From d573f5dfd5c25f82b009933968bd70b46d7ef77b Mon Sep 17 00:00:00 2001 From: Koji AGAWA Date: Fri, 11 Aug 2023 11:59:52 +0900 Subject: [PATCH 001/447] feat: props spread --- Cargo.toml | 2 + packages/autofmt/src/element.rs | 1 + packages/core/src/lib.rs | 4 +- packages/core/src/nodes.rs | 31 +++++ packages/dioxus/tests/props_spread.rs | 121 ++++++++++++++++++ packages/html-internal-macro/Cargo.toml | 28 ++++ packages/html-internal-macro/src/lib.rs | 83 ++++++++++++ .../html-internal-macro/tests/01-simple.rs | 1 + .../html-internal-macro/tests/progress.rs | 5 + packages/html/Cargo.toml | 1 + packages/html/src/elements.rs | 12 +- packages/html/src/global_attributes.rs | 7 + packages/rsx-rosetta/src/lib.rs | 1 + packages/rsx/src/element.rs | 8 ++ 14 files changed, 301 insertions(+), 4 deletions(-) create mode 100644 packages/dioxus/tests/props_spread.rs create mode 100644 packages/html-internal-macro/Cargo.toml create mode 100644 packages/html-internal-macro/src/lib.rs create mode 100644 packages/html-internal-macro/tests/01-simple.rs create mode 100644 packages/html-internal-macro/tests/progress.rs diff --git a/Cargo.toml b/Cargo.toml index 5b55f4628..0072a608e 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -9,6 +9,7 @@ members = [ "packages/extension", "packages/router", "packages/html", + "packages/html-internal-macro", "packages/hooks", "packages/web", "packages/ssr", @@ -60,6 +61,7 @@ dioxus-core-macro = { path = "packages/core-macro", version = "0.4.0" } dioxus-router = { path = "packages/router", version = "0.4.1" } dioxus-router-macro = { path = "packages/router-macro", version = "0.4.1" } dioxus-html = { path = "packages/html", version = "0.4.0" } +dioxus-html-internal-macro = { path = "packages/html-internal-macro", version = "0.4.0" } dioxus-hooks = { path = "packages/hooks", version = "0.4.0" } dioxus-web = { path = "packages/web", version = "0.4.0" } dioxus-ssr = { path = "packages/ssr", version = "0.4.0" } diff --git a/packages/autofmt/src/element.rs b/packages/autofmt/src/element.rs index dbc336401..44f527337 100644 --- a/packages/autofmt/src/element.rs +++ b/packages/autofmt/src/element.rs @@ -49,6 +49,7 @@ impl Writer<'_> { attributes, children, brace, + extra_attributes, } = el; /* diff --git a/packages/core/src/lib.rs b/packages/core/src/lib.rs index 62e142f60..b9e514a7c 100644 --- a/packages/core/src/lib.rs +++ b/packages/core/src/lib.rs @@ -73,8 +73,8 @@ pub(crate) mod innerlude { } pub use crate::innerlude::{ - fc_to_builder, vdom_is_rendering, AnyValue, Attribute, AttributeValue, BorrowedAttributeValue, - CapturedError, Component, DynamicNode, Element, ElementId, Event, Fragment, IntoDynNode, + fc_to_builder, vdom_is_rendering, AnyValue, Attribute, AttributeBox, AttributeValue, BorrowedAttributeValue, + CapturedError, Component, DynamicNode, Element, ElementId, Event, Fragment, HasAttributesBox, IntoDynNode, LazyNodes, Mutation, Mutations, Properties, RenderReturn, Scope, ScopeId, ScopeState, Scoped, TaskId, Template, TemplateAttribute, TemplateNode, VComponent, VNode, VPlaceholder, VText, VirtualDom, diff --git a/packages/core/src/nodes.rs b/packages/core/src/nodes.rs index a108f3577..0e3a9708b 100644 --- a/packages/core/src/nodes.rs +++ b/packages/core/src/nodes.rs @@ -832,3 +832,34 @@ impl<'a, T: IntoAttributeValue<'a>> IntoAttributeValue<'a> for Option { } } } + +pub struct AttributeBox<'a> { + /// The name of the attribute. + pub name: &'a str, + + /// The value of the attribute + pub value: Box + 'static>, + + /// The namespace of the attribute. + /// + /// Doesn’t exist in the html spec. Used in Dioxus to denote β€œstyle” tags and other attribute groups. + pub namespace: Option<&'static str>, + + /// An indication of we should always try and set the attribute. Used in controlled components to ensure changes are propagated + pub volatile: bool, +} + +impl<'a> AttributeBox<'a> { + pub fn new(name: &'a str, value: impl IntoAttributeValue<'a> + 'static, namespace: Option<&'static str>, volatile: bool) -> Self { + Self { + name, + value: Box::new(value), + namespace, + volatile, + } + } +} + +pub trait HasAttributesBox<'a, T> { + fn push_attribute(self, attr: AttributeBox<'a>) -> T; +} diff --git a/packages/dioxus/tests/props_spread.rs b/packages/dioxus/tests/props_spread.rs new file mode 100644 index 000000000..a183e11da --- /dev/null +++ b/packages/dioxus/tests/props_spread.rs @@ -0,0 +1,121 @@ +use dioxus::core_macro::render; +use dioxus::prelude::rsx; +use dioxus_core::{AttributeBox, Element, HasAttributesBox, Scope}; +use dioxus_html::{ExtendedAudioMarker, ExtendedGlobalAttributesMarker}; + +#[test] +fn props_spread() { + pub struct FooProps<'a> { + pub open: Option<&'a str>, + attributes: Vec>, + } + + // ----- + impl<'a> FooProps<'a> { + #[doc = "\nCreate a builder for building `FooProps`.\nOn the builder, call `.open(...)`(optional) to set the values of the fields.\nFinally, call `.build()` to create the instance of `FooProps`.\n "] + #[allow(dead_code)] + pub fn builder() -> FooPropsBuilder<'a, ((), ), > { + FooPropsBuilder { fields: ((), ), attributes: Vec::new(), _phantom: core::default::Default::default() } + } + } + #[must_use] + #[doc(hidden)] + #[allow(dead_code, non_camel_case_types, non_snake_case)] + pub struct FooPropsBuilder<'a, TypedBuilderFields, > { + fields: TypedBuilderFields, + attributes: Vec>, + _phantom: ( core::marker::PhantomData<&'a ()> ), + } + //impl<'a, TypedBuilderFields, > Clone for FooPropsBuilder<'a, TypedBuilderFields, > where TypedBuilderFields: Clone { fn clone(&self) -> Self { Self { fields: self.fields.clone(), attributes: self.attributes, _phantom: Default::default() } } } + impl<'a> dioxus::prelude::Properties for FooProps<'a> { + type Builder = FooPropsBuilder<'a, ((), ), >; + const IS_STATIC: bool = false; + fn builder() -> Self::Builder { FooProps::builder() } + unsafe fn memoize(&self, other: &Self) -> bool { false } + } + #[doc(hidden)] + #[allow(dead_code, non_camel_case_types, non_snake_case)] + pub trait FooPropsBuilder_Optional { fn into_value T>(self, default: F) -> T; } + impl FooPropsBuilder_Optional for () { fn into_value T>(self, default: F) -> T { default() } } + impl FooPropsBuilder_Optional for (T, ) { fn into_value T>(self, _: F) -> T { self.0 } } + #[allow(dead_code, non_camel_case_types, missing_docs)] + impl<'a> FooPropsBuilder<'a, ((), )> { + pub fn open(self, open: &'a str) -> FooPropsBuilder<'a, ((Option<&'a str>, + // pub attributes: Vec>, + ), )> { + let open = (Some(open), ); + let (_, ) = self.fields; + FooPropsBuilder { fields: (open, ), attributes: self.attributes, _phantom: self._phantom } + } + } + #[doc(hidden)] + #[allow(dead_code, non_camel_case_types, non_snake_case)] + pub enum FooPropsBuilder_Error_Repeated_field_open {} + #[doc(hidden)] + #[allow(dead_code, non_camel_case_types, missing_docs)] + impl<'a> FooPropsBuilder<'a, ((Option<&'a str>, + // pub attributes: Vec>, + ), )> { + #[deprecated(note = "Repeated field open")] + pub fn open(self, _: FooPropsBuilder_Error_Repeated_field_open) -> FooPropsBuilder<'a, ((Option<&'a str>, + // pub attributes: Vec>, + ), )> { self } + } + #[allow(dead_code, non_camel_case_types, missing_docs)] + impl<'a, __open: FooPropsBuilder_Optional>> FooPropsBuilder<'a, (__open, ), > { + pub fn build(self) -> FooProps<'a> { + let (open, ) = self.fields; + let open = FooPropsBuilder_Optional::into_value(open, || Default::default()); + FooProps { open, attributes: self.attributes } + } + } + // ----- + + impl<'a, A> HasAttributesBox<'a, FooPropsBuilder<'a, (A, )>> for FooPropsBuilder<'a, (A, )> { + fn push_attribute(self, attr: AttributeBox<'a>) -> FooPropsBuilder<'a, (A, )> { + let mut attrs = Vec::from(self.attributes); + attrs.push(attr); + FooPropsBuilder { fields: self.fields, attributes: attrs, _phantom: self._phantom } + } + } + impl ExtendedGlobalAttributesMarker for FooPropsBuilder<'_, (A,)> {} + impl ExtendedAudioMarker for FooPropsBuilder<'_, (A,)> {} + + use dioxus::prelude::*; + use dioxus_html::AudioExtension; + + #[allow(non_snake_case)] + pub fn Foo<'a>(cx: Scope<'a, FooProps<'a>>) -> Element<'a> { + let muted = false; + let attributes = cx.props.attributes; + render! { + // rsx! { + // audio { + // muted: muted, + // } + // } + ::dioxus::core::LazyNodes::new(move |__cx: &::dioxus::core::ScopeState| -> ::dioxus::core::VNode { + static TEMPLATE: ::dioxus::core::Template = ::dioxus::core::Template { name: concat!(file!(), ":", line!(), ":", column!(), ":", "" ), roots: &[::dioxus::core::TemplateNode::Element { tag: dioxus_elements::audio::TAG_NAME, namespace: dioxus_elements::audio::NAME_SPACE, attrs: &[::dioxus::core::TemplateAttribute::Dynamic { id: 0usize }], children: &[] }], node_paths: &[], attr_paths: &[&[0u8]] }; + let mut attrs = vec![__cx.attr(dioxus_elements::audio::muted.0, muted, dioxus_elements::audio::muted.1, dioxus_elements::audio::muted.2)]; + for attr in attributes { + attrs.push(__cx.attr(attr.name, attr.value.into_value(__cx.bump()), attr.namespace, attr.volatile)); + }; + ::dioxus::core::VNode { + parent: None, + key: None, + template: std::cell::Cell::new(TEMPLATE), + root_ids: Default::default(), + dynamic_nodes: __cx.bump().alloc([]), + dynamic_attrs: __cx.bump().alloc(attrs), + } + }) + } + } + + rsx! { + Foo { + autoplay: true, + controls: true, + } + }; +} \ No newline at end of file diff --git a/packages/html-internal-macro/Cargo.toml b/packages/html-internal-macro/Cargo.toml new file mode 100644 index 000000000..ce8ad54b1 --- /dev/null +++ b/packages/html-internal-macro/Cargo.toml @@ -0,0 +1,28 @@ +[package] +name = "dioxus-html-internal-macro" +version = { workspace = true } +edition = "2021" +repository = "https://github.com/DioxusLabs/dioxus/" +homepage = "https://dioxuslabs.com" +keywords = ["dom", "ui", "gui", "react", "liveview"] +license = "MIT OR Apache-2.0" +description = "HTML function macros for Dioxus" + + +# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html + +[dependencies] +proc-macro2 = "1.0.66" +syn = { version = "2", features = ["full"] } +quote = "^1.0.26" +convert_case = "^0.6.0" + +[lib] +proc-macro = true + +[[test]] +name = "tests" +path = "tests/progress.rs" + +[dev-dependencies] +trybuild = { version = "1.0.82", features = ["diff"] } \ No newline at end of file diff --git a/packages/html-internal-macro/src/lib.rs b/packages/html-internal-macro/src/lib.rs new file mode 100644 index 000000000..5794fd073 --- /dev/null +++ b/packages/html-internal-macro/src/lib.rs @@ -0,0 +1,83 @@ +use proc_macro::TokenStream; + +use convert_case::{Case, Casing}; +use quote::{quote, TokenStreamExt, ToTokens}; +use syn::{braced, Ident, parse_macro_input, Token}; +use syn::__private::TokenStream2; +use syn::parse::{Parse, ParseStream}; +use syn::punctuated::Punctuated; + +#[proc_macro] +pub fn impl_extension_attributes(input: TokenStream) -> TokenStream { + let input = parse_macro_input!(input as ImplExtensionAttributes); + input.to_token_stream().into() +} + +struct ImplExtensionAttributes { + is_element: bool, + name: Ident, + attrs: Punctuated, +} + +impl Parse for ImplExtensionAttributes { + fn parse(input: ParseStream) -> syn::Result { + let content; + + let element: Ident = input.parse()?; + let name = input.parse()?; + braced!(content in input); + let attrs = content.parse_terminated(Ident::parse, Token![,])?; + + Ok(ImplExtensionAttributes { + is_element: element.to_string() == "ELEMENT", + name, + attrs, + }) + } +} + +impl ToTokens for ImplExtensionAttributes { + fn to_tokens(&self, tokens: &mut TokenStream2) { + let name = &self.name; + let camel_name = name.to_string().to_case(Case::UpperCamel); + let impl_name = Ident::new(format!("{}Impl", &camel_name).as_str(), name.span()); + let extension_name = Ident::new(format!("{}Extension", &camel_name).as_str(), name.span()); + let marker_name = Ident::new(format!("Extended{}Marker", &camel_name).as_str(), name.span()); + + if !self.is_element { + tokens.append_all(quote! { + trait #impl_name {} + impl #name for #impl_name {} + }); + } + + let defs = self.attrs.iter().map(|ident| { + quote! { + fn #ident(self, value: impl IntoAttributeValue<'a> + 'static) -> Self; + } + }); + let impls = self.attrs.iter().map(|ident| { + let d = if self.is_element { + quote! { #name::#ident } + } else { + quote! { #impl_name::#ident } + }; + quote! { + fn #ident(self, value: impl IntoAttributeValue<'a> + 'static) -> Self { + let d = #d; + self.push_attribute(AttributeBox::new(d.0, value, d.1, d.2)) + } + } + }); + tokens.append_all(quote! { + pub trait #marker_name {} + + pub trait #extension_name<'a> { + #(#defs)* + } + impl<'a, T> #extension_name<'a> for T where T: HasAttributesBox<'a, T> + #marker_name { + #(#impls)* + } + }); + } +} diff --git a/packages/html-internal-macro/tests/01-simple.rs b/packages/html-internal-macro/tests/01-simple.rs new file mode 100644 index 000000000..e71fdf554 --- /dev/null +++ b/packages/html-internal-macro/tests/01-simple.rs @@ -0,0 +1 @@ +fn main() {} \ No newline at end of file diff --git a/packages/html-internal-macro/tests/progress.rs b/packages/html-internal-macro/tests/progress.rs new file mode 100644 index 000000000..563805397 --- /dev/null +++ b/packages/html-internal-macro/tests/progress.rs @@ -0,0 +1,5 @@ +#[test] +fn tests() { + let t = trybuild::TestCases::new(); + t.pass("tests/01-simple.rs"); +} diff --git a/packages/html/Cargo.toml b/packages/html/Cargo.toml index 86ccb029d..cdf072a7c 100644 --- a/packages/html/Cargo.toml +++ b/packages/html/Cargo.toml @@ -12,6 +12,7 @@ keywords = ["dom", "ui", "gui", "react"] [dependencies] dioxus-core = { workspace = true } dioxus-rsx = { workspace = true, features = ["hot_reload"], optional = true } +dioxus-html-internal-macro = { workspace = true } serde = { version = "1", features = ["derive"], optional = true } serde_repr = { version = "0.1", optional = true } wasm-bindgen = { workspace = true, optional = true } diff --git a/packages/html/src/elements.rs b/packages/html/src/elements.rs index 7e5bed124..e7e682bf5 100644 --- a/packages/html/src/elements.rs +++ b/packages/html/src/elements.rs @@ -1,9 +1,15 @@ #![allow(non_upper_case_globals)] + +use dioxus_core::AttributeBox; +use dioxus_core::HasAttributesBox; +use dioxus_core::prelude::IntoAttributeValue; +use dioxus_html_internal_macro::impl_extension_attributes; +#[cfg(feature = "hot-reload-context")] +use dioxus_rsx::HotReloadingContext; + #[cfg(feature = "hot-reload-context")] use crate::{map_global_attributes, map_svg_attributes}; use crate::{GlobalAttributes, SvgAttributes}; -#[cfg(feature = "hot-reload-context")] -use dioxus_rsx::HotReloadingContext; pub type AttributeDiscription = (&'static str, Option<&'static str>, bool); @@ -106,6 +112,8 @@ macro_rules! impl_element { } impl GlobalAttributes for $name {} + + impl_extension_attributes![ELEMENT $name { $($fil,)* }]; }; ( diff --git a/packages/html/src/global_attributes.rs b/packages/html/src/global_attributes.rs index 3792397ad..2c7718686 100644 --- a/packages/html/src/global_attributes.rs +++ b/packages/html/src/global_attributes.rs @@ -1,5 +1,10 @@ #![allow(non_upper_case_globals)] +use dioxus_core::HasAttributesBox; +use dioxus_core::AttributeBox; +use dioxus_core::prelude::IntoAttributeValue; +use dioxus_html_internal_macro::impl_extension_attributes; + use crate::AttributeDiscription; #[cfg(feature = "hot-reload-context")] @@ -62,6 +67,8 @@ macro_rules! trait_methods { )* None } + + impl_extension_attributes![GLOBAL $trait { $($name,)* }]; }; // Rename the incoming ident and apply a custom namespace diff --git a/packages/rsx-rosetta/src/lib.rs b/packages/rsx-rosetta/src/lib.rs index 2ceb5f038..97678cf3a 100644 --- a/packages/rsx-rosetta/src/lib.rs +++ b/packages/rsx-rosetta/src/lib.rs @@ -73,6 +73,7 @@ pub fn rsx_node_from_html(node: &Node) -> Option { attributes, key: None, brace: Default::default(), + extra_attributes: None, })) } diff --git a/packages/rsx/src/element.rs b/packages/rsx/src/element.rs index 8f45d91ff..dd33c825f 100644 --- a/packages/rsx/src/element.rs +++ b/packages/rsx/src/element.rs @@ -21,6 +21,7 @@ pub struct Element { pub attributes: Vec, pub children: Vec, pub brace: syn::token::Brace, + pub extra_attributes: Option, } impl Parse for Element { @@ -35,6 +36,7 @@ impl Parse for Element { let mut children: Vec = vec![]; let mut key = None; let mut _el_ref = None; + let mut extra_attributes = None; // parse fields with commas // break when we don't get this pattern anymore @@ -42,6 +44,11 @@ impl Parse for Element { // "def": 456, // abc: 123, loop { + if content.peek(Token![...]) { + content.parse::()?; + extra_attributes = Some(content.parse::()?); + } + // Parse the raw literal fields if content.peek(LitStr) && content.peek2(Token![:]) && !content.peek3(Token![:]) { let name = content.parse::()?; @@ -160,6 +167,7 @@ impl Parse for Element { attributes, children, brace, + extra_attributes }) } } From 9c2e713dae8440ca368cda4d2d8b55f6ab8f737b Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Tue, 15 Aug 2023 09:30:43 -0500 Subject: [PATCH 002/447] fix recycling nodes in native core --- packages/native-core/src/dioxus.rs | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/packages/native-core/src/dioxus.rs b/packages/native-core/src/dioxus.rs index 3e9ff9ee0..e5042f756 100644 --- a/packages/native-core/src/dioxus.rs +++ b/packages/native-core/src/dioxus.rs @@ -57,6 +57,12 @@ impl DioxusState { node.insert(ElementIdComponent(element_id)); if self.node_id_mapping.len() <= element_id.0 { self.node_id_mapping.resize(element_id.0 + 1, None); + } else { + if let Some(mut node) = + self.node_id_mapping[element_id.0].and_then(|id| node.real_dom_mut().get_mut(id)) + { + node.remove(); + } } self.node_id_mapping[element_id.0] = Some(node_id); } From 0d773eac63cbf8b6d9ffe459d9d5ca81c96bb2fc Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Tue, 15 Aug 2023 10:37:27 -0500 Subject: [PATCH 003/447] fix clippy --- packages/native-core/src/dioxus.rs | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/packages/native-core/src/dioxus.rs b/packages/native-core/src/dioxus.rs index e5042f756..c245de4fc 100644 --- a/packages/native-core/src/dioxus.rs +++ b/packages/native-core/src/dioxus.rs @@ -57,13 +57,12 @@ impl DioxusState { node.insert(ElementIdComponent(element_id)); if self.node_id_mapping.len() <= element_id.0 { self.node_id_mapping.resize(element_id.0 + 1, None); - } else { - if let Some(mut node) = - self.node_id_mapping[element_id.0].and_then(|id| node.real_dom_mut().get_mut(id)) - { - node.remove(); - } + } else if let Some(mut node) = + self.node_id_mapping[element_id.0].and_then(|id| node.real_dom_mut().get_mut(id)) + { + node.remove(); } + self.node_id_mapping[element_id.0] = Some(node_id); } From 0ec085fbbd935ac3ea96aa1c9fa7f84086a2f630 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Wed, 16 Aug 2023 14:03:28 -0500 Subject: [PATCH 004/447] add collect assets --- packages/cli/Cargo.toml | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/packages/cli/Cargo.toml b/packages/cli/Cargo.toml index 892399a9d..c6a7aeb03 100644 --- a/packages/cli/Cargo.toml +++ b/packages/cli/Cargo.toml @@ -33,7 +33,7 @@ tokio = { version = "1.16.1", features = ["full"] } atty = "0.2.14" regex = "1.5.4" chrono = "0.4.19" -anyhow = "1.0.53" +anyhow = "1" hyper = "0.14.17" hyper-rustls = "0.23.2" indicatif = "0.17.0-rc.11" @@ -81,6 +81,8 @@ toml_edit = "0.19.11" tauri-bundler = { version = "1.2", features = ["native-tls-vendored"] } tauri-utils = "1.3" +collect-assets = { git = "https://github.com/DioxusLabs/collect-assets" } + dioxus-autofmt = { workspace = true } dioxus-check = { workspace = true } rsx-rosetta = { workspace = true } From 8d3c11ef153cfb5c3f3bbce344f3521057529842 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Wed, 16 Aug 2023 16:16:34 -0500 Subject: [PATCH 005/447] inject included styles and preload images into the head --- packages/cli/Cargo.toml | 2 +- packages/cli/src/builder.rs | 60 +++++++++++++++++++++++++++++++---- packages/cli/src/cli/build.rs | 2 +- packages/cli/src/cli/serve.rs | 2 +- packages/cli/src/config.rs | 10 +++++- 5 files changed, 65 insertions(+), 11 deletions(-) diff --git a/packages/cli/Cargo.toml b/packages/cli/Cargo.toml index c6a7aeb03..87301100c 100644 --- a/packages/cli/Cargo.toml +++ b/packages/cli/Cargo.toml @@ -81,7 +81,7 @@ toml_edit = "0.19.11" tauri-bundler = { version = "1.2", features = ["native-tls-vendored"] } tauri-utils = "1.3" -collect-assets = { git = "https://github.com/DioxusLabs/collect-assets" } +assets-cli-support = { git = "https://github.com/DioxusLabs/collect-assets" } dioxus-autofmt = { workspace = true } dioxus-check = { workspace = true } diff --git a/packages/cli/src/builder.rs b/packages/cli/src/builder.rs index 332490fda..ee5e5ff89 100644 --- a/packages/cli/src/builder.rs +++ b/packages/cli/src/builder.rs @@ -2,8 +2,8 @@ use crate::{ config::{CrateConfig, ExecutableType}, error::{Error, Result}, tools::Tool, - DioxusConfig, }; +use assets_cli_support::AssetManifestExt; use cargo_metadata::{diagnostic::Diagnostic, Message}; use indicatif::{ProgressBar, ProgressStyle}; use serde::Serialize; @@ -239,6 +239,8 @@ pub fn build(config: &CrateConfig, quiet: bool) -> Result { } } + process_assets(config)?; + Ok(BuildResult { warnings: warning_messages, elapsed_time: t_start.elapsed().as_millis(), @@ -428,7 +430,7 @@ fn prettier_build(cmd: subprocess::Exec) -> anyhow::Result> { Ok(warning_messages) } -pub fn gen_page(config: &DioxusConfig, serve: bool) -> String { +pub fn gen_page(config: &CrateConfig, serve: bool) -> String { let crate_root = crate::cargo::crate_root().unwrap(); let custom_html_file = crate_root.join("index.html"); let mut html = if custom_html_file.is_file() { @@ -443,7 +445,7 @@ pub fn gen_page(config: &DioxusConfig, serve: bool) -> String { String::from(include_str!("./assets/index.html")) }; - let resouces = config.web.resource.clone(); + let resouces = config.dioxus_config.web.resource.clone(); let mut style_list = resouces.style.unwrap_or_default(); let mut script_list = resouces.script.unwrap_or_default(); @@ -462,7 +464,7 @@ pub fn gen_page(config: &DioxusConfig, serve: bool) -> String { &style.to_str().unwrap(), )) } - if config + if config.dioxus_config .application .tools .clone() @@ -471,6 +473,26 @@ pub fn gen_page(config: &DioxusConfig, serve: bool) -> String { { style_str.push_str("\n"); } + let manifest = config.asset_manifest(); + for package in manifest.packages() { + for asset in package.assets(){ + if let assets_cli_support::AssetType::File(file) = asset { + match file.options(){ + assets_cli_support::FileOptions::Css(_) => { + let asset_path = file.served_location(); + style_str.push_str(&format!("\n")) + } + assets_cli_support::FileOptions::Image(image_options) => { + if image_options.preload(){ + let asset_path = file.served_location(); + style_str.push_str(&format!("\n")) + } + } + _ => {} + } + } + } + } replace_or_insert_before("{style_include}", &style_str, " String { ); } - let base_path = match &config.web.app.base_path { + let base_path = match &config.dioxus_config.web.app.base_path { Some(path) => path, None => ".", }; - let app_name = &config.application.name; + let app_name = &config.dioxus_config.application.name; // Check if a script already exists if html.contains("{app_name}") && html.contains("{base_path}") { html = html.replace("{app_name}", app_name); @@ -520,7 +542,7 @@ pub fn gen_page(config: &DioxusConfig, serve: bool) -> String { } let title = config - .web + .dioxus_config.web .app .title .clone() @@ -687,9 +709,33 @@ fn build_assets(config: &CrateConfig) -> Result> { } // SASS END + // Set up the collect asset config + let config = assets_cli_support::Config::default().with_assets_serve_location("/"); + config.save(); + Ok(result) } +/// Process any assets collected from the binary +fn process_assets(config: &CrateConfig) -> anyhow::Result<()> { + let manifest = config.asset_manifest(); + + let static_asset_output_dir = PathBuf::from( + config + .dioxus_config + .web + .app + .base_path + .clone() + .unwrap_or_default(), + ); + let static_asset_output_dir = config.out_dir.join(static_asset_output_dir); + + manifest.copy_static_assets_to(&static_asset_output_dir)?; + + Ok(()) +} + // use binary_install::{Cache, Download}; // /// Attempts to find `wasm-opt` in `PATH` locally, or failing that downloads a diff --git a/packages/cli/src/cli/build.rs b/packages/cli/src/cli/build.rs index 3053a6e5a..9d264c366 100644 --- a/packages/cli/src/cli/build.rs +++ b/packages/cli/src/cli/build.rs @@ -49,7 +49,7 @@ impl Build { } } - let temp = gen_page(&crate_config.dioxus_config, false); + let temp = gen_page(&crate_config, false); let mut file = std::fs::File::create( crate_config diff --git a/packages/cli/src/cli/serve.rs b/packages/cli/src/cli/serve.rs index 433d611b7..774241b0f 100644 --- a/packages/cli/src/cli/serve.rs +++ b/packages/cli/src/cli/serve.rs @@ -56,7 +56,7 @@ impl Serve { } pub fn regen_dev_page(crate_config: &CrateConfig) -> Result<()> { - let serve_html = gen_page(&crate_config.dioxus_config, true); + let serve_html = gen_page(&crate_config, true); let dist_path = crate_config.crate_dir.join( crate_config diff --git a/packages/cli/src/config.rs b/packages/cli/src/config.rs index 2e499451f..a93570803 100644 --- a/packages/cli/src/config.rs +++ b/packages/cli/src/config.rs @@ -1,4 +1,5 @@ -use crate::{cfg::Platform, error::Result}; +use assets_cli_support::AssetManifest;use crate::{cfg::Platform, error::Result}; +use assets_cli_support::AssetManifestExt; use serde::{Deserialize, Serialize}; use std::{ collections::HashMap, @@ -297,6 +298,13 @@ impl CrateConfig { }) } + pub fn asset_manifest(&self) -> AssetManifest { + AssetManifest::load_from_path( + self.crate_dir.join("cargo.toml"), + self.workspace_dir.join("cargo.lock"), + ) + } + pub fn as_example(&mut self, example_name: String) -> &mut Self { self.executable = ExecutableType::Example(example_name); self From c402b6cd3640850d704ed785e379839c0aea3644 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Wed, 16 Aug 2023 17:01:51 -0500 Subject: [PATCH 006/447] collect assets in desktop debug mode --- packages/cli/Cargo.toml | 2 +- packages/cli/src/builder.rs | 34 +++++++++----------------- packages/cli/src/config.rs | 3 ++- packages/desktop/Cargo.toml | 1 + packages/desktop/src/collect_assets.rs | 31 +++++++++++++++++++++++ packages/desktop/src/lib.rs | 4 +++ packages/desktop/src/protocol.rs | 21 ++++++++++++++-- packages/desktop/src/webview.rs | 18 +++++++++++++- 8 files changed, 86 insertions(+), 28 deletions(-) create mode 100644 packages/desktop/src/collect_assets.rs diff --git a/packages/cli/Cargo.toml b/packages/cli/Cargo.toml index 87301100c..3d38bfc01 100644 --- a/packages/cli/Cargo.toml +++ b/packages/cli/Cargo.toml @@ -81,7 +81,7 @@ toml_edit = "0.19.11" tauri-bundler = { version = "1.2", features = ["native-tls-vendored"] } tauri-utils = "1.3" -assets-cli-support = { git = "https://github.com/DioxusLabs/collect-assets" } +assets-cli-support = { git = "https://github.com/DioxusLabs/collect-assets", features = ["webp", "html"] } dioxus-autofmt = { workspace = true } dioxus-check = { workspace = true } diff --git a/packages/cli/src/builder.rs b/packages/cli/src/builder.rs index ee5e5ff89..ddfa95dfe 100644 --- a/packages/cli/src/builder.rs +++ b/packages/cli/src/builder.rs @@ -464,7 +464,8 @@ pub fn gen_page(config: &CrateConfig, serve: bool) -> String { &style.to_str().unwrap(), )) } - if config.dioxus_config + if config + .dioxus_config .application .tools .clone() @@ -474,25 +475,7 @@ pub fn gen_page(config: &CrateConfig, serve: bool) -> String { style_str.push_str("\n"); } let manifest = config.asset_manifest(); - for package in manifest.packages() { - for asset in package.assets(){ - if let assets_cli_support::AssetType::File(file) = asset { - match file.options(){ - assets_cli_support::FileOptions::Css(_) => { - let asset_path = file.served_location(); - style_str.push_str(&format!("\n")) - } - assets_cli_support::FileOptions::Image(image_options) => { - if image_options.preload(){ - let asset_path = file.served_location(); - style_str.push_str(&format!("\n")) - } - } - _ => {} - } - } - } - } + style_str.push_str(&manifest.head()); replace_or_insert_before("{style_include}", &style_str, " String { } let title = config - .dioxus_config.web + .dioxus_config + .web .app .title .clone() @@ -710,8 +694,9 @@ fn build_assets(config: &CrateConfig) -> Result> { // SASS END // Set up the collect asset config - let config = assets_cli_support::Config::default().with_assets_serve_location("/"); - config.save(); + assets_cli_support::Config::default() + .with_assets_serve_location("/") + .save(); Ok(result) } @@ -733,6 +718,9 @@ fn process_assets(config: &CrateConfig) -> anyhow::Result<()> { manifest.copy_static_assets_to(&static_asset_output_dir)?; + // Reset the config + assets_cli_support::Config::default().save(); + Ok(()) } diff --git a/packages/cli/src/config.rs b/packages/cli/src/config.rs index a93570803..b5345a8a4 100644 --- a/packages/cli/src/config.rs +++ b/packages/cli/src/config.rs @@ -1,4 +1,5 @@ -use assets_cli_support::AssetManifest;use crate::{cfg::Platform, error::Result}; +use crate::{cfg::Platform, error::Result}; +use assets_cli_support::AssetManifest; use assets_cli_support::AssetManifestExt; use serde::{Deserialize, Serialize}; use std::{ diff --git a/packages/desktop/Cargo.toml b/packages/desktop/Cargo.toml index a85c2e045..6254c7ff8 100644 --- a/packages/desktop/Cargo.toml +++ b/packages/desktop/Cargo.toml @@ -38,6 +38,7 @@ futures-util = { workspace = true } urlencoding = "2.1.2" async-trait = "0.1.68" +assets-cli-support = { git = "https://github.com/DioxusLabs/collect-assets", features = ["webp", "html"] } [target.'cfg(any(target_os = "windows",target_os = "macos",target_os = "linux",target_os = "dragonfly", target_os = "freebsd", target_os = "netbsd", target_os = "openbsd"))'.dependencies] rfd = "0.11.3" diff --git a/packages/desktop/src/collect_assets.rs b/packages/desktop/src/collect_assets.rs new file mode 100644 index 000000000..65b36fede --- /dev/null +++ b/packages/desktop/src/collect_assets.rs @@ -0,0 +1,31 @@ +pub fn copy_assets() { + #[cfg(debug_assertions)] + { + use assets_cli_support::AssetManifest; + use assets_cli_support::AssetManifestExt; + use assets_cli_support::Config; + use std::path::PathBuf; + let config = Config::current(); + let asset_location = config.assets_serve_location(); + let asset_location = PathBuf::from(asset_location); + let _ = std::fs::remove_dir_all(&asset_location); + + let manifest = AssetManifest::load(); + let has_assets = manifest + .packages() + .iter() + .any(|package| !package.assets().is_empty()); + + if has_assets { + println!("Copying and optimizing assets..."); + manifest.copy_static_assets_to(&asset_location).unwrap(); + println!("Copied assets to {}", asset_location.display()); + } + } + #[cfg(not(debug_assertions))] + { + println!( + "Skipping assets in release mode. You compile assets with the dioxus-cli in release mode" + ); + } +} diff --git a/packages/desktop/src/lib.rs b/packages/desktop/src/lib.rs index 070bfa7d1..3fd1d6ed2 100644 --- a/packages/desktop/src/lib.rs +++ b/packages/desktop/src/lib.rs @@ -4,6 +4,7 @@ #![deny(missing_docs)] mod cfg; +mod collect_assets; mod desktop_context; mod element; mod escape; @@ -136,6 +137,9 @@ pub fn launch_with_props(root: Component

, props: P, cfg: Config) } }); + // Copy over any assets we find + crate::collect_assets::copy_assets(); + // We start the tokio runtime *on this thread* // Any future we poll later will use this runtime to spawn tasks and for IO let rt = tokio::runtime::Builder::new_multi_thread() diff --git a/packages/desktop/src/protocol.rs b/packages/desktop/src/protocol.rs index 53652f82f..4046ee42f 100644 --- a/packages/desktop/src/protocol.rs +++ b/packages/desktop/src/protocol.rs @@ -51,10 +51,12 @@ fn module_loader(root_name: &str) -> String { ) } +#[allow(unused_variables)] pub(super) fn desktop_handler( request: &Request>, custom_head: Option, custom_index: Option, + assets_head: Option, root_name: &str, ) -> Result>> { // If the request is for the root, we'll serve the index.html file. @@ -70,9 +72,24 @@ pub(super) fn desktop_handler( // Otherwise, we'll serve the default index.html and apply a custom head if that's specified. let mut template = include_str!("./index.html").to_string(); - if let Some(custom_head) = custom_head { - template = template.replace("", &custom_head); + #[allow(unused_mut)] + let mut head = custom_head.unwrap_or_default(); + #[cfg(debug_assertions)] + { + use assets_cli_support::AssetManifestExt; + let manifest = assets_cli_support::AssetManifest::load(); + head += &manifest.head(); } + #[cfg(not(debug_assertions))] + { + if let Some(assets_head) = assets_head { + head += &assets_head; + } else { + log::warn!("No assets head found. You can compile assets with the dioxus-cli in release mode"); + } + } + + template = template.replace("", &head); template .replace("", &module_loader(root_name)) diff --git a/packages/desktop/src/webview.rs b/packages/desktop/src/webview.rs index 469aa8068..49475e903 100644 --- a/packages/desktop/src/webview.rs +++ b/packages/desktop/src/webview.rs @@ -18,6 +18,16 @@ pub fn build( let custom_head = cfg.custom_head.clone(); let index_file = cfg.custom_index.clone(); let root_name = cfg.root_name.clone(); + let assets_head = { + #[cfg(debug_assertions)] + { + None + } + #[cfg(not(debug_assertions))] + { + std::fs::read_to_string("public/assets_head.html").ok() + } + }; // We assume that if the icon is None in cfg, then the user just didnt set it if cfg.window.window.window_icon.is_none() { @@ -45,7 +55,13 @@ pub fn build( } }) .with_custom_protocol(String::from("dioxus"), move |r| { - protocol::desktop_handler(r, custom_head.clone(), index_file.clone(), &root_name) + protocol::desktop_handler( + r, + custom_head.clone(), + index_file.clone(), + assets_head.clone(), + &root_name, + ) }) .with_file_drop_handler(move |window, evet| { file_handler From 77d11f6d9aac8fa75ae5a3ca8224a1c4f7666057 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Wed, 16 Aug 2023 17:24:30 -0500 Subject: [PATCH 007/447] Fix the asset config in the CLI --- packages/cli/src/builder.rs | 31 +++++++++++++++++++++++-------- 1 file changed, 23 insertions(+), 8 deletions(-) diff --git a/packages/cli/src/builder.rs b/packages/cli/src/builder.rs index ddfa95dfe..a5cb29dc5 100644 --- a/packages/cli/src/builder.rs +++ b/packages/cli/src/builder.rs @@ -40,6 +40,8 @@ pub fn build(config: &CrateConfig, quiet: bool) -> Result { .. } = config; + let _gaurd = AssetConfigDropGaurd::new(); + // start to build the assets let ignore_files = build_assets(config)?; @@ -431,6 +433,8 @@ fn prettier_build(cmd: subprocess::Exec) -> anyhow::Result> { } pub fn gen_page(config: &CrateConfig, serve: bool) -> String { + let _gaurd = AssetConfigDropGaurd::new(); + let crate_root = crate::cargo::crate_root().unwrap(); let custom_html_file = crate_root.join("index.html"); let mut html = if custom_html_file.is_file() { @@ -693,11 +697,6 @@ fn build_assets(config: &CrateConfig) -> Result> { } // SASS END - // Set up the collect asset config - assets_cli_support::Config::default() - .with_assets_serve_location("/") - .save(); - Ok(result) } @@ -718,9 +717,6 @@ fn process_assets(config: &CrateConfig) -> anyhow::Result<()> { manifest.copy_static_assets_to(&static_asset_output_dir)?; - // Reset the config - assets_cli_support::Config::default().save(); - Ok(()) } @@ -755,3 +751,22 @@ fn process_assets(config: &CrateConfig) -> anyhow::Result<()> { // install_permitted, // )?) // } + +struct AssetConfigDropGaurd; + +impl AssetConfigDropGaurd { + pub fn new() -> Self { + // Set up the collect asset config + assets_cli_support::Config::default() + .with_assets_serve_location("/") + .save(); + Self {} + } +} + +impl Drop for AssetConfigDropGaurd { + fn drop(&mut self) { + // Reset the config + assets_cli_support::Config::default().save(); + } +} From 62f8e0f727bf713782e6a324f7761f0d08be02a7 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Thu, 17 Aug 2023 09:56:59 -0500 Subject: [PATCH 008/447] fix fullstack assets --- packages/cli/src/builder.rs | 2 ++ 1 file changed, 2 insertions(+) diff --git a/packages/cli/src/builder.rs b/packages/cli/src/builder.rs index a5cb29dc5..7b5527d2a 100644 --- a/packages/cli/src/builder.rs +++ b/packages/cli/src/builder.rs @@ -252,6 +252,8 @@ pub fn build(config: &CrateConfig, quiet: bool) -> Result { pub fn build_desktop(config: &CrateConfig, _is_serve: bool) -> Result { log::info!("πŸš… Running build [Desktop] command..."); + let _gaurd = AssetConfigDropGaurd::new(); + let t_start = std::time::Instant::now(); let ignore_files = build_assets(config)?; From 213b80790b2c9c8659aa20372c658e0f417f7daf Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Fri, 18 Aug 2023 09:55:49 -0500 Subject: [PATCH 009/447] fix release desktop builds --- packages/cli/src/builder.rs | 12 +++++++++++- packages/desktop/src/webview.rs | 2 +- 2 files changed, 12 insertions(+), 2 deletions(-) diff --git a/packages/cli/src/builder.rs b/packages/cli/src/builder.rs index 7b5527d2a..bed075ad6 100644 --- a/packages/cli/src/builder.rs +++ b/packages/cli/src/builder.rs @@ -9,7 +9,7 @@ use indicatif::{ProgressBar, ProgressStyle}; use serde::Serialize; use std::{ fs::{copy, create_dir_all, File}, - io::Read, + io::{Read, Write}, panic, path::PathBuf, time::Duration, @@ -353,6 +353,9 @@ pub fn build_desktop(config: &CrateConfig, _is_serve: bool) -> Result Result Result<()> { + let manifest = config.asset_manifest(); + let mut file = File::create(config.out_dir.join("__assets_head.html"))?; + file.write_all(manifest.head().as_bytes())?; + Ok(()) +} + fn prettier_build(cmd: subprocess::Exec) -> anyhow::Result> { let mut warning_messages: Vec = vec![]; diff --git a/packages/desktop/src/webview.rs b/packages/desktop/src/webview.rs index 49475e903..118dbbdc4 100644 --- a/packages/desktop/src/webview.rs +++ b/packages/desktop/src/webview.rs @@ -25,7 +25,7 @@ pub fn build( } #[cfg(not(debug_assertions))] { - std::fs::read_to_string("public/assets_head.html").ok() + std::fs::read_to_string("dist/__assets_head.html").ok() } }; From 9bfe9682b5a83ca9dd521a7bed61071c14ded163 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Fri, 18 Aug 2023 10:27:38 -0500 Subject: [PATCH 010/447] integrate with the bundle command --- packages/cli/src/builder.rs | 4 ++-- packages/cli/src/cli/bundle.rs | 13 +++++++++++++ 2 files changed, 15 insertions(+), 2 deletions(-) diff --git a/packages/cli/src/builder.rs b/packages/cli/src/builder.rs index bed075ad6..9e445ed7a 100644 --- a/packages/cli/src/builder.rs +++ b/packages/cli/src/builder.rs @@ -252,8 +252,6 @@ pub fn build(config: &CrateConfig, quiet: bool) -> Result { pub fn build_desktop(config: &CrateConfig, _is_serve: bool) -> Result { log::info!("πŸš… Running build [Desktop] command..."); - let _gaurd = AssetConfigDropGaurd::new(); - let t_start = std::time::Instant::now(); let ignore_files = build_assets(config)?; @@ -353,6 +351,8 @@ pub fn build_desktop(config: &CrateConfig, _is_serve: bool) -> Result Date: Fri, 18 Aug 2023 10:36:55 -0500 Subject: [PATCH 011/447] log errors when desktop fails to read the head --- packages/desktop/src/webview.rs | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/packages/desktop/src/webview.rs b/packages/desktop/src/webview.rs index 118dbbdc4..cd7561b74 100644 --- a/packages/desktop/src/webview.rs +++ b/packages/desktop/src/webview.rs @@ -25,7 +25,13 @@ pub fn build( } #[cfg(not(debug_assertions))] { - std::fs::read_to_string("dist/__assets_head.html").ok() + match std::fs::read_to_string("./dist/__assets_head.html") { + Ok(s) => Some(s), + Err(err) => { + log::error!("Failed to read ./dist/__assets_head.html: {}", err); + None + } + } } }; From 7b2bf4acc5b218eab6dc0f94ebca55661e87c65f Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Fri, 18 Aug 2023 10:57:30 -0500 Subject: [PATCH 012/447] find head relative to asset root --- packages/desktop/src/protocol.rs | 9 ++++++--- packages/desktop/src/webview.rs | 6 ++++-- 2 files changed, 10 insertions(+), 5 deletions(-) diff --git a/packages/desktop/src/protocol.rs b/packages/desktop/src/protocol.rs index 4046ee42f..0a8a9ff3e 100644 --- a/packages/desktop/src/protocol.rs +++ b/packages/desktop/src/protocol.rs @@ -114,9 +114,7 @@ pub(super) fn desktop_handler( let path = PathBuf::from(&*decoded); // If the path is relative, we'll try to serve it from the assets directory. - let mut asset = get_asset_root() - .unwrap_or_else(|| Path::new(".").to_path_buf()) - .join(&path); + let mut asset = get_asset_root_or_default().join(&path); if !asset.exists() { asset = PathBuf::from("/").join(path); @@ -135,6 +133,11 @@ pub(super) fn desktop_handler( .map_err(From::from) } +#[allow(unreachable_code)] +pub(crate) fn get_asset_root_or_default() -> PathBuf { + get_asset_root().unwrap_or_else(|| Path::new(".").to_path_buf()) +} + #[allow(unreachable_code)] fn get_asset_root() -> Option { /* diff --git a/packages/desktop/src/webview.rs b/packages/desktop/src/webview.rs index cd7561b74..a464653b8 100644 --- a/packages/desktop/src/webview.rs +++ b/packages/desktop/src/webview.rs @@ -25,10 +25,12 @@ pub fn build( } #[cfg(not(debug_assertions))] { - match std::fs::read_to_string("./dist/__assets_head.html") { + let head = crate::protocol::get_asset_root_or_default(); + let head = head.join("dist/__assets_head.html"); + match std::fs::read_to_string(&head) { Ok(s) => Some(s), Err(err) => { - log::error!("Failed to read ./dist/__assets_head.html: {}", err); + log::error!("Failed to read {head:?}: {err}"); None } } From efe08df966a84ad6b336e21964abcbf7be0a5752 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Fri, 18 Aug 2023 11:02:15 -0500 Subject: [PATCH 013/447] report request errors in desktop --- packages/desktop/src/protocol.rs | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/packages/desktop/src/protocol.rs b/packages/desktop/src/protocol.rs index 0a8a9ff3e..8ec5e1821 100644 --- a/packages/desktop/src/protocol.rs +++ b/packages/desktop/src/protocol.rs @@ -127,6 +127,12 @@ pub(super) fn desktop_handler( .map_err(From::from); } + log::error!( + "Failed to find {} (as path {})", + request.uri().path(), + asset.display() + ); + Response::builder() .status(StatusCode::NOT_FOUND) .body(Cow::from(String::from("Not Found").into_bytes())) From 1ed814668a733bc261453cb1e0a720baf635ef0a Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Fri, 18 Aug 2023 11:12:56 -0500 Subject: [PATCH 014/447] Set an environment variable during serve for bundling --- packages/cli/src/server/desktop/mod.rs | 5 ++++- packages/desktop/src/protocol.rs | 2 +- 2 files changed, 5 insertions(+), 2 deletions(-) diff --git a/packages/cli/src/server/desktop/mod.rs b/packages/cli/src/server/desktop/mod.rs index 9b79bdea9..0cd21d1b6 100644 --- a/packages/cli/src/server/desktop/mod.rs +++ b/packages/cli/src/server/desktop/mod.rs @@ -240,7 +240,10 @@ pub fn start_desktop(config: &CrateConfig) -> Result<(Child, BuildResult)> { if cfg!(windows) { file.set_extension("exe"); } - let child = Command::new(file.to_str().unwrap()).spawn()?; + let active = "DIOXUS_ACTIVE"; + let child = Command::new(file.to_str().unwrap()) + .env(active, "true") + .spawn()?; Ok((child, result)) } diff --git a/packages/desktop/src/protocol.rs b/packages/desktop/src/protocol.rs index 8ec5e1821..3d03ac3eb 100644 --- a/packages/desktop/src/protocol.rs +++ b/packages/desktop/src/protocol.rs @@ -158,7 +158,7 @@ fn get_asset_root() -> Option { */ - if std::env::var_os("CARGO").is_some() { + if std::env::var_os("CARGO").is_some() || std::env::var_os("DIOXUS_ACTIVE").is_some() { return None; } From bd743fa2f93c375d0bef39056636ca62125c2d64 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Fri, 18 Aug 2023 13:55:00 -0500 Subject: [PATCH 015/447] Add fullstack platform to serve and build commands --- packages/cli/src/cli/build.rs | 26 ++++++ packages/cli/src/cli/cfg.rs | 35 ++++++++ packages/cli/src/cli/serve.rs | 6 +- packages/cli/src/server/desktop/mod.rs | 105 +++++++++++++---------- packages/cli/src/server/fullstack/mod.rs | 72 ++++++++++++++++ packages/cli/src/server/mod.rs | 10 ++- packages/cli/src/server/web/mod.rs | 4 +- 7 files changed, 209 insertions(+), 49 deletions(-) create mode 100644 packages/cli/src/server/fullstack/mod.rs diff --git a/packages/cli/src/cli/build.rs b/packages/cli/src/cli/build.rs index 3053a6e5a..5d111b797 100644 --- a/packages/cli/src/cli/build.rs +++ b/packages/cli/src/cli/build.rs @@ -47,6 +47,32 @@ impl Build { Platform::Desktop => { crate::builder::build_desktop(&crate_config, false)?; } + Platform::Fullstack => { + { + let mut web_config = crate_config.clone(); + let web_feature = self.build.client_feature; + let features = &mut web_config.features; + match features { + Some(features) => { + features.push(web_feature); + } + None => web_config.features = Some(vec![web_feature]), + }; + crate::builder::build(&crate_config, false)?; + } + { + let mut desktop_config = crate_config.clone(); + let desktop_feature = self.build.server_feature; + let features = &mut desktop_config.features; + match features { + Some(features) => { + features.push(desktop_feature); + } + None => desktop_config.features = Some(vec![desktop_feature]), + }; + crate::builder::build_desktop(&desktop_config, false)?; + } + } } let temp = gen_page(&crate_config.dioxus_config, false); diff --git a/packages/cli/src/cli/cfg.rs b/packages/cli/src/cli/cfg.rs index 2a441a1c8..bbe3119d3 100644 --- a/packages/cli/src/cli/cfg.rs +++ b/packages/cli/src/cli/cfg.rs @@ -35,6 +35,30 @@ pub struct ConfigOptsBuild { /// Space separated list of features to activate #[clap(long)] pub features: Option>, + + /// The feature to use for the client in a fullstack app [default: "web"] + #[clap(long, default_value_t = { "web".to_string() })] + pub client_feature: String, + + /// The feature to use for the server in a fullstack app [default: "ssr"] + #[clap(long, default_value_t = { "ssr".to_string() })] + pub server_feature: String, +} + +impl From for ConfigOptsBuild { + fn from(serve: ConfigOptsServe) -> Self { + Self { + target: serve.target, + release: serve.release, + verbose: serve.verbose, + example: serve.example, + profile: serve.profile, + platform: serve.platform, + features: serve.features, + client_feature: serve.client_feature, + server_feature: serve.server_feature, + } + } } #[derive(Clone, Debug, Default, Deserialize, Parser)] @@ -89,6 +113,14 @@ pub struct ConfigOptsServe { /// Space separated list of features to activate #[clap(long)] pub features: Option>, + + /// The feature to use for the client in a fullstack app [default: "web"] + #[clap(long, default_value_t = { "web".to_string() })] + pub client_feature: String, + + /// The feature to use for the server in a fullstack app [default: "ssr"] + #[clap(long, default_value_t = { "ssr".to_string() })] + pub server_feature: String, } #[derive(Copy, Clone, PartialEq, Eq, PartialOrd, Ord, ValueEnum, Serialize, Deserialize, Debug)] @@ -99,6 +131,9 @@ pub enum Platform { #[clap(name = "desktop")] #[serde(rename = "desktop")] Desktop, + #[clap(name = "fullstack")] + #[serde(rename = "fullstack")] + Fullstack, } /// Config options for the bundling system. diff --git a/packages/cli/src/cli/serve.rs b/packages/cli/src/cli/serve.rs index 433d611b7..74cfcbe6e 100644 --- a/packages/cli/src/cli/serve.rs +++ b/packages/cli/src/cli/serve.rs @@ -12,6 +12,7 @@ pub struct Serve { impl Serve { pub async fn serve(self, bin: Option) -> Result<()> { let mut crate_config = crate::CrateConfig::new(bin)?; + let serve_cfg = self.serve.clone(); // change the relase state. crate_config.with_hot_reload(self.serve.hot_reload); @@ -49,7 +50,10 @@ impl Serve { .await?; } cfg::Platform::Desktop => { - server::desktop::startup(crate_config.clone()).await?; + server::desktop::startup(crate_config.clone(), &serve_cfg).await?; + } + cfg::Platform::Fullstack => { + server::fullstack::startup(crate_config.clone(), &serve_cfg).await?; } } Ok(()) diff --git a/packages/cli/src/server/desktop/mod.rs b/packages/cli/src/server/desktop/mod.rs index 9b79bdea9..3662ac986 100644 --- a/packages/cli/src/server/desktop/mod.rs +++ b/packages/cli/src/server/desktop/mod.rs @@ -1,4 +1,5 @@ use crate::{ + cfg::ConfigOptsServe, server::{ output::{print_console_info, PrettierOptions}, setup_file_watcher, setup_file_watcher_hot_reload, @@ -19,7 +20,16 @@ use tokio::sync::broadcast::{self}; #[cfg(feature = "plugin")] use plugin::PluginManager; -pub async fn startup(config: CrateConfig) -> Result<()> { +use super::Platform; + +pub async fn startup(config: CrateConfig, serve: &ConfigOptsServe) -> Result<()> { + startup_with_platform::(config, serve).await +} + +pub(crate) async fn startup_with_platform( + config: CrateConfig, + serve: &ConfigOptsServe, +) -> Result<()> { // ctrl-c shutdown checker let _crate_config = config.clone(); let _ = ctrlc::set_handler(move || { @@ -29,17 +39,19 @@ pub async fn startup(config: CrateConfig) -> Result<()> { }); match config.hot_reload { - true => serve_hot_reload(config).await?, - false => serve_default(config).await?, + true => serve_hot_reload::

(config, serve).await?, + false => serve_default::

(config, serve).await?, } Ok(()) } /// Start the server without hot reload -pub async fn serve_default(config: CrateConfig) -> Result<()> { - let (child, first_build_result) = start_desktop(&config)?; - let currently_running_child: RwLock = RwLock::new(child); +async fn serve_default( + config: CrateConfig, + serve: &ConfigOptsServe, +) -> Result<()> { + let platform = RwLock::new(P::start(&config, serve)?); log::info!("πŸš€ Starting development server..."); @@ -49,49 +61,29 @@ pub async fn serve_default(config: CrateConfig) -> Result<()> { { let config = config.clone(); - move || { - let mut current_child = currently_running_child.write().unwrap(); - current_child.kill()?; - let (child, result) = start_desktop(&config)?; - *current_child = child; - Ok(result) - } + move || platform.write().unwrap().rebuild(&config) }, &config, None, ) .await?; - // Print serve info - print_console_info( - &config, - PrettierOptions { - changed: vec![], - warnings: first_build_result.warnings, - elapsed_time: first_build_result.elapsed_time, - }, - None, - ); - std::future::pending::<()>().await; Ok(()) } -/// Start the server without hot reload - /// Start dx serve with hot reload -pub async fn serve_hot_reload(config: CrateConfig) -> Result<()> { - let (_, first_build_result) = start_desktop(&config)?; - - println!("πŸš€ Starting development server..."); +async fn serve_hot_reload( + config: CrateConfig, + serve: &ConfigOptsServe, +) -> Result<()> { + let platform = RwLock::new(P::start(&config, serve)?); // Setup hot reload let FileMapBuildResult { map, errors } = FileMap::::create(config.crate_dir.clone()).unwrap(); - println!("πŸš€ Starting development server..."); - for err in errors { log::error!("{}", err); } @@ -119,24 +111,13 @@ pub async fn serve_hot_reload(config: CrateConfig) -> Result<()> { for channel in &mut *channels.lock().unwrap() { send_msg(HotReloadMsg::Shutdown, channel); } - Ok(start_desktop(&config)?.1) + Ok(platform.write().unwrap().rebuild(&config)?) } }, None, ) .await?; - // Print serve info - print_console_info( - &config, - PrettierOptions { - changed: vec![], - warnings: first_build_result.warnings, - elapsed_time: first_build_result.elapsed_time, - }, - None, - ); - clear_paths(); match LocalSocketListener::bind("@dioxusin") { @@ -228,7 +209,7 @@ fn send_msg(msg: HotReloadMsg, channel: &mut impl std::io::Write) -> bool { } } -pub fn start_desktop(config: &CrateConfig) -> Result<(Child, BuildResult)> { +fn start_desktop(config: &CrateConfig) -> Result<(Child, BuildResult)> { // Run the desktop application let result = crate::builder::build_desktop(config, true)?; @@ -246,3 +227,37 @@ pub fn start_desktop(config: &CrateConfig) -> Result<(Child, BuildResult)> { } } } + +pub(crate) struct DesktopPlatform { + currently_running_child: Child, +} + +impl Platform for DesktopPlatform { + fn start(config: &CrateConfig, _serve: &ConfigOptsServe) -> Result { + let (child, first_build_result) = start_desktop(&config)?; + + log::info!("πŸš€ Starting development server..."); + + // Print serve info + print_console_info( + &config, + PrettierOptions { + changed: vec![], + warnings: first_build_result.warnings, + elapsed_time: first_build_result.elapsed_time, + }, + None, + ); + + Ok(Self { + currently_running_child: child, + }) + } + + fn rebuild(&mut self, config: &CrateConfig) -> Result { + self.currently_running_child.kill()?; + let (child, result) = start_desktop(&config)?; + self.currently_running_child = child; + Ok(result) + } +} diff --git a/packages/cli/src/server/fullstack/mod.rs b/packages/cli/src/server/fullstack/mod.rs new file mode 100644 index 000000000..16ab31c44 --- /dev/null +++ b/packages/cli/src/server/fullstack/mod.rs @@ -0,0 +1,72 @@ +use crate::{ + cfg::{ConfigOptsBuild, ConfigOptsServe}, + CrateConfig, Result, +}; + +use super::{desktop, Platform}; + +pub async fn startup(config: CrateConfig, serve: &ConfigOptsServe) -> Result<()> { + desktop::startup_with_platform::(config, serve).await +} + +struct FullstackPlatform { + serve: ConfigOptsServe, + desktop: desktop::DesktopPlatform, +} + +impl Platform for FullstackPlatform { + fn start(config: &CrateConfig, serve: &ConfigOptsServe) -> Result + where + Self: Sized, + { + { + build_web(serve.clone())?; + } + + let mut desktop_config = config.clone(); + let desktop_feature = serve.server_feature.clone(); + let features = &mut desktop_config.features; + match features { + Some(features) => { + features.push(desktop_feature); + } + None => desktop_config.features = Some(vec![desktop_feature]), + }; + let desktop = desktop::DesktopPlatform::start(&desktop_config, serve)?; + + Ok(Self { + desktop, + serve: serve.clone(), + }) + } + + fn rebuild(&mut self, crate_config: &CrateConfig) -> Result { + build_web(self.serve.clone())?; + { + let mut desktop_config = crate_config.clone(); + let desktop_feature = self.serve.server_feature.clone(); + let features = &mut desktop_config.features; + match features { + Some(features) => { + features.push(desktop_feature); + } + None => desktop_config.features = Some(vec![desktop_feature]), + }; + self.desktop.rebuild(&desktop_config) + } + } +} + +fn build_web(serve: ConfigOptsServe) -> Result<()> { + let mut web_config: ConfigOptsBuild = serve.into(); + let web_feature = web_config.client_feature.clone(); + let features = &mut web_config.features; + match features { + Some(features) => { + features.push(web_feature); + } + None => web_config.features = Some(vec![web_feature]), + }; + web_config.platform = Some(crate::cfg::Platform::Web); + crate::cli::build::Build { build: web_config }.build(None) +} diff --git a/packages/cli/src/server/mod.rs b/packages/cli/src/server/mod.rs index 19dc44b75..1571a198e 100644 --- a/packages/cli/src/server/mod.rs +++ b/packages/cli/src/server/mod.rs @@ -1,4 +1,4 @@ -use crate::{BuildResult, CrateConfig, Result}; +use crate::{cfg::ConfigOptsServe, BuildResult, CrateConfig, Result}; use cargo_metadata::diagnostic::Diagnostic; use dioxus_core::Template; @@ -14,6 +14,7 @@ use tokio::sync::broadcast::Sender; mod output; use output::*; pub mod desktop; +pub mod fullstack; pub mod web; /// Sets up a file watcher @@ -180,3 +181,10 @@ async fn setup_file_watcher_hot_reload Result + Send + ' Ok(watcher) } + +pub(crate) trait Platform { + fn start(config: &CrateConfig, serve: &ConfigOptsServe) -> Result + where + Self: Sized; + fn rebuild(&mut self, config: &CrateConfig) -> Result; +} diff --git a/packages/cli/src/server/web/mod.rs b/packages/cli/src/server/web/mod.rs index 78eddb574..7f09dca6c 100644 --- a/packages/cli/src/server/web/mod.rs +++ b/packages/cli/src/server/web/mod.rs @@ -67,7 +67,7 @@ pub async fn startup(port: u16, config: CrateConfig, start_browser: bool) -> Res } /// Start the server without hot reload -pub async fn serve_default( +async fn serve_default( ip: String, port: u16, config: CrateConfig, @@ -128,7 +128,7 @@ pub async fn serve_default( } /// Start dx serve with hot reload -pub async fn serve_hot_reload( +async fn serve_hot_reload( ip: String, port: u16, config: CrateConfig, From e3aac14ec98fdfba015292342f88dd1d902b8ab1 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Fri, 18 Aug 2023 13:57:05 -0500 Subject: [PATCH 016/447] make clippy happy --- packages/cli/src/server/desktop/mod.rs | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/packages/cli/src/server/desktop/mod.rs b/packages/cli/src/server/desktop/mod.rs index 3662ac986..72a84a5c7 100644 --- a/packages/cli/src/server/desktop/mod.rs +++ b/packages/cli/src/server/desktop/mod.rs @@ -111,7 +111,7 @@ async fn serve_hot_reload( for channel in &mut *channels.lock().unwrap() { send_msg(HotReloadMsg::Shutdown, channel); } - Ok(platform.write().unwrap().rebuild(&config)?) + platform.write().unwrap().rebuild(&config) } }, None, @@ -234,13 +234,13 @@ pub(crate) struct DesktopPlatform { impl Platform for DesktopPlatform { fn start(config: &CrateConfig, _serve: &ConfigOptsServe) -> Result { - let (child, first_build_result) = start_desktop(&config)?; + let (child, first_build_result) = start_desktop(config)?; log::info!("πŸš€ Starting development server..."); // Print serve info print_console_info( - &config, + config, PrettierOptions { changed: vec![], warnings: first_build_result.warnings, @@ -256,7 +256,7 @@ impl Platform for DesktopPlatform { fn rebuild(&mut self, config: &CrateConfig) -> Result { self.currently_running_child.kill()?; - let (child, result) = start_desktop(&config)?; + let (child, result) = start_desktop(config)?; self.currently_running_child = child; Ok(result) } From 1c5835245685c8c07056be9fbb8213273a17472b Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Fri, 18 Aug 2023 14:30:23 -0500 Subject: [PATCH 017/447] implement fullstack assets integration --- packages/cli/src/builder.rs | 10 +++++----- packages/cli/src/cli/build.rs | 4 +++- packages/cli/src/server/fullstack/mod.rs | 5 ++++- 3 files changed, 12 insertions(+), 7 deletions(-) diff --git a/packages/cli/src/builder.rs b/packages/cli/src/builder.rs index 9e445ed7a..28466bd02 100644 --- a/packages/cli/src/builder.rs +++ b/packages/cli/src/builder.rs @@ -40,7 +40,7 @@ pub fn build(config: &CrateConfig, quiet: bool) -> Result { .. } = config; - let _gaurd = AssetConfigDropGaurd::new(); + let _gaurd = WebAssetConfigDropGuard::new(); // start to build the assets let ignore_files = build_assets(config)?; @@ -445,7 +445,7 @@ fn prettier_build(cmd: subprocess::Exec) -> anyhow::Result> { } pub fn gen_page(config: &CrateConfig, serve: bool) -> String { - let _gaurd = AssetConfigDropGaurd::new(); + let _gaurd = WebAssetConfigDropGuard::new(); let crate_root = crate::cargo::crate_root().unwrap(); let custom_html_file = crate_root.join("index.html"); @@ -764,9 +764,9 @@ fn process_assets(config: &CrateConfig) -> anyhow::Result<()> { // )?) // } -struct AssetConfigDropGaurd; +pub(crate) struct WebAssetConfigDropGuard; -impl AssetConfigDropGaurd { +impl WebAssetConfigDropGuard { pub fn new() -> Self { // Set up the collect asset config assets_cli_support::Config::default() @@ -776,7 +776,7 @@ impl AssetConfigDropGaurd { } } -impl Drop for AssetConfigDropGaurd { +impl Drop for WebAssetConfigDropGuard { fn drop(&mut self) { // Reset the config assets_cli_support::Config::default().save(); diff --git a/packages/cli/src/cli/build.rs b/packages/cli/src/cli/build.rs index 581e69326..9c5de4b9c 100644 --- a/packages/cli/src/cli/build.rs +++ b/packages/cli/src/cli/build.rs @@ -1,6 +1,6 @@ -use crate::cfg::Platform; #[cfg(feature = "plugin")] use crate::plugin::PluginManager; +use crate::{cfg::Platform, WebAssetConfigDropGuard}; use super::*; @@ -48,6 +48,8 @@ impl Build { crate::builder::build_desktop(&crate_config, false)?; } Platform::Fullstack => { + // Fullstack mode must be built with web configs on the desktop (server) binary as well as the web binary + let _config = WebAssetConfigDropGuard::new(); { let mut web_config = crate_config.clone(); let web_feature = self.build.client_feature; diff --git a/packages/cli/src/server/fullstack/mod.rs b/packages/cli/src/server/fullstack/mod.rs index 16ab31c44..ae8d1859a 100644 --- a/packages/cli/src/server/fullstack/mod.rs +++ b/packages/cli/src/server/fullstack/mod.rs @@ -1,6 +1,6 @@ use crate::{ cfg::{ConfigOptsBuild, ConfigOptsServe}, - CrateConfig, Result, + CrateConfig, Result, WebAssetConfigDropGuard, }; use super::{desktop, Platform}; @@ -12,6 +12,7 @@ pub async fn startup(config: CrateConfig, serve: &ConfigOptsServe) -> Result<()> struct FullstackPlatform { serve: ConfigOptsServe, desktop: desktop::DesktopPlatform, + _config: WebAssetConfigDropGuard, } impl Platform for FullstackPlatform { @@ -32,11 +33,13 @@ impl Platform for FullstackPlatform { } None => desktop_config.features = Some(vec![desktop_feature]), }; + let config = WebAssetConfigDropGuard::new(); let desktop = desktop::DesktopPlatform::start(&desktop_config, serve)?; Ok(Self { desktop, serve: serve.clone(), + _config: config, }) } From 1a36409922795cf4b68c3a3704221417f6f962fe Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Fri, 18 Aug 2023 14:43:56 -0500 Subject: [PATCH 018/447] disable asset patching in cargo run for mobile --- packages/desktop/Cargo.toml | 4 ++-- packages/desktop/src/collect_assets.rs | 26 ++++++++++++++++++++++++-- packages/desktop/src/protocol.rs | 26 ++++++++++++++++++++++++-- packages/desktop/src/webview.rs | 26 ++++++++++++++++++++++++-- 4 files changed, 74 insertions(+), 8 deletions(-) diff --git a/packages/desktop/Cargo.toml b/packages/desktop/Cargo.toml index 6254c7ff8..b9c36fb3e 100644 --- a/packages/desktop/Cargo.toml +++ b/packages/desktop/Cargo.toml @@ -38,9 +38,9 @@ futures-util = { workspace = true } urlencoding = "2.1.2" async-trait = "0.1.68" -assets-cli-support = { git = "https://github.com/DioxusLabs/collect-assets", features = ["webp", "html"] } - [target.'cfg(any(target_os = "windows",target_os = "macos",target_os = "linux",target_os = "dragonfly", target_os = "freebsd", target_os = "netbsd", target_os = "openbsd"))'.dependencies] +# This is only for debug mode, and it appears mobile does not support some packages this uses +assets-cli-support = { git = "https://github.com/DioxusLabs/collect-assets", features = ["webp", "html"] } rfd = "0.11.3" [target.'cfg(target_os = "ios")'.dependencies] diff --git a/packages/desktop/src/collect_assets.rs b/packages/desktop/src/collect_assets.rs index 65b36fede..5a36a191a 100644 --- a/packages/desktop/src/collect_assets.rs +++ b/packages/desktop/src/collect_assets.rs @@ -1,5 +1,16 @@ pub fn copy_assets() { - #[cfg(debug_assertions)] + #[cfg(all( + debug_assertions, + any( + target_os = "windows", + target_os = "macos", + target_os = "linux", + target_os = "dragonfly", + target_os = "freebsd", + target_os = "netbsd", + target_os = "openbsd" + ) + ))] { use assets_cli_support::AssetManifest; use assets_cli_support::AssetManifestExt; @@ -22,7 +33,18 @@ pub fn copy_assets() { println!("Copied assets to {}", asset_location.display()); } } - #[cfg(not(debug_assertions))] + #[cfg(not(all( + debug_assertions, + any( + target_os = "windows", + target_os = "macos", + target_os = "linux", + target_os = "dragonfly", + target_os = "freebsd", + target_os = "netbsd", + target_os = "openbsd" + ) + )))] { println!( "Skipping assets in release mode. You compile assets with the dioxus-cli in release mode" diff --git a/packages/desktop/src/protocol.rs b/packages/desktop/src/protocol.rs index 3d03ac3eb..810cb96c6 100644 --- a/packages/desktop/src/protocol.rs +++ b/packages/desktop/src/protocol.rs @@ -74,13 +74,35 @@ pub(super) fn desktop_handler( #[allow(unused_mut)] let mut head = custom_head.unwrap_or_default(); - #[cfg(debug_assertions)] + #[cfg(all( + debug_assertions, + any( + target_os = "windows", + target_os = "macos", + target_os = "linux", + target_os = "dragonfly", + target_os = "freebsd", + target_os = "netbsd", + target_os = "openbsd" + ) + ))] { use assets_cli_support::AssetManifestExt; let manifest = assets_cli_support::AssetManifest::load(); head += &manifest.head(); } - #[cfg(not(debug_assertions))] + #[cfg(not(all( + debug_assertions, + any( + target_os = "windows", + target_os = "macos", + target_os = "linux", + target_os = "dragonfly", + target_os = "freebsd", + target_os = "netbsd", + target_os = "openbsd" + ) + )))] { if let Some(assets_head) = assets_head { head += &assets_head; diff --git a/packages/desktop/src/webview.rs b/packages/desktop/src/webview.rs index a464653b8..2dfc1d325 100644 --- a/packages/desktop/src/webview.rs +++ b/packages/desktop/src/webview.rs @@ -19,11 +19,33 @@ pub fn build( let index_file = cfg.custom_index.clone(); let root_name = cfg.root_name.clone(); let assets_head = { - #[cfg(debug_assertions)] + #[cfg(all( + debug_assertions, + any( + target_os = "windows", + target_os = "macos", + target_os = "linux", + target_os = "dragonfly", + target_os = "freebsd", + target_os = "netbsd", + target_os = "openbsd" + ) + ))] { None } - #[cfg(not(debug_assertions))] + #[cfg(not(all( + debug_assertions, + any( + target_os = "windows", + target_os = "macos", + target_os = "linux", + target_os = "dragonfly", + target_os = "freebsd", + target_os = "netbsd", + target_os = "openbsd" + ) + )))] { let head = crate::protocol::get_asset_root_or_default(); let head = head.join("dist/__assets_head.html"); From 4ee2bc259d96c944b258ca570db452fff0e2eb72 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Fri, 18 Aug 2023 14:45:03 -0500 Subject: [PATCH 019/447] fix clippy --- packages/cli/src/builder.rs | 4 ++-- packages/cli/src/cli/serve.rs | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/packages/cli/src/builder.rs b/packages/cli/src/builder.rs index 28466bd02..ceeecb50b 100644 --- a/packages/cli/src/builder.rs +++ b/packages/cli/src/builder.rs @@ -354,7 +354,7 @@ pub fn build_desktop(config: &CrateConfig, _is_serve: bool) -> Result anyhow::Result<()> { ); let static_asset_output_dir = config.out_dir.join(static_asset_output_dir); - manifest.copy_static_assets_to(&static_asset_output_dir)?; + manifest.copy_static_assets_to(static_asset_output_dir)?; Ok(()) } diff --git a/packages/cli/src/cli/serve.rs b/packages/cli/src/cli/serve.rs index 6de136167..195b1ddf8 100644 --- a/packages/cli/src/cli/serve.rs +++ b/packages/cli/src/cli/serve.rs @@ -60,7 +60,7 @@ impl Serve { } pub fn regen_dev_page(crate_config: &CrateConfig) -> Result<()> { - let serve_html = gen_page(&crate_config, true); + let serve_html = gen_page(crate_config, true); let dist_path = crate_config.crate_dir.join( crate_config From 5eca11fe3d1b97118aac0e167c1d01a7c7820601 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Fri, 18 Aug 2023 14:54:57 -0500 Subject: [PATCH 020/447] update collect assets name --- packages/cli/Cargo.toml | 2 +- packages/cli/src/builder.rs | 6 +++--- packages/cli/src/cli/bundle.rs | 2 +- packages/cli/src/config.rs | 4 ++-- packages/desktop/Cargo.toml | 2 +- packages/desktop/src/collect_assets.rs | 6 +++--- packages/desktop/src/protocol.rs | 4 ++-- 7 files changed, 13 insertions(+), 13 deletions(-) diff --git a/packages/cli/Cargo.toml b/packages/cli/Cargo.toml index fee52a4f0..bca4e07bd 100644 --- a/packages/cli/Cargo.toml +++ b/packages/cli/Cargo.toml @@ -81,7 +81,7 @@ toml_edit = "0.19.11" tauri-bundler = { version = "1.2", features = ["native-tls-vendored"] } tauri-utils = "1.3" -assets-cli-support = { git = "https://github.com/DioxusLabs/collect-assets", features = ["webp", "html"] } +manganis-cli-support= { git = "https://github.com/DioxusLabs/collect-assets", features = ["webp", "html"] } dioxus-autofmt = { workspace = true } dioxus-check = { workspace = true } diff --git a/packages/cli/src/builder.rs b/packages/cli/src/builder.rs index ceeecb50b..371a1291f 100644 --- a/packages/cli/src/builder.rs +++ b/packages/cli/src/builder.rs @@ -3,9 +3,9 @@ use crate::{ error::{Error, Result}, tools::Tool, }; -use assets_cli_support::AssetManifestExt; use cargo_metadata::{diagnostic::Diagnostic, Message}; use indicatif::{ProgressBar, ProgressStyle}; +use manganis_cli_support::AssetManifestExt; use serde::Serialize; use std::{ fs::{copy, create_dir_all, File}, @@ -769,7 +769,7 @@ pub(crate) struct WebAssetConfigDropGuard; impl WebAssetConfigDropGuard { pub fn new() -> Self { // Set up the collect asset config - assets_cli_support::Config::default() + manganis_cli_support::Config::default() .with_assets_serve_location("/") .save(); Self {} @@ -779,6 +779,6 @@ impl WebAssetConfigDropGuard { impl Drop for WebAssetConfigDropGuard { fn drop(&mut self) { // Reset the config - assets_cli_support::Config::default().save(); + manganis_cli_support::Config::default().save(); } } diff --git a/packages/cli/src/cli/bundle.rs b/packages/cli/src/cli/bundle.rs index 42c5e6ab6..49979362c 100644 --- a/packages/cli/src/cli/bundle.rs +++ b/packages/cli/src/cli/bundle.rs @@ -130,7 +130,7 @@ impl Bundle { // Add all assets from collect assets to the bundle { - let config = assets_cli_support::Config::current(); + let config = manganis_cli_support::Config::current(); let location = config.assets_serve_location().to_string(); let location = format!("./{}", location); println!("Adding assets from {} to bundle", location); diff --git a/packages/cli/src/config.rs b/packages/cli/src/config.rs index b5345a8a4..34a6caa2a 100644 --- a/packages/cli/src/config.rs +++ b/packages/cli/src/config.rs @@ -1,6 +1,6 @@ use crate::{cfg::Platform, error::Result}; -use assets_cli_support::AssetManifest; -use assets_cli_support::AssetManifestExt; +use manganis_cli_support::AssetManifest; +use manganis_cli_support::AssetManifestExt; use serde::{Deserialize, Serialize}; use std::{ collections::HashMap, diff --git a/packages/desktop/Cargo.toml b/packages/desktop/Cargo.toml index b9c36fb3e..a981e8b1e 100644 --- a/packages/desktop/Cargo.toml +++ b/packages/desktop/Cargo.toml @@ -40,7 +40,7 @@ async-trait = "0.1.68" [target.'cfg(any(target_os = "windows",target_os = "macos",target_os = "linux",target_os = "dragonfly", target_os = "freebsd", target_os = "netbsd", target_os = "openbsd"))'.dependencies] # This is only for debug mode, and it appears mobile does not support some packages this uses -assets-cli-support = { git = "https://github.com/DioxusLabs/collect-assets", features = ["webp", "html"] } +manganis-cli-support = { git = "https://github.com/DioxusLabs/collect-assets", features = ["webp", "html"] } rfd = "0.11.3" [target.'cfg(target_os = "ios")'.dependencies] diff --git a/packages/desktop/src/collect_assets.rs b/packages/desktop/src/collect_assets.rs index 5a36a191a..d0e18d9a8 100644 --- a/packages/desktop/src/collect_assets.rs +++ b/packages/desktop/src/collect_assets.rs @@ -12,9 +12,9 @@ pub fn copy_assets() { ) ))] { - use assets_cli_support::AssetManifest; - use assets_cli_support::AssetManifestExt; - use assets_cli_support::Config; + use manganis_cli_support::AssetManifest; + use manganis_cli_support::AssetManifestExt; + use manganis_cli_support::Config; use std::path::PathBuf; let config = Config::current(); let asset_location = config.assets_serve_location(); diff --git a/packages/desktop/src/protocol.rs b/packages/desktop/src/protocol.rs index 810cb96c6..7a9e0b8e7 100644 --- a/packages/desktop/src/protocol.rs +++ b/packages/desktop/src/protocol.rs @@ -87,8 +87,8 @@ pub(super) fn desktop_handler( ) ))] { - use assets_cli_support::AssetManifestExt; - let manifest = assets_cli_support::AssetManifest::load(); + use manganis_cli_support::AssetManifestExt; + let manifest = manganis_cli_support::AssetManifest::load(); head += &manifest.head(); } #[cfg(not(all( From df85b25548cfff642af2b4ac4a4521b53027cb52 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Mon, 21 Aug 2023 14:23:02 -0500 Subject: [PATCH 021/447] Add debug information to borrows and ownership in signals --- packages/generational-box/Cargo.toml | 1 + packages/generational-box/src/lib.rs | 445 ++++++++++++++++++++++++--- packages/signals/src/effect.rs | 2 +- packages/signals/src/impls.rs | 33 +- packages/signals/src/rt.rs | 33 +- packages/signals/src/signal.rs | 58 +++- 6 files changed, 497 insertions(+), 75 deletions(-) diff --git a/packages/generational-box/Cargo.toml b/packages/generational-box/Cargo.toml index 6c5a5a841..cc0db9cec 100644 --- a/packages/generational-box/Cargo.toml +++ b/packages/generational-box/Cargo.toml @@ -15,3 +15,4 @@ rand = "0.8.5" [features] default = ["check_generation"] check_generation = [] +debug_borrows = [] diff --git a/packages/generational-box/src/lib.rs b/packages/generational-box/src/lib.rs index 60bd41419..7d64a1ed3 100644 --- a/packages/generational-box/src/lib.rs +++ b/packages/generational-box/src/lib.rs @@ -2,9 +2,13 @@ #![warn(missing_docs)] use std::{ + any::Any, cell::{Cell, Ref, RefCell, RefMut}, - fmt::Debug, + error::Error, + fmt::{Debug, Display}, marker::PhantomData, + ops::{Deref, DerefMut}, + panic::Location, rc::Rc, }; @@ -153,6 +157,8 @@ pub struct GenerationalBox { raw: MemoryLocation, #[cfg(any(debug_assertions, feature = "check_generation"))] generation: u32, + #[cfg(any(debug_assertions, feature = "check_generation"))] + created_at: &'static std::panic::Location<'static>, _marker: PhantomData, } @@ -161,7 +167,7 @@ impl Debug for GenerationalBox { #[cfg(any(debug_assertions, feature = "check_generation"))] f.write_fmt(format_args!( "{:?}@{:?}", - self.raw.data.as_ptr(), + self.raw.0.data.as_ptr(), self.generation ))?; #[cfg(not(any(debug_assertions, feature = "check_generation")))] @@ -175,7 +181,7 @@ impl GenerationalBox { fn validate(&self) -> bool { #[cfg(any(debug_assertions, feature = "check_generation"))] { - self.raw.generation.get() == self.generation + self.raw.0.generation.get() == self.generation } #[cfg(not(any(debug_assertions, feature = "check_generation")))] { @@ -184,43 +190,51 @@ impl GenerationalBox { } /// Try to read the value. Returns None if the value is no longer valid. - pub fn try_read(&self) -> Option> { - self.validate() - .then(|| { - Ref::filter_map(self.raw.data.borrow(), |any| { - any.as_ref()?.downcast_ref::() - }) - .ok() - }) - .flatten() + #[track_caller] + pub fn try_read(&self) -> Result, BorrowError> { + if !self.validate() { + return Err(BorrowError::Dropped(ValueDroppedError { + #[cfg(any(debug_assertions, feature = "debug_borrows"))] + created_at: self.created_at, + })); + } + self.raw.try_borrow( + #[cfg(any(debug_assertions, feature = "debug_borrows"))] + self.created_at, + ) } /// Read the value. Panics if the value is no longer valid. - pub fn read(&self) -> Ref<'_, T> { + #[track_caller] + pub fn read(&self) -> GenerationalRef<'_, T> { self.try_read().unwrap() } /// Try to write the value. Returns None if the value is no longer valid. - pub fn try_write(&self) -> Option> { - self.validate() - .then(|| { - RefMut::filter_map(self.raw.data.borrow_mut(), |any| { - any.as_mut()?.downcast_mut::() - }) - .ok() - }) - .flatten() + #[track_caller] + pub fn try_write(&self) -> Result, BorrowMutError> { + if !self.validate() { + return Err(BorrowMutError::Dropped(ValueDroppedError { + #[cfg(any(debug_assertions, feature = "debug_borrows"))] + created_at: self.created_at, + })); + } + self.raw.try_borrow_mut( + #[cfg(any(debug_assertions, feature = "debug_borrows"))] + self.created_at, + ) } /// Write the value. Panics if the value is no longer valid. - pub fn write(&self) -> RefMut<'_, T> { + #[track_caller] + pub fn write(&self) -> GenerationalRefMut<'_, T> { self.try_write().unwrap() } /// Set the value. Panics if the value is no longer valid. pub fn set(&self, value: T) { self.validate().then(|| { - *self.raw.data.borrow_mut() = Some(Box::new(value)); + *self.raw.0.data.borrow_mut() = Some(Box::new(value)); }); } @@ -228,7 +242,8 @@ impl GenerationalBox { pub fn ptr_eq(&self, other: &Self) -> bool { #[cfg(any(debug_assertions, feature = "check_generation"))] { - self.raw.data.as_ptr() == other.raw.data.as_ptr() && self.generation == other.generation + self.raw.0.data.as_ptr() == other.raw.0.data.as_ptr() + && self.generation == other.generation } #[cfg(not(any(debug_assertions, feature = "check_generation")))] { @@ -246,26 +261,38 @@ impl Clone for GenerationalBox { } #[derive(Clone, Copy)] -struct MemoryLocation { - data: &'static RefCell>>, +struct MemoryLocation(&'static MemoryLocationInner); + +struct MemoryLocationInner { + data: RefCell>>, #[cfg(any(debug_assertions, feature = "check_generation"))] - generation: &'static Cell, + generation: Cell, + #[cfg(any(debug_assertions, feature = "debug_borrows"))] + borrowed_at: RefCell>>, + #[cfg(any(debug_assertions, feature = "debug_borrows"))] + borrowed_mut_at: Cell>>, } impl MemoryLocation { #[allow(unused)] fn drop(&self) { - let old = self.data.borrow_mut().take(); + let old = self.0.data.borrow_mut().take(); #[cfg(any(debug_assertions, feature = "check_generation"))] if old.is_some() { drop(old); - let new_generation = self.generation.get() + 1; - self.generation.set(new_generation); + let new_generation = self.0.generation.get() + 1; + self.0.generation.set(new_generation); } } - fn replace(&mut self, value: T) -> GenerationalBox { - let mut inner_mut = self.data.borrow_mut(); + fn replace_with_caller( + &mut self, + value: T, + #[cfg(any(debug_assertions, feature = "check_generation"))] caller: &'static Location< + 'static, + >, + ) -> GenerationalBox { + let mut inner_mut = self.0.data.borrow_mut(); let raw = Box::new(value); let old = inner_mut.replace(raw); @@ -273,10 +300,318 @@ impl MemoryLocation { GenerationalBox { raw: *self, #[cfg(any(debug_assertions, feature = "check_generation"))] - generation: self.generation.get(), + generation: self.0.generation.get(), + #[cfg(any(debug_assertions, feature = "check_generation"))] + created_at: caller, _marker: PhantomData, } } + + #[track_caller] + fn try_borrow( + &self, + #[cfg(any(debug_assertions, feature = "debug_borrows"))] + created_at: &'static std::panic::Location<'static>, + ) -> Result, BorrowError> { + #[cfg(any(debug_assertions, feature = "debug_borrows"))] + self.0 + .borrowed_at + .borrow_mut() + .push(std::panic::Location::caller()); + match self.0.data.try_borrow() { + Ok(borrow) => match Ref::filter_map(borrow, |any| any.as_ref()?.downcast_ref::()) { + Ok(reference) => Ok(GenerationalRef { + inner: reference, + #[cfg(any(debug_assertions, feature = "debug_borrows"))] + borrow: GenerationalRefBorrowInfo { + borrowed_at: std::panic::Location::caller(), + borrowed_from: self.0, + }, + }), + Err(_) => Err(BorrowError::Dropped(ValueDroppedError { + #[cfg(any(debug_assertions, feature = "debug_borrows"))] + created_at, + })), + }, + Err(_) => Err(BorrowError::AlreadyBorrowedMut(AlreadyBorrowedMutError { + #[cfg(any(debug_assertions, feature = "debug_borrows"))] + borrowed_mut_at: self.0.borrowed_mut_at.get().unwrap(), + })), + } + } + + #[track_caller] + fn try_borrow_mut( + &self, + #[cfg(any(debug_assertions, feature = "debug_borrows"))] + created_at: &'static std::panic::Location<'static>, + ) -> Result, BorrowMutError> { + #[cfg(any(debug_assertions, feature = "debug_borrows"))] + { + self.0 + .borrowed_mut_at + .set(Some(std::panic::Location::caller())); + } + match self.0.data.try_borrow_mut() { + Ok(borrow_mut) => { + match RefMut::filter_map(borrow_mut, |any| any.as_mut()?.downcast_mut::()) { + Ok(reference) => Ok(GenerationalRefMut { + inner: reference, + #[cfg(any(debug_assertions, feature = "debug_borrows"))] + borrow: GenerationalRefMutBorrowInfo { + borrowed_from: self.0, + }, + }), + Err(_) => Err(BorrowMutError::Dropped(ValueDroppedError { + #[cfg(any(debug_assertions, feature = "debug_borrows"))] + created_at, + })), + } + } + Err(_) => Err(BorrowMutError::AlreadyBorrowed(AlreadyBorrowedError { + #[cfg(any(debug_assertions, feature = "debug_borrows"))] + borrowed_at: self.0.borrowed_at.borrow().clone(), + })), + } + } +} + +#[derive(Debug, Clone)] +/// An error that can occur when trying to borrow a value. +pub enum BorrowError { + /// The value was dropped. + Dropped(ValueDroppedError), + /// The value was already borrowed mutably. + AlreadyBorrowedMut(AlreadyBorrowedMutError), +} + +impl Display for BorrowError { + fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { + match self { + BorrowError::Dropped(error) => Display::fmt(error, f), + BorrowError::AlreadyBorrowedMut(error) => Display::fmt(error, f), + } + } +} + +impl Error for BorrowError {} + +#[derive(Debug, Clone)] +/// An error that can occur when trying to borrow a value mutably. +pub enum BorrowMutError { + /// The value was dropped. + Dropped(ValueDroppedError), + /// The value was already borrowed. + AlreadyBorrowed(AlreadyBorrowedError), + /// The value was already borrowed mutably. + AlreadyBorrowedMut(AlreadyBorrowedMutError), +} + +impl Display for BorrowMutError { + fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { + match self { + BorrowMutError::Dropped(error) => Display::fmt(error, f), + BorrowMutError::AlreadyBorrowedMut(error) => Display::fmt(error, f), + BorrowMutError::AlreadyBorrowed(error) => Display::fmt(error, f), + } + } +} + +impl Error for BorrowMutError {} + +/// An error that can occur when trying to use a value that has been dropped. +#[derive(Debug, Copy, Clone)] +pub struct ValueDroppedError { + #[cfg(any(debug_assertions, feature = "debug_borrows"))] + created_at: &'static std::panic::Location<'static>, +} + +impl Display for ValueDroppedError { + fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { + f.write_str("Failed to borrow because the value was dropped.")?; + #[cfg(any(debug_assertions, feature = "debug_borrows"))] + f.write_fmt(format_args!("created_at: {}", self.created_at))?; + Ok(()) + } +} + +impl std::error::Error for ValueDroppedError {} + +/// An error that can occur when trying to borrow a value that has already been borrowed mutably. +#[derive(Debug, Copy, Clone)] +pub struct AlreadyBorrowedMutError { + #[cfg(any(debug_assertions, feature = "debug_borrows"))] + borrowed_mut_at: &'static std::panic::Location<'static>, +} + +impl Display for AlreadyBorrowedMutError { + fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { + f.write_str("Failed to borrow because the value was already borrowed mutably.")?; + #[cfg(any(debug_assertions, feature = "debug_borrows"))] + f.write_fmt(format_args!("borrowed_mut_at: {}", self.borrowed_mut_at))?; + Ok(()) + } +} + +impl std::error::Error for AlreadyBorrowedMutError {} + +/// An error that can occur when trying to borrow a value mutably that has already been borrowed immutably. +#[derive(Debug, Clone)] +pub struct AlreadyBorrowedError { + #[cfg(any(debug_assertions, feature = "debug_borrows"))] + borrowed_at: Vec<&'static std::panic::Location<'static>>, +} + +impl Display for AlreadyBorrowedError { + fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { + f.write_str("Failed to borrow mutably because the value was already borrowed immutably.")?; + #[cfg(any(debug_assertions, feature = "debug_borrows"))] + f.write_str("borrowed_at:")?; + #[cfg(any(debug_assertions, feature = "debug_borrows"))] + for location in self.borrowed_at.iter() { + f.write_fmt(format_args!("\t{}", location))?; + } + Ok(()) + } +} + +impl std::error::Error for AlreadyBorrowedError {} + +/// A reference to a value in a generational box. +pub struct GenerationalRef<'a, T: 'static> { + inner: Ref<'a, T>, + #[cfg(any(debug_assertions, feature = "debug_borrows"))] + borrow: GenerationalRefBorrowInfo, +} + +impl<'a, T: 'static> GenerationalRef<'a, T> { + /// Map one ref type to another. + pub fn map(orig: GenerationalRef<'a, T>, f: F) -> GenerationalRef<'a, U> + where + F: FnOnce(&T) -> &U, + { + GenerationalRef { + inner: Ref::map(orig.inner, f), + #[cfg(any(debug_assertions, feature = "debug_borrows"))] + borrow: GenerationalRefBorrowInfo { + borrowed_at: orig.borrow.borrowed_at, + borrowed_from: orig.borrow.borrowed_from, + }, + } + } + + /// Filter one ref type to another. + pub fn filter_map(orig: GenerationalRef<'a, T>, f: F) -> Option> + where + F: FnOnce(&T) -> Option<&U>, + { + let Self { + inner, + #[cfg(any(debug_assertions, feature = "debug_borrows"))] + borrow, + } = orig; + Ref::filter_map(inner, f).ok().map(|inner| GenerationalRef { + inner, + #[cfg(any(debug_assertions, feature = "debug_borrows"))] + borrow: GenerationalRefBorrowInfo { + borrowed_at: borrow.borrowed_at, + borrowed_from: borrow.borrowed_from, + }, + }) + } +} + +impl<'a, T: 'static> Deref for GenerationalRef<'a, T> { + type Target = T; + + fn deref(&self) -> &Self::Target { + self.inner.deref() + } +} + +#[cfg(any(debug_assertions, feature = "debug_borrows"))] +struct GenerationalRefBorrowInfo { + borrowed_at: &'static std::panic::Location<'static>, + borrowed_from: &'static MemoryLocationInner, +} + +#[cfg(any(debug_assertions, feature = "debug_borrows"))] +impl Drop for GenerationalRefBorrowInfo { + fn drop(&mut self) { + self.borrowed_from + .borrowed_at + .borrow_mut() + .retain(|location| std::ptr::eq(*location, self.borrowed_at as *const _)); + } +} + +/// A mutable reference to a value in a generational box. +pub struct GenerationalRefMut<'a, T: 'static> { + inner: RefMut<'a, T>, + #[cfg(any(debug_assertions, feature = "debug_borrows"))] + borrow: GenerationalRefMutBorrowInfo, +} + +impl<'a, T: 'static> GenerationalRefMut<'a, T> { + /// Map one ref type to another. + pub fn map(orig: GenerationalRefMut<'a, T>, f: F) -> GenerationalRefMut<'a, U> + where + F: FnOnce(&mut T) -> &mut U, + { + GenerationalRefMut { + inner: RefMut::map(orig.inner, f), + #[cfg(any(debug_assertions, feature = "debug_borrows"))] + borrow: orig.borrow, + } + } + + /// Filter one ref type to another. + pub fn filter_map( + orig: GenerationalRefMut<'a, T>, + f: F, + ) -> Option> + where + F: FnOnce(&mut T) -> Option<&mut U>, + { + let Self { + inner, + #[cfg(any(debug_assertions, feature = "debug_borrows"))] + borrow, + } = orig; + RefMut::filter_map(inner, f) + .ok() + .map(|inner| GenerationalRefMut { + inner, + #[cfg(any(debug_assertions, feature = "debug_borrows"))] + borrow, + }) + } +} + +impl<'a, T: 'static> Deref for GenerationalRefMut<'a, T> { + type Target = T; + + fn deref(&self) -> &Self::Target { + self.inner.deref() + } +} + +impl<'a, T: 'static> DerefMut for GenerationalRefMut<'a, T> { + fn deref_mut(&mut self) -> &mut Self::Target { + self.inner.deref_mut() + } +} + +#[cfg(any(debug_assertions, feature = "debug_borrows"))] +struct GenerationalRefMutBorrowInfo { + borrowed_from: &'static MemoryLocationInner, +} + +#[cfg(any(debug_assertions, feature = "debug_borrows"))] +impl Drop for GenerationalRefMutBorrowInfo { + fn drop(&mut self) { + self.borrowed_from.borrowed_mut_at.take(); + } } /// Handles recycling generational boxes that have been dropped. Your application should have one store or one store per thread. @@ -305,12 +640,16 @@ impl Store { if let Some(location) = self.recycled.borrow_mut().pop() { location } else { - let data: &'static RefCell<_> = self.bump.alloc(RefCell::new(None)); - MemoryLocation { - data, + let data: &'static MemoryLocationInner = self.bump.alloc(MemoryLocationInner { + data: RefCell::new(None), #[cfg(any(debug_assertions, feature = "check_generation"))] - generation: self.bump.alloc(Cell::new(0)), - } + generation: Cell::new(0), + #[cfg(any(debug_assertions, feature = "debug_borrows"))] + borrowed_at: Default::default(), + #[cfg(any(debug_assertions, feature = "debug_borrows"))] + borrowed_mut_at: Default::default(), + }); + MemoryLocation(data) } } @@ -331,9 +670,31 @@ pub struct Owner { impl Owner { /// Insert a value into the store. The value will be dropped when the owner is dropped. + #[track_caller] pub fn insert(&self, value: T) -> GenerationalBox { let mut location = self.store.claim(); - let key = location.replace(value); + let key = location.replace_with_caller( + value, + #[cfg(any(debug_assertions, feature = "debug_borrows"))] + std::panic::Location::caller(), + ); + self.owned.borrow_mut().push(location); + key + } + + /// Insert a value into the store with a specific location blamed for creating the value. The value will be dropped when the owner is dropped. + pub fn insert_with_caller( + &self, + value: T, + #[cfg(any(debug_assertions, feature = "debug_borrows"))] + caller: &'static std::panic::Location<'static>, + ) -> GenerationalBox { + let mut location = self.store.claim(); + let key = location.replace_with_caller( + value, + #[cfg(any(debug_assertions, feature = "debug_borrows"))] + caller, + ); self.owned.borrow_mut().push(location); key } @@ -344,7 +705,9 @@ impl Owner { GenerationalBox { raw: location, #[cfg(any(debug_assertions, feature = "check_generation"))] - generation: location.generation.get(), + generation: location.0.generation.get(), + #[cfg(any(debug_assertions, feature = "check_generation"))] + created_at: std::panic::Location::caller(), _marker: PhantomData, } } diff --git a/packages/signals/src/effect.rs b/packages/signals/src/effect.rs index 0685938a0..0110ce4d1 100644 --- a/packages/signals/src/effect.rs +++ b/packages/signals/src/effect.rs @@ -83,7 +83,7 @@ impl Effect { /// Run the effect callback immediately. Returns `true` if the effect was run. Returns `false` is the effect is dead. pub fn try_run(&self) { - if let Some(mut callback) = self.callback.try_write() { + if let Ok(mut callback) = self.callback.try_write() { { get_effect_stack().effects.borrow_mut().push(*self); } diff --git a/packages/signals/src/impls.rs b/packages/signals/src/impls.rs index 6427c2e2b..8029ac312 100644 --- a/packages/signals/src/impls.rs +++ b/packages/signals/src/impls.rs @@ -1,7 +1,7 @@ use crate::rt::CopyValue; use crate::signal::{ReadOnlySignal, Signal, Write}; - -use std::cell::{Ref, RefMut}; +use generational_box::GenerationalRef; +use generational_box::GenerationalRefMut; use std::{ fmt::{Debug, Display}, @@ -38,8 +38,8 @@ macro_rules! read_impls { impl $ty> { /// Read a value from the inner vector. - pub fn get(&self, index: usize) -> Option> { - Ref::filter_map(self.read(), |v| v.get(index)).ok() + pub fn get(&self, index: usize) -> Option> { + GenerationalRef::filter_map(self.read(), |v| v.get(index)) } } @@ -52,9 +52,9 @@ macro_rules! read_impls { self.with(|v| v.clone()).unwrap() } - /// Attemps to read the inner value of the Option. - pub fn as_ref(&self) -> Option> { - Ref::filter_map(self.read(), |v| v.as_ref()).ok() + /// Attempts to read the inner value of the Option. + pub fn as_ref(&self) -> Option> { + GenerationalRef::filter_map(self.read(), |v| v.as_ref()) } } }; @@ -182,19 +182,22 @@ macro_rules! write_impls { } /// Gets the value out of the Option, or inserts the given value if the Option is empty. - pub fn get_or_insert(&self, default: T) -> Ref<'_, T> { + pub fn get_or_insert(&self, default: T) -> GenerationalRef<'_, T> { self.get_or_insert_with(|| default) } /// Gets the value out of the Option, or inserts the value returned by the given function if the Option is empty. - pub fn get_or_insert_with(&self, default: impl FnOnce() -> T) -> Ref<'_, T> { + pub fn get_or_insert_with( + &self, + default: impl FnOnce() -> T, + ) -> GenerationalRef<'_, T> { let borrow = self.read(); if borrow.is_none() { drop(borrow); self.with_mut(|v| *v = Some(default())); - Ref::map(self.read(), |v| v.as_ref().unwrap()) + GenerationalRef::map(self.read(), |v| v.as_ref().unwrap()) } else { - Ref::map(borrow, |v| v.as_ref().unwrap()) + GenerationalRef::map(borrow, |v| v.as_ref().unwrap()) } } } @@ -238,15 +241,15 @@ impl IntoIterator for CopyValue> { impl CopyValue> { /// Write to an element in the inner vector. - pub fn get_mut(&self, index: usize) -> Option> { - RefMut::filter_map(self.write(), |v| v.get_mut(index)).ok() + pub fn get_mut(&self, index: usize) -> Option> { + GenerationalRefMut::filter_map(self.write(), |v| v.get_mut(index)) } } impl CopyValue> { /// Deref the inner value mutably. - pub fn as_mut(&self) -> Option> { - RefMut::filter_map(self.write(), |v| v.as_mut()).ok() + pub fn as_mut(&self) -> Option> { + GenerationalRefMut::filter_map(self.write(), |v| v.as_mut()) } } diff --git a/packages/signals/src/rt.rs b/packages/signals/src/rt.rs index 7322d43b4..acf598217 100644 --- a/packages/signals/src/rt.rs +++ b/packages/signals/src/rt.rs @@ -1,14 +1,15 @@ -use std::cell::{Ref, RefMut}; - +use std::panic::Location; use std::rc::Rc; use dioxus_core::prelude::{ - consume_context, consume_context_from_scope, current_scope_id, provide_context, + consume_context, consume_context_from_scope, current_scope_id, has_context, provide_context, provide_context_to_scope, provide_root_context, }; use dioxus_core::ScopeId; -use generational_box::{GenerationalBox, Owner, Store}; +use generational_box::{ + BorrowError, BorrowMutError, GenerationalBox, GenerationalRef, GenerationalRefMut, Owner, Store, +}; fn current_store() -> Store { match consume_context() { @@ -21,7 +22,7 @@ fn current_store() -> Store { } fn current_owner() -> Rc { - match consume_context() { + match has_context() { Some(rt) => rt, None => { let owner = Rc::new(current_store().owner()); @@ -74,6 +75,7 @@ impl CopyValue { /// Create a new CopyValue. The value will be stored in the current component. /// /// Once the component this value is created in is dropped, the value will be dropped. + #[track_caller] pub fn new(value: T) -> Self { let owner = current_owner(); @@ -83,6 +85,15 @@ impl CopyValue { } } + pub(crate) fn new_with_caller(value: T, caller: &'static Location<'static>) -> Self { + let owner = current_owner(); + + Self { + value: owner.insert_with_caller(value, caller), + origin_scope: current_scope_id().expect("in a virtual dom"), + } + } + /// Create a new CopyValue. The value will be stored in the given scope. When the specified scope is dropped, the value will be dropped. pub fn new_in_scope(value: T, scope: ScopeId) -> Self { let owner = owner_in_scope(scope); @@ -108,22 +119,26 @@ impl CopyValue { } /// Try to read the value. If the value has been dropped, this will return None. - pub fn try_read(&self) -> Option> { + #[track_caller] + pub fn try_read(&self) -> Result, BorrowError> { self.value.try_read() } /// Read the value. If the value has been dropped, this will panic. - pub fn read(&self) -> Ref<'_, T> { + #[track_caller] + pub fn read(&self) -> GenerationalRef<'_, T> { self.value.read() } /// Try to write the value. If the value has been dropped, this will return None. - pub fn try_write(&self) -> Option> { + #[track_caller] + pub fn try_write(&self) -> Result, BorrowMutError> { self.value.try_write() } /// Write the value. If the value has been dropped, this will panic. - pub fn write(&self) -> RefMut<'_, T> { + #[track_caller] + pub fn write(&self) -> GenerationalRefMut<'_, T> { self.value.write() } diff --git a/packages/signals/src/signal.rs b/packages/signals/src/signal.rs index a5599a1ce..1656f559e 100644 --- a/packages/signals/src/signal.rs +++ b/packages/signals/src/signal.rs @@ -1,6 +1,7 @@ use std::{ - cell::{Ref, RefCell, RefMut}, + cell::RefCell, ops::{Deref, DerefMut}, + panic::Location, rc::Rc, sync::Arc, }; @@ -9,6 +10,7 @@ use dioxus_core::{ prelude::{current_scope_id, has_context, provide_context, schedule_update_any}, ScopeId, ScopeState, }; +use generational_box::{GenerationalRef, GenerationalRefMut}; use crate::{CopyValue, Effect}; @@ -43,8 +45,18 @@ use crate::{CopyValue, Effect}; /// } /// } /// ``` +#[track_caller] pub fn use_signal(cx: &ScopeState, f: impl FnOnce() -> T) -> Signal { - *cx.use_hook(|| Signal::new(f())) + #[cfg(debug_assertions)] + let caller = Location::caller(); + + *cx.use_hook(|| { + Signal::new_with_caller( + f(), + #[cfg(debug_assertions)] + caller, + ) + }) } #[derive(Clone)] @@ -134,6 +146,7 @@ impl<'de, T: serde::Deserialize<'de> + 'static> serde::Deserialize<'de> for Sign impl Signal { /// Creates a new Signal. Signals are a Copy state management solution with automatic dependency tracking. + #[track_caller] pub fn new(value: T) -> Self { Self { inner: CopyValue::new(SignalData { @@ -145,6 +158,25 @@ impl Signal { } } + /// Creates a new Signal. Signals are a Copy state management solution with automatic dependency tracking. + fn new_with_caller( + value: T, + #[cfg(debug_assertions)] caller: &'static Location<'static>, + ) -> Self { + Self { + inner: CopyValue::new_with_caller( + SignalData { + subscribers: Default::default(), + effect_subscribers: Default::default(), + update_any: schedule_update_any().expect("in a virtual dom"), + value, + }, + #[cfg(debug_assertions)] + caller, + ), + } + } + /// Get the scope the signal was created in. pub fn origin_scope(&self) -> ScopeId { self.inner.origin_scope() @@ -152,7 +184,8 @@ impl Signal { /// Get the current value of the signal. This will subscribe the current scope to the signal. /// If the signal has been dropped, this will panic. - pub fn read(&self) -> Ref { + #[track_caller] + pub fn read(&self) -> GenerationalRef { let inner = self.inner.read(); if let Some(effect) = Effect::current() { let mut effect_subscribers = inner.effect_subscribers.borrow_mut(); @@ -176,14 +209,15 @@ impl Signal { } } } - Ref::map(inner, |v| &v.value) + GenerationalRef::map(inner, |v| &v.value) } /// Get a mutable reference to the signal's value. /// If the signal has been dropped, this will panic. + #[track_caller] pub fn write(&self) -> Write<'_, T> { let inner = self.inner.write(); - let borrow = RefMut::map(inner, |v| &mut v.value); + let borrow = GenerationalRefMut::map(inner, |v| &mut v.value); Write { write: borrow, signal: SignalSubscriberDrop { signal: *self }, @@ -219,12 +253,14 @@ impl Signal { } /// Set the value of the signal. This will trigger an update on all subscribers. + #[track_caller] pub fn set(&self, value: T) { *self.write() = value; } /// Run a closure with a reference to the signal's value. /// If the signal has been dropped, this will panic. + #[track_caller] pub fn with(&self, f: impl FnOnce(&T) -> O) -> O { let write = self.read(); f(&*write) @@ -232,6 +268,7 @@ impl Signal { /// Run a closure with a mutable reference to the signal's value. /// If the signal has been dropped, this will panic. + #[track_caller] pub fn with_mut(&self, f: impl FnOnce(&mut T) -> O) -> O { let mut write = self.write(); f(&mut *write) @@ -241,6 +278,7 @@ impl Signal { impl Signal { /// Get the current value of the signal. This will subscribe the current scope to the signal. /// If the signal has been dropped, this will panic. + #[track_caller] pub fn value(&self) -> T { self.read().clone() } @@ -264,7 +302,7 @@ impl Drop for SignalSubscriberDrop { /// A mutable reference to a signal's value. pub struct Write<'a, T: 'static, I: 'static = T> { - write: RefMut<'a, T>, + write: GenerationalRefMut<'a, T>, signal: SignalSubscriberDrop, } @@ -273,7 +311,7 @@ impl<'a, T: 'static, I: 'static> Write<'a, T, I> { pub fn map(myself: Self, f: impl FnOnce(&mut T) -> &mut O) -> Write<'a, O, I> { let Self { write, signal } = myself; Write { - write: RefMut::map(write, f), + write: GenerationalRefMut::map(write, f), signal, } } @@ -284,7 +322,7 @@ impl<'a, T: 'static, I: 'static> Write<'a, T, I> { f: impl FnOnce(&mut T) -> Option<&mut O>, ) -> Option> { let Self { write, signal } = myself; - let write = RefMut::filter_map(write, f).ok(); + let write = GenerationalRefMut::filter_map(write, f); write.map(|write| Write { write, signal }) } } @@ -320,11 +358,13 @@ impl ReadOnlySignal { } /// Get the current value of the signal. This will subscribe the current scope to the signal. - pub fn read(&self) -> Ref { + #[track_caller] + pub fn read(&self) -> GenerationalRef { self.inner.read() } /// Run a closure with a reference to the signal's value. + #[track_caller] pub fn with(&self, f: impl FnOnce(&T) -> O) -> O { self.inner.with(f) } From f09a2e2280f74a9ac4e50d298e6f665bad1f8ea2 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Mon, 21 Aug 2023 14:28:45 -0500 Subject: [PATCH 022/447] fix release builds --- packages/generational-box/Cargo.toml | 1 + packages/generational-box/src/lib.rs | 26 ++++++++++++-------------- packages/signals/src/rt.rs | 12 +++++++++--- packages/signals/src/signal.rs | 5 ++--- 4 files changed, 24 insertions(+), 20 deletions(-) diff --git a/packages/generational-box/Cargo.toml b/packages/generational-box/Cargo.toml index cc0db9cec..7151ec103 100644 --- a/packages/generational-box/Cargo.toml +++ b/packages/generational-box/Cargo.toml @@ -16,3 +16,4 @@ rand = "0.8.5" default = ["check_generation"] check_generation = [] debug_borrows = [] +debug_ownership = [] diff --git a/packages/generational-box/src/lib.rs b/packages/generational-box/src/lib.rs index 7d64a1ed3..1f8cbbe11 100644 --- a/packages/generational-box/src/lib.rs +++ b/packages/generational-box/src/lib.rs @@ -8,7 +8,6 @@ use std::{ fmt::{Debug, Display}, marker::PhantomData, ops::{Deref, DerefMut}, - panic::Location, rc::Rc, }; @@ -157,7 +156,7 @@ pub struct GenerationalBox { raw: MemoryLocation, #[cfg(any(debug_assertions, feature = "check_generation"))] generation: u32, - #[cfg(any(debug_assertions, feature = "check_generation"))] + #[cfg(any(debug_assertions, feature = "debug_ownership"))] created_at: &'static std::panic::Location<'static>, _marker: PhantomData, } @@ -288,9 +287,8 @@ impl MemoryLocation { fn replace_with_caller( &mut self, value: T, - #[cfg(any(debug_assertions, feature = "check_generation"))] caller: &'static Location< - 'static, - >, + #[cfg(any(debug_assertions, feature = "debug_ownership"))] + caller: &'static std::panic::Location<'static>, ) -> GenerationalBox { let mut inner_mut = self.0.data.borrow_mut(); @@ -301,7 +299,7 @@ impl MemoryLocation { raw: *self, #[cfg(any(debug_assertions, feature = "check_generation"))] generation: self.0.generation.get(), - #[cfg(any(debug_assertions, feature = "check_generation"))] + #[cfg(any(debug_assertions, feature = "debug_ownership"))] created_at: caller, _marker: PhantomData, } @@ -310,7 +308,7 @@ impl MemoryLocation { #[track_caller] fn try_borrow( &self, - #[cfg(any(debug_assertions, feature = "debug_borrows"))] + #[cfg(any(debug_assertions, feature = "debug_ownership"))] created_at: &'static std::panic::Location<'static>, ) -> Result, BorrowError> { #[cfg(any(debug_assertions, feature = "debug_borrows"))] @@ -329,7 +327,7 @@ impl MemoryLocation { }, }), Err(_) => Err(BorrowError::Dropped(ValueDroppedError { - #[cfg(any(debug_assertions, feature = "debug_borrows"))] + #[cfg(any(debug_assertions, feature = "debug_ownership"))] created_at, })), }, @@ -343,7 +341,7 @@ impl MemoryLocation { #[track_caller] fn try_borrow_mut( &self, - #[cfg(any(debug_assertions, feature = "debug_borrows"))] + #[cfg(any(debug_assertions, feature = "debug_ownership"))] created_at: &'static std::panic::Location<'static>, ) -> Result, BorrowMutError> { #[cfg(any(debug_assertions, feature = "debug_borrows"))] @@ -363,7 +361,7 @@ impl MemoryLocation { }, }), Err(_) => Err(BorrowMutError::Dropped(ValueDroppedError { - #[cfg(any(debug_assertions, feature = "debug_borrows"))] + #[cfg(any(debug_assertions, feature = "debug_ownership"))] created_at, })), } @@ -422,14 +420,14 @@ impl Error for BorrowMutError {} /// An error that can occur when trying to use a value that has been dropped. #[derive(Debug, Copy, Clone)] pub struct ValueDroppedError { - #[cfg(any(debug_assertions, feature = "debug_borrows"))] + #[cfg(any(debug_assertions, feature = "debug_ownership"))] created_at: &'static std::panic::Location<'static>, } impl Display for ValueDroppedError { fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { f.write_str("Failed to borrow because the value was dropped.")?; - #[cfg(any(debug_assertions, feature = "debug_borrows"))] + #[cfg(any(debug_assertions, feature = "debug_ownership"))] f.write_fmt(format_args!("created_at: {}", self.created_at))?; Ok(()) } @@ -686,7 +684,7 @@ impl Owner { pub fn insert_with_caller( &self, value: T, - #[cfg(any(debug_assertions, feature = "debug_borrows"))] + #[cfg(any(debug_assertions, feature = "debug_ownership"))] caller: &'static std::panic::Location<'static>, ) -> GenerationalBox { let mut location = self.store.claim(); @@ -706,7 +704,7 @@ impl Owner { raw: location, #[cfg(any(debug_assertions, feature = "check_generation"))] generation: location.0.generation.get(), - #[cfg(any(debug_assertions, feature = "check_generation"))] + #[cfg(any(debug_assertions, feature = "debug_ownership"))] created_at: std::panic::Location::caller(), _marker: PhantomData, } diff --git a/packages/signals/src/rt.rs b/packages/signals/src/rt.rs index acf598217..aee3b0858 100644 --- a/packages/signals/src/rt.rs +++ b/packages/signals/src/rt.rs @@ -1,4 +1,3 @@ -use std::panic::Location; use std::rc::Rc; use dioxus_core::prelude::{ @@ -85,11 +84,18 @@ impl CopyValue { } } - pub(crate) fn new_with_caller(value: T, caller: &'static Location<'static>) -> Self { + pub(crate) fn new_with_caller( + value: T, + #[cfg(debug_assertions)] caller: &'static std::panic::Location<'static>, + ) -> Self { let owner = current_owner(); Self { - value: owner.insert_with_caller(value, caller), + value: owner.insert_with_caller( + value, + #[cfg(debug_assertions)] + caller, + ), origin_scope: current_scope_id().expect("in a virtual dom"), } } diff --git a/packages/signals/src/signal.rs b/packages/signals/src/signal.rs index 1656f559e..70a809e85 100644 --- a/packages/signals/src/signal.rs +++ b/packages/signals/src/signal.rs @@ -1,7 +1,6 @@ use std::{ cell::RefCell, ops::{Deref, DerefMut}, - panic::Location, rc::Rc, sync::Arc, }; @@ -48,7 +47,7 @@ use crate::{CopyValue, Effect}; #[track_caller] pub fn use_signal(cx: &ScopeState, f: impl FnOnce() -> T) -> Signal { #[cfg(debug_assertions)] - let caller = Location::caller(); + let caller = std::panic::Location::caller(); *cx.use_hook(|| { Signal::new_with_caller( @@ -161,7 +160,7 @@ impl Signal { /// Creates a new Signal. Signals are a Copy state management solution with automatic dependency tracking. fn new_with_caller( value: T, - #[cfg(debug_assertions)] caller: &'static Location<'static>, + #[cfg(debug_assertions)] caller: &'static std::panic::Location<'static>, ) -> Self { Self { inner: CopyValue::new_with_caller( From 18f8daf0bdc30a6eb71ab7e91863442a13d47ca6 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Mon, 21 Aug 2023 15:00:31 -0500 Subject: [PATCH 023/447] fix generational box tests --- packages/generational-box/README.md | 2 ++ packages/generational-box/src/lib.rs | 13 ++++++++----- 2 files changed, 10 insertions(+), 5 deletions(-) diff --git a/packages/generational-box/README.md b/packages/generational-box/README.md index 5ab7926ba..f8d4885b8 100644 --- a/packages/generational-box/README.md +++ b/packages/generational-box/README.md @@ -11,6 +11,8 @@ Three main types manage state in Generational Box: Example: ```rust +use generational_box::Store; + // Create a store for this thread let store = Store::default(); diff --git a/packages/generational-box/src/lib.rs b/packages/generational-box/src/lib.rs index 1f8cbbe11..84a81769d 100644 --- a/packages/generational-box/src/lib.rs +++ b/packages/generational-box/src/lib.rs @@ -32,12 +32,12 @@ fn reused() { let first_ptr; { let owner = store.owner(); - first_ptr = owner.insert(1).raw.data.as_ptr(); + first_ptr = owner.insert(1).raw.0.data.as_ptr(); drop(owner); } { let owner = store.owner(); - let second_ptr = owner.insert(1234).raw.data.as_ptr(); + let second_ptr = owner.insert(1234).raw.0.data.as_ptr(); assert_eq!(first_ptr, second_ptr); drop(owner); } @@ -56,7 +56,10 @@ fn leaking_is_ok() { // don't drop the owner std::mem::forget(owner); } - assert_eq!(key.try_read().as_deref(), Some(&"hello world".to_string())); + assert_eq!( + key.try_read().as_deref().unwrap(), + &"hello world".to_string() + ); } #[test] @@ -71,7 +74,7 @@ fn drops() { key = owner.insert(data); // drop the owner } - assert!(key.try_read().is_none()); + assert!(key.try_read().is_err()); } #[test] @@ -132,7 +135,7 @@ fn fuzz() { println!("{:?}", path); for key in valid_keys.iter() { let value = key.read(); - println!("{:?}", value); + println!("{:?}", &*value); assert!(value.starts_with("hello world")); } #[cfg(any(debug_assertions, feature = "check_generation"))] From 99268acc052a4a5fddf9e0c43cf30caf383ea855 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Mon, 21 Aug 2023 16:05:25 -0500 Subject: [PATCH 024/447] add an option to skip assets in the CLI --- packages/cli/src/builder.rs | 36 +++++++++++++++----------- packages/cli/src/cli/build.rs | 10 +++---- packages/cli/src/cli/bundle.rs | 2 +- packages/cli/src/cli/cfg.rs | 11 ++++++++ packages/cli/src/cli/serve.rs | 8 +++--- packages/cli/src/server/desktop/mod.rs | 12 +++++---- packages/cli/src/server/web/mod.rs | 22 +++++++++------- playwright-tests/playwright.config.js | 6 ++--- 8 files changed, 64 insertions(+), 43 deletions(-) diff --git a/packages/cli/src/builder.rs b/packages/cli/src/builder.rs index 371a1291f..c7acd9aaa 100644 --- a/packages/cli/src/builder.rs +++ b/packages/cli/src/builder.rs @@ -22,7 +22,7 @@ pub struct BuildResult { pub elapsed_time: u128, } -pub fn build(config: &CrateConfig, quiet: bool) -> Result { +pub fn build(config: &CrateConfig, quiet: bool, skip_assets: bool) -> Result { // [1] Build the project with cargo, generating a wasm32-unknown-unknown target (is there a more specific, better target to leverage?) // [2] Generate the appropriate build folders // [3] Wasm-bindgen the .wasm fiile, and move it into the {builddir}/modules/xxxx/xxxx_bg.wasm @@ -241,7 +241,9 @@ pub fn build(config: &CrateConfig, quiet: bool) -> Result { } } - process_assets(config)?; + if !skip_assets{ + process_assets(config)?; + } Ok(BuildResult { warnings: warning_messages, @@ -249,7 +251,7 @@ pub fn build(config: &CrateConfig, quiet: bool) -> Result { }) } -pub fn build_desktop(config: &CrateConfig, _is_serve: bool) -> Result { +pub fn build_desktop(config: &CrateConfig, _is_serve: bool, skip_assets: bool) -> Result { log::info!("πŸš… Running build [Desktop] command..."); let t_start = std::time::Instant::now(); @@ -351,10 +353,12 @@ pub fn build_desktop(config: &CrateConfig, _is_serve: bool) -> Result anyhow::Result> { Ok(warning_messages) } -pub fn gen_page(config: &CrateConfig, serve: bool) -> String { +pub fn gen_page(config: &CrateConfig, serve: bool, skip_assets: bool) -> String { let _gaurd = WebAssetConfigDropGuard::new(); let crate_root = crate::cargo::crate_root().unwrap(); @@ -461,14 +465,14 @@ pub fn gen_page(config: &CrateConfig, serve: bool) -> String { String::from(include_str!("./assets/index.html")) }; - let resouces = config.dioxus_config.web.resource.clone(); + let resources = config.dioxus_config.web.resource.clone(); - let mut style_list = resouces.style.unwrap_or_default(); - let mut script_list = resouces.script.unwrap_or_default(); + let mut style_list = resources.style.unwrap_or_default(); + let mut script_list = resources.script.unwrap_or_default(); if serve { - let mut dev_style = resouces.dev.style.clone().unwrap_or_default(); - let mut dev_script = resouces.dev.script.unwrap_or_default(); + let mut dev_style = resources.dev.style.clone().unwrap_or_default(); + let mut dev_script = resources.dev.script.unwrap_or_default(); style_list.append(&mut dev_style); script_list.append(&mut dev_script); } @@ -490,8 +494,10 @@ pub fn gen_page(config: &CrateConfig, serve: bool) -> String { { style_str.push_str("\n"); } - let manifest = config.asset_manifest(); - style_str.push_str(&manifest.head()); + if !skip_assets{ + let manifest = config.asset_manifest(); + style_str.push_str(&manifest.head()); + } replace_or_insert_before("{style_include}", &style_str, " { - crate::builder::build(&crate_config, false)?; + crate::builder::build(&crate_config, false, self.build.skip_assets)?; } Platform::Desktop => { - crate::builder::build_desktop(&crate_config, false)?; + crate::builder::build_desktop(&crate_config, false, self.build.skip_assets)?; } Platform::Fullstack => { // Fullstack mode must be built with web configs on the desktop (server) binary as well as the web binary @@ -60,7 +60,7 @@ impl Build { } None => web_config.features = Some(vec![web_feature]), }; - crate::builder::build(&crate_config, false)?; + crate::builder::build(&crate_config, false, self.build.skip_assets)?; } { let mut desktop_config = crate_config.clone(); @@ -72,12 +72,12 @@ impl Build { } None => desktop_config.features = Some(vec![desktop_feature]), }; - crate::builder::build_desktop(&desktop_config, false)?; + crate::builder::build_desktop(&desktop_config, false, self.build.skip_assets)?; } } } - let temp = gen_page(&crate_config, false); + let temp = gen_page(&crate_config, false, self.build.skip_assets); let mut file = std::fs::File::create( crate_config diff --git a/packages/cli/src/cli/bundle.rs b/packages/cli/src/cli/bundle.rs index 49979362c..9f82d8ba5 100644 --- a/packages/cli/src/cli/bundle.rs +++ b/packages/cli/src/cli/bundle.rs @@ -77,7 +77,7 @@ impl Bundle { } // build the desktop app - build_desktop(&crate_config, false)?; + build_desktop(&crate_config, false, false)?; // copy the binary to the out dir let package = crate_config.manifest.package.unwrap(); diff --git a/packages/cli/src/cli/cfg.rs b/packages/cli/src/cli/cfg.rs index bbe3119d3..3078e864f 100644 --- a/packages/cli/src/cli/cfg.rs +++ b/packages/cli/src/cli/cfg.rs @@ -32,6 +32,11 @@ pub struct ConfigOptsBuild { #[clap(long, value_enum)] pub platform: Option, + /// Skip collecting assets from dependencies [default: false] + #[clap(long)] + #[serde(default)] + pub skip_assets: bool, + /// Space separated list of features to activate #[clap(long)] pub features: Option>, @@ -57,6 +62,7 @@ impl From for ConfigOptsBuild { features: serve.features, client_feature: serve.client_feature, server_feature: serve.server_feature, + skip_assets: serve.skip_assets, } } } @@ -114,6 +120,11 @@ pub struct ConfigOptsServe { #[clap(long)] pub features: Option>, + /// Skip collecting assets from dependencies [default: false] + #[clap(long)] + #[serde(default)] + pub skip_assets: bool, + /// The feature to use for the client in a fullstack app [default: "web"] #[clap(long, default_value_t = { "web".to_string() })] pub client_feature: String, diff --git a/packages/cli/src/cli/serve.rs b/packages/cli/src/cli/serve.rs index 195b1ddf8..aa7380060 100644 --- a/packages/cli/src/cli/serve.rs +++ b/packages/cli/src/cli/serve.rs @@ -43,10 +43,10 @@ impl Serve { match platform { cfg::Platform::Web => { // generate dev-index page - Serve::regen_dev_page(&crate_config)?; + Serve::regen_dev_page(&crate_config, self.serve.skip_assets)?; // start the develop server - server::web::startup(self.serve.port, crate_config.clone(), self.serve.open) + server::web::startup(self.serve.port, crate_config.clone(), self.serve.open, self.serve.skip_assets) .await?; } cfg::Platform::Desktop => { @@ -59,8 +59,8 @@ impl Serve { Ok(()) } - pub fn regen_dev_page(crate_config: &CrateConfig) -> Result<()> { - let serve_html = gen_page(crate_config, true); + pub fn regen_dev_page(crate_config: &CrateConfig, skip_assets: bool) -> Result<()> { + let serve_html = gen_page(crate_config, true, skip_assets); let dist_path = crate_config.crate_dir.join( crate_config diff --git a/packages/cli/src/server/desktop/mod.rs b/packages/cli/src/server/desktop/mod.rs index 80df74fa4..94ae7c8c7 100644 --- a/packages/cli/src/server/desktop/mod.rs +++ b/packages/cli/src/server/desktop/mod.rs @@ -209,9 +209,9 @@ fn send_msg(msg: HotReloadMsg, channel: &mut impl std::io::Write) -> bool { } } -fn start_desktop(config: &CrateConfig) -> Result<(Child, BuildResult)> { +fn start_desktop(config: &CrateConfig, skip_assets: bool) -> Result<(Child, BuildResult)> { // Run the desktop application - let result = crate::builder::build_desktop(config, true)?; + let result = crate::builder::build_desktop(config, true, skip_assets)?; match &config.executable { crate::ExecutableType::Binary(name) @@ -233,11 +233,12 @@ fn start_desktop(config: &CrateConfig) -> Result<(Child, BuildResult)> { pub(crate) struct DesktopPlatform { currently_running_child: Child, + skip_assets: bool, } impl Platform for DesktopPlatform { - fn start(config: &CrateConfig, _serve: &ConfigOptsServe) -> Result { - let (child, first_build_result) = start_desktop(config)?; + fn start(config: &CrateConfig,serve: &ConfigOptsServe) -> Result { + let (child, first_build_result) = start_desktop(config, serve.skip_assets)?; log::info!("πŸš€ Starting development server..."); @@ -254,12 +255,13 @@ impl Platform for DesktopPlatform { Ok(Self { currently_running_child: child, + skip_assets: serve.skip_assets, }) } fn rebuild(&mut self, config: &CrateConfig) -> Result { self.currently_running_child.kill()?; - let (child, result) = start_desktop(config)?; + let (child, result) = start_desktop(config, self.skip_assets)?; self.currently_running_child = child; Ok(result) } diff --git a/packages/cli/src/server/web/mod.rs b/packages/cli/src/server/web/mod.rs index 7f09dca6c..16d57d6fd 100644 --- a/packages/cli/src/server/web/mod.rs +++ b/packages/cli/src/server/web/mod.rs @@ -47,7 +47,7 @@ struct WsReloadState { update: broadcast::Sender<()>, } -pub async fn startup(port: u16, config: CrateConfig, start_browser: bool) -> Result<()> { +pub async fn startup(port: u16, config: CrateConfig, start_browser: bool, skip_assets: bool) -> Result<()> { // ctrl-c shutdown checker let _crate_config = config.clone(); let _ = ctrlc::set_handler(move || { @@ -59,8 +59,8 @@ pub async fn startup(port: u16, config: CrateConfig, start_browser: bool) -> Res let ip = get_ip().unwrap_or(String::from("0.0.0.0")); match config.hot_reload { - true => serve_hot_reload(ip, port, config, start_browser).await?, - false => serve_default(ip, port, config, start_browser).await?, + true => serve_hot_reload(ip, port, config, start_browser, skip_assets).await?, + false => serve_default(ip, port, config, start_browser, skip_assets).await?, } Ok(()) @@ -72,8 +72,9 @@ async fn serve_default( port: u16, config: CrateConfig, start_browser: bool, + skip_assets: bool ) -> Result<()> { - let first_build_result = crate::builder::build(&config, false)?; + let first_build_result = crate::builder::build(&config, false, skip_assets)?; log::info!("πŸš€ Starting development server..."); @@ -86,7 +87,7 @@ async fn serve_default( { let config = config.clone(); let reload_tx = reload_tx.clone(); - move || build(&config, &reload_tx) + move || build(&config, &reload_tx, skip_assets) }, &config, Some(WebServerInfo { @@ -133,8 +134,9 @@ async fn serve_hot_reload( port: u16, config: CrateConfig, start_browser: bool, + skip_assets: bool ) -> Result<()> { - let first_build_result = crate::builder::build(&config, false)?; + let first_build_result = crate::builder::build(&config, false, skip_assets)?; log::info!("πŸš€ Starting development server..."); @@ -172,7 +174,7 @@ async fn serve_hot_reload( { let config = config.clone(); let reload_tx = reload_tx.clone(); - move || build(&config, &reload_tx) + move || build(&config, &reload_tx, skip_assets) }, Some(WebServerInfo { ip: ip.clone(), @@ -473,8 +475,8 @@ async fn ws_handler( }) } -fn build(config: &CrateConfig, reload_tx: &Sender<()>) -> Result { - let result = builder::build(config, true)?; +fn build(config: &CrateConfig, reload_tx: &Sender<()>, skip_assets: bool) -> Result { + let result = builder::build(config, true, skip_assets)?; // change the websocket reload state to true; // the page will auto-reload. if config @@ -484,7 +486,7 @@ fn build(config: &CrateConfig, reload_tx: &Sender<()>) -> Result { .reload_html .unwrap_or(false) { - let _ = Serve::regen_dev_page(config); + let _ = Serve::regen_dev_page(config, skip_assets); } let _ = reload_tx.send(()); Ok(result) diff --git a/playwright-tests/playwright.config.js b/playwright-tests/playwright.config.js index 54fe810a7..cd817d236 100644 --- a/playwright-tests/playwright.config.js +++ b/playwright-tests/playwright.config.js @@ -74,7 +74,7 @@ module.exports = defineConfig({ webServer: [ { command: - "cargo run --package dioxus-playwright-liveview-test --bin dioxus-playwright-liveview-test", + "cargo run --package dioxus-playwright-liveview-test --bin dioxus-playwright-liveview-test --skip-assets", port: 3030, timeout: 10 * 60 * 1000, reuseExistingServer: !process.env.CI, @@ -82,7 +82,7 @@ module.exports = defineConfig({ }, { cwd: path.join(process.cwd(), "web"), - command: "cargo run --package dioxus-cli -- serve", + command: "cargo run --package dioxus-cli --release -- serve --skip-assets", port: 8080, timeout: 10 * 60 * 1000, reuseExistingServer: !process.env.CI, @@ -90,7 +90,7 @@ module.exports = defineConfig({ }, { cwd: path.join(process.cwd(), 'fullstack'), - command: 'cargo run --package dioxus-cli -- build --features web --release\ncargo run --release --features ssr', + command: 'cargo run --package dioxus-cli --release -- build --features web --release --skip-assets\ncargo run --release --features ssr', port: 3333, timeout: 10 * 60 * 1000, reuseExistingServer: !process.env.CI, From e162e3e4cf0ef723d39f49f090ac8932d003eed5 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Mon, 21 Aug 2023 16:07:49 -0500 Subject: [PATCH 025/447] fix formatting --- packages/cli/src/builder.rs | 12 ++++++++---- packages/cli/src/cli/serve.rs | 9 +++++++-- packages/cli/src/server/desktop/mod.rs | 2 +- packages/cli/src/server/web/mod.rs | 11 ++++++++--- 4 files changed, 24 insertions(+), 10 deletions(-) diff --git a/packages/cli/src/builder.rs b/packages/cli/src/builder.rs index c7acd9aaa..1a537c049 100644 --- a/packages/cli/src/builder.rs +++ b/packages/cli/src/builder.rs @@ -241,7 +241,7 @@ pub fn build(config: &CrateConfig, quiet: bool, skip_assets: bool) -> Result Result Result { +pub fn build_desktop( + config: &CrateConfig, + _is_serve: bool, + skip_assets: bool, +) -> Result { log::info!("πŸš… Running build [Desktop] command..."); let t_start = std::time::Instant::now(); @@ -353,7 +357,7 @@ pub fn build_desktop(config: &CrateConfig, _is_serve: bool, skip_assets: bool) - } } - if !skip_assets{ + if !skip_assets { // Collect assets process_assets(config)?; // Create the __assets_head.html file for bundling @@ -494,7 +498,7 @@ pub fn gen_page(config: &CrateConfig, serve: bool, skip_assets: bool) -> String { style_str.push_str("\n"); } - if !skip_assets{ + if !skip_assets { let manifest = config.asset_manifest(); style_str.push_str(&manifest.head()); } diff --git a/packages/cli/src/cli/serve.rs b/packages/cli/src/cli/serve.rs index aa7380060..62ff8a955 100644 --- a/packages/cli/src/cli/serve.rs +++ b/packages/cli/src/cli/serve.rs @@ -46,8 +46,13 @@ impl Serve { Serve::regen_dev_page(&crate_config, self.serve.skip_assets)?; // start the develop server - server::web::startup(self.serve.port, crate_config.clone(), self.serve.open, self.serve.skip_assets) - .await?; + server::web::startup( + self.serve.port, + crate_config.clone(), + self.serve.open, + self.serve.skip_assets, + ) + .await?; } cfg::Platform::Desktop => { server::desktop::startup(crate_config.clone(), &serve_cfg).await?; diff --git a/packages/cli/src/server/desktop/mod.rs b/packages/cli/src/server/desktop/mod.rs index 94ae7c8c7..7c38fd674 100644 --- a/packages/cli/src/server/desktop/mod.rs +++ b/packages/cli/src/server/desktop/mod.rs @@ -237,7 +237,7 @@ pub(crate) struct DesktopPlatform { } impl Platform for DesktopPlatform { - fn start(config: &CrateConfig,serve: &ConfigOptsServe) -> Result { + fn start(config: &CrateConfig, serve: &ConfigOptsServe) -> Result { let (child, first_build_result) = start_desktop(config, serve.skip_assets)?; log::info!("πŸš€ Starting development server..."); diff --git a/packages/cli/src/server/web/mod.rs b/packages/cli/src/server/web/mod.rs index 16d57d6fd..297e252fa 100644 --- a/packages/cli/src/server/web/mod.rs +++ b/packages/cli/src/server/web/mod.rs @@ -47,7 +47,12 @@ struct WsReloadState { update: broadcast::Sender<()>, } -pub async fn startup(port: u16, config: CrateConfig, start_browser: bool, skip_assets: bool) -> Result<()> { +pub async fn startup( + port: u16, + config: CrateConfig, + start_browser: bool, + skip_assets: bool, +) -> Result<()> { // ctrl-c shutdown checker let _crate_config = config.clone(); let _ = ctrlc::set_handler(move || { @@ -72,7 +77,7 @@ async fn serve_default( port: u16, config: CrateConfig, start_browser: bool, - skip_assets: bool + skip_assets: bool, ) -> Result<()> { let first_build_result = crate::builder::build(&config, false, skip_assets)?; @@ -134,7 +139,7 @@ async fn serve_hot_reload( port: u16, config: CrateConfig, start_browser: bool, - skip_assets: bool + skip_assets: bool, ) -> Result<()> { let first_build_result = crate::builder::build(&config, false, skip_assets)?; From af555fcd1da324f9f7f00cc09f76cb12876f07d6 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Tue, 22 Aug 2023 12:51:49 -0500 Subject: [PATCH 026/447] don't use skip assets on cargo run --- playwright-tests/playwright.config.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/playwright-tests/playwright.config.js b/playwright-tests/playwright.config.js index cd817d236..7ad95175e 100644 --- a/playwright-tests/playwright.config.js +++ b/playwright-tests/playwright.config.js @@ -74,7 +74,7 @@ module.exports = defineConfig({ webServer: [ { command: - "cargo run --package dioxus-playwright-liveview-test --bin dioxus-playwright-liveview-test --skip-assets", + "cargo run --package dioxus-playwright-liveview-test --bin dioxus-playwright-liveview-test", port: 3030, timeout: 10 * 60 * 1000, reuseExistingServer: !process.env.CI, From cc3f60dd2ffb472e877bc4345c8b27c4ac32ccdd Mon Sep 17 00:00:00 2001 From: Evan Simkowitz Date: Tue, 22 Aug 2023 23:29:24 -0400 Subject: [PATCH 027/447] Adding PointInteraction trait, etc. --- packages/html/Cargo.toml | 2 +- packages/html/src/events/mouse.rs | 196 +---------------------- packages/html/src/input_data.rs | 3 +- packages/html/src/lib.rs | 1 + packages/html/src/point_interaction.rs | 95 +++++++++++ packages/html/src/web_sys_bind/events.rs | 24 +-- 6 files changed, 120 insertions(+), 201 deletions(-) create mode 100644 packages/html/src/point_interaction.rs diff --git a/packages/html/Cargo.toml b/packages/html/Cargo.toml index 5644b440c..83706d3bc 100644 --- a/packages/html/Cargo.toml +++ b/packages/html/Cargo.toml @@ -16,7 +16,7 @@ serde = { version = "1", features = ["derive"], optional = true } serde_repr = { version = "0.1", optional = true } wasm-bindgen = { workspace = true, optional = true } euclid = "0.22.7" -enumset = "1.0.11" +enumset = { version = "1.0.11", features = ["serde"] } keyboard-types = "0.7" async-trait = "0.1.58" serde-value = "0.7.0" diff --git a/packages/html/src/events/mouse.rs b/packages/html/src/events/mouse.rs index 7899393ff..51bca7d48 100644 --- a/packages/html/src/events/mouse.rs +++ b/packages/html/src/events/mouse.rs @@ -1,9 +1,5 @@ -use crate::geometry::{ClientPoint, Coordinates, ElementPoint, PagePoint, ScreenPoint}; -use crate::input_data::{ - decode_mouse_button_set, encode_mouse_button_set, MouseButton, MouseButtonSet, -}; +use crate::point_interaction::{PointData, PointInteraction}; use dioxus_core::Event; -use keyboard_types::Modifiers; use std::fmt::{Debug, Formatter}; pub type MouseEvent = Event; @@ -12,80 +8,8 @@ pub type MouseEvent = Event; #[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] #[derive(Clone, Default, PartialEq, Eq)] /// Data associated with a mouse event -/// -/// Do not use the deprecated fields; they may change or become private in the future. pub struct MouseData { - /// True if the alt key was down when the mouse event was fired. - #[deprecated(since = "0.3.0", note = "use modifiers() instead")] - pub alt_key: bool, - - /// The button number that was pressed (if applicable) when the mouse event was fired. - #[deprecated(since = "0.3.0", note = "use trigger_button() instead")] - pub button: i16, - - /// Indicates which buttons are pressed on the mouse (or other input device) when a mouse event is triggered. - /// - /// Each button that can be pressed is represented by a given number (see below). If more than one button is pressed, the button values are added together to produce a new number. For example, if the secondary (2) and auxiliary (4) buttons are pressed simultaneously, the value is 6 (i.e., 2 + 4). - /// - /// - 1: Primary button (usually the left button) - /// - 2: Secondary button (usually the right button) - /// - 4: Auxiliary button (usually the mouse wheel button or middle button) - /// - 8: 4th button (typically the "Browser Back" button) - /// - 16 : 5th button (typically the "Browser Forward" button) - #[deprecated(since = "0.3.0", note = "use held_buttons() instead")] - pub buttons: u16, - - /// The horizontal coordinate within the application's viewport at which the event occurred (as opposed to the coordinate within the page). - /// - /// For example, clicking on the left edge of the viewport will always result in a mouse event with a clientX value of 0, regardless of whether the page is scrolled horizontally. - #[deprecated(since = "0.3.0", note = "use client_coordinates() instead")] - pub client_x: i32, - - /// The vertical coordinate within the application's viewport at which the event occurred (as opposed to the coordinate within the page). - /// - /// For example, clicking on the top edge of the viewport will always result in a mouse event with a clientY value of 0, regardless of whether the page is scrolled vertically. - #[deprecated(since = "0.3.0", note = "use client_coordinates() instead")] - pub client_y: i32, - - /// True if the control key was down when the mouse event was fired. - #[deprecated(since = "0.3.0", note = "use modifiers() instead")] - pub ctrl_key: bool, - - /// True if the meta key was down when the mouse event was fired. - #[deprecated(since = "0.3.0", note = "use modifiers() instead")] - pub meta_key: bool, - - /// The offset in the X coordinate of the mouse pointer between that event and the padding edge of the target node. - #[deprecated(since = "0.3.0", note = "use element_coordinates() instead")] - pub offset_x: i32, - - /// The offset in the Y coordinate of the mouse pointer between that event and the padding edge of the target node. - #[deprecated(since = "0.3.0", note = "use element_coordinates() instead")] - pub offset_y: i32, - - /// The X (horizontal) coordinate (in pixels) of the mouse, relative to the left edge of the entire document. This includes any portion of the document not currently visible. - /// - /// Being based on the edge of the document as it is, this property takes into account any horizontal scrolling of the page. For example, if the page is scrolled such that 200 pixels of the left side of the document are scrolled out of view, and the mouse is clicked 100 pixels inward from the left edge of the view, the value returned by pageX will be 300. - #[deprecated(since = "0.3.0", note = "use page_coordinates() instead")] - pub page_x: i32, - - /// The Y (vertical) coordinate in pixels of the event relative to the whole document. - /// - /// See `page_x`. - #[deprecated(since = "0.3.0", note = "use page_coordinates() instead")] - pub page_y: i32, - - /// The X coordinate of the mouse pointer in global (screen) coordinates. - #[deprecated(since = "0.3.0", note = "use screen_coordinates() instead")] - pub screen_x: i32, - - /// The Y coordinate of the mouse pointer in global (screen) coordinates. - #[deprecated(since = "0.3.0", note = "use screen_coordinates() instead")] - pub screen_y: i32, - - /// True if the shift key was down when the mouse event was fired. - #[deprecated(since = "0.3.0", note = "use modifiers() instead")] - pub shift_key: bool, + point_data: PointData, } impl_event! { @@ -153,118 +77,14 @@ impl MouseData { /// Construct MouseData with the specified properties /// /// Note: the current implementation truncates coordinates. In the future, when we change the internal representation, it may also support a fractional part. - pub fn new( - coordinates: Coordinates, - trigger_button: Option, - held_buttons: MouseButtonSet, - modifiers: Modifiers, - ) -> Self { - let alt_key = modifiers.contains(Modifiers::ALT); - let ctrl_key = modifiers.contains(Modifiers::CONTROL); - let meta_key = modifiers.contains(Modifiers::META); - let shift_key = modifiers.contains(Modifiers::SHIFT); - - let [client_x, client_y]: [i32; 2] = coordinates.client().cast().into(); - let [offset_x, offset_y]: [i32; 2] = coordinates.element().cast().into(); - let [page_x, page_y]: [i32; 2] = coordinates.page().cast().into(); - let [screen_x, screen_y]: [i32; 2] = coordinates.screen().cast().into(); - - #[allow(deprecated)] - Self { - alt_key, - ctrl_key, - meta_key, - shift_key, - - button: trigger_button.map_or(0, |b| b.into_web_code()), - buttons: encode_mouse_button_set(held_buttons), - - client_x, - client_y, - offset_x, - offset_y, - page_x, - page_y, - screen_x, - screen_y, - } + pub fn new(point_data: PointData) -> Self { + Self { point_data } } +} - /// The event's coordinates relative to the application's viewport (as opposed to the coordinate within the page). - /// - /// For example, clicking in the top left corner of the viewport will always result in a mouse event with client coordinates (0., 0.), regardless of whether the page is scrolled horizontally. - pub fn client_coordinates(&self) -> ClientPoint { - #[allow(deprecated)] - ClientPoint::new(self.client_x.into(), self.client_y.into()) - } - - /// The event's coordinates relative to the padding edge of the target element - /// - /// For example, clicking in the top left corner of an element will result in element coordinates (0., 0.) - pub fn element_coordinates(&self) -> ElementPoint { - #[allow(deprecated)] - ElementPoint::new(self.offset_x.into(), self.offset_y.into()) - } - - /// The event's coordinates relative to the entire document. This includes any portion of the document not currently visible. - /// - /// For example, if the page is scrolled 200 pixels to the right and 300 pixels down, clicking in the top left corner of the viewport would result in page coordinates (200., 300.) - pub fn page_coordinates(&self) -> PagePoint { - #[allow(deprecated)] - PagePoint::new(self.page_x.into(), self.page_y.into()) - } - - /// The event's coordinates relative to the entire screen. This takes into account the window's offset. - pub fn screen_coordinates(&self) -> ScreenPoint { - #[allow(deprecated)] - ScreenPoint::new(self.screen_x.into(), self.screen_y.into()) - } - - pub fn coordinates(&self) -> Coordinates { - Coordinates::new( - self.screen_coordinates(), - self.client_coordinates(), - self.element_coordinates(), - self.page_coordinates(), - ) - } - - /// The set of modifier keys which were pressed when the event occurred - pub fn modifiers(&self) -> Modifiers { - let mut modifiers = Modifiers::empty(); - - #[allow(deprecated)] - { - if self.alt_key { - modifiers.insert(Modifiers::ALT); - } - if self.ctrl_key { - modifiers.insert(Modifiers::CONTROL); - } - if self.meta_key { - modifiers.insert(Modifiers::META); - } - if self.shift_key { - modifiers.insert(Modifiers::SHIFT); - } - } - - modifiers - } - - /// The set of mouse buttons which were held when the event occurred. - pub fn held_buttons(&self) -> MouseButtonSet { - #[allow(deprecated)] - decode_mouse_button_set(self.buttons) - } - - /// The mouse button that triggered the event - /// - // todo the following is kind of bad; should we just return None when the trigger_button is unreliable (and frankly irrelevant)? i guess we would need the event_type here - /// This is only guaranteed to indicate which button was pressed during events caused by pressing or releasing a button. As such, it is not reliable for events such as mouseenter, mouseleave, mouseover, mouseout, or mousemove. For example, a value of MouseButton::Primary may also indicate that no button was pressed. - pub fn trigger_button(&self) -> Option { - #[allow(deprecated)] - Some(MouseButton::from_web_code(self.button)) +impl PointInteraction for MouseData { + fn get_point_data(&self) -> PointData { + self.point_data } } diff --git a/packages/html/src/input_data.rs b/packages/html/src/input_data.rs index 28d182fdc..d354c78a9 100644 --- a/packages/html/src/input_data.rs +++ b/packages/html/src/input_data.rs @@ -8,9 +8,10 @@ use keyboard_types::Location; /// A mouse button type (such as Primary/Secondary) // note: EnumSetType also derives Copy and Clone for some reason #[allow(clippy::unused_unit)] -#[derive(EnumSetType, Debug)] +#[derive(EnumSetType, Debug, Default)] #[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] pub enum MouseButton { + #[default] /// Primary button (typically the left button) Primary, /// Secondary button (typically the right button) diff --git a/packages/html/src/lib.rs b/packages/html/src/lib.rs index 2fc1baeac..d555d798a 100644 --- a/packages/html/src/lib.rs +++ b/packages/html/src/lib.rs @@ -22,6 +22,7 @@ mod global_attributes; pub mod input_data; #[cfg(feature = "native-bind")] pub mod native_bind; +mod point_interaction; mod render_template; #[cfg(feature = "wasm-bind")] mod web_sys_bind; diff --git a/packages/html/src/point_interaction.rs b/packages/html/src/point_interaction.rs new file mode 100644 index 000000000..9692420e8 --- /dev/null +++ b/packages/html/src/point_interaction.rs @@ -0,0 +1,95 @@ +use keyboard_types::Modifiers; + +use crate::{ + geometry::{ClientPoint, Coordinates, ElementPoint, PagePoint, ScreenPoint}, + input_data::{MouseButton, MouseButtonSet}, +}; + +#[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] +#[derive(Copy, Clone, Default, PartialEq, Eq)] +pub struct PointData { + pub trigger_button: MouseButton, + pub client_x: i32, + pub client_y: i32, + pub screen_x: i32, + pub screen_y: i32, + pub element_x: i32, + pub element_y: i32, + pub page_x: i32, + pub page_y: i32, + pub held_buttons: MouseButtonSet, + pub modifiers: Modifiers, +} + +impl PointData { + pub fn new( + trigger_button: Option, + coordinates: Coordinates, + held_buttons: MouseButtonSet, + modifiers: Modifiers, + ) -> Self { + let [client_x, client_y]: [i32; 2] = coordinates.client().cast().into(); + let [element_x, element_y]: [i32; 2] = coordinates.element().cast().into(); + let [page_x, page_y]: [i32; 2] = coordinates.page().cast().into(); + let [screen_x, screen_y]: [i32; 2] = coordinates.screen().cast().into(); + Self { + trigger_button: trigger_button.map_or(MouseButton::default(), |b| b), + client_x, + client_y, + screen_x, + screen_y, + element_x, + element_y, + page_x, + page_y, + held_buttons, + modifiers, + } + } +} + +pub trait PointInteraction { + fn get_point_data(&self) -> PointData; + + fn coordinates(&self) -> Coordinates { + let point_data = self.get_point_data(); + Coordinates::new( + ScreenPoint::new(point_data.screen_x.into(), point_data.screen_y.into()), + ClientPoint::new(point_data.client_x.into(), point_data.client_y.into()), + ElementPoint::new(point_data.element_x.into(), point_data.element_y.into()), + PagePoint::new(point_data.page_x.into(), point_data.page_y.into()), + ) + } + + fn client_coordinates(&self) -> ClientPoint { + let point_data = self.get_point_data(); + ClientPoint::new(point_data.client_x.into(), point_data.client_y.into()) + } + + fn screen_coordinates(&self) -> ScreenPoint { + let point_data = self.get_point_data(); + ScreenPoint::new(point_data.screen_x.into(), point_data.screen_y.into()) + } + + fn element_coordinates(&self) -> ElementPoint { + let point_data = self.get_point_data(); + ElementPoint::new(point_data.element_x.into(), point_data.element_y.into()) + } + + fn page_coordinates(&self) -> PagePoint { + let point_data = self.get_point_data(); + PagePoint::new(point_data.page_x.into(), point_data.page_y.into()) + } + + fn modifiers(&self) -> Modifiers { + self.get_point_data().modifiers + } + + fn held_buttons(&self) -> MouseButtonSet { + self.get_point_data().held_buttons + } + + fn trigger_button(&self) -> MouseButton { + self.get_point_data().trigger_button + } +} diff --git a/packages/html/src/web_sys_bind/events.rs b/packages/html/src/web_sys_bind/events.rs index e5a6c0d78..4b87fcf41 100644 --- a/packages/html/src/web_sys_bind/events.rs +++ b/packages/html/src/web_sys_bind/events.rs @@ -2,8 +2,8 @@ use crate::events::{ AnimationData, CompositionData, KeyboardData, MouseData, PointerData, TouchData, TransitionData, WheelData, }; -use crate::geometry::{ClientPoint, Coordinates, ElementPoint, PagePoint, ScreenPoint}; use crate::input_data::{decode_key_location, decode_mouse_button_set, MouseButton}; +use crate::point_interaction::PointData; use crate::{DragData, MountedData}; use keyboard_types::{Code, Key, Modifiers}; use std::convert::TryInto; @@ -105,17 +105,19 @@ impl From<&MouseEvent> for MouseData { modifiers.insert(Modifiers::SHIFT); } - MouseData::new( - Coordinates::new( - ScreenPoint::new(e.screen_x().into(), e.screen_y().into()), - ClientPoint::new(e.client_x().into(), e.client_y().into()), - ElementPoint::new(e.offset_x().into(), e.offset_y().into()), - PagePoint::new(e.page_x().into(), e.page_y().into()), - ), - Some(MouseButton::from_web_code(e.button())), - decode_mouse_button_set(e.buttons()), + MouseData::new(PointData { + trigger_button: MouseButton::from_web_code(e.button()), + client_x: e.client_x(), + client_y: e.client_y(), + screen_x: e.screen_x(), + screen_y: e.screen_y(), + element_x: e.offset_x(), + element_y: e.offset_y(), + page_x: e.page_x(), + page_y: e.page_y(), + held_buttons: decode_mouse_button_set(e.buttons()), modifiers, - ) + }) } } From 6973e8bb86a938c2122af51a4a2a3dbfd552b532 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Wed, 23 Aug 2023 09:47:50 -0500 Subject: [PATCH 028/447] increase playwright timeout --- playwright-tests/playwright.config.js | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/playwright-tests/playwright.config.js b/playwright-tests/playwright.config.js index 7ad95175e..dcee8f0e4 100644 --- a/playwright-tests/playwright.config.js +++ b/playwright-tests/playwright.config.js @@ -76,7 +76,7 @@ module.exports = defineConfig({ command: "cargo run --package dioxus-playwright-liveview-test --bin dioxus-playwright-liveview-test", port: 3030, - timeout: 10 * 60 * 1000, + timeout: 20 * 60 * 1000, reuseExistingServer: !process.env.CI, stdout: "pipe", }, @@ -84,7 +84,7 @@ module.exports = defineConfig({ cwd: path.join(process.cwd(), "web"), command: "cargo run --package dioxus-cli --release -- serve --skip-assets", port: 8080, - timeout: 10 * 60 * 1000, + timeout: 20 * 60 * 1000, reuseExistingServer: !process.env.CI, stdout: "pipe", }, @@ -92,7 +92,7 @@ module.exports = defineConfig({ cwd: path.join(process.cwd(), 'fullstack'), command: 'cargo run --package dioxus-cli --release -- build --features web --release --skip-assets\ncargo run --release --features ssr', port: 3333, - timeout: 10 * 60 * 1000, + timeout: 20 * 60 * 1000, reuseExistingServer: !process.env.CI, stdout: "pipe", }, From e337aff0a443297c7d4f14b1bb5e1ad23963f10e Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Wed, 23 Aug 2023 10:48:10 -0500 Subject: [PATCH 029/447] WIP split element from element ref --- packages/core/src/arena.rs | 86 +++++++------ packages/core/src/create.rs | 80 ++++++------- packages/core/src/diff.rs | 200 ++++++++++++++++++++----------- packages/core/src/fragment.rs | 2 +- packages/core/src/nodes.rs | 7 +- packages/core/src/virtual_dom.rs | 137 +++++++++++---------- packages/rsx/src/lib.rs | 2 +- 7 files changed, 291 insertions(+), 223 deletions(-) diff --git a/packages/core/src/arena.rs b/packages/core/src/arena.rs index c8f7ce3c9..c41454b50 100644 --- a/packages/core/src/arena.rs +++ b/packages/core/src/arena.rs @@ -13,62 +13,52 @@ use crate::{ #[derive(Clone, Copy, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Default)] pub struct ElementId(pub usize); -pub(crate) struct ElementRef { +/// An Element that can be bubbled to's unique identifier. +/// +/// `ElementId` is a `usize` that is unique across the entire VirtualDOM - but not unique across time. If a component is +/// unmounted, then the `ElementId` will be reused for a new component. +#[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] +#[derive(Clone, Copy, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Default)] +pub struct BubbleId(pub usize); + +#[derive(Debug, Clone)] +pub struct ElementRef { // the pathway of the real element inside the template - pub path: ElementPath, + pub(crate) path: ElementPath, // The actual template - pub template: Option>>, + pub(crate) template: NonNull>, // The scope the element belongs to - pub scope: ScopeId, + pub(crate) scope: ScopeId, } #[derive(Clone, Copy, Debug)] -pub enum ElementPath { - Deep(&'static [u8]), - Root(usize), -} - -impl ElementRef { - pub(crate) fn none() -> Self { - Self { - template: None, - path: ElementPath::Root(0), - scope: ScopeId(0), - } - } +pub struct ElementPath { + path: &'static [u8], } impl VirtualDom { - pub(crate) fn next_element(&mut self, template: &VNode, path: &'static [u8]) -> ElementId { - self.next_reference(template, ElementPath::Deep(path)) + pub(crate) fn next_element(&mut self) -> ElementId { + ElementId(self.elements.insert(None)) } - pub(crate) fn next_root(&mut self, template: &VNode, path: usize) -> ElementId { - self.next_reference(template, ElementPath::Root(path)) + pub(crate) fn next_element_ref(&mut self, template: &VNode, path: &'static [u8]) -> BubbleId { + self.next_reference(template, ElementPath { path }) } - pub(crate) fn next_null(&mut self) -> ElementId { - let entry = self.elements.vacant_entry(); - let id = entry.key(); - - entry.insert(ElementRef::none()); - ElementId(id) - } - - fn next_reference(&mut self, template: &VNode, path: ElementPath) -> ElementId { - let entry = self.elements.vacant_entry(); + fn next_reference(&mut self, template: &VNode, path: ElementPath) -> BubbleId { + let entry = self.element_refs.vacant_entry(); let id = entry.key(); let scope = self.runtime.current_scope_id().unwrap_or(ScopeId(0)); entry.insert(ElementRef { // We know this is non-null because it comes from a reference - template: Some(unsafe { NonNull::new_unchecked(template as *const _ as *mut _) }), + template: unsafe { NonNull::new_unchecked(template as *const _ as *mut _) }, path, scope, }); - ElementId(id) + BubbleId(id) } pub(crate) fn reclaim(&mut self, el: ElementId) { @@ -76,7 +66,7 @@ impl VirtualDom { .unwrap_or_else(|| panic!("cannot reclaim {:?}", el)); } - pub(crate) fn try_reclaim(&mut self, el: ElementId) -> Option { + pub(crate) fn try_reclaim(&mut self, el: ElementId) -> Option<()> { if el.0 == 0 { panic!( "Cannot reclaim the root element - {:#?}", @@ -84,12 +74,26 @@ impl VirtualDom { ); } - self.elements.try_remove(el.0) + self.elements.try_remove(el.0).map(|_| ()) + } + + pub(crate) fn set_template(&mut self, el: ElementId, node: &VNode, path: &'static [u8]) { + match self.elements[el.0] { + Some(bubble_id) => { + self.element_refs[bubble_id.0].path = ElementPath { path }; + self.element_refs[bubble_id.0].template = + unsafe { NonNull::new_unchecked(node as *const _ as *mut _) }; + } + None => { + self.elements[el.0] = Some(self.next_reference(node, ElementPath { path })); + } + } } pub(crate) fn update_template(&mut self, el: ElementId, node: &VNode) { + let bubble_id = self.elements[el.0].unwrap(); let node: *const VNode = node as *const _; - self.elements[el.0].template = unsafe { std::mem::transmute(node) }; + self.element_refs[bubble_id.0].template = unsafe { std::mem::transmute(node) }; } // Drop a scope and all its children @@ -182,18 +186,12 @@ impl VirtualDom { impl ElementPath { pub(crate) fn is_decendant(&self, small: &&[u8]) -> bool { - match *self { - ElementPath::Deep(big) => small.len() <= big.len() && *small == &big[..small.len()], - ElementPath::Root(r) => small.len() == 1 && small[0] == r as u8, - } + small.len() <= self.path.len() && *small == &self.path[..small.len()] } } impl PartialEq<&[u8]> for ElementPath { fn eq(&self, other: &&[u8]) -> bool { - match *self { - ElementPath::Deep(deep) => deep.eq(*other), - ElementPath::Root(r) => other.len() == 1 && other[0] == r as u8, - } + self.path.eq(*other) } } diff --git a/packages/core/src/create.rs b/packages/core/src/create.rs index a61a8cace..f8ae3add3 100644 --- a/packages/core/src/create.rs +++ b/packages/core/src/create.rs @@ -1,4 +1,5 @@ use crate::any_props::AnyProps; +use crate::diff::BoundaryRef; use crate::innerlude::{BorrowedAttributeValue, VComponent, VPlaceholder, VText}; use crate::mutations::Mutation; use crate::mutations::Mutation::*; @@ -181,15 +182,15 @@ impl<'b> VirtualDom { use DynamicNode::*; match &template.dynamic_nodes[idx] { node @ Component { .. } | node @ Fragment(_) => { - self.create_dynamic_node(template, node, idx) + self.create_dynamic_node(template, idx, node, idx) } Placeholder(VPlaceholder { id }) => { - let id = self.set_slot(template, id, idx); + let id = self.set_slot(id); self.mutations.push(CreatePlaceholder { id }); 1 } Text(VText { id, value }) => { - let id = self.set_slot(template, id, idx); + let id = self.set_slot(id); self.create_static_text(value, id); 1 } @@ -265,7 +266,7 @@ impl<'b> VirtualDom { .map(|sorted_index| dynamic_nodes[sorted_index].0); for idx in reversed_iter { - let m = self.create_dynamic_node(template, &template.dynamic_nodes[idx], idx); + let m = self.create_dynamic_node(template, idx, &template.dynamic_nodes[idx], idx); if m > 0 { // The path is one shorter because the top node is the root let path = &template.template.get().node_paths[idx][1..]; @@ -279,15 +280,15 @@ impl<'b> VirtualDom { attrs: &mut Peekable>, root_idx: u8, root: ElementId, - node: &VNode, + node: &'b VNode<'b>, ) { while let Some((mut attr_id, path)) = attrs.next_if(|(_, p)| p.first().copied() == Some(root_idx)) { - let id = self.assign_static_node_as_dynamic(path, root, node, attr_id); + let id = self.assign_static_node_as_dynamic(path, root); loop { - self.write_attribute(&node.dynamic_attrs[attr_id], id); + self.write_attribute(node, attr_id, &node.dynamic_attrs[attr_id], id); // Only push the dynamic attributes forward if they match the current path (same element) match attrs.next_if(|(_, p)| *p == path) { @@ -298,7 +299,13 @@ impl<'b> VirtualDom { } } - fn write_attribute(&mut self, attribute: &'b crate::Attribute<'b>, id: ElementId) { + fn write_attribute( + &mut self, + template: &'b VNode<'b>, + idx: usize, + attribute: &'b crate::Attribute<'b>, + id: ElementId, + ) { // Make sure we set the attribute's associated id attribute.mounted_element.set(id); @@ -307,6 +314,8 @@ impl<'b> VirtualDom { match &attribute.value { AttributeValue::Listener(_) => { + let path = &template.template.get().attr_paths[idx]; + self.set_template(id, template, path); self.mutations.push(NewEventListener { // all listeners start with "on" name: &unbounded_name[2..], @@ -330,7 +339,7 @@ impl<'b> VirtualDom { fn load_template_root(&mut self, template: &VNode, root_idx: usize) -> ElementId { // Get an ID for this root since it's a real root - let this_id = self.next_root(template, root_idx); + let this_id = self.next_element(); template.root_ids.borrow_mut()[root_idx] = this_id; self.mutations.push(LoadTemplate { @@ -353,8 +362,6 @@ impl<'b> VirtualDom { &mut self, path: &'static [u8], this_id: ElementId, - template: &VNode, - attr_id: usize, ) -> ElementId { if path.len() == 1 { return this_id; @@ -362,7 +369,7 @@ impl<'b> VirtualDom { // if attribute is on a root node, then we've already created the element // Else, it's deep in the template and we should create a new id for it - let id = self.next_element(template, template.template.get().attr_paths[attr_id]); + let id = self.next_element(); self.mutations.push(Mutation::AssignId { path: &path[1..], @@ -439,27 +446,21 @@ impl<'b> VirtualDom { pub(crate) fn create_dynamic_node( &mut self, - template: &'b VNode<'b>, + parent: BoundaryRef<'b>, node: &'b DynamicNode<'b>, - idx: usize, ) -> usize { use DynamicNode::*; match node { - Text(text) => self.create_dynamic_text(template, text, idx), - Placeholder(place) => self.create_placeholder(place, template, idx), - Component(component) => self.create_component_node(template, component), + Text(text) => self.create_dynamic_text(parent, text), + Placeholder(place) => self.create_placeholder(place, parent), + Component(component) => self.create_component_node(parent, component), Fragment(frag) => frag.iter().map(|child| self.create(child)).sum(), } } - fn create_dynamic_text( - &mut self, - template: &'b VNode<'b>, - text: &'b VText<'b>, - idx: usize, - ) -> usize { + fn create_dynamic_text(&mut self, parent: BoundaryRef<'b>, text: &'b VText<'b>) -> usize { // Allocate a dynamic element reference for this text node - let new_id = self.next_element(template, template.template.get().node_paths[idx]); + let new_id = self.next_element(); // Make sure the text node is assigned to the correct element text.id.set(Some(new_id)); @@ -470,7 +471,7 @@ impl<'b> VirtualDom { // Add the mutation to the list self.mutations.push(HydrateText { id: new_id, - path: &template.template.get().node_paths[idx][1..], + path: &parent.parent.template.get().node_paths[parent.dyn_node_idx][1..], value, }); @@ -481,18 +482,17 @@ impl<'b> VirtualDom { pub(crate) fn create_placeholder( &mut self, placeholder: &VPlaceholder, - template: &'b VNode<'b>, - idx: usize, + parent: BoundaryRef<'b>, ) -> usize { // Allocate a dynamic element reference for this text node - let id = self.next_element(template, template.template.get().node_paths[idx]); + let id = self.next_element(); // Make sure the text node is assigned to the correct element placeholder.id.set(Some(id)); // Assign the ID to the existing node in the template self.mutations.push(AssignId { - path: &template.template.get().node_paths[idx][1..], + path: &parent.parent.template.get().node_paths[parent.dyn_node_idx][1..], id, }); @@ -502,7 +502,7 @@ impl<'b> VirtualDom { pub(super) fn create_component_node( &mut self, - template: &'b VNode<'b>, + parent: BoundaryRef<'b>, component: &'b VComponent<'b>, ) -> usize { use RenderReturn::*; @@ -514,8 +514,11 @@ impl<'b> VirtualDom { match unsafe { self.run_scope(scope).extend_lifetime_ref() } { // Create the component's root element - Ready(t) => self.create_scope(scope, t), - Aborted(t) => self.mount_aborted(template, t), + Ready(t) => { + self.assign_boundary_ref(parent, t); + self.create_scope(scope, t) + } + Aborted(t) => self.mount_aborted(t), } } @@ -531,20 +534,15 @@ impl<'b> VirtualDom { .unwrap_or_else(|| component.scope.get().unwrap()) } - fn mount_aborted(&mut self, parent: &'b VNode<'b>, placeholder: &VPlaceholder) -> usize { - let id = self.next_element(parent, &[]); + fn mount_aborted(&mut self, placeholder: &VPlaceholder) -> usize { + let id = self.next_element(); self.mutations.push(Mutation::CreatePlaceholder { id }); placeholder.id.set(Some(id)); 1 } - fn set_slot( - &mut self, - template: &'b VNode<'b>, - slot: &'b Cell>, - id: usize, - ) -> ElementId { - let id = self.next_element(template, template.template.get().node_paths[id]); + fn set_slot(&mut self, slot: &'b Cell>) -> ElementId { + let id = self.next_element(); slot.set(Some(id)); id } diff --git a/packages/core/src/diff.rs b/packages/core/src/diff.rs index dd4cf8147..80ccbc315 100644 --- a/packages/core/src/diff.rs +++ b/packages/core/src/diff.rs @@ -7,7 +7,7 @@ use crate::{ nodes::{DynamicNode, VNode}, scopes::ScopeId, virtual_dom::VirtualDom, - Attribute, TemplateNode, + Attribute, AttributeValue, TemplateNode, }; use rustc_hash::{FxHashMap, FxHashSet}; @@ -43,14 +43,14 @@ impl<'b> VirtualDom { // Placeholder becomes something // We should also clear the error now - (Aborted(l), Ready(r)) => self.replace_placeholder(l, [r]), + (Aborted(l), Ready(r)) => self.replace_placeholder(l, [r], todo!()), }; } self.runtime.scope_stack.borrow_mut().pop(); } fn diff_ok_to_err(&mut self, l: &'b VNode<'b>, p: &'b VPlaceholder) { - let id = self.next_null(); + let id = self.next_element(); p.id.set(Some(id)); self.mutations.push(Mutation::CreatePlaceholder { id }); @@ -81,12 +81,17 @@ impl<'b> VirtualDom { if let Some(&template) = map.get(&byte_index) { right_template.template.set(template); if template != left_template.template.get() { - return self.replace(left_template, [right_template]); + return self.replace(left_template, [right_template], todo!()); } } } } + // Copy over the parent + { + right_template.parent.set(left_template.parent.get()); + } + // If the templates are the same, we don't need to do anything, nor do we want to if templates_are_the_same(left_template, right_template) { return; @@ -94,7 +99,7 @@ impl<'b> VirtualDom { // If the templates are different by name, we need to replace the entire template if templates_are_different(left_template, right_template) { - return self.light_diff_templates(left_template, right_template); + return self.light_diff_templates(left_template, right_template, todo!()); } // If the templates are the same, we can diff the attributes and children @@ -105,15 +110,14 @@ impl<'b> VirtualDom { .zip(right_template.dynamic_attrs.iter()) .for_each(|(left_attr, right_attr)| { // Move over the ID from the old to the new - right_attr - .mounted_element - .set(left_attr.mounted_element.get()); - - // We want to make sure anything that gets pulled is valid - self.update_template(left_attr.mounted_element.get(), right_template); + let mounted_element = left_attr.mounted_element.get(); + right_attr.mounted_element.set(mounted_element); // If the attributes are different (or volatile), we need to update them - if left_attr.value != right_attr.value || left_attr.volatile { + if let AttributeValue::Listener(_) = left_attr.value { + // Nodes with Listeners always need their pointers updated + self.update_template(mounted_element, right_template); + } else if left_attr.value != right_attr.value || left_attr.volatile { self.update_attribute(right_attr, left_attr); } }); @@ -123,8 +127,13 @@ impl<'b> VirtualDom { .dynamic_nodes .iter() .zip(right_template.dynamic_nodes.iter()) - .for_each(|(left_node, right_node)| { - self.diff_dynamic_node(left_node, right_node, right_template); + .enumerate() + .for_each(|(dyn_node_idx, (left_node, right_node))| { + let current_ref = BoundaryRef { + parent: right_template, + dyn_node_idx, + }; + self.diff_dynamic_node(left_node, right_node, current_ref); }); // Make sure the roots get transferred over while we're here @@ -135,29 +144,20 @@ impl<'b> VirtualDom { right.push(element); } } - - let root_ids = right_template.root_ids.borrow(); - - // Update the node refs - for i in 0..root_ids.len() { - if let Some(root_id) = root_ids.get(i) { - self.update_template(*root_id, right_template); - } - } } fn diff_dynamic_node( &mut self, left_node: &'b DynamicNode<'b>, right_node: &'b DynamicNode<'b>, - node: &'b VNode<'b>, + parent: BoundaryRef<'b>, ) { match (left_node, right_node) { - (Text(left), Text(right)) => self.diff_vtext(left, right, node), - (Fragment(left), Fragment(right)) => self.diff_non_empty_fragment(left, right), + (Text(left), Text(right)) => self.diff_vtext(left, right), + (Fragment(left), Fragment(right)) => self.diff_non_empty_fragment(left, right, parent), (Placeholder(left), Placeholder(right)) => right.id.set(left.id.get()), - (Component(left), Component(right)) => self.diff_vcomponent(left, right, node), - (Placeholder(left), Fragment(right)) => self.replace_placeholder(left, *right), + (Component(left), Component(right)) => self.diff_vcomponent(left, right, parent), + (Placeholder(left), Fragment(right)) => self.replace_placeholder(left, *right, parent), (Fragment(left), Placeholder(right)) => self.node_to_placeholder(left, right), _ => todo!("This is an usual custom case for dynamic nodes. We don't know how to handle it yet."), }; @@ -179,7 +179,7 @@ impl<'b> VirtualDom { &mut self, left: &'b VComponent<'b>, right: &'b VComponent<'b>, - right_template: &'b VNode<'b>, + parent: BoundaryRef<'b>, ) { if std::ptr::eq(left, right) { return; @@ -187,7 +187,7 @@ impl<'b> VirtualDom { // Replace components that have different render fns if left.render_fn != right.render_fn { - return self.replace_vcomponent(right_template, right, left); + return self.replace_vcomponent(right, left, parent); } // Make sure the new vcomponent has the right scopeid associated to it @@ -222,11 +222,11 @@ impl<'b> VirtualDom { fn replace_vcomponent( &mut self, - right_template: &'b VNode<'b>, right: &'b VComponent<'b>, left: &'b VComponent<'b>, + parent: BoundaryRef<'b>, ) { - let m = self.create_component_node(right_template, right); + let m = self.create_component_node(parent, right); let pre_edits = self.mutations.edits.len(); @@ -280,12 +280,17 @@ impl<'b> VirtualDom { /// Component { ..props } /// } /// ``` - fn light_diff_templates(&mut self, left: &'b VNode<'b>, right: &'b VNode<'b>) { + fn light_diff_templates( + &mut self, + left: &'b VNode<'b>, + right: &'b VNode<'b>, + parent: BoundaryRef<'b>, + ) { match matching_components(left, right) { - None => self.replace(left, [right]), + None => self.replace(left, [right], parent), Some(components) => components .into_iter() - .for_each(|(l, r)| self.diff_vcomponent(l, r, right)), + .for_each(|(idx, l, r)| self.diff_vcomponent(l, r, parent)), } } @@ -293,11 +298,8 @@ impl<'b> VirtualDom { /// /// This just moves the ID of the old node over to the new node, and then sets the text of the new node if it's /// different. - fn diff_vtext(&mut self, left: &'b VText<'b>, right: &'b VText<'b>, node: &'b VNode<'b>) { - let id = left - .id - .get() - .unwrap_or_else(|| self.next_element(node, &[0])); + fn diff_vtext(&mut self, left: &'b VText<'b>, right: &'b VText<'b>) { + let id = left.id.get().unwrap_or_else(|| self.next_element()); right.id.set(Some(id)); if left.value != right.value { @@ -306,7 +308,12 @@ impl<'b> VirtualDom { } } - fn diff_non_empty_fragment(&mut self, old: &'b [VNode<'b>], new: &'b [VNode<'b>]) { + fn diff_non_empty_fragment( + &mut self, + old: &'b [VNode<'b>], + new: &'b [VNode<'b>], + parent: BoundaryRef<'b>, + ) { let new_is_keyed = new[0].key.is_some(); let old_is_keyed = old[0].key.is_some(); debug_assert!( @@ -319,9 +326,9 @@ impl<'b> VirtualDom { ); if new_is_keyed && old_is_keyed { - self.diff_keyed_children(old, new); + self.diff_keyed_children(old, new, parent); } else { - self.diff_non_keyed_children(old, new); + self.diff_non_keyed_children(old, new, parent); } } @@ -333,7 +340,12 @@ impl<'b> VirtualDom { // [... parent] // // the change list stack is in the same state when this function returns. - fn diff_non_keyed_children(&mut self, old: &'b [VNode<'b>], new: &'b [VNode<'b>]) { + fn diff_non_keyed_children( + &mut self, + old: &'b [VNode<'b>], + new: &'b [VNode<'b>], + parent: BoundaryRef<'b>, + ) { use std::cmp::Ordering; // Handled these cases in `diff_children` before calling this function. @@ -342,7 +354,9 @@ impl<'b> VirtualDom { match old.len().cmp(&new.len()) { Ordering::Greater => self.remove_nodes(&old[new.len()..]), - Ordering::Less => self.create_and_insert_after(&new[old.len()..], old.last().unwrap()), + Ordering::Less => { + self.create_and_insert_after(&new[old.len()..], old.last().unwrap(), parent) + } Ordering::Equal => {} } @@ -367,7 +381,12 @@ impl<'b> VirtualDom { // https://github.com/infernojs/inferno/blob/36fd96/packages/inferno/src/DOM/patching.ts#L530-L739 // // The stack is empty upon entry. - fn diff_keyed_children(&mut self, old: &'b [VNode<'b>], new: &'b [VNode<'b>]) { + fn diff_keyed_children( + &mut self, + old: &'b [VNode<'b>], + new: &'b [VNode<'b>], + parent: BoundaryRef<'b>, + ) { if cfg!(debug_assertions) { let mut keys = rustc_hash::FxHashSet::default(); let mut assert_unique_keys = |children: &'b [VNode<'b>]| { @@ -395,7 +414,7 @@ impl<'b> VirtualDom { // // `shared_prefix_count` is the count of how many nodes at the start of // `new` and `old` share the same keys. - let (left_offset, right_offset) = match self.diff_keyed_ends(old, new) { + let (left_offset, right_offset) = match self.diff_keyed_ends(old, new, parent) { Some(count) => count, None => return, }; @@ -421,18 +440,18 @@ impl<'b> VirtualDom { if left_offset == 0 { // insert at the beginning of the old list let foothold = &old[old.len() - right_offset]; - self.create_and_insert_before(new_middle, foothold); + self.create_and_insert_before(new_middle, foothold, parent); } else if right_offset == 0 { // insert at the end the old list let foothold = old.last().unwrap(); - self.create_and_insert_after(new_middle, foothold); + self.create_and_insert_after(new_middle, foothold, parent); } else { // inserting in the middle let foothold = &old[left_offset - 1]; - self.create_and_insert_after(new_middle, foothold); + self.create_and_insert_after(new_middle, foothold, parent); } } else { - self.diff_keyed_middle(old_middle, new_middle); + self.diff_keyed_middle(old_middle, new_middle, parent); } } @@ -445,6 +464,7 @@ impl<'b> VirtualDom { &mut self, old: &'b [VNode<'b>], new: &'b [VNode<'b>], + parent: BoundaryRef<'b>, ) -> Option<(usize, usize)> { let mut left_offset = 0; @@ -460,7 +480,7 @@ impl<'b> VirtualDom { // If that was all of the old children, then create and append the remaining // new children and we're finished. if left_offset == old.len() { - self.create_and_insert_after(&new[left_offset..], old.last().unwrap()); + self.create_and_insert_after(&new[left_offset..], old.last().unwrap(), parent); return None; } @@ -499,7 +519,12 @@ impl<'b> VirtualDom { // // Upon exit from this function, it will be restored to that same self. #[allow(clippy::too_many_lines)] - fn diff_keyed_middle(&mut self, old: &'b [VNode<'b>], new: &'b [VNode<'b>]) { + fn diff_keyed_middle( + &mut self, + old: &'b [VNode<'b>], + new: &'b [VNode<'b>], + parent: BoundaryRef<'b>, + ) { /* 1. Map the old keys into a numerical ordering based on indices. 2. Create a map of old key to its index @@ -556,7 +581,7 @@ impl<'b> VirtualDom { if shared_keys.is_empty() { if old.get(0).is_some() { self.remove_nodes(&old[1..]); - self.replace(&old[0], new); + self.replace(&old[0], new, parent); } else { // I think this is wrong - why are we appending? // only valid of the if there are no trailing elements @@ -734,20 +759,35 @@ impl<'b> VirtualDom { .sum() } - fn create_children(&mut self, nodes: impl IntoIterator>) -> usize { - nodes - .into_iter() - .fold(0, |acc, child| acc + self.create(child)) + fn create_children( + &mut self, + nodes: impl IntoIterator>, + parent: BoundaryRef<'b>, + ) -> usize { + nodes.into_iter().fold(0, |acc, child| { + self.assign_boundary_ref(parent, child); + acc + self.create(child) + }) } - fn create_and_insert_before(&mut self, new: &'b [VNode<'b>], before: &'b VNode<'b>) { - let m = self.create_children(new); + fn create_and_insert_before( + &mut self, + new: &'b [VNode<'b>], + before: &'b VNode<'b>, + parent: BoundaryRef<'b>, + ) { + let m = self.create_children(new, parent); let id = self.find_first_element(before); self.mutations.push(Mutation::InsertBefore { id, m }) } - fn create_and_insert_after(&mut self, new: &'b [VNode<'b>], after: &'b VNode<'b>) { - let m = self.create_children(new); + fn create_and_insert_after( + &mut self, + new: &'b [VNode<'b>], + after: &'b VNode<'b>, + parent: BoundaryRef<'b>, + ) { + let m = self.create_children(new, parent); let id = self.find_last_element(after); self.mutations.push(Mutation::InsertAfter { id, m }) } @@ -757,15 +797,21 @@ impl<'b> VirtualDom { &mut self, l: &'b VPlaceholder, r: impl IntoIterator>, + parent: BoundaryRef<'b>, ) { - let m = self.create_children(r); + let m = self.create_children(r, parent); let id = l.id.get().unwrap(); self.mutations.push(Mutation::ReplaceWith { id, m }); self.reclaim(id); } - fn replace(&mut self, left: &'b VNode<'b>, right: impl IntoIterator>) { - let m = self.create_children(right); + fn replace( + &mut self, + left: &'b VNode<'b>, + right: impl IntoIterator>, + parent: BoundaryRef<'b>, + ) { + let m = self.create_children(right, parent); let pre_edits = self.mutations.edits.len(); @@ -786,7 +832,7 @@ impl<'b> VirtualDom { fn node_to_placeholder(&mut self, l: &'b [VNode<'b>], r: &'b VPlaceholder) { // Create the placeholder first, ensuring we get a dedicated ID for the placeholder - let placeholder = self.next_element(&l[0], &[]); + let placeholder = self.next_element(); r.id.set(Some(placeholder)); @@ -984,6 +1030,15 @@ impl<'b> VirtualDom { } } } + + pub(crate) fn assign_boundary_ref(&mut self, parent: BoundaryRef, child: &VNode<'_>) { + // assign the parent + let path = parent.parent.template.get().node_paths[parent.dyn_node_idx]; + + child + .parent + .set(Some(self.next_element_ref(parent.parent, path))); + } } /// Are the templates the same? @@ -1005,7 +1060,7 @@ fn templates_are_different(left_template: &VNode, right_template: &VNode) -> boo fn matching_components<'a>( left: &'a VNode<'a>, right: &'a VNode<'a>, -) -> Option, &'a VComponent<'a>)>> { +) -> Option, &'a VComponent<'a>)>> { let left_template = left.template.get(); let right_template = right.template.get(); if left_template.roots.len() != right_template.roots.len() { @@ -1017,7 +1072,8 @@ fn matching_components<'a>( .roots .iter() .zip(right_template.roots.iter()) - .map(|(l, r)| { + .enumerate() + .map(|(idx, (l, r))| { let (l, r) = match (l, r) { (TemplateNode::Dynamic { id: l }, TemplateNode::Dynamic { id: r }) => (l, r), _ => return None, @@ -1028,7 +1084,7 @@ fn matching_components<'a>( _ => return None, }; - Some((l, r)) + Some((idx, l, r)) }) .collect() } @@ -1060,3 +1116,9 @@ fn is_dyn_node_only_child(node: &VNode, idx: usize) -> bool { _ => false, } } + +// A parent that can be used for bubbling +pub(crate) struct BoundaryRef<'b> { + pub parent: &'b VNode<'b>, + pub dyn_node_idx: usize, +} diff --git a/packages/core/src/fragment.rs b/packages/core/src/fragment.rs index a9e919bfa..0e4bf09e3 100644 --- a/packages/core/src/fragment.rs +++ b/packages/core/src/fragment.rs @@ -30,7 +30,7 @@ pub fn Fragment<'a>(cx: Scope<'a, FragmentProps<'a>>) -> Element { let children = cx.props.0.as_ref()?; Some(VNode { key: children.key, - parent: children.parent, + parent: children.parent.clone(), template: children.template.clone(), root_ids: children.root_ids.clone(), dynamic_nodes: children.dynamic_nodes, diff --git a/packages/core/src/nodes.rs b/packages/core/src/nodes.rs index 2399c16b8..9232b2961 100644 --- a/packages/core/src/nodes.rs +++ b/packages/core/src/nodes.rs @@ -1,3 +1,4 @@ +use crate::innerlude::BubbleId; use crate::{ any_props::AnyProps, arena::ElementId, Element, Event, LazyNodes, ScopeId, ScopeState, }; @@ -47,7 +48,7 @@ pub struct VNode<'a> { pub key: Option<&'a str>, /// When rendered, this template will be linked to its parent manually - pub parent: Option, + pub parent: Cell>, /// The static nodes and static descriptor of the template pub template: Cell>, @@ -68,7 +69,7 @@ impl<'a> VNode<'a> { pub fn empty(cx: &'a ScopeState) -> Element<'a> { Some(VNode { key: None, - parent: None, + parent: Default::default(), root_ids: RefCell::new(bumpalo::collections::Vec::new_in(cx.bump())), dynamic_nodes: &[], dynamic_attrs: &[], @@ -722,7 +723,7 @@ impl<'b> IntoDynNode<'b> for Arguments<'_> { impl<'a> IntoDynNode<'a> for &'a VNode<'a> { fn into_vnode(self, _cx: &'a ScopeState) -> DynamicNode<'a> { DynamicNode::Fragment(_cx.bump().alloc([VNode { - parent: self.parent, + parent: self.parent.clone(), template: self.template.clone(), root_ids: self.root_ids.clone(), key: self.key, diff --git a/packages/core/src/virtual_dom.rs b/packages/core/src/virtual_dom.rs index a1def71d2..faf1ecf44 100644 --- a/packages/core/src/virtual_dom.rs +++ b/packages/core/src/virtual_dom.rs @@ -5,7 +5,7 @@ use crate::{ any_props::VProps, arena::{ElementId, ElementRef}, - innerlude::{DirtyScope, ErrorBoundary, Mutations, Scheduler, SchedulerMsg}, + innerlude::{BubbleId, DirtyScope, ErrorBoundary, Mutations, Scheduler, SchedulerMsg}, mutations::Mutation, nodes::RenderReturn, nodes::{Template, TemplateId}, @@ -183,7 +183,10 @@ pub struct VirtualDom { pub(crate) templates: FxHashMap>>, // Every element is actually a dual reference - one to the template and the other to the dynamic node in that template - pub(crate) elements: Slab, + pub(crate) element_refs: Slab, + + // The element ids that are used in the renderer + pub(crate) elements: Slab>, pub(crate) mutations: Mutations<'static>, @@ -260,6 +263,7 @@ impl VirtualDom { dirty_scopes: Default::default(), templates: Default::default(), elements: Default::default(), + element_refs: Default::default(), mutations: Mutations::default(), suspended_scopes: Default::default(), }; @@ -273,7 +277,7 @@ impl VirtualDom { root.provide_context(Rc::new(ErrorBoundary::new(ScopeId(0)))); // the root element is always given element ID 0 since it's the container for the entire tree - dom.elements.insert(ElementRef::none()); + dom.elements.insert(None); dom } @@ -349,7 +353,13 @@ impl VirtualDom { | | | <-- no, broke early | <-- no, broke early */ - let mut parent_path = self.elements.get(element.0); + println!("calling {:?}", element); + let element = match self.elements.get(element.0) { + Some(Some(el)) => el, + _ => return, + }; + let mut parent_path = self.element_refs.get(element.0).cloned(); + println!("parent path {:?}", parent_path); let mut listeners = vec![]; // We will clone this later. The data itself is wrapped in RC to be used in callbacks if required @@ -363,33 +373,69 @@ impl VirtualDom { // Loop through each dynamic attribute (in a depth first order) in this template before moving up to the template's parent. while let Some(el_ref) = parent_path { // safety: we maintain references of all vnodes in the element slab - if let Some(template) = el_ref.template { - let template = unsafe { template.as_ref() }; - let node_template = template.template.get(); - let target_path = el_ref.path; + let template = el_ref.template; + let template = unsafe { template.as_ref() }; + let node_template = template.template.get(); + let target_path = el_ref.path; - for (idx, attr) in template.dynamic_attrs.iter().enumerate() { - let this_path = node_template.attr_paths[idx]; + for (idx, attr) in template.dynamic_attrs.iter().enumerate() { + let this_path = node_template.attr_paths[idx]; - // Remove the "on" prefix if it exists, TODO, we should remove this and settle on one - if attr.name.trim_start_matches("on") == name - && target_path.is_decendant(&this_path) - { - listeners.push(&attr.value); + // Remove the "on" prefix if it exists, TODO, we should remove this and settle on one + if attr.name.trim_start_matches("on") == name + && target_path.is_decendant(&this_path) + { + listeners.push(&attr.value); - // Break if this is the exact target element. - // This means we won't call two listeners with the same name on the same element. This should be - // documented, or be rejected from the rsx! macro outright - if target_path == this_path { - break; - } + // Break if this is the exact target element. + // This means we won't call two listeners with the same name on the same element. This should be + // documented, or be rejected from the rsx! macro outright + if target_path == this_path { + break; } } + } - // Now that we've accumulated all the parent attributes for the target element, call them in reverse order - // We check the bubble state between each call to see if the event has been stopped from bubbling - for listener in listeners.drain(..).rev() { - if let AttributeValue::Listener(listener) = listener { + // Now that we've accumulated all the parent attributes for the target element, call them in reverse order + // We check the bubble state between each call to see if the event has been stopped from bubbling + for listener in listeners.drain(..).rev() { + if let AttributeValue::Listener(listener) = listener { + let origin = el_ref.scope; + self.runtime.scope_stack.borrow_mut().push(origin); + self.runtime.rendering.set(false); + if let Some(cb) = listener.borrow_mut().as_deref_mut() { + cb(uievent.clone()); + } + self.runtime.scope_stack.borrow_mut().pop(); + self.runtime.rendering.set(true); + + if !uievent.propagates.get() { + return; + } + } + } + + parent_path = template + .parent + .get() + .and_then(|id| self.element_refs.get(id.0).cloned()); + } + } else { + // Otherwise, we just call the listener on the target element + if let Some(el_ref) = parent_path { + // safety: we maintain references of all vnodes in the element slab + let template = el_ref.template; + let template = unsafe { template.as_ref() }; + let node_template = template.template.get(); + let target_path = el_ref.path; + + for (idx, attr) in template.dynamic_attrs.iter().enumerate() { + let this_path = node_template.attr_paths[idx]; + + // Remove the "on" prefix if it exists, TODO, we should remove this and settle on one + // Only call the listener if this is the exact target element. + if attr.name.trim_start_matches("on") == name && target_path == this_path { + if let AttributeValue::Listener(listener) = &attr.value { let origin = el_ref.scope; self.runtime.scope_stack.borrow_mut().push(origin); self.runtime.rendering.set(false); @@ -399,44 +445,7 @@ impl VirtualDom { self.runtime.scope_stack.borrow_mut().pop(); self.runtime.rendering.set(true); - if !uievent.propagates.get() { - return; - } - } - } - - parent_path = template.parent.and_then(|id| self.elements.get(id.0)); - } else { - break; - } - } - } else { - // Otherwise, we just call the listener on the target element - if let Some(el_ref) = parent_path { - // safety: we maintain references of all vnodes in the element slab - if let Some(template) = el_ref.template { - let template = unsafe { template.as_ref() }; - let node_template = template.template.get(); - let target_path = el_ref.path; - - for (idx, attr) in template.dynamic_attrs.iter().enumerate() { - let this_path = node_template.attr_paths[idx]; - - // Remove the "on" prefix if it exists, TODO, we should remove this and settle on one - // Only call the listener if this is the exact target element. - if attr.name.trim_start_matches("on") == name && target_path == this_path { - if let AttributeValue::Listener(listener) = &attr.value { - let origin = el_ref.scope; - self.runtime.scope_stack.borrow_mut().push(origin); - self.runtime.rendering.set(false); - if let Some(cb) = listener.borrow_mut().as_deref_mut() { - cb(uievent.clone()); - } - self.runtime.scope_stack.borrow_mut().pop(); - self.runtime.rendering.set(true); - - break; - } + break; } } } @@ -559,7 +568,7 @@ impl VirtualDom { // If an error occurs, we should try to render the default error component and context where the error occured RenderReturn::Aborted(placeholder) => { log::info!("Ran into suspended or aborted scope during rebuild"); - let id = self.next_null(); + let id = self.next_element(); placeholder.id.set(Some(id)); self.mutations.push(Mutation::CreatePlaceholder { id }); } diff --git a/packages/rsx/src/lib.rs b/packages/rsx/src/lib.rs index f52ecad0e..d5e5b2009 100644 --- a/packages/rsx/src/lib.rs +++ b/packages/rsx/src/lib.rs @@ -245,7 +245,7 @@ impl<'a> ToTokens for TemplateRenderer<'a> { attr_paths: &[ #(#attr_paths),* ], }; ::dioxus::core::VNode { - parent: None, + parent: Default::default(), key: #key_tokens, template: std::cell::Cell::new(TEMPLATE), root_ids: dioxus::core::exports::bumpalo::collections::Vec::with_capacity_in(#root_count, __cx.bump()).into(), From 0e5600f2f42d6a11a7851e904721676f2bfbd8fc Mon Sep 17 00:00:00 2001 From: Evan Simkowitz Date: Wed, 23 Aug 2023 12:47:37 -0400 Subject: [PATCH 030/447] add impl for pointer --- packages/html/src/events/mouse.rs | 2 + packages/html/src/events/pointer.rs | 80 +++++++++++++---- packages/html/src/point_interaction.rs | 109 +++++++++++++++++++---- packages/html/src/web_sys_bind/events.rs | 85 ++++++++---------- 4 files changed, 195 insertions(+), 81 deletions(-) diff --git a/packages/html/src/events/mouse.rs b/packages/html/src/events/mouse.rs index 51bca7d48..6f49f70f7 100644 --- a/packages/html/src/events/mouse.rs +++ b/packages/html/src/events/mouse.rs @@ -9,6 +9,8 @@ pub type MouseEvent = Event; #[derive(Clone, Default, PartialEq, Eq)] /// Data associated with a mouse event pub struct MouseData { + /// Common data for all pointer/mouse events + #[cfg_attr(feature = "serialize", serde(flatten))] point_data: PointData, } diff --git a/packages/html/src/events/pointer.rs b/packages/html/src/events/pointer.rs index 4134ac852..0ba2b76b1 100644 --- a/packages/html/src/events/pointer.rs +++ b/packages/html/src/events/pointer.rs @@ -1,22 +1,16 @@ +use std::fmt::{Debug, Formatter}; + use dioxus_core::Event; +use crate::point_interaction::{PointData, PointInteraction}; + pub type PointerEvent = Event; #[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] -#[derive(Debug, Clone, PartialEq)] +#[derive(Clone, PartialEq)] pub struct PointerData { - // Mouse only - pub alt_key: bool, - pub button: i16, - pub buttons: u16, - pub client_x: i32, - pub client_y: i32, - pub ctrl_key: bool, - pub meta_key: bool, - pub page_x: i32, - pub page_y: i32, - pub screen_x: i32, - pub screen_y: i32, - pub shift_key: bool, + /// Common data for all pointer/mouse events + #[cfg_attr(feature = "serialize", serde(flatten))] + point_data: PointData, pub pointer_id: i32, pub width: i32, pub height: i32, @@ -27,7 +21,6 @@ pub struct PointerData { pub twist: i32, pub pointer_type: String, pub is_primary: bool, - // pub get_modifier_state: bool, } impl_event![ @@ -62,3 +55,60 @@ impl_event![ /// pointerout onpointerout ]; + +impl PointInteraction for PointerData { + fn get_point_data(&self) -> PointData { + self.point_data + } +} + +impl PointerData { + pub fn new( + point_data: PointData, + pointer_id: i32, + width: i32, + height: i32, + pressure: f32, + tangential_pressure: f32, + tilt_x: i32, + tilt_y: i32, + twist: i32, + pointer_type: String, + is_primary: bool, + ) -> Self { + Self { + point_data, + pointer_id, + width, + height, + pressure, + tangential_pressure, + tilt_x, + tilt_y, + twist, + pointer_type, + is_primary, + } + } +} + +impl Debug for PointerData { + fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result { + f.debug_struct("PointerData") + .field("coordinates", &self.coordinates()) + .field("modifiers", &self.modifiers()) + .field("held_buttons", &self.held_buttons()) + .field("trigger_button", &self.trigger_button()) + .field("pointer_id", &self.pointer_id) + .field("width", &self.width) + .field("height", &self.height) + .field("pressure", &self.pressure) + .field("tangential_pressure", &self.tangential_pressure) + .field("tilt_x", &self.tilt_x) + .field("tilt_y", &self.tilt_y) + .field("twist", &self.twist) + .field("pointer_type", &self.pointer_type) + .field("is_primary", &self.is_primary) + .finish() + } +} diff --git a/packages/html/src/point_interaction.rs b/packages/html/src/point_interaction.rs index 9692420e8..29ff997d6 100644 --- a/packages/html/src/point_interaction.rs +++ b/packages/html/src/point_interaction.rs @@ -2,23 +2,68 @@ use keyboard_types::Modifiers; use crate::{ geometry::{ClientPoint, Coordinates, ElementPoint, PagePoint, ScreenPoint}, - input_data::{MouseButton, MouseButtonSet}, + input_data::{decode_mouse_button_set, encode_mouse_button_set, MouseButton, MouseButtonSet}, }; #[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] #[derive(Copy, Clone, Default, PartialEq, Eq)] pub struct PointData { - pub trigger_button: MouseButton, + pub alt_key: bool, + + /// The button number that was pressed (if applicable) when the mouse event was fired. + pub button: i16, + + /// Indicates which buttons are pressed on the mouse (or other input device) when a mouse event is triggered. + /// + /// Each button that can be pressed is represented by a given number (see below). If more than one button is pressed, the button values are added together to produce a new number. For example, if the secondary (2) and auxiliary (4) buttons are pressed simultaneously, the value is 6 (i.e., 2 + 4). + /// + /// - 1: Primary button (usually the left button) + /// - 2: Secondary button (usually the right button) + /// - 4: Auxiliary button (usually the mouse wheel button or middle button) + /// - 8: 4th button (typically the "Browser Back" button) + /// - 16 : 5th button (typically the "Browser Forward" button) + pub buttons: u16, + + /// The horizontal coordinate within the application's viewport at which the event occurred (as opposed to the coordinate within the page). + /// + /// For example, clicking on the left edge of the viewport will always result in a mouse event with a clientX value of 0, regardless of whether the page is scrolled horizontally. pub client_x: i32, + + /// The vertical coordinate within the application's viewport at which the event occurred (as opposed to the coordinate within the page). + /// + /// For example, clicking on the top edge of the viewport will always result in a mouse event with a clientY value of 0, regardless of whether the page is scrolled vertically. pub client_y: i32, - pub screen_x: i32, - pub screen_y: i32, - pub element_x: i32, - pub element_y: i32, + + /// True if the control key was down when the mouse event was fired. + pub ctrl_key: bool, + + /// True if the meta key was down when the mouse event was fired. + pub meta_key: bool, + + /// The offset in the X coordinate of the mouse pointer between that event and the padding edge of the target node. + pub offset_x: i32, + + /// The offset in the Y coordinate of the mouse pointer between that event and the padding edge of the target node. + pub offset_y: i32, + + /// The X (horizontal) coordinate (in pixels) of the mouse, relative to the left edge of the entire document. This includes any portion of the document not currently visible. + /// + /// Being based on the edge of the document as it is, this property takes into account any horizontal scrolling of the page. For example, if the page is scrolled such that 200 pixels of the left side of the document are scrolled out of view, and the mouse is clicked 100 pixels inward from the left edge of the view, the value returned by pageX will be 300. pub page_x: i32, + + /// The Y (vertical) coordinate in pixels of the event relative to the whole document. + /// + /// See `page_x`. pub page_y: i32, - pub held_buttons: MouseButtonSet, - pub modifiers: Modifiers, + + /// The X coordinate of the mouse pointer in global (screen) coordinates. + pub screen_x: i32, + + /// The Y coordinate of the mouse pointer in global (screen) coordinates. + pub screen_y: i32, + + /// True if the shift key was down when the mouse event was fired. + pub shift_key: bool, } impl PointData { @@ -28,22 +73,32 @@ impl PointData { held_buttons: MouseButtonSet, modifiers: Modifiers, ) -> Self { + let alt_key = modifiers.contains(Modifiers::ALT); + let ctrl_key = modifiers.contains(Modifiers::CONTROL); + let meta_key = modifiers.contains(Modifiers::META); + let shift_key = modifiers.contains(Modifiers::SHIFT); + let [client_x, client_y]: [i32; 2] = coordinates.client().cast().into(); - let [element_x, element_y]: [i32; 2] = coordinates.element().cast().into(); + let [offset_x, offset_y]: [i32; 2] = coordinates.element().cast().into(); let [page_x, page_y]: [i32; 2] = coordinates.page().cast().into(); let [screen_x, screen_y]: [i32; 2] = coordinates.screen().cast().into(); Self { - trigger_button: trigger_button.map_or(MouseButton::default(), |b| b), + button: trigger_button + .map_or(MouseButton::default(), |b| b) + .into_web_code(), + buttons: encode_mouse_button_set(held_buttons), + meta_key, + ctrl_key, + shift_key, + alt_key, client_x, client_y, screen_x, screen_y, - element_x, - element_y, + offset_x, + offset_y, page_x, page_y, - held_buttons, - modifiers, } } } @@ -56,7 +111,7 @@ pub trait PointInteraction { Coordinates::new( ScreenPoint::new(point_data.screen_x.into(), point_data.screen_y.into()), ClientPoint::new(point_data.client_x.into(), point_data.client_y.into()), - ElementPoint::new(point_data.element_x.into(), point_data.element_y.into()), + ElementPoint::new(point_data.offset_x.into(), point_data.offset_y.into()), PagePoint::new(point_data.page_x.into(), point_data.page_y.into()), ) } @@ -73,7 +128,7 @@ pub trait PointInteraction { fn element_coordinates(&self) -> ElementPoint { let point_data = self.get_point_data(); - ElementPoint::new(point_data.element_x.into(), point_data.element_y.into()) + ElementPoint::new(point_data.offset_x.into(), point_data.offset_y.into()) } fn page_coordinates(&self) -> PagePoint { @@ -82,14 +137,30 @@ pub trait PointInteraction { } fn modifiers(&self) -> Modifiers { - self.get_point_data().modifiers + let mut modifiers = Modifiers::empty(); + let point_data = self.get_point_data(); + + if point_data.alt_key { + modifiers.insert(Modifiers::ALT); + } + if point_data.ctrl_key { + modifiers.insert(Modifiers::CONTROL); + } + if point_data.meta_key { + modifiers.insert(Modifiers::META); + } + if point_data.shift_key { + modifiers.insert(Modifiers::SHIFT); + } + + modifiers } fn held_buttons(&self) -> MouseButtonSet { - self.get_point_data().held_buttons + decode_mouse_button_set(self.get_point_data().buttons) } fn trigger_button(&self) -> MouseButton { - self.get_point_data().trigger_button + MouseButton::from_web_code(self.get_point_data().button) } } diff --git a/packages/html/src/web_sys_bind/events.rs b/packages/html/src/web_sys_bind/events.rs index 4b87fcf41..c1214f870 100644 --- a/packages/html/src/web_sys_bind/events.rs +++ b/packages/html/src/web_sys_bind/events.rs @@ -2,7 +2,7 @@ use crate::events::{ AnimationData, CompositionData, KeyboardData, MouseData, PointerData, TouchData, TransitionData, WheelData, }; -use crate::input_data::{decode_key_location, decode_mouse_button_set, MouseButton}; +use crate::input_data::decode_key_location; use crate::point_interaction::PointData; use crate::{DragData, MountedData}; use keyboard_types::{Code, Key, Modifiers}; @@ -90,33 +90,21 @@ impl From<&KeyboardEvent> for KeyboardData { impl From<&MouseEvent> for MouseData { fn from(e: &MouseEvent) -> Self { - let mut modifiers = Modifiers::empty(); - - if e.alt_key() { - modifiers.insert(Modifiers::ALT); - } - if e.ctrl_key() { - modifiers.insert(Modifiers::CONTROL); - } - if e.meta_key() { - modifiers.insert(Modifiers::META); - } - if e.shift_key() { - modifiers.insert(Modifiers::SHIFT); - } - - MouseData::new(PointData { - trigger_button: MouseButton::from_web_code(e.button()), + Self::new(PointData { + button: e.button(), + buttons: e.buttons(), + meta_key: e.meta_key(), + alt_key: e.alt_key(), + ctrl_key: e.ctrl_key(), + shift_key: e.shift_key(), client_x: e.client_x(), client_y: e.client_y(), screen_x: e.screen_x(), screen_y: e.screen_y(), - element_x: e.offset_x(), - element_y: e.offset_y(), + offset_x: e.offset_x(), + offset_y: e.offset_y(), page_x: e.page_x(), page_y: e.page_y(), - held_buttons: decode_mouse_button_set(e.buttons()), - modifiers, }) } } @@ -142,31 +130,34 @@ impl From<&TouchEvent> for TouchData { impl From<&PointerEvent> for PointerData { fn from(e: &PointerEvent) -> Self { - Self { - alt_key: e.alt_key(), - button: e.button(), - buttons: e.buttons(), - client_x: e.client_x(), - client_y: e.client_y(), - ctrl_key: e.ctrl_key(), - meta_key: e.meta_key(), - page_x: e.page_x(), - page_y: e.page_y(), - screen_x: e.screen_x(), - screen_y: e.screen_y(), - shift_key: e.shift_key(), - pointer_id: e.pointer_id(), - width: e.width(), - height: e.height(), - pressure: e.pressure(), - tangential_pressure: e.tangential_pressure(), - tilt_x: e.tilt_x(), - tilt_y: e.tilt_y(), - twist: e.twist(), - pointer_type: e.pointer_type(), - is_primary: e.is_primary(), - // get_modifier_state: evt.get_modifier_state(), - } + Self::new( + PointData { + button: e.button(), + buttons: e.buttons(), + meta_key: e.meta_key(), + alt_key: e.alt_key(), + ctrl_key: e.ctrl_key(), + shift_key: e.shift_key(), + client_x: e.client_x(), + client_y: e.client_y(), + screen_x: e.screen_x(), + screen_y: e.screen_y(), + offset_x: e.offset_x(), + offset_y: e.offset_y(), + page_x: e.page_x(), + page_y: e.page_y(), + }, + e.pointer_id(), + e.width(), + e.height(), + e.pressure(), + e.tangential_pressure(), + e.tilt_x(), + e.tilt_y(), + e.twist(), + e.pointer_type(), + e.is_primary(), + ) } } From e0f42f8173967e5c40011b8ac93add4e24141a6c Mon Sep 17 00:00:00 2001 From: Evan Simkowitz Date: Wed, 23 Aug 2023 13:31:42 -0400 Subject: [PATCH 031/447] Fix rink --- packages/html/src/events/mouse.rs | 14 +- packages/html/src/events/pointer.rs | 190 ++++++++++++++++------- packages/html/src/lib.rs | 2 +- packages/html/src/point_interaction.rs | 25 ++- packages/html/src/web_sys_bind/events.rs | 24 +-- packages/rink/src/hooks.rs | 21 +-- packages/rink/src/widgets/slider.rs | 4 +- packages/rink/src/widgets/text_like.rs | 4 +- 8 files changed, 187 insertions(+), 97 deletions(-) diff --git a/packages/html/src/events/mouse.rs b/packages/html/src/events/mouse.rs index 6f49f70f7..74b7bdfb9 100644 --- a/packages/html/src/events/mouse.rs +++ b/packages/html/src/events/mouse.rs @@ -1,12 +1,11 @@ use crate::point_interaction::{PointData, PointInteraction}; use dioxus_core::Event; -use std::fmt::{Debug, Formatter}; pub type MouseEvent = Event; /// A synthetic event that wraps a web-style [`MouseEvent`](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent) #[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] -#[derive(Clone, Default, PartialEq, Eq)] +#[derive(Debug, Clone, Default, PartialEq, Eq)] /// Data associated with a mouse event pub struct MouseData { /// Common data for all pointer/mouse events @@ -89,14 +88,3 @@ impl PointInteraction for MouseData { self.point_data } } - -impl Debug for MouseData { - fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result { - f.debug_struct("MouseData") - .field("coordinates", &self.coordinates()) - .field("modifiers", &self.modifiers()) - .field("held_buttons", &self.held_buttons()) - .field("trigger_button", &self.trigger_button()) - .finish() - } -} diff --git a/packages/html/src/events/pointer.rs b/packages/html/src/events/pointer.rs index 0ba2b76b1..62e65bf76 100644 --- a/packages/html/src/events/pointer.rs +++ b/packages/html/src/events/pointer.rs @@ -1,16 +1,16 @@ -use std::fmt::{Debug, Formatter}; +use std::fmt::Debug; use dioxus_core::Event; use crate::point_interaction::{PointData, PointInteraction}; +/// A synthetic event that wraps a web-style [`PointerEvent`](https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent) pub type PointerEvent = Event; + +/// Data associated with a pointer event, aside from the data shared with mouse events #[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] -#[derive(Clone, PartialEq)] -pub struct PointerData { - /// Common data for all pointer/mouse events - #[cfg_attr(feature = "serialize", serde(flatten))] - point_data: PointData, +#[derive(Debug, Clone, PartialEq)] +pub struct PointerEventData { pub pointer_id: i32, pub width: i32, pub height: i32, @@ -23,6 +23,54 @@ pub struct PointerData { pub is_primary: bool, } +#[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] +#[derive(Debug, Clone, PartialEq)] +pub struct PointerData { + /// Common data for all pointer/mouse events + #[cfg_attr(feature = "serialize", serde(flatten))] + point_data: PointData, + + /// The unique identifier of the pointer causing the event. + #[deprecated(since = "0.5.0", note = "use pointer_id() instead")] + pub pointer_id: i32, + + /// The width (magnitude on the X axis), in CSS pixels, of the contact geometry of the pointer. + #[deprecated(since = "0.5.0", note = "use width() instead")] + pub width: i32, + + /// The height (magnitude on the Y axis), in CSS pixels, of the contact geometry of the pointer. + #[deprecated(since = "0.5.0", note = "use height() instead")] + pub height: i32, + + /// The normalized pressure of the pointer input in the range of 0 to 1, + #[deprecated(since = "0.5.0", note = "use pressure() instead")] + pub pressure: f32, + + /// The normalized tangential pressure of the pointer input (also known as barrel pressure or cylinder stress) in the range -1 to 1, + #[deprecated(since = "0.5.0", note = "use tangential_pressure() instead")] + pub tangential_pressure: f32, + + /// The plane angle (in degrees, in the range of -90 to 90) between the Y-Z plane and the plane containing both the transducer (e.g. pen stylus) axis and the Y axis. + #[deprecated(since = "0.5.0", note = "use tilt_x() instead")] + pub tilt_x: i32, + + /// The plane angle (in degrees, in the range of -90 to 90) between the X-Z plane and the plane containing both the transducer (e.g. pen stylus) axis and the X axis. + #[deprecated(since = "0.5.0", note = "use tilt_y() instead")] + pub tilt_y: i32, + + /// The clockwise rotation of the pointer (e.g. pen stylus) around its major axis in degrees, with a value in the range 0 to 359.The clockwise rotation of the pointer (e.g. pen stylus) around its major axis in degrees, with a value in the range 0 to 359. + #[deprecated(since = "0.5.0", note = "use twist() instead")] + pub twist: i32, + + /// Indicates the device type that caused the event (mouse, pen, touch, etc.). + #[deprecated(since = "0.5.0", note = "use pointer_type() instead")] + pub pointer_type: String, + + /// Indicates if the pointer represents the primary pointer of this pointer type. + #[deprecated(since = "0.5.0", note = "use is_primary() instead")] + pub is_primary: bool, +} + impl_event![ PointerData; /// pointerdown @@ -56,59 +104,87 @@ impl_event![ onpointerout ]; +impl PointerData { + pub fn new(point_data: PointData, pointer_event_data: PointerEventData) -> Self { + #[allow(deprecated)] + Self { + point_data, + pointer_id: pointer_event_data.pointer_id, + width: pointer_event_data.width, + height: pointer_event_data.height, + pressure: pointer_event_data.pressure, + tangential_pressure: pointer_event_data.tangential_pressure, + tilt_x: pointer_event_data.tilt_x, + tilt_y: pointer_event_data.tilt_y, + twist: pointer_event_data.twist, + pointer_type: pointer_event_data.pointer_type, + is_primary: pointer_event_data.is_primary, + } + } + + /// Gets the unique identifier of the pointer causing the event. + pub fn pointer_id(&self) -> i32 { + #[allow(deprecated)] + self.pointer_id + } + + /// Gets the width (magnitude on the X axis), in CSS pixels, of the contact geometry of the pointer. + pub fn width(&self) -> i32 { + #[allow(deprecated)] + self.width + } + + /// Gets the height (magnitude on the Y axis), in CSS pixels, of the contact geometry of the pointer. + pub fn height(&self) -> i32 { + #[allow(deprecated)] + self.height + } + + /// Gets the normalized pressure of the pointer input in the range of 0 to 1, + pub fn pressure(&self) -> f32 { + #[allow(deprecated)] + self.pressure + } + + /// Gets the normalized tangential pressure of the pointer input (also known as barrel pressure or cylinder stress) in the range -1 to 1, + pub fn tangential_pressure(&self) -> f32 { + #[allow(deprecated)] + self.tangential_pressure + } + + /// Gets the plane angle (in degrees, in the range of -90 to 90) between the Y-Z plane and the plane containing both the transducer (e.g. pen stylus) axis and the Y axis. + pub fn tilt_x(&self) -> i32 { + #[allow(deprecated)] + self.tilt_x + } + + /// Gets the plane angle (in degrees, in the range of -90 to 90) between the X-Z plane and the plane containing both the transducer (e.g. pen stylus) axis and the X axis. + pub fn tilt_y(&self) -> i32 { + #[allow(deprecated)] + self.tilt_y + } + + /// Gets the clockwise rotation of the pointer (e.g. pen stylus) around its major axis in degrees, with a value in the range 0 to 359.The clockwise rotation of the pointer (e.g. pen stylus) around its major axis in degrees, with a value in the range 0 to 359. + pub fn twist(&self) -> i32 { + #[allow(deprecated)] + self.twist + } + + /// Gets the device type that caused the event (mouse, pen, touch, etc.). + pub fn pointer_type(&self) -> &str { + #[allow(deprecated)] + self.pointer_type.as_str() + } + + /// Gets if the pointer represents the primary pointer of this pointer type. + pub fn is_primary(&self) -> bool { + #[allow(deprecated)] + self.is_primary + } +} + impl PointInteraction for PointerData { fn get_point_data(&self) -> PointData { self.point_data } } - -impl PointerData { - pub fn new( - point_data: PointData, - pointer_id: i32, - width: i32, - height: i32, - pressure: f32, - tangential_pressure: f32, - tilt_x: i32, - tilt_y: i32, - twist: i32, - pointer_type: String, - is_primary: bool, - ) -> Self { - Self { - point_data, - pointer_id, - width, - height, - pressure, - tangential_pressure, - tilt_x, - tilt_y, - twist, - pointer_type, - is_primary, - } - } -} - -impl Debug for PointerData { - fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result { - f.debug_struct("PointerData") - .field("coordinates", &self.coordinates()) - .field("modifiers", &self.modifiers()) - .field("held_buttons", &self.held_buttons()) - .field("trigger_button", &self.trigger_button()) - .field("pointer_id", &self.pointer_id) - .field("width", &self.width) - .field("height", &self.height) - .field("pressure", &self.pressure) - .field("tangential_pressure", &self.tangential_pressure) - .field("tilt_x", &self.tilt_x) - .field("tilt_y", &self.tilt_y) - .field("twist", &self.twist) - .field("pointer_type", &self.pointer_type) - .field("is_primary", &self.is_primary) - .finish() - } -} diff --git a/packages/html/src/lib.rs b/packages/html/src/lib.rs index d555d798a..5866ed28a 100644 --- a/packages/html/src/lib.rs +++ b/packages/html/src/lib.rs @@ -22,7 +22,7 @@ mod global_attributes; pub mod input_data; #[cfg(feature = "native-bind")] pub mod native_bind; -mod point_interaction; +pub mod point_interaction; mod render_template; #[cfg(feature = "wasm-bind")] mod web_sys_bind; diff --git a/packages/html/src/point_interaction.rs b/packages/html/src/point_interaction.rs index 29ff997d6..f25a198cc 100644 --- a/packages/html/src/point_interaction.rs +++ b/packages/html/src/point_interaction.rs @@ -1,3 +1,5 @@ +use std::fmt::{Debug, Formatter}; + use keyboard_types::Modifiers; use crate::{ @@ -69,8 +71,8 @@ pub struct PointData { impl PointData { pub fn new( trigger_button: Option, - coordinates: Coordinates, held_buttons: MouseButtonSet, + coordinates: Coordinates, modifiers: Modifiers, ) -> Self { let alt_key = modifiers.contains(Modifiers::ALT); @@ -103,6 +105,23 @@ impl PointData { } } +impl Debug for PointData { + fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result { + f.debug_struct("PointInteraction") + .field("coordinates", &self.coordinates()) + .field("modifiers", &self.modifiers()) + .field("held_buttons", &self.held_buttons()) + .field("trigger_button", &self.trigger_button()) + .finish() + } +} + +impl PointInteraction for PointData { + fn get_point_data(&self) -> PointData { + *self + } +} + pub trait PointInteraction { fn get_point_data(&self) -> PointData; @@ -160,7 +179,7 @@ pub trait PointInteraction { decode_mouse_button_set(self.get_point_data().buttons) } - fn trigger_button(&self) -> MouseButton { - MouseButton::from_web_code(self.get_point_data().button) + fn trigger_button(&self) -> Option { + Some(MouseButton::from_web_code(self.get_point_data().button)) } } diff --git a/packages/html/src/web_sys_bind/events.rs b/packages/html/src/web_sys_bind/events.rs index c1214f870..f175e98e2 100644 --- a/packages/html/src/web_sys_bind/events.rs +++ b/packages/html/src/web_sys_bind/events.rs @@ -4,7 +4,7 @@ use crate::events::{ }; use crate::input_data::decode_key_location; use crate::point_interaction::PointData; -use crate::{DragData, MountedData}; +use crate::{DragData, MountedData, PointerEventData}; use keyboard_types::{Code, Key, Modifiers}; use std::convert::TryInto; use std::str::FromStr; @@ -147,16 +147,18 @@ impl From<&PointerEvent> for PointerData { page_x: e.page_x(), page_y: e.page_y(), }, - e.pointer_id(), - e.width(), - e.height(), - e.pressure(), - e.tangential_pressure(), - e.tilt_x(), - e.tilt_y(), - e.twist(), - e.pointer_type(), - e.is_primary(), + PointerEventData { + pointer_id: e.pointer_id(), + width: e.width(), + height: e.height(), + pressure: e.pressure(), + tangential_pressure: e.tangential_pressure(), + tilt_x: e.tilt_x(), + tilt_y: e.tilt_y(), + twist: e.twist(), + pointer_type: e.pointer_type(), + is_primary: e.is_primary(), + }, ) } } diff --git a/packages/rink/src/hooks.rs b/packages/rink/src/hooks.rs index f8c4500d2..7e85f0e2d 100644 --- a/packages/rink/src/hooks.rs +++ b/packages/rink/src/hooks.rs @@ -13,6 +13,7 @@ use dioxus_html::geometry::{ use dioxus_html::input_data::keyboard_types::{Code, Key, Location, Modifiers}; use dioxus_html::input_data::MouseButtonSet as DioxusMouseButtons; use dioxus_html::input_data::{MouseButton as DioxusMouseButton, MouseButtonSet}; +use dioxus_html::point_interaction::{PointData, PointInteraction}; use dioxus_html::{event_bubbles, FocusData, KeyboardData, MouseData, WheelData}; use std::any::Any; use std::collections::HashMap; @@ -133,12 +134,12 @@ impl InnerInputState { _ => {} } - let new_mouse_data = MouseData::new( - m.coordinates(), + let new_mouse_data = MouseData::new(PointData::new( m.trigger_button(), held_buttons, + m.coordinates(), m.modifiers(), - ); + )); self.mouse = Some(new_mouse_data.clone()); *m = new_mouse_data; @@ -291,12 +292,12 @@ impl InnerInputState { mouse_data.page_coordinates(), ); - MouseData::new( - coordinates, + MouseData::new(PointData::new( mouse_data.trigger_button(), mouse_data.held_buttons(), + coordinates, mouse_data.modifiers(), - ) + )) } if let Some(mouse_data) = &self.mouse { @@ -715,12 +716,12 @@ fn get_event(evt: TermEvent) -> Option<(&'static str, EventData)> { } // held mouse buttons get set later by maintaining state, as crossterm does not provide them - EventData::Mouse(MouseData::new( - coordinates, + EventData::Mouse(MouseData::new(PointData::new( button, - DioxusMouseButtons::empty(), + MouseButtonSet::empty(), + coordinates, modifiers, - )) + ))) }; let get_wheel_data = |up| { diff --git a/packages/rink/src/widgets/slider.rs b/packages/rink/src/widgets/slider.rs index 7080b6c12..5b24e180d 100644 --- a/packages/rink/src/widgets/slider.rs +++ b/packages/rink/src/widgets/slider.rs @@ -1,6 +1,8 @@ use std::collections::HashMap; -use dioxus_html::{input_data::keyboard_types::Key, KeyboardData, MouseData}; +use dioxus_html::{ + input_data::keyboard_types::Key, point_interaction::PointInteraction, KeyboardData, MouseData, +}; use dioxus_native_core::{ custom_element::CustomElement, node::{OwnedAttributeDiscription, OwnedAttributeValue}, diff --git a/packages/rink/src/widgets/text_like.rs b/packages/rink/src/widgets/text_like.rs index 6521073d0..1f96cfa61 100644 --- a/packages/rink/src/widgets/text_like.rs +++ b/packages/rink/src/widgets/text_like.rs @@ -1,7 +1,9 @@ use std::{collections::HashMap, io::stdout}; use crossterm::{cursor::MoveTo, execute}; -use dioxus_html::{input_data::keyboard_types::Key, KeyboardData, MouseData}; +use dioxus_html::{ + input_data::keyboard_types::Key, point_interaction::PointInteraction, KeyboardData, MouseData, +}; use dioxus_native_core::{ custom_element::CustomElement, node::OwnedAttributeDiscription, From dc4707ee2acf5d4a8469440958e0bf9d0014a1c9 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Wed, 23 Aug 2023 13:01:37 -0500 Subject: [PATCH 032/447] WIP fix event bubbling --- packages/core/src/arena.rs | 39 +++------- packages/core/src/create.rs | 44 ++++++++--- packages/core/src/diff.rs | 99 ++++++++++++------------ packages/core/src/virtual_dom.rs | 6 +- packages/core/tests/event_propagation.rs | 64 +++++++++++++++ packages/core/tests/fuzzing.rs | 3 +- 6 files changed, 161 insertions(+), 94 deletions(-) create mode 100644 packages/core/tests/event_propagation.rs diff --git a/packages/core/src/arena.rs b/packages/core/src/arena.rs index c41454b50..53695d9d7 100644 --- a/packages/core/src/arena.rs +++ b/packages/core/src/arena.rs @@ -1,5 +1,3 @@ -use std::ptr::NonNull; - use crate::{ innerlude::DirtyScope, nodes::RenderReturn, nodes::VNode, virtual_dom::VirtualDom, AttributeValue, DynamicNode, ScopeId, @@ -21,13 +19,13 @@ pub struct ElementId(pub usize); #[derive(Clone, Copy, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Default)] pub struct BubbleId(pub usize); -#[derive(Debug, Clone)] -pub struct ElementRef { +#[derive(Debug, Clone, Copy)] +pub struct ElementRef<'a> { // the pathway of the real element inside the template pub(crate) path: ElementPath, // The actual template - pub(crate) template: NonNull>, + pub(crate) template: &'a VNode<'a>, // The scope the element belongs to pub(crate) scope: ScopeId, @@ -35,7 +33,7 @@ pub struct ElementRef { #[derive(Clone, Copy, Debug)] pub struct ElementPath { - path: &'static [u8], + pub(crate) path: &'static [u8], } impl VirtualDom { @@ -43,22 +41,11 @@ impl VirtualDom { ElementId(self.elements.insert(None)) } - pub(crate) fn next_element_ref(&mut self, template: &VNode, path: &'static [u8]) -> BubbleId { - self.next_reference(template, ElementPath { path }) - } - - fn next_reference(&mut self, template: &VNode, path: ElementPath) -> BubbleId { - let entry = self.element_refs.vacant_entry(); - let id = entry.key(); - let scope = self.runtime.current_scope_id().unwrap_or(ScopeId(0)); - - entry.insert(ElementRef { - // We know this is non-null because it comes from a reference - template: unsafe { NonNull::new_unchecked(template as *const _ as *mut _) }, - path, - scope, - }); - BubbleId(id) + pub(crate) fn next_element_ref(&mut self, element_ref: ElementRef) -> BubbleId { + BubbleId( + self.element_refs + .insert(unsafe { std::mem::transmute(element_ref) }), + ) } pub(crate) fn reclaim(&mut self, el: ElementId) { @@ -77,15 +64,13 @@ impl VirtualDom { self.elements.try_remove(el.0).map(|_| ()) } - pub(crate) fn set_template(&mut self, el: ElementId, node: &VNode, path: &'static [u8]) { + pub(crate) fn set_template(&mut self, el: ElementId, element_ref: ElementRef) { match self.elements[el.0] { Some(bubble_id) => { - self.element_refs[bubble_id.0].path = ElementPath { path }; - self.element_refs[bubble_id.0].template = - unsafe { NonNull::new_unchecked(node as *const _ as *mut _) }; + self.element_refs[bubble_id.0] = unsafe { std::mem::transmute(element_ref) }; } None => { - self.elements[el.0] = Some(self.next_reference(node, ElementPath { path })); + self.elements[el.0] = Some(self.next_element_ref(element_ref)); } } } diff --git a/packages/core/src/create.rs b/packages/core/src/create.rs index f8ae3add3..e89942f36 100644 --- a/packages/core/src/create.rs +++ b/packages/core/src/create.rs @@ -1,6 +1,7 @@ use crate::any_props::AnyProps; -use crate::diff::BoundaryRef; -use crate::innerlude::{BorrowedAttributeValue, VComponent, VPlaceholder, VText}; +use crate::innerlude::{ + BorrowedAttributeValue, ElementPath, ElementRef, VComponent, VPlaceholder, VText, +}; use crate::mutations::Mutation; use crate::mutations::Mutation::*; use crate::nodes::VNode; @@ -182,7 +183,14 @@ impl<'b> VirtualDom { use DynamicNode::*; match &template.dynamic_nodes[idx] { node @ Component { .. } | node @ Fragment(_) => { - self.create_dynamic_node(template, idx, node, idx) + let template_ref = ElementRef { + path: ElementPath { + path: &template.template.get().node_paths[idx], + }, + template: &template, + scope: self.runtime.current_scope_id().unwrap_or(ScopeId(0)), + }; + self.create_dynamic_node(template_ref, node) } Placeholder(VPlaceholder { id }) => { let id = self.set_slot(id); @@ -266,7 +274,14 @@ impl<'b> VirtualDom { .map(|sorted_index| dynamic_nodes[sorted_index].0); for idx in reversed_iter { - let m = self.create_dynamic_node(template, idx, &template.dynamic_nodes[idx], idx); + let boundary_ref = ElementRef { + path: ElementPath { + path: &template.template.get().node_paths[idx], + }, + template, + scope: self.runtime.current_scope_id().unwrap_or(ScopeId(0)), + }; + let m = self.create_dynamic_node(boundary_ref, &template.dynamic_nodes[idx]); if m > 0 { // The path is one shorter because the top node is the root let path = &template.template.get().node_paths[idx][1..]; @@ -315,7 +330,12 @@ impl<'b> VirtualDom { match &attribute.value { AttributeValue::Listener(_) => { let path = &template.template.get().attr_paths[idx]; - self.set_template(id, template, path); + let element_ref = ElementRef { + path: ElementPath { path }, + template, + scope: self.runtime.current_scope_id().unwrap_or(ScopeId(0)), + }; + self.set_template(id, element_ref); self.mutations.push(NewEventListener { // all listeners start with "on" name: &unbounded_name[2..], @@ -446,19 +466,19 @@ impl<'b> VirtualDom { pub(crate) fn create_dynamic_node( &mut self, - parent: BoundaryRef<'b>, + parent: ElementRef<'b>, node: &'b DynamicNode<'b>, ) -> usize { use DynamicNode::*; match node { Text(text) => self.create_dynamic_text(parent, text), Placeholder(place) => self.create_placeholder(place, parent), - Component(component) => self.create_component_node(parent, component), + Component(component) => self.create_component_node(Some(parent), component), Fragment(frag) => frag.iter().map(|child| self.create(child)).sum(), } } - fn create_dynamic_text(&mut self, parent: BoundaryRef<'b>, text: &'b VText<'b>) -> usize { + fn create_dynamic_text(&mut self, parent: ElementRef<'b>, text: &'b VText<'b>) -> usize { // Allocate a dynamic element reference for this text node let new_id = self.next_element(); @@ -471,7 +491,7 @@ impl<'b> VirtualDom { // Add the mutation to the list self.mutations.push(HydrateText { id: new_id, - path: &parent.parent.template.get().node_paths[parent.dyn_node_idx][1..], + path: &parent.path.path[1..], value, }); @@ -482,7 +502,7 @@ impl<'b> VirtualDom { pub(crate) fn create_placeholder( &mut self, placeholder: &VPlaceholder, - parent: BoundaryRef<'b>, + parent: ElementRef<'b>, ) -> usize { // Allocate a dynamic element reference for this text node let id = self.next_element(); @@ -492,7 +512,7 @@ impl<'b> VirtualDom { // Assign the ID to the existing node in the template self.mutations.push(AssignId { - path: &parent.parent.template.get().node_paths[parent.dyn_node_idx][1..], + path: &parent.path.path[1..], id, }); @@ -502,7 +522,7 @@ impl<'b> VirtualDom { pub(super) fn create_component_node( &mut self, - parent: BoundaryRef<'b>, + parent: Option>, component: &'b VComponent<'b>, ) -> usize { use RenderReturn::*; diff --git a/packages/core/src/diff.rs b/packages/core/src/diff.rs index 80ccbc315..29a135be6 100644 --- a/packages/core/src/diff.rs +++ b/packages/core/src/diff.rs @@ -1,7 +1,10 @@ use crate::{ any_props::AnyProps, arena::ElementId, - innerlude::{BorrowedAttributeValue, DirtyScope, VComponent, VPlaceholder, VText}, + innerlude::{ + BorrowedAttributeValue, DirtyScope, ElementPath, ElementRef, VComponent, VPlaceholder, + VText, + }, mutations::Mutation, nodes::RenderReturn, nodes::{DynamicNode, VNode}, @@ -81,7 +84,10 @@ impl<'b> VirtualDom { if let Some(&template) = map.get(&byte_index) { right_template.template.set(template); if template != left_template.template.get() { - return self.replace(left_template, [right_template], todo!()); + let parent = left_template.parent.take().map(|parent_id| unsafe { + std::mem::transmute(self.element_refs[parent_id.0]) + }); + return self.replace(left_template, [right_template], parent); } } } @@ -99,7 +105,7 @@ impl<'b> VirtualDom { // If the templates are different by name, we need to replace the entire template if templates_are_different(left_template, right_template) { - return self.light_diff_templates(left_template, right_template, todo!()); + return self.light_diff_templates(left_template, right_template); } // If the templates are the same, we can diff the attributes and children @@ -129,9 +135,12 @@ impl<'b> VirtualDom { .zip(right_template.dynamic_nodes.iter()) .enumerate() .for_each(|(dyn_node_idx, (left_node, right_node))| { - let current_ref = BoundaryRef { - parent: right_template, - dyn_node_idx, + let current_ref = ElementRef { + template: right_template.into(), + path: ElementPath { + path: left_template.template.get().node_paths[dyn_node_idx], + }, + scope: self.runtime.scope_stack.borrow().last().copied().unwrap(), }; self.diff_dynamic_node(left_node, right_node, current_ref); }); @@ -150,13 +159,13 @@ impl<'b> VirtualDom { &mut self, left_node: &'b DynamicNode<'b>, right_node: &'b DynamicNode<'b>, - parent: BoundaryRef<'b>, + parent: ElementRef<'b>, ) { match (left_node, right_node) { (Text(left), Text(right)) => self.diff_vtext(left, right), (Fragment(left), Fragment(right)) => self.diff_non_empty_fragment(left, right, parent), (Placeholder(left), Placeholder(right)) => right.id.set(left.id.get()), - (Component(left), Component(right)) => self.diff_vcomponent(left, right, parent), + (Component(left), Component(right)) => self.diff_vcomponent(left, right, Some(parent)), (Placeholder(left), Fragment(right)) => self.replace_placeholder(left, *right, parent), (Fragment(left), Placeholder(right)) => self.node_to_placeholder(left, right), _ => todo!("This is an usual custom case for dynamic nodes. We don't know how to handle it yet."), @@ -179,7 +188,7 @@ impl<'b> VirtualDom { &mut self, left: &'b VComponent<'b>, right: &'b VComponent<'b>, - parent: BoundaryRef<'b>, + parent: Option>, ) { if std::ptr::eq(left, right) { return; @@ -224,7 +233,7 @@ impl<'b> VirtualDom { &mut self, right: &'b VComponent<'b>, left: &'b VComponent<'b>, - parent: BoundaryRef<'b>, + parent: Option>, ) { let m = self.create_component_node(parent, right); @@ -280,17 +289,16 @@ impl<'b> VirtualDom { /// Component { ..props } /// } /// ``` - fn light_diff_templates( - &mut self, - left: &'b VNode<'b>, - right: &'b VNode<'b>, - parent: BoundaryRef<'b>, - ) { + fn light_diff_templates(&mut self, left: &'b VNode<'b>, right: &'b VNode<'b>) { + let parent = left + .parent + .take() + .map(|parent_id| unsafe { std::mem::transmute(self.element_refs[parent_id.0]) }); match matching_components(left, right) { None => self.replace(left, [right], parent), Some(components) => components .into_iter() - .for_each(|(idx, l, r)| self.diff_vcomponent(l, r, parent)), + .for_each(|(l, r)| self.diff_vcomponent(l, r, parent)), } } @@ -312,7 +320,7 @@ impl<'b> VirtualDom { &mut self, old: &'b [VNode<'b>], new: &'b [VNode<'b>], - parent: BoundaryRef<'b>, + parent: ElementRef<'b>, ) { let new_is_keyed = new[0].key.is_some(); let old_is_keyed = old[0].key.is_some(); @@ -344,7 +352,7 @@ impl<'b> VirtualDom { &mut self, old: &'b [VNode<'b>], new: &'b [VNode<'b>], - parent: BoundaryRef<'b>, + parent: ElementRef<'b>, ) { use std::cmp::Ordering; @@ -385,7 +393,7 @@ impl<'b> VirtualDom { &mut self, old: &'b [VNode<'b>], new: &'b [VNode<'b>], - parent: BoundaryRef<'b>, + parent: ElementRef<'b>, ) { if cfg!(debug_assertions) { let mut keys = rustc_hash::FxHashSet::default(); @@ -464,7 +472,7 @@ impl<'b> VirtualDom { &mut self, old: &'b [VNode<'b>], new: &'b [VNode<'b>], - parent: BoundaryRef<'b>, + parent: ElementRef<'b>, ) -> Option<(usize, usize)> { let mut left_offset = 0; @@ -523,7 +531,7 @@ impl<'b> VirtualDom { &mut self, old: &'b [VNode<'b>], new: &'b [VNode<'b>], - parent: BoundaryRef<'b>, + parent: ElementRef<'b>, ) { /* 1. Map the old keys into a numerical ordering based on indices. @@ -581,7 +589,7 @@ impl<'b> VirtualDom { if shared_keys.is_empty() { if old.get(0).is_some() { self.remove_nodes(&old[1..]); - self.replace(&old[0], new, parent); + self.replace(&old[0], new, Some(parent)); } else { // I think this is wrong - why are we appending? // only valid of the if there are no trailing elements @@ -762,7 +770,7 @@ impl<'b> VirtualDom { fn create_children( &mut self, nodes: impl IntoIterator>, - parent: BoundaryRef<'b>, + parent: Option>, ) -> usize { nodes.into_iter().fold(0, |acc, child| { self.assign_boundary_ref(parent, child); @@ -774,9 +782,9 @@ impl<'b> VirtualDom { &mut self, new: &'b [VNode<'b>], before: &'b VNode<'b>, - parent: BoundaryRef<'b>, + parent: ElementRef<'b>, ) { - let m = self.create_children(new, parent); + let m = self.create_children(new, Some(parent)); let id = self.find_first_element(before); self.mutations.push(Mutation::InsertBefore { id, m }) } @@ -785,9 +793,9 @@ impl<'b> VirtualDom { &mut self, new: &'b [VNode<'b>], after: &'b VNode<'b>, - parent: BoundaryRef<'b>, + parent: ElementRef<'b>, ) { - let m = self.create_children(new, parent); + let m = self.create_children(new, Some(parent)); let id = self.find_last_element(after); self.mutations.push(Mutation::InsertAfter { id, m }) } @@ -797,9 +805,9 @@ impl<'b> VirtualDom { &mut self, l: &'b VPlaceholder, r: impl IntoIterator>, - parent: BoundaryRef<'b>, + parent: ElementRef<'b>, ) { - let m = self.create_children(r, parent); + let m = self.create_children(r, Some(parent)); let id = l.id.get().unwrap(); self.mutations.push(Mutation::ReplaceWith { id, m }); self.reclaim(id); @@ -809,7 +817,7 @@ impl<'b> VirtualDom { &mut self, left: &'b VNode<'b>, right: impl IntoIterator>, - parent: BoundaryRef<'b>, + parent: Option>, ) { let m = self.create_children(right, parent); @@ -1031,13 +1039,15 @@ impl<'b> VirtualDom { } } - pub(crate) fn assign_boundary_ref(&mut self, parent: BoundaryRef, child: &VNode<'_>) { - // assign the parent - let path = parent.parent.template.get().node_paths[parent.dyn_node_idx]; - - child - .parent - .set(Some(self.next_element_ref(parent.parent, path))); + pub(crate) fn assign_boundary_ref( + &mut self, + parent: Option>, + child: &'b VNode<'b>, + ) { + if let Some(parent) = parent { + // assign the parent of the child + child.parent.set(Some(self.next_element_ref(parent))); + } } } @@ -1060,7 +1070,7 @@ fn templates_are_different(left_template: &VNode, right_template: &VNode) -> boo fn matching_components<'a>( left: &'a VNode<'a>, right: &'a VNode<'a>, -) -> Option, &'a VComponent<'a>)>> { +) -> Option, &'a VComponent<'a>)>> { let left_template = left.template.get(); let right_template = right.template.get(); if left_template.roots.len() != right_template.roots.len() { @@ -1072,8 +1082,7 @@ fn matching_components<'a>( .roots .iter() .zip(right_template.roots.iter()) - .enumerate() - .map(|(idx, (l, r))| { + .map(|(l, r)| { let (l, r) = match (l, r) { (TemplateNode::Dynamic { id: l }, TemplateNode::Dynamic { id: r }) => (l, r), _ => return None, @@ -1084,7 +1093,7 @@ fn matching_components<'a>( _ => return None, }; - Some((idx, l, r)) + Some((l, r)) }) .collect() } @@ -1116,9 +1125,3 @@ fn is_dyn_node_only_child(node: &VNode, idx: usize) -> bool { _ => false, } } - -// A parent that can be used for bubbling -pub(crate) struct BoundaryRef<'b> { - pub parent: &'b VNode<'b>, - pub dyn_node_idx: usize, -} diff --git a/packages/core/src/virtual_dom.rs b/packages/core/src/virtual_dom.rs index faf1ecf44..48287a7b7 100644 --- a/packages/core/src/virtual_dom.rs +++ b/packages/core/src/virtual_dom.rs @@ -183,7 +183,7 @@ pub struct VirtualDom { pub(crate) templates: FxHashMap>>, // Every element is actually a dual reference - one to the template and the other to the dynamic node in that template - pub(crate) element_refs: Slab, + pub(crate) element_refs: Slab>, // The element ids that are used in the renderer pub(crate) elements: Slab>, @@ -353,13 +353,11 @@ impl VirtualDom { | | | <-- no, broke early | <-- no, broke early */ - println!("calling {:?}", element); let element = match self.elements.get(element.0) { Some(Some(el)) => el, _ => return, }; let mut parent_path = self.element_refs.get(element.0).cloned(); - println!("parent path {:?}", parent_path); let mut listeners = vec![]; // We will clone this later. The data itself is wrapped in RC to be used in callbacks if required @@ -374,7 +372,6 @@ impl VirtualDom { while let Some(el_ref) = parent_path { // safety: we maintain references of all vnodes in the element slab let template = el_ref.template; - let template = unsafe { template.as_ref() }; let node_template = template.template.get(); let target_path = el_ref.path; @@ -425,7 +422,6 @@ impl VirtualDom { if let Some(el_ref) = parent_path { // safety: we maintain references of all vnodes in the element slab let template = el_ref.template; - let template = unsafe { template.as_ref() }; let node_template = template.template.get(); let target_path = el_ref.path; diff --git a/packages/core/tests/event_propagation.rs b/packages/core/tests/event_propagation.rs new file mode 100644 index 000000000..1fbf82c4a --- /dev/null +++ b/packages/core/tests/event_propagation.rs @@ -0,0 +1,64 @@ +use dioxus::prelude::*; +use dioxus_core::ElementId; +use std::{rc::Rc, sync::Mutex}; + +static CLICKS: Mutex = Mutex::new(0); + +#[test] +fn events_propagate() { + let mut dom = VirtualDom::new(app); + _ = dom.rebuild(); + + // Top-level click is registered + dom.handle_event("click", Rc::new(MouseData::default()), ElementId(1), true); + assert_eq!(*CLICKS.lock().unwrap(), 1); + + // break reference.... + for _ in 0..5 { + dom.mark_dirty(ScopeId(0)); + _ = dom.rebuild(); + } + + // Lower click is registered + dom.handle_event("click", Rc::new(MouseData::default()), ElementId(2), true); + assert_eq!(*CLICKS.lock().unwrap(), 3); + + // break reference.... + for _ in 0..5 { + dom.mark_dirty(ScopeId(0)); + _ = dom.rebuild(); + } + + // Stop propagation occurs + dom.handle_event("click", Rc::new(MouseData::default()), ElementId(2), true); + assert_eq!(*CLICKS.lock().unwrap(), 3); +} + +fn app(cx: Scope) -> Element { + render! { + div { + onclick: move |_| { + println!("top clicked"); + *CLICKS.lock().unwrap() += 1; + }, + + problematic_child {} + } + } +} + +fn problematic_child(cx: Scope) -> Element { + render! { + button { + onclick: move |evt| { + let mut clicks = CLICKS.lock().unwrap(); + + if *clicks == 3 { + evt.stop_propagation(); + } else { + *clicks += 1; + } + } + } + } +} diff --git a/packages/core/tests/fuzzing.rs b/packages/core/tests/fuzzing.rs index 1523c4e22..95c3ed9bf 100644 --- a/packages/core/tests/fuzzing.rs +++ b/packages/core/tests/fuzzing.rs @@ -271,10 +271,9 @@ fn create_random_element(cx: Scope) -> Element { ) .into_boxed_str(), )); - // println!("{template:#?}"); let node = VNode { key: None, - parent: None, + parent: Default::default(), template: Cell::new(template), root_ids: bumpalo::collections::Vec::new_in(cx.bump()).into(), dynamic_nodes: { From b771386c1389f9edb2dbf924694f284b667de456 Mon Sep 17 00:00:00 2001 From: Evan Simkowitz Date: Wed, 23 Aug 2023 14:02:25 -0400 Subject: [PATCH 033/447] fix dioxusmousebuttons --- packages/rink/src/hooks.rs | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/packages/rink/src/hooks.rs b/packages/rink/src/hooks.rs index 7e85f0e2d..a8c611c50 100644 --- a/packages/rink/src/hooks.rs +++ b/packages/rink/src/hooks.rs @@ -11,8 +11,9 @@ use dioxus_html::geometry::{ ClientPoint, Coordinates, ElementPoint, PagePoint, ScreenPoint, WheelDelta, }; use dioxus_html::input_data::keyboard_types::{Code, Key, Location, Modifiers}; -use dioxus_html::input_data::MouseButtonSet as DioxusMouseButtons; -use dioxus_html::input_data::{MouseButton as DioxusMouseButton, MouseButtonSet}; +use dioxus_html::input_data::{ + MouseButton as DioxusMouseButton, MouseButtonSet as DioxusMouseButtons, +}; use dioxus_html::point_interaction::{PointData, PointInteraction}; use dioxus_html::{event_bubbles, FocusData, KeyboardData, MouseData, WheelData}; use std::any::Any; @@ -115,7 +116,7 @@ impl InnerInputState { EventData::Mouse(ref mut m) => { let mut held_buttons = match &self.mouse { Some(previous_data) => previous_data.held_buttons(), - None => MouseButtonSet::empty(), + None => DioxusMouseButtons::empty(), }; match evt.0 { @@ -306,7 +307,7 @@ impl InnerInputState { // a mouse button is pressed if a button was not down and is now down let previous_buttons = previous_mouse - .map_or(MouseButtonSet::empty(), |previous_data| { + .map_or(DioxusMouseButtons::empty(), |previous_data| { previous_data.held_buttons() }); let was_pressed = !(mouse_data.held_buttons() - previous_buttons).is_empty(); @@ -718,7 +719,7 @@ fn get_event(evt: TermEvent) -> Option<(&'static str, EventData)> { // held mouse buttons get set later by maintaining state, as crossterm does not provide them EventData::Mouse(MouseData::new(PointData::new( button, - MouseButtonSet::empty(), + DioxusMouseButtons::empty(), coordinates, modifiers, ))) From af9875f9b1ab363c9e82ff31d2fa98c84f0e30a9 Mon Sep 17 00:00:00 2001 From: Evan Simkowitz Date: Wed, 23 Aug 2023 14:10:18 -0400 Subject: [PATCH 034/447] revert change to cargo --- packages/html/Cargo.toml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/html/Cargo.toml b/packages/html/Cargo.toml index 83706d3bc..5644b440c 100644 --- a/packages/html/Cargo.toml +++ b/packages/html/Cargo.toml @@ -16,7 +16,7 @@ serde = { version = "1", features = ["derive"], optional = true } serde_repr = { version = "0.1", optional = true } wasm-bindgen = { workspace = true, optional = true } euclid = "0.22.7" -enumset = { version = "1.0.11", features = ["serde"] } +enumset = "1.0.11" keyboard-types = "0.7" async-trait = "0.1.58" serde-value = "0.7.0" From 56095116e263b7e7377e169ee5b8a1118ece2073 Mon Sep 17 00:00:00 2001 From: Evan Simkowitz Date: Wed, 23 Aug 2023 17:58:43 -0400 Subject: [PATCH 035/447] Fix tests --- packages/desktop/headless_tests/events.rs | 1 + packages/dioxus-tui/examples/colorpicker.rs | 11 ++-- packages/dioxus-tui/examples/hover.rs | 34 +++++------- packages/dioxus-tui/tests/events.rs | 59 +++++++-------------- packages/html/src/lib.rs | 1 + packages/rink/src/hooks.rs | 4 +- packages/rink/src/widgets/slider.rs | 4 +- 7 files changed, 43 insertions(+), 71 deletions(-) diff --git a/packages/desktop/headless_tests/events.rs b/packages/desktop/headless_tests/events.rs index ac62cd37b..d4439aec6 100644 --- a/packages/desktop/headless_tests/events.rs +++ b/packages/desktop/headless_tests/events.rs @@ -1,6 +1,7 @@ use dioxus::html::geometry::euclid::Vector3D; use dioxus::prelude::*; use dioxus_desktop::DesktopContext; +use dioxus_html::PointInteraction; pub(crate) fn check_app_exits(app: Component) { use dioxus_desktop::tao::window::WindowBuilder; diff --git a/packages/dioxus-tui/examples/colorpicker.rs b/packages/dioxus-tui/examples/colorpicker.rs index 00f8ef7e0..7a358da3e 100644 --- a/packages/dioxus-tui/examples/colorpicker.rs +++ b/packages/dioxus-tui/examples/colorpicker.rs @@ -1,5 +1,6 @@ use dioxus::core::RenderReturn; use dioxus::prelude::*; +use dioxus_html::PointInteraction; use dioxus_tui::DioxusElementToNodeId; use dioxus_tui::Query; use dioxus_tui::Size; @@ -15,21 +16,21 @@ fn app(cx: Scope) -> Element { let mapping: DioxusElementToNodeId = cx.consume_context().unwrap(); // disable templates so that every node has an id and can be queried cx.render(rsx! { - div{ + div { width: "100%", background_color: "hsl({hue}, 70%, {brightness}%)", onmousemove: move |evt| { if let RenderReturn::Ready(node) = cx.root_node() { if let Some(id) = node.root_ids.borrow().get(0).cloned() { let node = tui_query.get(mapping.get_node_id(id).unwrap()); - let Size{width, height} = node.size().unwrap(); + let Size { width, height } = node.size().unwrap(); let pos = evt.inner().element_coordinates(); - hue.set((pos.x as f32/width as f32)*255.0); - brightness.set((pos.y as f32/height as f32)*100.0); + hue.set((pos.x as f32 / width as f32) * 255.0); + brightness.set((pos.y as f32 / height as f32) * 100.0); } } }, - "hsl({hue}, 70%, {brightness}%)", + "hsl({hue}, 70%, {brightness}%)" } }) } diff --git a/packages/dioxus-tui/examples/hover.rs b/packages/dioxus-tui/examples/hover.rs index 3af2d1616..3c29521e5 100644 --- a/packages/dioxus-tui/examples/hover.rs +++ b/packages/dioxus-tui/examples/hover.rs @@ -1,5 +1,6 @@ use dioxus::{events::MouseData, prelude::*}; use dioxus_core::Event; +use dioxus_html::PointInteraction; use std::convert::TryInto; use std::fmt::Write; use std::rc::Rc; @@ -52,15 +53,9 @@ fn app(cx: Scope) -> Element { }; cx.render(rsx! { - div { - width: "100%", - height: "100%", - flex_direction: "column", + div { width: "100%", height: "100%", flex_direction: "column", - div { - width: "100%", - height: "50%", - flex_direction: "row", + div { width: "100%", height: "50%", flex_direction: "row", div { border_width: "1px", width: "50%", @@ -71,7 +66,7 @@ fn app(cx: Scope) -> Element { onmouseenter: move |m| q1_color.set([get_brightness(m.inner()), 0, 0]), onmousedown: move |m| q1_color.set([get_brightness(m.inner()), 0, 0]), onmouseup: move |m| q1_color.set([get_brightness(m.inner()), 0, 0]), - onwheel: move |w| q1_color.set([q1_color[0] + (10.0*w.delta().strip_units().y) as i32, 0, 0]), + onwheel: move |w| q1_color.set([q1_color[0] + (10.0 * w.delta().strip_units().y) as i32, 0, 0]), onmouseleave: move |_| q1_color.set([200; 3]), onmousemove: update_data, "click me" @@ -85,17 +80,14 @@ fn app(cx: Scope) -> Element { onmouseenter: move |m| q2_color.set([get_brightness(m.inner()); 3]), onmousedown: move |m| q2_color.set([get_brightness(m.inner()); 3]), onmouseup: move |m| q2_color.set([get_brightness(m.inner()); 3]), - onwheel: move |w| q2_color.set([q2_color[0] + (10.0*w.delta().strip_units().y) as i32;3]), + onwheel: move |w| q2_color.set([q2_color[0] + (10.0 * w.delta().strip_units().y) as i32; 3]), onmouseleave: move |_| q2_color.set([200; 3]), onmousemove: update_data, "click me" } } - div { - width: "100%", - height: "50%", - flex_direction: "row", + div { width: "100%", height: "50%", flex_direction: "row", div { width: "50%", height: "100%", @@ -105,7 +97,7 @@ fn app(cx: Scope) -> Element { onmouseenter: move |m| q3_color.set([0, get_brightness(m.inner()), 0]), onmousedown: move |m| q3_color.set([0, get_brightness(m.inner()), 0]), onmouseup: move |m| q3_color.set([0, get_brightness(m.inner()), 0]), - onwheel: move |w| q3_color.set([0, q3_color[1] + (10.0*w.delta().strip_units().y) as i32, 0]), + onwheel: move |w| q3_color.set([0, q3_color[1] + (10.0 * w.delta().strip_units().y) as i32, 0]), onmouseleave: move |_| q3_color.set([200; 3]), onmousemove: update_data, "click me" @@ -119,16 +111,16 @@ fn app(cx: Scope) -> Element { onmouseenter: move |m| q4_color.set([0, 0, get_brightness(m.inner())]), onmousedown: move |m| q4_color.set([0, 0, get_brightness(m.inner())]), onmouseup: move |m| q4_color.set([0, 0, get_brightness(m.inner())]), - onwheel: move |w| q4_color.set([0, 0, q4_color[2] + (10.0*w.delta().strip_units().y) as i32]), + onwheel: move |w| q4_color.set([0, 0, q4_color[2] + (10.0 * w.delta().strip_units().y) as i32]), onmouseleave: move |_| q4_color.set([200; 3]), onmousemove: update_data, "click me" } - }, - div {"Page coordinates: {page_coordinates}"}, - div {"Element coordinates: {element_coordinates}"}, - div {"Buttons: {buttons}"}, - div {"Modifiers: {modifiers}"}, + } + div { "Page coordinates: {page_coordinates}" } + div { "Element coordinates: {element_coordinates}" } + div { "Buttons: {buttons}" } + div { "Modifiers: {modifiers}" } } }) } diff --git a/packages/dioxus-tui/tests/events.rs b/packages/dioxus-tui/tests/events.rs index 671cfc349..01fea9934 100644 --- a/packages/dioxus-tui/tests/events.rs +++ b/packages/dioxus-tui/tests/events.rs @@ -1,6 +1,7 @@ use crossterm::event::{Event, KeyCode, KeyEvent, KeyModifiers, MouseButton, MouseEvent}; use dioxus::prelude::*; use dioxus_html::input_data::keyboard_types::Code; +use dioxus_html::PointInteraction; use dioxus_tui::TuiContext; use std::future::Future; use std::pin::Pin; @@ -63,7 +64,7 @@ fn key_down() { onkeydown: move |evt| { assert_eq!(evt.data.code(), Code::KeyA); tui_ctx.quit(); - }, + } } }) } @@ -95,9 +96,11 @@ fn mouse_down() { width: "100%", height: "100%", onmousedown: move |evt| { - assert!(evt.data.held_buttons().contains(dioxus_html::input_data::MouseButton::Primary)); + assert!( + evt.data.held_buttons().contains(dioxus_html::input_data::MouseButton::Primary) + ); tui_ctx.quit(); - }, + } } }) } @@ -131,13 +134,9 @@ fn mouse_up() { modifiers: KeyModifiers::NONE, })); cx.render(rsx! { - div { - width: "100%", - height: "100%", - onmouseup: move |_| { + div { width: "100%", height: "100%", onmouseup: move |_| { tui_ctx.quit(); - }, - } + } } }) } } @@ -170,13 +169,9 @@ fn mouse_enter() { modifiers: KeyModifiers::NONE, })); cx.render(rsx! { - div { - width: "50%", - height: "50%", - onmouseenter: move |_| { + div { width: "50%", height: "50%", onmouseenter: move |_| { tui_ctx.quit(); - }, - } + } } }) } } @@ -209,13 +204,9 @@ fn mouse_exit() { modifiers: KeyModifiers::NONE, })); cx.render(rsx! { - div { - width: "50%", - height: "50%", - onmouseenter: move |_| { + div { width: "50%", height: "50%", onmouseenter: move |_| { tui_ctx.quit(); - }, - } + } } }) } } @@ -248,13 +239,9 @@ fn mouse_move() { modifiers: KeyModifiers::NONE, })); cx.render(rsx! { - div { - width: "100%", - height: "100%", - onmousemove: move |_|{ + div { width: "100%", height: "100%", onmousemove: move |_| { tui_ctx.quit(); - }, - } + } } }) } } @@ -293,7 +280,7 @@ fn wheel() { onwheel: move |evt| { assert!(evt.data.delta().strip_units().y > 0.0); tui_ctx.quit(); - }, + } } }) } @@ -327,13 +314,9 @@ fn click() { modifiers: KeyModifiers::NONE, })); cx.render(rsx! { - div { - width: "100%", - height: "100%", - onclick: move |_|{ + div { width: "100%", height: "100%", onclick: move |_| { tui_ctx.quit(); - }, - } + } } }) } } @@ -366,13 +349,9 @@ fn context_menu() { modifiers: KeyModifiers::NONE, })); cx.render(rsx! { - div { - width: "100%", - height: "100%", - oncontextmenu: move |_|{ + div { width: "100%", height: "100%", oncontextmenu: move |_| { tui_ctx.quit(); - }, - } + } } }) } } diff --git a/packages/html/src/lib.rs b/packages/html/src/lib.rs index 5866ed28a..973d6e750 100644 --- a/packages/html/src/lib.rs +++ b/packages/html/src/lib.rs @@ -36,6 +36,7 @@ pub use transit::*; pub use elements::*; pub use events::*; pub use global_attributes::*; +pub use point_interaction::PointInteraction; pub use render_template::*; mod eval; diff --git a/packages/rink/src/hooks.rs b/packages/rink/src/hooks.rs index a8c611c50..106e0dc41 100644 --- a/packages/rink/src/hooks.rs +++ b/packages/rink/src/hooks.rs @@ -14,8 +14,8 @@ use dioxus_html::input_data::keyboard_types::{Code, Key, Location, Modifiers}; use dioxus_html::input_data::{ MouseButton as DioxusMouseButton, MouseButtonSet as DioxusMouseButtons, }; -use dioxus_html::point_interaction::{PointData, PointInteraction}; -use dioxus_html::{event_bubbles, FocusData, KeyboardData, MouseData, WheelData}; +use dioxus_html::point_interaction::PointData; +use dioxus_html::{event_bubbles, FocusData, KeyboardData, MouseData, PointInteraction, WheelData}; use std::any::Any; use std::collections::HashMap; use std::{ diff --git a/packages/rink/src/widgets/slider.rs b/packages/rink/src/widgets/slider.rs index 5b24e180d..4a78f2a79 100644 --- a/packages/rink/src/widgets/slider.rs +++ b/packages/rink/src/widgets/slider.rs @@ -1,8 +1,6 @@ use std::collections::HashMap; -use dioxus_html::{ - input_data::keyboard_types::Key, point_interaction::PointInteraction, KeyboardData, MouseData, -}; +use dioxus_html::{input_data::keyboard_types::Key, KeyboardData, MouseData, PointInteraction}; use dioxus_native_core::{ custom_element::CustomElement, node::{OwnedAttributeDiscription, OwnedAttributeValue}, From e8b95993ac7b4c63f3508ee123fa508698cc066a Mon Sep 17 00:00:00 2001 From: Evan Simkowitz Date: Wed, 23 Aug 2023 18:33:27 -0400 Subject: [PATCH 036/447] fix text_like import --- packages/rink/src/widgets/text_like.rs | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/packages/rink/src/widgets/text_like.rs b/packages/rink/src/widgets/text_like.rs index 1f96cfa61..b2d12efa2 100644 --- a/packages/rink/src/widgets/text_like.rs +++ b/packages/rink/src/widgets/text_like.rs @@ -1,9 +1,7 @@ use std::{collections::HashMap, io::stdout}; use crossterm::{cursor::MoveTo, execute}; -use dioxus_html::{ - input_data::keyboard_types::Key, point_interaction::PointInteraction, KeyboardData, MouseData, -}; +use dioxus_html::{input_data::keyboard_types::Key, KeyboardData, MouseData, PointInteraction}; use dioxus_native_core::{ custom_element::CustomElement, node::OwnedAttributeDiscription, From 500051e2b26844a257ef65dcf75cf6494b1951ed Mon Sep 17 00:00:00 2001 From: Evan Simkowitz Date: Wed, 23 Aug 2023 20:23:54 -0400 Subject: [PATCH 037/447] fix formatting issue --- packages/dioxus-tui/tests/events.rs | 48 +++++++++++++++++++++-------- 1 file changed, 36 insertions(+), 12 deletions(-) diff --git a/packages/dioxus-tui/tests/events.rs b/packages/dioxus-tui/tests/events.rs index 01fea9934..6282ef21d 100644 --- a/packages/dioxus-tui/tests/events.rs +++ b/packages/dioxus-tui/tests/events.rs @@ -134,9 +134,13 @@ fn mouse_up() { modifiers: KeyModifiers::NONE, })); cx.render(rsx! { - div { width: "100%", height: "100%", onmouseup: move |_| { + div { + width: "100%", + height: "100%", + onmouseup: move |_| { tui_ctx.quit(); - } } + } + } }) } } @@ -169,9 +173,13 @@ fn mouse_enter() { modifiers: KeyModifiers::NONE, })); cx.render(rsx! { - div { width: "50%", height: "50%", onmouseenter: move |_| { + div { + width: "50%", + height: "50%", + onmouseenter: move |_| { tui_ctx.quit(); - } } + } + } }) } } @@ -204,9 +212,13 @@ fn mouse_exit() { modifiers: KeyModifiers::NONE, })); cx.render(rsx! { - div { width: "50%", height: "50%", onmouseenter: move |_| { + div { + width: "50%", + height: "50%", + onmouseenter: move |_| { tui_ctx.quit(); - } } + } + } }) } } @@ -239,9 +251,13 @@ fn mouse_move() { modifiers: KeyModifiers::NONE, })); cx.render(rsx! { - div { width: "100%", height: "100%", onmousemove: move |_| { + div { + width: "100%", + height: "100%", + onmousemove: move |_| { tui_ctx.quit(); - } } + } + } }) } } @@ -314,9 +330,13 @@ fn click() { modifiers: KeyModifiers::NONE, })); cx.render(rsx! { - div { width: "100%", height: "100%", onclick: move |_| { + div { + width: "100%", + height: "100%", + onclick: move |_| { tui_ctx.quit(); - } } + } + } }) } } @@ -349,9 +369,13 @@ fn context_menu() { modifiers: KeyModifiers::NONE, })); cx.render(rsx! { - div { width: "100%", height: "100%", oncontextmenu: move |_| { + div { + width: "100%", + height: "100%", + oncontextmenu: move |_| { tui_ctx.quit(); - } } + } + } }) } } From a8af958d759e4a353bb1ce5c716e6811d04d54d9 Mon Sep 17 00:00:00 2001 From: Evan Simkowitz Date: Wed, 23 Aug 2023 20:39:34 -0400 Subject: [PATCH 038/447] Add dxfmt::skip and workspace recommendations --- .vscode/extensions.json | 6 ++++ .vscode/settings.json | 5 ++- packages/dioxus-tui/tests/events.rs | 54 ++++++++++++++++------------- 3 files changed, 40 insertions(+), 25 deletions(-) create mode 100644 .vscode/extensions.json diff --git a/.vscode/extensions.json b/.vscode/extensions.json new file mode 100644 index 000000000..0ec60d272 --- /dev/null +++ b/.vscode/extensions.json @@ -0,0 +1,6 @@ +{ + "recommendations": [ + "dioxuslabs.dioxus", + "rust-lang.rust-analyzer" + ] +} \ No newline at end of file diff --git a/.vscode/settings.json b/.vscode/settings.json index ebd52887e..4cf40036e 100644 --- a/.vscode/settings.json +++ b/.vscode/settings.json @@ -1,7 +1,10 @@ { - "editor.formatOnSave": true, + "editor.formatOnSave": false, "[toml]": { "editor.formatOnSave": false }, + "[rust]": { + "editor.defaultFormatter": "DioxusLabs.dioxus" + }, "rust-analyzer.checkOnSave.allTargets": false, } diff --git a/packages/dioxus-tui/tests/events.rs b/packages/dioxus-tui/tests/events.rs index 6282ef21d..7a93d3ebc 100644 --- a/packages/dioxus-tui/tests/events.rs +++ b/packages/dioxus-tui/tests/events.rs @@ -134,12 +134,13 @@ fn mouse_up() { modifiers: KeyModifiers::NONE, })); cx.render(rsx! { - div { - width: "100%", - height: "100%", + #[dxfmt::skip] + div { + width: "100%", + height: "100%", onmouseup: move |_| { tui_ctx.quit(); - } + } } }) } @@ -173,12 +174,13 @@ fn mouse_enter() { modifiers: KeyModifiers::NONE, })); cx.render(rsx! { - div { - width: "50%", - height: "50%", + #[dxfmt::skip] + div { + width: "50%", + height: "50%", onmouseenter: move |_| { tui_ctx.quit(); - } + } } }) } @@ -212,12 +214,13 @@ fn mouse_exit() { modifiers: KeyModifiers::NONE, })); cx.render(rsx! { - div { - width: "50%", - height: "50%", + #[dxfmt::skip] + div { + width: "50%", + height: "50%", onmouseenter: move |_| { tui_ctx.quit(); - } + } } }) } @@ -251,12 +254,13 @@ fn mouse_move() { modifiers: KeyModifiers::NONE, })); cx.render(rsx! { - div { - width: "100%", - height: "100%", + #[dxfmt::skip] + div { + width: "100%", + height: "100%", onmousemove: move |_| { tui_ctx.quit(); - } + } } }) } @@ -330,12 +334,13 @@ fn click() { modifiers: KeyModifiers::NONE, })); cx.render(rsx! { - div { - width: "100%", - height: "100%", + #[dxfmt::skip] + div { + width: "100%", + height: "100%", onclick: move |_| { tui_ctx.quit(); - } + } } }) } @@ -369,12 +374,13 @@ fn context_menu() { modifiers: KeyModifiers::NONE, })); cx.render(rsx! { - div { - width: "100%", - height: "100%", + #[dxfmt::skip] + div { + width: "100%", + height: "100%", oncontextmenu: move |_| { tui_ctx.quit(); - } + } } }) } From 4e584fb2c29cbb5c01ee91f8566b05817e1f2c42 Mon Sep 17 00:00:00 2001 From: Evan Simkowitz Date: Wed, 23 Aug 2023 20:40:06 -0400 Subject: [PATCH 039/447] add even better toml --- .vscode/extensions.json | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/.vscode/extensions.json b/.vscode/extensions.json index 0ec60d272..90881959b 100644 --- a/.vscode/extensions.json +++ b/.vscode/extensions.json @@ -1,6 +1,7 @@ { "recommendations": [ "dioxuslabs.dioxus", - "rust-lang.rust-analyzer" + "rust-lang.rust-analyzer", + "tamasfe.even-better-toml" ] } \ No newline at end of file From bad30786e28992d52a86fef50989ec005996b9a7 Mon Sep 17 00:00:00 2001 From: Evan Simkowitz Date: Wed, 23 Aug 2023 22:09:39 -0400 Subject: [PATCH 040/447] address comments --- .vscode/settings.json | 4 +- packages/html/src/events/pointer.rs | 51 +++++++++++------------- packages/html/src/lib.rs | 2 +- packages/html/src/web_sys_bind/events.rs | 24 +++++------ packages/rink/src/hooks.rs | 2 +- packages/rink/src/widgets/slider.rs | 2 +- packages/rink/src/widgets/text_like.rs | 2 +- 7 files changed, 41 insertions(+), 46 deletions(-) diff --git a/.vscode/settings.json b/.vscode/settings.json index 4cf40036e..42dfebaab 100644 --- a/.vscode/settings.json +++ b/.vscode/settings.json @@ -1,10 +1,10 @@ { - "editor.formatOnSave": false, + "editor.formatOnSave": true, "[toml]": { "editor.formatOnSave": false }, "[rust]": { - "editor.defaultFormatter": "DioxusLabs.dioxus" + "editor.defaultFormatter": "rust-lang.rust-analyzer" }, "rust-analyzer.checkOnSave.allTargets": false, } diff --git a/packages/html/src/events/pointer.rs b/packages/html/src/events/pointer.rs index 62e65bf76..9277568d0 100644 --- a/packages/html/src/events/pointer.rs +++ b/packages/html/src/events/pointer.rs @@ -7,22 +7,6 @@ use crate::point_interaction::{PointData, PointInteraction}; /// A synthetic event that wraps a web-style [`PointerEvent`](https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent) pub type PointerEvent = Event; -/// Data associated with a pointer event, aside from the data shared with mouse events -#[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] -#[derive(Debug, Clone, PartialEq)] -pub struct PointerEventData { - pub pointer_id: i32, - pub width: i32, - pub height: i32, - pub pressure: f32, - pub tangential_pressure: f32, - pub tilt_x: i32, - pub tilt_y: i32, - pub twist: i32, - pub pointer_type: String, - pub is_primary: bool, -} - #[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] #[derive(Debug, Clone, PartialEq)] pub struct PointerData { @@ -105,20 +89,33 @@ impl_event![ ]; impl PointerData { - pub fn new(point_data: PointData, pointer_event_data: PointerEventData) -> Self { + #[allow(clippy::too_many_arguments)] + pub fn new( + point_data: PointData, + pointer_id: i32, + width: i32, + height: i32, + pressure: f32, + tangential_pressure: f32, + tilt_x: i32, + tilt_y: i32, + twist: i32, + pointer_type: String, + is_primary: bool, + ) -> Self { #[allow(deprecated)] Self { point_data, - pointer_id: pointer_event_data.pointer_id, - width: pointer_event_data.width, - height: pointer_event_data.height, - pressure: pointer_event_data.pressure, - tangential_pressure: pointer_event_data.tangential_pressure, - tilt_x: pointer_event_data.tilt_x, - tilt_y: pointer_event_data.tilt_y, - twist: pointer_event_data.twist, - pointer_type: pointer_event_data.pointer_type, - is_primary: pointer_event_data.is_primary, + pointer_id, + width, + height, + pressure, + tangential_pressure, + tilt_x, + tilt_y, + twist, + pointer_type, + is_primary, } } diff --git a/packages/html/src/lib.rs b/packages/html/src/lib.rs index 973d6e750..d362d71f1 100644 --- a/packages/html/src/lib.rs +++ b/packages/html/src/lib.rs @@ -36,7 +36,6 @@ pub use transit::*; pub use elements::*; pub use events::*; pub use global_attributes::*; -pub use point_interaction::PointInteraction; pub use render_template::*; mod eval; @@ -44,4 +43,5 @@ mod eval; pub mod prelude { pub use crate::eval::*; pub use crate::events::*; + pub use crate::point_interaction::PointInteraction; } diff --git a/packages/html/src/web_sys_bind/events.rs b/packages/html/src/web_sys_bind/events.rs index f175e98e2..c1214f870 100644 --- a/packages/html/src/web_sys_bind/events.rs +++ b/packages/html/src/web_sys_bind/events.rs @@ -4,7 +4,7 @@ use crate::events::{ }; use crate::input_data::decode_key_location; use crate::point_interaction::PointData; -use crate::{DragData, MountedData, PointerEventData}; +use crate::{DragData, MountedData}; use keyboard_types::{Code, Key, Modifiers}; use std::convert::TryInto; use std::str::FromStr; @@ -147,18 +147,16 @@ impl From<&PointerEvent> for PointerData { page_x: e.page_x(), page_y: e.page_y(), }, - PointerEventData { - pointer_id: e.pointer_id(), - width: e.width(), - height: e.height(), - pressure: e.pressure(), - tangential_pressure: e.tangential_pressure(), - tilt_x: e.tilt_x(), - tilt_y: e.tilt_y(), - twist: e.twist(), - pointer_type: e.pointer_type(), - is_primary: e.is_primary(), - }, + e.pointer_id(), + e.width(), + e.height(), + e.pressure(), + e.tangential_pressure(), + e.tilt_x(), + e.tilt_y(), + e.twist(), + e.pointer_type(), + e.is_primary(), ) } } diff --git a/packages/rink/src/hooks.rs b/packages/rink/src/hooks.rs index 106e0dc41..4a07992de 100644 --- a/packages/rink/src/hooks.rs +++ b/packages/rink/src/hooks.rs @@ -15,7 +15,7 @@ use dioxus_html::input_data::{ MouseButton as DioxusMouseButton, MouseButtonSet as DioxusMouseButtons, }; use dioxus_html::point_interaction::PointData; -use dioxus_html::{event_bubbles, FocusData, KeyboardData, MouseData, PointInteraction, WheelData}; +use dioxus_html::{event_bubbles, FocusData, KeyboardData, MouseData, prelude::PointInteraction, WheelData}; use std::any::Any; use std::collections::HashMap; use std::{ diff --git a/packages/rink/src/widgets/slider.rs b/packages/rink/src/widgets/slider.rs index 4a78f2a79..61bb820b4 100644 --- a/packages/rink/src/widgets/slider.rs +++ b/packages/rink/src/widgets/slider.rs @@ -1,6 +1,6 @@ use std::collections::HashMap; -use dioxus_html::{input_data::keyboard_types::Key, KeyboardData, MouseData, PointInteraction}; +use dioxus_html::{input_data::keyboard_types::Key, KeyboardData, MouseData, prelude::PointInteraction}; use dioxus_native_core::{ custom_element::CustomElement, node::{OwnedAttributeDiscription, OwnedAttributeValue}, diff --git a/packages/rink/src/widgets/text_like.rs b/packages/rink/src/widgets/text_like.rs index b2d12efa2..bcba2d994 100644 --- a/packages/rink/src/widgets/text_like.rs +++ b/packages/rink/src/widgets/text_like.rs @@ -1,7 +1,7 @@ use std::{collections::HashMap, io::stdout}; use crossterm::{cursor::MoveTo, execute}; -use dioxus_html::{input_data::keyboard_types::Key, KeyboardData, MouseData, PointInteraction}; +use dioxus_html::{input_data::keyboard_types::Key, KeyboardData, MouseData, prelude::PointInteraction}; use dioxus_native_core::{ custom_element::CustomElement, node::OwnedAttributeDiscription, From f599ad6ad7e536bec7d66f8ff9ce99e6a5d94ea6 Mon Sep 17 00:00:00 2001 From: Evan Simkowitz Date: Wed, 23 Aug 2023 22:14:57 -0400 Subject: [PATCH 041/447] remove unnecessary PointInteraction imports now that it's in prelude --- packages/desktop/headless_tests/events.rs | 1 - packages/dioxus-tui/examples/colorpicker.rs | 1 - packages/dioxus-tui/examples/hover.rs | 1 - packages/dioxus-tui/tests/events.rs | 1 - 4 files changed, 4 deletions(-) diff --git a/packages/desktop/headless_tests/events.rs b/packages/desktop/headless_tests/events.rs index d4439aec6..ac62cd37b 100644 --- a/packages/desktop/headless_tests/events.rs +++ b/packages/desktop/headless_tests/events.rs @@ -1,7 +1,6 @@ use dioxus::html::geometry::euclid::Vector3D; use dioxus::prelude::*; use dioxus_desktop::DesktopContext; -use dioxus_html::PointInteraction; pub(crate) fn check_app_exits(app: Component) { use dioxus_desktop::tao::window::WindowBuilder; diff --git a/packages/dioxus-tui/examples/colorpicker.rs b/packages/dioxus-tui/examples/colorpicker.rs index 7a358da3e..694d58ed8 100644 --- a/packages/dioxus-tui/examples/colorpicker.rs +++ b/packages/dioxus-tui/examples/colorpicker.rs @@ -1,6 +1,5 @@ use dioxus::core::RenderReturn; use dioxus::prelude::*; -use dioxus_html::PointInteraction; use dioxus_tui::DioxusElementToNodeId; use dioxus_tui::Query; use dioxus_tui::Size; diff --git a/packages/dioxus-tui/examples/hover.rs b/packages/dioxus-tui/examples/hover.rs index 3c29521e5..dc797d048 100644 --- a/packages/dioxus-tui/examples/hover.rs +++ b/packages/dioxus-tui/examples/hover.rs @@ -1,6 +1,5 @@ use dioxus::{events::MouseData, prelude::*}; use dioxus_core::Event; -use dioxus_html::PointInteraction; use std::convert::TryInto; use std::fmt::Write; use std::rc::Rc; diff --git a/packages/dioxus-tui/tests/events.rs b/packages/dioxus-tui/tests/events.rs index 7a93d3ebc..3df63c8cd 100644 --- a/packages/dioxus-tui/tests/events.rs +++ b/packages/dioxus-tui/tests/events.rs @@ -1,7 +1,6 @@ use crossterm::event::{Event, KeyCode, KeyEvent, KeyModifiers, MouseButton, MouseEvent}; use dioxus::prelude::*; use dioxus_html::input_data::keyboard_types::Code; -use dioxus_html::PointInteraction; use dioxus_tui::TuiContext; use std::future::Future; use std::pin::Pin; From c9da74313ce77b9279bb7f29c6d1d92468f59062 Mon Sep 17 00:00:00 2001 From: Evan Simkowitz Date: Wed, 23 Aug 2023 22:18:12 -0400 Subject: [PATCH 042/447] fix another bad format --- packages/dioxus-tui/examples/hover.rs | 16 +++++++++++++--- 1 file changed, 13 insertions(+), 3 deletions(-) diff --git a/packages/dioxus-tui/examples/hover.rs b/packages/dioxus-tui/examples/hover.rs index dc797d048..a0b254414 100644 --- a/packages/dioxus-tui/examples/hover.rs +++ b/packages/dioxus-tui/examples/hover.rs @@ -52,9 +52,16 @@ fn app(cx: Scope) -> Element { }; cx.render(rsx! { - div { width: "100%", height: "100%", flex_direction: "column", + #[dxfmt::skip] + div { + width: "100%", + height: "100%", + flex_direction: "column", - div { width: "100%", height: "50%", flex_direction: "row", + div { + width: "100%", + height: "50%", + flex_direction: "row", div { border_width: "1px", width: "50%", @@ -86,7 +93,10 @@ fn app(cx: Scope) -> Element { } } - div { width: "100%", height: "50%", flex_direction: "row", + div { + width: "100%", + height: "50%", + flex_direction: "row", div { width: "50%", height: "100%", From a5b97aa4a3d56cb2dfb86d6ed4c5f119306d6529 Mon Sep 17 00:00:00 2001 From: Evan Simkowitz Date: Wed, 23 Aug 2023 22:29:12 -0400 Subject: [PATCH 043/447] fix hover.rs formatting --- packages/dioxus-tui/examples/hover.rs | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/packages/dioxus-tui/examples/hover.rs b/packages/dioxus-tui/examples/hover.rs index a0b254414..8f00c146c 100644 --- a/packages/dioxus-tui/examples/hover.rs +++ b/packages/dioxus-tui/examples/hover.rs @@ -52,10 +52,10 @@ fn app(cx: Scope) -> Element { }; cx.render(rsx! { - #[dxfmt::skip] - div { - width: "100%", - height: "100%", + div { + width: "100%", + height: "100%", + flex_direction: "column", div { From f9de91e987c1328dc7241d251d7d1647222f0d3c Mon Sep 17 00:00:00 2001 From: Evan Simkowitz Date: Thu, 24 Aug 2023 00:01:11 -0400 Subject: [PATCH 044/447] revert settings.json, remove extensions.json --- .vscode/extensions.json | 7 ------- .vscode/settings.json | 3 --- 2 files changed, 10 deletions(-) delete mode 100644 .vscode/extensions.json diff --git a/.vscode/extensions.json b/.vscode/extensions.json deleted file mode 100644 index 90881959b..000000000 --- a/.vscode/extensions.json +++ /dev/null @@ -1,7 +0,0 @@ -{ - "recommendations": [ - "dioxuslabs.dioxus", - "rust-lang.rust-analyzer", - "tamasfe.even-better-toml" - ] -} \ No newline at end of file diff --git a/.vscode/settings.json b/.vscode/settings.json index 42dfebaab..ebd52887e 100644 --- a/.vscode/settings.json +++ b/.vscode/settings.json @@ -3,8 +3,5 @@ "[toml]": { "editor.formatOnSave": false }, - "[rust]": { - "editor.defaultFormatter": "rust-lang.rust-analyzer" - }, "rust-analyzer.checkOnSave.allTargets": false, } From a5d687f7af3cad458af26a46352bc7af2e3b9bb2 Mon Sep 17 00:00:00 2001 From: Evan Simkowitz Date: Thu, 24 Aug 2023 00:06:52 -0400 Subject: [PATCH 045/447] fix formatting --- packages/dioxus-tui/examples/hover.rs | 2 -- packages/rink/src/hooks.rs | 4 +++- packages/rink/src/widgets/slider.rs | 4 +++- 3 files changed, 6 insertions(+), 4 deletions(-) diff --git a/packages/dioxus-tui/examples/hover.rs b/packages/dioxus-tui/examples/hover.rs index 8f00c146c..2c2cda17d 100644 --- a/packages/dioxus-tui/examples/hover.rs +++ b/packages/dioxus-tui/examples/hover.rs @@ -55,9 +55,7 @@ fn app(cx: Scope) -> Element { div { width: "100%", height: "100%", - flex_direction: "column", - div { width: "100%", height: "50%", diff --git a/packages/rink/src/hooks.rs b/packages/rink/src/hooks.rs index 4a07992de..b6b34458c 100644 --- a/packages/rink/src/hooks.rs +++ b/packages/rink/src/hooks.rs @@ -15,7 +15,9 @@ use dioxus_html::input_data::{ MouseButton as DioxusMouseButton, MouseButtonSet as DioxusMouseButtons, }; use dioxus_html::point_interaction::PointData; -use dioxus_html::{event_bubbles, FocusData, KeyboardData, MouseData, prelude::PointInteraction, WheelData}; +use dioxus_html::{ + event_bubbles, prelude::PointInteraction, FocusData, KeyboardData, MouseData, WheelData, +}; use std::any::Any; use std::collections::HashMap; use std::{ diff --git a/packages/rink/src/widgets/slider.rs b/packages/rink/src/widgets/slider.rs index 61bb820b4..3af995e09 100644 --- a/packages/rink/src/widgets/slider.rs +++ b/packages/rink/src/widgets/slider.rs @@ -1,6 +1,8 @@ use std::collections::HashMap; -use dioxus_html::{input_data::keyboard_types::Key, KeyboardData, MouseData, prelude::PointInteraction}; +use dioxus_html::{ + input_data::keyboard_types::Key, prelude::PointInteraction, KeyboardData, MouseData, +}; use dioxus_native_core::{ custom_element::CustomElement, node::{OwnedAttributeDiscription, OwnedAttributeValue}, From 124b58afb1bc6cd9b7dd9573fa837155fe3ef7a6 Mon Sep 17 00:00:00 2001 From: Evan Simkowitz Date: Thu, 24 Aug 2023 00:06:57 -0400 Subject: [PATCH 046/447] missed one --- packages/rink/src/widgets/text_like.rs | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/packages/rink/src/widgets/text_like.rs b/packages/rink/src/widgets/text_like.rs index bcba2d994..5bfebd0ab 100644 --- a/packages/rink/src/widgets/text_like.rs +++ b/packages/rink/src/widgets/text_like.rs @@ -1,7 +1,9 @@ use std::{collections::HashMap, io::stdout}; use crossterm::{cursor::MoveTo, execute}; -use dioxus_html::{input_data::keyboard_types::Key, KeyboardData, MouseData, prelude::PointInteraction}; +use dioxus_html::{ + input_data::keyboard_types::Key, prelude::PointInteraction, KeyboardData, MouseData, +}; use dioxus_native_core::{ custom_element::CustomElement, node::OwnedAttributeDiscription, From a72718134b7cdb5a05820bf06a65c35dece20f10 Mon Sep 17 00:00:00 2001 From: Evan Simkowitz Date: Thu, 24 Aug 2023 00:18:00 -0400 Subject: [PATCH 047/447] fix failing check --- packages/dioxus-tui/tests/events.rs | 6 ------ 1 file changed, 6 deletions(-) diff --git a/packages/dioxus-tui/tests/events.rs b/packages/dioxus-tui/tests/events.rs index 3df63c8cd..4d2639371 100644 --- a/packages/dioxus-tui/tests/events.rs +++ b/packages/dioxus-tui/tests/events.rs @@ -133,7 +133,6 @@ fn mouse_up() { modifiers: KeyModifiers::NONE, })); cx.render(rsx! { - #[dxfmt::skip] div { width: "100%", height: "100%", @@ -173,7 +172,6 @@ fn mouse_enter() { modifiers: KeyModifiers::NONE, })); cx.render(rsx! { - #[dxfmt::skip] div { width: "50%", height: "50%", @@ -213,7 +211,6 @@ fn mouse_exit() { modifiers: KeyModifiers::NONE, })); cx.render(rsx! { - #[dxfmt::skip] div { width: "50%", height: "50%", @@ -253,7 +250,6 @@ fn mouse_move() { modifiers: KeyModifiers::NONE, })); cx.render(rsx! { - #[dxfmt::skip] div { width: "100%", height: "100%", @@ -333,7 +329,6 @@ fn click() { modifiers: KeyModifiers::NONE, })); cx.render(rsx! { - #[dxfmt::skip] div { width: "100%", height: "100%", @@ -373,7 +368,6 @@ fn context_menu() { modifiers: KeyModifiers::NONE, })); cx.render(rsx! { - #[dxfmt::skip] div { width: "100%", height: "100%", From 299b1234462ea750e54b424dd4d9e7a7bbf779f4 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Fri, 25 Aug 2023 17:02:48 -0500 Subject: [PATCH 048/447] trait based event system --- packages/desktop/src/element.rs | 4 +- packages/desktop/src/lib.rs | 24 +- packages/html/Cargo.toml | 3 +- packages/html/src/events.rs | 4 +- packages/html/src/events/animation.rs | 118 ++++++- packages/html/src/events/clipboard.rs | 75 +++- packages/html/src/events/composition.rs | 85 ++++- packages/html/src/events/drag.rs | 180 +++++++++- packages/html/src/events/focus.rs | 71 +++- packages/html/src/events/form.rs | 210 +++++++++--- packages/html/src/events/image.rs | 88 ++++- packages/html/src/events/keyboard.rs | 247 +++++++------- packages/html/src/events/media.rs | 73 +++- packages/html/src/events/mounted.rs | 36 +- packages/html/src/events/mouse.rs | 132 ++++++- packages/html/src/events/pointer.rs | 347 ++++++++++++++----- packages/html/src/events/scroll.rs | 72 +++- packages/html/src/events/selection.rs | 72 +++- packages/html/src/events/toggle.rs | 72 +++- packages/html/src/events/touch.rs | 142 +++++++- packages/html/src/events/transition.rs | 101 +++++- packages/html/src/events/wheel.rs | 145 ++++---- packages/html/src/geometry.rs | 14 +- packages/html/src/lib.rs | 1 + packages/html/src/point_interaction.rs | 266 +++++++-------- packages/html/src/transit.rs | 4 +- packages/html/src/web_sys_bind/events.rs | 415 ++++++++++++++++------- packages/web/src/dom.rs | 140 +++++--- 28 files changed, 2407 insertions(+), 734 deletions(-) diff --git a/packages/desktop/src/element.rs b/packages/desktop/src/element.rs index 20ca951bf..8239099cb 100644 --- a/packages/desktop/src/element.rs +++ b/packages/desktop/src/element.rs @@ -17,8 +17,8 @@ impl DesktopElement { } impl RenderedElementBacking for DesktopElement { - fn get_raw_element(&self) -> dioxus_html::MountedResult<&dyn std::any::Any> { - Ok(self) + fn as_any(&self) -> &dyn std::any::Any { + self } fn get_client_rect( diff --git a/packages/desktop/src/lib.rs b/packages/desktop/src/lib.rs index 070bfa7d1..e1a94fbfc 100644 --- a/packages/desktop/src/lib.rs +++ b/packages/desktop/src/lib.rs @@ -27,8 +27,8 @@ pub use desktop_context::{ }; use desktop_context::{EventData, UserWindowEvent, WebviewQueue, WindowEventHandlers}; use dioxus_core::*; -use dioxus_html::MountedData; -use dioxus_html::{native_bind::NativeFileEngine, FormData, HtmlEvent}; +use dioxus_html::{native_bind::NativeFileEngine, HtmlEvent}; +use dioxus_html::{FileEngine, HasFormData, MountedData}; use element::DesktopElement; use eval::init_eval; use futures_util::{pin_mut, FutureExt}; @@ -340,14 +340,26 @@ pub fn launch_with_props(root: Component

, props: P, cfg: Config) if let Ok(file_diolog) = serde_json::from_value::(msg.params()) { + struct DesktopFileUploadForm { + files: Arc, + } + + impl HasFormData for DesktopFileUploadForm { + fn files(&self) -> Option> { + Some(self.files.clone()) + } + + fn as_any(&self) -> &dyn std::any::Any { + self + } + } + let id = ElementId(file_diolog.target); let event_name = &file_diolog.event; let event_bubbles = file_diolog.bubbles; let files = file_upload::get_file_event(&file_diolog); - let data = Rc::new(FormData { - value: Default::default(), - values: Default::default(), - files: Some(Arc::new(NativeFileEngine::new(files))), + let data = Rc::new(DesktopFileUploadForm { + files: Arc::new(NativeFileEngine::new(files)), }); let view = webviews.get_mut(&event.1).unwrap(); diff --git a/packages/html/Cargo.toml b/packages/html/Cargo.toml index 5644b440c..3a2495b02 100644 --- a/packages/html/Cargo.toml +++ b/packages/html/Cargo.toml @@ -41,7 +41,6 @@ features = [ "PointerEvent", "FocusEvent", "CompositionEvent", - "ClipboardEvent", ] [dev-dependencies] @@ -51,11 +50,13 @@ serde_json = "1" default = ["serialize", "mounted"] serialize = [ "serde", + "serde/rc", "serde_repr", "serde_json", "euclid/serde", "keyboard-types/serde", "dioxus-core/serialize", + "enumset/serde", ] mounted = [ "web-sys/Element", diff --git a/packages/html/src/events.rs b/packages/html/src/events.rs index c59149493..f044b7b43 100644 --- a/packages/html/src/events.rs +++ b/packages/html/src/events.rs @@ -151,8 +151,6 @@ pub fn event_bubbles(evt: &str) -> bool { } } -use std::future::Future; - #[doc(hidden)] pub trait EventReturn

: Sized { fn spawn(self, _cx: &dioxus_core::ScopeState) {} @@ -164,7 +162,7 @@ pub struct AsyncMarker; impl EventReturn for T where - T: Future + 'static, + T: std::future::Future + 'static, { #[inline] fn spawn(self, cx: &dioxus_core::ScopeState) { diff --git a/packages/html/src/events/animation.rs b/packages/html/src/events/animation.rs index 4495191fc..ca0a26567 100644 --- a/packages/html/src/events/animation.rs +++ b/packages/html/src/events/animation.rs @@ -2,12 +2,120 @@ use dioxus_core::Event; pub type AnimationEvent = Event; -#[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] -#[derive(Debug, Clone, PartialEq)] pub struct AnimationData { - pub animation_name: String, - pub pseudo_element: String, - pub elapsed_time: f32, + inner: Box, +} + +impl AnimationData { + pub fn animation_name(&self) -> String { + self.inner.animation_name() + } + + pub fn pseudo_element(&self) -> String { + self.inner.pseudo_element() + } + + pub fn elapsed_time(&self) -> f32 { + self.inner.elapsed_time() + } + + pub fn downcast(&self) -> Option<&T> { + self.inner.as_ref().as_any().downcast_ref::() + } +} + +impl From for AnimationData { + fn from(e: E) -> Self { + Self { inner: Box::new(e) } + } +} + +impl std::fmt::Debug for AnimationData { + fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { + f.debug_struct("AnimationData") + .field("animation_name", &self.animation_name()) + .field("pseudo_element", &self.pseudo_element()) + .field("elapsed_time", &self.elapsed_time()) + .finish() + } +} + +impl PartialEq for AnimationData { + fn eq(&self, other: &Self) -> bool { + self.animation_name() == other.animation_name() + && self.pseudo_element() == other.pseudo_element() + && self.elapsed_time() == other.elapsed_time() + } +} + +#[cfg(feature = "serialize")] +#[derive(serde::Serialize, serde::Deserialize)] +struct SerializedAnimationData { + animation_name: String, + pseudo_element: String, + elapsed_time: f32, +} + +#[cfg(feature = "serialize")] +impl From<&AnimationData> for SerializedAnimationData { + fn from(data: &AnimationData) -> Self { + Self { + animation_name: data.animation_name(), + pseudo_element: data.pseudo_element(), + elapsed_time: data.elapsed_time(), + } + } +} + +#[cfg(feature = "serialize")] +impl HasAnimationData for SerializedAnimationData { + fn animation_name(&self) -> String { + self.animation_name.clone() + } + + fn pseudo_element(&self) -> String { + self.pseudo_element.clone() + } + + fn elapsed_time(&self) -> f32 { + self.elapsed_time + } + + fn as_any(&self) -> &dyn std::any::Any { + self + } +} + +#[cfg(feature = "serialize")] +impl serde::Serialize for AnimationData { + fn serialize(&self, serializer: S) -> Result { + SerializedAnimationData::from(self).serialize(serializer) + } +} + +#[cfg(feature = "serialize")] +impl<'de> serde::Deserialize<'de> for AnimationData { + fn deserialize>(deserializer: D) -> Result { + let data = SerializedAnimationData::deserialize(deserializer)?; + Ok(Self { + inner: Box::new(data), + }) + } +} + +/// A trait for any object that has the data for an animation event +pub trait HasAnimationData: std::any::Any { + /// The name of the animation + fn animation_name(&self) -> String; + + /// The name of the pseudo-element the animation runs on + fn pseudo_element(&self) -> String; + + /// The amount of time the animation has been running + fn elapsed_time(&self) -> f32; + + /// return self as Any + fn as_any(&self) -> &dyn std::any::Any; } impl_event! [ diff --git a/packages/html/src/events/clipboard.rs b/packages/html/src/events/clipboard.rs index 54390c6b0..84a9b1446 100644 --- a/packages/html/src/events/clipboard.rs +++ b/packages/html/src/events/clipboard.rs @@ -1,10 +1,79 @@ use dioxus_core::Event; pub type ClipboardEvent = Event; -#[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] -#[derive(Debug, Clone, PartialEq, Eq)] + pub struct ClipboardData { - // DOMDataTransfer clipboardData + inner: Box, +} + +impl From for ClipboardData { + fn from(e: E) -> Self { + Self { inner: Box::new(e) } + } +} + +impl std::fmt::Debug for ClipboardData { + fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { + f.debug_struct("ClipboardData").finish() + } +} + +impl PartialEq for ClipboardData { + fn eq(&self, _other: &Self) -> bool { + true + } +} + +impl ClipboardData { + pub fn new(inner: impl HasClipboardData) -> Self { + Self { + inner: Box::new(inner), + } + } + + pub fn downcast(&self) -> Option<&T> { + self.inner.as_ref().as_any().downcast_ref::() + } +} + +#[cfg(feature = "serialize")] +#[derive(serde::Serialize, serde::Deserialize)] +struct SerializedClipboardData {} + +#[cfg(feature = "serialize")] +impl From<&ClipboardData> for SerializedClipboardData { + fn from(_: &ClipboardData) -> Self { + Self {} + } +} + +#[cfg(feature = "serialize")] +impl HasClipboardData for SerializedClipboardData { + fn as_any(&self) -> &dyn std::any::Any { + self + } +} + +#[cfg(feature = "serialize")] +impl serde::Serialize for ClipboardData { + fn serialize(&self, serializer: S) -> Result { + SerializedClipboardData::from(self).serialize(serializer) + } +} + +#[cfg(feature = "serialize")] +impl<'de> serde::Deserialize<'de> for ClipboardData { + fn deserialize>(deserializer: D) -> Result { + let data = SerializedClipboardData::deserialize(deserializer)?; + Ok(Self { + inner: Box::new(data), + }) + } +} + +pub trait HasClipboardData: std::any::Any { + /// return self as Any + fn as_any(&self) -> &dyn std::any::Any; } impl_event![ diff --git a/packages/html/src/events/composition.rs b/packages/html/src/events/composition.rs index 480868f24..bf2f6214e 100644 --- a/packages/html/src/events/composition.rs +++ b/packages/html/src/events/composition.rs @@ -1,10 +1,89 @@ use dioxus_core::Event; pub type CompositionEvent = Event; -#[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] -#[derive(Debug, Clone, PartialEq, Eq)] + pub struct CompositionData { - pub data: String, + inner: Box, +} + +impl std::fmt::Debug for CompositionData { + fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { + f.debug_struct("CompositionData") + .field("data", &self.data()) + .finish() + } +} + +impl From for CompositionData { + fn from(e: E) -> Self { + Self { inner: Box::new(e) } + } +} + +impl PartialEq for CompositionData { + fn eq(&self, other: &Self) -> bool { + self.data() == other.data() + } +} + +impl CompositionData { + pub fn data(&self) -> String { + self.inner.data() + } + + pub fn downcast(&self) -> Option<&T> { + self.inner.as_any().downcast_ref() + } +} + +#[cfg(feature = "serialize")] +#[derive(serde::Serialize, serde::Deserialize)] +struct SerializedCompositionData { + data: String, +} + +#[cfg(feature = "serialize")] +impl From<&CompositionData> for SerializedCompositionData { + fn from(data: &CompositionData) -> Self { + Self { data: data.data() } + } +} + +#[cfg(feature = "serialize")] +impl HasCompositionData for SerializedCompositionData { + fn data(&self) -> String { + self.data.clone() + } + + fn as_any(&self) -> &dyn std::any::Any { + self + } +} + +#[cfg(feature = "serialize")] +impl serde::Serialize for CompositionData { + fn serialize(&self, serializer: S) -> Result { + SerializedCompositionData::from(self).serialize(serializer) + } +} + +#[cfg(feature = "serialize")] +impl<'de> serde::Deserialize<'de> for CompositionData { + fn deserialize>(deserializer: D) -> Result { + let data = SerializedCompositionData::deserialize(deserializer)?; + Ok(Self { + inner: Box::new(data), + }) + } +} + +/// A trait for any object that has the data for a composition event +pub trait HasCompositionData: std::any::Any { + /// The characters generated by the input method that raised the event + fn data(&self) -> String; + + /// return self as Any + fn as_any(&self) -> &dyn std::any::Any; } impl_event! [ diff --git a/packages/html/src/events/drag.rs b/packages/html/src/events/drag.rs index fa3219631..f7575c494 100644 --- a/packages/html/src/events/drag.rs +++ b/packages/html/src/events/drag.rs @@ -1,6 +1,10 @@ +use crate::geometry::{ClientPoint, Coordinates, ElementPoint, PagePoint, ScreenPoint}; +use crate::input_data::{MouseButton, MouseButtonSet}; +use crate::prelude::PointInteraction; use dioxus_core::Event; +use keyboard_types::Modifiers; -use crate::MouseData; +use crate::HasMouseData; pub type DragEvent = Event; @@ -8,13 +12,179 @@ pub type DragEvent = Event; /// placing a pointer device (such as a mouse) on the touch surface and then dragging the pointer to a new location /// (such as another DOM element). Applications are free to interpret a drag and drop interaction in an /// application-specific way. -#[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] -#[derive(Debug, Clone, PartialEq, Eq)] pub struct DragData { - /// Inherit mouse data - pub mouse: MouseData, + inner: Box, } +impl From for DragData { + fn from(e: E) -> Self { + Self { inner: Box::new(e) } + } +} + +impl std::fmt::Debug for DragData { + fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { + f.debug_struct("DragData") + .field("coordinates", &self.coordinates()) + .field("modifiers", &self.modifiers()) + .field("held_buttons", &self.held_buttons()) + .field("trigger_button", &self.trigger_button()) + .finish() + } +} + +impl PartialEq for DragData { + fn eq(&self, other: &Self) -> bool { + self.coordinates() == other.coordinates() + && self.modifiers() == other.modifiers() + && self.held_buttons() == other.held_buttons() + && self.trigger_button() == other.trigger_button() + } +} + +impl DragData { + /// The event's coordinates relative to the application's viewport (as opposed to the coordinate within the page). + /// + /// For example, clicking in the top left corner of the viewport will always result in a mouse event with client coordinates (0., 0.), regardless of whether the page is scrolled horizontally. + pub fn client_coordinates(&self) -> ClientPoint { + self.inner.client_coordinates() + } + + /// The event's coordinates relative to the padding edge of the target element + /// + /// For example, clicking in the top left corner of an element will result in element coordinates (0., 0.) + pub fn element_coordinates(&self) -> ElementPoint { + self.inner.element_coordinates() + } + + /// The event's coordinates relative to the entire document. This includes any portion of the document not currently visible. + /// + /// For example, if the page is scrolled 200 pixels to the right and 300 pixels down, clicking in the top left corner of the viewport would result in page coordinates (200., 300.) + pub fn page_coordinates(&self) -> PagePoint { + self.inner.page_coordinates() + } + + /// The event's coordinates relative to the entire screen. This takes into account the window's offset. + pub fn screen_coordinates(&self) -> ScreenPoint { + self.inner.screen_coordinates() + } + + pub fn coordinates(&self) -> Coordinates { + self.inner.coordinates() + } + + /// The set of modifier keys which were pressed when the event occurred + pub fn modifiers(&self) -> Modifiers { + self.inner.modifiers() + } + + /// The set of mouse buttons which were held when the event occurred. + pub fn held_buttons(&self) -> MouseButtonSet { + self.inner.held_buttons() + } + + /// The mouse button that triggered the event + /// + // todo the following is kind of bad; should we just return None when the trigger_button is unreliable (and frankly irrelevant)? i guess we would need the event_type here + /// This is only guaranteed to indicate which button was pressed during events caused by pressing or releasing a button. As such, it is not reliable for events such as mouseenter, mouseleave, mouseover, mouseout, or mousemove. For example, a value of MouseButton::Primary may also indicate that no button was pressed. + pub fn trigger_button(&self) -> Option { + self.inner.trigger_button() + } + + /// Downcast this event data to a specific type + pub fn downcast(&self) -> Option<&T> { + self.inner.as_any().downcast_ref::() + } +} + +#[cfg(feature = "serialize")] +#[derive(serde::Serialize, serde::Deserialize)] +struct SerializedDragData { + mouse: crate::point_interaction::SerializedPointInteraction, +} + +#[cfg(feature = "serialize")] +impl From<&DragData> for SerializedDragData { + fn from(data: &DragData) -> Self { + Self { + mouse: crate::point_interaction::SerializedPointInteraction { + client_coordinates: data.client_coordinates(), + element_coordinates: data.element_coordinates(), + page_coordinates: data.page_coordinates(), + screen_coordinates: data.screen_coordinates(), + modifiers: data.modifiers(), + held_buttons: data.held_buttons(), + trigger_button: data.trigger_button(), + }, + } + } +} + +#[cfg(feature = "serialize")] +impl HasDragData for SerializedDragData {} + +#[cfg(feature = "serialize")] +impl HasMouseData for SerializedDragData { + fn as_any(&self) -> &dyn std::any::Any { + self + } +} + +#[cfg(feature = "serialize")] +impl PointInteraction for SerializedDragData { + fn client_coordinates(&self) -> ClientPoint { + self.mouse.client_coordinates() + } + + fn element_coordinates(&self) -> ElementPoint { + self.mouse.element_coordinates() + } + + fn page_coordinates(&self) -> PagePoint { + self.mouse.page_coordinates() + } + + fn screen_coordinates(&self) -> ScreenPoint { + self.mouse.screen_coordinates() + } + + fn coordinates(&self) -> Coordinates { + self.mouse.coordinates() + } + + fn modifiers(&self) -> Modifiers { + self.mouse.modifiers() + } + + fn held_buttons(&self) -> MouseButtonSet { + self.mouse.held_buttons() + } + + fn trigger_button(&self) -> Option { + self.mouse.trigger_button() + } +} + +#[cfg(feature = "serialize")] +impl serde::Serialize for DragData { + fn serialize(&self, serializer: S) -> Result { + SerializedDragData::from(self).serialize(serializer) + } +} + +#[cfg(feature = "serialize")] +impl<'de> serde::Deserialize<'de> for DragData { + fn deserialize>(deserializer: D) -> Result { + let data = SerializedDragData::deserialize(deserializer)?; + Ok(Self { + inner: Box::new(data), + }) + } +} + +/// A trait for any object that has the data for a drag event +pub trait HasDragData: HasMouseData {} + impl_event! { DragData; diff --git a/packages/html/src/events/focus.rs b/packages/html/src/events/focus.rs index 2092c972e..59e384f4a 100644 --- a/packages/html/src/events/focus.rs +++ b/packages/html/src/events/focus.rs @@ -2,9 +2,74 @@ use dioxus_core::Event; pub type FocusEvent = Event; -#[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] -#[derive(Debug, Clone, PartialEq, Eq)] -pub struct FocusData {/* DOMEventInner: Send + SyncTarget relatedTarget */} +pub struct FocusData { + inner: Box, +} + +impl From for FocusData { + fn from(e: E) -> Self { + Self { inner: Box::new(e) } + } +} + +impl std::fmt::Debug for FocusData { + fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { + f.debug_struct("FocusData").finish() + } +} + +impl PartialEq for FocusData { + fn eq(&self, _other: &Self) -> bool { + true + } +} + +impl FocusData { + /// Downcast this event data to a specific type + pub fn downcast(&self) -> Option<&T> { + self.inner.as_any().downcast_ref::() + } +} + +#[cfg(feature = "serialize")] +#[derive(serde::Serialize, serde::Deserialize)] +struct SerializedFocusData {} + +#[cfg(feature = "serialize")] +impl From<&FocusData> for SerializedFocusData { + fn from(_: &FocusData) -> Self { + Self {} + } +} + +#[cfg(feature = "serialize")] +impl HasFocusData for SerializedFocusData { + fn as_any(&self) -> &dyn std::any::Any { + self + } +} + +#[cfg(feature = "serialize")] +impl serde::Serialize for FocusData { + fn serialize(&self, serializer: S) -> Result { + SerializedFocusData::from(self).serialize(serializer) + } +} + +#[cfg(feature = "serialize")] +impl<'de> serde::Deserialize<'de> for FocusData { + fn deserialize>(deserializer: D) -> Result { + let data = SerializedFocusData::deserialize(deserializer)?; + Ok(Self { + inner: Box::new(data), + }) + } +} + +pub trait HasFocusData: std::any::Any { + /// return self as Any + fn as_any(&self) -> &dyn std::any::Any; +} impl_event! [ FocusData; diff --git a/packages/html/src/events/form.rs b/packages/html/src/events/form.rs index fab13482b..015559d64 100644 --- a/packages/html/src/events/form.rs +++ b/packages/html/src/events/form.rs @@ -4,28 +4,176 @@ use dioxus_core::Event; pub type FormEvent = Event; -/* DOMEvent: Send + SyncTarget relatedTarget */ -#[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] -#[derive(Clone)] pub struct FormData { - pub value: String, + inner: Box, +} - pub values: HashMap>, +impl From for FormData { + fn from(e: E) -> Self { + Self { inner: Box::new(e) } + } +} - #[cfg_attr( - feature = "serialize", - serde( - default, - skip_serializing, - deserialize_with = "deserialize_file_engine" - ) - )] - pub files: Option>, +impl PartialEq for FormData { + fn eq(&self, other: &Self) -> bool { + self.value() == other.value() && self.values() == other.values() + } +} + +impl Debug for FormData { + fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { + f.debug_struct("FormEvent") + .field("value", &self.value()) + .field("values", &self.values()) + .finish() + } +} + +impl FormData { + /// Create a new form event + pub fn new(event: impl HasFormData + 'static) -> Self { + Self { + inner: Box::new(event), + } + } + + /// Get the value of the form event + pub fn value(&self) -> String { + self.inner.value() + } + + /// Get the values of the form event + pub fn values(&self) -> HashMap> { + self.inner.values() + } + + /// Get the files of the form event + pub fn files(&self) -> Option> { + self.inner.files() + } + + /// Downcast this event to a concrete event type + pub fn downcast(&self) -> Option<&T> { + self.inner.as_any().downcast_ref::() + } +} + +/// An object that has all the data for a form event +pub trait HasFormData: std::any::Any { + fn value(&self) -> String { + Default::default() + } + + fn values(&self) -> HashMap> { + Default::default() + } + + fn files(&self) -> Option> { + None + } + + /// return self as Any + fn as_any(&self) -> &dyn std::any::Any; } #[cfg(feature = "serialize")] +/// A serialized form data object #[derive(serde::Serialize, serde::Deserialize)] -struct SerializedFileEngine { +pub struct SerializedFormData { + value: String, + values: HashMap>, + files: Option>, +} + +#[cfg(feature = "serialize")] +impl SerializedFormData { + /// Create a new serialized form data object + pub fn new( + value: String, + values: HashMap>, + files: Option>, + ) -> Self { + Self { + value, + values, + files, + } + } + + /// Create a new serialized form data object from a traditional form data object + pub async fn async_from(data: &FormData) -> Self { + Self { + value: data.value(), + values: data.values(), + files: match data.files() { + Some(files) => { + let mut resolved_files = HashMap::new(); + + for file in files.files() { + let bytes = files.read_file(&file).await; + resolved_files.insert(file, bytes.unwrap_or_default()); + } + + Some(std::sync::Arc::new(SerializedFileEngine { + files: resolved_files, + })) + } + None => None, + }, + } + } + + fn from_lossy(data: &FormData) -> Self { + Self { + value: data.value(), + values: data.values(), + files: None, + } + } +} + +#[cfg(feature = "serialize")] +impl HasFormData for SerializedFormData { + fn value(&self) -> String { + self.value.clone() + } + + fn values(&self) -> HashMap> { + self.values.clone() + } + + fn files(&self) -> Option> { + self.files + .as_ref() + .map(|files| std::sync::Arc::clone(files) as std::sync::Arc) + } + + fn as_any(&self) -> &dyn std::any::Any { + self + } +} + +#[cfg(feature = "serialize")] +impl serde::Serialize for FormData { + fn serialize(&self, serializer: S) -> Result { + SerializedFormData::from_lossy(self).serialize(serializer) + } +} + +#[cfg(feature = "serialize")] +impl<'de> serde::Deserialize<'de> for FormData { + fn deserialize>(deserializer: D) -> Result { + let data = SerializedFormData::deserialize(deserializer)?; + Ok(Self { + inner: Box::new(data), + }) + } +} + +#[cfg(feature = "serialize")] +/// A file engine that serializes files to bytes +#[derive(serde::Serialize, serde::Deserialize)] +pub struct SerializedFileEngine { files: HashMap>, } @@ -53,38 +201,6 @@ impl FileEngine for SerializedFileEngine { } } -#[cfg(feature = "serialize")] -fn deserialize_file_engine<'de, D>( - deserializer: D, -) -> Result>, D::Error> -where - D: serde::Deserializer<'de>, -{ - use serde::Deserialize; - - let Ok(file_engine) = SerializedFileEngine::deserialize(deserializer) else { - return Ok(None); - }; - - let file_engine = std::sync::Arc::new(file_engine); - Ok(Some(file_engine)) -} - -impl PartialEq for FormData { - fn eq(&self, other: &Self) -> bool { - self.value == other.value && self.values == other.values - } -} - -impl Debug for FormData { - fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { - f.debug_struct("FormEvent") - .field("value", &self.value) - .field("values", &self.values) - .finish() - } -} - #[async_trait::async_trait(?Send)] pub trait FileEngine { // get a list of file names diff --git a/packages/html/src/events/image.rs b/packages/html/src/events/image.rs index d5858a7f1..cf46838b7 100644 --- a/packages/html/src/events/image.rs +++ b/packages/html/src/events/image.rs @@ -1,11 +1,91 @@ use dioxus_core::Event; pub type ImageEvent = Event; -#[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] -#[derive(Debug, Clone, PartialEq, Eq)] pub struct ImageData { - #[cfg_attr(feature = "serialize", serde(default))] - pub load_error: bool, + inner: Box, +} + +impl From for ImageData { + fn from(e: E) -> Self { + Self { inner: Box::new(e) } + } +} + +impl std::fmt::Debug for ImageData { + fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { + f.debug_struct("ImageData") + .field("load_error", &self.load_error()) + .finish() + } +} + +impl PartialEq for ImageData { + fn eq(&self, other: &Self) -> bool { + self.load_error() == other.load_error() + } +} + +impl ImageData { + /// If the renderer encountered an error while loading the image + pub fn load_error(&self) -> bool { + self.inner.load_error() + } + + pub fn downcast(&self) -> Option<&T> { + self.inner.as_any().downcast_ref::() + } +} + +#[cfg(feature = "serialize")] +#[derive(serde::Serialize, serde::Deserialize)] +struct SerializedImageData { + load_error: bool, +} + +#[cfg(feature = "serialize")] +impl From<&ImageData> for SerializedImageData { + fn from(data: &ImageData) -> Self { + Self { + load_error: data.load_error(), + } + } +} + +#[cfg(feature = "serialize")] +impl HasImageData for SerializedImageData { + fn as_any(&self) -> &dyn std::any::Any { + self + } + + fn load_error(&self) -> bool { + self.load_error + } +} + +#[cfg(feature = "serialize")] +impl serde::Serialize for ImageData { + fn serialize(&self, serializer: S) -> Result { + SerializedImageData::from(self).serialize(serializer) + } +} + +#[cfg(feature = "serialize")] +impl<'de> serde::Deserialize<'de> for ImageData { + fn deserialize>(deserializer: D) -> Result { + let data = SerializedImageData::deserialize(deserializer)?; + Ok(Self { + inner: Box::new(data), + }) + } +} + +/// A trait for any object that has the data for an image event +pub trait HasImageData: std::any::Any { + /// If the renderer encountered an error while loading the image + fn load_error(&self) -> bool; + + /// return self as Any + fn as_any(&self) -> &dyn std::any::Any; } impl_event! [ diff --git a/packages/html/src/events/keyboard.rs b/packages/html/src/events/keyboard.rs index d00dcf8d2..07fc00871 100644 --- a/packages/html/src/events/keyboard.rs +++ b/packages/html/src/events/keyboard.rs @@ -1,9 +1,7 @@ -use crate::input_data::{decode_key_location, encode_key_location}; use dioxus_core::Event; use keyboard_types::{Code, Key, Location, Modifiers}; use std::convert::TryInto; -use std::fmt::{Debug, Formatter}; -use std::str::FromStr; +use std::fmt::Debug; #[cfg(feature = "serialize")] fn resilient_deserialize_code<'de, D>(deserializer: D) -> Result @@ -16,57 +14,136 @@ where } pub type KeyboardEvent = Event; -#[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] -#[derive(Clone, PartialEq, Eq)] pub struct KeyboardData { - #[deprecated( - since = "0.3.0", - note = "This may not work in all environments. Use key() instead." - )] - pub char_code: u32, + inner: Box, +} - /// Identify which "key" was entered. - #[deprecated(since = "0.3.0", note = "use key() instead")] - pub key: String, +impl From for KeyboardData { + fn from(e: E) -> Self { + Self { inner: Box::new(e) } + } +} - /// Get the key code as an enum Variant. - #[deprecated( - since = "0.3.0", - note = "This may not work in all environments. Use code() instead." - )] - pub key_code: KeyCode, +impl std::fmt::Debug for KeyboardData { + fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { + f.debug_struct("KeyboardData") + .field("key", &self.key()) + .field("code", &self.code()) + .field("modifiers", &self.modifiers()) + .field("location", &self.location()) + .field("is_auto_repeating", &self.is_auto_repeating()) + .finish() + } +} - /// the physical key on the keyboard - #[cfg_attr( - feature = "serialize", - serde(deserialize_with = "resilient_deserialize_code") - )] +impl PartialEq for KeyboardData { + fn eq(&self, other: &Self) -> bool { + self.key() == other.key() + && self.code() == other.code() + && self.modifiers() == other.modifiers() + && self.location() == other.location() + && self.is_auto_repeating() == other.is_auto_repeating() + } +} + +impl KeyboardData { + /// The value of the key pressed by the user, taking into consideration the state of modifier keys such as Shift as well as the keyboard locale and layout. + pub fn key(&self) -> Key { + self.inner.key() + } + + /// A physical key on the keyboard (as opposed to the character generated by pressing the key). In other words, this property returns a value that isn't altered by keyboard layout or the state of the modifier keys. + pub fn code(&self) -> Code { + self.inner.code() + } + + /// The set of modifier keys which were pressed when the event occurred + pub fn modifiers(&self) -> Modifiers { + self.inner.modifiers() + } + + /// The location of the key on the keyboard or other input device. + pub fn location(&self) -> Location { + self.inner.location() + } + + /// `true` iff the key is being held down such that it is automatically repeating. + pub fn is_auto_repeating(&self) -> bool { + self.inner.is_auto_repeating() + } + + /// Downcast this KeyboardData to a concrete type. + pub fn downcast(&self) -> Option<&T> { + self.inner.as_any().downcast_ref::() + } +} + +#[cfg(feature = "serialize")] +#[derive(serde::Serialize, serde::Deserialize)] +struct SerializedKeyboardData { + auto_repeating: bool, + #[serde(deserialize_with = "resilient_deserialize_code")] code: Code, + key: Key, + location: Location, + modifiers: Modifiers, +} - /// Indicate if the `alt` modifier key was pressed during this keyboard event - #[deprecated(since = "0.3.0", note = "use modifiers() instead")] - pub alt_key: bool, +#[cfg(feature = "serialize")] +impl From<&KeyboardData> for SerializedKeyboardData { + fn from(data: &KeyboardData) -> Self { + Self { + auto_repeating: data.is_auto_repeating(), + code: data.code(), + key: data.key(), + location: data.location(), + modifiers: data.modifiers(), + } + } +} - /// Indicate if the `ctrl` modifier key was pressed during this keyboard event - #[deprecated(since = "0.3.0", note = "use modifiers() instead")] - pub ctrl_key: bool, +#[cfg(feature = "serialize")] +impl HasKeyboardData for SerializedKeyboardData { + fn key(&self) -> Key { + self.key.clone() + } - /// Indicate if the `meta` modifier key was pressed during this keyboard event - #[deprecated(since = "0.3.0", note = "use modifiers() instead")] - pub meta_key: bool, + fn code(&self) -> Code { + self.code + } - /// Indicate if the `shift` modifier key was pressed during this keyboard event - #[deprecated(since = "0.3.0", note = "use modifiers() instead")] - pub shift_key: bool, + fn modifiers(&self) -> Modifiers { + self.modifiers + } - #[deprecated(since = "0.3.0", note = "use location() instead")] - pub location: usize, + fn location(&self) -> Location { + self.location + } - #[deprecated(since = "0.3.0", note = "use is_auto_repeating() instead")] - pub repeat: bool, + fn is_auto_repeating(&self) -> bool { + self.auto_repeating + } - #[deprecated(since = "0.3.0", note = "use code() or key() instead")] - pub which: usize, + fn as_any(&self) -> &dyn std::any::Any { + self + } +} + +#[cfg(feature = "serialize")] +impl serde::Serialize for KeyboardData { + fn serialize(&self, serializer: S) -> Result { + SerializedKeyboardData::from(self).serialize(serializer) + } +} + +#[cfg(feature = "serialize")] +impl<'de> serde::Deserialize<'de> for KeyboardData { + fn deserialize>(deserializer: D) -> Result { + let data = SerializedKeyboardData::deserialize(deserializer)?; + Ok(Self { + inner: Box::new(data), + }) + } } impl_event! { @@ -82,94 +159,24 @@ impl_event! { onkeyup } -impl KeyboardData { - pub fn new( - key: Key, - code: Code, - location: Location, - is_auto_repeating: bool, - modifiers: Modifiers, - ) -> Self { - #[allow(deprecated)] - KeyboardData { - char_code: key.legacy_charcode(), - key: key.to_string(), - key_code: KeyCode::from_raw_code( - key.legacy_keycode() - .try_into() - .expect("could not convert keycode to u8"), - ), - code, - alt_key: modifiers.contains(Modifiers::ALT), - ctrl_key: modifiers.contains(Modifiers::CONTROL), - meta_key: modifiers.contains(Modifiers::META), - shift_key: modifiers.contains(Modifiers::SHIFT), - location: encode_key_location(location), - repeat: is_auto_repeating, - which: key - .legacy_charcode() - .try_into() - .expect("could not convert charcode to usize"), - } - } - +pub trait HasKeyboardData: std::any::Any { /// The value of the key pressed by the user, taking into consideration the state of modifier keys such as Shift as well as the keyboard locale and layout. - pub fn key(&self) -> Key { - #[allow(deprecated)] - FromStr::from_str(&self.key).unwrap_or(Key::Unidentified) - } + fn key(&self) -> Key; /// A physical key on the keyboard (as opposed to the character generated by pressing the key). In other words, this property returns a value that isn't altered by keyboard layout or the state of the modifier keys. - pub fn code(&self) -> Code { - self.code - } + fn code(&self) -> Code; /// The set of modifier keys which were pressed when the event occurred - pub fn modifiers(&self) -> Modifiers { - let mut modifiers = Modifiers::empty(); - - #[allow(deprecated)] - { - if self.alt_key { - modifiers.insert(Modifiers::ALT); - } - if self.ctrl_key { - modifiers.insert(Modifiers::CONTROL); - } - if self.meta_key { - modifiers.insert(Modifiers::META); - } - if self.shift_key { - modifiers.insert(Modifiers::SHIFT); - } - } - - modifiers - } + fn modifiers(&self) -> Modifiers; /// The location of the key on the keyboard or other input device. - pub fn location(&self) -> Location { - #[allow(deprecated)] - decode_key_location(self.location) - } + fn location(&self) -> Location; /// `true` iff the key is being held down such that it is automatically repeating. - pub fn is_auto_repeating(&self) -> bool { - #[allow(deprecated)] - self.repeat - } -} + fn is_auto_repeating(&self) -> bool; -impl Debug for KeyboardData { - fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result { - f.debug_struct("KeyboardData") - .field("key", &self.key()) - .field("code", &self.code()) - .field("modifiers", &self.modifiers()) - .field("location", &self.location()) - .field("is_auto_repeating", &self.is_auto_repeating()) - .finish() - } + /// return self as Any + fn as_any(&self) -> &dyn std::any::Any; } #[cfg(feature = "serialize")] diff --git a/packages/html/src/events/media.rs b/packages/html/src/events/media.rs index d2ba71c08..e088bd2a5 100644 --- a/packages/html/src/events/media.rs +++ b/packages/html/src/events/media.rs @@ -1,9 +1,74 @@ use dioxus_core::Event; pub type MediaEvent = Event; -#[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] -#[derive(Debug, Clone, PartialEq, Eq)] -pub struct MediaData {} +pub struct MediaData { + inner: Box, +} + +impl From for MediaData { + fn from(e: E) -> Self { + Self { inner: Box::new(e) } + } +} + +impl std::fmt::Debug for MediaData { + fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { + f.debug_struct("MediaData").finish() + } +} + +impl PartialEq for MediaData { + fn eq(&self, _: &Self) -> bool { + true + } +} + +impl MediaData { + /// Downcast this event to a concrete event type + pub fn downcast(&self) -> Option<&T> { + self.inner.as_any().downcast_ref::() + } +} + +#[cfg(feature = "serialize")] +#[derive(serde::Serialize, serde::Deserialize)] +struct SerializedMediaData {} + +#[cfg(feature = "serialize")] +impl From<&MediaData> for SerializedMediaData { + fn from(_: &MediaData) -> Self { + Self {} + } +} + +#[cfg(feature = "serialize")] +impl HasMediaData for SerializedMediaData { + fn as_any(&self) -> &dyn std::any::Any { + self + } +} + +#[cfg(feature = "serialize")] +impl serde::Serialize for MediaData { + fn serialize(&self, serializer: S) -> Result { + SerializedMediaData::from(self).serialize(serializer) + } +} + +#[cfg(feature = "serialize")] +impl<'de> serde::Deserialize<'de> for MediaData { + fn deserialize>(deserializer: D) -> Result { + let data = SerializedMediaData::deserialize(deserializer)?; + Ok(Self { + inner: Box::new(data), + }) + } +} + +pub trait HasMediaData: std::any::Any { + /// return self as Any + fn as_any(&self) -> &dyn std::any::Any; +} impl_event! [ MediaData; @@ -29,7 +94,7 @@ impl_event! [ ///ended onended - // todo: this conflicts with image events + // todo: this conflicts with Media events // neither have data, so it's okay // ///error // onerror diff --git a/packages/html/src/events/mounted.rs b/packages/html/src/events/mounted.rs index bc561bf1b..e3908ca8a 100644 --- a/packages/html/src/events/mounted.rs +++ b/packages/html/src/events/mounted.rs @@ -3,22 +3,18 @@ use euclid::Rect; use std::{ - any::Any, fmt::{Display, Formatter}, future::Future, pin::Pin, - rc::Rc, }; /// An Element that has been rendered and allows reading and modifying information about it. /// /// Different platforms will have different implementations and different levels of support for this trait. Renderers that do not support specific features will return `None` for those queries. // we can not use async_trait here because it does not create a trait that is object safe -pub trait RenderedElementBacking { - /// Get the renderer specific element for the given id - fn get_raw_element(&self) -> MountedResult<&dyn Any> { - Err(MountedError::NotSupported) - } +pub trait RenderedElementBacking: std::any::Any { + /// return self as Any + fn as_any(&self) -> &dyn std::any::Any; /// Get the bounding rectangle of the element relative to the viewport (this does not include the scroll position) #[allow(clippy::type_complexity)] @@ -40,7 +36,11 @@ pub trait RenderedElementBacking { } } -impl RenderedElementBacking for () {} +impl RenderedElementBacking for () { + fn as_any(&self) -> &dyn std::any::Any { + self + } +} /// The way that scrolling should be performed #[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] @@ -57,22 +57,23 @@ pub enum ScrollBehavior { /// /// Different platforms will have different implementations and different levels of support for this trait. Renderers that do not support specific features will return `None` for those queries. pub struct MountedData { - inner: Rc, + inner: Box, +} + +impl From for MountedData { + fn from(e: E) -> Self { + Self { inner: Box::new(e) } + } } impl MountedData { /// Create a new MountedData pub fn new(registry: impl RenderedElementBacking + 'static) -> Self { Self { - inner: Rc::new(registry), + inner: Box::new(registry), } } - /// Get the renderer specific element for the given id - pub fn get_raw_element(&self) -> MountedResult<&dyn Any> { - self.inner.get_raw_element() - } - /// Get the bounding rectangle of the element relative to the viewport (this does not include the scroll position) pub async fn get_client_rect(&self) -> MountedResult> { self.inner.get_client_rect().await @@ -90,6 +91,11 @@ impl MountedData { pub fn set_focus(&self, focus: bool) -> Pin>>> { self.inner.set_focus(focus) } + + /// Downcast this event to a concrete event type + pub fn downcast(&self) -> Option<&T> { + self.inner.as_any().downcast_ref::() + } } use dioxus_core::Event; diff --git a/packages/html/src/events/mouse.rs b/packages/html/src/events/mouse.rs index 74b7bdfb9..6c346a434 100644 --- a/packages/html/src/events/mouse.rs +++ b/packages/html/src/events/mouse.rs @@ -1,16 +1,47 @@ -use crate::point_interaction::{PointData, PointInteraction}; +use crate::geometry::{ClientPoint, Coordinates, ElementPoint, PagePoint, ScreenPoint}; +use crate::input_data::{MouseButton, MouseButtonSet}; +use crate::point_interaction::PointInteraction; use dioxus_core::Event; +use keyboard_types::Modifiers; pub type MouseEvent = Event; /// A synthetic event that wraps a web-style [`MouseEvent`](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent) -#[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] -#[derive(Debug, Clone, Default, PartialEq, Eq)] /// Data associated with a mouse event pub struct MouseData { - /// Common data for all pointer/mouse events - #[cfg_attr(feature = "serialize", serde(flatten))] - point_data: PointData, + inner: Box, +} + +impl From for MouseData { + fn from(e: E) -> Self { + Self { inner: Box::new(e) } + } +} + +impl std::fmt::Debug for MouseData { + fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { + f.debug_struct("MouseData") + .field("coordinates", &self.coordinates()) + .field("modifiers", &self.modifiers()) + .field("held_buttons", &self.held_buttons()) + .field("trigger_button", &self.trigger_button()) + .finish() + } +} + +impl PartialEq for MouseData { + fn eq(&self, other: &E) -> bool { + self.coordinates() == other.coordinates() + && self.modifiers() == other.modifiers() + && self.held_buttons() == other.held_buttons() + && self.trigger_button() == other.trigger_button() + } +} + +/// A trait for any object that has the data for a mouse event +pub trait HasMouseData: PointInteraction { + /// return self as Any + fn as_any(&self) -> &dyn std::any::Any; } impl_event! { @@ -75,16 +106,91 @@ impl_event! { } impl MouseData { - /// Construct MouseData with the specified properties - /// - /// Note: the current implementation truncates coordinates. In the future, when we change the internal representation, it may also support a fractional part. - pub fn new(point_data: PointData) -> Self { - Self { point_data } + /// Downcast this event to a concrete event type + pub fn downcast(&self) -> Option<&T> { + self.inner.as_any().downcast_ref::() } } impl PointInteraction for MouseData { - fn get_point_data(&self) -> PointData { - self.point_data + /// The event's coordinates relative to the application's viewport (as opposed to the coordinate within the page). + /// + /// For example, clicking in the top left corner of the viewport will always result in a mouse event with client coordinates (0., 0.), regardless of whether the page is scrolled horizontally. + fn client_coordinates(&self) -> ClientPoint { + self.inner.client_coordinates() + } + + /// The event's coordinates relative to the padding edge of the target element + /// + /// For example, clicking in the top left corner of an element will result in element coordinates (0., 0.) + fn element_coordinates(&self) -> ElementPoint { + self.inner.element_coordinates() + } + + /// The event's coordinates relative to the entire document. This includes any portion of the document not currently visible. + /// + /// For example, if the page is scrolled 200 pixels to the right and 300 pixels down, clicking in the top left corner of the viewport would result in page coordinates (200., 300.) + fn page_coordinates(&self) -> PagePoint { + self.inner.page_coordinates() + } + + /// The event's coordinates relative to the entire screen. This takes into account the window's offset. + fn screen_coordinates(&self) -> ScreenPoint { + self.inner.screen_coordinates() + } + + fn coordinates(&self) -> Coordinates { + self.inner.coordinates() + } + + /// The set of modifier keys which were pressed when the event occurred + fn modifiers(&self) -> Modifiers { + self.inner.modifiers() + } + + /// The set of mouse buttons which were held when the event occurred. + fn held_buttons(&self) -> MouseButtonSet { + self.inner.held_buttons() + } + + /// The mouse button that triggered the event + /// + // todo the following is kind of bad; should we just return None when the trigger_button is unreliable (and frankly irrelevant)? i guess we would need the event_type here + /// This is only guaranteed to indicate which button was pressed during events caused by pressing or releasing a button. As such, it is not reliable for events such as mouseenter, mouseleave, mouseover, mouseout, or mousemove. For example, a value of MouseButton::Primary may also indicate that no button was pressed. + fn trigger_button(&self) -> Option { + self.inner.trigger_button() + } +} + +impl PartialEq for MouseData { + fn eq(&self, other: &Self) -> bool { + self.coordinates() == other.coordinates() + && self.modifiers() == other.modifiers() + && self.held_buttons() == other.held_buttons() + && self.trigger_button() == other.trigger_button() + } +} + +#[cfg(feature = "serialize")] +impl HasMouseData for crate::point_interaction::SerializedPointInteraction { + fn as_any(&self) -> &dyn std::any::Any { + self + } +} + +#[cfg(feature = "serialize")] +impl serde::Serialize for MouseData { + fn serialize(&self, serializer: S) -> Result { + crate::point_interaction::SerializedPointInteraction::from(self).serialize(serializer) + } +} + +#[cfg(feature = "serialize")] +impl<'de> serde::Deserialize<'de> for MouseData { + fn deserialize>(deserializer: D) -> Result { + let data = crate::point_interaction::SerializedPointInteraction::deserialize(deserializer)?; + Ok(Self { + inner: Box::new(data), + }) } } diff --git a/packages/html/src/events/pointer.rs b/packages/html/src/events/pointer.rs index 9277568d0..266dd7c66 100644 --- a/packages/html/src/events/pointer.rs +++ b/packages/html/src/events/pointer.rs @@ -1,58 +1,87 @@ -use std::fmt::Debug; - use dioxus_core::Event; +use keyboard_types::Modifiers; -use crate::point_interaction::{PointData, PointInteraction}; +use crate::{geometry::*, input_data::*, point_interaction::PointInteraction}; /// A synthetic event that wraps a web-style [`PointerEvent`](https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent) pub type PointerEvent = Event; -#[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] -#[derive(Debug, Clone, PartialEq)] pub struct PointerData { - /// Common data for all pointer/mouse events - #[cfg_attr(feature = "serialize", serde(flatten))] - point_data: PointData, + inner: Box, +} - /// The unique identifier of the pointer causing the event. - #[deprecated(since = "0.5.0", note = "use pointer_id() instead")] - pub pointer_id: i32, +impl From for PointerData { + fn from(e: E) -> Self { + Self { inner: Box::new(e) } + } +} - /// The width (magnitude on the X axis), in CSS pixels, of the contact geometry of the pointer. - #[deprecated(since = "0.5.0", note = "use width() instead")] - pub width: i32, +impl std::fmt::Debug for PointerData { + fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { + f.debug_struct("PointerData") + .field("pointer_id", &self.pointer_id()) + .field("width", &self.width()) + .field("height", &self.height()) + .field("pressure", &self.pressure()) + .field("tangential_pressure", &self.tangential_pressure()) + .field("tilt_x", &self.tilt_x()) + .field("tilt_y", &self.tilt_y()) + .field("twist", &self.twist()) + .field("pointer_type", &self.pointer_type()) + .field("is_primary", &self.is_primary()) + .finish() + } +} - /// The height (magnitude on the Y axis), in CSS pixels, of the contact geometry of the pointer. - #[deprecated(since = "0.5.0", note = "use height() instead")] - pub height: i32, +impl PartialEq for PointerData { + fn eq(&self, other: &Self) -> bool { + self.pointer_id() == other.pointer_id() + && self.width() == other.width() + && self.height() == other.height() + && self.pressure() == other.pressure() + && self.tangential_pressure() == other.tangential_pressure() + && self.tilt_x() == other.tilt_x() + && self.tilt_y() == other.tilt_y() + && self.twist() == other.twist() + && self.pointer_type() == other.pointer_type() + && self.is_primary() == other.is_primary() + } +} - /// The normalized pressure of the pointer input in the range of 0 to 1, - #[deprecated(since = "0.5.0", note = "use pressure() instead")] - pub pressure: f32, +/// A trait for any object that has the data for a pointer event +pub trait HasPointerData: PointInteraction { + /// Gets the unique identifier of the pointer causing the event. + fn pointer_id(&self) -> i32; - /// The normalized tangential pressure of the pointer input (also known as barrel pressure or cylinder stress) in the range -1 to 1, - #[deprecated(since = "0.5.0", note = "use tangential_pressure() instead")] - pub tangential_pressure: f32, + /// Gets the width (magnitude on the X axis), in CSS pixels, of the contact geometry of the pointer. + fn width(&self) -> i32; - /// The plane angle (in degrees, in the range of -90 to 90) between the Y-Z plane and the plane containing both the transducer (e.g. pen stylus) axis and the Y axis. - #[deprecated(since = "0.5.0", note = "use tilt_x() instead")] - pub tilt_x: i32, + /// Gets the height (magnitude on the Y axis), in CSS pixels, of the contact geometry of the pointer. + fn height(&self) -> i32; - /// The plane angle (in degrees, in the range of -90 to 90) between the X-Z plane and the plane containing both the transducer (e.g. pen stylus) axis and the X axis. - #[deprecated(since = "0.5.0", note = "use tilt_y() instead")] - pub tilt_y: i32, + /// Gets the normalized pressure of the pointer input in the range of 0 to 1, + fn pressure(&self) -> f32; - /// The clockwise rotation of the pointer (e.g. pen stylus) around its major axis in degrees, with a value in the range 0 to 359.The clockwise rotation of the pointer (e.g. pen stylus) around its major axis in degrees, with a value in the range 0 to 359. - #[deprecated(since = "0.5.0", note = "use twist() instead")] - pub twist: i32, + /// Gets the normalized tangential pressure of the pointer input (also known as barrel pressure or cylinder stress) in the range -1 to 1, + fn tangential_pressure(&self) -> f32; - /// Indicates the device type that caused the event (mouse, pen, touch, etc.). - #[deprecated(since = "0.5.0", note = "use pointer_type() instead")] - pub pointer_type: String, + /// Gets the plane angle (in degrees, in the range of -90 to 90) between the Y-Z plane and the plane containing both the transducer (e.g. pen stylus) axis and the Y axis. + fn tilt_x(&self) -> i32; - /// Indicates if the pointer represents the primary pointer of this pointer type. - #[deprecated(since = "0.5.0", note = "use is_primary() instead")] - pub is_primary: bool, + /// Gets the plane angle (in degrees, in the range of -90 to 90) between the X-Z plane and the plane containing both the transducer (e.g. pen stylus) axis and the X axis. + fn tilt_y(&self) -> i32; + + /// Gets the clockwise rotation of the pointer (e.g. pen stylus) around its major axis in degrees, with a value in the range 0 to 359.The clockwise rotation of the pointer (e.g. pen stylus) around its major axis in degrees, with a value in the range 0 to 359. + fn twist(&self) -> i32; + + /// Gets the device type that caused the event (mouse, pen, touch, etc.). + fn pointer_type(&self) -> String; + + /// Gets if the pointer represents the primary pointer of this pointer type. + fn is_primary(&self) -> bool; + + /// return self as Any + fn as_any(&self) -> &dyn std::any::Any; } impl_event![ @@ -89,99 +118,235 @@ impl_event![ ]; impl PointerData { - #[allow(clippy::too_many_arguments)] - pub fn new( - point_data: PointData, - pointer_id: i32, - width: i32, - height: i32, - pressure: f32, - tangential_pressure: f32, - tilt_x: i32, - tilt_y: i32, - twist: i32, - pointer_type: String, - is_primary: bool, - ) -> Self { - #[allow(deprecated)] - Self { - point_data, - pointer_id, - width, - height, - pressure, - tangential_pressure, - tilt_x, - tilt_y, - twist, - pointer_type, - is_primary, - } - } - /// Gets the unique identifier of the pointer causing the event. pub fn pointer_id(&self) -> i32 { - #[allow(deprecated)] - self.pointer_id + self.inner.pointer_id() } /// Gets the width (magnitude on the X axis), in CSS pixels, of the contact geometry of the pointer. pub fn width(&self) -> i32 { - #[allow(deprecated)] - self.width + self.inner.width() } /// Gets the height (magnitude on the Y axis), in CSS pixels, of the contact geometry of the pointer. pub fn height(&self) -> i32 { - #[allow(deprecated)] - self.height + self.inner.height() } /// Gets the normalized pressure of the pointer input in the range of 0 to 1, pub fn pressure(&self) -> f32 { - #[allow(deprecated)] - self.pressure + self.inner.pressure() } /// Gets the normalized tangential pressure of the pointer input (also known as barrel pressure or cylinder stress) in the range -1 to 1, pub fn tangential_pressure(&self) -> f32 { - #[allow(deprecated)] - self.tangential_pressure + self.inner.tangential_pressure() } /// Gets the plane angle (in degrees, in the range of -90 to 90) between the Y-Z plane and the plane containing both the transducer (e.g. pen stylus) axis and the Y axis. pub fn tilt_x(&self) -> i32 { - #[allow(deprecated)] - self.tilt_x + self.inner.tilt_x() } /// Gets the plane angle (in degrees, in the range of -90 to 90) between the X-Z plane and the plane containing both the transducer (e.g. pen stylus) axis and the X axis. pub fn tilt_y(&self) -> i32 { - #[allow(deprecated)] - self.tilt_y + self.inner.tilt_y() } /// Gets the clockwise rotation of the pointer (e.g. pen stylus) around its major axis in degrees, with a value in the range 0 to 359.The clockwise rotation of the pointer (e.g. pen stylus) around its major axis in degrees, with a value in the range 0 to 359. pub fn twist(&self) -> i32 { - #[allow(deprecated)] - self.twist + self.inner.twist() } /// Gets the device type that caused the event (mouse, pen, touch, etc.). - pub fn pointer_type(&self) -> &str { - #[allow(deprecated)] - self.pointer_type.as_str() + pub fn pointer_type(&self) -> String { + self.inner.pointer_type() } /// Gets if the pointer represents the primary pointer of this pointer type. pub fn is_primary(&self) -> bool { - #[allow(deprecated)] - self.is_primary + self.inner.is_primary() } } impl PointInteraction for PointerData { - fn get_point_data(&self) -> PointData { - self.point_data + fn client_coordinates(&self) -> ClientPoint { + self.inner.client_coordinates() + } + + fn screen_coordinates(&self) -> ScreenPoint { + self.inner.screen_coordinates() + } + + fn element_coordinates(&self) -> ElementPoint { + self.inner.element_coordinates() + } + + fn page_coordinates(&self) -> PagePoint { + self.inner.page_coordinates() + } + + fn modifiers(&self) -> Modifiers { + self.inner.modifiers() + } + + fn held_buttons(&self) -> MouseButtonSet { + self.inner.held_buttons() + } + + fn trigger_button(&self) -> Option { + self.inner.trigger_button() + } +} + +#[cfg(feature = "serialize")] +#[derive(serde::Serialize, serde::Deserialize)] +struct SerializedPointData { + /// Common data for all pointer/mouse events + #[serde(flatten)] + point_data: crate::point_interaction::SerializedPointInteraction, + + /// The unique identifier of the pointer causing the event. + pointer_id: i32, + + /// The width (magnitude on the X axis), in CSS pixels, of the contact geometry of the pointer. + width: i32, + + /// The height (magnitude on the Y axis), in CSS pixels, of the contact geometry of the pointer. + height: i32, + + /// The normalized pressure of the pointer input in the range of 0 to 1, + pressure: f32, + + /// The normalized tangential pressure of the pointer input (also known as barrel pressure or cylinder stress) in the range -1 to 1, + tangential_pressure: f32, + + /// The plane angle (in degrees, in the range of -90 to 90) between the Y-Z plane and the plane containing both the transducer (e.g. pen stylus) axis and the Y axis. + tilt_x: i32, + + /// The plane angle (in degrees, in the range of -90 to 90) between the X-Z plane and the plane containing both the transducer (e.g. pen stylus) axis and the X axis. + tilt_y: i32, + + /// The clockwise rotation of the pointer (e.g. pen stylus) around its major axis in degrees, with a value in the range 0 to 359.The clockwise rotation of the pointer (e.g. pen stylus) around its major axis in degrees, with a value in the range 0 to 359. + twist: i32, + + /// Indicates the device type that caused the event (mouse, pen, touch, etc.). + pointer_type: String, + + /// Indicates if the pointer represents the primary pointer of this pointer type. + is_primary: bool, +} + +#[cfg(feature = "serialize")] +impl HasPointerData for SerializedPointData { + fn pointer_id(&self) -> i32 { + self.pointer_id + } + + fn width(&self) -> i32 { + self.width + } + + fn height(&self) -> i32 { + self.height + } + + fn pressure(&self) -> f32 { + self.pressure + } + + fn tangential_pressure(&self) -> f32 { + self.tangential_pressure + } + + fn tilt_x(&self) -> i32 { + self.tilt_x + } + + fn tilt_y(&self) -> i32 { + self.tilt_y + } + + fn twist(&self) -> i32 { + self.twist + } + + fn pointer_type(&self) -> String { + self.pointer_type.clone() + } + + fn is_primary(&self) -> bool { + self.is_primary + } + + fn as_any(&self) -> &dyn std::any::Any { + self + } +} + +#[cfg(feature = "serialize")] +impl PointInteraction for SerializedPointData { + fn client_coordinates(&self) -> ClientPoint { + self.point_data.client_coordinates() + } + + fn screen_coordinates(&self) -> ScreenPoint { + self.point_data.screen_coordinates() + } + + fn element_coordinates(&self) -> ElementPoint { + self.point_data.element_coordinates() + } + + fn page_coordinates(&self) -> PagePoint { + self.point_data.page_coordinates() + } + + fn modifiers(&self) -> Modifiers { + self.point_data.modifiers() + } + + fn held_buttons(&self) -> MouseButtonSet { + self.point_data.held_buttons() + } + + fn trigger_button(&self) -> Option { + self.point_data.trigger_button() + } +} + +#[cfg(feature = "serialize")] +impl From<&PointerData> for SerializedPointData { + fn from(data: &PointerData) -> Self { + Self { + point_data: data.into(), + pointer_id: data.pointer_id(), + width: data.width(), + height: data.height(), + pressure: data.pressure(), + tangential_pressure: data.tangential_pressure(), + tilt_x: data.tilt_x(), + tilt_y: data.tilt_y(), + twist: data.twist(), + pointer_type: data.pointer_type().to_string(), + is_primary: data.is_primary(), + } + } +} + +#[cfg(feature = "serialize")] +impl serde::Serialize for PointerData { + fn serialize(&self, serializer: S) -> Result { + SerializedPointData::from(self).serialize(serializer) + } +} + +#[cfg(feature = "serialize")] +impl<'de> serde::Deserialize<'de> for PointerData { + fn deserialize>(deserializer: D) -> Result { + let data = SerializedPointData::deserialize(deserializer)?; + Ok(Self { + inner: Box::new(data), + }) } } diff --git a/packages/html/src/events/scroll.rs b/packages/html/src/events/scroll.rs index 798218b02..01046240e 100644 --- a/packages/html/src/events/scroll.rs +++ b/packages/html/src/events/scroll.rs @@ -1,9 +1,75 @@ use dioxus_core::Event; pub type ScrollEvent = Event; -#[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] -#[derive(Debug, Clone, PartialEq, Eq)] -pub struct ScrollData {} + +pub struct ScrollData { + inner: Box, +} + +impl From for ScrollData { + fn from(e: E) -> Self { + Self { inner: Box::new(e) } + } +} + +impl ScrollData { + /// Downcast this event to a concrete event type + pub fn downcast(&self) -> Option<&T> { + self.inner.as_any().downcast_ref::() + } +} + +impl std::fmt::Debug for ScrollData { + fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { + f.debug_struct("ScrollData").finish() + } +} + +impl PartialEq for ScrollData { + fn eq(&self, _other: &Self) -> bool { + true + } +} + +#[cfg(feature = "serialize")] +#[derive(serde::Serialize, serde::Deserialize)] +struct SerializedScrollData {} + +#[cfg(feature = "serialize")] +impl From<&ScrollData> for SerializedScrollData { + fn from(_: &ScrollData) -> Self { + Self {} + } +} + +#[cfg(feature = "serialize")] +impl HasScrollData for SerializedScrollData { + fn as_any(&self) -> &dyn std::any::Any { + self + } +} + +#[cfg(feature = "serialize")] +impl serde::Serialize for ScrollData { + fn serialize(&self, serializer: S) -> Result { + SerializedScrollData::from(self).serialize(serializer) + } +} + +#[cfg(feature = "serialize")] +impl<'de> serde::Deserialize<'de> for ScrollData { + fn deserialize>(deserializer: D) -> Result { + let data = SerializedScrollData::deserialize(deserializer)?; + Ok(Self { + inner: Box::new(data), + }) + } +} + +pub trait HasScrollData: std::any::Any { + /// return self as Any + fn as_any(&self) -> &dyn std::any::Any; +} impl_event! { ScrollData; diff --git a/packages/html/src/events/selection.rs b/packages/html/src/events/selection.rs index 249353e63..34aa98d32 100644 --- a/packages/html/src/events/selection.rs +++ b/packages/html/src/events/selection.rs @@ -1,9 +1,75 @@ use dioxus_core::Event; pub type SelectionEvent = Event; -#[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] -#[derive(Debug, Clone, PartialEq, Eq)] -pub struct SelectionData {} + +pub struct SelectionData { + inner: Box, +} + +impl SelectionData { + /// Downcast this event to a concrete event type + pub fn downcast(&self) -> Option<&T> { + self.inner.as_any().downcast_ref::() + } +} + +impl From for SelectionData { + fn from(e: E) -> Self { + Self { inner: Box::new(e) } + } +} + +impl std::fmt::Debug for SelectionData { + fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { + f.debug_struct("SelectionData").finish() + } +} + +impl PartialEq for SelectionData { + fn eq(&self, _other: &Self) -> bool { + true + } +} + +#[cfg(feature = "serialize")] +#[derive(serde::Serialize, serde::Deserialize)] +struct SerializedSelectionData {} + +#[cfg(feature = "serialize")] +impl From<&SelectionData> for SerializedSelectionData { + fn from(_: &SelectionData) -> Self { + Self {} + } +} + +#[cfg(feature = "serialize")] +impl HasSelectionData for SerializedSelectionData { + fn as_any(&self) -> &dyn std::any::Any { + self + } +} + +#[cfg(feature = "serialize")] +impl serde::Serialize for SelectionData { + fn serialize(&self, serializer: S) -> Result { + SerializedSelectionData::from(self).serialize(serializer) + } +} + +#[cfg(feature = "serialize")] +impl<'de> serde::Deserialize<'de> for SelectionData { + fn deserialize>(deserializer: D) -> Result { + let data = SerializedSelectionData::deserialize(deserializer)?; + Ok(Self { + inner: Box::new(data), + }) + } +} + +pub trait HasSelectionData: std::any::Any { + /// return self as Any + fn as_any(&self) -> &dyn std::any::Any; +} impl_event! [ SelectionData; diff --git a/packages/html/src/events/toggle.rs b/packages/html/src/events/toggle.rs index 4f225a8e6..33e34b18b 100644 --- a/packages/html/src/events/toggle.rs +++ b/packages/html/src/events/toggle.rs @@ -1,9 +1,75 @@ use dioxus_core::Event; pub type ToggleEvent = Event; -#[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] -#[derive(Debug, Clone, PartialEq, Eq)] -pub struct ToggleData {} + +pub struct ToggleData { + inner: Box, +} + +impl From for ToggleData { + fn from(e: E) -> Self { + Self { inner: Box::new(e) } + } +} + +impl std::fmt::Debug for ToggleData { + fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { + f.debug_struct("ToggleData").finish() + } +} + +impl PartialEq for ToggleData { + fn eq(&self, _other: &Self) -> bool { + true + } +} + +impl ToggleData { + /// Downcast this event to a concrete event type + pub fn downcast(&self) -> Option<&T> { + self.inner.as_any().downcast_ref::() + } +} + +#[cfg(feature = "serialize")] +#[derive(serde::Serialize, serde::Deserialize)] +struct SerializedToggleData {} + +#[cfg(feature = "serialize")] +impl From<&ToggleData> for SerializedToggleData { + fn from(_: &ToggleData) -> Self { + Self {} + } +} + +#[cfg(feature = "serialize")] +impl HasToggleData for SerializedToggleData { + fn as_any(&self) -> &dyn std::any::Any { + self + } +} + +#[cfg(feature = "serialize")] +impl serde::Serialize for ToggleData { + fn serialize(&self, serializer: S) -> Result { + SerializedToggleData::from(self).serialize(serializer) + } +} + +#[cfg(feature = "serialize")] +impl<'de> serde::Deserialize<'de> for ToggleData { + fn deserialize>(deserializer: D) -> Result { + let data = SerializedToggleData::deserialize(deserializer)?; + Ok(Self { + inner: Box::new(data), + }) + } +} + +pub trait HasToggleData: std::any::Any { + /// return self as Any + fn as_any(&self) -> &dyn std::any::Any; +} impl_event! { ToggleData; diff --git a/packages/html/src/events/touch.rs b/packages/html/src/events/touch.rs index 1e795b6da..97043870d 100644 --- a/packages/html/src/events/touch.rs +++ b/packages/html/src/events/touch.rs @@ -1,17 +1,139 @@ use dioxus_core::Event; pub type TouchEvent = Event; -#[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] -#[derive(Debug, Clone, PartialEq, Eq)] pub struct TouchData { - pub alt_key: bool, - pub ctrl_key: bool, - pub meta_key: bool, - pub shift_key: bool, - // get_modifier_state: bool, - // changedTouches: DOMTouchList, - // targetTouches: DOMTouchList, - // touches: DOMTouchList, + inner: Box, +} + +impl From for TouchData { + fn from(e: E) -> Self { + Self { inner: Box::new(e) } + } +} + +impl std::fmt::Debug for TouchData { + fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { + f.debug_struct("TouchData") + .field("alt_key", &self.alt_key()) + .field("ctrl_key", &self.ctrl_key()) + .field("meta_key", &self.meta_key()) + .field("shift_key", &self.shift_key()) + .finish() + } +} + +impl PartialEq for TouchData { + fn eq(&self, other: &Self) -> bool { + self.alt_key() == other.alt_key() + && self.ctrl_key() == other.ctrl_key() + && self.meta_key() == other.meta_key() + && self.shift_key() == other.shift_key() + } +} + +impl TouchData { + /// Returns true if the "ALT" key was down when the touch event was fired. + pub fn alt_key(&self) -> bool { + self.inner.alt_key() + } + + /// Returns true if the "CTRL" key was down when the touch event was fired. + pub fn ctrl_key(&self) -> bool { + self.inner.ctrl_key() + } + + /// Returns true if the "META" key was down when the touch event was fired. + pub fn meta_key(&self) -> bool { + self.inner.meta_key() + } + + /// Returns true if the "SHIFT" key was down when the touch event was fired. + pub fn shift_key(&self) -> bool { + self.inner.shift_key() + } + + /// Downcast this event to a concrete event type + pub fn downcast(&self) -> Option<&T> { + self.inner.as_any().downcast_ref::() + } +} + +#[cfg(feature = "serialize")] +#[derive(serde::Serialize, serde::Deserialize)] +struct SerializedTouchData { + alt_key: bool, + ctrl_key: bool, + meta_key: bool, + shift_key: bool, +} + +#[cfg(feature = "serialize")] +impl From<&TouchData> for SerializedTouchData { + fn from(data: &TouchData) -> Self { + Self { + alt_key: data.alt_key(), + ctrl_key: data.ctrl_key(), + meta_key: data.meta_key(), + shift_key: data.shift_key(), + } + } +} + +#[cfg(feature = "serialize")] +impl HasTouchData for SerializedTouchData { + fn alt_key(&self) -> bool { + self.alt_key + } + + fn ctrl_key(&self) -> bool { + self.ctrl_key + } + + fn meta_key(&self) -> bool { + self.meta_key + } + + fn shift_key(&self) -> bool { + self.shift_key + } + + fn as_any(&self) -> &dyn std::any::Any { + self + } +} + +#[cfg(feature = "serialize")] +impl serde::Serialize for TouchData { + fn serialize(&self, serializer: S) -> Result { + SerializedTouchData::from(self).serialize(serializer) + } +} + +#[cfg(feature = "serialize")] +impl<'de> serde::Deserialize<'de> for TouchData { + fn deserialize>(deserializer: D) -> Result { + let data = SerializedTouchData::deserialize(deserializer)?; + Ok(Self { + inner: Box::new(data), + }) + } +} + +pub trait HasTouchData: std::any::Any { + /// Returns true if the "ALT" key was down when the touch event was fired. + fn alt_key(&self) -> bool; + + /// Returns true if the "CTRL" key was down when the touch event was fired. + fn ctrl_key(&self) -> bool; + + /// Returns true if the "META" key was down when the touch event was fired. + fn meta_key(&self) -> bool; + + /// Returns true if the "SHIFT" key was down when the touch event was fired. + fn shift_key(&self) -> bool; + + /// return self as Any + fn as_any(&self) -> &dyn std::any::Any; } impl_event! { diff --git a/packages/html/src/events/transition.rs b/packages/html/src/events/transition.rs index ecc3e1636..8acffe29c 100644 --- a/packages/html/src/events/transition.rs +++ b/packages/html/src/events/transition.rs @@ -1,12 +1,103 @@ use dioxus_core::Event; pub type TransitionEvent = Event; -#[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] -#[derive(Debug, Clone, PartialEq)] + pub struct TransitionData { - pub property_name: String, - pub pseudo_element: String, - pub elapsed_time: f32, + inner: Box, +} + +impl From for TransitionData { + fn from(e: E) -> Self { + Self { inner: Box::new(e) } + } +} + +impl std::fmt::Debug for TransitionData { + fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { + f.debug_struct("TransitionData") + .field("property_name", &self.inner.property_name()) + .field("pseudo_element", &self.inner.pseudo_element()) + .field("elapsed_time", &self.inner.elapsed_time()) + .finish() + } +} + +impl PartialEq for TransitionData { + fn eq(&self, other: &Self) -> bool { + self.inner.property_name() == other.inner.property_name() + && self.inner.pseudo_element() == other.inner.pseudo_element() + && self.inner.elapsed_time() == other.inner.elapsed_time() + } +} + +impl TransitionData { + /// Downcast this event to a concrete event type + pub fn downcast(&self) -> Option<&T> { + self.inner.as_any().downcast_ref::() + } +} + +#[cfg(feature = "serialize")] +#[derive(serde::Serialize, serde::Deserialize)] +struct SerializedTransitionData { + property_name: String, + pseudo_element: String, + elapsed_time: f32, +} + +#[cfg(feature = "serialize")] +impl From<&TransitionData> for SerializedTransitionData { + fn from(data: &TransitionData) -> Self { + Self { + property_name: data.inner.property_name(), + pseudo_element: data.inner.pseudo_element(), + elapsed_time: data.inner.elapsed_time(), + } + } +} + +#[cfg(feature = "serialize")] +impl HasTransitionData for SerializedTransitionData { + fn property_name(&self) -> String { + self.property_name.clone() + } + + fn pseudo_element(&self) -> String { + self.pseudo_element.clone() + } + + fn elapsed_time(&self) -> f32 { + self.elapsed_time + } + + fn as_any(&self) -> &dyn std::any::Any { + self + } +} + +#[cfg(feature = "serialize")] +impl serde::Serialize for TransitionData { + fn serialize(&self, serializer: S) -> Result { + SerializedTransitionData::from(self).serialize(serializer) + } +} + +#[cfg(feature = "serialize")] +impl<'de> serde::Deserialize<'de> for TransitionData { + fn deserialize>(deserializer: D) -> Result { + let data = SerializedTransitionData::deserialize(deserializer)?; + Ok(Self { + inner: Box::new(data), + }) + } +} + +pub trait HasTransitionData: std::any::Any { + fn property_name(&self) -> String; + fn pseudo_element(&self) -> String; + fn elapsed_time(&self) -> f32; + /// return self as Any + fn as_any(&self) -> &dyn std::any::Any; } impl_event! { diff --git a/packages/html/src/events/wheel.rs b/packages/html/src/events/wheel.rs index 758fa7936..348f3760e 100644 --- a/packages/html/src/events/wheel.rs +++ b/packages/html/src/events/wheel.rs @@ -1,21 +1,88 @@ use dioxus_core::Event; -use euclid::UnknownUnit; -use std::fmt::{Debug, Formatter}; +use std::fmt::Formatter; -use crate::geometry::{LinesVector, PagesVector, PixelsVector, WheelDelta}; +use crate::geometry::WheelDelta; pub type WheelEvent = Event; -#[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] -#[derive(Clone, PartialEq, Default)] + pub struct WheelData { - #[deprecated(since = "0.3.0", note = "use delta() instead")] - pub delta_mode: u32, - #[deprecated(since = "0.3.0", note = "use delta() instead")] - pub delta_x: f64, - #[deprecated(since = "0.3.0", note = "use delta() instead")] - pub delta_y: f64, - #[deprecated(since = "0.3.0", note = "use delta() instead")] - pub delta_z: f64, + inner: Box, +} + +impl From for WheelData { + fn from(e: E) -> Self { + Self { inner: Box::new(e) } + } +} + +impl std::fmt::Debug for WheelData { + fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result { + f.debug_struct("WheelData") + .field("delta", &self.delta()) + .finish() + } +} + +impl PartialEq for WheelData { + fn eq(&self, other: &Self) -> bool { + self.inner.delta() == other.inner.delta() + } +} + +impl WheelData { + /// The amount of wheel movement + #[allow(deprecated)] + pub fn delta(&self) -> WheelDelta { + self.inner.delta() + } + + /// Downcast this event to a concrete event type + pub fn downcast(&self) -> Option<&T> { + self.inner.as_any().downcast_ref::() + } +} + +#[cfg(feature = "serialize")] +#[derive(serde::Serialize, serde::Deserialize)] +struct SerializedWheelData { + delta: WheelDelta, +} + +#[cfg(feature = "serialize")] +impl From<&WheelData> for SerializedWheelData { + fn from(data: &WheelData) -> Self { + Self { + delta: data.inner.delta(), + } + } +} + +#[cfg(feature = "serialize")] +impl HasWheelData for SerializedWheelData { + fn delta(&self) -> WheelDelta { + self.delta + } + + fn as_any(&self) -> &dyn std::any::Any { + self + } +} + +#[cfg(feature = "serialize")] +impl serde::Serialize for WheelData { + fn serialize(&self, serializer: S) -> Result { + SerializedWheelData::from(self).serialize(serializer) + } +} + +#[cfg(feature = "serialize")] +impl<'de> serde::Deserialize<'de> for WheelData { + fn deserialize>(deserializer: D) -> Result { + let data = SerializedWheelData::deserialize(deserializer)?; + Ok(Self { + inner: Box::new(data), + }) + } } impl_event![ @@ -25,54 +92,10 @@ impl_event![ onwheel ]; -impl WheelData { - /// Construct a new WheelData with the specified wheel movement delta - pub fn new(delta: WheelDelta) -> Self { - let (delta_mode, vector) = match delta { - WheelDelta::Pixels(v) => (0, v.cast_unit::()), - WheelDelta::Lines(v) => (1, v.cast_unit::()), - WheelDelta::Pages(v) => (2, v.cast_unit::()), - }; - - #[allow(deprecated)] - WheelData { - delta_mode, - delta_x: vector.x, - delta_y: vector.y, - delta_z: vector.z, - } - } - - /// Construct from the attributes of the web wheel event - pub fn from_web_attributes(delta_mode: u32, delta_x: f64, delta_y: f64, delta_z: f64) -> Self { - #[allow(deprecated)] - Self { - delta_mode, - delta_x, - delta_y, - delta_z, - } - } - +pub trait HasWheelData: std::any::Any { /// The amount of wheel movement - #[allow(deprecated)] - pub fn delta(&self) -> WheelDelta { - let x = self.delta_x; - let y = self.delta_y; - let z = self.delta_z; - match self.delta_mode { - 0 => WheelDelta::Pixels(PixelsVector::new(x, y, z)), - 1 => WheelDelta::Lines(LinesVector::new(x, y, z)), - 2 => WheelDelta::Pages(PagesVector::new(x, y, z)), - _ => panic!("Invalid delta mode, {:?}", self.delta_mode), - } - } -} + fn delta(&self) -> WheelDelta; -impl Debug for WheelData { - fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result { - f.debug_struct("WheelData") - .field("delta", &self.delta()) - .finish() - } + /// return self as Any + fn as_any(&self) -> &dyn std::any::Any; } diff --git a/packages/html/src/geometry.rs b/packages/html/src/geometry.rs index 990ca5b5e..4a0b16f4a 100644 --- a/packages/html/src/geometry.rs +++ b/packages/html/src/geometry.rs @@ -47,7 +47,7 @@ pub type PagesVector = Vector3D; /// A vector representing the amount the mouse wheel was moved /// /// This may be expressed in Pixels, Lines or Pages -#[derive(Copy, Clone, Debug)] +#[derive(Copy, Clone, Debug, PartialEq)] #[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] pub enum WheelDelta { /// Movement in Pixels @@ -59,6 +59,16 @@ pub enum WheelDelta { } impl WheelDelta { + /// Construct from the attributes of the web wheel event + pub fn from_web_attributes(delta_mode: u32, delta_x: f64, delta_y: f64, delta_z: f64) -> Self { + match delta_mode { + 0 => WheelDelta::Pixels(PixelsVector::new(delta_x, delta_y, delta_z)), + 1 => WheelDelta::Lines(LinesVector::new(delta_x, delta_y, delta_z)), + 2 => WheelDelta::Pages(PagesVector::new(delta_x, delta_y, delta_z)), + _ => panic!("Invalid delta mode, {:?}", delta_mode), + } + } + /// Convenience function for constructing a WheelDelta with pixel units pub fn pixels(x: f64, y: f64, z: f64) -> Self { WheelDelta::Pixels(PixelsVector::new(x, y, z)) @@ -96,7 +106,7 @@ impl WheelDelta { } /// Coordinates of a point in the app's interface -#[derive(Debug)] +#[derive(Debug, PartialEq)] pub struct Coordinates { screen: ScreenPoint, client: ClientPoint, diff --git a/packages/html/src/lib.rs b/packages/html/src/lib.rs index d362d71f1..8168d0c5e 100644 --- a/packages/html/src/lib.rs +++ b/packages/html/src/lib.rs @@ -44,4 +44,5 @@ pub mod prelude { pub use crate::eval::*; pub use crate::events::*; pub use crate::point_interaction::PointInteraction; + pub use keyboard_types::{self, Code, Key, Modifiers}; } diff --git a/packages/html/src/point_interaction.rs b/packages/html/src/point_interaction.rs index f25a198cc..1d6301176 100644 --- a/packages/html/src/point_interaction.rs +++ b/packages/html/src/point_interaction.rs @@ -1,185 +1,167 @@ -use std::fmt::{Debug, Formatter}; - use keyboard_types::Modifiers; use crate::{ geometry::{ClientPoint, Coordinates, ElementPoint, PagePoint, ScreenPoint}, - input_data::{decode_mouse_button_set, encode_mouse_button_set, MouseButton, MouseButtonSet}, + input_data::{MouseButton, MouseButtonSet}, }; -#[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] -#[derive(Copy, Clone, Default, PartialEq, Eq)] -pub struct PointData { - pub alt_key: bool, +// #[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] +// #[derive(Copy, Clone, Default, PartialEq, Eq)] +// pub struct PointData { +// pub alt_key: bool, - /// The button number that was pressed (if applicable) when the mouse event was fired. - pub button: i16, +// /// The button number that was pressed (if applicable) when the mouse event was fired. +// pub button: i16, - /// Indicates which buttons are pressed on the mouse (or other input device) when a mouse event is triggered. - /// - /// Each button that can be pressed is represented by a given number (see below). If more than one button is pressed, the button values are added together to produce a new number. For example, if the secondary (2) and auxiliary (4) buttons are pressed simultaneously, the value is 6 (i.e., 2 + 4). - /// - /// - 1: Primary button (usually the left button) - /// - 2: Secondary button (usually the right button) - /// - 4: Auxiliary button (usually the mouse wheel button or middle button) - /// - 8: 4th button (typically the "Browser Back" button) - /// - 16 : 5th button (typically the "Browser Forward" button) - pub buttons: u16, +// /// Indicates which buttons are pressed on the mouse (or other input device) when a mouse event is triggered. +// /// +// /// Each button that can be pressed is represented by a given number (see below). If more than one button is pressed, the button values are added together to produce a new number. For example, if the secondary (2) and auxiliary (4) buttons are pressed simultaneously, the value is 6 (i.e., 2 + 4). +// /// +// /// - 1: Primary button (usually the left button) +// /// - 2: Secondary button (usually the right button) +// /// - 4: Auxiliary button (usually the mouse wheel button or middle button) +// /// - 8: 4th button (typically the "Browser Back" button) +// /// - 16 : 5th button (typically the "Browser Forward" button) +// pub buttons: u16, - /// The horizontal coordinate within the application's viewport at which the event occurred (as opposed to the coordinate within the page). - /// - /// For example, clicking on the left edge of the viewport will always result in a mouse event with a clientX value of 0, regardless of whether the page is scrolled horizontally. - pub client_x: i32, +// /// The horizontal coordinate within the application's viewport at which the event occurred (as opposed to the coordinate within the page). +// /// +// /// For example, clicking on the left edge of the viewport will always result in a mouse event with a clientX value of 0, regardless of whether the page is scrolled horizontally. +// pub client_x: i32, - /// The vertical coordinate within the application's viewport at which the event occurred (as opposed to the coordinate within the page). - /// - /// For example, clicking on the top edge of the viewport will always result in a mouse event with a clientY value of 0, regardless of whether the page is scrolled vertically. - pub client_y: i32, +// /// The vertical coordinate within the application's viewport at which the event occurred (as opposed to the coordinate within the page). +// /// +// /// For example, clicking on the top edge of the viewport will always result in a mouse event with a clientY value of 0, regardless of whether the page is scrolled vertically. +// pub client_y: i32, - /// True if the control key was down when the mouse event was fired. - pub ctrl_key: bool, +// /// True if the control key was down when the mouse event was fired. +// pub ctrl_key: bool, - /// True if the meta key was down when the mouse event was fired. - pub meta_key: bool, +// /// True if the meta key was down when the mouse event was fired. +// pub meta_key: bool, - /// The offset in the X coordinate of the mouse pointer between that event and the padding edge of the target node. - pub offset_x: i32, +// /// The offset in the X coordinate of the mouse pointer between that event and the padding edge of the target node. +// pub offset_x: i32, - /// The offset in the Y coordinate of the mouse pointer between that event and the padding edge of the target node. - pub offset_y: i32, +// /// The offset in the Y coordinate of the mouse pointer between that event and the padding edge of the target node. +// pub offset_y: i32, - /// The X (horizontal) coordinate (in pixels) of the mouse, relative to the left edge of the entire document. This includes any portion of the document not currently visible. - /// - /// Being based on the edge of the document as it is, this property takes into account any horizontal scrolling of the page. For example, if the page is scrolled such that 200 pixels of the left side of the document are scrolled out of view, and the mouse is clicked 100 pixels inward from the left edge of the view, the value returned by pageX will be 300. - pub page_x: i32, +// /// The X (horizontal) coordinate (in pixels) of the mouse, relative to the left edge of the entire document. This includes any portion of the document not currently visible. +// /// +// /// Being based on the edge of the document as it is, this property takes into account any horizontal scrolling of the page. For example, if the page is scrolled such that 200 pixels of the left side of the document are scrolled out of view, and the mouse is clicked 100 pixels inward from the left edge of the view, the value returned by pageX will be 300. +// pub page_x: i32, - /// The Y (vertical) coordinate in pixels of the event relative to the whole document. - /// - /// See `page_x`. - pub page_y: i32, +// /// The Y (vertical) coordinate in pixels of the event relative to the whole document. +// /// +// /// See `page_x`. +// pub page_y: i32, - /// The X coordinate of the mouse pointer in global (screen) coordinates. - pub screen_x: i32, +// /// The X coordinate of the mouse pointer in global (screen) coordinates. +// pub screen_x: i32, - /// The Y coordinate of the mouse pointer in global (screen) coordinates. - pub screen_y: i32, +// /// The Y coordinate of the mouse pointer in global (screen) coordinates. +// pub screen_y: i32, - /// True if the shift key was down when the mouse event was fired. - pub shift_key: bool, -} - -impl PointData { - pub fn new( - trigger_button: Option, - held_buttons: MouseButtonSet, - coordinates: Coordinates, - modifiers: Modifiers, - ) -> Self { - let alt_key = modifiers.contains(Modifiers::ALT); - let ctrl_key = modifiers.contains(Modifiers::CONTROL); - let meta_key = modifiers.contains(Modifiers::META); - let shift_key = modifiers.contains(Modifiers::SHIFT); - - let [client_x, client_y]: [i32; 2] = coordinates.client().cast().into(); - let [offset_x, offset_y]: [i32; 2] = coordinates.element().cast().into(); - let [page_x, page_y]: [i32; 2] = coordinates.page().cast().into(); - let [screen_x, screen_y]: [i32; 2] = coordinates.screen().cast().into(); - Self { - button: trigger_button - .map_or(MouseButton::default(), |b| b) - .into_web_code(), - buttons: encode_mouse_button_set(held_buttons), - meta_key, - ctrl_key, - shift_key, - alt_key, - client_x, - client_y, - screen_x, - screen_y, - offset_x, - offset_y, - page_x, - page_y, - } - } -} - -impl Debug for PointData { - fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result { - f.debug_struct("PointInteraction") - .field("coordinates", &self.coordinates()) - .field("modifiers", &self.modifiers()) - .field("held_buttons", &self.held_buttons()) - .field("trigger_button", &self.trigger_button()) - .finish() - } -} - -impl PointInteraction for PointData { - fn get_point_data(&self) -> PointData { - *self - } -} - -pub trait PointInteraction { - fn get_point_data(&self) -> PointData; +// /// True if the shift key was down when the mouse event was fired. +// pub shift_key: bool, +// } +pub trait PointInteraction: std::any::Any { + /// Gets the coordinates of the pointer event. fn coordinates(&self) -> Coordinates { - let point_data = self.get_point_data(); Coordinates::new( - ScreenPoint::new(point_data.screen_x.into(), point_data.screen_y.into()), - ClientPoint::new(point_data.client_x.into(), point_data.client_y.into()), - ElementPoint::new(point_data.offset_x.into(), point_data.offset_y.into()), - PagePoint::new(point_data.page_x.into(), point_data.page_y.into()), + self.screen_coordinates(), + self.client_coordinates(), + self.element_coordinates(), + self.page_coordinates(), ) } - fn client_coordinates(&self) -> ClientPoint { - let point_data = self.get_point_data(); - ClientPoint::new(point_data.client_x.into(), point_data.client_y.into()) - } + /// Gets the coordinates of the pointer event relative to the browser viewport. + fn client_coordinates(&self) -> ClientPoint; - fn screen_coordinates(&self) -> ScreenPoint { - let point_data = self.get_point_data(); - ScreenPoint::new(point_data.screen_x.into(), point_data.screen_y.into()) + /// Gets the coordinates of the pointer event relative to the screen. + fn screen_coordinates(&self) -> ScreenPoint; + + /// Gets the coordinates of the pointer event relative to the target element. + fn element_coordinates(&self) -> ElementPoint; + + /// Gets the coordinates of the pointer event relative to the page. + fn page_coordinates(&self) -> PagePoint; + + /// Gets the modifiers of the pointer event. + fn modifiers(&self) -> Modifiers; + + /// Gets the buttons that are currently held down. + fn held_buttons(&self) -> MouseButtonSet; + + /// Gets the button that triggered the event. + fn trigger_button(&self) -> Option; +} + +#[cfg(feature = "serialize")] +#[derive(serde::Serialize, serde::Deserialize)] +pub(crate) struct SerializedPointInteraction { + pub(crate) client_coordinates: ClientPoint, + pub(crate) element_coordinates: ElementPoint, + pub(crate) page_coordinates: PagePoint, + pub(crate) screen_coordinates: ScreenPoint, + pub(crate) modifiers: Modifiers, + pub(crate) held_buttons: MouseButtonSet, + pub(crate) trigger_button: Option, +} + +#[cfg(feature = "serialize")] +impl From<&E> for SerializedPointInteraction { + fn from(data: &E) -> Self { + Self { + client_coordinates: data.client_coordinates(), + element_coordinates: data.element_coordinates(), + page_coordinates: data.page_coordinates(), + screen_coordinates: data.screen_coordinates(), + modifiers: data.modifiers(), + held_buttons: data.held_buttons(), + trigger_button: data.trigger_button(), + } + } +} + +#[cfg(feature = "serialize")] +impl PointInteraction for SerializedPointInteraction { + fn client_coordinates(&self) -> ClientPoint { + self.client_coordinates } fn element_coordinates(&self) -> ElementPoint { - let point_data = self.get_point_data(); - ElementPoint::new(point_data.offset_x.into(), point_data.offset_y.into()) + self.element_coordinates } fn page_coordinates(&self) -> PagePoint { - let point_data = self.get_point_data(); - PagePoint::new(point_data.page_x.into(), point_data.page_y.into()) + self.page_coordinates + } + + fn screen_coordinates(&self) -> ScreenPoint { + self.screen_coordinates + } + + fn coordinates(&self) -> Coordinates { + Coordinates::new( + self.screen_coordinates(), + self.client_coordinates(), + self.element_coordinates(), + self.page_coordinates(), + ) } fn modifiers(&self) -> Modifiers { - let mut modifiers = Modifiers::empty(); - let point_data = self.get_point_data(); - - if point_data.alt_key { - modifiers.insert(Modifiers::ALT); - } - if point_data.ctrl_key { - modifiers.insert(Modifiers::CONTROL); - } - if point_data.meta_key { - modifiers.insert(Modifiers::META); - } - if point_data.shift_key { - modifiers.insert(Modifiers::SHIFT); - } - - modifiers + self.modifiers } fn held_buttons(&self) -> MouseButtonSet { - decode_mouse_button_set(self.get_point_data().buttons) + self.held_buttons } fn trigger_button(&self) -> Option { - Some(MouseButton::from_web_code(self.get_point_data().button)) + self.trigger_button } } diff --git a/packages/html/src/transit.rs b/packages/html/src/transit.rs index b0fa0d16f..b27f8670a 100644 --- a/packages/html/src/transit.rs +++ b/packages/html/src/transit.rs @@ -4,7 +4,7 @@ use crate::events::*; use dioxus_core::ElementId; use serde::{Deserialize, Serialize}; -#[derive(Serialize, Debug, Clone, PartialEq)] +#[derive(Serialize, Debug, PartialEq)] pub struct HtmlEvent { pub element: ElementId, pub name: String, @@ -136,7 +136,7 @@ impl HtmlEvent { } } -#[derive(Deserialize, Serialize, Debug, Clone, PartialEq)] +#[derive(Deserialize, Serialize, Debug, PartialEq)] #[serde(untagged)] #[non_exhaustive] pub enum EventData { diff --git a/packages/html/src/web_sys_bind/events.rs b/packages/html/src/web_sys_bind/events.rs index c1214f870..757cc2ea0 100644 --- a/packages/html/src/web_sys_bind/events.rs +++ b/packages/html/src/web_sys_bind/events.rs @@ -1,12 +1,12 @@ +use crate::events::HasKeyboardData; use crate::events::{ - AnimationData, CompositionData, KeyboardData, MouseData, PointerData, TouchData, + AnimationData, CompositionData, HasTouchData, KeyboardData, MouseData, PointerData, TouchData, TransitionData, WheelData, }; -use crate::input_data::decode_key_location; -use crate::point_interaction::PointData; -use crate::{DragData, MountedData}; +use crate::geometry::{ClientPoint, ElementPoint, PagePoint, ScreenPoint}; +use crate::input_data::{decode_key_location, decode_mouse_button_set, MouseButton}; +use crate::prelude::*; use keyboard_types::{Code, Key, Modifiers}; -use std::convert::TryInto; use std::str::FromStr; use wasm_bindgen::{JsCast, JsValue}; use web_sys::{ @@ -20,7 +20,7 @@ macro_rules! uncheck_convert { #[inline] fn from(e: Event) -> Self { let e: $t = e.unchecked_into(); - Self::from(&e) + Self::from(e) } } @@ -28,7 +28,7 @@ macro_rules! uncheck_convert { #[inline] fn from(e: &Event) -> Self { let e: &$t = e.unchecked_ref(); - Self::from(e) + Self::from(e.clone()) } } }; @@ -38,152 +38,283 @@ macro_rules! uncheck_convert { } uncheck_convert![ - CompositionEvent => CompositionData, - KeyboardEvent => KeyboardData, - MouseEvent => MouseData, - MouseEvent => DragData, - TouchEvent => TouchData, - PointerEvent => PointerData, - WheelEvent => WheelData, - AnimationEvent => AnimationData, - TransitionEvent => TransitionData, + web_sys::CompositionEvent => CompositionData, + web_sys::KeyboardEvent => KeyboardData, + web_sys::MouseEvent => MouseData, + web_sys::TouchEvent => TouchData, + web_sys::PointerEvent => PointerData, + web_sys::WheelEvent => WheelData, + web_sys::AnimationEvent => AnimationData, + web_sys::TransitionEvent => TransitionData, + web_sys::MouseEvent => DragData, + web_sys::FocusEvent => FocusData, ]; -impl From<&CompositionEvent> for CompositionData { - fn from(e: &CompositionEvent) -> Self { - Self { - data: e.data().unwrap_or_default(), - } +impl HasCompositionData for CompositionEvent { + fn data(&self) -> std::string::String { + self.data().unwrap_or_default() + } + + fn as_any(&self) -> &dyn std::any::Any { + self } } -impl From<&KeyboardEvent> for KeyboardData { - fn from(e: &KeyboardEvent) -> Self { +impl HasKeyboardData for KeyboardEvent { + fn key(&self) -> Key { + Key::from_str(self.key().as_str()).unwrap_or(Key::Unidentified) + } + + fn code(&self) -> Code { + Code::from_str(self.code().as_str()).unwrap_or(Code::Unidentified) + } + + fn modifiers(&self) -> Modifiers { let mut modifiers = Modifiers::empty(); - if e.alt_key() { + if self.alt_key() { modifiers.insert(Modifiers::ALT); } - if e.ctrl_key() { + if self.ctrl_key() { modifiers.insert(Modifiers::CONTROL); } - if e.meta_key() { + if self.meta_key() { modifiers.insert(Modifiers::META); } - if e.shift_key() { + if self.shift_key() { modifiers.insert(Modifiers::SHIFT); } - Self::new( - Key::from_str(&e.key()).expect("could not parse key"), - Code::from_str(&e.code()).expect("could not parse code"), - decode_key_location( - e.location() - .try_into() - .expect("could not convert location to u32"), - ), - e.repeat(), - modifiers, + modifiers + } + + fn location(&self) -> keyboard_types::Location { + decode_key_location(self.location() as usize) + } + + fn is_auto_repeating(&self) -> bool { + self.repeat() + } + + fn as_any(&self) -> &dyn std::any::Any { + self + } +} + +impl HasDragData for MouseEvent {} + +impl PointInteraction for MouseEvent { + fn client_coordinates(&self) -> ClientPoint { + ClientPoint::new(self.client_x().into(), self.client_y().into()) + } + + fn element_coordinates(&self) -> ElementPoint { + ElementPoint::new(self.offset_x().into(), self.offset_y().into()) + } + + fn page_coordinates(&self) -> PagePoint { + PagePoint::new(self.page_x().into(), self.page_y().into()) + } + + fn screen_coordinates(&self) -> ScreenPoint { + ScreenPoint::new(self.screen_x().into(), self.screen_y().into()) + } + + fn modifiers(&self) -> Modifiers { + let mut modifiers = Modifiers::empty(); + + if self.alt_key() { + modifiers.insert(Modifiers::ALT); + } + if self.ctrl_key() { + modifiers.insert(Modifiers::CONTROL); + } + if self.meta_key() { + modifiers.insert(Modifiers::META); + } + if self.shift_key() { + modifiers.insert(Modifiers::SHIFT); + } + + modifiers + } + + fn held_buttons(&self) -> crate::input_data::MouseButtonSet { + decode_mouse_button_set(self.buttons()) + } + + fn trigger_button(&self) -> Option { + Some(MouseButton::from_web_code(self.button())) + } +} + +impl HasMouseData for MouseEvent { + fn as_any(&self) -> &dyn std::any::Any { + self + } +} + +impl HasTouchData for TouchEvent { + fn alt_key(&self) -> bool { + self.alt_key() + } + + fn ctrl_key(&self) -> bool { + self.ctrl_key() + } + + fn meta_key(&self) -> bool { + self.meta_key() + } + + fn shift_key(&self) -> bool { + self.shift_key() + } + + fn as_any(&self) -> &dyn std::any::Any { + self + } +} + +impl HasPointerData for PointerEvent { + fn pointer_id(&self) -> i32 { + self.pointer_id() + } + + fn width(&self) -> i32 { + self.width() + } + + fn height(&self) -> i32 { + self.height() + } + + fn pressure(&self) -> f32 { + self.pressure() + } + + fn tangential_pressure(&self) -> f32 { + self.tangential_pressure() + } + + fn tilt_x(&self) -> i32 { + self.tilt_x() + } + + fn tilt_y(&self) -> i32 { + self.tilt_y() + } + + fn twist(&self) -> i32 { + self.twist() + } + + fn pointer_type(&self) -> String { + self.pointer_type() + } + + fn is_primary(&self) -> bool { + self.is_primary() + } + + fn as_any(&self) -> &dyn std::any::Any { + self + } +} + +impl PointInteraction for PointerEvent { + fn client_coordinates(&self) -> ClientPoint { + ClientPoint::new(self.client_x().into(), self.client_y().into()) + } + + fn screen_coordinates(&self) -> ScreenPoint { + ScreenPoint::new(self.screen_x().into(), self.screen_y().into()) + } + + fn element_coordinates(&self) -> ElementPoint { + ElementPoint::new(self.offset_x().into(), self.offset_y().into()) + } + + fn page_coordinates(&self) -> PagePoint { + PagePoint::new(self.page_x().into(), self.page_y().into()) + } + + fn modifiers(&self) -> Modifiers { + let mut modifiers = Modifiers::empty(); + + if self.alt_key() { + modifiers.insert(Modifiers::ALT); + } + if self.ctrl_key() { + modifiers.insert(Modifiers::CONTROL); + } + if self.meta_key() { + modifiers.insert(Modifiers::META); + } + if self.shift_key() { + modifiers.insert(Modifiers::SHIFT); + } + + modifiers + } + + fn held_buttons(&self) -> crate::input_data::MouseButtonSet { + decode_mouse_button_set(self.buttons()) + } + + fn trigger_button(&self) -> Option { + Some(MouseButton::from_web_code(self.button())) + } +} + +impl HasWheelData for WheelEvent { + fn delta(&self) -> crate::geometry::WheelDelta { + crate::geometry::WheelDelta::from_web_attributes( + self.delta_mode(), + self.delta_x(), + self.delta_y(), + self.delta_z(), ) } -} -impl From<&MouseEvent> for MouseData { - fn from(e: &MouseEvent) -> Self { - Self::new(PointData { - button: e.button(), - buttons: e.buttons(), - meta_key: e.meta_key(), - alt_key: e.alt_key(), - ctrl_key: e.ctrl_key(), - shift_key: e.shift_key(), - client_x: e.client_x(), - client_y: e.client_y(), - screen_x: e.screen_x(), - screen_y: e.screen_y(), - offset_x: e.offset_x(), - offset_y: e.offset_y(), - page_x: e.page_x(), - page_y: e.page_y(), - }) + fn as_any(&self) -> &dyn std::any::Any { + self } } -impl From<&MouseEvent> for DragData { - fn from(value: &MouseEvent) -> Self { - Self { - mouse: MouseData::from(value), - } +impl HasAnimationData for AnimationEvent { + fn animation_name(&self) -> String { + self.animation_name() + } + + fn pseudo_element(&self) -> String { + self.pseudo_element() + } + + fn elapsed_time(&self) -> f32 { + self.elapsed_time() + } + + fn as_any(&self) -> &dyn std::any::Any { + self } } -impl From<&TouchEvent> for TouchData { - fn from(e: &TouchEvent) -> Self { - Self { - alt_key: e.alt_key(), - ctrl_key: e.ctrl_key(), - meta_key: e.meta_key(), - shift_key: e.shift_key(), - } +impl HasTransitionData for TransitionEvent { + fn elapsed_time(&self) -> f32 { + self.elapsed_time() } -} -impl From<&PointerEvent> for PointerData { - fn from(e: &PointerEvent) -> Self { - Self::new( - PointData { - button: e.button(), - buttons: e.buttons(), - meta_key: e.meta_key(), - alt_key: e.alt_key(), - ctrl_key: e.ctrl_key(), - shift_key: e.shift_key(), - client_x: e.client_x(), - client_y: e.client_y(), - screen_x: e.screen_x(), - screen_y: e.screen_y(), - offset_x: e.offset_x(), - offset_y: e.offset_y(), - page_x: e.page_x(), - page_y: e.page_y(), - }, - e.pointer_id(), - e.width(), - e.height(), - e.pressure(), - e.tangential_pressure(), - e.tilt_x(), - e.tilt_y(), - e.twist(), - e.pointer_type(), - e.is_primary(), - ) + fn property_name(&self) -> String { + self.property_name() } -} -impl From<&WheelEvent> for WheelData { - fn from(e: &WheelEvent) -> Self { - WheelData::from_web_attributes(e.delta_mode(), e.delta_x(), e.delta_y(), e.delta_z()) + fn pseudo_element(&self) -> String { + self.pseudo_element() } -} -impl From<&AnimationEvent> for AnimationData { - fn from(e: &AnimationEvent) -> Self { - Self { - elapsed_time: e.elapsed_time(), - animation_name: e.animation_name(), - pseudo_element: e.pseudo_element(), - } - } -} - -impl From<&TransitionEvent> for TransitionData { - fn from(e: &TransitionEvent) -> Self { - Self { - elapsed_time: e.elapsed_time(), - property_name: e.property_name(), - pseudo_element: e.pseudo_element(), - } + fn as_any(&self) -> &dyn std::any::Any { + self } } @@ -209,8 +340,8 @@ impl crate::RenderedElementBacking for web_sys::Element { Box::pin(async { result }) } - fn get_raw_element(&self) -> crate::MountedResult<&dyn std::any::Any> { - Ok(self) + fn as_any(&self) -> &dyn std::any::Any { + self } fn scroll_to( @@ -254,3 +385,39 @@ impl std::fmt::Display for FocusError { } impl std::error::Error for FocusError {} + +impl HasClipboardData for Event { + fn as_any(&self) -> &dyn std::any::Any { + self + } +} + +impl From<&Event> for ClipboardData { + fn from(e: &Event) -> Self { + ClipboardData::new(e.clone()) + } +} + +impl HasFocusData for web_sys::FocusEvent { + fn as_any(&self) -> &dyn std::any::Any { + self + } +} + +impl HasToggleData for web_sys::Event { + fn as_any(&self) -> &dyn std::any::Any { + self + } +} + +impl HasSelectionData for web_sys::Event { + fn as_any(&self) -> &dyn std::any::Any { + self + } +} + +impl HasMediaData for web_sys::Event { + fn as_any(&self) -> &dyn std::any::Any { + self + } +} diff --git a/packages/web/src/dom.rs b/packages/web/src/dom.rs index 9d0d837c5..d2e154129 100644 --- a/packages/web/src/dom.rs +++ b/packages/web/src/dom.rs @@ -10,12 +10,12 @@ use dioxus_core::{ BorrowedAttributeValue, ElementId, Mutation, Template, TemplateAttribute, TemplateNode, }; -use dioxus_html::{event_bubbles, CompositionData, FormData, MountedData}; +use dioxus_html::{event_bubbles, FileEngine, HasFormData, HasImageData, MountedData}; use dioxus_interpreter_js::{get_node, minimal_bindings, save_template, Channel}; use futures_channel::mpsc; use js_sys::Array; use rustc_hash::FxHashMap; -use std::{any::Any, rc::Rc}; +use std::{any::Any, collections::HashMap, rc::Rc}; use wasm_bindgen::{closure::Closure, prelude::wasm_bindgen, JsCast, JsValue}; use web_sys::{Document, Element, Event}; @@ -269,30 +269,29 @@ pub fn virtual_event_from_websys_event(event: web_sys::Event, target: Element) - use dioxus_html::events::*; match event.type_().as_str() { - "copy" | "cut" | "paste" => Rc::new(ClipboardData {}), + "copy" | "cut" | "paste" => Rc::new(ClipboardData::from(event)), "compositionend" | "compositionstart" | "compositionupdate" => { - make_composition_event(&event) + Rc::new(CompositionData::from(event)) } "keydown" | "keypress" | "keyup" => Rc::new(KeyboardData::from(event)), - "focus" | "blur" | "focusout" | "focusin" => Rc::new(FocusData {}), + "focus" | "blur" | "focusout" | "focusin" => Rc::new(FocusData::from(event)), - "change" | "input" | "invalid" | "reset" | "submit" => read_input_to_data(target), + "change" | "input" | "invalid" | "reset" | "submit" => { + Rc::new(WebFormData::new(target, event)) + } "click" | "contextmenu" | "dblclick" | "doubleclick" | "mousedown" | "mouseenter" | "mouseleave" | "mousemove" | "mouseout" | "mouseover" | "mouseup" => { Rc::new(MouseData::from(event)) } "drag" | "dragend" | "dragenter" | "dragexit" | "dragleave" | "dragover" | "dragstart" - | "drop" => { - let mouse = MouseData::from(event); - Rc::new(DragData { mouse }) - } + | "drop" => Rc::new(DragData::from(event)), "pointerdown" | "pointermove" | "pointerup" | "pointercancel" | "gotpointercapture" | "lostpointercapture" | "pointerenter" | "pointerleave" | "pointerover" | "pointerout" => { Rc::new(PointerData::from(event)) } - "select" => Rc::new(SelectionData {}), + "select" => Rc::new(SelectionData::from(event)), "touchcancel" | "touchend" | "touchmove" | "touchstart" => Rc::new(TouchData::from(event)), "scroll" => Rc::new(()), @@ -304,22 +303,15 @@ pub fn virtual_event_from_websys_event(event: web_sys::Event, target: Element) - "abort" | "canplay" | "canplaythrough" | "durationchange" | "emptied" | "encrypted" | "ended" | "loadeddata" | "loadedmetadata" | "loadstart" | "pause" | "play" | "playing" | "progress" | "ratechange" | "seeked" | "seeking" | "stalled" | "suspend" - | "timeupdate" | "volumechange" | "waiting" => Rc::new(MediaData {}), - "error" => Rc::new(ImageData { load_error: true }), - "load" => Rc::new(ImageData { load_error: false }), - "toggle" => Rc::new(ToggleData {}), + | "timeupdate" | "volumechange" | "waiting" => Rc::new(MediaData::from(event)), + "error" => Rc::new(WebImageEvent::new(event, true)), + "load" => Rc::new(WebImageEvent::new(event, false)), + "toggle" => Rc::new(ToggleData::from(event)), _ => Rc::new(()), } } -fn make_composition_event(event: &Event) -> Rc { - let evt: &web_sys::CompositionEvent = event.dyn_ref().unwrap(); - Rc::new(CompositionData { - data: evt.data().unwrap_or_default(), - }) -} - pub(crate) fn load_document() -> Document { web_sys::window() .expect("should have access to the Window") @@ -327,11 +319,42 @@ pub(crate) fn load_document() -> Document { .expect("should have access to the Document") } -fn read_input_to_data(target: Element) -> Rc { - // todo: these handlers might get really slow if the input box gets large and allocation pressure is heavy - // don't have a good solution with the serialized event problem +struct WebImageEvent { + raw: Event, + error: bool, +} - let value: String = target +impl WebImageEvent { + fn new(raw: Event, error: bool) -> Self { + Self { raw, error } + } +} + +impl HasImageData for WebImageEvent { + fn load_error(&self) -> bool { + self.error + } + + fn as_any(&self) -> &dyn Any { + &self.raw + } +} + +struct WebFormData { + element: Element, + raw: Event, +} + +impl WebFormData { + fn new(element: Element, raw: Event) -> Self { + Self { element, raw } + } +} + +impl HasFormData for WebFormData { + fn value(&self) -> String { + let target = &self.element; + target .dyn_ref() .map(|input: &web_sys::HtmlInputElement| { // todo: special case more input types @@ -364,44 +387,53 @@ fn read_input_to_data(target: Element) -> Rc { .unwrap() .text_content() }) - .expect("only an InputElement or TextAreaElement or an element with contenteditable=true can have an oninput event listener"); + .expect("only an InputElement or TextAreaElement or an element with contenteditable=true can have an oninput event listener") + } - let mut values = std::collections::HashMap::new(); + fn values(&self) -> HashMap> { + let mut values = std::collections::HashMap::new(); - // try to fill in form values - if let Some(form) = target.dyn_ref::() { - let form_data = get_form_data(form); - for value in form_data.entries().into_iter().flatten() { - if let Ok(array) = value.dyn_into::() { - if let Some(name) = array.get(0).as_string() { - if let Ok(item_values) = array.get(1).dyn_into::() { - let item_values = - item_values.iter().filter_map(|v| v.as_string()).collect(); + // try to fill in form values + if let Some(form) = self.element.dyn_ref::() { + let form_data = get_form_data(form); + for value in form_data.entries().into_iter().flatten() { + if let Ok(array) = value.dyn_into::() { + if let Some(name) = array.get(0).as_string() { + if let Ok(item_values) = array.get(1).dyn_into::() { + let item_values = + item_values.iter().filter_map(|v| v.as_string()).collect(); - values.insert(name, item_values); + values.insert(name, item_values); + } } } } } + + values } - #[cfg(not(feature = "file_engine"))] - let files = None; - #[cfg(feature = "file_engine")] - let files = target - .dyn_ref() - .and_then(|input: &web_sys::HtmlInputElement| { - input.files().and_then(|files| { - crate::file_engine::WebFileEngine::new(files) - .map(|f| std::sync::Arc::new(f) as std::sync::Arc) - }) - }); + fn files(&self) -> Option> { + #[cfg(not(feature = "file_engine"))] + let files = None; + #[cfg(feature = "file_engine")] + let files = self + .element + .dyn_ref() + .and_then(|input: &web_sys::HtmlInputElement| { + input.files().and_then(|files| { + crate::file_engine::WebFileEngine::new(files).map(|f| { + std::sync::Arc::new(f) as std::sync::Arc + }) + }) + }); - Rc::new(FormData { - value, - values, - files, - }) + files + } + + fn as_any(&self) -> &dyn Any { + &self.raw + } } // web-sys does not expose the keys api for form data, so we need to manually bind to it From ca1a502714117f9ef72500a40a41aa6a37a5d27d Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Fri, 25 Aug 2023 21:03:03 -0500 Subject: [PATCH 049/447] use an event converter for bundle splitting --- packages/core/src/events.rs | 21 +++ packages/html/src/events.rs | 173 +++++++++++++++++++++- packages/html/src/events/image.rs | 5 + packages/html/src/lib.rs | 2 +- packages/html/src/web_sys_bind/events.rs | 6 + packages/web/src/dom.rs | 177 ++++++++++++++++------- 6 files changed, 332 insertions(+), 52 deletions(-) diff --git a/packages/core/src/events.rs b/packages/core/src/events.rs index b85e0394d..644d69f29 100644 --- a/packages/core/src/events.rs +++ b/packages/core/src/events.rs @@ -28,6 +28,27 @@ pub struct Event { } impl Event { + /// Map the event data to a new type + /// + /// # Example + /// + /// ```rust, ignore + /// rsx! { + /// button { + /// onclick: move |evt: Event| { + /// let data = evt.map(|data| data.value()); + /// assert_eq!(data.inner(), "hello world"); + /// } + /// } + /// } + /// ``` + pub fn map U>(&self, f: F) -> Event { + Event { + data: Rc::new(f(&self.data)), + propagates: self.propagates.clone(), + } + } + /// Prevent this event from continuing to bubble up the tree to parent elements. /// /// # Example diff --git a/packages/html/src/events.rs b/packages/html/src/events.rs index f044b7b43..a24294378 100644 --- a/packages/html/src/events.rs +++ b/packages/html/src/events.rs @@ -1,3 +1,6 @@ +use std::any::Any; +use std::sync::RwLock; + macro_rules! impl_event { ( $data:ty; @@ -12,8 +15,8 @@ macro_rules! impl_event { pub fn $name<'a, E: crate::EventReturn, T>(_cx: &'a ::dioxus_core::ScopeState, mut _f: impl FnMut(::dioxus_core::Event<$data>) -> E + 'a) -> ::dioxus_core::Attribute<'a> { ::dioxus_core::Attribute::new( stringify!($name), - _cx.listener(move |e: ::dioxus_core::Event<$data>| { - _f(e).spawn(_cx); + _cx.listener(move |e: ::dioxus_core::Event| { + _f(e.map(|e|e.into())).spawn(_cx); }), None, false, @@ -23,6 +26,172 @@ macro_rules! impl_event { }; } +static EVENT_CONVERTER: RwLock>> = RwLock::new(None); + +pub fn set_event_converter(converter: Box) { + *EVENT_CONVERTER.write().unwrap() = Some(converter); +} + +pub(crate) fn with_event_converter(f: F) -> R +where + F: FnOnce(&dyn HtmlEventConverter) -> R, +{ + let converter = EVENT_CONVERTER.read().unwrap(); + f(converter.as_ref().unwrap().as_ref()) +} + +/// A platform specific event. +pub struct PlatformEventData { + event: Box, +} + +impl PlatformEventData { + pub fn new(event: Box) -> Self { + Self { event } + } + + pub fn downcast(&self) -> Option<&T> { + self.event.downcast_ref::() + } + + pub fn downcast_mut(&mut self) -> Option<&mut T> { + self.event.downcast_mut::() + } + + pub fn into_inner(self) -> Option { + self.event.downcast::().ok().map(|e| *e) + } +} + +pub trait HtmlEventConverter: Send + Sync { + fn convert_animation_data(&self, event: &PlatformEventData) -> AnimationData; + fn convert_clipboard_data(&self, event: &PlatformEventData) -> ClipboardData; + fn convert_composition_data(&self, event: &PlatformEventData) -> CompositionData; + fn convert_drag_data(&self, event: &PlatformEventData) -> DragData; + fn convert_focus_data(&self, event: &PlatformEventData) -> FocusData; + fn convert_form_data(&self, event: &PlatformEventData) -> FormData; + fn convert_image_data(&self, event: &PlatformEventData) -> ImageData; + fn convert_keyboard_data(&self, event: &PlatformEventData) -> KeyboardData; + fn convert_media_data(&self, event: &PlatformEventData) -> MediaData; + fn convert_mounted_data(&self, event: &PlatformEventData) -> MountedData; + fn convert_mouse_data(&self, event: &PlatformEventData) -> MouseData; + fn convert_pointer_data(&self, event: &PlatformEventData) -> PointerData; + fn convert_scroll_data(&self, event: &PlatformEventData) -> ScrollData; + fn convert_selection_data(&self, event: &PlatformEventData) -> SelectionData; + fn convert_toggle_data(&self, event: &PlatformEventData) -> ToggleData; + fn convert_touch_data(&self, event: &PlatformEventData) -> TouchData; + fn convert_transition_data(&self, event: &PlatformEventData) -> TransitionData; + fn convert_wheel_data(&self, event: &PlatformEventData) -> WheelData; +} + +impl Into for &PlatformEventData { + fn into(self) -> AnimationData { + with_event_converter(|c| c.convert_animation_data(self)) + } +} + +impl Into for &PlatformEventData { + fn into(self) -> ClipboardData { + with_event_converter(|c| c.convert_clipboard_data(self)) + } +} + +impl Into for &PlatformEventData { + fn into(self) -> CompositionData { + with_event_converter(|c| c.convert_composition_data(self)) + } +} + +impl Into for &PlatformEventData { + fn into(self) -> DragData { + with_event_converter(|c| c.convert_drag_data(self)) + } +} + +impl Into for &PlatformEventData { + fn into(self) -> FocusData { + with_event_converter(|c| c.convert_focus_data(self)) + } +} + +impl Into for &PlatformEventData { + fn into(self) -> FormData { + with_event_converter(|c| c.convert_form_data(self)) + } +} + +impl Into for &PlatformEventData { + fn into(self) -> ImageData { + with_event_converter(|c| c.convert_image_data(self)) + } +} + +impl Into for &PlatformEventData { + fn into(self) -> KeyboardData { + with_event_converter(|c| c.convert_keyboard_data(self)) + } +} + +impl Into for &PlatformEventData { + fn into(self) -> MediaData { + with_event_converter(|c| c.convert_media_data(self)) + } +} + +impl Into for &PlatformEventData { + fn into(self) -> MountedData { + with_event_converter(|c| c.convert_mounted_data(self)) + } +} + +impl Into for &PlatformEventData { + fn into(self) -> MouseData { + with_event_converter(|c| c.convert_mouse_data(self)) + } +} + +impl Into for &PlatformEventData { + fn into(self) -> PointerData { + with_event_converter(|c| c.convert_pointer_data(self)) + } +} + +impl Into for &PlatformEventData { + fn into(self) -> ScrollData { + with_event_converter(|c| c.convert_scroll_data(self)) + } +} + +impl Into for &PlatformEventData { + fn into(self) -> SelectionData { + with_event_converter(|c| c.convert_selection_data(self)) + } +} + +impl Into for &PlatformEventData { + fn into(self) -> ToggleData { + with_event_converter(|c| c.convert_toggle_data(self)) + } +} + +impl Into for &PlatformEventData { + fn into(self) -> TouchData { + with_event_converter(|c| c.convert_touch_data(self)) + } +} + +impl Into for &PlatformEventData { + fn into(self) -> TransitionData { + with_event_converter(|c| c.convert_transition_data(self)) + } +} + +impl Into for &PlatformEventData { + fn into(self) -> WheelData { + with_event_converter(|c| c.convert_wheel_data(self)) + } +} + mod animation; mod clipboard; mod composition; diff --git a/packages/html/src/events/image.rs b/packages/html/src/events/image.rs index cf46838b7..e7d67ea69 100644 --- a/packages/html/src/events/image.rs +++ b/packages/html/src/events/image.rs @@ -26,6 +26,11 @@ impl PartialEq for ImageData { } impl ImageData { + /// Create a new ImageData + pub fn new(e: impl HasImageData) -> Self { + Self { inner: Box::new(e) } + } + /// If the renderer encountered an error while loading the image pub fn load_error(&self) -> bool { self.inner.load_error() diff --git a/packages/html/src/lib.rs b/packages/html/src/lib.rs index 8168d0c5e..2a08241d9 100644 --- a/packages/html/src/lib.rs +++ b/packages/html/src/lib.rs @@ -38,7 +38,7 @@ pub use events::*; pub use global_attributes::*; pub use render_template::*; -mod eval; +pub mod eval; pub mod prelude { pub use crate::eval::*; diff --git a/packages/html/src/web_sys_bind/events.rs b/packages/html/src/web_sys_bind/events.rs index 757cc2ea0..643a06045 100644 --- a/packages/html/src/web_sys_bind/events.rs +++ b/packages/html/src/web_sys_bind/events.rs @@ -386,6 +386,12 @@ impl std::fmt::Display for FocusError { impl std::error::Error for FocusError {} +impl HasScrollData for Event { + fn as_any(&self) -> &dyn std::any::Any { + self + } +} + impl HasClipboardData for Event { fn as_any(&self) -> &dyn std::any::Any { self diff --git a/packages/web/src/dom.rs b/packages/web/src/dom.rs index d2e154129..c19886666 100644 --- a/packages/web/src/dom.rs +++ b/packages/web/src/dom.rs @@ -1,7 +1,6 @@ //! Implementation of a renderer for Dioxus on the web. //! -//! Oustanding todos: -//! - Removing event listeners (delegation) +//! Outstanding todos: //! - Passive event listeners //! - no-op event listener patch for safari //! - tests to ensure dyn_into works for various event types. @@ -10,7 +9,10 @@ use dioxus_core::{ BorrowedAttributeValue, ElementId, Mutation, Template, TemplateAttribute, TemplateNode, }; -use dioxus_html::{event_bubbles, FileEngine, HasFormData, HasImageData, MountedData}; +use dioxus_html::{ + event_bubbles, FileEngine, FormData, HasFormData, HasImageData, HtmlEventConverter, ImageData, + MountedData, ScrollData, +}; use dioxus_interpreter_js::{get_node, minimal_bindings, save_template, Channel}; use futures_channel::mpsc; use js_sys::Array; @@ -263,53 +265,130 @@ impl WebsysDom { } } +struct WebEventConverter; + +fn downcast_event(event: &dioxus_html::PlatformEventData) -> &GenericWebSysEvent { + event + .downcast::() + .expect("event should be a GenericWebSysEvent") +} + +impl HtmlEventConverter for WebEventConverter { + fn convert_animation_data( + &self, + event: &dioxus_html::PlatformEventData, + ) -> dioxus_html::AnimationData { + downcast_event(event).raw.clone().into() + } + + fn convert_clipboard_data( + &self, + event: &dioxus_html::PlatformEventData, + ) -> dioxus_html::ClipboardData { + downcast_event(event).raw.clone().into() + } + + fn convert_composition_data( + &self, + event: &dioxus_html::PlatformEventData, + ) -> dioxus_html::CompositionData { + downcast_event(event).raw.clone().into() + } + + fn convert_drag_data(&self, event: &dioxus_html::PlatformEventData) -> dioxus_html::DragData { + downcast_event(event).raw.clone().into() + } + + fn convert_focus_data(&self, event: &dioxus_html::PlatformEventData) -> dioxus_html::FocusData { + downcast_event(event).raw.clone().into() + } + + fn convert_form_data(&self, event: &dioxus_html::PlatformEventData) -> dioxus_html::FormData { + let event = downcast_event(event); + FormData::new(WebFormData::new(event.element.clone(), event.raw.clone())) + } + + fn convert_image_data(&self, event: &dioxus_html::PlatformEventData) -> dioxus_html::ImageData { + let event = downcast_event(event); + let error = event.raw.type_() == "error"; + ImageData::new(WebImageEvent::new(event.raw.clone(), error)) + } + + fn convert_keyboard_data( + &self, + event: &dioxus_html::PlatformEventData, + ) -> dioxus_html::KeyboardData { + downcast_event(event).raw.clone().into() + } + + fn convert_media_data(&self, event: &dioxus_html::PlatformEventData) -> dioxus_html::MediaData { + downcast_event(event).raw.clone().into() + } + + fn convert_mounted_data(&self, event: &dioxus_html::PlatformEventData) -> MountedData { + MountedData::from(downcast_event(event).element.clone()) + } + + fn convert_mouse_data(&self, event: &dioxus_html::PlatformEventData) -> dioxus_html::MouseData { + downcast_event(event).raw.clone().into() + } + + fn convert_pointer_data( + &self, + event: &dioxus_html::PlatformEventData, + ) -> dioxus_html::PointerData { + downcast_event(event).raw.clone().into() + } + + fn convert_scroll_data( + &self, + event: &dioxus_html::PlatformEventData, + ) -> dioxus_html::ScrollData { + ScrollData::from(downcast_event(event).raw.clone()) + } + + fn convert_selection_data( + &self, + event: &dioxus_html::PlatformEventData, + ) -> dioxus_html::SelectionData { + downcast_event(event).raw.clone().into() + } + + fn convert_toggle_data( + &self, + event: &dioxus_html::PlatformEventData, + ) -> dioxus_html::ToggleData { + downcast_event(event).raw.clone().into() + } + + fn convert_touch_data(&self, event: &dioxus_html::PlatformEventData) -> dioxus_html::TouchData { + downcast_event(event).raw.clone().into() + } + + fn convert_transition_data( + &self, + event: &dioxus_html::PlatformEventData, + ) -> dioxus_html::TransitionData { + downcast_event(event).raw.clone().into() + } + + fn convert_wheel_data(&self, event: &dioxus_html::PlatformEventData) -> dioxus_html::WheelData { + downcast_event(event).raw.clone().into() + } +} + +struct GenericWebSysEvent { + raw: Event, + element: Element, +} + // todo: some of these events are being casted to the wrong event type. // We need tests that simulate clicks/etc and make sure every event type works. pub fn virtual_event_from_websys_event(event: web_sys::Event, target: Element) -> Rc { - use dioxus_html::events::*; - - match event.type_().as_str() { - "copy" | "cut" | "paste" => Rc::new(ClipboardData::from(event)), - "compositionend" | "compositionstart" | "compositionupdate" => { - Rc::new(CompositionData::from(event)) - } - "keydown" | "keypress" | "keyup" => Rc::new(KeyboardData::from(event)), - "focus" | "blur" | "focusout" | "focusin" => Rc::new(FocusData::from(event)), - - "change" | "input" | "invalid" | "reset" | "submit" => { - Rc::new(WebFormData::new(target, event)) - } - - "click" | "contextmenu" | "dblclick" | "doubleclick" | "mousedown" | "mouseenter" - | "mouseleave" | "mousemove" | "mouseout" | "mouseover" | "mouseup" => { - Rc::new(MouseData::from(event)) - } - "drag" | "dragend" | "dragenter" | "dragexit" | "dragleave" | "dragover" | "dragstart" - | "drop" => Rc::new(DragData::from(event)), - - "pointerdown" | "pointermove" | "pointerup" | "pointercancel" | "gotpointercapture" - | "lostpointercapture" | "pointerenter" | "pointerleave" | "pointerover" | "pointerout" => { - Rc::new(PointerData::from(event)) - } - "select" => Rc::new(SelectionData::from(event)), - "touchcancel" | "touchend" | "touchmove" | "touchstart" => Rc::new(TouchData::from(event)), - - "scroll" => Rc::new(()), - "wheel" => Rc::new(WheelData::from(event)), - "animationstart" | "animationend" | "animationiteration" => { - Rc::new(AnimationData::from(event)) - } - "transitionend" => Rc::new(TransitionData::from(event)), - "abort" | "canplay" | "canplaythrough" | "durationchange" | "emptied" | "encrypted" - | "ended" | "loadeddata" | "loadedmetadata" | "loadstart" | "pause" | "play" - | "playing" | "progress" | "ratechange" | "seeked" | "seeking" | "stalled" | "suspend" - | "timeupdate" | "volumechange" | "waiting" => Rc::new(MediaData::from(event)), - "error" => Rc::new(WebImageEvent::new(event, true)), - "load" => Rc::new(WebImageEvent::new(event, false)), - "toggle" => Rc::new(ToggleData::from(event)), - - _ => Rc::new(()), - } + Rc::new(GenericWebSysEvent { + raw: event, + element: target, + }) } pub(crate) fn load_document() -> Document { @@ -336,7 +415,7 @@ impl HasImageData for WebImageEvent { } fn as_any(&self) -> &dyn Any { - &self.raw + &self.raw as &dyn Any } } @@ -432,7 +511,7 @@ impl HasFormData for WebFormData { } fn as_any(&self) -> &dyn Any { - &self.raw + &self.raw as &dyn Any } } From b54f7dd5d29bef6add9458ea64ecee94d0d81cd2 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Fri, 25 Aug 2023 21:28:44 -0500 Subject: [PATCH 050/447] fix no default features on the web renderer --- Cargo.toml | 2 +- packages/html/Cargo.toml | 6 +++++- packages/html/src/lib.rs | 2 ++ packages/web/Cargo.toml | 4 +++- packages/web/src/dom.rs | 10 +++++++++- packages/web/src/lib.rs | 1 + 6 files changed, 21 insertions(+), 4 deletions(-) diff --git a/Cargo.toml b/Cargo.toml index 252e9c83e..07f25171a 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -59,7 +59,7 @@ dioxus-core = { path = "packages/core", version = "0.4.2" } dioxus-core-macro = { path = "packages/core-macro", version = "0.4.0" } dioxus-router = { path = "packages/router", version = "0.4.1" } dioxus-router-macro = { path = "packages/router-macro", version = "0.4.1" } -dioxus-html = { path = "packages/html", version = "0.4.0" } +dioxus-html = { path = "packages/html", default-features = false, version = "0.4.0" } dioxus-hooks = { path = "packages/hooks", version = "0.4.0" } dioxus-web = { path = "packages/web", version = "0.4.0" } dioxus-ssr = { path = "packages/ssr", version = "0.4.0" } diff --git a/packages/html/Cargo.toml b/packages/html/Cargo.toml index 3a2495b02..b06ce3375 100644 --- a/packages/html/Cargo.toml +++ b/packages/html/Cargo.toml @@ -47,7 +47,7 @@ features = [ serde_json = "1" [features] -default = ["serialize", "mounted"] +default = ["serialize", "mounted", "eval"] serialize = [ "serde", "serde/rc", @@ -66,6 +66,10 @@ mounted = [ "web-sys/ScrollBehavior", "web-sys/HtmlElement", ] +eval = [ + "serde", + "serde_json" +] wasm-bind = ["web-sys", "wasm-bindgen"] native-bind = ["tokio"] hot-reload-context = ["dioxus-rsx"] diff --git a/packages/html/src/lib.rs b/packages/html/src/lib.rs index 2a08241d9..55037b2dc 100644 --- a/packages/html/src/lib.rs +++ b/packages/html/src/lib.rs @@ -38,9 +38,11 @@ pub use events::*; pub use global_attributes::*; pub use render_template::*; +#[cfg(feature = "eval")] pub mod eval; pub mod prelude { + #[cfg(feature = "eval")] pub use crate::eval::*; pub use crate::events::*; pub use crate::point_interaction::PointInteraction; diff --git a/packages/web/Cargo.toml b/packages/web/Cargo.toml index 8de282869..88ee3b680 100644 --- a/packages/web/Cargo.toml +++ b/packages/web/Cargo.toml @@ -65,7 +65,9 @@ hot_reload = [ "web-sys/WebSocket", "web-sys/Location", ] -eval = [] +eval = [ + "dioxus-html/eval", +] [dev-dependencies] dioxus = { workspace = true } diff --git a/packages/web/src/dom.rs b/packages/web/src/dom.rs index c19886666..3a38b22b6 100644 --- a/packages/web/src/dom.rs +++ b/packages/web/src/dom.rs @@ -173,6 +173,7 @@ impl WebsysDom { pub fn apply_edits(&mut self, mut edits: Vec) { use Mutation::*; let i = &mut self.interpreter; + #[cfg(feature = "mounted")] // we need to apply the mount events last, so we collect them here let mut to_mount = Vec::new(); for edit in &edits { @@ -228,6 +229,7 @@ impl WebsysDom { match *name { // mounted events are fired immediately after the element is mounted. "mounted" => { + #[cfg(feature = "mounted")] to_mount.push(*id); } _ => { @@ -248,6 +250,7 @@ impl WebsysDom { edits.clear(); i.flush(); + #[cfg(feature = "mounted")] for id in to_mount { let node = get_node(id.0 as u32); if let Some(element) = node.dyn_ref::() { @@ -326,7 +329,12 @@ impl HtmlEventConverter for WebEventConverter { } fn convert_mounted_data(&self, event: &dioxus_html::PlatformEventData) -> MountedData { - MountedData::from(downcast_event(event).element.clone()) + #[cfg(feature = "mounted")] + {MountedData::from(downcast_event(event).element.clone())} + #[cfg(not(feature = "mounted"))] + { + panic!("mounted events are not supported without the mounted feature on the dioxus-web crate enabled") + } } fn convert_mouse_data(&self, event: &dioxus_html::PlatformEventData) -> dioxus_html::MouseData { diff --git a/packages/web/src/lib.rs b/packages/web/src/lib.rs index 261232607..ce1fad116 100644 --- a/packages/web/src/lib.rs +++ b/packages/web/src/lib.rs @@ -54,6 +54,7 @@ // - Do DOM work in the next requestAnimationFrame callback pub use crate::cfg::Config; +#[cfg(feature = "file_engine")] pub use crate::file_engine::WebFileEngineExt; use dioxus_core::{Element, Scope, VirtualDom}; use futures_util::{ From b4ebf34595d4e876716e6f45d91939f4166ac7cf Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Mon, 28 Aug 2023 11:39:55 -0500 Subject: [PATCH 051/447] forward data PointInteraction data in the PointerData debug and partial implementation --- packages/html/src/events/pointer.rs | 20 ++++++++++++++------ 1 file changed, 14 insertions(+), 6 deletions(-) diff --git a/packages/html/src/events/pointer.rs b/packages/html/src/events/pointer.rs index 266dd7c66..280cc923e 100644 --- a/packages/html/src/events/pointer.rs +++ b/packages/html/src/events/pointer.rs @@ -29,6 +29,10 @@ impl std::fmt::Debug for PointerData { .field("twist", &self.twist()) .field("pointer_type", &self.pointer_type()) .field("is_primary", &self.is_primary()) + .field("coordinates", &self.coordinates()) + .field("modifiers", &self.modifiers()) + .field("held_buttons", &self.held_buttons()) + .field("trigger_button", &self.trigger_button()) .finish() } } @@ -45,6 +49,10 @@ impl PartialEq for PointerData { && self.twist() == other.twist() && self.pointer_type() == other.pointer_type() && self.is_primary() == other.is_primary() + && self.coordinates() == other.coordinates() + && self.modifiers() == other.modifiers() + && self.held_buttons() == other.held_buttons() + && self.trigger_button() == other.trigger_button() } } @@ -201,7 +209,7 @@ impl PointInteraction for PointerData { #[cfg(feature = "serialize")] #[derive(serde::Serialize, serde::Deserialize)] -struct SerializedPointData { +struct SerializedPointerData { /// Common data for all pointer/mouse events #[serde(flatten)] point_data: crate::point_interaction::SerializedPointInteraction, @@ -238,7 +246,7 @@ struct SerializedPointData { } #[cfg(feature = "serialize")] -impl HasPointerData for SerializedPointData { +impl HasPointerData for SerializedPointerData { fn pointer_id(&self) -> i32 { self.pointer_id } @@ -285,7 +293,7 @@ impl HasPointerData for SerializedPointData { } #[cfg(feature = "serialize")] -impl PointInteraction for SerializedPointData { +impl PointInteraction for SerializedPointerData { fn client_coordinates(&self) -> ClientPoint { self.point_data.client_coordinates() } @@ -316,7 +324,7 @@ impl PointInteraction for SerializedPointData { } #[cfg(feature = "serialize")] -impl From<&PointerData> for SerializedPointData { +impl From<&PointerData> for SerializedPointerData { fn from(data: &PointerData) -> Self { Self { point_data: data.into(), @@ -337,14 +345,14 @@ impl From<&PointerData> for SerializedPointData { #[cfg(feature = "serialize")] impl serde::Serialize for PointerData { fn serialize(&self, serializer: S) -> Result { - SerializedPointData::from(self).serialize(serializer) + SerializedPointerData::from(self).serialize(serializer) } } #[cfg(feature = "serialize")] impl<'de> serde::Deserialize<'de> for PointerData { fn deserialize>(deserializer: D) -> Result { - let data = SerializedPointData::deserialize(deserializer)?; + let data = SerializedPointerData::deserialize(deserializer)?; Ok(Self { inner: Box::new(data), }) From f7dff22552725fcc8b3b3650dacf563f84eb24c6 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Mon, 28 Aug 2023 11:49:16 -0500 Subject: [PATCH 052/447] expose all serialized events as public --- packages/html/src/events/animation.rs | 3 ++- packages/html/src/events/clipboard.rs | 3 ++- packages/html/src/events/composition.rs | 3 ++- packages/html/src/events/drag.rs | 3 ++- packages/html/src/events/focus.rs | 3 ++- packages/html/src/events/image.rs | 3 ++- packages/html/src/events/keyboard.rs | 3 ++- packages/html/src/events/media.rs | 3 ++- packages/html/src/events/pointer.rs | 3 ++- packages/html/src/events/scroll.rs | 3 ++- packages/html/src/events/selection.rs | 3 ++- packages/html/src/events/toggle.rs | 3 ++- packages/html/src/events/touch.rs | 3 ++- packages/html/src/events/transition.rs | 3 ++- packages/html/src/events/wheel.rs | 3 ++- 15 files changed, 30 insertions(+), 15 deletions(-) diff --git a/packages/html/src/events/animation.rs b/packages/html/src/events/animation.rs index ca0a26567..6b4d398da 100644 --- a/packages/html/src/events/animation.rs +++ b/packages/html/src/events/animation.rs @@ -49,8 +49,9 @@ impl PartialEq for AnimationData { } #[cfg(feature = "serialize")] +/// A serialized version of AnimationData #[derive(serde::Serialize, serde::Deserialize)] -struct SerializedAnimationData { +pub struct SerializedAnimationData { animation_name: String, pseudo_element: String, elapsed_time: f32, diff --git a/packages/html/src/events/clipboard.rs b/packages/html/src/events/clipboard.rs index 84a9b1446..7f945378d 100644 --- a/packages/html/src/events/clipboard.rs +++ b/packages/html/src/events/clipboard.rs @@ -37,8 +37,9 @@ impl ClipboardData { } #[cfg(feature = "serialize")] +/// A serialized version of ClipboardData #[derive(serde::Serialize, serde::Deserialize)] -struct SerializedClipboardData {} +pub struct SerializedClipboardData {} #[cfg(feature = "serialize")] impl From<&ClipboardData> for SerializedClipboardData { diff --git a/packages/html/src/events/composition.rs b/packages/html/src/events/composition.rs index bf2f6214e..41671a077 100644 --- a/packages/html/src/events/composition.rs +++ b/packages/html/src/events/composition.rs @@ -37,8 +37,9 @@ impl CompositionData { } #[cfg(feature = "serialize")] +/// A serialized version of CompositionData #[derive(serde::Serialize, serde::Deserialize)] -struct SerializedCompositionData { +pub struct SerializedCompositionData { data: String, } diff --git a/packages/html/src/events/drag.rs b/packages/html/src/events/drag.rs index f7575c494..c8599850f 100644 --- a/packages/html/src/events/drag.rs +++ b/packages/html/src/events/drag.rs @@ -98,8 +98,9 @@ impl DragData { } #[cfg(feature = "serialize")] +/// A serialized version of DragData #[derive(serde::Serialize, serde::Deserialize)] -struct SerializedDragData { +pub struct SerializedDragData { mouse: crate::point_interaction::SerializedPointInteraction, } diff --git a/packages/html/src/events/focus.rs b/packages/html/src/events/focus.rs index 59e384f4a..af1da2c59 100644 --- a/packages/html/src/events/focus.rs +++ b/packages/html/src/events/focus.rs @@ -32,8 +32,9 @@ impl FocusData { } #[cfg(feature = "serialize")] +/// A serialized version of FocusData #[derive(serde::Serialize, serde::Deserialize)] -struct SerializedFocusData {} +pub struct SerializedFocusData {} #[cfg(feature = "serialize")] impl From<&FocusData> for SerializedFocusData { diff --git a/packages/html/src/events/image.rs b/packages/html/src/events/image.rs index e7d67ea69..4e094c925 100644 --- a/packages/html/src/events/image.rs +++ b/packages/html/src/events/image.rs @@ -42,8 +42,9 @@ impl ImageData { } #[cfg(feature = "serialize")] +/// A serialized version of ImageData #[derive(serde::Serialize, serde::Deserialize)] -struct SerializedImageData { +pub struct SerializedImageData { load_error: bool, } diff --git a/packages/html/src/events/keyboard.rs b/packages/html/src/events/keyboard.rs index 07fc00871..74109bea2 100644 --- a/packages/html/src/events/keyboard.rs +++ b/packages/html/src/events/keyboard.rs @@ -79,8 +79,9 @@ impl KeyboardData { } #[cfg(feature = "serialize")] +/// A serialized version of KeyboardData #[derive(serde::Serialize, serde::Deserialize)] -struct SerializedKeyboardData { +pub struct SerializedKeyboardData { auto_repeating: bool, #[serde(deserialize_with = "resilient_deserialize_code")] code: Code, diff --git a/packages/html/src/events/media.rs b/packages/html/src/events/media.rs index e088bd2a5..9382e6831 100644 --- a/packages/html/src/events/media.rs +++ b/packages/html/src/events/media.rs @@ -31,8 +31,9 @@ impl MediaData { } #[cfg(feature = "serialize")] +/// A serialized version of MediaData #[derive(serde::Serialize, serde::Deserialize)] -struct SerializedMediaData {} +pub struct SerializedMediaData {} #[cfg(feature = "serialize")] impl From<&MediaData> for SerializedMediaData { diff --git a/packages/html/src/events/pointer.rs b/packages/html/src/events/pointer.rs index 280cc923e..cba360679 100644 --- a/packages/html/src/events/pointer.rs +++ b/packages/html/src/events/pointer.rs @@ -208,8 +208,9 @@ impl PointInteraction for PointerData { } #[cfg(feature = "serialize")] +/// A serialized version of PointerData #[derive(serde::Serialize, serde::Deserialize)] -struct SerializedPointerData { +pub struct SerializedPointerData { /// Common data for all pointer/mouse events #[serde(flatten)] point_data: crate::point_interaction::SerializedPointInteraction, diff --git a/packages/html/src/events/scroll.rs b/packages/html/src/events/scroll.rs index 01046240e..50be913d2 100644 --- a/packages/html/src/events/scroll.rs +++ b/packages/html/src/events/scroll.rs @@ -32,8 +32,9 @@ impl PartialEq for ScrollData { } #[cfg(feature = "serialize")] +/// A serialized version of ScrollData #[derive(serde::Serialize, serde::Deserialize)] -struct SerializedScrollData {} +pub struct SerializedScrollData {} #[cfg(feature = "serialize")] impl From<&ScrollData> for SerializedScrollData { diff --git a/packages/html/src/events/selection.rs b/packages/html/src/events/selection.rs index 34aa98d32..272b3e898 100644 --- a/packages/html/src/events/selection.rs +++ b/packages/html/src/events/selection.rs @@ -32,8 +32,9 @@ impl PartialEq for SelectionData { } #[cfg(feature = "serialize")] +/// A serialized version of SelectionData #[derive(serde::Serialize, serde::Deserialize)] -struct SerializedSelectionData {} +pub struct SerializedSelectionData {} #[cfg(feature = "serialize")] impl From<&SelectionData> for SerializedSelectionData { diff --git a/packages/html/src/events/toggle.rs b/packages/html/src/events/toggle.rs index 33e34b18b..f2240bcbf 100644 --- a/packages/html/src/events/toggle.rs +++ b/packages/html/src/events/toggle.rs @@ -32,8 +32,9 @@ impl ToggleData { } #[cfg(feature = "serialize")] +/// A serialized version of ToggleData #[derive(serde::Serialize, serde::Deserialize)] -struct SerializedToggleData {} +pub struct SerializedToggleData {} #[cfg(feature = "serialize")] impl From<&ToggleData> for SerializedToggleData { diff --git a/packages/html/src/events/touch.rs b/packages/html/src/events/touch.rs index 97043870d..4537bce92 100644 --- a/packages/html/src/events/touch.rs +++ b/packages/html/src/events/touch.rs @@ -59,8 +59,9 @@ impl TouchData { } #[cfg(feature = "serialize")] +/// A serialized version of TouchData #[derive(serde::Serialize, serde::Deserialize)] -struct SerializedTouchData { +pub struct SerializedTouchData { alt_key: bool, ctrl_key: bool, meta_key: bool, diff --git a/packages/html/src/events/transition.rs b/packages/html/src/events/transition.rs index 8acffe29c..9cd66b761 100644 --- a/packages/html/src/events/transition.rs +++ b/packages/html/src/events/transition.rs @@ -38,8 +38,9 @@ impl TransitionData { } #[cfg(feature = "serialize")] +/// A serialized version of TransitionData #[derive(serde::Serialize, serde::Deserialize)] -struct SerializedTransitionData { +pub struct SerializedTransitionData { property_name: String, pseudo_element: String, elapsed_time: f32, diff --git a/packages/html/src/events/wheel.rs b/packages/html/src/events/wheel.rs index 348f3760e..87048f4ce 100644 --- a/packages/html/src/events/wheel.rs +++ b/packages/html/src/events/wheel.rs @@ -43,8 +43,9 @@ impl WheelData { } #[cfg(feature = "serialize")] +/// A serialized version of WheelData #[derive(serde::Serialize, serde::Deserialize)] -struct SerializedWheelData { +pub struct SerializedWheelData { delta: WheelDelta, } From 93cbfd0dbcfd1cc292be86139ebeea38ca8f3fbd Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Mon, 28 Aug 2023 12:35:43 -0500 Subject: [PATCH 053/447] derive more traits for serialized types --- packages/html/Cargo.toml | 26 ++++---- packages/html/src/events/animation.rs | 2 +- packages/html/src/events/clipboard.rs | 2 +- packages/html/src/events/composition.rs | 2 +- packages/html/src/events/drag.rs | 2 +- packages/html/src/events/focus.rs | 2 +- packages/html/src/events/form.rs | 4 +- packages/html/src/events/image.rs | 2 +- packages/html/src/events/keyboard.rs | 25 ++++++- packages/html/src/events/media.rs | 2 +- packages/html/src/events/mouse.rs | 88 ++++++++++++++++++++++++- packages/html/src/events/pointer.rs | 2 +- packages/html/src/events/scroll.rs | 2 +- packages/html/src/events/selection.rs | 2 +- packages/html/src/events/toggle.rs | 2 +- packages/html/src/events/touch.rs | 2 +- packages/html/src/events/transition.rs | 2 +- packages/html/src/events/wheel.rs | 10 ++- packages/html/src/point_interaction.rs | 87 +++++++----------------- packages/html/src/transit.rs | 2 +- 20 files changed, 171 insertions(+), 97 deletions(-) diff --git a/packages/html/Cargo.toml b/packages/html/Cargo.toml index b06ce3375..7e061855e 100644 --- a/packages/html/Cargo.toml +++ b/packages/html/Cargo.toml @@ -16,7 +16,7 @@ serde = { version = "1", features = ["derive"], optional = true } serde_repr = { version = "0.1", optional = true } wasm-bindgen = { workspace = true, optional = true } euclid = "0.22.7" -enumset = "1.0.11" +enumset = "1.1.2" keyboard-types = "0.7" async-trait = "0.1.58" serde-value = "0.7.0" @@ -29,18 +29,18 @@ serde_json = { version = "1", optional = true } optional = true version = "0.3.56" features = [ - "TouchEvent", - "MouseEvent", - "InputEvent", - "ClipboardEvent", - "KeyboardEvent", - "TouchEvent", - "WheelEvent", - "AnimationEvent", - "TransitionEvent", - "PointerEvent", - "FocusEvent", - "CompositionEvent", + "TouchEvent", + "MouseEvent", + "InputEvent", + "ClipboardEvent", + "KeyboardEvent", + "TouchEvent", + "WheelEvent", + "AnimationEvent", + "TransitionEvent", + "PointerEvent", + "FocusEvent", + "CompositionEvent", ] [dev-dependencies] diff --git a/packages/html/src/events/animation.rs b/packages/html/src/events/animation.rs index 6b4d398da..02612bc77 100644 --- a/packages/html/src/events/animation.rs +++ b/packages/html/src/events/animation.rs @@ -50,7 +50,7 @@ impl PartialEq for AnimationData { #[cfg(feature = "serialize")] /// A serialized version of AnimationData -#[derive(serde::Serialize, serde::Deserialize)] +#[derive(serde::Serialize, serde::Deserialize, Debug, PartialEq, Clone)] pub struct SerializedAnimationData { animation_name: String, pseudo_element: String, diff --git a/packages/html/src/events/clipboard.rs b/packages/html/src/events/clipboard.rs index 7f945378d..0469c4f1c 100644 --- a/packages/html/src/events/clipboard.rs +++ b/packages/html/src/events/clipboard.rs @@ -38,7 +38,7 @@ impl ClipboardData { #[cfg(feature = "serialize")] /// A serialized version of ClipboardData -#[derive(serde::Serialize, serde::Deserialize)] +#[derive(serde::Serialize, serde::Deserialize, Debug, PartialEq, Clone)] pub struct SerializedClipboardData {} #[cfg(feature = "serialize")] diff --git a/packages/html/src/events/composition.rs b/packages/html/src/events/composition.rs index 41671a077..18ef4f5d1 100644 --- a/packages/html/src/events/composition.rs +++ b/packages/html/src/events/composition.rs @@ -38,7 +38,7 @@ impl CompositionData { #[cfg(feature = "serialize")] /// A serialized version of CompositionData -#[derive(serde::Serialize, serde::Deserialize)] +#[derive(serde::Serialize, serde::Deserialize, Debug, PartialEq, Clone)] pub struct SerializedCompositionData { data: String, } diff --git a/packages/html/src/events/drag.rs b/packages/html/src/events/drag.rs index c8599850f..004ea6612 100644 --- a/packages/html/src/events/drag.rs +++ b/packages/html/src/events/drag.rs @@ -99,7 +99,7 @@ impl DragData { #[cfg(feature = "serialize")] /// A serialized version of DragData -#[derive(serde::Serialize, serde::Deserialize)] +#[derive(serde::Serialize, serde::Deserialize, Debug, PartialEq, Clone)] pub struct SerializedDragData { mouse: crate::point_interaction::SerializedPointInteraction, } diff --git a/packages/html/src/events/focus.rs b/packages/html/src/events/focus.rs index af1da2c59..f96c1eaee 100644 --- a/packages/html/src/events/focus.rs +++ b/packages/html/src/events/focus.rs @@ -33,7 +33,7 @@ impl FocusData { #[cfg(feature = "serialize")] /// A serialized version of FocusData -#[derive(serde::Serialize, serde::Deserialize)] +#[derive(serde::Serialize, serde::Deserialize, Debug, PartialEq, Clone, Default)] pub struct SerializedFocusData {} #[cfg(feature = "serialize")] diff --git a/packages/html/src/events/form.rs b/packages/html/src/events/form.rs index 015559d64..de8bb0dbf 100644 --- a/packages/html/src/events/form.rs +++ b/packages/html/src/events/form.rs @@ -78,7 +78,7 @@ pub trait HasFormData: std::any::Any { #[cfg(feature = "serialize")] /// A serialized form data object -#[derive(serde::Serialize, serde::Deserialize)] +#[derive(serde::Serialize, serde::Deserialize, Debug, PartialEq, Clone)] pub struct SerializedFormData { value: String, values: HashMap>, @@ -172,7 +172,7 @@ impl<'de> serde::Deserialize<'de> for FormData { #[cfg(feature = "serialize")] /// A file engine that serializes files to bytes -#[derive(serde::Serialize, serde::Deserialize)] +#[derive(serde::Serialize, serde::Deserialize, Debug, PartialEq, Clone)] pub struct SerializedFileEngine { files: HashMap>, } diff --git a/packages/html/src/events/image.rs b/packages/html/src/events/image.rs index 4e094c925..3c75edbdd 100644 --- a/packages/html/src/events/image.rs +++ b/packages/html/src/events/image.rs @@ -43,7 +43,7 @@ impl ImageData { #[cfg(feature = "serialize")] /// A serialized version of ImageData -#[derive(serde::Serialize, serde::Deserialize)] +#[derive(serde::Serialize, serde::Deserialize, Debug, PartialEq, Clone)] pub struct SerializedImageData { load_error: bool, } diff --git a/packages/html/src/events/keyboard.rs b/packages/html/src/events/keyboard.rs index 74109bea2..2af582089 100644 --- a/packages/html/src/events/keyboard.rs +++ b/packages/html/src/events/keyboard.rs @@ -1,6 +1,5 @@ use dioxus_core::Event; use keyboard_types::{Code, Key, Location, Modifiers}; -use std::convert::TryInto; use std::fmt::Debug; #[cfg(feature = "serialize")] @@ -80,7 +79,7 @@ impl KeyboardData { #[cfg(feature = "serialize")] /// A serialized version of KeyboardData -#[derive(serde::Serialize, serde::Deserialize)] +#[derive(serde::Serialize, serde::Deserialize, Debug, PartialEq, Clone)] pub struct SerializedKeyboardData { auto_repeating: bool, #[serde(deserialize_with = "resilient_deserialize_code")] @@ -90,6 +89,26 @@ pub struct SerializedKeyboardData { modifiers: Modifiers, } +#[cfg(feature = "serialize")] +impl SerializedKeyboardData { + /// Create a new SerializedKeyboardData + pub fn new( + auto_repeating: bool, + code: Code, + key: Key, + location: Location, + modifiers: Modifiers, + ) -> Self { + Self { + auto_repeating, + code, + key, + location, + modifiers, + } + } +} + #[cfg(feature = "serialize")] impl From<&KeyboardData> for SerializedKeyboardData { fn from(data: &KeyboardData) -> Self { @@ -186,6 +205,8 @@ impl<'de> serde::Deserialize<'de> for KeyCode { where D: serde::Deserializer<'de>, { + use std::convert::TryInto; + // We could be deserializing a unicode character, so we need to use u64 even if the output only takes u8 let value = u64::deserialize(deserializer)?; diff --git a/packages/html/src/events/media.rs b/packages/html/src/events/media.rs index 9382e6831..1abcab21d 100644 --- a/packages/html/src/events/media.rs +++ b/packages/html/src/events/media.rs @@ -32,7 +32,7 @@ impl MediaData { #[cfg(feature = "serialize")] /// A serialized version of MediaData -#[derive(serde::Serialize, serde::Deserialize)] +#[derive(serde::Serialize, serde::Deserialize, Debug, PartialEq, Clone)] pub struct SerializedMediaData {} #[cfg(feature = "serialize")] diff --git a/packages/html/src/events/mouse.rs b/packages/html/src/events/mouse.rs index 6c346a434..0e73ef4f6 100644 --- a/packages/html/src/events/mouse.rs +++ b/packages/html/src/events/mouse.rs @@ -106,6 +106,13 @@ impl_event! { } impl MouseData { + /// Create a new instance of MouseData + pub fn new(inner: impl HasMouseData + 'static) -> Self { + Self { + inner: Box::new(inner), + } + } + /// Downcast this event to a concrete event type pub fn downcast(&self) -> Option<&T> { self.inner.as_any().downcast_ref::() @@ -172,23 +179,98 @@ impl PartialEq for MouseData { } #[cfg(feature = "serialize")] -impl HasMouseData for crate::point_interaction::SerializedPointInteraction { +/// A serialized version of [`MouseData`] +#[derive(serde::Serialize, serde::Deserialize, Debug, PartialEq, Clone, Default)] +pub struct SerializedMouseData { + /// Common data for all pointer/mouse events + #[serde(flatten)] + point_data: crate::point_interaction::SerializedPointInteraction, +} + +#[cfg(feature = "serialize")] +impl SerializedMouseData { + /// Create a new instance of SerializedMouseData + pub fn new( + client_coordinates: ClientPoint, + element_coordinates: ElementPoint, + page_coordinates: PagePoint, + screen_coordinates: ScreenPoint, + modifiers: Modifiers, + held_buttons: MouseButtonSet, + trigger_button: Option, + ) -> Self { + Self { + point_data: crate::point_interaction::SerializedPointInteraction::new( + client_coordinates, + element_coordinates, + page_coordinates, + screen_coordinates, + modifiers, + held_buttons, + trigger_button, + ), + } + } +} + +#[cfg(feature = "serialize")] +impl From<&MouseData> for SerializedMouseData { + fn from(e: &MouseData) -> Self { + Self { + point_data: crate::point_interaction::SerializedPointInteraction::from(e), + } + } +} + +#[cfg(feature = "serialize")] +impl HasMouseData for SerializedMouseData { fn as_any(&self) -> &dyn std::any::Any { self } } +#[cfg(feature = "serialize")] +impl PointInteraction for SerializedMouseData { + fn client_coordinates(&self) -> ClientPoint { + self.point_data.client_coordinates() + } + + fn element_coordinates(&self) -> ElementPoint { + self.point_data.element_coordinates() + } + + fn page_coordinates(&self) -> PagePoint { + self.point_data.page_coordinates() + } + + fn screen_coordinates(&self) -> ScreenPoint { + self.point_data.screen_coordinates() + } + + fn modifiers(&self) -> Modifiers { + self.point_data.modifiers() + } + + fn held_buttons(&self) -> MouseButtonSet { + self.point_data.held_buttons() + } + + fn trigger_button(&self) -> Option { + self.point_data.trigger_button() + } +} + #[cfg(feature = "serialize")] impl serde::Serialize for MouseData { fn serialize(&self, serializer: S) -> Result { - crate::point_interaction::SerializedPointInteraction::from(self).serialize(serializer) + SerializedMouseData::from(self).serialize(serializer) } } #[cfg(feature = "serialize")] impl<'de> serde::Deserialize<'de> for MouseData { fn deserialize>(deserializer: D) -> Result { - let data = crate::point_interaction::SerializedPointInteraction::deserialize(deserializer)?; + let data = SerializedMouseData::deserialize(deserializer)?; Ok(Self { inner: Box::new(data), }) diff --git a/packages/html/src/events/pointer.rs b/packages/html/src/events/pointer.rs index cba360679..5540dbe62 100644 --- a/packages/html/src/events/pointer.rs +++ b/packages/html/src/events/pointer.rs @@ -209,7 +209,7 @@ impl PointInteraction for PointerData { #[cfg(feature = "serialize")] /// A serialized version of PointerData -#[derive(serde::Serialize, serde::Deserialize)] +#[derive(serde::Serialize, serde::Deserialize, Debug, PartialEq, Clone)] pub struct SerializedPointerData { /// Common data for all pointer/mouse events #[serde(flatten)] diff --git a/packages/html/src/events/scroll.rs b/packages/html/src/events/scroll.rs index 50be913d2..4655afbcc 100644 --- a/packages/html/src/events/scroll.rs +++ b/packages/html/src/events/scroll.rs @@ -33,7 +33,7 @@ impl PartialEq for ScrollData { #[cfg(feature = "serialize")] /// A serialized version of ScrollData -#[derive(serde::Serialize, serde::Deserialize)] +#[derive(serde::Serialize, serde::Deserialize, Debug, PartialEq, Clone)] pub struct SerializedScrollData {} #[cfg(feature = "serialize")] diff --git a/packages/html/src/events/selection.rs b/packages/html/src/events/selection.rs index 272b3e898..de10b06c4 100644 --- a/packages/html/src/events/selection.rs +++ b/packages/html/src/events/selection.rs @@ -33,7 +33,7 @@ impl PartialEq for SelectionData { #[cfg(feature = "serialize")] /// A serialized version of SelectionData -#[derive(serde::Serialize, serde::Deserialize)] +#[derive(serde::Serialize, serde::Deserialize, Debug, PartialEq, Clone)] pub struct SerializedSelectionData {} #[cfg(feature = "serialize")] diff --git a/packages/html/src/events/toggle.rs b/packages/html/src/events/toggle.rs index f2240bcbf..7de8be36d 100644 --- a/packages/html/src/events/toggle.rs +++ b/packages/html/src/events/toggle.rs @@ -33,7 +33,7 @@ impl ToggleData { #[cfg(feature = "serialize")] /// A serialized version of ToggleData -#[derive(serde::Serialize, serde::Deserialize)] +#[derive(serde::Serialize, serde::Deserialize, Debug, PartialEq, Clone)] pub struct SerializedToggleData {} #[cfg(feature = "serialize")] diff --git a/packages/html/src/events/touch.rs b/packages/html/src/events/touch.rs index 4537bce92..7e9009ab6 100644 --- a/packages/html/src/events/touch.rs +++ b/packages/html/src/events/touch.rs @@ -60,7 +60,7 @@ impl TouchData { #[cfg(feature = "serialize")] /// A serialized version of TouchData -#[derive(serde::Serialize, serde::Deserialize)] +#[derive(serde::Serialize, serde::Deserialize, Debug, PartialEq, Clone)] pub struct SerializedTouchData { alt_key: bool, ctrl_key: bool, diff --git a/packages/html/src/events/transition.rs b/packages/html/src/events/transition.rs index 9cd66b761..c6dc65ae1 100644 --- a/packages/html/src/events/transition.rs +++ b/packages/html/src/events/transition.rs @@ -39,7 +39,7 @@ impl TransitionData { #[cfg(feature = "serialize")] /// A serialized version of TransitionData -#[derive(serde::Serialize, serde::Deserialize)] +#[derive(serde::Serialize, serde::Deserialize, Debug, PartialEq, Clone)] pub struct SerializedTransitionData { property_name: String, pseudo_element: String, diff --git a/packages/html/src/events/wheel.rs b/packages/html/src/events/wheel.rs index 87048f4ce..72550d835 100644 --- a/packages/html/src/events/wheel.rs +++ b/packages/html/src/events/wheel.rs @@ -44,11 +44,19 @@ impl WheelData { #[cfg(feature = "serialize")] /// A serialized version of WheelData -#[derive(serde::Serialize, serde::Deserialize)] +#[derive(serde::Serialize, serde::Deserialize, Debug, PartialEq, Clone)] pub struct SerializedWheelData { delta: WheelDelta, } +#[cfg(feature = "serialize")] +impl SerializedWheelData { + /// Create a new SerializedWheelData + pub fn new(delta: WheelDelta) -> Self { + Self { delta } + } +} + #[cfg(feature = "serialize")] impl From<&WheelData> for SerializedWheelData { fn from(data: &WheelData) -> Self { diff --git a/packages/html/src/point_interaction.rs b/packages/html/src/point_interaction.rs index 1d6301176..0b2230ab3 100644 --- a/packages/html/src/point_interaction.rs +++ b/packages/html/src/point_interaction.rs @@ -5,67 +5,6 @@ use crate::{ input_data::{MouseButton, MouseButtonSet}, }; -// #[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] -// #[derive(Copy, Clone, Default, PartialEq, Eq)] -// pub struct PointData { -// pub alt_key: bool, - -// /// The button number that was pressed (if applicable) when the mouse event was fired. -// pub button: i16, - -// /// Indicates which buttons are pressed on the mouse (or other input device) when a mouse event is triggered. -// /// -// /// Each button that can be pressed is represented by a given number (see below). If more than one button is pressed, the button values are added together to produce a new number. For example, if the secondary (2) and auxiliary (4) buttons are pressed simultaneously, the value is 6 (i.e., 2 + 4). -// /// -// /// - 1: Primary button (usually the left button) -// /// - 2: Secondary button (usually the right button) -// /// - 4: Auxiliary button (usually the mouse wheel button or middle button) -// /// - 8: 4th button (typically the "Browser Back" button) -// /// - 16 : 5th button (typically the "Browser Forward" button) -// pub buttons: u16, - -// /// The horizontal coordinate within the application's viewport at which the event occurred (as opposed to the coordinate within the page). -// /// -// /// For example, clicking on the left edge of the viewport will always result in a mouse event with a clientX value of 0, regardless of whether the page is scrolled horizontally. -// pub client_x: i32, - -// /// The vertical coordinate within the application's viewport at which the event occurred (as opposed to the coordinate within the page). -// /// -// /// For example, clicking on the top edge of the viewport will always result in a mouse event with a clientY value of 0, regardless of whether the page is scrolled vertically. -// pub client_y: i32, - -// /// True if the control key was down when the mouse event was fired. -// pub ctrl_key: bool, - -// /// True if the meta key was down when the mouse event was fired. -// pub meta_key: bool, - -// /// The offset in the X coordinate of the mouse pointer between that event and the padding edge of the target node. -// pub offset_x: i32, - -// /// The offset in the Y coordinate of the mouse pointer between that event and the padding edge of the target node. -// pub offset_y: i32, - -// /// The X (horizontal) coordinate (in pixels) of the mouse, relative to the left edge of the entire document. This includes any portion of the document not currently visible. -// /// -// /// Being based on the edge of the document as it is, this property takes into account any horizontal scrolling of the page. For example, if the page is scrolled such that 200 pixels of the left side of the document are scrolled out of view, and the mouse is clicked 100 pixels inward from the left edge of the view, the value returned by pageX will be 300. -// pub page_x: i32, - -// /// The Y (vertical) coordinate in pixels of the event relative to the whole document. -// /// -// /// See `page_x`. -// pub page_y: i32, - -// /// The X coordinate of the mouse pointer in global (screen) coordinates. -// pub screen_x: i32, - -// /// The Y coordinate of the mouse pointer in global (screen) coordinates. -// pub screen_y: i32, - -// /// True if the shift key was down when the mouse event was fired. -// pub shift_key: bool, -// } - pub trait PointInteraction: std::any::Any { /// Gets the coordinates of the pointer event. fn coordinates(&self) -> Coordinates { @@ -100,7 +39,7 @@ pub trait PointInteraction: std::any::Any { } #[cfg(feature = "serialize")] -#[derive(serde::Serialize, serde::Deserialize)] +#[derive(serde::Serialize, serde::Deserialize, Debug, PartialEq, Clone, Default)] pub(crate) struct SerializedPointInteraction { pub(crate) client_coordinates: ClientPoint, pub(crate) element_coordinates: ElementPoint, @@ -111,6 +50,30 @@ pub(crate) struct SerializedPointInteraction { pub(crate) trigger_button: Option, } +#[cfg(feature = "serialize")] +impl SerializedPointInteraction { + /// Create a new serialized point interaction. + pub fn new( + client_coordinates: ClientPoint, + element_coordinates: ElementPoint, + page_coordinates: PagePoint, + screen_coordinates: ScreenPoint, + modifiers: Modifiers, + held_buttons: MouseButtonSet, + trigger_button: Option, + ) -> Self { + Self { + client_coordinates, + element_coordinates, + page_coordinates, + screen_coordinates, + modifiers, + held_buttons, + trigger_button, + } + } +} + #[cfg(feature = "serialize")] impl From<&E> for SerializedPointInteraction { fn from(data: &E) -> Self { diff --git a/packages/html/src/transit.rs b/packages/html/src/transit.rs index b27f8670a..b34a4b882 100644 --- a/packages/html/src/transit.rs +++ b/packages/html/src/transit.rs @@ -189,7 +189,7 @@ impl EventData { fn test_back_and_forth() { let data = HtmlEvent { element: ElementId(0), - data: EventData::Mouse(MouseData::default()), + data: EventData::Mouse(SerializedMouseData::default().into()), name: "click".to_string(), bubbles: true, }; From 0ef765e060dde3cb4a4ace929895fd5f9b89a9a5 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Mon, 28 Aug 2023 12:35:55 -0500 Subject: [PATCH 054/447] move rink over to the new event system --- packages/rink/src/hooks.rs | 134 ++++++++++++++----------- packages/rink/src/widgets/button.rs | 2 +- packages/rink/src/widgets/checkbox.rs | 2 +- packages/rink/src/widgets/number.rs | 2 +- packages/rink/src/widgets/slider.rs | 7 +- packages/rink/src/widgets/text_like.rs | 9 +- 6 files changed, 86 insertions(+), 70 deletions(-) diff --git a/packages/rink/src/hooks.rs b/packages/rink/src/hooks.rs index b6b34458c..f6caf484c 100644 --- a/packages/rink/src/hooks.rs +++ b/packages/rink/src/hooks.rs @@ -2,22 +2,21 @@ use crossterm::event::{ Event as TermEvent, KeyCode as TermKeyCode, KeyModifiers, ModifierKeyCode, MouseButton, MouseEventKind, }; +use dioxus_html::{ + HasFormData, HasKeyboardData, HasWheelData, SerializedFocusData, SerializedKeyboardData, + SerializedMouseData, SerializedWheelData, +}; use dioxus_native_core::prelude::*; use dioxus_native_core::real_dom::NodeImmutable; use rustc_hash::{FxHashMap, FxHashSet}; use dioxus_html::geometry::euclid::{Point2D, Rect, Size2D}; -use dioxus_html::geometry::{ - ClientPoint, Coordinates, ElementPoint, PagePoint, ScreenPoint, WheelDelta, -}; +use dioxus_html::geometry::{ClientPoint, ElementPoint, PagePoint, ScreenPoint, WheelDelta}; use dioxus_html::input_data::keyboard_types::{Code, Key, Location, Modifiers}; use dioxus_html::input_data::{ MouseButton as DioxusMouseButton, MouseButtonSet as DioxusMouseButtons, }; -use dioxus_html::point_interaction::PointData; -use dioxus_html::{ - event_bubbles, prelude::PointInteraction, FocusData, KeyboardData, MouseData, WheelData, -}; +use dioxus_html::{event_bubbles, prelude::PointInteraction}; use std::any::Any; use std::collections::HashMap; use std::{ @@ -42,10 +41,10 @@ pub struct Event { #[derive(Debug, Clone, PartialEq)] pub enum EventData { - Mouse(MouseData), - Keyboard(KeyboardData), - Focus(FocusData), - Wheel(WheelData), + Mouse(SerializedMouseData), + Keyboard(SerializedKeyboardData), + Focus(SerializedFocusData), + Wheel(SerializedWheelData), Form(FormData), } @@ -70,13 +69,23 @@ pub struct FormData { pub files: Option, } +impl HasFormData for FormData { + fn value(&self) -> String { + self.value.clone() + } + + fn values(&self) -> HashMap> { + self.values.clone() + } + + fn as_any(&self) -> &dyn std::any::Any { + self + } +} + impl FormData { fn into_html(self) -> dioxus_html::FormData { - dioxus_html::FormData { - value: self.value, - values: self.values, - files: None, - } + dioxus_html::FormData::new(self) } } @@ -93,9 +102,9 @@ type EventCore = (&'static str, EventData); const MAX_REPEAT_TIME: Duration = Duration::from_millis(100); pub struct InnerInputState { - mouse: Option, - wheel: Option, - last_key_pressed: Option<(KeyboardData, Instant)>, + mouse: Option, + wheel: Option, + last_key_pressed: Option<(SerializedKeyboardData, Instant)>, pub(crate) focus_state: FocusState, // subscribers: Vec>, } @@ -137,12 +146,16 @@ impl InnerInputState { _ => {} } - let new_mouse_data = MouseData::new(PointData::new( - m.trigger_button(), - held_buttons, - m.coordinates(), + let coordinates = m.coordinates(); + let new_mouse_data = SerializedMouseData::new( + m.client_coordinates(), + coordinates.element(), + m.page_coordinates(), + m.screen_coordinates(), m.modifiers(), - )); + held_buttons, + m.trigger_button(), + ); self.mouse = Some(new_mouse_data.clone()); *m = new_mouse_data; @@ -159,7 +172,13 @@ impl InnerInputState { .is_some(); if is_repeating { - *k = KeyboardData::new(k.key(), k.code(), k.location(), true, k.modifiers()); + *k = SerializedKeyboardData::new( + is_repeating, + k.code(), + k.key(), + k.location(), + k.modifiers(), + ); } self.last_key_pressed = Some((k.clone(), Instant::now())); @@ -203,13 +222,13 @@ impl InnerInputState { resolved_events.push(Event { name: "focus", id, - data: EventData::Focus(FocusData {}), + data: EventData::Focus(SerializedFocusData::default()), bubbles: event_bubbles("focus"), }); resolved_events.push(Event { name: "focusin", id, - data: EventData::Focus(FocusData {}), + data: EventData::Focus(SerializedFocusData::default()), bubbles: event_bubbles("focusin"), }); } @@ -217,7 +236,7 @@ impl InnerInputState { resolved_events.push(Event { name: "focusout", id, - data: EventData::Focus(FocusData {}), + data: EventData::Focus(SerializedFocusData::default()), bubbles: event_bubbles("focusout"), }); } @@ -230,7 +249,7 @@ impl InnerInputState { fn resolve_mouse_events( &mut self, - previous_mouse: Option, + previous_mouse: Option, resolved_events: &mut Vec, layout: &Taffy, dom: &mut RealDom, @@ -277,7 +296,10 @@ impl InnerInputState { } } - fn prepare_mouse_data(mouse_data: &MouseData, layout: &Layout) -> MouseData { + fn prepare_mouse_data( + mouse_data: &SerializedMouseData, + layout: &Layout, + ) -> SerializedMouseData { let Point { x, y } = layout.location; let node_origin = ClientPoint::new( layout_to_screen_space(x).into(), @@ -288,19 +310,15 @@ impl InnerInputState { .to_point() .cast_unit(); - let coordinates = Coordinates::new( - mouse_data.screen_coordinates(), + SerializedMouseData::new( mouse_data.client_coordinates(), new_client_coordinates, mouse_data.page_coordinates(), - ); - - MouseData::new(PointData::new( - mouse_data.trigger_button(), - mouse_data.held_buttons(), - coordinates, + mouse_data.screen_coordinates(), mouse_data.modifiers(), - )) + mouse_data.held_buttons(), + mouse_data.trigger_button(), + ) } if let Some(mouse_data) = &self.mouse { @@ -693,17 +711,6 @@ fn get_event(evt: TermEvent) -> Option<(&'static str, EventData)> { // from https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent - // The `page` and `screen` coordinates are inconsistent with the MDN definition, as they are relative to the viewport (client), not the target element/page/screen, respectively. - // todo? - // But then, MDN defines them in terms of pixels, yet crossterm provides only row/column, and it might not be possible to get pixels. So we can't get 100% consistency anyway. - let coordinates = Coordinates::new( - ScreenPoint::new(x, y), - ClientPoint::new(x, y), - // offset x/y are set when the origin of the event is assigned to an element - ElementPoint::new(0., 0.), - PagePoint::new(x, y), - ); - let mut modifiers = Modifiers::empty(); if shift { modifiers.insert(Modifiers::SHIFT); @@ -719,17 +726,24 @@ fn get_event(evt: TermEvent) -> Option<(&'static str, EventData)> { } // held mouse buttons get set later by maintaining state, as crossterm does not provide them - EventData::Mouse(MouseData::new(PointData::new( - button, - DioxusMouseButtons::empty(), - coordinates, + EventData::Mouse(SerializedMouseData::new( + // The `page` and `screen` coordinates are inconsistent with the MDN definition, as they are relative to the viewport (client), not the target element/page/screen, respectively. + // todo? + // But then, MDN defines them in terms of pixels, yet crossterm provides only row/column, and it might not be possible to get pixels. So we can't get 100% consistency anyway. + ClientPoint::new(x, y), + // offset x/y are set when the origin of the event is assigned to an element + ElementPoint::new(0., 0.), + PagePoint::new(x, y), + ScreenPoint::new(x, y), modifiers, - ))) + DioxusMouseButtons::empty(), + button, + )) }; let get_wheel_data = |up| { let y = if up { -1.0 } else { 1.0 }; - EventData::Wheel(WheelData::new(WheelDelta::lines(0., y, 0.))) + EventData::Wheel(SerializedWheelData::new(WheelDelta::lines(0., y, 0.))) }; match m.kind { @@ -754,11 +768,11 @@ fn translate_key_event(event: crossterm::event::KeyEvent) -> Option { let code = guess_code_from_crossterm_key_code(event.code)?; let modifiers = modifiers_from_crossterm_modifiers(event.modifiers); - Some(EventData::Keyboard(KeyboardData::new( - key, - code, - Location::Standard, + Some(EventData::Keyboard(SerializedKeyboardData::new( false, + code, + key, + Location::Standard, modifiers, ))) } diff --git a/packages/rink/src/widgets/button.rs b/packages/rink/src/widgets/button.rs index 523b2392a..d07dd79f0 100644 --- a/packages/rink/src/widgets/button.rs +++ b/packages/rink/src/widgets/button.rs @@ -1,6 +1,6 @@ use std::collections::HashMap; -use dioxus_html::input_data::keyboard_types::Key; +use dioxus_html::{input_data::keyboard_types::Key, HasKeyboardData}; use dioxus_native_core::{ custom_element::CustomElement, node::OwnedAttributeDiscription, diff --git a/packages/rink/src/widgets/checkbox.rs b/packages/rink/src/widgets/checkbox.rs index fab809ed2..fe878e5b8 100644 --- a/packages/rink/src/widgets/checkbox.rs +++ b/packages/rink/src/widgets/checkbox.rs @@ -1,6 +1,6 @@ use std::collections::HashMap; -use dioxus_html::input_data::keyboard_types::Key; +use dioxus_html::{input_data::keyboard_types::Key, HasKeyboardData}; use dioxus_native_core::{ custom_element::CustomElement, node::OwnedAttributeDiscription, diff --git a/packages/rink/src/widgets/number.rs b/packages/rink/src/widgets/number.rs index 371c8b41d..c2a71ceac 100644 --- a/packages/rink/src/widgets/number.rs +++ b/packages/rink/src/widgets/number.rs @@ -1,4 +1,4 @@ -use dioxus_html::input_data::keyboard_types::Key; +use dioxus_html::{input_data::keyboard_types::Key, HasKeyboardData}; use dioxus_native_core::{ custom_element::CustomElement, real_dom::{NodeImmutable, RealDom}, diff --git a/packages/rink/src/widgets/slider.rs b/packages/rink/src/widgets/slider.rs index 3af995e09..5cef645cf 100644 --- a/packages/rink/src/widgets/slider.rs +++ b/packages/rink/src/widgets/slider.rs @@ -1,7 +1,8 @@ use std::collections::HashMap; use dioxus_html::{ - input_data::keyboard_types::Key, prelude::PointInteraction, KeyboardData, MouseData, + input_data::keyboard_types::Key, prelude::PointInteraction, HasKeyboardData, + SerializedKeyboardData, SerializedMouseData, }; use dioxus_native_core::{ custom_element::CustomElement, @@ -211,7 +212,7 @@ impl Slider { } } - fn handle_keydown(&mut self, mut root: NodeMut, data: &KeyboardData) { + fn handle_keydown(&mut self, mut root: NodeMut, data: &SerializedKeyboardData) { let key = data.key(); let step = self.step(); @@ -233,7 +234,7 @@ impl Slider { self.write_value(rdom, id); } - fn handle_mousemove(&mut self, mut root: NodeMut, data: &MouseData) { + fn handle_mousemove(&mut self, mut root: NodeMut, data: &SerializedMouseData) { if !data.held_buttons().is_empty() { let id = root.id(); let rdom = root.real_dom_mut(); diff --git a/packages/rink/src/widgets/text_like.rs b/packages/rink/src/widgets/text_like.rs index 5bfebd0ab..e7869600a 100644 --- a/packages/rink/src/widgets/text_like.rs +++ b/packages/rink/src/widgets/text_like.rs @@ -2,7 +2,8 @@ use std::{collections::HashMap, io::stdout}; use crossterm::{cursor::MoveTo, execute}; use dioxus_html::{ - input_data::keyboard_types::Key, prelude::PointInteraction, KeyboardData, MouseData, + input_data::keyboard_types::Key, prelude::PointInteraction, HasKeyboardData, + SerializedKeyboardData, SerializedMouseData, }; use dioxus_native_core::{ custom_element::CustomElement, @@ -186,7 +187,7 @@ impl TextLike { } } - fn handle_keydown(&mut self, mut root: NodeMut, data: &KeyboardData) { + fn handle_keydown(&mut self, mut root: NodeMut, data: &SerializedKeyboardData) { let key = data.key(); let modifiers = data.modifiers(); let code = data.code(); @@ -230,7 +231,7 @@ impl TextLike { } } - fn handle_mousemove(&mut self, mut root: NodeMut, data: &MouseData) { + fn handle_mousemove(&mut self, mut root: NodeMut, data: &SerializedMouseData) { if self.dragging { let id = root.id(); let offset = data.element_coordinates(); @@ -247,7 +248,7 @@ impl TextLike { } } - fn handle_mousedown(&mut self, mut root: NodeMut, data: &MouseData) { + fn handle_mousedown(&mut self, mut root: NodeMut, data: &SerializedMouseData) { let offset = data.element_coordinates(); let mut new = Pos::new(offset.x as usize, offset.y as usize); From 62556b2c34eab4cf33bafd1c6e556278f11bcd26 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Mon, 28 Aug 2023 12:43:21 -0500 Subject: [PATCH 055/447] fix desktop and liveview compilation --- packages/desktop/Cargo.toml | 2 +- packages/liveview/Cargo.toml | 2 +- packages/liveview/src/element.rs | 4 ++-- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/packages/desktop/Cargo.toml b/packages/desktop/Cargo.toml index a85c2e045..aaeb7f6ca 100644 --- a/packages/desktop/Cargo.toml +++ b/packages/desktop/Cargo.toml @@ -11,7 +11,7 @@ keywords = ["dom", "ui", "gui", "react"] [dependencies] dioxus-core = { workspace = true, features = ["serialize"] } -dioxus-html = { workspace = true, features = ["serialize", "native-bind"] } +dioxus-html = { workspace = true, features = ["serialize", "native-bind", "mounted", "eval"] } dioxus-interpreter-js = { workspace = true } dioxus-hot-reload = { workspace = true, optional = true } diff --git a/packages/liveview/Cargo.toml b/packages/liveview/Cargo.toml index 3dfce5bf4..a1309e809 100644 --- a/packages/liveview/Cargo.toml +++ b/packages/liveview/Cargo.toml @@ -22,7 +22,7 @@ tokio-stream = { version = "0.1.11", features = ["net"] } tokio-util = { version = "0.7.4", features = ["rt"] } serde = { version = "1.0.151", features = ["derive"] } serde_json = "1.0.91" -dioxus-html = { workspace = true, features = ["serialize"] } +dioxus-html = { workspace = true, features = ["serialize", "eval", "mounted"] } dioxus-core = { workspace = true, features = ["serialize"] } dioxus-interpreter-js = { workspace = true } dioxus-hot-reload = { workspace = true, optional = true } diff --git a/packages/liveview/src/element.rs b/packages/liveview/src/element.rs index ae0eb4efe..d813a47d5 100644 --- a/packages/liveview/src/element.rs +++ b/packages/liveview/src/element.rs @@ -16,8 +16,8 @@ impl LiveviewElement { } impl RenderedElementBacking for LiveviewElement { - fn get_raw_element(&self) -> dioxus_html::MountedResult<&dyn std::any::Any> { - Ok(self) + fn as_any(&self) -> &dyn std::any::Any { + self } fn get_client_rect( From bd387d601c1f721fe575858fb6ba5b124b719b6a Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Mon, 28 Aug 2023 15:49:46 -0500 Subject: [PATCH 056/447] fix formatting --- packages/html/src/events/drag.rs | 4 ++-- packages/web/src/dom.rs | 4 +++- 2 files changed, 5 insertions(+), 3 deletions(-) diff --git a/packages/html/src/events/drag.rs b/packages/html/src/events/drag.rs index 004ea6612..aa01b4748 100644 --- a/packages/html/src/events/drag.rs +++ b/packages/html/src/events/drag.rs @@ -1,6 +1,6 @@ use crate::geometry::{ClientPoint, Coordinates, ElementPoint, PagePoint, ScreenPoint}; use crate::input_data::{MouseButton, MouseButtonSet}; -use crate::prelude::PointInteraction; + use dioxus_core::Event; use keyboard_types::Modifiers; @@ -132,7 +132,7 @@ impl HasMouseData for SerializedDragData { } #[cfg(feature = "serialize")] -impl PointInteraction for SerializedDragData { +impl crate::prelude::PointInteraction for SerializedDragData { fn client_coordinates(&self) -> ClientPoint { self.mouse.client_coordinates() } diff --git a/packages/web/src/dom.rs b/packages/web/src/dom.rs index 3a38b22b6..1b7a11ca0 100644 --- a/packages/web/src/dom.rs +++ b/packages/web/src/dom.rs @@ -330,7 +330,9 @@ impl HtmlEventConverter for WebEventConverter { fn convert_mounted_data(&self, event: &dioxus_html::PlatformEventData) -> MountedData { #[cfg(feature = "mounted")] - {MountedData::from(downcast_event(event).element.clone())} + { + MountedData::from(downcast_event(event).element.clone()) + } #[cfg(not(feature = "mounted"))] { panic!("mounted events are not supported without the mounted feature on the dioxus-web crate enabled") From 8ba1c05a939b0e31b59d075a6490e0d35fc21f6e Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Mon, 28 Aug 2023 16:37:19 -0500 Subject: [PATCH 057/447] fix desktop events --- packages/desktop/src/element.rs | 1 + packages/desktop/src/events.rs | 147 ++++++++++++++++++++++ packages/desktop/src/lib.rs | 15 ++- packages/html/src/events/drag.rs | 94 ++++++-------- packages/html/src/events/keyboard.rs | 73 +++++++---- packages/html/src/events/mouse.rs | 18 +-- packages/html/src/events/wheel.rs | 24 +++- packages/html/src/point_interaction.rs | 165 +++++++++++++++++-------- packages/html/src/transit.rs | 106 ++++++++++------ packages/rink/src/hooks.rs | 54 ++++---- packages/web/src/dom.rs | 18 +-- packages/web/src/lib.rs | 9 +- 12 files changed, 507 insertions(+), 217 deletions(-) diff --git a/packages/desktop/src/element.rs b/packages/desktop/src/element.rs index 8239099cb..86741d415 100644 --- a/packages/desktop/src/element.rs +++ b/packages/desktop/src/element.rs @@ -3,6 +3,7 @@ use dioxus_html::{geometry::euclid::Rect, MountedResult, RenderedElementBacking} use crate::{desktop_context::DesktopContext, query::QueryEngine}; +#[derive(Clone)] /// A mounted element passed to onmounted events pub struct DesktopElement { id: ElementId, diff --git a/packages/desktop/src/events.rs b/packages/desktop/src/events.rs index 7059a7c85..a4fbb4e1e 100644 --- a/packages/desktop/src/events.rs +++ b/packages/desktop/src/events.rs @@ -1,7 +1,10 @@ //! Convert a serialized event to an event trigger +use dioxus_html::*; use serde::{Deserialize, Serialize}; +use crate::element::DesktopElement; + #[derive(Deserialize, Serialize, Debug, Clone)] pub struct IpcMessage { method: String, @@ -17,3 +20,147 @@ impl IpcMessage { self.params } } + +pub(crate) struct SerializedHtmlEventConverter; + +impl HtmlEventConverter for SerializedHtmlEventConverter { + fn convert_animation_data(&self, event: &PlatformEventData) -> AnimationData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_clipboard_data(&self, event: &PlatformEventData) -> ClipboardData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_composition_data(&self, event: &PlatformEventData) -> CompositionData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_drag_data(&self, event: &PlatformEventData) -> DragData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_focus_data(&self, event: &PlatformEventData) -> FocusData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_form_data(&self, event: &PlatformEventData) -> FormData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_image_data(&self, event: &PlatformEventData) -> ImageData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_keyboard_data(&self, event: &PlatformEventData) -> KeyboardData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_media_data(&self, event: &PlatformEventData) -> MediaData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_mounted_data(&self, event: &PlatformEventData) -> MountedData { + event.downcast::().cloned().unwrap().into() + } + + fn convert_mouse_data(&self, event: &PlatformEventData) -> MouseData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_pointer_data(&self, event: &PlatformEventData) -> PointerData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_scroll_data(&self, event: &PlatformEventData) -> ScrollData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_selection_data(&self, event: &PlatformEventData) -> SelectionData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_toggle_data(&self, event: &PlatformEventData) -> ToggleData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_touch_data(&self, event: &PlatformEventData) -> TouchData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_transition_data(&self, event: &PlatformEventData) -> TransitionData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_wheel_data(&self, event: &PlatformEventData) -> WheelData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } +} diff --git a/packages/desktop/src/lib.rs b/packages/desktop/src/lib.rs index e1a94fbfc..3d72b487c 100644 --- a/packages/desktop/src/lib.rs +++ b/packages/desktop/src/lib.rs @@ -28,9 +28,10 @@ pub use desktop_context::{ use desktop_context::{EventData, UserWindowEvent, WebviewQueue, WindowEventHandlers}; use dioxus_core::*; use dioxus_html::{native_bind::NativeFileEngine, HtmlEvent}; -use dioxus_html::{FileEngine, HasFormData, MountedData}; +use dioxus_html::{FileEngine, HasFormData, MountedData, PlatformEventData}; use element::DesktopElement; use eval::init_eval; +use events::SerializedHtmlEventConverter; use futures_util::{pin_mut, FutureExt}; use shortcut::ShortcutRegistry; pub use shortcut::{use_global_shortcut, ShortcutHandle, ShortcutId, ShortcutRegistryError}; @@ -136,6 +137,9 @@ pub fn launch_with_props(root: Component

, props: P, cfg: Config) } }); + // Set the event converter + dioxus_html::set_event_converter(Box::new(SerializedHtmlEventConverter)); + // We start the tokio runtime *on this thread* // Any future we poll later will use this runtime to spawn tasks and for IO let rt = tokio::runtime::Builder::new_multi_thread() @@ -292,7 +296,7 @@ pub fn launch_with_props(root: Component

, props: P, cfg: Config) let element = DesktopElement::new(element, view.desktop_context.clone(), query); - Rc::new(MountedData::new(element)) + Rc::new(PlatformEventData::new(Box::new(MountedData::new(element)))) } else { data.into_any() }; @@ -358,9 +362,10 @@ pub fn launch_with_props(root: Component

, props: P, cfg: Config) let event_name = &file_diolog.event; let event_bubbles = file_diolog.bubbles; let files = file_upload::get_file_event(&file_diolog); - let data = Rc::new(DesktopFileUploadForm { - files: Arc::new(NativeFileEngine::new(files)), - }); + let data = + Rc::new(PlatformEventData::new(Box::new(DesktopFileUploadForm { + files: Arc::new(NativeFileEngine::new(files)), + }))); let view = webviews.get_mut(&event.1).unwrap(); diff --git a/packages/html/src/events/drag.rs b/packages/html/src/events/drag.rs index aa01b4748..67da07721 100644 --- a/packages/html/src/events/drag.rs +++ b/packages/html/src/events/drag.rs @@ -1,5 +1,6 @@ use crate::geometry::{ClientPoint, Coordinates, ElementPoint, PagePoint, ScreenPoint}; use crate::input_data::{MouseButton, MouseButtonSet}; +use crate::prelude::PointInteraction; use dioxus_core::Event; use keyboard_types::Modifiers; @@ -43,60 +44,47 @@ impl PartialEq for DragData { } impl DragData { - /// The event's coordinates relative to the application's viewport (as opposed to the coordinate within the page). - /// - /// For example, clicking in the top left corner of the viewport will always result in a mouse event with client coordinates (0., 0.), regardless of whether the page is scrolled horizontally. - pub fn client_coordinates(&self) -> ClientPoint { - self.inner.client_coordinates() - } - - /// The event's coordinates relative to the padding edge of the target element - /// - /// For example, clicking in the top left corner of an element will result in element coordinates (0., 0.) - pub fn element_coordinates(&self) -> ElementPoint { - self.inner.element_coordinates() - } - - /// The event's coordinates relative to the entire document. This includes any portion of the document not currently visible. - /// - /// For example, if the page is scrolled 200 pixels to the right and 300 pixels down, clicking in the top left corner of the viewport would result in page coordinates (200., 300.) - pub fn page_coordinates(&self) -> PagePoint { - self.inner.page_coordinates() - } - - /// The event's coordinates relative to the entire screen. This takes into account the window's offset. - pub fn screen_coordinates(&self) -> ScreenPoint { - self.inner.screen_coordinates() - } - - pub fn coordinates(&self) -> Coordinates { - self.inner.coordinates() - } - - /// The set of modifier keys which were pressed when the event occurred - pub fn modifiers(&self) -> Modifiers { - self.inner.modifiers() - } - - /// The set of mouse buttons which were held when the event occurred. - pub fn held_buttons(&self) -> MouseButtonSet { - self.inner.held_buttons() - } - - /// The mouse button that triggered the event - /// - // todo the following is kind of bad; should we just return None when the trigger_button is unreliable (and frankly irrelevant)? i guess we would need the event_type here - /// This is only guaranteed to indicate which button was pressed during events caused by pressing or releasing a button. As such, it is not reliable for events such as mouseenter, mouseleave, mouseover, mouseout, or mousemove. For example, a value of MouseButton::Primary may also indicate that no button was pressed. - pub fn trigger_button(&self) -> Option { - self.inner.trigger_button() - } - /// Downcast this event data to a specific type pub fn downcast(&self) -> Option<&T> { self.inner.as_any().downcast_ref::() } } +impl PointInteraction for DragData { + fn client_coordinates(&self) -> ClientPoint { + self.inner.client_coordinates() + } + + fn element_coordinates(&self) -> ElementPoint { + self.inner.element_coordinates() + } + + fn page_coordinates(&self) -> PagePoint { + self.inner.page_coordinates() + } + + fn screen_coordinates(&self) -> ScreenPoint { + self.inner.screen_coordinates() + } + + fn coordinates(&self) -> Coordinates { + self.inner.coordinates() + } + + fn modifiers(&self) -> Modifiers { + self.inner.modifiers() + } + + fn held_buttons(&self) -> MouseButtonSet { + self.inner.held_buttons() + } + + // todo the following is kind of bad; should we just return None when the trigger_button is unreliable (and frankly irrelevant)? i guess we would need the event_type here + fn trigger_button(&self) -> Option { + self.inner.trigger_button() + } +} + #[cfg(feature = "serialize")] /// A serialized version of DragData #[derive(serde::Serialize, serde::Deserialize, Debug, PartialEq, Clone)] @@ -108,15 +96,7 @@ pub struct SerializedDragData { impl From<&DragData> for SerializedDragData { fn from(data: &DragData) -> Self { Self { - mouse: crate::point_interaction::SerializedPointInteraction { - client_coordinates: data.client_coordinates(), - element_coordinates: data.element_coordinates(), - page_coordinates: data.page_coordinates(), - screen_coordinates: data.screen_coordinates(), - modifiers: data.modifiers(), - held_buttons: data.held_buttons(), - trigger_button: data.trigger_button(), - }, + mouse: crate::point_interaction::SerializedPointInteraction::from(data), } } } diff --git a/packages/html/src/events/keyboard.rs b/packages/html/src/events/keyboard.rs index 2af582089..c4c6115c1 100644 --- a/packages/html/src/events/keyboard.rs +++ b/packages/html/src/events/keyboard.rs @@ -81,30 +81,46 @@ impl KeyboardData { /// A serialized version of KeyboardData #[derive(serde::Serialize, serde::Deserialize, Debug, PartialEq, Clone)] pub struct SerializedKeyboardData { - auto_repeating: bool, + char_code: u32, + key: String, + key_code: KeyCode, #[serde(deserialize_with = "resilient_deserialize_code")] code: Code, - key: Key, - location: Location, - modifiers: Modifiers, + alt_key: bool, + ctrl_key: bool, + meta_key: bool, + shift_key: bool, + location: usize, + repeat: bool, + which: usize, } #[cfg(feature = "serialize")] impl SerializedKeyboardData { /// Create a new SerializedKeyboardData pub fn new( - auto_repeating: bool, - code: Code, key: Key, + code: Code, location: Location, + is_auto_repeating: bool, modifiers: Modifiers, ) -> Self { Self { - auto_repeating, + char_code: key.legacy_charcode(), + key: key.to_string(), + key_code: KeyCode::from_raw_code( + std::convert::TryInto::try_into(key.legacy_keycode()) + .expect("could not convert keycode to u8"), + ), code, - key, - location, - modifiers, + alt_key: modifiers.contains(Modifiers::ALT), + ctrl_key: modifiers.contains(Modifiers::CONTROL), + meta_key: modifiers.contains(Modifiers::META), + shift_key: modifiers.contains(Modifiers::SHIFT), + location: crate::input_data::encode_key_location(location), + repeat: is_auto_repeating, + which: std::convert::TryInto::try_into(key.legacy_charcode()) + .expect("could not convert charcode to usize"), } } } @@ -112,20 +128,20 @@ impl SerializedKeyboardData { #[cfg(feature = "serialize")] impl From<&KeyboardData> for SerializedKeyboardData { fn from(data: &KeyboardData) -> Self { - Self { - auto_repeating: data.is_auto_repeating(), - code: data.code(), - key: data.key(), - location: data.location(), - modifiers: data.modifiers(), - } + Self::new( + data.key(), + data.code(), + data.location(), + data.is_auto_repeating(), + data.modifiers(), + ) } } #[cfg(feature = "serialize")] impl HasKeyboardData for SerializedKeyboardData { fn key(&self) -> Key { - self.key.clone() + std::str::FromStr::from_str(&self.key).unwrap_or(Key::Unidentified) } fn code(&self) -> Code { @@ -133,15 +149,30 @@ impl HasKeyboardData for SerializedKeyboardData { } fn modifiers(&self) -> Modifiers { - self.modifiers + let mut modifiers = Modifiers::empty(); + + if self.alt_key { + modifiers.insert(Modifiers::ALT); + } + if self.ctrl_key { + modifiers.insert(Modifiers::CONTROL); + } + if self.meta_key { + modifiers.insert(Modifiers::META); + } + if self.shift_key { + modifiers.insert(Modifiers::SHIFT); + } + + modifiers } fn location(&self) -> Location { - self.location + crate::input_data::decode_key_location(self.location) } fn is_auto_repeating(&self) -> bool { - self.auto_repeating + self.repeat } fn as_any(&self) -> &dyn std::any::Any { diff --git a/packages/html/src/events/mouse.rs b/packages/html/src/events/mouse.rs index 0e73ef4f6..c6a98e25e 100644 --- a/packages/html/src/events/mouse.rs +++ b/packages/html/src/events/mouse.rs @@ -191,23 +191,17 @@ pub struct SerializedMouseData { impl SerializedMouseData { /// Create a new instance of SerializedMouseData pub fn new( - client_coordinates: ClientPoint, - element_coordinates: ElementPoint, - page_coordinates: PagePoint, - screen_coordinates: ScreenPoint, - modifiers: Modifiers, - held_buttons: MouseButtonSet, trigger_button: Option, + held_buttons: MouseButtonSet, + coordinates: Coordinates, + modifiers: Modifiers, ) -> Self { Self { point_data: crate::point_interaction::SerializedPointInteraction::new( - client_coordinates, - element_coordinates, - page_coordinates, - screen_coordinates, - modifiers, - held_buttons, trigger_button, + held_buttons, + coordinates, + modifiers, ), } } diff --git a/packages/html/src/events/wheel.rs b/packages/html/src/events/wheel.rs index 72550d835..157a8dc06 100644 --- a/packages/html/src/events/wheel.rs +++ b/packages/html/src/events/wheel.rs @@ -46,30 +46,42 @@ impl WheelData { /// A serialized version of WheelData #[derive(serde::Serialize, serde::Deserialize, Debug, PartialEq, Clone)] pub struct SerializedWheelData { - delta: WheelDelta, + pub delta_mode: u32, + pub delta_x: f64, + pub delta_y: f64, + pub delta_z: f64, } #[cfg(feature = "serialize")] impl SerializedWheelData { /// Create a new SerializedWheelData pub fn new(delta: WheelDelta) -> Self { - Self { delta } + let delta_mode = match delta { + WheelDelta::Pixels(_) => 0, + WheelDelta::Lines(_) => 1, + WheelDelta::Pages(_) => 2, + }; + let delta_raw = delta.strip_units(); + Self { + delta_mode, + delta_x: delta_raw.x, + delta_y: delta_raw.y, + delta_z: delta_raw.z, + } } } #[cfg(feature = "serialize")] impl From<&WheelData> for SerializedWheelData { fn from(data: &WheelData) -> Self { - Self { - delta: data.inner.delta(), - } + Self::new(data.delta()) } } #[cfg(feature = "serialize")] impl HasWheelData for SerializedWheelData { fn delta(&self) -> WheelDelta { - self.delta + WheelDelta::from_web_attributes(self.delta_mode, self.delta_x, self.delta_y, self.delta_z) } fn as_any(&self) -> &dyn std::any::Any { diff --git a/packages/html/src/point_interaction.rs b/packages/html/src/point_interaction.rs index 0b2230ab3..f26917201 100644 --- a/packages/html/src/point_interaction.rs +++ b/packages/html/src/point_interaction.rs @@ -41,35 +41,98 @@ pub trait PointInteraction: std::any::Any { #[cfg(feature = "serialize")] #[derive(serde::Serialize, serde::Deserialize, Debug, PartialEq, Clone, Default)] pub(crate) struct SerializedPointInteraction { - pub(crate) client_coordinates: ClientPoint, - pub(crate) element_coordinates: ElementPoint, - pub(crate) page_coordinates: PagePoint, - pub(crate) screen_coordinates: ScreenPoint, - pub(crate) modifiers: Modifiers, - pub(crate) held_buttons: MouseButtonSet, - pub(crate) trigger_button: Option, + pub alt_key: bool, + + /// The button number that was pressed (if applicable) when the mouse event was fired. + pub button: i16, + + /// Indicates which buttons are pressed on the mouse (or other input device) when a mouse event is triggered. + /// + /// Each button that can be pressed is represented by a given number (see below). If more than one button is pressed, the button values are added together to produce a new number. For example, if the secondary (2) and auxiliary (4) buttons are pressed simultaneously, the value is 6 (i.e., 2 + 4). + /// + /// - 1: Primary button (usually the left button) + /// - 2: Secondary button (usually the right button) + /// - 4: Auxiliary button (usually the mouse wheel button or middle button) + /// - 8: 4th button (typically the "Browser Back" button) + /// - 16 : 5th button (typically the "Browser Forward" button) + pub buttons: u16, + + /// The horizontal coordinate within the application's viewport at which the event occurred (as opposed to the coordinate within the page). + /// + /// For example, clicking on the left edge of the viewport will always result in a mouse event with a clientX value of 0, regardless of whether the page is scrolled horizontally. + pub client_x: i32, + + /// The vertical coordinate within the application's viewport at which the event occurred (as opposed to the coordinate within the page). + /// + /// For example, clicking on the top edge of the viewport will always result in a mouse event with a clientY value of 0, regardless of whether the page is scrolled vertically. + pub client_y: i32, + + /// True if the control key was down when the mouse event was fired. + pub ctrl_key: bool, + + /// True if the meta key was down when the mouse event was fired. + pub meta_key: bool, + + /// The offset in the X coordinate of the mouse pointer between that event and the padding edge of the target node. + pub offset_x: i32, + + /// The offset in the Y coordinate of the mouse pointer between that event and the padding edge of the target node. + pub offset_y: i32, + + /// The X (horizontal) coordinate (in pixels) of the mouse, relative to the left edge of the entire document. This includes any portion of the document not currently visible. + /// + /// Being based on the edge of the document as it is, this property takes into account any horizontal scrolling of the page. For example, if the page is scrolled such that 200 pixels of the left side of the document are scrolled out of view, and the mouse is clicked 100 pixels inward from the left edge of the view, the value returned by pageX will be 300. + pub page_x: i32, + + /// The Y (vertical) coordinate in pixels of the event relative to the whole document. + /// + /// See `page_x`. + pub page_y: i32, + + /// The X coordinate of the mouse pointer in global (screen) coordinates. + pub screen_x: i32, + + /// The Y coordinate of the mouse pointer in global (screen) coordinates. + pub screen_y: i32, + + /// True if the shift key was down when the mouse event was fired. + pub shift_key: bool, } #[cfg(feature = "serialize")] impl SerializedPointInteraction { - /// Create a new serialized point interaction. pub fn new( - client_coordinates: ClientPoint, - element_coordinates: ElementPoint, - page_coordinates: PagePoint, - screen_coordinates: ScreenPoint, - modifiers: Modifiers, - held_buttons: MouseButtonSet, trigger_button: Option, + held_buttons: MouseButtonSet, + coordinates: Coordinates, + modifiers: Modifiers, ) -> Self { + let alt_key = modifiers.contains(Modifiers::ALT); + let ctrl_key = modifiers.contains(Modifiers::CONTROL); + let meta_key = modifiers.contains(Modifiers::META); + let shift_key = modifiers.contains(Modifiers::SHIFT); + + let [client_x, client_y]: [i32; 2] = coordinates.client().cast().into(); + let [offset_x, offset_y]: [i32; 2] = coordinates.element().cast().into(); + let [page_x, page_y]: [i32; 2] = coordinates.page().cast().into(); + let [screen_x, screen_y]: [i32; 2] = coordinates.screen().cast().into(); Self { - client_coordinates, - element_coordinates, - page_coordinates, - screen_coordinates, - modifiers, - held_buttons, - trigger_button, + button: trigger_button + .map_or(MouseButton::default(), |b| b) + .into_web_code(), + buttons: crate::input_data::encode_mouse_button_set(held_buttons), + meta_key, + ctrl_key, + shift_key, + alt_key, + client_x, + client_y, + screen_x, + screen_y, + offset_x, + offset_y, + page_x, + page_y, } } } @@ -77,54 +140,56 @@ impl SerializedPointInteraction { #[cfg(feature = "serialize")] impl From<&E> for SerializedPointInteraction { fn from(data: &E) -> Self { - Self { - client_coordinates: data.client_coordinates(), - element_coordinates: data.element_coordinates(), - page_coordinates: data.page_coordinates(), - screen_coordinates: data.screen_coordinates(), - modifiers: data.modifiers(), - held_buttons: data.held_buttons(), - trigger_button: data.trigger_button(), - } + let trigger_button = data.trigger_button(); + let held_buttons = data.held_buttons(); + let coordinates = data.coordinates(); + let modifiers = data.modifiers(); + Self::new(trigger_button, held_buttons, coordinates, modifiers) } } #[cfg(feature = "serialize")] impl PointInteraction for SerializedPointInteraction { fn client_coordinates(&self) -> ClientPoint { - self.client_coordinates - } - - fn element_coordinates(&self) -> ElementPoint { - self.element_coordinates - } - - fn page_coordinates(&self) -> PagePoint { - self.page_coordinates + ClientPoint::new(self.client_x.into(), self.client_y.into()) } fn screen_coordinates(&self) -> ScreenPoint { - self.screen_coordinates + ScreenPoint::new(self.screen_x.into(), self.screen_y.into()) } - fn coordinates(&self) -> Coordinates { - Coordinates::new( - self.screen_coordinates(), - self.client_coordinates(), - self.element_coordinates(), - self.page_coordinates(), - ) + fn element_coordinates(&self) -> ElementPoint { + ElementPoint::new(self.offset_x.into(), self.offset_y.into()) + } + + fn page_coordinates(&self) -> PagePoint { + PagePoint::new(self.page_x.into(), self.page_y.into()) } fn modifiers(&self) -> Modifiers { - self.modifiers + let mut modifiers = Modifiers::empty(); + + if self.alt_key { + modifiers.insert(Modifiers::ALT); + } + if self.ctrl_key { + modifiers.insert(Modifiers::CONTROL); + } + if self.meta_key { + modifiers.insert(Modifiers::META); + } + if self.shift_key { + modifiers.insert(Modifiers::SHIFT); + } + + modifiers } fn held_buttons(&self) -> MouseButtonSet { - self.held_buttons + crate::input_data::decode_mouse_button_set(self.buttons) } fn trigger_button(&self) -> Option { - self.trigger_button + Some(MouseButton::from_web_code(self.button)) } } diff --git a/packages/html/src/transit.rs b/packages/html/src/transit.rs index b34a4b882..8998b5fd7 100644 --- a/packages/html/src/transit.rs +++ b/packages/html/src/transit.rs @@ -4,6 +4,7 @@ use crate::events::*; use dioxus_core::ElementId; use serde::{Deserialize, Serialize}; +#[cfg(feature = "serialize")] #[derive(Serialize, Debug, PartialEq)] pub struct HtmlEvent { pub element: ElementId, @@ -12,6 +13,7 @@ pub struct HtmlEvent { pub data: EventData, } +#[cfg(feature = "serialize")] impl<'de> Deserialize<'de> for HtmlEvent { fn deserialize(deserializer: D) -> Result where @@ -41,6 +43,7 @@ impl<'de> Deserialize<'de> for HtmlEvent { } } +#[cfg(feature = "serialize")] fn fun_name( name: &str, data: serde_value::Value, @@ -130,6 +133,7 @@ fn fun_name( Ok(data) } +#[cfg(feature = "serialize")] impl HtmlEvent { pub fn bubbles(&self) -> bool { event_bubbles(&self.name) @@ -140,47 +144,79 @@ impl HtmlEvent { #[serde(untagged)] #[non_exhaustive] pub enum EventData { - Mouse(MouseData), - Clipboard(ClipboardData), - Composition(CompositionData), - Keyboard(KeyboardData), - Focus(FocusData), - Form(FormData), - Drag(DragData), - Pointer(PointerData), - Selection(SelectionData), - Touch(TouchData), - Scroll(ScrollData), - Wheel(WheelData), - Media(MediaData), - Animation(AnimationData), - Transition(TransitionData), - Toggle(ToggleData), - Image(ImageData), + Mouse(SerializedMouseData), + Clipboard(SerializedClipboardData), + Composition(SerializedCompositionData), + Keyboard(SerializedKeyboardData), + Focus(SerializedFocusData), + Form(SerializedFormData), + Drag(SerializedDragData), + Pointer(SerializedPointerData), + Selection(SerializedSelectionData), + Touch(SerializedTouchData), + Scroll(SerializedScrollData), + Wheel(SerializedWheelData), + Media(SerializedMediaData), + Animation(SerializedAnimationData), + Transition(SerializedTransitionData), + Toggle(SerializedToggleData), + Image(SerializedImageData), Mounted, } impl EventData { pub fn into_any(self) -> Rc { match self { - EventData::Mouse(data) => Rc::new(data) as Rc, - EventData::Clipboard(data) => Rc::new(data) as Rc, - EventData::Composition(data) => Rc::new(data) as Rc, - EventData::Keyboard(data) => Rc::new(data) as Rc, - EventData::Focus(data) => Rc::new(data) as Rc, - EventData::Form(data) => Rc::new(data) as Rc, - EventData::Drag(data) => Rc::new(data) as Rc, - EventData::Pointer(data) => Rc::new(data) as Rc, - EventData::Selection(data) => Rc::new(data) as Rc, - EventData::Touch(data) => Rc::new(data) as Rc, - EventData::Scroll(data) => Rc::new(data) as Rc, - EventData::Wheel(data) => Rc::new(data) as Rc, - EventData::Media(data) => Rc::new(data) as Rc, - EventData::Animation(data) => Rc::new(data) as Rc, - EventData::Transition(data) => Rc::new(data) as Rc, - EventData::Toggle(data) => Rc::new(data) as Rc, - EventData::Image(data) => Rc::new(data) as Rc, - EventData::Mounted => Rc::new(MountedData::new(())) as Rc, + EventData::Mouse(data) => { + Rc::new(PlatformEventData::new(Box::new(data))) as Rc + } + EventData::Clipboard(data) => { + Rc::new(PlatformEventData::new(Box::new(data))) as Rc + } + EventData::Composition(data) => { + Rc::new(PlatformEventData::new(Box::new(data))) as Rc + } + EventData::Keyboard(data) => { + Rc::new(PlatformEventData::new(Box::new(data))) as Rc + } + EventData::Focus(data) => { + Rc::new(PlatformEventData::new(Box::new(data))) as Rc + } + EventData::Form(data) => Rc::new(PlatformEventData::new(Box::new(data))) as Rc, + EventData::Drag(data) => Rc::new(PlatformEventData::new(Box::new(data))) as Rc, + EventData::Pointer(data) => { + Rc::new(PlatformEventData::new(Box::new(data))) as Rc + } + EventData::Selection(data) => { + Rc::new(PlatformEventData::new(Box::new(data))) as Rc + } + EventData::Touch(data) => { + Rc::new(PlatformEventData::new(Box::new(data))) as Rc + } + EventData::Scroll(data) => { + Rc::new(PlatformEventData::new(Box::new(data))) as Rc + } + EventData::Wheel(data) => { + Rc::new(PlatformEventData::new(Box::new(data))) as Rc + } + EventData::Media(data) => { + Rc::new(PlatformEventData::new(Box::new(data))) as Rc + } + EventData::Animation(data) => { + Rc::new(PlatformEventData::new(Box::new(data))) as Rc + } + EventData::Transition(data) => { + Rc::new(PlatformEventData::new(Box::new(data))) as Rc + } + EventData::Toggle(data) => { + Rc::new(PlatformEventData::new(Box::new(data))) as Rc + } + EventData::Image(data) => { + Rc::new(PlatformEventData::new(Box::new(data))) as Rc + } + EventData::Mounted => { + Rc::new(PlatformEventData::new(Box::new(MountedData::new(())))) as Rc + } } } } diff --git a/packages/rink/src/hooks.rs b/packages/rink/src/hooks.rs index f6caf484c..3191bafd8 100644 --- a/packages/rink/src/hooks.rs +++ b/packages/rink/src/hooks.rs @@ -11,7 +11,9 @@ use dioxus_native_core::real_dom::NodeImmutable; use rustc_hash::{FxHashMap, FxHashSet}; use dioxus_html::geometry::euclid::{Point2D, Rect, Size2D}; -use dioxus_html::geometry::{ClientPoint, ElementPoint, PagePoint, ScreenPoint, WheelDelta}; +use dioxus_html::geometry::{ + ClientPoint, Coordinates, ElementPoint, PagePoint, ScreenPoint, WheelDelta, +}; use dioxus_html::input_data::keyboard_types::{Code, Key, Location, Modifiers}; use dioxus_html::input_data::{ MouseButton as DioxusMouseButton, MouseButtonSet as DioxusMouseButtons, @@ -148,13 +150,15 @@ impl InnerInputState { let coordinates = m.coordinates(); let new_mouse_data = SerializedMouseData::new( - m.client_coordinates(), - coordinates.element(), - m.page_coordinates(), - m.screen_coordinates(), - m.modifiers(), - held_buttons, m.trigger_button(), + held_buttons, + Coordinates::new( + m.screen_coordinates(), + m.client_coordinates(), + coordinates.element(), + m.page_coordinates(), + ), + m.modifiers(), ); self.mouse = Some(new_mouse_data.clone()); @@ -311,13 +315,15 @@ impl InnerInputState { .cast_unit(); SerializedMouseData::new( - mouse_data.client_coordinates(), - new_client_coordinates, - mouse_data.page_coordinates(), - mouse_data.screen_coordinates(), - mouse_data.modifiers(), - mouse_data.held_buttons(), mouse_data.trigger_button(), + mouse_data.held_buttons(), + Coordinates::new( + mouse_data.screen_coordinates(), + mouse_data.client_coordinates(), + new_client_coordinates, + mouse_data.page_coordinates(), + ), + mouse_data.modifiers(), ) } @@ -727,17 +733,19 @@ fn get_event(evt: TermEvent) -> Option<(&'static str, EventData)> { // held mouse buttons get set later by maintaining state, as crossterm does not provide them EventData::Mouse(SerializedMouseData::new( - // The `page` and `screen` coordinates are inconsistent with the MDN definition, as they are relative to the viewport (client), not the target element/page/screen, respectively. - // todo? - // But then, MDN defines them in terms of pixels, yet crossterm provides only row/column, and it might not be possible to get pixels. So we can't get 100% consistency anyway. - ClientPoint::new(x, y), - // offset x/y are set when the origin of the event is assigned to an element - ElementPoint::new(0., 0.), - PagePoint::new(x, y), - ScreenPoint::new(x, y), - modifiers, - DioxusMouseButtons::empty(), button, + DioxusMouseButtons::empty(), + Coordinates::new( + // The `page` and `screen` coordinates are inconsistent with the MDN definition, as they are relative to the viewport (client), not the target element/page/screen, respectively. + // todo? + // But then, MDN defines them in terms of pixels, yet crossterm provides only row/column, and it might not be possible to get pixels. So we can't get 100% consistency anyway. + ScreenPoint::new(x, y), + ClientPoint::new(x, y), + // offset x/y are set when the origin of the event is assigned to an element + ElementPoint::new(0., 0.), + PagePoint::new(x, y), + ), + modifiers, )) }; diff --git a/packages/web/src/dom.rs b/packages/web/src/dom.rs index 1b7a11ca0..fb0dfef46 100644 --- a/packages/web/src/dom.rs +++ b/packages/web/src/dom.rs @@ -11,13 +11,13 @@ use dioxus_core::{ }; use dioxus_html::{ event_bubbles, FileEngine, FormData, HasFormData, HasImageData, HtmlEventConverter, ImageData, - MountedData, ScrollData, + MountedData, PlatformEventData, ScrollData, }; use dioxus_interpreter_js::{get_node, minimal_bindings, save_template, Channel}; use futures_channel::mpsc; use js_sys::Array; use rustc_hash::FxHashMap; -use std::{any::Any, collections::HashMap, rc::Rc}; +use std::{any::Any, collections::HashMap}; use wasm_bindgen::{closure::Closure, prelude::wasm_bindgen, JsCast, JsValue}; use web_sys::{Document, Element, Event}; @@ -37,7 +37,7 @@ pub struct UiEvent { pub name: String, pub bubbles: bool, pub element: ElementId, - pub data: Rc, + pub data: PlatformEventData, } impl WebsysDom { @@ -96,6 +96,7 @@ impl WebsysDom { root.clone().unchecked_into(), handler.as_ref().unchecked_ref(), ); + dioxus_html::set_event_converter(Box::new(WebEventConverter)); handler.forget(); Self { document, @@ -256,7 +257,7 @@ impl WebsysDom { if let Some(element) = node.dyn_ref::() { log::info!("mounted event fired: {}", id.0); let data: MountedData = element.into(); - let data = Rc::new(data); + let data = PlatformEventData::new(Box::new(data)); let _ = self.event_channel.unbounded_send(UiEvent { name: "mounted".to_string(), bubbles: false, @@ -394,11 +395,14 @@ struct GenericWebSysEvent { // todo: some of these events are being casted to the wrong event type. // We need tests that simulate clicks/etc and make sure every event type works. -pub fn virtual_event_from_websys_event(event: web_sys::Event, target: Element) -> Rc { - Rc::new(GenericWebSysEvent { +pub fn virtual_event_from_websys_event( + event: web_sys::Event, + target: Element, +) -> PlatformEventData { + PlatformEventData::new(Box::new(GenericWebSysEvent { raw: event, element: target, - }) + })) } pub(crate) fn load_document() -> Document { diff --git a/packages/web/src/lib.rs b/packages/web/src/lib.rs index ce1fad116..016d805e3 100644 --- a/packages/web/src/lib.rs +++ b/packages/web/src/lib.rs @@ -53,6 +53,8 @@ // - Do the VDOM work during the idlecallback // - Do DOM work in the next requestAnimationFrame callback +use std::rc::Rc; + pub use crate::cfg::Config; #[cfg(feature = "file_engine")] pub use crate::file_engine::WebFileEngineExt; @@ -276,7 +278,12 @@ pub async fn run_with_props(root: fn(Scope) -> Element, root_prop // Dequeue all of the events from the channel in send order // todo: we should re-order these if possible while let Some(evt) = res { - dom.handle_event(evt.name.as_str(), evt.data, evt.element, evt.bubbles); + dom.handle_event( + evt.name.as_str(), + Rc::new(evt.data), + evt.element, + evt.bubbles, + ); res = rx.try_next().transpose().unwrap().ok(); } From 097eb2099cca421d00777f56ab07e909d0db6281 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Mon, 28 Aug 2023 17:16:56 -0500 Subject: [PATCH 058/447] add extension to downcast web events --- packages/html/src/events/pointer.rs | 12 + packages/web/src/dom.rs | 296 +------------------- packages/web/src/event.rs | 420 ++++++++++++++++++++++++++++ packages/web/src/lib.rs | 2 + 4 files changed, 442 insertions(+), 288 deletions(-) create mode 100644 packages/web/src/event.rs diff --git a/packages/html/src/events/pointer.rs b/packages/html/src/events/pointer.rs index 5540dbe62..ec351d3dc 100644 --- a/packages/html/src/events/pointer.rs +++ b/packages/html/src/events/pointer.rs @@ -10,6 +10,18 @@ pub struct PointerData { inner: Box, } +impl PointerData { + /// Create a new PointerData + pub fn new(data: impl HasPointerData + 'static) -> Self { + Self::from(data) + } + + /// Downcast this event to a concrete event type + pub fn downcast(&self) -> Option<&T> { + self.inner.as_any().downcast_ref::() + } +} + impl From for PointerData { fn from(e: E) -> Self { Self { inner: Box::new(e) } diff --git a/packages/web/src/dom.rs b/packages/web/src/dom.rs index fb0dfef46..9799b50be 100644 --- a/packages/web/src/dom.rs +++ b/packages/web/src/dom.rs @@ -9,19 +9,14 @@ use dioxus_core::{ BorrowedAttributeValue, ElementId, Mutation, Template, TemplateAttribute, TemplateNode, }; -use dioxus_html::{ - event_bubbles, FileEngine, FormData, HasFormData, HasImageData, HtmlEventConverter, ImageData, - MountedData, PlatformEventData, ScrollData, -}; -use dioxus_interpreter_js::{get_node, minimal_bindings, save_template, Channel}; +use dioxus_html::{event_bubbles, PlatformEventData}; +use dioxus_interpreter_js::{minimal_bindings, save_template, Channel}; use futures_channel::mpsc; -use js_sys::Array; use rustc_hash::FxHashMap; -use std::{any::Any, collections::HashMap}; -use wasm_bindgen::{closure::Closure, prelude::wasm_bindgen, JsCast, JsValue}; +use wasm_bindgen::{closure::Closure, JsCast, JsValue}; use web_sys::{Document, Element, Event}; -use crate::Config; +use crate::{load_document, virtual_event_from_websys_event, Config, WebEventConverter}; pub struct WebsysDom { document: Document, @@ -30,6 +25,7 @@ pub struct WebsysDom { templates: FxHashMap, max_template_id: u32, pub(crate) interpreter: Channel, + #[cfg(feature = "mounted")] event_channel: mpsc::UnboundedSender, } @@ -104,6 +100,7 @@ impl WebsysDom { interpreter, templates: FxHashMap::default(), max_template_id: 0, + #[cfg(feature = "mounted")] event_channel, } } @@ -253,10 +250,10 @@ impl WebsysDom { #[cfg(feature = "mounted")] for id in to_mount { - let node = get_node(id.0 as u32); + let node = dioxus_interpreter_js::get_node(id.0 as u32); if let Some(element) = node.dyn_ref::() { log::info!("mounted event fired: {}", id.0); - let data: MountedData = element.into(); + let data: dioxus_html::MountedData = element.into(); let data = PlatformEventData::new(Box::new(data)); let _ = self.event_channel.unbounded_send(UiEvent { name: "mounted".to_string(), @@ -269,283 +266,6 @@ impl WebsysDom { } } -struct WebEventConverter; - -fn downcast_event(event: &dioxus_html::PlatformEventData) -> &GenericWebSysEvent { - event - .downcast::() - .expect("event should be a GenericWebSysEvent") -} - -impl HtmlEventConverter for WebEventConverter { - fn convert_animation_data( - &self, - event: &dioxus_html::PlatformEventData, - ) -> dioxus_html::AnimationData { - downcast_event(event).raw.clone().into() - } - - fn convert_clipboard_data( - &self, - event: &dioxus_html::PlatformEventData, - ) -> dioxus_html::ClipboardData { - downcast_event(event).raw.clone().into() - } - - fn convert_composition_data( - &self, - event: &dioxus_html::PlatformEventData, - ) -> dioxus_html::CompositionData { - downcast_event(event).raw.clone().into() - } - - fn convert_drag_data(&self, event: &dioxus_html::PlatformEventData) -> dioxus_html::DragData { - downcast_event(event).raw.clone().into() - } - - fn convert_focus_data(&self, event: &dioxus_html::PlatformEventData) -> dioxus_html::FocusData { - downcast_event(event).raw.clone().into() - } - - fn convert_form_data(&self, event: &dioxus_html::PlatformEventData) -> dioxus_html::FormData { - let event = downcast_event(event); - FormData::new(WebFormData::new(event.element.clone(), event.raw.clone())) - } - - fn convert_image_data(&self, event: &dioxus_html::PlatformEventData) -> dioxus_html::ImageData { - let event = downcast_event(event); - let error = event.raw.type_() == "error"; - ImageData::new(WebImageEvent::new(event.raw.clone(), error)) - } - - fn convert_keyboard_data( - &self, - event: &dioxus_html::PlatformEventData, - ) -> dioxus_html::KeyboardData { - downcast_event(event).raw.clone().into() - } - - fn convert_media_data(&self, event: &dioxus_html::PlatformEventData) -> dioxus_html::MediaData { - downcast_event(event).raw.clone().into() - } - - fn convert_mounted_data(&self, event: &dioxus_html::PlatformEventData) -> MountedData { - #[cfg(feature = "mounted")] - { - MountedData::from(downcast_event(event).element.clone()) - } - #[cfg(not(feature = "mounted"))] - { - panic!("mounted events are not supported without the mounted feature on the dioxus-web crate enabled") - } - } - - fn convert_mouse_data(&self, event: &dioxus_html::PlatformEventData) -> dioxus_html::MouseData { - downcast_event(event).raw.clone().into() - } - - fn convert_pointer_data( - &self, - event: &dioxus_html::PlatformEventData, - ) -> dioxus_html::PointerData { - downcast_event(event).raw.clone().into() - } - - fn convert_scroll_data( - &self, - event: &dioxus_html::PlatformEventData, - ) -> dioxus_html::ScrollData { - ScrollData::from(downcast_event(event).raw.clone()) - } - - fn convert_selection_data( - &self, - event: &dioxus_html::PlatformEventData, - ) -> dioxus_html::SelectionData { - downcast_event(event).raw.clone().into() - } - - fn convert_toggle_data( - &self, - event: &dioxus_html::PlatformEventData, - ) -> dioxus_html::ToggleData { - downcast_event(event).raw.clone().into() - } - - fn convert_touch_data(&self, event: &dioxus_html::PlatformEventData) -> dioxus_html::TouchData { - downcast_event(event).raw.clone().into() - } - - fn convert_transition_data( - &self, - event: &dioxus_html::PlatformEventData, - ) -> dioxus_html::TransitionData { - downcast_event(event).raw.clone().into() - } - - fn convert_wheel_data(&self, event: &dioxus_html::PlatformEventData) -> dioxus_html::WheelData { - downcast_event(event).raw.clone().into() - } -} - -struct GenericWebSysEvent { - raw: Event, - element: Element, -} - -// todo: some of these events are being casted to the wrong event type. -// We need tests that simulate clicks/etc and make sure every event type works. -pub fn virtual_event_from_websys_event( - event: web_sys::Event, - target: Element, -) -> PlatformEventData { - PlatformEventData::new(Box::new(GenericWebSysEvent { - raw: event, - element: target, - })) -} - -pub(crate) fn load_document() -> Document { - web_sys::window() - .expect("should have access to the Window") - .document() - .expect("should have access to the Document") -} - -struct WebImageEvent { - raw: Event, - error: bool, -} - -impl WebImageEvent { - fn new(raw: Event, error: bool) -> Self { - Self { raw, error } - } -} - -impl HasImageData for WebImageEvent { - fn load_error(&self) -> bool { - self.error - } - - fn as_any(&self) -> &dyn Any { - &self.raw as &dyn Any - } -} - -struct WebFormData { - element: Element, - raw: Event, -} - -impl WebFormData { - fn new(element: Element, raw: Event) -> Self { - Self { element, raw } - } -} - -impl HasFormData for WebFormData { - fn value(&self) -> String { - let target = &self.element; - target - .dyn_ref() - .map(|input: &web_sys::HtmlInputElement| { - // todo: special case more input types - match input.type_().as_str() { - "checkbox" => { - match input.checked() { - true => "true".to_string(), - false => "false".to_string(), - } - }, - _ => { - input.value() - } - } - }) - .or_else(|| { - target - .dyn_ref() - .map(|input: &web_sys::HtmlTextAreaElement| input.value()) - }) - // select elements are NOT input events - because - why woudn't they be?? - .or_else(|| { - target - .dyn_ref() - .map(|input: &web_sys::HtmlSelectElement| input.value()) - }) - .or_else(|| { - target - .dyn_ref::() - .unwrap() - .text_content() - }) - .expect("only an InputElement or TextAreaElement or an element with contenteditable=true can have an oninput event listener") - } - - fn values(&self) -> HashMap> { - let mut values = std::collections::HashMap::new(); - - // try to fill in form values - if let Some(form) = self.element.dyn_ref::() { - let form_data = get_form_data(form); - for value in form_data.entries().into_iter().flatten() { - if let Ok(array) = value.dyn_into::() { - if let Some(name) = array.get(0).as_string() { - if let Ok(item_values) = array.get(1).dyn_into::() { - let item_values = - item_values.iter().filter_map(|v| v.as_string()).collect(); - - values.insert(name, item_values); - } - } - } - } - } - - values - } - - fn files(&self) -> Option> { - #[cfg(not(feature = "file_engine"))] - let files = None; - #[cfg(feature = "file_engine")] - let files = self - .element - .dyn_ref() - .and_then(|input: &web_sys::HtmlInputElement| { - input.files().and_then(|files| { - crate::file_engine::WebFileEngine::new(files).map(|f| { - std::sync::Arc::new(f) as std::sync::Arc - }) - }) - }); - - files - } - - fn as_any(&self) -> &dyn Any { - &self.raw as &dyn Any - } -} - -// web-sys does not expose the keys api for form data, so we need to manually bind to it -#[wasm_bindgen(inline_js = r#" - export function get_form_data(form) { - let values = new Map(); - const formData = new FormData(form); - - for (let name of formData.keys()) { - values.set(name, formData.getAll(name)); - } - - return values; - } -"#)] -extern "C" { - fn get_form_data(form: &web_sys::HtmlFormElement) -> js_sys::Map; -} - fn walk_event_for_id(event: &web_sys::Event) -> Option<(ElementId, web_sys::Element)> { let target = event .target() diff --git a/packages/web/src/event.rs b/packages/web/src/event.rs new file mode 100644 index 000000000..8a4a2c204 --- /dev/null +++ b/packages/web/src/event.rs @@ -0,0 +1,420 @@ +use std::{any::Any, collections::HashMap}; + +use dioxus_html::{ + FileEngine, FormData, HasFormData, HasImageData, HtmlEventConverter, ImageData, MountedData, + PlatformEventData, ScrollData, +}; +use js_sys::Array; +use wasm_bindgen::{prelude::wasm_bindgen, JsCast}; +use web_sys::{Document, Element, Event}; + +pub(crate) struct WebEventConverter; + +fn downcast_event(event: &dioxus_html::PlatformEventData) -> &GenericWebSysEvent { + event + .downcast::() + .expect("event should be a GenericWebSysEvent") +} + +impl HtmlEventConverter for WebEventConverter { + fn convert_animation_data( + &self, + event: &dioxus_html::PlatformEventData, + ) -> dioxus_html::AnimationData { + downcast_event(event).raw.clone().into() + } + + fn convert_clipboard_data( + &self, + event: &dioxus_html::PlatformEventData, + ) -> dioxus_html::ClipboardData { + downcast_event(event).raw.clone().into() + } + + fn convert_composition_data( + &self, + event: &dioxus_html::PlatformEventData, + ) -> dioxus_html::CompositionData { + downcast_event(event).raw.clone().into() + } + + fn convert_drag_data(&self, event: &dioxus_html::PlatformEventData) -> dioxus_html::DragData { + downcast_event(event).raw.clone().into() + } + + fn convert_focus_data(&self, event: &dioxus_html::PlatformEventData) -> dioxus_html::FocusData { + downcast_event(event).raw.clone().into() + } + + fn convert_form_data(&self, event: &dioxus_html::PlatformEventData) -> dioxus_html::FormData { + let event = downcast_event(event); + FormData::new(WebFormData::new(event.element.clone(), event.raw.clone())) + } + + fn convert_image_data(&self, event: &dioxus_html::PlatformEventData) -> dioxus_html::ImageData { + let event = downcast_event(event); + let error = event.raw.type_() == "error"; + ImageData::new(WebImageEvent::new(event.raw.clone(), error)) + } + + fn convert_keyboard_data( + &self, + event: &dioxus_html::PlatformEventData, + ) -> dioxus_html::KeyboardData { + downcast_event(event).raw.clone().into() + } + + fn convert_media_data(&self, event: &dioxus_html::PlatformEventData) -> dioxus_html::MediaData { + downcast_event(event).raw.clone().into() + } + + #[allow(unused_variables)] + fn convert_mounted_data(&self, event: &dioxus_html::PlatformEventData) -> MountedData { + #[cfg(feature = "mounted")] + { + MountedData::from(downcast_event(event).element.clone()) + } + #[cfg(not(feature = "mounted"))] + { + panic!("mounted events are not supported without the mounted feature on the dioxus-web crate enabled") + } + } + + fn convert_mouse_data(&self, event: &dioxus_html::PlatformEventData) -> dioxus_html::MouseData { + downcast_event(event).raw.clone().into() + } + + fn convert_pointer_data( + &self, + event: &dioxus_html::PlatformEventData, + ) -> dioxus_html::PointerData { + downcast_event(event).raw.clone().into() + } + + fn convert_scroll_data( + &self, + event: &dioxus_html::PlatformEventData, + ) -> dioxus_html::ScrollData { + ScrollData::from(downcast_event(event).raw.clone()) + } + + fn convert_selection_data( + &self, + event: &dioxus_html::PlatformEventData, + ) -> dioxus_html::SelectionData { + downcast_event(event).raw.clone().into() + } + + fn convert_toggle_data( + &self, + event: &dioxus_html::PlatformEventData, + ) -> dioxus_html::ToggleData { + downcast_event(event).raw.clone().into() + } + + fn convert_touch_data(&self, event: &dioxus_html::PlatformEventData) -> dioxus_html::TouchData { + downcast_event(event).raw.clone().into() + } + + fn convert_transition_data( + &self, + event: &dioxus_html::PlatformEventData, + ) -> dioxus_html::TransitionData { + downcast_event(event).raw.clone().into() + } + + fn convert_wheel_data(&self, event: &dioxus_html::PlatformEventData) -> dioxus_html::WheelData { + downcast_event(event).raw.clone().into() + } +} + +/// A extension trait for web-sys events that provides a way to get the event as a web-sys event. +pub trait WebEventExt { + /// Get the event as a web-sys event. + fn web_event(&self) -> &E; +} + +impl WebEventExt for dioxus_html::AnimationData { + fn web_event(&self) -> &web_sys::AnimationEvent { + self.downcast::() + .expect("event should be a WebAnimationEvent") + } +} + +impl WebEventExt for dioxus_html::ClipboardData { + fn web_event(&self) -> &web_sys::Event { + &self + .downcast::() + .expect("event should be a web_sys::Event") + } +} + +impl WebEventExt for dioxus_html::CompositionData { + fn web_event(&self) -> &web_sys::CompositionEvent { + self.downcast::() + .expect("event should be a WebCompositionEvent") + } +} + +impl WebEventExt for dioxus_html::DragData { + fn web_event(&self) -> &web_sys::MouseEvent { + self.downcast::() + .expect("event should be a WebMouseEvent") + } +} + +impl WebEventExt for dioxus_html::FocusData { + fn web_event(&self) -> &web_sys::FocusEvent { + self.downcast::() + .expect("event should be a WebFocusEvent") + } +} + +impl WebEventExt for dioxus_html::FormData { + fn web_event(&self) -> &web_sys::Event { + self.downcast::() + .expect("event should be a WebFormData") + } +} + +impl WebEventExt for dioxus_html::ImageData { + fn web_event(&self) -> &WebImageEvent { + self.downcast::() + .expect("event should be a WebImageEvent") + } +} + +impl WebEventExt for dioxus_html::KeyboardData { + fn web_event(&self) -> &web_sys::KeyboardEvent { + self.downcast::() + .expect("event should be a WebKeyboardEvent") + } +} + +impl WebEventExt for dioxus_html::MediaData { + fn web_event(&self) -> &web_sys::Event { + self.downcast::() + .expect("event should be a WebMediaEvent") + } +} + +impl WebEventExt for MountedData { + fn web_event(&self) -> &MountedData { + self.downcast::() + .expect("event should be a WebMountedEvent") + } +} + +impl WebEventExt for dioxus_html::MouseData { + fn web_event(&self) -> &web_sys::MouseEvent { + self.downcast::() + .expect("event should be a WebMouseEvent") + } +} + +impl WebEventExt for dioxus_html::PointerData { + fn web_event(&self) -> &web_sys::PointerEvent { + self.downcast::() + .expect("event should be a WebPointerEvent") + } +} + +impl WebEventExt for ScrollData { + fn web_event(&self) -> &web_sys::Event { + self.downcast::() + .expect("event should be a WebScrollEvent") + } +} + +impl WebEventExt for dioxus_html::SelectionData { + fn web_event(&self) -> &web_sys::Event { + self.downcast::() + .expect("event should be a WebSelectionEvent") + } +} + +impl WebEventExt for dioxus_html::ToggleData { + fn web_event(&self) -> &web_sys::Event { + self.downcast::() + .expect("event should be a WebToggleEvent") + } +} + +impl WebEventExt for dioxus_html::TouchData { + fn web_event(&self) -> &web_sys::TouchEvent { + self.downcast::() + .expect("event should be a WebTouchEvent") + } +} + +impl WebEventExt for dioxus_html::TransitionData { + fn web_event(&self) -> &web_sys::TransitionEvent { + self.downcast::() + .expect("event should be a WebTransitionEvent") + } +} + +impl WebEventExt for dioxus_html::WheelData { + fn web_event(&self) -> &web_sys::WheelEvent { + self.downcast::() + .expect("event should be a WebWheelEvent") + } +} + +struct GenericWebSysEvent { + raw: Event, + element: Element, +} + +// todo: some of these events are being casted to the wrong event type. +// We need tests that simulate clicks/etc and make sure every event type works. +pub(crate) fn virtual_event_from_websys_event( + event: web_sys::Event, + target: Element, +) -> PlatformEventData { + PlatformEventData::new(Box::new(GenericWebSysEvent { + raw: event, + element: target, + })) +} + +pub(crate) fn load_document() -> Document { + web_sys::window() + .expect("should have access to the Window") + .document() + .expect("should have access to the Document") +} + +struct WebImageEvent { + raw: Event, + error: bool, +} + +impl WebImageEvent { + fn new(raw: Event, error: bool) -> Self { + Self { raw, error } + } +} + +impl HasImageData for WebImageEvent { + fn load_error(&self) -> bool { + self.error + } + + fn as_any(&self) -> &dyn Any { + &self.raw as &dyn Any + } +} + +struct WebFormData { + element: Element, + raw: Event, +} + +impl WebFormData { + fn new(element: Element, raw: Event) -> Self { + Self { element, raw } + } +} + +impl HasFormData for WebFormData { + fn value(&self) -> String { + let target = &self.element; + target + .dyn_ref() + .map(|input: &web_sys::HtmlInputElement| { + // todo: special case more input types + match input.type_().as_str() { + "checkbox" => { + match input.checked() { + true => "true".to_string(), + false => "false".to_string(), + } + }, + _ => { + input.value() + } + } + }) + .or_else(|| { + target + .dyn_ref() + .map(|input: &web_sys::HtmlTextAreaElement| input.value()) + }) + // select elements are NOT input events - because - why woudn't they be?? + .or_else(|| { + target + .dyn_ref() + .map(|input: &web_sys::HtmlSelectElement| input.value()) + }) + .or_else(|| { + target + .dyn_ref::() + .unwrap() + .text_content() + }) + .expect("only an InputElement or TextAreaElement or an element with contenteditable=true can have an oninput event listener") + } + + fn values(&self) -> HashMap> { + let mut values = std::collections::HashMap::new(); + + // try to fill in form values + if let Some(form) = self.element.dyn_ref::() { + let form_data = get_form_data(form); + for value in form_data.entries().into_iter().flatten() { + if let Ok(array) = value.dyn_into::() { + if let Some(name) = array.get(0).as_string() { + if let Ok(item_values) = array.get(1).dyn_into::() { + let item_values = + item_values.iter().filter_map(|v| v.as_string()).collect(); + + values.insert(name, item_values); + } + } + } + } + } + + values + } + + fn files(&self) -> Option> { + #[cfg(not(feature = "file_engine"))] + let files = None; + #[cfg(feature = "file_engine")] + let files = self + .element + .dyn_ref() + .and_then(|input: &web_sys::HtmlInputElement| { + input.files().and_then(|files| { + crate::file_engine::WebFileEngine::new(files).map(|f| { + std::sync::Arc::new(f) as std::sync::Arc + }) + }) + }); + + files + } + + fn as_any(&self) -> &dyn Any { + &self.raw as &dyn Any + } +} + +// web-sys does not expose the keys api for form data, so we need to manually bind to it +#[wasm_bindgen(inline_js = r#" + export function get_form_data(form) { + let values = new Map(); + const formData = new FormData(form); + + for (let name of formData.keys()) { + values.set(name, formData.getAll(name)); + } + + return values; + } +"#)] +extern "C" { + fn get_form_data(form: &web_sys::HtmlFormElement) -> js_sys::Map; +} diff --git a/packages/web/src/lib.rs b/packages/web/src/lib.rs index 016d805e3..002bdb916 100644 --- a/packages/web/src/lib.rs +++ b/packages/web/src/lib.rs @@ -69,6 +69,8 @@ mod cfg; mod dom; #[cfg(feature = "eval")] mod eval; +mod event; +pub use event::*; #[cfg(feature = "file_engine")] mod file_engine; #[cfg(all(feature = "hot_reload", debug_assertions))] From 177db238b9e472311c198230cd2678db7431a104 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Mon, 28 Aug 2023 17:55:23 -0500 Subject: [PATCH 059/447] add some inline hints --- packages/web/src/event.rs | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/packages/web/src/event.rs b/packages/web/src/event.rs index 8a4a2c204..8767b6a35 100644 --- a/packages/web/src/event.rs +++ b/packages/web/src/event.rs @@ -10,6 +10,7 @@ use web_sys::{Document, Element, Event}; pub(crate) struct WebEventConverter; +#[inline(always)] fn downcast_event(event: &dioxus_html::PlatformEventData) -> &GenericWebSysEvent { event .downcast::() @@ -17,6 +18,7 @@ fn downcast_event(event: &dioxus_html::PlatformEventData) -> &GenericWebSysEvent } impl HtmlEventConverter for WebEventConverter { + #[inline(always)] fn convert_animation_data( &self, event: &dioxus_html::PlatformEventData, @@ -24,6 +26,7 @@ impl HtmlEventConverter for WebEventConverter { downcast_event(event).raw.clone().into() } + #[inline(always)] fn convert_clipboard_data( &self, event: &dioxus_html::PlatformEventData, @@ -31,6 +34,7 @@ impl HtmlEventConverter for WebEventConverter { downcast_event(event).raw.clone().into() } + #[inline(always)] fn convert_composition_data( &self, event: &dioxus_html::PlatformEventData, @@ -38,25 +42,30 @@ impl HtmlEventConverter for WebEventConverter { downcast_event(event).raw.clone().into() } + #[inline(always)] fn convert_drag_data(&self, event: &dioxus_html::PlatformEventData) -> dioxus_html::DragData { downcast_event(event).raw.clone().into() } + #[inline(always)] fn convert_focus_data(&self, event: &dioxus_html::PlatformEventData) -> dioxus_html::FocusData { downcast_event(event).raw.clone().into() } + #[inline(always)] fn convert_form_data(&self, event: &dioxus_html::PlatformEventData) -> dioxus_html::FormData { let event = downcast_event(event); FormData::new(WebFormData::new(event.element.clone(), event.raw.clone())) } + #[inline(always)] fn convert_image_data(&self, event: &dioxus_html::PlatformEventData) -> dioxus_html::ImageData { let event = downcast_event(event); let error = event.raw.type_() == "error"; ImageData::new(WebImageEvent::new(event.raw.clone(), error)) } + #[inline(always)] fn convert_keyboard_data( &self, event: &dioxus_html::PlatformEventData, @@ -64,11 +73,13 @@ impl HtmlEventConverter for WebEventConverter { downcast_event(event).raw.clone().into() } + #[inline(always)] fn convert_media_data(&self, event: &dioxus_html::PlatformEventData) -> dioxus_html::MediaData { downcast_event(event).raw.clone().into() } #[allow(unused_variables)] + #[inline(always)] fn convert_mounted_data(&self, event: &dioxus_html::PlatformEventData) -> MountedData { #[cfg(feature = "mounted")] { @@ -80,10 +91,12 @@ impl HtmlEventConverter for WebEventConverter { } } + #[inline(always)] fn convert_mouse_data(&self, event: &dioxus_html::PlatformEventData) -> dioxus_html::MouseData { downcast_event(event).raw.clone().into() } + #[inline(always)] fn convert_pointer_data( &self, event: &dioxus_html::PlatformEventData, @@ -91,6 +104,7 @@ impl HtmlEventConverter for WebEventConverter { downcast_event(event).raw.clone().into() } + #[inline(always)] fn convert_scroll_data( &self, event: &dioxus_html::PlatformEventData, @@ -98,6 +112,7 @@ impl HtmlEventConverter for WebEventConverter { ScrollData::from(downcast_event(event).raw.clone()) } + #[inline(always)] fn convert_selection_data( &self, event: &dioxus_html::PlatformEventData, @@ -105,6 +120,7 @@ impl HtmlEventConverter for WebEventConverter { downcast_event(event).raw.clone().into() } + #[inline(always)] fn convert_toggle_data( &self, event: &dioxus_html::PlatformEventData, @@ -112,10 +128,12 @@ impl HtmlEventConverter for WebEventConverter { downcast_event(event).raw.clone().into() } + #[inline(always)] fn convert_touch_data(&self, event: &dioxus_html::PlatformEventData) -> dioxus_html::TouchData { downcast_event(event).raw.clone().into() } + #[inline(always)] fn convert_transition_data( &self, event: &dioxus_html::PlatformEventData, @@ -123,6 +141,7 @@ impl HtmlEventConverter for WebEventConverter { downcast_event(event).raw.clone().into() } + #[inline(always)] fn convert_wheel_data(&self, event: &dioxus_html::PlatformEventData) -> dioxus_html::WheelData { downcast_event(event).raw.clone().into() } From c5ebdc963595109bb400c134fe08666381a8fffa Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Thu, 31 Aug 2023 14:17:26 -0500 Subject: [PATCH 060/447] fix parents in placeholder diffing --- docs/guide/examples/readme_expanded.rs | 2 +- packages/core/src/create.rs | 25 ++++++++++++++--- packages/core/src/diff.rs | 27 +++++++++++++++---- packages/core/src/nodes.rs | 2 ++ packages/fullstack/src/hooks/server_cached.rs | 3 ++- packages/native-core/tests/fuzzing.rs | 2 +- 6 files changed, 50 insertions(+), 11 deletions(-) diff --git a/docs/guide/examples/readme_expanded.rs b/docs/guide/examples/readme_expanded.rs index 1ec30e57b..5e09aee56 100644 --- a/docs/guide/examples/readme_expanded.rs +++ b/docs/guide/examples/readme_expanded.rs @@ -85,7 +85,7 @@ fn app(cx: Scope) -> Element { }; // The VNode is a reference to the template with the dynamic parts of the rsx ::dioxus::core::VNode { - parent: None, + parent: Default::default(), key: None, // The static template this node will use. The template is stored in a Cell so it can be replaced with a new template when hot rsx reloading is enabled template: std::cell::Cell::new(TEMPLATE), diff --git a/packages/core/src/create.rs b/packages/core/src/create.rs index e89942f36..a85d977e0 100644 --- a/packages/core/src/create.rs +++ b/packages/core/src/create.rs @@ -192,7 +192,15 @@ impl<'b> VirtualDom { }; self.create_dynamic_node(template_ref, node) } - Placeholder(VPlaceholder { id }) => { + Placeholder(VPlaceholder { id, parent }) => { + let template_ref = ElementRef { + path: ElementPath { + path: &template.template.get().node_paths[idx], + }, + template: &template, + scope: self.runtime.current_scope_id().unwrap_or(ScopeId(0)), + }; + parent.set(Some(self.next_element_ref(template_ref))); let id = self.set_slot(id); self.mutations.push(CreatePlaceholder { id }); 1 @@ -510,6 +518,9 @@ impl<'b> VirtualDom { // Make sure the text node is assigned to the correct element placeholder.id.set(Some(id)); + // Assign the placeholder's parent + placeholder.parent.set(Some(self.next_element_ref(parent))); + // Assign the ID to the existing node in the template self.mutations.push(AssignId { path: &parent.path.path[1..], @@ -538,7 +549,7 @@ impl<'b> VirtualDom { self.assign_boundary_ref(parent, t); self.create_scope(scope, t) } - Aborted(t) => self.mount_aborted(t), + Aborted(t) => self.mount_aborted(t, parent), } } @@ -554,10 +565,18 @@ impl<'b> VirtualDom { .unwrap_or_else(|| component.scope.get().unwrap()) } - fn mount_aborted(&mut self, placeholder: &VPlaceholder) -> usize { + fn mount_aborted( + &mut self, + placeholder: &VPlaceholder, + parent: Option>, + ) -> usize { let id = self.next_element(); self.mutations.push(Mutation::CreatePlaceholder { id }); placeholder.id.set(Some(id)); + placeholder + .parent + .set(parent.map(|parent| self.next_element_ref(parent))); + 1 } diff --git a/packages/core/src/diff.rs b/packages/core/src/diff.rs index 29a135be6..5e015dbb3 100644 --- a/packages/core/src/diff.rs +++ b/packages/core/src/diff.rs @@ -42,11 +42,18 @@ impl<'b> VirtualDom { (Ready(l), Aborted(p)) => self.diff_ok_to_err(l, p), // Just move over the placeholder - (Aborted(l), Aborted(r)) => r.id.set(l.id.get()), + (Aborted(l), Aborted(r)) => { + r.id.set(l.id.get()); + r.parent.set(l.parent.get()) + } // Placeholder becomes something // We should also clear the error now - (Aborted(l), Ready(r)) => self.replace_placeholder(l, [r], todo!()), + (Aborted(l), Ready(r)) => self.replace_placeholder( + l, + [r], + self.element_refs[l.parent.get().expect("root should not be none").0], + ), }; } self.runtime.scope_stack.borrow_mut().pop(); @@ -55,6 +62,7 @@ impl<'b> VirtualDom { fn diff_ok_to_err(&mut self, l: &'b VNode<'b>, p: &'b VPlaceholder) { let id = self.next_element(); p.id.set(Some(id)); + p.parent.set(l.parent.get()); self.mutations.push(Mutation::CreatePlaceholder { id }); let pre_edits = self.mutations.edits.len(); @@ -164,10 +172,13 @@ impl<'b> VirtualDom { match (left_node, right_node) { (Text(left), Text(right)) => self.diff_vtext(left, right), (Fragment(left), Fragment(right)) => self.diff_non_empty_fragment(left, right, parent), - (Placeholder(left), Placeholder(right)) => right.id.set(left.id.get()), + (Placeholder(left), Placeholder(right)) => { + right.id.set(left.id.get()); + right.parent.set(left.parent.get()) + }, (Component(left), Component(right)) => self.diff_vcomponent(left, right, Some(parent)), (Placeholder(left), Fragment(right)) => self.replace_placeholder(left, *right, parent), - (Fragment(left), Placeholder(right)) => self.node_to_placeholder(left, right), + (Fragment(left), Placeholder(right)) => self.node_to_placeholder(left, right, parent), _ => todo!("This is an usual custom case for dynamic nodes. We don't know how to handle it yet."), }; } @@ -838,11 +849,17 @@ impl<'b> VirtualDom { }; } - fn node_to_placeholder(&mut self, l: &'b [VNode<'b>], r: &'b VPlaceholder) { + fn node_to_placeholder( + &mut self, + l: &'b [VNode<'b>], + r: &'b VPlaceholder, + parent: ElementRef<'b>, + ) { // Create the placeholder first, ensuring we get a dedicated ID for the placeholder let placeholder = self.next_element(); r.id.set(Some(placeholder)); + r.parent.set(Some(self.next_element_ref(parent))); self.mutations .push(Mutation::CreatePlaceholder { id: placeholder }); diff --git a/packages/core/src/nodes.rs b/packages/core/src/nodes.rs index 9232b2961..1cf15a28c 100644 --- a/packages/core/src/nodes.rs +++ b/packages/core/src/nodes.rs @@ -373,6 +373,8 @@ impl<'a> VText<'a> { pub struct VPlaceholder { /// The ID of this node in the real DOM pub(crate) id: Cell>, + /// The parent of this node + pub(crate) parent: Cell>, } impl VPlaceholder { diff --git a/packages/fullstack/src/hooks/server_cached.rs b/packages/fullstack/src/hooks/server_cached.rs index 80bb93008..ef2546762 100644 --- a/packages/fullstack/src/hooks/server_cached.rs +++ b/packages/fullstack/src/hooks/server_cached.rs @@ -12,9 +12,10 @@ use serde::{de::DeserializeOwned, Serialize}; /// use dioxus_fullstack::prelude::*; /// /// fn app(cx: Scope) -> Element { -/// let state1 = use_state(cx, || from_server(|| { +/// let state1 = use_state(cx, || server_cached(|| { /// 1234 /// })); +/// todo!() /// } /// ``` pub fn server_cached(server_fn: impl Fn() -> O) -> O { diff --git a/packages/native-core/tests/fuzzing.rs b/packages/native-core/tests/fuzzing.rs index 4f0a34b70..82794e7d0 100644 --- a/packages/native-core/tests/fuzzing.rs +++ b/packages/native-core/tests/fuzzing.rs @@ -255,7 +255,7 @@ fn create_random_element(cx: Scope) -> Element { println!("{template:#?}"); let node = VNode { key: None, - parent: None, + parent: Default::default(), template: Cell::new(template), root_ids: dioxus::core::exports::bumpalo::collections::Vec::new_in(cx.bump()) .into(), From 036e1ff0f53a60966de4d08b32b2400b07cba338 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Thu, 31 Aug 2023 15:38:31 -0500 Subject: [PATCH 061/447] remove node refs before dropping nodes --- packages/core/src/arena.rs | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/packages/core/src/arena.rs b/packages/core/src/arena.rs index 53695d9d7..667c7123d 100644 --- a/packages/core/src/arena.rs +++ b/packages/core/src/arena.rs @@ -118,6 +118,10 @@ impl VirtualDom { } fn drop_scope_inner(&mut self, node: &VNode) { + if let Some(id) = node.parent.get() { + self.element_refs.remove(id.0); + } + node.dynamic_nodes.iter().for_each(|node| match node { DynamicNode::Component(c) => { if let Some(f) = c.scope.get() { @@ -128,7 +132,11 @@ impl VirtualDom { DynamicNode::Fragment(nodes) => { nodes.iter().for_each(|node| self.drop_scope_inner(node)) } - DynamicNode::Placeholder(_) => {} + DynamicNode::Placeholder(placeholder) => { + if let Some(id) = placeholder.parent.get() { + self.element_refs.remove(id.0); + } + } DynamicNode::Text(_) => {} }); } From cf042563956b5c0be94bcf4ea0ff3ea651a54b16 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Thu, 31 Aug 2023 16:14:14 -0500 Subject: [PATCH 062/447] try to keep template indexes valid --- packages/core/src/arena.rs | 7 +++++++ packages/core/src/diff.rs | 4 ++++ packages/core/src/nodes.rs | 5 ++++- packages/core/src/scopes.rs | 3 ++- 4 files changed, 17 insertions(+), 2 deletions(-) diff --git a/packages/core/src/arena.rs b/packages/core/src/arena.rs index 667c7123d..52ea1f245 100644 --- a/packages/core/src/arena.rs +++ b/packages/core/src/arena.rs @@ -77,6 +77,10 @@ impl VirtualDom { pub(crate) fn update_template(&mut self, el: ElementId, node: &VNode) { let bubble_id = self.elements[el.0].unwrap(); + self.update_template_bubble(bubble_id, node) + } + + pub(crate) fn update_template_bubble(&mut self, bubble_id: BubbleId, node: &VNode) { let node: *const VNode = node as *const _; self.element_refs[bubble_id.0].template = unsafe { std::mem::transmute(node) }; } @@ -128,6 +132,9 @@ impl VirtualDom { self.drop_scope(f, true); } c.props.take(); + if let Some(bubble_id) = c.bubble_id.get() { + self.element_refs.remove(bubble_id.0); + } } DynamicNode::Fragment(nodes) => { nodes.iter().for_each(|node| self.drop_scope_inner(node)) diff --git a/packages/core/src/diff.rs b/packages/core/src/diff.rs index 5e015dbb3..b394f5e83 100644 --- a/packages/core/src/diff.rs +++ b/packages/core/src/diff.rs @@ -214,6 +214,10 @@ impl<'b> VirtualDom { let scope_id = left.scope.get().unwrap(); right.scope.set(Some(scope_id)); + if let Some(bubble_id) = left.bubble_id.get() { + right.bubble_id.set(Some(bubble_id)); + self.update_template_bubble(bubble_id, parent.unwrap().template); + } // copy out the box for both let old = self.scopes[scope_id.0].props.as_ref(); diff --git a/packages/core/src/nodes.rs b/packages/core/src/nodes.rs index 1cf15a28c..f3a27eecf 100644 --- a/packages/core/src/nodes.rs +++ b/packages/core/src/nodes.rs @@ -318,9 +318,12 @@ pub struct VComponent<'a> { /// The assigned Scope for this component pub(crate) scope: Cell>, + /// The bubble id assigned to the child that we need to update and drop when diffing happens + pub(crate) bubble_id: Cell>, + /// The function pointer of the component, known at compile time /// - /// It is possible that components get folded at comppile time, so these shouldn't be really used as a key + /// It is possible that components get folded at compile time, so these shouldn't be really used as a key pub(crate) render_fn: *const (), pub(crate) props: RefCell + 'a>>>, diff --git a/packages/core/src/scopes.rs b/packages/core/src/scopes.rs index 996529a0d..a9c8e4f1f 100644 --- a/packages/core/src/scopes.rs +++ b/packages/core/src/scopes.rs @@ -455,7 +455,8 @@ impl<'src> ScopeState { render_fn: component as *const (), static_props: P::IS_STATIC, props: RefCell::new(Some(extended)), - scope: Cell::new(None), + bubble_id: Default::default(), + scope: Default::default(), }) } From 4879f65a3ecd263185eda9f9c8a68b126d670c0d Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Thu, 31 Aug 2023 16:25:26 -0500 Subject: [PATCH 063/447] fix tui events --- packages/dioxus-tui/src/element.rs | 4 ++-- packages/rink/src/hooks.rs | 8 ++++---- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/packages/dioxus-tui/src/element.rs b/packages/dioxus-tui/src/element.rs index eeb4d5b86..ba496fae1 100644 --- a/packages/dioxus-tui/src/element.rs +++ b/packages/dioxus-tui/src/element.rs @@ -82,8 +82,8 @@ impl RenderedElementBacking for TuiElement { }) } - fn get_raw_element(&self) -> dioxus_html::MountedResult<&dyn std::any::Any> { - Ok(self) + fn as_any(&self) -> &dyn std::any::Any { + self } } diff --git a/packages/rink/src/hooks.rs b/packages/rink/src/hooks.rs index 3191bafd8..646ae52df 100644 --- a/packages/rink/src/hooks.rs +++ b/packages/rink/src/hooks.rs @@ -177,10 +177,10 @@ impl InnerInputState { if is_repeating { *k = SerializedKeyboardData::new( - is_repeating, - k.code(), k.key(), + k.code(), k.location(), + is_repeating, k.modifiers(), ); } @@ -777,10 +777,10 @@ fn translate_key_event(event: crossterm::event::KeyEvent) -> Option { let modifiers = modifiers_from_crossterm_modifiers(event.modifiers); Some(EventData::Keyboard(SerializedKeyboardData::new( - false, - code, key, + code, Location::Standard, + false, modifiers, ))) } From f7451c02e867ce87ba344b0c7440f9c2e563ec64 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Thu, 31 Aug 2023 16:34:04 -0500 Subject: [PATCH 064/447] port liveview events --- packages/liveview/src/element.rs | 1 + packages/liveview/src/events.rs | 149 +++++++++++++++++++++++++++++++ packages/liveview/src/lib.rs | 1 + packages/liveview/src/pool.rs | 11 ++- 4 files changed, 158 insertions(+), 4 deletions(-) create mode 100644 packages/liveview/src/events.rs diff --git a/packages/liveview/src/element.rs b/packages/liveview/src/element.rs index d813a47d5..eef0fa48d 100644 --- a/packages/liveview/src/element.rs +++ b/packages/liveview/src/element.rs @@ -4,6 +4,7 @@ use dioxus_html::{geometry::euclid::Rect, MountedResult, RenderedElementBacking} use crate::query::QueryEngine; /// A mounted element passed to onmounted events +#[derive(Clone)] pub struct LiveviewElement { id: ElementId, query: QueryEngine, diff --git a/packages/liveview/src/events.rs b/packages/liveview/src/events.rs new file mode 100644 index 000000000..b764bf7cc --- /dev/null +++ b/packages/liveview/src/events.rs @@ -0,0 +1,149 @@ +//! Convert a serialized event to an event trigger + +use dioxus_html::*; + +use crate::element::LiveviewElement; + +pub(crate) struct SerializedHtmlEventConverter; + +impl HtmlEventConverter for SerializedHtmlEventConverter { + fn convert_animation_data(&self, event: &PlatformEventData) -> AnimationData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_clipboard_data(&self, event: &PlatformEventData) -> ClipboardData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_composition_data(&self, event: &PlatformEventData) -> CompositionData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_drag_data(&self, event: &PlatformEventData) -> DragData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_focus_data(&self, event: &PlatformEventData) -> FocusData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_form_data(&self, event: &PlatformEventData) -> FormData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_image_data(&self, event: &PlatformEventData) -> ImageData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_keyboard_data(&self, event: &PlatformEventData) -> KeyboardData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_media_data(&self, event: &PlatformEventData) -> MediaData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_mounted_data(&self, event: &PlatformEventData) -> MountedData { + event.downcast::().cloned().unwrap().into() + } + + fn convert_mouse_data(&self, event: &PlatformEventData) -> MouseData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_pointer_data(&self, event: &PlatformEventData) -> PointerData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_scroll_data(&self, event: &PlatformEventData) -> ScrollData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_selection_data(&self, event: &PlatformEventData) -> SelectionData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_toggle_data(&self, event: &PlatformEventData) -> ToggleData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_touch_data(&self, event: &PlatformEventData) -> TouchData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_transition_data(&self, event: &PlatformEventData) -> TransitionData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_wheel_data(&self, event: &PlatformEventData) -> WheelData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } +} diff --git a/packages/liveview/src/lib.rs b/packages/liveview/src/lib.rs index 92cce63e6..306af276a 100644 --- a/packages/liveview/src/lib.rs +++ b/packages/liveview/src/lib.rs @@ -24,6 +24,7 @@ mod query; use futures_util::{SinkExt, StreamExt}; pub use pool::*; mod eval; +mod events; pub trait WebsocketTx: SinkExt {} impl WebsocketTx for T where T: SinkExt {} diff --git a/packages/liveview/src/pool.rs b/packages/liveview/src/pool.rs index 2fd06cec6..ed0649c00 100644 --- a/packages/liveview/src/pool.rs +++ b/packages/liveview/src/pool.rs @@ -1,11 +1,12 @@ use crate::{ element::LiveviewElement, eval::init_eval, + events::SerializedHtmlEventConverter, query::{QueryEngine, QueryResult}, LiveViewError, }; use dioxus_core::{prelude::*, Mutations}; -use dioxus_html::{EventData, HtmlEvent, MountedData}; +use dioxus_html::{EventData, HtmlEvent, MountedData, PlatformEventData}; use futures_util::{pin_mut, SinkExt, StreamExt}; use serde::Serialize; use std::{rc::Rc, time::Duration}; @@ -24,6 +25,9 @@ impl Default for LiveViewPool { impl LiveViewPool { pub fn new() -> Self { + // Set the event converter + dioxus_html::set_event_converter(Box::new(SerializedHtmlEventConverter)); + LiveViewPool { pool: LocalPoolHandle::new(16), } @@ -171,12 +175,11 @@ pub async fn run(mut vdom: VirtualDom, ws: impl LiveViewSocket) -> Result<(), Li let element = LiveviewElement::new(evt.element, query_engine.clone()); vdom.handle_event( &evt.name, - Rc::new(MountedData::new(element)), + Rc::new(PlatformEventData::new(Box::new(MountedData::new(element)))), evt.element, evt.bubbles, ); - } - else{ + } else { vdom.handle_event( &evt.name, evt.data.into_any(), From 3eafb05d92ac06f3012528816a14900f1b327384 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Thu, 31 Aug 2023 16:34:27 -0500 Subject: [PATCH 065/447] fix features on rink html dependency --- packages/rink/Cargo.toml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/rink/Cargo.toml b/packages/rink/Cargo.toml index ba3d549f8..69d9a5c7b 100644 --- a/packages/rink/Cargo.toml +++ b/packages/rink/Cargo.toml @@ -10,7 +10,7 @@ keywords = ["dom", "ui", "gui", "react", "terminal"] license = "MIT OR Apache-2.0" [dependencies] -dioxus-html = { workspace = true } +dioxus-html = { workspace = true, features = ["serialize", "mounted"] } dioxus-native-core = { workspace = true, features = ["layout-attributes"] } dioxus-native-core-macro = { workspace = true } From 3c0159370360c93f6e713b80f255f417f88c9a71 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Thu, 31 Aug 2023 16:38:14 -0500 Subject: [PATCH 066/447] document HtmlEventConverter --- packages/html/src/events.rs | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/packages/html/src/events.rs b/packages/html/src/events.rs index a24294378..ae2842d28 100644 --- a/packages/html/src/events.rs +++ b/packages/html/src/events.rs @@ -63,24 +63,43 @@ impl PlatformEventData { } } +/// A converter between a platform specific event and a general event. All code in a renderer that has a large binary size should be placed in this trait. Each of these functions should be snipped in high levels of optimization. pub trait HtmlEventConverter: Send + Sync { + /// Convert a general event to an animation data event fn convert_animation_data(&self, event: &PlatformEventData) -> AnimationData; + /// Convert a general event to a clipboard data event fn convert_clipboard_data(&self, event: &PlatformEventData) -> ClipboardData; + /// Convert a general event to a composition data event fn convert_composition_data(&self, event: &PlatformEventData) -> CompositionData; + /// Convert a general event to a drag data event fn convert_drag_data(&self, event: &PlatformEventData) -> DragData; + /// Convert a general event to a focus data event fn convert_focus_data(&self, event: &PlatformEventData) -> FocusData; + /// Convert a general event to a form data event fn convert_form_data(&self, event: &PlatformEventData) -> FormData; + /// Convert a general event to an image data event fn convert_image_data(&self, event: &PlatformEventData) -> ImageData; + /// Convert a general event to a keyboard data event fn convert_keyboard_data(&self, event: &PlatformEventData) -> KeyboardData; + /// Convert a general event to a media data event fn convert_media_data(&self, event: &PlatformEventData) -> MediaData; + /// Convert a general event to a mounted data event fn convert_mounted_data(&self, event: &PlatformEventData) -> MountedData; + /// Convert a general event to a mouse data event fn convert_mouse_data(&self, event: &PlatformEventData) -> MouseData; + /// Convert a general event to a pointer data event fn convert_pointer_data(&self, event: &PlatformEventData) -> PointerData; + /// Convert a general event to a scroll data event fn convert_scroll_data(&self, event: &PlatformEventData) -> ScrollData; + /// Convert a general event to a selection data event fn convert_selection_data(&self, event: &PlatformEventData) -> SelectionData; + /// Convert a general event to a toggle data event fn convert_toggle_data(&self, event: &PlatformEventData) -> ToggleData; + /// Convert a general event to a touch data event fn convert_touch_data(&self, event: &PlatformEventData) -> TouchData; + /// Convert a general event to a transition data event fn convert_transition_data(&self, event: &PlatformEventData) -> TransitionData; + /// Convert a general event to a wheel data event fn convert_wheel_data(&self, event: &PlatformEventData) -> WheelData; } From bf90b7584e127b058d511e960918142f25fbc1d4 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Thu, 31 Aug 2023 16:42:33 -0500 Subject: [PATCH 067/447] add some inline hints --- packages/html/src/events.rs | 2 ++ 1 file changed, 2 insertions(+) diff --git a/packages/html/src/events.rs b/packages/html/src/events.rs index ae2842d28..2d27f583c 100644 --- a/packages/html/src/events.rs +++ b/packages/html/src/events.rs @@ -28,10 +28,12 @@ macro_rules! impl_event { static EVENT_CONVERTER: RwLock>> = RwLock::new(None); +#[inline] pub fn set_event_converter(converter: Box) { *EVENT_CONVERTER.write().unwrap() = Some(converter); } +#[inline] pub(crate) fn with_event_converter(f: F) -> R where F: FnOnce(&dyn HtmlEventConverter) -> R, From 364654e1fd3e90afa68f5ccd4128c3a6d9858742 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Thu, 31 Aug 2023 16:43:24 -0500 Subject: [PATCH 068/447] fix clippy with events --- packages/html/src/events.rs | 108 ++++++++++++++++++------------------ packages/web/src/event.rs | 2 +- 2 files changed, 55 insertions(+), 55 deletions(-) diff --git a/packages/html/src/events.rs b/packages/html/src/events.rs index 2d27f583c..de685b3cc 100644 --- a/packages/html/src/events.rs +++ b/packages/html/src/events.rs @@ -105,111 +105,111 @@ pub trait HtmlEventConverter: Send + Sync { fn convert_wheel_data(&self, event: &PlatformEventData) -> WheelData; } -impl Into for &PlatformEventData { - fn into(self) -> AnimationData { - with_event_converter(|c| c.convert_animation_data(self)) +impl From<&PlatformEventData> for AnimationData { + fn from(val: &PlatformEventData) -> Self { + with_event_converter(|c| c.convert_animation_data(val)) } } -impl Into for &PlatformEventData { - fn into(self) -> ClipboardData { - with_event_converter(|c| c.convert_clipboard_data(self)) +impl From<&PlatformEventData> for ClipboardData { + fn from(val: &PlatformEventData) -> Self { + with_event_converter(|c| c.convert_clipboard_data(val)) } } -impl Into for &PlatformEventData { - fn into(self) -> CompositionData { - with_event_converter(|c| c.convert_composition_data(self)) +impl From<&PlatformEventData> for CompositionData { + fn from(val: &PlatformEventData) -> Self { + with_event_converter(|c| c.convert_composition_data(val)) } } -impl Into for &PlatformEventData { - fn into(self) -> DragData { - with_event_converter(|c| c.convert_drag_data(self)) +impl From<&PlatformEventData> for DragData { + fn from(val: &PlatformEventData) -> Self { + with_event_converter(|c| c.convert_drag_data(val)) } } -impl Into for &PlatformEventData { - fn into(self) -> FocusData { - with_event_converter(|c| c.convert_focus_data(self)) +impl From<&PlatformEventData> for FocusData { + fn from(val: &PlatformEventData) -> Self { + with_event_converter(|c| c.convert_focus_data(val)) } } -impl Into for &PlatformEventData { - fn into(self) -> FormData { - with_event_converter(|c| c.convert_form_data(self)) +impl From<&PlatformEventData> for FormData { + fn from(val: &PlatformEventData) -> Self { + with_event_converter(|c| c.convert_form_data(val)) } } -impl Into for &PlatformEventData { - fn into(self) -> ImageData { - with_event_converter(|c| c.convert_image_data(self)) +impl From<&PlatformEventData> for ImageData { + fn from(val: &PlatformEventData) -> Self { + with_event_converter(|c| c.convert_image_data(val)) } } -impl Into for &PlatformEventData { - fn into(self) -> KeyboardData { - with_event_converter(|c| c.convert_keyboard_data(self)) +impl From<&PlatformEventData> for KeyboardData { + fn from(val: &PlatformEventData) -> Self { + with_event_converter(|c| c.convert_keyboard_data(val)) } } -impl Into for &PlatformEventData { - fn into(self) -> MediaData { - with_event_converter(|c| c.convert_media_data(self)) +impl From<&PlatformEventData> for MediaData { + fn from(val: &PlatformEventData) -> Self { + with_event_converter(|c| c.convert_media_data(val)) } } -impl Into for &PlatformEventData { - fn into(self) -> MountedData { - with_event_converter(|c| c.convert_mounted_data(self)) +impl From<&PlatformEventData> for MountedData { + fn from(val: &PlatformEventData) -> Self { + with_event_converter(|c| c.convert_mounted_data(val)) } } -impl Into for &PlatformEventData { - fn into(self) -> MouseData { - with_event_converter(|c| c.convert_mouse_data(self)) +impl From<&PlatformEventData> for MouseData { + fn from(val: &PlatformEventData) -> Self { + with_event_converter(|c| c.convert_mouse_data(val)) } } -impl Into for &PlatformEventData { - fn into(self) -> PointerData { - with_event_converter(|c| c.convert_pointer_data(self)) +impl From<&PlatformEventData> for PointerData { + fn from(val: &PlatformEventData) -> Self { + with_event_converter(|c| c.convert_pointer_data(val)) } } -impl Into for &PlatformEventData { - fn into(self) -> ScrollData { - with_event_converter(|c| c.convert_scroll_data(self)) +impl From<&PlatformEventData> for ScrollData { + fn from(val: &PlatformEventData) -> Self { + with_event_converter(|c| c.convert_scroll_data(val)) } } -impl Into for &PlatformEventData { - fn into(self) -> SelectionData { - with_event_converter(|c| c.convert_selection_data(self)) +impl From<&PlatformEventData> for SelectionData { + fn from(val: &PlatformEventData) -> Self { + with_event_converter(|c| c.convert_selection_data(val)) } } -impl Into for &PlatformEventData { - fn into(self) -> ToggleData { - with_event_converter(|c| c.convert_toggle_data(self)) +impl From<&PlatformEventData> for ToggleData { + fn from(val: &PlatformEventData) -> Self { + with_event_converter(|c| c.convert_toggle_data(val)) } } -impl Into for &PlatformEventData { - fn into(self) -> TouchData { - with_event_converter(|c| c.convert_touch_data(self)) +impl From<&PlatformEventData> for TouchData { + fn from(val: &PlatformEventData) -> Self { + with_event_converter(|c| c.convert_touch_data(val)) } } -impl Into for &PlatformEventData { - fn into(self) -> TransitionData { - with_event_converter(|c| c.convert_transition_data(self)) +impl From<&PlatformEventData> for TransitionData { + fn from(val: &PlatformEventData) -> Self { + with_event_converter(|c| c.convert_transition_data(val)) } } -impl Into for &PlatformEventData { - fn into(self) -> WheelData { - with_event_converter(|c| c.convert_wheel_data(self)) +impl From<&PlatformEventData> for WheelData { + fn from(val: &PlatformEventData) -> Self { + with_event_converter(|c| c.convert_wheel_data(val)) } } diff --git a/packages/web/src/event.rs b/packages/web/src/event.rs index 8767b6a35..c1e28c354 100644 --- a/packages/web/src/event.rs +++ b/packages/web/src/event.rs @@ -162,7 +162,7 @@ impl WebEventExt for dioxus_html::AnimationData { impl WebEventExt for dioxus_html::ClipboardData { fn web_event(&self) -> &web_sys::Event { - &self + self .downcast::() .expect("event should be a web_sys::Event") } From dee92b83be8599161d1982ceaa3b2c35d2cba2e8 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Fri, 1 Sep 2023 15:06:30 -0500 Subject: [PATCH 069/447] remove the serde feature flag from enumset --- packages/html/Cargo.toml | 1 - 1 file changed, 1 deletion(-) diff --git a/packages/html/Cargo.toml b/packages/html/Cargo.toml index 7e061855e..5b665d14b 100644 --- a/packages/html/Cargo.toml +++ b/packages/html/Cargo.toml @@ -56,7 +56,6 @@ serialize = [ "euclid/serde", "keyboard-types/serde", "dioxus-core/serialize", - "enumset/serde", ] mounted = [ "web-sys/Element", From df222c121a22f1ab30846f065c9c46425aeb424f Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Fri, 1 Sep 2023 15:38:55 -0500 Subject: [PATCH 070/447] port examples to new events --- docs/guide/examples/hello_world_tui_no_ctrl_c.rs | 4 ++-- docs/guide/examples/input_controlled.rs | 2 +- docs/guide/examples/meme_editor.rs | 2 +- docs/guide/examples/meme_editor_dark_mode.rs | 4 ++-- docs/guide/examples/rendering_lists.rs | 4 ++-- examples/compose.rs | 2 +- examples/counter.rs | 2 +- examples/crm.rs | 6 +++--- examples/file_upload.rs | 4 ++-- examples/form.rs | 4 ++-- examples/login_form.rs | 4 ++-- examples/shared_state.rs | 2 +- examples/textarea.rs | 2 +- examples/todomvc.rs | 6 +++--- examples/window_zoom.rs | 2 +- examples/xss_safety.rs | 2 +- packages/cli/Cargo.toml | 2 +- packages/core/tests/lifecycle.rs | 9 ++++++++- packages/core/tests/miri_full_app.rs | 9 ++++++++- packages/core/tests/suspense.rs | 2 +- packages/desktop/headless_tests/events.rs | 6 +++--- packages/dioxus-tui/examples/widgets.rs | 10 +++++----- packages/html/src/lib.rs | 2 +- packages/html/src/transit.rs | 2 +- packages/router/examples/simple_routes.rs | 2 +- 25 files changed, 55 insertions(+), 41 deletions(-) diff --git a/docs/guide/examples/hello_world_tui_no_ctrl_c.rs b/docs/guide/examples/hello_world_tui_no_ctrl_c.rs index 6afa21e6c..62131f0a3 100644 --- a/docs/guide/examples/hello_world_tui_no_ctrl_c.rs +++ b/docs/guide/examples/hello_world_tui_no_ctrl_c.rs @@ -1,7 +1,7 @@ // todo remove deprecated #![allow(non_snake_case, deprecated)] -use dioxus::events::{KeyCode, KeyboardEvent}; +use dioxus::events::KeyboardEvent; use dioxus::prelude::*; use dioxus_tui::TuiContext; @@ -26,7 +26,7 @@ fn App(cx: Scope) -> Element { background_color: "red", justify_content: "center", align_items: "center", - onkeydown: move |k: KeyboardEvent| if let KeyCode::Q = k.key_code { + onkeydown: move |k: KeyboardEvent| if let Code::KeyQ = k.code() { tui_ctx.quit(); }, diff --git a/docs/guide/examples/input_controlled.rs b/docs/guide/examples/input_controlled.rs index bf92072a3..e9f33ef53 100644 --- a/docs/guide/examples/input_controlled.rs +++ b/docs/guide/examples/input_controlled.rs @@ -14,7 +14,7 @@ fn App(cx: Scope) -> Element { // we tell the component what to render value: "{name}", // and what to do when the value changes - oninput: move |evt| name.set(evt.value.clone()), + oninput: move |evt| name.set(evt.value()), } }) } diff --git a/docs/guide/examples/meme_editor.rs b/docs/guide/examples/meme_editor.rs index c5a473da9..1bf4df0b4 100644 --- a/docs/guide/examples/meme_editor.rs +++ b/docs/guide/examples/meme_editor.rs @@ -28,7 +28,7 @@ fn MemeEditor(cx: Scope) -> Element { }, CaptionEditor { caption: caption, - on_input: move |event: FormEvent| {caption.set(event.value.clone());}, + on_input: move |event: FormEvent| {caption.set(event.value());}, }, } }) diff --git a/docs/guide/examples/meme_editor_dark_mode.rs b/docs/guide/examples/meme_editor_dark_mode.rs index e62a64eb7..893bc2cc8 100644 --- a/docs/guide/examples/meme_editor_dark_mode.rs +++ b/docs/guide/examples/meme_editor_dark_mode.rs @@ -62,7 +62,7 @@ pub fn DarkModeToggle(cx: Scope) -> Element { input { r#type: "checkbox", oninput: move |event| { - let is_enabled = event.value == "true"; + let is_enabled = event.value() == "true"; dark_mode.write().0 = is_enabled; }, }, @@ -97,7 +97,7 @@ fn MemeEditor(cx: Scope) -> Element { }, CaptionEditor { caption: caption, - on_input: move |event: FormEvent| {caption.set(event.value.clone());}, + on_input: move |event: FormEvent| {caption.set(event.value().clone());}, }, } }) diff --git a/docs/guide/examples/rendering_lists.rs b/docs/guide/examples/rendering_lists.rs index b95e712dc..05df11eb7 100644 --- a/docs/guide/examples/rendering_lists.rs +++ b/docs/guide/examples/rendering_lists.rs @@ -40,7 +40,7 @@ cx.render(rsx!( }, input { value: "{comment_field}", - oninput: |event| comment_field.set(event.value.clone()), + oninput: |event| comment_field.set(event.value()), } input { r#type: "submit", @@ -71,7 +71,7 @@ cx.render(rsx!( }, input { value: "{comment_field}", - oninput: |event| comment_field.set(event.value.clone()), + oninput: |event| comment_field.set(event.value()), } input { r#type: "submit", diff --git a/examples/compose.rs b/examples/compose.rs index 3ee6d36ae..5f5b9ebc1 100644 --- a/examples/compose.rs +++ b/examples/compose.rs @@ -73,7 +73,7 @@ fn compose(cx: Scope) -> Element { input { oninput: move |e| { - user_input.set(e.value.clone()); + user_input.set(e.value()); }, value: "{user_input}" } diff --git a/examples/counter.rs b/examples/counter.rs index f51083a95..1de77dc38 100644 --- a/examples/counter.rs +++ b/examples/counter.rs @@ -22,7 +22,7 @@ fn app(cx: Scope) -> Element { input { value: "{counter}", oninput: move |e| { - if let Ok(value) = e.value.parse::() { + if let Ok(value) = e.value().parse::() { counters.make_mut()[i] = value; } } diff --git a/examples/crm.rs b/examples/crm.rs index f3da8ab7a..7ab0c8ad7 100644 --- a/examples/crm.rs +++ b/examples/crm.rs @@ -119,7 +119,7 @@ fn ClientAdd(cx: Scope) -> Element { placeholder: "First Name…", required: "", value: "{first_name}", - oninput: move |e| first_name.set(e.value.clone()) + oninput: move |e| first_name.set(e.value()) } } @@ -135,7 +135,7 @@ fn ClientAdd(cx: Scope) -> Element { placeholder: "Last Name…", required: "", value: "{last_name}", - oninput: move |e| last_name.set(e.value.clone()) + oninput: move |e| last_name.set(e.value()) } } @@ -149,7 +149,7 @@ fn ClientAdd(cx: Scope) -> Element { id: "description", placeholder: "Description…", value: "{description}", - oninput: move |e| description.set(e.value.clone()) + oninput: move |e| description.set(e.value()) } } diff --git a/examples/file_upload.rs b/examples/file_upload.rs index c7358c685..882285ddf 100644 --- a/examples/file_upload.rs +++ b/examples/file_upload.rs @@ -16,7 +16,7 @@ fn App(cx: Scope) -> Element { r#type: "checkbox", checked: "{enable_directory_upload}", oninput: move |evt| { - enable_directory_upload.set(evt.value.parse().unwrap()); + enable_directory_upload.set(evt.value().parse().unwrap()); }, }, "Enable directory upload" @@ -30,7 +30,7 @@ fn App(cx: Scope) -> Element { onchange: |evt| { to_owned![files_uploaded]; async move { - if let Some(file_engine) = &evt.files { + if let Some(file_engine) = &evt.files() { let files = file_engine.files(); for file_name in files { sleep(std::time::Duration::from_secs(1)).await; diff --git a/examples/form.rs b/examples/form.rs index a7de142f3..897ffc710 100644 --- a/examples/form.rs +++ b/examples/form.rs @@ -14,8 +14,8 @@ fn app(cx: Scope) -> Element { div { h1 { "Form" } form { - onsubmit: move |ev| println!("Submitted {:?}", ev.values), - oninput: move |ev| println!("Input {:?}", ev.values), + onsubmit: move |ev| println!("Submitted {:?}", ev.values()), + oninput: move |ev| println!("Input {:?}", ev.values()), input { r#type: "text", name: "username" } input { r#type: "text", name: "full-name" } input { r#type: "password", name: "password" } diff --git a/examples/login_form.rs b/examples/login_form.rs index 5ee47e4b5..d7371dc50 100644 --- a/examples/login_form.rs +++ b/examples/login_form.rs @@ -13,8 +13,8 @@ fn app(cx: Scope) -> Element { let resp = reqwest::Client::new() .post("http://localhost:8080/login") .form(&[ - ("username", &evt.values["username"]), - ("password", &evt.values["password"]), + ("username", &evt.values()["username"]), + ("password", &evt.values()["password"]), ]) .send() .await; diff --git a/examples/shared_state.rs b/examples/shared_state.rs index d129f75d1..71345dfcb 100644 --- a/examples/shared_state.rs +++ b/examples/shared_state.rs @@ -65,7 +65,7 @@ fn DataEditor(cx: Scope, id: usize) -> Element { fn DataView(cx: Scope, id: usize) -> Element { let cool_data = use_shared_state::(cx).unwrap(); - let oninput = |e: FormEvent| cool_data.write().set(*id, e.value.clone()); + let oninput = |e: FormEvent| cool_data.write().set(*id, e.value()); let cool_data = cool_data.read(); let my_data = &cool_data.view(id).unwrap(); diff --git a/examples/textarea.rs b/examples/textarea.rs index df684aa85..62afc45bb 100644 --- a/examples/textarea.rs +++ b/examples/textarea.rs @@ -17,7 +17,7 @@ fn app(cx: Scope) -> Element { rows: "10", cols: "80", value: "{model}", - oninput: move |e| model.set(e.value.clone()), + oninput: move |e| model.set(e.value().clone()), } }) } diff --git a/examples/todomvc.rs b/examples/todomvc.rs index 4b25507a5..d5dff22e8 100644 --- a/examples/todomvc.rs +++ b/examples/todomvc.rs @@ -66,7 +66,7 @@ pub fn app(cx: Scope<()>) -> Element { value: "{draft}", autofocus: "true", oninput: move |evt| { - draft.set(evt.value.clone()); + draft.set(evt.value()); }, onkeydown: move |evt| { if evt.key() == Key::Enter && !draft.is_empty() { @@ -176,7 +176,7 @@ pub fn TodoEntry<'a>(cx: Scope<'a, TodoEntryProps<'a>>) -> Element { id: "cbg-{todo.id}", checked: "{todo.checked}", oninput: move |evt| { - cx.props.todos.make_mut()[&cx.props.id].checked = evt.value.parse().unwrap(); + cx.props.todos.make_mut()[&cx.props.id].checked = evt.value().parse().unwrap(); } } label { @@ -195,7 +195,7 @@ pub fn TodoEntry<'a>(cx: Scope<'a, TodoEntryProps<'a>>) -> Element { input { class: "edit", value: "{todo.contents}", - oninput: move |evt| cx.props.todos.make_mut()[&cx.props.id].contents = evt.value.clone(), + oninput: move |evt| cx.props.todos.make_mut()[&cx.props.id].contents = evt.value(), autofocus: "true", onfocusout: move |_| is_editing.set(false), onkeydown: move |evt| { diff --git a/examples/window_zoom.rs b/examples/window_zoom.rs index e45d71be2..3c4edbb90 100644 --- a/examples/window_zoom.rs +++ b/examples/window_zoom.rs @@ -14,7 +14,7 @@ fn app(cx: Scope) -> Element { r#type: "number", value: "{level}", oninput: |e| { - if let Ok(new_zoom) = e.value.parse::() { + if let Ok(new_zoom) = e.value().parse::() { level.set(new_zoom); window.webview.zoom(new_zoom); } diff --git a/examples/xss_safety.rs b/examples/xss_safety.rs index 5272d661b..73da2ff14 100644 --- a/examples/xss_safety.rs +++ b/examples/xss_safety.rs @@ -20,7 +20,7 @@ fn app(cx: Scope) -> Element { input { value: "{contents}", r#type: "text", - oninput: move |e| contents.set(e.value.clone()), + oninput: move |e| contents.set(e.value()), } } }) diff --git a/packages/cli/Cargo.toml b/packages/cli/Cargo.toml index a37798eee..8299a88a6 100644 --- a/packages/cli/Cargo.toml +++ b/packages/cli/Cargo.toml @@ -78,7 +78,7 @@ toml_edit = "0.19.11" # dioxus-rsx = "0.0.1" # bundling -tauri-bundler = { version = "1.2", features = ["native-tls-vendored"] } +tauri-bundler = { version = "=1.2", features = ["native-tls-vendored"] } tauri-utils = "1.3" dioxus-autofmt = { workspace = true } diff --git a/packages/core/tests/lifecycle.rs b/packages/core/tests/lifecycle.rs index 04f6bc3cf..37b966712 100644 --- a/packages/core/tests/lifecycle.rs +++ b/packages/core/tests/lifecycle.rs @@ -56,7 +56,14 @@ fn events_generate() { let mut dom = VirtualDom::new(app); _ = dom.rebuild(); - dom.handle_event("click", Rc::new(MouseData::default()), ElementId(1), true); + dom.handle_event( + "click", + Rc::new(PlatformEventData::new(Box::new(MouseData::new( + SerializedMouseData::default(), + )))), + ElementId(1), + true, + ); dom.mark_dirty(ScopeId(0)); let edits = dom.render_immediate(); diff --git a/packages/core/tests/miri_full_app.rs b/packages/core/tests/miri_full_app.rs index c1c6d52cc..93277b181 100644 --- a/packages/core/tests/miri_full_app.rs +++ b/packages/core/tests/miri_full_app.rs @@ -9,7 +9,14 @@ fn miri_rollover() { _ = dom.rebuild(); for _ in 0..3 { - dom.handle_event("click", Rc::new(MouseData::default()), ElementId(2), true); + dom.handle_event( + "click", + Rc::new(PlatformEventData::new(Box::new(MouseData::new( + SerializedMouseData::default(), + )))), + ElementId(2), + true, + ); dom.process_events(); _ = dom.render_immediate(); } diff --git a/packages/core/tests/suspense.rs b/packages/core/tests/suspense.rs index 7b2516447..abce7f8a6 100644 --- a/packages/core/tests/suspense.rs +++ b/packages/core/tests/suspense.rs @@ -36,7 +36,7 @@ fn suspended_child(cx: Scope) -> Element { cx.spawn(async move { val += 1; }); - return cx.suspend()?; + cx.suspend()?; } render!("child") diff --git a/packages/desktop/headless_tests/events.rs b/packages/desktop/headless_tests/events.rs index ac62cd37b..6765a8199 100644 --- a/packages/desktop/headless_tests/events.rs +++ b/packages/desktop/headless_tests/events.rs @@ -304,7 +304,7 @@ fn app(cx: Scope) -> Element { assert!(event.data.modifiers().is_empty()); assert_eq!(event.data.key().to_string(), "a"); assert_eq!(event.data.code().to_string(), "KeyA"); - assert_eq!(event.data.location, 0); + assert_eq!(event.data.location(), Location::Standard); assert!(event.data.is_auto_repeating()); recieved_events.modify(|x| *x + 1) @@ -317,7 +317,7 @@ fn app(cx: Scope) -> Element { assert!(event.data.modifiers().is_empty()); assert_eq!(event.data.key().to_string(), "a"); assert_eq!(event.data.code().to_string(), "KeyA"); - assert_eq!(event.data.location, 0); + assert_eq!(event.data.location(), Location::Standard); assert!(!event.data.is_auto_repeating()); recieved_events.modify(|x| *x + 1) @@ -330,7 +330,7 @@ fn app(cx: Scope) -> Element { assert!(event.data.modifiers().is_empty()); assert_eq!(event.data.key().to_string(), "a"); assert_eq!(event.data.code().to_string(), "KeyA"); - assert_eq!(event.data.location, 0); + assert_eq!(event.data.location(), Location::Standard); assert!(!event.data.is_auto_repeating()); recieved_events.modify(|x| *x + 1) diff --git a/packages/dioxus-tui/examples/widgets.rs b/packages/dioxus-tui/examples/widgets.rs index b5df35388..2d0a5bf72 100644 --- a/packages/dioxus-tui/examples/widgets.rs +++ b/packages/dioxus-tui/examples/widgets.rs @@ -18,7 +18,7 @@ fn app(cx: Scope) -> Element { justify_content: "center", input { - oninput: |data| if &data.value == "good"{ + oninput: |data| if &data.value()== "good"{ bg_green.set(true); } else{ bg_green.set(false); @@ -30,7 +30,7 @@ fn app(cx: Scope) -> Element { checked: "true", } input { - oninput: |data| if &data.value == "hello world"{ + oninput: |data| if &data.value()== "hello world"{ bg_green.set(true); } else{ bg_green.set(false); @@ -41,7 +41,7 @@ fn app(cx: Scope) -> Element { } input { oninput: |data| { - if (data.value.parse::().unwrap() - 40.0).abs() < 5.0 { + if (data.value().parse::().unwrap() - 40.0).abs() < 5.0 { bg_green.set(true); } else{ bg_green.set(false); @@ -55,7 +55,7 @@ fn app(cx: Scope) -> Element { } input { oninput: |data| { - if data.value == "10"{ + if data.value()== "10"{ bg_green.set(true); } else{ bg_green.set(false); @@ -68,7 +68,7 @@ fn app(cx: Scope) -> Element { } input { oninput: |data| { - if data.value == "hello world"{ + if data.value()== "hello world"{ bg_green.set(true); } else{ bg_green.set(false); diff --git a/packages/html/src/lib.rs b/packages/html/src/lib.rs index 55037b2dc..a39dceff2 100644 --- a/packages/html/src/lib.rs +++ b/packages/html/src/lib.rs @@ -46,5 +46,5 @@ pub mod prelude { pub use crate::eval::*; pub use crate::events::*; pub use crate::point_interaction::PointInteraction; - pub use keyboard_types::{self, Code, Key, Modifiers}; + pub use keyboard_types::{self, Code, Key, Location, Modifiers}; } diff --git a/packages/html/src/transit.rs b/packages/html/src/transit.rs index 8998b5fd7..4b97f8c05 100644 --- a/packages/html/src/transit.rs +++ b/packages/html/src/transit.rs @@ -225,7 +225,7 @@ impl EventData { fn test_back_and_forth() { let data = HtmlEvent { element: ElementId(0), - data: EventData::Mouse(SerializedMouseData::default().into()), + data: EventData::Mouse(SerializedMouseData::default()), name: "click".to_string(), bubbles: true, }; diff --git a/packages/router/examples/simple_routes.rs b/packages/router/examples/simple_routes.rs index 673658870..46dd26eaf 100644 --- a/packages/router/examples/simple_routes.rs +++ b/packages/router/examples/simple_routes.rs @@ -80,7 +80,7 @@ fn Route3(cx: Scope, dynamic: String) -> Element { render! { input { oninput: move |evt| { - *current_route_str.write() = evt.value.clone(); + *current_route_str.write() = evt.value(); }, value: "{current_route_str.read()}" } From 885580f3af9aa092e5da1c6ab30433a9147faec8 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Sat, 2 Sep 2023 18:24:42 -0500 Subject: [PATCH 071/447] update to wry 0.31.0 --- examples/mobile_demo/Cargo.toml | 2 +- packages/desktop/Cargo.toml | 4 +- packages/desktop/src/desktop_context.rs | 15 +- packages/desktop/src/lib.rs | 30 ++- packages/desktop/src/mobile_shortcut.rs | 21 +- packages/desktop/src/shortcut.rs | 325 ++++++++++++------------ 6 files changed, 207 insertions(+), 190 deletions(-) diff --git a/examples/mobile_demo/Cargo.toml b/examples/mobile_demo/Cargo.toml index d22269a0c..ba2af2312 100644 --- a/examples/mobile_demo/Cargo.toml +++ b/examples/mobile_demo/Cargo.toml @@ -35,7 +35,7 @@ frameworks = ["WebKit"] [dependencies] anyhow = "1.0.56" log = "0.4.11" -wry = "0.28.0" +wry = "0.31.0" dioxus = { path = "../../packages/dioxus" } dioxus-desktop = { path = "../../packages/desktop", features = [ "tokio_runtime", diff --git a/packages/desktop/Cargo.toml b/packages/desktop/Cargo.toml index a85c2e045..311e224bb 100644 --- a/packages/desktop/Cargo.toml +++ b/packages/desktop/Cargo.toml @@ -19,7 +19,7 @@ serde = "1.0.136" serde_json = "1.0.79" thiserror = { workspace = true } log = { workspace = true } -wry = { version = "0.28.0" } +wry = { version = "0.31.0" } futures-channel = { workspace = true } tokio = { workspace = true, features = [ "sync", @@ -41,6 +41,7 @@ async-trait = "0.1.68" [target.'cfg(any(target_os = "windows",target_os = "macos",target_os = "linux",target_os = "dragonfly", target_os = "freebsd", target_os = "netbsd", target_os = "openbsd"))'.dependencies] rfd = "0.11.3" +global-hotkey = { git = "https://github.com/tauri-apps/global-hotkey" } [target.'cfg(target_os = "ios")'.dependencies] objc = "0.2.7" @@ -55,7 +56,6 @@ default = ["tokio_runtime", "hot-reload"] tokio_runtime = ["tokio"] fullscreen = ["wry/fullscreen"] transparent = ["wry/transparent"] -tray = ["wry/tray"] hot-reload = ["dioxus-hot-reload"] [dev-dependencies] diff --git a/packages/desktop/src/desktop_context.rs b/packages/desktop/src/desktop_context.rs index 166366379..5393fe113 100644 --- a/packages/desktop/src/desktop_context.rs +++ b/packages/desktop/src/desktop_context.rs @@ -5,9 +5,7 @@ use std::rc::Weak; use crate::create_new_window; use crate::events::IpcMessage; use crate::query::QueryEngine; -use crate::shortcut::ShortcutId; -use crate::shortcut::ShortcutRegistry; -use crate::shortcut::ShortcutRegistryError; +use crate::shortcut::{ShortcutId, ShortcutRegistry, ShortcutRegistryError}; use crate::Config; use crate::WebviewHandler; use dioxus_core::ScopeState; @@ -15,7 +13,6 @@ use dioxus_core::VirtualDom; #[cfg(all(feature = "hot-reload", debug_assertions))] use dioxus_hot_reload::HotReloadMsg; use slab::Slab; -use wry::application::accelerator::Accelerator; use wry::application::event::Event; use wry::application::event_loop::EventLoopProxy; use wry::application::event_loop::EventLoopWindowTarget; @@ -233,11 +230,11 @@ impl DesktopService { /// Linux: Only works on x11. See [this issue](https://github.com/tauri-apps/tao/issues/331) for more information. pub fn create_shortcut( &self, - accelerator: Accelerator, + hotkey: global_hotkey::hotkey::HotKey, callback: impl FnMut() + 'static, ) -> Result { self.shortcut_manager - .add_shortcut(accelerator, Box::new(callback)) + .add_shortcut(hotkey, Box::new(callback)) } /// Remove a global shortcut @@ -370,11 +367,7 @@ impl WryWindowEventHandlerInner { ) { // if this event does not apply to the window this listener cares about, return match event { - Event::WindowEvent { window_id, .. } - | Event::MenuEvent { - window_id: Some(window_id), - .. - } => { + Event::WindowEvent { window_id, .. } => { if *window_id != self.window_id { return; } diff --git a/packages/desktop/src/lib.rs b/packages/desktop/src/lib.rs index 070bfa7d1..130170b6f 100644 --- a/packages/desktop/src/lib.rs +++ b/packages/desktop/src/lib.rs @@ -10,15 +10,14 @@ mod escape; mod eval; mod events; mod file_upload; +#[cfg(any(target_os = "ios", target_os = "android"))] +mod mobile_shortcut; mod protocol; mod query; mod shortcut; mod waker; mod webview; -#[cfg(any(target_os = "ios", target_os = "android"))] -mod mobile_shortcut; - use crate::query::QueryResult; pub use cfg::{Config, WindowCloseBehaviour}; pub use desktop_context::DesktopContext; @@ -32,6 +31,16 @@ use dioxus_html::{native_bind::NativeFileEngine, FormData, HtmlEvent}; use element::DesktopElement; use eval::init_eval; use futures_util::{pin_mut, FutureExt}; +#[cfg(any( + target_os = "windows", + target_os = "macos", + target_os = "linux", + target_os = "dragonfly", + target_os = "freebsd", + target_os = "netbsd", + target_os = "openbsd" +))] +use global_hotkey::GlobalHotKeyEvent; use shortcut::ShortcutRegistry; pub use shortcut::{use_global_shortcut, ShortcutHandle, ShortcutId, ShortcutRegistryError}; use std::cell::Cell; @@ -43,10 +52,11 @@ use tao::event_loop::{EventLoopProxy, EventLoopWindowTarget}; pub use tao::window::WindowBuilder; use tao::{ event::{Event, StartCause, WindowEvent}, - event_loop::{ControlFlow, EventLoop}, + event_loop::ControlFlow, }; pub use wry; pub use wry::application as tao; +use wry::application::event_loop::EventLoopBuilder; use wry::webview::WebView; use wry::{application::window::WindowId, webview::WebContext}; @@ -118,7 +128,7 @@ pub fn launch_cfg(root: Component, config_builder: Config) { /// } /// ``` pub fn launch_with_props(root: Component

, props: P, cfg: Config) { - let event_loop = EventLoop::::with_user_event(); + let event_loop = EventLoopBuilder::::with_user_event().build(); let proxy = event_loop.create_proxy(); @@ -155,7 +165,8 @@ pub fn launch_with_props(root: Component

, props: P, cfg: Config) let queue = WebviewQueue::default(); - let shortcut_manager = ShortcutRegistry::new(&event_loop); + let shortcut_manager = ShortcutRegistry::new(); + let global_hotkey_channel = GlobalHotKeyEvent::receiver(); // move the props into a cell so we can pop it out later to create the first window // iOS panics if we create a window before the event loop is started @@ -163,10 +174,14 @@ pub fn launch_with_props(root: Component

, props: P, cfg: Config) let cfg = Rc::new(Cell::new(Some(cfg))); event_loop.run(move |window_event, event_loop, control_flow| { - *control_flow = ControlFlow::Wait; + *control_flow = ControlFlow::Poll; event_handlers.apply_event(&window_event, event_loop); + if let Ok(event) = global_hotkey_channel.try_recv() { + shortcut_manager.call_handlers(event); + } + match window_event { Event::WindowEvent { event, window_id, .. @@ -366,7 +381,6 @@ pub fn launch_with_props(root: Component

, props: P, cfg: Config) _ => {} }, - Event::GlobalShortcutEvent(id) => shortcut_manager.call_handlers(id), _ => {} } }) diff --git a/packages/desktop/src/mobile_shortcut.rs b/packages/desktop/src/mobile_shortcut.rs index 29149b55b..b4919dfdf 100644 --- a/packages/desktop/src/mobile_shortcut.rs +++ b/packages/desktop/src/mobile_shortcut.rs @@ -4,7 +4,16 @@ use super::*; use wry::application::accelerator::Accelerator; use wry::application::event_loop::EventLoopWindowTarget; -pub struct GlobalShortcut(); +pub struct HotKey(); + +impl FromStr for HotKey { + type Err = (); + + fn from_str(s: &str) -> Result { + Ok(HotKey()) + } +} + pub struct ShortcutManager(); impl ShortcutManager { @@ -53,3 +62,13 @@ impl fmt::Display for ShortcutManagerError { } } } + +struct HotkeyError; + +struct GlobalHotKeyEvent { + id: u32, +} + +pub(crate) type Code = dioxus::prelude::Code; + +struct GlobalHotKeyManager {} diff --git a/packages/desktop/src/shortcut.rs b/packages/desktop/src/shortcut.rs index ffc64a232..9696fa520 100644 --- a/packages/desktop/src/shortcut.rs +++ b/packages/desktop/src/shortcut.rs @@ -3,39 +3,29 @@ use std::{cell::RefCell, collections::HashMap, rc::Rc, str::FromStr}; use dioxus_core::ScopeState; use dioxus_html::input_data::keyboard_types::Modifiers; use slab::Slab; -use wry::application::{ - accelerator::{Accelerator, AcceleratorId}, - event_loop::EventLoopWindowTarget, - keyboard::{KeyCode, ModifiersState}, -}; +use wry::application::keyboard::ModifiersState; use crate::{desktop_context::DesktopContext, use_window}; -#[cfg(any( - target_os = "windows", - target_os = "macos", - target_os = "linux", - target_os = "dragonfly", - target_os = "freebsd", - target_os = "netbsd", - target_os = "openbsd" -))] -use wry::application::global_shortcut::{GlobalShortcut, ShortcutManager, ShortcutManagerError}; +use global_hotkey::{ + hotkey::{Code, HotKey}, + Error as HotkeyError, GlobalHotKeyEvent, GlobalHotKeyManager, +}; #[cfg(any(target_os = "ios", target_os = "android"))] pub use crate::mobile_shortcut::*; #[derive(Clone)] pub(crate) struct ShortcutRegistry { - manager: Rc>, + manager: Rc>, shortcuts: ShortcutMap, } -type ShortcutMap = Rc>>; +type ShortcutMap = Rc>>; struct Shortcut { #[allow(unused)] - shortcut: GlobalShortcut, + shortcut: HotKey, callbacks: Slab>, } @@ -54,15 +44,15 @@ impl Shortcut { } impl ShortcutRegistry { - pub fn new(target: &EventLoopWindowTarget) -> Self { + pub fn new() -> Self { Self { - manager: Rc::new(RefCell::new(ShortcutManager::new(target))), + manager: Rc::new(RefCell::new(GlobalHotKeyManager::new().unwrap())), shortcuts: Rc::new(RefCell::new(HashMap::new())), } } - pub(crate) fn call_handlers(&self, id: AcceleratorId) { - if let Some(Shortcut { callbacks, .. }) = self.shortcuts.borrow_mut().get_mut(&id) { + pub(crate) fn call_handlers(&self, id: GlobalHotKeyEvent) { + if let Some(Shortcut { callbacks, .. }) = self.shortcuts.borrow_mut().get_mut(&id.id) { for (_, callback) in callbacks.iter_mut() { (callback)(); } @@ -71,10 +61,10 @@ impl ShortcutRegistry { pub(crate) fn add_shortcut( &self, - accelerator: Accelerator, + hotkey: global_hotkey::hotkey::HotKey, callback: Box, ) -> Result { - let accelerator_id = accelerator.clone().id(); + let accelerator_id = hotkey.clone().id(); let mut shortcuts = self.shortcuts.borrow_mut(); Ok( if let Some(callbacks) = shortcuts.get_mut(&accelerator_id) { @@ -84,12 +74,12 @@ impl ShortcutRegistry { number: id, } } else { - match self.manager.borrow_mut().register(accelerator) { - Ok(global_shortcut) => { + match self.manager.borrow_mut().register(hotkey) { + Ok(_) => { let mut slab = Slab::new(); let id = slab.insert(callback); let shortcut = Shortcut { - shortcut: global_shortcut, + shortcut: hotkey, callbacks: slab, }; shortcuts.insert(accelerator_id, shortcut); @@ -98,7 +88,7 @@ impl ShortcutRegistry { number: id, } } - Err(ShortcutManagerError::InvalidAccelerator(shortcut)) => { + Err(HotkeyError::HotKeyParseError(shortcut)) => { return Err(ShortcutRegistryError::InvalidShortcut(shortcut)) } Err(err) => return Err(ShortcutRegistryError::Other(Box::new(err))), @@ -113,15 +103,6 @@ impl ShortcutRegistry { callbacks.remove(id.number); if callbacks.is_empty() { if let Some(_shortcut) = shortcuts.remove(&id.id) { - #[cfg(any( - target_os = "windows", - target_os = "macos", - target_os = "linux", - target_os = "dragonfly", - target_os = "freebsd", - target_os = "netbsd", - target_os = "openbsd" - ))] let _ = self.manager.borrow_mut().unregister(_shortcut.shortcut); } } @@ -130,8 +111,8 @@ impl ShortcutRegistry { pub(crate) fn remove_all(&self) { let mut shortcuts = self.shortcuts.borrow_mut(); - shortcuts.clear(); - let _ = self.manager.borrow_mut().unregister_all(); + let hotkeys: Vec<_> = shortcuts.drain().map(|(_, v)| v.shortcut).collect(); + let _ = self.manager.borrow_mut().unregister_all(&hotkeys); } } @@ -148,7 +129,7 @@ pub enum ShortcutRegistryError { #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)] /// An global id for a shortcut. pub struct ShortcutId { - id: AcceleratorId, + id: u32, number: usize, } @@ -160,33 +141,42 @@ pub struct ShortcutHandle { } pub trait IntoAccelerator { - fn accelerator(&self) -> Accelerator; + fn accelerator(&self) -> HotKey; } impl IntoAccelerator for (dioxus_html::KeyCode, ModifiersState) { - fn accelerator(&self) -> Accelerator { - Accelerator::new(Some(self.1), self.0.into_key_code()) + fn accelerator(&self) -> HotKey { + HotKey::new(Some(self.1.into_modifiers_state()), self.0.into_key_code()) } } impl IntoAccelerator for (ModifiersState, dioxus_html::KeyCode) { - fn accelerator(&self) -> Accelerator { - Accelerator::new(Some(self.0), self.1.into_key_code()) + fn accelerator(&self) -> HotKey { + HotKey::new(Some(self.0.into_modifiers_state()), self.1.into_key_code()) } } impl IntoAccelerator for dioxus_html::KeyCode { - fn accelerator(&self) -> Accelerator { - Accelerator::new(None, self.into_key_code()) + fn accelerator(&self) -> HotKey { + HotKey::new(None, self.into_key_code()) } } impl IntoAccelerator for &str { - fn accelerator(&self) -> Accelerator { - Accelerator::from_str(self).unwrap() + fn accelerator(&self) -> HotKey { + HotKey::from_str(self).unwrap() } } +#[cfg(any( + target_os = "windows", + target_os = "macos", + target_os = "linux", + target_os = "dragonfly", + target_os = "freebsd", + target_os = "netbsd", + target_os = "openbsd" +))] /// Get a closure that executes any JavaScript in the WebView context. pub fn use_global_shortcut( cx: &ScopeState, @@ -220,143 +210,144 @@ impl Drop for ShortcutHandle { } pub trait IntoModifersState { - fn into_modifiers_state(self) -> ModifiersState; + fn into_modifiers_state(self) -> Modifiers; } impl IntoModifersState for ModifiersState { - fn into_modifiers_state(self) -> ModifiersState { - self + fn into_modifiers_state(self) -> Modifiers { + let mut modifiers = Modifiers::default(); + if self.shift_key() { + modifiers |= Modifiers::SHIFT; + } + if self.control_key() { + modifiers |= Modifiers::CONTROL; + } + if self.alt_key() { + modifiers |= Modifiers::ALT; + } + if self.super_key() { + modifiers |= Modifiers::META; + } + + modifiers } } impl IntoModifersState for Modifiers { - fn into_modifiers_state(self) -> ModifiersState { - let mut state = ModifiersState::empty(); - if self.contains(Modifiers::SHIFT) { - state |= ModifiersState::SHIFT - } - if self.contains(Modifiers::CONTROL) { - state |= ModifiersState::CONTROL - } - if self.contains(Modifiers::ALT) { - state |= ModifiersState::ALT - } - if self.contains(Modifiers::META) || self.contains(Modifiers::SUPER) { - state |= ModifiersState::SUPER - } - state + fn into_modifiers_state(self) -> Modifiers { + self } } pub trait IntoKeyCode { - fn into_key_code(self) -> KeyCode; + fn into_key_code(self) -> Code; } -impl IntoKeyCode for KeyCode { - fn into_key_code(self) -> KeyCode { +impl IntoKeyCode for Code { + fn into_key_code(self) -> Code { self } } impl IntoKeyCode for dioxus_html::KeyCode { - fn into_key_code(self) -> KeyCode { + fn into_key_code(self) -> Code { match self { - dioxus_html::KeyCode::Backspace => KeyCode::Backspace, - dioxus_html::KeyCode::Tab => KeyCode::Tab, - dioxus_html::KeyCode::Clear => KeyCode::NumpadClear, - dioxus_html::KeyCode::Enter => KeyCode::Enter, - dioxus_html::KeyCode::Shift => KeyCode::ShiftLeft, - dioxus_html::KeyCode::Ctrl => KeyCode::ControlLeft, - dioxus_html::KeyCode::Alt => KeyCode::AltLeft, - dioxus_html::KeyCode::Pause => KeyCode::Pause, - dioxus_html::KeyCode::CapsLock => KeyCode::CapsLock, - dioxus_html::KeyCode::Escape => KeyCode::Escape, - dioxus_html::KeyCode::Space => KeyCode::Space, - dioxus_html::KeyCode::PageUp => KeyCode::PageUp, - dioxus_html::KeyCode::PageDown => KeyCode::PageDown, - dioxus_html::KeyCode::End => KeyCode::End, - dioxus_html::KeyCode::Home => KeyCode::Home, - dioxus_html::KeyCode::LeftArrow => KeyCode::ArrowLeft, - dioxus_html::KeyCode::UpArrow => KeyCode::ArrowUp, - dioxus_html::KeyCode::RightArrow => KeyCode::ArrowRight, - dioxus_html::KeyCode::DownArrow => KeyCode::ArrowDown, - dioxus_html::KeyCode::Insert => KeyCode::Insert, - dioxus_html::KeyCode::Delete => KeyCode::Delete, - dioxus_html::KeyCode::Num0 => KeyCode::Numpad0, - dioxus_html::KeyCode::Num1 => KeyCode::Numpad1, - dioxus_html::KeyCode::Num2 => KeyCode::Numpad2, - dioxus_html::KeyCode::Num3 => KeyCode::Numpad3, - dioxus_html::KeyCode::Num4 => KeyCode::Numpad4, - dioxus_html::KeyCode::Num5 => KeyCode::Numpad5, - dioxus_html::KeyCode::Num6 => KeyCode::Numpad6, - dioxus_html::KeyCode::Num7 => KeyCode::Numpad7, - dioxus_html::KeyCode::Num8 => KeyCode::Numpad8, - dioxus_html::KeyCode::Num9 => KeyCode::Numpad9, - dioxus_html::KeyCode::A => KeyCode::KeyA, - dioxus_html::KeyCode::B => KeyCode::KeyB, - dioxus_html::KeyCode::C => KeyCode::KeyC, - dioxus_html::KeyCode::D => KeyCode::KeyD, - dioxus_html::KeyCode::E => KeyCode::KeyE, - dioxus_html::KeyCode::F => KeyCode::KeyF, - dioxus_html::KeyCode::G => KeyCode::KeyG, - dioxus_html::KeyCode::H => KeyCode::KeyH, - dioxus_html::KeyCode::I => KeyCode::KeyI, - dioxus_html::KeyCode::J => KeyCode::KeyJ, - dioxus_html::KeyCode::K => KeyCode::KeyK, - dioxus_html::KeyCode::L => KeyCode::KeyL, - dioxus_html::KeyCode::M => KeyCode::KeyM, - dioxus_html::KeyCode::N => KeyCode::KeyN, - dioxus_html::KeyCode::O => KeyCode::KeyO, - dioxus_html::KeyCode::P => KeyCode::KeyP, - dioxus_html::KeyCode::Q => KeyCode::KeyQ, - dioxus_html::KeyCode::R => KeyCode::KeyR, - dioxus_html::KeyCode::S => KeyCode::KeyS, - dioxus_html::KeyCode::T => KeyCode::KeyT, - dioxus_html::KeyCode::U => KeyCode::KeyU, - dioxus_html::KeyCode::V => KeyCode::KeyV, - dioxus_html::KeyCode::W => KeyCode::KeyW, - dioxus_html::KeyCode::X => KeyCode::KeyX, - dioxus_html::KeyCode::Y => KeyCode::KeyY, - dioxus_html::KeyCode::Z => KeyCode::KeyZ, - dioxus_html::KeyCode::Numpad0 => KeyCode::Numpad0, - dioxus_html::KeyCode::Numpad1 => KeyCode::Numpad1, - dioxus_html::KeyCode::Numpad2 => KeyCode::Numpad2, - dioxus_html::KeyCode::Numpad3 => KeyCode::Numpad3, - dioxus_html::KeyCode::Numpad4 => KeyCode::Numpad4, - dioxus_html::KeyCode::Numpad5 => KeyCode::Numpad5, - dioxus_html::KeyCode::Numpad6 => KeyCode::Numpad6, - dioxus_html::KeyCode::Numpad7 => KeyCode::Numpad7, - dioxus_html::KeyCode::Numpad8 => KeyCode::Numpad8, - dioxus_html::KeyCode::Numpad9 => KeyCode::Numpad9, - dioxus_html::KeyCode::Multiply => KeyCode::NumpadMultiply, - dioxus_html::KeyCode::Add => KeyCode::NumpadAdd, - dioxus_html::KeyCode::Subtract => KeyCode::NumpadSubtract, - dioxus_html::KeyCode::DecimalPoint => KeyCode::NumpadDecimal, - dioxus_html::KeyCode::Divide => KeyCode::NumpadDivide, - dioxus_html::KeyCode::F1 => KeyCode::F1, - dioxus_html::KeyCode::F2 => KeyCode::F2, - dioxus_html::KeyCode::F3 => KeyCode::F3, - dioxus_html::KeyCode::F4 => KeyCode::F4, - dioxus_html::KeyCode::F5 => KeyCode::F5, - dioxus_html::KeyCode::F6 => KeyCode::F6, - dioxus_html::KeyCode::F7 => KeyCode::F7, - dioxus_html::KeyCode::F8 => KeyCode::F8, - dioxus_html::KeyCode::F9 => KeyCode::F9, - dioxus_html::KeyCode::F10 => KeyCode::F10, - dioxus_html::KeyCode::F11 => KeyCode::F11, - dioxus_html::KeyCode::F12 => KeyCode::F12, - dioxus_html::KeyCode::NumLock => KeyCode::NumLock, - dioxus_html::KeyCode::ScrollLock => KeyCode::ScrollLock, - dioxus_html::KeyCode::Semicolon => KeyCode::Semicolon, - dioxus_html::KeyCode::EqualSign => KeyCode::Equal, - dioxus_html::KeyCode::Comma => KeyCode::Comma, - dioxus_html::KeyCode::Period => KeyCode::Period, - dioxus_html::KeyCode::ForwardSlash => KeyCode::Slash, - dioxus_html::KeyCode::GraveAccent => KeyCode::Backquote, - dioxus_html::KeyCode::OpenBracket => KeyCode::BracketLeft, - dioxus_html::KeyCode::BackSlash => KeyCode::Backslash, - dioxus_html::KeyCode::CloseBraket => KeyCode::BracketRight, - dioxus_html::KeyCode::SingleQuote => KeyCode::Quote, + dioxus_html::KeyCode::Backspace => Code::Backspace, + dioxus_html::KeyCode::Tab => Code::Tab, + dioxus_html::KeyCode::Clear => Code::NumpadClear, + dioxus_html::KeyCode::Enter => Code::Enter, + dioxus_html::KeyCode::Shift => Code::ShiftLeft, + dioxus_html::KeyCode::Ctrl => Code::ControlLeft, + dioxus_html::KeyCode::Alt => Code::AltLeft, + dioxus_html::KeyCode::Pause => Code::Pause, + dioxus_html::KeyCode::CapsLock => Code::CapsLock, + dioxus_html::KeyCode::Escape => Code::Escape, + dioxus_html::KeyCode::Space => Code::Space, + dioxus_html::KeyCode::PageUp => Code::PageUp, + dioxus_html::KeyCode::PageDown => Code::PageDown, + dioxus_html::KeyCode::End => Code::End, + dioxus_html::KeyCode::Home => Code::Home, + dioxus_html::KeyCode::LeftArrow => Code::ArrowLeft, + dioxus_html::KeyCode::UpArrow => Code::ArrowUp, + dioxus_html::KeyCode::RightArrow => Code::ArrowRight, + dioxus_html::KeyCode::DownArrow => Code::ArrowDown, + dioxus_html::KeyCode::Insert => Code::Insert, + dioxus_html::KeyCode::Delete => Code::Delete, + dioxus_html::KeyCode::Num0 => Code::Numpad0, + dioxus_html::KeyCode::Num1 => Code::Numpad1, + dioxus_html::KeyCode::Num2 => Code::Numpad2, + dioxus_html::KeyCode::Num3 => Code::Numpad3, + dioxus_html::KeyCode::Num4 => Code::Numpad4, + dioxus_html::KeyCode::Num5 => Code::Numpad5, + dioxus_html::KeyCode::Num6 => Code::Numpad6, + dioxus_html::KeyCode::Num7 => Code::Numpad7, + dioxus_html::KeyCode::Num8 => Code::Numpad8, + dioxus_html::KeyCode::Num9 => Code::Numpad9, + dioxus_html::KeyCode::A => Code::KeyA, + dioxus_html::KeyCode::B => Code::KeyB, + dioxus_html::KeyCode::C => Code::KeyC, + dioxus_html::KeyCode::D => Code::KeyD, + dioxus_html::KeyCode::E => Code::KeyE, + dioxus_html::KeyCode::F => Code::KeyF, + dioxus_html::KeyCode::G => Code::KeyG, + dioxus_html::KeyCode::H => Code::KeyH, + dioxus_html::KeyCode::I => Code::KeyI, + dioxus_html::KeyCode::J => Code::KeyJ, + dioxus_html::KeyCode::K => Code::KeyK, + dioxus_html::KeyCode::L => Code::KeyL, + dioxus_html::KeyCode::M => Code::KeyM, + dioxus_html::KeyCode::N => Code::KeyN, + dioxus_html::KeyCode::O => Code::KeyO, + dioxus_html::KeyCode::P => Code::KeyP, + dioxus_html::KeyCode::Q => Code::KeyQ, + dioxus_html::KeyCode::R => Code::KeyR, + dioxus_html::KeyCode::S => Code::KeyS, + dioxus_html::KeyCode::T => Code::KeyT, + dioxus_html::KeyCode::U => Code::KeyU, + dioxus_html::KeyCode::V => Code::KeyV, + dioxus_html::KeyCode::W => Code::KeyW, + dioxus_html::KeyCode::X => Code::KeyX, + dioxus_html::KeyCode::Y => Code::KeyY, + dioxus_html::KeyCode::Z => Code::KeyZ, + dioxus_html::KeyCode::Numpad0 => Code::Numpad0, + dioxus_html::KeyCode::Numpad1 => Code::Numpad1, + dioxus_html::KeyCode::Numpad2 => Code::Numpad2, + dioxus_html::KeyCode::Numpad3 => Code::Numpad3, + dioxus_html::KeyCode::Numpad4 => Code::Numpad4, + dioxus_html::KeyCode::Numpad5 => Code::Numpad5, + dioxus_html::KeyCode::Numpad6 => Code::Numpad6, + dioxus_html::KeyCode::Numpad7 => Code::Numpad7, + dioxus_html::KeyCode::Numpad8 => Code::Numpad8, + dioxus_html::KeyCode::Numpad9 => Code::Numpad9, + dioxus_html::KeyCode::Multiply => Code::NumpadMultiply, + dioxus_html::KeyCode::Add => Code::NumpadAdd, + dioxus_html::KeyCode::Subtract => Code::NumpadSubtract, + dioxus_html::KeyCode::DecimalPoint => Code::NumpadDecimal, + dioxus_html::KeyCode::Divide => Code::NumpadDivide, + dioxus_html::KeyCode::F1 => Code::F1, + dioxus_html::KeyCode::F2 => Code::F2, + dioxus_html::KeyCode::F3 => Code::F3, + dioxus_html::KeyCode::F4 => Code::F4, + dioxus_html::KeyCode::F5 => Code::F5, + dioxus_html::KeyCode::F6 => Code::F6, + dioxus_html::KeyCode::F7 => Code::F7, + dioxus_html::KeyCode::F8 => Code::F8, + dioxus_html::KeyCode::F9 => Code::F9, + dioxus_html::KeyCode::F10 => Code::F10, + dioxus_html::KeyCode::F11 => Code::F11, + dioxus_html::KeyCode::F12 => Code::F12, + dioxus_html::KeyCode::NumLock => Code::NumLock, + dioxus_html::KeyCode::ScrollLock => Code::ScrollLock, + dioxus_html::KeyCode::Semicolon => Code::Semicolon, + dioxus_html::KeyCode::EqualSign => Code::Equal, + dioxus_html::KeyCode::Comma => Code::Comma, + dioxus_html::KeyCode::Period => Code::Period, + dioxus_html::KeyCode::ForwardSlash => Code::Slash, + dioxus_html::KeyCode::GraveAccent => Code::Backquote, + dioxus_html::KeyCode::OpenBracket => Code::BracketLeft, + dioxus_html::KeyCode::BackSlash => Code::Backslash, + dioxus_html::KeyCode::CloseBraket => Code::BracketRight, + dioxus_html::KeyCode::SingleQuote => Code::Quote, key => panic!("Failed to convert {:?} to tao::keyboard::KeyCode, try using tao::keyboard::KeyCode directly", key), } } From d1575b40d1648768ce80e621e1c75f6ffcd428b8 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Mon, 4 Sep 2023 08:24:38 -0500 Subject: [PATCH 072/447] fix mobile build --- packages/desktop/Cargo.toml | 1 + packages/desktop/src/desktop_context.rs | 4 +- packages/desktop/src/lib.rs | 11 +--- packages/desktop/src/mobile_shortcut.rs | 69 +++++++++++++++---------- packages/desktop/src/shortcut.rs | 22 ++++---- 5 files changed, 57 insertions(+), 50 deletions(-) diff --git a/packages/desktop/Cargo.toml b/packages/desktop/Cargo.toml index 311e224bb..a17b52b1a 100644 --- a/packages/desktop/Cargo.toml +++ b/packages/desktop/Cargo.toml @@ -37,6 +37,7 @@ slab = { workspace = true } futures-util = { workspace = true } urlencoding = "2.1.2" async-trait = "0.1.68" +crossbeam-channel = "0.5.8" [target.'cfg(any(target_os = "windows",target_os = "macos",target_os = "linux",target_os = "dragonfly", target_os = "freebsd", target_os = "netbsd", target_os = "openbsd"))'.dependencies] diff --git a/packages/desktop/src/desktop_context.rs b/packages/desktop/src/desktop_context.rs index 5393fe113..c5f9f5ca5 100644 --- a/packages/desktop/src/desktop_context.rs +++ b/packages/desktop/src/desktop_context.rs @@ -5,7 +5,7 @@ use std::rc::Weak; use crate::create_new_window; use crate::events::IpcMessage; use crate::query::QueryEngine; -use crate::shortcut::{ShortcutId, ShortcutRegistry, ShortcutRegistryError}; +use crate::shortcut::{HotKey, ShortcutId, ShortcutRegistry, ShortcutRegistryError}; use crate::Config; use crate::WebviewHandler; use dioxus_core::ScopeState; @@ -230,7 +230,7 @@ impl DesktopService { /// Linux: Only works on x11. See [this issue](https://github.com/tauri-apps/tao/issues/331) for more information. pub fn create_shortcut( &self, - hotkey: global_hotkey::hotkey::HotKey, + hotkey: HotKey, callback: impl FnMut() + 'static, ) -> Result { self.shortcut_manager diff --git a/packages/desktop/src/lib.rs b/packages/desktop/src/lib.rs index 130170b6f..a96cd5abf 100644 --- a/packages/desktop/src/lib.rs +++ b/packages/desktop/src/lib.rs @@ -19,6 +19,7 @@ mod waker; mod webview; use crate::query::QueryResult; +use crate::shortcut::GlobalHotKeyEvent; pub use cfg::{Config, WindowCloseBehaviour}; pub use desktop_context::DesktopContext; pub use desktop_context::{ @@ -31,16 +32,6 @@ use dioxus_html::{native_bind::NativeFileEngine, FormData, HtmlEvent}; use element::DesktopElement; use eval::init_eval; use futures_util::{pin_mut, FutureExt}; -#[cfg(any( - target_os = "windows", - target_os = "macos", - target_os = "linux", - target_os = "dragonfly", - target_os = "freebsd", - target_os = "netbsd", - target_os = "openbsd" -))] -use global_hotkey::GlobalHotKeyEvent; use shortcut::ShortcutRegistry; pub use shortcut::{use_global_shortcut, ShortcutHandle, ShortcutId, ShortcutRegistryError}; use std::cell::Cell; diff --git a/packages/desktop/src/mobile_shortcut.rs b/packages/desktop/src/mobile_shortcut.rs index b4919dfdf..c6144344b 100644 --- a/packages/desktop/src/mobile_shortcut.rs +++ b/packages/desktop/src/mobile_shortcut.rs @@ -1,38 +1,51 @@ #![allow(unused)] use super::*; -use wry::application::accelerator::Accelerator; +use std::str::FromStr; use wry::application::event_loop::EventLoopWindowTarget; -pub struct HotKey(); +use dioxus_html::input_data::keyboard_types::Modifiers; + +#[derive(Clone, Debug)] +pub struct Accelerator; + +#[derive(Clone, Copy)] +pub struct HotKey; + +impl HotKey { + pub fn new(mods: Option, key: Code) -> Self { + Self + } + + pub fn id(&self) -> u32 { + 0 + } +} impl FromStr for HotKey { type Err = (); fn from_str(s: &str) -> Result { - Ok(HotKey()) + Ok(HotKey) } } -pub struct ShortcutManager(); +pub struct GlobalHotKeyManager(); -impl ShortcutManager { - pub fn new(target: &EventLoopWindowTarget) -> Self { - Self() +impl GlobalHotKeyManager { + pub fn new() -> Result { + Ok(Self()) } - pub fn register( - &mut self, - accelerator: Accelerator, - ) -> Result { - Ok(GlobalShortcut()) + pub fn register(&mut self, accelerator: HotKey) -> Result { + Ok(HotKey) } - pub fn unregister(&mut self, id: ShortcutId) -> Result<(), ShortcutManagerError> { + pub fn unregister(&mut self, id: HotKey) -> Result<(), HotkeyError> { Ok(()) } - pub fn unregister_all(&mut self) -> Result<(), ShortcutManagerError> { + pub fn unregister_all(&mut self, _: &[HotKey]) -> Result<(), HotkeyError> { Ok(()) } } @@ -42,33 +55,35 @@ use std::{error, fmt}; /// An error whose cause the `ShortcutManager` to fail. #[non_exhaustive] #[derive(Debug)] -pub enum ShortcutManagerError { +pub enum HotkeyError { AcceleratorAlreadyRegistered(Accelerator), AcceleratorNotRegistered(Accelerator), - InvalidAccelerator(String), + HotKeyParseError(String), } -impl error::Error for ShortcutManagerError {} -impl fmt::Display for ShortcutManagerError { +impl error::Error for HotkeyError {} +impl fmt::Display for HotkeyError { fn fmt(&self, f: &mut fmt::Formatter<'_>) -> Result<(), fmt::Error> { match self { - ShortcutManagerError::AcceleratorAlreadyRegistered(e) => { + HotkeyError::AcceleratorAlreadyRegistered(e) => { f.pad(&format!("hotkey already registered: {:?}", e)) } - ShortcutManagerError::AcceleratorNotRegistered(e) => { + HotkeyError::AcceleratorNotRegistered(e) => { f.pad(&format!("hotkey not registered: {:?}", e)) } - ShortcutManagerError::InvalidAccelerator(e) => e.fmt(f), + HotkeyError::HotKeyParseError(e) => e.fmt(f), } } } -struct HotkeyError; - -struct GlobalHotKeyEvent { - id: u32, +pub struct GlobalHotKeyEvent { + pub id: u32, } -pub(crate) type Code = dioxus::prelude::Code; +impl GlobalHotKeyEvent { + pub fn receiver() -> crossbeam_channel::Receiver { + crossbeam_channel::unbounded().1 + } +} -struct GlobalHotKeyManager {} +pub(crate) type Code = dioxus_html::input_data::keyboard_types::Code; diff --git a/packages/desktop/src/shortcut.rs b/packages/desktop/src/shortcut.rs index 9696fa520..66ab4ba7a 100644 --- a/packages/desktop/src/shortcut.rs +++ b/packages/desktop/src/shortcut.rs @@ -7,7 +7,16 @@ use wry::application::keyboard::ModifiersState; use crate::{desktop_context::DesktopContext, use_window}; -use global_hotkey::{ +#[cfg(any( + target_os = "windows", + target_os = "macos", + target_os = "linux", + target_os = "dragonfly", + target_os = "freebsd", + target_os = "netbsd", + target_os = "openbsd" +))] +pub use global_hotkey::{ hotkey::{Code, HotKey}, Error as HotkeyError, GlobalHotKeyEvent, GlobalHotKeyManager, }; @@ -61,7 +70,7 @@ impl ShortcutRegistry { pub(crate) fn add_shortcut( &self, - hotkey: global_hotkey::hotkey::HotKey, + hotkey: HotKey, callback: Box, ) -> Result { let accelerator_id = hotkey.clone().id(); @@ -168,15 +177,6 @@ impl IntoAccelerator for &str { } } -#[cfg(any( - target_os = "windows", - target_os = "macos", - target_os = "linux", - target_os = "dragonfly", - target_os = "freebsd", - target_os = "netbsd", - target_os = "openbsd" -))] /// Get a closure that executes any JavaScript in the WebView context. pub fn use_global_shortcut( cx: &ScopeState, From 18fd40a5c2af4d8e7daee2bb9c4dd059836e33fa Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Mon, 4 Sep 2023 08:31:31 -0500 Subject: [PATCH 073/447] pin tauri bundler version --- packages/cli/Cargo.toml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/cli/Cargo.toml b/packages/cli/Cargo.toml index 28753f598..b1b47dd95 100644 --- a/packages/cli/Cargo.toml +++ b/packages/cli/Cargo.toml @@ -77,7 +77,7 @@ cargo-generate = "0.18" toml_edit = "0.19.11" # bundling -tauri-bundler = { version = "=1.2", features = ["native-tls-vendored"] } +tauri-bundler = { version = "=1.3.0", features = ["native-tls-vendored"] } tauri-utils = "1.3" dioxus-autofmt = { workspace = true } From e86c1647d835b72688279603af16cffada43c13a Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Mon, 4 Sep 2023 08:33:56 -0500 Subject: [PATCH 074/447] fix clippy --- packages/core/src/diff.rs | 3 +-- packages/desktop/src/desktop_context.rs | 9 +++------ 2 files changed, 4 insertions(+), 8 deletions(-) diff --git a/packages/core/src/diff.rs b/packages/core/src/diff.rs index dd4cf8147..58fceaa48 100644 --- a/packages/core/src/diff.rs +++ b/packages/core/src/diff.rs @@ -577,8 +577,7 @@ impl<'b> VirtualDom { } // 4. Compute the LIS of this list - let mut lis_sequence = Vec::default(); - lis_sequence.reserve(new_index_to_old_index.len()); + let mut lis_sequence = Vec::with_capacity(new_index_to_old_index.len()); let mut predecessors = vec![0; new_index_to_old_index.len()]; let mut starts = vec![0; new_index_to_old_index.len()]; diff --git a/packages/desktop/src/desktop_context.rs b/packages/desktop/src/desktop_context.rs index c5f9f5ca5..d2c29f676 100644 --- a/packages/desktop/src/desktop_context.rs +++ b/packages/desktop/src/desktop_context.rs @@ -366,13 +366,10 @@ impl WryWindowEventHandlerInner { target: &EventLoopWindowTarget, ) { // if this event does not apply to the window this listener cares about, return - match event { - Event::WindowEvent { window_id, .. } => { - if *window_id != self.window_id { - return; - } + if let Event::WindowEvent { window_id, .. } = event { + if *window_id != self.window_id { + return; } - _ => (), } (self.handler)(event, target) } From 148b35a87ad5b7e9cf48b853ce50893a482ef210 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Mon, 4 Sep 2023 08:42:30 -0500 Subject: [PATCH 075/447] fix clippy --- packages/cli/src/builder.rs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/cli/src/builder.rs b/packages/cli/src/builder.rs index 3e2da25e6..c551d788a 100644 --- a/packages/cli/src/builder.rs +++ b/packages/cli/src/builder.rs @@ -22,7 +22,7 @@ pub struct BuildResult { pub elapsed_time: u128, } -pub fn build(config: &CrateConfig, quiet: bool, skip_assets: bool) -> Result { +pub fn build(config: &CrateConfig, _: bool, skip_assets: bool) -> Result { // [1] Build the project with cargo, generating a wasm32-unknown-unknown target (is there a more specific, better target to leverage?) // [2] Generate the appropriate build folders // [3] Wasm-bindgen the .wasm fiile, and move it into the {builddir}/modules/xxxx/xxxx_bg.wasm From cfc6887e34c0efba775fd7b7d923b6547e5b3306 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Mon, 4 Sep 2023 09:28:16 -0500 Subject: [PATCH 076/447] use raw pointers instead of transmute to make miri happy --- packages/core/src/arena.rs | 10 ++++++---- packages/core/src/create.rs | 4 ++-- packages/core/src/diff.rs | 2 +- packages/core/src/virtual_dom.rs | 4 ++-- 4 files changed, 11 insertions(+), 9 deletions(-) diff --git a/packages/core/src/arena.rs b/packages/core/src/arena.rs index 52ea1f245..dd061eae8 100644 --- a/packages/core/src/arena.rs +++ b/packages/core/src/arena.rs @@ -25,7 +25,7 @@ pub struct ElementRef<'a> { pub(crate) path: ElementPath, // The actual template - pub(crate) template: &'a VNode<'a>, + pub(crate) template: *const VNode<'a>, // The scope the element belongs to pub(crate) scope: ScopeId, @@ -61,7 +61,10 @@ impl VirtualDom { ); } - self.elements.try_remove(el.0).map(|_| ()) + self.elements.try_remove(el.0).and_then(|id| match id { + Some(id) => self.element_refs.try_remove(id.0).map(|_| ()), + None => Some(()), + }) } pub(crate) fn set_template(&mut self, el: ElementId, element_ref: ElementRef) { @@ -80,8 +83,7 @@ impl VirtualDom { self.update_template_bubble(bubble_id, node) } - pub(crate) fn update_template_bubble(&mut self, bubble_id: BubbleId, node: &VNode) { - let node: *const VNode = node as *const _; + pub(crate) fn update_template_bubble(&mut self, bubble_id: BubbleId, node: *const VNode) { self.element_refs[bubble_id.0].template = unsafe { std::mem::transmute(node) }; } diff --git a/packages/core/src/create.rs b/packages/core/src/create.rs index a85d977e0..76182b976 100644 --- a/packages/core/src/create.rs +++ b/packages/core/src/create.rs @@ -187,7 +187,7 @@ impl<'b> VirtualDom { path: ElementPath { path: &template.template.get().node_paths[idx], }, - template: &template, + template: template, scope: self.runtime.current_scope_id().unwrap_or(ScopeId(0)), }; self.create_dynamic_node(template_ref, node) @@ -197,7 +197,7 @@ impl<'b> VirtualDom { path: ElementPath { path: &template.template.get().node_paths[idx], }, - template: &template, + template: template, scope: self.runtime.current_scope_id().unwrap_or(ScopeId(0)), }; parent.set(Some(self.next_element_ref(template_ref))); diff --git a/packages/core/src/diff.rs b/packages/core/src/diff.rs index b394f5e83..3ba2f6bf8 100644 --- a/packages/core/src/diff.rs +++ b/packages/core/src/diff.rs @@ -144,7 +144,7 @@ impl<'b> VirtualDom { .enumerate() .for_each(|(dyn_node_idx, (left_node, right_node))| { let current_ref = ElementRef { - template: right_template.into(), + template: right_template, path: ElementPath { path: left_template.template.get().node_paths[dyn_node_idx], }, diff --git a/packages/core/src/virtual_dom.rs b/packages/core/src/virtual_dom.rs index 775cd6427..b5921fd48 100644 --- a/packages/core/src/virtual_dom.rs +++ b/packages/core/src/virtual_dom.rs @@ -371,7 +371,7 @@ impl VirtualDom { // Loop through each dynamic attribute (in a depth first order) in this template before moving up to the template's parent. while let Some(el_ref) = parent_path { // safety: we maintain references of all vnodes in the element slab - let template = el_ref.template; + let template = unsafe { &*el_ref.template }; let node_template = template.template.get(); let target_path = el_ref.path; @@ -421,7 +421,7 @@ impl VirtualDom { // Otherwise, we just call the listener on the target element if let Some(el_ref) = parent_path { // safety: we maintain references of all vnodes in the element slab - let template = el_ref.template; + let template = unsafe { &*el_ref.template }; let node_template = template.template.get(); let target_path = el_ref.path; From d26aa95bcde716aec22801382e127cf67326132c Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Mon, 4 Sep 2023 09:57:26 -0500 Subject: [PATCH 077/447] update vnode ptr when parent of component reruns --- packages/core/src/arena.rs | 4 ++-- packages/core/src/create.rs | 1 + packages/core/src/diff.rs | 19 ++++++++++++++----- 3 files changed, 17 insertions(+), 7 deletions(-) diff --git a/packages/core/src/arena.rs b/packages/core/src/arena.rs index dd061eae8..aacd4dbf2 100644 --- a/packages/core/src/arena.rs +++ b/packages/core/src/arena.rs @@ -78,7 +78,7 @@ impl VirtualDom { } } - pub(crate) fn update_template(&mut self, el: ElementId, node: &VNode) { + pub(crate) fn update_template(&mut self, el: ElementId, node: *const VNode) { let bubble_id = self.elements[el.0].unwrap(); self.update_template_bubble(bubble_id, node) } @@ -135,7 +135,7 @@ impl VirtualDom { } c.props.take(); if let Some(bubble_id) = c.bubble_id.get() { - self.element_refs.remove(bubble_id.0); + self.element_refs.try_remove(bubble_id.0); } } DynamicNode::Fragment(nodes) => { diff --git a/packages/core/src/create.rs b/packages/core/src/create.rs index 76182b976..0b77b9417 100644 --- a/packages/core/src/create.rs +++ b/packages/core/src/create.rs @@ -547,6 +547,7 @@ impl<'b> VirtualDom { // Create the component's root element Ready(t) => { self.assign_boundary_ref(parent, t); + component.bubble_id.set(t.parent.get()); self.create_scope(scope, t) } Aborted(t) => self.mount_aborted(t, parent), diff --git a/packages/core/src/diff.rs b/packages/core/src/diff.rs index 3ba2f6bf8..6e53c7c3f 100644 --- a/packages/core/src/diff.rs +++ b/packages/core/src/diff.rs @@ -174,7 +174,9 @@ impl<'b> VirtualDom { (Fragment(left), Fragment(right)) => self.diff_non_empty_fragment(left, right, parent), (Placeholder(left), Placeholder(right)) => { right.id.set(left.id.get()); - right.parent.set(left.parent.get()) + right.parent.set(left.parent.get()); + // Update the template + self.update_template(left.id.get().unwrap(), parent.template); }, (Component(left), Component(right)) => self.diff_vcomponent(left, right, Some(parent)), (Placeholder(left), Fragment(right)) => self.replace_placeholder(left, *right, parent), @@ -214,10 +216,7 @@ impl<'b> VirtualDom { let scope_id = left.scope.get().unwrap(); right.scope.set(Some(scope_id)); - if let Some(bubble_id) = left.bubble_id.get() { - right.bubble_id.set(Some(bubble_id)); - self.update_template_bubble(bubble_id, parent.unwrap().template); - } + right.bubble_id.set(left.bubble_id.get()); // copy out the box for both let old = self.scopes[scope_id.0].props.as_ref(); @@ -236,6 +235,16 @@ impl<'b> VirtualDom { // Now run the component and diff it self.run_scope(scope_id); + if let Some(bubble_id) = right.bubble_id.get() { + if let RenderReturn::Ready(new_node) = unsafe { + self.scopes[scope_id.0] + .current_frame() + .try_load_node() + .expect("Call rebuild before diffing") + } { + self.update_template_bubble(bubble_id, new_node); + } + } self.diff_scope(scope_id); self.dirty_scopes.remove(&DirtyScope { From 9552ab6c1ccb8747ecdf469a52a108bb9fb34e9b Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Mon, 4 Sep 2023 19:10:11 -0500 Subject: [PATCH 078/447] pass event propagation test --- packages/core/src/arena.rs | 48 +++++++++++++++--------- packages/core/src/create.rs | 11 +++--- packages/core/src/diff.rs | 14 ++++++- packages/core/src/scope_arena.rs | 1 + packages/core/src/scopes.rs | 3 +- packages/core/src/virtual_dom.rs | 4 +- packages/core/tests/event_propagation.rs | 4 +- 7 files changed, 55 insertions(+), 30 deletions(-) diff --git a/packages/core/src/arena.rs b/packages/core/src/arena.rs index aacd4dbf2..a44e31f5a 100644 --- a/packages/core/src/arena.rs +++ b/packages/core/src/arena.rs @@ -25,7 +25,7 @@ pub struct ElementRef<'a> { pub(crate) path: ElementPath, // The actual template - pub(crate) template: *const VNode<'a>, + pub(crate) template: Option<*const VNode<'a>>, // The scope the element belongs to pub(crate) scope: ScopeId, @@ -42,10 +42,20 @@ impl VirtualDom { } pub(crate) fn next_element_ref(&mut self, element_ref: ElementRef) -> BubbleId { - BubbleId( + let new_id = BubbleId( self.element_refs .insert(unsafe { std::mem::transmute(element_ref) }), - ) + ); + + // Set this id to be dropped when the scope is rerun + if let Some(scope) = self.runtime.current_scope_id() { + self.scopes[scope.0] + .element_refs_to_drop + .borrow_mut() + .push(new_id); + } + + new_id } pub(crate) fn reclaim(&mut self, el: ElementId) { @@ -84,7 +94,7 @@ impl VirtualDom { } pub(crate) fn update_template_bubble(&mut self, bubble_id: BubbleId, node: *const VNode) { - self.element_refs[bubble_id.0].template = unsafe { std::mem::transmute(node) }; + self.element_refs[bubble_id.0].template = Some(unsafe { std::mem::transmute(node) }); } // Drop a scope and all its children @@ -124,10 +134,6 @@ impl VirtualDom { } fn drop_scope_inner(&mut self, node: &VNode) { - if let Some(id) = node.parent.get() { - self.element_refs.remove(id.0); - } - node.dynamic_nodes.iter().for_each(|node| match node { DynamicNode::Component(c) => { if let Some(f) = c.scope.get() { @@ -141,24 +147,30 @@ impl VirtualDom { DynamicNode::Fragment(nodes) => { nodes.iter().for_each(|node| self.drop_scope_inner(node)) } - DynamicNode::Placeholder(placeholder) => { - if let Some(id) = placeholder.parent.get() { - self.element_refs.remove(id.0); - } - } + DynamicNode::Placeholder(_) => {} DynamicNode::Text(_) => {} }); } /// Descend through the tree, removing any borrowed props and listeners - pub(crate) fn ensure_drop_safety(&self, scope_id: ScopeId) { + pub(crate) fn ensure_drop_safety(&mut self, scope_id: ScopeId) { let scope = &self.scopes[scope_id.0]; + { + // Drop all element refs that could be invalidated when the component was rerun + let mut element_refs = self.scopes[scope_id.0].element_refs_to_drop.borrow_mut(); + let element_refs_slab = &mut self.element_refs; + for element_ref in element_refs.drain(..) { + println!("Dropping element ref {:?}", element_ref); + element_refs_slab[element_ref.0].template = None; + } + } + // make sure we drop all borrowed props manually to guarantee that their drop implementation is called before we // run the hooks (which hold an &mut Reference) // recursively call ensure_drop_safety on all children - let mut props = scope.borrowed_props.borrow_mut(); - props.drain(..).for_each(|comp| { + let props = { scope.borrowed_props.borrow_mut().clone() }; + for comp in props { let comp = unsafe { &*comp }; match comp.scope.get() { Some(child) if child != scope_id => self.ensure_drop_safety(child), @@ -167,10 +179,10 @@ impl VirtualDom { if let Ok(mut props) = comp.props.try_borrow_mut() { *props = None; } - }); + } // Now that all the references are gone, we can safely drop our own references in our listeners. - let mut listeners = scope.attributes_to_drop.borrow_mut(); + let mut listeners = self.scopes[scope_id.0].attributes_to_drop.borrow_mut(); listeners.drain(..).for_each(|listener| { let listener = unsafe { &*listener }; match &listener.value { diff --git a/packages/core/src/create.rs b/packages/core/src/create.rs index 0b77b9417..759ee97d9 100644 --- a/packages/core/src/create.rs +++ b/packages/core/src/create.rs @@ -187,7 +187,7 @@ impl<'b> VirtualDom { path: ElementPath { path: &template.template.get().node_paths[idx], }, - template: template, + template: Some(template), scope: self.runtime.current_scope_id().unwrap_or(ScopeId(0)), }; self.create_dynamic_node(template_ref, node) @@ -197,7 +197,7 @@ impl<'b> VirtualDom { path: ElementPath { path: &template.template.get().node_paths[idx], }, - template: template, + template: Some(template), scope: self.runtime.current_scope_id().unwrap_or(ScopeId(0)), }; parent.set(Some(self.next_element_ref(template_ref))); @@ -286,7 +286,7 @@ impl<'b> VirtualDom { path: ElementPath { path: &template.template.get().node_paths[idx], }, - template, + template: Some(template), scope: self.runtime.current_scope_id().unwrap_or(ScopeId(0)), }; let m = self.create_dynamic_node(boundary_ref, &template.dynamic_nodes[idx]); @@ -340,7 +340,7 @@ impl<'b> VirtualDom { let path = &template.template.get().attr_paths[idx]; let element_ref = ElementRef { path: ElementPath { path }, - template, + template: Some(template), scope: self.runtime.current_scope_id().unwrap_or(ScopeId(0)), }; self.set_template(id, element_ref); @@ -546,9 +546,10 @@ impl<'b> VirtualDom { match unsafe { self.run_scope(scope).extend_lifetime_ref() } { // Create the component's root element Ready(t) => { + let created = self.create_scope(scope, t); self.assign_boundary_ref(parent, t); component.bubble_id.set(t.parent.get()); - self.create_scope(scope, t) + created } Aborted(t) => self.mount_aborted(t, parent), } diff --git a/packages/core/src/diff.rs b/packages/core/src/diff.rs index 6e53c7c3f..edaa0048e 100644 --- a/packages/core/src/diff.rs +++ b/packages/core/src/diff.rs @@ -144,7 +144,7 @@ impl<'b> VirtualDom { .enumerate() .for_each(|(dyn_node_idx, (left_node, right_node))| { let current_ref = ElementRef { - template: right_template, + template: Some(right_template), path: ElementPath { path: left_template.template.get().node_paths[dyn_node_idx], }, @@ -176,7 +176,7 @@ impl<'b> VirtualDom { right.id.set(left.id.get()); right.parent.set(left.parent.get()); // Update the template - self.update_template(left.id.get().unwrap(), parent.template); + self.update_template(left.id.get().unwrap(), parent.template.unwrap()); }, (Component(left), Component(right)) => self.diff_vcomponent(left, right, Some(parent)), (Placeholder(left), Fragment(right)) => self.replace_placeholder(left, *right, parent), @@ -227,6 +227,16 @@ impl<'b> VirtualDom { // The target scopestate still has the reference to the old props, so there's no need to update anything // This also implicitly drops the new props since they're not used if left.static_props && unsafe { old.as_ref().unwrap().memoize(new.as_ref()) } { + if let Some(bubble_id) = right.bubble_id.get() { + if let RenderReturn::Ready(new_node) = unsafe { + self.scopes[scope_id.0] + .current_frame() + .try_load_node() + .expect("Call rebuild before diffing") + } { + self.update_template_bubble(bubble_id, new_node); + } + } return; } diff --git a/packages/core/src/scope_arena.rs b/packages/core/src/scope_arena.rs index 138431740..cb51abf68 100644 --- a/packages/core/src/scope_arena.rs +++ b/packages/core/src/scope_arena.rs @@ -36,6 +36,7 @@ impl VirtualDom { borrowed_props: Default::default(), attributes_to_drop: Default::default(), + element_refs_to_drop: Default::default(), })); let context = diff --git a/packages/core/src/scopes.rs b/packages/core/src/scopes.rs index a9c8e4f1f..5cb066f41 100644 --- a/packages/core/src/scopes.rs +++ b/packages/core/src/scopes.rs @@ -2,7 +2,7 @@ use crate::{ any_props::AnyProps, any_props::VProps, bump_frame::BumpFrame, - innerlude::ErrorBoundary, + innerlude::{BubbleId, ErrorBoundary}, innerlude::{DynamicNode, EventHandler, VComponent, VText}, lazynodes::LazyNodes, nodes::{IntoAttributeValue, IntoDynNode, RenderReturn}, @@ -95,6 +95,7 @@ pub struct ScopeState { pub(crate) borrowed_props: RefCell>>, pub(crate) attributes_to_drop: RefCell>>, + pub(crate) element_refs_to_drop: RefCell>, pub(crate) props: Option>>, } diff --git a/packages/core/src/virtual_dom.rs b/packages/core/src/virtual_dom.rs index b5921fd48..c1043fc41 100644 --- a/packages/core/src/virtual_dom.rs +++ b/packages/core/src/virtual_dom.rs @@ -371,7 +371,7 @@ impl VirtualDom { // Loop through each dynamic attribute (in a depth first order) in this template before moving up to the template's parent. while let Some(el_ref) = parent_path { // safety: we maintain references of all vnodes in the element slab - let template = unsafe { &*el_ref.template }; + let template = unsafe { &*el_ref.template.unwrap() }; let node_template = template.template.get(); let target_path = el_ref.path; @@ -421,7 +421,7 @@ impl VirtualDom { // Otherwise, we just call the listener on the target element if let Some(el_ref) = parent_path { // safety: we maintain references of all vnodes in the element slab - let template = unsafe { &*el_ref.template }; + let template = unsafe { &*el_ref.template.unwrap() }; let node_template = template.template.get(); let target_path = el_ref.path; diff --git a/packages/core/tests/event_propagation.rs b/packages/core/tests/event_propagation.rs index 1fbf82c4a..2a87db175 100644 --- a/packages/core/tests/event_propagation.rs +++ b/packages/core/tests/event_propagation.rs @@ -16,7 +16,7 @@ fn events_propagate() { // break reference.... for _ in 0..5 { dom.mark_dirty(ScopeId(0)); - _ = dom.rebuild(); + _ = dom.render_immediate(); } // Lower click is registered @@ -26,7 +26,7 @@ fn events_propagate() { // break reference.... for _ in 0..5 { dom.mark_dirty(ScopeId(0)); - _ = dom.rebuild(); + _ = dom.render_immediate(); } // Stop propagation occurs From bd38cddc9fcda1a8174514d48927a059f4d5b4c8 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Mon, 4 Sep 2023 19:17:43 -0500 Subject: [PATCH 079/447] fix dioxus core event tests --- packages/core/Cargo.toml | 1 + packages/core/tests/lifecycle.rs | 6 +- packages/core/tests/miri_full_app.rs | 7 +- packages/html/src/transit.rs | 145 +++++++++++++++++++++++++++ 4 files changed, 155 insertions(+), 4 deletions(-) diff --git a/packages/core/Cargo.toml b/packages/core/Cargo.toml index 71afe5825..c2d387d33 100644 --- a/packages/core/Cargo.toml +++ b/packages/core/Cargo.toml @@ -36,6 +36,7 @@ serde = { version = "1", features = ["derive"], optional = true } [dev-dependencies] tokio = { workspace = true, features = ["full"] } dioxus = { workspace = true } +dioxus-html = { workspace = true, features = ["serialize"] } pretty_assertions = "1.3.0" rand = "0.8.5" dioxus-ssr = { workspace = true } diff --git a/packages/core/tests/lifecycle.rs b/packages/core/tests/lifecycle.rs index 261ea0935..0f5bc99dd 100644 --- a/packages/core/tests/lifecycle.rs +++ b/packages/core/tests/lifecycle.rs @@ -4,6 +4,7 @@ //! Tests for the lifecycle of components. use dioxus::core::{ElementId, Mutation::*}; use dioxus::prelude::*; +use dioxus_html::SerializedHtmlEventConverter; use std::rc::Rc; use std::sync::{Arc, Mutex}; @@ -39,6 +40,7 @@ fn manual_diffing() { #[test] fn events_generate() { + set_event_converter(Box::new(SerializedHtmlEventConverter)); fn app(cx: Scope) -> Element { let count = cx.use_hook(|| 0); @@ -58,9 +60,9 @@ fn events_generate() { dom.handle_event( "click", - Rc::new(PlatformEventData::new(Box::new(MouseData::new( + Rc::new(PlatformEventData::new(Box::new( SerializedMouseData::default(), - )))), + ))), ElementId(1), true, ); diff --git a/packages/core/tests/miri_full_app.rs b/packages/core/tests/miri_full_app.rs index 93277b181..8698b01b1 100644 --- a/packages/core/tests/miri_full_app.rs +++ b/packages/core/tests/miri_full_app.rs @@ -1,9 +1,12 @@ +use crate::dioxus_elements::SerializedMouseData; use dioxus::prelude::*; use dioxus_core::ElementId; +use dioxus_elements::SerializedHtmlEventConverter; use std::rc::Rc; #[test] fn miri_rollover() { + set_event_converter(Box::new(SerializedHtmlEventConverter)); let mut dom = VirtualDom::new(app); _ = dom.rebuild(); @@ -11,9 +14,9 @@ fn miri_rollover() { for _ in 0..3 { dom.handle_event( "click", - Rc::new(PlatformEventData::new(Box::new(MouseData::new( + Rc::new(PlatformEventData::new(Box::new( SerializedMouseData::default(), - )))), + ))), ElementId(2), true, ); diff --git a/packages/html/src/transit.rs b/packages/html/src/transit.rs index 4b97f8c05..06a91b46e 100644 --- a/packages/html/src/transit.rs +++ b/packages/html/src/transit.rs @@ -260,3 +260,148 @@ fn test_back_and_forth() { assert_eq!(data, p); } + +/// A trait for converting from a serialized event to a concrete event type. +pub struct SerializedHtmlEventConverter; + +impl HtmlEventConverter for SerializedHtmlEventConverter { + fn convert_animation_data(&self, event: &PlatformEventData) -> AnimationData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_clipboard_data(&self, event: &PlatformEventData) -> ClipboardData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_composition_data(&self, event: &PlatformEventData) -> CompositionData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_drag_data(&self, event: &PlatformEventData) -> DragData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_focus_data(&self, event: &PlatformEventData) -> FocusData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_form_data(&self, event: &PlatformEventData) -> FormData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_image_data(&self, event: &PlatformEventData) -> ImageData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_keyboard_data(&self, event: &PlatformEventData) -> KeyboardData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_media_data(&self, event: &PlatformEventData) -> MediaData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_mounted_data(&self, event: &PlatformEventData) -> MountedData { + event.downcast::<()>().cloned().unwrap().into() + } + + fn convert_mouse_data(&self, event: &PlatformEventData) -> MouseData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_pointer_data(&self, event: &PlatformEventData) -> PointerData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_scroll_data(&self, event: &PlatformEventData) -> ScrollData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_selection_data(&self, event: &PlatformEventData) -> SelectionData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_toggle_data(&self, event: &PlatformEventData) -> ToggleData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_touch_data(&self, event: &PlatformEventData) -> TouchData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_transition_data(&self, event: &PlatformEventData) -> TransitionData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } + + fn convert_wheel_data(&self, event: &PlatformEventData) -> WheelData { + event + .downcast::() + .cloned() + .unwrap() + .into() + } +} From 02456c10682ce14a8858dcc90c3fbb808e3c80d1 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Tue, 5 Sep 2023 21:21:54 -0500 Subject: [PATCH 080/447] fix double drop of bubble id --- packages/core/src/arena.rs | 4 +++- packages/core/src/virtual_dom.rs | 3 ++- packages/core/tests/event_propagation.rs | 6 +++++- 3 files changed, 10 insertions(+), 3 deletions(-) diff --git a/packages/core/src/arena.rs b/packages/core/src/arena.rs index a44e31f5a..5fb5fa6cb 100644 --- a/packages/core/src/arena.rs +++ b/packages/core/src/arena.rs @@ -162,7 +162,9 @@ impl VirtualDom { let element_refs_slab = &mut self.element_refs; for element_ref in element_refs.drain(..) { println!("Dropping element ref {:?}", element_ref); - element_refs_slab[element_ref.0].template = None; + if let Some(element_ref) = element_refs_slab.get_mut(element_ref.0) { + element_ref.template = None; + } } } diff --git a/packages/core/src/virtual_dom.rs b/packages/core/src/virtual_dom.rs index c1043fc41..eedfd6b9b 100644 --- a/packages/core/src/virtual_dom.rs +++ b/packages/core/src/virtual_dom.rs @@ -371,7 +371,8 @@ impl VirtualDom { // Loop through each dynamic attribute (in a depth first order) in this template before moving up to the template's parent. while let Some(el_ref) = parent_path { // safety: we maintain references of all vnodes in the element slab - let template = unsafe { &*el_ref.template.unwrap() }; + let template = + unsafe { &*el_ref.template.expect("template reference should be valid") }; let node_template = template.template.get(); let target_path = el_ref.path; diff --git a/packages/core/tests/event_propagation.rs b/packages/core/tests/event_propagation.rs index 2a87db175..be59c3fad 100644 --- a/packages/core/tests/event_propagation.rs +++ b/packages/core/tests/event_propagation.rs @@ -42,7 +42,11 @@ fn app(cx: Scope) -> Element { *CLICKS.lock().unwrap() += 1; }, - problematic_child {} + vec![ + render! { + problematic_child {} + } + ].into_iter() } } } From 0ab7a02777ce076f206d3d501888bfca44bdac40 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Tue, 5 Sep 2023 21:30:20 -0500 Subject: [PATCH 081/447] fix clippy --- packages/core/src/diff.rs | 3 +-- packages/core/tests/lifecycle.rs | 4 +--- packages/html/src/transit.rs | 4 ++-- 3 files changed, 4 insertions(+), 7 deletions(-) diff --git a/packages/core/src/diff.rs b/packages/core/src/diff.rs index dd4cf8147..58fceaa48 100644 --- a/packages/core/src/diff.rs +++ b/packages/core/src/diff.rs @@ -577,8 +577,7 @@ impl<'b> VirtualDom { } // 4. Compute the LIS of this list - let mut lis_sequence = Vec::default(); - lis_sequence.reserve(new_index_to_old_index.len()); + let mut lis_sequence = Vec::with_capacity(new_index_to_old_index.len()); let mut predecessors = vec![0; new_index_to_old_index.len()]; let mut starts = vec![0; new_index_to_old_index.len()]; diff --git a/packages/core/tests/lifecycle.rs b/packages/core/tests/lifecycle.rs index 0f5bc99dd..6db294653 100644 --- a/packages/core/tests/lifecycle.rs +++ b/packages/core/tests/lifecycle.rs @@ -60,9 +60,7 @@ fn events_generate() { dom.handle_event( "click", - Rc::new(PlatformEventData::new(Box::new( - SerializedMouseData::default(), - ))), + Rc::new(PlatformEventData::new(Box::::default())), ElementId(1), true, ); diff --git a/packages/html/src/transit.rs b/packages/html/src/transit.rs index 06a91b46e..17a8a5f2d 100644 --- a/packages/html/src/transit.rs +++ b/packages/html/src/transit.rs @@ -337,8 +337,8 @@ impl HtmlEventConverter for SerializedHtmlEventConverter { .into() } - fn convert_mounted_data(&self, event: &PlatformEventData) -> MountedData { - event.downcast::<()>().cloned().unwrap().into() + fn convert_mounted_data(&self, _: &PlatformEventData) -> MountedData { + MountedData::from(()) } fn convert_mouse_data(&self, event: &PlatformEventData) -> MouseData { From d06e64e5ad13c03bc085810002b2c3fa8a61ce29 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Wed, 6 Sep 2023 12:51:02 -0500 Subject: [PATCH 082/447] fix dioxus-tui events --- packages/core/tests/miri_full_app.rs | 4 +- packages/dioxus-tui/src/element.rs | 8 +- packages/dioxus-tui/src/events.rs | 108 ++++++++++++++++++++++++ packages/dioxus-tui/src/lib.rs | 14 ++- packages/html/src/events/animation.rs | 11 +++ packages/html/src/events/clipboard.rs | 2 + packages/html/src/events/composition.rs | 8 ++ packages/html/src/events/drag.rs | 7 ++ packages/html/src/events/focus.rs | 7 ++ packages/html/src/events/keyboard.rs | 7 ++ packages/html/src/events/media.rs | 7 ++ packages/html/src/events/scroll.rs | 7 ++ packages/html/src/events/selection.rs | 7 ++ packages/html/src/events/toggle.rs | 7 ++ packages/html/src/events/touch.rs | 7 ++ packages/html/src/events/transition.rs | 7 ++ packages/html/src/events/wheel.rs | 7 ++ packages/rink/examples/widgets.rs | 3 +- packages/rink/src/hooks.rs | 14 +-- 19 files changed, 221 insertions(+), 21 deletions(-) create mode 100644 packages/dioxus-tui/src/events.rs diff --git a/packages/core/tests/miri_full_app.rs b/packages/core/tests/miri_full_app.rs index 8698b01b1..534c3e418 100644 --- a/packages/core/tests/miri_full_app.rs +++ b/packages/core/tests/miri_full_app.rs @@ -14,9 +14,7 @@ fn miri_rollover() { for _ in 0..3 { dom.handle_event( "click", - Rc::new(PlatformEventData::new(Box::new( - SerializedMouseData::default(), - ))), + Rc::new(PlatformEventData::new(Box::::default())), ElementId(2), true, ); diff --git a/packages/dioxus-tui/src/element.rs b/packages/dioxus-tui/src/element.rs index ba496fae1..8fdb60b9f 100644 --- a/packages/dioxus-tui/src/element.rs +++ b/packages/dioxus-tui/src/element.rs @@ -1,7 +1,6 @@ use std::{ any::Any, fmt::{Display, Formatter}, - rc::Rc, }; use dioxus_core::{ElementId, Mutations, VirtualDom}; @@ -30,7 +29,7 @@ pub(crate) fn find_mount_events(mutations: &Mutations) -> Vec { // We need to queue the mounted events to give rink time to rendere and resolve the layout of elements after they are created pub(crate) fn create_mounted_events( vdom: &VirtualDom, - events: &mut Vec<(ElementId, &'static str, Rc, bool)>, + events: &mut Vec<(ElementId, &'static str, Box, bool)>, mount_events: impl Iterator, ) { let query: Query = vdom @@ -42,11 +41,12 @@ pub(crate) fn create_mounted_events( query: query.clone(), id: node_id, }; - events.push((id, "mounted", Rc::new(MountedData::new(element)), false)); + events.push((id, "mounted", Box::new(MountedData::new(element)), false)); } } -struct TuiElement { +#[derive(Clone)] +pub(crate) struct TuiElement { query: Query, id: NodeId, } diff --git a/packages/dioxus-tui/src/events.rs b/packages/dioxus-tui/src/events.rs new file mode 100644 index 000000000..3e7b6fd2a --- /dev/null +++ b/packages/dioxus-tui/src/events.rs @@ -0,0 +1,108 @@ +use core::panic; + +use dioxus_html::*; + +use crate::element::TuiElement; + +fn downcast(event: &PlatformEventData) -> plasmo::EventData { + event + .downcast::() + .expect("event should be of type EventData") + .clone() +} + +pub(crate) struct SerializedHtmlEventConverter; + +impl HtmlEventConverter for SerializedHtmlEventConverter { + fn convert_animation_data(&self, _: &PlatformEventData) -> AnimationData { + panic!("animation events not supported") + } + + fn convert_clipboard_data(&self, _: &PlatformEventData) -> ClipboardData { + panic!("clipboard events not supported") + } + + fn convert_composition_data(&self, _: &PlatformEventData) -> CompositionData { + panic!("composition events not supported") + } + + fn convert_drag_data(&self, _: &PlatformEventData) -> DragData { + panic!("drag events not supported") + } + + fn convert_focus_data(&self, event: &PlatformEventData) -> FocusData { + if let plasmo::EventData::Focus(event) = downcast(event) { + FocusData::new(event) + } else { + panic!("event should be of type Focus") + } + } + + fn convert_form_data(&self, event: &PlatformEventData) -> FormData { + if let plasmo::EventData::Form(event) = downcast(event) { + FormData::new(event) + } else { + panic!("event should be of type Form") + } + } + + fn convert_image_data(&self, _: &PlatformEventData) -> ImageData { + panic!("image events not supported") + } + + fn convert_keyboard_data(&self, event: &PlatformEventData) -> KeyboardData { + if let plasmo::EventData::Keyboard(event) = downcast(event) { + KeyboardData::new(event) + } else { + panic!("event should be of type Keyboard") + } + } + + fn convert_media_data(&self, _: &PlatformEventData) -> MediaData { + panic!("media events not supported") + } + + fn convert_mounted_data(&self, event: &PlatformEventData) -> MountedData { + event.downcast::().cloned().unwrap().into() + } + + fn convert_mouse_data(&self, event: &PlatformEventData) -> MouseData { + if let plasmo::EventData::Mouse(event) = downcast(event) { + MouseData::new(event) + } else { + panic!("event should be of type Mouse") + } + } + + fn convert_pointer_data(&self, _: &PlatformEventData) -> PointerData { + panic!("pointer events not supported") + } + + fn convert_scroll_data(&self, _: &PlatformEventData) -> ScrollData { + panic!("scroll events not supported") + } + + fn convert_selection_data(&self, _: &PlatformEventData) -> SelectionData { + panic!("selection events not supported") + } + + fn convert_toggle_data(&self, _: &PlatformEventData) -> ToggleData { + panic!("toggle events not supported") + } + + fn convert_touch_data(&self, _: &PlatformEventData) -> TouchData { + panic!("touch events not supported") + } + + fn convert_transition_data(&self, _: &PlatformEventData) -> TransitionData { + panic!("transition events not supported") + } + + fn convert_wheel_data(&self, event: &PlatformEventData) -> WheelData { + if let plasmo::EventData::Wheel(event) = downcast(event) { + WheelData::new(event) + } else { + panic!("event should be of type Wheel") + } + } +} diff --git a/packages/dioxus-tui/src/lib.rs b/packages/dioxus-tui/src/lib.rs index fd5b63501..6fafa47ef 100644 --- a/packages/dioxus-tui/src/lib.rs +++ b/packages/dioxus-tui/src/lib.rs @@ -1,4 +1,5 @@ mod element; +mod events; use std::{ any::Any, @@ -8,6 +9,7 @@ use std::{ }; use dioxus_core::{Component, ElementId, VirtualDom}; +use dioxus_html::PlatformEventData; use dioxus_native_core::dioxus::{DioxusState, NodeImmutableDioxusExt}; use dioxus_native_core::prelude::*; @@ -24,6 +26,8 @@ pub fn launch_cfg(app: Component<()>, cfg: Config) { } pub fn launch_cfg_with_props(app: Component, props: Props, cfg: Config) { + dioxus_html::set_event_converter(Box::new(events::SerializedHtmlEventConverter)); + render(cfg, |rdom, taffy, event_tx| { let dioxus_state = { let mut rdom = rdom.write().unwrap(); @@ -81,7 +85,7 @@ struct DioxusRenderer { vdom: VirtualDom, dioxus_state: Rc>, // Events that are queued up to be sent to the vdom next time the vdom is polled - queued_events: Vec<(ElementId, &'static str, Rc, bool)>, + queued_events: Vec<(ElementId, &'static str, Box, bool)>, #[cfg(all(feature = "hot-reload", debug_assertions))] hot_reload_rx: tokio::sync::mpsc::UnboundedReceiver, } @@ -122,15 +126,19 @@ impl Driver for DioxusRenderer { let id = { rdom.read().unwrap().get(id).unwrap().mounted_id() }; if let Some(id) = id { let inner_value = value.deref().clone(); + let boxed_event = Box::new(inner_value); + let platform_event = PlatformEventData::new(boxed_event); self.vdom - .handle_event(event, inner_value.into_any(), id, bubbles); + .handle_event(event, Rc::new(platform_event), id, bubbles); } } fn poll_async(&mut self) -> std::pin::Pin + '_>> { // Add any queued events for (id, event, value, bubbles) in self.queued_events.drain(..) { - self.vdom.handle_event(event, value, id, bubbles); + let platform_event = PlatformEventData::new(value); + self.vdom + .handle_event(event, Rc::new(platform_event), id, bubbles); } #[cfg(all(feature = "hot-reload", debug_assertions))] diff --git a/packages/html/src/events/animation.rs b/packages/html/src/events/animation.rs index 02612bc77..26db06f9d 100644 --- a/packages/html/src/events/animation.rs +++ b/packages/html/src/events/animation.rs @@ -7,18 +7,29 @@ pub struct AnimationData { } impl AnimationData { + /// Create a new AnimationData + pub fn new(inner: impl HasAnimationData + 'static) -> Self { + Self { + inner: Box::new(inner), + } + } + + /// The name of the animation pub fn animation_name(&self) -> String { self.inner.animation_name() } + /// The name of the pseudo-element the animation runs on pub fn pseudo_element(&self) -> String { self.inner.pseudo_element() } + /// The amount of time the animation has been running pub fn elapsed_time(&self) -> f32 { self.inner.elapsed_time() } + /// Downcast this event to a concrete event type pub fn downcast(&self) -> Option<&T> { self.inner.as_ref().as_any().downcast_ref::() } diff --git a/packages/html/src/events/clipboard.rs b/packages/html/src/events/clipboard.rs index 0469c4f1c..c0180c728 100644 --- a/packages/html/src/events/clipboard.rs +++ b/packages/html/src/events/clipboard.rs @@ -25,12 +25,14 @@ impl PartialEq for ClipboardData { } impl ClipboardData { + /// Create a new ClipboardData pub fn new(inner: impl HasClipboardData) -> Self { Self { inner: Box::new(inner), } } + /// Downcast this event to a concrete event type pub fn downcast(&self) -> Option<&T> { self.inner.as_ref().as_any().downcast_ref::() } diff --git a/packages/html/src/events/composition.rs b/packages/html/src/events/composition.rs index 18ef4f5d1..4d161436e 100644 --- a/packages/html/src/events/composition.rs +++ b/packages/html/src/events/composition.rs @@ -27,6 +27,14 @@ impl PartialEq for CompositionData { } impl CompositionData { + /// Create a new CompositionData + pub fn new(inner: impl HasCompositionData + 'static) -> Self { + Self { + inner: Box::new(inner), + } + } + + /// The characters generated by the input method that raised the event pub fn data(&self) -> String { self.inner.data() } diff --git a/packages/html/src/events/drag.rs b/packages/html/src/events/drag.rs index 67da07721..3ebd5fdbe 100644 --- a/packages/html/src/events/drag.rs +++ b/packages/html/src/events/drag.rs @@ -44,6 +44,13 @@ impl PartialEq for DragData { } impl DragData { + /// Create a new DragData + pub fn new(inner: impl HasDragData + 'static) -> Self { + Self { + inner: Box::new(inner), + } + } + /// Downcast this event data to a specific type pub fn downcast(&self) -> Option<&T> { self.inner.as_any().downcast_ref::() diff --git a/packages/html/src/events/focus.rs b/packages/html/src/events/focus.rs index f96c1eaee..f121feb7b 100644 --- a/packages/html/src/events/focus.rs +++ b/packages/html/src/events/focus.rs @@ -25,6 +25,13 @@ impl PartialEq for FocusData { } impl FocusData { + /// Create a new FocusData + pub fn new(inner: impl HasFocusData + 'static) -> Self { + Self { + inner: Box::new(inner), + } + } + /// Downcast this event data to a specific type pub fn downcast(&self) -> Option<&T> { self.inner.as_any().downcast_ref::() diff --git a/packages/html/src/events/keyboard.rs b/packages/html/src/events/keyboard.rs index c4c6115c1..a762f7ee9 100644 --- a/packages/html/src/events/keyboard.rs +++ b/packages/html/src/events/keyboard.rs @@ -46,6 +46,13 @@ impl PartialEq for KeyboardData { } impl KeyboardData { + /// Create a new KeyboardData + pub fn new(inner: impl HasKeyboardData + 'static) -> Self { + Self { + inner: Box::new(inner), + } + } + /// The value of the key pressed by the user, taking into consideration the state of modifier keys such as Shift as well as the keyboard locale and layout. pub fn key(&self) -> Key { self.inner.key() diff --git a/packages/html/src/events/media.rs b/packages/html/src/events/media.rs index 1abcab21d..7f3180cf7 100644 --- a/packages/html/src/events/media.rs +++ b/packages/html/src/events/media.rs @@ -24,6 +24,13 @@ impl PartialEq for MediaData { } impl MediaData { + /// Create a new MediaData + pub fn new(inner: impl HasMediaData + 'static) -> Self { + Self { + inner: Box::new(inner), + } + } + /// Downcast this event to a concrete event type pub fn downcast(&self) -> Option<&T> { self.inner.as_any().downcast_ref::() diff --git a/packages/html/src/events/scroll.rs b/packages/html/src/events/scroll.rs index 4655afbcc..3693cc144 100644 --- a/packages/html/src/events/scroll.rs +++ b/packages/html/src/events/scroll.rs @@ -13,6 +13,13 @@ impl From for ScrollData { } impl ScrollData { + /// Create a new ScrollData + pub fn new(inner: impl HasScrollData + 'static) -> Self { + Self { + inner: Box::new(inner), + } + } + /// Downcast this event to a concrete event type pub fn downcast(&self) -> Option<&T> { self.inner.as_any().downcast_ref::() diff --git a/packages/html/src/events/selection.rs b/packages/html/src/events/selection.rs index de10b06c4..30c3d9bf0 100644 --- a/packages/html/src/events/selection.rs +++ b/packages/html/src/events/selection.rs @@ -7,6 +7,13 @@ pub struct SelectionData { } impl SelectionData { + /// Create a new SelectionData + pub fn new(inner: impl HasSelectionData + 'static) -> Self { + Self { + inner: Box::new(inner), + } + } + /// Downcast this event to a concrete event type pub fn downcast(&self) -> Option<&T> { self.inner.as_any().downcast_ref::() diff --git a/packages/html/src/events/toggle.rs b/packages/html/src/events/toggle.rs index 7de8be36d..e929a6a64 100644 --- a/packages/html/src/events/toggle.rs +++ b/packages/html/src/events/toggle.rs @@ -25,6 +25,13 @@ impl PartialEq for ToggleData { } impl ToggleData { + /// Create a new ToggleData + pub fn new(inner: impl HasToggleData + 'static) -> Self { + Self { + inner: Box::new(inner), + } + } + /// Downcast this event to a concrete event type pub fn downcast(&self) -> Option<&T> { self.inner.as_any().downcast_ref::() diff --git a/packages/html/src/events/touch.rs b/packages/html/src/events/touch.rs index 7e9009ab6..12d8a5de1 100644 --- a/packages/html/src/events/touch.rs +++ b/packages/html/src/events/touch.rs @@ -32,6 +32,13 @@ impl PartialEq for TouchData { } impl TouchData { + /// Create a new TouchData + pub fn new(inner: impl HasTouchData + 'static) -> Self { + Self { + inner: Box::new(inner), + } + } + /// Returns true if the "ALT" key was down when the touch event was fired. pub fn alt_key(&self) -> bool { self.inner.alt_key() diff --git a/packages/html/src/events/transition.rs b/packages/html/src/events/transition.rs index c6dc65ae1..4e680d650 100644 --- a/packages/html/src/events/transition.rs +++ b/packages/html/src/events/transition.rs @@ -31,6 +31,13 @@ impl PartialEq for TransitionData { } impl TransitionData { + /// Create a new TransitionData + pub fn new(inner: impl HasTransitionData + 'static) -> Self { + Self { + inner: Box::new(inner), + } + } + /// Downcast this event to a concrete event type pub fn downcast(&self) -> Option<&T> { self.inner.as_any().downcast_ref::() diff --git a/packages/html/src/events/wheel.rs b/packages/html/src/events/wheel.rs index 157a8dc06..2661eee2b 100644 --- a/packages/html/src/events/wheel.rs +++ b/packages/html/src/events/wheel.rs @@ -30,6 +30,13 @@ impl PartialEq for WheelData { } impl WheelData { + /// Create a new WheelData + pub fn new(inner: impl HasWheelData + 'static) -> Self { + Self { + inner: Box::new(inner), + } + } + /// The amount of wheel movement #[allow(deprecated)] pub fn delta(&self) -> WheelDelta { diff --git a/packages/rink/examples/widgets.rs b/packages/rink/examples/widgets.rs index e1f71fe42..42dc3723d 100644 --- a/packages/rink/examples/widgets.rs +++ b/packages/rink/examples/widgets.rs @@ -1,3 +1,4 @@ +use dioxus_html::HasFormData; use dioxus_native_core::{ prelude::*, real_dom::{NodeImmutable, NodeTypeMut}, @@ -79,7 +80,7 @@ impl Driver for Counter { if event_type == "input" { // when the button is clicked, increment the counter if let EventData::Form(input_event) = &*event { - if let Ok(value) = input_event.value.parse::() { + if let Ok(value) = input_event.value().parse::() { self.count = value; } } diff --git a/packages/rink/src/hooks.rs b/packages/rink/src/hooks.rs index 646ae52df..c5378bfbf 100644 --- a/packages/rink/src/hooks.rs +++ b/packages/rink/src/hooks.rs @@ -57,18 +57,18 @@ impl EventData { EventData::Keyboard(k) => Rc::new(k), EventData::Focus(f) => Rc::new(f), EventData::Wheel(w) => Rc::new(w), - EventData::Form(f) => Rc::new(f.into_html()), + EventData::Form(f) => Rc::new(f), } } } #[derive(Clone, Debug, PartialEq)] pub struct FormData { - pub value: String, + pub(crate) value: String, - pub values: HashMap>, + pub(crate) values: HashMap>, - pub files: Option, + pub(crate) files: Option, } impl HasFormData for FormData { @@ -85,12 +85,6 @@ impl HasFormData for FormData { } } -impl FormData { - fn into_html(self) -> dioxus_html::FormData { - dioxus_html::FormData::new(self) - } -} - #[derive(Clone, Debug, PartialEq)] pub struct Files { files: FxHashMap, From 992ac4a3fb550b88c25d6a242f70fe8f40aac4d4 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Wed, 6 Sep 2023 16:12:01 -0500 Subject: [PATCH 083/447] clear borrowed props after ensure_drop_safety --- packages/core/src/arena.rs | 11 +++++++---- packages/core/src/create.rs | 8 ++++---- packages/core/src/diff.rs | 4 ++-- packages/core/src/virtual_dom.rs | 10 +++++++--- 4 files changed, 20 insertions(+), 13 deletions(-) diff --git a/packages/core/src/arena.rs b/packages/core/src/arena.rs index 5fb5fa6cb..6430934f5 100644 --- a/packages/core/src/arena.rs +++ b/packages/core/src/arena.rs @@ -2,6 +2,7 @@ use crate::{ innerlude::DirtyScope, nodes::RenderReturn, nodes::VNode, virtual_dom::VirtualDom, AttributeValue, DynamicNode, ScopeId, }; +use std::ptr::NonNull; /// An Element's unique identifier. /// @@ -13,8 +14,8 @@ pub struct ElementId(pub usize); /// An Element that can be bubbled to's unique identifier. /// -/// `ElementId` is a `usize` that is unique across the entire VirtualDOM - but not unique across time. If a component is -/// unmounted, then the `ElementId` will be reused for a new component. +/// `BubbleId` is a `usize` that is unique across the entire VirtualDOM - but not unique across time. If a component is +/// unmounted, then the `BubbleId` will be reused for a new component. #[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] #[derive(Clone, Copy, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Default)] pub struct BubbleId(pub usize); @@ -25,7 +26,7 @@ pub struct ElementRef<'a> { pub(crate) path: ElementPath, // The actual template - pub(crate) template: Option<*const VNode<'a>>, + pub(crate) template: Option>>, // The scope the element belongs to pub(crate) scope: ScopeId, @@ -182,9 +183,11 @@ impl VirtualDom { *props = None; } } + let scope = &self.scopes[scope_id.0]; + scope.borrowed_props.borrow_mut().clear(); // Now that all the references are gone, we can safely drop our own references in our listeners. - let mut listeners = self.scopes[scope_id.0].attributes_to_drop.borrow_mut(); + let mut listeners = scope.attributes_to_drop.borrow_mut(); listeners.drain(..).for_each(|listener| { let listener = unsafe { &*listener }; match &listener.value { diff --git a/packages/core/src/create.rs b/packages/core/src/create.rs index 759ee97d9..44b344380 100644 --- a/packages/core/src/create.rs +++ b/packages/core/src/create.rs @@ -187,7 +187,7 @@ impl<'b> VirtualDom { path: ElementPath { path: &template.template.get().node_paths[idx], }, - template: Some(template), + template: Some(template.into()), scope: self.runtime.current_scope_id().unwrap_or(ScopeId(0)), }; self.create_dynamic_node(template_ref, node) @@ -197,7 +197,7 @@ impl<'b> VirtualDom { path: ElementPath { path: &template.template.get().node_paths[idx], }, - template: Some(template), + template: Some(template.into()), scope: self.runtime.current_scope_id().unwrap_or(ScopeId(0)), }; parent.set(Some(self.next_element_ref(template_ref))); @@ -286,7 +286,7 @@ impl<'b> VirtualDom { path: ElementPath { path: &template.template.get().node_paths[idx], }, - template: Some(template), + template: Some(template.into()), scope: self.runtime.current_scope_id().unwrap_or(ScopeId(0)), }; let m = self.create_dynamic_node(boundary_ref, &template.dynamic_nodes[idx]); @@ -340,7 +340,7 @@ impl<'b> VirtualDom { let path = &template.template.get().attr_paths[idx]; let element_ref = ElementRef { path: ElementPath { path }, - template: Some(template), + template: Some(template.into()), scope: self.runtime.current_scope_id().unwrap_or(ScopeId(0)), }; self.set_template(id, element_ref); diff --git a/packages/core/src/diff.rs b/packages/core/src/diff.rs index edaa0048e..cbff0621e 100644 --- a/packages/core/src/diff.rs +++ b/packages/core/src/diff.rs @@ -144,7 +144,7 @@ impl<'b> VirtualDom { .enumerate() .for_each(|(dyn_node_idx, (left_node, right_node))| { let current_ref = ElementRef { - template: Some(right_template), + template: Some(right_template.into()), path: ElementPath { path: left_template.template.get().node_paths[dyn_node_idx], }, @@ -176,7 +176,7 @@ impl<'b> VirtualDom { right.id.set(left.id.get()); right.parent.set(left.parent.get()); // Update the template - self.update_template(left.id.get().unwrap(), parent.template.unwrap()); + self.update_template(left.id.get().unwrap(), parent.template.unwrap().as_ptr()); }, (Component(left), Component(right)) => self.diff_vcomponent(left, right, Some(parent)), (Placeholder(left), Fragment(right)) => self.replace_placeholder(left, *right, parent), diff --git a/packages/core/src/virtual_dom.rs b/packages/core/src/virtual_dom.rs index eedfd6b9b..6601f2793 100644 --- a/packages/core/src/virtual_dom.rs +++ b/packages/core/src/virtual_dom.rs @@ -371,8 +371,12 @@ impl VirtualDom { // Loop through each dynamic attribute (in a depth first order) in this template before moving up to the template's parent. while let Some(el_ref) = parent_path { // safety: we maintain references of all vnodes in the element slab - let template = - unsafe { &*el_ref.template.expect("template reference should be valid") }; + let template = unsafe { + el_ref + .template + .expect("template reference should be valid") + .as_ref() + }; let node_template = template.template.get(); let target_path = el_ref.path; @@ -422,7 +426,7 @@ impl VirtualDom { // Otherwise, we just call the listener on the target element if let Some(el_ref) = parent_path { // safety: we maintain references of all vnodes in the element slab - let template = unsafe { &*el_ref.template.unwrap() }; + let template = unsafe { el_ref.template.unwrap().as_ref() }; let node_template = template.template.get(); let target_path = el_ref.path; From 3a02520ffac43f5743f0ec3bde51debe75ae63f1 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Fri, 8 Sep 2023 10:32:48 -0500 Subject: [PATCH 084/447] fix web onmount event --- packages/web/src/dom.rs | 3 +-- packages/web/src/event.rs | 14 +++++++++----- 2 files changed, 10 insertions(+), 7 deletions(-) diff --git a/packages/web/src/dom.rs b/packages/web/src/dom.rs index 9799b50be..9cdabed3f 100644 --- a/packages/web/src/dom.rs +++ b/packages/web/src/dom.rs @@ -253,8 +253,7 @@ impl WebsysDom { let node = dioxus_interpreter_js::get_node(id.0 as u32); if let Some(element) = node.dyn_ref::() { log::info!("mounted event fired: {}", id.0); - let data: dioxus_html::MountedData = element.into(); - let data = PlatformEventData::new(Box::new(data)); + let data = PlatformEventData::new(Box::new(element.clone())); let _ = self.event_channel.unbounded_send(UiEvent { name: "mounted".to_string(), bubbles: false, diff --git a/packages/web/src/event.rs b/packages/web/src/event.rs index e9d6e4afb..d1eed67a6 100644 --- a/packages/web/src/event.rs +++ b/packages/web/src/event.rs @@ -83,7 +83,11 @@ impl HtmlEventConverter for WebEventConverter { fn convert_mounted_data(&self, event: &dioxus_html::PlatformEventData) -> MountedData { #[cfg(feature = "mounted")] { - MountedData::from(downcast_event(event).element.clone()) + MountedData::from( + event + .downcast::() + .expect("event should be a web_sys::Element"), + ) } #[cfg(not(feature = "mounted"))] { @@ -216,10 +220,10 @@ impl WebEventExt for dioxus_html::MediaData { } } -impl WebEventExt for MountedData { - fn web_event(&self) -> &MountedData { - self.downcast::() - .expect("event should be a WebMountedEvent") +impl WebEventExt for MountedData { + fn web_event(&self) -> &web_sys::Element { + self.downcast::() + .expect("event should be a web_sys::Element") } } From 35b643e23fcf6a67faaef4ec3d8deaead3525100 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Mon, 11 Sep 2023 15:55:58 -0500 Subject: [PATCH 085/447] switch to bubble ids on vnodes to fix nodes under fragments pointing to an invalid parent --- packages/core/src/arena.rs | 53 ++++++------------ packages/core/src/create.rs | 39 ++++++-------- packages/core/src/diff.rs | 92 ++++++++++---------------------- packages/core/src/fragment.rs | 1 + packages/core/src/nodes.rs | 38 ++++++++++--- packages/core/src/scopes.rs | 7 ++- packages/core/src/virtual_dom.rs | 53 +++++++++--------- packages/core/tests/fuzzing.rs | 50 ++++++++--------- packages/rsx/src/lib.rs | 15 +++--- 9 files changed, 159 insertions(+), 189 deletions(-) diff --git a/packages/core/src/arena.rs b/packages/core/src/arena.rs index 6430934f5..5dd8dbf67 100644 --- a/packages/core/src/arena.rs +++ b/packages/core/src/arena.rs @@ -1,8 +1,9 @@ +use std::ptr::NonNull; + use crate::{ innerlude::DirtyScope, nodes::RenderReturn, nodes::VNode, virtual_dom::VirtualDom, AttributeValue, DynamicNode, ScopeId, }; -use std::ptr::NonNull; /// An Element's unique identifier. /// @@ -18,15 +19,15 @@ pub struct ElementId(pub usize); /// unmounted, then the `BubbleId` will be reused for a new component. #[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] #[derive(Clone, Copy, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Default)] -pub struct BubbleId(pub usize); +pub struct VNodeId(pub usize); #[derive(Debug, Clone, Copy)] -pub struct ElementRef<'a> { +pub struct ElementRef { // the pathway of the real element inside the template pub(crate) path: ElementPath, // The actual template - pub(crate) template: Option>>, + pub(crate) template: VNodeId, // The scope the element belongs to pub(crate) scope: ScopeId, @@ -42,11 +43,12 @@ impl VirtualDom { ElementId(self.elements.insert(None)) } - pub(crate) fn next_element_ref(&mut self, element_ref: ElementRef) -> BubbleId { - let new_id = BubbleId( - self.element_refs - .insert(unsafe { std::mem::transmute(element_ref) }), - ); + pub(crate) fn next_vnode_ref(&mut self, vnode: &VNode) -> VNodeId { + let new_id = VNodeId(self.element_refs.insert(Some(unsafe { + std::mem::transmute::, _>(vnode.into()) + }))); + + println!("next_element_ref: {:?}", new_id); // Set this id to be dropped when the scope is rerun if let Some(scope) = self.runtime.current_scope_id() { @@ -72,30 +74,12 @@ impl VirtualDom { ); } - self.elements.try_remove(el.0).and_then(|id| match id { - Some(id) => self.element_refs.try_remove(id.0).map(|_| ()), - None => Some(()), - }) + self.elements.try_remove(el.0).map(|_| ()) } - pub(crate) fn set_template(&mut self, el: ElementId, element_ref: ElementRef) { - match self.elements[el.0] { - Some(bubble_id) => { - self.element_refs[bubble_id.0] = unsafe { std::mem::transmute(element_ref) }; - } - None => { - self.elements[el.0] = Some(self.next_element_ref(element_ref)); - } - } - } - - pub(crate) fn update_template(&mut self, el: ElementId, node: *const VNode) { - let bubble_id = self.elements[el.0].unwrap(); - self.update_template_bubble(bubble_id, node) - } - - pub(crate) fn update_template_bubble(&mut self, bubble_id: BubbleId, node: *const VNode) { - self.element_refs[bubble_id.0].template = Some(unsafe { std::mem::transmute(node) }); + pub(crate) fn set_template(&mut self, id: VNodeId, vnode: &VNode) { + self.element_refs[id.0] = + Some(unsafe { std::mem::transmute::, _>(vnode.into()) }); } // Drop a scope and all its children @@ -141,9 +125,6 @@ impl VirtualDom { self.drop_scope(f, true); } c.props.take(); - if let Some(bubble_id) = c.bubble_id.get() { - self.element_refs.try_remove(bubble_id.0); - } } DynamicNode::Fragment(nodes) => { nodes.iter().for_each(|node| self.drop_scope_inner(node)) @@ -162,9 +143,9 @@ impl VirtualDom { let mut element_refs = self.scopes[scope_id.0].element_refs_to_drop.borrow_mut(); let element_refs_slab = &mut self.element_refs; for element_ref in element_refs.drain(..) { - println!("Dropping element ref {:?}", element_ref); + println!("ensure_drop_safety: {:?}", element_ref); if let Some(element_ref) = element_refs_slab.get_mut(element_ref.0) { - element_ref.template = None; + *element_ref = None; } } } diff --git a/packages/core/src/create.rs b/packages/core/src/create.rs index 44b344380..7db744cf5 100644 --- a/packages/core/src/create.rs +++ b/packages/core/src/create.rs @@ -96,6 +96,9 @@ impl<'b> VirtualDom { nodes_mut.resize(len, ElementId::default()); }; + // Set this node id + node.stable_id.set(Some(self.next_vnode_ref(node))); + // The best renderers will have templates prehydrated and registered // Just in case, let's create the template using instructions anyways self.register_template(node.template.get()); @@ -187,7 +190,7 @@ impl<'b> VirtualDom { path: ElementPath { path: &template.template.get().node_paths[idx], }, - template: Some(template.into()), + template: template.stable_id().unwrap(), scope: self.runtime.current_scope_id().unwrap_or(ScopeId(0)), }; self.create_dynamic_node(template_ref, node) @@ -197,10 +200,10 @@ impl<'b> VirtualDom { path: ElementPath { path: &template.template.get().node_paths[idx], }, - template: Some(template.into()), + template: template.stable_id().unwrap(), scope: self.runtime.current_scope_id().unwrap_or(ScopeId(0)), }; - parent.set(Some(self.next_element_ref(template_ref))); + parent.set(Some(template_ref)); let id = self.set_slot(id); self.mutations.push(CreatePlaceholder { id }); 1 @@ -286,7 +289,7 @@ impl<'b> VirtualDom { path: ElementPath { path: &template.template.get().node_paths[idx], }, - template: Some(template.into()), + template: template.stable_id().unwrap(), scope: self.runtime.current_scope_id().unwrap_or(ScopeId(0)), }; let m = self.create_dynamic_node(boundary_ref, &template.dynamic_nodes[idx]); @@ -340,10 +343,10 @@ impl<'b> VirtualDom { let path = &template.template.get().attr_paths[idx]; let element_ref = ElementRef { path: ElementPath { path }, - template: Some(template.into()), + template: template.stable_id().unwrap(), scope: self.runtime.current_scope_id().unwrap_or(ScopeId(0)), }; - self.set_template(id, element_ref); + self.elements[id.0] = Some(element_ref); self.mutations.push(NewEventListener { // all listeners start with "on" name: &unbounded_name[2..], @@ -474,7 +477,7 @@ impl<'b> VirtualDom { pub(crate) fn create_dynamic_node( &mut self, - parent: ElementRef<'b>, + parent: ElementRef, node: &'b DynamicNode<'b>, ) -> usize { use DynamicNode::*; @@ -486,7 +489,7 @@ impl<'b> VirtualDom { } } - fn create_dynamic_text(&mut self, parent: ElementRef<'b>, text: &'b VText<'b>) -> usize { + fn create_dynamic_text(&mut self, parent: ElementRef, text: &'b VText<'b>) -> usize { // Allocate a dynamic element reference for this text node let new_id = self.next_element(); @@ -510,7 +513,7 @@ impl<'b> VirtualDom { pub(crate) fn create_placeholder( &mut self, placeholder: &VPlaceholder, - parent: ElementRef<'b>, + parent: ElementRef, ) -> usize { // Allocate a dynamic element reference for this text node let id = self.next_element(); @@ -519,7 +522,7 @@ impl<'b> VirtualDom { placeholder.id.set(Some(id)); // Assign the placeholder's parent - placeholder.parent.set(Some(self.next_element_ref(parent))); + placeholder.parent.set(Some(parent)); // Assign the ID to the existing node in the template self.mutations.push(AssignId { @@ -533,7 +536,7 @@ impl<'b> VirtualDom { pub(super) fn create_component_node( &mut self, - parent: Option>, + parent: Option, component: &'b VComponent<'b>, ) -> usize { use RenderReturn::*; @@ -546,10 +549,8 @@ impl<'b> VirtualDom { match unsafe { self.run_scope(scope).extend_lifetime_ref() } { // Create the component's root element Ready(t) => { - let created = self.create_scope(scope, t); self.assign_boundary_ref(parent, t); - component.bubble_id.set(t.parent.get()); - created + self.create_scope(scope, t) } Aborted(t) => self.mount_aborted(t, parent), } @@ -567,17 +568,11 @@ impl<'b> VirtualDom { .unwrap_or_else(|| component.scope.get().unwrap()) } - fn mount_aborted( - &mut self, - placeholder: &VPlaceholder, - parent: Option>, - ) -> usize { + fn mount_aborted(&mut self, placeholder: &VPlaceholder, parent: Option) -> usize { let id = self.next_element(); self.mutations.push(Mutation::CreatePlaceholder { id }); placeholder.id.set(Some(id)); - placeholder - .parent - .set(parent.map(|parent| self.next_element_ref(parent))); + placeholder.parent.set(parent); 1 } diff --git a/packages/core/src/diff.rs b/packages/core/src/diff.rs index cbff0621e..20358cfce 100644 --- a/packages/core/src/diff.rs +++ b/packages/core/src/diff.rs @@ -10,7 +10,7 @@ use crate::{ nodes::{DynamicNode, VNode}, scopes::ScopeId, virtual_dom::VirtualDom, - Attribute, AttributeValue, TemplateNode, + Attribute, TemplateNode, }; use rustc_hash::{FxHashMap, FxHashSet}; @@ -52,7 +52,7 @@ impl<'b> VirtualDom { (Aborted(l), Ready(r)) => self.replace_placeholder( l, [r], - self.element_refs[l.parent.get().expect("root should not be none").0], + l.parent.get().expect("root node should not be none"), ), }; } @@ -92,9 +92,7 @@ impl<'b> VirtualDom { if let Some(&template) = map.get(&byte_index) { right_template.template.set(template); if template != left_template.template.get() { - let parent = left_template.parent.take().map(|parent_id| unsafe { - std::mem::transmute(self.element_refs[parent_id.0]) - }); + let parent = left_template.parent.take(); return self.replace(left_template, [right_template], parent); } } @@ -106,6 +104,12 @@ impl<'b> VirtualDom { right_template.parent.set(left_template.parent.get()); } + // Update the bubble id pointer + right_template.stable_id.set(left_template.stable_id.get()); + if let Some(bubble_id) = right_template.stable_id.get() { + self.set_template(bubble_id, right_template); + } + // If the templates are the same, we don't need to do anything, nor do we want to if templates_are_the_same(left_template, right_template) { return; @@ -128,10 +132,7 @@ impl<'b> VirtualDom { right_attr.mounted_element.set(mounted_element); // If the attributes are different (or volatile), we need to update them - if let AttributeValue::Listener(_) = left_attr.value { - // Nodes with Listeners always need their pointers updated - self.update_template(mounted_element, right_template); - } else if left_attr.value != right_attr.value || left_attr.volatile { + if left_attr.value != right_attr.value || left_attr.volatile { self.update_attribute(right_attr, left_attr); } }); @@ -144,7 +145,7 @@ impl<'b> VirtualDom { .enumerate() .for_each(|(dyn_node_idx, (left_node, right_node))| { let current_ref = ElementRef { - template: Some(right_template.into()), + template: right_template.stable_id().unwrap(), path: ElementPath { path: left_template.template.get().node_paths[dyn_node_idx], }, @@ -167,7 +168,7 @@ impl<'b> VirtualDom { &mut self, left_node: &'b DynamicNode<'b>, right_node: &'b DynamicNode<'b>, - parent: ElementRef<'b>, + parent: ElementRef, ) { match (left_node, right_node) { (Text(left), Text(right)) => self.diff_vtext(left, right), @@ -175,8 +176,6 @@ impl<'b> VirtualDom { (Placeholder(left), Placeholder(right)) => { right.id.set(left.id.get()); right.parent.set(left.parent.get()); - // Update the template - self.update_template(left.id.get().unwrap(), parent.template.unwrap().as_ptr()); }, (Component(left), Component(right)) => self.diff_vcomponent(left, right, Some(parent)), (Placeholder(left), Fragment(right)) => self.replace_placeholder(left, *right, parent), @@ -201,7 +200,7 @@ impl<'b> VirtualDom { &mut self, left: &'b VComponent<'b>, right: &'b VComponent<'b>, - parent: Option>, + parent: Option, ) { if std::ptr::eq(left, right) { return; @@ -216,7 +215,6 @@ impl<'b> VirtualDom { let scope_id = left.scope.get().unwrap(); right.scope.set(Some(scope_id)); - right.bubble_id.set(left.bubble_id.get()); // copy out the box for both let old = self.scopes[scope_id.0].props.as_ref(); @@ -227,16 +225,6 @@ impl<'b> VirtualDom { // The target scopestate still has the reference to the old props, so there's no need to update anything // This also implicitly drops the new props since they're not used if left.static_props && unsafe { old.as_ref().unwrap().memoize(new.as_ref()) } { - if let Some(bubble_id) = right.bubble_id.get() { - if let RenderReturn::Ready(new_node) = unsafe { - self.scopes[scope_id.0] - .current_frame() - .try_load_node() - .expect("Call rebuild before diffing") - } { - self.update_template_bubble(bubble_id, new_node); - } - } return; } @@ -245,16 +233,6 @@ impl<'b> VirtualDom { // Now run the component and diff it self.run_scope(scope_id); - if let Some(bubble_id) = right.bubble_id.get() { - if let RenderReturn::Ready(new_node) = unsafe { - self.scopes[scope_id.0] - .current_frame() - .try_load_node() - .expect("Call rebuild before diffing") - } { - self.update_template_bubble(bubble_id, new_node); - } - } self.diff_scope(scope_id); self.dirty_scopes.remove(&DirtyScope { @@ -267,7 +245,7 @@ impl<'b> VirtualDom { &mut self, right: &'b VComponent<'b>, left: &'b VComponent<'b>, - parent: Option>, + parent: Option, ) { let m = self.create_component_node(parent, right); @@ -324,10 +302,7 @@ impl<'b> VirtualDom { /// } /// ``` fn light_diff_templates(&mut self, left: &'b VNode<'b>, right: &'b VNode<'b>) { - let parent = left - .parent - .take() - .map(|parent_id| unsafe { std::mem::transmute(self.element_refs[parent_id.0]) }); + let parent = left.parent.take(); match matching_components(left, right) { None => self.replace(left, [right], parent), Some(components) => components @@ -354,7 +329,7 @@ impl<'b> VirtualDom { &mut self, old: &'b [VNode<'b>], new: &'b [VNode<'b>], - parent: ElementRef<'b>, + parent: ElementRef, ) { let new_is_keyed = new[0].key.is_some(); let old_is_keyed = old[0].key.is_some(); @@ -386,7 +361,7 @@ impl<'b> VirtualDom { &mut self, old: &'b [VNode<'b>], new: &'b [VNode<'b>], - parent: ElementRef<'b>, + parent: ElementRef, ) { use std::cmp::Ordering; @@ -427,7 +402,7 @@ impl<'b> VirtualDom { &mut self, old: &'b [VNode<'b>], new: &'b [VNode<'b>], - parent: ElementRef<'b>, + parent: ElementRef, ) { if cfg!(debug_assertions) { let mut keys = rustc_hash::FxHashSet::default(); @@ -506,7 +481,7 @@ impl<'b> VirtualDom { &mut self, old: &'b [VNode<'b>], new: &'b [VNode<'b>], - parent: ElementRef<'b>, + parent: ElementRef, ) -> Option<(usize, usize)> { let mut left_offset = 0; @@ -565,7 +540,7 @@ impl<'b> VirtualDom { &mut self, old: &'b [VNode<'b>], new: &'b [VNode<'b>], - parent: ElementRef<'b>, + parent: ElementRef, ) { /* 1. Map the old keys into a numerical ordering based on indices. @@ -804,7 +779,7 @@ impl<'b> VirtualDom { fn create_children( &mut self, nodes: impl IntoIterator>, - parent: Option>, + parent: Option, ) -> usize { nodes.into_iter().fold(0, |acc, child| { self.assign_boundary_ref(parent, child); @@ -816,7 +791,7 @@ impl<'b> VirtualDom { &mut self, new: &'b [VNode<'b>], before: &'b VNode<'b>, - parent: ElementRef<'b>, + parent: ElementRef, ) { let m = self.create_children(new, Some(parent)); let id = self.find_first_element(before); @@ -827,7 +802,7 @@ impl<'b> VirtualDom { &mut self, new: &'b [VNode<'b>], after: &'b VNode<'b>, - parent: ElementRef<'b>, + parent: ElementRef, ) { let m = self.create_children(new, Some(parent)); let id = self.find_last_element(after); @@ -839,7 +814,7 @@ impl<'b> VirtualDom { &mut self, l: &'b VPlaceholder, r: impl IntoIterator>, - parent: ElementRef<'b>, + parent: ElementRef, ) { let m = self.create_children(r, Some(parent)); let id = l.id.get().unwrap(); @@ -851,7 +826,7 @@ impl<'b> VirtualDom { &mut self, left: &'b VNode<'b>, right: impl IntoIterator>, - parent: Option>, + parent: Option, ) { let m = self.create_children(right, parent); @@ -872,17 +847,12 @@ impl<'b> VirtualDom { }; } - fn node_to_placeholder( - &mut self, - l: &'b [VNode<'b>], - r: &'b VPlaceholder, - parent: ElementRef<'b>, - ) { + fn node_to_placeholder(&mut self, l: &'b [VNode<'b>], r: &'b VPlaceholder, parent: ElementRef) { // Create the placeholder first, ensuring we get a dedicated ID for the placeholder let placeholder = self.next_element(); r.id.set(Some(placeholder)); - r.parent.set(Some(self.next_element_ref(parent))); + r.parent.set(Some(parent)); self.mutations .push(Mutation::CreatePlaceholder { id: placeholder }); @@ -1079,14 +1049,10 @@ impl<'b> VirtualDom { } } - pub(crate) fn assign_boundary_ref( - &mut self, - parent: Option>, - child: &'b VNode<'b>, - ) { + pub(crate) fn assign_boundary_ref(&mut self, parent: Option, child: &'b VNode<'b>) { if let Some(parent) = parent { // assign the parent of the child - child.parent.set(Some(self.next_element_ref(parent))); + child.parent.set(Some(parent)); } } } diff --git a/packages/core/src/fragment.rs b/packages/core/src/fragment.rs index 0e4bf09e3..dbc8e8131 100644 --- a/packages/core/src/fragment.rs +++ b/packages/core/src/fragment.rs @@ -31,6 +31,7 @@ pub fn Fragment<'a>(cx: Scope<'a, FragmentProps<'a>>) -> Element { Some(VNode { key: children.key, parent: children.parent.clone(), + stable_id: children.stable_id.clone(), template: children.template.clone(), root_ids: children.root_ids.clone(), dynamic_nodes: children.dynamic_nodes, diff --git a/packages/core/src/nodes.rs b/packages/core/src/nodes.rs index f3a27eecf..c0b1a382a 100644 --- a/packages/core/src/nodes.rs +++ b/packages/core/src/nodes.rs @@ -1,4 +1,4 @@ -use crate::innerlude::BubbleId; +use crate::innerlude::{ElementRef, VNodeId}; use crate::{ any_props::AnyProps, arena::ElementId, Element, Event, LazyNodes, ScopeId, ScopeState, }; @@ -48,7 +48,10 @@ pub struct VNode<'a> { pub key: Option<&'a str>, /// When rendered, this template will be linked to its parent manually - pub parent: Cell>, + pub(crate) parent: Cell>, + + /// The bubble id assigned to the child that we need to update and drop when diffing happens + pub(crate) stable_id: Cell>, /// The static nodes and static descriptor of the template pub template: Cell>, @@ -70,6 +73,7 @@ impl<'a> VNode<'a> { Some(VNode { key: None, parent: Default::default(), + stable_id: Default::default(), root_ids: RefCell::new(bumpalo::collections::Vec::new_in(cx.bump())), dynamic_nodes: &[], dynamic_attrs: &[], @@ -82,6 +86,30 @@ impl<'a> VNode<'a> { }) } + /// Create a new VNode + pub fn new( + key: Option<&'a str>, + template: Template<'static>, + root_ids: bumpalo::collections::Vec<'a, ElementId>, + dynamic_nodes: &'a [DynamicNode<'a>], + dynamic_attrs: &'a [Attribute<'a>], + ) -> Self { + Self { + key, + parent: Cell::new(None), + stable_id: Cell::new(None), + template: Cell::new(template), + root_ids: RefCell::new(root_ids), + dynamic_nodes, + dynamic_attrs, + } + } + + /// Get the stable id of this node used for bubbling events + pub(crate) fn stable_id(&self) -> Option { + self.stable_id.get() + } + /// Load a dynamic root at the given index /// /// Returns [`None`] if the root is actually a static node (Element/Text) @@ -318,9 +346,6 @@ pub struct VComponent<'a> { /// The assigned Scope for this component pub(crate) scope: Cell>, - /// The bubble id assigned to the child that we need to update and drop when diffing happens - pub(crate) bubble_id: Cell>, - /// The function pointer of the component, known at compile time /// /// It is possible that components get folded at compile time, so these shouldn't be really used as a key @@ -377,7 +402,7 @@ pub struct VPlaceholder { /// The ID of this node in the real DOM pub(crate) id: Cell>, /// The parent of this node - pub(crate) parent: Cell>, + pub(crate) parent: Cell>, } impl VPlaceholder { @@ -729,6 +754,7 @@ impl<'a> IntoDynNode<'a> for &'a VNode<'a> { fn into_vnode(self, _cx: &'a ScopeState) -> DynamicNode<'a> { DynamicNode::Fragment(_cx.bump().alloc([VNode { parent: self.parent.clone(), + stable_id: self.stable_id.clone(), template: self.template.clone(), root_ids: self.root_ids.clone(), key: self.key, diff --git a/packages/core/src/scopes.rs b/packages/core/src/scopes.rs index 5cb066f41..95c06f6b3 100644 --- a/packages/core/src/scopes.rs +++ b/packages/core/src/scopes.rs @@ -2,8 +2,8 @@ use crate::{ any_props::AnyProps, any_props::VProps, bump_frame::BumpFrame, - innerlude::{BubbleId, ErrorBoundary}, - innerlude::{DynamicNode, EventHandler, VComponent, VText}, + innerlude::ErrorBoundary, + innerlude::{DynamicNode, EventHandler, VComponent, VNodeId, VText}, lazynodes::LazyNodes, nodes::{IntoAttributeValue, IntoDynNode, RenderReturn}, runtime::Runtime, @@ -95,7 +95,7 @@ pub struct ScopeState { pub(crate) borrowed_props: RefCell>>, pub(crate) attributes_to_drop: RefCell>>, - pub(crate) element_refs_to_drop: RefCell>, + pub(crate) element_refs_to_drop: RefCell>, pub(crate) props: Option>>, } @@ -456,7 +456,6 @@ impl<'src> ScopeState { render_fn: component as *const (), static_props: P::IS_STATIC, props: RefCell::new(Some(extended)), - bubble_id: Default::default(), scope: Default::default(), }) } diff --git a/packages/core/src/virtual_dom.rs b/packages/core/src/virtual_dom.rs index 6601f2793..60727cb42 100644 --- a/packages/core/src/virtual_dom.rs +++ b/packages/core/src/virtual_dom.rs @@ -4,19 +4,19 @@ use crate::{ any_props::VProps, - arena::{ElementId, ElementRef}, - innerlude::{BubbleId, DirtyScope, ErrorBoundary, Mutations, Scheduler, SchedulerMsg}, + arena::ElementId, + innerlude::{DirtyScope, ElementRef, ErrorBoundary, Mutations, Scheduler, SchedulerMsg}, mutations::Mutation, nodes::RenderReturn, nodes::{Template, TemplateId}, runtime::{Runtime, RuntimeGuard}, scopes::{ScopeId, ScopeState}, - AttributeValue, Element, Event, Scope, + AttributeValue, Element, Event, Scope, VNode, }; use futures_util::{pin_mut, StreamExt}; use rustc_hash::{FxHashMap, FxHashSet}; use slab::Slab; -use std::{any::Any, cell::Cell, collections::BTreeSet, future::Future, rc::Rc}; +use std::{any::Any, cell::Cell, collections::BTreeSet, future::Future, ptr::NonNull, rc::Rc}; /// A virtual node system that progresses user events and diffs UI trees. /// @@ -183,10 +183,10 @@ pub struct VirtualDom { pub(crate) templates: FxHashMap>>, // Every element is actually a dual reference - one to the template and the other to the dynamic node in that template - pub(crate) element_refs: Slab>, + pub(crate) element_refs: Slab>>>, // The element ids that are used in the renderer - pub(crate) elements: Slab>, + pub(crate) elements: Slab>, pub(crate) mutations: Mutations<'static>, @@ -353,11 +353,16 @@ impl VirtualDom { | | | <-- no, broke early | <-- no, broke early */ - let element = match self.elements.get(element.0) { + let parent_path = match self.elements.get(element.0) { Some(Some(el)) => el, _ => return, }; - let mut parent_path = self.element_refs.get(element.0).cloned(); + println!("handle_event: {:?}", element); + let mut parent_node = self + .element_refs + .get(parent_path.template.0) + .cloned() + .map(|el| (*parent_path, el)); let mut listeners = vec![]; // We will clone this later. The data itself is wrapped in RC to be used in callbacks if required @@ -369,16 +374,11 @@ impl VirtualDom { // If the event bubbles, we traverse through the tree until we find the target element. if bubbles { // Loop through each dynamic attribute (in a depth first order) in this template before moving up to the template's parent. - while let Some(el_ref) = parent_path { + while let Some((path, el_ref)) = parent_node { // safety: we maintain references of all vnodes in the element slab - let template = unsafe { - el_ref - .template - .expect("template reference should be valid") - .as_ref() - }; + let template = unsafe { el_ref.unwrap().as_ref() }; let node_template = template.template.get(); - let target_path = el_ref.path; + let target_path = path.path; for (idx, attr) in template.dynamic_attrs.iter().enumerate() { let this_path = node_template.attr_paths[idx]; @@ -402,7 +402,7 @@ impl VirtualDom { // We check the bubble state between each call to see if the event has been stopped from bubbling for listener in listeners.drain(..).rev() { if let AttributeValue::Listener(listener) = listener { - let origin = el_ref.scope; + let origin = path.scope; self.runtime.scope_stack.borrow_mut().push(origin); self.runtime.rendering.set(false); if let Some(cb) = listener.borrow_mut().as_deref_mut() { @@ -417,18 +417,21 @@ impl VirtualDom { } } - parent_path = template - .parent - .get() - .and_then(|id| self.element_refs.get(id.0).cloned()); + parent_node = template.parent.get().and_then(|element_ref| { + println!("handle_event: {:?}", element_ref); + self.element_refs + .get(element_ref.template.0) + .cloned() + .map(|el| (element_ref, el)) + }); } } else { // Otherwise, we just call the listener on the target element - if let Some(el_ref) = parent_path { + if let Some((path, el_ref)) = parent_node { // safety: we maintain references of all vnodes in the element slab - let template = unsafe { el_ref.template.unwrap().as_ref() }; + let template = unsafe { el_ref.unwrap().as_ref() }; let node_template = template.template.get(); - let target_path = el_ref.path; + let target_path = path.path; for (idx, attr) in template.dynamic_attrs.iter().enumerate() { let this_path = node_template.attr_paths[idx]; @@ -437,7 +440,7 @@ impl VirtualDom { // Only call the listener if this is the exact target element. if attr.name.trim_start_matches("on") == name && target_path == this_path { if let AttributeValue::Listener(listener) = &attr.value { - let origin = el_ref.scope; + let origin = path.scope; self.runtime.scope_stack.borrow_mut().push(origin); self.runtime.rendering.set(false); if let Some(cb) = listener.borrow_mut().as_deref_mut() { diff --git a/packages/core/tests/fuzzing.rs b/packages/core/tests/fuzzing.rs index 95c3ed9bf..39b5b152c 100644 --- a/packages/core/tests/fuzzing.rs +++ b/packages/core/tests/fuzzing.rs @@ -2,7 +2,7 @@ use dioxus::prelude::Props; use dioxus_core::*; -use std::{cell::Cell, collections::HashSet}; +use std::collections::HashSet; fn random_ns() -> Option<&'static str> { let namespace = rand::random::() % 2; @@ -170,22 +170,23 @@ fn create_random_dynamic_node(cx: &ScopeState, depth: usize) -> DynamicNode { let range = if depth > 5 { 1 } else { 4 }; match rand::random::() % range { 0 => DynamicNode::Placeholder(Default::default()), - 1 => cx.make_node((0..(rand::random::() % 5)).map(|_| VNode { - key: None, - parent: Default::default(), - template: Cell::new(Template { - name: concat!(file!(), ":", line!(), ":", column!(), ":0"), - roots: &[TemplateNode::Dynamic { id: 0 }], - node_paths: &[&[0]], - attr_paths: &[], - }), - root_ids: bumpalo::collections::Vec::new_in(cx.bump()).into(), - dynamic_nodes: cx.bump().alloc([cx.component( - create_random_element, - DepthProps { depth, root: false }, - "create_random_element", - )]), - dynamic_attrs: &[], + 1 => cx.make_node((0..(rand::random::() % 5)).map(|_| { + VNode::new( + None, + Template { + name: concat!(file!(), ":", line!(), ":", column!(), ":0"), + roots: &[TemplateNode::Dynamic { id: 0 }], + node_paths: &[&[0]], + attr_paths: &[], + }, + bumpalo::collections::Vec::new_in(cx.bump()).into(), + cx.bump().alloc([cx.component( + create_random_element, + DepthProps { depth, root: false }, + "create_random_element", + )]), + &[], + ) })), 2 => cx.component( create_random_element, @@ -271,12 +272,11 @@ fn create_random_element(cx: Scope) -> Element { ) .into_boxed_str(), )); - let node = VNode { - key: None, - parent: Default::default(), - template: Cell::new(template), - root_ids: bumpalo::collections::Vec::new_in(cx.bump()).into(), - dynamic_nodes: { + let node = VNode::new( + None, + template, + bumpalo::collections::Vec::new_in(cx.bump()).into(), + { let dynamic_nodes: Vec<_> = dynamic_node_types .iter() .map(|ty| match ty { @@ -290,12 +290,12 @@ fn create_random_element(cx: Scope) -> Element { .collect(); cx.bump().alloc(dynamic_nodes) }, - dynamic_attrs: cx.bump().alloc( + cx.bump().alloc( (0..template.attr_paths.len()) .map(|_| create_random_dynamic_attr(cx)) .collect::>(), ), - }; + ); Some(node) } _ => None, diff --git a/packages/rsx/src/lib.rs b/packages/rsx/src/lib.rs index d5e5b2009..e49f4c52c 100644 --- a/packages/rsx/src/lib.rs +++ b/packages/rsx/src/lib.rs @@ -244,14 +244,13 @@ impl<'a> ToTokens for TemplateRenderer<'a> { node_paths: &[ #(#node_paths),* ], attr_paths: &[ #(#attr_paths),* ], }; - ::dioxus::core::VNode { - parent: Default::default(), - key: #key_tokens, - template: std::cell::Cell::new(TEMPLATE), - root_ids: dioxus::core::exports::bumpalo::collections::Vec::with_capacity_in(#root_count, __cx.bump()).into(), - dynamic_nodes: __cx.bump().alloc([ #( #node_printer ),* ]), - dynamic_attrs: __cx.bump().alloc([ #( #dyn_attr_printer ),* ]), - } + ::dioxus::core::VNode::new( + #key_tokens, + TEMPLATE, + dioxus::core::exports::bumpalo::collections::Vec::with_capacity_in(#root_count, __cx.bump()), + __cx.bump().alloc([ #( #node_printer ),* ]), + __cx.bump().alloc([ #( #dyn_attr_printer ),* ]), + ) }); } } From d81d3ebaefd5ec6f7a47750240f3997e23284a15 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Mon, 11 Sep 2023 16:16:16 -0500 Subject: [PATCH 086/447] assign parents through fragments --- packages/core/src/create.rs | 2 +- packages/core/src/diff.rs | 13 ++++++++----- packages/core/src/virtual_dom.rs | 3 +++ packages/core/tests/event_propagation.rs | 1 + 4 files changed, 13 insertions(+), 6 deletions(-) diff --git a/packages/core/src/create.rs b/packages/core/src/create.rs index 7db744cf5..783842d45 100644 --- a/packages/core/src/create.rs +++ b/packages/core/src/create.rs @@ -485,7 +485,7 @@ impl<'b> VirtualDom { Text(text) => self.create_dynamic_text(parent, text), Placeholder(place) => self.create_placeholder(place, parent), Component(component) => self.create_component_node(Some(parent), component), - Fragment(frag) => frag.iter().map(|child| self.create(child)).sum(), + Fragment(frag) => self.create_children(*frag, Some(parent)), } } diff --git a/packages/core/src/diff.rs b/packages/core/src/diff.rs index 20358cfce..10cdbeb88 100644 --- a/packages/core/src/diff.rs +++ b/packages/core/src/diff.rs @@ -776,15 +776,18 @@ impl<'b> VirtualDom { .sum() } - fn create_children( + pub(crate) fn create_children( &mut self, nodes: impl IntoIterator>, parent: Option, ) -> usize { - nodes.into_iter().fold(0, |acc, child| { - self.assign_boundary_ref(parent, child); - acc + self.create(child) - }) + nodes + .into_iter() + .map(|child| { + self.assign_boundary_ref(parent, child); + self.create(child) + }) + .sum() } fn create_and_insert_before( diff --git a/packages/core/src/virtual_dom.rs b/packages/core/src/virtual_dom.rs index 60727cb42..332376627 100644 --- a/packages/core/src/virtual_dom.rs +++ b/packages/core/src/virtual_dom.rs @@ -379,9 +379,11 @@ impl VirtualDom { let template = unsafe { el_ref.unwrap().as_ref() }; let node_template = template.template.get(); let target_path = path.path; + println!("handle_event: {:?} ({:?})", target_path, template); for (idx, attr) in template.dynamic_attrs.iter().enumerate() { let this_path = node_template.attr_paths[idx]; + println!("checking: {:?} ({:?})", this_path, attr); // Remove the "on" prefix if it exists, TODO, we should remove this and settle on one if attr.name.trim_start_matches("on") == name @@ -401,6 +403,7 @@ impl VirtualDom { // Now that we've accumulated all the parent attributes for the target element, call them in reverse order // We check the bubble state between each call to see if the event has been stopped from bubbling for listener in listeners.drain(..).rev() { + println!("handle_event: {:?}", listener); if let AttributeValue::Listener(listener) = listener { let origin = path.scope; self.runtime.scope_stack.borrow_mut().push(origin); diff --git a/packages/core/tests/event_propagation.rs b/packages/core/tests/event_propagation.rs index be59c3fad..d694b1ff1 100644 --- a/packages/core/tests/event_propagation.rs +++ b/packages/core/tests/event_propagation.rs @@ -55,6 +55,7 @@ fn problematic_child(cx: Scope) -> Element { render! { button { onclick: move |evt| { + println!("bottom clicked"); let mut clicks = CLICKS.lock().unwrap(); if *clicks == 3 { From 589483d892d6b92986d11b0757109c6ccc10e50b Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Mon, 11 Sep 2023 16:18:55 -0500 Subject: [PATCH 087/447] remove logs --- packages/core/src/arena.rs | 3 --- packages/core/src/virtual_dom.rs | 8 -------- 2 files changed, 11 deletions(-) diff --git a/packages/core/src/arena.rs b/packages/core/src/arena.rs index 5dd8dbf67..cd0f6efd1 100644 --- a/packages/core/src/arena.rs +++ b/packages/core/src/arena.rs @@ -48,8 +48,6 @@ impl VirtualDom { std::mem::transmute::, _>(vnode.into()) }))); - println!("next_element_ref: {:?}", new_id); - // Set this id to be dropped when the scope is rerun if let Some(scope) = self.runtime.current_scope_id() { self.scopes[scope.0] @@ -143,7 +141,6 @@ impl VirtualDom { let mut element_refs = self.scopes[scope_id.0].element_refs_to_drop.borrow_mut(); let element_refs_slab = &mut self.element_refs; for element_ref in element_refs.drain(..) { - println!("ensure_drop_safety: {:?}", element_ref); if let Some(element_ref) = element_refs_slab.get_mut(element_ref.0) { *element_ref = None; } diff --git a/packages/core/src/virtual_dom.rs b/packages/core/src/virtual_dom.rs index 332376627..255987bb0 100644 --- a/packages/core/src/virtual_dom.rs +++ b/packages/core/src/virtual_dom.rs @@ -357,7 +357,6 @@ impl VirtualDom { Some(Some(el)) => el, _ => return, }; - println!("handle_event: {:?}", element); let mut parent_node = self .element_refs .get(parent_path.template.0) @@ -379,11 +378,9 @@ impl VirtualDom { let template = unsafe { el_ref.unwrap().as_ref() }; let node_template = template.template.get(); let target_path = path.path; - println!("handle_event: {:?} ({:?})", target_path, template); for (idx, attr) in template.dynamic_attrs.iter().enumerate() { let this_path = node_template.attr_paths[idx]; - println!("checking: {:?} ({:?})", this_path, attr); // Remove the "on" prefix if it exists, TODO, we should remove this and settle on one if attr.name.trim_start_matches("on") == name @@ -403,7 +400,6 @@ impl VirtualDom { // Now that we've accumulated all the parent attributes for the target element, call them in reverse order // We check the bubble state between each call to see if the event has been stopped from bubbling for listener in listeners.drain(..).rev() { - println!("handle_event: {:?}", listener); if let AttributeValue::Listener(listener) = listener { let origin = path.scope; self.runtime.scope_stack.borrow_mut().push(origin); @@ -421,7 +417,6 @@ impl VirtualDom { } parent_node = template.parent.get().and_then(|element_ref| { - println!("handle_event: {:?}", element_ref); self.element_refs .get(element_ref.template.0) .cloned() @@ -607,15 +602,12 @@ impl VirtualDom { /// The mutations will be thrown out, so it's best to use this method for things like SSR that have async content pub async fn wait_for_suspense(&mut self) { loop { - // println!("waiting for suspense {:?}", self.suspended_scopes); if self.suspended_scopes.is_empty() { return; } - // println!("waiting for suspense"); self.wait_for_work().await; - // println!("Rendered immediately"); _ = self.render_immediate(); } } From 73e0be9e6518a06af57047060839d26f79f49a0a Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Mon, 11 Sep 2023 16:25:32 -0500 Subject: [PATCH 088/447] recycle vnode ids --- packages/core/src/arena.rs | 9 +++++++++ packages/core/src/diff.rs | 10 ++++++++++ 2 files changed, 19 insertions(+) diff --git a/packages/core/src/arena.rs b/packages/core/src/arena.rs index cd0f6efd1..fb6741a3f 100644 --- a/packages/core/src/arena.rs +++ b/packages/core/src/arena.rs @@ -89,6 +89,15 @@ impl VirtualDom { id, }); + // Remove all VNode ids from the scope + for id in self.scopes[id.0] + .element_refs_to_drop + .borrow_mut() + .drain(..) + { + self.element_refs.try_remove(id.0); + } + self.ensure_drop_safety(id); if recursive { diff --git a/packages/core/src/diff.rs b/packages/core/src/diff.rs index 10cdbeb88..359f7b3a8 100644 --- a/packages/core/src/diff.rs +++ b/packages/core/src/diff.rs @@ -893,6 +893,16 @@ impl<'b> VirtualDom { // Clean up the roots, assuming we need to generate mutations for these // This is done last in order to preserve Node ID reclaim order (reclaim in reverse order of claim) self.reclaim_roots(node, gen_muts); + + // Clean up the vnode id + self.reclaim_vnode_id(node); + } + + fn reclaim_vnode_id(&mut self, node: &'b VNode<'b>) { + // Clean up the vnode id + if let Some(id) = node.stable_id() { + self.element_refs.remove(id.0); + } } fn reclaim_roots(&mut self, node: &VNode, gen_muts: bool) { From 9d044ee5891a63c24ae600d04b03b2cfc5471067 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Mon, 11 Sep 2023 16:30:16 -0500 Subject: [PATCH 089/447] make clippy happy --- packages/core/src/create.rs | 6 +++--- packages/core/src/diff.rs | 3 +-- 2 files changed, 4 insertions(+), 5 deletions(-) diff --git a/packages/core/src/create.rs b/packages/core/src/create.rs index 783842d45..892cb26ab 100644 --- a/packages/core/src/create.rs +++ b/packages/core/src/create.rs @@ -188,7 +188,7 @@ impl<'b> VirtualDom { node @ Component { .. } | node @ Fragment(_) => { let template_ref = ElementRef { path: ElementPath { - path: &template.template.get().node_paths[idx], + path: template.template.get().node_paths[idx], }, template: template.stable_id().unwrap(), scope: self.runtime.current_scope_id().unwrap_or(ScopeId(0)), @@ -198,7 +198,7 @@ impl<'b> VirtualDom { Placeholder(VPlaceholder { id, parent }) => { let template_ref = ElementRef { path: ElementPath { - path: &template.template.get().node_paths[idx], + path: template.template.get().node_paths[idx], }, template: template.stable_id().unwrap(), scope: self.runtime.current_scope_id().unwrap_or(ScopeId(0)), @@ -287,7 +287,7 @@ impl<'b> VirtualDom { for idx in reversed_iter { let boundary_ref = ElementRef { path: ElementPath { - path: &template.template.get().node_paths[idx], + path: template.template.get().node_paths[idx], }, template: template.stable_id().unwrap(), scope: self.runtime.current_scope_id().unwrap_or(ScopeId(0)), diff --git a/packages/core/src/diff.rs b/packages/core/src/diff.rs index 359f7b3a8..f2f6d7b57 100644 --- a/packages/core/src/diff.rs +++ b/packages/core/src/diff.rs @@ -619,8 +619,7 @@ impl<'b> VirtualDom { } // 4. Compute the LIS of this list - let mut lis_sequence = Vec::default(); - lis_sequence.reserve(new_index_to_old_index.len()); + let mut lis_sequence = Vec::with_capacity(new_index_to_old_index.len()); let mut predecessors = vec![0; new_index_to_old_index.len()]; let mut starts = vec![0; new_index_to_old_index.len()]; From cbf8a1e158378304a70c0600107e2d547337dbd1 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Mon, 11 Sep 2023 16:40:11 -0500 Subject: [PATCH 090/447] fix readme expanded example --- docs/guide/examples/readme_expanded.rs | 16 +++++++--------- 1 file changed, 7 insertions(+), 9 deletions(-) diff --git a/docs/guide/examples/readme_expanded.rs b/docs/guide/examples/readme_expanded.rs index 5e09aee56..8b9abfa20 100644 --- a/docs/guide/examples/readme_expanded.rs +++ b/docs/guide/examples/readme_expanded.rs @@ -84,24 +84,22 @@ fn app(cx: Scope) -> Element { ], }; // The VNode is a reference to the template with the dynamic parts of the rsx - ::dioxus::core::VNode { - parent: Default::default(), - key: None, + ::dioxus::core::VNode::new( + None, // The static template this node will use. The template is stored in a Cell so it can be replaced with a new template when hot rsx reloading is enabled - template: std::cell::Cell::new(TEMPLATE), - root_ids: dioxus::core::exports::bumpalo::collections::Vec::new_in(__cx.bump()) - .into(), - dynamic_nodes: __cx.bump().alloc([ + TEMPLATE, + dioxus::core::exports::bumpalo::collections::Vec::new_in(__cx.bump()), + __cx.bump().alloc([ // The dynamic count text node (dynamic node id 0) __cx.text_node(format_args!("High-Five counter: {0}", count)), ]), - dynamic_attrs: __cx.bump().alloc([ + __cx.bump().alloc([ // The dynamic up high button onclick listener (dynamic attribute id 0) dioxus_elements::events::onclick(__cx, move |_| count += 1), // The dynamic down low button onclick listener (dynamic attribute id 1) dioxus_elements::events::onclick(__cx, move |_| count -= 1), ]), - } + ) }, ), ) From cb8027cf435677eb3aaa2d7457c6fbcca075c2fd Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Tue, 12 Sep 2023 09:11:57 -0500 Subject: [PATCH 091/447] fix native core fuzzing test --- packages/native-core/tests/fuzzing.rs | 50 +++++++++++++-------------- 1 file changed, 24 insertions(+), 26 deletions(-) diff --git a/packages/native-core/tests/fuzzing.rs b/packages/native-core/tests/fuzzing.rs index 82794e7d0..29c4fef9e 100644 --- a/packages/native-core/tests/fuzzing.rs +++ b/packages/native-core/tests/fuzzing.rs @@ -3,7 +3,6 @@ use dioxus_core::*; use dioxus_native_core::prelude::*; use dioxus_native_core_macro::partial_derive_state; use shipyard::Component; -use std::cell::Cell; fn random_ns() -> Option<&'static str> { let namespace = rand::random::() % 2; @@ -178,22 +177,23 @@ fn create_random_dynamic_node(cx: &ScopeState, depth: usize) -> DynamicNode { let range = if depth > 3 { 1 } else { 3 }; match rand::random::() % range { 0 => DynamicNode::Placeholder(Default::default()), - 1 => cx.make_node((0..(rand::random::() % 5)).map(|_| VNode { - key: None, - parent: Default::default(), - template: Cell::new(Template { - name: concat!(file!(), ":", line!(), ":", column!(), ":0"), - roots: &[TemplateNode::Dynamic { id: 0 }], - node_paths: &[&[0]], - attr_paths: &[], - }), - root_ids: dioxus::core::exports::bumpalo::collections::Vec::new_in(cx.bump()).into(), - dynamic_nodes: cx.bump().alloc([cx.component( - create_random_element, - DepthProps { depth, root: false }, - "create_random_element", - )]), - dynamic_attrs: &[], + 1 => cx.make_node((0..(rand::random::() % 5)).map(|_| { + VNode::new( + None, + Template { + name: concat!(file!(), ":", line!(), ":", column!(), ":0"), + roots: &[TemplateNode::Dynamic { id: 0 }], + node_paths: &[&[0]], + attr_paths: &[], + }, + dioxus::core::exports::bumpalo::collections::Vec::new_in(cx.bump()), + cx.bump().alloc([cx.component( + create_random_element, + DepthProps { depth, root: false }, + "create_random_element", + )]), + &[], + ) })), 2 => cx.component( create_random_element, @@ -253,13 +253,11 @@ fn create_random_element(cx: Scope) -> Element { .into_boxed_str(), )); println!("{template:#?}"); - let node = VNode { - key: None, - parent: Default::default(), - template: Cell::new(template), - root_ids: dioxus::core::exports::bumpalo::collections::Vec::new_in(cx.bump()) - .into(), - dynamic_nodes: { + let node = VNode::new( + None, + template, + dioxus::core::exports::bumpalo::collections::Vec::new_in(cx.bump()), + { let dynamic_nodes: Vec<_> = dynamic_node_types .iter() .map(|ty| match ty { @@ -273,12 +271,12 @@ fn create_random_element(cx: Scope) -> Element { .collect(); cx.bump().alloc(dynamic_nodes) }, - dynamic_attrs: cx.bump().alloc( + cx.bump().alloc( (0..template.attr_paths.len()) .map(|_| create_random_dynamic_attr(cx)) .collect::>(), ), - }; + ); Some(node) } _ => None, From c8fca7b321d3b1b818548c75e3a475ebdfd0bd1d Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Tue, 12 Sep 2023 09:28:08 -0500 Subject: [PATCH 092/447] fix clippy --- packages/core/tests/fuzzing.rs | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/packages/core/tests/fuzzing.rs b/packages/core/tests/fuzzing.rs index 39b5b152c..b847dc04e 100644 --- a/packages/core/tests/fuzzing.rs +++ b/packages/core/tests/fuzzing.rs @@ -179,7 +179,7 @@ fn create_random_dynamic_node(cx: &ScopeState, depth: usize) -> DynamicNode { node_paths: &[&[0]], attr_paths: &[], }, - bumpalo::collections::Vec::new_in(cx.bump()).into(), + bumpalo::collections::Vec::new_in(cx.bump()), cx.bump().alloc([cx.component( create_random_element, DepthProps { depth, root: false }, @@ -275,7 +275,7 @@ fn create_random_element(cx: Scope) -> Element { let node = VNode::new( None, template, - bumpalo::collections::Vec::new_in(cx.bump()).into(), + bumpalo::collections::Vec::new_in(cx.bump()), { let dynamic_nodes: Vec<_> = dynamic_node_types .iter() From a9bb04722f63f7798878e6147c6a8a787070eed3 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Tue, 12 Sep 2023 10:01:53 -0500 Subject: [PATCH 093/447] split the point interaction trait into smaller traits for touch compatibility --- packages/html/src/events/drag.rs | 18 +++++-- packages/html/src/events/mouse.rs | 20 +++++-- packages/html/src/events/pointer.rs | 20 +++++-- packages/html/src/lib.rs | 2 +- packages/html/src/point_interaction.rs | 69 ++++++++++++++---------- packages/html/src/web_sys_bind/events.rs | 12 ++++- packages/rink/src/hooks.rs | 2 +- packages/rink/src/widgets/slider.rs | 4 +- packages/rink/src/widgets/text_like.rs | 4 +- 9 files changed, 101 insertions(+), 50 deletions(-) diff --git a/packages/html/src/events/drag.rs b/packages/html/src/events/drag.rs index 3ebd5fdbe..a21f33f25 100644 --- a/packages/html/src/events/drag.rs +++ b/packages/html/src/events/drag.rs @@ -1,6 +1,6 @@ use crate::geometry::{ClientPoint, Coordinates, ElementPoint, PagePoint, ScreenPoint}; use crate::input_data::{MouseButton, MouseButtonSet}; -use crate::prelude::PointInteraction; +use crate::prelude::*; use dioxus_core::Event; use keyboard_types::Modifiers; @@ -17,7 +17,7 @@ pub struct DragData { inner: Box, } -impl From for DragData { +impl From for DragData { fn from(e: E) -> Self { Self { inner: Box::new(e) } } @@ -57,7 +57,7 @@ impl DragData { } } -impl PointInteraction for DragData { +impl InteractionLocation for DragData { fn client_coordinates(&self) -> ClientPoint { self.inner.client_coordinates() } @@ -77,11 +77,15 @@ impl PointInteraction for DragData { fn coordinates(&self) -> Coordinates { self.inner.coordinates() } +} +impl ModifiersInteraction for DragData { fn modifiers(&self) -> Modifiers { self.inner.modifiers() } +} +impl PointerInteraction for DragData { fn held_buttons(&self) -> MouseButtonSet { self.inner.held_buttons() } @@ -119,7 +123,7 @@ impl HasMouseData for SerializedDragData { } #[cfg(feature = "serialize")] -impl crate::prelude::PointInteraction for SerializedDragData { +impl InteractionLocation for SerializedDragData { fn client_coordinates(&self) -> ClientPoint { self.mouse.client_coordinates() } @@ -139,11 +143,17 @@ impl crate::prelude::PointInteraction for SerializedDragData { fn coordinates(&self) -> Coordinates { self.mouse.coordinates() } +} +#[cfg(feature = "serialize")] +impl ModifiersInteraction for SerializedDragData { fn modifiers(&self) -> Modifiers { self.mouse.modifiers() } +} +#[cfg(feature = "serialize")] +impl PointerInteraction for SerializedDragData { fn held_buttons(&self) -> MouseButtonSet { self.mouse.held_buttons() } diff --git a/packages/html/src/events/mouse.rs b/packages/html/src/events/mouse.rs index c6a98e25e..d7f328043 100644 --- a/packages/html/src/events/mouse.rs +++ b/packages/html/src/events/mouse.rs @@ -1,6 +1,6 @@ use crate::geometry::{ClientPoint, Coordinates, ElementPoint, PagePoint, ScreenPoint}; use crate::input_data::{MouseButton, MouseButtonSet}; -use crate::point_interaction::PointInteraction; +use crate::prelude::*; use dioxus_core::Event; use keyboard_types::Modifiers; @@ -12,7 +12,7 @@ pub struct MouseData { inner: Box, } -impl From for MouseData { +impl From for MouseData { fn from(e: E) -> Self { Self { inner: Box::new(e) } } @@ -39,7 +39,7 @@ impl PartialEq for MouseData { } /// A trait for any object that has the data for a mouse event -pub trait HasMouseData: PointInteraction { +pub trait HasMouseData: PointerInteraction { /// return self as Any fn as_any(&self) -> &dyn std::any::Any; } @@ -119,7 +119,7 @@ impl MouseData { } } -impl PointInteraction for MouseData { +impl InteractionLocation for MouseData { /// The event's coordinates relative to the application's viewport (as opposed to the coordinate within the page). /// /// For example, clicking in the top left corner of the viewport will always result in a mouse event with client coordinates (0., 0.), regardless of whether the page is scrolled horizontally. @@ -149,12 +149,16 @@ impl PointInteraction for MouseData { fn coordinates(&self) -> Coordinates { self.inner.coordinates() } +} +impl ModifiersInteraction for MouseData { /// The set of modifier keys which were pressed when the event occurred fn modifiers(&self) -> Modifiers { self.inner.modifiers() } +} +impl PointerInteraction for MouseData { /// The set of mouse buttons which were held when the event occurred. fn held_buttons(&self) -> MouseButtonSet { self.inner.held_buttons() @@ -224,7 +228,7 @@ impl HasMouseData for SerializedMouseData { } #[cfg(feature = "serialize")] -impl PointInteraction for SerializedMouseData { +impl InteractionLocation for SerializedMouseData { fn client_coordinates(&self) -> ClientPoint { self.point_data.client_coordinates() } @@ -240,11 +244,17 @@ impl PointInteraction for SerializedMouseData { fn screen_coordinates(&self) -> ScreenPoint { self.point_data.screen_coordinates() } +} +#[cfg(feature = "serialize")] +impl ModifiersInteraction for SerializedMouseData { fn modifiers(&self) -> Modifiers { self.point_data.modifiers() } +} +#[cfg(feature = "serialize")] +impl PointerInteraction for SerializedMouseData { fn held_buttons(&self) -> MouseButtonSet { self.point_data.held_buttons() } diff --git a/packages/html/src/events/pointer.rs b/packages/html/src/events/pointer.rs index ec351d3dc..6c96136ef 100644 --- a/packages/html/src/events/pointer.rs +++ b/packages/html/src/events/pointer.rs @@ -1,7 +1,7 @@ use dioxus_core::Event; use keyboard_types::Modifiers; -use crate::{geometry::*, input_data::*, point_interaction::PointInteraction}; +use crate::{geometry::*, input_data::*, prelude::*}; /// A synthetic event that wraps a web-style [`PointerEvent`](https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent) pub type PointerEvent = Event; @@ -22,7 +22,7 @@ impl PointerData { } } -impl From for PointerData { +impl From for PointerData { fn from(e: E) -> Self { Self { inner: Box::new(e) } } @@ -69,7 +69,7 @@ impl PartialEq for PointerData { } /// A trait for any object that has the data for a pointer event -pub trait HasPointerData: PointInteraction { +pub trait HasPointerData: PointerInteraction { /// Gets the unique identifier of the pointer causing the event. fn pointer_id(&self) -> i32; @@ -189,7 +189,7 @@ impl PointerData { } } -impl PointInteraction for PointerData { +impl InteractionLocation for PointerData { fn client_coordinates(&self) -> ClientPoint { self.inner.client_coordinates() } @@ -205,11 +205,15 @@ impl PointInteraction for PointerData { fn page_coordinates(&self) -> PagePoint { self.inner.page_coordinates() } +} +impl ModifiersInteraction for PointerData { fn modifiers(&self) -> Modifiers { self.inner.modifiers() } +} +impl PointerInteraction for PointerData { fn held_buttons(&self) -> MouseButtonSet { self.inner.held_buttons() } @@ -306,7 +310,7 @@ impl HasPointerData for SerializedPointerData { } #[cfg(feature = "serialize")] -impl PointInteraction for SerializedPointerData { +impl InteractionLocation for SerializedPointerData { fn client_coordinates(&self) -> ClientPoint { self.point_data.client_coordinates() } @@ -322,11 +326,17 @@ impl PointInteraction for SerializedPointerData { fn page_coordinates(&self) -> PagePoint { self.point_data.page_coordinates() } +} +#[cfg(feature = "serialize")] +impl ModifiersInteraction for SerializedPointerData { fn modifiers(&self) -> Modifiers { self.point_data.modifiers() } +} +#[cfg(feature = "serialize")] +impl PointerInteraction for SerializedPointerData { fn held_buttons(&self) -> MouseButtonSet { self.point_data.held_buttons() } diff --git a/packages/html/src/lib.rs b/packages/html/src/lib.rs index a39dceff2..e8ee3ffb8 100644 --- a/packages/html/src/lib.rs +++ b/packages/html/src/lib.rs @@ -45,6 +45,6 @@ pub mod prelude { #[cfg(feature = "eval")] pub use crate::eval::*; pub use crate::events::*; - pub use crate::point_interaction::PointInteraction; + pub use crate::point_interaction::*; pub use keyboard_types::{self, Code, Key, Location, Modifiers}; } diff --git a/packages/html/src/point_interaction.rs b/packages/html/src/point_interaction.rs index f26917201..9204f968e 100644 --- a/packages/html/src/point_interaction.rs +++ b/packages/html/src/point_interaction.rs @@ -5,8 +5,9 @@ use crate::{ input_data::{MouseButton, MouseButtonSet}, }; -pub trait PointInteraction: std::any::Any { - /// Gets the coordinates of the pointer event. +/// A interaction that contains data about the location of the event. +pub trait InteractionLocation { + /// Gets the coordinates of the event. fn coordinates(&self) -> Coordinates { Coordinates::new( self.screen_coordinates(), @@ -16,26 +17,32 @@ pub trait PointInteraction: std::any::Any { ) } - /// Gets the coordinates of the pointer event relative to the browser viewport. + /// Gets the coordinates of the event relative to the browser viewport. fn client_coordinates(&self) -> ClientPoint; - /// Gets the coordinates of the pointer event relative to the screen. + /// Gets the coordinates of the event relative to the screen. fn screen_coordinates(&self) -> ScreenPoint; - /// Gets the coordinates of the pointer event relative to the target element. + /// Gets the coordinates of the event relative to the target element. fn element_coordinates(&self) -> ElementPoint; - /// Gets the coordinates of the pointer event relative to the page. + /// Gets the coordinates of the event relative to the page. fn page_coordinates(&self) -> PagePoint; +} - /// Gets the modifiers of the pointer event. - fn modifiers(&self) -> Modifiers; +/// A interaction that contains data about the pointer button(s) that triggered the event. +pub trait PointerInteraction: InteractionLocation + ModifiersInteraction { + /// Gets the button that triggered the event. + fn trigger_button(&self) -> Option; /// Gets the buttons that are currently held down. fn held_buttons(&self) -> MouseButtonSet; +} - /// Gets the button that triggered the event. - fn trigger_button(&self) -> Option; +/// A interaction that contains data about the current state of the keyboard modifiers. +pub trait ModifiersInteraction { + /// Gets the modifiers of the pointer event. + fn modifiers(&self) -> Modifiers; } #[cfg(feature = "serialize")] @@ -138,7 +145,7 @@ impl SerializedPointInteraction { } #[cfg(feature = "serialize")] -impl From<&E> for SerializedPointInteraction { +impl From<&E> for SerializedPointInteraction { fn from(data: &E) -> Self { let trigger_button = data.trigger_button(); let held_buttons = data.held_buttons(); @@ -149,23 +156,18 @@ impl From<&E> for SerializedPointInteraction { } #[cfg(feature = "serialize")] -impl PointInteraction for SerializedPointInteraction { - fn client_coordinates(&self) -> ClientPoint { - ClientPoint::new(self.client_x.into(), self.client_y.into()) +impl PointerInteraction for SerializedPointInteraction { + fn held_buttons(&self) -> MouseButtonSet { + crate::input_data::decode_mouse_button_set(self.buttons) } - fn screen_coordinates(&self) -> ScreenPoint { - ScreenPoint::new(self.screen_x.into(), self.screen_y.into()) - } - - fn element_coordinates(&self) -> ElementPoint { - ElementPoint::new(self.offset_x.into(), self.offset_y.into()) - } - - fn page_coordinates(&self) -> PagePoint { - PagePoint::new(self.page_x.into(), self.page_y.into()) + fn trigger_button(&self) -> Option { + Some(MouseButton::from_web_code(self.button)) } +} +#[cfg(feature = "serialize")] +impl ModifiersInteraction for SerializedPointInteraction { fn modifiers(&self) -> Modifiers { let mut modifiers = Modifiers::empty(); @@ -184,12 +186,23 @@ impl PointInteraction for SerializedPointInteraction { modifiers } +} - fn held_buttons(&self) -> MouseButtonSet { - crate::input_data::decode_mouse_button_set(self.buttons) +#[cfg(feature = "serialize")] +impl InteractionLocation for SerializedPointInteraction { + fn client_coordinates(&self) -> ClientPoint { + ClientPoint::new(self.client_x.into(), self.client_y.into()) } - fn trigger_button(&self) -> Option { - Some(MouseButton::from_web_code(self.button)) + fn screen_coordinates(&self) -> ScreenPoint { + ScreenPoint::new(self.screen_x.into(), self.screen_y.into()) + } + + fn element_coordinates(&self) -> ElementPoint { + ElementPoint::new(self.offset_x.into(), self.offset_y.into()) + } + + fn page_coordinates(&self) -> PagePoint { + PagePoint::new(self.page_x.into(), self.page_y.into()) } } diff --git a/packages/html/src/web_sys_bind/events.rs b/packages/html/src/web_sys_bind/events.rs index 643a06045..148a30c88 100644 --- a/packages/html/src/web_sys_bind/events.rs +++ b/packages/html/src/web_sys_bind/events.rs @@ -103,7 +103,7 @@ impl HasKeyboardData for KeyboardEvent { impl HasDragData for MouseEvent {} -impl PointInteraction for MouseEvent { +impl InteractionLocation for MouseEvent { fn client_coordinates(&self) -> ClientPoint { ClientPoint::new(self.client_x().into(), self.client_y().into()) } @@ -119,7 +119,9 @@ impl PointInteraction for MouseEvent { fn screen_coordinates(&self) -> ScreenPoint { ScreenPoint::new(self.screen_x().into(), self.screen_y().into()) } +} +impl ModifiersInteraction for MouseEvent { fn modifiers(&self) -> Modifiers { let mut modifiers = Modifiers::empty(); @@ -138,7 +140,9 @@ impl PointInteraction for MouseEvent { modifiers } +} +impl PointerInteraction for MouseEvent { fn held_buttons(&self) -> crate::input_data::MouseButtonSet { decode_mouse_button_set(self.buttons()) } @@ -222,7 +226,7 @@ impl HasPointerData for PointerEvent { } } -impl PointInteraction for PointerEvent { +impl InteractionLocation for PointerEvent { fn client_coordinates(&self) -> ClientPoint { ClientPoint::new(self.client_x().into(), self.client_y().into()) } @@ -238,7 +242,9 @@ impl PointInteraction for PointerEvent { fn page_coordinates(&self) -> PagePoint { PagePoint::new(self.page_x().into(), self.page_y().into()) } +} +impl ModifiersInteraction for PointerEvent { fn modifiers(&self) -> Modifiers { let mut modifiers = Modifiers::empty(); @@ -257,7 +263,9 @@ impl PointInteraction for PointerEvent { modifiers } +} +impl PointerInteraction for PointerEvent { fn held_buttons(&self) -> crate::input_data::MouseButtonSet { decode_mouse_button_set(self.buttons()) } diff --git a/packages/rink/src/hooks.rs b/packages/rink/src/hooks.rs index c5378bfbf..1ffa361f7 100644 --- a/packages/rink/src/hooks.rs +++ b/packages/rink/src/hooks.rs @@ -18,7 +18,7 @@ use dioxus_html::input_data::keyboard_types::{Code, Key, Location, Modifiers}; use dioxus_html::input_data::{ MouseButton as DioxusMouseButton, MouseButtonSet as DioxusMouseButtons, }; -use dioxus_html::{event_bubbles, prelude::PointInteraction}; +use dioxus_html::{event_bubbles, prelude::*}; use std::any::Any; use std::collections::HashMap; use std::{ diff --git a/packages/rink/src/widgets/slider.rs b/packages/rink/src/widgets/slider.rs index 5cef645cf..b3d6d24da 100644 --- a/packages/rink/src/widgets/slider.rs +++ b/packages/rink/src/widgets/slider.rs @@ -1,8 +1,8 @@ use std::collections::HashMap; use dioxus_html::{ - input_data::keyboard_types::Key, prelude::PointInteraction, HasKeyboardData, - SerializedKeyboardData, SerializedMouseData, + input_data::keyboard_types::Key, prelude::*, HasKeyboardData, SerializedKeyboardData, + SerializedMouseData, }; use dioxus_native_core::{ custom_element::CustomElement, diff --git a/packages/rink/src/widgets/text_like.rs b/packages/rink/src/widgets/text_like.rs index e7869600a..3231a9e29 100644 --- a/packages/rink/src/widgets/text_like.rs +++ b/packages/rink/src/widgets/text_like.rs @@ -2,8 +2,8 @@ use std::{collections::HashMap, io::stdout}; use crossterm::{cursor::MoveTo, execute}; use dioxus_html::{ - input_data::keyboard_types::Key, prelude::PointInteraction, HasKeyboardData, - SerializedKeyboardData, SerializedMouseData, + input_data::keyboard_types::Key, prelude::*, HasKeyboardData, SerializedKeyboardData, + SerializedMouseData, }; use dioxus_native_core::{ custom_element::CustomElement, From c10700c962367bbacfa46ef8c06dc6c7136fd652 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Tue, 12 Sep 2023 17:28:55 -0500 Subject: [PATCH 094/447] add touch data to touch events --- packages/html/Cargo.toml | 3 +- packages/html/src/events/drag.rs | 21 ++- packages/html/src/events/keyboard.rs | 45 ++--- packages/html/src/events/mouse.rs | 31 ++-- packages/html/src/events/pointer.rs | 21 ++- packages/html/src/events/touch.rs | 219 +++++++++++++++++------ packages/html/src/point_interaction.rs | 34 ++-- packages/html/src/web_sys_bind/events.rs | 125 +++++++++---- 8 files changed, 339 insertions(+), 160 deletions(-) diff --git a/packages/html/Cargo.toml b/packages/html/Cargo.toml index 5b665d14b..00df6040a 100644 --- a/packages/html/Cargo.toml +++ b/packages/html/Cargo.toml @@ -29,12 +29,13 @@ serde_json = { version = "1", optional = true } optional = true version = "0.3.56" features = [ + "Touch", + "TouchList", "TouchEvent", "MouseEvent", "InputEvent", "ClipboardEvent", "KeyboardEvent", - "TouchEvent", "WheelEvent", "AnimationEvent", "TransitionEvent", diff --git a/packages/html/src/events/drag.rs b/packages/html/src/events/drag.rs index a21f33f25..e58c20e22 100644 --- a/packages/html/src/events/drag.rs +++ b/packages/html/src/events/drag.rs @@ -62,10 +62,6 @@ impl InteractionLocation for DragData { self.inner.client_coordinates() } - fn element_coordinates(&self) -> ElementPoint { - self.inner.element_coordinates() - } - fn page_coordinates(&self) -> PagePoint { self.inner.page_coordinates() } @@ -73,6 +69,12 @@ impl InteractionLocation for DragData { fn screen_coordinates(&self) -> ScreenPoint { self.inner.screen_coordinates() } +} + +impl InteractionElementOffset for DragData { + fn element_coordinates(&self) -> ElementPoint { + self.inner.element_coordinates() + } fn coordinates(&self) -> Coordinates { self.inner.coordinates() @@ -128,10 +130,6 @@ impl InteractionLocation for SerializedDragData { self.mouse.client_coordinates() } - fn element_coordinates(&self) -> ElementPoint { - self.mouse.element_coordinates() - } - fn page_coordinates(&self) -> PagePoint { self.mouse.page_coordinates() } @@ -139,6 +137,13 @@ impl InteractionLocation for SerializedDragData { fn screen_coordinates(&self) -> ScreenPoint { self.mouse.screen_coordinates() } +} + +#[cfg(feature = "serialize")] +impl InteractionElementOffset for SerializedDragData { + fn element_coordinates(&self) -> ElementPoint { + self.mouse.element_coordinates() + } fn coordinates(&self) -> Coordinates { self.mouse.coordinates() diff --git a/packages/html/src/events/keyboard.rs b/packages/html/src/events/keyboard.rs index a762f7ee9..feb0ab313 100644 --- a/packages/html/src/events/keyboard.rs +++ b/packages/html/src/events/keyboard.rs @@ -2,6 +2,8 @@ use dioxus_core::Event; use keyboard_types::{Code, Key, Location, Modifiers}; use std::fmt::Debug; +use crate::prelude::ModifiersInteraction; + #[cfg(feature = "serialize")] fn resilient_deserialize_code<'de, D>(deserializer: D) -> Result where @@ -63,11 +65,6 @@ impl KeyboardData { self.inner.code() } - /// The set of modifier keys which were pressed when the event occurred - pub fn modifiers(&self) -> Modifiers { - self.inner.modifiers() - } - /// The location of the key on the keyboard or other input device. pub fn location(&self) -> Location { self.inner.location() @@ -84,6 +81,12 @@ impl KeyboardData { } } +impl ModifiersInteraction for KeyboardData { + fn modifiers(&self) -> Modifiers { + self.inner.modifiers() + } +} + #[cfg(feature = "serialize")] /// A serialized version of KeyboardData #[derive(serde::Serialize, serde::Deserialize, Debug, PartialEq, Clone)] @@ -155,6 +158,21 @@ impl HasKeyboardData for SerializedKeyboardData { self.code } + fn location(&self) -> Location { + crate::input_data::decode_key_location(self.location) + } + + fn is_auto_repeating(&self) -> bool { + self.repeat + } + + fn as_any(&self) -> &dyn std::any::Any { + self + } +} + +#[cfg(feature = "serialize")] +impl ModifiersInteraction for SerializedKeyboardData { fn modifiers(&self) -> Modifiers { let mut modifiers = Modifiers::empty(); @@ -173,18 +191,6 @@ impl HasKeyboardData for SerializedKeyboardData { modifiers } - - fn location(&self) -> Location { - crate::input_data::decode_key_location(self.location) - } - - fn is_auto_repeating(&self) -> bool { - self.repeat - } - - fn as_any(&self) -> &dyn std::any::Any { - self - } } #[cfg(feature = "serialize")] @@ -217,16 +223,13 @@ impl_event! { onkeyup } -pub trait HasKeyboardData: std::any::Any { +pub trait HasKeyboardData: ModifiersInteraction + std::any::Any { /// The value of the key pressed by the user, taking into consideration the state of modifier keys such as Shift as well as the keyboard locale and layout. fn key(&self) -> Key; /// A physical key on the keyboard (as opposed to the character generated by pressing the key). In other words, this property returns a value that isn't altered by keyboard layout or the state of the modifier keys. fn code(&self) -> Code; - /// The set of modifier keys which were pressed when the event occurred - fn modifiers(&self) -> Modifiers; - /// The location of the key on the keyboard or other input device. fn location(&self) -> Location; diff --git a/packages/html/src/events/mouse.rs b/packages/html/src/events/mouse.rs index d7f328043..0fbaf2c9e 100644 --- a/packages/html/src/events/mouse.rs +++ b/packages/html/src/events/mouse.rs @@ -120,31 +120,23 @@ impl MouseData { } impl InteractionLocation for MouseData { - /// The event's coordinates relative to the application's viewport (as opposed to the coordinate within the page). - /// - /// For example, clicking in the top left corner of the viewport will always result in a mouse event with client coordinates (0., 0.), regardless of whether the page is scrolled horizontally. fn client_coordinates(&self) -> ClientPoint { self.inner.client_coordinates() } - /// The event's coordinates relative to the padding edge of the target element - /// - /// For example, clicking in the top left corner of an element will result in element coordinates (0., 0.) - fn element_coordinates(&self) -> ElementPoint { - self.inner.element_coordinates() - } - - /// The event's coordinates relative to the entire document. This includes any portion of the document not currently visible. - /// - /// For example, if the page is scrolled 200 pixels to the right and 300 pixels down, clicking in the top left corner of the viewport would result in page coordinates (200., 300.) fn page_coordinates(&self) -> PagePoint { self.inner.page_coordinates() } - /// The event's coordinates relative to the entire screen. This takes into account the window's offset. fn screen_coordinates(&self) -> ScreenPoint { self.inner.screen_coordinates() } +} + +impl InteractionElementOffset for MouseData { + fn element_coordinates(&self) -> ElementPoint { + self.inner.element_coordinates() + } fn coordinates(&self) -> Coordinates { self.inner.coordinates() @@ -233,10 +225,6 @@ impl InteractionLocation for SerializedMouseData { self.point_data.client_coordinates() } - fn element_coordinates(&self) -> ElementPoint { - self.point_data.element_coordinates() - } - fn page_coordinates(&self) -> PagePoint { self.point_data.page_coordinates() } @@ -246,6 +234,13 @@ impl InteractionLocation for SerializedMouseData { } } +#[cfg(feature = "serialize")] +impl InteractionElementOffset for SerializedMouseData { + fn element_coordinates(&self) -> ElementPoint { + self.point_data.element_coordinates() + } +} + #[cfg(feature = "serialize")] impl ModifiersInteraction for SerializedMouseData { fn modifiers(&self) -> Modifiers { diff --git a/packages/html/src/events/pointer.rs b/packages/html/src/events/pointer.rs index 6c96136ef..9556502d3 100644 --- a/packages/html/src/events/pointer.rs +++ b/packages/html/src/events/pointer.rs @@ -198,15 +198,17 @@ impl InteractionLocation for PointerData { self.inner.screen_coordinates() } - fn element_coordinates(&self) -> ElementPoint { - self.inner.element_coordinates() - } - fn page_coordinates(&self) -> PagePoint { self.inner.page_coordinates() } } +impl InteractionElementOffset for PointerData { + fn element_coordinates(&self) -> ElementPoint { + self.inner.element_coordinates() + } +} + impl ModifiersInteraction for PointerData { fn modifiers(&self) -> Modifiers { self.inner.modifiers() @@ -319,15 +321,18 @@ impl InteractionLocation for SerializedPointerData { self.point_data.screen_coordinates() } - fn element_coordinates(&self) -> ElementPoint { - self.point_data.element_coordinates() - } - fn page_coordinates(&self) -> PagePoint { self.point_data.page_coordinates() } } +#[cfg(feature = "serialize")] +impl InteractionElementOffset for SerializedPointerData { + fn element_coordinates(&self) -> ElementPoint { + self.point_data.element_coordinates() + } +} + #[cfg(feature = "serialize")] impl ModifiersInteraction for SerializedPointerData { fn modifiers(&self) -> Modifiers { diff --git a/packages/html/src/events/touch.rs b/packages/html/src/events/touch.rs index 12d8a5de1..83fdbb0b4 100644 --- a/packages/html/src/events/touch.rs +++ b/packages/html/src/events/touch.rs @@ -1,4 +1,8 @@ use dioxus_core::Event; +use keyboard_types::Modifiers; + +use crate::geometry::*; +use crate::prelude::{InteractionLocation, ModifiersInteraction}; pub type TouchEvent = Event; pub struct TouchData { @@ -14,20 +18,14 @@ impl From for TouchData { impl std::fmt::Debug for TouchData { fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { f.debug_struct("TouchData") - .field("alt_key", &self.alt_key()) - .field("ctrl_key", &self.ctrl_key()) - .field("meta_key", &self.meta_key()) - .field("shift_key", &self.shift_key()) + .field("modifiers", &self.modifiers()) .finish() } } impl PartialEq for TouchData { fn eq(&self, other: &Self) -> bool { - self.alt_key() == other.alt_key() - && self.ctrl_key() == other.ctrl_key() - && self.meta_key() == other.meta_key() - && self.shift_key() == other.shift_key() + self.modifiers() == other.modifiers() } } @@ -39,24 +37,9 @@ impl TouchData { } } - /// Returns true if the "ALT" key was down when the touch event was fired. - pub fn alt_key(&self) -> bool { - self.inner.alt_key() - } - - /// Returns true if the "CTRL" key was down when the touch event was fired. - pub fn ctrl_key(&self) -> bool { - self.inner.ctrl_key() - } - - /// Returns true if the "META" key was down when the touch event was fired. - pub fn meta_key(&self) -> bool { - self.inner.meta_key() - } - - /// Returns true if the "SHIFT" key was down when the touch event was fired. - pub fn shift_key(&self) -> bool { - self.inner.shift_key() + /// Get the pointers that are currently down + pub fn touches(&self) -> Vec { + self.inner.touches() } /// Downcast this event to a concrete event type @@ -65,6 +48,12 @@ impl TouchData { } } +impl ModifiersInteraction for TouchData { + fn modifiers(&self) -> Modifiers { + self.inner.modifiers() + } +} + #[cfg(feature = "serialize")] /// A serialized version of TouchData #[derive(serde::Serialize, serde::Deserialize, Debug, PartialEq, Clone)] @@ -73,36 +62,47 @@ pub struct SerializedTouchData { ctrl_key: bool, meta_key: bool, shift_key: bool, + touches: Vec, } #[cfg(feature = "serialize")] impl From<&TouchData> for SerializedTouchData { fn from(data: &TouchData) -> Self { + let modifiers = data.modifiers(); Self { - alt_key: data.alt_key(), - ctrl_key: data.ctrl_key(), - meta_key: data.meta_key(), - shift_key: data.shift_key(), + alt_key: modifiers.contains(Modifiers::ALT), + ctrl_key: modifiers.contains(Modifiers::CONTROL), + meta_key: modifiers.contains(Modifiers::META), + shift_key: modifiers.contains(Modifiers::SHIFT), + touches: data.touches().iter().map(|t| t.into()).collect(), } } } +#[cfg(feature = "serialize")] +impl ModifiersInteraction for SerializedTouchData { + fn modifiers(&self) -> Modifiers { + let mut modifiers = Modifiers::default(); + if self.alt_key { + modifiers.insert(Modifiers::ALT); + } + if self.ctrl_key { + modifiers.insert(Modifiers::CONTROL); + } + if self.meta_key { + modifiers.insert(Modifiers::META); + } + if self.shift_key { + modifiers.insert(Modifiers::SHIFT); + } + modifiers + } +} + #[cfg(feature = "serialize")] impl HasTouchData for SerializedTouchData { - fn alt_key(&self) -> bool { - self.alt_key - } - - fn ctrl_key(&self) -> bool { - self.ctrl_key - } - - fn meta_key(&self) -> bool { - self.meta_key - } - - fn shift_key(&self) -> bool { - self.shift_key + fn touches(&self) -> Vec { + Vec::new() } fn as_any(&self) -> &dyn std::any::Any { @@ -127,23 +127,130 @@ impl<'de> serde::Deserialize<'de> for TouchData { } } -pub trait HasTouchData: std::any::Any { - /// Returns true if the "ALT" key was down when the touch event was fired. - fn alt_key(&self) -> bool; - - /// Returns true if the "CTRL" key was down when the touch event was fired. - fn ctrl_key(&self) -> bool; - - /// Returns true if the "META" key was down when the touch event was fired. - fn meta_key(&self) -> bool; - - /// Returns true if the "SHIFT" key was down when the touch event was fired. - fn shift_key(&self) -> bool; +pub trait HasTouchData: ModifiersInteraction + std::any::Any { + /// Get the pointers that are currently down + fn touches(&self) -> Vec; /// return self as Any fn as_any(&self) -> &dyn std::any::Any; } +pub struct TouchPoint { + inner: Box, +} + +impl From for TouchPoint { + fn from(e: E) -> Self { + Self { inner: Box::new(e) } + } +} + +impl TouchPoint { + /// Create a new TouchPoint + pub fn new(inner: impl HasTouchPointData + 'static) -> Self { + Self { + inner: Box::new(inner), + } + } + + /// A unique identifier for this touch point that will be the same for the duration of the touch + fn identifier(&self) -> i32 { + self.inner.identifier() + } + + /// the pressure of the touch + fn force(&self) -> f64 { + self.inner.force() + } + + /// the radius of the touch + fn radius(&self) -> ScreenPoint { + self.inner.radius() + } + + /// the rotation of the touch in degrees between 0 and 90 + fn rotation(&self) -> f64 { + self.inner.rotation() + } + + /// Downcast this event to a concrete event type + pub fn downcast(&self) -> Option<&T> { + self.inner.as_any().downcast_ref::() + } +} + +impl InteractionLocation for TouchPoint { + fn client_coordinates(&self) -> ClientPoint { + self.inner.client_coordinates() + } + + fn page_coordinates(&self) -> PagePoint { + self.inner.page_coordinates() + } + + fn screen_coordinates(&self) -> ScreenPoint { + self.inner.screen_coordinates() + } +} + +/// A trait for touch point data +pub trait HasTouchPointData: InteractionLocation + std::any::Any { + /// A unique identifier for this touch point that will be the same for the duration of the touch + fn identifier(&self) -> i32; + + /// the pressure of the touch + fn force(&self) -> f64; + + /// the radius of the touch + fn radius(&self) -> ScreenPoint; + + /// the rotation of the touch in degrees between 0 and 90 + fn rotation(&self) -> f64; + + /// return self as Any + fn as_any(&self) -> &dyn std::any::Any; +} + +#[cfg(feature = "serialize")] +/// A serialized version of TouchPoint +#[derive(serde::Serialize, serde::Deserialize, Debug, PartialEq, Clone)] +struct SerializedTouchPoint { + identifier: i32, + client_x: f64, + client_y: f64, + page_x: f64, + page_y: f64, + screen_x: f64, + screen_y: f64, + force: f64, + radius_x: f64, + radius_y: f64, + rotation_angle: f64, +} + +#[cfg(feature = "serialize")] +impl From<&TouchPoint> for SerializedTouchPoint { + fn from(point: &TouchPoint) -> Self { + let client_coordinates = point.client_coordinates(); + + let page_coordinates = point.page_coordinates(); + let screen_coordinates = point.screen_coordinates(); + Self { + identifier: point.identifier(), + client_x: client_coordinates.x, + client_y: client_coordinates.y, + page_x: page_coordinates.x, + page_y: page_coordinates.y, + screen_x: screen_coordinates.x, + screen_y: screen_coordinates.y, + force: point.force(), + radius_x: point.radius().x, + radius_y: point.radius().y, + rotation_angle: point.rotation(), + } + } +} + impl_event! { TouchData; /// touchstart diff --git a/packages/html/src/point_interaction.rs b/packages/html/src/point_interaction.rs index 9204f968e..9aa4e0f31 100644 --- a/packages/html/src/point_interaction.rs +++ b/packages/html/src/point_interaction.rs @@ -7,6 +7,18 @@ use crate::{ /// A interaction that contains data about the location of the event. pub trait InteractionLocation { + /// Gets the coordinates of the event relative to the browser viewport. + fn client_coordinates(&self) -> ClientPoint; + + /// Gets the coordinates of the event relative to the screen. + fn screen_coordinates(&self) -> ScreenPoint; + + /// Gets the coordinates of the event relative to the page. + fn page_coordinates(&self) -> PagePoint; +} + +/// A interaction that contains data about the location of the event. +pub trait InteractionElementOffset: InteractionLocation { /// Gets the coordinates of the event. fn coordinates(&self) -> Coordinates { Coordinates::new( @@ -17,21 +29,12 @@ pub trait InteractionLocation { ) } - /// Gets the coordinates of the event relative to the browser viewport. - fn client_coordinates(&self) -> ClientPoint; - - /// Gets the coordinates of the event relative to the screen. - fn screen_coordinates(&self) -> ScreenPoint; - /// Gets the coordinates of the event relative to the target element. fn element_coordinates(&self) -> ElementPoint; - - /// Gets the coordinates of the event relative to the page. - fn page_coordinates(&self) -> PagePoint; } /// A interaction that contains data about the pointer button(s) that triggered the event. -pub trait PointerInteraction: InteractionLocation + ModifiersInteraction { +pub trait PointerInteraction: InteractionElementOffset + ModifiersInteraction { /// Gets the button that triggered the event. fn trigger_button(&self) -> Option; @@ -198,11 +201,14 @@ impl InteractionLocation for SerializedPointInteraction { ScreenPoint::new(self.screen_x.into(), self.screen_y.into()) } - fn element_coordinates(&self) -> ElementPoint { - ElementPoint::new(self.offset_x.into(), self.offset_y.into()) - } - fn page_coordinates(&self) -> PagePoint { PagePoint::new(self.page_x.into(), self.page_y.into()) } } + +#[cfg(feature = "serialize")] +impl InteractionElementOffset for SerializedPointInteraction { + fn element_coordinates(&self) -> ElementPoint { + ElementPoint::new(self.offset_x.into(), self.offset_y.into()) + } +} diff --git a/packages/html/src/web_sys_bind/events.rs b/packages/html/src/web_sys_bind/events.rs index 148a30c88..055d1cc12 100644 --- a/packages/html/src/web_sys_bind/events.rs +++ b/packages/html/src/web_sys_bind/events.rs @@ -1,6 +1,6 @@ use crate::events::HasKeyboardData; use crate::events::{ - AnimationData, CompositionData, HasTouchData, KeyboardData, MouseData, PointerData, TouchData, + AnimationData, CompositionData, KeyboardData, MouseData, PointerData, TouchData, TransitionData, WheelData, }; use crate::geometry::{ClientPoint, ElementPoint, PagePoint, ScreenPoint}; @@ -10,8 +10,8 @@ use keyboard_types::{Code, Key, Modifiers}; use std::str::FromStr; use wasm_bindgen::{JsCast, JsValue}; use web_sys::{ - AnimationEvent, CompositionEvent, Event, KeyboardEvent, MouseEvent, PointerEvent, TouchEvent, - TransitionEvent, WheelEvent, + AnimationEvent, CompositionEvent, Event, KeyboardEvent, MouseEvent, PointerEvent, Touch, + TouchEvent, TransitionEvent, WheelEvent, }; macro_rules! uncheck_convert { @@ -69,6 +69,20 @@ impl HasKeyboardData for KeyboardEvent { Code::from_str(self.code().as_str()).unwrap_or(Code::Unidentified) } + fn location(&self) -> keyboard_types::Location { + decode_key_location(self.location() as usize) + } + + fn is_auto_repeating(&self) -> bool { + self.repeat() + } + + fn as_any(&self) -> &dyn std::any::Any { + self + } +} + +impl ModifiersInteraction for KeyboardEvent { fn modifiers(&self) -> Modifiers { let mut modifiers = Modifiers::empty(); @@ -87,18 +101,6 @@ impl HasKeyboardData for KeyboardEvent { modifiers } - - fn location(&self) -> keyboard_types::Location { - decode_key_location(self.location() as usize) - } - - fn is_auto_repeating(&self) -> bool { - self.repeat() - } - - fn as_any(&self) -> &dyn std::any::Any { - self - } } impl HasDragData for MouseEvent {} @@ -108,10 +110,6 @@ impl InteractionLocation for MouseEvent { ClientPoint::new(self.client_x().into(), self.client_y().into()) } - fn element_coordinates(&self) -> ElementPoint { - ElementPoint::new(self.offset_x().into(), self.offset_y().into()) - } - fn page_coordinates(&self) -> PagePoint { PagePoint::new(self.page_x().into(), self.page_y().into()) } @@ -121,6 +119,12 @@ impl InteractionLocation for MouseEvent { } } +impl InteractionElementOffset for MouseEvent { + fn element_coordinates(&self) -> ElementPoint { + ElementPoint::new(self.offset_x().into(), self.offset_y().into()) + } +} + impl ModifiersInteraction for MouseEvent { fn modifiers(&self) -> Modifiers { let mut modifiers = Modifiers::empty(); @@ -158,21 +162,36 @@ impl HasMouseData for MouseEvent { } } -impl HasTouchData for TouchEvent { - fn alt_key(&self) -> bool { - self.alt_key() - } +impl ModifiersInteraction for TouchEvent { + fn modifiers(&self) -> Modifiers { + let mut modifiers = Modifiers::empty(); - fn ctrl_key(&self) -> bool { - self.ctrl_key() - } + if self.alt_key() { + modifiers.insert(Modifiers::ALT); + } + if self.ctrl_key() { + modifiers.insert(Modifiers::CONTROL); + } + if self.meta_key() { + modifiers.insert(Modifiers::META); + } + if self.shift_key() { + modifiers.insert(Modifiers::SHIFT); + } - fn meta_key(&self) -> bool { - self.meta_key() + modifiers } +} - fn shift_key(&self) -> bool { - self.shift_key() +impl crate::events::HasTouchData for TouchEvent { + fn touches(&self) -> Vec { + let touches = TouchEvent::touches(self); + let mut result = Vec::with_capacity(touches.length() as usize); + for i in 0..touches.length() { + let touch = touches.get(i).unwrap(); + result.push(TouchPoint::new(touch)); + } + result } fn as_any(&self) -> &dyn std::any::Any { @@ -180,6 +199,42 @@ impl HasTouchData for TouchEvent { } } +impl HasTouchPointData for Touch { + fn identifier(&self) -> i32 { + self.identifier() + } + + fn radius(&self) -> ScreenPoint { + ScreenPoint::new(self.radius_x().into(), self.radius_y().into()) + } + + fn rotation(&self) -> f64 { + self.rotation_angle() as f64 + } + + fn force(&self) -> f64 { + self.force() as f64 + } + + fn as_any(&self) -> &dyn std::any::Any { + self + } +} + +impl InteractionLocation for Touch { + fn client_coordinates(&self) -> ClientPoint { + ClientPoint::new(self.client_x().into(), self.client_y().into()) + } + + fn screen_coordinates(&self) -> ScreenPoint { + ScreenPoint::new(self.screen_x().into(), self.screen_y().into()) + } + + fn page_coordinates(&self) -> PagePoint { + PagePoint::new(self.page_x().into(), self.page_y().into()) + } +} + impl HasPointerData for PointerEvent { fn pointer_id(&self) -> i32 { self.pointer_id() @@ -235,15 +290,17 @@ impl InteractionLocation for PointerEvent { ScreenPoint::new(self.screen_x().into(), self.screen_y().into()) } - fn element_coordinates(&self) -> ElementPoint { - ElementPoint::new(self.offset_x().into(), self.offset_y().into()) - } - fn page_coordinates(&self) -> PagePoint { PagePoint::new(self.page_x().into(), self.page_y().into()) } } +impl InteractionElementOffset for PointerEvent { + fn element_coordinates(&self) -> ElementPoint { + ElementPoint::new(self.offset_x().into(), self.offset_y().into()) + } +} + impl ModifiersInteraction for PointerEvent { fn modifiers(&self) -> Modifiers { let mut modifiers = Modifiers::empty(); From 27f4b3f3451c1550e2df376fbf80559c024bb8ee Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Tue, 12 Sep 2023 17:45:07 -0500 Subject: [PATCH 095/447] add touches_changed and target_touches --- packages/html/src/events/touch.rs | 103 ++++++++++++++++++++++- packages/html/src/web_sys_bind/events.rs | 20 +++++ 2 files changed, 121 insertions(+), 2 deletions(-) diff --git a/packages/html/src/events/touch.rs b/packages/html/src/events/touch.rs index 83fdbb0b4..b30ace17c 100644 --- a/packages/html/src/events/touch.rs +++ b/packages/html/src/events/touch.rs @@ -19,6 +19,9 @@ impl std::fmt::Debug for TouchData { fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { f.debug_struct("TouchData") .field("modifiers", &self.modifiers()) + .field("touches", &self.touches()) + .field("touches_changed", &self.touches_changed()) + .field("target_touches", &self.target_touches()) .finish() } } @@ -42,6 +45,16 @@ impl TouchData { self.inner.touches() } + /// Get the touches that have changed since the last event + pub fn touches_changed(&self) -> Vec { + self.inner.touches_changed() + } + + /// Get the touches that started and stayed on the element that triggered this event + pub fn target_touches(&self) -> Vec { + self.inner.target_touches() + } + /// Downcast this event to a concrete event type pub fn downcast(&self) -> Option<&T> { self.inner.as_any().downcast_ref::() @@ -63,6 +76,8 @@ pub struct SerializedTouchData { meta_key: bool, shift_key: bool, touches: Vec, + changed_touches: Vec, + target_touches: Vec, } #[cfg(feature = "serialize")] @@ -75,6 +90,8 @@ impl From<&TouchData> for SerializedTouchData { meta_key: modifiers.contains(Modifiers::META), shift_key: modifiers.contains(Modifiers::SHIFT), touches: data.touches().iter().map(|t| t.into()).collect(), + changed_touches: data.touches_changed().iter().map(|t| t.into()).collect(), + target_touches: data.target_touches().iter().map(|t| t.into()).collect(), } } } @@ -102,7 +119,23 @@ impl ModifiersInteraction for SerializedTouchData { #[cfg(feature = "serialize")] impl HasTouchData for SerializedTouchData { fn touches(&self) -> Vec { - Vec::new() + self.touches.clone().into_iter().map(Into::into).collect() + } + + fn touches_changed(&self) -> Vec { + self.changed_touches + .clone() + .into_iter() + .map(Into::into) + .collect() + } + + fn target_touches(&self) -> Vec { + self.target_touches + .clone() + .into_iter() + .map(Into::into) + .collect() } fn as_any(&self) -> &dyn std::any::Any { @@ -128,9 +161,15 @@ impl<'de> serde::Deserialize<'de> for TouchData { } pub trait HasTouchData: ModifiersInteraction + std::any::Any { - /// Get the pointers that are currently down + /// Get the touches that are currently down fn touches(&self) -> Vec; + /// Get the touches that have changed since the last event + fn touches_changed(&self) -> Vec; + + /// Get the touches that started and stayed on the element that triggered this event + fn target_touches(&self) -> Vec; + /// return self as Any fn as_any(&self) -> &dyn std::any::Any; } @@ -179,6 +218,20 @@ impl TouchPoint { } } +impl std::fmt::Debug for TouchPoint { + fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { + f.debug_struct("TouchPoint") + .field("client_coordinates", &self.client_coordinates()) + .field("page_coordinates", &self.page_coordinates()) + .field("screen_coordinates", &self.screen_coordinates()) + .field("identifier", &self.identifier()) + .field("force", &self.force()) + .field("radius", &self.radius()) + .field("rotation", &self.rotation()) + .finish() + } +} + impl InteractionLocation for TouchPoint { fn client_coordinates(&self) -> ClientPoint { self.inner.client_coordinates() @@ -251,6 +304,52 @@ impl From<&TouchPoint> for SerializedTouchPoint { } } +#[cfg(feature = "serialize")] +impl HasTouchPointData for SerializedTouchPoint { + /// A unique identifier for this touch point that will be the same for the duration of the touch + fn identifier(&self) -> i32 { + self.identifier + } + + /// the pressure of the touch + fn force(&self) -> f64 { + self.force + } + + /// the radius of the touch + fn radius(&self) -> ScreenPoint { + ScreenPoint::new(self.radius_x, self.radius_y) + } + + /// the rotation of the touch in degrees between 0 and 90 + fn rotation(&self) -> f64 { + self.rotation_angle + } + + /// return self as Any + fn as_any(&self) -> &dyn std::any::Any { + self + } +} + +#[cfg(feature = "serialize")] +impl InteractionLocation for SerializedTouchPoint { + /// Gets the coordinates of the event relative to the browser viewport. + fn client_coordinates(&self) -> ClientPoint { + ClientPoint::new(self.client_x, self.client_y) + } + + /// Gets the coordinates of the event relative to the screen. + fn screen_coordinates(&self) -> ScreenPoint { + ScreenPoint::new(self.screen_x, self.screen_y) + } + + /// Gets the coordinates of the event relative to the page. + fn page_coordinates(&self) -> PagePoint { + PagePoint::new(self.page_x, self.page_y) + } +} + impl_event! { TouchData; /// touchstart diff --git a/packages/html/src/web_sys_bind/events.rs b/packages/html/src/web_sys_bind/events.rs index 055d1cc12..b1e6c5341 100644 --- a/packages/html/src/web_sys_bind/events.rs +++ b/packages/html/src/web_sys_bind/events.rs @@ -194,6 +194,26 @@ impl crate::events::HasTouchData for TouchEvent { result } + fn touches_changed(&self) -> Vec { + let touches = self.changed_touches(); + let mut result = Vec::with_capacity(touches.length() as usize); + for i in 0..touches.length() { + let touch = touches.get(i).unwrap(); + result.push(TouchPoint::new(touch)); + } + result + } + + fn target_touches(&self) -> Vec { + let touches = self.target_touches(); + let mut result = Vec::with_capacity(touches.length() as usize); + for i in 0..touches.length() { + let touch = touches.get(i).unwrap(); + result.push(TouchPoint::new(touch)); + } + result + } + fn as_any(&self) -> &dyn std::any::Any { self } From fc5c53810b363c2f96c2ad7748e7eecfa79f695d Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Wed, 13 Sep 2023 10:08:06 -0500 Subject: [PATCH 096/447] fix rink imports --- packages/rink/src/widgets/button.rs | 2 +- packages/rink/src/widgets/checkbox.rs | 2 +- packages/rink/src/widgets/slider.rs | 3 ++- packages/rink/src/widgets/text_like.rs | 3 ++- 4 files changed, 6 insertions(+), 4 deletions(-) diff --git a/packages/rink/src/widgets/button.rs b/packages/rink/src/widgets/button.rs index d07dd79f0..25f0e07ef 100644 --- a/packages/rink/src/widgets/button.rs +++ b/packages/rink/src/widgets/button.rs @@ -11,7 +11,7 @@ use dioxus_native_core::{ }; use shipyard::UniqueView; -use crate::FormData; +use crate::hooks::FormData; use super::{RinkWidget, WidgetContext}; diff --git a/packages/rink/src/widgets/checkbox.rs b/packages/rink/src/widgets/checkbox.rs index fe878e5b8..a8a8253a0 100644 --- a/packages/rink/src/widgets/checkbox.rs +++ b/packages/rink/src/widgets/checkbox.rs @@ -11,7 +11,7 @@ use dioxus_native_core::{ }; use shipyard::UniqueView; -use crate::FormData; +use crate::hooks::FormData; use super::{RinkWidget, WidgetContext}; diff --git a/packages/rink/src/widgets/slider.rs b/packages/rink/src/widgets/slider.rs index b3d6d24da..bb0639610 100644 --- a/packages/rink/src/widgets/slider.rs +++ b/packages/rink/src/widgets/slider.rs @@ -15,7 +15,8 @@ use dioxus_native_core::{ use shipyard::UniqueView; use super::{RinkWidget, WidgetContext}; -use crate::{query::get_layout, Event, EventData, FormData, Query}; +use crate::hooks::FormData; +use crate::{query::get_layout, Event, EventData, Query}; #[derive(Debug)] pub(crate) struct Slider { diff --git a/packages/rink/src/widgets/text_like.rs b/packages/rink/src/widgets/text_like.rs index 3231a9e29..770dd9d33 100644 --- a/packages/rink/src/widgets/text_like.rs +++ b/packages/rink/src/widgets/text_like.rs @@ -17,7 +17,8 @@ use dioxus_native_core::{ use shipyard::UniqueView; use taffy::geometry::Point; -use crate::{query::get_layout, Event, EventData, FormData, Query}; +use crate::hooks::FormData; +use crate::{query::get_layout, Event, EventData, Query}; use super::{RinkWidget, WidgetContext}; From 8c47dfaf78a734460d5335897fb7e68a65bb4144 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Thu, 14 Sep 2023 14:08:39 -0500 Subject: [PATCH 097/447] clean up attribute parsing --- packages/autofmt/src/element.rs | 56 +++++----- packages/autofmt/src/writer.rs | 32 +++--- packages/rsx-rosetta/src/lib.rs | 26 +++-- packages/rsx/Cargo.toml | 2 + packages/rsx/src/attribute.rs | 165 ++++++++++++++++++++++++++++ packages/rsx/src/element.rs | 187 +++++--------------------------- packages/rsx/src/errors.rs | 4 +- packages/rsx/src/lib.rs | 67 ++++-------- 8 files changed, 278 insertions(+), 261 deletions(-) create mode 100644 packages/rsx/src/attribute.rs diff --git a/packages/autofmt/src/element.rs b/packages/autofmt/src/element.rs index dbc336401..971f4447e 100644 --- a/packages/autofmt/src/element.rs +++ b/packages/autofmt/src/element.rs @@ -209,12 +209,25 @@ impl Writer<'_> { Ok(()) } - fn write_attribute(&mut self, attr: &ElementAttrNamed) -> Result { - match &attr.attr { - ElementAttr::AttrText { name, value } => { - write!(self.out, "{name}: {value}", value = ifmt_to_string(value))?; + fn write_attribute_name(&mut self, attr: &ElementAttrName) -> Result { + match attr { + ElementAttrName::BuiltIn(name) => { + write!(self.out, "{}", name)?; } - ElementAttr::AttrExpression { name, value } => { + ElementAttrName::Custom(name) => { + write!(self.out, "\"{}\"", name.to_token_stream())?; + } + } + + Ok(()) + } + + fn write_attribute_value(&mut self, value: &ElementAttrValue) -> Result { + match value { + ElementAttrValue::AttrLiteral(value) => { + write!(self.out, "{value}", value = ifmt_to_string(value))?; + } + ElementAttrValue::AttrExpr(value) => { let out = prettyplease::unparse_expr(value); let mut lines = out.split('\n').peekable(); let first = lines.next().unwrap(); @@ -222,9 +235,9 @@ impl Writer<'_> { // a one-liner for whatever reason // Does not need a new line if lines.peek().is_none() { - write!(self.out, "{name}: {first}")?; + write!(self.out, "{first}")?; } else { - writeln!(self.out, "{name}: {first}")?; + writeln!(self.out, "{first}")?; while let Some(line) = lines.next() { self.out.indented_tab()?; @@ -237,22 +250,7 @@ impl Writer<'_> { } } } - - ElementAttr::CustomAttrText { name, value } => { - write!( - self.out, - "{name}: {value}", - name = name.to_token_stream(), - value = ifmt_to_string(value) - )?; - } - - ElementAttr::CustomAttrExpression { name, value } => { - let out = prettyplease::unparse_expr(value); - write!(self.out, "{}: {}", name.to_token_stream(), out)?; - } - - ElementAttr::EventTokens { name, tokens } => { + ElementAttrValue::EventTokens(tokens) => { let out = self.retrieve_formatted_expr(tokens).to_string(); let mut lines = out.split('\n').peekable(); @@ -261,9 +259,9 @@ impl Writer<'_> { // a one-liner for whatever reason // Does not need a new line if lines.peek().is_none() { - write!(self.out, "{name}: {first}")?; + write!(self.out, "{first}")?; } else { - writeln!(self.out, "{name}: {first}")?; + writeln!(self.out, "{first}")?; while let Some(line) = lines.next() { self.out.indented_tab()?; @@ -281,6 +279,14 @@ impl Writer<'_> { Ok(()) } + fn write_attribute(&mut self, attr: &ElementAttrNamed) -> Result { + self.write_attribute_name(&attr.attr.name)?; + write!(self.out, ": ")?; + self.write_attribute_value(&attr.attr.value)?; + + Ok(()) + } + // make sure the comments are actually relevant to this element. // test by making sure this element is the primary element on this line pub fn current_span_is_primary(&self, location: Span) -> bool { diff --git a/packages/autofmt/src/writer.rs b/packages/autofmt/src/writer.rs index 59f135592..c96e96c93 100644 --- a/packages/autofmt/src/writer.rs +++ b/packages/autofmt/src/writer.rs @@ -1,4 +1,4 @@ -use dioxus_rsx::{BodyNode, ElementAttr, ElementAttrNamed, ForLoop}; +use dioxus_rsx::{BodyNode, ElementAttrNamed, ElementAttrValue, ForLoop}; use proc_macro2::{LineColumn, Span}; use quote::ToTokens; use std::{ @@ -146,20 +146,18 @@ impl<'a> Writer<'a> { } } - total += match &attr.attr { - ElementAttr::AttrText { value, name } => { - ifmt_to_string(value).len() + name.span().line_length() + 6 + total += match &attr.attr.name { + dioxus_rsx::ElementAttrName::BuiltIn(name) => { + let name = name.to_string(); + name.len() } - ElementAttr::AttrExpression { name, value } => { - value.span().line_length() + name.span().line_length() + 6 - } - ElementAttr::CustomAttrText { value, name } => { - ifmt_to_string(value).len() + name.to_token_stream().to_string().len() + 6 - } - ElementAttr::CustomAttrExpression { name, value } => { - name.to_token_stream().to_string().len() + value.span().line_length() + 6 - } - ElementAttr::EventTokens { tokens, name } => { + dioxus_rsx::ElementAttrName::Custom(name) => name.value().len() + 2, + }; + + total += match &attr.attr.value { + ElementAttrValue::AttrLiteral(lit) => ifmt_to_string(lit).len(), + ElementAttrValue::AttrExpr(expr) => expr.span().line_length(), + ElementAttrValue::EventTokens(tokens) => { let location = Location::new(tokens.span().start()); let len = if let std::collections::hash_map::Entry::Vacant(e) = @@ -177,9 +175,11 @@ impl<'a> Writer<'a> { self.cached_formats[&location].len() }; - len + name.span().line_length() + 6 + len } }; + + total += 6; } total @@ -218,7 +218,7 @@ impl<'a> Writer<'a> { } } -trait SpanLength { +pub(crate) trait SpanLength { fn line_length(&self) -> usize; } impl SpanLength for Span { diff --git a/packages/rsx-rosetta/src/lib.rs b/packages/rsx-rosetta/src/lib.rs index 2ceb5f038..19b1d5375 100644 --- a/packages/rsx-rosetta/src/lib.rs +++ b/packages/rsx-rosetta/src/lib.rs @@ -36,9 +36,11 @@ pub fn rsx_node_from_html(node: &Node) -> Option { ElementAttrNamed { el_name: el_name.clone(), - attr: ElementAttr::AttrText { - value: ifmt_from_text(value.as_deref().unwrap_or("false")), - name: ident, + attr: ElementAttr { + value: dioxus_rsx::ElementAttrValue::AttrLiteral(ifmt_from_text( + value.as_deref().unwrap_or("false"), + )), + name: dioxus_rsx::ElementAttrName::BuiltIn(ident), }, } }) @@ -48,9 +50,12 @@ pub fn rsx_node_from_html(node: &Node) -> Option { if !class.is_empty() { attributes.push(ElementAttrNamed { el_name: el_name.clone(), - attr: ElementAttr::AttrText { - name: Ident::new("class", Span::call_site()), - value: ifmt_from_text(&class), + attr: ElementAttr { + name: dioxus_rsx::ElementAttrName::BuiltIn(Ident::new( + "class", + Span::call_site(), + )), + value: dioxus_rsx::ElementAttrValue::AttrLiteral(ifmt_from_text(&class)), }, }); } @@ -58,9 +63,12 @@ pub fn rsx_node_from_html(node: &Node) -> Option { if let Some(id) = &el.id { attributes.push(ElementAttrNamed { el_name: el_name.clone(), - attr: ElementAttr::AttrText { - name: Ident::new("id", Span::call_site()), - value: ifmt_from_text(id), + attr: ElementAttr { + name: dioxus_rsx::ElementAttrName::BuiltIn(Ident::new( + "id", + Span::call_site(), + )), + value: dioxus_rsx::ElementAttrValue::AttrLiteral(ifmt_from_text(id)), }, }); } diff --git a/packages/rsx/Cargo.toml b/packages/rsx/Cargo.toml index bc866acb7..0b7b23e98 100644 --- a/packages/rsx/Cargo.toml +++ b/packages/rsx/Cargo.toml @@ -22,5 +22,7 @@ internment = { version = "0.7.0", optional = true } krates = { version = "0.12.6", optional = true } [features] +default = ["html"] hot_reload = ["krates", "internment"] serde = ["dep:serde"] +html = [] diff --git a/packages/rsx/src/attribute.rs b/packages/rsx/src/attribute.rs new file mode 100644 index 000000000..76cf55a01 --- /dev/null +++ b/packages/rsx/src/attribute.rs @@ -0,0 +1,165 @@ +use std::fmt::{Display, Formatter}; + +use super::*; + +use proc_macro2::{Span, TokenStream as TokenStream2}; +use quote::{quote, ToTokens, TokenStreamExt}; +use syn::{ + parse::{Parse, ParseStream}, + punctuated::Punctuated, + spanned::Spanned, + Expr, Ident, LitStr, Result, Token, +}; + +#[derive(PartialEq, Eq, Clone, Debug, Hash)] +pub struct ElementAttrNamed { + pub el_name: ElementName, + pub attr: ElementAttr, +} + +impl ElementAttrNamed { + pub(crate) fn try_combine(&self, other: Self) -> Option { + if self.el_name == other.el_name && self.attr.name == other.attr.name { + if let Some(separator) = todo!() { + return Some(ElementAttrNamed { + el_name: self.el_name.clone(), + attr: ElementAttr { + name: self.attr.name.clone(), + value: self.attr.value.combine(separator, other.attr.value), + }, + }); + } + } + None + } +} + +impl ToTokens for ElementAttrNamed { + fn to_tokens(&self, tokens: &mut TokenStream2) { + let ElementAttrNamed { el_name, attr } = self; + + let ns = |name| match el_name { + ElementName::Ident(i) => quote! { dioxus_elements::#i::#name.1 }, + ElementName::Custom(_) => quote! { None }, + }; + let volitile = |name| match el_name { + ElementName::Ident(_) => quote! { #el_name::#name.2 }, + ElementName::Custom(_) => quote! { false }, + }; + let attribute = |name: &ElementAttrName| match name { + ElementAttrName::BuiltIn(name) => match el_name { + ElementName::Ident(_) => quote! { #el_name::#name.0 }, + ElementName::Custom(_) => { + let as_string = name.to_string(); + quote!(#as_string) + } + }, + ElementAttrName::Custom(s) => quote! { #s }, + }; + + let attribute = { + match &attr.value { + ElementAttrValue::AttrLiteral(_) | ElementAttrValue::AttrExpr(_) => { + let name = &self.attr.name; + let ns = ns(name); + let volitile = volitile(name); + let attribute = attribute(name); + let value = match &self.attr.value { + ElementAttrValue::AttrLiteral(lit) => quote! { #lit }, + ElementAttrValue::AttrExpr(expr) => quote! { #expr }, + _ => unreachable!(), + }; + quote! { + __cx.attr( + #attribute, + #value, + #ns, + #volitile + ) + } + } + ElementAttrValue::EventTokens(tokens) => match &self.attr.name { + ElementAttrName::BuiltIn(name) => { + quote! { + dioxus_elements::events::#name(__cx, #tokens) + } + } + ElementAttrName::Custom(_) => todo!(), + }, + } + }; + + tokens.append_all(attribute); + } +} + +#[derive(PartialEq, Eq, Clone, Debug, Hash)] +pub struct ElementAttr { + pub name: ElementAttrName, + pub value: ElementAttrValue, +} + +#[derive(PartialEq, Eq, Clone, Debug, Hash)] +pub enum ElementAttrValue { + /// attribute: "value" + AttrLiteral(IfmtInput), + /// attribute: true + AttrExpr(Expr), + /// onclick: move |_| {} + EventTokens(Expr), +} + +impl ElementAttrValue { + fn combine(&self, separator: &str, other: Self) -> Self { + todo!() + } +} + +#[derive(PartialEq, Eq, Clone, Debug, Hash)] +pub enum ElementAttrName { + BuiltIn(Ident), + Custom(LitStr), +} + +impl ElementAttrName { + pub fn start(&self) -> Span { + match self { + ElementAttrName::BuiltIn(i) => i.span(), + ElementAttrName::Custom(s) => s.span(), + } + } +} + +impl ToTokens for ElementAttrName { + fn to_tokens(&self, tokens: &mut TokenStream2) { + match self { + ElementAttrName::BuiltIn(i) => tokens.append_all(quote! { #i }), + ElementAttrName::Custom(s) => tokens.append_all(quote! { #s }), + } + } +} + +impl Display for ElementAttrName { + fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result { + match self { + ElementAttrName::BuiltIn(i) => write!(f, "{}", i), + ElementAttrName::Custom(s) => write!(f, "{}", s.value()), + } + } +} + +impl ElementAttr { + pub fn start(&self) -> Span { + self.name.start() + } + + pub fn is_expr(&self) -> bool { + matches!( + self, + ElementAttr { + value: ElementAttrValue::AttrExpr(_) | ElementAttrValue::EventTokens(_), + .. + } + ) + } +} diff --git a/packages/rsx/src/element.rs b/packages/rsx/src/element.rs index 8f45d91ff..19557edd2 100644 --- a/packages/rsx/src/element.rs +++ b/packages/rsx/src/element.rs @@ -8,7 +8,7 @@ use syn::{ parse::{Parse, ParseBuffer, ParseStream}, punctuated::Punctuated, spanned::Spanned, - Error, Expr, Ident, LitStr, Result, Token, + Expr, Ident, LitStr, Result, Token, }; // ======================================= @@ -34,7 +34,6 @@ impl Parse for Element { let mut attributes: Vec = vec![]; let mut children: Vec = vec![]; let mut key = None; - let mut _el_ref = None; // parse fields with commas // break when we don't get this pattern anymore @@ -49,19 +48,20 @@ impl Parse for Element { content.parse::()?; - if content.peek(LitStr) { + let value = if content.peek(LitStr) { let value = content.parse()?; - attributes.push(ElementAttrNamed { - el_name: el_name.clone(), - attr: ElementAttr::CustomAttrText { name, value }, - }); + ElementAttrValue::AttrLiteral(value) } else { let value = content.parse::()?; - attributes.push(ElementAttrNamed { - el_name: el_name.clone(), - attr: ElementAttr::CustomAttrExpression { name, value }, - }); - } + ElementAttrValue::AttrExpr(value) + }; + attributes.push(ElementAttrNamed { + el_name: el_name.clone(), + attr: ElementAttr { + name: ElementAttrName::Custom(name), + value, + }, + }); if content.is_empty() { break; @@ -86,9 +86,9 @@ impl Parse for Element { if name_str.starts_with("on") { attributes.push(ElementAttrNamed { el_name: el_name.clone(), - attr: ElementAttr::EventTokens { - name, - tokens: content.parse()?, + attr: ElementAttr { + name: ElementAttrName::BuiltIn(name), + value: ElementAttrValue::EventTokens(content.parse()?), }, }); } else { @@ -96,26 +96,21 @@ impl Parse for Element { "key" => { key = Some(content.parse()?); } - "classes" => todo!("custom class list not supported yet"), - // "namespace" => todo!("custom namespace not supported yet"), - "node_ref" => { - _el_ref = Some(content.parse::()?); - } _ => { if content.peek(LitStr) { attributes.push(ElementAttrNamed { el_name: el_name.clone(), - attr: ElementAttr::AttrText { - name, - value: content.parse()?, + attr: ElementAttr { + name: ElementAttrName::BuiltIn(name), + value: ElementAttrValue::AttrLiteral(content.parse()?), }, }); } else { attributes.push(ElementAttrNamed { el_name: el_name.clone(), - attr: ElementAttr::AttrExpression { - name, - value: content.parse()?, + attr: ElementAttr { + name: ElementAttrName::BuiltIn(name), + value: ElementAttrValue::AttrExpr(content.parse()?), }, }); } @@ -137,6 +132,9 @@ impl Parse for Element { break; } + // Deduplicate any attributes that can be combined + // For example, if there are two `class` attributes, combine them into one + while !content.is_empty() { if (content.peek(LitStr) && content.peek2(Token![:])) && !content.peek3(Token![:]) { attr_after_element!(content.span()); @@ -177,12 +175,12 @@ impl ToTokens for Element { let listeners = self .attributes .iter() - .filter(|f| matches!(f.attr, ElementAttr::EventTokens { .. })); + .filter(|f| matches!(f.attr.value, ElementAttrValue::EventTokens { .. })); let attr = self .attributes .iter() - .filter(|f| !matches!(f.attr, ElementAttr::EventTokens { .. })); + .filter(|f| !matches!(f.attr.value, ElementAttrValue::EventTokens { .. })); tokens.append_all(quote! { __cx.element( @@ -264,136 +262,3 @@ impl ToTokens for ElementName { } } } - -#[derive(PartialEq, Eq, Clone, Debug, Hash)] -pub enum ElementAttr { - /// `attribute: "value"` - AttrText { name: Ident, value: IfmtInput }, - - /// `attribute: true` - AttrExpression { name: Ident, value: Expr }, - - /// `"attribute": "value"` - CustomAttrText { name: LitStr, value: IfmtInput }, - - /// `"attribute": true` - CustomAttrExpression { name: LitStr, value: Expr }, - - // /// onclick: move |_| {} - // EventClosure { name: Ident, closure: ExprClosure }, - /// onclick: {} - EventTokens { name: Ident, tokens: Expr }, -} - -impl ElementAttr { - pub fn start(&self) -> Span { - match self { - ElementAttr::AttrText { name, .. } => name.span(), - ElementAttr::AttrExpression { name, .. } => name.span(), - ElementAttr::CustomAttrText { name, .. } => name.span(), - ElementAttr::CustomAttrExpression { name, .. } => name.span(), - ElementAttr::EventTokens { name, .. } => name.span(), - } - } - - pub fn is_expr(&self) -> bool { - matches!( - self, - ElementAttr::AttrExpression { .. } - | ElementAttr::CustomAttrExpression { .. } - | ElementAttr::EventTokens { .. } - ) - } -} - -#[derive(PartialEq, Eq, Clone, Debug, Hash)] -pub struct ElementAttrNamed { - pub el_name: ElementName, - pub attr: ElementAttr, -} - -impl ToTokens for ElementAttrNamed { - fn to_tokens(&self, tokens: &mut TokenStream2) { - let ElementAttrNamed { el_name, attr } = self; - - let ns = |name| match el_name { - ElementName::Ident(i) => quote! { dioxus_elements::#i::#name.1 }, - ElementName::Custom(_) => quote! { None }, - }; - let volitile = |name| match el_name { - ElementName::Ident(_) => quote! { #el_name::#name.2 }, - ElementName::Custom(_) => quote! { false }, - }; - let attribute = |name: &Ident| match el_name { - ElementName::Ident(_) => quote! { #el_name::#name.0 }, - ElementName::Custom(_) => { - let as_string = name.to_string(); - quote!(#as_string) - } - }; - - let attribute = match attr { - ElementAttr::AttrText { name, value } => { - let ns = ns(name); - let volitile = volitile(name); - let attribute = attribute(name); - quote! { - __cx.attr( - #attribute, - #value, - #ns, - #volitile - ) - } - } - ElementAttr::AttrExpression { name, value } => { - let ns = ns(name); - let volitile = volitile(name); - let attribute = attribute(name); - quote! { - __cx.attr( - #attribute, - #value, - #ns, - #volitile - ) - } - } - ElementAttr::CustomAttrText { name, value } => { - quote! { - __cx.attr( - #name, - #value, - None, - false - ) - } - } - ElementAttr::CustomAttrExpression { name, value } => { - quote! { - __cx.attr( - #name, - #value, - None, - false - ) - } - } - ElementAttr::EventTokens { name, tokens } => { - quote! { - dioxus_elements::events::#name(__cx, #tokens) - } - } - }; - - tokens.append_all(attribute); - } -} - -// ::dioxus::core::Attribute { -// name: stringify!(#name), -// namespace: None, -// volatile: false, -// mounted_node: Default::default(), -// value: ::dioxus::core::AttributeValue::Text(#value), -// } diff --git a/packages/rsx/src/errors.rs b/packages/rsx/src/errors.rs index f89b28500..6cc34e1fb 100644 --- a/packages/rsx/src/errors.rs +++ b/packages/rsx/src/errors.rs @@ -1,12 +1,12 @@ macro_rules! missing_trailing_comma { ($span:expr) => { - return Err(Error::new($span, "missing trailing comma")); + return Err(syn::Error::new($span, "missing trailing comma")); }; } macro_rules! attr_after_element { ($span:expr) => { - return Err(Error::new($span, "expected element\n = help move the attribute above all the children and text elements")); + return Err(syn::Error::new($span, "expected element\n = help move the attribute above all the children and text elements")); }; } diff --git a/packages/rsx/src/lib.rs b/packages/rsx/src/lib.rs index f52ecad0e..ff00fd87e 100644 --- a/packages/rsx/src/lib.rs +++ b/packages/rsx/src/lib.rs @@ -13,6 +13,7 @@ #[macro_use] mod errors; +mod attribute; mod component; mod element; #[cfg(feature = "hot_reload")] @@ -23,6 +24,7 @@ mod node; use std::{fmt::Debug, hash::Hash}; // Re-export the namespaces into each other +pub use attribute::*; pub use component::*; #[cfg(feature = "hot_reload")] use dioxus_core::{Template, TemplateAttribute, TemplateNode}; @@ -307,16 +309,9 @@ impl DynamicMapping { match node { BodyNode::Element(el) => { for attr in el.attributes { - match &attr.attr { - ElementAttr::CustomAttrText { value, .. } - | ElementAttr::AttrText { value, .. } - if value.is_static() => {} - - ElementAttr::AttrExpression { .. } - | ElementAttr::AttrText { .. } - | ElementAttr::CustomAttrText { .. } - | ElementAttr::CustomAttrExpression { .. } - | ElementAttr::EventTokens { .. } => { + match &attr.attr.value { + ElementAttrValue::AttrLiteral(input) if input.is_static() => {} + _ => { self.insert_attribute(attr.attr); } } @@ -365,9 +360,10 @@ impl<'a> DynamicContext<'a> { let mut static_attrs = Vec::new(); for attr in &el.attributes { - match &attr.attr { - ElementAttr::AttrText { name, value } if value.is_static() => { + match &attr.attr.value { + ElementAttrValue::AttrLiteral(value) if value.is_static() => { let value = value.source.as_ref().unwrap(); + let name = &attr.attr.name; let attribute_name_rust = name.to_string(); let (name, namespace) = Ctx::map_attribute(&element_name_rust, &attribute_name_rust) @@ -379,20 +375,7 @@ impl<'a> DynamicContext<'a> { }) } - ElementAttr::CustomAttrText { name, value } if value.is_static() => { - let value = value.source.as_ref().unwrap(); - static_attrs.push(TemplateAttribute::Static { - name: intern(name.value().as_str()), - namespace: None, - value: intern(value.value().as_str()), - }) - } - - ElementAttr::AttrExpression { .. } - | ElementAttr::AttrText { .. } - | ElementAttr::CustomAttrText { .. } - | ElementAttr::CustomAttrExpression { .. } - | ElementAttr::EventTokens { .. } => { + _ => { let idx = match mapping { Some(mapping) => mapping.get_attribute_idx(&attr.attr)?, None => self.dynamic_attributes.len(), @@ -464,10 +447,16 @@ impl<'a> DynamicContext<'a> { ElementName::Ident(i) => quote! { dioxus_elements::#i::#name }, ElementName::Custom(_) => quote! { None }, }; - let static_attrs = el.attributes.iter().map(|attr| match &attr.attr { - ElementAttr::AttrText { name, value } if value.is_static() => { + let static_attrs = el.attributes.iter().map(|attr| match &attr.attr.value { + ElementAttrValue::AttrLiteral(value) if value.is_static() => { let value = value.to_static().unwrap(); - let ns = ns(quote!(#name.1)); + let ns = { + match &attr.attr.name { + ElementAttrName::BuiltIn(name) => ns(quote!(#name.1)), + ElementAttrName::Custom(_) => quote!(None), + } + }; + let name = &attr.attr.name; let name = match el_name { ElementName::Ident(_) => quote! { #el_name::#name.0 }, ElementName::Custom(_) => { @@ -487,25 +476,7 @@ impl<'a> DynamicContext<'a> { } } - ElementAttr::CustomAttrText { name, value } if value.is_static() => { - let value = value.to_static().unwrap(); - quote! { - ::dioxus::core::TemplateAttribute::Static { - name: #name, - namespace: None, - value: #value, - - // todo: we don't diff these so we never apply the volatile flag - // volatile: dioxus_elements::#el_name::#name.2, - } - } - } - - ElementAttr::AttrExpression { .. } - | ElementAttr::AttrText { .. } - | ElementAttr::CustomAttrText { .. } - | ElementAttr::CustomAttrExpression { .. } - | ElementAttr::EventTokens { .. } => { + _ => { let ct = self.dynamic_attributes.len(); self.dynamic_attributes.push(attr); self.attr_paths.push(self.current_path.clone()); From 30b124189cabb04e7f723296e6436c20822a0024 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Thu, 14 Sep 2023 15:56:17 -0500 Subject: [PATCH 098/447] fix raw attribute names --- packages/rsx/src/lib.rs | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/packages/rsx/src/lib.rs b/packages/rsx/src/lib.rs index ff00fd87e..ea24a779f 100644 --- a/packages/rsx/src/lib.rs +++ b/packages/rsx/src/lib.rs @@ -457,9 +457,11 @@ impl<'a> DynamicContext<'a> { } }; let name = &attr.attr.name; - let name = match el_name { - ElementName::Ident(_) => quote! { #el_name::#name.0 }, - ElementName::Custom(_) => { + let name = match (el_name, name) { + (ElementName::Ident(_), ElementAttrName::BuiltIn(_)) => { + quote! { #el_name::#name.0 } + } + _ => { let as_string = name.to_string(); quote! { #as_string } } From be4b0c801a9df54abc32d34dafdf3f9f51560338 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Thu, 14 Sep 2023 16:10:48 -0500 Subject: [PATCH 099/447] fix raw attributes with dynamic values --- packages/rsx/src/attribute.rs | 23 +++++++++++------------ 1 file changed, 11 insertions(+), 12 deletions(-) diff --git a/packages/rsx/src/attribute.rs b/packages/rsx/src/attribute.rs index 76cf55a01..ea9d79263 100644 --- a/packages/rsx/src/attribute.rs +++ b/packages/rsx/src/attribute.rs @@ -4,12 +4,7 @@ use super::*; use proc_macro2::{Span, TokenStream as TokenStream2}; use quote::{quote, ToTokens, TokenStreamExt}; -use syn::{ - parse::{Parse, ParseStream}, - punctuated::Punctuated, - spanned::Spanned, - Expr, Ident, LitStr, Result, Token, -}; +use syn::{Expr, Ident, LitStr}; #[derive(PartialEq, Eq, Clone, Debug, Hash)] pub struct ElementAttrNamed { @@ -38,13 +33,17 @@ impl ToTokens for ElementAttrNamed { fn to_tokens(&self, tokens: &mut TokenStream2) { let ElementAttrNamed { el_name, attr } = self; - let ns = |name| match el_name { - ElementName::Ident(i) => quote! { dioxus_elements::#i::#name.1 }, - ElementName::Custom(_) => quote! { None }, + let ns = |name: &ElementAttrName| match (el_name, name) { + (ElementName::Ident(i), ElementAttrName::BuiltIn(_)) => { + quote! { dioxus_elements::#i::#name.1 } + } + _ => quote! { None }, }; - let volitile = |name| match el_name { - ElementName::Ident(_) => quote! { #el_name::#name.2 }, - ElementName::Custom(_) => quote! { false }, + let volitile = |name: &ElementAttrName| match (el_name, name) { + (ElementName::Ident(i), ElementAttrName::BuiltIn(_)) => { + quote! { dioxus_elements::#i::#name.2 } + } + _ => quote! { false }, }; let attribute = |name: &ElementAttrName| match name { ElementAttrName::BuiltIn(name) => match el_name { From 1a17ca988c209d36c82c336449fa195559601362 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Thu, 14 Sep 2023 16:19:21 -0500 Subject: [PATCH 100/447] fix double quotes in autoformatting --- packages/autofmt/src/element.rs | 2 +- packages/autofmt/tests/samples/simple.rsx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/packages/autofmt/src/element.rs b/packages/autofmt/src/element.rs index 971f4447e..b64415649 100644 --- a/packages/autofmt/src/element.rs +++ b/packages/autofmt/src/element.rs @@ -215,7 +215,7 @@ impl Writer<'_> { write!(self.out, "{}", name)?; } ElementAttrName::Custom(name) => { - write!(self.out, "\"{}\"", name.to_token_stream())?; + write!(self.out, "{}", name.to_token_stream())?; } } diff --git a/packages/autofmt/tests/samples/simple.rsx b/packages/autofmt/tests/samples/simple.rsx index a0e573974..a3bfd1388 100644 --- a/packages/autofmt/tests/samples/simple.rsx +++ b/packages/autofmt/tests/samples/simple.rsx @@ -33,7 +33,7 @@ rsx! { } // No children, minimal props - img { class: "mb-6 mx-auto h-24", src: "artemis-assets/images/friends.png", alt: "" } + img { class: "mb-6 mx-auto h-24", src: "artemis-assets/images/friends.png" } // One level compression div { From 9f1c735cf1d939ee82a2aa7e65f17d8e9b0dd1d9 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Thu, 14 Sep 2023 16:40:49 -0500 Subject: [PATCH 101/447] combine style and class attributes when there are multiple --- packages/rsx/src/attribute.rs | 46 +++++++++++++++++++++++++++++++---- packages/rsx/src/element.rs | 16 +++++++++++- packages/rsx/src/ifmt.rs | 21 +++++++++++++++- 3 files changed, 76 insertions(+), 7 deletions(-) diff --git a/packages/rsx/src/attribute.rs b/packages/rsx/src/attribute.rs index ea9d79263..a5daafc27 100644 --- a/packages/rsx/src/attribute.rs +++ b/packages/rsx/src/attribute.rs @@ -13,14 +13,14 @@ pub struct ElementAttrNamed { } impl ElementAttrNamed { - pub(crate) fn try_combine(&self, other: Self) -> Option { + pub(crate) fn try_combine(&self, other: &Self) -> Option { if self.el_name == other.el_name && self.attr.name == other.attr.name { - if let Some(separator) = todo!() { + if let Some(separator) = self.attr.name.multi_attribute_separator() { return Some(ElementAttrNamed { el_name: self.el_name.clone(), attr: ElementAttr { name: self.attr.name.clone(), - value: self.attr.value.combine(separator, other.attr.value), + value: self.attr.value.combine(separator, &other.attr.value), }, }); } @@ -109,8 +109,33 @@ pub enum ElementAttrValue { } impl ElementAttrValue { - fn combine(&self, separator: &str, other: Self) -> Self { - todo!() + fn combine(&self, separator: &str, other: &Self) -> Self { + match (self, other) { + (Self::AttrLiteral(lit1), Self::AttrLiteral(lit2)) => { + let fmt = lit1.clone().join(lit2.clone(), separator); + Self::AttrLiteral(fmt) + } + (Self::AttrLiteral(expr1), Self::AttrExpr(expr2)) => { + let mut ifmt = expr1.clone(); + ifmt.push_str(separator); + ifmt.push_expr(expr2.clone()); + Self::AttrLiteral(ifmt) + } + (Self::AttrExpr(expr1), Self::AttrLiteral(expr2)) => { + let mut ifmt = expr2.clone(); + ifmt.push_str(separator); + ifmt.push_expr(expr1.clone()); + Self::AttrLiteral(ifmt) + } + (Self::AttrExpr(expr1), Self::AttrExpr(expr2)) => { + let mut ifmt = IfmtInput::default(); + ifmt.push_expr(expr1.clone()); + ifmt.push_str(separator); + ifmt.push_expr(expr2.clone()); + Self::AttrLiteral(ifmt) + } + _ => todo!(), + } } } @@ -121,6 +146,17 @@ pub enum ElementAttrName { } impl ElementAttrName { + fn multi_attribute_separator(&self) -> Option<&'static str> { + match self { + ElementAttrName::BuiltIn(i) => match i.to_string().as_str() { + "class" => Some(" "), + "style" => Some(";"), + _ => None, + }, + ElementAttrName::Custom(_) => None, + } + } + pub fn start(&self) -> Span { match self { ElementAttrName::BuiltIn(i) => i.span(), diff --git a/packages/rsx/src/element.rs b/packages/rsx/src/element.rs index 19557edd2..a02669fc7 100644 --- a/packages/rsx/src/element.rs +++ b/packages/rsx/src/element.rs @@ -1,4 +1,7 @@ -use std::fmt::{Display, Formatter}; +use std::{ + collections::HashMap, + fmt::{Display, Formatter}, +}; use super::*; @@ -134,6 +137,17 @@ impl Parse for Element { // Deduplicate any attributes that can be combined // For example, if there are two `class` attributes, combine them into one + let mut combined_attrs: HashMap = HashMap::new(); + for attr in attributes { + if let Some(old_attr) = combined_attrs.get_mut(&attr.attr.name) { + if let Some(combined) = old_attr.try_combine(&attr) { + *old_attr = combined; + } + } else { + combined_attrs.insert(attr.attr.name.clone(), attr); + } + } + let attributes: Vec<_> = combined_attrs.into_iter().map(|(_, v)| v).collect(); while !content.is_empty() { if (content.peek(LitStr) && content.peek2(Token![:])) && !content.peek3(Token![:]) { diff --git a/packages/rsx/src/ifmt.rs b/packages/rsx/src/ifmt.rs index 6c72f5025..981b111ce 100644 --- a/packages/rsx/src/ifmt.rs +++ b/packages/rsx/src/ifmt.rs @@ -13,7 +13,7 @@ pub fn format_args_f_impl(input: IfmtInput) -> Result { } #[allow(dead_code)] // dumb compiler does not see the struct being used... -#[derive(Debug, PartialEq, Eq, Clone, Hash)] +#[derive(Debug, PartialEq, Eq, Clone, Hash, Default)] pub struct IfmtInput { pub source: Option, pub segments: Vec, @@ -27,6 +27,25 @@ impl IfmtInput { } } + pub fn join(mut self, other: Self, separator: &str) -> Self { + if !self.segments.is_empty() { + self.segments.push(Segment::Literal(separator.to_string())); + } + self.segments.extend(other.segments); + self + } + + pub fn push_expr(&mut self, expr: Expr) { + self.segments.push(Segment::Formatted(FormattedSegment { + format_args: String::new(), + segment: FormattedSegmentType::Expr(Box::new(expr)), + })); + } + + pub fn push_str(&mut self, s: &str) { + self.segments.push(Segment::Literal(s.to_string())); + } + pub fn is_static(&self) -> bool { matches!(self.segments.as_slice(), &[Segment::Literal(_)] | &[]) } From 23c215da0218281db7e342e053e1709b4ae3495d Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Sun, 17 Sep 2023 14:11:13 -0500 Subject: [PATCH 102/447] make RuntimeGuard public --- packages/core/src/runtime.rs | 81 +++++++++++++++--------------------- 1 file changed, 34 insertions(+), 47 deletions(-) diff --git a/packages/core/src/runtime.rs b/packages/core/src/runtime.rs index 4b9dcdab0..566e9ba7c 100644 --- a/packages/core/src/runtime.rs +++ b/packages/core/src/runtime.rs @@ -7,51 +7,6 @@ thread_local! { static RUNTIMES: RefCell>> = RefCell::new(vec![]); } -/// Run some code within a runtime -pub fn in_runtime(runtime: Rc, f: impl FnOnce() -> R) -> R { - let _guard = RuntimeGuard::new(runtime); - f() -} - -/// Override the current runtime. This must be used to override the current runtime when importing components from a dynamic library that has it's own runtime. -/// -/// ```rust -/// use dioxus::prelude::*; -/// -/// fn main() { -/// let virtual_dom = VirtualDom::new(app); -/// } -/// -/// fn app(cx: Scope) -> Element { -/// render!{ Component { runtime: Runtime::current().unwrap() } } -/// } -/// -/// // In a dynamic library -/// #[derive(Props)] -/// struct ComponentProps { -/// runtime: std::rc::Rc, -/// } -/// -/// impl PartialEq for ComponentProps { -/// fn eq(&self, _other: &Self) -> bool { -/// true -/// } -/// } -/// -/// fn Component(cx: Scope) -> Element { -/// cx.use_hook(|| override_runtime(cx.props.runtime.clone())); -/// -/// render! { div {} } -/// } -/// ``` -pub fn override_runtime(runtime: Rc) { - RUNTIMES.with(|stack| { - let mut stack = stack.borrow_mut(); - stack.pop(); - stack.push(runtime); - }); -} - /// Pushes a new scope onto the stack pub(crate) fn push_runtime(runtime: Rc) { RUNTIMES.with(|stack| stack.borrow_mut().push(runtime)); @@ -143,10 +98,42 @@ impl Runtime { } } -pub(crate) struct RuntimeGuard(Rc); +/// A gaurd for a new runtime. This must be used to override the current runtime when importing components from a dynamic library that has it's own runtime. +/// +/// ```rust +/// use dioxus::prelude::*; +/// +/// fn main() { +/// let virtual_dom = VirtualDom::new(app); +/// } +/// +/// fn app(cx: Scope) -> Element { +/// render!{ Component { runtime: Runtime::current().unwrap() } } +/// } +/// +/// // In a dynamic library +/// #[derive(Props)] +/// struct ComponentProps { +/// runtime: std::rc::Rc, +/// } +/// +/// impl PartialEq for ComponentProps { +/// fn eq(&self, _other: &Self) -> bool { +/// true +/// } +/// } +/// +/// fn Component(cx: Scope) -> Element { +/// cx.use_hook(|| RuntimeGuard::new(cx.props.runtime.clone())); +/// +/// render! { div {} } +/// } +/// ``` +pub struct RuntimeGuard(Rc); impl RuntimeGuard { - pub(crate) fn new(runtime: Rc) -> Self { + /// Create a new runtime guard that sets the current Dioxus runtime. The runtime will be reset when the guard is dropped + pub fn new(runtime: Rc) -> Self { push_runtime(runtime.clone()); Self(runtime) } From 8b411b8c6da0707fc618985c8b35201e00d638da Mon Sep 17 00:00:00 2001 From: Deep Patel <61371425+Deepp0925@users.noreply.github.com> Date: Sun, 17 Sep 2023 15:18:23 -0400 Subject: [PATCH 103/447] Update Cargo.toml (#1466) Remove duplicate `dox` feature that resulted in build fail --- packages/desktop/Cargo.toml | 1 - 1 file changed, 1 deletion(-) diff --git a/packages/desktop/Cargo.toml b/packages/desktop/Cargo.toml index fd4a57a42..a884928ba 100644 --- a/packages/desktop/Cargo.toml +++ b/packages/desktop/Cargo.toml @@ -58,7 +58,6 @@ transparent = ["wry/transparent"] devtools = ["wry/devtools"] dox = ["wry/dox"] hot-reload = ["dioxus-hot-reload"] -dox = ["wry/dox"] [package.metadata.docs.rs] default-features = false From f976e08f71b4854a9474ddcebce1dc7289823dbc Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Sun, 17 Sep 2023 19:40:14 -0500 Subject: [PATCH 104/447] Merge branch 'master' into intigrate-collect-assets --- .github/workflows/cli_release.yml | 2 +- .github/workflows/docs stable.yml | 2 +- .github/workflows/docs.yml | 15 +- .github/workflows/main.yml | 12 +- .github/workflows/miri.yml | 2 +- .github/workflows/playwright.yml | 2 +- Cargo.toml | 5 +- docs/.nojekyll | 0 docs/README.md | 19 - docs/fermi/.gitignore | 1 - docs/fermi/book.toml | 6 - docs/fermi/src/SUMMARY.md | 3 - docs/fermi/src/chapter_1.md | 1 - docs/guide/.gitignore | 1 - docs/guide/Cargo.toml | 27 - docs/guide/book.toml | 40 -- docs/guide/examples/Readme.md | 1 - docs/guide/examples/anti_patterns.rs | 71 --- docs/guide/examples/boolean_attribute.rs | 18 - .../examples/component_borrowed_props.rs | 27 - docs/guide/examples/component_children.rs | 36 -- .../examples/component_children_inspect.rs | 37 -- .../guide/examples/component_element_props.rs | 36 -- docs/guide/examples/component_owned_props.rs | 34 -- .../guide/examples/component_props_options.rs | 110 ---- docs/guide/examples/components.rs | 24 - docs/guide/examples/conditional_rendering.rs | 97 ---- docs/guide/examples/custom_renderer.rs | 311 ----------- docs/guide/examples/dangerous_inner_html.rs | 20 - docs/guide/examples/event_click.rs | 18 - docs/guide/examples/event_handler_prop.rs | 32 -- docs/guide/examples/event_nested.rs | 25 - docs/guide/examples/event_prevent_default.rs | 17 - docs/guide/examples/hello_world_desktop.rs | 21 - docs/guide/examples/hello_world_liveview.rs | 60 --- docs/guide/examples/hello_world_ssr.rs | 63 --- docs/guide/examples/hello_world_tui.rs | 17 - .../examples/hello_world_tui_no_ctrl_c.rs | 36 -- docs/guide/examples/hello_world_web.rs | 17 - docs/guide/examples/hooks_anti_patterns.rs | 38 -- docs/guide/examples/hooks_bad.rs | 68 --- docs/guide/examples/hooks_composed.rs | 67 --- docs/guide/examples/hooks_counter.rs | 31 -- .../guide/examples/hooks_counter_two_state.rs | 24 - docs/guide/examples/hooks_custom_logic.rs | 57 -- docs/guide/examples/hooks_use_ref.rs | 22 - docs/guide/examples/hydration.rs | 34 -- docs/guide/examples/hydration_props.rs | 74 --- docs/guide/examples/input_controlled.rs | 21 - docs/guide/examples/input_uncontrolled.rs | 22 - docs/guide/examples/meme_editor.rs | 104 ---- docs/guide/examples/meme_editor_dark_mode.rs | 185 ------- docs/guide/examples/readme_expanded.rs | 108 ---- docs/guide/examples/rendering_lists.rs | 98 ---- docs/guide/examples/rsx_overview.rs | 169 ------ docs/guide/examples/server_basic.rs | 30 -- docs/guide/examples/server_context.rs | 109 ---- docs/guide/examples/server_context_state.rs | 134 ----- docs/guide/examples/server_function.rs | 96 ---- docs/guide/examples/spawn.rs | 84 --- docs/guide/examples/use_future.rs | 62 --- docs/guide/src/en/SUMMARY.md | 57 -- docs/guide/src/en/__unused/README.md | 6 - .../advanced-guides/06-subscription-api.md | 33 -- .../advanced-guides/10-concurrent-mode.md | 82 --- .../__unused/advanced-guides/11-arena-memo.md | 58 -- .../en/__unused/advanced-guides/12-signals.md | 150 ------ .../__unused/advanced-guides/13-subtrees.md | 52 -- .../advanced-guides/custom-renderer.md | 280 ---------- .../en/__unused/advanced-guides/liveview.md | 32 -- .../src/en/__unused/advanced-guides/rsx.md | 67 --- .../en/__unused/advanced-guides/testing.md | 29 - .../src/en/__unused/attribute_spreading.md | 30 -- docs/guide/src/en/__unused/composing.md | 244 --------- .../guide/src/en/__unused/event_javascript.rs | 26 - docs/guide/src/en/__unused/fanout.md | 61 --- docs/guide/src/en/__unused/hello_world.md | 14 - docs/guide/src/en/__unused/helpers.md | 47 -- docs/guide/src/en/__unused/index.md | 36 -- docs/guide/src/en/__unused/localstate.md | 107 ---- docs/guide/src/en/__unused/memoization.md | 26 - docs/guide/src/en/__unused/model_pattern.md | 64 --- docs/guide/src/en/async/index.md | 9 - docs/guide/src/en/async/spawn.md | 19 - docs/guide/src/en/async/use_coroutine.md | 204 ------- docs/guide/src/en/async/use_effect.md | 41 -- docs/guide/src/en/async/use_future.md | 31 -- .../src/en/best_practices/antipatterns.md | 33 -- .../src/en/best_practices/error_handling.md | 153 ------ docs/guide/src/en/best_practices/index.md | 14 - .../src/en/contributing/guiding_principles.md | 37 -- docs/guide/src/en/contributing/index.md | 57 -- .../src/en/contributing/project_structure.md | 50 -- docs/guide/src/en/contributing/roadmap.md | 138 ----- .../src/en/contributing/walkthrough_readme.md | 136 ----- docs/guide/src/en/custom_renderer/index.md | 413 -------------- .../en/describing_ui/component_children.md | 31 -- .../src/en/describing_ui/component_props.md | 144 ----- docs/guide/src/en/describing_ui/components.md | 27 - .../component_borrowed_props_screenshot.png | Bin 7868 -> 0 bytes .../component_owned_props_screenshot.png | Bin 6318 -> 0 bytes .../images/screenshot_about_component.png | Bin 19470 -> 0 bytes docs/guide/src/en/describing_ui/index.md | 142 ----- .../en/describing_ui/special_attributes.md | 62 --- .../guide/src/en/fullstack/getting_started.md | 102 ---- docs/guide/src/en/fullstack/index.md | 59 -- .../src/en/fullstack/server_functions.md | 31 -- docs/guide/src/en/getting_started/desktop.md | 77 --- .../guide/src/en/getting_started/fullstack.md | 1 - .../src/en/getting_started/hot_reload.md | 60 --- docs/guide/src/en/getting_started/index.md | 34 -- docs/guide/src/en/getting_started/liveview.md | 62 --- docs/guide/src/en/getting_started/mobile.md | 76 --- docs/guide/src/en/getting_started/ssr.md | 71 --- docs/guide/src/en/getting_started/tui.md | 46 -- docs/guide/src/en/getting_started/web.md | 63 --- .../src/en/images/compiletimecorrect.png | Bin 196054 -> 0 bytes docs/guide/src/en/images/component_tree.png | Bin 3724 -> 0 bytes docs/guide/src/en/images/diffing.png | Bin 23486 -> 0 bytes docs/guide/src/en/images/dioxuslogo_full.png | Bin 59292 -> 0 bytes docs/guide/src/en/images/oldnew.png | Bin 124296 -> 0 bytes docs/guide/src/en/images/publish.png | Bin 278470 -> 0 bytes docs/guide/src/en/index.md | 52 -- .../src/en/interactivity/custom_hooks.md | 91 ---- .../src/en/interactivity/dynamic_rendering.md | 86 --- .../src/en/interactivity/event_handlers.md | 72 --- docs/guide/src/en/interactivity/hooks.md | 106 ---- .../src/en/interactivity/images/counter.png | Bin 11368 -> 0 bytes .../images/counter_two_state.png | Bin 14503 -> 0 bytes .../images/meme_editor_screenshot.png | Bin 371060 -> 0 bytes docs/guide/src/en/interactivity/index.md | 3 - .../guide/src/en/interactivity/memoization.md | 19 - docs/guide/src/en/interactivity/router.md | 83 --- .../src/en/interactivity/sharing_state.md | 71 --- docs/guide/src/en/interactivity/user_input.md | 33 -- docs/guide/src/en/lib.rs | 1 - docs/guide/src/en/publishing/desktop.md | 65 --- docs/guide/src/en/publishing/index.md | 1 - docs/guide/src/en/publishing/web.md | 8 - docs/guide/src/pt-br/SUMMARY.md | 43 -- docs/guide/src/pt-br/async/index.md | 9 - docs/guide/src/pt-br/async/spawn.md | 29 - docs/guide/src/pt-br/async/use_coroutine.md | 181 ------- docs/guide/src/pt-br/async/use_future.md | 31 -- .../src/pt-br/best_practices/antipatterns.md | 33 -- .../pt-br/best_practices/error_handling.md | 153 ------ docs/guide/src/pt-br/best_practices/index.md | 14 - docs/guide/src/pt-br/contributing.md | 20 - docs/guide/src/pt-br/custom_renderer/index.md | 505 ------------------ .../pt-br/describing_ui/component_children.md | 31 -- .../pt-br/describing_ui/component_props.md | 142 ----- .../src/pt-br/describing_ui/components.md | 27 - .../component_borrowed_props_screenshot.png | Bin 7868 -> 0 bytes .../component_owned_props_screenshot.png | Bin 6318 -> 0 bytes .../images/screenshot_about_component.png | Bin 19470 -> 0 bytes docs/guide/src/pt-br/describing_ui/index.md | 116 ---- .../pt-br/describing_ui/special_attributes.md | 62 --- .../src/pt-br/getting_started/desktop.md | 40 -- .../src/pt-br/getting_started/hot_reload.md | 31 -- docs/guide/src/pt-br/getting_started/index.md | 72 --- .../guide/src/pt-br/getting_started/mobile.md | 76 --- docs/guide/src/pt-br/getting_started/ssr.md | 110 ---- docs/guide/src/pt-br/getting_started/tui.md | 46 -- docs/guide/src/pt-br/getting_started/web.md | 75 --- .../src/pt-br/images/compiletimecorrect.png | Bin 196054 -> 0 bytes .../guide/src/pt-br/images/component_tree.png | Bin 3724 -> 0 bytes docs/guide/src/pt-br/images/diffing.png | Bin 23486 -> 0 bytes .../src/pt-br/images/dioxuslogo_full.png | Bin 59292 -> 0 bytes docs/guide/src/pt-br/images/oldnew.png | Bin 124296 -> 0 bytes docs/guide/src/pt-br/images/publish.png | Bin 278470 -> 0 bytes docs/guide/src/pt-br/index.md | 52 -- .../src/pt-br/interactivity/custom_hooks.md | 26 - .../pt-br/interactivity/dynamic_rendering.md | 71 --- .../src/pt-br/interactivity/event_handlers.md | 68 --- docs/guide/src/pt-br/interactivity/hooks.md | 87 --- .../pt-br/interactivity/images/counter.png | Bin 11368 -> 0 bytes .../images/counter_two_state.png | Bin 14503 -> 0 bytes .../images/meme_editor_screenshot.png | Bin 371060 -> 0 bytes docs/guide/src/pt-br/interactivity/index.md | 3 - .../guide/src/pt-br/interactivity/roteador.md | 1 - docs/guide/src/pt-br/interactivity/router.md | 83 --- .../src/pt-br/interactivity/sharing_state.md | 71 --- .../src/pt-br/interactivity/user_input.md | 33 -- docs/guide/src/pt-br/lib.rs | 1 - docs/guide/src/pt-br/publishing/desktop.md | 54 -- docs/guide/src/pt-br/publishing/index.md | 1 - docs/guide/src/pt-br/publishing/web.md | 9 - docs/guide/src/pt-br/roadmap.md | 138 ----- docs/posts/release-0-2-0.md | 361 ------------- docs/posts/release.md | 406 -------------- docs/router/.gitignore | 1 - docs/router/Cargo.toml | 14 - docs/router/README.md | 7 - docs/router/book.toml | 9 - docs/router/examples/catch_all.rs | 48 -- docs/router/examples/catch_all_segments.rs | 24 - docs/router/examples/dynamic_route.rs | 115 ---- docs/router/examples/dynamic_segments.rs | 35 -- docs/router/examples/external_link.rs | 28 - docs/router/examples/first_route.rs | 36 -- docs/router/examples/full_example.rs | 112 ---- docs/router/examples/history_buttons.rs | 30 -- docs/router/examples/history_provider.rs | 29 - docs/router/examples/links.rs | 72 --- docs/router/examples/navigator.rs | 56 -- docs/router/examples/nest.rs | 40 -- docs/router/examples/nested_routes.rs | 66 --- docs/router/examples/outlet.rs | 46 -- docs/router/examples/query_segments.rs | 24 - docs/router/examples/router_cfg.rs | 37 -- docs/router/examples/routing_update.rs | 41 -- docs/router/examples/static_segments.rs | 28 - docs/router/src/SUMMARY.md | 25 - docs/router/src/example/building-a-nest.md | 99 ---- docs/router/src/example/first-route.md | 62 --- docs/router/src/example/full-code.md | 5 - docs/router/src/example/index.md | 29 - docs/router/src/example/navigation-targets.md | 27 - .../src/example/redirection-perfection.md | 41 -- docs/router/src/index.md | 27 - docs/router/src/lib.rs | 1 - docs/router/src/reference/history-buttons.md | 32 -- .../router/src/reference/history-providers.md | 20 - docs/router/src/reference/index.md | 23 - docs/router/src/reference/layouts.md | 19 - docs/router/src/reference/navigation/index.md | 39 -- .../src/reference/navigation/programmatic.md | 32 -- docs/router/src/reference/redirects.md | 13 - docs/router/src/reference/routes/index.md | 65 --- docs/router/src/reference/routes/nested.md | 39 -- .../src/reference/routing-update-callback.md | 25 - .../router/src/reference/static-generation.md | 15 - examples/crm.rs | 8 +- examples/dog_app.rs | 11 +- examples/error_handle.rs | 11 +- examples/flat_router.rs | 17 +- examples/inlineprops.rs | 20 +- examples/link.rs | 13 +- examples/query_segments_demo/src/main.rs | 5 +- examples/router.rs | 11 +- examples/rsx_usage.rs | 27 +- examples/shared_state.rs | 7 +- examples/simple_desktop.rs | 15 +- examples/simple_router.rs | 6 +- packages/autofmt/README.md | 10 +- packages/autofmt/tests/samples/long.rsx | 2 +- packages/check/README.md | 10 +- packages/check/src/issues.rs | 6 +- packages/cli/src/server/desktop/mod.rs | 105 ++-- packages/cli/src/server/mod.rs | 204 +++---- packages/cli/src/server/web/hot_reload.rs | 16 +- packages/cli/src/server/web/mod.rs | 126 ++--- packages/core-macro/Cargo.toml | 2 + packages/core-macro/README.md | 9 +- packages/core-macro/src/component_body/mod.rs | 237 ++++++++ .../core-macro/src/component_body/utils.rs | 57 ++ .../component_body_deserializers/component.rs | 152 ++++++ .../inline_props.rs | 195 +++++++ .../src/component_body_deserializers/mod.rs | 4 + packages/core-macro/src/inlineprops.rs | 185 ------- packages/core-macro/src/lib.rs | 131 ++++- packages/core-macro/src/props/mod.rs | 55 +- packages/core/Cargo.toml | 2 +- packages/core/src/any_props.rs | 2 +- packages/core/src/diff.rs | 11 +- packages/core/src/error_boundary.rs | 27 +- packages/core/src/events.rs | 2 +- packages/core/src/lib.rs | 11 +- packages/core/src/runtime.rs | 57 +- packages/core/src/scope_arena.rs | 1 + packages/core/src/scope_context.rs | 41 +- packages/core/src/virtual_dom.rs | 19 +- packages/core/tests/create_passthru.rs | 35 +- packages/core/tests/miri_full_app.rs | 11 +- packages/core/tests/miri_simple.rs | 42 +- packages/desktop/Cargo.toml | 12 +- packages/desktop/README.md | 12 +- packages/desktop/src/desktop_context.rs | 4 +- packages/desktop/src/lib.rs | 2 +- packages/desktop/src/protocol.rs | 2 +- packages/desktop/src/query.rs | 2 +- packages/desktop/src/readme.md | 4 +- packages/dioxus-tui/Cargo.toml | 2 +- packages/dioxus/Cargo.toml | 4 +- packages/dioxus/README.md | 65 ++- packages/dioxus/src/lib.rs | 3 +- packages/fermi/Cargo.toml | 2 +- packages/fermi/src/root.rs | 8 +- packages/fullstack/Cargo.toml | 3 +- packages/fullstack/README.md | 2 +- .../examples/axum-hello-world/Cargo.toml | 5 +- .../examples/axum-hello-world/src/main.rs | 5 +- .../examples/axum-router/src/main.rs | 6 +- .../examples/salvo-hello-world/Cargo.toml | 5 +- .../examples/salvo-hello-world/src/main.rs | 4 +- .../examples/static-hydrated/src/main.rs | 6 +- .../examples/warp-hello-world/Cargo.toml | 5 +- .../examples/warp-hello-world/src/main.rs | 4 +- .../fullstack/src/adapters/axum_adapter.rs | 6 +- .../fullstack/src/adapters/salvo_adapter.rs | 2 +- .../fullstack/src/adapters/warp_adapter.rs | 18 +- packages/fullstack/src/hooks/server_cached.rs | 2 +- packages/fullstack/src/hooks/server_future.rs | 8 +- packages/fullstack/src/hot_reload.rs | 2 +- .../fullstack/src/html_storage/deserialize.rs | 8 +- packages/fullstack/src/html_storage/mod.rs | 4 +- packages/fullstack/src/layer.rs | 7 +- packages/fullstack/src/render.rs | 8 +- packages/fullstack/src/router.rs | 2 +- packages/hooks/Cargo.toml | 2 +- packages/hooks/README.md | 9 +- packages/hooks/src/computed.rs | 3 +- packages/hooks/src/use_shared_state.rs | 21 +- packages/hooks/src/useeffect.rs | 6 +- packages/hooks/src/usefuture.rs | 2 +- packages/hooks/src/usememo.rs | 7 +- packages/hot-reload/Cargo.toml | 2 +- packages/hot-reload/README.md | 15 +- packages/html/README.md | 15 +- packages/html/src/elements.rs | 2 + packages/html/src/events/mouse.rs | 2 +- packages/interpreter/README.md | 9 +- packages/interpreter/src/interpreter.js | 40 +- packages/liveview/Cargo.toml | 4 +- packages/liveview/README.md | 8 +- packages/liveview/src/query.rs | 2 +- packages/mobile/Cargo.toml | 2 +- packages/mobile/README.md | 13 +- packages/native-core-macro/README.md | 8 +- packages/router-macro/src/lib.rs | 13 +- packages/router-macro/src/query.rs | 2 +- packages/router-macro/src/route.rs | 6 +- packages/router-macro/src/route_tree.rs | 9 +- packages/router-macro/src/segment.rs | 15 +- packages/router/Cargo.toml | 4 +- packages/router/README.md | 14 +- packages/router/benches/incremental.rs | 12 +- packages/router/examples/simple_routes.rs | 15 +- packages/router/examples/static_generation.rs | 10 +- .../router/src/components/history_buttons.rs | 12 +- packages/router/src/components/link.rs | 7 +- packages/router/src/components/outlet.rs | 7 +- packages/router/src/history/memory.rs | 4 +- packages/router/src/history/mod.rs | 31 +- packages/router/src/history/web.rs | 14 +- packages/router/src/history/web_hash.rs | 2 +- packages/router/src/hooks/use_navigator.rs | 5 +- packages/router/src/hooks/use_route.rs | 7 +- packages/router/src/incremental.rs | 8 +- packages/router/src/lib.rs | 5 + packages/router/src/navigation.rs | 4 +- packages/router/src/routable.rs | 197 ++++--- packages/router/src/router_cfg.rs | 2 +- packages/router/tests/via_ssr/link.rs | 48 +- packages/router/tests/via_ssr/outlet.rs | 17 +- packages/rsx-rosetta/README.md | 9 +- packages/rsx/README.md | 8 +- packages/signals/Cargo.toml | 2 +- packages/signals/README.md | 20 +- packages/signals/examples/selector.rs | 9 +- packages/signals/src/effect.rs | 5 +- packages/signals/src/rt.rs | 25 +- packages/signals/src/selector.rs | 1 + packages/signals/src/signal.rs | 11 +- packages/ssr/Cargo.toml | 5 +- packages/ssr/README.md | 13 +- packages/ssr/src/cache.rs | 6 + packages/ssr/src/incremental.rs | 10 +- packages/ssr/src/renderer.rs | 111 +++- packages/ssr/tests/bool_attr.rs | 37 ++ packages/ssr/tests/simple.rs | 11 +- packages/web/Cargo.toml | 5 +- packages/web/README.md | 7 +- packages/web/examples/hydrate.rs | 4 +- packages/web/src/dom.rs | 1 - packages/web/src/eval.rs | 2 +- packages/web/src/lib.rs | 8 +- packages/web/src/rehydrate.rs | 8 +- translations/ja-jp/README.md | 2 +- 379 files changed, 1962 insertions(+), 13517 deletions(-) delete mode 100644 docs/.nojekyll delete mode 100644 docs/README.md delete mode 100644 docs/fermi/.gitignore delete mode 100644 docs/fermi/book.toml delete mode 100644 docs/fermi/src/SUMMARY.md delete mode 100644 docs/fermi/src/chapter_1.md delete mode 100644 docs/guide/.gitignore delete mode 100644 docs/guide/Cargo.toml delete mode 100644 docs/guide/book.toml delete mode 100644 docs/guide/examples/Readme.md delete mode 100644 docs/guide/examples/anti_patterns.rs delete mode 100644 docs/guide/examples/boolean_attribute.rs delete mode 100644 docs/guide/examples/component_borrowed_props.rs delete mode 100644 docs/guide/examples/component_children.rs delete mode 100644 docs/guide/examples/component_children_inspect.rs delete mode 100644 docs/guide/examples/component_element_props.rs delete mode 100644 docs/guide/examples/component_owned_props.rs delete mode 100644 docs/guide/examples/component_props_options.rs delete mode 100644 docs/guide/examples/components.rs delete mode 100644 docs/guide/examples/conditional_rendering.rs delete mode 100644 docs/guide/examples/custom_renderer.rs delete mode 100644 docs/guide/examples/dangerous_inner_html.rs delete mode 100644 docs/guide/examples/event_click.rs delete mode 100644 docs/guide/examples/event_handler_prop.rs delete mode 100644 docs/guide/examples/event_nested.rs delete mode 100644 docs/guide/examples/event_prevent_default.rs delete mode 100644 docs/guide/examples/hello_world_desktop.rs delete mode 100644 docs/guide/examples/hello_world_liveview.rs delete mode 100644 docs/guide/examples/hello_world_ssr.rs delete mode 100644 docs/guide/examples/hello_world_tui.rs delete mode 100644 docs/guide/examples/hello_world_tui_no_ctrl_c.rs delete mode 100644 docs/guide/examples/hello_world_web.rs delete mode 100644 docs/guide/examples/hooks_anti_patterns.rs delete mode 100644 docs/guide/examples/hooks_bad.rs delete mode 100644 docs/guide/examples/hooks_composed.rs delete mode 100644 docs/guide/examples/hooks_counter.rs delete mode 100644 docs/guide/examples/hooks_counter_two_state.rs delete mode 100644 docs/guide/examples/hooks_custom_logic.rs delete mode 100644 docs/guide/examples/hooks_use_ref.rs delete mode 100644 docs/guide/examples/hydration.rs delete mode 100644 docs/guide/examples/hydration_props.rs delete mode 100644 docs/guide/examples/input_controlled.rs delete mode 100644 docs/guide/examples/input_uncontrolled.rs delete mode 100644 docs/guide/examples/meme_editor.rs delete mode 100644 docs/guide/examples/meme_editor_dark_mode.rs delete mode 100644 docs/guide/examples/readme_expanded.rs delete mode 100644 docs/guide/examples/rendering_lists.rs delete mode 100644 docs/guide/examples/rsx_overview.rs delete mode 100644 docs/guide/examples/server_basic.rs delete mode 100644 docs/guide/examples/server_context.rs delete mode 100644 docs/guide/examples/server_context_state.rs delete mode 100644 docs/guide/examples/server_function.rs delete mode 100644 docs/guide/examples/spawn.rs delete mode 100644 docs/guide/examples/use_future.rs delete mode 100644 docs/guide/src/en/SUMMARY.md delete mode 100644 docs/guide/src/en/__unused/README.md delete mode 100644 docs/guide/src/en/__unused/advanced-guides/06-subscription-api.md delete mode 100644 docs/guide/src/en/__unused/advanced-guides/10-concurrent-mode.md delete mode 100644 docs/guide/src/en/__unused/advanced-guides/11-arena-memo.md delete mode 100644 docs/guide/src/en/__unused/advanced-guides/12-signals.md delete mode 100644 docs/guide/src/en/__unused/advanced-guides/13-subtrees.md delete mode 100644 docs/guide/src/en/__unused/advanced-guides/custom-renderer.md delete mode 100644 docs/guide/src/en/__unused/advanced-guides/liveview.md delete mode 100644 docs/guide/src/en/__unused/advanced-guides/rsx.md delete mode 100644 docs/guide/src/en/__unused/advanced-guides/testing.md delete mode 100644 docs/guide/src/en/__unused/attribute_spreading.md delete mode 100644 docs/guide/src/en/__unused/composing.md delete mode 100644 docs/guide/src/en/__unused/event_javascript.rs delete mode 100644 docs/guide/src/en/__unused/fanout.md delete mode 100644 docs/guide/src/en/__unused/hello_world.md delete mode 100644 docs/guide/src/en/__unused/helpers.md delete mode 100644 docs/guide/src/en/__unused/index.md delete mode 100644 docs/guide/src/en/__unused/localstate.md delete mode 100644 docs/guide/src/en/__unused/memoization.md delete mode 100644 docs/guide/src/en/__unused/model_pattern.md delete mode 100644 docs/guide/src/en/async/index.md delete mode 100644 docs/guide/src/en/async/spawn.md delete mode 100644 docs/guide/src/en/async/use_coroutine.md delete mode 100644 docs/guide/src/en/async/use_effect.md delete mode 100644 docs/guide/src/en/async/use_future.md delete mode 100644 docs/guide/src/en/best_practices/antipatterns.md delete mode 100644 docs/guide/src/en/best_practices/error_handling.md delete mode 100644 docs/guide/src/en/best_practices/index.md delete mode 100644 docs/guide/src/en/contributing/guiding_principles.md delete mode 100644 docs/guide/src/en/contributing/index.md delete mode 100644 docs/guide/src/en/contributing/project_structure.md delete mode 100644 docs/guide/src/en/contributing/roadmap.md delete mode 100644 docs/guide/src/en/contributing/walkthrough_readme.md delete mode 100644 docs/guide/src/en/custom_renderer/index.md delete mode 100644 docs/guide/src/en/describing_ui/component_children.md delete mode 100644 docs/guide/src/en/describing_ui/component_props.md delete mode 100644 docs/guide/src/en/describing_ui/components.md delete mode 100644 docs/guide/src/en/describing_ui/images/component_borrowed_props_screenshot.png delete mode 100644 docs/guide/src/en/describing_ui/images/component_owned_props_screenshot.png delete mode 100644 docs/guide/src/en/describing_ui/images/screenshot_about_component.png delete mode 100644 docs/guide/src/en/describing_ui/index.md delete mode 100644 docs/guide/src/en/describing_ui/special_attributes.md delete mode 100644 docs/guide/src/en/fullstack/getting_started.md delete mode 100644 docs/guide/src/en/fullstack/index.md delete mode 100644 docs/guide/src/en/fullstack/server_functions.md delete mode 100644 docs/guide/src/en/getting_started/desktop.md delete mode 100644 docs/guide/src/en/getting_started/fullstack.md delete mode 100644 docs/guide/src/en/getting_started/hot_reload.md delete mode 100644 docs/guide/src/en/getting_started/index.md delete mode 100644 docs/guide/src/en/getting_started/liveview.md delete mode 100644 docs/guide/src/en/getting_started/mobile.md delete mode 100644 docs/guide/src/en/getting_started/ssr.md delete mode 100644 docs/guide/src/en/getting_started/tui.md delete mode 100644 docs/guide/src/en/getting_started/web.md delete mode 100644 docs/guide/src/en/images/compiletimecorrect.png delete mode 100644 docs/guide/src/en/images/component_tree.png delete mode 100644 docs/guide/src/en/images/diffing.png delete mode 100644 docs/guide/src/en/images/dioxuslogo_full.png delete mode 100644 docs/guide/src/en/images/oldnew.png delete mode 100644 docs/guide/src/en/images/publish.png delete mode 100644 docs/guide/src/en/index.md delete mode 100644 docs/guide/src/en/interactivity/custom_hooks.md delete mode 100644 docs/guide/src/en/interactivity/dynamic_rendering.md delete mode 100644 docs/guide/src/en/interactivity/event_handlers.md delete mode 100644 docs/guide/src/en/interactivity/hooks.md delete mode 100644 docs/guide/src/en/interactivity/images/counter.png delete mode 100644 docs/guide/src/en/interactivity/images/counter_two_state.png delete mode 100644 docs/guide/src/en/interactivity/images/meme_editor_screenshot.png delete mode 100644 docs/guide/src/en/interactivity/index.md delete mode 100644 docs/guide/src/en/interactivity/memoization.md delete mode 100644 docs/guide/src/en/interactivity/router.md delete mode 100644 docs/guide/src/en/interactivity/sharing_state.md delete mode 100644 docs/guide/src/en/interactivity/user_input.md delete mode 100644 docs/guide/src/en/lib.rs delete mode 100644 docs/guide/src/en/publishing/desktop.md delete mode 100644 docs/guide/src/en/publishing/index.md delete mode 100644 docs/guide/src/en/publishing/web.md delete mode 100644 docs/guide/src/pt-br/SUMMARY.md delete mode 100644 docs/guide/src/pt-br/async/index.md delete mode 100644 docs/guide/src/pt-br/async/spawn.md delete mode 100644 docs/guide/src/pt-br/async/use_coroutine.md delete mode 100644 docs/guide/src/pt-br/async/use_future.md delete mode 100644 docs/guide/src/pt-br/best_practices/antipatterns.md delete mode 100644 docs/guide/src/pt-br/best_practices/error_handling.md delete mode 100644 docs/guide/src/pt-br/best_practices/index.md delete mode 100644 docs/guide/src/pt-br/contributing.md delete mode 100644 docs/guide/src/pt-br/custom_renderer/index.md delete mode 100644 docs/guide/src/pt-br/describing_ui/component_children.md delete mode 100644 docs/guide/src/pt-br/describing_ui/component_props.md delete mode 100644 docs/guide/src/pt-br/describing_ui/components.md delete mode 100644 docs/guide/src/pt-br/describing_ui/images/component_borrowed_props_screenshot.png delete mode 100644 docs/guide/src/pt-br/describing_ui/images/component_owned_props_screenshot.png delete mode 100644 docs/guide/src/pt-br/describing_ui/images/screenshot_about_component.png delete mode 100644 docs/guide/src/pt-br/describing_ui/index.md delete mode 100644 docs/guide/src/pt-br/describing_ui/special_attributes.md delete mode 100644 docs/guide/src/pt-br/getting_started/desktop.md delete mode 100644 docs/guide/src/pt-br/getting_started/hot_reload.md delete mode 100644 docs/guide/src/pt-br/getting_started/index.md delete mode 100644 docs/guide/src/pt-br/getting_started/mobile.md delete mode 100644 docs/guide/src/pt-br/getting_started/ssr.md delete mode 100644 docs/guide/src/pt-br/getting_started/tui.md delete mode 100644 docs/guide/src/pt-br/getting_started/web.md delete mode 100644 docs/guide/src/pt-br/images/compiletimecorrect.png delete mode 100644 docs/guide/src/pt-br/images/component_tree.png delete mode 100644 docs/guide/src/pt-br/images/diffing.png delete mode 100644 docs/guide/src/pt-br/images/dioxuslogo_full.png delete mode 100644 docs/guide/src/pt-br/images/oldnew.png delete mode 100644 docs/guide/src/pt-br/images/publish.png delete mode 100644 docs/guide/src/pt-br/index.md delete mode 100644 docs/guide/src/pt-br/interactivity/custom_hooks.md delete mode 100644 docs/guide/src/pt-br/interactivity/dynamic_rendering.md delete mode 100644 docs/guide/src/pt-br/interactivity/event_handlers.md delete mode 100644 docs/guide/src/pt-br/interactivity/hooks.md delete mode 100644 docs/guide/src/pt-br/interactivity/images/counter.png delete mode 100644 docs/guide/src/pt-br/interactivity/images/counter_two_state.png delete mode 100644 docs/guide/src/pt-br/interactivity/images/meme_editor_screenshot.png delete mode 100644 docs/guide/src/pt-br/interactivity/index.md delete mode 100644 docs/guide/src/pt-br/interactivity/roteador.md delete mode 100644 docs/guide/src/pt-br/interactivity/router.md delete mode 100644 docs/guide/src/pt-br/interactivity/sharing_state.md delete mode 100644 docs/guide/src/pt-br/interactivity/user_input.md delete mode 100644 docs/guide/src/pt-br/lib.rs delete mode 100644 docs/guide/src/pt-br/publishing/desktop.md delete mode 100644 docs/guide/src/pt-br/publishing/index.md delete mode 100644 docs/guide/src/pt-br/publishing/web.md delete mode 100644 docs/guide/src/pt-br/roadmap.md delete mode 100644 docs/posts/release-0-2-0.md delete mode 100644 docs/posts/release.md delete mode 100644 docs/router/.gitignore delete mode 100644 docs/router/Cargo.toml delete mode 100644 docs/router/README.md delete mode 100644 docs/router/book.toml delete mode 100644 docs/router/examples/catch_all.rs delete mode 100644 docs/router/examples/catch_all_segments.rs delete mode 100644 docs/router/examples/dynamic_route.rs delete mode 100644 docs/router/examples/dynamic_segments.rs delete mode 100644 docs/router/examples/external_link.rs delete mode 100644 docs/router/examples/first_route.rs delete mode 100644 docs/router/examples/full_example.rs delete mode 100644 docs/router/examples/history_buttons.rs delete mode 100644 docs/router/examples/history_provider.rs delete mode 100644 docs/router/examples/links.rs delete mode 100644 docs/router/examples/navigator.rs delete mode 100644 docs/router/examples/nest.rs delete mode 100644 docs/router/examples/nested_routes.rs delete mode 100644 docs/router/examples/outlet.rs delete mode 100644 docs/router/examples/query_segments.rs delete mode 100644 docs/router/examples/router_cfg.rs delete mode 100644 docs/router/examples/routing_update.rs delete mode 100644 docs/router/examples/static_segments.rs delete mode 100644 docs/router/src/SUMMARY.md delete mode 100644 docs/router/src/example/building-a-nest.md delete mode 100644 docs/router/src/example/first-route.md delete mode 100644 docs/router/src/example/full-code.md delete mode 100644 docs/router/src/example/index.md delete mode 100644 docs/router/src/example/navigation-targets.md delete mode 100644 docs/router/src/example/redirection-perfection.md delete mode 100644 docs/router/src/index.md delete mode 100644 docs/router/src/lib.rs delete mode 100644 docs/router/src/reference/history-buttons.md delete mode 100644 docs/router/src/reference/history-providers.md delete mode 100644 docs/router/src/reference/index.md delete mode 100644 docs/router/src/reference/layouts.md delete mode 100644 docs/router/src/reference/navigation/index.md delete mode 100644 docs/router/src/reference/navigation/programmatic.md delete mode 100644 docs/router/src/reference/redirects.md delete mode 100644 docs/router/src/reference/routes/index.md delete mode 100644 docs/router/src/reference/routes/nested.md delete mode 100644 docs/router/src/reference/routing-update-callback.md delete mode 100644 docs/router/src/reference/static-generation.md create mode 100644 packages/core-macro/src/component_body/mod.rs create mode 100644 packages/core-macro/src/component_body/utils.rs create mode 100644 packages/core-macro/src/component_body_deserializers/component.rs create mode 100644 packages/core-macro/src/component_body_deserializers/inline_props.rs create mode 100644 packages/core-macro/src/component_body_deserializers/mod.rs delete mode 100644 packages/core-macro/src/inlineprops.rs create mode 100644 packages/ssr/tests/bool_attr.rs diff --git a/.github/workflows/cli_release.yml b/.github/workflows/cli_release.yml index c6c2b81e8..4cd33f47e 100644 --- a/.github/workflows/cli_release.yml +++ b/.github/workflows/cli_release.yml @@ -29,7 +29,7 @@ jobs: toolchain: "1.70.0", } steps: - - uses: actions/checkout@v3 + - uses: actions/checkout@v4 - name: Install stable uses: dtolnay/rust-toolchain@master with: diff --git a/.github/workflows/docs stable.yml b/.github/workflows/docs stable.yml index 069d4308a..642216f0f 100644 --- a/.github/workflows/docs stable.yml +++ b/.github/workflows/docs stable.yml @@ -23,7 +23,7 @@ jobs: - name: Setup mdBook run: | cargo install mdbook --git https://github.com/Demonthos/mdBook.git --branch master - - uses: actions/checkout@v3 + - uses: actions/checkout@v4 - name: Build run: cd docs && diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml index 3a452e770..88542aea8 100644 --- a/.github/workflows/docs.yml +++ b/.github/workflows/docs.yml @@ -1,12 +1,13 @@ name: github pages on: - push: - paths: - - docs/** - - .github/workflows/docs.yml - branches: - - master + workflow_dispatch: + # push: + # paths: + # - docs/** + # - .github/workflows/docs.yml + # branches: + # - master concurrency: group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }} @@ -28,7 +29,7 @@ jobs: - name: Setup mdBook run: | cargo install mdbook --git https://github.com/Demonthos/mdBook.git --branch master - - uses: actions/checkout@v3 + - uses: actions/checkout@v4 - name: Build run: cd docs && diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml index 04f367b8e..037525557 100644 --- a/.github/workflows/main.yml +++ b/.github/workflows/main.yml @@ -41,7 +41,7 @@ jobs: - uses: Swatinem/rust-cache@v2 - run: sudo apt-get update - run: sudo apt install libwebkit2gtk-4.1-dev libgtk-3-dev libayatana-appindicator3-dev - - uses: actions/checkout@v3 + - uses: actions/checkout@v4 - run: cargo check --all --examples --tests test: @@ -56,7 +56,7 @@ jobs: - uses: davidB/rust-cargo-make@v1 - uses: browser-actions/setup-firefox@latest - uses: jetli/wasm-pack-action@v0.4.0 - - uses: actions/checkout@v3 + - uses: actions/checkout@v4 - run: cargo make tests fmt: @@ -67,7 +67,7 @@ jobs: - uses: dtolnay/rust-toolchain@stable - uses: Swatinem/rust-cache@v2 - run: rustup component add rustfmt - - uses: actions/checkout@v3 + - uses: actions/checkout@v4 - run: cargo fmt --all -- --check clippy: @@ -80,7 +80,7 @@ jobs: - run: sudo apt-get update - run: sudo apt install libwebkit2gtk-4.1-dev libgtk-3-dev libayatana-appindicator3-dev - run: rustup component add clippy - - uses: actions/checkout@v3 + - uses: actions/checkout@v4 - run: cargo clippy --workspace --examples --tests -- -D warnings matrix_test: @@ -124,7 +124,7 @@ jobs: } steps: - - uses: actions/checkout@v3 + - uses: actions/checkout@v4 - name: install stable uses: dtolnay/rust-toolchain@master @@ -154,7 +154,7 @@ jobs: # options: --security-opt seccomp=unconfined # steps: # - name: Checkout repository - # uses: actions/checkout@v3 + # uses: actions/checkout@v4 # - name: Generate code coverage # run: | # apt-get update &&\ diff --git a/.github/workflows/miri.yml b/.github/workflows/miri.yml index b1d772512..4a467b9b2 100644 --- a/.github/workflows/miri.yml +++ b/.github/workflows/miri.yml @@ -69,7 +69,7 @@ jobs: if: runner.os == 'Linux' run: echo "MIRIFLAGS=-Zmiri-tag-gc=1" >> $GITHUB_ENV - - uses: actions/checkout@v3 + - uses: actions/checkout@v4 - name: Install Rust ${{ env.rust_nightly }} uses: dtolnay/rust-toolchain@master with: diff --git a/.github/workflows/playwright.yml b/.github/workflows/playwright.yml index dba32d257..500d41564 100644 --- a/.github/workflows/playwright.yml +++ b/.github/workflows/playwright.yml @@ -19,7 +19,7 @@ jobs: runs-on: ubuntu-latest steps: # Do our best to cache the toolchain and node install steps - - uses: actions/checkout@v3 + - uses: actions/checkout@v4 - uses: actions/setup-node@v3 with: node-version: 16 diff --git a/Cargo.toml b/Cargo.toml index 54c54ebf1..e6b07eb8c 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -37,8 +37,6 @@ members = [ "packages/fullstack/examples/salvo-hello-world", "packages/fullstack/examples/warp-hello-world", "packages/fullstack/examples/static-hydrated", - "docs/guide", - "docs/router", # Full project examples "examples/tailwind", "examples/PWA-example", @@ -82,7 +80,8 @@ generational-box = { path = "packages/generational-box" } dioxus-hot-reload = { path = "packages/hot-reload", version = "0.4.0" } dioxus-fullstack = { path = "packages/fullstack", version = "0.4.1" } dioxus_server_macro = { path = "packages/server-macro", version = "0.4.1" } -log = "0.4.19" +tracing = "0.1.37" +tracing-futures = "0.2.5" tokio = "1.28" slab = "0.4.2" futures-channel = "0.3.21" diff --git a/docs/.nojekyll b/docs/.nojekyll deleted file mode 100644 index e69de29bb..000000000 diff --git a/docs/README.md b/docs/README.md deleted file mode 100644 index 766752ecf..000000000 --- a/docs/README.md +++ /dev/null @@ -1,19 +0,0 @@ -# Building the Documentation - -Dioxus uses a fork of MdBook with multilanguage support. To build the documentation, you will need to install the forked version of MdBook. - -```sh -cargo install mdbook --git https://github.com/Demonthos/mdBook.git --branch master -``` - -Then, you can build the documentation by running: - -```sh -cd docs -cd guide -mdbook build -d ../nightly/guide -cd .. -cd router -mdbook build -d ../nightly/router -cd ../../ -``` diff --git a/docs/fermi/.gitignore b/docs/fermi/.gitignore deleted file mode 100644 index 7585238ef..000000000 --- a/docs/fermi/.gitignore +++ /dev/null @@ -1 +0,0 @@ -book diff --git a/docs/fermi/book.toml b/docs/fermi/book.toml deleted file mode 100644 index dd6d2eacb..000000000 --- a/docs/fermi/book.toml +++ /dev/null @@ -1,6 +0,0 @@ -[book] -authors = ["Jonathan Kelley"] -language = "en" -multilingual = false -src = "src" -title = "Fermi Guide" diff --git a/docs/fermi/src/SUMMARY.md b/docs/fermi/src/SUMMARY.md deleted file mode 100644 index 7390c8289..000000000 --- a/docs/fermi/src/SUMMARY.md +++ /dev/null @@ -1,3 +0,0 @@ -# Summary - -- [Chapter 1](./chapter_1.md) diff --git a/docs/fermi/src/chapter_1.md b/docs/fermi/src/chapter_1.md deleted file mode 100644 index b743fda35..000000000 --- a/docs/fermi/src/chapter_1.md +++ /dev/null @@ -1 +0,0 @@ -# Chapter 1 diff --git a/docs/guide/.gitignore b/docs/guide/.gitignore deleted file mode 100644 index 3006b271d..000000000 --- a/docs/guide/.gitignore +++ /dev/null @@ -1 +0,0 @@ -book/ diff --git a/docs/guide/Cargo.toml b/docs/guide/Cargo.toml deleted file mode 100644 index c2527b8b4..000000000 --- a/docs/guide/Cargo.toml +++ /dev/null @@ -1,27 +0,0 @@ -[package] -name = "dioxus-guide" -version = "0.0.1" -edition = "2021" -description = "Dioxus guide, including testable examples" -license = "MIT OR Apache-2.0" -publish = false - -[dev-dependencies] -dioxus = { path = "../../packages/dioxus" } -dioxus-desktop = { path = "../../packages/desktop" } -dioxus-web = { path = "../../packages/web" } -dioxus-ssr = { path = "../../packages/ssr" } -dioxus-native-core = { path = "../../packages/native-core" } -dioxus-native-core-macro = { path = "../../packages/native-core-macro" } -dioxus-router = { path = "../../packages/router" } -dioxus-liveview = { path = "../../packages/liveview", features = ["axum"] } -dioxus-tui = { path = "../../packages/dioxus-tui" } -dioxus-fullstack = { path = "../../packages/fullstack" } -# dioxus = { path = "../../packages/dioxus", features = ["desktop", "web", "ssr", "router", "fermi", "tui"] } -fermi = { path = "../../packages/fermi" } -shipyard = "0.6.2" -serde = { version = "1.0.138", features=["derive"] } -reqwest = { version = "0.11.11", features = ["json"] } -tokio = { version = "1.19.2", features = ["full"] } -axum = { version = "0.6.1", features = ["ws"] } -gloo-storage = "0.2.2" diff --git a/docs/guide/book.toml b/docs/guide/book.toml deleted file mode 100644 index 1f926256e..000000000 --- a/docs/guide/book.toml +++ /dev/null @@ -1,40 +0,0 @@ -[book.en] -title = "Dioxus Documentation" -description = "Get started with Dioxus, a portable, performant, and ergonomic framework for building cross-platform user interfaces in Rust" -authors = ["Jonathan Kelley"] -language = "en" - -[language.en] -name = "English" - -[language.pt-br] -name = "PortuguΓͺs Brasileiro" -title = "Documentação do Dioxus" -description = "Introdução ao Dioxus, um framework portΓ‘til, de alto desempenho e ergonΓ΄mico para criar interfaces de usuΓ‘rio multiplataforma em Rust." - -[rust] -edition = "2018" - -[output.html] -mathjax-support = true -site-url = "/mdBook/" -git-repository-url = "https://github.com/DioxusLabs/dioxus/edit/master/docs/guide" -edit-url-template = "https://github.com/DioxusLabs/dioxus/edit/master/docs/guide/{path}" - -[output.html.playground] -editable = true -line-numbers = true -# running examples will not work because dioxus is not a included in the playground -runnable = false - -[output.html.search] -limit-results = 20 -use-boolean-and = true -boost-title = 2 -boost-hierarchy = 2 -boost-paragraph = 1 -expand = true -heading-split-level = 2 - -# [output.html.redirect] -# "/format/config.html" = "configuration/index.html" diff --git a/docs/guide/examples/Readme.md b/docs/guide/examples/Readme.md deleted file mode 100644 index 891fc8fe4..000000000 --- a/docs/guide/examples/Readme.md +++ /dev/null @@ -1 +0,0 @@ -Some of these examples (e.g. web) cannot be run. The code samples are here mostly so that we can easily check that they compile using `cargo test`. \ No newline at end of file diff --git a/docs/guide/examples/anti_patterns.rs b/docs/guide/examples/anti_patterns.rs deleted file mode 100644 index 3911bfa0a..000000000 --- a/docs/guide/examples/anti_patterns.rs +++ /dev/null @@ -1,71 +0,0 @@ -#![allow(non_snake_case, unused)] - -//! This example shows what *not* to do - -use std::collections::HashMap; - -use dioxus::prelude::*; - -fn main() {} - -fn AntipatternNestedFragments(cx: Scope<()>) -> Element { - // ANCHOR: nested_fragments - // ❌ Don't unnecessarily nest fragments - let _ = cx.render(rsx!( - Fragment { - Fragment { - Fragment { - Fragment { - Fragment { - div { "Finally have a real node!" } - } - } - } - } - } - )); - - // βœ… Render shallow structures - cx.render(rsx!( - div { "Finally have a real node!" } - )) - // ANCHOR_END: nested_fragments -} - -#[derive(PartialEq, Props)] -struct NoKeysProps { - data: HashMap, -} - -fn AntipatternNoKeys(cx: Scope) -> Element { - // ANCHOR: iter_keys - let data: &HashMap<_, _> = &cx.props.data; - - // ❌ No keys - cx.render(rsx! { - ul { - data.values().map(|value| rsx!( - li { "List item: {value}" } - )) - } - }); - - // ❌ Using index as keys - cx.render(rsx! { - ul { - cx.props.data.values().enumerate().map(|(index, value)| rsx!( - li { key: "{index}", "List item: {value}" } - )) - } - }); - - // βœ… Using unique IDs as keys: - cx.render(rsx! { - ul { - cx.props.data.iter().map(|(key, value)| rsx!( - li { key: "{key}", "List item: {value}" } - )) - } - }) - // ANCHOR_END: iter_keys -} diff --git a/docs/guide/examples/boolean_attribute.rs b/docs/guide/examples/boolean_attribute.rs deleted file mode 100644 index 685103ccb..000000000 --- a/docs/guide/examples/boolean_attribute.rs +++ /dev/null @@ -1,18 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -#[rustfmt::skip] -fn App(cx: Scope) -> Element { - // ANCHOR: boolean_attribute -cx.render(rsx! { - div { - hidden: "false", - "hello" - } -}) - // ANCHOR_END: boolean_attribute -} diff --git a/docs/guide/examples/component_borrowed_props.rs b/docs/guide/examples/component_borrowed_props.rs deleted file mode 100644 index ee78a1824..000000000 --- a/docs/guide/examples/component_borrowed_props.rs +++ /dev/null @@ -1,27 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -// ANCHOR: App -fn App(cx: Scope) -> Element { - let hello = "Hello Dioxus!"; - - cx.render(rsx!(TitleCard { title: hello })) -} -// ANCHOR_END: App - -// ANCHOR: TitleCard -#[derive(Props)] -struct TitleCardProps<'a> { - title: &'a str, -} - -fn TitleCard<'a>(cx: Scope<'a, TitleCardProps<'a>>) -> Element { - cx.render(rsx! { - h1 { "{cx.props.title}" } - }) -} -// ANCHOR_END: TitleCard diff --git a/docs/guide/examples/component_children.rs b/docs/guide/examples/component_children.rs deleted file mode 100644 index d13a6480d..000000000 --- a/docs/guide/examples/component_children.rs +++ /dev/null @@ -1,36 +0,0 @@ -// ANCHOR: all -#![allow(non_snake_case)] -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -fn App(cx: Scope) -> Element { - // ANCHOR: Clickable_usage - cx.render(rsx! { - Clickable { - href: "https://www.youtube.com/watch?v=C-M2hs3sXGo", - "How to " i {"not"} " be seen" - } - }) - // ANCHOR_END: Clickable_usage -} - -// ANCHOR: Clickable -#[derive(Props)] -struct ClickableProps<'a> { - href: &'a str, - children: Element<'a>, -} - -fn Clickable<'a>(cx: Scope<'a, ClickableProps<'a>>) -> Element { - cx.render(rsx!( - a { - href: "{cx.props.href}", - class: "fancy-button", - &cx.props.children - } - )) -} -// ANCHOR_END: Clickable diff --git a/docs/guide/examples/component_children_inspect.rs b/docs/guide/examples/component_children_inspect.rs deleted file mode 100644 index a79b068a3..000000000 --- a/docs/guide/examples/component_children_inspect.rs +++ /dev/null @@ -1,37 +0,0 @@ -// ANCHOR: all -#![allow(non_snake_case, unused)] -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -fn App(cx: Scope) -> Element { - // ANCHOR: Clickable_usage - cx.render(rsx! { - Clickable { - href: "https://www.youtube.com/watch?v=C-M2hs3sXGo", - "How to " i {"not"} " be seen" - } - }) - // ANCHOR_END: Clickable_usage -} - -#[derive(Props)] -struct ClickableProps<'a> { - href: &'a str, - children: Element<'a>, -} - -// ANCHOR: Clickable -fn Clickable<'a>(cx: Scope<'a, ClickableProps<'a>>) -> Element { - match cx.props.children { - Some(VNode { dynamic_nodes, .. }) => { - todo!("render some stuff") - } - _ => { - todo!("render some other stuff") - } - } -} -// ANCHOR_END: Clickable diff --git a/docs/guide/examples/component_element_props.rs b/docs/guide/examples/component_element_props.rs deleted file mode 100644 index b8fe98879..000000000 --- a/docs/guide/examples/component_element_props.rs +++ /dev/null @@ -1,36 +0,0 @@ -// ANCHOR: all -#![allow(non_snake_case)] -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -fn App(cx: Scope) -> Element { - // ANCHOR: Clickable_usage - cx.render(rsx! { - Clickable { - href: "https://www.youtube.com/watch?v=C-M2hs3sXGo", - body: cx.render(rsx!("How to " i {"not"} " be seen")), - } - }) - // ANCHOR_END: Clickable_usage -} - -// ANCHOR: Clickable -#[derive(Props)] -struct ClickableProps<'a> { - href: &'a str, - body: Element<'a>, -} - -fn Clickable<'a>(cx: Scope<'a, ClickableProps<'a>>) -> Element { - cx.render(rsx!( - a { - href: "{cx.props.href}", - class: "fancy-button", - &cx.props.body - } - )) -} -// ANCHOR_END: Clickable diff --git a/docs/guide/examples/component_owned_props.rs b/docs/guide/examples/component_owned_props.rs deleted file mode 100644 index 3913f02c8..000000000 --- a/docs/guide/examples/component_owned_props.rs +++ /dev/null @@ -1,34 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -// ANCHOR: App -fn App(cx: Scope) -> Element { - cx.render(rsx! { - Likes { - score: 42, - }, - }) -} -// ANCHOR_END: App - -// ANCHOR: Likes -// Remember: Owned props must implement `PartialEq`! -#[derive(PartialEq, Props)] -struct LikesProps { - score: i32, -} - -fn Likes(cx: Scope) -> Element { - cx.render(rsx! { - div { - "This post has ", - b { "{cx.props.score}" }, - " likes" - } - }) -} -// ANCHOR_END: Likes diff --git a/docs/guide/examples/component_props_options.rs b/docs/guide/examples/component_props_options.rs deleted file mode 100644 index df2ebf1db..000000000 --- a/docs/guide/examples/component_props_options.rs +++ /dev/null @@ -1,110 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -#[rustfmt::skip] -fn App(cx: Scope) -> Element { - cx.render(rsx! { - // ANCHOR: OptionalProps_usage -Title { - title: "Some Title", -}, -Title { - title: "Some Title", - subtitle: "Some Subtitle", -}, -// Providing an Option explicitly won't compile though: -// Title { -// title: "Some Title", -// subtitle: None, -// }, - // ANCHOR_END: OptionalProps_usage - - // ANCHOR: ExplicitOption_usage -ExplicitOption { - title: "Some Title", - subtitle: None, -}, -ExplicitOption { - title: "Some Title", - subtitle: Some("Some Title"), -}, -// This won't compile: -// ExplicitOption { -// title: "Some Title", -// }, - // ANCHOR_END: ExplicitOption_usage - - // ANCHOR: DefaultComponent_usage -DefaultComponent { - number: 5, -}, -DefaultComponent {}, - // ANCHOR_END: DefaultComponent_usage - - // ANCHOR: IntoComponent_usage -IntoComponent { - string: "some &str", -}, - // ANCHOR_END: IntoComponent_usage - }) -} - -// ANCHOR: OptionalProps -#[derive(Props)] -struct OptionalProps<'a> { - title: &'a str, - subtitle: Option<&'a str>, -} - -fn Title<'a>(cx: Scope<'a, OptionalProps>) -> Element<'a> { - cx.render(rsx!(h1{ - "{cx.props.title}: ", - cx.props.subtitle.unwrap_or("No subtitle provided"), - })) -} -// ANCHOR_END: OptionalProps - -// ANCHOR: ExplicitOption -#[derive(Props)] -struct ExplicitOptionProps<'a> { - title: &'a str, - #[props(!optional)] - subtitle: Option<&'a str>, -} - -fn ExplicitOption<'a>(cx: Scope<'a, ExplicitOptionProps>) -> Element<'a> { - cx.render(rsx!(h1 { - "{cx.props.title}: ", - cx.props.subtitle.unwrap_or("No subtitle provided"), - })) -} -// ANCHOR_END: ExplicitOption - -// ANCHOR: DefaultComponent -#[derive(PartialEq, Props)] -struct DefaultProps { - // default to 42 when not provided - #[props(default = 42)] - number: i64, -} - -fn DefaultComponent(cx: Scope) -> Element { - cx.render(rsx!(h1 { "{cx.props.number}" })) -} -// ANCHOR_END: DefaultComponent - -// ANCHOR: IntoComponent -#[derive(PartialEq, Props)] -struct IntoProps { - #[props(into)] - string: String, -} - -fn IntoComponent(cx: Scope) -> Element { - cx.render(rsx!(h1 { "{cx.props.string}" })) -} -// ANCHOR_END: IntoComponent diff --git a/docs/guide/examples/components.rs b/docs/guide/examples/components.rs deleted file mode 100644 index 85020c79c..000000000 --- a/docs/guide/examples/components.rs +++ /dev/null @@ -1,24 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -// ANCHOR: App -fn App(cx: Scope) -> Element { - cx.render(rsx! { - About {}, - About {}, - }) -} -// ANCHOR_END: App - -// ANCHOR: About -pub fn About(cx: Scope) -> Element { - cx.render(rsx!(p { - b {"Dioxus Labs"} - " An Open Source project dedicated to making Rust UI wonderful." - })) -} -// ANCHOR_END: About diff --git a/docs/guide/examples/conditional_rendering.rs b/docs/guide/examples/conditional_rendering.rs deleted file mode 100644 index c6095df98..000000000 --- a/docs/guide/examples/conditional_rendering.rs +++ /dev/null @@ -1,97 +0,0 @@ -#![allow(unused)] -#![allow(non_snake_case)] -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -pub fn App(cx: Scope) -> Element { - let is_logged_in = use_state(cx, || false); - - cx.render(rsx!(LogIn { - is_logged_in: **is_logged_in, - on_log_in: |_| is_logged_in.set(true), - on_log_out: |_| is_logged_in.set(false), - })) -} - -#[inline_props] -#[rustfmt::skip] -fn LogIn<'a>( - cx: Scope<'a>, - is_logged_in: bool, - on_log_in: EventHandler<'a>, - on_log_out: EventHandler<'a>, -) -> Element<'a> { - // ANCHOR: if_else -if *is_logged_in { - cx.render(rsx! { - "Welcome!" - button { - onclick: move |_| on_log_out.call(()), - "Log Out", - } - }) -} else { - cx.render(rsx! { - button { - onclick: move |_| on_log_in.call(()), - "Log In", - } - }) -} - // ANCHOR_END: if_else -} - -#[inline_props] -#[rustfmt::skip] -fn LogInImproved<'a>( - cx: Scope<'a>, - is_logged_in: bool, - on_log_in: EventHandler<'a>, - on_log_out: EventHandler<'a>, -) -> Element<'a> { - // ANCHOR: if_else_improved -cx.render(rsx! { - // We only render the welcome message if we are logged in - // You can use if statements in the middle of a render block to conditionally render elements - if *is_logged_in { - // Notice the body of this if statment is rsx code, not an expression - "Welcome!" - } - button { - // depending on the value of `is_logged_in`, we will call a different event handler - onclick: move |_| if *is_logged_in { - on_log_in.call(()) - } - else{ - on_log_out.call(()) - }, - if *is_logged_in { - // if we are logged in, the button should say "Log Out" - "Log Out" - } else { - // if we are not logged in, the button should say "Log In" - "Log In" - } - } -}) - // ANCHOR_END: if_else_improved -} - -#[inline_props] -#[rustfmt::skip] -fn LogInWarning(cx: Scope, is_logged_in: bool) -> Element { - // ANCHOR: conditional_none -if *is_logged_in { - return None; -} - -cx.render(rsx! { - a { - "You must be logged in to comment" - } -}) - // ANCHOR_END: conditional_none -} diff --git a/docs/guide/examples/custom_renderer.rs b/docs/guide/examples/custom_renderer.rs deleted file mode 100644 index 13993fe7b..000000000 --- a/docs/guide/examples/custom_renderer.rs +++ /dev/null @@ -1,311 +0,0 @@ -use dioxus::html::input_data::keyboard_types::{Code, Key, Modifiers}; -use dioxus::prelude::*; -use dioxus_native_core::exports::shipyard::Component; -use dioxus_native_core::node_ref::*; -use dioxus_native_core::prelude::*; -use dioxus_native_core::utils::cursor::{Cursor, Pos}; -use dioxus_native_core_macro::partial_derive_state; - -// ANCHOR: state_impl -struct FontSize(f64); - -// All states need to derive Component -#[derive(Default, Debug, Copy, Clone, Component)] -struct Size(f64, f64); - -/// Derive some of the boilerplate for the State implementation -#[partial_derive_state] -impl State for Size { - type ParentDependencies = (); - - // The size of the current node depends on the size of its children - type ChildDependencies = (Self,); - - type NodeDependencies = (); - - // Size only cares about the width, height, and text parts of the current node - const NODE_MASK: NodeMaskBuilder<'static> = NodeMaskBuilder::new() - // Get access to the width and height attributes - .with_attrs(AttributeMaskBuilder::Some(&["width", "height"])) - // Get access to the text of the node - .with_text(); - - fn update<'a>( - &mut self, - node_view: NodeView<()>, - _node: ::ElementBorrowed<'a>, - _parent: Option<::ElementBorrowed<'a>>, - children: Vec<::ElementBorrowed<'a>>, - context: &SendAnyMap, - ) -> bool { - let font_size = context.get::().unwrap().0; - let mut width; - let mut height; - if let Some(text) = node_view.text() { - // if the node has text, use the text to size our object - width = text.len() as f64 * font_size; - height = font_size; - } else { - // otherwise, the size is the maximum size of the children - width = children - .iter() - .map(|(item,)| item.0) - .reduce(|accum, item| if accum >= item { accum } else { item }) - .unwrap_or(0.0); - - height = children - .iter() - .map(|(item,)| item.1) - .reduce(|accum, item| if accum >= item { accum } else { item }) - .unwrap_or(0.0); - } - // if the node contains a width or height attribute it overrides the other size - for a in node_view.attributes().into_iter().flatten() { - match &*a.attribute.name { - "width" => width = a.value.as_float().unwrap(), - "height" => height = a.value.as_float().unwrap(), - // because Size only depends on the width and height, no other attributes will be passed to the member - _ => panic!(), - } - } - // to determine what other parts of the dom need to be updated we return a boolean that marks if this member changed - let changed = (width != self.0) || (height != self.1); - *self = Self(width, height); - changed - } -} - -#[derive(Debug, Clone, Copy, PartialEq, Default, Component)] -struct TextColor { - r: u8, - g: u8, - b: u8, -} - -#[partial_derive_state] -impl State for TextColor { - // TextColor depends on the TextColor part of the parent - type ParentDependencies = (Self,); - - type ChildDependencies = (); - - type NodeDependencies = (); - - // TextColor only cares about the color attribute of the current node - const NODE_MASK: NodeMaskBuilder<'static> = - // Get access to the color attribute - NodeMaskBuilder::new().with_attrs(AttributeMaskBuilder::Some(&["color"])); - - fn update<'a>( - &mut self, - node_view: NodeView<()>, - _node: ::ElementBorrowed<'a>, - parent: Option<::ElementBorrowed<'a>>, - _children: Vec<::ElementBorrowed<'a>>, - _context: &SendAnyMap, - ) -> bool { - // TextColor only depends on the color tag, so getting the first tag is equivilent to looking through all tags - let new = match node_view - .attributes() - .and_then(|mut attrs| attrs.next()) - .and_then(|attr| attr.value.as_text()) - { - // if there is a color tag, translate it - Some("red") => TextColor { r: 255, g: 0, b: 0 }, - Some("green") => TextColor { r: 0, g: 255, b: 0 }, - Some("blue") => TextColor { r: 0, g: 0, b: 255 }, - Some(color) => panic!("unknown color {color}"), - // otherwise check if the node has a parent and inherit that color - None => match parent { - Some((parent,)) => *parent, - None => Self::default(), - }, - }; - // check if the member has changed - let changed = new != *self; - *self = new; - changed - } -} - -#[derive(Debug, Clone, Copy, PartialEq, Default, Component)] -struct Border(bool); - -#[partial_derive_state] -impl State for Border { - // TextColor depends on the TextColor part of the parent - type ParentDependencies = (Self,); - - type ChildDependencies = (); - - type NodeDependencies = (); - - // Border does not depended on any other member in the current node - const NODE_MASK: NodeMaskBuilder<'static> = - // Get access to the border attribute - NodeMaskBuilder::new().with_attrs(AttributeMaskBuilder::Some(&["border"])); - - fn update<'a>( - &mut self, - node_view: NodeView<()>, - _node: ::ElementBorrowed<'a>, - _parent: Option<::ElementBorrowed<'a>>, - _children: Vec<::ElementBorrowed<'a>>, - _context: &SendAnyMap, - ) -> bool { - // check if the node contians a border attribute - let new = Self( - node_view - .attributes() - .and_then(|mut attrs| attrs.next().map(|a| a.attribute.name == "border")) - .is_some(), - ); - // check if the member has changed - let changed = new != *self; - *self = new; - changed - } -} -// ANCHOR_END: state_impl - -// ANCHOR: rendering -fn main() -> Result<(), Box> { - fn app(cx: Scope) -> Element { - let count = use_state(cx, || 0); - - use_future(cx, (count,), |(count,)| async move { - loop { - tokio::time::sleep(std::time::Duration::from_secs(1)).await; - count.set(*count + 1); - } - }); - - cx.render(rsx! { - div{ - color: "red", - "{count}" - } - }) - } - - // create the vdom, the real_dom, and the binding layer between them - let mut vdom = VirtualDom::new(app); - let mut rdom: RealDom = RealDom::new([ - Border::to_type_erased(), - TextColor::to_type_erased(), - Size::to_type_erased(), - ]); - let mut dioxus_intigration_state = DioxusState::create(&mut rdom); - - let mutations = vdom.rebuild(); - // update the structure of the real_dom tree - dioxus_intigration_state.apply_mutations(&mut rdom, mutations); - let mut ctx = SendAnyMap::new(); - // set the font size to 3.3 - ctx.insert(FontSize(3.3)); - // update the State for nodes in the real_dom tree - let _to_rerender = rdom.update_state(ctx); - - // we need to run the vdom in a async runtime - tokio::runtime::Builder::new_current_thread() - .enable_all() - .build()? - .block_on(async { - loop { - // wait for the vdom to update - vdom.wait_for_work().await; - - // get the mutations from the vdom - let mutations = vdom.render_immediate(); - - // update the structure of the real_dom tree - dioxus_intigration_state.apply_mutations(&mut rdom, mutations); - - // update the state of the real_dom tree - let mut ctx = SendAnyMap::new(); - // set the font size to 3.3 - ctx.insert(FontSize(3.3)); - let _to_rerender = rdom.update_state(ctx); - - // render... - rdom.traverse_depth_first(|node| { - let indent = " ".repeat(node.height() as usize); - let color = *node.get::().unwrap(); - let size = *node.get::().unwrap(); - let border = *node.get::().unwrap(); - let id = node.id(); - let node = node.node_type(); - let node_type = &*node; - println!("{indent}{id:?} {color:?} {size:?} {border:?} {node_type:?}"); - }); - } - }) -} -// ANCHOR_END: rendering - -// ANCHOR: derive_state -// All states must derive Component (https://docs.rs/shipyard/latest/shipyard/derive.Component.html) -// They also must implement Default or provide a custom implementation of create in the State trait -#[derive(Default, Component)] -struct MyState; - -/// Derive some of the boilerplate for the State implementation -#[partial_derive_state] -impl State for MyState { - // The states of the parent nodes this state depends on - type ParentDependencies = (); - - // The states of the child nodes this state depends on - type ChildDependencies = (Self,); - - // The states of the current node this state depends on - type NodeDependencies = (); - - // The parts of the current text, element, or placeholder node in the tree that this state depends on - const NODE_MASK: NodeMaskBuilder<'static> = NodeMaskBuilder::new(); - - // How to update the state of the current node based on the state of the parent nodes, child nodes, and the current node - // Returns true if the node was updated and false if the node was not updated - fn update<'a>( - &mut self, - // The view of the current node limited to the parts this state depends on - _node_view: NodeView<()>, - // The state of the current node that this state depends on - _node: ::ElementBorrowed<'a>, - // The state of the parent nodes that this state depends on - _parent: Option<::ElementBorrowed<'a>>, - // The state of the child nodes that this state depends on - _children: Vec<::ElementBorrowed<'a>>, - // The context of the current node used to pass global state into the tree - _context: &SendAnyMap, - ) -> bool { - todo!() - } - - // partial_derive_state will generate a default implementation of all the other methods -} -// ANCHOR_END: derive_state - -#[allow(unused)] -// ANCHOR: cursor -fn text_editing() { - let mut cursor = Cursor::default(); - let mut text = String::new(); - - // handle keyboard input with a max text length of 10 - cursor.handle_input( - &Code::ArrowRight, - &Key::ArrowRight, - &Modifiers::empty(), - &mut text, - 10, - ); - - // mannually select text between characters 0-5 on the first line (this could be from dragging with a mouse) - cursor.start = Pos::new(0, 0); - cursor.end = Some(Pos::new(5, 0)); - - // delete the selected text and move the cursor to the start of the selection - cursor.delete_selection(&mut text); -} -// ANCHOR_END: cursor diff --git a/docs/guide/examples/dangerous_inner_html.rs b/docs/guide/examples/dangerous_inner_html.rs deleted file mode 100644 index fe8a52663..000000000 --- a/docs/guide/examples/dangerous_inner_html.rs +++ /dev/null @@ -1,20 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -#[rustfmt::skip] -fn App(cx: Scope) -> Element { - // ANCHOR: dangerous_inner_html -// this should come from a trusted source -let contents = "live dangerously"; - -cx.render(rsx! { - div { - dangerous_inner_html: "{contents}", - } -}) - // ANCHOR_END: dangerous_inner_html -} diff --git a/docs/guide/examples/event_click.rs b/docs/guide/examples/event_click.rs deleted file mode 100644 index bd25c5f36..000000000 --- a/docs/guide/examples/event_click.rs +++ /dev/null @@ -1,18 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -#[rustfmt::skip] -fn App(cx: Scope) -> Element { - // ANCHOR: rsx -cx.render(rsx! { - button { - onclick: move |event| println!("Clicked! Event: {event:?}"), - "click me!" - } -}) - // ANCHOR_END: rsx -} diff --git a/docs/guide/examples/event_handler_prop.rs b/docs/guide/examples/event_handler_prop.rs deleted file mode 100644 index 0ef70c841..000000000 --- a/docs/guide/examples/event_handler_prop.rs +++ /dev/null @@ -1,32 +0,0 @@ -#![allow(non_snake_case)] - -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -fn App(cx: Scope) -> Element { - // ANCHOR: usage - cx.render(rsx! { - FancyButton { - on_click: move |event| println!("Clicked! {event:?}") - } - }) - // ANCHOR_END: usage -} - -// ANCHOR: component_with_handler -#[derive(Props)] -pub struct FancyButtonProps<'a> { - on_click: EventHandler<'a, MouseEvent>, -} - -pub fn FancyButton<'a>(cx: Scope<'a, FancyButtonProps<'a>>) -> Element<'a> { - cx.render(rsx!(button { - class: "fancy-button", - onclick: move |evt| cx.props.on_click.call(evt), - "click me pls." - })) -} -// ANCHOR_END: component_with_handler diff --git a/docs/guide/examples/event_nested.rs b/docs/guide/examples/event_nested.rs deleted file mode 100644 index b31e340f1..000000000 --- a/docs/guide/examples/event_nested.rs +++ /dev/null @@ -1,25 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -#[rustfmt::skip] -fn App(cx: Scope) -> Element { - // ANCHOR: rsx -cx.render(rsx! { - div { - onclick: move |_event| {}, - "outer", - button { - onclick: move |event| { - // now, outer won't be triggered - event.stop_propagation(); - }, - "inner" - } - } -}) - // ANCHOR_END: rsx -} diff --git a/docs/guide/examples/event_prevent_default.rs b/docs/guide/examples/event_prevent_default.rs deleted file mode 100644 index 32443d017..000000000 --- a/docs/guide/examples/event_prevent_default.rs +++ /dev/null @@ -1,17 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -#[rustfmt::skip] -fn App(cx: Scope) -> Element { - // ANCHOR: prevent_default -cx.render(rsx! { - input { - prevent_default: "oninput onclick", - } -}) - // ANCHOR_END: prevent_default -} diff --git a/docs/guide/examples/hello_world_desktop.rs b/docs/guide/examples/hello_world_desktop.rs deleted file mode 100644 index 9d5a02051..000000000 --- a/docs/guide/examples/hello_world_desktop.rs +++ /dev/null @@ -1,21 +0,0 @@ -// ANCHOR: all -#![allow(non_snake_case)] -// import the prelude to get access to the `rsx!` macro and the `Scope` and `Element` types -use dioxus::prelude::*; - -fn main() { - // launch the dioxus app in a webview - dioxus_desktop::launch(App); -} - -// ANCHOR: component -// define a component that renders a div with the text "Hello, world!" -fn App(cx: Scope) -> Element { - cx.render(rsx! { - div { - "Hello, world!" - } - }) -} -// ANCHOR_END: component -// ANCHOR_END: all diff --git a/docs/guide/examples/hello_world_liveview.rs b/docs/guide/examples/hello_world_liveview.rs deleted file mode 100644 index c88dc2f53..000000000 --- a/docs/guide/examples/hello_world_liveview.rs +++ /dev/null @@ -1,60 +0,0 @@ -// ANCHOR: all -use axum::{extract::ws::WebSocketUpgrade, response::Html, routing::get, Router}; -use dioxus::prelude::*; - -// ANCHOR: glue -#[tokio::main] -async fn main() { - let addr: std::net::SocketAddr = ([127, 0, 0, 1], 3030).into(); - - let view = dioxus_liveview::LiveViewPool::new(); - - let app = Router::new() - // The root route contains the glue code to connect to the WebSocket - .route( - "/", - get(move || async move { - Html(format!( - r#" - - - Dioxus LiveView with Axum -

- {glue} - - "#, - // Create the glue code to connect to the WebSocket on the "/ws" route - glue = dioxus_liveview::interpreter_glue(&format!("ws://{addr}/ws")) - )) - }), - ) - // The WebSocket route is what Dioxus uses to communicate with the browser - .route( - "/ws", - get(move |ws: WebSocketUpgrade| async move { - ws.on_upgrade(move |socket| async move { - // When the WebSocket is upgraded, launch the LiveView with the app component - _ = view.launch(dioxus_liveview::axum_socket(socket), app).await; - }) - }), - ); - - println!("Listening on http://{addr}"); - - axum::Server::bind(&addr.to_string().parse().unwrap()) - .serve(app.into_make_service()) - .await - .unwrap(); -} -// ANCHOR_END: glue - -// ANCHOR: app -fn app(cx: Scope) -> Element { - cx.render(rsx! { - div { - "Hello, world!" - } - }) -} -// ANCHOR_END: app -// ANCHOR_END: all diff --git a/docs/guide/examples/hello_world_ssr.rs b/docs/guide/examples/hello_world_ssr.rs deleted file mode 100644 index 0f8db0b46..000000000 --- a/docs/guide/examples/hello_world_ssr.rs +++ /dev/null @@ -1,63 +0,0 @@ -#![allow(unused)] -#![allow(non_snake_case)] -// ANCHOR: all - -// ANCHOR: main -#![allow(non_snake_case)] -use axum::{response::Html, routing::get, Router}; -// import the prelude to get access to the `rsx!` macro and the `Scope` and `Element` types -use dioxus::prelude::*; - -#[tokio::main] -async fn main() { - let addr = std::net::SocketAddr::from(([127, 0, 0, 1], 3000)); - println!("listening on http://{}", addr); - - axum::Server::bind(&addr) - .serve( - Router::new() - .route("/", get(app_endpoint)) - .into_make_service(), - ) - .await - .unwrap(); -} - -// ANCHOR_END: main - -// ANCHOR: endpoint -async fn app_endpoint() -> Html { - // render the rsx! macro to HTML - Html(dioxus_ssr::render_lazy(rsx! { - div { "hello world!" } - })) -} -// ANCHOR_END: endpoint - -// ANCHOR: second_endpoint -async fn second_app_endpoint() -> Html { - // create a component that renders a div with the text "hello world" - fn app(cx: Scope) -> Element { - cx.render(rsx!(div { "hello world" })) - } - // create a VirtualDom with the app component - let mut app = VirtualDom::new(app); - // rebuild the VirtualDom before rendering - let _ = app.rebuild(); - - // render the VirtualDom to HTML - Html(dioxus_ssr::render(&app)) -} -// ANCHOR_END: second_endpoint - -// ANCHOR: component -// define a component that renders a div with the text "Hello, world!" -fn App(cx: Scope) -> Element { - cx.render(rsx! { - div { - "Hello, world!" - } - }) -} -// ANCHOR_END: component -// ANCHOR_END: all diff --git a/docs/guide/examples/hello_world_tui.rs b/docs/guide/examples/hello_world_tui.rs deleted file mode 100644 index dc4f0ee71..000000000 --- a/docs/guide/examples/hello_world_tui.rs +++ /dev/null @@ -1,17 +0,0 @@ -#![allow(non_snake_case)] -// import the prelude to get access to the `rsx!` macro and the `Scope` and `Element` types -use dioxus::prelude::*; - -fn main() { - // launch the app in the terminal - dioxus_tui::launch(App); -} - -// create a component that renders a div with the text "Hello, world!" -fn App(cx: Scope) -> Element { - cx.render(rsx! { - div { - "Hello, world!" - } - }) -} diff --git a/docs/guide/examples/hello_world_tui_no_ctrl_c.rs b/docs/guide/examples/hello_world_tui_no_ctrl_c.rs deleted file mode 100644 index 6afa21e6c..000000000 --- a/docs/guide/examples/hello_world_tui_no_ctrl_c.rs +++ /dev/null @@ -1,36 +0,0 @@ -// todo remove deprecated -#![allow(non_snake_case, deprecated)] - -use dioxus::events::{KeyCode, KeyboardEvent}; -use dioxus::prelude::*; -use dioxus_tui::TuiContext; - -fn main() { - dioxus_tui::launch_cfg( - App, - dioxus_tui::Config::new() - .without_ctrl_c_quit() - // Some older terminals only support 16 colors or ANSI colors - // If your terminal is one of these, change this to BaseColors or ANSI - .with_rendering_mode(dioxus_tui::RenderingMode::Rgb), - ); -} - -fn App(cx: Scope) -> Element { - let tui_ctx: TuiContext = cx.consume_context().unwrap(); - - cx.render(rsx! { - div { - width: "100%", - height: "10px", - background_color: "red", - justify_content: "center", - align_items: "center", - onkeydown: move |k: KeyboardEvent| if let KeyCode::Q = k.key_code { - tui_ctx.quit(); - }, - - "Hello world!" - } - }) -} diff --git a/docs/guide/examples/hello_world_web.rs b/docs/guide/examples/hello_world_web.rs deleted file mode 100644 index 7b013bc3d..000000000 --- a/docs/guide/examples/hello_world_web.rs +++ /dev/null @@ -1,17 +0,0 @@ -#![allow(non_snake_case)] -// import the prelude to get access to the `rsx!` macro and the `Scope` and `Element` types -use dioxus::prelude::*; - -fn main() { - // launch the web app - dioxus_web::launch(App); -} - -// create a component that renders a div with the text "Hello, world!" -fn App(cx: Scope) -> Element { - cx.render(rsx! { - div { - "Hello, world!" - } - }) -} diff --git a/docs/guide/examples/hooks_anti_patterns.rs b/docs/guide/examples/hooks_anti_patterns.rs deleted file mode 100644 index 2119b8601..000000000 --- a/docs/guide/examples/hooks_anti_patterns.rs +++ /dev/null @@ -1,38 +0,0 @@ -#![allow(unused)] - -use dioxus::prelude::*; - -fn main() {} - -// ANCHOR: non_clone_state -use std::cell::RefCell; -use std::rc::Rc; -use std::sync::Arc; - -struct UseState<'a, T> { - value: &'a RefCell, - update: Arc, -} - -fn my_use_state(cx: &ScopeState, init: impl FnOnce() -> T) -> UseState { - // The update function will trigger a re-render in the component cx is attached to - let update = cx.schedule_update(); - // Create the initial state - let value = cx.use_hook(|| RefCell::new(init())); - - UseState { value, update } -} - -impl UseState<'_, T> { - fn get(&self) -> T { - self.value.borrow().clone() - } - - fn set(&self, value: T) { - // Update the state - *self.value.borrow_mut() = value; - // Trigger a re-render on the component the state is from - (self.update)(); - } -} -// ANCHOR_END: non_clone_state diff --git a/docs/guide/examples/hooks_bad.rs b/docs/guide/examples/hooks_bad.rs deleted file mode 100644 index cbaa54e90..000000000 --- a/docs/guide/examples/hooks_bad.rs +++ /dev/null @@ -1,68 +0,0 @@ -#![allow(non_snake_case)] - -use dioxus::prelude::*; -use std::collections::HashMap; - -fn main() { - dioxus_desktop::launch(App); -} - -#[rustfmt::skip] -fn App(cx: Scope) -> Element { - let you_are_happy = true; - let you_know_it = false; - - // ANCHOR: conditional -// ❌ don't call hooks in conditionals! -// We must ensure that the same hooks will be called every time -// But `if` statements only run if the conditional is true! -// So we might violate rule 2. -if you_are_happy && you_know_it { - let something = use_state(cx, || "hands"); - println!("clap your {something}") -} - -// βœ… instead, *always* call use_state -// You can put other stuff in the conditional though -let something = use_state(cx, || "hands"); -if you_are_happy && you_know_it { - println!("clap your {something}") -} - // ANCHOR_END: conditional - - // ANCHOR: closure -// ❌ don't call hooks inside closures! -// We can't guarantee that the closure, if used, will be called in the same order every time -let _a = || { - let b = use_state(cx, || 0); - b.get() -}; - -// βœ… instead, move hook `b` outside -let b = use_state(cx, || 0); -let _a = || b.get(); - // ANCHOR_END: closure - - let names: Vec<&str> = vec![]; - - // ANCHOR: loop -// `names` is a Vec<&str> - -// ❌ Do not use hooks in loops! -// In this case, if the length of the Vec changes, we break rule 2 -for _name in &names { - let is_selected = use_state(cx, || false); - println!("selected: {is_selected}"); -} - -// βœ… Instead, use a hashmap with use_ref -let selection_map = use_ref(cx, HashMap::<&str, bool>::new); - -for name in &names { - let is_selected = selection_map.read()[name]; - println!("selected: {is_selected}"); -} - // ANCHOR_END: loop - - cx.render(rsx!(())) -} diff --git a/docs/guide/examples/hooks_composed.rs b/docs/guide/examples/hooks_composed.rs deleted file mode 100644 index 782a19d7d..000000000 --- a/docs/guide/examples/hooks_composed.rs +++ /dev/null @@ -1,67 +0,0 @@ -#![allow(unused)] - -use dioxus::prelude::*; - -fn main() {} - -struct AppSettings {} - -// ANCHOR: wrap_context -fn use_settings(cx: &ScopeState) -> &UseSharedState { - use_shared_state::(cx).expect("App settings not provided") -} -// ANCHOR_END: wrap_context - -// ANCHOR: use_storage -use gloo_storage::{LocalStorage, Storage}; -use serde::{de::DeserializeOwned, Serialize}; - -/// A persistent storage hook that can be used to store data across application reloads. -#[allow(clippy::needless_return)] -pub fn use_persistent( - cx: &ScopeState, - // A unique key for the storage entry - key: impl ToString, - // A function that returns the initial value if the storage entry is empty - init: impl FnOnce() -> T, -) -> &UsePersistent { - // Use the use_ref hook to create a mutable state for the storage entry - let state = use_ref(cx, move || { - // This closure will run when the hook is created - let key = key.to_string(); - let value = LocalStorage::get(key.as_str()).ok().unwrap_or_else(init); - StorageEntry { key, value } - }); - - // Wrap the state in a new struct with a custom API - // Note: We use use_hook here so that this hook is easier to use in closures in the rsx. Any values with the same lifetime as the ScopeState can be used in the closure without cloning. - cx.use_hook(|| UsePersistent { - inner: state.clone(), - }) -} - -struct StorageEntry { - key: String, - value: T, -} - -/// Storage that persists across application reloads -pub struct UsePersistent { - inner: UseRef>, -} - -impl UsePersistent { - /// Returns a reference to the value - pub fn get(&self) -> T { - self.inner.read().value.clone() - } - - /// Sets the value - pub fn set(&self, value: T) { - let mut inner = self.inner.write(); - // Write the new value to local storage - LocalStorage::set(inner.key.as_str(), &value); - inner.value = value; - } -} -// ANCHOR_END: use_storage diff --git a/docs/guide/examples/hooks_counter.rs b/docs/guide/examples/hooks_counter.rs deleted file mode 100644 index 86705f4af..000000000 --- a/docs/guide/examples/hooks_counter.rs +++ /dev/null @@ -1,31 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -// ANCHOR: component -fn App(cx: Scope) -> Element { - // count will be initialized to 0 the first time the component is rendered - let mut count = use_state(cx, || 0); - - cx.render(rsx!( - h1 { "High-Five counter: {count}" } - button { - onclick: move |_| { - // changing the count will cause the component to re-render - count += 1 - }, - "Up high!" - } - button { - onclick: move |_| { - // changing the count will cause the component to re-render - count -= 1 - }, - "Down low!" - } - )) -} -// ANCHOR_END: component diff --git a/docs/guide/examples/hooks_counter_two_state.rs b/docs/guide/examples/hooks_counter_two_state.rs deleted file mode 100644 index b2a8f6e77..000000000 --- a/docs/guide/examples/hooks_counter_two_state.rs +++ /dev/null @@ -1,24 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -// ANCHOR: component -fn App(cx: Scope) -> Element { - // ANCHOR: use_state_calls - let mut count_a = use_state(cx, || 0); - let mut count_b = use_state(cx, || 0); - // ANCHOR_END: use_state_calls - - cx.render(rsx!( - h1 { "Counter_a: {count_a}" } - button { onclick: move |_| count_a += 1, "a++" } - button { onclick: move |_| count_a -= 1, "a--" } - h1 { "Counter_b: {count_b}" } - button { onclick: move |_| count_b += 1, "b++" } - button { onclick: move |_| count_b -= 1, "b--" } - )) -} -// ANCHOR_END: component diff --git a/docs/guide/examples/hooks_custom_logic.rs b/docs/guide/examples/hooks_custom_logic.rs deleted file mode 100644 index 2323ddb11..000000000 --- a/docs/guide/examples/hooks_custom_logic.rs +++ /dev/null @@ -1,57 +0,0 @@ -#![allow(unused)] - -use dioxus::prelude::*; - -fn main() {} - -// ANCHOR: use_state -use std::cell::RefCell; -use std::rc::Rc; -use std::sync::Arc; - -#[derive(Clone)] -struct UseState { - value: Rc>, - update: Arc, -} - -fn my_use_state(cx: &ScopeState, init: impl FnOnce() -> T) -> &UseState { - cx.use_hook(|| { - // The update function will trigger a re-render in the component cx is attached to - let update = cx.schedule_update(); - // Create the initial state - let value = Rc::new(RefCell::new(init())); - - UseState { value, update } - }) -} - -impl UseState { - fn get(&self) -> T { - self.value.borrow().clone() - } - - fn set(&self, value: T) { - // Update the state - *self.value.borrow_mut() = value; - // Trigger a re-render on the component the state is from - (self.update)(); - } -} -// ANCHOR_END: use_state - -// ANCHOR: use_context -pub fn use_context(cx: &ScopeState) -> Option<&T> { - cx.use_hook(|| cx.consume_context::()).as_ref() -} - -pub fn use_context_provider(cx: &ScopeState, f: impl FnOnce() -> T) -> &T { - cx.use_hook(|| { - let val = f(); - // Provide the context state to the scope - cx.provide_context(val.clone()); - val - }) -} - -// ANCHOR_END: use_context diff --git a/docs/guide/examples/hooks_use_ref.rs b/docs/guide/examples/hooks_use_ref.rs deleted file mode 100644 index 00794fbb7..000000000 --- a/docs/guide/examples/hooks_use_ref.rs +++ /dev/null @@ -1,22 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -// ANCHOR: component -fn App(cx: Scope) -> Element { - let list = use_ref(cx, Vec::new); - - cx.render(rsx!( - p { "Current list: {list.read():?}" } - button { - onclick: move |event| { - list.with_mut(|list| list.push(event)); - }, - "Click me!" - } - )) -} -// ANCHOR_END: component diff --git a/docs/guide/examples/hydration.rs b/docs/guide/examples/hydration.rs deleted file mode 100644 index 31574edce..000000000 --- a/docs/guide/examples/hydration.rs +++ /dev/null @@ -1,34 +0,0 @@ -#![allow(non_snake_case, unused)] -use dioxus::prelude::*; - -fn main() { - #[cfg(feature = "web")] - dioxus_web::launch_cfg(app, dioxus_web::Config::new().hydrate(true)); - #[cfg(feature = "ssr")] - { - use dioxus_fullstack::prelude::*; - tokio::runtime::Runtime::new() - .unwrap() - .block_on(async move { - let addr = std::net::SocketAddr::from(([127, 0, 0, 1], 8080)); - axum::Server::bind(&addr) - .serve( - axum::Router::new() - .serve_dioxus_application("", ServeConfigBuilder::new(app, ())) - .into_make_service(), - ) - .await - .unwrap(); - }); - } -} - -fn app(cx: Scope) -> Element { - let mut count = use_state(cx, || 0); - - cx.render(rsx! { - h1 { "High-Five counter: {count}" } - button { onclick: move |_| count += 1, "Up high!" } - button { onclick: move |_| count -= 1, "Down low!" } - }) -} diff --git a/docs/guide/examples/hydration_props.rs b/docs/guide/examples/hydration_props.rs deleted file mode 100644 index 4e6bb1752..000000000 --- a/docs/guide/examples/hydration_props.rs +++ /dev/null @@ -1,74 +0,0 @@ -#![allow(non_snake_case, unused)] -use dioxus::prelude::*; -use dioxus_fullstack::prelude::*; - -fn main() { - #[cfg(feature = "web")] - dioxus_web::launch_with_props( - app, - // Get the root props from the document - get_root_props_from_document().unwrap_or_default(), - dioxus_web::Config::new().hydrate(true), - ); - #[cfg(feature = "ssr")] - { - use axum::extract::Path; - use axum::extract::State; - use axum::routing::get; - tokio::runtime::Runtime::new() - .unwrap() - .block_on(async move { - let addr = std::net::SocketAddr::from(([127, 0, 0, 1], 8080)); - axum::Server::bind(&addr) - .serve( - axum::Router::new() - // Serve the dist folder with the static javascript and WASM files created by the dixous CLI - .serve_static_assets("./dist") - // Register server functions - .register_server_fns("") - // Connect to the hot reload server in debug mode - .connect_hot_reload() - // Render the application. This will serialize the root props (the intial count) into the HTML - .route( - "/", - get(move | State(ssr_state): State| async move { axum::body::Full::from( - ssr_state.render( - &ServeConfigBuilder::new( - app, - 0, - ) - .build(), - ) - )}), - ) - // Render the application with a different intial count - .route( - "/:initial_count", - get(move |Path(intial_count): Path, State(ssr_state): State| async move { axum::body::Full::from( - ssr_state.render( - &ServeConfigBuilder::new( - app, - intial_count, - ) - .build(), - ) - )}), - ) - .with_state(SSRState::default()) - .into_make_service(), - ) - .await - .unwrap(); - }); - } -} - -fn app(cx: Scope) -> Element { - let mut count = use_state(cx, || *cx.props); - - cx.render(rsx! { - h1 { "High-Five counter: {count}" } - button { onclick: move |_| count += 1, "Up high!" } - button { onclick: move |_| count -= 1, "Down low!" } - }) -} diff --git a/docs/guide/examples/input_controlled.rs b/docs/guide/examples/input_controlled.rs deleted file mode 100644 index bf92072a3..000000000 --- a/docs/guide/examples/input_controlled.rs +++ /dev/null @@ -1,21 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -// ANCHOR: component -fn App(cx: Scope) -> Element { - let name = use_state(cx, || "bob".to_string()); - - cx.render(rsx! { - input { - // we tell the component what to render - value: "{name}", - // and what to do when the value changes - oninput: move |evt| name.set(evt.value.clone()), - } - }) -} -// ANCHOR_END: component diff --git a/docs/guide/examples/input_uncontrolled.rs b/docs/guide/examples/input_uncontrolled.rs deleted file mode 100644 index 5adc4aaad..000000000 --- a/docs/guide/examples/input_uncontrolled.rs +++ /dev/null @@ -1,22 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -// ANCHOR: component -fn App(cx: Scope) -> Element { - cx.render(rsx! { - form { - onsubmit: move |event| { - println!("Submitted! {event:?}") - }, - input { name: "name", }, - input { name: "age", }, - input { name: "date", }, - input { r#type: "submit", }, - } - }) -} -// ANCHOR_END: component diff --git a/docs/guide/examples/meme_editor.rs b/docs/guide/examples/meme_editor.rs deleted file mode 100644 index c5a473da9..000000000 --- a/docs/guide/examples/meme_editor.rs +++ /dev/null @@ -1,104 +0,0 @@ -// ANCHOR: all -#![allow(non_snake_case)] - -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(MemeEditor); -} - -// ANCHOR: meme_editor -fn MemeEditor(cx: Scope) -> Element { - let container_style = r" - display: flex; - flex-direction: column; - gap: 16px; - margin: 0 auto; - width: fit-content; - "; - - let caption = use_state(cx, || "me waiting for my rust code to compile".to_string()); - - cx.render(rsx! { - div { - style: "{container_style}", - h1 { "Meme Editor" }, - Meme { - caption: caption, - }, - CaptionEditor { - caption: caption, - on_input: move |event: FormEvent| {caption.set(event.value.clone());}, - }, - } - }) -} -// ANCHOR_END: meme_editor - -// ANCHOR: meme_component -#[inline_props] -fn Meme<'a>(cx: Scope<'a>, caption: &'a str) -> Element<'a> { - let container_style = r#" - position: relative; - width: fit-content; - "#; - - let caption_container_style = r#" - position: absolute; - bottom: 0; - left: 0; - right: 0; - padding: 16px 8px; - "#; - - let caption_style = r" - font-size: 32px; - margin: 0; - color: white; - text-align: center; - "; - - cx.render(rsx!( - div { - style: "{container_style}", - img { - src: "https://i.imgflip.com/2zh47r.jpg", - height: "500px", - }, - div { - style: "{caption_container_style}", - p { - style: "{caption_style}", - "{caption}" - } - } - } - )) -} -// ANCHOR_END: meme_component - -// ANCHOR: caption_editor -#[inline_props] -fn CaptionEditor<'a>( - cx: Scope<'a>, - caption: &'a str, - on_input: EventHandler<'a, FormEvent>, -) -> Element<'a> { - let input_style = r" - border: none; - background: cornflowerblue; - padding: 8px 16px; - margin: 0; - border-radius: 4px; - color: white; - "; - - cx.render(rsx!(input { - style: "{input_style}", - value: "{caption}", - oninput: move |event| on_input.call(event), - })) -} -// ANCHOR_END: caption_editor - -// ANCHOR_END: all diff --git a/docs/guide/examples/meme_editor_dark_mode.rs b/docs/guide/examples/meme_editor_dark_mode.rs deleted file mode 100644 index e62a64eb7..000000000 --- a/docs/guide/examples/meme_editor_dark_mode.rs +++ /dev/null @@ -1,185 +0,0 @@ -// ANCHOR: all -#![allow(non_snake_case)] - -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -// ANCHOR: DarkMode_struct -struct DarkMode(bool); -// ANCHOR_END: DarkMode_struct - -#[rustfmt::skip] -pub fn App(cx: Scope) -> Element { - // ANCHOR: context_provider -use_shared_state_provider(cx, || DarkMode(false)); - // ANCHOR_END: context_provider - - let is_dark_mode = use_is_dark_mode(cx); - - let wrapper_style = if is_dark_mode { - r" - background: #222; - min-height: 100vh; - " - } else { - r"" - }; - - cx.render(rsx!(div { - style: "{wrapper_style}", - DarkModeToggle {}, - MemeEditor {}, - })) -} - -#[rustfmt::skip] -pub fn use_is_dark_mode(cx: &ScopeState) -> bool { - // ANCHOR: use_context -let dark_mode_context = use_shared_state::(cx); - // ANCHOR_END: use_context - - dark_mode_context - .map(|context| context.read().0) - .unwrap_or(false) -} - -// ANCHOR: toggle -pub fn DarkModeToggle(cx: Scope) -> Element { - let dark_mode = use_shared_state::(cx).unwrap(); - - let style = if dark_mode.read().0 { - "color:white" - } else { - "" - }; - - cx.render(rsx!(label { - style: "{style}", - "Dark Mode", - input { - r#type: "checkbox", - oninput: move |event| { - let is_enabled = event.value == "true"; - dark_mode.write().0 = is_enabled; - }, - }, - })) -} -// ANCHOR_END: toggle - -// ANCHOR: meme_editor -fn MemeEditor(cx: Scope) -> Element { - let is_dark_mode = use_is_dark_mode(cx); - let heading_style = if is_dark_mode { "color: white" } else { "" }; - - let container_style = r" - display: flex; - flex-direction: column; - gap: 16px; - margin: 0 auto; - width: fit-content; - "; - - let caption = use_state(cx, || "me waiting for my rust code to compile".to_string()); - - cx.render(rsx! { - div { - style: "{container_style}", - h1 { - style: "{heading_style}", - "Meme Editor" - }, - Meme { - caption: caption, - }, - CaptionEditor { - caption: caption, - on_input: move |event: FormEvent| {caption.set(event.value.clone());}, - }, - } - }) -} -// ANCHOR_END: meme_editor - -// ANCHOR: meme_component -#[inline_props] -fn Meme<'a>(cx: Scope<'a>, caption: &'a str) -> Element<'a> { - let container_style = r" - position: relative; - width: fit-content; - "; - - let caption_container_style = r" - position: absolute; - bottom: 0; - left: 0; - right: 0; - padding: 16px 8px; - "; - - let caption_style = r" - font-size: 32px; - margin: 0; - color: white; - text-align: center; - "; - - cx.render(rsx!( - div { - style: "{container_style}", - img { - src: "https://i.imgflip.com/2zh47r.jpg", - height: "500px", - }, - div { - style: "{caption_container_style}", - p { - style: "{caption_style}", - "{caption}" - } - } - } - )) -} -// ANCHOR_END: meme_component - -// ANCHOR: caption_editor -#[inline_props] -fn CaptionEditor<'a>( - cx: Scope<'a>, - caption: &'a str, - on_input: EventHandler<'a, FormEvent>, -) -> Element<'a> { - let is_dark_mode = use_is_dark_mode(cx); - - let colors = if is_dark_mode { - r" - background: cornflowerblue; - color: white; - " - } else { - r" - background: #def; - color: black; - " - }; - - let input_style = r" - border: none; - padding: 8px 16px; - margin: 0; - border-radius: 4px; - "; - - cx.render(rsx!(input { - style: "{input_style}{colors}", - value: "{caption}", - oninput: move |event| on_input.call(event), - })) -} -// ANCHOR_END: caption_editor - -// ANCHOR_END: all diff --git a/docs/guide/examples/readme_expanded.rs b/docs/guide/examples/readme_expanded.rs deleted file mode 100644 index 1ec30e57b..000000000 --- a/docs/guide/examples/readme_expanded.rs +++ /dev/null @@ -1,108 +0,0 @@ -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(app); -} - -fn app(cx: Scope) -> Element { - let mut count = use_state(cx, || 0); - - cx.render( - // rsx expands to LazyNodes::new - ::dioxus::core::LazyNodes::new( - move |__cx: &::dioxus::core::ScopeState| -> ::dioxus::core::VNode { - // The template is every static part of the rsx - static TEMPLATE: ::dioxus::core::Template = ::dioxus::core::Template { - // This is the source location of the rsx that generated this template. This is used to make hot rsx reloading work. Hot rsx reloading just replaces the template with a new one generated from the rsx by the CLI. - name: "examples\\readme.rs:14:15:250", - // The root nodes are the top level nodes of the rsx - roots: &[ - // The h1 node - ::dioxus::core::TemplateNode::Element { - // Find the built in h1 tag in the dioxus_elements crate exported by the dioxus html crate - tag: dioxus_elements::h1::TAG_NAME, - namespace: dioxus_elements::h1::NAME_SPACE, - attrs: &[], - // The children of the h1 node - children: &[ - // The dynamic count text node - // Any nodes that are dynamic have a dynamic placeholder with a unique index - ::dioxus::core::TemplateNode::DynamicText { - // This index is used to find what element in `dynamic_nodes` to use instead of the placeholder - id: 0usize, - }, - ], - }, - // The up high button node - ::dioxus::core::TemplateNode::Element { - tag: dioxus_elements::button::TAG_NAME, - namespace: dioxus_elements::button::NAME_SPACE, - attrs: &[ - // The dynamic onclick listener attribute - // Any attributes that are dynamic have a dynamic placeholder with a unique index. - ::dioxus::core::TemplateAttribute::Dynamic { - // Similar to dynamic nodes, dynamic attributes have a unique index used to find the attribute in `dynamic_attrs` to use instead of the placeholder - id: 0usize, - }, - ], - children: &[::dioxus::core::TemplateNode::Text { text: "Up high!" }], - }, - // The down low button node - ::dioxus::core::TemplateNode::Element { - tag: dioxus_elements::button::TAG_NAME, - namespace: dioxus_elements::button::NAME_SPACE, - attrs: &[ - // The dynamic onclick listener attribute - ::dioxus::core::TemplateAttribute::Dynamic { id: 1usize }, - ], - children: &[::dioxus::core::TemplateNode::Text { text: "Down low!" }], - }, - ], - // Node paths is a list of paths to every dynamic node in the rsx - node_paths: &[ - // The first node path is the path to the dynamic node with an id of 0 (the count text node) - &[ - // Go to the index 0 root node - 0u8, - // - // Go to the first child of the root node - 0u8, - ], - ], - // Attr paths is a list of paths to every dynamic attribute in the rsx - attr_paths: &[ - // The first attr path is the path to the dynamic attribute with an id of 0 (the up high button onclick listener) - &[ - // Go to the index 1 root node - 1u8, - ], - // The second attr path is the path to the dynamic attribute with an id of 1 (the down low button onclick listener) - &[ - // Go to the index 2 root node - 2u8, - ], - ], - }; - // The VNode is a reference to the template with the dynamic parts of the rsx - ::dioxus::core::VNode { - parent: None, - key: None, - // The static template this node will use. The template is stored in a Cell so it can be replaced with a new template when hot rsx reloading is enabled - template: std::cell::Cell::new(TEMPLATE), - root_ids: dioxus::core::exports::bumpalo::collections::Vec::new_in(__cx.bump()) - .into(), - dynamic_nodes: __cx.bump().alloc([ - // The dynamic count text node (dynamic node id 0) - __cx.text_node(format_args!("High-Five counter: {0}", count)), - ]), - dynamic_attrs: __cx.bump().alloc([ - // The dynamic up high button onclick listener (dynamic attribute id 0) - dioxus_elements::events::onclick(__cx, move |_| count += 1), - // The dynamic down low button onclick listener (dynamic attribute id 1) - dioxus_elements::events::onclick(__cx, move |_| count -= 1), - ]), - } - }, - ), - ) -} diff --git a/docs/guide/examples/rendering_lists.rs b/docs/guide/examples/rendering_lists.rs deleted file mode 100644 index b95e712dc..000000000 --- a/docs/guide/examples/rendering_lists.rs +++ /dev/null @@ -1,98 +0,0 @@ -#![allow(non_snake_case)] - -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -#[derive(PartialEq, Clone)] -struct Comment { - content: String, - id: usize, -} - -#[rustfmt::skip] -pub fn App(cx: Scope) -> Element { - // ANCHOR: render_list -let comment_field = use_state(cx, String::new); -let mut next_id = use_state(cx, || 0); -let comments = use_ref(cx, Vec::::new); - -let comments_lock = comments.read(); -let comments_rendered = comments_lock.iter().map(|comment| { - rsx!(CommentComponent { - key: "{comment.id}", - comment: comment.clone(), - }) -}); - -cx.render(rsx!( - form { - onsubmit: move |_| { - comments.write().push(Comment { - content: comment_field.get().clone(), - id: *next_id.get(), - }); - next_id += 1; - - comment_field.set(String::new()); - }, - input { - value: "{comment_field}", - oninput: |event| comment_field.set(event.value.clone()), - } - input { - r#type: "submit", - } - }, - comments_rendered, -)) - // ANCHOR_END: render_list -} - -#[rustfmt::skip] -pub fn AppForLoop(cx: Scope) -> Element { - // ANCHOR: render_list_for_loop -let comment_field = use_state(cx, String::new); -let mut next_id = use_state(cx, || 0); -let comments = use_ref(cx, Vec::::new); - -cx.render(rsx!( - form { - onsubmit: move |_| { - comments.write().push(Comment { - content: comment_field.get().clone(), - id: *next_id.get(), - }); - next_id += 1; - - comment_field.set(String::new()); - }, - input { - value: "{comment_field}", - oninput: |event| comment_field.set(event.value.clone()), - } - input { - r#type: "submit", - } - }, - for comment in &*comments.read() { - // Notice the body of this for loop is rsx code, not an expression - CommentComponent { - key: "{comment.id}", - comment: comment.clone(), - } - } -)) - // ANCHOR_END: render_list_for_loop -} - -#[inline_props] -fn CommentComponent(cx: Scope, comment: Comment) -> Element { - cx.render(rsx!(div { - "Comment by anon:", - p { "{comment.content}" } - button { "Reply" }, - })) -} diff --git a/docs/guide/examples/rsx_overview.rs b/docs/guide/examples/rsx_overview.rs deleted file mode 100644 index 93c991d0d..000000000 --- a/docs/guide/examples/rsx_overview.rs +++ /dev/null @@ -1,169 +0,0 @@ -#![allow(non_snake_case)] - -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -pub fn App(cx: Scope) -> Element { - cx.render(rsx!( - Empty {}, - Children {}, - Fragments {}, - Attributes {}, - VariableAttributes {}, - CustomAttributes {}, - Formatting {}, - Expression {}, - )) -} - -#[rustfmt::skip] -pub fn Empty(cx: Scope) -> Element { - // ANCHOR: empty -cx.render(rsx!(div { - // attributes / listeners - // children -})) - // ANCHOR_END: empty -} - -#[rustfmt::skip] -pub fn Children(cx: Scope) -> Element { - // ANCHOR: children -cx.render(rsx!(ol { - li {"First Item"} - li {"Second Item"} - li {"Third Item"} -})) - // ANCHOR_END: children -} - -#[rustfmt::skip] -pub fn Fragments(cx: Scope) -> Element { - // ANCHOR: fragments -cx.render(rsx!( - p {"First Item"}, - p {"Second Item"}, - Fragment { - span { "a group" }, - span { "of three" }, - span { "items" }, - } -)) - // ANCHOR_END: fragments -} - -#[rustfmt::skip] -pub fn ManyRoots(cx: Scope) -> Element { - // ANCHOR: manyroots -cx.render(rsx!( - p {"First Item"}, - p {"Second Item"}, -)) - // ANCHOR_END: manyroots -} - -#[rustfmt::skip] -pub fn Attributes(cx: Scope) -> Element { - // ANCHOR: attributes -cx.render(rsx!(a { - href: "https://www.youtube.com/watch?v=dQw4w9WgXcQ", - class: "primary_button", - color: "red", -})) - // ANCHOR_END: attributes -} - -#[rustfmt::skip] -pub fn VariableAttributes(cx: Scope) -> Element { - // ANCHOR: variable_attributes -let written_in_rust = true; -let button_type = "button"; -cx.render(rsx!(button { - disabled: "{written_in_rust}", - class: "{button_type}", - "Rewrite it in rust" -})) - // ANCHOR_END: variable_attributes -} - -#[rustfmt::skip] -pub fn CustomAttributes(cx: Scope) -> Element { - // ANCHOR: custom_attributes - cx.render(rsx!(b { - "customAttribute": "value", - })) - // ANCHOR_END: custom_attributes -} - -#[rustfmt::skip] -pub fn Formatting(cx: Scope) -> Element { - // ANCHOR: formatting -let coordinates = (42, 0); -let country = "es"; -cx.render(rsx!(div { - class: "country-{country}", - "position": "{coordinates:?}", - // arbitrary expressions are allowed, - // as long as they don't contain `{}` - div { - "{country.to_uppercase()}" - }, - div { - "{7*6}" - }, - // {} can be escaped with {{}} - div { - "{{}}" - }, -})) -// ANCHOR_END: formatting -} - -#[rustfmt::skip] -pub fn Expression(cx: Scope) -> Element { - // ANCHOR: expression -let text = "Dioxus"; -cx.render(rsx!(span { - text.to_uppercase(), - // create a list of text from 0 to 9 - (0..10).map(|i| rsx!{ i.to_string() }) -})) - // ANCHOR_END: expression -} - -#[rustfmt::skip] -pub fn Loops(cx: Scope) -> Element { - // ANCHOR: loops -cx.render(rsx!{ - // use a for loop where the body itself is RSX - div { - // create a list of text from 0 to 9 - for i in 0..3 { - // NOTE: the body of the loop is RSX not a rust statement - div { - "{i}" - } - } - } - // iterator equivalent - div { - (0..3).map(|i| rsx!{ div { "{i}" } }) - } -}) - // ANCHOR_END: loops -} - -#[rustfmt::skip] -pub fn IfStatements(cx: Scope) -> Element { - // ANCHOR: ifstatements -cx.render(rsx!{ - // use if statements without an else - if true { - rsx!(div { "true" }) - } -}) - // ANCHOR_END: ifstatements -} diff --git a/docs/guide/examples/server_basic.rs b/docs/guide/examples/server_basic.rs deleted file mode 100644 index 858fcfd50..000000000 --- a/docs/guide/examples/server_basic.rs +++ /dev/null @@ -1,30 +0,0 @@ -#![allow(non_snake_case, unused)] -use dioxus::prelude::*; - -#[tokio::main] -async fn main() { - #[cfg(feature = "ssr")] - { - use dioxus_fullstack::prelude::*; - - let addr = std::net::SocketAddr::from(([127, 0, 0, 1], 8080)); - axum::Server::bind(&addr) - .serve( - axum::Router::new() - .serve_dioxus_application("", ServeConfigBuilder::new(app, ())) - .into_make_service(), - ) - .await - .unwrap(); - } -} - -fn app(cx: Scope) -> Element { - let mut count = use_state(cx, || 0); - - cx.render(rsx! { - h1 { "High-Five counter: {count}" } - button { onclick: move |_| count += 1, "Up high!" } - button { onclick: move |_| count -= 1, "Down low!" } - }) -} diff --git a/docs/guide/examples/server_context.rs b/docs/guide/examples/server_context.rs deleted file mode 100644 index 172b978e9..000000000 --- a/docs/guide/examples/server_context.rs +++ /dev/null @@ -1,109 +0,0 @@ -#![allow(non_snake_case, unused)] -use dioxus::prelude::*; -use dioxus_fullstack::prelude::*; - -fn main() { - #[cfg(feature = "web")] - dioxus_web::launch_with_props( - app, - // Get the root props from the document - get_root_props_from_document().unwrap_or_default(), - dioxus_web::Config::new().hydrate(true), - ); - #[cfg(feature = "ssr")] - { - use axum::extract::Path; - use axum::extract::State; - use axum::routing::get; - - tokio::runtime::Runtime::new() - .unwrap() - .block_on(async move { - let addr = std::net::SocketAddr::from(([127, 0, 0, 1], 8080)); - axum::Server::bind(&addr) - .serve( - axum::Router::new() - // Serve the dist folder with the static javascript and WASM files created by the dixous CLI - .serve_static_assets("./dist") - // Register server functions - .register_server_fns("") - // Connect to the hot reload server in debug mode - .connect_hot_reload() - // Render the application. This will serialize the root props (the intial count) into the HTML - .route( - "/", - get(move |State(ssr_state): State| async move { axum::body::Full::from( - ssr_state.render( - &ServeConfigBuilder::new( - app, - 0, - ) - .build(), - ) - )}), - ) - // Render the application with a different intial count - .route( - "/:initial_count", - get(move |Path(intial_count): Path, State(ssr_state): State| async move { axum::body::Full::from( - ssr_state.render( - &ServeConfigBuilder::new( - app, - intial_count, - ) - .build(), - ) - )}), - ) - .with_state(SSRState::default()) - .into_make_service(), - ) - .await - .unwrap(); - }); - } -} - -fn app(cx: Scope) -> Element { - let mut count = use_state(cx, || *cx.props); - - cx.render(rsx! { - h1 { "High-Five counter: {count}" } - button { onclick: move |_| count += 1, "Up high!" } - button { onclick: move |_| count -= 1, "Down low!" } - button { - onclick: move |_| { - to_owned![count]; - async move { - // Call the server function just like a local async function - if let Ok(new_count) = double_server(*count.current()).await { - count.set(new_count); - } - } - }, - "Double" - } - }) -} - -// We use the "getcbor" encoding to make caching easier -#[server(DoubleServer, "", "getcbor")] -async fn double_server(number: usize) -> Result { - let cx = server_context(); - // Perform some expensive computation or access a database on the server - tokio::time::sleep(std::time::Duration::from_secs(1)).await; - let result = number * 2; - - println!( - "User Agent {:?}", - cx.request_parts().headers.get("User-Agent") - ); - - // Set the cache control header to 1 hour on the post request - cx.response_headers_mut() - .insert("Cache-Control", "max-age=3600".parse().unwrap()); - - println!("server calculated {result}"); - - Ok(result) -} diff --git a/docs/guide/examples/server_context_state.rs b/docs/guide/examples/server_context_state.rs deleted file mode 100644 index 0f0b541cc..000000000 --- a/docs/guide/examples/server_context_state.rs +++ /dev/null @@ -1,134 +0,0 @@ -#![allow(non_snake_case, unused)] -use dioxus::prelude::*; -use dioxus_fullstack::prelude::*; - -#[cfg(feature = "ssr")] -#[derive(Default, Clone)] -struct ServerFunctionState { - call_count: std::sync::Arc, -} - -fn main() { - #[cfg(feature = "web")] - dioxus_web::launch_with_props( - app, - // Get the root props from the document - get_root_props_from_document().unwrap_or_default(), - dioxus_web::Config::new().hydrate(true), - ); - #[cfg(feature = "ssr")] - { - use axum::body::Body; - use axum::extract::Path; - use axum::extract::State; - use axum::http::Request; - use axum::routing::get; - use std::sync::Arc; - - tokio::runtime::Runtime::new() - .unwrap() - .block_on(async move { - let addr = std::net::SocketAddr::from(([127, 0, 0, 1], 8080)); - axum::Server::bind(&addr) - .serve( - axum::Router::new() - // Serve the dist folder with the static javascript and WASM files created by the dixous CLI - .serve_static_assets("./dist") - // Register server functions - .register_server_fns_with_handler("", |func| { - move |State(server_fn_state): State, req: Request| async move { - let (parts, body) = req.into_parts(); - let parts: Arc = Arc::new(parts.into()); - let mut server_context = DioxusServerContext::new(parts.clone()); - server_context.insert(server_fn_state); - server_fn_handler(server_context, func.clone(), parts, body).await - } - }) - .with_state(ServerFunctionState::default()) - // Connect to the hot reload server in debug mode - .connect_hot_reload() - // Render the application. This will serialize the root props (the intial count) into the HTML - .route( - "/", - get(move |State(ssr_state): State| async move { axum::body::Full::from( - ssr_state.render( - &ServeConfigBuilder::new( - app, - 0, - ) - .build(), - ) - )}), - ) - // Render the application with a different intial count - .route( - "/:initial_count", - get(move |Path(intial_count): Path, State(ssr_state): State| async move { axum::body::Full::from( - ssr_state.render( - &ServeConfigBuilder::new( - app, - intial_count, - ) - .build(), - ) - )}), - ) - .with_state(SSRState::default()) - .into_make_service(), - ) - .await - .unwrap(); - }); - } -} - -fn app(cx: Scope) -> Element { - let mut count = use_state(cx, || *cx.props); - - cx.render(rsx! { - h1 { "High-Five counter: {count}" } - button { onclick: move |_| count += 1, "Up high!" } - button { onclick: move |_| count -= 1, "Down low!" } - button { - onclick: move |_| { - to_owned![count]; - async move { - // Call the server function just like a local async function - if let Ok(new_count) = double_server(*count.current()).await { - count.set(new_count); - } - } - }, - "Double" - } - }) -} - -// We use the "getcbor" encoding to make caching easier -#[server(DoubleServer, "", "getcbor")] -async fn double_server(number: usize) -> Result { - // Perform some expensive computation or access a database on the server - tokio::time::sleep(std::time::Duration::from_secs(1)).await; - let result = number * 2; - let cx = server_context(); - - println!( - "User Agent {:?}", - cx.request_parts().headers.get("User-Agent") - ); - - // Set the cache control header to 1 hour on the post request - cx.response_headers_mut() - .insert("Cache-Control", "max-age=3600".parse().unwrap()); - - // Get the server function state - let server_fn_state = cx.get::().unwrap(); - let call_count = server_fn_state - .call_count - .fetch_add(1, std::sync::atomic::Ordering::SeqCst); - println!("server functions have been called {call_count} times"); - - println!("server calculated {result}"); - - Ok(result) -} diff --git a/docs/guide/examples/server_function.rs b/docs/guide/examples/server_function.rs deleted file mode 100644 index 55f5104f9..000000000 --- a/docs/guide/examples/server_function.rs +++ /dev/null @@ -1,96 +0,0 @@ -#![allow(non_snake_case, unused)] -use dioxus::prelude::*; -use dioxus_fullstack::prelude::*; - -fn main() { - #[cfg(feature = "web")] - dioxus_web::launch_with_props( - app, - // Get the root props from the document - get_root_props_from_document().unwrap_or_default(), - dioxus_web::Config::new().hydrate(true), - ); - #[cfg(feature = "ssr")] - { - use axum::extract::Path; - use axum::extract::State; - use axum::routing::get; - - tokio::runtime::Runtime::new() - .unwrap() - .block_on(async move { - let addr = std::net::SocketAddr::from(([127, 0, 0, 1], 8080)); - axum::Server::bind(&addr) - .serve( - axum::Router::new() - // Serve the dist folder with the static javascript and WASM files created by the dixous CLI - .serve_static_assets("./dist") - // Register server functions - .register_server_fns("") - // Connect to the hot reload server in debug mode - .connect_hot_reload() - // Render the application. This will serialize the root props (the intial count) into the HTML - .route( - "/", - get(move |Path(intial_count): Path, State(ssr_state): State| async move { axum::body::Full::from( - ssr_state.render( - &ServeConfigBuilder::new( - app, - intial_count, - ) - .build(), - ) - )}), - ) - // Render the application with a different intial count - .route( - "/:initial_count", - get(move |Path(intial_count): Path, State(ssr_state): State| async move { axum::body::Full::from( - ssr_state.render( - &ServeConfigBuilder::new( - app, - intial_count, - ) - .build(), - ) - )}), - ) - .with_state(SSRState::default()) - .into_make_service(), - ) - .await - .unwrap(); - }); - } -} - -fn app(cx: Scope) -> Element { - let mut count = use_state(cx, || *cx.props); - - cx.render(rsx! { - h1 { "High-Five counter: {count}" } - button { onclick: move |_| count += 1, "Up high!" } - button { onclick: move |_| count -= 1, "Down low!" } - button { - onclick: move |_| { - to_owned![count]; - async move { - // Call the server function just like a local async function - if let Ok(new_count) = double_server(*count.current()).await { - count.set(new_count); - } - } - }, - "Double" - } - }) -} - -#[server(DoubleServer)] -async fn double_server(number: usize) -> Result { - // Perform some expensive computation or access a database on the server - tokio::time::sleep(std::time::Duration::from_secs(1)).await; - let result = number * 2; - println!("server calculated {result}"); - Ok(result) -} diff --git a/docs/guide/examples/spawn.rs b/docs/guide/examples/spawn.rs deleted file mode 100644 index 90c311200..000000000 --- a/docs/guide/examples/spawn.rs +++ /dev/null @@ -1,84 +0,0 @@ -#![allow(non_snake_case, unused)] - -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -fn App(cx: Scope) -> Element { - // ANCHOR: spawn - let logged_in = use_state(cx, || false); - - let log_in = move |_| { - cx.spawn({ - let logged_in = logged_in.to_owned(); - - async move { - let resp = reqwest::Client::new() - .post("http://example.com/login") - .send() - .await; - - match resp { - Ok(_data) => { - println!("Login successful!"); - logged_in.set(true); - } - Err(_err) => { - println!( - "Login failed - you need a login server running on localhost:8080." - ) - } - } - } - }); - }; - - cx.render(rsx! { - button { - onclick: log_in, - "Login", - } - }) - // ANCHOR_END: spawn -} - -pub fn Tokio(cx: Scope) -> Element { - let _ = || { - // ANCHOR: tokio - cx.spawn(async { - let _ = tokio::spawn(async {}).await; - - let _ = tokio::task::spawn_local(async { - // some !Send work - }) - .await; - }); - // ANCHOR_END: tokio - }; - - cx.render(rsx!(())) -} - -pub fn ToOwnedMacro(cx: Scope) -> Element { - let count = use_state(cx, || 0); - let age = use_state(cx, || 0); - let name = use_state(cx, || 0); - let description = use_state(cx, || 0); - - let _ = || { - // ANCHOR: to_owned_macro - use dioxus::hooks::to_owned; - - cx.spawn({ - to_owned![count, age, name, description]; - async move { - // ... - } - }); - // ANCHOR_END: to_owned_macro - }; - - cx.render(rsx!(())) -} diff --git a/docs/guide/examples/use_future.rs b/docs/guide/examples/use_future.rs deleted file mode 100644 index 01464704a..000000000 --- a/docs/guide/examples/use_future.rs +++ /dev/null @@ -1,62 +0,0 @@ -#![allow(non_snake_case, unused)] - -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -#[derive(serde::Deserialize, Debug)] -struct ApiResponse { - #[serde(rename = "message")] - image_url: String, -} - -#[rustfmt::skip] -fn App(cx: Scope) -> Element { -// ANCHOR: use_future -let future = use_future(cx, (), |_| async move { - reqwest::get("https://dog.ceo/api/breeds/image/random") - .await - .unwrap() - .json::() - .await -}); -// ANCHOR_END: use_future - -// ANCHOR: render -cx.render(match future.value() { - Some(Ok(response)) => rsx! { - button { - onclick: move |_| future.restart(), - "Click to fetch another doggo" - } - div { - img { - max_width: "500px", - max_height: "500px", - src: "{response.image_url}", - } - } - }, - Some(Err(_)) => rsx! { div { "Loading dogs failed" } }, - None => rsx! { div { "Loading dogs..." } }, -}) -// ANCHOR_END: render -} - -#[rustfmt::skip] -#[inline_props] -fn RandomDog(cx: Scope, breed: String) -> Element { -// ANCHOR: dependency -let future = use_future(cx, (breed,), |(breed,)| async move { - reqwest::get(format!("https://dog.ceo/api/breed/{breed}/images/random")) - .await - .unwrap() - .json::() - .await -}); -// ANCHOR_END: dependency - - cx.render(rsx!(())) -} diff --git a/docs/guide/src/en/SUMMARY.md b/docs/guide/src/en/SUMMARY.md deleted file mode 100644 index a44439200..000000000 --- a/docs/guide/src/en/SUMMARY.md +++ /dev/null @@ -1,57 +0,0 @@ -# Summary - -[Introduction](index.md) - -- [Getting Started](getting_started/index.md) - - [Desktop](getting_started/desktop.md) - - [Web](getting_started/web.md) - - [Server-Side Rendering](getting_started/ssr.md) - - [Fullstack](getting_started/fullstack.md) - - [Liveview](getting_started/liveview.md) - - [Terminal UI](getting_started/tui.md) - - [Mobile](getting_started/mobile.md) - - [Hot Reloading](getting_started/hot_reload.md) -- [Describing the UI](describing_ui/index.md) - - [Special Attributes](describing_ui/special_attributes.md) - - [Components](describing_ui/components.md) - - [Props](describing_ui/component_props.md) - - [Component Children](describing_ui/component_children.md) -- [Interactivity](interactivity/index.md) - - [Event Listeners](interactivity/event_handlers.md) - - [Hooks & Component State](interactivity/hooks.md) - - [User Input](interactivity/user_input.md) - - [Sharing State](interactivity/sharing_state.md) - - [Memoization](interactivity/memoization.md) - - [Custom Hooks](interactivity/custom_hooks.md) - - [Dynamic Rendering](interactivity/dynamic_rendering.md) - - [Routing](interactivity/router.md) -- [Async](async/index.md) - - [UseEffect](async/use_effect.md) - - [UseFuture](async/use_future.md) - - [UseCoroutine](async/use_coroutine.md) - - [Spawning Futures](async/spawn.md) -- [Best Practices](best_practices/index.md) - - [Error Handling](best_practices/error_handling.md) - - [Antipatterns](best_practices/antipatterns.md) -- [Publishing](publishing/index.md) - - - [Desktop](publishing/desktop.md) - - [Web](publishing/web.md) - ---- - -- [Fullstack](fullstack/index.md) - - [Getting Started](fullstack/getting_started.md) - - [Communicating with the Server](fullstack/server_functions.md) - ---- - -- [Custom Renderer](custom_renderer/index.md) - ---- - -- [Contributing](contributing/index.md) - - [Project Structure](contributing/project_structure.md) - - [Walkthrough of Internals](contributing/walkthrough_readme.md) - - [Guiding Principles](contributing/guiding_principles.md) - - [Roadmap](contributing/roadmap.md) diff --git a/docs/guide/src/en/__unused/README.md b/docs/guide/src/en/__unused/README.md deleted file mode 100644 index 0a3583ef1..000000000 --- a/docs/guide/src/en/__unused/README.md +++ /dev/null @@ -1,6 +0,0 @@ -This directory includes: - -- Very outdated docs -- Docs for features which haven't been implemented (yet?) -- Information which has already been covered in the guide in a more organized fashion -- A few things yet to be integrated into the guide nicely \ No newline at end of file diff --git a/docs/guide/src/en/__unused/advanced-guides/06-subscription-api.md b/docs/guide/src/en/__unused/advanced-guides/06-subscription-api.md deleted file mode 100644 index 1d53a8d61..000000000 --- a/docs/guide/src/en/__unused/advanced-guides/06-subscription-api.md +++ /dev/null @@ -1,33 +0,0 @@ -# Subscriptions - -Yew subscriptions are used to schedule update for components into the future. The `Context` object can create subscriptions: - -```rust, no_run -fn Component(cx: Component) -> DomTree { - let update = cx.schedule(); - - // Now, when the subscription is called, the component will be re-evaluated - update.consume(); -} -``` - -Whenever a component's subscription is called, the component will then re-evaluated. You can consider the input properties of -a component to be just another form of subscription. By default, the Dioxus component system automatically diffs a component's props -when the parent function is called, and if the props are different, the child component's subscription is called. - -The subscription API exposes this functionality allowing hooks and state management solutions the ability to update components whenever -some state or event occurs outside of the component. For instance, the `use_context` hook uses this to subscribe components that use a -particular context. - -```rust, no_run -fn use_context(cx: Scope) -> I { - -} - - - - - - - -``` diff --git a/docs/guide/src/en/__unused/advanced-guides/10-concurrent-mode.md b/docs/guide/src/en/__unused/advanced-guides/10-concurrent-mode.md deleted file mode 100644 index b92897157..000000000 --- a/docs/guide/src/en/__unused/advanced-guides/10-concurrent-mode.md +++ /dev/null @@ -1,82 +0,0 @@ -# Concurrent mode - -Concurrent mode provides a mechanism for building efficient asynchronous components. With this feature, components don't need to render immediately, and instead can schedule a future render by returning a future. - -To make a component asynchronous, simply change its function signature to async. - -```rust, no_run -fn Example(cx: Scope) -> Vnode { - rsx!{
"Hello world!"
} -} -``` - -becomes - -```rust, no_run -async fn Example(cx: Scope) -> Vnode { - rsx!{
"Hello world!"
} -} -``` - -Now, logic in components can be awaited to delay updates of the component and its children. Like so: - -```rust, no_run -async fn Example(cx: Scope) -> Vnode { - let name = fetch_name().await; - rsx!{
"Hello {name}"
} -} - -async fetch_name() -> String { - // ... -} -``` - -This component will only schedule its render once the fetch is complete. However, we _don't_ recommend using async/await directly in your components. - -Async is a notoriously challenging yet rewarding tool for efficient tools. If not careful, locking and unlocking shared aspects of the component's context can lead to data races and panics. If a shared resource is locked while the component is awaiting, then other components can be locked or panic when trying to access the same resource. These rules are especially important when references to shared global state are accessed using the context object's lifetime. If mutable references to data captured immutably by the context are taken, then the component will panic, causing confusion. - -Instead, we suggest using hooks and future combinators that can safely utilize the safeguards of the component's Context when interacting with async tasks. - -As part of our Dioxus hooks crate, we provide a data loader hook which pauses a component until its async dependencies are ready. This caches requests, reruns the fetch if dependencies have changed, and provides the option to render something else while the component is loading. - -```rust, no_run -async fn ExampleLoader(cx: Scope) -> Vnode { - /* - Fetch, pause the component from rendering at all. - - The component is locked while waiting for the request to complete - While waiting, an alternate component is scheduled in its place. - - This API stores the result on the Context object, so the loaded data is taken as reference. - */ - let name: &Result = use_fetch_data("http://example.com/json", ()) - .place_holder(|cx| rsx!{
"loading..."
}) - .delayed_place_holder(1000, |cx| rsx!{
"still loading..."
}) - .await; - - match name { - Ok(name) => rsx! {
"Hello {something}"
}, - Err(e) => rsx! {
"An error occurred :("
} - } -} -``` - -```rust, no_run -async fn Example(cx: Scope) -> DomTree { - // Diff this set between the last set - // Check if we have any outstanding tasks? - // - // Eventually, render the component into the VDOM when the future completes -
- -
- - // Render a div, queue a component - // Render the placeholder first, then when the component is ready, then render the component -
- "Loading"
}}> - - - -} -``` diff --git a/docs/guide/src/en/__unused/advanced-guides/11-arena-memo.md b/docs/guide/src/en/__unused/advanced-guides/11-arena-memo.md deleted file mode 100644 index 49fedda11..000000000 --- a/docs/guide/src/en/__unused/advanced-guides/11-arena-memo.md +++ /dev/null @@ -1,58 +0,0 @@ -# Memoization and the arena allocator - -Dioxus differs slightly from other UI virtual doms in some subtle ways due to its memory allocator. - -One important aspect to understand is how props are passed down from parent components to children. All "components" (custom user-made UI elements) are tightly allocated together in an arena. However, because props and hooks are generically typed, they are casted to `Any` and allocated on the heap – not in the arena with the components. - -With this system, we try to be more efficient when leaving the component arena and entering the heap. By default, props are memoized between renders using COW and context. This makes props comparisons fast – done via ptr comparisons on the cow pointer. Because memoization is done by default, parent re-renders will _not_ cascade to children if the child's props did not change. - -https://dmitripavlutin.com/use-react-memo-wisely/ - -This behavior is defined as an attribute implicit to user components. When in React land you might wrap a component with `react.memo`, Dioxus components are automatically memoized via an implicit attribute. You can manually configure this behavior on any component with "nomemo" to disable memoization. - -```rust, no_run -fn test() -> DomTree { - html! { - <> - - // same as - - - } -} - -static TestComponent: Component = |cx| html!{
"Hello world"
}; - -static TestComponent: Component = |cx|{ - let g = "BLAH"; - html! { -
"Hello world"
- } -}; - -#[inline_props] -fn test_component(cx: Scope, name: String) -> Element { - render!("Hello, {name}") -} -``` - -## Why this behavior? - -"This is different than React, why differ?". - -Take a component like this: - -```rust, no_run -fn test(cx: Scope) -> DomTree { - let Bundle { alpha, beta, gamma } = use_context::(cx); - html! { -
- - - -
- } -} -``` - -While the contents of the destructured bundle might change, not every child component will need to be re-rendered every time the context changes. diff --git a/docs/guide/src/en/__unused/advanced-guides/12-signals.md b/docs/guide/src/en/__unused/advanced-guides/12-signals.md deleted file mode 100644 index 7fbb56de7..000000000 --- a/docs/guide/src/en/__unused/advanced-guides/12-signals.md +++ /dev/null @@ -1,150 +0,0 @@ -# Signals: Skipping the Diff - -In most cases, the traditional VirtualDOM diffing pattern is plenty fast. Dioxus will compare trees of VNodes, find the differences, and then update the Renderer's DOM with the diffs. However, this can generate a lot of overhead for certain types of components. In apps where reducing visual latency is a top priority, you can opt into the `Signals` api to entirely disable diffing of hot-path components. Dioxus will then automatically construct a state machine for your component, making updates nearly instant. - -Signals build on the same infrastructure that powers asynchronous rendering where in-tree values can be updated outside of the render phase. In async rendering, a future is used as the signal source. With the raw signal API, any value can be used as a signal source. - -By default, Dioxus will only try to diff subtrees of components with dynamic content, automatically skipping diffing static content. - -## What does this look like? - -Your component today might look something like this: - -```rust, no_run -fn Comp(cx: Scope) -> DomTree { - let (title, set_title) = use_state(cx, || "Title".to_string()); - cx.render(rsx!{ - input { - value: title, - onchange: move |new| set_title(new.value()) - } - }) -} -``` - -This component is fairly straightforward – the input updates its own value on every change. However, every call to set_title will re-render the component. If we add a large list, then every time we update the title input, Dioxus will need to diff the entire list, over, and over, and over. This is **a lot** of wasted clock-cycles! - -```rust, no_run -fn Comp(cx: Scope) -> DomTree { - let (title, set_title) = use_state(cx, || "Title".to_string()); - cx.render(rsx!{ - div { - input { - value: title, - onchange: move |new| set_title(new.value()) - } - ul { - {0..10000.map(|f| rsx!{ - li { "{f}" } - })} - } - } - }) -} -``` - -Many experienced React developers will just say "this is bad design" – but we consider it to be a pit of failure, rather than a pit of success! That's why signals exist – to push you in a more performant (and ergonomic) direction. Signals let us directly bind values to their final place in the VirtualDOM. Whenever the signal value is updated, Dioxus will only the DOM nodes where that signal is used. Signals are built into Dioxus, so we can directly bind attributes of elements to their updates. - -We can use signals to generate a two-way binding between data and the input box. Our text input is now just a two-line component! - -```rust, no_run -fn Comp(cx: Scope) -> DomTree { - let mut title = use_signal(cx, || String::from("Title")); - cx.render(rsx!(input { value: title })) -} -``` - -For a slightly more interesting example, this component calculates the sum between two numbers, but totally skips the diffing process. - -```rust, no_run -fn Calculator(cx: Scope) -> DomTree { - let mut a = use_signal(cx, || 0); - let mut b = use_signal(cx, || 0); - let mut c = a + b; - rsx! { - input { value: a } - input { value: b } - p { "a + b = {c}" } - } -} -``` - -Do you notice how we can use built-in operations on signals? Under the hood, we actually create a new derived signal that depends on `a` and `b`. Whenever `a` or `b` update, then `c` will update. If we need to create a new derived signal that's more complex than a basic operation (`std::ops`) we can either chain signals together or combine them: - -```rust, no_run -let mut a = use_signal(cx, || 0); -let mut b = use_signal(cx, || 0); - -// Chain signals together using the `with` method -let c = a.with(b).map(|(a, b)| *a + *b); -``` - -## Deref and DerefMut - -If we ever need to get the value out of a signal, we can simply `deref` it. - -```rust, no_run -let mut a = use_signal(cx, || 0); -let c = *a + *b; -``` - -Calling `deref` or `deref_mut` is actually more complex than it seems. When a value is derefed, you're essentially telling Dioxus that _this_ element _needs_ to be subscribed to the signal. If a signal is derefed outside of an element, the entire component will be subscribed and the advantage of skipping diffing will be lost. Dioxus will throw an error in the console when this happens to tell you that you're using signals wrong, but your component will continue to work. - -## Global Signals - -Sometimes you want a signal to propagate across your app, either through far-away siblings or through deeply-nested components. In these cases, we use Dirac: Dioxus's first-class state management toolkit. Dirac atoms automatically implement the Signal API. This component will bind the input element to the `TITLE` atom. - - -```rust, no_run -const TITLE: Atom = Atom(|| "".to_string()); - -const Provider: Component = |cx|{ - let title = use_signal(cx, &TITLE); - render!(input { value: title }) -}; -``` - -If we use the `TITLE` atom in another component, we can cause updates to flow between components without calling render or diffing either component trees: - -```rust, no_run -const Receiver: Component = |cx|{ - let title = use_signal(cx, &TITLE); - log::info!("This will only be called once!"); - rsx!(cx, - div { - h1 { "{title}" } - div {} - footer {} - } - ) -}; -``` - -Dioxus knows that the receiver's `title` signal is used only in the text node, and skips diffing Receiver entirely, knowing to update _just_ the text node. - -If you build a complex app on top of Dirac, you'll likely notice that many of your components simply won't be diffed at all. For instance, our Receiver component will never be diffed once it has been mounted! - -## Signals and Iterators - -Sometimes you want to use a collection of items. With Signals, you can bypass diffing for collections – a very powerful technique to avoid re-rendering on large collections. - -By default, Dioxus is limited when you use iter/map. With the `For` component, you can provide an iterator and a function for the iterator to map to. - -Dioxus automatically understands how to use your signals when mixed with iterators through `Deref`/`DerefMut`. This lets you efficiently map collections while avoiding the re-rendering of lists. In essence, signals act as a hint to Dioxus on how to avoid un-necessary checks and renders, making your app faster. - -```rust, no_run -const DICT: AtomFamily = AtomFamily(|_| {}); - -const List: Component = |cx|{ - let dict = use_signal(cx, &DICT); - cx.render(rsx!( - ul { - For { each: dict, map: |k, v| rsx!( li { "{v}" }) } - } - )) -}; -``` - -## How does it work? - -Signals internally use Dioxus' asynchronous rendering infrastructure to perform updates out of the tree. diff --git a/docs/guide/src/en/__unused/advanced-guides/13-subtrees.md b/docs/guide/src/en/__unused/advanced-guides/13-subtrees.md deleted file mode 100644 index d7a8ba1d7..000000000 --- a/docs/guide/src/en/__unused/advanced-guides/13-subtrees.md +++ /dev/null @@ -1,52 +0,0 @@ -# Subtrees - -One way of extending the Dioxus VirtualDom is through the use of "Subtrees." Subtrees are chunks of the VirtualDom tree distinct from the rest of the tree. They still participate in event bubbling, diffing, etc, but will have a separate set of edits generated during the diff phase. - -For a VirtualDom that has a root tree with two subtrees, the edits follow a pattern of: - -Root --> Tree 1 --> Tree 2 --> Original root tree - -- Root edits -- Tree 1 Edits -- Tree 2 Edits -- Root Edits - -The goal of this functionality is to enable things like Portals, Windows, and inline alternative renderers without needing to spin up a new VirtualDom. - -With the right renderer plugins, a subtree could be rendered as anything – a 3D scene, SVG, or even as the contents of a new window or modal. This functionality is similar to "Portals" in React, but much more "renderer agnostic." Portals, by nature, are not necessarily cross-platform and rely on renderer functionality, so it makes sense to abstract their purpose into the subtree concept. - -The desktop renderer comes pre-loaded with the window and notification subtree plugins, making it possible to render subtrees into entirely different windows. - -Subtrees also solve the "bridging" issues in React where two different renderers need two different VirtualDoms to work properly. In Dioxus, you only ever need one VirtualDom and the right renderer plugins. - -## API - -Due to their importance in the hierarchy, Components – not nodes – are treated as subtree roots. - -```rust, no_run - -fn Subtree

(cx: Scope

) -> DomTree { - -} - -fn Window() -> DomTree { - Subtree { - onassign: move |e| { - // create window - } - children() - } -} - -fn 3dRenderer -> DomTree { - Subtree { - onassign: move |e| { - // initialize bevy - } - } -} - -``` diff --git a/docs/guide/src/en/__unused/advanced-guides/custom-renderer.md b/docs/guide/src/en/__unused/advanced-guides/custom-renderer.md deleted file mode 100644 index b14243dae..000000000 --- a/docs/guide/src/en/__unused/advanced-guides/custom-renderer.md +++ /dev/null @@ -1,280 +0,0 @@ -# Custom Renderer - -Dioxus is an incredibly portable framework for UI development. The lessons, knowledge, hooks, and components you acquire over time can always be used for future projects. However, sometimes those projects cannot leverage a supported renderer or you need to implement your own better renderer. - -Great news: the design of the renderer is entirely up to you! We provide suggestions and inspiration with the 1st party renderers, but only really require implementation of the `RealDom` trait for things to function properly. - -## The specifics: - -Implementing the renderer is fairly straightforward. The renderer needs to: - -1. Handle the stream of edits generated by updates to the virtual DOM -2. Register listeners and pass events into the virtual DOM's event system -3. Progress the virtual DOM with an async executor (or disable the suspense API and use `progress_sync`) - -Essentially, your renderer needs to implement the `RealDom` trait and generate `EventTrigger` objects to update the VirtualDOM. From there, you'll have everything needed to render the VirtualDOM to the screen. - -Internally, Dioxus handles the tree relationship, diffing, memory management, and the event system, leaving as little as possible required for renderers to implement themselves. - -For reference, check out the WebSys renderer as a starting point for your custom renderer. - -## Trait implementation and DomEdits - -The current `RealDom` trait lives in `dioxus-core/diff`. A version of it is provided here (but might not be up-to-date): - -```rust, no_run -pub trait RealDom<'a> { - fn handle_edit(&mut self, edit: DomEdit); - fn request_available_node(&mut self) -> ElementId; - fn raw_node_as_any(&self) -> &mut dyn Any; -} -``` - -For reference, the "DomEdit" type is a serialized enum that represents an atomic operation occurring on the RealDom. The variants roughly follow this set: - -```rust, no_run -enum DomEdit { - PushRoot, - AppendChildren, - ReplaceWith, - CreateTextNode, - CreateElement, - CreateElementNs, - CreatePlaceholder, - NewEventListener, - RemoveEventListener, - SetText, - SetAttribute, - RemoveAttribute, -} -``` - -The Dioxus diffing mechanism operates as a [stack machine](https://en.wikipedia.org/wiki/Stack_machine) where the "push_root" method pushes a new "real" DOM node onto the stack and "append_child" and "replace_with" both remove nodes from the stack. - -### An example - -For the sake of understanding, lets consider this example – a very simple UI declaration: - -```rust, no_run -rsx!( h1 {"hello world"} ) -``` - -To get things started, Dioxus must first navigate to the container of this h1 tag. To "navigate" here, the internal diffing algorithm generates the DomEdit `PushRoot` where the ID of the root is the container. - -When the renderer receives this instruction, it pushes the actual Node onto its own stack. The real renderer's stack will look like this: - -```rust, no_run -instructions: [ - PushRoot(Container) -] -stack: [ - ContainerNode, -] -``` - -Next, Dioxus will encounter the h1 node. The diff algorithm decides that this node needs to be created, so Dioxus will generate the DomEdit `CreateElement`. When the renderer receives this instruction, it will create an unmounted node and push into its own stack: - -```rust, no_run -instructions: [ - PushRoot(Container), - CreateElement(h1), -] -stack: [ - ContainerNode, - h1, -] -``` - -Next, Dioxus sees the text node, and generates the `CreateTextNode` DomEdit: - -```rust, no_run -instructions: [ - PushRoot(Container), - CreateElement(h1), - CreateTextNode("hello world") -] -stack: [ - ContainerNode, - h1, - "hello world" -] -``` - -Remember, the text node is not attached to anything (it is unmounted) so Dioxus needs to generate an Edit that connects the text node to the h1 element. It depends on the situation, but in this case we use `AppendChildren`. This pops the text node off the stack, leaving the h1 element as the next element in line. - -```rust, no_run -instructions: [ - PushRoot(Container), - CreateElement(h1), - CreateTextNode("hello world"), - AppendChildren(1) -] -stack: [ - ContainerNode, - h1 -] -``` - -We call `AppendChildren` again, popping off the h1 node and attaching it to the parent: - -```rust, no_run -instructions: [ - PushRoot(Container), - CreateElement(h1), - CreateTextNode("hello world"), - AppendChildren(1), - AppendChildren(1) -] -stack: [ - ContainerNode, -] -``` - -Finally, the container is popped since we don't need it anymore. - -```rust, no_run -instructions: [ - PushRoot(Container), - CreateElement(h1), - CreateTextNode("hello world"), - AppendChildren(1), - AppendChildren(1), - Pop(1) -] -stack: [] -``` - -Over time, our stack looked like this: - -```rust, no_run -[] -[Container] -[Container, h1] -[Container, h1, "hello world"] -[Container, h1] -[Container] -[] -``` - -Notice how our stack is empty once UI has been mounted. Conveniently, this approach completely separates the VirtualDOM and the Real DOM. Additionally, these edits are serializable, meaning we can even manage UIs across a network connection. This little stack machine and serialized edits makes Dioxus independent of platform specifics. - -Dioxus is also really fast. Because Dioxus splits the diff and patch phase, it's able to make all the edits to the RealDOM in a very short amount of time (less than a single frame) making rendering very snappy. It also allows Dioxus to cancel large diffing operations if higher priority work comes in while it's diffing. - -It's important to note that there _is_ one layer of connectedness between Dioxus and the renderer. Dioxus saves and loads elements (the PushRoot edit) with an ID. Inside the VirtualDOM, this is just tracked as a u64. - -Whenever a `CreateElement` edit is generated during diffing, Dioxus increments its node counter and assigns that new element its current NodeCount. The RealDom is responsible for remembering this ID and pushing the correct node when PushRoot(ID) is generated. Dioxus doesn't reclaim IDs of elements its removed, but your renderer probably will want to. To do this, we suggest using a `SecondarySlotMap` if implementing the renderer in Rust, or just deferring to a HashMap-type approach. - -This little demo serves to show exactly how a Renderer would need to process an edit stream to build UIs. A set of serialized EditStreams for various demos is available for you to test your custom renderer against. - -## Event loop - -Like most GUIs, Dioxus relies on an event loop to progress the VirtualDOM. The VirtualDOM itself can produce events as well, so it's important that your custom renderer can handle those too. - -The code for the WebSys implementation is straightforward, so we'll add it here to demonstrate how simple an event loop is: - -```rust, no_run -pub async fn run(&mut self) -> dioxus_core::error::Result<()> { - // Push the body element onto the WebsysDom's stack machine - let mut websys_dom = crate::new::WebsysDom::new(prepare_websys_dom()); - websys_dom.stack.push(root_node); - - // Rebuild or hydrate the virtualdom - self.internal_dom.rebuild(&mut websys_dom)?; - - // Wait for updates from the real dom and progress the virtual dom - loop { - let user_input_future = websys_dom.wait_for_event(); - let internal_event_future = self.internal_dom.wait_for_event(); - - match select(user_input_future, internal_event_future).await { - Either::Left((trigger, _)) => trigger, - Either::Right((trigger, _)) => trigger, - } - } - - while let Some(trigger) = { - websys_dom.stack.push(body_element.first_child().unwrap()); - self.internal_dom - .progress_with_event(&mut websys_dom, trigger)?; - } -} -``` - -It's important that you decode the real events from your event system into Dioxus' synthetic event system (synthetic meaning abstracted). This simply means matching your event type and creating a Dioxus `VirtualEvent` type. Your custom event must implement the corresponding event trait. Right now, the VirtualEvent system is modeled almost entirely around the HTML spec, but we are interested in slimming it down. - -```rust, no_run -fn virtual_event_from_websys_event(event: &web_sys::Event) -> VirtualEvent { - match event.type_().as_str() { - "keydown" | "keypress" | "keyup" => { - struct CustomKeyboardEvent(web_sys::KeyboardEvent); - impl dioxus::events::KeyboardEvent for CustomKeyboardEvent { - fn char_code(&self) -> usize { self.0.char_code() } - fn ctrl_key(&self) -> bool { self.0.ctrl_key() } - fn key(&self) -> String { self.0.key() } - fn key_code(&self) -> usize { self.0.key_code() } - fn location(&self) -> usize { self.0.location() } - fn meta_key(&self) -> bool { self.0.meta_key() } - fn repeat(&self) -> bool { self.0.repeat() } - fn shift_key(&self) -> bool { self.0.shift_key() } - fn which(&self) -> usize { self.0.which() } - fn get_modifier_state(&self, key_code: usize) -> bool { self.0.get_modifier_state() } - } - VirtualEvent::KeyboardEvent(Rc::new(event.clone().dyn_into().unwrap())) - } - _ => todo!() -``` - -## Custom raw elements - -If you need to go as far as relying on custom elements for your renderer – you totally can. This still enables you to use Dioxus' reactive nature, component system, shared state, and other features, but will ultimately generate different nodes. All attributes and listeners for the HTML and SVG namespace are shuttled through helper structs that essentially compile away (pose no runtime overhead). You can drop in your own elements any time you want, with little hassle. However, you must be absolutely sure your renderer can handle the new type, or it will crash and burn. - -These custom elements are defined as unit structs with trait implementations. - -For example, the `div` element is (approximately!) defined as such: - -```rust, no_run -struct div; -impl div { - /// Some glorious documentation about the class property. - #[inline] - fn class<'a>(&self, cx: NodeFactory<'a>, val: Arguments) -> Attribute<'a> { - cx.attr("class", val, None, false) - } - // more attributes -} -``` - -You've probably noticed that many elements in the `rsx!` and `html!` macros support on-hover documentation. The approach we take to custom elements means that the unit struct is created immediately where the element is used in the macro. When the macro is expanded, the doc comments still apply to the unit struct, giving tons of in-editor feedback, even inside a proc macro. - -## Compatibility - -Forewarning: not every hook and service will work on your platform. Dioxus wraps things that need to be cross-platform in "synthetic" types. However, downcasting to a native type might fail if the types don't match. - -There are three opportunities for platform incompatibilities to break your program: - -1. When downcasting elements via `Ref.downcast_ref()` -2. When downcasting events via `Event.downcast_ref()` -3. Calling platform-specific APIs that don't exist - -The best hooks will properly detect the target platform and still provide functionality, failing gracefully when a platform is not supported. We encourage – and provide – an indication to the user on what platforms a hook supports. For issues 1 and 2, these return a result as to not cause panics on unsupported platforms. When designing your hooks, we recommend propagating this error upwards into user facing code, making it obvious that this particular service is not supported. - -This particular code _will panic_ due to the unwrap on downcast_ref. Try to avoid these types of patterns. - -```rust, no_run -let div_ref = use_node_ref(cx); - -cx.render(rsx!{ - div { ref: div_ref, class: "custom class", - button { "click me to see my parent's class" - onclick: move |_| if let Some(div_ref) = div_ref { - log::info!("Div class is {}", div_ref.downcast_ref::().unwrap().class()) - } - } - } -}) - -``` - -## Conclusion - -That should be it! You should have nearly all the knowledge required on how to implement your own renderer. We're super interested in seeing Dioxus apps brought to custom desktop renderers, mobile renderer, video game UI, and even augmented reality! If you're interesting in contributing to any of the these projects, don't be afraid to reach out or join the community. diff --git a/docs/guide/src/en/__unused/advanced-guides/liveview.md b/docs/guide/src/en/__unused/advanced-guides/liveview.md deleted file mode 100644 index e223c593e..000000000 --- a/docs/guide/src/en/__unused/advanced-guides/liveview.md +++ /dev/null @@ -1,32 +0,0 @@ -# Dioxus Liveview -Liveview is a configuration where a server and a client work together to render a Dioxus app. Liveview monomorphizes a web application, eliminating the need for frontend-specific APIs. - -This is a developer-friendly alternative to the JAM-stack (Javascript + API + Markdown), combining the Wasm-compatibility and async performance of Rust. - -## Why liveview? - -### No APIs necessary! -Because Liveview combines the server and the client, you'll find dedicated APIs unnecessary. You'll still want to implement a data-fetching service for Live-apps, but this can be implemented as a crate and shared between apps. This approach was designed to let you model out your data requirements without needing to maintain a public versioned API. - -You can find more information to data modeling and fetching for LiveApps in the "Book of Dioxus Patterns". - -### Ease of deployment -There is no hassle for deploying Dioxus liveview apps – simply upload the binary to your hosting provider of choice. There simply is no need to deal with intermediate APIs. An app's frontend and backend are tightly coupled to each other, meaning that the backed and frontend are always up to date. - -This is especially powerful for small teams, where fast iteration, versioned unique prototypes, and simple deployments are important. As your app grows, Dioxus will happily grow with you, serving up to 100K RPS (thanks to async Rust performance). - -### Power of server rendering combined with the reactive nature of JavaScript -Liveview apps are backed by a server and enhanced with web-assembly. This completely eliminates the need to write Javascript to add dynamic content to webpages. Apps are written in only **one** language and require essentially 0 knowledge of build systems, transpiling or ECMAScript versions. Minimum browser support is guaranteed to cover 95% of users, and the Dioxus-CLI can be configured to generate polyfills for even more support. - -### Support with LiveHost by Dioxus-Labs -The Dioxus-CLI comes ready for use with premium Dioxus-Labs services, like LiveHost. Simply link up your git repo to the Dioxus LiveHost and start deploying your fullstack Dioxus app today. LiveHost supports: - -- Versioned fronted/backend with unique links -- Builtin CI/CD -- Managed and pluggable storage database backends -- Serverless support for minimal latency -- Site Analytics -- Lighthouse optimization -- On-premise support (see license terms) - -Dioxus LiveHost is a Dioxus LiveApp management service with all supported features in a single binary. For OSS, we permit free usage and deployment of LiveHost to your favorite hosting provider. diff --git a/docs/guide/src/en/__unused/advanced-guides/rsx.md b/docs/guide/src/en/__unused/advanced-guides/rsx.md deleted file mode 100644 index 169a57875..000000000 --- a/docs/guide/src/en/__unused/advanced-guides/rsx.md +++ /dev/null @@ -1,67 +0,0 @@ -# VNodes with RSX, HTML, and NodeFactory - -Many modern frameworks provide a domain-specific-language for declaring user-interfaces. In the case of React, this language extension is called JSX and must be handled through additional dependencies and pre/post processors to transform your source code. With Rust, we can simply provide a procedural macro in the Dioxus dependency itself that mimics the JSX language. - -With Dioxus, we actually ship two different macros – a macro that mimics JSX (the `html!` macro) and a macro that mimics Rust's native nested-struct syntax (the `rsx!` macro). These macros simply transform their inputs into NodeFactory calls. - -For instance, this html! call: - -```rust, no_run -html!(

"hello world"
) -``` - -becomes this NodeFactory call: - -```rust, no_run -|f| f.element( - dioxus_elements::div, // tag - [], // listeners - [], // attributes - [f.static_text("hello world")], // children - None // key -) -``` - -The NodeFactory API is fairly ergonomic, making it a viable option to use directly. The NodeFactory API is also compile-time correct and has incredible syntax highlighting support. We use what Rust calls a "unit type" – the `dioxus_elements::div` and associated methods to ensure that a `div` can only have attributes associated with `div`s. This lets us tack on relevant documentation, autocomplete support, and jump-to-definition for methods and attributes. - -![Compile time correct syntax](../images/compiletimecorrect.png) - -## html! macro - -The html! macro supports a limited subset of the html standard. Rust's macro parsing tools are somewhat limited, so all text between tags _must be quoted_. - -However, writing HTML by hand is a bit tedious – IDE tools for Rust don't support linting/autocomplete/syntax highlighting. We suggest using RSX – it's more natural for Rust programs and _does_ integrate well with Rust IDE tools. - -```rust, no_run -let name = "jane"; -let pending = false; -let count = 10; - -dioxus::ssr::render_lazy(html! { -
-

"Hello, {name}!"

-

"Status: {pending}!"

-

"Count {count}!"

-
-}); -``` - -## rsx! macro - -The rsx! macro is a VNode builder macro designed especially for Rust programs. Writing these should feel very natural, much like assembling a struct. VSCode also supports these with code folding, bracket-tabbing, bracket highlighting, section selecting, inline documentation, GOTO definition, and refactoring support. - -When helpful, the Dioxus VSCode extension provides a way of converting a selection of HTML directly to RSX, so you can import templates from the web directly into your existing app. - -It's also a bit easier on the eyes than HTML. - -```rust, no_run -dioxus::ssr::render_lazy(rsx! { - div { - p {"Hello, {name}!"} - p {"Status: {pending}!"} - p {"Count {count}!"} - } -}); -``` - -In the next section, we'll cover the `rsx!` macro in more depth. diff --git a/docs/guide/src/en/__unused/advanced-guides/testing.md b/docs/guide/src/en/__unused/advanced-guides/testing.md deleted file mode 100644 index 405c929a9..000000000 --- a/docs/guide/src/en/__unused/advanced-guides/testing.md +++ /dev/null @@ -1,29 +0,0 @@ -## Testing - -To test your Rust code, you can annotate any function with the `#[test]` block. In VSCode with RA, this will provide a lens to click and run the test. - -```rust, no_run -#[test] -fn component_runs() { - assert!(true) -} -``` - -This will test your Rust code _without_ going through the browser. This is ideal for squashing logic bugs and ensuring components render appropriately when the browsers's DOM is not needed. If you need to run tests in the browser, you can annotate your blocks with the `#[dioxus::test]` block. - -```rust, no_run -#[dioxus::test] -fn runs_in_browser() { - // ... -} -``` - -Then, when you run - -```console -dx test --chrome -``` - -Dioxus will build and test your code using the Chrome browser as a harness. - -There's a lot more to testing if you dive in, so check out the [Testing]() guide for more information diff --git a/docs/guide/src/en/__unused/attribute_spreading.md b/docs/guide/src/en/__unused/attribute_spreading.md deleted file mode 100644 index 9bbb30698..000000000 --- a/docs/guide/src/en/__unused/attribute_spreading.md +++ /dev/null @@ -1,30 +0,0 @@ -In the cases where you need to pass arbitrary element properties into a component – say to add more functionality to the `` tag, Dioxus will accept any quoted fields. This is similar to adding arbitrary fields to regular elements using quotes. - -```rust, no_run - -rsx!( - Clickable { - "class": "blue-button", - "style": "background: red;" - } -) - -``` - -For a component to accept these attributes, you must add an `attributes` field to your component's properties. We can use the spread syntax to add these attributes to whatever nodes are in our component. - -```rust, no_run -#[derive(Props)] -struct ClickableProps<'a> { - attributes: Attributes<'a> -} - -fn clickable(cx: Scope>) -> Element { - cx.render(rsx!( - a { - ..cx.props.attributes, - "Any link, anywhere" - } - )) -} -``` diff --git a/docs/guide/src/en/__unused/composing.md b/docs/guide/src/en/__unused/composing.md deleted file mode 100644 index 82435d6f3..000000000 --- a/docs/guide/src/en/__unused/composing.md +++ /dev/null @@ -1,244 +0,0 @@ -# Thinking in Reactively - -We've finally reached the point in our tutorial where we can talk about the theory of Reactivity. We've talked about defining a declarative view, but not about the aspects that make our code _reactive_. - -Understanding the theory of reactive programming is essential to making sense of Dioxus and writing effective, performant UIs. - -In this section, we'll talk about: - -- One-way data flow -- Modifying data -- Forcing renders -- How renders propagate - -This section is a bit long, but worth the read. We recommend coffee, tea, and/or snacks. - -## Reactive Programming - -Dioxus is one of a handful of Rust libraries that provide a "Reactive Programming Model". The term "Reactive programming" is a classification of programming paradigm – much like functional or imperative programming. This is a very important distinction since it affects how we _think_ about our code. - -Reactive programming is a programming model concerned with deriving computations from asynchronous data flow. Most reactive programs are comprised of datasources, intermediate computations, and a final result. - -We consider the rendered GUI to be the final result of our Dioxus apps. The datasources for our apps include local and global state. - -For example, the model presented in the figure below is comprised of two data sources: time and a constant. These values are passed through our computation graph to achieve a final result: `g`. - -![Reactive Model](https://upload.wikimedia.org/wikipedia/commons/thumb/e/e9/Reactive_programming_glitches.svg/440px-Reactive_programming_glitches.svg.png) - -Whenever our `seconds` variable changes, we will then reevaluate the computation for `t`. Because `g` relies on `t`, we will also reevaluate its computation too. Notice that we would've reevaluated the computation for `g` even if `t` didn't change because `seconds` is used to calculate `g`. - -However, if we somehow changed our constant from `1` to `2`, then we need to reevaluate `t`. If, for whatever reason, this change did not affect the result of `t`, then we wouldn't try to reevaluate `g`. - -In Reactive Programming, we don't think about whether or not we should reevaluate `t` or `g`; instead, we simply provide functions of computation and let the framework figure out the rest for us. - -In Rust, our reactive app would look something like: - -```rust, no_run -fn compute_g(t: i32, seconds: i32) -> bool { - t > seconds -} - -fn compute_t(constant: i32, seconds: i32) -> i32 { - constant + seconds -} - -fn compute_graph(constant: i32, seconds: i32) -> bool { - let t = compute_t(constant, seconds); - let g = compute_g(t, seconds); - g -} -``` - -## How is Dioxus Reactive? - -The Dioxus VirtualDom provides us a framework for reactive programming. When we build apps with dioxus, we need to provide our own datasources. This can be either initial props or some values fetched from the network. We then pass this data through our app into components through properties. - -If we represented the reactive graph presented above in Dioxus, it would look very similar: - -```rust, no_run -// Declare a component that holds our datasources and calculates `g` -fn RenderGraph(cx: Scope) -> Element { - let seconds = use_datasource(SECONDS); - let constant = use_state(cx, || 1); - - cx.render(rsx!( - RenderG { seconds: seconds } - RenderT { seconds: seconds, constant: constant } - )) -} - -// "calculate" g by rendering `t` and `seconds` -#[inline_props] -fn RenderG(cx: Scope, seconds: i32) -> Element { - cx.render(rsx!{ "There are {seconds} seconds remaining..." }) -} - -// calculate and render `t` in its own component -#[inline_props] -fn RenderT(cx: Scope, seconds: i32, constant: i32) -> Element { - let res = seconds + constant; - cx.render(rsx!{ "{res}" }) -} -``` - -With this app, we've defined three components. Our top-level component provides our datasources (the hooks), computation nodes (child components), and a final value (what's "rendered"). - -Now, whenever the `constant` changes, our `RenderT` component will be re-rendered. However, if `seconds` doesn't change, then we don't need to re-render `RenderG` because the input is the same. If `seconds` _does_ change, then both RenderG and RenderT will be reevaluated. - -Dioxus is "Reactive" because it provides this framework for us. All we need to do is write our own tiny units of computation and Dioxus figures out which components need to be reevaluated automatically. - -These extra checks and algorithms add some overhead, which is why you see projects like [Sycamore](http://sycamore-rs.netlify.app) and [SolidJS](http://solidjs.com) eliminating them altogether. Dioxus is _really_ fast, so we're willing to exchange the added overhead for improved developer experience. - -## How do we update values in our dataflow graph? - -Dioxus will automatically figure out how to regenerate parts of our app when datasources change. But how exactly can we update our data sources? - -In Dioxus there are two datasources: - -1. Local state in `use_hook` and all other hooks -2. Global state through `provide_context`. - -Technically, the root props of the VirtualDom are a third datasource, but since we cannot modify them, they are not worth talking about. - -### Local State - -For local state in hooks, Dioxus gives us the `use_hook` method which returns an `&mut T` without any requirements. This means raw hook values are not tracked by Dioxus. In fact, we could write a component that modifies a hook value directly: - -```rust, no_run -fn app(cx: Scope) -> Element { - let mut count = cx.use_hook(|_| 0); - cx.render(rsx!{ - button { - onclick: move |_| *count += 1, - "Count: {count}" - } - }) -} -``` - -However, when this value is written to, the component does not know to be reevaluated. We must explicitly tell Dioxus that this component is "dirty" and needs to be re-rendered. This is done through the `cx.needs_update` method: - -```rust, no_run -button { - onclick: move |_| { - *count += 1; - cx.needs_update(); - }, - "Count: {count}" -} -``` - -Now, whenever we click the button, the value will change and the component will be re-rendered. - -> Re-rendering is when Dioxus calls your function component _again_. Component functions will be called over and over throughout their lifetime, so they should be mostly side-effect free. - -### Understand this! - -Your component functions will be called ("rendered" in our lingo) for as long as the component is present in the tree. - -A single component will be called multiple times, modifying its own internal state or rendering new nodes with new values from its properties. - -### App-Global State - -With the `provide_context` and `consume_context` methods on `Scope`, we can share values to descendants without having to pass values through component props. This has the side-effect of making our datasources less obvious from a high-level perspective, but it makes our components more modular within the same codebase. - -To make app-global state easier to reason about, Dioxus makes all values provided through `provide_context` immutable. This means any library built on top of `provide_context` needs to use interior mutability to modify shared global state. - -In these cases, App-Global state needs to manually track which components need to be re-generated. - -To regenerate _any_ component in your app, you can get a handle to the Dioxus' internal scheduler through `schedule_update_any`: - -```rust, no_run -let force_render = cx.schedule_update_any(); - -// force a render of the root component -force_render(ScopeId(0)); -``` - -## What does it mean for a component to "re-render"? - -In our guides, we frequently use the phrase "re-render" to describe updates to our app. You'll often hear this paired with "preventing unnecessary re-renders." But what exactly does this mean? - -When we call `dioxus::desktop::launch`, Dioxus will create a new `Scope` object and call the component we gave it. Our `rsx!` calls will create new nodes which we return back to the VirtualDom. Dioxus will then look through these nodes for child components, call their functions, and so on until every component has been "rendered." We consider these nodes "rendered" because they were created because of our explicit actions. - -The tree of UI that dioxus creates will roughly look like the tree of components presented earlier: - -![Tree of UI](../images/component_tree.png) - -But what happens when we call `needs_update` after modifying some important state? Well, if Dioxus called our component's function again, then we would produce new, different nodes. In fact, this is exactly what Dioxus does! - -At this point, we have some old nodes and some new nodes. Again, we call this "rendering" because Dioxus had to create new nodes because of our explicit actions. Any time new nodes get created, our VirtualDom is being "rendered." - -These nodes are stored in an extremely efficient memory allocator called a "bump arena." For example, a div with a handler and attribute would be stored in memory in two locations: the "old" tree and the "new" tree. - -![Bump Arenas](../images/oldnew.png) - -From here, Dioxus computes the difference between these trees and updates the Real DOM to make it look like the new version of what we've declared. - -![Diffing](../images/diffing.png) - -## Suppressing Renders - -So, we know how to make Dioxus render, but how do we _stop_ it? What if we _know_ that our state didn't change and we shouldn't render and diff new nodes because they'll be exactly the same as the last time? - -In these cases, you want to reach for _memoization_. In Dioxus, memoization involves preventing a component from rendering again if its props didn't change since the last time it attempted to render. - -Visually, you can tell that a component will only re-render if the new value is sufficiently different than the old one. - -| props.val | re-render | -| --------- | --------- | -| 10 | true | -| 20 | true | -| 20 | false | -| 20 | false | -| 10 | true | -| 30 | false | - -This is why when you `derive(Props)`, you must also implement the `PartialEq` trait. To override the memoization strategy for a component, you can simply implement your own PartialEq. - -```rust, no_run -struct CustomProps { - val: i32, -} - -impl PartialEq for CustomProps { - fn partial_eq(&self, other: &Self) -> bool { - // we don't render components that have a val less than 5 - if other.val > 5 && self.val > 5{ - self.val == other.val - } - } -} -``` - -However, for components that borrow data, it doesn't make sense to implement PartialEq since the actual references in memory might be different. - -You can technically override this behavior by implementing the `Props` trait manually, though it's unsafe and easy to mess up: - -```rust, no_run -unsafe impl Properties for CustomProps { - fn memoize(&self, other &Self) -> bool { - self != other - } -} -``` - -TLDR: - -- Dioxus checks if props changed between renders -- If props changed according to PartialEq, Dioxus re-renders the component -- Props that have a lifetime (ie `<'a>`) will always be re-rendered - -## Wrapping Up - -Wow, that was a lot of material! - -Let's see if we can recap what was presented: - -- Reactive programming calculates a final value from datasources and computation -- Dioxus is "reactive" since it figures out which computations to check -- `schedule_update` must be called to mark a component as dirty -- dirty components will be re-rendered (called multiple times) to produce a new UI -- Renders can be suppressed with memoization - -This theory is crucial to understand how to compose components and how to control renders in your app. diff --git a/docs/guide/src/en/__unused/event_javascript.rs b/docs/guide/src/en/__unused/event_javascript.rs deleted file mode 100644 index d80501b46..000000000 --- a/docs/guide/src/en/__unused/event_javascript.rs +++ /dev/null @@ -1,26 +0,0 @@ - -## JavaScript Handlers - -Instead of passing a closure, you can also pass a string to event handlers – this lets you use JavaScript (if your renderer can execute JavaScript): - -```rust -{{#include ../../../examples/event_javascript.rs:rsx}} -``` - - -#![allow(non_snake_case)] -use dioxus::prelude::*; - -fn main() { - dioxus::desktop::launch(App); -} - -fn App(cx: Scope) -> Element { - cx.render(rsx! { - // ANCHOR: rsx - div { - onclick: "alert('hello world')", - } - // ANCHOR_END: rsx - }) -} diff --git a/docs/guide/src/en/__unused/fanout.md b/docs/guide/src/en/__unused/fanout.md deleted file mode 100644 index 63b7d3403..000000000 --- a/docs/guide/src/en/__unused/fanout.md +++ /dev/null @@ -1,61 +0,0 @@ -# Fanning Out - -One of the most reliable state management patterns in large Dioxus apps is `fan-out`. The fan-out pattern is the ideal way to structure your app to maximize code reuse, testability, and deterministic rendering. - -## The structure - -With `fan-out`, our individual components at "leaf" position of our VirtualDom are "pure", making them easily reusable, testable, and deterministic. For instance, the "title" bar of our app might be a fairly complicated component. - -```rust, no_run -#[derive(Props, PartialEq)] -struct TitlebarProps { - title: String, - subtitle: String, -} - -fn Titlebar(cx: Scope) -> Element { - cx.render(rsx!{ - div { - class: "titlebar" - h1 { "{cx.props.title}" } - h1 { "{cx.props.subtitle}" } - } - }) -} -``` - -If we used global state like use_context or fermi, we might be tempted to inject our `use_read` directly into the component. - -```rust, no_run -fn Titlebar(cx: Scope) -> Element { - let title = use_read(cx, TITLE); - let subtitle = use_read(cx, SUBTITLE); - - cx.render(rsx!{/* ui */}) -} -``` - -For many apps – this is a fine pattern, especially if the component is a one-off. However, if we want to reuse the component outside of this app, then we'll start to run into issues where our contexts are unavailable. - -## Fanning Out - -To enable our titlebar component to be used across apps, we want to lift our atoms upwards and out of the Titlebar component. We would organize a bunch of other components in this section of the app to share some of the same state. - -```rust, no_run -fn DocsiteTitlesection(cx: Scope) { - let title = use_read(cx, TITLE); - let subtitle = use_read(cx, SUBTITLE); - - let username = use_read(cx, USERNAME); - let points = use_read(cx, POINTS); - - cx.render(rsx!{ - TitleBar { title: title, subtitle: subtitle } - UserBar { username: username, points: points } - }) -} -``` - -This particular wrapper component unfortunately cannot be reused across apps. However, because it simply wraps other real elements, it doesn't have to. We are free to reuse our TitleBar and UserBar components across apps with ease. We also know that this particular component is plenty performant because the wrapper doesn't have any props and is always memoized. The only times this component re-renders is when any of the atoms change. - -This is the beauty of Dioxus – we always know where our components are likely to be re-rendered. Our wrapper components can easily prevent any large re-renders by simply memoizing their components. This system might not be as elegant or precise as signal systems found in libraries like Sycamore or SolidJS, but it is quite ergonomic. diff --git a/docs/guide/src/en/__unused/hello_world.md b/docs/guide/src/en/__unused/hello_world.md deleted file mode 100644 index d49172e47..000000000 --- a/docs/guide/src/en/__unused/hello_world.md +++ /dev/null @@ -1,14 +0,0 @@ -# "Hello, World" desktop app - - - -If you plan to develop extensions for the `Dioxus` ecosystem, please use the `dioxus` crate with the `core` feature to limit the amount of dependencies your project brings in. - - -### What is this `Scope` object? - -Coming from React, the `Scope` object might be confusing. In React, you'll want to store data between renders with hooks. However, hooks rely on global variables which make them difficult to integrate in multi-tenant systems like server-rendering. - -In Dioxus, you are given an explicit `Scope` object to control how the component renders and stores data. The `Scope` object provides a handful of useful APIs for features like suspense, rendering, and more. - -For now, just know that `Scope` lets you store state with hooks and render elements with `cx.render`. diff --git a/docs/guide/src/en/__unused/helpers.md b/docs/guide/src/en/__unused/helpers.md deleted file mode 100644 index 86c76bea8..000000000 --- a/docs/guide/src/en/__unused/helpers.md +++ /dev/null @@ -1,47 +0,0 @@ -# Helper Crates - -Because the Dioxus ecosystem is fairly young, there aren't a ton of third-party libraries designed to "get things done." That's where the Dioxus helper crates come in. These are officially supported crates built on top of existing libraries to solve some of the common barriers to building apps. - -## Router - -Quickly add a cross-platform router to structure your app. - -[Link](https://github.com/DioxusLabs/dioxus/tree/master/packages/router) - -## Fermi - -Global state as easy as `use_state`. - -[Link](https://github.com/DioxusLabs/dioxus/tree/master/packages/fermi) - -## Query - -This crate has yet to be developed! However, we do plan on providing a crate for good fetching and query support. - -## 3rd-party – Toast - -Toast notifications, curtesy of [@mrxiaozhuox](https://github.com/mrxiaozhuox). - -[Link](https://github.com/mrxiaozhuox/dioxus-toast) - -## 3rd-party – HeroIcon - -Collection of helpful hero icons, curtesy of [@autarch](https://github.com/autarch). - - -[Link](https://github.com/houseabsolute/dioxus-heroicons) - -## 3rd-party – Katex - -Draw beautiful equations, curtesy of [@oovm](https://github.com/oovm) - -[Link](https://github.com/oovm/katex-wasm/tree/dev/projects/dioxus-katex) - - -## 3rd-party – PrimsJS - -Highlight your code blocks with ease, curtesy of [@oovm](https://github.com/oovm) - -[Link](https://github.com/oovm/katex-wasm/tree/dev/projects/dioxus-katex) - - diff --git a/docs/guide/src/en/__unused/index.md b/docs/guide/src/en/__unused/index.md deleted file mode 100644 index d1863a465..000000000 --- a/docs/guide/src/en/__unused/index.md +++ /dev/null @@ -1,36 +0,0 @@ -# Managing State - -Every app you'll build with Dioxus will have some sort of state that needs to be maintained and updated as your users interact with it. However, managing state can be particularly challenging at times, and is frequently the source of bugs in many GUI frameworks. - -In this chapter, we'll cover the various ways to manage state, the appropriate terminology, various patterns, and some problems you might run into. - -## The Problem - -Why do people say state management is so difficult? What does it mean? - -Generally, state management is the code you need to write to ensure that your app renders the _correct_ content. If the user inputs a name, then you need to display the appropriate response – like alerts, validation, and disable/enable various elements on the page. Things can quickly become tricky if you need loading screens and cancellable tasks. - -For the simplest of apps, all of your state can enter the app from the root props. This is common in server-side rendering – we can collect all of the required state _before_ rendering the content. - -```rust, no_run -let all_content = get_all_content().await; - -let output = dioxus::ssr::render_lazy(rsx!{ - div { - RenderContent { content: all_content } - } -}); -``` - -With this incredibly simple setup, it is highly unlikely that you'll have rendering bugs. There simply is barely any state to manage. - -However, most of your apps will store state inside of the Dioxus VirtualDom – either through local state or global state. - -## Your options - -To deal with complexity, you have a couple of options: - -- Refactor state out of shared state and into reusable components and hooks. -- Lift state upwards to be spread across multiple components (fan out). -- Use the Context API to share state globally. -- Use a dedicated state management solution like Fermi. diff --git a/docs/guide/src/en/__unused/localstate.md b/docs/guide/src/en/__unused/localstate.md deleted file mode 100644 index fbc04272a..000000000 --- a/docs/guide/src/en/__unused/localstate.md +++ /dev/null @@ -1,107 +0,0 @@ -# Local State - -The first step to dealing with complexity in your app is to refactor your state to be purely local. This encourages good code reuse and prevents leakage of abstractions across component boundaries. - -## What it looks like - -Let's say we're managing the state for a list of Todos. Whenever we edit the todo, we want the list to update. We might've started building our app but putting everything into a single `use_ref`. - -```rust, no_run -struct Todo { - contents: String, - is_hovered: bool, - is_editing: bool, -} - -let todos = use_ref(cx, || vec![Todo::new()]); - -cx.render(rsx!{ - ul { - todos.read().iter().enumerate().map(|(id, todo)| rsx!{ - li { - onhover: move |_| *todos.write()[id].is_hovered = true, - h1 { "{todo.contents}" } - } - }) - } -}) -``` - -As shown above, whenever the todo is hovered, we want to set its state: - -```rust, no_run -todos.write()[0].is_hovered = true; -``` - -As the amount of interactions goes up, so does the complexity of our state. Should the "hover" state really be baked into our data model? - -Instead, let's refactor our Todo component to handle its own state: - -```rust, no_run -#[inline_props] -fn Todo<'a>(cx: Scope, todo: &'a Todo) -> Element { - let is_hovered = use_state(cx, || false); - - cx.render(rsx!{ - li { - h1 { "{todo.contents}" } - onhover: move |_| is_hovered.set(true), - } - }) -} -``` - -Now, we can simplify our Todo data model to get rid of local UI state: - -```rust, no_run -struct Todo { - contents: String, -} -``` - -This is not only better for encapsulation and abstraction, but it's only more performant! Whenever a Todo is hovered, we won't need to re-render _every_ Todo again – only the Todo that's currently being hovered. - -Wherever possible, you should try to refactor the "view" layer _out_ of your data model. - -## Immutability - -Storing all of your state inside a `use_ref` might be tempting. However, you'll quickly run into an issue where the `Ref` provided by `read()` "does not live long enough." An indeed – you can't return locally-borrowed value into the Dioxus tree. - -In these scenarios consider breaking your `use_ref` into individual `use_state`s. - -You might've started modeling your component with a struct and use_ref - -```rust, no_run -struct State { - count: i32, - color: &'static str, - names: HashMap -} - -// in the component -let state = use_ref(cx, State::new) -``` - -The "better" approach for this particular component would be to break the state apart into different values: - -```rust, no_run -let count = use_state(cx, || 0); -let color = use_state(cx, || "red"); -let names = use_state(cx, HashMap::new); -``` - -You might recognize that our "names" value is a HashMap – which is not terribly cheap to clone every time we update its value. To solve this issue, we _highly_ suggest using a library like [`im`](https://crates.io/crates/im) which will take advantage of structural sharing to make clones and mutations much cheaper. - -When combined with the `make_mut` method on `use_state`, you can get really succinct updates to collections: - -```rust, no_run -let todos = use_state(cx, im_rc::HashMap::default); - -todos.make_mut().insert("new todo", Todo { - contents: "go get groceries", -}); -``` - -## Moving on - -This particular local patterns are powerful but is not a cure-all for state management problems. Sometimes your state problems are much larger than just staying local to a component. diff --git a/docs/guide/src/en/__unused/memoization.md b/docs/guide/src/en/__unused/memoization.md deleted file mode 100644 index 4baa73be9..000000000 --- a/docs/guide/src/en/__unused/memoization.md +++ /dev/null @@ -1,26 +0,0 @@ -## Memoization - -Dioxus uses Memoization for a more efficient user interface. Memoization is the process in which we check if a component actually needs to be re-rendered when its props change. If a component's properties change but they wouldn't affect the output, then we don't need to re-render the component, saving time! - -For example, let's say we have a component that has two children: - -```rust, no_run -fn Demo(cx: Scope) -> Element { - // don't worry about these 2, we'll cover them later - let name = use_state(cx, || String::from("bob")); - let age = use_state(cx, || 21); - - cx.render(rsx!{ - Name { name: name } - Age { age: age } - }) -} -``` - -If `name` changes but `age` does not, then there is no reason to re-render our `Age` component since the contents of its props did not meaningfully change. - -Dioxus memoizes owned components. It uses `PartialEq` to determine if a component needs rerendering, or if it has stayed the same. This is why you must derive PartialEq! - -> This means you can always rely on props with `PartialEq` or no props at all to act as barriers in your app. This can be extremely useful when building larger apps where properties frequently change. By moving our state into a global state management solution, we can achieve precise, surgical re-renders, improving the performance of our app. - -Borrowed Props cannot be safely memoized. However, this is not a problem – Dioxus relies on the memoization of their parents to determine if they need to be rerendered. diff --git a/docs/guide/src/en/__unused/model_pattern.md b/docs/guide/src/en/__unused/model_pattern.md deleted file mode 100644 index c9bf9f6b5..000000000 --- a/docs/guide/src/en/__unused/model_pattern.md +++ /dev/null @@ -1,64 +0,0 @@ -## Using UseRef with "models" - -One option for state management that UseRef enables is the development of a "model" for your components. This particular pattern enables you to model your state with regular structs. - -For instance, our calculator example uses a struct to model the state. - -```rust, no_run - -struct Calculator { - display_value: String, - operator: Option, - waiting_for_operand: bool, - cur_val: f64, -} -``` - -Our component is really simple – we just call `use_ref` to get an initial calculator state. - -```rust, no_run -fn app(cx: Scope) -> Element { - let state = use_ref(cx, Calculator::new); - - cx.render(rsx!{ - // the rendering code - }) -} -``` - -In our UI, we can then use `read` and a helper method to get data out of the model. - -```rust, no_run -// Our accessor method -impl Calculator { - fn formatted_display(&self) -> String { - self.display_value - .parse::() - .unwrap() - .separated_string() - } -} - -// And then in the UI -cx.render(rsx!{ - div { [state.read().formatted_display()] } -}) -``` - -To modify the state, we can setup a helper method and then attach it to a callback. - -```rust, no_run -// our helper -impl Calculator { - fn clear_display(&mut self) { - self.display_value = "0".to_string() - } -} - -// our callback -cx.render(rsx!{ - button { - onclick: move |_| state.write().clear_display(), - } -}) -``` diff --git a/docs/guide/src/en/async/index.md b/docs/guide/src/en/async/index.md deleted file mode 100644 index a95671399..000000000 --- a/docs/guide/src/en/async/index.md +++ /dev/null @@ -1,9 +0,0 @@ -# Working with Async - -Often, apps need to interact with file systems, network interfaces, hardware, or timers. This chapter provides an overview of using async code in Dioxus. - -## The Runtime - -By default, Dioxus-Desktop ships with the `Tokio` runtime and automatically sets everything up for you. This is currently not configurable, though it would be easy to write an integration for Dioxus desktop that uses a different asynchronous runtime. - -Dioxus is not currently thread-safe, so any async code you write does *not* need to be `Send/Sync`. That means that you can use non-thread-safe structures like `Cell`, `Rc`, and `RefCell`. diff --git a/docs/guide/src/en/async/spawn.md b/docs/guide/src/en/async/spawn.md deleted file mode 100644 index 2f86ad159..000000000 --- a/docs/guide/src/en/async/spawn.md +++ /dev/null @@ -1,19 +0,0 @@ -# Spawning Futures - -The `use_future` and `use_coroutine` hooks are useful if you want to unconditionally spawn the future. Sometimes, though, you'll want to only spawn a future in response to an event, such as a mouse click. For example, suppose you need to send a request when the user clicks a "log in" button. For this, you can use `cx.spawn`: - -```rust, no_run -{{#include ../../../examples/spawn.rs:spawn}} -``` - -> Note: `spawn` will always spawn a _new_ future. You most likely don't want to call it on every render. - -Calling `spawn` will give you a `JoinHandle` which lets you cancel or pause the future. - -## Spawning Tokio Tasks - -Sometimes, you might want to spawn a background task that needs multiple threads or talk to hardware that might block your app code. In these cases, we can directly spawn a Tokio task from our future. For Dioxus-Desktop, your task will be spawned onto Tokio's Multithreaded runtime: - -```rust, no_run -{{#include ../../../examples/spawn.rs:tokio}} -``` diff --git a/docs/guide/src/en/async/use_coroutine.md b/docs/guide/src/en/async/use_coroutine.md deleted file mode 100644 index d42905be5..000000000 --- a/docs/guide/src/en/async/use_coroutine.md +++ /dev/null @@ -1,204 +0,0 @@ -# Coroutines - -Another tool in your async toolbox are coroutines. Coroutines are futures that can be manually stopped, started, paused, and resumed. - -Like regular futures, code in a coroutine will run until the next `await` point before yielding. This low-level control over asynchronous tasks is quite powerful, allowing for infinitely looping tasks like WebSocket polling, background timers, and other periodic actions. - -## `use_coroutine` - -The `use_coroutine` hook allows you to create a coroutine. Most coroutines we write will be polling loops using async/await. - -```rust, no_run -fn app(cx: Scope) -> Element { - let ws: &UseCoroutine<()> = use_coroutine(cx, |rx| async move { - // Connect to some sort of service - let mut conn = connect_to_ws_server().await; - - // Wait for data on the service - while let Some(msg) = conn.next().await { - // handle messages - } - }); -} -``` - -For many services, a simple async loop will handle the majority of use cases. - -However, if we want to temporarily disable the coroutine, we can "pause" it using the `pause` method, and "resume" it using the `resume` method: - -```rust, no_run -let sync: &UseCoroutine<()> = use_coroutine(cx, |rx| async move { - // code for syncing -}); - -if sync.is_running() { - cx.render(rsx!{ - button { - onclick: move |_| sync.pause(), - "Disable syncing" - } - }) -} else { - cx.render(rsx!{ - button { - onclick: move |_| sync.resume(), - "Enable syncing" - } - }) -} -``` - -This pattern is where coroutines are extremely useful – instead of writing all the complicated logic for pausing our async tasks like we would with JavaScript promises, the Rust model allows us to just not poll our future. - -## Yielding Values - -To yield values from a coroutine, simply bring in a `UseState` handle and set the value whenever your coroutine completes its work. - -The future must be `'static` – so any values captured by the task cannot carry any references to `cx`, such as a `UseState`. - -You can use [to_owned](https://doc.rust-lang.org/std/borrow/trait.ToOwned.html#tymethod.to_owned) to create a clone of the hook handle which can be moved into the async closure. - -```rust, no_run -let sync_status = use_state(cx, || Status::Launching); -let sync_task = use_coroutine(cx, |rx: UnboundedReceiver| { - let sync_status = sync_status.to_owned(); - async move { - loop { - delay_ms(1000).await; - sync_status.set(Status::Working); - } - } -}) -``` - -To make this a bit less verbose, Dioxus exports the `to_owned!` macro which will create a binding as shown above, which can be quite helpful when dealing with many values. - -```rust, no_run -let sync_status = use_state(cx, || Status::Launching); -let load_status = use_state(cx, || Status::Launching); -let sync_task = use_coroutine(cx, |rx: UnboundedReceiver| { - to_owned![sync_status, load_status]; - async move { - // ... - } -}) -``` - -## Sending Values - -You might've noticed the `use_coroutine` closure takes an argument called `rx`. What is that? Well, a common pattern in complex apps is to handle a bunch of async code at once. With libraries like Redux Toolkit, managing multiple promises at once can be challenging and a common source of bugs. - -With Coroutines, we can centralize our async logic. The `rx` parameter is an Channel that allows code external to the coroutine to send data _into_ the coroutine. Instead of looping on an external service, we can loop on the channel itself, processing messages from within our app without needing to spawn a new future. To send data into the coroutine, we would call "send" on the handle. - -```rust, no_run -use futures_util::stream::StreamExt; - -enum ProfileUpdate { - SetUsername(String), - SetAge(i32) -} - -let profile = use_coroutine(cx, |mut rx: UnboundedReciver| async move { - let mut server = connect_to_server().await; - - while let Ok(msg) = rx.next().await { - match msg { - ProfileUpdate::SetUsername(name) => server.update_username(name).await, - ProfileUpdate::SetAge(age) => server.update_age(age).await, - } - } -}); - - -cx.render(rsx!{ - button { - onclick: move |_| profile.send(ProfileUpdate::SetUsername("Bob".to_string())), - "Update username" - } -}) -``` - -> Note: In order to use/run the `rx.next().await` statement you will need to extend the [`Stream`] trait (used by [`UnboundedReceiver`]) by adding 'futures_util' as a dependency to your project and adding the `use futures_util::stream::StreamExt;`. - -For sufficiently complex apps, we could build a bunch of different useful "services" that loop on channels to update the app. - -```rust, no_run -let profile = use_coroutine(cx, profile_service); -let editor = use_coroutine(cx, editor_service); -let sync = use_coroutine(cx, sync_service); - -async fn profile_service(rx: UnboundedReceiver) { - // do stuff -} - -async fn sync_service(rx: UnboundedReceiver) { - // do stuff -} - -async fn editor_service(rx: UnboundedReceiver) { - // do stuff -} -``` - -We can combine coroutines with [Fermi](https://docs.rs/fermi/latest/fermi/index.html) to emulate Redux Toolkit's Thunk system with much less headache. This lets us store all of our app's state _within_ a task and then simply update the "view" values stored in Atoms. It cannot be understated how powerful this technique is: we get all the perks of native Rust tasks with the optimizations and ergonomics of global state. This means your _actual_ state does not need to be tied up in a system like Fermi or Redux – the only Atoms that need to exist are those that are used to drive the display/UI. - -```rust, no_run -static USERNAME: Atom = Atom(|_| "default".to_string()); - -fn app(cx: Scope) -> Element { - let atoms = use_atom_root(cx); - - use_coroutine(cx, |rx| sync_service(rx, atoms.clone())); - - cx.render(rsx!{ - Banner {} - }) -} - -fn Banner(cx: Scope) -> Element { - let username = use_read(cx, &USERNAME); - - cx.render(rsx!{ - h1 { "Welcome back, {username}" } - }) -} -``` - -Now, in our sync service, we can structure our state however we want. We only need to update the view values when ready. - -```rust, no_run -use futures_util::stream::StreamExt; - -enum SyncAction { - SetUsername(String), -} - -async fn sync_service(mut rx: UnboundedReceiver, atoms: AtomRoot) { - let username = atoms.write(&USERNAME); - let errors = atoms.write(&ERRORS); - - while let Ok(msg) = rx.next().await { - match msg { - SyncAction::SetUsername(name) => { - if set_name_on_server(&name).await.is_ok() { - username.set(name); - } else { - errors.make_mut().push("SetUsernameFailed"); - } - } - } - } -} -``` - -## Automatic injection into the Context API - -Coroutine handles are automatically injected through the context API. You can use the `use_coroutine_handle` hook with the message type as a generic to fetch a handle. - -```rust, no_run -fn Child(cx: Scope) -> Element { - let sync_task = use_coroutine_handle::(cx); - - sync_task.send(SyncAction::SetUsername); -} -``` diff --git a/docs/guide/src/en/async/use_effect.md b/docs/guide/src/en/async/use_effect.md deleted file mode 100644 index 7c20e3589..000000000 --- a/docs/guide/src/en/async/use_effect.md +++ /dev/null @@ -1,41 +0,0 @@ -# UseEffect - -[`use_effect`](https://docs.rs/dioxus-hooks/latest/dioxus_hooks/fn.use_effect.html) lets you run a callback that returns a future, which will be re-run when its [dependencies](#dependencies) change. This is useful to syncrhonize with external events. - -## Dependencies - -You can make the callback re-run when some value changes. For example, you might want to fetch a user's data only when the user id changes. You can provide a tuple of "dependencies" to the hook. It will automatically re-run it when any of those dependencies change. - -## Example - -```rust, no_run -#[inline_props] -fn Profile(cx: Scope, id: usize) -> Element { - let name = use_state(cx, || None); - - // Only fetch the user data when the id changes. - use_effect(cx, (id,), |(id,)| { - to_owned![name]; - async move { - let user = fetch_user(id).await; - name.set(user.name); - } - }); - - // Because the dependencies are empty, this will only run once. - // An empty tuple is always equal to an empty tuple. - use_effect(cx, (), |()| async move { - println!("Hello, World!"); - }); - - let name = name.get().clone().unwrap_or("Loading...".to_string()); - - render!( - p { "{name}" } - ) -} - -fn app(cx: Scope) -> Element { - render!(Profile { id: 0 }) -} -``` diff --git a/docs/guide/src/en/async/use_future.md b/docs/guide/src/en/async/use_future.md deleted file mode 100644 index c7b262c61..000000000 --- a/docs/guide/src/en/async/use_future.md +++ /dev/null @@ -1,31 +0,0 @@ -# UseFuture - -[`use_future`](https://docs.rs/dioxus-hooks/latest/dioxus_hooks/fn.use_future.html) lets you run an async closure, and provides you with its result. - -For example, we can make an API request (using [reqwest](https://docs.rs/reqwest/latest/reqwest/index.html)) inside `use_future`: - -```rust, no_run -{{#include ../../../examples/use_future.rs:use_future}} -``` - -The code inside `use_future` will be submitted to the Dioxus scheduler once the component has rendered. - -We can use `.value()` to get the result of the future. On the first run, since there's no data ready when the component loads, its value will be `None`. However, once the future is finished, the component will be re-rendered and the value will now be `Some(...)`, containing the return value of the closure. - -We can then render that result: - -```rust, no_run -{{#include ../../../examples/use_future.rs:render}} -``` - -## Restarting the Future - -The `UseFuture` handle provides a `restart` method. It can be used to execute the future again, producing a new value. - -## Dependencies - -Often, you will need to run the future again every time some value (e.g. a prop) changes. Rather than calling `restart` manually, you can provide a tuple of "dependencies" to the hook. It will automatically re-run the future when any of those dependencies change. Example: - -```rust, no_run -{{#include ../../../examples/use_future.rs:dependency}} -``` diff --git a/docs/guide/src/en/best_practices/antipatterns.md b/docs/guide/src/en/best_practices/antipatterns.md deleted file mode 100644 index 771ffe75f..000000000 --- a/docs/guide/src/en/best_practices/antipatterns.md +++ /dev/null @@ -1,33 +0,0 @@ -# Antipatterns - -This example shows what not to do and provides a reason why a given pattern is considered an "AntiPattern". Most anti-patterns are considered wrong for performance or code re-usability reasons. - -## Unnecessarily Nested Fragments - -Fragments don't mount a physical element to the DOM immediately, so Dioxus must recurse into its children to find a physical DOM node. This process is called "normalization". This means that deeply nested fragments make Dioxus perform unnecessary work. Prefer one or two levels of fragments / nested components until presenting a true DOM element. - -Only Component and Fragment nodes are susceptible to this issue. Dioxus mitigates this with components by providing an API for registering shared state without the Context Provider pattern. - -```rust, no_run -{{#include ../../../examples/anti_patterns.rs:nested_fragments}} -``` - -## Incorrect Iterator Keys - -As described in the [dynamic rendering chapter](../interactivity/dynamic_rendering.md#the-key-attribute), list items must have unique keys that are associated with the same items across renders. This helps Dioxus associate state with the contained components and ensures good diffing performance. Do not omit keys, unless you know that the list will never change. - -```rust, no_run -{{#include ../../../examples/anti_patterns.rs:iter_keys}} -``` - -## Avoid Interior Mutability in Props - -While it is technically acceptable to have a `Mutex` or a `RwLock` in the props, they will be difficult to use. - -Suppose you have a struct `User` containing the field `username: String`. If you pass a `Mutex` prop to a `UserComponent` component, that component may wish to pass the username as a `&str` prop to a child component. However, it cannot pass that borrowed field down, since it only would live as long as the `Mutex`'s lock, which belongs to the `UserComponent` function. Therefore, the component will be forced to clone the `username` field. - -## Avoid Updating State During Render - -Every time you update the state, Dioxus needs to re-render the component – this is inefficient! Consider refactoring your code to avoid this. - -Also, if you unconditionally update the state during render, it will be re-rendered in an infinite loop. diff --git a/docs/guide/src/en/best_practices/error_handling.md b/docs/guide/src/en/best_practices/error_handling.md deleted file mode 100644 index d16d04347..000000000 --- a/docs/guide/src/en/best_practices/error_handling.md +++ /dev/null @@ -1,153 +0,0 @@ -# Error handling - -A selling point of Rust for web development is the reliability of always knowing where errors can occur and being forced to handle them - -However, we haven't talked about error handling at all in this guide! In this chapter, we'll cover some strategies in handling errors to ensure your app never crashes. - -## The simplest – returning None - -Astute observers might have noticed that `Element` is actually a type alias for `Option`. You don't need to know what a `VNode` is, but it's important to recognize that we could actually return nothing at all: - -```rust, no_run -fn App(cx: Scope) -> Element { - None -} -``` - -This lets us add in some syntactic sugar for operations we think _shouldn't_ fail, but we're still not confident enough to "unwrap" on. - -> The nature of `Option` might change in the future as the `try` trait gets upgraded. - -```rust, no_run -fn App(cx: Scope) -> Element { - // immediately return "None" - let name = cx.use_hook(|_| Some("hi"))?; -} -``` - -## Early return on result - -Because Rust can't accept both Options and Results with the existing try infrastructure, you'll need to manually handle Results. This can be done by converting them into Options or by explicitly handling them. - -```rust, no_run -fn App(cx: Scope) -> Element { - // Convert Result to Option - let name = cx.use_hook(|_| "1.234").parse().ok()?; - - - // Early return - let count = cx.use_hook(|_| "1.234"); - let val = match count.parse() { - Ok(val) => val - Err(err) => return cx.render(rsx!{ "Parsing failed" }) - }; -} -``` - -Notice that while hooks in Dioxus do not like being called in conditionals or loops, they _are_ okay with early returns. Returning an error state early is a completely valid way of handling errors. - -## Match results - -The next "best" way of handling errors in Dioxus is to match on the error locally. This is the most robust way of handling errors, though it doesn't scale to architectures beyond a single component. - -To do this, we simply have an error state built into our component: - -```rust, no_run -let err = use_state(cx, || None); -``` - -Whenever we perform an action that generates an error, we'll set that error state. We can then match on the error in a number of ways (early return, return Element, etc). - -```rust, no_run -fn Commandline(cx: Scope) -> Element { - let error = use_state(cx, || None); - - cx.render(match *error { - Some(error) => rsx!( - h1 { "An error occured" } - ) - None => rsx!( - input { - oninput: move |_| error.set(Some("bad thing happened!")), - } - ) - }) -} -``` - -## Passing error states through components - -If you're dealing with a handful of components with minimal nesting, you can just pass the error handle into child components. - -```rust, no_run -fn Commandline(cx: Scope) -> Element { - let error = use_state(cx, || None); - - if let Some(error) = **error { - return cx.render(rsx!{ "An error occured" }); - } - - cx.render(rsx!{ - Child { error: error.clone() } - Child { error: error.clone() } - Child { error: error.clone() } - Child { error: error.clone() } - }) -} -``` - -Much like before, our child components can manually set the error during their own actions. The advantage to this pattern is that we can easily isolate error states to a few components at a time, making our app more predictable and robust. - -## Going global - -A strategy for handling cascaded errors in larger apps is through signaling an error using global state. This particular pattern involves creating an "error" context, and then setting it wherever relevant. This particular method is not as "sophisticated" as React's error boundary, but it is more fitting for Rust. - -To get started, consider using a built-in hook like `use_context` and `use_context_provider` or Fermi. Of course, it's pretty easy to roll your own hook too. - -At the "top" of our architecture, we're going to want to explicitly declare a value that could be an error. - -```rust, no_run -enum InputError { - None, - TooLong, - TooShort, -} - -static INPUT_ERROR: Atom = Atom(|_| InputError::None); -``` - -Then, in our top level component, we want to explicitly handle the possible error state for this part of the tree. - -```rust, no_run -fn TopLevel(cx: Scope) -> Element { - let error = use_read(cx, &INPUT_ERROR); - - match error { - TooLong => return cx.render(rsx!{ "FAILED: Too long!" }), - TooShort => return cx.render(rsx!{ "FAILED: Too Short!" }), - _ => {} - } -} -``` - -Now, whenever a downstream component has an error in its actions, it can simply just set its own error state: - -```rust, no_run -fn Commandline(cx: Scope) -> Element { - let set_error = use_set(cx, &INPUT_ERROR); - - cx.render(rsx!{ - input { - oninput: move |evt| { - if evt.value.len() > 20 { - set_error(InputError::TooLong); - } - } - } - }) -} -``` - -This approach to error handling is best in apps that have "well defined" error states. Consider using a crate like `thiserror` or `anyhow` to simplify the generation of the error types. - -This pattern is widely popular in many contexts and is particularly helpful whenever your code generates a non-recoverable error. You can gracefully capture these "global" error states without panicking or mucking up state. diff --git a/docs/guide/src/en/best_practices/index.md b/docs/guide/src/en/best_practices/index.md deleted file mode 100644 index 6b9f0ed1d..000000000 --- a/docs/guide/src/en/best_practices/index.md +++ /dev/null @@ -1,14 +0,0 @@ -# Best Practices - -## Reusable Components - -As much as possible, break your code down into small, reusable components and hooks, instead of implementing large chunks of the UI in a single component. This will help you keep the code maintainable – it is much easier to e.g. add, remove or re-order parts of the UI if it is organized in components. - -Organize your components in modules to keep the codebase easy to navigate! - -## Minimize State Dependencies - -While it is possible to share state between components, this should only be done when necessary. Any component that is associated with a particular state object needs to be re-rendered when that state changes. For this reason: - -- Keep state local to a component if possible -- When sharing state through props, only pass down the specific data necessary diff --git a/docs/guide/src/en/contributing/guiding_principles.md b/docs/guide/src/en/contributing/guiding_principles.md deleted file mode 100644 index 5c730d622..000000000 --- a/docs/guide/src/en/contributing/guiding_principles.md +++ /dev/null @@ -1,37 +0,0 @@ -# Overall Goals - -This document outlines some of the overall goals for Dioxus. These goals are not set in stone, but they represent general guidelines for the project. - -The goal of Dioxus is to make it easy to build **cross-platform applications that scale**. - -## Cross-Platform - -Dioxus is designed to be cross-platform by default. This means that it should be easy to build applications that run on the web, desktop, and mobile. However, Dioxus should also be flexible enough to allow users to opt into platform-specific features when needed. The `use_eval` is one example of this. By default, Dioxus does not assume that the platform supports JavaScript, but it does provide a hook that allows users to opt into JavaScript when needed. - -## Performance - -As Dioxus applications grow, they should remain relatively performant without the need for manual optimizations. There will be cases where manual optimizations are needed, but Dioxus should try to make these cases as rare as possible. - -One of the benefits of the core architecture of Dioxus is that it delivers reasonable performance even when components are rerendered often. It is based on a Virtual Dom which performs diffing which should prevent unnecessary re-renders even when large parts of the component tree are rerun. On top of this, Dioxus groups static parts of the RSX tree together to skip diffing them entirely. - -## Type Safety - -As teams grow, the Type safety of Rust is a huge advantage. Dioxus should leverage this advantage to make it easy to build applications with large teams. - -To take full advantage of Rust's type system, Dioxus should try to avoid exposing public `Any` types and string-ly typed APIs where possible. - -## Developer Experience - -Dioxus should be easy to learn and ergonomic to use. - -- The API of Dioxus attempts to remain close to React's API where possible. This makes it easier for people to learn Dioxus if they already know React - -- We can avoid the tradeoff between simplicity and flexibility by providing multiple layers of API: One for the very common use case, one for low-level control - - - Hooks: the hooks crate has the most common use cases, but `cx.hook` provides a way to access the underlying persistent reference if needed. - - The builder pattern in platform Configs: The builder pattern is used to default to the most common use case, but users can change the defaults if needed. - -- Documentation: - - All public APIs should have rust documentation - - Examples should be provided for all public features. These examples both serve as documentation and testing. They are checked by CI to ensure that they continue to compile - - The most common workflows should be documented in the guide diff --git a/docs/guide/src/en/contributing/index.md b/docs/guide/src/en/contributing/index.md deleted file mode 100644 index d70dc6f8d..000000000 --- a/docs/guide/src/en/contributing/index.md +++ /dev/null @@ -1,57 +0,0 @@ -# Contributing - -Development happens in the [Dioxus GitHub repository](https://github.com/DioxusLabs/dioxus). If you've found a bug or have an idea for a feature, please submit an issue (but first check if someone hasn't [done it already](https://github.com/DioxusLabs/dioxus/issues)). - -[GitHub discussions](https://github.com/DioxusLabs/dioxus/discussions) can be used as a place to ask for help or talk about features. You can also join [our Discord channel](https://discord.gg/XgGxMSkvUM) where some development discussion happens. - -## Improving Docs - -If you'd like to improve the docs, PRs are welcome! Both Rust docs ([source](https://github.com/DioxusLabs/dioxus/tree/master/packages)) and this guide ([source](https://github.com/DioxusLabs/dioxus/tree/master/docs/guide)) can be found in the GitHub repo. - -## Working on the Ecosystem - -Part of what makes React great is the rich ecosystem. We'd like the same for Dioxus! So if you have a library in mind that you'd like to write and many people would benefit from, it will be appreciated. You can [browse npm.js](https://www.npmjs.com/search?q=keywords:react-component) for inspiration. Once you are done, add your library to the [awesome dioxus](https://github.com/DioxusLabs/awesome-dioxus) list or share it in the `#I-made-a-thing` channel on [Discord](https://discord.gg/XgGxMSkvUM). - -## Bugs & Features - -If you've fixed [an open issue](https://github.com/DioxusLabs/dioxus/issues), feel free to submit a PR! You can also take a look at [the roadmap](./roadmap.md) and work on something in there. Consider [reaching out](https://discord.gg/XgGxMSkvUM) to the team first to make sure everyone's on the same page, and you don't do useless work! - -All pull requests (including those made by a team member) must be approved by at least one other team member. -Larger, more nuanced decisions about design, architecture, breaking changes, trade-offs, etc. are made by team consensus. - -## Tools - -The following tools can be helpful when developing Dioxus. Many of these tools are used in the CI pipeline. Running them locally before submitting a PR instead of waiting for CI can save time. - -- All code is tested with [cargo test](https://doc.rust-lang.org/cargo/commands/cargo-test.html) - -```sh -cargo fmt --all -``` - -- All code is formatted with [rustfmt](https://github.com/rust-lang/rustfmt) - -```sh -cargo check --workspace --examples --tests -``` - -- All code is linted with [Clippy](https://doc.rust-lang.org/clippy/) - -```sh -cargo clippy --workspace --examples --tests -- -D warnings -``` - -- Browser tests are automated with [Playwright](https://playwright.dev/docs/intro#installing-playwright) - -```sh -npx playwright test -``` - -- Crates that use unsafe are checked for undefined behavior with [MIRI](https://github.com/rust-lang/miri). MIRI can be helpful to debug what unsafe code is causing issues. Only code that does not interact with system calls can be checked with MIRI. Currently, this is used for the two MIRI tests in `dioxus-core` and `dioxus-native-core`. - -```sh -cargo miri test --package dioxus-core --test miri_stress -cargo miri test --package dioxus-native-core --test miri_native -``` - -- [Rust analyzer](https://rust-analyzer.github.io/) can be very helpful for quick feedback in your IDE. diff --git a/docs/guide/src/en/contributing/project_structure.md b/docs/guide/src/en/contributing/project_structure.md deleted file mode 100644 index 38b6cbde4..000000000 --- a/docs/guide/src/en/contributing/project_structure.md +++ /dev/null @@ -1,50 +0,0 @@ -# Project Struture - -There are many packages in the Dioxus organization. This document will help you understand the purpose of each package and how they fit together. - -## Renderers - -- [Desktop](https://github.com/DioxusLabs/dioxus/tree/master/packages/desktop): A renderer that runs Dioxus applications natively, but renders them with the system webview. -- [Mobile](https://github.com/DioxusLabs/dioxus/tree/master/packages/mobile): A renderer that runs Dioxus applications natively, but renders them with the system webview. This is currently a copy of the desktop renderer. -- [Web](https://github.com/DioxusLabs/dioxus/tree/master/packages/Web): Renders Dioxus applications in the browser by compiling to WASM and manipulating the DOM. -- [Liveview](https://github.com/DioxusLabs/dioxus/tree/master/packages/liveview): A renderer that runs on the server, and renders using a websocket proxy in the browser. -- [Rink](https://github.com/DioxusLabs/dioxus/tree/master/packages/rink): A renderer that renders a HTML-like tree into a terminal. -- [TUI](https://github.com/DioxusLabs/dioxus/tree/master/packages/dioxus-tui): A renderer that uses Rink to render a Dioxus application in a terminal. -- [Blitz-Core](https://github.com/DioxusLabs/blitz/tree/master/blitz-core): An experimental native renderer that renders a HTML-like tree using WGPU. -- [Blitz](https://github.com/DioxusLabs/blitz): An experimental native renderer that uses Blitz-Core to render a Dioxus application using WGPU. -- [SSR](https://github.com/DioxusLabs/dioxus/tree/master/packages/ssr): A renderer that runs Dioxus applications on the server, and renders them to HTML. - -## State Management/Hooks - -- [Hooks](https://github.com/DioxusLabs/dioxus/tree/master/packages/hooks): A collection of common hooks for Dioxus applications -- [Signals](https://github.com/DioxusLabs/dioxus/tree/master/packages/signals): A experimental state management library for Dioxus applications. This currently contains a `Copy` version of UseRef -- [Dioxus STD](https://github.com/DioxusLabs/dioxus-std): A collection of platform agnostic hooks to interact with system interfaces (The clipboard, camera, etc.). -- [Fermi](https://github.com/DioxusLabs/dioxus/tree/master/packages/fermi): A global state management library for Dioxus applications. - [Router](https://github.com/DioxusLabs/dioxus/tree/master/packages/router): A client-side router for Dioxus applications - -## Core utilities - -- [core](https://github.com/DioxusLabs/dioxus/tree/master/packages/core): The core virtual dom implementation every Dioxus application uses - - You can read more about the archetecture of the core [in this blog post](https://dioxuslabs.com/blog/templates-diffing/) and the [custom renderer section of the guide](../custom_renderer/index.md) -- [RSX](https://github.com/DioxusLabs/dioxus/tree/master/packages/RSX): The core parsing for RSX used for hot reloading, autoformatting, and the macro -- [core-macro](https://github.com/DioxusLabs/dioxus/tree/master/packages/core-macro): The rsx! macro used to write Dioxus applications. (This is a wrapper over the RSX crate) -- [HTML macro](https://github.com/DioxusLabs/dioxus-html-macro): A html-like alternative to the RSX macro - -## Native Renderer Utilities - -- [native-core](https://github.com/DioxusLabs/dioxus/tree/master/packages/native-core): Incrementally computed tree of states (mostly styles) - - You can read more about how native-core can help you build native renderers in the [custom renderer section of the guide](../custom_renderer/index.html#native-core) -- [native-core-macro](https://github.com/DioxusLabs/dioxus/tree/master/packages/native-core-macro): A helper macro for native core -- [Taffy](https://github.com/DioxusLabs/taffy): Layout engine powering Blitz-Core, Rink, and Bevy UI - -## Web renderer tooling - -- [HTML](https://github.com/DioxusLabs/dioxus/tree/master/packages/html): defines html specific elements, events, and attributes -- [Interpreter](https://github.com/DioxusLabs/dioxus/tree/master/packages/interpreter): defines browser bindings used by the web and desktop renderers - -## Developer tooling - -- [hot-reload](https://github.com/DioxusLabs/dioxus/tree/master/packages/hot-reload): Macro that uses the RSX crate to hot reload static parts of any rsx! macro. This macro works with any non-web renderer with an [integration](https://crates.io/crates/dioxus-hot-reload) -- [autofmt](https://github.com/DioxusLabs/dioxus/tree/master/packages/autofmt): Formats RSX code -- [rsx-rosetta](https://github.com/DioxusLabs/dioxus/tree/master/packages/RSX-rosetta): Handles conversion between HTML and RSX -- [CLI](https://github.com/DioxusLabs/cli): A Command Line Interface and VSCode extension to assist with Dioxus usage diff --git a/docs/guide/src/en/contributing/roadmap.md b/docs/guide/src/en/contributing/roadmap.md deleted file mode 100644 index fba5913db..000000000 --- a/docs/guide/src/en/contributing/roadmap.md +++ /dev/null @@ -1,138 +0,0 @@ -# Roadmap & Feature-set - -This feature set and roadmap can help you decide if what Dioxus can do today works for you. - -If a feature that you need doesn't exist or you want to contribute to projects on the roadmap, feel free to get involved by [joining the discord](https://discord.gg/XgGxMSkvUM). - -Generally, here's the status of each platform: - -- **Web**: Dioxus is a great choice for pure web-apps – especially for CRUD/complex apps. However, it does lack the ecosystem of React, so you might be missing a component library or some useful hook. - -- **SSR**: Dioxus is a great choice for pre-rendering, hydration, and rendering HTML on a web endpoint. Be warned – the VirtualDom is not (currently) `Send + Sync`. - -- **Desktop**: You can build very competent single-window desktop apps right now. However, multi-window apps require support from Dioxus core and are not ready. - -- **Mobile**: Mobile support is very young. You'll be figuring things out as you go and there are not many support crates for peripherals. - -- **LiveView**: LiveView support is very young. You'll be figuring things out as you go. Thankfully, none of it is too hard and any work can be upstreamed into Dioxus. - -## Features - ---- - -| Feature | Status | Description | -| ------------------------- | ------ | -------------------------------------------------------------------- | -| Conditional Rendering | βœ… | if/then to hide/show component | -| Map, Iterator | βœ… | map/filter/reduce to produce rsx! | -| Keyed Components | βœ… | advanced diffing with keys | -| Web | βœ… | renderer for web browser | -| Desktop (webview) | βœ… | renderer for desktop | -| Shared State (Context) | βœ… | share state through the tree | -| Hooks | βœ… | memory cells in components | -| SSR | βœ… | render directly to string | -| Component Children | βœ… | cx.children() as a list of nodes | -| Headless components | βœ… | components that don't return real elements | -| Fragments | βœ… | multiple elements without a real root | -| Manual Props | βœ… | Manually pass in props with spread syntax | -| Controlled Inputs | βœ… | stateful wrappers around inputs | -| CSS/Inline Styles | βœ… | syntax for inline styles/attribute groups | -| Custom elements | βœ… | Define new element primitives | -| Suspense | βœ… | schedule future render from future/promise | -| Integrated error handling | βœ… | Gracefully handle errors with ? syntax | -| NodeRef | βœ… | gain direct access to nodes | -| Re-hydration | βœ… | Pre-render to HTML to speed up first contentful paint | -| Jank-Free Rendering | βœ… | Large diffs are segmented across frames for silky-smooth transitions | -| Effects | βœ… | Run effects after a component has been committed to render | -| Portals | πŸ›  | Render nodes outside of the traditional tree structure | -| Cooperative Scheduling | πŸ›  | Prioritize important events over non-important events | -| Server Components | πŸ›  | Hybrid components for SPA and Server | -| Bundle Splitting | πŸ‘€ | Efficiently and asynchronously load the app | -| Lazy Components | πŸ‘€ | Dynamically load the new components as the page is loaded | -| 1st class global state | βœ… | redux/recoil/mobx on top of context | -| Runs natively | βœ… | runs as a portable binary w/o a runtime (Node) | -| Subtree Memoization | βœ… | skip diffing static element subtrees | -| High-efficiency templates | βœ… | rsx! calls are translated to templates on the DOM's side | -| Compile-time correct | βœ… | Throw errors on invalid template layouts | -| Heuristic Engine | βœ… | track component memory usage to minimize future allocations | -| Fine-grained reactivity | πŸ‘€ | Skip diffing for fine-grain updates | - -- βœ… = implemented and working -- πŸ›  = actively being worked on -- πŸ‘€ = not yet implemented or being worked on - -## Roadmap - -These Features are planned for the future of Dioxus: - -### Core - -- [x] Release of Dioxus Core -- [x] Upgrade documentation to include more theory and be more comprehensive -- [x] Support for HTML-side templates for lightning-fast dom manipulation -- [ ] Support for multiple renderers for same virtualdom (subtrees) -- [ ] Support for ThreadSafe (Send + Sync) -- [ ] Support for Portals - -### SSR - -- [x] SSR Support + Hydration -- [ ] Integrated suspense support for SSR - -### Desktop - -- [ ] Declarative window management -- [ ] Templates for building/bundling -- [ ] Access to Canvas/WebGL context natively - -### Mobile - -- [ ] Mobile standard library - - [ ] GPS - - [ ] Camera - - [ ] filesystem - - [ ] Biometrics - - [ ] WiFi - - [ ] Bluetooth - - [ ] Notifications - - [ ] Clipboard -- [ ] Animations - -### Bundling (CLI) - -- [x] Translation from HTML into RSX -- [x] Dev server -- [x] Live reload -- [x] Translation from JSX into RSX -- [ ] Hot module replacement -- [ ] Code splitting -- [ ] Asset macros -- [ ] Css pipeline -- [ ] Image pipeline - -### Essential hooks - -- [x] Router -- [x] Global state management -- [ ] Resize observer - -## Work in Progress - -### Build Tool - -We are currently working on our own build tool called [Dioxus CLI](https://github.com/DioxusLabs/cli) which will support: - -- an interactive TUI -- on-the-fly reconfiguration -- hot CSS reloading -- two-way data binding between browser and source code -- an interpreter for `rsx!` -- ability to publish to github/netlify/vercel -- bundling for iOS/Desktop/etc - -### Server Component Support - -While not currently fully implemented, the expectation is that LiveView apps can be a hybrid between Wasm and server-rendered where only portions of a page are "live" and the rest of the page is either server-rendered, statically generated, or handled by the host SPA. - -### Native rendering - -We are currently working on a native renderer for Dioxus using WGPU called [Blitz](https://github.com/DioxusLabs/blitz/). This will allow you to build apps that are rendered natively for iOS, Android, and Desktop. diff --git a/docs/guide/src/en/contributing/walkthrough_readme.md b/docs/guide/src/en/contributing/walkthrough_readme.md deleted file mode 100644 index 5be9d4b5a..000000000 --- a/docs/guide/src/en/contributing/walkthrough_readme.md +++ /dev/null @@ -1,136 +0,0 @@ -# Walkthrough of the Hello World Example Internals - -This walkthrough will take you through the internals of the Hello World example program. It will explain how major parts of Dioxus internals interact with each other to take the readme example from a source file to a running application. This guide should serve as a high-level overview of the internals of Dioxus. It is not meant to be a comprehensive guide. - -## The Source File - -We start will a hello world program. This program renders a desktop app with the text "Hello World" in a webview. - -```rust, no_run -{{#include ../../../../../examples/readme.rs}} -``` - -[![](https://mermaid.ink/img/pako:eNqNkT1vwyAQhv8KvSlR48HphtQtqjK0S6tuSBGBS0CxwcJHk8rxfy_YVqxKVdR3ug_u4YXrQHmNwOFQ-bMyMhB7fReOJbVxfwyyMSy0l7GSpW1ARda727ksUy5MuSyKgvBC5ULA1h5N8WK_kCkfHWHgrBuiXsBynrvdsY9E3u1iM_eyvFOVVadMnELOap-o1911JLPHZ1b-YqLTc3LjTt7WifTZMJPsPdx1ov3Z_ellfcdL8R8vmTy5eUqsTUpZ-vzZzjAEK6gx1NLqtJwuNwSQwRoF8BRqGU4ChOvTORnJf3w7BZxCxBXERkvCjZXpQTXwg6zaVEVtyYe3cdvD0vsf4bucgw?type=png)](https://mermaid.live/edit#pako:eNqNkT1vwyAQhv8KvSlR48HphtQtqjK0S6tuSBGBS0CxwcJHk8rxfy_YVqxKVdR3ug_u4YXrQHmNwOFQ-bMyMhB7fReOJbVxfwyyMSy0l7GSpW1ARda727ksUy5MuSyKgvBC5ULA1h5N8WK_kCkfHWHgrBuiXsBynrvdsY9E3u1iM_eyvFOVVadMnELOap-o1911JLPHZ1b-YqLTc3LjTt7WifTZMJPsPdx1ov3Z_ellfcdL8R8vmTy5eUqsTUpZ-vzZzjAEK6gx1NLqtJwuNwSQwRoF8BRqGU4ChOvTORnJf3w7BZxCxBXERkvCjZXpQTXwg6zaVEVtyYe3cdvD0vsf4bucgw) - -## The rsx! Macro - -Before the Rust compiler runs the program, it will expand all [macros](https://doc.rust-lang.org/reference/procedural-macros.html). Here is what the hello world example looks like expanded: - -```rust, no_run -{{#include ../../../examples/readme_expanded.rs}} -``` - -The rsx macro separates the static parts of the rsx (the template) and the dynamic parts (the [dynamic_nodes](https://docs.rs/dioxus-core/0.3.2/dioxus_core/prelude/struct.VNode.html#structfield.dynamic_nodes) and [dynamic_attributes](https://docs.rs/dioxus-core/0.3.2/dioxus_core/prelude/struct.VNode.html#structfield.dynamic_attrs)). - -The static template only contains the parts of the rsx that cannot change at runtime with holes for the dynamic parts: - -[![](https://mermaid.ink/img/pako:eNqdksFuwjAMhl8l8wkkKtFx65njdtm0E0GVSQKJoEmVOgKEeHecUrXStO0wn5Lf9u8vcm6ggjZQwf4UzspiJPH2Ib3g6NLuELG1oiMkp0TsLs9EDu2iUeSCH8tz2HJmy3lRFPrqsXGq9mxeLzcbCU6LZSUGXWRdwnY7tY7Tdoko-Dq1U64fODgiUfzJMeuOe7_ZGq-ny2jNhGQu9DqT8NUK6w72RcL8dxgdzv4PnHLAKf-Fk80HoBUDrfkqeBkTUd8EC2hMbNBpXtYtJySQNQ0PqPioMR4lSH_nOkwUPq9eQUUxmQWkViOZtUN-UwPVHk8dq0Y7CvH9uf3-E9wfrmuk1A?type=png)](https://mermaid.live/edit#pako:eNqdksFuwjAMhl8l8wkkKtFx65njdtm0E0GVSQKJoEmVOgKEeHecUrXStO0wn5Lf9u8vcm6ggjZQwf4UzspiJPH2Ib3g6NLuELG1oiMkp0TsLs9EDu2iUeSCH8tz2HJmy3lRFPrqsXGq9mxeLzcbCU6LZSUGXWRdwnY7tY7Tdoko-Dq1U64fODgiUfzJMeuOe7_ZGq-ny2jNhGQu9DqT8NUK6w72RcL8dxgdzv4PnHLAKf-Fk80HoBUDrfkqeBkTUd8EC2hMbNBpXtYtJySQNQ0PqPioMR4lSH_nOkwUPq9eQUUxmQWkViOZtUN-UwPVHk8dq0Y7CvH9uf3-E9wfrmuk1A) - -The dynamic_nodes and dynamic_attributes are the parts of the rsx that can change at runtime: - -[![](https://mermaid.ink/img/pako:eNp1UcFOwzAM_RXLVzZpvUbighDiABfgtkxTlnirtSaZUgc0df130hZEEcwny35-79nu0EZHqHDfxA9bmyTw9KIDlGjz7pDMqQZ3DsazhVCQ7dQbwnEiKxwDvN3NqhN4O4C3q_VaIztYKXjkQ7184HcCG3MQSgq6Mes1bjbTPAV3RdqIJN5l-V__2_Fcf5iY68dgG7ZHBT4WD5ftZfIBN7dQ_Tj4w1B9MVTXGZa_GMYdcIGekjfsymW7oaFRavKkUZXUmXTUqENfcCZLfD0Hi0pSpgXmkzNC92zKATyqvWnaUiXHEtPz9KrxY_0nzYOPmA?type=png)](https://mermaid.live/edit#pako:eNp1UcFOwzAM_RXLVzZpvUbighDiABfgtkxTlnirtSaZUgc0df130hZEEcwny35-79nu0EZHqHDfxA9bmyTw9KIDlGjz7pDMqQZ3DsazhVCQ7dQbwnEiKxwDvN3NqhN4O4C3q_VaIztYKXjkQ7184HcCG3MQSgq6Mes1bjbTPAV3RdqIJN5l-V__2_Fcf5iY68dgG7ZHBT4WD5ftZfIBN7dQ_Tj4w1B9MVTXGZa_GMYdcIGekjfsymW7oaFRavKkUZXUmXTUqENfcCZLfD0Hi0pSpgXmkzNC92zKATyqvWnaUiXHEtPz9KrxY_0nzYOPmA) - -## Launching the App - -The app is launched by calling the `launch` function with the root component. Internally, this function will create a new web view using [wry](https://docs.rs/wry/latest/wry/) and create a virtual dom with the root component (`fn app()` in the readme example). This guide will not explain the renderer in-depth, but you can read more about it in the [custom renderer](/guide/custom-renderer) section. - -## The Virtual DOM - -Before we dive into the initial render in the virtual DOM, we need to discuss what the virtual DOM is. The virtual DOM is a representation of the DOM that is used to diff the current DOM from the new DOM. This diff is then used to create a list of mutations that need to be applied to the DOM to bring it into sync with the virtual DOM. - -The Virtual DOM roughly looks like this: - -```rust, no_run -pub struct VirtualDom { - // All the templates that have been created or set during hot reloading - pub(crate) templates: FxHashMap>>, - - // A slab of all the scopes that have been created - pub(crate) scopes: ScopeSlab, - - // All scopes that have been marked as dirty - pub(crate) dirty_scopes: BTreeSet, - - // Every element is actually a dual reference - one to the template and the other to the dynamic node in that template - pub(crate) elements: Slab, - - // This receiver is used to receive messages from hooks about what scopes need to be marked as dirty - pub(crate) rx: futures_channel::mpsc::UnboundedReceiver, - - // The changes queued up to be sent to the renderer - pub(crate) mutations: Mutations<'static>, -} -``` - -> What is a [slab](https://docs.rs/slab/latest/slab/)? -> -> A slab acts like a hashmap with integer keys if you don't care about the value of the keys. It is internally backed by a dense vector which makes it more efficient than a hashmap. When you insert a value into a slab, it returns an integer key that you can use to retrieve the value later. - -> How does Dioxus use slabs? -> -> Dioxus uses "synchronized slabs" to communicate between the renderer and the VDOM. When a node is created in the Virtual DOM, an (elementId, mutation) pair is passed to the renderer to identify that node, which the renderer will then render in actual DOM. These ids are also used by the Virtual Dom to reference that node in future mutations, like setting an attribute on a node or removing a node. When the renderer sends an event to the Virtual Dom, it sends the ElementId of the node that the event was triggered on. The Virtual DOM uses this id to find that node in the slab and then run the necessary event handlers. - -The virtual DOM is a tree of scopes. A new `Scope` is created for every component when it is first rendered and recycled when the component is unmounted. - -Scopes serve three main purposes: - -1. They store the state of hooks used by the component -2. They store the state for the context API (for example: using - [use_shared_state_provider](https://docs.rs/dioxus/latest/dioxus/prelude/fn.use_shared_state_provider.html)). -3. They store the current and previous versions of the `VNode` that was rendered, so they can be - diffed to generate the set of mutations needed to re-render it. - -### The Initial Render - -The root scope is created and rebuilt: - -1. The root component is run -2. The root component returns a `VNode` -3. Mutations for this `VNode` are created and added to the mutation list (this may involve creating new child components) -4. The `VNode` is stored in the root's `Scope`. - -After the root's `Scope` is built, all generated mutations are sent to the renderer, which applies them to the DOM. - -After the initial render, the root `Scope` looks like this: - -[![](https://mermaid.ink/img/pako:eNqtVE1P4zAQ_SuzPrWikRpWXCLtBRDisItWsOxhCaqM7RKricdyJrQV8N93QtvQNCkfEnOynydv3nxkHoVCbUQipjnOVSYDwc_L1AFbWd3dB-kzuEQkuFLoDUwDFkCZAek9nGDh0RlHK__atA1GkUUHf45f0YbppAqB_aOzIAvz-t7-chN_Y-1bw1WSJKsglIu2w9tktWXxIIuHURT5XCqTYa5NmDguw2R8c5MKq2GcgF46WTB_jafi9rZL0yi5q4jQTSrf9altO4okCn1Ratwyz55Qxuku2ITlTMgs6HCQimsPmb3PvqVi-L5gjXP3QcnxWnL8JZLrwGvR31n0KV-Bx6-r-oVkT_-3G1S-NQLbk9i8rj7udP2cixed2QcDCitHJiQw7ub3EVlNecrPjudG2-6soFO5VbMECmR9T5OnlUY4-AFxfw9aTFst3McU9TK1Otm6NEn_DubBYlX2_dglLXOz48FgwJmJ5lZTlhz6xWgNaFnyDgpymcARHO0W2a9J_l5w2wYXvHuGPcqaQ-rESBQmFNJq3nCPNZoK3l4sUSR81DLMUpG6Z_aTFeHV0imRUKjMSFReSzKnVnKGhUimMi8ZNdoShl-rlfmyOUfCS_cPcePz_B_Wl4pc?type=png)](https://mermaid.live/edit#pako:eNqtVE1P4zAQ_SuzPrWikRpWXCLtBRDisItWsOxhCaqM7RKricdyJrQV8N93QtvQNCkfEnOynydv3nxkHoVCbUQipjnOVSYDwc_L1AFbWd3dB-kzuEQkuFLoDUwDFkCZAek9nGDh0RlHK__atA1GkUUHf45f0YbppAqB_aOzIAvz-t7-chN_Y-1bw1WSJKsglIu2w9tktWXxIIuHURT5XCqTYa5NmDguw2R8c5MKq2GcgF46WTB_jafi9rZL0yi5q4jQTSrf9altO4okCn1Ratwyz55Qxuku2ITlTMgs6HCQimsPmb3PvqVi-L5gjXP3QcnxWnL8JZLrwGvR31n0KV-Bx6-r-oVkT_-3G1S-NQLbk9i8rj7udP2cixed2QcDCitHJiQw7ub3EVlNecrPjudG2-6soFO5VbMECmR9T5OnlUY4-AFxfw9aTFst3McU9TK1Otm6NEn_DubBYlX2_dglLXOz48FgwJmJ5lZTlhz6xWgNaFnyDgpymcARHO0W2a9J_l5w2wYXvHuGPcqaQ-rESBQmFNJq3nCPNZoK3l4sUSR81DLMUpG6Z_aTFeHV0imRUKjMSFReSzKnVnKGhUimMi8ZNdoShl-rlfmyOUfCS_cPcePz_B_Wl4pc) - -### Waiting for Events - -The Virtual DOM will only ever re-render a `Scope` if it is marked as dirty. Each hook is responsible for marking the `Scope` as dirty if the state has changed. Hooks can mark a scope as dirty by sending a message to the Virtual Dom's channel. You can see the [implementations](https://github.com/DioxusLabs/dioxus/tree/master/packages/hooks) for the hooks dioxus includes by default on how this is done. Calling `needs_update()` on a hook will also cause it to mark its scope as dirty. - -There are generally two ways a scope is marked as dirty: - -1. The renderer triggers an event: An event listener on this event may be called, which may mark a - component as dirty, if processing the event resulted in any generated any mutations. -2. The renderer calls - [`wait_for_work`](https://docs.rs/dioxus/latest/dioxus/prelude/struct.VirtualDom.html#method.wait_for_work): - This polls dioxus internal future queue. One of these futures may mark a component as dirty. - -Once at least one `Scope` is marked as dirty, the renderer can call [`render_with_deadline`](https://docs.rs/dioxus/latest/dioxus/prelude/struct.VirtualDom.html#method.render_with_deadline) to diff the dirty scopes. - -### Diffing Scopes - -When a user clicks the "up high" button, the root `Scope` will be marked as dirty by the `use_state` hook. The desktop renderer will then call `render_with_deadline`, which will diff the root `Scope`. - -To start the diffing process, the component function is run. After the root component is run it, the root `Scope` will look like this: - -[![](https://mermaid.ink/img/pako:eNrFVlFP2zAQ_iuen0BrpCaIl0i8AEJ72KQJtpcRFBnbJVYTn-U4tBXw33dpG5M2CetoBfdkny_ffb67fPIT5SAkjekkhxnPmHXk-3WiCVpZ3T9YZjJyDeDIDQcjycRCQVwmCTOGXEBhQEvtVvG1CWUldwo0-XX-6vVIF5W1GB9cWVbI1_PNL5v8jW3uPFbpmFOc2HK-GfA2WG1ZeJSFx0EQmJxxmUEupE01liEd394mVAkyjolYaFYgfu1P6N1dF8Yzua-cA51WphtTWzsLc872Zan9CnEGUkktuk6fFm_i5NxFRwn9bUimHrIvCT3-N2EBM70j5XBNOTwI5TrxmvQJkr7ELcHx67Jeggz0v92g8q0RaE-iP1193On6NyxecKUeJeFQaSdtTMLu_Xah5ctT_u94Nty2ZwU0zxWfxqQA5PecPq84kq9nfRw7SK0WDiEFZ4O37d34S_-08lFBVfb92KVb5HIrAp0WpjKYKeGyODLz0dohWIkaZNkiJqfkdLvIH6oRaTSoEmm0n06k0a5K0ZdpL61Io0Yt0nfpxc7UQ0_9cJrhyZ8syX-6brS706Mc489Vjja7fbWj3cxDqIdfJJqOaCFtwZTAV8hT7U0ovjBQRmiMS8HsNKGJfsE4Vjm4WWhOY2crOaKVEczJS8WwgAWNJywv0SuFcmB_rJ41y9fNiBqm_wA0MS9_AUuAiy0?type=png)](https://mermaid.live/edit#pako:eNrFVlFP2zAQ_iuen0BrpCaIl0i8AEJ72KQJtpcRFBnbJVYTn-U4tBXw33dpG5M2CetoBfdkny_ffb67fPIT5SAkjekkhxnPmHXk-3WiCVpZ3T9YZjJyDeDIDQcjycRCQVwmCTOGXEBhQEvtVvG1CWUldwo0-XX-6vVIF5W1GB9cWVbI1_PNL5v8jW3uPFbpmFOc2HK-GfA2WG1ZeJSFx0EQmJxxmUEupE01liEd394mVAkyjolYaFYgfu1P6N1dF8Yzua-cA51WphtTWzsLc872Zan9CnEGUkktuk6fFm_i5NxFRwn9bUimHrIvCT3-N2EBM70j5XBNOTwI5TrxmvQJkr7ELcHx67Jeggz0v92g8q0RaE-iP1193On6NyxecKUeJeFQaSdtTMLu_Xah5ctT_u94Nty2ZwU0zxWfxqQA5PecPq84kq9nfRw7SK0WDiEFZ4O37d34S_-08lFBVfb92KVb5HIrAp0WpjKYKeGyODLz0dohWIkaZNkiJqfkdLvIH6oRaTSoEmm0n06k0a5K0ZdpL61Io0Yt0nfpxc7UQ0_9cJrhyZ8syX-6brS706Mc489Vjja7fbWj3cxDqIdfJJqOaCFtwZTAV8hT7U0ovjBQRmiMS8HsNKGJfsE4Vjm4WWhOY2crOaKVEczJS8WwgAWNJywv0SuFcmB_rJ41y9fNiBqm_wA0MS9_AUuAiy0) - -Next, the Virtual DOM will compare the new VNode with the previous VNode and only update the parts of the tree that have changed. Because of this approach, when a component is re-rendered only the parts of the tree that have changed will be updated in the DOM by the renderer. - -The diffing algorithm goes through the list of dynamic attributes and nodes and compares them to the previous VNode. If the attribute or node has changed, a mutation that describes the change is added to the mutation list. - -Here is what the diffing algorithm looks like for the root `Scope` (red lines indicate that a mutation was generated, and green lines indicate that no mutation was generated) - -[![](https://mermaid.ink/img/pako:eNrFlFFPwjAQx7_KpT7Kko2Elya8qCE-aGLAJ5khpe1Yw9Zbug4k4He3OJjbGPig0T5t17tf_nf777aEo5CEkijBNY-ZsfAwDjW4kxfzhWFZDGNECxOOmYTIYAo2lsCyDG4xzVBLbcv8_RHKSG4V6orSIN0Wxrh8b2RYKr_uTyubd1W92GiWKg7aac6bOU3G803HbVk82xfP_Ok0JEqAT-FeLWJvpFYSOBbaSkMhCMnra5MgtfhWFrPWqHlhL2urT6atbU-oa0PNE8WXFFJ0-nazXakRroddGk9IwYEUnCd5w7Pddr5UTT8ZuVJY5F0fM7ebRLYyXNDgUnprJWxM-9lb7xAQLHe-M2xDYQCD9pD_2hez_kVn-P_rjLq6n3qjYv2iO5qz9DyvPdyv1ETp5eTTJ_7BGvQq8v1TVtl5jXUcRRcrqFh-dI4VtFlBN6t_ynLNkh5JpUmZEm5rbvfhkLiN6H4BQt2jYGYZklC_uzxWWJxsNCfUmkL2SJEJZuWdYs4cKaERS3IXlUJZNI_lGv7cxj2SMf2CeMx5_wBcbK19?type=png)](https://mermaid.live/edit#pako:eNrFlFFPwjAQx7_KpT7Kko2Elya8qCE-aGLAJ5khpe1Yw9Zbug4k4He3OJjbGPig0T5t17tf_nf777aEo5CEkijBNY-ZsfAwDjW4kxfzhWFZDGNECxOOmYTIYAo2lsCyDG4xzVBLbcv8_RHKSG4V6orSIN0Wxrh8b2RYKr_uTyubd1W92GiWKg7aac6bOU3G803HbVk82xfP_Ok0JEqAT-FeLWJvpFYSOBbaSkMhCMnra5MgtfhWFrPWqHlhL2urT6atbU-oa0PNE8WXFFJ0-nazXakRroddGk9IwYEUnCd5w7Pddr5UTT8ZuVJY5F0fM7ebRLYyXNDgUnprJWxM-9lb7xAQLHe-M2xDYQCD9pD_2hez_kVn-P_rjLq6n3qjYv2iO5qz9DyvPdyv1ETp5eTTJ_7BGvQq8v1TVtl5jXUcRRcrqFh-dI4VtFlBN6t_ynLNkh5JpUmZEm5rbvfhkLiN6H4BQt2jYGYZklC_uzxWWJxsNCfUmkL2SJEJZuWdYs4cKaERS3IXlUJZNI_lGv7cxj2SMf2CeMx5_wBcbK19) - -## Conclusion - -This is only a brief overview of how the Virtual Dom works. There are several aspects not yet covered in this guide including: - - * How the Virtual DOM handles async-components - * Keyed diffing - * Using [bump allocation](https://github.com/fitzgen/bumpalo) to efficiently allocate VNodes. - -If you need more information about the Virtual Dom, you can read the code of the [core](https://github.com/DioxusLabs/dioxus/tree/master/packages/core) crate or reach out to us on [Discord](https://discord.gg/XgGxMSkvUM). \ No newline at end of file diff --git a/docs/guide/src/en/custom_renderer/index.md b/docs/guide/src/en/custom_renderer/index.md deleted file mode 100644 index 3b6888b0d..000000000 --- a/docs/guide/src/en/custom_renderer/index.md +++ /dev/null @@ -1,413 +0,0 @@ -# Custom Renderer - -Dioxus is an incredibly portable framework for UI development. The lessons, knowledge, hooks, and components you acquire over time can always be used for future projects. However, sometimes those projects cannot leverage a supported renderer or you need to implement your own better renderer. - -Great news: the design of the renderer is entirely up to you! We provide suggestions and inspiration with the 1st party renderers, but only really require processing `Mutations` and sending `UserEvents`. - -## The specifics: - -Implementing the renderer is fairly straightforward. The renderer needs to: - -1. Handle the stream of edits generated by updates to the virtual DOM -2. Register listeners and pass events into the virtual DOM's event system - -Essentially, your renderer needs to process edits and generate events to update the VirtualDOM. From there, you'll have everything needed to render the VirtualDOM to the screen. - -Internally, Dioxus handles the tree relationship, diffing, memory management, and the event system, leaving as little as possible required for renderers to implement themselves. - -For reference, check out the [javascript interpreter](https://github.com/DioxusLabs/dioxus/tree/master/packages/interpreter) or [tui renderer](https://github.com/DioxusLabs/dioxus/tree/master/packages/dioxus-tui) as a starting point for your custom renderer. - -## Templates - -Dioxus is built around the concept of [Templates](https://docs.rs/dioxus-core/latest/dioxus_core/prelude/struct.Template.html). Templates describe a UI tree known at compile time with dynamic parts filled at runtime. This is useful internally to make skip diffing static nodes, but it is also useful for the renderer to reuse parts of the UI tree. This can be useful for things like a list of items. Each item could contain some static parts and some dynamic parts. The renderer can use the template to create a static part of the UI once, clone it for each element in the list, and then fill in the dynamic parts. - -## Mutations - -The `Mutation` type is a serialized enum that represents an operation that should be applied to update the UI. The variants roughly follow this set: - -```rust, no_run -enum Mutation { - AppendChildren, - AssignId, - CreatePlaceholder, - CreateTextNode, - HydrateText, - LoadTemplate, - ReplaceWith, - ReplacePlaceholder, - InsertAfter, - InsertBefore, - SetAttribute, - SetText, - NewEventListener, - RemoveEventListener, - Remove, - PushRoot, -} -``` - -The Dioxus diffing mechanism operates as a [stack machine](https://en.wikipedia.org/wiki/Stack_machine) where the [LoadTemplate](https://docs.rs/dioxus-core/latest/dioxus_core/enum.Mutation.html#variant.LoadTemplate), [CreatePlaceholder](https://docs.rs/dioxus-core/latest/dioxus_core/enum.Mutation.html#variant.CreatePlaceholder), and [CreateTextNode](https://docs.rs/dioxus-core/latest/dioxus_core/enum.Mutation.html#variant.CreateTextNode) mutations pushes a new "real" DOM node onto the stack and [AppendChildren](https://docs.rs/dioxus-core/latest/dioxus_core/enum.Mutation.html#variant.AppendChildren), [InsertAfter](https://docs.rs/dioxus-core/latest/dioxus_core/enum.Mutation.html#variant.InsertAfter), [InsertBefore](https://docs.rs/dioxus-core/latest/dioxus_core/enum.Mutation.html#variant.InsertBefore), [ReplacePlaceholder](https://docs.rs/dioxus-core/latest/dioxus_core/enum.Mutation.html#variant.ReplacePlaceholder), and [ReplaceWith](https://docs.rs/dioxus-core/latest/dioxus_core/enum.Mutation.html#variant.ReplaceWith) all remove nodes from the stack. - -## Node storage - -Dioxus saves and loads elements with IDs. Inside the VirtualDOM, this is just tracked as as a u64. - -Whenever a `CreateElement` edit is generated during diffing, Dioxus increments its node counter and assigns that new element its current NodeCount. The RealDom is responsible for remembering this ID and pushing the correct node when id is used in a mutation. Dioxus reclaims the IDs of elements when removed. To stay in sync with Dioxus you can use a sparse Vec (Vec>) with possibly unoccupied items. You can use the ids as indexes into the Vec for elements, and grow the Vec when an id does not exist. - -### An Example - -For the sake of understanding, let's consider this example – a very simple UI declaration: - -```rust, no_run -rsx!( h1 {"count: {x}"} ) -``` - -#### Building Templates - -The above rsx will create a template that contains one static h1 tag and a placeholder for a dynamic text node. The template contains the static parts of the UI, and ids for the dynamic parts along with the paths to access them. - -The template will look something like this: - -```rust, no_run -Template { - // Some id that is unique for the entire project - name: "main.rs:1:1:0", - // The root nodes of the template - roots: &[ - TemplateNode::Element { - tag: "h1", - namespace: None, - attrs: &[], - children: &[ - TemplateNode::DynamicText { - id: 0 - }, - ], - } - ], - // the path to each of the dynamic nodes - node_paths: &[ - // the path to dynamic node with a id of 0 - &[ - // on the first root node - 0, - // the first child of the root node - 0, - ] - ], - // the path to each of the dynamic attributes - attr_paths: &'a [&'a [u8]], -} -``` - -> For more detailed docs about the struture of templates see the [Template api docs](https://docs.rs/dioxus-core/latest/dioxus_core/prelude/struct.Template.html) - -This template will be sent to the renderer in the [list of templates](https://docs.rs/dioxus-core/latest/dioxus_core/struct.Mutations.html#structfield.templates) supplied with the mutations the first time it is used. Any time the renderer encounters a [LoadTemplate](https://docs.rs/dioxus-core/latest/dioxus_core/enum.Mutation.html#variant.LoadTemplate) mutation after this, it should clone the template and store it in the given id. - -For dynamic nodes and dynamic text nodes, a placeholder node should be created and inserted into the UI so that the node can be modified later. - -In HTML renderers, this template could look like this: - -```html -

""

-``` - -#### Applying Mutations - -After the renderer has created all of the new templates, it can begin to process the mutations. - -When the renderer starts, it should contain the Root node on the stack and store the Root node with an id of 0. The Root node is the top-level node of the UI. In HTML, this is the `
` element. - -```rust, no_run -instructions: [] -stack: [ - RootNode, -] -nodes: [ - RootNode, -] -``` - -The first mutation is a `LoadTemplate` mutation. This tells the renderer to load a root from the template with the given id. The renderer will then push the root node of the template onto the stack and store it with an id for later. In this case, the root node is an h1 element. - -```rust, no_run -instructions: [ - LoadTemplate { - // the id of the template - name: "main.rs:1:1:0", - // the index of the root node in the template - index: 0, - // the id to store - id: ElementId(1), - } -] -stack: [ - RootNode, -

""

, -] -nodes: [ - RootNode, -

""

, -] -``` - -Next, Dioxus will create the dynamic text node. The diff algorithm decides that this node needs to be created, so Dioxus will generate the Mutation `HydrateText`. When the renderer receives this instruction, it will navigate to the placeholder text node in the template and replace it with the new text. - -```rust, no_run -instructions: [ - LoadTemplate { - name: "main.rs:1:1:0", - index: 0, - id: ElementId(1), - }, - HydrateText { - // the id to store the text node - id: ElementId(2), - // the text to set - text: "count: 0", - } -] -stack: [ - RootNode, -

"count: 0"

, -] -nodes: [ - RootNode, -

"count: 0"

, - "count: 0", -] -``` - -Remember, the h1 node is not attached to anything (it is unmounted) so Dioxus needs to generate an Edit that connects the h1 node to the Root. It depends on the situation, but in this case, we use `AppendChildren`. This pops the text node off the stack, leaving the Root element as the next element on the stack. - -```rust, no_run -instructions: [ - LoadTemplate { - name: "main.rs:1:1:0", - index: 0, - id: ElementId(1), - }, - HydrateText { - id: ElementId(2), - text: "count: 0", - }, - AppendChildren { - // the id of the parent node - id: ElementId(0), - // the number of nodes to pop off the stack and append - m: 1 - } -] -stack: [ - RootNode, -] -nodes: [ - RootNode, -

"count: 0"

, - "count: 0", -] -``` - -Over time, our stack looked like this: - -```rust, no_run -[Root] -[Root,

""

] -[Root,

"count: 0"

] -[Root] -``` - -Conveniently, this approach completely separates the Virtual DOM and the Real DOM. Additionally, these edits are serializable, meaning we can even manage UIs across a network connection. This little stack machine and serialized edits make Dioxus independent of platform specifics. - -Dioxus is also really fast. Because Dioxus splits the diff and patch phase, it's able to make all the edits to the RealDOM in a very short amount of time (less than a single frame) making rendering very snappy. It also allows Dioxus to cancel large diffing operations if higher priority work comes in while it's diffing. - -This little demo serves to show exactly how a Renderer would need to process a mutation stream to build UIs. - -## Event loop - -Like most GUIs, Dioxus relies on an event loop to progress the VirtualDOM. The VirtualDOM itself can produce events as well, so it's important for your custom renderer can handle those too. - -The code for the WebSys implementation is straightforward, so we'll add it here to demonstrate how simple an event loop is: - -```rust, no_run, ignore -pub async fn run(&mut self) -> dioxus_core::error::Result<()> { - // Push the body element onto the WebsysDom's stack machine - let mut websys_dom = crate::new::WebsysDom::new(prepare_websys_dom()); - websys_dom.stack.push(root_node); - - // Rebuild or hydrate the virtualdom - let mutations = self.internal_dom.rebuild(); - websys_dom.apply_mutations(mutations); - - // Wait for updates from the real dom and progress the virtual dom - loop { - let user_input_future = websys_dom.wait_for_event(); - let internal_event_future = self.internal_dom.wait_for_work(); - - match select(user_input_future, internal_event_future).await { - Either::Left((_, _)) => { - let mutations = self.internal_dom.work_with_deadline(|| false); - websys_dom.apply_mutations(mutations); - }, - Either::Right((event, _)) => websys_dom.handle_event(event), - } - - // render - } -} -``` - -It's important to decode what the real events are for your event system into Dioxus' synthetic event system (synthetic meaning abstracted). This simply means matching your event type and creating a Dioxus `UserEvent` type. Right now, the virtual event system is modeled almost entirely around the HTML spec, but we are interested in slimming it down. - -```rust, no_run, ignore -fn virtual_event_from_websys_event(event: &web_sys::Event) -> VirtualEvent { - match event.type_().as_str() { - "keydown" => { - let event: web_sys::KeyboardEvent = event.clone().dyn_into().unwrap(); - UserEvent::KeyboardEvent(UserEvent { - scope_id: None, - priority: EventPriority::Medium, - name: "keydown", - // This should be whatever element is focused - element: Some(ElementId(0)), - data: Arc::new(KeyboardData{ - char_code: event.char_code(), - key: event.key(), - key_code: event.key_code(), - alt_key: event.alt_key(), - ctrl_key: event.ctrl_key(), - meta_key: event.meta_key(), - shift_key: event.shift_key(), - location: event.location(), - repeat: event.repeat(), - which: event.which(), - }) - }) - } - _ => todo!() - } -} -``` - -## Custom raw elements - -If you need to go as far as relying on custom elements/attributes for your renderer – you totally can. This still enables you to use Dioxus' reactive nature, component system, shared state, and other features, but will ultimately generate different nodes. All attributes and listeners for the HTML and SVG namespace are shuttled through helper structs that essentially compile away. You can drop in your elements any time you want, with little hassle. However, you must be sure your renderer can handle the new namespace. - -For more examples and information on how to create custom namespaces, see the [`dioxus_html` crate](https://github.com/DioxusLabs/dioxus/blob/master/packages/html/README.md#how-to-extend-it). - -# Native Core - -If you are creating a renderer in rust, the [native-core](https://github.com/DioxusLabs/dioxus/tree/master/packages/native-core) crate provides some utilities to implement a renderer. It provides an abstraction over Mutations and Templates and contains helpers that can handle the layout and text editing for you. - -## The RealDom - -The `RealDom` is a higher-level abstraction over updating the Dom. It uses an entity component system to manage the state of nodes. This system allows you to modify insert and modify arbitrary components on nodes. On top of this, the RealDom provides a way to manage a tree of nodes, and the State trait provides a way to automatically add and update these components when the tree is modified. It also provides a way to apply `Mutations` to the RealDom. - -### Example - -Let's build a toy renderer with borders, size, and text color. -Before we start let's take a look at an example element we can render: - -```rust, no_run -cx.render(rsx!{ - div{ - color: "red", - p{ - border: "1px solid black", - "hello world" - } - } -}) -``` - -In this tree, the color depends on the parent's color. The layout depends on the children's layout, the current text, and the text size. The border depends on only the current node. - -In the following diagram arrows represent dataflow: - -[![](https://mermaid.ink/img/pako:eNqllV1vgjAUhv8K6W4wkQVa2QdLdrHsdlfukmSptEhjoaSWqTH-9xVwONAKst70g5739JzzlO5BJAgFAYi52EQJlsr6fAszS7d1sVhKnCdWJDJFt6peLVs5-9owohK7HFrVcFJ_pxnpmK8VVvRkTJikkWIiaxy1dhP23bUwW1WW5WbPrrqJ4ziR4EJ6dtVN2ls5y1ZztePUcrWZFCvqVEcPPDffvlyS1XoLIQnVgnVvVPR6FU9Zc-6dV453ojjOPbuetRJ57gIeXQR3cez7rjtteZyZQ2j5MqmjqwE0ZW0VKx9RKtgpFewp1aw3sXXFy6TWgiYlv8mfq1scD8ofbBCAfQg8_AMBOAyBxzEIwA4CxgQ99QbQkjnD2KT7_CfxGF8_9WXQEsq5sDZCcjICOXRCri4h6r3NA38Q6Jdi1EOx5w3DGDYYI6MUvJFjM3VoGHUeGoMd6mBnDmh2E3fo7O4Yhf0x4OkBmIKUyhQzol_GfbkcApXQlIYg0EOC5SoEYXbQ-3ChxHyXRSBQsqBTUOREx_7OsAY3BUGM-VqvUsKUkB_1U6vf05gtweEHTk4_HQ?type=png)](https://mermaid.live/edit#pako:eNqllV1vgjAUhv8K6W4wkQVa2QdLdrHsdlfukmSptEhjoaSWqTH-9xVwONAKst70g5739JzzlO5BJAgFAYi52EQJlsr6fAszS7d1sVhKnCdWJDJFt6peLVs5-9owohK7HFrVcFJ_pxnpmK8VVvRkTJikkWIiaxy1dhP23bUwW1WW5WbPrrqJ4ziR4EJ6dtVN2ls5y1ZztePUcrWZFCvqVEcPPDffvlyS1XoLIQnVgnVvVPR6FU9Zc-6dV453ojjOPbuetRJ57gIeXQR3cez7rjtteZyZQ2j5MqmjqwE0ZW0VKx9RKtgpFewp1aw3sXXFy6TWgiYlv8mfq1scD8ofbBCAfQg8_AMBOAyBxzEIwA4CxgQ99QbQkjnD2KT7_CfxGF8_9WXQEsq5sDZCcjICOXRCri4h6r3NA38Q6Jdi1EOx5w3DGDYYI6MUvJFjM3VoGHUeGoMd6mBnDmh2E3fo7O4Yhf0x4OkBmIKUyhQzol_GfbkcApXQlIYg0EOC5SoEYXbQ-3ChxHyXRSBQsqBTUOREx_7OsAY3BUGM-VqvUsKUkB_1U6vf05gtweEHTk4_HQ) - -[//]: # "%% mermaid flow chart" -[//]: # "flowchart TB" -[//]: # " subgraph context" -[//]: # " text_width(text width)" -[//]: # " end" -[//]: # " subgraph state" -[//]: # " direction TB" -[//]: # " subgraph div state" -[//]: # " direction TB" -[//]: # " state1(state)---color1(color)" -[//]: # " linkStyle 0 stroke-width:10px;" -[//]: # " state1---border1(border)" -[//]: # " linkStyle 1 stroke-width:10px;" -[//]: # " text_width-.->layout_width1(layout width)" -[//]: # " linkStyle 2 stroke:#ff5500,stroke-width:4px;" -[//]: # " state1---layout_width1" -[//]: # " linkStyle 3 stroke-width:10px;" -[//]: # " end" -[//]: # " subgraph p state" -[//]: # " direction TB" -[//]: # " state2(state)---color2(color)" -[//]: # " linkStyle 4 stroke-width:10px;" -[//]: # " color1-.->color2" -[//]: # " linkStyle 5 stroke:#0000ff,stroke-width:4px;" -[//]: # " state2---border2(border)" -[//]: # " linkStyle 6 stroke-width:10px;" -[//]: # " text_width-.->layout_width2(layout width)" -[//]: # " linkStyle 7 stroke:#ff5500,stroke-width:4px;" -[//]: # " state2---layout_width2" -[//]: # " linkStyle 8 stroke-width:10px;" -[//]: # " layout_width2-.->layout_width1" -[//]: # " linkStyle 9 stroke:#00aa00,stroke-width:4px;" -[//]: # " end" -[//]: # " subgraph hello world state" -[//]: # " direction TB" -[//]: # " state3(state)---border3(border)" -[//]: # " linkStyle 10 stroke-width:10px;" -[//]: # " state3---color3(color)" -[//]: # " linkStyle 11 stroke-width:10px;" -[//]: # " color2-.->color3" -[//]: # " linkStyle 12 stroke:#0000ff,stroke-width:4px;" -[//]: # " text_width-.->layout_width3(layout width)" -[//]: # " linkStyle 13 stroke:#ff5500,stroke-width:4px;" -[//]: # " state3---layout_width3" -[//]: # " linkStyle 14 stroke-width:10px;" -[//]: # " layout_width3-.->layout_width2" -[//]: # " linkStyle 15 stroke:#00aa00,stroke-width:4px;" -[//]: # " end" -[//]: # " end" - -To help in building a Dom, native-core provides the State trait and a RealDom struct. The State trait provides a way to describe how states in a node depend on other states in its relatives. By describing how to update a single node from its relations, native-core will derive a way to update the states of all nodes for you. Once you have a state you can provide it as a generic to RealDom. RealDom provides all of the methods to interact and update your new dom. - -Native Core cannot create all of the required methods for the State trait, but it can derive some of them. To implement the State trait, you must implement the following methods and let the `#[partial_derive_state]` macro handle the rest: - -```rust, no_run, ignore -{{#include ../../../examples/custom_renderer.rs:derive_state}} -``` - -Lets take a look at how to implement the State trait for a simple renderer. - -```rust, no_run -{{#include ../../../examples/custom_renderer.rs:state_impl}} -``` - -Now that we have our state, we can put it to use in our RealDom. We can update the RealDom with apply_mutations to update the structure of the dom (adding, removing, and changing properties of nodes) and then update_state to update the States for each of the nodes that changed. - -```rust, no_run -{{#include ../../../examples/custom_renderer.rs:rendering}} -``` - -## Layout - -For most platforms, the layout of the Elements will stay the same. The [layout_attributes](https://docs.rs/dioxus-native-core/latest/dioxus_native_core/layout_attributes/index.html) module provides a way to apply HTML attributes a [Taffy](https://docs.rs/taffy/latest/taffy/index.html) layout style. - -## Text Editing - -To make it easier to implement text editing in rust renderers, `native-core` also contains a renderer-agnostic cursor system. The cursor can handle text editing, selection, and movement with common keyboard shortcuts integrated. - -```rust, no_run -{{#include ../../../examples/custom_renderer.rs:cursor}} -``` - -## Conclusion - -That should be it! You should have nearly all the knowledge required on how to implement your renderer. We're super interested in seeing Dioxus apps brought to custom desktop renderers, mobile renderers, video game UI, and even augmented reality! If you're interested in contributing to any of these projects, don't be afraid to reach out or join the [community](https://discord.gg/XgGxMSkvUM). diff --git a/docs/guide/src/en/describing_ui/component_children.md b/docs/guide/src/en/describing_ui/component_children.md deleted file mode 100644 index 7e329abbc..000000000 --- a/docs/guide/src/en/describing_ui/component_children.md +++ /dev/null @@ -1,31 +0,0 @@ -# Component Children - -In some cases, you may wish to create a component that acts as a container for some other content, without the component needing to know what that content is. To achieve this, create a prop of type `Element`: - -```rust, no_run -{{#include ../../../examples/component_element_props.rs:Clickable}} -``` - -Then, when rendering the component, you can pass in the output of `cx.render(rsx!(...))`: - -```rust, no_run -{{#include ../../../examples/component_element_props.rs:Clickable_usage}} -``` - -> Note: Since `Element<'a>` is a borrowed prop, there will be no memoization. - -> Warning: While it may compile, do not include the same `Element` more than once in the RSX. The resulting behavior is unspecified. - -## The `children` field - -Rather than passing the RSX through a regular prop, you may wish to accept children similarly to how elements can have children. The "magic" `children` prop lets you achieve this: - -```rust, no_run -{{#include ../../../examples/component_children.rs:Clickable}} -``` - -This makes using the component much simpler: simply put the RSX inside the `{}` brackets – and there is no need for a `render` call or another macro! - -```rust, no_run -{{#include ../../../examples/component_children.rs:Clickable_usage}} -``` diff --git a/docs/guide/src/en/describing_ui/component_props.md b/docs/guide/src/en/describing_ui/component_props.md deleted file mode 100644 index 947ec5f70..000000000 --- a/docs/guide/src/en/describing_ui/component_props.md +++ /dev/null @@ -1,144 +0,0 @@ -# Component Props - -Just like you can pass arguments to a function, you can pass props to a component that customize its behavior! The components we've seen so far didn't accept any props – so let's write some components that do. - -## `#[derive(Props)]` - -Component props are a single struct annotated with `#[derive(Props)]`. For a component to accept props, the type of its argument must be `Scope`. Then, you can access the value of the props using `cx.props`. - -There are 2 flavors of Props structs: - -- Owned props: - - Don't have an associated lifetime - - Implement `PartialEq`, allow for memoization (if the props don't change, Dioxus won't re-render the component) -- Borrowed props: - - [Borrow](https://doc.rust-lang.org/beta/rust-by-example/scope/borrow.html) from a parent component - - Cannot be memoized due to lifetime constraints - -### Owned Props - -Owned Props are very simple – they don't borrow anything. Example: - -```rust, no_run -{{#include ../../../examples/component_owned_props.rs:Likes}} -``` - -You can then pass prop values to the component the same way you would pass attributes to an element: - -```rust, no_run -{{#include ../../../examples/component_owned_props.rs:App}} -``` - -![Screenshot: Likes component](./images/component_owned_props_screenshot.png) - -### Borrowed Props - -Owned props work well if your props are easy to copy around – like a single number. But what if we need to pass a larger data type, like a String from an `App` Component to a `TitleCard` subcomponent? A naive solution might be to [`.clone()`](https://doc.rust-lang.org/std/clone/trait.Clone.html) the String, creating a copy of it for the subcomponent – but this would be inefficient, especially for larger Strings. - -Rust allows for something more efficient – borrowing the String as a `&str` – this is what Borrowed Props are for! - -```rust, no_run -{{#include ../../../examples/component_borrowed_props.rs:TitleCard}} -``` - -We can then use the component like this: - -```rust, no_run -{{#include ../../../examples/component_borrowed_props.rs:App}} -``` - -![Screenshot: TitleCard component](./images/component_borrowed_props_screenshot.png) - -Borrowed props can be very useful, but they do not allow for memorization so they will _always_ rerun when the parent scope is rerendered. Because of this Borrowed Props should be reserved for components that are cheap to rerun or places where cloning data is an issue. Using Borrowed Props everywhere will result in large parts of your app rerunning every interaction. - -## Prop Options - -The `#[derive(Props)]` macro has some features that let you customize the behavior of props. - -### Optional Props - -You can create optional fields by using the `Option<…>` type for a field: - -```rust, no_run -{{#include ../../../examples/component_props_options.rs:OptionalProps}} -``` - -Then, you can choose to either provide them or not: - -```rust, no_run -{{#include ../../../examples/component_props_options.rs:OptionalProps_usage}} -``` - -### Explicitly Required `Option`s - -If you want to explicitly require an `Option`, and not an optional prop, you can annotate it with `#[props(!optional)]`: - -```rust, no_run -{{#include ../../../examples/component_props_options.rs:ExplicitOption}} -``` - -Then, you have to explicitly pass either `Some("str")` or `None`: - -```rust, no_run -{{#include ../../../examples/component_props_options.rs:ExplicitOption_usage}} -``` - -### Default Props - -You can use `#[props(default = 42)]` to make a field optional and specify its default value: - -```rust, no_run -{{#include ../../../examples/component_props_options.rs:DefaultComponent}} -``` - -Then, similarly to optional props, you don't have to provide it: - -```rust, no_run -{{#include ../../../examples/component_props_options.rs:DefaultComponent_usage}} -``` - -### Automatic Conversion with `.into` - -It is common for Rust functions to accept `impl Into` rather than just `SomeType` to support a wider range of parameters. If you want similar functionality with props, you can use `#[props(into)]`. For example, you could add it on a `String` prop – and `&str` will also be automatically accepted, as it can be converted into `String`: - -```rust, no_run -{{#include ../../../examples/component_props_options.rs:IntoComponent}} -``` - -Then, you can use it so: - -```rust, no_run -{{#include ../../../examples/component_props_options.rs:IntoComponent_usage}} -``` - -## The `inline_props` macro - -So far, every Component function we've seen had a corresponding ComponentProps struct to pass in props. This was quite verbose... Wouldn't it be nice to have props as simple function arguments? Then we wouldn't need to define a Props struct, and instead of typing `cx.props.whatever`, we could just use `whatever` directly! - -`inline_props` allows you to do just that. Instead of typing the "full" version: - -```rust, no_run -#[derive(Props, PartialEq)] -struct TitleCardProps { - title: String, -} - -fn TitleCard(cx: Scope) -> Element { - cx.render(rsx!{ - h1 { "{cx.props.title}" } - }) -} -``` - -...you can define a function that accepts props as arguments. Then, just annotate it with `#[inline_props]`, and the macro will turn it into a regular Component for you: - -```rust, no_run -#[inline_props] -fn TitleCard(cx: Scope, title: String) -> Element { - cx.render(rsx!{ - h1 { "{title}" } - }) -} -``` - -> While the new Component is shorter and easier to read, this macro should not be used by library authors since you have less control over Prop documentation. diff --git a/docs/guide/src/en/describing_ui/components.md b/docs/guide/src/en/describing_ui/components.md deleted file mode 100644 index 2b72fcaf2..000000000 --- a/docs/guide/src/en/describing_ui/components.md +++ /dev/null @@ -1,27 +0,0 @@ -# Components - -Just like you wouldn't want to write a complex program in a single, long, `main` function, you shouldn't build a complex UI in a single `App` function. Instead, you should break down the functionality of an app in logical parts called components. - -A component is a Rust function, named in UpperCammelCase, that takes a `Scope` parameter and returns an `Element` describing the UI it wants to render. In fact, our `App` function is a component! - -```rust, no_run -{{#include ../../../examples/hello_world_desktop.rs:component}} -``` - -> You'll probably want to add `#![allow(non_snake_case)]` to the top of your crate to avoid warnings about UpperCammelCase component names - -A Component is responsible for some rendering task – typically, rendering an isolated part of the user interface. For example, you could have an `About` component that renders a short description of Dioxus Labs: - -```rust, no_run -{{#include ../../../examples/components.rs:About}} -``` - -Then, you can render your component in another component, similarly to how elements are rendered: - -```rust, no_run -{{#include ../../../examples/components.rs:App}} -``` - -![Screenshot containing the About component twice](./images/screenshot_about_component.png) - -> At this point, it might seem like components are nothing more than functions. However, as you learn more about the features of Dioxus, you'll see that they are actually more powerful! diff --git a/docs/guide/src/en/describing_ui/images/component_borrowed_props_screenshot.png b/docs/guide/src/en/describing_ui/images/component_borrowed_props_screenshot.png deleted file mode 100644 index 6f1864662f34cf7bc4101f2778f0ccb03d1d1646..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 7868 zcmc(EWl$Wzv*#iUi@PosAUFx`?h-6$NN^1h7Fk@gKyXQbV2it3a0?J1KycSZL(s)t zj{nEISMTb+yt=8Lp6UM3Q!`WjtCmP@O=Uc6YHR=ifTyaW@D>0-(R|*gf-s(Wv^)U$ zyr8?wsp^5Ahd;~o{{-3w z4&Vm!_ETEL{1>Jc>XI_N3qVIZ2IgSou+>uY_8aZiq4J>o#&98%>0BmA0K-v((^pql zGr@xPJiY40<$2m1in7g1_ck%Lb&3i##$0cm10RzURaK|l+}s+`Ly!}Io%&I&YBWyfrglkB%_vKSF>RMV)Xfof$ zhohaVly?pfS47zuazb9PhF9}YSrMQ!!d|dqCWpYp{QUfylqar7Xj_)_s%Q2ll)Z>` zJn%L8=R=eT(Lpem^|kfhL!D`a&-)`&*IN$KC=QzRm|9FCBH3K+P{6T!aeG^L>33#T zkEB!N< zd&LjD(MMYSKbTlIm+>|GDck7v4AlN@LgbQ)sZi9G*uPSd6ZxI$86}qXdqlV4Ioybd zP+5^FL8M7AFv)+)y99brmL!c2&xKNE%lRkgcDHghwQ|{Pu35+EgYrXS{;fN@l~;tz zQ0fdu5GIF)%{9Ck8T;sV4{o_cw(I;&FK< zym0vuoAJIV5N9eIY`)w%Sya)u>8`DOp)gxPfx>~U-XQaD->xU`{F`H)yNlGh#2T0e z-7FR~m=wM&M`WB$C^1>aLHBWiO0tc+_ZODgx;LF{YYkm?;6Y^EXS-Sp%<#XxL;51C z?0U#A0EWpar#lu^wrh7uf2DRzHhmuF2Yf)z?lo7ta(gt~hTl2tuZE7PEtlrp_j%so z?m_1o#*Yg;F-BRa_VVKggF30##&)5CV3=??&CeWQBoAjs&ecB(!hCfg?fmDP0q$VR z2=WJI3vVQw0PdwspaY|4<%gKQea)XT9Mg2o0JBbF{Oue1@!DximYDaqB-ayp{Q=pG1X4PsL*AaoC2CyUxRc?|C zsgWreS@_LYMyOX!i}B`$rarq|ANq1#lgfYvm9*-P1*frEZggYtm`*64O@KnnlR8}( zxcaw#Yh%s&RjSMBZ&gx428__W^ps87Cd+L~+#?ebj@Bqd(UszxIcLgiR|(t##aw(v4i>+P2O$whH#m2~80FT47S(iF6eH^Uiu^%=uoT$y_oxgyC zHm-)|V>2%w8Ist-4BCj@!6$~V#1?rM@KSq&66!W;U3c`2v?HRsocnljWX~Of`vs$% z?;7A{VGHWS=6bhGKbK$y5Jaz6G0sX=xS$XHrKteg;w)v?hB6mii1e`B5q@PDnLJ^; z^`T<%Qe4Q{C|nQ`(`{vpLI@of1%q>Fn5$MI6mS@B1!Q{5Gy{o`k}L}4ARZl+(N`a- z$-96^BBb1sN6zpmRnrYuOY=JHJVp&DTqGM4s+(yc?C7d)hiek1r=8zz=*InhU0$ zzDiv%_AzM;Lo!WYiri{=-$_JvKdmfln6->W16e&ur2%tpvJEz z=fa8c8@AQ>P&Hnb6ManY(mBW{k29SesJ)61@#w~uQ7|udO(oO?&Tg&DM+-$n`IA8| z#iMFDM|&+NnfSF(@5^#sH`NHotVIk|chQ1w!C>j^&{$UwUh79g%GKsqc}t<|`?@>F zV_IqoGWLSrQNb7Iw*K|DIDAQI-sj1WnlN3I!nc4Nh2($s0@{G2Y}l4S`5!);%|Pt_ zNlHntFu=i}Zm!|UAQA@BSjtiiNbf6RB6BhWqM%OeNLnmknq_>wkapL9DTWgolDLv1 z6Oz)^*SL=DU6Moy1X%YsbY!n*ZU^;lSYz!j8gM<`hzjf*(q`IK$!_h3Y5VNv$f0Of zKhpWRp>#i)MbJ(Wp-ckrkGpYyO=xr7Z1@NSePp~ni0&K0iJZT%6U#byM^$O|gaZDu zC3lYZqorA2$eYN_{{$C0_tur$Ff3saJJ{{3=R3%iRf5amIbvL0gK(OUJUYeWS04>z z`qa}cj141ytUcB~`(v2bOS2Ln&MRlr=<5&n?yzQ)v~WEi^y|Ghf|mZ+Pie!d#C5Aw zTRht!K+KY1PqS6S2;vR1xd#@ael$~%K$3)Ss)})#O;+3Yr@Vz?rxcL&s%l_zx0mN% ztf0ug17WzE>v6r|N&m(t5!XIYvcc#3VXS!(2v`4WaUcoQUX+VGlN03@L9yAUz!byU z+1F!M9Rk(h6%oRawWQmS&Ipa4qwjth0;pDd)TY>T-95KBkaVRr0ANo9tMA|)gUZ5u zJwiS^M$R{S^GV%s53h6dK<$ZG##SOWOKq>`93u_59c3MxLkr}U6X3e-N5E!JQ5-dT zt)DJLL6yE>2$zWU9lcYV?w90NXmmt1-+|H=JhZ61tFO>8L8nJc&8?}P<#gij$W_w6 zbSh4QGPXA>=PxXwrAEAUK@%UQ+t_=DmP;7&KP9f{aFXao3%T$+J25lT0Gu4+{7o|GxlO?u~h+t72lj!h>|S0)7_x2^LLi@>|!LxL5gP*>U)pwqTYI$y#3bC zFdD;~_Me#K4a4K}xHNdn}lru&$f# z|D&D%#{B=3I+Lf;k4`ENAj@|77Tse0dygN-UCsKZUOK&(ba3b=c1r!@%yh&}R z)?Q?v8&oX4j3z}tOiLbCSm1c;;?@v^E*s3ok)v0ddvU60?n3Dx>=YLfCpqy{h~>Q# zJu@F51fD&8M18}8gRk`oHTmJuK-tQCq;!K-gL|3ODv!VLIYVOBdyLz0T~B@G-G zz+g|kG5CU3M;`sRgPikUvI4l&m)=MUiyD!(x}*fMC#hR}+}_n}<(#TSCe;Nf;om>> zdV3yr6%~>)8Xo*r^bb@xtJGhL7X{@r34^@LlC^#9*WVZ78$P8s)Tsk3h}CoB@`Fu!Md z8NA0C^H@)PK=MlnaOA_WSoxOtB|zKGE{;u!g30!O;{!u`EQyK-p;LU4@^3jX7oBK zLwQqT91fjwT|1($^jDXP*5<=W51HnKvpy@ZZhzMq8)q=;RMeZSZjiPv19;j|SK z%co*L+|P^3i61q}obFNdiN6$(?o;)#BIc%_jqz8!Yh6An%q{NZZ=TPy6%#0|O}tQ^ zDBgk3q^Nvjt~0K*ZZKB;#+-2#-9@JWU|hlag&owF=6-B-?lgtNKbI|A1-2rymWUsz z_kB@^w1jh=MQh2;X1$B}I7LA3+yTfJx8k(^750ff52Ap(x{wijN)<=6Hsv7EX?70L zbDxy_sPQfY5;WE^;E{CSs1qJ9zl>=@WbU4%{(GK}C_m-p6Mw^yKlYjOo8D2UB`reE ztDmgHO8K9MVp~O!f0GA;4d~bil8iC{} zop>1M&7`!=Zk}_S{@CjHZGa_;j+t}EW;Ej^`;&^bFI_GGpW4~i{BXSaY|8y4N+KJ zfOC{ya%-ChKRRHK7Fz$b=S~}MrHU~qCwnH_dMX9wqZblUhgrcapC79`l(F)-TCmi_S^Xs3N$vi9<6h)QE3e<^?sCeL>orw zL3$8OSwutB8!`fE8dmeY-3{Yl7W0?>Jl)_oQ6U&KaTD`lXrx^RGYGEO;ZUmT!p8Y_ zMs}b5jLul~YBE{Qx=20|EGl#dc=MPd3J0xj)x+xqUt+H3tAk{LX+5 zW~>oet_ylilWFmczk358_KtoW`0BVXI|(ID*fWQ8%lLL=xw*TuGckokMAX&QmDJQE zVB_Ghi;HJOMDX$Pu?Y*Oocl^r;bQPn$65z7^fi^P`SEnFO8Z(Si9lJ?yo%lE!YL&IJHZ?-CZze^lmhEVc-YyA8Ew>6)R zrsinnPXS6?0k5MEW$)@)h=@!&{nOsCkUUQ{4ULzKdE?{S>AY6`l{U{e-QL}?_qKZan?my~3s5-1>^!gy;+Rj93fOamrnDJ61D| z4Q>~^g92H`62Z6g$4i+VHJE^6+YBHY}O9HWyyjK1`5LPKP^gQ#7^1#uwSWaI3%D2 z{EjFf+0iy_Is&_&tyMT`jN8-f?|rXZ6f%u~KMEE#)=K-3Gu`H`R8*hX4!5@yQ zcd^Xmn@kJ}iOLpPJ7t|wXYDUyXgC0S)ptV5@aP6e9?ZJW$L1`b3jM>a7PIn<@j@5j zHt1~f<@p>H+w=FIcjFEYoZe(h(dy{v%y$NeL&a7qy9+Q)(tyR3 zBIsZZXgSm3!Z4f%Z`~QsQ1y3n);jbk$LTE#-+5ucm!ur6Iq_LTT!k49hZOaX@^Wj) zn(z<)25B{GPLuD7y9+>7QEP3jFG_HmVv9sg<1@a1iVf{hC7uLvhD{yO3B1aWSein9 zaboBqkdcITDd&pW=zKd2hvz6xCM|@JflFD1L+a;L=LNoPi)pw~3q}vLPg+;O<$?z! ztn}MvX5w9CM22oC$fVsS=p*Ig=;%%VXEO))Dz zXp99?cs|B4hY!C8Fi^%nMbWZ*-QBZd85BnopSmOc^^Fuh8;2NLjeMMAzXm-$VB@M1n}%s!KT#%UzwB%X=q|>N7B3J<|sIl z_j1$5-dSkjNgY~^&vsU;sSUJhr7#X=-g)9o)gbq&uK7A~zf9}sAymRU1vy^@N`nz_ zcc**f(f;*bvQm5kd~)cg6NR=qao*HwR`ZdifQi;#g?rDHL65|>XnaVFGUm!kb^de{ zo{iN`(u>r9d7+=^pZL%BOy?R^-}qebuXLwA7MG_zLsprdC;T0QNjC(%@zt(=)p7oO z7Pq2H<0(J32U<{scwE!Jot9gALBd-T`LHW1XJFfy$oU?NVy-K8f=SuZ`o!>n=3pEx zkFBS-7wz-s&n0GEQpP{*Q4$A3LqpLEii-ZD&tqHVNJ&qRVp5L#Y0i`LuHLr9u$m4P z4Gog)M=7TpcZW3fP}SNu#dU=XaC>WyWFaSC2iYY)RERmQl8LoA0!OHp!i^25zA@PE zE(pdYMyuPQ`eQs?``1jVuBNwk?5;F~v%TbxKjqW?cdUh+obnLRWc3MeZ?4i~`H7RR zbgp+mNzHGI8|!mHMlE$rwRdXt>9juk&fYLvjTdJZLUHwgpkGqT+wa0HUR1kNJ<2-2 z7FYglKd(VTEk3%fC&?ETI3tc2{~H3)VPYL9&A~1DH$P@SQ)ITALNAr?sx|EvFxHXi z1E1Uun_gfIrP~*dle+ihr0qzOkBhfw%SqC(Dh-c0UNAbPCX&T6A1XUQ{|rmp=5% zayhWoc=9_;RY^8P+pDg}>%FAEBV-$1V`g-8qq%^d zAvYltnmbK%%fd_jzCOTNCZ2NUnNlX9ZyteiQ#jIFYTAquvMn!dd z)8P)Ih&UNS7^dRzv^QOIV@0}9h2~*@B_ddQq^@RXQQ@SJNFeG*Jh~#ewP_o%D81FY z&?`;H>^;u<6D^oh3@{w%OK(!fMtcia;gIQX$&WyEkhERV_MGsS^2{U9KlJ}f4>`Hm z8;rnB=vwFtZcMEc!+&kiMc|pX7KVW)H8A=Kxn_p)a!PWX-c)m0#Kk#+C-NePU22J?@cQ}nmpo6ZYRr{zP2FrsV0DQG@p>#Do@ z*c5d9@j)zbp$moIPdGR}=Djd_7=eTGh5U}M&5eK?3d-SXe`5zHPp4I?A4xwDPfk2$ zfWWWG()LHtjix!VKnXQ3s9u<^Z~ZAw!5#UnLPHe-=GPpd|8kO1wS9jD&1;jsF{^N^397q51ESp5{*lP1GfIDxM;N-d;6Xg_y|DRPN8!5y zGPM%x)j(!8)QP?A>ROKz{*qG{yLV}2Ir)2y5@iGCdyAtHk}Y_S29Te#()erhyJspL zS+V}nfQDI|Rg~@$)3#T8f)1Yt@)vUh!r4L%Cz8|&clWM(;Rrv=5BFmCHG35IomU{u zM*Z-<%VrBD(rZm*UOkkykZob8z!26v()6VebzQG4v= zyPnP3Un$_`(Vw_C&(ty}PdBoQ@PXxv4ip+S9HNeq_jKg(RY;LR)fLjsls~_|M_|qC zJ8hXvLV62wvl(uigb7Xkr8)^iU(p{b$<4h!8KjUlAMPY+POyM2N~6z!m2&Rf<#`=c zD5fWkU7SMv5GEkHIJ{C?*MDQuHCNU0Dk8q9#fiEuq8HSB?lC;%#<}C(-PLdPr%Nc} z2J+h0N*~Aa)B_Mvfk3_W<_z#xg&)Owjy;rC+iwU%8v&QAr8LdFr>3^yy^nWRH x{eL*Junh>5wSS*ZX7OKJxBpu^H#z4Ct(PvC!cd{|KV4~ns-mVsm7F>3e*r{Y3vd7c diff --git a/docs/guide/src/en/describing_ui/images/component_owned_props_screenshot.png b/docs/guide/src/en/describing_ui/images/component_owned_props_screenshot.png deleted file mode 100644 index 2a1146cd1d49b2b54bcb1d103f69a294d3921ec9..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 6318 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 diff --git a/docs/guide/src/en/describing_ui/images/screenshot_about_component.png b/docs/guide/src/en/describing_ui/images/screenshot_about_component.png deleted file mode 100644 index 36f7250a1bbb007bf4f3cea787319d9df08f7b8d..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 19470 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 diff --git a/docs/guide/src/en/describing_ui/index.md b/docs/guide/src/en/describing_ui/index.md deleted file mode 100644 index 8e5b3fe8f..000000000 --- a/docs/guide/src/en/describing_ui/index.md +++ /dev/null @@ -1,142 +0,0 @@ -# Describing the UI - -Dioxus is a _declarative_ framework. This means that instead of telling Dioxus what to do (e.g. to "create an element" or "set the color to red") we simply _declare_ what we want the UI to look like using RSX. - -You have already seen a simple example of RSX syntax in the "hello world" application: - -```rust, no_run -{{#include ../../../examples/hello_world_desktop.rs:component}} -``` - -Here, we use the `rsx!` macro to _declare_ that we want a `div` element, containing the text `"Hello, world!"`. Dioxus takes the RSX and constructs a UI from it. - -## RSX Features - -RSX is very similar to HTML in that it describes elements with attributes and children. Here's an empty `div` element in RSX, as well as the resulting HTML: - -```rust, no_run -{{#include ../../../examples/rsx_overview.rs:empty}} -``` - -```html -
-``` - -### Attributes - -Attributes (and [listeners](../interactivity/index.md)) modify the behavior or appearance of the element they are attached to. They are specified inside the `{}` brackets, using the `name: value` syntax. You can provide the value as a literal in the RSX: - -```rust, no_run -{{#include ../../../examples/rsx_overview.rs:attributes}} -``` - -```html - -``` - -> Note: All attributes defined in `dioxus-html` follow the snake_case naming convention. They transform their `snake_case` names to HTML's `camelCase` attributes. - -> Note: Styles can be used directly outside of the `style:` attribute. In the above example, `color: "red"` is turned into `style="color: red"`. - -#### Custom Attributes - -Dioxus has a pre-configured set of attributes that you can use. RSX is validated at compile time to make sure you didn't specify an invalid attribute. If you want to override this behavior with a custom attribute name, specify the attribute in quotes: - -```rust, no_run -{{#include ../../../examples/rsx_overview.rs:custom_attributes}} -``` - -```html - -``` - -### Interpolation - -Similarly to how you can [format](https://doc.rust-lang.org/rust-by-example/hello/print/fmt.html) Rust strings, you can also interpolate in RSX text. Use `{variable}` to Display the value of a variable in a string, or `{variable:?}` to use the Debug representation: - -```rust, no_run -{{#include ../../../examples/rsx_overview.rs:formatting}} -``` - -```html -
-
ES
-
42
-
{}
-
-``` - -### Children - -To add children to an element, put them inside the `{}` brackets after all attributes and listeners in the element. They can be other elements, text, or [components](components.md). For example, you could have an `ol` (ordered list) element, containing 3 `li` (list item) elements, each of which contains some text: - -```rust, no_run -{{#include ../../../examples/rsx_overview.rs:children}} -``` - -```html -
    -
  1. First Item
    2. -
  2. Second Item
    3. -
  3. Third Item
    4. -
-``` - -### Fragments - -You can render multiple elements at the top level of `rsx!` and they will be automatically grouped. - -```rust, no_run -{{#include ../../../examples/rsx_overview.rs:manyroots}} -``` - -```html -

First Item

-

Second Item

-``` - -### Expressions - -You can include arbitrary Rust expressions as children within RSX that implements [IntoDynNode](https://docs.rs/dioxus-core/0.3/dioxus_core/trait.IntoDynNode.html). This is useful for displaying data from an [iterator](https://doc.rust-lang.org/stable/book/ch13-02-iterators.html#processing-a-series-of-items-with-iterators): - -```rust, no_run -{{#include ../../../examples/rsx_overview.rs:expression}} -``` - -```html -DIOXUS0123456789 -``` - -### Loops - -In addition to iterators you can also use for loops directly within RSX: - -```rust, no_run -{{#include ../../../examples/rsx_overview.rs:loops}} -``` - -```html -
0
-
1
-
2
-
0
-
1
-
2
-``` - -### If statements - -You can also use if statements without an else branch within RSX: - -```rust, no_run -{{#include ../../../examples/rsx_overview.rs:ifstatements}} -``` - -```html -
true
-``` diff --git a/docs/guide/src/en/describing_ui/special_attributes.md b/docs/guide/src/en/describing_ui/special_attributes.md deleted file mode 100644 index 4ba7a40f1..000000000 --- a/docs/guide/src/en/describing_ui/special_attributes.md +++ /dev/null @@ -1,62 +0,0 @@ -# Special Attributes - -While most attributes are simply passed on to the HTML, some have special behaviors. - -## The HTML Escape Hatch - -If you're working with pre-rendered assets, output from templates, or output from a JS library, then you might want to pass HTML directly instead of going through Dioxus. In these instances, reach for `dangerous_inner_html`. - -For example, shipping a markdown-to-Dioxus converter might significantly bloat your final application size. Instead, you'll want to pre-render your markdown to HTML and then include the HTML directly in your output. We use this approach for the [Dioxus homepage](https://dioxuslabs.com): - -```rust, no_run -{{#include ../../../examples/dangerous_inner_html.rs:dangerous_inner_html}} -``` - -> Note! This attribute is called "dangerous_inner_html" because it is **dangerous** to pass it data you don't trust. If you're not careful, you can easily expose [cross-site scripting (XSS)](https://en.wikipedia.org/wiki/Cross-site_scripting) attacks to your users. -> -> If you're handling untrusted input, make sure to sanitize your HTML before passing it into `dangerous_inner_html` – or just pass it to a Text Element to escape any HTML tags. - -## Boolean Attributes - -Most attributes, when rendered, will be rendered exactly as the input you provided. However, some attributes are considered "boolean" attributes and just their presence determines whether they affect the output. For these attributes, a provided value of `"false"` will cause them to be removed from the target element. - -So this RSX wouldn't actually render the `hidden` attribute: - -```rust, no_run -{{#include ../../../examples/boolean_attribute.rs:boolean_attribute}} -``` - -```html -
hello
-``` - -Not all attributes work like this however. _Only the following attributes_ have this behavior: - -- `allowfullscreen` -- `allowpaymentrequest` -- `async` -- `autofocus` -- `autoplay` -- `checked` -- `controls` -- `default` -- `defer` -- `disabled` -- `formnovalidate` -- `hidden` -- `ismap` -- `itemscope` -- `loop` -- `multiple` -- `muted` -- `nomodule` -- `novalidate` -- `open` -- `playsinline` -- `readonly` -- `required` -- `reversed` -- `selected` -- `truespeed` - -For any other attributes, a value of `"false"` will be sent directly to the DOM. diff --git a/docs/guide/src/en/fullstack/getting_started.md b/docs/guide/src/en/fullstack/getting_started.md deleted file mode 100644 index 401af1d43..000000000 --- a/docs/guide/src/en/fullstack/getting_started.md +++ /dev/null @@ -1,102 +0,0 @@ -> This guide assumes you read the [Web](web.md) guide and installed the [Dioxus-cli](https://github.com/DioxusLabs/cli) - -# Getting Started - -## Setup - -For this guide, we're going to show how to use Dioxus with [Axum](https://docs.rs/axum/latest/axum/), but `dioxus-fullstack` also integrates with the [Warp](https://docs.rs/warp/latest/warp/) and [Salvo](https://docs.rs/salvo/latest/salvo/) web frameworks. - -Make sure you have Rust and Cargo installed, and then create a new project: - -```shell -cargo new --bin demo -cd demo -``` - -Add `dioxus` and `dioxus-fullstack` as dependencies: - -```shell -cargo add dioxus -cargo add dioxus-fullstack --features axum, ssr -``` - -Next, add all the Axum dependencies. This will be different if you're using a different Web Framework - -```shell -cargo add tokio --features full -cargo add axum -``` - -Your dependencies should look roughly like this: - -```toml -[dependencies] -axum = "*" -dioxus = { version = "*" } -dioxus-fullstack = { version = "*", features = ["axum", "ssr"] } -tokio = { version = "*", features = ["full"] } -``` - -Now, set up your Axum app to serve the Dioxus app. - -```rust, no_run -{{#include ../../../examples/server_basic.rs}} -``` - -Now, run your app with `cargo run` and open `http://localhost:8080` in your browser. You should see a server-side rendered page with a counter. - -## Hydration - -Right now, the page is static. We can't interact with the buttons. To fix this, we can hydrate the page with `dioxus-web`. - -First, modify your `Cargo.toml` to include two features, one for the server called `ssr`, and one for the client called `web`. - -```toml -[dependencies] -# Common dependancies -dioxus = { version = "*" } -dioxus-fullstack = { version = "*" } - -# Web dependancies -dioxus-web = { version = "*", features=["hydrate"], optional = true } - -# Server dependancies -axum = { version = "0.6.12", optional = true } -tokio = { version = "1.27.0", features = ["full"], optional = true } - -[features] -default = [] -ssr = ["axum", "tokio", "dioxus-fullstack/axum"] -web = ["dioxus-web"] -``` - -Next, we need to modify our `main.rs` to use either hydrate on the client or render on the server depending on the active features. - -```rust, no_run -{{#include ../../../examples/hydration.rs}} -``` - -Now, build your client-side bundle with `dx build --features web` and run your server with `cargo run --features ssr`. You should see the same page as before, but now you can interact with the buttons! - -## Sycronizing props between the server and client - -Let's make the initial count of the counter dynamic based on the current page. - -### Modifying the server - -To do this, we must remove the serve_dioxus_application and replace it with a custom implementation of its four key functions: - -- Serve static WASM and JS files with serve_static_assets -- Register server functions with register_server_fns (more information on server functions later) -- Connect to the hot reload server with connect_hot_reload -- A custom route that uses SSRState to server-side render the application - -### Modifying the client - -The only thing we need to change on the client is the props. `dioxus-fullstack` will automatically serialize the props it uses to server render the app and send them to the client. In the client section of `main.rs`, we need to add `get_root_props_from_document` to deserialize the props before we hydrate the app. - -```rust, no_run -{{#include ../../../examples/hydration_props.rs}} -``` - -Now, build your client-side bundle with `dx build --features web` and run your server with `cargo run --features ssr`. Navigate to `http://localhost:8080/1` and you should see the counter start at 1. Navigate to `http://localhost:8080/2` and you should see the counter start at 2. diff --git a/docs/guide/src/en/fullstack/index.md b/docs/guide/src/en/fullstack/index.md deleted file mode 100644 index a9b39c8f1..000000000 --- a/docs/guide/src/en/fullstack/index.md +++ /dev/null @@ -1,59 +0,0 @@ -# Fullstack development - -So far you have learned about three different approaches to target the web with Dioxus: - -- [Client-side rendering with dioxus-web](../getting_started/web.md) -- [Server-side rendering with dioxus-liveview](../getting_started/liveview.md) -- [Server-side static HTML generation with dioxus-ssr](../getting_started/ssr.md) - -## Summary of Existing Approaches - -Each approach has its tradeoffs: - -### Client-side rendering - -- With Client side rendering, you send the entire content of your application to the client, and then the client generates all of the HTML of the page dynamically. - -- This means that the page will be blank until the JavaScript bundle has loaded and the application has initialized. This can result in **slower first render times and makes the page less SEO-friendly**. - -> SEO stands for Search Engine Optimization. It refers to the practice of making your website more likely to appear in search engine results. Search engines like Google and Bing use web crawlers to index the content of websites. Most of these crawlers are not able to run JavaScript, so they will not be able to index the content of your page if it is rendered client-side. - -- Client-side rendered applications need to use **weakly typed requests to communicate with the server** - -> Client-side rendering is a good starting point for most applications. It is well supported and makes it easy to communicate with the client/browser APIs - -### Liveview - -- Liveview rendering communicates with the server over a WebSocket connection. It essentially moves all of the work that Client-side rendering does to the server. - -- This makes it **easy to communicate with the server, but more difficult to communicate with the client/browser APIS**. - -- Each interaction also requires a message to be sent to the server and back which can cause **issues with latency**. - -- Because Liveview uses a websocket to render, the page will be blank until the WebSocket connection has been established and the first renderer has been sent form the websocket. Just like with client side rendering, this can make the page **less SEO-friendly**. - -- Because the page is rendered on the server and the page is sent to the client piece by piece, you never need to send the entire application to the client. The initial load time can be faster than client-side rendering with large applications because Liveview only needs to send a constant small websocket script regardless of the size of the application. - -> Liveview is a good fit for applications that already need to communicate with the server frequently (like real time collaborative apps), but don't need to communicate with as many client/browser APIs - -### Server-side rendering - -- Server-side rendering generates all of the HTML of the page on the server before the page is sent to the client. This means that the page will be fully rendered when it is sent to the client. This results in a faster first render time and makes the page more SEO-friendly. However, it **only works for static pages**. - -> Server-side rendering is not a good fit for purely static sites like a blog - -## A New Approach - -Each of these approaches has its tradeoffs. What if we could combine the best parts of each approach? - -- **Fast initial render** time like SSR -- **Works well with SEO** like SSR -- **Type safe easy communication with the server** like Liveview -- **Access to the client/browser APIs** like Client-side rendering -- **Fast interactivity** like Client-side rendering - -We can achieve this by rendering the initial page on the server (SSR) and then taking over rendering on the client (Client-side rendering). Taking over rendering on the client is called **hydration**. - -Finally, we can use [server functions](server_functions.md) to communicate with the server in a type-safe way. - -This approach uses both the dioxus-web and dioxus-ssr crates. To integrate those two packages and `axum`, `warp`, or `salvo`, Dioxus provides the `dioxus-fullstack` crate. diff --git a/docs/guide/src/en/fullstack/server_functions.md b/docs/guide/src/en/fullstack/server_functions.md deleted file mode 100644 index 581aa382a..000000000 --- a/docs/guide/src/en/fullstack/server_functions.md +++ /dev/null @@ -1,31 +0,0 @@ -# Communicating with the server - -`dixous-server` provides server functions that allow you to call an automatically generated API on the server from the client as if it were a local function. - -To make a server function, simply add the `#[server(YourUniqueType)]` attribute to a function. The function must: - -- Be an async function -- Have arguments and a return type that both implement serialize and deserialize (with [serde](https://serde.rs/)). -- Return a `Result` with an error type of ServerFnError - -You must call `register` on the type you passed into the server macro in your main function before starting your server to tell Dioxus about the server function. - -Let's continue building on the app we made in the [getting started](./getting_started.md) guide. We will add a server function to our app that allows us to double the count on the server. - -First, add serde as a dependency: - -```shell -cargo add serde -``` - -Next, add the server function to your `main.rs`: - -```rust, no_run -{{#include ../../../examples/server_function.rs}} -``` - -Now, build your client-side bundle with `dx build --features web` and run your server with `cargo run --features ssr`. You should see a new button that multiplies the count by 2. - -## Conclusion - -That's it! You've created a full-stack Dioxus app. You can find more examples of full-stack apps and information about how to integrate with other frameworks and desktop renderers in the [dioxus-fullstack examples directory](https://github.com/DioxusLabs/dioxus/tree/master/packages/server/examples). diff --git a/docs/guide/src/en/getting_started/desktop.md b/docs/guide/src/en/getting_started/desktop.md deleted file mode 100644 index 42fe5c1a2..000000000 --- a/docs/guide/src/en/getting_started/desktop.md +++ /dev/null @@ -1,77 +0,0 @@ -# Desktop Overview - -Build a standalone native desktop app that looks and feels the same across operating systems. - -Apps built with Dioxus are typically <5mb in size and use existing system resources, so they won't hog extreme amounts of RAM or memory. - -Examples: - -- [File Explorer](https://github.com/DioxusLabs/example-projects/blob/master/file-explorer) -- [WiFi Scanner](https://github.com/DioxusLabs/example-projects/blob/master/wifi-scanner) - -[![File ExplorerExample](https://raw.githubusercontent.com/DioxusLabs/example-projects/master/file-explorer/image.png)](https://github.com/DioxusLabs/example-projects/tree/master/file-explorer) - -## Support - -The desktop is a powerful target for Dioxus but is currently limited in capability when compared to the Web platform. Currently, desktop apps are rendered with the platform's WebView library, but your Rust code is running natively on a native thread. This means that browser APIs are _not_ available, so rendering WebGL, Canvas, etc is not as easy as the Web. However, native system APIs _are_ accessible, so streaming, WebSockets, filesystem, etc are all viable APIs. In the future, we plan to move to a custom web renderer-based DOM renderer with WGPU integrations. - -Dioxus Desktop is built off [Tauri](https://tauri.app/). Right now there aren't any Dioxus abstractions over the menubar, handling, etc, so you'll want to leverage Tauri – mostly [Wry](http://github.com/tauri-apps/wry/) and [Tao](http://github.com/tauri-apps/tao)) directly. - -# Getting started - -## Platform-Specific Dependencies - -Dioxus desktop renders through a web view. Depending on your platform, you might need to install some dependancies. - -### Windows - -Windows Desktop apps depend on WebView2 – a library that should be installed in all modern Windows distributions. If you have Edge installed, then Dioxus will work fine. If you _don't_ have Webview2, [then you can install it through Microsoft](https://developer.microsoft.com/en-us/microsoft-edge/webview2/). MS provides 3 options: - -1. A tiny "evergreen" _bootstrapper_ that fetches an installer from Microsoft's CDN -2. A tiny _installer_ that fetches Webview2 from Microsoft's CDN -3. A statically linked version of Webview2 in your final binary for offline users - -For development purposes, use Option 1. - -### Linux - -Webview Linux apps require WebkitGtk. When distributing, this can be part of your dependency tree in your `.rpm` or `.deb`. However, likely, your users will already have WebkitGtk. - -```bash -sudo apt install libwebkit2gtk-4.1-dev libgtk-3-dev libayatana-appindicator3-dev -``` - -When using Debian/bullseye `libappindicator3-dev` is no longer available but replaced by `libayatana-appindicator3-dev`. - -```bash -# on Debian/bullseye use: -sudo apt install libwebkit2gtk-4.1-dev libgtk-3-dev libayatana-appindicator3-dev -``` - -If you run into issues, make sure you have all the basics installed, as outlined in the [Tauri docs](https://tauri.studio/v1/guides/getting-started/prerequisites#setting-up-linux). - -### MacOS - -Currently – everything for macOS is built right in! However, you might run into an issue if you're using nightly Rust due to some permissions issues in our Tao dependency (which have been resolved but not published). - -## Creating a Project - -Create a new crate: - -```shell -cargo new --bin demo -cd demo -``` - -Add Dioxus and the desktop renderer as dependencies (this will edit your `Cargo.toml`): - -```shell -cargo add dioxus -cargo add dioxus-desktop -``` - -Edit your `main.rs`: - -```rust, no_run -{{#include ../../../examples/hello_world_desktop.rs:all}} -``` diff --git a/docs/guide/src/en/getting_started/fullstack.md b/docs/guide/src/en/getting_started/fullstack.md deleted file mode 100644 index fa3ba67c2..000000000 --- a/docs/guide/src/en/getting_started/fullstack.md +++ /dev/null @@ -1 +0,0 @@ -# Fullstack diff --git a/docs/guide/src/en/getting_started/hot_reload.md b/docs/guide/src/en/getting_started/hot_reload.md deleted file mode 100644 index d207f361a..000000000 --- a/docs/guide/src/en/getting_started/hot_reload.md +++ /dev/null @@ -1,60 +0,0 @@ -# Setting Up Hot Reload - -1. Hot reloading allows much faster iteration times inside of rsx calls by interpreting them and streaming the edits. -2. It is useful when changing the styling/layout of a program, but will not help with changing the logic of a program. -3. Currently the cli only implements hot reloading for the web renderer. For TUI, desktop, and LiveView you can use the hot reload macro instead. - -# Web - -For the web renderer, you can use the dioxus cli to serve your application with hot reloading enabled. - -## Setup - -Install [dioxus-cli](https://github.com/DioxusLabs/cli). -Hot reloading is automatically enabled when using the web renderer on debug builds. - -## Usage - -1. Run: - -```bash -dx serve --hot-reload -``` - -2. Change some code within a rsx or render macro -3. Open your localhost in a browser -4. Save and watch the style change without recompiling - -# Desktop/Liveview/TUI/Server - -For desktop, LiveView, and tui, you can place the hot reload macro at the top of your main function to enable hot reloading. -Hot reloading is automatically enabled on debug builds. - -For more information about hot reloading on native platforms and configuration options see the [dioxus-hot-reload](https://crates.io/crates/dioxus-hot-reload) crate. - -## Setup - -Add the following to your main function: - -```rust, no_run -fn main() { - hot_reload_init!(); - // launch your application -} -``` - -## Usage - -1. Run: - -```bash -cargo run -``` - -2. Change some code within a rsx or render macro -3. Save and watch the style change without recompiling - -# Limitations - -1. The interpreter can only use expressions that existed on the last full recompile. If you introduce a new variable or expression to the rsx call, it will require a full recompile to capture the expression. -2. Components, Iterators, and some attributes can contain arbitrary rust code and will trigger a full recompile when changed. diff --git a/docs/guide/src/en/getting_started/index.md b/docs/guide/src/en/getting_started/index.md deleted file mode 100644 index fbf0b2d05..000000000 --- a/docs/guide/src/en/getting_started/index.md +++ /dev/null @@ -1,34 +0,0 @@ -# Getting Started - -This section will help you set up your Dioxus project! - -## Prerequisites - -### An Editor - -Dioxus integrates very well with the [Rust-Analyzer LSP plugin](https://rust-analyzer.github.io) which will provide appropriate syntax highlighting, code navigation, folding, and more. - -### Rust - -Head over to [https://rust-lang.org](http://rust-lang.org) and install the Rust compiler. - -We strongly recommend going through the [official Rust book](https://doc.rust-lang.org/book/ch01-00-getting-started.html) _completely_. However, we hope that a Dioxus app can serve as a great first Rust project. With Dioxus, you'll learn about: - -- Error handling -- Structs, Functions, Enums -- Closures -- Macros - -We've put a lot of care into making Dioxus syntax familiar and easy to understand, so you won't need deep knowledge of async, lifetimes, or smart pointers until you start building complex Dioxus apps. - - -## Setup Guides - -Dioxus supports multiple platforms. Choose the platform you want to target below to get platform-specific setup instructions: - -- [Web](web.md): runs in the browser through WebAssembly -- [Server Side Rendering](ssr.md): renders to HTML text on the server -- [Liveview](liveview.md): runs on the server, renders in the browser using WebSockets -- [Desktop](desktop.md): runs in a web view on desktop -- [Mobile](mobile.md): runs in a web view on mobile -- [Terminal UI](tui.md): renders text-based graphics in the terminal \ No newline at end of file diff --git a/docs/guide/src/en/getting_started/liveview.md b/docs/guide/src/en/getting_started/liveview.md deleted file mode 100644 index 56847cab5..000000000 --- a/docs/guide/src/en/getting_started/liveview.md +++ /dev/null @@ -1,62 +0,0 @@ -# Liveview - -Liveview allows apps to _run_ on the server and _render_ in the browser. It uses WebSockets to communicate between the server and the browser. - -Examples: - -- [Axum Example](https://github.com/DioxusLabs/dioxus/tree/master/packages/liveview/examples/axum.rs) -- [Salvo Example](https://github.com/DioxusLabs/dioxus/tree/master/packages/liveview/examples/salvo.rs) -- [Warp Example](https://github.com/DioxusLabs/dioxus/tree/master/packages/liveview/examples/warp.rs) - -## Support - -Liveview is currently limited in capability when compared to the Web platform. Liveview apps run on the server in a native thread. This means that browser APIs are not available, so rendering WebGL, Canvas, etc is not as easy as the Web. However, native system APIs are accessible, so streaming, WebSockets, filesystem, etc are all viable APIs. - -## Setup - -For this guide, we're going to show how to use Dioxus Liveview with [Axum](https://docs.rs/axum/latest/axum/). - -Make sure you have Rust and Cargo installed, and then create a new project: - -```shell -cargo new --bin demo -cd app -``` - -Add Dioxus and the liveview renderer with the Axum feature as dependencies: - -```shell -cargo add dioxus -cargo add dioxus-liveview --features axum -``` - -Next, add all the Axum dependencies. This will be different if you're using a different Web Framework - -``` -cargo add tokio --features full -cargo add axum -``` - -Your dependencies should look roughly like this: - -```toml -[dependencies] -axum = "0.4.5" -dioxus = { version = "*" } -dioxus-liveview = { version = "*", features = ["axum"] } -tokio = { version = "1.15.0", features = ["full"] } -``` - -Now, set up your Axum app to respond on an endpoint. - -```rust, no_run -{{#include ../../../examples/hello_world_liveview.rs:glue}} -``` - -And then add our app component: - -```rust, no_run -{{#include ../../../examples/hello_world_liveview.rs:app}} -``` - -And that's it! diff --git a/docs/guide/src/en/getting_started/mobile.md b/docs/guide/src/en/getting_started/mobile.md deleted file mode 100644 index 72d597f51..000000000 --- a/docs/guide/src/en/getting_started/mobile.md +++ /dev/null @@ -1,76 +0,0 @@ -# Mobile App - -Build a mobile app with Dioxus! - -Example: [Todo App](https://github.com/DioxusLabs/example-projects/blob/master/ios_demo) - -## Support - -Mobile is currently the least-supported renderer target for Dioxus. Mobile apps are rendered with either the platform's WebView or experimentally through [WGPU](https://github.com/DioxusLabs/blitz). WebView doesn't support animations, transparency, and native widgets. - -Mobile support is currently best suited for CRUD-style apps, ideally for internal teams who need to develop quickly but don't care much about animations or native widgets. - -This guide is primarily targeted at iOS apps, however, you can follow it while using the `android` guide in `cargo-mobile`. - -## Getting Set up - -Getting set up with mobile can be quite challenging. The tooling here isn't great (yet) and might take some hacking around to get things working. macOS M1 is broadly unexplored and might not work for you. - -We're going to be using `cargo-mobile` to build for mobile. First, install it: - -```shell -cargo install --git https://github.com/BrainiumLLC/cargo-mobile -``` - -And then initialize your app for the right platform. Use the `winit` template for now. Right now, there's no "Dioxus" template in cargo-mobile. - -```shell -cargo mobile init -``` - -We're going to completely clear out the `dependencies` it generates for us, swapping out `winit` with `dioxus-mobile`. - -```toml - -[package] -name = "dioxus-ios-demo" -version = "0.1.0" -authors = [] -edition = "2018" - - -# leave the `lib` declaration -[lib] -crate-type = ["staticlib", "cdylib", "rlib"] - - -# leave the binary it generates for us -[[bin]] -name = "dioxus-ios-demo-desktop" -path = "gen/bin/desktop.rs" - -# clear all the dependencies -[dependencies] -mobile-entry-point = "0.1.0" -dioxus = { version = "*"} -dioxus-desktop = { version = "*" } -simple_logger = "*" -``` - -Edit your `lib.rs`: - -```rust, no_run -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(app); -} - -fn app(cx: Scope) -> Element { - cx.render(rsx!{ - div { - "hello world!" - } - }) -} -``` diff --git a/docs/guide/src/en/getting_started/ssr.md b/docs/guide/src/en/getting_started/ssr.md deleted file mode 100644 index 080efbb6d..000000000 --- a/docs/guide/src/en/getting_started/ssr.md +++ /dev/null @@ -1,71 +0,0 @@ -# Server-Side Rendering - -For lower-level control over the rendering process, you can use the `dioxus-ssr` crate directly. This can be useful when integrating with a web framework that `dioxus-server` does not support, or pre-rendering pages. - -## Setup - -For this guide, we're going to show how to use Dioxus SSR with [Axum](https://docs.rs/axum/latest/axum/). - -Make sure you have Rust and Cargo installed, and then create a new project: - -```shell -cargo new --bin demo -cd demo -``` - -Add Dioxus and the ssr renderer as dependencies: - -```shell -cargo add dioxus -cargo add dioxus-ssr -``` - -Next, add all the Axum dependencies. This will be different if you're using a different Web Framework - -``` -cargo add tokio --features full -cargo add axum -``` - -Your dependencies should look roughly like this: - -```toml -[dependencies] -axum = "0.4.5" -dioxus = { version = "*" } -dioxus-ssr = { version = "*" } -tokio = { version = "1.15.0", features = ["full"] } -``` - -Now, set up your Axum app to respond on an endpoint. - -```rust, no_run -{{#include ../../../examples/hello_world_ssr.rs:main}} -``` - -And then add our endpoint. We can either render `rsx!` directly: - -```rust, no_run -{{#include ../../../examples/hello_world_ssr.rs:endpoint}} -``` - -Or we can render VirtualDoms. - -```rust, no_run -{{#include ../../../examples/hello_world_ssr.rs:second_endpoint}} -``` - -And then add our app component: - -```rust -{{#include ../../../examples/hello_world_ssr.rs:component}} -``` - -And that's it! - - -## Multithreaded Support - -The Dioxus VirtualDom, sadly, is not currently `Send`. Internally, we use quite a bit of interior mutability which is not thread-safe. -When working with web frameworks that require `Send`, it is possible to render a VirtualDom immediately to a String – but you cannot hold the VirtualDom across an await point. For retained-state SSR (essentially LiveView), you'll need to spawn a VirtualDom on its own thread and communicate with it via channels or create a pool of VirtualDoms. -You might notice that you cannot hold the VirtualDom across an await point. Because Dioxus is currently not ThreadSafe, it _must_ remain on the thread it started. We are working on loosening this requirement. diff --git a/docs/guide/src/en/getting_started/tui.md b/docs/guide/src/en/getting_started/tui.md deleted file mode 100644 index 504c01212..000000000 --- a/docs/guide/src/en/getting_started/tui.md +++ /dev/null @@ -1,46 +0,0 @@ -# Terminal UI - -You can build a text-based interface that will run in the terminal using Dioxus. - -![Hello World screenshot](https://github.com/DioxusLabs/rink/raw/master/examples/example.png) - -> Note: this book was written with HTML-based platforms in mind. You might be able to follow along with TUI, but you'll have to adapt a bit. - -## Support - -TUI support is currently quite experimental. But, if you're willing to venture into the realm of the unknown, this guide will get you started. - -- It uses flexbox for the layout -- It only supports a subset of the attributes and elements -- Regular widgets will not work in the tui render, but the tui renderer has its own widget components that start with a capital letter. See the [widgets example](https://github.com/DioxusLabs/dioxus/blob/master/packages/dioxus-tui/examples/widgets.rs) -- 1px is one character line height. Your regular CSS px does not translate -- If your app panics, your terminal is wrecked. This will be fixed eventually - -## Getting Set up - -Start by making a new package and adding Dioxus and the TUI renderer as dependancies. - -```shell -cargo new --bin demo -cd demo -cargo add dioxus -cargo add dioxus-tui -``` - -Then, edit your `main.rs` with the basic template. - -```rust, no_run -{{#include ../../../examples/hello_world_tui.rs}} -``` - -To run our app: - -```shell -cargo run -``` - -Press "ctrl-c" to close the app. To switch from "ctrl-c" to just "q" to quit you can launch the app with a configuration to disable the default quit and use the root TuiContext to quit on your own. - -```rust, no_run -{{#include ../../../examples/hello_world_tui_no_ctrl_c.rs}} -``` diff --git a/docs/guide/src/en/getting_started/web.md b/docs/guide/src/en/getting_started/web.md deleted file mode 100644 index 07139cce6..000000000 --- a/docs/guide/src/en/getting_started/web.md +++ /dev/null @@ -1,63 +0,0 @@ -# Web - -Build single-page applications that run in the browser with Dioxus. To run on the Web, your app must be compiled to WebAssembly and depend on the `dioxus` and `dioxus-web` crates. - -A build of Dioxus for the web will be roughly equivalent to the size of a React build (70kb vs 65kb) but it will load significantly faster because [WebAssembly can be compiled as it is streamed](https://hacks.mozilla.org/2018/01/making-webassembly-even-faster-firefoxs-new-streaming-and-tiering-compiler/). - -Examples: - -- [TodoMVC](https://github.com/DioxusLabs/example-projects/tree/master/todomvc) -- [ECommerce](https://github.com/DioxusLabs/example-projects/tree/master/ecommerce-site) - -[![TodoMVC example](https://github.com/DioxusLabs/example-projects/raw/master/todomvc/example.png)](https://github.com/DioxusLabs/example-projects/blob/master/todomvc) - -> Note: Because of the limitations of Wasm, [not every crate will work](https://rustwasm.github.io/docs/book/reference/which-crates-work-with-wasm.html) with your web apps, so you'll need to make sure that your crates work without native system calls (timers, IO, etc). - -## Support - -The Web is the best-supported target platform for Dioxus. - -- Because your app will be compiled to WASM you have access to browser APIs through [wasm-bindgen](https://rustwasm.github.io/docs/wasm-bindgen/introduction.html). -- Dioxus provides hydration to resume apps that are rendered on the server. See the [fullstack](fullstack.md) getting started guide for more information. - -## Tooling - -To develop your Dioxus app for the web, you'll need a tool to build and serve your assets. We recommend using [dioxus-cli](https://github.com/DioxusLabs/dioxus/tree/master/packages/cli) which includes a build system, Wasm optimization, a dev server, and support hot reloading: - -```shell -cargo install dioxus-cli --locked -``` - -Make sure the `wasm32-unknown-unknown` target for rust is installed: - -```shell -rustup target add wasm32-unknown-unknown -``` - -## Creating a Project - -Create a new crate: - -```shell -cargo new --bin demo -cd demo -``` - -Add Dioxus and the web renderer as dependencies (this will edit your `Cargo.toml`): - -```bash -cargo add dioxus -cargo add dioxus-web -``` - -Edit your `main.rs`: - -```rust, no_run -{{#include ../../../examples/hello_world_web.rs}} -``` - -And to serve our app: - -```bash -dx serve -``` diff --git a/docs/guide/src/en/images/compiletimecorrect.png b/docs/guide/src/en/images/compiletimecorrect.png deleted file mode 100644 index 8fab7509fe6321c957b25b77ee2927cd3c24d787..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 196054 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

5^Y|FMQCq&bZ)=_Yrj(Dd^(qsz#QD70c-N-N_z< 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 Xr-Fvw74!rH_)@u~sff9F-S58ufbu*v diff --git a/docs/guide/src/en/images/component_tree.png b/docs/guide/src/en/images/component_tree.png deleted file mode 100644 index d9692407350138e0b7597e8705e33f58a463357a..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 3724 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 diff --git a/docs/guide/src/en/images/diffing.png b/docs/guide/src/en/images/diffing.png deleted file mode 100644 index 4c243bc759085f24ada3be039cb763e1d59fc2f5..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 23486 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 Bge?F7 diff --git a/docs/guide/src/en/images/dioxuslogo_full.png b/docs/guide/src/en/images/dioxuslogo_full.png deleted file mode 100644 index 7d08f2af8f057780eddae4b0f8b8fa753b69e7f8..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 59292 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

##0PXrvufB0wJ`%=YsvNItF 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

sW@yfIK5!0r3C!jXOp{;!Mh)wCw-TYJeHj?h7 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%0AT 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 KTJSHwum215)xFXH diff --git a/docs/guide/src/en/index.md b/docs/guide/src/en/index.md deleted file mode 100644 index bbebb0bc9..000000000 --- a/docs/guide/src/en/index.md +++ /dev/null @@ -1,52 +0,0 @@ -# Introduction - -![dioxuslogo](./images/dioxuslogo_full.png) - -Dioxus is a portable, performant, and ergonomic framework for building cross-platform user interfaces in Rust. This guide will help you get started with writing Dioxus apps for the Web, Desktop, Mobile, and more. - -```rust, no_run -fn app(cx: Scope) -> Element { - let mut count = use_state(cx, || 0); - - cx.render(rsx!( - h1 { "High-Five counter: {count}" } - button { onclick: move |_| count += 1, "Up high!" } - button { onclick: move |_| count -= 1, "Down low!" } - )) -} -``` - -Dioxus is heavily inspired by React. If you know React, getting started with Dioxus will be a breeze. - -> This guide assumes you already know some [Rust](https://www.rust-lang.org/)! If not, we recommend reading [_the book_](https://doc.rust-lang.org/book/ch01-00-getting-started.html) to learn Rust first. - -## Features - -- Desktop apps running natively (no Electron!) in less than 10 lines of code. -- Incredibly ergonomic and powerful state management. -- Comprehensive inline documentation – hover and guides for all HTML elements, listeners, and events. -- Extremely memory efficient – 0 global allocations for steady-state components. -- Multi-channel asynchronous scheduler for first-class async support. -- And more! Read the [full release post](https://dioxuslabs.com/blog/introducing-dioxus/). - -### Multiplatform - -Dioxus is a _portable_ toolkit, meaning the Core implementation can run anywhere with no platform-dependent linking. Unlike many other Rust frontend toolkits, Dioxus is not intrinsically linked to WebSys. In fact, every element and event listener can be swapped out at compile time. By default, Dioxus ships with the `html` feature enabled, but this can be disabled depending on your target renderer. - -Right now, we have several 1st-party renderers: - -- WebSys (for WASM): Great support -- Tao/Tokio (for Desktop apps): Good support -- Tao/Tokio (for Mobile apps): Poor support -- SSR (for generating static markup) -- TUI/Rink (for terminal-based apps): Experimental - -## Stability - -Dioxus has not reached a stable release yet. - -Web: Since the web is a fairly mature platform, we expect there to be very little API churn for web-based features. - -Desktop: APIs will likely be in flux as we figure out better patterns than our ElectronJS counterpart. - -SSR: We don't expect the SSR API to change drastically in the future. diff --git a/docs/guide/src/en/interactivity/custom_hooks.md b/docs/guide/src/en/interactivity/custom_hooks.md deleted file mode 100644 index d075bb632..000000000 --- a/docs/guide/src/en/interactivity/custom_hooks.md +++ /dev/null @@ -1,91 +0,0 @@ -# Custom Hooks - -Hooks are a great way to encapsulate business logic. If none of the existing hooks work for your problem, you can write your own. - -When writing your hook, you can make a function that accepts `cx: &ScopeState` as a parameter to accept a scope with any Props. - -## Composing Hooks - -To avoid repetition, you can encapsulate business logic based on existing hooks to create a new hook. - -For example, if many components need to access an `AppSettings` struct, you can create a "shortcut" hook: - -```rust, no_run -{{#include ../../../examples/hooks_composed.rs:wrap_context}} -``` - -Or if you want to wrap a hook that persists reloads with the storage API, you can build on top of the use_ref hook to work with mutable state: - -```rust, no_run -{{#include ../../../examples/hooks_composed.rs:use_storage}} -``` - -## Custom Hook Logic - -You can use [`cx.use_hook`](https://docs.rs/dioxus/latest/dioxus/prelude/struct.ScopeState.html#method.use_hook) to build your own hooks. In fact, this is what all the standard hooks are built on! - -`use_hook` accepts a single closure for initializing the hook. It will be only run the first time the component is rendered. The return value of that closure will be used as the value of the hook – Dioxus will take it, and store it for as long as the component is alive. On every render (not just the first one!), you will get a reference to this value. - -> Note: You can implement [`Drop`](https://doc.rust-lang.org/std/ops/trait.Drop.html) for your hook value – it will be dropped then the component is unmounted (no longer in the UI) - -Inside the initialization closure, you will typically make calls to other `cx` methods. For example: - -- The `use_state` hook tracks state in the hook value, and uses [`cx.schedule_update`](https://docs.rs/dioxus/latest/dioxus/prelude/struct.ScopeState.html#method.schedule_update) to make Dioxus re-render the component whenever it changes. - -Here is a simplified implementation of the `use_state` hook: - -```rust, no_run -{{#include ../../../examples/hooks_custom_logic.rs:use_state}} -``` - -- The `use_context` hook calls [`cx.consume_context`](https://docs.rs/dioxus/latest/dioxus/prelude/struct.ScopeState.html#method.consume_context) (which would be expensive to call on every render) to get some context from the scope - -Here is an implementation of the `use_context` and `use_context_provider` hooks: - -```rust, no_run -{{#include ../../../examples/hooks_custom_logic.rs:use_context}} -``` - -## Hook Anti-Patterns - -When writing a custom hook, you should avoid the following anti-patterns: - -- !Clone Hooks: To allow hooks to be used within async blocks, the hooks must be Clone. To make a hook clone, you can wrap data in Rc or Arc and avoid lifetimes in hooks. - -This version of use_state may seem more efficient, but it is not cloneable: - -```rust, no_run -{{#include ../../../examples/hooks_anti_patterns.rs:non_clone_state}} -``` - -If we try to use this hook in an async block, we will get a compile error: - -```rust, no_run -fn FutureComponent(cx: &ScopeState) -> Element { - let my_state = my_use_state(cx, || 0); - cx.spawn({ - to_owned![my_state]; - async move { - my_state.set(1); - } - }); - - todo!() -} -``` - -But with the original version, we can use it in an async block: - -```rust, no_run -fn FutureComponent(cx: &ScopeState) -> Element { - let my_state = use_state(cx, || 0); - cx.spawn({ - to_owned![my_state]; - async move { - my_state.set(1); - } - }); - - todo!() -} -``` diff --git a/docs/guide/src/en/interactivity/dynamic_rendering.md b/docs/guide/src/en/interactivity/dynamic_rendering.md deleted file mode 100644 index 8d91650c3..000000000 --- a/docs/guide/src/en/interactivity/dynamic_rendering.md +++ /dev/null @@ -1,86 +0,0 @@ -# Dynamic Rendering - -Sometimes you want to render different things depending on the state/props. With Dioxus, just describe what you want to see using Rust control flow – the framework will take care of making the necessary changes on the fly if the state or props change! - -## Conditional Rendering - -To render different elements based on a condition, you could use an `if-else` statement: - -```rust, no_run -{{#include ../../../examples/conditional_rendering.rs:if_else}} -``` - -> You could also use `match` statements, or any Rust function to conditionally render different things. - -### Improving the `if-else` Example - -You may have noticed some repeated code in the `if-else` example above. Repeating code like this is both bad for maintainability and performance. Dioxus will skip diffing static elements like the button, but when switching between multiple `rsx` calls it cannot perform this optimization. For this example either approach is fine, but for components with large parts that are reused between conditionals, it can be more of an issue. - -We can improve this example by splitting up the dynamic parts and inserting them where they are needed. - -```rust, no_run -{{#include ../../../examples/conditional_rendering.rs:if_else_improved}} -``` - -### Inspecting `Element` props - -Since `Element` is a `Option`, components accepting `Element` as a prop can inspect its contents, and render different things based on that. Example: - -```rust, no_run -{{#include ../../../examples/component_children_inspect.rs:Clickable}} -``` - -You can't mutate the `Element`, but if you need a modified version of it, you can construct a new one based on its attributes/children/etc. - -## Rendering Nothing - -To render nothing, you can return `None` from a component. This is useful if you want to conditionally hide something: - -```rust, no_run -{{#include ../../../examples/conditional_rendering.rs:conditional_none}} -``` - -This works because the `Element` type is just an alias for `Option` - -> Again, you may use a different method to conditionally return `None`. For example the boolean's [`then()`](https://doc.rust-lang.org/std/primitive.bool.html#method.then) function could be used. - -## Rendering Lists - -Often, you'll want to render a collection of components. For example, you might want to render a list of all comments on a post. - -For this, Dioxus accepts iterators that produce `Element`s. So we need to: - -- Get an iterator over all of our items (e.g., if you have a `Vec` of comments, iterate over it with `iter()`) -- `.map` the iterator to convert each item into a `LazyNode` using `rsx!(...)` - - Add a unique `key` attribute to each iterator item -- Include this iterator in the final RSX (or use it inline) - -Example: suppose you have a list of comments you want to render. Then, you can render them like this: - -```rust, no_run -{{#include ../../../examples/rendering_lists.rs:render_list}} -``` - -### Inline for loops - -Because of how common it is to render a list of items, Dioxus provides a shorthand for this. Instead of using `.iter`, `.map`, and `rsx`, you can use a `for` loop with a body of rsx code: - -```rust, no_run -{{#include ../../../examples/rendering_lists.rs:render_list_for_loop}} -``` - -### The `key` Attribute - -Every time you re-render your list, Dioxus needs to keep track of which items go where to determine what updates need to be made to the UI. - -For example, suppose the `CommentComponent` had some state – e.g. a field where the user typed in a reply. If the order of comments suddenly changes, Dioxus needs to correctly associate that state with the same comment – otherwise, the user will end up replying to a different comment! - -To help Dioxus keep track of list items, we need to associate each item with a unique key. In the example above, we dynamically generated the unique key. In real applications, it's more likely that the key will come from e.g. a database ID. It doesn't matter where you get the key from, as long as it meets the requirements: - -- Keys must be unique in a list -- The same item should always get associated with the same key -- Keys should be relatively small (i.e. converting the entire Comment structure to a String would be a pretty bad key) so they can be compared efficiently - -You might be tempted to use an item's index in the list as its key. That’s what Dioxus will use if you don’t specify a key at all. This is only acceptable if you can guarantee that the list is constant – i.e., no re-ordering, additions, or deletions. - -> Note that if you pass the key to a component you've made, it won't receive the key as a prop. It’s only used as a hint by Dioxus itself. If your component needs an ID, you have to pass it as a separate prop. diff --git a/docs/guide/src/en/interactivity/event_handlers.md b/docs/guide/src/en/interactivity/event_handlers.md deleted file mode 100644 index 4e332adf9..000000000 --- a/docs/guide/src/en/interactivity/event_handlers.md +++ /dev/null @@ -1,72 +0,0 @@ -# Event Handlers - -Event handlers are used to respond to user actions. For example, an event handler could be triggered when the user clicks, scrolls, moves the mouse, or types a character. - -Event handlers are attached to elements. For example, we usually don't care about all the clicks that happen within an app, only those on a particular button. - -Event handlers are similar to regular attributes, but their name usually starts with `on`- and they accept closures as values. The closure will be called whenever the event it listens for is triggered and will be passed that event. - -For example, to handle clicks on an element, we can specify an `onclick` handler: - -```rust, no_run -{{#include ../../../examples/event_click.rs:rsx}} -``` - -## The `Event` object - -Event handlers receive an [`Event`](https://docs.rs/dioxus-core/latest/dioxus_core/struct.Event.html) object containing information about the event. Different types of events contain different types of data. For example, mouse-related events contain [`MouseData`](https://docs.rs/dioxus/latest/dioxus/events/struct.MouseData.html), which tells you things like where the mouse was clicked and what mouse buttons were used. - -In the example above, this event data was logged to the terminal: - -``` -Clicked! Event: UiEvent { bubble_state: Cell { value: true }, data: MouseData { coordinates: Coordinates { screen: (242.0, 256.0), client: (26.0, 17.0), element: (16.0, 7.0), page: (26.0, 17.0) }, modifiers: (empty), held_buttons: EnumSet(), trigger_button: Some(Primary) } } -Clicked! Event: UiEvent { bubble_state: Cell { value: true }, data: MouseData { coordinates: Coordinates { screen: (242.0, 256.0), client: (26.0, 17.0), element: (16.0, 7.0), page: (26.0, 17.0) }, modifiers: (empty), held_buttons: EnumSet(), trigger_button: Some(Primary) } } -``` - -To learn what the different event types for HTML provide, read the [events module docs](https://docs.rs/dioxus-html/latest/dioxus_html/events/index.html). - -### Event propagation - -Some events will trigger first on the element the event originated at upward. For example, a click event on a `button` inside a `div` would first trigger the button's event listener and then the div's event listener. - -> For more information about event propagation see [the mdn docs on event bubbling](https://developer.mozilla.org/en-US/docs/Learn/JavaScript/Building_blocks/Events#event_bubbling) - -If you want to prevent this behavior, you can call `stop_propagation()` on the event: - -```rust, no_run -{{#include ../../../examples/event_nested.rs:rsx}} -``` - -## Prevent Default - -Some events have a default behavior. For keyboard events, this might be entering the typed character. For mouse events, this might be selecting some text. - -In some instances, might want to avoid this default behavior. For this, you can add the `prevent_default` attribute with the name of the handler whose default behavior you want to stop. This attribute can be used for multiple handlers using their name separated by spaces: - -```rust, no_run -{{#include ../../../examples/event_prevent_default.rs:prevent_default}} -``` - -Any event handlers will still be called. - -> Normally, in React or JavaScript, you'd call "preventDefault" on the event in the callback. Dioxus does _not_ currently support this behavior. Note: this means you cannot conditionally prevent default behavior based on the data in the event. - -> Note about forms: if an event handler is attached to the `onsubmit` event of a form, default behavior is to **not submit it**, meaning having `prevent_default: "onsubmit"` will submit it in this case. - -## Handler Props - -Sometimes, you might want to make a component that accepts an event handler. A simple example would be a `FancyButton` component, which accepts an `on_click` handler: - -```rust, no_run -{{#include ../../../examples/event_handler_prop.rs:component_with_handler}} -``` - -Then, you can use it like any other handler: - -```rust, no_run -{{#include ../../../examples/event_handler_prop.rs:usage}} -``` - -> Note: just like any other attribute, you can name the handlers anything you want! Though they must start with `on`, for the prop to be automatically turned into an `EventHandler` at the call site. -> -> You can also put custom data in the event, rather than e.g. `MouseData` diff --git a/docs/guide/src/en/interactivity/hooks.md b/docs/guide/src/en/interactivity/hooks.md deleted file mode 100644 index 8b571dacd..000000000 --- a/docs/guide/src/en/interactivity/hooks.md +++ /dev/null @@ -1,106 +0,0 @@ -# Hooks and Component State - -So far our components have had no state like a normal rust functions. However, in a UI component, it is often useful to have stateful functionality to build user interactions. For example, you might want to track whether the user has opened a drop-down, and render different things accordingly. - -Hooks allow us to create state in our components. Hooks are Rust functions that take a reference to [`ScopeState`](https://docs.rs/dioxus/latest/dioxus/prelude/struct.ScopeState.html) (in a component, you can pass `cx`), and provide you with functionality and state. - -## `use_state` Hook - -[`use_state`](https://docs.rs/dioxus/latest/dioxus/prelude/fn.use_state.html) is one of the simplest hooks. - -- You provide a closure that determines the initial value: `let mut count = use_state(cx, || 0);` -- `use_state` gives you the current value, and a way to update it by setting it to something else -- When the value updates, `use_state` makes the component re-render (along with any other component - that references it), and then provides you with the new value. - -For example, you might have seen the counter example, in which state (a number) is tracked using the `use_state` hook: - -```rust, no_run -{{#include ../../../examples/hooks_counter.rs:component}} -``` - -![Screenshot: counter app](./images/counter.png) - -Every time the component's state changes, it re-renders, and the component function is called, so you can describe what you want the new UI to look like. You don't have to worry about "changing" anything – just describe what you want in terms of the state, and Dioxus will take care of the rest! - -> `use_state` returns your value wrapped in a smart pointer of type [`UseState`](https://docs.rs/dioxus/latest/dioxus/prelude/struct.UseState.html). This is why you can both read the value and update it, even within an event handler. - -You can use multiple hooks in the same component if you want: - -```rust, no_run -{{#include ../../../examples/hooks_counter_two_state.rs:component}} -``` - -![Screenshot: app with two counters](./images/counter_two_state.png) - -## Rules of Hooks - -The above example might seem a bit magic, since Rust functions are typically not associated with state. Dioxus allows hooks to maintain state across renders through a reference to `ScopeState`, which is why you must pass `&cx` to them. - -But how can Dioxus differentiate between multiple hooks in the same component? As you saw in the second example, both `use_state` functions were called with the same parameters, so how come they can return different things when the counters are different? - -```rust, no_run -{{#include ../../../examples/hooks_counter_two_state.rs:use_state_calls}} -``` - -This is only possible because the two hooks are always called in the same order, so Dioxus knows which is which. Because the order you call hooks matters, you must follow certain rules when using hooks: - -1. Hooks may be only used in components or other hooks (we'll get to that later) -2. On every call to a component function - 1. The same hooks must be called (except in the case of early returns, as explained later in the [Error Handling chapter](../best_practices/error_handling.md)) - 2. In the same order -3. Hook names should start with `use_` so you don't accidentally confuse them with regular - functions (`use_state()`, `use_ref()`, `use_future()`, etc...) - -These rules mean that there are certain things you can't do with hooks: - -### No Hooks in Conditionals - -```rust, no_run -{{#include ../../../examples/hooks_bad.rs:conditional}} -``` - -### No Hooks in Closures - -```rust, no_run -{{#include ../../../examples/hooks_bad.rs:closure}} -``` - -### No Hooks in Loops - -```rust, no_run -{{#include ../../../examples/hooks_bad.rs:loop}} -``` - -## `use_ref` Hook - -`use_state` is great for tracking simple values. However, you may notice in the [`UseState` API](https://docs.rs/dioxus/latest/dioxus/hooks/struct.UseState.html) that the only way to modify its value is to replace it with something else (e.g., by calling `set`, or through one of the `+=`, `-=` operators). This works well when it is cheap to construct a value (such as any primitive). But what if you want to maintain more complex data in the components state? - -For example, suppose we want to maintain a `Vec` of values. If we stored it with `use_state`, the -only way to add a new value to the list would be to copy the existing `Vec`, add our value to it, -and then replace the existing `Vec` in the state with it. This is expensive! We want to modify the -existing `Vec` instead. - -Thankfully, there is another hook for that, `use_ref`! It **is** similar to `use_state`, but it lets you get a mutable reference to the contained data. - -Here's a simple example that keeps a list of events in a `use_ref`. We can acquire write access to the state with `.with_mut()`, and then just `.push` a new value to the state: - -```rust, no_run -{{#include ../../../examples/hooks_use_ref.rs:component}} -``` - -> The return values of `use_state` and `use_ref` ( -> [`UseState`](https://docs.rs/dioxus/latest/dioxus/prelude/struct.UseState.html) and -> [`UseRef`](https://docs.rs/dioxus/latest/dioxus/prelude/struct.UseRef.html), respectively) are in -> some ways similar to [`Cell`](https://doc.rust-lang.org/std/cell/) and -> [`RefCell`](https://doc.rust-lang.org/std/cell/struct.RefCell.html) – they provide interior -> mutability. However, these Dioxus wrappers also ensure that the component gets re-rendered -> whenever you change the state. - - -## Additional Resources - -- [**dioxus_hooks** ](https://docs.rs/dioxus-hooks/latest/dioxus_hooks/) rustdoc - - Documents all hook types included with dioxus by default Most of these are also covered in - later chapters of this guide. -- [Hooks Package](https://github.com/DioxusLabs/dioxus/tree/master/packages/hooks) diff --git a/docs/guide/src/en/interactivity/images/counter.png b/docs/guide/src/en/interactivity/images/counter.png deleted file mode 100644 index dd89cadef3ab7794d1f77b08350b8a2cad434b72..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 11368 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 O00kLk=_*O1;Qs=kxyf1p diff --git a/docs/guide/src/en/interactivity/images/counter_two_state.png b/docs/guide/src/en/interactivity/images/counter_two_state.png deleted file mode 100644 index 4f77942a20ab23ea01784871c7bc977a2baec4a5..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 14503 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

Xr+Mb0o6&U|y=x|mJQEkCNwLvd|7x7mswPA5 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 Element { - let bigger_number = use_memo(cx, (number,), |(number,)| { - // This will only be calculated when `number` has changed. - number * 100 - }); - render!( - p { "{bigger_number}" } - ) -} -fn app(cx: Scope) -> Element { - render!(Calculator { number: 0 }) -} -``` diff --git a/docs/guide/src/en/interactivity/router.md b/docs/guide/src/en/interactivity/router.md deleted file mode 100644 index b4f20eb78..000000000 --- a/docs/guide/src/en/interactivity/router.md +++ /dev/null @@ -1,83 +0,0 @@ -# Router - -In many of your apps, you'll want to have different "scenes". For a webpage, these scenes might be the different webpages with their own content. For a desktop app, these scenes might be different views in your app. - -To unify these platforms, Dioxus provides a first-party solution for scene management called Dioxus Router. - -## What is it? - -For an app like the Dioxus landing page (https://dioxuslabs.com), we want to have several different scenes: - -- Homepage -- Blog - -Each of these scenes is independent – we don't want to render both the homepage and blog at the same time. - -The Dioxus router makes it easy to create these scenes. To make sure we're using the router, add the `dioxus-router` package to your `Cargo.toml`. - -```shell -cargo add dioxus-router -``` - -## Using the router - -Unlike other routers in the Rust ecosystem, our router is built declaratively. This makes it possible to compose our app layout simply by arranging components. - -```rust, no_run -rsx!{ - // All of our routes will be rendered inside this Router component - Router:: { - // if the current location is "/home", render the Home component - Route { to: "/home", Home {} } - // if the current location is "/blog", render the Blog component - Route { to: "/blog", Blog {} } - } -} -``` - -Whenever we visit this app, we will get either the Home component or the Blog component rendered depending on which route we enter at. If neither of these routes match the current location, then nothing will render. - -We can fix this one of two ways: - -- A fallback 404 page - -```rust, no_run -rsx!{ - Router:: { - Route { to: "/home", Home {} } - Route { to: "/blog", Blog {} } - // if the current location doesn't match any of the above routes, render the NotFound component - Route { to: "", NotFound {} } - } -} -``` - -- Redirect 404 to home - -```rust, no_run -rsx!{ - Router:: { - Route { to: "/home", Home {} } - Route { to: "/blog", Blog {} } - // if the current location doesn't match any of the above routes, redirect to "/home" - Redirect { from: "", to: "/home" } - } -} -``` - -## Links - -For our app to navigate these routes, we can provide clickable elements called Links. These simply wrap `` elements that, when clicked, navigate the app to the given location. - -```rust, no_run -rsx!{ - Link { - to: "/home", - "Go home!" - } -} -``` - -## More reading - -This page is just a very brief overview of the router. For more information, check out [the router book](https://dioxuslabs.com/docs/0.3/router/) or some of [the router examples](https://github.com/DioxusLabs/dioxus/blob/master/examples/router.rs). diff --git a/docs/guide/src/en/interactivity/sharing_state.md b/docs/guide/src/en/interactivity/sharing_state.md deleted file mode 100644 index d71fbdec0..000000000 --- a/docs/guide/src/en/interactivity/sharing_state.md +++ /dev/null @@ -1,71 +0,0 @@ -# Sharing State - -Often, multiple components need to access the same state. Depending on your needs, there are several ways to implement this. - -## Lifting State - -One approach to share state between components is to "lift" it up to the nearest common ancestor. This means putting the `use_state` hook in a parent component, and passing the needed values down as props. - -Suppose we want to build a meme editor. We want to have an input to edit the meme caption, but also a preview of the meme with the caption. Logically, the meme and the input are 2 separate components, but they need access to the same state (the current caption). - -> Of course, in this simple example, we could write everything in one component – but it is better to split everything out in smaller components to make the code more reusable, maintainable, and performant (this is even more important for larger, complex apps). - -We start with a `Meme` component, responsible for rendering a meme with a given caption: - -```rust, no_run -{{#include ../../../examples/meme_editor.rs:meme_component}} -``` - -> Note that the `Meme` component is unaware where the caption is coming from – it could be stored in `use_state`, `use_ref`, or a constant. This ensures that it is very reusable – the same component can be used for a meme gallery without any changes! - -We also create a caption editor, completely decoupled from the meme. The caption editor must not store the caption itself – otherwise, how will we provide it to the `Meme` component? Instead, it should accept the current caption as a prop, as well as an event handler to delegate input events to: - -```rust, no_run -{{#include ../../../examples/meme_editor.rs:caption_editor}} -``` - -Finally, a third component will render the other two as children. It will be responsible for keeping the state and passing down the relevant props. - -```rust, no_run -{{#include ../../../examples/meme_editor.rs:meme_editor}} -``` - -![Meme Editor Screenshot: An old plastic skeleton sitting on a park bench. Caption: "me waiting for a language feature"](./images/meme_editor_screenshot.png) - -## Using Shared State - -Sometimes, some state needs to be shared between multiple components far down the tree, and passing it down through props is very inconvenient. - -Suppose now that we want to implement a dark mode toggle for our app. To achieve this, we will make every component select styling depending on whether dark mode is enabled or not. - -> Note: we're choosing this approach for the sake of an example. There are better ways to implement dark mode (e.g. using CSS variables). Let's pretend CSS variables don't exist – welcome to 2013! - -Now, we could write another `use_state` in the top component, and pass `is_dark_mode` down to every component through props. But think about what will happen as the app grows in complexity – almost every component that renders any CSS is going to need to know if dark mode is enabled or not – so they'll all need the same dark mode prop. And every parent component will need to pass it down to them. Imagine how messy and verbose that would get, especially if we had components several levels deep! - -Dioxus offers a better solution than this "prop drilling" – providing context. The [`use_shared_state_provider`](https://docs.rs/dioxus-hooks/latest/dioxus_hooks/fn.use_shared_state_provider.html) hook is similar to `use_ref`, but it makes it available through [`use_shared_state`](https://docs.rs/dioxus-hooks/latest/dioxus_hooks/fn.use_shared_state.html) for all children components. - -First, we have to create a struct for our dark mode configuration: - -```rust, no_run -{{#include ../../../examples/meme_editor_dark_mode.rs:DarkMode_struct}} -``` - -Now, in a top-level component (like `App`), we can provide the `DarkMode` context to all children components: - -```rust, no_run -{{#include ../../../examples/meme_editor_dark_mode.rs:context_provider}} -``` - -As a result, any child component of `App` (direct or not), can access the `DarkMode` context. - -```rust, no_run -{{#include ../../../examples/meme_editor_dark_mode.rs:use_context}} -``` - -> `use_shared_state` returns `Option>` here. If the context has been provided, the value is `Some(UseSharedState)`, which you can call `.read` or `.write` on, similarly to `UseRef`. Otherwise, the value is `None`. - -For example, here's how we would implement the dark mode toggle, which both reads the context (to determine what color it should render) and writes to it (to toggle dark mode): - -```rust, no_run -{{#include ../../../examples/meme_editor_dark_mode.rs:toggle}} -``` diff --git a/docs/guide/src/en/interactivity/user_input.md b/docs/guide/src/en/interactivity/user_input.md deleted file mode 100644 index 6470588e5..000000000 --- a/docs/guide/src/en/interactivity/user_input.md +++ /dev/null @@ -1,33 +0,0 @@ -# User Input - -Interfaces often need to provide a way to input data: e.g. text, numbers, checkboxes, etc. In Dioxus, there are two ways you can work with user input. - -## Controlled Inputs - -With controlled inputs, you are directly in charge of the state of the input. This gives you a lot of flexibility, and makes it easy to keep things in sync. For example, this is how you would create a controlled text input: - -```rust, no_run -{{#include ../../../examples/input_controlled.rs:component}} -``` - -Notice the flexibility – you can: - -- Also display the same contents in another element, and they will be in sync -- Transform the input every time it is modified (e.g. to make sure it is upper case) -- Validate the input every time it changes -- Have custom logic happening when the input changes (e.g. network request for autocompletion) -- Programmatically change the value (e.g. a "randomize" button that fills the input with nonsense) - -## Uncontrolled Inputs - -As an alternative to controlled inputs, you can simply let the platform keep track of the input values. If we don't tell a HTML input what content it should have, it will be editable anyway (this is built into the browser). This approach can be more performant, but less flexible. For example, it's harder to keep the input in sync with another element. - -Since you don't necessarily have the current value of the uncontrolled input in state, you can access it either by listening to `oninput` events (similarly to controlled components), or, if the input is part of a form, you can access the form data in the form events (e.g. `oninput` or `onsubmit`): - -```rust, no_run -{{#include ../../../examples/input_uncontrolled.rs:component}} -``` - -``` -Submitted! UiEvent { data: FormData { value: "", values: {"age": "very old", "date": "1966", "name": "Fred"} } } -``` diff --git a/docs/guide/src/en/lib.rs b/docs/guide/src/en/lib.rs deleted file mode 100644 index 97cda56a8..000000000 --- a/docs/guide/src/en/lib.rs +++ /dev/null @@ -1 +0,0 @@ -// empty (we only need this crate for the examples) diff --git a/docs/guide/src/en/publishing/desktop.md b/docs/guide/src/en/publishing/desktop.md deleted file mode 100644 index f30b0b26d..000000000 --- a/docs/guide/src/en/publishing/desktop.md +++ /dev/null @@ -1,65 +0,0 @@ -# Publishing - -Congrats! You've made your first Dioxus app that actually does some pretty cool stuff. This app uses your operating system's WebView library, so it's portable to be distributed for other platforms. - -In this section, we'll cover how to bundle your app for macOS, Windows, and Linux. - - - -## Install `cargo-bundle` - - -The first thing we'll do is install [`cargo-bundle`](https://github.com/burtonageo/cargo-bundle). This extension to cargo will make it very easy to package our app for the various platforms. - -According to the `cargo-bundle` github page, - - - -*"cargo-bundle is a tool used to generate installers or app bundles for GUI executables built with cargo. It can create .app bundles for Mac OS X and iOS, .deb packages for Linux, and .msi installers for Windows (note however that iOS and Windows support is still experimental). Support for creating .rpm packages (for Linux) and .apk packages (for Android) is still pending."* - - -To install, simply run - - -`cargo install cargo-bundle` - -## Setting up your project - - -To get a project setup for bundling, we need to add some flags to our `Cargo.toml` file. - - -```toml -[package] -name = "example" -# ...other fields... - -[package.metadata.bundle] -name = "DogSearch" -identifier = "com.dogs.dogsearch" -version = "1.0.0" -copyright = "Copyright (c) Jane Doe 2016. All rights reserved." -category = "Developer Tool" -short_description = "Easily search for Dog photos" -long_description = """ -This app makes it quick and easy to browse photos of dogs from over 200 bree -""" -``` - - -## Building - -Following cargo-bundle's instructions, we simply `cargo-bundle --release` to produce a final app with all the optimizations and assets builtin. - -Once you've ran `cargo-bundle --release`, your app should be accessible in - -`target/release/bundle//`. - -For example, a macOS app would look like this: - -![Published App](../images/publish.png) - -Nice! And it's only 4.8 Mb – extremely lean!! Because Dioxus leverages your platform's native WebView, Dioxus apps are extremely memory efficient and won't waste your battery. - -> Note: not all CSS works the same on all platforms. Make sure to view your app's CSS on each platform – or web browser (Firefox, Chrome, Safari) before publishing. - diff --git a/docs/guide/src/en/publishing/index.md b/docs/guide/src/en/publishing/index.md deleted file mode 100644 index 96670f1c8..000000000 --- a/docs/guide/src/en/publishing/index.md +++ /dev/null @@ -1 +0,0 @@ -# Publishing diff --git a/docs/guide/src/en/publishing/web.md b/docs/guide/src/en/publishing/web.md deleted file mode 100644 index 9c285a104..000000000 --- a/docs/guide/src/en/publishing/web.md +++ /dev/null @@ -1,8 +0,0 @@ -## Publishing with Github Pages -To build our app and publish it to Github: - -- Make sure GitHub Pages is set up for your repo -- Build your app with `trunk build --release` (include `--public-url ` to update asset prefixes if using a project site) -- Move your generated HTML/CSS/JS/Wasm from `dist` into the folder configured for Github Pages -- Add and commit with git -- Push to GitHub diff --git a/docs/guide/src/pt-br/SUMMARY.md b/docs/guide/src/pt-br/SUMMARY.md deleted file mode 100644 index 45cc4912f..000000000 --- a/docs/guide/src/pt-br/SUMMARY.md +++ /dev/null @@ -1,43 +0,0 @@ -# SumΓ‘rio - -[Introdução](index.md) - -- [Introdução RΓ‘pida as Plataformas](getting_started/index.md) - - [Desktop](getting_started/desktop.md) - - [Web](getting_started/web.md) - - [Hot Reload](getting_started/hot_reload.md) - - [Renderização por Servidor](getting_started/ssr.md) - - [Interface do Terminal](getting_started/tui.md) - - [MΓ³vel](getting_started/mobile.md) -- [Descrevendo a Interface do UsuΓ‘rio](describing_ui/index.md) - - [Atributos Especiais](describing_ui/special_attributes.md) - - [Componentes](describing_ui/components.md) - - [Props](describing_ui/component_props.md) - - [Componente Filho](describing_ui/component_children.md) -- [Interatividade](interactivity/index.md) - - [Manipuladores de Eventos](interactivity/event_handlers.md) - - [Hooks & Estado de Componentes](interactivity/hooks.md) - - [Entradas do UsuΓ‘rio](interactivity/user_input.md) - - [Estado Compartilhado](interactivity/sharing_state.md) - - [Hooks Personalizados](interactivity/custom_hooks.md) - - [Renderização DinΓ’mica](interactivity/dynamic_rendering.md) - - [Roteamento](interactivity/roteador.md) -- [Assincronia](async/index.md) - - [UseFuture](async/use_future.md) - - [UseCoroutine](async/use_coroutine.md) - - [Gerando Futures](async/spawn.md) -- [PrΓ‘ticas Recomendadas](best_practices/index.md) - - [Tratamento de erros](best_practices/error_handling.md) - - [AntipadrΓ΅es](best_practices/antipatterns.md) -- [Publicação](publishing/index.md) - - [Desktop](publishing/desktop.md) - - [Web](publishing/web.md) - ---- - -- [Renderizador Personalizado](custom_renderer/index.md) - ---- - -[Roteiro](roadmap.md) -[Contribuindo](contributing.md) diff --git a/docs/guide/src/pt-br/async/index.md b/docs/guide/src/pt-br/async/index.md deleted file mode 100644 index ea3cae827..000000000 --- a/docs/guide/src/pt-br/async/index.md +++ /dev/null @@ -1,9 +0,0 @@ -# Trabalhando em Assincronia - -Muitas vezes, os aplicativos precisam interagir com sistemas de arquivos, interfaces de rede, hardware ou temporizadores. Este capΓ­tulo fornece uma visΓ£o geral do uso de cΓ³digo assΓ­ncrono no Dioxus. - -## O Tempo de Execução (runtime) - -Por padrΓ£o, o Dioxus-Desktop vem com o runtime `Tokio` e configura tudo automaticamente para vocΓͺ. No momento, isso nΓ£o Γ© configurΓ‘vel, embora seja fΓ‘cil escrever uma integração para o desktop Dioxus que use um tempo de execução assΓ­ncrono diferente. - -Dioxus atualmente nΓ£o Γ© `thread-safe`, entΓ£o qualquer cΓ³digo assΓ­ncrono que vocΓͺ escreve _nΓ£o_ precisa ser `Send/Sync`. Isso significa que vocΓͺ pode usar estruturas nΓ£o `thread-safe` como `Cell`, `Rc` e `RefCell`. diff --git a/docs/guide/src/pt-br/async/spawn.md b/docs/guide/src/pt-br/async/spawn.md deleted file mode 100644 index 3c00934cf..000000000 --- a/docs/guide/src/pt-br/async/spawn.md +++ /dev/null @@ -1,29 +0,0 @@ -# Gerando Futures - -Os **"hooks"** `use_future` e `use_coroutine` sΓ£o ΓΊteis se vocΓͺ quiser gerar incondicionalmente o `Future`. Γ€s vezes, porΓ©m, vocΓͺ desejarΓ‘ apenas gerar um `Future` em resposta a um evento, como um clique do mouse. Por exemplo, suponha que vocΓͺ precise enviar uma solicitação quando o usuΓ‘rio clicar em um botΓ£o "log in". Para isso, vocΓͺ pode usar `cx.spawn`: - -```rust, no_run -{{#include ../../../examples/spawn.rs:spawn}} -``` - -> Nota: `spawn` sempre gerarΓ‘ um _novo_ `Future`. VocΓͺ provavelmente nΓ£o quer chamΓ‘-lo em cada renderização. - -O `Future` deve ser `'static` – entΓ£o quaisquer valores capturados pela tarefa nΓ£o podem carregar nenhuma referΓͺncia a `cx`, como um `UseState`. - -No entanto, como vocΓͺ normalmente precisa de uma maneira de atualizar o valor de um gancho, vocΓͺ pode usar `to_owned` para criar um clone do _handle_ do _hook_. VocΓͺ pode entΓ£o usar esse clone no encerramento assΓ­ncrono. - -Para tornar isso um pouco menos detalhado, o Dioxus exporta a macro `to_owned!` que criarΓ‘ uma ligação como mostrado acima, o que pode ser bastante ΓΊtil ao lidar com muitos valores. - -```rust, no_run -{{#include ../../../examples/spawn.rs:to_owned_macro}} -``` - -Calling `spawn` will give you a `JoinHandle` which lets you cancel or pause the future. - -## Gerando Tarefas do Tokio - -Γ€s vezes, vocΓͺ pode querer gerar uma tarefa em segundo plano que precise de vΓ‘rios _threads_ ou conversar com o hardware que pode bloquear o cΓ³digo do seu aplicativo. Nesses casos, podemos gerar diretamente uma tarefa Tokio do nosso `Future`. Para Dioxus-Desktop, sua tarefa serΓ‘ gerada no tempo de execução Multi-Tarefado do Tokio: - -```rust, no_run -{{#include ../../../examples/spawn.rs:tokio}} -``` diff --git a/docs/guide/src/pt-br/async/use_coroutine.md b/docs/guide/src/pt-br/async/use_coroutine.md deleted file mode 100644 index cb9eda3a0..000000000 --- a/docs/guide/src/pt-br/async/use_coroutine.md +++ /dev/null @@ -1,181 +0,0 @@ -# Corrotinas - -Outra boa ferramenta para manter em sua caixa de ferramentas assΓ­ncrona sΓ£o as corrotinas. Corrotinas sΓ£o `Futures` que podem ser interrompidos, iniciados, pausados e retomados manualmente. - -Assim como os `Futures` regulares, o cΓ³digo em uma corrotina Dioxus serΓ‘ executado atΓ© o prΓ³ximo ponto `await` antes do _render_. Esse controle de baixo nΓ­vel sobre tarefas assΓ­ncronas Γ© bastante poderoso, permitindo tarefas em _loop_ infinito, como pesquisa de WebSocket, temporizadores em segundo plano e outras açáes periΓ³dicas. - -## `use_coroutine` - -A configuração bΓ‘sica para corrotinas Γ© o _hook_ `use_coroutine`. A maioria das corrotinas que escrevemos serΓ£o _loops_ de pesquisa usando `async`/`await`. - -```rust, no_run -fn app(cx: Scope) -> Element { - let ws: &UseCoroutine<()> = use_coroutine(cx, |rx| async move { - // Connect to some sort of service - let mut conn = connect_to_ws_server().await; - - // Wait for data on the service - while let Some(msg) = conn.next().await { - // handle messages - } - }); -} -``` - -Para muitos serviΓ§os, um _loop_ assΓ­ncrono simples lidarΓ‘ com a maioria dos casos de uso. - -No entanto, se quisermos desabilitar temporariamente a corrotina, podemos "pausΓ‘-la" usando o mΓ©todo `pause` e "retomΓ‘-la" usando o mΓ©todo `resume`: - -```rust, no_run -let sync: &UseCoroutine<()> = use_coroutine(cx, |rx| async move { - // code for syncing -}); - -if sync.is_running() { - cx.render(rsx!{ - button { - onclick: move |_| sync.pause(), - "Disable syncing" - } - }) -} else { - cx.render(rsx!{ - button { - onclick: move |_| sync.resume(), - "Enable syncing" - } - }) -} -``` - -Esse padrΓ£o Γ© onde as corrotinas sΓ£o extremamente ΓΊteis – em vez de escrever toda a lΓ³gica complicada para pausar nossas tarefas assΓ­ncronas como farΓ­amos com `Promises` de JavaScript, o modelo do Rust nos permite simplesmente nΓ£o pesquisar nosso `Future`. - -## Enviando valores - -VocΓͺ deve ter notado que o encerramento `use_coroutine` recebe um argumento chamado `rx`. O que Γ© aquilo? Bem, um padrΓ£o comum em aplicativos complexos Γ© lidar com vΓ‘rios cΓ³digos assΓ­ncronos de uma sΓ³ vez. Com bibliotecas como o Redux Toolkit, gerenciar vΓ‘rias promessas ao mesmo tempo pode ser um desafio e uma fonte comum de _bugs_. - -Usando corrotinas, temos a oportunidade de centralizar nossa lΓ³gica assΓ­ncrona. O parΓ’metro `rx` Γ© um canal ilimitado para cΓ³digo externo Γ  corrotina para enviar dados _para_ a corrotina. Em vez de fazer um _loop_ em um serviΓ§o externo, podemos fazer um _loop_ no prΓ³prio canal, processando mensagens de dentro de nosso aplicativo sem precisar gerar um novo `Future`. Para enviar dados para a corrotina, chamarΓ­amos "send" no _handle_. - -```rust, no_run -enum ProfileUpdate { - SetUsername(String), - SetAge(i32) -} - -let profile = use_coroutine(cx, |mut rx: UnboundedReciver| async move { - let mut server = connect_to_server().await; - - while let Ok(msg) = rx.next().await { - match msg { - ProfileUpdate::SetUsername(name) => server.update_username(name).await, - ProfileUpdate::SetAge(age) => server.update_age(age).await, - } - } -}); - - -cx.render(rsx!{ - button { - onclick: move |_| profile.send(ProfileUpdate::SetUsername("Bob".to_string())), - "Update username" - } -}) -``` - -Para aplicativos suficientemente complexos, poderΓ­amos criar vΓ‘rios "serviΓ§os" ΓΊteis diferentes que fazem um _loop_ nos canais para atualizar o aplicativo. - -```rust, no_run -let profile = use_coroutine(cx, profile_service); -let editor = use_coroutine(cx, editor_service); -let sync = use_coroutine(cx, sync_service); - -async fn profile_service(rx: UnboundedReceiver) { - // do stuff -} - -async fn sync_service(rx: UnboundedReceiver) { - // do stuff -} - -async fn editor_service(rx: UnboundedReceiver) { - // do stuff -} -``` - -Podemos combinar corrotinas com `Fermi` para emular o sistema `Thunk` do **Redux Toolkit** com muito menos dor de cabeΓ§a. Isso nos permite armazenar todo o estado do nosso aplicativo _dentro_ de uma tarefa e, em seguida, simplesmente atualizar os valores de "visualização" armazenados em `Atoms`. NΓ£o pode ser subestimado o quΓ£o poderosa Γ© essa tΓ©cnica: temos todas as vantagens das tarefas nativas do Rust com as otimizaçáes e ergonomia do estado global. Isso significa que seu estado _real_ nΓ£o precisa estar vinculado a um sistema como `Fermi` ou `Redux` – os ΓΊnicos `Atoms` que precisam existir sΓ£o aqueles que sΓ£o usados para controlar a interface. - -```rust, no_run -static USERNAME: Atom = Atom(|_| "default".to_string()); - -fn app(cx: Scope) -> Element { - let atoms = use_atom_root(cx); - - use_coroutine(cx, |rx| sync_service(rx, atoms.clone())); - - cx.render(rsx!{ - Banner {} - }) -} - -fn Banner(cx: Scope) -> Element { - let username = use_read(cx, &USERNAME); - - cx.render(rsx!{ - h1 { "Welcome back, {username}" } - }) -} -``` - -Agora, em nosso serviΓ§o de sincronização, podemos estruturar nosso estado como quisermos. SΓ³ precisamos atualizar os valores da _view_ quando estiver pronto. - -```rust, no_run -enum SyncAction { - SetUsername(String), -} - -async fn sync_service(mut rx: UnboundedReceiver, atoms: AtomRoot) { - let username = atoms.write(&USERNAME); - let errors = atoms.write(&ERRORS); - - while let Ok(msg) = rx.next().await { - match msg { - SyncAction::SetUsername(name) => { - if set_name_on_server(&name).await.is_ok() { - username.set(name); - } else { - errors.make_mut().push("SetUsernameFailed"); - } - } - } - } -} -``` - -## Valores de Rendimento - -Para obter valores de uma corrotina, basta usar um identificador `UseState` e definir o valor sempre que sua corrotina concluir seu trabalho. - -```rust, no_run -let sync_status = use_state(cx, || Status::Launching); -let sync_task = use_coroutine(cx, |rx: UnboundedReceiver| { - to_owned![sync_status]; - async move { - loop { - delay_ms(1000).await; - sync_status.set(Status::Working); - } - } -}) -``` - -## Injeção AutomΓ‘tica na API de Contexto - -Os identificadores de corrotina sΓ£o injetados automaticamente por meio da API de contexto. `use_coroutine_handle` com o tipo de mensagem como genΓ©rico pode ser usado para buscar um _handle_. - -```rust, no_run -fn Child(cx: Scope) -> Element { - let sync_task = use_coroutine_handle::(cx); - - sync_task.send(SyncAction::SetUsername); -} -``` diff --git a/docs/guide/src/pt-br/async/use_future.md b/docs/guide/src/pt-br/async/use_future.md deleted file mode 100644 index 1e7030ddf..000000000 --- a/docs/guide/src/pt-br/async/use_future.md +++ /dev/null @@ -1,31 +0,0 @@ -# `UseFuture` - -[`use_future`](https://docs.rs/dioxus-hooks/latest/dioxus_hooks/fn.use_future.html) permite executar um encerramento assΓ­ncrono e fornece seu resultado. - -Por exemplo, podemos fazer uma solicitação de API dentro de `use_future`: - -```rust, no_run -{{#include ../../../examples/use_future.rs:use_future}} -``` - -O cΓ³digo dentro de `use_future` serΓ‘ enviado ao agendador do Dioxus assim que o componente for renderizado. - -Podemos usar `.value()` para obter o resultado do `Future`. Na primeira execução, como nΓ£o hΓ‘ dados prontos quando o componente Γ© carregado, seu valor serΓ‘ `None`. No entanto, uma vez finalizado o `Future`, o componente serΓ‘ renderizado novamente e o valor agora serΓ‘ `Some(...)`, contendo o valor de retorno do encerramento. - -Podemos entΓ£o renderizar esse resultado: - -```rust, no_run -{{#include ../../../examples/use_future.rs:render}} -``` - -## Reiniciando o `Future` - -O identificador `UseFuture` fornece um mΓ©todo `restart`. Ele pode ser usado para executar o `Future` novamente, produzindo um novo valor. - -## DependΓͺncias - -Muitas vezes, vocΓͺ precisarΓ‘ executar o `Future` novamente toda vez que algum valor (por exemplo, uma prop) mudar. Ao invΓ©s de `.restart` manualmente, vocΓͺ pode fornecer uma tupla de "dependΓͺncias" para o gancho. Ele executarΓ‘ automaticamente o `Future` quando qualquer uma dessas dependΓͺncias for alterada. Exemplo: - -```rust, no_run -{{#include ../../../examples/use_future.rs:dependency}} -``` diff --git a/docs/guide/src/pt-br/best_practices/antipatterns.md b/docs/guide/src/pt-br/best_practices/antipatterns.md deleted file mode 100644 index fa57ba125..000000000 --- a/docs/guide/src/pt-br/best_practices/antipatterns.md +++ /dev/null @@ -1,33 +0,0 @@ -# AntipadrΓ΅es - -Este exemplo mostra o que nΓ£o fazer e fornece uma razΓ£o pela qual um determinado padrΓ£o Γ© considerado um "AntiPattern". A maioria dos antipadrΓ΅es sΓ£o considerados errados por motivos de desempenho ou por prejudicar a reutilização do cΓ³digo. - -## Fragmentos Aninhados Desnecessariamente - -Os fragmentos nΓ£o montam um elemento fΓ­sico no DOM imediatamente, entΓ£o o Dioxus deve recorrer a seus filhos para encontrar um nΓ³ DOM fΓ­sico. Este processo Γ© chamado de "normalização". Isso significa que fragmentos profundamente aninhados fazem o Dioxus realizar um trabalho desnecessΓ‘rio. Prefira um ou dois nΓ­veis de fragmentos/componentes aninhados atΓ© apresentar um elemento DOM verdadeiro. - -Apenas os nΓ³s Componente e Fragmento sΓ£o suscetΓ­veis a esse problema. O Dioxus atenua isso com componentes fornecendo uma API para registrar o estado compartilhado sem o padrΓ£o _Context Provider_. - -```rust, no_run -{{#include ../../../examples/anti_patterns.rs:nested_fragments}} -``` - -## Chaves do Iterador Incorretas - -Conforme descrito no capΓ­tulo de renderização condicional, os itens da lista devem ter _keys_ exclusivas associadas aos mesmos itens nas renderizaçáes. Isso ajuda o Dioxus a associar o estado aos componentes contidos e garante um bom desempenho de diferenciação. NΓ£o omita as _keys_, a menos que vocΓͺ saiba que a lista Γ© estΓ‘tica e nunca serΓ‘ alterada. - -```rust, no_run -{{#include ../../../examples/anti_patterns.rs:iter_keys}} -``` - -## Evite Mutabilidade Interior em `Props` - -Embora seja tecnicamente aceitΓ‘vel ter um `Mutex` ou um `RwLock` nos _props_, eles serΓ£o difΓ­ceis de usar. - -Suponha que vocΓͺ tenha um _struct_ `User` contendo o campo `username: String`. Se vocΓͺ passar uma _prop_ `Mutex` para um componente `UserComponent`, esse componente pode querer passar o nome de usuΓ‘rio como uma _prop_ `&str` para um componente filho. No entanto, ele nΓ£o pode passar esse campo emprestado, pois ele sΓ³ viveria enquanto o bloqueio do `Mutex`, que pertence Γ  função `UserComponent`. Portanto, o componente serΓ‘ forΓ§ado a clonar o campo `username`. - -## Evite Atualizar o Estado Durante a Renderização - -Toda vez que vocΓͺ atualiza o estado, o Dioxus precisa renderizar novamente o componente – isso Γ© ineficiente! Considere refatorar seu cΓ³digo para evitar isso. - -AlΓ©m disso, se vocΓͺ atualizar incondicionalmente o estado durante a renderização, ele serΓ‘ renderizado novamente em um _loop_ infinito. diff --git a/docs/guide/src/pt-br/best_practices/error_handling.md b/docs/guide/src/pt-br/best_practices/error_handling.md deleted file mode 100644 index 2fec8d88d..000000000 --- a/docs/guide/src/pt-br/best_practices/error_handling.md +++ /dev/null @@ -1,153 +0,0 @@ -# Manipulação de Erros - -Um ponto forte do Rust para desenvolvimento Web Γ© a confiabilidade de sempre saber onde os erros podem ocorrer e ser forΓ§ado a lidar com eles - -No entanto, nΓ£o falamos sobre tratamento de erros neste guia! Neste capΓ­tulo, abordaremos algumas estratΓ©gias para lidar com erros para garantir que seu aplicativo nunca falhe. - -## O mais simples – retornando None - -Observadores astutos podem ter notado que `Element` Γ© na verdade um alias de tipo para `Option`. VocΓͺ nΓ£o precisa saber o que Γ© um `VNode`, mas Γ© importante reconhecer que nΓ£o poderΓ­amos retornar nada: - -```rust, no_run -fn App(cx: Scope) -> Element { - None -} -``` - -Isso nos permite adicionar um pouco de açúcar sintΓ‘tico para operaçáes que achamos que _nΓ£o devem_ falhar, mas ainda nΓ£o estamos confiantes o suficiente para "desempacotar". - -> A natureza de `Option` pode mudar no futuro Γ  medida que a caracterΓ­stica `try` for atualizada. - -```rust, no_run -fn App(cx: Scope) -> Element { - // immediately return "None" - let name = cx.use_hook(|_| Some("hi"))?; -} -``` - -## Retorno Antecipado do Resultado - -Como o Rust nΓ£o pode aceitar opçáes e resultados com a infraestrutura _try_ existente, vocΓͺ precisarΓ‘ manipular os resultados manualmente. Isso pode ser feito convertendo-os em `Option` ou manipulando-os explicitamente. - -```rust, no_run -fn App(cx: Scope) -> Element { - // Convert Result to Option - let name = cx.use_hook(|_| "1.234").parse().ok()?; - - - // Early return - let count = cx.use_hook(|_| "1.234"); - let val = match count.parse() { - Ok(val) => val - Err(err) => return cx.render(rsx!{ "Parsing failed" }) - }; -} -``` - -Observe que enquanto os ganchos no Dioxus nΓ£o gostam de ser chamados em condicionais ou loops, eles _estΓ£o_ bem com retornos antecipados. Retornar um estado de erro antecipadamente Γ© uma maneira completamente vΓ‘lida de lidar com erros. - -## Resultados usando `match` - -A prΓ³xima "melhor" maneira de lidar com erros no Dioxus Γ© combinar (`match`) o erro localmente. Essa Γ© a maneira mais robusta de lidar com erros, embora nΓ£o seja dimensionada para arquiteturas alΓ©m de um ΓΊnico componente. - -Para fazer isso, simplesmente temos um estado de erro embutido em nosso componente: - -```rust, no_run -let err = use_state(cx, || None); -``` - -Sempre que realizarmos uma ação que gere um erro, definiremos esse estado de erro. Podemos entΓ£o combinar o erro de vΓ‘rias maneiras (retorno antecipado, elemento de retorno etc.). - -```rust, no_run -fn Commandline(cx: Scope) -> Element { - let error = use_state(cx, || None); - - cx.render(match *error { - Some(error) => rsx!( - h1 { "An error occured" } - ) - None => rsx!( - input { - oninput: move |_| error.set(Some("bad thing happened!")), - } - ) - }) -} -``` - -## Passando Estados de Erro AtravΓ©s de Componentes - -Se vocΓͺ estiver lidando com alguns componentes com um mΓ­nimo de aninhamento, basta passar o identificador de erro para componentes filhos. - -```rust, no_run -fn Commandline(cx: Scope) -> Element { - let error = use_state(cx, || None); - - if let Some(error) = **error { - return cx.render(rsx!{ "An error occured" }); - } - - cx.render(rsx!{ - Child { error: error.clone() } - Child { error: error.clone() } - Child { error: error.clone() } - Child { error: error.clone() } - }) -} -``` - -Assim como antes, nossos componentes filhos podem definir manualmente o erro durante suas prΓ³prias açáes. A vantagem desse padrΓ£o Γ© que podemos isolar facilmente os estados de erro para alguns componentes por vez, tornando nosso aplicativo mais previsΓ­vel e robusto. - -## Tornando Global - -Uma estratΓ©gia para lidar com erros em cascata em aplicativos maiores Γ© sinalizar um erro usando o estado global. Esse padrΓ£o especΓ­fico envolve a criação de um contexto de "erro" e, em seguida, defini-lo sempre que relevante. Este mΓ©todo em particular nΓ£o Γ© tΓ£o "sofisticado" quanto o controle de erros do React, mas Γ© mais adequado para Rust. - -Para comeΓ§ar, considere usar um _hook_ embutido como `use_context` e `use_context_provider` ou `Fermi`. Claro, Γ© muito fΓ‘cil criar seu prΓ³prio _hook_ tambΓ©m. - -No "topo" de nossa arquitetura, queremos declarar explicitamente um valor que pode ser um erro. - -```rust, no_run -enum InputError { - None, - TooLong, - TooShort, -} - -static INPUT_ERROR: Atom = Atom(|_| InputError::None); -``` - -EntΓ£o, em nosso componente de nΓ­vel superior, queremos tratar explicitamente o possΓ­vel estado de erro para esta parte da Γ‘rvore. - -```rust, no_run -fn TopLevel(cx: Scope) -> Element { - let error = use_read(cx, &INPUT_ERROR); - - match error { - TooLong => return cx.render(rsx!{ "FAILED: Too long!" }), - TooShort => return cx.render(rsx!{ "FAILED: Too Short!" }), - _ => {} - } -} -``` - -Agora, sempre que um componente _downstream_ tiver um erro em suas açáes, ele pode simplesmente definir seu prΓ³prio estado de erro: - -```rust, no_run -fn Commandline(cx: Scope) -> Element { - let set_error = use_set(cx, &INPUT_ERROR); - - cx.render(rsx!{ - input { - oninput: move |evt| { - if evt.value.len() > 20 { - set_error(InputError::TooLong); - } - } - } - }) -} -``` - -Essa abordagem de tratamento de erros Γ© melhor em aplicativos que tΓͺm estados de erro "bem definidos". Considere usar uma `crate` como `thiserror` ou `anyhow` para simplificar a geração dos tipos de erro. - -Esse padrΓ£o Γ© amplamente popular em muitos contextos e Γ© particularmente ΓΊtil sempre que seu cΓ³digo gera um erro irrecuperΓ‘vel. VocΓͺ pode capturar esses estados de erro "globais" resultar em `panic!` ou estragar o estado. diff --git a/docs/guide/src/pt-br/best_practices/index.md b/docs/guide/src/pt-br/best_practices/index.md deleted file mode 100644 index ee8506241..000000000 --- a/docs/guide/src/pt-br/best_practices/index.md +++ /dev/null @@ -1,14 +0,0 @@ -# PrΓ‘ticas Recomendadas - -## Componentes ReutilizΓ‘veis - -Tanto quanto possΓ­vel, divida seu cΓ³digo em pequenos componentes e _hooks_ reutilizΓ‘veis, em vez de implementar grandes partes da interface do usuΓ‘rio em um ΓΊnico componente. Isso ajudarΓ‘ vocΓͺ a manter o cΓ³digo sustentΓ‘vel – Γ© muito mais fΓ‘cil, por exemplo, adicionar, remover ou reordenar partes da interface do usuΓ‘rio se ela estiver organizada em componentes. - -Organize seus componentes em mΓ³dulos para manter a base de cΓ³digo fΓ‘cil de navegar! - -## Minimize as DependΓͺncias do Estado - -Embora seja possΓ­vel compartilhar o estado entre os componentes, isso sΓ³ deve ser feito quando necessΓ‘rio. Qualquer componente associado a um objeto de estado especΓ­fico precisa ser renderizado novamente quando esse estado for alterado. Por esta razΓ£o: - -- Mantenha o estado local para um componente, se possΓ­vel -- Ao compartilhar o estado por meio de adereΓ§os, passe apenas os dados especΓ­ficos necessΓ‘rios diff --git a/docs/guide/src/pt-br/contributing.md b/docs/guide/src/pt-br/contributing.md deleted file mode 100644 index 404a174db..000000000 --- a/docs/guide/src/pt-br/contributing.md +++ /dev/null @@ -1,20 +0,0 @@ -# Contribuindo - -O desenvolvimento acontece no [repositΓ³rio do Dioxus no GitHub](https://github.com/DioxusLabs/dioxus). Se vocΓͺ encontrou um bug ou tem uma ideia para um recurso, envie um _issue_ (verifique se alguΓ©m ainda nΓ£o o fez (https://github.com/DioxusLabs/dioxus/issues)). - -[DiscussΓ΅es do GitHub](https://github.com/DioxusLabs/dioxus/discussions) podem ser usadas como um lugar para pedir ajuda ou falar sobre recursos. VocΓͺ tambΓ©m pode participar do [nosso canal Discord](https://discord.gg/XgGxMSkvUM) onde algumas discussΓ΅es de desenvolvimento acontecem. - -## Como melhorar os documentos - -Se vocΓͺ quiser melhorar os documentos, os PRs sΓ£o bem-vindos! Ambos os documentos do Rust ([source](https://github.com/DioxusLabs/dioxus/tree/master/packages)) e este guia ([source](https://github.com/DioxusLabs/dioxus/tree/master /docs/guide)) pode ser encontrado no repositΓ³rio do GitHub. - -## Trabalhando no Ecossistema - -Parte do que torna o React Γ³timo Γ© o rico ecossistema. GostarΓ­amos do mesmo para Dioxus! Portanto, se vocΓͺ tem uma biblioteca em mente que gostaria de escrever e da qual acha que muitas pessoas se beneficiariam, ela serΓ‘ apreciada. VocΓͺ pode [navegar no npm.js](https://www.npmjs.com/search?q=keywords:react-component) para se inspirar. - -## Bugs e recursos - -Se vocΓͺ corrigiu [um problema aberto](https://github.com/DioxusLabs/dioxus/issues), sinta-se Γ  vontade para enviar um PR! VocΓͺ tambΓ©m pode dar uma olhada no [roteiro](./roadmap.md) e trabalhar em algo lΓ‘. Considere [entre em contato](https://discord.gg/XgGxMSkvUM) com a equipe primeiro para garantir que todos estejam na mesma pΓ‘gina e que vocΓͺ nΓ£o faΓ§a um trabalho inΓΊtil! - -Todas as solicitaçáes de PR (incluindo aquelas feitas por um membro da equipe) devem ser aprovadas por pelo menos um outro membro da equipe. -DecisΓ΅es maiores e mais sutis sobre design, arquitetura, mudanΓ§as de ΓΊltima hora, trade-offs, etc. sΓ£o feitas por consenso da equipe. diff --git a/docs/guide/src/pt-br/custom_renderer/index.md b/docs/guide/src/pt-br/custom_renderer/index.md deleted file mode 100644 index 195f9d6ca..000000000 --- a/docs/guide/src/pt-br/custom_renderer/index.md +++ /dev/null @@ -1,505 +0,0 @@ -# Renderizador Personalizado - -Dioxus Γ© uma estrutura incrivelmente portΓ‘til para desenvolvimento de interface do usuΓ‘rio. As liçáes, conhecimentos, _hooks_ e componentes que vocΓͺ adquire ao longo do tempo sempre podem ser usados ​​para projetos futuros. No entanto, Γ s vezes, esses projetos nΓ£o podem aproveitar um renderizador compatΓ­vel ou vocΓͺ precisa implementar seu prΓ³prio renderizador melhor. - -Γ“timas notΓ­cias: o design do renderizador depende inteiramente de vocΓͺ! NΓ³s fornecemos sugestΓ΅es e inspiração com os renderizadores originais, mas sΓ³ realmente precisamos processar `DomEdits` e enviar `UserEvents`. - -## Detalhes - -A implementação do renderizador Γ© bastante simples. O renderizador precisa: - -1. Lidar com o fluxo de ediçáes gerado por atualizaçáes no DOM virtual -2. Registrar ouvintes e passar eventos para o sistema de eventos do DOM virtual - -Essencialmente, seu renderizador precisa implementar a `trait` `RealDom` e gerar objetos `EventTrigger` para atualizar o `VirtualDOM`. A partir daΓ­, vocΓͺ terΓ‘ tudo o que precisa para renderizar o `VirtualDOM` na tela. - -Internamente, o Dioxus lida com o relacionamento da Γ‘rvore, `diffing`, gerenciamento de memΓ³ria e o sistema de eventos, deixando o mΓ­nimo necessΓ‘rio para que os renderizadores se implementem. - -Como referΓͺncia, confira o interpretador `javascript` ou o renderizador `tui` como ponto de partida para seu renderizador personalizado. - -## DomEdit - -O tipo "DomEdit" Γ© uma `enum` serializada que representa uma operação atΓ΄mica que ocorre no `RealDom`. As variantes seguem aproximadamente este conjunto: - -```rust, no_run -enum DomEdit { - PushRoot, - AppendChildren, - ReplaceWith, - InsertAfter, - InsertBefore, - Remove, - CreateTextNode, - CreateElement, - CreateElementNs, - CreatePlaceholder, - NewEventListener, - RemoveEventListener, - SetText, - SetAttribute, - RemoveAttribute, - PopRoot, -} -``` - -O mecanismo de diferenciação Dioxus opera como uma [mΓ‘quina de pilha] (https://en.wikipedia.org/wiki/Stack_machine) onde o mΓ©todo "push_root" empurra um novo nΓ³ DOM "real" para a pilha e "append_child" e "replace_with" " ambos removem nΓ³s da pilha. - -### Exemplo - -Para fins de compreensΓ£o, vamos considerar este exemplo – uma declaração de interface do usuΓ‘rio muito simples: - -```rust, no_run -rsx!( h1 {"hello world"} ) -``` - -Para comeΓ§ar, o Dioxus deve primeiro navegar atΓ© o contΓͺiner dessa tag h1. Para "navegar" aqui, o algoritmo de diferenciação interna gera o `DomEdit` `PushRoot` onde o ID da raiz Γ© o contΓͺiner. - -Quando o renderizador recebe essa instrução, ele empurra o `Node` real para sua prΓ³pria pilha. A pilha do renderizador real ficarΓ‘ assim: - -```rust, no_run -instructions: [ - PushRoot(Container) -] -stack: [ - ContainerNode, -] -``` - -Em seguida, o Dioxus encontrarΓ‘ o nΓ³ `h1`. O algoritmo `diff` decide que este nΓ³ precisa ser criado, entΓ£o o Dioxus irΓ‘ gerar o DomEdit `CreateElement`. Quando o renderizador receber esta instrução, ele criarΓ‘ um nΓ³ desmontado e o enviarΓ‘ para sua prΓ³pria pilha (_stack_): - -```rust, no_run -instructions: [ - PushRoot(Container), - CreateElement(h1), -] -stack: [ - ContainerNode, - h1, -] -``` - -Em seguida, Dioxus vΓͺ o nΓ³ de texto e gera o DomEdit `CreateTextNode`: - -```rust, no_run -instructions: [ - PushRoot(Container), - CreateElement(h1), - CreateTextNode("hello world") -] -stack: [ - ContainerNode, - h1, - "hello world" -] -``` - -Lembre-se, o nΓ³ de texto nΓ£o estΓ‘ anexado a nada (ele estΓ‘ desmontado), entΓ£o o Dioxus precisa gerar um _Edit_ que conecte o nΓ³ de texto ao elemento `h1`. Depende da situação, mas neste caso usamos `AppendChildren`. Isso remove o nΓ³ de texto da _stack_, deixando o elemento `h1` como o prΓ³ximo elemento na linha. - -```rust, no_run -instructions: [ - PushRoot(Container), - CreateElement(h1), - CreateTextNode("hello world"), - AppendChildren(1) -] -stack: [ - ContainerNode, - h1 -] -``` - -Chamamos `AppendChildren` novamente, retirando o nΓ³ `h1` e anexando-o ao pai: - -```rust, no_run -instructions: [ - PushRoot(Container), - CreateElement(h1), - CreateTextNode("hello world"), - AppendChildren(1), - AppendChildren(1) -] -stack: [ - ContainerNode, -] -``` - -Finalmente, o contΓͺiner Γ© aberto, pois nΓ£o precisamos mais dele. - -```rust, no_run -instructions: [ - PushRoot(Container), - CreateElement(h1), - CreateTextNode("hello world"), - AppendChildren(1), - AppendChildren(1), - PopRoot -] -stack: [] -``` - -Com o tempo, nossa _stack_ ficou assim: - -```rust, no_run -[] -[Container] -[Container, h1] -[Container, h1, "hello world"] -[Container, h1] -[Container] -[] -``` - -Observe como nossa _stack_ fica vazia depois que a interface do usuΓ‘rio Γ© montada. Convenientemente, essa abordagem separa completamente o `VirtualDOM` e o `RealDOM`. AlΓ©m disso, essas ediçáes sΓ£o serializΓ‘veis, o que significa que podemos atΓ© gerenciar UIs em uma conexΓ£o de rede. Esta pequena _stack_ e ediçáes serializadas tornam o Dioxus independente das especificidades da plataforma. - -Dioxus tambΓ©m Γ© muito rΓ‘pido. Como o Dioxus divide a fase de `diff` e `patch`, ele Γ© capaz de fazer todas as ediçáes no `RealDOM` em um perΓ­odo de tempo muito curto (menos de um ΓΊnico quadro), tornando a renderização muito rΓ‘pida. Ele tambΓ©m permite que o Dioxus cancele grandes operaçáes de diferenciação se ocorrer um trabalho de prioridade mais alta durante a diferenciação. - -Γ‰ importante notar que hΓ‘ uma camada de conexΓ£o entre o Dioxus e o renderizador. Dioxus salva e carrega elementos (a edição `PushRoot`) com um ID. Dentro do `VirtualDOM`, isso Γ© rastreado apenas como um `u64`. - -Sempre que uma edição `CreateElement` Γ© gerada durante a comparação, o Dioxus incrementa seu contador de nΓ³s e atribui a esse novo elemento seu `NodeCount` atual. O `RealDom` Γ© responsΓ‘vel por lembrar este ID e enviar o nΓ³ correto quando `PushRoot(ID)` Γ© gerado. Dioxus recupera IDs de elementos quando removidos. Para ficar em sincronia com Dioxus, vocΓͺ pode usar um `Sparce Vec` (`Vec>`) com itens possivelmente desocupados. VocΓͺ pode usar os ids como Γ­ndices no `Vec` para elementos e aumentar o `Vec` quando um id nΓ£o existir. - -Esta pequena demonstração serve para mostrar exatamente como um Renderer precisaria processar um stream de edição para construir UIs. Um conjunto de `DomEdits` serializados para vΓ‘rias demos estΓ‘ disponΓ­vel para vocΓͺ testar seu renderizador personalizado. - -## Ciclo de Eventos - -Como a maioria das GUIs, o Dioxus conta com um _loop_ de eventos para progredir no `VirtualDOM`. O prΓ³prio `VirtualDOM` tambΓ©m pode produzir eventos, por isso Γ© importante que seu renderizador personalizado tambΓ©m possa lidar com eles. - -O cΓ³digo para a implementação do `WebSys` Γ© direto, entΓ£o vamos adicionΓ‘-lo aqui para demonstrar como um `loop` de eventos Γ© simples: - -```rust, no_run -pub async fn run(&mut self) -> dioxus_core::error::Result<()> { - // Push the body element onto the WebsysDom's stack machine - let mut websys_dom = crate::new::WebsysDom::new(prepare_websys_dom()); - websys_dom.stack.push(root_node); - - // Rebuild or hydrate the virtualdom - let mutations = self.internal_dom.rebuild(); - websys_dom.apply_mutations(mutations); - - // Wait for updates from the real dom and progress the virtual dom - loop { - let user_input_future = websys_dom.wait_for_event(); - let internal_event_future = self.internal_dom.wait_for_work(); - - match select(user_input_future, internal_event_future).await { - Either::Left((_, _)) => { - let mutations = self.internal_dom.work_with_deadline(|| false); - websys_dom.apply_mutations(mutations); - }, - Either::Right((event, _)) => websys_dom.handle_event(event), - } - - // render - } -} -``` - -Γ‰ importante que vocΓͺ decodifique os eventos reais do seu sistema de eventos no sistema de eventos sintΓ©tico do Dioxus (entenda sintΓ©tico como abstraΓ­do). Isso significa simplesmente combinar seu tipo de evento e criar um tipo Dioxus `UserEvent`. No momento, o sistema `VirtualEvent` Γ© modelado quase inteiramente em torno da especificação HTML, mas estamos interessados em reduzi-lo. - -```rust, no_run -fn virtual_event_from_websys_event(event: &web_sys::Event) -> VirtualEvent { - match event.type_().as_str() { - "keydown" => { - let event: web_sys::KeyboardEvent = event.clone().dyn_into().unwrap(); - UserEvent::KeyboardEvent(UserEvent { - scope_id: None, - priority: EventPriority::Medium, - name: "keydown", - // This should be whatever element is focused - element: Some(ElementId(0)), - data: Arc::new(KeyboardData{ - char_code: event.char_code(), - key: event.key(), - key_code: event.key_code(), - alt_key: event.alt_key(), - ctrl_key: event.ctrl_key(), - meta_key: event.meta_key(), - shift_key: event.shift_key(), - location: event.location(), - repeat: event.repeat(), - which: event.which(), - }) - }) - } - _ => todo!() - } -} -``` - -## Elementos brutos personalizados - -Se vocΓͺ precisa ir tΓ£o longe a ponto de confiar em elementos personalizados para o seu renderizador – vocΓͺ pode. Isso ainda permite que vocΓͺ use a natureza reativa do Dioxus, sistema de componentes, estado compartilhado e outros recursos, mas acabarΓ‘ gerando nΓ³s diferentes. Todos os atributos e ouvintes para o namespace HTML e SVG sΓ£o transportados por meio de estruturas auxiliares que essencialmente compilam (nΓ£o representam sobrecarga de tempo de execução). VocΓͺ pode colocar seus prΓ³prios elementos a qualquer hora, sem problemas. No entanto, vocΓͺ deve ter certeza absoluta de que seu renderizador pode lidar com o novo tipo, ou ele irΓ‘ "bater e queimar". - -Esses elementos personalizados sΓ£o definidos como estruturas de unidade com implementaçáes de caracterΓ­sticas. - -Por exemplo, o elemento `div` Γ© (aproximadamente!) definido assim: - -```rust, no_run -struct div; -impl div { - /// Some glorious documentation about the class property. - const TAG_NAME: &'static str = "div"; - const NAME_SPACE: Option<&'static str> = None; - // define the class attribute - pub fn class<'a>(&self, cx: NodeFactory<'a>, val: Arguments) -> Attribute<'a> { - cx.attr("class", val, None, false) - } - // more attributes -} -``` - -VocΓͺ provavelmente notou que muitos elementos nas macros `rsx!` suportam documentação em foco. A abordagem que adotamos para elementos personalizados significa que a estrutura da unidade Γ© criada imediatamente onde o elemento Γ© usado na macro. Quando a macro Γ© expandida, os comentΓ‘rios doc ainda se aplicam Γ  estrutura da unidade, dando toneladas de feedback no editor, mesmo dentro de uma `macro proc`. - -# NΓΊcleo Nativo - -Se vocΓͺ estiver criando um renderizador em Rust, o nΓΊcleo nativo fornece alguns utilitΓ‘rios para implementar um renderizador. Ele fornece uma abstração sobre `DomEdits` e manipula o layout para vocΓͺ. - -## RealDom - -O `RealDom` Γ© uma abstração de nΓ­vel superior sobre a atualização do Dom. Ele atualiza com `DomEdits` e fornece uma maneira de atualizar incrementalmente o estado dos nΓ³s com base em quais atributos mudam. - -### Exemplo - -Vamos construir um renderizador de exemplo com bordas, tamanho e cor do texto. -Antes de comeΓ§armos, vamos dar uma olhada em um elemento de exemplo que podemos renderizar: - -```rust, no_run -cx.render(rsx!{ - div{ - color: "red", - p{ - border: "1px solid black", - "hello world" - } - } -}) -``` - -Nesta Γ‘rvore a cor depende da cor do pai. O tamanho depende do tamanho das _children_, do texto atual e do tamanho do texto. A borda depende apenas do nΓ³ atual. - -No diagrama a seguir, as setas representam o fluxo de dados: - -[![](https://mermaid.ink/img/pako:eNqdVNFqgzAU_RXJXizUUZPJmIM-jO0LukdhpCbO0JhIGteW0n9fNK1Oa0brfUnu9VxyzzkXjyCVhIIYZFzu0hwr7X2-JcIzsa3W3wqXuZdKoele22oddfa1Y0Tnfn31muvMfqeCDNq3GmvaNROmaKqZFO1DPTRhP8MOd1fTWYNDvzlmQbBMJZcq9JtjNgY1mLVUhBqQPQeojl3wGCw5PsjqnIe-zXqEL8GZ2Kz0gVMPmoeU3ND4IcuiaLGY2zRouuKncv_qGKv3VodpJe0JVU6QCQ5kgqMyWQVr8hbk4hm1PBcmsuwmnrCVH94rP7xN_ucp8sOB_EPSfz9drYVrkpc_AmH8_yTjJueUc-ntpOJkgt2os9tKjcYlt-DLUiD3UsB2KZCLcwjv3Aq33-g2v0M0xXA0MBy5DUdXi-gcJZriuLmAOSioKjAj5ld8rMsJ0DktaAJicyVYbRKQiJPBVSUx438QpqUCcYb5ls4BrrRcHUTaFizqnWGzR8W5evoFI-bJdw)](https://mermaid-js.github.io/mermaid-live-editor/edit#pako:eNqdVNFqgzAU_RXJXizUUZPJmIM-jO0LukdhpCbO0JhIGteW0n9fNK1Oa0brfUnu9VxyzzkXjyCVhIIYZFzu0hwr7X2-JcIzsa3W3wqXuZdKoele22oddfa1Y0Tnfn31muvMfqeCDNq3GmvaNROmaKqZFO1DPTRhP8MOd1fTWYNDvzlmQbBMJZcq9JtjNgY1mLVUhBqQPQeojl3wGCw5PsjqnIe-zXqEL8GZ2Kz0gVMPmoeU3ND4IcuiaLGY2zRouuKncv_qGKv3VodpJe0JVU6QCQ5kgqMyWQVr8hbk4hm1PBcmsuwmnrCVH94rP7xN_ucp8sOB_EPSfz9drYVrkpc_AmH8_yTjJueUc-ntpOJkgt2os9tKjcYlt-DLUiD3UsB2KZCLcwjv3Aq33-g2v0M0xXA0MBy5DUdXi-gcJZriuLmAOSioKjAj5ld8rMsJ0DktaAJicyVYbRKQiJPBVSUx438QpqUCcYb5ls4BrrRcHUTaFizqnWGzR8W5evoFI-bJdw) - -[//]: # "%% mermaid flow chart" -[//]: # "flowchart TB" -[//]: # " subgraph context" -[//]: # " text_width(text width)" -[//]: # " end" -[//]: # " subgraph state" -[//]: # " direction TB" -[//]: # " subgraph div state" -[//]: # " direction TB" -[//]: # " state1(state)-->color1(color)" -[//]: # " state1-->border1(border)" -[//]: # " text_width-.->layout_width1(layout width)" -[//]: # " linkStyle 2 stroke:#ff5500,stroke-width:4px;" -[//]: # " state1-->layout_width1" -[//]: # " end" -[//]: # " subgraph p state" -[//]: # " direction TB" -[//]: # " state2(state)-->color2(color)" -[//]: # " color1-.->color2" -[//]: # " linkStyle 5 stroke:#0000ff,stroke-width:4px;" -[//]: # " state2-->border2(border)" -[//]: # " text_width-.->layout_width2(layout width)" -[//]: # " linkStyle 7 stroke:#ff5500,stroke-width:4px;" -[//]: # " state2-->layout_width2" -[//]: # " layout_width2-.->layout_width1" -[//]: # " linkStyle 9 stroke:#00aa00,stroke-width:4px;" -[//]: # " end" -[//]: # " subgraph hello world state" -[//]: # " direction TB" -[//]: # " state3(state)-->border3(border)" -[//]: # " state3-->color3(color)" -[//]: # " color2-.->color3" -[//]: # " linkStyle 12 stroke:#0000ff,stroke-width:4px;" -[//]: # " text_width-.->layout_width3(layout width)" -[//]: # " linkStyle 13 stroke:#ff5500,stroke-width:4px;" -[//]: # " state3-->layout_width3" -[//]: # " layout_width3-.->layout_width2" -[//]: # " linkStyle 15 stroke:#00aa00,stroke-width:4px;" -[//]: # " end" -[//]: # " end" - -Para ajudar na construção de um DOM, o nΓΊcleo nativo fornece quatro `traits`: `State`, `ChildDepState`, `ParentDepState` e `NodeDepState` e uma estrutura `RealDom`. O `ChildDepState`, `ParentDepState` e `NodeDepState` fornecem uma maneira de descrever como algumas informaçáes em um nΓ³ se relacionam com as de seus parentes. Ao fornecer como construir um ΓΊnico nΓ³ a partir de suas relaçáes, o native-core derivarΓ‘ uma maneira de atualizar o estado de todos os nΓ³s para vocΓͺ com `#[derive(State)]`. Depois de ter um estado, vocΓͺ pode fornecΓͺ-lo como genΓ©rico ao `RealDom`. `RealDom` fornece todos os mΓ©todos para interagir e atualizar seu novo dom. - -```rust, no_run -use dioxus_native_core::node_ref::*; -use dioxus_native_core::state::{ChildDepState, NodeDepState, ParentDepState, State}; -use dioxus_native_core_macro::{sorted_str_slice, State}; - -#[derive(Default, Copy, Clone)] -struct Size(f32, f32); -// Size only depends on the current node and its children, so it implements ChildDepState -impl ChildDepState for Size { - // Size accepts a font size context - type Ctx = f32; - // Size depends on the Size part of each child - type DepState = Self; - // Size only cares about the width, height, and text parts of the current node - const NODE_MASK: NodeMask = - NodeMask::new_with_attrs(AttributeMask::Static(&sorted_str_slice!(["width", "height"]))).with_text(); - fn reduce<'a>( - &mut self, - node: NodeView, - children: impl Iterator, - ctx: &Self::Ctx, - ) -> bool - where - Self::DepState: 'a, - { - let mut width; - let mut height; - if let Some(text) = node.text() { - // if the node has text, use the text to size our object - width = text.len() as f32 * ctx; - height = ctx; - } else { - // otherwise, the size is the maximum size of the children - width = *children - .reduce(|accum, item| if accum >= item.0 { accum } else { item.0 }) - .unwrap_or(0.0)); - height = *children - .reduce(|accum, item| if accum >= item.1 { accum } else { item.1 }) - .unwrap_or(&0.0); - } - // if the node contains a width or height attribute it overrides the other size - for a in node.attibutes(){ - match a.name{ - "width" => width = a.value.parse().unwrap(), - "height" => height = a.value.parse().unwrap(), - // because Size only depends on the width and height, no other attributes will be passed to the member - _ => panic!() - } - } - // to determine what other parts of the dom need to be updated we return a boolean that marks if this member changed - let changed = (width != self.0) || (height != self.1); - *self = Self(width, height); - changed - } -} - -#[derive(Debug, Clone, Copy, PartialEq, Default)] -struct TextColor { - r: u8, - g: u8, - b: u8, -} -// TextColor only depends on the current node and its parent, so it implements ParentDepState -impl ParentDepState for TextColor { - type Ctx = (); - // TextColor depends on the TextColor part of the parent - type DepState = Self; - // TextColor only cares about the color attribute of the current node - const NODE_MASK: NodeMask = NodeMask::new_with_attrs(AttributeMask::Static(&["color"])); - fn reduce( - &mut self, - node: NodeView, - parent: Option<&Self::DepState>, - _ctx: &Self::Ctx, - ) -> bool { - // TextColor only depends on the color tag, so getting the first tag is equivilent to looking through all tags - let new = match node.attributes().next() { - // if there is a color tag, translate it - Some("red") => TextColor { r: 255, g: 0, b: 0 }, - Some("green") => TextColor { r: 0, g: 255, b: 0 }, - Some("blue") => TextColor { r: 0, g: 0, b: 255 }, - Some(_) => panic!("unknown color"), - // otherwise check if the node has a parent and inherit that color - None => match parent { - Some(parent) => *parent, - None => Self::default(), - }, - }; - // check if the member has changed - let changed = new != *self; - *self = new; - changed - } -} - -#[derive(Debug, Clone, PartialEq, Default)] -struct Border(bool); -// TextColor only depends on the current node, so it implements NodeDepState -impl NodeDepState for Border { - type Ctx = (); - // Border does not depended on any other member in the current node - type DepState = (); - // Border does not depended on any other member in the current node - const NODE_MASK: NodeMask = - NodeMask::new_with_attrs(AttributeMask::Static(&["border"])); - fn reduce(&mut self, node: NodeView, _sibling: &Self::DepState, _ctx: &Self::Ctx) -> bool { - // check if the node contians a border attribute - let new = Self(node.attributes().next().map(|a| a.name == "border").is_some()); - // check if the member has changed - let changed = new != *self; - *self = new; - changed - } -} - -// State provides a derive macro, but anotations on the members are needed in the form #[dep_type(dep_member, CtxType)] -#[derive(State, Default, Clone)] -struct ToyState { - // the color member of it's parent and no context - #[parent_dep_state(color)] - color: TextColor, - // depends on the node, and no context - #[node_dep_state()] - border: Border, - // depends on the layout_width member of children and f32 context (for text size) - #[child_dep_state(size, f32)] - size: Size, -} -``` - -Agora que temos nosso estado, podemos colocΓ‘-lo em uso em nosso DOM. VocΓͺ pode atualizar o DOM com `update_state` para atualizar a estrutura do dom (adicionando, removendo e alterando as propriedades dos nΓ³s) e entΓ£o `apply_mutations` para atualizar o `ToyState` para cada um dos nΓ³s que foram alterados. - -```rust, no_run -fn main(){ - fn app(cx: Scope) -> Element { - cx.render(rsx!{ - div{ - color: "red", - "hello world" - } - }) - } - let vdom = VirtualDom::new(app); - let rdom: RealDom = RealDom::new(); - - let mutations = dom.rebuild(); - // update the structure of the real_dom tree - let to_update = rdom.apply_mutations(vec![mutations]); - let mut ctx = AnyMap::new(); - // set the font size to 3.3 - ctx.insert(3.3); - // update the ToyState for nodes in the real_dom tree - let _to_rerender = rdom.update_state(&dom, to_update, ctx).unwrap(); - - // we need to run the vdom in a async runtime - tokio::runtime::Builder::new_current_thread() - .enable_all() - .build()? - .block_on(async { - loop{ - let wait = vdom.wait_for_work(); - let mutations = vdom.work_with_deadline(|| false); - let to_update = rdom.apply_mutations(mutations); - let mut ctx = AnyMap::new(); - ctx.insert(3.3); - let _to_rerender = rdom.update_state(vdom, to_update, ctx).unwrap(); - - // render... - } - }) -} -``` - -## Layout - -Para a maioria das plataformas, o _layout_ dos `Elementos` permanecerΓ‘ o mesmo. O mΓ³dulo `layout_attributes` fornece uma maneira de aplicar atributos html a um estilo de _layout_ estendido. - -## ConclusΓ£o - -Pronto! VocΓͺ deve ter quase todo o conhecimento necessΓ‘rio sobre como implementar seu prΓ³prio renderizador. Estamos super interessados em ver os aplicativos Dioxus trazidos para renderizadores de desktop personalizados, renderizador para dispositivos mΓ³veis, interface do usuΓ‘rio de videogame e atΓ© realidade aumentada! Se vocΓͺ estiver interessado em contribuir para qualquer um desses projetos, nΓ£o tenha medo de entrar em contato ou se juntar Γ  comunidade. diff --git a/docs/guide/src/pt-br/describing_ui/component_children.md b/docs/guide/src/pt-br/describing_ui/component_children.md deleted file mode 100644 index 9663dca19..000000000 --- a/docs/guide/src/pt-br/describing_ui/component_children.md +++ /dev/null @@ -1,31 +0,0 @@ -# Componente Filhos - -Em alguns casos, vocΓͺ pode desejar criar um componente que atue como um contΓͺiner para algum outro conteΓΊdo, sem que o componente precise saber qual Γ© esse conteΓΊdo. Para conseguir isso, crie uma _prop_ do tipo `Element`: - -```rust, no_run -{{#include ../../../examples/component_element_props.rs:Clickable}} -``` - -EntΓ£o, ao renderizar o componente, vocΓͺ pode passar a saΓ­da de `cx.render(rsx!(...))`: - -```rust, no_run -{{#include ../../../examples/component_element_props.rs:Clickable_usage}} -``` - -> Nota: Como `Element<'a>` Γ© uma _prop_ emprestado, nΓ£o haverΓ‘ memoização. - -> Atenção: Embora possa compilar, nΓ£o inclua o mesmo `Element` mais de uma vez no RSX. O comportamento resultante nΓ£o Γ© especificado. - -## O Campo `children` - -Em vez de passar o `RSX` atravΓ©s de uma _prop_ regular, vocΓͺ pode querer aceitar filhos da mesma forma que os elementos podem ter filhos. O prop "mΓ‘gico" `children` permite que vocΓͺ consiga isso: - -```rust, no_run -{{#include ../../../examples/component_children.rs:Clickable}} -``` - -Isso torna o uso do componente muito mais simples: basta colocar o `RSX` dentro dos colchetes `{}` – e nΓ£o hΓ‘ necessidade de uma chamada `render` ou outra macro! - -```rust, no_run -{{#include ../../../examples/component_children.rs:Clickable_usage}} -``` diff --git a/docs/guide/src/pt-br/describing_ui/component_props.md b/docs/guide/src/pt-br/describing_ui/component_props.md deleted file mode 100644 index 4cb5a50ca..000000000 --- a/docs/guide/src/pt-br/describing_ui/component_props.md +++ /dev/null @@ -1,142 +0,0 @@ -# Props de Componentes - -Assim como vocΓͺ pode passar argumentos para uma função, vocΓͺ pode passar _props_ para um componente que personaliza seu comportamento! Os componentes que vimos atΓ© agora nΓ£o aceitam _props_ – entΓ£o vamos escrever alguns componentes que aceitam. - -## `#[derive(Props)]` - -_Props_ de componente sΓ£o uma ΓΊnica estrutura anotada com `#[derive(Props)]`. Para um componente aceitar _props_, o tipo de seu argumento deve ser `Scope`. EntΓ£o, vocΓͺ pode acessar o valor das _props_ usando `cx.props`. - -Existem 2 tipos de estruturas Props: - -- `props` prΓ³prios: - - NΓ£o tem uma vida ΓΊtil associada - - Implementam `PartialEq`, permitindo a memoização (se os _props_ nΓ£o mudarem, o Dioxus nΓ£o renderizarΓ‘ novamente o componente) -- `props` emprestados: - - [Emprestado](https://doc.rust-lang.org/beta/rust-by-example/scope/borrow.html) de um componente pai - - NΓ£o pode ser memoizado devido a restriçáes de tempo de vida (Rust's lifetime) - -### Props PrΓ³prios - -_Props_ prΓ³prios sΓ£o muito simples – eles nΓ£o emprestam nada. Exemplo: - -```rust, no_run -{{#include ../../../examples/component_owned_props.rs:Likes}} -``` - -VocΓͺ pode entΓ£o passar valores de _prop_ para o componente da mesma forma que vocΓͺ passaria atributos para um elemento: - -```rust, no_run -{{#include ../../../examples/component_owned_props.rs:App}} -``` - -![Screenshot: Likes component](./images/component_owned_props_screenshot.png) - -### Props Emprestados - -Possuir _props_ funciona bem se seus _props_ forem fΓ‘ceis de copiar – como um ΓΊnico nΓΊmero. Mas e se precisarmos passar um tipo de dados maior, como uma `String` de um componente `App` para um subcomponente `TitleCard`? Uma solução ingΓͺnua pode ser [`.clone()`](https://doc.rust-lang.org/std/clone/trait.Clone.html) a `String`, criando uma cΓ³pia dela para o subcomponente – mas isso seria ineficiente, especialmente para `Strings` maiores. - -Rust permite algo mais eficiente – emprestar a `String` como um `&str` – Γ© para isso que servem as _props emprestadas_! - -```rust, no_run -{{#include ../../../examples/component_borrowed_props.rs:TitleCard}} -``` - -Podemos entΓ£o usar o componente assim: - -```rust, no_run -{{#include ../../../examples/component_borrowed_props.rs:App}} -``` - -![Screenshot: TitleCard component](./images/component_borrowed_props_screenshot.png) - -## Props de Option - -A macro `#[derive(Props)]` tem alguns recursos que permitem personalizar o comportamento dos adereΓ§os. - -### Props Opcionais - -VocΓͺ pode criar campos opcionais usando o tipo `Option<…>` para um campo: - -```rust, no_run -{{#include ../../../examples/component_props_options.rs:OptionalProps}} -``` - -Em seguida, vocΓͺ pode optar por fornecΓͺ-los ou nΓ£o: - -```rust, no_run -{{#include ../../../examples/component_props_options.rs:OptionalProps_usage}} -``` - -### `Option` Explicitamente ObrigatΓ³rias - -Se vocΓͺ quiser exigir explicitamente uma `Option`, e nΓ£o uma _prop_ opcional, vocΓͺ pode anotΓ‘-la com `#[props(!optional)]`: - -```rust, no_run -{{#include ../../../examples/component_props_options.rs:ExplicitOption}} -``` - -EntΓ£o, vocΓͺ tem que passar explicitamente `Some("str")` ou `None`: - -```rust, no_run -{{#include ../../../examples/component_props_options.rs:ExplicitOption_usage}} -``` - -### Props PadrΓ£o - -VocΓͺ pode usar `#[props(default = 42)]` para tornar um campo opcional e especificar seu valor padrΓ£o: - -```rust, no_run -{{#include ../../../examples/component_props_options.rs:DefaultComponent}} -``` - -EntΓ£o, da mesma forma que _props_ opcionais, vocΓͺ nΓ£o precisa fornecΓͺ-lo: - -```rust, no_run -{{#include ../../../examples/component_props_options.rs:DefaultComponent_usage}} -``` - -### ConversΓ£o AutomΓ‘tica com `.into` - -Γ‰ comum que as funçáes Rust aceitem `impl Into` em vez de apenas `SomeType` para suportar uma ampla gama de parΓ’metros. Se vocΓͺ quiser uma funcionalidade semelhante com _props_, vocΓͺ pode usar `#[props(into)]`. Por exemplo, vocΓͺ pode adicionΓ‘-lo em uma prop `String` – e `&str` tambΓ©m serΓ‘ aceito automaticamente, pois pode ser convertido em `String`: - -```rust, no_run -{{#include ../../../examples/component_props_options.rs:IntoComponent}} -``` - -EntΓ£o, vocΓͺ pode usΓ‘-lo assim: - -```rust, no_run -{{#include ../../../examples/component_props_options.rs:IntoComponent_usage}} -``` - -## A macro `inline_props` - -AtΓ© agora, todas as funçáes `Component` que vimos tinham uma _struct_ `ComponentProps` correspondente para passar em _props_. Isso foi bastante verboso... NΓ£o seria legal ter _props_ como argumentos de função simples? EntΓ£o nΓ£o precisarΓ­amos definir uma estrutura Props, e ao invΓ©s de digitar `cx.props.whatever`, poderΓ­amos usar `whatever` diretamente! - -`inline_props` permite que vocΓͺ faΓ§a exatamente isso. Em vez de digitar a versΓ£o "completa": - -```rust, no_run -#[derive(Props, PartialEq)] -struct TitleCardProps { - title: String, -} - -fn TitleCard(cx: Scope) -> Element { - cx.render(rsx!{ - h1 { "{cx.props.title}" } - }) -} -``` - -...vocΓͺ pode definir uma função que aceita _props_ como argumentos. EntΓ£o, basta anotΓ‘-lo com `#[inline_props]`, e a macro irΓ‘ transformΓ‘-lo em um componente regular para vocΓͺ: - -```rust, no_run -#[inline_props] -fn TitleCard(cx: Scope, title: String) -> Element { - cx.render(rsx!{ - h1 { "{title}" } - }) -} -``` - -> Embora o novo Componente seja mais curto e fΓ‘cil de ler, essa macro nΓ£o deve ser usada por autores de bibliotecas, pois vocΓͺ tem menos controle sobre a documentação do Prop. diff --git a/docs/guide/src/pt-br/describing_ui/components.md b/docs/guide/src/pt-br/describing_ui/components.md deleted file mode 100644 index 91123b5f8..000000000 --- a/docs/guide/src/pt-br/describing_ui/components.md +++ /dev/null @@ -1,27 +0,0 @@ -# Componentes - -Assim como vocΓͺ nΓ£o gostaria de escrever um programa complexo em uma ΓΊnica e longa função `main`, vocΓͺ nΓ£o deve construir uma interface complexa em uma ΓΊnica função `App`. Em vez disso, seria melhor dividir a funcionalidade de um aplicativo em partes lΓ³gicas chamadas componentes. - -Um componente Γ© uma função Rust, nomeada em _UpperCammelCase_, que recebe um parΓ’metro `Scope` e retorna um `Element` descrevendo a interface do usuΓ‘rio que deseja renderizar. Na verdade, nossa função `App` Γ© um componente! - -```rust, no_run -{{#include ../../../examples/hello_world_desktop.rs:component}} -``` - -> VocΓͺ provavelmente desejarΓ‘ adicionar `#![allow(non_snake_case)]` no topo de sua caixa para evitar avisos sobre o nome da função - -Um Componente Γ© responsΓ‘vel por alguma tarefa de renderização – normalmente, renderizando uma parte isolada da interface do usuΓ‘rio. Por exemplo, vocΓͺ pode ter um componente `About` que renderiza uma breve descrição do Dioxus Labs: - -```rust, no_run -{{#include ../../../examples/components.rs:About}} -``` - -Em seguida, vocΓͺ pode renderizar seu componente em outro componente, da mesma forma que os elementos sΓ£o renderizados: - -```rust, no_run -{{#include ../../../examples/components.rs:App}} -``` - -![Captura de tela contendo o componente Sobre duas vezes](./images/screenshot_about_component.png) - -> Neste ponto, pode parecer que os componentes nada mais sΓ£o do que funçáes. No entanto, Γ  medida que vocΓͺ aprende mais sobre os recursos do Dioxus, verΓ‘ que eles sΓ£o realmente mais poderosos! diff --git a/docs/guide/src/pt-br/describing_ui/images/component_borrowed_props_screenshot.png b/docs/guide/src/pt-br/describing_ui/images/component_borrowed_props_screenshot.png deleted file mode 100644 index 6f1864662f34cf7bc4101f2778f0ccb03d1d1646..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 7868 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 diff --git a/docs/guide/src/pt-br/describing_ui/images/component_owned_props_screenshot.png b/docs/guide/src/pt-br/describing_ui/images/component_owned_props_screenshot.png deleted file mode 100644 index 2a1146cd1d49b2b54bcb1d103f69a294d3921ec9..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 6318 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 diff --git a/docs/guide/src/pt-br/describing_ui/images/screenshot_about_component.png b/docs/guide/src/pt-br/describing_ui/images/screenshot_about_component.png deleted file mode 100644 index 36f7250a1bbb007bf4f3cea787319d9df08f7b8d..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 19470 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 diff --git a/docs/guide/src/pt-br/describing_ui/index.md b/docs/guide/src/pt-br/describing_ui/index.md deleted file mode 100644 index 212e67921..000000000 --- a/docs/guide/src/pt-br/describing_ui/index.md +++ /dev/null @@ -1,116 +0,0 @@ -# Descrevendo a Interface do UsuΓ‘rio - -Dioxus Γ© uma estrutura _declarativa_. Isso significa que, em vez de dizer ao Dioxus o que fazer (por exemplo, "criar um elemento" ou "definir a cor para vermelho"), simplesmente _declaramos_ como queremos que a interface do usuΓ‘rio se pareΓ§a usando o RSX. - -VocΓͺ jΓ‘ viu um exemplo simples ou sintaxe `RSX` no aplicativo "hello world": - -```rust, no_run -{{#include ../../../examples/hello_world_desktop.rs:component}} -``` - -Aqui, usamos a macro `rsx!` para _declarar_ que queremos um elemento `div`, contendo o texto `"Hello, world!"`. Dioxus pega o RSX e constrΓ³i uma interface do usuΓ‘rio a partir dele. - -## Recursos do RSX - -O RSX Γ© muito semelhante ao HTML, pois descreve elementos com atributos e filhos. Aqui estΓ‘ um elemento `div` vazio no RSX, bem como o HTML resultante: - -```rust, no_run -{{#include ../../../examples/rsx_overview.rs:empty}} -``` - -```html -

-``` - -### Filhos - -Para adicionar filhos a um elemento, coloque-os dentro dos colchetes `{}`. Eles podem ser outros elementos ou texto. Por exemplo, vocΓͺ pode ter um elemento `ol` (lista ordenada), contendo 3 elementos `li` (item da lista), cada um dos quais contΓ©m algum texto: - -```rust, no_run -{{#include ../../../examples/rsx_overview.rs:children}} -``` - -```html -
    -
  1. First Item
    2. -
  2. Second Item
    3. -
  3. Third Item
    4. -
-``` - -### Fragmentos - -VocΓͺ tambΓ©m pode "agrupar" elementos envolvendo-os em `Fragment {}`. Isso nΓ£o criarΓ‘ nenhum elemento adicional. - -> Nota: vocΓͺ tambΓ©m pode renderizar vΓ‘rios elementos no nΓ­vel superior de `rsx!` e eles serΓ£o agrupados automaticamente – nΓ£o hΓ‘ necessidade de um `Fragment {}` explΓ­cito lΓ‘. - -```rust, no_run -{{#include ../../../examples/rsx_overview.rs:fragments}} -``` - -```html -

First Item

-

Second Item

-a group -of three -items -``` - -### Atributos - -Os atributos tambΓ©m sΓ£o especificados dentro dos colchetes `{}`, usando a sintaxe `name: value`. VocΓͺ pode fornecer o valor como um literal no RSX: - -```rust, no_run -{{#include ../../../examples/rsx_overview.rs:attributes}} -``` - -```html -Log In -``` - -> Nota: Todos os atributos definidos em `dioxus-html` seguem a convenção de nomenclatura snake_case. Eles transformam seus nomes `snake_case` em atributos `camelCase` do HTML. - -#### Atributos Personalizados - -Dioxus tem um conjunto prΓ©-configurado de atributos que vocΓͺ pode usar. O RSX Γ© validado em tempo de compilação para garantir que vocΓͺ nΓ£o especificou um atributo invΓ‘lido. Se vocΓͺ quiser substituir esse comportamento por um nome de atributo personalizado, especifique o atributo entre aspas: - -```rust, no_run -{{#include ../../../examples/rsx_overview.rs:custom_attributes}} -``` - -```html - Rust is cool -``` - -### Interpolação - -Da mesma forma que vocΓͺ pode [formatar](https://doc.rust-lang.org/rust-by-example/hello/print/fmt.html) Rust _strings_, vocΓͺ tambΓ©m pode interpolar no texto RSX. Use `{variable}` para exibir o valor de uma variΓ‘vel em uma _string_, ou `{variable:?}` para usar a representação `Debug`: - -```rust, no_run -{{#include ../../../examples/rsx_overview.rs:formatting}} -``` - -```html -
- Coordinates: (42, 0) -
ES
-
42
-
-``` - -### ExpressΓ΅es - -VocΓͺ pode incluir expressΓ΅es Rust arbitrΓ‘rias dentro do RSX, mas deve escapΓ‘-las entre colchetes `[]`: - -```rust, no_run -{{#include ../../../examples/rsx_overview.rs:expression}} -``` - -```html -DIOXUS -``` diff --git a/docs/guide/src/pt-br/describing_ui/special_attributes.md b/docs/guide/src/pt-br/describing_ui/special_attributes.md deleted file mode 100644 index 01bfe9b25..000000000 --- a/docs/guide/src/pt-br/describing_ui/special_attributes.md +++ /dev/null @@ -1,62 +0,0 @@ -# Atributos Especiais - -Enquanto a maioria dos atributos sΓ£o simplesmente passados para o HTML, alguns tΓͺm comportamentos especiais. - -## A Escotilha de Escape do HTML - -Se vocΓͺ estiver trabalhando com itens prΓ©-renderizados, modelos ou uma biblioteca JS, convΓ©m passar o HTML diretamente em vez de passar pelo Dioxus. Nesses casos, use `dangerous_inner_html`. - -Por exemplo, enviar um conversor de markdown para Dioxus pode aumentar significativamente o tamanho final do aplicativo. Em vez disso, vocΓͺ desejarΓ‘ prΓ©-renderizar sua remarcação para HTML e, em seguida, incluir o HTML diretamente em sua saΓ­da. Usamos essa abordagem para a [pΓ‘gina inicial do Dioxus](https://dioxuslabs.com): - -```rust, no_run -{{#include ../../../examples/dangerous_inner_html.rs:dangerous_inner_html}} -``` - -> Nota! Esse atributo Γ© chamado de "dangerous_inner_html" porque Γ© **perigoso** passar dados que vocΓͺ nΓ£o confia. Se vocΓͺ nΓ£o for cuidadoso, poderΓ‘ facilmente expor ataques de [cross-site scripting (XSS)](https://en.wikipedia.org/wiki/Cross-site_scripting) aos seus usuΓ‘rios. -> -> Se vocΓͺ estiver lidando com entradas nΓ£o confiΓ‘veis, certifique-se de higienizar seu HTML antes de passΓ‘-lo para `dangerous_inner_html` – ou apenas passe-o para um elemento de texto para escapar de qualquer tag HTML. - -## Atributos Booleanos - -A maioria dos atributos, quando renderizados, serΓ£o renderizados exatamente como a entrada que vocΓͺ forneceu. No entanto, alguns atributos sΓ£o considerados atributos "booleanos" e apenas sua presenΓ§a determina se eles afetam a saΓ­da. Para esses atributos, um valor fornecido de `"false"` farΓ‘ com que eles sejam removidos do elemento de destino. - -Portanto, este RSX nΓ£o renderizaria o atributo `hidden`: - -```rust, no_run -{{#include ../../../examples/boolean_attribute.rs:boolean_attribute}} -``` - -```html -
hello
-``` - -No entanto, nem todos os atributos funcionam assim. _Apenas os seguintes atributos_ tΓͺm este comportamento: - -- `allowfullscreen` -- `allowpaymentrequest` -- `async` -- `autofocus` -- `autoplay` -- `checked` -- `controls` -- `default` -- `defer` -- `disabled` -- `formnovalidate` -- `hidden` -- `ismap` -- `itemscope` -- `loop` -- `multiple` -- `muted` -- `nomodule` -- `novalidate` -- `open` -- `playsinline` -- `readonly` -- `required` -- `reversed` -- `selected` -- `truespeed` - -Para quaisquer outros atributos, um valor de `"false"` serΓ‘ enviado diretamente para o DOM. diff --git a/docs/guide/src/pt-br/getting_started/desktop.md b/docs/guide/src/pt-br/getting_started/desktop.md deleted file mode 100644 index 70f71aa1a..000000000 --- a/docs/guide/src/pt-br/getting_started/desktop.md +++ /dev/null @@ -1,40 +0,0 @@ -# Aplicativo de Γ‘rea de trabalho - -Crie um aplicativo de desktop nativo autΓ΄nomo que tenha a mesma aparΓͺncia em todos os sistemas operacionais. - -Os aplicativos criados com o Dioxus geralmente tΓͺm menos de 5 MB de tamanho e usam os recursos existentes do sistema, para que nΓ£o consumam quantidades extremas de RAM ou memΓ³ria. - -Exemplos: - -- [Explorador de arquivos](https://github.com/DioxusLabs/example-projects/blob/master/file-explorer) -- [Scanner WiFi](https://github.com/DioxusLabs/example-projects/blob/master/wifi-scanner) - -[![Exemplo do Explorador de Arquivos](https://raw.githubusercontent.com/DioxusLabs/example-projects/master/file-explorer/image.png)](https://github.com/DioxusLabs/example-projects/tree /master/file-explorer) - -## Suporte - -O desktop Γ© uma plataforma poderosa para o Dioxus, mas atualmente Γ© limitado em capacidade quando comparado Γ  plataforma Web. Atualmente, os aplicativos de desktop sΓ£o renderizados com a biblioteca WebView da prΓ³pria plataforma, mas seu cΓ³digo Rust estΓ‘ sendo executado nativamente em um _thread_ nativo. Isso significa que as APIs do navegador _nΓ£o_ estΓ£o disponΓ­veis, portanto, renderizar WebGL, Canvas, etc. nΓ£o Γ© tΓ£o fΓ‘cil quanto a Web. No entanto, as APIs do sistema nativo _sΓ£o_ acessΓ­veis, portanto, streaming, WebSockets, sistema de arquivos, etc., sΓ£o todas APIs viΓ‘veis. No futuro, planejamos migrar para um renderizador DOM personalizado baseado em webrenderer com integraçáes WGPU. - -O Dioxus Desktop Γ© construΓ­do a partir do [Tauri](https://tauri.app/). No momento, nΓ£o hΓ‘ abstraçáes do Dioxus sobre atalhos de teclado, barra de menus, manuseio, etc., entΓ£o vocΓͺ deve aproveitar o Tauri - principalmente [Wry](http://github.com/tauri-apps/wry/) e [ Tao](http://github.com/tauri-apps/tao)) diretamente. - -## Criando um projeto - -Crie uma nova caixa: - -```shell -cargo new --bin demo -cd demo -``` - -Adicione o Dioxus com o recurso `desktop` (isso irΓ‘ editar o `Cargo.toml`): - -```shell -cargo add dioxus -cargo add dioxus-desktop -``` - -Edite seu `main.rs`: - -```rust, no_run -{{#include ../../../examples/hello_world_desktop.rs:all}} -``` diff --git a/docs/guide/src/pt-br/getting_started/hot_reload.md b/docs/guide/src/pt-br/getting_started/hot_reload.md deleted file mode 100644 index 447169055..000000000 --- a/docs/guide/src/pt-br/getting_started/hot_reload.md +++ /dev/null @@ -1,31 +0,0 @@ -# Configurando o Hot Reload - -1. O recarregamento em tempo-real (_hot reload_) permite tempos de iteração muito mais rΓ‘pidos dentro de chamadas 'rsx', interpretando-as e transmitindo as ediçáes. -2. Γ‰ ΓΊtil para alterar o estilo/layout de um programa, mas nΓ£o ajudarΓ‘ na alteração da lΓ³gica de um programa. -3. Atualmente, o cli implementa apenas o _hot-reload_ para o renderizador da web. - -# Configurar - -Instale o [dioxus-cli](https://github.com/DioxusLabs/cli). -Habilite o recurso de _hot-reload_ no dioxus: - -```toml -dioxus = { version = "*", features = ["hot-reload"] } -``` - -# Usage - -1. Execute: - -``` -dx serve --hot-reload -``` - -2. alterar algum cΓ³digo dentro de uma macro `rsx` -3. abra seu `localhost` em um navegador -4. salve e observe a mudanΓ§a de estilo sem recompilar - -# Limitaçáes - -1. O interpretador sΓ³ pode usar expressΓ΅es que existiam na ΓΊltima recompilação completa. Se vocΓͺ introduzir uma nova variΓ‘vel ou expressΓ£o na chamada `rsx`, ela acionarΓ‘ uma recompilação completa para capturar a expressΓ£o. -2. Componentes e Iteradores podem conter cΓ³digo de Rust arbitrΓ‘rio e acionarΓ£o uma recompilação completa quando alterados. diff --git a/docs/guide/src/pt-br/getting_started/index.md b/docs/guide/src/pt-br/getting_started/index.md deleted file mode 100644 index 2ee8fe89f..000000000 --- a/docs/guide/src/pt-br/getting_started/index.md +++ /dev/null @@ -1,72 +0,0 @@ -# Introdução - -Esta seção irΓ‘ ajudΓ‘-lo a configurar seu projeto Dioxus! - -## PrΓ©-requisitos - -### Editor - -O Dioxus se integra muito bem com o [plugin Rust-Analyzer LSP](https://rust-analyzer.github.io) que fornecerΓ‘ realce de sintaxe apropriado, navegação de cΓ³digo, _folding_ e muito mais. - -### Rust - -VΓ‘ para [https://rust-lang.org](http://rust-lang.org) e instale o compilador Rust. - -Γ‰ altamente recomendΓ‘vel ler o [livro oficial do Rust](https://doc.rust-lang.org/book/ch01-00-getting-started.html) _completamente_. No entanto, nossa esperanΓ§a Γ© que um aplicativo Dioxus possa servir como um Γ³timo primeiro projeto Rust. Com Dioxus, vocΓͺ aprenderΓ‘ sobre: - -- Manipulação de erros -- Estruturas, Funçáes, Enums -- Closures -- Macros - -NΓ³s empenhamos muito cuidado para tornar a sintaxe do Dioxus familiar e fΓ‘cil de entender, para que vocΓͺ nΓ£o precise de conhecimento profundo sobre _async_, _lifetime_ ou _smart pointers_ atΓ© que vocΓͺ realmente comece a criar aplicativos Dioxus complexos. - -### DependΓͺncias EspecΓ­ficas da Plataforma - -#### Windows - -Os aplicativos da Γ‘rea de trabalho do Windows dependem do WebView2 – uma biblioteca que deve ser instalada em todas as distribuiçáes modernas do Windows. Se vocΓͺ tiver o Edge instalado, o Dioxus funcionarΓ‘ bem. Se vocΓͺ _nΓ£o_ tiver o Webview2, [vocΓͺ poderΓ‘ instalΓ‘-lo pela Microsoft](https://developer.microsoft.com/en-us/microsoft-edge/webview2/). MS oferece 3 opçáes: - -1. Um pequeno _bootstrapper_ "evergreen" que buscarΓ‘ um instalador do CDN da Microsoft -2. Um pequeno _instalador_ que buscarΓ‘ o Webview2 do CDN da Microsoft -3. Uma versΓ£o vinculada estaticamente do Webview2 em seu binΓ‘rio final para usuΓ‘rios offline - -Para fins de desenvolvimento, use a Opção 1. - -#### Linux - -Os aplicativos Webview Linux requerem WebkitGtk. Ao distribuir, isso pode ser parte de sua Γ‘rvore de dependΓͺncia em seu `.rpm` ou `.deb`. No entanto, Γ© muito provΓ‘vel que seus usuΓ‘rios jΓ‘ tenham o WebkitGtk. - -```bash -sudo apt install libwebkit2gtk-4.0-dev libgtk-3-dev libappindicator3-dev -``` - -Ao usar o Debian/bullseye, o `libappindicator3-dev` nΓ£o estΓ‘ mais disponΓ­vel, pois foi substituΓ­do por `libayatana-appindicator3-dev`. - -```bash -# on Debian/bullseye use: -sudo apt install libwebkit2gtk-4.0-dev libgtk-3-dev libayatana-appindicator3-dev -``` - -Se vocΓͺ tiver problemas, certifique-se de ter todo o bΓ‘sico instalado, conforme descrito nos [documentos do Tauri](https://tauri.studio/v1/guides/getting-started/prerequisites#setting-up-linux). - -#### Mac OS - -Atualmente – tudo para macOS estΓ‘ integrado! No entanto, vocΓͺ pode encontrar um problema se estiver usando o Rust **nightly** devido a alguns problemas de permissΓ£o em nossa dependΓͺncia do `Tao` (que foram resolvidos, mas nΓ£o publicados). - -### ExtensΓ΅es do Cargo Sugeridas - -Se vocΓͺ quiser manter seu fluxo de trabalho tradicional como `npm install XXX` para adicionar pacotes, vocΓͺ pode querer instalar o `cargo-edit` e algumas outras extensΓ΅es `cargo` interessantes: - -- [cargo-expand](https://github.com/dtolnay/cargo-expand) para expandir chamadas de macro -- [Γ‘rvore de carga](https://doc.rust-lang.org/cargo/commands/cargo-tree.html) – um comando de carga integrado que permite inspecionar sua Γ‘rvore de dependΓͺncia - -## Guias de configuração - -Dioxus suporta mΓΊltiplas plataformas. Dependendo do que vocΓͺ quer, a configuração Γ© um pouco diferente. - -- [Web](web.md): rodando no navegador usando WASM -- [Server Side Rendering](ssr.md): renderiza Dioxus HTML como texto -- [Desktop](desktop.md): um aplicativo autΓ΄nomo usando o webview -- [Celular](mobile.md) -- [Terminal UI](tui.md): interface grΓ‘fica baseada em texto do terminal diff --git a/docs/guide/src/pt-br/getting_started/mobile.md b/docs/guide/src/pt-br/getting_started/mobile.md deleted file mode 100644 index 66a17272b..000000000 --- a/docs/guide/src/pt-br/getting_started/mobile.md +++ /dev/null @@ -1,76 +0,0 @@ -# Aplicativo mΓ³vel - -Crie um aplicativo mΓ³vel com Dioxus! - -Exemplo: [Aplicativo Todo](https://github.com/DioxusLabs/example-projects/blob/master/ios_demo) - -## Suporte - -Atualmente, a plataforma mΓ³vel Γ© o destino de renderizador menos suportado para o Dioxus. Os aplicativos mΓ³veis sΓ£o renderizados com o WebView da plataforma, o que significa que animaçáes, transparΓͺncia e widgets nativos nΓ£o estΓ£o disponΓ­veis no momento. - -AlΓ©m disso, o iOS Γ© a ΓΊnica plataforma mΓ³vel compatΓ­vel. Γ‰ possΓ­vel obter o Dioxus rodando no Android e renderizado com WebView, mas a biblioteca de janelas do Rust que o Dioxus usa – tao – atualmente nΓ£o suporta Android. - -Atualmente, o suporte mΓ³vel Γ© mais adequado para aplicativos no estilo CRUD, idealmente para equipes internas que precisam desenvolver rapidamente, mas nΓ£o se importam muito com animaçáes ou widgets nativos. - -## Configurando - -A configuração com dispositivos mΓ³veis pode ser bastante desafiadora. As ferramentas aqui nΓ£o sΓ£o Γ³timas (ainda) e podem precisar de alguns _hacks_ para fazer as coisas funcionarem. O macOS M1 Γ© amplamente inexplorado e pode nΓ£o funcionar para vocΓͺ. - -Vamos usar `cargo-mobile` para construir para dispositivos mΓ³veis. Primeiro, instale-o: - -```shell -cargo install --git https://github.com/BrainiumLLC/cargo-mobile -``` - -E, em seguida, inicialize seu aplicativo para a plataforma certa. Use o modelo `winit` por enquanto. No momento, nΓ£o hΓ‘ modelo "Dioxus" no cargo-mobile. - -```shell -cargo mobile init -``` - -NΓ³s vamos limpar completamente as `dependΓͺncias` que ele gera para nΓ³s, trocando `winit` por `dioxus-mobile`. - -```toml - -[package] -name = "dioxus-ios-demo" -version = "0.1.0" -authors = ["Jonathan Kelley "] -edition = "2018" - - -# leave the `lib` declaration -[lib] -crate-type = ["staticlib", "cdylib", "rlib"] - - -# leave the binary it generates for us -[[bin]] -name = "dioxus-ios-demo-desktop" -path = "gen/bin/desktop.rs" - -# clear all the dependencies -[dependencies] -mobile-entry-point = "0.1.0" -dioxus = { version = "*" } -dioxus-desktop = { version = "*" } -simple_logger = "*" -``` - -Edite seu `lib.rs`: - -```rust, no_run -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(app); -} - -fn app(cx: Scope) -> Element { - cx.render(rsx!{ - div { - "hello world!" - } - }) -} -``` diff --git a/docs/guide/src/pt-br/getting_started/ssr.md b/docs/guide/src/pt-br/getting_started/ssr.md deleted file mode 100644 index ebf478163..000000000 --- a/docs/guide/src/pt-br/getting_started/ssr.md +++ /dev/null @@ -1,110 +0,0 @@ -# Renderização por Servidor - -O Dioxus 'VirtualDom' pode ser renderizado por servidor. - -[Exemplo: Dioxus DocSite](https://github.com/dioxusLabs/docsite) - -## Suporte a Multitarefas - -O Dioxus `VirtualDom`, infelizmente, atualmente nΓ£o Γ© `Send`. Internamente, usamos um pouco de mutabilidade interior que nΓ£o Γ© _thread-safe_. Isso significa que vocΓͺ nΓ£o pode usar Dioxus facilmente com a maioria dos frameworks da web como Tide, Rocket, Axum, etc. - -Para resolver isso, vocΓͺ deve gerar um `VirtualDom` em seu prΓ³prio thread e se comunicar com ele por meio de canais. - -Ao trabalhar com frameworks web que requerem `Send`, Γ© possΓ­vel renderizar um `VirtualDom` imediatamente para uma `String` – mas vocΓͺ nΓ£o pode manter o `VirtualDom` em um ponto de espera. Para SSR de estado retido (essencialmente LiveView), vocΓͺ precisarΓ‘ criar um _pool_ de `VirtualDoms`. - -## Configurar - -Se vocΓͺ quer apenas renderizar `rsx!` ou um VirtualDom para HTML, confira os documentos da API. Γ‰ bem simples: - -```rust, no_run -// We can render VirtualDoms -let mut vdom = VirtualDom::new(app); -let _ = vdom.rebuild(); -println!("{}", dioxus::ssr::render_vdom(&vdom)); - -// Or we can render rsx! calls directly -println!( "{}", dioxus::ssr::render_lazy(rsx! { h1 { "Hello, world!" } } ); -``` - -No entanto, para este guia, vamos mostrar como usar Dioxus SSR com `Axum`. - -Certifique-se de ter o Rust and Cargo instalado e, em seguida, crie um novo projeto: - -```shell -cargo new --bin demo -cd app -``` - -Adicione o Dioxus com o recurso `ssr`: - -```shell -cargo add dioxus -cargo add dioxus-ssr -``` - -Em seguida, adicione todas as dependΓͺncias do Axum. Isso serΓ‘ diferente se vocΓͺ estiver usando um Web Framework diferente - -``` -cargo add tokio --features full -cargo add axum -``` - -Suas dependΓͺncias devem ficar mais ou menos assim: - -```toml -[dependencies] -axum = "0.4.5" -dioxus = { version = "*" } -dioxus-ssr = { version = "*" } -tokio = { version = "1.15.0", features = ["full"] } -``` - -Agora, configure seu aplicativo Axum para responder em um _endpoint_. - -```rust, no_run -use axum::{response::Html, routing::get, Router}; -use dioxus::prelude::*; - -#[tokio::main] -async fn main() { - let addr = std::net::SocketAddr::from(([127, 0, 0, 1], 3000)); - println!("listening on http://{}", addr); - - axum::Server::bind(&addr) - .serve( - Router::new() - .route("/", get(app_endpoint)) - .into_make_service(), - ) - .await - .unwrap(); -} -``` - -E, em seguida, adicione nosso _endpoint_. Podemos renderizar `rsx!` diretamente: - -```rust, no_run -async fn app_endpoint() -> Html { - Html(dioxus_ssr::render_lazy(rsx! { - h1 { "hello world!" } - })) -} -``` - -Ou podemos renderizar `VirtualDoms`. - -```rust, no_run -async fn app_endpoint() -> Html { - fn app(cx: Scope) -> Element { - cx.render(rsx!(h1 { "hello world" })) - } - let mut app = VirtualDom::new(app); - let _ = app.rebuild(); - - Html(dioxus_ssr::render_vdom(&app)) -} -``` - -E Γ© isso! - -> VocΓͺ pode notar que nΓ£o pode manter o VirtualDom em um ponto de espera. Dioxus atualmente nΓ£o Γ© ThreadSafe, entΓ£o _deve_ permanecer no _thread_ que iniciou. Estamos trabalhando para flexibilizar essa exigΓͺncia. diff --git a/docs/guide/src/pt-br/getting_started/tui.md b/docs/guide/src/pt-br/getting_started/tui.md deleted file mode 100644 index ba4e2ecda..000000000 --- a/docs/guide/src/pt-br/getting_started/tui.md +++ /dev/null @@ -1,46 +0,0 @@ -# IU do terminal - -VocΓͺ pode construir uma interface baseada em texto que serΓ‘ executada no terminal usando o Dioxus. - -![Hello World screenshot](https://github.com/DioxusLabs/rink/raw/master/examples/example.png) - -> Nota: este livro foi escrito tendo em mente plataformas baseadas em HTML. VocΓͺ pode acompanhar a TUI, mas terΓ‘ que se adaptar um pouco. - -## Suporte - -O suporte Γ  TUI Γ© atualmente bastante experimental. AtΓ© o nome do projeto mudarΓ‘. Mas, se vocΓͺ estiver disposto a se aventurar no reino do desconhecido, este guia o ajudarΓ‘ a comeΓ§ar. - -## Configurando - -Comece criando um novo pacote e adicionando nosso recurso TUI. - -```shell -cargo new --bin demo -cd demo -cargo add dioxus -cargo add dioxus-tui -``` - -Em seguida, edite seu `main.rs` com o modelo bΓ‘sico. - -```rust, no_run -{{#include ../../../examples/hello_world_tui.rs}} -``` - -Para executar nosso aplicativo: - -```shell -cargo run -``` - -Pressione "ctrl-c" para fechar o aplicativo. Para mudar de "ctrl-c" para apenas "q" para sair, vocΓͺ pode iniciar o aplicativo com uma configuração para desativar o sair padrΓ£o e usar a raiz TuiContext para sair por conta prΓ³pria. - -```rust, no_run -{{#include ../../../examples/hello_world_tui_no_ctrl_c.rs}} -``` - -## Notas - -- Nosso pacote TUI usa flexbox para layout -- 1px Γ© a altura da linha de um caractere. Seu px CSS regular nΓ£o traduz. -- Se seu aplicativo entrar em pΓ’nico, seu terminal serΓ‘ destruΓ­do. Isso serΓ‘ corrigido eventualmente. diff --git a/docs/guide/src/pt-br/getting_started/web.md b/docs/guide/src/pt-br/getting_started/web.md deleted file mode 100644 index 47991b595..000000000 --- a/docs/guide/src/pt-br/getting_started/web.md +++ /dev/null @@ -1,75 +0,0 @@ -# Web - -Crie aplicativos de pΓ‘gina ΓΊnica (SPA) que sΓ£o executados no navegador com o Dioxus. Para rodar na Web, seu aplicativo deve ser compilado para WebAssembly e utilizar a `crate` `dioxus` com o recurso `web` ativado. - -Uma compilação do Dioxus para a web serΓ‘ aproximadamente equivalente ao tamanho de uma compilação do React (70kb vs 65kb), mas carregarΓ‘ significativamente mais rΓ‘pido devido ao [StreamingCompile do WebAssembly](https://hacks.mozilla.org/2018/01/making-webassembly-even-faster-firefoxs-new-streaming-and-tiering-compiler/). - -Exemplos: - -- [TodoMVC](https://github.com/DioxusLabs/example-projects/tree/master/todomvc) -- [ECommerce](https://github.com/DioxusLabs/example-projects/tree/master/ecommerce-site) - -[![Exemplo de TodoMVC](https://github.com/DioxusLabs/example-projects/raw/master/todomvc/example.png)](https://github.com/DioxusLabs/example-projects/blob/master /todomvc) - -> Nota: Devido Γ s limitaçáes do Wasm, nem todos as `crates` funcionarΓ£o com seus aplicativos da web, portanto, vocΓͺ precisarΓ‘ certificar-se de que suas `crates` funcionem sem chamadas de sistema nativas (temporizadores, IO, etc.). - -## Suporte - -A Web Γ© a plataforma de destino com melhor suporte para Dioxus. - -## Ferramentas - -Para desenvolver seu aplicativo Dioxus para a web, vocΓͺ precisarΓ‘ de uma ferramenta para construir e servir seus itens. Recomendamos usar [trunk](https://trunkrs.dev) que inclui um sistema de compilação, otimização Wasm, um servidor dev e suporte para SASS/CSS: - -```shell -cargo install trunk -``` - -Certifique-se de que o destino `wasm32-unknown-unknown` esteja instalado: - -```shell -rustup target add wasm32-unknown-unknown -``` - -## Criando um Projeto - -Crie uma nova caixa: - -```shell -cargo new --bin demo -cd demo -``` - -Adicione o Dioxus como uma dependΓͺncia com o recurso `web`: - -```bash -cargo add dioxus -cargo add dioxus-web -``` - -Adicione um `index.html` para o `Trunk` usar. Certifique-se de que seu elemento "mount point" tenha um ID de "main": - -```html - - - - - - - -
- - -``` - -Edite seu `main.rs`: - -```rust, no_run -{{#include ../../../examples/hello_world_web.rs}} -``` - -E para servir nosso aplicativo: - -```bash -trunk serve -``` diff --git a/docs/guide/src/pt-br/images/compiletimecorrect.png b/docs/guide/src/pt-br/images/compiletimecorrect.png deleted file mode 100644 index 8fab7509fe6321c957b25b77ee2927cd3c24d787..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 196054 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

5^Y|FMQCq&bZ)=_Yrj(Dd^(qsz#QD70c-N-N_z< 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 Xr-Fvw74!rH_)@u~sff9F-S58ufbu*v diff --git a/docs/guide/src/pt-br/images/component_tree.png b/docs/guide/src/pt-br/images/component_tree.png deleted file mode 100644 index d9692407350138e0b7597e8705e33f58a463357a..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 3724 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 diff --git a/docs/guide/src/pt-br/images/diffing.png b/docs/guide/src/pt-br/images/diffing.png deleted file mode 100644 index 4c243bc759085f24ada3be039cb763e1d59fc2f5..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 23486 zcmZU)b8u(R^F18fwz)|*wr$(CZTl75wr$(aCfV4woo7Gq-(TN)s;f>--RYj&(^a?Y z%$+()l44@5+CV_+qCyI43LG*O|HkymV8cL=gZT+$qRcNp-?BXg!6T%&(Ik>eE^tqL z{wG(TdyBO6MG}c1pVgfJuNNkch6q0+8}Ka=3+hM*P1-vWaseNcZ9HqKEQrNhKxUnzr3;1d)(Y z`;~V_m^q;57q`eHNweJ8HaP~o=fP5#Bc04J+lOHB1ygX)FP9T^nt2l1PqkXs*jnQXi-?Fwk|pL3fCbNTZton2%*#yw{Akjs zmbhk{=TtDNhwF(w=3$t0Ich_vo=~(VO?2%;)PND42PXoF1IR4X_gKm@LVx<2s))&w zXwtgb3x5)cBojAEU7|13cu#pV*T4mZ)*wS|H>z4=7)L`4jM_#D$O&d{C7k8(DA`KN zzJBsTdvB7EK!(>ZGSL?NHJWWzD=^&Xn7Jo#<03rI4!&&{54s!{Q+H5!wR9&5d&#|$ zcfQh|^8T;gq)KF)nL>GXdKOH}WAr1OXpKkmYU4OtnIGV4vtuqjwl8}gIy-gt7GF8| zRyxaIo@mQGSe=k&{(V2M3b6E{L(I#LTH8y>xzMV1BHqVuz4*&v=Ju_+{MZra+k$K_ z)bfV`L)(y>Coe|76y#<4m;AXV6X?tE&9qOI)?c>9p(mF^Cn*!B-cQvT!}s;vhi?zv zgi9Wpy9|H6o*&a*P3!3o`5&Yx>TWCSmCX8~KK|a1r-!Vs?<~NrhbuS-9G~jL;n1G&=+@;F2UEnuivu$(>ZF` z6uBw>Kb|kL!`;H}zk69`6kGQm=#gnYzxQBcHN}2myzRs-_mrGFEK}r7_UUi?qp}h< zPaE`n}zNePCM}lX-eJoZL~fV<84~KwN)to z$r<%NPoW$4TWykz)SMNgql@76m`uR31f%j|T zm9nW+KP;w!==*xxc7A<)ckztW^5FmGbx=*Ksn+7$t zq33vu(NVl_5m{0VOGi?DN*1@ThNS{F_-d!-A#42dz#jPtmPI2*s(cn}xA8XZ#+%Wa z3A0r#;Y0qCSgFXwUMM$40vo@SFnP$Vy0=FsUp_r)WEiKZdN(3<#CzaE+b9-i%8#c- z-9P!VHg?L$FJl8p<#|vFPp<@0pTwO(GYA5V7;k&-hz%DC%cutUpGDOgex?EnjWW)q z8+K(B8f?bM&^7$dr=qDvA->i1NmB3WP(??WP$H=_PcYDMPD#X^U+R1@egI~B zc`lRTQ0)V|Q-0vny$X*&cmV_XXk-`+(04iBi{|5cJd5CIMxD@9kz+k>@78#=>wi|Z zB~}OaooqmsjFfe~aT!}+)p#xE=FHLi3xT06o);rY0{%QNHWF08%p6Wxtr$4!#f(FF zsFio+qS9)Zub{Mrs)1~Wm&4fN6>Ggq&9JIv9FDmwR?lyU$IFzJ?>um{8;7&Jl4j9= zv^)1&|FNF5S>y0DIf|V@=Dz%hP$vg(#XbYwXo=QQB4p227=~X7$)(=3@HePkCyQY& zrii;#jj}%}y_7v^8Tx@G3VD5HQY$C7^$jz{$SM($Pu}gVjr0H=eljGy=t#bQL#rrr zGW*5Z2iQw#V=DtCZ|}zDfxpwTXJvU1Vs#_PmBBJ0_vzP;FGS6RTX?B>CxB$+z>*yZt$qlUCS^Hf1#QxmakwiH~yjI_q3At|a+qbqM{uzRrL z6#X@Jfh=XVen~e;e_<0so>NL;>Vi^IqxMX5s3bC48h&h0?zg(3;?t3?M49GLC_Bu` z6~<3mCu?uJ@K;5cu$mcNxjL6!av^94FiS`6EZFhg zkBml}kgxcZ=QRwfIwKrE&KUz-HMi&xBis0pEuT=IWbw1|EM{J?#~)w1pQeAIp&DV^7uNzJvF zdi+A*uf0Dqt=#=pk2J%75!n46X8odL+o<+PJdIOsqa+HML=;_Hja^_^_F62<(3?^G z{xGaXW>s-Vrx?4uGw*d&r1sP7eIYHM&VM%8S2A+7q~AXHWuC@eg=dR}S8A?CFPsgB zTySZlNxeP^sG^)<1h^WxxLhfcE@6a+)be%WG4Mn=u1;x1%lT9AD68)xn-yCJ)(Vnt zl~Z$a7SdFKO;1AjEd%0ZE7mzEW)3waR|C>k=^==>Ee=S!i(PYja;=ym4d0<%e7 zz%=~d-WBcFPZNVt^k6k(5YE_~c(HQ$WZLb#VDdV9(V1}ZGmFZW4P3(5_w0Th7lxz> zaTN_!%H`~wrhj7YXF243^HsqoN)u-xH1qTzJH_XY5>#+4uNJGd<2p)FW`i?JEx#VrD-nHmxt&`N_Kx zAsD#wj==6$CJ5F-v?;TSQ1l=rV`3+kr}kz~UjtEQPdq?)QXIC3QWo}nRLTctPknUA zH@jx{D?={GTd!kV__*e=bLOf-HafXiCWHwmHXcdwIc3LBea?%@;t6N6JcYGj_s#~b z&X17HU3`R~%lK}fUoZkNjJAT0`&dtb%w70OQD*09?8$W~$IV@M#>V08#7>lH_G+6H zJZSc~1YL?qeL&s{W=?%1$ni+kuBBe7h!rCp_IFwdR-$9`sPtAdH({*~UWhF< z+bWe%5j=%DO8O>H$K~bIF!OES)p476u4dqlv{vptj_huJQ|~p6IDtBUXGI-Z+M7|W zHnm=3Iml7(Jv6cEz;4XE-HZ4JrDp)4fGYP1nxcS5P_|5b#8TO(+HzJXXEAqe#3f|q z=)z=cO39BVvQ=la7>_+xym`?$m{EUWwP`f83URxML-V7zuQ+2yRqV^8O9Eemh3OM( zFIoX<+E*#+i$IVMSCG$9Viun4E=Qpktv9q5hj0{y(Ek>dZ>Yv}->5g9DR_X1|F-jL zMdyK}9I2DTg9DlfU=$nBPzU~Qc9J_;cWl+sGI3ix?4ED+Jq<Vo(O79Dsy`1PmfU5!5$XX~4lScVt&3#Npa@RN84wgUPV! z{vtohv#Fcp_|VK>XQYkQ^#JfZT|DRTW4b%O-kV7GUPoA6BIw!mZo5_qb+{fCWrJ;# z$!1I6=o+ImzJ~Kf2|Z5)(n0beM)nb-%1p(DBN5K*y3P~hwtT{B?Pyss7Iy0M<~DNn z@N6Hg+HKw`#mPiF*&1R&gn$0vYJtw*N=%p>nhLBRYTM#P9+~;L+kcBGOPj#iAG@~s z=I3l$$%<7Wco84$=G#G$9IdDfQNc=MhDr6GwmF5voygxv{?fokYMhhOV_CQRK!5hU;nLlt4v=GT=k7%($hCJU5J1dzvuo2fJbV2<*6J~u#y$p? zFW65Vvu;LFaaABN7@@*`rQ?RJ##aeWZu^dsKGZ1e+QuK5hP@v=@pZ2}IIwH6N7pf) zDWsj%n@7k?z|?z8KTpc3!*MGLWNqv1@kVVL97-Dei=~IeVJIRj;n((DGi1F?QKsj| zgBLoZ+y~#`i?;DAhP6#9iPDjVXS1ka$1cS+`&{UH`Qcr36G7iTg@6gq;tiGTX} zQ;_0jfn@&?nR7rq%{Avf@P1v!*`W*qUtrs+F|%{~6&+!Al0pz(5&q z&Vh9?t!|^Mq(;dwupT4`2O%`YUAEA=41yOd_(kZbxrIQLwvmnU;^9zRRT0Q>EpT`v z?Mnf=7m^7C!i{$>yXmGdm%;r7;1vv%19a;f6}ks_!}6oR{wP@Fe90krAk8R|jz%}_ z5yDvk5szfk>!Y_&&K1`#^Y3cg%0kk}A=w|By7GqFHa8+KKkd;6MHG90UstSyCpz4& z5iyS^m}R6>hG&$CXE;^0pci;iDm=~h>Hs}pq{6NOUb7tsc^7wa&tuG^werR8oryi0&0s;`w2Z%; zXIUpSoY^s53Ao}LLoI~~E-*rzNFE&|hmG|kBG{k4>v{-nwE9HilHUzAm% zskt>3$FJDl(h_Su{C|F>h~L)h6ZAoWfQ)^71gmg&tFsUeNn|XVE|V}Wzp4NYt4=17 zc0yT?W~s0pUET*lrW=^dtRH=SDgLSx*sAWMXBbF&xziBzH4?A5M1#w8jDQeg)n_6o zKnP{!^Ns@*1kP|H9EVKc4Tb48R~D+*+zqB zG%{*KgRUMI#ucf?pn}^rOK+CV2H~N(a=yma@KQ9Rb%&_sXiBBRZjXr&y-jz^-l=X- zGk*3(Y6yv_CI*M1Cv|}9fKDc+WuQ*nsPT%)C3>evHD@xjIOzDKRFdS=oIs{5ke%qa z6`>6p%P!xaUQcvP#&0N(jJn{ml#n{dM(R{ZhYBloD4_`Qi7IYmS$KI6R-+8o7S`Cm4Ipv5pshW5J_ zY0OpBYoV`!w?i2)ym=Gch7)4Nl}GeLv6Kv=Iv{+_y>2H6AiTxhGJPc_Zp;>CI-d&1 z>b)i8;AOd@O@h%oCpaGVMRQ=?{Ju>hqpp z;;(DW=L@#$nUELHk`&bQtz66Q;)S;Rc$o2o21%WfDe{+NMO{&LPnMnSU=Zt-v z-**T5md?cw3?@>X>@s3*&HwQ#v=^C-HF|Zo+7^8%`ZR~pob~r4Yu5nxpxnfKnNDZ=vIwdx zZkh55e8QbuL^t{E5{uVM&gQE4nOle z_Oodkq?4;+B)vpL&}K+ak@_>~I%l&8x#ZrY8$nyV>=W~iPco)x#%5Q-33;RS?K;5D zk(#;bVOhN50i#2w-6^2OHeU1hXH(dHKY=I5!AhuK)1@i?VLRzSDDG%JxSr$T-J#|Y zsK!ux|VkZO1j zYITl(iu-HtNA2(eu%@_9KtAq4N=HOCU%Cg>#hoh9G&SJTFo*Yyl-=vIBW-0ZNv-@F z&`YGd>=4`{Z8`JyHWWVyZgm|izZtrGD3-MMOk_>reC`5cOcGsULXCtfAVK&*bR#TO z(@KMcKka1fIfnLT0Ns|m-rT4wz{wFE`>0|XhQmj3=7wB;uw5P-cco)^^+ENC>xY$Jqg4WHB5S}$+2`db&-=@`dSjC+pe8n`&uH$(pv)Ozd6Em{ku!J zG>5yoW`XGF`>2_F7@|e8pK_>kIABEew&u^`m(_AwZI{ob6A|RHJ|G|Ct}Geo)m*JHBhC# zV^*I{ok8n*%`C+ZfV->hW5q7L`Y%M`ZGrpE+W#IBX0qRCRR12?SXrE_N_x1J{Kraa z8}Qv=laR?zp%ueS1HoLLnewALy%OW$+<0HNx0=hGOF?+>z;Nxiz2Ob#Ae3#6Y)C-T zes;AWufTh5{rx(uL?%jp7c4;NkE&zKbqkZ>QO_w_Mcj80 z&Ox4@!u9+5zH6OHstPo_a`QRM@W_l)7uReW)+F5GyK12H^Y-kvd{8OQ*X&Yj`aVD` z`Vx^nJZ;(W`01u>+~)T97O|*HMM%uQuZV{`rEme2huuu2*kppO z-5*5tHZf#wYVmWj;!a5*On|n75HM2IBvV6eq{Z;6`O>14;{d2US8QOfI?$1@=t zw%EqX@(6ux$SL{fFPrmfEq+98PPl*`9gflsFuC7iliL)5R$17nb>@+OY%=kF)5w7T z#=j0fsMvBU3*hSVa@wpjrmNiAN;2teZ{N?QcBMG|eYYXC;^of1nUkaIP*(rYeNF8& z3In4kCxa02j;j1SX7PT$myo~Dzk{?z{ROP_wo%Da7fw5ays`6a12Xuz0P0kQoS(7NIV%^_4!w^6^G;&!l*`(Gk6QqhPk3ALKRIY5f& zT<`)HP{hKw2Y&C<*w#V`rMfYrCJEg?7l>*HkkV@jk0oH%7q;;6MdUlC9nh7gaKNuAt&7UxL$L$Xkz$2|RB*EDAI&hhUvp zGz*3&Z6K*65IRh|9*&M2Af_WCQ1;J-fnCIiwqVheIL88(bJ3LJ(uPn?1PI3x86-zc zE2Mu7Op%YcYLm{9wY&SlwDgy^5~Rv75Vj>Us7bLXRCEkuc5t!AtRNgzgu|lxe^Z9Y zU?w4=NYiqnm%?dE8sWlWOEwia@gy+)P*GGsq_jZ>E>4ZL?ID8are;|6^bE*65H-Sp ze={_LK+)Au!H##%%Ca&k<}`7Xh}^ozBu^8;p=IUxJEf^ezO0mf7Xc&)?c)HBU6OzP zJV4LPT~5eoj{Tx4U?7-^$WXdNkrMqRzes?i%ArDP_e97H63_|)M3q8>{uq#8luH0K z@=2(L3al8AVO79H85EGw2Ig6kBOs`PNO1C@00tH~QX-&eoX7|Yhawzk@MQaek=YTD z6iy^~00@-3ei0cmAPOTA;72%8B_I^W1d#ZMNU(Y4XbE76Vi6Pp67ocW86pyRqy!Yp zfQV!X5Z2%b76B0nG7u7>LaJssVkKZC;slrgsK~;3rVt5m0TU4>AQI9^p$Q-o{M&fs zvw-kuDp+#R2$z0g5i&3Wl0pWTX#Zlc6A_XBfDDWu<3|E|HZnv4=0DJ*eNMp8L52Q* zfYz;XNlMpF0Ybv~AH3GLi(5I!fQkGEMz@BJam%~umD%#7QzdcXx~HMsf=032{KfTPF5{U_Zk^F&1O>Vys~LJQ4upmjhfBONUKs5a5S_2CKDc^{rsF!1I4)e>jCWF$xAXD58An#*};_1veVFpNi*7~6T=DySLL5<8{`q|Rp#O1m zm02FCVeIIYnQ$#=Hp(@MJSm85$@BYgMwCNw{c-V^)x{ky5b6D6_s96Fyf7+#S>;3& zHd~((VO?ceK*QPTUqYoLilXdH&`?H}c))Jf^e4;2NB!$@QEEg#Usc~i_#GBem!6IU znIr@13W!|&e@OeU8~SjpED@@|9>?~1eELySxrA+Spq*Qb0I|Ja?p_)ht9nb+ic~9j z{|aIwj;?EKs{bKer{(0d;`eTyvqbfMr8ARwkVx}_COx}O|I^SI@#BMa*NuAYM(XLQ zv;jf#JNqew7~J~2w){#Wz3TBkL+u1kb_;I4f{N=N;yV1vby)1|D zuO2(y$h`}}@E))}wwNrjnsfitfV;{9{`E7#w5MWcA8Ani@nSQu*x=@aluqul)r9?# z`=V49RUZG(>Zmp~zg3d-987{vWZo(z$%sA zCwjHIwdgEzW=E!i^2ZS>NTH~&V#~H0Uze?)y5TM~yc$npHGErV?6n#?5Onv#G3!LK zeDROi1EQWOk&UifzlGz?ygtQq4$Y`FTNkYESb+2JtwQy+@Y(+qTUBU;@MLxziZRQs zvwy-kiRdWHgtF904|74!K;=Ax?(Y3lff1PdH@37($=wjgYTW`7o+;KOhiNB5&zl%O zGp*4zZToMi%4(Hftcef#{KljRUafH;j|1 z^FrpWKDLHdHA;*yw=S=su4~5{ys~?vt^@iGLT}Sh%iS{|y%84BlFL7~TI4W;)4=$&kvw;pox}bfRJMkN6Ch}P(=S02@kb2&WcTQg)oV$6rv%H2 zl$K4dWJ7snRX+S^L}`5}n>(V#ieJ#!U<|jKespjeW(76IzhbV9TG%0qX$=ILkWK%o zK2Rx*{o!V?_HKUJ#~od)oNb20R0HpA*cgC>!pm&w+ih@2GM4aic}<}VJx4Neu-q6l zW`RV+%afa@i9{gm<^i#17#jP*cVF?a=GwwEx2Ie60t2oGScaKiiMQu1(L2F~wWldb zHpRwmp=(Q;XMWTUIPlrD>yvc?%nX+fV7IE<^EFXPAHBf0v+m7J4N=YeJoy_uX~Q8; z?LIPI!mYczKJCe1vt~WU%1<;_zDFTrdT_Pjm%R|TzWFg%(_f*POqulrsPp1wum z2j@zCpkR!FIrMHpU@H*4t0v{@!dB61Cf) zg0KKr2tTSrM)Md?54KzEYEg58UPI_eYN3O>gDxY(ui2=4BhG-Gj(dC?$1+=;O`O{h zzI+pd#EAL&*xWld7hToamk~^FBqx53nB$-8>rVw39*#i2!gMgcb~v z)S3K&_CtPZ4x?bQz-ptaB)cXOr{UHbkSPJAh5>kLPR;rUlKKF4#sZ02-XDR7qwe4w z_Y%x$GDnF)DRE*{$|MmJ+pnsl1;09lF2^(m_2yNA!%VZtqc@bpTtUj zBO;6b5c{Qxze5^sHv)M)z9cD7``_)B*@XC7cF@wO1p6uyR%WpLenA8 ztTvMO#=A8w<9@UUU&h)!^Ko2>!>#Z#VV20pOyKF1^vIo=Bi-1M+{UAWdp9vN%{PbRj6rIt`DM|0QBcj>oNv`S4+%paj0_eT`($@)P7Z2}s3e5s>~gMsKZSxSm5f3*9D8*1Nzcrlr<-C~m+gNSI;>w+osB!|uy5@LGwrV;_>1`8z+{ zCN7059P?Z0oi%d_8YVG;!QH?&-u#K`+h8SjT3E-uH{gn64EncNS}P(7X6~g*ubA_3 z49mcL?QF_osy$$9ayED;V2n#}*q>|~zrVy*0R=z1B^;{=g+==Bzp$&^ zo;em(2f&NC8ckoT_3y^mpX9H+greq5_5qlBZ^=+CjOAVRRS6w-v^)f&q$w*YE;=zW zwJrDQVp{5M^E7=gsqWUhX6%a=YB)&j{INx(`PIAZd7ql>Fh8j-=h!kmPW;Rkq@ZC} zh&X4eCgZCZ`#OU{B|Y$ix~$5oTK|fF#NS4@5{{LM^KQ!clP!7+sf}BqTz7sFgDbUT z$CoHV5PuF|#$F^ZDHDIBS~RUQwf$mD(9ur8<%4$$$CWD6Ou7Bb0A93&P*z3vm&cLU zM8?WLc+pkrOf1&w^N=qieHV%lGPNd*PhI8I7#!E%k{TNmQR=h!TSUd5;)6O>#|9eu zu}~Vy{G=l#z^dgBNGoYYA+>Re^2<#WT>;te`-Hfaij*o&SEQ2*E@O{+`VO%WmOpC> z?}Ah<+gqAt(D$77J%2z3R(}>k- zbL8i?0YxYF!0T z7MrF+Vq3z6nSZ30_$6v|Xe8R0ocI6zN;$(c7a7U~JNo49rpw+F)(jfM+(}?a+j%le zmL=M!N&+`uDK>xoIOIk-mink&=i{oOY)P&u+*qZsf2999n|H}Y!oMZI-n&6q2sV&f zxy~G>m8UA7PkHth$MjWM_(yH)hP^drEO<2VP%5w&DhdF zsq|Z2?6wMu_Dc3e&W{_T28n@jgn(@KSc9EZU<^69u+Z#!%Y4qyr;*W2#>B6V*{!Wd zlMEwD2x>RKKZjN)S2qzYY!OgDdo(dO=`!lKyMbJq`ZA;L)jhCYkI=B|+^{Q~-4pTI zdP|8J#IUL74h*b^t@`QVO#^a?(!)V5;c1|}rta?Uj6b7kEk%Iqjy}goeO)`LhGR^M zqzWe2;eqiA>urDE-HQkKCmNhW){q+ZxL=*Cc!OpHJ&wL&`XYF0aEKkgEipDA$Z6Fk zGg}7jrooOX3##@2_djoD%?#1X&Fgk2R&7Shizz-DUA{hEf3>@qU)Z;J`5PBS%+BBSTL;C-78@zj+9orcHBlQBsQhRbkm{@K8)LI;;{7k zU!qxnp-fR4t2CXCGL7eIc*-#PCRZ8_(*P4$q^q!*@;PSHnUS$~MbXv6P5V`bFJiOV z%&rFpO;y=d?3;^T){x!^PTiiWApRF7F0j8DNiuPvdvf_kU5JH~bg>nSatAy~ zq1TsA)VK3NR>0&}IjAe!Xg#lciQ-20f)u495(w@~R|11ymxNfTK|Q$%qK#kTL7Vx2 zk6H}T88Qs>;ydT^=hn}+N&|uV@(0q>7SZZ(r*gedtk$^bnZTmeAAzJLz!b@O(0pty zaDX)+cv`ElgQpFr(Du1wg#PV2&pdse8bJFq9ZHfU%+qsCuZV9Z;L10nk8R zuzZb@1RoTThK!Rl2WG6(+Ec{`FC#_8)BTXz4J>yOVE9w{g@)Y#rO zIqVU0m@}F_tO_>h^~VH^$L(-|r+}RbOBv!S&bX`!iI4{co`M@8+7c~r94<~C#I&4( z0t+X4qKED7Z+q7+n&yi1Zn_x$&0sE8UOVc$;2>MEO1bvRyCa=wZU7Rn3p&2E%SW~< zA2sI)FR*maL*!KF_|{0JvL++7(xF|^=Bog$lt-3Y5{XHVETm!6q(S1hAwkpO6gSXOq;7`ifufJyyoD>kYjFpq?x6|C_EKUzSm ze}0JOh@q`JH0FJgF^`Zza8Bx~uM9dhlk|XVxll5yz<9DSZIh4S*bVTQK7i9t=sOlz z5LZg(7M6<#PpZbFmo^OLFeDWoMaaOJPbSUeR@lIi_8Bb{_6gHLMZ?Ra3;+|6i}*K3=Oy&+wRzu8IMr6v6#n=w_@oez$br2HUYJd<-y%&;UR>C=qo|;gCzjJD6ya zqksl5=fA?&Z<1f1sfOsNnp?65gMzZ#9rFzPrL7dpqyu?WQ5O#PZrMlFkc$@94M%=J z1*VspDzVueDmV_K62muOY4*||zV=9>j>%8xKZMWG?!1#A!BC;O5J_}(MM6~s<7I{m zT+fuHxWk+#k$x66H&hDR;Y{5~&wz|sr8|)r*epMXks{WOp&<71S3BHx zSOFn`Ibt-!f&nxtBzT6{2AahT)WE4G4!Bj2l`hA9oA>{t20811_@YFrxFJa9(UGJ-Ku)yi`4EXgFdky!0FzHD4A9?}qNq#6 zb<_8xBeLrRO&9>44kzZVY)5(E|>2^Slcn>E;auj=uj zj0FcYNQa0OLd{kD0L{>pC5UIb8Q8EDvUwqzUj+f3#V8x~^e(pw7ce9;)z%z2w;yk~ z0_QFg6ZnFso2KWP$=7{%%C6xf$FE*L)1s2H5K@yCg2VN(luLM*yt zIYBD%z9P!~xcjFT0385f@zy`!pZ{HsCQIXRl!yL`?3l*_h%`9|c|><`PGv1)nr( zgnaHZ5=qA0%7ntG5R4%6ZlX}^0U@*rRJKtR_{8vLjy7s!FxyB}Fdr;%B~%T4xfX1) z@GPn$E-V07&}PX(&s3_8xCVlsdZHGLb6E@t&#SMalAc|JG(&87a8kY}Z*n^TFYzw9uSI9xd z+3)^|gNW>_nF;qchz_lqla`+p6kpqINUc%RU`T)j2Fa887dk% zj!%RO>q&IwtysV5me0H{<4rR7SWCD znsj`+9YlePaIJui!ockpoT4|<&fNv)ck!f=aR%sJ8lQqm--dQc)4hZKy(5fz*UG`zO1}`HaD$5^%bS^NO8w0s`D?jyabh(xd-YsNXEq zqXf+BAnZ>jgT(5$X(FF_Iw6Cc-0du%c z9R2SFcZ(>Sq>H3%BLkZNQHA_2c<+8wpfr)2mqbV1Cz$Pt5C*{kC7eq;vIyw=b=4sp zg|jU~KzSA#pcrA9UH8*@S)n^Yn5#@|B`S6T>`@!#H7Xb3Du!ZKP3Qt z^bXGoHM(Iwjl3`&Yu)4b?kjq(&WtCSM(zV6NAY6^h?3JqwaH&N+M0;HScGvcZw8_FpfEB%e%?K@8xPkp4&wnMj=? z{wT=D8V6Rlf@62zF|Q^)Iq!31|39u+{qqSM_R%I8chfn+pX`?>^IhzVwf5OMxup^-Gw0E=@!s!!% z?Anf?>}>(6YRC+Cy$t>Xv)5Hdn%1n}9*Q4&#uEQyRU5GeLLh(`OUrh z@}^osj}_5fe}yzfy9nx&bvEMP;)uRAaXF5|Ip`C4xhE6fvw&u7ZmhZ$@f5C+-pA`R zSZ1d`zGofb(IjsV3&A&E8h!s$vIK}lexETP8Z7=w0n7NOVS#=}a6aVzQNPs%B1+Ta zs8T_($c&Q>aGwb5@rok5%|bs}-)aPM-@!ua>zL9gNepZ^XqTdma} z_ht@yL@`d0dcOmg!ATLB=cXTW`GA^~i*_yAJL8?%Lh(BA^MFk1GEPMCjstl3>LAr9 zN$z%~gp5Uag~tHx)R2iGtXMONp0LN4zmUK_`fdq%MK(y0e*qOW1V5aoFn-KXII+Ih z)+oNsNU0q8--YY|v;PaZ@EQAKorxaor3@z+GP3!c3#V^!Y`6 z^qA3h!P$MA-A{A2AR*=&&S`ZVAT0lRHB|hVp^6Un@{_WZ5d8G3YteT_G~>BSMd`I0 z79wYLB0Z1D2%A%*PMjg-UW^$$J>Tdq{izK7pZWv?8;a?+@4e6(iv~OW5To#rJ__6% zkd?lm5kdm`vz&&l41nwY=thrvI?s9toGBNU`BPP&Kc6oebTYomujr`n81D7g`}<9m$a!O`KFc=snb6G9*5IRyXfNyC7-i}8z# z2*LUU&0HZ$)e9DB9ZwX@>(a)8XLrZ!)Ev9}V~+B}GulZO?v?oQ7s%+k^V%2X<#adB zJNzcarS31w4?#+L}HYhNzLQh1q3;4?3-iZ4cvulDKY{Y+Si-WN7ZLO@2Lb~Qi z-(pb^G-BS3yIWhBLe#q0i4Ct;#Bo@Fyh^+uYW2?C+Y=uBJYvP(M>bsjr zWX0((`d_S?i?}@k;VagSg7VY&GFeFVn@$>HkC?v~8IC zMi-psr8BV1m|DpT)aqI?e9cF#8fIS6)xVA!gYU-LFqi2GQ6@v;q*u;^Dd%rPG_B)f zm#ebG)dtgOhJf{`}5O;DSYM822F)TGVI{Sr5ZWUf^ucYq`twItsGE$cvF; zqmq1}$*IWO-5mPGn{lhPH43DicY*v*vEZ>Ws~j_N%F|JE+8?q(rNe;A$AoyrB691s z6pWT*CDYyyOO$e}7~#nKn{VhNuJE50W0eI>gIp(E!peo}TWLqpC6jTljE;3gpUaG6 zXQ$9|$uqW4ISTsa+Fn+X!lyW&I$A`!uUl;4Y$Sxx-vm(3ghK;lGvy-T-t*W-m**bd zu=H_T?z8|UxK#SbMO)=9s&FX=nxA_;Qf>#!+hU#H(CP_8v0~t&I*p6}o-F^zp$mMS&1t*f6wPR`WJt#%<qicheuSraL5I^ZgTth)I~a z;F*4&q31Nnwp%7m%0knJ7>JEE4gLH@&&iN&x9@$U-t$G8K23jC;p;49Zia5V%D7h^ zq#0>mZ>%xmZ!ctSfEHKPhKtQzq{@Yet7CfaK+l=04tY?yeJzFG8g6+y>0bLbrr{#g zfO=pm|D zxa0Jiq*Qa^>p+=x6i1ttYF9&AI*sOhVmhNb(jpit?G{xIYaB`i1=K)+i4OQ#})nM+|a#lbgNvy&p1;n=l*6Y-xa<%aIKF64s8($Qk* z2i+%)Em^a>I=tN-C#0r&R`PZ#C|;T-b|yFpG=cuIaQl7dL7^v3Qj2W`?S%} zb_7M+J^8j>r*)}hg1kn1-w51V)PxT@$@qLC+ducWIwq_t^!O|-CIai7psy(>;z=p9 z3x})KOfv>gp`BYboo()UG)ituV>mFK?u?ev`us)(ct=#tsb%1d%2>Kfe56ga*2RM> z4d3+G_y|DP!pYxoBJ)nitd?qTW8@c?W1~1&ZDb7P^FKL=z71}5=#z@83{yYasJu>> zv+HK-f(CF$bEHH^_IT&jquD@q=!mk1l=MoF^oKNU8mVy`ewDI2E9AS}v_xqrQcwo# zOL^9Pn!B%g?)29d-5IC6Dmfc9UiUUod51M?mW?;-n&icbR@@5JNzcUETKL4`nqVtt zQWTxF+!bOQ{OF5ZSNKHwZcl+n?{H%e7gja5uE7isqPBS=>euGb)Lz8QccjO;Q6+^+ zIY&KNPp%;WP4vi(3-xAG;ES5<1?f44(*PMRTx)Ed$xK5IxstA3*OBLIxfrl@>S8AA z7=nanScf;K)64~Etmbj05tA5SHJR2oZ*6n0|4MJW$Tb$Moq1ocUjDL^?R&95Ihb|U z!s)Xs#dOjiT4r-wugL4GIHBX)fF{OD6h!(BgR8QLuhZq^9ovI`HvF^F$fnjUTi=d5 zjwIRoYRzfk9M-bj)j4s)2d^jy)d6~hhjouwIt2`QU2_>bKa9{?I zP7wrzp-Vaj5s(yo#`~P-{LlU3dER{2?^nP2wbs5qn_74K>9QL*Dm=7|CN4ri z@ZB&~Az=Xwur_&4r;$5Gpx_P1)T&tA$Q=Gs zDn^SzIDh$oXL3G#8&4-8cpmd-VPjKqiL~yeiZm_YKig-imPN2C)@s;0ut%tN&Oh zw#%ESs0frpQ@%u&(5tv7MQ|NA6%gmPW=LMf_&MAEP-YIj4$83ayvnae2WuY~8fOLS zJ|L|F8$RVd8Mbj@&~ISWlC}5xNoP_sMaelfIOmahM8tugzbb-Zy}#w2XMZE_{_$!nN@p-Z%$W5tx120*rbV=! zNzUXBgZ&WN;%E)lpEyyc`Uc-5AY*35>tt`w_py zA`WNjf5H+62aZ&tgOj{T3~tc?ZYMmhqpsn%`9Or)mLdwD@sTbf*BxV`%{7|p0*YC? zN)l|SAPKqEF(@ek$q~&jII}6FYyTL4adHuS_E8_e%3aJDdHiC(Oom1Rpgcpo-XAp| zWw~-dwk)7cvF=rV2Fp1P|D=f;TJ1d0{nae~F_+_L_4iAdoc+GT(e1>LOq|?|id_-? zCX^E`NWfr-R6=hLWh^fyRWGsk%LUyOg$Ts0ty)8uV~5O#OabRMJohp^9WQQToQ2k| zuT{8DS=Q}kRZ^1*!KH4u2wHAMySu+_$q_Cl)#CISCA$oYv-Gc&T`1p;Vq<629~Bm9 z{_|7Hk(vJokOBoX4QFq>{R>idL>}n`VTH=yuQ39O3xc?A6Pb~)<4J<(2FsH(@!6_a zw?*{K?lg8M+|pSeoVyrd{9$8?0){6rGzLUw30|)nj=TGZQ~k+t#BdEUr9RFvk}2% z_B066dL6V5wk@$TBBRoG-#v@bOT;ckzS&ZljDFxu;0s1(8Bkxg@f$8g%BL=}iMD6E zHoni+oJ*RBBiFgy&P>TcQd9>$mVD%97z?;ldfJQaM{#pMK+z%3KJ*z=eNdfYw7(s3 z@QKstrAFa3rPXH%A99Kdc+jm@F=6$|=$CAK4F?KJuxm()a`Rgu=_WX_tO@6Cu$txsMpT5Kls z#7}C8WM4ky9#8FjgzlkvOpPU87&MUh+TO@FGPW6XBie?XsCgNMWU(5-#shlf95L@Es#ik^v2GX{a5@cWa^bNG!pB+( zR0-t~lrDy&p+LUL+uS$%iftW>nu<1EQ^s4w5D@nrJ#4hcx_pc*@|$)tjgf~|L#PcL zZF&HYa2RN>3<)q0(pR zAwZo^9Fv1a*b7(zJe;Z8lt(IH{+-EI8oo+2o)wB53?x5zt++1Amn5J z%JO(DWQO59_b=Hv85gq8CFGjU!1Hs;3;xpR$4!|mvUg9}kzoP_8_s;bjCHN`Cz-D8 z8qb9wS|F$!{*40~Hy#f}JVn*|{9mxqIVWV5e$Q~I5WyH8l)FDqTNF@9Ru-%bAVxdX zTU3?W)V2|P-rN<=p(-VcgS&2cR|*3Q0(V@U(so$rlWo;J1AIy0(@1dOLrQ-?v9ZQ|hf-cNMD$acSBhtEH;ul1{yXFvpmlCZAl#@%T> z*m#sVnhOUdF6(G-`l04s@%WU)9pY! zbn2=Ftch9ZYPe|Xrcd5-EgkN#cgEhUjmcY#P#U;?{N0^RHjZx_)AKr)D#2%guqTk=$isS4#KkyAcF zz0Y!cWX?YVSzS^i6n}h!Uj9V=;rTPvg%%gRtVZPL@&_#*vVKVdqzx)x3dxuDbRP`H z63tgO>53J&jSI4=Q;;*!fu0sWIZNwXOhu}$A7xrSGcps+gPO!UPdxS*Fz3y0V*PQN z%5a%cp_i{m%|T_Cp3cpa=YaQMv`{?(V`g8OP$DPUpO z4|W{SG^{@93#)w{nh;y$R3_8afJEIJ4A;n^WtW%#U=mGVO!kvfI83ZY3Sg}0DpZER zxR^YdM!CjH&W(hUFy{O0ox1P(<#i7AY0S>o+1!tq$0txLOb{O34HHAsdG8#Gu^lCT^-9?_=kqJoz?9t4&&< z+4R}(^PAPBAnGe(_!E9s=D7y_7kDDvo3e03)2avN1}7n{jl(ME-Y#UI-R7Tvq2H_F zqbxv*Y`bO~n6peiGpjzm80NMKX3G(ez%p+4W#f^ywc=T!HG=e1lp_!{ove`s{u=BT zc|cnxEp8&>D`nfeuS8C0BScz)RoPdDTdy9l6VrM|&K5x=j2JH+9+@g94@RCD5aw_1 z|KlzE2p?+4N8akF0H2+wP~nBV&2iPlOFu127zM2mCub@D9zw zh;RK}vKgz9%w^mnSW4r;uHHf(SAgxIX2u`WNCGNz2tBZIkK}#((&Qj3-z~5pH%G60!-N7Pd}<+D7eLTn-D6!Q%#`dN6&^M72(Ns#F0a*zuSN4{|~r; z#^H;0gNX-;li29#$E`O?qp#>h9REjLP&1Qu4kn8JWfwMK!C|Qz<#BG|0vq6tB~*>gi;6B{403Or{jazn z6fOn>TVgq6|2MmU#u4$SgK6tD67?$>leg=X)$|Do=v1i4bycaD|3MdpVBW|gSKeaP z|0OS=et|Y%o^HIveB!v`hOc4bs!jm?cNGlO{)_uKwdMpz3$z|6M_$4_4U0q^bkwNvYKNG*oH8g}?FJ?6;cwzX?Wh3DGq4 z0VmPc-w*)>kB>*f!EDq~{{&@H>vlz#7!@#~3-UMO`mFr^tuTaTgS@oYReij4aB*lO zc9&TJg>x4KUfMW!vC{EfNEWb?5g$k1DMUrd(5b|sIZ;E-{^(UqWU^5NW0{3PY-d2= zAeWY9S(8Lsv0BrHBQcCIkL0VD&}HANfhX zFVnAQui)ugoo(efK1F&eiylP>o8WbW2F2O)pc2B*cC%nH{K z`OcReU(`%T%Vov~?aK9*-Zz}Q8wb5O3OC`Cl;HEkWEok3J%n^mzTcAU*Yyx=@D$KC zTRnQyobaSFvr?Cf1_ON^XCQMZIl_=^rOs(k|Q@`V3PtoPtoGe0zKl=x7gccKw>$ zSU=p#f;jfo^>K7C+dkK;|CUHQ9E+SESiJe=vV1D?2w~g?Vb%J55RKk-61~jS%-sWV zw4ciEy%ywwQ20UMlpJts968x?b+Bu2uMZ-e(UrT7VYls`yA(6n%BUX)4gKm>BWc#C z5B}!TvWDve&XRMjSq{zRm^8?LM58?rYx)eE2que-o*`qXms9Pd{Nawpwh2HGz|q$O zg1^71Cjt&kT|-}M7%NH-{`zg1X*q&}4Dx-cS0=}YQ#%kccDSyv;KJ$-W1ryV1D|pA z?tAmqMN-o~Gv6@JZbQ5iZ`X16;>HOlvU!l$%sn}4WC9;NQxW~EZ8W~RC|kDgKC>=@ zOk&{4Ia7G6dJkLiwH421@FM*d_gjw{kQoGlS->HYkPl32j4O>PC6Wo7Ajt<^_7L&rwF0a~$foTmhEe%UYw?y`+~@Sz$4+T>{b8|cNUHzym=Tvh?k zL)r4@sST+y})S)ecq{fFJH%j#;f(El4UDLzbqh1gu z`F-3k0g9h)n$c^@zG~=X{5}%>sW{44V?I+W#lu^8B+rB^UkF}M6)l(c$|)HR_|@MG ztzW!5J?@7%HJNMX3qj$*b>%7|9)I|a8UNC3R(o0m81c=4WbarwXRO`0P-~|8!EDvW z7e2AUT4fFmll`QZUTv2VOgP3kZ*V21pK5MqbEC${4J+Uv)+z!@O-4HBruWv#5X{Ss zN8GV+kTVjkZ8&pK^xnGWXHAL?Cf`etqi*E~4s9^(U8>2$5r!RVtF=yJHU%^2a+h_^ zsy)3~*`Y>m8!R}EM(z=(u+;Br5{^*<0VFc14L(p);DJI7PcFY<||AL09;htpSdOGb-rFfuAn-K|TaGtB)MsT_2wP-?ssyvi1z z2bI)GiSaBrrOUH>v|9ExbC7I|hgFjEN0{VZU=75)n4p^DZhMW%=eXA|7HIK10(?*N z&S>%meE2be&o4>NJ|jd>iUICXrwBj?liBOdScQ9%3(Ky*c-r`T2Q<9oRI9u3zs^M= zOlDRFP+tI_Y#{9M+Jo4FfnFP3+j~!~^Gl3!#94I_7Uz&a?LXkQt*F>*HFZ=3GRByK zl2Gx5;~2S47vo-^2(yZgjhi2t*CvyD9E&wv7x$<@PT|7yqNGi8fy?pbQ+*7}3)9P< zMio`VaFVJA7>08^t`FsQ{{a^1=Wp1SWvJ@{{^1oaia1^oMrABW)j)LUlL7Cfxx6(? z?5ox3eaKGo6_^8wG{ECj&-Wi)DSk#EFRIpu@0e0*m&Q@(BIVUrEJ(OvQ7@>u!CT31 zn5PouJ@nkr3#zMu59^b13vUE>6AH%r!-G_{^gvAc@y8eg+M!>OsR@*tI$MEv(th9Uyqa6;h@Ah%k+1{o8-dRbmEKE1ALC5_sY+fpW(5lsHblK-r7A1 zOC-pOpe&2?MBY1Z!0_GKwGW#j_EJnWI>}1?;hm2;IwNeyBnRbp$70&vrESJ%s|OYf zoU=6R+o$|ulEQTHSqhAh{;p5ytQiXJ9cG@Q5}9QY@E5*b1>6(2Lky5jdW4zycsvEqXgsOXk z=tL#Yzp=+t6}IZ|)tJ55+XJ=jA4KcLR+8F5W!@W;33z3!@s1i^*aY7caM5eN2`;%i zkXKzFWL5S>a+C*<_b~T(q+q4S+tYNvZa7kF)H^=!XP?Q7&?}vWw=atuf+FpA)zb{V zu87lphs|qS9F4HCcYh7p#QM&+yW~nMeB5mLZe;uJ2@k&+ z=G?hdK=EDJ`O$8S0te&`(xQ?s%34-6?hw6TaJ}my{WdwQTr?YasNmy-g{|(%8s8Ml zH(!wpvc<+Lz<;k2^S@4TLsP>}t%p8Ns3*jAO7N)09m72HD}sg%7p7W(hz;s-OOTod zCLeW@uGg6+s*ccPT;0vo0b!s#Y4rpF)UiLgTt5~}$}%o>FuU%qf0#b}(`Y0`%iVWv z7~yx7VL-r4n&<#Zz{R$7cgiloc_b#go5eVn)-SjuX0PW)a}N7XU(88&;(`T%8Je2> zDNj0uXVhqnsCp{pu|e+H?2;P`G>4ejJnXiFx(P-*HiV`4QFPw!X0&=F7ULW?6o@;p z5zvu_=^&xc`4GN?Qu0R%=m~i@jgjJVGg-_VM|n7C^svav7kqxICiz$fM>>Dm47$Q- zz6(>Pk(&buPD-;{%D)6(1qpDL)+k_M@B&i8WrmlQl)c!UpN?lptNa40Grpxl>pp8n8*2V0?zU&f-tB1W;D|y%_i1goE6Xwb?x6j^7kG1ld;Z87dehQd~H?3JiMEtILG*{qS!)#dNYwVXJ*=GQ7NlN zQfx+yTHJYL2!3)HV5#%|v2egKZ8+^b^xi%k{VZf7qgrX%(D_pgU`f|zEtj!X&CxAABFZ+zr)>@hQ} z7PI6Jd+LvKiWpY=pGhCKs?U6Z%dOWyZh~CIYc$?}A^-Vagp4ms3Z4{nW83Ep8>+|f zgVN*uDP^d5@V@3EKz29BFBRaSwjb9&qfKhxnH~K9QG+Ct&{{iN* Bge?F7 diff --git a/docs/guide/src/pt-br/images/dioxuslogo_full.png b/docs/guide/src/pt-br/images/dioxuslogo_full.png deleted file mode 100644 index 7d08f2af8f057780eddae4b0f8b8fa753b69e7f8..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 59292 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

##0PXrvufB0wJ`%=YsvNItF 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

sW@yfIK5!0r3C!jXOp{;!Mh)wCw-TYJeHj?h7 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%0AT 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 KTJSHwum215)xFXH diff --git a/docs/guide/src/pt-br/index.md b/docs/guide/src/pt-br/index.md deleted file mode 100644 index e3d32ebc2..000000000 --- a/docs/guide/src/pt-br/index.md +++ /dev/null @@ -1,52 +0,0 @@ -# Introdução - -![dioxuslogo](./images/dioxuslogo_full.png) - -Dioxus Γ© uma estrutura portΓ‘til, de alto desempenho e ergonΓ΄mica para a construção de interfaces de usuΓ‘rio multiplataforma no Rust. Este guia irΓ‘ ajudΓ‘-lo a comeΓ§ar a escrever aplicativos Dioxus para a Web, Desktop, Mobile e muito mais. - -```rust, no_run -fn app(cx: Scope) -> Element { - let mut count = use_state(cx, || 0); - - cx.render(rsx!( - h1 { "High-Five counter: {count}" } - button { onclick: move |_| count += 1, "Up high!" } - button { onclick: move |_| count -= 1, "Down low!" } - )) -} -``` - -Dioxus Γ© fortemente inspirado pelo React. Se vocΓͺ conhece o React, comeΓ§ar com o Dioxus serΓ‘ muito fΓ‘cil. - -> Este guia pressupΓ΅e que vocΓͺ jΓ‘ conhece um pouco de [Rust](https://www.rust-lang.org/)! Caso contrΓ‘rio, recomendamos ler [_the book_](https://doc.rust-lang.org/book/ch01-00-getting-started.html) para aprender Rust primeiro. - -## Recursos - -- Aplicativos de desktop rodando nativamente (sem Electron!) em menos de 10 linhas de cΓ³digo. -- Gerenciamento de estado incrivelmente ergonΓ΄mico e poderoso. -- Documentação em linha abrangente - documentação sob o mouse e guias para todos os elementos HTML e manipuladores de eventos. -- Extremamente eficiente de memΓ³ria – 0 alocaçáes globais para componentes de estado estacionΓ‘rio. -- Agendador assΓ­ncrono multicanal para suporte assΓ­ncrono de primeira classe. -- E mais! Leia as [notas de lanΓ§amento completa](https://dioxuslabs.com/blog/introducing-dioxus/. - -### Multi Plataforma - -Dioxus Γ© um kit de ferramentas _portΓ‘til_, o que significa que a implementação do nΓΊcleo pode ser executada em qualquer lugar sem independente da plataforma. Ao contrΓ‘rio de muitos outros kits de ferramentas de frontend Rust, o Dioxus nΓ£o estΓ‘ intrinsecamente vinculado ao WebSys. Na verdade, todos os elementos e ouvintes de eventos podem ser trocados em tempo de compilação. Por padrΓ£o, o Dioxus vem com o recurso `html` habilitado, mas isso pode ser desabilitado dependendo do seu renderizador de destino. - -No momento, temos vΓ‘rios renderizadores de terceiros: - -- WebSys (para WASM): Γ“timo suporte -- Tao/Tokio (para aplicativos de desktop): Bom suporte -- Tao/Tokio (para aplicativos mΓ³veis): Suporte ruim -- SSR (para gerar marcação estΓ‘tica) -- TUI/Rink (para aplicativos baseados em terminal): Experimental - -## Estabilidade - -Dioxus ainda nΓ£o chegou a uma versΓ£o estΓ‘vel. - -Web: como a Web Γ© uma plataforma bastante madura, esperamos que haja muito pouca rotatividade de API para recursos baseados na Web. - -Desktop: APIs provavelmente estarΓ£o em fluxo Γ  medida que descobrimos padrΓ΅es melhores do que nossa contraparte, ElectronJS. - -SSR: NΓ£o esperamos que a API SSR mude drasticamente no futuro. diff --git a/docs/guide/src/pt-br/interactivity/custom_hooks.md b/docs/guide/src/pt-br/interactivity/custom_hooks.md deleted file mode 100644 index c2ac570c4..000000000 --- a/docs/guide/src/pt-br/interactivity/custom_hooks.md +++ /dev/null @@ -1,26 +0,0 @@ -# Hooks Personalizados - -_Hooks_ sΓ£o uma Γ³tima maneira de encapsular a lΓ³gica de negΓ³cio. Se nenhum dos _hooks_ existentes funcionar para o seu problema, vocΓͺ pode escrever o seu prΓ³prio. - -## Hooks de Composição - -Para evitar a repetição, vocΓͺ pode encapsular a lΓ³gica de negΓ³cios com base em _hooks_ existentes para criar um novo gancho. - -Por exemplo, se muitos componentes precisam acessar uma _struct_ `AppSettings`, vocΓͺ pode criar um gancho de "atalho": - -```rust, no_run -{{#include ../../../examples/hooks_composed.rs:wrap_context}} -``` - -## LΓ³gica de Hook Personalizada - -VocΓͺ pode usar [`cx.use_hook`](https://docs.rs/dioxus/latest/dioxus/prelude/struct.Scope.html#method.use_hook) para construir seus prΓ³prios _hooks_. Na verdade, Γ© nisso que todos os _hooks_ padrΓ£o sΓ£o construΓ­dos! - -`use_hook` aceita um ΓΊnico encerramento para inicializar o _hook_. Ele serΓ‘ executado apenas na primeira vez que o componente for renderizado. O valor de retorno desse encerramento serΓ‘ usado como o valor do _hook_ – o Dioxus o pegarΓ‘ e o armazenarΓ‘ enquanto o componente estiver vivo. Em cada renderização (nΓ£o apenas na primeira!), vocΓͺ receberΓ‘ uma referΓͺncia a esse valor. - -> Nota: VocΓͺ pode implementar [`Drop`](https://doc.rust-lang.org/std/ops/trait.Drop.html) para o valor do seu _hook_ – ele serΓ‘ descartado e o componente serΓ‘ desmontado (nΓ£o mais na interface do usuΓ‘rio) - -Dentro do encerramento de inicialização, vocΓͺ normalmente farΓ‘ chamadas para outros mΓ©todos `cx`. Por exemplo: - -- O _hook_ `use_state` rastreia o estado no valor do _hook_ e usa [`cx.schedule_update`](https://docs.rs/dioxus/latest/dioxus/prelude/struct.Scope.html#method.schedule_update) para o Dioxus renderizar novamente o componente sempre que ele for alterado. -- O _hook_ `use_context` chama [`cx.consume_context`](https://docs.rs/dioxus/latest/dioxus/prelude/struct.Scope.html#method.consume_context) (que seria custoso chamar em cada render) para obter algum contexto do escopo diff --git a/docs/guide/src/pt-br/interactivity/dynamic_rendering.md b/docs/guide/src/pt-br/interactivity/dynamic_rendering.md deleted file mode 100644 index 58c120926..000000000 --- a/docs/guide/src/pt-br/interactivity/dynamic_rendering.md +++ /dev/null @@ -1,71 +0,0 @@ -# Renderização DinΓ’mica - -Γ€s vezes vocΓͺ quer renderizar coisas diferentes dependendo do estado/_props_. Com o Dioxus, apenas descreva o que vocΓͺ quer ver usando o fluxo de controle do Rust – o _framework_ se encarregarΓ‘ de fazer as mudanΓ§as necessΓ‘rias em tempo real se o estado ou _props_ mudarem! - -## Renderização Condicional - -Para renderizar diferentes elementos com base em uma condição, vocΓͺ pode usar uma instrução `if-else`: - -```rust, no_run -{{#include ../../../examples/conditional_rendering.rs:if_else}} -``` - -> VocΓͺ tambΓ©m pode usar instruçáes `match`, ou qualquer função Rust para renderizar condicionalmente coisas diferentes. - -### Inspecionando _props_ `Element` - -Como `Element` Γ© uma `Option`, os componentes que aceitam `Element` como _prop_ podem realmente inspecionar seu conteΓΊdo e renderizar coisas diferentes com base nisso. Exemplo: - -```rust, no_run -{{#include ../../../examples/component_children_inspect.rs:Clickable}} -``` - -VocΓͺ nΓ£o pode modificar o `Element`, mas se precisar de uma versΓ£o modificada dele, vocΓͺ pode construir um novo baseado em seus atributos/filhos/etc. - -## Renderizando Nada - -Para renderizar nada, vocΓͺ pode retornar `None` de um componente. Isso Γ© ΓΊtil se vocΓͺ deseja ocultar algo condicionalmente: - -```rust, no_run -{{#include ../../../examples/conditional_rendering.rs:conditional_none}} -``` - -Isso funciona porque o tipo `Element` Γ© apenas um alias para `Option` - -> Novamente, vocΓͺ pode usar um mΓ©todo diferente para retornar condicionalmente `None`. Por exemplo, a função _booleana_ [`then()`](https://doc.rust-lang.org/std/primitive.bool.html#method.then) pode ser usada. - -## Listas de renderização - -Frequentemente, vocΓͺ desejarΓ‘ renderizar uma coleção de componentes. Por exemplo, vocΓͺ pode querer renderizar uma lista de todos os comentΓ‘rios em uma postagem. - -Para isso, o Dioxus aceita iteradores que produzem `Element`s. EntΓ£o precisamos: - -- Obter um iterador sobre todos os nossos itens (por exemplo, se vocΓͺ tiver um `Vec` de comentΓ‘rios, itere sobre ele com `iter()`) -- `.map` o iterador para converter cada item em um `Element` renderizado usando `cx.render(rsx!(...))` - - Adicione um atributo `key` exclusivo a cada item do iterador -- Incluir este iterador no RSX final - -Exemplo: suponha que vocΓͺ tenha uma lista de comentΓ‘rios que deseja renderizar. EntΓ£o, vocΓͺ pode renderizΓ‘-los assim: - -```rust, no_run -{{#include ../../../examples/rendering_lists.rs:render_list}} -``` - -### O Atributo `key` - -Toda vez que vocΓͺ renderiza novamente sua lista, o Dioxus precisa acompanhar qual item foi para onde, porque a ordem dos itens em uma lista pode mudar – itens podem ser adicionados, removidos ou trocados. Apesar disso, Dioxus precisa: - -- Acompanhar o estado do componente -- Descobrir com eficiΓͺncia quais atualizaçáes precisam ser feitas na interface do usuΓ‘rio - -Por exemplo, suponha que o `CommentComponent` tenha algum estado – ex. um campo onde o usuΓ‘rio digitou uma resposta. Se a ordem dos comentΓ‘rios mudar repentinamente, o Dioxus precisa associar corretamente esse estado ao mesmo comentΓ‘rio – caso contrΓ‘rio, o usuΓ‘rio acabarΓ‘ respondendo a um comentΓ‘rio diferente! - -Para ajudar o Dioxus a acompanhar os itens da lista, precisamos associar cada item a uma chave exclusiva. No exemplo acima, geramos dinamicamente a chave exclusiva. Em aplicaçáes reais, Γ© mais provΓ‘vel que a chave venha de, por exemplo, um ID de banco de dados. Realmente nΓ£o importa de onde vocΓͺ obtΓ©m a chave, desde que atenda aos requisitos - -- As chaves devem ser ΓΊnicas em uma lista -- O mesmo item deve sempre ser associado Γ  mesma chave -- As chaves devem ser relativamente pequenas (ou seja, converter toda a estrutura Comment em uma String seria uma chave muito ruim) para que possam ser comparadas com eficiΓͺncia - -VocΓͺ pode ficar tentado a usar o Γ­ndice de um item na lista como sua chave. Na verdade, Γ© isso que o Dioxus usarΓ‘ se vocΓͺ nΓ£o especificar uma chave. Isso sΓ³ Γ© aceitΓ‘vel se vocΓͺ puder garantir que a lista seja constante – ou seja, sem reordenação, adiçáes ou exclusΓ΅es. - -> Observe que se vocΓͺ passar a chave para um componente que vocΓͺ criou, ele nΓ£o receberΓ‘ a chave como _prop_. Γ‰ usado apenas como uma dica pelo prΓ³prio Dioxus. Se o seu componente precisar de um ID, vocΓͺ deve passΓ‘-lo como um _prop_ separado. diff --git a/docs/guide/src/pt-br/interactivity/event_handlers.md b/docs/guide/src/pt-br/interactivity/event_handlers.md deleted file mode 100644 index 8b3d757ef..000000000 --- a/docs/guide/src/pt-br/interactivity/event_handlers.md +++ /dev/null @@ -1,68 +0,0 @@ -# Manipuladores de eventos - -Eventos sΓ£o açáes interessantes que acontecem, geralmente relacionadas a algo que o usuΓ‘rio fez. Por exemplo, alguns eventos acontecem quando o usuΓ‘rio clica, rola, move o mouse ou digita um caractere. Para responder a essas açáes e tornar a interface do usuΓ‘rio interativa, precisamos lidar com esses eventos. - -Os eventos estΓ£o associados a elementos. Por exemplo, geralmente nΓ£o nos importamos com todos os cliques que acontecem em um aplicativo, apenas aqueles em um botΓ£o especΓ­fico. Para lidar com eventos que acontecem em um elemento, devemos anexar o manipulador de eventos desejado a ele. - -Os manipuladores de eventos sΓ£o semelhantes aos atributos regulares, mas seus nomes geralmente comeΓ§am com `on` - e aceitam encerramentos como valores. O encerramento serΓ‘ chamado sempre que o evento for acionado e serΓ‘ passado esse evento. - -Por exemplo, para manipular cliques em um elemento, podemos especificar um manipulador `onclick`: - -```rust, no_run -{{#include ../../../examples/event_click.rs:rsx}} -``` - -## O Objeto `Evento` - -Os manipuladores de eventos recebem um objeto [`UiEvent`](https://docs.rs/dioxus-core/latest/dioxus_core/struct.UiEvent.html) contendo informaçáes sobre o evento. Diferentes tipos de eventos contΓͺm diferentes tipos de dados. Por exemplo, eventos relacionados ao mouse contΓͺm [`MouseData`](https://docs.rs/dioxus/latest/dioxus/events/struct.MouseData.html), que informa coisas como onde o mouse foi clicado e quais botΓ΅es do mouse foram usados. - -No exemplo acima, esses dados de evento foram registrados no terminal: - -``` -Clicked! Event: UiEvent { data: MouseData { coordinates: Coordinates { screen: (468.0, 109.0), client: (73.0, 25.0), element: (63.0, 15.0), page: (73.0, 25.0) }, modifiers: (empty), held_buttons: EnumSet(), trigger_button: Some(Primary) } } -Clicked! Event: UiEvent { data: MouseData { coordinates: Coordinates { screen: (468.0, 109.0), client: (73.0, 25.0), element: (63.0, 15.0), page: (73.0, 25.0) }, modifiers: (empty), held_buttons: EnumSet(), trigger_button: Some(Primary) } } -``` - -Para saber o que os diferentes tipos de eventos fornecem, leia os [documentos do mΓ³dulo de eventos](https://docs.rs/dioxus/latest/dioxus/events/index.html). - -### Parando a propagação - -Quando vocΓͺ tem, por exemplo um `button` dentro de um `div`, qualquer clique no `button` tambΓ©m Γ© um clique no `div`. Por esta razΓ£o, Dioxus propaga o evento click: primeiro, ele Γ© acionado no elemento alvo, depois nos elementos pai. Se vocΓͺ quiser evitar esse comportamento, vocΓͺ pode chamar `cancel_bubble()` no evento: - -```rust, no_run -{{#include ../../../examples/event_click.rs:rsx}} -``` - -## Prevenir o PadrΓ£o - -Alguns eventos tΓͺm um comportamento padrΓ£o. Para eventos de teclado, isso pode ser inserir o caractere digitado. Para eventos de mouse, isso pode estar selecionando algum texto. - -Em alguns casos, vocΓͺ pode querer evitar esse comportamento padrΓ£o. Para isso, vocΓͺ pode adicionar o atributo `prevent_default` com o nome do manipulador cujo comportamento padrΓ£o vocΓͺ deseja interromper. Este atributo Γ© especial: vocΓͺ pode anexΓ‘-lo vΓ‘rias vezes para vΓ‘rios atributos: - -```rust, no_run -{{#include ../../../examples/event_prevent_default.rs:prevent_default}} -``` - -Quaisquer manipuladores de eventos ainda serΓ£o chamados. - -> Normalmente, em React ou JavaScript, vocΓͺ chamaria "preventDefault" no evento no retorno de chamada. Dioxus atualmente _nΓ£o_ suporta este comportamento. Observação: isso significa que vocΓͺ nΓ£o pode impedir condicionalmente o comportamento padrΓ£o. - -## Manipulador de Props - -Γ€s vezes, vocΓͺ pode querer criar um componente que aceite um manipulador de eventos. Um exemplo simples seria um componente `FancyButton`, que aceita um manipulador `on_click`: - -```rust, no_run -{{#include ../../../examples/event_handler_prop.rs:component_with_handler}} -``` - -EntΓ£o, vocΓͺ pode usΓ‘-lo como qualquer outro manipulador: - -```rust, no_run -{{#include ../../../examples/event_handler_prop.rs:usage}} -``` - -> Nota: assim como qualquer outro atributo, vocΓͺ pode nomear os manipuladores como quiser! Embora eles devam comeΓ§ar com `on`, para que o prop seja automaticamente transformado em um `EventHandler` no local da chamada. -> -> VocΓͺ tambΓ©m pode colocar dados personalizados no evento, em vez de, por exemplo, `MouseData` - -> Nota sobre formulΓ‘rios: se um manipulador de evento estΓ‘ anexado ao evento `onsubmit` em um formulΓ‘rio, o comportamento padrΓ£o Γ© de **nΓ£o submetΓͺ-lo**. Portanto, especificar `prevent_default: "onsubmit"` irΓ‘ submetΓͺ-lo. \ No newline at end of file diff --git a/docs/guide/src/pt-br/interactivity/hooks.md b/docs/guide/src/pt-br/interactivity/hooks.md deleted file mode 100644 index c5dd85d41..000000000 --- a/docs/guide/src/pt-br/interactivity/hooks.md +++ /dev/null @@ -1,87 +0,0 @@ -# Hooks e Estado do Componente - -AtΓ© agora nossos componentes, sendo funçáes Rust, nΓ£o tinham estado – eles estavam sempre renderizando a mesma coisa. No entanto, em um componente de interface do usuΓ‘rio, geralmente Γ© ΓΊtil ter uma funcionalidade com estado para criar interaçáes do usuΓ‘rio. Por exemplo, vocΓͺ pode querer rastrear se o usuΓ‘rio abriu uma lista suspensa e renderizar coisas diferentes de acordo. - -Para lΓ³gica com estado, vocΓͺ pode usar _hooks_. _Hooks_ sΓ£o funçáes Rust que fazem referΓͺncia a `ScopeState` (em um componente, vocΓͺ pode passar `&cx`), e fornecem funcionalidade e estado. - -## Hook `use_state` - -[`use_state`](https://docs.rs/dioxus/latest/dioxus/hooks/fn.use_state.html) Γ© um dos _hooks_ mais simples. - -- VocΓͺ fornece um fechamento que determina o valor inicial -- `use_state` fornece o valor atual e uma maneira de atualizΓ‘-lo, definindo-o para outra coisa -- Quando o valor Γ© atualizado, `use_state` faz o componente renderizar novamente e fornece o novo valor - -Por exemplo, vocΓͺ pode ter visto o exemplo do contador, no qual o estado (um nΓΊmero) Γ© rastreado usando o _hook_ `use_state`: - -```rust, no_run -{{#include ../../../examples/hooks_counter.rs:component}} -``` - -![Screenshot: counter app](./images/counter.png) - -Toda vez que o estado do componente muda, ele Γ© renderizado novamente e a função do componente Γ© chamada, para que vocΓͺ possa descrever como deseja que a nova interface do usuΓ‘rio se pareΓ§a. VocΓͺ nΓ£o precisa se preocupar em "mudar" nada - apenas descreva o que vocΓͺ quer em termos de estado, e Dioxus cuidarΓ‘ do resto! - -> `use_state` retorna seu valor envolto em uma _smart pointer_ do tipo [`UseState`](https://docs.rs/dioxus/latest/dioxus/hooks/struct.UseState.html). Γ‰ por isso que vocΓͺ pode ler o valor e atualizΓ‘-lo, mesmo dentro de um manipulador. - -VocΓͺ pode usar vΓ‘rios _hooks_ no mesmo componente se quiser: - -```rust, no_run -{{#include ../../../examples/hooks_counter_two_state.rs:component}} -``` - -![Screenshot: app with two counters](./images/counter_two_state.png) - -## Regras dos Hooks - -O exemplo acima pode parecer um pouco mΓ‘gico, jΓ‘ que as funçáes Rust normalmente nΓ£o estΓ£o associadas ao estado. O Dioxus permite que os _hooks_ mantenham o estado entre as renderizaçáes atravΓ©s de uma referΓͺncia a `ScopeState`, e Γ© por isso que vocΓͺ deve passar `&cx` para eles. - -Mas como Dioxus pode diferenciar entre vΓ‘rios _hooks_ no mesmo componente? Como vocΓͺ viu no segundo exemplo, ambas as funçáes `use_state` foram chamadas com os mesmos parΓ’metros, entΓ£o como elas podem retornar coisas diferentes quando os contadores sΓ£o diferentes? - -```rust, no_run -{{#include ../../../examples/hooks_counter_two_state.rs:use_state_calls}} -``` - -Isso sΓ³ Γ© possΓ­vel porque os dois _hooks_ sΓ£o sempre chamados na mesma ordem, entΓ£o Dioxus sabe qual Γ© qual. Portanto, a ordem em que vocΓͺ chama os _hooks_ Γ© importante, e Γ© por isso que vocΓͺ deve seguir certas regras ao usar os _hooks_: - -1. _Hooks_ sΓ³ podem ser usados em componentes ou outros _hooks_ (falaremos disso mais tarde) -2. Em cada chamada para a função componente - 1. Os mesmos _hooks_ devem ser chamados - 2. Na mesma ordem -3. Os nomes dos _hooks_ devem comeΓ§ar com `use_` para que vocΓͺ nΓ£o os confunda acidentalmente com funçáes normais - -Essas regras significam que hΓ‘ certas coisas que vocΓͺ nΓ£o pode fazer com _hooks_: - -### Sem Hooks em Condicionais - -```rust, no_run -{{#include ../../../examples/hooks_bad.rs:conditional}} -``` - -### Sem Hooks em Closures - -```rust, no_run -{{#include ../../../examples/hooks_bad.rs:closure}} -``` - -### Sem Hooks em Loops - -```rust, no_run -{{#include ../../../examples/hooks_bad.rs:loop}} -``` - -## Gancho `use_ref` - -`use_state` Γ© Γ³timo para rastrear valores simples. No entanto, vocΓͺ pode notar na [`UseState` API](https://docs.rs/dioxus/latest/dioxus/hooks/struct.UseState.html) que a ΓΊnica maneira de modificar seu valor Γ© substituΓ­-lo por algo else (por exemplo, chamando `set`, ou atravΓ©s de um dos operadores `+=`, `-=`). Isso funciona bem quando Γ© barato construir um valor (como qualquer primitivo). Mas e se vocΓͺ quiser manter dados mais complexos no estado dos componentes? - -Por exemplo, suponha que queremos manter um `Vec` de valores. Se o armazenamos com `use_state`, a ΓΊnica maneira de adicionar um novo valor Γ  lista seria criar um novo `Vec` com o valor adicional e colocΓ‘-lo no estado. Isto Γ© custoso! Queremos modificar o `Vec` existente. - -Felizmente, existe outro _hook_ para isso, `use_ref`! Γ‰ semelhante ao `use_state`, mas permite obter uma referΓͺncia mutΓ‘vel aos dados contidos. - -Aqui estΓ‘ um exemplo simples que mantΓ©m uma lista de eventos em um `use_ref`. Podemos adquirir acesso de escrita ao estado com `.write()`, e entΓ£o apenas `.push` um novo valor para o estado: - -```rust, no_run -{{#include ../../../examples/hooks_use_ref.rs:component}} -``` - -> Os valores de retorno de `use_state` e `use_ref`, (`UseState` e `UseRef`, respectivamente) sΓ£o de alguma forma semelhantes a [`Cell`](https://doc.rust-lang.org/std/ cell/) e [`RefCell`](https://doc.rust-lang.org/std/cell/struct.RefCell.html) – eles fornecem mutabilidade interior. No entanto, esses _wrappers_ do Dioxus tambΓ©m garantem que o componente seja renderizado novamente sempre que vocΓͺ alterar o estado. diff --git a/docs/guide/src/pt-br/interactivity/images/counter.png b/docs/guide/src/pt-br/interactivity/images/counter.png deleted file mode 100644 index dd89cadef3ab7794d1f77b08350b8a2cad434b72..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 11368 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 O00kLk=_*O1;Qs=kxyf1p diff --git a/docs/guide/src/pt-br/interactivity/images/counter_two_state.png b/docs/guide/src/pt-br/interactivity/images/counter_two_state.png deleted file mode 100644 index 4f77942a20ab23ea01784871c7bc977a2baec4a5..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 14503 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

Xr+Mb0o6&U|y=x|mJQEkCNwLvd|7x7mswPA5 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 { - Route { to: "/home", Home {} } - Route { to: "/blog", Blog {} } - } -} -``` - -Sempre que visitamos este aplicativo, obteremos o componente Home ou o componente Blog renderizado, dependendo de qual rota entrarmos. Se nenhuma dessas rotas corresponder Γ  localização atual, nada serΓ‘ renderizado. - -Podemos corrigir isso de duas maneiras: - -- Uma pΓ‘gina 404 de _fallback_ - -```rust, no_run -rsx!{ - Router:: { - Route { to: "/home", Home {} } - Route { to: "/blog", Blog {} } - Route { to: "", NotFound {} } - } -} -``` - -- Redirecionar 404 para _Home_ - -```rust, no_run -rsx!{ - Router:: { - Route { to: "/home", Home {} } - Route { to: "/blog", Blog {} } - Redirect { from: "", to: "/home" } - } -} -``` - -## Links - -Para que nosso aplicativo navegue nessas rotas, podemos fornecer elementos clicΓ‘veis chamados Links. Eles simplesmente envolvem elementos `` que, quando clicados, navegam no aplicativo para o local determinado. - -```rust, no_run -rsx!{ - Link { - to: "/home", - "Go home!" - } -} -``` - -## Mais leitura - -Esta pΓ‘gina Γ© apenas uma breve visΓ£o geral do roteador para mostrar que existe uma solução poderosa jΓ‘ construΓ­da para um problema muito comum. Para obter mais informaçáes sobre o roteador, confira seu livro ou confira alguns dos exemplos. - -O roteador tem sua prΓ³pria documentação! [DisponΓ­vel aqui](https://dioxuslabs.com/docs/0.3/router/). diff --git a/docs/guide/src/pt-br/interactivity/sharing_state.md b/docs/guide/src/pt-br/interactivity/sharing_state.md deleted file mode 100644 index b9b829c0c..000000000 --- a/docs/guide/src/pt-br/interactivity/sharing_state.md +++ /dev/null @@ -1,71 +0,0 @@ -# Estado de compartilhamento - -Muitas vezes, vΓ‘rios componentes precisam acessar o mesmo estado. Dependendo de suas necessidades, existem vΓ‘rias maneiras de implementar isso. - -## Elevenado o Estado - -Uma abordagem para compartilhar o estado entre os componentes Γ© "elevΓ‘-lo" atΓ© o ancestral comum mais prΓ³ximo. Isso significa colocar o _hook_ `use_state` em um componente pai e passar os valores necessΓ‘rios como _props_. - -Por exemplo, suponha que queremos construir um editor de memes. Queremos ter uma entrada para editar a legenda do meme, mas tambΓ©m uma visualização do meme com a legenda. Logicamente, o meme e a entrada sΓ£o 2 componentes separados, mas precisam acessar o mesmo estado (a legenda atual). - -> Claro, neste exemplo simples, poderΓ­amos escrever tudo em um componente - mas Γ© melhor dividir tudo em componentes menores para tornar o cΓ³digo mais reutilizΓ‘vel e fΓ‘cil de manter (isso Γ© ainda mais importante para aplicativos maiores e complexos) . - -ComeΓ§amos com um componente `Meme`, responsΓ‘vel por renderizar um meme com uma determinada legenda: - -```rust, no_run -{{#include ../../../examples/meme_editor.rs:meme_component}} -``` - -> Observe que o componente `Meme` nΓ£o sabe de onde vem a legenda – ela pode ser armazenada em `use_state`, `use_ref` ou uma constante. Isso garante que seja muito reutilizΓ‘vel - o mesmo componente pode ser usado para uma galeria de memes sem nenhuma alteração! - -TambΓ©m criamos um editor de legendas, totalmente desacoplado do meme. O editor de legendas nΓ£o deve armazenar a legenda em si – caso contrΓ‘rio, como iremos fornecΓͺ-la ao componente `Meme`? Em vez disso, ele deve aceitar a legenda atual como um suporte, bem como um manipulador de eventos para delegar eventos de entrada para: - -```rust, no_run -{{#include ../../../examples/meme_editor.rs:caption_editor}} -``` - -Finalmente, um terceiro componente renderizarΓ‘ os outros dois como filhos. Ele serΓ‘ responsΓ‘vel por manter o estado e passar os _props_ relevantes. - -```rust, no_run -{{#include ../../../examples/meme_editor.rs:meme_editor}} -``` - -![Captura de tela do editor de memes: Um velho esqueleto de plΓ‘stico sentado em um banco de parque. Legenda: "eu esperando por um recurso de idioma"](./images/meme_editor_screenshot.png) - -## Usando o contexto - -Γ€s vezes, algum estado precisa ser compartilhado entre vΓ‘rios componentes na Γ‘rvore, e passΓ‘-lo pelos _props_ Γ© muito inconveniente. - -Suponha agora que queremos implementar uma alternΓ’ncia de modo escuro para nosso aplicativo. Para conseguir isso, faremos com que cada componente selecione o estilo dependendo se o modo escuro estΓ‘ ativado ou nΓ£o. - -> Nota: estamos escolhendo esta abordagem como exemplo. Existem maneiras melhores de implementar o modo escuro (por exemplo, usando variΓ‘veis ​​CSS). Vamos fingir que as variΓ‘veis ​​CSS nΓ£o existem – bem-vindo a 2013! - -Agora, poderΓ­amos escrever outro `use_state` no componente superior e passar `is_dark_mode` para cada componente atravΓ©s de _props_. Mas pense no que acontecerΓ‘ Γ  medida que o aplicativo crescer em complexidade – quase todos os componentes que renderizam qualquer CSS precisarΓ£o saber se o modo escuro estΓ‘ ativado ou nΓ£o – para que todos precisem do mesmo suporte do modo escuro. E cada componente pai precisarΓ‘ passΓ‘-lo para eles. Imagine como isso ficaria confuso e verboso, especialmente se tivΓ©ssemos componentes com vΓ‘rios nΓ­veis de profundidade! - -A Dioxus oferece uma solução melhor do que esta "perfuração com hΓ©lice" – fornecendo contexto. O _hook_ [`use_context_provider`](https://docs.rs/dioxus-hooks/latest/dioxus_hooks/fn.use_context_provider.html) Γ© semelhante ao `use_ref`, mas o torna disponΓ­vel atravΓ©s do [`use_context`](https://docs.rs/dioxus-hooks/latest/dioxus_hooks/fn.use_context.html) para todos os componentes filhos. - -Primeiro, temos que criar um _struct_ para nossa configuração de modo escuro: - -```rust, no_run -{{#include ../../../examples/meme_editor_dark_mode.rs:DarkMode_struct}} -``` - -Agora, em um componente de nΓ­vel superior (como `App`), podemos fornecer o contexto `DarkMode` para todos os componentes filhos: - -```rust, no_run -{{#include ../../../examples/meme_editor_dark_mode.rs:context_provider}} -``` - -Como resultado, qualquer componente filho de `App` (direto ou nΓ£o), pode acessar o contexto `DarkMode`. - -```rust, no_run -{{#include ../../../examples/meme_editor_dark_mode.rs:use_context}} -``` - -> `use_context` retorna `Option>` aqui. Se o contexto foi fornecido, o valor Γ© `Some(UseSharedState)`, que vocΓͺ pode chamar `.read` ou `.write`, similarmente a `UseRef`. Caso contrΓ‘rio, o valor Γ© `None`. - -Por exemplo, aqui estΓ‘ como implementarΓ­amos a alternΓ’ncia do modo escuro, que lΓͺ o contexto (para determinar a cor que deve renderizar) e grava nele (para alternar o modo escuro): - -```rust, no_run -{{#include ../../../examples/meme_editor_dark_mode.rs:toggle}} -``` diff --git a/docs/guide/src/pt-br/interactivity/user_input.md b/docs/guide/src/pt-br/interactivity/user_input.md deleted file mode 100644 index 94a091e38..000000000 --- a/docs/guide/src/pt-br/interactivity/user_input.md +++ /dev/null @@ -1,33 +0,0 @@ -# Entradas do UsuΓ‘rio - -As interfaces geralmente precisam fornecer uma maneira de inserir dados: por exemplo, texto, nΓΊmeros, caixas de seleção, etc. No Dioxus, hΓ‘ duas maneiras de trabalhar com a entrada do usuΓ‘rio. - -## Entradas Controladas - -Com entradas controladas, vocΓͺ fica diretamente responsΓ‘vel pelo estado da entrada. Isso lhe dΓ‘ muita flexibilidade e facilita manter as coisas em sincronia. Por exemplo, Γ© assim que vocΓͺ criaria uma entrada de texto controlada: - -```rust, no_run -{{#include ../../../examples/input_controlled.rs:component}} -``` - -Observe a flexibilidade - vocΓͺ pode: - -- Exibir o mesmo conteΓΊdo em outro elemento, e eles estarΓ£o em sincronia -- Transformar a entrada toda vez que for modificada (por exemplo, para garantir que seja maiΓΊscula) -- Validar a entrada toda vez que ela mudar -- Ter uma lΓ³gica personalizada acontecendo quando a entrada for alterada (por exemplo, solicitação de rede para preenchimento automΓ‘tico) -- Alterar programaticamente o valor (por exemplo, um botΓ£o "randomize" que preenche a entrada com absurdos) - -## Entradas nΓ£o Controladas - -Como alternativa Γ s entradas controladas, vocΓͺ pode simplesmente deixar a plataforma acompanhar os valores de entrada. Se nΓ£o dissermos a uma entrada HTML qual conteΓΊdo ela deve ter, ela poderΓ‘ ser editada de qualquer maneira (isso estΓ‘ embutido na visualização da web). Essa abordagem pode ser mais eficiente, mas menos flexΓ­vel. Por exemplo, Γ© mais difΓ­cil manter a entrada sincronizada com outro elemento. - -Como vocΓͺ nΓ£o tem necessariamente o valor atual da entrada nΓ£o controlada no estado, vocΓͺ pode acessΓ‘-lo ouvindo os eventos `oninput` (de maneira semelhante aos componentes controlados) ou, se a entrada for parte de um formulΓ‘rio, vocΓͺ pode acessar os dados do formulΓ‘rio nos eventos do formulΓ‘rio (por exemplo, `oninput` ou `onsubmit`): - -```rust, no_run -{{#include ../../../examples/input_uncontrolled.rs:component}} -``` - -``` -Submitted! UiEvent { data: FormData { value: "", values: {"age": "very old", "date": "1966", "name": "Fred"} } } -``` diff --git a/docs/guide/src/pt-br/lib.rs b/docs/guide/src/pt-br/lib.rs deleted file mode 100644 index 97cda56a8..000000000 --- a/docs/guide/src/pt-br/lib.rs +++ /dev/null @@ -1 +0,0 @@ -// empty (we only need this crate for the examples) diff --git a/docs/guide/src/pt-br/publishing/desktop.md b/docs/guide/src/pt-br/publishing/desktop.md deleted file mode 100644 index ab9427b32..000000000 --- a/docs/guide/src/pt-br/publishing/desktop.md +++ /dev/null @@ -1,54 +0,0 @@ -# Publicação - -ParabΓ©ns! VocΓͺ fez seu primeiro aplicativo Dioxus que realmente faz coisas muito legais. Este aplicativo usa a biblioteca WebView do seu sistema operacional, portanto, Γ© portΓ‘til para ser distribuΓ­do para outras plataformas. - -Nesta seção, abordaremos como agrupar seu aplicativo para macOS, Windows e Linux. - -## Instale o `cargo-bundle` - -A primeira coisa que faremos Γ© instalar o [`cargo-bundle`](https://github.com/burtonageo/cargo-bundle). Essa extensΓ£o para carga facilitarΓ‘ muito o empacotamento do nosso aplicativo para as vΓ‘rias plataformas. - -De acordo com a pΓ‘gina do github `cargo-bundle`, - -_"cargo-bundle Γ© uma ferramenta usada para gerar instaladores ou pacotes de aplicativos para executΓ‘veis ​​GUI criados com o cargo. Ele pode criar pacotes .app para Mac OS X e iOS, pacotes .deb para Linux e instaladores .msi para Windows (observe no entanto que o suporte para iOS e Windows ainda Γ© experimental). O suporte para a criação de pacotes .rpm (para Linux) e pacotes .apk (para Android) ainda estΓ‘ pendente."_ - -Para instalar, basta executar - -`cargo install ` - -## Configurando seu Projeto - -Para obter uma configuração de projeto para empacotamento, precisamos adicionar algumas _flags_ ao nosso arquivo `Cargo.toml`. - -```toml -[package] -name = "example" -# ...other fields... - -[package.metadata.bundle] -name = "DogSearch" -identifier = "com.dogs.dogsearch" -version = "1.0.0" -copyright = "Copyright (c) Jane Doe 2016. All rights reserved." -category = "Developer Tool" -short_description = "Easily search for Dog photos" -long_description = """ -This app makes it quick and easy to browse photos of dogs from over 200 bree -""" -``` - -## Empacotando - -Seguindo as instruçáes do cargo-bundle, simplesmente `cargo-bundle --release` para produzir um aplicativo final com todas as otimizaçáes e recursos integrados. - -Depois de executar `cargo-bundle --release`, seu aplicativo deve estar acessΓ­vel em - -`target/release/bundle//`. - -Por exemplo, um aplicativo macOS ficaria assim: - -![Aplicativo publicado](../images/publish.png) - -Γ“timo! E sΓ£o apenas 4,8 Mb – extremamente enxutos! Como o Dioxus aproveita o WebView nativo da sua plataforma, os aplicativos Dioxus sΓ£o extremamente eficientes em termos de memΓ³ria e nΓ£o desperdiΓ§am sua bateria. - -> Nota: nem todo CSS funciona da mesma forma em todas as plataformas. Certifique-se de visualizar o CSS do seu aplicativo em cada plataforma – ou navegador da web (Firefox, Chrome, Safari) antes de publicar. diff --git a/docs/guide/src/pt-br/publishing/index.md b/docs/guide/src/pt-br/publishing/index.md deleted file mode 100644 index 06b7aaf7b..000000000 --- a/docs/guide/src/pt-br/publishing/index.md +++ /dev/null @@ -1 +0,0 @@ -# Publicando diff --git a/docs/guide/src/pt-br/publishing/web.md b/docs/guide/src/pt-br/publishing/web.md deleted file mode 100644 index 2ecc49699..000000000 --- a/docs/guide/src/pt-br/publishing/web.md +++ /dev/null @@ -1,9 +0,0 @@ -## Publicando com o Github Pages - -Para construir nosso aplicativo e publicΓ‘-lo no Github: - -- Verifique se o GitHub Pages estΓ‘ configurado para seu repositΓ³rio -- Crie seu aplicativo com `trunk build --release` (inclua `--public-url ` para atualizar os prefixos de ativos se estiver usando um site de projeto) -- Mova seu HTML/CSS/JS/Wasm gerado de `dist` para a pasta configurada para Github Pages -- Adicione e confirme com `git` -- `git push` para o GitHub diff --git a/docs/guide/src/pt-br/roadmap.md b/docs/guide/src/pt-br/roadmap.md deleted file mode 100644 index d16a09770..000000000 --- a/docs/guide/src/pt-br/roadmap.md +++ /dev/null @@ -1,138 +0,0 @@ -# Roteiro e Conjunto de Recursos - -Este conjunto de recursos e roteiro podem ajudΓ‘-lo a decidir se o que a Dioxus pode fazer hoje funciona para vocΓͺ. - -Se um recurso que vocΓͺ precisa nΓ£o existe ou vocΓͺ deseja contribuir com projetos no roteiro, sinta-se Γ  vontade para se envolver [juntando-se ao discord](https://discord.gg/XgGxMSkvUM). - -Em geral, aqui estΓ‘ o status de cada plataforma: - -- **Web**: Dioxus Γ© uma Γ³tima opção para aplicativos da web puros - especialmente para aplicativos CRUD/complexos. No entanto, ele nΓ£o possui o ecossistema do React, entΓ£o vocΓͺ pode estar perdendo uma biblioteca de componentes ou algum _hook_ ΓΊtil. - -- **SSR**: Dioxus Γ© uma Γ³tima opção para prΓ©-renderização, hidratação e renderização de HTML em um endpoint da web. Esteja ciente: o `VirtualDom` nΓ£o Γ© (atualmente) `Send + Sync`. - -- **Desktop**: vocΓͺ pode criar aplicativos de desktop de janela ΓΊnica muito competentes agora mesmo. No entanto, os aplicativos de vΓ‘rias janelas exigem suporte do nΓΊcleo do Dioxus que nΓ£o estΓ£o prontos. - -- **Celular**: o suporte mΓ³vel Γ© muito recente. VocΓͺ descobrirΓ‘ as coisas Γ  medida que avanΓ§a e nΓ£o hΓ‘ muitas `crates` de suporte para perifΓ©ricos. - -- **LiveView**: o suporte ao LiveView Γ© muito recente. VocΓͺ descobrirΓ‘ as coisas Γ  medida que avanΓ§a. Felizmente, nada disso Γ© muito difΓ­cil e qualquer trabalho poderΓ‘ ser enviado `upstream` no Dioxus. - -## Recursos - ---- - -| Recurso | Situação | Descrição | -| ----------------------------------- | -------- | ------------------------------------------------------------------------------------------------ | -| Renderização Condicional | βœ… | `if/then` para esconder/mostrar componente | -| Map, Iterador | βœ… | `map/filter/reduce` para produzir `rsx!` | -| Componentes Chaveados | βœ… | comparação em `diff` com chaves | -| Web | βœ… | renderizador para navegadores Web | -| Desktop (WebView) | βœ… | renderizador para Desktop | -| Estado Compartilhado (Context) | βœ… | compartilha estados atravΓ©s de Γ‘rvores | -| Hooks | βœ… | cΓ©lulas de memoria nos componentes | -| SSR | βœ… | renderiza diretamente para `string` | -| Componente Filho | βœ… | `cx.children()` como lista de nΓ³s | -| Componentes Sem Elementos | βœ… | componentes que nΓ£o renderizam elementos reais na DOM | -| Fragmentos | βœ… | elementos mΓΊltiplos sem uma raiz real | -| Propriedades Manuais | βœ… | passa manualmente `props` com a sintaxe de propagação (`spread syntax`) | -| Entradas Controladas | βœ… | encapsulamento com estado em sobre entradas | -| Estilos CSS/Inline | βœ… | sintaxe para grupos de estilo/atributos em linha | -| Elementos Personalizados | βœ… | define novos elementos primitivos | -| SuspensΓ£o | βœ… | programa futuras renderizaçáes usando `future`/`Promise` | -| Tratamento Integrado de Erros | βœ… | trata erros graciosamente com a sintaxe `?` | -| NodeRef | βœ… | ganha acesso direto aos nΓ³s | -| Re-hidratação | βœ… | pre-renderiza HTML para acelerar a primeira impressΓ£o na tela | -| Renderização Livre de Gargalos | βœ… | `diffs` grandes sΓ£o segmentados sobre quadros para uma transição suave como seda | -| Efeitos | βœ… | executa efeitos apΓ³s um componente ser enviado para a fila de renderização | -| Portais | πŸ›  | renderiza nΓ³s fora da Γ‘rvore tradicional de elementos (DOM) | -| Agendamento Cooperativo | πŸ›  | prioriza eventos com mais importΓ’ncia sobre eventos menos importantes | -| Componentes de Servidor | πŸ›  | componentes hΓ­bridos para aplicativos de ΓΊnica pΓ‘gina (SPA) e servidores | -| DivisΓ£o de Pacotes | πŸ‘€ | carrega o aplicativo assincronamente e eficientemente | -| Componentes Tardios | πŸ‘€ | dinamicamente carrega os novos componentes assim que estiverem prontos enquanto a pΓ‘gina carrega | -| Estado Global de 1Βͺ Classe | βœ… | `redux/recoil/mobx` sobre o `context` | -| Execução Nativa | βœ… | execução como um binΓ‘rio portΓ‘til sem um `runtime` (Node) | -| Sub-Árvore de Memoization | βœ… | pula o `diffing` em sub-Γ‘rvores de elementos estΓ‘ticos | -| Modelos de Alta EficiΓͺncia | πŸ›  | chamadas `rsx!` sΓ£o traduzidas para modelos sobre a `DOM` | -| Garantia de Correção por Compilador | βœ… | avisa sobre erros em esquemas de modelos invΓ‘lidos antes do final da compilação | -| Motor de HeurΓ­stica | βœ… | rastreia componentes na memΓ³ria para minimizar alocaçáes futures | -| Controle Preciso de Reatividade | πŸ‘€ | pula o `diffing` para ter controle preciso das atualizaçáes de tela | - -- βœ… = implementado e funcionando -- πŸ›  = sendo trabalhado ativamente -- πŸ‘€ = ainda nΓ£o implementado ou sendo trabalhado - -## Roteiro - -Esses recursos estΓ£o planejados para o futuro do Dioxus: - -### Essencial - -- [x] Liberação do NΓΊcleo Dioxus -- [x] Atualizar a documentação para incluir mais teoria e ser mais abrangente -- [ ] Suporte para modelos HTML para manipulação de DOM ultrarrΓ‘pida -- [ ] Suporte para vΓ‘rios renderizadores para o mesmo `virtualdom` (subΓ‘rvores) -- [ ] Suporte para `ThreadSafe` (`Send` + `Sync`) -- [ ] Suporte para `Portals` - -### SSR - -- [x] Suporte SSR + Hidratação -- [ ] Suporte integrado de suspensΓ£o para SSR - -### Desktop - -- [ ] Gerenciamento de janela declarativa -- [ ] Modelos para construção/agregação -- [ ] Renderizador totalmente nativo -- [ ] Acesso ao contexto Canvas/WebGL nativamente - -### MΓ³vel - -- [ ] Biblioteca padrΓ£o mΓ³vel - - [ ] GPS - - [ ] CΓ’mera - - [ ] Sistema de Arquivo - - [ ] Biometria - - [ ] Wi-fi - - [ ] Bluetooth - - [ ] Notificaçáes - - [ ] Prancheta (_Clipboard_) -- [ ] Animaçáes -- [ ] Renderizador nativo - -### Empacotamento (CLI) - -- [x] Tradução de HTML para RSX -- [x] Servidor de desenvolvimento -- [x] Recarregamento em tempo-real (_hot-reload_) -- [x] Tradução de JSX para RSX -- [ ] Substituição de mΓ³dulos em tempo-real (_hot-modules_) -- [ ] DivisΓ£o de cΓ³digo -- [ ] Acervo de macros -- [ ] _Pipeline_ CSS -- [ ] _Pipeline_ de imagens - -### Hooks Essenciais - -- [x] Roteador -- [x] Gerenciamento de estado global -- [ ] Redimensionar o observador - -## Trabalho em Progresso - -### Ferramenta de Construção - -Atualmente, estamos trabalhando em nossa prΓ³pria ferramenta de compilação chamada [Dioxus CLI](https://github.com/DioxusLabs/cli) que suportarΓ‘: - -- uma TUI interativa -- reconfiguração em tempo real -- recarga de CSS em tempo-real -- ligação de dados bidirecional entre o navegador e o cΓ³digo-fonte -- um interpretador para `rsx!` -- capacidade de publicar no github/netlify/vercel -- pacote para iOS/Desktop/etc - -### Suporte ao LiveView / Componente do Servidor - -A arquitetura interna do Dioxus foi projetada desde o primeiro dia para suportar o caso de uso `LiveView`, onde um servidor Web hospeda um aplicativo em execução para cada usuΓ‘rio conectado. A partir de hoje, nΓ£o hΓ‘ suporte LiveView de primeira classe – vocΓͺ precisarΓ‘ conectar isso sozinho. - -Embora nΓ£o esteja totalmente implementado, a expectativa Γ© que os aplicativos LiveView possam ser um hΓ­brido entre Wasm e renderizado pelo servidor, onde apenas partes de uma pΓ‘gina sΓ£o "ao vivo" e o restante da pΓ‘gina Γ© renderizado pelo servidor, gerado estaticamente ou manipulado pelo SPA anfitriΓ£o. diff --git a/docs/posts/release-0-2-0.md b/docs/posts/release-0-2-0.md deleted file mode 100644 index 82d87a730..000000000 --- a/docs/posts/release-0-2-0.md +++ /dev/null @@ -1,361 +0,0 @@ -# Dioxus v0.2 Release: TUI, Router, Fermi, and Tooling - -> March 9, 2022 - -Thanks to these amazing folks for their financial support on OpenCollective: - -- [@t1m0t](https://github.com/t1m0t) -- [@alexkirsz](https://github.com/t1m0t) -- [@freopen](https://github.com/freopen) -- [@DannyMichaels](https://github.com/DannyMichaels) -- [@SweetLittleMUV](https://github.com/Fatcat560) - -Thanks to these amazing folks for their code contributions: - -- [@mrxiaozhuox](https://github.com/mrxiaozhuox) -- [@autarch](https://github.com/autarch) -- [@FruitieX](https://github.com/FruitieX) -- [@t1m0t](https://github.com/t1m0t) -- [@Demonthos](https://github.com/Demonthos) -- [@oovm](https://github.com/oovm) -- [@6asaaki](https://github.com/6asaaki) - -Just over two months in, and we already a ton of awesome changes to Dioxus! - -Dioxus is a recently-released library for building interactive user interfaces (GUI) with Rust. It is built around a Virtual DOM, making it portable for the web, desktop, server, mobile, and more. Dioxus looks and feels just like React, so if you know React, then you'll feel right at home. - -```rust, no_run -fn app(cx: Scope) -> Element { - let mut count = use_state(cx, || 0); - - cx.render(rsx! { - h1 { "Count: {count}" } - button { onclick: move |_| count += 1, "+" } - button { onclick: move |_| count -= 1, "-" } - }) -} -``` - -# What's new? - -A _ton_ of stuff happened in this release; 550+ commits, 23 contributors, 2 minor releases, and 6 backers on Open Collective. - -Some of the major new features include: - -- We now can render into the terminal, similar to Ink.JS - a huge thanks to [@Demonthos](https://github.com/Demonthos) -- We have a new router in the spirit of React-Router [@autarch](https://github.com/autarch) -- We now have Fermi for global state management in the spirit of [Recoil.JS](https://recoiljs.org) -- Our desktop platform got major upgrades, getting closer to parity with Electron [@mrxiaozhuox](https://github.com/mrxiaozhuox) -- Our CLI tools now support HTML-to-RSX translation for converting 3rd party HTML into Dioxus [@mrxiaozhuox](https://github.com/mrxiaozhuox) -- Dioxus-Web is sped up by 2.5x with JS-based DOM manipulation (3x faster than React) - -We also fixed and improved a bunch of stuff - check out the full list down below. - -## A New Renderer: Your terminal! - -When Dioxus was initially released, we had very simple support for logging Dioxus elements out as TUI elements. In the past month or so, [@Demonthos](https://github.com/Demonthos) really stepped up and made the new crate a reality. - -![Imgur](https://i.imgur.com/GL7uu3r.png) - -The new TUI renderer even supports mouse movements, keyboard input, async tasks, borders, and a ton more. - -

- ); -}; -``` - -In Dioxus, we would define the same component in a similar fashion: - -```rust, no_run -#[derive(Props, PartialEq)] -struct CardProps { - title: String, - paragraph: String -} - -static Card: Component = |cx| { - let mut count = use_state(cx, || 0); - cx.render(rsx!( - aside { - h2 { "{cx.props.title}" } - p { "{cx.props.paragraph}" } - button { onclick: move |_| count+=1, "Count: {count}" } - } - )) -}; -``` - -However, we recognize that not every project needs Rust - many are fine with JavaScript! We also acknowledge that Rust/Wasm/Dioxus does not fix "everything that is wrong with frontend development." There are always going to be new patterns, frameworks, and languages that solve these problems better than Rust and Dioxus. - -As a general rule of thumb, Dioxus is for you if: - -- your app will become very large -- you need to share code across many platforms -- you want a fast way to build for desktop -- you want to avoid electron or need direct access to hardware -- you're tired of JavaScript tooling - -Today, to publish a Dioxus app, you don't need NPM/WebPack/Parcel/etc. Dioxus simply builds with cargo, and for web builds, Dioxus happily works with the popular [trunk](http://trunkrs.dev) project. - -## Show me more - -Here, we'll dive into some features of Dioxus and why it's so fun to use. The [guide](https://dioxuslabs.com/guide/en/) serves as a deeper and more comprehensive look at what Dioxus can do. - -## Building a new project is simple - -To start a new project, all you need is Cargo, which comes with Rust. For a simple desktop app, all we'll need is the `dioxus` crate with the appropriate `desktop` feature. We start by initializing a new binary crate: - -```shell -$ cargo init dioxus_example -$ cd dioxus_example -``` - -We then add a dependency on Dioxus to the `Cargo.toml` file, with the "desktop" feature enabled: - -```rust, no_run -[dependencies] -dioxus = { version = "*", features = ["desktop"] } -``` - -We can add our counter from above. - -```rust, no_run -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(app) -} - -fn app(cx: Scope) -> Element { - let mut count = use_state(cx, || 0); - - cx.render(rsx! { - h1 { "Count: {count}" } - button { onclick: move |_| count += 1, "+" } - button { onclick: move |_| count -= 1, "-" } - }) -} -``` - -And voilΓ ! We can `cargo run` our app - -![Simple Counter Desktop App](/static/counter.png) - -## Support for JSX-style templating - -Dioxus ships with a templating macro called RSX, a spin on React's JSX. RSX is very similar to regular struct syntax for Rust so it integrates well with your IDE. If used with [Rust-Analyzer](https://github.com/rust-analyzer/rust-analyzer) (not tested anywhere else) RSX supports code-folding, block selection, bracket pair colorizing, autocompletion, symbol renaming β€” pretty much anything you would expect from writing regular struct-style code. - -```rust, no_run -rsx! { - div { "Hello world" } - button { - onclick: move |_| log::info!("button pressed"), - "Press me" - } -} -``` - -If macros aren't your style, you can always drop down to the factory API: - -```rust, no_run -LazyNodes::new(|f| { - f.fragment([ - f.element(div, [f.text("hello world")], [], None, None) - f.element( - button, - [f.text("Press Me")], - [on::click(move |_| log::info!("button pressed"))], - None, - None - ) - ]) -}) -``` - -The `rsx!` macro generates idiomatic Rust code that uses the factory API β€” no different than what you'd write by hand yourself. - -To make it easier to work with RSX, we've built a small [VSCode extension](https://github.com/DioxusLabs/studio) with useful utilities. This extension provides a command that converts a selected block of HTML into RSX so you can easily reuse existing web templates. - -## Dioxus prioritizes developer experience - -Many of the Rust UI frameworks are particularly difficult to work with. Even the ones branded as "ergonomic" are quite challenging to in comparison to TSX/JSX. With Dioxus, we've innovated on a number of Rust patterns to deliver a framework that is actually enjoyable to develop in. - -For example, many Rust frameworks require you to clone your data in for _every_ closure and handler you use. This can get really clumsy for large apps. - -```rust, no_run -div() - .children([ - button().onclick(cloned!(name, date, age, description => move |evt| { /* */ }) - button().onclick(cloned!(name, date, age, description => move |evt| { /* */ }) - button().onclick(cloned!(name, date, age, description => move |evt| { /* */ }) - ]) -``` - -Dioxus understands the lifetimes of data borrowed from `Scope`, so you can safely return any borrowed data without declaring explicit captures. Hook handles all implement `Copy` so they can be shared between listeners without any ceremony. - -```rust, no_run -let name = use_state(cx, || "asd"); -rsx! { - div { - button { onclick: move |_| name.set("abc") } - button { onclick: move |_| name.set("def") } - button { onclick: move |_| name.set("ghi") } - } -} -``` - -Because we know the lifetime of your handlers, we can also expose this to children. No other Rust frameworks let us share borrowed state through the tree, forcing use of Rc/Arc everywhere. With Dioxus, all the Rc/Arc magic is tucked away in hooks, and just beautiful borrowed interfaces are exposed to your code. You don't need to know how Rc/RefCell work to build a competent Dioxus app. - -```rust, no_run -fn app(cx: Scope) -> Element { - let name = use_state(cx, || "asd"); - cx.render(rsx!{ - Button { name: name } - }) -} - -#[derive(Props)] -struct ButtonProps<'a> { - name: UseState<'a, &'static str> -} - -fn Button<'a>(cx: Scope<'a, Childprops<'a>>) -> Element { - cx.render(rsx!{ - button { - onclick: move |_| cx.props.name.set("bob") - } - }) -} -``` - -There's _way_ more to this story, but hopefully we've convinced you that Dioxus' DX somewhat approximates JSX/React. - -## Dioxus is perfected for the IDE - -Note: all IDE-related features have only been tested with [Rust-Analyzer](https://github.com/rust-analyzer/rust-analyzer). - -Dioxus code operates pleasantly with your IDE. For starters, most elements are documented through the Rustdoc system. A quick summary of the MDN docs is always under your finger tips: - -![Elements have hover context](/static/ide_hover.png) - -Dioxus also wraps platform-specific events with a custom synthetic event system. This means events enjoy proper autocomplete and documentation, unlike [Yew](https://yew.rs/) which currently relies on [web-sys](https://crates.io/crates/web-sys) with incomplete IDE support: - -![Events are strongly typed](/static/ide_autocomplete.png) - -Even element attributes and event handlers have top-notch documentation! - -![Element attributes and listeners have hover context](/static/ide_listener.png) - -The `rsx!` macro also benefits from code folding, batch renaming, and block selection, making most basic code navigation and completion tasks a breeze. - -![Element blocks can be folded and renamed](/static/ide_selection.png) - -Furthermore, the `rsx!` macro itself is documented, so if you ever forget how to use a certain feature, the documentation remains close at hand: - -![The RSX documentation is provided on hover](/static/ide_rsx.png) - -We spent a ton of time on this and we hope you enjoy it! - -## Dioxus is extremely fast - -We take the performance of Dioxus seriously. Instead of resolving to "good enough," Dioxus is designed to push the limits of what a declarative React-like framework can achieve. Dioxus is designed with multi-tenancy in mind: a single machine should be able to run thousands of simultaneous low-latency LiveView apps without skipping a beat. To accomplish this goal we've implemented a large number of optimizations: - -- Usage of bump memory allocators and double-buffering -- Compile-time hashing of templates -- Automatic component memoization -- Fiber-like scheduler -- DOM Patch Batching - -Dioxus is humbly built off the work done by [Dodrio](https://github.com/fitzgen/dodrio), a now-archived research project by fitzgen exploring the use of bump allocators in UI frameworks. - -Dioxus is _substantially_ more performant than many of the other Rust DOM-based UI libraries (Yew/Percy) and is _significantly_ more performant than React - roughly competitive with InfernoJS. While not as performant as libraries like SolidJS/Sycamore, Dioxus imposes roughly a ~3% overhead over DOM patching, so it's _plenty_ fast. - -## Works on Desktop and Mobile - -We’ve mentioned before that Dioxus works practically anywhere that Rust does. When running natively as a desktop or mobile app, your Dioxus code will run on its own thread, not inside of a web runtime. This means you can access hardware, file system, and platform APIs directly without needing to go through a shim layer. In our examples, we feature a [file explorer app](https://github.com/DioxusLabs/example-projects/tree/master/file-explorer) and [WiFi scanner app](https://github.com/DioxusLabs/example-projects/tree/master/wifi-scanner) where platform access occurs inside an asynchronous multithreaded coroutine. This solves the problem faced by React Native and other cross-platform toolkits where JavaScript apps incur a massive performance penalty with substantial maintenance overhead associated with platform API shims. - -A desktop app: - -[![Example Dioxus desktop app](https://github.com/DioxusLabs/example-projects/raw/master/file-explorer/image.png)](https://github.com/DioxusLabs/example-projects/blob/master/file-explorer) - -A mobile app: - -[![Example Dioxus mobile app](https://github.com/DioxusLabs/example-projects/raw/master/ios_demo/assets/screenshot_smaller.jpeg)](https://github.com/DioxusLabs/example-projects/blob/master/ios_demo) - -However, be warned that mobile is currently considered very experimental and there will likely be quirks. Dioxus is leveraging the work done by the [Tauri](https://github.com/tauri-apps/tauri) team to enable mobile support, and mobile support isn't technically complete in Tauri yet. - -iOS should be supported out of the box, but Android support will take custom some boilerplate that hasn't been completely figured out. If you're interested in contributing to Dioxus, improving mobile support would be extremely helpful. - -### Did someone say TUI support? - -Yes, you can even build terminal user interfaces with Dioxus. Full support is still a work in progress, but the foundation is there. - -[![TUI Support](https://github.com/DioxusLabs/rink/raw/master/examples/example.png)](https://github.com/dioxusLabs/rink) - -### Things we didn't cover: - -There are a bunch of things we didn't talk about here. Check out the guide for more information, or peruse the examples and reference for more context. - -- Jank-free rendering with fiber scheduler -- [Support for borrowed props]() -- [Conditional rendering]() -- [CSS/Styling/Inline style support]() -- [Support for inline Context Providing/Consuming]() -- [First-class global state management]() - -For a quick glance at party with React, check out the [Readme on Github](https://github.com/DioxusLabs/dioxus#parity-with-react). - -## What's on the roadmap? - -The world of Rust on the frontend is barely explored. Given the performance, ergonomics, and portability of Rust/Dioxus, we expect there to be a ton of different applications where having a React-like toolkit running natively can enable things previously considered impossible. - -In the coming weeks, our plan is to finish the remaining outstanding features where Dioxus is lacking in comparison to React: - -- Transition effects for Suspense -- Micro-optimizations and better cross-platform/browser bug mitigations -- Heuristics to guide the diffing algorithm -- Better support for subtree memoization (signals, etc.) -- More thorough documentation, fleshing out sore spots - -We also need some help in important crates currently missing: - -- First class cross-platform router (currently in progress) -- An extension to DioxusStudio that enables lazy bundling of static assets -- Animation library (see [React Spring](https://react-spring.io/), [Framer Motion](https://www.framer.com/motion/)) -- A [TUI renderer for Dioxus](https://github.com/dioxuslabs/rink) (see [Ink](https://github.com/vadimdemedes/ink)) - -And finally, some bigger, forward-thinking projects that are too big for a one-person team: - -- Completely native renderer for the Dioxus Virtual DOM (see [Flutter](https://flutter.dev/)) -- Better support for LiveView -- Code-splitting -- 3D renderer (see [react-three-fiber](https://github.com/pmndrs/react-three-fiber)) - -Stay tuned for our next article, which will go over some of the optimization techniques that went into making Dioxus blazing fast. - -## Community - -The future is bright for Rust frontends! If you'd like to get involved, we have a [Discord server](https://discord.gg/XgGxMSkvUM), [a subreddit](http://reddit.com/r/dioxus), and [GitHub discussion pages](https://github.com/DioxusLabs/dioxus/discussions). - -Let us know what you build! - -Check out the original `/r/rust` thread here. diff --git a/docs/router/.gitignore b/docs/router/.gitignore deleted file mode 100644 index 7585238ef..000000000 --- a/docs/router/.gitignore +++ /dev/null @@ -1 +0,0 @@ -book diff --git a/docs/router/Cargo.toml b/docs/router/Cargo.toml deleted file mode 100644 index 59e8861ad..000000000 --- a/docs/router/Cargo.toml +++ /dev/null @@ -1,14 +0,0 @@ -[package] -name = "dioxus-router-guide" -version = "0.0.1" -edition = "2021" -description = "Dioxus router guide, including testable examples" -license = "MIT OR Apache-2.0" -publish = false - -[dev-dependencies] -dioxus = { path = "../../packages/dioxus" } -dioxus-desktop = { path = "../../packages/desktop" } -dioxus-web = { path = "../../packages/web" } -dioxus-ssr = { path = "../../packages/ssr" } -dioxus-router = { path = "../../packages/router" } diff --git a/docs/router/README.md b/docs/router/README.md deleted file mode 100644 index 7219b47a4..000000000 --- a/docs/router/README.md +++ /dev/null @@ -1,7 +0,0 @@ -# The router book - -## How to run the tests -- Navigate your terminal to this directory -- Run `cargo clean` -- Run `cargo build --all --F regex -F serde -F web` -- Run `mdbook test -L ../../target/debug/deps/` diff --git a/docs/router/book.toml b/docs/router/book.toml deleted file mode 100644 index e2000ca82..000000000 --- a/docs/router/book.toml +++ /dev/null @@ -1,9 +0,0 @@ -[book] -authors = ["Jonathan Kelley"] -language = "en" -multilingual = false -src = "src" -title = "Dioxus Router" - -[rust] -edition = "2021" diff --git a/docs/router/examples/catch_all.rs b/docs/router/examples/catch_all.rs deleted file mode 100644 index 0e989b7a6..000000000 --- a/docs/router/examples/catch_all.rs +++ /dev/null @@ -1,48 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; -use dioxus_router::prelude::*; - -// ANCHOR: router -#[derive(Routable, Clone)] -enum Route { - #[route("/")] - Home {}, - // PageNotFound is a catch all route that will match any route and placing the matched segments in the route field - #[route("/:..route")] - PageNotFound { route: Vec }, -} -// ANCHOR_END: router - -// ANCHOR: app -#[inline_props] -fn App(cx: Scope) -> Element { - render! { - Router:: {} - } -} -// ANCHOR_END: app - -// ANCHOR: home -#[inline_props] -fn Home(cx: Scope) -> Element { - render! { - h1 { "Welcome to the Dioxus Blog!" } - } -} -// ANCHOR_END: home - -// ANCHOR: fallback -#[inline_props] -fn PageNotFound(cx: Scope, route: Vec) -> Element { - render! { - h1 { "Page not found" } - p { "We are terribly sorry, but the page you requested doesn't exist." } - pre { - color: "red", - "log:\nattemped to navigate to: {route:?}" - } - } -} -// ANCHOR_END: fallback - -fn main() {} diff --git a/docs/router/examples/catch_all_segments.rs b/docs/router/examples/catch_all_segments.rs deleted file mode 100644 index ce84a84db..000000000 --- a/docs/router/examples/catch_all_segments.rs +++ /dev/null @@ -1,24 +0,0 @@ -#![allow(non_snake_case, unused)] -use dioxus::prelude::*; -use dioxus_router::prelude::*; - -// ANCHOR: route -#[derive(Routable, Clone)] -#[rustfmt::skip] -enum Route { - // segments that start with :... are catch all segments - #[route("/blog/:..segments")] - BlogPost { - // You must include catch all segment in child variants - segments: Vec, - }, -} - -// Components must contain the same catch all segments as their corresponding variant -#[inline_props] -fn BlogPost(cx: Scope, segments: Vec) -> Element { - todo!() -} -// ANCHOR_END: route - -fn main() {} diff --git a/docs/router/examples/dynamic_route.rs b/docs/router/examples/dynamic_route.rs deleted file mode 100644 index f8a103e7c..000000000 --- a/docs/router/examples/dynamic_route.rs +++ /dev/null @@ -1,115 +0,0 @@ -#![allow(non_snake_case)] - -use dioxus::prelude::*; -use dioxus_router::prelude::*; - -fn main() { - #[cfg(target_arch = "wasm32")] - dioxus_web::launch(App); - #[cfg(not(target_arch = "wasm32"))] - dioxus_desktop::launch(App); -} - -// ANCHOR: router -#[derive(Routable, Clone)] -#[rustfmt::skip] -enum Route { - #[layout(NavBar)] - #[route("/")] - Home {}, - #[nest("/blog")] - #[layout(Blog)] - #[route("/")] - BlogList {}, - #[route("/blog/:name")] - BlogPost { name: String }, - #[end_layout] - #[end_nest] - #[end_layout] - #[route("/:..route")] - PageNotFound { - route: Vec, - }, -} -// ANCHOR_END: router - -fn App(cx: Scope) -> Element { - render! { - Router:: {} - } -} - -#[inline_props] -fn NavBar(cx: Scope) -> Element { - render! { - nav { - ul { - li { Link { to: Route::Home {}, "Home" } } - li { Link { to: Route::BlogList {}, "Blog" } } - } - } - Outlet:: {} - } -} - -#[inline_props] -fn Home(cx: Scope) -> Element { - render! { - h1 { "Welcome to the Dioxus Blog!" } - } -} - -// ANCHOR: blog -#[inline_props] -fn Blog(cx: Scope) -> Element { - render! { - h1 { "Blog" } - Outlet:: {} - } -} -// ANCHOR_END: blog - -// ANCHOR: blog_list -#[inline_props] -fn BlogList(cx: Scope) -> Element { - render! { - h2 { "Choose a post" } - ul { - li { - Link { - to: Route::BlogPost { name: "Blog post 1".into() }, - "Read the first blog post" - } - } - li { - Link { - to: Route::BlogPost { name: "Blog post 2".into() }, - "Read the second blog post" - } - } - } - } -} -// ANCHOR_END: blog_list - -// ANCHOR: blog_post -// The name prop comes from the /:name route segment -#[inline_props] -fn BlogPost(cx: Scope, name: String) -> Element { - render! { - h2 { "Blog Post: {name}"} - } -} -// ANCHOR_END: blog_post - -#[inline_props] -fn PageNotFound(cx: Scope, route: Vec) -> Element { - render! { - h1 { "Page not found" } - p { "We are terribly sorry, but the page you requested doesn't exist." } - pre { - color: "red", - "log:\nattemped to navigate to: {route:?}" - } - } -} diff --git a/docs/router/examples/dynamic_segments.rs b/docs/router/examples/dynamic_segments.rs deleted file mode 100644 index 6aee22e6c..000000000 --- a/docs/router/examples/dynamic_segments.rs +++ /dev/null @@ -1,35 +0,0 @@ -#![allow(non_snake_case, unused)] -use dioxus::prelude::*; -use dioxus_router::prelude::*; - -// ANCHOR: route -#[derive(Routable, Clone)] -#[rustfmt::skip] -enum Route { - // segments that start with : are dynamic segments - #[route("/blog/:name")] - BlogPost { - // You must include dynamic segments in child variants - name: String, - }, - #[route("/document/:id")] - Document { - // You can use any type that implements FromStr - // If the segment can't be parsed, the route will not match - id: usize, - }, -} - -// Components must contain the same dynamic segments as their corresponding variant -#[inline_props] -fn BlogPost(cx: Scope, name: String) -> Element { - todo!() -} - -#[inline_props] -fn Document(cx: Scope, id: usize) -> Element { - todo!() -} -// ANCHOR_END: route - -fn main() {} diff --git a/docs/router/examples/external_link.rs b/docs/router/examples/external_link.rs deleted file mode 100644 index ed855e2d3..000000000 --- a/docs/router/examples/external_link.rs +++ /dev/null @@ -1,28 +0,0 @@ -#![allow(non_snake_case, unused)] - -use dioxus::prelude::*; -use dioxus_router::prelude::*; - -#[derive(Routable, Clone)] -enum Route { - #[route("/")] - Home {}, -} - -#[inline_props] -fn Home(cx: Scope) -> Element { - todo!() -} - -fn main() {} - -// ANCHOR: component -fn GoToDioxus(cx: Scope) -> Element { - render! { - Link { - to: "https://dioxuslabs.com", - "ExternalTarget target" - } - } -} -// ANCHOR_END: component diff --git a/docs/router/examples/first_route.rs b/docs/router/examples/first_route.rs deleted file mode 100644 index 5afa513f9..000000000 --- a/docs/router/examples/first_route.rs +++ /dev/null @@ -1,36 +0,0 @@ -// ANCHOR: router -#![allow(non_snake_case)] -use dioxus::prelude::*; -use dioxus_router::prelude::*; - -/// An enum of all of the possible routes in the app. -#[derive(Routable, Clone)] -enum Route { - // The home page is at the / route - #[route("/")] - // If the name of the component and variant are the same you can omit the component and props name - // If they are different you can specify them like this: - // #[route("/", ComponentName, PropsName)] - Home {}, -} -// ANCHOR_END: router - -// ANCHOR: app -#[inline_props] -fn App(cx: Scope) -> Element { - render! { - Router:: {} - } -} -// ANCHOR_END: app - -// ANCHOR: home -#[inline_props] -fn Home(cx: Scope) -> Element { - render! { - h1 { "Welcome to the Dioxus Blog!" } - } -} -// ANCHOR_END: home - -fn main() {} diff --git a/docs/router/examples/full_example.rs b/docs/router/examples/full_example.rs deleted file mode 100644 index 11465c38f..000000000 --- a/docs/router/examples/full_example.rs +++ /dev/null @@ -1,112 +0,0 @@ -#![allow(non_snake_case)] - -use dioxus::prelude::*; -use dioxus_router::prelude::*; - -fn main() { - #[cfg(target_arch = "wasm32")] - dioxus_web::launch(App); - #[cfg(not(target_arch = "wasm32"))] - dioxus_desktop::launch(App); -} - -// ANCHOR: router -#[derive(Routable, Clone)] -#[rustfmt::skip] -enum Route { - #[layout(NavBar)] - #[route("/")] - Home {}, - #[nest("/blog")] - #[layout(Blog)] - #[route("/")] - BlogList {}, - #[route("/blog/:name")] - BlogPost { name: String }, - #[end_layout] - #[end_nest] - #[end_layout] - #[nest("/myblog")] - #[redirect("/", || Route::BlogList {})] - #[redirect("/:name", |name: String| Route::BlogPost { name })] - #[end_nest] - #[route("/:..route")] - PageNotFound { - route: Vec, - }, -} -// ANCHOR_END: router - -fn App(cx: Scope) -> Element { - render! { - Router:: {} - } -} - -#[inline_props] -fn NavBar(cx: Scope) -> Element { - render! { - nav { - ul { - li { Link { to: Route::Home {}, "Home" } } - li { Link { to: Route::BlogList {}, "Blog" } } - } - } - Outlet:: {} - } -} - -#[inline_props] -fn Home(cx: Scope) -> Element { - render! { - h1 { "Welcome to the Dioxus Blog!" } - } -} - -#[inline_props] -fn Blog(cx: Scope) -> Element { - render! { - h1 { "Blog" } - Outlet:: {} - } -} - -#[inline_props] -fn BlogList(cx: Scope) -> Element { - render! { - h2 { "Choose a post" } - ul { - li { - Link { - to: Route::BlogPost { name: "Blog post 1".into() }, - "Read the first blog post" - } - } - li { - Link { - to: Route::BlogPost { name: "Blog post 2".into() }, - "Read the second blog post" - } - } - } - } -} - -#[inline_props] -fn BlogPost(cx: Scope, name: String) -> Element { - render! { - h2 { "Blog Post: {name}"} - } -} - -#[inline_props] -fn PageNotFound(cx: Scope, route: Vec) -> Element { - render! { - h1 { "Page not found" } - p { "We are terribly sorry, but the page you requested doesn't exist." } - pre { - color: "red", - "log:\nattemped to navigate to: {route:?}" - } - } -} diff --git a/docs/router/examples/history_buttons.rs b/docs/router/examples/history_buttons.rs deleted file mode 100644 index 971549aa5..000000000 --- a/docs/router/examples/history_buttons.rs +++ /dev/null @@ -1,30 +0,0 @@ -#![allow(non_snake_case, unused)] -use dioxus::prelude::*; -use dioxus_router::prelude::*; - -#[derive(Routable, Clone)] -#[rustfmt::skip] -enum Route { - #[route("/")] - Home {}, -} - -#[inline_props] -fn Home(cx: Scope) -> Element { - todo!() -} - -// ANCHOR: history_buttons -fn HistoryNavigation(cx: Scope) -> Element { - render! { - GoBackButton { - "Back to the Past" - } - GoForwardButton { - "Back to the Future" /* You see what I did there? πŸ˜‰ */ - } - } -} -// ANCHOR_END: history_buttons - -fn main() {} diff --git a/docs/router/examples/history_provider.rs b/docs/router/examples/history_provider.rs deleted file mode 100644 index 57ec27732..000000000 --- a/docs/router/examples/history_provider.rs +++ /dev/null @@ -1,29 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; -use dioxus_router::prelude::*; - -#[derive(Routable, Clone)] -enum Route { - #[route("/")] - Home {}, -} - -// ANCHOR: app -#[inline_props] -fn App(cx: Scope) -> Element { - render! { - Router:: { - config: || RouterConfig::default().history(WebHistory::default()) - } - } -} -// ANCHOR_END: app - -#[inline_props] -fn Home(cx: Scope) -> Element { - render! { - h1 { "Welcome to the Dioxus Blog!" } - } -} - -fn main() {} diff --git a/docs/router/examples/links.rs b/docs/router/examples/links.rs deleted file mode 100644 index 356e9c0a7..000000000 --- a/docs/router/examples/links.rs +++ /dev/null @@ -1,72 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; -use dioxus_router::prelude::*; - -// ANCHOR: router -#[derive(Routable, Clone)] -#[rustfmt::skip] -enum Route { - // All routes under the NavBar layout will be rendered inside of the NavBar Outlet - #[layout(NavBar)] - #[route("/")] - Home {}, - #[end_layout] - #[route("/:..route")] - PageNotFound { route: Vec }, -} -// ANCHOR_END: router - -// ANCHOR: nav -#[inline_props] -fn NavBar(cx: Scope) -> Element { - render! { - nav { - ul { - li { - Link { - // The Link component will navigate to the route specified - // in the target prop which is checked to exist at compile time - to: Route::Home {}, - "Home" - } - } - } - } - Outlet:: {} - } -} -// ANCHOR_END: nav - -// ANCHOR: app -#[inline_props] -fn App(cx: Scope) -> Element { - render! { - Router:: {} - } -} -// ANCHOR_END: app - -// ANCHOR: home -#[inline_props] -fn Home(cx: Scope) -> Element { - render! { - h1 { "Welcome to the Dioxus Blog!" } - } -} -// ANCHOR_END: home - -// ANCHOR: fallback -#[inline_props] -fn PageNotFound(cx: Scope, route: Vec) -> Element { - render! { - h1 { "Page not found" } - p { "We are terribly sorry, but the page you requested doesn't exist." } - pre { - color: "red", - "log:\nattemped to navigate to: {route:?}" - } - } -} -// ANCHOR_END: fallback - -fn main() {} diff --git a/docs/router/examples/navigator.rs b/docs/router/examples/navigator.rs deleted file mode 100644 index 9f32b7c12..000000000 --- a/docs/router/examples/navigator.rs +++ /dev/null @@ -1,56 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; -use dioxus_router::prelude::*; - -#[derive(Routable, Clone)] -#[rustfmt::skip] -enum Route { - #[route("/")] - Home {}, - #[route("/:..route")] - PageNotFound { route: Vec }, -} - -#[inline_props] -fn App(cx: Scope) -> Element { - render! { - Router:: {} - } -} - -// ANCHOR: nav -#[inline_props] -fn Home(cx: Scope) -> Element { - let nav = use_navigator(cx); - - // push - nav.push(Route::PageNotFound { route: vec![] }); - - // replace - nav.replace(Route::Home {}); - - // go back - nav.go_back(); - - // go forward - nav.go_forward(); - - render! { - h1 { "Welcome to the Dioxus Blog!" } - } -} -// ANCHOR_END: nav - -#[inline_props] -fn PageNotFound(cx: Scope, route: Vec) -> Element { - render! { - h1 { "Page not found" } - p { "We are terribly sorry, but the page you requested doesn't exist." } - pre { - color: "red", - "log:\nattemped to navigate to: {route:?}" - } - } -} - -fn main() {} diff --git a/docs/router/examples/nest.rs b/docs/router/examples/nest.rs deleted file mode 100644 index f7fe2137c..000000000 --- a/docs/router/examples/nest.rs +++ /dev/null @@ -1,40 +0,0 @@ -#![allow(non_snake_case, unused)] -use dioxus::prelude::*; -use dioxus_router::prelude::*; - -// ANCHOR: route -#[derive(Routable, Clone)] -// Skipping formatting allows you to indent nests -#[rustfmt::skip] -enum Route { - // Start the /blog nest - #[nest("/blog")] - // You can nest as many times as you want - #[nest("/:id")] - #[route("/post")] - PostId { - // You must include parent dynamic segments in child variants - id: usize, - }, - // End nests manually with #[end_nest] - #[end_nest] - #[route("/:id")] - // The absolute route of BlogPost is /blog/:name - BlogPost { - id: usize, - }, - // Or nests are ended automatically at the end of the enum -} - -#[inline_props] -fn BlogPost(cx: Scope, id: usize) -> Element { - todo!() -} - -#[inline_props] -fn PostId(cx: Scope, id: usize) -> Element { - todo!() -} -// ANCHOR_END: route - -fn main() {} diff --git a/docs/router/examples/nested_routes.rs b/docs/router/examples/nested_routes.rs deleted file mode 100644 index 63e080016..000000000 --- a/docs/router/examples/nested_routes.rs +++ /dev/null @@ -1,66 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; -use dioxus_router::prelude::*; - -// ANCHOR: router -#[derive(Routable, Clone)] -#[rustfmt::skip] -enum Route { - // All routes under the NavBar layout will be rendered inside of the NavBar Outlet - #[layout(NavBar)] - #[route("/")] - Home {}, - #[end_layout] - #[route("/:..route")] - PageNotFound { route: Vec }, -} -// ANCHOR_END: router - -// ANCHOR: nav -#[inline_props] -fn NavBar(cx: Scope) -> Element { - render! { - nav { - ul { - li { "links" } - } - } - // The Outlet component will render child routes (In this case just the Home component) inside the Outlet component - Outlet:: {} - } -} -// ANCHOR_END: nav - -// ANCHOR: app -#[inline_props] -fn App(cx: Scope) -> Element { - render! { - Router:: {} - } -} -// ANCHOR_END: app - -// ANCHOR: home -#[inline_props] -fn Home(cx: Scope) -> Element { - render! { - h1 { "Welcome to the Dioxus Blog!" } - } -} -// ANCHOR_END: home - -// ANCHOR: fallback -#[inline_props] -fn PageNotFound(cx: Scope, route: Vec) -> Element { - render! { - h1 { "Page not found" } - p { "We are terribly sorry, but the page you requested doesn't exist." } - pre { - color: "red", - "log:\nattemped to navigate to: {route:?}" - } - } -} -// ANCHOR_END: fallback - -fn main() {} diff --git a/docs/router/examples/outlet.rs b/docs/router/examples/outlet.rs deleted file mode 100644 index 5c7ee8dbf..000000000 --- a/docs/router/examples/outlet.rs +++ /dev/null @@ -1,46 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; -use dioxus_router::prelude::*; - -// ANCHOR: outlet -#[derive(Routable, Clone)] -#[rustfmt::skip] -enum Route { - #[layout(Wrapper)] - #[route("/")] - Index {}, -} - -#[inline_props] -fn Wrapper(cx: Scope) -> Element { - render! { - header { "header" } - // The index route will be rendered here - Outlet:: { } - footer { "footer" } - } -} - -#[inline_props] -fn Index(cx: Scope) -> Element { - render! { - h1 { "Index" } - } -} -// ANCHOR_END: outlet - -fn App(cx: Scope) -> Element { - render! { - Router:: {} - } -} - -fn main() { - let mut vdom = VirtualDom::new(App); - let _ = vdom.rebuild(); - let html = dioxus_ssr::render(&vdom); - assert_eq!( - html, - "
header

Index

footer
" - ); -} diff --git a/docs/router/examples/query_segments.rs b/docs/router/examples/query_segments.rs deleted file mode 100644 index 1f3c068ac..000000000 --- a/docs/router/examples/query_segments.rs +++ /dev/null @@ -1,24 +0,0 @@ -#![allow(non_snake_case, unused)] -use dioxus::prelude::*; -use dioxus_router::prelude::*; - -// ANCHOR: route -#[derive(Routable, Clone)] -#[rustfmt::skip] -enum Route { - // segments that start with ?: are query segments - #[route("/blog?:name")] - BlogPost { - // You must include query segments in child variants - name: String, - }, -} - -// Components must contain the same query segments as their corresponding variant -#[inline_props] -fn BlogPost(cx: Scope, name: String) -> Element { - todo!() -} -// ANCHOR_END: route - -fn main() {} diff --git a/docs/router/examples/router_cfg.rs b/docs/router/examples/router_cfg.rs deleted file mode 100644 index 5fd0402af..000000000 --- a/docs/router/examples/router_cfg.rs +++ /dev/null @@ -1,37 +0,0 @@ -// ANCHOR: router -#![allow(non_snake_case)] -use dioxus::prelude::*; -use dioxus_router::prelude::*; - -/// An enum of all of the possible routes in the app. -#[derive(Routable, Clone)] -enum Route { - // The home page is at the / route - #[route("/")] - // If the name of the component and variant are the same you can omit the component and props name - // #[route("/", ComponentName, PropsName)] - Home {}, -} -// ANCHOR_END: router - -// ANCHOR: app -#[inline_props] -fn App(cx: Scope) -> Element { - render! { - Router:: { - config: || RouterConfig::default().history(WebHistory::default()) - } - } -} -// ANCHOR_END: app - -// ANCHOR: home -#[inline_props] -fn Home(cx: Scope) -> Element { - render! { - h1 { "Welcome to the Dioxus Blog!" } - } -} -// ANCHOR_END: home - -fn main() {} diff --git a/docs/router/examples/routing_update.rs b/docs/router/examples/routing_update.rs deleted file mode 100644 index a7f83d633..000000000 --- a/docs/router/examples/routing_update.rs +++ /dev/null @@ -1,41 +0,0 @@ -#![allow(non_snake_case, unused)] -use dioxus::prelude::*; -use dioxus_router::prelude::*; - -// ANCHOR: router -#[derive(Routable, Clone, PartialEq)] -enum Route { - #[route("/")] - Index {}, - #[route("/home")] - Home {}, -} - -#[inline_props] -fn Home(cx: Scope) -> Element { - render! { - p { "Home" } - } -} - -#[inline_props] -fn Index(cx: Scope) -> Element { - render! { - p { "Index" } - } -} - -fn app(cx: Scope) -> Element { - render! { - Router:: { - config: || RouterConfig::default().on_update(|state|{ - (state.current() == Route::Index {}).then_some( - NavigationTarget::Internal(Route::Home {}) - ) - }) - } - } -} -// ANCHOR_END: router - -fn main() {} diff --git a/docs/router/examples/static_segments.rs b/docs/router/examples/static_segments.rs deleted file mode 100644 index 54c045765..000000000 --- a/docs/router/examples/static_segments.rs +++ /dev/null @@ -1,28 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; -use dioxus_router::prelude::*; - -// ANCHOR: route -#[derive(Routable, Clone)] -#[rustfmt::skip] -enum Route { - // Routes always start with a slash - #[route("/")] - Home {}, - // You can have multiple segments in a route - #[route("/hello/world")] - HelloWorld {}, -} - -#[inline_props] -fn Home(cx: Scope) -> Element { - todo!() -} - -#[inline_props] -fn HelloWorld(cx: Scope) -> Element { - todo!() -} -// ANCHOR_END: route - -fn main() {} diff --git a/docs/router/src/SUMMARY.md b/docs/router/src/SUMMARY.md deleted file mode 100644 index 19ffb2ca7..000000000 --- a/docs/router/src/SUMMARY.md +++ /dev/null @@ -1,25 +0,0 @@ -# Summary - -[Introduction](./index.md) - -# Example Project - -- [Overview](./example/index.md) -- [Creating Our First Route](./example/first-route.md) -- [Building a Nest](./example/building-a-nest.md) -- [Navigation Targets](./example/navigation-targets.md) -- [Redirection Perfection](./example/redirection-perfection.md) -- [Full Code](./example/full-code.md) - -# Reference - -- [Adding the Router to Your Application](./reference/index.md) -- [Defining Routes](./reference/routes/index.md) - - [Nested Routes](./reference/routes/nested.md) -- [Layouts](./reference/layouts.md) -- [Navigation](./reference/navigation/index.md) - - [Programmatic Navigation](./reference/navigation/programmatic.md) -- [History Providers](./reference/history-providers.md) -- [History Buttons](./reference/history-buttons.md) -- [Static Generation](./reference/static-generation.md) -- [Routing Update Callback](./reference/routing-update-callback.md) diff --git a/docs/router/src/example/building-a-nest.md b/docs/router/src/example/building-a-nest.md deleted file mode 100644 index 426194f48..000000000 --- a/docs/router/src/example/building-a-nest.md +++ /dev/null @@ -1,99 +0,0 @@ -# Building a Nest - -In this chapter, we will begin to build the blog portion of our site which will -include links, nested routes, and route parameters. - -## Site Navigation - -Our site visitors won't know all the available pages and blogs on our site so we -should provide a navigation bar for them. Our navbar will be a list of links going between our pages. - -We want our navbar component to be rendered on several different pages on our site. Instead of duplicating the code, we can create a component that wraps all children routes. This is called a layout component. To tell the router where to render the child routes, we use the [`Outlet`] component. - -Let's create a new `NavBar` component: - -```rust, no_run -{{#include ../../examples/nested_routes.rs:nav}} -``` - -Next, let's add our `NavBar` component as a layout to our Route enum: - -```rust, no_run -{{#include ../../examples/nested_routes.rs:router}} -``` - -To add links to our `NavBar`, we could always use an HTML anchor element but that has two issues: - -1. It causes a full-page reload -2. We can accidentally link to a page that doesn't exist - -Instead, we want to use the [`Link`] component provided by Dioxus Router. - -The [`Link`] is similar to a regular `` tag. It takes a target and children. - -Unlike a regular `` tag, we can pass in our Route enum as the target. Because we annotated our routes with the [`route(path)`] attribute, the [`Link`] will know how to generate the correct URL. If we use the Route enum, the rust compiler will prevent us from linking to a page that doesn't exist. - -Let's add our links: - -```rust, no_run -{{#include ../../examples/links.rs:nav}} -``` - -> Using this method, the [`Link`] component only works for links within our -> application. To learn more about navigation targets see -> [here](./navigation-targets.md). - -Now you should see a list of links near the top of your page. Click on one and -you should seamlessly travel between pages. - -## URL Parameters and Nested Routes - -Many websites such as GitHub put parameters in their URL. For example, -`https://github.com/DioxusLabs` utilizes the text after the domain to -dynamically search and display content about an organization. - -We want to store our blogs in a database and load them as needed. We also -want our users to be able to send people a link to a specific blog post. -Instead of listing all of the blog titles at compile time, we can make a dynamic route. - -We could utilize a search page that loads a blog when clicked but then our users -won't be able to share our blogs easily. This is where URL parameters come in. - -The path to our blog will look like `/blog/myBlogPage`, `myBlogPage` being the -URL parameter. - -First, let's create a layout component (similar to the navbar) that wraps the blog content. This allows us to add a heading that tells the user they are on the blog. - -```rust, no_run -{{#include ../../examples/dynamic_route.rs:blog}} -``` - -Now we'll create another index component, that'll be displayed when no blog post -is selected: - -```rust, no_run -{{#include ../../examples/dynamic_route.rs:blog_list}} -``` - -We also need to create a component that displays an actual blog post. This component will accept the URL parameters as props: - -```rust, no_run -{{#include ../../examples/dynamic_route.rs:blog_post}} -``` - -Finally, let's tell our router about those components: - -```rust, no_run -{{#include ../../examples/dynamic_route.rs:router}} -``` - -That's it! If you head to `/blog/1` you should see our sample post. - -## Conclusion - -In this chapter, we utilized Dioxus Router's Link, and Route Parameter -functionality to build the blog portion of our application. In the next chapter, -we will go over how navigation targets (like the one we passed to our links) -work. - -[`Link`]: https://docs.rs/dioxus-router/latest/dioxus_router/prelude/fn.GenericLink.html diff --git a/docs/router/src/example/first-route.md b/docs/router/src/example/first-route.md deleted file mode 100644 index 5135f6a8f..000000000 --- a/docs/router/src/example/first-route.md +++ /dev/null @@ -1,62 +0,0 @@ -# Creating Our First Route - -In this chapter, we will start utilizing Dioxus Router and add a homepage and a -404 page to our project. - -## Fundamentals - -The core of the Dioxus Router is the [`Routable`] macro and the [`Router`] component. - -First, we need an actual page to route to! Let's add a homepage component: - -```rust, no_run -{{#include ../../examples/first_route.rs:home}} -``` - -## Creating Routes - -We want to use Dioxus Router to separate our application into different "pages". -Dioxus Router will then determine which page to render based on the URL path. - -To start using Dioxus Router, we need to use the [`Routable`] macro. - -The [`Routable`] macro takes an enum with all of the possible routes in our application. Each variant of the enum represents a route and must be annotated with the [`route(path)`] attribute. - -```rust, no_run -{{#include ../../examples/first_route.rs:router}} -``` - -All other hooks and components the router provides can only be used as a descendant of a [`Router`] component. - -If you head to your application's browser tab, you should now see the text -`Welcome to Dioxus Blog!` when on the root URL (`http://localhost:8080/`). If -you enter a different path for the URL, nothing should be displayed. - -This is because we told Dioxus Router to render the `Home` component only when -the URL path is `/`. - -## Fallback Route - -In our example, when a route doesn't exist Dioxus Router doesn't render anything. Many sites also have a "404" page when a path does not exist. Let's add one to our site. - -First, we create a new `PageNotFound` component. - -```rust, no_run -{{#include ../../examples/catch_all.rs:fallback}} -``` - -Next, register the route in the Route enum to match if all other routes fail. - -```rust, no_run -{{#include ../../examples/catch_all.rs:router}} -``` - -Now when you go to a route that doesn't exist, you should see the page not found -text. - -## Conclusion - -In this chapter, we learned how to create a route and tell Dioxus Router what -component to render when the URL path is `/`. We also created a 404 page to -handle when a route doesn't exist. Next, we'll create the blog portion of our -site. We will utilize nested routes and URL parameters. diff --git a/docs/router/src/example/full-code.md b/docs/router/src/example/full-code.md deleted file mode 100644 index ca97812a5..000000000 --- a/docs/router/src/example/full-code.md +++ /dev/null @@ -1,5 +0,0 @@ -# Full Code - -```rust, no_run -{{#include ../../examples/full_example.rs}} -``` diff --git a/docs/router/src/example/index.md b/docs/router/src/example/index.md deleted file mode 100644 index 064c9ac68..000000000 --- a/docs/router/src/example/index.md +++ /dev/null @@ -1,29 +0,0 @@ -# Overview - -In this guide, you'll learn to effectively use Dioxus Router whether you're -building a small todo app or the next FAANG company. We will create a small -website with a blog, homepage, and more! - -> To follow along with the router example, you'll need a working Dioxus app. -> Check out the [Dioxus book](https://dioxuslabs.com/docs/0.3/guide/en/) to get started. - -> Make sure to add Dioxus Router as a dependency, as explained in the -> [introduction](../index.md). - -## You'll learn how to - -- Create routes and render "pages". -- Utilize nested routes, create a navigation bar, and render content for a - set of routes. -- Parse URL parameters to dynamically display content. -- Redirect visitors to different routes. - -> **Disclaimer** -> -> The example will only display the features of Dioxus Router. It will not -> include any actual functionality. To keep things simple we will only be using -> a single file, this is not the recommended way of doing things with a real -> application. - -You can find the complete application in the [full code](./full-code.md) -chapter. diff --git a/docs/router/src/example/navigation-targets.md b/docs/router/src/example/navigation-targets.md deleted file mode 100644 index fb12f913f..000000000 --- a/docs/router/src/example/navigation-targets.md +++ /dev/null @@ -1,27 +0,0 @@ -# Navigation Targets - -In the previous chapter, we learned how to create links to pages within our app. -We told them where to go using the `target` property. This property takes something that can be converted to a [`NavigationTarget`]. - -## What is a navigation target? - -A [`NavigationTarget`] is similar to the `href` of an HTML anchor element. It -tells the router where to navigate to. The Dioxus Router knows two kinds of -navigation targets: - -- [`Internal`]: We used internal links in the previous chapter. It's a link to a page within our - app represented as a Route enum. -- [`External`]: This works exactly like an HTML anchors' `href`. Don't use this for in-app - navigation as it will trigger a page reload by the browser. - -## External navigation - -If we need a link to an external page we can do it like this: - -```rust, no_run -{{#include ../../examples/external_link.rs:component}} -``` - -[`External`]: https://docs.rs/dioxus-router-core/latest/dioxus_router/navigation/enum.NavigationTarget.html#variant.External -[`Internal`]: https://docs.rs/dioxus-router-core/latest/dioxus_router/navigation/enum.NavigationTarget.html#variant.Internal -[`NavigationTarget`]: https://docs.rs/dioxus-router-core/latest/dioxus_router/navigation/enum.NavigationTarget.html diff --git a/docs/router/src/example/redirection-perfection.md b/docs/router/src/example/redirection-perfection.md deleted file mode 100644 index 1ad4950ae..000000000 --- a/docs/router/src/example/redirection-perfection.md +++ /dev/null @@ -1,41 +0,0 @@ -# Redirection Perfection - -You're well on your way to becoming a routing master! - -In this chapter, we will cover creating redirects - -## Creating Redirects - -A redirect is very simple. When dioxus encounters a redirect while finding out -what components to render, it will redirect the user to the target of the -redirect. - -As a simple example, let's say you want user to still land on your blog, even -if they used the path `/myblog` or `/myblog/:name`. - -Redirects are special attributes in the router enum that accept a route and a closure -with the route parameters. The closure should return a route to redirect to. - -Let's add a redirect to our router enum: - -```rust, no_run -{{#include ../../examples/full_example.rs:router}} -``` - -That's it! Now your users will be redirected to the blog. - -### Conclusion - -Well done! You've completed the Dioxus Router guide. You've built a small -application and learned about the many things you can do with Dioxus Router. -To continue your journey, you attempt a challenge listed below, look at the [router examples](https://github.com/DioxusLabs/dioxus/tree/master/packages/router/examples), or -can check out the [API reference](https://docs.rs/dioxus-router/). - -### Challenges - -- Organize your components into separate files for better maintainability. -- Give your app some style if you haven't already. -- Build an about page so your visitors know who you are. -- Add a user system that uses URL parameters. -- Create a simple admin system to create, delete, and edit blogs. -- If you want to go to the max, hook up your application to a rest API and database. diff --git a/docs/router/src/index.md b/docs/router/src/index.md deleted file mode 100644 index 56a7d5deb..000000000 --- a/docs/router/src/index.md +++ /dev/null @@ -1,27 +0,0 @@ -# Introduction - -> If you are not familiar with Dioxus itself, check out the [Dioxus book](https://dioxuslabs.com/docs/0.3/guide/en/) first. - -Whether you are building a website, desktop app, or mobile app, -splitting your app's views into "pages" can be an effective method for -organization and maintainability. - -For this purpose, Dioxus provides a router. Use the `cargo add` command to add the dependency: - -```sh -cargo add dioxus-router -``` - -This book is intended to get you up to speed with Dioxus Router. It is split -into two sections: - -1. The [reference](./reference/index.md) section explains individual features in - depth. You can read it from start to finish, or you can read individual chapters - in whatever order you want. -2. If you prefer a learning-by-doing approach, you can check out the - _[example project](./example/index.md)_. It guides you through - creating a dioxus app, setting up the router, and using some of its - functionality. - -> Please note that this is not the only documentation for the Dioxus Router. You -> can also check out the [API Docs](https://docs.rs/dioxus-router/). diff --git a/docs/router/src/lib.rs b/docs/router/src/lib.rs deleted file mode 100644 index 97cda56a8..000000000 --- a/docs/router/src/lib.rs +++ /dev/null @@ -1 +0,0 @@ -// empty (we only need this crate for the examples) diff --git a/docs/router/src/reference/history-buttons.md b/docs/router/src/reference/history-buttons.md deleted file mode 100644 index ad3ffbe22..000000000 --- a/docs/router/src/reference/history-buttons.md +++ /dev/null @@ -1,32 +0,0 @@ -# History Buttons - -Some platforms, like web browsers, provide users with an easy way to navigate -through an app's history. They have UI elements or integrate with the OS. - -However, native platforms usually don't provide such amenities, which means that -apps wanting users to have access to them, need to implement them. For this -reason, the router comes with two components, which emulate a browser's back and -forward buttons: - -- [`GoBackButton`](https://docs.rs/dioxus-router/latest/dioxus_router/components/fn.GoBackButton.html) -- [`GoForwardButton`](https://docs.rs/dioxus-router/latest/dioxus_router/components/fn.GoForwardButton.html) - -> If you want to navigate through the history programmatically, take a look at -> [`programmatic navigation`](./navigation/programmatic.md). - -```rust, no_run -{{#include ../../examples/history_buttons.rs:history_buttons}} -``` - -As you might know, browsers usually disable the back and forward buttons if -there is no history to navigate to. The router's history buttons try to do that -too, but depending on the [history provider] that might not be possible. - -Importantly, neither [`WebHistory`] supports that feature. -This is due to limitations of the browser History API. - -However, in both cases, the router will just ignore button presses, if there is -no history to navigate to. - -Also, when using [`WebHistory`], the history buttons might -navigate a user to a history entry outside your app. diff --git a/docs/router/src/reference/history-providers.md b/docs/router/src/reference/history-providers.md deleted file mode 100644 index 6ee11b20f..000000000 --- a/docs/router/src/reference/history-providers.md +++ /dev/null @@ -1,20 +0,0 @@ -# History Providers - -[`HistoryProvider`]s are used by the router to keep track of the navigation history -and update any external state (e.g. the browser's URL). - -The router provides two [`HistoryProvider`]s, but you can also create your own. -The two default implementations are: - -- The [`MemoryHistory`] is a custom implementation that works in memory. -- The [`WebHistory`] integrates with the browser's URL. - -By default, the router uses the [`MemoryHistory`]. It might be changed to use -[`WebHistory`] when the `web` feature is active, but that is not guaranteed. - -You can override the default history: - -```rust, no_run -{{#include ../../examples/history_provider.rs:app}} -``` - diff --git a/docs/router/src/reference/index.md b/docs/router/src/reference/index.md deleted file mode 100644 index add681671..000000000 --- a/docs/router/src/reference/index.md +++ /dev/null @@ -1,23 +0,0 @@ -# Adding the Router to Your Application - -In this chapter, we will learn how to add the router to our app. By itself, this -is not very useful. However, it is a prerequisite for all the functionality -described in the other chapters. - -> Make sure you added the `dioxus-router` dependency as explained in the -> [introduction](../index.md). - -In most cases, we want to add the router to the root component of our app. This -way, we can ensure that we have access to all its functionality everywhere. - -First, we define the router with the router macro: - -```rust, no_run -{{#include ../../examples/first_route.rs:router}} -``` - -Then we render the router with the [`Router`] component. - -```rust, no_run -{{#include ../../examples/first_route.rs:app}} -``` diff --git a/docs/router/src/reference/layouts.md b/docs/router/src/reference/layouts.md deleted file mode 100644 index 525838fb0..000000000 --- a/docs/router/src/reference/layouts.md +++ /dev/null @@ -1,19 +0,0 @@ -# Layouts - -Layouts allow you to wrap all child routes in a component. This can be useful when creating something like a header that will be used in many different routes. - -[`Outlet`] tells the router where to render content in layouts. In the following example, -the Index will be rendered within the [`Outlet`]. - -```rust, no_run -{{#include ../../examples/outlet.rs:outlet}} -``` - -The example above will output the following HTML (line breaks added for -readability): - -```html -
header
-

Index

-
footer
-``` diff --git a/docs/router/src/reference/navigation/index.md b/docs/router/src/reference/navigation/index.md deleted file mode 100644 index 2abf8477e..000000000 --- a/docs/router/src/reference/navigation/index.md +++ /dev/null @@ -1,39 +0,0 @@ -# Links & Navigation - -When we split our app into pages, we need to provide our users with a way to -navigate between them. On regular web pages, we'd use an anchor element for that, -like this: - -```html -Link to an other page -``` - -However, we cannot do that when using the router for three reasons: - -1. Anchor tags make the browser load a new page from the server. This takes a - lot of time, and it is much faster to let the router handle the navigation - client-side. -2. Navigation using anchor tags only works when the app is running inside a - browser. This means we cannot use them inside apps using Dioxus Desktop. -3. Anchor tags cannot check if the target page exists. This means we cannot - prevent accidentally linking to non-existent pages. - -To solve these problems, the router provides us with a [`Link`] component we can -use like this: - -```rust, no_run -{{#include ../../../examples/links.rs:nav}} -``` - -The `target` in the example above is similar to the `href` of a regular anchor -element. However, it tells the router more about what kind of navigation it -should perform. It accepts something that can be converted into a -[`NavigationTarget`]: - -- The example uses a Internal route. This is the most common type of navigation. - It tells the router to navigate to a page within our app by passing a variant of a [`Routable`] enum. This type of navigation can never fail if the link component is used inside a router component. -- [`External`] allows us to navigate to URLs outside of our app. This is useful - for links to external websites. NavigationTarget::External accepts an URL to navigate to. This type of navigation can fail if the URL is invalid. - -> The [`Link`] accepts several props that modify its behavior. See the API docs -> for more details. diff --git a/docs/router/src/reference/navigation/programmatic.md b/docs/router/src/reference/navigation/programmatic.md deleted file mode 100644 index 894dd968e..000000000 --- a/docs/router/src/reference/navigation/programmatic.md +++ /dev/null @@ -1,32 +0,0 @@ -# Programmatic Navigation - -Sometimes we want our application to navigate to another page without having the -user click on a link. This is called programmatic navigation. - -## Using a Navigator - -We can get a navigator with the [`use_navigator`] hook. This hook returns a [`Navigator`]. - -We can use the [`Navigator`] to trigger four different kinds of navigation: - -- `push` will navigate to the target. It works like a regular anchor tag. -- `replace` works like `push`, except that it replaces the current history entry - instead of adding a new one. This means the prior page cannot be restored with the browser's back button. -- `Go back` works like the browser's back button. -- `Go forward` works like the browser's forward button. - -```rust, no_run -{{#include ../../../examples/navigator.rs:nav}} -``` - -You might have noticed that, like [`Link`], the [`Navigator`]s `push` and -`replace` functions take a [`NavigationTarget`]. This means we can use either -[`Internal`], or [`External`] targets. - -## External Navigation Targets - -Unlike a [`Link`], the [`Navigator`] cannot rely on the browser (or webview) to -handle navigation to external targets via a generated anchor element. - -This means, that under certain conditions, navigation to external targets can -fail. diff --git a/docs/router/src/reference/redirects.md b/docs/router/src/reference/redirects.md deleted file mode 100644 index 70ea4d7cd..000000000 --- a/docs/router/src/reference/redirects.md +++ /dev/null @@ -1,13 +0,0 @@ -# Redirects - -In some cases, we may want to redirect our users to another page whenever they -open a specific path. We can tell the router to do this with the `#[redirect]` -attribute. - -The `#[redirect]` attribute accepts a route and a closure with all of the parameters defined in the route. The closure must return a [`NavigationTarget`]. - -In the following example, we will redirect everybody from `/myblog` and `/myblog/:id` to `/blog` and `/blog/:id` respectively - -```rust, no_run -{{#include ../../examples/full_example.rs:router}} -``` diff --git a/docs/router/src/reference/routes/index.md b/docs/router/src/reference/routes/index.md deleted file mode 100644 index 7cd0fe9e5..000000000 --- a/docs/router/src/reference/routes/index.md +++ /dev/null @@ -1,65 +0,0 @@ -# Defining Routes - -When creating a [`Routable`] enum, we can define routes for our application using the `route("path")` attribute. - -## Route Segments - -Each route is made up of segments. Most segments are separated by `/` characters in the path. - -There are four fundamental types of segments: - -1. [Static segments](#static-segments) are fixed strings that must be present in the path. -2. [Dynamic segments](#dynamic-segments) are types that can be parsed from a segment. -3. [Catch-all segments](#catch-all-segments) are types that can be parsed from multiple segments. -4. [Query segments](#query-segments) are types that can be parsed from the query string. - -Routes are matched: - -- First, from most specific to least specific (Static then Dynamic then Catch All) (Query is always matched) -- Then, if multiple routes match the same path, the order in which they are defined in the enum is followed. - -## Static segments - -Fixed routes match a specific path. For example, the route `#[route("/about")]` will match the path `/about`. - -```rust, no_run -{{#include ../../../examples/static_segments.rs:route}} -``` - -## Dynamic Segments - -Dynamic segments are in the form of `:name` where `name` is -the name of the field in the route variant. If the segment is parsed -successfully then the route matches, otherwise the matching continues. - -The segment can be of any type that implements `FromStr`. - -```rust, no_run -{{#include ../../../examples/dynamic_segments.rs:route}} -``` - -## Catch All Segments - -Catch All segments are in the form of `:...name` where `name` is the name of the field in the route variant. If the segments are parsed successfully then the route matches, otherwise the matching continues. - -The segment can be of any type that implements `FromSegments`. (Vec implements this by default) - -Catch All segments must be the _last route segment_ in the path (query segments are not counted) and cannot be included in nests. - -```rust, no_run -{{#include ../../../examples/catch_all_segments.rs:route}} -``` - -## Query Segments - -Query segments are in the form of `?:name` where `name` is the name of the field in the route variant. - -Unlike [Dynamic Segments](#dynamic-segments) and [Catch All Segments](#catch-all-segments), parsing a Query segment must not fail. - -The segment can be of any type that implements `FromQuery`. - -Query segments must be the _after all route segments_ and cannot be included in nests. - -```rust, no_run -{{#include ../../../examples/query_segments.rs:route}} -``` diff --git a/docs/router/src/reference/routes/nested.md b/docs/router/src/reference/routes/nested.md deleted file mode 100644 index 4860fbb0d..000000000 --- a/docs/router/src/reference/routes/nested.md +++ /dev/null @@ -1,39 +0,0 @@ -# Nested Routes - -When developing bigger applications we often want to nest routes within each -other. As an example, we might want to organize a settings menu using this -pattern: - -```plain -β”” Settings - β”œ General Settings (displayed when opening the settings) - β”œ Change Password - β”” Privacy Settings -``` - -We might want to map this structure to these paths and components: - -```plain -/settings -> Settings { GeneralSettings } -/settings/password -> Settings { PWSettings } -/settings/privacy -> Settings { PrivacySettings } -``` - -Nested routes allow us to do this without repeating /settings in every route. - -## Nesting - -To nest routes, we use the `#[nest("path")]` and `#[end_nest]` attributes. - -The path in nest must not: - -1. Contain a [Catch All Segment](index.md#catch-all-segments) -2. Contain a [Query Segment](index.md#query-segments) - -If you define a dynamic segment in a nest, it will be available to all child routes and layouts. - -To finish a nest, we use the `#[end_nest]` attribute or the end of the enum. - -```rust, no_run -{{#include ../../../examples/nest.rs:route}} -``` diff --git a/docs/router/src/reference/routing-update-callback.md b/docs/router/src/reference/routing-update-callback.md deleted file mode 100644 index f4fdb9a99..000000000 --- a/docs/router/src/reference/routing-update-callback.md +++ /dev/null @@ -1,25 +0,0 @@ -# Routing Update Callback - -In some cases, we might want to run custom code when the current route changes. -For this reason, the [`RouterConfig`] exposes an `on_update` field. - -## How does the callback behave? - -The `on_update` is called whenever the current routing information changes. It -is called after the router updated its internal state, but before dependent components and hooks are updated. - -If the callback returns a [`NavigationTarget`], the router will replace the -current location with the specified target. It will not call the -`on_update` again. - -If at any point the router encounters a -[navigation failure](./failures/index.md), it will go to the appropriate state -without calling the `on_update`. It doesn't matter if the invalid target -initiated the navigation, was found as a redirect target, or was returned by the -`on_update` itself. - -## Code Example - -```rust, no_run -{{#include ../../examples/routing_update.rs:router}} -``` diff --git a/docs/router/src/reference/static-generation.md b/docs/router/src/reference/static-generation.md deleted file mode 100644 index c43f9fe4b..000000000 --- a/docs/router/src/reference/static-generation.md +++ /dev/null @@ -1,15 +0,0 @@ -# Static Generation - -## Getting the Sitemap - -The [`Routable`] trait includes an associated [`SITE_MAP`] constant that contains the map of all of the routes in the enum. - -By default, the sitemap is a tree of (static or dynamic) RouteTypes, but it can be flattened into a list of individual routes with the `.flatten()` method. - -## Generating a Sitemap - -To statically render pages, we need to flatten the route tree and generate a file for each route that contains only static segments: - -```rust, no_run -{{#include ../../../../packages/router/examples/static_generation.rs}} -``` diff --git a/examples/crm.rs b/examples/crm.rs index f3da8ab7a..d2cd98118 100644 --- a/examples/crm.rs +++ b/examples/crm.rs @@ -1,5 +1,4 @@ //! Tiny CRM: A port of the Yew CRM example to Dioxus. -#![allow(non_snake_case)] use dioxus::prelude::*; use dioxus_router::prelude::*; @@ -27,6 +26,7 @@ pub struct Client { type ClientContext = Vec; +#[component] fn App(cx: Scope) -> Element { use_shared_state_provider::(cx, Default::default); @@ -50,7 +50,7 @@ fn App(cx: Scope) -> Element { } } -#[inline_props] +#[component] fn ClientList(cx: Scope) -> Element { let clients = use_shared_state::(cx).unwrap(); @@ -80,7 +80,7 @@ fn ClientList(cx: Scope) -> Element { }) } -#[inline_props] +#[component] fn ClientAdd(cx: Scope) -> Element { let clients = use_shared_state::(cx).unwrap(); let first_name = use_state(cx, String::new); @@ -173,7 +173,7 @@ fn ClientAdd(cx: Scope) -> Element { }) } -#[inline_props] +#[component] fn Settings(cx: Scope) -> Element { let clients = use_shared_state::(cx).unwrap(); diff --git a/examples/dog_app.rs b/examples/dog_app.rs index 243e4bbca..66a3c615c 100644 --- a/examples/dog_app.rs +++ b/examples/dog_app.rs @@ -2,7 +2,7 @@ use dioxus::prelude::*; use std::collections::HashMap; fn main() { - dioxus_desktop::launch(|cx| render!(app_root {})); + dioxus_desktop::launch(|cx| render!(AppRoot {})); } #[derive(Debug, Clone, PartialEq, serde::Deserialize)] @@ -10,7 +10,8 @@ struct ListBreeds { message: HashMap>, } -fn app_root(cx: Scope<'_>) -> Element { +#[component] +fn AppRoot(cx: Scope<'_>) -> Element { let breed = use_state(cx, || "deerhound".to_string()); let breeds = use_future!(cx, || async move { @@ -36,7 +37,7 @@ fn app_root(cx: Scope<'_>) -> Element { } } } - div { flex: "50%", breed_pic { breed: breed.to_string() } } + div { flex: "50%", BreedPic { breed: breed.to_string() } } } } }), @@ -49,8 +50,8 @@ struct DogApi { message: String, } -#[inline_props] -fn breed_pic(cx: Scope, breed: String) -> Element { +#[component] +fn BreedPic(cx: Scope, breed: String) -> Element { let fut = use_future!(cx, |breed| async move { reqwest::get(format!("https://dog.ceo/api/breed/{breed}/images/random")) .await diff --git a/examples/error_handle.rs b/examples/error_handle.rs index b4a6dbb05..d1fb57933 100644 --- a/examples/error_handle.rs +++ b/examples/error_handle.rs @@ -1,10 +1,11 @@ use dioxus::prelude::*; fn main() { - dioxus_desktop::launch(app); + dioxus_desktop::launch(App); } -fn app(cx: Scope) -> Element { +#[component] +fn App(cx: Scope) -> Element { let val = use_state(cx, || "0.0001"); let num = match val.parse::() { @@ -19,13 +20,13 @@ fn app(cx: Scope) -> Element { "Set an invalid number" } (0..5).map(|i| rsx! { - demo_c { x: i } + DemoC { x: i } }) }) } -#[inline_props] -fn demo_c(cx: Scope, x: i32) -> Element { +#[component] +fn DemoC(cx: Scope, x: i32) -> Element { cx.render(rsx! { h1 { "asdasdasdasd {x}" diff --git a/examples/flat_router.rs b/examples/flat_router.rs index b8e3d6425..ec6e2f417 100644 --- a/examples/flat_router.rs +++ b/examples/flat_router.rs @@ -1,5 +1,3 @@ -#![allow(non_snake_case)] - use dioxus::prelude::*; use dioxus_desktop::{tao::dpi::LogicalSize, Config, WindowBuilder}; use dioxus_router::prelude::*; @@ -13,10 +11,11 @@ fn main() { .with_resizable(false), ); - dioxus_desktop::launch_cfg(app, cfg) + dioxus_desktop::launch_cfg(App, cfg) } -fn app(cx: Scope) -> Element { +#[component] +fn App(cx: Scope) -> Element { render! { Router:: {} } @@ -36,7 +35,7 @@ enum Route { Settings {}, } -#[inline_props] +#[component] fn Footer(cx: Scope) -> Element { render! { div { @@ -58,22 +57,22 @@ fn Footer(cx: Scope) -> Element { } } -#[inline_props] +#[component] fn Home(cx: Scope) -> Element { render!("Home") } -#[inline_props] +#[component] fn Games(cx: Scope) -> Element { render!("Games") } -#[inline_props] +#[component] fn Play(cx: Scope) -> Element { render!("Play") } -#[inline_props] +#[component] fn Settings(cx: Scope) -> Element { render!("Settings") } diff --git a/examples/inlineprops.rs b/examples/inlineprops.rs index 8c626d346..6d5534064 100644 --- a/examples/inlineprops.rs +++ b/examples/inlineprops.rs @@ -1,33 +1,35 @@ -//! Run with `cargo-expand` to see what each one expands to -#![allow(non_snake_case)] - +//! Run with `cargo-expand` to see what each one expands to. +//! This file is named `inlineprops.rs`, because there used to be a `#[inline_props]` macro to +//! do this. However, it's now deprecated (and will likely be removed in a future major version), +//! so please use `#[component]` instead! use dioxus::prelude::*; -#[inline_props] +#[component] fn Thing1(cx: Scope, _a: T) -> Element { cx.render(rsx! { "" }) } -#[inline_props] +#[component] fn Thing2(cx: Scope, _a: u32) -> Element<'a> { cx.render(rsx! { "" }) } -#[inline_props] +#[component] fn Thing3<'a, T>(cx: Scope<'a>, _a: &'a T) -> Element<'a> { cx.render(rsx! { "" }) } -#[inline_props] +#[component] fn Thing4<'a>(cx: Scope<'a>, _a: &'a u32) -> Element<'a> { cx.render(rsx! { "" }) } fn main() { - dioxus_desktop::launch(app); + dioxus_desktop::launch(App); } -fn app(cx: Scope) -> Element { +#[component] +fn App(cx: Scope) -> Element { let state = use_state(cx, || 1); cx.render(rsx! { diff --git a/examples/link.rs b/examples/link.rs index c66b1abd1..726fe3d79 100644 --- a/examples/link.rs +++ b/examples/link.rs @@ -1,13 +1,12 @@ -#![allow(non_snake_case)] - use dioxus::prelude::*; use dioxus_router::prelude::*; fn main() { - dioxus_desktop::launch(app); + dioxus_desktop::launch(App); } -fn app(cx: Scope) -> Element { +#[component] +fn App(cx: Scope) -> Element { cx.render(rsx! ( div { p { @@ -38,7 +37,7 @@ enum Route { Settings {}, } -#[inline_props] +#[component] fn Header(cx: Scope) -> Element { render! { h1 { "Your app here" } @@ -50,12 +49,12 @@ fn Header(cx: Scope) -> Element { } } -#[inline_props] +#[component] fn Home(cx: Scope) -> Element { render!(h1 { "Home" }) } -#[inline_props] +#[component] fn Settings(cx: Scope) -> Element { render!(h1 { "Settings" }) } diff --git a/examples/query_segments_demo/src/main.rs b/examples/query_segments_demo/src/main.rs index 2348f1fe5..d9f5f83ef 100644 --- a/examples/query_segments_demo/src/main.rs +++ b/examples/query_segments_demo/src/main.rs @@ -1,4 +1,4 @@ -#![allow(non_snake_case, unused)] +#![allow(unused)] //! Example: Url query segments usage //! ------------------------------------ //! @@ -56,7 +56,7 @@ impl FromQuery for BlogQuerySegments { } } -#[inline_props] +#[component] fn BlogPost(cx: Scope, query_params: BlogQuerySegments) -> Element { render! { div{"This is your blogpost with a query segment:"} @@ -64,6 +64,7 @@ fn BlogPost(cx: Scope, query_params: BlogQuerySegments) -> Element { } } +#[component] fn App(cx: Scope) -> Element { render! { Router::{} } } diff --git a/examples/router.rs b/examples/router.rs index ed7fbefa4..d00c747b9 100644 --- a/examples/router.rs +++ b/examples/router.rs @@ -1,5 +1,3 @@ -#![allow(non_snake_case)] - use dioxus::prelude::*; use dioxus_router::prelude::*; @@ -37,12 +35,14 @@ enum Route { } // ANCHOR_END: router +#[component] fn App(cx: Scope) -> Element { render! { Router:: {} } } +#[component] fn NavBar(cx: Scope) -> Element { render! { nav { @@ -55,12 +55,14 @@ fn NavBar(cx: Scope) -> Element { } } +#[component] fn Home(cx: Scope) -> Element { render! { h1 { "Welcome to the Dioxus Blog!" } } } +#[component] fn Blog(cx: Scope) -> Element { render! { h1 { "Blog" } @@ -68,6 +70,7 @@ fn Blog(cx: Scope) -> Element { } } +#[component] fn BlogList(cx: Scope) -> Element { render! { h2 { "Choose a post" } @@ -88,14 +91,14 @@ fn BlogList(cx: Scope) -> Element { } } -#[inline_props] +#[component] fn BlogPost(cx: Scope, name: String) -> Element { render! { h2 { "Blog Post: {name}"} } } -#[inline_props] +#[component] fn PageNotFound(cx: Scope, route: Vec) -> Element { render! { h1 { "Page not found" } diff --git a/examples/rsx_usage.rs b/examples/rsx_usage.rs index d5e2fcdb3..f9ecb4939 100644 --- a/examples/rsx_usage.rs +++ b/examples/rsx_usage.rs @@ -1,4 +1,3 @@ -#![allow(non_snake_case)] //! A tour of the rsx! macro //! ------------------------ //! @@ -40,7 +39,7 @@ //! - Allow top-level fragments fn main() { - dioxus_desktop::launch(app); + dioxus_desktop::launch(App); } use core::{fmt, str::FromStr}; @@ -49,7 +48,8 @@ use std::fmt::Display; use baller::Baller; use dioxus::prelude::*; -fn app(cx: Scope) -> Element { +#[component] +fn App(cx: Scope) -> Element { let formatting = "formatting!"; let formatting_tuple = ("a", "b"); let lazy_fmt = format_args!("lazily formatted text"); @@ -217,12 +217,16 @@ fn format_dollars(dollars: u32, cents: u32) -> String { format!("${dollars}.{cents:02}") } -fn helper<'a>(cx: &'a ScopeState, text: &str) -> Element<'a> { +fn helper<'a>(cx: &'a ScopeState, text: &'a str) -> Element<'a> { cx.render(rsx! { p { "{text}" } }) } +// no_case_check disables PascalCase checking if you *really* want a snake_case component. +// This will likely be deprecated/removed in a future update that will introduce a more polished linting system, +// something like Clippy. +#[component(no_case_check)] fn lowercase_helper(cx: Scope) -> Element { cx.render(rsx! { "asd" @@ -234,12 +238,16 @@ mod baller { #[derive(Props, PartialEq, Eq)] pub struct BallerProps {} - #[allow(non_snake_case)] + #[component] /// This component totally balls - pub fn Baller(_: Scope) -> Element { + pub fn Baller(_cx: Scope) -> Element { todo!() } + // no_case_check disables PascalCase checking if you *really* want a snake_case component. + // This will likely be deprecated/removed in a future update that will introduce a more polished linting system, + // something like Clippy. + #[component(no_case_check)] pub fn lowercase_component(cx: Scope) -> Element { cx.render(rsx! { "look ma, no uppercase" }) } @@ -253,7 +261,7 @@ pub struct TallerProps<'a> { } /// Documention for this component is visible within the rsx macro -#[allow(non_snake_case)] +#[component] pub fn Taller<'a>(cx: Scope<'a, TallerProps<'a>>) -> Element { cx.render(rsx! { &cx.props.children @@ -275,15 +283,14 @@ where todo!() } -#[inline_props] +#[component] fn WithInline<'a>(cx: Scope<'a>, text: &'a str) -> Element { cx.render(rsx! { p { "{text}" } }) } -// generic component with inline_props too -#[inline_props] +#[component] fn Label(cx: Scope, text: T) -> Element where T: Display, diff --git a/examples/shared_state.rs b/examples/shared_state.rs index d129f75d1..37271f160 100644 --- a/examples/shared_state.rs +++ b/examples/shared_state.rs @@ -1,5 +1,3 @@ -#![allow(non_snake_case)] - use std::collections::HashMap; use dioxus::prelude::*; @@ -27,6 +25,7 @@ impl CoolData { } } +#[component] #[rustfmt::skip] pub fn App(cx: Scope) -> Element { use_shared_state_provider(cx, || CoolData::new(HashMap::from([ @@ -50,7 +49,7 @@ pub fn App(cx: Scope) -> Element { ) } -#[inline_props] +#[component] fn DataEditor(cx: Scope, id: usize) -> Element { let cool_data = use_shared_state::(cx).unwrap().read(); @@ -61,7 +60,7 @@ fn DataEditor(cx: Scope, id: usize) -> Element { }) } -#[inline_props] +#[component] fn DataView(cx: Scope, id: usize) -> Element { let cool_data = use_shared_state::(cx).unwrap(); diff --git a/examples/simple_desktop.rs b/examples/simple_desktop.rs index 374b58a4e..4eac5e3a9 100644 --- a/examples/simple_desktop.rs +++ b/examples/simple_desktop.rs @@ -9,10 +9,11 @@ fn main() { .with_module_level("dioxus", log::LevelFilter::Trace) .init() .unwrap(); - dioxus_desktop::launch(app); + dioxus_desktop::launch(App); } -fn app(cx: Scope) -> Element { +#[component] +fn App(cx: Scope) -> Element { render! { Router:: {} } @@ -36,7 +37,7 @@ enum Route { Oranges {}, } -#[inline_props] +#[component] fn NavBar(cx: Scope) -> Element { render! { h1 { "Your app here" } @@ -51,19 +52,19 @@ fn NavBar(cx: Scope) -> Element { } } -#[inline_props] +#[component] fn Home(cx: Scope) -> Element { log::debug!("rendering home {:?}", cx.scope_id()); render! { h1 { "Home" } } } -#[inline_props] +#[component] fn BlogList(cx: Scope) -> Element { log::debug!("rendering blog list {:?}", cx.scope_id()); render! { div { "Blog List" } } } -#[inline_props] +#[component] fn BlogPost(cx: Scope, post: String) -> Element { log::debug!("rendering blog post {}", post); @@ -75,7 +76,7 @@ fn BlogPost(cx: Scope, post: String) -> Element { } } -#[inline_props] +#[component] fn Oranges(cx: Scope) -> Element { render!("Oranges are not apples!") } diff --git a/examples/simple_router.rs b/examples/simple_router.rs index 0604558a1..7ed55885e 100644 --- a/examples/simple_router.rs +++ b/examples/simple_router.rs @@ -12,12 +12,12 @@ enum Route { Blog { id: String }, } -#[inline_props] +#[component] fn Homepage(cx: Scope) -> Element { render! { h1 { "Welcome home" } } } -#[inline_props] +#[component] fn Blog(cx: Scope, id: String) -> Element { render! { h1 { "How to make: " } @@ -25,7 +25,7 @@ fn Blog(cx: Scope, id: String) -> Element { } } -#[inline_props] +#[component] fn Nav(cx: Scope) -> Element { render! { nav { diff --git a/packages/autofmt/README.md b/packages/autofmt/README.md index bd934f2c7..0b13dc7a9 100644 --- a/packages/autofmt/README.md +++ b/packages/autofmt/README.md @@ -1,6 +1,5 @@ # dioxus-autofmt - [![Crates.io][crates-badge]][crates-url] [![MIT licensed][mit-badge]][mit-url] [![Build Status][actions-badge]][actions-url] @@ -8,38 +7,33 @@ [crates-badge]: https://img.shields.io/crates/v/dioxus-autofmt.svg [crates-url]: https://crates.io/crates/dioxus-autofmt - [mit-badge]: https://img.shields.io/badge/license-MIT-blue.svg [mit-url]: https://github.com/dioxuslabs/dioxus/blob/master/LICENSE - [actions-badge]: https://github.com/dioxuslabs/dioxus/actions/workflows/main.yml/badge.svg [actions-url]: https://github.com/dioxuslabs/dioxus/actions?query=workflow%3ACI+branch%3Amaster - [discord-badge]: https://img.shields.io/discord/899851952891002890.svg?logo=discord&style=flat-square [discord-url]: https://discord.gg/XgGxMSkvUM [Website](https://dioxuslabs.com) | -[Guides](https://dioxuslabs.com/docs/0.3/guide/en/) | +[Guides](https://dioxuslabs.com/learn/0.4/) | [API Docs](https://docs.rs/dioxus-autofmt/latest/dioxus_autofmt) | [Chat](https://discord.gg/XgGxMSkvUM) - ## Overview `dioxus-autofmt` provides a pretty printer for the `rsx` syntax tree. - This is done manually with a via set of formatting rules. The output is not guaranteed to be stable between minor versions of the crate as we might tweak the output. `dioxus-autofmt` provides an API to perform precision edits as well as just spit out a block of formatted RSX from any RSX syntax tree. This is used by the `rsx-rosetta` crate which can accept various input languages and output valid RSX. - ## Contributing - Report issues on our [issue tracker](https://github.com/dioxuslabs/dioxus/issues). - Join the discord and ask questions! ## License + This project is licensed under the [MIT license]. [mit license]: https://github.com/DioxusLabs/dioxus/blob/master/LICENSE-MIT diff --git a/packages/autofmt/tests/samples/long.rsx b/packages/autofmt/tests/samples/long.rsx index c5ace9cc3..1bda8a006 100644 --- a/packages/autofmt/tests/samples/long.rsx +++ b/packages/autofmt/tests/samples/long.rsx @@ -1,6 +1,6 @@ use dioxus::prelude::*; -#[inline_props] +#[component] pub fn Explainer<'a>( cx: Scope<'a>, invert: bool, diff --git a/packages/check/README.md b/packages/check/README.md index 512eb579a..0bb6ce0a4 100644 --- a/packages/check/README.md +++ b/packages/check/README.md @@ -1,6 +1,5 @@ # dioxus-check - [![Crates.io][crates-badge]][crates-url] [![MIT licensed][mit-badge]][mit-url] [![Build Status][actions-badge]][actions-url] @@ -8,25 +7,21 @@ [crates-badge]: https://img.shields.io/crates/v/dioxus-autofmt.svg [crates-url]: https://crates.io/crates/dioxus-autofmt - [mit-badge]: https://img.shields.io/badge/license-MIT-blue.svg [mit-url]: https://github.com/dioxuslabs/dioxus/blob/master/LICENSE - [actions-badge]: https://github.com/dioxuslabs/dioxus/actions/workflows/main.yml/badge.svg [actions-url]: https://github.com/dioxuslabs/dioxus/actions?query=workflow%3ACI+branch%3Amaster - [discord-badge]: https://img.shields.io/discord/899851952891002890.svg?logo=discord&style=flat-square [discord-url]: https://discord.gg/XgGxMSkvUM [Website](https://dioxuslabs.com) | -[Guides](https://dioxuslabs.com/docs/0.3/guide/en/) | +[Guides](https://dioxuslabs.com/learn/0.4/) | [API Docs](https://docs.rs/dioxus-autofmt/latest/dioxus_autofmt) | [Chat](https://discord.gg/XgGxMSkvUM) - ## Overview -`dioxus-check` analyzes Dioxus source code and reports errors and warnings. Primarily, it enforces the [Rules of Hooks](https://dioxuslabs.com/docs/0.3/guide/en/interactivity/hooks.html#no-hooks-in-conditionals). +`dioxus-check` analyzes Dioxus source code and reports errors and warnings. Primarily, it enforces the [Rules of Hooks](https://dioxuslabs.com/learn/0.4/reference/hooks#rules-of-hooks). ## Contributing @@ -34,6 +29,7 @@ - Join the discord and ask questions! ## License + This project is licensed under the [MIT license]. [mit license]: https://github.com/DioxusLabs/dioxus/blob/master/LICENSE-MIT diff --git a/packages/check/src/issues.rs b/packages/check/src/issues.rs index 9893cde25..34d20eaef 100644 --- a/packages/check/src/issues.rs +++ b/packages/check/src/issues.rs @@ -158,11 +158,11 @@ impl Display for IssueReport { #[allow(clippy::enum_variant_names)] // we'll add non-hook ones in the future /// Issues that might be found via static analysis of a Dioxus file. pub enum Issue { - /// https://dioxuslabs.com/docs/0.3/guide/en/interactivity/hooks.html#no-hooks-in-conditionals + /// https://dioxuslabs.com/learn/0.4/reference/hooks#no-hooks-in-conditionals HookInsideConditional(HookInfo, ConditionalInfo), - /// https://dioxuslabs.com/docs/0.3/guide/en/interactivity/hooks.html#no-hooks-in-loops + /// https://dioxuslabs.com/learn/0.4/reference/hooks#no-hooks-in-loops HookInsideLoop(HookInfo, AnyLoopInfo), - /// https://dioxuslabs.com/docs/0.3/guide/en/interactivity/hooks.html#no-hooks-in-closures + /// https://dioxuslabs.com/learn/0.4/reference/hooks#no-hooks-in-closures HookInsideClosure(HookInfo, ClosureInfo), HookOutsideComponent(HookInfo), } diff --git a/packages/cli/src/server/desktop/mod.rs b/packages/cli/src/server/desktop/mod.rs index 7c38fd674..e6ad8c7ff 100644 --- a/packages/cli/src/server/desktop/mod.rs +++ b/packages/cli/src/server/desktop/mod.rs @@ -1,12 +1,12 @@ +use crate::server::Platform; use crate::{ cfg::ConfigOptsServe, server::{ output::{print_console_info, PrettierOptions}, - setup_file_watcher, setup_file_watcher_hot_reload, + setup_file_watcher, }, BuildResult, CrateConfig, Result, }; - use dioxus_hot_reload::HotReloadMsg; use dioxus_html::HtmlCtx; use dioxus_rsx::hot_reload::*; @@ -20,7 +20,7 @@ use tokio::sync::broadcast::{self}; #[cfg(feature = "plugin")] use plugin::PluginManager; -use super::Platform; +use super::HotReloadState; pub async fn startup(config: CrateConfig, serve: &ConfigOptsServe) -> Result<()> { startup_with_platform::(config, serve).await @@ -28,7 +28,7 @@ pub async fn startup(config: CrateConfig, serve: &ConfigOptsServe) -> Result<()> pub(crate) async fn startup_with_platform( config: CrateConfig, - serve: &ConfigOptsServe, + serve_cfg: &ConfigOptsServe, ) -> Result<()> { // ctrl-c shutdown checker let _crate_config = config.clone(); @@ -38,18 +38,39 @@ pub(crate) async fn startup_with_platform( std::process::exit(0); }); - match config.hot_reload { - true => serve_hot_reload::

(config, serve).await?, - false => serve_default::

(config, serve).await?, - } + let hot_reload_state = match config.hot_reload { + true => { + let FileMapBuildResult { map, errors } = + FileMap::::create(config.crate_dir.clone()).unwrap(); + + for err in errors { + log::error!("{}", err); + } + + let file_map = Arc::new(Mutex::new(map)); + + let hot_reload_tx = broadcast::channel(100).0; + + clear_paths(); + + Some(HotReloadState { + messages: hot_reload_tx.clone(), + file_map: file_map.clone(), + }) + } + false => None, + }; + + serve::

(config, serve_cfg, hot_reload_state).await?; Ok(()) } /// Start the server without hot reload -async fn serve_default( +async fn serve( config: CrateConfig, serve: &ConfigOptsServe, + hot_reload_state: Option, ) -> Result<()> { let platform = RwLock::new(P::start(&config, serve)?); @@ -65,68 +86,34 @@ async fn serve_default( }, &config, None, + hot_reload_state.clone(), ) .await?; - std::future::pending::<()>().await; + match &hot_reload_state { + Some(hot_reload_state) => { + // The open interprocess sockets + start_desktop_hot_reload(hot_reload_state).await?; + } + None => { + std::future::pending::<()>().await; + } + } Ok(()) } -/// Start dx serve with hot reload -async fn serve_hot_reload( - config: CrateConfig, - serve: &ConfigOptsServe, -) -> Result<()> { - let platform = RwLock::new(P::start(&config, serve)?); - - // Setup hot reload - let FileMapBuildResult { map, errors } = - FileMap::::create(config.crate_dir.clone()).unwrap(); - - for err in errors { - log::error!("{}", err); - } - - let file_map = Arc::new(Mutex::new(map)); - - let (hot_reload_tx, mut hot_reload_rx) = broadcast::channel(100); - - // States - // The open interprocess sockets - let channels = Arc::new(Mutex::new(Vec::new())); - - // Setup file watcher - // We got to own watcher so that it exists for the duration of serve - // Otherwise hot reload won't work. - let _watcher = setup_file_watcher_hot_reload( - &config, - hot_reload_tx, - file_map.clone(), - { - let config = config.clone(); - - let channels = channels.clone(); - move || { - for channel in &mut *channels.lock().unwrap() { - send_msg(HotReloadMsg::Shutdown, channel); - } - platform.write().unwrap().rebuild(&config) - } - }, - None, - ) - .await?; - - clear_paths(); - +async fn start_desktop_hot_reload(hot_reload_state: &HotReloadState) -> Result<()> { match LocalSocketListener::bind("@dioxusin") { Ok(local_socket_stream) => { let aborted = Arc::new(Mutex::new(false)); + // States + // The open interprocess sockets + let channels = Arc::new(Mutex::new(Vec::new())); // listen for connections std::thread::spawn({ - let file_map = file_map.clone(); + let file_map = hot_reload_state.file_map.clone(); let channels = channels.clone(); let aborted = aborted.clone(); let _ = local_socket_stream.set_nonblocking(true); @@ -161,6 +148,8 @@ async fn serve_hot_reload( } }); + let mut hot_reload_rx = hot_reload_state.messages.subscribe(); + while let Ok(template) = hot_reload_rx.recv().await { let channels = &mut *channels.lock().unwrap(); let mut i = 0; diff --git a/packages/cli/src/server/mod.rs b/packages/cli/src/server/mod.rs index 1571a198e..8badab929 100644 --- a/packages/cli/src/server/mod.rs +++ b/packages/cli/src/server/mod.rs @@ -9,7 +9,7 @@ use std::{ path::PathBuf, sync::{Arc, Mutex}, }; -use tokio::sync::broadcast::Sender; +use tokio::sync::broadcast::{self}; mod output; use output::*; @@ -22,6 +22,7 @@ async fn setup_file_watcher Result + Send + 'static>( build_with: F, config: &CrateConfig, web_info: Option, + hot_reload: Option, ) -> Result { let mut last_update_time = chrono::Local::now().timestamp(); @@ -39,28 +40,81 @@ async fn setup_file_watcher Result + Send + 'static>( let config = watcher_config.clone(); if let Ok(e) = info { if chrono::Local::now().timestamp() > last_update_time { - match build_with() { - Ok(res) => { - last_update_time = chrono::Local::now().timestamp(); + let mut needs_full_rebuild; + if let Some(hot_reload) = &hot_reload { + // find changes to the rsx in the file + let mut rsx_file_map = hot_reload.file_map.lock().unwrap(); + let mut messages: Vec> = Vec::new(); - #[allow(clippy::redundant_clone)] - print_console_info( - &config, - PrettierOptions { - changed: e.paths.clone(), - warnings: res.warnings, - elapsed_time: res.elapsed_time, - }, - web_info.clone(), - ); + // In hot reload mode, we only need to rebuild if non-rsx code is changed + needs_full_rebuild = false; - #[cfg(feature = "plugin")] - let _ = PluginManager::on_serve_rebuild( - chrono::Local::now().timestamp(), - e.paths, - ); + for path in &e.paths { + // if this is not a rust file, rebuild the whole project + if path.extension().and_then(|p| p.to_str()) != Some("rs") { + needs_full_rebuild = true; + break; + } + + match rsx_file_map.update_rsx(path, &config.crate_dir) { + Ok(UpdateResult::UpdatedRsx(msgs)) => { + messages.extend(msgs); + needs_full_rebuild = false; + } + Ok(UpdateResult::NeedsRebuild) => { + needs_full_rebuild = true; + } + Err(err) => { + log::error!("{}", err); + } + } + } + + if needs_full_rebuild { + // Reset the file map to the new state of the project + let FileMapBuildResult { + map: new_file_map, + errors, + } = FileMap::::create(config.crate_dir.clone()).unwrap(); + + for err in errors { + log::error!("{}", err); + } + + *rsx_file_map = new_file_map; + } else { + for msg in messages { + let _ = hot_reload.messages.send(msg); + } + } + } else { + needs_full_rebuild = true; + } + + if needs_full_rebuild { + match build_with() { + Ok(res) => { + last_update_time = chrono::Local::now().timestamp(); + + #[allow(clippy::redundant_clone)] + print_console_info( + &config, + PrettierOptions { + changed: e.paths.clone(), + warnings: res.warnings, + elapsed_time: res.elapsed_time, + }, + web_info.clone(), + ); + + #[cfg(feature = "plugin")] + let _ = PluginManager::on_serve_rebuild( + chrono::Local::now().timestamp(), + e.paths, + ); + } + Err(e) => log::error!("{}", e), } - Err(e) => log::error!("{}", e), } } } @@ -78,113 +132,15 @@ async fn setup_file_watcher Result + Send + 'static>( Ok(watcher) } -// Todo: reduce duplication and merge with setup_file_watcher() -/// Sets up a file watcher with hot reload -async fn setup_file_watcher_hot_reload Result + Send + 'static>( - config: &CrateConfig, - hot_reload_tx: Sender>, - file_map: Arc>>, - build_with: F, - web_info: Option, -) -> Result { - // file watcher: check file change - let allow_watch_path = config - .dioxus_config - .web - .watcher - .watch_path - .clone() - .unwrap_or_else(|| vec![PathBuf::from("src")]); - - let watcher_config = config.clone(); - let mut last_update_time = chrono::Local::now().timestamp(); - - let mut watcher = RecommendedWatcher::new( - move |evt: notify::Result| { - let config = watcher_config.clone(); - // Give time for the change to take effect before reading the file - std::thread::sleep(std::time::Duration::from_millis(100)); - if chrono::Local::now().timestamp() > last_update_time { - if let Ok(evt) = evt { - let mut messages: Vec> = Vec::new(); - for path in evt.paths.clone() { - // if this is not a rust file, rebuild the whole project - if path.extension().and_then(|p| p.to_str()) != Some("rs") { - match build_with() { - Ok(res) => { - print_console_info( - &config, - PrettierOptions { - changed: evt.paths, - warnings: res.warnings, - elapsed_time: res.elapsed_time, - }, - web_info.clone(), - ); - } - Err(err) => { - log::error!("{}", err); - } - } - return; - } - // find changes to the rsx in the file - let mut map = file_map.lock().unwrap(); - - match map.update_rsx(&path, &config.crate_dir) { - Ok(UpdateResult::UpdatedRsx(msgs)) => { - messages.extend(msgs); - } - Ok(UpdateResult::NeedsRebuild) => { - match build_with() { - Ok(res) => { - print_console_info( - &config, - PrettierOptions { - changed: evt.paths, - warnings: res.warnings, - elapsed_time: res.elapsed_time, - }, - web_info.clone(), - ); - } - Err(err) => { - log::error!("{}", err); - } - } - return; - } - Err(err) => { - log::error!("{}", err); - } - } - } - for msg in messages { - let _ = hot_reload_tx.send(msg); - } - } - last_update_time = chrono::Local::now().timestamp(); - } - }, - notify::Config::default(), - ) - .unwrap(); - - for sub_path in allow_watch_path { - if let Err(err) = watcher.watch( - &config.crate_dir.join(&sub_path), - notify::RecursiveMode::Recursive, - ) { - log::error!("error watching {sub_path:?}: \n{}", err); - } - } - - Ok(watcher) -} - pub(crate) trait Platform { fn start(config: &CrateConfig, serve: &ConfigOptsServe) -> Result where Self: Sized; fn rebuild(&mut self, config: &CrateConfig) -> Result; } + +#[derive(Clone)] +pub struct HotReloadState { + pub messages: broadcast::Sender>, + pub file_map: Arc>>, +} diff --git a/packages/cli/src/server/web/hot_reload.rs b/packages/cli/src/server/web/hot_reload.rs index 49cce38d4..7b47dca4c 100644 --- a/packages/cli/src/server/web/hot_reload.rs +++ b/packages/cli/src/server/web/hot_reload.rs @@ -1,27 +1,15 @@ -use std::sync::{Arc, Mutex}; - use axum::{ extract::{ws::Message, WebSocketUpgrade}, response::IntoResponse, Extension, TypedHeader, }; -use dioxus_core::Template; -use dioxus_html::HtmlCtx; -use dioxus_rsx::hot_reload::FileMap; -use tokio::sync::broadcast; -use crate::CrateConfig; - -pub struct HotReloadState { - pub messages: broadcast::Sender>, - pub file_map: Arc>>, - pub watcher_config: CrateConfig, -} +use crate::server::HotReloadState; pub async fn hot_reload_handler( ws: WebSocketUpgrade, _: Option>, - Extension(state): Extension>, + Extension(state): Extension, ) -> impl IntoResponse { ws.on_upgrade(|mut socket| async move { log::info!("πŸ”₯ Hot Reload WebSocket connected"); diff --git a/packages/cli/src/server/web/mod.rs b/packages/cli/src/server/web/mod.rs index 297e252fa..1ed57fb96 100644 --- a/packages/cli/src/server/web/mod.rs +++ b/packages/cli/src/server/web/mod.rs @@ -3,7 +3,7 @@ use crate::{ serve::Serve, server::{ output::{print_console_info, PrettierOptions, WebServerInfo}, - setup_file_watcher, setup_file_watcher_hot_reload, + setup_file_watcher, HotReloadState, }, BuildResult, CrateConfig, Result, WebHttpsConfig, }; @@ -63,21 +63,48 @@ pub async fn startup( let ip = get_ip().unwrap_or(String::from("0.0.0.0")); - match config.hot_reload { - true => serve_hot_reload(ip, port, config, start_browser, skip_assets).await?, - false => serve_default(ip, port, config, start_browser, skip_assets).await?, - } + let hot_reload_state = match config.hot_reload { + true => { + let FileMapBuildResult { map, errors } = + FileMap::::create(config.crate_dir.clone()).unwrap(); + + for err in errors { + log::error!("{}", err); + } + + let file_map = Arc::new(Mutex::new(map)); + + let hot_reload_tx = broadcast::channel(100).0; + + Some(HotReloadState { + messages: hot_reload_tx.clone(), + file_map: file_map.clone(), + }) + } + false => None, + }; + + serve( + ip, + port, + config, + start_browser, + skip_assets, + hot_reload_state, + ) + .await?; Ok(()) } /// Start the server without hot reload -async fn serve_default( +pub async fn serve( ip: String, port: u16, config: CrateConfig, start_browser: bool, skip_assets: bool, + hot_reload_state: Option, ) -> Result<()> { let first_build_result = crate::builder::build(&config, false, skip_assets)?; @@ -99,6 +126,7 @@ async fn serve_default( ip: ip.clone(), port, }), + hot_reload_state.clone(), ) .await?; @@ -125,89 +153,7 @@ async fn serve_default( ); // Router - let router = setup_router(config, ws_reload_state, None).await?; - - // Start server - start_server(port, router, start_browser, rustls_config).await?; - - Ok(()) -} - -/// Start dx serve with hot reload -async fn serve_hot_reload( - ip: String, - port: u16, - config: CrateConfig, - start_browser: bool, - skip_assets: bool, -) -> Result<()> { - let first_build_result = crate::builder::build(&config, false, skip_assets)?; - - log::info!("πŸš€ Starting development server..."); - - // Setup hot reload - let (reload_tx, _) = broadcast::channel(100); - let FileMapBuildResult { map, errors } = - FileMap::::create(config.crate_dir.clone()).unwrap(); - - for err in errors { - log::error!("{}", err); - } - - let file_map = Arc::new(Mutex::new(map)); - - let hot_reload_tx = broadcast::channel(100).0; - - // States - let hot_reload_state = Arc::new(HotReloadState { - messages: hot_reload_tx.clone(), - file_map: file_map.clone(), - watcher_config: config.clone(), - }); - - let ws_reload_state = Arc::new(WsReloadState { - update: reload_tx.clone(), - }); - - // Setup file watcher - // We got to own watcher so that it exists for the duration of serve - // Otherwise hot reload won't work. - let _watcher = setup_file_watcher_hot_reload( - &config, - hot_reload_tx, - file_map, - { - let config = config.clone(); - let reload_tx = reload_tx.clone(); - move || build(&config, &reload_tx, skip_assets) - }, - Some(WebServerInfo { - ip: ip.clone(), - port, - }), - ) - .await?; - - // HTTPS - // Before console info so it can stop if mkcert isn't installed or fails - let rustls_config = get_rustls(&config).await?; - - // Print serve info - print_console_info( - &config, - PrettierOptions { - changed: vec![], - warnings: first_build_result.warnings, - elapsed_time: first_build_result.elapsed_time, - }, - Some(WebServerInfo { - ip: ip.clone(), - port, - }), - ); - - // Router - let router = setup_router(config, ws_reload_state, Some(hot_reload_state)).await?; + let router = setup_router(config, ws_reload_state, hot_reload_state).await?; // Start server start_server(port, router, start_browser, rustls_config).await?; @@ -298,7 +244,7 @@ fn get_rustls_without_mkcert(web_config: &WebHttpsConfig) -> Result<(String, Str async fn setup_router( config: CrateConfig, ws_reload: Arc, - hot_reload: Option>, + hot_reload: Option, ) -> Result { // Setup cors let cors = CorsLayer::new() diff --git a/packages/core-macro/Cargo.toml b/packages/core-macro/Cargo.toml index f3d6f6b3b..d928d5fec 100644 --- a/packages/core-macro/Cargo.toml +++ b/packages/core-macro/Cargo.toml @@ -17,6 +17,8 @@ proc-macro2 = { version = "1.0" } quote = "1.0" syn = { version = "2.0", features = ["full", "extra-traits"] } dioxus-rsx = { workspace = true } +dioxus-core = { workspace = true } +constcat = "0.3.0" # testing [dev-dependencies] diff --git a/packages/core-macro/README.md b/packages/core-macro/README.md index bcf1572cf..31b0cca90 100644 --- a/packages/core-macro/README.md +++ b/packages/core-macro/README.md @@ -1,6 +1,5 @@ # dioxus-core-macro - [![Crates.io][crates-badge]][crates-url] [![MIT licensed][mit-badge]][mit-url] [![Build Status][actions-badge]][actions-url] @@ -8,22 +7,18 @@ [crates-badge]: https://img.shields.io/crates/v/dioxus-core-macro.svg [crates-url]: https://crates.io/crates/dioxus-core-macro - [mit-badge]: https://img.shields.io/badge/license-MIT-blue.svg [mit-url]: https://github.com/dioxuslabs/dioxus/blob/master/LICENSE - [actions-badge]: https://github.com/dioxuslabs/dioxus/actions/workflows/main.yml/badge.svg [actions-url]: https://github.com/dioxuslabs/dioxus/actions?query=workflow%3ACI+branch%3Amaster - [discord-badge]: https://img.shields.io/discord/899851952891002890.svg?logo=discord&style=flat-square [discord-url]: https://discord.gg/XgGxMSkvUM [Website](https://dioxuslabs.com) | -[Guides](https://dioxuslabs.com/docs/0.3/guide/en/) | +[Guides](https://dioxuslabs.com/learn/0.4/) | [API Docs](https://docs.rs/dioxus-core-macro/latest/dioxus_core_macro) | [Chat](https://discord.gg/XgGxMSkvUM) - ## Overview `dioxus-core-macro` provides a handful of helpful macros used by the `dioxus` crate. These include: @@ -32,13 +27,13 @@ - The `inline_props` macro transforms function arguments into an auto-derived struct - The `format_args_f` macro which allows f-string formatting with support for expressions - ## Contributing - Report issues on our [issue tracker](https://github.com/dioxuslabs/dioxus/issues). - Join the discord and ask questions! ## License + This project is licensed under the [MIT license]. [mit license]: https://github.com/DioxusLabs/dioxus/blob/master/LICENSE-MIT diff --git a/packages/core-macro/src/component_body/mod.rs b/packages/core-macro/src/component_body/mod.rs new file mode 100644 index 000000000..91e66c42c --- /dev/null +++ b/packages/core-macro/src/component_body/mod.rs @@ -0,0 +1,237 @@ +//! This module is used for parsing a component function into a struct that is subsequently +//! deserialized into something useful using deserializer arguments. +//! +//! Let's break that down with a term glossary and examples which show usage and implementing. +//! +//! # Glossary +//! * `component body` - The [`ComponentBody`] struct. It's used to parse a component function [`proc_macro::TokenStream`] +//! to a reusable struct that deserializers use to modify the token stream. +//! * `deserializer` - A struct that deserializes the [`ComponentBody`] into a [`DeserializerOutput`]. +//! It implements the [`DeserializerArgs`] trait, but as you can see, it's called "DeserializerArgs", +//! not "Deserializer". Why? +//! Because "args" makes more sense to the caller of [`ComponentBody::deserialize`], which +//! takes an [`DeserializerArgs`] argument. However, you can think of "DeserializerArgs" as the deserializer. +//! * `deserializer output` - A struct that implements the [`DeserializerOutput`] trait. +//! This struct is what enables deserializers to use each other, since it contains the fields that +//! a deserializer needs to turn a token stream to a different token stream. +//! This means a deserializer can get the output of another deserializer, and use that output, +//! thereby using the functionality of a different deserializer. +//! This struct also implements [`ToTokens`], which means that this is the final stage of the whole process. +//! +//! # Examples +//! *Not all imports might be included.* +//! +//! ## Usage in a procedural macro attribute +//! ```rs,ignore +//! use proc_macro::TokenStream; +//! +//! // Some documentation. You can reuse this in your deserializer structs. +//! /// This attribute changes the name of a component function to whatever the first argument is. +//! #[proc_macro_attribute] +//! pub fn name_changer(args: TokenStream, input: TokenStream) -> TokenStream { +//! // Parse the component body. +//! let component_body = parse_macro_input!(input as ComponentBody); +//! +//! // Parse the first argument, which is going to be the components new name. +//! let new_name: String = match Punctuated::::parse_terminated.parse(args) { +//! Err(e) => return e.to_compile_error().into(), // Convert to a compile error and return +//! Ok(args) => { +//! // If the argument exists, then convert it to a string +//! if let Some(first) = args.first() { +//! first.to_token_stream().to_string() +//! } else { +//! // If the argument doesn't exist, return an error with the appropriate message. +//! // The "span" is the location of some code. +//! // The error occurred in the "args" token stream, so point the error there. +//! return Error::new(args.span(), "No new name provided").to_compile_error().into(); +//! } +//! } +//! }; +//! +//! let new_name = &*new_name; +//! +//! // Deserialize the component body to an output with the given args. +//! let output = component_body.deserialize(NameChangerDeserializerArgs { new_name }); +//! +//! // Error handling like before, except now you're ready to return the final value. +//! match output { +//! Err(e) => e.to_compile_error().into(), +//! Ok(output) => output.to_token_stream().into(), +//! } +//! } +//! ``` +//! ## Using the macro in Dioxus code: +//! ```rs +//! use your_proc_macro_library::name_changer; +//! use dioxus::prelude::*; +//! +//! #[name_changer(CoolName)] +//! pub fn LameName(cx: Scope) -> Element { +//! render! { "I want a cool name!" } +//! } +//! +//! pub fn App(cx: Scope) -> Element { +//! render! { CoolName {} } // Renders: "I want a cool name!" +//! } +//! ``` +//! ## Implementing a component body deserializer +//! ```rs +//! use syn::{Result, ItemFn, Signature, Ident}; +//! use quote::quote; +//! +//! // Create a list of arguments. +//! // If there was no args, just make it empty. The "args" struct is also the deserializer struct. +//! // For the docs, you can basically copy paste this text and replace "name_changer" with your macro path. +//! // Although unfortunately, the link does not work +//! // Just make sure that your macro is well documented. +//! /// The args and deserializing implementation for the [`name_changer`] macro. +//! #[derive(Clone)] +//! pub struct NameChangerDeserializerArgs<'a> { +//! pub new_name: &'a str, +//! } +//! +//! // Create an output struct. +//! // The ItemFn represents a modified component function. +//! // To read what fields should be here, check out the `DeserializerOutput` struct docs. +//! // For the docs, you can basically copy paste this text and replace "name_changer" with your macro path. +//! // Just make sure that your macro is well documented. +//! /// The output fields and [`ToTokens`] implementation for the [`name_changer`] macro. +//! #[derive(Clone)] +//! pub struct NameChangerDeserializerOutput { +//! pub comp_fn: ItemFn, +//! } +//! +//! // Implement `ToTokens`, which is forced by `DeserializerOutput`. +//! // This will usually be very simple like this, even for complex deserializers. +//! // That's because of the way the `DeserializerOutput` is designed. +//! impl ToTokens for NameChangerDeserializerOutput { +//! fn to_tokens(&self, tokens: &mut TokenStream) { +//! let comp_fn = &self.comp_fn; +//! +//! tokens.append_all(quote! { +//! #comp_fn +//! }); +//! } +//! } +//! +//! impl DeserializerOutput for NameChangerDeserializerOutput {} +//! +//! // Implement `DeserializerArgs`. This is the core part of deserializers. +//! impl<'a> DeserializerArgs for NameChangerDeserializerArgs<'a> { +//! fn to_output(&self, component_body: &ComponentBody) -> Result { +//! let old_fn = &component_body.item_fn; +//! let old_sig = &old_fn.sig; +//! +//! // For more complex uses, you will probably use `quote::parse_quote!` in combination with +//! // creating the structs manually. +//! // However, create the structs manually if you can. +//! // It's more reliable, because you only modify a certain struct field +//! // and set the others to be the clone of the original component body. +//! // That ensures that no information will be accidentally removed. +//! let new_sig = Signature { +//! ident: Ident::new(self.new_name, old_sig.ident.span()), +//! ..old_sig.clone() +//! }; +//! let new_fn = ItemFn { +//! sig: new_sig, +//! ..old_fn.clone() +//! }; +//! +//! Ok(NameChangerDeserializerOutput { +//! comp_fn: new_fn +//! }) +//! } +//! ``` + +pub mod utils; + +pub use utils::DeserializerArgs; +pub use utils::DeserializerOutput; +pub use utils::TypeHelper; + +use dioxus_core::{Element, Scope}; +use syn::parse::{Parse, ParseStream}; +use syn::spanned::Spanned; +use syn::*; + +/// General struct for parsing a component body. +/// However, because it's ambiguous, it does not implement [`ToTokens`](quote::to_tokens::ToTokens). +/// +/// Refer to the [module documentation](crate::component_body) for more. +pub struct ComponentBody { + /// The component function definition. You can parse this back into a [`ComponentBody`]. + /// For example, you might modify it, parse it into a [`ComponentBody`], and deserialize that + /// using some deserializer. This is how deserializers use other deserializers. + /// + /// **`item_fn.sig.inputs` includes the context argument!** + /// Keep this in mind when creating deserializers, because you often might want to ignore it. + /// That might be annoying, but it would be bad design for this kind of struct to not be parsable from itself. + pub item_fn: ItemFn, + /// Parsing tries to ensure that this argument will be a [`Scope`]. + /// **However, macros have limitations that prevent this from always working, + /// so don't take this for granted!** + pub cx_arg: FnArg, + /// The pattern (name) and type of the context argument. + pub cx_pat_type: PatType, + /// If the function has any arguments other than the context. + pub has_extra_args: bool, +} + +impl ComponentBody { + /// Deserializes the body into the [`TOutput`] with the specific [`TArgs`]. + /// Even if the args are empty, the [`TArg`] type still determines what [`TOutput`] will be generated. + pub fn deserialize(&self, args: TArgs) -> Result + where + TOutput: DeserializerOutput, + TArgs: DeserializerArgs, + { + args.to_output(self) + } +} + +impl Parse for ComponentBody { + fn parse(input: ParseStream) -> Result { + let item_fn: ItemFn = input.parse()?; + let scope_type_path = Scope::get_path_string(); + + let (cx_arg, cx_pat_type) = if let Some(first_arg) = item_fn.sig.inputs.first() { + let incorrect_first_arg_err = Err(Error::new( + first_arg.span(), + format!("First argument must be a <{}>", scope_type_path), + )); + + match first_arg.to_owned() { + FnArg::Receiver(_) => { + return incorrect_first_arg_err; + } + FnArg::Typed(f) => (first_arg.to_owned(), f), + } + } else { + return Err(Error::new( + item_fn.sig.ident.span(), // Or maybe just item_f.sig.span()? + format!( + "Must have at least one argument that's a <{}>", + scope_type_path + ), + )); + }; + + let element_type_path = Element::get_path_string(); + + if item_fn.sig.output == ReturnType::Default { + return Err(Error::new( + item_fn.sig.output.span(), + format!("Must return a <{}>", element_type_path), + )); + } + + let has_extra_args = item_fn.sig.inputs.len() > 1; + + Ok(Self { + item_fn, + cx_arg, + cx_pat_type, + has_extra_args, + }) + } +} diff --git a/packages/core-macro/src/component_body/utils.rs b/packages/core-macro/src/component_body/utils.rs new file mode 100644 index 000000000..05a2869d7 --- /dev/null +++ b/packages/core-macro/src/component_body/utils.rs @@ -0,0 +1,57 @@ +use crate::component_body::ComponentBody; +use dioxus_core::{Element, Scope}; +use quote::ToTokens; +use syn::{parse_quote, Path}; + +/// The output produced by a deserializer. +/// +/// # For implementors +/// Struct field guidelines: +/// * Must be public, so that other deserializers can utilize them. +/// * Should usually be [`Item`]s that you then simply combine in a [`quote!`] +/// in the [`ComponentBodyDeserializer::output_to_token_stream2`] function. +/// * If an [`Item`] might not be included, wrap it in an [`Option`]. +/// * Must be at the component function "level"/"context". +/// For example, the [`InlinePropsDeserializer`](crate::component_body_deserializers::inline_props::InlinePropsDeserializer) +/// produces two [`Item`]s; the function but with arguments turned into props, and the props struct. +/// It does not return any [`Item`]s inside the struct or function. +pub trait DeserializerOutput: ToTokens {} + +impl DeserializerOutput for T {} + +/// The args passed to a [`ComponentBody`] when deserializing it. +/// +/// It's also the struct that does the deserializing. +/// It's called "DeserializerArgs", not "Deserializer". Why? +/// Because "args" makes more sense to the caller of [`ComponentBody::deserialize`], which +/// takes an [`DeserializerArgs`] argument. However, you can think of "DeserializerArgs" as the deserializer. +pub trait DeserializerArgs: Clone +where + TOutput: ToTokens, +{ + // There's a lot of Results out there... let's make sure that this is a syn::Result. + // Let's also make sure there's not a warning. + /// Creates a [`ToTokens`] struct from the `self` args and a [`ComponentBody`]. + /// The [`ComponentBody::deserialize`] provides a cleaner way of calling this function. + #[allow(unused_qualifications)] + fn to_output(&self, component_body: &ComponentBody) -> syn::Result; +} + +pub trait TypeHelper { + fn get_path() -> Path; + fn get_path_string() -> String { + Self::get_path().to_token_stream().to_string() + } +} + +impl<'a> TypeHelper for Scope<'a> { + fn get_path() -> Path { + parse_quote!(::dioxus::core::Scope) + } +} + +impl<'a> TypeHelper for Element<'a> { + fn get_path() -> Path { + parse_quote!(::dioxus::core::Element) + } +} diff --git a/packages/core-macro/src/component_body_deserializers/component.rs b/packages/core-macro/src/component_body_deserializers/component.rs new file mode 100644 index 000000000..e43b1819f --- /dev/null +++ b/packages/core-macro/src/component_body_deserializers/component.rs @@ -0,0 +1,152 @@ +use crate::component_body::{ComponentBody, DeserializerArgs}; +use crate::component_body_deserializers::inline_props::InlinePropsDeserializerArgs; +use constcat::concat; +use proc_macro2::TokenStream as TokenStream2; +use quote::{quote, ToTokens, TokenStreamExt}; +use syn::*; + +pub(crate) const COMPONENT_ARG_CASE_CHECK_ERROR: &str = concat!( + "This component does not use PascalCase. \ +To ignore this check, pass the \"", + crate::COMPONENT_ARG_CASE_CHECK_OFF, + "\" argument, like so: #[component(", + crate::COMPONENT_ARG_CASE_CHECK_OFF, + ")]" +); + +const INNER_FN_NAME: &str = "__dx_inner_comp"; + +fn get_out_comp_fn(orig_comp_fn: &ItemFn, cx_pat: &Pat) -> ItemFn { + let inner_comp_ident = Ident::new(INNER_FN_NAME, orig_comp_fn.sig.ident.span()); + + let inner_comp_fn = ItemFn { + sig: Signature { + ident: inner_comp_ident.clone(), + ..orig_comp_fn.sig.clone() + }, + ..orig_comp_fn.clone() + }; + + ItemFn { + block: parse_quote! { + { + #[warn(non_snake_case)] + #[inline(always)] + #inner_comp_fn + #inner_comp_ident (#cx_pat) + } + }, + ..orig_comp_fn.clone() + } +} + +/// The args and deserializing implementation for the [`crate::component`] macro. +#[derive(Clone)] +pub struct ComponentDeserializerArgs { + pub case_check: bool, +} + +/// The output fields and [`ToTokens`] implementation for the [`crate::component`] macro. +#[derive(Clone)] +pub struct ComponentDeserializerOutput { + pub comp_fn: ItemFn, + pub props_struct: Option, +} + +impl ToTokens for ComponentDeserializerOutput { + fn to_tokens(&self, tokens: &mut TokenStream2) { + let comp_fn = &self.comp_fn; + let props_struct = &self.props_struct; + + tokens.append_all(quote! { + #props_struct + #[allow(non_snake_case)] + #comp_fn + }); + } +} + +impl DeserializerArgs for ComponentDeserializerArgs { + fn to_output(&self, component_body: &ComponentBody) -> Result { + let Signature { ident, .. } = &component_body.item_fn.sig; + + if self.case_check && !is_pascal_case(&ident.to_string()) { + return Err(Error::new(ident.span(), COMPONENT_ARG_CASE_CHECK_ERROR)); + } + + if component_body.has_extra_args { + Self::deserialize_with_props(component_body) + } else { + Ok(Self::deserialize_no_props(component_body)) + } + } +} + +impl ComponentDeserializerArgs { + fn deserialize_no_props(component_body: &ComponentBody) -> ComponentDeserializerOutput { + let ComponentBody { + item_fn, + cx_pat_type, + .. + } = component_body; + let cx_pat = &cx_pat_type.pat; + + let comp_fn = get_out_comp_fn(item_fn, cx_pat); + + ComponentDeserializerOutput { + comp_fn, + props_struct: None, + } + } + + fn deserialize_with_props( + component_body: &ComponentBody, + ) -> Result { + let ComponentBody { + item_fn, + cx_pat_type, + .. + } = component_body; + let cx_pat = &cx_pat_type.pat; + + let comp_parsed = match parse2::(quote!(#item_fn)) { + Ok(comp_body) => comp_body, + Err(e) => { + return Err(Error::new( + e.span(), + format!( + "This is probably a bug in our code, please report it! Error: {}", + e + ), + )) + } + }; + + let inlined_props_output = comp_parsed.deserialize(InlinePropsDeserializerArgs {})?; + let props_struct = inlined_props_output.props_struct; + let props_fn = inlined_props_output.comp_fn; + + let comp_fn = get_out_comp_fn(&props_fn, cx_pat); + + Ok(ComponentDeserializerOutput { + comp_fn, + props_struct: Some(props_struct), + }) + } +} + +fn is_pascal_case(input: &str) -> bool { + let mut is_next_lowercase = false; + + for c in input.chars() { + let is_upper = c.is_ascii_uppercase(); + + if (c == '_') || (is_upper && is_next_lowercase) { + return false; + } + + is_next_lowercase = is_upper; + } + + true +} diff --git a/packages/core-macro/src/component_body_deserializers/inline_props.rs b/packages/core-macro/src/component_body_deserializers/inline_props.rs new file mode 100644 index 000000000..8e4581c19 --- /dev/null +++ b/packages/core-macro/src/component_body_deserializers/inline_props.rs @@ -0,0 +1,195 @@ +use crate::component_body::{ComponentBody, DeserializerArgs}; +use proc_macro2::TokenStream as TokenStream2; +use quote::{quote, ToTokens, TokenStreamExt}; +use syn::token::Comma; +use syn::{punctuated::Punctuated, *}; + +/// The args and deserializing implementation for the [`crate::inline_props`] macro. +#[derive(Clone)] +pub struct InlinePropsDeserializerArgs; + +/// The output fields and [`ToTokens`] implementation for the [`crate::inline_props`] macro. +#[derive(Clone)] +pub struct InlinePropsDeserializerOutput { + pub comp_fn: ItemFn, + pub props_struct: ItemStruct, +} + +impl ToTokens for InlinePropsDeserializerOutput { + fn to_tokens(&self, tokens: &mut TokenStream2) { + let function = &self.comp_fn; + let props_struct = &self.props_struct; + + tokens.append_all(quote! { + #function + #props_struct + }); + } +} + +impl DeserializerArgs for InlinePropsDeserializerArgs { + fn to_output(&self, component_body: &ComponentBody) -> Result { + Ok(InlinePropsDeserializerOutput { + comp_fn: Self::get_function(component_body), + props_struct: Self::get_props_struct(component_body), + }) + } +} + +impl InlinePropsDeserializerArgs { + fn get_props_struct(component_body: &ComponentBody) -> ItemStruct { + let ComponentBody { item_fn, .. } = component_body; + let ItemFn { vis, sig, .. } = item_fn; + let Signature { + inputs, + ident: fn_ident, + generics, + .. + } = sig; + + // Skip first arg since that's the context + let struct_fields = inputs.iter().skip(1).map(move |f| { + match f { + FnArg::Receiver(_) => unreachable!(), // Unreachable because of ComponentBody parsing + FnArg::Typed(pt) => { + let arg_pat = &pt.pat; // Pattern (identifier) + let arg_colon = &pt.colon_token; + let arg_ty = &pt.ty; // Type + let arg_attrs = &pt.attrs; // Attributes + + quote! { + #(#arg_attrs) + * + #vis #arg_pat #arg_colon #arg_ty + } + } + } + }); + + let struct_ident = Ident::new(&format!("{fn_ident}Props"), fn_ident.span()); + + let first_lifetime = if let Some(GenericParam::Lifetime(lt)) = generics.params.first() { + Some(lt) + } else { + None + }; + + let struct_attrs = if first_lifetime.is_some() { + quote! { #[derive(Props)] } + } else { + quote! { #[derive(Props, PartialEq)] } + }; + + let struct_generics = if first_lifetime.is_some() { + let struct_generics: Punctuated = component_body + .item_fn + .sig + .generics + .params + .iter() + .map(|it| match it { + GenericParam::Type(tp) => { + let mut tp = tp.clone(); + tp.bounds.push(parse_quote!( 'a )); + + GenericParam::Type(tp) + } + _ => it.clone(), + }) + .collect(); + + quote! { <#struct_generics> } + } else { + quote! { #generics } + }; + + parse_quote! { + #struct_attrs + #[allow(non_camel_case_types)] + #vis struct #struct_ident #struct_generics + { + #(#struct_fields),* + } + } + } + + fn get_function(component_body: &ComponentBody) -> ItemFn { + let ComponentBody { + item_fn, + cx_pat_type, + .. + } = component_body; + let ItemFn { + attrs: fn_attrs, + vis, + sig, + block: fn_block, + } = item_fn; + let Signature { + inputs, + ident: fn_ident, + generics, + output: fn_output, + asyncness, + .. + } = sig; + let Generics { where_clause, .. } = generics; + + let cx_pat = &cx_pat_type.pat; + let struct_ident = Ident::new(&format!("{fn_ident}Props"), fn_ident.span()); + + // Skip first arg since that's the context + let struct_field_names = inputs.iter().skip(1).filter_map(|f| match f { + FnArg::Receiver(_) => unreachable!(), // ComponentBody prohibits receiver parameters. + FnArg::Typed(t) => Some(&t.pat), + }); + + let first_lifetime = if let Some(GenericParam::Lifetime(lt)) = generics.params.first() { + Some(lt) + } else { + None + }; + + let (scope_lifetime, fn_generics) = if let Some(lt) = first_lifetime { + (quote! { #lt, }, generics.clone()) + } else { + let lifetime: LifetimeParam = parse_quote! { 'a }; + + let mut fn_generics = generics.clone(); + fn_generics + .params + .insert(0, GenericParam::Lifetime(lifetime.clone())); + + (quote! { #lifetime, }, fn_generics) + }; + + let generics_no_bounds = { + let mut generics = generics.clone(); + generics.params = generics + .params + .iter() + .map(|it| match it { + GenericParam::Type(tp) => { + let mut tp = tp.clone(); + tp.bounds.clear(); + + GenericParam::Type(tp) + } + _ => it.clone(), + }) + .collect(); + + generics + }; + + parse_quote! { + #(#fn_attrs)* + #asyncness #vis fn #fn_ident #fn_generics (#cx_pat: Scope<#scope_lifetime #struct_ident #generics_no_bounds>) #fn_output + #where_clause + { + let #struct_ident { #(#struct_field_names),* } = &#cx_pat.props; + #fn_block + } + } + } +} diff --git a/packages/core-macro/src/component_body_deserializers/mod.rs b/packages/core-macro/src/component_body_deserializers/mod.rs new file mode 100644 index 000000000..a3027796d --- /dev/null +++ b/packages/core-macro/src/component_body_deserializers/mod.rs @@ -0,0 +1,4 @@ +//! This module contains all [`ComponentBody`](crate::component_body::ComponentBody) deserializers. + +pub mod component; +pub mod inline_props; diff --git a/packages/core-macro/src/inlineprops.rs b/packages/core-macro/src/inlineprops.rs deleted file mode 100644 index ccc00f4f9..000000000 --- a/packages/core-macro/src/inlineprops.rs +++ /dev/null @@ -1,185 +0,0 @@ -use proc_macro2::{Span, TokenStream as TokenStream2}; -use quote::{quote, ToTokens, TokenStreamExt}; -use syn::{ - parse::{Parse, ParseStream}, - punctuated::Punctuated, - *, -}; - -pub struct InlinePropsBody { - pub attrs: Vec, - pub vis: syn::Visibility, - pub maybe_async: Option, - pub fn_token: Token![fn], - pub ident: Ident, - pub cx_token: Box, - pub generics: Generics, - pub paren_token: token::Paren, - pub inputs: Punctuated, - // pub fields: FieldsNamed, - pub output: ReturnType, - pub where_clause: Option, - pub block: Box, -} - -/// The custom rusty variant of parsing rsx! -impl Parse for InlinePropsBody { - fn parse(input: ParseStream) -> Result { - let attrs: Vec = input.call(Attribute::parse_outer)?; - let maybe_async: Option = input.parse().ok(); - let vis: Visibility = input.parse()?; - - let fn_token = input.parse()?; - let ident = input.parse()?; - let generics: Generics = input.parse()?; - - let content; - let paren_token = syn::parenthesized!(content in input); - - let first_arg: FnArg = content.parse()?; - let cx_token = { - match first_arg { - FnArg::Receiver(_) => panic!("first argument must not be a receiver argument"), - FnArg::Typed(f) => f.pat, - } - }; - - let _: Result = content.parse(); - - let inputs = syn::punctuated::Punctuated::parse_terminated(&content)?; - - let output = input.parse()?; - - let where_clause = input - .peek(syn::token::Where) - .then(|| input.parse()) - .transpose()?; - - let block = input.parse()?; - - Ok(Self { - vis, - maybe_async, - fn_token, - ident, - generics, - paren_token, - inputs, - output, - where_clause, - block, - cx_token, - attrs, - }) - } -} - -/// Serialize the same way, regardless of flavor -impl ToTokens for InlinePropsBody { - fn to_tokens(&self, out_tokens: &mut TokenStream2) { - let Self { - vis, - ident, - generics, - inputs, - output, - where_clause, - block, - cx_token, - attrs, - maybe_async, - .. - } = self; - - let fields = inputs.iter().map(|f| { - quote! { #vis #f } - }); - - let struct_name = Ident::new(&format!("{ident}Props"), Span::call_site()); - - let field_names = inputs.iter().filter_map(|f| match f { - FnArg::Receiver(_) => todo!(), - FnArg::Typed(t) => Some(&t.pat), - }); - - let first_lifetime = if let Some(GenericParam::Lifetime(lt)) = generics.params.first() { - Some(lt) - } else { - None - }; - - let modifiers = if first_lifetime.is_some() { - quote! { #[derive(Props)] } - } else { - quote! { #[derive(Props, PartialEq)] } - }; - - let (scope_lifetime, fn_generics, struct_generics) = if let Some(lt) = first_lifetime { - let struct_generics: Punctuated<_, token::Comma> = generics - .params - .iter() - .map(|it| match it { - GenericParam::Type(tp) => { - let mut tp = tp.clone(); - tp.bounds.push(parse_quote!( 'a )); - - GenericParam::Type(tp) - } - _ => it.clone(), - }) - .collect(); - - ( - quote! { #lt, }, - generics.clone(), - quote! { <#struct_generics> }, - ) - } else { - let lifetime: LifetimeParam = parse_quote! { 'a }; - - let mut fn_generics = generics.clone(); - fn_generics - .params - .insert(0, GenericParam::Lifetime(lifetime.clone())); - - (quote! { #lifetime, }, fn_generics, quote! { #generics }) - }; - - let generics_no_bounds = { - let mut generics = generics.clone(); - generics.params = generics - .params - .iter() - .map(|it| match it { - GenericParam::Type(tp) => { - let mut tp = tp.clone(); - tp.bounds.clear(); - - GenericParam::Type(tp) - } - _ => it.clone(), - }) - .collect(); - - generics - }; - - out_tokens.append_all(quote! { - #modifiers - #[allow(non_camel_case_types)] - #vis struct #struct_name #struct_generics - #where_clause - { - #(#fields),* - } - - #(#attrs)* - #maybe_async #vis fn #ident #fn_generics (#cx_token: Scope<#scope_lifetime #struct_name #generics_no_bounds>) #output - #where_clause - { - let #struct_name { #(#field_names),* } = &#cx_token.props; - #block - } - }); - } -} diff --git a/packages/core-macro/src/lib.rs b/packages/core-macro/src/lib.rs index 501c38e7b..d91c72e39 100644 --- a/packages/core-macro/src/lib.rs +++ b/packages/core-macro/src/lib.rs @@ -1,12 +1,18 @@ use proc_macro::TokenStream; use quote::ToTokens; use rsx::RenderCallBody; -use syn::parse_macro_input; +use syn::parse::Parser; +use syn::punctuated::Punctuated; +use syn::{parse_macro_input, Path, Token}; -mod inlineprops; +mod component_body; +mod component_body_deserializers; mod props; // mod rsx; +use crate::component_body::ComponentBody; +use crate::component_body_deserializers::component::ComponentDeserializerArgs; +use crate::component_body_deserializers::inline_props::InlinePropsDeserializerArgs; use dioxus_rsx as rsx; #[proc_macro] @@ -18,7 +24,7 @@ pub fn format_args_f(input: TokenStream) -> TokenStream { } #[proc_macro_derive(Props, attributes(props))] -pub fn derive_typed_builder(input: proc_macro::TokenStream) -> proc_macro::TokenStream { +pub fn derive_typed_builder(input: TokenStream) -> TokenStream { let input = parse_macro_input!(input as syn::DeriveInput); match props::impl_my_derive(&input) { Ok(output) => output.into(), @@ -37,7 +43,7 @@ pub fn rsx(s: TokenStream) -> TokenStream { /// The render! macro makes it easy for developers to write jsx-style markup in their components. /// -/// The render macro automatically renders rsx - making it unhygenic. +/// The render macro automatically renders rsx - making it unhygienic. #[proc_macro] pub fn render(s: TokenStream) -> TokenStream { match syn::parse::(s) { @@ -55,7 +61,7 @@ pub fn render(s: TokenStream) -> TokenStream { /// you would be repeating a lot of the usual Rust boilerplate. /// /// # Example -/// ```ignore +/// ```rust,ignore /// #[inline_props] /// fn app(cx: Scope, bob: String) -> Element { /// cx.render(rsx!("hello, {bob}")) @@ -73,9 +79,118 @@ pub fn render(s: TokenStream) -> TokenStream { /// } /// ``` #[proc_macro_attribute] -pub fn inline_props(_args: proc_macro::TokenStream, s: TokenStream) -> TokenStream { - match syn::parse::(s) { +#[deprecated(note = "Use `#[component]` instead.")] +pub fn inline_props(_args: TokenStream, s: TokenStream) -> TokenStream { + let comp_body = parse_macro_input!(s as ComponentBody); + + match comp_body.deserialize(InlinePropsDeserializerArgs {}) { Err(e) => e.to_compile_error().into(), - Ok(s) => s.to_token_stream().into(), + Ok(output) => output.to_token_stream().into(), + } +} + +pub(crate) const COMPONENT_ARG_CASE_CHECK_OFF: &str = "no_case_check"; + +/// Streamlines component creation. +/// This is the recommended way of creating components, +/// though you might want lower-level control with more advanced uses. +/// +/// # Arguments +/// * `no_case_check` - Doesn't enforce `PascalCase` on your component names. +/// **This will be removed/deprecated in a future update in favor of a more complete Clippy-backed linting system.** +/// The reasoning behind this is that Clippy allows more robust and powerful lints, whereas +/// macros are extremely limited. +/// +/// # Features +/// This attribute: +/// * Enforces that your component uses `PascalCase`. +/// No warnings are generated for the `PascalCase` +/// function name, but everything else will still raise a warning if it's incorrectly `PascalCase`. +/// Does not disable warnings anywhere else, so if you, for example, +/// accidentally don't use `snake_case` +/// for a variable name in the function, the compiler will still warn you. +/// * Automatically uses `#[inline_props]` if there's more than 1 parameter in the function. +/// * Verifies the validity of your component. +/// E.g. if it has a [`Scope`](dioxus_core::Scope) argument. +/// Notes: +/// * This doesn't work 100% of the time, because of macro limitations. +/// * Provides helpful messages if your component is not correct. +/// Possible bugs (please, report these!): +/// * There might be bugs where it incorrectly *denies* validity. +/// This is bad as it means that you can't use the attribute or you have to change the component. +/// * There might be bugs where it incorrectly *confirms* validity. +/// You will still know if the component is invalid once you use it, +/// but the error might be less helpful. +/// +/// # Examples +/// * Without props: +/// ```rust,ignore +/// #[component] +/// fn GreetBob(cx: Scope) -> Element { +/// render! { "hello, bob" } +/// } +/// +/// // is equivalent to +/// +/// #[allow(non_snake_case)] +/// fn GreetBob(cx: Scope) -> Element { +/// #[warn(non_snake_case)] +/// #[inline(always)] +/// fn __dx_inner_comp(cx: Scope) -> Element { +/// render! { "hello, bob" } +/// } +/// // There's no function call overhead since __dx_inner_comp has the #[inline(always)] attribute, +/// // so don't worry about performance. +/// __dx_inner_comp(cx) +/// } +/// ``` +/// * With props: +/// ```rust,ignore +/// #[component(no_case_check)] +/// fn GreetPerson(cx: Scope, person: String) -> Element { +/// render! { "hello, {person}" } +/// } +/// +/// // is equivalent to +/// +/// #[derive(Props, PartialEq)] +/// #[allow(non_camel_case_types)] +/// struct GreetPersonProps { +/// person: String, +/// } +/// +/// #[allow(non_snake_case)] +/// fn GreetPerson<'a>(cx: Scope<'a, GreetPersonProps>) -> Element { +/// #[warn(non_snake_case)] +/// #[inline(always)] +/// fn __dx_inner_comp<'a>(cx: Scope<'a, GreetPersonProps>e) -> Element { +/// let GreetPersonProps { person } = &cx.props; +/// { +/// render! { "hello, {person}" } +/// } +/// } +/// +/// __dx_inner_comp(cx) +/// } +/// ``` +// TODO: Maybe add an option to input a custom component name through the args. +// I think that's unnecessary, but there might be some scenario where it could be useful. +#[proc_macro_attribute] +pub fn component(args: TokenStream, input: TokenStream) -> TokenStream { + let component_body = parse_macro_input!(input as ComponentBody); + let case_check = match Punctuated::::parse_terminated.parse(args) { + Err(e) => return e.to_compile_error().into(), + Ok(args) => { + if let Some(first) = args.first() { + !first.is_ident(COMPONENT_ARG_CASE_CHECK_OFF) + } else { + true + } + } + }; + + match component_body.deserialize(ComponentDeserializerArgs { case_check }) { + Err(e) => e.to_compile_error().into(), + Ok(output) => output.to_token_stream().into(), } } diff --git a/packages/core-macro/src/props/mod.rs b/packages/core-macro/src/props/mod.rs index 6a0d24a95..c1931e497 100644 --- a/packages/core-macro/src/props/mod.rs +++ b/packages/core-macro/src/props/mod.rs @@ -2,9 +2,9 @@ //! //! However, it has been adopted to fit the Dioxus Props builder pattern. //! -//! For dioxus, we make a few changes: -//! - [ ] automatically implement Into

, props: P, cfg: Config) if temp.contains_key("href") { let open = webbrowser::open(temp["href"].as_str().unwrap()); if let Err(e) = open { - log::error!("Open Browser error: {:?}", e); + tracing::error!("Open Browser error: {:?}", e); } } } diff --git a/packages/desktop/src/protocol.rs b/packages/desktop/src/protocol.rs index 7a9e0b8e7..1f407561c 100644 --- a/packages/desktop/src/protocol.rs +++ b/packages/desktop/src/protocol.rs @@ -149,7 +149,7 @@ pub(super) fn desktop_handler( .map_err(From::from); } - log::error!( + tracing::error!( "Failed to find {} (as path {})", request.uri().path(), asset.display() diff --git a/packages/desktop/src/query.rs b/packages/desktop/src/query.rs index 247f333e8..d38478c61 100644 --- a/packages/desktop/src/query.rs +++ b/packages/desktop/src/query.rs @@ -123,7 +123,7 @@ impl QueryEngine { }}) }})();"# )) { - log::warn!("Query error: {err}"); + tracing::warn!("Query error: {err}"); } Query { diff --git a/packages/desktop/src/readme.md b/packages/desktop/src/readme.md index cd4dbe41a..ac2205b4c 100644 --- a/packages/desktop/src/readme.md +++ b/packages/desktop/src/readme.md @@ -8,7 +8,6 @@ One of Dioxus' flagship features is the ability to quickly build a native deskto Dioxus Desktop is built off Tauri. Right now there aren't any Dioxus abstractions over the menubar, handling, etc, so you'll want to leverage Tauri - mostly [Wry](http://github.com/tauri-apps/wry/) and [Tao](http://github.com/tauri-apps/tao) directly. An upcoming release of Dioxus-Desktop will include components and hooks for notifications, global shortcuts, menubar, etc. - ## Getting Set up Getting Set up with Dioxus-Desktop is quite easy. Make sure you have Rust and Cargo installed, and then create a new project: @@ -44,9 +43,8 @@ fn app(cx: Scope) -> Element { } ``` - To configure the webview, menubar, and other important desktop-specific features, checkout out some of the launch configuration in the [API reference](https://docs.rs/dioxus-desktop/). ## Future Steps -Make sure to read the [Dioxus Guide](https://dioxuslabs.com/docs/0.3/guide/en) if you already haven't! +Make sure to read the [Dioxus Guide](https://dioxuslabs.com/learn/0.4/) if you already haven't! diff --git a/packages/dioxus-tui/Cargo.toml b/packages/dioxus-tui/Cargo.toml index 1286ca010..0d0bb59f4 100644 --- a/packages/dioxus-tui/Cargo.toml +++ b/packages/dioxus-tui/Cargo.toml @@ -5,7 +5,7 @@ authors = ["Jonathan Kelley, Evan Almloff"] edition = "2021" description = "TUI-based renderer for Dioxus" repository = "https://github.com/DioxusLabs/dioxus/" -homepage = "https://dioxuslabs.com/docs/0.3/guide/en/getting_started/tui.html" +homepage = "https://dioxuslabs.com/learn/0.4/getting_started/tui" keywords = ["dom", "ui", "gui", "react", "terminal"] license = "MIT OR Apache-2.0" diff --git a/packages/dioxus/Cargo.toml b/packages/dioxus/Cargo.toml index ea052230b..2c284bf1a 100644 --- a/packages/dioxus/Cargo.toml +++ b/packages/dioxus/Cargo.toml @@ -6,7 +6,7 @@ edition = "2021" description = "Portable, performant, and ergonomic framework for building cross-platform user interfaces in Rust" license = "MIT OR Apache-2.0" repository = "https://github.com/DioxusLabs/dioxus/" -homepage = "https://dioxuslabs.com/docs/0.3/guide/en/index.html" +homepage = "https://dioxuslabs.com/learn/0.4/" keywords = ["dom", "ui", "gui", "react", "wasm"] rust-version = "1.65.0" @@ -30,7 +30,7 @@ hot-reload = ["dioxus-hot-reload"] [dev-dependencies] futures-util = { workspace = true } -log = { workspace = true } +tracing = { workspace = true } rand = { version = "0.8.4", features = ["small_rng"] } criterion = "0.3.5" thiserror = { workspace = true } diff --git a/packages/dioxus/README.md b/packages/dioxus/README.md index 31fff88fa..5bbb37aa0 100644 --- a/packages/dioxus/README.md +++ b/packages/dioxus/README.md @@ -1,4 +1,4 @@ -

+

πŸŒ—πŸš€ Dioxus

A concurrent, functional, virtual DOM for Rust @@ -9,8 +9,8 @@ This overview provides a brief introduction to Dioxus. For a more in-depth guide, make sure to check out: -- [Getting Started](https://dioxuslabs.com/docs/0.3/guide/en/getting_started/index.html) -- [Book](https://dioxuslabs.com/docs/0.3/guide/en/) +- [Getting Started](https://dioxuslabs.com/learn/0.4/getting_started) +- [Book (0.4)](https://dioxuslabs.com/learn/0.4/) - [Examples](https://github.com/DioxusLabs/example-projects) # Overview and Goals @@ -27,15 +27,15 @@ Dioxus is heavily inspired by React, supporting many of the same concepts: If you know React, then you know Dioxus. -Dioxus is *substantially* more performant than many of the other Rust UI libraries (Yew/Percy) and is *significantly* more performant -than React - roughly competitive with InfernoJS. +Dioxus is _substantially_ more performant than many of the other Rust UI libraries (Yew/Percy) and is _significantly_ more performant +than Reactβ€”roughly competitive with InfernoJS. -Remember: Dioxus is a library for declaring interactive user interfaces - it is not a dedicated renderer. Most 1st party renderers for Dioxus currently only support web technologies. +Remember: Dioxus is a library for declaring interactive user interfacesβ€”it is not a dedicated renderer. Most 1st party renderers for Dioxus currently only support web technologies. ## Brief Overview All Dioxus apps are built by composing functions that take in a `Scope` which is generic over some `Properties` and return an `Element`. -A `Scope` holds relevant state data for the currently-rendered component. +A `Scope` holds relevant state data for the currently rendered component. To launch an app, we use the `launch` method for the specific renderer we want to use. In the launch function, we pass the app's `Component`. @@ -43,10 +43,13 @@ To launch an app, we use the `launch` method for the specific renderer we want t use dioxus::prelude::*; fn main() { - dioxus_desktop::launch(app); + dioxus_desktop::launch(App); } -fn app(cx: Scope) -> Element { +// The #[component] attribute streamlines component creation. +// It's not required, but highly recommended. For example, UpperCamelCase components will not generate a warning. +#[component] +fn App(cx: Scope) -> Element { cx.render(rsx!("hello world!")) } ``` @@ -59,7 +62,7 @@ macro or the NodeFactory API. For the most part, you want to use the `rsx!` macro. Any element in `rsx!` can have attributes, listeners, and children. For -consistency, we force all attributes and listeners to be listed *before* +consistency, we force all attributes and listeners to be listed _before_ children. ```rust, ignore @@ -84,7 +87,6 @@ rsx!( (0..10).map(|_| rsx!(span { "hello world" })) } ) - ``` Used within components, the `rsx!` macro must be rendered into an `Element` with @@ -95,7 +97,8 @@ If we want to omit the boilerplate of `cx.render`, we can simply pass in render nodes in match statements. ```rust, ignore -fn example(cx: Scope) -> Element { +#[component[ +fn Example(cx: Scope) -> Element { // both of these are equivalent cx.render(rsx!("hello world")) @@ -108,7 +111,8 @@ Putting everything together, we can write a simple component that renders a list elements: ```rust, ignore -fn app(cx: Scope) -> Element { +#[component] +fn App(cx: Scope) -> Element { let name = "dave"; cx.render(rsx!( h1 { "Hello, {name}!" } @@ -136,6 +140,7 @@ properties, we can use the `()` type or simply omit the type altogether. In Dioxus, all properties are memoized by default! ```rust, ignore +#[component] fn App(cx: Scope) -> Element { cx.render(rsx!( Header { @@ -157,6 +162,7 @@ struct HeaderProps { color: String, } +#[component] fn Header(cx: Scope) -> Element { cx.render(rsx!( div { @@ -167,11 +173,11 @@ fn Header(cx: Scope) -> Element { } ``` -Components may use the `inline_props` macro to completely inline the props -definition into the function arguments. +The `#[component]` macro also allows you to derive the props +struct from function arguments: ```rust, ignore -#[inline_props] +#[component] fn Header(cx: Scope, title: String, color: String) -> Element { cx.render(rsx!( div { @@ -184,6 +190,7 @@ fn Header(cx: Scope, title: String, color: String) -> Element { Components may also borrow data from their parent component. We just need to attach some lifetimes to the props struct. + > Note: we don't need to derive `PartialEq` for borrowed props since they cannot be memoized. ```rust, ignore @@ -193,6 +200,7 @@ struct HeaderProps<'a> { color: &'a str, } +#[component] fn Header<'a>(cx: Scope<'a, HeaderProps<'a>>) -> Element { cx.render(rsx!( div { @@ -221,6 +229,9 @@ rsx!( ) ``` +However, the convention is to use UpperCamelCase. The `#[component]` attribute will enforce this, +but you can turn it off if you wish. + ## Hooks While components are reusable forms of UI elements, hooks are reusable forms @@ -231,7 +242,8 @@ By convention, all hooks are functions that should start with `use_`. We can use hooks to define the state and modify it from within listeners. ```rust, ignore -fn app(cx: Scope) -> Element { +#[component] +fn App(cx: Scope) -> Element { let name = use_state(cx, || "world"); render!("hello {name}!") @@ -239,10 +251,11 @@ fn app(cx: Scope) -> Element { ``` Hooks are sensitive to how they are used. To use hooks, you must abide by the -["rules of hooks" (borrowed from react)](https://reactjs.org/docs/hooks-rules.html): -- Functions with "use_" should not be called in callbacks -- Functions with "use_" should not be called out of order -- Functions with "use_" should not be called in loops or conditionals +["rules of hooks" (borrowed from React)](https://reactjs.org/docs/hooks-rules.html): + +- Functions with "use\_" should not be called in callbacks +- Functions with "use\_" should not be called out of order +- Functions with "use\_" should not be called in loops or conditionals In a sense, hooks let us add a field of state to our component without declaring an explicit state struct. However, this means we need to "load" the struct in the right @@ -278,6 +291,7 @@ fn main() { dioxus_desktop::launch(App); } +#[component] fn App(cx: Scope) -> Element { let count = use_state(cx, || 0); @@ -295,6 +309,7 @@ This overview doesn't cover everything. Make sure to check out the tutorial and website for more details. Beyond this overview, Dioxus supports: + - Server-side rendering - Concurrent rendering (with async support) - Web/Desktop/Mobile support @@ -311,14 +326,16 @@ Good luck! ## Inspiration, Resources, Alternatives, and Credits Dioxus is inspired by: + - React: for its hooks, concurrency, suspense - Dodrio: for its research in bump allocation, double buffering, and diffing architecture Alternatives to Dioxus include: + - Yew: supports function components and web, but no SSR, borrowed data, or bump allocation. Rather slow at times. - Percy: supports function components, web, ssr, but lacks state management - Sycamore: supports function components, web, ssr, but is closer to SolidJS than React -- MoonZoom/Seed: opinionated frameworks based on the Elm model (message, update) - no hooks +- MoonZoom/Seed: opinionated frameworks based on the Elm model (message, update)β€”no hooks -We've put a lot of work into making Dioxus ergonomic and *familiar*. -Our target audience is TypeScript developers looking to switch to Rust for the web - so we need to be comparable to React. +We've put a lot of work into making Dioxus ergonomic and _familiar_. +Our target audience is TypeScript developers looking to switch to Rust for the webβ€”so we need to be comparable to React. diff --git a/packages/dioxus/src/lib.rs b/packages/dioxus/src/lib.rs index 5d1371f27..bc2cd76e6 100644 --- a/packages/dioxus/src/lib.rs +++ b/packages/dioxus/src/lib.rs @@ -24,7 +24,8 @@ pub mod prelude { pub use dioxus_core::prelude::*; #[cfg(feature = "macro")] - pub use dioxus_core_macro::{format_args_f, inline_props, render, rsx, Props}; + #[allow(deprecated)] + pub use dioxus_core_macro::{component, format_args_f, inline_props, render, rsx, Props}; #[cfg(feature = "html")] pub use dioxus_html as dioxus_elements; diff --git a/packages/fermi/Cargo.toml b/packages/fermi/Cargo.toml index a50a06852..92a0ede71 100644 --- a/packages/fermi/Cargo.toml +++ b/packages/fermi/Cargo.toml @@ -14,7 +14,7 @@ keywords = ["dom", "ui", "gui", "react", "state-management"] [dependencies] dioxus-core = { workspace = true } im-rc = { version = "15.0.0", features = ["serde"] } -log = { workspace = true } +tracing = { workspace = true } [dev-dependencies] closure = "0.3.0" diff --git a/packages/fermi/src/root.rs b/packages/fermi/src/root.rs index f77930c75..67f6514c7 100644 --- a/packages/fermi/src/root.rs +++ b/packages/fermi/src/root.rs @@ -66,14 +66,14 @@ impl AtomRoot { if let Some(slot) = atoms.get_mut(&ptr) { slot.value = Rc::new(value); - log::trace!("found item with subscribers {:?}", slot.subscribers); + tracing::trace!("found item with subscribers {:?}", slot.subscribers); for scope in &slot.subscribers { - log::trace!("updating subcsriber"); + tracing::trace!("updating subcsriber"); (self.update_any)(*scope); } } else { - log::trace!("no atoms found for {:?}", ptr); + tracing::trace!("no atoms found for {:?}", ptr); atoms.insert( ptr, Slot { @@ -96,7 +96,7 @@ impl AtomRoot { pub fn force_update(&self, ptr: AtomId) { if let Some(slot) = self.atoms.borrow_mut().get(&ptr) { for scope in slot.subscribers.iter() { - log::trace!("updating subcsriber"); + tracing::trace!("updating subcsriber"); (self.update_any)(*scope); } } diff --git a/packages/fullstack/Cargo.toml b/packages/fullstack/Cargo.toml index 82ed7c8d7..8ab213e78 100644 --- a/packages/fullstack/Cargo.toml +++ b/packages/fullstack/Cargo.toml @@ -44,7 +44,8 @@ dioxus-desktop = { workspace = true, optional = true } # Router Integration dioxus-router = { workspace = true, optional = true } -log = { workspace = true } +tracing = { workspace = true } +tracing-futures = { workspace = true } once_cell = "1.17.1" thiserror = { workspace = true } tokio = { workspace = true, features = ["full"], optional = true } diff --git a/packages/fullstack/README.md b/packages/fullstack/README.md index ecd003ee8..3128c3598 100644 --- a/packages/fullstack/README.md +++ b/packages/fullstack/README.md @@ -15,7 +15,7 @@ [discord-url]: https://discord.gg/XgGxMSkvUM [Website](https://dioxuslabs.com) | -[Guides](https://dioxuslabs.com/docs/0.3/guide/en/) | +[Guides](https://dioxuslabs.com/learn/0.4/) | [API Docs](https://docs.rs/dioxus-fullstack/latest/dioxus_sever) | [Chat](https://discord.gg/XgGxMSkvUM) diff --git a/packages/fullstack/examples/axum-hello-world/Cargo.toml b/packages/fullstack/examples/axum-hello-world/Cargo.toml index 2073e4655..a3b68b05a 100644 --- a/packages/fullstack/examples/axum-hello-world/Cargo.toml +++ b/packages/fullstack/examples/axum-hello-world/Cargo.toml @@ -12,8 +12,9 @@ dioxus-fullstack = { workspace = true } axum = { version = "0.6.12", optional = true } serde = "1.0.159" simple_logger = "4.2.0" -wasm-logger = "0.2.0" -log.workspace = true +tracing-wasm = "0.2.1" +tracing.workspace = true +tracing-subscriber = "0.3.17" reqwest = "0.11.18" [features] diff --git a/packages/fullstack/examples/axum-hello-world/src/main.rs b/packages/fullstack/examples/axum-hello-world/src/main.rs index 985a5a717..8f1d3c8c6 100644 --- a/packages/fullstack/examples/axum-hello-world/src/main.rs +++ b/packages/fullstack/examples/axum-hello-world/src/main.rs @@ -12,7 +12,6 @@ use dioxus_fullstack::{ prelude::*, }; use serde::{Deserialize, Serialize}; -use wasm_logger::Config; #[derive(Props, PartialEq, Debug, Default, Serialize, Deserialize, Clone)] struct AppProps { @@ -66,9 +65,9 @@ async fn get_server_data() -> Result { fn main() { #[cfg(feature = "web")] - wasm_logger::init(wasm_logger::Config::new(log::Level::Trace)); + tracing_wasm::set_as_global_default(); #[cfg(feature = "ssr")] - simple_logger::SimpleLogger::new().init().unwrap(); + tracing_subscriber::fmt::init(); LaunchBuilder::new_with_props(app, AppProps { count: 0 }).launch() } diff --git a/packages/fullstack/examples/axum-router/src/main.rs b/packages/fullstack/examples/axum-router/src/main.rs index 6780aec6f..176bf3361 100644 --- a/packages/fullstack/examples/axum-router/src/main.rs +++ b/packages/fullstack/examples/axum-router/src/main.rs @@ -5,8 +5,6 @@ //! cargo run --features ssr --release //! ``` -#![allow(non_snake_case)] - use dioxus::prelude::*; use dioxus_fullstack::prelude::*; use dioxus_router::prelude::*; @@ -33,7 +31,7 @@ enum Route { Blog { id: i32 }, } -#[inline_props] +#[component] fn Blog(cx: Scope, id: i32) -> Element { render! { Link { to: Route::Home {}, "Go to counter" } @@ -51,7 +49,7 @@ fn Blog(cx: Scope, id: i32) -> Element { } } -#[inline_props] +#[component] fn Home(cx: Scope) -> Element { let mut count = use_state(cx, || 0); let text = use_state(cx, || "...".to_string()); diff --git a/packages/fullstack/examples/salvo-hello-world/Cargo.toml b/packages/fullstack/examples/salvo-hello-world/Cargo.toml index 977ad7843..ca0d85ecf 100644 --- a/packages/fullstack/examples/salvo-hello-world/Cargo.toml +++ b/packages/fullstack/examples/salvo-hello-world/Cargo.toml @@ -16,8 +16,9 @@ salvo = { version = "0.37.9", optional = true } execute = "0.2.12" reqwest = "0.11.18" simple_logger = "4.2.0" -log.workspace = true -wasm-logger = "0.2.0" +tracing-wasm = "0.2.1" +tracing.workspace = true +tracing-subscriber = "0.3.17" [features] default = [] diff --git a/packages/fullstack/examples/salvo-hello-world/src/main.rs b/packages/fullstack/examples/salvo-hello-world/src/main.rs index df119b4dd..838ee6f2c 100644 --- a/packages/fullstack/examples/salvo-hello-world/src/main.rs +++ b/packages/fullstack/examples/salvo-hello-world/src/main.rs @@ -60,9 +60,9 @@ async fn get_server_data() -> Result { fn main() { #[cfg(feature = "web")] - wasm_logger::init(wasm_logger::Config::new(log::Level::Trace)); + tracing_wasm::set_as_global_default(); #[cfg(feature = "ssr")] - simple_logger::SimpleLogger::new().init().unwrap(); + tracing_subscriber::fmt::init(); LaunchBuilder::new_with_props(app, AppProps { count: 0 }).launch() } diff --git a/packages/fullstack/examples/static-hydrated/src/main.rs b/packages/fullstack/examples/static-hydrated/src/main.rs index 78963be7e..2539d0deb 100644 --- a/packages/fullstack/examples/static-hydrated/src/main.rs +++ b/packages/fullstack/examples/static-hydrated/src/main.rs @@ -5,7 +5,7 @@ //! cargo run --features ssr //! ``` -#![allow(non_snake_case, unused)] +#![allow(unused)] use dioxus::prelude::*; use dioxus_fullstack::{launch, prelude::*}; use dioxus_router::prelude::*; @@ -49,7 +49,7 @@ enum Route { Blog, } -#[inline_props] +#[component] fn Blog(cx: Scope) -> Element { render! { Link { to: Route::Home {}, "Go to counter" } @@ -67,7 +67,7 @@ fn Blog(cx: Scope) -> Element { } } -#[inline_props] +#[component] fn Home(cx: Scope) -> Element { let mut count = use_state(cx, || 0); let text = use_state(cx, || "...".to_string()); diff --git a/packages/fullstack/examples/warp-hello-world/Cargo.toml b/packages/fullstack/examples/warp-hello-world/Cargo.toml index d9e82b4c4..1474facf3 100644 --- a/packages/fullstack/examples/warp-hello-world/Cargo.toml +++ b/packages/fullstack/examples/warp-hello-world/Cargo.toml @@ -16,8 +16,9 @@ warp = { version = "0.3.3", optional = true } execute = "0.2.12" reqwest = "0.11.18" simple_logger = "4.2.0" -log.workspace = true -wasm-logger = "0.2.0" +tracing-wasm = "0.2.1" +tracing.workspace = true +tracing-subscriber = "0.3.17" [features] default = [] diff --git a/packages/fullstack/examples/warp-hello-world/src/main.rs b/packages/fullstack/examples/warp-hello-world/src/main.rs index df119b4dd..838ee6f2c 100644 --- a/packages/fullstack/examples/warp-hello-world/src/main.rs +++ b/packages/fullstack/examples/warp-hello-world/src/main.rs @@ -60,9 +60,9 @@ async fn get_server_data() -> Result { fn main() { #[cfg(feature = "web")] - wasm_logger::init(wasm_logger::Config::new(log::Level::Trace)); + tracing_wasm::set_as_global_default(); #[cfg(feature = "ssr")] - simple_logger::SimpleLogger::new().init().unwrap(); + tracing_subscriber::fmt::init(); LaunchBuilder::new_with_props(app, AppProps { count: 0 }).launch() } diff --git a/packages/fullstack/src/adapters/axum_adapter.rs b/packages/fullstack/src/adapters/axum_adapter.rs index 330d15bc3..95d9ee6cd 100644 --- a/packages/fullstack/src/adapters/axum_adapter.rs +++ b/packages/fullstack/src/adapters/axum_adapter.rs @@ -263,8 +263,8 @@ where let res = service.run(req); match res.await { Ok(res) => Ok::<_, std::convert::Infallible>(res.map(|b| b.into())), - Err(_e) => { - let mut res = Response::new(Body::empty()); + Err(e) => { + let mut res = Response::new(Body::from(e.to_string())); *res.status_mut() = StatusCode::INTERNAL_SERVER_ERROR; Ok(res) } @@ -389,7 +389,7 @@ pub async fn render_handler response } Err(e) => { - log::error!("Failed to render page: {}", e); + tracing::error!("Failed to render page: {}", e); report_err(e).into_response() } } diff --git a/packages/fullstack/src/adapters/salvo_adapter.rs b/packages/fullstack/src/adapters/salvo_adapter.rs index 671128b65..674722665 100644 --- a/packages/fullstack/src/adapters/salvo_adapter.rs +++ b/packages/fullstack/src/adapters/salvo_adapter.rs @@ -423,7 +423,7 @@ impl Handler for SSRHandler freshness.write(res.headers_mut()); } Err(err) => { - log::error!("Error rendering SSR: {}", err); + tracing::error!("Error rendering SSR: {}", err); res.write_body("Error rendering SSR").unwrap(); } }; diff --git a/packages/fullstack/src/adapters/warp_adapter.rs b/packages/fullstack/src/adapters/warp_adapter.rs index 723314ca3..316d70e56 100644 --- a/packages/fullstack/src/adapters/warp_adapter.rs +++ b/packages/fullstack/src/adapters/warp_adapter.rs @@ -84,7 +84,7 @@ use warp::{ /// async move { /// let req = warp::hyper::Request::from_parts(parts, bytes.into()); /// service.run(req).await.map_err(|err| { -/// log::error!("Server function error: {}", err); +/// tracing::error!("Server function error: {}", err); /// warp::reject::reject() /// }) /// } @@ -142,8 +142,18 @@ pub fn register_server_fns(server_fn_route: &'static str) -> BoxedFilter<(impl R async move { let req = warp::hyper::Request::from_parts(parts, bytes.into()); service.run(req).await.map_err(|err| { - log::error!("Server function error: {}", err); - warp::reject::reject() + tracing::error!("Server function error: {}", err); + + struct WarpServerFnError(String); + impl std::fmt::Debug for WarpServerFnError { + fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { + write!(f, "{}", self.0) + } + } + + impl warp::reject::Reject for WarpServerFnError {} + + warp::reject::custom(WarpServerFnError(err.to_string())) }) } }) @@ -222,7 +232,7 @@ pub fn render_ssr( res } Err(err) => { - log::error!("Failed to render ssr: {}", err); + tracing::error!("Failed to render ssr: {}", err); Response::builder() .status(500) .body("Failed to render ssr".into()) diff --git a/packages/fullstack/src/hooks/server_cached.rs b/packages/fullstack/src/hooks/server_cached.rs index 80bb93008..519f70dae 100644 --- a/packages/fullstack/src/hooks/server_cached.rs +++ b/packages/fullstack/src/hooks/server_cached.rs @@ -23,7 +23,7 @@ pub fn server_cached(server_fn: impl let data = server_fn(); let sc = crate::prelude::server_context(); if let Err(err) = sc.push_html_data(&data) { - log::error!("Failed to push HTML data: {}", err); + tracing::error!("Failed to push HTML data: {}", err); } data } diff --git a/packages/fullstack/src/hooks/server_future.rs b/packages/fullstack/src/hooks/server_future.rs index 9a13df235..e4d89480e 100644 --- a/packages/fullstack/src/hooks/server_future.rs +++ b/packages/fullstack/src/hooks/server_future.rs @@ -47,13 +47,13 @@ where if first_run { match crate::html_storage::deserialize::take_server_data() { Some(data) => { - log::trace!("Loaded {data:?} from server"); + tracing::trace!("Loaded {data:?} from server"); *state.value.borrow_mut() = Some(Box::new(data)); state.needs_regen.set(false); return Some(state); } None => { - log::trace!("Failed to load from server... running future"); + tracing::trace!("Failed to load from server... running future"); } }; } @@ -82,7 +82,7 @@ where data = fut.await; if first_run { if let Err(err) = crate::prelude::server_context().push_html_data(&data) { - log::error!("Failed to push HTML data: {}", err); + tracing::error!("Failed to push HTML data: {}", err); }; } } @@ -99,7 +99,7 @@ where if first_run { #[cfg(feature = "ssr")] { - log::trace!("Suspending first run of use_server_future"); + tracing::trace!("Suspending first run of use_server_future"); cx.suspend(); } None diff --git a/packages/fullstack/src/hot_reload.rs b/packages/fullstack/src/hot_reload.rs index b94df4811..87f219df8 100644 --- a/packages/fullstack/src/hot_reload.rs +++ b/packages/fullstack/src/hot_reload.rs @@ -30,7 +30,7 @@ impl Default for HotReloadState { } if let Err(err) = tx.send(Some(template)) { - log::error!("Failed to send hot reload message: {}", err); + tracing::error!("Failed to send hot reload message: {}", err); } } dioxus_hot_reload::HotReloadMsg::Shutdown => { diff --git a/packages/fullstack/src/html_storage/deserialize.rs b/packages/fullstack/src/html_storage/deserialize.rs index 822b45076..7fc70ba6c 100644 --- a/packages/fullstack/src/html_storage/deserialize.rs +++ b/packages/fullstack/src/html_storage/deserialize.rs @@ -10,7 +10,7 @@ pub(crate) fn serde_from_bytes(string: &[u8]) -> Option let decompressed = match STANDARD.decode(string) { Ok(bytes) => bytes, Err(err) => { - log::error!("Failed to decode base64: {}", err); + tracing::error!("Failed to decode base64: {}", err); return None; } }; @@ -18,7 +18,7 @@ pub(crate) fn serde_from_bytes(string: &[u8]) -> Option match postcard::from_bytes(&decompressed) { Ok(data) => Some(data), Err(err) => { - log::error!("Failed to deserialize: {}", err); + tracing::error!("Failed to deserialize: {}", err); None } } @@ -32,14 +32,14 @@ static SERVER_DATA: once_cell::sync::Lazy> = let element = match window.get_element_by_id("dioxus-storage-data") { Some(element) => element, None => { - log::error!("Failed to get element by id: dioxus-storage-data"); + tracing::error!("Failed to get element by id: dioxus-storage-data"); return None; } }; let attribute = match element.get_attribute("data-serialized") { Some(attribute) => attribute, None => { - log::error!("Failed to get attribute: data-serialized"); + tracing::error!("Failed to get attribute: data-serialized"); return None; } }; diff --git a/packages/fullstack/src/html_storage/mod.rs b/packages/fullstack/src/html_storage/mod.rs index 2d64953ae..5b4d2804f 100644 --- a/packages/fullstack/src/html_storage/mod.rs +++ b/packages/fullstack/src/html_storage/mod.rs @@ -36,7 +36,7 @@ impl HTMLDataCursor { pub fn take(&self) -> Option { let current = self.index.load(std::sync::atomic::Ordering::SeqCst); if current >= self.data.len() { - log::error!( + tracing::error!( "Tried to take more data than was available, len: {}, index: {}", self.data.len(), current @@ -48,7 +48,7 @@ impl HTMLDataCursor { match postcard::from_bytes(cursor) { Ok(x) => Some(x), Err(e) => { - log::error!("Error deserializing data: {:?}", e); + tracing::error!("Error deserializing data: {:?}", e); None } } diff --git a/packages/fullstack/src/layer.rs b/packages/fullstack/src/layer.rs index cf5633db2..10e67b3f5 100644 --- a/packages/fullstack/src/layer.rs +++ b/packages/fullstack/src/layer.rs @@ -1,4 +1,5 @@ use std::pin::Pin; +use tracing_futures::Instrument; use http::{Request, Response}; @@ -45,7 +46,11 @@ where > + Send, >, > { - let fut = self.call(req); + let fut = self.call(req).instrument(tracing::trace_span!( + "service", + "{}", + std::any::type_name::() + )); Box::pin(async move { fut.await.map_err(|err| err.into()) }) } } diff --git a/packages/fullstack/src/render.rs b/packages/fullstack/src/render.rs index d389fa54e..cda41f82c 100644 --- a/packages/fullstack/src/render.rs +++ b/packages/fullstack/src/render.rs @@ -50,10 +50,10 @@ impl SsrRendererPool { let prev_context = SERVER_CONTEXT.with(|ctx| ctx.replace(server_context)); // poll the future, which may call server_context() - log::info!("Rebuilding vdom"); + tracing::info!("Rebuilding vdom"); let _ = vdom.rebuild(); vdom.wait_for_suspense().await; - log::info!("Suspense resolved"); + tracing::info!("Suspense resolved"); // after polling the future, we need to restore the context SERVER_CONTEXT.with(|ctx| ctx.replace(prev_context)); @@ -116,10 +116,10 @@ impl SsrRendererPool { let prev_context = SERVER_CONTEXT .with(|ctx| ctx.replace(Box::new(server_context))); // poll the future, which may call server_context() - log::info!("Rebuilding vdom"); + tracing::info!("Rebuilding vdom"); let _ = vdom.rebuild(); vdom.wait_for_suspense().await; - log::info!("Suspense resolved"); + tracing::info!("Suspense resolved"); // after polling the future, we need to restore the context SERVER_CONTEXT.with(|ctx| ctx.replace(prev_context)); }) diff --git a/packages/fullstack/src/router.rs b/packages/fullstack/src/router.rs index eee282c01..b556aa000 100644 --- a/packages/fullstack/src/router.rs +++ b/packages/fullstack/src/router.rs @@ -29,7 +29,7 @@ where .to_string() .parse() .unwrap_or_else(|err| { - log::error!("Failed to parse uri: {}", err); + tracing::error!("Failed to parse uri: {}", err); "/" .parse() .unwrap_or_else(|err| { diff --git a/packages/hooks/Cargo.toml b/packages/hooks/Cargo.toml index caa25cb1e..bf07389ff 100644 --- a/packages/hooks/Cargo.toml +++ b/packages/hooks/Cargo.toml @@ -16,7 +16,7 @@ nightly-features = [] [dependencies] dioxus-core = { workspace = true } futures-channel = { workspace = true } -log = { workspace = true } +tracing = { workspace = true } thiserror = { workspace = true } slab = { workspace = true } dioxus-debug-cell = "0.1.1" diff --git a/packages/hooks/README.md b/packages/hooks/README.md index 6c77867de..932847b53 100644 --- a/packages/hooks/README.md +++ b/packages/hooks/README.md @@ -1,6 +1,5 @@ # Dioxus Hooks - [![Crates.io][crates-badge]][crates-url] [![MIT licensed][mit-badge]][mit-url] [![Build Status][actions-badge]][actions-url] @@ -8,22 +7,18 @@ [crates-badge]: https://img.shields.io/crates/v/dioxus-hooks.svg [crates-url]: https://crates.io/crates/dioxus-hooks - [mit-badge]: https://img.shields.io/badge/license-MIT-blue.svg [mit-url]: https://github.com/dioxuslabs/dioxus/blob/master/LICENSE - [actions-badge]: https://github.com/dioxuslabs/dioxus/actions/workflows/main.yml/badge.svg [actions-url]: https://github.com/dioxuslabs/dioxus/actions?query=workflow%3ACI+branch%3Amaster - [discord-badge]: https://img.shields.io/discord/899851952891002890.svg?logo=discord&style=flat-square [discord-url]: https://discord.gg/XgGxMSkvUM [Website](https://dioxuslabs.com) | -[Guides](https://dioxuslabs.com/docs/0.3/guide/en/) | +[Guides](https://dioxuslabs.com/learn/0.4/) | [API Docs](https://docs.rs/dioxus-hooks/latest/dioxus_hooks) | [Chat](https://discord.gg/XgGxMSkvUM) - ## Overview `dioxus-hooks` includes some basic useful hooks for dioxus: @@ -42,13 +37,13 @@ This crate also provides a few helpful macros to get around some Rust lifetime m - `use_future!()` - `use_callback!()` - ## Contributing - Report issues on our [issue tracker](https://github.com/dioxuslabs/dioxus/issues). - Join the discord and ask questions! ## License + This project is licensed under the [MIT license]. [mit license]: https://github.com/DioxusLabs/dioxus/blob/master/LICENSE-MIT diff --git a/packages/hooks/src/computed.rs b/packages/hooks/src/computed.rs index 1fcad8bb0..3369d6832 100644 --- a/packages/hooks/src/computed.rs +++ b/packages/hooks/src/computed.rs @@ -17,6 +17,7 @@ use std::{ /// ```rust /// use dioxus::prelude::*; /// +/// #[component] /// fn Parent(cx: Scope) -> Element { /// let count = use_tracked_state(cx, || 0); /// @@ -27,7 +28,7 @@ use std::{ /// } /// } /// -/// #[inline_props] +/// #[component] /// fn Child(cx: Scope, count: Tracked) -> Element { /// let less_than_five = use_selector(cx, count, |count| *count < 5); /// diff --git a/packages/hooks/src/use_shared_state.rs b/packages/hooks/src/use_shared_state.rs index b900b9dc6..18ce1e5f1 100644 --- a/packages/hooks/src/use_shared_state.rs +++ b/packages/hooks/src/use_shared_state.rs @@ -81,10 +81,12 @@ pub(crate) struct ProvidedStateInner { value: T, notify_any: Arc, consumers: HashSet, + gen: usize, } impl ProvidedStateInner { pub(crate) fn notify_consumers(&mut self) { + self.gen += 1; for consumer in self.consumers.iter() { (self.notify_any)(*consumer); } @@ -157,7 +159,7 @@ impl ProvidedStateInner { /// /// Right now, there is not a distinction between read-only and write-only, so every consumer will be notified. pub fn use_shared_state(cx: &ScopeState) -> Option<&UseSharedState> { - let state: &Option> = &*cx.use_hook(move || { + let state_owner: &mut Option> = &mut *cx.use_hook(move || { let scope_id = cx.scope_id(); let root = cx.consume_context::>()?; @@ -167,7 +169,10 @@ pub fn use_shared_state(cx: &ScopeState) -> Option<&UseSharedState Drop for UseSharedStateOwner { /// State that is shared between components through the context system pub struct UseSharedState { pub(crate) inner: Rc>>, + gen: usize, } impl UseSharedState { fn new(inner: Rc>>) -> Self { - Self { inner } + let gen = inner.borrow().gen; + Self { inner, gen } } /// Notify all consumers of the state that it has changed. (This is called automatically when you call "write") @@ -302,15 +309,14 @@ impl Clone for UseSharedState { fn clone(&self) -> Self { Self { inner: self.inner.clone(), + gen: self.gen, } } } -impl PartialEq for UseSharedState { +impl PartialEq for UseSharedState { fn eq(&self, other: &Self) -> bool { - let first = self.inner.borrow(); - let second = other.inner.borrow(); - first.value == second.value + self.gen == other.gen } } @@ -360,6 +366,7 @@ pub fn use_shared_state_provider(cx: &ScopeState, f: impl FnOnce() - value: f(), notify_any: cx.schedule_update_any(), consumers: HashSet::new(), + gen: 0, })); cx.provide_context(state); diff --git a/packages/hooks/src/useeffect.rs b/packages/hooks/src/useeffect.rs index aec1f9c9a..76a3f5245 100644 --- a/packages/hooks/src/useeffect.rs +++ b/packages/hooks/src/useeffect.rs @@ -14,7 +14,8 @@ use crate::UseFutureDep; /// ## Examples /// /// ```rust, no_run -/// #[inline_props] +/// # use dioxus::prelude::*; +/// #[component] /// fn Profile(cx: Scope, id: usize) -> Element { /// let name = use_state(cx, || None); /// @@ -34,7 +35,8 @@ use crate::UseFutureDep; /// ) /// } /// -/// fn app(cx: Scope) -> Element { +/// #[component] +/// fn App(cx: Scope) -> Element { /// render!(Profile { id: 0 }) /// } /// ``` diff --git a/packages/hooks/src/usefuture.rs b/packages/hooks/src/usefuture.rs index 6692e2d3b..67bcdc74e 100644 --- a/packages/hooks/src/usefuture.rs +++ b/packages/hooks/src/usefuture.rs @@ -14,7 +14,7 @@ use crate::{use_state, UseState}; /// /// Whenever the hooks dependencies change, the future will be re-evaluated. /// If a future is pending when the dependencies change, the previous future -/// will be allowed to continue +/// will be canceled before the new one is started. /// /// - dependencies: a tuple of references to values that are PartialEq + Clone pub fn use_future( diff --git a/packages/hooks/src/usememo.rs b/packages/hooks/src/usememo.rs index d3d991ccc..3181d57b8 100644 --- a/packages/hooks/src/usememo.rs +++ b/packages/hooks/src/usememo.rs @@ -10,8 +10,9 @@ use crate::UseFutureDep; /// ## Examples /// /// ```rust, no_run +/// # use dioxus::prelude::*; /// -/// #[inline_props] +/// #[component] /// fn Calculator(cx: Scope, number: usize) -> Element { /// let bigger_number = use_memo(cx, (number,), |(number,)| { /// // This will only be calculated when `number` has changed. @@ -21,7 +22,9 @@ use crate::UseFutureDep; /// p { "{bigger_number}" } /// ) /// } -/// fn app(cx: Scope) -> Element { +/// +/// #[component] +/// fn App(cx: Scope) -> Element { /// render!(Calculator { number: 0 }) /// } /// ``` diff --git a/packages/hot-reload/Cargo.toml b/packages/hot-reload/Cargo.toml index 38eecc8bd..b724ad685 100644 --- a/packages/hot-reload/Cargo.toml +++ b/packages/hot-reload/Cargo.toml @@ -5,7 +5,7 @@ version = { workspace = true } edition = "2021" license = "MIT OR Apache-2.0" repository = "https://github.com/DioxusLabs/dioxus/" -homepage = "https://dioxuslabs.com/docs/0.3/guide/en/getting_started/hot_reload.html" +homepage = "https://dioxuslabs.com/learn/0.4/migration/hot_reload" description = "Hot reloading utilities for Dioxus" keywords = ["dom", "ui", "gui", "react", "hot-reloading"] diff --git a/packages/hot-reload/README.md b/packages/hot-reload/README.md index 60b7b9c87..d7418d4b1 100644 --- a/packages/hot-reload/README.md +++ b/packages/hot-reload/README.md @@ -1,6 +1,5 @@ # `dioxus-hot-reload`: Hot Reloading Utilites for Dioxus - [![Crates.io][crates-badge]][crates-url] [![MIT licensed][mit-badge]][mit-url] [![Build Status][actions-badge]][actions-url] @@ -8,28 +7,24 @@ [crates-badge]: https://img.shields.io/crates/v/dioxus-hot-reload.svg [crates-url]: https://crates.io/crates/dioxus-hot-reload - [mit-badge]: https://img.shields.io/badge/license-MIT-blue.svg [mit-url]: https://github.com/dioxuslabs/dioxus/blob/master/LICENSE - [actions-badge]: https://github.com/dioxuslabs/dioxus/actions/workflows/main.yml/badge.svg [actions-url]: https://github.com/dioxuslabs/dioxus/actions?query=workflow%3ACI+branch%3Amaster - [discord-badge]: https://img.shields.io/discord/899851952891002890.svg?logo=discord&style=flat-square [discord-url]: https://discord.gg/XgGxMSkvUM [Website](https://dioxuslabs.com) | -[Guides](https://dioxuslabs.com/docs/0.3/guide/en) | +[Guides](https://dioxuslabs.com/learn/0.4/) | [API Docs](https://docs.rs/dioxus-hot-reload/latest/dioxus_hot_reload) | [Chat](https://discord.gg/XgGxMSkvUM) - ## Overview Dioxus supports hot reloading for static parts of rsx macros. This enables changing the styling of your application without recompiling the rust code. This is useful for rapid iteration on the styling of your application. - Hot reloading could update the following change without recompiling: + ```rust rsx! { div { @@ -37,7 +32,9 @@ rsx! { } } ``` + => + ```rust rsx! { div { @@ -49,6 +46,7 @@ rsx! { ``` But it could not update the following change: + ```rust rsx! { div { @@ -56,7 +54,9 @@ rsx! { } } ``` + => + ```rust rsx! { div { @@ -161,6 +161,7 @@ async fn launch(app: Component) { - Join the discord and ask questions! ## License + This project is licensed under the [MIT license]. [mit license]: https://github.com/DioxusLabs/dioxus/blob/master/LICENSE-MIT diff --git a/packages/html/README.md b/packages/html/README.md index 59ec2f9ff..93733116c 100644 --- a/packages/html/README.md +++ b/packages/html/README.md @@ -1,6 +1,5 @@ # `dioxus-html`: Html (and SVG) Namespace for Dioxus - [![Crates.io][crates-badge]][crates-url] [![MIT licensed][mit-badge]][mit-url] [![Build Status][actions-badge]][actions-url] @@ -8,22 +7,18 @@ [crates-badge]: https://img.shields.io/crates/v/dioxus-html.svg [crates-url]: https://crates.io/crates/dioxus-html - [mit-badge]: https://img.shields.io/badge/license-MIT-blue.svg [mit-url]: https://github.com/dioxuslabs/dioxus/blob/master/LICENSE - [actions-badge]: https://github.com/dioxuslabs/dioxus/actions/workflows/main.yml/badge.svg [actions-url]: https://github.com/dioxuslabs/dioxus/actions?query=workflow%3ACI+branch%3Amaster - [discord-badge]: https://img.shields.io/discord/899851952891002890.svg?logo=discord&style=flat-square [discord-url]: https://discord.gg/XgGxMSkvUM [Website](https://dioxuslabs.com) | -[Guides](https://dioxuslabs.com/docs/0.3/guide/en/) | +[Guides](https://dioxuslabs.com/learn/0.4/) | [API Docs](https://docs.rs/dioxus-html/latest/dioxus_html) | [Chat](https://discord.gg/XgGxMSkvUM) - ## Overview The Dioxus `rsx!` and `html!` macros can accept any compile-time correct namespace on top of NodeFactory. This crate provides the HTML (and SVG) namespaces which get imported in the Dioxus prelude. @@ -64,6 +59,7 @@ All elements should be defined as a zero-sized-struct (also known as unit struct Attributes would then be implemented as constants on these unit structs. The HTML namespace is defined mostly with macros. However, the expanded form would look something like this: + ```rust struct base; impl DioxusElement for base { @@ -75,8 +71,8 @@ impl base { const target: (&'static str, Option<'static str>, bool) = ("target", None, false); } ``` -Because attributes are defined as methods on the unit struct, they guard the attribute creation behind a compile-time correct interface. +Because attributes are defined as methods on the unit struct, they guard the attribute creation behind a compile-time correct interface. ## How to extend it: @@ -93,16 +89,13 @@ mod dioxus_elements { } ``` - - - - ## Contributing - Report issues on our [issue tracker](https://github.com/dioxuslabs/dioxus/issues). - Join the discord and ask questions! ## License + This project is licensed under the [MIT license]. [mit license]: https://github.com/DioxusLabs/dioxus/blob/master/LICENSE-MIT diff --git a/packages/html/src/elements.rs b/packages/html/src/elements.rs index 7e5bed124..7800369a9 100644 --- a/packages/html/src/elements.rs +++ b/packages/html/src/elements.rs @@ -1258,6 +1258,8 @@ builder_constructors! { spellcheck: BoolOrDefault DEFAULT, wrap: Wrap DEFAULT, value: String volatile, + + initial_value: String DEFAULT, }; diff --git a/packages/html/src/events/mouse.rs b/packages/html/src/events/mouse.rs index 7899393ff..55d081900 100644 --- a/packages/html/src/events/mouse.rs +++ b/packages/html/src/events/mouse.rs @@ -108,7 +108,7 @@ impl_event! { /// /// ## Example /// ```rust, ignore - /// rsx!( button { "click me", onclick: move |_| log::info!("Clicked!`") } ) + /// rsx!( button { "click me", onclick: move |_| tracing::info!("Clicked!`") } ) /// ``` /// /// ## Reference diff --git a/packages/interpreter/README.md b/packages/interpreter/README.md index 90e390f56..0c195d681 100644 --- a/packages/interpreter/README.md +++ b/packages/interpreter/README.md @@ -1,6 +1,5 @@ # `dioxus-interpreter-js` - [![Crates.io][crates-badge]][crates-url] [![MIT licensed][mit-badge]][mit-url] [![Build Status][actions-badge]][actions-url] @@ -8,35 +7,31 @@ [crates-badge]: https://img.shields.io/crates/v/dioxus-interpreter-js.svg [crates-url]: https://crates.io/crates/dioxus-interpreter-js - [mit-badge]: https://img.shields.io/badge/license-MIT-blue.svg [mit-url]: https://github.com/dioxuslabs/dioxus/blob/master/LICENSE - [actions-badge]: https://github.com/dioxuslabs/dioxus/actions/workflows/main.yml/badge.svg [actions-url]: https://github.com/dioxuslabs/dioxus/actions?query=workflow%3ACI+branch%3Amaster - [discord-badge]: https://img.shields.io/discord/899851952891002890.svg?logo=discord&style=flat-square [discord-url]: https://discord.gg/XgGxMSkvUM [Website](https://dioxuslabs.com) | -[Guides](https://dioxuslabs.com/docs/0.3/guide/en/) | +[Guides](https://dioxuslabs.com/learn/0.4/) | [API Docs](https://docs.rs/dioxus-interpreter-js/latest/dioxus_interpreter_js) | [Chat](https://discord.gg/XgGxMSkvUM) - ## Overview `dioxus-interpreter-js` provides the high-performance JavaScript glue that interprets the stream of edits produced by the Dioxus VirtualDom and converts them into mutations on the actual web DOM. This crate features bindings for the web and sledgehammer for increased performance. - ## Contributing - Report issues on our [issue tracker](https://github.com/dioxuslabs/dioxus/issues). - Join the discord and ask questions! ## License + This project is licensed under the [MIT license]. [mit license]: https://github.com/DioxusLabs/dioxus/blob/master/LICENSE-MIT diff --git a/packages/interpreter/src/interpreter.js b/packages/interpreter/src/interpreter.js index 0a041df27..a03983ffa 100644 --- a/packages/interpreter/src/interpreter.js +++ b/packages/interpreter/src/interpreter.js @@ -390,7 +390,11 @@ class Interpreter { function handler(event, name, bubbles, config) { let target = event.target; if (target != null) { - let preventDefaultRequests = target.getAttribute(`dioxus-prevent-default`); + let preventDefaultRequests = null; + // Some events can be triggered on text nodes, which don't have attributes + if (target instanceof Element) { + preventDefaultRequests = target.getAttribute(`dioxus-prevent-default`); + } if (event.type === "click") { // todo call prevent default if it's the right type of event @@ -446,15 +450,24 @@ function handler(event, name, bubbles, config) { target.tagName === "FORM" && (event.type === "submit" || event.type === "input") ) { - if ( - target.tagName === "FORM" && - (event.type === "submit" || event.type === "input") - ) { - const formData = new FormData(target); + const formData = new FormData(target); - for (let name of formData.keys()) { - let value = formData.getAll(name); - contents.values[name] = value; + for (let name of formData.keys()) { + let value = formData.getAll(name); + contents.values[name] = value; + } + } + + if ( + target.tagName === "SELECT" && + event.type === "input" + ) { + const selectData = target.options; + contents.values["options"] = []; + for (let i = 0; i < selectData.length; i++) { + let option = selectData[i]; + if (option.selected) { + contents.values["options"].push(option.value.toString()); } } } @@ -474,7 +487,10 @@ function handler(event, name, bubbles, config) { } function find_real_id(target) { - let realId = target.getAttribute(`data-dioxus-id`); + let realId = null; + if (target instanceof Element) { + realId = target.getAttribute(`data-dioxus-id`); + } // walk the tree to find the real element while (realId == null) { // we've reached the root we don't want to send an event @@ -483,7 +499,9 @@ function find_real_id(target) { } target = target.parentElement; - realId = target.getAttribute(`data-dioxus-id`); + if (target instanceof Element) { + realId = target.getAttribute(`data-dioxus-id`); + } } return realId; } diff --git a/packages/liveview/Cargo.toml b/packages/liveview/Cargo.toml index 3dfce5bf4..cbd7b75f5 100644 --- a/packages/liveview/Cargo.toml +++ b/packages/liveview/Cargo.toml @@ -3,7 +3,7 @@ name = "dioxus-liveview" version = { workspace = true } edition = "2021" repository = "https://github.com/DioxusLabs/dioxus/" -homepage = "https://dioxuslabs.com/docs/0.3/guide/en/getting_started/liveview.html" +homepage = "https://dioxuslabs.com/learn/0.4/getting_started/liveview" keywords = ["dom", "ui", "gui", "react", "liveview"] description = "Build server-side apps with Dioxus" authors = ["Jonathan Kelley", "Evan Almloff"] @@ -11,7 +11,7 @@ license = "MIT OR Apache-2.0" [dependencies] thiserror = { workspace = true } -log = { workspace = true } +tracing = { workspace = true } slab = { workspace = true } futures-util = { workspace = true, default-features = false, features = [ "sink", diff --git a/packages/liveview/README.md b/packages/liveview/README.md index 0a0e7de3a..cbae3c53a 100644 --- a/packages/liveview/README.md +++ b/packages/liveview/README.md @@ -1,6 +1,5 @@ # Dioxus Liveview - [![Crates.io][crates-badge]][crates-url] [![MIT licensed][mit-badge]][mit-url] [![Build Status][actions-badge]][actions-url] @@ -8,22 +7,18 @@ [crates-badge]: https://img.shields.io/crates/v/dioxus-liveview.svg [crates-url]: https://crates.io/crates/dioxus-liveview - [mit-badge]: https://img.shields.io/badge/license-MIT-blue.svg [mit-url]: https://github.com/dioxuslabs/dioxus/blob/master/LICENSE - [actions-badge]: https://github.com/dioxuslabs/dioxus/actions/workflows/main.yml/badge.svg [actions-url]: https://github.com/dioxuslabs/dioxus/actions?query=workflow%3ACI+branch%3Amaster - [discord-badge]: https://img.shields.io/discord/899851952891002890.svg?logo=discord&style=flat-square [discord-url]: https://discord.gg/XgGxMSkvUM [Website](https://dioxuslabs.com) | -[Guides](https://dioxuslabs.com/docs/0.3/guide/en/) | +[Guides](https://dioxuslabs.com/learn/0.4/) | [API Docs](https://docs.rs/dioxus-liveview/latest/dioxus_liveview) | [Chat](https://discord.gg/XgGxMSkvUM) - ## Overview `dioxus-liveview` provides adapters for running the Dioxus VirtualDom over a WebSocket connection. @@ -46,6 +41,7 @@ Dioxus-LiveView exports some primitives to wire up an app into an existing backe - Join the discord and ask questions! ## License + This project is licensed under the [MIT license]. [mit license]: https://github.com/DioxusLabs/dioxus/blob/master/LICENSE-MIT diff --git a/packages/liveview/src/query.rs b/packages/liveview/src/query.rs index 8052c2afa..a638625c1 100644 --- a/packages/liveview/src/query.rs +++ b/packages/liveview/src/query.rs @@ -126,7 +126,7 @@ impl QueryEngine { }}) }})();"# )) { - log::warn!("Query error: {err}"); + tracing::warn!("Query error: {err}"); } Query { diff --git a/packages/mobile/Cargo.toml b/packages/mobile/Cargo.toml index 9c6d51270..c0d84c8d4 100644 --- a/packages/mobile/Cargo.toml +++ b/packages/mobile/Cargo.toml @@ -5,7 +5,7 @@ authors = ["Jonathan Kelley"] edition = "2018" description = "Mobile-compatible renderer for Dioxus" repository = "https://github.com/DioxusLabs/dioxus/" -homepage = "https://dioxuslabs.com/docs/0.3/guide/en/getting_started/mobile.html" +homepage = "https://dioxuslabs.com/learn/0.4/getting_started/mobile" keywords = ["dom", "ui", "gui", "react"] license = "MIT OR Apache-2.0" diff --git a/packages/mobile/README.md b/packages/mobile/README.md index 46da9061a..611348da5 100644 --- a/packages/mobile/README.md +++ b/packages/mobile/README.md @@ -7,29 +7,24 @@ [crates-badge]: https://img.shields.io/crates/v/dioxus-mobile.svg [crates-url]: https://crates.io/crates/dioxus-mobile - [mit-badge]: https://img.shields.io/badge/license-MIT-blue.svg [mit-url]: https://github.com/dioxuslabs/dioxus/blob/master/LICENSE - [actions-badge]: https://github.com/dioxuslabs/dioxus/actions/workflows/main.yml/badge.svg [actions-url]: https://github.com/dioxuslabs/dioxus/actions?query=workflow%3ACI+branch%3Amaster - [discord-badge]: https://img.shields.io/discord/899851952891002890.svg?logo=discord&style=flat-square [discord-url]: https://discord.gg/XgGxMSkvUM [Website](https://dioxuslabs.com) | -[Guides](https://dioxuslabs.com/docs/0.3/guide/en/) | +[Guides](https://dioxuslabs.com/learn/0.4/) | [API Docs](https://docs.rs/dioxus-mobile/latest/dioxus_mobile) | [Chat](https://discord.gg/XgGxMSkvUM) - ## Overview `dioxus-mobile` is a re-export of `dioxus-desktop` with some minor tweaks and documentation changes. As this crate evolves, it will provide some more unique features to mobile, but for now, it's very similar to the desktop crate. Dioxus Mobile supports both iOS and Android. However, Android support is still quite experimental and requires a lot of configuration. A good area to contribute here would be to improve the CLI tool to include bundling and mobile configuration. - ## Getting Set up Getting set up with mobile can but quite challenging. The tooling here isn't great (yet) and might take some hacking around to get things working. macOS M1 is broadly unexplored and might not work for you. @@ -40,7 +35,6 @@ We're going to be using `cargo-mobile` to build for mobile. First, install it: $ cargo install --git https://github.com/BrainiumLLC/cargo-mobile ``` - And then initialize your app for the right platform. Use the `winit` template for now. Right now, there's no "Dioxus" template in cargo-mobile. ```shell @@ -98,9 +92,7 @@ To configure the web view, menubar, and other important desktop-specific feature ## Future Steps -Make sure to read the [Dioxus Guide](https://dioxuslabs.com/docs/0.3/guide/en) if you already haven't! - - +Make sure to read the [Dioxus Guide](https://dioxuslabs.com/learn/0.4/) if you already haven't! ## Contributing @@ -108,6 +100,7 @@ Make sure to read the [Dioxus Guide](https://dioxuslabs.com/docs/0.3/guide/en) i - Join the discord and ask questions! ## License + This project is licensed under the [MIT license]. [mit license]: https://github.com/DioxusLabs/dioxus/blob/master/LICENSE-MIT diff --git a/packages/native-core-macro/README.md b/packages/native-core-macro/README.md index 6b8c13590..4cf19cece 100644 --- a/packages/native-core-macro/README.md +++ b/packages/native-core-macro/README.md @@ -7,33 +7,29 @@ [crates-badge]: https://img.shields.io/crates/v/dioxus-native-core-macro.svg [crates-url]: https://crates.io/crates/dioxus-native-core-macro - [mit-badge]: https://img.shields.io/badge/license-MIT-blue.svg [mit-url]: https://github.com/dioxuslabs/dioxus/blob/master/LICENSE - [actions-badge]: https://github.com/dioxuslabs/dioxus/actions/workflows/main.yml/badge.svg [actions-url]: https://github.com/dioxuslabs/dioxus/actions?query=workflow%3ACI+branch%3Amaster - [discord-badge]: https://img.shields.io/discord/899851952891002890.svg?logo=discord&style=flat-square [discord-url]: https://discord.gg/XgGxMSkvUM [Website](https://dioxuslabs.com) | -[Guides](https://dioxuslabs.com/docs/0.3/guide/en/) | +[Guides](https://dioxuslabs.com/learn/0.4/) | [API Docs](https://docs.rs/dioxus-native-core-macro/latest/dioxus_native_core_macro) | [Chat](https://discord.gg/XgGxMSkvUM) - ## Overview `dioxus-native-core-macro` provides a handful of macros used by native-core for native renderers like TUI, Blitz, and Freya to derive their state. - ## Contributing - Report issues on our [issue tracker](https://github.com/dioxuslabs/dioxus/issues). - Join the discord and ask questions! ## License + This project is licensed under the [MIT license]. [mit license]: https://github.com/DioxusLabs/dioxus/blob/master/LICENSE-MIT diff --git a/packages/router-macro/src/lib.rs b/packages/router-macro/src/lib.rs index c949cf2f4..b1ff7b0fe 100644 --- a/packages/router-macro/src/lib.rs +++ b/packages/router-macro/src/lib.rs @@ -210,7 +210,7 @@ pub fn routable(input: TokenStream) -> TokenStream { let display_impl = route_enum.impl_display(); let routable_impl = route_enum.routable_impl(); - quote! { + (quote! { #error_type #display_impl @@ -218,7 +218,7 @@ pub fn routable(input: TokenStream) -> TokenStream { #routable_impl #parse_impl - } + }) .into() } @@ -482,7 +482,8 @@ impl RouteEnum { let route = s; let (route, _hash) = route.split_once('#').unwrap_or((route, "")); let (route, query) = route.split_once('?').unwrap_or((route, "")); - let mut segments = route.split('/'); + let query = dioxus_router::exports::urlencoding::decode(query).unwrap_or(query.into()); + let mut segments = route.split('/').map(|s| dioxus_router::exports::urlencoding::decode(s).unwrap_or(s.into())); // skip the first empty segment if s.starts_with('/') { let _ = segments.next(); @@ -677,9 +678,9 @@ impl ToTokens for SegmentType { impl<'a> From<&'a RouteSegment> for SegmentType { fn from(value: &'a RouteSegment) -> Self { match value { - segment::RouteSegment::Static(s) => SegmentType::Static(s.to_string()), - segment::RouteSegment::Dynamic(s, _) => SegmentType::Dynamic(s.to_string()), - segment::RouteSegment::CatchAll(s, _) => SegmentType::CatchAll(s.to_string()), + RouteSegment::Static(s) => SegmentType::Static(s.to_string()), + RouteSegment::Dynamic(s, _) => SegmentType::Dynamic(s.to_string()), + RouteSegment::CatchAll(s, _) => SegmentType::CatchAll(s.to_string()), } } } diff --git a/packages/router-macro/src/query.rs b/packages/router-macro/src/query.rs index 8b9db9e51..c97d3be29 100644 --- a/packages/router-macro/src/query.rs +++ b/packages/router-macro/src/query.rs @@ -14,7 +14,7 @@ impl QuerySegment { let ident = &self.ident; let ty = &self.ty; quote! { - let #ident = <#ty as dioxus_router::routable::FromQuery>::from_query(query); + let #ident = <#ty as dioxus_router::routable::FromQuery>::from_query(&*query); } } diff --git a/packages/router-macro/src/route.rs b/packages/router-macro/src/route.rs index b070c2013..26665e575 100644 --- a/packages/router-macro/src/route.rs +++ b/packages/router-macro/src/route.rs @@ -277,10 +277,8 @@ impl Route { } } for segment in &self.segments { - if let RouteSegment::Dynamic(other, ..) = segment { - if other == name { - from_route = true - } + if segment.name().as_ref() == Some(name) { + from_route = true } } if let Some(query) = &self.query { diff --git a/packages/router-macro/src/route_tree.rs b/packages/router-macro/src/route_tree.rs index 399d20e5e..6b89c80ab 100644 --- a/packages/router-macro/src/route_tree.rs +++ b/packages/router-macro/src/route_tree.rs @@ -312,7 +312,8 @@ impl<'a> RouteTreeSegmentData<'a> { quote! { { let mut segments = segments.clone(); - if let Some(segment) = segments.next() { + let segment = segments.next(); + if let Some(segment) = segment.as_deref() { if #segment == segment { #(#children)* } @@ -369,7 +370,7 @@ impl<'a> RouteTreeSegmentData<'a> { quote! { let mut trailing = String::from("/"); for seg in segments.clone() { - trailing += seg; + trailing += &*seg; trailing += "/"; } trailing.pop(); @@ -506,7 +507,9 @@ fn return_constructed( let remaining_segments = segments.clone(); let mut segments_clone = segments.clone(); let next_segment = segments_clone.next(); + let next_segment = next_segment.as_deref(); let segment_after_next = segments_clone.next(); + let segment_after_next = segment_after_next.as_deref(); match (next_segment, segment_after_next) { // This is the last segment, return the parsed route (None, _) | (Some(""), None) => { @@ -516,7 +519,7 @@ fn return_constructed( _ => { let mut trailing = String::new(); for seg in remaining_segments { - trailing += seg; + trailing += &*seg; trailing += "/"; } trailing.pop(); diff --git a/packages/router-macro/src/segment.rs b/packages/router-macro/src/segment.rs index 62dea59a7..7e4e40662 100644 --- a/packages/router-macro/src/segment.rs +++ b/packages/router-macro/src/segment.rs @@ -25,7 +25,7 @@ impl RouteSegment { match self { Self::Static(segment) => quote! { write!(f, "/{}", #segment)?; }, Self::Dynamic(ident, _) => quote! { write!(f, "/{}", #ident)?; }, - Self::CatchAll(ident, _) => quote! { #ident.display_route_segements(f)?; }, + Self::CatchAll(ident, _) => quote! { #ident.display_route_segments(f)?; }, } } @@ -59,6 +59,7 @@ impl RouteSegment { { let mut segments = segments.clone(); let segment = segments.next(); + let segment = segment.as_deref(); let parsed = if let Some(#segment) = segment { Ok(()) } else { @@ -80,7 +81,8 @@ impl RouteSegment { quote! { { let mut segments = segments.clone(); - let parsed = if let Some(segment) = segments.next() { + let segment = segments.next(); + let parsed = if let Some(segment) = segment.as_deref() { <#ty as dioxus_router::routable::FromRouteSegment>::from_route_segment(segment).map_err(|err| #error_enum_name::#error_enum_varient(#inner_parse_enum::#error_name(err))) } else { Err(#error_enum_name::#error_enum_varient(#inner_parse_enum::#missing_error_name)) @@ -100,9 +102,12 @@ impl RouteSegment { quote! { { let parsed = { - let mut segments = segments.clone(); - let segments: Vec<_> = segments.collect(); - <#ty as dioxus_router::routable::FromRouteSegments>::from_route_segments(&segments).map_err(|err| #error_enum_name::#error_enum_varient(#inner_parse_enum::#error_name(err))) + let remaining_segments: Vec<_> = segments.collect(); + let mut new_segments: Vec<&str> = Vec::new(); + for segment in &remaining_segments { + new_segments.push(&*segment); + } + <#ty as dioxus_router::routable::FromRouteSegments>::from_route_segments(&new_segments).map_err(|err| #error_enum_name::#error_enum_varient(#inner_parse_enum::#error_name(err))) }; match parsed { Ok(#name) => { diff --git a/packages/router/Cargo.toml b/packages/router/Cargo.toml index 46d7536b6..80923d539 100644 --- a/packages/router/Cargo.toml +++ b/packages/router/Cargo.toml @@ -14,10 +14,10 @@ anyhow = "1.0.66" dioxus = { workspace = true } dioxus-router-macro = { workspace = true } gloo = { version = "0.8.0", optional = true } -log = { workspace = true } +tracing = { workspace = true } thiserror = { workspace = true } futures-util = { workspace = true } -serde_urlencoded = { version = "0.7.1", optional = true } +urlencoding = "2.1.3" serde = { version = "1", features = ["derive"], optional = true } url = "2.3.1" wasm-bindgen = { workspace = true, optional = true } diff --git a/packages/router/README.md b/packages/router/README.md index db6cfdf4f..f83fa63cf 100644 --- a/packages/router/README.md +++ b/packages/router/README.md @@ -15,7 +15,7 @@ [discord-url]: https://discord.gg/XgGxMSkvUM [Website](https://dioxuslabs.com) | -[Guides](https://dioxuslabs.com/docs/0.3/router/) | +[Guides](https://dioxuslabs.com/learn/0.4/router/) | [API Docs](https://docs.rs/dioxus-router/latest/dioxus_router) | [Chat](https://discord.gg/XgGxMSkvUM) @@ -26,8 +26,6 @@ interface similar to React Router, but takes advantage of types for more expressiveness. ```rust, no_run -#![allow(non_snake_case)] - use dioxus::prelude::*; use dioxus_router::prelude::*; use std::str::FromStr; @@ -48,14 +46,14 @@ enum Route { Index {}, } - +#[component] fn App(cx: Scope) -> Element { render! { Router:: { } } } -#[inline_props] +#[component] fn Index(cx: Scope) -> Element { render! { h1 { "Index" } @@ -66,7 +64,7 @@ fn Index(cx: Scope) -> Element { } } -#[inline_props] +#[component] fn Blog(cx: Scope) -> Element { render! { h1 { "Blog" } @@ -74,7 +72,7 @@ fn Blog(cx: Scope) -> Element { } } -#[inline_props] +#[component] fn BlogList(cx: Scope) -> Element { render! { h2 { "List of blog posts" } @@ -89,7 +87,7 @@ fn BlogList(cx: Scope) -> Element { } } -#[inline_props] +#[component] fn BlogPost(cx: Scope, blog_id: usize) -> Element { render! { h2 { "Blog Post" } diff --git a/packages/router/benches/incremental.rs b/packages/router/benches/incremental.rs index 0c2697a80..2c4e9d548 100644 --- a/packages/router/benches/incremental.rs +++ b/packages/router/benches/incremental.rs @@ -1,4 +1,4 @@ -#![allow(unused, non_snake_case)] +#![allow(unused)] use std::time::Duration; @@ -134,7 +134,7 @@ pub fn criterion_benchmark(c: &mut Criterion) { criterion_group!(benches, criterion_benchmark); criterion_main!(benches); -#[inline_props] +#[component] fn Blog(cx: Scope) -> Element { render! { div { @@ -143,7 +143,7 @@ fn Blog(cx: Scope) -> Element { } } -#[inline_props] +#[component] fn Post(cx: Scope, id: usize) -> Element { render! { for _ in 0..*id { @@ -154,7 +154,7 @@ fn Post(cx: Scope, id: usize) -> Element { } } -#[inline_props] +#[component] fn PostHome(cx: Scope) -> Element { render! { div { @@ -163,7 +163,7 @@ fn PostHome(cx: Scope) -> Element { } } -#[inline_props] +#[component] fn Home(cx: Scope) -> Element { render! { div { @@ -189,7 +189,7 @@ enum Route { Home {}, } -#[inline_props] +#[component] fn RenderPath(cx: Scope, path: Route) -> Element { let path = path.clone(); render! { diff --git a/packages/router/examples/simple_routes.rs b/packages/router/examples/simple_routes.rs index 673658870..3634f7df3 100644 --- a/packages/router/examples/simple_routes.rs +++ b/packages/router/examples/simple_routes.rs @@ -1,24 +1,23 @@ -#![allow(non_snake_case)] - use dioxus::prelude::*; use dioxus_router::prelude::*; use std::str::FromStr; fn main() { #[cfg(not(target_arch = "wasm32"))] - dioxus_desktop::launch(root); + dioxus_desktop::launch(Root); #[cfg(target_arch = "wasm32")] dioxus_web::launch(root); } -fn root(cx: Scope) -> Element { +#[component] +fn Root(cx: Scope) -> Element { render! { Router:: {} } } -#[inline_props] +#[component] fn UserFrame(cx: Scope, user_id: usize) -> Element { render! { pre { @@ -32,7 +31,7 @@ fn UserFrame(cx: Scope, user_id: usize) -> Element { } } -#[inline_props] +#[component] fn Route1(cx: Scope, user_id: usize, dynamic: usize, query: String, extra: String) -> Element { render! { pre { @@ -50,7 +49,7 @@ fn Route1(cx: Scope, user_id: usize, dynamic: usize, query: String, extra: Strin } } -#[inline_props] +#[component] fn Route2(cx: Scope, user_id: usize) -> Element { render! { pre { @@ -65,7 +64,7 @@ fn Route2(cx: Scope, user_id: usize) -> Element { } } -#[inline_props] +#[component] fn Route3(cx: Scope, dynamic: String) -> Element { let navigator = use_navigator(cx); let current_route = use_route(cx)?; diff --git a/packages/router/examples/static_generation.rs b/packages/router/examples/static_generation.rs index 19e7c7341..e3b6db19f 100644 --- a/packages/router/examples/static_generation.rs +++ b/packages/router/examples/static_generation.rs @@ -1,5 +1,3 @@ -#![allow(non_snake_case)] - use std::time::Duration; use dioxus::prelude::*; @@ -54,7 +52,7 @@ async fn main() { .unwrap(); } -#[inline_props] +#[component] fn Blog(cx: Scope) -> Element { render! { div { @@ -63,7 +61,7 @@ fn Blog(cx: Scope) -> Element { } } -#[inline_props] +#[component] fn Post(cx: Scope, id: usize) -> Element { render! { div { @@ -72,7 +70,7 @@ fn Post(cx: Scope, id: usize) -> Element { } } -#[inline_props] +#[component] fn PostHome(cx: Scope) -> Element { render! { div { @@ -81,7 +79,7 @@ fn PostHome(cx: Scope) -> Element { } } -#[inline_props] +#[component] fn Home(cx: Scope) -> Element { render! { div { diff --git a/packages/router/src/components/history_buttons.rs b/packages/router/src/components/history_buttons.rs index 6bd23d860..eb62e9285 100644 --- a/packages/router/src/components/history_buttons.rs +++ b/packages/router/src/components/history_buttons.rs @@ -1,5 +1,5 @@ use dioxus::prelude::*; -use log::error; +use tracing::error; use crate::utils::use_router_internal::use_router_internal; @@ -30,13 +30,14 @@ pub struct HistoryButtonProps<'a> { /// Index {}, /// } /// +/// #[component] /// fn App(cx: Scope) -> Element { /// render! { /// Router:: {} /// } /// } /// -/// #[inline_props] +/// #[component] /// fn Index(cx: Scope) -> Element { /// render! { /// GoBackButton { @@ -52,7 +53,7 @@ pub struct HistoryButtonProps<'a> { /// # r#""# /// # ); /// ``` -#[allow(non_snake_case)] +#[component] pub fn GoBackButton<'a>(cx: Scope<'a, HistoryButtonProps<'a>>) -> Element { let HistoryButtonProps { children } = cx.props; @@ -101,13 +102,14 @@ pub fn GoBackButton<'a>(cx: Scope<'a, HistoryButtonProps<'a>>) -> Element { /// Index {}, /// } /// +/// #[component] /// fn App(cx: Scope) -> Element { /// render! { /// Router:: {} /// } /// } /// -/// #[inline_props] +/// #[component] /// fn Index(cx: Scope) -> Element { /// render! { /// GoForwardButton { @@ -123,7 +125,7 @@ pub fn GoBackButton<'a>(cx: Scope<'a, HistoryButtonProps<'a>>) -> Element { /// # r#""# /// # ); /// ``` -#[allow(non_snake_case)] +#[component] pub fn GoForwardButton<'a>(cx: Scope<'a, HistoryButtonProps<'a>>) -> Element { let HistoryButtonProps { children } = cx.props; diff --git a/packages/router/src/components/link.rs b/packages/router/src/components/link.rs index bc55fec8c..787f9cdc9 100644 --- a/packages/router/src/components/link.rs +++ b/packages/router/src/components/link.rs @@ -1,9 +1,11 @@ +#![allow(clippy::type_complexity)] + use std::any::Any; use std::fmt::Debug; use std::rc::Rc; use dioxus::prelude::*; -use log::error; +use tracing::error; use crate::navigation::NavigationTarget; use crate::prelude::Routable; @@ -133,13 +135,14 @@ impl Debug for LinkProps<'_> { /// Index {}, /// } /// +/// #[component] /// fn App(cx: Scope) -> Element { /// render! { /// Router:: {} /// } /// } /// -/// #[inline_props] +/// #[component] /// fn Index(cx: Scope) -> Element { /// render! { /// render! { diff --git a/packages/router/src/components/outlet.rs b/packages/router/src/components/outlet.rs index 133a23543..663f54e64 100644 --- a/packages/router/src/components/outlet.rs +++ b/packages/router/src/components/outlet.rs @@ -29,7 +29,7 @@ use dioxus::prelude::*; /// Index {}, /// } /// -/// #[inline_props] +/// #[component] /// fn Index(cx: Scope) -> Element { /// render! { /// div { @@ -38,7 +38,7 @@ use dioxus::prelude::*; /// } /// } /// -/// #[inline_props] +/// #[component] /// fn Wrapper(cx: Scope) -> Element { /// render! { /// h1 { "App" } @@ -46,7 +46,7 @@ use dioxus::prelude::*; /// } /// } /// -/// #[inline_props] +/// #[component] /// fn Child(cx: Scope) -> Element { /// render! { /// p { @@ -55,6 +55,7 @@ use dioxus::prelude::*; /// } /// } /// +/// # #[component] /// # fn App(cx: Scope) -> Element { /// # render! { /// # Router:: { diff --git a/packages/router/src/history/memory.rs b/packages/router/src/history/memory.rs index ba511bb97..373920be2 100644 --- a/packages/router/src/history/memory.rs +++ b/packages/router/src/history/memory.rs @@ -20,9 +20,9 @@ where /// ```rust /// # use dioxus_router::prelude::*; /// # use dioxus::prelude::*; - /// # #[inline_props] + /// # #[component] /// # fn Index(cx: Scope) -> Element { todo!() } - /// # #[inline_props] + /// # #[component] /// # fn OtherPage(cx: Scope) -> Element { todo!() } /// #[derive(Clone, Routable, Debug, PartialEq)] /// enum Route { diff --git a/packages/router/src/history/mod.rs b/packages/router/src/history/mod.rs index fda386075..e9668b979 100644 --- a/packages/router/src/history/mod.rs +++ b/packages/router/src/history/mod.rs @@ -48,9 +48,9 @@ pub trait HistoryProvider { /// ```rust /// # use dioxus_router::prelude::*; /// # use dioxus::prelude::*; - /// # #[inline_props] + /// # #[component] /// # fn Index(cx: Scope) -> Element { todo!() } - /// # #[inline_props] + /// # #[component] /// # fn OtherPage(cx: Scope) -> Element { todo!() } /// #[derive(Clone, Routable, Debug, PartialEq)] /// enum Route { @@ -86,17 +86,20 @@ pub trait HistoryProvider { /// ```rust /// # use dioxus_router::prelude::*; /// # use dioxus::prelude::*; - /// # #[inline_props] + /// # #[component] /// # fn Index(cx: Scope) -> Element { todo!() } + /// # fn Other(cx: Scope) -> Element { todo!() } /// #[derive(Clone, Routable, Debug, PartialEq)] /// enum Route { /// #[route("/")] /// Index {}, + /// #[route("/other")] + /// Other {}, /// } /// let mut history = MemoryHistory::::default(); /// assert_eq!(history.can_go_back(), false); /// - /// history.push(Route::Index {}); + /// history.push(Route::Other {}); /// assert_eq!(history.can_go_back(), true); /// ``` #[must_use] @@ -112,9 +115,9 @@ pub trait HistoryProvider { /// ```rust /// # use dioxus_router::prelude::*; /// # use dioxus::prelude::*; - /// # #[inline_props] + /// # #[component] /// # fn Index(cx: Scope) -> Element { todo!() } - /// # #[inline_props] + /// # #[component] /// # fn OtherPage(cx: Scope) -> Element { todo!() } /// #[derive(Clone, Routable, Debug, PartialEq)] /// enum Route { @@ -144,9 +147,9 @@ pub trait HistoryProvider { /// ```rust /// # use dioxus_router::prelude::*; /// # use dioxus::prelude::*; - /// # #[inline_props] + /// # #[component] /// # fn Index(cx: Scope) -> Element { todo!() } - /// # #[inline_props] + /// # #[component] /// # fn OtherPage(cx: Scope) -> Element { todo!() } /// #[derive(Clone, Routable, Debug, PartialEq)] /// enum Route { @@ -177,9 +180,9 @@ pub trait HistoryProvider { /// ```rust /// # use dioxus_router::prelude::*; /// # use dioxus::prelude::*; - /// # #[inline_props] + /// # #[component] /// # fn Index(cx: Scope) -> Element { todo!() } - /// # #[inline_props] + /// # #[component] /// # fn OtherPage(cx: Scope) -> Element { todo!() } /// #[derive(Clone, Routable, Debug, PartialEq)] /// enum Route { @@ -210,9 +213,9 @@ pub trait HistoryProvider { /// ```rust /// # use dioxus_router::prelude::*; /// # use dioxus::prelude::*; - /// # #[inline_props] + /// # #[component] /// # fn Index(cx: Scope) -> Element { todo!() } - /// # #[inline_props] + /// # #[component] /// # fn OtherPage(cx: Scope) -> Element { todo!() } /// #[derive(Clone, Routable, Debug, PartialEq)] /// enum Route { @@ -239,9 +242,9 @@ pub trait HistoryProvider { /// ```rust /// # use dioxus_router::prelude::*; /// # use dioxus::prelude::*; - /// # #[inline_props] + /// # #[component] /// # fn Index(cx: Scope) -> Element { todo!() } - /// # #[inline_props] + /// # #[component] /// # fn OtherPage(cx: Scope) -> Element { todo!() } /// #[derive(Clone, Routable, Debug, PartialEq)] /// enum Route { diff --git a/packages/router/src/history/web.rs b/packages/router/src/history/web.rs index 8b6089b20..789eed76e 100644 --- a/packages/router/src/history/web.rs +++ b/packages/router/src/history/web.rs @@ -139,7 +139,7 @@ impl WebHistory { ); let current_route = myself.current_route(); - log::trace!("initial route: {:?}", current_route); + tracing::trace!("initial route: {:?}", current_route); let current_url = current_route.to_string(); let state = myself.create_state(current_route); let _ = replace_state_with_url(&myself.history, &state, Some(¤t_url)); @@ -195,14 +195,10 @@ where ::Err: std::fmt::Display, { fn route_from_location(&self) -> R { - R::from_str( - &self - .window - .location() - .pathname() - .unwrap_or_else(|_| String::from("/")), - ) - .unwrap_or_else(|err| panic!("{}", err)) + let location = self.window.location(); + let path = location.pathname().unwrap_or_else(|_| "/".into()) + + &location.search().unwrap_or("".into()); + R::from_str(&path).unwrap_or_else(|err| panic!("{}", err)) } fn full_path(&self, state: &R) -> String { diff --git a/packages/router/src/history/web_hash.rs b/packages/router/src/history/web_hash.rs index c910b1c97..c23bca237 100644 --- a/packages/router/src/history/web_hash.rs +++ b/packages/router/src/history/web_hash.rs @@ -1,8 +1,8 @@ use std::sync::{Arc, Mutex}; use gloo::{events::EventListener, render::AnimationFrame, utils::window}; -use log::error; use serde::{de::DeserializeOwned, Serialize}; +use tracing::error; use url::Url; use web_sys::{History, ScrollRestoration, Window}; diff --git a/packages/router/src/hooks/use_navigator.rs b/packages/router/src/hooks/use_navigator.rs index b435e7f9e..c1c21ee63 100644 --- a/packages/router/src/hooks/use_navigator.rs +++ b/packages/router/src/hooks/use_navigator.rs @@ -17,13 +17,14 @@ use crate::prelude::{Navigator, RouterContext}; /// Dynamic { id: usize }, /// } /// +/// #[component] /// fn App(cx: Scope) -> Element { /// render! { /// Router:: {} /// } /// } /// -/// #[inline_props] +/// #[component] /// fn Index(cx: Scope) -> Element { /// let navigator = use_navigator(&cx); /// @@ -35,7 +36,7 @@ use crate::prelude::{Navigator, RouterContext}; /// } /// } /// -/// #[inline_props] +/// #[component] /// fn Dynamic(cx: Scope, id: usize) -> Element { /// render! { /// p { diff --git a/packages/router/src/hooks/use_route.rs b/packages/router/src/hooks/use_route.rs index e6aa906d5..42cca27fb 100644 --- a/packages/router/src/hooks/use_route.rs +++ b/packages/router/src/hooks/use_route.rs @@ -12,7 +12,7 @@ use crate::utils::use_router_internal::use_router_internal; /// - Otherwise the current route. /// /// # Panic -/// - When the calling component is not nested within a [`Link`] component durring a debug build. +/// - When the calling component is not nested within a [`Link`] component during a debug build. /// /// # Example /// ```rust @@ -25,6 +25,7 @@ use crate::utils::use_router_internal::use_router_internal; /// Index {}, /// } /// +/// #[component] /// fn App(cx: Scope) -> Element { /// render! { /// h1 { "App" } @@ -32,9 +33,9 @@ use crate::utils::use_router_internal::use_router_internal; /// } /// } /// -/// #[inline_props] +/// #[component] /// fn Index(cx: Scope) -> Element { -/// let path = use_route(&cx).unwrap(); +/// let path: Route = use_route(&cx).unwrap(); /// render! { /// h2 { "Current Path" } /// p { "{path}" } diff --git a/packages/router/src/incremental.rs b/packages/router/src/incremental.rs index 79f4e24bf..e1c74c5fb 100644 --- a/packages/router/src/incremental.rs +++ b/packages/router/src/incremental.rs @@ -1,4 +1,4 @@ -//! Exentsions to the incremental renderer to support pre-caching static routes. +//! Extensions to the incremental renderer to support pre-caching static routes. use core::pin::Pin; use std::future::Future; use std::str::FromStr; @@ -59,8 +59,8 @@ where .await?; } Err(e) => { - log::info!("@ route: {}", full_path); - log::error!("Error pre-caching static route: {}", e); + tracing::info!("@ route: {}", full_path); + tracing::error!("Error pre-caching static route: {}", e); } } } @@ -87,7 +87,7 @@ where ::Err: std::fmt::Display, W: tokio::io::AsyncWrite + Unpin + Send, { - #[inline_props] + #[component] fn RenderPath(cx: Scope, path: R) -> Element where R: Routable, diff --git a/packages/router/src/lib.rs b/packages/router/src/lib.rs index 49b7ffc42..a92394513 100644 --- a/packages/router/src/lib.rs +++ b/packages/router/src/lib.rs @@ -82,3 +82,8 @@ pub mod prelude { mod utils { pub(crate) mod use_router_internal; } + +#[doc(hidden)] +pub mod exports { + pub use urlencoding; +} diff --git a/packages/router/src/navigation.rs b/packages/router/src/navigation.rs index c0a85fe67..2d7a3f90f 100644 --- a/packages/router/src/navigation.rs +++ b/packages/router/src/navigation.rs @@ -18,7 +18,7 @@ pub enum NavigationTarget { /// # use dioxus::prelude::*; /// # use dioxus_router::prelude::*; /// # use dioxus_router::navigation::NavigationTarget; - /// # #[inline_props] + /// # #[component] /// # fn Index(cx: Scope) -> Element { /// # todo!() /// # } @@ -38,7 +38,7 @@ pub enum NavigationTarget { /// # use dioxus::prelude::*; /// # use dioxus_router::prelude::*; /// # use dioxus_router::navigation::NavigationTarget; - /// # #[inline_props] + /// # #[component] /// # fn Index(cx: Scope) -> Element { /// # todo!() /// # } diff --git a/packages/router/src/routable.rs b/packages/router/src/routable.rs index d9f5b2346..b1bb6d915 100644 --- a/packages/router/src/routable.rs +++ b/packages/router/src/routable.rs @@ -3,16 +3,18 @@ #![allow(non_snake_case)] use dioxus::prelude::*; +use std::iter::FlatMap; +use std::slice::Iter; use std::{fmt::Display, str::FromStr}; -/// An error that occurs when parsing a route +/// An error that occurs when parsing a route. #[derive(Debug, PartialEq)] -pub struct RouteParseError { - /// The attempted routes that failed to match +pub struct RouteParseError { + /// The attempted routes that failed to match. pub attempted_routes: Vec, } -impl std::fmt::Display for RouteParseError { +impl Display for RouteParseError { fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { write!(f, "Route did not match:\nAttempted Matches:\n")?; for (i, route) in self.attempted_routes.iter().enumerate() { @@ -26,63 +28,96 @@ impl std::fmt::Display for RouteParseError { /// /// This trait needs to be implemented if you want to turn a query string into a struct. /// -/// A working example can be found in the `examples` folder in the root package under `query_segments_demo` +/// A working example can be found in the `examples` folder in the root package under `query_segments_demo`. pub trait FromQuery { - /// Create an instance of `Self` from a query string + /// Create an instance of `Self` from a query string. fn from_query(query: &str) -> Self; } impl From<&'a str>> FromQuery for T { fn from_query(query: &str) -> Self { - T::from(query) + T::from(&*urlencoding::decode(query).expect("Failed to decode url encoding")) } } -/// Something that can be created from a route segment +/// Something that can be created from a route segment. pub trait FromRouteSegment: Sized { - /// The error that can occur when parsing a route segment + /// The error that can occur when parsing a route segment. type Err; - /// Create an instance of `Self` from a route segment + /// Create an instance of `Self` from a route segment. fn from_route_segment(route: &str) -> Result; } impl FromRouteSegment for T where - ::Err: std::fmt::Display, + ::Err: Display, { type Err = ::Err; fn from_route_segment(route: &str) -> Result { - T::from_str(route) + match urlencoding::decode(route) { + Ok(segment) => T::from_str(&segment), + Err(err) => { + tracing::error!("Failed to decode url encoding: {}", err); + T::from_str(route) + } + } } } -/// Something that can be converted to route segments -pub trait ToRouteSegments { - /// Display the route segments - fn display_route_segements(self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result; +#[test] +fn full_circle() { + let route = "testing 1234 hello world"; + assert_eq!(String::from_route_segment(route).unwrap(), route); } -impl ToRouteSegments for I +/// Something that can be converted to route segments. +pub trait ToRouteSegments { + /// Display the route segments. + fn display_route_segments(self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result; +} + +impl ToRouteSegments for I where I: IntoIterator, { - fn display_route_segements(self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { + fn display_route_segments(self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { for segment in self { write!(f, "/")?; - write!(f, "{}", segment)?; + let segment = segment.to_string(); + match urlencoding::decode(&segment) { + Ok(segment) => write!(f, "{}", segment)?, + Err(err) => { + tracing::error!("Failed to decode url encoding: {}", err); + write!(f, "{}", segment)? + } + } } Ok(()) } } -/// Something that can be created from route segments +#[test] +fn to_route_segments() { + struct DisplaysRoute; + + impl Display for DisplaysRoute { + fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { + let segments = vec!["hello", "world"]; + segments.display_route_segments(f) + } + } + + assert_eq!(DisplaysRoute.to_string(), "/hello/world"); +} + +/// Something that can be created from route segments. pub trait FromRouteSegments: Sized { - /// The error that can occur when parsing route segments + /// The error that can occur when parsing route segments. type Err; - /// Create an instance of `Self` from route segments + /// Create an instance of `Self` from route segments. fn from_route_segments(segments: &[&str]) -> Result; } @@ -97,29 +132,54 @@ impl> FromRouteSegments for I { } } +/// A flattened version of [`Routable::SITE_MAP`]. +/// This essentially represents a `Vec>`, which you can collect it into. +type SiteMapFlattened<'a> = FlatMap< + Iter<'a, SiteMapSegment>, + Vec>, + fn(&SiteMapSegment) -> Vec>, +>; + +fn seg_strs_to_route(segs_maybe: &Option>) -> Option +where + T: Routable, +{ + if let Some(str) = seg_strs_to_str(segs_maybe) { + T::from_str(&str).ok() + } else { + None + } +} + +fn seg_strs_to_str(segs_maybe: &Option>) -> Option { + segs_maybe + .as_ref() + .map(|segs| String::from('/') + &segs.join("/")) +} + /// Something that can be: -/// 1. Converted from a route -/// 2. Converted to a route -/// 3. Rendered as a component +/// 1. Converted from a route. +/// 2. Converted to a route. +/// 3. Rendered as a component. /// -/// This trait can be derived using the `#[derive(Routable)]` macro -pub trait Routable: std::fmt::Display + std::str::FromStr + Clone + 'static { - /// The error that can occur when parsing a route +/// This trait can be derived using the `#[derive(Routable)]` macro. +pub trait Routable: FromStr + Display + Clone + 'static { + /// The error that can occur when parsing a route. const SITE_MAP: &'static [SiteMapSegment]; /// Render the route at the given level fn render<'a>(&self, cx: &'a ScopeState, level: usize) -> Element<'a>; - /// Checks if this route is a child of the given route + /// Checks if this route is a child of the given route. /// /// # Example /// ```rust /// use dioxus_router::prelude::*; /// use dioxus::prelude::*; /// - /// #[inline_props] + /// #[component] /// fn Home(cx: Scope) -> Element { todo!() } - /// #[inline_props] + /// #[component] /// fn About(cx: Scope) -> Element { todo!() } /// /// #[derive(Routable, Clone, PartialEq, Debug)] @@ -152,23 +212,23 @@ pub trait Routable: std::fmt::Display + std::str::FromStr + Clone + 'static { true } - /// Get the parent route of this route + /// Get the parent route of this route. /// /// # Example /// ```rust /// use dioxus_router::prelude::*; /// use dioxus::prelude::*; /// - /// #[inline_props] + /// #[component] /// fn Home(cx: Scope) -> Element { todo!() } - /// #[inline_props] + /// #[component] /// fn About(cx: Scope) -> Element { todo!() } /// /// #[derive(Routable, Clone, PartialEq, Debug)] /// enum Route { - /// #[route("/")] + /// #[route("/home")] /// Home {}, - /// #[route("/about")] + /// #[route("/home/about")] /// About {}, /// } /// @@ -192,72 +252,67 @@ pub trait Routable: std::fmt::Display + std::str::FromStr + Clone + 'static { Self::from_str(&new_route).ok() } - /// Gets a list of all static routes + /// Returns a flattened version of [`Self::SITE_MAP`]. + fn flatten_site_map<'a>() -> SiteMapFlattened<'a> { + Self::SITE_MAP.iter().flat_map(SiteMapSegment::flatten) + } + + /// Gets a list of all the static routes. + /// Example static route: `#[route("/static/route")]` fn static_routes() -> Vec { - Self::SITE_MAP - .iter() - .flat_map(|segment| segment.flatten()) + Self::flatten_site_map() .filter_map(|route| { - if route + let route_if_static = &route .iter() - .all(|segment| matches!(segment, SegmentType::Static(_))) - { - Self::from_str( - &route - .iter() - .map(|segment| match segment { - SegmentType::Static(s) => s.to_string(), - _ => unreachable!(), - }) - .collect::>() - .join("/"), - ) - .ok() - } else { - None - } + .map(|segment| match segment { + SegmentType::Static(s) => Some(*s), + _ => None, + }) + .collect::>>(); + + seg_strs_to_route(route_if_static) }) .collect() } } trait RoutableFactory { - type Err: std::fmt::Display; + type Err: Display; type Routable: Routable + FromStr; } impl RoutableFactory for R where - ::Err: std::fmt::Display, + ::Err: Display, { type Err = ::Err; type Routable = R; } -trait RouteRenderable: std::fmt::Display + 'static { +trait RouteRenderable: Display + 'static { fn render<'a>(&self, cx: &'a ScopeState, level: usize) -> Element<'a>; } impl RouteRenderable for R where - ::Err: std::fmt::Display, + ::Err: Display, { fn render<'a>(&self, cx: &'a ScopeState, level: usize) -> Element<'a> { self.render(cx, level) } } -/// A type erased map of the site structurens +/// A type erased map of the site structure. #[derive(Debug, Clone, PartialEq)] pub struct SiteMapSegment { - /// The type of the route segment + /// The type of the route segment. pub segment_type: SegmentType, - /// The children of the route segment + /// The children of the route segment. pub children: &'static [SiteMapSegment], } impl SiteMapSegment { - /// Take a map of the site structure and flatten it into a vector of routes + /// Take a map of the site structure and flatten it into a vector of routes. pub fn flatten(&self) -> Vec> { let mut routes = Vec::new(); self.flatten_inner(&mut routes, Vec::new()); @@ -277,16 +332,16 @@ impl SiteMapSegment { } } -/// The type of a route segment +/// The type of a route segment. #[derive(Debug, Clone, PartialEq)] pub enum SegmentType { - /// A static route segment + /// A static route segment. Static(&'static str), - /// A dynamic route segment + /// A dynamic route segment. Dynamic(&'static str), - /// A catch all route segment + /// A catch all route segment. CatchAll(&'static str), - /// A child router + /// A child router. Child, } @@ -296,7 +351,7 @@ impl Display for SegmentType { SegmentType::Static(s) => write!(f, "/{}", s), SegmentType::Child => Ok(()), SegmentType::Dynamic(s) => write!(f, "/:{}", s), - SegmentType::CatchAll(s) => write!(f, "/:...{}", s), + SegmentType::CatchAll(s) => write!(f, "/:..{}", s), } } } diff --git a/packages/router/src/router_cfg.rs b/packages/router/src/router_cfg.rs index 764d70461..dd379e493 100644 --- a/packages/router/src/router_cfg.rs +++ b/packages/router/src/router_cfg.rs @@ -13,7 +13,7 @@ use crate::prelude::*; /// ```rust,no_run /// # use dioxus_router::prelude::*; /// # use dioxus::prelude::*; -/// # #[inline_props] +/// # #[component] /// # fn Index(cx: Scope) -> Element { /// # todo!() /// # } diff --git a/packages/router/tests/via_ssr/link.rs b/packages/router/tests/via_ssr/link.rs index 3fe899128..6f330cb83 100644 --- a/packages/router/tests/via_ssr/link.rs +++ b/packages/router/tests/via_ssr/link.rs @@ -1,4 +1,3 @@ -#![allow(non_snake_case)] use dioxus::prelude::*; use dioxus_router::prelude::*; use std::str::FromStr; @@ -27,6 +26,7 @@ where } } + #[component] fn App(cx: Scope>) -> Element where ::Err: std::fmt::Display, @@ -50,12 +50,12 @@ fn href_internal() { Test {}, } - #[inline_props] - fn Test(cx: Scope) -> Element { + #[component] + fn Test(_cx: Scope) -> Element { todo!() } - #[inline_props] + #[component] fn Root(cx: Scope) -> Element { render! { Link { @@ -88,12 +88,12 @@ fn href_external() { Test {}, } - #[inline_props] - fn Test(cx: Scope) -> Element { + #[component] + fn Test(_cx: Scope) -> Element { todo!() } - #[inline_props] + #[component] fn Root(cx: Scope) -> Element { render! { Link { @@ -126,12 +126,12 @@ fn with_class() { Test {}, } - #[inline_props] - fn Test(cx: Scope) -> Element { + #[component] + fn Test(_cx: Scope) -> Element { todo!() } - #[inline_props] + #[component] fn Root(cx: Scope) -> Element { render! { Link { @@ -163,7 +163,7 @@ fn with_active_class_active() { Root {}, } - #[inline_props] + #[component] fn Root(cx: Scope) -> Element { render! { Link { @@ -198,12 +198,12 @@ fn with_active_class_inactive() { Test {}, } - #[inline_props] - fn Test(cx: Scope) -> Element { + #[component] + fn Test(_cx: Scope) -> Element { todo!() } - #[inline_props] + #[component] fn Root(cx: Scope) -> Element { render! { Link { @@ -238,12 +238,12 @@ fn with_id() { Test {}, } - #[inline_props] - fn Test(cx: Scope) -> Element { + #[component] + fn Test(_cx: Scope) -> Element { todo!() } - #[inline_props] + #[component] fn Root(cx: Scope) -> Element { render! { Link { @@ -277,12 +277,12 @@ fn with_new_tab() { Test {}, } - #[inline_props] - fn Test(cx: Scope) -> Element { + #[component] + fn Test(_cx: Scope) -> Element { todo!() } - #[inline_props] + #[component] fn Root(cx: Scope) -> Element { render! { Link { @@ -314,7 +314,7 @@ fn with_new_tab_external() { Root {}, } - #[inline_props] + #[component] fn Root(cx: Scope) -> Element { render! { Link { @@ -348,12 +348,12 @@ fn with_rel() { Test {}, } - #[inline_props] - fn Test(cx: Scope) -> Element { + #[component] + fn Test(_cx: Scope) -> Element { todo!() } - #[inline_props] + #[component] fn Root(cx: Scope) -> Element { render! { Link { diff --git a/packages/router/tests/via_ssr/outlet.rs b/packages/router/tests/via_ssr/outlet.rs index d48b355d0..216384559 100644 --- a/packages/router/tests/via_ssr/outlet.rs +++ b/packages/router/tests/via_ssr/outlet.rs @@ -1,4 +1,4 @@ -#![allow(non_snake_case, unused)] +#![allow(unused)] use dioxus::prelude::*; use dioxus_router::prelude::*; @@ -34,6 +34,7 @@ fn prepare(path: impl Into) -> VirtualDom { path: String, } + #[component] fn App(cx: Scope) -> Element { render! { h1 { "App" } @@ -46,14 +47,14 @@ fn prepare(path: impl Into) -> VirtualDom { } } - #[inline_props] + #[component] fn RootIndex(cx: Scope) -> Element { render! { h2 { "Root Index" } } } - #[inline_props] + #[component] fn Fixed(cx: Scope) -> Element { render! { h2 { "Fixed" } @@ -61,21 +62,21 @@ fn prepare(path: impl Into) -> VirtualDom { } } - #[inline_props] + #[component] fn FixedIndex(cx: Scope) -> Element { render! { h3 { "Fixed - Index" } } } - #[inline_props] + #[component] fn FixedFixed(cx: Scope) -> Element { render! { h3 { "Fixed - Fixed"} } } - #[inline_props] + #[component] fn Parameter(cx: Scope, id: u8) -> Element { render! { h2 { "Parameter {id}" } @@ -83,14 +84,14 @@ fn prepare(path: impl Into) -> VirtualDom { } } - #[inline_props] + #[component] fn ParameterIndex(cx: Scope, id: u8) -> Element { render! { h3 { "Parameter - Index" } } } - #[inline_props] + #[component] fn ParameterFixed(cx: Scope, id: u8) -> Element { render! { h3 { "Parameter - Fixed" } diff --git a/packages/rsx-rosetta/README.md b/packages/rsx-rosetta/README.md index da3049d3c..f046838c4 100644 --- a/packages/rsx-rosetta/README.md +++ b/packages/rsx-rosetta/README.md @@ -1,5 +1,3 @@ - - # `rsx-rosetta` [![Crates.io][crates-badge]][crates-url] @@ -9,18 +7,15 @@ [crates-badge]: https://img.shields.io/crates/v/rsx-rosetta.svg [crates-url]: https://crates.io/crates/rsx-rosetta - [mit-badge]: https://img.shields.io/badge/license-MIT-blue.svg [mit-url]: https://github.com/dioxuslabs/dioxus/blob/master/LICENSE - [actions-badge]: https://github.com/dioxuslabs/dioxus/actions/workflows/main.yml/badge.svg [actions-url]: https://github.com/dioxuslabs/dioxus/actions?query=workflow%3ACI+branch%3Amaster - [discord-badge]: https://img.shields.io/discord/899851952891002890.svg?logo=discord&style=flat-square [discord-url]: https://discord.gg/XgGxMSkvUM [Website](https://dioxuslabs.com) | -[Guides](https://dioxuslabs.com/docs/0.3/guide/en/) | +[Guides](https://dioxuslabs.com/learn/0.4/) | [API Docs](https://docs.rs/rsx-rosetta/latest/rsx-rosetta) | [Chat](https://discord.gg/XgGxMSkvUM) @@ -49,6 +44,7 @@ From there, you can convert directly to a string or into some other AST. - Join the discord and ask questions! ## License + This project is licensed under the [MIT license]. [mit license]: https://github.com/DioxusLabs/dioxus/blob/master/LICENSE-MIT @@ -56,4 +52,3 @@ This project is licensed under the [MIT license]. Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in Dioxus by you, shall be licensed as MIT, without any additional terms or conditions. - diff --git a/packages/rsx/README.md b/packages/rsx/README.md index c20737167..61502fb17 100644 --- a/packages/rsx/README.md +++ b/packages/rsx/README.md @@ -7,22 +7,18 @@ [crates-badge]: https://img.shields.io/crates/v/dioxus-rsx.svg [crates-url]: https://crates.io/crates/dioxus-rsx - [mit-badge]: https://img.shields.io/badge/license-MIT-blue.svg [mit-url]: https://github.com/dioxuslabs/dioxus/blob/master/LICENSE - [actions-badge]: https://github.com/dioxuslabs/dioxus/actions/workflows/main.yml/badge.svg [actions-url]: https://github.com/dioxuslabs/dioxus/actions?query=workflow%3ACI+branch%3Amaster - [discord-badge]: https://img.shields.io/discord/899851952891002890.svg?logo=discord&style=flat-square [discord-url]: https://discord.gg/XgGxMSkvUM [Website](https://dioxuslabs.com) | -[Guides](https://dioxuslabs.com/docs/0.3/guide/en/) | +[Guides](https://dioxuslabs.com/learn/0.4/) | [API Docs](https://docs.rs/dioxus-rsx/latest/dioxus_rsx) | [Chat](https://discord.gg/XgGxMSkvUM) - ## Overview This crate provides the actual DSL that Dioxus uses in the `rsx!` macro. This crate is separate from the macro crate to enable tooling like autoformat, translation, and AST manipulation (extract to component). @@ -33,6 +29,7 @@ This crate provides the actual DSL that Dioxus uses in the `rsx!` macro. This cr - Join the discord and ask questions! ## License + This project is licensed under the [MIT license]. [mit license]: https://github.com/DioxusLabs/dioxus/blob/master/LICENSE-MIT @@ -40,4 +37,3 @@ This project is licensed under the [MIT license]. Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in Dioxus by you shall be licensed as MIT, without any additional terms or conditions. - diff --git a/packages/signals/Cargo.toml b/packages/signals/Cargo.toml index 0017a1545..56e19bbd8 100644 --- a/packages/signals/Cargo.toml +++ b/packages/signals/Cargo.toml @@ -9,7 +9,7 @@ edition = "2018" [dependencies] dioxus-core = { workspace = true } generational-box = { workspace = true } -log.workspace = true +tracing = { workspace = true } simple_logger = "4.2.0" serde = { version = "1", features = ["derive"], optional = true } diff --git a/packages/signals/README.md b/packages/signals/README.md index 020edc18f..d1e772445 100644 --- a/packages/signals/README.md +++ b/packages/signals/README.md @@ -10,7 +10,8 @@ All signals implement Copy, even if the inner value does not implement copy. Thi use dioxus::prelude::*; use dioxus_signals::*; -fn app(cx: Scope) -> Element { +#[component] +fn App(cx: Scope) -> Element { let signal = use_signal(cx, || "hello world".to_string()); spawn(async move { @@ -32,7 +33,8 @@ Signals will only subscribe to components when you read from the signal in that use dioxus::prelude::*; use dioxus_signals::*; -fn app(cx: Scope) -> Element { +#[component] +fn App(cx: Scope) -> Element { // Because signal is never read in this component, this component will not rerun when the signal changes let signal = use_signal(cx, || 0); @@ -56,6 +58,7 @@ struct ChildProps { signal: Signal, } +#[component] fn Child(cx: Scope) -> Element { // This component does read from the signal, so when the signal changes it will rerun render! { @@ -70,15 +73,17 @@ Because subscriptions happen when you read from (not create) the data, you can p use dioxus::prelude::*; use dioxus_signals::*; -fn app(cx: Scope) -> Element { +#[component] +fn App(cx: Scope) -> Element { // Because signal is never read in this component, this component will not rerun when the signal changes use_context_provider(cx, || Signal::new(0)); - + render! { Child {} } } +#[component] fn Child(cx: Scope) -> Element { let signal: Signal = *use_context(cx).unwrap(); // This component does read from the signal, so when the signal changes it will rerun @@ -92,13 +97,14 @@ fn Child(cx: Scope) -> Element { In addition to local subscriptions in components, `dioxus-signals` provides a way to derive data with local subscriptions. -The use_selector hook will only rerun when any signals inside of the hook change: +The use_selector hook will only rerun when any signals inside the hook change: ```rust use dioxus::prelude::*; use dioxus_signals::*; -fn app(cx: Scope) -> Element { +#[component] +fn App(cx: Scope) -> Element { let signal = use_signal(cx, || 0); let doubled = use_selector(cx, || signal * 2); @@ -113,7 +119,7 @@ fn app(cx: Scope) -> Element { } } -#[inline_props] +#[component] fn Child(cx: Scope, signal: ReadOnlySignal) -> Element { render! { "{signal}" diff --git a/packages/signals/examples/selector.rs b/packages/signals/examples/selector.rs index 85d93ae7f..e7a482cd6 100644 --- a/packages/signals/examples/selector.rs +++ b/packages/signals/examples/selector.rs @@ -1,13 +1,12 @@ -#![allow(non_snake_case)] - use dioxus::prelude::*; use dioxus_signals::*; fn main() { - dioxus_desktop::launch(app); + dioxus_desktop::launch(App); } -fn app(cx: Scope) -> Element { +#[component] +fn App(cx: Scope) -> Element { let signal = use_signal(cx, || 0); let doubled = use_selector(cx, move || signal * 2); @@ -22,7 +21,7 @@ fn app(cx: Scope) -> Element { } } -#[inline_props] +#[component] fn Child(cx: Scope, signal: ReadOnlySignal) -> Element { render! { "{signal}" diff --git a/packages/signals/src/effect.rs b/packages/signals/src/effect.rs index 0685938a0..9a54188d9 100644 --- a/packages/signals/src/effect.rs +++ b/packages/signals/src/effect.rs @@ -18,7 +18,8 @@ pub(crate) fn get_effect_stack() -> EffectStack { Some(rt) => rt, None => { let store = EffectStack::default(); - provide_root_context(store).expect("in a virtual dom") + provide_root_context(store.clone()); + store } } } @@ -54,6 +55,7 @@ pub fn use_effect_with_dependencies( /// Effects allow you to run code when a signal changes. Effects are run immediately and whenever any signal it reads changes. #[derive(Copy, Clone, PartialEq)] pub struct Effect { + pub(crate) source: ScopeId, pub(crate) callback: CopyValue>, } @@ -73,6 +75,7 @@ impl Effect { /// The signal will be owned by the current component and will be dropped when the component is dropped. pub fn new(callback: impl FnMut() + 'static) -> Self { let myself = Self { + source: current_scope_id().expect("in a virtual dom"), callback: CopyValue::new(Box::new(callback)), }; diff --git a/packages/signals/src/rt.rs b/packages/signals/src/rt.rs index 7322d43b4..113fe9b30 100644 --- a/packages/signals/src/rt.rs +++ b/packages/signals/src/rt.rs @@ -2,14 +2,13 @@ use std::cell::{Ref, RefMut}; use std::rc::Rc; -use dioxus_core::prelude::{ - consume_context, consume_context_from_scope, current_scope_id, provide_context, - provide_context_to_scope, provide_root_context, -}; +use dioxus_core::prelude::*; use dioxus_core::ScopeId; use generational_box::{GenerationalBox, Owner, Store}; +use crate::Effect; + fn current_store() -> Store { match consume_context() { Some(rt) => rt, @@ -21,12 +20,20 @@ fn current_store() -> Store { } fn current_owner() -> Rc { - match consume_context() { - Some(rt) => rt, - None => { - let owner = Rc::new(current_store().owner()); - provide_context(owner).expect("in a virtual dom") + match Effect::current() { + // If we are inside of an effect, we should use the owner of the effect as the owner of the value. + Some(effect) => { + let scope_id = effect.source; + owner_in_scope(scope_id) } + // Otherwise either get an owner from the current scope or create a new one. + None => match has_context() { + Some(rt) => rt, + None => { + let owner = Rc::new(current_store().owner()); + provide_context(owner).expect("in a virtual dom") + } + }, } } diff --git a/packages/signals/src/selector.rs b/packages/signals/src/selector.rs index 5eb3fa3c9..346506ff7 100644 --- a/packages/signals/src/selector.rs +++ b/packages/signals/src/selector.rs @@ -74,6 +74,7 @@ pub fn selector(mut f: impl FnMut() -> R + 'static) -> ReadOnlySig inner: CopyValue::invalid(), }; let effect = Effect { + source: current_scope_id().expect("in a virtual dom"), callback: CopyValue::invalid(), }; diff --git a/packages/signals/src/signal.rs b/packages/signals/src/signal.rs index f41624f96..c1ae076d9 100644 --- a/packages/signals/src/signal.rs +++ b/packages/signals/src/signal.rs @@ -26,7 +26,7 @@ use crate::{CopyValue, Effect}; /// render! { Child { state: count } } /// } /// -/// #[inline_props] +/// #[component] /// fn Child(cx: Scope, state: Signal) -> Element { /// let state = *state; /// @@ -89,6 +89,7 @@ pub(crate) struct SignalData { /// use dioxus::prelude::*; /// use dioxus_signals::*; /// +/// #[component] /// fn App(cx: Scope) -> Element { /// let mut count = use_signal(cx, || 0); /// @@ -97,7 +98,7 @@ pub(crate) struct SignalData { /// render! { Child { state: count } } /// } /// -/// #[inline_props] +/// #[component] /// fn Child(cx: Scope, state: Signal) -> Element { /// let state = *state; /// @@ -177,7 +178,7 @@ impl Signal { } else if let Some(current_scope_id) = current_scope_id() { // only subscribe if the vdom is rendering if dioxus_core::vdom_is_rendering() { - log::trace!( + tracing::trace!( "{:?} subscribed to {:?}", self.inner.value, current_scope_id @@ -209,7 +210,7 @@ impl Signal { { let inner = self.inner.read(); for &scope_id in &*inner.subscribers.borrow() { - log::trace!( + tracing::trace!( "Write on {:?} triggered update on {:?}", self.inner.value, scope_id @@ -224,7 +225,7 @@ impl Signal { std::mem::take(&mut *effects) }; for effect in subscribers { - log::trace!( + tracing::trace!( "Write on {:?} triggered effect {:?}", self.inner.value, effect diff --git a/packages/ssr/Cargo.toml b/packages/ssr/Cargo.toml index 1450bd46e..f6376452d 100644 --- a/packages/ssr/Cargo.toml +++ b/packages/ssr/Cargo.toml @@ -6,7 +6,6 @@ edition = "2018" description = "Dioxus render-to-string" license = "MIT OR Apache-2.0" repository = "https://github.com/DioxusLabs/dioxus/" -homepage = "https://dioxuslabs.com/docs/0.3/guide/en/getting_started/ssr.html" keywords = ["dom", "ui", "gui", "react", "ssr"] [dependencies] @@ -15,14 +14,14 @@ askama_escape = "0.10.3" thiserror = "1.0.23" rustc-hash = "1.1.0" lru = "0.10.0" -log = "0.4.13" +tracing = { workspace = true } http = "0.2.9" tokio = { version = "1.28", features = ["full"], optional = true } [dev-dependencies] dioxus = { workspace = true } thiserror = { workspace = true } -log = { workspace = true } +tracing = { workspace = true } fern = { version = "0.6.0", features = ["colored"] } anyhow = "1.0" argh = "0.1.4" diff --git a/packages/ssr/README.md b/packages/ssr/README.md index c5b91b7b8..59dbfbacf 100644 --- a/packages/ssr/README.md +++ b/packages/ssr/README.md @@ -6,10 +6,11 @@

## Resources + This crate is a part of the broader Dioxus ecosystem. For more resources about Dioxus, check out: -- [Getting Started](https://dioxuslabs.com/docs/0.3/guide/en/getting_started/index.html) -- [Book](https://dioxuslabs.com/docs/0.3/guide/en/) +- [Getting Started](https://dioxuslabs.com/learn/0.4/getting_started) +- [Book](https://dioxuslabs.com/learn/0.4/) - [Examples](https://github.com/DioxusLabs/example-projects) ## Overview @@ -26,7 +27,6 @@ let text = dioxus_ssr::render(&vdom); assert_eq!(text, "
hello world!
") ``` - ## Basic Usage The simplest example is to simply render some `rsx!` nodes to HTML. This can be done with the [`render_lazy`] API. @@ -50,15 +50,11 @@ let _ = vdom.rebuild(); let content = dioxus_ssr::render(&vdom); ``` - - - - ## Usage in pre-rendering This crate is particularly useful in pre-generating pages server-side and then selectively loading Dioxus client-side to pick up the reactive elements. -This crate supports hydration out of the box. However, both the client and server must generate the *exact* same VirtualDOMs - the client picks up its VirtualDOM assuming that the pre-rendered page output is the same. To do this, you need to make sure that your VirtualDOM implementation is deterministic! This could involve either serializing our app state and sending it to the client, hydrating only parts of the page, or building tests to ensure what's rendered on the server is the same as the client. +This crate supports hydration out of the box. However, both the client and server must generate the _exact_ same VirtualDOMs - the client picks up its VirtualDOM assuming that the pre-rendered page output is the same. To do this, you need to make sure that your VirtualDOM implementation is deterministic! This could involve either serializing our app state and sending it to the client, hydrating only parts of the page, or building tests to ensure what's rendered on the server is the same as the client. With pre-rendering enabled, this crate will generate element nodes with Element IDs pre-associated. During hydration, the Dioxus-WebSys renderer will attach the Virtual nodes to these real nodes after a page query. @@ -107,5 +103,4 @@ let text = render_lazy!(rsx!( div { "hello world" } )); Dioxus SSR is a powerful tool to generate static sites. Using Dioxus for static site generation _is_ a bit overkill, however. The new documentation generation library, Doxie, is essentially Dioxus SSR on steroids designed for static site generation with client-side hydration. - Again, simply render the VirtualDOM to a string using `render` or any of the other render methods. diff --git a/packages/ssr/src/cache.rs b/packages/ssr/src/cache.rs index a67fd5f22..bcd6ba71f 100644 --- a/packages/ssr/src/cache.rs +++ b/packages/ssr/src/cache.rs @@ -1,6 +1,8 @@ use dioxus_core::prelude::*; use std::fmt::Write; +use crate::renderer::{str_truthy, BOOL_ATTRS}; + #[derive(Debug)] pub struct StringCache { pub segments: Vec, @@ -86,6 +88,10 @@ impl StringCache { inner_html = Some(value); } else if let Some("style") = namespace { styles.push((name, value)); + } else if BOOL_ATTRS.contains(name) { + if str_truthy(value) { + write!(chain, " {name}=\"{value}\"",)?; + } } else { write!(chain, " {name}=\"{value}\"")?; } diff --git a/packages/ssr/src/incremental.rs b/packages/ssr/src/incremental.rs index 9647124de..c3bb25314 100644 --- a/packages/ssr/src/incremental.rs +++ b/packages/ssr/src/incremental.rs @@ -139,13 +139,13 @@ impl IncrementalRenderer { let age = elapsed.as_secs(); if let Some(invalidate_after) = self.invalidate_after { if elapsed < invalidate_after { - log::trace!("memory cache hit {:?}", route); + tracing::trace!("memory cache hit {:?}", route); output.write_all(cache_hit).await?; let max_age = invalidate_after.as_secs(); return Ok(Some(RenderFreshness::new(age, max_age))); } } else { - log::trace!("memory cache hit {:?}", route); + tracing::trace!("memory cache hit {:?}", route); output.write_all(cache_hit).await?; return Ok(Some(RenderFreshness::new_age(age))); } @@ -157,7 +157,7 @@ impl IncrementalRenderer { if let Ok(file) = tokio::fs::File::open(file_path.full_path).await { let mut file = BufReader::new(file); tokio::io::copy_buf(&mut file, output).await?; - log::trace!("file cache hit {:?}", route); + tracing::trace!("file cache hit {:?}", route); self.promote_memory_cache(&route); return Ok(Some(freshness)); } @@ -184,7 +184,7 @@ impl IncrementalRenderer { let freshness = self .render_and_cache(route, component, props, output, rebuild_with, renderer) .await?; - log::trace!("cache miss"); + tracing::trace!("cache miss"); Ok(freshness) } } @@ -206,7 +206,7 @@ impl IncrementalRenderer { } // if the timestamp is invalid or passed, delete the file if let Err(err) = std::fs::remove_file(entry.path()) { - log::error!("Failed to remove file: {}", err); + tracing::error!("Failed to remove file: {}", err); } } } diff --git a/packages/ssr/src/renderer.rs b/packages/ssr/src/renderer.rs index 154fad641..98afef8b7 100644 --- a/packages/ssr/src/renderer.rs +++ b/packages/ssr/src/renderer.rs @@ -1,5 +1,7 @@ use super::cache::Segment; use crate::cache::StringCache; + +use dioxus_core::Attribute; use dioxus_core::{prelude::*, AttributeValue, DynamicNode, RenderReturn}; use std::collections::HashMap; use std::fmt::Write; @@ -83,18 +85,13 @@ impl Renderer { inner_html = Some(attr); } else if attr.namespace == Some("style") { accumulated_dynamic_styles.push(attr); + } else if BOOL_ATTRS.contains(&attr.name) { + if truthy(&attr.value) { + write!(buf, " {}=", attr.name)?; + write_value(buf, &attr.value)?; + } } else { - match attr.value { - AttributeValue::Text(value) => { - write!(buf, " {}=\"{}\"", attr.name, value)? - } - AttributeValue::Bool(value) => write!(buf, " {}={}", attr.name, value)?, - AttributeValue::Int(value) => write!(buf, " {}={}", attr.name, value)?, - AttributeValue::Float(value) => { - write!(buf, " {}={}", attr.name, value)? - } - _ => {} - }; + write_attribute(buf, attr)?; } } Segment::Node(idx) => match &template.dynamic_nodes[*idx] { @@ -153,17 +150,9 @@ impl Renderer { write!(buf, " style=\"")?; } for attr in &accumulated_dynamic_styles { - match attr.value { - AttributeValue::Text(value) => { - write!(buf, "{}:{};", attr.name, value)? - } - AttributeValue::Bool(value) => { - write!(buf, "{}:{};", attr.name, value)? - } - AttributeValue::Float(f) => write!(buf, "{}:{};", attr.name, f)?, - AttributeValue::Int(i) => write!(buf, "{}:{};", attr.name, i)?, - _ => {} - }; + write!(buf, "{}:", attr.name)?; + write_value_unquoted(buf, &attr.value)?; + write!(buf, ";")?; } if !*inside_style_tag { write!(buf, "\"")?; @@ -248,3 +237,81 @@ fn to_string_works() { assert_eq!(out, "
Hello world 1 -->123<-- Hello world 2
nest 1
nest 2
</diiiiiiiiv>
finalize 0
finalize 1
finalize 2
finalize 3
finalize 4
"); } + +pub(crate) const BOOL_ATTRS: &[&str] = &[ + "allowfullscreen", + "allowpaymentrequest", + "async", + "autofocus", + "autoplay", + "checked", + "controls", + "default", + "defer", + "disabled", + "formnovalidate", + "hidden", + "ismap", + "itemscope", + "loop", + "multiple", + "muted", + "nomodule", + "novalidate", + "open", + "playsinline", + "readonly", + "required", + "reversed", + "selected", + "truespeed", + "webkitdirectory", +]; + +pub(crate) fn str_truthy(value: &str) -> bool { + !value.is_empty() && value != "0" && value.to_lowercase() != "false" +} + +pub(crate) fn truthy(value: &AttributeValue) -> bool { + match value { + AttributeValue::Text(value) => str_truthy(value), + AttributeValue::Bool(value) => *value, + AttributeValue::Int(value) => *value != 0, + AttributeValue::Float(value) => *value != 0.0, + _ => false, + } +} + +pub(crate) fn write_attribute(buf: &mut impl Write, attr: &Attribute) -> std::fmt::Result { + let name = &attr.name; + match attr.value { + AttributeValue::Text(value) => write!(buf, " {name}=\"{value}\""), + AttributeValue::Bool(value) => write!(buf, " {name}={value}"), + AttributeValue::Int(value) => write!(buf, " {name}={value}"), + AttributeValue::Float(value) => write!(buf, " {name}={value}"), + _ => Ok(()), + } +} + +pub(crate) fn write_value(buf: &mut impl Write, value: &AttributeValue) -> std::fmt::Result { + match value { + AttributeValue::Text(value) => write!(buf, "\"{}\"", value), + AttributeValue::Bool(value) => write!(buf, "{}", value), + AttributeValue::Int(value) => write!(buf, "{}", value), + AttributeValue::Float(value) => write!(buf, "{}", value), + _ => Ok(()), + } +} + +pub(crate) fn write_value_unquoted( + buf: &mut impl Write, + value: &AttributeValue, +) -> std::fmt::Result { + match value { + AttributeValue::Text(value) => write!(buf, "{}", value), + AttributeValue::Bool(value) => write!(buf, "{}", value), + AttributeValue::Int(value) => write!(buf, "{}", value), + AttributeValue::Float(value) => write!(buf, "{}", value), + _ => Ok(()), + } +} diff --git a/packages/ssr/tests/bool_attr.rs b/packages/ssr/tests/bool_attr.rs new file mode 100644 index 000000000..778e90dcc --- /dev/null +++ b/packages/ssr/tests/bool_attr.rs @@ -0,0 +1,37 @@ +use dioxus::prelude::*; + +#[test] +fn static_boolean_attributs() { + fn app(cx: Scope) -> Element { + render! { + div { hidden: "false" } + div { hidden: "true" } + } + } + + let mut dom = VirtualDom::new(app); + _ = dom.rebuild(); + + assert_eq!( + dioxus_ssr::render(&dom), + r#"
"# + ); +} + +#[test] +fn dynamic_boolean_attributs() { + fn app(cx: Scope) -> Element { + render! { + div { hidden: false } + div { hidden: true } + } + } + + let mut dom = VirtualDom::new(app); + _ = dom.rebuild(); + + assert_eq!( + dioxus_ssr::render(&dom), + r#"
"# + ); +} diff --git a/packages/ssr/tests/simple.rs b/packages/ssr/tests/simple.rs index 395f801e1..cdf186a80 100644 --- a/packages/ssr/tests/simple.rs +++ b/packages/ssr/tests/simple.rs @@ -2,11 +2,12 @@ use dioxus::prelude::*; #[test] fn simple() { - fn app(cx: Scope) -> Element { + #[component] + fn App(cx: Scope) -> Element { render! { div { "hello!" } } } - let mut dom = VirtualDom::new(app); + let mut dom = VirtualDom::new(App); _ = dom.rebuild(); assert_eq!(dioxus_ssr::render(&dom), "
hello!
"); @@ -44,8 +45,8 @@ fn dynamic() { #[test] fn components() { - #[inline_props] - fn my_component(cx: Scope, name: i32) -> Element { + #[component] + fn MyComponent(cx: Scope, name: i32) -> Element { render! { div { "component {name}" } } @@ -55,7 +56,7 @@ fn components() { dioxus_ssr::render_lazy(rsx! { div { (0..5).map(|name| rsx! { - my_component { name: name } + MyComponent { name: name } }) } }), diff --git a/packages/web/Cargo.toml b/packages/web/Cargo.toml index 8de282869..35eb9c5f1 100644 --- a/packages/web/Cargo.toml +++ b/packages/web/Cargo.toml @@ -6,7 +6,7 @@ edition = "2018" description = "Web renderer for Dioxus using websys" license = "MIT OR Apache-2.0" repository = "https://github.com/DioxusLabs/dioxus/" -homepage = "https://dioxuslabs.com/docs/0.3/guide/en/getting_started/web.html" +homepage = "https://dioxuslabs.com/learn/0.4/getting_started/wasm" keywords = ["dom", "ui", "gui", "react", "wasm"] [dependencies] @@ -20,7 +20,7 @@ dioxus-interpreter-js = { workspace = true, features = [ js-sys = "0.3.56" wasm-bindgen = { workspace = true, features = ["enable-interning"] } wasm-bindgen-futures = "0.4.29" -log = { workspace = true } +tracing = { workspace = true } rustc-hash = { workspace = true } console_error_panic_hook = { version = "0.1.7", optional = true } futures-util = { workspace = true, features = ["std", "async-await", "async-await-macro"] } @@ -75,3 +75,4 @@ wasm-logger = "0.2.0" gloo-timers = "0.2.3" gloo-dialogs = "0.1.1" dioxus-web = { path = ".", features = ["hydrate"] } +tracing-wasm = "0.2.1" diff --git a/packages/web/README.md b/packages/web/README.md index 87265c926..561da808c 100644 --- a/packages/web/README.md +++ b/packages/web/README.md @@ -7,18 +7,15 @@ [crates-badge]: https://img.shields.io/crates/v/dioxus-web.svg [crates-url]: https://crates.io/crates/dioxus-web - [mit-badge]: https://img.shields.io/badge/license-MIT-blue.svg [mit-url]: https://github.com/dioxuslabs/dioxus/blob/master/LICENSE - [actions-badge]: https://github.com/dioxuslabs/dioxus/actions/workflows/main.yml/badge.svg [actions-url]: https://github.com/dioxuslabs/dioxus/actions?query=workflow%3ACI+branch%3Amaster - [discord-badge]: https://img.shields.io/discord/899851952891002890.svg?logo=discord&style=flat-square [discord-url]: https://discord.gg/XgGxMSkvUM [Website](https://dioxuslabs.com) | -[Guides](https://dioxuslabs.com/docs/0.3/guide/en/) | +[Guides](https://dioxuslabs.com/learn/0.4/) | [API Docs](https://docs.rs/dioxus-web/latest/dioxus_web) | [Chat](https://discord.gg/XgGxMSkvUM) @@ -36,6 +33,7 @@ Run Dioxus in the browser using WebAssembly. - Join the discord and ask questions! ## License + This project is licensed under the [MIT license]. [mit license]: https://github.com/DioxusLabs/dioxus/blob/master/LICENSE-MIT @@ -43,4 +41,3 @@ This project is licensed under the [MIT license]. Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in Dioxus by you shall be licensed as MIT without any additional terms or conditions. - diff --git a/packages/web/examples/hydrate.rs b/packages/web/examples/hydrate.rs index 3491bba81..08c0f95cd 100644 --- a/packages/web/examples/hydrate.rs +++ b/packages/web/examples/hydrate.rs @@ -43,13 +43,13 @@ fn Bapp(cx: Scope) -> Element { fn main() { console_error_panic_hook::set_once(); - wasm_logger::init(wasm_logger::Config::new(log::Level::Trace)); + tracing_wasm::set_as_global_default(); let mut dom = VirtualDom::new(app); let _ = dom.rebuild(); let pre = dioxus_ssr::pre_render(&dom); - log::trace!("{}", pre); + tracing::trace!("{}", pre); // set the inner content of main to the pre-rendered content window() diff --git a/packages/web/src/dom.rs b/packages/web/src/dom.rs index 52f2ab1a9..4fa5c9444 100644 --- a/packages/web/src/dom.rs +++ b/packages/web/src/dom.rs @@ -249,7 +249,6 @@ impl WebsysDom { for id in to_mount { let node = get_node(id.0 as u32); if let Some(element) = node.dyn_ref::() { - log::info!("mounted event fired: {}", id.0); let data: MountedData = element.into(); let data = Rc::new(data); let _ = self.event_channel.unbounded_send(UiEvent { diff --git a/packages/web/src/eval.rs b/packages/web/src/eval.rs index 954bb1b54..eefece50e 100644 --- a/packages/web/src/eval.rs +++ b/packages/web/src/eval.rs @@ -46,7 +46,7 @@ impl WebEvaluator { Ok(data) => _ = channel_sender.send_blocking(data), Err(e) => { // Can't really do much here. - log::error!("failed to serialize JsValue to serde_json::Value (eval communication) - {}", e); + tracing::error!("failed to serialize JsValue to serde_json::Value (eval communication) - {}", e); } } }); diff --git a/packages/web/src/lib.rs b/packages/web/src/lib.rs index 261232607..60f84de37 100644 --- a/packages/web/src/lib.rs +++ b/packages/web/src/lib.rs @@ -170,7 +170,7 @@ pub fn launch_with_props( /// } /// ``` pub async fn run_with_props(root: fn(Scope) -> Element, root_props: T, cfg: Config) { - log::info!("Starting up"); + tracing::info!("Starting up"); let mut dom = VirtualDom::new_with_props(root, root_props); @@ -205,7 +205,7 @@ pub async fn run_with_props(root: fn(Scope) -> Element, root_prop let mut websys_dom = dom::WebsysDom::new(cfg, tx); - log::info!("rebuilding app"); + tracing::info!("rebuilding app"); if should_hydrate { #[cfg(feature = "hydrate")] @@ -217,7 +217,7 @@ pub async fn run_with_props(root: fn(Scope) -> Element, root_prop websys_dom.load_templates(&templates); if let Err(err) = websys_dom.rehydrate(&dom) { - log::error!( + tracing::error!( "Rehydration failed {:?}. Rebuild DOM into element from scratch", &err ); @@ -240,7 +240,7 @@ pub async fn run_with_props(root: fn(Scope) -> Element, root_prop websys_dom.mount(); loop { - log::trace!("waiting for work"); + tracing::trace!("waiting for work"); // if virtualdom has nothing, wait for it to have something before requesting idle time // if there is work then this future resolves immediately. diff --git a/packages/web/src/rehydrate.rs b/packages/web/src/rehydrate.rs index c7ea6d87d..4415ceb37 100644 --- a/packages/web/src/rehydrate.rs +++ b/packages/web/src/rehydrate.rs @@ -114,9 +114,9 @@ impl WebsysDom { node: &TemplateNode, last_node_was_static_text: &mut bool, ) -> Result<(), RehydrationError> { - log::trace!("rehydrate template node: {:?}", node); + tracing::trace!("rehydrate template node: {:?}", node); if let Ok(current_child) = current_child { - if log::log_enabled!(log::Level::Trace) { + if tracing::event_enabled!(tracing::Level::TRACE) { web_sys::console::log_1(¤t_child.clone().into()); } } @@ -203,9 +203,9 @@ impl WebsysDom { dynamic: &DynamicNode, last_node_was_static_text: &mut bool, ) -> Result<(), RehydrationError> { - log::trace!("rehydrate dynamic node: {:?}", dynamic); + tracing::trace!("rehydrate dynamic node: {:?}", dynamic); if let Ok(current_child) = current_child { - if log::log_enabled!(log::Level::Trace) { + if tracing::event_enabled!(tracing::Level::TRACE) { web_sys::console::log_1(¤t_child.clone().into()); } } diff --git a/translations/ja-jp/README.md b/translations/ja-jp/README.md index 342a99cdb..b678eb989 100644 --- a/translations/ja-jp/README.md +++ b/translations/ja-jp/README.md @@ -40,7 +40,7 @@ | δΎ‹ | - ガむド + ガむド | δΈ­ζ–‡ | From 98335bd9a6aec30c0f3d32319a076732015d852a Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Sun, 17 Sep 2023 20:00:22 -0500 Subject: [PATCH 105/447] Merge branch 'master' into fix-event-bubbling --- .github/workflows/docs.yml | 13 +- Cargo.toml | 5 +- docs/.nojekyll | 0 docs/README.md | 19 - docs/fermi/.gitignore | 1 - docs/fermi/book.toml | 6 - docs/fermi/src/SUMMARY.md | 3 - docs/fermi/src/chapter_1.md | 1 - docs/guide/.gitignore | 1 - docs/guide/Cargo.toml | 27 - docs/guide/book.toml | 40 -- docs/guide/examples/Readme.md | 1 - docs/guide/examples/anti_patterns.rs | 71 --- docs/guide/examples/boolean_attribute.rs | 18 - .../examples/component_borrowed_props.rs | 27 - docs/guide/examples/component_children.rs | 36 -- .../examples/component_children_inspect.rs | 37 -- .../guide/examples/component_element_props.rs | 36 -- docs/guide/examples/component_owned_props.rs | 34 -- .../guide/examples/component_props_options.rs | 110 ---- docs/guide/examples/components.rs | 24 - docs/guide/examples/conditional_rendering.rs | 97 ---- docs/guide/examples/custom_renderer.rs | 311 ----------- docs/guide/examples/dangerous_inner_html.rs | 20 - docs/guide/examples/event_click.rs | 18 - docs/guide/examples/event_handler_prop.rs | 32 -- docs/guide/examples/event_nested.rs | 25 - docs/guide/examples/event_prevent_default.rs | 17 - docs/guide/examples/hello_world_desktop.rs | 21 - docs/guide/examples/hello_world_liveview.rs | 60 --- docs/guide/examples/hello_world_ssr.rs | 63 --- docs/guide/examples/hello_world_tui.rs | 17 - .../examples/hello_world_tui_no_ctrl_c.rs | 36 -- docs/guide/examples/hello_world_web.rs | 17 - docs/guide/examples/hooks_anti_patterns.rs | 38 -- docs/guide/examples/hooks_bad.rs | 68 --- docs/guide/examples/hooks_composed.rs | 67 --- docs/guide/examples/hooks_counter.rs | 31 -- .../guide/examples/hooks_counter_two_state.rs | 24 - docs/guide/examples/hooks_custom_logic.rs | 57 -- docs/guide/examples/hooks_use_ref.rs | 22 - docs/guide/examples/hydration.rs | 34 -- docs/guide/examples/hydration_props.rs | 74 --- docs/guide/examples/input_controlled.rs | 21 - docs/guide/examples/input_uncontrolled.rs | 22 - docs/guide/examples/meme_editor.rs | 104 ---- docs/guide/examples/meme_editor_dark_mode.rs | 185 ------- docs/guide/examples/readme_expanded.rs | 106 ---- docs/guide/examples/rendering_lists.rs | 98 ---- docs/guide/examples/rsx_overview.rs | 169 ------ docs/guide/examples/server_basic.rs | 30 -- docs/guide/examples/server_context.rs | 109 ---- docs/guide/examples/server_context_state.rs | 134 ----- docs/guide/examples/server_function.rs | 96 ---- docs/guide/examples/spawn.rs | 84 --- docs/guide/examples/use_future.rs | 62 --- docs/guide/src/en/SUMMARY.md | 57 -- docs/guide/src/en/__unused/README.md | 6 - .../advanced-guides/06-subscription-api.md | 33 -- .../advanced-guides/10-concurrent-mode.md | 82 --- .../__unused/advanced-guides/11-arena-memo.md | 58 -- .../en/__unused/advanced-guides/12-signals.md | 150 ------ .../__unused/advanced-guides/13-subtrees.md | 52 -- .../advanced-guides/custom-renderer.md | 280 ---------- .../en/__unused/advanced-guides/liveview.md | 32 -- .../src/en/__unused/advanced-guides/rsx.md | 67 --- .../en/__unused/advanced-guides/testing.md | 29 - .../src/en/__unused/attribute_spreading.md | 30 -- docs/guide/src/en/__unused/composing.md | 244 --------- .../guide/src/en/__unused/event_javascript.rs | 26 - docs/guide/src/en/__unused/fanout.md | 61 --- docs/guide/src/en/__unused/hello_world.md | 14 - docs/guide/src/en/__unused/helpers.md | 47 -- docs/guide/src/en/__unused/index.md | 36 -- docs/guide/src/en/__unused/localstate.md | 107 ---- docs/guide/src/en/__unused/memoization.md | 26 - docs/guide/src/en/__unused/model_pattern.md | 64 --- docs/guide/src/en/async/index.md | 9 - docs/guide/src/en/async/spawn.md | 19 - docs/guide/src/en/async/use_coroutine.md | 204 ------- docs/guide/src/en/async/use_effect.md | 41 -- docs/guide/src/en/async/use_future.md | 31 -- .../src/en/best_practices/antipatterns.md | 33 -- .../src/en/best_practices/error_handling.md | 153 ------ docs/guide/src/en/best_practices/index.md | 14 - .../src/en/contributing/guiding_principles.md | 37 -- docs/guide/src/en/contributing/index.md | 57 -- .../src/en/contributing/project_structure.md | 50 -- docs/guide/src/en/contributing/roadmap.md | 138 ----- .../src/en/contributing/walkthrough_readme.md | 136 ----- docs/guide/src/en/custom_renderer/index.md | 413 -------------- .../en/describing_ui/component_children.md | 31 -- .../src/en/describing_ui/component_props.md | 144 ----- docs/guide/src/en/describing_ui/components.md | 27 - .../component_borrowed_props_screenshot.png | Bin 7868 -> 0 bytes .../component_owned_props_screenshot.png | Bin 6318 -> 0 bytes .../images/screenshot_about_component.png | Bin 19470 -> 0 bytes docs/guide/src/en/describing_ui/index.md | 142 ----- .../en/describing_ui/special_attributes.md | 62 --- .../guide/src/en/fullstack/getting_started.md | 102 ---- docs/guide/src/en/fullstack/index.md | 59 -- .../src/en/fullstack/server_functions.md | 31 -- docs/guide/src/en/getting_started/desktop.md | 77 --- .../guide/src/en/getting_started/fullstack.md | 1 - .../src/en/getting_started/hot_reload.md | 60 --- docs/guide/src/en/getting_started/index.md | 34 -- docs/guide/src/en/getting_started/liveview.md | 62 --- docs/guide/src/en/getting_started/mobile.md | 76 --- docs/guide/src/en/getting_started/ssr.md | 71 --- docs/guide/src/en/getting_started/tui.md | 46 -- docs/guide/src/en/getting_started/web.md | 63 --- .../src/en/images/compiletimecorrect.png | Bin 196054 -> 0 bytes docs/guide/src/en/images/component_tree.png | Bin 3724 -> 0 bytes docs/guide/src/en/images/diffing.png | Bin 23486 -> 0 bytes docs/guide/src/en/images/dioxuslogo_full.png | Bin 59292 -> 0 bytes docs/guide/src/en/images/oldnew.png | Bin 124296 -> 0 bytes docs/guide/src/en/images/publish.png | Bin 278470 -> 0 bytes docs/guide/src/en/index.md | 52 -- .../src/en/interactivity/custom_hooks.md | 91 ---- .../src/en/interactivity/dynamic_rendering.md | 86 --- .../src/en/interactivity/event_handlers.md | 72 --- docs/guide/src/en/interactivity/hooks.md | 106 ---- .../src/en/interactivity/images/counter.png | Bin 11368 -> 0 bytes .../images/counter_two_state.png | Bin 14503 -> 0 bytes .../images/meme_editor_screenshot.png | Bin 371060 -> 0 bytes docs/guide/src/en/interactivity/index.md | 3 - .../guide/src/en/interactivity/memoization.md | 19 - docs/guide/src/en/interactivity/router.md | 83 --- .../src/en/interactivity/sharing_state.md | 71 --- docs/guide/src/en/interactivity/user_input.md | 33 -- docs/guide/src/en/lib.rs | 1 - docs/guide/src/en/publishing/desktop.md | 65 --- docs/guide/src/en/publishing/index.md | 1 - docs/guide/src/en/publishing/web.md | 8 - docs/guide/src/pt-br/SUMMARY.md | 43 -- docs/guide/src/pt-br/async/index.md | 9 - docs/guide/src/pt-br/async/spawn.md | 29 - docs/guide/src/pt-br/async/use_coroutine.md | 181 ------- docs/guide/src/pt-br/async/use_future.md | 31 -- .../src/pt-br/best_practices/antipatterns.md | 33 -- .../pt-br/best_practices/error_handling.md | 153 ------ docs/guide/src/pt-br/best_practices/index.md | 14 - docs/guide/src/pt-br/contributing.md | 20 - docs/guide/src/pt-br/custom_renderer/index.md | 505 ------------------ .../pt-br/describing_ui/component_children.md | 31 -- .../pt-br/describing_ui/component_props.md | 142 ----- .../src/pt-br/describing_ui/components.md | 27 - .../component_borrowed_props_screenshot.png | Bin 7868 -> 0 bytes .../component_owned_props_screenshot.png | Bin 6318 -> 0 bytes .../images/screenshot_about_component.png | Bin 19470 -> 0 bytes docs/guide/src/pt-br/describing_ui/index.md | 116 ---- .../pt-br/describing_ui/special_attributes.md | 62 --- .../src/pt-br/getting_started/desktop.md | 40 -- .../src/pt-br/getting_started/hot_reload.md | 31 -- docs/guide/src/pt-br/getting_started/index.md | 72 --- .../guide/src/pt-br/getting_started/mobile.md | 76 --- docs/guide/src/pt-br/getting_started/ssr.md | 110 ---- docs/guide/src/pt-br/getting_started/tui.md | 46 -- docs/guide/src/pt-br/getting_started/web.md | 75 --- .../src/pt-br/images/compiletimecorrect.png | Bin 196054 -> 0 bytes .../guide/src/pt-br/images/component_tree.png | Bin 3724 -> 0 bytes docs/guide/src/pt-br/images/diffing.png | Bin 23486 -> 0 bytes .../src/pt-br/images/dioxuslogo_full.png | Bin 59292 -> 0 bytes docs/guide/src/pt-br/images/oldnew.png | Bin 124296 -> 0 bytes docs/guide/src/pt-br/images/publish.png | Bin 278470 -> 0 bytes docs/guide/src/pt-br/index.md | 52 -- .../src/pt-br/interactivity/custom_hooks.md | 26 - .../pt-br/interactivity/dynamic_rendering.md | 71 --- .../src/pt-br/interactivity/event_handlers.md | 68 --- docs/guide/src/pt-br/interactivity/hooks.md | 87 --- .../pt-br/interactivity/images/counter.png | Bin 11368 -> 0 bytes .../images/counter_two_state.png | Bin 14503 -> 0 bytes .../images/meme_editor_screenshot.png | Bin 371060 -> 0 bytes docs/guide/src/pt-br/interactivity/index.md | 3 - .../guide/src/pt-br/interactivity/roteador.md | 1 - docs/guide/src/pt-br/interactivity/router.md | 83 --- .../src/pt-br/interactivity/sharing_state.md | 71 --- .../src/pt-br/interactivity/user_input.md | 33 -- docs/guide/src/pt-br/lib.rs | 1 - docs/guide/src/pt-br/publishing/desktop.md | 54 -- docs/guide/src/pt-br/publishing/index.md | 1 - docs/guide/src/pt-br/publishing/web.md | 9 - docs/guide/src/pt-br/roadmap.md | 138 ----- docs/posts/release-0-2-0.md | 361 ------------- docs/posts/release.md | 406 -------------- docs/router/.gitignore | 1 - docs/router/Cargo.toml | 14 - docs/router/README.md | 7 - docs/router/book.toml | 9 - docs/router/examples/catch_all.rs | 48 -- docs/router/examples/catch_all_segments.rs | 24 - docs/router/examples/dynamic_route.rs | 115 ---- docs/router/examples/dynamic_segments.rs | 35 -- docs/router/examples/external_link.rs | 28 - docs/router/examples/first_route.rs | 36 -- docs/router/examples/full_example.rs | 112 ---- docs/router/examples/history_buttons.rs | 30 -- docs/router/examples/history_provider.rs | 29 - docs/router/examples/links.rs | 72 --- docs/router/examples/navigator.rs | 56 -- docs/router/examples/nest.rs | 40 -- docs/router/examples/nested_routes.rs | 66 --- docs/router/examples/outlet.rs | 46 -- docs/router/examples/query_segments.rs | 24 - docs/router/examples/router_cfg.rs | 37 -- docs/router/examples/routing_update.rs | 41 -- docs/router/examples/static_segments.rs | 28 - docs/router/src/SUMMARY.md | 25 - docs/router/src/example/building-a-nest.md | 99 ---- docs/router/src/example/first-route.md | 62 --- docs/router/src/example/full-code.md | 5 - docs/router/src/example/index.md | 29 - docs/router/src/example/navigation-targets.md | 27 - .../src/example/redirection-perfection.md | 41 -- docs/router/src/index.md | 27 - docs/router/src/lib.rs | 1 - docs/router/src/reference/history-buttons.md | 32 -- .../router/src/reference/history-providers.md | 20 - docs/router/src/reference/index.md | 23 - docs/router/src/reference/layouts.md | 19 - docs/router/src/reference/navigation/index.md | 39 -- .../src/reference/navigation/programmatic.md | 32 -- docs/router/src/reference/redirects.md | 13 - docs/router/src/reference/routes/index.md | 65 --- docs/router/src/reference/routes/nested.md | 39 -- .../src/reference/routing-update-callback.md | 25 - .../router/src/reference/static-generation.md | 15 - examples/crm.rs | 8 +- examples/dog_app.rs | 11 +- examples/error_handle.rs | 11 +- examples/flat_router.rs | 17 +- examples/inlineprops.rs | 20 +- examples/link.rs | 13 +- examples/query_segments_demo/src/main.rs | 5 +- examples/router.rs | 11 +- examples/rsx_usage.rs | 27 +- examples/shared_state.rs | 7 +- examples/simple_desktop.rs | 15 +- examples/simple_router.rs | 6 +- packages/autofmt/README.md | 10 +- packages/autofmt/tests/samples/long.rsx | 2 +- packages/check/README.md | 10 +- packages/check/src/issues.rs | 6 +- packages/cli/src/server/desktop/mod.rs | 113 ++-- packages/cli/src/server/mod.rs | 200 +++---- packages/cli/src/server/web/hot_reload.rs | 16 +- packages/cli/src/server/web/mod.rs | 117 +--- packages/core-macro/Cargo.toml | 2 + packages/core-macro/README.md | 9 +- packages/core-macro/src/component_body/mod.rs | 237 ++++++++ .../core-macro/src/component_body/utils.rs | 57 ++ .../component_body_deserializers/component.rs | 152 ++++++ .../inline_props.rs | 195 +++++++ .../src/component_body_deserializers/mod.rs | 4 + packages/core-macro/src/inlineprops.rs | 185 ------- packages/core-macro/src/lib.rs | 131 ++++- packages/core-macro/src/props/mod.rs | 55 +- packages/core/Cargo.toml | 2 +- packages/core/src/any_props.rs | 2 +- packages/core/src/diff.rs | 8 +- packages/core/src/error_boundary.rs | 27 +- packages/core/src/events.rs | 2 +- packages/core/src/lib.rs | 11 +- packages/core/src/runtime.rs | 57 +- packages/core/src/scope_arena.rs | 1 + packages/core/src/scope_context.rs | 41 +- packages/core/src/virtual_dom.rs | 19 +- packages/core/tests/create_passthru.rs | 35 +- packages/core/tests/miri_full_app.rs | 11 +- packages/core/tests/miri_simple.rs | 42 +- packages/desktop/Cargo.toml | 12 +- packages/desktop/README.md | 12 +- packages/desktop/src/desktop_context.rs | 4 +- packages/desktop/src/lib.rs | 2 +- packages/desktop/src/query.rs | 2 +- packages/desktop/src/readme.md | 4 +- packages/dioxus-tui/Cargo.toml | 2 +- packages/dioxus/Cargo.toml | 4 +- packages/dioxus/README.md | 65 ++- packages/dioxus/src/lib.rs | 3 +- packages/fermi/Cargo.toml | 2 +- packages/fermi/src/root.rs | 8 +- packages/fullstack/Cargo.toml | 3 +- packages/fullstack/README.md | 2 +- .../examples/axum-hello-world/Cargo.toml | 5 +- .../examples/axum-hello-world/src/main.rs | 5 +- .../examples/axum-router/src/main.rs | 6 +- .../examples/salvo-hello-world/Cargo.toml | 5 +- .../examples/salvo-hello-world/src/main.rs | 4 +- .../examples/static-hydrated/src/main.rs | 6 +- .../examples/warp-hello-world/Cargo.toml | 5 +- .../examples/warp-hello-world/src/main.rs | 4 +- .../fullstack/src/adapters/axum_adapter.rs | 6 +- .../fullstack/src/adapters/salvo_adapter.rs | 2 +- .../fullstack/src/adapters/warp_adapter.rs | 18 +- packages/fullstack/src/hooks/server_cached.rs | 2 +- packages/fullstack/src/hooks/server_future.rs | 8 +- packages/fullstack/src/hot_reload.rs | 2 +- .../fullstack/src/html_storage/deserialize.rs | 8 +- packages/fullstack/src/html_storage/mod.rs | 4 +- packages/fullstack/src/layer.rs | 7 +- packages/fullstack/src/render.rs | 8 +- packages/fullstack/src/router.rs | 2 +- packages/hooks/Cargo.toml | 2 +- packages/hooks/README.md | 9 +- packages/hooks/src/computed.rs | 3 +- packages/hooks/src/use_shared_state.rs | 21 +- packages/hooks/src/useeffect.rs | 6 +- packages/hooks/src/usefuture.rs | 2 +- packages/hooks/src/usememo.rs | 7 +- packages/hot-reload/Cargo.toml | 2 +- packages/hot-reload/README.md | 15 +- packages/html/README.md | 15 +- packages/html/src/events/mouse.rs | 2 +- packages/interpreter/README.md | 9 +- packages/interpreter/src/interpreter.js | 40 +- packages/liveview/Cargo.toml | 4 +- packages/liveview/README.md | 8 +- packages/liveview/src/query.rs | 2 +- packages/mobile/Cargo.toml | 2 +- packages/mobile/README.md | 13 +- packages/native-core-macro/README.md | 8 +- packages/router-macro/src/lib.rs | 10 +- packages/router-macro/src/route.rs | 6 +- packages/router-macro/src/segment.rs | 2 +- packages/router/Cargo.toml | 2 +- packages/router/README.md | 14 +- packages/router/benches/incremental.rs | 12 +- packages/router/examples/simple_routes.rs | 15 +- packages/router/examples/static_generation.rs | 10 +- .../router/src/components/history_buttons.rs | 12 +- packages/router/src/components/link.rs | 7 +- packages/router/src/components/outlet.rs | 7 +- packages/router/src/history/memory.rs | 4 +- packages/router/src/history/mod.rs | 31 +- packages/router/src/history/web.rs | 14 +- packages/router/src/history/web_hash.rs | 2 +- packages/router/src/hooks/use_navigator.rs | 5 +- packages/router/src/hooks/use_route.rs | 7 +- packages/router/src/incremental.rs | 8 +- packages/router/src/navigation.rs | 4 +- packages/router/src/routable.rs | 164 +++--- packages/router/src/router_cfg.rs | 2 +- packages/router/tests/via_ssr/link.rs | 48 +- packages/router/tests/via_ssr/outlet.rs | 17 +- packages/rsx-rosetta/README.md | 9 +- packages/rsx/README.md | 8 +- packages/signals/Cargo.toml | 2 +- packages/signals/README.md | 20 +- packages/signals/examples/selector.rs | 9 +- packages/signals/src/effect.rs | 5 +- packages/signals/src/rt.rs | 25 +- packages/signals/src/selector.rs | 1 + packages/signals/src/signal.rs | 11 +- packages/ssr/Cargo.toml | 5 +- packages/ssr/README.md | 13 +- packages/ssr/src/cache.rs | 6 + packages/ssr/src/incremental.rs | 10 +- packages/ssr/src/renderer.rs | 111 +++- packages/ssr/tests/bool_attr.rs | 37 ++ packages/ssr/tests/simple.rs | 11 +- packages/web/Cargo.toml | 5 +- packages/web/README.md | 7 +- packages/web/examples/hydrate.rs | 4 +- packages/web/src/eval.rs | 2 +- packages/web/src/lib.rs | 8 +- packages/web/src/rehydrate.rs | 8 +- translations/ja-jp/README.md | 2 +- 368 files changed, 1877 insertions(+), 13498 deletions(-) delete mode 100644 docs/.nojekyll delete mode 100644 docs/README.md delete mode 100644 docs/fermi/.gitignore delete mode 100644 docs/fermi/book.toml delete mode 100644 docs/fermi/src/SUMMARY.md delete mode 100644 docs/fermi/src/chapter_1.md delete mode 100644 docs/guide/.gitignore delete mode 100644 docs/guide/Cargo.toml delete mode 100644 docs/guide/book.toml delete mode 100644 docs/guide/examples/Readme.md delete mode 100644 docs/guide/examples/anti_patterns.rs delete mode 100644 docs/guide/examples/boolean_attribute.rs delete mode 100644 docs/guide/examples/component_borrowed_props.rs delete mode 100644 docs/guide/examples/component_children.rs delete mode 100644 docs/guide/examples/component_children_inspect.rs delete mode 100644 docs/guide/examples/component_element_props.rs delete mode 100644 docs/guide/examples/component_owned_props.rs delete mode 100644 docs/guide/examples/component_props_options.rs delete mode 100644 docs/guide/examples/components.rs delete mode 100644 docs/guide/examples/conditional_rendering.rs delete mode 100644 docs/guide/examples/custom_renderer.rs delete mode 100644 docs/guide/examples/dangerous_inner_html.rs delete mode 100644 docs/guide/examples/event_click.rs delete mode 100644 docs/guide/examples/event_handler_prop.rs delete mode 100644 docs/guide/examples/event_nested.rs delete mode 100644 docs/guide/examples/event_prevent_default.rs delete mode 100644 docs/guide/examples/hello_world_desktop.rs delete mode 100644 docs/guide/examples/hello_world_liveview.rs delete mode 100644 docs/guide/examples/hello_world_ssr.rs delete mode 100644 docs/guide/examples/hello_world_tui.rs delete mode 100644 docs/guide/examples/hello_world_tui_no_ctrl_c.rs delete mode 100644 docs/guide/examples/hello_world_web.rs delete mode 100644 docs/guide/examples/hooks_anti_patterns.rs delete mode 100644 docs/guide/examples/hooks_bad.rs delete mode 100644 docs/guide/examples/hooks_composed.rs delete mode 100644 docs/guide/examples/hooks_counter.rs delete mode 100644 docs/guide/examples/hooks_counter_two_state.rs delete mode 100644 docs/guide/examples/hooks_custom_logic.rs delete mode 100644 docs/guide/examples/hooks_use_ref.rs delete mode 100644 docs/guide/examples/hydration.rs delete mode 100644 docs/guide/examples/hydration_props.rs delete mode 100644 docs/guide/examples/input_controlled.rs delete mode 100644 docs/guide/examples/input_uncontrolled.rs delete mode 100644 docs/guide/examples/meme_editor.rs delete mode 100644 docs/guide/examples/meme_editor_dark_mode.rs delete mode 100644 docs/guide/examples/readme_expanded.rs delete mode 100644 docs/guide/examples/rendering_lists.rs delete mode 100644 docs/guide/examples/rsx_overview.rs delete mode 100644 docs/guide/examples/server_basic.rs delete mode 100644 docs/guide/examples/server_context.rs delete mode 100644 docs/guide/examples/server_context_state.rs delete mode 100644 docs/guide/examples/server_function.rs delete mode 100644 docs/guide/examples/spawn.rs delete mode 100644 docs/guide/examples/use_future.rs delete mode 100644 docs/guide/src/en/SUMMARY.md delete mode 100644 docs/guide/src/en/__unused/README.md delete mode 100644 docs/guide/src/en/__unused/advanced-guides/06-subscription-api.md delete mode 100644 docs/guide/src/en/__unused/advanced-guides/10-concurrent-mode.md delete mode 100644 docs/guide/src/en/__unused/advanced-guides/11-arena-memo.md delete mode 100644 docs/guide/src/en/__unused/advanced-guides/12-signals.md delete mode 100644 docs/guide/src/en/__unused/advanced-guides/13-subtrees.md delete mode 100644 docs/guide/src/en/__unused/advanced-guides/custom-renderer.md delete mode 100644 docs/guide/src/en/__unused/advanced-guides/liveview.md delete mode 100644 docs/guide/src/en/__unused/advanced-guides/rsx.md delete mode 100644 docs/guide/src/en/__unused/advanced-guides/testing.md delete mode 100644 docs/guide/src/en/__unused/attribute_spreading.md delete mode 100644 docs/guide/src/en/__unused/composing.md delete mode 100644 docs/guide/src/en/__unused/event_javascript.rs delete mode 100644 docs/guide/src/en/__unused/fanout.md delete mode 100644 docs/guide/src/en/__unused/hello_world.md delete mode 100644 docs/guide/src/en/__unused/helpers.md delete mode 100644 docs/guide/src/en/__unused/index.md delete mode 100644 docs/guide/src/en/__unused/localstate.md delete mode 100644 docs/guide/src/en/__unused/memoization.md delete mode 100644 docs/guide/src/en/__unused/model_pattern.md delete mode 100644 docs/guide/src/en/async/index.md delete mode 100644 docs/guide/src/en/async/spawn.md delete mode 100644 docs/guide/src/en/async/use_coroutine.md delete mode 100644 docs/guide/src/en/async/use_effect.md delete mode 100644 docs/guide/src/en/async/use_future.md delete mode 100644 docs/guide/src/en/best_practices/antipatterns.md delete mode 100644 docs/guide/src/en/best_practices/error_handling.md delete mode 100644 docs/guide/src/en/best_practices/index.md delete mode 100644 docs/guide/src/en/contributing/guiding_principles.md delete mode 100644 docs/guide/src/en/contributing/index.md delete mode 100644 docs/guide/src/en/contributing/project_structure.md delete mode 100644 docs/guide/src/en/contributing/roadmap.md delete mode 100644 docs/guide/src/en/contributing/walkthrough_readme.md delete mode 100644 docs/guide/src/en/custom_renderer/index.md delete mode 100644 docs/guide/src/en/describing_ui/component_children.md delete mode 100644 docs/guide/src/en/describing_ui/component_props.md delete mode 100644 docs/guide/src/en/describing_ui/components.md delete mode 100644 docs/guide/src/en/describing_ui/images/component_borrowed_props_screenshot.png delete mode 100644 docs/guide/src/en/describing_ui/images/component_owned_props_screenshot.png delete mode 100644 docs/guide/src/en/describing_ui/images/screenshot_about_component.png delete mode 100644 docs/guide/src/en/describing_ui/index.md delete mode 100644 docs/guide/src/en/describing_ui/special_attributes.md delete mode 100644 docs/guide/src/en/fullstack/getting_started.md delete mode 100644 docs/guide/src/en/fullstack/index.md delete mode 100644 docs/guide/src/en/fullstack/server_functions.md delete mode 100644 docs/guide/src/en/getting_started/desktop.md delete mode 100644 docs/guide/src/en/getting_started/fullstack.md delete mode 100644 docs/guide/src/en/getting_started/hot_reload.md delete mode 100644 docs/guide/src/en/getting_started/index.md delete mode 100644 docs/guide/src/en/getting_started/liveview.md delete mode 100644 docs/guide/src/en/getting_started/mobile.md delete mode 100644 docs/guide/src/en/getting_started/ssr.md delete mode 100644 docs/guide/src/en/getting_started/tui.md delete mode 100644 docs/guide/src/en/getting_started/web.md delete mode 100644 docs/guide/src/en/images/compiletimecorrect.png delete mode 100644 docs/guide/src/en/images/component_tree.png delete mode 100644 docs/guide/src/en/images/diffing.png delete mode 100644 docs/guide/src/en/images/dioxuslogo_full.png delete mode 100644 docs/guide/src/en/images/oldnew.png delete mode 100644 docs/guide/src/en/images/publish.png delete mode 100644 docs/guide/src/en/index.md delete mode 100644 docs/guide/src/en/interactivity/custom_hooks.md delete mode 100644 docs/guide/src/en/interactivity/dynamic_rendering.md delete mode 100644 docs/guide/src/en/interactivity/event_handlers.md delete mode 100644 docs/guide/src/en/interactivity/hooks.md delete mode 100644 docs/guide/src/en/interactivity/images/counter.png delete mode 100644 docs/guide/src/en/interactivity/images/counter_two_state.png delete mode 100644 docs/guide/src/en/interactivity/images/meme_editor_screenshot.png delete mode 100644 docs/guide/src/en/interactivity/index.md delete mode 100644 docs/guide/src/en/interactivity/memoization.md delete mode 100644 docs/guide/src/en/interactivity/router.md delete mode 100644 docs/guide/src/en/interactivity/sharing_state.md delete mode 100644 docs/guide/src/en/interactivity/user_input.md delete mode 100644 docs/guide/src/en/lib.rs delete mode 100644 docs/guide/src/en/publishing/desktop.md delete mode 100644 docs/guide/src/en/publishing/index.md delete mode 100644 docs/guide/src/en/publishing/web.md delete mode 100644 docs/guide/src/pt-br/SUMMARY.md delete mode 100644 docs/guide/src/pt-br/async/index.md delete mode 100644 docs/guide/src/pt-br/async/spawn.md delete mode 100644 docs/guide/src/pt-br/async/use_coroutine.md delete mode 100644 docs/guide/src/pt-br/async/use_future.md delete mode 100644 docs/guide/src/pt-br/best_practices/antipatterns.md delete mode 100644 docs/guide/src/pt-br/best_practices/error_handling.md delete mode 100644 docs/guide/src/pt-br/best_practices/index.md delete mode 100644 docs/guide/src/pt-br/contributing.md delete mode 100644 docs/guide/src/pt-br/custom_renderer/index.md delete mode 100644 docs/guide/src/pt-br/describing_ui/component_children.md delete mode 100644 docs/guide/src/pt-br/describing_ui/component_props.md delete mode 100644 docs/guide/src/pt-br/describing_ui/components.md delete mode 100644 docs/guide/src/pt-br/describing_ui/images/component_borrowed_props_screenshot.png delete mode 100644 docs/guide/src/pt-br/describing_ui/images/component_owned_props_screenshot.png delete mode 100644 docs/guide/src/pt-br/describing_ui/images/screenshot_about_component.png delete mode 100644 docs/guide/src/pt-br/describing_ui/index.md delete mode 100644 docs/guide/src/pt-br/describing_ui/special_attributes.md delete mode 100644 docs/guide/src/pt-br/getting_started/desktop.md delete mode 100644 docs/guide/src/pt-br/getting_started/hot_reload.md delete mode 100644 docs/guide/src/pt-br/getting_started/index.md delete mode 100644 docs/guide/src/pt-br/getting_started/mobile.md delete mode 100644 docs/guide/src/pt-br/getting_started/ssr.md delete mode 100644 docs/guide/src/pt-br/getting_started/tui.md delete mode 100644 docs/guide/src/pt-br/getting_started/web.md delete mode 100644 docs/guide/src/pt-br/images/compiletimecorrect.png delete mode 100644 docs/guide/src/pt-br/images/component_tree.png delete mode 100644 docs/guide/src/pt-br/images/diffing.png delete mode 100644 docs/guide/src/pt-br/images/dioxuslogo_full.png delete mode 100644 docs/guide/src/pt-br/images/oldnew.png delete mode 100644 docs/guide/src/pt-br/images/publish.png delete mode 100644 docs/guide/src/pt-br/index.md delete mode 100644 docs/guide/src/pt-br/interactivity/custom_hooks.md delete mode 100644 docs/guide/src/pt-br/interactivity/dynamic_rendering.md delete mode 100644 docs/guide/src/pt-br/interactivity/event_handlers.md delete mode 100644 docs/guide/src/pt-br/interactivity/hooks.md delete mode 100644 docs/guide/src/pt-br/interactivity/images/counter.png delete mode 100644 docs/guide/src/pt-br/interactivity/images/counter_two_state.png delete mode 100644 docs/guide/src/pt-br/interactivity/images/meme_editor_screenshot.png delete mode 100644 docs/guide/src/pt-br/interactivity/index.md delete mode 100644 docs/guide/src/pt-br/interactivity/roteador.md delete mode 100644 docs/guide/src/pt-br/interactivity/router.md delete mode 100644 docs/guide/src/pt-br/interactivity/sharing_state.md delete mode 100644 docs/guide/src/pt-br/interactivity/user_input.md delete mode 100644 docs/guide/src/pt-br/lib.rs delete mode 100644 docs/guide/src/pt-br/publishing/desktop.md delete mode 100644 docs/guide/src/pt-br/publishing/index.md delete mode 100644 docs/guide/src/pt-br/publishing/web.md delete mode 100644 docs/guide/src/pt-br/roadmap.md delete mode 100644 docs/posts/release-0-2-0.md delete mode 100644 docs/posts/release.md delete mode 100644 docs/router/.gitignore delete mode 100644 docs/router/Cargo.toml delete mode 100644 docs/router/README.md delete mode 100644 docs/router/book.toml delete mode 100644 docs/router/examples/catch_all.rs delete mode 100644 docs/router/examples/catch_all_segments.rs delete mode 100644 docs/router/examples/dynamic_route.rs delete mode 100644 docs/router/examples/dynamic_segments.rs delete mode 100644 docs/router/examples/external_link.rs delete mode 100644 docs/router/examples/first_route.rs delete mode 100644 docs/router/examples/full_example.rs delete mode 100644 docs/router/examples/history_buttons.rs delete mode 100644 docs/router/examples/history_provider.rs delete mode 100644 docs/router/examples/links.rs delete mode 100644 docs/router/examples/navigator.rs delete mode 100644 docs/router/examples/nest.rs delete mode 100644 docs/router/examples/nested_routes.rs delete mode 100644 docs/router/examples/outlet.rs delete mode 100644 docs/router/examples/query_segments.rs delete mode 100644 docs/router/examples/router_cfg.rs delete mode 100644 docs/router/examples/routing_update.rs delete mode 100644 docs/router/examples/static_segments.rs delete mode 100644 docs/router/src/SUMMARY.md delete mode 100644 docs/router/src/example/building-a-nest.md delete mode 100644 docs/router/src/example/first-route.md delete mode 100644 docs/router/src/example/full-code.md delete mode 100644 docs/router/src/example/index.md delete mode 100644 docs/router/src/example/navigation-targets.md delete mode 100644 docs/router/src/example/redirection-perfection.md delete mode 100644 docs/router/src/index.md delete mode 100644 docs/router/src/lib.rs delete mode 100644 docs/router/src/reference/history-buttons.md delete mode 100644 docs/router/src/reference/history-providers.md delete mode 100644 docs/router/src/reference/index.md delete mode 100644 docs/router/src/reference/layouts.md delete mode 100644 docs/router/src/reference/navigation/index.md delete mode 100644 docs/router/src/reference/navigation/programmatic.md delete mode 100644 docs/router/src/reference/redirects.md delete mode 100644 docs/router/src/reference/routes/index.md delete mode 100644 docs/router/src/reference/routes/nested.md delete mode 100644 docs/router/src/reference/routing-update-callback.md delete mode 100644 docs/router/src/reference/static-generation.md create mode 100644 packages/core-macro/src/component_body/mod.rs create mode 100644 packages/core-macro/src/component_body/utils.rs create mode 100644 packages/core-macro/src/component_body_deserializers/component.rs create mode 100644 packages/core-macro/src/component_body_deserializers/inline_props.rs create mode 100644 packages/core-macro/src/component_body_deserializers/mod.rs delete mode 100644 packages/core-macro/src/inlineprops.rs create mode 100644 packages/ssr/tests/bool_attr.rs diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml index 107ad9638..88542aea8 100644 --- a/.github/workflows/docs.yml +++ b/.github/workflows/docs.yml @@ -1,12 +1,13 @@ name: github pages on: - push: - paths: - - docs/** - - .github/workflows/docs.yml - branches: - - master + workflow_dispatch: + # push: + # paths: + # - docs/** + # - .github/workflows/docs.yml + # branches: + # - master concurrency: group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }} diff --git a/Cargo.toml b/Cargo.toml index 54c54ebf1..e6b07eb8c 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -37,8 +37,6 @@ members = [ "packages/fullstack/examples/salvo-hello-world", "packages/fullstack/examples/warp-hello-world", "packages/fullstack/examples/static-hydrated", - "docs/guide", - "docs/router", # Full project examples "examples/tailwind", "examples/PWA-example", @@ -82,7 +80,8 @@ generational-box = { path = "packages/generational-box" } dioxus-hot-reload = { path = "packages/hot-reload", version = "0.4.0" } dioxus-fullstack = { path = "packages/fullstack", version = "0.4.1" } dioxus_server_macro = { path = "packages/server-macro", version = "0.4.1" } -log = "0.4.19" +tracing = "0.1.37" +tracing-futures = "0.2.5" tokio = "1.28" slab = "0.4.2" futures-channel = "0.3.21" diff --git a/docs/.nojekyll b/docs/.nojekyll deleted file mode 100644 index e69de29bb..000000000 diff --git a/docs/README.md b/docs/README.md deleted file mode 100644 index 766752ecf..000000000 --- a/docs/README.md +++ /dev/null @@ -1,19 +0,0 @@ -# Building the Documentation - -Dioxus uses a fork of MdBook with multilanguage support. To build the documentation, you will need to install the forked version of MdBook. - -```sh -cargo install mdbook --git https://github.com/Demonthos/mdBook.git --branch master -``` - -Then, you can build the documentation by running: - -```sh -cd docs -cd guide -mdbook build -d ../nightly/guide -cd .. -cd router -mdbook build -d ../nightly/router -cd ../../ -``` diff --git a/docs/fermi/.gitignore b/docs/fermi/.gitignore deleted file mode 100644 index 7585238ef..000000000 --- a/docs/fermi/.gitignore +++ /dev/null @@ -1 +0,0 @@ -book diff --git a/docs/fermi/book.toml b/docs/fermi/book.toml deleted file mode 100644 index dd6d2eacb..000000000 --- a/docs/fermi/book.toml +++ /dev/null @@ -1,6 +0,0 @@ -[book] -authors = ["Jonathan Kelley"] -language = "en" -multilingual = false -src = "src" -title = "Fermi Guide" diff --git a/docs/fermi/src/SUMMARY.md b/docs/fermi/src/SUMMARY.md deleted file mode 100644 index 7390c8289..000000000 --- a/docs/fermi/src/SUMMARY.md +++ /dev/null @@ -1,3 +0,0 @@ -# Summary - -- [Chapter 1](./chapter_1.md) diff --git a/docs/fermi/src/chapter_1.md b/docs/fermi/src/chapter_1.md deleted file mode 100644 index b743fda35..000000000 --- a/docs/fermi/src/chapter_1.md +++ /dev/null @@ -1 +0,0 @@ -# Chapter 1 diff --git a/docs/guide/.gitignore b/docs/guide/.gitignore deleted file mode 100644 index 3006b271d..000000000 --- a/docs/guide/.gitignore +++ /dev/null @@ -1 +0,0 @@ -book/ diff --git a/docs/guide/Cargo.toml b/docs/guide/Cargo.toml deleted file mode 100644 index c2527b8b4..000000000 --- a/docs/guide/Cargo.toml +++ /dev/null @@ -1,27 +0,0 @@ -[package] -name = "dioxus-guide" -version = "0.0.1" -edition = "2021" -description = "Dioxus guide, including testable examples" -license = "MIT OR Apache-2.0" -publish = false - -[dev-dependencies] -dioxus = { path = "../../packages/dioxus" } -dioxus-desktop = { path = "../../packages/desktop" } -dioxus-web = { path = "../../packages/web" } -dioxus-ssr = { path = "../../packages/ssr" } -dioxus-native-core = { path = "../../packages/native-core" } -dioxus-native-core-macro = { path = "../../packages/native-core-macro" } -dioxus-router = { path = "../../packages/router" } -dioxus-liveview = { path = "../../packages/liveview", features = ["axum"] } -dioxus-tui = { path = "../../packages/dioxus-tui" } -dioxus-fullstack = { path = "../../packages/fullstack" } -# dioxus = { path = "../../packages/dioxus", features = ["desktop", "web", "ssr", "router", "fermi", "tui"] } -fermi = { path = "../../packages/fermi" } -shipyard = "0.6.2" -serde = { version = "1.0.138", features=["derive"] } -reqwest = { version = "0.11.11", features = ["json"] } -tokio = { version = "1.19.2", features = ["full"] } -axum = { version = "0.6.1", features = ["ws"] } -gloo-storage = "0.2.2" diff --git a/docs/guide/book.toml b/docs/guide/book.toml deleted file mode 100644 index 1f926256e..000000000 --- a/docs/guide/book.toml +++ /dev/null @@ -1,40 +0,0 @@ -[book.en] -title = "Dioxus Documentation" -description = "Get started with Dioxus, a portable, performant, and ergonomic framework for building cross-platform user interfaces in Rust" -authors = ["Jonathan Kelley"] -language = "en" - -[language.en] -name = "English" - -[language.pt-br] -name = "PortuguΓͺs Brasileiro" -title = "Documentação do Dioxus" -description = "Introdução ao Dioxus, um framework portΓ‘til, de alto desempenho e ergonΓ΄mico para criar interfaces de usuΓ‘rio multiplataforma em Rust." - -[rust] -edition = "2018" - -[output.html] -mathjax-support = true -site-url = "/mdBook/" -git-repository-url = "https://github.com/DioxusLabs/dioxus/edit/master/docs/guide" -edit-url-template = "https://github.com/DioxusLabs/dioxus/edit/master/docs/guide/{path}" - -[output.html.playground] -editable = true -line-numbers = true -# running examples will not work because dioxus is not a included in the playground -runnable = false - -[output.html.search] -limit-results = 20 -use-boolean-and = true -boost-title = 2 -boost-hierarchy = 2 -boost-paragraph = 1 -expand = true -heading-split-level = 2 - -# [output.html.redirect] -# "/format/config.html" = "configuration/index.html" diff --git a/docs/guide/examples/Readme.md b/docs/guide/examples/Readme.md deleted file mode 100644 index 891fc8fe4..000000000 --- a/docs/guide/examples/Readme.md +++ /dev/null @@ -1 +0,0 @@ -Some of these examples (e.g. web) cannot be run. The code samples are here mostly so that we can easily check that they compile using `cargo test`. \ No newline at end of file diff --git a/docs/guide/examples/anti_patterns.rs b/docs/guide/examples/anti_patterns.rs deleted file mode 100644 index 3911bfa0a..000000000 --- a/docs/guide/examples/anti_patterns.rs +++ /dev/null @@ -1,71 +0,0 @@ -#![allow(non_snake_case, unused)] - -//! This example shows what *not* to do - -use std::collections::HashMap; - -use dioxus::prelude::*; - -fn main() {} - -fn AntipatternNestedFragments(cx: Scope<()>) -> Element { - // ANCHOR: nested_fragments - // ❌ Don't unnecessarily nest fragments - let _ = cx.render(rsx!( - Fragment { - Fragment { - Fragment { - Fragment { - Fragment { - div { "Finally have a real node!" } - } - } - } - } - } - )); - - // βœ… Render shallow structures - cx.render(rsx!( - div { "Finally have a real node!" } - )) - // ANCHOR_END: nested_fragments -} - -#[derive(PartialEq, Props)] -struct NoKeysProps { - data: HashMap, -} - -fn AntipatternNoKeys(cx: Scope) -> Element { - // ANCHOR: iter_keys - let data: &HashMap<_, _> = &cx.props.data; - - // ❌ No keys - cx.render(rsx! { - ul { - data.values().map(|value| rsx!( - li { "List item: {value}" } - )) - } - }); - - // ❌ Using index as keys - cx.render(rsx! { - ul { - cx.props.data.values().enumerate().map(|(index, value)| rsx!( - li { key: "{index}", "List item: {value}" } - )) - } - }); - - // βœ… Using unique IDs as keys: - cx.render(rsx! { - ul { - cx.props.data.iter().map(|(key, value)| rsx!( - li { key: "{key}", "List item: {value}" } - )) - } - }) - // ANCHOR_END: iter_keys -} diff --git a/docs/guide/examples/boolean_attribute.rs b/docs/guide/examples/boolean_attribute.rs deleted file mode 100644 index 685103ccb..000000000 --- a/docs/guide/examples/boolean_attribute.rs +++ /dev/null @@ -1,18 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -#[rustfmt::skip] -fn App(cx: Scope) -> Element { - // ANCHOR: boolean_attribute -cx.render(rsx! { - div { - hidden: "false", - "hello" - } -}) - // ANCHOR_END: boolean_attribute -} diff --git a/docs/guide/examples/component_borrowed_props.rs b/docs/guide/examples/component_borrowed_props.rs deleted file mode 100644 index ee78a1824..000000000 --- a/docs/guide/examples/component_borrowed_props.rs +++ /dev/null @@ -1,27 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -// ANCHOR: App -fn App(cx: Scope) -> Element { - let hello = "Hello Dioxus!"; - - cx.render(rsx!(TitleCard { title: hello })) -} -// ANCHOR_END: App - -// ANCHOR: TitleCard -#[derive(Props)] -struct TitleCardProps<'a> { - title: &'a str, -} - -fn TitleCard<'a>(cx: Scope<'a, TitleCardProps<'a>>) -> Element { - cx.render(rsx! { - h1 { "{cx.props.title}" } - }) -} -// ANCHOR_END: TitleCard diff --git a/docs/guide/examples/component_children.rs b/docs/guide/examples/component_children.rs deleted file mode 100644 index d13a6480d..000000000 --- a/docs/guide/examples/component_children.rs +++ /dev/null @@ -1,36 +0,0 @@ -// ANCHOR: all -#![allow(non_snake_case)] -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -fn App(cx: Scope) -> Element { - // ANCHOR: Clickable_usage - cx.render(rsx! { - Clickable { - href: "https://www.youtube.com/watch?v=C-M2hs3sXGo", - "How to " i {"not"} " be seen" - } - }) - // ANCHOR_END: Clickable_usage -} - -// ANCHOR: Clickable -#[derive(Props)] -struct ClickableProps<'a> { - href: &'a str, - children: Element<'a>, -} - -fn Clickable<'a>(cx: Scope<'a, ClickableProps<'a>>) -> Element { - cx.render(rsx!( - a { - href: "{cx.props.href}", - class: "fancy-button", - &cx.props.children - } - )) -} -// ANCHOR_END: Clickable diff --git a/docs/guide/examples/component_children_inspect.rs b/docs/guide/examples/component_children_inspect.rs deleted file mode 100644 index a79b068a3..000000000 --- a/docs/guide/examples/component_children_inspect.rs +++ /dev/null @@ -1,37 +0,0 @@ -// ANCHOR: all -#![allow(non_snake_case, unused)] -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -fn App(cx: Scope) -> Element { - // ANCHOR: Clickable_usage - cx.render(rsx! { - Clickable { - href: "https://www.youtube.com/watch?v=C-M2hs3sXGo", - "How to " i {"not"} " be seen" - } - }) - // ANCHOR_END: Clickable_usage -} - -#[derive(Props)] -struct ClickableProps<'a> { - href: &'a str, - children: Element<'a>, -} - -// ANCHOR: Clickable -fn Clickable<'a>(cx: Scope<'a, ClickableProps<'a>>) -> Element { - match cx.props.children { - Some(VNode { dynamic_nodes, .. }) => { - todo!("render some stuff") - } - _ => { - todo!("render some other stuff") - } - } -} -// ANCHOR_END: Clickable diff --git a/docs/guide/examples/component_element_props.rs b/docs/guide/examples/component_element_props.rs deleted file mode 100644 index b8fe98879..000000000 --- a/docs/guide/examples/component_element_props.rs +++ /dev/null @@ -1,36 +0,0 @@ -// ANCHOR: all -#![allow(non_snake_case)] -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -fn App(cx: Scope) -> Element { - // ANCHOR: Clickable_usage - cx.render(rsx! { - Clickable { - href: "https://www.youtube.com/watch?v=C-M2hs3sXGo", - body: cx.render(rsx!("How to " i {"not"} " be seen")), - } - }) - // ANCHOR_END: Clickable_usage -} - -// ANCHOR: Clickable -#[derive(Props)] -struct ClickableProps<'a> { - href: &'a str, - body: Element<'a>, -} - -fn Clickable<'a>(cx: Scope<'a, ClickableProps<'a>>) -> Element { - cx.render(rsx!( - a { - href: "{cx.props.href}", - class: "fancy-button", - &cx.props.body - } - )) -} -// ANCHOR_END: Clickable diff --git a/docs/guide/examples/component_owned_props.rs b/docs/guide/examples/component_owned_props.rs deleted file mode 100644 index 3913f02c8..000000000 --- a/docs/guide/examples/component_owned_props.rs +++ /dev/null @@ -1,34 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -// ANCHOR: App -fn App(cx: Scope) -> Element { - cx.render(rsx! { - Likes { - score: 42, - }, - }) -} -// ANCHOR_END: App - -// ANCHOR: Likes -// Remember: Owned props must implement `PartialEq`! -#[derive(PartialEq, Props)] -struct LikesProps { - score: i32, -} - -fn Likes(cx: Scope) -> Element { - cx.render(rsx! { - div { - "This post has ", - b { "{cx.props.score}" }, - " likes" - } - }) -} -// ANCHOR_END: Likes diff --git a/docs/guide/examples/component_props_options.rs b/docs/guide/examples/component_props_options.rs deleted file mode 100644 index df2ebf1db..000000000 --- a/docs/guide/examples/component_props_options.rs +++ /dev/null @@ -1,110 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -#[rustfmt::skip] -fn App(cx: Scope) -> Element { - cx.render(rsx! { - // ANCHOR: OptionalProps_usage -Title { - title: "Some Title", -}, -Title { - title: "Some Title", - subtitle: "Some Subtitle", -}, -// Providing an Option explicitly won't compile though: -// Title { -// title: "Some Title", -// subtitle: None, -// }, - // ANCHOR_END: OptionalProps_usage - - // ANCHOR: ExplicitOption_usage -ExplicitOption { - title: "Some Title", - subtitle: None, -}, -ExplicitOption { - title: "Some Title", - subtitle: Some("Some Title"), -}, -// This won't compile: -// ExplicitOption { -// title: "Some Title", -// }, - // ANCHOR_END: ExplicitOption_usage - - // ANCHOR: DefaultComponent_usage -DefaultComponent { - number: 5, -}, -DefaultComponent {}, - // ANCHOR_END: DefaultComponent_usage - - // ANCHOR: IntoComponent_usage -IntoComponent { - string: "some &str", -}, - // ANCHOR_END: IntoComponent_usage - }) -} - -// ANCHOR: OptionalProps -#[derive(Props)] -struct OptionalProps<'a> { - title: &'a str, - subtitle: Option<&'a str>, -} - -fn Title<'a>(cx: Scope<'a, OptionalProps>) -> Element<'a> { - cx.render(rsx!(h1{ - "{cx.props.title}: ", - cx.props.subtitle.unwrap_or("No subtitle provided"), - })) -} -// ANCHOR_END: OptionalProps - -// ANCHOR: ExplicitOption -#[derive(Props)] -struct ExplicitOptionProps<'a> { - title: &'a str, - #[props(!optional)] - subtitle: Option<&'a str>, -} - -fn ExplicitOption<'a>(cx: Scope<'a, ExplicitOptionProps>) -> Element<'a> { - cx.render(rsx!(h1 { - "{cx.props.title}: ", - cx.props.subtitle.unwrap_or("No subtitle provided"), - })) -} -// ANCHOR_END: ExplicitOption - -// ANCHOR: DefaultComponent -#[derive(PartialEq, Props)] -struct DefaultProps { - // default to 42 when not provided - #[props(default = 42)] - number: i64, -} - -fn DefaultComponent(cx: Scope) -> Element { - cx.render(rsx!(h1 { "{cx.props.number}" })) -} -// ANCHOR_END: DefaultComponent - -// ANCHOR: IntoComponent -#[derive(PartialEq, Props)] -struct IntoProps { - #[props(into)] - string: String, -} - -fn IntoComponent(cx: Scope) -> Element { - cx.render(rsx!(h1 { "{cx.props.string}" })) -} -// ANCHOR_END: IntoComponent diff --git a/docs/guide/examples/components.rs b/docs/guide/examples/components.rs deleted file mode 100644 index 85020c79c..000000000 --- a/docs/guide/examples/components.rs +++ /dev/null @@ -1,24 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -// ANCHOR: App -fn App(cx: Scope) -> Element { - cx.render(rsx! { - About {}, - About {}, - }) -} -// ANCHOR_END: App - -// ANCHOR: About -pub fn About(cx: Scope) -> Element { - cx.render(rsx!(p { - b {"Dioxus Labs"} - " An Open Source project dedicated to making Rust UI wonderful." - })) -} -// ANCHOR_END: About diff --git a/docs/guide/examples/conditional_rendering.rs b/docs/guide/examples/conditional_rendering.rs deleted file mode 100644 index c6095df98..000000000 --- a/docs/guide/examples/conditional_rendering.rs +++ /dev/null @@ -1,97 +0,0 @@ -#![allow(unused)] -#![allow(non_snake_case)] -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -pub fn App(cx: Scope) -> Element { - let is_logged_in = use_state(cx, || false); - - cx.render(rsx!(LogIn { - is_logged_in: **is_logged_in, - on_log_in: |_| is_logged_in.set(true), - on_log_out: |_| is_logged_in.set(false), - })) -} - -#[inline_props] -#[rustfmt::skip] -fn LogIn<'a>( - cx: Scope<'a>, - is_logged_in: bool, - on_log_in: EventHandler<'a>, - on_log_out: EventHandler<'a>, -) -> Element<'a> { - // ANCHOR: if_else -if *is_logged_in { - cx.render(rsx! { - "Welcome!" - button { - onclick: move |_| on_log_out.call(()), - "Log Out", - } - }) -} else { - cx.render(rsx! { - button { - onclick: move |_| on_log_in.call(()), - "Log In", - } - }) -} - // ANCHOR_END: if_else -} - -#[inline_props] -#[rustfmt::skip] -fn LogInImproved<'a>( - cx: Scope<'a>, - is_logged_in: bool, - on_log_in: EventHandler<'a>, - on_log_out: EventHandler<'a>, -) -> Element<'a> { - // ANCHOR: if_else_improved -cx.render(rsx! { - // We only render the welcome message if we are logged in - // You can use if statements in the middle of a render block to conditionally render elements - if *is_logged_in { - // Notice the body of this if statment is rsx code, not an expression - "Welcome!" - } - button { - // depending on the value of `is_logged_in`, we will call a different event handler - onclick: move |_| if *is_logged_in { - on_log_in.call(()) - } - else{ - on_log_out.call(()) - }, - if *is_logged_in { - // if we are logged in, the button should say "Log Out" - "Log Out" - } else { - // if we are not logged in, the button should say "Log In" - "Log In" - } - } -}) - // ANCHOR_END: if_else_improved -} - -#[inline_props] -#[rustfmt::skip] -fn LogInWarning(cx: Scope, is_logged_in: bool) -> Element { - // ANCHOR: conditional_none -if *is_logged_in { - return None; -} - -cx.render(rsx! { - a { - "You must be logged in to comment" - } -}) - // ANCHOR_END: conditional_none -} diff --git a/docs/guide/examples/custom_renderer.rs b/docs/guide/examples/custom_renderer.rs deleted file mode 100644 index 13993fe7b..000000000 --- a/docs/guide/examples/custom_renderer.rs +++ /dev/null @@ -1,311 +0,0 @@ -use dioxus::html::input_data::keyboard_types::{Code, Key, Modifiers}; -use dioxus::prelude::*; -use dioxus_native_core::exports::shipyard::Component; -use dioxus_native_core::node_ref::*; -use dioxus_native_core::prelude::*; -use dioxus_native_core::utils::cursor::{Cursor, Pos}; -use dioxus_native_core_macro::partial_derive_state; - -// ANCHOR: state_impl -struct FontSize(f64); - -// All states need to derive Component -#[derive(Default, Debug, Copy, Clone, Component)] -struct Size(f64, f64); - -/// Derive some of the boilerplate for the State implementation -#[partial_derive_state] -impl State for Size { - type ParentDependencies = (); - - // The size of the current node depends on the size of its children - type ChildDependencies = (Self,); - - type NodeDependencies = (); - - // Size only cares about the width, height, and text parts of the current node - const NODE_MASK: NodeMaskBuilder<'static> = NodeMaskBuilder::new() - // Get access to the width and height attributes - .with_attrs(AttributeMaskBuilder::Some(&["width", "height"])) - // Get access to the text of the node - .with_text(); - - fn update<'a>( - &mut self, - node_view: NodeView<()>, - _node: ::ElementBorrowed<'a>, - _parent: Option<::ElementBorrowed<'a>>, - children: Vec<::ElementBorrowed<'a>>, - context: &SendAnyMap, - ) -> bool { - let font_size = context.get::().unwrap().0; - let mut width; - let mut height; - if let Some(text) = node_view.text() { - // if the node has text, use the text to size our object - width = text.len() as f64 * font_size; - height = font_size; - } else { - // otherwise, the size is the maximum size of the children - width = children - .iter() - .map(|(item,)| item.0) - .reduce(|accum, item| if accum >= item { accum } else { item }) - .unwrap_or(0.0); - - height = children - .iter() - .map(|(item,)| item.1) - .reduce(|accum, item| if accum >= item { accum } else { item }) - .unwrap_or(0.0); - } - // if the node contains a width or height attribute it overrides the other size - for a in node_view.attributes().into_iter().flatten() { - match &*a.attribute.name { - "width" => width = a.value.as_float().unwrap(), - "height" => height = a.value.as_float().unwrap(), - // because Size only depends on the width and height, no other attributes will be passed to the member - _ => panic!(), - } - } - // to determine what other parts of the dom need to be updated we return a boolean that marks if this member changed - let changed = (width != self.0) || (height != self.1); - *self = Self(width, height); - changed - } -} - -#[derive(Debug, Clone, Copy, PartialEq, Default, Component)] -struct TextColor { - r: u8, - g: u8, - b: u8, -} - -#[partial_derive_state] -impl State for TextColor { - // TextColor depends on the TextColor part of the parent - type ParentDependencies = (Self,); - - type ChildDependencies = (); - - type NodeDependencies = (); - - // TextColor only cares about the color attribute of the current node - const NODE_MASK: NodeMaskBuilder<'static> = - // Get access to the color attribute - NodeMaskBuilder::new().with_attrs(AttributeMaskBuilder::Some(&["color"])); - - fn update<'a>( - &mut self, - node_view: NodeView<()>, - _node: ::ElementBorrowed<'a>, - parent: Option<::ElementBorrowed<'a>>, - _children: Vec<::ElementBorrowed<'a>>, - _context: &SendAnyMap, - ) -> bool { - // TextColor only depends on the color tag, so getting the first tag is equivilent to looking through all tags - let new = match node_view - .attributes() - .and_then(|mut attrs| attrs.next()) - .and_then(|attr| attr.value.as_text()) - { - // if there is a color tag, translate it - Some("red") => TextColor { r: 255, g: 0, b: 0 }, - Some("green") => TextColor { r: 0, g: 255, b: 0 }, - Some("blue") => TextColor { r: 0, g: 0, b: 255 }, - Some(color) => panic!("unknown color {color}"), - // otherwise check if the node has a parent and inherit that color - None => match parent { - Some((parent,)) => *parent, - None => Self::default(), - }, - }; - // check if the member has changed - let changed = new != *self; - *self = new; - changed - } -} - -#[derive(Debug, Clone, Copy, PartialEq, Default, Component)] -struct Border(bool); - -#[partial_derive_state] -impl State for Border { - // TextColor depends on the TextColor part of the parent - type ParentDependencies = (Self,); - - type ChildDependencies = (); - - type NodeDependencies = (); - - // Border does not depended on any other member in the current node - const NODE_MASK: NodeMaskBuilder<'static> = - // Get access to the border attribute - NodeMaskBuilder::new().with_attrs(AttributeMaskBuilder::Some(&["border"])); - - fn update<'a>( - &mut self, - node_view: NodeView<()>, - _node: ::ElementBorrowed<'a>, - _parent: Option<::ElementBorrowed<'a>>, - _children: Vec<::ElementBorrowed<'a>>, - _context: &SendAnyMap, - ) -> bool { - // check if the node contians a border attribute - let new = Self( - node_view - .attributes() - .and_then(|mut attrs| attrs.next().map(|a| a.attribute.name == "border")) - .is_some(), - ); - // check if the member has changed - let changed = new != *self; - *self = new; - changed - } -} -// ANCHOR_END: state_impl - -// ANCHOR: rendering -fn main() -> Result<(), Box> { - fn app(cx: Scope) -> Element { - let count = use_state(cx, || 0); - - use_future(cx, (count,), |(count,)| async move { - loop { - tokio::time::sleep(std::time::Duration::from_secs(1)).await; - count.set(*count + 1); - } - }); - - cx.render(rsx! { - div{ - color: "red", - "{count}" - } - }) - } - - // create the vdom, the real_dom, and the binding layer between them - let mut vdom = VirtualDom::new(app); - let mut rdom: RealDom = RealDom::new([ - Border::to_type_erased(), - TextColor::to_type_erased(), - Size::to_type_erased(), - ]); - let mut dioxus_intigration_state = DioxusState::create(&mut rdom); - - let mutations = vdom.rebuild(); - // update the structure of the real_dom tree - dioxus_intigration_state.apply_mutations(&mut rdom, mutations); - let mut ctx = SendAnyMap::new(); - // set the font size to 3.3 - ctx.insert(FontSize(3.3)); - // update the State for nodes in the real_dom tree - let _to_rerender = rdom.update_state(ctx); - - // we need to run the vdom in a async runtime - tokio::runtime::Builder::new_current_thread() - .enable_all() - .build()? - .block_on(async { - loop { - // wait for the vdom to update - vdom.wait_for_work().await; - - // get the mutations from the vdom - let mutations = vdom.render_immediate(); - - // update the structure of the real_dom tree - dioxus_intigration_state.apply_mutations(&mut rdom, mutations); - - // update the state of the real_dom tree - let mut ctx = SendAnyMap::new(); - // set the font size to 3.3 - ctx.insert(FontSize(3.3)); - let _to_rerender = rdom.update_state(ctx); - - // render... - rdom.traverse_depth_first(|node| { - let indent = " ".repeat(node.height() as usize); - let color = *node.get::().unwrap(); - let size = *node.get::().unwrap(); - let border = *node.get::().unwrap(); - let id = node.id(); - let node = node.node_type(); - let node_type = &*node; - println!("{indent}{id:?} {color:?} {size:?} {border:?} {node_type:?}"); - }); - } - }) -} -// ANCHOR_END: rendering - -// ANCHOR: derive_state -// All states must derive Component (https://docs.rs/shipyard/latest/shipyard/derive.Component.html) -// They also must implement Default or provide a custom implementation of create in the State trait -#[derive(Default, Component)] -struct MyState; - -/// Derive some of the boilerplate for the State implementation -#[partial_derive_state] -impl State for MyState { - // The states of the parent nodes this state depends on - type ParentDependencies = (); - - // The states of the child nodes this state depends on - type ChildDependencies = (Self,); - - // The states of the current node this state depends on - type NodeDependencies = (); - - // The parts of the current text, element, or placeholder node in the tree that this state depends on - const NODE_MASK: NodeMaskBuilder<'static> = NodeMaskBuilder::new(); - - // How to update the state of the current node based on the state of the parent nodes, child nodes, and the current node - // Returns true if the node was updated and false if the node was not updated - fn update<'a>( - &mut self, - // The view of the current node limited to the parts this state depends on - _node_view: NodeView<()>, - // The state of the current node that this state depends on - _node: ::ElementBorrowed<'a>, - // The state of the parent nodes that this state depends on - _parent: Option<::ElementBorrowed<'a>>, - // The state of the child nodes that this state depends on - _children: Vec<::ElementBorrowed<'a>>, - // The context of the current node used to pass global state into the tree - _context: &SendAnyMap, - ) -> bool { - todo!() - } - - // partial_derive_state will generate a default implementation of all the other methods -} -// ANCHOR_END: derive_state - -#[allow(unused)] -// ANCHOR: cursor -fn text_editing() { - let mut cursor = Cursor::default(); - let mut text = String::new(); - - // handle keyboard input with a max text length of 10 - cursor.handle_input( - &Code::ArrowRight, - &Key::ArrowRight, - &Modifiers::empty(), - &mut text, - 10, - ); - - // mannually select text between characters 0-5 on the first line (this could be from dragging with a mouse) - cursor.start = Pos::new(0, 0); - cursor.end = Some(Pos::new(5, 0)); - - // delete the selected text and move the cursor to the start of the selection - cursor.delete_selection(&mut text); -} -// ANCHOR_END: cursor diff --git a/docs/guide/examples/dangerous_inner_html.rs b/docs/guide/examples/dangerous_inner_html.rs deleted file mode 100644 index fe8a52663..000000000 --- a/docs/guide/examples/dangerous_inner_html.rs +++ /dev/null @@ -1,20 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -#[rustfmt::skip] -fn App(cx: Scope) -> Element { - // ANCHOR: dangerous_inner_html -// this should come from a trusted source -let contents = "live dangerously"; - -cx.render(rsx! { - div { - dangerous_inner_html: "{contents}", - } -}) - // ANCHOR_END: dangerous_inner_html -} diff --git a/docs/guide/examples/event_click.rs b/docs/guide/examples/event_click.rs deleted file mode 100644 index bd25c5f36..000000000 --- a/docs/guide/examples/event_click.rs +++ /dev/null @@ -1,18 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -#[rustfmt::skip] -fn App(cx: Scope) -> Element { - // ANCHOR: rsx -cx.render(rsx! { - button { - onclick: move |event| println!("Clicked! Event: {event:?}"), - "click me!" - } -}) - // ANCHOR_END: rsx -} diff --git a/docs/guide/examples/event_handler_prop.rs b/docs/guide/examples/event_handler_prop.rs deleted file mode 100644 index 0ef70c841..000000000 --- a/docs/guide/examples/event_handler_prop.rs +++ /dev/null @@ -1,32 +0,0 @@ -#![allow(non_snake_case)] - -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -fn App(cx: Scope) -> Element { - // ANCHOR: usage - cx.render(rsx! { - FancyButton { - on_click: move |event| println!("Clicked! {event:?}") - } - }) - // ANCHOR_END: usage -} - -// ANCHOR: component_with_handler -#[derive(Props)] -pub struct FancyButtonProps<'a> { - on_click: EventHandler<'a, MouseEvent>, -} - -pub fn FancyButton<'a>(cx: Scope<'a, FancyButtonProps<'a>>) -> Element<'a> { - cx.render(rsx!(button { - class: "fancy-button", - onclick: move |evt| cx.props.on_click.call(evt), - "click me pls." - })) -} -// ANCHOR_END: component_with_handler diff --git a/docs/guide/examples/event_nested.rs b/docs/guide/examples/event_nested.rs deleted file mode 100644 index b31e340f1..000000000 --- a/docs/guide/examples/event_nested.rs +++ /dev/null @@ -1,25 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -#[rustfmt::skip] -fn App(cx: Scope) -> Element { - // ANCHOR: rsx -cx.render(rsx! { - div { - onclick: move |_event| {}, - "outer", - button { - onclick: move |event| { - // now, outer won't be triggered - event.stop_propagation(); - }, - "inner" - } - } -}) - // ANCHOR_END: rsx -} diff --git a/docs/guide/examples/event_prevent_default.rs b/docs/guide/examples/event_prevent_default.rs deleted file mode 100644 index 32443d017..000000000 --- a/docs/guide/examples/event_prevent_default.rs +++ /dev/null @@ -1,17 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -#[rustfmt::skip] -fn App(cx: Scope) -> Element { - // ANCHOR: prevent_default -cx.render(rsx! { - input { - prevent_default: "oninput onclick", - } -}) - // ANCHOR_END: prevent_default -} diff --git a/docs/guide/examples/hello_world_desktop.rs b/docs/guide/examples/hello_world_desktop.rs deleted file mode 100644 index 9d5a02051..000000000 --- a/docs/guide/examples/hello_world_desktop.rs +++ /dev/null @@ -1,21 +0,0 @@ -// ANCHOR: all -#![allow(non_snake_case)] -// import the prelude to get access to the `rsx!` macro and the `Scope` and `Element` types -use dioxus::prelude::*; - -fn main() { - // launch the dioxus app in a webview - dioxus_desktop::launch(App); -} - -// ANCHOR: component -// define a component that renders a div with the text "Hello, world!" -fn App(cx: Scope) -> Element { - cx.render(rsx! { - div { - "Hello, world!" - } - }) -} -// ANCHOR_END: component -// ANCHOR_END: all diff --git a/docs/guide/examples/hello_world_liveview.rs b/docs/guide/examples/hello_world_liveview.rs deleted file mode 100644 index c88dc2f53..000000000 --- a/docs/guide/examples/hello_world_liveview.rs +++ /dev/null @@ -1,60 +0,0 @@ -// ANCHOR: all -use axum::{extract::ws::WebSocketUpgrade, response::Html, routing::get, Router}; -use dioxus::prelude::*; - -// ANCHOR: glue -#[tokio::main] -async fn main() { - let addr: std::net::SocketAddr = ([127, 0, 0, 1], 3030).into(); - - let view = dioxus_liveview::LiveViewPool::new(); - - let app = Router::new() - // The root route contains the glue code to connect to the WebSocket - .route( - "/", - get(move || async move { - Html(format!( - r#" - - - Dioxus LiveView with Axum -
- {glue} - - "#, - // Create the glue code to connect to the WebSocket on the "/ws" route - glue = dioxus_liveview::interpreter_glue(&format!("ws://{addr}/ws")) - )) - }), - ) - // The WebSocket route is what Dioxus uses to communicate with the browser - .route( - "/ws", - get(move |ws: WebSocketUpgrade| async move { - ws.on_upgrade(move |socket| async move { - // When the WebSocket is upgraded, launch the LiveView with the app component - _ = view.launch(dioxus_liveview::axum_socket(socket), app).await; - }) - }), - ); - - println!("Listening on http://{addr}"); - - axum::Server::bind(&addr.to_string().parse().unwrap()) - .serve(app.into_make_service()) - .await - .unwrap(); -} -// ANCHOR_END: glue - -// ANCHOR: app -fn app(cx: Scope) -> Element { - cx.render(rsx! { - div { - "Hello, world!" - } - }) -} -// ANCHOR_END: app -// ANCHOR_END: all diff --git a/docs/guide/examples/hello_world_ssr.rs b/docs/guide/examples/hello_world_ssr.rs deleted file mode 100644 index 0f8db0b46..000000000 --- a/docs/guide/examples/hello_world_ssr.rs +++ /dev/null @@ -1,63 +0,0 @@ -#![allow(unused)] -#![allow(non_snake_case)] -// ANCHOR: all - -// ANCHOR: main -#![allow(non_snake_case)] -use axum::{response::Html, routing::get, Router}; -// import the prelude to get access to the `rsx!` macro and the `Scope` and `Element` types -use dioxus::prelude::*; - -#[tokio::main] -async fn main() { - let addr = std::net::SocketAddr::from(([127, 0, 0, 1], 3000)); - println!("listening on http://{}", addr); - - axum::Server::bind(&addr) - .serve( - Router::new() - .route("/", get(app_endpoint)) - .into_make_service(), - ) - .await - .unwrap(); -} - -// ANCHOR_END: main - -// ANCHOR: endpoint -async fn app_endpoint() -> Html { - // render the rsx! macro to HTML - Html(dioxus_ssr::render_lazy(rsx! { - div { "hello world!" } - })) -} -// ANCHOR_END: endpoint - -// ANCHOR: second_endpoint -async fn second_app_endpoint() -> Html { - // create a component that renders a div with the text "hello world" - fn app(cx: Scope) -> Element { - cx.render(rsx!(div { "hello world" })) - } - // create a VirtualDom with the app component - let mut app = VirtualDom::new(app); - // rebuild the VirtualDom before rendering - let _ = app.rebuild(); - - // render the VirtualDom to HTML - Html(dioxus_ssr::render(&app)) -} -// ANCHOR_END: second_endpoint - -// ANCHOR: component -// define a component that renders a div with the text "Hello, world!" -fn App(cx: Scope) -> Element { - cx.render(rsx! { - div { - "Hello, world!" - } - }) -} -// ANCHOR_END: component -// ANCHOR_END: all diff --git a/docs/guide/examples/hello_world_tui.rs b/docs/guide/examples/hello_world_tui.rs deleted file mode 100644 index dc4f0ee71..000000000 --- a/docs/guide/examples/hello_world_tui.rs +++ /dev/null @@ -1,17 +0,0 @@ -#![allow(non_snake_case)] -// import the prelude to get access to the `rsx!` macro and the `Scope` and `Element` types -use dioxus::prelude::*; - -fn main() { - // launch the app in the terminal - dioxus_tui::launch(App); -} - -// create a component that renders a div with the text "Hello, world!" -fn App(cx: Scope) -> Element { - cx.render(rsx! { - div { - "Hello, world!" - } - }) -} diff --git a/docs/guide/examples/hello_world_tui_no_ctrl_c.rs b/docs/guide/examples/hello_world_tui_no_ctrl_c.rs deleted file mode 100644 index 6afa21e6c..000000000 --- a/docs/guide/examples/hello_world_tui_no_ctrl_c.rs +++ /dev/null @@ -1,36 +0,0 @@ -// todo remove deprecated -#![allow(non_snake_case, deprecated)] - -use dioxus::events::{KeyCode, KeyboardEvent}; -use dioxus::prelude::*; -use dioxus_tui::TuiContext; - -fn main() { - dioxus_tui::launch_cfg( - App, - dioxus_tui::Config::new() - .without_ctrl_c_quit() - // Some older terminals only support 16 colors or ANSI colors - // If your terminal is one of these, change this to BaseColors or ANSI - .with_rendering_mode(dioxus_tui::RenderingMode::Rgb), - ); -} - -fn App(cx: Scope) -> Element { - let tui_ctx: TuiContext = cx.consume_context().unwrap(); - - cx.render(rsx! { - div { - width: "100%", - height: "10px", - background_color: "red", - justify_content: "center", - align_items: "center", - onkeydown: move |k: KeyboardEvent| if let KeyCode::Q = k.key_code { - tui_ctx.quit(); - }, - - "Hello world!" - } - }) -} diff --git a/docs/guide/examples/hello_world_web.rs b/docs/guide/examples/hello_world_web.rs deleted file mode 100644 index 7b013bc3d..000000000 --- a/docs/guide/examples/hello_world_web.rs +++ /dev/null @@ -1,17 +0,0 @@ -#![allow(non_snake_case)] -// import the prelude to get access to the `rsx!` macro and the `Scope` and `Element` types -use dioxus::prelude::*; - -fn main() { - // launch the web app - dioxus_web::launch(App); -} - -// create a component that renders a div with the text "Hello, world!" -fn App(cx: Scope) -> Element { - cx.render(rsx! { - div { - "Hello, world!" - } - }) -} diff --git a/docs/guide/examples/hooks_anti_patterns.rs b/docs/guide/examples/hooks_anti_patterns.rs deleted file mode 100644 index 2119b8601..000000000 --- a/docs/guide/examples/hooks_anti_patterns.rs +++ /dev/null @@ -1,38 +0,0 @@ -#![allow(unused)] - -use dioxus::prelude::*; - -fn main() {} - -// ANCHOR: non_clone_state -use std::cell::RefCell; -use std::rc::Rc; -use std::sync::Arc; - -struct UseState<'a, T> { - value: &'a RefCell, - update: Arc, -} - -fn my_use_state(cx: &ScopeState, init: impl FnOnce() -> T) -> UseState { - // The update function will trigger a re-render in the component cx is attached to - let update = cx.schedule_update(); - // Create the initial state - let value = cx.use_hook(|| RefCell::new(init())); - - UseState { value, update } -} - -impl UseState<'_, T> { - fn get(&self) -> T { - self.value.borrow().clone() - } - - fn set(&self, value: T) { - // Update the state - *self.value.borrow_mut() = value; - // Trigger a re-render on the component the state is from - (self.update)(); - } -} -// ANCHOR_END: non_clone_state diff --git a/docs/guide/examples/hooks_bad.rs b/docs/guide/examples/hooks_bad.rs deleted file mode 100644 index cbaa54e90..000000000 --- a/docs/guide/examples/hooks_bad.rs +++ /dev/null @@ -1,68 +0,0 @@ -#![allow(non_snake_case)] - -use dioxus::prelude::*; -use std::collections::HashMap; - -fn main() { - dioxus_desktop::launch(App); -} - -#[rustfmt::skip] -fn App(cx: Scope) -> Element { - let you_are_happy = true; - let you_know_it = false; - - // ANCHOR: conditional -// ❌ don't call hooks in conditionals! -// We must ensure that the same hooks will be called every time -// But `if` statements only run if the conditional is true! -// So we might violate rule 2. -if you_are_happy && you_know_it { - let something = use_state(cx, || "hands"); - println!("clap your {something}") -} - -// βœ… instead, *always* call use_state -// You can put other stuff in the conditional though -let something = use_state(cx, || "hands"); -if you_are_happy && you_know_it { - println!("clap your {something}") -} - // ANCHOR_END: conditional - - // ANCHOR: closure -// ❌ don't call hooks inside closures! -// We can't guarantee that the closure, if used, will be called in the same order every time -let _a = || { - let b = use_state(cx, || 0); - b.get() -}; - -// βœ… instead, move hook `b` outside -let b = use_state(cx, || 0); -let _a = || b.get(); - // ANCHOR_END: closure - - let names: Vec<&str> = vec![]; - - // ANCHOR: loop -// `names` is a Vec<&str> - -// ❌ Do not use hooks in loops! -// In this case, if the length of the Vec changes, we break rule 2 -for _name in &names { - let is_selected = use_state(cx, || false); - println!("selected: {is_selected}"); -} - -// βœ… Instead, use a hashmap with use_ref -let selection_map = use_ref(cx, HashMap::<&str, bool>::new); - -for name in &names { - let is_selected = selection_map.read()[name]; - println!("selected: {is_selected}"); -} - // ANCHOR_END: loop - - cx.render(rsx!(())) -} diff --git a/docs/guide/examples/hooks_composed.rs b/docs/guide/examples/hooks_composed.rs deleted file mode 100644 index 782a19d7d..000000000 --- a/docs/guide/examples/hooks_composed.rs +++ /dev/null @@ -1,67 +0,0 @@ -#![allow(unused)] - -use dioxus::prelude::*; - -fn main() {} - -struct AppSettings {} - -// ANCHOR: wrap_context -fn use_settings(cx: &ScopeState) -> &UseSharedState { - use_shared_state::(cx).expect("App settings not provided") -} -// ANCHOR_END: wrap_context - -// ANCHOR: use_storage -use gloo_storage::{LocalStorage, Storage}; -use serde::{de::DeserializeOwned, Serialize}; - -/// A persistent storage hook that can be used to store data across application reloads. -#[allow(clippy::needless_return)] -pub fn use_persistent( - cx: &ScopeState, - // A unique key for the storage entry - key: impl ToString, - // A function that returns the initial value if the storage entry is empty - init: impl FnOnce() -> T, -) -> &UsePersistent { - // Use the use_ref hook to create a mutable state for the storage entry - let state = use_ref(cx, move || { - // This closure will run when the hook is created - let key = key.to_string(); - let value = LocalStorage::get(key.as_str()).ok().unwrap_or_else(init); - StorageEntry { key, value } - }); - - // Wrap the state in a new struct with a custom API - // Note: We use use_hook here so that this hook is easier to use in closures in the rsx. Any values with the same lifetime as the ScopeState can be used in the closure without cloning. - cx.use_hook(|| UsePersistent { - inner: state.clone(), - }) -} - -struct StorageEntry { - key: String, - value: T, -} - -/// Storage that persists across application reloads -pub struct UsePersistent { - inner: UseRef>, -} - -impl UsePersistent { - /// Returns a reference to the value - pub fn get(&self) -> T { - self.inner.read().value.clone() - } - - /// Sets the value - pub fn set(&self, value: T) { - let mut inner = self.inner.write(); - // Write the new value to local storage - LocalStorage::set(inner.key.as_str(), &value); - inner.value = value; - } -} -// ANCHOR_END: use_storage diff --git a/docs/guide/examples/hooks_counter.rs b/docs/guide/examples/hooks_counter.rs deleted file mode 100644 index 86705f4af..000000000 --- a/docs/guide/examples/hooks_counter.rs +++ /dev/null @@ -1,31 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -// ANCHOR: component -fn App(cx: Scope) -> Element { - // count will be initialized to 0 the first time the component is rendered - let mut count = use_state(cx, || 0); - - cx.render(rsx!( - h1 { "High-Five counter: {count}" } - button { - onclick: move |_| { - // changing the count will cause the component to re-render - count += 1 - }, - "Up high!" - } - button { - onclick: move |_| { - // changing the count will cause the component to re-render - count -= 1 - }, - "Down low!" - } - )) -} -// ANCHOR_END: component diff --git a/docs/guide/examples/hooks_counter_two_state.rs b/docs/guide/examples/hooks_counter_two_state.rs deleted file mode 100644 index b2a8f6e77..000000000 --- a/docs/guide/examples/hooks_counter_two_state.rs +++ /dev/null @@ -1,24 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -// ANCHOR: component -fn App(cx: Scope) -> Element { - // ANCHOR: use_state_calls - let mut count_a = use_state(cx, || 0); - let mut count_b = use_state(cx, || 0); - // ANCHOR_END: use_state_calls - - cx.render(rsx!( - h1 { "Counter_a: {count_a}" } - button { onclick: move |_| count_a += 1, "a++" } - button { onclick: move |_| count_a -= 1, "a--" } - h1 { "Counter_b: {count_b}" } - button { onclick: move |_| count_b += 1, "b++" } - button { onclick: move |_| count_b -= 1, "b--" } - )) -} -// ANCHOR_END: component diff --git a/docs/guide/examples/hooks_custom_logic.rs b/docs/guide/examples/hooks_custom_logic.rs deleted file mode 100644 index 2323ddb11..000000000 --- a/docs/guide/examples/hooks_custom_logic.rs +++ /dev/null @@ -1,57 +0,0 @@ -#![allow(unused)] - -use dioxus::prelude::*; - -fn main() {} - -// ANCHOR: use_state -use std::cell::RefCell; -use std::rc::Rc; -use std::sync::Arc; - -#[derive(Clone)] -struct UseState { - value: Rc>, - update: Arc, -} - -fn my_use_state(cx: &ScopeState, init: impl FnOnce() -> T) -> &UseState { - cx.use_hook(|| { - // The update function will trigger a re-render in the component cx is attached to - let update = cx.schedule_update(); - // Create the initial state - let value = Rc::new(RefCell::new(init())); - - UseState { value, update } - }) -} - -impl UseState { - fn get(&self) -> T { - self.value.borrow().clone() - } - - fn set(&self, value: T) { - // Update the state - *self.value.borrow_mut() = value; - // Trigger a re-render on the component the state is from - (self.update)(); - } -} -// ANCHOR_END: use_state - -// ANCHOR: use_context -pub fn use_context(cx: &ScopeState) -> Option<&T> { - cx.use_hook(|| cx.consume_context::()).as_ref() -} - -pub fn use_context_provider(cx: &ScopeState, f: impl FnOnce() -> T) -> &T { - cx.use_hook(|| { - let val = f(); - // Provide the context state to the scope - cx.provide_context(val.clone()); - val - }) -} - -// ANCHOR_END: use_context diff --git a/docs/guide/examples/hooks_use_ref.rs b/docs/guide/examples/hooks_use_ref.rs deleted file mode 100644 index 00794fbb7..000000000 --- a/docs/guide/examples/hooks_use_ref.rs +++ /dev/null @@ -1,22 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -// ANCHOR: component -fn App(cx: Scope) -> Element { - let list = use_ref(cx, Vec::new); - - cx.render(rsx!( - p { "Current list: {list.read():?}" } - button { - onclick: move |event| { - list.with_mut(|list| list.push(event)); - }, - "Click me!" - } - )) -} -// ANCHOR_END: component diff --git a/docs/guide/examples/hydration.rs b/docs/guide/examples/hydration.rs deleted file mode 100644 index 31574edce..000000000 --- a/docs/guide/examples/hydration.rs +++ /dev/null @@ -1,34 +0,0 @@ -#![allow(non_snake_case, unused)] -use dioxus::prelude::*; - -fn main() { - #[cfg(feature = "web")] - dioxus_web::launch_cfg(app, dioxus_web::Config::new().hydrate(true)); - #[cfg(feature = "ssr")] - { - use dioxus_fullstack::prelude::*; - tokio::runtime::Runtime::new() - .unwrap() - .block_on(async move { - let addr = std::net::SocketAddr::from(([127, 0, 0, 1], 8080)); - axum::Server::bind(&addr) - .serve( - axum::Router::new() - .serve_dioxus_application("", ServeConfigBuilder::new(app, ())) - .into_make_service(), - ) - .await - .unwrap(); - }); - } -} - -fn app(cx: Scope) -> Element { - let mut count = use_state(cx, || 0); - - cx.render(rsx! { - h1 { "High-Five counter: {count}" } - button { onclick: move |_| count += 1, "Up high!" } - button { onclick: move |_| count -= 1, "Down low!" } - }) -} diff --git a/docs/guide/examples/hydration_props.rs b/docs/guide/examples/hydration_props.rs deleted file mode 100644 index 4e6bb1752..000000000 --- a/docs/guide/examples/hydration_props.rs +++ /dev/null @@ -1,74 +0,0 @@ -#![allow(non_snake_case, unused)] -use dioxus::prelude::*; -use dioxus_fullstack::prelude::*; - -fn main() { - #[cfg(feature = "web")] - dioxus_web::launch_with_props( - app, - // Get the root props from the document - get_root_props_from_document().unwrap_or_default(), - dioxus_web::Config::new().hydrate(true), - ); - #[cfg(feature = "ssr")] - { - use axum::extract::Path; - use axum::extract::State; - use axum::routing::get; - tokio::runtime::Runtime::new() - .unwrap() - .block_on(async move { - let addr = std::net::SocketAddr::from(([127, 0, 0, 1], 8080)); - axum::Server::bind(&addr) - .serve( - axum::Router::new() - // Serve the dist folder with the static javascript and WASM files created by the dixous CLI - .serve_static_assets("./dist") - // Register server functions - .register_server_fns("") - // Connect to the hot reload server in debug mode - .connect_hot_reload() - // Render the application. This will serialize the root props (the intial count) into the HTML - .route( - "/", - get(move | State(ssr_state): State| async move { axum::body::Full::from( - ssr_state.render( - &ServeConfigBuilder::new( - app, - 0, - ) - .build(), - ) - )}), - ) - // Render the application with a different intial count - .route( - "/:initial_count", - get(move |Path(intial_count): Path, State(ssr_state): State| async move { axum::body::Full::from( - ssr_state.render( - &ServeConfigBuilder::new( - app, - intial_count, - ) - .build(), - ) - )}), - ) - .with_state(SSRState::default()) - .into_make_service(), - ) - .await - .unwrap(); - }); - } -} - -fn app(cx: Scope) -> Element { - let mut count = use_state(cx, || *cx.props); - - cx.render(rsx! { - h1 { "High-Five counter: {count}" } - button { onclick: move |_| count += 1, "Up high!" } - button { onclick: move |_| count -= 1, "Down low!" } - }) -} diff --git a/docs/guide/examples/input_controlled.rs b/docs/guide/examples/input_controlled.rs deleted file mode 100644 index bf92072a3..000000000 --- a/docs/guide/examples/input_controlled.rs +++ /dev/null @@ -1,21 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -// ANCHOR: component -fn App(cx: Scope) -> Element { - let name = use_state(cx, || "bob".to_string()); - - cx.render(rsx! { - input { - // we tell the component what to render - value: "{name}", - // and what to do when the value changes - oninput: move |evt| name.set(evt.value.clone()), - } - }) -} -// ANCHOR_END: component diff --git a/docs/guide/examples/input_uncontrolled.rs b/docs/guide/examples/input_uncontrolled.rs deleted file mode 100644 index 5adc4aaad..000000000 --- a/docs/guide/examples/input_uncontrolled.rs +++ /dev/null @@ -1,22 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -// ANCHOR: component -fn App(cx: Scope) -> Element { - cx.render(rsx! { - form { - onsubmit: move |event| { - println!("Submitted! {event:?}") - }, - input { name: "name", }, - input { name: "age", }, - input { name: "date", }, - input { r#type: "submit", }, - } - }) -} -// ANCHOR_END: component diff --git a/docs/guide/examples/meme_editor.rs b/docs/guide/examples/meme_editor.rs deleted file mode 100644 index c5a473da9..000000000 --- a/docs/guide/examples/meme_editor.rs +++ /dev/null @@ -1,104 +0,0 @@ -// ANCHOR: all -#![allow(non_snake_case)] - -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(MemeEditor); -} - -// ANCHOR: meme_editor -fn MemeEditor(cx: Scope) -> Element { - let container_style = r" - display: flex; - flex-direction: column; - gap: 16px; - margin: 0 auto; - width: fit-content; - "; - - let caption = use_state(cx, || "me waiting for my rust code to compile".to_string()); - - cx.render(rsx! { - div { - style: "{container_style}", - h1 { "Meme Editor" }, - Meme { - caption: caption, - }, - CaptionEditor { - caption: caption, - on_input: move |event: FormEvent| {caption.set(event.value.clone());}, - }, - } - }) -} -// ANCHOR_END: meme_editor - -// ANCHOR: meme_component -#[inline_props] -fn Meme<'a>(cx: Scope<'a>, caption: &'a str) -> Element<'a> { - let container_style = r#" - position: relative; - width: fit-content; - "#; - - let caption_container_style = r#" - position: absolute; - bottom: 0; - left: 0; - right: 0; - padding: 16px 8px; - "#; - - let caption_style = r" - font-size: 32px; - margin: 0; - color: white; - text-align: center; - "; - - cx.render(rsx!( - div { - style: "{container_style}", - img { - src: "https://i.imgflip.com/2zh47r.jpg", - height: "500px", - }, - div { - style: "{caption_container_style}", - p { - style: "{caption_style}", - "{caption}" - } - } - } - )) -} -// ANCHOR_END: meme_component - -// ANCHOR: caption_editor -#[inline_props] -fn CaptionEditor<'a>( - cx: Scope<'a>, - caption: &'a str, - on_input: EventHandler<'a, FormEvent>, -) -> Element<'a> { - let input_style = r" - border: none; - background: cornflowerblue; - padding: 8px 16px; - margin: 0; - border-radius: 4px; - color: white; - "; - - cx.render(rsx!(input { - style: "{input_style}", - value: "{caption}", - oninput: move |event| on_input.call(event), - })) -} -// ANCHOR_END: caption_editor - -// ANCHOR_END: all diff --git a/docs/guide/examples/meme_editor_dark_mode.rs b/docs/guide/examples/meme_editor_dark_mode.rs deleted file mode 100644 index e62a64eb7..000000000 --- a/docs/guide/examples/meme_editor_dark_mode.rs +++ /dev/null @@ -1,185 +0,0 @@ -// ANCHOR: all -#![allow(non_snake_case)] - -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -// ANCHOR: DarkMode_struct -struct DarkMode(bool); -// ANCHOR_END: DarkMode_struct - -#[rustfmt::skip] -pub fn App(cx: Scope) -> Element { - // ANCHOR: context_provider -use_shared_state_provider(cx, || DarkMode(false)); - // ANCHOR_END: context_provider - - let is_dark_mode = use_is_dark_mode(cx); - - let wrapper_style = if is_dark_mode { - r" - background: #222; - min-height: 100vh; - " - } else { - r"" - }; - - cx.render(rsx!(div { - style: "{wrapper_style}", - DarkModeToggle {}, - MemeEditor {}, - })) -} - -#[rustfmt::skip] -pub fn use_is_dark_mode(cx: &ScopeState) -> bool { - // ANCHOR: use_context -let dark_mode_context = use_shared_state::(cx); - // ANCHOR_END: use_context - - dark_mode_context - .map(|context| context.read().0) - .unwrap_or(false) -} - -// ANCHOR: toggle -pub fn DarkModeToggle(cx: Scope) -> Element { - let dark_mode = use_shared_state::(cx).unwrap(); - - let style = if dark_mode.read().0 { - "color:white" - } else { - "" - }; - - cx.render(rsx!(label { - style: "{style}", - "Dark Mode", - input { - r#type: "checkbox", - oninput: move |event| { - let is_enabled = event.value == "true"; - dark_mode.write().0 = is_enabled; - }, - }, - })) -} -// ANCHOR_END: toggle - -// ANCHOR: meme_editor -fn MemeEditor(cx: Scope) -> Element { - let is_dark_mode = use_is_dark_mode(cx); - let heading_style = if is_dark_mode { "color: white" } else { "" }; - - let container_style = r" - display: flex; - flex-direction: column; - gap: 16px; - margin: 0 auto; - width: fit-content; - "; - - let caption = use_state(cx, || "me waiting for my rust code to compile".to_string()); - - cx.render(rsx! { - div { - style: "{container_style}", - h1 { - style: "{heading_style}", - "Meme Editor" - }, - Meme { - caption: caption, - }, - CaptionEditor { - caption: caption, - on_input: move |event: FormEvent| {caption.set(event.value.clone());}, - }, - } - }) -} -// ANCHOR_END: meme_editor - -// ANCHOR: meme_component -#[inline_props] -fn Meme<'a>(cx: Scope<'a>, caption: &'a str) -> Element<'a> { - let container_style = r" - position: relative; - width: fit-content; - "; - - let caption_container_style = r" - position: absolute; - bottom: 0; - left: 0; - right: 0; - padding: 16px 8px; - "; - - let caption_style = r" - font-size: 32px; - margin: 0; - color: white; - text-align: center; - "; - - cx.render(rsx!( - div { - style: "{container_style}", - img { - src: "https://i.imgflip.com/2zh47r.jpg", - height: "500px", - }, - div { - style: "{caption_container_style}", - p { - style: "{caption_style}", - "{caption}" - } - } - } - )) -} -// ANCHOR_END: meme_component - -// ANCHOR: caption_editor -#[inline_props] -fn CaptionEditor<'a>( - cx: Scope<'a>, - caption: &'a str, - on_input: EventHandler<'a, FormEvent>, -) -> Element<'a> { - let is_dark_mode = use_is_dark_mode(cx); - - let colors = if is_dark_mode { - r" - background: cornflowerblue; - color: white; - " - } else { - r" - background: #def; - color: black; - " - }; - - let input_style = r" - border: none; - padding: 8px 16px; - margin: 0; - border-radius: 4px; - "; - - cx.render(rsx!(input { - style: "{input_style}{colors}", - value: "{caption}", - oninput: move |event| on_input.call(event), - })) -} -// ANCHOR_END: caption_editor - -// ANCHOR_END: all diff --git a/docs/guide/examples/readme_expanded.rs b/docs/guide/examples/readme_expanded.rs deleted file mode 100644 index 8b9abfa20..000000000 --- a/docs/guide/examples/readme_expanded.rs +++ /dev/null @@ -1,106 +0,0 @@ -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(app); -} - -fn app(cx: Scope) -> Element { - let mut count = use_state(cx, || 0); - - cx.render( - // rsx expands to LazyNodes::new - ::dioxus::core::LazyNodes::new( - move |__cx: &::dioxus::core::ScopeState| -> ::dioxus::core::VNode { - // The template is every static part of the rsx - static TEMPLATE: ::dioxus::core::Template = ::dioxus::core::Template { - // This is the source location of the rsx that generated this template. This is used to make hot rsx reloading work. Hot rsx reloading just replaces the template with a new one generated from the rsx by the CLI. - name: "examples\\readme.rs:14:15:250", - // The root nodes are the top level nodes of the rsx - roots: &[ - // The h1 node - ::dioxus::core::TemplateNode::Element { - // Find the built in h1 tag in the dioxus_elements crate exported by the dioxus html crate - tag: dioxus_elements::h1::TAG_NAME, - namespace: dioxus_elements::h1::NAME_SPACE, - attrs: &[], - // The children of the h1 node - children: &[ - // The dynamic count text node - // Any nodes that are dynamic have a dynamic placeholder with a unique index - ::dioxus::core::TemplateNode::DynamicText { - // This index is used to find what element in `dynamic_nodes` to use instead of the placeholder - id: 0usize, - }, - ], - }, - // The up high button node - ::dioxus::core::TemplateNode::Element { - tag: dioxus_elements::button::TAG_NAME, - namespace: dioxus_elements::button::NAME_SPACE, - attrs: &[ - // The dynamic onclick listener attribute - // Any attributes that are dynamic have a dynamic placeholder with a unique index. - ::dioxus::core::TemplateAttribute::Dynamic { - // Similar to dynamic nodes, dynamic attributes have a unique index used to find the attribute in `dynamic_attrs` to use instead of the placeholder - id: 0usize, - }, - ], - children: &[::dioxus::core::TemplateNode::Text { text: "Up high!" }], - }, - // The down low button node - ::dioxus::core::TemplateNode::Element { - tag: dioxus_elements::button::TAG_NAME, - namespace: dioxus_elements::button::NAME_SPACE, - attrs: &[ - // The dynamic onclick listener attribute - ::dioxus::core::TemplateAttribute::Dynamic { id: 1usize }, - ], - children: &[::dioxus::core::TemplateNode::Text { text: "Down low!" }], - }, - ], - // Node paths is a list of paths to every dynamic node in the rsx - node_paths: &[ - // The first node path is the path to the dynamic node with an id of 0 (the count text node) - &[ - // Go to the index 0 root node - 0u8, - // - // Go to the first child of the root node - 0u8, - ], - ], - // Attr paths is a list of paths to every dynamic attribute in the rsx - attr_paths: &[ - // The first attr path is the path to the dynamic attribute with an id of 0 (the up high button onclick listener) - &[ - // Go to the index 1 root node - 1u8, - ], - // The second attr path is the path to the dynamic attribute with an id of 1 (the down low button onclick listener) - &[ - // Go to the index 2 root node - 2u8, - ], - ], - }; - // The VNode is a reference to the template with the dynamic parts of the rsx - ::dioxus::core::VNode::new( - None, - // The static template this node will use. The template is stored in a Cell so it can be replaced with a new template when hot rsx reloading is enabled - TEMPLATE, - dioxus::core::exports::bumpalo::collections::Vec::new_in(__cx.bump()), - __cx.bump().alloc([ - // The dynamic count text node (dynamic node id 0) - __cx.text_node(format_args!("High-Five counter: {0}", count)), - ]), - __cx.bump().alloc([ - // The dynamic up high button onclick listener (dynamic attribute id 0) - dioxus_elements::events::onclick(__cx, move |_| count += 1), - // The dynamic down low button onclick listener (dynamic attribute id 1) - dioxus_elements::events::onclick(__cx, move |_| count -= 1), - ]), - ) - }, - ), - ) -} diff --git a/docs/guide/examples/rendering_lists.rs b/docs/guide/examples/rendering_lists.rs deleted file mode 100644 index b95e712dc..000000000 --- a/docs/guide/examples/rendering_lists.rs +++ /dev/null @@ -1,98 +0,0 @@ -#![allow(non_snake_case)] - -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -#[derive(PartialEq, Clone)] -struct Comment { - content: String, - id: usize, -} - -#[rustfmt::skip] -pub fn App(cx: Scope) -> Element { - // ANCHOR: render_list -let comment_field = use_state(cx, String::new); -let mut next_id = use_state(cx, || 0); -let comments = use_ref(cx, Vec::::new); - -let comments_lock = comments.read(); -let comments_rendered = comments_lock.iter().map(|comment| { - rsx!(CommentComponent { - key: "{comment.id}", - comment: comment.clone(), - }) -}); - -cx.render(rsx!( - form { - onsubmit: move |_| { - comments.write().push(Comment { - content: comment_field.get().clone(), - id: *next_id.get(), - }); - next_id += 1; - - comment_field.set(String::new()); - }, - input { - value: "{comment_field}", - oninput: |event| comment_field.set(event.value.clone()), - } - input { - r#type: "submit", - } - }, - comments_rendered, -)) - // ANCHOR_END: render_list -} - -#[rustfmt::skip] -pub fn AppForLoop(cx: Scope) -> Element { - // ANCHOR: render_list_for_loop -let comment_field = use_state(cx, String::new); -let mut next_id = use_state(cx, || 0); -let comments = use_ref(cx, Vec::::new); - -cx.render(rsx!( - form { - onsubmit: move |_| { - comments.write().push(Comment { - content: comment_field.get().clone(), - id: *next_id.get(), - }); - next_id += 1; - - comment_field.set(String::new()); - }, - input { - value: "{comment_field}", - oninput: |event| comment_field.set(event.value.clone()), - } - input { - r#type: "submit", - } - }, - for comment in &*comments.read() { - // Notice the body of this for loop is rsx code, not an expression - CommentComponent { - key: "{comment.id}", - comment: comment.clone(), - } - } -)) - // ANCHOR_END: render_list_for_loop -} - -#[inline_props] -fn CommentComponent(cx: Scope, comment: Comment) -> Element { - cx.render(rsx!(div { - "Comment by anon:", - p { "{comment.content}" } - button { "Reply" }, - })) -} diff --git a/docs/guide/examples/rsx_overview.rs b/docs/guide/examples/rsx_overview.rs deleted file mode 100644 index 93c991d0d..000000000 --- a/docs/guide/examples/rsx_overview.rs +++ /dev/null @@ -1,169 +0,0 @@ -#![allow(non_snake_case)] - -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -pub fn App(cx: Scope) -> Element { - cx.render(rsx!( - Empty {}, - Children {}, - Fragments {}, - Attributes {}, - VariableAttributes {}, - CustomAttributes {}, - Formatting {}, - Expression {}, - )) -} - -#[rustfmt::skip] -pub fn Empty(cx: Scope) -> Element { - // ANCHOR: empty -cx.render(rsx!(div { - // attributes / listeners - // children -})) - // ANCHOR_END: empty -} - -#[rustfmt::skip] -pub fn Children(cx: Scope) -> Element { - // ANCHOR: children -cx.render(rsx!(ol { - li {"First Item"} - li {"Second Item"} - li {"Third Item"} -})) - // ANCHOR_END: children -} - -#[rustfmt::skip] -pub fn Fragments(cx: Scope) -> Element { - // ANCHOR: fragments -cx.render(rsx!( - p {"First Item"}, - p {"Second Item"}, - Fragment { - span { "a group" }, - span { "of three" }, - span { "items" }, - } -)) - // ANCHOR_END: fragments -} - -#[rustfmt::skip] -pub fn ManyRoots(cx: Scope) -> Element { - // ANCHOR: manyroots -cx.render(rsx!( - p {"First Item"}, - p {"Second Item"}, -)) - // ANCHOR_END: manyroots -} - -#[rustfmt::skip] -pub fn Attributes(cx: Scope) -> Element { - // ANCHOR: attributes -cx.render(rsx!(a { - href: "https://www.youtube.com/watch?v=dQw4w9WgXcQ", - class: "primary_button", - color: "red", -})) - // ANCHOR_END: attributes -} - -#[rustfmt::skip] -pub fn VariableAttributes(cx: Scope) -> Element { - // ANCHOR: variable_attributes -let written_in_rust = true; -let button_type = "button"; -cx.render(rsx!(button { - disabled: "{written_in_rust}", - class: "{button_type}", - "Rewrite it in rust" -})) - // ANCHOR_END: variable_attributes -} - -#[rustfmt::skip] -pub fn CustomAttributes(cx: Scope) -> Element { - // ANCHOR: custom_attributes - cx.render(rsx!(b { - "customAttribute": "value", - })) - // ANCHOR_END: custom_attributes -} - -#[rustfmt::skip] -pub fn Formatting(cx: Scope) -> Element { - // ANCHOR: formatting -let coordinates = (42, 0); -let country = "es"; -cx.render(rsx!(div { - class: "country-{country}", - "position": "{coordinates:?}", - // arbitrary expressions are allowed, - // as long as they don't contain `{}` - div { - "{country.to_uppercase()}" - }, - div { - "{7*6}" - }, - // {} can be escaped with {{}} - div { - "{{}}" - }, -})) -// ANCHOR_END: formatting -} - -#[rustfmt::skip] -pub fn Expression(cx: Scope) -> Element { - // ANCHOR: expression -let text = "Dioxus"; -cx.render(rsx!(span { - text.to_uppercase(), - // create a list of text from 0 to 9 - (0..10).map(|i| rsx!{ i.to_string() }) -})) - // ANCHOR_END: expression -} - -#[rustfmt::skip] -pub fn Loops(cx: Scope) -> Element { - // ANCHOR: loops -cx.render(rsx!{ - // use a for loop where the body itself is RSX - div { - // create a list of text from 0 to 9 - for i in 0..3 { - // NOTE: the body of the loop is RSX not a rust statement - div { - "{i}" - } - } - } - // iterator equivalent - div { - (0..3).map(|i| rsx!{ div { "{i}" } }) - } -}) - // ANCHOR_END: loops -} - -#[rustfmt::skip] -pub fn IfStatements(cx: Scope) -> Element { - // ANCHOR: ifstatements -cx.render(rsx!{ - // use if statements without an else - if true { - rsx!(div { "true" }) - } -}) - // ANCHOR_END: ifstatements -} diff --git a/docs/guide/examples/server_basic.rs b/docs/guide/examples/server_basic.rs deleted file mode 100644 index 858fcfd50..000000000 --- a/docs/guide/examples/server_basic.rs +++ /dev/null @@ -1,30 +0,0 @@ -#![allow(non_snake_case, unused)] -use dioxus::prelude::*; - -#[tokio::main] -async fn main() { - #[cfg(feature = "ssr")] - { - use dioxus_fullstack::prelude::*; - - let addr = std::net::SocketAddr::from(([127, 0, 0, 1], 8080)); - axum::Server::bind(&addr) - .serve( - axum::Router::new() - .serve_dioxus_application("", ServeConfigBuilder::new(app, ())) - .into_make_service(), - ) - .await - .unwrap(); - } -} - -fn app(cx: Scope) -> Element { - let mut count = use_state(cx, || 0); - - cx.render(rsx! { - h1 { "High-Five counter: {count}" } - button { onclick: move |_| count += 1, "Up high!" } - button { onclick: move |_| count -= 1, "Down low!" } - }) -} diff --git a/docs/guide/examples/server_context.rs b/docs/guide/examples/server_context.rs deleted file mode 100644 index 172b978e9..000000000 --- a/docs/guide/examples/server_context.rs +++ /dev/null @@ -1,109 +0,0 @@ -#![allow(non_snake_case, unused)] -use dioxus::prelude::*; -use dioxus_fullstack::prelude::*; - -fn main() { - #[cfg(feature = "web")] - dioxus_web::launch_with_props( - app, - // Get the root props from the document - get_root_props_from_document().unwrap_or_default(), - dioxus_web::Config::new().hydrate(true), - ); - #[cfg(feature = "ssr")] - { - use axum::extract::Path; - use axum::extract::State; - use axum::routing::get; - - tokio::runtime::Runtime::new() - .unwrap() - .block_on(async move { - let addr = std::net::SocketAddr::from(([127, 0, 0, 1], 8080)); - axum::Server::bind(&addr) - .serve( - axum::Router::new() - // Serve the dist folder with the static javascript and WASM files created by the dixous CLI - .serve_static_assets("./dist") - // Register server functions - .register_server_fns("") - // Connect to the hot reload server in debug mode - .connect_hot_reload() - // Render the application. This will serialize the root props (the intial count) into the HTML - .route( - "/", - get(move |State(ssr_state): State| async move { axum::body::Full::from( - ssr_state.render( - &ServeConfigBuilder::new( - app, - 0, - ) - .build(), - ) - )}), - ) - // Render the application with a different intial count - .route( - "/:initial_count", - get(move |Path(intial_count): Path, State(ssr_state): State| async move { axum::body::Full::from( - ssr_state.render( - &ServeConfigBuilder::new( - app, - intial_count, - ) - .build(), - ) - )}), - ) - .with_state(SSRState::default()) - .into_make_service(), - ) - .await - .unwrap(); - }); - } -} - -fn app(cx: Scope) -> Element { - let mut count = use_state(cx, || *cx.props); - - cx.render(rsx! { - h1 { "High-Five counter: {count}" } - button { onclick: move |_| count += 1, "Up high!" } - button { onclick: move |_| count -= 1, "Down low!" } - button { - onclick: move |_| { - to_owned![count]; - async move { - // Call the server function just like a local async function - if let Ok(new_count) = double_server(*count.current()).await { - count.set(new_count); - } - } - }, - "Double" - } - }) -} - -// We use the "getcbor" encoding to make caching easier -#[server(DoubleServer, "", "getcbor")] -async fn double_server(number: usize) -> Result { - let cx = server_context(); - // Perform some expensive computation or access a database on the server - tokio::time::sleep(std::time::Duration::from_secs(1)).await; - let result = number * 2; - - println!( - "User Agent {:?}", - cx.request_parts().headers.get("User-Agent") - ); - - // Set the cache control header to 1 hour on the post request - cx.response_headers_mut() - .insert("Cache-Control", "max-age=3600".parse().unwrap()); - - println!("server calculated {result}"); - - Ok(result) -} diff --git a/docs/guide/examples/server_context_state.rs b/docs/guide/examples/server_context_state.rs deleted file mode 100644 index 0f0b541cc..000000000 --- a/docs/guide/examples/server_context_state.rs +++ /dev/null @@ -1,134 +0,0 @@ -#![allow(non_snake_case, unused)] -use dioxus::prelude::*; -use dioxus_fullstack::prelude::*; - -#[cfg(feature = "ssr")] -#[derive(Default, Clone)] -struct ServerFunctionState { - call_count: std::sync::Arc, -} - -fn main() { - #[cfg(feature = "web")] - dioxus_web::launch_with_props( - app, - // Get the root props from the document - get_root_props_from_document().unwrap_or_default(), - dioxus_web::Config::new().hydrate(true), - ); - #[cfg(feature = "ssr")] - { - use axum::body::Body; - use axum::extract::Path; - use axum::extract::State; - use axum::http::Request; - use axum::routing::get; - use std::sync::Arc; - - tokio::runtime::Runtime::new() - .unwrap() - .block_on(async move { - let addr = std::net::SocketAddr::from(([127, 0, 0, 1], 8080)); - axum::Server::bind(&addr) - .serve( - axum::Router::new() - // Serve the dist folder with the static javascript and WASM files created by the dixous CLI - .serve_static_assets("./dist") - // Register server functions - .register_server_fns_with_handler("", |func| { - move |State(server_fn_state): State, req: Request| async move { - let (parts, body) = req.into_parts(); - let parts: Arc = Arc::new(parts.into()); - let mut server_context = DioxusServerContext::new(parts.clone()); - server_context.insert(server_fn_state); - server_fn_handler(server_context, func.clone(), parts, body).await - } - }) - .with_state(ServerFunctionState::default()) - // Connect to the hot reload server in debug mode - .connect_hot_reload() - // Render the application. This will serialize the root props (the intial count) into the HTML - .route( - "/", - get(move |State(ssr_state): State| async move { axum::body::Full::from( - ssr_state.render( - &ServeConfigBuilder::new( - app, - 0, - ) - .build(), - ) - )}), - ) - // Render the application with a different intial count - .route( - "/:initial_count", - get(move |Path(intial_count): Path, State(ssr_state): State| async move { axum::body::Full::from( - ssr_state.render( - &ServeConfigBuilder::new( - app, - intial_count, - ) - .build(), - ) - )}), - ) - .with_state(SSRState::default()) - .into_make_service(), - ) - .await - .unwrap(); - }); - } -} - -fn app(cx: Scope) -> Element { - let mut count = use_state(cx, || *cx.props); - - cx.render(rsx! { - h1 { "High-Five counter: {count}" } - button { onclick: move |_| count += 1, "Up high!" } - button { onclick: move |_| count -= 1, "Down low!" } - button { - onclick: move |_| { - to_owned![count]; - async move { - // Call the server function just like a local async function - if let Ok(new_count) = double_server(*count.current()).await { - count.set(new_count); - } - } - }, - "Double" - } - }) -} - -// We use the "getcbor" encoding to make caching easier -#[server(DoubleServer, "", "getcbor")] -async fn double_server(number: usize) -> Result { - // Perform some expensive computation or access a database on the server - tokio::time::sleep(std::time::Duration::from_secs(1)).await; - let result = number * 2; - let cx = server_context(); - - println!( - "User Agent {:?}", - cx.request_parts().headers.get("User-Agent") - ); - - // Set the cache control header to 1 hour on the post request - cx.response_headers_mut() - .insert("Cache-Control", "max-age=3600".parse().unwrap()); - - // Get the server function state - let server_fn_state = cx.get::().unwrap(); - let call_count = server_fn_state - .call_count - .fetch_add(1, std::sync::atomic::Ordering::SeqCst); - println!("server functions have been called {call_count} times"); - - println!("server calculated {result}"); - - Ok(result) -} diff --git a/docs/guide/examples/server_function.rs b/docs/guide/examples/server_function.rs deleted file mode 100644 index 55f5104f9..000000000 --- a/docs/guide/examples/server_function.rs +++ /dev/null @@ -1,96 +0,0 @@ -#![allow(non_snake_case, unused)] -use dioxus::prelude::*; -use dioxus_fullstack::prelude::*; - -fn main() { - #[cfg(feature = "web")] - dioxus_web::launch_with_props( - app, - // Get the root props from the document - get_root_props_from_document().unwrap_or_default(), - dioxus_web::Config::new().hydrate(true), - ); - #[cfg(feature = "ssr")] - { - use axum::extract::Path; - use axum::extract::State; - use axum::routing::get; - - tokio::runtime::Runtime::new() - .unwrap() - .block_on(async move { - let addr = std::net::SocketAddr::from(([127, 0, 0, 1], 8080)); - axum::Server::bind(&addr) - .serve( - axum::Router::new() - // Serve the dist folder with the static javascript and WASM files created by the dixous CLI - .serve_static_assets("./dist") - // Register server functions - .register_server_fns("") - // Connect to the hot reload server in debug mode - .connect_hot_reload() - // Render the application. This will serialize the root props (the intial count) into the HTML - .route( - "/", - get(move |Path(intial_count): Path, State(ssr_state): State| async move { axum::body::Full::from( - ssr_state.render( - &ServeConfigBuilder::new( - app, - intial_count, - ) - .build(), - ) - )}), - ) - // Render the application with a different intial count - .route( - "/:initial_count", - get(move |Path(intial_count): Path, State(ssr_state): State| async move { axum::body::Full::from( - ssr_state.render( - &ServeConfigBuilder::new( - app, - intial_count, - ) - .build(), - ) - )}), - ) - .with_state(SSRState::default()) - .into_make_service(), - ) - .await - .unwrap(); - }); - } -} - -fn app(cx: Scope) -> Element { - let mut count = use_state(cx, || *cx.props); - - cx.render(rsx! { - h1 { "High-Five counter: {count}" } - button { onclick: move |_| count += 1, "Up high!" } - button { onclick: move |_| count -= 1, "Down low!" } - button { - onclick: move |_| { - to_owned![count]; - async move { - // Call the server function just like a local async function - if let Ok(new_count) = double_server(*count.current()).await { - count.set(new_count); - } - } - }, - "Double" - } - }) -} - -#[server(DoubleServer)] -async fn double_server(number: usize) -> Result { - // Perform some expensive computation or access a database on the server - tokio::time::sleep(std::time::Duration::from_secs(1)).await; - let result = number * 2; - println!("server calculated {result}"); - Ok(result) -} diff --git a/docs/guide/examples/spawn.rs b/docs/guide/examples/spawn.rs deleted file mode 100644 index 90c311200..000000000 --- a/docs/guide/examples/spawn.rs +++ /dev/null @@ -1,84 +0,0 @@ -#![allow(non_snake_case, unused)] - -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -fn App(cx: Scope) -> Element { - // ANCHOR: spawn - let logged_in = use_state(cx, || false); - - let log_in = move |_| { - cx.spawn({ - let logged_in = logged_in.to_owned(); - - async move { - let resp = reqwest::Client::new() - .post("http://example.com/login") - .send() - .await; - - match resp { - Ok(_data) => { - println!("Login successful!"); - logged_in.set(true); - } - Err(_err) => { - println!( - "Login failed - you need a login server running on localhost:8080." - ) - } - } - } - }); - }; - - cx.render(rsx! { - button { - onclick: log_in, - "Login", - } - }) - // ANCHOR_END: spawn -} - -pub fn Tokio(cx: Scope) -> Element { - let _ = || { - // ANCHOR: tokio - cx.spawn(async { - let _ = tokio::spawn(async {}).await; - - let _ = tokio::task::spawn_local(async { - // some !Send work - }) - .await; - }); - // ANCHOR_END: tokio - }; - - cx.render(rsx!(())) -} - -pub fn ToOwnedMacro(cx: Scope) -> Element { - let count = use_state(cx, || 0); - let age = use_state(cx, || 0); - let name = use_state(cx, || 0); - let description = use_state(cx, || 0); - - let _ = || { - // ANCHOR: to_owned_macro - use dioxus::hooks::to_owned; - - cx.spawn({ - to_owned![count, age, name, description]; - async move { - // ... - } - }); - // ANCHOR_END: to_owned_macro - }; - - cx.render(rsx!(())) -} diff --git a/docs/guide/examples/use_future.rs b/docs/guide/examples/use_future.rs deleted file mode 100644 index 01464704a..000000000 --- a/docs/guide/examples/use_future.rs +++ /dev/null @@ -1,62 +0,0 @@ -#![allow(non_snake_case, unused)] - -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(App); -} - -#[derive(serde::Deserialize, Debug)] -struct ApiResponse { - #[serde(rename = "message")] - image_url: String, -} - -#[rustfmt::skip] -fn App(cx: Scope) -> Element { -// ANCHOR: use_future -let future = use_future(cx, (), |_| async move { - reqwest::get("https://dog.ceo/api/breeds/image/random") - .await - .unwrap() - .json::() - .await -}); -// ANCHOR_END: use_future - -// ANCHOR: render -cx.render(match future.value() { - Some(Ok(response)) => rsx! { - button { - onclick: move |_| future.restart(), - "Click to fetch another doggo" - } - div { - img { - max_width: "500px", - max_height: "500px", - src: "{response.image_url}", - } - } - }, - Some(Err(_)) => rsx! { div { "Loading dogs failed" } }, - None => rsx! { div { "Loading dogs..." } }, -}) -// ANCHOR_END: render -} - -#[rustfmt::skip] -#[inline_props] -fn RandomDog(cx: Scope, breed: String) -> Element { -// ANCHOR: dependency -let future = use_future(cx, (breed,), |(breed,)| async move { - reqwest::get(format!("https://dog.ceo/api/breed/{breed}/images/random")) - .await - .unwrap() - .json::() - .await -}); -// ANCHOR_END: dependency - - cx.render(rsx!(())) -} diff --git a/docs/guide/src/en/SUMMARY.md b/docs/guide/src/en/SUMMARY.md deleted file mode 100644 index a44439200..000000000 --- a/docs/guide/src/en/SUMMARY.md +++ /dev/null @@ -1,57 +0,0 @@ -# Summary - -[Introduction](index.md) - -- [Getting Started](getting_started/index.md) - - [Desktop](getting_started/desktop.md) - - [Web](getting_started/web.md) - - [Server-Side Rendering](getting_started/ssr.md) - - [Fullstack](getting_started/fullstack.md) - - [Liveview](getting_started/liveview.md) - - [Terminal UI](getting_started/tui.md) - - [Mobile](getting_started/mobile.md) - - [Hot Reloading](getting_started/hot_reload.md) -- [Describing the UI](describing_ui/index.md) - - [Special Attributes](describing_ui/special_attributes.md) - - [Components](describing_ui/components.md) - - [Props](describing_ui/component_props.md) - - [Component Children](describing_ui/component_children.md) -- [Interactivity](interactivity/index.md) - - [Event Listeners](interactivity/event_handlers.md) - - [Hooks & Component State](interactivity/hooks.md) - - [User Input](interactivity/user_input.md) - - [Sharing State](interactivity/sharing_state.md) - - [Memoization](interactivity/memoization.md) - - [Custom Hooks](interactivity/custom_hooks.md) - - [Dynamic Rendering](interactivity/dynamic_rendering.md) - - [Routing](interactivity/router.md) -- [Async](async/index.md) - - [UseEffect](async/use_effect.md) - - [UseFuture](async/use_future.md) - - [UseCoroutine](async/use_coroutine.md) - - [Spawning Futures](async/spawn.md) -- [Best Practices](best_practices/index.md) - - [Error Handling](best_practices/error_handling.md) - - [Antipatterns](best_practices/antipatterns.md) -- [Publishing](publishing/index.md) - - - [Desktop](publishing/desktop.md) - - [Web](publishing/web.md) - ---- - -- [Fullstack](fullstack/index.md) - - [Getting Started](fullstack/getting_started.md) - - [Communicating with the Server](fullstack/server_functions.md) - ---- - -- [Custom Renderer](custom_renderer/index.md) - ---- - -- [Contributing](contributing/index.md) - - [Project Structure](contributing/project_structure.md) - - [Walkthrough of Internals](contributing/walkthrough_readme.md) - - [Guiding Principles](contributing/guiding_principles.md) - - [Roadmap](contributing/roadmap.md) diff --git a/docs/guide/src/en/__unused/README.md b/docs/guide/src/en/__unused/README.md deleted file mode 100644 index 0a3583ef1..000000000 --- a/docs/guide/src/en/__unused/README.md +++ /dev/null @@ -1,6 +0,0 @@ -This directory includes: - -- Very outdated docs -- Docs for features which haven't been implemented (yet?) -- Information which has already been covered in the guide in a more organized fashion -- A few things yet to be integrated into the guide nicely \ No newline at end of file diff --git a/docs/guide/src/en/__unused/advanced-guides/06-subscription-api.md b/docs/guide/src/en/__unused/advanced-guides/06-subscription-api.md deleted file mode 100644 index 1d53a8d61..000000000 --- a/docs/guide/src/en/__unused/advanced-guides/06-subscription-api.md +++ /dev/null @@ -1,33 +0,0 @@ -# Subscriptions - -Yew subscriptions are used to schedule update for components into the future. The `Context` object can create subscriptions: - -```rust, no_run -fn Component(cx: Component) -> DomTree { - let update = cx.schedule(); - - // Now, when the subscription is called, the component will be re-evaluated - update.consume(); -} -``` - -Whenever a component's subscription is called, the component will then re-evaluated. You can consider the input properties of -a component to be just another form of subscription. By default, the Dioxus component system automatically diffs a component's props -when the parent function is called, and if the props are different, the child component's subscription is called. - -The subscription API exposes this functionality allowing hooks and state management solutions the ability to update components whenever -some state or event occurs outside of the component. For instance, the `use_context` hook uses this to subscribe components that use a -particular context. - -```rust, no_run -fn use_context(cx: Scope) -> I { - -} - - - - - - - -``` diff --git a/docs/guide/src/en/__unused/advanced-guides/10-concurrent-mode.md b/docs/guide/src/en/__unused/advanced-guides/10-concurrent-mode.md deleted file mode 100644 index b92897157..000000000 --- a/docs/guide/src/en/__unused/advanced-guides/10-concurrent-mode.md +++ /dev/null @@ -1,82 +0,0 @@ -# Concurrent mode - -Concurrent mode provides a mechanism for building efficient asynchronous components. With this feature, components don't need to render immediately, and instead can schedule a future render by returning a future. - -To make a component asynchronous, simply change its function signature to async. - -```rust, no_run -fn Example(cx: Scope) -> Vnode { - rsx!{
"Hello world!"
} -} -``` - -becomes - -```rust, no_run -async fn Example(cx: Scope) -> Vnode { - rsx!{
"Hello world!"
} -} -``` - -Now, logic in components can be awaited to delay updates of the component and its children. Like so: - -```rust, no_run -async fn Example(cx: Scope) -> Vnode { - let name = fetch_name().await; - rsx!{
"Hello {name}"
} -} - -async fetch_name() -> String { - // ... -} -``` - -This component will only schedule its render once the fetch is complete. However, we _don't_ recommend using async/await directly in your components. - -Async is a notoriously challenging yet rewarding tool for efficient tools. If not careful, locking and unlocking shared aspects of the component's context can lead to data races and panics. If a shared resource is locked while the component is awaiting, then other components can be locked or panic when trying to access the same resource. These rules are especially important when references to shared global state are accessed using the context object's lifetime. If mutable references to data captured immutably by the context are taken, then the component will panic, causing confusion. - -Instead, we suggest using hooks and future combinators that can safely utilize the safeguards of the component's Context when interacting with async tasks. - -As part of our Dioxus hooks crate, we provide a data loader hook which pauses a component until its async dependencies are ready. This caches requests, reruns the fetch if dependencies have changed, and provides the option to render something else while the component is loading. - -```rust, no_run -async fn ExampleLoader(cx: Scope) -> Vnode { - /* - Fetch, pause the component from rendering at all. - - The component is locked while waiting for the request to complete - While waiting, an alternate component is scheduled in its place. - - This API stores the result on the Context object, so the loaded data is taken as reference. - */ - let name: &Result = use_fetch_data("http://example.com/json", ()) - .place_holder(|cx| rsx!{
"loading..."
}) - .delayed_place_holder(1000, |cx| rsx!{
"still loading..."
}) - .await; - - match name { - Ok(name) => rsx! {
"Hello {something}"
}, - Err(e) => rsx! {
"An error occurred :("
} - } -} -``` - -```rust, no_run -async fn Example(cx: Scope) -> DomTree { - // Diff this set between the last set - // Check if we have any outstanding tasks? - // - // Eventually, render the component into the VDOM when the future completes -
- -
- - // Render a div, queue a component - // Render the placeholder first, then when the component is ready, then render the component -
- "Loading"
}}> - - -
-} -``` diff --git a/docs/guide/src/en/__unused/advanced-guides/11-arena-memo.md b/docs/guide/src/en/__unused/advanced-guides/11-arena-memo.md deleted file mode 100644 index 49fedda11..000000000 --- a/docs/guide/src/en/__unused/advanced-guides/11-arena-memo.md +++ /dev/null @@ -1,58 +0,0 @@ -# Memoization and the arena allocator - -Dioxus differs slightly from other UI virtual doms in some subtle ways due to its memory allocator. - -One important aspect to understand is how props are passed down from parent components to children. All "components" (custom user-made UI elements) are tightly allocated together in an arena. However, because props and hooks are generically typed, they are casted to `Any` and allocated on the heap – not in the arena with the components. - -With this system, we try to be more efficient when leaving the component arena and entering the heap. By default, props are memoized between renders using COW and context. This makes props comparisons fast – done via ptr comparisons on the cow pointer. Because memoization is done by default, parent re-renders will _not_ cascade to children if the child's props did not change. - -https://dmitripavlutin.com/use-react-memo-wisely/ - -This behavior is defined as an attribute implicit to user components. When in React land you might wrap a component with `react.memo`, Dioxus components are automatically memoized via an implicit attribute. You can manually configure this behavior on any component with "nomemo" to disable memoization. - -```rust, no_run -fn test() -> DomTree { - html! { - <> - - // same as - - - } -} - -static TestComponent: Component = |cx| html!{
"Hello world"
}; - -static TestComponent: Component = |cx|{ - let g = "BLAH"; - html! { -
"Hello world"
- } -}; - -#[inline_props] -fn test_component(cx: Scope, name: String) -> Element { - render!("Hello, {name}") -} -``` - -## Why this behavior? - -"This is different than React, why differ?". - -Take a component like this: - -```rust, no_run -fn test(cx: Scope) -> DomTree { - let Bundle { alpha, beta, gamma } = use_context::(cx); - html! { -
- - - -
- } -} -``` - -While the contents of the destructured bundle might change, not every child component will need to be re-rendered every time the context changes. diff --git a/docs/guide/src/en/__unused/advanced-guides/12-signals.md b/docs/guide/src/en/__unused/advanced-guides/12-signals.md deleted file mode 100644 index 7fbb56de7..000000000 --- a/docs/guide/src/en/__unused/advanced-guides/12-signals.md +++ /dev/null @@ -1,150 +0,0 @@ -# Signals: Skipping the Diff - -In most cases, the traditional VirtualDOM diffing pattern is plenty fast. Dioxus will compare trees of VNodes, find the differences, and then update the Renderer's DOM with the diffs. However, this can generate a lot of overhead for certain types of components. In apps where reducing visual latency is a top priority, you can opt into the `Signals` api to entirely disable diffing of hot-path components. Dioxus will then automatically construct a state machine for your component, making updates nearly instant. - -Signals build on the same infrastructure that powers asynchronous rendering where in-tree values can be updated outside of the render phase. In async rendering, a future is used as the signal source. With the raw signal API, any value can be used as a signal source. - -By default, Dioxus will only try to diff subtrees of components with dynamic content, automatically skipping diffing static content. - -## What does this look like? - -Your component today might look something like this: - -```rust, no_run -fn Comp(cx: Scope) -> DomTree { - let (title, set_title) = use_state(cx, || "Title".to_string()); - cx.render(rsx!{ - input { - value: title, - onchange: move |new| set_title(new.value()) - } - }) -} -``` - -This component is fairly straightforward – the input updates its own value on every change. However, every call to set_title will re-render the component. If we add a large list, then every time we update the title input, Dioxus will need to diff the entire list, over, and over, and over. This is **a lot** of wasted clock-cycles! - -```rust, no_run -fn Comp(cx: Scope) -> DomTree { - let (title, set_title) = use_state(cx, || "Title".to_string()); - cx.render(rsx!{ - div { - input { - value: title, - onchange: move |new| set_title(new.value()) - } - ul { - {0..10000.map(|f| rsx!{ - li { "{f}" } - })} - } - } - }) -} -``` - -Many experienced React developers will just say "this is bad design" – but we consider it to be a pit of failure, rather than a pit of success! That's why signals exist – to push you in a more performant (and ergonomic) direction. Signals let us directly bind values to their final place in the VirtualDOM. Whenever the signal value is updated, Dioxus will only the DOM nodes where that signal is used. Signals are built into Dioxus, so we can directly bind attributes of elements to their updates. - -We can use signals to generate a two-way binding between data and the input box. Our text input is now just a two-line component! - -```rust, no_run -fn Comp(cx: Scope) -> DomTree { - let mut title = use_signal(cx, || String::from("Title")); - cx.render(rsx!(input { value: title })) -} -``` - -For a slightly more interesting example, this component calculates the sum between two numbers, but totally skips the diffing process. - -```rust, no_run -fn Calculator(cx: Scope) -> DomTree { - let mut a = use_signal(cx, || 0); - let mut b = use_signal(cx, || 0); - let mut c = a + b; - rsx! { - input { value: a } - input { value: b } - p { "a + b = {c}" } - } -} -``` - -Do you notice how we can use built-in operations on signals? Under the hood, we actually create a new derived signal that depends on `a` and `b`. Whenever `a` or `b` update, then `c` will update. If we need to create a new derived signal that's more complex than a basic operation (`std::ops`) we can either chain signals together or combine them: - -```rust, no_run -let mut a = use_signal(cx, || 0); -let mut b = use_signal(cx, || 0); - -// Chain signals together using the `with` method -let c = a.with(b).map(|(a, b)| *a + *b); -``` - -## Deref and DerefMut - -If we ever need to get the value out of a signal, we can simply `deref` it. - -```rust, no_run -let mut a = use_signal(cx, || 0); -let c = *a + *b; -``` - -Calling `deref` or `deref_mut` is actually more complex than it seems. When a value is derefed, you're essentially telling Dioxus that _this_ element _needs_ to be subscribed to the signal. If a signal is derefed outside of an element, the entire component will be subscribed and the advantage of skipping diffing will be lost. Dioxus will throw an error in the console when this happens to tell you that you're using signals wrong, but your component will continue to work. - -## Global Signals - -Sometimes you want a signal to propagate across your app, either through far-away siblings or through deeply-nested components. In these cases, we use Dirac: Dioxus's first-class state management toolkit. Dirac atoms automatically implement the Signal API. This component will bind the input element to the `TITLE` atom. - - -```rust, no_run -const TITLE: Atom = Atom(|| "".to_string()); - -const Provider: Component = |cx|{ - let title = use_signal(cx, &TITLE); - render!(input { value: title }) -}; -``` - -If we use the `TITLE` atom in another component, we can cause updates to flow between components without calling render or diffing either component trees: - -```rust, no_run -const Receiver: Component = |cx|{ - let title = use_signal(cx, &TITLE); - log::info!("This will only be called once!"); - rsx!(cx, - div { - h1 { "{title}" } - div {} - footer {} - } - ) -}; -``` - -Dioxus knows that the receiver's `title` signal is used only in the text node, and skips diffing Receiver entirely, knowing to update _just_ the text node. - -If you build a complex app on top of Dirac, you'll likely notice that many of your components simply won't be diffed at all. For instance, our Receiver component will never be diffed once it has been mounted! - -## Signals and Iterators - -Sometimes you want to use a collection of items. With Signals, you can bypass diffing for collections – a very powerful technique to avoid re-rendering on large collections. - -By default, Dioxus is limited when you use iter/map. With the `For` component, you can provide an iterator and a function for the iterator to map to. - -Dioxus automatically understands how to use your signals when mixed with iterators through `Deref`/`DerefMut`. This lets you efficiently map collections while avoiding the re-rendering of lists. In essence, signals act as a hint to Dioxus on how to avoid un-necessary checks and renders, making your app faster. - -```rust, no_run -const DICT: AtomFamily = AtomFamily(|_| {}); - -const List: Component = |cx|{ - let dict = use_signal(cx, &DICT); - cx.render(rsx!( - ul { - For { each: dict, map: |k, v| rsx!( li { "{v}" }) } - } - )) -}; -``` - -## How does it work? - -Signals internally use Dioxus' asynchronous rendering infrastructure to perform updates out of the tree. diff --git a/docs/guide/src/en/__unused/advanced-guides/13-subtrees.md b/docs/guide/src/en/__unused/advanced-guides/13-subtrees.md deleted file mode 100644 index d7a8ba1d7..000000000 --- a/docs/guide/src/en/__unused/advanced-guides/13-subtrees.md +++ /dev/null @@ -1,52 +0,0 @@ -# Subtrees - -One way of extending the Dioxus VirtualDom is through the use of "Subtrees." Subtrees are chunks of the VirtualDom tree distinct from the rest of the tree. They still participate in event bubbling, diffing, etc, but will have a separate set of edits generated during the diff phase. - -For a VirtualDom that has a root tree with two subtrees, the edits follow a pattern of: - -Root --> Tree 1 --> Tree 2 --> Original root tree - -- Root edits -- Tree 1 Edits -- Tree 2 Edits -- Root Edits - -The goal of this functionality is to enable things like Portals, Windows, and inline alternative renderers without needing to spin up a new VirtualDom. - -With the right renderer plugins, a subtree could be rendered as anything – a 3D scene, SVG, or even as the contents of a new window or modal. This functionality is similar to "Portals" in React, but much more "renderer agnostic." Portals, by nature, are not necessarily cross-platform and rely on renderer functionality, so it makes sense to abstract their purpose into the subtree concept. - -The desktop renderer comes pre-loaded with the window and notification subtree plugins, making it possible to render subtrees into entirely different windows. - -Subtrees also solve the "bridging" issues in React where two different renderers need two different VirtualDoms to work properly. In Dioxus, you only ever need one VirtualDom and the right renderer plugins. - -## API - -Due to their importance in the hierarchy, Components – not nodes – are treated as subtree roots. - -```rust, no_run - -fn Subtree

(cx: Scope

) -> DomTree { - -} - -fn Window() -> DomTree { - Subtree { - onassign: move |e| { - // create window - } - children() - } -} - -fn 3dRenderer -> DomTree { - Subtree { - onassign: move |e| { - // initialize bevy - } - } -} - -``` diff --git a/docs/guide/src/en/__unused/advanced-guides/custom-renderer.md b/docs/guide/src/en/__unused/advanced-guides/custom-renderer.md deleted file mode 100644 index b14243dae..000000000 --- a/docs/guide/src/en/__unused/advanced-guides/custom-renderer.md +++ /dev/null @@ -1,280 +0,0 @@ -# Custom Renderer - -Dioxus is an incredibly portable framework for UI development. The lessons, knowledge, hooks, and components you acquire over time can always be used for future projects. However, sometimes those projects cannot leverage a supported renderer or you need to implement your own better renderer. - -Great news: the design of the renderer is entirely up to you! We provide suggestions and inspiration with the 1st party renderers, but only really require implementation of the `RealDom` trait for things to function properly. - -## The specifics: - -Implementing the renderer is fairly straightforward. The renderer needs to: - -1. Handle the stream of edits generated by updates to the virtual DOM -2. Register listeners and pass events into the virtual DOM's event system -3. Progress the virtual DOM with an async executor (or disable the suspense API and use `progress_sync`) - -Essentially, your renderer needs to implement the `RealDom` trait and generate `EventTrigger` objects to update the VirtualDOM. From there, you'll have everything needed to render the VirtualDOM to the screen. - -Internally, Dioxus handles the tree relationship, diffing, memory management, and the event system, leaving as little as possible required for renderers to implement themselves. - -For reference, check out the WebSys renderer as a starting point for your custom renderer. - -## Trait implementation and DomEdits - -The current `RealDom` trait lives in `dioxus-core/diff`. A version of it is provided here (but might not be up-to-date): - -```rust, no_run -pub trait RealDom<'a> { - fn handle_edit(&mut self, edit: DomEdit); - fn request_available_node(&mut self) -> ElementId; - fn raw_node_as_any(&self) -> &mut dyn Any; -} -``` - -For reference, the "DomEdit" type is a serialized enum that represents an atomic operation occurring on the RealDom. The variants roughly follow this set: - -```rust, no_run -enum DomEdit { - PushRoot, - AppendChildren, - ReplaceWith, - CreateTextNode, - CreateElement, - CreateElementNs, - CreatePlaceholder, - NewEventListener, - RemoveEventListener, - SetText, - SetAttribute, - RemoveAttribute, -} -``` - -The Dioxus diffing mechanism operates as a [stack machine](https://en.wikipedia.org/wiki/Stack_machine) where the "push_root" method pushes a new "real" DOM node onto the stack and "append_child" and "replace_with" both remove nodes from the stack. - -### An example - -For the sake of understanding, lets consider this example – a very simple UI declaration: - -```rust, no_run -rsx!( h1 {"hello world"} ) -``` - -To get things started, Dioxus must first navigate to the container of this h1 tag. To "navigate" here, the internal diffing algorithm generates the DomEdit `PushRoot` where the ID of the root is the container. - -When the renderer receives this instruction, it pushes the actual Node onto its own stack. The real renderer's stack will look like this: - -```rust, no_run -instructions: [ - PushRoot(Container) -] -stack: [ - ContainerNode, -] -``` - -Next, Dioxus will encounter the h1 node. The diff algorithm decides that this node needs to be created, so Dioxus will generate the DomEdit `CreateElement`. When the renderer receives this instruction, it will create an unmounted node and push into its own stack: - -```rust, no_run -instructions: [ - PushRoot(Container), - CreateElement(h1), -] -stack: [ - ContainerNode, - h1, -] -``` - -Next, Dioxus sees the text node, and generates the `CreateTextNode` DomEdit: - -```rust, no_run -instructions: [ - PushRoot(Container), - CreateElement(h1), - CreateTextNode("hello world") -] -stack: [ - ContainerNode, - h1, - "hello world" -] -``` - -Remember, the text node is not attached to anything (it is unmounted) so Dioxus needs to generate an Edit that connects the text node to the h1 element. It depends on the situation, but in this case we use `AppendChildren`. This pops the text node off the stack, leaving the h1 element as the next element in line. - -```rust, no_run -instructions: [ - PushRoot(Container), - CreateElement(h1), - CreateTextNode("hello world"), - AppendChildren(1) -] -stack: [ - ContainerNode, - h1 -] -``` - -We call `AppendChildren` again, popping off the h1 node and attaching it to the parent: - -```rust, no_run -instructions: [ - PushRoot(Container), - CreateElement(h1), - CreateTextNode("hello world"), - AppendChildren(1), - AppendChildren(1) -] -stack: [ - ContainerNode, -] -``` - -Finally, the container is popped since we don't need it anymore. - -```rust, no_run -instructions: [ - PushRoot(Container), - CreateElement(h1), - CreateTextNode("hello world"), - AppendChildren(1), - AppendChildren(1), - Pop(1) -] -stack: [] -``` - -Over time, our stack looked like this: - -```rust, no_run -[] -[Container] -[Container, h1] -[Container, h1, "hello world"] -[Container, h1] -[Container] -[] -``` - -Notice how our stack is empty once UI has been mounted. Conveniently, this approach completely separates the VirtualDOM and the Real DOM. Additionally, these edits are serializable, meaning we can even manage UIs across a network connection. This little stack machine and serialized edits makes Dioxus independent of platform specifics. - -Dioxus is also really fast. Because Dioxus splits the diff and patch phase, it's able to make all the edits to the RealDOM in a very short amount of time (less than a single frame) making rendering very snappy. It also allows Dioxus to cancel large diffing operations if higher priority work comes in while it's diffing. - -It's important to note that there _is_ one layer of connectedness between Dioxus and the renderer. Dioxus saves and loads elements (the PushRoot edit) with an ID. Inside the VirtualDOM, this is just tracked as a u64. - -Whenever a `CreateElement` edit is generated during diffing, Dioxus increments its node counter and assigns that new element its current NodeCount. The RealDom is responsible for remembering this ID and pushing the correct node when PushRoot(ID) is generated. Dioxus doesn't reclaim IDs of elements its removed, but your renderer probably will want to. To do this, we suggest using a `SecondarySlotMap` if implementing the renderer in Rust, or just deferring to a HashMap-type approach. - -This little demo serves to show exactly how a Renderer would need to process an edit stream to build UIs. A set of serialized EditStreams for various demos is available for you to test your custom renderer against. - -## Event loop - -Like most GUIs, Dioxus relies on an event loop to progress the VirtualDOM. The VirtualDOM itself can produce events as well, so it's important that your custom renderer can handle those too. - -The code for the WebSys implementation is straightforward, so we'll add it here to demonstrate how simple an event loop is: - -```rust, no_run -pub async fn run(&mut self) -> dioxus_core::error::Result<()> { - // Push the body element onto the WebsysDom's stack machine - let mut websys_dom = crate::new::WebsysDom::new(prepare_websys_dom()); - websys_dom.stack.push(root_node); - - // Rebuild or hydrate the virtualdom - self.internal_dom.rebuild(&mut websys_dom)?; - - // Wait for updates from the real dom and progress the virtual dom - loop { - let user_input_future = websys_dom.wait_for_event(); - let internal_event_future = self.internal_dom.wait_for_event(); - - match select(user_input_future, internal_event_future).await { - Either::Left((trigger, _)) => trigger, - Either::Right((trigger, _)) => trigger, - } - } - - while let Some(trigger) = { - websys_dom.stack.push(body_element.first_child().unwrap()); - self.internal_dom - .progress_with_event(&mut websys_dom, trigger)?; - } -} -``` - -It's important that you decode the real events from your event system into Dioxus' synthetic event system (synthetic meaning abstracted). This simply means matching your event type and creating a Dioxus `VirtualEvent` type. Your custom event must implement the corresponding event trait. Right now, the VirtualEvent system is modeled almost entirely around the HTML spec, but we are interested in slimming it down. - -```rust, no_run -fn virtual_event_from_websys_event(event: &web_sys::Event) -> VirtualEvent { - match event.type_().as_str() { - "keydown" | "keypress" | "keyup" => { - struct CustomKeyboardEvent(web_sys::KeyboardEvent); - impl dioxus::events::KeyboardEvent for CustomKeyboardEvent { - fn char_code(&self) -> usize { self.0.char_code() } - fn ctrl_key(&self) -> bool { self.0.ctrl_key() } - fn key(&self) -> String { self.0.key() } - fn key_code(&self) -> usize { self.0.key_code() } - fn location(&self) -> usize { self.0.location() } - fn meta_key(&self) -> bool { self.0.meta_key() } - fn repeat(&self) -> bool { self.0.repeat() } - fn shift_key(&self) -> bool { self.0.shift_key() } - fn which(&self) -> usize { self.0.which() } - fn get_modifier_state(&self, key_code: usize) -> bool { self.0.get_modifier_state() } - } - VirtualEvent::KeyboardEvent(Rc::new(event.clone().dyn_into().unwrap())) - } - _ => todo!() -``` - -## Custom raw elements - -If you need to go as far as relying on custom elements for your renderer – you totally can. This still enables you to use Dioxus' reactive nature, component system, shared state, and other features, but will ultimately generate different nodes. All attributes and listeners for the HTML and SVG namespace are shuttled through helper structs that essentially compile away (pose no runtime overhead). You can drop in your own elements any time you want, with little hassle. However, you must be absolutely sure your renderer can handle the new type, or it will crash and burn. - -These custom elements are defined as unit structs with trait implementations. - -For example, the `div` element is (approximately!) defined as such: - -```rust, no_run -struct div; -impl div { - /// Some glorious documentation about the class property. - #[inline] - fn class<'a>(&self, cx: NodeFactory<'a>, val: Arguments) -> Attribute<'a> { - cx.attr("class", val, None, false) - } - // more attributes -} -``` - -You've probably noticed that many elements in the `rsx!` and `html!` macros support on-hover documentation. The approach we take to custom elements means that the unit struct is created immediately where the element is used in the macro. When the macro is expanded, the doc comments still apply to the unit struct, giving tons of in-editor feedback, even inside a proc macro. - -## Compatibility - -Forewarning: not every hook and service will work on your platform. Dioxus wraps things that need to be cross-platform in "synthetic" types. However, downcasting to a native type might fail if the types don't match. - -There are three opportunities for platform incompatibilities to break your program: - -1. When downcasting elements via `Ref.downcast_ref()` -2. When downcasting events via `Event.downcast_ref()` -3. Calling platform-specific APIs that don't exist - -The best hooks will properly detect the target platform and still provide functionality, failing gracefully when a platform is not supported. We encourage – and provide – an indication to the user on what platforms a hook supports. For issues 1 and 2, these return a result as to not cause panics on unsupported platforms. When designing your hooks, we recommend propagating this error upwards into user facing code, making it obvious that this particular service is not supported. - -This particular code _will panic_ due to the unwrap on downcast_ref. Try to avoid these types of patterns. - -```rust, no_run -let div_ref = use_node_ref(cx); - -cx.render(rsx!{ - div { ref: div_ref, class: "custom class", - button { "click me to see my parent's class" - onclick: move |_| if let Some(div_ref) = div_ref { - log::info!("Div class is {}", div_ref.downcast_ref::().unwrap().class()) - } - } - } -}) - -``` - -## Conclusion - -That should be it! You should have nearly all the knowledge required on how to implement your own renderer. We're super interested in seeing Dioxus apps brought to custom desktop renderers, mobile renderer, video game UI, and even augmented reality! If you're interesting in contributing to any of the these projects, don't be afraid to reach out or join the community. diff --git a/docs/guide/src/en/__unused/advanced-guides/liveview.md b/docs/guide/src/en/__unused/advanced-guides/liveview.md deleted file mode 100644 index e223c593e..000000000 --- a/docs/guide/src/en/__unused/advanced-guides/liveview.md +++ /dev/null @@ -1,32 +0,0 @@ -# Dioxus Liveview -Liveview is a configuration where a server and a client work together to render a Dioxus app. Liveview monomorphizes a web application, eliminating the need for frontend-specific APIs. - -This is a developer-friendly alternative to the JAM-stack (Javascript + API + Markdown), combining the Wasm-compatibility and async performance of Rust. - -## Why liveview? - -### No APIs necessary! -Because Liveview combines the server and the client, you'll find dedicated APIs unnecessary. You'll still want to implement a data-fetching service for Live-apps, but this can be implemented as a crate and shared between apps. This approach was designed to let you model out your data requirements without needing to maintain a public versioned API. - -You can find more information to data modeling and fetching for LiveApps in the "Book of Dioxus Patterns". - -### Ease of deployment -There is no hassle for deploying Dioxus liveview apps – simply upload the binary to your hosting provider of choice. There simply is no need to deal with intermediate APIs. An app's frontend and backend are tightly coupled to each other, meaning that the backed and frontend are always up to date. - -This is especially powerful for small teams, where fast iteration, versioned unique prototypes, and simple deployments are important. As your app grows, Dioxus will happily grow with you, serving up to 100K RPS (thanks to async Rust performance). - -### Power of server rendering combined with the reactive nature of JavaScript -Liveview apps are backed by a server and enhanced with web-assembly. This completely eliminates the need to write Javascript to add dynamic content to webpages. Apps are written in only **one** language and require essentially 0 knowledge of build systems, transpiling or ECMAScript versions. Minimum browser support is guaranteed to cover 95% of users, and the Dioxus-CLI can be configured to generate polyfills for even more support. - -### Support with LiveHost by Dioxus-Labs -The Dioxus-CLI comes ready for use with premium Dioxus-Labs services, like LiveHost. Simply link up your git repo to the Dioxus LiveHost and start deploying your fullstack Dioxus app today. LiveHost supports: - -- Versioned fronted/backend with unique links -- Builtin CI/CD -- Managed and pluggable storage database backends -- Serverless support for minimal latency -- Site Analytics -- Lighthouse optimization -- On-premise support (see license terms) - -Dioxus LiveHost is a Dioxus LiveApp management service with all supported features in a single binary. For OSS, we permit free usage and deployment of LiveHost to your favorite hosting provider. diff --git a/docs/guide/src/en/__unused/advanced-guides/rsx.md b/docs/guide/src/en/__unused/advanced-guides/rsx.md deleted file mode 100644 index 169a57875..000000000 --- a/docs/guide/src/en/__unused/advanced-guides/rsx.md +++ /dev/null @@ -1,67 +0,0 @@ -# VNodes with RSX, HTML, and NodeFactory - -Many modern frameworks provide a domain-specific-language for declaring user-interfaces. In the case of React, this language extension is called JSX and must be handled through additional dependencies and pre/post processors to transform your source code. With Rust, we can simply provide a procedural macro in the Dioxus dependency itself that mimics the JSX language. - -With Dioxus, we actually ship two different macros – a macro that mimics JSX (the `html!` macro) and a macro that mimics Rust's native nested-struct syntax (the `rsx!` macro). These macros simply transform their inputs into NodeFactory calls. - -For instance, this html! call: - -```rust, no_run -html!(

"hello world"
) -``` - -becomes this NodeFactory call: - -```rust, no_run -|f| f.element( - dioxus_elements::div, // tag - [], // listeners - [], // attributes - [f.static_text("hello world")], // children - None // key -) -``` - -The NodeFactory API is fairly ergonomic, making it a viable option to use directly. The NodeFactory API is also compile-time correct and has incredible syntax highlighting support. We use what Rust calls a "unit type" – the `dioxus_elements::div` and associated methods to ensure that a `div` can only have attributes associated with `div`s. This lets us tack on relevant documentation, autocomplete support, and jump-to-definition for methods and attributes. - -![Compile time correct syntax](../images/compiletimecorrect.png) - -## html! macro - -The html! macro supports a limited subset of the html standard. Rust's macro parsing tools are somewhat limited, so all text between tags _must be quoted_. - -However, writing HTML by hand is a bit tedious – IDE tools for Rust don't support linting/autocomplete/syntax highlighting. We suggest using RSX – it's more natural for Rust programs and _does_ integrate well with Rust IDE tools. - -```rust, no_run -let name = "jane"; -let pending = false; -let count = 10; - -dioxus::ssr::render_lazy(html! { -
-

"Hello, {name}!"

-

"Status: {pending}!"

-

"Count {count}!"

-
-}); -``` - -## rsx! macro - -The rsx! macro is a VNode builder macro designed especially for Rust programs. Writing these should feel very natural, much like assembling a struct. VSCode also supports these with code folding, bracket-tabbing, bracket highlighting, section selecting, inline documentation, GOTO definition, and refactoring support. - -When helpful, the Dioxus VSCode extension provides a way of converting a selection of HTML directly to RSX, so you can import templates from the web directly into your existing app. - -It's also a bit easier on the eyes than HTML. - -```rust, no_run -dioxus::ssr::render_lazy(rsx! { - div { - p {"Hello, {name}!"} - p {"Status: {pending}!"} - p {"Count {count}!"} - } -}); -``` - -In the next section, we'll cover the `rsx!` macro in more depth. diff --git a/docs/guide/src/en/__unused/advanced-guides/testing.md b/docs/guide/src/en/__unused/advanced-guides/testing.md deleted file mode 100644 index 405c929a9..000000000 --- a/docs/guide/src/en/__unused/advanced-guides/testing.md +++ /dev/null @@ -1,29 +0,0 @@ -## Testing - -To test your Rust code, you can annotate any function with the `#[test]` block. In VSCode with RA, this will provide a lens to click and run the test. - -```rust, no_run -#[test] -fn component_runs() { - assert!(true) -} -``` - -This will test your Rust code _without_ going through the browser. This is ideal for squashing logic bugs and ensuring components render appropriately when the browsers's DOM is not needed. If you need to run tests in the browser, you can annotate your blocks with the `#[dioxus::test]` block. - -```rust, no_run -#[dioxus::test] -fn runs_in_browser() { - // ... -} -``` - -Then, when you run - -```console -dx test --chrome -``` - -Dioxus will build and test your code using the Chrome browser as a harness. - -There's a lot more to testing if you dive in, so check out the [Testing]() guide for more information diff --git a/docs/guide/src/en/__unused/attribute_spreading.md b/docs/guide/src/en/__unused/attribute_spreading.md deleted file mode 100644 index 9bbb30698..000000000 --- a/docs/guide/src/en/__unused/attribute_spreading.md +++ /dev/null @@ -1,30 +0,0 @@ -In the cases where you need to pass arbitrary element properties into a component – say to add more functionality to the `` tag, Dioxus will accept any quoted fields. This is similar to adding arbitrary fields to regular elements using quotes. - -```rust, no_run - -rsx!( - Clickable { - "class": "blue-button", - "style": "background: red;" - } -) - -``` - -For a component to accept these attributes, you must add an `attributes` field to your component's properties. We can use the spread syntax to add these attributes to whatever nodes are in our component. - -```rust, no_run -#[derive(Props)] -struct ClickableProps<'a> { - attributes: Attributes<'a> -} - -fn clickable(cx: Scope>) -> Element { - cx.render(rsx!( - a { - ..cx.props.attributes, - "Any link, anywhere" - } - )) -} -``` diff --git a/docs/guide/src/en/__unused/composing.md b/docs/guide/src/en/__unused/composing.md deleted file mode 100644 index 82435d6f3..000000000 --- a/docs/guide/src/en/__unused/composing.md +++ /dev/null @@ -1,244 +0,0 @@ -# Thinking in Reactively - -We've finally reached the point in our tutorial where we can talk about the theory of Reactivity. We've talked about defining a declarative view, but not about the aspects that make our code _reactive_. - -Understanding the theory of reactive programming is essential to making sense of Dioxus and writing effective, performant UIs. - -In this section, we'll talk about: - -- One-way data flow -- Modifying data -- Forcing renders -- How renders propagate - -This section is a bit long, but worth the read. We recommend coffee, tea, and/or snacks. - -## Reactive Programming - -Dioxus is one of a handful of Rust libraries that provide a "Reactive Programming Model". The term "Reactive programming" is a classification of programming paradigm – much like functional or imperative programming. This is a very important distinction since it affects how we _think_ about our code. - -Reactive programming is a programming model concerned with deriving computations from asynchronous data flow. Most reactive programs are comprised of datasources, intermediate computations, and a final result. - -We consider the rendered GUI to be the final result of our Dioxus apps. The datasources for our apps include local and global state. - -For example, the model presented in the figure below is comprised of two data sources: time and a constant. These values are passed through our computation graph to achieve a final result: `g`. - -![Reactive Model](https://upload.wikimedia.org/wikipedia/commons/thumb/e/e9/Reactive_programming_glitches.svg/440px-Reactive_programming_glitches.svg.png) - -Whenever our `seconds` variable changes, we will then reevaluate the computation for `t`. Because `g` relies on `t`, we will also reevaluate its computation too. Notice that we would've reevaluated the computation for `g` even if `t` didn't change because `seconds` is used to calculate `g`. - -However, if we somehow changed our constant from `1` to `2`, then we need to reevaluate `t`. If, for whatever reason, this change did not affect the result of `t`, then we wouldn't try to reevaluate `g`. - -In Reactive Programming, we don't think about whether or not we should reevaluate `t` or `g`; instead, we simply provide functions of computation and let the framework figure out the rest for us. - -In Rust, our reactive app would look something like: - -```rust, no_run -fn compute_g(t: i32, seconds: i32) -> bool { - t > seconds -} - -fn compute_t(constant: i32, seconds: i32) -> i32 { - constant + seconds -} - -fn compute_graph(constant: i32, seconds: i32) -> bool { - let t = compute_t(constant, seconds); - let g = compute_g(t, seconds); - g -} -``` - -## How is Dioxus Reactive? - -The Dioxus VirtualDom provides us a framework for reactive programming. When we build apps with dioxus, we need to provide our own datasources. This can be either initial props or some values fetched from the network. We then pass this data through our app into components through properties. - -If we represented the reactive graph presented above in Dioxus, it would look very similar: - -```rust, no_run -// Declare a component that holds our datasources and calculates `g` -fn RenderGraph(cx: Scope) -> Element { - let seconds = use_datasource(SECONDS); - let constant = use_state(cx, || 1); - - cx.render(rsx!( - RenderG { seconds: seconds } - RenderT { seconds: seconds, constant: constant } - )) -} - -// "calculate" g by rendering `t` and `seconds` -#[inline_props] -fn RenderG(cx: Scope, seconds: i32) -> Element { - cx.render(rsx!{ "There are {seconds} seconds remaining..." }) -} - -// calculate and render `t` in its own component -#[inline_props] -fn RenderT(cx: Scope, seconds: i32, constant: i32) -> Element { - let res = seconds + constant; - cx.render(rsx!{ "{res}" }) -} -``` - -With this app, we've defined three components. Our top-level component provides our datasources (the hooks), computation nodes (child components), and a final value (what's "rendered"). - -Now, whenever the `constant` changes, our `RenderT` component will be re-rendered. However, if `seconds` doesn't change, then we don't need to re-render `RenderG` because the input is the same. If `seconds` _does_ change, then both RenderG and RenderT will be reevaluated. - -Dioxus is "Reactive" because it provides this framework for us. All we need to do is write our own tiny units of computation and Dioxus figures out which components need to be reevaluated automatically. - -These extra checks and algorithms add some overhead, which is why you see projects like [Sycamore](http://sycamore-rs.netlify.app) and [SolidJS](http://solidjs.com) eliminating them altogether. Dioxus is _really_ fast, so we're willing to exchange the added overhead for improved developer experience. - -## How do we update values in our dataflow graph? - -Dioxus will automatically figure out how to regenerate parts of our app when datasources change. But how exactly can we update our data sources? - -In Dioxus there are two datasources: - -1. Local state in `use_hook` and all other hooks -2. Global state through `provide_context`. - -Technically, the root props of the VirtualDom are a third datasource, but since we cannot modify them, they are not worth talking about. - -### Local State - -For local state in hooks, Dioxus gives us the `use_hook` method which returns an `&mut T` without any requirements. This means raw hook values are not tracked by Dioxus. In fact, we could write a component that modifies a hook value directly: - -```rust, no_run -fn app(cx: Scope) -> Element { - let mut count = cx.use_hook(|_| 0); - cx.render(rsx!{ - button { - onclick: move |_| *count += 1, - "Count: {count}" - } - }) -} -``` - -However, when this value is written to, the component does not know to be reevaluated. We must explicitly tell Dioxus that this component is "dirty" and needs to be re-rendered. This is done through the `cx.needs_update` method: - -```rust, no_run -button { - onclick: move |_| { - *count += 1; - cx.needs_update(); - }, - "Count: {count}" -} -``` - -Now, whenever we click the button, the value will change and the component will be re-rendered. - -> Re-rendering is when Dioxus calls your function component _again_. Component functions will be called over and over throughout their lifetime, so they should be mostly side-effect free. - -### Understand this! - -Your component functions will be called ("rendered" in our lingo) for as long as the component is present in the tree. - -A single component will be called multiple times, modifying its own internal state or rendering new nodes with new values from its properties. - -### App-Global State - -With the `provide_context` and `consume_context` methods on `Scope`, we can share values to descendants without having to pass values through component props. This has the side-effect of making our datasources less obvious from a high-level perspective, but it makes our components more modular within the same codebase. - -To make app-global state easier to reason about, Dioxus makes all values provided through `provide_context` immutable. This means any library built on top of `provide_context` needs to use interior mutability to modify shared global state. - -In these cases, App-Global state needs to manually track which components need to be re-generated. - -To regenerate _any_ component in your app, you can get a handle to the Dioxus' internal scheduler through `schedule_update_any`: - -```rust, no_run -let force_render = cx.schedule_update_any(); - -// force a render of the root component -force_render(ScopeId(0)); -``` - -## What does it mean for a component to "re-render"? - -In our guides, we frequently use the phrase "re-render" to describe updates to our app. You'll often hear this paired with "preventing unnecessary re-renders." But what exactly does this mean? - -When we call `dioxus::desktop::launch`, Dioxus will create a new `Scope` object and call the component we gave it. Our `rsx!` calls will create new nodes which we return back to the VirtualDom. Dioxus will then look through these nodes for child components, call their functions, and so on until every component has been "rendered." We consider these nodes "rendered" because they were created because of our explicit actions. - -The tree of UI that dioxus creates will roughly look like the tree of components presented earlier: - -![Tree of UI](../images/component_tree.png) - -But what happens when we call `needs_update` after modifying some important state? Well, if Dioxus called our component's function again, then we would produce new, different nodes. In fact, this is exactly what Dioxus does! - -At this point, we have some old nodes and some new nodes. Again, we call this "rendering" because Dioxus had to create new nodes because of our explicit actions. Any time new nodes get created, our VirtualDom is being "rendered." - -These nodes are stored in an extremely efficient memory allocator called a "bump arena." For example, a div with a handler and attribute would be stored in memory in two locations: the "old" tree and the "new" tree. - -![Bump Arenas](../images/oldnew.png) - -From here, Dioxus computes the difference between these trees and updates the Real DOM to make it look like the new version of what we've declared. - -![Diffing](../images/diffing.png) - -## Suppressing Renders - -So, we know how to make Dioxus render, but how do we _stop_ it? What if we _know_ that our state didn't change and we shouldn't render and diff new nodes because they'll be exactly the same as the last time? - -In these cases, you want to reach for _memoization_. In Dioxus, memoization involves preventing a component from rendering again if its props didn't change since the last time it attempted to render. - -Visually, you can tell that a component will only re-render if the new value is sufficiently different than the old one. - -| props.val | re-render | -| --------- | --------- | -| 10 | true | -| 20 | true | -| 20 | false | -| 20 | false | -| 10 | true | -| 30 | false | - -This is why when you `derive(Props)`, you must also implement the `PartialEq` trait. To override the memoization strategy for a component, you can simply implement your own PartialEq. - -```rust, no_run -struct CustomProps { - val: i32, -} - -impl PartialEq for CustomProps { - fn partial_eq(&self, other: &Self) -> bool { - // we don't render components that have a val less than 5 - if other.val > 5 && self.val > 5{ - self.val == other.val - } - } -} -``` - -However, for components that borrow data, it doesn't make sense to implement PartialEq since the actual references in memory might be different. - -You can technically override this behavior by implementing the `Props` trait manually, though it's unsafe and easy to mess up: - -```rust, no_run -unsafe impl Properties for CustomProps { - fn memoize(&self, other &Self) -> bool { - self != other - } -} -``` - -TLDR: - -- Dioxus checks if props changed between renders -- If props changed according to PartialEq, Dioxus re-renders the component -- Props that have a lifetime (ie `<'a>`) will always be re-rendered - -## Wrapping Up - -Wow, that was a lot of material! - -Let's see if we can recap what was presented: - -- Reactive programming calculates a final value from datasources and computation -- Dioxus is "reactive" since it figures out which computations to check -- `schedule_update` must be called to mark a component as dirty -- dirty components will be re-rendered (called multiple times) to produce a new UI -- Renders can be suppressed with memoization - -This theory is crucial to understand how to compose components and how to control renders in your app. diff --git a/docs/guide/src/en/__unused/event_javascript.rs b/docs/guide/src/en/__unused/event_javascript.rs deleted file mode 100644 index d80501b46..000000000 --- a/docs/guide/src/en/__unused/event_javascript.rs +++ /dev/null @@ -1,26 +0,0 @@ - -## JavaScript Handlers - -Instead of passing a closure, you can also pass a string to event handlers – this lets you use JavaScript (if your renderer can execute JavaScript): - -```rust -{{#include ../../../examples/event_javascript.rs:rsx}} -``` - - -#![allow(non_snake_case)] -use dioxus::prelude::*; - -fn main() { - dioxus::desktop::launch(App); -} - -fn App(cx: Scope) -> Element { - cx.render(rsx! { - // ANCHOR: rsx - div { - onclick: "alert('hello world')", - } - // ANCHOR_END: rsx - }) -} diff --git a/docs/guide/src/en/__unused/fanout.md b/docs/guide/src/en/__unused/fanout.md deleted file mode 100644 index 63b7d3403..000000000 --- a/docs/guide/src/en/__unused/fanout.md +++ /dev/null @@ -1,61 +0,0 @@ -# Fanning Out - -One of the most reliable state management patterns in large Dioxus apps is `fan-out`. The fan-out pattern is the ideal way to structure your app to maximize code reuse, testability, and deterministic rendering. - -## The structure - -With `fan-out`, our individual components at "leaf" position of our VirtualDom are "pure", making them easily reusable, testable, and deterministic. For instance, the "title" bar of our app might be a fairly complicated component. - -```rust, no_run -#[derive(Props, PartialEq)] -struct TitlebarProps { - title: String, - subtitle: String, -} - -fn Titlebar(cx: Scope) -> Element { - cx.render(rsx!{ - div { - class: "titlebar" - h1 { "{cx.props.title}" } - h1 { "{cx.props.subtitle}" } - } - }) -} -``` - -If we used global state like use_context or fermi, we might be tempted to inject our `use_read` directly into the component. - -```rust, no_run -fn Titlebar(cx: Scope) -> Element { - let title = use_read(cx, TITLE); - let subtitle = use_read(cx, SUBTITLE); - - cx.render(rsx!{/* ui */}) -} -``` - -For many apps – this is a fine pattern, especially if the component is a one-off. However, if we want to reuse the component outside of this app, then we'll start to run into issues where our contexts are unavailable. - -## Fanning Out - -To enable our titlebar component to be used across apps, we want to lift our atoms upwards and out of the Titlebar component. We would organize a bunch of other components in this section of the app to share some of the same state. - -```rust, no_run -fn DocsiteTitlesection(cx: Scope) { - let title = use_read(cx, TITLE); - let subtitle = use_read(cx, SUBTITLE); - - let username = use_read(cx, USERNAME); - let points = use_read(cx, POINTS); - - cx.render(rsx!{ - TitleBar { title: title, subtitle: subtitle } - UserBar { username: username, points: points } - }) -} -``` - -This particular wrapper component unfortunately cannot be reused across apps. However, because it simply wraps other real elements, it doesn't have to. We are free to reuse our TitleBar and UserBar components across apps with ease. We also know that this particular component is plenty performant because the wrapper doesn't have any props and is always memoized. The only times this component re-renders is when any of the atoms change. - -This is the beauty of Dioxus – we always know where our components are likely to be re-rendered. Our wrapper components can easily prevent any large re-renders by simply memoizing their components. This system might not be as elegant or precise as signal systems found in libraries like Sycamore or SolidJS, but it is quite ergonomic. diff --git a/docs/guide/src/en/__unused/hello_world.md b/docs/guide/src/en/__unused/hello_world.md deleted file mode 100644 index d49172e47..000000000 --- a/docs/guide/src/en/__unused/hello_world.md +++ /dev/null @@ -1,14 +0,0 @@ -# "Hello, World" desktop app - - - -If you plan to develop extensions for the `Dioxus` ecosystem, please use the `dioxus` crate with the `core` feature to limit the amount of dependencies your project brings in. - - -### What is this `Scope` object? - -Coming from React, the `Scope` object might be confusing. In React, you'll want to store data between renders with hooks. However, hooks rely on global variables which make them difficult to integrate in multi-tenant systems like server-rendering. - -In Dioxus, you are given an explicit `Scope` object to control how the component renders and stores data. The `Scope` object provides a handful of useful APIs for features like suspense, rendering, and more. - -For now, just know that `Scope` lets you store state with hooks and render elements with `cx.render`. diff --git a/docs/guide/src/en/__unused/helpers.md b/docs/guide/src/en/__unused/helpers.md deleted file mode 100644 index 86c76bea8..000000000 --- a/docs/guide/src/en/__unused/helpers.md +++ /dev/null @@ -1,47 +0,0 @@ -# Helper Crates - -Because the Dioxus ecosystem is fairly young, there aren't a ton of third-party libraries designed to "get things done." That's where the Dioxus helper crates come in. These are officially supported crates built on top of existing libraries to solve some of the common barriers to building apps. - -## Router - -Quickly add a cross-platform router to structure your app. - -[Link](https://github.com/DioxusLabs/dioxus/tree/master/packages/router) - -## Fermi - -Global state as easy as `use_state`. - -[Link](https://github.com/DioxusLabs/dioxus/tree/master/packages/fermi) - -## Query - -This crate has yet to be developed! However, we do plan on providing a crate for good fetching and query support. - -## 3rd-party – Toast - -Toast notifications, curtesy of [@mrxiaozhuox](https://github.com/mrxiaozhuox). - -[Link](https://github.com/mrxiaozhuox/dioxus-toast) - -## 3rd-party – HeroIcon - -Collection of helpful hero icons, curtesy of [@autarch](https://github.com/autarch). - - -[Link](https://github.com/houseabsolute/dioxus-heroicons) - -## 3rd-party – Katex - -Draw beautiful equations, curtesy of [@oovm](https://github.com/oovm) - -[Link](https://github.com/oovm/katex-wasm/tree/dev/projects/dioxus-katex) - - -## 3rd-party – PrimsJS - -Highlight your code blocks with ease, curtesy of [@oovm](https://github.com/oovm) - -[Link](https://github.com/oovm/katex-wasm/tree/dev/projects/dioxus-katex) - - diff --git a/docs/guide/src/en/__unused/index.md b/docs/guide/src/en/__unused/index.md deleted file mode 100644 index d1863a465..000000000 --- a/docs/guide/src/en/__unused/index.md +++ /dev/null @@ -1,36 +0,0 @@ -# Managing State - -Every app you'll build with Dioxus will have some sort of state that needs to be maintained and updated as your users interact with it. However, managing state can be particularly challenging at times, and is frequently the source of bugs in many GUI frameworks. - -In this chapter, we'll cover the various ways to manage state, the appropriate terminology, various patterns, and some problems you might run into. - -## The Problem - -Why do people say state management is so difficult? What does it mean? - -Generally, state management is the code you need to write to ensure that your app renders the _correct_ content. If the user inputs a name, then you need to display the appropriate response – like alerts, validation, and disable/enable various elements on the page. Things can quickly become tricky if you need loading screens and cancellable tasks. - -For the simplest of apps, all of your state can enter the app from the root props. This is common in server-side rendering – we can collect all of the required state _before_ rendering the content. - -```rust, no_run -let all_content = get_all_content().await; - -let output = dioxus::ssr::render_lazy(rsx!{ - div { - RenderContent { content: all_content } - } -}); -``` - -With this incredibly simple setup, it is highly unlikely that you'll have rendering bugs. There simply is barely any state to manage. - -However, most of your apps will store state inside of the Dioxus VirtualDom – either through local state or global state. - -## Your options - -To deal with complexity, you have a couple of options: - -- Refactor state out of shared state and into reusable components and hooks. -- Lift state upwards to be spread across multiple components (fan out). -- Use the Context API to share state globally. -- Use a dedicated state management solution like Fermi. diff --git a/docs/guide/src/en/__unused/localstate.md b/docs/guide/src/en/__unused/localstate.md deleted file mode 100644 index fbc04272a..000000000 --- a/docs/guide/src/en/__unused/localstate.md +++ /dev/null @@ -1,107 +0,0 @@ -# Local State - -The first step to dealing with complexity in your app is to refactor your state to be purely local. This encourages good code reuse and prevents leakage of abstractions across component boundaries. - -## What it looks like - -Let's say we're managing the state for a list of Todos. Whenever we edit the todo, we want the list to update. We might've started building our app but putting everything into a single `use_ref`. - -```rust, no_run -struct Todo { - contents: String, - is_hovered: bool, - is_editing: bool, -} - -let todos = use_ref(cx, || vec![Todo::new()]); - -cx.render(rsx!{ - ul { - todos.read().iter().enumerate().map(|(id, todo)| rsx!{ - li { - onhover: move |_| *todos.write()[id].is_hovered = true, - h1 { "{todo.contents}" } - } - }) - } -}) -``` - -As shown above, whenever the todo is hovered, we want to set its state: - -```rust, no_run -todos.write()[0].is_hovered = true; -``` - -As the amount of interactions goes up, so does the complexity of our state. Should the "hover" state really be baked into our data model? - -Instead, let's refactor our Todo component to handle its own state: - -```rust, no_run -#[inline_props] -fn Todo<'a>(cx: Scope, todo: &'a Todo) -> Element { - let is_hovered = use_state(cx, || false); - - cx.render(rsx!{ - li { - h1 { "{todo.contents}" } - onhover: move |_| is_hovered.set(true), - } - }) -} -``` - -Now, we can simplify our Todo data model to get rid of local UI state: - -```rust, no_run -struct Todo { - contents: String, -} -``` - -This is not only better for encapsulation and abstraction, but it's only more performant! Whenever a Todo is hovered, we won't need to re-render _every_ Todo again – only the Todo that's currently being hovered. - -Wherever possible, you should try to refactor the "view" layer _out_ of your data model. - -## Immutability - -Storing all of your state inside a `use_ref` might be tempting. However, you'll quickly run into an issue where the `Ref` provided by `read()` "does not live long enough." An indeed – you can't return locally-borrowed value into the Dioxus tree. - -In these scenarios consider breaking your `use_ref` into individual `use_state`s. - -You might've started modeling your component with a struct and use_ref - -```rust, no_run -struct State { - count: i32, - color: &'static str, - names: HashMap -} - -// in the component -let state = use_ref(cx, State::new) -``` - -The "better" approach for this particular component would be to break the state apart into different values: - -```rust, no_run -let count = use_state(cx, || 0); -let color = use_state(cx, || "red"); -let names = use_state(cx, HashMap::new); -``` - -You might recognize that our "names" value is a HashMap – which is not terribly cheap to clone every time we update its value. To solve this issue, we _highly_ suggest using a library like [`im`](https://crates.io/crates/im) which will take advantage of structural sharing to make clones and mutations much cheaper. - -When combined with the `make_mut` method on `use_state`, you can get really succinct updates to collections: - -```rust, no_run -let todos = use_state(cx, im_rc::HashMap::default); - -todos.make_mut().insert("new todo", Todo { - contents: "go get groceries", -}); -``` - -## Moving on - -This particular local patterns are powerful but is not a cure-all for state management problems. Sometimes your state problems are much larger than just staying local to a component. diff --git a/docs/guide/src/en/__unused/memoization.md b/docs/guide/src/en/__unused/memoization.md deleted file mode 100644 index 4baa73be9..000000000 --- a/docs/guide/src/en/__unused/memoization.md +++ /dev/null @@ -1,26 +0,0 @@ -## Memoization - -Dioxus uses Memoization for a more efficient user interface. Memoization is the process in which we check if a component actually needs to be re-rendered when its props change. If a component's properties change but they wouldn't affect the output, then we don't need to re-render the component, saving time! - -For example, let's say we have a component that has two children: - -```rust, no_run -fn Demo(cx: Scope) -> Element { - // don't worry about these 2, we'll cover them later - let name = use_state(cx, || String::from("bob")); - let age = use_state(cx, || 21); - - cx.render(rsx!{ - Name { name: name } - Age { age: age } - }) -} -``` - -If `name` changes but `age` does not, then there is no reason to re-render our `Age` component since the contents of its props did not meaningfully change. - -Dioxus memoizes owned components. It uses `PartialEq` to determine if a component needs rerendering, or if it has stayed the same. This is why you must derive PartialEq! - -> This means you can always rely on props with `PartialEq` or no props at all to act as barriers in your app. This can be extremely useful when building larger apps where properties frequently change. By moving our state into a global state management solution, we can achieve precise, surgical re-renders, improving the performance of our app. - -Borrowed Props cannot be safely memoized. However, this is not a problem – Dioxus relies on the memoization of their parents to determine if they need to be rerendered. diff --git a/docs/guide/src/en/__unused/model_pattern.md b/docs/guide/src/en/__unused/model_pattern.md deleted file mode 100644 index c9bf9f6b5..000000000 --- a/docs/guide/src/en/__unused/model_pattern.md +++ /dev/null @@ -1,64 +0,0 @@ -## Using UseRef with "models" - -One option for state management that UseRef enables is the development of a "model" for your components. This particular pattern enables you to model your state with regular structs. - -For instance, our calculator example uses a struct to model the state. - -```rust, no_run - -struct Calculator { - display_value: String, - operator: Option, - waiting_for_operand: bool, - cur_val: f64, -} -``` - -Our component is really simple – we just call `use_ref` to get an initial calculator state. - -```rust, no_run -fn app(cx: Scope) -> Element { - let state = use_ref(cx, Calculator::new); - - cx.render(rsx!{ - // the rendering code - }) -} -``` - -In our UI, we can then use `read` and a helper method to get data out of the model. - -```rust, no_run -// Our accessor method -impl Calculator { - fn formatted_display(&self) -> String { - self.display_value - .parse::() - .unwrap() - .separated_string() - } -} - -// And then in the UI -cx.render(rsx!{ - div { [state.read().formatted_display()] } -}) -``` - -To modify the state, we can setup a helper method and then attach it to a callback. - -```rust, no_run -// our helper -impl Calculator { - fn clear_display(&mut self) { - self.display_value = "0".to_string() - } -} - -// our callback -cx.render(rsx!{ - button { - onclick: move |_| state.write().clear_display(), - } -}) -``` diff --git a/docs/guide/src/en/async/index.md b/docs/guide/src/en/async/index.md deleted file mode 100644 index a95671399..000000000 --- a/docs/guide/src/en/async/index.md +++ /dev/null @@ -1,9 +0,0 @@ -# Working with Async - -Often, apps need to interact with file systems, network interfaces, hardware, or timers. This chapter provides an overview of using async code in Dioxus. - -## The Runtime - -By default, Dioxus-Desktop ships with the `Tokio` runtime and automatically sets everything up for you. This is currently not configurable, though it would be easy to write an integration for Dioxus desktop that uses a different asynchronous runtime. - -Dioxus is not currently thread-safe, so any async code you write does *not* need to be `Send/Sync`. That means that you can use non-thread-safe structures like `Cell`, `Rc`, and `RefCell`. diff --git a/docs/guide/src/en/async/spawn.md b/docs/guide/src/en/async/spawn.md deleted file mode 100644 index 2f86ad159..000000000 --- a/docs/guide/src/en/async/spawn.md +++ /dev/null @@ -1,19 +0,0 @@ -# Spawning Futures - -The `use_future` and `use_coroutine` hooks are useful if you want to unconditionally spawn the future. Sometimes, though, you'll want to only spawn a future in response to an event, such as a mouse click. For example, suppose you need to send a request when the user clicks a "log in" button. For this, you can use `cx.spawn`: - -```rust, no_run -{{#include ../../../examples/spawn.rs:spawn}} -``` - -> Note: `spawn` will always spawn a _new_ future. You most likely don't want to call it on every render. - -Calling `spawn` will give you a `JoinHandle` which lets you cancel or pause the future. - -## Spawning Tokio Tasks - -Sometimes, you might want to spawn a background task that needs multiple threads or talk to hardware that might block your app code. In these cases, we can directly spawn a Tokio task from our future. For Dioxus-Desktop, your task will be spawned onto Tokio's Multithreaded runtime: - -```rust, no_run -{{#include ../../../examples/spawn.rs:tokio}} -``` diff --git a/docs/guide/src/en/async/use_coroutine.md b/docs/guide/src/en/async/use_coroutine.md deleted file mode 100644 index d42905be5..000000000 --- a/docs/guide/src/en/async/use_coroutine.md +++ /dev/null @@ -1,204 +0,0 @@ -# Coroutines - -Another tool in your async toolbox are coroutines. Coroutines are futures that can be manually stopped, started, paused, and resumed. - -Like regular futures, code in a coroutine will run until the next `await` point before yielding. This low-level control over asynchronous tasks is quite powerful, allowing for infinitely looping tasks like WebSocket polling, background timers, and other periodic actions. - -## `use_coroutine` - -The `use_coroutine` hook allows you to create a coroutine. Most coroutines we write will be polling loops using async/await. - -```rust, no_run -fn app(cx: Scope) -> Element { - let ws: &UseCoroutine<()> = use_coroutine(cx, |rx| async move { - // Connect to some sort of service - let mut conn = connect_to_ws_server().await; - - // Wait for data on the service - while let Some(msg) = conn.next().await { - // handle messages - } - }); -} -``` - -For many services, a simple async loop will handle the majority of use cases. - -However, if we want to temporarily disable the coroutine, we can "pause" it using the `pause` method, and "resume" it using the `resume` method: - -```rust, no_run -let sync: &UseCoroutine<()> = use_coroutine(cx, |rx| async move { - // code for syncing -}); - -if sync.is_running() { - cx.render(rsx!{ - button { - onclick: move |_| sync.pause(), - "Disable syncing" - } - }) -} else { - cx.render(rsx!{ - button { - onclick: move |_| sync.resume(), - "Enable syncing" - } - }) -} -``` - -This pattern is where coroutines are extremely useful – instead of writing all the complicated logic for pausing our async tasks like we would with JavaScript promises, the Rust model allows us to just not poll our future. - -## Yielding Values - -To yield values from a coroutine, simply bring in a `UseState` handle and set the value whenever your coroutine completes its work. - -The future must be `'static` – so any values captured by the task cannot carry any references to `cx`, such as a `UseState`. - -You can use [to_owned](https://doc.rust-lang.org/std/borrow/trait.ToOwned.html#tymethod.to_owned) to create a clone of the hook handle which can be moved into the async closure. - -```rust, no_run -let sync_status = use_state(cx, || Status::Launching); -let sync_task = use_coroutine(cx, |rx: UnboundedReceiver| { - let sync_status = sync_status.to_owned(); - async move { - loop { - delay_ms(1000).await; - sync_status.set(Status::Working); - } - } -}) -``` - -To make this a bit less verbose, Dioxus exports the `to_owned!` macro which will create a binding as shown above, which can be quite helpful when dealing with many values. - -```rust, no_run -let sync_status = use_state(cx, || Status::Launching); -let load_status = use_state(cx, || Status::Launching); -let sync_task = use_coroutine(cx, |rx: UnboundedReceiver| { - to_owned![sync_status, load_status]; - async move { - // ... - } -}) -``` - -## Sending Values - -You might've noticed the `use_coroutine` closure takes an argument called `rx`. What is that? Well, a common pattern in complex apps is to handle a bunch of async code at once. With libraries like Redux Toolkit, managing multiple promises at once can be challenging and a common source of bugs. - -With Coroutines, we can centralize our async logic. The `rx` parameter is an Channel that allows code external to the coroutine to send data _into_ the coroutine. Instead of looping on an external service, we can loop on the channel itself, processing messages from within our app without needing to spawn a new future. To send data into the coroutine, we would call "send" on the handle. - -```rust, no_run -use futures_util::stream::StreamExt; - -enum ProfileUpdate { - SetUsername(String), - SetAge(i32) -} - -let profile = use_coroutine(cx, |mut rx: UnboundedReciver| async move { - let mut server = connect_to_server().await; - - while let Ok(msg) = rx.next().await { - match msg { - ProfileUpdate::SetUsername(name) => server.update_username(name).await, - ProfileUpdate::SetAge(age) => server.update_age(age).await, - } - } -}); - - -cx.render(rsx!{ - button { - onclick: move |_| profile.send(ProfileUpdate::SetUsername("Bob".to_string())), - "Update username" - } -}) -``` - -> Note: In order to use/run the `rx.next().await` statement you will need to extend the [`Stream`] trait (used by [`UnboundedReceiver`]) by adding 'futures_util' as a dependency to your project and adding the `use futures_util::stream::StreamExt;`. - -For sufficiently complex apps, we could build a bunch of different useful "services" that loop on channels to update the app. - -```rust, no_run -let profile = use_coroutine(cx, profile_service); -let editor = use_coroutine(cx, editor_service); -let sync = use_coroutine(cx, sync_service); - -async fn profile_service(rx: UnboundedReceiver) { - // do stuff -} - -async fn sync_service(rx: UnboundedReceiver) { - // do stuff -} - -async fn editor_service(rx: UnboundedReceiver) { - // do stuff -} -``` - -We can combine coroutines with [Fermi](https://docs.rs/fermi/latest/fermi/index.html) to emulate Redux Toolkit's Thunk system with much less headache. This lets us store all of our app's state _within_ a task and then simply update the "view" values stored in Atoms. It cannot be understated how powerful this technique is: we get all the perks of native Rust tasks with the optimizations and ergonomics of global state. This means your _actual_ state does not need to be tied up in a system like Fermi or Redux – the only Atoms that need to exist are those that are used to drive the display/UI. - -```rust, no_run -static USERNAME: Atom = Atom(|_| "default".to_string()); - -fn app(cx: Scope) -> Element { - let atoms = use_atom_root(cx); - - use_coroutine(cx, |rx| sync_service(rx, atoms.clone())); - - cx.render(rsx!{ - Banner {} - }) -} - -fn Banner(cx: Scope) -> Element { - let username = use_read(cx, &USERNAME); - - cx.render(rsx!{ - h1 { "Welcome back, {username}" } - }) -} -``` - -Now, in our sync service, we can structure our state however we want. We only need to update the view values when ready. - -```rust, no_run -use futures_util::stream::StreamExt; - -enum SyncAction { - SetUsername(String), -} - -async fn sync_service(mut rx: UnboundedReceiver, atoms: AtomRoot) { - let username = atoms.write(&USERNAME); - let errors = atoms.write(&ERRORS); - - while let Ok(msg) = rx.next().await { - match msg { - SyncAction::SetUsername(name) => { - if set_name_on_server(&name).await.is_ok() { - username.set(name); - } else { - errors.make_mut().push("SetUsernameFailed"); - } - } - } - } -} -``` - -## Automatic injection into the Context API - -Coroutine handles are automatically injected through the context API. You can use the `use_coroutine_handle` hook with the message type as a generic to fetch a handle. - -```rust, no_run -fn Child(cx: Scope) -> Element { - let sync_task = use_coroutine_handle::(cx); - - sync_task.send(SyncAction::SetUsername); -} -``` diff --git a/docs/guide/src/en/async/use_effect.md b/docs/guide/src/en/async/use_effect.md deleted file mode 100644 index 7c20e3589..000000000 --- a/docs/guide/src/en/async/use_effect.md +++ /dev/null @@ -1,41 +0,0 @@ -# UseEffect - -[`use_effect`](https://docs.rs/dioxus-hooks/latest/dioxus_hooks/fn.use_effect.html) lets you run a callback that returns a future, which will be re-run when its [dependencies](#dependencies) change. This is useful to syncrhonize with external events. - -## Dependencies - -You can make the callback re-run when some value changes. For example, you might want to fetch a user's data only when the user id changes. You can provide a tuple of "dependencies" to the hook. It will automatically re-run it when any of those dependencies change. - -## Example - -```rust, no_run -#[inline_props] -fn Profile(cx: Scope, id: usize) -> Element { - let name = use_state(cx, || None); - - // Only fetch the user data when the id changes. - use_effect(cx, (id,), |(id,)| { - to_owned![name]; - async move { - let user = fetch_user(id).await; - name.set(user.name); - } - }); - - // Because the dependencies are empty, this will only run once. - // An empty tuple is always equal to an empty tuple. - use_effect(cx, (), |()| async move { - println!("Hello, World!"); - }); - - let name = name.get().clone().unwrap_or("Loading...".to_string()); - - render!( - p { "{name}" } - ) -} - -fn app(cx: Scope) -> Element { - render!(Profile { id: 0 }) -} -``` diff --git a/docs/guide/src/en/async/use_future.md b/docs/guide/src/en/async/use_future.md deleted file mode 100644 index c7b262c61..000000000 --- a/docs/guide/src/en/async/use_future.md +++ /dev/null @@ -1,31 +0,0 @@ -# UseFuture - -[`use_future`](https://docs.rs/dioxus-hooks/latest/dioxus_hooks/fn.use_future.html) lets you run an async closure, and provides you with its result. - -For example, we can make an API request (using [reqwest](https://docs.rs/reqwest/latest/reqwest/index.html)) inside `use_future`: - -```rust, no_run -{{#include ../../../examples/use_future.rs:use_future}} -``` - -The code inside `use_future` will be submitted to the Dioxus scheduler once the component has rendered. - -We can use `.value()` to get the result of the future. On the first run, since there's no data ready when the component loads, its value will be `None`. However, once the future is finished, the component will be re-rendered and the value will now be `Some(...)`, containing the return value of the closure. - -We can then render that result: - -```rust, no_run -{{#include ../../../examples/use_future.rs:render}} -``` - -## Restarting the Future - -The `UseFuture` handle provides a `restart` method. It can be used to execute the future again, producing a new value. - -## Dependencies - -Often, you will need to run the future again every time some value (e.g. a prop) changes. Rather than calling `restart` manually, you can provide a tuple of "dependencies" to the hook. It will automatically re-run the future when any of those dependencies change. Example: - -```rust, no_run -{{#include ../../../examples/use_future.rs:dependency}} -``` diff --git a/docs/guide/src/en/best_practices/antipatterns.md b/docs/guide/src/en/best_practices/antipatterns.md deleted file mode 100644 index 771ffe75f..000000000 --- a/docs/guide/src/en/best_practices/antipatterns.md +++ /dev/null @@ -1,33 +0,0 @@ -# Antipatterns - -This example shows what not to do and provides a reason why a given pattern is considered an "AntiPattern". Most anti-patterns are considered wrong for performance or code re-usability reasons. - -## Unnecessarily Nested Fragments - -Fragments don't mount a physical element to the DOM immediately, so Dioxus must recurse into its children to find a physical DOM node. This process is called "normalization". This means that deeply nested fragments make Dioxus perform unnecessary work. Prefer one or two levels of fragments / nested components until presenting a true DOM element. - -Only Component and Fragment nodes are susceptible to this issue. Dioxus mitigates this with components by providing an API for registering shared state without the Context Provider pattern. - -```rust, no_run -{{#include ../../../examples/anti_patterns.rs:nested_fragments}} -``` - -## Incorrect Iterator Keys - -As described in the [dynamic rendering chapter](../interactivity/dynamic_rendering.md#the-key-attribute), list items must have unique keys that are associated with the same items across renders. This helps Dioxus associate state with the contained components and ensures good diffing performance. Do not omit keys, unless you know that the list will never change. - -```rust, no_run -{{#include ../../../examples/anti_patterns.rs:iter_keys}} -``` - -## Avoid Interior Mutability in Props - -While it is technically acceptable to have a `Mutex` or a `RwLock` in the props, they will be difficult to use. - -Suppose you have a struct `User` containing the field `username: String`. If you pass a `Mutex` prop to a `UserComponent` component, that component may wish to pass the username as a `&str` prop to a child component. However, it cannot pass that borrowed field down, since it only would live as long as the `Mutex`'s lock, which belongs to the `UserComponent` function. Therefore, the component will be forced to clone the `username` field. - -## Avoid Updating State During Render - -Every time you update the state, Dioxus needs to re-render the component – this is inefficient! Consider refactoring your code to avoid this. - -Also, if you unconditionally update the state during render, it will be re-rendered in an infinite loop. diff --git a/docs/guide/src/en/best_practices/error_handling.md b/docs/guide/src/en/best_practices/error_handling.md deleted file mode 100644 index d16d04347..000000000 --- a/docs/guide/src/en/best_practices/error_handling.md +++ /dev/null @@ -1,153 +0,0 @@ -# Error handling - -A selling point of Rust for web development is the reliability of always knowing where errors can occur and being forced to handle them - -However, we haven't talked about error handling at all in this guide! In this chapter, we'll cover some strategies in handling errors to ensure your app never crashes. - -## The simplest – returning None - -Astute observers might have noticed that `Element` is actually a type alias for `Option`. You don't need to know what a `VNode` is, but it's important to recognize that we could actually return nothing at all: - -```rust, no_run -fn App(cx: Scope) -> Element { - None -} -``` - -This lets us add in some syntactic sugar for operations we think _shouldn't_ fail, but we're still not confident enough to "unwrap" on. - -> The nature of `Option` might change in the future as the `try` trait gets upgraded. - -```rust, no_run -fn App(cx: Scope) -> Element { - // immediately return "None" - let name = cx.use_hook(|_| Some("hi"))?; -} -``` - -## Early return on result - -Because Rust can't accept both Options and Results with the existing try infrastructure, you'll need to manually handle Results. This can be done by converting them into Options or by explicitly handling them. - -```rust, no_run -fn App(cx: Scope) -> Element { - // Convert Result to Option - let name = cx.use_hook(|_| "1.234").parse().ok()?; - - - // Early return - let count = cx.use_hook(|_| "1.234"); - let val = match count.parse() { - Ok(val) => val - Err(err) => return cx.render(rsx!{ "Parsing failed" }) - }; -} -``` - -Notice that while hooks in Dioxus do not like being called in conditionals or loops, they _are_ okay with early returns. Returning an error state early is a completely valid way of handling errors. - -## Match results - -The next "best" way of handling errors in Dioxus is to match on the error locally. This is the most robust way of handling errors, though it doesn't scale to architectures beyond a single component. - -To do this, we simply have an error state built into our component: - -```rust, no_run -let err = use_state(cx, || None); -``` - -Whenever we perform an action that generates an error, we'll set that error state. We can then match on the error in a number of ways (early return, return Element, etc). - -```rust, no_run -fn Commandline(cx: Scope) -> Element { - let error = use_state(cx, || None); - - cx.render(match *error { - Some(error) => rsx!( - h1 { "An error occured" } - ) - None => rsx!( - input { - oninput: move |_| error.set(Some("bad thing happened!")), - } - ) - }) -} -``` - -## Passing error states through components - -If you're dealing with a handful of components with minimal nesting, you can just pass the error handle into child components. - -```rust, no_run -fn Commandline(cx: Scope) -> Element { - let error = use_state(cx, || None); - - if let Some(error) = **error { - return cx.render(rsx!{ "An error occured" }); - } - - cx.render(rsx!{ - Child { error: error.clone() } - Child { error: error.clone() } - Child { error: error.clone() } - Child { error: error.clone() } - }) -} -``` - -Much like before, our child components can manually set the error during their own actions. The advantage to this pattern is that we can easily isolate error states to a few components at a time, making our app more predictable and robust. - -## Going global - -A strategy for handling cascaded errors in larger apps is through signaling an error using global state. This particular pattern involves creating an "error" context, and then setting it wherever relevant. This particular method is not as "sophisticated" as React's error boundary, but it is more fitting for Rust. - -To get started, consider using a built-in hook like `use_context` and `use_context_provider` or Fermi. Of course, it's pretty easy to roll your own hook too. - -At the "top" of our architecture, we're going to want to explicitly declare a value that could be an error. - -```rust, no_run -enum InputError { - None, - TooLong, - TooShort, -} - -static INPUT_ERROR: Atom = Atom(|_| InputError::None); -``` - -Then, in our top level component, we want to explicitly handle the possible error state for this part of the tree. - -```rust, no_run -fn TopLevel(cx: Scope) -> Element { - let error = use_read(cx, &INPUT_ERROR); - - match error { - TooLong => return cx.render(rsx!{ "FAILED: Too long!" }), - TooShort => return cx.render(rsx!{ "FAILED: Too Short!" }), - _ => {} - } -} -``` - -Now, whenever a downstream component has an error in its actions, it can simply just set its own error state: - -```rust, no_run -fn Commandline(cx: Scope) -> Element { - let set_error = use_set(cx, &INPUT_ERROR); - - cx.render(rsx!{ - input { - oninput: move |evt| { - if evt.value.len() > 20 { - set_error(InputError::TooLong); - } - } - } - }) -} -``` - -This approach to error handling is best in apps that have "well defined" error states. Consider using a crate like `thiserror` or `anyhow` to simplify the generation of the error types. - -This pattern is widely popular in many contexts and is particularly helpful whenever your code generates a non-recoverable error. You can gracefully capture these "global" error states without panicking or mucking up state. diff --git a/docs/guide/src/en/best_practices/index.md b/docs/guide/src/en/best_practices/index.md deleted file mode 100644 index 6b9f0ed1d..000000000 --- a/docs/guide/src/en/best_practices/index.md +++ /dev/null @@ -1,14 +0,0 @@ -# Best Practices - -## Reusable Components - -As much as possible, break your code down into small, reusable components and hooks, instead of implementing large chunks of the UI in a single component. This will help you keep the code maintainable – it is much easier to e.g. add, remove or re-order parts of the UI if it is organized in components. - -Organize your components in modules to keep the codebase easy to navigate! - -## Minimize State Dependencies - -While it is possible to share state between components, this should only be done when necessary. Any component that is associated with a particular state object needs to be re-rendered when that state changes. For this reason: - -- Keep state local to a component if possible -- When sharing state through props, only pass down the specific data necessary diff --git a/docs/guide/src/en/contributing/guiding_principles.md b/docs/guide/src/en/contributing/guiding_principles.md deleted file mode 100644 index 5c730d622..000000000 --- a/docs/guide/src/en/contributing/guiding_principles.md +++ /dev/null @@ -1,37 +0,0 @@ -# Overall Goals - -This document outlines some of the overall goals for Dioxus. These goals are not set in stone, but they represent general guidelines for the project. - -The goal of Dioxus is to make it easy to build **cross-platform applications that scale**. - -## Cross-Platform - -Dioxus is designed to be cross-platform by default. This means that it should be easy to build applications that run on the web, desktop, and mobile. However, Dioxus should also be flexible enough to allow users to opt into platform-specific features when needed. The `use_eval` is one example of this. By default, Dioxus does not assume that the platform supports JavaScript, but it does provide a hook that allows users to opt into JavaScript when needed. - -## Performance - -As Dioxus applications grow, they should remain relatively performant without the need for manual optimizations. There will be cases where manual optimizations are needed, but Dioxus should try to make these cases as rare as possible. - -One of the benefits of the core architecture of Dioxus is that it delivers reasonable performance even when components are rerendered often. It is based on a Virtual Dom which performs diffing which should prevent unnecessary re-renders even when large parts of the component tree are rerun. On top of this, Dioxus groups static parts of the RSX tree together to skip diffing them entirely. - -## Type Safety - -As teams grow, the Type safety of Rust is a huge advantage. Dioxus should leverage this advantage to make it easy to build applications with large teams. - -To take full advantage of Rust's type system, Dioxus should try to avoid exposing public `Any` types and string-ly typed APIs where possible. - -## Developer Experience - -Dioxus should be easy to learn and ergonomic to use. - -- The API of Dioxus attempts to remain close to React's API where possible. This makes it easier for people to learn Dioxus if they already know React - -- We can avoid the tradeoff between simplicity and flexibility by providing multiple layers of API: One for the very common use case, one for low-level control - - - Hooks: the hooks crate has the most common use cases, but `cx.hook` provides a way to access the underlying persistent reference if needed. - - The builder pattern in platform Configs: The builder pattern is used to default to the most common use case, but users can change the defaults if needed. - -- Documentation: - - All public APIs should have rust documentation - - Examples should be provided for all public features. These examples both serve as documentation and testing. They are checked by CI to ensure that they continue to compile - - The most common workflows should be documented in the guide diff --git a/docs/guide/src/en/contributing/index.md b/docs/guide/src/en/contributing/index.md deleted file mode 100644 index d70dc6f8d..000000000 --- a/docs/guide/src/en/contributing/index.md +++ /dev/null @@ -1,57 +0,0 @@ -# Contributing - -Development happens in the [Dioxus GitHub repository](https://github.com/DioxusLabs/dioxus). If you've found a bug or have an idea for a feature, please submit an issue (but first check if someone hasn't [done it already](https://github.com/DioxusLabs/dioxus/issues)). - -[GitHub discussions](https://github.com/DioxusLabs/dioxus/discussions) can be used as a place to ask for help or talk about features. You can also join [our Discord channel](https://discord.gg/XgGxMSkvUM) where some development discussion happens. - -## Improving Docs - -If you'd like to improve the docs, PRs are welcome! Both Rust docs ([source](https://github.com/DioxusLabs/dioxus/tree/master/packages)) and this guide ([source](https://github.com/DioxusLabs/dioxus/tree/master/docs/guide)) can be found in the GitHub repo. - -## Working on the Ecosystem - -Part of what makes React great is the rich ecosystem. We'd like the same for Dioxus! So if you have a library in mind that you'd like to write and many people would benefit from, it will be appreciated. You can [browse npm.js](https://www.npmjs.com/search?q=keywords:react-component) for inspiration. Once you are done, add your library to the [awesome dioxus](https://github.com/DioxusLabs/awesome-dioxus) list or share it in the `#I-made-a-thing` channel on [Discord](https://discord.gg/XgGxMSkvUM). - -## Bugs & Features - -If you've fixed [an open issue](https://github.com/DioxusLabs/dioxus/issues), feel free to submit a PR! You can also take a look at [the roadmap](./roadmap.md) and work on something in there. Consider [reaching out](https://discord.gg/XgGxMSkvUM) to the team first to make sure everyone's on the same page, and you don't do useless work! - -All pull requests (including those made by a team member) must be approved by at least one other team member. -Larger, more nuanced decisions about design, architecture, breaking changes, trade-offs, etc. are made by team consensus. - -## Tools - -The following tools can be helpful when developing Dioxus. Many of these tools are used in the CI pipeline. Running them locally before submitting a PR instead of waiting for CI can save time. - -- All code is tested with [cargo test](https://doc.rust-lang.org/cargo/commands/cargo-test.html) - -```sh -cargo fmt --all -``` - -- All code is formatted with [rustfmt](https://github.com/rust-lang/rustfmt) - -```sh -cargo check --workspace --examples --tests -``` - -- All code is linted with [Clippy](https://doc.rust-lang.org/clippy/) - -```sh -cargo clippy --workspace --examples --tests -- -D warnings -``` - -- Browser tests are automated with [Playwright](https://playwright.dev/docs/intro#installing-playwright) - -```sh -npx playwright test -``` - -- Crates that use unsafe are checked for undefined behavior with [MIRI](https://github.com/rust-lang/miri). MIRI can be helpful to debug what unsafe code is causing issues. Only code that does not interact with system calls can be checked with MIRI. Currently, this is used for the two MIRI tests in `dioxus-core` and `dioxus-native-core`. - -```sh -cargo miri test --package dioxus-core --test miri_stress -cargo miri test --package dioxus-native-core --test miri_native -``` - -- [Rust analyzer](https://rust-analyzer.github.io/) can be very helpful for quick feedback in your IDE. diff --git a/docs/guide/src/en/contributing/project_structure.md b/docs/guide/src/en/contributing/project_structure.md deleted file mode 100644 index 38b6cbde4..000000000 --- a/docs/guide/src/en/contributing/project_structure.md +++ /dev/null @@ -1,50 +0,0 @@ -# Project Struture - -There are many packages in the Dioxus organization. This document will help you understand the purpose of each package and how they fit together. - -## Renderers - -- [Desktop](https://github.com/DioxusLabs/dioxus/tree/master/packages/desktop): A renderer that runs Dioxus applications natively, but renders them with the system webview. -- [Mobile](https://github.com/DioxusLabs/dioxus/tree/master/packages/mobile): A renderer that runs Dioxus applications natively, but renders them with the system webview. This is currently a copy of the desktop renderer. -- [Web](https://github.com/DioxusLabs/dioxus/tree/master/packages/Web): Renders Dioxus applications in the browser by compiling to WASM and manipulating the DOM. -- [Liveview](https://github.com/DioxusLabs/dioxus/tree/master/packages/liveview): A renderer that runs on the server, and renders using a websocket proxy in the browser. -- [Rink](https://github.com/DioxusLabs/dioxus/tree/master/packages/rink): A renderer that renders a HTML-like tree into a terminal. -- [TUI](https://github.com/DioxusLabs/dioxus/tree/master/packages/dioxus-tui): A renderer that uses Rink to render a Dioxus application in a terminal. -- [Blitz-Core](https://github.com/DioxusLabs/blitz/tree/master/blitz-core): An experimental native renderer that renders a HTML-like tree using WGPU. -- [Blitz](https://github.com/DioxusLabs/blitz): An experimental native renderer that uses Blitz-Core to render a Dioxus application using WGPU. -- [SSR](https://github.com/DioxusLabs/dioxus/tree/master/packages/ssr): A renderer that runs Dioxus applications on the server, and renders them to HTML. - -## State Management/Hooks - -- [Hooks](https://github.com/DioxusLabs/dioxus/tree/master/packages/hooks): A collection of common hooks for Dioxus applications -- [Signals](https://github.com/DioxusLabs/dioxus/tree/master/packages/signals): A experimental state management library for Dioxus applications. This currently contains a `Copy` version of UseRef -- [Dioxus STD](https://github.com/DioxusLabs/dioxus-std): A collection of platform agnostic hooks to interact with system interfaces (The clipboard, camera, etc.). -- [Fermi](https://github.com/DioxusLabs/dioxus/tree/master/packages/fermi): A global state management library for Dioxus applications. - [Router](https://github.com/DioxusLabs/dioxus/tree/master/packages/router): A client-side router for Dioxus applications - -## Core utilities - -- [core](https://github.com/DioxusLabs/dioxus/tree/master/packages/core): The core virtual dom implementation every Dioxus application uses - - You can read more about the archetecture of the core [in this blog post](https://dioxuslabs.com/blog/templates-diffing/) and the [custom renderer section of the guide](../custom_renderer/index.md) -- [RSX](https://github.com/DioxusLabs/dioxus/tree/master/packages/RSX): The core parsing for RSX used for hot reloading, autoformatting, and the macro -- [core-macro](https://github.com/DioxusLabs/dioxus/tree/master/packages/core-macro): The rsx! macro used to write Dioxus applications. (This is a wrapper over the RSX crate) -- [HTML macro](https://github.com/DioxusLabs/dioxus-html-macro): A html-like alternative to the RSX macro - -## Native Renderer Utilities - -- [native-core](https://github.com/DioxusLabs/dioxus/tree/master/packages/native-core): Incrementally computed tree of states (mostly styles) - - You can read more about how native-core can help you build native renderers in the [custom renderer section of the guide](../custom_renderer/index.html#native-core) -- [native-core-macro](https://github.com/DioxusLabs/dioxus/tree/master/packages/native-core-macro): A helper macro for native core -- [Taffy](https://github.com/DioxusLabs/taffy): Layout engine powering Blitz-Core, Rink, and Bevy UI - -## Web renderer tooling - -- [HTML](https://github.com/DioxusLabs/dioxus/tree/master/packages/html): defines html specific elements, events, and attributes -- [Interpreter](https://github.com/DioxusLabs/dioxus/tree/master/packages/interpreter): defines browser bindings used by the web and desktop renderers - -## Developer tooling - -- [hot-reload](https://github.com/DioxusLabs/dioxus/tree/master/packages/hot-reload): Macro that uses the RSX crate to hot reload static parts of any rsx! macro. This macro works with any non-web renderer with an [integration](https://crates.io/crates/dioxus-hot-reload) -- [autofmt](https://github.com/DioxusLabs/dioxus/tree/master/packages/autofmt): Formats RSX code -- [rsx-rosetta](https://github.com/DioxusLabs/dioxus/tree/master/packages/RSX-rosetta): Handles conversion between HTML and RSX -- [CLI](https://github.com/DioxusLabs/cli): A Command Line Interface and VSCode extension to assist with Dioxus usage diff --git a/docs/guide/src/en/contributing/roadmap.md b/docs/guide/src/en/contributing/roadmap.md deleted file mode 100644 index fba5913db..000000000 --- a/docs/guide/src/en/contributing/roadmap.md +++ /dev/null @@ -1,138 +0,0 @@ -# Roadmap & Feature-set - -This feature set and roadmap can help you decide if what Dioxus can do today works for you. - -If a feature that you need doesn't exist or you want to contribute to projects on the roadmap, feel free to get involved by [joining the discord](https://discord.gg/XgGxMSkvUM). - -Generally, here's the status of each platform: - -- **Web**: Dioxus is a great choice for pure web-apps – especially for CRUD/complex apps. However, it does lack the ecosystem of React, so you might be missing a component library or some useful hook. - -- **SSR**: Dioxus is a great choice for pre-rendering, hydration, and rendering HTML on a web endpoint. Be warned – the VirtualDom is not (currently) `Send + Sync`. - -- **Desktop**: You can build very competent single-window desktop apps right now. However, multi-window apps require support from Dioxus core and are not ready. - -- **Mobile**: Mobile support is very young. You'll be figuring things out as you go and there are not many support crates for peripherals. - -- **LiveView**: LiveView support is very young. You'll be figuring things out as you go. Thankfully, none of it is too hard and any work can be upstreamed into Dioxus. - -## Features - ---- - -| Feature | Status | Description | -| ------------------------- | ------ | -------------------------------------------------------------------- | -| Conditional Rendering | βœ… | if/then to hide/show component | -| Map, Iterator | βœ… | map/filter/reduce to produce rsx! | -| Keyed Components | βœ… | advanced diffing with keys | -| Web | βœ… | renderer for web browser | -| Desktop (webview) | βœ… | renderer for desktop | -| Shared State (Context) | βœ… | share state through the tree | -| Hooks | βœ… | memory cells in components | -| SSR | βœ… | render directly to string | -| Component Children | βœ… | cx.children() as a list of nodes | -| Headless components | βœ… | components that don't return real elements | -| Fragments | βœ… | multiple elements without a real root | -| Manual Props | βœ… | Manually pass in props with spread syntax | -| Controlled Inputs | βœ… | stateful wrappers around inputs | -| CSS/Inline Styles | βœ… | syntax for inline styles/attribute groups | -| Custom elements | βœ… | Define new element primitives | -| Suspense | βœ… | schedule future render from future/promise | -| Integrated error handling | βœ… | Gracefully handle errors with ? syntax | -| NodeRef | βœ… | gain direct access to nodes | -| Re-hydration | βœ… | Pre-render to HTML to speed up first contentful paint | -| Jank-Free Rendering | βœ… | Large diffs are segmented across frames for silky-smooth transitions | -| Effects | βœ… | Run effects after a component has been committed to render | -| Portals | πŸ›  | Render nodes outside of the traditional tree structure | -| Cooperative Scheduling | πŸ›  | Prioritize important events over non-important events | -| Server Components | πŸ›  | Hybrid components for SPA and Server | -| Bundle Splitting | πŸ‘€ | Efficiently and asynchronously load the app | -| Lazy Components | πŸ‘€ | Dynamically load the new components as the page is loaded | -| 1st class global state | βœ… | redux/recoil/mobx on top of context | -| Runs natively | βœ… | runs as a portable binary w/o a runtime (Node) | -| Subtree Memoization | βœ… | skip diffing static element subtrees | -| High-efficiency templates | βœ… | rsx! calls are translated to templates on the DOM's side | -| Compile-time correct | βœ… | Throw errors on invalid template layouts | -| Heuristic Engine | βœ… | track component memory usage to minimize future allocations | -| Fine-grained reactivity | πŸ‘€ | Skip diffing for fine-grain updates | - -- βœ… = implemented and working -- πŸ›  = actively being worked on -- πŸ‘€ = not yet implemented or being worked on - -## Roadmap - -These Features are planned for the future of Dioxus: - -### Core - -- [x] Release of Dioxus Core -- [x] Upgrade documentation to include more theory and be more comprehensive -- [x] Support for HTML-side templates for lightning-fast dom manipulation -- [ ] Support for multiple renderers for same virtualdom (subtrees) -- [ ] Support for ThreadSafe (Send + Sync) -- [ ] Support for Portals - -### SSR - -- [x] SSR Support + Hydration -- [ ] Integrated suspense support for SSR - -### Desktop - -- [ ] Declarative window management -- [ ] Templates for building/bundling -- [ ] Access to Canvas/WebGL context natively - -### Mobile - -- [ ] Mobile standard library - - [ ] GPS - - [ ] Camera - - [ ] filesystem - - [ ] Biometrics - - [ ] WiFi - - [ ] Bluetooth - - [ ] Notifications - - [ ] Clipboard -- [ ] Animations - -### Bundling (CLI) - -- [x] Translation from HTML into RSX -- [x] Dev server -- [x] Live reload -- [x] Translation from JSX into RSX -- [ ] Hot module replacement -- [ ] Code splitting -- [ ] Asset macros -- [ ] Css pipeline -- [ ] Image pipeline - -### Essential hooks - -- [x] Router -- [x] Global state management -- [ ] Resize observer - -## Work in Progress - -### Build Tool - -We are currently working on our own build tool called [Dioxus CLI](https://github.com/DioxusLabs/cli) which will support: - -- an interactive TUI -- on-the-fly reconfiguration -- hot CSS reloading -- two-way data binding between browser and source code -- an interpreter for `rsx!` -- ability to publish to github/netlify/vercel -- bundling for iOS/Desktop/etc - -### Server Component Support - -While not currently fully implemented, the expectation is that LiveView apps can be a hybrid between Wasm and server-rendered where only portions of a page are "live" and the rest of the page is either server-rendered, statically generated, or handled by the host SPA. - -### Native rendering - -We are currently working on a native renderer for Dioxus using WGPU called [Blitz](https://github.com/DioxusLabs/blitz/). This will allow you to build apps that are rendered natively for iOS, Android, and Desktop. diff --git a/docs/guide/src/en/contributing/walkthrough_readme.md b/docs/guide/src/en/contributing/walkthrough_readme.md deleted file mode 100644 index 5be9d4b5a..000000000 --- a/docs/guide/src/en/contributing/walkthrough_readme.md +++ /dev/null @@ -1,136 +0,0 @@ -# Walkthrough of the Hello World Example Internals - -This walkthrough will take you through the internals of the Hello World example program. It will explain how major parts of Dioxus internals interact with each other to take the readme example from a source file to a running application. This guide should serve as a high-level overview of the internals of Dioxus. It is not meant to be a comprehensive guide. - -## The Source File - -We start will a hello world program. This program renders a desktop app with the text "Hello World" in a webview. - -```rust, no_run -{{#include ../../../../../examples/readme.rs}} -``` - -[![](https://mermaid.ink/img/pako:eNqNkT1vwyAQhv8KvSlR48HphtQtqjK0S6tuSBGBS0CxwcJHk8rxfy_YVqxKVdR3ug_u4YXrQHmNwOFQ-bMyMhB7fReOJbVxfwyyMSy0l7GSpW1ARda727ksUy5MuSyKgvBC5ULA1h5N8WK_kCkfHWHgrBuiXsBynrvdsY9E3u1iM_eyvFOVVadMnELOap-o1911JLPHZ1b-YqLTc3LjTt7WifTZMJPsPdx1ov3Z_ellfcdL8R8vmTy5eUqsTUpZ-vzZzjAEK6gx1NLqtJwuNwSQwRoF8BRqGU4ChOvTORnJf3w7BZxCxBXERkvCjZXpQTXwg6zaVEVtyYe3cdvD0vsf4bucgw?type=png)](https://mermaid.live/edit#pako:eNqNkT1vwyAQhv8KvSlR48HphtQtqjK0S6tuSBGBS0CxwcJHk8rxfy_YVqxKVdR3ug_u4YXrQHmNwOFQ-bMyMhB7fReOJbVxfwyyMSy0l7GSpW1ARda727ksUy5MuSyKgvBC5ULA1h5N8WK_kCkfHWHgrBuiXsBynrvdsY9E3u1iM_eyvFOVVadMnELOap-o1911JLPHZ1b-YqLTc3LjTt7WifTZMJPsPdx1ov3Z_ellfcdL8R8vmTy5eUqsTUpZ-vzZzjAEK6gx1NLqtJwuNwSQwRoF8BRqGU4ChOvTORnJf3w7BZxCxBXERkvCjZXpQTXwg6zaVEVtyYe3cdvD0vsf4bucgw) - -## The rsx! Macro - -Before the Rust compiler runs the program, it will expand all [macros](https://doc.rust-lang.org/reference/procedural-macros.html). Here is what the hello world example looks like expanded: - -```rust, no_run -{{#include ../../../examples/readme_expanded.rs}} -``` - -The rsx macro separates the static parts of the rsx (the template) and the dynamic parts (the [dynamic_nodes](https://docs.rs/dioxus-core/0.3.2/dioxus_core/prelude/struct.VNode.html#structfield.dynamic_nodes) and [dynamic_attributes](https://docs.rs/dioxus-core/0.3.2/dioxus_core/prelude/struct.VNode.html#structfield.dynamic_attrs)). - -The static template only contains the parts of the rsx that cannot change at runtime with holes for the dynamic parts: - -[![](https://mermaid.ink/img/pako:eNqdksFuwjAMhl8l8wkkKtFx65njdtm0E0GVSQKJoEmVOgKEeHecUrXStO0wn5Lf9u8vcm6ggjZQwf4UzspiJPH2Ib3g6NLuELG1oiMkp0TsLs9EDu2iUeSCH8tz2HJmy3lRFPrqsXGq9mxeLzcbCU6LZSUGXWRdwnY7tY7Tdoko-Dq1U64fODgiUfzJMeuOe7_ZGq-ny2jNhGQu9DqT8NUK6w72RcL8dxgdzv4PnHLAKf-Fk80HoBUDrfkqeBkTUd8EC2hMbNBpXtYtJySQNQ0PqPioMR4lSH_nOkwUPq9eQUUxmQWkViOZtUN-UwPVHk8dq0Y7CvH9uf3-E9wfrmuk1A?type=png)](https://mermaid.live/edit#pako:eNqdksFuwjAMhl8l8wkkKtFx65njdtm0E0GVSQKJoEmVOgKEeHecUrXStO0wn5Lf9u8vcm6ggjZQwf4UzspiJPH2Ib3g6NLuELG1oiMkp0TsLs9EDu2iUeSCH8tz2HJmy3lRFPrqsXGq9mxeLzcbCU6LZSUGXWRdwnY7tY7Tdoko-Dq1U64fODgiUfzJMeuOe7_ZGq-ny2jNhGQu9DqT8NUK6w72RcL8dxgdzv4PnHLAKf-Fk80HoBUDrfkqeBkTUd8EC2hMbNBpXtYtJySQNQ0PqPioMR4lSH_nOkwUPq9eQUUxmQWkViOZtUN-UwPVHk8dq0Y7CvH9uf3-E9wfrmuk1A) - -The dynamic_nodes and dynamic_attributes are the parts of the rsx that can change at runtime: - -[![](https://mermaid.ink/img/pako:eNp1UcFOwzAM_RXLVzZpvUbighDiABfgtkxTlnirtSaZUgc0df130hZEEcwny35-79nu0EZHqHDfxA9bmyTw9KIDlGjz7pDMqQZ3DsazhVCQ7dQbwnEiKxwDvN3NqhN4O4C3q_VaIztYKXjkQ7184HcCG3MQSgq6Mes1bjbTPAV3RdqIJN5l-V__2_Fcf5iY68dgG7ZHBT4WD5ftZfIBN7dQ_Tj4w1B9MVTXGZa_GMYdcIGekjfsymW7oaFRavKkUZXUmXTUqENfcCZLfD0Hi0pSpgXmkzNC92zKATyqvWnaUiXHEtPz9KrxY_0nzYOPmA?type=png)](https://mermaid.live/edit#pako:eNp1UcFOwzAM_RXLVzZpvUbighDiABfgtkxTlnirtSaZUgc0df130hZEEcwny35-79nu0EZHqHDfxA9bmyTw9KIDlGjz7pDMqQZ3DsazhVCQ7dQbwnEiKxwDvN3NqhN4O4C3q_VaIztYKXjkQ7184HcCG3MQSgq6Mes1bjbTPAV3RdqIJN5l-V__2_Fcf5iY68dgG7ZHBT4WD5ftZfIBN7dQ_Tj4w1B9MVTXGZa_GMYdcIGekjfsymW7oaFRavKkUZXUmXTUqENfcCZLfD0Hi0pSpgXmkzNC92zKATyqvWnaUiXHEtPz9KrxY_0nzYOPmA) - -## Launching the App - -The app is launched by calling the `launch` function with the root component. Internally, this function will create a new web view using [wry](https://docs.rs/wry/latest/wry/) and create a virtual dom with the root component (`fn app()` in the readme example). This guide will not explain the renderer in-depth, but you can read more about it in the [custom renderer](/guide/custom-renderer) section. - -## The Virtual DOM - -Before we dive into the initial render in the virtual DOM, we need to discuss what the virtual DOM is. The virtual DOM is a representation of the DOM that is used to diff the current DOM from the new DOM. This diff is then used to create a list of mutations that need to be applied to the DOM to bring it into sync with the virtual DOM. - -The Virtual DOM roughly looks like this: - -```rust, no_run -pub struct VirtualDom { - // All the templates that have been created or set during hot reloading - pub(crate) templates: FxHashMap>>, - - // A slab of all the scopes that have been created - pub(crate) scopes: ScopeSlab, - - // All scopes that have been marked as dirty - pub(crate) dirty_scopes: BTreeSet, - - // Every element is actually a dual reference - one to the template and the other to the dynamic node in that template - pub(crate) elements: Slab, - - // This receiver is used to receive messages from hooks about what scopes need to be marked as dirty - pub(crate) rx: futures_channel::mpsc::UnboundedReceiver, - - // The changes queued up to be sent to the renderer - pub(crate) mutations: Mutations<'static>, -} -``` - -> What is a [slab](https://docs.rs/slab/latest/slab/)? -> -> A slab acts like a hashmap with integer keys if you don't care about the value of the keys. It is internally backed by a dense vector which makes it more efficient than a hashmap. When you insert a value into a slab, it returns an integer key that you can use to retrieve the value later. - -> How does Dioxus use slabs? -> -> Dioxus uses "synchronized slabs" to communicate between the renderer and the VDOM. When a node is created in the Virtual DOM, an (elementId, mutation) pair is passed to the renderer to identify that node, which the renderer will then render in actual DOM. These ids are also used by the Virtual Dom to reference that node in future mutations, like setting an attribute on a node or removing a node. When the renderer sends an event to the Virtual Dom, it sends the ElementId of the node that the event was triggered on. The Virtual DOM uses this id to find that node in the slab and then run the necessary event handlers. - -The virtual DOM is a tree of scopes. A new `Scope` is created for every component when it is first rendered and recycled when the component is unmounted. - -Scopes serve three main purposes: - -1. They store the state of hooks used by the component -2. They store the state for the context API (for example: using - [use_shared_state_provider](https://docs.rs/dioxus/latest/dioxus/prelude/fn.use_shared_state_provider.html)). -3. They store the current and previous versions of the `VNode` that was rendered, so they can be - diffed to generate the set of mutations needed to re-render it. - -### The Initial Render - -The root scope is created and rebuilt: - -1. The root component is run -2. The root component returns a `VNode` -3. Mutations for this `VNode` are created and added to the mutation list (this may involve creating new child components) -4. The `VNode` is stored in the root's `Scope`. - -After the root's `Scope` is built, all generated mutations are sent to the renderer, which applies them to the DOM. - -After the initial render, the root `Scope` looks like this: - -[![](https://mermaid.ink/img/pako:eNqtVE1P4zAQ_SuzPrWikRpWXCLtBRDisItWsOxhCaqM7RKricdyJrQV8N93QtvQNCkfEnOynydv3nxkHoVCbUQipjnOVSYDwc_L1AFbWd3dB-kzuEQkuFLoDUwDFkCZAek9nGDh0RlHK__atA1GkUUHf45f0YbppAqB_aOzIAvz-t7-chN_Y-1bw1WSJKsglIu2w9tktWXxIIuHURT5XCqTYa5NmDguw2R8c5MKq2GcgF46WTB_jafi9rZL0yi5q4jQTSrf9altO4okCn1Ratwyz55Qxuku2ITlTMgs6HCQimsPmb3PvqVi-L5gjXP3QcnxWnL8JZLrwGvR31n0KV-Bx6-r-oVkT_-3G1S-NQLbk9i8rj7udP2cixed2QcDCitHJiQw7ub3EVlNecrPjudG2-6soFO5VbMECmR9T5OnlUY4-AFxfw9aTFst3McU9TK1Otm6NEn_DubBYlX2_dglLXOz48FgwJmJ5lZTlhz6xWgNaFnyDgpymcARHO0W2a9J_l5w2wYXvHuGPcqaQ-rESBQmFNJq3nCPNZoK3l4sUSR81DLMUpG6Z_aTFeHV0imRUKjMSFReSzKnVnKGhUimMi8ZNdoShl-rlfmyOUfCS_cPcePz_B_Wl4pc?type=png)](https://mermaid.live/edit#pako:eNqtVE1P4zAQ_SuzPrWikRpWXCLtBRDisItWsOxhCaqM7RKricdyJrQV8N93QtvQNCkfEnOynydv3nxkHoVCbUQipjnOVSYDwc_L1AFbWd3dB-kzuEQkuFLoDUwDFkCZAek9nGDh0RlHK__atA1GkUUHf45f0YbppAqB_aOzIAvz-t7-chN_Y-1bw1WSJKsglIu2w9tktWXxIIuHURT5XCqTYa5NmDguw2R8c5MKq2GcgF46WTB_jafi9rZL0yi5q4jQTSrf9altO4okCn1Ratwyz55Qxuku2ITlTMgs6HCQimsPmb3PvqVi-L5gjXP3QcnxWnL8JZLrwGvR31n0KV-Bx6-r-oVkT_-3G1S-NQLbk9i8rj7udP2cixed2QcDCitHJiQw7ub3EVlNecrPjudG2-6soFO5VbMECmR9T5OnlUY4-AFxfw9aTFst3McU9TK1Otm6NEn_DubBYlX2_dglLXOz48FgwJmJ5lZTlhz6xWgNaFnyDgpymcARHO0W2a9J_l5w2wYXvHuGPcqaQ-rESBQmFNJq3nCPNZoK3l4sUSR81DLMUpG6Z_aTFeHV0imRUKjMSFReSzKnVnKGhUimMi8ZNdoShl-rlfmyOUfCS_cPcePz_B_Wl4pc) - -### Waiting for Events - -The Virtual DOM will only ever re-render a `Scope` if it is marked as dirty. Each hook is responsible for marking the `Scope` as dirty if the state has changed. Hooks can mark a scope as dirty by sending a message to the Virtual Dom's channel. You can see the [implementations](https://github.com/DioxusLabs/dioxus/tree/master/packages/hooks) for the hooks dioxus includes by default on how this is done. Calling `needs_update()` on a hook will also cause it to mark its scope as dirty. - -There are generally two ways a scope is marked as dirty: - -1. The renderer triggers an event: An event listener on this event may be called, which may mark a - component as dirty, if processing the event resulted in any generated any mutations. -2. The renderer calls - [`wait_for_work`](https://docs.rs/dioxus/latest/dioxus/prelude/struct.VirtualDom.html#method.wait_for_work): - This polls dioxus internal future queue. One of these futures may mark a component as dirty. - -Once at least one `Scope` is marked as dirty, the renderer can call [`render_with_deadline`](https://docs.rs/dioxus/latest/dioxus/prelude/struct.VirtualDom.html#method.render_with_deadline) to diff the dirty scopes. - -### Diffing Scopes - -When a user clicks the "up high" button, the root `Scope` will be marked as dirty by the `use_state` hook. The desktop renderer will then call `render_with_deadline`, which will diff the root `Scope`. - -To start the diffing process, the component function is run. After the root component is run it, the root `Scope` will look like this: - -[![](https://mermaid.ink/img/pako:eNrFVlFP2zAQ_iuen0BrpCaIl0i8AEJ72KQJtpcRFBnbJVYTn-U4tBXw33dpG5M2CetoBfdkny_ffb67fPIT5SAkjekkhxnPmHXk-3WiCVpZ3T9YZjJyDeDIDQcjycRCQVwmCTOGXEBhQEvtVvG1CWUldwo0-XX-6vVIF5W1GB9cWVbI1_PNL5v8jW3uPFbpmFOc2HK-GfA2WG1ZeJSFx0EQmJxxmUEupE01liEd394mVAkyjolYaFYgfu1P6N1dF8Yzua-cA51WphtTWzsLc872Zan9CnEGUkktuk6fFm_i5NxFRwn9bUimHrIvCT3-N2EBM70j5XBNOTwI5TrxmvQJkr7ELcHx67Jeggz0v92g8q0RaE-iP1193On6NyxecKUeJeFQaSdtTMLu_Xah5ctT_u94Nty2ZwU0zxWfxqQA5PecPq84kq9nfRw7SK0WDiEFZ4O37d34S_-08lFBVfb92KVb5HIrAp0WpjKYKeGyODLz0dohWIkaZNkiJqfkdLvIH6oRaTSoEmm0n06k0a5K0ZdpL61Io0Yt0nfpxc7UQ0_9cJrhyZ8syX-6brS706Mc489Vjja7fbWj3cxDqIdfJJqOaCFtwZTAV8hT7U0ovjBQRmiMS8HsNKGJfsE4Vjm4WWhOY2crOaKVEczJS8WwgAWNJywv0SuFcmB_rJ41y9fNiBqm_wA0MS9_AUuAiy0?type=png)](https://mermaid.live/edit#pako:eNrFVlFP2zAQ_iuen0BrpCaIl0i8AEJ72KQJtpcRFBnbJVYTn-U4tBXw33dpG5M2CetoBfdkny_ffb67fPIT5SAkjekkhxnPmHXk-3WiCVpZ3T9YZjJyDeDIDQcjycRCQVwmCTOGXEBhQEvtVvG1CWUldwo0-XX-6vVIF5W1GB9cWVbI1_PNL5v8jW3uPFbpmFOc2HK-GfA2WG1ZeJSFx0EQmJxxmUEupE01liEd394mVAkyjolYaFYgfu1P6N1dF8Yzua-cA51WphtTWzsLc872Zan9CnEGUkktuk6fFm_i5NxFRwn9bUimHrIvCT3-N2EBM70j5XBNOTwI5TrxmvQJkr7ELcHx67Jeggz0v92g8q0RaE-iP1193On6NyxecKUeJeFQaSdtTMLu_Xah5ctT_u94Nty2ZwU0zxWfxqQA5PecPq84kq9nfRw7SK0WDiEFZ4O37d34S_-08lFBVfb92KVb5HIrAp0WpjKYKeGyODLz0dohWIkaZNkiJqfkdLvIH6oRaTSoEmm0n06k0a5K0ZdpL61Io0Yt0nfpxc7UQ0_9cJrhyZ8syX-6brS706Mc489Vjja7fbWj3cxDqIdfJJqOaCFtwZTAV8hT7U0ovjBQRmiMS8HsNKGJfsE4Vjm4WWhOY2crOaKVEczJS8WwgAWNJywv0SuFcmB_rJ41y9fNiBqm_wA0MS9_AUuAiy0) - -Next, the Virtual DOM will compare the new VNode with the previous VNode and only update the parts of the tree that have changed. Because of this approach, when a component is re-rendered only the parts of the tree that have changed will be updated in the DOM by the renderer. - -The diffing algorithm goes through the list of dynamic attributes and nodes and compares them to the previous VNode. If the attribute or node has changed, a mutation that describes the change is added to the mutation list. - -Here is what the diffing algorithm looks like for the root `Scope` (red lines indicate that a mutation was generated, and green lines indicate that no mutation was generated) - -[![](https://mermaid.ink/img/pako:eNrFlFFPwjAQx7_KpT7Kko2Elya8qCE-aGLAJ5khpe1Yw9Zbug4k4He3OJjbGPig0T5t17tf_nf777aEo5CEkijBNY-ZsfAwDjW4kxfzhWFZDGNECxOOmYTIYAo2lsCyDG4xzVBLbcv8_RHKSG4V6orSIN0Wxrh8b2RYKr_uTyubd1W92GiWKg7aac6bOU3G803HbVk82xfP_Ok0JEqAT-FeLWJvpFYSOBbaSkMhCMnra5MgtfhWFrPWqHlhL2urT6atbU-oa0PNE8WXFFJ0-nazXakRroddGk9IwYEUnCd5w7Pddr5UTT8ZuVJY5F0fM7ebRLYyXNDgUnprJWxM-9lb7xAQLHe-M2xDYQCD9pD_2hez_kVn-P_rjLq6n3qjYv2iO5qz9DyvPdyv1ETp5eTTJ_7BGvQq8v1TVtl5jXUcRRcrqFh-dI4VtFlBN6t_ynLNkh5JpUmZEm5rbvfhkLiN6H4BQt2jYGYZklC_uzxWWJxsNCfUmkL2SJEJZuWdYs4cKaERS3IXlUJZNI_lGv7cxj2SMf2CeMx5_wBcbK19?type=png)](https://mermaid.live/edit#pako:eNrFlFFPwjAQx7_KpT7Kko2Elya8qCE-aGLAJ5khpe1Yw9Zbug4k4He3OJjbGPig0T5t17tf_nf777aEo5CEkijBNY-ZsfAwDjW4kxfzhWFZDGNECxOOmYTIYAo2lsCyDG4xzVBLbcv8_RHKSG4V6orSIN0Wxrh8b2RYKr_uTyubd1W92GiWKg7aac6bOU3G803HbVk82xfP_Ok0JEqAT-FeLWJvpFYSOBbaSkMhCMnra5MgtfhWFrPWqHlhL2urT6atbU-oa0PNE8WXFFJ0-nazXakRroddGk9IwYEUnCd5w7Pddr5UTT8ZuVJY5F0fM7ebRLYyXNDgUnprJWxM-9lb7xAQLHe-M2xDYQCD9pD_2hez_kVn-P_rjLq6n3qjYv2iO5qz9DyvPdyv1ETp5eTTJ_7BGvQq8v1TVtl5jXUcRRcrqFh-dI4VtFlBN6t_ynLNkh5JpUmZEm5rbvfhkLiN6H4BQt2jYGYZklC_uzxWWJxsNCfUmkL2SJEJZuWdYs4cKaERS3IXlUJZNI_lGv7cxj2SMf2CeMx5_wBcbK19) - -## Conclusion - -This is only a brief overview of how the Virtual Dom works. There are several aspects not yet covered in this guide including: - - * How the Virtual DOM handles async-components - * Keyed diffing - * Using [bump allocation](https://github.com/fitzgen/bumpalo) to efficiently allocate VNodes. - -If you need more information about the Virtual Dom, you can read the code of the [core](https://github.com/DioxusLabs/dioxus/tree/master/packages/core) crate or reach out to us on [Discord](https://discord.gg/XgGxMSkvUM). \ No newline at end of file diff --git a/docs/guide/src/en/custom_renderer/index.md b/docs/guide/src/en/custom_renderer/index.md deleted file mode 100644 index 3b6888b0d..000000000 --- a/docs/guide/src/en/custom_renderer/index.md +++ /dev/null @@ -1,413 +0,0 @@ -# Custom Renderer - -Dioxus is an incredibly portable framework for UI development. The lessons, knowledge, hooks, and components you acquire over time can always be used for future projects. However, sometimes those projects cannot leverage a supported renderer or you need to implement your own better renderer. - -Great news: the design of the renderer is entirely up to you! We provide suggestions and inspiration with the 1st party renderers, but only really require processing `Mutations` and sending `UserEvents`. - -## The specifics: - -Implementing the renderer is fairly straightforward. The renderer needs to: - -1. Handle the stream of edits generated by updates to the virtual DOM -2. Register listeners and pass events into the virtual DOM's event system - -Essentially, your renderer needs to process edits and generate events to update the VirtualDOM. From there, you'll have everything needed to render the VirtualDOM to the screen. - -Internally, Dioxus handles the tree relationship, diffing, memory management, and the event system, leaving as little as possible required for renderers to implement themselves. - -For reference, check out the [javascript interpreter](https://github.com/DioxusLabs/dioxus/tree/master/packages/interpreter) or [tui renderer](https://github.com/DioxusLabs/dioxus/tree/master/packages/dioxus-tui) as a starting point for your custom renderer. - -## Templates - -Dioxus is built around the concept of [Templates](https://docs.rs/dioxus-core/latest/dioxus_core/prelude/struct.Template.html). Templates describe a UI tree known at compile time with dynamic parts filled at runtime. This is useful internally to make skip diffing static nodes, but it is also useful for the renderer to reuse parts of the UI tree. This can be useful for things like a list of items. Each item could contain some static parts and some dynamic parts. The renderer can use the template to create a static part of the UI once, clone it for each element in the list, and then fill in the dynamic parts. - -## Mutations - -The `Mutation` type is a serialized enum that represents an operation that should be applied to update the UI. The variants roughly follow this set: - -```rust, no_run -enum Mutation { - AppendChildren, - AssignId, - CreatePlaceholder, - CreateTextNode, - HydrateText, - LoadTemplate, - ReplaceWith, - ReplacePlaceholder, - InsertAfter, - InsertBefore, - SetAttribute, - SetText, - NewEventListener, - RemoveEventListener, - Remove, - PushRoot, -} -``` - -The Dioxus diffing mechanism operates as a [stack machine](https://en.wikipedia.org/wiki/Stack_machine) where the [LoadTemplate](https://docs.rs/dioxus-core/latest/dioxus_core/enum.Mutation.html#variant.LoadTemplate), [CreatePlaceholder](https://docs.rs/dioxus-core/latest/dioxus_core/enum.Mutation.html#variant.CreatePlaceholder), and [CreateTextNode](https://docs.rs/dioxus-core/latest/dioxus_core/enum.Mutation.html#variant.CreateTextNode) mutations pushes a new "real" DOM node onto the stack and [AppendChildren](https://docs.rs/dioxus-core/latest/dioxus_core/enum.Mutation.html#variant.AppendChildren), [InsertAfter](https://docs.rs/dioxus-core/latest/dioxus_core/enum.Mutation.html#variant.InsertAfter), [InsertBefore](https://docs.rs/dioxus-core/latest/dioxus_core/enum.Mutation.html#variant.InsertBefore), [ReplacePlaceholder](https://docs.rs/dioxus-core/latest/dioxus_core/enum.Mutation.html#variant.ReplacePlaceholder), and [ReplaceWith](https://docs.rs/dioxus-core/latest/dioxus_core/enum.Mutation.html#variant.ReplaceWith) all remove nodes from the stack. - -## Node storage - -Dioxus saves and loads elements with IDs. Inside the VirtualDOM, this is just tracked as as a u64. - -Whenever a `CreateElement` edit is generated during diffing, Dioxus increments its node counter and assigns that new element its current NodeCount. The RealDom is responsible for remembering this ID and pushing the correct node when id is used in a mutation. Dioxus reclaims the IDs of elements when removed. To stay in sync with Dioxus you can use a sparse Vec (Vec>) with possibly unoccupied items. You can use the ids as indexes into the Vec for elements, and grow the Vec when an id does not exist. - -### An Example - -For the sake of understanding, let's consider this example – a very simple UI declaration: - -```rust, no_run -rsx!( h1 {"count: {x}"} ) -``` - -#### Building Templates - -The above rsx will create a template that contains one static h1 tag and a placeholder for a dynamic text node. The template contains the static parts of the UI, and ids for the dynamic parts along with the paths to access them. - -The template will look something like this: - -```rust, no_run -Template { - // Some id that is unique for the entire project - name: "main.rs:1:1:0", - // The root nodes of the template - roots: &[ - TemplateNode::Element { - tag: "h1", - namespace: None, - attrs: &[], - children: &[ - TemplateNode::DynamicText { - id: 0 - }, - ], - } - ], - // the path to each of the dynamic nodes - node_paths: &[ - // the path to dynamic node with a id of 0 - &[ - // on the first root node - 0, - // the first child of the root node - 0, - ] - ], - // the path to each of the dynamic attributes - attr_paths: &'a [&'a [u8]], -} -``` - -> For more detailed docs about the struture of templates see the [Template api docs](https://docs.rs/dioxus-core/latest/dioxus_core/prelude/struct.Template.html) - -This template will be sent to the renderer in the [list of templates](https://docs.rs/dioxus-core/latest/dioxus_core/struct.Mutations.html#structfield.templates) supplied with the mutations the first time it is used. Any time the renderer encounters a [LoadTemplate](https://docs.rs/dioxus-core/latest/dioxus_core/enum.Mutation.html#variant.LoadTemplate) mutation after this, it should clone the template and store it in the given id. - -For dynamic nodes and dynamic text nodes, a placeholder node should be created and inserted into the UI so that the node can be modified later. - -In HTML renderers, this template could look like this: - -```html -

""

-``` - -#### Applying Mutations - -After the renderer has created all of the new templates, it can begin to process the mutations. - -When the renderer starts, it should contain the Root node on the stack and store the Root node with an id of 0. The Root node is the top-level node of the UI. In HTML, this is the `
` element. - -```rust, no_run -instructions: [] -stack: [ - RootNode, -] -nodes: [ - RootNode, -] -``` - -The first mutation is a `LoadTemplate` mutation. This tells the renderer to load a root from the template with the given id. The renderer will then push the root node of the template onto the stack and store it with an id for later. In this case, the root node is an h1 element. - -```rust, no_run -instructions: [ - LoadTemplate { - // the id of the template - name: "main.rs:1:1:0", - // the index of the root node in the template - index: 0, - // the id to store - id: ElementId(1), - } -] -stack: [ - RootNode, -

""

, -] -nodes: [ - RootNode, -

""

, -] -``` - -Next, Dioxus will create the dynamic text node. The diff algorithm decides that this node needs to be created, so Dioxus will generate the Mutation `HydrateText`. When the renderer receives this instruction, it will navigate to the placeholder text node in the template and replace it with the new text. - -```rust, no_run -instructions: [ - LoadTemplate { - name: "main.rs:1:1:0", - index: 0, - id: ElementId(1), - }, - HydrateText { - // the id to store the text node - id: ElementId(2), - // the text to set - text: "count: 0", - } -] -stack: [ - RootNode, -

"count: 0"

, -] -nodes: [ - RootNode, -

"count: 0"

, - "count: 0", -] -``` - -Remember, the h1 node is not attached to anything (it is unmounted) so Dioxus needs to generate an Edit that connects the h1 node to the Root. It depends on the situation, but in this case, we use `AppendChildren`. This pops the text node off the stack, leaving the Root element as the next element on the stack. - -```rust, no_run -instructions: [ - LoadTemplate { - name: "main.rs:1:1:0", - index: 0, - id: ElementId(1), - }, - HydrateText { - id: ElementId(2), - text: "count: 0", - }, - AppendChildren { - // the id of the parent node - id: ElementId(0), - // the number of nodes to pop off the stack and append - m: 1 - } -] -stack: [ - RootNode, -] -nodes: [ - RootNode, -

"count: 0"

, - "count: 0", -] -``` - -Over time, our stack looked like this: - -```rust, no_run -[Root] -[Root,

""

] -[Root,

"count: 0"

] -[Root] -``` - -Conveniently, this approach completely separates the Virtual DOM and the Real DOM. Additionally, these edits are serializable, meaning we can even manage UIs across a network connection. This little stack machine and serialized edits make Dioxus independent of platform specifics. - -Dioxus is also really fast. Because Dioxus splits the diff and patch phase, it's able to make all the edits to the RealDOM in a very short amount of time (less than a single frame) making rendering very snappy. It also allows Dioxus to cancel large diffing operations if higher priority work comes in while it's diffing. - -This little demo serves to show exactly how a Renderer would need to process a mutation stream to build UIs. - -## Event loop - -Like most GUIs, Dioxus relies on an event loop to progress the VirtualDOM. The VirtualDOM itself can produce events as well, so it's important for your custom renderer can handle those too. - -The code for the WebSys implementation is straightforward, so we'll add it here to demonstrate how simple an event loop is: - -```rust, no_run, ignore -pub async fn run(&mut self) -> dioxus_core::error::Result<()> { - // Push the body element onto the WebsysDom's stack machine - let mut websys_dom = crate::new::WebsysDom::new(prepare_websys_dom()); - websys_dom.stack.push(root_node); - - // Rebuild or hydrate the virtualdom - let mutations = self.internal_dom.rebuild(); - websys_dom.apply_mutations(mutations); - - // Wait for updates from the real dom and progress the virtual dom - loop { - let user_input_future = websys_dom.wait_for_event(); - let internal_event_future = self.internal_dom.wait_for_work(); - - match select(user_input_future, internal_event_future).await { - Either::Left((_, _)) => { - let mutations = self.internal_dom.work_with_deadline(|| false); - websys_dom.apply_mutations(mutations); - }, - Either::Right((event, _)) => websys_dom.handle_event(event), - } - - // render - } -} -``` - -It's important to decode what the real events are for your event system into Dioxus' synthetic event system (synthetic meaning abstracted). This simply means matching your event type and creating a Dioxus `UserEvent` type. Right now, the virtual event system is modeled almost entirely around the HTML spec, but we are interested in slimming it down. - -```rust, no_run, ignore -fn virtual_event_from_websys_event(event: &web_sys::Event) -> VirtualEvent { - match event.type_().as_str() { - "keydown" => { - let event: web_sys::KeyboardEvent = event.clone().dyn_into().unwrap(); - UserEvent::KeyboardEvent(UserEvent { - scope_id: None, - priority: EventPriority::Medium, - name: "keydown", - // This should be whatever element is focused - element: Some(ElementId(0)), - data: Arc::new(KeyboardData{ - char_code: event.char_code(), - key: event.key(), - key_code: event.key_code(), - alt_key: event.alt_key(), - ctrl_key: event.ctrl_key(), - meta_key: event.meta_key(), - shift_key: event.shift_key(), - location: event.location(), - repeat: event.repeat(), - which: event.which(), - }) - }) - } - _ => todo!() - } -} -``` - -## Custom raw elements - -If you need to go as far as relying on custom elements/attributes for your renderer – you totally can. This still enables you to use Dioxus' reactive nature, component system, shared state, and other features, but will ultimately generate different nodes. All attributes and listeners for the HTML and SVG namespace are shuttled through helper structs that essentially compile away. You can drop in your elements any time you want, with little hassle. However, you must be sure your renderer can handle the new namespace. - -For more examples and information on how to create custom namespaces, see the [`dioxus_html` crate](https://github.com/DioxusLabs/dioxus/blob/master/packages/html/README.md#how-to-extend-it). - -# Native Core - -If you are creating a renderer in rust, the [native-core](https://github.com/DioxusLabs/dioxus/tree/master/packages/native-core) crate provides some utilities to implement a renderer. It provides an abstraction over Mutations and Templates and contains helpers that can handle the layout and text editing for you. - -## The RealDom - -The `RealDom` is a higher-level abstraction over updating the Dom. It uses an entity component system to manage the state of nodes. This system allows you to modify insert and modify arbitrary components on nodes. On top of this, the RealDom provides a way to manage a tree of nodes, and the State trait provides a way to automatically add and update these components when the tree is modified. It also provides a way to apply `Mutations` to the RealDom. - -### Example - -Let's build a toy renderer with borders, size, and text color. -Before we start let's take a look at an example element we can render: - -```rust, no_run -cx.render(rsx!{ - div{ - color: "red", - p{ - border: "1px solid black", - "hello world" - } - } -}) -``` - -In this tree, the color depends on the parent's color. The layout depends on the children's layout, the current text, and the text size. The border depends on only the current node. - -In the following diagram arrows represent dataflow: - -[![](https://mermaid.ink/img/pako:eNqllV1vgjAUhv8K6W4wkQVa2QdLdrHsdlfukmSptEhjoaSWqTH-9xVwONAKst70g5739JzzlO5BJAgFAYi52EQJlsr6fAszS7d1sVhKnCdWJDJFt6peLVs5-9owohK7HFrVcFJ_pxnpmK8VVvRkTJikkWIiaxy1dhP23bUwW1WW5WbPrrqJ4ziR4EJ6dtVN2ls5y1ZztePUcrWZFCvqVEcPPDffvlyS1XoLIQnVgnVvVPR6FU9Zc-6dV453ojjOPbuetRJ57gIeXQR3cez7rjtteZyZQ2j5MqmjqwE0ZW0VKx9RKtgpFewp1aw3sXXFy6TWgiYlv8mfq1scD8ofbBCAfQg8_AMBOAyBxzEIwA4CxgQ99QbQkjnD2KT7_CfxGF8_9WXQEsq5sDZCcjICOXRCri4h6r3NA38Q6Jdi1EOx5w3DGDYYI6MUvJFjM3VoGHUeGoMd6mBnDmh2E3fo7O4Yhf0x4OkBmIKUyhQzol_GfbkcApXQlIYg0EOC5SoEYXbQ-3ChxHyXRSBQsqBTUOREx_7OsAY3BUGM-VqvUsKUkB_1U6vf05gtweEHTk4_HQ?type=png)](https://mermaid.live/edit#pako:eNqllV1vgjAUhv8K6W4wkQVa2QdLdrHsdlfukmSptEhjoaSWqTH-9xVwONAKst70g5739JzzlO5BJAgFAYi52EQJlsr6fAszS7d1sVhKnCdWJDJFt6peLVs5-9owohK7HFrVcFJ_pxnpmK8VVvRkTJikkWIiaxy1dhP23bUwW1WW5WbPrrqJ4ziR4EJ6dtVN2ls5y1ZztePUcrWZFCvqVEcPPDffvlyS1XoLIQnVgnVvVPR6FU9Zc-6dV453ojjOPbuetRJ57gIeXQR3cez7rjtteZyZQ2j5MqmjqwE0ZW0VKx9RKtgpFewp1aw3sXXFy6TWgiYlv8mfq1scD8ofbBCAfQg8_AMBOAyBxzEIwA4CxgQ99QbQkjnD2KT7_CfxGF8_9WXQEsq5sDZCcjICOXRCri4h6r3NA38Q6Jdi1EOx5w3DGDYYI6MUvJFjM3VoGHUeGoMd6mBnDmh2E3fo7O4Yhf0x4OkBmIKUyhQzol_GfbkcApXQlIYg0EOC5SoEYXbQ-3ChxHyXRSBQsqBTUOREx_7OsAY3BUGM-VqvUsKUkB_1U6vf05gtweEHTk4_HQ) - -[//]: # "%% mermaid flow chart" -[//]: # "flowchart TB" -[//]: # " subgraph context" -[//]: # " text_width(text width)" -[//]: # " end" -[//]: # " subgraph state" -[//]: # " direction TB" -[//]: # " subgraph div state" -[//]: # " direction TB" -[//]: # " state1(state)---color1(color)" -[//]: # " linkStyle 0 stroke-width:10px;" -[//]: # " state1---border1(border)" -[//]: # " linkStyle 1 stroke-width:10px;" -[//]: # " text_width-.->layout_width1(layout width)" -[//]: # " linkStyle 2 stroke:#ff5500,stroke-width:4px;" -[//]: # " state1---layout_width1" -[//]: # " linkStyle 3 stroke-width:10px;" -[//]: # " end" -[//]: # " subgraph p state" -[//]: # " direction TB" -[//]: # " state2(state)---color2(color)" -[//]: # " linkStyle 4 stroke-width:10px;" -[//]: # " color1-.->color2" -[//]: # " linkStyle 5 stroke:#0000ff,stroke-width:4px;" -[//]: # " state2---border2(border)" -[//]: # " linkStyle 6 stroke-width:10px;" -[//]: # " text_width-.->layout_width2(layout width)" -[//]: # " linkStyle 7 stroke:#ff5500,stroke-width:4px;" -[//]: # " state2---layout_width2" -[//]: # " linkStyle 8 stroke-width:10px;" -[//]: # " layout_width2-.->layout_width1" -[//]: # " linkStyle 9 stroke:#00aa00,stroke-width:4px;" -[//]: # " end" -[//]: # " subgraph hello world state" -[//]: # " direction TB" -[//]: # " state3(state)---border3(border)" -[//]: # " linkStyle 10 stroke-width:10px;" -[//]: # " state3---color3(color)" -[//]: # " linkStyle 11 stroke-width:10px;" -[//]: # " color2-.->color3" -[//]: # " linkStyle 12 stroke:#0000ff,stroke-width:4px;" -[//]: # " text_width-.->layout_width3(layout width)" -[//]: # " linkStyle 13 stroke:#ff5500,stroke-width:4px;" -[//]: # " state3---layout_width3" -[//]: # " linkStyle 14 stroke-width:10px;" -[//]: # " layout_width3-.->layout_width2" -[//]: # " linkStyle 15 stroke:#00aa00,stroke-width:4px;" -[//]: # " end" -[//]: # " end" - -To help in building a Dom, native-core provides the State trait and a RealDom struct. The State trait provides a way to describe how states in a node depend on other states in its relatives. By describing how to update a single node from its relations, native-core will derive a way to update the states of all nodes for you. Once you have a state you can provide it as a generic to RealDom. RealDom provides all of the methods to interact and update your new dom. - -Native Core cannot create all of the required methods for the State trait, but it can derive some of them. To implement the State trait, you must implement the following methods and let the `#[partial_derive_state]` macro handle the rest: - -```rust, no_run, ignore -{{#include ../../../examples/custom_renderer.rs:derive_state}} -``` - -Lets take a look at how to implement the State trait for a simple renderer. - -```rust, no_run -{{#include ../../../examples/custom_renderer.rs:state_impl}} -``` - -Now that we have our state, we can put it to use in our RealDom. We can update the RealDom with apply_mutations to update the structure of the dom (adding, removing, and changing properties of nodes) and then update_state to update the States for each of the nodes that changed. - -```rust, no_run -{{#include ../../../examples/custom_renderer.rs:rendering}} -``` - -## Layout - -For most platforms, the layout of the Elements will stay the same. The [layout_attributes](https://docs.rs/dioxus-native-core/latest/dioxus_native_core/layout_attributes/index.html) module provides a way to apply HTML attributes a [Taffy](https://docs.rs/taffy/latest/taffy/index.html) layout style. - -## Text Editing - -To make it easier to implement text editing in rust renderers, `native-core` also contains a renderer-agnostic cursor system. The cursor can handle text editing, selection, and movement with common keyboard shortcuts integrated. - -```rust, no_run -{{#include ../../../examples/custom_renderer.rs:cursor}} -``` - -## Conclusion - -That should be it! You should have nearly all the knowledge required on how to implement your renderer. We're super interested in seeing Dioxus apps brought to custom desktop renderers, mobile renderers, video game UI, and even augmented reality! If you're interested in contributing to any of these projects, don't be afraid to reach out or join the [community](https://discord.gg/XgGxMSkvUM). diff --git a/docs/guide/src/en/describing_ui/component_children.md b/docs/guide/src/en/describing_ui/component_children.md deleted file mode 100644 index 7e329abbc..000000000 --- a/docs/guide/src/en/describing_ui/component_children.md +++ /dev/null @@ -1,31 +0,0 @@ -# Component Children - -In some cases, you may wish to create a component that acts as a container for some other content, without the component needing to know what that content is. To achieve this, create a prop of type `Element`: - -```rust, no_run -{{#include ../../../examples/component_element_props.rs:Clickable}} -``` - -Then, when rendering the component, you can pass in the output of `cx.render(rsx!(...))`: - -```rust, no_run -{{#include ../../../examples/component_element_props.rs:Clickable_usage}} -``` - -> Note: Since `Element<'a>` is a borrowed prop, there will be no memoization. - -> Warning: While it may compile, do not include the same `Element` more than once in the RSX. The resulting behavior is unspecified. - -## The `children` field - -Rather than passing the RSX through a regular prop, you may wish to accept children similarly to how elements can have children. The "magic" `children` prop lets you achieve this: - -```rust, no_run -{{#include ../../../examples/component_children.rs:Clickable}} -``` - -This makes using the component much simpler: simply put the RSX inside the `{}` brackets – and there is no need for a `render` call or another macro! - -```rust, no_run -{{#include ../../../examples/component_children.rs:Clickable_usage}} -``` diff --git a/docs/guide/src/en/describing_ui/component_props.md b/docs/guide/src/en/describing_ui/component_props.md deleted file mode 100644 index 947ec5f70..000000000 --- a/docs/guide/src/en/describing_ui/component_props.md +++ /dev/null @@ -1,144 +0,0 @@ -# Component Props - -Just like you can pass arguments to a function, you can pass props to a component that customize its behavior! The components we've seen so far didn't accept any props – so let's write some components that do. - -## `#[derive(Props)]` - -Component props are a single struct annotated with `#[derive(Props)]`. For a component to accept props, the type of its argument must be `Scope`. Then, you can access the value of the props using `cx.props`. - -There are 2 flavors of Props structs: - -- Owned props: - - Don't have an associated lifetime - - Implement `PartialEq`, allow for memoization (if the props don't change, Dioxus won't re-render the component) -- Borrowed props: - - [Borrow](https://doc.rust-lang.org/beta/rust-by-example/scope/borrow.html) from a parent component - - Cannot be memoized due to lifetime constraints - -### Owned Props - -Owned Props are very simple – they don't borrow anything. Example: - -```rust, no_run -{{#include ../../../examples/component_owned_props.rs:Likes}} -``` - -You can then pass prop values to the component the same way you would pass attributes to an element: - -```rust, no_run -{{#include ../../../examples/component_owned_props.rs:App}} -``` - -![Screenshot: Likes component](./images/component_owned_props_screenshot.png) - -### Borrowed Props - -Owned props work well if your props are easy to copy around – like a single number. But what if we need to pass a larger data type, like a String from an `App` Component to a `TitleCard` subcomponent? A naive solution might be to [`.clone()`](https://doc.rust-lang.org/std/clone/trait.Clone.html) the String, creating a copy of it for the subcomponent – but this would be inefficient, especially for larger Strings. - -Rust allows for something more efficient – borrowing the String as a `&str` – this is what Borrowed Props are for! - -```rust, no_run -{{#include ../../../examples/component_borrowed_props.rs:TitleCard}} -``` - -We can then use the component like this: - -```rust, no_run -{{#include ../../../examples/component_borrowed_props.rs:App}} -``` - -![Screenshot: TitleCard component](./images/component_borrowed_props_screenshot.png) - -Borrowed props can be very useful, but they do not allow for memorization so they will _always_ rerun when the parent scope is rerendered. Because of this Borrowed Props should be reserved for components that are cheap to rerun or places where cloning data is an issue. Using Borrowed Props everywhere will result in large parts of your app rerunning every interaction. - -## Prop Options - -The `#[derive(Props)]` macro has some features that let you customize the behavior of props. - -### Optional Props - -You can create optional fields by using the `Option<…>` type for a field: - -```rust, no_run -{{#include ../../../examples/component_props_options.rs:OptionalProps}} -``` - -Then, you can choose to either provide them or not: - -```rust, no_run -{{#include ../../../examples/component_props_options.rs:OptionalProps_usage}} -``` - -### Explicitly Required `Option`s - -If you want to explicitly require an `Option`, and not an optional prop, you can annotate it with `#[props(!optional)]`: - -```rust, no_run -{{#include ../../../examples/component_props_options.rs:ExplicitOption}} -``` - -Then, you have to explicitly pass either `Some("str")` or `None`: - -```rust, no_run -{{#include ../../../examples/component_props_options.rs:ExplicitOption_usage}} -``` - -### Default Props - -You can use `#[props(default = 42)]` to make a field optional and specify its default value: - -```rust, no_run -{{#include ../../../examples/component_props_options.rs:DefaultComponent}} -``` - -Then, similarly to optional props, you don't have to provide it: - -```rust, no_run -{{#include ../../../examples/component_props_options.rs:DefaultComponent_usage}} -``` - -### Automatic Conversion with `.into` - -It is common for Rust functions to accept `impl Into` rather than just `SomeType` to support a wider range of parameters. If you want similar functionality with props, you can use `#[props(into)]`. For example, you could add it on a `String` prop – and `&str` will also be automatically accepted, as it can be converted into `String`: - -```rust, no_run -{{#include ../../../examples/component_props_options.rs:IntoComponent}} -``` - -Then, you can use it so: - -```rust, no_run -{{#include ../../../examples/component_props_options.rs:IntoComponent_usage}} -``` - -## The `inline_props` macro - -So far, every Component function we've seen had a corresponding ComponentProps struct to pass in props. This was quite verbose... Wouldn't it be nice to have props as simple function arguments? Then we wouldn't need to define a Props struct, and instead of typing `cx.props.whatever`, we could just use `whatever` directly! - -`inline_props` allows you to do just that. Instead of typing the "full" version: - -```rust, no_run -#[derive(Props, PartialEq)] -struct TitleCardProps { - title: String, -} - -fn TitleCard(cx: Scope) -> Element { - cx.render(rsx!{ - h1 { "{cx.props.title}" } - }) -} -``` - -...you can define a function that accepts props as arguments. Then, just annotate it with `#[inline_props]`, and the macro will turn it into a regular Component for you: - -```rust, no_run -#[inline_props] -fn TitleCard(cx: Scope, title: String) -> Element { - cx.render(rsx!{ - h1 { "{title}" } - }) -} -``` - -> While the new Component is shorter and easier to read, this macro should not be used by library authors since you have less control over Prop documentation. diff --git a/docs/guide/src/en/describing_ui/components.md b/docs/guide/src/en/describing_ui/components.md deleted file mode 100644 index 2b72fcaf2..000000000 --- a/docs/guide/src/en/describing_ui/components.md +++ /dev/null @@ -1,27 +0,0 @@ -# Components - -Just like you wouldn't want to write a complex program in a single, long, `main` function, you shouldn't build a complex UI in a single `App` function. Instead, you should break down the functionality of an app in logical parts called components. - -A component is a Rust function, named in UpperCammelCase, that takes a `Scope` parameter and returns an `Element` describing the UI it wants to render. In fact, our `App` function is a component! - -```rust, no_run -{{#include ../../../examples/hello_world_desktop.rs:component}} -``` - -> You'll probably want to add `#![allow(non_snake_case)]` to the top of your crate to avoid warnings about UpperCammelCase component names - -A Component is responsible for some rendering task – typically, rendering an isolated part of the user interface. For example, you could have an `About` component that renders a short description of Dioxus Labs: - -```rust, no_run -{{#include ../../../examples/components.rs:About}} -``` - -Then, you can render your component in another component, similarly to how elements are rendered: - -```rust, no_run -{{#include ../../../examples/components.rs:App}} -``` - -![Screenshot containing the About component twice](./images/screenshot_about_component.png) - -> At this point, it might seem like components are nothing more than functions. However, as you learn more about the features of Dioxus, you'll see that they are actually more powerful! diff --git a/docs/guide/src/en/describing_ui/images/component_borrowed_props_screenshot.png b/docs/guide/src/en/describing_ui/images/component_borrowed_props_screenshot.png deleted file mode 100644 index 6f1864662f34cf7bc4101f2778f0ccb03d1d1646..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 7868 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 diff --git a/docs/guide/src/en/describing_ui/images/component_owned_props_screenshot.png b/docs/guide/src/en/describing_ui/images/component_owned_props_screenshot.png deleted file mode 100644 index 2a1146cd1d49b2b54bcb1d103f69a294d3921ec9..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 6318 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 diff --git a/docs/guide/src/en/describing_ui/images/screenshot_about_component.png b/docs/guide/src/en/describing_ui/images/screenshot_about_component.png deleted file mode 100644 index 36f7250a1bbb007bf4f3cea787319d9df08f7b8d..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 19470 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 diff --git a/docs/guide/src/en/describing_ui/index.md b/docs/guide/src/en/describing_ui/index.md deleted file mode 100644 index 8e5b3fe8f..000000000 --- a/docs/guide/src/en/describing_ui/index.md +++ /dev/null @@ -1,142 +0,0 @@ -# Describing the UI - -Dioxus is a _declarative_ framework. This means that instead of telling Dioxus what to do (e.g. to "create an element" or "set the color to red") we simply _declare_ what we want the UI to look like using RSX. - -You have already seen a simple example of RSX syntax in the "hello world" application: - -```rust, no_run -{{#include ../../../examples/hello_world_desktop.rs:component}} -``` - -Here, we use the `rsx!` macro to _declare_ that we want a `div` element, containing the text `"Hello, world!"`. Dioxus takes the RSX and constructs a UI from it. - -## RSX Features - -RSX is very similar to HTML in that it describes elements with attributes and children. Here's an empty `div` element in RSX, as well as the resulting HTML: - -```rust, no_run -{{#include ../../../examples/rsx_overview.rs:empty}} -``` - -```html -
-``` - -### Attributes - -Attributes (and [listeners](../interactivity/index.md)) modify the behavior or appearance of the element they are attached to. They are specified inside the `{}` brackets, using the `name: value` syntax. You can provide the value as a literal in the RSX: - -```rust, no_run -{{#include ../../../examples/rsx_overview.rs:attributes}} -``` - -```html - -``` - -> Note: All attributes defined in `dioxus-html` follow the snake_case naming convention. They transform their `snake_case` names to HTML's `camelCase` attributes. - -> Note: Styles can be used directly outside of the `style:` attribute. In the above example, `color: "red"` is turned into `style="color: red"`. - -#### Custom Attributes - -Dioxus has a pre-configured set of attributes that you can use. RSX is validated at compile time to make sure you didn't specify an invalid attribute. If you want to override this behavior with a custom attribute name, specify the attribute in quotes: - -```rust, no_run -{{#include ../../../examples/rsx_overview.rs:custom_attributes}} -``` - -```html - -``` - -### Interpolation - -Similarly to how you can [format](https://doc.rust-lang.org/rust-by-example/hello/print/fmt.html) Rust strings, you can also interpolate in RSX text. Use `{variable}` to Display the value of a variable in a string, or `{variable:?}` to use the Debug representation: - -```rust, no_run -{{#include ../../../examples/rsx_overview.rs:formatting}} -``` - -```html -
-
ES
-
42
-
{}
-
-``` - -### Children - -To add children to an element, put them inside the `{}` brackets after all attributes and listeners in the element. They can be other elements, text, or [components](components.md). For example, you could have an `ol` (ordered list) element, containing 3 `li` (list item) elements, each of which contains some text: - -```rust, no_run -{{#include ../../../examples/rsx_overview.rs:children}} -``` - -```html -
    -
  1. First Item
    2. -
  2. Second Item
    3. -
  3. Third Item
    4. -
-``` - -### Fragments - -You can render multiple elements at the top level of `rsx!` and they will be automatically grouped. - -```rust, no_run -{{#include ../../../examples/rsx_overview.rs:manyroots}} -``` - -```html -

First Item

-

Second Item

-``` - -### Expressions - -You can include arbitrary Rust expressions as children within RSX that implements [IntoDynNode](https://docs.rs/dioxus-core/0.3/dioxus_core/trait.IntoDynNode.html). This is useful for displaying data from an [iterator](https://doc.rust-lang.org/stable/book/ch13-02-iterators.html#processing-a-series-of-items-with-iterators): - -```rust, no_run -{{#include ../../../examples/rsx_overview.rs:expression}} -``` - -```html -DIOXUS0123456789 -``` - -### Loops - -In addition to iterators you can also use for loops directly within RSX: - -```rust, no_run -{{#include ../../../examples/rsx_overview.rs:loops}} -``` - -```html -
0
-
1
-
2
-
0
-
1
-
2
-``` - -### If statements - -You can also use if statements without an else branch within RSX: - -```rust, no_run -{{#include ../../../examples/rsx_overview.rs:ifstatements}} -``` - -```html -
true
-``` diff --git a/docs/guide/src/en/describing_ui/special_attributes.md b/docs/guide/src/en/describing_ui/special_attributes.md deleted file mode 100644 index 4ba7a40f1..000000000 --- a/docs/guide/src/en/describing_ui/special_attributes.md +++ /dev/null @@ -1,62 +0,0 @@ -# Special Attributes - -While most attributes are simply passed on to the HTML, some have special behaviors. - -## The HTML Escape Hatch - -If you're working with pre-rendered assets, output from templates, or output from a JS library, then you might want to pass HTML directly instead of going through Dioxus. In these instances, reach for `dangerous_inner_html`. - -For example, shipping a markdown-to-Dioxus converter might significantly bloat your final application size. Instead, you'll want to pre-render your markdown to HTML and then include the HTML directly in your output. We use this approach for the [Dioxus homepage](https://dioxuslabs.com): - -```rust, no_run -{{#include ../../../examples/dangerous_inner_html.rs:dangerous_inner_html}} -``` - -> Note! This attribute is called "dangerous_inner_html" because it is **dangerous** to pass it data you don't trust. If you're not careful, you can easily expose [cross-site scripting (XSS)](https://en.wikipedia.org/wiki/Cross-site_scripting) attacks to your users. -> -> If you're handling untrusted input, make sure to sanitize your HTML before passing it into `dangerous_inner_html` – or just pass it to a Text Element to escape any HTML tags. - -## Boolean Attributes - -Most attributes, when rendered, will be rendered exactly as the input you provided. However, some attributes are considered "boolean" attributes and just their presence determines whether they affect the output. For these attributes, a provided value of `"false"` will cause them to be removed from the target element. - -So this RSX wouldn't actually render the `hidden` attribute: - -```rust, no_run -{{#include ../../../examples/boolean_attribute.rs:boolean_attribute}} -``` - -```html -
hello
-``` - -Not all attributes work like this however. _Only the following attributes_ have this behavior: - -- `allowfullscreen` -- `allowpaymentrequest` -- `async` -- `autofocus` -- `autoplay` -- `checked` -- `controls` -- `default` -- `defer` -- `disabled` -- `formnovalidate` -- `hidden` -- `ismap` -- `itemscope` -- `loop` -- `multiple` -- `muted` -- `nomodule` -- `novalidate` -- `open` -- `playsinline` -- `readonly` -- `required` -- `reversed` -- `selected` -- `truespeed` - -For any other attributes, a value of `"false"` will be sent directly to the DOM. diff --git a/docs/guide/src/en/fullstack/getting_started.md b/docs/guide/src/en/fullstack/getting_started.md deleted file mode 100644 index 401af1d43..000000000 --- a/docs/guide/src/en/fullstack/getting_started.md +++ /dev/null @@ -1,102 +0,0 @@ -> This guide assumes you read the [Web](web.md) guide and installed the [Dioxus-cli](https://github.com/DioxusLabs/cli) - -# Getting Started - -## Setup - -For this guide, we're going to show how to use Dioxus with [Axum](https://docs.rs/axum/latest/axum/), but `dioxus-fullstack` also integrates with the [Warp](https://docs.rs/warp/latest/warp/) and [Salvo](https://docs.rs/salvo/latest/salvo/) web frameworks. - -Make sure you have Rust and Cargo installed, and then create a new project: - -```shell -cargo new --bin demo -cd demo -``` - -Add `dioxus` and `dioxus-fullstack` as dependencies: - -```shell -cargo add dioxus -cargo add dioxus-fullstack --features axum, ssr -``` - -Next, add all the Axum dependencies. This will be different if you're using a different Web Framework - -```shell -cargo add tokio --features full -cargo add axum -``` - -Your dependencies should look roughly like this: - -```toml -[dependencies] -axum = "*" -dioxus = { version = "*" } -dioxus-fullstack = { version = "*", features = ["axum", "ssr"] } -tokio = { version = "*", features = ["full"] } -``` - -Now, set up your Axum app to serve the Dioxus app. - -```rust, no_run -{{#include ../../../examples/server_basic.rs}} -``` - -Now, run your app with `cargo run` and open `http://localhost:8080` in your browser. You should see a server-side rendered page with a counter. - -## Hydration - -Right now, the page is static. We can't interact with the buttons. To fix this, we can hydrate the page with `dioxus-web`. - -First, modify your `Cargo.toml` to include two features, one for the server called `ssr`, and one for the client called `web`. - -```toml -[dependencies] -# Common dependancies -dioxus = { version = "*" } -dioxus-fullstack = { version = "*" } - -# Web dependancies -dioxus-web = { version = "*", features=["hydrate"], optional = true } - -# Server dependancies -axum = { version = "0.6.12", optional = true } -tokio = { version = "1.27.0", features = ["full"], optional = true } - -[features] -default = [] -ssr = ["axum", "tokio", "dioxus-fullstack/axum"] -web = ["dioxus-web"] -``` - -Next, we need to modify our `main.rs` to use either hydrate on the client or render on the server depending on the active features. - -```rust, no_run -{{#include ../../../examples/hydration.rs}} -``` - -Now, build your client-side bundle with `dx build --features web` and run your server with `cargo run --features ssr`. You should see the same page as before, but now you can interact with the buttons! - -## Sycronizing props between the server and client - -Let's make the initial count of the counter dynamic based on the current page. - -### Modifying the server - -To do this, we must remove the serve_dioxus_application and replace it with a custom implementation of its four key functions: - -- Serve static WASM and JS files with serve_static_assets -- Register server functions with register_server_fns (more information on server functions later) -- Connect to the hot reload server with connect_hot_reload -- A custom route that uses SSRState to server-side render the application - -### Modifying the client - -The only thing we need to change on the client is the props. `dioxus-fullstack` will automatically serialize the props it uses to server render the app and send them to the client. In the client section of `main.rs`, we need to add `get_root_props_from_document` to deserialize the props before we hydrate the app. - -```rust, no_run -{{#include ../../../examples/hydration_props.rs}} -``` - -Now, build your client-side bundle with `dx build --features web` and run your server with `cargo run --features ssr`. Navigate to `http://localhost:8080/1` and you should see the counter start at 1. Navigate to `http://localhost:8080/2` and you should see the counter start at 2. diff --git a/docs/guide/src/en/fullstack/index.md b/docs/guide/src/en/fullstack/index.md deleted file mode 100644 index a9b39c8f1..000000000 --- a/docs/guide/src/en/fullstack/index.md +++ /dev/null @@ -1,59 +0,0 @@ -# Fullstack development - -So far you have learned about three different approaches to target the web with Dioxus: - -- [Client-side rendering with dioxus-web](../getting_started/web.md) -- [Server-side rendering with dioxus-liveview](../getting_started/liveview.md) -- [Server-side static HTML generation with dioxus-ssr](../getting_started/ssr.md) - -## Summary of Existing Approaches - -Each approach has its tradeoffs: - -### Client-side rendering - -- With Client side rendering, you send the entire content of your application to the client, and then the client generates all of the HTML of the page dynamically. - -- This means that the page will be blank until the JavaScript bundle has loaded and the application has initialized. This can result in **slower first render times and makes the page less SEO-friendly**. - -> SEO stands for Search Engine Optimization. It refers to the practice of making your website more likely to appear in search engine results. Search engines like Google and Bing use web crawlers to index the content of websites. Most of these crawlers are not able to run JavaScript, so they will not be able to index the content of your page if it is rendered client-side. - -- Client-side rendered applications need to use **weakly typed requests to communicate with the server** - -> Client-side rendering is a good starting point for most applications. It is well supported and makes it easy to communicate with the client/browser APIs - -### Liveview - -- Liveview rendering communicates with the server over a WebSocket connection. It essentially moves all of the work that Client-side rendering does to the server. - -- This makes it **easy to communicate with the server, but more difficult to communicate with the client/browser APIS**. - -- Each interaction also requires a message to be sent to the server and back which can cause **issues with latency**. - -- Because Liveview uses a websocket to render, the page will be blank until the WebSocket connection has been established and the first renderer has been sent form the websocket. Just like with client side rendering, this can make the page **less SEO-friendly**. - -- Because the page is rendered on the server and the page is sent to the client piece by piece, you never need to send the entire application to the client. The initial load time can be faster than client-side rendering with large applications because Liveview only needs to send a constant small websocket script regardless of the size of the application. - -> Liveview is a good fit for applications that already need to communicate with the server frequently (like real time collaborative apps), but don't need to communicate with as many client/browser APIs - -### Server-side rendering - -- Server-side rendering generates all of the HTML of the page on the server before the page is sent to the client. This means that the page will be fully rendered when it is sent to the client. This results in a faster first render time and makes the page more SEO-friendly. However, it **only works for static pages**. - -> Server-side rendering is not a good fit for purely static sites like a blog - -## A New Approach - -Each of these approaches has its tradeoffs. What if we could combine the best parts of each approach? - -- **Fast initial render** time like SSR -- **Works well with SEO** like SSR -- **Type safe easy communication with the server** like Liveview -- **Access to the client/browser APIs** like Client-side rendering -- **Fast interactivity** like Client-side rendering - -We can achieve this by rendering the initial page on the server (SSR) and then taking over rendering on the client (Client-side rendering). Taking over rendering on the client is called **hydration**. - -Finally, we can use [server functions](server_functions.md) to communicate with the server in a type-safe way. - -This approach uses both the dioxus-web and dioxus-ssr crates. To integrate those two packages and `axum`, `warp`, or `salvo`, Dioxus provides the `dioxus-fullstack` crate. diff --git a/docs/guide/src/en/fullstack/server_functions.md b/docs/guide/src/en/fullstack/server_functions.md deleted file mode 100644 index 581aa382a..000000000 --- a/docs/guide/src/en/fullstack/server_functions.md +++ /dev/null @@ -1,31 +0,0 @@ -# Communicating with the server - -`dixous-server` provides server functions that allow you to call an automatically generated API on the server from the client as if it were a local function. - -To make a server function, simply add the `#[server(YourUniqueType)]` attribute to a function. The function must: - -- Be an async function -- Have arguments and a return type that both implement serialize and deserialize (with [serde](https://serde.rs/)). -- Return a `Result` with an error type of ServerFnError - -You must call `register` on the type you passed into the server macro in your main function before starting your server to tell Dioxus about the server function. - -Let's continue building on the app we made in the [getting started](./getting_started.md) guide. We will add a server function to our app that allows us to double the count on the server. - -First, add serde as a dependency: - -```shell -cargo add serde -``` - -Next, add the server function to your `main.rs`: - -```rust, no_run -{{#include ../../../examples/server_function.rs}} -``` - -Now, build your client-side bundle with `dx build --features web` and run your server with `cargo run --features ssr`. You should see a new button that multiplies the count by 2. - -## Conclusion - -That's it! You've created a full-stack Dioxus app. You can find more examples of full-stack apps and information about how to integrate with other frameworks and desktop renderers in the [dioxus-fullstack examples directory](https://github.com/DioxusLabs/dioxus/tree/master/packages/server/examples). diff --git a/docs/guide/src/en/getting_started/desktop.md b/docs/guide/src/en/getting_started/desktop.md deleted file mode 100644 index 42fe5c1a2..000000000 --- a/docs/guide/src/en/getting_started/desktop.md +++ /dev/null @@ -1,77 +0,0 @@ -# Desktop Overview - -Build a standalone native desktop app that looks and feels the same across operating systems. - -Apps built with Dioxus are typically <5mb in size and use existing system resources, so they won't hog extreme amounts of RAM or memory. - -Examples: - -- [File Explorer](https://github.com/DioxusLabs/example-projects/blob/master/file-explorer) -- [WiFi Scanner](https://github.com/DioxusLabs/example-projects/blob/master/wifi-scanner) - -[![File ExplorerExample](https://raw.githubusercontent.com/DioxusLabs/example-projects/master/file-explorer/image.png)](https://github.com/DioxusLabs/example-projects/tree/master/file-explorer) - -## Support - -The desktop is a powerful target for Dioxus but is currently limited in capability when compared to the Web platform. Currently, desktop apps are rendered with the platform's WebView library, but your Rust code is running natively on a native thread. This means that browser APIs are _not_ available, so rendering WebGL, Canvas, etc is not as easy as the Web. However, native system APIs _are_ accessible, so streaming, WebSockets, filesystem, etc are all viable APIs. In the future, we plan to move to a custom web renderer-based DOM renderer with WGPU integrations. - -Dioxus Desktop is built off [Tauri](https://tauri.app/). Right now there aren't any Dioxus abstractions over the menubar, handling, etc, so you'll want to leverage Tauri – mostly [Wry](http://github.com/tauri-apps/wry/) and [Tao](http://github.com/tauri-apps/tao)) directly. - -# Getting started - -## Platform-Specific Dependencies - -Dioxus desktop renders through a web view. Depending on your platform, you might need to install some dependancies. - -### Windows - -Windows Desktop apps depend on WebView2 – a library that should be installed in all modern Windows distributions. If you have Edge installed, then Dioxus will work fine. If you _don't_ have Webview2, [then you can install it through Microsoft](https://developer.microsoft.com/en-us/microsoft-edge/webview2/). MS provides 3 options: - -1. A tiny "evergreen" _bootstrapper_ that fetches an installer from Microsoft's CDN -2. A tiny _installer_ that fetches Webview2 from Microsoft's CDN -3. A statically linked version of Webview2 in your final binary for offline users - -For development purposes, use Option 1. - -### Linux - -Webview Linux apps require WebkitGtk. When distributing, this can be part of your dependency tree in your `.rpm` or `.deb`. However, likely, your users will already have WebkitGtk. - -```bash -sudo apt install libwebkit2gtk-4.1-dev libgtk-3-dev libayatana-appindicator3-dev -``` - -When using Debian/bullseye `libappindicator3-dev` is no longer available but replaced by `libayatana-appindicator3-dev`. - -```bash -# on Debian/bullseye use: -sudo apt install libwebkit2gtk-4.1-dev libgtk-3-dev libayatana-appindicator3-dev -``` - -If you run into issues, make sure you have all the basics installed, as outlined in the [Tauri docs](https://tauri.studio/v1/guides/getting-started/prerequisites#setting-up-linux). - -### MacOS - -Currently – everything for macOS is built right in! However, you might run into an issue if you're using nightly Rust due to some permissions issues in our Tao dependency (which have been resolved but not published). - -## Creating a Project - -Create a new crate: - -```shell -cargo new --bin demo -cd demo -``` - -Add Dioxus and the desktop renderer as dependencies (this will edit your `Cargo.toml`): - -```shell -cargo add dioxus -cargo add dioxus-desktop -``` - -Edit your `main.rs`: - -```rust, no_run -{{#include ../../../examples/hello_world_desktop.rs:all}} -``` diff --git a/docs/guide/src/en/getting_started/fullstack.md b/docs/guide/src/en/getting_started/fullstack.md deleted file mode 100644 index fa3ba67c2..000000000 --- a/docs/guide/src/en/getting_started/fullstack.md +++ /dev/null @@ -1 +0,0 @@ -# Fullstack diff --git a/docs/guide/src/en/getting_started/hot_reload.md b/docs/guide/src/en/getting_started/hot_reload.md deleted file mode 100644 index d207f361a..000000000 --- a/docs/guide/src/en/getting_started/hot_reload.md +++ /dev/null @@ -1,60 +0,0 @@ -# Setting Up Hot Reload - -1. Hot reloading allows much faster iteration times inside of rsx calls by interpreting them and streaming the edits. -2. It is useful when changing the styling/layout of a program, but will not help with changing the logic of a program. -3. Currently the cli only implements hot reloading for the web renderer. For TUI, desktop, and LiveView you can use the hot reload macro instead. - -# Web - -For the web renderer, you can use the dioxus cli to serve your application with hot reloading enabled. - -## Setup - -Install [dioxus-cli](https://github.com/DioxusLabs/cli). -Hot reloading is automatically enabled when using the web renderer on debug builds. - -## Usage - -1. Run: - -```bash -dx serve --hot-reload -``` - -2. Change some code within a rsx or render macro -3. Open your localhost in a browser -4. Save and watch the style change without recompiling - -# Desktop/Liveview/TUI/Server - -For desktop, LiveView, and tui, you can place the hot reload macro at the top of your main function to enable hot reloading. -Hot reloading is automatically enabled on debug builds. - -For more information about hot reloading on native platforms and configuration options see the [dioxus-hot-reload](https://crates.io/crates/dioxus-hot-reload) crate. - -## Setup - -Add the following to your main function: - -```rust, no_run -fn main() { - hot_reload_init!(); - // launch your application -} -``` - -## Usage - -1. Run: - -```bash -cargo run -``` - -2. Change some code within a rsx or render macro -3. Save and watch the style change without recompiling - -# Limitations - -1. The interpreter can only use expressions that existed on the last full recompile. If you introduce a new variable or expression to the rsx call, it will require a full recompile to capture the expression. -2. Components, Iterators, and some attributes can contain arbitrary rust code and will trigger a full recompile when changed. diff --git a/docs/guide/src/en/getting_started/index.md b/docs/guide/src/en/getting_started/index.md deleted file mode 100644 index fbf0b2d05..000000000 --- a/docs/guide/src/en/getting_started/index.md +++ /dev/null @@ -1,34 +0,0 @@ -# Getting Started - -This section will help you set up your Dioxus project! - -## Prerequisites - -### An Editor - -Dioxus integrates very well with the [Rust-Analyzer LSP plugin](https://rust-analyzer.github.io) which will provide appropriate syntax highlighting, code navigation, folding, and more. - -### Rust - -Head over to [https://rust-lang.org](http://rust-lang.org) and install the Rust compiler. - -We strongly recommend going through the [official Rust book](https://doc.rust-lang.org/book/ch01-00-getting-started.html) _completely_. However, we hope that a Dioxus app can serve as a great first Rust project. With Dioxus, you'll learn about: - -- Error handling -- Structs, Functions, Enums -- Closures -- Macros - -We've put a lot of care into making Dioxus syntax familiar and easy to understand, so you won't need deep knowledge of async, lifetimes, or smart pointers until you start building complex Dioxus apps. - - -## Setup Guides - -Dioxus supports multiple platforms. Choose the platform you want to target below to get platform-specific setup instructions: - -- [Web](web.md): runs in the browser through WebAssembly -- [Server Side Rendering](ssr.md): renders to HTML text on the server -- [Liveview](liveview.md): runs on the server, renders in the browser using WebSockets -- [Desktop](desktop.md): runs in a web view on desktop -- [Mobile](mobile.md): runs in a web view on mobile -- [Terminal UI](tui.md): renders text-based graphics in the terminal \ No newline at end of file diff --git a/docs/guide/src/en/getting_started/liveview.md b/docs/guide/src/en/getting_started/liveview.md deleted file mode 100644 index 56847cab5..000000000 --- a/docs/guide/src/en/getting_started/liveview.md +++ /dev/null @@ -1,62 +0,0 @@ -# Liveview - -Liveview allows apps to _run_ on the server and _render_ in the browser. It uses WebSockets to communicate between the server and the browser. - -Examples: - -- [Axum Example](https://github.com/DioxusLabs/dioxus/tree/master/packages/liveview/examples/axum.rs) -- [Salvo Example](https://github.com/DioxusLabs/dioxus/tree/master/packages/liveview/examples/salvo.rs) -- [Warp Example](https://github.com/DioxusLabs/dioxus/tree/master/packages/liveview/examples/warp.rs) - -## Support - -Liveview is currently limited in capability when compared to the Web platform. Liveview apps run on the server in a native thread. This means that browser APIs are not available, so rendering WebGL, Canvas, etc is not as easy as the Web. However, native system APIs are accessible, so streaming, WebSockets, filesystem, etc are all viable APIs. - -## Setup - -For this guide, we're going to show how to use Dioxus Liveview with [Axum](https://docs.rs/axum/latest/axum/). - -Make sure you have Rust and Cargo installed, and then create a new project: - -```shell -cargo new --bin demo -cd app -``` - -Add Dioxus and the liveview renderer with the Axum feature as dependencies: - -```shell -cargo add dioxus -cargo add dioxus-liveview --features axum -``` - -Next, add all the Axum dependencies. This will be different if you're using a different Web Framework - -``` -cargo add tokio --features full -cargo add axum -``` - -Your dependencies should look roughly like this: - -```toml -[dependencies] -axum = "0.4.5" -dioxus = { version = "*" } -dioxus-liveview = { version = "*", features = ["axum"] } -tokio = { version = "1.15.0", features = ["full"] } -``` - -Now, set up your Axum app to respond on an endpoint. - -```rust, no_run -{{#include ../../../examples/hello_world_liveview.rs:glue}} -``` - -And then add our app component: - -```rust, no_run -{{#include ../../../examples/hello_world_liveview.rs:app}} -``` - -And that's it! diff --git a/docs/guide/src/en/getting_started/mobile.md b/docs/guide/src/en/getting_started/mobile.md deleted file mode 100644 index 72d597f51..000000000 --- a/docs/guide/src/en/getting_started/mobile.md +++ /dev/null @@ -1,76 +0,0 @@ -# Mobile App - -Build a mobile app with Dioxus! - -Example: [Todo App](https://github.com/DioxusLabs/example-projects/blob/master/ios_demo) - -## Support - -Mobile is currently the least-supported renderer target for Dioxus. Mobile apps are rendered with either the platform's WebView or experimentally through [WGPU](https://github.com/DioxusLabs/blitz). WebView doesn't support animations, transparency, and native widgets. - -Mobile support is currently best suited for CRUD-style apps, ideally for internal teams who need to develop quickly but don't care much about animations or native widgets. - -This guide is primarily targeted at iOS apps, however, you can follow it while using the `android` guide in `cargo-mobile`. - -## Getting Set up - -Getting set up with mobile can be quite challenging. The tooling here isn't great (yet) and might take some hacking around to get things working. macOS M1 is broadly unexplored and might not work for you. - -We're going to be using `cargo-mobile` to build for mobile. First, install it: - -```shell -cargo install --git https://github.com/BrainiumLLC/cargo-mobile -``` - -And then initialize your app for the right platform. Use the `winit` template for now. Right now, there's no "Dioxus" template in cargo-mobile. - -```shell -cargo mobile init -``` - -We're going to completely clear out the `dependencies` it generates for us, swapping out `winit` with `dioxus-mobile`. - -```toml - -[package] -name = "dioxus-ios-demo" -version = "0.1.0" -authors = [] -edition = "2018" - - -# leave the `lib` declaration -[lib] -crate-type = ["staticlib", "cdylib", "rlib"] - - -# leave the binary it generates for us -[[bin]] -name = "dioxus-ios-demo-desktop" -path = "gen/bin/desktop.rs" - -# clear all the dependencies -[dependencies] -mobile-entry-point = "0.1.0" -dioxus = { version = "*"} -dioxus-desktop = { version = "*" } -simple_logger = "*" -``` - -Edit your `lib.rs`: - -```rust, no_run -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(app); -} - -fn app(cx: Scope) -> Element { - cx.render(rsx!{ - div { - "hello world!" - } - }) -} -``` diff --git a/docs/guide/src/en/getting_started/ssr.md b/docs/guide/src/en/getting_started/ssr.md deleted file mode 100644 index 080efbb6d..000000000 --- a/docs/guide/src/en/getting_started/ssr.md +++ /dev/null @@ -1,71 +0,0 @@ -# Server-Side Rendering - -For lower-level control over the rendering process, you can use the `dioxus-ssr` crate directly. This can be useful when integrating with a web framework that `dioxus-server` does not support, or pre-rendering pages. - -## Setup - -For this guide, we're going to show how to use Dioxus SSR with [Axum](https://docs.rs/axum/latest/axum/). - -Make sure you have Rust and Cargo installed, and then create a new project: - -```shell -cargo new --bin demo -cd demo -``` - -Add Dioxus and the ssr renderer as dependencies: - -```shell -cargo add dioxus -cargo add dioxus-ssr -``` - -Next, add all the Axum dependencies. This will be different if you're using a different Web Framework - -``` -cargo add tokio --features full -cargo add axum -``` - -Your dependencies should look roughly like this: - -```toml -[dependencies] -axum = "0.4.5" -dioxus = { version = "*" } -dioxus-ssr = { version = "*" } -tokio = { version = "1.15.0", features = ["full"] } -``` - -Now, set up your Axum app to respond on an endpoint. - -```rust, no_run -{{#include ../../../examples/hello_world_ssr.rs:main}} -``` - -And then add our endpoint. We can either render `rsx!` directly: - -```rust, no_run -{{#include ../../../examples/hello_world_ssr.rs:endpoint}} -``` - -Or we can render VirtualDoms. - -```rust, no_run -{{#include ../../../examples/hello_world_ssr.rs:second_endpoint}} -``` - -And then add our app component: - -```rust -{{#include ../../../examples/hello_world_ssr.rs:component}} -``` - -And that's it! - - -## Multithreaded Support - -The Dioxus VirtualDom, sadly, is not currently `Send`. Internally, we use quite a bit of interior mutability which is not thread-safe. -When working with web frameworks that require `Send`, it is possible to render a VirtualDom immediately to a String – but you cannot hold the VirtualDom across an await point. For retained-state SSR (essentially LiveView), you'll need to spawn a VirtualDom on its own thread and communicate with it via channels or create a pool of VirtualDoms. -You might notice that you cannot hold the VirtualDom across an await point. Because Dioxus is currently not ThreadSafe, it _must_ remain on the thread it started. We are working on loosening this requirement. diff --git a/docs/guide/src/en/getting_started/tui.md b/docs/guide/src/en/getting_started/tui.md deleted file mode 100644 index 504c01212..000000000 --- a/docs/guide/src/en/getting_started/tui.md +++ /dev/null @@ -1,46 +0,0 @@ -# Terminal UI - -You can build a text-based interface that will run in the terminal using Dioxus. - -![Hello World screenshot](https://github.com/DioxusLabs/rink/raw/master/examples/example.png) - -> Note: this book was written with HTML-based platforms in mind. You might be able to follow along with TUI, but you'll have to adapt a bit. - -## Support - -TUI support is currently quite experimental. But, if you're willing to venture into the realm of the unknown, this guide will get you started. - -- It uses flexbox for the layout -- It only supports a subset of the attributes and elements -- Regular widgets will not work in the tui render, but the tui renderer has its own widget components that start with a capital letter. See the [widgets example](https://github.com/DioxusLabs/dioxus/blob/master/packages/dioxus-tui/examples/widgets.rs) -- 1px is one character line height. Your regular CSS px does not translate -- If your app panics, your terminal is wrecked. This will be fixed eventually - -## Getting Set up - -Start by making a new package and adding Dioxus and the TUI renderer as dependancies. - -```shell -cargo new --bin demo -cd demo -cargo add dioxus -cargo add dioxus-tui -``` - -Then, edit your `main.rs` with the basic template. - -```rust, no_run -{{#include ../../../examples/hello_world_tui.rs}} -``` - -To run our app: - -```shell -cargo run -``` - -Press "ctrl-c" to close the app. To switch from "ctrl-c" to just "q" to quit you can launch the app with a configuration to disable the default quit and use the root TuiContext to quit on your own. - -```rust, no_run -{{#include ../../../examples/hello_world_tui_no_ctrl_c.rs}} -``` diff --git a/docs/guide/src/en/getting_started/web.md b/docs/guide/src/en/getting_started/web.md deleted file mode 100644 index 07139cce6..000000000 --- a/docs/guide/src/en/getting_started/web.md +++ /dev/null @@ -1,63 +0,0 @@ -# Web - -Build single-page applications that run in the browser with Dioxus. To run on the Web, your app must be compiled to WebAssembly and depend on the `dioxus` and `dioxus-web` crates. - -A build of Dioxus for the web will be roughly equivalent to the size of a React build (70kb vs 65kb) but it will load significantly faster because [WebAssembly can be compiled as it is streamed](https://hacks.mozilla.org/2018/01/making-webassembly-even-faster-firefoxs-new-streaming-and-tiering-compiler/). - -Examples: - -- [TodoMVC](https://github.com/DioxusLabs/example-projects/tree/master/todomvc) -- [ECommerce](https://github.com/DioxusLabs/example-projects/tree/master/ecommerce-site) - -[![TodoMVC example](https://github.com/DioxusLabs/example-projects/raw/master/todomvc/example.png)](https://github.com/DioxusLabs/example-projects/blob/master/todomvc) - -> Note: Because of the limitations of Wasm, [not every crate will work](https://rustwasm.github.io/docs/book/reference/which-crates-work-with-wasm.html) with your web apps, so you'll need to make sure that your crates work without native system calls (timers, IO, etc). - -## Support - -The Web is the best-supported target platform for Dioxus. - -- Because your app will be compiled to WASM you have access to browser APIs through [wasm-bindgen](https://rustwasm.github.io/docs/wasm-bindgen/introduction.html). -- Dioxus provides hydration to resume apps that are rendered on the server. See the [fullstack](fullstack.md) getting started guide for more information. - -## Tooling - -To develop your Dioxus app for the web, you'll need a tool to build and serve your assets. We recommend using [dioxus-cli](https://github.com/DioxusLabs/dioxus/tree/master/packages/cli) which includes a build system, Wasm optimization, a dev server, and support hot reloading: - -```shell -cargo install dioxus-cli --locked -``` - -Make sure the `wasm32-unknown-unknown` target for rust is installed: - -```shell -rustup target add wasm32-unknown-unknown -``` - -## Creating a Project - -Create a new crate: - -```shell -cargo new --bin demo -cd demo -``` - -Add Dioxus and the web renderer as dependencies (this will edit your `Cargo.toml`): - -```bash -cargo add dioxus -cargo add dioxus-web -``` - -Edit your `main.rs`: - -```rust, no_run -{{#include ../../../examples/hello_world_web.rs}} -``` - -And to serve our app: - -```bash -dx serve -``` diff --git a/docs/guide/src/en/images/compiletimecorrect.png b/docs/guide/src/en/images/compiletimecorrect.png deleted file mode 100644 index 8fab7509fe6321c957b25b77ee2927cd3c24d787..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 196054 zcmeEscT`i`^Ka-NA}S&RQWOyc>Ai#^A{~_8i%1PkAoMCtML?w}9i;c(A%G|#E!2cw zL~4N0LVytR;=T8KzxVz0{`uB=>#diyPR>4O&Tg}3W`Aa8zj~~xM0J7T0ssJ@Qc-@W z4FHf>0susPtCIjVu%t| zdGw!W@0%&hf!g;l%t7dRStt-4OzMsFCkx4V%@iMSwt>kAKHF^@30 zl^pO?e0)Ze`+ZT>ji+o97cYM|a!f1f?4J-f32UI9yu;ys%Y`sRefeOe39w!-4=gc! zOX=&$BEQ8;tC|Z~rkq-_m62ix1z!pUsJ^>6c$u~~!!EZc zl8b=J0C}$yNA5BBkDF#Kem*6*`(@`rkk7?0tCy8jDZf9hJKegea)iPycSx z?)TcpV&$}(WkuBWCLJs<7l^-;zDtM~>}At_6UQ{5$ax`d_(yDAbndd$oNRBLMT5I zP;y%Jlj_JZzpeEa^Xjrld8gb#=KhxQVTVQuecC%w{@W4IJC6y^LzIcHDI9zzeWaLm zV^j8$gNT;cTOod9X?`{q>Bz>*UqT3vO(gi$B!BSGO21(ECfiDBSxQn_)N@|6ET>Vb zpL6qv%?6e6RkoK)U+kaW8KD>J3fq&DzAmF+b?{}X5ocMOxlIvA!4ysw4kD&qf<03y zIx8{kCZzolH*TATwdrmo`f=FVwaeOjDf#(b7t&cb*Y&8dC^@Li;BEY z#po2!Hs{W@1i?2~RiB^w<(Eg7LoY`+f3kon(SVK~>oqB`Szy+Jp4i>mvWC=uxo$;P zH8x4Hb>E8^M0|fs92RcY5nH@B%-|?~;{(zv`$Qe_V(V7oEhyo69+JKUU4HlyEqi4 zw#d*(1=r&6A@%D34M(w(Q)IJU{Bo`8!PXUnFEmzcoyx>lqwn0_P`>^?TKNjQAf-`= zE-UvtRIh&S^%DY#H)(Q1x0!l*e#neQoJF)M2_!@^WM3~NlDuG(b5od9;}OTFrghy~ zVzZaLiY3Dgp48JJ8FJ7Z_+#4Bi`!oT`C$SApaCjtYt#G8{T=T75~5_>JzP}`rOcp6 z+y?i@3yALdrH5&uHEv>!kvV(UOhdH3t}UwVqK7SVgmXEdRj{2Yx}3CX2D z`#j*aV#t2;SY=XP{Gm9Bw+_dW$UEg{SD9V~xryb|9J~~IrS_8X73L++mrLIjp7OnV zD9GOQ{)O`19hst+x{r*NrWGVLo7Fe(w6P=Jmi1=*Pv!X_Y))f!)4vkM$PJyQ; zW|2F}W*Oy=y~|zdT*7v2=GOeK0sVoo^LN^=wyCy-`O%@8QTI+Sotg$h&TnEJv0bNP zhyGMINSR6ZNFzwqE_yMhiTF4w3wrXu;lIYfD?DrKGrD_=$a+$+@gjjWfwk1~wVbh+ z_CM^u2=xgS^G}1uUB<1Q?6;iL9Hr+Pr;iJ(UcVAx`Y3Hn;6Z-?IFLNR@<&^xS$(pK zj+&ruk=}~=<`(~$=ABB@H<@_QU8IIl{+0Zbd~S6{4P?raEwAnJKz_2bpp*>^IBV~- z=+?QrzeE;^bBs-C`N)w16<)9n>THF79=+Z7z_x1Wd#+*w`gPWWo_OU5J}SEb_8aH$WQ2euQDv zu7cwO=J4sr3ku%hGE3qf`{MrM(5~68A68MH=iP`JYnphL41IKce0}`Gtsbg=IeqE> zPV`;VJMcT;6PYJMImVwTMg&H9&mzj8Bh?IV?GFkLfNe#bg4{1DcJR@3h?uOL&)3#g^m!;7hm& zjigYZV8396mS>uH;P)vN+xQE2nbJ$el4VaUuixV40eQp7f~4Cc7g7iN=ikn;Ena|K z$e>V&D2Xup#5$rn5}%fpmMEd+5$0~N;`K`5OX7DI3WI9%{o8z!t{(HLXUAvhCs+~( z63m5f5k?VFd6A<54l~#K?~N6B_L|z*2u_TL6oK-OdaZv*U3>ZT)2E_da^`tH&h&%@ zP9z-}odI2YdXnV!qG#B~=mwo_#wLFH>v{V zb@shaq&A2#o2X2wYYsq_h{VIw$_~qCTa%jgoAmW)O(trGT;}${EU;*}MaiX-`G(Gb zuJ2T?q8G%>=dU#v1=W0AeLaY5P_CbyWvHvm?#|A4XMAq5SKl+E(~xCn{%5DJJvfTlhjAtXxzC1j2ce; z<)%HbSH=*RgN5YV&S-RWA6Eud+!R3!RLyzfJAT9SzRND z39eJV(E83-0j%S5uu=BHgfEEaybgKPDitoZ;*CP;&kMC19Hbt&Vss(JIp{8=h0oi= z#Uq8zF1xsEaWbB~0qVh~Cto&IwsoKdO3k-hc(F1|=pnmmyTCb{;2UREOHE@3EVzr< zg9p&#j3K&xI&3hHufwVP8aL9Qtc{`#ZB7T-@z*(r9d4I4= z#SLaYm6_Y%+d_WWTR98O0gy7L#1nN`ND*We5Op*XL#b(my&(kh!su}V;&U3ADnGS*SH4U!M-<_BKd8__@!j%D(bA_*M(QQ!V4NByKzR@lkbp*` zowtxUa%ABo55PFzaVN#`*5{Va>nJn2S!0ps%*U$2=wUwhvu3hQ^43l`wjI##_9`F^ zS#gf{I$qlts@Q610J!jFasV*_1AqiyBEVlV1dM-|9}#c@i2is_2mnMm0EqwkMiYPk z`Fo4Me%AT(PV_z!K!$(1iobla2>xp|#}|_L^3T_Nw^{%A#1jO(ZK&~>Rl(KWhE;@Dn3w;y%mr3f zR%!QVwvyTpAN^Gw{{*~k@9F6#$;apI?ak{g#OvyA$0r~mA;HHl$R{Ysga3lZ!`H>r z%7@3rgYC~o{?pDw8xL!D2RBa#R~Ocw?OHu`1$zQ--~QRr-@iY{Y2)MY-=17N{+bqk zf_y(Id;+}ue1Er%uPXiXt>j||9~&pbhYrqop5gnD5fBm+mHwl`FQor=`Dax<4;yy{ zS7&@pPnrL6{jbXZB>vBefAnee-##V8`2X4EKPZ3Il;-<6^?$J9Pd@+g7SCvz3(|al zFPhASf_JlZ_;tML@K8$^f5%JN&mX}G{*Uv|JHAX1!T7f0^$Y+Y2T*w^uj@mwHAmr- zu#$a_lR|{cU42P$he58sm-pJWXAX*E9uFmCAD4XP(&ovd{otsEn0L%GE-B;57-jxa z=9uRa(N0-Ql|}Nzm{aO@$y-*-r>qndD&$MJf%Bnfcl)2c|F)m*VfJG#WBXtzw?_&p z?W&7r20{zXT0bSeowk@F^5-4`W>gbR*ZO|YY(dX#KneCXjK>-Zkn5_laBHPFL@O_S zGZ)(gI&I3NJ-DX4(6j%`##~01aB~f|T4y>?T&p4>(E+3pbM=#RGk00$BX3lp8zs6?zYLY9mgIibU$xgK43L!&Zp-DCrp_@33M-?)N05aS-`v-rG; zq@FJ&?^|4Hjjq_EXffVVaXN)>-320^(+~Pjffw2# z#;xF@?kT?UTi9H*jq#R2BC;Iq2WrFG@r?G7^@#J%?IJ+nl{2lIGZ{hpB?MLt|Zvd|_&yL$ndF+m>?N6#%bH$IfMr-Ite9-N#F zTx!DZ2AnInE=UAHk+gM(NLf3~(it|>CCJ;w4ZGvHFjp6+K5?iB!)dr@E^!c&vxWfv z{9{sLEgmGR6i81PFDn@Ow!@Nm~foNLX$-N;TOg+Ety-JU8pDF)IW>$7~G-&RuxNQ}|~KJGJ``{~xO z_^Zu%*djK3YbF-1^h$8olR9VQOQI(RkUx6$cit#+b7MB&`5H878aS?eDyZutt`zn7 zl4O{d2!#}H+hmNYwtIz&N(+p5WG&_xfHBy1Smgc{zr`X8$5qAh-3imGtyq=Q`Oyc^ zx}zAiRh|h-p;O5?J>*yeMq@%1O^a1OZXBhTnWkRhX){?y`alC=dmhtgD=D%Qv@Z;p zN5?!??a!4)6BkZ0TyUK$oAijbR@gCSa6B^6V`U&tt?p>9q4r1FgruSVZ7_58M#JEE z?YsF9AhJ$^0k=Fcf1#_A76SOpSIKKw;EO&p=0>Y2aF}H$izWLvpYfV)P^@>+bQn@N zNyLHBH6L0oB|5GkGskIMgFZ3m+}-SUH7l%>P0x!kDP>QoWJ)YFTcb({{$d;)^R*d0 z*5tWf^J8}8SG#jv20108?smA00hLB z|M*+CCv+AMiP3Xx-`gBxn@48o-3wmRr@cmdFJLdjf~L$x>`~KNMunBFmxF=@3~7Z&DpsP&fE@2)OYbU#PY~nR}$6{ zDq|wBF7VF8nlRcTaKI9KmoU^dDIa{@q>QkfDAcxR^HbAwn@>L5Y@J2@eyGanks5^H zE4$XmkRxLQIne45fR%(lQS}xyd|ZRGe27&c+@KH+?6WR!atLU#5J^A`zhoW|2UG75CV@lI-w}T z?&8-3v>@S*S6LyVdYfQevMguh2|D=n;z3WZ@4W1zX(f9s)24sLl)~TZBbT*IUb_U) zSKag|sus#&@iSI@g-}4<>BdnIC=KDEe_Rkb6wx!zi-U zx}kCXZ3Z9Lu(eehcGIEYV8!?hoe45c3d|^8v9YxVK8HUwgDlEW2^6Tx2&!FHN1MFp zAeLiE0l+17#T5&5_*Pw$0LzF zs&*^+q}e)Xdm(fOBrU6Ob|wtL?gpJREOPoTuUPl#<(D2#~@xH&Sfkiu$OWfVbb$jM{jzXaLEUk)(`&H zbg#IyRChi@!}w$b@`yZqSvxiIhiS1@^1WE2vaeBM4n{j1K_EzEPP!a;((~Im_qfoM zZMQ{fS&4x?#;RX^N=`8#HW^~^>~wx%%G;lb%==so)Nnl1i@G=Z+WXW(_(=}NE*bN< z=zCXY?P8$Yr(9~595pBs;fQ-Hb7r4@fsh!z#9ABd0QTH|_w05L1p)s_Dgcs;Su6#Pr%HG z%k^c&|EQ&LS%)HeWAQt}bWW&$MV+OLOxCfkEzkNNOH=z1K;RVpWb88G_7hf(xck0F zA3RHhgYSO+B(o~%1IV`W)YxzhiIOBQ2Ng&f6^ZomGKN4F$!(u63K`sCL3%RZ-3wtvN zo=%c~%-{1O0pVoq^Gtg7fAsVZ`a`)8fGFX*@T%o(^Z=jQ({0p6!nB0;rL^J+>^!nH1umGMc)g5S?@O%1Y0{q;_ zv&QcHero@3Pd(I&rsGi$SU-(Rk0u#K%3pZmzsTaxQU~|2AK_%9uFVmB zeoee}-myK?Y^^HE3KjViYn_Ct;MyV0n4{P}h@QK0=GJU>r0$Z*Tj0O6#VSo$hF^6( z?YLWgJMcNXhbJcb8|$xrwl7T8YMCpENvPdPaDcbNiw_e}H)ejncp-BA?AKp`Wp-iQdPQUr{$ova#=PE|>F# zXl!^Co!Uvl15xdw-_rWM(miy&JWE8kfTLG4YD0goSL8m#x371oR;hm5D%$)^#3iM- zy#DyXsv*_J7+xPG6$87?3w4!>w4HIs)_US4ZwI#EOSVU#G`p8aRPCUEp{lTdX;(N- zj+kh2n#j=ykXjsStt7z$(W|#$6hpp~3I;=ic%Tb8pTZ%1sx{E}JYz#(ke*kwSL#jq z|5(&N(dgeSNKwmjCan~>8^W}F(Nc?PF5B6kT7t+Bx&>$0K1Gwg-a(0=kn(^TQ&;BA zzpe8B)<$SE$@DV-WBQ~8o6_O)H>FOv_SyrtDr>24#N|^)dy+P=fVroz0O#E|)6FsB z(f=~5@H@jtM3Y2}wFi&i8DZ*Lj4-Hxnj=umk&9vWa^md}stq3bTfY}q@(*$|7cE;p z(pPqw30ayEl=>f)47?|1#9v2rLY7@9(QM{_si~NyL0VZ|N>K92Y`U>Pea%c<`_&^$ zTx4)z??6yp`}?1gW?)xi!~7Y=cW}AfvB&EC-xz89@FycjR&SYFr&BL!F9mJ$AONVPW=PDHp^MQgwyx043^=RmGb=cIUG;Aq6^{PN7Ai$}(1&7+ID0=tqsolK8t3a9!#Yvi(wNQ?~tGuEY%hidK@j~DZ4xeBfO9M${qS~fZsW^IPi zdu{vRsLbL(;wK$J`W)i*O*y=7Cn#R2+z0)Zd> z?7F48%^JN+F7y>&qh(i2eO11~t|;kTz6X&kfj2%^^=9IfsnqjTq6BZMr!{BzXP+Lr z!Po+`omrgq^R$dyd7N(jV?X+*bPclq?D4K%SI--5)38VSIc5m`!g1U!|9+1VPL=yXILRp#22M!s+{`F6Ub{>=cpnxMYFE{rSBzeK zqKeoukT=Tq+MX;N)d}jE`n{GA5F0DAx)V5kB)eg)rk%E&Y`U5$#G&`3Go`}nZocI2 z7r{PPu7$#qQNo2+>EG1X48MC%y>j>$vScwH8!5FNykY#kpr!o(>i>7MPQKe2p_hZ` z8CTXjr%My)d3xAaZLfEl`E-Ge-|~mU%AstIYH+*H#$vPK3iF|9-#^jje-u!T>?cM8 zh&2f)+;p=}hRvE@%T*RzF`ZR32}@hqrEfby2WaqHfwJH*gX)9>b=@qToB!~O{}wI# z0z%@-?ZfU!$x;G%0%)+zf|S=hE#FEcCZTIl#=VdBTfVe--B4EA~JFC(~j<%*C;(Z&lg>wU=Cs^Iq&bW)8uc#>V%- z`twPen&Z`Fl)`t6rgukgnw@kw+O1&*VfBd(+(vnRds6X-mM)8lrey^8L#@V;{@y}4 zJ|&<>0vQ_UT+(0FGpmfE_60yxUj-P+*<#_%(sIUA;(7Q`fp9WE3GGn7jeM4pg|hY^ z=Gqn@*kUgS)ZjjcMWM1djOB{?;qHSO2jZ_4;WoE?2#yS737 zqSo)cpfylWo{83~<=Wj!kANC{%$SIdJ^8U`4TYjBIm2sFAb)K#z^hFtgvY4hNtbP1 z6@BH>cJLT*29Ajz`OWUZq`~@>pp*v{K*h9f>Xqe&vt402fAAdG?PxDcb2Y^P5B+rd z8!8x`#|FrdV}(Cd*{Rb$sYOarQR=tnq16E(q5if@jawIDRK@xUKf?(`0rdGl;Y2#L7D^caA5%)Y(KZ{^ZB z;R<|GtHtQPFma}2KEaIsnvuD*)n1_8^T<8}0b}m8R0v`79I0 zsMRqa%$Z|)>rx==Gz($nZ5sz4HVt$zq|$3Z`(W}ZoDlV`n$l3l`g4Di=dKYyHh2fL zeieK`s3_m%PC$LV*)rke?uQC9>lq1mOn*PBjS~8#+T(pma-eb1`}bV_n$GzhcTbr4 z#ClZ!aBas^s2H>@Kl&zK=gTPDNwlpm@;!sUJs350vt8XRI9dHzq9d9L>BUCm%WC_t zmTly&1~;0IRkyDCG8%xoNEV4MumdmW(3>3o^;xdT3Li`>2!3a4({l7UZ>OU;SM z9M;{emnBUQx1L#Tv==yJ#=MmdbhIS<)mq49@lamws9$L@C_y^dVkh)sQ3h(FGDX>A z=APywzWMdr9}(oNWz?(1db2m}{VeUrC>i01tC;(+N2LTaxLCXh4Z6{G;&$yx0ndiC&_KRChoiFvN83%w znD$$f7ft=mvQY~KLP_cQ{>EI^G`}0^AO(J;O(yzEQ9>HSr&U7sJiURsIgo?m<)<^_ z1p`~dH+znzEwm;MPcSd^M-MwHD=0!gNV0s^YZ{W?1?dly1^G%XNnya-Z257~XBeL* z8R^|dziG<<1o2%-Qcm`bfr2A-M`bo!Noov@^s2ZpgE>#=BG`lUcOydm)YlX;I9qztR%b`4GYqY~+p+R)`uwz)PqxB1MWgUy3jq`|;H$;x40L-3e8w{|hBrzyNo4N6J?o_{KgK3b+ZFj7mq3VttK>1h5yLpiV!SP6 zO7yt!yRl6C9LuT6`0gcRg+kRijB;jK@*aETO}|z86;|*rEHt#^JwK7l&npy z-LGp9b{+AjBDYppZ*M6A$foYlXK7#h9qg>7$Hyx~JxVr__PET}(!_=gS6*Rxge6UF zl0?6cZLFxJ1}vW}@)q&OWZTu9o}uIxRNQEg;x>KdkbBr+@Am@XgHIlW20CViU(x0{ znXRiA^NB33J-`te{1Bh^gi3O)UHc76l`ElR4RJ;_6hbZ?P2d8Lt9h%SXX^C>3}w7} zDor&`)e<|ti658QQ-z(+(n2f_T>s$323?2#^_!z~@^GrkdtddlIL_CM+irN?bxp}1 zY}Aa$`G4xR5Lf;NE2_1T|Ew>iCs#2J5L|(Qu{=jPAaeq$o(e>T&xAfEq zzJqf2(il*C))(nqP$7cArj9av7&o2h6DvG7rbEm4yPeSaF&;@!%?mH^&Io(V2X0n) z2zx|g;a<;v+SsuG9hgIWa}HrGWEfZpJ3~cMC)f(y{J(f zt6p-K2Ku78nBD*84F4sg#_e*53zq(GCf)`ORqp=uoj5BT5-cCk^otc&>3i?p;F+mY zR#1OwRK2G{!w*^CvRYNIfoz)gY(c5w)JGGeH;r+^H-8TAue|6ipk#^Zag z^>FU;WdbLD`dGGK{Us)apT3E1>DBlauHtU`>I?}s_Izp`>Ez+KyZ3 z>U<_RROuxjjFl(5*zO;J)6DjlRhqj_S<8Zi>a12w4W_iq0?|A?zM#5GNr}qoO7^GD zLL$z&=uT7Lioua%mI|+iA84U3=a`A_^Ulo$EqDJJX#RWtwThv=B$Wb13^KL}-x+fM z^bikgSH9;bHRw(-i#qFMj_#aD#AZ7kqw1R7&pBeZpHoBfzt)f@Z)*bszlj5_^zRlT zXk$D012?;-`4@=G`mr|YtR3UGTTgqlDN+GIw_0@2K=PE&hgsHUHEbF|uS6%l)aG@@>) zC))_MV}Tu}$%lqbZsNmMGnCEGhaS)pb8ZK7j-O-TV}XuM_4BB_<=xY@YR|8k0|_qX zzf)SKM?YmP>XwTMQ5|WeWI}n=`Sr5$qstS-D?RA18`S*_bgW11_MaZ1q3;LphdvHC zrs3(w-dXHwKTCANk~-`c%Bxl-zfb%+-E0+6k1X>)A+}=@rD|H&rb1*soff9#`&j*F z@?*U1s4N(>gY7=T6@!XB%?<1};uD{23hd^(FdJ;)y$OW=%0E-~|G~M>e+H$8+FXW} z0|^arR||9!Jsj+uQL;l2wZ%8{X74IS1VZJ>Es0v(uKl_v*+YMNNhdpz{PhH4Nua^O zp^5=GSJ3zS8Xw;m&edtUb=-4%L>|zO`ArOH-3Q+W6EXuX^?hd}l<%Hs zbb;uzDQ7ml zuELY0AWavkeow#6EeBvU3O4?IG$PdNKHfo#b>&s~o%bjQ2<^Rax#JNm6ZSg^zbu!< z^m8v?PVFE5okhJY$6Ae_+dEVN`1ez@|Nm3}Kf3C;`Y}Jx(x=u$-VM#glDn^9Zo>12 zEuGjxeXw2_Uu;K26@v!~Z}ZnE+8~Qm+aP<39Ge|8%Lv;h?-8TsRm|A9j#BNjCv2zm z1W!_a0~=CI@Oybv#Eb%V4~yy|%P%n*uF^$Jo~Ik1A4yF=ne_WSIVtmD!%i&b(llZk ze@1G;;#^;<50puPcy~+;R(YxS^%YHVxr6#3MT!^HG)C1)U6w|8WvGcEo}o0|FsLZrK@_386))w30M` zIFHV_t~vI+do8IZy!ot^Vw|~>%n{XAjOrB9;u5O>hgVV%<*%R9vuz@3R{|m^EHj-} z0WjiE9vZBUJ9=MN#SWvzyp5+TT=5AIfzEsiXAS=xb$=A3&)adyb^furf*p*sWVqEL z$bO!0j@&Yg;`z;AR8jIRUQ7KOr!wfH<~wz7PUW{lY^a}V`A|nTuTYHV1~%~_P#QfG z-va8|o12ZRC>$8T8#WBV<^~4anGQ<|eB2dJgrpR<4Fgx6PVkhKcvHOCyuePCnV;%D zBtpWSfH|X_)^>zsAdB*iNg{fH{)073m!4=CLYAn2klGU>L#@RYTp&+?N9wbkbS&*m zQAu@F%y4)WQQ{)A(>Fih`44xRbkU_1-*(}y!<@k-G&JKPl!!Na*(T3WJ`*6rLV_eePq_L+yQ(s`pSk56`i>Z$uIZMBOyRR%NTd1-)7G zR6|@GdSC2uj}tV!oPINLa7Iy>%0#;qQz#;H)|TM zI4Ailiy|xcX^IP%%}t7}e&Y<1m*BZ(D8Z(i%&~i6J_tO*%wy4Pia2VCA6bOMB&~~r z`%Bs<5ShduS(2rV(a^R5f%sAX82>?ShaQWd5`zXz(m`Z4tm52+uuBULvgjkHg6=O5@HSAM-&Slh( zs@?DP>0M(kq12xG)Tzc`BkN=b#y5^Oi;J>@g z=l?6}kSoOR9oc<#`R*AVB?ReQC+htRX64kfMgF1%S{g~GZA-;aTJ33K>{e_vlf@d^ ze3=T@+S9s17?m9gzhA~#@%X_fvBlDJ&nD&|o3@5(QWp}JG3~~AvRD-snFBQ*bg9S8 zL}`^@s&~x9CXJ-&ZJT_*Fj!zeu5b;0y%-rBXdNvrHB;@_oaDorXb)HJ8%bn&Ye&^YAwNR#)Ci8rqs*`b;c?I-jZe+WG zI=h(?!cMkzz>faa1)&3x&Vj6Y$mYe&GP>&Dn6Yppe7bQU>q=31Xy^y6g}#HjvqAP# zw+8U$Cn)ValNy%M{4_6V>nONazqEV7vw#<2O|4wEWX74D((tB@h(kt1h~2_0$NI>P zuc_U3Ai3PB$EmM7{OwUnTE!{hvLW53<<)MC? z5@is?FlyWGz0$|zcAc9-!RWSjLuke9vJL^^{phN!e3uSh-WKHvQ0fSxUS zvg)&JXVdJ=Amrtp>}T6C-I8SW;7}symY-*mi{JXpCP=no+4y{b@{}Jc5#NL~C`d(l zVx)$S!;6y8(bykVgZ*{86$tR>*{;cQEO@YVgJH{$bFz6Yb6g6uEjS+}DjlLRY~wvN z;R7F~XmO`QOa$*de>P1)&*r(jbN*R|W}d~h!=;Iv=0Tl|!lFU?`7KV?-8;Pa%rZ<617~{S*R~}Tyq28Y zp0t-d*tyWE1E&(G2`uZsZaB|3v5MWLgkn1NU{{U(73^JQ=bTMU_K&&*z521mljpHP zdml7lw{7*04CjKCV%cuGw${1oZT%+Nk&TCQkzDYUJ|n`4ZgBrq+X=nOY*cD;Hf3;= zp>IYMQ^e(BBije07YC(pSrK7&#L7eDGcXJX;3Lc+d}{l^$D7BZ6iscwJrp>^e2?SO zgvNqr5bXlZ)w`F*vFL!VC*6>Y4#*%2Xf6pT>BDKkK?t-jhV1!HQ`RmWISowC*)Ux0 zxSI;_D;Em!isQq6-e|Ud9hd})aJMin4VgJ>#uSs&wsf?3?u$?mm0Y zy6FE6=YI4nat*b`Cs&+F$FEn6UiA^Fb;c+(%?qeqcIx#A5`YZ3!%j8Uy*|x05z9Nd z(;4jAs~WhDcF6|!h#X9qnUH522NL8J@FjIX=S+!$NH6Z2u3RP67{kJ;oaJ~Rhy>fz zIy1ZDifu>7B3_A4VD2Q)$)hzv(xKOFcVnnY=4=>$YRIXAaz%`HK-gedS2^YJB7g8* zwM=PrZ}ZIvBx*{>b?oAS+kMRb#kkZJdQHO}e+8n+aCw~pEQ1x7C}@312(<3^BG}br z$BV&ryDW_7S8$zm4{tj)MnF6^z)%A$Q?YopPH>=qlUE~bue3e9>9aO2@J zbt2}LT7GUwI7y?l58l#UWU!V}OI-+xG^ag5qQzh*}Il?_N z;HgLfMP#+Xc-HxCc<1a9TF$lB^n6WGFjT*Q=q1FZ0X;)D2uGu%Oe zd2=RO=_Y$-vZg`C_HYd`r5b_=~ugO_)KO6EopbG(njN9C?~Y1mQ}xe#4;*<81TbaT zL}paX2Jal2z32>YiyOb--*%UFW`UnNcAxTNn;BK*O1;BRqwr=w@~iFLos4Nzx7|iF zOOQzzO?rV>+ksNsA)nppO;Go)P|uCrz<#=olR8+zo8*=SyINkxjO@*L+q2+>XY&NB zD@{taGgnt7L1H*Rn2U(h-DkK6wrA*O;%e$+^H(wk9?Z@1$+53x$391y>zl_E(Dq|W zGIpm-!hfSZtXp`gvEqo4i%3ci*@49co>nEbVjxFM=pc>x!157Uo>1d$0Bpc+E8g0+ zIu@*-iiR);*v1sR>Rd=GK}1fnfNTg`(F?;R$kexjw=~u)q!q`yQx-?}s!3lbbyVir zb)-Pv2x8M$H<49?O@0njezYHTt7aq=M7B@wZ6e6;wP6QapCzrDrY+t0x)irC;?b`` z?(m>vvYZG!SL(_+6Am4+iC*}Hqt!kLnp(_` zCp9*!cAh%6(iMib;nioo*IHFXmY)c%Rq zrUG1jxx3vUcc3C@=6>qp4(_?L&q7f9Q}EH-Du(&76G)BsEBZ<=l3$}smnrZrn{r`P z+aPcAR?7nXV@>W0Z0g}rwdqP?c-0lP4o1$9x`x9#32M%sWCh2$1Fg+;Y%J%{z}tZl z?2enL{fE-fPu_Q*;jL46r?;#nZn~*XefTvfz0iZS6uY^8anQ#y31l{7{FRAp-`!&P zbMUH^R*F%L$3Usk+I{u4Y{&S#WK|#1VHv{$Ru#j zA=FFN7e$;)ciP!{1QRYTMMzk}dA`YylZj+UfT#4=ZqEjF9GN(Ve#MyfzQER&@3x1WuDZ;|Uk6!BcpIGG8@Ro;-4vD(e_!H@Iv_bzZ^fITwCkiO6@A z;3*}RnH83hbniC@#e{Y76U^2&jgtF9a@BKCYt7Nesm>^9=|hZp(5>%tu925K8BeIN zyM3VgsGWQGQ7J*W^xNG2%-uO>Mf=8pWWJh@M|vWHYYw{DIbvX=vNY6V?vL3 z@BvE*k}v090+!@I1D2OF^M8eXKSd=g@MpjhiRoYeRr`L@Szq8y|CKKV4!>fmpTn_V zz>~Kz=Ys!o`0HgBez}SF92kBP%RjoCZorck; z*ru!uW^c)|*}TjW_&IaRZktcw6X?odproB+qRR?VdMMWrw95msU!wb=}2xn^u9FbdU_?2_Cp7%!C8s zP^S|!ABcVX$osjO-GfPryWw+YT2*eD=P-pH)cDuD4995dyv+rv<-;i1ZjeS`jSnzy z^6#Y2e@BqDiI?(kP5Pedfa#myUn&aIJA+CvjO$wjC)pA4x3n+<|l z!^?V#e6`SK+F9Q$o)0phK#mK@n%b?sq|B<5NgVC^>Vaus@n${(R}$@xJ-r?P53fY} zC`_u>-0TcV{jNvfDmMw8-Pg@#W^mAoUPkRK13eF_E5+m^e&Y^@5gTg(7(Wyb$aHyn zxtD%Z{{(g$rRL?vm&(OW=%l}=Ma*4oSWGH-tqw4;P1(%taZw+0rLKQi^1H*?ka(t+rVD%5)7tsw!Y60BP>{i^*h^r%!?O>O|5w`rrs+oBbjDuRGx9M@P>h!g!9Kn6Q3+7k*wZX-@0lC zx!|RlK^uhyc|?ZDfhR>i){)i7VobIPis~qdV^Dp3WC&^@zFATMM4yx}3)lGY)j_{& z410LzA?9OtgwB2w&^Ok{pWAZMhKbvt1$A(<71i3bJ?!_sCYHcxJGev@?Wmg`C#O@Q zzO{??1?Lf(Y@RSk4vUc0K8q7|nOU&1?YvZ(2hzyQaMA05eusKsSs# zG@6^aeB7pi^(FebV7;#nm}^Efx_ZGy+_8y>B^MxAk9wi*8F#yMmK0_CxXIw*V)@53 z9R^^@gSIGrE{VO`r?h38`!|@lt2gAzHB5q;89iYxr=?srYr6NWz7z1e8kl zKWa!NdBK`9$;`t%cRg%2o%c_*STuAez$>SxHXH-mRJJj*?;i&8bEsfq^+BTt?3;F+ znlqXu_6o1(lbI{VuCE+sW{j^>YL%Qu`(T$>eexE}vY*2<9yjw$CrH>pB3TNwEYwDd zF+}K2?Zgy@4%?6QN){&NZ+_@>cgzm$i!)6n6@t+mg_ad{> z!<BttZJ0$pZctb8i{eW|y@MV?|rE6qiDQ;w|o4pt!piw^Ce#Lkq=<7719a8qnO#~|YBxBr+OfnMeDqM_C|hPv2Y zE=JdY0B5I*eu=d#DbKJ^yu-uHo-o8=$RPlzD6-z_3`0Ey_&H?e9)fTB~ zPX7#7Mka{Gf@ zfSZGv;HGzV*zxP`-TY1@Bz58feRVIfJ1&&3DiG0wOS5c9I~a{1^qWw+V^e zlw+o6J>?lYXBWM^PihGr8AqKXS6*=c7z*Ha^CB4;^CmL$niVH`hD#3~!Yk*`-6A%} zW(U`*fA{)n^_4ufloKe90 zAjRFvyG#+0QaLhyF$G3mBLjFCc0@3=9w@%6wMtBSSFH!oEL+0xXer4M8;ybfcIb46 z<)5>$lgIC-#Vq={{3wdPFm`C#tkpVNBm(yYGbI7Hj8WDhd2W}ZW1->_9Medimkasi ziCf2RZRbyk<=~A~+766|WbMs7rbLuC?fMA9#rh^#RrHthf@~#A z?ei}6ot7S^(aA98NOQas2aoYd>+j(m^+H|$p?HG$ueSNcWsO`~o%dZtum;5(Pnyzy zg}b<~P5%Ke)I5FM5T1%q;1LR9ADRklLs7+i#S;X6JDJ|CVO4yk14lEBzp|eH#>xUV z?S_l4&b4ovCfWBr-#MIJcnzv;SW!*2`(U4$VnXAM4stSzDdo?oyuaJdQRrwj;x;ms zOEvw%qK`VKV(saaZsF+^?Sl`68{>5g0kbQ1`WXbep=TNAN;FD=_xoor5W2F*9XkV? zG&`X~nrFBBJ{9;4ZSa!)v>*hGOiSU6sfo~7C+lQc&OCxSUH*c@=+KX&ntft zy;q9*b(z>_Og~iK0kdUeN8exzTT@ihfeQJsV%27kChiU}vN}B8J}^A)F}luMtJeQh zza&en>2Cer&dG1KQrWokqHGB6+P|_}?_&)sy9lfATv1eY*zX$KYAR?cdtBm|?{8xo z(HVMHMWlp8alFNvWCG?LqtUIro~r5fTV2#hz)Eb5;8cRWxA+eV)DqL2QM7 z6&{w_b&3>T)V8xjc-O1zYSi7t2$+K7J^rqL6RMuWt}Tt`K(XEJDOm=r{ndTh?V|;J zo}a9a{nw3J^&ma(?QM(npr`+f&cqw+fb=ca>nn^ZD1O}|5}#g^Jv5zHk?OhULNQv>-(C8IqV^Wlv*F_bqZ(xnw)T#8&-Ig3_9`m{xE`C(2$1l(Fe-n zF>6n4e`RNLbo*V|kfgT>5B)JsKfg;{6qHM(`c`ya2xro_Iq;hF7zx@L;Jmnk;USM~ zGtk1}gzyiK4ObX%Wf`*``SBaeG;nXf_gc~Quu9V48nH8v ze@4{iDx$pZn-a~s4a5A3c$7{%ig;+g`C)`9P~D=Ai{M*=g=%i{h9<3ze&R*9+J(yf zHvn%{U8nOvq||0E7pVO5^;9=x%isPSkH(NA=xR8N_W|T!?U0Xf;-UWbM>pt??F@d< zSVd}JuS9mB83C%kI#`+5W_H}}m2RSZe*br`AOWE*4MH_99V+|64P41gd}ve_Difgk zDGL9KB0q(Ko`GrF?I?dg>6DEY=)_8Uu;cV+0-!^edhOs2sG3o^7I=J*-LW^km-qSh zu9C=OjUA5KTyFXV$D>&^MM9hq;@gd*wW|BLESOA&>s1 zEyvh3AEc_%L#b)(QZT#+>qR8gTOy2;b2vjxD2ot!-#`LL#6Xh$e>XY*d_?;uxPb=J z=P?Vx8BM*b)(meIg9dj`#=l#T&QS$gjw9(q#H+}iLT}U$0=i{tm%2#)N zo9NO_Hc@dN^(`^rc|>`AXTXUl$>D1w=zM9Gez_z~_ZH1*i}0s~`J_s75Defp^0F59 z=oMUWH5+=Sw+L$=tg$f;fkZ#WS>MB)SNUNc7y12Ha{@ayHV3TwgFZ!%UjumyV$4_B zHIJ`kVimv7+Pw9v@XPX*R`}{2qfg|Ss!zn%`||0NQ&GgSjdA?z9wFw4zokXYFxv43 zRK2HD4|u10PL2Rt1WfZyQdM0C*A>tiOLP%$kmo>d6n~67X<@MeJ!Q**`||#B0eMxo zam(%}eb*J<$6r(sbRW!AA2n$Gwxs?ZF58pXHMT*2?O#c*zNCZpGPV!SJ&=SZEx%d6fB;KZ^!NiOsmtY*sHuHOb_wfKVES_Pk| zzF0Ivm+lMmBY8W=CTA*VZRRrDb3gyB58wTb0%i?5daomW%OH5%-=)l|rDj5OzcM#G zJgdHvR+*h)g@NleZiP|)@t<3~t^Ogt(XI6IYSF&#vq4BEtJf_w>Fnz#V?g+Y(pDf> zoozb5W&K0WQdsS175IFL+ThaTj_4;FrzTu^jLL&u{SQrigm6%D?56eZNJjfZE&R>U zWngL96IZQGHqDy2;_Ra7fwzKA#(c-@thiq-oK+?rp=&>sozOSnp;NEddA;jp0O*&o zTUDG`>GN-}PikF{j}Uyd7Bg!YcR9|^>d#?&KiY&%1*n7QAG`A#1MEn^cK+-!91{=e zu1@VUH(CF-HsupA|NYD}C-`QBL_u8Evsn>U>Jm|IGx`&Qxe%eFRkHEc`KQOx$~Dn8 zk>sC3+A}V0Q;ak#3_?+~uXPT7xp@}$7>erK)k?&LU$tFIW8ckcsxGc#GO&Rwl>j># z<<=cifk&nES@XHVE6PwN=f2XmrKS6xslg7gl10aQjMasyu$n1mF z{>q?8=aEgPIC1RlK|^ATV_)hy2R%jQm0PRBvcs_i$31fSa{m1k&%;Kb6U%!9`CYG- z$mo05IX3*;2-ej4faEJkeEaD3tO6s-W3p(~YpRbw&x%4D+_frHc%Pkq<$&ctY10NBIm*34rna=Me7|!{*v>W2`~Ci7 zi?6b33DxE;ukq}$rnT|Bvmi7%`M-L4!qYQ*4{d@;!4p?(;N>F4)a6`Pd}%KJ-{tS) zmj5l{_20olr%;XY1RLgR%yy?t7}xN+dY_n)%nCi;K(&R842%!F{Y3Epk^Yby+`)T@ z8Cebwk0UL4TuI5YfKr#^pJb)n!_T$hfd?BXn;_@L@eE>RT5i9jRQ4Vu^u#EA_q!UaF>5?ymeLKVJi$)FbO5HE zjkr5yS0&!d{Q)EELaX}IP$>4dU1*#6Ka{}_9qiOici{`L30dtH8_0sM{dGz3i|5W| zbvvsxCD&SO>5GdK66X8lL@6f5a(WA*V%mmxSqIYQ>{Fu9%oCdXHr1|puTk4mH|rvY z(f32c){0g$z`7G>=G!}V7s>7+Zt{yb3vxi#fx~r5-ZR6=tI?Mk=ufq37Ng*IHZ6OF zCdNjJRGAar7hlQ=K-QBbSd6Bw7>U+8NAQty13%p6jah3d=&GPixplj%ktS0*hV~7j z4x>N}1%MVt?u%Xx83em_1uBUT6XJB>Vb;1&x1{+PB(5+|uDSaK0!(jCvcQFnXj$^) z7Tt%60Va8e<%u2P!zNbp2wT~d{y`u~Q+cZd9AwQt*J|X@l}=WBBDNyU&*_%!G^e__ ziA~kED9qYiIBR}|UIn}w-_&}@<&*n`-mU$&Rw_t>=ouXegs*zzrE@1rWPCcC#YOZxq-Hg&AVgxrLX6ParK zr-U;_nl0C=#?G#~PX67QdKDuNFVN$=o2CPACQ&cb^kZYggBl2itd8BRrrehAvCel6 z(Y51oAP%<2iJ8rQi^u%@pikTJ_`GrK|D0m;Pj{U}69S$8#jXIL(tt1p0WDGHWW#`9 z;=^sZ?}+mbzEBUm+>x7fpN(qqTYQ*g0sD+obOcoMN&h;=X;_k6_Tb$rKRL%JDw@J# z5hJK14pf4&4|P*?@E2w${hcp{aUwAG$CLN;j>y3nBR&qt{&gSVv2LPj!!zUm@TERSkRL6Y{C`UT*9egQ z*0<`b#7C4P-k^Gm%_W11{s_5)s1t_W@94WC4Ulrl*7n+pM*!>fLf|dgvdB>qW2P>c zTHfaJWOg{c>S}o134-7JAF5W{Dg?$J3Tna+UPA$-zO+5pJ;WPU7_X7vJNkqbvX;N~ z{BKu78zdo(SX~O1UJuOa*Z7H=g_SEh;7QTyg|k}kWd2P_eUIsW=D%&@zsQK!h=me6 zrqBNm05GC93f4hz8H?D?*v9{X=lJXO|6hE*@5EwZej8fVmz2}T4QJhTBEPo9W1Q{=+GyA{|Vab|ta&IqUT&I#xA)`m(1&!p-|OO<2;y8)t0_L z@i2Mu*K#xw>(U`^7fJ{TXotT6@H%9U#lt99i%A+g_uZnY{=JEU#}V-)?dHH+xQ}Bt zb^uU#GWt>=|M0LKy65{Oj-^~0+Wmv%+J5KF$Zq=f?(eex&gsFLgx_9K)U@~#5OII@ z3bvUkL`S=|*D_n#Fct*l{**E~!p3oTP=aMng5Qmfj~nm}iLdE}4Zbbna_}Kp%M6;0 znSr%7-lkb>ld*ZKSK0X)+TQ1iV=jFES}0^RDH2-}WJhJwfgY^({D<7jB5@&`Naz#wMsPPr(o8gOWa4k)MX_-U=7@De(|1Jkv) zISIwdBXHcubo-z#RktGKeB)PHpEp=7%Pcn z?IL(L*Q=ay_HHuE2X?Zh{pv-P(nYIfO+A+VlO(*wEOkdSrX@wUS_LiBj0-U>>k2Y4 z?@T+zjmMlt?@Y^JhZ-ZMk1xHA+DEl73lj_7{AZCpjEwX_+=l%7!{RGtoj^$atlwow zbfo|kP;ctJz(#Yr*|~Gj1FG>I(&zm4J$7oDWQ957W+U_ADqw{iEN~rsMc5FENFwOL zf4*dp?9MjE$;MHG5YyF@Gg?_}F@-%3!}ph26<6_Od#JPzyuqk5Go?Pa zSUcr&229f8@%R}z*+!?Ry=jGLhn)@C%ePEaZwGKdQg^>BKT`-AzPDbsxQpsn1wXaN zB7l+ThIpYR1#ALHLjr{)e>cm!(>6z7;G>!xkfE^9phJY;7U{0OQdvzFZ|6z%cHRb~ z{@C>3*8<7Ypn)`!0}%P{wt`_n1M;+TyUO%$C1!9D_WzhMRqB?IFs8Tv+{{Uo*M3@J z_R31A%B?s`QDN9|R)FD6cK!JgVYgVCG%U zV}M$mJw^U?^$<|=H3(j0Q>xmg%;aFt1OF|lJ##VB`^A%G^60A@+Y4~n&NXYYn0MRQ zR=@aSDd5R_Vuw_?14Rt^aKIHfUn3vIz54bva6Y@v31yC(0(z4fnSSXZ6Vo~8cep7J zoNtq~!9CQ~iU!$Sf0TKF@FiS)3OSo3oMF3;aWDN-n{dRP!P$9#aN94g11e?t()=U_ z*H9L)DbL5tz;4(dF@DN!6o2iw_4DhX|HzeETFZVd-06Ii60CO?%)*)hiwVYWnJd;0r92o)=bkkEoZrOLAxSLC{^x?eTdmfZXthQmk2+2()Ec0M?TH`{nTnctQX z^|NxT&vebUcn{2+5^3+NJ~j0@M=H=jM@r6NP2oc8|KEd%Nh!N?Ktz= zNxxG%_{nW`(cf^nlrsnb>yT0=3#^g5kkMFU=m_1q&n!wmVZB zTt)eKYb$opEe9yZ&a9+}Vp8}nquxHvx8g!dO3ML^?LWfsKca-KNXz+>^n`>s9aS9c zS2*dyb=A9KpS2#h?6zcl>gnX zu;K?_c0Gn454XYF-8zX#sjX%`>|BtKuFri~SUuK>opoExsY}otZ!&4neD?VWl{bE$ zj0M&wlo^5UXJ2TE1*TYBeUr5$3*=4a%-r}veK?+ry5}`(s@&BjS!cdcdAV0SMYW(~ zg}PRKJ6Z&1ZY}Xmul*BjerfxJ!32)vGcDzt#dpM`=o+awH!+9O~ zicN3b%v5?{9If0>w*_$5FkP=`gN@hNeoSn#xHGyn-rywsmbV^edXIh<_4SjiErcGf_R_(0J2_>-4tKjYwEd2cWVz1KhoQ#I_V}5tddz{b)IOKY7^<2cSZpXZfQ|zPL*V|Q(dwT4{tS;i&)G(BGhJ!p0`<2Pev`o9 z?rtfk`Mo`|%dSqb+`2kTwHYNGg~fU2!?sW-nh;o+#T^Ojl0EA{Q~W1YE4)0*}_Rvl?zvDBg= z>3uD@O3gR3VD~jh?&>f{eZJY_QQDW8t!~yv#z^UURaID^;$2@1#V(lx)a##zJ{Gt%>o>FG1UGu>{W~-iRaSk0MGS%ys`kWv~c3!nKL)ASy797Z!>;bxwc?~Xfp;tY&b zfYnqxU`SF|y_T9@rux@Vabjm6Z9Tb5sKBULT{14`!(?4#gT+sX-RyU}1y>fKM3vVQ zE=60es#Harg5?1Fs>YV9nbC^R(?9#<4BCq<9~EGyPv=TSssr}(4NJbtkcfyMtE*XS z{Mh&U=0<~JzNv59Z#SV=v&xov_CINZ3u0`>vhq2L1LcIhj(_MkfLX-XhG^f}e@UZC z^V@9&#AX@m+28MoFH4@CC10ScPx3o1DP;p-$}t?Qc-tgG)yU;O4nGt5%$^Hx-BTs^ zajN@YL~`?tew}%3R@wR)C5Fo4;a;f0aYQg+{Z0GLwzw0T$j6FQ6W{c_{Bq8g(NoGa zE~`>1>Nt^mB#+&36`uHPQ;Ec4krS=HZvD=V!IMCBQ~TM97~6`Rs(8=CIb~*M(0Y?{ zhR$@Y9ASSKYku>^D`+|#r10hQa!V+T;RHT&3Yd)LL<~fClw5A{u)2xQ4##Mdcnt-*39L^ zB`~{{S*)DQ!74kyk-t;Uijgx_yY;H$-P zsDHs&7;m--p0;5dkdax6si*gT4_bS<%f8dbwYymO=W@;Py~zw1tnglmvV+`o&jlmI zLpp$(7?PhHIY0FCXHw7MYMRKBzMdI3@yhqmUvzI@(|${3CyI%wO86PytT$*@-BEFkd(B84cWrrp7!wCpC#yEFg_fQ$YEHo0&szq&Z-S0-dbJ(f{1GY!4-a zO#@DpF+vuIG7?)nau+|h2CqG^5PghfD6hQzg~w)WmT-C+s9GrulKBvV`SU8y^hu@| zr$$M^H>+?EUrUB9nw&Sf!iI3dv^n6}A-niP+0(@KNLC{Mv7W05)3g$; zs591_I%U&tA4O$#8lLKo^w(Im_Xl~54UQ^$*s*B9=>biX9Fblk0<`NyP3r1D9qxMy z>1XZQC>Fotk=^f{_@i2A!&ZDR07BloRRWLTrw{Mt{r3tjd>Rr?3ydJH#Io$_!&Ke_ zQls5JyMO(9=3_XziV-Y{?0)P1ib{OccbKujc&e!SC8WpS+M3bAGs~dPR^@l-_F)>g z4OUoQwF#}CeP3Unnyu~I;J30uUryh_UAiNjJYi%kmg{qDT`=6EMfDH)m@ecnDpB9z zT$;=z*dHM&Pf6t_sE%EP>)>wzr(bz3Fc3hZ!)$k4ayt6GWQYh-8(_x$td~B#nCnZr zs7>&cOPNRXT~ms#YMaKIiJIC+x9#(Nlr7)h9-bmay;3Bsp1VHf46@pdK5HZDSuB*4 z{u{N`yAt`27K7{q`Lq0w(nM7pmFZ%jf1LaOwHst1ZfG3OQBp*|t;twa(_-q<)$dQX z&|&J5QO&g_jY5arN_T8$C0=-8>UnpL`m!Us|EuTU^6ik_&rH{u8v_YPvg7Rj2aCM>Vt?y8C8XRqBU>@s+NNZrX$hkX#|PEhvJ}e| z6R$>>dD77&MeHlXi_F6P%gP2US4DI}MH`K^G)*P}Ghn;1y$}8zEkUl|_seHQy=6cB zwfj*LwiRHP_fcb8T+N5y(Qbk(W<`hB{Q|V&lNJ0rZ0O=?uv;HK6NZ1_C3-lqIhk4F zkvo@RP&3~-(_YowUb*6{6*4*7!DdEf3_2g39CbGN6x*2a9Q+wDua0E#K$!R>i}DKX zaf1@V-Y=&&@Hh>oLT)u{kd9}sFK=;f-o&nXPRUX;2tUp{Co=^VFR%1_oua~5dsl3Y z5BDjz->%aHTr+pw&FFVi0&>Q(-*S|LXw6nvE~)*@fgU%EY^*08xEJr&e61+c#4?(5k_~DhEe8~(L zA>s1l;()CgufsO2yURWK@r8%g=(O@5`=sVnirWO3FR%)>YscE9^!4X2`zScoY{Qef z29q834xBqktcD-g7GBWs{ahzn2mQ3d(Q=&iz?|p#N$1VWN$V3RV3~x z7T9VBKW?{AnLC-QM*Txh7I-Ad@_2v2GAIIA&|!)Xy$eq2v7xryjN{(HOdx&s<@0(N zYuc%Yh%VKgBk)3HwgL!}gMSX$mF*xq!+Ku1E*RdN_+x-mI2EjxacbL%;m7N>A@*J; zKN|Vl+Mi!v)f|ZeT=ag_c#ncj+EXOvS`zIug06P%l7Fy&o!ssD({0ptf7@S4bMED` zdwGxc^uAYefG=62B^d09c|r295afO7pyrI7#!sE#dpq#S zw<0g&Vzrq9w)3zO*KMavc812vK5sR0BGc^*6pes*#b4?(pu|>x2=c-s7#9J)q~Jt9 zdr#EdN&3ymSr)@CjAWx6?~nCn)k0C_t*&TD8TK3Wd+Ja)hXW>En$KP-->qw>&(jcd z2b^@ma6Yba4h z(OC~?IPrQom=N3aIGoG6g;fVQ7t~On3~D>XE7Qw8w_wI=dq;0jYb^>C zNuxVI>o>f!M5WF9`hv<)PL{@MZ1x2OpP)CL^pwy2^-#~xMpv~uz#VMJT4ZI=C;UCT zQB&BNn|~S_p4CTUG#&q)yu&QfJH5Q_Gpo>vpaoj9GoYW_?5cX%@06F+`1UrFUIW~A zauSxte~Fb`W{USm zj1L+0MC~4vp4WsMAI)TI@ZkiO2G)_p%35q6lp#^uC;28XFk17f1;Bam(uw`Im(abZ zWY;0P1Hyt2(8U++9O(aAnQ`gPOIToUR&hZo;M9Lf(){h=+=L?7UaBIh%k@rU1?d8^ zD{r`b%aTK&WOPrHIEQHxku(rCU6#h|E_Ido^g8XM#>VSD4s7z@33WX*-L!ryt5 zkOz}cw$WJOv*KH3*%z0hIWn96(&cND3EvUDm}`9TyXw~gz3pI*+}k!58?Y7H1{`}Pep9d*L0qSqFf zRPGa2xtauP88?68Ed+AmjbaGj!H!0_aGjhOyEJ`{T1<^bmlx>FXqtB`UlK2Uob&By zOR`G6-?RM8^5C$@#CLZU`+rL36Z|GxOg(Yv!Q~Ex9KKAjdG*WLBAi|W2A0V4*h$#Y zK)L#!@c6!lVitbYy`u!qs+df>@T*qJ?jO@gWPy(oS&0 ztnD$+0@{g0n|4K?z5c`Wcr=#ZGosupIo*evo;xn%o`)wOm&Gi))m;WegyI5SBBseA zK7{&l_m>mHFSO{AXHAKS)A4^El9|A!MDm%Cj+TgI5>9&soWc^lk|0*J+Xzcl{Za3GWE7@f#vu%B|CmrSC4!hd2m^*3`|0phroW{*b!z;0d2ekYRa9fl$d;`EJ`SM}Cie};Zuh;e9_Vji>(S^P7| zxLP5r#!2)w&Bk2*tK0UE89z5ge_K|jzZt;Bvy3md*Vsaj`u_dKD!P+4LQ-fni+i<; zRU3NMBj)`lmWo@UZC4WDpZa;VArW@0m@<;~S#q9g~b(C8K8#Li=B8bB|z4$~#I~ z%q+qsDVy_Kj{K9O<8TFkKP_Q@t=QfN={LTDNNCHx*`kt)M);+tpZwW7>c=I+9}fcc zpJu2CoiP2HR_2>Phl6`CO!0D+A%VT=*6GE^7^;xDkWEQ$lUMr5k7cETIFmPLbsKbF z(yB+&1ypwZuox~|wRixq-zq{KpBZm3^i$8WIe+JRZahl-88P^NG43haU>^Y_JH{`m zdCrn`Z-on7=;($bZ5q^ z?X29SD66gG>9c}pezfwoM_Rm9-#dWN7f5rzm39NI+LWPlhwVj(OopbZcg*DEa64|y zktBLP)`83R_O^OJhnsVtMSE$iw$vCAN&}4u-MldAN@1<_SiN20;3I8X5W_KM9j_bI zNYbG6je|Wo=ZUGE@k*S~zMv_7m8*~FLd1@*=c~?ZNZeZ{Z)*7QOd|f95i-z1iwB(~ zg)Zapr(Ljh&2edM!6$vF%#)!XpyHz_#I|>b=8bf1yLs?p*3tp`- zHpGp9%2^6t==2RBPDyRy>eXr&zZURfOq&U0eMSM!}6$X^$GtE!nr06A1U9*jASsctV7^)XoQ<@nvt*s%gG=dTb}*7$xZ)TWjiy=ae2xmT4-IuX#XrAp-8YPxY#{0?Ra0O4GrOdzZCo zb>Mf|qi2(DB1xq^eQj4F>ahap20?S!%wXyxGc>UtX$@8!}M9hTY zk6iKj)ZPR8(;u-alWvceo1z1OrcpCV?|}q8l(;iWi)DFJ24^0#vII_0tkXU`$gy8L zkQS{FgRSDGGtGOo#p7%F{uzuQg&WBn#Aur!_Aor8JxX66TM5@zR@dgpDGkWM!6uv_ z3uYb@rZCp&y>H2jO$jxxe!X^!)j_3v zQJH7f#@|I$@4TS#Ot+ORXXl25Rgwe~N$yjYj4kEl8KZr47cL_SHZ{*BWecB6CZn-@ zTv>fTKoP$7ZmaI3zf&{7njunW`F4`8`3Qm*kUjpch?u>u{as}r3gf_I)m2ImL(1T( z-|74Hs;v-j_NO%`mND1k_9B?w5{-~M?ZfeHnari94{pyC|LUW}!K`zVe$k>jWw4)8 z8NvF}FzSWv1qfWUB{FijP(ZXix#g9&P*lgxbFk*0s{F>|Kq~P1*9e-ZM%tiWs^{^N zOr2R5VcJ$L__o=tQC&Bzq}54))y6um>`?-<O57Y^ZfPK{Mwvlbre;NzG<7D_`a?a!)11>#d2BmJFnH$M{Ei#i+dB z;qQJH6g7{%$w=R;Lyl6qAOjZ{tUw3BB0AW;NzJ7V#)&2TcEw0TlqMo{(emv>@9 ziw6IrkwU8()1{TB=9Fb4u3>%L5hW%La&?Ng9^PTD zG={pAe@)MVZoq=H`+eIX4v$!B~WBkHSe#YYV+{-0on1ie`-=S;FH#MVOw5*zp?mhZ^pxxLQ3!o!jSHU7u33s?U)x@h#&=f~!%(162< z^!_2)zW_Fk3Zx^CPvBYkY8|P&sY4}$3}?=ZAifhbyO3Nqb+!7(vYm%t=(U>_kF5Kp zJ&M}YE!F^^43b#~o_f-ECR$_i^Qv}+sfmGKz8Sj}QsT4at}?tNnAO=VJ~2>cf{xZD z|3E8!AC$_rHkLIm`Z+N6{vP!iax46)QdD5-CEaWQ z8#SID0WvPO;bM1(Jo+<7>~u@wPfJ8nzDSz~fnqlysIB1>?EI#j3lJmkyCb|(2IsYg z_bS-96nsA=1iCwJa9#;BOi%BN`o2+btN_XY1>H#SQCvWFo8Qb|(yR`H&?J@pAPRVz z_{DD95V0LjbnVt^8ptHyc-0jgZZUFw@e;C0kE!WBG@33t_R4WsPnAJ#*?5wMoLuUc zzAkZk6&G?w{Q)#1fY1CZe^|4l;j)Q40?l5nh?#PDJLI_@WZ&+4g|G4K_b-v)isM{q zIZJ{mCj{)Q4L$^u3Gd!*&KEW8EBy~z?XN@WgrLL_&2foV!QT0W!57B^jlthu=ch+B zDpfSIup)XuhE|)2?)4r#)HGSz!3iH(=8g6yyY(XvYSbFg}<^kmsI`Jp(n6xyA znZ&J>b!}VI3y~O|B&MbKJ!psmF=ef;dbwDgMksoN5oiRG&PQuY85_ozG%@vrMslU& zfmcO=WyG*RNiq3{S`&<;o`lFk&7>dcH^Wlv4G^-~S{Buu>FiJ(68s~qQLV`IBtPBO%qz~%pUSA}6Fka2 zZ<8`U`h`)x`o1+jbR2BZp0WnmEqgh36kCp|XZ1Xm;V$Tf`i~!cobvKt)OE+ zX?{86cWQAiF@N=+1V+!v>u_E@zWJtIuaqxK!1L)^4VGS+^jX3D#0bqeH1@MLhy%Z> z>#^(dI;b;})<~EOKJIlFP%`KUF!?_fmo%DvTu?ol8YzZ+jn-1;`Nf-X-XlpcQF&Hs z8itpetV#76>h)vl`IwbD$gE2M^2%?xJ^|jmGr6~RMxWHr4=ud^N%b;I0t-P`N4u{L z3lB;XCEP59r-{r2DMt&dW{AlbPES4Z>>i`Bur-LmFy5V1!B#=jLXRRbW_BpHJ<#Im z>~`%ZqufsHPaby1`h(U-+6CS)|MrkAw3e@7Q5Ny$iIcJF1dKp=jV-h_@a=ny!-ZcT z9N&rSd707Gvl6vWjaBIsX*Ak=Bz>rl^cXPbN(ICnymS@+p|l$v`7Lkg<%@-0L7Tlm zk!&D?^R1kr`jV~%V~nDY5vhJ%AdzEMJqABt;r`Z^x{1J${>{@y zsw+>8QrxIgJVD0D@;>%hq|ZSw9r>q-&%VHhgGvbGl~*E*IPJHIJxx%w6SrbTo1Qib zvBw2>+|wY`C_W4N?nym4jQIhzb$O~*Z|eyG_81k)IUIe{BJJQn!z8aNO{IYa#~9s}F31zn4w*<6hoo{gk7P_q#fl|D%){ z;x9a45uUo+gSGK2_-pes6d?u%?P#0fUV0~LUlUT&&(9`fwV3teRv<~aY4^5w>G97)cFWi1lSIh`Mom&Meb zB#ckqW*iT`_8G0)2d@988vabD=7&}u`231;E^aCRX7KGzYGIOQSKe(nqsESy@o#ea z<(ZGQws?MSo4VOdt~2uBtc#?e@M>;T<>Id8@85K1FHnCp6_l z9u6L6)b6naN}F%jH`2x{S%|Ak4iw3llYCd2<#-knU6Dr@{5T%o0NFr}^eF?Qc852+ zpIx`qx0RntE=U-IB+*(EGwsGph3YF7e1iJ}mB>2FYAQxS=cqfeCxxgu;-1=>LdxC{ ztq91+93h8-w@lwX1L4@L#3h%_^vDNx0DWqc{xM#M*PE1<)D6epv}IfE^NmVv!EB=C zLytqEnB9f2EiWSRAg^5nJaWP<+P{h* zgi4DC$RKgf$x1@`9dTmWa_gDW&|q{PaYwTJo*lB&Z0wwcsnAY&2CMDOfUmetdryy^ z;#RIz#du=Zc!h<9eiIwv>b-_2eDUr1#qIYziE-ygC4$tanEpNshDs_13=(V152wEn z|51BOV>6oH`#p7DyW>wpncZc{A3D6Awc;nB3I+e?YSvKHd}`3X_P*NO(DV4fjeb+v zKO)7(g+xpmVaH5^b>^RZ*Mb5X)@k=bLPD<>yVIjRqr~P=Uwx?Hr>?T~z;sAqtnp+f z{HE>w0)vYz+H(5Cvk70a#Hs)hzBd*=o1m<^)62H|bCwTLS0BR1D{;^qTTA%dZQzFCKHLd56AjTo>!N*;|6TJ0+tdCP zm<*W)R}@mpg~g>ql9rRB9)@!k>dZY{Xz#IrC01p6BSS_=|C$9rMA#V36?a^iG@W=4 z0Z%t0d9}Yb^K0NNnte)FcFM@!VQAD*lkB0E$H}=fagf4L(W9B%r!dmne!AN&k`jX0 z3b*m@)b8xrL#;)fy@R+?dR<6cjeq&QbSlM?Y<^YibriD1jZ0lX-%T-bG*NBuQr-FO z4w&HJSr_PSqVjnm(*Q&JA=tH0@_YY@iPHMx4_+ndKfV=j zrZW-~mCN*ocxENcSb9Ykz;9HB_TCMlThc7;*917G22a~J@#YX-eu9tPsU@WzK@7Rv z;6hPHTtRFBunU15OD-y-%Shm5&|!JYm6h;Zx=ejws1+Nnje6n$moKG$M64w&OdWp( z&~z^t{HkfL<E|Xx z?|yE#2m^NKPvx5Na+|3-LvI~dJAk`57g`CR)3tDtz2jxr1(=Fx1TZJehvY28O1KXc zaMAF#CYNvhE*H1P@K9}exs((}vxybGW7#^Fw-n!n3bInXBPpeo@j6~o_JcE&^)e?| z5lKYJ${2`tZOKR5JUxcy#nurVbuW^_GJd3Mz+X90inxdIIo)dW*)00nXM^+1F^)7Z7zlR}&CN&~5GpoI}x`aohJ2h6UVa2u80LqOm)W8&@p9ZR54JvKJW6n0kg=IPOg8 zsY7yA=uB@|6@G5AtzkTgaHa;xy^9?G7AcaYAM)kd8D_$mKK9zz22xnWvn!0qP;R!+ z9D80V#-Q)t{B4{{Zn9vNQ1G$X7c_$B7_RYseXAHZX-r|1!L=r(hO2WNUmQk)JL6;Bo@CjLEpCK-hAmSHedv-yr+2J2UwtGj zD8>qDEIK+G(?BC)DZo6941Fnytw`9Em=~JAn;QUE59(ELXBX~>N}(~_Q_(h#ASl5_ zEu1XRSmQPf>|Y;|9Nd-J}ZLd$As(dpB)*sYIT#(T8QL(FtB1GYc==mJ{Z zMm6u2?56b4Kfr7m>m(C?S&+ObXI+x)h^63<$h%pfle9*8Vqk)JzEwgv8t}b_eGn6s??7ZQ5zt3r!2fV=S7#@9=hYPPmvTtaXS?k)j>ySuwvaCdhI!3pjz!QDN$yUXD2Ft~h^bDyW` zz0aTT=dPOC)4g}EwO6l8TG&u^=PT}`uu1*9D{KnN3Cv|oF zG$W!QSabE&@t&j5fFP@wVo*73Vd+EbEf!R>yo$9sdiCDl2Ed@SKe$8h@5nOR4Ja@MFx7D&wkL2Z$QMr zHqo9%j@p&FMZUed%^FuPM$pj%F? z*4(w4ytxE7Zw~bhTqmbGyQ!0(^zZFG78)l0bx&RiLG+qz6ZH}+3y8(1eH>pUez~^u zhRU8(1NOZAj6XI*g9Li-%|oz4N>!crR*p3B93R0|UmAMdv>ZA=K}xJmeq8m*YByhC zuX*kQpB>-8o{#Vjv#SShy!e-MF?euu0DkY~8o5Xo^ zZxD8%XQtVlSC#>d#|<7ChQ_L_=Bv5lNSx~BLXCz!{pGlLYzc|Kx|=^5S4>n<^Y~K) z-$zr6_z93($%`l{RFC$?*~!^*ws6GQpi^JWZ-b`ArlhM20{oN+lL%9R?}LqBZ6Zwb z1I(-28Xst*N87`laVp_i;I3lif^_^;aHybm3k!FANi^lB;N3)5e1O+B`ztG&hHuS4 zw(g60y@k?+R;|I(6^8h+!2gV#@bAcDNy>FFak;^HKC*U^3Im>NSbT-ZgX2=R?vaD$8DY5Y&ABK6h=&2k#>6#IwishAP{Ws2`c|wmre%xfi!qUlW z-zfx>@wquBDV5?{FHLb*e4De8G3)T+W#a=*o`}q(<*j{arJB>n6H;2+l-UK6x?(9k>>tW*!P!{r^vBZt;Uc$Cap@TdOV) zy{3iwLsK{rSmBtC>6Z!%&i92!3!izdyu;vZWG{YADXXnqe}nmzTz>_iPfZT; zv*iDD3%LH?FGjADb8Z@b`3L{I7qe93um5?+|GLEe`ZstFvAgro;}Cscfj-YxxBtT) z{?}{Ky@IoVXv#L&`5`aJes{fedt5&8uPOZx#^})dH-C8fg@YntWqQb9s-&9T;NOG( zKbp{g{-+1}ZyG;+qOd!H`YuA`&zIA+>hnJ@<6oE9y#JX%O3VMx1O%grQ7~}j$v$4m zF|qe%%04=zO^Xh#3yBQa(x;0!fUVE+(kq>5O_T5I8WSgOpuq%k2mKw&aOl-y)IYQJ z=COC_EJL-(MxpvtRG3}XR>PS0@80*{+0TE0B2Dj~sS)58e-9M;Q!H|tGMjD6dK%>` zE<%rm5dG4vK|@TgnmNkZkiqVA8(5plzX)0sC(M5*GK7s>%;5r2mlq2-zO!BUK~25< z>H>ovVLp|b(=O=z_WF9%v}Tw4`U)W}&o8*veCfnB3wzO>(dK?hJBlyh7+);soiRE# zrnfjlMSyxVoksvXU5msW`i4bydvkMil~>SUcFu&WAkpIT5A~oW7ZuK0Te@-xLs>sv z!1N5RFlg=_`_99ct%XughMK)J6{7EvKjedH{JvnEPsruKFrd0^`h4C93b*k{R4F`b zM1WIP_hYBShTEMq?M9xUv`>Ah%aY{R%(v%F^AV<=XD+S`uc$@8cekvE0Nd3nI$-xU zVcnxvHxV1W&Wp2@4yYmo0nr$s?1m#)MB(bK70ARyxN7yE_uqZ&V_Y|5KRYLiY406v zI*L7+cO!Qiy@Gwm+@Y1@bE5=->b>**Q|H}mhWt<@OLf;XzF0_DBul86*j+#Rl#-HC z?Hu=W2p>d`!{}aEsaPb`3p%ERsj2DRD4qS>H9Af4p=4Er2&|SK=obsDU+voX7OgY%KoZx-NsU>iiq2qqvI&vGzTcu$52}gUW~D{zmr0 za4Oa^|KU3pE45~WAw51m!A>v38Waj96A5y=pOB9sckC!uRhfOWTZw@I+@pXtmw)=v z*Oum*TIWv7T2~oCE4v30>I4ZK4@U&v)?4vb(oY6+PhzNvu_Vd|`GQ(lyS_w?D!)Tk zdb2ayNqUqwAnzT^_Pig`J>~j>!&;W1<&k=NSRE~qM=0vdwO24k5vJYaht|>c8qCv zTd~n>fTR50_xL8x^i)e>LIb?GzHE?xvcu?mpu9&6+M=gp%nv&ICcV}c<)nhV ziv2sVAor)miCf?9-k|{(xU|eCF@^U)5@T<#4@&OmTMo8q?>Bp=M?D3_@45)garx`c z4QHL^ryYmos6Z?!Y^BR^cg=cF`3ucQHiEUfMNL^EYtV)T_&JbUum?u5poRQozAKHu zg{q0EM5Xlty(W4!CQlxIu~}3itz+UYq@(e))sNuYf1}nW)Gdw(@Vk$!!;LI2&F>exmfl$viKX;3Yqv|(oq^CLz1F*G~t0(N~SeEHeKu~=BG55 zU36JLc2x2&9oTd3mBr}RbdB8G@XNPNhn`>jC@lSNQn*~KUOoY$e%c=Whag|m<>S6! z(R+-s%5h4>CVj+q>CZLrKu9)DJvx#PdHW$JcE~c|C@9G};BqFR^};dt^oLiYn0?sU zmJwGvb1lFrXKW$}Aw;bKubp=lBr-O|zYpM()@i0dCp^X#{%>yKabBN2B(00;7RO)! zv`3Db`|QiJ0TQ?I%(}yJ$Ukj213|1}&rpE^^-FAk%a%S}Hd@U^W0_1E$yc*+$+qkf z>q52ir5O!_iLZ3(R5uW*h7Y^gn84n4F6LSa#4o&HH~tL{+i2YG7rI$J(<)?JM*LRu z4pzk;k_Cuyz?TQ2J%GL3c>5pK-9wO@PF2<4+UucOaf-*8#z+v=p9`(hpDbdMu&+@&>ydVJ6RtBki7K%ACg zd>>G(yto;i|65(plgpdT5@|o1TXv)#P*3pURWfm;LtQLl&{UWi{|{lyXG1K@8hH{q z7)D@|GI=tLr$vPQ0otbkk;n{oZeftlMb>z2OiRVo5hvc-dY`KcsS&0 zv`xPF`&Iu9^H=D`Zp9VC-B@>02lw(cF~8Cyj-e(r=q23qqaQK9@P3hKAgZ(cSTh+I z?a1a(%Axj8WpFtu+NkS}pw&hhp1<$xmwRKIu~B-E!NOd-=MDgbJlH;!exv<3(gQS{ z8qoy>_-0eUX-;?1!b2cuEDj*T{gpY`b@WO(@KOaZ4$hFGae$n1|nHZ&2ngo3H6)$LgKVLKE)j#Rh?ke z#oIdrgpw|L>BR4h&=k7o71muufE2@gNG-qBZS4?YVUw*k`u8&aw@a5UBF-(xv59tI z0l&tF&^(>#%FmqlYjPu)K7FsVSZbS4{aJDh6A#*0{4E6cza3_1kBP)4Py`t$_CPME zye$t=P%lZ2dzXV*+Y$Odp5g4C)sa&U+px7O0oYnY;Ee1=Hl{MYiFl&|FPxO zkVQ%Cn=)2Y{>^btYSXr@nQ}AZH=`X)jHL=1_gy9kbCRRQ9kH>aP4COS4zLoavk4A8 z2?q2Ggv_WnlP|v7>8&opIsAOb@iO9(wB;I=1&ycdIOUPMReC%#Y8rZz55OW97K(|I z?7S=LR^TFlxz~mQV`lsA_@e+M;gj`w*FAXs|yR_q@A}SSWUjArgpz zsV|`jij(@R!19B&E9X2J1G3|refOLA%>B65tp%!yfd(4k^PrwnZCq-AT)a(aGCo@J z!&F*(fBG?mTNv>5Wo3zVpp=~XgKbde!sGGQzs zlM$gd2^&G9uL4(?P$xs6;q6L<+|ukumcDtVrW(k}ZBJ{PDKocSYHrq&jd}fjyvjWDLPYN?6I=2DFxOIGHuB$DMHaz3-UO8`RqGZaK!KPBIxyMS3caq z>^7R8Y=(*;kwA9ej ztKgURrHD*3sXkC)qe`OY;4;umKj9!wqt&|h&63)?-VL4HVerD$w7* z*zr~c1BZ~}gp(}b8gIs@$HT}TY&X`W3q*x;GN4+V+PBtjj6xYUi1X zDG^>erGT~C<)jHRTFCSFze|%SPlVZg1siBOCr#()K13~dFD@7*1#l{XW z`X8uUnEGWb*EPn|>ZeJ5R(KKV|GBXzdObxC+v@by%s-8H#J;6qph$c=^d@SjpfSZ( zjOvbL_j%zr#a|^ea%w|FLdsuWrrhDpgmU@Y=RNt)7k~vpL1#OyVPf)Js zTVp8(mU<}zd6t6gs3;+QgK9pFK z4qpijD0DY}F`274xO{;fC((YEj3UNgxZhTSn-V5xg+Q^@z1!jv;w=M4y$o<+X|uAW zOA$&a)7LF{;`aYKWsp~o3dYdafh3GRd6dz_#%Kx@WS22Vf|_Qs*OnsReQJ^wbZeso zq}uW@(rsfaG1W_$r58vPw?F1Fv%dZ^(0RuDq(%GrnnT4={ENvzs44+I0exR^kw%Yld@1;_%gsvg{=fSk)O-s|`Hu?&)N z30MNBVN|YT3bN~6Z<#R`I1Ok0=iM~zSRi@5C-2rsN-=*xiJpXi@+%Wl0K znAaR!QaA^)mL&~Kpy*T1c&~*nN-!^z=C)1eXkNC|t=}TLjcOTM#|={9+}@!Lv3SR0 znJu_1f?5P1gs@lY&_hMF2$GzXk-maY$%EMx5cv-sWbz7X!TL3xJ_vILi1gVuZyLHY zAx*q!)gR8qQ_z*+llo=Y-ax)O>b)IXyRe^oBmw6kEOzt4E{Z0zxPPx8y<~9M7sY4M~E}3FX-I2oxq68MHLG0rxu0Lf$*3ZGN+FNlACD zsWRhjxu9BY_h}mACg5%;=)UI6#f}Xz$Kf5DUwmtpF#$?N3qp$IV!>-l6!K9SLjJaV zn3SD$Sw^tTrS!Yt))Bl?BPrpTj?N{fl{{Z4<)&nYAbNtsom=}+z zw1-<-$xS{Yvz&vg3sOM@9Q4K>t;3BoBB+}ZdkBjpb(>!I;A;o+Lg8C) z(1(8e%;4jz^8^aMoEp57+s)2sIyy3+uXe`%5f=F^GUO)gCFo`>-m|mb`LHg<@Fds# z*#XL)Z~g1G+5Q9vpddI5X^ir$X{Y#9s_WSJ27J?7LDnxD@{<5&2cN}iHBqv*RVg*4d8CL$waoT)zC)gHZ zr0U>!FNim89|pbZvkSyNvr82-N)TXUc1y6!Gy@vOH{wlUdJv9hvMn8eM}86#3M|&g z5;sORNv)0xyJ~Y0>)API7I|@_55}iIFxU6%y2_2a9Us>;T4TqzT2sd)i9npipCu;o#65b-^dkHcAHYUN*6wmF+UeznJsT8)X?U8?eVpewe34?r^3U>$;@zM`+`oQL2b(6M5HkC1>+s##R0({|mmJS5ut z+d1_<-gklZQfu`eC9sG&>2i6srXbf3>=Xech{dk&YPf|~TV(UR?&~@7m+)wW^)t4U zD&I*thBN6T=P_l+F|+Ea42ANe{n&I8vH6_2Jfd$RtZFmYjeW5wQCjGVIakf?E6pWN z9v9Myby(eC;EkEfY@vy5mVPvo(Yyrk2`#mVz$1F>WmaC0$hs*x+XMS#t$iS9m4RB*7)~?@{bG_3K@(BU)}brJj(zy3B>5R~u(Tnr zGmwrqp9Im6+_2n4;2Gyyxamm4Z3hD4c%UWuX1ZykSIFnxlN+(P zU3Q@|c5tY+1Q1frSdS_=+&7kM-<=`V{c7ADL`zMYE?A@e2pON_nHiMkafkf5>A2!g zWWx}H0yF!2Vv1wtp$e(WIDQASsla*814%m8X7N?LnDBJj2B7m#j>^j~7zwtbLV(;3 zKtvhuN@CC$&lNoNS7-SiT3HE8oOJr>Ste&44%r^SU?+bxiEh$E_3n!zoXR`P*}s zc|Y&9x*wR(cT`z*%5klV<=#%$Q*{P-I=49G_Ly4xB5|Bqt z7URj1PU6@UQ!b5yyz5n5qxHDMwBNMmiPN>{uMF26l**S^TM_t|KG+X0WTX8o*_xrH zDZ)CCPc5ig;T6f%N3ZcCsVr3hL@=d{cQ#NwwX~F8MIMRzdNrAm-&kBSS<_6dgZHo& zo>(0JUshu1obhigPsk9tdy-JiHU+Zmwv*JYPuSnneTN?PPgmIQu3+XMqfLJ$^avqZ zexx~Yp-l4KdN%9r_*LfY7<>&efS*8d~p0%DZAO#~9Zu>$5v0&#p#j#I2cJ}aesL{8E^d+$#8EB|HG#JX=%)s^glW(kD>%^A!%ebziL`SNBJ6+fc3`$>ZMDi@}wO2&KVve%> zA)F2Z>#et-;0E>2DxM^>2jIe-N!KJICL+JKV(R45Ug2!m>9@6b5BF(#qU)XCyCa`VA zFWl5pU7b@cMipN|ljI1#!|9pUJ=)%fU~;xoa0fv@^7p{k8yI*_@_N{j#mcpT+79{D z?wf&;GcE+E+E3Ny9s*FP zg&t&pL`&DvTxv``()DU%_p+&XFwvPxxYak!{+yD=Q@`5yCpW&w3qws!vbF-piZw(~ z1A_M)Xa8&9Wn_O}6+1Y>r3Sr-#Og!019#o{NhSF?!e_dYi|(l+R#?cRD}@+3N}IMU zUGQJ0OC2Z^&%ulKU~$fU*<2=Mx8rbe@;Ys~t^?@rcWp z2Ff~DkX@2nP(s>csxDYIHNfFNgf%NKkd}07JM;r}^V1EFqG59qj~pJ_gHkJreV%Db zS3-d=uJuX zWcSoeWoHXM=(j3}eqG=BaYfqwdI&$502m)@_^&+MDEWksj^z=O7+!N80Nk*C4Wdv% z60$jWv5*@b?$M$KnHOnWG$&^@`{e{=o_oES1X&Dtl6m5xpvmi1`Qns3hE8~XimC8P zQ;YYX{E=}LAjc;fmg2)Ws{h;nYwShmAuA(5C0exJ={Hn_RWO~JED;e z8KYa&B)%pp@Yuh*uH2DrEE9OX7FpbR({#+YM}{oW^RRXr020+n2Im*_wboZ|;$X?kq&hmJsUsdCj4pOJiW0kx;VqA~T^s4w;7ZIy1>xL^p; z+YB#zG*bvuleH!iv#v|pDa~Kt_sy4IFmW>_#htJ`J$64RnX>+1an~hKDHQQiPK?J( zLri5g4-3`xRK$#n7}8smjVAVvjioT?kRX?LsqIVr26_>M)Be`m9Og`v~-spo=z`CoZ$!s-s~S?_U@jzK%&2B!t>_9EaL z(+M4~Qy>*@n9zKcR(&=wS>?Elj;RFY-X)Yu2FJTLAS#p3yz5B8>jk2De@sIerbM zb2gx|=QTV<10PEX`@uhPn-(r!n3W?jJ>oi<;)!={@*XzW;i`=iM=YQrfGzj*MLm{7 z3u|l+R$wyF_i+)pJ_DxxAf3pocFu5?LfB)tJkG1DW;`Pa7EDa=OpYF4gU3rxvJIA{ z!q!MIb_2Df#izTy(RT1;fhSZx%A?5_hsPr+*nqDsDb=jy&lB~w#O`;(X)8+Gg@Y3m zMG$y*`eNKl0PNzCuz11ktnjt%KG(i()ZNa5v4QjU=)woYVCI|<+<=+EQ6x|riCzNrs%`8IJ)=Y=J>V3j89y-{-W>6R2&?= zpjzFd4`$i3C%@Wl_oDDAl8xqbf&~WM)FNeS{TYYQJjYc4!Ml ze^_jjso;6+lYI&;_RWlMF_1kRQZ*|c5T`>&C*=jXbgiB9M3>+zaSz)umu5sm{Hvv?xd=brSp zR?JIQ8ZRdUy}F}rG#wWUBsA9e?tesg&z9uKyO+?kvw)C+IGBWoTno7FCk27qItPea zYfYlRNPjmM1TZB4@n=yL1v3U{vGQfv$K|2ft*duigJy-iASRQV0 zhc$9H+q#|g=t0~k^Nh?^1sg_za0#*f7dNh^{b2lc!!2=0sV-X>)N;z7FMs7dJ1|w0 zaGLZ(+3e?Egr2u34_6NLYf-JsUIVT(tqPd#qoK|~07b4^1$a0V9?2Y-lHZZKl+Zh< zM@^ZLgVltMg*meuD`4G*VGut&DQRcfZ55n0A4qTBq!uok$r0~q=E^$}90qx(Zwe7^ zkt`h{lNzN@o*W*m3d0W4$~A0Ej}j}GLD3V64jDL>5>o^&u~2Rl!O|xG>LWvMfRWsK zS`W*tRwf0%$LDhkdRZfu74Zf+J`}XH6u(lNDfH}QlG|>de?p$m#J|@)gtCNM4l6ua z%a6GWV3S7a5kZ%cz`O1cG@#?s%t*vS(Jnh<{ZUfCrNQe(HQ}+79KpjC(xokE%&2S5(i+0v<~_)s$<3b zuO;wX?w^O8KS2jKtTp+A*Cp5z9|&l;y#_vX9k4g+{e3SmHSi-d-nkda(c~&!9pbr_k5_ zWPh>M?~FdS-4ieu0BYCV)f1a;ImNGhSZkROl|$gaw{3h4@78(Kx;J4edT-OTsLbD~O#&#%9=`vT+)1M08;%6( zU%3DgYNRlRk@B_O>%B&uV0abXeP1FT&wD-94#2)2Oxk-;#6Ocp2nf=G)2)45%jRp! z$R&ydu%-Pa8W2=J)^n=zIq!Scsy)YTcCy1mwFkYv@ST_i*?_|>cLKV_K%m$UG{i%c zhncG%1AOtaX3W^C5KYt%_zb4Vn!CQC753}-u^I-x@{)FWF&z43b#hQ$oo`Ke`+2sJ zm|mLThtff#>dQ6gfL3f^`-R=F(->I#Pdh8r5gKaSbcRn;cc5FlMC zV)$-=-g%`yxz@|l?DpqVIkIU`QNtjlSbkeR$g>1h;rx?t!5=f^-1mcO^S)r=W`ig7 z3(W!1MMS&%-gbCm_-C1J@ciAI(E3uJIVNMk1u|gxk?)nGV$Ks3F99A)MCRD!dh$hFS7wCu%XqC9eT>3r1srxnK^%yi45a%fT9E-#kYXy^ z=R{0}MeSSxNG#3|0sAxT6Yqou`8s`*ErlZO5UQ`M7xRN#BbeB%z8T#Ghuw^40bVQwbJx4Wow36l3TI3c3^Y0yq2Qo++qQqZqB_1Em>>9(Dllz!jp0HslMvla1Ko%alTT%G+%W zC?sn%9}xwPX*c{%G!_)(ve-8E!4}>jQO^jlo&VD&tIt@U(voR@K6SPy$o=dLXZ_~} z%{*b=2MqSHt$xQnMytw%PK376P$}E!hq9pQ;f3BXxM*!KH+h&thMC|QE%}lx zOH&|&#jO&RyqstZK4AQ_CB8ynUNoFg>umFzEZ=1+?XWgkczDqvpS^dsfIEFOcsLlP zVIFK`;`9TW^pSh%vI3wnUA}^?Vsr;tQ4Pw*k@2*wIb%5Ds5XUTy~cRG(HmS#Y^bt}TaXQ>|T zKc&De5)8VlkvzTAMU}jpS4FAGI;dW+WMYR0SNn+_2Ntv{6PcTK9u6nl5HCERk!13X*TYE(JsQdktpzBtZztC#M>Y_X(X9e*~x(3nb z%p|1=Fs!_*q1mTOCJ-&@Nvu_aeAnj2eZE8nQAM)^S>dLJ0Yqs`AwMt;T8~H!XPi zD0>eb2Tx=QipJO9E!!Z+Mk;UL!IfW;RtB?_u95sG9@en1TgnOKT!CXdImz$}RCnN0 zsBw2>shUXUvC5bTja}R@Tz0^Ybqzj+8EoEPB;eb$QfoEqm{4Eg{#to#ifw&HnVZ%O z9pYV8g;#^(Z9mHA-x@mm4oA*RH{vlbaswmKh*SuxUc(_RI1mZb06**3|1&SBfn$_^ zi#NXgQA;M{BUJp>^few*MRd~Ays*g=VbU2LGT4F~c8A*_FyS_Skrn)v?}d*koG~CW z4;hU^!xjR|EJQR#sajxP(S^tP@-d&)ui+g?O*;<3riCV zE^z2eqAkf#@5COAD51*skY5*}p73r!$UvQzDgN_^H2rRwRo}BaA5nn< z?t8aa`QOhHAJhp2_$l^apqy88V_sTLlE^+dCdVJ2ZX2WOw3^(AxdG2ajZ}%D2fG5^ zTW?Dp9-w2%KfFo#LwbND$TN@o+6&}TW@3xhuhHckyWn&b;h1(a^?_(a0t-@C{75i8 zGbQcrfB_oJ1WG@0k!dX8(V3gh3kA?$gQRauo2S)sm@^kb7Q7&zkvnRD;rYDcJ=7q} z>Cn@U$*dlQGKTE4_TbQ3K1{sKKD5&Kh+NdcI!+j&=S^>-HS*6)x_?WtwUq=aVE0fNH ze?nzK%qdnghPlm!)@{O5o{|SeAbO&vLfz3f7F1p6(YbU$+pd5?dAPQPtw-;JZnqZYie3ztYza;1}85xTg?5Uf>qL4Pg zD+crr33$2Xa|2!`UK!KYpN~!R$7QhnM%ybct8d*)G(X2EH~RbWW$=5*+?JZ>@UtL1 zoXVjp$oYcFGU|B$6y!7F%B_6OnQdZ7*jQ;g!HLs~OZo%&a*x|lSCd3MUb4ppa^7Q{ zGAW1G?7sq%9o4y=EbE8b;5__SnucRiF-u4Q-WPT-8#i04sDo#SUnW&3&|(tLUn1R_QY zZV2c4q1F6jRY*vZ)@H(0w5RLw*+ztl81MNp%NMR=#vj=JV1GtC>bEbeoalSUsMPi_ zmi209o|V7&8XuAtlRoc1@Tm3&na~c@Xi0{orybE$fuiT`3`@ZWR%tqgP^`it5$3^u zSS>)U4apn>JP#pZ*L>3QjJGE_XPUj{!UF_}!#ih6;&&Bof6G8soFsj^VT+W~1ciVi z1+C*IJyCiw+#qxvJ0DpvnpUwO1%Xbpd?ASJgz(4yJ!k+auUe_pvh)WpYi>r0n3=rN%QR2wD z_E#cVOt?_G7Jqt#x)A zFsQ^snu}|@Mn=&`An&|Jsfz}1i2K?Glf=`3S&RDnFUEM_$2Okb(($b_6(e2Tx@ijM zL)gP2VZ?eTXm{g!felYNF}O8Nqii(=F#tTo^~t3}r3~iKKP=|=uwsd|P~g@*b<$Bv zcnjh$?DzP5!&;Xk`2CU{Ms#TOQm1%B#~h$rL9!;}+CM*XU? z-622M69fM@QCvQdqxAIm_P-wDISO5cCPVVW^lR+@XZE0pR+9v3vD7jML%L2q&~Nvn z>!B5y5!O6bo%zoNx2t`LA>EVzaG;<rH z5l7mC{5E*WpL-YFzVU~sSE7VpKueN%+a0hVU0sIjv-RHYS){6=^qH<=t0f@BO$gt9 zV-(Gvu(-FGPm~#id1;T7V@(Q&Efw@@xn5?aD<=OMA)1Pw3(s}zZ}6N!VL9k1}#UABv7^!UCt?8_;S zD7X)X^IsKjY6QYgXIqKrks8{Ly+3KUkcxr4NrmPEYx+z`IxN3MqR3Gv_+0YDc%}n+Ri#?FoUu3;)RKHnBD=n$FfQ1YdPcBV z@yGnyWBD+?Kgb>lp*(1$l4@L#3`lQ;1L06@RC`=3)*|d7Y*_ zAZ;)}^+AT$I3xD9`xw2!%hnf|35XN`*<~NaMrX898~K+N^BIPQSuyj6CYA0hB7Jks z06z5U8CTY^D^<5Udz5kkRGnBB-Qg73K+Uu-&l+ntKz;>gJn(Zwkomm?Gq6=aA{9C< z6jPz@pn1D#MePe4oCc%!N0leds?krY-0HR;IaU?XuY0luSyo)GfTbmX8KeQE+KJHl z+zP+h8^Nm<{%DRATW4mraF|TQJpJ6;$)ZHTRgmvr7dF$#gC_o~tomOCJ-dFAZ|~q- zs|{<4N*9mmMARk^+KW<%`Pt0^Q{aFKrpjCdZ=dtn9X~a+n$%pg@4tP$1#X;;m?9)C zsIu`UMk8aMAj#L*&}tsvf56%*hPVR3AdJtS0uAozx&y7^m^_Z{K6burS6btBgz+qZ z7+m&$T}VFpIxlydO)%Y^yGI!iD8vOn&uw&zpA$`E6w|##48AnShDW8v$u!BsH$x>&;JPbT2SRUlo6E5z zoqC0%rIjn3=2i^F&Jlu_R=Ik0BiX91o9@7fcr>YK0Mnh3c!V^=LK!*S9-5z2@ra!o zsXVZ09!eU4s(Hne+ri?xnUw_nrSYT3eb^96BkKrRF+TnGU~APO7_Nu003`ypQfPb+I$ znryO^*#W=A$j0O|&*5h4?YQ@5z26&5^#!~$K^qyd^mBi|=+6a5AKjOH!LUTkg&&A` zJeqg7a}Q!37{7G?{2~*3JiB#WZ47LQjXTaE-62#Gh{qAq{rNMrtc8TrqehTHy+|Ed zWAS$tR?sPv)ytTSPKo(#eKGSVZtps&3-y8K zuAl$U3jm&4FX4K_yzEEg+VOQft(zk2WZPw;HqKCT7@d)Ae+PFzqUB(fe=`%9c_Q`G z)VmxP8mn!6>3wHG1#e2Dj_0UrA9O&WW3z{fbW>Zk&O*Na%YylLCK%_Z4OGLvd~L_g z1XDO$R>S2dZG5Ei(EcdmrztImPuG3((#EtHez>6oA6D3pg?g-)ziY%a^0$8+qB*iu zBQ|l(M6UtzDAZ(VKUrYP+0tBkG-jj2*Qlwk-%K^cOGc#25!oJl^yC%b))wXJdg&y=m;02Us zI3rf8NmYy5A~<3NB9(K<+5I&k$H$=c zG~;_Wy{Xp=qqV|(7|%`X^V_9fY#OWWPN`DEqw7bGzz2b`(7BwXJW(JQ06PVhB>gr5 zz;w5Y*xR_IUqs(LwKy=`zKJlpk^I=l0qg0`<9%V{Q{&M(3Gk5_k4rrx_@|2;bw^o zP=mY60V_XX8lWs&NM3-H4|>*BWHL{POS5|kVBF|Nq*$7vUk&i_22-&Mpz z{|6YV9Wr)bg_G!OjWrn_mQrEGi=(HbbwPeuHF2O}hE zTzJgD00lPWzRs)d_IAxqX|bftmUdX?$E(xZqRyptuVRJCM9hmGe9g>^l9d-w>t5~9 z^wWLwJO=kJ^hLr#&USw|i!Z%!v?f{$Ig3ZzIS9w$xIh>r-7&TZ4bp zO#<8Dcv>5dmgrW_=qR}|{Eo3Fo$fmH?L1w$ijGb>7J^Qwt<|Wz_A2qX`dpK#nkT${ z$2C$&So<_O_#%o>bVuX@!UL!oZiRnuVU4vMGH}9{Lq|8Y%RRMMNZtt+|2XV&A8Gkh ze=@oD2acs`+3(+)FN8@ZUpNkP{HvOHf9>kEKag^`x1Sk5-&qb%;ubv&NNa}(lHnxR zI?>b3S8EzMe~ByFk>Lh9{_f_?fYzirRc`zp4>vyB*RG~j=aJl?G%1(CE@q3KsCMYY zpf0@`KbQnYw=^!?SWgGh$+>8XZEgK&m!D46PJsL~A+Myu3icAxX(Hz-Ee?HA_5piK z#OcYphp7?2lORz}i_S88Q-_2Lbh)VH?uT`667=cGrbDq2t^ zca>B`oF-}-B5mxO69P!Ps`PKu?px`fMuhEVHClC=>6R#9#|Ks(I`Fy~bWJGzMQkFvDC7;{u}<~2uOg)KXI9ua6j>|6sxfp(p(X(DT4@`2k)12b@7WrW ziOg~qYDE6l7YfHUaVdqzc8Yz&j9~5(0ZC31c5sE!Ph%zxbb&bgx2_;AIckp4%X;!s z(1LpjwST(tnIVGmd&iJGsWgKzrO=Men@o^4B0t2J`V;2&HY*I-^(pJ4kGFFWM11^m=R){BQ3wukX-cotd+s%q@CaC3LL_|$hC(-o>ug{7-f`qW}_OJ)2$a43<;qS2x_!!U8b zDcWxKONk!517DiD{oZMLlOQ zH`x{y`^4~j^|uJXcY1+QcG?Gdl@ht2j+YVdP|dxrn^8QZr%mUF>bsySr`ZmiYWxg9 zGzGx_?Nkof=kW59)9;8W+(+hceXd~D-EuN-VWWRaTh`YqcExed$`c;Akf zLE@Yww%&@}(nYUcIwerG0m&(<$b^yC%%mzK*sRmRsmp;x{&txipiCFd8lwY5!}A(r z3JAO?$#3cca%;QWIm<2ulRYhHRp^RIp3}FW84if`c0O!cV!QF~lQ79oeO&n0Xgs;N zVv<)wBV5+JRK`Dc`5kv|1$nj{;Aym##qgWIe!652Y9lW1GjQKn$j(2qCf$+r2Biua zGYvfy96#;o4w?D8_awUZ_Z!AbgL%O9DL6mMbEiEnGx#?~sq`SLA zNs;bmOP6%)cPr=I&);)<-tW(N##)21KdiyJu50$3zd2WnWC0tlG*+ge+xfwGkYWV0 z0IhGeeJic6i#{7Z-{$HA#a`>fH2qRNcvD(v z)+r$Kk^)%&_`6pXL-Lry)~&CtS1``I{F;!0^x9DkIJ{`5h1!S%i-k>FOGBEvdzB?F z!NB9?vOx9kPQaGhl09bf^(GyD{^Rm$J zt;;fI&}Vn#_ENhSAsO?!9*E(!b>tcwaT0I+ma(iBLo%ugrZ$MlCDr4GPZr~ud{<39 zBpQ{H)}v~R5xOURi!JO%7NiZu*_~~5(xI!EHeF%cO8bc$IzN+5?}P7BsFCm>~Ugqs+H`x=$ zu%A9NQ0c`+S|1SoH!pzYOA=|hOh0iRzv(x8i3T@K!v%>pR=SAIaPuD!=Xnn#TM5hn z+@X_5FN^D!_Zw8$VknoD+Fk}3JB2BJz+x%Ct<8aB;=skhz8*e=lL&H_%fD@?vsNxc z713E0D18>7i@0}F&rt1@Z4Tl zV{Om3^NUQK@G7tI08JVXPjfe>$l8r_&Pn9QqL#(>(#D~(qu9D&sG{Ft79O!Z?;T=nxrAKF zpuP{Qt>#|}4Bu;(*5x_0sp{YbF52{&4a!0+g!xrU|O>|cWAGtAT=NH>s=p){Dh0QZ!VIN*5t9i1MASd*Ic39%) zaHjCRa_a6n6$a|S8PZa6T9rR^Zsv`Y3-5QCe@fpyp{!@xOxfMsi)~a5d2vC?CfV3b zJ~|vS>8UU-XbkzlAR71;5`Zn8cE^HF!uuMWD;N*V!-5I>M-4-ior?$qc9(Xe`X~_`K^KO*S>YpQL;WM;tG%spD4xO^Mw4mn<>$ts zUN-L5>7Hl9FUf6gD%F>8RiPRo>BdWq98t53yh|TS7gHt|rXCqfwQU!d&WV;Bzo9*( zP!PF_(v?(MD^qWLWYab~7M`kpCGvA+@j6{<&2h`r>BM-s^Qh2NR{5@MJ^WCORO8N; zmFeyEa)D?)4b~9iwSxB(lOm59o?^5pRU0o;33>mw=s?Q1t=_6?pU!4DK0hyHQ%Mi_ zc=nx-M(4_0Nv~?hVocKsz~C&ZGGOK87k5|&k1*-*dUL(%MF{PhVBN66h*b)iZj{-; z)29+O&>=%}ZYSr2B4K8_f>bKl zws~4~sS@l#-Q#VDe6xUsvzHz(v$E7rPsk#s`?aykbwgGg{OUkgV^PsuzVR9FbQ`NE za}_>9AFp{R@39triR--@EhPG;8^BTA;J>nEK z)9{)WRk`w&S5rz-Ay^UfAdNdk8|_FhJAdA)zhImy#8ZiJ3)+OQ) zD`Sh!H|8U)VPF&-YLwU!_DezmRgJFVWYA9gR-mS(+a~2^|MXWHq01C2o9NTH%Vy70 zQ2zMheu$rujEQgB>3Tpg`TNwT)47sIwNQ7Acv{#fqApYd?eKS8qt(;4hbgo(7qda< zhBi)RZPym&`qNheMGbea#l4}bkZI(qaHS9}j)YUXnFJAX z8jEn6FzkwR3rhI*_twk3@-w?QpZ5yn*s+)QWgfc9CxC8MZ+(@^*1KKHf2n-`qtzo3 zpZx4hQpl?gUqptEM<4UGeiH`4{Zg~-`s6z!Q(35JO&Q`9_svN2 z!E|wlGcD+#SP86G^+_K zaAf*=^hcb%0$Lo&v)C`dtOU>QphH~kllKR`@ssP3H+9fvZE-pZcrc8<#489Lzo|>U z(w#V|hUn?E8yOYPt$20$lT0RD6Kg+OCPUFvq_>(F0mg_5C~_%reiLzccqAevcg-%l zHudzzoGhqGsFHp4Dzpd}(4LVw2wtUy41^45Y6@45x*rl^)j3(th}YcH+VzcU<|N2`N7u`tQ` zpIa;vl?I(OhXqs|it+xqwsOiD&E>qIYRDV$CG75q`AzV8HyjGcXhCN>Z_(uLe3w!= zdPh-sWuJbK6-6I!y(reM%>m+6`|f%*tAR+{ad`3bzWOCsuhk48EJG1*t8;{oSx{iShqY~$AH`79ohHgeiB}A5o9NVSH!;ThmxzV6OPyU64=LfJY{Dg;pT;TyXn<%C2W&D`uV6dZ2N020x!;8;y z5Zsl!=jySzm{=wjZi7*ZFg*7^Z8cs*tezqkm zc>Iu*thJnmr1wLW6j)xoa2GO2RWk&Q+Y4ayEA*3_4GDb>a_1xSJv~(xg_|V*wPr%J zs?Copu&W{@+8w%jqfjA?>2=x#I^7@kfN2R43NiRPOp2STVA@ggzCkAX_1cR!b70sC zTdwt~bafK^iCJ0upCqdO;2WV*rsyYtcj`;ZY1nSjUaSMzlt1T;x)~%mV|xO{H}Bf& z!~zYwNAP+fI94u8DUR>HH22hr#6GHJ4>)t5v=`%iw}pQzmR;+#X5n8h8|8JlTqf}bKYvQ{+{GAy1FZpkkc1_jx+-(Jpd zJJll;*DG}3dYN4i0K+c8<(I@l$zCzXm$p|q1Xod!=vYf^-jqDVyy%(rm8@RcwB$={ zoR2=XJ3Oaag*+2g*j!qHn2ly)c18OjzWj8E^45D_a7yIab{%ofhwU(-^ozC8HQTEN z#@55zDib{G`I;N2GsvCn#D%bA zxqR3#^#*1_+Gxe#r|R83GMeQ&+l^c^bo}E1iynN0@f_`vk0fp}c}>=Y#5RelVJY3c%qg0 zj_wA8h%Q~`Wmnzi7jf5saUT3%ZWPzw4}$-nd+?sR zLpqnrV}izrCJ-Syi(#hfF)g<|nE=HjGhB#)x&s=Ka8GD(N$(QdboO^88qDpxyO@Uv za=D*=SLW{oQl(!(23Ydpe79rgv8a&H!`mu*VH=MO&%=zrZXz#}Cc&tN%rbM=`&gN` zxe0g)DfvwvA5q^~z+Y$sBN&P`;Eu5)uot5@7!@~)XcpTpA7J^OvC33ICWgj}&$qQX z5?()xl*_zO#?hEoQ$QCrluMO>qIBv06Jd`f;y)Dn|7dnNR74IRPh1dg;Be;*Hr>tS zj%=I^4Mm}R*nTLSRz^F#i`1t0g8V_M$wTs6l=EZ2Z>9gB`v3X2gB;~&DjadV01|Hh z>;gvImQC+!_ImKk)bJ1u)Rfn1h%-A9sTDUblSPmAP6gC|dj~h}9hG8#-zEA|gw zcp!?5;`N8;@nkO?bB4vm9Ih=l!m{D!4%XUd$7OW0ZezOg8=W!xV!@O6fU%`6>T z<^2cQvi^Yq)HITt^K-siTcES+oiD==t{ETEN6Ej_kY>dO(f5V7O7VxRCIJ##+dQcT zBF1+gK*+KKjCbKKzUr2KFKTh@k*iM)c67cZ`g8GLuFvdA`Sy$sAHi~Et zNabGYzhjy9LGjVpzss!{z*B<48)*j7NG{2LhHlgPQzc-NJ|e5B4#*NL`9c~)`g8s3 z>Z??>tdhE~HlHp`q#jtPl|Lbg;J+QpAuftGd>t+jwR;P+hmwk-W&a-6i4^q>)5CJS z=D?&aIEv-;bzQdyE7|j4{WwVJZ6dg_ZK4)_^jZA zB$T2{-FxU>d8t4Q2d9LdBdaZMPd%`L--nmgul{}xSjvdL>fZ8-fIYd#72@35f;@o$ zOBp&Ln1TA6Vx(CSMf6qmeiA;?Q#0N__fl;`|Mc9wiQ*{JcG`kF3vS+mA^E?oGRhkh z0aXoW9W*<;j>Ye7>pA%58$D zq!fG4@K)(vpb5TA(A!uyc;ji!8ZYF5fq`$|7JMrTjL-*C0)O_@H8Au>oTa{lh!1ib zJX)K2a6p3%6CCOOrqn6mnXrF|{?aPmkIcr0gm)?L9awl1}A{symqJ**|Z5z=QQVz;%_^BT{*027{8g8TEkkq~Q z;#nvD$LBLRHa%`|w~k-pW!6it<^)&ZKqGDP_+(HE3?Em(PwJE~|CeKr_q%Xxo(~26!91{bD}bf9bNz4O672|LD?aQ;lynz{^rK;mvdd3b-OlK{pV!mh zHT0Db!2)C(ER-imz`HdX#aK;}Dy?Iw=ekh#kyR4R|KP|LYM9sxzVRd;{C%v4^$4-} z_7tCLZoLYOuaf(Ar6 z&X(o@G& zH3AmAIHTO&20oS}8b_%Cl(U8Vskd?d^R2MoKf}DCC>7X+FJaSSpN0%@GIQd=%u!Zu z-q+%(fL@HwiZOn|q=JbjO7BY;q*gl@8H$Uz)1Q>-JS^%%_|}S*ywMA^5f3@kik)NC zIzfQmJ?oeaajN}sJ-gjCf0JivY3b$9a)nPPm)Py4Y)sOCPH75AAS1e9u`b%DR46Ze zf4%g%8SXG(4;Px~-vWTv%^WK6F^By@;-*&}n20kUXmU3}mQ$c0y5CN&3It$jIp+{I zD(m=i_ru%hpyByb?2@{Q2gMmwIfBqmi^Tx2lv8Bff==HJD5?$9yq&U{PiPDD9k#ej zU}D-z5i>GE?CPd|tEGj8J@ym;?#Mk(Ggu_K%xYA}oE#2_t~MVO&zp8HbECnmzhra_lIWJy6 zPifz?`3pj~7SLSfgB>4N$JnYv425&+s}=2C*&|uRr$;-jJkK0;-2)!u3wqu26F&do zEg^(`m%ys!6B_zB=v3%P7=Amp++!c7r?2NzLjz)F$^FDdK$X8P?YCvXo^yFY*X+0z zuz{^D+PmDT@#CxANgx;3AI>j|C*Y2*gAP5_uaa7>cw1F1TZjt&mDS-@I$A~a%S=wp zr&bzx)>`3f1A!}t9QnY9$S*w*0rM^n=3){&BS0Len9$R~lI-hSzlC}tX04hxRaUuc zUF;mbRgHo~7X*8#x$i6X^zdB=d!z!Dp?KImP90~pmw@ch3GFsb? zG;_tZdz3zCDUvCwNf6GPki0bMzT^u0)8p!V^=TP#reNY(65q&{)2HWNOc(^DGLmza zaznD;as_cgq$PUbdj0Wx!_HZW^qPSOc{TqCLuR1pL9dPZtSo`qIaXcj9v%pxk>vd{ zRt9RW7G$RRBedLGlKigk5oz~yDatxNU6bGNk;uQVtBrWe*pHV9-tqROk z3L3g{j1rRQ)*4eL@Kr*l`l-B>f-_I$G2$41>6g#*sZ9v6(d%`G_i;F(qdrRvXDSwv ze(^Y}F;d+=`SJS_RNFV!q6wGzI!fXG`osIihmjpVpE;6TWEuyG?cwVL&kmn>=9s2O z9z*m#&ns%!pPAsu12y!lxqPzo>@lbQwBaS3-$p6%OT#@nV>L>*tX=aHK`kgj} zI)(i@TQj!+si4cy@}gBpbZ4OJZ3{mRvRcm%)2POqiFMrdcAfAf_?-;3$i&3~V=?2b zoY9Fdm#T6tg|ec{G$VD1R--)jB3pO&K+vcXVDHQduoslsw^E8|YaRPU;mKoW^`i>E!!Lr?(5F?^GP{@D z+_ep+of7Zgzb!VpP$U#+Cc|x4o6JaUN>^i(6CVjzAxs*tBvJFkmY5)NwcbND7USdihGfNTYw{x$NNczRydv@BCfLRPNAN`i0M#P%HBf;n`gI*$VhMO z%Gc|F8RVu2U0N}960PuBl$mMWX+6I`va`87(oeGAf<+U$Cnr+Ru|aHVzzSPnmG^%5 zvFQ0OH=$z)`2~=CYy`f$smJIk zMs5+@%7LIW-wBKt)^3)dlVO#YnX_IZAY_{Qm9flBWzh!s8_b~f<952_;{N~0z4%yT z{f<(tS_wei(LBZ?fnQ4+0=s9bY(N~w^r#`p zm-7V|d)q}vwRwdQsWl%2YzQAzJ{)rlvMh0(~w9c!&Z3u#^|D0FurIaA1K zbjYe#8a!FL9c^~?8c9oT*zVi?=?PY($ne-wnDL^}Bfpr+jN6kAyD#kRVXZMS zICyw?O)N@%mBHWxiQ){`I(Uts?&F?H@3F6gu<@5MERw`!RY-VxW;_$ zm%-hUlp`Sliv`iiC`x72x#2e#5W@^t;1^8B4EGKqV<~CrA|BqHA3r!qm_!cJTDyHJav#Yx*DCfqT-@4zkt2oK>Nj_n zMs6a_u2cN|hx_Yc;=>Ygi7L7_023i<#W7ZYQWLUa6Qqd4V&@z$<8+X zcpCyCEm4M5`@<~SY?1DlQx8GAQ>4<0H|GOPti7KTbw5Q)`Ma)k_SdTa{5c*;kvAOQ znZj*xJhuz2%-`Nm7nd#JYn3lyKPh9y=nl+}ov68|8@ddTr$kO^q+9HZCqcantlF4DvrX!G%A+o%aM6e4J#Z)h+k9 z;!k510u9!nc{NjYyb<*%S}dAtM5!Fny&scJ>{?o=9_jg(wLS7`ufOP8y$lE^sG?hT zO@~OJ=MEo(gZnMlGYa-y*$Y9G5`Nr1{k0y{IrHh4rlTcbLF#z4K#gjX_nkFjsQJm% zfsSAFZz6PNvhI`pChVt5xU~ChEX})$R4lYZ`>Sc?w?5dbV%(G=sw)_)sH*DEp5SYW z@tD$#CZe$>mGh^J65mkam0xd+V{C`*^7F4#rfJ1hv~W8Mp6?HGv7YVJHLrV3Ak`AO zh09B_E@EeuY7gVby19o{MTL{jgt2&44u9v+OT5E|OzGb`@{B2Gh!-Ee5tmS5*b>!v zbe9toTJ2?vej@VTtBen#PlEXl4J3aRz3(zL4X`Y-J3A>pR0Rc_7yG9V1Ps`-)r%g6 z3D~{qK!~A%s3QKU0H@%G;etV4U1P4Tl&L^!Ovpp&3#n-hj6$f!YTIKesrD21z6&kTkIa)Ba=HZj0W!xPrZ-DRy)AE z;*i`CP}azLy|{7ja+7{BHZybIy)yAE_QRZ+p+l7k{zXF-AVOuT+F+4Uyl35c>8e9~ zg~U0$n{95;E-fJv%H|jk~l@U+W=2_TiKdEY@$f87A_ukSEU=?L^ z7a~=u-u2abNi~1jc|pTn7P2{KI^a6#Qd#!JADDKNWEEOj?JcnJ^O4+DCG0m7G*VGU zVcRX|UNO-B;3(F?1YQ-fOF`Eig**Svm(Q$765etBN8dk_=VWJlXx0~p;oz**elu@# zI-j+ViWZTCp{wF)Elgcr&T)<#R$LZ{;OvP^nZ1oIxZYJtwBX#&8qaF1Ih6`le za_G&sx|P?B)adQ?MT~jAVg&5Uke4g&SBHncinU|czcnLewpw3bkK4SGYVxGAW>tNW z*MJ$#?zm%Ao1|N}#5=8X%cJKpiN7QA#A2PM#A-A5^OHV)NZRL9dmu>a8$K8m{X!v~ zar%r)n>Ee0&!LxHDY4f2?ol%_%2VP%h1sGVB4*td<$jKP7=$q3<>!U{x!Qid&5B7t z$+hjv9cJ-{meT`dQs!t<9LLj7&FjnjIxe0Kx_sr5jg&{y?A%4ghsMUojNtubzq;U7 zdZaUaD^Iy00-e3o-Ejgy$?T?gqrh&R^s0?bf2zX&@<>yE<=lmv47o!Gtk53U+6PN) zrSVtH?kO8gU!N7cTa&Fode9+Zrr0lm!cOgrn$}k*Dg#{ye%6?0r;}8=%gSJvWus-_04 z3546-Ny)vS`ING|XMSyG`ap9;d!3d|`t2b=NyS4r_3g}TEf8+I6pqPQ5E&b*H?wkM zHT*SPj@(xnV3bx_-Zw!lv%#NN@P)E)N@Y)$+`K|`Zi%_*i1V4INpP06DyJLUwhVJv z6)*6aM8-t4!*{#mjIT88O}3p_xI@OJi9#-}AiM7h+>40BuQ!Xzz2r5JWInw>ZH#%d zBk-J>)E<&in8T0OAG5_-i=x&7mTEwMt@X9rl9u`DD*WnRi zW8yYoJNI|8NUyI5g(UJByee=JTYqyFa_`^Lg0M)|hixufqm3qw_O_i1>)bX?2qSr+$CQ05ov38HF zeP5WF=I!%lN_Kw@=L3wepG($HI3`sV7j?L_0S(2_G%i#9%cCregq*Dw5ydvUVKDfW z9?YHX6)n9ijCa#?-+Rnk=^bwsYbWzzgx@}1&^HOA49)0WIi)NiuWxW?6`#6zr+)Kh zsqOHhD)0zrP`9$>Oy$SHW#To1WztVS*<2>DlOcz&y|C8Ajl==;8TfXX2kd^zecIL_ z$PaDA-B+#H@ziN$M{?XjrnT{FB=w-|5SZRIT`udHu&pDnZA3}rA|?Bywj*|df|v(q zq3d5PKn??ocJk!-^dZbL7S6W}!4BISs_( z#!jRAoj7)y5`1E>a(Bv6=(IxTHMLddF=O-Q2sPgzTCa%7}X7z92h-xqpcI`0|HjiK$U+E21 zy6xE_7xIUF-n>(YTNl_H(_86EBviY+$Sr~ASU1AGW1!8eu*l0svNbfD4#xy};#Dub zbWk@^hDNjB2+1h*_$iQ&&2e5mIyJAu!l!pQxPB1fWlyT2#PLxU;d|bsA?OV?)tcNW z8*QHTM^PVBu;j=OVhM6*2mqDNSeVzG+m@>t=L7Ip4D$fZM9;gQ4_v0Ubc!_ z9g5y(MT3MPe`L}GXt9z2%mz^+hOC@DSW>7Jsqt{dZ3K=e`+$-vZxuA#^v7KR4G#qn z&L2`FE*q;zSZG|ROsZv_sWxrJ7tPoGd!AxF+Nd$@{;=;ktZXJiOD}})LLQ^`I>#b| zOiG5GSL&KHZ}*K*i!`v?mSTS>8J~I;5x|7Q0Ji`l&!O1#ZyZ{=;oj5bPeBmQ# zFP{Q`q+%frK|VT8+~*Dq{>6b)(**Mn?*ZM(=WoZ6vYr zS03e%iQa)Zk2?ZVq|3_&zA(k1UYT-cZ4<<=kj0CHANO1%XZ>~b>&rSGQeo-WIkNsW zjlCjy!0ovmlW11t3j|K@O}*4ri+j7;hUNJP@J%CAb^Br8DS61XLdV(Xhq4l3 zg=oXoqgJeF5^^=BIMJgHs`Z%ZdF4&&(=6n}sWN2Aw^zH%x~gEj-ZjB#FD1xWw(>9} z!)+|b4WZJd)dD0?72li1kH^cs=CejUps0g~dXXgv2>sE03QU)btD1|^Gnf*M_qW@u zuVl)i2UyNMr~P)@QwOIAPN{7^Vdb7|S{eiJ{!US61CJFA!m8osiO+cF=14uI=d$>@ z*w1#C$Ag}5tNaFMF1$|-wCvfo+YTMM^ymqOo!gg`kp06ldH16JD*5JVKQfxteuQVK z;e&%&Y!W~l);;m6+wp=MXf0*!ljAi|acL=+E;KOJif^v6w|~W2YJ|}GFGx+_Z{-UyR2= zdkaPDP=T=4(DC|3cKZKs$NZl3g3eYM4Eq`(_@hp<_Q+(S!!JqJ?1Ir zt~xijAb1*|)UeULY2KpTEC<1|2?<;e(bw8M&CTQ<1&YvOmr=2Dmx;0O<+5fVXBd=X;Nvli`MP?_(-K#yOw8;~)&EsbEs@Q+tB+GPEt2i$*~JtOqcc=BSRdUHjFgW)pQMh9ysQzPh5+oYL3(UZ&%>OOHV#8v+r zME1|R=MpZg{H{6-0n5ut2W!Gf`d+t1%!tQE6_#rHe7~E2tGM{7ZKm+4yX;_LA%jG< z{BlJtD-A}n=}4#8JoW&Z)7l4H4k8t&=vO%$PTF+nY*qn{#c#DIj|UC4zI!h{peKg? zF3OrcBi>PS?dKa&mW8L*F|6jkODFf)Hpk9R`tiPX;My=!co%f%G|XG}mMK27c$}xG z_v1k$M4y{>{v1h2SojGV!9tcKMe6318mvYH`xM$PV-FMeNo9?`4iMC<$ZV!et=P|_ zKOt2su$z~H<$h)W=!(;IHBj^Slx|>D8j{8Su|Lr+b&vsF;`% zSZ-=@(B%g6he!1nM&nYY191#;R>@q=4moWWnnI*28a`Ot+p*^Li-k};;2f}$q=Z?c zm)7qHSZqYy)8B8lwU)g)7_PVN8D|k4jh!UyM)y4^ce`Ng`l*?5F>DqxEE3=B)()UM zqaK>KX)h;$ey4X`RZ!^js%hdK^=ufnQ(4Rl$dp}c-#_h|;)DtPQq1Zn>l@jq!P(=0GsHqK&@qMa7(*>59 z8yJdBpb-lte7L8k&`_AJRHO#AIWo>A4EGDc1DbHFk~oWb2^Or8uf=6bD~PKKds&WE zn|EeYk;(%ln(ofE&SZbst?fGl4X;k(F*LN@_EnO~fveFJUBl43I~DgUW0}lUY*{0X zTxL-0T#qJotn``G{d7M@R^C1`!Fo$2x56>^NOFC%Zlpw~`KT&rE5KsNEd3(VCcI}0 zTB$M9$EWr0Spajy(?ftgO@eWM;j0hvLOs`xOF8tU1bZBu&T~yTAX-_4on_+NT#PLJ z)rOL?a z6FWC26Wgh)xtC|%UrUn5_icNZEsT_Nx9I3~ChdokEYn1+s)XfBaiVi3F`0Ri$DQUh zyyL6ac-8z>slS|x`Kr&$Vu?G4oP=1YvyHyBtyU(okK)_18@e|eJ~moznMo!|CBThc zUqTUn3N^T6R4ob=+bI;O{hW2VmxWi8<3Z}Cp4nF+gd>f9~Ssd#NCd805xxb^&$n33Hq>||FGCbta98Gmrg z-mm5z6<`T<-e@O<@#2&VL+`m`>N~dO>$Df@Ls;m`D-a5!GzoT|QRvY!^f<*2&A0hLIicEIoC*~g6MrRy-qVz( z(x!LqKzx&2)!jsvK|nPuh}`qL=VD9j=e&w#;ey41w`F&$k{ousbBHMR8+9JlhtdRz zl@QTNzDwJ%;@21uSeY-%UIHH{Q1DJO$KWeK=Z2ua3C}M4S)YN``K;g9f@d5Pm|Ev1 z@Kfm)us%7{`yxO{5ylq9=GHw6e5_5Gq>%yB!so>2i=|#R$FTzFnRaw^diSKWlYpU! zNT{Emo@X{@>lL+X2_(%Uq3*}?wZWX5K{j4WQD~H{tX6MIsgBgQ*pD~oo6iUchLhOu zYcQr_Mhr59xyB>tIo|eF%54)^D4`Ok?HCQ@X*I9OT=|}kPMW0?oL8Y$?1(tD(VjO~WNK$YKPR*+B(@Y|SgHzQ)oE1ZPn-@jP2~`|-`eBeP87w9%e380q9W z?NTU~H3qCMhc#&2%{bMN5YPQMmVVPAn2no}Ritd^0*Q!7fX`t1Yrqu}!H|r3Dy_}C zF^-Zehtg=ra!WUXdlh_+RoBfvqc+cbvHRN>arx6zd9D-9M{3i9QrA*W54l1Gzqhwtp%fD( zJtert#sj09o{3Zu`9e)@^6s4`(voKS1r>$x`01CP`_}vi-$UA`{j-Kql*V0B;~}t$ z)`y9Be(1|}R>#p1u$0bilu50(N-&O{#5;{2?7^?V#6W zQ? z>*9jr2Siz6{WAXq;)qSd(C+&JT@wP81 zKq$A$EIr&hz%|Z*$Z47N<=4VDguGIa{{R+yhrrNhxM5-owGSAPwIt(o1aODhXcw+D0JpyWrV`l>o9$&MFL6R?G zi3})4Q;dgZv@@79}Mtz|7i(q{D2y9vt{65`XjRaM@s-X z7OWuwp}-^gGd;ZBeHhV#%Q~u?V}`3SoT`nM92YlhR)RTKmeqjk% z8;F5mu5ZT29?!Ya@1JplpO$+j1*;{}t_Fe!ZM#3?3q(|-5PvzA@=oX2Vz3rqQ>$m0 znP&<|-?%rp^Skjhg2HyPeHyUdczVnnM))7FGXWTuug+fDlT_kYGfbkc+FIHeoEnwo zr+xx7km)gZ(me4G*m~)oc8_mHQf)|xaEg^&3qdY1OO9>4l5GFP#=ZQc1jC35N^LA- zTQ_q&P8|6%9$i}(R4Mg78)%iq2P*Oiazo}X3F|(vtCPpxH3-*b01DtSVLdyp-nb}}-$>qUQ|4xPK%a|1H-JZ(!&^ zNZ75wBczuWu(sYqul6?nn@@Ilpc^<&@IScm-(2cL25VEBm+-zzU)TYV%-dMOH?<$O z-?J`bfigXhFLa6q%Avau0TC8ZvwwK>{}zFlpR`~{}Hi^HeUtSf{@?v2j=X5b_Is~YOj=pE$EUS^5|U55!>SjSIsB@Q8L1{`YKqfz1V)wh%S-;l(iKM7vb{-Z?y zu=ff&So0eE(xEEB%8aK4+PAhA53cXy4(Br9P!A2c$P*{}jz9`T(cvq~z`oCd8_+lR z2A0fMp@0$ue6l~3=fl#xZGJTjvFK$&-oSsKgSDjIEYA}&KYxw~`?wv8xw(0zvkjS@ zz4J%8>uN18{}9~%T|OA72Q-!q`8GGV!y)gb?Lgm=k?u*yO6KX)Dtm<=R8hVL$Af1h zsbf!yq%QdM;BPNI{Pj{{!^{MbBYebueI4BX{xI!S2^zsY5mgV6j6W2H`0BG#3_0z= z#iSBpebZl9T;9LvEE;@${ixpTde>JF{yb)tz`*+2GT7+$VzC_LCDkT@zwO%rkNlso z&|l)(k&k#Q;~oA|>bl_7mzU_sR1)thjPYg7Qx6R=o!2y77X1JmEc#Y;YUiO znbiEaSLFa{W+v;DU4-j9W%#_`j>JrrBU{R%G|B?3o8p1uOG}M9*dW@`jSU)Y`{DRt z6wLk@OwkwO;#u`lXJ$gqfW6PutX&!sCRwm_@u;Hr{0(jk(o zjpgrj;M*}TbVr#X2=C;u_VO0AAm0>fv)LY0E?Xy{oCsrejK8wF0_uNnMQZ94#sN_W zf=-^sVo~y|{B926O{fwvo~KX#_qLtezS_}+b;s+qqnr65Qwj;mv8B<1ty%Qya76F6 zhj+9aw8$%_y>5umi8J7hd3MrRbUinpkO*$gg?i4_d~G=Dx)K;R%`EGlb0ikXO~hUA zkL<-)(+-_VFd^Z0MTcHbr?Rd)Zszg=_K0tmr4K^(F=qdNxaU`gmd^*8&zLew+my<@ za|!*Ss>M!_u$@LYVqQzKzVM3V?_`U0kEP-dJicDXS(6*VdLMpEn^jwHS@XGhn%jZ) z>9fR}GT`dtCr^5n6hy*iW|A<>G$K6`Ls{vR`YcTUarSBzgH~?&m+K0MT|6FA7WiTO&2t^hJt3slU63#KytN zR^WdA9MnG|92_1ZeV#Nncjk>f{cG5lr|aM_ArCWxynG$G<)bG=DA*=a-X2@Yq6V;p zA2nK#m8&ZekhMi3aqRnd-{wOXl=yfR3|pGa{7g?oj$@^ zS@5E261nWKVOMV?je4uA>w`?Dox6znrLuwa<7Ji`EP2EnWUYhs1Dq!c1`2y`9!_(cdSr@8=E?5G z(6fK(y}>8%>%<%(tP~O&g{<$Z6&+3CE!vW$COq~kZ(4yMwpLh{z3{eKmQT|GJyPf- zj$bfo5wqm?B#-SMI31LB1Q_V>=a|qN(_6I>Ol)GZocrE6`}by6oz;zOE6N^?cWHZX z|GRSZ`Gf=Nj-dzb_-7HR%deX3F*2Mz6Y~1_`d)`og1)u(;@10&*MXYaMvjuRrl zQ_Vvy$=Y@TggctjHb)RAYMB9i-}>)9mUi$SSmFWfbw_wxrR6t1JTtFyk27kzc0|9j zdbrM0Jw0fg&~3gaJ&^nqDUp|BC|s0b|5#kl};jNIBtS1`-01B?cXc^!Rokzb$Pt z+XD*A{sa8tTOXp?FyD{;R^K&iW`LTi8}u&@C7HzEDGnDh7ID#&Gy z?W@K!A#&&i&S$!0OogY6JbpbN{g?VyYL#W0$IBZmI`&g8L0g z1y!67Kf>x|ePNgbv1R9<&X0NnEs9LW(GevlO;m;*_4LfI5ty0EN37~)wxt9mPktY? zmwHNW(6Qxl+j?4&g0Z6df1fVUEe>Sl#RGa~3I1A0FY5bI_r))~f3_eiX}l)i;?L+0 zGZoFA3Qhz@cKpP+y~PCB*#73DJbvGvYJYmcYUp(>=4o^jvVJiwOF%Pd1W(4&yDkM5p)ZqB(yeeEXRhv6dZza7r;v%1}tX>nvj9$v8mo?ZT@g zBch`CGwUm%_$|dpt0_UNFOrX7Zm+~ z#J+w?5sQ{BpLI%AIf7S_GtYxlohVb9k{LaKC3%%>>QKKgUg50QBcodA{ z&Id%#=)bR!JK#6Tt^rXm{(cLV(}=kmbO+nu;eT|E`p?}dY(+TAvVVUCb}@(CmxJxfnU%+ZQWPEj=YGJDLZb&jC={iO`*b#Y zn?N8HA<$H{qX4y4UD{htPLokoi;#L(`G4EH{|!(=UaoW3vSn$jG7{{?IRe)WG@kq< zj8kK_OlZbtruQXGOdbH&HSdl;8`GE)7g|$-HqjhC`}#CFBl*+S{?j7Hi=4R`>sqNIcU3(mQ89mHX(~pTuErB)Jb0EemcdIHis0_iuR%#Ra}b zNgTX07z4-e_ZWS*@gT72iESsXfxp5gYEIcXAJtYBeYi*^Kg_YJJWpa2_?)UCr-zO7RPVw z!K5K|ztecYz3pS)EdV^N^^MKrhQrYC5pikLgx!x91Z#%Bbk0_NkeL*ZWCw4DbILl7 zc+}O~w$2$^eynQ|ok@tuPOji|`aG4sZM1f(TkI!fU5Z@xyqoEHL7Gbg z*xG}(r#}5UfxLP>&!A%==f9{?l~?%s zuYHq$XaVOTfKWu~zf)*q|EI?Fh4qGoB7UHF__BYgP?hqN#h3G)=Z5KrocbI@Yz#%? zEy{jwv=2Yr)DpO+rr^q2N`^!J&Q&RWeYC7fESbd(DCk~7IS+uG-r$8fB> z&|*~UbZW*LgrAR^T|{HwcCug3g!HifN5FmyjRK~|oM2Bj_h`b`%IB~34V=lze<)`#@ZBGEr~eBfs6o;9k%$U^ z(RhCXW&&WM5g$w_@lOOK1~>)}Xwd7Rtn9k{>BJKrpBl6mlK&x+Aj1KU@Lqb1u*T4z z&N>NPl$-m?Z36MWLVMZQcLKiK455((;Ns#rI-9Vukz)g<@OPK7P~;tI3mGRTr9a0OCRdplOx8nrBER?^ASiX( zu=FfNJIo4s_f9n=LRnneU7ED!@#wgER!PZtl+`y64H_DncU+M40x$HS}%`hW_nn-NJIWRbwd8i8C%hg6h@`E{czrL>WNb(VCpbvKc<4B6I zgj((RF`$3<%UntwTj`JG?vLNq!@rVb6+Vm`=#0(VWCNNeY0QV6yENP04CCNY2rjS* z4m40<*(`U;;Ch7qE3+d9y9c_(hCF!oPSgsA3#Z+`O9d!`3W`qZ_rZBgcfa%P*K(o+ zi_7O0_SPaPju?8)j4)m{`B;@aMRbhQ~U39?X$#EC zG)Sp}6Vd^iuB!*W?S>P&dFU;Ab3{@yACpc4lmGr9Ff{$U_t+Kx=YSn^5FekdV263O z;72FXJjR(&1BA{LWu(6HKPfs7!sM<7*W~e!t#l1!8cdF)iXv#U!kJXt^^3WObbbad(- zJ`grbj}^Y0d&!d!{V$s+lD})~4K#M*aFx~<@>tPTHxA{~yuf}Wn{W%Ff`Oes=la>cCPO?z=`iFkUzQTPH zVQDSLy^2HoWX@ps;403%igQs2HP8IeUn=}!+D$ViI9T|2~8|-_3>GGR`6I`V&87X_V5n~nV10>*7eUr z0{q+eu1Q;)K@0R`qkTx-6L~D6n%!e)Yb zA!kT|L6YnKgVHPv+A5(<>3IW)sOR2Mx1XS)RLTfwq0kTnQf)Y&$#N>xQ0TEZ6ibd8 zg_YL-t>JkZck;Kdb4?B3W^E?7cZo&6SLe?sHZ`2N4Seu_-)Ehna=E=qiZB~|AI{h$ zxq;I4BbhO%S{0-9LZfFILC)S@46Ur%&zB~N@0F6{0gVK9Xk0MH?k9%GjTPPbV^5FG zln3QyUZwCc^1+z9gd;0LUtG8!DI>_#hC+iW#A& z%fVRmB+#LEVQme`mID)qo6*$lX zB3oqpV7!gKTYE2eXpP?<+ozimMT_<)%A{g^Jc(HxpocK{1UOs>SOJOx{IGxsug?HW z8Ywq`A|OAu{$|KKUhzfttlghS&7ZgE8f$%Sh-!6pcOIG8LuM7h6Gm)LxKMjNXA1&) zP;B`*E8ywU(rClqt;dD?8Wj#^j*P3!A6Lgo9dzkd@`k3GKG|5?qmPb@jg?eUDVwAZ zd&(Fx{N@1z@~S1ggf1k!NQ{vva2QubSNFc+gJh`~hxW4oIt+s)FOubu`$bnzzQqT! zp@gz_s9gK?$ZZ5aTX2?W7IwbSJQblO8BdrMTQpYhJ%+eve(MMoqB}#mX$)C7#Xd1Hu1P4Pqi(aF4@Y~^UmJcq{6HT; z`R(Bx*ROkX13#k)MYtsx^l`{+ZHv9gXhg0UR-@W;MhUFmz2``NAM=|7S+NmjV(6#c zdD|*h2xzzgu%10X0*Lh5U^`; zLmOm)jr&YILwIuN9i* zL@oDZ&Ndtu2M6^) zY^(bleX)-@w4_lfOLXpg4?uh# zXRf#hdbJGV{t5aIkaHSpBwS+a(sX#mWY5e*Og-Jm#42_h&Hg+ce?2zr8l|=h7)mh; z7Q~Q)UqsccVMnD#r-VD|AJ>)Lclm{!GHW&Gz%m-Gsxy9KSm%$Y#^c3YSyZIcvKSXw0J}7AvOopYj5}>lOV%Byo#a0it$P?eC>$+un^MTfvL?7XOBEGC+o^5q#k14tW z8##k%4kf|YJ}wOt!ADaANs?LfFZ(9F;#k$Rf`Qxu& zZ!8Gy=w9VFZ?H}j?J`$}sMjO~)w1YRSUDY>oe>5wqP)Y4%*?iT(ZD}n5F_pf-AI{n z)Jqi!xCoeu;Sr?9#Vb~u`Y;n-_dJSzL3`d|oySxzV#S)5 zY^oUp^=YhSxTrrCF*jDdbnw_dQ=m^Wzl3A#r-M3CF#@V4J?Qc2jX7xiP(0U5G_NFb=;oIKYCS zu@GnXph#yeR9fl0eYq0_>k-;-PxBPU3OvojgSQETs!)dhDbOWXA0^MmbJJYx!R+Ez z5+-^}ax&IRpE3K~XLhi!jRw%=Q?DAhK5)@ZU$#sk-=JuRL)56!{DiWxXLa+2qSL2a zxr;s8a=Y79gW9gRAL^dAB?T*H#B2#NVJ~!0P3iPhRWWpkgCo$?^Bu>6a!IDN@^$Te zPHl||X3M#G?1yls6?Q?CM_w@(v;cqKs9$&1a-JVIznWWA4#n)?Qm1PtG= zgit;&j2*4BKtr?TvZoZ&rSSgx&nN_#Ak+z^HXDv~%9r7Io#>&Q>5d^%=fEafp@iz2 z!3Hlh>{0F`Yt$4HLNPYK-akiDbZ&mZt0SPX)X1V8SSrR9?n|ZfdhaOWr z6~vmYNQX)(&>m0ZHkT@?lL@_N&%j7$bct_v*V=EH$3`Xw2t60UR+S>JeckgZZ4T=6 zv`B56b{UsD$4_4h|7unczBv9Y?wT?7A)nuZu{6^I}^Yt&Z;E2cu5IEF0R}IaYB`uiH;>)}FnalaDB9lHaW( zK??WOf!2{6t)rLDEgrp^43jQ6-6NRUu#EukUB#DZ6Gxnzdyt~>wsljC#EnMpN)36uRx z(sTLx0@1#Crj{)I)wPrO#%M*|FOgp{XkHdvgbvP8Fd5Kf z_Kd!rmO?rWWuZytMZ$TXZ-AGF>Um?-Ey>5hLDUcOr8oHiO{ZGNnwI&<%*2FK0?&ZP z6n61BDX6?2nw;^~sf^t+cU@NX4dVIoljU5{zC+xvJ6M|l-GbL{VUVkZz$Hv|X=kdU zGbT?+W?Wp652Ds%ZlW2-MH3AWO7_errw@LW9w%xocGHF)+ku9sFVhgT+jqip8r=3` zsW2=GytqOQ*80bE#m8M@3h$h3>6Rw|823r77!3_F8MD=b)Z~8*dL(70MK?}A$8#yT z`PL>W@IKmxvt$mzI3j7#=v+K@B8(yJ)n%FTcRgv3FCNq5wpkg94X2vic$(!5nY*)9 z=v`VxBwdnxJYT823)fCgM=;5ydrf;q$Fju?6UQ~f^oZx@iUB0(HQj&k+d0R)vzDRI zs&;6`V?xll<4Rjr9z>9;X4GTq9s;K(6FvCAK2-(Q_Toiyo^H-VBFX6hhaw)-ZR5rnn30 z9DM^h8@TWcqsaRR+A?^ld1!g=FL@mkY}l|)Xv_6QGKoiLTcBQ;7BjFWq=F98%!66x`4E*9nQhpznonxyq>zDE(qrREqI!QgmKC=nnha1tWxX zFkaFYsR~5DL-eSl->w%L<8LwuO3Cf=ZT1xi5>-)%rZvP8 zv+Byp^j+3Pjy+6|)V%MP2l?r)VL;9uZfn(`8~o7?@KtlSz{iJo3ZJ;cvvG`(a5)aK zE-sJsd+GX&OzV)znu8yM`-WJ-5iM3iMKL}OIr69Pobx0nFvxzzOc3y{Bosm0ZG#c* zpjj47()k;-9D~<}y0~DD ze)9eseN?CNV=48+>r2BrJCUA0ZxFYTWBAbSqbEhowi)ZY4lN#fMDafg_ZLV_SH*$= zB-Z)Wa_s)!tBIT!5}^C-cYks}2VY=cynF@twHe3ZyLyob+D(>~iF%UCu6HQYq_SS11`gaFM~6P!=2pJ+@SM7qAjcD?a2MuTJxCvqIQ#XT z?F)l}#J@*cB9= zt@XLx5TCL=JMXidQp)O%)+Ad;j@tIeQQJngUMCmv(vyBZWlF~_tOp{NS596cmp2{P zTR*O?8yycYe%)URV3wIS|DGWZgi%iQ3I5tgZMx(<`nGy6?+Uo_(9+ZyLt8)FZZf7M zd4j>z$(E_p;a+&++NO+$&l~x@=RAb>&vOS_a=qufy@>69+f(nKdrB$BC5l`^oWP`e zFiWWj8U14ZrCBrlU7xxPbEFaTi&|#NjR1-I^!@4^AM0oK>sYtVjjIS@vmNU64t*gC91NRGyj!oy+XM=t0~L~wM7p$?B;Mf3nlTj*#D5 zU(L_KNMX_CuwSO(w@1-RyHha!GXI|@{qu)?^`AR5Pyt8E?D-a9(wU#KJ5mD(Ii0nR zO#kuwfEKcFg$)75F_qiBjn;-n;Opx^746?1j7@TzfvU^TuqLAZ`zljc7E<+=V`T|XrVn1)BWg~<2@VN$y_7Gd%jk=Q6gM2!GK>V@fe zJrf~b=?AA^JvIDssx+lPXtd{Lj1#)c!sa1qfx!p%U+rw}4?6?&1``>~3b^Fm)d%0o zH$TB`5%DX1foH+C0OEwsaFBCQKp>* z0P!`M5x~bSlZK6f^9paQ0HyZq_4efq&RMe7m-kdaw$S|Lpz0toqXM}7j74qQSY zZeSqlxFK@rTIo%0A+7!)4b42#Omee>SLLPPfV<)B8yiA2avb*8gL#@*a}_BE!}-Ve z%C39e!aEz=e~A=OH=KPUpr(+GATx>g6?7O?AoUYcg_4JC@SPb6CIM!&N3@@$SpioF zY716KPleZKh1S=5x5c|(Uk_$FVM3kO7GU;95)XBor*L(@oV;!}*_BY!rNpy~f~_jA zPRD#${!L)=hbM`EBb{7(oWOnZc%6&_ZUL$6@;aYmd23tnZD(842<2<$i%v{A5+1qgT2f}Q6^4!4UU&#xxf_}%)`ZR zl>_UTQv>btCUnuZ2$cdotVOf}&49rx&VWL?F)oTo;T3_P9krutmk@?rs|)Ai@*_~> z01>FiH7$d>NJG&jK&LbW5CfioI_-a-yg>n!T6L%*(IxWL8*0IR_y8LQ?GLeQSp@lgBvkiq*0kT86PU+h3m9bZyMDN8?hR|IuRpV@ViuSry!EJ6H=BJrl z7{Jd4&r{V4n_POz{n)W?sBc+@8e@ssgv&X(j|@0iEJwL!uXX))S}8#BK&_3E4xE}S z(F_Ke@&)#b0d3S-bG9HxAM}EJUJ#$>Hh0~Vta+c(ZGtKFo{lPM__xX^y!-YbI zWk%8i9F|gKOK?0wus{3mt&ZmXc|yX>^Np)PG9Q~r)CepZIz9rv_XO?d58q+!*e8&` z)6oI#5v;Zng>y47eAf0?4n63|I%1!eLMsAl{Pz*?52&cFe5fiOrH=ZQnG-W=8HTN`>UOVG?M4n_l)s6wup&7 zrXn)=DL$cI)q6Ig8PlsI;_&mGpyV*Ya%^?b^8KzLgv%Ij2&HOzO9?H>p4e*{|9ZkW zKs8hgTp)sU5e1K3(XQJUAeP(dg{+hMwYat>pG^Wtsk;qGf!GSm9@E>u`FVVHa=V=< zNnDE;VaN>AGYAuEMR1=<-8J#uv8TK{_NOM_-XWI3>B+NZC@Y_LiY&u0Wh9!!r{gvyT{3)@uHg=oqGw`aGVUmEXpj%%JNi^ZS-j28J>qdn)Rj%+W^4_=uE-WcX9ATenB-HxQ124gc@4yMI-dk zYCJh@AHLyz1KQEjID|jGn0ozH z;S=kZm*xyB)@(v6gMUPckOIt!fDg{+m!E=M%Xj!sDF?YQjNq2ny0IxMT=6^J{fd4Z z(7x#Es2-3ZxZ)m zvx9}^{2mO|rW;9>^u)T=78nNx%Uy3Z0~PhETXWNVEOE3b;1?=?m?u{Sys$_tc+FKb zp!TCP<8!y#5BB@0_yna^I@P=ELV8pz8u>akK{9Q0tr>iDiunw$5X_ZO{9}i2=-bq5 zi={KXUbH%P$rfs$;+a2l$J4Ds3^Tcq0`KyCSJim%#3;~g-ruE+E^lQTXMRrLkC=C0 zHQb1Pzs{QJe4#g-yEF1UIwK4 zRY_~tZaxVi5ERE|Nqb3IG&*EC+a!M%)(!5$dIP3e@Foz}LDSb~k->qYwN^r}m!hA! zZ^R{1GZz z7vFI#+%vT2I+xG{_Pm^51fg7keGM1kp4RMxdK4O98cs;9`njs*7 z;Qx?w`fC;dNDkt2)1oZpphDH>{@N_9D4=-SHGyM$<`KcoqaPB+UvwidCL1#PY65R^!<5g{+z73#caz}>4W-9jt-NG%#Tp4x8Ju+GdZuZ+~ zxxc0Yov&X~1i(ssuFcdlU#Z)JT1!KQ9Id6=Z`D>Pc&T0GjFgd|e+6u7SPse{0-D7{ z%y<~w#Mq~k-A7tLxThJiEXSjpqUaihV4 z6JI8>7MEu%cH|W9A~6)}YK4BxiG5SjCev3UC9h38`lJM=K9*S}$C1uoKnmrQXkbi6PvKi6hXi|~-^VcWpOcx)K8STC-~FsWYm zZ@_*X%Rvo9pf|iGs(mmsrea-~IU?v0$_k-FiJHCx!58llCS@r2t8HxuSKYf=`Ubk_RvA zRMODO54}d#1;t5^@dD-h_gEE;9*3!kfLzJhF!*qDZ-be4L2_k2Ssk6sV~JA^?7IEY z2*vkx<58zP<;2Qp1+9HP7wjT+neRHSS5QkXbH@+MoS#!SFd6fb<=2(48jbf7>uDjU zTQwP|`odi-?1;Q1gI`*5G+y_Fv2!5z8&jTBo!x8kK}ekD&(kP!YQblNjS&(qMSBeD zMYY8|Qqk3hyY#zGn;cI>k^PO7WFgm~05U^$h@dlQJ}yRaH8BVUR|D zVjh!Kkkp$iO~&nBvRDe{m<39||G&uq2WXFOVH{kvUHxLmODe6uHh?Fooxp6{-!>n? z;mg--j_lG_%+>>5C&&_xT3QHKafAJ@A%g{K1+wlF0f=!1M>C4A@+drx^$EPT9xFrx z^j=!Gm^6U*i}|9s8L@EaE|ICqEaqSxgi^m!!Ni|=S$Dbup@>)Tq=kTN=ssKX-V}BQdqC}>3RI?dqA%@hFn8ytO(VwN7hdyl0UKOYjRcmxqAW__s$F&dBe3zfSmr4% zRd?PYf@Tu{5!iM*_%QVYDgpGyXL0wS1~vQ(UH1NV(IXW@JMD!h6(tq+;g{#*NXHwGTrI@8LfV0QEr6=@ruZ&1p&OQ zEyVf~#6!j{EvLAvLB2q1BrUykfL$)JdbiC5i5d^_e)*HSj@sopwVZWLXV?z-OG0PM zFGRW&r;W@>BLAYzf9W7lbKHGlQ1yU8*;U;T)x-kR)CuRzqa(ej9ho~6Ie&*D%S~o< z+qI!Go3R}52t9l`bDh*6iL@sJkY4=*Ah4*xe>IBv7Q7Ku?V8K zWVC3Q2VbC;>H3vd_zoK_{` z$iat8&u3Y=7jj@m_sEZ_NxIr@5yHuq8=_M;_O$&$rk4gCVH_cpe2=LfHEx&-R36B_ z>CCZJn9msW`5ZxG*D=3EW!CP-m%S|a8_fYIEFH`+%l^8W0~det?++I1 z8E=u!B11|QUxnHC)t(Sf8hCXqpWdlFK0N@+>5Q<|Bl!$2@*h?kxj`@1t;RxPM8a&( z{IZw0(6ClAo#FSK(sB1VQL-{RB`mJ2iYxUKytdza6!T1F4V(vKD!K;fBZpB^buroP zz=nt|1Q=X9Iu>6#zGLNm>$1_vUB{4``ijxwy1;h8Tn3>mqf%Ru2L4%bb`gohman*B z*eNE|QcsLW#3Q ze&otX zBA-8DzKYg|^IxCfJG zdTlmN1Q-tjE}+Krb-d>P0HEr@-U3pvppyXWJ4$ zWzHP|d1&^=!GLsiU>pNpfrNcev*+xPk2!J~Es0pMnz_77#lwe~lALFhB%E5SSuSE! z12K-Z9{tx);0=BuFhMY*Yswh0r#eOHpyvMYz)-23@4s1%np8%t(n3V^zs}p$5X_I5VCk8VUR2F zKOx5-yPulMhkteD-8v;{MEg*5tP;QSgdZPL<*T8{Rodxa4BlqWRc=FIaIhj=qyak2 zOmzewRKzOsdSD;*6!4ssGvo5nxgpf%#W_Es8W_%iHEZK0s;1orWm=UY z!oap@%F7~;M2}o$MZ(wn%ns*~i30AGR1^Ll%5m!=!zF?VWxp^BV9Pbev`Y0>GdbnS5Z{kGcvj_8=26!1J-~l{t@M# z>z2Lz$e(?4!kxPSkx9hqebk@}az#*@Hi~L~u_wbk3bKfJYOJQi$s(i&hf+H@2Cu*W z^z|5k{?|xAasBU-{Yl$s!Z%EX>*&&o3ON)@@O#y8(yPL(R4-x@UhrMSX3JEvAXHFL zkdT4-gCB3A*1nI_$MjZvW>JL^cUW`MScssa6|ek39pt(k%r2!mhoX1z#=VsRX6QZ7 zQywyrXd(+aqCeVsI`A9i1dM0?5gm({*f2)jpb5LM_LE0d{CpHt`6q9M1HvA^ zyH#^TQ9t9WP1oVDV|*(%xjYuTR*bH0g{S*Hno7a-v&MN#Sv{&!M#!!WWqm@G&Y!Y_ z+->qh@uNsYzeCwG+h7qf@8=!eQz(a&^1h~wA09=5w_g%KiVv2o|Lr1Sq{w$AOz7n5 zT7ZfZfgb`~W>{*S=l&hI$v~t+uTGVX_D}8bqBiWYWG-3>$7$OmJQ(xSP-@#=-L9E~ z;Dg5cksL3Y&qiFRV5#<2Bm{5bm!~%VO=87wgMTlXlK&~>lMnn~>g_3Vx~Qlq$416w zy5)#NUJwIkG47fZU4TgdeNj%6Ogz(vVtfLi%q8hsq{-HD%_UriA2K{zMwj>BTv~|v_ufNMEC4CH5VT|$dk_riUT~2b$IFKb zFgchZ$a(3Nn^f+kw!Yz4S7zl3Xv)#BHv@YqM;x=;Hmgz2GV8AgS|Obi7s&W=o<*X& z0Dn?b1yDq1Uk@#LsA@w`8bwzK>f)e3&3;e!LSOLLPp3ZpnWNIN1_n6z48XE#z7y#Q z_?Zc5w=lQ;k@~wMti-gidXwuh(S?g?F;S$~inz#Yw)!74@h-oP_@<`1`l%oxL?KOg zNI{H|rR_J-k)q(+yGKCaMeAHA>Z;*U197PXn>|9fkq3H`y*c=UygBOc)3_bPzFyPK zEH}4|9(4a!VCc^GGriyk1ZG4%%<6l^2zeI{jr^>5o-RxTtW~sa_14~uFxSW_TfAhE zx~7-41=q1jxCo9rhr$(pCsT!|_C5U#i>CclgQ#Upl)TNk5x4c{4qoVi?!uG4w_?sz zIFG+OgXf?6Wg!dgDX@_hLqh-GfTF774@s0H8 z{f&F#+@*dlPcJ8;V4W=wVVg!Ll#yaa(_qaaYfz10Dq2lM7k=@W=;s2=5nwJV{G`8u z(?ZE&gUs|y@s0Y%#s00aHCfR&0wk&BYERSKskUJ0Nz20OkeeF1X8H&}yHfM{`C31b z7QYC7wmIWpa!IhPpGRv}9?XKk$h7gsqvDMxO;JNA1`qiq#Qcc8(i;lpqec+P`< zJ3Dq$;qgLG*}8P91)z&0d%&Z)?v7@}P(R%D0`6&?&=8$EcivX?u5A*gs7wP<+#=Q> z>arc4dmq+qZ0uHO|DG9M{FxcXcnFGXYxVJ(ZKMMdgFxQ?`gT+!D$M`rN}2r;A5=i2 z3Hkiu$2hYH{fl4r{tjJFBdcp^OcT5_;e86MpRdQRyy@9L>OXhRLSKh;gKeZ#R)l|* zFCpMnU;(`5OG@TIhB|j{IKS}ks<5#-#t)rp&!DzL_17LOv0=aG5Zy8TXO_QZmIFz3 zw=^KlH+PNnk1w{ihXDT(Cl=rTo4EphVx0RT;VvmH`$q*gt2praDN-V|vXYg7?B5a~ zKY(SPgo^@YD}9&m{;u?J*+CCS(4IJ48~*jl_V3cto&enevbWdkJ7BV!`Gz~S#lY(x zkaMcKssm;Z{d-wItu1v3U}g0lVij;3v*3?4caFNG$-f+KOZVnKT$VE6vIf?dA5+6F zE`Gd9D`i(tySIOm|2j1EX~V_^VxR=vdkH#te=)mWvaa@BNm2>$KOZ*vEjPks$bwvL z&P4HG;Vj%xo)rCAYt551SbipMi7oB__H98JtM;%5+o5`&<*Lf^$b%sw45;;xp=!3) zTAytoys|&ha@ZvcMI=jr#shidac;qxY_N@kI+=8*b6}2fa}G~$7!|#b7}-GIE2|Oa zRoNTG4BHuT3&QN~Wd*+N>9qS_POa-!&3Kl$|MmKm`mrF_-q#R|HD+V?nsTglO89Ji zx=htp5VeYq0SYO`4O|Q56$Mj4kHNGy;rm^nlK@lE9WFF9%y?kVbh6$h8O^Fy=8r6+ zxD;;f%4%}D6VO%MgX4XEz$M_i?Jh;w{ev4+Lybj30*;{-4^+2I?vzTfJjN2W7L&B?C zw`_~vu_inJ&k1O)NVhA5YpB+f*PX6)A5%)0cpeIp7&l4`;GvNL%Si@curiO+_T;`Dn8vObk z-(u?}H5b>jeXq;evxTo4+yu{$HaeuC2$LP7q>&R}=zuqVX*^hH0#PjPrKUHd{7y(9 zDO1JHV~LIFn4(Lh_ddP?d-!EocxROm^`PCtmqE=JG4Y6Am}Zjrf;7nX(}aRD@;ZE^ zuJ#Iu%3~0n|5e6KP6=f)pOWE29!O;_OwHAh&Z2++&>v{;${zf+Q9b5`GfW4^1ZOwU zRZ%G9h!*Bsv!>R?ENF={poXbiZG(cgI&iNdP*KDgIY-g2LoK;y=cgaxApz6Y&$(`~ zVqsxHG;=G4xwLD~S#x#f^D~EsOk@|cqT-TcpU`Ix>asSzS^So>aBL}1{2<};XKAS? zPZ+f1b|E zsWanu_-!qqCb#V1yDLxzLfo{410oo-6>l(nm0_#RwhatR`Kl?q&Q-A%2$AXVzw941vm47_*w>3y=Bpl;@e7=C)mC&yVBuhe+MzHloW0*O z7O8)j?xT#s0!vMs%jV?Ui;bretQSE=t=k{)Qw-{Pig{+_>^u09Q31AtJcw56Cvt&& zet8*IA7eI|-zZ#pejh2RBDv9C%=>7^P03O#ielDyJ7K8fWfx9gv`m^6ojgGu8UZUG zwtp$95MsUC-m1E)dg(jomJi4K(iX!X-;BU>XpD|AtEFaL9tI%TOL_!trEbWbZ<0(P zR5-m{*k9z);hme36DRK^h#93uE%30p_987ZsOf*Mnd&Za-6(K~6F4LA)~nE=^0}Cn z0lIxl1725VEj8HB@Pm9Tg7(^>vxZ#>HblnS$5GdecVTT#_&iW57cE#E&wx=ZU}@8r z8*Mx%<*~TF-Yc|MMYCHA=ijD+vmF`A?(cPosd{c~#SR)@(ZvL*l4RlcuFOk#r&VJ9~QVRgvWb7P25j zKL0|`Irw`*`ZUry6#>~Y^%!LHw$wqFX+ZP-)iJfmR~DT{l~azV{jnVwT#0xVg>aJnbCHBSiN_Og51H)7QrRK(gHNBqhyN z`=zzk=s_j$()(^q2|2kucjNN)zM8?q=`vqvmAA-B(kIbZrkrUpPNPfml;-~l%`Zte`spRd&U52 zJJp(ovlt=fmk>p2~}B)dj$I`P z<4H<6x91(MU9c$U@w>G4Dpu0?UNhBckbf5_7H3`!LYuE(s2Cq(I2`c)g5NH~qnqx$ zQ(96L&}4m;GFV~ebiNo&>4?35&qbrfaAIsgUdnH7OG8!RYg+sT4v!*`9c9FH6S4XL zF0#jSrsRT^)oQAeY){5oZ3e)4Tr973Kg6PXw5Cw&vK(u`U-H`r(qJBs^!-(b$^s*4 z_H1iwTlhj~j%=+VC?&ahy3=q_>`Hg6yls7KBD=QMbn%dESRpx?XTx`Wq#?KaOdF)s zFwd6WM63&v1pobSHs~(Y!Jy8(R z6$16_$zEY%BJv~C&NK<$vbsAT-W$wzDta=b=J8{Hb1Te|q|mqF@?;CmExZAJs>+r* zrztM;MAq}MVA0Jcsryp-E$-T}H>}!vg5aT&JC@Jq3zA;Fith#j0cc-lypJL{z%qgR z`wr9(hn=U)(!5cv$4623M^CLw>PQeV*4cY<7_;%BK3_;4_ckAtD()}J_OjFmzYQ|< zK9CWJaK)>X>E+zuewTA#bq{5l)-IZ%7`+mFz7mg)JK~*>@tNwu1F0fJJIkcC+G+b& z%|4gni;0r%H(%<+PihIKrNZJ>Me@iQk<=DXexQ9W=(b86J(bN-2+%CnMHM|TXb9yQ zT|;_?k;Ks_PJNSd7FW>ScS@e`=W{twgyS86!r||UE4MyEx)=7~%k{E|{`cS+Ol{Pm zo$2<4)>l+VUD%V=wnFzCj-Q7BBf$_Fzz3H#B&S(eN7H*-E-~|uc3ndrqwyqxuQ1}I zm>cxap4CP>GRz{m`#o%p4rsJ{@|Jo&IsW;zZjBY4Va~7*pNNPQvR2#-#oO$~JZo9W z2G^ZH_LoW2Wj>u4M1rOvWiwUk1hYn^jfbe~qviL`kr4el1)Em+VH++Bma z2X_hX5*$Kshv3$@(>TH1Ex5b;ckaA1b7$uJ!_)lf(`VP-yH-`Ls#OKncC)3rA|tQ& zGZw6VA1{|4z#i)Ra`G*~bI7;w_S-%>G@zW*m+Wdj2`k(}m%y#uEco&qS;?8(e!N^~ zi2^i+vb7=K294^xhMEk-bcy4kgsjo6Xyh=wdyL6HD_sXwVgu|SdJcOM*wiM&J$0hU zC9-89Fj9%nb^AdC*?^^w4?ULir8v>|Y|g_-aeL;Ht40~o`bOFoOnj9snc$(EzDM=S z=P4t{=1NbVM~?$sQkIpUsv7f%6p)YspiiIiQHi9gwHbZXF)tcFFs zCed~1GR%NoAO@5gdVP35-C;jp>}B7l@>WV?($=(d(3-d~eUiq#Q&NsBxE!SnHehw7q zRRu)0=u&(C9zqnjTQvoJVv&(m88a8SA!XlC+hu6HM!!ZxEDk$2k_{aW(}QVTcWUP= zch+%lfG-5-mwdlU;?KZ$q#vEO)eh-b0g^|OH{4o?ikTT%*TwqV-FrDti#*Uo{NB!O zSrwSIdV&0?to5u#MSpHJ>$CGa5)YRT*m!tH`hK^mMNvq``x2cA9Gr2!aasK#Cc7Qi zrRd+ybP2MN*4Z0^THTH-i#d?zsRx>rp*tJ44SI0No@F)xQX19-(sEKua+2|d#?mNyYVw^YfFxL24iUdJedzUKYiG=dbx|GG^3YT4GfHpNx_dk-%5pJ&4mEVtusG zYW#gna!W`}yoQtK5>ZYDW|BOko1UHCe!_Rc9El#*(|Kxs>IB3V3y<_Rs2pXaFkY=FHb-e$45H1_fh*?xZQyiVxCUC=<6+L6P%JT znvamYPm8oU)Y@YUm=Vfi-kT+h5|Fd{kV!-L>+|b9Y1vjqgE#V0{zZj?M%a*pLvBFR z96ByR1T%R{I$!4@0?3ry`RSxl1Y02!t&d~ot?scN9Sy|CQz&Fx0Q6D}ws>?s&-X$z z77TaI7D#u-9!-gB3Pg(C?+M97R31Ti{%N(?51}AP6jz5hntvn5t!=?&`Ykn+BczUS zrOzIP?CY5oYMQ3L`5YRo zzp`_MeglAcF&?Bg&a*Ez;YFwsXZE;5{dv>~Wk2^JhXs%H-8iuY`C;r_c+f>aMlb}w zV=;Y17?xG9D19D2dp(FUq)d)6yPR}TvXv)VM}Iyd&!wsrZCSz?IvmlI*z@@wL09Sn zs`j665FxeZ&%q#r#{i{2+!Bn zI`zJ2Mr3-Lef~fhqMkEz zt1ICQdSMp$1FsyM777Z5QV7DBz&rSiQ~i*nw$;|Ypel48+2DG5twm+-fF1jL=lq3a zKO!?hi$6jZ>m9@{2P@K1)TyMlmeo`>BELWw!wF_XuSK`smxJbUA>DDvp}roP-n4js zzHR^bww91Q_M|>n+kp#Gy?6}|x3J_Fxt@2DPapT{0d@ZQW0F^-@WkWwV5+Nam>z4=>Th`lLTkG5$Wcy$sk9hXGu6mcTvj##| zbmt*kzs9lGUB51d*yPW}z$-mTH+gVE)Px#p;NJG&Ccc`ST1Tpf@ABxd!o8+ zl!Naj5kcE|{=Ks!BaB;|OSzV|wOoH1jdQE}|*XI!xzcfz@IMv?e1tvJuSJ4Wauw>=N>C6px8n)5Rh z4lBd7-&zCA!K(AMC(`fF`{O`xyHz(L+k27Q6L!(pGu>~!l=%s746nPMU%>E4$4@Kl z@j81Xs1YcWaVrSPF%bJUHzkXUbFyno{NT3IBwisKvAf?=Bv&8$p$eH)o+F^&utFyi z)%N(oCH@ClZ?2+JQvn_?TQOAmhrGcfPaS%;iJ+I5%vQteVr%ibdTW#gn+X{06-J_KF#%&oxQ-^O_~7#C zHQzgavUs_7m;%z@sqy$cg|+pTC_wKYmb&zlO4u;=KB9T1Hv9IFo})9bN!X#QZbYr@ zuQ>F$Qj{jOqfbsSDeD=hGq#d9I%P}^2cZe*esyQf!IpyJf7u17zuAHhpFz}mq64`H z`x?1Os4Z2$g(w8uVZMcm|Kj1Q%NEws*V9R}Q&hjd_D~*(=OS)LelPIM=J#otsI?3P#iN1#$m}Az=$u4p52x%&W-T1I360;wWs_@+W3B ze*Xw83gY{iyq!PJA`ByM6|Zye#SuZ*{x^qZkt5!{JSzT) zA-7h`q?Lyr3Cf!Cf{7Htvy=~E;@FrL(#6zWNg}?E%+EicVX4gCZ0i)tVsKlXu~j)0@UKI0=8;oqVE?EgS?tPeoG1WI@nV8n9nl8EsI-mUyQ*DFW$~QHaD` zbMX(;7LC`?euJAK#zr47C9_j*f8NJ4ZI#^6euBj!&7$xw89J&{gZ)x*!=&eTGMgMy z&vvMlduHF^UyNx4&*PFbkv#T&T8P&3 zvt#d+uVxx_NS3YW~4YOP2chUC7mg99HkqR_-0lPj!^LHRnc9XyZ18M3S_n>e14& zT|2(9iAl)#R~_BqVnAOFNcu4SB=F0SpzM4M?G-xfJ+cnId!W8k<#W-D zt%a|9jtOo1f2!Z)a0D>&d+i!X|<>N0s+W41gxB6sf&@O(juB&J6XWVcC_pu`M1S}JQCf9*OU$O_i z>0hQg=vwWw5M608_K3hM6m@4c|4=v+p@CT?Jjd zvV21fBFJ`9a6jrmMZU1Z(x+`Iw(Iko4*>-ZsUj6r2aurTPVv;#@K=MKYk|>JbE(}n znN^2W9*rzlrj_@Y*$!BQN!!iAe~hIT^xSq<6R5Mw`wqufaZ|4S3A2ipj|0JHe^z1Z z7oSBu!-fg+o#4Z@b2UZzh)#V@fpZ-^%;0!vHaJwXZmRZLQuessRS8z}gmXx^BEJ?^ z(|l%qLPiBi)9Xobx9cxrMTTf6-Qgep0d+|ACkI8&>Lj#>chuRnrXHo4Y}O?>mjMQd z_@y^iQ(64ze@My7iFRCvB$>?LUZFR|Q_{fH}#|oU5%zg`W zOTQDJ-`ntn#Pw-(lU%PbEs`PsWQJwBjZ1*a_;O>5=qUOws7t?;>&wz@eVm52E%yc% zYNkUPLI+x(68w_`b@yhPY$$xzMe^S)1=#l-#excgpUO>vL6n8^*=D+QGHW~gVWUVa zBk0By{JrJ6H#p@wjl%lx=*JKPF8G?sKH^p$2g8Q+Y-zMZZL{3o7-WYggh(cq?Y07Y zZZ!Q<&?0*ly1Fo%#^c2`scuF&(Ym$@*;h}fTo_GEG+KT>WyUl_lG}M zP4+$g8F^=qO5vrFtY%0!Cwwvvg;~~TTxuA@U^Uwe66y|_Pr_&t;3@=%nqd&o1iDCsV8$#x_5RpXj^CMN59OD+z#5gCbC z{=#8n`f!WO97TmkM9HuuZr=eb-q%+HpKL=d*j{aBAHpoIfr+LK*GuymjsHEE zC(zx&^CHB&H;71!Vl4G4Erp_LZGC@3Ci<#7^2#A(Oxv-x8Xly&mzob~z#EV~-#tm@ z{OW!T3Iy2jKsy6rD}=T5h}r=3NrH7CbtE1F9)ycrQu6lO*|)m5T-fG)a*vBV*lw26 zEC^Xki|QYrS)MiI=nG6DBEMiI>JpO}6J$A7G%b3St zZ-|HqrXg_&*rx15=hBiN8`EF2ARL$juE;xoEPQnAhVJf*Dtw$gIZkMOI5|8<*H)gaz#Pp@dp z=TWXuHorxyWhss)W3S5x2d*NjPW$Om)@Is1QvtXzl3TX;gQyNB>&Md=$410q@%k!L z-F92#N+QMSU9_$4#3d~z&x;d&+J}Ri=ys1uq-~&rqLo2oXYV`qU2yYq*r?NA%xG2N zVe%{wJOOXh6DpV)-~PL2vN~7269ZCRex2_F;%U>C+qF2+hb4=_%&_CL76F!UE0ofxjRSx+QaiiF1!vi zY0Ho(yx_vsT!X6jTUxVs3_@ger~JryAy1IHDKrn?e$#`_g3Lym;?F>TvyMUuXGT&L zMUK>&`nm$3;Wk_|XsSY=&cH}O9g0=~=a0_)!E`p3V2UY`J(l5(F1o6!YPX36ziyy? zEB!>zGy{u3WXFY7(Wfc2gHQ)yA%@=qx4j&T#QhZ?zG!3Z5@DRraMW4MizXDN+?VB% z_BdfM1N1#Lm$};U@0M=;G7P+?YR@O%)+2E$5~qzdGP@Ob1V3(&*NV5*S=J3y0`sDk z{T4~;S;}u}qsIU8F9b3E$}_!BKB8KkUrq{?LJj(XGOo4Z_*%OVMYKK(X_;5YgC}K{V%NH`_7PcmdnByX zm~w1uJayh+^~ucMv($QPKXJjtWivp8b}|pU>Px0Z`7_iMJDbZEkLQ=mX+-1O-J(bJ z`moscodtsI;G=32iB!4iBG@Z|C!3JfO?^GHQj>gUqvlua9!t{> z)6t*c!PD0sjiv#NPpy^XNM_7}jX+7q6yI}8NPjx!)0VNfW~H05P;Ka8M%=^Us)%NI~>qDoU5KGjGQl&4pL#Ni!XV-phHitJZi@JE#xtIS0EaH%Z;%1uj@PELXIP z>@!5hm{cI;fOGDqE`(S=YN$d5w6zmAq}S^btl8swEOW?NRQG={oi>>BTF7(QOTwnk zCD-wUm=XG8!8o3``(N8uy)O?wcw@aKU!=IT$@^0~x{e(eO*|IwGU=g2=S=3AA$dDN*MY`_4Vp`8=)dY< zqONIO(r9mnM#3%N?X@BEx}9=FnxBY?0=*dTR19Wz#)t85l5JIPN2@i?l+K z`z}Ygv4N8o$^zlG#*>8!wBiD#P2%$%U3ivHwNwPXXf^m6&_mq-si2yYySdIuU|qmsE8fNEjj;mx_W|>z}dB zft*jSMpYICPdGC`9WkTue|UQ8p-kcW`1?E~B`FDY-TR5S!Gt=Vr31J&y2wVw=Te|X$ztV6uKb5v6r;GYffoql<~Vu`C8 zc$CGFJSy|mw|IOu0LmDQ?zC4-blfOFhtZHItBFDrY>5C|{3wOdiftpJ>?*(Jc($KD z18(exUZ7FiVGCtmbiUHj;oPtkw8@`p-6T0-emuk=0TC_TBH8wG`UTLtQA&vL@e*M9 zAnA2V>LfQf9kW?KQu!^d4JU~- z>f~_I?g*;5|y8Mn?uMo$6)THGI|3Bte-Hvg3OhNCbmq?x1N<{RQ_FHWK1xaP7vOqGit-CDWSzToHMB7iH|J5nv&}MM!Q=3gi0!~VZMJUXmMvRUc!?F3 zN}R;ReC)iYCB^em&;{a94h3nsgyg;?k~&LB7Q}04KzL_w$*k{j!LJZX%TO6qcdy#& zW=o!{NJ{qU-O?XjNVj;0MxkkUS^+-sJ7EzWU!NnEE9YNtrrLi|kpJjHl|on#mdYm4 zZ5<-`1ieG$xbNzJDxxOWh=BgNPU>eDEO-GfAltGM59Mkq-d^20<52LJ)2FT8?SeZk zyIK5xlY7>b^M}kt*^}Y-FntRfCW7BmNHtK7SUKvC!H5hPbm``VnhU@U#e^JwJKr)B z^6fFp;gPw6_4F8WKfE1ckQ93B72Bf6Y~S}v2$toHI~#3W_Zc@;F1WAMo5bl_SmG%` zu)1XmkDZ&c8VJZgRzosPC?#)g>8I)=^?fjF67b(>O^mUvzvk2?`$B>2xz+8^cL8=H zvesHmFezGyaTp%`6wV4rF@&2|B3lWbt%FHBUUysH;cU)~N7lP#_u_q!U4K&&%N-AK zku+wK=jn)xW0Bg29oUveOZO?PJ2;^3M;w*K!5_#PM=EgKekC9Hxz;YaHek`#UhPmF zp0f0b98w~tO-5bqTdU)i0cayu`wn9!>!^y*q;0)4oM7`RZ&&e&vC}HNX|GxqMiV|F zAQ*C$yp!fDUEb>pZ$>2u{WBRN&n*!IQ#Z$aq!T%{2OPGxOi}o0W!T>Ysk!Sh*Q?R_ zu7YILzS+1JdFHqq0Ij?R;xMSEXC%Y@vwn_VI7q~C z18Yba81=X-{$XQRvWJKl_{Irii7ybI%8m>|}ClmuvqNnm{n8wVb%7IRZ!(DB_QVpt8Pe zlrZh9yM93n7FWv-Ui)}iT4p$Zy82ZBYLoxIQZ_mOH{8RF%vA!TU~^nIUf8-?UX`4z-^1x**llMG5b$*LyRwZSEOY;5eg zr8P2|k%gO#aF@iDDBE!C)qa9OuBlG(jP?hu64v;|h?+nF7nor4tSD{fp;6__L4ALR zLP%C^U{EdfD=QLeDE@IT0wY

5^Y|FMQCq&bZ)=_Yrj(Dd^(qsz#QD70c-N-N_z< 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 Xr-Fvw74!rH_)@u~sff9F-S58ufbu*v diff --git a/docs/guide/src/en/images/component_tree.png b/docs/guide/src/en/images/component_tree.png deleted file mode 100644 index d9692407350138e0b7597e8705e33f58a463357a..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 3724 zcmcInX*3iL*H;uzihqfO;UA%f>7+f_`)MmHV*g8YZH8`ILU zg?%^7>|JA`DcK=2){$?tlul(Y_?kk^SWfwBKFpIZJ^J42!>1ee>OZ`19zdjieh<%* zyK+xE^P%QBm~GuI)9#s4(mg_R_5y!%;T+!e@@$zET zQt2y3M0D-{xmfw`WFhxh3@Huqx_c7Hg@c6)I~1o-tlVQncze&Ojlh!OSBF#bC-T3e z?6q+K3X}n!H5}yQEm3P%it>3|8o}b|JocDZj=AuT~c}#A#+kY^84czx>#Nec;w3AQLe7w)E))FgB zy8u4REjaFXQ~avii&9@&Oy#p^^0!unzL0(;+5@UFty&I#RVN&9qe))*Tnh|x<5F6m zjW9FBk{DUu^97(LEdDg)(H4K^t7t%8y@`z^XD`%w`=PualCR^*&Bl8TDxesEdEqJB zWyzozh)u8^?<%S{xkxZE533SeeYV#fPu_mUYv#sBPlN40*CH=iYrRUdIw1^*zSH&V zLVaX~;Nr;`pfmQRl-EKTr&VZS7CQ0M^%Q9zMQmBED;9789HFg4(lLaG{=NvNy!~Qh z<+TUAh}H>q`+Y@Fw@R$}`{?s*zKo^e7Pz^}eIY{^%cU7vVH-3aYoZ@6m3Bq@4Zzd^ z@|G9!(^$SgCo5%`VQ386I%1F*KWzeJiAEtH5I$Mhd#=h|h&Zg!23zq~;zbVL{%i!p zxgYNRhE6GaiE+a}T4WaNY)1n;vn(FZ86SMJ$03$H-FSIak2cy-q&|6J)hgJqcYRWa zlEwLrAE;23CvmYAj#PUlisV(FLYCuqAkbYrZna?)8cA~W==BEi*ObxG;7K1(^qtAX zpxTxUhJn8{GPC(}3+g}|_aUfus?i~LkF+1odq4)V26=Y>kXcG+NDR45rU_BP*&_w% zAGHT5%Wt3enf%TEH~ZaAq$G}4ZLW37(RNdfZI|B4CZcf5dfgn=@qihJG;ExI0^Be| z#jCU}O*Ld2G5ZhkiLmaGzUAqj1*W8Riio!eJq*`+AC>G z+*R-%3(7`^(SVTF4}uGjRz3|)zV|}i3GkOr5SZ=0QI?D(l1oGilYgSZ_ldkY%YNSJ z+f7Jofsjg2#e!s$^lc=U@GiR(2nMOE5W)&i8cJoKGN%Epk9@RC@rv7`Bw`$Vr;(St8tsGp?`ON*osbqCz= zdQWlVtfdfm;9UVUWfbWfnSha0$sMQOQ_d7Yv!|tF}3T zGAfRaBl{}B2{5FB;+8AAa3hA4#!ze1tG1Bnqg2G_E$G;*vF^I$mr zwh-HTV7zV5fX8TsP@S`PEF9%tDj@}gUG7d$J83LPT6S%2>rl3BaV~eQ1YHI{wg^(Q zd(#;sBT<@to^CMcF;9N~`624yn!-Pkx#swKeF%fwQh7Pu52J7^?U$@e(u)E~4Szp9 z0m?B-J%eDv%dkUB?oYQJPn_^+Hkwu=w0BI^B=)z;O=|GtGa4|qSz26rxb;s|iY0y? zy8qponSQ_F=U6?0r%=SYa+lIGzsH{<=3``bc<6I-%=J8?leNWee##_EzF}j6t`TC- z$_-GTv4bk`-_>lca7^y|!|xWx@d`W+0{M)L37Gk45*0QR-J_JFP>FLlwDc+0^3BBl zXb;~Vs#awZzW_S0y19UaLrmPrjdmEYywhJT*$TINZpXT?mwJ96bA9ziN)F;OHQ>dv zeXdCEJn_c9S#jx3G=N#tr%u@xyD-M3Rleu3`VPQN99?hrM1(}SAa}rOV-&MolT5!Ry1#Uj;+PJiByvArvR&v0My&DoBELZ9)W(d~ z`=V6m7~1YoLeaaa0~mS)WyGV}T@&}{jvxv2W)g7Q4><{O$sC9mDI=MNlHeh}XCa#E za#bV^_G>ePDvjKOq)}y~zuGdUUPG>wj=ER@{ic51zFBiuPnRl}F{%^QJBS1|*{$Kh z4zq0URx9s~M+8I@Kzl@!SqtcKk^hW^ik%M;Rr2dDrbEWe3v7Mh?>)`yg@dlM>ol#|dqtkmf=&@(6j=_3>xmcWE#<$8x|}Zk{gN_1F_9skmm6 zl+346a8eJ`9ERjHC=81XR=yqw*d*=cYV4KN1=jsU^Qk%$5A)$SlQKkIB5i`;dJ*2a zN$GjBS*ssMeIi39!|~((+FpIzuN4T*f8m|^e8e-fbLty>;Ux#|{G*`qqp-rJe$q%Y zDB}a*RkR>l+N%hrCkP(!XoLdSonAxmSZ(n_kpE~~9)p>48SDtv3v;?8n$Rolk?Dr4 zmW5Mq%`)T`c!7O07VvfBvTRHL65Pr}M}$t#%P{25I)AUU2K**oPv4zdWmomMFT*YM zPvVx>pFxYyNPtsD`w2?DZj70D_Nz3q3|}zIwRRZe?r{r8K^06HQu-1)jC}3-tGDLv zs9o&lLO-s5l|t)8RfjIR6$h=6=CD4JM+O$t&$$nSTO7jS85(M%H^qj5@($mp%_jDX z6fpO-mhs~^yfb`f%3&YEBBdY(q4KI1iW@`M#1z3fr&rq1pDsmRT~{%(Nw8#`59~^n zIPnV(3-r;RqT8b4=O72^1JUrkiZ6f?bz5gh6hPL7b7g%^Vay<4$hFur_2D`JHH0u`OfIQOiFa5* z8(xDYEb)%Gob}a;v=5s|Hw^g@UV+%mZO2X!wmDgk%4a}SnWhj&+)xCLkP|5u+-#5Y zVB^M87zW%3crT((OdNh}%Dx)Bm{%D){ji}G@ z)Vvd(Cn0wU=rzoaBA+I>CSrO0Yn!nwePf+tK7>yzWVOR;EC#Ub8Gj3hy7WhW6KwvO z=b5h2X78W~CR?>^ATj^w-nE7#m^DT21?3-3T19q8J=etTwBAz=N~d#7;{a!_3mGkO zzDA+|m2ACPAv{erx+#dRD1IO4qnVlCSIlZ@F#Yxwu}t~ir@a^b+#(Tkfimon0x?*C+)HMM<$Ords3f}FO?&zV=p#;W)cdlUb{bKf8MO`9u;Gea*#YRs@Wnj_tzo?8pOZ#kx@USbOx|)A~<{{g*whKHE7evVU=3 z80pG>G`tej`@jE`f zOlkV6A}`p6tmFo?K&MDyIuX8ip8x!6;qEMdhZsM3Ijh-T*0B9>-${K|@!)IUAbEHi z5{zulnd}|70$-@`cU6Q(y~0@r1<$=a8rQHLo02HljiyDneuLp8sP+hU`+qZd#Vpsv zTt^jvI(tUD>VW%0F(2(xQ4FIq@SC)6kr+^soOjqOSveSoy#{;$K-yJ`(@{ diff --git a/docs/guide/src/en/images/diffing.png b/docs/guide/src/en/images/diffing.png deleted file mode 100644 index 4c243bc759085f24ada3be039cb763e1d59fc2f5..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 23486 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 Bge?F7 diff --git a/docs/guide/src/en/images/dioxuslogo_full.png b/docs/guide/src/en/images/dioxuslogo_full.png deleted file mode 100644 index 7d08f2af8f057780eddae4b0f8b8fa753b69e7f8..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 59292 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

##0PXrvufB0wJ`%=YsvNItF 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

sW@yfIK5!0r3C!jXOp{;!Mh)wCw-TYJeHj?h7 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%0AT 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 KTJSHwum215)xFXH diff --git a/docs/guide/src/en/index.md b/docs/guide/src/en/index.md deleted file mode 100644 index bbebb0bc9..000000000 --- a/docs/guide/src/en/index.md +++ /dev/null @@ -1,52 +0,0 @@ -# Introduction - -![dioxuslogo](./images/dioxuslogo_full.png) - -Dioxus is a portable, performant, and ergonomic framework for building cross-platform user interfaces in Rust. This guide will help you get started with writing Dioxus apps for the Web, Desktop, Mobile, and more. - -```rust, no_run -fn app(cx: Scope) -> Element { - let mut count = use_state(cx, || 0); - - cx.render(rsx!( - h1 { "High-Five counter: {count}" } - button { onclick: move |_| count += 1, "Up high!" } - button { onclick: move |_| count -= 1, "Down low!" } - )) -} -``` - -Dioxus is heavily inspired by React. If you know React, getting started with Dioxus will be a breeze. - -> This guide assumes you already know some [Rust](https://www.rust-lang.org/)! If not, we recommend reading [_the book_](https://doc.rust-lang.org/book/ch01-00-getting-started.html) to learn Rust first. - -## Features - -- Desktop apps running natively (no Electron!) in less than 10 lines of code. -- Incredibly ergonomic and powerful state management. -- Comprehensive inline documentation – hover and guides for all HTML elements, listeners, and events. -- Extremely memory efficient – 0 global allocations for steady-state components. -- Multi-channel asynchronous scheduler for first-class async support. -- And more! Read the [full release post](https://dioxuslabs.com/blog/introducing-dioxus/). - -### Multiplatform - -Dioxus is a _portable_ toolkit, meaning the Core implementation can run anywhere with no platform-dependent linking. Unlike many other Rust frontend toolkits, Dioxus is not intrinsically linked to WebSys. In fact, every element and event listener can be swapped out at compile time. By default, Dioxus ships with the `html` feature enabled, but this can be disabled depending on your target renderer. - -Right now, we have several 1st-party renderers: - -- WebSys (for WASM): Great support -- Tao/Tokio (for Desktop apps): Good support -- Tao/Tokio (for Mobile apps): Poor support -- SSR (for generating static markup) -- TUI/Rink (for terminal-based apps): Experimental - -## Stability - -Dioxus has not reached a stable release yet. - -Web: Since the web is a fairly mature platform, we expect there to be very little API churn for web-based features. - -Desktop: APIs will likely be in flux as we figure out better patterns than our ElectronJS counterpart. - -SSR: We don't expect the SSR API to change drastically in the future. diff --git a/docs/guide/src/en/interactivity/custom_hooks.md b/docs/guide/src/en/interactivity/custom_hooks.md deleted file mode 100644 index d075bb632..000000000 --- a/docs/guide/src/en/interactivity/custom_hooks.md +++ /dev/null @@ -1,91 +0,0 @@ -# Custom Hooks - -Hooks are a great way to encapsulate business logic. If none of the existing hooks work for your problem, you can write your own. - -When writing your hook, you can make a function that accepts `cx: &ScopeState` as a parameter to accept a scope with any Props. - -## Composing Hooks - -To avoid repetition, you can encapsulate business logic based on existing hooks to create a new hook. - -For example, if many components need to access an `AppSettings` struct, you can create a "shortcut" hook: - -```rust, no_run -{{#include ../../../examples/hooks_composed.rs:wrap_context}} -``` - -Or if you want to wrap a hook that persists reloads with the storage API, you can build on top of the use_ref hook to work with mutable state: - -```rust, no_run -{{#include ../../../examples/hooks_composed.rs:use_storage}} -``` - -## Custom Hook Logic - -You can use [`cx.use_hook`](https://docs.rs/dioxus/latest/dioxus/prelude/struct.ScopeState.html#method.use_hook) to build your own hooks. In fact, this is what all the standard hooks are built on! - -`use_hook` accepts a single closure for initializing the hook. It will be only run the first time the component is rendered. The return value of that closure will be used as the value of the hook – Dioxus will take it, and store it for as long as the component is alive. On every render (not just the first one!), you will get a reference to this value. - -> Note: You can implement [`Drop`](https://doc.rust-lang.org/std/ops/trait.Drop.html) for your hook value – it will be dropped then the component is unmounted (no longer in the UI) - -Inside the initialization closure, you will typically make calls to other `cx` methods. For example: - -- The `use_state` hook tracks state in the hook value, and uses [`cx.schedule_update`](https://docs.rs/dioxus/latest/dioxus/prelude/struct.ScopeState.html#method.schedule_update) to make Dioxus re-render the component whenever it changes. - -Here is a simplified implementation of the `use_state` hook: - -```rust, no_run -{{#include ../../../examples/hooks_custom_logic.rs:use_state}} -``` - -- The `use_context` hook calls [`cx.consume_context`](https://docs.rs/dioxus/latest/dioxus/prelude/struct.ScopeState.html#method.consume_context) (which would be expensive to call on every render) to get some context from the scope - -Here is an implementation of the `use_context` and `use_context_provider` hooks: - -```rust, no_run -{{#include ../../../examples/hooks_custom_logic.rs:use_context}} -``` - -## Hook Anti-Patterns - -When writing a custom hook, you should avoid the following anti-patterns: - -- !Clone Hooks: To allow hooks to be used within async blocks, the hooks must be Clone. To make a hook clone, you can wrap data in Rc or Arc and avoid lifetimes in hooks. - -This version of use_state may seem more efficient, but it is not cloneable: - -```rust, no_run -{{#include ../../../examples/hooks_anti_patterns.rs:non_clone_state}} -``` - -If we try to use this hook in an async block, we will get a compile error: - -```rust, no_run -fn FutureComponent(cx: &ScopeState) -> Element { - let my_state = my_use_state(cx, || 0); - cx.spawn({ - to_owned![my_state]; - async move { - my_state.set(1); - } - }); - - todo!() -} -``` - -But with the original version, we can use it in an async block: - -```rust, no_run -fn FutureComponent(cx: &ScopeState) -> Element { - let my_state = use_state(cx, || 0); - cx.spawn({ - to_owned![my_state]; - async move { - my_state.set(1); - } - }); - - todo!() -} -``` diff --git a/docs/guide/src/en/interactivity/dynamic_rendering.md b/docs/guide/src/en/interactivity/dynamic_rendering.md deleted file mode 100644 index 8d91650c3..000000000 --- a/docs/guide/src/en/interactivity/dynamic_rendering.md +++ /dev/null @@ -1,86 +0,0 @@ -# Dynamic Rendering - -Sometimes you want to render different things depending on the state/props. With Dioxus, just describe what you want to see using Rust control flow – the framework will take care of making the necessary changes on the fly if the state or props change! - -## Conditional Rendering - -To render different elements based on a condition, you could use an `if-else` statement: - -```rust, no_run -{{#include ../../../examples/conditional_rendering.rs:if_else}} -``` - -> You could also use `match` statements, or any Rust function to conditionally render different things. - -### Improving the `if-else` Example - -You may have noticed some repeated code in the `if-else` example above. Repeating code like this is both bad for maintainability and performance. Dioxus will skip diffing static elements like the button, but when switching between multiple `rsx` calls it cannot perform this optimization. For this example either approach is fine, but for components with large parts that are reused between conditionals, it can be more of an issue. - -We can improve this example by splitting up the dynamic parts and inserting them where they are needed. - -```rust, no_run -{{#include ../../../examples/conditional_rendering.rs:if_else_improved}} -``` - -### Inspecting `Element` props - -Since `Element` is a `Option`, components accepting `Element` as a prop can inspect its contents, and render different things based on that. Example: - -```rust, no_run -{{#include ../../../examples/component_children_inspect.rs:Clickable}} -``` - -You can't mutate the `Element`, but if you need a modified version of it, you can construct a new one based on its attributes/children/etc. - -## Rendering Nothing - -To render nothing, you can return `None` from a component. This is useful if you want to conditionally hide something: - -```rust, no_run -{{#include ../../../examples/conditional_rendering.rs:conditional_none}} -``` - -This works because the `Element` type is just an alias for `Option` - -> Again, you may use a different method to conditionally return `None`. For example the boolean's [`then()`](https://doc.rust-lang.org/std/primitive.bool.html#method.then) function could be used. - -## Rendering Lists - -Often, you'll want to render a collection of components. For example, you might want to render a list of all comments on a post. - -For this, Dioxus accepts iterators that produce `Element`s. So we need to: - -- Get an iterator over all of our items (e.g., if you have a `Vec` of comments, iterate over it with `iter()`) -- `.map` the iterator to convert each item into a `LazyNode` using `rsx!(...)` - - Add a unique `key` attribute to each iterator item -- Include this iterator in the final RSX (or use it inline) - -Example: suppose you have a list of comments you want to render. Then, you can render them like this: - -```rust, no_run -{{#include ../../../examples/rendering_lists.rs:render_list}} -``` - -### Inline for loops - -Because of how common it is to render a list of items, Dioxus provides a shorthand for this. Instead of using `.iter`, `.map`, and `rsx`, you can use a `for` loop with a body of rsx code: - -```rust, no_run -{{#include ../../../examples/rendering_lists.rs:render_list_for_loop}} -``` - -### The `key` Attribute - -Every time you re-render your list, Dioxus needs to keep track of which items go where to determine what updates need to be made to the UI. - -For example, suppose the `CommentComponent` had some state – e.g. a field where the user typed in a reply. If the order of comments suddenly changes, Dioxus needs to correctly associate that state with the same comment – otherwise, the user will end up replying to a different comment! - -To help Dioxus keep track of list items, we need to associate each item with a unique key. In the example above, we dynamically generated the unique key. In real applications, it's more likely that the key will come from e.g. a database ID. It doesn't matter where you get the key from, as long as it meets the requirements: - -- Keys must be unique in a list -- The same item should always get associated with the same key -- Keys should be relatively small (i.e. converting the entire Comment structure to a String would be a pretty bad key) so they can be compared efficiently - -You might be tempted to use an item's index in the list as its key. That’s what Dioxus will use if you don’t specify a key at all. This is only acceptable if you can guarantee that the list is constant – i.e., no re-ordering, additions, or deletions. - -> Note that if you pass the key to a component you've made, it won't receive the key as a prop. It’s only used as a hint by Dioxus itself. If your component needs an ID, you have to pass it as a separate prop. diff --git a/docs/guide/src/en/interactivity/event_handlers.md b/docs/guide/src/en/interactivity/event_handlers.md deleted file mode 100644 index 4e332adf9..000000000 --- a/docs/guide/src/en/interactivity/event_handlers.md +++ /dev/null @@ -1,72 +0,0 @@ -# Event Handlers - -Event handlers are used to respond to user actions. For example, an event handler could be triggered when the user clicks, scrolls, moves the mouse, or types a character. - -Event handlers are attached to elements. For example, we usually don't care about all the clicks that happen within an app, only those on a particular button. - -Event handlers are similar to regular attributes, but their name usually starts with `on`- and they accept closures as values. The closure will be called whenever the event it listens for is triggered and will be passed that event. - -For example, to handle clicks on an element, we can specify an `onclick` handler: - -```rust, no_run -{{#include ../../../examples/event_click.rs:rsx}} -``` - -## The `Event` object - -Event handlers receive an [`Event`](https://docs.rs/dioxus-core/latest/dioxus_core/struct.Event.html) object containing information about the event. Different types of events contain different types of data. For example, mouse-related events contain [`MouseData`](https://docs.rs/dioxus/latest/dioxus/events/struct.MouseData.html), which tells you things like where the mouse was clicked and what mouse buttons were used. - -In the example above, this event data was logged to the terminal: - -``` -Clicked! Event: UiEvent { bubble_state: Cell { value: true }, data: MouseData { coordinates: Coordinates { screen: (242.0, 256.0), client: (26.0, 17.0), element: (16.0, 7.0), page: (26.0, 17.0) }, modifiers: (empty), held_buttons: EnumSet(), trigger_button: Some(Primary) } } -Clicked! Event: UiEvent { bubble_state: Cell { value: true }, data: MouseData { coordinates: Coordinates { screen: (242.0, 256.0), client: (26.0, 17.0), element: (16.0, 7.0), page: (26.0, 17.0) }, modifiers: (empty), held_buttons: EnumSet(), trigger_button: Some(Primary) } } -``` - -To learn what the different event types for HTML provide, read the [events module docs](https://docs.rs/dioxus-html/latest/dioxus_html/events/index.html). - -### Event propagation - -Some events will trigger first on the element the event originated at upward. For example, a click event on a `button` inside a `div` would first trigger the button's event listener and then the div's event listener. - -> For more information about event propagation see [the mdn docs on event bubbling](https://developer.mozilla.org/en-US/docs/Learn/JavaScript/Building_blocks/Events#event_bubbling) - -If you want to prevent this behavior, you can call `stop_propagation()` on the event: - -```rust, no_run -{{#include ../../../examples/event_nested.rs:rsx}} -``` - -## Prevent Default - -Some events have a default behavior. For keyboard events, this might be entering the typed character. For mouse events, this might be selecting some text. - -In some instances, might want to avoid this default behavior. For this, you can add the `prevent_default` attribute with the name of the handler whose default behavior you want to stop. This attribute can be used for multiple handlers using their name separated by spaces: - -```rust, no_run -{{#include ../../../examples/event_prevent_default.rs:prevent_default}} -``` - -Any event handlers will still be called. - -> Normally, in React or JavaScript, you'd call "preventDefault" on the event in the callback. Dioxus does _not_ currently support this behavior. Note: this means you cannot conditionally prevent default behavior based on the data in the event. - -> Note about forms: if an event handler is attached to the `onsubmit` event of a form, default behavior is to **not submit it**, meaning having `prevent_default: "onsubmit"` will submit it in this case. - -## Handler Props - -Sometimes, you might want to make a component that accepts an event handler. A simple example would be a `FancyButton` component, which accepts an `on_click` handler: - -```rust, no_run -{{#include ../../../examples/event_handler_prop.rs:component_with_handler}} -``` - -Then, you can use it like any other handler: - -```rust, no_run -{{#include ../../../examples/event_handler_prop.rs:usage}} -``` - -> Note: just like any other attribute, you can name the handlers anything you want! Though they must start with `on`, for the prop to be automatically turned into an `EventHandler` at the call site. -> -> You can also put custom data in the event, rather than e.g. `MouseData` diff --git a/docs/guide/src/en/interactivity/hooks.md b/docs/guide/src/en/interactivity/hooks.md deleted file mode 100644 index 8b571dacd..000000000 --- a/docs/guide/src/en/interactivity/hooks.md +++ /dev/null @@ -1,106 +0,0 @@ -# Hooks and Component State - -So far our components have had no state like a normal rust functions. However, in a UI component, it is often useful to have stateful functionality to build user interactions. For example, you might want to track whether the user has opened a drop-down, and render different things accordingly. - -Hooks allow us to create state in our components. Hooks are Rust functions that take a reference to [`ScopeState`](https://docs.rs/dioxus/latest/dioxus/prelude/struct.ScopeState.html) (in a component, you can pass `cx`), and provide you with functionality and state. - -## `use_state` Hook - -[`use_state`](https://docs.rs/dioxus/latest/dioxus/prelude/fn.use_state.html) is one of the simplest hooks. - -- You provide a closure that determines the initial value: `let mut count = use_state(cx, || 0);` -- `use_state` gives you the current value, and a way to update it by setting it to something else -- When the value updates, `use_state` makes the component re-render (along with any other component - that references it), and then provides you with the new value. - -For example, you might have seen the counter example, in which state (a number) is tracked using the `use_state` hook: - -```rust, no_run -{{#include ../../../examples/hooks_counter.rs:component}} -``` - -![Screenshot: counter app](./images/counter.png) - -Every time the component's state changes, it re-renders, and the component function is called, so you can describe what you want the new UI to look like. You don't have to worry about "changing" anything – just describe what you want in terms of the state, and Dioxus will take care of the rest! - -> `use_state` returns your value wrapped in a smart pointer of type [`UseState`](https://docs.rs/dioxus/latest/dioxus/prelude/struct.UseState.html). This is why you can both read the value and update it, even within an event handler. - -You can use multiple hooks in the same component if you want: - -```rust, no_run -{{#include ../../../examples/hooks_counter_two_state.rs:component}} -``` - -![Screenshot: app with two counters](./images/counter_two_state.png) - -## Rules of Hooks - -The above example might seem a bit magic, since Rust functions are typically not associated with state. Dioxus allows hooks to maintain state across renders through a reference to `ScopeState`, which is why you must pass `&cx` to them. - -But how can Dioxus differentiate between multiple hooks in the same component? As you saw in the second example, both `use_state` functions were called with the same parameters, so how come they can return different things when the counters are different? - -```rust, no_run -{{#include ../../../examples/hooks_counter_two_state.rs:use_state_calls}} -``` - -This is only possible because the two hooks are always called in the same order, so Dioxus knows which is which. Because the order you call hooks matters, you must follow certain rules when using hooks: - -1. Hooks may be only used in components or other hooks (we'll get to that later) -2. On every call to a component function - 1. The same hooks must be called (except in the case of early returns, as explained later in the [Error Handling chapter](../best_practices/error_handling.md)) - 2. In the same order -3. Hook names should start with `use_` so you don't accidentally confuse them with regular - functions (`use_state()`, `use_ref()`, `use_future()`, etc...) - -These rules mean that there are certain things you can't do with hooks: - -### No Hooks in Conditionals - -```rust, no_run -{{#include ../../../examples/hooks_bad.rs:conditional}} -``` - -### No Hooks in Closures - -```rust, no_run -{{#include ../../../examples/hooks_bad.rs:closure}} -``` - -### No Hooks in Loops - -```rust, no_run -{{#include ../../../examples/hooks_bad.rs:loop}} -``` - -## `use_ref` Hook - -`use_state` is great for tracking simple values. However, you may notice in the [`UseState` API](https://docs.rs/dioxus/latest/dioxus/hooks/struct.UseState.html) that the only way to modify its value is to replace it with something else (e.g., by calling `set`, or through one of the `+=`, `-=` operators). This works well when it is cheap to construct a value (such as any primitive). But what if you want to maintain more complex data in the components state? - -For example, suppose we want to maintain a `Vec` of values. If we stored it with `use_state`, the -only way to add a new value to the list would be to copy the existing `Vec`, add our value to it, -and then replace the existing `Vec` in the state with it. This is expensive! We want to modify the -existing `Vec` instead. - -Thankfully, there is another hook for that, `use_ref`! It **is** similar to `use_state`, but it lets you get a mutable reference to the contained data. - -Here's a simple example that keeps a list of events in a `use_ref`. We can acquire write access to the state with `.with_mut()`, and then just `.push` a new value to the state: - -```rust, no_run -{{#include ../../../examples/hooks_use_ref.rs:component}} -``` - -> The return values of `use_state` and `use_ref` ( -> [`UseState`](https://docs.rs/dioxus/latest/dioxus/prelude/struct.UseState.html) and -> [`UseRef`](https://docs.rs/dioxus/latest/dioxus/prelude/struct.UseRef.html), respectively) are in -> some ways similar to [`Cell`](https://doc.rust-lang.org/std/cell/) and -> [`RefCell`](https://doc.rust-lang.org/std/cell/struct.RefCell.html) – they provide interior -> mutability. However, these Dioxus wrappers also ensure that the component gets re-rendered -> whenever you change the state. - - -## Additional Resources - -- [**dioxus_hooks** ](https://docs.rs/dioxus-hooks/latest/dioxus_hooks/) rustdoc - - Documents all hook types included with dioxus by default Most of these are also covered in - later chapters of this guide. -- [Hooks Package](https://github.com/DioxusLabs/dioxus/tree/master/packages/hooks) diff --git a/docs/guide/src/en/interactivity/images/counter.png b/docs/guide/src/en/interactivity/images/counter.png deleted file mode 100644 index dd89cadef3ab7794d1f77b08350b8a2cad434b72..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 11368 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 O00kLk=_*O1;Qs=kxyf1p diff --git a/docs/guide/src/en/interactivity/images/counter_two_state.png b/docs/guide/src/en/interactivity/images/counter_two_state.png deleted file mode 100644 index 4f77942a20ab23ea01784871c7bc977a2baec4a5..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 14503 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

Xr+Mb0o6&U|y=x|mJQEkCNwLvd|7x7mswPA5 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 Element { - let bigger_number = use_memo(cx, (number,), |(number,)| { - // This will only be calculated when `number` has changed. - number * 100 - }); - render!( - p { "{bigger_number}" } - ) -} -fn app(cx: Scope) -> Element { - render!(Calculator { number: 0 }) -} -``` diff --git a/docs/guide/src/en/interactivity/router.md b/docs/guide/src/en/interactivity/router.md deleted file mode 100644 index b4f20eb78..000000000 --- a/docs/guide/src/en/interactivity/router.md +++ /dev/null @@ -1,83 +0,0 @@ -# Router - -In many of your apps, you'll want to have different "scenes". For a webpage, these scenes might be the different webpages with their own content. For a desktop app, these scenes might be different views in your app. - -To unify these platforms, Dioxus provides a first-party solution for scene management called Dioxus Router. - -## What is it? - -For an app like the Dioxus landing page (https://dioxuslabs.com), we want to have several different scenes: - -- Homepage -- Blog - -Each of these scenes is independent – we don't want to render both the homepage and blog at the same time. - -The Dioxus router makes it easy to create these scenes. To make sure we're using the router, add the `dioxus-router` package to your `Cargo.toml`. - -```shell -cargo add dioxus-router -``` - -## Using the router - -Unlike other routers in the Rust ecosystem, our router is built declaratively. This makes it possible to compose our app layout simply by arranging components. - -```rust, no_run -rsx!{ - // All of our routes will be rendered inside this Router component - Router:: { - // if the current location is "/home", render the Home component - Route { to: "/home", Home {} } - // if the current location is "/blog", render the Blog component - Route { to: "/blog", Blog {} } - } -} -``` - -Whenever we visit this app, we will get either the Home component or the Blog component rendered depending on which route we enter at. If neither of these routes match the current location, then nothing will render. - -We can fix this one of two ways: - -- A fallback 404 page - -```rust, no_run -rsx!{ - Router:: { - Route { to: "/home", Home {} } - Route { to: "/blog", Blog {} } - // if the current location doesn't match any of the above routes, render the NotFound component - Route { to: "", NotFound {} } - } -} -``` - -- Redirect 404 to home - -```rust, no_run -rsx!{ - Router:: { - Route { to: "/home", Home {} } - Route { to: "/blog", Blog {} } - // if the current location doesn't match any of the above routes, redirect to "/home" - Redirect { from: "", to: "/home" } - } -} -``` - -## Links - -For our app to navigate these routes, we can provide clickable elements called Links. These simply wrap `` elements that, when clicked, navigate the app to the given location. - -```rust, no_run -rsx!{ - Link { - to: "/home", - "Go home!" - } -} -``` - -## More reading - -This page is just a very brief overview of the router. For more information, check out [the router book](https://dioxuslabs.com/docs/0.3/router/) or some of [the router examples](https://github.com/DioxusLabs/dioxus/blob/master/examples/router.rs). diff --git a/docs/guide/src/en/interactivity/sharing_state.md b/docs/guide/src/en/interactivity/sharing_state.md deleted file mode 100644 index d71fbdec0..000000000 --- a/docs/guide/src/en/interactivity/sharing_state.md +++ /dev/null @@ -1,71 +0,0 @@ -# Sharing State - -Often, multiple components need to access the same state. Depending on your needs, there are several ways to implement this. - -## Lifting State - -One approach to share state between components is to "lift" it up to the nearest common ancestor. This means putting the `use_state` hook in a parent component, and passing the needed values down as props. - -Suppose we want to build a meme editor. We want to have an input to edit the meme caption, but also a preview of the meme with the caption. Logically, the meme and the input are 2 separate components, but they need access to the same state (the current caption). - -> Of course, in this simple example, we could write everything in one component – but it is better to split everything out in smaller components to make the code more reusable, maintainable, and performant (this is even more important for larger, complex apps). - -We start with a `Meme` component, responsible for rendering a meme with a given caption: - -```rust, no_run -{{#include ../../../examples/meme_editor.rs:meme_component}} -``` - -> Note that the `Meme` component is unaware where the caption is coming from – it could be stored in `use_state`, `use_ref`, or a constant. This ensures that it is very reusable – the same component can be used for a meme gallery without any changes! - -We also create a caption editor, completely decoupled from the meme. The caption editor must not store the caption itself – otherwise, how will we provide it to the `Meme` component? Instead, it should accept the current caption as a prop, as well as an event handler to delegate input events to: - -```rust, no_run -{{#include ../../../examples/meme_editor.rs:caption_editor}} -``` - -Finally, a third component will render the other two as children. It will be responsible for keeping the state and passing down the relevant props. - -```rust, no_run -{{#include ../../../examples/meme_editor.rs:meme_editor}} -``` - -![Meme Editor Screenshot: An old plastic skeleton sitting on a park bench. Caption: "me waiting for a language feature"](./images/meme_editor_screenshot.png) - -## Using Shared State - -Sometimes, some state needs to be shared between multiple components far down the tree, and passing it down through props is very inconvenient. - -Suppose now that we want to implement a dark mode toggle for our app. To achieve this, we will make every component select styling depending on whether dark mode is enabled or not. - -> Note: we're choosing this approach for the sake of an example. There are better ways to implement dark mode (e.g. using CSS variables). Let's pretend CSS variables don't exist – welcome to 2013! - -Now, we could write another `use_state` in the top component, and pass `is_dark_mode` down to every component through props. But think about what will happen as the app grows in complexity – almost every component that renders any CSS is going to need to know if dark mode is enabled or not – so they'll all need the same dark mode prop. And every parent component will need to pass it down to them. Imagine how messy and verbose that would get, especially if we had components several levels deep! - -Dioxus offers a better solution than this "prop drilling" – providing context. The [`use_shared_state_provider`](https://docs.rs/dioxus-hooks/latest/dioxus_hooks/fn.use_shared_state_provider.html) hook is similar to `use_ref`, but it makes it available through [`use_shared_state`](https://docs.rs/dioxus-hooks/latest/dioxus_hooks/fn.use_shared_state.html) for all children components. - -First, we have to create a struct for our dark mode configuration: - -```rust, no_run -{{#include ../../../examples/meme_editor_dark_mode.rs:DarkMode_struct}} -``` - -Now, in a top-level component (like `App`), we can provide the `DarkMode` context to all children components: - -```rust, no_run -{{#include ../../../examples/meme_editor_dark_mode.rs:context_provider}} -``` - -As a result, any child component of `App` (direct or not), can access the `DarkMode` context. - -```rust, no_run -{{#include ../../../examples/meme_editor_dark_mode.rs:use_context}} -``` - -> `use_shared_state` returns `Option>` here. If the context has been provided, the value is `Some(UseSharedState)`, which you can call `.read` or `.write` on, similarly to `UseRef`. Otherwise, the value is `None`. - -For example, here's how we would implement the dark mode toggle, which both reads the context (to determine what color it should render) and writes to it (to toggle dark mode): - -```rust, no_run -{{#include ../../../examples/meme_editor_dark_mode.rs:toggle}} -``` diff --git a/docs/guide/src/en/interactivity/user_input.md b/docs/guide/src/en/interactivity/user_input.md deleted file mode 100644 index 6470588e5..000000000 --- a/docs/guide/src/en/interactivity/user_input.md +++ /dev/null @@ -1,33 +0,0 @@ -# User Input - -Interfaces often need to provide a way to input data: e.g. text, numbers, checkboxes, etc. In Dioxus, there are two ways you can work with user input. - -## Controlled Inputs - -With controlled inputs, you are directly in charge of the state of the input. This gives you a lot of flexibility, and makes it easy to keep things in sync. For example, this is how you would create a controlled text input: - -```rust, no_run -{{#include ../../../examples/input_controlled.rs:component}} -``` - -Notice the flexibility – you can: - -- Also display the same contents in another element, and they will be in sync -- Transform the input every time it is modified (e.g. to make sure it is upper case) -- Validate the input every time it changes -- Have custom logic happening when the input changes (e.g. network request for autocompletion) -- Programmatically change the value (e.g. a "randomize" button that fills the input with nonsense) - -## Uncontrolled Inputs - -As an alternative to controlled inputs, you can simply let the platform keep track of the input values. If we don't tell a HTML input what content it should have, it will be editable anyway (this is built into the browser). This approach can be more performant, but less flexible. For example, it's harder to keep the input in sync with another element. - -Since you don't necessarily have the current value of the uncontrolled input in state, you can access it either by listening to `oninput` events (similarly to controlled components), or, if the input is part of a form, you can access the form data in the form events (e.g. `oninput` or `onsubmit`): - -```rust, no_run -{{#include ../../../examples/input_uncontrolled.rs:component}} -``` - -``` -Submitted! UiEvent { data: FormData { value: "", values: {"age": "very old", "date": "1966", "name": "Fred"} } } -``` diff --git a/docs/guide/src/en/lib.rs b/docs/guide/src/en/lib.rs deleted file mode 100644 index 97cda56a8..000000000 --- a/docs/guide/src/en/lib.rs +++ /dev/null @@ -1 +0,0 @@ -// empty (we only need this crate for the examples) diff --git a/docs/guide/src/en/publishing/desktop.md b/docs/guide/src/en/publishing/desktop.md deleted file mode 100644 index f30b0b26d..000000000 --- a/docs/guide/src/en/publishing/desktop.md +++ /dev/null @@ -1,65 +0,0 @@ -# Publishing - -Congrats! You've made your first Dioxus app that actually does some pretty cool stuff. This app uses your operating system's WebView library, so it's portable to be distributed for other platforms. - -In this section, we'll cover how to bundle your app for macOS, Windows, and Linux. - - - -## Install `cargo-bundle` - - -The first thing we'll do is install [`cargo-bundle`](https://github.com/burtonageo/cargo-bundle). This extension to cargo will make it very easy to package our app for the various platforms. - -According to the `cargo-bundle` github page, - - - -*"cargo-bundle is a tool used to generate installers or app bundles for GUI executables built with cargo. It can create .app bundles for Mac OS X and iOS, .deb packages for Linux, and .msi installers for Windows (note however that iOS and Windows support is still experimental). Support for creating .rpm packages (for Linux) and .apk packages (for Android) is still pending."* - - -To install, simply run - - -`cargo install cargo-bundle` - -## Setting up your project - - -To get a project setup for bundling, we need to add some flags to our `Cargo.toml` file. - - -```toml -[package] -name = "example" -# ...other fields... - -[package.metadata.bundle] -name = "DogSearch" -identifier = "com.dogs.dogsearch" -version = "1.0.0" -copyright = "Copyright (c) Jane Doe 2016. All rights reserved." -category = "Developer Tool" -short_description = "Easily search for Dog photos" -long_description = """ -This app makes it quick and easy to browse photos of dogs from over 200 bree -""" -``` - - -## Building - -Following cargo-bundle's instructions, we simply `cargo-bundle --release` to produce a final app with all the optimizations and assets builtin. - -Once you've ran `cargo-bundle --release`, your app should be accessible in - -`target/release/bundle//`. - -For example, a macOS app would look like this: - -![Published App](../images/publish.png) - -Nice! And it's only 4.8 Mb – extremely lean!! Because Dioxus leverages your platform's native WebView, Dioxus apps are extremely memory efficient and won't waste your battery. - -> Note: not all CSS works the same on all platforms. Make sure to view your app's CSS on each platform – or web browser (Firefox, Chrome, Safari) before publishing. - diff --git a/docs/guide/src/en/publishing/index.md b/docs/guide/src/en/publishing/index.md deleted file mode 100644 index 96670f1c8..000000000 --- a/docs/guide/src/en/publishing/index.md +++ /dev/null @@ -1 +0,0 @@ -# Publishing diff --git a/docs/guide/src/en/publishing/web.md b/docs/guide/src/en/publishing/web.md deleted file mode 100644 index 9c285a104..000000000 --- a/docs/guide/src/en/publishing/web.md +++ /dev/null @@ -1,8 +0,0 @@ -## Publishing with Github Pages -To build our app and publish it to Github: - -- Make sure GitHub Pages is set up for your repo -- Build your app with `trunk build --release` (include `--public-url ` to update asset prefixes if using a project site) -- Move your generated HTML/CSS/JS/Wasm from `dist` into the folder configured for Github Pages -- Add and commit with git -- Push to GitHub diff --git a/docs/guide/src/pt-br/SUMMARY.md b/docs/guide/src/pt-br/SUMMARY.md deleted file mode 100644 index 45cc4912f..000000000 --- a/docs/guide/src/pt-br/SUMMARY.md +++ /dev/null @@ -1,43 +0,0 @@ -# SumΓ‘rio - -[Introdução](index.md) - -- [Introdução RΓ‘pida as Plataformas](getting_started/index.md) - - [Desktop](getting_started/desktop.md) - - [Web](getting_started/web.md) - - [Hot Reload](getting_started/hot_reload.md) - - [Renderização por Servidor](getting_started/ssr.md) - - [Interface do Terminal](getting_started/tui.md) - - [MΓ³vel](getting_started/mobile.md) -- [Descrevendo a Interface do UsuΓ‘rio](describing_ui/index.md) - - [Atributos Especiais](describing_ui/special_attributes.md) - - [Componentes](describing_ui/components.md) - - [Props](describing_ui/component_props.md) - - [Componente Filho](describing_ui/component_children.md) -- [Interatividade](interactivity/index.md) - - [Manipuladores de Eventos](interactivity/event_handlers.md) - - [Hooks & Estado de Componentes](interactivity/hooks.md) - - [Entradas do UsuΓ‘rio](interactivity/user_input.md) - - [Estado Compartilhado](interactivity/sharing_state.md) - - [Hooks Personalizados](interactivity/custom_hooks.md) - - [Renderização DinΓ’mica](interactivity/dynamic_rendering.md) - - [Roteamento](interactivity/roteador.md) -- [Assincronia](async/index.md) - - [UseFuture](async/use_future.md) - - [UseCoroutine](async/use_coroutine.md) - - [Gerando Futures](async/spawn.md) -- [PrΓ‘ticas Recomendadas](best_practices/index.md) - - [Tratamento de erros](best_practices/error_handling.md) - - [AntipadrΓ΅es](best_practices/antipatterns.md) -- [Publicação](publishing/index.md) - - [Desktop](publishing/desktop.md) - - [Web](publishing/web.md) - ---- - -- [Renderizador Personalizado](custom_renderer/index.md) - ---- - -[Roteiro](roadmap.md) -[Contribuindo](contributing.md) diff --git a/docs/guide/src/pt-br/async/index.md b/docs/guide/src/pt-br/async/index.md deleted file mode 100644 index ea3cae827..000000000 --- a/docs/guide/src/pt-br/async/index.md +++ /dev/null @@ -1,9 +0,0 @@ -# Trabalhando em Assincronia - -Muitas vezes, os aplicativos precisam interagir com sistemas de arquivos, interfaces de rede, hardware ou temporizadores. Este capΓ­tulo fornece uma visΓ£o geral do uso de cΓ³digo assΓ­ncrono no Dioxus. - -## O Tempo de Execução (runtime) - -Por padrΓ£o, o Dioxus-Desktop vem com o runtime `Tokio` e configura tudo automaticamente para vocΓͺ. No momento, isso nΓ£o Γ© configurΓ‘vel, embora seja fΓ‘cil escrever uma integração para o desktop Dioxus que use um tempo de execução assΓ­ncrono diferente. - -Dioxus atualmente nΓ£o Γ© `thread-safe`, entΓ£o qualquer cΓ³digo assΓ­ncrono que vocΓͺ escreve _nΓ£o_ precisa ser `Send/Sync`. Isso significa que vocΓͺ pode usar estruturas nΓ£o `thread-safe` como `Cell`, `Rc` e `RefCell`. diff --git a/docs/guide/src/pt-br/async/spawn.md b/docs/guide/src/pt-br/async/spawn.md deleted file mode 100644 index 3c00934cf..000000000 --- a/docs/guide/src/pt-br/async/spawn.md +++ /dev/null @@ -1,29 +0,0 @@ -# Gerando Futures - -Os **"hooks"** `use_future` e `use_coroutine` sΓ£o ΓΊteis se vocΓͺ quiser gerar incondicionalmente o `Future`. Γ€s vezes, porΓ©m, vocΓͺ desejarΓ‘ apenas gerar um `Future` em resposta a um evento, como um clique do mouse. Por exemplo, suponha que vocΓͺ precise enviar uma solicitação quando o usuΓ‘rio clicar em um botΓ£o "log in". Para isso, vocΓͺ pode usar `cx.spawn`: - -```rust, no_run -{{#include ../../../examples/spawn.rs:spawn}} -``` - -> Nota: `spawn` sempre gerarΓ‘ um _novo_ `Future`. VocΓͺ provavelmente nΓ£o quer chamΓ‘-lo em cada renderização. - -O `Future` deve ser `'static` – entΓ£o quaisquer valores capturados pela tarefa nΓ£o podem carregar nenhuma referΓͺncia a `cx`, como um `UseState`. - -No entanto, como vocΓͺ normalmente precisa de uma maneira de atualizar o valor de um gancho, vocΓͺ pode usar `to_owned` para criar um clone do _handle_ do _hook_. VocΓͺ pode entΓ£o usar esse clone no encerramento assΓ­ncrono. - -Para tornar isso um pouco menos detalhado, o Dioxus exporta a macro `to_owned!` que criarΓ‘ uma ligação como mostrado acima, o que pode ser bastante ΓΊtil ao lidar com muitos valores. - -```rust, no_run -{{#include ../../../examples/spawn.rs:to_owned_macro}} -``` - -Calling `spawn` will give you a `JoinHandle` which lets you cancel or pause the future. - -## Gerando Tarefas do Tokio - -Γ€s vezes, vocΓͺ pode querer gerar uma tarefa em segundo plano que precise de vΓ‘rios _threads_ ou conversar com o hardware que pode bloquear o cΓ³digo do seu aplicativo. Nesses casos, podemos gerar diretamente uma tarefa Tokio do nosso `Future`. Para Dioxus-Desktop, sua tarefa serΓ‘ gerada no tempo de execução Multi-Tarefado do Tokio: - -```rust, no_run -{{#include ../../../examples/spawn.rs:tokio}} -``` diff --git a/docs/guide/src/pt-br/async/use_coroutine.md b/docs/guide/src/pt-br/async/use_coroutine.md deleted file mode 100644 index cb9eda3a0..000000000 --- a/docs/guide/src/pt-br/async/use_coroutine.md +++ /dev/null @@ -1,181 +0,0 @@ -# Corrotinas - -Outra boa ferramenta para manter em sua caixa de ferramentas assΓ­ncrona sΓ£o as corrotinas. Corrotinas sΓ£o `Futures` que podem ser interrompidos, iniciados, pausados e retomados manualmente. - -Assim como os `Futures` regulares, o cΓ³digo em uma corrotina Dioxus serΓ‘ executado atΓ© o prΓ³ximo ponto `await` antes do _render_. Esse controle de baixo nΓ­vel sobre tarefas assΓ­ncronas Γ© bastante poderoso, permitindo tarefas em _loop_ infinito, como pesquisa de WebSocket, temporizadores em segundo plano e outras açáes periΓ³dicas. - -## `use_coroutine` - -A configuração bΓ‘sica para corrotinas Γ© o _hook_ `use_coroutine`. A maioria das corrotinas que escrevemos serΓ£o _loops_ de pesquisa usando `async`/`await`. - -```rust, no_run -fn app(cx: Scope) -> Element { - let ws: &UseCoroutine<()> = use_coroutine(cx, |rx| async move { - // Connect to some sort of service - let mut conn = connect_to_ws_server().await; - - // Wait for data on the service - while let Some(msg) = conn.next().await { - // handle messages - } - }); -} -``` - -Para muitos serviΓ§os, um _loop_ assΓ­ncrono simples lidarΓ‘ com a maioria dos casos de uso. - -No entanto, se quisermos desabilitar temporariamente a corrotina, podemos "pausΓ‘-la" usando o mΓ©todo `pause` e "retomΓ‘-la" usando o mΓ©todo `resume`: - -```rust, no_run -let sync: &UseCoroutine<()> = use_coroutine(cx, |rx| async move { - // code for syncing -}); - -if sync.is_running() { - cx.render(rsx!{ - button { - onclick: move |_| sync.pause(), - "Disable syncing" - } - }) -} else { - cx.render(rsx!{ - button { - onclick: move |_| sync.resume(), - "Enable syncing" - } - }) -} -``` - -Esse padrΓ£o Γ© onde as corrotinas sΓ£o extremamente ΓΊteis – em vez de escrever toda a lΓ³gica complicada para pausar nossas tarefas assΓ­ncronas como farΓ­amos com `Promises` de JavaScript, o modelo do Rust nos permite simplesmente nΓ£o pesquisar nosso `Future`. - -## Enviando valores - -VocΓͺ deve ter notado que o encerramento `use_coroutine` recebe um argumento chamado `rx`. O que Γ© aquilo? Bem, um padrΓ£o comum em aplicativos complexos Γ© lidar com vΓ‘rios cΓ³digos assΓ­ncronos de uma sΓ³ vez. Com bibliotecas como o Redux Toolkit, gerenciar vΓ‘rias promessas ao mesmo tempo pode ser um desafio e uma fonte comum de _bugs_. - -Usando corrotinas, temos a oportunidade de centralizar nossa lΓ³gica assΓ­ncrona. O parΓ’metro `rx` Γ© um canal ilimitado para cΓ³digo externo Γ  corrotina para enviar dados _para_ a corrotina. Em vez de fazer um _loop_ em um serviΓ§o externo, podemos fazer um _loop_ no prΓ³prio canal, processando mensagens de dentro de nosso aplicativo sem precisar gerar um novo `Future`. Para enviar dados para a corrotina, chamarΓ­amos "send" no _handle_. - -```rust, no_run -enum ProfileUpdate { - SetUsername(String), - SetAge(i32) -} - -let profile = use_coroutine(cx, |mut rx: UnboundedReciver| async move { - let mut server = connect_to_server().await; - - while let Ok(msg) = rx.next().await { - match msg { - ProfileUpdate::SetUsername(name) => server.update_username(name).await, - ProfileUpdate::SetAge(age) => server.update_age(age).await, - } - } -}); - - -cx.render(rsx!{ - button { - onclick: move |_| profile.send(ProfileUpdate::SetUsername("Bob".to_string())), - "Update username" - } -}) -``` - -Para aplicativos suficientemente complexos, poderΓ­amos criar vΓ‘rios "serviΓ§os" ΓΊteis diferentes que fazem um _loop_ nos canais para atualizar o aplicativo. - -```rust, no_run -let profile = use_coroutine(cx, profile_service); -let editor = use_coroutine(cx, editor_service); -let sync = use_coroutine(cx, sync_service); - -async fn profile_service(rx: UnboundedReceiver) { - // do stuff -} - -async fn sync_service(rx: UnboundedReceiver) { - // do stuff -} - -async fn editor_service(rx: UnboundedReceiver) { - // do stuff -} -``` - -Podemos combinar corrotinas com `Fermi` para emular o sistema `Thunk` do **Redux Toolkit** com muito menos dor de cabeΓ§a. Isso nos permite armazenar todo o estado do nosso aplicativo _dentro_ de uma tarefa e, em seguida, simplesmente atualizar os valores de "visualização" armazenados em `Atoms`. NΓ£o pode ser subestimado o quΓ£o poderosa Γ© essa tΓ©cnica: temos todas as vantagens das tarefas nativas do Rust com as otimizaçáes e ergonomia do estado global. Isso significa que seu estado _real_ nΓ£o precisa estar vinculado a um sistema como `Fermi` ou `Redux` – os ΓΊnicos `Atoms` que precisam existir sΓ£o aqueles que sΓ£o usados para controlar a interface. - -```rust, no_run -static USERNAME: Atom = Atom(|_| "default".to_string()); - -fn app(cx: Scope) -> Element { - let atoms = use_atom_root(cx); - - use_coroutine(cx, |rx| sync_service(rx, atoms.clone())); - - cx.render(rsx!{ - Banner {} - }) -} - -fn Banner(cx: Scope) -> Element { - let username = use_read(cx, &USERNAME); - - cx.render(rsx!{ - h1 { "Welcome back, {username}" } - }) -} -``` - -Agora, em nosso serviΓ§o de sincronização, podemos estruturar nosso estado como quisermos. SΓ³ precisamos atualizar os valores da _view_ quando estiver pronto. - -```rust, no_run -enum SyncAction { - SetUsername(String), -} - -async fn sync_service(mut rx: UnboundedReceiver, atoms: AtomRoot) { - let username = atoms.write(&USERNAME); - let errors = atoms.write(&ERRORS); - - while let Ok(msg) = rx.next().await { - match msg { - SyncAction::SetUsername(name) => { - if set_name_on_server(&name).await.is_ok() { - username.set(name); - } else { - errors.make_mut().push("SetUsernameFailed"); - } - } - } - } -} -``` - -## Valores de Rendimento - -Para obter valores de uma corrotina, basta usar um identificador `UseState` e definir o valor sempre que sua corrotina concluir seu trabalho. - -```rust, no_run -let sync_status = use_state(cx, || Status::Launching); -let sync_task = use_coroutine(cx, |rx: UnboundedReceiver| { - to_owned![sync_status]; - async move { - loop { - delay_ms(1000).await; - sync_status.set(Status::Working); - } - } -}) -``` - -## Injeção AutomΓ‘tica na API de Contexto - -Os identificadores de corrotina sΓ£o injetados automaticamente por meio da API de contexto. `use_coroutine_handle` com o tipo de mensagem como genΓ©rico pode ser usado para buscar um _handle_. - -```rust, no_run -fn Child(cx: Scope) -> Element { - let sync_task = use_coroutine_handle::(cx); - - sync_task.send(SyncAction::SetUsername); -} -``` diff --git a/docs/guide/src/pt-br/async/use_future.md b/docs/guide/src/pt-br/async/use_future.md deleted file mode 100644 index 1e7030ddf..000000000 --- a/docs/guide/src/pt-br/async/use_future.md +++ /dev/null @@ -1,31 +0,0 @@ -# `UseFuture` - -[`use_future`](https://docs.rs/dioxus-hooks/latest/dioxus_hooks/fn.use_future.html) permite executar um encerramento assΓ­ncrono e fornece seu resultado. - -Por exemplo, podemos fazer uma solicitação de API dentro de `use_future`: - -```rust, no_run -{{#include ../../../examples/use_future.rs:use_future}} -``` - -O cΓ³digo dentro de `use_future` serΓ‘ enviado ao agendador do Dioxus assim que o componente for renderizado. - -Podemos usar `.value()` para obter o resultado do `Future`. Na primeira execução, como nΓ£o hΓ‘ dados prontos quando o componente Γ© carregado, seu valor serΓ‘ `None`. No entanto, uma vez finalizado o `Future`, o componente serΓ‘ renderizado novamente e o valor agora serΓ‘ `Some(...)`, contendo o valor de retorno do encerramento. - -Podemos entΓ£o renderizar esse resultado: - -```rust, no_run -{{#include ../../../examples/use_future.rs:render}} -``` - -## Reiniciando o `Future` - -O identificador `UseFuture` fornece um mΓ©todo `restart`. Ele pode ser usado para executar o `Future` novamente, produzindo um novo valor. - -## DependΓͺncias - -Muitas vezes, vocΓͺ precisarΓ‘ executar o `Future` novamente toda vez que algum valor (por exemplo, uma prop) mudar. Ao invΓ©s de `.restart` manualmente, vocΓͺ pode fornecer uma tupla de "dependΓͺncias" para o gancho. Ele executarΓ‘ automaticamente o `Future` quando qualquer uma dessas dependΓͺncias for alterada. Exemplo: - -```rust, no_run -{{#include ../../../examples/use_future.rs:dependency}} -``` diff --git a/docs/guide/src/pt-br/best_practices/antipatterns.md b/docs/guide/src/pt-br/best_practices/antipatterns.md deleted file mode 100644 index fa57ba125..000000000 --- a/docs/guide/src/pt-br/best_practices/antipatterns.md +++ /dev/null @@ -1,33 +0,0 @@ -# AntipadrΓ΅es - -Este exemplo mostra o que nΓ£o fazer e fornece uma razΓ£o pela qual um determinado padrΓ£o Γ© considerado um "AntiPattern". A maioria dos antipadrΓ΅es sΓ£o considerados errados por motivos de desempenho ou por prejudicar a reutilização do cΓ³digo. - -## Fragmentos Aninhados Desnecessariamente - -Os fragmentos nΓ£o montam um elemento fΓ­sico no DOM imediatamente, entΓ£o o Dioxus deve recorrer a seus filhos para encontrar um nΓ³ DOM fΓ­sico. Este processo Γ© chamado de "normalização". Isso significa que fragmentos profundamente aninhados fazem o Dioxus realizar um trabalho desnecessΓ‘rio. Prefira um ou dois nΓ­veis de fragmentos/componentes aninhados atΓ© apresentar um elemento DOM verdadeiro. - -Apenas os nΓ³s Componente e Fragmento sΓ£o suscetΓ­veis a esse problema. O Dioxus atenua isso com componentes fornecendo uma API para registrar o estado compartilhado sem o padrΓ£o _Context Provider_. - -```rust, no_run -{{#include ../../../examples/anti_patterns.rs:nested_fragments}} -``` - -## Chaves do Iterador Incorretas - -Conforme descrito no capΓ­tulo de renderização condicional, os itens da lista devem ter _keys_ exclusivas associadas aos mesmos itens nas renderizaçáes. Isso ajuda o Dioxus a associar o estado aos componentes contidos e garante um bom desempenho de diferenciação. NΓ£o omita as _keys_, a menos que vocΓͺ saiba que a lista Γ© estΓ‘tica e nunca serΓ‘ alterada. - -```rust, no_run -{{#include ../../../examples/anti_patterns.rs:iter_keys}} -``` - -## Evite Mutabilidade Interior em `Props` - -Embora seja tecnicamente aceitΓ‘vel ter um `Mutex` ou um `RwLock` nos _props_, eles serΓ£o difΓ­ceis de usar. - -Suponha que vocΓͺ tenha um _struct_ `User` contendo o campo `username: String`. Se vocΓͺ passar uma _prop_ `Mutex` para um componente `UserComponent`, esse componente pode querer passar o nome de usuΓ‘rio como uma _prop_ `&str` para um componente filho. No entanto, ele nΓ£o pode passar esse campo emprestado, pois ele sΓ³ viveria enquanto o bloqueio do `Mutex`, que pertence Γ  função `UserComponent`. Portanto, o componente serΓ‘ forΓ§ado a clonar o campo `username`. - -## Evite Atualizar o Estado Durante a Renderização - -Toda vez que vocΓͺ atualiza o estado, o Dioxus precisa renderizar novamente o componente – isso Γ© ineficiente! Considere refatorar seu cΓ³digo para evitar isso. - -AlΓ©m disso, se vocΓͺ atualizar incondicionalmente o estado durante a renderização, ele serΓ‘ renderizado novamente em um _loop_ infinito. diff --git a/docs/guide/src/pt-br/best_practices/error_handling.md b/docs/guide/src/pt-br/best_practices/error_handling.md deleted file mode 100644 index 2fec8d88d..000000000 --- a/docs/guide/src/pt-br/best_practices/error_handling.md +++ /dev/null @@ -1,153 +0,0 @@ -# Manipulação de Erros - -Um ponto forte do Rust para desenvolvimento Web Γ© a confiabilidade de sempre saber onde os erros podem ocorrer e ser forΓ§ado a lidar com eles - -No entanto, nΓ£o falamos sobre tratamento de erros neste guia! Neste capΓ­tulo, abordaremos algumas estratΓ©gias para lidar com erros para garantir que seu aplicativo nunca falhe. - -## O mais simples – retornando None - -Observadores astutos podem ter notado que `Element` Γ© na verdade um alias de tipo para `Option`. VocΓͺ nΓ£o precisa saber o que Γ© um `VNode`, mas Γ© importante reconhecer que nΓ£o poderΓ­amos retornar nada: - -```rust, no_run -fn App(cx: Scope) -> Element { - None -} -``` - -Isso nos permite adicionar um pouco de açúcar sintΓ‘tico para operaçáes que achamos que _nΓ£o devem_ falhar, mas ainda nΓ£o estamos confiantes o suficiente para "desempacotar". - -> A natureza de `Option` pode mudar no futuro Γ  medida que a caracterΓ­stica `try` for atualizada. - -```rust, no_run -fn App(cx: Scope) -> Element { - // immediately return "None" - let name = cx.use_hook(|_| Some("hi"))?; -} -``` - -## Retorno Antecipado do Resultado - -Como o Rust nΓ£o pode aceitar opçáes e resultados com a infraestrutura _try_ existente, vocΓͺ precisarΓ‘ manipular os resultados manualmente. Isso pode ser feito convertendo-os em `Option` ou manipulando-os explicitamente. - -```rust, no_run -fn App(cx: Scope) -> Element { - // Convert Result to Option - let name = cx.use_hook(|_| "1.234").parse().ok()?; - - - // Early return - let count = cx.use_hook(|_| "1.234"); - let val = match count.parse() { - Ok(val) => val - Err(err) => return cx.render(rsx!{ "Parsing failed" }) - }; -} -``` - -Observe que enquanto os ganchos no Dioxus nΓ£o gostam de ser chamados em condicionais ou loops, eles _estΓ£o_ bem com retornos antecipados. Retornar um estado de erro antecipadamente Γ© uma maneira completamente vΓ‘lida de lidar com erros. - -## Resultados usando `match` - -A prΓ³xima "melhor" maneira de lidar com erros no Dioxus Γ© combinar (`match`) o erro localmente. Essa Γ© a maneira mais robusta de lidar com erros, embora nΓ£o seja dimensionada para arquiteturas alΓ©m de um ΓΊnico componente. - -Para fazer isso, simplesmente temos um estado de erro embutido em nosso componente: - -```rust, no_run -let err = use_state(cx, || None); -``` - -Sempre que realizarmos uma ação que gere um erro, definiremos esse estado de erro. Podemos entΓ£o combinar o erro de vΓ‘rias maneiras (retorno antecipado, elemento de retorno etc.). - -```rust, no_run -fn Commandline(cx: Scope) -> Element { - let error = use_state(cx, || None); - - cx.render(match *error { - Some(error) => rsx!( - h1 { "An error occured" } - ) - None => rsx!( - input { - oninput: move |_| error.set(Some("bad thing happened!")), - } - ) - }) -} -``` - -## Passando Estados de Erro AtravΓ©s de Componentes - -Se vocΓͺ estiver lidando com alguns componentes com um mΓ­nimo de aninhamento, basta passar o identificador de erro para componentes filhos. - -```rust, no_run -fn Commandline(cx: Scope) -> Element { - let error = use_state(cx, || None); - - if let Some(error) = **error { - return cx.render(rsx!{ "An error occured" }); - } - - cx.render(rsx!{ - Child { error: error.clone() } - Child { error: error.clone() } - Child { error: error.clone() } - Child { error: error.clone() } - }) -} -``` - -Assim como antes, nossos componentes filhos podem definir manualmente o erro durante suas prΓ³prias açáes. A vantagem desse padrΓ£o Γ© que podemos isolar facilmente os estados de erro para alguns componentes por vez, tornando nosso aplicativo mais previsΓ­vel e robusto. - -## Tornando Global - -Uma estratΓ©gia para lidar com erros em cascata em aplicativos maiores Γ© sinalizar um erro usando o estado global. Esse padrΓ£o especΓ­fico envolve a criação de um contexto de "erro" e, em seguida, defini-lo sempre que relevante. Este mΓ©todo em particular nΓ£o Γ© tΓ£o "sofisticado" quanto o controle de erros do React, mas Γ© mais adequado para Rust. - -Para comeΓ§ar, considere usar um _hook_ embutido como `use_context` e `use_context_provider` ou `Fermi`. Claro, Γ© muito fΓ‘cil criar seu prΓ³prio _hook_ tambΓ©m. - -No "topo" de nossa arquitetura, queremos declarar explicitamente um valor que pode ser um erro. - -```rust, no_run -enum InputError { - None, - TooLong, - TooShort, -} - -static INPUT_ERROR: Atom = Atom(|_| InputError::None); -``` - -EntΓ£o, em nosso componente de nΓ­vel superior, queremos tratar explicitamente o possΓ­vel estado de erro para esta parte da Γ‘rvore. - -```rust, no_run -fn TopLevel(cx: Scope) -> Element { - let error = use_read(cx, &INPUT_ERROR); - - match error { - TooLong => return cx.render(rsx!{ "FAILED: Too long!" }), - TooShort => return cx.render(rsx!{ "FAILED: Too Short!" }), - _ => {} - } -} -``` - -Agora, sempre que um componente _downstream_ tiver um erro em suas açáes, ele pode simplesmente definir seu prΓ³prio estado de erro: - -```rust, no_run -fn Commandline(cx: Scope) -> Element { - let set_error = use_set(cx, &INPUT_ERROR); - - cx.render(rsx!{ - input { - oninput: move |evt| { - if evt.value.len() > 20 { - set_error(InputError::TooLong); - } - } - } - }) -} -``` - -Essa abordagem de tratamento de erros Γ© melhor em aplicativos que tΓͺm estados de erro "bem definidos". Considere usar uma `crate` como `thiserror` ou `anyhow` para simplificar a geração dos tipos de erro. - -Esse padrΓ£o Γ© amplamente popular em muitos contextos e Γ© particularmente ΓΊtil sempre que seu cΓ³digo gera um erro irrecuperΓ‘vel. VocΓͺ pode capturar esses estados de erro "globais" resultar em `panic!` ou estragar o estado. diff --git a/docs/guide/src/pt-br/best_practices/index.md b/docs/guide/src/pt-br/best_practices/index.md deleted file mode 100644 index ee8506241..000000000 --- a/docs/guide/src/pt-br/best_practices/index.md +++ /dev/null @@ -1,14 +0,0 @@ -# PrΓ‘ticas Recomendadas - -## Componentes ReutilizΓ‘veis - -Tanto quanto possΓ­vel, divida seu cΓ³digo em pequenos componentes e _hooks_ reutilizΓ‘veis, em vez de implementar grandes partes da interface do usuΓ‘rio em um ΓΊnico componente. Isso ajudarΓ‘ vocΓͺ a manter o cΓ³digo sustentΓ‘vel – Γ© muito mais fΓ‘cil, por exemplo, adicionar, remover ou reordenar partes da interface do usuΓ‘rio se ela estiver organizada em componentes. - -Organize seus componentes em mΓ³dulos para manter a base de cΓ³digo fΓ‘cil de navegar! - -## Minimize as DependΓͺncias do Estado - -Embora seja possΓ­vel compartilhar o estado entre os componentes, isso sΓ³ deve ser feito quando necessΓ‘rio. Qualquer componente associado a um objeto de estado especΓ­fico precisa ser renderizado novamente quando esse estado for alterado. Por esta razΓ£o: - -- Mantenha o estado local para um componente, se possΓ­vel -- Ao compartilhar o estado por meio de adereΓ§os, passe apenas os dados especΓ­ficos necessΓ‘rios diff --git a/docs/guide/src/pt-br/contributing.md b/docs/guide/src/pt-br/contributing.md deleted file mode 100644 index 404a174db..000000000 --- a/docs/guide/src/pt-br/contributing.md +++ /dev/null @@ -1,20 +0,0 @@ -# Contribuindo - -O desenvolvimento acontece no [repositΓ³rio do Dioxus no GitHub](https://github.com/DioxusLabs/dioxus). Se vocΓͺ encontrou um bug ou tem uma ideia para um recurso, envie um _issue_ (verifique se alguΓ©m ainda nΓ£o o fez (https://github.com/DioxusLabs/dioxus/issues)). - -[DiscussΓ΅es do GitHub](https://github.com/DioxusLabs/dioxus/discussions) podem ser usadas como um lugar para pedir ajuda ou falar sobre recursos. VocΓͺ tambΓ©m pode participar do [nosso canal Discord](https://discord.gg/XgGxMSkvUM) onde algumas discussΓ΅es de desenvolvimento acontecem. - -## Como melhorar os documentos - -Se vocΓͺ quiser melhorar os documentos, os PRs sΓ£o bem-vindos! Ambos os documentos do Rust ([source](https://github.com/DioxusLabs/dioxus/tree/master/packages)) e este guia ([source](https://github.com/DioxusLabs/dioxus/tree/master /docs/guide)) pode ser encontrado no repositΓ³rio do GitHub. - -## Trabalhando no Ecossistema - -Parte do que torna o React Γ³timo Γ© o rico ecossistema. GostarΓ­amos do mesmo para Dioxus! Portanto, se vocΓͺ tem uma biblioteca em mente que gostaria de escrever e da qual acha que muitas pessoas se beneficiariam, ela serΓ‘ apreciada. VocΓͺ pode [navegar no npm.js](https://www.npmjs.com/search?q=keywords:react-component) para se inspirar. - -## Bugs e recursos - -Se vocΓͺ corrigiu [um problema aberto](https://github.com/DioxusLabs/dioxus/issues), sinta-se Γ  vontade para enviar um PR! VocΓͺ tambΓ©m pode dar uma olhada no [roteiro](./roadmap.md) e trabalhar em algo lΓ‘. Considere [entre em contato](https://discord.gg/XgGxMSkvUM) com a equipe primeiro para garantir que todos estejam na mesma pΓ‘gina e que vocΓͺ nΓ£o faΓ§a um trabalho inΓΊtil! - -Todas as solicitaçáes de PR (incluindo aquelas feitas por um membro da equipe) devem ser aprovadas por pelo menos um outro membro da equipe. -DecisΓ΅es maiores e mais sutis sobre design, arquitetura, mudanΓ§as de ΓΊltima hora, trade-offs, etc. sΓ£o feitas por consenso da equipe. diff --git a/docs/guide/src/pt-br/custom_renderer/index.md b/docs/guide/src/pt-br/custom_renderer/index.md deleted file mode 100644 index 195f9d6ca..000000000 --- a/docs/guide/src/pt-br/custom_renderer/index.md +++ /dev/null @@ -1,505 +0,0 @@ -# Renderizador Personalizado - -Dioxus Γ© uma estrutura incrivelmente portΓ‘til para desenvolvimento de interface do usuΓ‘rio. As liçáes, conhecimentos, _hooks_ e componentes que vocΓͺ adquire ao longo do tempo sempre podem ser usados ​​para projetos futuros. No entanto, Γ s vezes, esses projetos nΓ£o podem aproveitar um renderizador compatΓ­vel ou vocΓͺ precisa implementar seu prΓ³prio renderizador melhor. - -Γ“timas notΓ­cias: o design do renderizador depende inteiramente de vocΓͺ! NΓ³s fornecemos sugestΓ΅es e inspiração com os renderizadores originais, mas sΓ³ realmente precisamos processar `DomEdits` e enviar `UserEvents`. - -## Detalhes - -A implementação do renderizador Γ© bastante simples. O renderizador precisa: - -1. Lidar com o fluxo de ediçáes gerado por atualizaçáes no DOM virtual -2. Registrar ouvintes e passar eventos para o sistema de eventos do DOM virtual - -Essencialmente, seu renderizador precisa implementar a `trait` `RealDom` e gerar objetos `EventTrigger` para atualizar o `VirtualDOM`. A partir daΓ­, vocΓͺ terΓ‘ tudo o que precisa para renderizar o `VirtualDOM` na tela. - -Internamente, o Dioxus lida com o relacionamento da Γ‘rvore, `diffing`, gerenciamento de memΓ³ria e o sistema de eventos, deixando o mΓ­nimo necessΓ‘rio para que os renderizadores se implementem. - -Como referΓͺncia, confira o interpretador `javascript` ou o renderizador `tui` como ponto de partida para seu renderizador personalizado. - -## DomEdit - -O tipo "DomEdit" Γ© uma `enum` serializada que representa uma operação atΓ΄mica que ocorre no `RealDom`. As variantes seguem aproximadamente este conjunto: - -```rust, no_run -enum DomEdit { - PushRoot, - AppendChildren, - ReplaceWith, - InsertAfter, - InsertBefore, - Remove, - CreateTextNode, - CreateElement, - CreateElementNs, - CreatePlaceholder, - NewEventListener, - RemoveEventListener, - SetText, - SetAttribute, - RemoveAttribute, - PopRoot, -} -``` - -O mecanismo de diferenciação Dioxus opera como uma [mΓ‘quina de pilha] (https://en.wikipedia.org/wiki/Stack_machine) onde o mΓ©todo "push_root" empurra um novo nΓ³ DOM "real" para a pilha e "append_child" e "replace_with" " ambos removem nΓ³s da pilha. - -### Exemplo - -Para fins de compreensΓ£o, vamos considerar este exemplo – uma declaração de interface do usuΓ‘rio muito simples: - -```rust, no_run -rsx!( h1 {"hello world"} ) -``` - -Para comeΓ§ar, o Dioxus deve primeiro navegar atΓ© o contΓͺiner dessa tag h1. Para "navegar" aqui, o algoritmo de diferenciação interna gera o `DomEdit` `PushRoot` onde o ID da raiz Γ© o contΓͺiner. - -Quando o renderizador recebe essa instrução, ele empurra o `Node` real para sua prΓ³pria pilha. A pilha do renderizador real ficarΓ‘ assim: - -```rust, no_run -instructions: [ - PushRoot(Container) -] -stack: [ - ContainerNode, -] -``` - -Em seguida, o Dioxus encontrarΓ‘ o nΓ³ `h1`. O algoritmo `diff` decide que este nΓ³ precisa ser criado, entΓ£o o Dioxus irΓ‘ gerar o DomEdit `CreateElement`. Quando o renderizador receber esta instrução, ele criarΓ‘ um nΓ³ desmontado e o enviarΓ‘ para sua prΓ³pria pilha (_stack_): - -```rust, no_run -instructions: [ - PushRoot(Container), - CreateElement(h1), -] -stack: [ - ContainerNode, - h1, -] -``` - -Em seguida, Dioxus vΓͺ o nΓ³ de texto e gera o DomEdit `CreateTextNode`: - -```rust, no_run -instructions: [ - PushRoot(Container), - CreateElement(h1), - CreateTextNode("hello world") -] -stack: [ - ContainerNode, - h1, - "hello world" -] -``` - -Lembre-se, o nΓ³ de texto nΓ£o estΓ‘ anexado a nada (ele estΓ‘ desmontado), entΓ£o o Dioxus precisa gerar um _Edit_ que conecte o nΓ³ de texto ao elemento `h1`. Depende da situação, mas neste caso usamos `AppendChildren`. Isso remove o nΓ³ de texto da _stack_, deixando o elemento `h1` como o prΓ³ximo elemento na linha. - -```rust, no_run -instructions: [ - PushRoot(Container), - CreateElement(h1), - CreateTextNode("hello world"), - AppendChildren(1) -] -stack: [ - ContainerNode, - h1 -] -``` - -Chamamos `AppendChildren` novamente, retirando o nΓ³ `h1` e anexando-o ao pai: - -```rust, no_run -instructions: [ - PushRoot(Container), - CreateElement(h1), - CreateTextNode("hello world"), - AppendChildren(1), - AppendChildren(1) -] -stack: [ - ContainerNode, -] -``` - -Finalmente, o contΓͺiner Γ© aberto, pois nΓ£o precisamos mais dele. - -```rust, no_run -instructions: [ - PushRoot(Container), - CreateElement(h1), - CreateTextNode("hello world"), - AppendChildren(1), - AppendChildren(1), - PopRoot -] -stack: [] -``` - -Com o tempo, nossa _stack_ ficou assim: - -```rust, no_run -[] -[Container] -[Container, h1] -[Container, h1, "hello world"] -[Container, h1] -[Container] -[] -``` - -Observe como nossa _stack_ fica vazia depois que a interface do usuΓ‘rio Γ© montada. Convenientemente, essa abordagem separa completamente o `VirtualDOM` e o `RealDOM`. AlΓ©m disso, essas ediçáes sΓ£o serializΓ‘veis, o que significa que podemos atΓ© gerenciar UIs em uma conexΓ£o de rede. Esta pequena _stack_ e ediçáes serializadas tornam o Dioxus independente das especificidades da plataforma. - -Dioxus tambΓ©m Γ© muito rΓ‘pido. Como o Dioxus divide a fase de `diff` e `patch`, ele Γ© capaz de fazer todas as ediçáes no `RealDOM` em um perΓ­odo de tempo muito curto (menos de um ΓΊnico quadro), tornando a renderização muito rΓ‘pida. Ele tambΓ©m permite que o Dioxus cancele grandes operaçáes de diferenciação se ocorrer um trabalho de prioridade mais alta durante a diferenciação. - -Γ‰ importante notar que hΓ‘ uma camada de conexΓ£o entre o Dioxus e o renderizador. Dioxus salva e carrega elementos (a edição `PushRoot`) com um ID. Dentro do `VirtualDOM`, isso Γ© rastreado apenas como um `u64`. - -Sempre que uma edição `CreateElement` Γ© gerada durante a comparação, o Dioxus incrementa seu contador de nΓ³s e atribui a esse novo elemento seu `NodeCount` atual. O `RealDom` Γ© responsΓ‘vel por lembrar este ID e enviar o nΓ³ correto quando `PushRoot(ID)` Γ© gerado. Dioxus recupera IDs de elementos quando removidos. Para ficar em sincronia com Dioxus, vocΓͺ pode usar um `Sparce Vec` (`Vec>`) com itens possivelmente desocupados. VocΓͺ pode usar os ids como Γ­ndices no `Vec` para elementos e aumentar o `Vec` quando um id nΓ£o existir. - -Esta pequena demonstração serve para mostrar exatamente como um Renderer precisaria processar um stream de edição para construir UIs. Um conjunto de `DomEdits` serializados para vΓ‘rias demos estΓ‘ disponΓ­vel para vocΓͺ testar seu renderizador personalizado. - -## Ciclo de Eventos - -Como a maioria das GUIs, o Dioxus conta com um _loop_ de eventos para progredir no `VirtualDOM`. O prΓ³prio `VirtualDOM` tambΓ©m pode produzir eventos, por isso Γ© importante que seu renderizador personalizado tambΓ©m possa lidar com eles. - -O cΓ³digo para a implementação do `WebSys` Γ© direto, entΓ£o vamos adicionΓ‘-lo aqui para demonstrar como um `loop` de eventos Γ© simples: - -```rust, no_run -pub async fn run(&mut self) -> dioxus_core::error::Result<()> { - // Push the body element onto the WebsysDom's stack machine - let mut websys_dom = crate::new::WebsysDom::new(prepare_websys_dom()); - websys_dom.stack.push(root_node); - - // Rebuild or hydrate the virtualdom - let mutations = self.internal_dom.rebuild(); - websys_dom.apply_mutations(mutations); - - // Wait for updates from the real dom and progress the virtual dom - loop { - let user_input_future = websys_dom.wait_for_event(); - let internal_event_future = self.internal_dom.wait_for_work(); - - match select(user_input_future, internal_event_future).await { - Either::Left((_, _)) => { - let mutations = self.internal_dom.work_with_deadline(|| false); - websys_dom.apply_mutations(mutations); - }, - Either::Right((event, _)) => websys_dom.handle_event(event), - } - - // render - } -} -``` - -Γ‰ importante que vocΓͺ decodifique os eventos reais do seu sistema de eventos no sistema de eventos sintΓ©tico do Dioxus (entenda sintΓ©tico como abstraΓ­do). Isso significa simplesmente combinar seu tipo de evento e criar um tipo Dioxus `UserEvent`. No momento, o sistema `VirtualEvent` Γ© modelado quase inteiramente em torno da especificação HTML, mas estamos interessados em reduzi-lo. - -```rust, no_run -fn virtual_event_from_websys_event(event: &web_sys::Event) -> VirtualEvent { - match event.type_().as_str() { - "keydown" => { - let event: web_sys::KeyboardEvent = event.clone().dyn_into().unwrap(); - UserEvent::KeyboardEvent(UserEvent { - scope_id: None, - priority: EventPriority::Medium, - name: "keydown", - // This should be whatever element is focused - element: Some(ElementId(0)), - data: Arc::new(KeyboardData{ - char_code: event.char_code(), - key: event.key(), - key_code: event.key_code(), - alt_key: event.alt_key(), - ctrl_key: event.ctrl_key(), - meta_key: event.meta_key(), - shift_key: event.shift_key(), - location: event.location(), - repeat: event.repeat(), - which: event.which(), - }) - }) - } - _ => todo!() - } -} -``` - -## Elementos brutos personalizados - -Se vocΓͺ precisa ir tΓ£o longe a ponto de confiar em elementos personalizados para o seu renderizador – vocΓͺ pode. Isso ainda permite que vocΓͺ use a natureza reativa do Dioxus, sistema de componentes, estado compartilhado e outros recursos, mas acabarΓ‘ gerando nΓ³s diferentes. Todos os atributos e ouvintes para o namespace HTML e SVG sΓ£o transportados por meio de estruturas auxiliares que essencialmente compilam (nΓ£o representam sobrecarga de tempo de execução). VocΓͺ pode colocar seus prΓ³prios elementos a qualquer hora, sem problemas. No entanto, vocΓͺ deve ter certeza absoluta de que seu renderizador pode lidar com o novo tipo, ou ele irΓ‘ "bater e queimar". - -Esses elementos personalizados sΓ£o definidos como estruturas de unidade com implementaçáes de caracterΓ­sticas. - -Por exemplo, o elemento `div` Γ© (aproximadamente!) definido assim: - -```rust, no_run -struct div; -impl div { - /// Some glorious documentation about the class property. - const TAG_NAME: &'static str = "div"; - const NAME_SPACE: Option<&'static str> = None; - // define the class attribute - pub fn class<'a>(&self, cx: NodeFactory<'a>, val: Arguments) -> Attribute<'a> { - cx.attr("class", val, None, false) - } - // more attributes -} -``` - -VocΓͺ provavelmente notou que muitos elementos nas macros `rsx!` suportam documentação em foco. A abordagem que adotamos para elementos personalizados significa que a estrutura da unidade Γ© criada imediatamente onde o elemento Γ© usado na macro. Quando a macro Γ© expandida, os comentΓ‘rios doc ainda se aplicam Γ  estrutura da unidade, dando toneladas de feedback no editor, mesmo dentro de uma `macro proc`. - -# NΓΊcleo Nativo - -Se vocΓͺ estiver criando um renderizador em Rust, o nΓΊcleo nativo fornece alguns utilitΓ‘rios para implementar um renderizador. Ele fornece uma abstração sobre `DomEdits` e manipula o layout para vocΓͺ. - -## RealDom - -O `RealDom` Γ© uma abstração de nΓ­vel superior sobre a atualização do Dom. Ele atualiza com `DomEdits` e fornece uma maneira de atualizar incrementalmente o estado dos nΓ³s com base em quais atributos mudam. - -### Exemplo - -Vamos construir um renderizador de exemplo com bordas, tamanho e cor do texto. -Antes de comeΓ§armos, vamos dar uma olhada em um elemento de exemplo que podemos renderizar: - -```rust, no_run -cx.render(rsx!{ - div{ - color: "red", - p{ - border: "1px solid black", - "hello world" - } - } -}) -``` - -Nesta Γ‘rvore a cor depende da cor do pai. O tamanho depende do tamanho das _children_, do texto atual e do tamanho do texto. A borda depende apenas do nΓ³ atual. - -No diagrama a seguir, as setas representam o fluxo de dados: - -[![](https://mermaid.ink/img/pako:eNqdVNFqgzAU_RXJXizUUZPJmIM-jO0LukdhpCbO0JhIGteW0n9fNK1Oa0brfUnu9VxyzzkXjyCVhIIYZFzu0hwr7X2-JcIzsa3W3wqXuZdKoele22oddfa1Y0Tnfn31muvMfqeCDNq3GmvaNROmaKqZFO1DPTRhP8MOd1fTWYNDvzlmQbBMJZcq9JtjNgY1mLVUhBqQPQeojl3wGCw5PsjqnIe-zXqEL8GZ2Kz0gVMPmoeU3ND4IcuiaLGY2zRouuKncv_qGKv3VodpJe0JVU6QCQ5kgqMyWQVr8hbk4hm1PBcmsuwmnrCVH94rP7xN_ucp8sOB_EPSfz9drYVrkpc_AmH8_yTjJueUc-ntpOJkgt2os9tKjcYlt-DLUiD3UsB2KZCLcwjv3Aq33-g2v0M0xXA0MBy5DUdXi-gcJZriuLmAOSioKjAj5ld8rMsJ0DktaAJicyVYbRKQiJPBVSUx438QpqUCcYb5ls4BrrRcHUTaFizqnWGzR8W5evoFI-bJdw)](https://mermaid-js.github.io/mermaid-live-editor/edit#pako:eNqdVNFqgzAU_RXJXizUUZPJmIM-jO0LukdhpCbO0JhIGteW0n9fNK1Oa0brfUnu9VxyzzkXjyCVhIIYZFzu0hwr7X2-JcIzsa3W3wqXuZdKoele22oddfa1Y0Tnfn31muvMfqeCDNq3GmvaNROmaKqZFO1DPTRhP8MOd1fTWYNDvzlmQbBMJZcq9JtjNgY1mLVUhBqQPQeojl3wGCw5PsjqnIe-zXqEL8GZ2Kz0gVMPmoeU3ND4IcuiaLGY2zRouuKncv_qGKv3VodpJe0JVU6QCQ5kgqMyWQVr8hbk4hm1PBcmsuwmnrCVH94rP7xN_ucp8sOB_EPSfz9drYVrkpc_AmH8_yTjJueUc-ntpOJkgt2os9tKjcYlt-DLUiD3UsB2KZCLcwjv3Aq33-g2v0M0xXA0MBy5DUdXi-gcJZriuLmAOSioKjAj5ld8rMsJ0DktaAJicyVYbRKQiJPBVSUx438QpqUCcYb5ls4BrrRcHUTaFizqnWGzR8W5evoFI-bJdw) - -[//]: # "%% mermaid flow chart" -[//]: # "flowchart TB" -[//]: # " subgraph context" -[//]: # " text_width(text width)" -[//]: # " end" -[//]: # " subgraph state" -[//]: # " direction TB" -[//]: # " subgraph div state" -[//]: # " direction TB" -[//]: # " state1(state)-->color1(color)" -[//]: # " state1-->border1(border)" -[//]: # " text_width-.->layout_width1(layout width)" -[//]: # " linkStyle 2 stroke:#ff5500,stroke-width:4px;" -[//]: # " state1-->layout_width1" -[//]: # " end" -[//]: # " subgraph p state" -[//]: # " direction TB" -[//]: # " state2(state)-->color2(color)" -[//]: # " color1-.->color2" -[//]: # " linkStyle 5 stroke:#0000ff,stroke-width:4px;" -[//]: # " state2-->border2(border)" -[//]: # " text_width-.->layout_width2(layout width)" -[//]: # " linkStyle 7 stroke:#ff5500,stroke-width:4px;" -[//]: # " state2-->layout_width2" -[//]: # " layout_width2-.->layout_width1" -[//]: # " linkStyle 9 stroke:#00aa00,stroke-width:4px;" -[//]: # " end" -[//]: # " subgraph hello world state" -[//]: # " direction TB" -[//]: # " state3(state)-->border3(border)" -[//]: # " state3-->color3(color)" -[//]: # " color2-.->color3" -[//]: # " linkStyle 12 stroke:#0000ff,stroke-width:4px;" -[//]: # " text_width-.->layout_width3(layout width)" -[//]: # " linkStyle 13 stroke:#ff5500,stroke-width:4px;" -[//]: # " state3-->layout_width3" -[//]: # " layout_width3-.->layout_width2" -[//]: # " linkStyle 15 stroke:#00aa00,stroke-width:4px;" -[//]: # " end" -[//]: # " end" - -Para ajudar na construção de um DOM, o nΓΊcleo nativo fornece quatro `traits`: `State`, `ChildDepState`, `ParentDepState` e `NodeDepState` e uma estrutura `RealDom`. O `ChildDepState`, `ParentDepState` e `NodeDepState` fornecem uma maneira de descrever como algumas informaçáes em um nΓ³ se relacionam com as de seus parentes. Ao fornecer como construir um ΓΊnico nΓ³ a partir de suas relaçáes, o native-core derivarΓ‘ uma maneira de atualizar o estado de todos os nΓ³s para vocΓͺ com `#[derive(State)]`. Depois de ter um estado, vocΓͺ pode fornecΓͺ-lo como genΓ©rico ao `RealDom`. `RealDom` fornece todos os mΓ©todos para interagir e atualizar seu novo dom. - -```rust, no_run -use dioxus_native_core::node_ref::*; -use dioxus_native_core::state::{ChildDepState, NodeDepState, ParentDepState, State}; -use dioxus_native_core_macro::{sorted_str_slice, State}; - -#[derive(Default, Copy, Clone)] -struct Size(f32, f32); -// Size only depends on the current node and its children, so it implements ChildDepState -impl ChildDepState for Size { - // Size accepts a font size context - type Ctx = f32; - // Size depends on the Size part of each child - type DepState = Self; - // Size only cares about the width, height, and text parts of the current node - const NODE_MASK: NodeMask = - NodeMask::new_with_attrs(AttributeMask::Static(&sorted_str_slice!(["width", "height"]))).with_text(); - fn reduce<'a>( - &mut self, - node: NodeView, - children: impl Iterator, - ctx: &Self::Ctx, - ) -> bool - where - Self::DepState: 'a, - { - let mut width; - let mut height; - if let Some(text) = node.text() { - // if the node has text, use the text to size our object - width = text.len() as f32 * ctx; - height = ctx; - } else { - // otherwise, the size is the maximum size of the children - width = *children - .reduce(|accum, item| if accum >= item.0 { accum } else { item.0 }) - .unwrap_or(0.0)); - height = *children - .reduce(|accum, item| if accum >= item.1 { accum } else { item.1 }) - .unwrap_or(&0.0); - } - // if the node contains a width or height attribute it overrides the other size - for a in node.attibutes(){ - match a.name{ - "width" => width = a.value.parse().unwrap(), - "height" => height = a.value.parse().unwrap(), - // because Size only depends on the width and height, no other attributes will be passed to the member - _ => panic!() - } - } - // to determine what other parts of the dom need to be updated we return a boolean that marks if this member changed - let changed = (width != self.0) || (height != self.1); - *self = Self(width, height); - changed - } -} - -#[derive(Debug, Clone, Copy, PartialEq, Default)] -struct TextColor { - r: u8, - g: u8, - b: u8, -} -// TextColor only depends on the current node and its parent, so it implements ParentDepState -impl ParentDepState for TextColor { - type Ctx = (); - // TextColor depends on the TextColor part of the parent - type DepState = Self; - // TextColor only cares about the color attribute of the current node - const NODE_MASK: NodeMask = NodeMask::new_with_attrs(AttributeMask::Static(&["color"])); - fn reduce( - &mut self, - node: NodeView, - parent: Option<&Self::DepState>, - _ctx: &Self::Ctx, - ) -> bool { - // TextColor only depends on the color tag, so getting the first tag is equivilent to looking through all tags - let new = match node.attributes().next() { - // if there is a color tag, translate it - Some("red") => TextColor { r: 255, g: 0, b: 0 }, - Some("green") => TextColor { r: 0, g: 255, b: 0 }, - Some("blue") => TextColor { r: 0, g: 0, b: 255 }, - Some(_) => panic!("unknown color"), - // otherwise check if the node has a parent and inherit that color - None => match parent { - Some(parent) => *parent, - None => Self::default(), - }, - }; - // check if the member has changed - let changed = new != *self; - *self = new; - changed - } -} - -#[derive(Debug, Clone, PartialEq, Default)] -struct Border(bool); -// TextColor only depends on the current node, so it implements NodeDepState -impl NodeDepState for Border { - type Ctx = (); - // Border does not depended on any other member in the current node - type DepState = (); - // Border does not depended on any other member in the current node - const NODE_MASK: NodeMask = - NodeMask::new_with_attrs(AttributeMask::Static(&["border"])); - fn reduce(&mut self, node: NodeView, _sibling: &Self::DepState, _ctx: &Self::Ctx) -> bool { - // check if the node contians a border attribute - let new = Self(node.attributes().next().map(|a| a.name == "border").is_some()); - // check if the member has changed - let changed = new != *self; - *self = new; - changed - } -} - -// State provides a derive macro, but anotations on the members are needed in the form #[dep_type(dep_member, CtxType)] -#[derive(State, Default, Clone)] -struct ToyState { - // the color member of it's parent and no context - #[parent_dep_state(color)] - color: TextColor, - // depends on the node, and no context - #[node_dep_state()] - border: Border, - // depends on the layout_width member of children and f32 context (for text size) - #[child_dep_state(size, f32)] - size: Size, -} -``` - -Agora que temos nosso estado, podemos colocΓ‘-lo em uso em nosso DOM. VocΓͺ pode atualizar o DOM com `update_state` para atualizar a estrutura do dom (adicionando, removendo e alterando as propriedades dos nΓ³s) e entΓ£o `apply_mutations` para atualizar o `ToyState` para cada um dos nΓ³s que foram alterados. - -```rust, no_run -fn main(){ - fn app(cx: Scope) -> Element { - cx.render(rsx!{ - div{ - color: "red", - "hello world" - } - }) - } - let vdom = VirtualDom::new(app); - let rdom: RealDom = RealDom::new(); - - let mutations = dom.rebuild(); - // update the structure of the real_dom tree - let to_update = rdom.apply_mutations(vec![mutations]); - let mut ctx = AnyMap::new(); - // set the font size to 3.3 - ctx.insert(3.3); - // update the ToyState for nodes in the real_dom tree - let _to_rerender = rdom.update_state(&dom, to_update, ctx).unwrap(); - - // we need to run the vdom in a async runtime - tokio::runtime::Builder::new_current_thread() - .enable_all() - .build()? - .block_on(async { - loop{ - let wait = vdom.wait_for_work(); - let mutations = vdom.work_with_deadline(|| false); - let to_update = rdom.apply_mutations(mutations); - let mut ctx = AnyMap::new(); - ctx.insert(3.3); - let _to_rerender = rdom.update_state(vdom, to_update, ctx).unwrap(); - - // render... - } - }) -} -``` - -## Layout - -Para a maioria das plataformas, o _layout_ dos `Elementos` permanecerΓ‘ o mesmo. O mΓ³dulo `layout_attributes` fornece uma maneira de aplicar atributos html a um estilo de _layout_ estendido. - -## ConclusΓ£o - -Pronto! VocΓͺ deve ter quase todo o conhecimento necessΓ‘rio sobre como implementar seu prΓ³prio renderizador. Estamos super interessados em ver os aplicativos Dioxus trazidos para renderizadores de desktop personalizados, renderizador para dispositivos mΓ³veis, interface do usuΓ‘rio de videogame e atΓ© realidade aumentada! Se vocΓͺ estiver interessado em contribuir para qualquer um desses projetos, nΓ£o tenha medo de entrar em contato ou se juntar Γ  comunidade. diff --git a/docs/guide/src/pt-br/describing_ui/component_children.md b/docs/guide/src/pt-br/describing_ui/component_children.md deleted file mode 100644 index 9663dca19..000000000 --- a/docs/guide/src/pt-br/describing_ui/component_children.md +++ /dev/null @@ -1,31 +0,0 @@ -# Componente Filhos - -Em alguns casos, vocΓͺ pode desejar criar um componente que atue como um contΓͺiner para algum outro conteΓΊdo, sem que o componente precise saber qual Γ© esse conteΓΊdo. Para conseguir isso, crie uma _prop_ do tipo `Element`: - -```rust, no_run -{{#include ../../../examples/component_element_props.rs:Clickable}} -``` - -EntΓ£o, ao renderizar o componente, vocΓͺ pode passar a saΓ­da de `cx.render(rsx!(...))`: - -```rust, no_run -{{#include ../../../examples/component_element_props.rs:Clickable_usage}} -``` - -> Nota: Como `Element<'a>` Γ© uma _prop_ emprestado, nΓ£o haverΓ‘ memoização. - -> Atenção: Embora possa compilar, nΓ£o inclua o mesmo `Element` mais de uma vez no RSX. O comportamento resultante nΓ£o Γ© especificado. - -## O Campo `children` - -Em vez de passar o `RSX` atravΓ©s de uma _prop_ regular, vocΓͺ pode querer aceitar filhos da mesma forma que os elementos podem ter filhos. O prop "mΓ‘gico" `children` permite que vocΓͺ consiga isso: - -```rust, no_run -{{#include ../../../examples/component_children.rs:Clickable}} -``` - -Isso torna o uso do componente muito mais simples: basta colocar o `RSX` dentro dos colchetes `{}` – e nΓ£o hΓ‘ necessidade de uma chamada `render` ou outra macro! - -```rust, no_run -{{#include ../../../examples/component_children.rs:Clickable_usage}} -``` diff --git a/docs/guide/src/pt-br/describing_ui/component_props.md b/docs/guide/src/pt-br/describing_ui/component_props.md deleted file mode 100644 index 4cb5a50ca..000000000 --- a/docs/guide/src/pt-br/describing_ui/component_props.md +++ /dev/null @@ -1,142 +0,0 @@ -# Props de Componentes - -Assim como vocΓͺ pode passar argumentos para uma função, vocΓͺ pode passar _props_ para um componente que personaliza seu comportamento! Os componentes que vimos atΓ© agora nΓ£o aceitam _props_ – entΓ£o vamos escrever alguns componentes que aceitam. - -## `#[derive(Props)]` - -_Props_ de componente sΓ£o uma ΓΊnica estrutura anotada com `#[derive(Props)]`. Para um componente aceitar _props_, o tipo de seu argumento deve ser `Scope`. EntΓ£o, vocΓͺ pode acessar o valor das _props_ usando `cx.props`. - -Existem 2 tipos de estruturas Props: - -- `props` prΓ³prios: - - NΓ£o tem uma vida ΓΊtil associada - - Implementam `PartialEq`, permitindo a memoização (se os _props_ nΓ£o mudarem, o Dioxus nΓ£o renderizarΓ‘ novamente o componente) -- `props` emprestados: - - [Emprestado](https://doc.rust-lang.org/beta/rust-by-example/scope/borrow.html) de um componente pai - - NΓ£o pode ser memoizado devido a restriçáes de tempo de vida (Rust's lifetime) - -### Props PrΓ³prios - -_Props_ prΓ³prios sΓ£o muito simples – eles nΓ£o emprestam nada. Exemplo: - -```rust, no_run -{{#include ../../../examples/component_owned_props.rs:Likes}} -``` - -VocΓͺ pode entΓ£o passar valores de _prop_ para o componente da mesma forma que vocΓͺ passaria atributos para um elemento: - -```rust, no_run -{{#include ../../../examples/component_owned_props.rs:App}} -``` - -![Screenshot: Likes component](./images/component_owned_props_screenshot.png) - -### Props Emprestados - -Possuir _props_ funciona bem se seus _props_ forem fΓ‘ceis de copiar – como um ΓΊnico nΓΊmero. Mas e se precisarmos passar um tipo de dados maior, como uma `String` de um componente `App` para um subcomponente `TitleCard`? Uma solução ingΓͺnua pode ser [`.clone()`](https://doc.rust-lang.org/std/clone/trait.Clone.html) a `String`, criando uma cΓ³pia dela para o subcomponente – mas isso seria ineficiente, especialmente para `Strings` maiores. - -Rust permite algo mais eficiente – emprestar a `String` como um `&str` – Γ© para isso que servem as _props emprestadas_! - -```rust, no_run -{{#include ../../../examples/component_borrowed_props.rs:TitleCard}} -``` - -Podemos entΓ£o usar o componente assim: - -```rust, no_run -{{#include ../../../examples/component_borrowed_props.rs:App}} -``` - -![Screenshot: TitleCard component](./images/component_borrowed_props_screenshot.png) - -## Props de Option - -A macro `#[derive(Props)]` tem alguns recursos que permitem personalizar o comportamento dos adereΓ§os. - -### Props Opcionais - -VocΓͺ pode criar campos opcionais usando o tipo `Option<…>` para um campo: - -```rust, no_run -{{#include ../../../examples/component_props_options.rs:OptionalProps}} -``` - -Em seguida, vocΓͺ pode optar por fornecΓͺ-los ou nΓ£o: - -```rust, no_run -{{#include ../../../examples/component_props_options.rs:OptionalProps_usage}} -``` - -### `Option` Explicitamente ObrigatΓ³rias - -Se vocΓͺ quiser exigir explicitamente uma `Option`, e nΓ£o uma _prop_ opcional, vocΓͺ pode anotΓ‘-la com `#[props(!optional)]`: - -```rust, no_run -{{#include ../../../examples/component_props_options.rs:ExplicitOption}} -``` - -EntΓ£o, vocΓͺ tem que passar explicitamente `Some("str")` ou `None`: - -```rust, no_run -{{#include ../../../examples/component_props_options.rs:ExplicitOption_usage}} -``` - -### Props PadrΓ£o - -VocΓͺ pode usar `#[props(default = 42)]` para tornar um campo opcional e especificar seu valor padrΓ£o: - -```rust, no_run -{{#include ../../../examples/component_props_options.rs:DefaultComponent}} -``` - -EntΓ£o, da mesma forma que _props_ opcionais, vocΓͺ nΓ£o precisa fornecΓͺ-lo: - -```rust, no_run -{{#include ../../../examples/component_props_options.rs:DefaultComponent_usage}} -``` - -### ConversΓ£o AutomΓ‘tica com `.into` - -Γ‰ comum que as funçáes Rust aceitem `impl Into` em vez de apenas `SomeType` para suportar uma ampla gama de parΓ’metros. Se vocΓͺ quiser uma funcionalidade semelhante com _props_, vocΓͺ pode usar `#[props(into)]`. Por exemplo, vocΓͺ pode adicionΓ‘-lo em uma prop `String` – e `&str` tambΓ©m serΓ‘ aceito automaticamente, pois pode ser convertido em `String`: - -```rust, no_run -{{#include ../../../examples/component_props_options.rs:IntoComponent}} -``` - -EntΓ£o, vocΓͺ pode usΓ‘-lo assim: - -```rust, no_run -{{#include ../../../examples/component_props_options.rs:IntoComponent_usage}} -``` - -## A macro `inline_props` - -AtΓ© agora, todas as funçáes `Component` que vimos tinham uma _struct_ `ComponentProps` correspondente para passar em _props_. Isso foi bastante verboso... NΓ£o seria legal ter _props_ como argumentos de função simples? EntΓ£o nΓ£o precisarΓ­amos definir uma estrutura Props, e ao invΓ©s de digitar `cx.props.whatever`, poderΓ­amos usar `whatever` diretamente! - -`inline_props` permite que vocΓͺ faΓ§a exatamente isso. Em vez de digitar a versΓ£o "completa": - -```rust, no_run -#[derive(Props, PartialEq)] -struct TitleCardProps { - title: String, -} - -fn TitleCard(cx: Scope) -> Element { - cx.render(rsx!{ - h1 { "{cx.props.title}" } - }) -} -``` - -...vocΓͺ pode definir uma função que aceita _props_ como argumentos. EntΓ£o, basta anotΓ‘-lo com `#[inline_props]`, e a macro irΓ‘ transformΓ‘-lo em um componente regular para vocΓͺ: - -```rust, no_run -#[inline_props] -fn TitleCard(cx: Scope, title: String) -> Element { - cx.render(rsx!{ - h1 { "{title}" } - }) -} -``` - -> Embora o novo Componente seja mais curto e fΓ‘cil de ler, essa macro nΓ£o deve ser usada por autores de bibliotecas, pois vocΓͺ tem menos controle sobre a documentação do Prop. diff --git a/docs/guide/src/pt-br/describing_ui/components.md b/docs/guide/src/pt-br/describing_ui/components.md deleted file mode 100644 index 91123b5f8..000000000 --- a/docs/guide/src/pt-br/describing_ui/components.md +++ /dev/null @@ -1,27 +0,0 @@ -# Componentes - -Assim como vocΓͺ nΓ£o gostaria de escrever um programa complexo em uma ΓΊnica e longa função `main`, vocΓͺ nΓ£o deve construir uma interface complexa em uma ΓΊnica função `App`. Em vez disso, seria melhor dividir a funcionalidade de um aplicativo em partes lΓ³gicas chamadas componentes. - -Um componente Γ© uma função Rust, nomeada em _UpperCammelCase_, que recebe um parΓ’metro `Scope` e retorna um `Element` descrevendo a interface do usuΓ‘rio que deseja renderizar. Na verdade, nossa função `App` Γ© um componente! - -```rust, no_run -{{#include ../../../examples/hello_world_desktop.rs:component}} -``` - -> VocΓͺ provavelmente desejarΓ‘ adicionar `#![allow(non_snake_case)]` no topo de sua caixa para evitar avisos sobre o nome da função - -Um Componente Γ© responsΓ‘vel por alguma tarefa de renderização – normalmente, renderizando uma parte isolada da interface do usuΓ‘rio. Por exemplo, vocΓͺ pode ter um componente `About` que renderiza uma breve descrição do Dioxus Labs: - -```rust, no_run -{{#include ../../../examples/components.rs:About}} -``` - -Em seguida, vocΓͺ pode renderizar seu componente em outro componente, da mesma forma que os elementos sΓ£o renderizados: - -```rust, no_run -{{#include ../../../examples/components.rs:App}} -``` - -![Captura de tela contendo o componente Sobre duas vezes](./images/screenshot_about_component.png) - -> Neste ponto, pode parecer que os componentes nada mais sΓ£o do que funçáes. No entanto, Γ  medida que vocΓͺ aprende mais sobre os recursos do Dioxus, verΓ‘ que eles sΓ£o realmente mais poderosos! diff --git a/docs/guide/src/pt-br/describing_ui/images/component_borrowed_props_screenshot.png b/docs/guide/src/pt-br/describing_ui/images/component_borrowed_props_screenshot.png deleted file mode 100644 index 6f1864662f34cf7bc4101f2778f0ccb03d1d1646..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 7868 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 diff --git a/docs/guide/src/pt-br/describing_ui/images/component_owned_props_screenshot.png b/docs/guide/src/pt-br/describing_ui/images/component_owned_props_screenshot.png deleted file mode 100644 index 2a1146cd1d49b2b54bcb1d103f69a294d3921ec9..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 6318 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 diff --git a/docs/guide/src/pt-br/describing_ui/images/screenshot_about_component.png b/docs/guide/src/pt-br/describing_ui/images/screenshot_about_component.png deleted file mode 100644 index 36f7250a1bbb007bf4f3cea787319d9df08f7b8d..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 19470 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 diff --git a/docs/guide/src/pt-br/describing_ui/index.md b/docs/guide/src/pt-br/describing_ui/index.md deleted file mode 100644 index 212e67921..000000000 --- a/docs/guide/src/pt-br/describing_ui/index.md +++ /dev/null @@ -1,116 +0,0 @@ -# Descrevendo a Interface do UsuΓ‘rio - -Dioxus Γ© uma estrutura _declarativa_. Isso significa que, em vez de dizer ao Dioxus o que fazer (por exemplo, "criar um elemento" ou "definir a cor para vermelho"), simplesmente _declaramos_ como queremos que a interface do usuΓ‘rio se pareΓ§a usando o RSX. - -VocΓͺ jΓ‘ viu um exemplo simples ou sintaxe `RSX` no aplicativo "hello world": - -```rust, no_run -{{#include ../../../examples/hello_world_desktop.rs:component}} -``` - -Aqui, usamos a macro `rsx!` para _declarar_ que queremos um elemento `div`, contendo o texto `"Hello, world!"`. Dioxus pega o RSX e constrΓ³i uma interface do usuΓ‘rio a partir dele. - -## Recursos do RSX - -O RSX Γ© muito semelhante ao HTML, pois descreve elementos com atributos e filhos. Aqui estΓ‘ um elemento `div` vazio no RSX, bem como o HTML resultante: - -```rust, no_run -{{#include ../../../examples/rsx_overview.rs:empty}} -``` - -```html -

-``` - -### Filhos - -Para adicionar filhos a um elemento, coloque-os dentro dos colchetes `{}`. Eles podem ser outros elementos ou texto. Por exemplo, vocΓͺ pode ter um elemento `ol` (lista ordenada), contendo 3 elementos `li` (item da lista), cada um dos quais contΓ©m algum texto: - -```rust, no_run -{{#include ../../../examples/rsx_overview.rs:children}} -``` - -```html -
    -
  1. First Item
    2. -
  2. Second Item
    3. -
  3. Third Item
    4. -
-``` - -### Fragmentos - -VocΓͺ tambΓ©m pode "agrupar" elementos envolvendo-os em `Fragment {}`. Isso nΓ£o criarΓ‘ nenhum elemento adicional. - -> Nota: vocΓͺ tambΓ©m pode renderizar vΓ‘rios elementos no nΓ­vel superior de `rsx!` e eles serΓ£o agrupados automaticamente – nΓ£o hΓ‘ necessidade de um `Fragment {}` explΓ­cito lΓ‘. - -```rust, no_run -{{#include ../../../examples/rsx_overview.rs:fragments}} -``` - -```html -

First Item

-

Second Item

-a group -of three -items -``` - -### Atributos - -Os atributos tambΓ©m sΓ£o especificados dentro dos colchetes `{}`, usando a sintaxe `name: value`. VocΓͺ pode fornecer o valor como um literal no RSX: - -```rust, no_run -{{#include ../../../examples/rsx_overview.rs:attributes}} -``` - -```html -Log In -``` - -> Nota: Todos os atributos definidos em `dioxus-html` seguem a convenção de nomenclatura snake_case. Eles transformam seus nomes `snake_case` em atributos `camelCase` do HTML. - -#### Atributos Personalizados - -Dioxus tem um conjunto prΓ©-configurado de atributos que vocΓͺ pode usar. O RSX Γ© validado em tempo de compilação para garantir que vocΓͺ nΓ£o especificou um atributo invΓ‘lido. Se vocΓͺ quiser substituir esse comportamento por um nome de atributo personalizado, especifique o atributo entre aspas: - -```rust, no_run -{{#include ../../../examples/rsx_overview.rs:custom_attributes}} -``` - -```html - Rust is cool -``` - -### Interpolação - -Da mesma forma que vocΓͺ pode [formatar](https://doc.rust-lang.org/rust-by-example/hello/print/fmt.html) Rust _strings_, vocΓͺ tambΓ©m pode interpolar no texto RSX. Use `{variable}` para exibir o valor de uma variΓ‘vel em uma _string_, ou `{variable:?}` para usar a representação `Debug`: - -```rust, no_run -{{#include ../../../examples/rsx_overview.rs:formatting}} -``` - -```html -
- Coordinates: (42, 0) -
ES
-
42
-
-``` - -### ExpressΓ΅es - -VocΓͺ pode incluir expressΓ΅es Rust arbitrΓ‘rias dentro do RSX, mas deve escapΓ‘-las entre colchetes `[]`: - -```rust, no_run -{{#include ../../../examples/rsx_overview.rs:expression}} -``` - -```html -DIOXUS -``` diff --git a/docs/guide/src/pt-br/describing_ui/special_attributes.md b/docs/guide/src/pt-br/describing_ui/special_attributes.md deleted file mode 100644 index 01bfe9b25..000000000 --- a/docs/guide/src/pt-br/describing_ui/special_attributes.md +++ /dev/null @@ -1,62 +0,0 @@ -# Atributos Especiais - -Enquanto a maioria dos atributos sΓ£o simplesmente passados para o HTML, alguns tΓͺm comportamentos especiais. - -## A Escotilha de Escape do HTML - -Se vocΓͺ estiver trabalhando com itens prΓ©-renderizados, modelos ou uma biblioteca JS, convΓ©m passar o HTML diretamente em vez de passar pelo Dioxus. Nesses casos, use `dangerous_inner_html`. - -Por exemplo, enviar um conversor de markdown para Dioxus pode aumentar significativamente o tamanho final do aplicativo. Em vez disso, vocΓͺ desejarΓ‘ prΓ©-renderizar sua remarcação para HTML e, em seguida, incluir o HTML diretamente em sua saΓ­da. Usamos essa abordagem para a [pΓ‘gina inicial do Dioxus](https://dioxuslabs.com): - -```rust, no_run -{{#include ../../../examples/dangerous_inner_html.rs:dangerous_inner_html}} -``` - -> Nota! Esse atributo Γ© chamado de "dangerous_inner_html" porque Γ© **perigoso** passar dados que vocΓͺ nΓ£o confia. Se vocΓͺ nΓ£o for cuidadoso, poderΓ‘ facilmente expor ataques de [cross-site scripting (XSS)](https://en.wikipedia.org/wiki/Cross-site_scripting) aos seus usuΓ‘rios. -> -> Se vocΓͺ estiver lidando com entradas nΓ£o confiΓ‘veis, certifique-se de higienizar seu HTML antes de passΓ‘-lo para `dangerous_inner_html` – ou apenas passe-o para um elemento de texto para escapar de qualquer tag HTML. - -## Atributos Booleanos - -A maioria dos atributos, quando renderizados, serΓ£o renderizados exatamente como a entrada que vocΓͺ forneceu. No entanto, alguns atributos sΓ£o considerados atributos "booleanos" e apenas sua presenΓ§a determina se eles afetam a saΓ­da. Para esses atributos, um valor fornecido de `"false"` farΓ‘ com que eles sejam removidos do elemento de destino. - -Portanto, este RSX nΓ£o renderizaria o atributo `hidden`: - -```rust, no_run -{{#include ../../../examples/boolean_attribute.rs:boolean_attribute}} -``` - -```html -
hello
-``` - -No entanto, nem todos os atributos funcionam assim. _Apenas os seguintes atributos_ tΓͺm este comportamento: - -- `allowfullscreen` -- `allowpaymentrequest` -- `async` -- `autofocus` -- `autoplay` -- `checked` -- `controls` -- `default` -- `defer` -- `disabled` -- `formnovalidate` -- `hidden` -- `ismap` -- `itemscope` -- `loop` -- `multiple` -- `muted` -- `nomodule` -- `novalidate` -- `open` -- `playsinline` -- `readonly` -- `required` -- `reversed` -- `selected` -- `truespeed` - -Para quaisquer outros atributos, um valor de `"false"` serΓ‘ enviado diretamente para o DOM. diff --git a/docs/guide/src/pt-br/getting_started/desktop.md b/docs/guide/src/pt-br/getting_started/desktop.md deleted file mode 100644 index 70f71aa1a..000000000 --- a/docs/guide/src/pt-br/getting_started/desktop.md +++ /dev/null @@ -1,40 +0,0 @@ -# Aplicativo de Γ‘rea de trabalho - -Crie um aplicativo de desktop nativo autΓ΄nomo que tenha a mesma aparΓͺncia em todos os sistemas operacionais. - -Os aplicativos criados com o Dioxus geralmente tΓͺm menos de 5 MB de tamanho e usam os recursos existentes do sistema, para que nΓ£o consumam quantidades extremas de RAM ou memΓ³ria. - -Exemplos: - -- [Explorador de arquivos](https://github.com/DioxusLabs/example-projects/blob/master/file-explorer) -- [Scanner WiFi](https://github.com/DioxusLabs/example-projects/blob/master/wifi-scanner) - -[![Exemplo do Explorador de Arquivos](https://raw.githubusercontent.com/DioxusLabs/example-projects/master/file-explorer/image.png)](https://github.com/DioxusLabs/example-projects/tree /master/file-explorer) - -## Suporte - -O desktop Γ© uma plataforma poderosa para o Dioxus, mas atualmente Γ© limitado em capacidade quando comparado Γ  plataforma Web. Atualmente, os aplicativos de desktop sΓ£o renderizados com a biblioteca WebView da prΓ³pria plataforma, mas seu cΓ³digo Rust estΓ‘ sendo executado nativamente em um _thread_ nativo. Isso significa que as APIs do navegador _nΓ£o_ estΓ£o disponΓ­veis, portanto, renderizar WebGL, Canvas, etc. nΓ£o Γ© tΓ£o fΓ‘cil quanto a Web. No entanto, as APIs do sistema nativo _sΓ£o_ acessΓ­veis, portanto, streaming, WebSockets, sistema de arquivos, etc., sΓ£o todas APIs viΓ‘veis. No futuro, planejamos migrar para um renderizador DOM personalizado baseado em webrenderer com integraçáes WGPU. - -O Dioxus Desktop Γ© construΓ­do a partir do [Tauri](https://tauri.app/). No momento, nΓ£o hΓ‘ abstraçáes do Dioxus sobre atalhos de teclado, barra de menus, manuseio, etc., entΓ£o vocΓͺ deve aproveitar o Tauri - principalmente [Wry](http://github.com/tauri-apps/wry/) e [ Tao](http://github.com/tauri-apps/tao)) diretamente. - -## Criando um projeto - -Crie uma nova caixa: - -```shell -cargo new --bin demo -cd demo -``` - -Adicione o Dioxus com o recurso `desktop` (isso irΓ‘ editar o `Cargo.toml`): - -```shell -cargo add dioxus -cargo add dioxus-desktop -``` - -Edite seu `main.rs`: - -```rust, no_run -{{#include ../../../examples/hello_world_desktop.rs:all}} -``` diff --git a/docs/guide/src/pt-br/getting_started/hot_reload.md b/docs/guide/src/pt-br/getting_started/hot_reload.md deleted file mode 100644 index 447169055..000000000 --- a/docs/guide/src/pt-br/getting_started/hot_reload.md +++ /dev/null @@ -1,31 +0,0 @@ -# Configurando o Hot Reload - -1. O recarregamento em tempo-real (_hot reload_) permite tempos de iteração muito mais rΓ‘pidos dentro de chamadas 'rsx', interpretando-as e transmitindo as ediçáes. -2. Γ‰ ΓΊtil para alterar o estilo/layout de um programa, mas nΓ£o ajudarΓ‘ na alteração da lΓ³gica de um programa. -3. Atualmente, o cli implementa apenas o _hot-reload_ para o renderizador da web. - -# Configurar - -Instale o [dioxus-cli](https://github.com/DioxusLabs/cli). -Habilite o recurso de _hot-reload_ no dioxus: - -```toml -dioxus = { version = "*", features = ["hot-reload"] } -``` - -# Usage - -1. Execute: - -``` -dx serve --hot-reload -``` - -2. alterar algum cΓ³digo dentro de uma macro `rsx` -3. abra seu `localhost` em um navegador -4. salve e observe a mudanΓ§a de estilo sem recompilar - -# Limitaçáes - -1. O interpretador sΓ³ pode usar expressΓ΅es que existiam na ΓΊltima recompilação completa. Se vocΓͺ introduzir uma nova variΓ‘vel ou expressΓ£o na chamada `rsx`, ela acionarΓ‘ uma recompilação completa para capturar a expressΓ£o. -2. Componentes e Iteradores podem conter cΓ³digo de Rust arbitrΓ‘rio e acionarΓ£o uma recompilação completa quando alterados. diff --git a/docs/guide/src/pt-br/getting_started/index.md b/docs/guide/src/pt-br/getting_started/index.md deleted file mode 100644 index 2ee8fe89f..000000000 --- a/docs/guide/src/pt-br/getting_started/index.md +++ /dev/null @@ -1,72 +0,0 @@ -# Introdução - -Esta seção irΓ‘ ajudΓ‘-lo a configurar seu projeto Dioxus! - -## PrΓ©-requisitos - -### Editor - -O Dioxus se integra muito bem com o [plugin Rust-Analyzer LSP](https://rust-analyzer.github.io) que fornecerΓ‘ realce de sintaxe apropriado, navegação de cΓ³digo, _folding_ e muito mais. - -### Rust - -VΓ‘ para [https://rust-lang.org](http://rust-lang.org) e instale o compilador Rust. - -Γ‰ altamente recomendΓ‘vel ler o [livro oficial do Rust](https://doc.rust-lang.org/book/ch01-00-getting-started.html) _completamente_. No entanto, nossa esperanΓ§a Γ© que um aplicativo Dioxus possa servir como um Γ³timo primeiro projeto Rust. Com Dioxus, vocΓͺ aprenderΓ‘ sobre: - -- Manipulação de erros -- Estruturas, Funçáes, Enums -- Closures -- Macros - -NΓ³s empenhamos muito cuidado para tornar a sintaxe do Dioxus familiar e fΓ‘cil de entender, para que vocΓͺ nΓ£o precise de conhecimento profundo sobre _async_, _lifetime_ ou _smart pointers_ atΓ© que vocΓͺ realmente comece a criar aplicativos Dioxus complexos. - -### DependΓͺncias EspecΓ­ficas da Plataforma - -#### Windows - -Os aplicativos da Γ‘rea de trabalho do Windows dependem do WebView2 – uma biblioteca que deve ser instalada em todas as distribuiçáes modernas do Windows. Se vocΓͺ tiver o Edge instalado, o Dioxus funcionarΓ‘ bem. Se vocΓͺ _nΓ£o_ tiver o Webview2, [vocΓͺ poderΓ‘ instalΓ‘-lo pela Microsoft](https://developer.microsoft.com/en-us/microsoft-edge/webview2/). MS oferece 3 opçáes: - -1. Um pequeno _bootstrapper_ "evergreen" que buscarΓ‘ um instalador do CDN da Microsoft -2. Um pequeno _instalador_ que buscarΓ‘ o Webview2 do CDN da Microsoft -3. Uma versΓ£o vinculada estaticamente do Webview2 em seu binΓ‘rio final para usuΓ‘rios offline - -Para fins de desenvolvimento, use a Opção 1. - -#### Linux - -Os aplicativos Webview Linux requerem WebkitGtk. Ao distribuir, isso pode ser parte de sua Γ‘rvore de dependΓͺncia em seu `.rpm` ou `.deb`. No entanto, Γ© muito provΓ‘vel que seus usuΓ‘rios jΓ‘ tenham o WebkitGtk. - -```bash -sudo apt install libwebkit2gtk-4.0-dev libgtk-3-dev libappindicator3-dev -``` - -Ao usar o Debian/bullseye, o `libappindicator3-dev` nΓ£o estΓ‘ mais disponΓ­vel, pois foi substituΓ­do por `libayatana-appindicator3-dev`. - -```bash -# on Debian/bullseye use: -sudo apt install libwebkit2gtk-4.0-dev libgtk-3-dev libayatana-appindicator3-dev -``` - -Se vocΓͺ tiver problemas, certifique-se de ter todo o bΓ‘sico instalado, conforme descrito nos [documentos do Tauri](https://tauri.studio/v1/guides/getting-started/prerequisites#setting-up-linux). - -#### Mac OS - -Atualmente – tudo para macOS estΓ‘ integrado! No entanto, vocΓͺ pode encontrar um problema se estiver usando o Rust **nightly** devido a alguns problemas de permissΓ£o em nossa dependΓͺncia do `Tao` (que foram resolvidos, mas nΓ£o publicados). - -### ExtensΓ΅es do Cargo Sugeridas - -Se vocΓͺ quiser manter seu fluxo de trabalho tradicional como `npm install XXX` para adicionar pacotes, vocΓͺ pode querer instalar o `cargo-edit` e algumas outras extensΓ΅es `cargo` interessantes: - -- [cargo-expand](https://github.com/dtolnay/cargo-expand) para expandir chamadas de macro -- [Γ‘rvore de carga](https://doc.rust-lang.org/cargo/commands/cargo-tree.html) – um comando de carga integrado que permite inspecionar sua Γ‘rvore de dependΓͺncia - -## Guias de configuração - -Dioxus suporta mΓΊltiplas plataformas. Dependendo do que vocΓͺ quer, a configuração Γ© um pouco diferente. - -- [Web](web.md): rodando no navegador usando WASM -- [Server Side Rendering](ssr.md): renderiza Dioxus HTML como texto -- [Desktop](desktop.md): um aplicativo autΓ΄nomo usando o webview -- [Celular](mobile.md) -- [Terminal UI](tui.md): interface grΓ‘fica baseada em texto do terminal diff --git a/docs/guide/src/pt-br/getting_started/mobile.md b/docs/guide/src/pt-br/getting_started/mobile.md deleted file mode 100644 index 66a17272b..000000000 --- a/docs/guide/src/pt-br/getting_started/mobile.md +++ /dev/null @@ -1,76 +0,0 @@ -# Aplicativo mΓ³vel - -Crie um aplicativo mΓ³vel com Dioxus! - -Exemplo: [Aplicativo Todo](https://github.com/DioxusLabs/example-projects/blob/master/ios_demo) - -## Suporte - -Atualmente, a plataforma mΓ³vel Γ© o destino de renderizador menos suportado para o Dioxus. Os aplicativos mΓ³veis sΓ£o renderizados com o WebView da plataforma, o que significa que animaçáes, transparΓͺncia e widgets nativos nΓ£o estΓ£o disponΓ­veis no momento. - -AlΓ©m disso, o iOS Γ© a ΓΊnica plataforma mΓ³vel compatΓ­vel. Γ‰ possΓ­vel obter o Dioxus rodando no Android e renderizado com WebView, mas a biblioteca de janelas do Rust que o Dioxus usa – tao – atualmente nΓ£o suporta Android. - -Atualmente, o suporte mΓ³vel Γ© mais adequado para aplicativos no estilo CRUD, idealmente para equipes internas que precisam desenvolver rapidamente, mas nΓ£o se importam muito com animaçáes ou widgets nativos. - -## Configurando - -A configuração com dispositivos mΓ³veis pode ser bastante desafiadora. As ferramentas aqui nΓ£o sΓ£o Γ³timas (ainda) e podem precisar de alguns _hacks_ para fazer as coisas funcionarem. O macOS M1 Γ© amplamente inexplorado e pode nΓ£o funcionar para vocΓͺ. - -Vamos usar `cargo-mobile` para construir para dispositivos mΓ³veis. Primeiro, instale-o: - -```shell -cargo install --git https://github.com/BrainiumLLC/cargo-mobile -``` - -E, em seguida, inicialize seu aplicativo para a plataforma certa. Use o modelo `winit` por enquanto. No momento, nΓ£o hΓ‘ modelo "Dioxus" no cargo-mobile. - -```shell -cargo mobile init -``` - -NΓ³s vamos limpar completamente as `dependΓͺncias` que ele gera para nΓ³s, trocando `winit` por `dioxus-mobile`. - -```toml - -[package] -name = "dioxus-ios-demo" -version = "0.1.0" -authors = ["Jonathan Kelley "] -edition = "2018" - - -# leave the `lib` declaration -[lib] -crate-type = ["staticlib", "cdylib", "rlib"] - - -# leave the binary it generates for us -[[bin]] -name = "dioxus-ios-demo-desktop" -path = "gen/bin/desktop.rs" - -# clear all the dependencies -[dependencies] -mobile-entry-point = "0.1.0" -dioxus = { version = "*" } -dioxus-desktop = { version = "*" } -simple_logger = "*" -``` - -Edite seu `lib.rs`: - -```rust, no_run -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(app); -} - -fn app(cx: Scope) -> Element { - cx.render(rsx!{ - div { - "hello world!" - } - }) -} -``` diff --git a/docs/guide/src/pt-br/getting_started/ssr.md b/docs/guide/src/pt-br/getting_started/ssr.md deleted file mode 100644 index ebf478163..000000000 --- a/docs/guide/src/pt-br/getting_started/ssr.md +++ /dev/null @@ -1,110 +0,0 @@ -# Renderização por Servidor - -O Dioxus 'VirtualDom' pode ser renderizado por servidor. - -[Exemplo: Dioxus DocSite](https://github.com/dioxusLabs/docsite) - -## Suporte a Multitarefas - -O Dioxus `VirtualDom`, infelizmente, atualmente nΓ£o Γ© `Send`. Internamente, usamos um pouco de mutabilidade interior que nΓ£o Γ© _thread-safe_. Isso significa que vocΓͺ nΓ£o pode usar Dioxus facilmente com a maioria dos frameworks da web como Tide, Rocket, Axum, etc. - -Para resolver isso, vocΓͺ deve gerar um `VirtualDom` em seu prΓ³prio thread e se comunicar com ele por meio de canais. - -Ao trabalhar com frameworks web que requerem `Send`, Γ© possΓ­vel renderizar um `VirtualDom` imediatamente para uma `String` – mas vocΓͺ nΓ£o pode manter o `VirtualDom` em um ponto de espera. Para SSR de estado retido (essencialmente LiveView), vocΓͺ precisarΓ‘ criar um _pool_ de `VirtualDoms`. - -## Configurar - -Se vocΓͺ quer apenas renderizar `rsx!` ou um VirtualDom para HTML, confira os documentos da API. Γ‰ bem simples: - -```rust, no_run -// We can render VirtualDoms -let mut vdom = VirtualDom::new(app); -let _ = vdom.rebuild(); -println!("{}", dioxus::ssr::render_vdom(&vdom)); - -// Or we can render rsx! calls directly -println!( "{}", dioxus::ssr::render_lazy(rsx! { h1 { "Hello, world!" } } ); -``` - -No entanto, para este guia, vamos mostrar como usar Dioxus SSR com `Axum`. - -Certifique-se de ter o Rust and Cargo instalado e, em seguida, crie um novo projeto: - -```shell -cargo new --bin demo -cd app -``` - -Adicione o Dioxus com o recurso `ssr`: - -```shell -cargo add dioxus -cargo add dioxus-ssr -``` - -Em seguida, adicione todas as dependΓͺncias do Axum. Isso serΓ‘ diferente se vocΓͺ estiver usando um Web Framework diferente - -``` -cargo add tokio --features full -cargo add axum -``` - -Suas dependΓͺncias devem ficar mais ou menos assim: - -```toml -[dependencies] -axum = "0.4.5" -dioxus = { version = "*" } -dioxus-ssr = { version = "*" } -tokio = { version = "1.15.0", features = ["full"] } -``` - -Agora, configure seu aplicativo Axum para responder em um _endpoint_. - -```rust, no_run -use axum::{response::Html, routing::get, Router}; -use dioxus::prelude::*; - -#[tokio::main] -async fn main() { - let addr = std::net::SocketAddr::from(([127, 0, 0, 1], 3000)); - println!("listening on http://{}", addr); - - axum::Server::bind(&addr) - .serve( - Router::new() - .route("/", get(app_endpoint)) - .into_make_service(), - ) - .await - .unwrap(); -} -``` - -E, em seguida, adicione nosso _endpoint_. Podemos renderizar `rsx!` diretamente: - -```rust, no_run -async fn app_endpoint() -> Html { - Html(dioxus_ssr::render_lazy(rsx! { - h1 { "hello world!" } - })) -} -``` - -Ou podemos renderizar `VirtualDoms`. - -```rust, no_run -async fn app_endpoint() -> Html { - fn app(cx: Scope) -> Element { - cx.render(rsx!(h1 { "hello world" })) - } - let mut app = VirtualDom::new(app); - let _ = app.rebuild(); - - Html(dioxus_ssr::render_vdom(&app)) -} -``` - -E Γ© isso! - -> VocΓͺ pode notar que nΓ£o pode manter o VirtualDom em um ponto de espera. Dioxus atualmente nΓ£o Γ© ThreadSafe, entΓ£o _deve_ permanecer no _thread_ que iniciou. Estamos trabalhando para flexibilizar essa exigΓͺncia. diff --git a/docs/guide/src/pt-br/getting_started/tui.md b/docs/guide/src/pt-br/getting_started/tui.md deleted file mode 100644 index ba4e2ecda..000000000 --- a/docs/guide/src/pt-br/getting_started/tui.md +++ /dev/null @@ -1,46 +0,0 @@ -# IU do terminal - -VocΓͺ pode construir uma interface baseada em texto que serΓ‘ executada no terminal usando o Dioxus. - -![Hello World screenshot](https://github.com/DioxusLabs/rink/raw/master/examples/example.png) - -> Nota: este livro foi escrito tendo em mente plataformas baseadas em HTML. VocΓͺ pode acompanhar a TUI, mas terΓ‘ que se adaptar um pouco. - -## Suporte - -O suporte Γ  TUI Γ© atualmente bastante experimental. AtΓ© o nome do projeto mudarΓ‘. Mas, se vocΓͺ estiver disposto a se aventurar no reino do desconhecido, este guia o ajudarΓ‘ a comeΓ§ar. - -## Configurando - -Comece criando um novo pacote e adicionando nosso recurso TUI. - -```shell -cargo new --bin demo -cd demo -cargo add dioxus -cargo add dioxus-tui -``` - -Em seguida, edite seu `main.rs` com o modelo bΓ‘sico. - -```rust, no_run -{{#include ../../../examples/hello_world_tui.rs}} -``` - -Para executar nosso aplicativo: - -```shell -cargo run -``` - -Pressione "ctrl-c" para fechar o aplicativo. Para mudar de "ctrl-c" para apenas "q" para sair, vocΓͺ pode iniciar o aplicativo com uma configuração para desativar o sair padrΓ£o e usar a raiz TuiContext para sair por conta prΓ³pria. - -```rust, no_run -{{#include ../../../examples/hello_world_tui_no_ctrl_c.rs}} -``` - -## Notas - -- Nosso pacote TUI usa flexbox para layout -- 1px Γ© a altura da linha de um caractere. Seu px CSS regular nΓ£o traduz. -- Se seu aplicativo entrar em pΓ’nico, seu terminal serΓ‘ destruΓ­do. Isso serΓ‘ corrigido eventualmente. diff --git a/docs/guide/src/pt-br/getting_started/web.md b/docs/guide/src/pt-br/getting_started/web.md deleted file mode 100644 index 47991b595..000000000 --- a/docs/guide/src/pt-br/getting_started/web.md +++ /dev/null @@ -1,75 +0,0 @@ -# Web - -Crie aplicativos de pΓ‘gina ΓΊnica (SPA) que sΓ£o executados no navegador com o Dioxus. Para rodar na Web, seu aplicativo deve ser compilado para WebAssembly e utilizar a `crate` `dioxus` com o recurso `web` ativado. - -Uma compilação do Dioxus para a web serΓ‘ aproximadamente equivalente ao tamanho de uma compilação do React (70kb vs 65kb), mas carregarΓ‘ significativamente mais rΓ‘pido devido ao [StreamingCompile do WebAssembly](https://hacks.mozilla.org/2018/01/making-webassembly-even-faster-firefoxs-new-streaming-and-tiering-compiler/). - -Exemplos: - -- [TodoMVC](https://github.com/DioxusLabs/example-projects/tree/master/todomvc) -- [ECommerce](https://github.com/DioxusLabs/example-projects/tree/master/ecommerce-site) - -[![Exemplo de TodoMVC](https://github.com/DioxusLabs/example-projects/raw/master/todomvc/example.png)](https://github.com/DioxusLabs/example-projects/blob/master /todomvc) - -> Nota: Devido Γ s limitaçáes do Wasm, nem todos as `crates` funcionarΓ£o com seus aplicativos da web, portanto, vocΓͺ precisarΓ‘ certificar-se de que suas `crates` funcionem sem chamadas de sistema nativas (temporizadores, IO, etc.). - -## Suporte - -A Web Γ© a plataforma de destino com melhor suporte para Dioxus. - -## Ferramentas - -Para desenvolver seu aplicativo Dioxus para a web, vocΓͺ precisarΓ‘ de uma ferramenta para construir e servir seus itens. Recomendamos usar [trunk](https://trunkrs.dev) que inclui um sistema de compilação, otimização Wasm, um servidor dev e suporte para SASS/CSS: - -```shell -cargo install trunk -``` - -Certifique-se de que o destino `wasm32-unknown-unknown` esteja instalado: - -```shell -rustup target add wasm32-unknown-unknown -``` - -## Criando um Projeto - -Crie uma nova caixa: - -```shell -cargo new --bin demo -cd demo -``` - -Adicione o Dioxus como uma dependΓͺncia com o recurso `web`: - -```bash -cargo add dioxus -cargo add dioxus-web -``` - -Adicione um `index.html` para o `Trunk` usar. Certifique-se de que seu elemento "mount point" tenha um ID de "main": - -```html - - - - - - - -
- - -``` - -Edite seu `main.rs`: - -```rust, no_run -{{#include ../../../examples/hello_world_web.rs}} -``` - -E para servir nosso aplicativo: - -```bash -trunk serve -``` diff --git a/docs/guide/src/pt-br/images/compiletimecorrect.png b/docs/guide/src/pt-br/images/compiletimecorrect.png deleted file mode 100644 index 8fab7509fe6321c957b25b77ee2927cd3c24d787..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 196054 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

5^Y|FMQCq&bZ)=_Yrj(Dd^(qsz#QD70c-N-N_z< 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 Xr-Fvw74!rH_)@u~sff9F-S58ufbu*v diff --git a/docs/guide/src/pt-br/images/component_tree.png b/docs/guide/src/pt-br/images/component_tree.png deleted file mode 100644 index d9692407350138e0b7597e8705e33f58a463357a..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 3724 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 diff --git a/docs/guide/src/pt-br/images/diffing.png b/docs/guide/src/pt-br/images/diffing.png deleted file mode 100644 index 4c243bc759085f24ada3be039cb763e1d59fc2f5..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 23486 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 Bge?F7 diff --git a/docs/guide/src/pt-br/images/dioxuslogo_full.png b/docs/guide/src/pt-br/images/dioxuslogo_full.png deleted file mode 100644 index 7d08f2af8f057780eddae4b0f8b8fa753b69e7f8..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 59292 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

##0PXrvufB0wJ`%=YsvNItF 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

sW@yfIK5!0r3C!jXOp{;!Mh)wCw-TYJeHj?h7 zbf&{PeW{;p_g{aaMgT-VnT5GJ=F)@2vaBZ;xwW$X?tJ|C@lJ+!UB&c@bcuIA?V>sZ z2YQ5cTf8sRvkIL8lNLpSZ!@caSum4`KAtf7Q}n&t@Z>1WOIc_3ZQ=QYi{X0&qNCrv z`&&S!d^VZ)%_QwH#D!c{-pzcKE(WRxM43Ha968@qMp|3}wf#ESX33DW8(;B#k|3xU z+g`u>_fqbKAH!AR+NaQ+V%P-QmA6$G+*fALLls1lwb~cMESmCXjIC zrKV#QNU$X)1e4;vYE&k!X#y1 zDa15qV>>eXVfYm3*Vh-Sb(&%cfR5nG985v1STmGV|MPQzD%jT$?>OPwvVuab{HB>T@F7u7SE1sHeWnfighKILPD;`is5h3G z3~rV{g;9H3&OfFwSc6T!FMaz1FD5z3Rv_hF#aZnSAkuO(Yju($yHMJ#lgGguT;`n(|&ZM|b4BwAZ` zNc60yZW^PZ=XHTEu{fh01ZFA2QoFlXD|TDcGAiQR3A~l_GK=}2pe~IE&dk?{y4>{v z=xw*x;WB$N^~Kc6VQ@0e44t`60WHPBrcEy~oyVMv<8ZY>5~N6r{CnUHPKMK!`z#B8 zKw2=Bou_Q{FW|r_g{rMWRAUUdmPu8RXI9eU)N5Tf{nkD(00mG{?KB2$P52gSeLZV~vc!u`ERVnTr)A+*1ED*c;tgQA##tA&DJciSw0 z8O#C}3qTHIN1}>wwqTo-Rl*U(%gC+#{hWVl8JsR~&Ke?FiX?gg(FOoVmbY3=;(8GzT-Sq#x9&w=i+UfGP%DP7*bppew`l9;spoM>*K@ih!u0- zhL$_&ZcLvC@kMw8?ltXwj^$w9n-z&`Odav7;LqN334?h>$nKzrD%j_E!)d<|@#30& zJrrBskr^+)h>F;etk)SC9CZ{d;)JXt_dX})t0BT@P{aJrjYY5$Y@vxn(w2GO(n^^3 z;EuWaSoJNwT7-~mHm_gqn3t(Zj_7p@6Z5T3UWER$5zW1<*4nzMO$U-eT6xYM0s)cm z2NhEL|Iq^I9x7PQRh+ykujpc?5x3CG_^fm8-9Ji0EXZag9X^k_8!fwOIq$o}-Wi2W(9 z;A*IpWEkuYSC`==6L&19yn?2nAJ^ONFF8os4S$U9FiY20u*91KAT(|q8P9?%3kD*G zMR@(B+rVFnlHMDolZNeW%;{m9OSCLXLx`Qe!tCw7@Zt)yO_V;CFnPKchD^ngArMOf zXu?&r^W_o@%VGd5>)qsOW-Ne8gR4t3t~OXw5j1*r(*TY+&i{KJoS{c+(h8@#54r=O z+gvy9dlcNbyYeF4PNGwJL50U`aBNdRGd-KBo%jpuY3{ z%|_2|$Hy}u8E{HOO#!S{LUnMy&z5%q8Nm@juCVuU7sRz3Q1TcC!O?(-Gt~V2hR&@K zH9Ya3Okzm<2%T9hE~c&hhtqNLi#_hMaPm(kRs!yY15sLj+pUi46;31@vL4i!l{h;+ z@tHF90OthJ#-t_IKo4Gm~10hQV#-5N6=wrTv2W0}Q7Jt146g@_BjI7IX<~ zOy_l3IEHpNORi0_mkmFnjbsopoM_bHolL1div^6Fe`J_(#PWXQ6`@Nx2oN&hfQo%Rn*dXyw`CcT=F#{qE#DAjzRWP3ZbLV`$d z7xvKGgyc`plBc)DETel`+yo9mL>5@!c+z%fvgKZLad}WlyxuOTp2=GYIxrmdb5vdn zR}7D}-&q3)A@pr(f%;1tEF0_#*(*;6M|9j^U1bnkm^&DR`8JpHPQ>8x;>y zy^#*?mz_=H3Z@tk(HZy_vDy_ZK4lxUHhn$ z#@`su8;(FHO8~X2@VUFUwVeA>i6sg3A-^;pXKsU*3Vig(o`li)fGVb!<^eXKUy^DY znoB6X1^LcjEeYnB4+<3=LF)?JFi~Pgz|HjgMFfCzaQTECbV{lN5Fo{@JrS3Fo!xD= zY$6$sAf;J^b^Zp4_Q14p019?BKj!ctMTgN41cHd$Cv4E!=*I+dToioTXi#8oCl#F1 zzRXSN?63_(HA!K`nqN01$pMU^1D$tRF$~WILZE@JNLn(w98g8wjQK3e5JOs~pjA{DlWCK~QdWn=e3h|R34RG{ zi|KDI%8OCKi_wbup2lA6-#+{jL%Bb=V<;iQpk7w&o30R-QuG5mD!fJ^px~y*xH8 z|H=di0q=?Z@F+zjEFa>O7^mWBOvlN0l#*mW864Z6RO^o2jt|S?x0aqzKzANn@J)Ea ztkAJabny3FL8P$zgZ~jq`_~T*u+26Gbj%g{dp_6?Xiy51Y`#(u45NP~4*n~LKnLSd zy!cD8HA~?IMWgZmTC6nrbQYx>Kqe+K7=Ai9w(Hd~OuzA|0yYDemnBv()vte{0{k1} z@QO0Vonr;9yKIFJB0AizIvDS7%wT*Fo$-HT4u1I;3V~e|g@ho>HemgVYX;*0J;HVt zZB@NEx;R}`!J-tgj(MZMRS8k;vWBfaFFMr*VD>z+70NIgE$?2}6gAua(st#6T8u(e zsuB-AZ$$4&lyj>CIMCGM*LrN3Ucl@a>;E63{ToqLwt;0Xj0c`C^H9p2@4dn5$&jX* zJc|6rJFo!X9aq}1W&H}t7z}>uM~SCWDsXkbeBBHc#CiA~Y!>U>9UF|jm5QW=2D}7N zGsPwklWY9g(TAE(#{H#4y#VS;ee6P>oISasJjx6et&)mH0+7OyGV}oUeFp+h->(R_ zqxzh_mw<)y-Tb>lA39(cPr%lAW|J6#Ua?YS*Y594-jeiip|b6&-16B-atppH_q5?g z#L3W%Qyj9B4X?R4MmTb&#trz?nO=ncwCC5qj=y$7;N2Pe5F46y*^uY2abJek*ZYRZ zh8}TVqU-zC3%d<+ms}^as=m#+d*cV=$gZxrb1em8(T(UF@9}@Qh4c+L^dB)|MId*k z+09eLNUwo$mhEB@z{Gle4}o!_q2|S=ZOO6u3qB^H(ug#9xPa0%?`UP-Vz% zz8di3%3r^?VD}#d7a~T}-~dX|c_<~n-4LW0IbDH5QK^25l5Wb_xq)berra|!#h%z6 z_^mB_xv9~pMJiqeLQ~_~I%#Y~>Yl;Rab_Ju1J!N5d@z*Zd)cWm`w)MNsu~(OsDGeW z}4!)_J*%P6^zcu?Be>kZ;6 zV-lm-q`UE8qq7(^{u>>hlZX#%RMKvS-2n;yaqW6ouJ#mc*pO)A$}*@!;- zo;MG3LDrdJK!#2H#tLU3IwN(I#S`nu6^?RKgSFvxE2q?W(ACb?3Ulk$ouG$$a#9Ac zb{5}@mHmzW@?|i06FLF*BIvV+97NY#W z9#H6Kb_8`Kvf$sM@k5a!{^S25Y_uIT6eXHHum{RL z#eNOA3>5*3st3BESf1A{RE*t#3dKC=9-#{oQP$vcEAy=ILnjA6FKByI3^MAOpmS7Y zJ2VLL=_U|K=I>=VeJhYza5_0m&EAJBVN6~D)VTl<+_KNb05-h`QMc~2Vb?v6uMPve zT@0A=Ezl~;(o9oJus9m{tQwnfFYuVxgax%xarJ`|n7R0~_T&gks{`8oI4i}AuY{MH zU*3Nn1Dzg{70~erKp{0WvKF9bYo_%JOe!>vkb&_BUs5_MX}VDIFu=Q9UCA zPpcS8pL^*Qj^)+QC|B6m1)qR)eodJ}jOXwASv&CSOMpj)Z|1%w0U*HZ4o_$qhIEVU zf$UPOo;P&b(1lv|X~1uaApO^QUJ@GGWg|>9>jrldK=_0n{JP@uqh@m{R}1j=e2HD( zWj_M_%cQ*K1wXLZ>Xt#t@Yi%`S21)Gh$ln&Q0fZO4Dd~t#ND1r5Jbp_f1*9dysF6~ z$F~%#c?c@zK^}mK^#c1XER7ZVtI)1AcLY)w#a!TOrOc9;S6bLH8%7ZEDHj=P$H%4K5_Ad@7KKHHl6pY3icKDa|de1ADIgCNtBJ`<_ zyn+4kA)a7$CsFa>L4YyD)~5?-t6T#~>(IoP6K|U%RnGhYU@KwfIiWtQFsoN40+Ho1 z(~*4sT}7S%ec0S^4a|vcd?w}2<0Mkd*!FZ3IwCCb4h(_jSRYi?4R``n+V98oX@3il z2K#`bzt(xEsk=l}VIL;oG>Nk%RxlDs#i zFvOb83wQ+GkeP;*H;@feTThd_It$G;kMf(S*e8=nQsv%qC;ybqIn!(`!eZ9}`bwDc zo@CB5G;#H5ynp!{a!`2wPgB7rMUv$+(R1e);%g~LI=n$gp&eo>g@Pe7LDX=C51@;7#wRQ^&|pPl085O8}B~m)Op=`{u8z7kN1;uG|A9W30DkVLKB76tn!>^bcMBx zEN-rVFVpR4b?X}ytYYuqKSP15_YI7S!6*~S4M==DR*2i>Y@&Y*gRqig9HV#qxE1i; zYzcb6>&pYiqN&IGXzR4L6-eBf0yZb)WdgF7Z9wA+yBJ(;)x&2wR9%&ASTpFAQw5k- zJ)4XB4j5~a7i8^B7$xw$B6_Yr{Xy)$P*sVFAo>l$e@(Rn%NeLEtRgS>*{ni}W*V}k zj*A3e$Mc?GnrOTp{>*RWDR{=fS?;w&=Sw;z_mh8>B$qg!X+)`n|M!6fVCp~ojsTb) zR&vu#?6}ipi<@#xm0E+gokoB$^0bLC=dI*a%-XY0uf2(&A}}ZDo%jwFbU&b9O~2x2 zno>*B5^zpSKV}XMZFMPD(X_S1Ne=mc1pPT9kC~!yCm^`(y6DtIYHv9lf5TPZ`qIJ| z27M_KAU@9QY215qm86>>cTr)t4t%F9P$*np_UOrSpct5U)ww)qeAVkXL@biv zebfO|vgsDFxk5N5%jZjErlE1wgA?=6C%dysvWSdiYLI*jZDtK9YidDmclfT#oL7ut z2b>AKeQ>sDb~CQ{Qw=ez8qmdYxn{S2f$c`*FMy3Y>y^`bB=Bv{9k0}kOW*g;Zo$oZ zfzvW2A%^tHvFyoD@wleg_xdKA{&$>d^qP_;5b36mZ~X~~YCWVVx!!8nf;2GfUmKQ0 z&M}a7?DyJS8w1t&FQ+%hI~bp->YdKSJlLnnFuS1x@=564yN48nDJeKapnER_*?a%t z(;?pTMS>X*RxlEZ>^(oQ*0P6B;-7v+a>r*5u|@-_jsW{4)VczJi^4FP3LyaY|A*kOTMJXBx+QMrWe4c-d)mRv<&<-B`d(` zfKJ_MuW!;Ms{wFn9O092a1#=9BL>i%?d-;RI$zkJ&@ZVNq)kqZod~HQjb5lq88LIT+0`tF^shs*V!~TM zkSw>W^a%N*kQCtqxr*7UOsOhXfinaWkgr8{%=mytQExqGoR!aNqah7+U#tKtHE5LP z%=IwN{A~RLr)XG&qN^shH`9j%GNPk<=~3wnkNJV5||ggGd^cwD$4{dLn&M z0Dls6)vuznjf(gGPd#=x(MLM)dKg8Sv=jU&>Kz0iOgsHl2%OLUm_c{;eE=j==!7-O z-BBLG7FI6tGT@bep7@z&9dfoUq|b-_DJolTX(lsTYaGKqNYWmsj7sl!7VoZ?H;@M z4&$(hXM`KpK{9qyUKy|0Mw4fG%2<{8YtO6BtZiF&16amol11O`Op2Z`m6s%P+BWu)@XmC~#j4Z%)^^|1JN?t;%poCndmK;P7EZ-l;1oBC}vVB0WFI z#|5r^rSTtf0FLF3OPtYmk1CFlb-w@;WWe)6Fd}MI0VFt8x?N{n2Z5_QI+n?k&P!?w zoTVk_e}U}bueCKePgQNS-||;)+AK`eZ*ev52w%zD@VBa3>YnAi?C4E4l6sIv@}jwa z{cdL`WIKMvKAJ)2{NPihpvYOjWf!_2t{{wtgqFk%bi?N%B$k}UvO8$lv?F*?`}LVXIC`$Xh~mJrLmiZmV!1CuBtR7kj}xK$4eq1hyttI zmq6Dn{7ziT#~TJzazIR~?wIV31c01XY$`n|R8{liExMFRa)t*P;Rg~0M9Y07XCUNB zrM^abLE~Kxo!qUUi`;Aq>treLSOzxW=$?T<=)t1LbY6hRt*>)QV@Ow24}t<0o;L7C zPJjl;m)ou#ri!arVz;-9f`FoBSD&C^C;{&3Fn8T+e3D-^PAT##h*c3DEJ+3SkLI*8 zu_$QrfO~Lj{MQTKV$i*>aG2CSdq8r-PWU(^+E1`76|9~4yBGiDlZRF9micQN z@zF$c$ijC6sY5t-Wdt-+r^gRJU7_=x6g6pyHm{g1&pfkJA7>7_mZ<@X&^6BtEOB*( zfln50Cr;U+AF_QFA>&JKiFbT}7N8dfGl!QZ9SlCbKR%oO=hB@Z*1`7VfSs`rBaVLF z^~t-_H2U<=9Mqj?@RiQZ(Qmaql5YgcZ0Yk&&bVsDLtaHzltNmxkIxjZE;d65U$1g4 zDicemqiuZ1a+c@}{Q?XrNZZGu2y=h`s!J1P+2?8b*fH>6R(t5-8<+nK`wgVmGiM`C z7oWc(nQNFi<&tEbRR06dVEygdfhsv?IwXz?S=lAr z@aJ-1Qp7I=>|?qIf?lfT4ylX~`BojR*I$Po&gYAv#bh7ISg3dtIv`Y-fkAY9u{Sx5 zI4>Gb6$NTbgW_OC`xW~GSe$QxqkqQ(;m54##2Yh^}94Scddj*?mI6UC89mCL9s3OI+sOm(Av; z#Cg09pDXfbxJptBihMc5bL7v?K}myUEi`;XT1{4qq_Cb4cZ=W0kNA;CIlMEoi?8OW z(j_0auRGBVJpGkT!d0&kPRn-FDO=p3F3+Ky8W0z-#%m z>!QZb753Li*N`6C7!1mRp$pT0H+x8Q3&GB#E>I>Zrj^nH&Pw1~c6{=qafmzk1BY*C zXr#OZiqq#Y<}p_oGeyEJf5pR!+P9qGfOKIOT6Zx23M&Jl#szAQ2H^O>iZbKS~9HcJARz_{kaYQi`Fm``1{vai$9JYKt1Y+hi|$ zpKX2sipE9|+qP!Gl64+%!k5t#$PY}LBj0Q+?e$-DYJvCeQxlsR6|VoI9Vf!9uipXq zQEb0_(g1Ps1|3Iw&3mLtVOj)9YAqpv)uMW?%hWx67(xVLku!BXF94qc6!-eMUvh}~ z{H38o5&a&82@N6gF{5dogY2*!Uy4R4W7{zr4oLfdD1Y}5I^cCv2kd|hVSw!z1D!mf zN~Qvi2>m@9fOzrwpA!VChmdt>LX!%6GO!@<5G}ka+w3$$_>i_&hb+E~AZ~*(qMp88 zY1fUd#kj3Q(2JNuS>@9$)iN;qe_mbw{q#IUh5o+|2eq2GPbLIdwI|AH0gJT)&Lx`Z z#BJH~e%)8tsI|IHvQ-#E#JOU9)P9v^1UbR1 zuLZ9?!OCNmY>+zPw6x)jfNro>T<%#G3py3 zWuuD_oPxP40*RomYHTlq3lxz%xmfh|2piG&#U$)9uDV#JV=>#|d(}h0rde)SC3FcUV#ww}XJt zs4c@K{7Au1i@Vm9*q;)~S~vnQ9@S&{J1%-}u9}v(zBpfOM;B#PGT@9LnPtYz%~b$o z*%-vxGM}#mQt+&kc~D=9GNb0CSjQ=9a+(r*I`=k7*ZE%U9Gp!Ejkxa!sV&V z+;ZZQb(bI2+BrPX;w~DkApS|+?DHP1YqjqrL=#E>Y4GL^{>h&u5p8U{A!IVgwdZe9 zK;a9Bi?Y;6OgzW@6L#=V$`Q}+{DB~;%8?+k@(-nRDKMwm9TL6TnotlmkUj-=)gft7 z4dg@5=R$CBraxyaa)WCm(iY+m7Qh&_GBh~Wfw>1t=H|N7se077!vbDlfM$RVXvcn> zo9+D_GWd4-lbzJ9VxWB)aLoRxrKa6uq#I~2^wT!a*RWfGq8>Z;M$SlewgK7s61|Ygu$l~(5CEH3@)mGdmgryW z=Z%)|D)*=%6v^)gG4>3@n~60R72XTdadMw5e^Ynl3aLa2)Cca)rMAtFc`j;m_q!XQ zKhuCFyJU8;7I8;qWbGh;1rCY%J@Q&3u6m?N|Q zR1_f91_tEjE)4WRe8}w0M9e2yK#1>|HD%aAX|{J%Glu6}aL%=5@sOIv?xFvbUEcc;Rs!~!luWn&o_Pxg>6`6C5Z=@h#jL~LyH-x^l{zB5*?+41W zMw14$()H#VN#?M!`NeVlPA`N`VPL^;!Hmv=s<}$adOkaFWD!scmIg@A7_gI&dDo{ZmuoKpa&=ij&|4$SQ zS$?UW5SAol(|{pUbYcv|tPk*oL`_&)#;_r~3PYALo0x~XaTk%m3MvQmP~Sok8L~|{ z$EJaZ>9T1WaZh+F3AO3&cE;PFf2Kc?<^kxny zf~G>7UZ_J;e4+)dYRutOc4mJu_u=z_GkwIbAgntfGhpbo^oF*;BBC}M3dN&oGok+V z8&tyZLTPD~Rv7_&{SSzBgky@XBfZ&MH}9VR(VsfGen}DQOZ+BHAK=7juj*8s`D9ml z#3yU*l&gn@&n`f`ZNj`){L-1^jP^EA0Uwc<$CtyVs%Xavu93iz zm==P9tQSzW=Ke`PLV?Ycidj&PJ>C*GiF7D-|K@<;Zo4`_XwBR`?k4aQtJ0wMbwYkA z7i#@{$pSKKNU0SR@L( z1ZEgr7xfZwwq68`q2fMKn_2)O$|j^;%{W<-x#)J13z7f+#-9c62hX;q929Cuc5Tws zWz<$zJ^u%LZywci_w^5xB1MHJNlF(YDx^{MF;!@gQfM@mG$~1+W@K)lD5Zgt(4;g^ zk`!s4XKB_*^ZeWAoR90CzL)#=taaaOJ!?JBUsmdU-sgSJ-uvvc_iMj)=)1Ltsd^sr zE_LVpQp0+5gjl4$xxN!LcD4tig<9lRD?S>eLPi@{}cXI*VB}Cfv;$~ghXe`l0Bc5&llsN|XWi4#PFJZhS)p8*NM9t|MCa4W$L9(kr&62|+1`^J)x?9R z9Q7>$b(v7_teJm$EnUavIB@;P+3qNAty%O}ol3nDtA$y5f6|G;uv^L_{3=P)-8=V( zJr`DgQ?f#C=D}Q@Rr>>_v|A_HRn|#a8A+%b2i|6yKv|G7fCCCrH&vKnaX-R5AFEiFAKYkWTa)&62ab#FcbRn zedPk;G?oKb(AmGyfC8YUxBeX(5MI9E`U&(63+eX)Nf*nBTcy18Yz4AzAkY+mki<05>KU9hXuVs6fFD%H8XrJNv0b)2jORybFQQ zzDO4`QB5v^jsA}w5J1RtVaSWm1$WYsH5I~u0oGGprGMeM)FP093-bb!|2+-wx-EMv zf^e!Jpy0GFfke8o!5=~yB7#H$4U;8pg-_G<*gM49oWdqIPy^@QvR2EwY0|QBw;|aL zg@oiMHb4VjX8aosc;pYi{HTV}4tHWUdGn=@FW|yn%n=rncej4u$&O#h$PSGK^;N_q z2w7JsFC_UpZWp~Gadsidai#einbGho(xB3XD*`o1V%wWQ66kJFWCoX$wf$m1Qio$n zyekO0upAyaEL=dNY`PVAaLxMwi&i@u9Oo? zu~`u~#Ge^uvCWg#Abg$+=cMOdR?(V-GXg+KX6xU4VM2ho6fya*k|wN>+F<#&zUEA@ zn#=)lxFP5QH$7(Z0w4{lN#@NbTt8t1ZRMF+vI~pM4MYg@H;>>Ygj54Au`5_|<3J#D z|K<`ahEJ0km#@K_9hXXwKHb127TBxZPSBQF!OUQG?31wPRW`W0(Lc#db zLOsGIrUiSU(Jx(3jN%el8(!*@iv%naNT3sP`+)N!nFa3_n?sof&7)jPs(=dJn&`}*ubI$ z+ll$%&b@3G;HU6(uTOa2_G^K7Dk`gA<`)cC8d0Nx)Sq#J^l%HvRsII4pGF%1h(8*T z2he~@&jU>`(H=zw=CQs1stBpcSc%^JyOyJ1C($mM#}sOCQ!5RCBt)QS&$?N7XaT^x zAe-*jxrnaaK;Gf&fza*b$8gwfO{uH2zl?<4dG>>a2a7q|D%$W*DO8mKN0NOD)g!vq z@uirC$}B+2%du(=u_tjSV2D8XARp|C@_QrfpYTQr0thlnfVW99%WfiGYbuc+Nr>G0 zXA7n{V)1)Q4h5SJg?sR|j7ii3VuvnbCUfr6P;_DA0$j(2=e1zPBm0 zn4M>Vn>BbOe!`NQi1h*RUuDnfOK)+Z`~tdj1T0Cv$!%muYOECPwVR3gXXi8^Sa3Eb z7*QzAO_BWQ4P=@@58O$gUd9`HVZZNMgsvc8a25f@&z_unrjKmDK6Q?Q6K^Wn$bPq+m8y}&U%UU1L&K-E~|AgX;q?tBO=((MyZ~>Ez zQG$u^42SPa#dKtD8Q?>79ka70(ryo)RB-}Jhcz~PzmVYSG=0v)%hrzWP$e?H1n+wL z29eFC1N?F;$G6dHr~HXoKD}1S2G8#_!iyY`w0VHnb_HV3d)H{iBg6M{$n1B$QUFwxpH0FD?mcj@8I zgYVBHlfxKp+3ERhgeC}JWsE7OXw6du!0W#iE@(m{CtVFvzxv2=n*1umPXaxR0UD>> z5c@Q+4t0%LLO+~ikoy0ae_DzD8Xa&+#6`nJ4^R;20h`7YbDGcXC^^~o04}L=oP7zo z>xa7H&&*t~oSAqhwS6F6Ma>N2*vDMpwiooWf5==qJy$y{2~t^3Hfle?qi$SqGnFj3MCiHQ+*f(x}5ra}U^wx-c>S22&#h zD0>q{kSs_6D(xuvZQK3}WEWlb;iBK~wuH~B#{T09rQ?WI+Q7zM6xB60F*XA*a+BR&2J`<9U1_P;htLPTBP9BxIMSzpWyy38j)Y-ZzlI$$vRQDQGk zEo2fxn^FG`%{GrR%PmnV1{ltk17f2xApF}7-zD1N?*982`;%FF2C{wY`5F^?Vy0Ik zVCJn|7%NcwRN6*GaMA!cw^mQPxo_Ztqu)ARY~a<3&yZUTD1Y}Gr4|n@tWN+wP_sJ3 zzVk^EZ2rrw!uPl|mWQLV&MQCxCrx+Gks}_(pF$^mH)}Tj2C9Y5L!{IcsQpfWBfMM^=Ys2Lwo%n?m~epr>yzpE7Ew-6O*k2;VN(+mvo+z3YD*F?C^4 z50m+pWx8RC%K?>Yt-bbj=s6%&jDk3_yM>{)+X#Z+0w7Iqnn~`2fN-T+qK0|V`G?h_1yn&OEjXU~t25AY~P)|E9eL$Qb7L=K3SVT0<8YxgGj1uXXTT zIv#ek*V5{cLJhEFoT)c#wPT>#)t*`+x#bsRVb(Mj6>)X#b~bi@$RTp8!vX5 zs(tkGl&PBRxhjUcv+^@VfN1(JaJKQ-fhI_<)}1g8dbDES_;ZA2yXb44spKU$c6^PP zk*kA3?_7B=zh4PQ??;)>U-k!S-;&o}$QKgFnVzZ`R zAA{I>hZK`~?@Rz-n_cQaXM*ChQbgG&s!e`T{rBfw^w=0+kE3u@Kk$>;hUlXL|3tuVjL27MX+vh=aL9=tn^aL+#$~2$orSz6fJ-Iy zAkJ&yG!z0{dkrY_7q#f562F{~R)Hf*=(VprLGwt@qMJg$3=h6?u`L33W|_>B!}yAH zI|{6IyuMN{aTgGK`<_iUckl`PfCCbG`VT2n2pA5OJfiRB(do(LJ9RMZCM4H#BQ)Oc z+I-_jZYLFxQ0D1S6|5II3aJ4xhO;|WncScxTcYB1`wowrV2`{S0GAS|$N5x)F-tu} zUK@HQwx4$YhB``&pL}NP-e0lFLo8}Gsl|C3kZGNOSd;0X&MdBf3H>jVD%4~r4{+|T zfzWLCweO!F-C6DKu*>?A75(J*V5M6}k6eMcaL+Bf*y}X_k{8ry=Q{mliCpU!p1MLb{xM~$3*s=Wq5+33R!wf-5(_TuUgBn=m;g=2+A)K_qv1Wr0LN}&76FoD@k8bxr>^tsHt;R|CFsNlTS^g zMs5+;SP3Aa+OCD4j5W$Ae&IUa72-1R;oHd=u{6(~>yL80Q>umOsqYsqNhvFXZ8k^6 z2b}5eUnuS#6HMwo$?;AnG64>`D_^(gOEG(VnFCBvT3LBw^jKLzVL*9_EyR~~;Q%!M z`906#hN-*LuC7E>RITO;gmY2_Nsf@G_{g*)Of@I_qnC zpvCYK3XdvT$`A-=D0TcI6BFWOXmt0t-R*HRW{K1_LA#6LR_247W`DV{xMza$c#@B7hr0y5%ikd&@`SysmY@>3z^3i*M^u!)^h-Cax*lrA~m~RA0#< zk5X4m*@u3YC?h^P@o5htC?EHMWOzAuZo!g)>*&vCmzm;w?Nt<3DJ#(<%%I}PB|(xg z^!h_nfH=~O9+rZbrrIP)fHlK*9WgzJm3aUZ$_NTXPZas)R5wjN-8e>DS49L1}5 zM8zx@k59PP6HqMGwhRI*O^q|*2Yvbg<96xUBzQO_?qyAP73MWev~!NC?z#6Zm7Q9{ zSm=C|v1ZBXaasyT_t?W>`q)HBXIICcJM6-vX*36E%S!_%;WBg3M`tI1-#A370sJ=N z{aHh4?V}85hWn6!yH-VArvMDQ7D0UerOE&gkT0DUmwGr4N8Wib-9CJ!826UJC;pT5 z1vun<1E*Fbe=l))Hv^u#t>`Rc2ld&5FACFrJKsP<&NcmpA?pHWZZ`(Ffaj?fr$4;m z2>?+g#tkB&?k02S1M}yS8|9134^taA9DXb%nc8c!FTX7OL0=&x(r+C_1h9dS-IUD- z0#YN$bEO1AetWdkW9q~#`?CIvx!>d@PJN)~(gQpd$fjsKLR?ac=hPH}UEr8V+xw13TcLrq;(hK`gDVhb2ZE*E&g%j{Ri+s{u1#N{xAxc{Blc!pUQ@_n7sP%#ZVgpA z>YiJ8ch@{I4!!`ej>Fbm48yy4-YWW7l!xB|M#REs;m`K$>#LkzKWNzX%XTW8_|@*6wo&K-p9; zzB1**eI5ZhsYlT1WSN8T?mEC{d=t=T9E%9Fuyz5aWeX;C(=DdikV{N4ii*+9QFXW4 z6+4u2ZQ_6`!p#K%>4HVVw^T$l<+I0%N8T~z0{agD2{gc^SpWHOq&d%KgW2%+>DLDT z6QHg=zgHEwguF~{ID33_sy%gUgVG^ZgGs0HrY=RbnjIc|&Cna&x9sz1;gXyOLbW;&X4RWjAu1^38!XQN|FN!nSUJCZ+8$7J5w{MF@ZYJA6?=EBeM68V zzhQR7x9j6`$6r86*GLM_s|+}ZVwPTC!kWYOrQR56ciZu`d*|_N|F|k`-3>Jn zOUhZL+u3@7zulqWh23DYgh?s?xP8ous!{2%k`JrYcb7RufGOT#LEQ*AN3*FzCunJd z5eQTKBRmKEFshT{J#3i2L#stkbwisM*bgg1z$(zow7oBwM3F1?+4GHldeWK`I;XVO z$$(u*Yz4mz;c$`wVVKJ1VBMu)3}}r`#ld4%4eA?~hF=`%Jm|AAb>B#TLygC$0k47bVcM{!MxjLxL4{}?XG3%f7!q5Xae0ksB(;hKEzdP3vXp5dMG-phh$9;$R_`W z+9k_ejRA)`PtGewv;Ua4GXM(`b{0zsW?tarO@!tV3xhL`BMjESIgiHJ@fUkrz=bk$ zyT}J&2$XW(<^lncrd;m&0aO`N2%KYQpy0#qi!;+EVec4+!T*A`Gp4c~Kwvw!e*@c5 zDQ$o~-tHu#=QLV%vSV-klV&@Mb1UY%=f<;5Lk$m<=1S%CpsF;uET<0#gZGYVoMhp! z^$F~*VHi2$>Ad|E_}FS9qW>CZ=Qf)9>K0Xe^V3)x=vh|}1rwW+qvBjfnyb5i1hDgs zYeM$U9IEUt(_nVrbyBl?+(!1XLd;z7hr{R-zAaaQwOLh-DZcPI+?MFeHQDc7eegf( zw9P@~OTdR$0qiEn{Hwg8-gu`0N3SoRvK{lPd7;WV0OdCTZ}_)4)3=I-0J*8~2?Q;U zIU^6ih5>G#XvoTstMaMuBfS!bW)jYRUa2XiqiLnU zFbrM3y6O6y=|?__xX&#O77nDOvA{KZH#BQZGAUbMkxK{Ug(uv`t{O%|yux*pD5n_+ z7;`0KBkDw#?($OQ$>*U1qhV znW$xYe@dID4b*UrAoRu5_~2l54>t&2;Kl2Tb}j&0ZT$6cW*F{Hsik&F)32kM0xy<} z%6HqSpK@MTJmxk~&a3mx5&)U9O#q>eV4IHExK3GTfzw!DU0}WVIsFI#RlTg~3gMH0 z*T^;+_xyVp-Va?!kUZNugJF_0TTYM^8$}#$Rb_v3t|Ow~-BVBAkXzLsi}r{%PeCzM z`?dBTsQ@di1#F04-$!6>EHQ8zJvJ`Gt*n!x5q6~p_@RK0%D2%VO#I?UeGl&_SQ=-h z#S!3OG3Fgm{SDbOk9ct10dV3RTeOr10Ll{kgswG!{SyjsA@?e)=}N;1KO z4l(o;J(aG=)HX3_wO8eNd*Yd)yBtT{@{=Z+in7{QZ2)Pb=6RNPw+?h*e)!ZFKp|t$ zt>D#akp+zz_BN8SE+gMu>3VsJPOgIE$=hxoSCZs;rOgiIvIf$XIhS``ci3~cqypyCbqvb7(zdVdo0 z{28{@+aY_A54?S6u}fXR2=Psp#pUA&O62k+Vq0=!Igg};8Mwb<9w(y?3VN@D8;eDI zI|Pdx*|l{F^fbl1=Kz~rkMLPiGrpQ?Z(;9>+*9DzbrGV<@0j0Q{CGy;Q2bbp^korM z0IS3Uq9MKP_8Tzwk2%J?6jiHl7X~222S6US_lK3aZBh^Jdo0ZDQg(nVwc{k)vOB$_ zVD&9fY?;~VM;d!yl~yLzmMcJqU(4s(D@4wBF+j zeMqkkd{%4JD{{l4_ke0h1hT7gK*%a_2{}U{mlCz3XB?m((DIS ze73AwjO`F~O?ObvZR?hcGCWioK79yWGr5S+)OmNhXy(P`0An|=F>r|HOxLL5FsqiQ zx^_T?gR(sD13u-NF&?Le`7PHCE{2amV4;B_Z}eovNKb|8c;ZG6o@S`Dl{74Osk}1# z{hIueYc=g&FAY`vq4sXgas$?^v$7nvjUPP2N~+P_FIwB7GR7<-o+UgRZWvdJrMv!8 zk1jbs|G$9+1X+-*VrB}1p6_)QAJ4jP-^F7;r3Jy0WP?H|7<5m|zrWh2Q7_EvqShss zWegD;??4atzDOkFXRD z5OmY94hkt#{tVzbZMV=~C@nMtg3)U&QSS{s7-LIg_r43b*7ZfgJ7)H-17CmGf~;%l zPa?kA0&~J&?6c?Keq`&;Q-&H`2#uWP5UVz6&p9|44V8bJJDx4hHee0xUU(NG0H7$N zlrKv+JvD*?laauU^NR=b0M7i))?|}Y5_AUGotl0AKi~+T1&a14Y*_BeWt;VoPjV}C zY$$i(l-lNRwU@*8y)kool>5@s?Xdp!c!%e71O1;Z}h_&L%8tpses!l%nJcJT}YxbJb+ z3AY-EipB$Vc|9Bz51-Y62bN}YA^g|cE42dWLX4D=b&~Wjizy4+Rqp`7?8eA0o*XCe z7*y&?vX2~hgwQ97A~(dHx~{8-P=j~h*1vh58FE>bhvTG=;+^V(${a+;hX^H@sner* z(q3Z^5)?gxcN%-HS*>3v{w1Av*OsKIeHD3JhGuX*vKgN7Q9w9C)_o?wafJ5}{E9iE z1dKhruZ@qhOmsu{Y}74|5kBP*@x5uyz0|=OV0*BzMNM!3xP0Z*C@TJ*J^g;IUE_mB z+qs!ZNa^O82l(;6c{R3^=j|5~{sS zLyDYvHq1jS;md(@(=GE!fO3>dZ9rGx-w?tvh(*0{%z|rP)8%!qTq@O5{T*kUzLx}c z&u=*>Qhbype}pR@?lghHSIgVyIlD%BrrAFM?*o%v?YD~KdD5&6B<;_(354Y-HSi)4 zmH@EmrgDl7#QR2N4VsoV(b%GE0PsyII^RST2h5&=#Ld?<@Gzk8-=&=W3~>oh*l!?D zOt0YBslJh|`VojLqIug`*nQ*rh`4h+4^9aD9QkHvH4XJxUMFL&Y|+w%4h_P^iNMqN zRh%h(tgy5GT7SV619Ra4d-ig_>xyqnj-|(&D>S%kQU-U*eSEf}aCCu^gwI&nb?yd> zbo1(Iq4zOMG~=6;22Xk1joBUDoKG!SKP&g@)>h=EYl=C+HK$HI$b9`4LW!~@!X*^A zjJktV6Y%%#MF4}LZ^t9k+&__o{5SZjMjD#wh7O!(%~{XR;jf37Q0fwr$zzO#Mapo} zeE9erQ@CHdR3G?3=Qf2d5rvim?TYomP+uWCgzC^OTe3E9D!aZNQBa4)pjH(gror(G zMSmS4P%#Uj_R$%aucw;F1XW``awq-1$p^70u&0-`* zyH6Fsv;}&-k4nIKvw30NS~p(C5r`8+s0KdXZ4FpyGhoZrhJV|46hUj@7NBPM{uqqG zG=rkLdYwPl{|@eMgGoJ#m!no)4GAdH4GGPayzant8oHH%I@WgqwO}61hqC`#)B^_8 zX`9tuWJlb&3``*X5(m{5vG1vz?S3Q&KYNH@F5AK?hEVzN5@dzd$dYIpG#yb8nu^i7 zXr{o5wEkc{Npn$;z*hdICv>wy@FPM`_)Fag$^^#179Ix|Lc;!1{dq{zK!>9P<1HH{ z&!78WgJl9*uRxcU{`aR)o11&}xRGAH2hvWQ{{N)*t&#{HJA%2;-^?RF-9Xfo*VICn z{`bFpyNb{Z^)3z1ACP-bYI%LHldL{(oHPw_mj|92*Q)zPSS8qml)xTHpSIaT4xPKe z&LpytJCH=zk9dL*T7T@+A}{}o06P{4co#d+ptA7u9D3YF%-IntjM%eWnvUd?|M<&10;$;x-Ayl93MA29U_#WeO#63Hrahqc3U!|j z6HJhICMdsya1!n7GT`phv8{NLmg5KfX;3DIE^RK_1XXhzm}lPT-fJUTJv2{XS@SJ7 zq{$k8_!HhuF-AzKZ(&Mcv&y#Zd!!5=@i1F z{N3I3DNOhhP)A@kN`8dsi2J+4A?jjSoLQ2HH^)qbh$q#RGS!*JAx+G_JOP9br~0Kz zV9!1h5L01)cQ<8$@uWs})L^bPHq^yX>+cSS&>C(nG(_gXv;44;nB)>RW!8pmhaB+w z{n|r_%~&%(?;=Q_K$uYr)wh?hd!eIBesp6E27LV&wBoN9YN7@iQXy&X7xAAnK6!to z!CWU|+b;~(cm!aLW<%a(7$>`M69!gx-K5!$|BO0>e#-PNL<||B5xtC~(_R`G))3v~ z(U(iZr};X_f{4%qVD@={D5M%vcmGBW{|97YJAz@A$odx&P}V#6sk}*vwDtT2Fsz`i zwO>21aP3D#Ydr&D1V^+2iRX&)Rci|vdsbxnTp(bjNF+Uq%B;4MWi-w;*nl(jKlRA3 z{{p-B;BS^_#2~FA8(c^j$q=LN%BKB-_`7})?YiR$XOOX-lpi^Rn27KTrCtAxPy^Xi zYyCzu70(dP`?ahIhHx#Q+YGzS&hi`Dwgp}mnRcC=q#yT_BaQ{o&_1#ug;-sH2oEF5 zQsaMf;r)poknt=yyv29#&{*^UqXy`s55))Z^iPXm`T6JpJvKWB8AY%K;on4z!_y(_ zBSf_h!4M)G>we=0(R!%aOG^>s@JC|7`!qxx5cypV`OT$wbSZ&D=N0@W90U+t&?;>f zTJxMIpsa;A9$Y7y{%5%2TVgzo1icNSrf+!=VJkR9G=PJP2Gaa9J)j=4K3|Gx@J=Bp z5l=g=XGTkQKVigh<^NH14q(kr{3cRVBY=7%AV;m3_PCCX#z!qYf4&Mp7Gj}eL`-#+ zP5augf}cj@v6IW+ci=z%6R)7eJ#y&J(3eXVIu(#j|D{J(r)zByO<|6L!hE&}E5n9v zJF16)UT!MbFe!sx2>#szZX*bf|7CGMQV+9*cJjJYsF4He1Vigh6Q12YM?|o(<&Onj zvabr#qX8D-a2k%1x0g-)mJo_q*=g%et(9pEA7JY<2nPQLhao-agqK`**xH-P6fDRDvAO|3Q18{^@ z?rF@cp1?&i6P#g-QMfg%xjQrt{TKTIuwrZe8dzQ+=NuQ;nSkmcZb!WbIDi?@!hp{z zZnqq`!xFM*Iz&$xmSoru_dyUp9z|fPV+}38hyf;O;0pB9(|xHH6ff`D5*OvwI-V0VAnRLmZ7{E054ha+P>Q6DuHuVyN~)HY_wF23S~;Cu45wn-^@&-v=qYaao)ow3;Qwt9b#~<29uK0%q-A6sZLMz8>*b3sL=yz^CECLB|vGROveNS>uREPjg{8g`l7CS7W0Ur z%TrNG@Z`ytW#7D9Nb9RV%CRdclXLC=8`>qIN0@1E>L1h_ZY0i$5Cx|-&*I+8=| zXMZitC({FEv)T5QxL<5SpiybEThr1I!GYp%bkUbi5TBh)IGweoYo|H*z=_UP127q4i=mohrbglHQOA5ndG6 ztMwMx*VqfGD|NY1U(f?vi*@d02vliySH2=Pn@+}w50Bb7kgZc;hX3x?}Z2w5kcRY4NegG9T-;X`YhqyobBS`05+h> zIC4(nLOB#m$}Ove-eTi*F-xwAn^HA2PppfL96on)5U;EnHAnkdp?J^dEvh+m!4M)M z3h(Or1Q9w1r7t8UUjL7(XLN)36r3|qS^K~*)VWS}ASEnYOE>*WbQ1tqM7W!QE=v~3 zJ$-uFt0B+(j+wfNYvXzL^@u|S@oj!S28ImbfG!RsdX55gbW_bFWeT_q&S^%d92C*1 z7V(coyh(i^D{3)14Zv$+PRp9^O4SQ{h7h=j19PJvgE0b5RwP20UNTjxR(>_G8;YeC zmuS7wE`kJwF~r!%?@ge9hHvWonaN>PmR}vF#A;`jS-og`K>YG>VXGL!oYF^AN3gICy>V-aP}Y%KOM>K?!^EV1K{U$- z?(*n2epuzVnKhX&3eW9#9EhAi-l{}osRgf$*3;Z^90d#Z>V7F-5KnAx*wCH@I?PhU=&F+N-+>N8ratk#2x^1O8|br zy#6%ECDloHJ@r`@ckvnBFalxqmdNyOMHHt^j&V*)c&%LFw7g`IIyVWy;Ktj%0WDD8 zt=F)t1QlA4C48+3G_sdfWuePeKXe7#QmW!~vv*jd0`l<}rgm>N+tS;{aV7ZqV?z0Q zfIl-*_vR>BDRx8R#yHB3(Jr7haH#7s+u*_~FxlWIi=?h~AaMk5pEfCN~7$wuS0A*7g7_5`f0My3>fV=((pQN2?eNOVrRqF$%JCQqMgE;kU zd&=_wLf68iY4Z ztx$W2^{G3@uyTvNhu+}2Mr*P|kw2u{n2ib43xGguCi$T-EB12!4mmH z_iW^e;Kf5g!`L$K@jpmi`o}BirBXww4vqtJNF7<6unM>Fh>Wos z1CQz6{sypt{XlYJ+rY4>1%YIH<_BM@=a|o=!TFi0@l`j;tcUJL&J3i*sYBfIdV^js zvLSAoj>vBZEa5OgCer53_33k_Ekmuj=5_Jss%bpDP4fRv+o+)?SlcFe!4ePXh?O@? zLRX`|uK%DacL61Nk|N_^`v}ULL0}3?hul=-FQBFkaGpJ-2?wR6X4e+8Ak6u`H;bDp1}U;@q$rfp zm)r{ttoMzPupB?4eb@VJjc;0@PEcVgk}04>)3yKnOYc})8SeIK#&6(*g);{wo0NS( zy-?Xx5LqCnh@MH#ic(F9f}!V;@9m~UzEo`kJRf3inT9j(Ve1H_;ad<#k_51-Lc{Oa zet<;U^s4XvxxWFDHJU8Z8pRwUHI-RT4zd6hZ*tV=7xW(RpMaxB;yMKiA-MD}KTv(L zBhR!ts%H)eQDt9rP>s6a%uIr^js^%#_wmUes^jlRK575ZiOdlk&bmjTYL74f9VOUG zeA2hIf7dFaMg`0}H_`m*{jeS@-@aW%EJz26D07`xqZLlxq5qYr77LPglV$A>6(B1d z{P2x>37AoFQB9PAeFujF7*&1OpCGjFpcdst)I6MfX1O<)N6g>K226UY?E!`?4*7Xh zIFf|CGXVN*@OnkT&<=x(A4kD~C`2YD7OGJ!GDo$O4Y~#Z>2WObh=6?*q_&GHIaTGT zBXQ_XR>V~$PuJsl$Ayhzv=fta#_DRl*81$!In~*-vrxe?Y-kd)D>GXHx1YHg1QkC6 ziSp{u)h$qO99<+K9n~Yh=DK~?Lq1XaZ#(>dqUEC7S-a=tN5-CWR(_Xomjt(3;u4&3 z5ne!u1oncBVU%^>NSrQj$i3JIlY1kZ0sQLf^i7&S=3QcoC?v+fBlt`9#4{^*ZXjmz z*Na$fK8%j0K3%w*L>=}M5xJU09W`|TF8qGDZCE$_1`kLYYJEfeq;ZHW%lwV^1j-yE z=NGDWYJo1qkjuOB3oyGh0Q+rEQX!N`+}#v>b$zN6&>BU<;);BecNjAZ+-)D*YTvlRk&jPn1egK?JLDI1wves6t&B#fTx!nEjWTfHs?%KCu)5{>w@fuOf z|GxdGh6FJMT`a$@49S{zfjZp!*;}_;Ht()5?t%uc{f~P?9`cH&+N>_Z!K8&yTz`LH zD+?{HLLt!}$|+1RxxmdE?%VsySN!J9_;ZT^ihRul298ZC{@xisz?)B9aK?I%Q6~cL z0p3XgAB&kjXf zmOXb5qW*aGxdRx5TBm?rLq2t@R2Ul-A%6B;U;H`mK%y4_GVZRXXA?4Z15l+XfH5mX z6-;D$!hQMx)vA`HCKzG}1!tdYdUgVD^%b|vAs2%IT+19j-49LAP9r3zOON7F(c+&E zWgnN_$L1(Bt1UxRFx+7&^l}I9fd7a!(Zo5&6+v#I-(Z=_ZwI;;7iD2ZogJe zfN#_XC`H?s=@Z}Ysm@QL4yprwf+L4H0l^i!7WnC$A5Fhma!Y)Dntb+5_!4*2V*&cQ zs>q9n+kV*@a_Q4*3Ame%ubzu_nJpZAIHUWtZG+vGu+`XyrvMVQEGX|3aRL}g!SEuX zuVj^Jk)><2WT`i#7lIbLA0SS_4OE=`&@*&3`SC1hGuQsQluKba*Zk`$D8W`aK^-fv z=YB#aF-KBAbmtg3lsRxVo(3i;5wVcX^oCX!A0zcITUpxmLf&rl&B`Yc=%9nL(l+N^ z&q3(M=Ic|3kEh0@vwTxBSebvAv+mMLW1IeuONG|l>F-m0z_^l*X+1?(Ktn@9;MsbC z7aY&GY-9hj&Uf#g1N@bbw;b^nDplrxd@Wx3Ufb3yKf~0=MnV-4$mJNtQf;TzC-~)~ z^dmh#s=nS{ioQ`A-fUxP9)Vu$?S*H0PL;lV_{3Aiy=a(GXh+UV*E9O+)f4n;iW59M zRavfr7sweNo;5X9L=PWXx6mm~K2dxX`i965S9yIX1zmw=)-LKj6-%L>K;$@F(JN?k zzzZ;HYWxvD>;ezZ?ULAsAC7^Co9b6flh2}r#JG4AdBa@jUkit->m*-MRKp+0p**Vt zv?b3d06rg^0Ec%O{qKAKRmA)K~eL&uC!!Xj*S>5~< ztpPv0TxOnUwE%vfIzN(y_$2sd-S+eQ(VN=1@EWwmy00M1uLiT#{Ah=o@LF==K7&yXOIhvmO3;kIsuUn-HLwR8UbGW4O&%n*-kMFDDE%PdF3_{E4 zN{NN_j6Lcph_^lr=Bs2m;EA55gzCU6bvEY{X)6P13zM`{A`?K1o61RFJ{yK)V(cIu+yvWm zcv!JVSQuV-Q>L^I=Q)%Avw`-l0^agA`;5^pE^s@Ao_J`hPkx&M`jPTXn5@wse&x(? zbRKxSfi-_xf3GK*Rt0nT5*D|So@m}Z=o{!2w}q;Eoot*X3o{4{GpOzP7g-oiSeR`C z&SYWiU}5ZpmB@VRR$`d|NNGs)iw+t57vBIX0BWpo{yWjff&-M0;ukAFk@swbrSwtl z6Tl;Rko`ZD?QJ&0j{AXVRRZ`!)g_;O>BJg-i~}_Mq;wnB@QpBa)yQ~htX&pl zvX53Mmzdw-VMW7KLU%J{9-aks;!m{&G3eFS7)BrNCIj1O`#J)MVn7I+Kx)&DRXSp^ zQ-f~`dVK*BwlFgeBEol|2PKm*tj;UbPlxcDtSEgMc=WN z0=DDT(S%_mwCZWrjugup3^UeO<%%sSswqEI~X)>x2_I(&2<>-I+IKY z5){T|>XZ<^;Amm;npZ^5-090-p4>7<{_hFVxF>65e8>}r;fcply+o68V3Bi{>%0AT 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 KTJSHwum215)xFXH diff --git a/docs/guide/src/pt-br/index.md b/docs/guide/src/pt-br/index.md deleted file mode 100644 index e3d32ebc2..000000000 --- a/docs/guide/src/pt-br/index.md +++ /dev/null @@ -1,52 +0,0 @@ -# Introdução - -![dioxuslogo](./images/dioxuslogo_full.png) - -Dioxus Γ© uma estrutura portΓ‘til, de alto desempenho e ergonΓ΄mica para a construção de interfaces de usuΓ‘rio multiplataforma no Rust. Este guia irΓ‘ ajudΓ‘-lo a comeΓ§ar a escrever aplicativos Dioxus para a Web, Desktop, Mobile e muito mais. - -```rust, no_run -fn app(cx: Scope) -> Element { - let mut count = use_state(cx, || 0); - - cx.render(rsx!( - h1 { "High-Five counter: {count}" } - button { onclick: move |_| count += 1, "Up high!" } - button { onclick: move |_| count -= 1, "Down low!" } - )) -} -``` - -Dioxus Γ© fortemente inspirado pelo React. Se vocΓͺ conhece o React, comeΓ§ar com o Dioxus serΓ‘ muito fΓ‘cil. - -> Este guia pressupΓ΅e que vocΓͺ jΓ‘ conhece um pouco de [Rust](https://www.rust-lang.org/)! Caso contrΓ‘rio, recomendamos ler [_the book_](https://doc.rust-lang.org/book/ch01-00-getting-started.html) para aprender Rust primeiro. - -## Recursos - -- Aplicativos de desktop rodando nativamente (sem Electron!) em menos de 10 linhas de cΓ³digo. -- Gerenciamento de estado incrivelmente ergonΓ΄mico e poderoso. -- Documentação em linha abrangente - documentação sob o mouse e guias para todos os elementos HTML e manipuladores de eventos. -- Extremamente eficiente de memΓ³ria – 0 alocaçáes globais para componentes de estado estacionΓ‘rio. -- Agendador assΓ­ncrono multicanal para suporte assΓ­ncrono de primeira classe. -- E mais! Leia as [notas de lanΓ§amento completa](https://dioxuslabs.com/blog/introducing-dioxus/. - -### Multi Plataforma - -Dioxus Γ© um kit de ferramentas _portΓ‘til_, o que significa que a implementação do nΓΊcleo pode ser executada em qualquer lugar sem independente da plataforma. Ao contrΓ‘rio de muitos outros kits de ferramentas de frontend Rust, o Dioxus nΓ£o estΓ‘ intrinsecamente vinculado ao WebSys. Na verdade, todos os elementos e ouvintes de eventos podem ser trocados em tempo de compilação. Por padrΓ£o, o Dioxus vem com o recurso `html` habilitado, mas isso pode ser desabilitado dependendo do seu renderizador de destino. - -No momento, temos vΓ‘rios renderizadores de terceiros: - -- WebSys (para WASM): Γ“timo suporte -- Tao/Tokio (para aplicativos de desktop): Bom suporte -- Tao/Tokio (para aplicativos mΓ³veis): Suporte ruim -- SSR (para gerar marcação estΓ‘tica) -- TUI/Rink (para aplicativos baseados em terminal): Experimental - -## Estabilidade - -Dioxus ainda nΓ£o chegou a uma versΓ£o estΓ‘vel. - -Web: como a Web Γ© uma plataforma bastante madura, esperamos que haja muito pouca rotatividade de API para recursos baseados na Web. - -Desktop: APIs provavelmente estarΓ£o em fluxo Γ  medida que descobrimos padrΓ΅es melhores do que nossa contraparte, ElectronJS. - -SSR: NΓ£o esperamos que a API SSR mude drasticamente no futuro. diff --git a/docs/guide/src/pt-br/interactivity/custom_hooks.md b/docs/guide/src/pt-br/interactivity/custom_hooks.md deleted file mode 100644 index c2ac570c4..000000000 --- a/docs/guide/src/pt-br/interactivity/custom_hooks.md +++ /dev/null @@ -1,26 +0,0 @@ -# Hooks Personalizados - -_Hooks_ sΓ£o uma Γ³tima maneira de encapsular a lΓ³gica de negΓ³cio. Se nenhum dos _hooks_ existentes funcionar para o seu problema, vocΓͺ pode escrever o seu prΓ³prio. - -## Hooks de Composição - -Para evitar a repetição, vocΓͺ pode encapsular a lΓ³gica de negΓ³cios com base em _hooks_ existentes para criar um novo gancho. - -Por exemplo, se muitos componentes precisam acessar uma _struct_ `AppSettings`, vocΓͺ pode criar um gancho de "atalho": - -```rust, no_run -{{#include ../../../examples/hooks_composed.rs:wrap_context}} -``` - -## LΓ³gica de Hook Personalizada - -VocΓͺ pode usar [`cx.use_hook`](https://docs.rs/dioxus/latest/dioxus/prelude/struct.Scope.html#method.use_hook) para construir seus prΓ³prios _hooks_. Na verdade, Γ© nisso que todos os _hooks_ padrΓ£o sΓ£o construΓ­dos! - -`use_hook` aceita um ΓΊnico encerramento para inicializar o _hook_. Ele serΓ‘ executado apenas na primeira vez que o componente for renderizado. O valor de retorno desse encerramento serΓ‘ usado como o valor do _hook_ – o Dioxus o pegarΓ‘ e o armazenarΓ‘ enquanto o componente estiver vivo. Em cada renderização (nΓ£o apenas na primeira!), vocΓͺ receberΓ‘ uma referΓͺncia a esse valor. - -> Nota: VocΓͺ pode implementar [`Drop`](https://doc.rust-lang.org/std/ops/trait.Drop.html) para o valor do seu _hook_ – ele serΓ‘ descartado e o componente serΓ‘ desmontado (nΓ£o mais na interface do usuΓ‘rio) - -Dentro do encerramento de inicialização, vocΓͺ normalmente farΓ‘ chamadas para outros mΓ©todos `cx`. Por exemplo: - -- O _hook_ `use_state` rastreia o estado no valor do _hook_ e usa [`cx.schedule_update`](https://docs.rs/dioxus/latest/dioxus/prelude/struct.Scope.html#method.schedule_update) para o Dioxus renderizar novamente o componente sempre que ele for alterado. -- O _hook_ `use_context` chama [`cx.consume_context`](https://docs.rs/dioxus/latest/dioxus/prelude/struct.Scope.html#method.consume_context) (que seria custoso chamar em cada render) para obter algum contexto do escopo diff --git a/docs/guide/src/pt-br/interactivity/dynamic_rendering.md b/docs/guide/src/pt-br/interactivity/dynamic_rendering.md deleted file mode 100644 index 58c120926..000000000 --- a/docs/guide/src/pt-br/interactivity/dynamic_rendering.md +++ /dev/null @@ -1,71 +0,0 @@ -# Renderização DinΓ’mica - -Γ€s vezes vocΓͺ quer renderizar coisas diferentes dependendo do estado/_props_. Com o Dioxus, apenas descreva o que vocΓͺ quer ver usando o fluxo de controle do Rust – o _framework_ se encarregarΓ‘ de fazer as mudanΓ§as necessΓ‘rias em tempo real se o estado ou _props_ mudarem! - -## Renderização Condicional - -Para renderizar diferentes elementos com base em uma condição, vocΓͺ pode usar uma instrução `if-else`: - -```rust, no_run -{{#include ../../../examples/conditional_rendering.rs:if_else}} -``` - -> VocΓͺ tambΓ©m pode usar instruçáes `match`, ou qualquer função Rust para renderizar condicionalmente coisas diferentes. - -### Inspecionando _props_ `Element` - -Como `Element` Γ© uma `Option`, os componentes que aceitam `Element` como _prop_ podem realmente inspecionar seu conteΓΊdo e renderizar coisas diferentes com base nisso. Exemplo: - -```rust, no_run -{{#include ../../../examples/component_children_inspect.rs:Clickable}} -``` - -VocΓͺ nΓ£o pode modificar o `Element`, mas se precisar de uma versΓ£o modificada dele, vocΓͺ pode construir um novo baseado em seus atributos/filhos/etc. - -## Renderizando Nada - -Para renderizar nada, vocΓͺ pode retornar `None` de um componente. Isso Γ© ΓΊtil se vocΓͺ deseja ocultar algo condicionalmente: - -```rust, no_run -{{#include ../../../examples/conditional_rendering.rs:conditional_none}} -``` - -Isso funciona porque o tipo `Element` Γ© apenas um alias para `Option` - -> Novamente, vocΓͺ pode usar um mΓ©todo diferente para retornar condicionalmente `None`. Por exemplo, a função _booleana_ [`then()`](https://doc.rust-lang.org/std/primitive.bool.html#method.then) pode ser usada. - -## Listas de renderização - -Frequentemente, vocΓͺ desejarΓ‘ renderizar uma coleção de componentes. Por exemplo, vocΓͺ pode querer renderizar uma lista de todos os comentΓ‘rios em uma postagem. - -Para isso, o Dioxus aceita iteradores que produzem `Element`s. EntΓ£o precisamos: - -- Obter um iterador sobre todos os nossos itens (por exemplo, se vocΓͺ tiver um `Vec` de comentΓ‘rios, itere sobre ele com `iter()`) -- `.map` o iterador para converter cada item em um `Element` renderizado usando `cx.render(rsx!(...))` - - Adicione um atributo `key` exclusivo a cada item do iterador -- Incluir este iterador no RSX final - -Exemplo: suponha que vocΓͺ tenha uma lista de comentΓ‘rios que deseja renderizar. EntΓ£o, vocΓͺ pode renderizΓ‘-los assim: - -```rust, no_run -{{#include ../../../examples/rendering_lists.rs:render_list}} -``` - -### O Atributo `key` - -Toda vez que vocΓͺ renderiza novamente sua lista, o Dioxus precisa acompanhar qual item foi para onde, porque a ordem dos itens em uma lista pode mudar – itens podem ser adicionados, removidos ou trocados. Apesar disso, Dioxus precisa: - -- Acompanhar o estado do componente -- Descobrir com eficiΓͺncia quais atualizaçáes precisam ser feitas na interface do usuΓ‘rio - -Por exemplo, suponha que o `CommentComponent` tenha algum estado – ex. um campo onde o usuΓ‘rio digitou uma resposta. Se a ordem dos comentΓ‘rios mudar repentinamente, o Dioxus precisa associar corretamente esse estado ao mesmo comentΓ‘rio – caso contrΓ‘rio, o usuΓ‘rio acabarΓ‘ respondendo a um comentΓ‘rio diferente! - -Para ajudar o Dioxus a acompanhar os itens da lista, precisamos associar cada item a uma chave exclusiva. No exemplo acima, geramos dinamicamente a chave exclusiva. Em aplicaçáes reais, Γ© mais provΓ‘vel que a chave venha de, por exemplo, um ID de banco de dados. Realmente nΓ£o importa de onde vocΓͺ obtΓ©m a chave, desde que atenda aos requisitos - -- As chaves devem ser ΓΊnicas em uma lista -- O mesmo item deve sempre ser associado Γ  mesma chave -- As chaves devem ser relativamente pequenas (ou seja, converter toda a estrutura Comment em uma String seria uma chave muito ruim) para que possam ser comparadas com eficiΓͺncia - -VocΓͺ pode ficar tentado a usar o Γ­ndice de um item na lista como sua chave. Na verdade, Γ© isso que o Dioxus usarΓ‘ se vocΓͺ nΓ£o especificar uma chave. Isso sΓ³ Γ© aceitΓ‘vel se vocΓͺ puder garantir que a lista seja constante – ou seja, sem reordenação, adiçáes ou exclusΓ΅es. - -> Observe que se vocΓͺ passar a chave para um componente que vocΓͺ criou, ele nΓ£o receberΓ‘ a chave como _prop_. Γ‰ usado apenas como uma dica pelo prΓ³prio Dioxus. Se o seu componente precisar de um ID, vocΓͺ deve passΓ‘-lo como um _prop_ separado. diff --git a/docs/guide/src/pt-br/interactivity/event_handlers.md b/docs/guide/src/pt-br/interactivity/event_handlers.md deleted file mode 100644 index 8b3d757ef..000000000 --- a/docs/guide/src/pt-br/interactivity/event_handlers.md +++ /dev/null @@ -1,68 +0,0 @@ -# Manipuladores de eventos - -Eventos sΓ£o açáes interessantes que acontecem, geralmente relacionadas a algo que o usuΓ‘rio fez. Por exemplo, alguns eventos acontecem quando o usuΓ‘rio clica, rola, move o mouse ou digita um caractere. Para responder a essas açáes e tornar a interface do usuΓ‘rio interativa, precisamos lidar com esses eventos. - -Os eventos estΓ£o associados a elementos. Por exemplo, geralmente nΓ£o nos importamos com todos os cliques que acontecem em um aplicativo, apenas aqueles em um botΓ£o especΓ­fico. Para lidar com eventos que acontecem em um elemento, devemos anexar o manipulador de eventos desejado a ele. - -Os manipuladores de eventos sΓ£o semelhantes aos atributos regulares, mas seus nomes geralmente comeΓ§am com `on` - e aceitam encerramentos como valores. O encerramento serΓ‘ chamado sempre que o evento for acionado e serΓ‘ passado esse evento. - -Por exemplo, para manipular cliques em um elemento, podemos especificar um manipulador `onclick`: - -```rust, no_run -{{#include ../../../examples/event_click.rs:rsx}} -``` - -## O Objeto `Evento` - -Os manipuladores de eventos recebem um objeto [`UiEvent`](https://docs.rs/dioxus-core/latest/dioxus_core/struct.UiEvent.html) contendo informaçáes sobre o evento. Diferentes tipos de eventos contΓͺm diferentes tipos de dados. Por exemplo, eventos relacionados ao mouse contΓͺm [`MouseData`](https://docs.rs/dioxus/latest/dioxus/events/struct.MouseData.html), que informa coisas como onde o mouse foi clicado e quais botΓ΅es do mouse foram usados. - -No exemplo acima, esses dados de evento foram registrados no terminal: - -``` -Clicked! Event: UiEvent { data: MouseData { coordinates: Coordinates { screen: (468.0, 109.0), client: (73.0, 25.0), element: (63.0, 15.0), page: (73.0, 25.0) }, modifiers: (empty), held_buttons: EnumSet(), trigger_button: Some(Primary) } } -Clicked! Event: UiEvent { data: MouseData { coordinates: Coordinates { screen: (468.0, 109.0), client: (73.0, 25.0), element: (63.0, 15.0), page: (73.0, 25.0) }, modifiers: (empty), held_buttons: EnumSet(), trigger_button: Some(Primary) } } -``` - -Para saber o que os diferentes tipos de eventos fornecem, leia os [documentos do mΓ³dulo de eventos](https://docs.rs/dioxus/latest/dioxus/events/index.html). - -### Parando a propagação - -Quando vocΓͺ tem, por exemplo um `button` dentro de um `div`, qualquer clique no `button` tambΓ©m Γ© um clique no `div`. Por esta razΓ£o, Dioxus propaga o evento click: primeiro, ele Γ© acionado no elemento alvo, depois nos elementos pai. Se vocΓͺ quiser evitar esse comportamento, vocΓͺ pode chamar `cancel_bubble()` no evento: - -```rust, no_run -{{#include ../../../examples/event_click.rs:rsx}} -``` - -## Prevenir o PadrΓ£o - -Alguns eventos tΓͺm um comportamento padrΓ£o. Para eventos de teclado, isso pode ser inserir o caractere digitado. Para eventos de mouse, isso pode estar selecionando algum texto. - -Em alguns casos, vocΓͺ pode querer evitar esse comportamento padrΓ£o. Para isso, vocΓͺ pode adicionar o atributo `prevent_default` com o nome do manipulador cujo comportamento padrΓ£o vocΓͺ deseja interromper. Este atributo Γ© especial: vocΓͺ pode anexΓ‘-lo vΓ‘rias vezes para vΓ‘rios atributos: - -```rust, no_run -{{#include ../../../examples/event_prevent_default.rs:prevent_default}} -``` - -Quaisquer manipuladores de eventos ainda serΓ£o chamados. - -> Normalmente, em React ou JavaScript, vocΓͺ chamaria "preventDefault" no evento no retorno de chamada. Dioxus atualmente _nΓ£o_ suporta este comportamento. Observação: isso significa que vocΓͺ nΓ£o pode impedir condicionalmente o comportamento padrΓ£o. - -## Manipulador de Props - -Γ€s vezes, vocΓͺ pode querer criar um componente que aceite um manipulador de eventos. Um exemplo simples seria um componente `FancyButton`, que aceita um manipulador `on_click`: - -```rust, no_run -{{#include ../../../examples/event_handler_prop.rs:component_with_handler}} -``` - -EntΓ£o, vocΓͺ pode usΓ‘-lo como qualquer outro manipulador: - -```rust, no_run -{{#include ../../../examples/event_handler_prop.rs:usage}} -``` - -> Nota: assim como qualquer outro atributo, vocΓͺ pode nomear os manipuladores como quiser! Embora eles devam comeΓ§ar com `on`, para que o prop seja automaticamente transformado em um `EventHandler` no local da chamada. -> -> VocΓͺ tambΓ©m pode colocar dados personalizados no evento, em vez de, por exemplo, `MouseData` - -> Nota sobre formulΓ‘rios: se um manipulador de evento estΓ‘ anexado ao evento `onsubmit` em um formulΓ‘rio, o comportamento padrΓ£o Γ© de **nΓ£o submetΓͺ-lo**. Portanto, especificar `prevent_default: "onsubmit"` irΓ‘ submetΓͺ-lo. \ No newline at end of file diff --git a/docs/guide/src/pt-br/interactivity/hooks.md b/docs/guide/src/pt-br/interactivity/hooks.md deleted file mode 100644 index c5dd85d41..000000000 --- a/docs/guide/src/pt-br/interactivity/hooks.md +++ /dev/null @@ -1,87 +0,0 @@ -# Hooks e Estado do Componente - -AtΓ© agora nossos componentes, sendo funçáes Rust, nΓ£o tinham estado – eles estavam sempre renderizando a mesma coisa. No entanto, em um componente de interface do usuΓ‘rio, geralmente Γ© ΓΊtil ter uma funcionalidade com estado para criar interaçáes do usuΓ‘rio. Por exemplo, vocΓͺ pode querer rastrear se o usuΓ‘rio abriu uma lista suspensa e renderizar coisas diferentes de acordo. - -Para lΓ³gica com estado, vocΓͺ pode usar _hooks_. _Hooks_ sΓ£o funçáes Rust que fazem referΓͺncia a `ScopeState` (em um componente, vocΓͺ pode passar `&cx`), e fornecem funcionalidade e estado. - -## Hook `use_state` - -[`use_state`](https://docs.rs/dioxus/latest/dioxus/hooks/fn.use_state.html) Γ© um dos _hooks_ mais simples. - -- VocΓͺ fornece um fechamento que determina o valor inicial -- `use_state` fornece o valor atual e uma maneira de atualizΓ‘-lo, definindo-o para outra coisa -- Quando o valor Γ© atualizado, `use_state` faz o componente renderizar novamente e fornece o novo valor - -Por exemplo, vocΓͺ pode ter visto o exemplo do contador, no qual o estado (um nΓΊmero) Γ© rastreado usando o _hook_ `use_state`: - -```rust, no_run -{{#include ../../../examples/hooks_counter.rs:component}} -``` - -![Screenshot: counter app](./images/counter.png) - -Toda vez que o estado do componente muda, ele Γ© renderizado novamente e a função do componente Γ© chamada, para que vocΓͺ possa descrever como deseja que a nova interface do usuΓ‘rio se pareΓ§a. VocΓͺ nΓ£o precisa se preocupar em "mudar" nada - apenas descreva o que vocΓͺ quer em termos de estado, e Dioxus cuidarΓ‘ do resto! - -> `use_state` retorna seu valor envolto em uma _smart pointer_ do tipo [`UseState`](https://docs.rs/dioxus/latest/dioxus/hooks/struct.UseState.html). Γ‰ por isso que vocΓͺ pode ler o valor e atualizΓ‘-lo, mesmo dentro de um manipulador. - -VocΓͺ pode usar vΓ‘rios _hooks_ no mesmo componente se quiser: - -```rust, no_run -{{#include ../../../examples/hooks_counter_two_state.rs:component}} -``` - -![Screenshot: app with two counters](./images/counter_two_state.png) - -## Regras dos Hooks - -O exemplo acima pode parecer um pouco mΓ‘gico, jΓ‘ que as funçáes Rust normalmente nΓ£o estΓ£o associadas ao estado. O Dioxus permite que os _hooks_ mantenham o estado entre as renderizaçáes atravΓ©s de uma referΓͺncia a `ScopeState`, e Γ© por isso que vocΓͺ deve passar `&cx` para eles. - -Mas como Dioxus pode diferenciar entre vΓ‘rios _hooks_ no mesmo componente? Como vocΓͺ viu no segundo exemplo, ambas as funçáes `use_state` foram chamadas com os mesmos parΓ’metros, entΓ£o como elas podem retornar coisas diferentes quando os contadores sΓ£o diferentes? - -```rust, no_run -{{#include ../../../examples/hooks_counter_two_state.rs:use_state_calls}} -``` - -Isso sΓ³ Γ© possΓ­vel porque os dois _hooks_ sΓ£o sempre chamados na mesma ordem, entΓ£o Dioxus sabe qual Γ© qual. Portanto, a ordem em que vocΓͺ chama os _hooks_ Γ© importante, e Γ© por isso que vocΓͺ deve seguir certas regras ao usar os _hooks_: - -1. _Hooks_ sΓ³ podem ser usados em componentes ou outros _hooks_ (falaremos disso mais tarde) -2. Em cada chamada para a função componente - 1. Os mesmos _hooks_ devem ser chamados - 2. Na mesma ordem -3. Os nomes dos _hooks_ devem comeΓ§ar com `use_` para que vocΓͺ nΓ£o os confunda acidentalmente com funçáes normais - -Essas regras significam que hΓ‘ certas coisas que vocΓͺ nΓ£o pode fazer com _hooks_: - -### Sem Hooks em Condicionais - -```rust, no_run -{{#include ../../../examples/hooks_bad.rs:conditional}} -``` - -### Sem Hooks em Closures - -```rust, no_run -{{#include ../../../examples/hooks_bad.rs:closure}} -``` - -### Sem Hooks em Loops - -```rust, no_run -{{#include ../../../examples/hooks_bad.rs:loop}} -``` - -## Gancho `use_ref` - -`use_state` Γ© Γ³timo para rastrear valores simples. No entanto, vocΓͺ pode notar na [`UseState` API](https://docs.rs/dioxus/latest/dioxus/hooks/struct.UseState.html) que a ΓΊnica maneira de modificar seu valor Γ© substituΓ­-lo por algo else (por exemplo, chamando `set`, ou atravΓ©s de um dos operadores `+=`, `-=`). Isso funciona bem quando Γ© barato construir um valor (como qualquer primitivo). Mas e se vocΓͺ quiser manter dados mais complexos no estado dos componentes? - -Por exemplo, suponha que queremos manter um `Vec` de valores. Se o armazenamos com `use_state`, a ΓΊnica maneira de adicionar um novo valor Γ  lista seria criar um novo `Vec` com o valor adicional e colocΓ‘-lo no estado. Isto Γ© custoso! Queremos modificar o `Vec` existente. - -Felizmente, existe outro _hook_ para isso, `use_ref`! Γ‰ semelhante ao `use_state`, mas permite obter uma referΓͺncia mutΓ‘vel aos dados contidos. - -Aqui estΓ‘ um exemplo simples que mantΓ©m uma lista de eventos em um `use_ref`. Podemos adquirir acesso de escrita ao estado com `.write()`, e entΓ£o apenas `.push` um novo valor para o estado: - -```rust, no_run -{{#include ../../../examples/hooks_use_ref.rs:component}} -``` - -> Os valores de retorno de `use_state` e `use_ref`, (`UseState` e `UseRef`, respectivamente) sΓ£o de alguma forma semelhantes a [`Cell`](https://doc.rust-lang.org/std/ cell/) e [`RefCell`](https://doc.rust-lang.org/std/cell/struct.RefCell.html) – eles fornecem mutabilidade interior. No entanto, esses _wrappers_ do Dioxus tambΓ©m garantem que o componente seja renderizado novamente sempre que vocΓͺ alterar o estado. diff --git a/docs/guide/src/pt-br/interactivity/images/counter.png b/docs/guide/src/pt-br/interactivity/images/counter.png deleted file mode 100644 index dd89cadef3ab7794d1f77b08350b8a2cad434b72..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 11368 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 O00kLk=_*O1;Qs=kxyf1p diff --git a/docs/guide/src/pt-br/interactivity/images/counter_two_state.png b/docs/guide/src/pt-br/interactivity/images/counter_two_state.png deleted file mode 100644 index 4f77942a20ab23ea01784871c7bc977a2baec4a5..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 14503 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

Xr+Mb0o6&U|y=x|mJQEkCNwLvd|7x7mswPA5 zf=7=(Jp+M+8vg~|<~4537g8A&2QoCZ8Mw9>M!Tm$8AdY@N}7~3AqEk<+RJZnmSf$n zFL-RNwycYx#x}a@Fu>e9w^Jrbk<>er7g#OhP>}Um_qBgdYFV6P!X`pbYUv6#s+%#`~9NL@g^xR+BALL0Y72g1^9( zew<15I~K+bcH%$p_CMwozbgcqwI2M$S9nr1$*`rrS#h#GNRU+Ec5+T*%(Z7xZs_8! zn*OHN&qSl8%_&}{t7&S;DWkw>L7tIGthFEQZ(WX3L4@6u&TrZcoi)%6FOjqjB~ zO<4b)-ZnsEvprXqIEOI{@W`qfLbY}`-8AG11SM2>fBEI}+5B?3U>F!;BbI(DhElUv zOxV#mj>x$X#&GC3h0de1O4Un>a%Cd0fHLgd<`@6vjoVRg)z1)=YSF%(tc20=`i|HT z3h#3ge-1HxM$UE)T5Z4SznwVx1zm0mp}>ZyJsxpo6A_b(dnUX78HA;}7YwD7`}9f)m-u8!rM57Hr7DZGh#cs4a6OE!jwh}bB}}>Aoi(J^ zQyW-3*V=bHJ#8H=7uj)IEZ-Q{h~?%!YYG}Wq#*#h+sMoXNm2&i`to0lWCALAzynIYC-=2uIi zJ-Hwbm)eExsEY*vGZbjBX7)PMR(%S{2qdRMFs}z!b?Gdu#ib+idT>t`>BJ}8mFXm( zy%TiRY?$Di;D#2i^l>J<+7Eb(6=pzkgvy z3bf)yF+{1cPBEjAVHcy{7{ck54=Jvoi~nPhcS1h2IfL;7#f!I(OT49Mc&l{%twhvM zc~ZDXS-TQX!j8?@rfXPUagx-7#|uh&mM5oMQ}9cPSgW+YW5*5B4asDPV{%3gM=~sGWmYRI?!iTpD?q)DfIsq9Tls z<&uP}oTB`-5TxNNHWsB?&8);GR#ZF8!HebE%W5#QjAZX2d1WmpRY5+OV{WB$^D|Z8 zX==3Y@G{_0Y5OtMUThg4Gh`PBjPNppip-jZD`aE%N|>qH+}NcGja^ZV{Vs|Vjn8lz zKu3L>ys<^`@SH$+GO@lcmKy?K_rk5$TqO zj-j}rvO=!23}INIOj?Lf4PMW8&C7aMG(a*8h^nxUY|s$#W34>|jcw6w4)l@lfHkkp zkm0o|!O+g?C--MfT3Y{s0qRQ8a>1Ab97@pIm$(q@@S9=zg?X7_>8Etmg5BB}&RD-Z zldf)T40d31sQJ(OKS#^(#lvMkyIRo`xM-L#R#I^&+aIl1uh@9r*pwp z^(7DSnfnm|saEaVw4?kXtudMKd)3vTQX5EvLgJN?z9>9y`7;Z}MU)0xnkzR`H|COQ z5;>*SZ6wEaym~28!r-vVzVJXv3N#zgV^OGU_l4BaNCE<85%0hVdhww$Yz$$d+0C8wQkoYH_AM`QexZf9#I~}vq@4PJY~eug*#uP+n`)$E>OfAHlom}q=9^2( zA^jiA^5(2oLs1N^-JJgRG<^{_B9Bc^C`Vb*Bh*aW@)lONYBq=G$iBW>m{0q#)DFPeM3+}9{xWcVbm8PHKpD6A>5&EXBcyx`Z?UtC?vn!Cd5Fi`&2=xo*^kU=VD8G6NWOIVD+ z;BG+dK+`}GN%ng(PznjEl#6xirNZ^@5GM{0Y&`f+cRm+0tbkTlhsn?- zN;p}6;fZlwp+f86iaqk}_xZ3DO2|K;3$6`U5tpWB>fh+$vu=6>v}}cgUx`=dZXzAE zW_$FmYE^3_-*6GfMaz#DPg4+OR81z63NNMpWepL_Cvtj@<3XSy0C`m{jbz0A9KxqH zKV3RWo$N(7rf3U4F)}vZ`H@ud-?*9VtBjBsL(j&>kAq^;7D;w|1W&*lw8*V^lss7M zs!&EHC*Vy|Us-fXKIC8WHIjTzUaFv_2#E7!6gF{wPj`Qsl7iK9e)AquT49qN)=zC= zeU2$(tv!~~(>i=m4W*5xkxZ8yX-ywSmLoR*5;b0&k`q!(1)E<+Lbn)6)i$XceeDxz zI%C=ph;tg#pGwtq%9#xiGl^CJDz!Hy&rl)dv*c02`dai+*DEF-0d9Uk|7;QRA&-TvpI4x=aFKHl4;4x)uYPuIN>@WM$wJ zj>&bAk`lnnkwB+KPFH(z_=Vm7PPCdE$T_FsJmh4#b$~G2M5xrc(UH{x1kE~wk7<-6 zA*85 zOCdx}LLb}crvGpmLR7=LKFO+#7);=8|DK3SQOgYhbeVzf5ETj|Fs22|>vvtsc&5r% zdqz#Jl4`j?HZyVw7JPwyTExtjwZgGE-Kzl?FkhyIg4O+ZV&VT=^wLnu(Chbcl{2L% zWH+NnLyb*}QgLJIsfz5EcYyhN`JmGcoBzwAlnb#wex%SeDN{UX&dYnL|A*{@8iJP6 zdM`S;Y5nYUh5j`eee!L=L-_p`WI^a2m(GpUI!imqBWbX92GZl_t!*#JC zv)n{wA7oEyq*S8!zP9N|tF^x`z?1%LEnq;-q-1OU^phj>IUy@pJ&IHG-GW|BD~D2! z65^MXvvSf?r=HK3xYm8B@inH_#j@zPQxmObl}efD{}WPcQs#Pbb=4@GA0K>ZvS_yf zTNL`0Yc&RKYi8YUrstjMtCYk_=dE~ctc^o8}nOCtSqOhJC24|Z%y zS3XtXFEg%*Jt+BwI2nyHX-d3Pi$A51*7{ZHsMLP=rTPGp`Jh(vRWi=&F6 z*{{@t$C`4xzda{7g$k=`%way3Hdn^0r%K@;+e4!8-#ItR8oDLu{T$cj=O6egfaK13 z_CZs6Oe)yeS(S*C&{h3*xg+ImI2?Hd)6V1V*VPSu6%Fij0svE-K1di$0$5L*D5_(Fx1<*kbz|~9@~+OR;o@uL_{Ti(mygW$0cR3TOM0j zPwLvAw*3doE6|(7d^@n7P|gg#g0xh(^l+jySqu=qZE+}-A;pP-fpJ)kIT?z)g)Dw7 z{N$9d*34v>4*@V7x5kdXrg^sqH;7FWVqK9*;uR`ek^9Oeu7aBaaAvYEwOJS=3 z6uI&Te6w)tc?ll8aIj3V-j!yiTD4fcWV2J&LKmPwBI=g0->TREa>-`M?2G1WGL~}H zCC*IM@TB1migav<$igHUy2ZFnNgHR_$a9=YL`5w#O0dpjlYQ<3>o52~Akg}_e8VUT z3MBuZK7Pt&BAJDH*u8UZ*&^Psh$$T^`lL+m)(Q%S#hl>^SD)>2lJOqkyDDA5ox&ha zq5pN4osr^3jIBG!D$$y)P1Bsd6$6HBj~BfRuF5gf5Ul z?&zM2pQPl+nUATOHISADTUa78#4&w{bnlpcaI`O~Wx16-fKK}~%Rm2PI-{TJd8k|I zMEN{B%c5Ia{dxh6VsT148LJ>5`I{n{m0y)tHTR$4=xq^NV~bl1z|YbU>#v(MUv6^Y zNLG^Y&=hUrv`8o_$V&|4D`;dSOeKJ!p-$>iVyRG5f+~C|tupI(GoECk=4m-SUR>0B zsE#?VB%Ln2xT$&Vm+J2f2^n-l>ti=f*8=c?m8>b}>Mt{MZkJDU3RTY$TntQ4<*n>8 zOga4+)*gRsT4D6)UH5j5V%CNlbs{9=20nW)bG_;JD@OClq`q9 zQYJ8>*)8J%LUOaJ|piwg6u141x!%(52#%%SAZ-k7@ygr#7mcXuz5I*he zIKHS1ynN$PT8Ap|VpkEIXLFq^vMdZ167}eHa0=C5c&Y3-lYPHx2j>WbtGicTYCuVb z;tu2c%+=bhp179|d*VV5iq^0}x2EZdr6CCk**`YM#o1=rqnwk+*!NMZPqibN| zd_Ol@?G-A$Us%u7H4RtvVeuj$RJeRtbg%lzqKAQjpmGb-cW6^g2Rr}dZ#|LM3{kzp zD0CDJofX{*#uH zZCqms0;MO^HTp@zWy-s@!34mdctp!Sa5WTPtqxaY@nS^L2wE~~EL!M_cM zRJ2@kN}E90mrbvMg$1(lQFkVuuIuiu=SrU8F3ZU+kFDwHKbsR*(qQy1fV_jip+=PH ze;!1$y*Gr(w>tc$(J`f!I)ZKSmo)ZP{)^OFIO%xGY5PjEDmdaw8&1?^InG&|g!2Rw zqwRa#fs{BzO^hXs9Ha``XbbR}(v#S98D2C{-s`0!u+bdEK<5S3NDB#qY^s_TKMCkXay53+0b|LWmk_CkBkE_yN8EB3TlQn zS_&ogYE~zv6HOGt$-fNcqZ3`@(SXwd5fuNirR{uE)NEMS?|7i7^C1&^yL(JyedpVt z%q|VCc8iH2V~ueqG$fp!=7c#A?*sRfUuFFuW-MwfW{g_(r3H&Fx>4#vBuxM_I%i!k zZ<0bRp=dY3=YU*Hs3FGfruVq&THr{sEEY)wVpS~=zL5eCC0wQF@c z83DvuRgfXZpA=3&>y9=c4jj6T1{PWy<>{hUW9O-)BKc^#tCuPcC7GFxSLUrJWAsix zdbW8?La0KPCHpEm>8+id%fv2Wc6QisiG}Pizj9V2i7_tRSW82|(XbN6g1RQwvjPFF z$w+^RLzZvJf^1hB`S+QNQ)q%9aOP#R$aFG=7h$nvvx`Y?7Hm z8D&3J^HgOPbKCQDILGC~3(ITVTbVBM?%Hew@@Cv?rK2@oBrgCALP$?LBPP2Df}a8sHry@EPG~dV9?lGcgzg-k`@`?i;g&QHzJ2(=~dTE zwCtfLyNMv);$L!e8BC`z+PkFr-x1D+@~PEJUDcN){@kdwnBYCe7gIMwg2kjbMgqCP z`j);dBPpD(ajTk_FBwhjZ42*#iwdtVax8qP{lg+GS1ot%&FY<&a{6f{ zf`2z~a;8+B-e*Pys#xp4?cOwY8{d`EQd3R9}1!G9G;i)-=XB_*|yElzfp+hMpJ`D7(9 zomNm(%wcr1<~1-gQ80Ur{m`$@7w2-@{Fs@4Y;opzeDLLT_~q3CS3d`kRyp^B?q`n) zAjuqQ;kTlvxw~N&|G>))<^3ogqkeHTAyPC&Am4d)Q~TY-Wcz0zT-(JX?rnDObGGl( zXh6;%12>rb=L-@Hv7KNNPnO zowVLJ`EBQEeb19!X}mZ@{{v}=v!IG)>h>}!ttnKa`e|=d|p!il4pSl~F zq)8QrtZOc`(l!5?+z^3R+DPhs203PEEK(spW{VuV zq0>JK{K^hfi;{0Zx{1~JL~u7zJAkWIsg$LoMf2h}BOVr2Pen-|v0!9kCLMK1TT)fo zSGGy^s0_LCZ0{HJ3#de_oz9AD4UEO&g;8ivUA$Lj3F*iNtouo|6c=LOZ?c)}5lMGF zUYreqwH4N8m2fZ3Nzga_v=hnQf^AWZ`K3t8H^@+Io5Wl}F7^s@4pa^fpNd2euQEQN$V^I;H3vIdh$_R66Z8eCig zOCJj)G)$mR<$;}AA;>L;E2HEtSq27#GGYC5Ep(cjUmq$aPsRCJHFY1+W;xek9w+z- zV1$^*+MIAhw#A4I%Q|NiulpaB z4*a|wFHML`F{}~7i27wdR~9A^;n0{Go4Y3NCg^cw3a!mQ1EB=Ln=XvRdP&Vy-!;#z z9pV<V?X#zoai-Ift0UMRI3)FVc8Stv z7}y57X>5Rq@qD11!Aj!rdR#H9d5Wvy3Y#LWKnbPdNeSZ}yR3+;Y5Zt#*bKB7y2l=+ z?5(H-o`voROypbQPqVVX;!0|n_{sJ1pvSl)zj~X_xQ@z|OWH$Tj5#VD*?i?Vm)MK5 zq9$pU;I!{w)n1c+o3E6tEa#M#s2d*)DKeEd=wkS^+!+Lgd-h5kR%{mS{iEq5-(#+F z%&IL)s`;$tX*jNq6f$66_&Hsykp#Oyy46XW?S^*0&0VhS^;i_ESbxx;WXU%ZDfm3M zN6sy~+HAofo8@Hfl!*I}H^N%yl&J^Z z!!Wl`NtzLF-KXJlx|7BB6&pCwx!i>ox`;J0B(bS8#xa|DesN2Y6>!B)sR@*;oD>oVU~+}LWe7LQ;Imxp%c1IZ^TYcg~UDUi4)f3=Iy^;GxY4lA+7snJ#a?a8pERSix?4oaQd{VvoB~_9oz^%EbKP)YTD^NTM zu$DU%?tT5`@@3b1If<2$$$6nX!*&BFo<&m{_bvo9^RbzwNUUW&Y><<-rcW8*=<@Ot^a7{jW7OH;K_zu)hT$s7qZ4D3t$i zlfbfrH;Eax;`NCXG%lEIsBY^MFCd;ZHYbb=rE-(U?3pM;Gv{70rGFd8t!S;kcFSV7 zK2+*;Tb*4Ur)!uRXympyfzF-LQ9bL$*Xz_G##J$7Pf?ntsDaAQVh>%D{sSh>nb(vz zt85HTC);c>$d^@`E0YxvD`A*J0&gEM?pRmOWjGd4fO~6Zue#MA6HROC^eWcOcPK=N~F z()^~S@Uu^T3FFa!&>$|?#|)32ceu6tzyAKOn4iJ#a5#7~j=SR`Z{MKX-fQEVIvT~Y zC?Qclof0=D?7Y?3i1*Ov^90XW6UK3`Qr3Zak-Y-Gsbe6StaoRCz_dDzET>$IxO5Uv>I8gLYIkQaY&e&_!Ly~8l+nS$#*g1MJ}eYaGGJfRgXlR< z)Q!-#O2kEM6OlqqHJ^7vM4sIE4q{>+wpeOj398Sysn)7(?nnwW)tp>OigEQ&U=)Z&X6(YL7k_;=6~f>aH8 zQ-4DAs(pSLUT`F)`t0#n&>gHjm~2ufZ6~NUr*XzE=m!bD`7w2C+lSliw*_(bTi&r= z@+&(?Kqr)$5}0DjTMFrt`@wFD^Nrc4H{`KQV3mqT2GE$Z^bBya^SiWEITUz2nu$6XMf>=${e zyc_>Ynd!0ICw;+?7YjqlW0c23g|!p0A@G7k!YEbyQL^Xd;-r*#WYacm&7#Y72wIkW zTqxTfyewvG4cr}$0$HtbbV_WMOi^C2gG>j(-(B>TOwMft)|{3RlWl|8jO@bE(_Mk; zI7d7UZs*)b$H$VSn2a+7jWg=7;%tC%a&*eEA!2e6npF1pCa&7e4kAp#U}p&q-IB~0 zvZI}Qax;JbzCU2$8DrmP%T`B_*y8}bao6p6j^C99c_bATLY#NkP{Co}7Fci~Zjr@w zbOtNgl2cLIwnT?82QzqBu*`v8Z$*i!5I|QM-OQU`I;f>>4$EcOETFuATcNQGfn>KP z^ZXkYcU3SQ;$XZk16n$rGgghF6U-2*?Vx?_k{znX{ADCH$^ViPU#?l5xYYHPpT*0h zLzt!WsKT;H!I`P<+^IJ9`Rq%-M2kvmZ8+4+3sRtsz4Tx9B!@Bf(+;I6y#VP&{)-Og zBY!Sr)xz9TO7|L(0+wd}l{q&zR~d9;hD2t93398&O`R8$yC6=zp)#AO>*ZIO$hS4X z*nLc6iX|scg&F-^H2GY_I|bXZL+pbv9`dq;q}~mi6?5 zR&~zLChkf$M5Z~9J`9`aPZPGo#6^zNFCQ3As61DVK>+lZ(p)yKWyn%Q zHh|BJ7H%QZagk9DR8V;UfRzq1aZo{*!y}saaZj}Xu`w%FRwUYFOIkKqa;9Q?%#6bM zlVqr6wdQiaJhrL|v({urREdV6#T9?+8iZ~qv4F!|^pDJy3%EDXI<#j<7ONTW(^;P} z=^liRk8bqD9VSqB5@)U$X|->_ft4h)QA9uW({Z^*B~$1;gR_v$GQSf-8@s2e6i;T% zuOt)~b))tcJN}o&0h#MO_1c1VW*7tJ zJ9F?Ex5KTu<|P+rgh`kfoHE0|hf|aQZEH#^i#L`Z(LP%Ofj~X~_L29lsE_O622Bk% zVCXdKWqDpHoav9Vctn3>z# z6dyzqqr0R7YF<&Y`O!T8J&ZiqL~TzcJ#~DzRQpl)O(^~OIO3%GSlVli z=`rmLSHOFHu7XzNt#e&XFZ4USXj> z^2(r(8z7mMaj`NRJ%kW$3pLH^>X>~e?|{CL_I5AWLlp-JOw)1a8XPht%1p!L5}W3x z?`v1ZmAbk_i>*!>x><_HQ^>GTL)@w6V5+W&Dl>FgxweaF1SfPe2-p(Vo*1~ z7qsHUPqYmE`y)%KT8XtecThV0zsjuou0~33PN#$LNT{u|j$FCD>{hBoFC=uK;boTE zZ)E?N#}CF!om6=-%Z~67Ufwx=(u>D|WI>P6JWhw2j>j$@t%CJ`N^A#_g$oO5qwbtlEyJQ`#@ard;g^su_+KxIK6==W z^mbZf;{=+TSM$1k+V>_%4nV#RQ(N&o_&WdlEMGP3ck;GSK6hvJq_RD3#){%+4%#@7 zn5`~1$4Nkkx;0$okdM{109Xl}1+Cpoam>yfctY+Q_ns3#CeK~kg^ZGN%>ll)=ezE5 zv2w1?gh_W+v87i~#X7{EDn_WTuAVy3fxMA!-$<>p`BB z^s*?jVUtwlK1deneRO=Gpsi!&WGeOjWJ_bH%iIqZm}c_;(MR1)m}=QHWUlpgSuU9B zj!28J@5Q{PJ$r!p1;dg(%o(dW1v^}uLD@`}2~O`DVO{T2A$8^YI zC2p6}q|*ly0~|{M%ssY4uQ+v&LLjU~aoEC4h6Yoo&B+o<&9}gA8tU zxiLw2;k7Ur`6B+R6Hj0-%d*75^ zW;bopxaxFHRORdNXLKV4ExB{f`1X>ZXL)PxHLdy3=+tK&`3}CuHy!Cj?YcP0k zZEtaL$@BA}|JW&w3a@%%t2so`Mtx3+Hk!Et-x({TiLtX|zW_7(QB<^AlKeoH_9 zZ|C`5#PDc7S6uk1BPF@1Z_&s0<0K6Mt@_)D^Y9YI_8*4BW-lns$^5rd_5lB%mk|Q- zt~~^AK18=}p!4Ufn1CDbF>Q}`#OFh~!QpfC(eopZkN-JX%WKZ@CX=TlZPXP+xT_cN zfu8TRdr~Lz@+dg<&c3$eJNW$rB|Yv@5bJQ&bE$M#Nkk}AsLJ>4yL4mw&fp5lb3-s! zfbT0}{xzevF~@d?jo5?$h=0eb&dK+JfhqY^6)OJv z{8y)%JN2*M!R^WFN=lgS_8j#9R>_H4#lX>jvVI3U>RkDL{sRRw5QheF|2-n{e;?P_ zS9Yl23MjPA)+wuh(4@akex>*8K-M#SVR(oc?+GaBx<4cPyulx>^KZ8Z+ARbgKd;?G z@qiiztWf)JF20KRISt@I`Jh5N0(%<Sr5%xz9+Sg=LcfPyh2P%Hipz zI#kea(m3k6|JL^YS$l`84D)+Gvs2CgJuAm0Iqh|GT~#~Z;n`i!`GfoEh$GC!y||g{ zVm&cIc-cfrcI{BW!NZ1LbZXDv;0jR#vM;s7$1j&dFDe%2NLz zHuF+*c-vb8CI{tq|H>`|Lb6#n$ z4n{{kh(8m)e1Scal@Qf%K^q5>2>#@Kr-ADNS`7#IscpZ`xiEpR1$=FfBaS<-$F2kZ zt_X3w-b0`cAM5=^Bpb-_?>)~mK%y@kjNHEO-|OTxy!=<*lL#mAdY?dZ$VmQsytCq} z+tx5-vjRtn#%% z_!k!DeGam`gZw>je{YW;FD<<;W0mW=xvO0TyO13>9U7D!Ttm{mdq%+>y1Ca<*WL3C z@y9)Ugao}GuP&dyb;kv?;ro!azAEvCF$jm`T$(F-6An;HVRK;ev1ZWy8MfK z1$+BHO{FmTFyhYLox%wywRas1gofQAPbQ-^SATK$8K3QhfErE| zIgqcp3;T~}fx|SW|JzlGbz1LeY4W}>DE*~lUl4@eM_hn;ZhhUo`@a==A=H6xItX|D z`PQF%82`7bUCkUE0r$7U{Y;g5Gb~T{*%5{v8jnAWMoIVLbsSUI**8N&w|z(m>Ba`E zs|RiOvV0>yffN5)51TxA1kVD88a#`G;j9Vm=#j(HnFZYC%^l&)9vLV;R>gIsBe_2)E7obEO~(wAyq_ahx&B1Fc0rh;4P4^DZ%*JnE7g2lnmWulwh@ z?Khr)#-zFV2l;-3ky_Y2{$C~!|G(R9p77TTX`gr1y5q#F^rfQwYx!qFe7ltN0U$M# zyX!abX7g0pw%|b+3E*})umI0v(?xocNSWlQ>QLaycj$g*Mc~R`?!*5R6UC=ishq^& z3QFJ9pn1D6SnUy?fWiu{+;uK!y8lXGJU_l>CEz5it>BP`o1q|T>d@m&pBP;vhtja zPsL}ROUrDpTm0se|4=1jN{b)`)QN4cl^ShY~q^jpttV-6* z`7pEp;f>>^_hp_{$-n(7UAOJAmj=i`m;;Xi*|-<7;#*B+)y%k$s2mg$P7wq=0Z zMl&rpdv(85@d7ngyZjb~fE%k&`rMjX8tJpdw2fu!Rs&mrUa1pi3+wBCYxCBByvTS{ zq^uvXZS~Wx_~f}aN4&fLUakFJ`1h%SPRVyrbI~h#oyngYp+`HXi|u~$sQbq67kh!X zA#%r5=ABcxuCQ36t7wt&3EuE|(?6fLo3Z)##C+M%wi=r=>zw!NRK6~~Ui9ICqMpXP zr>o3!pRJjj{_$+}`_$87z{V@M4g1sO@6S8M=buh=mwUL$JKlcv1cTjbATK< { - Route { to: "/home", Home {} } - Route { to: "/blog", Blog {} } - } -} -``` - -Sempre que visitamos este aplicativo, obteremos o componente Home ou o componente Blog renderizado, dependendo de qual rota entrarmos. Se nenhuma dessas rotas corresponder Γ  localização atual, nada serΓ‘ renderizado. - -Podemos corrigir isso de duas maneiras: - -- Uma pΓ‘gina 404 de _fallback_ - -```rust, no_run -rsx!{ - Router:: { - Route { to: "/home", Home {} } - Route { to: "/blog", Blog {} } - Route { to: "", NotFound {} } - } -} -``` - -- Redirecionar 404 para _Home_ - -```rust, no_run -rsx!{ - Router:: { - Route { to: "/home", Home {} } - Route { to: "/blog", Blog {} } - Redirect { from: "", to: "/home" } - } -} -``` - -## Links - -Para que nosso aplicativo navegue nessas rotas, podemos fornecer elementos clicΓ‘veis chamados Links. Eles simplesmente envolvem elementos `` que, quando clicados, navegam no aplicativo para o local determinado. - -```rust, no_run -rsx!{ - Link { - to: "/home", - "Go home!" - } -} -``` - -## Mais leitura - -Esta pΓ‘gina Γ© apenas uma breve visΓ£o geral do roteador para mostrar que existe uma solução poderosa jΓ‘ construΓ­da para um problema muito comum. Para obter mais informaçáes sobre o roteador, confira seu livro ou confira alguns dos exemplos. - -O roteador tem sua prΓ³pria documentação! [DisponΓ­vel aqui](https://dioxuslabs.com/docs/0.3/router/). diff --git a/docs/guide/src/pt-br/interactivity/sharing_state.md b/docs/guide/src/pt-br/interactivity/sharing_state.md deleted file mode 100644 index b9b829c0c..000000000 --- a/docs/guide/src/pt-br/interactivity/sharing_state.md +++ /dev/null @@ -1,71 +0,0 @@ -# Estado de compartilhamento - -Muitas vezes, vΓ‘rios componentes precisam acessar o mesmo estado. Dependendo de suas necessidades, existem vΓ‘rias maneiras de implementar isso. - -## Elevenado o Estado - -Uma abordagem para compartilhar o estado entre os componentes Γ© "elevΓ‘-lo" atΓ© o ancestral comum mais prΓ³ximo. Isso significa colocar o _hook_ `use_state` em um componente pai e passar os valores necessΓ‘rios como _props_. - -Por exemplo, suponha que queremos construir um editor de memes. Queremos ter uma entrada para editar a legenda do meme, mas tambΓ©m uma visualização do meme com a legenda. Logicamente, o meme e a entrada sΓ£o 2 componentes separados, mas precisam acessar o mesmo estado (a legenda atual). - -> Claro, neste exemplo simples, poderΓ­amos escrever tudo em um componente - mas Γ© melhor dividir tudo em componentes menores para tornar o cΓ³digo mais reutilizΓ‘vel e fΓ‘cil de manter (isso Γ© ainda mais importante para aplicativos maiores e complexos) . - -ComeΓ§amos com um componente `Meme`, responsΓ‘vel por renderizar um meme com uma determinada legenda: - -```rust, no_run -{{#include ../../../examples/meme_editor.rs:meme_component}} -``` - -> Observe que o componente `Meme` nΓ£o sabe de onde vem a legenda – ela pode ser armazenada em `use_state`, `use_ref` ou uma constante. Isso garante que seja muito reutilizΓ‘vel - o mesmo componente pode ser usado para uma galeria de memes sem nenhuma alteração! - -TambΓ©m criamos um editor de legendas, totalmente desacoplado do meme. O editor de legendas nΓ£o deve armazenar a legenda em si – caso contrΓ‘rio, como iremos fornecΓͺ-la ao componente `Meme`? Em vez disso, ele deve aceitar a legenda atual como um suporte, bem como um manipulador de eventos para delegar eventos de entrada para: - -```rust, no_run -{{#include ../../../examples/meme_editor.rs:caption_editor}} -``` - -Finalmente, um terceiro componente renderizarΓ‘ os outros dois como filhos. Ele serΓ‘ responsΓ‘vel por manter o estado e passar os _props_ relevantes. - -```rust, no_run -{{#include ../../../examples/meme_editor.rs:meme_editor}} -``` - -![Captura de tela do editor de memes: Um velho esqueleto de plΓ‘stico sentado em um banco de parque. Legenda: "eu esperando por um recurso de idioma"](./images/meme_editor_screenshot.png) - -## Usando o contexto - -Γ€s vezes, algum estado precisa ser compartilhado entre vΓ‘rios componentes na Γ‘rvore, e passΓ‘-lo pelos _props_ Γ© muito inconveniente. - -Suponha agora que queremos implementar uma alternΓ’ncia de modo escuro para nosso aplicativo. Para conseguir isso, faremos com que cada componente selecione o estilo dependendo se o modo escuro estΓ‘ ativado ou nΓ£o. - -> Nota: estamos escolhendo esta abordagem como exemplo. Existem maneiras melhores de implementar o modo escuro (por exemplo, usando variΓ‘veis ​​CSS). Vamos fingir que as variΓ‘veis ​​CSS nΓ£o existem – bem-vindo a 2013! - -Agora, poderΓ­amos escrever outro `use_state` no componente superior e passar `is_dark_mode` para cada componente atravΓ©s de _props_. Mas pense no que acontecerΓ‘ Γ  medida que o aplicativo crescer em complexidade – quase todos os componentes que renderizam qualquer CSS precisarΓ£o saber se o modo escuro estΓ‘ ativado ou nΓ£o – para que todos precisem do mesmo suporte do modo escuro. E cada componente pai precisarΓ‘ passΓ‘-lo para eles. Imagine como isso ficaria confuso e verboso, especialmente se tivΓ©ssemos componentes com vΓ‘rios nΓ­veis de profundidade! - -A Dioxus oferece uma solução melhor do que esta "perfuração com hΓ©lice" – fornecendo contexto. O _hook_ [`use_context_provider`](https://docs.rs/dioxus-hooks/latest/dioxus_hooks/fn.use_context_provider.html) Γ© semelhante ao `use_ref`, mas o torna disponΓ­vel atravΓ©s do [`use_context`](https://docs.rs/dioxus-hooks/latest/dioxus_hooks/fn.use_context.html) para todos os componentes filhos. - -Primeiro, temos que criar um _struct_ para nossa configuração de modo escuro: - -```rust, no_run -{{#include ../../../examples/meme_editor_dark_mode.rs:DarkMode_struct}} -``` - -Agora, em um componente de nΓ­vel superior (como `App`), podemos fornecer o contexto `DarkMode` para todos os componentes filhos: - -```rust, no_run -{{#include ../../../examples/meme_editor_dark_mode.rs:context_provider}} -``` - -Como resultado, qualquer componente filho de `App` (direto ou nΓ£o), pode acessar o contexto `DarkMode`. - -```rust, no_run -{{#include ../../../examples/meme_editor_dark_mode.rs:use_context}} -``` - -> `use_context` retorna `Option>` aqui. Se o contexto foi fornecido, o valor Γ© `Some(UseSharedState)`, que vocΓͺ pode chamar `.read` ou `.write`, similarmente a `UseRef`. Caso contrΓ‘rio, o valor Γ© `None`. - -Por exemplo, aqui estΓ‘ como implementarΓ­amos a alternΓ’ncia do modo escuro, que lΓͺ o contexto (para determinar a cor que deve renderizar) e grava nele (para alternar o modo escuro): - -```rust, no_run -{{#include ../../../examples/meme_editor_dark_mode.rs:toggle}} -``` diff --git a/docs/guide/src/pt-br/interactivity/user_input.md b/docs/guide/src/pt-br/interactivity/user_input.md deleted file mode 100644 index 94a091e38..000000000 --- a/docs/guide/src/pt-br/interactivity/user_input.md +++ /dev/null @@ -1,33 +0,0 @@ -# Entradas do UsuΓ‘rio - -As interfaces geralmente precisam fornecer uma maneira de inserir dados: por exemplo, texto, nΓΊmeros, caixas de seleção, etc. No Dioxus, hΓ‘ duas maneiras de trabalhar com a entrada do usuΓ‘rio. - -## Entradas Controladas - -Com entradas controladas, vocΓͺ fica diretamente responsΓ‘vel pelo estado da entrada. Isso lhe dΓ‘ muita flexibilidade e facilita manter as coisas em sincronia. Por exemplo, Γ© assim que vocΓͺ criaria uma entrada de texto controlada: - -```rust, no_run -{{#include ../../../examples/input_controlled.rs:component}} -``` - -Observe a flexibilidade - vocΓͺ pode: - -- Exibir o mesmo conteΓΊdo em outro elemento, e eles estarΓ£o em sincronia -- Transformar a entrada toda vez que for modificada (por exemplo, para garantir que seja maiΓΊscula) -- Validar a entrada toda vez que ela mudar -- Ter uma lΓ³gica personalizada acontecendo quando a entrada for alterada (por exemplo, solicitação de rede para preenchimento automΓ‘tico) -- Alterar programaticamente o valor (por exemplo, um botΓ£o "randomize" que preenche a entrada com absurdos) - -## Entradas nΓ£o Controladas - -Como alternativa Γ s entradas controladas, vocΓͺ pode simplesmente deixar a plataforma acompanhar os valores de entrada. Se nΓ£o dissermos a uma entrada HTML qual conteΓΊdo ela deve ter, ela poderΓ‘ ser editada de qualquer maneira (isso estΓ‘ embutido na visualização da web). Essa abordagem pode ser mais eficiente, mas menos flexΓ­vel. Por exemplo, Γ© mais difΓ­cil manter a entrada sincronizada com outro elemento. - -Como vocΓͺ nΓ£o tem necessariamente o valor atual da entrada nΓ£o controlada no estado, vocΓͺ pode acessΓ‘-lo ouvindo os eventos `oninput` (de maneira semelhante aos componentes controlados) ou, se a entrada for parte de um formulΓ‘rio, vocΓͺ pode acessar os dados do formulΓ‘rio nos eventos do formulΓ‘rio (por exemplo, `oninput` ou `onsubmit`): - -```rust, no_run -{{#include ../../../examples/input_uncontrolled.rs:component}} -``` - -``` -Submitted! UiEvent { data: FormData { value: "", values: {"age": "very old", "date": "1966", "name": "Fred"} } } -``` diff --git a/docs/guide/src/pt-br/lib.rs b/docs/guide/src/pt-br/lib.rs deleted file mode 100644 index 97cda56a8..000000000 --- a/docs/guide/src/pt-br/lib.rs +++ /dev/null @@ -1 +0,0 @@ -// empty (we only need this crate for the examples) diff --git a/docs/guide/src/pt-br/publishing/desktop.md b/docs/guide/src/pt-br/publishing/desktop.md deleted file mode 100644 index ab9427b32..000000000 --- a/docs/guide/src/pt-br/publishing/desktop.md +++ /dev/null @@ -1,54 +0,0 @@ -# Publicação - -ParabΓ©ns! VocΓͺ fez seu primeiro aplicativo Dioxus que realmente faz coisas muito legais. Este aplicativo usa a biblioteca WebView do seu sistema operacional, portanto, Γ© portΓ‘til para ser distribuΓ­do para outras plataformas. - -Nesta seção, abordaremos como agrupar seu aplicativo para macOS, Windows e Linux. - -## Instale o `cargo-bundle` - -A primeira coisa que faremos Γ© instalar o [`cargo-bundle`](https://github.com/burtonageo/cargo-bundle). Essa extensΓ£o para carga facilitarΓ‘ muito o empacotamento do nosso aplicativo para as vΓ‘rias plataformas. - -De acordo com a pΓ‘gina do github `cargo-bundle`, - -_"cargo-bundle Γ© uma ferramenta usada para gerar instaladores ou pacotes de aplicativos para executΓ‘veis ​​GUI criados com o cargo. Ele pode criar pacotes .app para Mac OS X e iOS, pacotes .deb para Linux e instaladores .msi para Windows (observe no entanto que o suporte para iOS e Windows ainda Γ© experimental). O suporte para a criação de pacotes .rpm (para Linux) e pacotes .apk (para Android) ainda estΓ‘ pendente."_ - -Para instalar, basta executar - -`cargo install ` - -## Configurando seu Projeto - -Para obter uma configuração de projeto para empacotamento, precisamos adicionar algumas _flags_ ao nosso arquivo `Cargo.toml`. - -```toml -[package] -name = "example" -# ...other fields... - -[package.metadata.bundle] -name = "DogSearch" -identifier = "com.dogs.dogsearch" -version = "1.0.0" -copyright = "Copyright (c) Jane Doe 2016. All rights reserved." -category = "Developer Tool" -short_description = "Easily search for Dog photos" -long_description = """ -This app makes it quick and easy to browse photos of dogs from over 200 bree -""" -``` - -## Empacotando - -Seguindo as instruçáes do cargo-bundle, simplesmente `cargo-bundle --release` para produzir um aplicativo final com todas as otimizaçáes e recursos integrados. - -Depois de executar `cargo-bundle --release`, seu aplicativo deve estar acessΓ­vel em - -`target/release/bundle//`. - -Por exemplo, um aplicativo macOS ficaria assim: - -![Aplicativo publicado](../images/publish.png) - -Γ“timo! E sΓ£o apenas 4,8 Mb – extremamente enxutos! Como o Dioxus aproveita o WebView nativo da sua plataforma, os aplicativos Dioxus sΓ£o extremamente eficientes em termos de memΓ³ria e nΓ£o desperdiΓ§am sua bateria. - -> Nota: nem todo CSS funciona da mesma forma em todas as plataformas. Certifique-se de visualizar o CSS do seu aplicativo em cada plataforma – ou navegador da web (Firefox, Chrome, Safari) antes de publicar. diff --git a/docs/guide/src/pt-br/publishing/index.md b/docs/guide/src/pt-br/publishing/index.md deleted file mode 100644 index 06b7aaf7b..000000000 --- a/docs/guide/src/pt-br/publishing/index.md +++ /dev/null @@ -1 +0,0 @@ -# Publicando diff --git a/docs/guide/src/pt-br/publishing/web.md b/docs/guide/src/pt-br/publishing/web.md deleted file mode 100644 index 2ecc49699..000000000 --- a/docs/guide/src/pt-br/publishing/web.md +++ /dev/null @@ -1,9 +0,0 @@ -## Publicando com o Github Pages - -Para construir nosso aplicativo e publicΓ‘-lo no Github: - -- Verifique se o GitHub Pages estΓ‘ configurado para seu repositΓ³rio -- Crie seu aplicativo com `trunk build --release` (inclua `--public-url ` para atualizar os prefixos de ativos se estiver usando um site de projeto) -- Mova seu HTML/CSS/JS/Wasm gerado de `dist` para a pasta configurada para Github Pages -- Adicione e confirme com `git` -- `git push` para o GitHub diff --git a/docs/guide/src/pt-br/roadmap.md b/docs/guide/src/pt-br/roadmap.md deleted file mode 100644 index d16a09770..000000000 --- a/docs/guide/src/pt-br/roadmap.md +++ /dev/null @@ -1,138 +0,0 @@ -# Roteiro e Conjunto de Recursos - -Este conjunto de recursos e roteiro podem ajudΓ‘-lo a decidir se o que a Dioxus pode fazer hoje funciona para vocΓͺ. - -Se um recurso que vocΓͺ precisa nΓ£o existe ou vocΓͺ deseja contribuir com projetos no roteiro, sinta-se Γ  vontade para se envolver [juntando-se ao discord](https://discord.gg/XgGxMSkvUM). - -Em geral, aqui estΓ‘ o status de cada plataforma: - -- **Web**: Dioxus Γ© uma Γ³tima opção para aplicativos da web puros - especialmente para aplicativos CRUD/complexos. No entanto, ele nΓ£o possui o ecossistema do React, entΓ£o vocΓͺ pode estar perdendo uma biblioteca de componentes ou algum _hook_ ΓΊtil. - -- **SSR**: Dioxus Γ© uma Γ³tima opção para prΓ©-renderização, hidratação e renderização de HTML em um endpoint da web. Esteja ciente: o `VirtualDom` nΓ£o Γ© (atualmente) `Send + Sync`. - -- **Desktop**: vocΓͺ pode criar aplicativos de desktop de janela ΓΊnica muito competentes agora mesmo. No entanto, os aplicativos de vΓ‘rias janelas exigem suporte do nΓΊcleo do Dioxus que nΓ£o estΓ£o prontos. - -- **Celular**: o suporte mΓ³vel Γ© muito recente. VocΓͺ descobrirΓ‘ as coisas Γ  medida que avanΓ§a e nΓ£o hΓ‘ muitas `crates` de suporte para perifΓ©ricos. - -- **LiveView**: o suporte ao LiveView Γ© muito recente. VocΓͺ descobrirΓ‘ as coisas Γ  medida que avanΓ§a. Felizmente, nada disso Γ© muito difΓ­cil e qualquer trabalho poderΓ‘ ser enviado `upstream` no Dioxus. - -## Recursos - ---- - -| Recurso | Situação | Descrição | -| ----------------------------------- | -------- | ------------------------------------------------------------------------------------------------ | -| Renderização Condicional | βœ… | `if/then` para esconder/mostrar componente | -| Map, Iterador | βœ… | `map/filter/reduce` para produzir `rsx!` | -| Componentes Chaveados | βœ… | comparação em `diff` com chaves | -| Web | βœ… | renderizador para navegadores Web | -| Desktop (WebView) | βœ… | renderizador para Desktop | -| Estado Compartilhado (Context) | βœ… | compartilha estados atravΓ©s de Γ‘rvores | -| Hooks | βœ… | cΓ©lulas de memoria nos componentes | -| SSR | βœ… | renderiza diretamente para `string` | -| Componente Filho | βœ… | `cx.children()` como lista de nΓ³s | -| Componentes Sem Elementos | βœ… | componentes que nΓ£o renderizam elementos reais na DOM | -| Fragmentos | βœ… | elementos mΓΊltiplos sem uma raiz real | -| Propriedades Manuais | βœ… | passa manualmente `props` com a sintaxe de propagação (`spread syntax`) | -| Entradas Controladas | βœ… | encapsulamento com estado em sobre entradas | -| Estilos CSS/Inline | βœ… | sintaxe para grupos de estilo/atributos em linha | -| Elementos Personalizados | βœ… | define novos elementos primitivos | -| SuspensΓ£o | βœ… | programa futuras renderizaçáes usando `future`/`Promise` | -| Tratamento Integrado de Erros | βœ… | trata erros graciosamente com a sintaxe `?` | -| NodeRef | βœ… | ganha acesso direto aos nΓ³s | -| Re-hidratação | βœ… | pre-renderiza HTML para acelerar a primeira impressΓ£o na tela | -| Renderização Livre de Gargalos | βœ… | `diffs` grandes sΓ£o segmentados sobre quadros para uma transição suave como seda | -| Efeitos | βœ… | executa efeitos apΓ³s um componente ser enviado para a fila de renderização | -| Portais | πŸ›  | renderiza nΓ³s fora da Γ‘rvore tradicional de elementos (DOM) | -| Agendamento Cooperativo | πŸ›  | prioriza eventos com mais importΓ’ncia sobre eventos menos importantes | -| Componentes de Servidor | πŸ›  | componentes hΓ­bridos para aplicativos de ΓΊnica pΓ‘gina (SPA) e servidores | -| DivisΓ£o de Pacotes | πŸ‘€ | carrega o aplicativo assincronamente e eficientemente | -| Componentes Tardios | πŸ‘€ | dinamicamente carrega os novos componentes assim que estiverem prontos enquanto a pΓ‘gina carrega | -| Estado Global de 1Βͺ Classe | βœ… | `redux/recoil/mobx` sobre o `context` | -| Execução Nativa | βœ… | execução como um binΓ‘rio portΓ‘til sem um `runtime` (Node) | -| Sub-Árvore de Memoization | βœ… | pula o `diffing` em sub-Γ‘rvores de elementos estΓ‘ticos | -| Modelos de Alta EficiΓͺncia | πŸ›  | chamadas `rsx!` sΓ£o traduzidas para modelos sobre a `DOM` | -| Garantia de Correção por Compilador | βœ… | avisa sobre erros em esquemas de modelos invΓ‘lidos antes do final da compilação | -| Motor de HeurΓ­stica | βœ… | rastreia componentes na memΓ³ria para minimizar alocaçáes futures | -| Controle Preciso de Reatividade | πŸ‘€ | pula o `diffing` para ter controle preciso das atualizaçáes de tela | - -- βœ… = implementado e funcionando -- πŸ›  = sendo trabalhado ativamente -- πŸ‘€ = ainda nΓ£o implementado ou sendo trabalhado - -## Roteiro - -Esses recursos estΓ£o planejados para o futuro do Dioxus: - -### Essencial - -- [x] Liberação do NΓΊcleo Dioxus -- [x] Atualizar a documentação para incluir mais teoria e ser mais abrangente -- [ ] Suporte para modelos HTML para manipulação de DOM ultrarrΓ‘pida -- [ ] Suporte para vΓ‘rios renderizadores para o mesmo `virtualdom` (subΓ‘rvores) -- [ ] Suporte para `ThreadSafe` (`Send` + `Sync`) -- [ ] Suporte para `Portals` - -### SSR - -- [x] Suporte SSR + Hidratação -- [ ] Suporte integrado de suspensΓ£o para SSR - -### Desktop - -- [ ] Gerenciamento de janela declarativa -- [ ] Modelos para construção/agregação -- [ ] Renderizador totalmente nativo -- [ ] Acesso ao contexto Canvas/WebGL nativamente - -### MΓ³vel - -- [ ] Biblioteca padrΓ£o mΓ³vel - - [ ] GPS - - [ ] CΓ’mera - - [ ] Sistema de Arquivo - - [ ] Biometria - - [ ] Wi-fi - - [ ] Bluetooth - - [ ] Notificaçáes - - [ ] Prancheta (_Clipboard_) -- [ ] Animaçáes -- [ ] Renderizador nativo - -### Empacotamento (CLI) - -- [x] Tradução de HTML para RSX -- [x] Servidor de desenvolvimento -- [x] Recarregamento em tempo-real (_hot-reload_) -- [x] Tradução de JSX para RSX -- [ ] Substituição de mΓ³dulos em tempo-real (_hot-modules_) -- [ ] DivisΓ£o de cΓ³digo -- [ ] Acervo de macros -- [ ] _Pipeline_ CSS -- [ ] _Pipeline_ de imagens - -### Hooks Essenciais - -- [x] Roteador -- [x] Gerenciamento de estado global -- [ ] Redimensionar o observador - -## Trabalho em Progresso - -### Ferramenta de Construção - -Atualmente, estamos trabalhando em nossa prΓ³pria ferramenta de compilação chamada [Dioxus CLI](https://github.com/DioxusLabs/cli) que suportarΓ‘: - -- uma TUI interativa -- reconfiguração em tempo real -- recarga de CSS em tempo-real -- ligação de dados bidirecional entre o navegador e o cΓ³digo-fonte -- um interpretador para `rsx!` -- capacidade de publicar no github/netlify/vercel -- pacote para iOS/Desktop/etc - -### Suporte ao LiveView / Componente do Servidor - -A arquitetura interna do Dioxus foi projetada desde o primeiro dia para suportar o caso de uso `LiveView`, onde um servidor Web hospeda um aplicativo em execução para cada usuΓ‘rio conectado. A partir de hoje, nΓ£o hΓ‘ suporte LiveView de primeira classe – vocΓͺ precisarΓ‘ conectar isso sozinho. - -Embora nΓ£o esteja totalmente implementado, a expectativa Γ© que os aplicativos LiveView possam ser um hΓ­brido entre Wasm e renderizado pelo servidor, onde apenas partes de uma pΓ‘gina sΓ£o "ao vivo" e o restante da pΓ‘gina Γ© renderizado pelo servidor, gerado estaticamente ou manipulado pelo SPA anfitriΓ£o. diff --git a/docs/posts/release-0-2-0.md b/docs/posts/release-0-2-0.md deleted file mode 100644 index 82d87a730..000000000 --- a/docs/posts/release-0-2-0.md +++ /dev/null @@ -1,361 +0,0 @@ -# Dioxus v0.2 Release: TUI, Router, Fermi, and Tooling - -> March 9, 2022 - -Thanks to these amazing folks for their financial support on OpenCollective: - -- [@t1m0t](https://github.com/t1m0t) -- [@alexkirsz](https://github.com/t1m0t) -- [@freopen](https://github.com/freopen) -- [@DannyMichaels](https://github.com/DannyMichaels) -- [@SweetLittleMUV](https://github.com/Fatcat560) - -Thanks to these amazing folks for their code contributions: - -- [@mrxiaozhuox](https://github.com/mrxiaozhuox) -- [@autarch](https://github.com/autarch) -- [@FruitieX](https://github.com/FruitieX) -- [@t1m0t](https://github.com/t1m0t) -- [@Demonthos](https://github.com/Demonthos) -- [@oovm](https://github.com/oovm) -- [@6asaaki](https://github.com/6asaaki) - -Just over two months in, and we already a ton of awesome changes to Dioxus! - -Dioxus is a recently-released library for building interactive user interfaces (GUI) with Rust. It is built around a Virtual DOM, making it portable for the web, desktop, server, mobile, and more. Dioxus looks and feels just like React, so if you know React, then you'll feel right at home. - -```rust, no_run -fn app(cx: Scope) -> Element { - let mut count = use_state(cx, || 0); - - cx.render(rsx! { - h1 { "Count: {count}" } - button { onclick: move |_| count += 1, "+" } - button { onclick: move |_| count -= 1, "-" } - }) -} -``` - -# What's new? - -A _ton_ of stuff happened in this release; 550+ commits, 23 contributors, 2 minor releases, and 6 backers on Open Collective. - -Some of the major new features include: - -- We now can render into the terminal, similar to Ink.JS - a huge thanks to [@Demonthos](https://github.com/Demonthos) -- We have a new router in the spirit of React-Router [@autarch](https://github.com/autarch) -- We now have Fermi for global state management in the spirit of [Recoil.JS](https://recoiljs.org) -- Our desktop platform got major upgrades, getting closer to parity with Electron [@mrxiaozhuox](https://github.com/mrxiaozhuox) -- Our CLI tools now support HTML-to-RSX translation for converting 3rd party HTML into Dioxus [@mrxiaozhuox](https://github.com/mrxiaozhuox) -- Dioxus-Web is sped up by 2.5x with JS-based DOM manipulation (3x faster than React) - -We also fixed and improved a bunch of stuff - check out the full list down below. - -## A New Renderer: Your terminal! - -When Dioxus was initially released, we had very simple support for logging Dioxus elements out as TUI elements. In the past month or so, [@Demonthos](https://github.com/Demonthos) really stepped up and made the new crate a reality. - -![Imgur](https://i.imgur.com/GL7uu3r.png) - -The new TUI renderer even supports mouse movements, keyboard input, async tasks, borders, and a ton more. - -

- ); -}; -``` - -In Dioxus, we would define the same component in a similar fashion: - -```rust, no_run -#[derive(Props, PartialEq)] -struct CardProps { - title: String, - paragraph: String -} - -static Card: Component = |cx| { - let mut count = use_state(cx, || 0); - cx.render(rsx!( - aside { - h2 { "{cx.props.title}" } - p { "{cx.props.paragraph}" } - button { onclick: move |_| count+=1, "Count: {count}" } - } - )) -}; -``` - -However, we recognize that not every project needs Rust - many are fine with JavaScript! We also acknowledge that Rust/Wasm/Dioxus does not fix "everything that is wrong with frontend development." There are always going to be new patterns, frameworks, and languages that solve these problems better than Rust and Dioxus. - -As a general rule of thumb, Dioxus is for you if: - -- your app will become very large -- you need to share code across many platforms -- you want a fast way to build for desktop -- you want to avoid electron or need direct access to hardware -- you're tired of JavaScript tooling - -Today, to publish a Dioxus app, you don't need NPM/WebPack/Parcel/etc. Dioxus simply builds with cargo, and for web builds, Dioxus happily works with the popular [trunk](http://trunkrs.dev) project. - -## Show me more - -Here, we'll dive into some features of Dioxus and why it's so fun to use. The [guide](https://dioxuslabs.com/guide/en/) serves as a deeper and more comprehensive look at what Dioxus can do. - -## Building a new project is simple - -To start a new project, all you need is Cargo, which comes with Rust. For a simple desktop app, all we'll need is the `dioxus` crate with the appropriate `desktop` feature. We start by initializing a new binary crate: - -```shell -$ cargo init dioxus_example -$ cd dioxus_example -``` - -We then add a dependency on Dioxus to the `Cargo.toml` file, with the "desktop" feature enabled: - -```rust, no_run -[dependencies] -dioxus = { version = "*", features = ["desktop"] } -``` - -We can add our counter from above. - -```rust, no_run -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(app) -} - -fn app(cx: Scope) -> Element { - let mut count = use_state(cx, || 0); - - cx.render(rsx! { - h1 { "Count: {count}" } - button { onclick: move |_| count += 1, "+" } - button { onclick: move |_| count -= 1, "-" } - }) -} -``` - -And voilΓ ! We can `cargo run` our app - -![Simple Counter Desktop App](/static/counter.png) - -## Support for JSX-style templating - -Dioxus ships with a templating macro called RSX, a spin on React's JSX. RSX is very similar to regular struct syntax for Rust so it integrates well with your IDE. If used with [Rust-Analyzer](https://github.com/rust-analyzer/rust-analyzer) (not tested anywhere else) RSX supports code-folding, block selection, bracket pair colorizing, autocompletion, symbol renaming β€” pretty much anything you would expect from writing regular struct-style code. - -```rust, no_run -rsx! { - div { "Hello world" } - button { - onclick: move |_| log::info!("button pressed"), - "Press me" - } -} -``` - -If macros aren't your style, you can always drop down to the factory API: - -```rust, no_run -LazyNodes::new(|f| { - f.fragment([ - f.element(div, [f.text("hello world")], [], None, None) - f.element( - button, - [f.text("Press Me")], - [on::click(move |_| log::info!("button pressed"))], - None, - None - ) - ]) -}) -``` - -The `rsx!` macro generates idiomatic Rust code that uses the factory API β€” no different than what you'd write by hand yourself. - -To make it easier to work with RSX, we've built a small [VSCode extension](https://github.com/DioxusLabs/studio) with useful utilities. This extension provides a command that converts a selected block of HTML into RSX so you can easily reuse existing web templates. - -## Dioxus prioritizes developer experience - -Many of the Rust UI frameworks are particularly difficult to work with. Even the ones branded as "ergonomic" are quite challenging to in comparison to TSX/JSX. With Dioxus, we've innovated on a number of Rust patterns to deliver a framework that is actually enjoyable to develop in. - -For example, many Rust frameworks require you to clone your data in for _every_ closure and handler you use. This can get really clumsy for large apps. - -```rust, no_run -div() - .children([ - button().onclick(cloned!(name, date, age, description => move |evt| { /* */ }) - button().onclick(cloned!(name, date, age, description => move |evt| { /* */ }) - button().onclick(cloned!(name, date, age, description => move |evt| { /* */ }) - ]) -``` - -Dioxus understands the lifetimes of data borrowed from `Scope`, so you can safely return any borrowed data without declaring explicit captures. Hook handles all implement `Copy` so they can be shared between listeners without any ceremony. - -```rust, no_run -let name = use_state(cx, || "asd"); -rsx! { - div { - button { onclick: move |_| name.set("abc") } - button { onclick: move |_| name.set("def") } - button { onclick: move |_| name.set("ghi") } - } -} -``` - -Because we know the lifetime of your handlers, we can also expose this to children. No other Rust frameworks let us share borrowed state through the tree, forcing use of Rc/Arc everywhere. With Dioxus, all the Rc/Arc magic is tucked away in hooks, and just beautiful borrowed interfaces are exposed to your code. You don't need to know how Rc/RefCell work to build a competent Dioxus app. - -```rust, no_run -fn app(cx: Scope) -> Element { - let name = use_state(cx, || "asd"); - cx.render(rsx!{ - Button { name: name } - }) -} - -#[derive(Props)] -struct ButtonProps<'a> { - name: UseState<'a, &'static str> -} - -fn Button<'a>(cx: Scope<'a, Childprops<'a>>) -> Element { - cx.render(rsx!{ - button { - onclick: move |_| cx.props.name.set("bob") - } - }) -} -``` - -There's _way_ more to this story, but hopefully we've convinced you that Dioxus' DX somewhat approximates JSX/React. - -## Dioxus is perfected for the IDE - -Note: all IDE-related features have only been tested with [Rust-Analyzer](https://github.com/rust-analyzer/rust-analyzer). - -Dioxus code operates pleasantly with your IDE. For starters, most elements are documented through the Rustdoc system. A quick summary of the MDN docs is always under your finger tips: - -![Elements have hover context](/static/ide_hover.png) - -Dioxus also wraps platform-specific events with a custom synthetic event system. This means events enjoy proper autocomplete and documentation, unlike [Yew](https://yew.rs/) which currently relies on [web-sys](https://crates.io/crates/web-sys) with incomplete IDE support: - -![Events are strongly typed](/static/ide_autocomplete.png) - -Even element attributes and event handlers have top-notch documentation! - -![Element attributes and listeners have hover context](/static/ide_listener.png) - -The `rsx!` macro also benefits from code folding, batch renaming, and block selection, making most basic code navigation and completion tasks a breeze. - -![Element blocks can be folded and renamed](/static/ide_selection.png) - -Furthermore, the `rsx!` macro itself is documented, so if you ever forget how to use a certain feature, the documentation remains close at hand: - -![The RSX documentation is provided on hover](/static/ide_rsx.png) - -We spent a ton of time on this and we hope you enjoy it! - -## Dioxus is extremely fast - -We take the performance of Dioxus seriously. Instead of resolving to "good enough," Dioxus is designed to push the limits of what a declarative React-like framework can achieve. Dioxus is designed with multi-tenancy in mind: a single machine should be able to run thousands of simultaneous low-latency LiveView apps without skipping a beat. To accomplish this goal we've implemented a large number of optimizations: - -- Usage of bump memory allocators and double-buffering -- Compile-time hashing of templates -- Automatic component memoization -- Fiber-like scheduler -- DOM Patch Batching - -Dioxus is humbly built off the work done by [Dodrio](https://github.com/fitzgen/dodrio), a now-archived research project by fitzgen exploring the use of bump allocators in UI frameworks. - -Dioxus is _substantially_ more performant than many of the other Rust DOM-based UI libraries (Yew/Percy) and is _significantly_ more performant than React - roughly competitive with InfernoJS. While not as performant as libraries like SolidJS/Sycamore, Dioxus imposes roughly a ~3% overhead over DOM patching, so it's _plenty_ fast. - -## Works on Desktop and Mobile - -We’ve mentioned before that Dioxus works practically anywhere that Rust does. When running natively as a desktop or mobile app, your Dioxus code will run on its own thread, not inside of a web runtime. This means you can access hardware, file system, and platform APIs directly without needing to go through a shim layer. In our examples, we feature a [file explorer app](https://github.com/DioxusLabs/example-projects/tree/master/file-explorer) and [WiFi scanner app](https://github.com/DioxusLabs/example-projects/tree/master/wifi-scanner) where platform access occurs inside an asynchronous multithreaded coroutine. This solves the problem faced by React Native and other cross-platform toolkits where JavaScript apps incur a massive performance penalty with substantial maintenance overhead associated with platform API shims. - -A desktop app: - -[![Example Dioxus desktop app](https://github.com/DioxusLabs/example-projects/raw/master/file-explorer/image.png)](https://github.com/DioxusLabs/example-projects/blob/master/file-explorer) - -A mobile app: - -[![Example Dioxus mobile app](https://github.com/DioxusLabs/example-projects/raw/master/ios_demo/assets/screenshot_smaller.jpeg)](https://github.com/DioxusLabs/example-projects/blob/master/ios_demo) - -However, be warned that mobile is currently considered very experimental and there will likely be quirks. Dioxus is leveraging the work done by the [Tauri](https://github.com/tauri-apps/tauri) team to enable mobile support, and mobile support isn't technically complete in Tauri yet. - -iOS should be supported out of the box, but Android support will take custom some boilerplate that hasn't been completely figured out. If you're interested in contributing to Dioxus, improving mobile support would be extremely helpful. - -### Did someone say TUI support? - -Yes, you can even build terminal user interfaces with Dioxus. Full support is still a work in progress, but the foundation is there. - -[![TUI Support](https://github.com/DioxusLabs/rink/raw/master/examples/example.png)](https://github.com/dioxusLabs/rink) - -### Things we didn't cover: - -There are a bunch of things we didn't talk about here. Check out the guide for more information, or peruse the examples and reference for more context. - -- Jank-free rendering with fiber scheduler -- [Support for borrowed props]() -- [Conditional rendering]() -- [CSS/Styling/Inline style support]() -- [Support for inline Context Providing/Consuming]() -- [First-class global state management]() - -For a quick glance at party with React, check out the [Readme on Github](https://github.com/DioxusLabs/dioxus#parity-with-react). - -## What's on the roadmap? - -The world of Rust on the frontend is barely explored. Given the performance, ergonomics, and portability of Rust/Dioxus, we expect there to be a ton of different applications where having a React-like toolkit running natively can enable things previously considered impossible. - -In the coming weeks, our plan is to finish the remaining outstanding features where Dioxus is lacking in comparison to React: - -- Transition effects for Suspense -- Micro-optimizations and better cross-platform/browser bug mitigations -- Heuristics to guide the diffing algorithm -- Better support for subtree memoization (signals, etc.) -- More thorough documentation, fleshing out sore spots - -We also need some help in important crates currently missing: - -- First class cross-platform router (currently in progress) -- An extension to DioxusStudio that enables lazy bundling of static assets -- Animation library (see [React Spring](https://react-spring.io/), [Framer Motion](https://www.framer.com/motion/)) -- A [TUI renderer for Dioxus](https://github.com/dioxuslabs/rink) (see [Ink](https://github.com/vadimdemedes/ink)) - -And finally, some bigger, forward-thinking projects that are too big for a one-person team: - -- Completely native renderer for the Dioxus Virtual DOM (see [Flutter](https://flutter.dev/)) -- Better support for LiveView -- Code-splitting -- 3D renderer (see [react-three-fiber](https://github.com/pmndrs/react-three-fiber)) - -Stay tuned for our next article, which will go over some of the optimization techniques that went into making Dioxus blazing fast. - -## Community - -The future is bright for Rust frontends! If you'd like to get involved, we have a [Discord server](https://discord.gg/XgGxMSkvUM), [a subreddit](http://reddit.com/r/dioxus), and [GitHub discussion pages](https://github.com/DioxusLabs/dioxus/discussions). - -Let us know what you build! - -Check out the original `/r/rust` thread here. diff --git a/docs/router/.gitignore b/docs/router/.gitignore deleted file mode 100644 index 7585238ef..000000000 --- a/docs/router/.gitignore +++ /dev/null @@ -1 +0,0 @@ -book diff --git a/docs/router/Cargo.toml b/docs/router/Cargo.toml deleted file mode 100644 index 59e8861ad..000000000 --- a/docs/router/Cargo.toml +++ /dev/null @@ -1,14 +0,0 @@ -[package] -name = "dioxus-router-guide" -version = "0.0.1" -edition = "2021" -description = "Dioxus router guide, including testable examples" -license = "MIT OR Apache-2.0" -publish = false - -[dev-dependencies] -dioxus = { path = "../../packages/dioxus" } -dioxus-desktop = { path = "../../packages/desktop" } -dioxus-web = { path = "../../packages/web" } -dioxus-ssr = { path = "../../packages/ssr" } -dioxus-router = { path = "../../packages/router" } diff --git a/docs/router/README.md b/docs/router/README.md deleted file mode 100644 index 7219b47a4..000000000 --- a/docs/router/README.md +++ /dev/null @@ -1,7 +0,0 @@ -# The router book - -## How to run the tests -- Navigate your terminal to this directory -- Run `cargo clean` -- Run `cargo build --all --F regex -F serde -F web` -- Run `mdbook test -L ../../target/debug/deps/` diff --git a/docs/router/book.toml b/docs/router/book.toml deleted file mode 100644 index e2000ca82..000000000 --- a/docs/router/book.toml +++ /dev/null @@ -1,9 +0,0 @@ -[book] -authors = ["Jonathan Kelley"] -language = "en" -multilingual = false -src = "src" -title = "Dioxus Router" - -[rust] -edition = "2021" diff --git a/docs/router/examples/catch_all.rs b/docs/router/examples/catch_all.rs deleted file mode 100644 index 0e989b7a6..000000000 --- a/docs/router/examples/catch_all.rs +++ /dev/null @@ -1,48 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; -use dioxus_router::prelude::*; - -// ANCHOR: router -#[derive(Routable, Clone)] -enum Route { - #[route("/")] - Home {}, - // PageNotFound is a catch all route that will match any route and placing the matched segments in the route field - #[route("/:..route")] - PageNotFound { route: Vec }, -} -// ANCHOR_END: router - -// ANCHOR: app -#[inline_props] -fn App(cx: Scope) -> Element { - render! { - Router:: {} - } -} -// ANCHOR_END: app - -// ANCHOR: home -#[inline_props] -fn Home(cx: Scope) -> Element { - render! { - h1 { "Welcome to the Dioxus Blog!" } - } -} -// ANCHOR_END: home - -// ANCHOR: fallback -#[inline_props] -fn PageNotFound(cx: Scope, route: Vec) -> Element { - render! { - h1 { "Page not found" } - p { "We are terribly sorry, but the page you requested doesn't exist." } - pre { - color: "red", - "log:\nattemped to navigate to: {route:?}" - } - } -} -// ANCHOR_END: fallback - -fn main() {} diff --git a/docs/router/examples/catch_all_segments.rs b/docs/router/examples/catch_all_segments.rs deleted file mode 100644 index ce84a84db..000000000 --- a/docs/router/examples/catch_all_segments.rs +++ /dev/null @@ -1,24 +0,0 @@ -#![allow(non_snake_case, unused)] -use dioxus::prelude::*; -use dioxus_router::prelude::*; - -// ANCHOR: route -#[derive(Routable, Clone)] -#[rustfmt::skip] -enum Route { - // segments that start with :... are catch all segments - #[route("/blog/:..segments")] - BlogPost { - // You must include catch all segment in child variants - segments: Vec, - }, -} - -// Components must contain the same catch all segments as their corresponding variant -#[inline_props] -fn BlogPost(cx: Scope, segments: Vec) -> Element { - todo!() -} -// ANCHOR_END: route - -fn main() {} diff --git a/docs/router/examples/dynamic_route.rs b/docs/router/examples/dynamic_route.rs deleted file mode 100644 index f8a103e7c..000000000 --- a/docs/router/examples/dynamic_route.rs +++ /dev/null @@ -1,115 +0,0 @@ -#![allow(non_snake_case)] - -use dioxus::prelude::*; -use dioxus_router::prelude::*; - -fn main() { - #[cfg(target_arch = "wasm32")] - dioxus_web::launch(App); - #[cfg(not(target_arch = "wasm32"))] - dioxus_desktop::launch(App); -} - -// ANCHOR: router -#[derive(Routable, Clone)] -#[rustfmt::skip] -enum Route { - #[layout(NavBar)] - #[route("/")] - Home {}, - #[nest("/blog")] - #[layout(Blog)] - #[route("/")] - BlogList {}, - #[route("/blog/:name")] - BlogPost { name: String }, - #[end_layout] - #[end_nest] - #[end_layout] - #[route("/:..route")] - PageNotFound { - route: Vec, - }, -} -// ANCHOR_END: router - -fn App(cx: Scope) -> Element { - render! { - Router:: {} - } -} - -#[inline_props] -fn NavBar(cx: Scope) -> Element { - render! { - nav { - ul { - li { Link { to: Route::Home {}, "Home" } } - li { Link { to: Route::BlogList {}, "Blog" } } - } - } - Outlet:: {} - } -} - -#[inline_props] -fn Home(cx: Scope) -> Element { - render! { - h1 { "Welcome to the Dioxus Blog!" } - } -} - -// ANCHOR: blog -#[inline_props] -fn Blog(cx: Scope) -> Element { - render! { - h1 { "Blog" } - Outlet:: {} - } -} -// ANCHOR_END: blog - -// ANCHOR: blog_list -#[inline_props] -fn BlogList(cx: Scope) -> Element { - render! { - h2 { "Choose a post" } - ul { - li { - Link { - to: Route::BlogPost { name: "Blog post 1".into() }, - "Read the first blog post" - } - } - li { - Link { - to: Route::BlogPost { name: "Blog post 2".into() }, - "Read the second blog post" - } - } - } - } -} -// ANCHOR_END: blog_list - -// ANCHOR: blog_post -// The name prop comes from the /:name route segment -#[inline_props] -fn BlogPost(cx: Scope, name: String) -> Element { - render! { - h2 { "Blog Post: {name}"} - } -} -// ANCHOR_END: blog_post - -#[inline_props] -fn PageNotFound(cx: Scope, route: Vec) -> Element { - render! { - h1 { "Page not found" } - p { "We are terribly sorry, but the page you requested doesn't exist." } - pre { - color: "red", - "log:\nattemped to navigate to: {route:?}" - } - } -} diff --git a/docs/router/examples/dynamic_segments.rs b/docs/router/examples/dynamic_segments.rs deleted file mode 100644 index 6aee22e6c..000000000 --- a/docs/router/examples/dynamic_segments.rs +++ /dev/null @@ -1,35 +0,0 @@ -#![allow(non_snake_case, unused)] -use dioxus::prelude::*; -use dioxus_router::prelude::*; - -// ANCHOR: route -#[derive(Routable, Clone)] -#[rustfmt::skip] -enum Route { - // segments that start with : are dynamic segments - #[route("/blog/:name")] - BlogPost { - // You must include dynamic segments in child variants - name: String, - }, - #[route("/document/:id")] - Document { - // You can use any type that implements FromStr - // If the segment can't be parsed, the route will not match - id: usize, - }, -} - -// Components must contain the same dynamic segments as their corresponding variant -#[inline_props] -fn BlogPost(cx: Scope, name: String) -> Element { - todo!() -} - -#[inline_props] -fn Document(cx: Scope, id: usize) -> Element { - todo!() -} -// ANCHOR_END: route - -fn main() {} diff --git a/docs/router/examples/external_link.rs b/docs/router/examples/external_link.rs deleted file mode 100644 index ed855e2d3..000000000 --- a/docs/router/examples/external_link.rs +++ /dev/null @@ -1,28 +0,0 @@ -#![allow(non_snake_case, unused)] - -use dioxus::prelude::*; -use dioxus_router::prelude::*; - -#[derive(Routable, Clone)] -enum Route { - #[route("/")] - Home {}, -} - -#[inline_props] -fn Home(cx: Scope) -> Element { - todo!() -} - -fn main() {} - -// ANCHOR: component -fn GoToDioxus(cx: Scope) -> Element { - render! { - Link { - to: "https://dioxuslabs.com", - "ExternalTarget target" - } - } -} -// ANCHOR_END: component diff --git a/docs/router/examples/first_route.rs b/docs/router/examples/first_route.rs deleted file mode 100644 index 5afa513f9..000000000 --- a/docs/router/examples/first_route.rs +++ /dev/null @@ -1,36 +0,0 @@ -// ANCHOR: router -#![allow(non_snake_case)] -use dioxus::prelude::*; -use dioxus_router::prelude::*; - -/// An enum of all of the possible routes in the app. -#[derive(Routable, Clone)] -enum Route { - // The home page is at the / route - #[route("/")] - // If the name of the component and variant are the same you can omit the component and props name - // If they are different you can specify them like this: - // #[route("/", ComponentName, PropsName)] - Home {}, -} -// ANCHOR_END: router - -// ANCHOR: app -#[inline_props] -fn App(cx: Scope) -> Element { - render! { - Router:: {} - } -} -// ANCHOR_END: app - -// ANCHOR: home -#[inline_props] -fn Home(cx: Scope) -> Element { - render! { - h1 { "Welcome to the Dioxus Blog!" } - } -} -// ANCHOR_END: home - -fn main() {} diff --git a/docs/router/examples/full_example.rs b/docs/router/examples/full_example.rs deleted file mode 100644 index 11465c38f..000000000 --- a/docs/router/examples/full_example.rs +++ /dev/null @@ -1,112 +0,0 @@ -#![allow(non_snake_case)] - -use dioxus::prelude::*; -use dioxus_router::prelude::*; - -fn main() { - #[cfg(target_arch = "wasm32")] - dioxus_web::launch(App); - #[cfg(not(target_arch = "wasm32"))] - dioxus_desktop::launch(App); -} - -// ANCHOR: router -#[derive(Routable, Clone)] -#[rustfmt::skip] -enum Route { - #[layout(NavBar)] - #[route("/")] - Home {}, - #[nest("/blog")] - #[layout(Blog)] - #[route("/")] - BlogList {}, - #[route("/blog/:name")] - BlogPost { name: String }, - #[end_layout] - #[end_nest] - #[end_layout] - #[nest("/myblog")] - #[redirect("/", || Route::BlogList {})] - #[redirect("/:name", |name: String| Route::BlogPost { name })] - #[end_nest] - #[route("/:..route")] - PageNotFound { - route: Vec, - }, -} -// ANCHOR_END: router - -fn App(cx: Scope) -> Element { - render! { - Router:: {} - } -} - -#[inline_props] -fn NavBar(cx: Scope) -> Element { - render! { - nav { - ul { - li { Link { to: Route::Home {}, "Home" } } - li { Link { to: Route::BlogList {}, "Blog" } } - } - } - Outlet:: {} - } -} - -#[inline_props] -fn Home(cx: Scope) -> Element { - render! { - h1 { "Welcome to the Dioxus Blog!" } - } -} - -#[inline_props] -fn Blog(cx: Scope) -> Element { - render! { - h1 { "Blog" } - Outlet:: {} - } -} - -#[inline_props] -fn BlogList(cx: Scope) -> Element { - render! { - h2 { "Choose a post" } - ul { - li { - Link { - to: Route::BlogPost { name: "Blog post 1".into() }, - "Read the first blog post" - } - } - li { - Link { - to: Route::BlogPost { name: "Blog post 2".into() }, - "Read the second blog post" - } - } - } - } -} - -#[inline_props] -fn BlogPost(cx: Scope, name: String) -> Element { - render! { - h2 { "Blog Post: {name}"} - } -} - -#[inline_props] -fn PageNotFound(cx: Scope, route: Vec) -> Element { - render! { - h1 { "Page not found" } - p { "We are terribly sorry, but the page you requested doesn't exist." } - pre { - color: "red", - "log:\nattemped to navigate to: {route:?}" - } - } -} diff --git a/docs/router/examples/history_buttons.rs b/docs/router/examples/history_buttons.rs deleted file mode 100644 index 971549aa5..000000000 --- a/docs/router/examples/history_buttons.rs +++ /dev/null @@ -1,30 +0,0 @@ -#![allow(non_snake_case, unused)] -use dioxus::prelude::*; -use dioxus_router::prelude::*; - -#[derive(Routable, Clone)] -#[rustfmt::skip] -enum Route { - #[route("/")] - Home {}, -} - -#[inline_props] -fn Home(cx: Scope) -> Element { - todo!() -} - -// ANCHOR: history_buttons -fn HistoryNavigation(cx: Scope) -> Element { - render! { - GoBackButton { - "Back to the Past" - } - GoForwardButton { - "Back to the Future" /* You see what I did there? πŸ˜‰ */ - } - } -} -// ANCHOR_END: history_buttons - -fn main() {} diff --git a/docs/router/examples/history_provider.rs b/docs/router/examples/history_provider.rs deleted file mode 100644 index 57ec27732..000000000 --- a/docs/router/examples/history_provider.rs +++ /dev/null @@ -1,29 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; -use dioxus_router::prelude::*; - -#[derive(Routable, Clone)] -enum Route { - #[route("/")] - Home {}, -} - -// ANCHOR: app -#[inline_props] -fn App(cx: Scope) -> Element { - render! { - Router:: { - config: || RouterConfig::default().history(WebHistory::default()) - } - } -} -// ANCHOR_END: app - -#[inline_props] -fn Home(cx: Scope) -> Element { - render! { - h1 { "Welcome to the Dioxus Blog!" } - } -} - -fn main() {} diff --git a/docs/router/examples/links.rs b/docs/router/examples/links.rs deleted file mode 100644 index 356e9c0a7..000000000 --- a/docs/router/examples/links.rs +++ /dev/null @@ -1,72 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; -use dioxus_router::prelude::*; - -// ANCHOR: router -#[derive(Routable, Clone)] -#[rustfmt::skip] -enum Route { - // All routes under the NavBar layout will be rendered inside of the NavBar Outlet - #[layout(NavBar)] - #[route("/")] - Home {}, - #[end_layout] - #[route("/:..route")] - PageNotFound { route: Vec }, -} -// ANCHOR_END: router - -// ANCHOR: nav -#[inline_props] -fn NavBar(cx: Scope) -> Element { - render! { - nav { - ul { - li { - Link { - // The Link component will navigate to the route specified - // in the target prop which is checked to exist at compile time - to: Route::Home {}, - "Home" - } - } - } - } - Outlet:: {} - } -} -// ANCHOR_END: nav - -// ANCHOR: app -#[inline_props] -fn App(cx: Scope) -> Element { - render! { - Router:: {} - } -} -// ANCHOR_END: app - -// ANCHOR: home -#[inline_props] -fn Home(cx: Scope) -> Element { - render! { - h1 { "Welcome to the Dioxus Blog!" } - } -} -// ANCHOR_END: home - -// ANCHOR: fallback -#[inline_props] -fn PageNotFound(cx: Scope, route: Vec) -> Element { - render! { - h1 { "Page not found" } - p { "We are terribly sorry, but the page you requested doesn't exist." } - pre { - color: "red", - "log:\nattemped to navigate to: {route:?}" - } - } -} -// ANCHOR_END: fallback - -fn main() {} diff --git a/docs/router/examples/navigator.rs b/docs/router/examples/navigator.rs deleted file mode 100644 index 9f32b7c12..000000000 --- a/docs/router/examples/navigator.rs +++ /dev/null @@ -1,56 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; -use dioxus_router::prelude::*; - -#[derive(Routable, Clone)] -#[rustfmt::skip] -enum Route { - #[route("/")] - Home {}, - #[route("/:..route")] - PageNotFound { route: Vec }, -} - -#[inline_props] -fn App(cx: Scope) -> Element { - render! { - Router:: {} - } -} - -// ANCHOR: nav -#[inline_props] -fn Home(cx: Scope) -> Element { - let nav = use_navigator(cx); - - // push - nav.push(Route::PageNotFound { route: vec![] }); - - // replace - nav.replace(Route::Home {}); - - // go back - nav.go_back(); - - // go forward - nav.go_forward(); - - render! { - h1 { "Welcome to the Dioxus Blog!" } - } -} -// ANCHOR_END: nav - -#[inline_props] -fn PageNotFound(cx: Scope, route: Vec) -> Element { - render! { - h1 { "Page not found" } - p { "We are terribly sorry, but the page you requested doesn't exist." } - pre { - color: "red", - "log:\nattemped to navigate to: {route:?}" - } - } -} - -fn main() {} diff --git a/docs/router/examples/nest.rs b/docs/router/examples/nest.rs deleted file mode 100644 index f7fe2137c..000000000 --- a/docs/router/examples/nest.rs +++ /dev/null @@ -1,40 +0,0 @@ -#![allow(non_snake_case, unused)] -use dioxus::prelude::*; -use dioxus_router::prelude::*; - -// ANCHOR: route -#[derive(Routable, Clone)] -// Skipping formatting allows you to indent nests -#[rustfmt::skip] -enum Route { - // Start the /blog nest - #[nest("/blog")] - // You can nest as many times as you want - #[nest("/:id")] - #[route("/post")] - PostId { - // You must include parent dynamic segments in child variants - id: usize, - }, - // End nests manually with #[end_nest] - #[end_nest] - #[route("/:id")] - // The absolute route of BlogPost is /blog/:name - BlogPost { - id: usize, - }, - // Or nests are ended automatically at the end of the enum -} - -#[inline_props] -fn BlogPost(cx: Scope, id: usize) -> Element { - todo!() -} - -#[inline_props] -fn PostId(cx: Scope, id: usize) -> Element { - todo!() -} -// ANCHOR_END: route - -fn main() {} diff --git a/docs/router/examples/nested_routes.rs b/docs/router/examples/nested_routes.rs deleted file mode 100644 index 63e080016..000000000 --- a/docs/router/examples/nested_routes.rs +++ /dev/null @@ -1,66 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; -use dioxus_router::prelude::*; - -// ANCHOR: router -#[derive(Routable, Clone)] -#[rustfmt::skip] -enum Route { - // All routes under the NavBar layout will be rendered inside of the NavBar Outlet - #[layout(NavBar)] - #[route("/")] - Home {}, - #[end_layout] - #[route("/:..route")] - PageNotFound { route: Vec }, -} -// ANCHOR_END: router - -// ANCHOR: nav -#[inline_props] -fn NavBar(cx: Scope) -> Element { - render! { - nav { - ul { - li { "links" } - } - } - // The Outlet component will render child routes (In this case just the Home component) inside the Outlet component - Outlet:: {} - } -} -// ANCHOR_END: nav - -// ANCHOR: app -#[inline_props] -fn App(cx: Scope) -> Element { - render! { - Router:: {} - } -} -// ANCHOR_END: app - -// ANCHOR: home -#[inline_props] -fn Home(cx: Scope) -> Element { - render! { - h1 { "Welcome to the Dioxus Blog!" } - } -} -// ANCHOR_END: home - -// ANCHOR: fallback -#[inline_props] -fn PageNotFound(cx: Scope, route: Vec) -> Element { - render! { - h1 { "Page not found" } - p { "We are terribly sorry, but the page you requested doesn't exist." } - pre { - color: "red", - "log:\nattemped to navigate to: {route:?}" - } - } -} -// ANCHOR_END: fallback - -fn main() {} diff --git a/docs/router/examples/outlet.rs b/docs/router/examples/outlet.rs deleted file mode 100644 index 5c7ee8dbf..000000000 --- a/docs/router/examples/outlet.rs +++ /dev/null @@ -1,46 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; -use dioxus_router::prelude::*; - -// ANCHOR: outlet -#[derive(Routable, Clone)] -#[rustfmt::skip] -enum Route { - #[layout(Wrapper)] - #[route("/")] - Index {}, -} - -#[inline_props] -fn Wrapper(cx: Scope) -> Element { - render! { - header { "header" } - // The index route will be rendered here - Outlet:: { } - footer { "footer" } - } -} - -#[inline_props] -fn Index(cx: Scope) -> Element { - render! { - h1 { "Index" } - } -} -// ANCHOR_END: outlet - -fn App(cx: Scope) -> Element { - render! { - Router:: {} - } -} - -fn main() { - let mut vdom = VirtualDom::new(App); - let _ = vdom.rebuild(); - let html = dioxus_ssr::render(&vdom); - assert_eq!( - html, - "
header

Index

footer
" - ); -} diff --git a/docs/router/examples/query_segments.rs b/docs/router/examples/query_segments.rs deleted file mode 100644 index 1f3c068ac..000000000 --- a/docs/router/examples/query_segments.rs +++ /dev/null @@ -1,24 +0,0 @@ -#![allow(non_snake_case, unused)] -use dioxus::prelude::*; -use dioxus_router::prelude::*; - -// ANCHOR: route -#[derive(Routable, Clone)] -#[rustfmt::skip] -enum Route { - // segments that start with ?: are query segments - #[route("/blog?:name")] - BlogPost { - // You must include query segments in child variants - name: String, - }, -} - -// Components must contain the same query segments as their corresponding variant -#[inline_props] -fn BlogPost(cx: Scope, name: String) -> Element { - todo!() -} -// ANCHOR_END: route - -fn main() {} diff --git a/docs/router/examples/router_cfg.rs b/docs/router/examples/router_cfg.rs deleted file mode 100644 index 5fd0402af..000000000 --- a/docs/router/examples/router_cfg.rs +++ /dev/null @@ -1,37 +0,0 @@ -// ANCHOR: router -#![allow(non_snake_case)] -use dioxus::prelude::*; -use dioxus_router::prelude::*; - -/// An enum of all of the possible routes in the app. -#[derive(Routable, Clone)] -enum Route { - // The home page is at the / route - #[route("/")] - // If the name of the component and variant are the same you can omit the component and props name - // #[route("/", ComponentName, PropsName)] - Home {}, -} -// ANCHOR_END: router - -// ANCHOR: app -#[inline_props] -fn App(cx: Scope) -> Element { - render! { - Router:: { - config: || RouterConfig::default().history(WebHistory::default()) - } - } -} -// ANCHOR_END: app - -// ANCHOR: home -#[inline_props] -fn Home(cx: Scope) -> Element { - render! { - h1 { "Welcome to the Dioxus Blog!" } - } -} -// ANCHOR_END: home - -fn main() {} diff --git a/docs/router/examples/routing_update.rs b/docs/router/examples/routing_update.rs deleted file mode 100644 index a7f83d633..000000000 --- a/docs/router/examples/routing_update.rs +++ /dev/null @@ -1,41 +0,0 @@ -#![allow(non_snake_case, unused)] -use dioxus::prelude::*; -use dioxus_router::prelude::*; - -// ANCHOR: router -#[derive(Routable, Clone, PartialEq)] -enum Route { - #[route("/")] - Index {}, - #[route("/home")] - Home {}, -} - -#[inline_props] -fn Home(cx: Scope) -> Element { - render! { - p { "Home" } - } -} - -#[inline_props] -fn Index(cx: Scope) -> Element { - render! { - p { "Index" } - } -} - -fn app(cx: Scope) -> Element { - render! { - Router:: { - config: || RouterConfig::default().on_update(|state|{ - (state.current() == Route::Index {}).then_some( - NavigationTarget::Internal(Route::Home {}) - ) - }) - } - } -} -// ANCHOR_END: router - -fn main() {} diff --git a/docs/router/examples/static_segments.rs b/docs/router/examples/static_segments.rs deleted file mode 100644 index 54c045765..000000000 --- a/docs/router/examples/static_segments.rs +++ /dev/null @@ -1,28 +0,0 @@ -#![allow(non_snake_case)] -use dioxus::prelude::*; -use dioxus_router::prelude::*; - -// ANCHOR: route -#[derive(Routable, Clone)] -#[rustfmt::skip] -enum Route { - // Routes always start with a slash - #[route("/")] - Home {}, - // You can have multiple segments in a route - #[route("/hello/world")] - HelloWorld {}, -} - -#[inline_props] -fn Home(cx: Scope) -> Element { - todo!() -} - -#[inline_props] -fn HelloWorld(cx: Scope) -> Element { - todo!() -} -// ANCHOR_END: route - -fn main() {} diff --git a/docs/router/src/SUMMARY.md b/docs/router/src/SUMMARY.md deleted file mode 100644 index 19ffb2ca7..000000000 --- a/docs/router/src/SUMMARY.md +++ /dev/null @@ -1,25 +0,0 @@ -# Summary - -[Introduction](./index.md) - -# Example Project - -- [Overview](./example/index.md) -- [Creating Our First Route](./example/first-route.md) -- [Building a Nest](./example/building-a-nest.md) -- [Navigation Targets](./example/navigation-targets.md) -- [Redirection Perfection](./example/redirection-perfection.md) -- [Full Code](./example/full-code.md) - -# Reference - -- [Adding the Router to Your Application](./reference/index.md) -- [Defining Routes](./reference/routes/index.md) - - [Nested Routes](./reference/routes/nested.md) -- [Layouts](./reference/layouts.md) -- [Navigation](./reference/navigation/index.md) - - [Programmatic Navigation](./reference/navigation/programmatic.md) -- [History Providers](./reference/history-providers.md) -- [History Buttons](./reference/history-buttons.md) -- [Static Generation](./reference/static-generation.md) -- [Routing Update Callback](./reference/routing-update-callback.md) diff --git a/docs/router/src/example/building-a-nest.md b/docs/router/src/example/building-a-nest.md deleted file mode 100644 index 426194f48..000000000 --- a/docs/router/src/example/building-a-nest.md +++ /dev/null @@ -1,99 +0,0 @@ -# Building a Nest - -In this chapter, we will begin to build the blog portion of our site which will -include links, nested routes, and route parameters. - -## Site Navigation - -Our site visitors won't know all the available pages and blogs on our site so we -should provide a navigation bar for them. Our navbar will be a list of links going between our pages. - -We want our navbar component to be rendered on several different pages on our site. Instead of duplicating the code, we can create a component that wraps all children routes. This is called a layout component. To tell the router where to render the child routes, we use the [`Outlet`] component. - -Let's create a new `NavBar` component: - -```rust, no_run -{{#include ../../examples/nested_routes.rs:nav}} -``` - -Next, let's add our `NavBar` component as a layout to our Route enum: - -```rust, no_run -{{#include ../../examples/nested_routes.rs:router}} -``` - -To add links to our `NavBar`, we could always use an HTML anchor element but that has two issues: - -1. It causes a full-page reload -2. We can accidentally link to a page that doesn't exist - -Instead, we want to use the [`Link`] component provided by Dioxus Router. - -The [`Link`] is similar to a regular `` tag. It takes a target and children. - -Unlike a regular `` tag, we can pass in our Route enum as the target. Because we annotated our routes with the [`route(path)`] attribute, the [`Link`] will know how to generate the correct URL. If we use the Route enum, the rust compiler will prevent us from linking to a page that doesn't exist. - -Let's add our links: - -```rust, no_run -{{#include ../../examples/links.rs:nav}} -``` - -> Using this method, the [`Link`] component only works for links within our -> application. To learn more about navigation targets see -> [here](./navigation-targets.md). - -Now you should see a list of links near the top of your page. Click on one and -you should seamlessly travel between pages. - -## URL Parameters and Nested Routes - -Many websites such as GitHub put parameters in their URL. For example, -`https://github.com/DioxusLabs` utilizes the text after the domain to -dynamically search and display content about an organization. - -We want to store our blogs in a database and load them as needed. We also -want our users to be able to send people a link to a specific blog post. -Instead of listing all of the blog titles at compile time, we can make a dynamic route. - -We could utilize a search page that loads a blog when clicked but then our users -won't be able to share our blogs easily. This is where URL parameters come in. - -The path to our blog will look like `/blog/myBlogPage`, `myBlogPage` being the -URL parameter. - -First, let's create a layout component (similar to the navbar) that wraps the blog content. This allows us to add a heading that tells the user they are on the blog. - -```rust, no_run -{{#include ../../examples/dynamic_route.rs:blog}} -``` - -Now we'll create another index component, that'll be displayed when no blog post -is selected: - -```rust, no_run -{{#include ../../examples/dynamic_route.rs:blog_list}} -``` - -We also need to create a component that displays an actual blog post. This component will accept the URL parameters as props: - -```rust, no_run -{{#include ../../examples/dynamic_route.rs:blog_post}} -``` - -Finally, let's tell our router about those components: - -```rust, no_run -{{#include ../../examples/dynamic_route.rs:router}} -``` - -That's it! If you head to `/blog/1` you should see our sample post. - -## Conclusion - -In this chapter, we utilized Dioxus Router's Link, and Route Parameter -functionality to build the blog portion of our application. In the next chapter, -we will go over how navigation targets (like the one we passed to our links) -work. - -[`Link`]: https://docs.rs/dioxus-router/latest/dioxus_router/prelude/fn.GenericLink.html diff --git a/docs/router/src/example/first-route.md b/docs/router/src/example/first-route.md deleted file mode 100644 index 5135f6a8f..000000000 --- a/docs/router/src/example/first-route.md +++ /dev/null @@ -1,62 +0,0 @@ -# Creating Our First Route - -In this chapter, we will start utilizing Dioxus Router and add a homepage and a -404 page to our project. - -## Fundamentals - -The core of the Dioxus Router is the [`Routable`] macro and the [`Router`] component. - -First, we need an actual page to route to! Let's add a homepage component: - -```rust, no_run -{{#include ../../examples/first_route.rs:home}} -``` - -## Creating Routes - -We want to use Dioxus Router to separate our application into different "pages". -Dioxus Router will then determine which page to render based on the URL path. - -To start using Dioxus Router, we need to use the [`Routable`] macro. - -The [`Routable`] macro takes an enum with all of the possible routes in our application. Each variant of the enum represents a route and must be annotated with the [`route(path)`] attribute. - -```rust, no_run -{{#include ../../examples/first_route.rs:router}} -``` - -All other hooks and components the router provides can only be used as a descendant of a [`Router`] component. - -If you head to your application's browser tab, you should now see the text -`Welcome to Dioxus Blog!` when on the root URL (`http://localhost:8080/`). If -you enter a different path for the URL, nothing should be displayed. - -This is because we told Dioxus Router to render the `Home` component only when -the URL path is `/`. - -## Fallback Route - -In our example, when a route doesn't exist Dioxus Router doesn't render anything. Many sites also have a "404" page when a path does not exist. Let's add one to our site. - -First, we create a new `PageNotFound` component. - -```rust, no_run -{{#include ../../examples/catch_all.rs:fallback}} -``` - -Next, register the route in the Route enum to match if all other routes fail. - -```rust, no_run -{{#include ../../examples/catch_all.rs:router}} -``` - -Now when you go to a route that doesn't exist, you should see the page not found -text. - -## Conclusion - -In this chapter, we learned how to create a route and tell Dioxus Router what -component to render when the URL path is `/`. We also created a 404 page to -handle when a route doesn't exist. Next, we'll create the blog portion of our -site. We will utilize nested routes and URL parameters. diff --git a/docs/router/src/example/full-code.md b/docs/router/src/example/full-code.md deleted file mode 100644 index ca97812a5..000000000 --- a/docs/router/src/example/full-code.md +++ /dev/null @@ -1,5 +0,0 @@ -# Full Code - -```rust, no_run -{{#include ../../examples/full_example.rs}} -``` diff --git a/docs/router/src/example/index.md b/docs/router/src/example/index.md deleted file mode 100644 index 064c9ac68..000000000 --- a/docs/router/src/example/index.md +++ /dev/null @@ -1,29 +0,0 @@ -# Overview - -In this guide, you'll learn to effectively use Dioxus Router whether you're -building a small todo app or the next FAANG company. We will create a small -website with a blog, homepage, and more! - -> To follow along with the router example, you'll need a working Dioxus app. -> Check out the [Dioxus book](https://dioxuslabs.com/docs/0.3/guide/en/) to get started. - -> Make sure to add Dioxus Router as a dependency, as explained in the -> [introduction](../index.md). - -## You'll learn how to - -- Create routes and render "pages". -- Utilize nested routes, create a navigation bar, and render content for a - set of routes. -- Parse URL parameters to dynamically display content. -- Redirect visitors to different routes. - -> **Disclaimer** -> -> The example will only display the features of Dioxus Router. It will not -> include any actual functionality. To keep things simple we will only be using -> a single file, this is not the recommended way of doing things with a real -> application. - -You can find the complete application in the [full code](./full-code.md) -chapter. diff --git a/docs/router/src/example/navigation-targets.md b/docs/router/src/example/navigation-targets.md deleted file mode 100644 index fb12f913f..000000000 --- a/docs/router/src/example/navigation-targets.md +++ /dev/null @@ -1,27 +0,0 @@ -# Navigation Targets - -In the previous chapter, we learned how to create links to pages within our app. -We told them where to go using the `target` property. This property takes something that can be converted to a [`NavigationTarget`]. - -## What is a navigation target? - -A [`NavigationTarget`] is similar to the `href` of an HTML anchor element. It -tells the router where to navigate to. The Dioxus Router knows two kinds of -navigation targets: - -- [`Internal`]: We used internal links in the previous chapter. It's a link to a page within our - app represented as a Route enum. -- [`External`]: This works exactly like an HTML anchors' `href`. Don't use this for in-app - navigation as it will trigger a page reload by the browser. - -## External navigation - -If we need a link to an external page we can do it like this: - -```rust, no_run -{{#include ../../examples/external_link.rs:component}} -``` - -[`External`]: https://docs.rs/dioxus-router-core/latest/dioxus_router/navigation/enum.NavigationTarget.html#variant.External -[`Internal`]: https://docs.rs/dioxus-router-core/latest/dioxus_router/navigation/enum.NavigationTarget.html#variant.Internal -[`NavigationTarget`]: https://docs.rs/dioxus-router-core/latest/dioxus_router/navigation/enum.NavigationTarget.html diff --git a/docs/router/src/example/redirection-perfection.md b/docs/router/src/example/redirection-perfection.md deleted file mode 100644 index 1ad4950ae..000000000 --- a/docs/router/src/example/redirection-perfection.md +++ /dev/null @@ -1,41 +0,0 @@ -# Redirection Perfection - -You're well on your way to becoming a routing master! - -In this chapter, we will cover creating redirects - -## Creating Redirects - -A redirect is very simple. When dioxus encounters a redirect while finding out -what components to render, it will redirect the user to the target of the -redirect. - -As a simple example, let's say you want user to still land on your blog, even -if they used the path `/myblog` or `/myblog/:name`. - -Redirects are special attributes in the router enum that accept a route and a closure -with the route parameters. The closure should return a route to redirect to. - -Let's add a redirect to our router enum: - -```rust, no_run -{{#include ../../examples/full_example.rs:router}} -``` - -That's it! Now your users will be redirected to the blog. - -### Conclusion - -Well done! You've completed the Dioxus Router guide. You've built a small -application and learned about the many things you can do with Dioxus Router. -To continue your journey, you attempt a challenge listed below, look at the [router examples](https://github.com/DioxusLabs/dioxus/tree/master/packages/router/examples), or -can check out the [API reference](https://docs.rs/dioxus-router/). - -### Challenges - -- Organize your components into separate files for better maintainability. -- Give your app some style if you haven't already. -- Build an about page so your visitors know who you are. -- Add a user system that uses URL parameters. -- Create a simple admin system to create, delete, and edit blogs. -- If you want to go to the max, hook up your application to a rest API and database. diff --git a/docs/router/src/index.md b/docs/router/src/index.md deleted file mode 100644 index 56a7d5deb..000000000 --- a/docs/router/src/index.md +++ /dev/null @@ -1,27 +0,0 @@ -# Introduction - -> If you are not familiar with Dioxus itself, check out the [Dioxus book](https://dioxuslabs.com/docs/0.3/guide/en/) first. - -Whether you are building a website, desktop app, or mobile app, -splitting your app's views into "pages" can be an effective method for -organization and maintainability. - -For this purpose, Dioxus provides a router. Use the `cargo add` command to add the dependency: - -```sh -cargo add dioxus-router -``` - -This book is intended to get you up to speed with Dioxus Router. It is split -into two sections: - -1. The [reference](./reference/index.md) section explains individual features in - depth. You can read it from start to finish, or you can read individual chapters - in whatever order you want. -2. If you prefer a learning-by-doing approach, you can check out the - _[example project](./example/index.md)_. It guides you through - creating a dioxus app, setting up the router, and using some of its - functionality. - -> Please note that this is not the only documentation for the Dioxus Router. You -> can also check out the [API Docs](https://docs.rs/dioxus-router/). diff --git a/docs/router/src/lib.rs b/docs/router/src/lib.rs deleted file mode 100644 index 97cda56a8..000000000 --- a/docs/router/src/lib.rs +++ /dev/null @@ -1 +0,0 @@ -// empty (we only need this crate for the examples) diff --git a/docs/router/src/reference/history-buttons.md b/docs/router/src/reference/history-buttons.md deleted file mode 100644 index ad3ffbe22..000000000 --- a/docs/router/src/reference/history-buttons.md +++ /dev/null @@ -1,32 +0,0 @@ -# History Buttons - -Some platforms, like web browsers, provide users with an easy way to navigate -through an app's history. They have UI elements or integrate with the OS. - -However, native platforms usually don't provide such amenities, which means that -apps wanting users to have access to them, need to implement them. For this -reason, the router comes with two components, which emulate a browser's back and -forward buttons: - -- [`GoBackButton`](https://docs.rs/dioxus-router/latest/dioxus_router/components/fn.GoBackButton.html) -- [`GoForwardButton`](https://docs.rs/dioxus-router/latest/dioxus_router/components/fn.GoForwardButton.html) - -> If you want to navigate through the history programmatically, take a look at -> [`programmatic navigation`](./navigation/programmatic.md). - -```rust, no_run -{{#include ../../examples/history_buttons.rs:history_buttons}} -``` - -As you might know, browsers usually disable the back and forward buttons if -there is no history to navigate to. The router's history buttons try to do that -too, but depending on the [history provider] that might not be possible. - -Importantly, neither [`WebHistory`] supports that feature. -This is due to limitations of the browser History API. - -However, in both cases, the router will just ignore button presses, if there is -no history to navigate to. - -Also, when using [`WebHistory`], the history buttons might -navigate a user to a history entry outside your app. diff --git a/docs/router/src/reference/history-providers.md b/docs/router/src/reference/history-providers.md deleted file mode 100644 index 6ee11b20f..000000000 --- a/docs/router/src/reference/history-providers.md +++ /dev/null @@ -1,20 +0,0 @@ -# History Providers - -[`HistoryProvider`]s are used by the router to keep track of the navigation history -and update any external state (e.g. the browser's URL). - -The router provides two [`HistoryProvider`]s, but you can also create your own. -The two default implementations are: - -- The [`MemoryHistory`] is a custom implementation that works in memory. -- The [`WebHistory`] integrates with the browser's URL. - -By default, the router uses the [`MemoryHistory`]. It might be changed to use -[`WebHistory`] when the `web` feature is active, but that is not guaranteed. - -You can override the default history: - -```rust, no_run -{{#include ../../examples/history_provider.rs:app}} -``` - diff --git a/docs/router/src/reference/index.md b/docs/router/src/reference/index.md deleted file mode 100644 index add681671..000000000 --- a/docs/router/src/reference/index.md +++ /dev/null @@ -1,23 +0,0 @@ -# Adding the Router to Your Application - -In this chapter, we will learn how to add the router to our app. By itself, this -is not very useful. However, it is a prerequisite for all the functionality -described in the other chapters. - -> Make sure you added the `dioxus-router` dependency as explained in the -> [introduction](../index.md). - -In most cases, we want to add the router to the root component of our app. This -way, we can ensure that we have access to all its functionality everywhere. - -First, we define the router with the router macro: - -```rust, no_run -{{#include ../../examples/first_route.rs:router}} -``` - -Then we render the router with the [`Router`] component. - -```rust, no_run -{{#include ../../examples/first_route.rs:app}} -``` diff --git a/docs/router/src/reference/layouts.md b/docs/router/src/reference/layouts.md deleted file mode 100644 index 525838fb0..000000000 --- a/docs/router/src/reference/layouts.md +++ /dev/null @@ -1,19 +0,0 @@ -# Layouts - -Layouts allow you to wrap all child routes in a component. This can be useful when creating something like a header that will be used in many different routes. - -[`Outlet`] tells the router where to render content in layouts. In the following example, -the Index will be rendered within the [`Outlet`]. - -```rust, no_run -{{#include ../../examples/outlet.rs:outlet}} -``` - -The example above will output the following HTML (line breaks added for -readability): - -```html -
header
-

Index

-
footer
-``` diff --git a/docs/router/src/reference/navigation/index.md b/docs/router/src/reference/navigation/index.md deleted file mode 100644 index 2abf8477e..000000000 --- a/docs/router/src/reference/navigation/index.md +++ /dev/null @@ -1,39 +0,0 @@ -# Links & Navigation - -When we split our app into pages, we need to provide our users with a way to -navigate between them. On regular web pages, we'd use an anchor element for that, -like this: - -```html -Link to an other page -``` - -However, we cannot do that when using the router for three reasons: - -1. Anchor tags make the browser load a new page from the server. This takes a - lot of time, and it is much faster to let the router handle the navigation - client-side. -2. Navigation using anchor tags only works when the app is running inside a - browser. This means we cannot use them inside apps using Dioxus Desktop. -3. Anchor tags cannot check if the target page exists. This means we cannot - prevent accidentally linking to non-existent pages. - -To solve these problems, the router provides us with a [`Link`] component we can -use like this: - -```rust, no_run -{{#include ../../../examples/links.rs:nav}} -``` - -The `target` in the example above is similar to the `href` of a regular anchor -element. However, it tells the router more about what kind of navigation it -should perform. It accepts something that can be converted into a -[`NavigationTarget`]: - -- The example uses a Internal route. This is the most common type of navigation. - It tells the router to navigate to a page within our app by passing a variant of a [`Routable`] enum. This type of navigation can never fail if the link component is used inside a router component. -- [`External`] allows us to navigate to URLs outside of our app. This is useful - for links to external websites. NavigationTarget::External accepts an URL to navigate to. This type of navigation can fail if the URL is invalid. - -> The [`Link`] accepts several props that modify its behavior. See the API docs -> for more details. diff --git a/docs/router/src/reference/navigation/programmatic.md b/docs/router/src/reference/navigation/programmatic.md deleted file mode 100644 index 894dd968e..000000000 --- a/docs/router/src/reference/navigation/programmatic.md +++ /dev/null @@ -1,32 +0,0 @@ -# Programmatic Navigation - -Sometimes we want our application to navigate to another page without having the -user click on a link. This is called programmatic navigation. - -## Using a Navigator - -We can get a navigator with the [`use_navigator`] hook. This hook returns a [`Navigator`]. - -We can use the [`Navigator`] to trigger four different kinds of navigation: - -- `push` will navigate to the target. It works like a regular anchor tag. -- `replace` works like `push`, except that it replaces the current history entry - instead of adding a new one. This means the prior page cannot be restored with the browser's back button. -- `Go back` works like the browser's back button. -- `Go forward` works like the browser's forward button. - -```rust, no_run -{{#include ../../../examples/navigator.rs:nav}} -``` - -You might have noticed that, like [`Link`], the [`Navigator`]s `push` and -`replace` functions take a [`NavigationTarget`]. This means we can use either -[`Internal`], or [`External`] targets. - -## External Navigation Targets - -Unlike a [`Link`], the [`Navigator`] cannot rely on the browser (or webview) to -handle navigation to external targets via a generated anchor element. - -This means, that under certain conditions, navigation to external targets can -fail. diff --git a/docs/router/src/reference/redirects.md b/docs/router/src/reference/redirects.md deleted file mode 100644 index 70ea4d7cd..000000000 --- a/docs/router/src/reference/redirects.md +++ /dev/null @@ -1,13 +0,0 @@ -# Redirects - -In some cases, we may want to redirect our users to another page whenever they -open a specific path. We can tell the router to do this with the `#[redirect]` -attribute. - -The `#[redirect]` attribute accepts a route and a closure with all of the parameters defined in the route. The closure must return a [`NavigationTarget`]. - -In the following example, we will redirect everybody from `/myblog` and `/myblog/:id` to `/blog` and `/blog/:id` respectively - -```rust, no_run -{{#include ../../examples/full_example.rs:router}} -``` diff --git a/docs/router/src/reference/routes/index.md b/docs/router/src/reference/routes/index.md deleted file mode 100644 index 7cd0fe9e5..000000000 --- a/docs/router/src/reference/routes/index.md +++ /dev/null @@ -1,65 +0,0 @@ -# Defining Routes - -When creating a [`Routable`] enum, we can define routes for our application using the `route("path")` attribute. - -## Route Segments - -Each route is made up of segments. Most segments are separated by `/` characters in the path. - -There are four fundamental types of segments: - -1. [Static segments](#static-segments) are fixed strings that must be present in the path. -2. [Dynamic segments](#dynamic-segments) are types that can be parsed from a segment. -3. [Catch-all segments](#catch-all-segments) are types that can be parsed from multiple segments. -4. [Query segments](#query-segments) are types that can be parsed from the query string. - -Routes are matched: - -- First, from most specific to least specific (Static then Dynamic then Catch All) (Query is always matched) -- Then, if multiple routes match the same path, the order in which they are defined in the enum is followed. - -## Static segments - -Fixed routes match a specific path. For example, the route `#[route("/about")]` will match the path `/about`. - -```rust, no_run -{{#include ../../../examples/static_segments.rs:route}} -``` - -## Dynamic Segments - -Dynamic segments are in the form of `:name` where `name` is -the name of the field in the route variant. If the segment is parsed -successfully then the route matches, otherwise the matching continues. - -The segment can be of any type that implements `FromStr`. - -```rust, no_run -{{#include ../../../examples/dynamic_segments.rs:route}} -``` - -## Catch All Segments - -Catch All segments are in the form of `:...name` where `name` is the name of the field in the route variant. If the segments are parsed successfully then the route matches, otherwise the matching continues. - -The segment can be of any type that implements `FromSegments`. (Vec implements this by default) - -Catch All segments must be the _last route segment_ in the path (query segments are not counted) and cannot be included in nests. - -```rust, no_run -{{#include ../../../examples/catch_all_segments.rs:route}} -``` - -## Query Segments - -Query segments are in the form of `?:name` where `name` is the name of the field in the route variant. - -Unlike [Dynamic Segments](#dynamic-segments) and [Catch All Segments](#catch-all-segments), parsing a Query segment must not fail. - -The segment can be of any type that implements `FromQuery`. - -Query segments must be the _after all route segments_ and cannot be included in nests. - -```rust, no_run -{{#include ../../../examples/query_segments.rs:route}} -``` diff --git a/docs/router/src/reference/routes/nested.md b/docs/router/src/reference/routes/nested.md deleted file mode 100644 index 4860fbb0d..000000000 --- a/docs/router/src/reference/routes/nested.md +++ /dev/null @@ -1,39 +0,0 @@ -# Nested Routes - -When developing bigger applications we often want to nest routes within each -other. As an example, we might want to organize a settings menu using this -pattern: - -```plain -β”” Settings - β”œ General Settings (displayed when opening the settings) - β”œ Change Password - β”” Privacy Settings -``` - -We might want to map this structure to these paths and components: - -```plain -/settings -> Settings { GeneralSettings } -/settings/password -> Settings { PWSettings } -/settings/privacy -> Settings { PrivacySettings } -``` - -Nested routes allow us to do this without repeating /settings in every route. - -## Nesting - -To nest routes, we use the `#[nest("path")]` and `#[end_nest]` attributes. - -The path in nest must not: - -1. Contain a [Catch All Segment](index.md#catch-all-segments) -2. Contain a [Query Segment](index.md#query-segments) - -If you define a dynamic segment in a nest, it will be available to all child routes and layouts. - -To finish a nest, we use the `#[end_nest]` attribute or the end of the enum. - -```rust, no_run -{{#include ../../../examples/nest.rs:route}} -``` diff --git a/docs/router/src/reference/routing-update-callback.md b/docs/router/src/reference/routing-update-callback.md deleted file mode 100644 index f4fdb9a99..000000000 --- a/docs/router/src/reference/routing-update-callback.md +++ /dev/null @@ -1,25 +0,0 @@ -# Routing Update Callback - -In some cases, we might want to run custom code when the current route changes. -For this reason, the [`RouterConfig`] exposes an `on_update` field. - -## How does the callback behave? - -The `on_update` is called whenever the current routing information changes. It -is called after the router updated its internal state, but before dependent components and hooks are updated. - -If the callback returns a [`NavigationTarget`], the router will replace the -current location with the specified target. It will not call the -`on_update` again. - -If at any point the router encounters a -[navigation failure](./failures/index.md), it will go to the appropriate state -without calling the `on_update`. It doesn't matter if the invalid target -initiated the navigation, was found as a redirect target, or was returned by the -`on_update` itself. - -## Code Example - -```rust, no_run -{{#include ../../examples/routing_update.rs:router}} -``` diff --git a/docs/router/src/reference/static-generation.md b/docs/router/src/reference/static-generation.md deleted file mode 100644 index c43f9fe4b..000000000 --- a/docs/router/src/reference/static-generation.md +++ /dev/null @@ -1,15 +0,0 @@ -# Static Generation - -## Getting the Sitemap - -The [`Routable`] trait includes an associated [`SITE_MAP`] constant that contains the map of all of the routes in the enum. - -By default, the sitemap is a tree of (static or dynamic) RouteTypes, but it can be flattened into a list of individual routes with the `.flatten()` method. - -## Generating a Sitemap - -To statically render pages, we need to flatten the route tree and generate a file for each route that contains only static segments: - -```rust, no_run -{{#include ../../../../packages/router/examples/static_generation.rs}} -``` diff --git a/examples/crm.rs b/examples/crm.rs index f3da8ab7a..d2cd98118 100644 --- a/examples/crm.rs +++ b/examples/crm.rs @@ -1,5 +1,4 @@ //! Tiny CRM: A port of the Yew CRM example to Dioxus. -#![allow(non_snake_case)] use dioxus::prelude::*; use dioxus_router::prelude::*; @@ -27,6 +26,7 @@ pub struct Client { type ClientContext = Vec; +#[component] fn App(cx: Scope) -> Element { use_shared_state_provider::(cx, Default::default); @@ -50,7 +50,7 @@ fn App(cx: Scope) -> Element { } } -#[inline_props] +#[component] fn ClientList(cx: Scope) -> Element { let clients = use_shared_state::(cx).unwrap(); @@ -80,7 +80,7 @@ fn ClientList(cx: Scope) -> Element { }) } -#[inline_props] +#[component] fn ClientAdd(cx: Scope) -> Element { let clients = use_shared_state::(cx).unwrap(); let first_name = use_state(cx, String::new); @@ -173,7 +173,7 @@ fn ClientAdd(cx: Scope) -> Element { }) } -#[inline_props] +#[component] fn Settings(cx: Scope) -> Element { let clients = use_shared_state::(cx).unwrap(); diff --git a/examples/dog_app.rs b/examples/dog_app.rs index 243e4bbca..66a3c615c 100644 --- a/examples/dog_app.rs +++ b/examples/dog_app.rs @@ -2,7 +2,7 @@ use dioxus::prelude::*; use std::collections::HashMap; fn main() { - dioxus_desktop::launch(|cx| render!(app_root {})); + dioxus_desktop::launch(|cx| render!(AppRoot {})); } #[derive(Debug, Clone, PartialEq, serde::Deserialize)] @@ -10,7 +10,8 @@ struct ListBreeds { message: HashMap>, } -fn app_root(cx: Scope<'_>) -> Element { +#[component] +fn AppRoot(cx: Scope<'_>) -> Element { let breed = use_state(cx, || "deerhound".to_string()); let breeds = use_future!(cx, || async move { @@ -36,7 +37,7 @@ fn app_root(cx: Scope<'_>) -> Element { } } } - div { flex: "50%", breed_pic { breed: breed.to_string() } } + div { flex: "50%", BreedPic { breed: breed.to_string() } } } } }), @@ -49,8 +50,8 @@ struct DogApi { message: String, } -#[inline_props] -fn breed_pic(cx: Scope, breed: String) -> Element { +#[component] +fn BreedPic(cx: Scope, breed: String) -> Element { let fut = use_future!(cx, |breed| async move { reqwest::get(format!("https://dog.ceo/api/breed/{breed}/images/random")) .await diff --git a/examples/error_handle.rs b/examples/error_handle.rs index b4a6dbb05..d1fb57933 100644 --- a/examples/error_handle.rs +++ b/examples/error_handle.rs @@ -1,10 +1,11 @@ use dioxus::prelude::*; fn main() { - dioxus_desktop::launch(app); + dioxus_desktop::launch(App); } -fn app(cx: Scope) -> Element { +#[component] +fn App(cx: Scope) -> Element { let val = use_state(cx, || "0.0001"); let num = match val.parse::() { @@ -19,13 +20,13 @@ fn app(cx: Scope) -> Element { "Set an invalid number" } (0..5).map(|i| rsx! { - demo_c { x: i } + DemoC { x: i } }) }) } -#[inline_props] -fn demo_c(cx: Scope, x: i32) -> Element { +#[component] +fn DemoC(cx: Scope, x: i32) -> Element { cx.render(rsx! { h1 { "asdasdasdasd {x}" diff --git a/examples/flat_router.rs b/examples/flat_router.rs index b8e3d6425..ec6e2f417 100644 --- a/examples/flat_router.rs +++ b/examples/flat_router.rs @@ -1,5 +1,3 @@ -#![allow(non_snake_case)] - use dioxus::prelude::*; use dioxus_desktop::{tao::dpi::LogicalSize, Config, WindowBuilder}; use dioxus_router::prelude::*; @@ -13,10 +11,11 @@ fn main() { .with_resizable(false), ); - dioxus_desktop::launch_cfg(app, cfg) + dioxus_desktop::launch_cfg(App, cfg) } -fn app(cx: Scope) -> Element { +#[component] +fn App(cx: Scope) -> Element { render! { Router:: {} } @@ -36,7 +35,7 @@ enum Route { Settings {}, } -#[inline_props] +#[component] fn Footer(cx: Scope) -> Element { render! { div { @@ -58,22 +57,22 @@ fn Footer(cx: Scope) -> Element { } } -#[inline_props] +#[component] fn Home(cx: Scope) -> Element { render!("Home") } -#[inline_props] +#[component] fn Games(cx: Scope) -> Element { render!("Games") } -#[inline_props] +#[component] fn Play(cx: Scope) -> Element { render!("Play") } -#[inline_props] +#[component] fn Settings(cx: Scope) -> Element { render!("Settings") } diff --git a/examples/inlineprops.rs b/examples/inlineprops.rs index 8c626d346..6d5534064 100644 --- a/examples/inlineprops.rs +++ b/examples/inlineprops.rs @@ -1,33 +1,35 @@ -//! Run with `cargo-expand` to see what each one expands to -#![allow(non_snake_case)] - +//! Run with `cargo-expand` to see what each one expands to. +//! This file is named `inlineprops.rs`, because there used to be a `#[inline_props]` macro to +//! do this. However, it's now deprecated (and will likely be removed in a future major version), +//! so please use `#[component]` instead! use dioxus::prelude::*; -#[inline_props] +#[component] fn Thing1(cx: Scope, _a: T) -> Element { cx.render(rsx! { "" }) } -#[inline_props] +#[component] fn Thing2(cx: Scope, _a: u32) -> Element<'a> { cx.render(rsx! { "" }) } -#[inline_props] +#[component] fn Thing3<'a, T>(cx: Scope<'a>, _a: &'a T) -> Element<'a> { cx.render(rsx! { "" }) } -#[inline_props] +#[component] fn Thing4<'a>(cx: Scope<'a>, _a: &'a u32) -> Element<'a> { cx.render(rsx! { "" }) } fn main() { - dioxus_desktop::launch(app); + dioxus_desktop::launch(App); } -fn app(cx: Scope) -> Element { +#[component] +fn App(cx: Scope) -> Element { let state = use_state(cx, || 1); cx.render(rsx! { diff --git a/examples/link.rs b/examples/link.rs index c66b1abd1..726fe3d79 100644 --- a/examples/link.rs +++ b/examples/link.rs @@ -1,13 +1,12 @@ -#![allow(non_snake_case)] - use dioxus::prelude::*; use dioxus_router::prelude::*; fn main() { - dioxus_desktop::launch(app); + dioxus_desktop::launch(App); } -fn app(cx: Scope) -> Element { +#[component] +fn App(cx: Scope) -> Element { cx.render(rsx! ( div { p { @@ -38,7 +37,7 @@ enum Route { Settings {}, } -#[inline_props] +#[component] fn Header(cx: Scope) -> Element { render! { h1 { "Your app here" } @@ -50,12 +49,12 @@ fn Header(cx: Scope) -> Element { } } -#[inline_props] +#[component] fn Home(cx: Scope) -> Element { render!(h1 { "Home" }) } -#[inline_props] +#[component] fn Settings(cx: Scope) -> Element { render!(h1 { "Settings" }) } diff --git a/examples/query_segments_demo/src/main.rs b/examples/query_segments_demo/src/main.rs index 2348f1fe5..d9f5f83ef 100644 --- a/examples/query_segments_demo/src/main.rs +++ b/examples/query_segments_demo/src/main.rs @@ -1,4 +1,4 @@ -#![allow(non_snake_case, unused)] +#![allow(unused)] //! Example: Url query segments usage //! ------------------------------------ //! @@ -56,7 +56,7 @@ impl FromQuery for BlogQuerySegments { } } -#[inline_props] +#[component] fn BlogPost(cx: Scope, query_params: BlogQuerySegments) -> Element { render! { div{"This is your blogpost with a query segment:"} @@ -64,6 +64,7 @@ fn BlogPost(cx: Scope, query_params: BlogQuerySegments) -> Element { } } +#[component] fn App(cx: Scope) -> Element { render! { Router::{} } } diff --git a/examples/router.rs b/examples/router.rs index ed7fbefa4..d00c747b9 100644 --- a/examples/router.rs +++ b/examples/router.rs @@ -1,5 +1,3 @@ -#![allow(non_snake_case)] - use dioxus::prelude::*; use dioxus_router::prelude::*; @@ -37,12 +35,14 @@ enum Route { } // ANCHOR_END: router +#[component] fn App(cx: Scope) -> Element { render! { Router:: {} } } +#[component] fn NavBar(cx: Scope) -> Element { render! { nav { @@ -55,12 +55,14 @@ fn NavBar(cx: Scope) -> Element { } } +#[component] fn Home(cx: Scope) -> Element { render! { h1 { "Welcome to the Dioxus Blog!" } } } +#[component] fn Blog(cx: Scope) -> Element { render! { h1 { "Blog" } @@ -68,6 +70,7 @@ fn Blog(cx: Scope) -> Element { } } +#[component] fn BlogList(cx: Scope) -> Element { render! { h2 { "Choose a post" } @@ -88,14 +91,14 @@ fn BlogList(cx: Scope) -> Element { } } -#[inline_props] +#[component] fn BlogPost(cx: Scope, name: String) -> Element { render! { h2 { "Blog Post: {name}"} } } -#[inline_props] +#[component] fn PageNotFound(cx: Scope, route: Vec) -> Element { render! { h1 { "Page not found" } diff --git a/examples/rsx_usage.rs b/examples/rsx_usage.rs index d5e2fcdb3..f9ecb4939 100644 --- a/examples/rsx_usage.rs +++ b/examples/rsx_usage.rs @@ -1,4 +1,3 @@ -#![allow(non_snake_case)] //! A tour of the rsx! macro //! ------------------------ //! @@ -40,7 +39,7 @@ //! - Allow top-level fragments fn main() { - dioxus_desktop::launch(app); + dioxus_desktop::launch(App); } use core::{fmt, str::FromStr}; @@ -49,7 +48,8 @@ use std::fmt::Display; use baller::Baller; use dioxus::prelude::*; -fn app(cx: Scope) -> Element { +#[component] +fn App(cx: Scope) -> Element { let formatting = "formatting!"; let formatting_tuple = ("a", "b"); let lazy_fmt = format_args!("lazily formatted text"); @@ -217,12 +217,16 @@ fn format_dollars(dollars: u32, cents: u32) -> String { format!("${dollars}.{cents:02}") } -fn helper<'a>(cx: &'a ScopeState, text: &str) -> Element<'a> { +fn helper<'a>(cx: &'a ScopeState, text: &'a str) -> Element<'a> { cx.render(rsx! { p { "{text}" } }) } +// no_case_check disables PascalCase checking if you *really* want a snake_case component. +// This will likely be deprecated/removed in a future update that will introduce a more polished linting system, +// something like Clippy. +#[component(no_case_check)] fn lowercase_helper(cx: Scope) -> Element { cx.render(rsx! { "asd" @@ -234,12 +238,16 @@ mod baller { #[derive(Props, PartialEq, Eq)] pub struct BallerProps {} - #[allow(non_snake_case)] + #[component] /// This component totally balls - pub fn Baller(_: Scope) -> Element { + pub fn Baller(_cx: Scope) -> Element { todo!() } + // no_case_check disables PascalCase checking if you *really* want a snake_case component. + // This will likely be deprecated/removed in a future update that will introduce a more polished linting system, + // something like Clippy. + #[component(no_case_check)] pub fn lowercase_component(cx: Scope) -> Element { cx.render(rsx! { "look ma, no uppercase" }) } @@ -253,7 +261,7 @@ pub struct TallerProps<'a> { } /// Documention for this component is visible within the rsx macro -#[allow(non_snake_case)] +#[component] pub fn Taller<'a>(cx: Scope<'a, TallerProps<'a>>) -> Element { cx.render(rsx! { &cx.props.children @@ -275,15 +283,14 @@ where todo!() } -#[inline_props] +#[component] fn WithInline<'a>(cx: Scope<'a>, text: &'a str) -> Element { cx.render(rsx! { p { "{text}" } }) } -// generic component with inline_props too -#[inline_props] +#[component] fn Label(cx: Scope, text: T) -> Element where T: Display, diff --git a/examples/shared_state.rs b/examples/shared_state.rs index d129f75d1..37271f160 100644 --- a/examples/shared_state.rs +++ b/examples/shared_state.rs @@ -1,5 +1,3 @@ -#![allow(non_snake_case)] - use std::collections::HashMap; use dioxus::prelude::*; @@ -27,6 +25,7 @@ impl CoolData { } } +#[component] #[rustfmt::skip] pub fn App(cx: Scope) -> Element { use_shared_state_provider(cx, || CoolData::new(HashMap::from([ @@ -50,7 +49,7 @@ pub fn App(cx: Scope) -> Element { ) } -#[inline_props] +#[component] fn DataEditor(cx: Scope, id: usize) -> Element { let cool_data = use_shared_state::(cx).unwrap().read(); @@ -61,7 +60,7 @@ fn DataEditor(cx: Scope, id: usize) -> Element { }) } -#[inline_props] +#[component] fn DataView(cx: Scope, id: usize) -> Element { let cool_data = use_shared_state::(cx).unwrap(); diff --git a/examples/simple_desktop.rs b/examples/simple_desktop.rs index 374b58a4e..4eac5e3a9 100644 --- a/examples/simple_desktop.rs +++ b/examples/simple_desktop.rs @@ -9,10 +9,11 @@ fn main() { .with_module_level("dioxus", log::LevelFilter::Trace) .init() .unwrap(); - dioxus_desktop::launch(app); + dioxus_desktop::launch(App); } -fn app(cx: Scope) -> Element { +#[component] +fn App(cx: Scope) -> Element { render! { Router:: {} } @@ -36,7 +37,7 @@ enum Route { Oranges {}, } -#[inline_props] +#[component] fn NavBar(cx: Scope) -> Element { render! { h1 { "Your app here" } @@ -51,19 +52,19 @@ fn NavBar(cx: Scope) -> Element { } } -#[inline_props] +#[component] fn Home(cx: Scope) -> Element { log::debug!("rendering home {:?}", cx.scope_id()); render! { h1 { "Home" } } } -#[inline_props] +#[component] fn BlogList(cx: Scope) -> Element { log::debug!("rendering blog list {:?}", cx.scope_id()); render! { div { "Blog List" } } } -#[inline_props] +#[component] fn BlogPost(cx: Scope, post: String) -> Element { log::debug!("rendering blog post {}", post); @@ -75,7 +76,7 @@ fn BlogPost(cx: Scope, post: String) -> Element { } } -#[inline_props] +#[component] fn Oranges(cx: Scope) -> Element { render!("Oranges are not apples!") } diff --git a/examples/simple_router.rs b/examples/simple_router.rs index 0604558a1..7ed55885e 100644 --- a/examples/simple_router.rs +++ b/examples/simple_router.rs @@ -12,12 +12,12 @@ enum Route { Blog { id: String }, } -#[inline_props] +#[component] fn Homepage(cx: Scope) -> Element { render! { h1 { "Welcome home" } } } -#[inline_props] +#[component] fn Blog(cx: Scope, id: String) -> Element { render! { h1 { "How to make: " } @@ -25,7 +25,7 @@ fn Blog(cx: Scope, id: String) -> Element { } } -#[inline_props] +#[component] fn Nav(cx: Scope) -> Element { render! { nav { diff --git a/packages/autofmt/README.md b/packages/autofmt/README.md index bd934f2c7..0b13dc7a9 100644 --- a/packages/autofmt/README.md +++ b/packages/autofmt/README.md @@ -1,6 +1,5 @@ # dioxus-autofmt - [![Crates.io][crates-badge]][crates-url] [![MIT licensed][mit-badge]][mit-url] [![Build Status][actions-badge]][actions-url] @@ -8,38 +7,33 @@ [crates-badge]: https://img.shields.io/crates/v/dioxus-autofmt.svg [crates-url]: https://crates.io/crates/dioxus-autofmt - [mit-badge]: https://img.shields.io/badge/license-MIT-blue.svg [mit-url]: https://github.com/dioxuslabs/dioxus/blob/master/LICENSE - [actions-badge]: https://github.com/dioxuslabs/dioxus/actions/workflows/main.yml/badge.svg [actions-url]: https://github.com/dioxuslabs/dioxus/actions?query=workflow%3ACI+branch%3Amaster - [discord-badge]: https://img.shields.io/discord/899851952891002890.svg?logo=discord&style=flat-square [discord-url]: https://discord.gg/XgGxMSkvUM [Website](https://dioxuslabs.com) | -[Guides](https://dioxuslabs.com/docs/0.3/guide/en/) | +[Guides](https://dioxuslabs.com/learn/0.4/) | [API Docs](https://docs.rs/dioxus-autofmt/latest/dioxus_autofmt) | [Chat](https://discord.gg/XgGxMSkvUM) - ## Overview `dioxus-autofmt` provides a pretty printer for the `rsx` syntax tree. - This is done manually with a via set of formatting rules. The output is not guaranteed to be stable between minor versions of the crate as we might tweak the output. `dioxus-autofmt` provides an API to perform precision edits as well as just spit out a block of formatted RSX from any RSX syntax tree. This is used by the `rsx-rosetta` crate which can accept various input languages and output valid RSX. - ## Contributing - Report issues on our [issue tracker](https://github.com/dioxuslabs/dioxus/issues). - Join the discord and ask questions! ## License + This project is licensed under the [MIT license]. [mit license]: https://github.com/DioxusLabs/dioxus/blob/master/LICENSE-MIT diff --git a/packages/autofmt/tests/samples/long.rsx b/packages/autofmt/tests/samples/long.rsx index c5ace9cc3..1bda8a006 100644 --- a/packages/autofmt/tests/samples/long.rsx +++ b/packages/autofmt/tests/samples/long.rsx @@ -1,6 +1,6 @@ use dioxus::prelude::*; -#[inline_props] +#[component] pub fn Explainer<'a>( cx: Scope<'a>, invert: bool, diff --git a/packages/check/README.md b/packages/check/README.md index 512eb579a..0bb6ce0a4 100644 --- a/packages/check/README.md +++ b/packages/check/README.md @@ -1,6 +1,5 @@ # dioxus-check - [![Crates.io][crates-badge]][crates-url] [![MIT licensed][mit-badge]][mit-url] [![Build Status][actions-badge]][actions-url] @@ -8,25 +7,21 @@ [crates-badge]: https://img.shields.io/crates/v/dioxus-autofmt.svg [crates-url]: https://crates.io/crates/dioxus-autofmt - [mit-badge]: https://img.shields.io/badge/license-MIT-blue.svg [mit-url]: https://github.com/dioxuslabs/dioxus/blob/master/LICENSE - [actions-badge]: https://github.com/dioxuslabs/dioxus/actions/workflows/main.yml/badge.svg [actions-url]: https://github.com/dioxuslabs/dioxus/actions?query=workflow%3ACI+branch%3Amaster - [discord-badge]: https://img.shields.io/discord/899851952891002890.svg?logo=discord&style=flat-square [discord-url]: https://discord.gg/XgGxMSkvUM [Website](https://dioxuslabs.com) | -[Guides](https://dioxuslabs.com/docs/0.3/guide/en/) | +[Guides](https://dioxuslabs.com/learn/0.4/) | [API Docs](https://docs.rs/dioxus-autofmt/latest/dioxus_autofmt) | [Chat](https://discord.gg/XgGxMSkvUM) - ## Overview -`dioxus-check` analyzes Dioxus source code and reports errors and warnings. Primarily, it enforces the [Rules of Hooks](https://dioxuslabs.com/docs/0.3/guide/en/interactivity/hooks.html#no-hooks-in-conditionals). +`dioxus-check` analyzes Dioxus source code and reports errors and warnings. Primarily, it enforces the [Rules of Hooks](https://dioxuslabs.com/learn/0.4/reference/hooks#rules-of-hooks). ## Contributing @@ -34,6 +29,7 @@ - Join the discord and ask questions! ## License + This project is licensed under the [MIT license]. [mit license]: https://github.com/DioxusLabs/dioxus/blob/master/LICENSE-MIT diff --git a/packages/check/src/issues.rs b/packages/check/src/issues.rs index 9893cde25..34d20eaef 100644 --- a/packages/check/src/issues.rs +++ b/packages/check/src/issues.rs @@ -158,11 +158,11 @@ impl Display for IssueReport { #[allow(clippy::enum_variant_names)] // we'll add non-hook ones in the future /// Issues that might be found via static analysis of a Dioxus file. pub enum Issue { - /// https://dioxuslabs.com/docs/0.3/guide/en/interactivity/hooks.html#no-hooks-in-conditionals + /// https://dioxuslabs.com/learn/0.4/reference/hooks#no-hooks-in-conditionals HookInsideConditional(HookInfo, ConditionalInfo), - /// https://dioxuslabs.com/docs/0.3/guide/en/interactivity/hooks.html#no-hooks-in-loops + /// https://dioxuslabs.com/learn/0.4/reference/hooks#no-hooks-in-loops HookInsideLoop(HookInfo, AnyLoopInfo), - /// https://dioxuslabs.com/docs/0.3/guide/en/interactivity/hooks.html#no-hooks-in-closures + /// https://dioxuslabs.com/learn/0.4/reference/hooks#no-hooks-in-closures HookInsideClosure(HookInfo, ClosureInfo), HookOutsideComponent(HookInfo), } diff --git a/packages/cli/src/server/desktop/mod.rs b/packages/cli/src/server/desktop/mod.rs index 9b79bdea9..91811857d 100644 --- a/packages/cli/src/server/desktop/mod.rs +++ b/packages/cli/src/server/desktop/mod.rs @@ -1,7 +1,7 @@ use crate::{ server::{ output::{print_console_info, PrettierOptions}, - setup_file_watcher, setup_file_watcher_hot_reload, + setup_file_watcher, }, BuildResult, CrateConfig, Result, }; @@ -19,6 +19,8 @@ use tokio::sync::broadcast::{self}; #[cfg(feature = "plugin")] use plugin::PluginManager; +use super::HotReloadState; + pub async fn startup(config: CrateConfig) -> Result<()> { // ctrl-c shutdown checker let _crate_config = config.clone(); @@ -28,16 +30,36 @@ pub async fn startup(config: CrateConfig) -> Result<()> { std::process::exit(0); }); - match config.hot_reload { - true => serve_hot_reload(config).await?, - false => serve_default(config).await?, - } + let hot_reload_state = match config.hot_reload { + true => { + let FileMapBuildResult { map, errors } = + FileMap::::create(config.crate_dir.clone()).unwrap(); + + for err in errors { + log::error!("{}", err); + } + + let file_map = Arc::new(Mutex::new(map)); + + let hot_reload_tx = broadcast::channel(100).0; + + clear_paths(); + + Some(HotReloadState { + messages: hot_reload_tx.clone(), + file_map: file_map.clone(), + }) + } + false => None, + }; + + serve(config, hot_reload_state).await?; Ok(()) } /// Start the server without hot reload -pub async fn serve_default(config: CrateConfig) -> Result<()> { +pub async fn serve(config: CrateConfig, hot_reload_state: Option) -> Result<()> { let (child, first_build_result) = start_desktop(&config)?; let currently_running_child: RwLock = RwLock::new(child); @@ -59,6 +81,7 @@ pub async fn serve_default(config: CrateConfig) -> Result<()> { }, &config, None, + hot_reload_state.clone(), ) .await?; @@ -73,79 +96,29 @@ pub async fn serve_default(config: CrateConfig) -> Result<()> { None, ); - std::future::pending::<()>().await; + match hot_reload_state { + Some(hot_reload_state) => { + start_desktop_hot_reload(hot_reload_state).await?; + } + None => { + std::future::pending::<()>().await; + } + } Ok(()) } -/// Start the server without hot reload - -/// Start dx serve with hot reload -pub async fn serve_hot_reload(config: CrateConfig) -> Result<()> { - let (_, first_build_result) = start_desktop(&config)?; - - println!("πŸš€ Starting development server..."); - - // Setup hot reload - let FileMapBuildResult { map, errors } = - FileMap::::create(config.crate_dir.clone()).unwrap(); - - println!("πŸš€ Starting development server..."); - - for err in errors { - log::error!("{}", err); - } - - let file_map = Arc::new(Mutex::new(map)); - - let (hot_reload_tx, mut hot_reload_rx) = broadcast::channel(100); - - // States - // The open interprocess sockets - let channels = Arc::new(Mutex::new(Vec::new())); - - // Setup file watcher - // We got to own watcher so that it exists for the duration of serve - // Otherwise hot reload won't work. - let _watcher = setup_file_watcher_hot_reload( - &config, - hot_reload_tx, - file_map.clone(), - { - let config = config.clone(); - - let channels = channels.clone(); - move || { - for channel in &mut *channels.lock().unwrap() { - send_msg(HotReloadMsg::Shutdown, channel); - } - Ok(start_desktop(&config)?.1) - } - }, - None, - ) - .await?; - - // Print serve info - print_console_info( - &config, - PrettierOptions { - changed: vec![], - warnings: first_build_result.warnings, - elapsed_time: first_build_result.elapsed_time, - }, - None, - ); - - clear_paths(); - +async fn start_desktop_hot_reload(hot_reload_state: HotReloadState) -> Result<()> { match LocalSocketListener::bind("@dioxusin") { Ok(local_socket_stream) => { let aborted = Arc::new(Mutex::new(false)); + // States + // The open interprocess sockets + let channels = Arc::new(Mutex::new(Vec::new())); // listen for connections std::thread::spawn({ - let file_map = file_map.clone(); + let file_map = hot_reload_state.file_map.clone(); let channels = channels.clone(); let aborted = aborted.clone(); let _ = local_socket_stream.set_nonblocking(true); @@ -180,6 +153,8 @@ pub async fn serve_hot_reload(config: CrateConfig) -> Result<()> { } }); + let mut hot_reload_rx = hot_reload_state.messages.subscribe(); + while let Ok(template) = hot_reload_rx.recv().await { let channels = &mut *channels.lock().unwrap(); let mut i = 0; diff --git a/packages/cli/src/server/mod.rs b/packages/cli/src/server/mod.rs index 19dc44b75..c6073d787 100644 --- a/packages/cli/src/server/mod.rs +++ b/packages/cli/src/server/mod.rs @@ -9,7 +9,7 @@ use std::{ path::PathBuf, sync::{Arc, Mutex}, }; -use tokio::sync::broadcast::Sender; +use tokio::sync::broadcast::{self}; mod output; use output::*; @@ -21,6 +21,7 @@ async fn setup_file_watcher Result + Send + 'static>( build_with: F, config: &CrateConfig, web_info: Option, + hot_reload: Option, ) -> Result { let mut last_update_time = chrono::Local::now().timestamp(); @@ -38,28 +39,81 @@ async fn setup_file_watcher Result + Send + 'static>( let config = watcher_config.clone(); if let Ok(e) = info { if chrono::Local::now().timestamp() > last_update_time { - match build_with() { - Ok(res) => { - last_update_time = chrono::Local::now().timestamp(); + let mut needs_full_rebuild; + if let Some(hot_reload) = &hot_reload { + // find changes to the rsx in the file + let mut rsx_file_map = hot_reload.file_map.lock().unwrap(); + let mut messages: Vec> = Vec::new(); - #[allow(clippy::redundant_clone)] - print_console_info( - &config, - PrettierOptions { - changed: e.paths.clone(), - warnings: res.warnings, - elapsed_time: res.elapsed_time, - }, - web_info.clone(), - ); + // In hot reload mode, we only need to rebuild if non-rsx code is changed + needs_full_rebuild = false; - #[cfg(feature = "plugin")] - let _ = PluginManager::on_serve_rebuild( - chrono::Local::now().timestamp(), - e.paths, - ); + for path in &e.paths { + // if this is not a rust file, rebuild the whole project + if path.extension().and_then(|p| p.to_str()) != Some("rs") { + needs_full_rebuild = true; + break; + } + + match rsx_file_map.update_rsx(path, &config.crate_dir) { + Ok(UpdateResult::UpdatedRsx(msgs)) => { + messages.extend(msgs); + needs_full_rebuild = false; + } + Ok(UpdateResult::NeedsRebuild) => { + needs_full_rebuild = true; + } + Err(err) => { + log::error!("{}", err); + } + } + } + + if needs_full_rebuild { + // Reset the file map to the new state of the project + let FileMapBuildResult { + map: new_file_map, + errors, + } = FileMap::::create(config.crate_dir.clone()).unwrap(); + + for err in errors { + log::error!("{}", err); + } + + *rsx_file_map = new_file_map; + } else { + for msg in messages { + let _ = hot_reload.messages.send(msg); + } + } + } else { + needs_full_rebuild = true; + } + + if needs_full_rebuild { + match build_with() { + Ok(res) => { + last_update_time = chrono::Local::now().timestamp(); + + #[allow(clippy::redundant_clone)] + print_console_info( + &config, + PrettierOptions { + changed: e.paths.clone(), + warnings: res.warnings, + elapsed_time: res.elapsed_time, + }, + web_info.clone(), + ); + + #[cfg(feature = "plugin")] + let _ = PluginManager::on_serve_rebuild( + chrono::Local::now().timestamp(), + e.paths, + ); + } + Err(e) => log::error!("{}", e), } - Err(e) => log::error!("{}", e), } } } @@ -77,106 +131,8 @@ async fn setup_file_watcher Result + Send + 'static>( Ok(watcher) } -// Todo: reduce duplication and merge with setup_file_watcher() -/// Sets up a file watcher with hot reload -async fn setup_file_watcher_hot_reload Result + Send + 'static>( - config: &CrateConfig, - hot_reload_tx: Sender>, - file_map: Arc>>, - build_with: F, - web_info: Option, -) -> Result { - // file watcher: check file change - let allow_watch_path = config - .dioxus_config - .web - .watcher - .watch_path - .clone() - .unwrap_or_else(|| vec![PathBuf::from("src")]); - - let watcher_config = config.clone(); - let mut last_update_time = chrono::Local::now().timestamp(); - - let mut watcher = RecommendedWatcher::new( - move |evt: notify::Result| { - let config = watcher_config.clone(); - // Give time for the change to take effect before reading the file - std::thread::sleep(std::time::Duration::from_millis(100)); - if chrono::Local::now().timestamp() > last_update_time { - if let Ok(evt) = evt { - let mut messages: Vec> = Vec::new(); - for path in evt.paths.clone() { - // if this is not a rust file, rebuild the whole project - if path.extension().and_then(|p| p.to_str()) != Some("rs") { - match build_with() { - Ok(res) => { - print_console_info( - &config, - PrettierOptions { - changed: evt.paths, - warnings: res.warnings, - elapsed_time: res.elapsed_time, - }, - web_info.clone(), - ); - } - Err(err) => { - log::error!("{}", err); - } - } - return; - } - // find changes to the rsx in the file - let mut map = file_map.lock().unwrap(); - - match map.update_rsx(&path, &config.crate_dir) { - Ok(UpdateResult::UpdatedRsx(msgs)) => { - messages.extend(msgs); - } - Ok(UpdateResult::NeedsRebuild) => { - match build_with() { - Ok(res) => { - print_console_info( - &config, - PrettierOptions { - changed: evt.paths, - warnings: res.warnings, - elapsed_time: res.elapsed_time, - }, - web_info.clone(), - ); - } - Err(err) => { - log::error!("{}", err); - } - } - return; - } - Err(err) => { - log::error!("{}", err); - } - } - } - for msg in messages { - let _ = hot_reload_tx.send(msg); - } - } - last_update_time = chrono::Local::now().timestamp(); - } - }, - notify::Config::default(), - ) - .unwrap(); - - for sub_path in allow_watch_path { - if let Err(err) = watcher.watch( - &config.crate_dir.join(&sub_path), - notify::RecursiveMode::Recursive, - ) { - log::error!("error watching {sub_path:?}: \n{}", err); - } - } - - Ok(watcher) +#[derive(Clone)] +pub struct HotReloadState { + pub messages: broadcast::Sender>, + pub file_map: Arc>>, } diff --git a/packages/cli/src/server/web/hot_reload.rs b/packages/cli/src/server/web/hot_reload.rs index 49cce38d4..7b47dca4c 100644 --- a/packages/cli/src/server/web/hot_reload.rs +++ b/packages/cli/src/server/web/hot_reload.rs @@ -1,27 +1,15 @@ -use std::sync::{Arc, Mutex}; - use axum::{ extract::{ws::Message, WebSocketUpgrade}, response::IntoResponse, Extension, TypedHeader, }; -use dioxus_core::Template; -use dioxus_html::HtmlCtx; -use dioxus_rsx::hot_reload::FileMap; -use tokio::sync::broadcast; -use crate::CrateConfig; - -pub struct HotReloadState { - pub messages: broadcast::Sender>, - pub file_map: Arc>>, - pub watcher_config: CrateConfig, -} +use crate::server::HotReloadState; pub async fn hot_reload_handler( ws: WebSocketUpgrade, _: Option>, - Extension(state): Extension>, + Extension(state): Extension, ) -> impl IntoResponse { ws.on_upgrade(|mut socket| async move { log::info!("πŸ”₯ Hot Reload WebSocket connected"); diff --git a/packages/cli/src/server/web/mod.rs b/packages/cli/src/server/web/mod.rs index bb1c00c99..0e1413597 100644 --- a/packages/cli/src/server/web/mod.rs +++ b/packages/cli/src/server/web/mod.rs @@ -3,7 +3,7 @@ use crate::{ serve::Serve, server::{ output::{print_console_info, PrettierOptions, WebServerInfo}, - setup_file_watcher, setup_file_watcher_hot_reload, + setup_file_watcher, HotReloadState, }, BuildResult, CrateConfig, Result, WebHttpsConfig, }; @@ -58,20 +58,39 @@ pub async fn startup(port: u16, config: CrateConfig, start_browser: bool) -> Res let ip = get_ip().unwrap_or(String::from("0.0.0.0")); - match config.hot_reload { - true => serve_hot_reload(ip, port, config, start_browser).await?, - false => serve_default(ip, port, config, start_browser).await?, - } + let hot_reload_state = match config.hot_reload { + true => { + let FileMapBuildResult { map, errors } = + FileMap::::create(config.crate_dir.clone()).unwrap(); + + for err in errors { + log::error!("{}", err); + } + + let file_map = Arc::new(Mutex::new(map)); + + let hot_reload_tx = broadcast::channel(100).0; + + Some(HotReloadState { + messages: hot_reload_tx.clone(), + file_map: file_map.clone(), + }) + } + false => None, + }; + + serve(ip, port, config, start_browser, hot_reload_state).await?; Ok(()) } /// Start the server without hot reload -pub async fn serve_default( +pub async fn serve( ip: String, port: u16, config: CrateConfig, start_browser: bool, + hot_reload_state: Option, ) -> Result<()> { let first_build_result = crate::builder::build(&config, true)?; @@ -93,6 +112,7 @@ pub async fn serve_default( ip: ip.clone(), port, }), + hot_reload_state.clone(), ) .await?; @@ -119,88 +139,7 @@ pub async fn serve_default( ); // Router - let router = setup_router(config, ws_reload_state, None).await?; - - // Start server - start_server(port, router, start_browser, rustls_config).await?; - - Ok(()) -} - -/// Start dx serve with hot reload -pub async fn serve_hot_reload( - ip: String, - port: u16, - config: CrateConfig, - start_browser: bool, -) -> Result<()> { - let first_build_result = crate::builder::build(&config, true)?; - - log::info!("πŸš€ Starting development server..."); - - // Setup hot reload - let (reload_tx, _) = broadcast::channel(100); - let FileMapBuildResult { map, errors } = - FileMap::::create(config.crate_dir.clone()).unwrap(); - - for err in errors { - log::error!("{}", err); - } - - let file_map = Arc::new(Mutex::new(map)); - - let hot_reload_tx = broadcast::channel(100).0; - - // States - let hot_reload_state = Arc::new(HotReloadState { - messages: hot_reload_tx.clone(), - file_map: file_map.clone(), - watcher_config: config.clone(), - }); - - let ws_reload_state = Arc::new(WsReloadState { - update: reload_tx.clone(), - }); - - // Setup file watcher - // We got to own watcher so that it exists for the duration of serve - // Otherwise hot reload won't work. - let _watcher = setup_file_watcher_hot_reload( - &config, - hot_reload_tx, - file_map, - { - let config = config.clone(); - let reload_tx = reload_tx.clone(); - move || build(&config, &reload_tx) - }, - Some(WebServerInfo { - ip: ip.clone(), - port, - }), - ) - .await?; - - // HTTPS - // Before console info so it can stop if mkcert isn't installed or fails - let rustls_config = get_rustls(&config).await?; - - // Print serve info - print_console_info( - &config, - PrettierOptions { - changed: vec![], - warnings: first_build_result.warnings, - elapsed_time: first_build_result.elapsed_time, - }, - Some(WebServerInfo { - ip: ip.clone(), - port, - }), - ); - - // Router - let router = setup_router(config, ws_reload_state, Some(hot_reload_state)).await?; + let router = setup_router(config, ws_reload_state, hot_reload_state).await?; // Start server start_server(port, router, start_browser, rustls_config).await?; @@ -291,7 +230,7 @@ fn get_rustls_without_mkcert(web_config: &WebHttpsConfig) -> Result<(String, Str async fn setup_router( config: CrateConfig, ws_reload: Arc, - hot_reload: Option>, + hot_reload: Option, ) -> Result { // Setup cors let cors = CorsLayer::new() diff --git a/packages/core-macro/Cargo.toml b/packages/core-macro/Cargo.toml index f3d6f6b3b..d928d5fec 100644 --- a/packages/core-macro/Cargo.toml +++ b/packages/core-macro/Cargo.toml @@ -17,6 +17,8 @@ proc-macro2 = { version = "1.0" } quote = "1.0" syn = { version = "2.0", features = ["full", "extra-traits"] } dioxus-rsx = { workspace = true } +dioxus-core = { workspace = true } +constcat = "0.3.0" # testing [dev-dependencies] diff --git a/packages/core-macro/README.md b/packages/core-macro/README.md index bcf1572cf..31b0cca90 100644 --- a/packages/core-macro/README.md +++ b/packages/core-macro/README.md @@ -1,6 +1,5 @@ # dioxus-core-macro - [![Crates.io][crates-badge]][crates-url] [![MIT licensed][mit-badge]][mit-url] [![Build Status][actions-badge]][actions-url] @@ -8,22 +7,18 @@ [crates-badge]: https://img.shields.io/crates/v/dioxus-core-macro.svg [crates-url]: https://crates.io/crates/dioxus-core-macro - [mit-badge]: https://img.shields.io/badge/license-MIT-blue.svg [mit-url]: https://github.com/dioxuslabs/dioxus/blob/master/LICENSE - [actions-badge]: https://github.com/dioxuslabs/dioxus/actions/workflows/main.yml/badge.svg [actions-url]: https://github.com/dioxuslabs/dioxus/actions?query=workflow%3ACI+branch%3Amaster - [discord-badge]: https://img.shields.io/discord/899851952891002890.svg?logo=discord&style=flat-square [discord-url]: https://discord.gg/XgGxMSkvUM [Website](https://dioxuslabs.com) | -[Guides](https://dioxuslabs.com/docs/0.3/guide/en/) | +[Guides](https://dioxuslabs.com/learn/0.4/) | [API Docs](https://docs.rs/dioxus-core-macro/latest/dioxus_core_macro) | [Chat](https://discord.gg/XgGxMSkvUM) - ## Overview `dioxus-core-macro` provides a handful of helpful macros used by the `dioxus` crate. These include: @@ -32,13 +27,13 @@ - The `inline_props` macro transforms function arguments into an auto-derived struct - The `format_args_f` macro which allows f-string formatting with support for expressions - ## Contributing - Report issues on our [issue tracker](https://github.com/dioxuslabs/dioxus/issues). - Join the discord and ask questions! ## License + This project is licensed under the [MIT license]. [mit license]: https://github.com/DioxusLabs/dioxus/blob/master/LICENSE-MIT diff --git a/packages/core-macro/src/component_body/mod.rs b/packages/core-macro/src/component_body/mod.rs new file mode 100644 index 000000000..91e66c42c --- /dev/null +++ b/packages/core-macro/src/component_body/mod.rs @@ -0,0 +1,237 @@ +//! This module is used for parsing a component function into a struct that is subsequently +//! deserialized into something useful using deserializer arguments. +//! +//! Let's break that down with a term glossary and examples which show usage and implementing. +//! +//! # Glossary +//! * `component body` - The [`ComponentBody`] struct. It's used to parse a component function [`proc_macro::TokenStream`] +//! to a reusable struct that deserializers use to modify the token stream. +//! * `deserializer` - A struct that deserializes the [`ComponentBody`] into a [`DeserializerOutput`]. +//! It implements the [`DeserializerArgs`] trait, but as you can see, it's called "DeserializerArgs", +//! not "Deserializer". Why? +//! Because "args" makes more sense to the caller of [`ComponentBody::deserialize`], which +//! takes an [`DeserializerArgs`] argument. However, you can think of "DeserializerArgs" as the deserializer. +//! * `deserializer output` - A struct that implements the [`DeserializerOutput`] trait. +//! This struct is what enables deserializers to use each other, since it contains the fields that +//! a deserializer needs to turn a token stream to a different token stream. +//! This means a deserializer can get the output of another deserializer, and use that output, +//! thereby using the functionality of a different deserializer. +//! This struct also implements [`ToTokens`], which means that this is the final stage of the whole process. +//! +//! # Examples +//! *Not all imports might be included.* +//! +//! ## Usage in a procedural macro attribute +//! ```rs,ignore +//! use proc_macro::TokenStream; +//! +//! // Some documentation. You can reuse this in your deserializer structs. +//! /// This attribute changes the name of a component function to whatever the first argument is. +//! #[proc_macro_attribute] +//! pub fn name_changer(args: TokenStream, input: TokenStream) -> TokenStream { +//! // Parse the component body. +//! let component_body = parse_macro_input!(input as ComponentBody); +//! +//! // Parse the first argument, which is going to be the components new name. +//! let new_name: String = match Punctuated::::parse_terminated.parse(args) { +//! Err(e) => return e.to_compile_error().into(), // Convert to a compile error and return +//! Ok(args) => { +//! // If the argument exists, then convert it to a string +//! if let Some(first) = args.first() { +//! first.to_token_stream().to_string() +//! } else { +//! // If the argument doesn't exist, return an error with the appropriate message. +//! // The "span" is the location of some code. +//! // The error occurred in the "args" token stream, so point the error there. +//! return Error::new(args.span(), "No new name provided").to_compile_error().into(); +//! } +//! } +//! }; +//! +//! let new_name = &*new_name; +//! +//! // Deserialize the component body to an output with the given args. +//! let output = component_body.deserialize(NameChangerDeserializerArgs { new_name }); +//! +//! // Error handling like before, except now you're ready to return the final value. +//! match output { +//! Err(e) => e.to_compile_error().into(), +//! Ok(output) => output.to_token_stream().into(), +//! } +//! } +//! ``` +//! ## Using the macro in Dioxus code: +//! ```rs +//! use your_proc_macro_library::name_changer; +//! use dioxus::prelude::*; +//! +//! #[name_changer(CoolName)] +//! pub fn LameName(cx: Scope) -> Element { +//! render! { "I want a cool name!" } +//! } +//! +//! pub fn App(cx: Scope) -> Element { +//! render! { CoolName {} } // Renders: "I want a cool name!" +//! } +//! ``` +//! ## Implementing a component body deserializer +//! ```rs +//! use syn::{Result, ItemFn, Signature, Ident}; +//! use quote::quote; +//! +//! // Create a list of arguments. +//! // If there was no args, just make it empty. The "args" struct is also the deserializer struct. +//! // For the docs, you can basically copy paste this text and replace "name_changer" with your macro path. +//! // Although unfortunately, the link does not work +//! // Just make sure that your macro is well documented. +//! /// The args and deserializing implementation for the [`name_changer`] macro. +//! #[derive(Clone)] +//! pub struct NameChangerDeserializerArgs<'a> { +//! pub new_name: &'a str, +//! } +//! +//! // Create an output struct. +//! // The ItemFn represents a modified component function. +//! // To read what fields should be here, check out the `DeserializerOutput` struct docs. +//! // For the docs, you can basically copy paste this text and replace "name_changer" with your macro path. +//! // Just make sure that your macro is well documented. +//! /// The output fields and [`ToTokens`] implementation for the [`name_changer`] macro. +//! #[derive(Clone)] +//! pub struct NameChangerDeserializerOutput { +//! pub comp_fn: ItemFn, +//! } +//! +//! // Implement `ToTokens`, which is forced by `DeserializerOutput`. +//! // This will usually be very simple like this, even for complex deserializers. +//! // That's because of the way the `DeserializerOutput` is designed. +//! impl ToTokens for NameChangerDeserializerOutput { +//! fn to_tokens(&self, tokens: &mut TokenStream) { +//! let comp_fn = &self.comp_fn; +//! +//! tokens.append_all(quote! { +//! #comp_fn +//! }); +//! } +//! } +//! +//! impl DeserializerOutput for NameChangerDeserializerOutput {} +//! +//! // Implement `DeserializerArgs`. This is the core part of deserializers. +//! impl<'a> DeserializerArgs for NameChangerDeserializerArgs<'a> { +//! fn to_output(&self, component_body: &ComponentBody) -> Result { +//! let old_fn = &component_body.item_fn; +//! let old_sig = &old_fn.sig; +//! +//! // For more complex uses, you will probably use `quote::parse_quote!` in combination with +//! // creating the structs manually. +//! // However, create the structs manually if you can. +//! // It's more reliable, because you only modify a certain struct field +//! // and set the others to be the clone of the original component body. +//! // That ensures that no information will be accidentally removed. +//! let new_sig = Signature { +//! ident: Ident::new(self.new_name, old_sig.ident.span()), +//! ..old_sig.clone() +//! }; +//! let new_fn = ItemFn { +//! sig: new_sig, +//! ..old_fn.clone() +//! }; +//! +//! Ok(NameChangerDeserializerOutput { +//! comp_fn: new_fn +//! }) +//! } +//! ``` + +pub mod utils; + +pub use utils::DeserializerArgs; +pub use utils::DeserializerOutput; +pub use utils::TypeHelper; + +use dioxus_core::{Element, Scope}; +use syn::parse::{Parse, ParseStream}; +use syn::spanned::Spanned; +use syn::*; + +/// General struct for parsing a component body. +/// However, because it's ambiguous, it does not implement [`ToTokens`](quote::to_tokens::ToTokens). +/// +/// Refer to the [module documentation](crate::component_body) for more. +pub struct ComponentBody { + /// The component function definition. You can parse this back into a [`ComponentBody`]. + /// For example, you might modify it, parse it into a [`ComponentBody`], and deserialize that + /// using some deserializer. This is how deserializers use other deserializers. + /// + /// **`item_fn.sig.inputs` includes the context argument!** + /// Keep this in mind when creating deserializers, because you often might want to ignore it. + /// That might be annoying, but it would be bad design for this kind of struct to not be parsable from itself. + pub item_fn: ItemFn, + /// Parsing tries to ensure that this argument will be a [`Scope`]. + /// **However, macros have limitations that prevent this from always working, + /// so don't take this for granted!** + pub cx_arg: FnArg, + /// The pattern (name) and type of the context argument. + pub cx_pat_type: PatType, + /// If the function has any arguments other than the context. + pub has_extra_args: bool, +} + +impl ComponentBody { + /// Deserializes the body into the [`TOutput`] with the specific [`TArgs`]. + /// Even if the args are empty, the [`TArg`] type still determines what [`TOutput`] will be generated. + pub fn deserialize(&self, args: TArgs) -> Result + where + TOutput: DeserializerOutput, + TArgs: DeserializerArgs, + { + args.to_output(self) + } +} + +impl Parse for ComponentBody { + fn parse(input: ParseStream) -> Result { + let item_fn: ItemFn = input.parse()?; + let scope_type_path = Scope::get_path_string(); + + let (cx_arg, cx_pat_type) = if let Some(first_arg) = item_fn.sig.inputs.first() { + let incorrect_first_arg_err = Err(Error::new( + first_arg.span(), + format!("First argument must be a <{}>", scope_type_path), + )); + + match first_arg.to_owned() { + FnArg::Receiver(_) => { + return incorrect_first_arg_err; + } + FnArg::Typed(f) => (first_arg.to_owned(), f), + } + } else { + return Err(Error::new( + item_fn.sig.ident.span(), // Or maybe just item_f.sig.span()? + format!( + "Must have at least one argument that's a <{}>", + scope_type_path + ), + )); + }; + + let element_type_path = Element::get_path_string(); + + if item_fn.sig.output == ReturnType::Default { + return Err(Error::new( + item_fn.sig.output.span(), + format!("Must return a <{}>", element_type_path), + )); + } + + let has_extra_args = item_fn.sig.inputs.len() > 1; + + Ok(Self { + item_fn, + cx_arg, + cx_pat_type, + has_extra_args, + }) + } +} diff --git a/packages/core-macro/src/component_body/utils.rs b/packages/core-macro/src/component_body/utils.rs new file mode 100644 index 000000000..05a2869d7 --- /dev/null +++ b/packages/core-macro/src/component_body/utils.rs @@ -0,0 +1,57 @@ +use crate::component_body::ComponentBody; +use dioxus_core::{Element, Scope}; +use quote::ToTokens; +use syn::{parse_quote, Path}; + +/// The output produced by a deserializer. +/// +/// # For implementors +/// Struct field guidelines: +/// * Must be public, so that other deserializers can utilize them. +/// * Should usually be [`Item`]s that you then simply combine in a [`quote!`] +/// in the [`ComponentBodyDeserializer::output_to_token_stream2`] function. +/// * If an [`Item`] might not be included, wrap it in an [`Option`]. +/// * Must be at the component function "level"/"context". +/// For example, the [`InlinePropsDeserializer`](crate::component_body_deserializers::inline_props::InlinePropsDeserializer) +/// produces two [`Item`]s; the function but with arguments turned into props, and the props struct. +/// It does not return any [`Item`]s inside the struct or function. +pub trait DeserializerOutput: ToTokens {} + +impl DeserializerOutput for T {} + +/// The args passed to a [`ComponentBody`] when deserializing it. +/// +/// It's also the struct that does the deserializing. +/// It's called "DeserializerArgs", not "Deserializer". Why? +/// Because "args" makes more sense to the caller of [`ComponentBody::deserialize`], which +/// takes an [`DeserializerArgs`] argument. However, you can think of "DeserializerArgs" as the deserializer. +pub trait DeserializerArgs: Clone +where + TOutput: ToTokens, +{ + // There's a lot of Results out there... let's make sure that this is a syn::Result. + // Let's also make sure there's not a warning. + /// Creates a [`ToTokens`] struct from the `self` args and a [`ComponentBody`]. + /// The [`ComponentBody::deserialize`] provides a cleaner way of calling this function. + #[allow(unused_qualifications)] + fn to_output(&self, component_body: &ComponentBody) -> syn::Result; +} + +pub trait TypeHelper { + fn get_path() -> Path; + fn get_path_string() -> String { + Self::get_path().to_token_stream().to_string() + } +} + +impl<'a> TypeHelper for Scope<'a> { + fn get_path() -> Path { + parse_quote!(::dioxus::core::Scope) + } +} + +impl<'a> TypeHelper for Element<'a> { + fn get_path() -> Path { + parse_quote!(::dioxus::core::Element) + } +} diff --git a/packages/core-macro/src/component_body_deserializers/component.rs b/packages/core-macro/src/component_body_deserializers/component.rs new file mode 100644 index 000000000..e43b1819f --- /dev/null +++ b/packages/core-macro/src/component_body_deserializers/component.rs @@ -0,0 +1,152 @@ +use crate::component_body::{ComponentBody, DeserializerArgs}; +use crate::component_body_deserializers::inline_props::InlinePropsDeserializerArgs; +use constcat::concat; +use proc_macro2::TokenStream as TokenStream2; +use quote::{quote, ToTokens, TokenStreamExt}; +use syn::*; + +pub(crate) const COMPONENT_ARG_CASE_CHECK_ERROR: &str = concat!( + "This component does not use PascalCase. \ +To ignore this check, pass the \"", + crate::COMPONENT_ARG_CASE_CHECK_OFF, + "\" argument, like so: #[component(", + crate::COMPONENT_ARG_CASE_CHECK_OFF, + ")]" +); + +const INNER_FN_NAME: &str = "__dx_inner_comp"; + +fn get_out_comp_fn(orig_comp_fn: &ItemFn, cx_pat: &Pat) -> ItemFn { + let inner_comp_ident = Ident::new(INNER_FN_NAME, orig_comp_fn.sig.ident.span()); + + let inner_comp_fn = ItemFn { + sig: Signature { + ident: inner_comp_ident.clone(), + ..orig_comp_fn.sig.clone() + }, + ..orig_comp_fn.clone() + }; + + ItemFn { + block: parse_quote! { + { + #[warn(non_snake_case)] + #[inline(always)] + #inner_comp_fn + #inner_comp_ident (#cx_pat) + } + }, + ..orig_comp_fn.clone() + } +} + +/// The args and deserializing implementation for the [`crate::component`] macro. +#[derive(Clone)] +pub struct ComponentDeserializerArgs { + pub case_check: bool, +} + +/// The output fields and [`ToTokens`] implementation for the [`crate::component`] macro. +#[derive(Clone)] +pub struct ComponentDeserializerOutput { + pub comp_fn: ItemFn, + pub props_struct: Option, +} + +impl ToTokens for ComponentDeserializerOutput { + fn to_tokens(&self, tokens: &mut TokenStream2) { + let comp_fn = &self.comp_fn; + let props_struct = &self.props_struct; + + tokens.append_all(quote! { + #props_struct + #[allow(non_snake_case)] + #comp_fn + }); + } +} + +impl DeserializerArgs for ComponentDeserializerArgs { + fn to_output(&self, component_body: &ComponentBody) -> Result { + let Signature { ident, .. } = &component_body.item_fn.sig; + + if self.case_check && !is_pascal_case(&ident.to_string()) { + return Err(Error::new(ident.span(), COMPONENT_ARG_CASE_CHECK_ERROR)); + } + + if component_body.has_extra_args { + Self::deserialize_with_props(component_body) + } else { + Ok(Self::deserialize_no_props(component_body)) + } + } +} + +impl ComponentDeserializerArgs { + fn deserialize_no_props(component_body: &ComponentBody) -> ComponentDeserializerOutput { + let ComponentBody { + item_fn, + cx_pat_type, + .. + } = component_body; + let cx_pat = &cx_pat_type.pat; + + let comp_fn = get_out_comp_fn(item_fn, cx_pat); + + ComponentDeserializerOutput { + comp_fn, + props_struct: None, + } + } + + fn deserialize_with_props( + component_body: &ComponentBody, + ) -> Result { + let ComponentBody { + item_fn, + cx_pat_type, + .. + } = component_body; + let cx_pat = &cx_pat_type.pat; + + let comp_parsed = match parse2::(quote!(#item_fn)) { + Ok(comp_body) => comp_body, + Err(e) => { + return Err(Error::new( + e.span(), + format!( + "This is probably a bug in our code, please report it! Error: {}", + e + ), + )) + } + }; + + let inlined_props_output = comp_parsed.deserialize(InlinePropsDeserializerArgs {})?; + let props_struct = inlined_props_output.props_struct; + let props_fn = inlined_props_output.comp_fn; + + let comp_fn = get_out_comp_fn(&props_fn, cx_pat); + + Ok(ComponentDeserializerOutput { + comp_fn, + props_struct: Some(props_struct), + }) + } +} + +fn is_pascal_case(input: &str) -> bool { + let mut is_next_lowercase = false; + + for c in input.chars() { + let is_upper = c.is_ascii_uppercase(); + + if (c == '_') || (is_upper && is_next_lowercase) { + return false; + } + + is_next_lowercase = is_upper; + } + + true +} diff --git a/packages/core-macro/src/component_body_deserializers/inline_props.rs b/packages/core-macro/src/component_body_deserializers/inline_props.rs new file mode 100644 index 000000000..8e4581c19 --- /dev/null +++ b/packages/core-macro/src/component_body_deserializers/inline_props.rs @@ -0,0 +1,195 @@ +use crate::component_body::{ComponentBody, DeserializerArgs}; +use proc_macro2::TokenStream as TokenStream2; +use quote::{quote, ToTokens, TokenStreamExt}; +use syn::token::Comma; +use syn::{punctuated::Punctuated, *}; + +/// The args and deserializing implementation for the [`crate::inline_props`] macro. +#[derive(Clone)] +pub struct InlinePropsDeserializerArgs; + +/// The output fields and [`ToTokens`] implementation for the [`crate::inline_props`] macro. +#[derive(Clone)] +pub struct InlinePropsDeserializerOutput { + pub comp_fn: ItemFn, + pub props_struct: ItemStruct, +} + +impl ToTokens for InlinePropsDeserializerOutput { + fn to_tokens(&self, tokens: &mut TokenStream2) { + let function = &self.comp_fn; + let props_struct = &self.props_struct; + + tokens.append_all(quote! { + #function + #props_struct + }); + } +} + +impl DeserializerArgs for InlinePropsDeserializerArgs { + fn to_output(&self, component_body: &ComponentBody) -> Result { + Ok(InlinePropsDeserializerOutput { + comp_fn: Self::get_function(component_body), + props_struct: Self::get_props_struct(component_body), + }) + } +} + +impl InlinePropsDeserializerArgs { + fn get_props_struct(component_body: &ComponentBody) -> ItemStruct { + let ComponentBody { item_fn, .. } = component_body; + let ItemFn { vis, sig, .. } = item_fn; + let Signature { + inputs, + ident: fn_ident, + generics, + .. + } = sig; + + // Skip first arg since that's the context + let struct_fields = inputs.iter().skip(1).map(move |f| { + match f { + FnArg::Receiver(_) => unreachable!(), // Unreachable because of ComponentBody parsing + FnArg::Typed(pt) => { + let arg_pat = &pt.pat; // Pattern (identifier) + let arg_colon = &pt.colon_token; + let arg_ty = &pt.ty; // Type + let arg_attrs = &pt.attrs; // Attributes + + quote! { + #(#arg_attrs) + * + #vis #arg_pat #arg_colon #arg_ty + } + } + } + }); + + let struct_ident = Ident::new(&format!("{fn_ident}Props"), fn_ident.span()); + + let first_lifetime = if let Some(GenericParam::Lifetime(lt)) = generics.params.first() { + Some(lt) + } else { + None + }; + + let struct_attrs = if first_lifetime.is_some() { + quote! { #[derive(Props)] } + } else { + quote! { #[derive(Props, PartialEq)] } + }; + + let struct_generics = if first_lifetime.is_some() { + let struct_generics: Punctuated = component_body + .item_fn + .sig + .generics + .params + .iter() + .map(|it| match it { + GenericParam::Type(tp) => { + let mut tp = tp.clone(); + tp.bounds.push(parse_quote!( 'a )); + + GenericParam::Type(tp) + } + _ => it.clone(), + }) + .collect(); + + quote! { <#struct_generics> } + } else { + quote! { #generics } + }; + + parse_quote! { + #struct_attrs + #[allow(non_camel_case_types)] + #vis struct #struct_ident #struct_generics + { + #(#struct_fields),* + } + } + } + + fn get_function(component_body: &ComponentBody) -> ItemFn { + let ComponentBody { + item_fn, + cx_pat_type, + .. + } = component_body; + let ItemFn { + attrs: fn_attrs, + vis, + sig, + block: fn_block, + } = item_fn; + let Signature { + inputs, + ident: fn_ident, + generics, + output: fn_output, + asyncness, + .. + } = sig; + let Generics { where_clause, .. } = generics; + + let cx_pat = &cx_pat_type.pat; + let struct_ident = Ident::new(&format!("{fn_ident}Props"), fn_ident.span()); + + // Skip first arg since that's the context + let struct_field_names = inputs.iter().skip(1).filter_map(|f| match f { + FnArg::Receiver(_) => unreachable!(), // ComponentBody prohibits receiver parameters. + FnArg::Typed(t) => Some(&t.pat), + }); + + let first_lifetime = if let Some(GenericParam::Lifetime(lt)) = generics.params.first() { + Some(lt) + } else { + None + }; + + let (scope_lifetime, fn_generics) = if let Some(lt) = first_lifetime { + (quote! { #lt, }, generics.clone()) + } else { + let lifetime: LifetimeParam = parse_quote! { 'a }; + + let mut fn_generics = generics.clone(); + fn_generics + .params + .insert(0, GenericParam::Lifetime(lifetime.clone())); + + (quote! { #lifetime, }, fn_generics) + }; + + let generics_no_bounds = { + let mut generics = generics.clone(); + generics.params = generics + .params + .iter() + .map(|it| match it { + GenericParam::Type(tp) => { + let mut tp = tp.clone(); + tp.bounds.clear(); + + GenericParam::Type(tp) + } + _ => it.clone(), + }) + .collect(); + + generics + }; + + parse_quote! { + #(#fn_attrs)* + #asyncness #vis fn #fn_ident #fn_generics (#cx_pat: Scope<#scope_lifetime #struct_ident #generics_no_bounds>) #fn_output + #where_clause + { + let #struct_ident { #(#struct_field_names),* } = &#cx_pat.props; + #fn_block + } + } + } +} diff --git a/packages/core-macro/src/component_body_deserializers/mod.rs b/packages/core-macro/src/component_body_deserializers/mod.rs new file mode 100644 index 000000000..a3027796d --- /dev/null +++ b/packages/core-macro/src/component_body_deserializers/mod.rs @@ -0,0 +1,4 @@ +//! This module contains all [`ComponentBody`](crate::component_body::ComponentBody) deserializers. + +pub mod component; +pub mod inline_props; diff --git a/packages/core-macro/src/inlineprops.rs b/packages/core-macro/src/inlineprops.rs deleted file mode 100644 index ccc00f4f9..000000000 --- a/packages/core-macro/src/inlineprops.rs +++ /dev/null @@ -1,185 +0,0 @@ -use proc_macro2::{Span, TokenStream as TokenStream2}; -use quote::{quote, ToTokens, TokenStreamExt}; -use syn::{ - parse::{Parse, ParseStream}, - punctuated::Punctuated, - *, -}; - -pub struct InlinePropsBody { - pub attrs: Vec, - pub vis: syn::Visibility, - pub maybe_async: Option, - pub fn_token: Token![fn], - pub ident: Ident, - pub cx_token: Box, - pub generics: Generics, - pub paren_token: token::Paren, - pub inputs: Punctuated, - // pub fields: FieldsNamed, - pub output: ReturnType, - pub where_clause: Option, - pub block: Box, -} - -/// The custom rusty variant of parsing rsx! -impl Parse for InlinePropsBody { - fn parse(input: ParseStream) -> Result { - let attrs: Vec = input.call(Attribute::parse_outer)?; - let maybe_async: Option = input.parse().ok(); - let vis: Visibility = input.parse()?; - - let fn_token = input.parse()?; - let ident = input.parse()?; - let generics: Generics = input.parse()?; - - let content; - let paren_token = syn::parenthesized!(content in input); - - let first_arg: FnArg = content.parse()?; - let cx_token = { - match first_arg { - FnArg::Receiver(_) => panic!("first argument must not be a receiver argument"), - FnArg::Typed(f) => f.pat, - } - }; - - let _: Result = content.parse(); - - let inputs = syn::punctuated::Punctuated::parse_terminated(&content)?; - - let output = input.parse()?; - - let where_clause = input - .peek(syn::token::Where) - .then(|| input.parse()) - .transpose()?; - - let block = input.parse()?; - - Ok(Self { - vis, - maybe_async, - fn_token, - ident, - generics, - paren_token, - inputs, - output, - where_clause, - block, - cx_token, - attrs, - }) - } -} - -/// Serialize the same way, regardless of flavor -impl ToTokens for InlinePropsBody { - fn to_tokens(&self, out_tokens: &mut TokenStream2) { - let Self { - vis, - ident, - generics, - inputs, - output, - where_clause, - block, - cx_token, - attrs, - maybe_async, - .. - } = self; - - let fields = inputs.iter().map(|f| { - quote! { #vis #f } - }); - - let struct_name = Ident::new(&format!("{ident}Props"), Span::call_site()); - - let field_names = inputs.iter().filter_map(|f| match f { - FnArg::Receiver(_) => todo!(), - FnArg::Typed(t) => Some(&t.pat), - }); - - let first_lifetime = if let Some(GenericParam::Lifetime(lt)) = generics.params.first() { - Some(lt) - } else { - None - }; - - let modifiers = if first_lifetime.is_some() { - quote! { #[derive(Props)] } - } else { - quote! { #[derive(Props, PartialEq)] } - }; - - let (scope_lifetime, fn_generics, struct_generics) = if let Some(lt) = first_lifetime { - let struct_generics: Punctuated<_, token::Comma> = generics - .params - .iter() - .map(|it| match it { - GenericParam::Type(tp) => { - let mut tp = tp.clone(); - tp.bounds.push(parse_quote!( 'a )); - - GenericParam::Type(tp) - } - _ => it.clone(), - }) - .collect(); - - ( - quote! { #lt, }, - generics.clone(), - quote! { <#struct_generics> }, - ) - } else { - let lifetime: LifetimeParam = parse_quote! { 'a }; - - let mut fn_generics = generics.clone(); - fn_generics - .params - .insert(0, GenericParam::Lifetime(lifetime.clone())); - - (quote! { #lifetime, }, fn_generics, quote! { #generics }) - }; - - let generics_no_bounds = { - let mut generics = generics.clone(); - generics.params = generics - .params - .iter() - .map(|it| match it { - GenericParam::Type(tp) => { - let mut tp = tp.clone(); - tp.bounds.clear(); - - GenericParam::Type(tp) - } - _ => it.clone(), - }) - .collect(); - - generics - }; - - out_tokens.append_all(quote! { - #modifiers - #[allow(non_camel_case_types)] - #vis struct #struct_name #struct_generics - #where_clause - { - #(#fields),* - } - - #(#attrs)* - #maybe_async #vis fn #ident #fn_generics (#cx_token: Scope<#scope_lifetime #struct_name #generics_no_bounds>) #output - #where_clause - { - let #struct_name { #(#field_names),* } = &#cx_token.props; - #block - } - }); - } -} diff --git a/packages/core-macro/src/lib.rs b/packages/core-macro/src/lib.rs index 501c38e7b..d91c72e39 100644 --- a/packages/core-macro/src/lib.rs +++ b/packages/core-macro/src/lib.rs @@ -1,12 +1,18 @@ use proc_macro::TokenStream; use quote::ToTokens; use rsx::RenderCallBody; -use syn::parse_macro_input; +use syn::parse::Parser; +use syn::punctuated::Punctuated; +use syn::{parse_macro_input, Path, Token}; -mod inlineprops; +mod component_body; +mod component_body_deserializers; mod props; // mod rsx; +use crate::component_body::ComponentBody; +use crate::component_body_deserializers::component::ComponentDeserializerArgs; +use crate::component_body_deserializers::inline_props::InlinePropsDeserializerArgs; use dioxus_rsx as rsx; #[proc_macro] @@ -18,7 +24,7 @@ pub fn format_args_f(input: TokenStream) -> TokenStream { } #[proc_macro_derive(Props, attributes(props))] -pub fn derive_typed_builder(input: proc_macro::TokenStream) -> proc_macro::TokenStream { +pub fn derive_typed_builder(input: TokenStream) -> TokenStream { let input = parse_macro_input!(input as syn::DeriveInput); match props::impl_my_derive(&input) { Ok(output) => output.into(), @@ -37,7 +43,7 @@ pub fn rsx(s: TokenStream) -> TokenStream { /// The render! macro makes it easy for developers to write jsx-style markup in their components. /// -/// The render macro automatically renders rsx - making it unhygenic. +/// The render macro automatically renders rsx - making it unhygienic. #[proc_macro] pub fn render(s: TokenStream) -> TokenStream { match syn::parse::(s) { @@ -55,7 +61,7 @@ pub fn render(s: TokenStream) -> TokenStream { /// you would be repeating a lot of the usual Rust boilerplate. /// /// # Example -/// ```ignore +/// ```rust,ignore /// #[inline_props] /// fn app(cx: Scope, bob: String) -> Element { /// cx.render(rsx!("hello, {bob}")) @@ -73,9 +79,118 @@ pub fn render(s: TokenStream) -> TokenStream { /// } /// ``` #[proc_macro_attribute] -pub fn inline_props(_args: proc_macro::TokenStream, s: TokenStream) -> TokenStream { - match syn::parse::(s) { +#[deprecated(note = "Use `#[component]` instead.")] +pub fn inline_props(_args: TokenStream, s: TokenStream) -> TokenStream { + let comp_body = parse_macro_input!(s as ComponentBody); + + match comp_body.deserialize(InlinePropsDeserializerArgs {}) { Err(e) => e.to_compile_error().into(), - Ok(s) => s.to_token_stream().into(), + Ok(output) => output.to_token_stream().into(), + } +} + +pub(crate) const COMPONENT_ARG_CASE_CHECK_OFF: &str = "no_case_check"; + +/// Streamlines component creation. +/// This is the recommended way of creating components, +/// though you might want lower-level control with more advanced uses. +/// +/// # Arguments +/// * `no_case_check` - Doesn't enforce `PascalCase` on your component names. +/// **This will be removed/deprecated in a future update in favor of a more complete Clippy-backed linting system.** +/// The reasoning behind this is that Clippy allows more robust and powerful lints, whereas +/// macros are extremely limited. +/// +/// # Features +/// This attribute: +/// * Enforces that your component uses `PascalCase`. +/// No warnings are generated for the `PascalCase` +/// function name, but everything else will still raise a warning if it's incorrectly `PascalCase`. +/// Does not disable warnings anywhere else, so if you, for example, +/// accidentally don't use `snake_case` +/// for a variable name in the function, the compiler will still warn you. +/// * Automatically uses `#[inline_props]` if there's more than 1 parameter in the function. +/// * Verifies the validity of your component. +/// E.g. if it has a [`Scope`](dioxus_core::Scope) argument. +/// Notes: +/// * This doesn't work 100% of the time, because of macro limitations. +/// * Provides helpful messages if your component is not correct. +/// Possible bugs (please, report these!): +/// * There might be bugs where it incorrectly *denies* validity. +/// This is bad as it means that you can't use the attribute or you have to change the component. +/// * There might be bugs where it incorrectly *confirms* validity. +/// You will still know if the component is invalid once you use it, +/// but the error might be less helpful. +/// +/// # Examples +/// * Without props: +/// ```rust,ignore +/// #[component] +/// fn GreetBob(cx: Scope) -> Element { +/// render! { "hello, bob" } +/// } +/// +/// // is equivalent to +/// +/// #[allow(non_snake_case)] +/// fn GreetBob(cx: Scope) -> Element { +/// #[warn(non_snake_case)] +/// #[inline(always)] +/// fn __dx_inner_comp(cx: Scope) -> Element { +/// render! { "hello, bob" } +/// } +/// // There's no function call overhead since __dx_inner_comp has the #[inline(always)] attribute, +/// // so don't worry about performance. +/// __dx_inner_comp(cx) +/// } +/// ``` +/// * With props: +/// ```rust,ignore +/// #[component(no_case_check)] +/// fn GreetPerson(cx: Scope, person: String) -> Element { +/// render! { "hello, {person}" } +/// } +/// +/// // is equivalent to +/// +/// #[derive(Props, PartialEq)] +/// #[allow(non_camel_case_types)] +/// struct GreetPersonProps { +/// person: String, +/// } +/// +/// #[allow(non_snake_case)] +/// fn GreetPerson<'a>(cx: Scope<'a, GreetPersonProps>) -> Element { +/// #[warn(non_snake_case)] +/// #[inline(always)] +/// fn __dx_inner_comp<'a>(cx: Scope<'a, GreetPersonProps>e) -> Element { +/// let GreetPersonProps { person } = &cx.props; +/// { +/// render! { "hello, {person}" } +/// } +/// } +/// +/// __dx_inner_comp(cx) +/// } +/// ``` +// TODO: Maybe add an option to input a custom component name through the args. +// I think that's unnecessary, but there might be some scenario where it could be useful. +#[proc_macro_attribute] +pub fn component(args: TokenStream, input: TokenStream) -> TokenStream { + let component_body = parse_macro_input!(input as ComponentBody); + let case_check = match Punctuated::::parse_terminated.parse(args) { + Err(e) => return e.to_compile_error().into(), + Ok(args) => { + if let Some(first) = args.first() { + !first.is_ident(COMPONENT_ARG_CASE_CHECK_OFF) + } else { + true + } + } + }; + + match component_body.deserialize(ComponentDeserializerArgs { case_check }) { + Err(e) => e.to_compile_error().into(), + Ok(output) => output.to_token_stream().into(), } } diff --git a/packages/core-macro/src/props/mod.rs b/packages/core-macro/src/props/mod.rs index 6a0d24a95..c1931e497 100644 --- a/packages/core-macro/src/props/mod.rs +++ b/packages/core-macro/src/props/mod.rs @@ -2,9 +2,9 @@ //! //! However, it has been adopted to fit the Dioxus Props builder pattern. //! -//! For dioxus, we make a few changes: -//! - [ ] automatically implement Into

yukBKSs9bHLp!Auf`BBY$AxI|7FN`&(OIDGWvtDU5YYkD~bbWaWQiAy#R;f5RZhVaA{nPoZksvUUcf zRrxkf31f5jYsa57vxD*Jc&);+_NA;@9pUY@mYKvUHh3g|;4c3D6Yf1o`mKWN z&K{mIEwSB#@u9c}xXYh^mf9Td!Bi5bRXI?IHur$Ad2%Yd(7ugcg5Tjemm}X5SB%B3 z5E28aQTi)6eHhmjaeZSL1J2WLSW$TfNXd1O{HRDM%T7vtG}kCsu(}di7QQksFrP&R zSBqkz01Ej$?=C_q4A$9Wsq#C-8;zA_6c$1_eslU zBNiNL`Q3!KnVCYaq#r$WbVH4{#*cU(&n|u$f5aF1#isypxO={PpD9L-3dI(VO=p4- zoG_?%MRsjqXzKP)TGcBHb;!l zPuJq5-1PF!zWpX<6w;X0h^3hljS{V)Bs%2u=WAp;cEkzw4;2Q9jhnH{Xb+CR%8W%* zTH98Pv}hmkF7ccUFb=yZ(g$T$a#ei9vgqGTv%6+qmF{jmBAnu9B;f5B+VG&m9Gsf9 zQ?C=|@M5Lg4`v&HzR`qIjhf@4J$Xszf!%*h#aP2qxbmWLoD4E=L{%5$gc@B(X1S)C zxVsxKZroySazRKxh|Du0(l{ctetLnu_rhniwgf7Hk(MRl+VauM z6Z9x>)WmmY)AL2f#wc{o%AmL6)0SC4ptrUigFcDoq`sK;MEO-f)>Ww2W(7Z8tjQ^1 ztxjSdH6cLt9Tbp_h?eE>aZT)j;t&U2k{>ZPKL8}2I(pv3r-FLRs?@qFNwHLfLDe{D zY5`_+(tA;w<)!ay+2_wuH`*|kM03XAQ%}ClDsM1hl(ULe%g%kdlqIELLpGwK$Vf|! z@3V{XuUg9mw#6KEkjUjYW?id@LDAFDwK)A+pJ%ZmzJe~Be4E!WAX5s{BJXfO+_QCv zplbh~qUXu&f~|#=p#T1!V)8B2ukkr2W_3e36wzFC(p^(a4Zz$~e>{`NPp?U0!`|(& z$M+6##fXd6n&}BzT_@vrrvu;W^zmtT zGI3Q&6AumW2@c8z?Q|B{Gm7UPyp=UUYopt53|@}8Kr8qm^W95;`~ZW@u4C)sn5b$z zwA6aYDdH`Cg8#woxMt7ZuhG+`X2Iv{(%M5Rg0 z+~S$PmO^pYtIe}11+zY+A*!M&qs1R639nhf|8O6*_x?ivS%T!1M9)9VgRXEH?e#bP z+v+XkO=Cd~?@URHbz7IVJ>y-^Jos1gd2&nNq%)A1*G4TnK7UzrIKoY z%)4u^C{AQ=>AQuH&pCO?5B7;Mh6@0{@`gsQy4D7udFA;(6A=;ud}|LTbWK4m9x zRM->VA6-!`;Jt_r3j;cgA*(H{+!oD`?I9Gj)ws`&+NHsM09FLmXgSQsqmD$*!Qvxa zl54B#K?r@lY&u{i&L_aaHg?P_C~q?b!O*OcYB5M1T7hcOq;5sVsSF?3@dwH!Al)6h z7FKBTIUu`ix&B$QzYfGPQ$r~xwIrtdDhLM0ew}Tg8z3=eKlUJOI=OfFux&Su`bGX$ zih$@`#k_hN$b>W~+RRiFDJ6)-$V(U=(>1T4YsfJ-7)ax}#Al~jVN`3pwLo`Mr=*Ui z=|~5O(Jq$`ET%$f-jD0t^h?by|F%X}kppv1P;bwT`e5yrazvNWqDo3jNquWbRMu7# zwTV!g3V*F)rTvjf{fB9CLKr`x*l)FoqH3zaK#$lFAE;XNcCZ_=rYw&@1+(%%W3(6Z zdK4ZXTy%kqKL>+LA?n-!q=@;Br-RyVmer{bUy5M~+e&QGrpuE>+45-Vl+CkMWIE^G zEZeew8%h(&PmMx)WW#fGg*z|JG~f*rCmCc%YU0t-RN>y5(43W*Mn%>mV*FB+6a5Fu zAm@Z!432zP;XbD!UOJz3B|etY*G``hciOBgE@TlY$`5|`RiYH{y%Qd15yuW*xQjG) z!!opyDw)>4cX8m-aaXj(#{taANwjBAO>gX00X+ije zIID-i;3eZuILVjp|c?s3r2pHYnManwKw3kt8`VGQ`Sn!aXi@Nzu z3f;_Ip&W68-^GT-7UWIQ!~M6yDAwa;eJ_UT{`01|s*qAB>h-km?N$L_>IDhWmEA&i zC^fG~-FdB;)u7Mm7w9j8L`92;==WgfKi+>z2U}5qFo86?wuTk-eLsI;BUc1N#K`ge z{r#}YmtU||PXcT2H7>3F^2}7=^`}^dTUNV&{Fp8B2#ABW0bjwX4n0q?JppC)U0o%Wm1SMK9iCmfVg3_aQ&&i*X4)isqPr_0*tGB8774HavP96)B@+A)+M|cF zOkAxR6q($Um|eTc+^->Yueb&|~i#!|N8 zTF~h{T3`Qp@)RRyh@!p2@}>rhMhhUfs34c1>ELUOr(&+Bc^d4Ky6I2P&uE9xbTF%< zp`dHanZEv0aZ6mZBTe{`E5!ZRZ^p2O5U1n!D!;Sbs985ajUZt=srQYxpJ|69<02~w z7A;sCX{574FzH0cfsa4ZwGT0JXkdV7UI#AQ{-aqR9Fm|KkbE=4AdgKEp@~#t{@Msf zx%PJ^GZHf%#F+n00AbG=z1No-4M5+(csJZSC3S!V++JtTWmam>)TKIfP;WUUm>Ab9(xWh_hVoFDd3s+Nv^|qr_;lm~Ww3~IUQ<^jei^H45 z4+!GRd5o#kONo#`B@H9P;r7JCvi)zoBiIhwW9$4c{}T=)y)bO@|zcpL1n zVIbEEV0xX+vjvQa&-vhYk|N|PI!=7+E}nexiCfouxeIk)a6?5`YWaKGKctMUv^Zo8 zW>9qdjPv%~v(#-oimrJB_y|sbEs@u_bZnW$ZTH>aIxlnkoW21AlWdK>alIAy7Hy7PNEIj~h=Ju;*UH5-dZ(Wan+*SK75a2)TX}4|oJNFu^Dl?JW>NURg9LMaq zDHW`4*zKcE#GL|zIE3#zb4@jzZ-`a~A%8^c1*D;#8lQLj&+Ups(X+Ee%>cR!%`E9- zLfOY#&ZIkZQG^;Mdyi=twN)ZoX2b9>-Es)%ct`UR>MDk`iolQp?9S1?&7rF!-Od}^ zyqwuNl8avKqlef;v#-MAxFtieaOT^q#NVC)y${x#vHa1^W3sOI{=@kWD;hW)>ctf1 z0Qkng3FmgVtAr=z;7P*pKp>L%P%-C&LZ@rMM8w7b>n9AcRvF%^w5}PUs7hLVu^z3X z)ExQbfgZwHb3K9=?}%C{T4Q2DWIORg&S-UZ*|4J^lT6?>m`IAPo1|V0>MFlC-{S)h zBHP*MsSk;%pcR9Q5^tf-IP&PkkdbN)^t3cWz&Z)k$>f_3d-1!!yDuPQ%}#r~1W{3< za5DFa_x$4fvbitrnDNV7PF=)N2z`eNIRX!sE>x1gheo-FBw1PRJNoxH=yH@PT17r- zb)s}v`v+fJNRMTh}z4Zn^eDjq5_y4>A zmt#WXrb%Zy62nxrPTV@Y{d_p$A4A^{P-XNI6$t~0OuIA$T5Bd%8nRjI0U^|XO;(J~ zP-Uuy}P|C?U&) z7o)?uRD+IY^*!-Env2>+$H-JO%eeJ8pFAlBkPhnY5!pbME)gk&apg?rerXWdklj`- z1}~o0(b#mqF(zf0!>Ld~xD;|0kQMqNWDa-YAvq!LU}%eNMS3p+O@(rD;(xL){w!By`M;>@=Uc2}MvhRBW?>7=$NB!2`N zMVPEI;7drNR)mr=EE`GRo2u~Vz2>vfX?xArlzk@I6@4Ex$dj!yWhq@eTt2VjT|c-m z9ubA%W`<0wo4(fZq0_pmG|siy11l#EX=~OD2uRSxrwOHjP%E!y4)=mT8Y}!1jNmel z#Zy<|6bbG)r$4090DQkX_*Dqv=p5|yuoMCLZUEiv2C zoA5b8&+FDahHe2t-7?Qo4ECRHlH_B`!;jiE3_SmD@TgZ_4M@} zg}iyPeo+k?xcl}YOPRL-U3YSp^F!x=ec)KD259y0>19ip-R`2^%ji3d^~ya|M5O)J!lDj?dm7DNNeoVX<{{~`{{C%C<~%klOBb4~74MZ> zQ7IjC;H$7w%O}`l=;qf)YVO{_+1!!CewwdEvXK_wLqdQywIM0oV+=iQ-qHSW0OCI3!X>SYY_amJu$$W2I_&dSBA$E)%(hA0o`VcCZ!=i&O+^AF#1MMH`o{GJU8_VzBY{Vx3*Q;ul2{%GZ z)M@cOUAMVtEjFFtT(dGJHIE%c^yAHk6;|fG_EPDKiMs#nj!DbpoQxelpING-`krc> z6=~lZ-hhiVbMfFf$|@oBF_E?)rnItiXlk4K5gTx2@9kX^d{M8SXMztqzBtN7bFPmh z=9<>K#h_&Teuba97DLsa@plfqB7cHgTe;(?7-4k4NBZ|LELLCrCjwHkQ?JY~8Os%R z#p3GnrlfGhR3z(IzJ;k~<8)ykpPws79RqY!vRM}yjZwC`o4x}Bcl;e|vCVep>%*Qh z414KB`!c-${%r?d=2o*PP#2=unKiRgFD3-xS#79QGsZbs`>KBX74%U|G-u}n9|78l zwG^`;)$hvKUzKLx-SD`b_&RqT0V*)=1Xn*wA{*DI?V2|UcLQ=?C?msF1swi(=2m*{1(kw=vC%QilGk=Md__BKOZ6i zcMF~G^m#ib3+KukrKX)#FPygQC zR{@0veKzy}p5W?*{lkIMn^7k4@S_wbaAHKN6@WXkF*KYya{>|g_O~B~+2R~jmHa1_Y zm*>xZPg8vZpr~nr{Z1_96jw>ana%|+-x4l4$C;(7RGA>p;;%gbElA$@Pz^k3SPl^ER7WU4pQTTokqFC@PZ?AW^od(8A)ti_AGl zk#j|I`k6t~f!o>#b8lXmIG&X4^S~P%Lxi6uzFofCqiK_KjG!1uL87Cg?Zn2nQrHQJ zv3zIlmyEQGdRdXTGJNXyaPG?ak6G%_^&Q}VQ^!FmxIp2Q_ZEXF@@d}vJB(PCX>NIl zvGe)uEqr-#L1gm#{O})qLZHV$JCzf~YV0`lE0og>m5)yLdX-V@w1ubyDX0wA^j?Q9 zYE7qD+I{=`0Z{Sbq)v_I9Qk#e~f-UV8e&S$ii0Nw3kmELuqJ&SvS>g+D>%jMh@&Q#Rd_v^XJPj15dY zt|J0)DGIG@J1>N5_nz-n!W3-ZL zxbkP}Z^6MWlcD17CUKaU#h}(nk8VGo&Fw)I`~x2KI1ltj>i)%6T0MEnhN&Eac9+Z`T{YXOf+2vRlpN2Fo12``r~ z_dRW^wS{jz2OC-c_5IlN+;Q(Xe|ee}IX}4yc{!haNm^^&b`?0k_XfiLkJJEgF5pAc z{&tyC9!OyF&@-N+H5vIxTJ}W|_kJ+UV-8wAqFh<3tOC!E{^?F`7G?Q$=#384OrLkp zi*h%*S;Lgz4dVi4?qJww#t^T}r7ei;YdfKp=8+q#ffM&_M@#KMod}!PN9-eoDaWXR zyq^Ciou_BPAdDuAoM&gwEOKOC^jj zw&8r6deyX}BT#mzU&!OXBA~QdOLo*LtGMH6x>BsPA~3$)C+IvO?r-oND@~WIkq4zj z0HQ)qnnNNrG8gn(djY-Vhpy6G%?X=T=?cy8meHWS(D@_l5C)^>-qBdQeg*Bc_9*+m znhgUZvbn;8&waZq@b>ZkVbL{JYeRhmBmHnA0+M5+-vFW=V7APskn%L)##`>wKA6@d zAhrs-nnd3wPw9}y&Re>g#H8pPdJmqvit1XuFTq2uC+@rKpu-qMT-U}J6n^?W%#hHS zU<|GqqAZ9u2OJhxAx1q#%^xZmp)_Sfb5u*wdPosH_Dq+JfzAJl3{~kfvQecYetjaG zQa4KJtBi&EI7gQYG!J+UbbK`eIn`S5lJfV+@2DwD8)f%0B8Q;Vyi!g8>Q6h&37kBQ zaWXw>aHNrF=PhV1gHeL%JLs#rw5DT>T9O#I02`&>;6vW}C6<)2Ku&C;Z2Pb>p136> z=oqBbfeVAw)Fmek|4ei#rWsadV99O)A;8Sc^+2>N99p8*_FejQ%CvS1S_FjlvY_!B+z};lPpnbsazQH)( zM|%FO8I4yDPJ>}_dF*h`uq(jqzRL0{sN#o>H} zuiX-}@`RzY=@V7JvQ@NY`I($N?@e0$c%#8LoY~*&s7O&qyO9VDFLqFATkR1ppMMUUGMg4sj2N!E7 z4t?_Ue~CV=)~jL)&MIJ#%R;&7r5K0+Xw(1f?~kgNaiyF1~B^Qq%x zW#=D^5(_b|-8K^8PJ0f>Ef=Z3Q&HE6XolX`*)|Cdxb0a{l!WZ74d;Hf@B6sQ^Ua z=xzFN5B&%+d*;NxVdt!&Mz*5|F?TAzK>})iq;l*^u6hAfbr=egP#b~0N5$FI#D${( z2iF*;x;15V;-vb%k9!|78IzpOlq;yH-k_*y?ql@!kkQMlUyX_hwJyf!3rLZs1B@3g zR!J3-kd$7YGEy~48D&n6)j#e>iYJ#9Lpng&Z{>AYWiwfc)HTn#6rTJ%W2yPxl7ZFCiY2PFq zrMa0z;if%geChco^ht;l<8vs`5~fRIDsX&v``j|Ob$5LNch;2wa~w-Q|EU9Reh+b^ zv6#2r)O%yQ&e+K8X6#UjXW&Qxrcg?cM?KF>c|HCFv{Y~A-FA1cq?9@4IoIeg!oGb7 zuim}8BeJnWePH!{zT*7yDIlRsuBr_*cpjGXPUN5Cc@3z_bU4D7tz?8{aluXETT#m1 zqdYzJfbqmIrLs+eV@bu1?+=05S3y4a0?PQot=Ql5J4=e`TN)X`7?KFExjjRKh3cwa zUZ|FZ?ob@>tx1KpJ&Pi$3}?g|SDN_y##cPcJ!F<`ev6ETHH++N{Marfv%=d3O&ey1 z;ZC@^R%*(07}zK3Pp@x(524$qx!`}6NqI4_p4TcNDaKkN zTP;JfK!3Nkb=QA7UqvZ!C|c<$o1-wXZ?Uo@J7)Ad$ z7{nXEd#2x-mkyRNu>rMjXi|FFLtPpP{JYxuGklHP(I!S^F z6E@`)!Xr3;70Qhx<35r9PU4iTy{!c@x`4;gChhbHV|4(`EXf6H_nZ*aZZ2G&J=*BlmVM|q2%ze6EhhFkTfD5fK`)9~^t7PT zhV=sFtzd25)IFTp(qCtV;ATTV>I7>mEt1e&ukMC{44vKa@3p9K>wAOuc?tiwOwNuZ8Z-YiKDR1HV(3e!6%+879jlPC0DqMz|7*$_2t_;s~_F zQNt|Nz*_qaBMIv8LyR))sInT%q{aD+2Vb)mibL|Z;5U49Np2GdsTP&m;(;C0Vv)=) z`2wwaJ;s`0jiG~sh`L%s3^=M%l$gdcd{qZsC5GUMu7)}BZ67PUWfoog59|D!7GB7u z#MFtki`9U|RagF3qzXD*hpGI!TOk6fVJshPNROvB5zk2*OpuA|m@%BH$kfSWt4lS` z%gU|1J;p=9M;7PWW%DmmQoRDn{Bt|b!RqV8c=wX^LbH#}ArDvbijdO7b?zkb)Em1* z_A`RN^eNNQAKh$Na&AB|tF4WX@(9H#!bZ^vURfl>$k7C@ao|`r>ih%mIH>r#AIZN! zQd|b=gbt}O+Q^Kx{J7%4Eutcni`*EeBN^>9hMBRV9*z?JY0(rXkOdNfEp=ajWwL$P zKNv?LB`g#4-OJnG+=H)Cu*bPWUsn4)#?3>{?k5-FFYli|PC`n;{Y>?x?78QI64uu2 za$EISsUDtx)KU1f76)@9e3@O&Z_;DxBN%r3sl{MWIAcohxPE>{uld=IOSiQM-Ex;6 z7Vn%o1Kt@gZ78OCK1JbMn04D)t5fHA*A%ZKp8>&-r^e~8e*al!q+XIkxt%Q9K}sj_ z%aGK^79-MOqQmM1$jnl^VYXJ53wkggF7!i+D68-YUpBYH%+DrsW0bk<^IspX25>z4 z>7l4oTKiLCiI1v9$&k{r_kuEF?@2B>hM(bbQRX8NUb##2l9BmMW(V%Rb+X;r4tlJF z&@tb~!;HS?p>`qzgC1qb?sixnU+xY{jw&UscDXkj&4Eq_L3)zme&1m~yQ{4(WpGF) zl2#=QN6?n7`66-WriYcp1O{U6B0C(D9zn8T?pQB$-RjnYhP%2O9!Pt)(AkXc(mH#k zVm>ho2Dx>abd@o(@D8;$)+Uzo&NtC?#eCv zznFkpHyrH#EJSzYf{dABj_9R=rl{l~1QYZL1=hHSuIjGcxV>J{hBTGGYtYDyk}5Iw z(cn4)3$sfYO*^B}&T5R{&(>dAOq-A*%?~^}0|;DV?B}oDk`~&O&vRB6QxXbhBNPXx z_?L!L)J0ouTQM*okk0C*a7yP-U$n^d3^e_pu2Sm0u<5ZerKQDyaJ~TNq<;peoqXRL zV-Oc<;O-NcrI##gpU5(?0tP6YSI*d@&A9t3tIJL{b{)NH%LYm#Gu1E$=EhT0Ka=QW z(%dgu1w}yPML-X48kDht0GjF-4orQXbgAw>tz}9`kbWqiVc+B^+0TCOL|Yc@EKQ0% zvDryyi+zNyFM^dMBm=vfc;s*}odZ$xn?hbM=upZ%F#VDr$$+Ge>}Jc*8YLI(t(Gz% ze@8YjD1ey&7{nvfLmS$Nzk*Sx(qcwCF)M0XsY3)Px_>}wbb=o^W;+{8V)P1+y{mC* zHBvAmXN>(t)e{D*OG>ALLgkJ|cy0}W9Gky!a&@JvVM_x)Bi)e-T^|$1EE93a12YXT(r+y!%<$#F()&@J{ z6Y|i6HG3t+5Hn=vQE@cw)FE{V6-zUsjs|o}lx>_5)BD;%-KZ;K3julrsq9i&%h9z! zpM&>|1svtj!%ldU-(b69jE1tT?&ow1G<=KTgl5*L{Idt3KT1VY4xb=X&#a;ZYb#WP zDrPTv2-$fm`B)hi7D|OfANDagW#t6kTyueSB8dDvfc}ltngOZT7vIVfbnd4#J~LFV z7N$aOA`Fx4y_#s0C2KnMmLYTcYDciJ)GAUxmgL$}j>2yexK>c)@p=9VV*s}gqRt*I z>?Z<2p!jN8+S+K3Tg0uVzHHMv(l;pgKodBxGWJeg6@plApHRPc=xauL!^ivk_=oWL zOt>{;m{_KA2{pr%8`-i>xH=l0w2DhYR<7H>^-)AUIeN{H$0=>{|GLxk?ZS&sC0~`C z&2QzD&9ByTc0YYL&f;xmk%@7rDTl6LD1`RwNbY+2t`^j1PZHM7<~%8eQk$UZpSG>p zk6Y_km^KmY0$U2!?tYg7F27lYjR)~QS=vIx;YFS0Rqw*2$MYe@^UxJ3sDt|9oNQU^ zr*X=w$^S(U@M%md(>9k)zs@hPU~JLwyiFB~SZ!oYLeELNbwOmo@-P=zR2`?1nf=CED$*;3bO zg!f=-^DSA4*wx5HPDjJZpA>j2^#8K>odN^2wGdYt3t(Z4 z|H2(Mx}EuQ+2`fb@hMq@;}@GX@M}0IYkj-AnvH0ip0G)ke4O!6*@j}V9fra66TpD% zC;zu!Qi1Wbjqt$f_}*TgHRL04O6&&c1cRpMXHTW8fuUgB ziBBqYagXRoc$q%+AqS7=)1gJXUtA@*gNJ0lep?Mur5PzkF&5ITjvO`15$`PeT+4Gw zOTBZoDV^X)8|LzB3$%oK^`?uOYwxh{QL8vPrI(5S)_dU`ljGzDGAhTlH!CsQn?IiG zll1i?WkQ-m7}Ke_>vllvG~L-Nta9qn+{f2~dKOE~=)Yrd3X%&xO6hTSgylj}R#G!Q zzLvn~%dJVR%3qrUm`XP9CJSF_SLW8 zssgE>kzHT&%u-(Qx8V%3r1gmlvMQoKH<BvSxMYWENf(*fe@DSL7D)UUi**yzF9%#2w!v~XaJ{Wq&b;@ zYK4!~0~kp$X4rM$_D0S~ty-ygkM*#zND<>k+ChSbHBpciYMuMILQ^TQvPW(>xQ&K} zDNzx8|J9ah-0i2+AXAu#GEpLHsxS3QSK=25I?E>OIoU<{dmpg7M= zs15Z+Vb^0ZQ^)Z846sf5k2OZ?YxP>3qsJmzB zsinV~=@;`9;yI6|x=OI&HdorEErU1c>{|qNes0zi3MslpcO+mX9Xm(=q>^=&|0xi4 z^41sc+kkGxy#3^+Bb9B2*RrF#$?C~rXQ;D@uEpMiv?gga5(P>hy_p$=sKRn6!!4&C zGJQjC!7_575nNs@rXeWL_RwBHLEl|pE;<*klqtf=QdMhWwHCMKq08&kYN~|{Pb)1W zQj25y;wLx!;%U#KF&-fsyFb*8AcQJ31!OvtDDO4kk&3+$Pm+>}$p6hP6bri2r`04T zUcet!^9v<(!%rlziP9dyTy3Nvhb{@Mqe`N&F31)}5Ls_to$KTvxh%PuSl^r|ratH| zR8WI6)6h^HE+0;m%xG&=KtZ~!Ht%L+K$kr`p2r58ti>%iuR*fmo~Cz>RW3=ur5!rY zPFgjmcVOnJ;r0{Zzz{SVGRuhcTQISU>*a}lk(Qd~SJKl&US)`zZHIlZu0A;{{mh`S zaFtvwV`7#=4QAm>aT1iGAhR(DH+o$M!rUUyB4lbFXMCWnPFQGT+-hcDn}{wN3T&gF zXL0oN+w^TqOvGy2e@L-Qfs0sEjwPaN2@Y5@sWT+lkA_l@G}SRq48#G{ z=*@&yBmzY*Mp2w#`+g9;SFiShyGCea6K`tvnR$O@>^h&d&Qh(4ACQG}({BG}3 z^=cip5`|#-YqQEZeFsF{eC-z|9ey<=lm7GFwXfNl(RZ=>(=*|gIMT?4>zRtHSyE5B zwZqz93z~^vRT>?59LEWdsMWR*-uZfNSa#%YpNsA@mr&lPRP1ERaAQG#XcN^pc^IO7 zn_t8ND-QjF$Wdm2iML%*Js|FO+5}LX1xuEhI@hjs?bQA-%piMj@7q_Pc`0{nOJukST4!Y=bzA^?BAQ&Cu)@h32DlnhP}bW#h4}pL&$u zI#6n!cBT6p8kUl4llAZh7-OhE z8{ml@dGe=30>Onhy1UQZx-VvxVzd!T!3HLU;6{MDX}X1B~li#?CuMRKS=Nldju>@@#d zU?JIugL-Jo}wRfd+(iSZI?-Pk|w@!?#p)nesCaO_kf7^B!w(b*ct(c5I6YTaJz z!}3$$QS{czS}k+sYJvbk2@}(@40#2D5m89$ce$`nI*{>s^HW_gOE}rD@GOYWxTg?% zwoqk~cq2PqGtRl-DEPFY+a!Z(g;8|8_U=((cy)s9Ak!&_Zg*_-DCCPsz^*%Ct-35! zqzbQCmiUuCf!EpNXby*d{lr%&^FCYWvu%i0pwN#Pn3e+r19l6tMZRxOo9R-USupKh zwrL$}8fWc|=LVz>LTUTDvNSjl6D8oRUn@cv?)_Sv(PH{vIY&}UjMe?vNiFg@3ioD| zS&yLdmBZcDWu3h0PHS4e-f##G=Q{cHwy3)EW$No94%f_eO(;q}io|I-eJXe4qrlKQ zbxDjJXH3wvkvxD)v?E>i?!>JawM_7rh_u_MDh-F&BbH3zrM7ORta`#`J(*~=FNLs8 z5;1aXB{HZ!f)Ja(qXETRJ%b)(l+w@&tp%61u^&vQ8-nXy4?~ClhIX%0@}!c_Hj+)|D)+F!=mcmc>NkEp-3~N zv~+ifbb}1t-7s{QB0~-cNOvRMUCPi6BP}^}!+?POwB&wv4NbArzTIUPf?O*TL;89*@>wo?Wyl8 z%)~!xC{jb7*|2?A``~rAzIrlVlrLciHjrk@%21G+C*mwEoD`WX z=`Hb&F~(ME0zU=V06m6|6un4wD3;RGN%3G0yDN9#IK>S3H?wsbGm!&ZO5T1^O`6;vFz8 z8NS!4=mT9<%|UZy%B|vPWS7q*wi8W1L$d!Dn(CdJgW9sXzZ{t+FAyF(TbD^Am#-rJ z=DJCy&@786QR#4zfQ)iqDYpEGmLh@Iy-K#i6Pf{FOr^vAa}1U8ylZdcLgH%f;tius zV={Z*C0DR=v4s|rjTeD6f49cg&cVL*EGg>hxJB$@A|KJK%p?8?;=lb{Qq3AIXoH1-L60cV4B>hSGbPRRSL8I%5G zei8cSP0I+ctI7v!%B;QxDzD8`=Zi&gbYxmQLQyK(cF+S>DRIU3VBL&NS|v{lRtH^1 zE?kW~NLt*RmAASl^Nni|^fb?J});+rMEzCh)f*gAPeQ4rRtbBv~3dT#AZemnH@-^z)Z#GuQ z?Bh1!?6!ZcN`b)x+whxYCilmi(oJf=?tmF33a2w=42bROOe@WmBKa(Z-#r8o#O2p| z%%aA+&cWk_EmPkCu;gA~NQI?$E*7a?{=^m8)j^VHn}n**>XbiLU#^2hsd5Z%U0gz? z`?*GvJO=KLXfa&`8NGxG(E+&-^Eq>t#Ox<9)V^=3IKxvHV;~fa)rETFmCHKDr-!wn zs-uh5rE{(NHDMVp==V%+G2}AVo*P<;+rzTRkXXvd=F3_qMJ6YH__+-D!$evnVrrEw z(Dr-dE}MtzA+^jJ6x+*6h30-OYox z8VEkU4Ddw`J1LB$!gG&jwk8QO)w2P|n*ZX8lKhHUI=CZiH#AI$X`7d8z?Kug{HR{` z9H&&7sn6_xX4Bd}5{slziqgXYAkzMX&NA+AuP(TZ+dSMbXtTeJj0}AGRVQ71rx+=q z>JPR4wLi$cD%8EQ5F;06_CZ{&YJU9e@<1o~X2Nz$ko?LyOAran09mCU8&>JW>f=k{ zkte4}KL{(eZgf;S^CLmDi^H~3FCAWyI6C|2t%z&W@Mg7$*R=AF z@BLuK2=Jm$GyhOq%%}Qri(SG-J)FSQuWVT7GLV0f%2+AS^(o$Tu?Z4K@NLyqWI`92 z1_xT@ldWhfBllV8H8b5{L2^S$H~i{uM5!jDp#*gIe1i7etQw!lhWZ$3gJm5=2x7^( z4_G7hqs-F^)j5mbddL_^REJh@t~^Uir{#+tb33KYx^zVK)>Uv13CoP0`~P%`&v7$f zqUpcPcQR1J4uLCRRFF&#ufd3omPxg>K6`9h&Vx5l)zyVB#UC!>2g0xZo-}Vya^>oD z1^BK5a~LpW?89Tk<;G##Du++CVD>8*ZfP|cMG}n&*XE=E2!e%>Sl^&Byy~q`&ynGp`4d4tFZ7@(wW890<&Xdrgpx1H3?oDK5M%+;b|HVZz2MU*A5<8}cnmX}vz0zh8$iU&5 z9lL19#Tb$uEnX>$2s}A8*4I!PGZ)OQOMLt7bg|!+fWaX9l$YT91UaQz<_g8GtQrk2 zQjzc6x2DO|$Xd_ZctU^yvF;fDM{QISQ7=QUX@8Ot%{p?vf+<`wE6Gk~tYE8I9^xHl z3O-O)^m$$M%CEXc`_-^hyHcQRZ7$u7iNm(vN7_4RUMqqi_{Yi1cfC#Esqz32n3lCxielaJd!n;LV4-E9XSi`?E`_ zcPRsK1xcu@1tu9^RF%^03Z31&{hC*+TMiK=<=b}G@EOW-ip^nR=S{kV&#GT{KJ3w$ z%og!&P;4v{(Ph^SM#?m6j3Mt<4;EtWen>B5yFF*7(2=EjZj4)>rC;^2+0Zm zzxLO!f^#ij%z!cfoyy*=IiBUVL`+JK(Qf{`uQ4k1$}@W7GdjUU5ej6I^Ycy6M3FFwYZWFe z(?3FR&OxcqEE2ouiiXdtfNB3 z9!r(IA0X!Wo9B>MJUVwS8NpLZWyCwKj@8SilsYZkQGe*=Z~oIU<8N=jSz&$p9r?nE z94xGs?DGuRgMsYBZ&@d@q+hjYdi*xb2kG>Nn$NKb5+OMs`(t`fU=gZ}y3raSN6&mGYED4kX@^f|$uu>o z=g?cx7qjIRvA8NOAaSHt^qt}x9}^zZxdID#5t#~3J!lx3M7}0MHnG4Dx9P5x|*Fo zY5h#hbTtCNEBeZJdT*)@_JlFe*++o4UeB6~r7*W8oA~j1AlT~fTT!u(3bS@>1SPt~ zy}V8p8q!OYQAj`I>)QjC;70`U_EM-iwzGd`ym2XkDK^hY-4JBkqX(om|6Hp31+WNX zZukXC9kwTeZ?G1HRqqNW8>;guBPwi9SK{mC4TVyg14f#h3KLI_&qb@NtHCUFP6@A{ z$8%cHK)=jBd2t5XM2d-vqxKL$0}ec+@=h+`!KF#J63wP?T(f{)P)EXyl-rnRRR_47 ze-n3E6f^BK+kKf9JjX-Lk#H*47>lOctX0uJj-g+m(mX;V##yIZ9g&F~GcfRsZV$C#kAB@j-z?t=Q`!J&)k z2|b{JmQ{uDVct%aY=ikvgu)!Zhv!m&Hi{Ul$N-CgVc(xh~AVSc=UBJ^tWK(o?$!{fhdwZ!di^s zA_qiyd`&VQzBF5$xn1kmB)him){zQVCuan?AfXqM63|TDoG0BK^M2qC8J@FE!XK6v8f@t?q(f}NY2ubx?Y+i6>r zObWP?>-V|R&k}YeXTJoB`nS~m1@em7?H-EqXII_&0!%wC3U26V-_Zw3($=&oJ?{ntPT?3Df{vEHCxMLb$wr=fnyKU^|` zWm7JFhCqqk4?TWXX*4AdrC%}7ct7~~(U0bMZd~3cEd}f>-^pQ^k;-7Qm>IMhedr1b zEIRoYaC>0@>`hd?^0GBl=4gLiWQU?#R(ZyFR*kzk$FSA}DYF;8Q<75n?8?Os;1_8o zTR~FaaJ|T!*wOaj=gn}3DsWRHtB~vKc@kV`1R#svwiiZo?(NF}BYS#?+YgNCyg*cH zLS&rwAE}DJ1(rVCS1CoLAp!f%aKtMi7kBEyPnDBbFMxD>`|<$mz4${|Nr_EzGWA~D zS0^K%KwmTer|c4MHQ=irbS1Ko1z5@(W&<8>S%U9V#LvRT?*)Rc1cLikAC`lA^v%oy z@BS$&*QuqKB(=QUHlx`dd~n;kJsRbAZZR6r@V4x#RGt%Y&>dp>p;VYZuis>G8lF5e z#3oQP2{2tjoc&YY*hX)gxh0aM=0QU{g>-G+${TIv^gL=h$y}V5+BVuwO#H zMWH>bwg9J#H_I*Qul*x&EZcbt{4puqk=2PD8vpZGdN zKB^l`jGkRkv5Tei%-DURdA^h$+M0@4`e`u9kT3`*V)IBXxSw?HmDRxCb3HE11$`zN zbam|FWTVo?8dfDZ`{gJ~85R%B2!d!459~fE@N9UCMKhUiP|$$$)3!Gt(BeYl^Xsc) z6+aZct`#7ji;tfCUOD5u>$7v)U+-!=o!$=)VryGUu4F02Gs3PpE$t;Hs%F<$IK(5#havef9Hc=x6<`m=_P zo8k8{^@J%XXvrN9(#yP=kTI9JhLsccu=rN~z@UdN`ZRTtF@$~7b?xuf{r&oj49J96 z@Y*ZfI{@v$`}U{I_8znc@44~|_c+7gH&`Vj7&1_AgY^99|N9}T*-SW7aIbemYsFC2a5^aPQB{$&iV9(!pzJ- z*09R?6KwLPv^jw^q{ak1h1PQH@;H6{FY5aG*Pfl}K0d1B%XEX05&~kobh!<*9m4`f zI8`-O2D%8k0v?9p5423{U;1AaARy9jVgDU+WC0pkHLGB3{icT!& zz~LAIX>D7q?_R9m14v4v|C^OzC(iBoTpS!D-p&4K)tM}W)OO#9(w&lTlQmFe`_&Si zhVE`jNiP@t(HIm)c_h8YGf__$V|`}noh3>oKqk~#QkrsLq{F2~sMUz)J~z0s?iXF% zE2<+u>bf1!;S%Vt5-n-PCLHrKwI7=IB%Mlp3~_czqGe40EjeGYjwrV`{54$V3dgX@ z=3@Um6LarUUzm}MQ+T&77RZq++1Q4+-Kf$X3MiZzS(Ws!1D>FEAsKGwQ>v5`>y1(d+w3GiyV0shDcg30~&aFCT`gXj6rcUe53__U--E z;6C(vT~ce2sYBdq@WrJ#T}jr@3HjWl)jY0Dsf14^$_x%l&D|R_?auRu-lKbT ze=s#7gllVZhotdcwBQ*hCR2wZ=7TVei3H*xRQrj~!x2UQZ*sYgA7lz<)O4S$GIh`$ zetyB+tYC8J5GzRvawHA?ZUp$J<%mWGiD|2&n_XxZ+>252bX44RQGlVMzx& ze2afTm9v!c5(jkjme2dqPu2qW#5VJ4c9SztnYugL75)$BrR5P{Mipy zh+`^h>FOd%)P%8oP$?#L?)H^iY6``SczXYlgd!C+kEP0^xUdZ ztyJ3JYtPv_@P8Bc? zZEpdmMSh~O2q>O_N9PWEm`%wrH5r4)4!A-9KSfYuiqF7nDYE6|$DsRPHy+!!E`6Tf zGDFXH-U3-3E{faL)4dOQmYu*eJ2Yp(pZwq@r!|y+?9rCnXx+So=Vq;+JVR{087Gfx zqI3A~^{>+{R3yh$j;~J(=fAHR2VeMTiV`TaH{5(5O$E2Np1(B53pv2+PeQyx{6X;2 z$gP06`g~Y59^&JRTLu~xo5f-y4oT((|Mc#3+THvrgE#^)X;ehq8JfQ;v_5ax%gdI2x%&hypowd9T z`UO&2YI^f05%4&d@nfi zyZtm~&t$hLwlhy>81I}+d9qeX^plxW!v71_QvDRZQqWjHz^LacXo%pu^K=#Xst7EH zMMl*fIm%-hma+!c35(3q4%)snwfEh4lBU_O?Wn60Y7>dpb(!Ee*2TVh10J|1TlPVs zIcQ((-l%B(a4P=y|7?f4$&tmCc8jujA|vRe|CT6rjMp+`g^C5IuO5a^OXodA%F5^m zMsIwI?a17iJyhf{BdxMQVevTMe5_ywWQ&CDN6DOoigj+LNizLL@2)Q3(98{Cr7-1~ z+B7)uzLxq5e>}TAdRuM0T)XUL`@-`;+E`0h{UOdhVOwNtive*3A35svwX@pkz2&ES z5-Z}xtbfjG6U9^4Vp6+9&^SJVr82XYZe64v-7=PrTl7YVz)pRRVkL`72I8irf!xL{ zc-U8uN4KU%-Of-v%{@H?pYI`Fmkr}?gfu2UsA_iZpwM>6s<7vHjlxA{K{{uD-YKU% zvk`3$5Bp@MZ_SR1uyepBTOZs?Y>maN6lG%U3J{t$VYqcSCBbx8wcV;+#8;<_>9{6P za2kt-v1q_F`*EjPAF6O7sJT9%_tjbUWnwWo1T4p=U|6wwF4Zg@xmKBz6CdYvO;21& z8)4crnZTLlO^p0J!)0!(s;a6o#x4O=#?2=yXUOm3 zb*o20Srek7qH$n=_mC{P9vAui&fxk-;uh>w1)^_AIYV39sfeWn-%dw5B} z#J{b~6cWGUBpfx4cfr=GUuy#pFE)|%6DU?4iIdauNiT|V ze>bMgahnA$4^wR%W5xKfVwrmhNQcB8`x$Emq;DwE0 z^fkvAg&o!nFIbQmMXYvwOIw<~xbL}>oOO!_kq?oHc+GRkRh31IINhiec>J?naw;vA8|h&N;t0`lMROoP1*(ZtmhLM?^!RRj_?f1%2XsD-7Il{#F|QFh z#CL)t4kok;xNPYI*d18SC|aY!=I(DUZ~%ZAOAsjX?#cQ5a_IPg*2>UG5s zQOp;*nU{hVFIx)<>0g_tevRk{WMkKEiPM1nFX+F>EeHB$s;J*-7*X`lQEtW8g9~4- zpg7$0OciJ4E;YY>&0>?tFe2HUW%5tnz55l+BlK?KsyFWXIOBb5Ygf@ZndaGH+lzO1_(&?|ID`V^rSnQxF~ok# z?ms|c^M&Kx)xn7$Lv^1U(@)`sX-T|huO#~6xu?V4_;WAa;0b&cL`QF1miyno=*!o8 zdl)BTK-ckBbN9_#07o*BBaT{!bHI@DMtsT#>lYrPm4(pz<_sc4ajpkLFO+wp@bGIg zIKi^X3F=OWxjDN|k+J;hwx)-a>K|G4e`xgY5}p$iZ{UI4`~5~Zu?xw8x$%nPpM&rR z{NP(uPNdm-MzgbB2VGXWwbI-%XMfG;S0pkmJRFc=;wuvVYxe(NK^=)4P$S^2HV&3T z9Jem4x&r8k4)N(LwZkTV2&9=D0u&%wJ_g?o-nf}#e4zYZv+R+JRW;w z%vdtu&xjo;nb1r!d1v~a8EQxRb3c8on0BWZSukpyV>dDJW%wr=WcNXFSEgF<_KQH6 zuV;Uu?))E-T1EB{ZoO@3%oqCA? z`FAx|v*+0&f>byv6)*cx|uJ-&-cMi+h=v7vV=1lY^4BG z|B)bhmp*Ku+=TNgQO`x|H-Xe))K|s6rr2WrEOiN6 zo};u-l7{{kntdo!f<|s>5!RVu_Q3=(0ko;qb+#Z$Mw=0{oNrt>Kk2nWtQ#34ompVL zE@u%B3XviFCJA9!Qq^38!lvF*V++!9Ee(rQ;0BMQ>in~@r~G>RW0)^$@P)3q?D4qZ9rjV=Sz!Y(DUQFeUshi5*hoa3om(+DSv~(M@PP+@G`9 zP1)G{!}g$F!1LyySFZn`VBq3H8W#UQxZdi+vG*ZA88EMz^D%G(RRXM&h^uT!b0AZ# z*HWi)eDao#$h#mbJzYbD5hus9#)=m7f+^u@oB>I6w5Z=AdYVHJYE$^WNY^|1 zvA{Q}W*HbHKwODYj|$rC@w?4mNp-JizDbHdXgVCYSiHggVG^Z~T&xY&7#N_Xwmhyf zK{RF2nR4qQeFF$&br8IoTF`oIhfL`&KjNYq{fs{Wjo$G>5!l{96U2feNN&%7b)?5i zunKp+12dLfj~;9Yv;d{@SjcxgU4K2_BbJN;Y-H-qY{eC^-UQ?Pn+=@G3HeHTyS>Bu zY0(ol;1IBMF()(+IFx%4&7tuL);R6*Muq9#L+ax9ahUa4j~K z($7tC_13ZYGEmQ)`Zx{i?p0(bL%EC#N-?O(^GHGfRF3ZY@`s(i+~|3G4nR(Oc0@St zAK=*+r1L{5@wC6~1YxVI)y+g?K3e`mmeLNvi=QmFXsxt$d7B14I0>DsSITByiKYSdBNFf|Ovl+h4kWCPT>#k4o1a&wIw z+3yQjif;fmGDo{iksg;^G;GU)!3J8-m!Tpvln;{~s=VK~|M2e7H_vYWQae*#$Q-8c zxyH9$wQ=h*lA&`l-xR$5{^=liXCn9>e+1;y(VhEqmm{7N>suwnplwX{9~EMdS4DSc z{)nF(J3J*4xJ>MZ`^OTmhi0jM2s2xA6GBwqB?AxD2$41soSox6eMV;W4jV%e07Z^s(i!U^kKYdf%iIBEX7toSX6{DUIkGT$z6 zV{v1pj8W1sje>=Mh#NTm*>oA#SnTUvx>KL@5 zshT%AF2$C^zhaN;m zj~uA68L=Q^@~ym)uu;#-c)_G!uZmo5@A0M^2wMlG%(JZ48C^1UK9-HdA$fMYCEj z#EL;tXE3|s!Z)`2!}%RX?}MQE+T)5?Rn2AHAc?e1r%>@=RiX-w&%{^RIcv1gDg~9p`+lguYzv@OA>DykN z$iyt0(2TGK<`!3~_i}DePekQuKVf`nkMt?zBZl2A_zGb z2FN87#u)0_`;)QHRJqffI=^8wI-#{$-Dl^t&5WcVR~koZyN-^1=c^TV+*_wktsG4kH10Dyo;9cyCP5 z^-*y3v)YS0m9Z^HD&xWR5Zbu94L4DX(s@sc6=81Zu&^c@t%fE|B6JbU)H4l#JGmlCTV2$fmIP5NBtK@dS5v;s<*ZuS& z`07gBts`K4{r;;jX$!YO<`pB4M#BYYb5P@8m+86U#)E!!=rMNXjNiBTDP45T6DZ47 zKy*@k5W(-HOWPmxst{?mjs?fOi&2EMGy85OQ7$7NsxIzFO91Sl`~cbNaCQjIBS=); z!~o(tmGcQ(A(&H}t$ z+s)$lu^A5rkM|`xzE6+%^f@i<2QK6Fg}*%fdP&#eM-SP)=@Im<`)WQGK&2K4Z-JxM zYt;c-*K8qiiqeC0;1l3~> zV)D`D!l}?@UfwGu19qfOh6=(DMwH0qbVmuj;Tr+EZR^L1Sse zYt%{}p5)^JHy252IbEh6G72(X88R9)pdECx!czUJYDnrfuE`8=1y{Dnb;FXy>ilJ| zmyk?OlKcrBSW;J#FF!*U{Z~5t#zZHS5k1AY7s@cZhjxH+&$3vI8*(UIt;HfW*bW`x zb*20cGAiIQJo*RfWXHK2UWp1h)5e>D+j8(v_)1&N&iXZWDGaL?Z^jqvX?OQgM&c+a zvdK!+i;Gw${!3LX*odmvouWX}`5Cq+pHWR|##(ols&9UiRk%p`T4Py-oemG02)>4& z-2BVX@hLxhrHQTURI~Aw9x5##RWrCEN2UiJ5X9esY3F8r%TFEnC8$_f9~z#S$v1+L|9zF_9*JodZBx;;OIpY%!5ZoGC@0QRe_Jzd__1BH)SK*T{DX*#c|9~BB)T?tqG+(L!{Q|aqWJKKlsIqy}Z(a00x zu{+?wZ}Z?mto?!Qq$_X?dDgR2{Z7}RwY}Xy>gBVf7f$tZ&;G}534TQ7K)Y=!KAAKo zq?|T>mt?wtQ(FuVQMu7vkp0&B5wiU!2P$Yyc{?Sb8(`Abu z)@-?uC!Ynid3~!VfztQabp?+DQ5~H*Rx^g}P|tr`-{RfPNOv0949@oScX^%mgWodFp@$zGU|0)=vOwS{>%j_5+S3tUOACt zDqNyFBGx+@w$gkf8E3(VnCyQmZvtvvWL4kUz}z}~@4}8Vyp<8Lu5F(TL8{*!+sPnR z_8X4s3xn%9BbXNmMpkOe$RyIS)aOh@q^qtiZQHk;rVG>BubYmZK{oMd3k zIXP^kUra5o8A93WGRI2g9lc`XXuBZSYEMh=?oTt`gNpH=j^00sXo!A08X|A;otZu+ zjbayMD?7p|JgVX=?^XJ*5+(X$BeeP8+CI~cbm}=Ps%H`_vPU;^uYK4eM%IE$v4iJX zYt~Kz*Kpl}Bj+Oix4*WE?4uGP??>=bdqN{4nOT@mB%+ledNerdG9d49`;H$kAlY)T zTFoRIjCi}mjB2p)Pr@PfL~54sS!}CNE$iqw%&2Jswr=m-LX%>#eqXmVj6U^5))VTr z3duc5J9}7ysl0}BYM36;Ehcc!6yzBzpn8PYl`-Tx@RNISAG0siEE#IFCMWO(rYSs2 zuE~XMFE_8Q9q=$Q0Hic&E$;>vnZgr}UOmMjE=<0*?hBw74w`qOw~e-{m)^9#{m;7d zau}ySW#s?flV{+7m4z!HIbUmO22`;5Eg7m6YHl=XUxAc)OjPO>Qqq{C z$*H3}%CxmWV$Mhf%rG(RL%wkljz0m+;!QBmm+Weai|tqyZTfw4H%Hr> zS5J?YoPpZfmle`tyX5A!H`EN6vZ_~aQ0a}$vt}`JdNsy~pw+y@;&VQgc8T?$6pn3` zu$e?abB?#>^%R9dqV13`d1>*gO}CznM<-3|#}h!Ib<9?sKaStc66SK9RW$Q>)@xwYU##?)Q8`=hSEv&0n$O4^DO(ykAGX4+(1n3xV?4czcz7W{RNuP?|3$t6hFUp8&Q+;g(UmeyWzl zpXp*=TL-gOC6&_sI<(e0bA~6}cFclBH3Tp)jBAaLksIYAU7~E{M13=3tyjBeFUdKI z=-u*QC}NCuS;Dh!T|aD|>j=6GL#CuPby+X1`TfU$=p|kEi15 zds0JYvFx>obX4Hq#qS4!#;uc^<0a?o_fPk$*L&UfQ1QpRr%&y;$lwX*JDtL{&#HwE z`VvM8lk~~*>U9GZ9aNu+C3LN24MqbZw z8ktlO4BX+TD1D!n)H0U*v=>rKxYShS1SMF@w3r)$Fv{%izd#X8E!Hh-iHc?3%mqIP zY+G%JKMr);qyy;EfQgccoSP%(;E7_VT@K<~WIRfN`6Uy5ESFnwuv&1}T9!%tBQfAW zDB_%rIQHw~6tggbarIazk;HtS*NDiZ%$XG{`LNl`jft^9_4Q{1-RE>)W8;=+K$+WC z1@+1QUquk8aB#hOVbT@g_j~Bi<*KdJsxDWT6|bTQjPGaaWPgI3?ED#Cp$v6d2YWl|c;=8E&5zmM#+IF}LRGUO%#r+I ztuP#7bKJ+IdT#SvDoB!je2WG98+b^qeIGlcrUFeNuoSd5|C27TC#n8y=`At!M~iJr zzPxuSD7pVQ$a~B=xaN-v6r9Fk()Agfy9AjxInohI?-x-UM+11_G1H_aTTM9Itg1do zgJl&^9wm)v(%Vdq%n7ysflIu|^#1FQ^34REV5F7*2sdB|nt&JBq`jE+bNz9h?wXw| ze;ra$c-ir2lvz4e*<=4skMh5j84wE=WM}`9p;2Cax_0`TPLm!%?+y32YUXr%j%P2A zbT^bS@#z)RdfFssJV01X9HSN-wsB2c)+XyJEbrFAy2T{m{L;djlCPjwG*O%e;0D3Y zc=)(r@tI_Bt0~N^c>!@9i$~leT7QHcfT}vZ_M~BZWhHII$&PP<6T6Urrx9To7GDf8 z##VP?ZAEt;9Z0V^Ugf_Nt6uHgI=*D7f>hlchp(PKBD+y)Pyb9>Gbw?8FxgkuP(KZ1 zec=~pN$#s(C|_RGtaXQ3!Xt!fUkYLp?H9_O6g)~DmX1s#$8?Pit$7@g?szx-Yc8sV zH8FokKd-Lg!opAXWaNZY=CkndH=gVSU`E{KW6mIbg~tYL7&=V0c!cdFGr$J%lVfG^ z|7>@2<(_={{l^QaC8HwEU@O&_kJhPnfwoGWdM=x}h6-r`f#RHQR+`d;VD^x2d;`g+ zuU3XWx7^e3XvbL+ryLi7laT7IMpAB=;&3mOqL~)!IHm~Ohe>UX#0{U1XE!4ss;W<} z;qM>6(%UBg1Py!|I`2N2ARaFPI-g7{f0<6~{CLS~o*3u^n_g41i*X#e65e7RZSegq zT#8$Rx7KMgrBqbG@g+f#B0Roo$<5ziN^9s!w21E2{H1q?(^FeP=|NPJ6L3j*wdSFp zL#*=}Xh&D_Ma^BK4*nS?7L+#s(HgKud`?XKomq~dB+Uf(YBwTVjV}DQpPc%F3!3uW zMDbICsMr^->`XvFfia~$^rp?J>A)_B1R)Poa11!8SP*7uX2_aa#5`Zo;q`=XxmlAk zq!;T+J=+M0WHN8)wau#RjjrNb9L$^hBkRIWU>>&-Kl+O==_L0T@3^K`%v5&MLY#Z2 zKCXdzrUZReb(OqXu@lSwFfubq;7;qr@P??)8dNAf!}}J=S@#oqc}wpY6@J#}HIzVx7?Y7{?EK;n^LUoFq}rGC z>#zc+ra~$K{1f|4BZHy56e4rw#QfA^v>Nl33(}|;^kWc}Z-^Mfn}XkylUg|NUS1PU zw5ltE+x5tn3(dBEQkhs&-IkR(U55x?>fXrZCfa_5OzLsutbnm%kI*Co4pg!s?Zd4e#J9ks!aP>U&go;MU`TPQPn!h0+e^yOvjaD=e)} z`2?6uOeL(;8eH{|DZ=OnZkZc}Bkr2J%Fh>y5dHTEC>}D9`xKj08O;k$Tt2by=0e zwu~^lK3P?@L$*qb(cGlwTNH1!&49e99zow}`|3li`2G6HQ0wXAga7yrR;&C8y%lxn zV01$q$9}Ojxh&927{Zs_>}-PIB`dbuI6FK0U(hfEM4n7 zduNP?Yo#$M+iAI9Sv%^E^F~I&(pjDh$*bALuwx@w45MynN^m!+U0Km#@zmVzT(rb= z`^iNA^_wd>Fr=-je;8}=JH2HCy!kAZJD1t+P(+GJG9*hD_p*?)K)$eM@OcFze}>rN zV5X+oT(yeVOQ>Yl4CVHq6)~6a8FU zLF?RoHEWq$8O|&5?$+(e^p#wiD;h#_s<;JM{UJuWd0(?tnr-yB5vf8SvtA18dUGhv zx0Mg7uRD#U%1X-bcHl@#9}s>ndrM8&;C0xfqdSMmMQwHFW~*l8dzQBpmjCCriIiy} zzfkr=gH?A?=@r3qS(3%YJi7=ped?cSntoJ6*n|ERmzK{>r~Dp1ld@393dcuFs_UNj za-vO|vP?A4b^R4rzhPq{NrVg)SsTCNPNwf6$4jFcv2t=v>K6>3o%Z-n|6_*)CQ-s_ z-hh*uJjnYxk-s-V=#uzx&*U*}phWKY7&{as_?P_j=@`%|hsr2tkI*PEW&N_f32dIN zC@>~*va58dDsrPNAeWFEB(=#`#&DCRUHOrK1~RyLRe+|+%uc{jP?4`byrJ@~mXO{d zQ`NzH$duQ%8ZAu&Z+uwQ5^;>7lQz}_ZzuXaHAJ(D z;X?$qd5n+E%NNvEk_B(zK0uUP=wwiVXi*gAXmTq|O(Wi0oV16b9G4D~rp1t#p?j9B z-HybW%?*`_-=xq5O*DL=dDhId zIC6lDIui6E!)atkt^4#6A*Q9}>K^#5HtaFLI?bBY@;d18rt|(ObKF6Vk?S9jUg0_stOni1E<*qi zdcfl~V@21pSLe~ouArO2GY|7?gTC(2xGDX`g>mgr`dU_~mFgddVzDB$O4i%HFh*@& zs07KSBoRAPopK~ORx4W_-CUd!Lp9bvO-qF={7WhvQpvFQ57)WGqqlV-Egc~{U+=0p6T@R?)>#Myx@Ml z|GCl{Ynpt<6PpEX=$A}}mF&tAl@&91-oB)}3y`4ZW z!Mq0rino@vzR^|+alGqhQ&X*m1%2y$~^g_rAqL@lF- zpT+d2h9%IJ`MCWdKx+l1^|2@!>2;I?Y?aCHZvt~IqpL|PE_W|~clVO$oemS`RMe`j z{ItjgyQ?d%^WjM**UknV1cBYE)O2ZPGA0!uJ!*Jysq3S#>p{ zB*QPG>|ca{>zccdzmkqp!6VOgti+A|kG&SG)+fR(uL)5U#Wd~|WSqj%?=fB<=+voS zG-bCxy#XIF>oHAfD)-NhIZ}8P8W;Mxgufzkrb)ll9QACGG9Wo%VH@{ldSilQKwQsp zus4*K_>?e>f_~W8WIux{F=-%`=nf!=9HQ&rdmSOiH#6Pc$C+_IMK2ni^;=KsdP~iS z;+DiVy|)u}ru`G^@QZ5z%|^yUrwPl?B#qUXYjGMz<>PF!w< zzS8ymk`iEFiUaA~M6$NHNGn2e)`Hd%Hzy|6UH}Qt$ zEw+b@maN?^4u*95AYSx7zIR#i@*7V(%A-60dMRhp@a*3;ksYR5!v8q&lQ+b`@I}u* zckKH&M>Zx-|zSKMc*Ac_&0GOev6J@1lHjN()>o5h5!fFSR8l!{WGVN(hqDc!7m zU6oNn^--FB#Hk3QrSvLJSq`O$px+@yc7|x4cKw3PMpcGA+r7gm->&Z;#>C~oWnjzU_8-{sQ$yKmIcVJ zMMXN#!UQ$fAhp}VJOhu#K339y9&30YorVfo|YW5{Eo2ltVSB{A=_~9-q3JC zrTkwa<>K#YQFfT&rN2cYo!QtR7d!CcWAt$TlziKNhI#cga$}+~_Rgj})ZLAaLgdwg z#=z$0c39M;rm<$lls8@t^DC8X+-LU2(e3)pSm-PAIiX6InqnzJHAq_6E1Mnl51O$T z#eELpt0rhax^+QYQOsKBGz(d!Q;o&v6uR?JJj_=(Uwrs5WTupf!EDly(wBs00S7p3 z^E6w+yAPdHjK4#osJ>Zi6vBCo3W=UxZdTg&Eg6!P-;lgUI=xf5{xp|IJipBApCH?e z8Xki~g>#CqEx!p|6Ds5qaT;ER7Lx_wL@HgPtEBjTImzION|nj|=Gn_6z+E+(RXIW( z9c|3o#r0XG=lD*>QS-wAM(w06iSs;8aZ)YWeyc7LTiIG6vH^Mk~bkIQQN76Q0*?v6tm4}Nt9nSXlXKzNN@)ojGr8` z|J`bD(~jkiE!YZhiTVgUoBzw^GE*t4DNgw^^CoudH`g^2K2v&;^+iFCoSHT%rVJss zLuecx`|+FoY62VKocf(04rB&OAi0YzT(+5tpX4*G=d|cV;kU_p@@vM$#-vpxYIBJq z+Z=yG9#t`m&}s^L=#OErO0s2ax>k1Tv0{P9yGY(uW;`Ry6dQZ8VzkHYQ`G{?;mLs} zOZzm0@;8KWLLECN;7w1qFXd@|Mbm4MaA}Qals|hgP08#v)?GX=(F#Vk<5r2692r^^ zQdyIRMSr0hDFPgZbcsp8c$*4Y>QAo6WH%+oFmAVkjIh+O$mzQx_C4qjJ>QCq0CK&e zy111aQtqWqZ#Z(Mu5};OV*@-R^^Wj;L}0hPlFZ|_2KCoaN%R^pG*=-?@So?%Q_nku zOiWI#5qfgS4Qgsuui05@;-`X+oiJ0DefN+n}%d&#i2;I7@lq0y4 z8eLC0@OnfkqSA6Hx{Q`VQ;IG`JzU(qA$_r|WZ6 z$}YxHx(D;Na9R0^aub#<@V&d-ifWWv;IfCam9Vj*`S()sN2%iFWR7686f?+x6>vpO zc$13J95mgJ)yRG9Du?yiIevAt*wl4MC27ucf=p1scYjW2)+Em6J0G#C_?jqPH5AXz z&uLgTs}cKm;V-vKYqtkxFW-QLT*vYnzLj-tBKOU{*O%8vhRIxG?X|sh+BR3VIY+G_ zS6@avnk`#(TtOKiLh3jFE+C#O3iGm(FntbAPKBAUk`jL)5K%|~OD6-UU3(@0_Y$B9 zVq*8-eu+&B`tkGU2vN-R7^)<9yqKbmt8aS8$*ydgUC=^1HAZZb)}hm<3qty;BqR0M zc=u>N6&0w>xdp!zM?WeV>jW>0nVYadM90?IzC{Gz8;yf^=L}}rq0RH?f8&_$aHMii zMCy~UGm~Kw&a_h-eehmTTtaq-t3xYqvMX~sbH$aWDEilL*hze4lZ#P9xMDfhMgQ#u zQ0a9`#0=vzZg_vLy3{6klOvM%kL50}ks;NH0*67~BuD7|HCuV;L8j7&iiQ;YZ`4hi z_nLzkGOrC~E7{#vH`>_(MtJ)E;hnJA)KX8R|I#Q(DGDdvte@gEZsEcs=>O~<>VUw(^SACD_O zp+C>ikHa3V#yra+n1vnOQ0iB64%Oi~@wm6gddzsw^zy~?Irr>qkJ!n9TSW!Wo+|60 zfYC;`0>wn)^rrJg<}}2$!*9Y{t83A{w%r!wI9H*RqIkw(K22^#$Q5$N#LL-YXPefY zufrff+)Lsbmty$PwFOpyB4sKV=v2hgO`uIFtTFfd0gi_rTzLSP7mAUZ#1iIYo>Lj5H=QTaz+6HW-c4Q&<2!6dk5u6w9IG+t^JQPvtDDr9kFID zB{5-n$zLODiEIcQ(xyKjjXFYK0>OksP)?ed{*^%av_jvBN5osJzNT7zZ92%#j?KWz z3I+F@)pq|#23+6bIqewhuefNstM>+znz~`6h`#`DuAA4^}=EM9T{}`xA zF25#Br@04EG!Mg#o~wCz{N>~&f3oSNv+3czJJm8LCAUuidkp8(jli3?S<0jI^0ej~ zVrM>P8wK99uAQFsu&*YFimzJ5;n7QJ6U5NJTm(JmJkH#%-9DYTGM{5{%<2EY)0RU0 z<|SVbO+?Es#l*$n#{W{I$n6+1B}DCr$NIoo!3r0p4ZFL>$Nz|5MZPKXxqOm)a8M&L z#r{a4l9=>Ype)OnttQ2*Nbh$xRCuTk(Zy1%HN4Xj#c;;Uea_k3R+Ai6{*XFNXQbr`&heMr$KK%glSad>HPTWHJ|tLB zSP2Xc42(p-vPItDmr8#Ost?I^^=#LLUZcvjmx zI~k4mttZ>t{U9q}r+?CghAEYLWE>nElZI1(rtZ~^Q^42RbRhV(-dPD&oU#+zak6l7 z<0&cstYc_2S8*h&M{uk$k4B|twQaG^P;4O+E-3KuV|4agN||X4)DX=?09h#flfV*5 z68F$J?JzSH7|#y}dE(BOt~Q@TI*LozMOUZt+JhqD(?I zV*0O$jDCfros=SrLwrjvdwNLLwWx+QiVkxJtSi>q%G?WHiA`+|4aG@GG+^cSaOC6Y z%~1RSALm(SWmpEdc?!^B3>pTS7Gr13acN672VHb{A0t5SFc!I=8Ux|*+TGI@#2hA+ zWSG2t;+njICwt5=J%oYwTLQh!Q#?KWLIsm-926iJ2Bg`hhUnB|b&%G{)rp^m;qZ^Mwx$1w zn)ZH^B1M(oucacT3sN(n}wI*9azWgHrZG9a$T-6!iTus(*tb zmSTaAx|SY-Yr-`(u}4d*KE4r)MtYQbnG=nKXcN@m{na4j#&2UVzI7q^;zuK^p{|4S z0j$oQxQJ}C^RXhOJ1)5t$DX7mq@D7gxg;O`aLH>H}WnnE*gtm z*LYj}{XAFkC9QUWj~m2+&-;4+JjZNXZG1$}gPzu2uz}a(X%99a)BXVIohg`{s=~#S zicPAeM5Bhn2r`G+RSht@kdn%c>x|j;tI{gx$x@)-M$UW-4}|~S_wEBDv&_3hHq4G8 ztk|B9E9CnT@fLVrd|`@Hi%j%rA~cXGSIY)Ec6|bR+trMqxSv0b^8chE28fHN&Yo99 zV)2YNDsoFtL`aBb<8lgXt5RTyfG^JsbaY@Tt(+na(V=}>u*?=o0Zq`=+=PvUBt0e+ zbB2^Fcav@LjESBZ^W^o_J|-?v48Ppc-_tZL0(ut@J{6_;&)Pc7_J?^pg1E0$4DZB#Ij5Z*_Y|ycmZcH;P(~aAF(!QW{!VW+>7x`7Cem^Vk z%c4`--oQaJWCf!$J1hl09QgprTk(;t@5f49BlB@&^F}A&(RDGNXO$+zr{3?;`9Pg|N3gXO<2A{Zviw5!Q;TQXE@p_DDJ$c!+yZ3Rs z{}|NPd^~V!rrY8b$08vS)x@A2498uaB0yx<6 zuP$-$@0ZL?8WN%%8cX;(V>jPAg7|(LbL#E5OKxl$UsV(x zFO9e+hv)vU-XwQWhMYThyGI?gmnR-RkdZ~JL6kX!A^koDRyp`_$o_F`6oe#eIEWE7 z|6i9=w3CpCU%y|Dp=WJ-B2GfGS*tOdJ_pgKCNi`YWQ9-Y+~<#%qu3IUztcH^Btx-j z>=m}Z=gTW=p2Fk{M>l{kk$)QZ%gR}3Azs1&sS~@No`9E$#7RC1WxXLA;vFyXsHu$HgG*Oy?-#QcDd4HmWci zCM*u$OUz2Ar9f{%5Rnc&%Q|0rCO#LY*jyoxX%Al3!1t7spa(H-dmsr|=zaXQUx-F% z3CUZvCCm$bx?vC}Sc56TH1M`3rKXgHPl%i0vT9(DpupyC6?bpx_tsN(u{YZ=#`!17 zwBpc!GJ=ZPh(M5Upx?&XSx7$9DRqr8M<4!A0`XDr){M_|t*oU7uyll7grqle~g_*RJ0ekuMwp!nzu5}q_gBrc+mc)H;Sxx1vM?)Vs_o5`4+{o-cX+L|HL zU(c4|YFJ6XM&?{9LBkuLX(MmwS*@SdVNsou9;HOP@FbfUj`Dw60E(x{={SnUIzDIi zKV}7ci%^HdQAaEo@xF;(#-TG6Vi4p*OFO}nEVL>t zmF(Z;ng#8?y>)Cat|U@UE^r|0 zcQ3#IC+Sad&}XB)>4L zDMQ16q9NK?l-r;?u(QBlv77~=|gOR*M9NPL`(S3 zi~n^94zM~?XWR6s(Yu%c$uy!coS_T!$%_$cXfcYMLt7GdOC}wJkQOMUrb^#IrzYT8 zd1n`?QnsC-z}Q(E#nKUqU-l%Q7{W8olqA}Cvu^a(nc1q? z7lF95R@=}jXOSn9)d90qPzrmoEC#nm`uBIadtPK;IVuTY*00DcC3p(-D{5A<)Hp;# zc%o6iel(KS&;?cLSI-gnsfLjdQn!|x|Nb7_oowG#NahR#CsROF0Iq9Ko^5Nhd24gN zvwtx&w3x`L*9uBVuNud+_EDX#n64H@cwYInm$P;Bs{)VnLTdwqv=O2z@7Q+hgA#YV zH_1A#*^t&&fAObtNaG2UA_*jJ1~uA1_Q#gAz>T)GD5G;f3PuoSeslvI>@FKUBt~!`A}H-^s9*}qD+${ zYt6Gi^gs>{fV!7{j;N5Cu8gt#RbOxp&3P>*GUqWF7`(%zl{*^>(vV zrfaURFA~UTvM!#NLYND@QC1KzuYYG4Xi2l>nf%|Hf3#UtG$(pZCkIGyMrnjzrb` zd;`pzmT*H$n9lu9=0_$v2`NI=HST%Ln@4lVrawhjJnb?pWM{stDXF0288dAPfW;RZ~ z^}5}*|I)R+&4LSO4WzAhW^}SKEj=CZFz+t^3C2l?d!tSx4Qm@MBd+6=QVJ06{itDm zj-|N$8ZSvpYpEeuL>c&s-aZ4{8cP+aY+_?mV_?`-V%4+ZW(gBDU@5u9sA7r^ct?VI z+)_?-5kyNc3l$yPYfTenMNB*N?8$9Xag7{(G40@IH%J4#-2$Rw;#xVR$KyAjKIm=x zQIB$@)-j>PKpD}#+ApyEoD`-XV|hgO(@e~DTlpvv)=Z3q{H+UaVCL4m;_=llyaBTA zSsv|aa&e(1akix<0bmdfT$`3x1I-%@>((SZgI+$SAr|O>m~6E70jx?xd$e)}X|vHF zS$)FL?!OB8d|(*iHs-e122Xc~KisAh7U%s75#HxvJ6Ex6y*HXM_ z%EY=-Cw2$@mI-Z5+cX_H3`p~nH0b2STQ_tVB4~EG;^KvU^XKi8adkp6u;S-nO-8eP z*UH>n*I1D~@uFjccy}Zu14@t)T|%&Ka71uAPpxV#ql&uE1!6X77MV=<(+^Bu3zm$H=-p1~!y_zU3jKD7 zUIM;1^J8NkiJrA(_a!?SRHPQkvTKotF~BRcd))ykZLhBIz>+LU9=&?X&h{)`5g$TM z3g{?;p~U|#E-nISxd>$Yug3Tt(x$u_v$M^9wYDPC%>petMQTi4N$%r&0u!cTuAL9@ zn>Gp9ZsG!$Pq+PV$>eStmo9+8g8s+$7=oD4Sx2x&imO0qLwN*FhdcrJ%6xpxfHGylFTf$Tdr!e%d;+qN;@bK2KXb(NpAKA@Pb3JpHJ%I%2l%>ePHVrj;tb25P-jzLJk=C?dvBpM8b{_75 zCA4sPwGDB<8yyo9(|qd)YKf-|dQ1v>+@kbq&sw!+{J^Ec2^bB5&i!hxMj7K{)EJ^A zwRe&WCuLQS$PCKuDVo zgxh?yQ&Xn@u-*P!dQ*WU_ZHPcyr*Btd|l|h6YvxA4fwMAaNo2X7%=h01g(jqsZcnH z3GV(KgknZuvtO+oI*n#nB>0mFopFJb@=P2(h!bgW@GnDJAD>6<%IP`0@SHhakC-hT zqwb_x0r;uVh{Ob@a9cE#x{Z6j4fd=g2<2x#ssa1bW?P*mBS_5N_b<$VDb z@e+Si6D3^@?^}G}NqvC;6lCIV3rDMy`m!2u<6&`|2E*|QnvBEPt&eL?ROfJizt$DV zzMlHaPn6MFkD=C^lfNz>!f*t04*V`T8}+O(XY)5707Vowr8tkujGjMbfQg$;O1Rx= zlEw(-@&Yp9Sgfb}g;aS-Ig+e~=B`qG#Pza!(90ljTK4YW2&gjOVF_qEJG}P=4)&H~>qoJyA8$ISI?Wifknv? zqeXlY8=rbm%Ct{mUR89NvNS<#m6>PiTiqf3Y#|#IXC3DvdK7E=P2y@xJDvC*+@v ze64ZR>Tg5}os12)Fbbxw(p%;5j2=5W&B}UN`K|^%280gYY@;s0U+PJ0F*(-hUN=wA zp&6?_m$j)TeiqeV4p2I4b$!-ebY>SrD4kVprM}sx!5D44s4{aU?JO-AcmCv07r}to z3nm4ZcjCUA%C85VIV_+Hc`3AVkT9i%?ya3Trp^+ncMu1~9r9!{#Md2}kKP_YpgRGu zwKADsURwbME4#@7?QGWUDZl(rLDsPi(O>_?aGz?Hy-2be}RhI!t_Pjs$&e)eO> zaw>|Fw6L9|$tyZwD4z7JCIjR2QOPOc(?7V-7*Ln6oKP5~A>lghd@;x^%M{sDS+O3kwH?t0rl+K1SyeXmO@Vd1qbof$SYqKZTIslCN27daM-0t@HSbx~q z{TB_d1X}PkiqyGazzp@=1qj3Z-TMX-*3=0IotL;VRr|m7X-d5^;cP0yK@_#77!c-@ z&9%Yk$(Fa7D^TtpeF#&E0mjvwecoS3*%{&G!Wv<_Rs)Or{s%OHY*gL~4nd*btOMAS zh1!z0D<=VBm*~80uX=*NXYvf4?-E@(``g?f1hBX^uOcU%Bn`LKU?1W+8)l^sc`d;B zCnB%p#K^smE=`o!ltKpBLIIwYWz#Y8KJTQ)A0LO1{^CLw6ZPYC(QVjtA^9X%_p}wK zlD1lg@~?Cp=~K?66xwL8@a^Kf$VIKz&I5wv=bLzg#zw~b^xG2lG6Y5AUS$?mHnIXD zi2~!4LIXvOv`SqkxaixD4r7+JIK_*Pp1P^@U6Fs~3%BV@?OvrN-PT4+@x)K@s)zyn zk+|2?=o!)m(%RjQta?fgHA~2pJz0hr%G8O4Xce=X*EA39f_c$W+W4=g+X~BxVw0)- z@29xqX(gU+vHxvBDw%$@G+Q+MRoJ0^qYMq!T$T{6S)(KwND8`3584m_fHH<;$H(t) zH%=rx%0&YB+72B9@2=h<^2%kX^BQ8cXkl=}T4Oe*kt_$0jZBcZXF0tb+u{~+v4gdN z4jU1D#cZ_CiHkmmjrH^G?dZrO?{^!Ii^GSsr$Dut!77_t{Th9?|Nc^R77w0_B7B8C z7fyt-9skKe?ZB3PJ`YJJ9S`w0Cu^SK05tbPO;kcGsNtqdub3tV3$K2AAvO4*7-yAe z$w4#!Pw$y86}MQX4wVuwHAXsX;7coXBFEEW<1l`CwWFjGeOjBG(+vIMM5TiL zlA$WCq9~56#`v#f1zWZcYD3fX)dY`scgq{aA@FkRadAwqYWmu=a>LQw(F}!Ln{B8K zk1*L{T4QRrwhrON=u&R|q@%zAp&ux>+5zFoY7nqRLZr+A z5cL#UB>XH@{?99uS3LnR{@bC>+5u&lg$j?nAGL~RnkVwZY)v|-tAnfp(glbF7~($- z6F3uCID!yMYuhsR{FwPnF0hE*<;k0GGD3Fb^7GfeluRSQ$yC6LyMe;?BVYX}W^yGF zp7`1Ms2CefH->my6s8KLOFd2*o79!DPxcJe%h|f_-@D_bu~JV7(;lCv7}+7pEVP!D z?d9>46+sS#p(;*0ITTN!1L56m{F8f3t&~-^be(h4l+l5zoy^SpEZ>Whc8#}If@w5Q zu$4{JK=N71CwibC|1q}5uC-x%nI!O|_0)8!u-i2BG7u5JmIVeK?TKC)b8P^{+OhVx zpI@`7iK!Gpik2moAIp@DEhcn2txZ4pT-izuN-u*_Vt8w714|}E(QpFmjK7Tm(Yl9L zGNE3?7&F2=G;n2IetR?^qnNA}T!u+&q@nrg;Kfnz@gj;XnnY@tFgosbX;0Qncva%l zpD?bP(>_Y-y7_&@`qIy6Fv2wy(m+We0ZdKQa*l6D)&jRTH(@woxW0f8=7gqXCcCfO z&E1drbF?4WEJsy_lY1j@4}qJ0m~tUnRId182@AMy3LWH@K4kratsG}u+#$0-iAfC7 zI?8@klmqQ%t!WGs_Xu2o5MCQm?Ck63XVJ6-w8oi7ZxG~u*%t#6&jNrk_3w$#<4=hv z2&b9&L~`oSOO9K|PJEtWbw#TZhIBW7tahs zZF~^LT5P1&}Ki_Re!;N`V+yir?;eae8azOrn z?#Y>YJe4tzVaKi=?~!7|+^E9-T%BGgHAng)y=|d6(BB{S;DP3@jgrC1rmTOjdlsNJ zx~eXbV&f{-e&W)K^nuThkIDcwXEqerarrl9Vq{$a>d*7XHoHCfxdSW#ffIcWy|8sz zl>_n}N9jLlK%mc0fb8QbI_EV89>m#^QoS+7bN_)a)1v;X=v7<-j`{hyy2FIspV;xA z3H%ci{%Io^L>27wC#!YK##)WEMLfY)rX)#pxqO9l8rDeT+Fz~@MhiH^*5E3Wu0Ntm z!?tr9pf1vGhdE^Z9R-8v&!?>tiTWyE#m|5;{+lal{kmL4$R5Le_0C=GmfOM@iV2s) z@Xl4-pv5fuT5ek0z!>(K`yiit>=St=X zd;zSZBqc>I1sTPQ*2%XfJ3kwY1BW=#JhT))jFC5b>{?chUjO{~dx; zhV5jn>GAqut)N~uBTUCYJ&nF+vTp4NP!_J&ti1{e_@FghC2QHEqGeUJvC>K=zPzgV z_Y26ja3sSWL?Um&Qw&_P+ZP=~KzRieYTJI}747Fb=)0lIbHxrw^kIo?69!et-atZk z^V2DS=XSjBodFnXz3mr09TI3iSQpD?mPkx$MICnL zOidEXc4aL?liS(L0<6JKw)^x6P;i8P#4pHbnye~C%R-s+Uy03QQS-48DZ%T%Yf(x5 z8Tr%gD5iFSHFR}V|0e=~qj_sgq?o4(Hobjdu z4?8wkG%u>_5?08{0-nG1TJ%sKJQ6j!j!b(MuXhsffc*q2zV!U$m0ip6C?8fXQdI~@ ztSnX5O@q*Q&A86+Cs2Y=2His<5sY&cST9>Iw~Q{;Yg=E}kB^hm(<#Q9=|>6$Gi^{5 znX51T;cQmz9ldX5msB1dE{OAa>yLux(sUZKRSJj%gcgelPc31ie_ZZjRZOpuS0-mZ z^PFoL4tF~vzB7DlBpH{Dn3^!5q$XAyAM0*Wh{|ST*H7W;NJVXdVUsvEg2us3^DhFU zV#Fi)mHI!4jGZ}AT?$WNe+}>)mfi>m!9_E#=BF34<-j6WPrtc@1GG0Q&v4?3ONrR# zSU*9zRN`AwP4>%(Iu>1;O4xt~)=5`Kvb|KFJ&izCF3HZ?)qyu|NTwuM2UBZeTOQV! zx}<1;CzU9!_=0Y!BJ(O3`Rg}g!LlDpscLEy9tVmT(K4ZwX2-{S5fFC|;IZK@dfeRh zYn?ObiFHCv?a+r4sJTvDUH4l<($mFaW}|l;Wi>ds7u`fD?v}8Fwl32B-{)kPWxgRs z@-sD`iFK@no^^5`-T)Zo=icL;j2;X5c|}c^2IHs@cr_q+$9tI5jOys+JuTJ#OLbvfC*K#-(h)$&{M)9p*1 z6XW!s(Pb`@9{uEGIvy9{dAqC_pb3LBv9?rO-N5adallht%9vjd#a&*H_lwZT0k7vs(0 z0>jb*!mm(lg&5fP+P~u@S6bIDZhoWY6hj~LZv7gQn$V*FML!s4kRr;?>WPGG&mJXt z+b8oVcYEOZ7n!?940*Z$Dgv|b#lL4~>19)siM=C0@yL(MCb;NQ`L?*<h%<0OD5K&2S3ho_rGGzLjO^taZ9!{k!#2} z$dR5!ZY4!V`X7r2Cf7e0Nc(O1a&%cMcRUW;4q zA&WZ6#~2Yv)8L`?S3=y)Cukya$%uoa5t-3yQB-A0QDfe2{9@z8Z6O&UL_ESSn>6k9 z+UF+cc0jGuO_=|C29mq@;or_fpyuX%_xj)n3WNk{N9UI>7#n*$Y|s)D8?~4Y$3(W+ z1UdSy&ik^>dW?)+u`eC<8K0_>^h2HiWK-b%Th57zQUgMGwkt4IvNi_8G*ZI7%7V+w z2jQ{lc4&-(j6iz4BLMOKQ^Gqw;pj-vL)9cxlWxM` z`Sn{8e`c;lF3i_g&9*S>*b2nb$^89&ivV$}R5)(cim_BoZt>sXw@j-F4Gy|Vbnl9U z15Q(96TQIy2^c`F$NJ`i-yra$Mh8DhX4`pv%}T9;@g?iFNUwWxe+jMQvy)%*x%~Q@ zjlB!>SP1;3iy{W<1{7|ld-vZWzeyfJ?pD9CUMWgDYBI>Rfb-%|T=$oVFCysgj?lWqn`-;&da%{*gMpcKOpwMbz)I7w(d%PgDVIBM9qk zd~bt3z9J(cNR+7r_ke&kxzef~Zg*yW^0nL5c5L4NgGCjS$<^0xf_*}|gchr}0;&yu z&TU4oeL~qvvPrR_whr$Ycu4BC?+>K<(%gk3mP}^1p)JF!VXY`iuHn8Y;a=%f-_d1{ zI^`*tb$ja!)bG(#BKhF52S_6sNvNb9YyMOlxyU~TVAd=ln8mZFeaa->jq{oTq^6&gFT{`{j?{!_CB%eJR~= zE629`jo9`Uv)z63oedj_ovK|qcDy6ub&Rq9rv;!E&JC(V4v@}(2?hGU-ShKCVk)p2gD)9iADJ_@x#eB^s7o5 z^-hl2|KtJOv+p8rBfpC=?>lCd6`W$Kt`LW9-vwTwJYVbP-rft*t_L7dJbdLi8&NWm z^)Djkh){2d5c@_=zeqoYzMKWM>%uo^fWbMj{J%sHZ)h^>PV&KfE@3pY7+n zi2r%`-clNdP)^=DJ9~8^^W*ICcJR!Ns`s~ddoddZ+%L$(Wt`4HvAOhnv8gHOqHLY3 zz-mz!GsVV0gNS}qv!&wzTt`q97p60gCBq!=+C*GfrmSt6qy>i7nEuQth71hI1LmvG z?3~bf>w?(%ltX^3;4K~87vL(YhIlA!Bfr=B#B%3bL1Dpw-e%fduUXifOa6&x{l{-q z=}S+eKUVB)^G;ObzfL~6@Hq8zTaaSgI}cqry7a|cXDF0JnAWg7^klH{vJorQ^B_wk zE=b`S{Y9$qjF8+0b2I&05}z3@}xJh`cA!2M4ARtMr?%~5v*BZ^rzV+1t*Rw}sVpft^?+#?1X zZOa-c81k#hva_Ehc2}LiaMrQ$$422{S>Mt>Iw;zD?yy4_5BvI!2Z^3U-YP{T1(M;} zB%`suPFi3v5QARFBTb!@fqOh~^W0~+c8?(^5BbrMokEz?5wMl>a<%5rO3`^gw&wZO zbA->o<@4_5d2|-9nwlD4>XzQg8gK0XkoNXQQ>XJPTB9znm7oi=ToZhs$Chty{b>3W zY_L?={p-tlDs@F#bU|8?GufTbmv-Y@5Qk$)G>&IZ0F7C9^7eV)(0TFaK!&!t&EBpZa{n2dua&#RDoj}&w z2(~V!1@TN=31)6>{mnBZFpSqZs`H>t?O-){P0AKAvOzC^AYTe&zF1eO~ zPG4}tCA{>grNwyA;2l~QJx0D9hKF1d5G&vJ==2F~K?|m>tv{{ZcF~$%UbZJ@NV$=anK=4zp9Dc zw0&d$ETqNA-P3dA>Wc8-3f;=OaN+Yi`0lOm_7Xy*e_vrnsN>;SL^qT0YtZIW6K829 zT3`>)pr(=2!V$;qX~hkn^H{y_yGVQhNn)G9Xu7iM_Svt`#itL*Tbb9>yLD%XP*8=2 zp96%L;Hk%d0&6qXbBEZB*J|?j7S^Unz^8vtiM{-_6|uRAXU7^}g8y`OdH&2?G<<6Y zco(*>4(5AteziXIBPMdx6#+9pyN->}jb+G!sY!my=JRv*(*|Vy^}+OzsF|>jj}N)p z+bn#tKF#e*L$oNKyWdR{X7)>f5q@p6k@#FWY|tTS{dh$0I#LXx{mVJ@saDtOht2F~ z5LTeUvo~kDdyPVTGmUSg=6ZX5{^@W(sdNF1RIm_k z+iz|?=Wt%V(CgBy|E~VT=F{2?v6n3)1A17e7F+3g-R-JhhC_dkm@%_pde zDGI3#-{D1Wo%+D82u9hCZn0}bc>Pdo&Ob|6BF4T*NAW%}=YE#c+OiwFTe!Gfuxi*E zs}L|YZLKdHeR|(H5oqus2mjRw`)m zCA8Q#H-#XB;v@o^r7Kd)UVrLeEo0Fm6=WQZPCSyiVX4VCc?|(KE3Se!cEE1J*Ee8$ z_nQ6l%=8WZ%frhZF?{ZFW;D}>(%x_gr7Sb8k+2+|fJPbiD=QyFnwmtBJB4SE_3c(C zES#wJ1H@v=UU;6s&6>p&nOeojj$VwQi_E~e%y^@KowqKBTeo!CponI2aQc;1sdWEd zbcbX5+DVL#0sJb)~~^NG-Su*S3&Gc7Mp z;+Cg;euJbzGaC=MCCbi7l>@ipV_rs7@J9$|{{xD|L?tXj;HS&4mIY0cUn^C&C7mxK zY2eX#Y&HLB#Lq&%LJ83%sqT`|c}}zDuU9ba&U->Vf%N)Rx7T_{5lybEGjoJy9ghkM z7{mI2D(Ck4h;@tW^mvS{k(f-g$%6ciCZ@ep^tOpQqsoyz%fQZYXrqyqjt7&-)~{6) zck!$##kx@-`Y2Z&h*p^0A#`1Bw?l&rl)N6e$Z$9OPBhWC8!F8@^Q~vbR5)rY$vx|P zzsBCEv(ikX_Bh@*1OO_Hj1(z$&n+j9d@A6Y)+{Wm*tCKuU);i#{GNRxw=|;PaXyfo zwBPR4cZ13nq)!jA{cAOu`hb(Ch`y8hND}#amD3VluXE?wJ;GFJ;`3>aqRW31j=FPA ze19*?nZ6~N78fcI;+IX*p9G4xuiAfW;3(j%q@~A%!Yw;Uf?(_ahg60imHjz>Y;l8y zmX=r3eP@1KyKWTiB%CM~3R+MuhSxX}9N2d0z*;`=RTWjpNuB5SOpvDXR|s$DL9+P9 z=Qsn(QfNN2uO&y5Wo6XpZYjq#qJMBIE@QlnHm{&*Pg7Lb`R)BgdJy*JM=DX9Ty_RS z-yPe#<;J7$awA(?6p=l7lbT}b=^~^EeOrxRvF)Ydu;R_*rPo2XKxV>##A6aU;o8%# zzj)gnAp@C*SHSaQ@AE0`T;r$4AO7Bnc%nAbGt%Bi2PI*}lnTk^r-<4!Vd&=K5h#f~Txm|QQF5-O(jy00L< z<@UYpz}T1##3r%*$4&Q`zju!lgoOsN8KU7)EBejC3RCt!TKg|?+eAekfeVUJ7);?( z`4KjJKayS+6XAy@DbV>Y5I8uF+f$reNL&nHsQjQ!>n*QB%Zz{GnVJLASf1iLA6h%N z9D;Tu)pG8(I-f8Q4i=v7LwC!(6Byiq13NqMDoYzF0J&v!D_A!z#Wohs8LSC5H%`J+ zP9Au8L?Zh^tfn)6>z5~SLoZQ=gOauDaf4n!Vco~WL5{6?8}N9UQSuaW>(wiN>wTlp zwCMIygW$ttGYvxzd>3wppbK_0m{c6Ot#AgwLMwfJ7_g#~3GxL0e)mLo2lQC!gej;m zt2lF?u_YuGZ}_)kL%06~@ZOZSl>TiCzQgPZo+MW0KIspg`LbJeM=Uey=^c}}f`Wx# z&`ZnLU{i-%ouR?S&fE2ZRnaH@?8`RHcK2I#rdQqVjSvDaNEBD=OA^lWp-Wmh2R*mu zXXl=sS;BM?=_P&uy8$xDmO?#8_;Z#%RXaPh^3RdLT8hgZ?Ip`(hB2lXVfTjKJmB}* zP#O_>(UQ<0Kgn^2tBcB|{?H3zG#k|H>egH*F>c5v*a<}lH{Y&dRa2*lPlfiaBA)jQ zm+I(D=oFz)gTB$s9RGZJ2*Gg%0!?CG`5U#4T-t36ZGU_&miYgp>8!${{Q55Z7eu-{ z1nG{ULApBzW@w~_lny}=L}`YY0fvz7M!G?|y97j~1*E&b=RNq&IhgBW?`QvFt$P`A zbXa!;jUTwKANy>cIEB>jC&sdz=1r`};A9ukh#_K=+EZhxF6T#F6+_p0b@ik7W39giG8%r=Q|a5 zf~K&F1RheFKR}LH&?^IA_1*mmX2VhBRP!=H8Dz=J-*XpYGg1hi)de&wIJMY$4QY*n zwc?}yY~92#g78Rpg6#gX4*+pFVF^qSi<(uplCKo5r0Sd~s!{{K8LOLNEq(a#53Udj z&JK>Uf0LP5?bpT>Z-{tU`M%T0|13_$l0p5>*Z5{RK-tpqCKSDKrD``l`p*4Lz^$LI z0qt@bDs>&k7vdk+>eSNNnd`LpkAR&dy7(c=;3;jAA$T)T^5kID;jlAk`|hY~M~oq; z|6raK!korO+4ge&UnF+Lesg=!7bc-`1b=q$pZXMB$9FCEZ5G6{ApvPooTtavYC36v zn+sZA`Q6oa-KMU{)u`mJf1vm=a6#_IoPE1fs^0+H*hlo>`>U>*s)g(4%T(K}0uzGK zwaY^VGHe+&J}c?t_7;2za5lsS{EgJ$19NdN>GY&Ax=OF}yw?YB?ItAFhJ#Wk_;a#z zdUUIwO}!Moo<>betIet}UWY$)^JB~@J z7`v}_3^@Ni^`f6Wo$XV0m;)a^{sNxX^RhB!M1ADD&4A%%o?1AAYKRifviZ*rPBs#S zmzfUQW9YqD+7{DQeXk4`@9(YYrO#@ISjkC8Nxq4KpwW%w4uLwjjP~^t!rFX)->1nJ z@6-<}05Rq%HJS3e@GEciR)aaHeQC^_Dd$`-1un~x3@~je8F#XyGlm5ck>y|BuWRsO z+oYt^R6RB2mwm-jZJYm~l&)G;lzD5ih@o4Iex_lmUHW_A*+%br(#C8pKQ>X|o%r*t!>(FR!pHX=0M`a+ z2sk;xw=K*fVW%3=p)dqq)J9g#kwhlp&)>gme#_1fvg=nWO-2wNEmau_L;8U%&zt)b zq3o`pHJf+CUyZ7NSXRh!*Df>{*f79AX^XBnoz!$G{ANnG z!G(LK)yeW_c<>yomZ{7BIVIz=wG=d9&Bbn6Xu_1$ug8(kdBnVPHYBdYzpAdGa3hlm zXvRYP=0{E?Im10shw@H_T2^>1KBQ$+oUy(f3)gwB~CS_b)< zlZoxrHLzvxQXXc6oXm+X@>Bma_;awb_>XTPL-#|^y2(MKA*5IMgO_N1`O7NQJ(IyZ zx;uoE$%XrDq`QKm0&TgOwq?LH(h^8I*DMBQG1!mgE!C9v_NOf+o z27D(ZU;*wO{;xD$Z8l^y+%x+8%eR#xPYO<7Im3^V;3aZEYQiWpP1qw|zT!JfR>r8C zp~IZrHR9&@fsw0`jEP2Ge2e7;#E5AD@*>~rBLiRr5Em$O4sJXST5KyDJ&`T@P5)lm2@qVva-E=n3S@62 z#|MpEk87=>8%mMSlLK1NUuuQRYe1WRTFJh4^ew8wEs2k0v(4ms&B|Irkgo9Eo$wj5I%G8?FPV^ zx}Yt#{__y==IrX}=IG|(DCo;{+PM9=eTU6C!kthTSd{|p(D}xgFGYylm=F*>6cK?5 z4qxq$12#~nQI9@FWoBG1)cSN;ms+!0TUpfh`Qm+F!;8qNYrw77V6-6Y0=n->u;K@a z{&R^Wz5z8neIk}$8=6WN!jlXgPANln_fN#W#1xil+@?BtL%PDsK_&m#~$w(ac=vT+q2xOYOYrs5Gq z&$(?42kjTvo#pRC3$VHqN>jJPdi4$SB4)oA^Iti-wlx2!F|nu(rb*o%)0GX}26jS2 zYaRt=zFOXP4ZpnZ_Fn4he(1cfej2Akl2HzjB(fyFIC{fDT7~R5705E#jtZb3R<~)` z3E)d5w{Czylp!sY|G^@WKz59SO+^T_-NDp*A}aUVHcLBsVwHIs}^{I29~mMV_21vMB3kbhkY55vfd+ZJBDEnY|{x9x_oCo=?vu*0?m`S)P9-=n43(RjS>pmk#&@ zXl~D~L$FEW78llqPx;y>j2OoakEGx+s~eJ(2KICF~12 zM^vrV5$Ur+@=4ADq=iAn2Z=6tK;7H^8i+E7{VdhlWd2&kkfY$%QKZ7xs(k_%F5s>x z=_T>Wu%q0GoMtNX2KYJBJmgyX}04b{#jsN=}WQdUniHn)i=GsSRh*_ z2=&{A;F|Sxw)pkH^x5vd7;wS>i5dVe1vv74AG(EO>VqVuyu|;hvobc7Irsc?T7I!O z2UDfPwgaC(=Pylql@GP`(eG8?$!)MPVLLqPBDS##7EijyR>nJBc3|Q(%0WKIgQ7hD zNo4Buw;3ij{QIY%BW@%Vj}8R00h*0(zbbC-Z|X8?&c*~VoY~b|Tvv#MV4m5fAw<*F9Po2J?KmL+xAKXL+*Xvy8;jzl>s3I@#>w zF#m2C6ofwFEJ{fm^zh(*ec;}eZ&t0xm1v-}5?#USGzZ0}dDcZ^RI^-RQn~0QPSNZ* z5k-Zzv+=C*73cMwFA$9$HQpb0afuAoOCIF(+LQK$l@^71C)6?PgC+#Dq;V#N>5Z#_ z!qe^gcw5@kh-&43yZY=+YVnI;rhJJ@>8m?w-9cuCpo@@7sMNpgYrkOry*Z-eARxo2 z)lGSej;IvK6MET=X+snS!Fpspy>1bT1c4VJ)bTr~S{nYQSn|<2`EMj&9c7PK%xM3} z!#cBM%3&pju(3%LgU8e;bXGL*`fdWZ*G{sMUMcM=)Qi}_MQt(+72Wd!uPRws&hEMc47j-D#77uU_%BQym3`Ga*wPFS7iBqKy!>MzcVRf__?o5ts| zZ+);)D=7e^-Sw`c0&2hRf%)&Dv*);Jsee&`l9@VX1&+9xN9Qp#+fHfQYq&>53E}2viu||(n9MhBVFmta7B5 zdQ?z^?+or_ou{0nhlUo1s zc!Ef@l#LVMABJt!k-_k~xC%Qmgvd47^U*A(C>EkOti(F%x9_xIjLCaU*LhV5VxrsT z0~}WHdzo^x4A)T(d8T*6OvaxK1zs_o)i>t5Vw8d=>5=UecMkxABj9WszxqvAu3zmJ zc_)Pg>Oi_LRLA!UP!cZaqR9Syx+j%#oBPXhmAt}1&Z%tHa#p3%i3X9Go`^6{sl?gO zP)oElxcrtH0d99Z&)F-FaTcixDyfKG=`-;^JJ|a?i~E{nr`F>1gtaclY`{B3qY9W+ zOEP$}#P*Z_VS~A{@KQhinFEYX43FQxTCX3hh?)QHw57vb7p$|W1Tp|qDJw*KLSxd} zS(5yI0`#q;$5~mcf6*IjW8hjS)FQ0ZSqkY<(jYz}Bq(S)?|aipI^wuXP^(tEG0I9D zldjngAqzKBK^U<0b96!T8XFu#rZqO;EFi9ewz&!G3Rc)~rC4K+}`g8}x3*3QnN(iL#Y@Rdt_V!#c_w+$^QW>QFIOHSEKt^$Rpg}I5`T%VToGDOvl z7xSwhFw4|pljtzyvqV6$($6vJ#=5ayvhK3e`u|!0!39Y`eMH%YKj8#E<~VELAI7kE z!e;Ee53c-#wQS;-k`j1*9HJ}xFyz_gfZciD?y-kiM$~Qmc$>l?o}p6JDRcaIcjP3R zV)Jr}AgTXuOgKY**rUc`ql_FohH%Oce}m-uKB9}L2N;0!VLpLnW~q}Bo~1YDTU1L> zCTym-znNaPa_;TlqHu-vEuos-j--42*^03=B%x8ODA1$Op3IK|+`T#k)DNtx6g$G!caH%dZ zCAy?X7rE)HjLJLWjZne8LzC3xBGUp8Qpeu>0^hBv#OZZd`At=@wP$Nr4h0&SZq!C* zYQ{#f3Zuc_NytVY#~ym0<>NsNX6x}6S_MfEExX>Zvig2hq1#0CUvdKu5~%Gc&znRD zQ)n0!h5-`H1k;{%1G=vOiI_H;SVBbaiPCIUb8G9??dgk3-YN=P$1!3C<`}|SBAr|w zG*z9Q5T{gQ3f(O{R}0OH*s!;rMfN6WoOhp>bqoGFxhTek3+R@x;AFie@us5=|M<*3 zYgmKsFfltVJR}2c|02D7RY!?@At!cw?J)#Uq4ouJsX84qdWzFyU|09;8%m#*)UvUS z(=ibess>%32YX-iIy{cb-lH3(q}Y@gM$eWNdxg{W5waXlg?f`OJ61SdKeqj@+w;o+ ztWYUJ0IGN-YU6|>58c(Sow#t>8={Pb2(Z)}Ak%PN_m^Dz`2FwBJ;RBDI$zWje%~ES ziYC{nSD}c6yw!g zQ<9DlHQv!kNF&2+^rFgtg;`(6l&h%ql^Q!c#$?V#k{eXOwE4Hl!rNfz_tQX^7rhFJ z-aLNH)p>3TBE1q@9dxZ!PcBx?*the&BT|9Psw@S|w(@29cwCV9tS+KP)+6|x?gRp| zVik+ZC{3asz=jD@QW}|CyqWdk4uAaY{_YI`7YTi3hqght`kvR>s9@@KRvbz1Pf-@T z5yXgEZB>7aO(nc2%U0M6YLmr>irLYV+~IL$e>uA5LG+jdLh9{0n`aJ9n&6Y6DGKv* zzo^9Dkjk(3iBfElQyjqX97m4-@ze#(|lhh`nzqc+NP4 zPGif5>#nc){D>NJ7pn|-rZSt`V&RxW>vR_FgA&SHN?c;PQJzwQlWFtsapi(9>Ee;@ z(&y;DkXd1x{r~8kZ2y|Gw`>o5yH2x4wjUIgP7Sm>4jdgGMl#m^dh36&M=sVRChW`3 zw;y0bgQ;)o!|Phd$ujeughh3LBEZ_>`G0i``pZ__yi1@$+>xz6%1#O-Q`x@X`^BV*mLc6%GXSZ!JNt0Lz7wN)jo zZs~tY@DxC`e=?Z;gW)oP6eTNKse6G6Q{XBLu{YFZNFKX6l{qYb1Oj3Wf2le(l zk3XbfRzTZZTVPq6pM!K*L?)2a;w#5%57lAGg#`v~uc9&6h<);CH|}3D?)tx zMpEcfpR8D!qF?GqP$~Fgm=#CUj)onzD-kW9!to+Vlq)H29x;N099D!3%9LhLV4Q2 zXa#AyhW=vae>KN&5Iq=z%eg%N9tWPyji#;9hE}C88)P$*`PnRF79$h^)x}{}f{<&|`Zh$d&eXsX3%ZXR zZoU1u%MDUWhqAF1d2O=zT+L455@V{1CZAa6xxHTaiaS>)wK^)SXnD_avY?N*z)zZp zH(O7nXhpXb5IAtj9z>tJoe_O+q0$IqD^eeruF*mdx3)SFvMc#&D%cQR(d=Zl+}dqo z2E`_oc@C)b#=jc9T~KhLznzW2-$=Q=h4H6YMVc;e{^4v|(<^&`gBt$HBAH(F3;WyL zd_(6CQG{6FVpB~m)jGdkD97Dv(GZyHO@K@eEnEEPMm{4nNo3u$D16^BFlS@AIGmr1o{fycrG59JN%gci2YE5K9 zno*)a`v6#%LiR`Zd)i47bD^esdj~W|M4Z1n8^&gb#Lu;YiU^`&6Sp>-dFZk)$DX0# z7&PGZeqZyPoQr?EB0}k^dai%3HX;zO$tZpwXgt7D?ZRN#uJjgVUmo+0$FC(>gp#yn@y?I13BZjL}#$n$!9@s4=&h zUSP!xq0ZWqsNW-Mx%B@HdqEL(sq1^oGc++ZIu!k^EaMSru+phU@v}sx7bjt166-s1 z0x*{1>|~D__$G_9aN#CefXwA)En-yr+VS%*PhV}Q$($y!j~^_9IV^wdE;|gL6;$WL zHOVZeOo50IB*IvBdaJnTS~DMA!DZf2R>y;rSQgX_YFaqF%PO|BeB8v6GKmh_IZ96M1qfVKfd|m+W!uAVZn*K9ut1Hx4ZI zEL_`IwLd!;hQroQG;q+hGLul>2TG05@KjSxFrd3bn~TC9BPKJr!+VcerIfha4* znW{pbq)_my6uxvyV>SD#Wp0l=<;a8MxE8s*O!o3g9w-gPA?0zX6@hm~h}T+HHvjP9 z30fO%`mjv|g7hAG4fgkwYq!}GAf)(N$AuETWagutxfH_I6RtXNmKM{P|6whe(@X1Ah{|j%E~IAYNBjMk4d5@J27sw))NpE3tmTx&bl}J|c;ypkBqreyW|Vxh6oW!0|~fHg4TD z8g}03Km5~k0qI4Np|P6*4*wgLa8LKIAW1DE%$YyNyKwVcT!3|&ebhT+iU2lv(IL>( z`7vEtP)z>N<;jdt89uB{;8)cQ> z!{@XE_i(UMmVuOai{3mZSulpzT>o8?m6C^>S2X1~>xuMIQSXe+Z($t$?%LSfCV}BU z9mzfk$=;tc?*zoN3t{Y@R=JZdRMzwh&~!Nb{ji%ehm&MC-t4Wag|IfKiXa_)Nc^WJ zr_#4zqi9dnrJ#O-r;gNZtAcfOd?$-r3`hms?FFu;RaLJmd`rwh6Eo_<7O~K1>%Y_k zVH>$SC%Z%KJcho?9LyK}?5Kp&z35a7(X_f(l_cSfE++1LN(CFmDHEFxpQGBhH8|B} zScy}@cCL{-7P(~gf*R#qpm5C|SH89IxFR=4XY~&A>c#b3YE@389;^Cw%FX}ON5#eH zJKk@uUxT}cGED8~sr@HFMka{QDFp*$HBgQbYaP5!hcq+^>LjoF@$f$|PSMybG9eai zJi#N&Y5;V{{ukfKU@5%JImSrdmRnw534Fr+{o>**Qh{K!6{+#}CeNdhcMcW-T8}0V zk$=uSFtBl=XK37bZ{ArFdm6JTP}t|pn`C97X=Bb6glPn8_3IZuKkpp^`(X~GQhu=< zA>QX{a4Fr7E1N$aN6M{aonsIvlnhw5M*}P3@T3v#plSe(%42?=!gT z&x3hJb8(Ab<>aYBIjxlE9o}d%UC)h5mAEXnc`tGeTa(IIs(-n-xH#wAPa@}}y6WoG znpHv%C$!%bUo>=b zi}h9gP+AY}J;Hgqq+9J+D0?=JXgyhgXvqJ8hnv zAUtU#E^wEtj=M?n?6b(D1i{Q+GB1rklMw(S?I1F>0?`?en$dxAC2Q^s=9>Xqt9pUS z#+6tf>u#Y~!6Mfc3NB@M8WjtgsSR1Ekt5uHEQ>$S!Koco`{a^Nu~RTry%^V8WjSHF zPp7?7%YzFjTmh;VIN<2f{)C^C2k&g?#)SHu0R^lT>!B)K&{4iA$yfuh6Pmb#$!CWQ zcHk2WlPJUk+S&k9su#QA3dd+CLa3tBr`{v69J_E{^3LNFNcTH&cC7Q((p_j}U@(S# zssSHv>zH_!MCORv#*!h_XJf$8>vWUujeXLj{e%P07d0XaYHbJy3XKF0(Hyy^`oTc2TcmO5l+D(TgX6j4-pk~-{3N@ia0rb?jSr68e`Q_rV zq}m4FQuMo%(gRfCOQdzy*a8#8Vwn2h?lE6>)P)xg#n*}brCX|^5#6T%aQ@r%M5LGMmJ&fo1$jE0Q{Jq|A5-Bx!B)QG zISKb1Xa=oO4 z@KwPi(akd|hDs{QEYsj&XYFW2=aKSoD)algJg*`paSku880*5mqcEnyo?BXWnc({| zAfwCpo@Ya<{JG-XT!k3zUL)Jq*gs0Ik#*4~5#R^4t2rcXfhkOGKYOM-VQ1(_Gsu3l zp|eN*x9>OFdjfZbwl7(DUEK1PIj1Sun6lkk18*OZ(5xV_w-R-~)P+_f+p-osJwU?{ zR7c-5*U%dQuOr_dNA<3irlO0K;@75_Qs^Zsq1te4l|-B^!pd=Wh@-AbOphv!c!b}-7mcY?zY2A>rF@;nQNh56n%26{HfD4U41Fj@zde`gdD8XeXje* zGJ>%Vz*Y>m0lo~U!ty!mq#l zt7hX@f-ZPQTpgVG;d2eDG4XH`LQ~FIKD3Uxt(-x(U@ZTIDrQ0hDZaDw_LZi^>l-=t zu+AVLRXYcsIvja zW4^o+ng#N4^vTSdua3OuSdve?DMtL%y`-}zGA5->sh8(zHa1NRH27fq^-4NqeNW?75;1uwL?vIo0B_ZU!zV9=BCJtC@8ICU?5BH5L6R@8{w!(DHkez!sp)8zGh@E{ z4qV^HO~0_|I2ggTQ#a<5Am_3C5bd(0KwS0j&XaSW&6QPV6$l{AO)e1zq)Q2Fy1_Rg z!8cb?PJ2Kg>m9IWWiE*XW4{SlZe+dNoJQTyP^=z&As(}}0u%{V|J*~n8~kWRDVwBZekLM&p)U0Y9;P)j3bg9e zLi`D}{izhyB)+rO=Kb$^!!`Fq-(^pDU2Q6Fsf!vt~j}ql>u-tJUu=2qZ0(Sh+;=w5$6pPo z6y(;OuE^ zZbWB&+uhh1mbtZn;`-0Zs@UZqDPcS?0heODOC%49 zf+xa<#rE+5a8&kgL?_Q=;VXPbIgM*r-u}Y9Wc1A5$y(gJ^8-_$8s|C}b&AaE^WuQq zsudt+>dG1UPjb>H8+P?;cf`*(|Jf84X(eS2(sH~;>XvS zjJ?;%Z-}SzUD+1~J#3IU>zu@OR4{H1ed%m#GC>k^_>mnnr6Cwx&u6@1Q0AIPq6}Av z|27a6?fbVHjlhLhh1QGfyiFcwt2e94yJArxmSGUFxG2r(V2+O3PV)E_Q+vk!@#FmH zRxf`rF*Mct=Rdbil?!tT%YhN}yVKK=M-RC)QFrqwF_mWxFO3Hu5J;8vS|W30kRAz7 z4Y<6xt7Yx+AeKj^fx}^9hjiy;jBcG=pqb{yKYLcfng#!_rRst-s9hz~xB?E_Mny-@ z(oRMFzk&U2abGQTf6s9)j4(pI>}b$O1J@lfZX0-TBOXF}Pv(yINr?Y+6d!#!bYl%T z+6MC4$RtcGI|CU*!<@1JD5Te)?Qp363tLv@lgrCEK#b<|GLkDl*@~m$L~A1iCX)-v z+y1@=_#6}R$DAadEuD%mj1aRcUPFSkqGG`^sTEz)92pi!)X(5t`=P7uxyQG5^u`&n8e0rlksQ>?Wu1_x3By zkcA2cjkjP~m_AbO-Z(^b8EQADtt_woyd59JzKHq2zDPEKgYf>a+>7<-ma=GioL zLr^L8%j~xM>~Q7X{bkb;&_Mv^PE0qq|JC3M=KhbT)JMF4ob&!n_JP^`SG#rHFEkX4 z;D1b6Ku^~d5Fl;dp&apmUC6uaub1vL{L_c_S68rNp@$>`pxBuUDA*qJf@2Y##pTi- zFLU7hJJkj=7eR@Q?^-@HEMb{=ewi;qvThGc=kl#%_&cH@xhCT+zns=+je(X z?Z*%ZT#KFT$3PLR%(&N4dle~AEw{z98$cg{V$HmQ7b`{Y*k6yh9%e={T62hJ4y_H{ zKtN{l`?M}t8~9G0iH1!@PXyMC{d2EEPrv&vfX-h+OtxW+VM3$k*w$>tq3`mVBN>~} z1&Jt1k)@|c1!v#REog-{XH2!#!EnaLUM7*ny5sP6Z^z8d_4m>Ox~k!wJAthm{y)|_ zb^;~!HEc}nw>?<~-y5HGYzcvAXKtg~Q!OFLZ{0rmd5VzK$> zMsQ>S)8E^q%}j>8`wBZ))ijTK9j+l@uQ-Y2Imv@xvKZ}#N9nOrDAHnFZ=K<6(;+cd6MAU=K6OMS~7UaJ!YL5vuSE~J}_$>22*Th+G(PVK6>+3qr zxlX$MFZn%`mB_TlY{lHX96nFo-yeCmfBNgL>SLo_9z6;pEN{QV++RXShZ!)y_1>tx zI}W7+^p0AIKd_U)*XGm9YZg!QhhM78DLzmv7uST(o*w|c-llk%U)G;4bPe8mcr6g~A&}~}wvci)fVM=gyb%CxcFK5Q??Xx3R zc9w#3ZqhQ||$p^pr=xwUL(4Zxo%&+4r~VYgW~fozHebEUE;8ST@Bi&voH? zZGwg*87092ffelk8jbH0>qi2P2&Le~(Yu#S8|_$pg8|Ok_|FWYB!)O<0+K*|837+x zo6@}VhZ=4ABx2@oN4#oPu*=%%?*Cs45Y9S`@hiZ(e7-%w>__q}GPT5oMf-y0Uqc2Y z@r9ASa+`n>mwCCl-+GpxPl90M27h z_x>-Z@*BukCNh^M+8lU~AM(x9_A2e+k^A-PQ4nz6gV#4EWzS{-650lT7uJ_OACi8s z&@zN9isw3!C9=S@kQ-guL5W=4cyjiguFuE#i!5WlZd(Lk2ryBi0O+oR(h?JTf@RPX zySMJw+XrGm2u$!sQ`g;A9YEvIj23V#!v>Ht!rnXOq8ZZvw0Zi6>xiY1cMZk56^R$go3-n=CJO^bPO zLq2kVSJ^-=m3$e4H6J9w?m|wU4N{S$z&I1Og#*>;pG@1}1WrUG0w6sXDk%?BHO4v_ z%xKweetY8AP_{&s_D6FeagBP@gwmTMJA<(0?Q1!$W1Sq`TU?)kv2v^$>GN5o)x^}L)L_@0J^R2$uK%}&C0nX4^xU#kh1eg3D}H7 zfAX(AT%;?GH0Gb9GxDZY?q1MavyRNW$a(aTqu%@|vVkOTXwYS&Qy)ihF;|o}yt6m$ zb5-d_(WK2X$DtP$xi3eO&6D7n&IrDO&2Xtn%C>N|P|cpXpFhl#(@6`oIwIxsavLX= z`N->?$?S4J?wFfKT$Fd?7j7{*rXYEhbK)gye^r>czx%l=0~k~K4pyZtx}LeN^cUuE ze&YMh4rAQh-EL)2rB0LUre)S(EyoC%@#EEaqhdFs6_u^*arg+>gaO{c!=o6T#5Sne}cX=&;>=H1cKvGxqC$PXVk`d^yR5Qjo z(6WKyQLy;*h4j<$9mDmTr?aQ^cz{*h)`n?QWmER^ZNS;}kYCdppfi&Se(VFXNCr%j zpbt};Oj{|F02OmmDj3;}aq@-b*T=KCySooT*K6?AU2&lW=)Mv zn$(`Ovw%q{T(dD}#T~k@7vKHbUzzzbi@)HAyqM$h8f^AoGZ9I1{Qd5_DiI;~dkx+>(7%l=bp=(H@uba4OkZUE zBJ>xM6Zu4(togbmy3EmF>bbLp#|t+xl!e&0)e2)1-jo>qBwRbic;lze~n75S<(#t2#3zYk4q6wc76Yb(RC(5sD_0qQC?N8;HeX4iJ%HW zBnu`tqz|p|V|alrWti?rSI-NBiA@q}T8_GXBdLle0OalU?rNy*>i609?#r(is37CD zHu}Q0fj#6;s(lNC;0CQMu7siJu_bT3K9(_l+xilMa&w&4BY|ZN0ps4kw5*)@ROp62 zm3US83=41FjsgI%UBS1=h{6$!vWDEoyy}9U{?qJd@Eo_K=^P9@&Y+L|ti&}G*z5)k zHnF+eBZGvpXFCA&IQVh2>xBR5l>h!3Sa-AmzoHao%IO6#P&pWnAH*Vlco0HIrKX>Bs+!_?X^As(oZHqXBi;fE--E&#G|71 zp$cFhP>I@1!6k6)kUR(}s7k|xZj*-Ep~my= zLfZ?cWc_Lp;so>ZjQ+$F8gk}fY1UICl|zR|Qi?oi)KF}xo{QpQlPDh#!W%vVGYlcY z=`?HTMi(7Co|4e(ZR74kb*6* zylWtX_JW`od3KzYtRCfke^@4zqlRR!FHmN9t)zbt9cKrB-#Yd}P!eQ{dTdBi(YJ_H zCwPD4`nm+XZzGvY#PMZ;eij8+#$Ge|s<0RW2`dwd**DHZYp^!1{>xDi@IQRdIP=bI zlsIOIhK%DvooVIqFCd*Z9gRWeqZ83M5LNnsYBMwWm#I^{{S5i{d8JFfoF?{mhm=~O zf`qDbO%mDAumW+ZCvONH8wwVhKCQi`ggP0NicccpWVLp-7Ew!99`1t`DJk=s6!hy4 zVUiG~V0&*BFmt+Sm~be2slx@SHar%r)6)c5^&dhrmgV1YK!{`RKaQ9T5r`YkJ094* zP48F!tq@W|=^!n*&IOsitT>fP(%{5Nazd+77z&&4y`GpRqzzp3emedxdw(2%e|aT) ze10CcI__#fIGi0LxXI(=Vy%rWZ65v(Vt@4c`o;66B!i^vO0p>Ji6|tgN{9<+-f^{6 zn6u}6>ta(>CckmI0AXP!E5{rAiZAQii|^~VJzwWqN>tFNqMe`5zrh%qZ&fleii$El z{ZhYx_cg2dO80(N_9;a6el7lfS2uWFDh|Ltx&vkT5EVg0ekg`0i>@+!bjP#Lv3H|) z1M-a32RJCVDP5;GXATN@J`Gto*g@B7toeJmgCL(NH>`= z!JhMNmB5fC`>((F%sW*#_oHuB?gJ{IMlSR(M~sw~g#3Zm*SK=|95D_U`9Bcyn#2+M zc>5vNTU!r&wb=;i!=FreWUEs#YfT>;19v!~fU`hAA1vqcp9^G^)_LYb=waOFXbL$u z6t=coNkR3+1%y8Z=-(q6%_qURgWoZPc+a}SzfF35$5}AP##N`SuQ^?F|Cg7F%ZmM^ zR?F&`&sjxaw`+OcK$35mi^*=6R#m8>2k{_pEe-cN6YfLZJzIxYH;`x~zs2AGreVRo zlS-=Tq#o*Om+xrR^+K=RE==43dn2@FJ-9}P0I%@5t?VSJW~#F5CSKvl%yRt$q9<3N zS%vnSsIgw=A($cYYu=4Kb&!2+Y>qkqgKfjF$jS323&fm+E5W!-pnu{b73|LgO<8agI z9X3BVf2VXAKE3J*i2yHK`>QMB{Y6H76{+g4vh;YkJ>v6=wtKf1uEA+i``rZr3!ES> zgEMFP9!OK}l|y-5o^NVFTMta_k_;0REzE*Ny6hc2@rH7jBrRv@Zd#zuT#Gt?^Qg)- zqG@+tH;Re12l)5)ZqSOlU{ADmv~8`5{q}r14i92Av@I-HUR(wf>uOdBrt^|d@uq5q zfRW*4N&iZ`P+uNwS|Rmns~mIn?Ou(VqjCQViu>aMru@d6VK$CF-;v8fLMZ z&$Xk=SbOs7do?8`K!$IMaQD0zDZZO}5qp=NWPP3g?$!kR;61o8`#R`$MYk^_O;IVW zanSi!wNtt{-5XYVCS0XPhR}v$XBfSMWfm*fU7!rEyqq#0XD*q33XN?Pqu09+ntbV# zZ!ED(*8}-8opt6W!_It=Io;qPkQWX6wv(L!PTR_B>h<*xhhX@`tchr>Nu*^8Gd9>l8 zSx0i1)lPv5fGrC>2sGBjz}ngz8d|yuU0SVU4p=nT*B*6P%0M3J>=TLq78G!Ut|Pj+k)gc-jP9T; zt(L^{;u)Q?sZ2d5aDSs&G^LZ%p_1;(hJ6L;DgiW-YMCtS`peewW9&)i6Ia|dUeD+| z6$YzCuNyOQ?L_#Jf`X`(>LDQoCN zAaVU7la*Y)F)GNoWCjwPBtfHHp&QBgk?UJvI%(^~>0ei#<|nLxE&|Lzbutz$ig08! z=dmpDM9xgJ^ZUj%i#v76ICZS?wei^86SmfxbtfaIeidstJ$I0Ox{)^VOkLQxL%&VO zOFht|gaYtg`pI=;N31T`!~UCScLhI0n|(_fi+lel3PknP=>(d4)X zz1ZFTKw?{_4K0gITlP`be7%m1XO9`=OPp^pEbTs!X=IYa-L z9^V=E)Jv3@TM$R+!(D)y^TnD%IyyMi*s*2;BetC@%p)0ZTwWhLc$|0Qd!BA&p#v*~ zfjA=w#BuwU%~Uv!K#wq^r`a6=%c~D-{3wiHpC_0|sq?crHkrIczP@j)j!7~w5Y`qt z?>%_b`_8!`N!`9#`cB}7SCYJlNtey9)!(mKwnlSAK)YmMkGK2EGg8U-uN$XvGD$`p z;K}Mb6xMXGNmrGgsHD7k_7E$)tE?usn-<7V-c zRj*&aUk9witbS>|hC+XJeeHaAoU;AoJG*7Pp@naJf(|vY`|=tuLPm*^Gp|N z95K$4n=C6ZjX5QH(*seYSMrq6P6?K87g%oSP;RS%ylpGdQB|EC+xM}4I_s%Z^_&1V z*lIcU+SC*97$%o|MeynAHOw-|)xNA_IFy;z6XoDHCO4kMWR?DBpyg%EIJ#qxCCqc| zjS~AGq0P)psj=>L!X-1ZEtZf7>0|Ts4+>3h6B{RAx=vvr{VS}dHd4;UW`6V>f<*%} zvBLq6As9j}7yUmFaO%xl26wgrb%1^cDU5_3|4)lrY=9u8zN4epOG1EUILN4SFPvnV zqBZdMk-b8)`dBwYuKgao`TGjILGXXo-3VGh6I*?;wN zVkV>>u!Oie>8T{kJ5+}L`UGyI#&5*L)7H5`T%AYwNL$ZcLSm<)GDt$-vdbe>^~v;f zr6Un`nrxem1ze(qOO^T|nugl2*U9k0LxYR#v5V-sK19oBAK>|hTRzS;fJ=E(%k$!|(N zHEz067d=YzGWHV<=jp1$%c$JLYL&aH!y0|7N}G;-*Y%-pdz=N)FtaW5?1af};aI2L z?B@24GA^)=`i!q#v>^3@4?n4QHm6B>;u#KihXrt`uYj{fjjrej2LBKq)Uz*xnl}>zF$$`7-^*Iu+aKu zEq+S6_0^ge;Z@Pjvk@b2;q?eDZMN=zp8_BI4$t`}$o`qZgH0DbK9f>Hl-7lUTA*Z^ zkre#a*5W1tQ@Sa}@0M8DjQCMZV!v`}HPB}AeT+|%+`m}@k-eP!URz*}=HZ94pS<+-fYD;MiIM{^OyPk69{YJyhCGod{ z1>d0jS^=8G-F2Q|c``3guzmOU23a;XG|?Si*=UHMu9Lgv{RL7P-D%BdS2x-Y`ts)bH? z?^y~v36)@Zd|}g1Dd1H{{^N>s>Ds*7Yw zx$+}Zgj_08Kwf;5am7iTNy#YDaB&112I$^5^71#9_Y5v3j z+1U7HYm zHiY)&y11lejDa|4CBZS&dwqY+VDCLb{H@`7neDW*kh4OAChe=W4idUNq(G& zW?efea3rS*)NSh|3u>fF;6fWQEJN&!u?3(Q)1cie!do^Ez3FrgH9nzMeJ{=n(@BTD z2m!vqC~xYf-q_A(?Ahlxxr2C=-BV)Wf<3RG%IyEmDWxbe10El4p zM4<1cepZ)UG*#PS3gBh{V8rLa2c%f*n!*Ag%b{Xi}T)TopD#{JeXl+kc6V!hReGAwld= zQLKE~7&aBLhE^e_#i0n!GNtYjO$PALj{C2!-xZ)ix~{KSB4|bD6o>qS0nyp6VE{`B zC9zDAfSh_hAHj%xNNrPG2UnDQuAckUe*e%g`8cWa63Mf+KlFR@J(tb)=cLOR%ee zjUwq78%zH3`Ph#qIX6I$wQD)x?>rCb$`(J*T{6Jp0V)31+)3xi1%iFRuw%REcWYcF zv&qAPEb3o!?3SvO3!|V}&zXrE)Mu6{xngh2zA&6WU@iOd<^(J3L^Nj1JN&1&ug-FY z(&+odkPIEbT<$k+z@1AhH7%T+>5j+NM>{D75!!lk zZCj@A_M9I^h$)(Ec=%rrecX5oJNbMrc6_q&-Be>JnBewo2b)$(>U{H@WAMDs&$j!e zOa_I{=#($Ebr?>0V87pW#EE(2B{ovns?k~3zN9wZoi6#sgtBv(8@0>2IKZKLeyc1k>Rxx=^BaAL8v&Dm|9XZwME5#4>X=^f4D z`OzR3{~EN|lg1Dl)ffxVE>Qgy`r4h$1<59IMNMYY)7UYKSe>5@FURWJ7;xPQjFSa_ zXXmE$*wcu_CF!~=rz9_{X0ZU3`%#&J?;ZC-P`3Nudj^gU@?&15&wDD*vTZvkn(L;Z z((?*vQ6Y~M!dR5<(A$d3Wu@dVUEP+;=yRnzC+;ZpZ_>*5_&6r{0MZpOAoHgD0Ae?A!!#Nn7DB2_UmL1f7G9{7q2D=|1m5DNSkPsV zip#<79$}u-h#(}>u;r{;qLAw#-}W*h5K+n~_1r|@l$l%y4fObt-CSi}`y4iRwIN4~ zHGl$t0&rukimDekKrxml+vZqzSGe0$Xp^zOHP8wsKV(H8fLXlOx-aeqJXH#*PU2poLqeOO#Y zeFg@|rj>_c{Vu^!!$q$@-a8pq|DDlolPR-dJLxszd}Sa(qT9x=aJDif@TLNJ3Eysk z`xdX@Y_sacsm?(Vf-}TbqQQE7kGw&NooC_`63v0Us^usOpU5x4Bn6R_Hhi%YAN^D5 z1XP|YnBF*68OraNsinN1vhU2-ECrx(u*g59J&s(S| zq(VtP=^!#H0SmV~q7OeUHR4AO(EdpGMV=VBcmtW2A1l<2Hu|y~G!DLLj@%(eN@##n z*Z2C0>m+A==A(p&N>QkOnQ}N$Dq=+2x|(TsnVm6x_qbDczcoTe^{@+jjGcT)Eo%L> z3h@Y;=!u&d@~acZ8|g20`Mm4zP0mZ_-rN)j1V}Yd$NwIJNt#xfMr#>+3l?g-JG2-5 zbF48*d=1NaZY=f|2+f3cJzNldlT@)KwED1Gy{g(xPFz4-jodkM2B5>Zz^&Zs`nqLI zA??dsRa*jSVN{8{fWWW*NrpAuR%@KgoPLKCe6sdpcF<&alEmbWO2K@h?5r2HkdV-y zZ#h2Ap8@3jW2kxHzsTOh|Mf=>CBbnlx}j=Pynb=)B>o*2zy(XPjq&r@I!(lLj%;kD zxoT$!3h`prb9Z(S@813M=&k22a`2l`O2SH}n0|RIF`+D~dFiNm$*GUDsQc9Qke#;(aT{W67&sX@&?y~Yk5x>)WvYdk)JNvcZ8=Ev>nF+0%&nsBdWK=W9G zFQ!&87Aj%LyygAerBgwYZ*8J+YN!`E@I5}74Yav9pIB9NSg2-)00zDDm>4G#Ehv3I zD`Q8I!`u{CFLw^e!S>?tC#Hi#>avRsdtqz6E^QR4$3oh1TT_T z$`Q6MMXWX+4i!SUa;5hb+%^^5Mm8$+g;7-_4Wq&Ol$bW!{Ck`Iw(t8@lC;~o2f613 zB3j1`!x!>?EFF7~jl+HD-==cj?rdGwZfE?hVqvx~)ywoSe=TU$@V}Tc6XuJ0`E+(#Rl}1ut&2n zT?Ni}v*ZW^0-n^cEg<9H(;^nB&g8ifz5q*OmS5#LGEq2N0g!y$ef_@Tku*@IP>7#Y znQN|0b!<})>oD^0_&B<@CUJfJu|mI`IX~qa2a7KPp5k21)RIQ3tm!!VZ^k>v9n;Uz z&{tzaMElM^hLBd3PrQf|2||f~Y`R|kA1U8w3wVgq($d_yURStCXE&^+R*!&*~CnJDfx;1~O-ixr+~`?&LDo;LA{0FRUJWJB_F zyzLs$ffd>3p1fKYU$0+x4&^A(qeN%7M5O)BBC4O>D|(&O!y=Ga^WBIzUWZ{U+K>R6 z%qxVozVe33pafhSB7+sQYANEtr8EE}nw#L6&NE6N8P7Zw$8VE0?^k ztZ`q*P`0j@(GsSO`*gpP`hOwSes+4waG3LrtH>U5HNn6UYG~{%zsQs+acnc#&Pk<_ zxGAB=SB4cV6HgrP!SqrK-mlN*dGtcNWSdIlTPzoP9R#P`QMKd$3j~#x!KU1H7%UaC17&nozrtW}XcJEA=P#nH z>q=S9s?Q13ET9s}nnYyvO_A~m*lKZK=4kU3-r6Ae#w-X#-9qh+N)~h~tMu+-W^-;R;c1v-e>MMn#8 z+Z+}kx1JgadmTchEMm4llrQADZc)i~iAb}Y` zBVkcl8nXg|zl@dfJHG2Q2pTX=5xxQ5mN}&A#a5$%_A^(?bM~VQ8z(;EFWm7>@*-s; zIJxZW%_~76&h^Osqj&3_M9`iZQ(%ic;j6_}q&krssx}O=OJ?SXXv7-QHsJkd{1>sH zmYqUwD)?jJSX|J``}`M480yZN&i z2yoo*6Ah-?N(S77rlNSV{wGJ#`D#4k!@Dh~2Qe3$uTKsP zixTcu#2RJ*Kzu0jv~MloEr(%B0`ie>z#r=HBPfeaK3=$NjDZRK28N#F2xl0G{PhXC zOxAvGxQNW|Zi%w7$aph>?1QK?I8ViDvxB)S&)?X$vi^Kyng7LH<{aT1`Vo53*-JL= z<0sEX)*94#Qq}J~lHj(Qbk1q3j%iqanz_mTP^~u?)F_u?6qWxH@=p}-4d1E%M6Nl> z;tl;`9Pl}M|D89^R@*Q_CHl6bWE2kn+3umn%r+8%=%X`oce?RN*bzC|zl*)(9dfTp zDIX9MT2-n{*It%UFTxETQi^Vf18>0{hFuww5#HK5sUZYtL;<##TJ0~_{r@@7&#|G; zL#B1oFh@DNIIX}D5Cw~O74-yN3M5%!tj|bN=R^x}^pqoX*h8rp`XZ{vLzW`@>dKb4 z7c5&ZL~QpSC_$?Ez*9Bc`k>-5y}kmH6bVh zMzFkwqP}zrTiv6Q*57cFK+2_Ed#U_KunBFO{g*KVBgY~bpN3MWmkV6v^co-LdJn`|nixtw)`0!Dv zxzlB;8yczop4B@2sFDOFet9tE;z!0wq046=_|<_snHX6;T%m7S;g#Q6z+}dR_#UiH zyi=%MQzo(CwYpvn+yKaOMN&Nv@8uX=BsKfi^>-ij&Byn)=NuJxe>VFHfQ1&%M)sZ# z*;9o=)j?xK^w8^rY^%8~l+j0O-BZSFbMsPgjdA6^0Y^g_f(k==YgT6hr#DLI6wtm3 z70iKgUWmvS?T_t$`rRzWD?l=jj_nFIGe?9q>Jq$|XD`Wab`?FYhAK<1O%*(a{ow*# z&8g@r5J(y*Cs3twbg7fX%_ciMV?41{CjzM<2$jI~+qKzA(m!QM-#aRQXJ6LM3Qp@& z&63H)+JVj`M}=$wDZX$r3nQB%x5NlXNYN3IN@+8Dl!z@TBfyLqPObz70_kXEAIAT0 zM+o@bGnWTVNHafIzaqVi=3I>pKP{^{%^vhi55LZaCopOM*d$Mx^07`xgbau!)QH}q zFA6U2Wo-v5Nh(;X*NW@`{cXb{`)#i-l&kQ6iD-*nrswR!+8;cIIftFsqqN5NqUJ-5 z8T7HWP4%XTE6NP#y;WskiBG8!BV8j79SOfI5)?<^5<*>}vzjr?#Ut86%8#!=k(Xo1o(##C`5!KuJ4R;Y6ce4_zQwGaCWfjIamGVH3KMq*W|9GY^Ehp| zrl?^MK@VqsrF0b5yiA@ud<+@%FsfyVSEu`%u($OYQmKWo-nF2IRmH9H{oX4;2Cq*E z9&wOYOPGRK;ZxGv^$T--0)ofA`(I|t&?mc3eReN*NGb&sPfpFnO{3XjrMYpz6BF)A zMV@PIeXPvmWQA?x;HFqTUE@Uhg1s=3UI);?#%0*NO)nBjc}zgt+@hez+-NhjmeENxn9Bw&%b{X5G;H3;x?tUv$q5T+KP0Yn>H zDBWHoW8b8#8aasOTrwF{ za~}qDF55M{8fH;8Ff>{D{t_7mLQCtc$!+3yVTmDkI~0G_wS^o7#yl)a6SCZUZ{Jqd zvbkcH&;NXQ02*iE0SpQWS}KSamPKZ72AVaYifj-X&O-kD*3F&&xlDPU#hLFP9)^W> zeCieum@Yfw>C@b=j=s<01IqUSV!wInt!j&97o>M5%Phrx%J)00y(yhCC*{lP$ogd= zv5Zw75L;c0_mJTsl{Y@IWc=s+?#{K1ph$8)PNI8i(XT~j=cbA#Ha4hfbp-~itn>** zqdY$ryz=L>?<%eqvxjzM&D%Er-jUFPPITAJ(&#`?V!UoB@vj(=Pfr^k<~N{4a4paz9_c{@vGO?d%BM`!qtw~IKjsB_jkUJs7xg(07Xw4Nu6 z9YQJ{^XIGyES^l7AoK3BBo_UebwwXpuyPH{uD|3_|IVZAtzU2 znkJ65($HD|m$-^rP9ddVY&iAG5#PctF*CAxWveK`Z<@(icEYbQugXy{Gi7j)1+emx zt&IuCG}FxnZQVvz9l8cScUq$LUiB8jmpK3B@#{ppTitc4VQ=wYzEmWW!l@a+NK6l| zm!s5#nrBGo{T=_1LLh6MMJ4OdoSYbjOmlr4P%;VUv8G!0qL!6XX5C1?itp1{Fg_4v zoYZ+yDFJP0HwFEL6=iY~ z$$fmf#ttkZwr1Pgu%Ka1Bdwa2)^W*OAg_$}J72bNEu0FA&q>UD&dMu!cCJ5^hTW|wkFI{8&W_?k&h%ws*OawDbZd&q zfg3)LijC$p3))xfCC9?IApG|c!pQ?(^t=-cd|8e3e1wOGMUnBu9suqNL1ThWubO(A zM7GUfl%h2c8l5Lhg58iY^~@W${s0MwXEM{jEuPj{93K65aUu8dfWBvbp2RCXX@x3O zQJ%#gPaI}rw+_grozsdUyIROm=>B;Pt8>IrJ-dkX!sQQ46MEfOUPXugU{gOl%&FV^ zn`hC3lPp_vV5by>p1Qv{KITP0Ol^uUaq5$0Z9D<$*EH=lL}!9{z2`T}ausSWr!NAy zYh`LR8(MN^`X~Lf&}?_mc=Q?g4sdW}wVH|gaYR*!!zuw6_Tn&vCT~cFK~#a}HO)ra4te^KSW||nLV6=;XaTEQQnG1)v zMC8>$jCFh_EgAEnCpN3XGVyDMAAi+;4(Pv>;GvcL+tl^&)4403((fw#1yZXy*{lpe=+u?k=rIg4T}VM$Ae=q^*d27<0ZJ`O|~`Z|TRYA1ek~ zN#J_Q@V?{3;m}WslOq(l0R?W>DVWEP@U*CDQ2Cb@e)_u4Khl6xk;n7R9NZQ#6j7H} zO(KbN(LwhwJn(%^fM1Rjdslf3UGROQkg9H@fKc~PO|`Unp+&D8izyUH!=a?7 zuv)2QGluG_6ZL4Z(K>*i_iYyy{CVyqkLOa6+##L!DK>v^h|f{JBZ0xe3jZ`$K#)LI z&D~9fAT#4Om@#tUEyA}@`?sv6u05l^C8M z5D|WbNJEP^Ma$xN2-tvMheeB_hxiX--!M0ahr8??XoYITIL9ke8U2mLyBAJ=SuORSv^RX;s&IIRHnp0P=(ryl1nEALpmIG(KK z9I~Gd2}BxlaH9S+4Y5Ur&E>Z^|6{}s_LECB;IV|Q+hbH{`Q z@z+irv?Icg=OD~@xvCnR0jcf!=MkANxJS940wt}?2ZFwBJRuA}0O7K&t-)L3ZyJty zCRID~*{FiB#Hydgug|DPMQ~r7Gdb_2X;PEwB}1|K^NlJp5m;pLbD_NjBrVca zNd0&m=;1}bdjihL>aXwleVtfRBZ=v{b`wS%DBz0kzn}G-%cc+t9H#r$p22fgIoC(9 z&$Ap3P3FA(59WXQpwTTlCcgpHiJh0S9dU#AL4(dKx6VY$Z2m*=m$;kmY4u9p5pB6I zwIb`7^z-9HS_yxVr-UChchQ9w7u!3!@|_)+Plh0o^ki!oXa_}1_Iviv@|8ge|3 zDnG>4V#_hlJ@k(~GW#$1NcxO@BvI6Fb#>ay{k#rqInerwdL1u>*Y$&W`oIb{_Lwh$ z5kNV22GnSNzMBoo*p9zk%nPv9*)p_+VK{risl5zb@11(`vphmpIZtP1MG}RSG)iovQV3B`3vDN;UiFvI_B_W9~J;RrVNg`x* zg1rSrdMKURtVr22#Gm5U*s4SO6<|gRDo!;3R{H^qg<&j=+I(=5LFDO7j3dZFsE{v@ z)XEwI`g+Q9syxlvYX3v==M)d%Anl@Muh zB9eDt;)P#h`e3G;DQEx*GTO>Rm(g!THbUr+Qx-#5AL?Cs-)V`ltOws z$>i-F&4a9DCvAg5xjah3L}rn@n9H#M7HKCl;dk`VA^@dVRMp(kxqIO7wf2od0vnbm zZ*c|WtY-#~@dz^^pj-)qZvibOILbF(DVGY)(>J z4`8%7&M&q+yD|mQ$vm1fOq-uN0kDU7-AH{_U76PM)ExHu>c;4J0YTNgd!tRuGRCbK zPsnrlBkKon#&>>?2+MBege7p%4IgdN64><@t&eZA<=Ma1stud zdGy5xC7m}(_oD2#Mm9#?k*hhym<)vaFcRc1aBS?urjj!bEJvrHuxmPMWyP`c{>;O> zjk}01=>tSwI?(P({;7BlEoBHh^NFUJRvKJ>cIdUB8k%a9sHRfw z@R{y?1C$7NX_MbT1XjQO?<#hsO-yic@zdk2!KbH(k3hxd^ZTX^2pkD&uQK9J>v#e3 zXZ1BG7#=bGd26&z$`z`Zo20u8@{^vh@#ud%`03D6L@P-%6hG&~_KXm;Yo91<&PH$w z1!J61h1c)ARj}w4R)Ll^rg~^cMJp5whmdu^S(AMZCZ0~thc3tPUgXmCvBsbcKNZB# z%Y_ofYC(MbJZTf+we}P z`oBlde|F9AI+vlStRf@J^XH_&Xm7~7zn~VNq@UL}w}bn>&F zB!^}5F^4KGda?Q)7>k2p&jv=O7}2zfVrDrLt+HQZC7anCq0wuM_$a?DJ}3N4V^gH{ zcZo@{DN`|z)MfOGN_^Xw==hzy%}Ju}x!ZJ+P4yW841~!^Kz#Uwq6k{0z;`v#ct#_A zGjX}3q*wFSd3`zr1G&W#G{aFI|5(1P{!uL|J$O$0TtQaLhFE?;JeF*S)uZ2C55H8H zhO0XcCm>FcT#f7eDi;ru7ZD^9(KOJ8Nz%vRDN4-?Jw4YrG2(U{sSELRe8)*@QmJ3U zUv{=$EUR5u^@OvlLeNz2nFl5J)W;xse|CXXwwaT5PGjyTam-|yPfv}sA?yXP-6?(TqGjY~_*no^*u9)T>w*}tEE zOqXY2ktX=uA+JK=pIe>j6f~q_8)OwlwzmrlYbY{NCS4tyLdQa$vp+W*Pykc#!THro z)zs;xSL;tV)Ly1_OBF!3X!o(+zp6s{uVI3C`0#Ao&#N8z<}dQnv;1?>p%Kz>f_(F# zp>w5_VoDbF+X_Ze9mK%d56+g3HWck6^79t3hq3bV3S~KaxZaq?%jVbA51|R*DO#wj z2!&>MuJnw~buYtzhzogQG|PT0eQfl6jPMgk9o4iMvkZuSgp4`mKegbQAx{__4H4 zG{!254qn_M>#n}t1s<-6A$tN)Y`;%eQ#lH)7M<@MgQX@#1GJ0N=iHQ8_GEvusc8}( zSU0K*r~ed}-xc|d`jTmN&`dwd9x1H%{6{8=9Gw{URoQtHo2JJwa!5@@3I%f`Bk0nQ z!bs)haYt(;?TZ%@sT0pH!-9{8eEKaeO3yuDzqNCjUgZe-wsjnP=!dKCA>4@bK;ZNo z1~>)n^rI8Mo}3={iBs>r8$8}gKfZbHR=^6oI=l}#d!`2Ynhiuu#b1-ubZGouvm+E! zaSW5jQq~I%*}Yaxq7$?JMwgvFV?RU{pgs1VsI7OxZ0=WL0xEmn^u#aK{OpYbBZ0C; zXYB>fZ*;w6>+KA=Q#s#YYrUN(kvG!XMrVfkBJ`3A4n*XQes}QW$ZL%pkJ_l#%f<+D z?Rng$7p$qhef>^ooMB5ziV{TyNb%O30r?mpI|1f;w#XzV5NS`JO~>x>ni!zyGIV)U z=dXPC45j2MyZ_0=~(-oae%krf4Z7_b(Bim1YT&*#M+ zyMs$PKR;ZFJzfk-)vO$+{UefXLpAGIr*AfL``*L4dnXr7Hr5kUL&JN{8DDeai75v=I_o2t75G?^l_(&W_*-7_C8zaQTtlN|GJT;Kv!8DH zK1WTmaB&AxOdG|5DQG)>6K3^NjxG_1#u3em=YDA|8!C^=!$)h9}NrF$ydzmm;T zk&wHMbN`;fV3czmRy$;#tdK7yoFG4)R;gv`Z3|i&hbJ-Z*%Ke-T9Jh#L|^G?nE;L1 zl+Z`tSG+8AED`xF-)zH_8Nx1=wcf~M@#@$=V-u=uW$zaW6qQb#g_aeO)>~$ks)N!4 z!nycz%*6(B8JQ=;plenMj%BNw$zf$va#Aym?}86ojOXR7_F9A19z#@AoE@e7UPLez zrVp?V@7F5SmQcR&dLdWD1jeI}O5_+8o0Mcm^cjU4&3&QYx%{pg{F$Ahg)?RtY^1KG zyTxcvvGkcA^`NM1%41Ze&zS;QPoz{*Pe7%Oy-)IAD;{77p-U%){>+km$!~0PxlR=S zAvZpcNJf-+!tEKm!s^X59uZ+gjgvfk+u8^#CmQCpvCA9&7`pdW)zwCo3!JIg`iC6$ zRCUBhtJkWt@Q(@hP=6}We$_x$n}wEueSR7;i&&ANO|YeZK?FQ2Ozp}HX?>R8KpgzB z={~&YZ1*^9r*(5h>LJoR&~I||oX<*%IeDEGce`}wcK-$QXelYSOD9XlGu-|MQnkS@+JWS1AQcvfT@ANuu4lH}M}w+AdcA@x9*vtVIMfB~u!5 zScOM&m!|IaNw{CEMRt-Z|M3|ShTY0rnh=Y~n%0jY&ns#ObGrhr!g;S! zX%!-Rn%NHz5``?F`@6~7C3H|8ONFVrC(Y85kcPL>`-O0*N?16EBzKP0JjL=9K!TeU zT6)sRV<@S!g=!^mYDm6doPM4-${<36`f8@2ZCpbj{TF*7E4m_rS_!Wjl3`-++$_)5 z|5%gyrEUq6mxKM2D^7mCSoYs@RSVqEMoxEnJ(Te@G5Wwy-b--_iL+ya6GNC|Zk>9M z;n{42t@_Yk%$WRAcEQ6aUvETc4|?R&QE|GYDEurws|U43_=4?3zMZ3mXsk|!Qh|PXJp$bdO$9jQml-?m%JaI2 zP&6ZQMxoTYvP6|OM28Y0kh|myB#+M8J9TBo$cFpGovv>P(N1Lfs1LYKq~H)5Mv{4q zb72n$jgUE~iSxdFPpD9e#4NuB+_JvKvVI9T?DPX$$kD=*(TpPHZfk`rRm_zQFKRii zewg>Zt^3Q0Sh7rrqYVoHf72#Jg@|UeUXg>(5wO?^V(HObn?{BdOzo4z5q3s87kBE`3f6x zo`za@1Wnlp4zl*Tw`}bit7f1OGifG&M#z9O!|CMHKOU+$MH)%*vx|$g0Zk0Z26mKf zVq69IE-P6Ww&vstwr z`+ncDPUhlE-jj?T(o?l6d8dkV2osU?vx+VC1KliDvq-LDWZ+8Z->%tHGi!A;_ zE6@Ad^W9E01P6Y)O|GjqK7NViAzr&en?68uqBz2!C{r)@-3; zRh>5?WGylF@7^Q+)G%Pd<<>IVdv4>+es2Y1kDS3ddF(PkdW{A4f}D$s2teKlU~ila zIa76Gh62?H(S{gwurWzbONFH=i3pf9_zxhAUHEM=3M@O+kDN@dWG6%qhD`Hc`ph)8 z5_q9}o-f*ta*obZd=pcB$mDPZ;nbr2bL(qsXSb+tzzt&n`F!>u=uE{juGrrCfaTw8 zWap7~Fh$|QhB>mzhy~tO^5?|RczW}I zOMz=4mz#rVo)!R~28_x(y}dl*Qov;YuV?Cd8}?f3Og=0ZxqoU~$DYrvLZFT|Wu#z) zkkJ})uTz!d2g_&~ROoY5jAPihH@0=4&L^d86R<@xmsY{^UM->Jt%g23xb`}g$@(!XUdE%T*F$3yNgy zMJ5w{g7Isa^LX+3!O(Y+tI`O2&jOQwowM{9`CTvz%6YiM3QeD(OvXu4AaE14;Vu zHr6j((%ww{;E%%@(7Hdesz|PGF80Fo2h|Pgv4?2zQV828Pp;%r@leW`+MGX9m<} z3$0tNB)G@HxoV*zRiIn(U*Cpkwt7}9??r;W`02&X&ob_tU4w7+W?Wj}siW&ZKi2CM<=SpfA_$n!bLfDl@)7wRcvJa( z9iN_&($_tfJa<*;d>QNc3fA(B$c*2_hfS^FTlb%& zu>R`K`^3-xia+mqwUJD`TLI%Rd>{TZIo6sW87*khGTIDV) zE2>HXh#5*0cGqq)-z%YN-{I4kylmuRZSOG%&Y0XLAkh-94q4UA5W|#(;4tgvani6ZJVw6Z&x~g_gygxlIdZq@Fl}9>tuhatWEibZ zh}1l4Ry*NngFq72E3da>$jGda$JyZtIn9-!07+{NnXASzR14HI3_O#PAMm71pLr}8 z`##1;rxE^DoqI8@hA!{x1e|4-Pl4V6#NvQiX`Nfx$XuT?qA&sryJnCPwiVr*3;jkL zm~JbZz=6m(rLhs(4C8kDIupXKjM4b~Q{GFPe{W}j&a^0#yQ%$mUT)Q z@l%Y_8Fe5|!>m$y2*5NU(KAZY6B%WTy}o5@d^hUjwTof3;QyoPtAnC!-*7((X=zvlLAtw< zknRov>2B!`X;`{@LAsHY4rvxxxGeXBGr?3WTjb1O;BMhmND0upJvo z9gXySqx!W8rjK=%g>+~K-D2GqL>bIO;2=T9$t6@jkK}#xBKUui*&WK4#}9dYmR$=> z_Nn8PHUEmbbE&{>WMQt;F~bQp5j~u7>W?m#Q$>GhBN7|};>}=#NaJ}Uy&E#i?xXdl z*%o-2z)J@DBOTvv0mIdrbHH2J(Gg>2u@o`6LT=j4o@z`87zOueXD8+EEP(vIb`7sK zBT2a+F2jFc=iMaEaM*RFgs1r?bNVJp#U#GR5X19H5-{_C?AYK~Z-lh0(WNMm2D&X8 z|7K?2%wkl`;-3k>C9-xse0p2%^#L5d32(3KZ^QwQSGfxghKYpC`FedAV*cY(ihiT- z?P#Xnt~}Lj6|;qmaRL&=jCqMQkj2h~NiuQ@${G9t4}qhH2P-SFnCRQ#d{^<1e6e-0 z{rAUeaYpf)r>N+c)7Mldk~fEP>>;#amyzQkcb~!|B_;xShabd1Jybo>xX6~;U+dJr zizX037V8XBvF7xSl+`7LfGGD$u@k|AxJKYz>H3{T%@J=<6?rykCr+fdYm*HtbA(-=YO-) z7G+&}hE$eX%0)ST)MG1qWTT`@-d@M#>3 zLpjyq)EA=;r%QmIgQX!pmHdVF%TM-Iwer@&GMmFJ^wT^hriphwMf!mTrn}yp$?%P$Vl;SNF%evv#VML4kHDH6=SC+%~>`? zz~MV7{Y&ykMK^dQ(c*@ixP}Purr#toMB&l=R)-i{J!}kiO%{gUTzJNVH1=3{0Xk3h zQq}~>B{kz4u5DCugA(- zr|jyr*EJult7IV^Vk2oHTuHgjVQUKrt&yKn!}+3Gn-aBSN{%36Oroen;@2!Db5c?} zhB><2@Ev}ls1|i#*koQ1Uu((rp1_&d$}v#))cfj)9e9tG$SVm^J~L}iSw<%V$#;iJDpc$M|CIl6-OQDx$DF$Wy-6z3jiiuIS*=fZ$5i z>25c*oT1iy*rsJ5yxYIalEkusgHX2SE;0P_`B_3UO>bR~wkNbehp8+RpVdiu5vY}+ z4DSt;tlt}3{oc@&4aBZGyS{X@DJg7a-}@d6Ak#}*Dy%iSsMcm<-|LIL4xp2VGlIes^1Mn+VNk|}%XguO6pHA0c-xeJra50MDK07w_7itwMMYIwVgLTmfB#26~8Bh}DJ5*M|hXFT?I^f8kI^puI6N_AwY% z_!HiJu**b5Ufdw6k8>@>BdB`6GWIf<)RSA%Pq-2*OJn-2+5Hex6m%*3#G?HZi139N z)cZKZt3JA7`HoC)!Sf!uUB)A$EN%1uSnt?5JbnM&jDA(Ew2K{KsTU}ztE21p{AiM# zcDHbOzmc#gT{))1gJ!2S!I`j}U2NBEFyHQXN1Yq+ipcxt&$bu&>79hm`P#;_f=-GU zQaWw&WU{%e1=?cp!&eKJ{JAu}PxfY&*6OGSi)2`h7O`R>A0|y>#E#+}D1(F&%+1@G z_Vx48bCs$rfPKN?sPQgq)rt$Dp#ex`nLQ;{rB}cl(0{oGgrvfcy64X(P z7LD6L7K+2!X>*s)pk=P#`0PzsYxR^2uYnY)@DN>L^$}XSTi5y(Am@k)c={tUaTgrH z;(MPvr4RE*9Z#GA@kiMXuotQpP|@oa5d}R*hdUHPzYv&9s^W7s^=J}F$6gNxt{zpW zq+Vs;dYVjfflMVlliWXRYN{~J`CdIy1L1#{m~8>uHx~&dgGdGt(ueaa_!?PkT7<9* z=YP^?k>jeV_!&x)jD(KIP7r?5yJStpdfi|3(f?&D(Kam$_0|N8S)Q%we^9YDzF!bFiluUpVitx3?JAma12G6gux_nAefr{o&|TL@pow zt;^hxy0Htb*4!thVELWV@zoDTq&|n5KakmV*Vh-)me~KMv+GNW`~Q}SZyO@7lxsdf zP$+ZLk_T)vnTW9pUuU15~Kn%DP4lgorD4Xo~XV47E*k(j2z2Ar;i!5 zNTdw5wLIdNvu-2DrDnCK7SFDKt)es;h6`!Az<-gsT--@{bJ7Kd2pKu>t(B1;JNpqu zJ-?a9dK83c#|Y{8_uAB&xi$8L51G{GJJ{%5H-kzmGDo!ya&xUczMxi>*~Mn{_q4B` zJS@kFT%2Ez0t63$(DkcSCZ|6sXD`JHG6E*Zy$aT@?Ng# z#~A09CkspD2X;k;f^;Xz$uz95qL;gS+wgq6GC{Z*D4x+%5@a|SqV=WJl9xb*xWnlw zK+S9&J_5|s_ww?d^scBIB~($AhD{12`(<2_*L(PY2dE+7J}2|^^(`zTw5DM#-ZsX% zv`-+k_Mqqo(kOggQ37$)1LN7s^6AWFPv8gjqsWAybu?Yx!J6+2oU6ahlMwiHzMc9Q z7(gcH>Q)`f4sq<6ZcK)q0l2QGszt4+UuVG01?B$sjkxn+jCZv6Yk-}XzxVFWLk5}u zJ>p|zA`^tSQpW3U)aRY-Fv~v6^foU$9E9P5XMRd4t3WEo5|@{G zx6P&2-4KF789An)ai5+zqbWgdDhhLvVJaEF(H)SHn+=k{n#8+(%Zr&fKwK@Y9^}kNM!<+`BwGCH?FtH^?#<%%rfd9!6x8FMZ zIHjb8b~W$wPlcZXHyxaa42+dBfH8pC=o=Dn*g;q3ljMpDBxwSc{&Fp*&rD%(h)$k+y)X3DUP@wq(m4k{)95?Ts`fVDi1+ z*&y_PzMvKMy$42tzhE$`%;bzH`)$$$NqNH-A0vK2TB)&pI?kE0?Um~L8gw4^qe>nG z!hiqF)!WDcA~}e-(0e0WtLcxz`pXM)X#`QFjk2Xb48prv>+k>?PE`=p z*{$Ei4VZ3Ufw%S{Z2k2WKv079>py@ua>MOu=<&fu&YsoY;+rD<4*bDHYiOS}3Q9*3 zvGN$?lhqnd6883Ju~UGpnWpUOOtN1%hX8k&vm>Eb;2hWs!cx{CoP*|&C_COMl*f%j zFDN-MIeEhjtAXLUiRx^RUP()IhMkDTo1TxYZa;8S7=J!Ht)A@prVB{19Aow>@Rlx z@76u=iqbz;wC-Sv&7DXPtWwW}E@5!1;aPszX#`W`A7^0{oamF_R?z zZuaOv3I`pYgR^X`o`DRU-28qrOt@tIEU}etAo)l2&K%|MFGE*wXYF_$lEcR(X3@?d zc+*rvv7dDc|Dr~8pPzCUPVX89ag~9v6r3_m1~$%;rrvU9bDhaM%4w>nTm~Y;5~poP z-#jv!CG|K8XCIgTn;S5QB>aU@Qm0;*S!E8V1D*XN1`2b^1`UeVK@&1cuKs$1 z_Xrt=SkE**ZlM%;D$HzvD3frXU-`gY)XFSZtpv0$fc4kV|A9K!4}f+a9!%dDhgFpm zm)TJelM@~5>X_cKCy>S=k&=-;oVK0aAC!;*pH?NWb8^5nZwC!{|d6yG@8 z@1R$XpxY8U%U-DrmZ_^69#ZG6NHzf#eVx;k)!eD%v8{HfVGEcBc#+!WA7w|0v%BEY zb(Z4)uLUsqQ{?S$5g_R7=BHR+I#g9O%3M-iIO1|Ss_G<^pUU zUaOtw8+(TL4=*ra$$EKz-VMD4@{IN$V}}*-%q7#LvRlT6u7Y~LkctTAnf?#50TlG< z4SufJ)h>v?m&E)!i8eRhGP{pXR|}Edy;MR4nOtR?A~t=bsUJo zKI~Bp*nrF9pVQ0ndYkXWB<^CpAp5Pjy$fKyE*otY+jiLEiID#MCA8P4Zsqr4<@r@M zf+QjXYOOa!|KkCaML;=53mLU43L0@_*M4pA9K;p5RjQ^DmS{N5WdH}PpJbB|ov!Yb z-jpvM3j24~U#|g%7RS%5UT1ng(E*HJpYH+QvxkoQkP5eNY7AI(kTa$p$5F1ooOd5x zp#^5QJsDms-dN6z;s02B1(OBbL$)@4&ZYKS6xs>Lxd5@jwhf;7vPo*^34?>%EJXdg0Dy!Fi>+ytu z7VUUe*4Gm(`P*J%Zyv#a&V(%+4FKBc*yFqRp6BWrkp*l-F8en#V^~3f5Qc07ktv<{Y~m#Aur8BY=tmeplgyY^O4K{=oT zTQjNJ+1SJ6GLISKDE7)f5y&T)fQ)e*T8MI@2X$l!vD;MAg9anh4pL^ld-vh=*Ks45 z<`^5odYxd5H0tC1E;p~)4Z67R4@<|j$BS{I$Kpk$vc z7keAYHi~0RBG{b4_hn{*Db}<&vS%_U*4jy+*sw01R%T+JYeZCjbAibI_iz~# z`{L!91|B!Dszaf;2q*1!RBfuo>J&e zP9|JAvH8Yqfr}t|MqYDMGt4}dNDZdM^WhkYda4?iKI^Y?3 zy%%{!!o_mtY$Q~lr@KK`W}jyS)+}1RjRM2??6lB z{0SOpY<8AAN^;D(@gJaU>D`F;k3EO7ico{9T0OVzIB;POcvQ;9Rs@JgF@l6T)eD~x z_S>{m^$ZPv{rq*dlPcI6Rc=c{yX)26LQmgQ*U+b|7?hGz$eqgcXIsbX0TPv;SC0C% z?nl!yvpr)U!rt>+NRt2~1F*FP2nvzs3!h@^{2`atwTo+CBNE!Cnwo5H7@L%Vq4K>^ zORKm1G#3I#?1_S=VQtH>YEyBp5h@XM44ki5x0-?tJZ4hGP|x? z=f@hBn-Z^gok`FBzvZ)lU0A>a=eqyXr?%d}*7DL3@cP>+P}L9sT&DY#`9t`{rEHR+ zV`v`+g;;F-{XLD_RxfW)gvLz9US7h=BP(khbnL2Cy_87tiL)jv{iVziS2w=$j+)#v z*lgCCdhoHum`=gw`>^0hmZ zV5T~&)P|B+VSJ<<6qn*_v{8 zE6+m+&fJlb zf|uc)$}YAp{5``B;O>4Ca;q1*i~0W~Qvv=_l0|K5MR$0EU26BK2bV_KLOyzU_#{Ik zexser0TKp@$yLo5kW}Vdf5yFxIfMU9a0#8M_`F9}Rg)t;@AjB0yU*#=f+ShF=jpNiPJj3$POR|K3Ry6BXlp+RohNEmRWq(;75 z(7NamKBSZTGpQ;6fX zpnYE-YSZ{HYyBlt5SC#%2$bedhtr-qoY8T@!Ut(PUruZA+{S>Tf6PL>Ue`E!Oiv>j_!Z?ef*~%(EU7!G$92j#j16d<0GK6kVM~&!6M)De-`;yIG!nc zLGdUpcoNc;AD&)rcZfsAFC}# z!Ej~14TJyF(>h12(A;0c*Jn#%L4Tuwg#<#xX|8xT#KB$zljx^FAUI*!BX^Q1je=cE zcYv(~P_ET~vCs%z=_F8O-dY$nN|7SWl;AUsPY4{dfO|hd0yz*)C=3jz^UVzxzdfl80-VnbV(L z#rr`2{Pu&BnN$4Ml~+en>l-;?_-4|7+EM!S#F9@88Xl&!J8z7;NLOr~xLo z(70mEFDoR>k>}IkwP_U{4)B0Hg~Qv=Pc)Eb!CDN!z1ju)Quh}(Nab~X7E>Ngb8KO% z-9cu2xe0{w4yPO})u$5{1MVV@Zx@02?Vl@Hsp6KsQlZp3E&18&dB>^l|Ha8zM?EIm z5FMqdz_c}8l24XjHysbHGBJXJe)>D+2Vz3T zwjjN=*k)2cl`(B&ODF+y4Rh4ujTg{y1ib78h)R~V@72ppH#Yc%moXfA4>-5vGr2fd z>A?1yo6I}Yudatbm23sBS|e$38jfbL5^(8DPouH@CM)ECWUrg68pRBNBsI0=d3j-L`}XND=PnfO@FB4x>&q^b+MK(f z+A@en?kcu3jr=Y7l$I1j)|5m#tvfOH*U{pS|JB}{-<}YYk`^{nkXvF`RWjK?@zc`M z=!&$N2m}LeqbrVVe{J8w5B6e@kQAW-LSgHV(JAp?azp3`WNgtj)$kIGhs?%HLY=r{ z;l#$;2XR&CT^%|MP0_?B((p3)2MI;|9woxA>%p@-h;I+T?CkY29hcoi95$W6#M&Re zDd@LcX8=@zxC?r{W>>V?68R&AADLeXaha4hma+Ld(^mBZYSQFDJj`ml@#jtO&MY&) zfPN4WSP}>5tIgi0yXS-1JD~GS`T6_>^EgiWJ+BEz)Y)LjT|%hlzxsE3NRK_g*AO1Z zH}tnRHwB6^X$Ji?X3WQv+K5%XPHxfld%a&Gp%rK>)eg;_t;y4aWj!ULp8DVVG(KZ& zeVr$XL|Alfr=$>0F3#9&>4&;IImxEt^AR5W&#X$b>CJa=T1kQz`P-c5d#zq(gA+0` zQ0-u8B=!h>zoEvyq0UuL@DxNyE}Lq;t)sSM?boSXGIW}|b+p&t)u8@`juskJSZ&>V z>L^C9I>l7cG9;6gYK-39&8Bdz;xziixvx|!;)+sWL^K%4lqA~5VSX84md8~xFxdbx zR*5#Hx=+9YBy#smb)$08_VXL-Lcf=JC{Cc%TfHD6-!iTcksPUH$gh~JC70%mY_RaF`acgM@lmwoHtdu=7fB$+xY zU;lm^ub$a448pXum6f%+*7jn(Dmv&#GV;ENF;tWkM$}}2uRE`v$pjiKFUKG;wbO{d zKh!|C`hynr8$gJ*9SIooo%;9 zC|zK3zOpaRp5KTW8SXjWJNecS7CAq!Gpgx+epXtwU_7go(%kLWkCOuV(kL%eQtDdV z0dJUZu~ASU$r?Z4em-F5L|Nqb_aFOh@1(c);ejUJ{I!CH{5#6<)32JE0Ap&xQ!D?v8a3n}s>er-ADCfIAu#8xH3zb`WJr8bbDr792{wSUVTHH<-eb#OG2k0`~MmdIs1(*s~(7 z`RWmSY*#=|AM#z$fl;z>SIML$=@R-;UQ_e0n0Q{bIe!6!IletVVt`gPu3gxaTb(X9 zFXS&j*pz||UP07MWN;o;e<2Hb5KlM6x~krnR-koNtY63RSfG>i}b{!CAEY` zbb;mdJ3=HqH7+VK>S!I7QLTNNa|JBMKAHeDC+{eY?oTOEXg)u?c+zW4l~!yC8OrO*kf%r-_N zq8R|Ss1w!iP-isG)a!6)3n6Y73vn}l<87;_K%my4_;1{Hz(ad`>e zISeW%I87dQ`OUNQSAn<5vGOlMj3OT~iZN&Omgnt=LhXkEAP$!D3`l@3nXmDB+wjXI zx@k~koIS1FT&ynvyq2}utj%(?fL=tK$;Q~K|Lc5Ch_0%xH}y$7AobwJDA|?JA-pz? z8pbnEk$s}V2+P52$mzz8sijMaw4-w)j3!8|DRdvHv;^UZFuxD0wroi^O)f5H=zQ4y z!a^Yby78xLXO`@3NaSrgU}Lu88;P>?V-w|mLJ$9pPw#=N(bIiozsWE#;XkOyu*&1r z4I!O58aPUM(UKe6FaJW<(4>A4D8dt+1G&=JhAMs@Y!7?b49cQaez;BR+V%)|_IZT{ zJiwlzUC+2c6Y_5JdcMX0UMe>_JOjfBg))BE=tbr&70lgnL2&S+qNatQmvdG=o7`C}a^(nn?b@3UK|iKS{YtM+Ha zV1*c$q)6KG8)F2^%T|zY=umjmhRNj4=_a9?Z#3&PbjOaP3)vP4l{QpnT?#7x)DqQE zES}0eI-9LaxrQlR$TAPk7khN^bW(K@^@zf z1LQ{0|NG?ViTH(KCU~5kC6(qWhwv#z1gbAzY#s5E#4&5qkH73VOL>&Pi_=oU0O&?e}^-lKI${EPS&+VCCcC3cW9SJ*ERcewV~Q7hH7rj@PaZA+_} zm(#Fatr<_6v8Pa)UUC$a@$ezLy_9V(KSsjh3FJs_UTix&^;zjof$yzth$D6o_ioVV zvnVTmS$F*0^28{yb&xTiga)T&6Jj|5)zZiE_KoU2N`J z`_}YU*w}0Lk=yq z1PLp_QVI=0`>@HD;!*|{7OfTGmaTqhTD#{(cEI!CThjlKZLxKnwmKD=jB;wEt1n5R zc#q^N4@46?<*Q@2THpH&87juI_UT`u>%y829;iM6@CJ&~#4gxI~UU}&YW zn2yO!Uv-{(PA*E@Hl@z@^ZWjNcy{#s_cIXC_FAMtdWddC$O?>3K5+Z-AB;1RzCvyv zcKYn2&LzWpeeLIQ3hGODPNn!+=n}@a)305pz;15yqGu>_v}=+q`(ijwEQQXVgN(EF zUKNHw2RsGA?RdrV9^9;X~ZV>=QRo*8-(^z$|pcR zGfE1)55t&!x3IL-8@vGsvY`Rogb$ z+PjDP#3VQcW=&{cj8tNxCKH(ERYn6hXVnPz! zJkt>zT13Z46Y^&g#kGXH$7^X9Vc53>nd>BSf3@XrolaORYF4C7-hsEZ4}-YIgd6-> z7Si02&{gZd-OI#k9VezDzYI&UvRL*h9*ngoE(Pv9>dr+k=`5xH3S7iqm{EtPK-Ao@ z@XvM)lfz<3JkQW0VsJjr^s@7?bE8R%p0kr%@8u?V(L_{p3@1)ucvulFcl=l4lVNoi zon>)DXIJ~6zCh8n9}K`Uu7{M$gfGE?|o)2z{ffl<%lLFC8gH0>-eRJjBi_oOr(}N@u0(n6H^&u z?pi0>kdr+HtxL5flU$jQzEH(C@8R?O02qKVMvpRoMWg#c!=I4a$#h078|p-zOATYok zn7D`wzh#%o;C~R_6d{3{3}8GTC_J2mvC$mDYfj6N~QJwY2OR7tMBaN+VVdKSf!c=~9oY-NIZ z{P5C}2H(I~rRjSRwNP*_waYCg#_f_j_6wvScC4UOMV^5A;OhnyvJ(Y4T6G z%o(+2ni>D4$NFO(I7K*rMDJn$aKLAWC+B4X0!W5R=eiZFh-*ck;@WB!4m&L@wOw~r zJPoe_6CO$!2dS_hMHqHLe?g(>c8Yl{v;3p~;g0S5z5OTh1QXntCB(35(=HL`QKplF zK0u_v;xfWv+LB(M37cG+aIYFQ&R^loNgAss3q!!eX#Pjknoypqql~Uf;dqrjqHR-@ zF-EATr|0P8)W5Ss4c$S!QQ!dx-y*rHz9BTMqCNV%Z+Mb*cCm8c_p~6)P^Q+TwEz0F zKZ^5VD#yvXf2pt~h@zg;C7rkJe7je@96MTGGk%p#d6Y$ZNrDx3cv7ts%ViQ&3<8qg|U?(Vc7h)KLya$9Y z{zf;LnJ#4yB)eD8ZTm>jBj+Sx=vKtSr^)-8sVubdB@jC(6ua4aM=_ z9qW%#iVc%1DyJw+l8~cpm?}tBlrXMjYI07Hm}K`;6qQX1aRmPtL%x}FjjlT7BDklr zM>My_oM!k_nFcYl-%~r7gJYb^6)fD^+=#hbf`QN~#)F{&LAhixq^@SMZ0< zCTkisw&u~vU$)10x@#5%%rm9RYgrpm&@RE5az+o26NeGQEzv|2CNyPB;16Cg4HU_# zR@c5evued1>GBupm>64FYAm)RKBSknEk@$qI)e^abm=7s(%&*51 zUN+KwaTC-N)OS;LsNtg8+Gtl+g*LKky0&hz{s4Itz-H#<4$yD{joX+F_E8B)*{_~| z-GHPZnfle=K6=x~n1X({AyHA(G_c=Rt(`j)T-hI_Z`*{99 ztmy@FG@Nu_cp7!B)@th+RTY)nSlmPx3&}p&@AqHZ;tzbC0V}>YTK)f80FtONgrO`# zNw6brmDg0uZ-FtFKM)r&ostS=yI=tFRpFmMPgYOP@*DqJbYCyc!8hb!s}Ti6x*1r#@a zTmt+|)Jnr-%(a~%#M-?%ml`O<;6E7#cVIg##br)CWW@3mMY>HyZH!@>Oj^qWSA}az@@UpGHDW#DVHXbpR&ksJq80c}U!{{Zekud&B?@yw%PRc0B}RX+}F zf`v}Lsjoo$MO@QTLL?u#6oj}dD>d!2RLh@>nptez`4bo(7u!ubwK=jPnY=r-3nSpu zS$AjZiLMrdY_!w~isDh!1Z&kk;(Q!j(#w9q&c>9WPI+#4D3I{l7Dr%4Nx}{#LrT!R zgGW$yEEwgU+Qkw3tXy8*FUBTet~$Ym0cZ&+-)_2IA#r3P6nzIka>{qW=G-D15(0Pz zJ36*D57ltK<$NLLb=yqvE55(wQUqXy&sw|JSQ{o89|@)vo*Vbp;U!p*5r7JUevcZ> zb~OEZPZ1vxG4Tqp$W88}c`{VarEE>Eqm|;>UGx3+8$c0J%9g(CsK5lZI&=JPrj@CN_CC(Ls} zJegk)WYd5tLHOIsG4|BetX6Nx&X~k1{KMWSX;Z!#ZcXk2hMms+Os%jt$sYIm0v5DG z@A0G(So#=&pkTGCZqgpUCO0J%2*e;ar&+{%V}g)p?OI~1zLX_baa7nImYXb~AyRk) zStA`sN!@1KTZ3_2C6t;O>hsiI#_VCqMHDTXR}VqyXy*DQbIGcS+7&Uy`SFcIPcG!2 z)Byg-e<9?V{z^=ZYucK+Fn&^@!xIb3ik7Eu3bwO2czWp4%7sqc*pQWXnO0w5D<$0U*~{v2^9wW5OR~cGK_S+nlpi z&oT}U%8X07KxJMd&E0z{uJm%S)4uu+M_xqwC@Q zfJLJWaW56F68m3r&&OYB$(>U)wLt`-V;6mVe3fHEbu!UHpS^Ck_P6m&sYLp0Bq2H@ zV)?N#v!fQA1XuhzsV)F20N`_Dd$MA2HGKt<7iyeM+lMM{O}Rq6=|T#qO9S_HaGqT@ z*?*zKG9?O%5eM~Cb&DaQx=Kr66IDJH3a|A~AAr5!ho@k@tzRXIbyh`q=Bk@l*_}sT zfCl!=oZ!#uiRazvry9eqUraXs7g2`)Ljw^Tr;nLYQBhZ7pHVWY<%lYIPzqS)SE%7m zdwb#I;(&*cR_M8j9Lfk0{%#zzVdF;4e-1iq-91R6#R}CjPBuQ44pN@~Jan~y2@gm- zPN~S%r@V=}DM2K7rVNit^zUYLhdt*}zTr*Nx0W-YC!9D0uSZ6@X`#^TC7}NeHr=88 zmWJ3g)B>3WB5%)U=UMM}fRo!J;10+&Kg1V#J%>MA? zE_@^xYY8c#ptNPJa)0xT+0^{eahlam+sF}<=*>$LNfFP-YV&$8GoJ79=7{rYgbia5 zY`M&dXL~LocYHR{njo|}>(a}au?NOgJrjxT zzQe1UqMRKR0~L5S{`#ATLbe-%#;JuqxkUH;hRS3$%N?S!%=9oFc2r?M(EGB#iJLvT zlGk8%p%q>0I*m_Cy;TR>uB0Y8ye$YU3gT{ABx~v%Ml$d!RkQpdqx-TWMAKtNbR$7( zK;~TI%cAU&rdS31k{qMr0bVN28N}P8N5S&hEihZn#n}R_5hY0>{O>HCS>p4OH#gTuqvkJm86x5s(G7N5U%Jf=KZ341N+%b8MPFZ#4L%=Qrmg4DwA zmx?zwE)sHqYLmemT|BvQRTu-1APa0G0asbQT+jxd%D0s5?Py8{spozE7-_-S9cTKp zf+K#2(zU+wx|^j_^!C<1m2UjcFEJE+w6xB=kPLG-%^)xinlY0S@qj35OZmZ2RAOav z(m3ezwU9%b>G@^LY`w0wT?H^r1Z8E}`rkm$Jb})bfX6K|ud7FlJ2GJ)!0q7i!|kT( zmrr*ZZlbsSH}g`)E{h8Vm>|l54S;ZvjuUh8a-+W3SjuZCVzQK=cIoWBkP!M#Mc)a8 zO_CjW>xhK;W3gl5$W}ID8yzle1k>aLV#EG+i#DP2(;M4eDE_x^-!$CD`fY}RuM%K$ z*<4~RNRB;R#qKGR-)Pab3x=qOC&WWOP(q-S zDpT3r;#NG3%>vz~4*fShAW07?y5qG|=sBazBy&_cGb|OI;m!&SIMR9R=;O?Kv z9j)w_axq9QnMci@wVDp&>hS+Bi6|Lc=;8YF$Wf{YneXRf8-42-PO&FV)Sx^RGjWx7 zWbj&xA%?k$JA&8=KfW^u%wK1&@a4@CmWAr_#2AynXbH8BSbdccu_<~NYJcR*}Nj|)M+h`n%kY{Ek z(@+#T*F6YVSsskJlW(@!_jUb`Yg_E}#n7YEScx(jK#Rys^IZN1+_p;wtIl6G)7K<{|HGw}+wG+ipO1wxcssL5q|Jo!k5>o$)EkHS;g zIg`CoC&VZjY%HRvYmW+zF6to7d0!))N1xbt%A)Bg*5b5Hn_F5fT-+q*femtO-@aq8 zjK4k2ztN^o>L-0f9zBw;mZ(Wu~5@^oh|Rb6nsO=SWe44wjNA&q`D$}gI!;NdiT~0ulGoe z70?D;1I^@e+Yxntb?sB%`oS(d&5qwkBkSZ7Z@_r^Euec)7LhF8`=&Dr7jfkHavGcCsxQ}(HFX0Js9 zIdK1(=+lozavJy|r4p7ip%*?!!BcZlbg(f<6w%pslG4+7_p{W3b+R`~`@q#rt(liC5@czKDhb?&t2Np#|Id$uSDQ~PP*5OeQ!JKcXyP!T~vEEP+W9`Cl26C^!k z^sS*S?-;ePN;)-Z>IvyM?#$Y=gUrS2c$7cdfwFDJaQL3*+dy#0+*tJpTuO z^+4k019j@!x!9mw9;5u{gpeUlGmxRoDQk)#Vum}Zt@HsWp0GfPzA5z|oW2!`lVD9Q zhxqIs+4QmI@w++!iQ=Zt=gz4q9x}DoB45_2l^PmYRM%SIYns3T>mJ4Qd$`}$v#|3x5Qc1k0@X-1~y~k&YKn7&=Nz1Pb~NWA*8FqRqKU|rKqRh z;4pF)SKUol;8Dkly#F`g0-el}MHYB@d7nkt?)#8PXy})+WQ{*Ak2U)*Tg4{E1f6z3 zRggqS6)U;e`pc3-h{lCd#KcNybiP#v@Sa(m(IBXOMG-v3nRT7dc~yx#^2rlz)koSQ!oZ7FK82`! zL-b;)^S0$;c^@ga5AVOXkc;P)Nv<%QWUk{3Y&yrLX`e6WyS7iVa_@V|{9#%1H4o>n zLM2Tp1X{dC(bQA{P!o2rE*q364AOfMf=00f92F!VXe*ij8~aDmgW1p_Az{W-FzTWr zwuj8FMsP`TEl&Gc{_FsW{g*eU&gnKpdo)S&>xSN-H}m#pD@#jT$HwWYQnTj?w)KyS z?W!altq5#haLLG1#Pqu@!AP7a3ghdfH#6}2T!np}s$hws%j413r0Zc%hbKvsr9xMm zqP9XRe3U=3Fs z#`bf6e>2aYJF_!8$$g(U&bhAFMVKI>`*h_3i|L2={grEQl)6MVtx^nM%$y+)mtrU7 zr+9%-+0FWlcou#<&VV~lc!Vh{jKac5e__3C_&6eAMJ0WG>Q7!PF>H7Fq|i?$Bp@Lo zVi2RXfLK#M9?QJQWJa3!;nXSm_xitYl5i9PcA=O))PY?_?OQYL`MjKR6ev$nB}mQ8 zJ~s-5Uuey?Ovyk+Zs{L8Ji|MH*MCj-yhyTiMgj<9 zUVnyU#qq6m{cIJ`_^a0P83CQT9Os*P-BWqOh&-``e7#&YhH|29%uXoD7jlgIfAOhJ zgsj0e7M$5C%DIz7u3y&MAA#Hu{*~LL7N!yls@wAIZO6X3K8y+uxeW(fl-<-^TE~`} zyt8lnQrcNd89>Nq60S@ZpJz`U?!@E6+b5FqbNBZ%VxV;%vPM>r`Xrh@d9xz~W&uZy zxlEk7nYu1I@r8$OJw2)Kw<^U5ablte;lZ+V$_V=i`yiQ2lyEC2aAQ^)%!4v-#N)bE z7ZO9m`m-EvG;LDG5Y%xIvjlzneOkBPOmfZ%Nk6?w;hY?uHcS;_vL0yq!$ z<5I0S(G`_O1;~N}NfZXL$>~ekQxX}e+(4R9V-gwAulY{yfRI~ zoJF!SLDbhQnYAjr)K^1;bor}*vaMg~g~ofqfr|*(=-_Y3(IgJypcXvH^d;qCO10w( zau|-q*M*Wj5eM$wizA-(0L3RIfo`j!|L4K|Og_j12!qAZsi%(7yli+=Un51N~>FRlD}@VQXLk5T5(J`b-Eo%qCzIELc=?WrYk1wSxt24*mXVlXeY|4%FLulaQWi4Z_Lp{^+0LPEdo#WmrnM$|2O8Q83p5-PaSy?5|4LXMH1s^$FV zTI!8g?Xau4^llx#(hI>}IwA>Ru2@)I;*f|ZJS0(K-dVKyNwFcEe`FHZh0`P%tPP#k z+CHF6&Gg56(Q3x=`ooM8z~k)(a`Qqm+}*`&z#x)KOSEK6C#6^O(ATZ5eJ)C;`rJcH z6X}CDQTjJVt`tm*m~n5a&e=0`5?5~z|A}cm0Wumt?k!t<9`i=MOIa}9DLKp=ku{n; zIMP5Zb4`CKX4-5YQ_J_`YQMmHu8}chN7$Uf;;JlOxJp^b5RVv2`!}iMe32xIC@QkL z3E>0EogN|=nEq0TS2`_g3IUtnWCKGjhyCM|leoOgcqG`HCM$Ht@6-hf5EEZ8D0Yt; z`GM$O@o!grPy)t^Sg2p_dHj{QcKRy|iwkkCLUzD(f|mSfI2Ld9?$dGbl6Bwqe$uaw z*C=4NUb@8Kr_y(yr%KM`NmCLXdiASr{R$Waqw`|Hrk^G?0haK!pRn!Ijej0^viQ7v z02Ov~OUwSFQ)(u!~eqw>7kigypiw&c=uuU2o ze~oruLtFtPM-tQsT9T@C#)`7S*g8hhuyGZ2>7V7b%j zHh3_xS`^Tg;!kvzx?OJD^gC?6K>;q}))$|rBN{-r3FLm>|BL#P)`-m@Pq{=?$k}ci zr=rB(ke0tjDD=qYFC}*AP8VZ}6y{#+naAjVl zO&0%qIKv3{*}ZdseTS*b@qb^W2YbVrUueRN83_Z*la=#_>bSA1RcI`n&xmGD+sh^5 z6o-~1nchQ%2JsvYBCON{+2I8SEjBhLu5a07VvESQEl8K&t%YtL9}-*qL4_{TToabE z=48nDpU^qCRuThr)7{goS5C3?GbVW~H?a1^yG}%(Pm|e%es6QMAf5bj()x=_vhR>%j_F+fR+# zgpZx4evmqk?}{nLMaqS0WfCSlg67p5In6T@#+Q>|$Z_0)k*JURkny?(2l0_Tyh@SH z5@qp6cF2n{Qz)VURM;|p;_H!a8pHQs`C7g>je%yR2Sv3=SM=|9yAG!M*s~G%zq6)X z`9W^-c2I|=LMw%07DI<#mTA|b3HF5!;Qx(NFTje#UwNXWpI@@hjRLgd3S);=A~1l} zWW2TGaGRK`B}*nC?2UX0T#P2%N*; zybhJ5mmBEU6quC$>U}JOU;$zSX8iA%maIjNzb{O%VEg-ub{1!*?Mhj#RBrbR@%Y2GIsp#)B_GM=a?^Q+AHJHN4vWdG|709gjzWyJYm@HHpGVtc7Am& z2N7Fu^;Rzv${QsWY+^ryDFt1G<*DPP2Q4$7Vp(P2|HvS+V4lc?F~byGfTX_};f2x< z3a#Lg#XluD#gy9HFuKFk<6V%W*9X%gFn_Qs6i#dS$PWYg5+9tNf6v*TjrP$EmKx$u zwy^I-T!=q5i!j3jik|+RTDi7Vhe0%M6HEsCC36F6AWmpma3OCBR$o$`l5CxbM#26# zti4rHLTcB`JnKQelAt29(g?3L@ff&-JpFZq)m_LNj(sd_=aN*5hJJe>OT{C`yiVIq zPDrrcxgtm2{1)kjmaPtr_BoDTqnIVnh8LwZ(@pTJfaCktryt5c`e-d9j|Qt04@pat zYZAM?R-8*a}D-Gl~r1Lx^c;{?M}|?Gxhv= zgen{i;q(Rdq&mwe*8mIxxy_ZN*52jZs#kE z`n0RiKMFrq=**i)KHse{p09W8IrE{t{5Lh_N)voWOQ^T1cgF@W1sS8dF02`0Ue~bG)R}f#TaIu27ca8S) zraJ5N_2oXZK6!1iXd@b2DdWaO_W~SCFVg9;nfWh0Q_I>bIdi_5E9*(-QNOqJAqUb9pRd#JB*pKvGr zu9qI>Ee^JzyJNY5q0!7N$;6uZ?0skG)oqFy{n5>2;>W&N@yt1WsEUqE##4O4Qgaww zIYyqXY`8!!_Wh6>c9_*${){nw+T*6gRsIf1umJK#t~xAwvKQ+!jDT}5Wsvi@QPX60 z<79xK&HvW|sG3P_pw`PlS#AJDf-_$ALp}oxkY+w&QIwFo5Z*y@7*&J?`>lQ-FQ0(O z`+v>};5A;@@cN(S?fZ9E24<#|Ffb94|^Vc-hAFdc9o${Kqn?u3)SAq~K|9nRIz?=p?3B zqPY>joRew0dk**4Ngid>v`tU(1qZ%Ut8|wcCS_A&UWg~6~SI!${2dkSby zwcY>=%E4XKm~83tm#CsoMe+G8IL(9c4dFLG27Y#88%b(y_e+{1l#i!q)ON3yGo>bD zSLwf^eg#T-(H6foiD9O`xxhxAec)5{{r%`ZTZhjh$J-;@{xvo=GvzlpszPz*T4NhV zxfM{hhH67haGA)*)$rQw?W?q3ozGD-C3~~ZwwyZp?N5M-DtY67RC~g=2wg&SuTY1n z=h)o%ZeR0A+hJ*1l$}FBE(M*V z`qxVRHHGU&6QR$#g~1=2CWv>`@E5t#AFgiNIFjMq+o2=jQzE+j}+o`0CsQVAim4$Y1zXN6I(Z|6kJ~ekxAp#!);jnpX zeQ`aN_|U?|I9toarwRtfTKA+KJ42!Z4)lz8%m_@|HaYC%8gZPo8bONZg5Ol(;L*_O zp%73eo+wpe94n1D9H&&V%E{Ov%##WxhPdgF%Dr;qtlQbOIsDB*LJxYJtX6i2J4kHo z2`2v9YVs^26q{Pu?;@VN>6}zrS}*0PQFxMMeWyQ`Z)C8%fB_+#9BLWV7>g!RI|>K+ znD335Aqkma6yT2Ju#;JEwaUX#^i89HBjKh`B z2cHSPv(^vn(jgRcO%pGeYRTJwFzZ#+F%9ogN6IWbB{06hBUU+~+kO>Vku-na@dzN~ z9}jbCEj8EG)2;sd*U;T*;2M|N?dqn4^buF)cnK+fFA$EY=aAnGt_16NIm$@(hcbz! zJTf4S2QqIi{Q6#Kk?QkJGw3@TPcGJ-e!F)Aisq4c8il_d9s5T!MZh~g5=IsF;h0Z? zj3!6L$@tJyHAA~yntt8+Nfl&V5xj}l61-z1kG$Y z7xU>o1_O>5NE*mj9nx;0wAc3ZrT|<}v+nHk+4PY@O`^|rqI5uNPd{_GiT<`EQBJzI z=P*!ly5H~vA#-7bMxbjnLvOG3>UCp#FrhF=`2>8!UfEbh~&zTbO8RX0UeZSoHTl0I#OdyH)U~B;@%k zWT9|JhE7?qejfUH%8%qjc^DdvA|gZ=F&C`sr-5SgQQNa6zw!!7idq6B)cnoBGNLzs z*gcf6@^=O6qc@Cl6bg~I4Pr!srsczrehO_lNd3Zrx0uOe_$NX&H(eUxH&l$xVj0A6 z*eDWck3dWl)~JeXf^}30Pe!$4c0fp9x8JrUYd#H3?W5^p)ge;W=n@-EKyXyH!|&fx zYRRm8UJ7V=-*Z3cgffO9K}X{`>O{2*>CF zVpK?`WI#IdkAl6tCtKPC44J@!|AWb6z-Q4XPy8bmqR-hEHWYjJ=d(JPan&P9^|Bdoj_?%wl! z$++T|l^tn#E+@=H3IFu(*S)`It@@_Z@kMrDT%G|-NbHg=pv2y~yNmh`v_@8bb?%*Q zAvdOuK#OQ=U3*!A135xhzYll&?Ej7Y!F)Lq|9ATS8Q^oo&KwP1PC8oa2o#`}FW3mN zMQzufKLaT;zev_E)?7C(qu(E*+kCELVqd1QpAYNYD1V3p1kWuYq$OPsK4{-?=H@g9E!IMkYrz#|gx$kU#e=-j1fhmfZp&UhdBqU8iHg z-%;;hn%?gW9)a;oMRO927DOe9^FpgNtRQ~{22YWD(l`W*XGL!O*l_axJqEy>@jitS->eDh~Ue`i1&d-_Ej+1MsY5s4jSyIhi z;+sFMVqiW~-d}^A+p@1r*V_H6pfGx}eoCfUTHF9egoHTxK3EAWp~N_Fa@;WP0RAUN zb955~Qe(CJgt^ZJQu$mEk={VkT=i}hy6FDAdff6R<-n4@#}7J*s=ujFRZS+7_>3_U zW#8(#P|J2d#_B~le}Yd8T3SjFbN(2&f^~*JN*Bo5$ zyIxPeoRO?MI(d(H0I`(XtWTsAv1oK)u&U?xT#>FtF!}WEUOU6+L|(zE%YaXl$#AX# z9Zwq}_g4k4rN?>`G`2F@ ztvLK{h#hB?6PZEDIvq)3&K3xT*kl|kNMs54?(ZE@%q$v#A?%-Z5W}g&(Eo!gu8#>> zVHeULq)DVqf^ZG|uw)mf93tDFIuISj48kLdCtPaxB5Rg!X~)tUkI=Prd-92PLa|Yp zl^faoJb!}Sw6LJNrdzkl@b`aI{SB{y*6g>Q5TH$bb=B+8i3tjJ5XvBZ%P)ng7TFx`lEt77kW#xv1kz;VYy-PtYJ1f)-7wb}-k&|jMe0KoRNv8_$A zEpQ5_0CQPenL2=%=8=XK>p>cyJ36~O=^$7=43Ahkf)yA&cu6;34?XXpS+*wKT4&a% zOYKg?n=Zx=PGq^cznHp0`;@9C6L>a=j#s@y`N>3w{_xb@Fl_&VS4w(>VqFIc%Pw&~ z4>_;T>5gt`zptS@EO@-OnADJ0pQA1rs%{pBE!m2P#^p_oTDJ+>3`ywUc^WJC+Wui} zG;L^x(3Y=K4l6EDsV^X%qF2E9DyIR-5t1N9YdPWkdUUhy$G~gD2n0LER~A-}qo3g) z!LgYVVAfjtaWM}Tdu% z0gj9XBg~gvU0f(jmfr!9(Sd_GnXn-@%>efRcWPCA){r;9ZADE!WyBiu8HM+TxkB73 zT0d<$28^r~hnZ4NoYC|W5$A6=Ls!1(yH7j2TwitW29g?2E(I{id{NUHrfrY$bAa%M zZ06>cj)SNDs3zd?J2n_~XsV3u|Mz!j#teHRCDH7xI(f=Gt~$RKOVdItSvEe;Mj<1L zw{hiw?=$aow)~P4mJ=k8Hu_1QRiT{mZ>R6rxz9bX&-?R+ldCI@UUlqf(ykDp);}8? zrY#ErNv|^>U&?~sTXQ)hByT|$XGZ2|g@4&i#eCCi{O$H`?qp!hDegF2b2X(|d{Mf6 zIh#IaOvt~^glPcD4JdJe*-a9sjB4Em16{BcaC87bZFURW0Hvq?rU+NR1Dr4q(7u5J zEzBC*wLx<*GA4p8p=@@8*P+942u7HkW%GFt5xfZTeWTIO61*Px-_pL|`^fxq()qFh z_Lf-q{ZJ?CCGaB%{kzLUO;NSI0j;bOrbw@ZqJEyEkiiCOa=YHbEyl>?C=6Tu#t7V? z_GCB!$wC$MnrL+ubl@Ql6Rth(`$&2`gvU3-f*}$&F*oQY`z?`oCTh=GN(-xp?^-F4 z;&HOBA42c0&`CYmQXYflqT$Iibx*9OrJNYV@Ynz;Egzf+h|jchPCnbSUB?-$1aFoS z>05&Lh(anGR!wM^RHTY_otEe~%J|?#nF?30PGX(DYX(+-@PLx1^P6DIfr zyV%kh%r-6s&4x*8wYBl#z1Pc2Y9n!%W@Y6st9=eKxSR7asLpYVdAnwfR!0zv<6?&) z5;)WRFbZ$?W6}-3Qu@uSq;fFiXDGbUeTD38Z6Va`2Qv(uoS%FSw;so5|6%G;{Tl^)=|2fOT$iq!6Oiqvr(hl$ zQWrf}{A)NtDU?owI+%N|L^qukNAtCe|o{;mRrvPeNiN ztR63i-lo!^ef#V#iv)N80JlcxOuroiOM-LjxUDTnR84Aq^v!M8p09R=_~GU;R%K=S zmLK7-He;&zz};ie>rdwVb3Cj2FF=PA!uwUy>SI2dRDVuQ9EBVw=Ub7-Zb)^ z8)QKJ2XO4JccKOL?~1OfljfHW$#JuLbnE67ld)ra(Y`b@2cxGaKdEWOB=rC07Z3x_ zaetD|Yk)>?BNFthS1!4a&Ey?8^K6!d*Xo)?VoeuLEO8E^h+8<`E;w(*yg#>jlHsOa z{Eqyu5sgYSbQ=AU=*!RR@iEKSx%{81g=3O_A95aVr)hoXpnGR$1d13M96v>iJML-?Z@GO9zI??#ugnAtH>v}c678%$_2d_90vR4 zl2nWT=O~Szfw_k+ef_W(d#WzZG4zMduK!Xa*}8yM+BvTBl!$Y;jc>HHWk@PusneJN zD>zq>d4#HrQrxPcfgUcg`9*hKZo0&h%0MuffhQ(b*B(<;xYUq=JCdUHS+C9`QZSTU5&di;alI{G^shG~5BMo?fvb2&R#WdFPK& zS1VomU(u(3-d!|7oK(wrA}OImaS4UAHuLE=X9j{7D;sY~8dYan4EwWkV_u-VN^?Ub zGAi){DW1VkcV5EOC6nY~Q@rpatkefN=Xjs-86}hCsCG9=g^iwHlY9=D^mbXI{z|np zmX?DsT@_aw^1gmuo@*;xitmEiILp6Y`^QVp? z1{qy@+4UKPD0dZy`zPck*L$z~*Iy5BAtVnc+3!8A**@EAtt3Y%%=LN`heUSFp)Zd` z%(@$^HO(Dn9n00ry6{^R!zteO`sAfQ@=L9s8~|5>0#f|WSo*J&vHhFZKO8v9#tpj4 zIIJG(Jf8b)n>Ue+Ec)Wo@#)20bPyB_p3tr4bM0_QFKn3eWdA1O$l-W+f8Z2C8OPTn z+TdJ@&k}0bSOq!v&)qfl+fD>UVLox>LZkJNX?87Adz@ok7miC=VRhVw1&xys@M7dt zf>@Z+K@`om_=GrYQT2kXgDH#J!K%k6HPmF^hgU&_8LRotm)-;B?8lYo&da?S+*0kI ze-92U_OH2J?_FP*QGY#beeV=IdJph@zmA@j>vQBdxP^YYuR4D$@_qWmykgOoU5p@B z8{XFfU<0md-+Obtw>|10T6mlb$YkNP=Rlm^qjltP+|HC(QaZQm%BKMpg@s$)4O=%i zH#sewjAaTlEeEcQhnGi05cM$RqZy@{5@O@CuGFcEXTm@Iqi6lEoN972ql>njn*4d^ z^4u_`xc|T$l*`IDEfcoeh0gK-K){};&szvPPcW0}1fQEJ&T{@UhB zB(_}thpNUpd>rLxCD)P!Q>;T`^-Nbe3_@F5KSuflrf$5nR7i$_(ikpq%On1^?gL$E z+W4QRVZXU$C@8$RS-vQ0YKUxV^y8Q)_j(Pr)2J?q548eW%$;-fh=@1cG5@kRyRQNi%%bMMn6p@8?kQl&6k%{BrHkSG{S>y(hv_-Wu)8H)zxo%QPzD>}NvIcP z0g5@j@yW&>TmTRax!)I|aMeGAJEpu3n6}|8o{9Da0IH|aZOu=*!DbGnsjdt=637>E&AahA~>Op@WPX6<2$3%4aeejEMCjy1+(E4S=Lq-zH0lqoZKC_?O_NcXChsW%uK%IXbhNbrW`wxf zpMQPbp!)zdWJN=DEG{}b>+mV8&w6a^lw-r|Iyj{1m)q?V_V=pF$CpR8iEM#M5>%pA z%=7iv-t4y<3F)%GE&6PqB?OWGl3sPX5NNs5gtv4z5AK>;bu5pjG7@|x$+icAg(Z~K z!OZ->^&Fhqsl_H-S}oE(H!}N&;F>4z9c24%?}T(ZSnHG)Qd{*s-=9mttCt~f_}+U9 zR5J|B_yL+HRE*3P+Jy&1BR5DTy()dGt|1<;d=chAJOkk4nT;g+`Flojj!i0wuvbh6 z?}t|Cc^5ag=&JixhO+qI!2rtHujjb9$>;7!IC1|v1iYVmS&#s-iM_XXkZGah+3=Aw z)tKN~Z#!Kt(;m#p53Rd*8?Xg3>vZeN30tI-y$(pI%*T zDE*hg_0!n*w#U2wP1&0mG;Hc?L`e=?mFVRT@QY$qJRyWn|A-|WXF}pOF^hJhl8cy= z*MiY`*-y8+9GdcYv+~O>!g5cT&)3)^k>pXRNcdj0{OuS3%>Om1W#+&uO-U57LS)hwxug|I*+5wgnRD~t#SoKQ}^hwpm$X z<)GwCO)WL8E|$s6C?va)Ln4xQ^OE$>3Ftq5X@!5_?0<3JYhv}GYFer5<$7mG3oIpX zp-%zwJ1*7{zX}SgeIBALMULdevkL=lWrU<~aSas%ct>5mp}@Vl*Kc1ty*}&;lv;2| zTTy@CXUOyK$>PPxL?vXQ)^DRdINN*wr7mbN;0W(^>P#vV?Bnp~h1KbVDCote!v{D& zP562;I}QLLQ(840?tMB3+_#^^t$v=LH@A0eovt(){~`ROjos$sHUiy2^y@u6WxTI4 zsMD_c5X2}AyzGyH?^W-zt)Axpbl$GceYdYefNgfnre*5#@iM4175L(%%80?+>jY(i zrX8oH9ry1~baa)!&M0m2Rb|H=xK3&5@nN~YUmnj9i&=4Hx$p_LUjX4FqapVs@aW}q zk3eq4noBfiu!p)-OGY*qkjTSbCX*DwZKic`^GLBnS;+W(D5LR&5~hS6VIElWhZa(fkAze_Y4lu$2DzETdCn*AUL4&Y-s&{nL5lTA^DEjZH4I}rS zo|0NyJu^^=qG-w+u!2-;fQ9}3TyS$$R46UNDtArL5cs)&)fz3`f zLZZ}@Oq}_{UDzrxAK$x2;RAnJ$#HNYw~R5xa6-Zuc+MK&^qSYKRs$1)t+DT`tL>1i ziJHd$`NAash4AYM>h3OF@r#*{Ar)-duVS`Sh(*t(4O`Ra^{HUxvZU?uhnz;OUCR_= z;L=hq&Fp2@kUYzhqiNYtg3|wYqu;(g`R?@&1*!*VI-U@!kEqEr%(^2{TctoQ5Ru}Y zy#Z*!Gb*59yq>5py1OzgF7=M_%hgvgpWed#+nGkyJ}^WlRPNn8`tFS~66i~gl?Ya^nhPhnPvVxaFg?)8LJLCQlZ zi_89jM$Ud6C!oF$Cf~vxsXzSOkyMd+%60l!50mTgyh*nl7uZiQR+HFwH)lR}deQ`# z^e$h2`3?-+3(6$lF9=>gUegG8KL8nZ7I;xN_&bi)3Zp0Za%>|drEIzYP*l1e;MP2joXwQwSb9~*y zzHC&?!XqiSMCz_!q8KwelP`5p-{a;qmix^c3FpM##JK<{DlYu~_%3b9OMHPx7F0yb zFy;k)dcu}UZnM27ijEc$w!Z#NXr(60qpz~QYVRE0cWasgG7q856a2!q3M4GW^`aDPUg0h+KCSkckh zQgl-djOk_H5|o#?eOka7NeddI2W)pCpMcGcQhbQ710ZaTc|_KxHQI1zYIABVtsiP!7Y&^kERb4K+G3dI*nj6Jzs3##P-dp( z_8k&*(5Tbm{z`HX7jS*xO*51H7yAb1HoOP!}u z7)rJh&IV^KVbV%(Y25g8Eb@rH3@yEy7WXk@C#dWH^73A?-!MbgqE1H;Nql`KiYBt% zygc^Zc&2_6w-#CC|HoKdN_~AVoe>XyHp-w4kGu7tI1iDwXZ``(Hq2{+9q)-rzM_^*6IpfttX)l3WF%UDY1iS8T9Uj8lfn=T62>ELQ4 zruX{c^kw2Tt;*om-u?bEtd@ZmA;5PPlHEvK05=4w`G?A1Y@zIB+9_DO_7!*yS6X=! z=oN>74}cdY`{*eanoC7B_I$5nY%4_Qby&R@Tv{)>|1UcB@KY%smrL5%DL)`_{3O`E zae4FNU&A(^9tmTnh8(S6z*YaL2pYTR*uDQ0)$)_;H$~AI#keN`2I^(!acSibQ5o2B z8$NR=E=90I3|3lQG+R@guPdMRH^RtTVnIr296UQk=NSCq!I@sOY%583)#kl5k}MG? z4VbMftM-KB|J*II%ApiAz_^(8D`}}Q;L4QOAbEdNo`-%AL{d$xUtrb#mNIcb?mIT( zGF3|`5)Lq8GEJJbYu4f3UfuW%!~Lgc^Ra65Lhd14Qc8E!K!PHnoMf!SRSG2EYM&wL z8<^4U^&(iK>T7X$T1Rqad392crhjt2gdO|uIs5mgERFlBR1T*oyKgn^J8;}X)u(-@ z>!Y~I=~SlVwm_n{3ykTM2cIpxPfM`{ICz>sT#&_uMw^**`mWl7;PdKk;LRoz0JGch|Bc>bL zbJP>YOOn`qQv^m58Zusy860<5uzgTS_^#y zf))~<14BU{gJz}l{^Vhhrm!8A(f`mC8y5iQt-fokEGqL^&_UEhib&!A9LuVq%@s>t zRA@3?EtXbeN9+->aeoZAa?Ur1kw_T6SVr2sJ!_jp#huw@UJ9`I^8R=`Qt(cN%=LUf zzF2JVRr)x&JFbAqJZ0GNAI~bgGEPzp1H1~vch!L_68yML@Fj%*4lMukMXPRq zB$=3*nb_`om_eU|BxZerWa8(xx(N(Asem zDIo1ghQb#hK}kUs!^2w`5K@D-2+I0=G6EUB1#*l*{1c6Z?+gpyY_*I>{Iwbk+m{u; zQ`vcLIuDz$ew+T+(ZqoBZR#SL!pyyQInJ<+uRapoli@_kzO$<}i=2KN+`3Q&V2A#% zf3rX4I%*zaEBfyuFXbyhsDpA1!odrd;Qs!hn&yJ%wseY@VZzNV6x!aO(k4rMxSZs0 z*r)ZA9UR-pJMBv2vVyDZh}B=KJN6+cJgerM`^@$6vpV4PD>O1r^AgY+l|6Ky^2}rvy&gg+hePU}6WY(EG8u%YUU^ z%t&5vfI{)FY-?|4XdTdJg&3)~Hv=~k?-|B#$@@d2@QCKgP0wRsVYFF8cRzennrGsA zdZT=f7GZfmwaPwkRYrN0eJO*#bUWMXrL^$(=8Wov$x!t?en)MMI!q$xxP-ScPZ>Bzeky0DBrL z5;4i0a}Ei|!grOv{74kpJ%hT|cg+#CL)F6z6OD{Nv`Ygak<#{}pk=IHNnlAM>ZPu# zr4N-xZ`hxW9@O)?s|7lHu)f`$T*=8d!y?LDG~1D;&2ZMH{?rK7*OIb&nr773Fz;_d zk9$#jWi#)B#S>;V9V6WP1ZtLW!NpjG+ME5cXhhH$JQ~GPbKrm`)RNWmGlkhAL!RHR zDbEULG1u{V+TWpc)8-}HSGeCo-Zzd1YK!I%BU~(4Vo&k zif&)%Xl9WE23qro7MYahoNyvIcrXhlWSbzg#p(P0d?o3@3&2%Mli{cZ({ANzZv@v} z5(~E9T7EzsgFr76Hz2JrRfQl7RbY=+mEc)45Mw+Q_Y()hyf7A{8*=_4{?4v0sAlMVUhVbMua2K2D} z+6N$$mlykhb=<$v=JCo(Mm4tVgacuMU96soMSDA7K-W~$CTv{=KSCL355SbCVx+{F z4TTAz{d?j603`R0|> zU6kyqo>$Qly30q$9ehWd2c^vQNZwTs7z~TVVerL3Qi1bxz=MI&!a3Ae(O@Ny;9FpOG{_Ja55SRaS?_|ZXF_65OxX#!e!DB zZ_&s?Nlu4v%rMyqp(CJPP$>zA)ML%V$@jV^WY(-Qzza;f5MTF!A4Txw%#@@?nM29g zWn;+2^y*42Mm5sCj%DWTEB{mGp{R_A*iu@F<7KbgBls>KgJEW+v^>p@INM-!^`YXM z!^N`l#aDZ!h%s}utO%JiS7+cvk#xt-VlYZOqD^$5H*mkf%;eCta*9|q^Wh*vQY;ey za$xuys{b!t&Y?UR16F5&Ew~PWw)Jsf2n7B_7CyW?>f*Sh*u3`3sx-I|gZTZ(E$(Nj zb+vl+=D31tU3fv_YC;0vj}2*9JnC|g^C@TpFKf;?@?Ic5k;-jEQ%nV$>pLitqG%`U z)CJIsgWFTqb(6eZ^}fZ~=cO#L`4#Phh5=o^W`#PiL*bloXt=trw)@0%RTQE>{em-| zCw!{<;&@lffP>glxnmFHY`lO`Yt!+b;NuGGIW*F30C<66!|JBq=E#9Wzm%5@07|Mx z1|eCh<*>xC{}7zY@(A|nwPtK>XARlO4N`EeROOc7mOL9^$L`$(5tJ)osVBV$aV&~# z=1Ipw*L4eBz7*!>oks;)^%7kA*Cx}zz5uJaQm%#sqd>US@rGgz? zSUUN*p_PPfnlZd9DrE&W!xIng7&EdbD8ne?WU&-e8xHVTA4{EMvnAX1hXB*A?YlQ@ zwYr?Niifc`p%oV*c>tqTv-Wd|L>|aq?N=G$g8MfU$q%9&hQtU7##lygmrr9@_j|OH z_XELUVeHgNU0lfI3RQ&Q27DP)ssdIw5qptHCWK?{KQ$sK4)v!}rqB5Q**G@FaXm6} z9`J=}tA?V%gDkD{B*~;lCEh&M5gR)h%t+XycFgj>81Q18^G}7m_z;d?(j<=-8~oGv zsaUA;_?zPR8N@1w4^I-$K!UBwh^PpgP%w^4E^Ln_CBsonby3W~h!=bFxS79)3Nl%C zN|HkQSTs7CJp`-7ubRj(%bwD+X%gJ!Vf5z+LK+ho$SXd3*awaMcw3%JYfb)DhX5P| zDW*k;wI^U)cGJRff%$HRTcP^Z0=Ze;(GsU|a80I5)2Rf(*2-%Cv&uN-Hn%is%GjL5 zjN~&vr#lfOGXKMVKp9I?E&E@qKrE}$a4aIjltRBpFL5m#Bok&fr!uxH@t&UH()_Ci zuwxuietbG$e)e+rNLX@YtTVI8Up{%#cfquvbJS9{^b8xt4i^$unF~Zal&4XKvoza% zC1}YgQQ1p55k-*anY1$frvQeAS^dGHdS!u0KKd--q96JNu<(U|;2CCb+tHE-Vms`p z_^gP;Y+1Oe4?bwMDf}eQ@2xGN>MSTNDZ@{1J85a@0LI8sdmfP$))@2~FT1-VS&b(! zs$A()qvo>XPCN}>Pd8zxBmr;GQWPa;eAfZHX2ThQa?!`RDkDzNmy1}do9E>|om82yG-tCCEM{DFl!{&}{ zYv-Gt!LhC0E$3}#Kraj=bn<5lzK;65`=8Uqebfo>8PSwe!j@!8BaH%cjN-8MTghKw zdT_o@RASd}q{>_^l^XFBGmxasP^Es-T01JY@!( zoG7Z%tmAmo00Rb6z+$-0oeY=ou~m}H-oQetrm&*!Zz<)r2{k$oPx$ePW}VX~8vMHD zRu>LE&BC&Bl7#wNCBrJi-MVIEhiJa?%ItqsDf+RRp|N+9L8Q%-pq%l*EwoxXTC==Z z2GM~STKK=D*zJf>XtglRgV0A=d>3IuZ#wFJsSa~llyhg4gCX-mT5;KP&U>@i~&sTI&FP){{c<-c^-*=Z5`b!0${Q@R^F{SwzIPn^s;)-Kaj^#Pf2Rir498G z7~u9bsKc;2Q*nEooFhi?b@~4;YQPu6hAGMwBg{k?a&>1XI%kOrLTqKpz1SGRi@&y;#|@` zSbF078X#zDUs6;<9`ow~-k+|! zuQd2U?Y7zY66j>AW@ERv#8p25Oz%EN`WW&L-de%0eThysbOW*FNXafPj-%Bdi z0{AvZFuh${xW-JvEo;z*zI`~(aP$~wRQ_nLwp)WLdXC?MX|jN^N{RT3;)BmmqUyxm znR}?@#&33DEd86O2WU;SS$8h5{+MD?+9uCgPmY3bu} zQil;K9jisAU(tn;3WY;N>Eg#Egmb(IFg_GefCe3vGNaYJIpL+0^Eq(>b`1u0DboW6 zcL!`)MH3h_r71%hsDnV*Qtx|T{zq~;_dM3Cn&9s{|vbvoG} zF|{x)7XOI~AHkbZT$wi48@&;qXAu!lHe;YNi{yWr7bYkLal1;1Tka+svD=~-Q5}(* z*tF$)DX0b49X2V{Eu*?lJE5-frd{KRQ9sgki9}0lAzBQYzvj!;3DcIqkOcG{Th1bY zdk%5!=pyjc0)Im`GfJtIw(Rr;((dvS%$v0paex{c0iZ~|2Lm+vE}o#SJ$_j&EZcd& zgnp-UcCOEsT}1|;__vh4v}HKo7Cuczv|sAuX}B^15EM0d4@7snAPzjY7N|25jy1QWzhH~hkyFpSK1nKS$>8>H9k?uyi8!2h&XaAnH{vTjo z&0c%o_jR4;aZvxvRNP1M&g^zUclCfcarY1q_%>+Y{Mt~6hzF+#Ts~so`B3uyb=6UE>PN?tP0xW zsrw^L9CL*a?$DocwDq!}4Ek9a-`}E%P>&_%lz%AVMpN*ao)OO)fg7{l^7YJz^fdNx zb)74AN@bA~wNcU!^B7qo?Rp3Q1*SKrl@d^EnhGj*5ZUZ(Z>i`9Q6YnvAs4@;3{(ND zk|Ze_3X7(9>3BYGFa}=8hc^(Tob8R4z1j$=fZ(W`m%+Ztg7B>O5Vybhz33algI$B> z5y;7$K8=kQ!ZyismNF(8?fCa2h5p<`w*|i}Pi?xRKby-@$hz3n8qeJMbGiA)kOx{j zO}#1)*M|X7Dwy_8xeO$a7cY)Lv)3BN5RaGV6CRUO3&xzn3LZ5=-+vbbKU2Z)N$+tO zFs!ET6@^QG8|OQ!D6xDOgu5aTNHJ6x0ahv)kX@0PB($;D+=k~fcB1)OpacEpP$V|T zmLY}ya9iK*XKJ&zfuaW6zet;?!1KPYyTyO}0B->Tj9(MlcIj{bBaF1%xcJDSyH<&B zgI_`*V2{4xEm^y8nT>_HsUvo3=_xq2xL#B%J!RV29u~)8Z%gyblK#eLydDK#mF^RL3i-IP#Wc{*>xb5!B z17OWbh*YnB{5!y*r^1*d+i%na`6noh<`-emslimRV6la%tQx#^d1!JP66T~v_g&^y zX}*hq3y1dyJEJ~UC&o=B{`-Lmvk*7cL_$glm(Hk<28ZwggOK_B$1qpBw~#mLqvS>D z(mNmN#cpL2VW2KcyV{_Si+y82@uw-~LCb~uBaR6~n1KxC$yo9;CZAQ0`FAy%L`egj{T)Dv zqV9SBFXZ%;BhC>JN(U=o<_1ti<2pP@S}^Vg`$1~1=&e|x??{I!UlY7s@JV=;WFiBf z*)xdmGIlt8_j=xfMqY$BvGi@JvzRKVyM$Wua~|X7sJ?u+za~g&&Ydm}i!YsK(;`)n z!o7Ba_dQ$5(0Wdt6j2x)Qra8qX?w#TGJze}iJw@RTL1L;-)S1N>$y_E@8=P5uT3!X zcsDW_Q8BcFpEHf!MGQPwklEcc^mop~fk8poDx$^GYgSzLjXz?#C{6mBtrA8+XzE!0*$oJ@U}Q9Z@O^LjHh}9};x_H>#iuL=zWGAw zHI2cK3cuV8@G__*>tbQ7G%}f(qu5K`-6@{*^GklpGD#|OCZh-zQYV~FNAbM^Vf%L) zH73s=!zb#0{3x+XZR*8`Dh$MJwE{0eU?Y3-x~aY$tl;-v++G1^RgkZb6*Fl}bDA~N zmhkf+Kms%W^GZu&VH1r9w}mmo;yD4IH0SfFsXfaOQ9EcV`7D)f#24mw&i` z3?+5<=h;c+j9W+ay6)uGTbudyeLlx1K8`d3OHjoyWsMBC3;_sDuTKZg>m$XJN4+GGPpSDwwL?svnT+u)Wl=oTd|z%fx7L69 zK8IBng7uhttX(l1n;R1={W$^-T3}7X;7ShOO7TbA9VMDZ&tPO5l90e;-%^G1!u|+8 zp_1ibeKzWUX9^(x&qpOnwU=Q-X5k|Pfw7PyT0}H413mHXC+)u)R^S8`ayGs<8#U7O zzSSFZqsD2^74Mx!%Ci!BhZ~5fJkt0VD zMfTl+5uL$yHe-6 zeM|%iGV#%rRwgK5o-9FyUO32NY>Z{vSppva&m!jpg*Z1VMGx93|Bff3n_RVKQpVO_ zID1S~ewPN=+kke`y(l}3M_)I2Zw-ANT6d-VCkY3L;VY-jfZCns{TDyy07Bqf^|T=VR1>^I!E*m3l85ft%S-yfo@ zUnJ-iGp=4Bbdqz6XQZ8Q`dYO+NPsLCKmONJ2uBh)ze^y;qnTp0<3Hp(yiT^1nm3or zXDz^&abC4ov1^_GyS(^%($)BGT?pW@#`Hyz@dDixK_T|lvWB+Cb)frDI`S5vq#Z00 zKi@zcu9=ksN<`k2?$Vm93v7=*!>zM%9}$_W z*L<`ib=z>ew-@^E!%8`RhTx(%`|`Jacw#Vjebzi0D09-r@o+6svcqh?kiz@+I7ISq z2GSiV6{nYAP{n|t$hk9iDK(xlUG}Z~K$sK+6I;HM4=&+xf~Kpq^dd(8?Sy$*Vr^Ry z4nM@nKpHMO60%(ot08G_#Tw6>5X|gPAnZ^pKS(3hy-M$fSGly&T5TF z#$KPa>U4{%^H8(PNu$?gY8t^$ZJp)MY6;PzN}YtVQ_h@TbjoIkU{@EC5Nd10a5sig z!1UjL7yVt!X1(_MjoM0yG%hZM>9($Giar1aIEXI&Tzl)^f;vzF1Lz0905C2$s>igO zFQ_`TCnr7STdw2MvdG`lsZYnG$G|GMbs4ES=om79?H5dBgaPF(&I34bHm3o%i{V}s%L;##Q)3G^>4_TD^<8ry++$9 zs6DsMFvqsK7Wou|slX{XLk=k&U(?v4qzz<4Y>yX)(Pa<63IGtFsD|o7M)dFrj_}X% zu~-;NEoF7nbtpf7oAgiyHOMp1+l5zo6~=Ol`z=2E(40 zQi=`q6MGsC`yz5E6DiW-sXUg0XI|o9Gp!+FF3BM@eq+myu@6o4_z?p#A-X80P&6?@ z_Oaoh^xtbQIzrN_G&C@~$z>ea+(Cx5<|@X2V;?ota@e_h^_|r!UZAste|&ADpnxI? zG6kW$kr*TVIFKYxriPwCiQl~;C}$BlKR;b$ee-Mv-CQ1)Yz?Dp@N;UZuj(A0WW_`) z4X75Ux6jS!>Jk5Io@+`aoRA{4;vusm0sqYfOh_KQ6{l)BaOGwcHr{gu=mro5_~tsB zUKJC$(3jCrsI3%E$=GU_qH>7S${B%Xz;YC&F!_3JMYK{TXA2WpEDD!Wv~kx|arVjU z7maD$iD_x-jB5Yc2Hfthgeq5B3~GeBKzO~Hy%X!bQr#xzxAw+9f>?&Y!~CPR7kc`k z^sFT3NHY@v=InGIuV+4Z(}h!z5%$Ie1-*`>lj*xZ+s<60N>Vqhx-Hf7TI&iTbA7l4 zh9{<19>|&8J2b+?k2m8{f`TCwf4Ziqy4I*eDF*I9ozjaWd$+jXt^V3$1sa^WiWpLq zHf~d3PvAJvnFjb#DO~YHCO5leFs)>e9QLkJmn3itYE^$5opR9vf9Y8?`=b7Z=jAB!ml8zzt^SenVVMXNLVk zcyTTGZMzz2DFK*j;-PS0{?}WnABgG)0^PBMxs)>PEoH}KSZ+A2A>9+omayBS+wdK%d*1?2xd7dyz z?vsUrd+92oq=E-V!z_Uj6&k(p3-44Wpz+Wa;*b}QWGXtiWl?GGB3IVa;h0J_Tcyl@ zX7Hwm6$ia>&Y9VJD1cX5D?yzX%+`Ua`|W(wm%^iNe@Qei&)BktChd3X`H<}B=vZT0 z)B0^sd09I$!(Dt`9K<~~J|z$}FfnbInt!@7arF`gNv$xbF6xnG{BRW{boUSm&~B|!yj^(G?iahFXrF079+Dv?QjM0 zXPsnm+ysRw}j@9@=a;OU>p!`M=b=YY>` z^Hcxo!^7(7W|YsClc3*wl50ieJ5tTSDWI;uik#1c&v2PbpvUm?OJzwLh;D)hQN1s^ zS(Vf=>eILmE@1^PS+u?-UrJDX!YK-&#x~}{%=z@kBWNPSc&<_n2RdGlXeR*fCDV23 z3~~MTBp+w`E4`w%?_}((;v0-tm$c8XMu-C|41RjV%1m4OVYr?=?+Bq=uwQjKN3R{f zxu;M9p{~5G1q8mV?EFC^*{-oeRBUflRgv0^ryWCsx0SyiY21<>GKP?%M2(`ac?Qv; z7M>SQ5|JuLnt^S7Z%G4kka$L_92cs>Rd0I-O9~iENel$sj=&|z{)UM0FU#P@Im=W- z!(Zgz(zycGjG;p3o$%1f!HBo|p*VhY64XSJqhIPLiJrxE)@U$8!q_Y4wybW)X#}+1 z>Bm0X)RcK`fpJQ7Ag?%!k)`YBgJp`4^9Pyc4#;5T$Ae@}yy}CJh?k>sYLA)~7(0U$ zLL-rRd2CYF2N+t}bul@hsj`Bk7j!3mTUmK^8GRPzZ`ovsDw1Rqhg3(yWNLn4NzVOt z{^%_y`33F_)lpRm0Gh<;Nvjb6cc!p@(}|bWBs@$k-?-oh;~=PPMr)MCR)bL;aKxSb zd+d52uNonaoiLY2NA>K8^&O!VQ92bp_zzD0k-F6n(N$+~KBP2uPw1%F;IJoW$5k*` z!IF@dRB_4cv9s%8Gn~iy;g@CW`u364iuZLUK*!c?bq642U*>Jc-oOuS^NhG|yyCO2 z?R>_7<5Gy0x#saPsU0&?NWiRFDEGiaZ3ypRJM_W(hm}Aua)n*<)-*p~fH?u@0jfgu zEg=vZj<$XBkC2U3S<#Wdg<3JSd*5lzmETxguHfZRMt}=trm8gGbNt?WCRStrA(OapdvAzXtFX$D5I`KWeJ@%W))9iK=hOPstpO^6>#j%Sb_C!8fNyHB!(| zi=p<1KefZX7OSd~sZ8s@$03@o)4JF#PTRuNhS7|G0tht>(nCC8$?*Cs{2R_={rewA z&p1o^+e}Poj67C8D&U_hPe_ZQ%fhh9UUX=6_za^+m8R_D#06Kx*Pd(Gpzw}he#DWa z(Fq^TR;M4RRrWUV_$ZDQT68_n#ATxCTlTz;?Od2!imLH#huKw>oRpaSMVgt_A)5B} zD6X?UN$=qu%`&YfKeJZ+Tyjwz30-{^A(KiE*48e#QXhTsj{xa8dXdcs!@qo4QoUwr zt6^9)V}{MkO0!%PAs$uTWjm4F+l-i2W)I)5Glgkd&THj^CPK5VEYhe(WDH->YkmIB zRTBO1XjrG;$Zysvw7YQ@`13^A&fB}^Xox3XHKVJKQYPd_G-j;kmLs7A*32^Rj&}I3 z@t+!?AyIbytj~9PprYnqoO*3)P<{JjPeke zQyVz$y>4p5rIOb&QWEVEolMPd!jqHtU~kz8JYPUA=fjZlSx>g7u(*MZ41dETR!x z`KA@!jfwF5SaMQpTbESol#UUDPp?2~#3PHy)-M=P%cx>lP0YQtS&TExv(ZutjZfIV zzfZqDY3sZD^^k#5Ab*|AiHBPsFGMt5a}=*ONvH<(<%;&Bg94O9Kl{V|=D@X#xl@p7 z?>AcU>7VYNQyc6ipP;C^G_kSi{`OdQOug~*im9D5^Y#2Sxs-%73Z(%|!4URvDhlXC zxWA|Y`YCwu!XzO@yO`RD3tDe(=Sa$%Lc~Upxn!?6b53q3U7iq3LAP!19cL6?6z|WM zh#*7X`3z=@jeB=}0BWe5ryzIj^|U8nE2`5(mrq8Q8T9I!&gehKn5Q(&@zpdUZ!W^; zubFKrR8zt%V4L5$f7g-5Xo(Yu+Bfd9w);8JV-fi1;$r;C2esk7m>L zTGtNmL&Ju&W)7I3s#EXZB^7k38kbXdcmo;Abj-c@abw5!?7mAOui3DgBe0AgfF%_? z&NMwud5;5OeFyvrn>s&A=+%;}beC4nc%Ba1*Smm6d8dczU?fG(0ozci0Wn;#YgKmQ z0Z2+4+M74m*CQXivzQD7HIuA?F9$cyl+}N`$IV{m#Wu;?3L3Av+i;34xvw49w6m|% za-BF>ISdXv8|31YyB!0Y1}Ol6k#yV}WoR~$#EMI?+ofRRer%QX@AcEoD$wQ_;~07i(mQVZyM0V*vc0V?a%BFe^hN$(=_Z(S98eCHSPJ)tb9av0V<&aX6Y3~U zqo&o!+E!FFw6tw(?4S}PskbzE4cz?32t~d!`71NgCptx9&x{pYHDhQx_75CyEdu*c zsIMH#dT~(*cx!(d_~`oxB3Fl~*-Yy-L@;@IHd@SIP@^Mgix&xYfd*gTA^>d#W&@{x zF17GW@#?Xr+9yHbqh{-=y@`QSr{EtqyniqL_OpmQ4L>|&5Yk>Td9CKwvBm?3ZlF`Z zp)9AY=1UO3O3~NW7exheizR+DS_5W?eXjzg$jTYh#I`}nQ^d{;U>;})Qvp#yLcvV@?i|}$bn4=(P`1h`xWG>NYzg%6Le`!9CtM*^LM|*w~J*}@k z>D}K?MO}R7#dq-4~S8Dsj1+&e=ndm0mUT|ov%AOM@L6l3-n2P zBqmG_ih+7lDAKf5c=z-a&Bp)D_*?enP+e_1(~bpWy#3{1cxV%jvM%6l_6Sv~r+qE~ zj{sA>P%~n<&Hj|~LhBw+kr`t0r504vr`T_W$zD}{Zom+fOE`}z?vPjHxL&QHoKr)V z5`u=?vL_kuTlA(gI~GIlyV9%jo^ysC$!WGJoSt1U^e+(KAmL~o|8w(7SuFhD)+bm8 z_MpR!wRSRX$Cjga9rxHF^CiLBl}fmhsRxDaXd@LmLi?tUZG#g#AKcRu-A*7aJUphz zXuy8Q9QBtiux!bBK8g`;`aD^i9xbPV6nxpTl7=qP|0>S#A8(arIi##7f(iy%Y4zwk zn63Qha80!9Z-9fW*6ZgyF(BM|qhnO&pJVg0EYa%p3$Z&8FUrtp0WRY}HhTo{0yVl_ zYMPH;`sI|IQcPS?HE&wz(pkn~SgNo(8$)2EAq1?kgr~ViPqmx->u}NA%@E~9pe+-$ z8Iw(xM>Ud_AQmq6Hnry5QMc8rD@f00Er`tfN14fkiFN&Q2%1*#OJ+As2>oe3KWWtc z#Z;7_kkBMaBruDc;*_udgZ1@)=D={@nNPy(;KDKI7VKZD8GN z$yAkkcbe>~03Y59Y2bS!^p8(b2-j#DMXB(Hp?Dx!NzIg>AZz$FRhAL*>%>iylG3>0 z=W|Uc1UlKTkwPSN=Ez=OMg$cli*syDZRh}aR2=I*MzK{gO12?rQ&2_^4JB2D1t}5!8)QsZW}IPEo41JSqQK?&-6DWSqBGAd1A|+?l~C{5JE z{l#d-wfggDP`+axn)()Vo!tk)b+uGO9}U@GIOpPWx#_?YQ45tNR8@f_bCo7Wv`F~N zgpwVhX0;DijJkL8x_}mK^Xe**=L;?E@6X)P=hi>kmf7 z|17hfF&5Ea(yCpfS^n?u`pfp4wAJ%t^^-a4nZx&=AO!*WC9)G;gdCOftz<;s%Q(K? z2?5g1jpHGLz=~W8;_5FU4&_YvcmxCl=~-FNm8_L1+s*h)H9~;#=#-zTc!1<2^wqG3 zp(LlK<%?7*ID_1)nU{RTx+cA9smDVWt#_WTMe(^`YMjGTpW!9=ZjdxF_i2jn;w5q; ztP+hW34%h0H{=kV>D$jNnsjkNYTUT)li4(9^vpOdpD?~9+n9o=pN}?I6oR?Xy2d@6 zLK$I0BS%*Cy96zFj{vBBitJ{w{Xq-J_bLh=eyv^p7H2QAS{N#w$4E`0m_GVeGXiW< zrN&9_XVHIf*|8bd6-9c|biY97NaV&e5b7<{JeW#kLgZ*-8nu!loMWV9u~GGAw@%oM{&~*gqlzM&g2`wBppoDVp1QwJ|y0JTibb$OUhUh1k-Tm-{I$yx@f|jfdFZX-ijp7 zz7Wb3fyMi+0MgW>Nem-nNoE+#3KFVB`Al5@(7l3%`LqjMnr1*=&}|8~uV0boO`2pZ zNv-*vT76{SDnSReU=&M?bYP>U{-lj4Lo$}qB$*{yCu${LhK8NXhUOUe->_4lEGY2v z%RR48lu`DOLtx`#=5AJrgqB*@i3W7fy%!W-%B{_*fGu=oPT2;XcrTi6TXrr1y1E*1JkE?-tHv2{ zZFGlET)&lf?6w4?WPDyO)X*qqrVdn4Xj>epPg+;NdlZ_WNd6!g6MicbezRFL~HCB;jrVHy6uG|6?T@d7lS)^VpST~q&&L z5UlwsTt0jQJB}PsrZ)IgZNoUo&(!7MY$!l7+~y zN=nZmO&c{#l;NKiok0n~5ubL!gPLmlo6>yc&lu!I(^0#tRBOFw@Ie5>IZ8u$Aap@Z zU)D2rYa$1HR*++Mfu4(Fj&P?72+omb8zLuvbJL?)V%g))q+zhg4df+pHPQ9FOjmbK z<-@{8Z^krDG|RatcR27*f1!03?H+rx%Y@~y4re5Do+zo%)-|RQX(M-F-{`gv?edY( zuQ0;=ssQRG8hhVdPPGdxJ!rCmfuddwvY-#;4<8-nKqc;C!S_`+#aS1QZC98N%Fa_3 ze*jkZsYbrV(N&9|tXvZ|T}FwLV|Fa_P2&%l$EJL_ZS@cFtdJJueEyGR? zjzk;@5!MSKv&Exf{@CS)@O=~Sk0x-W&KF7Yc@q20f7a7UtGSi)HqQ<&1BZrW0rxkB z)YrS0VEeYO%xmmW4&zX>VkVgZ>WOp(&cat(gYEDnz+?DXokmT}h2L&L$bkO)!COTj zyzh03vXW~Eg8J0kll6)T4%3cnQX%#!KC5Erwt9D^{rutv{GYo?1lD7td?Et5VATY}-DSShmBdl?!kN?%K3+oN)v^kt!tO0VE$WLxr1qq`dsjK5<0Gjt!lfadL zFpesp7h@Hu#q8aYWK>Z!L}rswgsDpe&mn&;#KvP0_ny|Gd)Bz zDvK{Kg2|X+1Xs(+XLne6!=S*a0kcTquAv<>rx_iv1yRNYt>K1kvo8|;{?}G$p#bKR z=1pN{r8TKf=6nHR8Ht;8+Ybrm<9I%}H4BfQWF=JIQ52AGiTHB$ub>CI|Bd@qeBaGC zg;%BM@%TFd)jz0WhnPsDlwgzY*>x}nLFA^%t?mnY;Zhp!lCf{z;g zhDl`I_(L$iXNCFelREH@&TQZ8q);hxFzi?r%-{c`&vK_voYJ(W7v(rY?7oX`XH-#6 z;)JL4Rhz+L(vpSuOWVJj&a`@Z0r1PC*&9+d;^!B28s*Jv(vmHXz{+4}`f~yv&+M%0 zE-&f3Jd~jx_L`{|st5<~uTplAfTBAxNNAEqq+M}9@FbM(n|pP?domU;$-8IMmpHrI zH%$0pWy=G&AJ+OZE3iEtpxVKWkms`*f1Q12v1dOLExeo|)`l(l-1MJT<<rZ!psb~nr$MJbk~vVIlQ9AL-%WF{4qI&L+>zD zRYRG)G2JM6TvvDBek%*FV!_i-#JbdWvi z!n3^7Q*SU(_8ogh1a~3rAGaPssD5yk>fpw9v`YPrPw#S|!Lx3fk4(xbQS;vIU`QD! zAMVPt*!|5V>6AD!8xb5F%!~#i5OgGs=R~8d-g>kGAo2jnytCagJ%BA~h%OLk#g)dt z;P6;Ce!#JLT*~~I@`_|vK9oBZabC0j(`#|_Gn?oj&UNQ~U1QkX4eUm`lB=xVXxzk8Yw0BPuT9V?8!? zgo(g!8~}(w(EIj{hdURbJ!MeJMOP-Hon8qZ@-wjG!_bjTZZ3TNwVAFqaYu@nYf2xw zNtK*j^u)wX5EMPjL9h2xrbn(J7>g4>qMqn%tYJ`+TtQ4DjNXc5S|tH1oYT~0HF{D` zOaV&^I#MRR@@HJ-;y?*WddXwkLuA zY@VXXgd}rVRENrZFzSh`DEZ^&mr_p{YtOmOzKvHJBf=AqugMHa3#_oQSWKMMD5nPEUt{0!N*G2gasbTxg`Ymz1Esse@WU`(KM&v2|qkGBO&OuSD zltvPZ2{(*wPO0|0_#fE@u-40Xs6~if@_@Wgxm9(&06RaOju&FfkP>#izwvh7uL)ch z{)a+8g0K={RdAsBu55S^jc6~H*U(-a22;j4zYbO|=1K*1?{qe@nFSAp%9%KqInhJk zftCNs1mSEYrlEIoy2=S^`D4kCY)^la(suXy-x z&&P|DseNfxRqLN-DXo-pJi8=5kN;xs3I#ktS-JaW2&3`(;fd1J97cc2jOM)kf^^ne z0}^nlS;-miJ4}fvrO%)bEmW8vbrwIXqF$PIUG@ZuqXIXepod6%!q3%(2ks$TLLb}c z!IXhqYVUXmj2{{oY=ILS(+QwH0|Gw{O-;RXen&T`COT}r-;fR(MsJ0sfJSYWu+J+X z4N0!a_# zo%4#o0M^Vf=3xYO)l5fvoUhL{5`#?siyH=~RXm^xND#M0F4imf(d`|ck&8M}Z?o~` zy`hLx&gmSUssZ7y2T2Z?$i#`|j*j%_Jy%AQXYMe&vWL*H1*y1wap?X|;g-T4KRIui zXVS_iVU;njjHe!>5XtqZAtYa>#jTr4Bt-)V3H={c3;07Qruu}1| z*8hwK!mo;eX-k+|4DzW-J05aWq-U@VQfk>lXd*l)s!#ne25OU)9z7*`t&zqXT0(6W z_BWMJfAs)5^yYr|p0?@yv|*obYQiuS{uw`?*Z)4LU z;H70CGJ$WHYN_OZwiuY-pf>y)8y1a2{Ssm&>nUm>@y22OpalmU>X%b1_h^7?WQcUO zA01(+F8&!Cc}o5Nn(IUd?8a0DMrymP?n79NRxt-o}wLbxSFJSZw zOmRch0&NKi7x8se#UoG$p)?52{QP~bcZIojPXW7;LL|H-Q2-e@;OXoM;HW+Rv&YYQ z>%|h+00&eUe;@Cz?~h&Dw~x|z$`To}aew9r>M>fDm77);Z#&4m$uuyxNR@~jjNmJk zuoFly-Ucs!Ic7@eW)U<)>DPP05VHHFR{hc5sbA1LJB?kmJcmTatO96-Rsf047UNNZXep0tQbf zPMe|PBUTgWYLtpIz*E>bybnLGd3#weWi>LjN#)`arJ_3EUMGo%{J_~5B5u(_Fnjvj zw9C@5_iOX^_K^CaORRwtFUbucQYH$7m+8S$s@?^Cmosw97cL(i@U=mfypEQdRvczH zsS)r8rX;C+>s-yh6hW?B3FaLM5ycwQc&douQW0epN^M~h)`GSBvrxd?%gTFo*D8vR zpel@rshuc^rDd*UFfuJwm`kXdkfh@-zcq5FH5wUt;Bf^uVrSPrPcF}Zxx-XFH4TNT z2_hDRnY$FtQA4lD0uwU`4VM7h+S)d>dJQaheROfT#@qy3g#Q)~J z*h2AqObM1PKFq0$KqbnjrXGqy;aPK+O)A76$c_n{H%D+iBg{zo3NeT;y3FsYVf>@{ zwX?frL7A^bZpNpc^P=!qaSZVfFuI&U5k8mAV$2!!Y?RjuSL_!-dump&VBA3ATs(t` z`C{VT-5nyHoA=Y~PeXqT)hnl1!E4a=_+>@DMI?~MYP0FMUejFop0Fx%44;Ve%OwVs zT0%OD(MmatvICIQ%zCmA^U=yLu6N4*nq3?R#CmtekaK`i$J2 ztiluWyM@Sm>Q6jIN4Xi3h-F^>er4GGR%k?waesL{#N(@QRXMkK`&ffEJn=mHecX2m zNyO*pA!)2rTv^7;30!8(TM}#`QiFRIe-bWfAzOA;yAo!plM(elOggHnJEt~mKW4e4RDUJu!f2*zsj~2*=+(0 zIb-^p_lmBM|YQt*2@n&PFYTrK} z68C(jK1B0CPT@W37OntNo8qGLiz2jQpP|I+Ot$Ez$9)-(FEKgc!T%ta9$T~F*2NZQ zudn;@fTZxAiEOpDL2yZ=YQC&E6h{x0P50pSysGJkq8WM)4*h=Ih^?%HvKd8CFJOG` z;05@SUhC7GAd`?fn%wJ}-;a6hbu&2}J#!!ARY8W+g>>23;rslhDRtOZHql%N9rcaN zTJ7P{PCYC2Hhcw`z0ADK{4gWQ{P!@_5$bLwO-7YiCBUvX2ul_Q-v2v7XAaff9&}K) zyL&L@=p~BCXd-8Qm1`2NP)yj;+l}1(&ngI^%wVvIB+Iv=xjH;c*I>f|_5cF66EjTn z91}&#l4L&;ESZbNRbS&dQpVWFk{x5zq%nLp~=dprJ*ZVN)l zRgv}H=LAwqa~M!{hXRw0%nM0n>@_#2RXjE^Azshy7z`ChSq05EHLZXX+dlviA5YmM z2UUR3hCixGNs@&XSXXlJU$!oBkactyb@m%GAa6|}p{G@g|3v{gz6q{zK zK@VMhPncU&8{=1)w|HgS4Zxl84QnQAseyYauUVrua527n$m|Px&CEQyOOl9WG{sM2 z{fH8Wb6NuGLo&`=&rIGINUmPX>H28Ksp~)Ei??DfLhyzL8yUgEZGTu0Hz{0DIzuX- zrqh9Q)|z#VNu8z%or6IyO^&fZOtd!r5R#q`-*DG3;`2|5a7?eRhorIY1LE)rVE1E) zOA|&LIx0W2?O?-8Q`{K0*^FhobRJJc=i!AqkMb2==Uy%9i>7w?jJQd;mC{uQ_Ilnk z>4o4Du0JGAx!tBfRq*6PKJ=|XaO~Cg5d(k(lbgDdyJ3038YnopJsh|c>>( z6=bHRAJo-yzS~oo?P@iqgqwc{y6)tWq*=!8p&Rq9e1aZ1GRWl%GrmgNlX*P)EEv+~ zz03ulrb&mSE(Ym4;J)-azR{TEW8qZDL=-h;*EssO#v&l7Xsw)zE9_E{|N9>s@Ce;p z?Bo7m4KQh4!7|D_l4@Gvh>R)1u|QEyZ1MCOayjwosq}t$S-I*N#1zUW{NvzLr2KcK zDs9_2+p*#j%@0v%ai4QO?k_|xZvy9JuMH>5xsz+pM~AUu8#FffZ@%l+3P@?_e3 z>$BQAI_TNrkcE1h-hS`)LL0>fEHDhaU8dzLcc`2UQlQNfJIS0ySKChjQJYv7tWlTb zX9dN+mY;`4>uA=Fhtwf&)?f|To}(CI0~9zMiwsg7f4gs`Ns{Z>f8f%aRF;I}(Q{Q> zp7A4O*pyOwt)1!-;>VZmcH^G|327wlQhyDJ?^R6*%=0GWdEONf zRwKAXjN2QU=n<7_Bv$~x{Dd$tvx(UxBJsV06~=A$(Cb1P6NCEEiM}xC2rz5T5`IW2 z5Hj?{S;}EfVGpCVNmoiiq$)Eg)ADtbziMR00LftMsqcZzSelzk8k$-*fJ6*&l1gVO0ERRh^CIMXT%-M-iU`G}X4A4h9wzQTad93cw}aH%O%V-OD}d3Sf?0n9hU zpz>4P98_{vfTRdNHRt_dX6BCck^$j344{Poo80$8ULtn9q@t~97@6!JObTSBL(A_o zr4Z1`&hRMuoU-2d069MDSG$BQxbBS@nD7#r;LsO4bg1$kTSG~T)HK|; z%$Ru;c7o8}Yy)jZqNY@XJ>HLzm|i@Kt?KzSybx)d+3dQGIwr+tszJhz_tsDY`V#k$ za)NXn?b9@%`Q$<-Y0uS z5;@-_d+cXvzh_UAkJX{6jq!3rr~%R(M>j8_W^BUT{ZzHGDcQ#IUVG#ARb>^LpDbVU z7cbZZC?wN~8`|4<*Vh#s_}IDT-GZ3d|CKt;FctCbG5Jehtf$Q8(iUvQtMKuu64yrN zbcTk(QLG;>^8q1bVN?q@}AFeIYIs|A?0*If9oK%$*A*SOZ%G`#X`_AT4)W7Pz4xV|kc zlcy~B7^wx>W7gH;3}rI_%X71fN-AtvzfN;o9_q_vOq0?Q?Sbz+@U?YR-i5ruH%Av) zB)iaNM53vLUPd6hFdBR1SNAGcEa0$!Nm&a$gu?Y!SU|w6g)aZlI427-6W4#KB@A5j z8e3Wn>vYG+;jQuJV{iV$C0k@3?I{nI;aA&YN47o-DKzTpi^@V&@Mtg)d=HI%I*R){ zW|EendeytN2y3z`l`LlAe=cJ`y?{gO^324s`{;au!ryx8^8f|)YuSR(oxYYZDHHnh zX`zC2?LBG!G{YU|lq!p@_SdCE%c5{ipmAT7SYQJj#tbQV2JPEl>nEHW2K!d<{imNl zyqXHL|)FT*;%u(kDtB;v!>XnUcUNWk)gj#Fb{&^E6qS+i0 zwoCzo5lR}d;#8$`SJVjnED@g_MW1_IGM`(Hy9Z$_ZcLN9UkiTjjm93{1KXEeEPAbm zt;@rr*SwKFzRKNTfiw4N{W^rBo7;2x2~sV%dKAu+htCrrCh23n=mwpE0<@L)=X<^R zQL50b0!Y)ZV^bP0<>)fVLK-LF2=r`8`P6C>X_?J9am5ui+RCo!>1gtc%i(Ao7uy>? zxQP?p>e!Yc_3M}8DRj=y|lrBgQ04=W|u;w-c>ytP> zOA3uw1)g!-PB3&-!T8qz^oq-gk+ze~1hC>BSOBs&hqN z`iFnBt8*iijSh+r2&iN*ed~|xzHi;>V=i8zYbCPJ2e1@a>KJP{JQaubS+;-I9u3Qvyr^68Gc27f+2VRmGC!H%lvz zCw=A_%IQ{vGQVR_c-IAhD2+U;c*F#+{#&0 z1+4$p_%b4`XROc}2Ir#jX4p`cc*SAqdgh@9*M@A}QV7-60K1Hx4jJ3qua2 zbc1vZ-QAs%(ozG`-Q6t>($D?<*Lq&C7Vj9~+;i^P-@W%o79TMHEs)Ruf)9X$`*udE zb~>^Wusku9dJkFosji3kJ#FDiygc#(Hc7Ahf3dBcu4FfIkO;smeh8P`bW3KP=x_5J z16uiDGr~x}!m?8bKk0HKwp5M8(*tiCwL&8KW!5!MnEsB}Ko{}f*p)4y-3wdbD)gi+ z_03r?$j_okD<)A(Qfu5{omX$Kc=$ei;eaN7%Z$D#%g-&7s)XuYJoaZHRN7ws?{vfy zrpZW^_zc9U->0@KVs{-aak~A<{1dj63)=j=04^ z>V(D+6_~ogU*UtUvP$aEmZ~FZvZesKG?4J-`bg7%Za9&&$>WX+M z(m`86bLAK7q@f_E`Aj0_D4{vpBKh{1eGR>7OO0^$eyXTkvj(G7@_?st9;cHE&1g_t zIV5EmAt;yrl@EMo29Y^TORn4>4}Wz4UavnBS5J&kz7u{_ZXKRy{!8NQV9P?aAJ<@M ztoam((r096?lo=4wmyjHV;RrNJUe0=501{qv@g7p%n`~22qnNPg=bn3t*i`4GltJV zWW3R!NNq4^_B!)(uoTuYo!O3y;??kM%e+Jy{9$A`GnRqwHrpPT_i!#P}_{rIf*30TJL%=}vmP$5h{?jYz%e*yd^gjqRi z$5(G-Uky}L9RFRMe)ui5_C$VYsulMZaJ!MY|xo#}p^@4B1sc1N&}= za`F?WKx?{w?Y6{`J_jdKRrNO<_V09WyKKIc)0^pR7W)B_M-erNtIH-4y&Fb94e5^4 zo)Aw|z4f+avuDA{XbO!%N&5+T0+sI=^=5SvXJ`NZY+Wk(2IO?r85?%uu05|CP}orh?nw1FF?&^bGdt+^^HFKSjc}-}O&- zyI4#qXi-yrt$6dQu5%PMgCW;o(%yANen}-`kwVX=^u{hQ2RtgVi3a z9*nh9*VfWvUemJv6cYXT?|}E)sy9H=NHTU({};anI4S+_ZV@*4RoJV3qe9Z^E3~l0 zihKONg}jNz#C&`@_1#+f^$h@YsGfjOZ4De99fy`&zX5}os<4OPH%#^7PGXY~`slfyx3d}go<~0S3(DcwzUix=&P2{1hfvyNE z(oT7@Ls6=K@v)ATE*C{GQj!}szq*t}2adOB zw)`2C!6*e(ogWh+jqQx^U)ScA;UtO@_qk+ts*Q0*dp+F0H!&@CvUgU|;9U6T%0?RY zvHB>us0v!9NJE<8^o+_(G~s#2=v_%n!0>9Hg7@sp_%irD3^`(z9art52o-_;cAPh(4JCmAvUS8 z^Uyy-2RFaTY`-CTMfT>1W|);M#uYl&5S(`B21E7YHQ&~ii`tdirX~gS z*0dIupSly*2+7JD(seECncQ_^H$YHp?%V3mCT+Bkjw4GsInd0siqy(9Fr2n`cUM^X z<4Gv_gJ>5`kTdnS&r`Uhbj-qtPT?k3kJ!_X+q`&gEw6&ZmaIyy-a&{_8iKR!MBirH zeD@c#pc+4Js7$aimEag~ewHX5))r{6doMA#n$@7V#s`M86SA%XGsNWVm*MnZw`@s- zmKs=+cqK+;2O5@frU`%keN95#G71H05P?FYd*qk0<|$pEsF9*xp6f@aziSq3kWm_g z{v2-l-%|Q+SNlF?d;Qx$0#a->jdXO^zR5hgKpVy~mxH5YB!BS85N-5Wbi`CAqt-7>T=arn^SeUW0(@&E4y&~^fU)`s=1 zXUZe@ChFY#W69V{OkFxlCvT3E*=v{o)DFc>Kfw)o(hD!}V;%Ho7G7MP!lW=^NwuV% z21^;BI934|m&dk^jg26Ir_N~K``8&>lK2^ikdmd4O5g6A0UB?(c*Wc~!B4!dkNt?J0lePJ_TZ+AB-eMv-?Q9WRi z$VLY_ZT$Aw#j~s|!-UI;hJWPeFI*FF%?Y=Imh7`TY{=a8V=+BAmdiInyUmR&NBy+fbnND7PR?TxQ6Y~*jytJ)`(>9Y)WrJHdJ!iRcu?(~9-s^)`rp(MCc{SLi z3LZGrm>E;ooobsJ1sNro4b04gHg9@F#e%Si45%VD+28sB8c|z^iMP8F2#-fWsDJ$S zGS@b;kklipSSsxu&B%qnxjXk#t~Gg$ZcQ0UxK-E4iWmfV*fTLAdgQ?b6-!s(yaf&b%C!M7iLR~qPwPDBr`~-$n;dvc_}ZSE35F0!V10|MMcNm5&3TA8 z8tI#YT4(L2E?YYmLQPDRcE=DA8Z#4=GSC0r*?k1_R024un_ILUMUU@J=GLImXyzXlv8XD+d&V=O8xC6p%htAJ)5DP%tZ*Hd$zkrxB-<4rmiUqsE7?a<{E zE%nL~(C&S4Avt$_2`r%u@*r$^)gxuy&;O|A41N$t4Rh~lK<@AG0@iWsY)}Vy`aFlX ziM9e4?PS{YvSgN5J-I@C-ZB4^f!b??!PT`K*zFo6S5dIN@HBIQ+Q5o0j`8!(j4mN> zU@hhi`Y_tN?~2&e10mem-*h*Md8v0i#X79*KQaCqr&}Bn#_@XQ`iSu@fZf!6nvH;s z0G5!)6p~Ivne?_Z=ub+8w3`h6s6fvVh;o$H5<`V0zDNqHK#m8>J3FmAO{~G);$t9( zeZ*1BtOS2-8LXH_N>=B?r#{46BTLoqltbZ%g~~*tL40}8g+zxn=6SfAo%|;PRcLSB z--;R6xAhHL9>RGd*AeK+TQT-zJ3k8`knbL_(X`;{CGp1h3(0{846XM)7UN5n0x+k+ zBiA$Ufx5uE_b6+OveX}dzi?=6Aba`6%mdlksAKcml&gRI7cktzn_VRBD)kC_%o*?K=j%Jpfk7jgwZ_<<*WtN;!;v+$wVD zQWO>qz}!0(GjR1shVA&nu5l`j*0O+7D`1x;MoO&;HkEE(I>E_c8P2VWU(=9mtNPE0 z?|XlNdn(~&3Mg5hWzKLXl%{)thEfAgP{UO3luv)Dn1g8Mco0)b^?!k@rkn~Ezzlj> zyK%7Lmz@0Gj!fv}mh4tNIAa#eL2U(!^f8{(WfwCG6 zlBTa7^X&I|kO$)}8-B$$7<=24v(piVtC(COSz(;kQdGuD01F1dD9_)G>K3?!`wyHp zSDwUNzx`F0n)~kh5DZvC93jdmB2}lVqN1Y6VGO3-k(=k|VO7@jNOEY?SUvbiI zcSiH?GNDq;cULT!_vy>usL=x%j1jFhOPw*P(AvI+CZ~Uc1+v8y?k1TiAKlr=(t@0 zu8Qg(Dw+0_Y~w}lC}AW&@TKe`;=I31enWjT?tiMM|4UAVyf1owk|)wItuY7GNb?Wd zgvPF+K#ShYOsDz_nHth!ag^`l7Nyt2O=NMh#q;By1mGq4q%-L44qOk$BwkYCkb&zN z{+IKYX9+S4r20wyuWOUH{HCOt(3L2op~HadW&?HGl%8+?bmm9f(GQOszkx`vjS3(#W1^( z;lL88i_qLMU2;4?mu5mW+1n&G$ru31vL5QHLq{a6?Nc+10!A&!{)s}MmCW^-gsaSg zl1A0WDF+cBbi$f4vMZ%S3&Lq42M$K|Y)DG;RawpxeiY-t1p=odL#7euO~dR}eG?wv z4ZyLcgj};MpNA3x-`V0ZaDU>d_)I__B&N4+G0d;Gt!JyP$!`f7SKA77rKqN}YLbTw z;t*%x4hwhkAwRG!%`@RM*PH8b9z0-VPo8P=SsHv!0%%?W5Dh!_DLR37f8w;HljMp9 z>}xvKFD~MWi;HyzC`_^*1L3>v0P7=aAXsKhI+X1tcJ4?cWXHTUCPT<1LPe&SN>;sO z_MJr3e@h6M5BBMfoPU>}hDvG1`j7}_-OvoutK+9hCg<>*<(}K+9AVU=P57NC4a{Sb z-E8J~31{xNMD_TH#N#H+I#wKcwC@5|=H0cIr?tC{ExAP>`S^(5d12S6!t3}R6I zH+zInc!clPzxML%I^mQ!sZ0?i*C8%G&IiT;i_qjvCNr>D>-ORf$87Y_@eYcx?WVEp z#Wz}>gbJSuBW!VvZXTm|nboa6df#QySjB#F%O&~+)Ltb416fIBjQ0u=6!?J(=*%I; zMm5?$bvXeCq$GHTjJi@Dn*y}8BK;ksvf#Wzo$X$No$cmiNx)$q3A z7E%>N$-l_>OrII7D$GUp|PcXe_q>fneuA(}bvO zVvWWhT)zP_7GRY-_KU;)aXig7DpC(p?&w!>2+(7li=)Bn=^anDO}%4Nk@JDVkOj8BE)0e-|kT z>5xiFtiw%zGROAC?n|L|;%eb=>#*kTT8m97@7#a6{B6SE+-|ri+x&&cSqP2V%te74 zTQQV@o1{J*OH6rEUPU}dlFlQ9lTC#l8w z%O75IWSN#$MX6n(MPx11$oPC7?VA&kvf8(8WeCoT4iDuIm&A%Y=1xMvcK=F0KtZfH zoF;a@f!2kaDGjz*kdzNv|1S8dAW(5Zgb>Bytq`oLs*0)XwaJj_-6XFHEq0=V_hbkA zJ75PAzTeiTa?u#_h;3UYBdJ*{Eyvkogj`L7Q9w9?dp0GfXaB0;W~~eAGx&KY^5}>r z7V=OfKCLx%LUINB}T}C z$|6zE$_lx}%LQ-w3~GLArj4y}iL)5Y*5EtM2eJ@TDM~ob8VLkX(3vc%cU*%ot!46G z4G`WtyZG06a}ef3Bx8+_@Ky*5@D<$wFRl_#k7(II0~){qb?{qxrW&1=r5f!~J)V8& z$UoI>R&BRv_1-u?j~&@XJbhDs{okSR__*i0aq@60T?j>*_-E6oN6{f>l#pkw*YSKK z(z<6+RAaI){K)j|Uc5yiq3{kQ9}>?)vUGd#%#yh2l)v8+Aw!z|xNd5nk^A#SSN~7h zv)Ail@XOHy9hN%VjgDw?`j<-0G%G$9-Fj3eeB{}|?Gv#s_j^MdCq8UjlEH5EZ8L7! z?w&S+8!%pY{cRS_&Ysgs?8;4;2MBT$Jjs;cQZhd@jmwCPQO*JZsS~^b8|zH-6B4rG z#cIr50O$OWGv{BVU#@fdRkN1#?x5`Ft5{e$T60IG_L8r+R}LwVHU#pq>Yb^|%+%Wi z+@mzpHb306FdVx+6^XMePcwx~D|6^_1cqLctd8x?3r3Me%QY^s>!#y*Q{PTFG#Av< zb4ViB_C!E;xSD_5cB4+~YUtQglpdx5HutcT4+Pmc2UF*vq;jFbWfecgdC-CTPnwgt z_gKFxJBM?7OpxZx=Xsp`%AY{Tin4LvPgrdZ7yTd+7jitSd-R>tyag>vW)AbE70>It z?{zZI)p&yiv46)6HMNGT^z(%h=kgOvi}$pA~851CVCLBpQU|e^^8zuLZ&`M1E7^ zBqe2J=l7)`h`p@ZbG(gPW`@JHd+dJ4+YOLZeXHVbk&hnMN0z6KDkK2-vLd&0U`4QhY?h|628IV>3AzN?su$~kIvzl;9h_{Lb-0X~y=4IrtY z#~=_vf^@&#L$^z7;kW3`&`PU}OTZ5e@H$tXJbmtV#(>Pd8XqjNNmLqV$u>`IXl$K~ zg%~$#U{H#xFKlE87D^G~x8nd``gQsrdLFRuL)>f3Q}n}SRD@Jr%48Bn)uQzhF%SwiiphRku=(ZW4bu|Jr~P_b%G7(AJtFwt z^uvhP$f$-2i{+lRNcqKBmIezxr%GqZtD=vI4khmc_+HWNFR0+^(t4ob7v>Nx*e1== zy{-&^()7v~vReW(wf$~~+ne`hVD3nub?7s&Kl?YL*)(Hiw===7?^)V=nHH0BZ5LRL z#ZNwPzI~xh@fNNQ6PgLo*_zz45q#9VXV{O&y3(pD^ zz8P;XyI+pkGSHNad#7^PhEg-QRW$O*(V%@qQfs$P21+1p0yMuy@U*53N*_;9C=^W+ z?@MeIWgsMT7JZS4gL78@>(|TO6FqDVYn3?{o2;*Hf)wumo&+FQfRBCgkGCG)CN#-p z;rHBDD?#$n5Ni#G01m>38`>#WL4|GybncIH*V2_1<@dE^hGA!u-P~)YrAGsvPotG=+JJCtI48$wD%?|kl=v_9F4^sN64+1P%`2;z|fKPMQMpopAU`UhF9C9L7qL{6Vvrvcut_#E{gMolg*#|--mWWS!)dM=VOd6tBnfhaqd_!?^Abpl)ybqvB zdhCW=TB-ki)Jcp8;JQ#Pru8BDM4BcuatIlD3i)rAhYRehyhHG`#?zD{YIv`ekZF|M z@;1oL36E)zk?~vX#lj7j}EcDfvfc>NB{zk9T%`%7;!s)J*4lE_;^}6Ij!)N@Rpu4Iz5K zd8=-3rW`ID3LQQgWAO|bs1+)tu}W37n5Y|^s%|nPO!T5M#H2YLh^23qz{@?fg0g=;v>~rr^^W>v7jmQomFwj;{gHRRJ@r(wRdeeqU_~X%$B`V6OuRF$0eL@1@7Ke))HtxOv?N-^S1P zSPC5-Dw^W0O|@MBEB4w-ObvOH8Sg9kjfV?C7Q+GFSfAtj#-GfKGj!Id#OLP4#`0-c z{H{7WP6?DOk>}OET4#PK&o-m1Vc{(-+`41#H!_eY=ETfzLB1RkW01)7)=0M4u(%R> zEyfU9A<;jJG&|Mub}Ik9As@B(xJRl~@c9j*-u2I?UdIx3^_te$<$Vm4g^g*V`{hjT zQ%J`{l>PY4gvk(Cm>2{m8|1=1i#61HGlqMxtImk;HcfHqT}uP2u@9Pu>bL(!RtYyJ zLuujAx7WN5rDT?2VsvbJ&PysXf7{oBJwY9NPt4%n%k@FbU@jLAPm6IjYTrC6m@(ZR_6o25ZPuY;DE1?im+@rDMDP#dApXf34tudpwQH*a?ms^%`5nU^_V0{00&~ z-QA5_m%^-Vjcb^H6`azYU)8(Rg~GFzjtrNDE(1!rao6?i{_5y4SqTFS)ebuTbzW{MJR@q>JAhn!iT_6 z=8A3=T?T6bl-J#!elu-E#RQF1hyHmS%w_NNIO76-nP2&B)tIFq9F>z7;Y|$^X_S>p zKwx5E@K(3{1w~FNA>WYfdP6;oq!<*6z@Oh5^*RQ!aUhoW4;Xz22y@S3c{t=8H zP`{WgLPAY*<83lR56D&6ei0i+xNA|LymstEgLY*nKXP}4vBc{2y7BV%_1PyFaN;0l zAx;tNj!F|#23k?%$0_79PxUfqK^38gx;Lo+Ix!8wOWyNS&kh{%_V$~*&tu=vu3vvK z;myOya;IjZv|qx`Z9rc~^^;P>rEwhQ$-)sUehRM^Gpy4%tX=UwthpXb5#bdBrJJqi5<8Bwqlt6$z(@Y*VL%3`}pr$D#Gd5f}qM;r*vPYX$r_-np`G1+&JJvLNs~JKf@L2 zMR*}13O|$Z8t_a%ymUzFTDIbHa*oy8%FQ_+H460coZjI+cV$5tJAc(y3XBr=QTTt*Iu6S}2 zD$sb6H!7f+dZ~UqvLGA_gT3A`p0#gxhC@gc(*6^gEg7eEDH$pG!s#ZcgH*ZBr~%Bp z%#1O!;m~h14;n#k#))QrA6SUn&F9(ZS)(v0Y3B}s3h><0@Rqjh$%I@(>yXjN>KOb{5NWCy zqkNc2vp%+eeicj6e-&FMYhx(CdblpGt}?D%zB_xfJNYs)w5rgOB$|WjTzqaA`TEqs zN*uGvnr83083;Idm+$^QiLD9+ms+&0)vVZ>CX>_70%L@sFAA+MPyfBkayZ{WE(oYw z8)bDIu!D9jBiYt7)ukPnz*zTYF@gO*$ZCaABXOSP<3&!z!!P*~L~D3LL^;PBlEy0r zkaU)HciRXFr9T(q@UmOUOe;Dt7ahmb3lu5KA_h&M+{8-p5oYVJ8*(1;Brt5U49Le; zeJza2RXoNq9y7Db|KPD|(94AMk1ulaqm07PaF))d2MddG;=H)+oWuOLURCqD9XGtC z=l&22)#9X#-c@l_$>GtV9 zEcGvXcARhxHz zF+ep~Y4w~F(NF;pky0^u) z{s}B<49z?D4&(;Bjc9ilsiEM2CZTE4kYFP?>o~YN(q=)s#(3VLyh95+#~*E7iV4bh z_^P&*z;`{|ZP}dd5R-fCZ4!ziEH1Eccl^ry&6-r+&YpAE$q6~X6~h}#TkQ{MgJpeb zlBku9OwxMA4GOxX)Lw6C8s#@9e|>XveaV9Te#rz9x+7OkCa7g)cYEv{1;YW#b3@uy zt{9W)c6)9{1MwK2&Te=Sd8DAj)4wxxo;>{6FcY2F?9F|f@d7fE)5zO|k8zb_*c2|h z%5YrRzFzjzH4^K}3sfk6dRQn()l(;_q!VTYWuFYIfvlc z9Xxmxv1jARopP+vpK_u5xbRU!GNrcMudS%jcHyM=!jwpM&@?yB`}c+Qh(NFkZYmo- z^)8z$yFnZ`L5;s!Ge`W{`O3C=UJ$17>}TYRoq5|22xvkBBPHpufPC(ILo4Z2J!Y(;_Pzl_u0Xe#b8U4H+ar3E^Je58#@2VC}<2aTeJWMVcHRiQLZF1Y8rF=Lo;!;I^%3}MAl)7ymSs9 zr9qr5KL4&_Eonkt=9PF8s8p%BEhU|NV-PIq&l`J;c2~A_G})$a+`kOmJzsp{Q&%m_ z=}?B$;DBT6EadOFbY;Tu7@W_ANB_VrW%K+ekZx?11R@oz)x&pSw{I)MY6>W6#?s%2 zYjb?N@^ZWB=@hg*qnK69tv|k?`8?BIpvO+o*6!Ie4b&Nl+b^G5sxjUK6*#uwHM!b* z!>>=sf$1MKgGv^N_elTAd|Sth#@`HFT2#Lc4}+S0i=4((O8@MxC@W7JLK%j-FFYnu z#79}VPetRin3Va^##^g)?sigPLuee;8~}Bi2vHUP%?jcWJY0shYAya!*<_KD71V$p zul!pvK4U1Ttya4VsGA{=Ud!6|^!pyk917Z6X2tpAdwHH2$vS3JHJ4}@uDlvsa7LT2 zGd<$<#{)812S`&hmh8@RA;(y(XG$DQkgH-1SGFu=vsC8VQnd5u8Tj|r7gN22xwcDv z(IYdr1uRc0zeHw-BIhzQ4SHyIfBZHD@ zc=XLf7WKi?{rIKSkSxZLQcY;J9pA|BcAOC9IF5|f&nz@+VOH2b|&yVN$` zz?cxul#d)QcZ3{@u)-8ni@>@`3tXYR9aR?iEH$w6I+I#^{E}BN5_X=SFe^AYn?wyz zuzTf~8@%j-_L=<0y9i-${dsGv!0-KzxCd3|Tcm zj^RS>EQ%2F-6tw&Hnt&u@}2XjNcnU|7<`;+$}@OIayC*hgHTf0JW0od$@Wv~@jnZ7 z^>D@N^6-xZMa7wh>TuvX#HmIh_8BI~413M3 zoQRE1o^e_qjap0=W&eM8(Cor9j?vc2$27R1c^=bbZZ5x~ z9wg1DzJ`d;PT9UvIwN`-oFQi~fLgqRVXJ^m<#k|_;1p-f3V$@7|A2M2!OqLj4#9&Hy!WV`^PjS^J6+>l5 zsD)+j!l$aX{#@j;3li#&0iSK@8$S2Obg4NRaN6{ae-&vC?`k$@EIRpLu}AzFHunB^k$i^!ynZTKA1;S@g*Dt6>*^E45H(t8rX<*c6pVq*C zXJJ*j+pP_z?}%Hkn+i)EU2J@94QD7~t1Lifn2jwEWYFh#3s>i*vt$cINH{L9#dRVG zf@1}}PjX=&y_3M}v(MPQ)j~!xQo+eFcbxcwAXexEu_^S=$QfSNM2_94c*TiYV@Db6 zw_+zJal=$#*?0o=8Ixogym+=EQ0ejT?mAf^FHhW82DZsM!>{9P1cHP_NQ?^U#Yt18 zw3A_2yj_*WTioQYvY>c>p!-ORRfR|I6anNefO<%arj)pt`~8gRbALy;+UBYB_MJds z8;;D!{o^gJ@dmjMoMWP*kE6z|N-;VPdr>*40V*NcT9Q0r)Lc$hcA74&-}{=J32lLHwVMR1Xw2k;R&44ZHz1i!6BQ7(9e3$Irvg|V|JgN!vp9Oe3Q z`(M}K;mSffTR&3DwZQ^&dIzPMqvV9Rf>u~v6t@H+5$5e3y-c~voM|MNyYI{4{yld6 zcE5XWDH8UVXOENy7*MnRPD94`)m=(h!kU;b_%qT}DsgcymzQxg0)Ku;QAa@(!FS$+ zD|o6a++|yC=_>izn=ya4KMNzu-8IIO13*YqAa1{$L7D z=9W%SFm(At!A#e3$ER}aqSs<SUtL19fa(do~X&+DC*+ItBf7|WK^bw$!e}RGv7kL z)7l+UTcXmwmr4A)Cv+gA6Tv<%qfmlxa%wL{<*^_(-yQmIF~fLg>s)Y+*L!WFEx$xD zfhQ#oFAs*3Y_))>h+5u|RDNXrSHkNfagWQdo$tcj&0!!O9nLcbab07or^pNmhW0zO!qxofcG4UaToR@7}~-df~*pVB|NRqK8}vKPC-%!} zk{IzS#|(0phwmDQB3LXgx;@%^-5JqolXQW!DFr%(qO#S=cg-xXI+D`n1|N9h77ju2 z0}O6ecB`K`lcXz!oX8)hPzu=>wZep)jq0$&>n6f)=DC|utlyi_zYDy3!U&Y$!;&#B zWvMY0XdgFU*`{++DNh~D+77U^#!39jrteQ`sb`-^aUXY7&Oc-pFtHBqeJ?&?9@M06 zg&mT|HyVIh+sZ8)&=3JMNmMpzxKTfA>vc?KmKGo$1SS#{#tM_)O5+_}(`&ItJpknM z8vRPRAGIRa+{g$yrO#vU#YH%9Za<$NRXcfe21cDkVQshb%%XDlAR(uo5#i)=)X407 zNHi!`<3f? zM&@xZQ@=v&3jt;CI;h{YHJU~m6fvjr34}^(X8y4-K$S+HeDz>EHU1cH+C3WRys=s1 zUvcm z`lXREEIi8s=rn`ES*m1FjKTIPty5K}3fCXb&*=MRw54>y_58VIH{TY0JloVanCD%= zrV)3~9FR+p{uzcX2-9iE3QEQqW1Ul&a~?RgQHY2e2Rvyb{m~NN9UTMs)qCk^cOY7S z1)LR(-}i;ac@XJl+-{cqD5BIofJ{AGkjQ0y%_0WeP^x53#R;ONf3oYwBYppE$UR?F z`|eEbWpgc#Uz3j_0`b6R59rTnR|3}F#Cd1 z)8AOQ2ERE56ExIuffZ{l?)4aJ-rSvpZz(n7%B05=fh!#;W$*3Xv-HcgO;qAM+xLa^ zYkzfEa21!Xx{yU=s<QVO+=+hXscC8%N^c57Z?6(J`aQEZgg)K zsuRpo9}oMkD2NSt<-h7lw9jIqkTK)_?zKg>;)*i4xJ*Na?n#PfQ_ET>!4PLV51cwf zK7x{Ha#V87EEoZtK`Z0EyunNxFs9nQASvWm0dMt#T#|R?L0Wt>aor@%u8M+`4e8~?(lY8#UsLx^&LK+Z<3fqEPs@!k? zW&yLx-jNZ0Ze&fJIeg#%uVstB?D}y@+h7&54T_c?N6nmVHQa9%AI}snsOC|$#9&e(u!Q30Tj=(;j&AXr*J~pU&tIb8bVXkli zPPXQj7SjgZ^MffyzVIiPXoT=dh7@&isr*sXgk_!VYa9=T{9Ym=xd{*E!uTik!CPc^ z>~9*Eh}_}pO{7KJg<6m*G_A;9+;U`D*xan3AOcRX`4A7H7O~g3WA?S<^9l)UxLP5+@IYv#ql3&2CS z*!ZU49BuSc`0s*{z}J`R({Dx{r@R^a?Sx2SP%NcVO>Ia50x8aNTTL zDRYEM^F`Wv=0680(1ezAeW7aBS3foOM;VwlCZlOJol%=_l$epdDV|E%|6wMK$G2L3 z)uDpkBkhUf?BT@G{wprtxKbe`^H`@Wfq+=DfDJKf@zkZ>R>=T%?Ol{hVq&gDnyVvH z&vUuKdlXmSXGv{tdRVWp8yL5cJNcUOGl~8m{~_fEhFIp_7GE;C7Gud&|Lek!2CG1g z%i85uG$pVYlyjA24xJD^lPj?2$$!-w$kkc?Z0rn)B|~_}^`7=*qtnNCeaCEQ*9^$$ z8OO+UP@2^8VK)K)uU}q|=W^n{&%+}tq-kalYD7$7l}s~*>AVf1em_7+1~$eA(%&yP zq?}`FWNLDuKnaph8kcNu(c9)=#NF}|LbR@5xSl0tB(q1(i>@*h6j>=5d(*DR7;-H> zy+J>sQTKZD|DG$<=qlXro{Zr8-cMz_RZt31V8jSNr=FCIZ7wc54Wp!&rk;O7*G!x( zVfuP(Vx&0Q4}qkGelYWsCE>GWo1*I;#gc<8JCv~=cGv3j@tINkD>81lO2(_ed~r*x zRCsl05UKGjQTwwW+pyLVsNWdkC0QyNUz&r6$}LjcIa( zfbQ%e`qx2~R#kSaHVa%q^0(1ni8TasXVc0`OXDca$Q(TK=Wq7wT~R-6hVwRbh*9hd z+k^kM5ESMx6`a@3s%z2fCi7R%tTtEbB_ZEl!&-BKh+?{ z?LWCgNr$txb#4F~>gkzt{}tm*-dPS^uTZL)W%!`6JE!y^q`!<;6_plf&bN%+rxDud1iI5G5BuyH53>@1;mSxedo>ZSEh zEe$+`Rxp@Zpp+n}mR*sXZCbZO;I8z&31hf2%&oCNw!XVoDYp^qD3lY3#)#RK&YDy z=iTC4=^_wD#(KuFP5rTapoh&K47B{lANeRxQ8vG}T(Xqdfg0b}I4<)R0X*~F(^1Oc z%kt_9s;dNQtW*w$y;n-#Yl#~&3=x;5leT&}C_-!vWuRT#()rcDULRK@GKM1V)J&^p zjux%Q8LcD!?B8A+L&==W?e0DB8G1AJm2JLj6jDM4RWO0HK#kb(yiL~KlJ7I)SKo)k zCp)>dn|0bC?s-Y-$qv41nV&^Q4ca4c1LjC;1}_}`nSHq08Qlta(6*6AkH)iLR}*%?@I_ui~V z6X6H#$g2CqYny3xP$X`0Kyt_#?pHzDJzQOIoWmk2D%XGZP*1(pv=B1Dnl;?QScm10k8T zj#6A3A?9eE2pqxFb>ibU3_X2c2@A9+SS}WlcQrYp5l^?^9cTk8N?fvYLVG_Put}44 zW}!x!#(@$f;(5E}_uqeGe`*qbp+F z9f+U|27}f$T3gxA`2WM)do;;$W!bvlQLaLy06?%*chBFm_y7OPwKwUmDiR`9C>KZF z!QSo(-aEyBX+|T9MF5!*9_MVa*0)w=-1~SeM(I9;TCC1;Yj9RLRv0ek4- zR?|I=>9Ks~b^S`i>G=JB=f!*Ee2YUb$UwG@+I6SNCqqBqPP4@A>@8Cjn6Y z*MG@q&Z{rT8A^qrZ>gO`NPyvbxp6ta@$&q{+siYj(~0Rik{3bdTPH+aGYlfO} zHW0iNCuxb4B50I(o;OufseF7p%IaYaMLXINJa9W5_Dy9*N zd9{uuFI=6WrUln@6yvb95@*ltB5>ThyCXg{#F!a|9f!jmm(!ViOS+sF2fI*^b%aRO zNOXPXmt_+vm6DmJ8?SG#Jbrv+*A4nSkK3-)IY($bjrSx4jf(Vq;c`BcnvR^(cDbb> zBeax+*q)1+$V&;tFf)!f-ri(i)-JINtdF z?Hg!^al74!abei?Io<`XrbyFt;t8>qoU3GatmC#2czk^1?%|#l zi}L#V%8FE3mW8Hi*zIg;s<$`bR4AAAB!JhqPAa z#t61NuX`Pg78{9CBEP6jXI7rELBmW;6i8a2u31!>6DVXKitxJqRm zR7vSoC0dmBE4e%iZv!)$6Zg??fCxmigT6^A0LU! z%*2N0 zbk)r-e5=Sj&0H=Q#@mhCc!70+S1S(>5A?g9wreDxA^5Ett)^nV0b7|AMV?DX+q43x zTbEWbY2HL(iL$U;;=<{CW|?JPzaF~l1GIkcYnadKi>by4Vx{fa?FK?4%A#-Izw!M1 zOf7}BYjs&IdDx3qJ+d2-eaPi}!dXY(^%7Bfy=}XrH7~<^r);h)6;3CA<}gT**PAYB zQxV5_N(t)&OI)~JuabPY`gkx@C$dRrEs1qEB5iwIW}OQ=@(Oy?P6_;g6#xJr07*na zR3n#+u`74#{qnK8{58gC9F%axKvr6sQZdp>^p$S?1Qd&iHL_%!!|KZd zOx?_qrApUPNvfhu*edUNaE_*H>AH@t7sXIP4ventaIWESJn-q`FRFG5jN{DZc9XG3 zvm+;%=d8O=5fH3o1zQS~RblDmy)}kH(!ISLpw)#yDH6wtR0_s9jB_+zFEyN|)k-%vD`U-DgE!J;`OwfgM;|8WV4?PxQkbhr@x_;g$ScsX60}jI2yq z6=Co31vzJlA*jeGt8LjI_U!k2USD73Gn2zcxe&l5crRU~_fn9Crp5b(X>`n!WD~8T z9qVLAjXJW5KRbF{r2%;)o&>-CB;hQslI51!#XFin%}6ueSbZNd9W*9qM>#>mUd zs~qsbGfoS)%Z;}6Kd5KkO_OaakjJ>h&BZ<~vsTy*UDwd}9n&;2jyDOhDuv_muqn}` z^O2M}W8~kLQh0rRT{YND<3fy)H9}yO;fh>#p=ko2KYym{d-nT-nC8^u0&L^Q5Q4gW zElt~S*zchf#(AQov`+41L{jC0weFjwL)4{XirOK*qjlb~H7nCiOrcGc9EcbN!@e%W zYmvqOs+OZxj9m}>OwN&IF}%G#@qFlU4w~R8X=XKKc3s1Mzvp_r@cjJ5*Dr-(x0(qh zQ0;WOaJk$z!(z!0OTn77ja@%~{w!Jd5BHiO6fjgh>;?RJI-NvZ(I=d-OyejH@8@UE zuPt3{P1G(=w?h8W~ zXj>;P_IVblC!(g5e0cGkc?X@hc&pLr#?Ur_rtw^F7jCmm3J!fs%!O&bQN6>LNbjns zx26l{=Wpc0J+2mfu-Ir=(!%+2!BFYjmf*#MC)0|$DeTs<(OPI(=jew)a_U3i`^z)_ z@+M==EOO(fX$ftM^?_<+uOv#@4(l6SGtnsNqo`tZ$wlON*5N{nZxbd(tn*as$iR{l z`F3Sm78xa4OSJ~;118HTyBZnYS?4h(&~!cBZlLXY^`ptC)0wdCnB-~rlU^?OcOS6U zN+s_*ylb(>Gf(1DmaeAdu)n7X3#D3Wl`3YaatO6;plKyg=X`qO?ev0kmVUR}kkreP zh_UecdgkTjnYL}YySwM^?vefe$mw+6=8)+!DyqeDxH}SDORbW`m@5p<)As}3>SEh_ z_Pape%lHk@{l!Gi7uu%B`$kaxDo<|O24i5+Wpj+Ps>Ukk^ND3yWI=zsvfuBwK%RM? zx4*`5WS*m--S;24oG!%p&MpgH+S*|l*c}e+jz`kG@b>n~`Etd#ZZj4-=ZN!yvxbM` z9rf45YuEGq^33bo3vpV&2nZR!1X#3V+M_PsJ7?_Tu?5bK7Hgr{^K8f`0xSa>?SZMwQ{@N$mPs+6nW-6jhtRz zvBnXXs3W&Gu9qv*I4UO!j9!{6Q!N+SC#__HQZilN&=0MQnn=Vvu|z@l1Rv4$+Z&tM!=jLdUljsm@G+9&??uP^ldz;3q_%uO{Y1Cu3Y+>)?1v(ghn zXw-Z3E=gXo@y1F*YC%#@SF3=KjxC{ha*CvRWJwFHcNp)Lpi#AWGT;mt5v4S}r`UE2 zK)a12%d|*F(f+`0*wciLzI7Pe;hS}D2vB8Y6Fk8Md?VpltXVR((D#AHTT-;#$|7$0 z`6?MN*3kQkuM25Bvs|teO?I?fRS!ZvlQ@d zXadLkJ03rN;P)@TbGh9JO`zWm^nK66$4~V813>|mRuy{&=z34v?L?7QGUIgP?d_Fi ziY!@+vZkd)qD+il7Lo*8B*GyZ<|qUO5QDmFIxYM}P3D`Hw%ZfhL2{cgAmiw@sQwvWKlO6?fBxV9@BPrx!z1U+us1X@ZrRYoFwk~|ZrJk|6sfO?i$eYt zli7#IM{c)YWLFV1M}A#A8O!~B#X9-W+~41GI2>@+ak*Z&oG*;Gk@H!)Bj*E;A07!! zOG=WBf-!Qj_#hFw)5!IDC1t^uho+IS%RDnJ3zyr--F;=f^{o}0MlF@=b>!{!#5B#U z9Iv;x6Z1T8#>R1+RJA2-_dGA^33?|zhY~Zi$w)M7j`|#+#VRjN$9o%$F};czb*0mrtKG#7Mr6 zuImJJd3xjZ^-bilKCmp2X_|2wlbm9~TMt%bz-`lVe}B)%k01HVUq18k;|IBTvzXl~ zP*Y^mJ;7C-=j)|zjU~s-`FxWgFY4xZF`$=I!FfleV5(eJSY7O+SRfr4B2gZ)cQ6I( z4PD>T_Z=~2g_cT(bG=jy<#t`byl$eAd7fpFo+HkQLUCTCqVL)u zT}suxSW#>|MUX7klCn^(!D6$)C9BcMqHe4?vE+rC7bKOk;MDwVt;2bX@rG)p3vaE* zH-;E3mQ0)zHCL7;aXw%9{{4lT3w@`t<4M?PHn`2)>n#{>Y5JCGtkSm^N-S$}PvZ@3 z5PV6TZ}_IA>j%2lL6xb=cs)~%qaF4%JnXW-mP5gDC8$3#xpGR9vRGtXf`Q{vjE*8{Eq^e8?RNKk z{HUG}E7gPnj)#`MJ*r1!-WI=Y+bX|Ie(bES?yl?c&U3k(xLhyqGgeLS>-vGi@knS| z{`R-Ou`CP2b%*zk!(q?ia7WIW{r`i-~K8(k-d+&IqqGdKEsTSDlB z-Q^M~iCOFJ?v7fGRMauiG%Zah820bqpBTrHzVAfnFplIRNpc}b_DikuT9zW=Q`Wpg zBvTf((&c*FOp))>Wf`sgc=6OKkDCwgOtv3cY#^?FucC}~gpl&c?IwT5pnjC9?&NU{ z1SBhFl;Rw^0&|S^{toyzDLIj}p^ysa4cPRJ>wgd}9Gm zHnK;nrjSV#>r`Epe^ARgTI0l+8x5Yq5)viCqTH+Jr&pF~rtccMUQj456pDjtwcsh4 z-T)!si(+$JCE1McBrYJuKxhMTS#%8P=(>icag-v@i*w+c28qYM(%w$I-V)!xedBVy z>dz}M*OgANeyz5OcLbFsMd@}{W9qOQ_}qBr<&K=H;+OWUoV=3W-Tjiyrk^W)mQzwt zto0b{$*JIx3)@zs#?Upp2l?5ObTI4Z-Kx9QR7WacvV1OMu9!Jtf^rv4QIwDu?wn>R zHN8wze&WjI=Uy)3I1_>%Vk#$;1)WT3~uk2&?+*pps%?ngqtz1{qH| z`##zFx0eo^|ko ziP`Ut91aKOWo9>snyhIXg70Ws%Rm0!@;AL)Qc8jYxm;8>*l>UM0f`gsrR{dD8mkiX zBIpO-NTqQ+9=Ah$x7*Qmy|~MPw(IHp9jDVt)nqOE{gGi9u*PnOu5+HD@0rI*zYi<< zC%Zk1iW}g4VF_}%Op{dbqIhcvZA;rryFHF0m&-+RIW#2H)T+|%jJJW5g$y7D*2+AK zf5JOQ6J%^B3vIoua%7sMi+g%{){d^=t>Yj6_y^7kqfEwJ4VTM>+bH2j-pkC`djT0X zp`mR8hr^yYT5h+IX_?3+;e(;K4bz;-NZychvd9%^XcZ4m$|MqP zXl1YBWt?Zcr8Tk}ko@?9Ges^Jc}Rr(+wa6syDThm!MKWVI(;8x?CG>~^Ujd1!`Fr! zJY>t{Jo6OEY2kE=+-|yO@)p}x_OTAvSTnoL`rT~)R@2JQ?iVMjIju=(n8w`qNT#JB$l|yE$K7*&Kh88s}+LeMTMrByQQw-j2rVIax~`*XMbEyD+q$;FJI`!jiSNk&mB}VVg0hj8S4sHlXBmb;X8+y$w5aG^L9FulX^f>B6v02IS1ZzIlb}q`I*!C4XcJlV=HarvB5F)9n(CCDXuC8 z#RpQ%YM_LaikOEtVzj00#1I@)rYsp_#VcWL!DMmGdoNvS(|Ag?O!Jj#nk1^YK)oco zzGp{YA6hN=1iwTn81Jy&;waQCqdY;w7&&|?lA4k4;Be)TM6Y} zmff`$#<*Zp#8Sw{FeUk1H)KpnT&IQW+nKj(=QGndQ_740SfyC*`iKp^6mhedL7ji6H8ftu0LXhlsej_jB{X!c#Pd4m z1Rkff+w2N0N-Qob!%B7+Z7YXzPV&LZVq=w1og!H7b!KVI`r-77N)OD7RFi^0f9HA0 zsK;VW#+Zb&m7pk$&^DXDV0AB7m86QJUtZ{S$MB=yrPej|vcq7=xk`4rnQ7aOu5ZO_ zvU+>SbgjqPpd+X9Lz^u)80ST?lh%NtW!WMLa!%x!n5Rjjk6S9xG_CBJbf<%{Snmne zk*pp}F_DYl>^D|emIu1)x-Hk^$K=V~Zcp2Gn~%n~4K7I4v>xVb+rM5QE8?eZTm3M~ zg;uMu=B#GEh+3s3#|7&GAyi5$7qx&f!*=-zivEqqhX+b2yuH1#EDOiOj{R=OG)s`! z{lf$I_m4b2e&GJ@p8bBHZ3Bnhj(+G=7MxiY<=r_$+cdOYOE*Q%;i}k@u(8`@kUHD^KFuUj*A`^^0_&k zPh77T5m4x7!+XaP7y6;+{_%ls7nfq(|Si6oVxnu(wA{*kxcH(7o~bD4QRw7Rlj}k#pWKOEHRQsA*b` z#|PO(8rey;8dE+^GvB^_T(t~Q7&2jUdxvEZH&Q(bp*DEL{l?FteV}LrqksT#3gTlxb;?@ z=lBO2aa@ufaPP}#kP3?`2X1RcYaWxxqK!4%fhLuvEW=Vt!hN#x>%9J%>zsP6>Vs?P zJ6X<4M$MufKn5Z?6`XrF8di!vFh!U6lDlD6ifye#-IJ{C`D)_KszJv&?U<}4*ok^; zy(Eq99@Z>y)Nw5fS5K}I6(IXA2}a5}i!4`v_86lS2fD)wp~1C{C}h-+b37impKFyt zZ=gh>8nP@RD9EKK3r_q!$HShsZMa-^)RN_ct7;rjDr=ShJa z|H8MYCzh1Nv!h*=bBffk3_0y7o3nZrittI$}~%WoI%FW!CCq?u#*w}eCeSKwK7E+GP^FmB#hCNc8 zg9hixnd+T{5QZAWuk{0*^Jjeh)XSysWtVWdT*NWDEc}S2UT21rA~*zgScy@juFm>* z{6rNkIkt!zLR&d;WXrtQMP*!R5Y@V1mQb8RR=!v3`ppz&tR)sXXreCrX*aNf!2tIDgiQ>nNRrz=g@%kQ&^0Hj-OyAJ0q z{U9<-?}eZ%2eK}5^&;rfKpO(ad3J|A504LwqeS%fUC-`t;N#;X$Gdxxpmr_ZJ8G5J zJ*HXqa5-_go_KkEg$n&J&~?4Yf2Wb>mlvL%o_KzF;_dB?^I1BXbvLpFC{-~n3Y*Cj zryG~^MHl?)+;*0%U9z)=91C-f%u$}T5FAUYlrfT1q~uKF8?1>c%4m6f{J^ij{*{M^ z2ijprXgdKpIwv&lTEwGc4gJvb`SY(lJU()}UHJXC-}(2y{>|-rAuS6DwxGG-MRA#O zh77LpG;ND@cH1dc%~%2?XDJ(HlZkWYwxD?vXFc%qFJHQy3 zLbQ!g7fLPkF|*53-QT8#IcBmEE?6^p%%yNTpSh+RQ-#(-*Eoj0p=&H@PRuzn&5}ZC zeV`&cg=%C!WpLmH4--@2<@L(T>y;&0d=PM~F^-%y4N{-S5TtNz+CWj#x>1pXnB!M< zl?JMcI=mvIym4G+ z2?H}2hTVa?{hp5x54^k{nQkN3+nH}K&k{g4JDl9g+ErENX<-^?rhXP_df(ETW*a;I zjIW=1xvWdz^+M^o?uTmsJsEQIN!WE<(%^kVtws;tMzGz+$e1Xl?Q%&eF-@b$CXJ-~ zxnQ@MCApAdA?8e~YtH-HEy%cr4ZvssQE*VIl9|i)KuD*R$mTsJdDXzzQiyrkqJm|A zV77y@B3TjEtr~QBV~wfQnx&*Ol7ZvBRFf&oZbC+YauF>{#9G-twN0ZA`NE{$n3aYs zUWP!f;_P)G(nRM38kmu>N0L~Bs>ZyOE6y97Z!s=XihM8CR2)`6SY|`0%u50zx$Kn{ z5?Xaee=f4v| z5DZM)aX22?4Lh0;lsvsE4hz<4e6Yq7jPsRoyhzvCcuJLwl=Jz_)AuKyo}bi@)bsH0 zi1&@|?dj|yOLT9O9*&x*$+DzW8_TN?(ja~f@eupc1Ae~ zhTTEVm0{?3czEQ~r_bEq-D9oedb_Z^y^yk)5O34MoD#WKLKDCkj>jYW{Z5R_-Hzko zp2PmgKmYr`d3k;!#VG!)Mv@$tMfh25*NfOD%ZO&(1H@Q#e5P^Zp&=HSmxX1HBwg-9 zAlD4FFh}_QeBn0DJUra->G6?W+pudJ8YifhR5OjWbWLE`NpM;&a2scqRH)9g)XL@J zF(s15QT9UC35MT!`fgx9wB!_tHM1XD+ODB(I}t-QcT%*=;Jx!#P+3z~`yFJH4N7q=!X=Isq zbba9UbYWBoY07omSyw&pQc6sV5CCLk_b1)CT(8${TqX2Z9Vz`EzKHi!M)`O0&t4B{ z!^-6XDA{dpc4Ht$=>l9bx==2pH0y{r?^~h#(HXze2p9lN@#5dKxsbk8b9LunLPX$7?cDAdzxk+%9@0;cGKlB$_8dhr_hcSR$5 zx7Wf5DLd!P>3n8dW`_Nay*)7WJ%e^X(=vgrI3UGEMm0X@$Ti|@!P(4y*V1)8xf)(x zo;aPZeEt5y^UI02WQKl6XnKbIk&hpAG*M;rw=4^kHT12)8&7CG{ui%sQIXEh^GL~= zu50LeQ8`*hob`l8Mr89mvE&JBJ$={HwXG71?S@I3rish#%G1j;=gXC8mM$@4G0su+ z^#Q}(-I2rbNY}QsP0L??{X3sNd}bK-{Qv*!fAReEMBBFdnX;sElbu^LNZjr$G1|^J zuz^&g^25Bi;&BQ)j4Ux@jKjD<#!3{1ftVdnZ&$uP&3t=$XI`TzBGA3nix0&C+eB<9=zVX|aC#ES;O+!J9s}(k1kTKwm7%kSwE-p z=Kk@FTc!Q0Sjg%aQi$ON@0=1UGbugr@`=C-O=7iF>xPus&F`;Mqo zRWYmu5xp4JjQR?!_4;>tU0c2ImSujQ>Fa?MLZEAVobjYN ziLO3~`lYBr(>hPz?{V(L5@oqqs^Igh9-_`Qv|WK|!m#GK1e_D9Z_{>Q*=F1zqeNpZ zZD=SZu}sS*GnRr+g59hJh#9TqjFCTA z+qcYd=6XIeuYQTP!C6D!wKyj`J%hO9LlF0Tt%cXuH@Hr^`jqFUHY!1IPW5{r*VP_grryr_+hkNlb~QRPOKY_^?`;k1nJ`OK5s(g|_X;Q7G6!i2}wLY?ThiRN+p6fow5WiVQJGLrgMec1@7% zl@gg_~X+=1L-COwpoN^Kf)DwsP61RU^KYh5*~yQRZ3nM$CJ>ffzf5=dB=T!&)u=7X$;5XzJlaBpvzl?T0xcS|F#@A21T$)CJjBVR)(p^dJ%iH2v@++ooVJ~AShxdY_ z9>`Fy0Jl{xsLC$ip7%RCj&U?)rPs$=QdO5mnQ7Eo;U9y)|;PFmbsA?!%m+z${ zar;~OU|p^^F4r56A3tE7XSzsb|Mv1q6CB6AjL7;*(G3r%PlhMu5E`L>TN^Gqc3dRwU9Ux@|A8rv#PS`#Mq7NTTP&{bo%|6axhMS!M8cxl#J za-6BUr(4ya#ej7kZPyUIj8?@aaU-RU&<5t|%G=8~3?et)?>as_-f@3-#9$dmF*JAG z4ygBR1gbm&=fFD&v z?;jw+Ra~#4$+y-r3?1G}sFyJ-=yAe(OWOp@dSE%J)~Qv@K^jvlK{r)hxoPtx$RVew zi&zQT?yuGk&CpHf)CC1?-$MfSo3j=fnGa@bp+{*A!kmzfgf63J2Gqq|NhwY6q)S}@*Gt6n6|kg_L^k(iU1M?)iRzIIe1;)pnJlv?c( zNxmA+GOQoEwfk~L-XCi%##yYY4A)CFmxA*RwPbGN$kX!+T|aPtcPAnY7nqmGJdZMp z)Dc9Z9*7T*4|o$eU(fvOUtjq4{e|mwB(y!lPDVvGBQp4$sPlx;y^vgTGOqB>BMpby zq}$TL7@FX*RDzQz?Y0#L-c<{wT8fB5)JG6pAUL5olu`t+iHtQQ9W-t64!`{JnScD_ zKY4uoNYnPX&@kO5&gXGU{Cv23Y0$wbHPyb*_~%ej~xc#XstU{QIR=PjLh?e7;mJq@OB!hN=LZg zHynmQ@I95xG|eJ^HXdsN!_djN&3XF1BUhn$WIfcqsWgMA*RJO)(`{m!BDdRubq%E& zUS3c9_VtO^(~ZlxP_m&3Jz1skGPRIEJ#;5;l)JV~UzP>x`=w&5d`7J?YNeCoQy3QS z-Otwb+f`&_AWI=7ujQ%|)neG_c&-UFI!+Bf5Sq+9&4Bor`mW`CzVQ0`OpG&K*U|s- zncdK`8#;0-lq?Y@&db>{^bMc=2hQg+-+uqXvp&L6g^PXj%4IqF<>vbe%dZdC<#R~F8V~ zGp)~7MRqO5t~-d8mMbmzs%Fbsh`QnveOJNdoCzUlFqlRdP-z=E;A>7S%Sh9B+Q##~ z!*DdMM?9(ptK)*CGI6ZDmP^b8kD_r3DbE<=Nl~Pug5;3!q+DcV<-OudipU;Qj%d6R zRmXkuVbw~mzK_356*XQ_N$sYpTQ6GgWTL2-ZC2O#`F!Kswt#NE7rCc6R6b^qkNMg$SgdiMJrWF39SW!HCV->SYz-( z1RfKqZ@LAYk-e_dOI#V|mvXXbL-uza=)uwr-8c_iq4o95x!pi&p zEU^W}h^ngTNL9oXyThL2@rd`1@ivL0zZ4-&Od}X*o4|FvNklLrWo^1a;+Wk#jMV#} z5@x57+#+be+KsLZa*S>iZfoRnaE_GM?*AYc%y_1zh3k|s^`@CGffU6zl#_+(Rqmg_ z2l}0UKAoecBL0&K(>N2CncXnZwH=qs$h;(s3v`3Ug`T=3I8T73>vlB#kyHvxF3Oe5 zYT$%YD>+NtLdj*jC@@Bg3{B7#PQey_Coh0e!H(`?Rqg1U#1O2}-{|jIk!cQ85)xu) zeM2o11qe;Uus_grov3K%NLArQ2#tO|iu$$GN>LFKfYLD5Sn#z-jY{hN^zkEy!;Y7i zC)(h7yuauEc*G$4=@e&Dnm1C)&-nVOmrGT2d0yW<3*BnVEF zJZ;y|1dlP5m?T)IWHFARqlxlEwO^|EB`QKXt+{M_9;2D?DM?<%JPC`-SgYeBuODvt z-kK&*tBMkaUPn>OHY!`H1nbmNwx0+6kgemNlrrNu$z@_zc%j|)F>?781divou4&!7 ztQYb6->=@FUaKl+HKkEI5o--G&KNx1ZpYf$)*30*YWP^d*uu1o+{P<&l!|CozDUI) z?K?)sCCegC=L)1Kqsldz(CGZRRQXV13SAq>*{F*d-HWNY)vo)BinW!RD%#3W%etI? zmvyeAuu=*oE9B1zU+nAG?_4f7+O}btCgy3xJ0pIYoVi|ZOt(q*LK9C<;^Ua-0(3N; z817QhC|N4jJB@hGm?9tCtjU4S6tWQ}n|B^>oT{p1e3X*e6n=7G2?Ayvd6bf*s?CvH z4LLj3nA}{-X6Rj?QH*8iJJ~gjGyn5H|HCvclxo=R4|LrQ-}RI#-;bbLyimw3R0I3N zp1=P6@A#(SfByO3jN^^VH8IUM`mU3ZuOQ}3AA%B|4Jl@_K98=-;aRPCK59xh9V4%b z&$ZK~nCur=kwj$@#_WR9|s8ornv~wA7 z$yB1GBI7|7Amp<0?F3}H7N$Rj>>0&Tt+H+@l7%FZ(n3lWoWuG6DPdiu?RPXPIGL4u z*9`~m9zW9U_Oc(#QtXv7<6Ofy$;3dWL_yC3EqLe1oHE9Hf;a4T9j$uA?(dIuUBfcX zN^YO9=zjVqef`wSMer7N8*{8*#)x!R#tB9%wlWRJ>;mh)v-p%G%3CQLRmY;n7)n#6Si^45Hr9*G9of%OI;;^F+BG`HT*XXV z3zY?LD~)ze-daqNZgEak3%5cnGjl!>i{b*2%H>wcjZgh7GqSk*}9|2I17E( zG0ziKg)lY*d?{G(F+PYrAT5Al=yyDP_{hVDj|^?g<@82O;~ zu4C2n^(qic@0b<|vHSG#QA7hy!pi1l=H=yu^XXN8jz8%_pPJ*YnNe1NWyHs*FRa-{9IIlk z@j|5a&I*Gq$r92zO9Dz>)a>cS6sXEB6C-h&sa}3BA1sacSiq$uGHmC?aHu|jqDE0l zk@#X`bu1*~A^2mw^7@|2!7EV8;)L5YO_N-FO;GVel?$+1oQ~kE6BSc66`T_ki;;a& zO!AsYW`~L=)=Nq^yfPv*a#^XDN&HAz0f*9!Rb#07&(Z?Rc&ku10=TtK(jH@EoMy&( zB&AGf-$T|ahF~2zS8n6P5)*fadmbJhd3bna7{n`MTp*XqG~aL`Fob4PA@0MGySoP+ zqgY}}eE9g0)8)*|>+=?-W{jm!m>0=XFS%->q*L0%JJKg9If7DTjcg5M={9nSIz=*= zoFx#;D!@wj5T#l$9^3TT+EPm-#+fuHQceOCEg7o{sm3N6FZ--@?Bm>R+waK zmGPPNmQ>`m@m|Jb(dnhV3cV%-=4GNA26?W%rwQ7%=EC`WCFjC^f8g%! zfe#NK*zXQ9y0ljjEaXZskcxyBPV+?D210Pm(J)Ul*V~PkmltAzYAoX{G?ZUHeWdRP zN7&hkF;C*8T6Pj9SQ7rB%TTnY7E`>lqz5abYy{Gi;*Md#}gG{w&c zh01x0!AM)1-(|w<4ue(RsWQo2&>6ohJ;clzsQn=O8sDfwYoS)DE~hHklB!GoA603q ziV4_8KHkfyPw39?e4uF>$t4ShMI&ujZ;SKq7obR~6Vz3vTi11P1X(Y`^%*)I z4|HA7E?N8~f|#k>`?W?!SNwL+`?jIjMZO>H0%e>j`w5Xu%bzc(mH=%f%@JedzfBse zY_w}Mn(HIxGx^I{dF`!pG);@ChAB&4%k_GbXUrN7$32JR9lmLpbU|K9C3uyWcf#r0 z@An)I2l{@%D75f=xp8`X<8r&`#sxN#b5Y%G+@6y@_< zlF}KR!v^_0wZZ8#gKoH`Knb1fOk>e!D+Ed|_+V&kz{qdfz5dw0GNzXEiv5wHT!UNMCoxe%3U?gAH7v~#uAjkLR}s#bGl+qTrc zmqJ?2N!C=nMJrhVOJ3CYsA@20)E|?eB#ET63X*fxVT#!#fgi%~9mStz8 zzpmCSn2)%cN96%so&Re!EU21HP9wIyFTbiTOxhQ! z8VbSrcn>pQi2BZQBw>kpxiFnR1BXKI|QNieC4v@!(pEixNcvg;SXkd;domr)mAY z3kr>7RTpZ6ht+|^V4x9hFL+NX^D3iX>zje!rDl{ODmddX9=vrpZ^(KuwXL)j-rc|B z?*1Mh0>{&thlfXE%yjJ_A)jrB4}oc#czJnIHDXW7h12Q8;qbze3-gkg<3iJRJiVOg z`kt<9wRA4fwF7V7yy0^B#O>u)Dhc*Gx>k~r?N*-qe(FuziJ2 z*_E_7H za>V(oZ!KoY5L;$RU(PXORbpO>p;S`US|~C>6y*~!MuOBb3Wv*|Nz&FO$XPp1($$hu;(R>u{QSZ=&RpghjHBzNf2s;W#~(XXm6YV=iQ=&L z&LWGUvDx-fst5M~WQ0)ocQS>FyMN*mxHAK`K4@Oc3ivFxH=BlcLwZU->6kXMPuhM2y zEjg1U-K3DmtZjxVXSt*rkMZKm!H6;~ku^a;2N7F{B}t@vikM=t4oph8Ec}bWAXX9v zw8O)$>b9)VkI}8r0%8%n_$LCl$1__LTIMOC9%5urF^z&K*A zyn=2iI!uVDQBV-MbgUK-Ivs{Zj%~fcB#EZVnvXcoSz%SD3FURbo`r)}`@}TW{4nXc zmk53lt61mpjiVd3?6x=f(8?C_auQ*TlO*&7iC1cx4r66|iZPNeiD?>nel(r+SCrrP z_TMTcA>BxKcS%Vzgn-o0-67o|NDUvxfDL}7f zrhaBqT+@G=6jhI}Fi&2gyme;RBF#WGntCN^9&ZOp23{Q@!cph91ERU}hkO~b_C|@N z4UL@K0!tQgZXIL2EQ=bJO124M2FzS7vG`TPQI)u5eNmITR(olGjk9IFl~Ky-y_}ZY zN>mV?gXsl4+}&Ro4iGJ_hH14>+i4W03LeZb^AY166#~}=>!pQaI?C5K@oeSvs!>Gd z>bA<@ndm{|=w#!fy|XMY4kK4?dX}cKR%J4aWUPnTC__-P6p>X3X&{3X8%IeqlALe# z-43{Lq2ZIgn2ombw`QZzD_q>K1F2$pk$5XBe?EC$M}_?6bruGYTJHoww@J zh%g|5zLV=;P89y~?#VJd9=Y)F>S?S|R;idv4vw0=QTh62nO3tr`7U&M?{kBOhPk}14Lbg8_i)TatcLTHd5g1%{OzM ziK?W@u zqTEz(cmN3PC#gJ)uKZ(>f35(8uSJwnd2;HKvbnv}3zKQR@QYg=^Ft!y2|(2~Yj454 z_)}sc9W^32P_);7R3>YdTvzc=ZEVvUbf6YpRHVvtV@=8-o9j`lRx;1pyH&B9P{5cD z!vQY_iOSPZHw{i-V#-@ zYM!GSu_=eV1f9%TlzE70hzMCFm?~@Io6k~yl+L>&7kkCb67(wq)5#kdb-p)#D^U{` zmxgP!F2kT{`|H9yxv1se)w@O4washklgF>2Ydc3cKvarFI~{31e7&chQ$j-W>?^>f z7#>DX9DY>_&-AAl6?3>UEh6jh?|=1S$9-^F&R%|bt4694Qz?p;>NiD>^?o{dn$O?t zBSB{EH=M}swjInnAwexEqq(aY3Ria07g^#}w|?ck6Ies?x>m$voRlHz9Vflj2o+=7 zZAAPVpYSS_W8TFNI;)hlT(dv#6%_kZrk&ArqDXe|)vstmgn) z_^z%rW#(iY`_HjEL=n3%%v^``fattCr zbgC9#;B!D+XtqP{v2(S9W|t%QCx=HL@{|2fQGzBkYc#Sb(prHg1R~j8LS2;?SHdxZ zSj31peHLId36?%1=ZgEL(`otd@?{kHCYa$@0^dzZZ^%F;$Ny;o_69Q3?9=>iqMBVs zTC32@f@l_%72V4r$$iJiRn^qSHsXwJ8cY z??|L1S89>+mnKo`K%ZVV8YYv=z6I1+z5rI$rpS&4C|AsBk%Yj6K!!UrN=vhnqJm%r zuQiZNqOXq1NPqKL6mcfdTMGl1qs=+?OzJndX{cD0ITEFSQ^eBG<=Iqto{Aj#9z%Zh zRT+b}J;I0;l6-rs3r7-9K`P+`p@G`WcTKe;$q-vfVC=A0f7saR4pJ_EAOHv6xV>*2;5&~DKY?fb}c5YLqjxsMiavBWzCQr z&gjr-gcCGL$e{fA!$>6{*%{O_RL?n%WKANmY{u$+kvKROX8Gbk(&WSgkBIKD2HipE zc@`Z}JK&Y`ro_RRMPzT5Ta+|L)jD^_+tE~KTUT!|d((rY;3-@__0P(mwfJPV#}3|v zLd7)wCZpt^84kuRxljRh!r#ZfjV}G$LEx5jJo#z@S-C$dXh=Z>XG)_-6rSm<7(7FL zL#~3riM=EBTzs^ZK05MWxE{~*+5QRpLAM!U-a%+BA%8_tC8j`1f@{mmrf>9kj**I6 z2*&G{7fYsSP5wI`tyAUij4}3C?|;holA)4o zVyM0BJjWEGwBoBV_h8hp+ffK~tm;K61j)+Pg@uDt_@NYq+w;jd`9*4Dkw4Y^f{$Y9 zG0NquwB9RJ82^)Xd^Kdm`Pz+tZe~AH|V$vnJQ+B`V*nQqxS?+Jab6y`3 z2`oOa5QqPL+{*9(S zcJwJITS&Lr@sglVJDh*nJ7L?uOv#pBc?;2Oc~|Z&ou@%|aLTRx*d$y3?6PS_-Swcz zZR1@THO1S4GrXzdsAn-j2PLlU53IdaO0LoWqQwSN8l56gsxX$wwlMz}h=P`agPyRR zw88$mw~F*zgq^VXtm!(YQ&rm&VexU1kH{npVV4uWMQ22k%!FRs8?WG(G9YWEfcZ_; zSUp9^bF8ejHtIz>%&R_alnfJ2Z^BE!#K6OEAmnKSn5+~*MO9eg)#)5RI+u=tb}b|0 z)qm|1ia-Ce`WerlMQlY}qMD*s)m*1>Dnw_I$ub027_W9w6|$Y9)rR<}9588#RAR<; zc1f7Iam+GkrTOOf=@%yz4j?*KG@qP?j2@r6^%7GM;8Bf!Dph^EgGKMzPAi}Xp;$bcEt_sD7=YpMhu5Fe3+g_x?G}vHiv&H~gk96D0G`qehaIo3PvmyoNcyKj`rr4B zGc%_OEWh7oPxRO}FrXj=)g`2*&VhJ02_B9{LtJD3^l89r-u4;3NNw2S?t~q#>3HW0 zV^bwi_|0#jIz${dfyHDf`L6=1ImpW&uo+Q?7t)-1xe?13P8#xqcBKJ|S;k5*#`6T#+!7>Qr#VsuGiUACfq;;!g;?AhG>B7@LE`+hD~ zt?97Td@xAAe^8WH%G~@o-&n1fMeIYSlX)g*YTEZb6RM5sIbtb1Y}a5!>rW_BGf9Qz);5JCt< z_Y0VHhXhCdATfDyZD6H;M87k#?ltuA^ejGygxIcU2lU!x;>Gimq;MglT}Vyx7Jq==4uf9Bus~wmH2I-wH*hi-xl7%2^&sc z4jBdtfrkY3&4Jl-3Ud2pk88ITneaHDyHw7%T@`(|WT_p-PJ#ZZhGlHOuNU& z$N@JwKB0luHaJaRe0L6B&=<|oic`sAqcV>*Z*Je7J|#>MRpx+Goc?80^+ort5zKS( zJw0=OWvC4p*Yu)(Vxc+=%ExRuNyhczTw`p69bz`&3fNFHA*XI<{@BrY=Zo- zA5LM%iHn73>p4YKI}kWjW1p_@AsEcM9)`{viqKb=mjSmFAX>68wM|z*duzq0LR$iE zNo|uPODBWG^@OsG)=>oY1AV-S&^_hW5^p7iz}{!8@u;b0PB@TUVw*+kBO)SdC;C?5 zZIrul3F`SppHEBSv1D%xN29*T#@egjGHi;~^s7EjVQz<>TC)j%+lyU}`Axs2`{V3# z(AHS@XT|&x^f&>&cIrjHD{s%(7nr3ai9$cTDL|{z9lTnbL%%6{whgySx3OqnruVa> zz3JKW+uGZMxWoJcpVMK*wzol2R@F9H#UpzFNyr_5D^VZ6>VCT7=tXaCua^HR3Kz|F zkd?E4>8U2sP1R~#RN3KTcqJmz(b)~0cwBfpvgN) z$^qTg60ft*0pl;XX6NR>#9_kxy}$Q~K*Tx!2fyQ+z0z)XsXXNmkjDuemsP7An@mG| z5GU5?_)l{tYRMS(-5}@v&Z$gD6H~{E>*q?4Vl*zq1E1J(EF6L$>mX)Ix-ik% zG&5xgW(RjvMDwy|r0&NR3p>A+T{WqrR0W|PTQdmG@vD?{td_W$``i%LWxcnP8SX9{wyG-8X-wSp^o!?EE#4>9KQy7TkIOicYrYt@7Zh+Ie ztLvb@knF^%_NYWZ15y4RCfsLhPg&k~(q)rN`evALxF4*|T4m9)i`Q_C=;XI>3m&R2I|-3Fl*4V#3o z7gXhCodcIo(Q1AVofr!wmj+EZJM7eJ$3qNQLKF=g-g*%|N@gDVzz+|NfLbd?^`@dr z?EJxF%?o<$-miZ-ERNgv1AcLjHtqMng?j3Xl~VG(aop_+kc?_-mO! zUKI3NeJO_ZzsxDmUxH3fbzrq>I%QEYG+0)ZW14J^kH_Tr{#*89JX7!c&(5ERlnu(S z=PgC|Qd>O)o^?%b?v5`#%Dc_tlf`0>(RY(C~+*&7QWZxkG0m(W&2O#k@n*zjcy>T?Ke74Tx_w&1AQM4&PM~mE*lMU){8RVwB5N(Uny~`* zQJwkkeQwS1=}PS{M=R|6$He^O3k9PZ^qb=c0oTEfgZYDr;*i1AI(XB9ARV5(M!m}G z`5|_`v@#mD%L=yti1a>Y%Lf^^F!JHXuE}w8(sep9IoBn2k$#)LkE*28O9hp9kckOQ z;x`iX8K|y`{Q0x&@qEQ)BEqYI@6?&a!({VbJhleiOuEro1b85iBZ12C zjhZ_1GKsPj49dp_Dya>GgS>0OnLG-|1nD6`Wwv3sYVD9bz^O zV%P5-32$iT_RU{7#BMP`W36{*?W$ZT>!NJZiK3h@>|CrpYBkG;0x|5qnUbQ7AuN7- zsd>VYNP!HvN{DUkgO)U0y7$4>@#UsCq7G47E&~{H+-6Zf#u$V#y7h zZXa$101_|e>ye_RW-ee7_jNUR>+${?fI53f|%4iLk$F@)*|NaU@oBy6K&t_aq+jISZ6T^UTHi<8zpH}XosSgY*$fMuFvZx##&sQ zs*Ot?g5LQ)C#yEJI{b_AoJ+p}e(<-uUH&K?0tL^ts!z~`bt-bDv~Khd z8rt#A;{t==v`Zs^OXarm$FmUea2vF~ciS^R4BV3fo19&VWl?`h4(w;!fq`A{{EwwW zuipp$&rh#brKQ>C0isN^tf^0Am0Z%9Ks;DZ8C87d3%d=pkKLE;`sOj#EJL9s|L85{3+5~pY4`Y2B<+gh4=uwT~6w90$2A`-^V60HQBmwI} z#24!3`Wli}W1@X%Lg`sMv`z~93-rd0TP5ZJ6DgA5oT$>zS$V_Eq=R1))_FH8$OQz- zZ}&&z{#or#BeI$xsU*f8>T~Tbc3HYSIc@{|3QB4K(BrG|ke1WP7h`t053AV98`0lF zI&rf~|JLmo-X7&(f7lprc@E~uC~;w`s&y%H;8Den#>G)*F?il45QR;uopVMi%K^u$ zLdsE3R}*8Sjx^XWoS#s(--p9As~?WFX~XO)ppK_v0t`ldMF3hY1ovy^xk}8f#qYX3 z^b+{bJ7(^T6bYFjN5gWp=K4fo;JlrcNl;i$o`qP{a_ot6g?0X%Z>p)Uy#ni?GAFYvyHg;Sb z%n@>~d;QPt>MRg7EDYu?AqmWuyPp%{(&fd3g0xuDQcuOVOX=U7!M2N48&2q$6&+rT z*HT@;!*fcSB*rKh@Y%I=v@~8{f<|^(J4M-;TqtdVr`1|bLA7u1YSZjD)L%QfX|O>{ zBoAb0`(=`f!YVl7vvgb)`OOZf?+^-3vj zLwYp^sax+#0g4%eSH=ln!Uv;eG*5@tKUrpN;c1lH7Tg8d21;~ z8X2keEZ6tlHPFA=_Jho-83K ze9oI|QWZs8D}MkpBfu#||>bKhqG9J?rwH9yD;=}wi zStE7-Y{H6?=1Ufv9R%Gsb?a(wJN>l@%9z5e$QFr6S9&;w6u=P8oOk`{ zt-#v7s7m8WvBi7BD7(L1e4U#qL6hSjbqI@?A`+2%F>KWJ{R_EWt7khC@7_eeirxgC zhCF0TnB<34?aPw=pWr~IF&|fuzn`rkL4V!$(GkwX6k+#BgbOTUVNlF6T=`|CnA_ig zr<+pgvpwYXzw38Tr(Z))fP*tGn(%Oo2xTtrJ3p15cl+7dzPa4)+Yxx3h$n$S@B}@b zWdf@*i4P+lbOv7WS|xJcJn!88MsaPzfaqY076vV+5T*dh?fnaHYli%|O;Lh|s!1pp z(+}SB#=5sY9l_^`_xFLYmWQ(?o&mx0>+a_?SV70sf-2J))%LoGeSc9Z>#d@2X_@6` zCcEmK*)Pq;>kJu$!nc=9&^R_ZsQ6a=38(t%nr#1`mvyG2ca5GnB^~*}mrhyLF(bdh zq{@JCRIO^R^FE1*zS^S5DTBqDey69oJ^ml#0xR!Vo19yWbXTp1++Sk%3i%zz@?fUO z&luTE=)TNp2q4>==^17v7M3u#M*+2>s1xPljUN7TmGv_28kVsts9N?|(Pe1jn z-VL96*&5O#I{@o#SbPy5f; zvu7-vB!apbF}J$t;)1c|$ts4|OGDV~+iS-QTmk{I<(~%L|N=zm6CH5&pePELnd2B8LDekrKxu_*VL1{lf!1?-_k~Gdc7g zZYK5?*V?*5;wz;2@Nb~%IC$}@4e0g|2ms>sb@k@51z3$r3Gie#Q_h|A;Jus_sVGaf zeNVT>yy)6(6E;Z0~tOfZcvn|HFuA3uz$1}OX6#LuauaTCXzmhmeAiqIlyS&y3qu`9;iwQ_r`Gu6iXFtEZ)6fA5Kofg<(8vL7x0IeE^CayVk{%qYY^g#;VE7_Y|a4Hv1Z- zgt-fy8K_X4q*uXcUk36%a3)c`qnv0EoaCQ~4KFAN0>tCAD`_Rq_-riG5gf!?+b%7E z$vJOcsY|Z~X|5`oD)65-0{dg2FBK=hZgg1-5+j^Htj)S;{NWA$WGeMyfoxmaPMy(b zMb=~BXB9F)S1*cLS(Txl4)emF_@m$P9G$GxTETJf_R>}XiFa1z^O)`xwrFE}`OF1o zxq8wQUAZ+kW&@bRwKNqx3lXzvb-k#E0@k&+S5n3tqOksVA7Yc4V>Gw7-Y_1bvfD@c z*5K92)Sh{2j@}VKw7N2CD1Wd1sarVeF_?G-JFT&3e>*oZVyI-ye=gy;XRv;Io5_>c zon&djFe^Pa={{6TW%PU7dGQGZ* zcn577(v9P`6t5q1VI<)VoP%pwTA`gEMB1`vatOX`-;V61Ox2iK^RQROIpb-iWjHV)ww9<^ke{W}s<(5L zX*L;CKG@v5-4%`APQTS%tIP_*$!B3FXCFQ=PFBh%kf~jp?IxYd7xhT`pZmBD9i%Hl zARPI(epShixM6?zxkm)3GO|w0o1DjMrn1>|Io%`Q#`RfT9yc@dq=uj8PF@JoVHCBq ziHnX1Buz9S6}r5BmJKb^=Q*w7bhNhbK0UovU-FPj=%7keJ1-!G1A*Z&bVyN462kLs zdQ@{B9v<_x9b3diHRG#q;d9wDhBoabATn#bSa1iZhUk%sQZi*aZ?!{ees$v@+Z0%M zr0hClvL%j@$GDFJ-uUiLY7L6RHRD45_lI%3nelWb6tC8KSN==3$@-R#y8AMFnesHu zI?Tj1nlk)4OCi12Hp*76yHyU>&!0((j04wqY~W%V(lYPR?@}QN{t90QoxHP*ZB&oL z&4q8vYG_CAcV6WifcvBAPL6`j8#>qTX=8f^~OQ; zi1TsL4?vAQ1L$SDr>DuHJikmuG~!DI&TZvjihBYonKrQzbC#VQ#=R|#hyRhUbhY;H z-SN~P0jP&wGFi&H(ftT^j-pGFY%HdEHYM}qdAzv;3}UOAHvck3d3X1(g=%5#%ZVb_ z*F}B|1Ai5Wc#+VWeJT#jCeWObq?fjab^~P!Hsf4UMjwG)(Wo|*NKH5F#gOotq$>aK zjRhAsKVTFu(&GE4+aKP3?+fjp@!qQc)J1i3cF7U?yypgmUoN?g!_}rs#*5Nk(xFfs zV9eqc<>#b*1?U-Y&aPPP{3@Loh42r!rG%R{eG5?z5HhPh=N9Uae22LnO-{ifko)hD z;r449zk3Z7Mi(9_NHfi+6;JX~U4o;|-DsMSgs8B_|I-4b!aC?Bd4bKq!_|^q$lab> z(Bm1HYIm2Ai7SbaZDwkoKGS=$w80=937=+4|^-$@;R(^~X$7#CGa=*-ACrLHnOl z*+uHL`JlhJ5KYr6rnx49Iy2}T4~ZJjz3AyS&=FSe9rS}yFbB2vP}cVyhp&9OkFJQr zL&-;5mX1u<#Ys?`GO}?)K(=^Ii*Xs(jOOOyz%71rq=Y6l&SAuV8aC+v*4!j1_P{xb zB3XL`3?0BqP9?Q$E-JvR|E5wQe-CWtuRJn~^u-59I+P#FMfIG(A75eo`$0R^+d;Hr zgEj-NgSMp?m55q#E{Lkxe^Q7KU?XMP#`a8SpJ4-?{rGsM!CWJQkz2ym2zZN1F}Zb( z$aUBl<^2xTe&o-`WHjnskzkf9(>shdNU0^399|*-?upwro;JTeZI+fP_tf9$pEc8b z%sWh$CTm{eR#nd4E-d)MyYS5Zy@6A&jUW=Mw2K_dswmsU3@jBEXS=sz%pgqxYqWST z=`ALFSwu;O_w&42Xm3f3uf;@ApKTT4LJ2O0@vi)-c5z>ACo`KaOx#RFU|BCBb@oJ# zg>p!6k}R^4>j<4I1|NWI@Ue|Nj^)WC6U4FN+(rwkg{3{~en8YKq6~^=MaQ@+8`}q;; z`QGeVx8$)Oh&}iKT`IN+T~O9fBvV6$;})~N$8pcSKro`ar~y8GK7(xpbDKsHz*x_n z@M#ZeZdGQrH>S_$!_I!Y3Q*bGeUEQ%mRZ&*%$NkbJ33B0i1G&Zyh>90CMIxJgNb<5 zBk7Nij($5gJGW3iZLS(^@Sk6tq!AT+SVA^F`L6J4*imvVaWfKrJ5I$Rv8&tl zZ;mY8f#S3a+^I4rw(-v(9b9~OekW<@Iq@Q8U8Om57VL&n{2!|p!vz)*f$Ah?g2~6G z`LHtAcIuvW6NXQ}pAwswlKA6?1xn9HpacmO7IGM5jrsZwXt=|#5D0`C^5@xN!nJ6m zT|&80K6W%TAxmMI6lVH85>IfC0)Nh2&_rw^o?_s(x~pq%8yZJ-Glv?^?uL>b#faqP$ydI{x@nCY@#v?+vf_x5rx^YwU#@KPU}3(L2VvlnTDUtbU2s0 zZi36I1zz$8&o?&%9T?3WOUI}Az0pzrhKw|7rHUWlS5UlOY<a z*Z&##@M_oQJx$2g)lshY*rL?!<@qZ>;CaJbx3qe;TnZf7QwEnMfeAtY>{H3&471Gz z(r~DYqdQ%egcAC|-Jrv03-gvGz?SmA1_jj)(=6mZZ8(~tFvX8J+0T0D6cES{P>}}J z6)|Qg1XCwW#D7dXCEeMk*WR)Lua;J3l>bGYs*~fkFUJa-o({H7Iz-S9Aoo+E8MK&>-c7Pp#$THzP2ho zTf$3=ki!4HbCsX)y5k=H%k<;PfCtcxNE5k!A2Z1DL}9^|Qvtv0eLIR_nmyJO+swS9 z*W$9&ELcHy4#Fr&mANO2x6Qb1rehT|z=E?U6Bo{fR{YWV{x11;he-d-Kt~z7_I80A^w8*svvfDj%zVc|E?vUH$$JKA8s~jZU7{9A42*$=QJq)^^0RJMb!#! zWWD9Xa^2>{RPCQ(iMVci3Okr88L8j-6;~**liL6^poG4@ZbfJk*_W*kcUKUz&_~@; zH^iRT`raPuW+I^7Jy~+=cAx7jhYd11#TOq0LazbgKcJFll*=O?y*)qe*@TC+XG`86 zM$v@agq03I_nJNVT9_&h394Fal0>)tfR5U7hBMpi1g~D9sLvVX`A=jM!q_UeI%B06 zeM--)bctTBeeq(SfV1Y}rHl-!9LmH~D8>ybXk2txm>pb#=i=pNKlmSiF61>qS@9c^nj; zsq1b2v&+*k|E%pmt**9IwI#G)1mqc+$kU$lbHZKZd-G}a50o#FUg^HB>6rhu+8?qD z^9hF~C&C;u$%nO8tO$A8Ff4VZ`sxRGBZN>ljDmuZ@c-?dR*lZ?vlj2>LDUXN%h?za z7tdw93p5jz-P8d-O2P(VY7!=yQR)<34}+p^IvxR481ebch-- zbs4TXhAEC=fuFnH+@yadr0{{Z!)HRrUhUJ4BPAFy_oKVjqPyD$R@!vlM|SI+&Xi2= z+$=(7P+VRRkSvell%pKxV$1^wxMh>1om?iW4pV3$wN2M1Qbs(l`xo^;zWOiwllN?4 z-fW%4A(ePujz0Vwbjl_0zBrXpH=o@?<;2H^9YWH}zIkA!r-h={Zef4uPTKd6kN$TLxr@rbD z5@TXDb*m<|N(^)(elewVQ8sP9T95*mV4zleMAS|wRr_p0=BdL!Ol%TUWb|B_jlvPFsV^GT!kbj29g$}f zfYYabzWyZ-Vp|-#KP0jOl%}_}$$LGq-E&{8T{r}z>>C++m8HWx^@uFz#)@h#bNL@Z z=T_Po#}w${Ov90EEWmS?jrmYDxxd@RXz`C_tO<>y6PGG-s?jvTSaIISpS)1fk4TgyN z00tS%b#^uAtg24ld_nyRo;YymX1wX%2%hMEUzWpY#bV? zAlku!+n|lT+vM}T0#H#OAg;Tkw63pNrc+<~6`}aZoNFO4)r|AMPU_+uq4V3eJB72Y z=2*Yj6k~!t0vH-9zFzt13gegI+H7>iz0WpUWM1q4no1z_Ui|dtA`Ljr=jRCN^B_NP z{;IZPeQhsUD@G0>=}*2)3Osi7#(qsBrUY4AA$o-Z->Qrgy-M}`vzm%E#g>A$*;%{S zQzReO-&6_woT@T{Q|S8LaKvcbxF?>T`mID@7#V3}`upNlc9&iEQr+@Jfy6jg1{`vJE6;6-OC}5~ zF?$3*JX|2n{`V&-FJ3G*aV=F3IIH}1>_h*cj$O9W-+VAq%=>|mk4fF4OOc0bEHo4t zZ^2u2JU^N!U3S-+9AO>+@X=Ildykh4J1Ts~3LbO6GrX4lc*9-v=pTh1m~UK+TMERN z{b>F!Qd@PD<*~oN(ac*#~Svk#GJ3^Q~;+;K$jlDhi58x`=h zgt6-}$b;7Rwljx!?YN0$Pq^}5t7R~z)uGH!-K5vxO%a_RBEpOfG?*ka;TF#iqZ z7h?`TM>!zhO+F2>APZRO3P$iclegix9fj;112;aRJD9no%mH76NIuR_C#ox&lhPI0 zTuDT34#CRn4xtNuif>wst9c(ytEq|sfJr`#;d=(cZ#}HrjDNOv+JrJB-nSb;oM?Rd z16oI}7;fzq?xJSDS7tBxSx_kD($I)fzxj79;w=0Y2vef5H$w1#00e6ufxe}(#BukB z0-K^WAi?z+iIpaU8sc>#jz>Z87tJ4JAEVg?GqB??zZD3*R`rg3=P^e+2&`QvlVZJU zX4Kos{67@^_hB*`>92!YIw*o;gMUQ0-OG6QE4ChLXjRki)++u?H@~3C!#+@_g5OyC z4m!L2igWmzJn<U z^XM04KzvGGIjJJNlHl1udqEfxqK z^bJlXtpt+Lu>5(cOnT_k#Ut2wNFa){H-ruHwWQp}QKN8MVb94~?`LiPF$F9I z@X&X(P3D;P=q~HG=oCiv7X)E#WDgOW+QeT1fe)2!so_;A#TUQhD(VymX7V1P49tPA zOD^6U(l+$a87NVb@<&ZPrT^%TWx zMH6Pe-@^IeFZwyuS8--QPu|fPIxMKfy*Um)7ifSE&XKh>52NqZ0S?3$j3ae#biob4 zjE#FE9ZYNhJ!g`nOG!F7FLD%8>FNUB2um$)4(*A{u84`JsK@18ifQ^&>b|8}`E~Kr zU1N-uX+J(C>O}NN$IZJ2zaWyXl2mz60aZt9uv}$^YT6+@j6HOc%%)CROZbw#l?PLQ zJ|7hSm7eN9pMMBKs;L;r{fJAKJ7TIAUo{Cv1XT_e(}noRFFWvA1u=)H$~l ztaohQexvtBfIf$7#us1u%x zZg!Gs2}Ex0F|JqU=g*b%h)p+3s@vD?MEZ|4icMdC=?nYyY(=bB`{npRt59$0jBF4~fff;dMj{LnpPSzr*!o{@HJDyE zJs;G%RgxIVo7f~IfA6yan-Pr;Im|pK*9}d3YmA%a`$y)1de#L^V%%*_OD^a0Y|H7n zi>Cr>e=QtDrf|Hs!(I`)6aJ)vUw^{VN|dg^obnCDu+>$z!dFB&Pt7NwlBJr5m`Y?j z;?lezO^%tR#KyEZwl$`{`pz51Za3s!v?nfmAIMTQa7B7|7`1$eQ{zyl{{1~PD8oOD zlk{3T5dTBtgGgr5;wQKU8E!MUL)0Mj&~5^Oz_x@njw~xJF1|(sAfIdN5kbG z&SpWH7HZ@$M)VI1O81bo)|CoQpnZP+7TCa~QqR%uv8eah;wIe)$#UX!TcQd z*y0x1POIKxy^4n=VX)`Fq7AL}iP%>0)_TMenyMC&uJAfNsWM+2b^($4lE9H0Fn1|x z`+gWHI^`9AUmuJRW5GnN+=p?pcnn?*!-U0ZiIP7i)DsDw6F^j6b`1%}FDD+X9h94_ zTjdvp3x5YOC)>jqievbF0-Lw>?BpvyM9RF>?!0{mbNcV&wES7a5Nr0uKhh8&7f{t3 zNzQOG#{|;vFmWR`+~E#+%}Ix`{5{R+$WS-9U3x^FjZ%B+;pwn_eA=UjY{UT#JGiCP z$@dJV8&kYUkB)XISaX|Su!t_p`m3y>SM2p`pSd4PY*+0{-|Loe)XJz->d(o-LNk1 zR@3MYd-v2KC6Vj`#svD*PN!-qeT68VjU<$-5KNvMnq z%^lAtVM~wHmD|iKx0zJ;gPR{;Wh@%jH!YzxnyRciPdF7HQBH0Q`_J4RvoY-`XdgVfvN)I3 zRJ)dq2j%QTWbt=1S3~ayR-dj!a`WoHz6UZ+8*7)$= zCuMZz>ia07aZ*V(=})XM$rN!sg=ij+5r3Bh#U#>u>6;!Hdy6?GAEcp}1mc@+dJEs$ zTT0v$_w3|0<`FBGE?nKqEbknU}aH=^{4}W z;x1~QvkfdX*FSxH1OQqO@15OVf)+@BR7>N~>D@ojpTx^_w&-PpeuO3cw9utS`CCbg_vOSP z<)?Je`i-ljFu+$t<|9&6;D|@Aa@C&RMI-hHu=@YD(kU5WMTNi}yImc!5|j9m-Xw+S zv5)IfUoX?EWyTIFyvRDdaPkFf@cHjtjafm{-VAe~7-Ni=ZD^}le6f5RE;|>;p^q~Y z3T)FFs;P7<0rgx=^SCiT{q=^Y>c?M}sJX+xjW@ssQe{6;fyaIhxhq*^bD96Xmh5>J z{%lApRQI#QrloegUfkR@3(e}E;;f1HF!bEEGOc;A#dxeD`Tx;$)`kd$ta zlosg*X;?s{yQRB3C8RrDx+He#F6mf$g+-8VmK0E$-}C11dFl zF7~*9+C{Hw+XYbl1Xe}b`{AbfYuXcDOMV085M_|MeWaIyQVy__)*}g?9n$^&y&ebW zYd3E|pelyTNmnit&#)p|#p=h5%v)2!b{Ll-Lp7yi_S4X_!cXB@;^jO=W_{{5$BpRvlVH$4m;{<#q*GUtIDNJ~bP#CFb zDDk5Z?Z`a|oH;aAY1d-P>OZD^FQKP>Ge<=9b%#y=Ebb zrW`6rFUY zcI#}Y(Bs)6{H)J;4GeFc)BEd^vnz7oJD~B%fl2Dll}P~?{M0W$qoeVJ@;?5NV5t{0 zM4X*nrWj!wGouCvpZ{K!SODuM&AAGjX73$Hp6t?7+`X1kl8w8s7gDHfeo%3$&=%fT zo|AZq0fz{tme)5Wh<%-EQ`OCTdtj$exCwelZsBrN#C2e5V~*Rp-5YPg__X+OrE-bd zYrZ-|{zV=@N5EiKWnjirg7%gjTgK1XX*_Y*ezNuu-K8(=)N{eTpzjGXbZ|%H{M;0; zK*}cO3}a5X=UWN&a$q@x$iAA3_Z6cdAHhe6NT;4QA8c>4b@QijBrCEr7|X!P3=lmB zqr{%A*4~3C4DDc}NFG%FE0fP}(+F899qX5izx#bLB*C;s0WBT>ZCSOjh@U?h^Tv9p zUm;lBZqO!u&8@@wL769!BJ6xo;*| zI;K+e)=&nOfAVoUEh7x?<2L{<@Xdt{5Nf!eVEL5U<97776?-7x<4o`9|GWUxra)>X zU$2WfO0H)btS*<*SarekX?%_^YB=UW_u$HhF8bpa+J{D+IjXqN?(QkHuIi5Hd;Ibn zL4!g$Ltc45Y$N;FF1UoV?V@^s$Wzpc&|EVPlS1IbilCFJ%O1rk3gQ=`h17CXPsVhQ z!{PI`aQWsG`>P8jwj{X*qP_34I=EHy?d?;od4x&}2Cyr4I$zUCTFJdDO~EXf{w`fR zJ-$YBDb#%?cVl0qFIZ7Ox$wICHDHyHjE~=9geHIN_jT7KXWZV3oFwx2z^>`lA8G+9 zHhyKY%Lpx|jbE5I{`?pgL|jrjt&4yqwbvSubkMEEF zWaA0Y$9X#+RGcntIM7Df-rik?^mhlohIGrTvC|S3O7Zlog7p0*?73u(6;x{cl&z}w67Qxm}VRZUGGR*f5nmu$H_s>}1WS4mFs%P3l9_45j~ z&2PUMF;(T7csCbuW7S=bOcu5^*sWVfN*;P88aqp!FkA0Vt`Xag7$FJ(*{g?MxW2F6gV zhPHb%%G%3|lz{U@M$$FFXG9NDS5eXimrYF>kYC1JpVjNumiP{~H5yr2;gmsmbWdRq zeB2EM!RVYa4PIN~tO9ISn(M#Elt40c2ZnF~Pm{WjN%IPngTQ_PCOc+~Zzi%|lmZYq6K$bN>bv&D+e2=IB$}rTaUVfwd zJ25M1jf0-u#E|{1`mCo6|H!seO)?u@i6&YFKTDh!HB_B!%igVE;%?WN;jHVS#B4Pq;Q5Yuv#F(nfvrSi@b9u5Z zCOogmnECUaxE@w9uVktW9~*ga%fxdU>LVBAe+VfMT}Wb|6Gf$KHE)a;*K@=;=(V$}6QA*L&8O(10}gp=KtZvZuG6+UW5{{p1rn;k?gn>fA# zMIS(B2MgBlH8TOs=i=;qy_1!6zk!f+_X*+R3ndyON>}Hg!wdH`0&r}q>7b}6VFeN{ zefknY)>su(>C%sOdFBw}N_Nbk<5yWen+li%v81)Ua-fu--Js3)yx%7ENN9B`RiC!( z4o2E1*|?l}b8ctG4QdN_%NGzyGM|jY5`~#GGNI?$J0FVnw{v26;O?W5tg1K-2x2R6_`FAiki zAyuJePLw$~RZDYnQj~Jb!Zm3&LwEn#K5jfMa!KOr+gd7BTX5)Po4Bc*|B7`7Yy)1K zjf=h7`=pRN-TzvtJtSc9n0Vx@SfY?R0>(M(9b=TP+$B(D`UF@-TnmF(!&!7ZHSP1M zVyyR3TYJFv`GL5T;Cn8MW8#7Ma%2Qj0QciQ`d4$aTxKYoalfdAVFw5`uSETGTHeg1 z*;}Q5&aP2uN4+2vk3qI#b{Kf;Z~T>YGdFR{pgl#0v|5Nud^Ju=_E%0Z$L(IxQ1Hnv zf%Ib3XXLsGRX%D#|1P!xwe&iDz^|* z-DtyKjT(uQ^sjMdBHx3bhTC!E^6eKLka4+Up zB*Bb`1g3?w@*i8J9}YJTVg@F0TI}==vF(Bi%8?m})3ux1oodFPDd^RDFWLWW0Q>eo z=tj%jlMSO~sYCKP+Z#U6fnQNAZe-~~8EgsOG9`QTEx+i$d^Qx7V&s1C_DE~~iv#Ki zf7HPIX3{+urm5eT`NwOiWu-q|688@x#56=r63q=^-R+gxGUXr7?@s^oNzu+^nPDfO zie#sQuAGRa(yY0UO?5OTb-}1b5tViPSXaBcQHLCR`E3c`c5+L|w6?{(f#o;v#wbd} z47;!vB!~vC4eH!(ve!!$q8@RZ<`N76TpCV-NVNh9?VG)(p!^yqfQ~9AA@K*sB`vpl z>`jFm4f1it?xZfObJA!hBI*5*(moB?w%pr)l2_c<2+KkdF@E{4g6ZFKGqw%SkTZ8H zCoox=<|z>nrB4o-u@SYTx90AVk?syLG#v-w{EMV;&Hu!<1tuvS3;zD~t!iId!$>rS zRH~xTj}OriWQ8R zn|Kf9xS>==pwx+6jX!FY(|(l=WOBI8ai%Zj%5VlAf0+OG-om_9lxc4xoH>Vum!N5? z&1pFNHgpxH6-tHm&^~_7M-gtWd?a65nj-XJX1<5bO}{Gp@E`j-ekUqb8v&F!2TT$D z8V5I3nQHqh50bs*D}Oo4gYJXd=Wx%bWvSD(i`&X?Ft5}I&zjsd%(8STT{Hb{bHU*m zKPf}o68$2q4uSF=@Zp&gDy>NSl%2j_Iq?fU!D1YQv8juU8COLTy+OOtmmS69L-2qO z4Iy``a=8!nfDq8&w|ce)(hcysoG@W&Le~96ulEz+9-VI(7e!V|M1;Qcl6vRvzzv$U z9eSVmdrf@i>I;!knGyV)y*L;kCj+@-;*BKzgASi?VgT-2df@Mlc3|sbCFI*(cl{Lz z7GmmPY@#~UL1ijK%RxHxnN^L7ehbZp{f5OpIjQiszZTyFOZcK_I`iVM&QLlSJ83qX zP}Ir4_*O;anF88qSkev2MzoK^Qj>M>pBvM!y@qB+*)eHjX;b{_k;F7!eveIEl<8}A z;Z6DLMS(UAY!pl8DFIs=ommvG>T{N6M9_>yYa|H$LyOuvPu-_Uc zuRiF|Syf}E1K7}e+x{!zJ5$0MB&2pK7)XOALsgK$AKQ8DPIRxtnkHO>^lr3)5roV0QlR=s z{Y!#Ga@^8y>_6t`bJ{fHyF73ZA^3V#xx9SGshge+12Nwo>E-RKHaadL{Y5)GdK5|aEkmmyGqzc&3iq#a-@IXT<-UtfwR6-ke`-BTPBQ(# zd)I&vh2?(@ZJ8>wsWz{IH?Hom{u{z2Xv%0>>=gAKE4Q2#deiV$x+Wr$_isO*Jp^y~ zce}TbO3Jf>x!Z;}YviI_7#x0;f(aConNJ)MQY;u~BQc>L>r^t)>qSCi97 z7FR*_h1+DFP@s{oc)mWm>y}VqdL@xD28lz-L3IANZh^ zhHMq$&wiDkChT(k{QRCn0M~x$seelBr2o>JLx?uX2<&DM3ByvgJPY2v(zZv<)!A+- z#)Nu#<}H`1)ze^^I)0JWv0ES;*>G*tc2$EjI=9=)A1p*4gKIGrs847C| zsD8!z9^oa8t;jml^1{~hV}3Oh`IYr-2Wj*74h7)GvFJ$XA1l=JAaMFzDBoqu0iQ;%_4;Up8F`J7{5U7$gRRUcb* zcwv<}uB9axw~H@Xry+7Se2K2?xbTVBMAFZrebj3Lz~r|<+^IiM7`t#7x8k7c0?nOO z52W!{TLxw6=jPTOQ(!LAPyKdt25^3P&wI9@vh0>{I!z`>&G=t5wwFI!rvm%w1q+N| z2`XNSL;LDz(wH13xm>zAHR-u4>dC2&@1S-9Y#(%Ycp-eOFL~xCo-Oxx81Q)D2mf;B zx*@T|rW;yvwowP+;Q>O|#m(rZO+5L`=#dO13|jujBL%c1-M8qUR~r?p(JN2}N?md$ zSs`P1+a0v7%N#eC%$9zNb3hL}9{y78|0EJ;&`9kr%I89HKaO4#q6SiO#_(D=fAS%P z*1j>eKzcM-*;EbgTbkwWsrnOkw50ue9UA^REKvCT;f_5E=Jicm@x$dY^6@%|%#yCQ z#iMaDCw*a%B~M}wp;^`3JWd%`@dk|sS8zG}=?caRGBjd88zmzM&Z)k9OLUM<@E>s| zpPBU;Z-)+kua1neE=sOfBc!#9e+$6T08t3Qrx&Zi5tsFTgKze=INi%zXWE55Jt40Z z!x;_M_{`It^K&HuCfQ7R7>USq+HV@X+vo!dFeUUQ% z$ydkUZJEoR0TO}tk$2JP@d7GY>~I1${8G!KfWMt4DsmYTcqKC_dw$R$Ag;{=7|pp% zdwK4D%p`awh!IXfo-ejekIKtPX)`-j7383%)Bg$|BTrXA6@CSJ7?A#0PqWV+ez0e3 z5L(dPeyv2pBeSB7mD|6F!8*^6V{FJj06sIhm587H%%t0$j^e~n(Kat1AWrUhck1cXk>ZpO~iw^Faoei4d9%nMgH-%sVr{yB`Qam;Z6M}8OOwI2Ln0W-KdeQ)f zBr?cBvBsmQhtx5)L4%XSno$2)ppjm=-(AOoL5;wRjhZ=J%v!h>{KlN4FP!U1^9DsWP--FiXz)wNuGT*MlwH^G*yiZRClfSnpwoOqd z*3+0)1}{BsEK!~vOzbI91Lf>{s%`k06^?T&}#v@=;1Ba3`u%V~T2iY90SzNZE@NqY6?<;{^*n@Me{UKK?D z?U&XjlF)2D> zZ_Vi5xqfb4#vu4EPh8`cYNdo)&ACPEeO`2WuuS5>CoJF3!<&ebjB0MmBhQ-of=Of5IkF#l zo-wTF9ZlWNIF*G(hjHhOPG%J&wad`XScA_yipgw@aX44k?ueF@5lO1~VgJnD13J#h znGEXv&_xbPVP9K13}<1@HfgMqw8aW%9e8*vx(>{a|ePdPjf((L;d3?aT69 zgEmqT6N`zlJeaZRFch5Bku66^C5n_2d+ zIrR40dV6;s|3(c9zdeniOPeKwW7ct5^>-x~XC($el;jpok7pVssaQb%%An@C@fS2X z?`+;xFpP2W$@2#I)mq5f>sJ#urpK$L;91$*HI=D`NfF0Zq1w;CZNHW)l{d@T_Eu6A zt?ko*B!J5wUa)k`IW^d@Haip(I9nzX92(iDl?PWVJ#wFOG2eT`<_d|KMCouQur3I) z_t@=^#kof5^Rc!gsw#T$HZuhc!m@KTAUQvO%dZ-lSGP+=_2e`sXzGr64 zV0_#DxWmyKeX%ofae+1PentT2JbK-ED*OfkdQr=LBO+-xW9_5`x!^5DQFNGerfO^d zRib5{`$FQg3O>>Su9q@j9IBdBtv2CL{r|GoQu=!$o2E{h=qde%hp4lG`Kaj4=aT^A&zkc% zfR(E&;3=i&O*YB&j(gc@G@Bn=$M9x+6nLh}3<7N|;`qC5UU(2-Vrl}+I1qA)n+H}* z1Jd}gZNj1jvdb0PR1bX{_VNyAQgGUr2R=0wL{4&9`X{X@imn=T3vFIgsD_A+?*6pz z!}cTqtABeN%qaHTGGWJ8Bu#plpL2n)=3t{d#k|Kur}UjAi&7M{lBnpp4>jsgps-uF z(SGN1n?kpKywpU86uyon*>(_b@Kjg6iJh@>Y}&f&j1kt+Ff|LO$s^f8XTAkd{m&Or zdKrBOrZ9)RV(oH^Zie&^O6#QhrP}!SojevKpO`F1(?ups)Fz}~;315V*n*uY#%nTD z+u5^AI+QMS*Q0?s*;6)Ol`!i;^fr+WqCl03tq3{o-ivWzKH>;6de{{RT$?NgGGs|1 z(x$Gnk(wZ_Y9bi4FvK(<5Bz)0a)FW@^}{M3quNQ`F4aWzn4Po3&R#D31FH=erF>E0 zq@nhu{gnyRccN|2wxy&H*^`>oMUfh`mPxrs=lTedt(oIjmFvt&I-Ant!aTNP4hw`@=Ub7zEBv9znhW#Vg=M(_ zT#TG8WWB*S6Ytf@faopMGG{2m69_PDx(oBF5rQy6s?$~Ad>IdAtzuDgE*`8H&!?L= z^>sUI`uPm%o}7m^YX7<%ERMA&BMc4VIVzp2=wRg=L=r?6#jA@$JY720pD~BYEfndu z4BGW4P5js2I6Jp>_l`6NQ4iXxSi0$u{M+AY0$bqu{Tw~}Z5yX9k2$4L%tGeFV7$hQ z%OFf5&3;_A5ChS1mP}o4>lVh7A-JjAv}b&=QQGo>lGRf=#?M6P2uK@V=dVdVOu6(1 zRh>3gjrklV%=37n1e=uVGFiv-41!rPmdb%`eg4RZ&t>;d64Q6O;je#FQAMvPvi4(Z zezwqCJpEgU3HJ(5Z*OlW-m3vB-h13d3IxA(@}uowPU%w!;%N?myiNk>ij)P@-)|14 za-v_7$@LrZnt|pmOct$qD1=o6hC!e7INT(UuRI8Eh26W2vfq(vWUG(6isXOgM*N}I z!M|b>zqzr+gSVUyC@eU_1BLS2 zenvwoD`qu#9^L~Cuz)D@ZKH$Hg+(WioIU-cxxTb6g&om_yE0I0j$-p4 z64k^%PrTNu&%dx0rVN7T&HnN|Gz{(q-jZBRh*8Lm%L{nV(R zj#!>q-hJy0CzCdgADT0X&4lNpSt2M?^^PBS2m|R!hs6BKk+OQ3OG735ONr6ZqL23# zl5_v4fl(Nucd1Y_fB$%Q3W&Pe-{-Gv444wj>m|hyJTFaMVl~3GUAtcw@{wMBh^F2-q>YBeYgGp8q;k7#8;pqjj}`tU_%*S!(5VwMefr>-K|QvN zfDwQ#9<-L$HB-*-PBY5dFcJ5|{9E~y`RbvtMSS=*vo1=^%2y2cB^OsHL8F72Ka-B0 z!&n*3N5Uqjq{aj)@L`t^6*2$Nq#*cr^pKD zcXw{lreb>+8CkW{*#>v|?sT8~nz72oc`HJ%NCsZXB&qYG6MQ!36E4!;{aZJ}#cS&R z`48^`OMPZkB=U-*Q}oM(kCwtz4*Y=lRD9%uJqUhw{vbNVdUgYI(LTmZ|41+x01V)9#{)0f#1p89d`*ql}A)i8oBCNFXA z9H!Aoi>ZZQ8ssph)L|8IurqV0a1@&fM68%^p?dDhpoVrb;e=|D!bw(q2bLfFIK$*1 zYf6y{T1LnAgBVo7a>YxNKcXOfJ{Ikkll)14YJQpx@u5$@jA7xX)_ff_92Dtn;AsUD z(*j|@NU8-pzsw76Eur+k?WtxmrzlwUwWHO@QMAml%RRf8*l>MzQ~CV)J2uGS23<+4 z*2FkRt(>{u&v1IU(7=qKo{jL4_x+!9>NgT%&tq#%CAYG2+^BB$dhc_R-mG05BXu8d z5l{b}cNX~-w?{R}pHf~mCuWq=_F_Rk|BuKE+^3=k!rYj>2)2aYCyE+%TPfA?@J?gF zwJ8X?lLl|s@}`-m_Rm1A?XJYfZmOGJf~qBU zxtUNWZu!LsIN$92Ku@DfN+R&s?`1}k4+N7bO1xL4Nw99EEUJ^bPUpGu6vy|VmrL;= ziUhx4y;aTnNfA|KMfNhKZbJFt0;8k>To?CNZom^`t_b>LTK641!>{Ad&V>sZC&lA? zKE98H{luX1HwIwMuHX=+8w{HTIxnfL4`B9~0>Q)Rq%} zg9;^XfcOsQNz<^_FRl7_a2~eY37juVcXWUL9g6g}l@H$d@Ayi@QL_2|8cZ*z_C9iP zAscps&DMZfOxqnR;3=nT1viiP;s3Cphu2KZ8t_jI)vs5=-AQW1BK(`Z=P6|qo_{?m z9@@2K%awk|t&di|Fc*&k!YWkLM*6T8Di3Q4+`M4&&0eoY%CmcFe&cNRM71xQsRBsf z#B>up%o;9UtuP+^u8R6hFwv}XM?ijUS5MCwpX6MUH~=+i2Mb-JY_*jXD#>Ys!Y1wo zL|RfeJN!B}NdW+Z(&4^rtcC?YtS%ymdgYRViO)ZKGzf)WzlHCzip;NHUV$ zn{W+a&p=57L|(TBf_4rk18?~d38t|FHO4YSVPr6CS^Ybp0_-a3{yeD{SpO<4cN6~= zW>zF^mxD!ldU(i;S(iLlYqZf90|0emlC4IyHt!IGXs$I||K|k=HaUYejHR;=vzDp6 zQb(Imr_gb6ak;*F-TMbw@D$^7y5^#Ezx@Tfw%NMF=nR$tmbTgwcF){%CqpZIubL~& z(xiUbN!{tj+@3^6-jUhj_8;r^;Gf#IhHqft_Q^@h3zxm)y_TsNJ~W3b9ddljQoEh* zfWSb;ZCRBV$%g|qfcO+chJpYb)c&yY8lmsycECqsgbdc|vbNs=Bo2Lmg7PpovK$*O zKm-GphGv2%GoSWkEvQnaQ&K<|-~*8&@9B$vAk*ld=MWm;R57pj?fu)IDv2+3N#7je z6@Y}t=E<{^OsKq&oPqizO^t?lepadXWK7?oH2QnH{l!mTG9!&^br6ILQ|w{ z2Px#%d@hZ-g0S?XE|F$_WdvBNiyH3z!jnRm@iNi>beo=Q6{jms<%iS1mBCIiceMK! z)#EbLF{3vrW_o?M_QVVvJ0lgMnXWsY=f780H^7^|fxF1oHP+9=AE~HW+JAwkXk;?~ z6zBdf*v;7{wZ%+uBZ7?PihPLw4t6uBe`EDZUxQX|NCT4XOdTAfbhF&|H2sHo<-YVHF2hX zY?JODgqukW+Rn`l z``!imYIlHiM*qQep1Gh_A(LL2fPI5@c{nM5m3Qa_jGi~_P>;u9P9rX6%O5|=IgU?_XcT0=z}Zu`3ue2(}h4fWiUN(pS|xE+KcK zs{tP?JmmTjDl*4(26Q#_82_61nH%4IMFzs!NlGT)W|`FTUNj}o9g0J;@BJ4K{YSct zglSB(p``AK957i{_1pE5&tl~;;xfLF+bz>;wWkBgi;V$=zs+v-Z_v!29onT0f|#d` zu(7JfTU8m*GkZ>F(Q4pL^(lQf!6VMh)SME&ANzR8Cjp8cRqVoc>I@o%rFzGZzou0S zu?4%gTiK8uY4OOfs0Z`u1NS1@^f-VWrP~v9_ZHQ-?C1B0F3BEH3y>;Udo$YZ>T?IA z*)N%a%MZp9=?+x(EdtPoi&)Mb) zP%u|2c8EiA8ex7mIusrWFj*}jI}dk0i^HxRRKoc^$}82GezFLkKi$yZjF4F^q~DRs*KIMb}4*p9lgiKwtwc_O;>T%=z$UwJcqGJQkgt zMe?7L@*gV?D6KxPLzf&2hAG@*h$7H{lo_jR=?!AW3ukMlenNMXr^LP7g|cShn(Qp@ zCkQ#8kb#(Fl7ceX%Wq|2I8doZ8VMxOPRr;C^#n6(6-&p*w0C6H)MIabSZ>jF$(K8w zX150d;GAWOA4|1b;T`#gy1!JL&*27!4kcw-49{R(l|_h*Z-BE7B3ZH3x)!`FkOf8VFPZfB zHNPp_?ib?>y!%58+TF2|Wfi{J1p}1)fyXEybyw*smVf>5Z<@+f&DQeQDQv30O*bT`$U%6mJVY&bvU5y*o-UDrM}8@P%uuz=@TIGBWU z=(CKdjm3j=&P+;A=euZy3G3Hd$HyvrYUf{GOz=#D6Kj)s7nF2x%MLdKf7?=4se9?+ zNKEWw<~+<|Yj9H4{Lr+-`S4KgIr{?YEk$*Yx7=R^1_iB5NU+MKk_y^E+nX{%-%$23>MaaG`MBksFjZ@xcX0n9)P2FbfDmF zHCbVHsbNc@-KZ|Z6GS%_+jM@SIw^8%HkBRAFG0&F6>iOC9Tb+y{zg+;uq~S{=4P(= zey7;UEp2&OaHd>CAiW7--_7?ixX-SZd6mz)LPEZH>(BBZMxOdN?{G}I-b*B_Uw zs6=+X;xRVMsKPS(2RGtalA`gHrZMGv!uC zlDDm^nimTYRWC98$Lv5H!|rq7+AN$K6#7mGw6fgp>wK7is&XDH_8{$kss<0-2nY^K zggj2%C7F)N5o%P;4DbrdzbBJJ;{co&fM3HcHP&nhP__KLk4Eww*M*&(+t*3mi*!&z zDx3mvo3&KN1l3~m5BxLllc(-)VF7L@+ltG2OLvCu1XZ;wUa>+Vt$ITW4RA!L_85O*atg?)fuDF;$`a98x7H@@Jfekh#n2L8_m2#7)&f3K|p6x!|ePj>|`Mf9In zENEe(e}MiXQko^*_Dh_7qPz>^YHbPw)fiX7s}TkOIQA)S#0HlxE*niGy*zHVB%es*NupCs zNia~~lFwvvEUaV~gMBkd64f#_rB%YrLzIhVyxp~(!6oG0>FI4D{%WGHo^eGeiXJ^H zLfNC&kD0gISt{!J6$wz3>jNZ0WI7W&2XK6nPS2Hq(#r8|h81Tn<{&`1#Yf=qtc|4< zQ|;#tYIA}VXn|uAx)SrC14CCNSFn&06j#zO#=I`h)_7Z3|1kOxZQ2&{?>QW2Q2$mW zou@Q+GP^wHlxs~mFL45%Q$Uo=YVDg1>wB>f%Bb-o2sc8cyd4IaQo>5*1kHu?fJvFz!DbzPx}dA@Z6Y2G{bYv7diecB;if}-;w zU=gOW6720-`f7N$ERl1W;I0|UhPsmbn}~L;YGTd?gQxc&-m!s5fm-0reGUR~+FUDtxT5QkP;bodteA1vRkKJgx7OOMRfq4Pti&%`et5yq z{Yl3GlcbE@x|fC}&#BG;H=A{|$j=1o3GC#(pWId~G@sd6xi-n-X+&(+rG2m>Eau48 zj&=cYJzy|x@m*?b*nf+Hp4#TEuU5RDZAv~Vai$6wFk{rjs| z6qE08ko98R10LLbIm)N^K4xWQOa7Jj0#NKV@E+v*o^fgq>!K?;jiaff!!&owJnwCk zo|l5m`JB7emBbgUSA!D0#{G^a~IeUAg!FQL2 zD|&eJjXHzb?cE`tL)yyh3^Ij^AnDJHp}JFhu&7PwtKdU#*dK!;>f_&Fl!IJPbNm2lQW@};c$D25&MXl^N zxl5#&(xw=lZp)4uDxcQf+v}DSGJe8R{Fpm9pFW^D<%wF zxo_;;04q9{)?9zzIRm34r#1D%fLskTGPJ*)DMoCucX))qDBmr9E?< z)UA}q+yZ^%fMujAi_hr3`d;5mL9fd@88Y)txwmtfqfvQ=$hdP)RYCAX;MgaB&tAru zB`$&_Qd1jHRzClYA;VfF0ci;d&UiyY5t&8-Gn~UsRDaRaGt*$Y26afsj8z~!#qZRe3m1TD$PN|ErO{N|^ zn4I&CtVLdNP84oM#C<<+@f?z(2=Gc%6V$6}82sgiDCIy_cfrz51PQE!nK3%1 z3fjwUueNu@sCCQ77<52j1=#a^Q40UmoRO0B3m{SdY9ahiQYzSGf zmf|Ehi+=t8xk+M^M(@(HjdP=V(m+Qm&LbnQPpgdh)|bj(n07kN8vU|Sg`3A)>2LG8 zi{+E`jM4jbW7eHtU3tNh$NFUI7(m31T<>RkvTphpU)N;p43E4(nIweHf<}YrG|}Ri8*Cg zb9{)F*7gxLY=lIs#4y!2rXS!0JSi$nbYHa0L=k3xGoh5W-vAi*#18$buIXA@#MM6Pk+H$YG7ew|LhKOXi3e$r%gg?c-t?gys)Z|UivRs(Q0_+q>5#2_}X!Knh6cra*g8eMe#f=aLEfW z^_8S_mc4A3ixXtX+bs-iSZ$?AI<4VX9~f_Pm_8?F#enUZqZ;@gXb@G9`dJafKED{P zAHNd4$;#sVQ{hq{;NBb4ERhjhaIgP zDH!aH(iKCt21b(joY?(4n}rtnE-byWr0~DFuMzkwoN1!2dI4U-F$Y>z#*A-<13k_p zlAvb}KAp29mR`-s*e+T*rv~3!+OPpFtI;v8Y}zkF$qW7w&unvBYLzZ>->^Ach3TS0g*>r;@QUUK0s)WLBa(kiA1^{ILdXsi zhO~GwzTI0wetjoXWneuWa2`3HVdG{{-WaciNMkWEW z<|OB7{_6Slwc;8dSsDAg%DtN%@;8r?K$*N!>NaRW(=aH8skQ15DviSH!_xKiG@Yy~ zM1_e)_AKE9IuRd#Hm@VG?>7D7M(8ROPw9D8Cp!;`53lIn_h5?WG7{hBNmdQCh-%FH zmaoEdu>f*><5t3Bw1gxl7Fy7B)z4Sjp)5!4N;72TrSNpkW#>@0s;j|u*l_I~j(XZEkG zX1O=|`l=Td{5nfL@}Xr~nNH*AQ(&^}(SH{YbNxNY-9NViM-^JAN8LwEj5X)6FfWVU zaQa&+mQaD2s$#YTEnew&sk;4UtYuA~Oa@L~=#2l+!>H0ggUh~6CZN%R)0kmKTU4^y zB4<3AiL{!Q7_#F1jMYJ*0_^Tqg~<s!?yJKWq@!Ux)zVg%3^I;isHL+0vPcQQ0jk-HS z`$`Sz)7=Z7H1il9Mo9k_JqBqmt&;7o;U{4QZLBJDHcOZF+%8MAChHbOR@5njck9Hq zS*WlHFs{@083#z@IZeXeUN+V;Yx9dGKj58uqf;eKoQ+0ulAnsrQQ+@=t>WPz;UEkF zAFp$mCG7m8MbR2BwiB9{-(M)Bhp4NxVi=I`%QIxq7h|?)=0qsc*PH4#3?|xeTzpNB zL6Ex$cHRFaHVwHO*BTq{Z$6$PFf74dL|_aHT}G1xox1J^bcuxw?Hq^Ok+p|WCjm8S zT-R%l$EN4kzVfX2!jQTa8OTd<+yR`PbKue#;pL1@;;emeuJ}7>YwXLi0Uu;SeHcmH z+Dci7*>%1TJ2>aVWkxyeVi0MA?DsX^rl2VCn|z;Ta*C|29^m6AbZzEXm__{ zfAv%`F_eGpz2BL>z9@K%C{YJlW>eP&GN%5zLw zXZiRcK5~T=QJ;WNqZFY7C~}scy2*lFw49NVshRh6!VPm?yB7Hzn{d3|-umASakZq@ zupP6tRv{Yy_7oho5#skBWmsP`GizxR7h?~*o0|rTrU>tm5ouvsj6Z8=a@)tvU%+Vj z)Cz5uN;P*SNYsiaXZoDN!c#5dfWpFQb^8KBNKw1qy@A(t3_KFHy5>P~FTS{uaYHcP z;yY}JNx6TLuX^9IdHXkXxLFZ4dXI$Ul@eKie1kgIcdk&|d1$(7|IM7F0b#`4pV5k6pCv zN;dv%GnY&0)uc|J5W3SMLfhd7LA1A0dVrA#VEJvnJ7KWEH!6`|TtMX9zU^2js^Ya^&gj5WqiaWGHLrT^6A zWcV{ZMOhAP%|V!$-`I49lam57NZ-z%Sfdvo4_|#3P5H`P6FlH%SWXXJ4C5r?g8V2Xx3$#Z;hEiV^TJE!+5 zSQd&}0`HI}8!R6PSbp(zimq)$t4Yp~+HgW$T=cSDqJA0J2!$VnLN6wwDht`)5W~bQ zj7guxv-g^CUBg2j@k8#GO}Vidn$V(@o)xF^Hfe(s{^^mhW6q$Sa>!Ez3n!J@2{U8d zyAwTdAma_{s|8zczBfiG<_?67gX{tfx|yPTzQy(;wmO~P$=6}xHGbr%F}sDzz}?>; z$ET*1S*{srFIE)|QoE!}vthtHq_v|QSRqAua-+|cv+JSk;D3B#hnUBFv5JvJM3+_d zHCWCA&rZdG@HY73E8WQ-TNfNhIDL6&E@ppMzaQ=Z_+k`wG|Ehn8G4z{J8UOEfjT_P z@IwFh=v#MNiZP)|RAg#|Qz^iUp-zm(og&{h?B|*O9_y}-YDNL1V|R4By2RkGmfY(q z()$iPfq$%Is#z7b+Ql$_lkl|YYMwAV4*11D8(TH1Ev!X5o<-gD?is~eAshN>nY6kg z9!a6Ll)6eN2P-}E6npBAGokk@XCxpt?J)!O&{V0zfYk`I6U{L0WE`cmbuskx)cvJe z;wg=D%lM41tFdIia%1cJ{ibwxh0Ssgk`?&taB#jDSotEP?ONbX*nm8pOH zi|FmQMRhoMYuXy{YtZ`OK*@&<374oOMr~3k-g446B*4n|c?XLwP zH{_B}$6R`u7*qQ3aK^aWeqbFAJoE~D3CmWkOIqBqAHQG3n`a9p*-?UXNun8c9-I(; zBGD%^Kdwh>yTU5m}TzyboQh z@i75G+S`WgV_fhZUL@`J2EgJ_`*)@}m^ACfK0C8Y2A;>}n^_)=& zjT-NvDq=W|P-T3yu*>uLZielQjkS<0doeWxGdx^fZXsq2U&e84Cn2*bgrLPsONF_S zka*72!q^7P?WX53OZd8)Ul~p~Y;g3wC>>ZBynn@_PDAdyhw;OMI=z92Y%r8xw%Eab zTWQiy%WX2#2*06Jn}kjFW5xdiT0y106YkF^IBSvCfMuExmWBS2)}xk;X&i95ykHs! z90W05GEXH>AE**5r3%omMFI0>hH2!6Co)@O3@`9f0bO_3d4+-z0AvR@j)y zN|S&uqYVHfb~B9vgQ~b#>Z+hDL3$ffq81J=q4>KYglM%4SfpM0>(JBZ4U*o4In43oH9blC^?Es&Le~Zh|nN}glU|hVBwn; z@t6cwkpas44R55N=3}~ky1ts15zsJ`vWU=ZPE5UDu56fI@NZa7~AM)v2BYK zBhx=q#O+Eo+3|ejec>p4$xTArw0L~D!|}lOjc**Q#>#*$%FVABha3L*$Nxl(3rbG7 zzdxhvI!2AJGrcEPQ_6e2U|ANlZ42*PEbEGCoRCsQsbozZ4o5igpeSW z0e=1MSG+tw<9IsZ(+@x3a6C%lB$;ZyX*gSpfeNh5nBH1AQ=6ud&icqGUu|esjae3C zYj%Xm7UoxKMSoy*Jq!bCB{HQEa3|*ti&O_d*LC|rXIX+AASzrdxl1Y|g}_QHXN1U% zB&~UvjcG+n0Y$>!x~|9PFF)bK$4@T?5552ZAOJ~3K~!+^+EUsuQaw(mqpVF-YGuLc z$5g}u5TFgwMgR4eKjYv3@Ba(8;f-ri)eG%U0= zq8iit?6KC0bsjO#i&TFc>^sftM~j%ks0vh}qVyfSd1sxGoS;M%`+XkYw=GsPtl}H; zcFV#BtWkipvW(kEqYVlYmZiv!J2U>aR%oNpb`4I)BfM*c??pqDZw_dsAGv4LCnml% zwnY{$7A2WxPmFVxgT)*p7Qu1kREb*G6)1`)+e{~{_YIVVz!o`w;BeHTRJPPY$gpO^ ze6zQzDmSZ?2!(Xk;Qn;Ru|F`xYgsT)6G~1niYKj-BgWesZr2N9Sdp#95V`1n`1A>P z_YcrUs;SD^MifKhG%tJfYL-pCDg|9Dw9KqhPN+)38Oo=TG)fFe1t@ET3JFSEp87@c zwaH#{68FAh?unN4!j05RwU>Y#mFDl%gkEmSvLbU37$pb`$akJ(P%Cm^r3LaC0D)?D zeaGItv^Ch%=G?{t@V@T6tF7%r*)@rE+Bj5Hgf&26Lam%}^~VE@<&C$^fFN#e=Nme} z1@S@w9SyQ!UTCbXRDxCUf5aG(N@a*ubA+CNk~zQ7s$fWoH@>q-G8BG!`HF|fJ3Kx; zzwZJkH)Va(fLRhfO6W%T_Sl1ap{`e7h4|h19j`;fPirX?{X&hc( zpK-aoh|w?MbULB$518i#<2XTUhqgPySi5J#uM%{nG|3K+A0AO^#u^sRNk!^i1k-f? z@BlAS#+$Tv62+rZ3a8@{^E6_bMx+$s8%n54rHaaml|X5Ok}_gs(45Lyus2pd14|)8 z+sYuiV3`A6USFV;!spK|I}TDE=3FH1+`t$Ir43ZhP=!eSEHjEVtQf`t!!XKwCm!a< z&tC+ke?TepzW@S$)egQPC^bnK9D%HLuZr2WH~9MX1%Lb7U-A6>8!Jj}BCnRIOZWNoVbbeWMaiBAK-U zrg6Zpzx)la&%ePLplv*+H9;FXg75Ahk#mLbjwsb2B=*6FalkZA7>5DNI3p}8;<`Yi zqOlfjYhkS2d*7_efK)2EVNgtg&lR;qK*ew5iZaO06}pn!1);oFnNy%rGMTa@foec$ z=Gkzw0Ez;V%y4p8zfq-;p|oY4Sk2A7=Dfr7))bLOUhMA?(H2!AYn^k@&cn4DPPG2k zF+9sPjquG_S*4gUmjwj?ltOaBYXf@hp=05lLF96$;8Y6lhEf zm0(sY#H`Q@b-5yAUKdnF_@cK4ISPg*C%D$5=_s+jyuRZ0cEP7lPq4-y=7@P2X>N_2 zcf^&4n0cHK*MQsG3+CYsH3b+|;H`#HJS?RU;2gj6+wF!o$&;y-6~XN`qH8-*z7-sf zC(;UXfhrY;BiqJCb3qPaMVLqAxFRkyYKnN4E=0|YeGco4`+Fj0ssi3F&oItmnkHCd zacCPFGv@(XDV*=`a5^0M9&3RCpbR(nH71m*U|q9gp;D(|2Edi!ey+5w%fu} z5!MA4@r>le_EM>AqZMhh)XHdNy0+i@;>K7k>x>v8=4k;+Mc=hMt=Cu$>n+SOBSiya z4UDtMwZa(6S)FeMX<_)KYAb!xgd8KZRT9p#BCInr#v{w>Wf@RX!ZamxorCiVZR4;k zqqt%Vyla>fk`sp86<>e(4Y%9d?wr?0g|0v1haY~#Q3XbV*|ec|gPqd4%QS&13m)4WwQ>P8R*Uz68D>e*yDG61ok%9tK z%U;Q_-Ab%~Ma8^KSmVMhj9N)nUin>)vgzdS!Ot7Q449*VyWy30pl=X znS;bb0~#3`843xik`6vxFZekJT#qMoZ36?+cjsva6o=$h0drjt*R+3M8Z%Nzs8!*3 zUB-^NH=p6ksf^0@`S-%ZzE75L3dT z>v23Dxd1ASrtP4u!N$;3TBGed`p~o?&PL?%PzGyENGSs~OT|osW7D+QQbO52bZ%~L^mKfHa~_{R|AdE!k62f>%d{!*-e6xE1m?_@LMSL#?^E_dm1C(}neEhge`TPC^YqbahPK*W9LQNMzQAsz9}|^9r0Hi8{t8uWQ-c)yjByVU=wMsqgXlzMG5SOUlH- z*EA80K>08cCDS}%UN}TV&EozhBPynZ{?McA8suEDhJbmYsb}K`vCp0ayH38=rl2?; zkGrFL7)K1_gcKP1#S^y17Dw&&*Gy&=H-KC?uNuZ1IZu5HlQ*CvTRh`9qPbpSokvj` zMjNSGIs7d`B52wc&Uh@#g0eDa9H2VNXhKqB%t(c%wf=ZQ*EO;LCTJA2Esb_=XprK< z_HiLT{d&FP<>dv(y93&;Mb~(EPqtTzGsf!$mzOsZZ*#%$_KFe~AV<E2K~nmI>=T zP_!FN-em&(oLR2fNdOV zQdkqI#Lilj#-YT3b(!QIU!kqRr%#{I_6OWNypw_w@OjBZ;)>p=ougkI{;EC&@ zx{He^q}@vSd6tDTr3`01K7am#w(TU+BA{tIb})opM{z&{rLEk@Bw>V@v91v@6~tH( zW5xOI315Ev9X@{iz{5tEpmc#!R%Su$f;i`JJe_cVe=kb08N)DOo<`XmS}e$s-24I0UR z%B4u#3;V`Q0Y^nx*r9RW?g4GnIAR#bot_NT!imblZrT7FI>rcX8z{xfZCwMV zVZ`n7hTG*8*UKv-jge6cG42`_&U*R)Hm7~H4Ea(TB}Mjha~3LsY?=Ta?UEOwng&%B zSnZ@jz~0tk^|_f3x4}43A8S}JiQi=7S^?PI;zbhohzsHAv~8RH{iXyNuv?VUVU=tV zV+CN!0j$%w-QJj?ZZ%4w2O-6XWt}mO1C%kaQl)MiiZXhy z_5h8dIHWG6z{qE#m2A4Y!73^~nkWr?+d`pWp6E$A^gJ+4!wqk5FIdBbc^Z+1jN3Hf z`Er5rM60Bf;5Ik=vS56B#p`dsVVPH?QZdgns|HA(QRbl_leL7~ZQyV`S2)+~gk@`; zNZWb3W^D6{zG+YkFy~R8gPTj&wt!I#a|;wBXeh=UY^{@Qkz#`w7AQkmeJ&YV{7yMW z+-@}X9u7TxL&cu6H1#TDP(sEU5@MosnF*wuxCV?_P#R6g15z#gUJJN+7;TYCVPteE ztc>~|#?h2LEdjYIz&PllrS(>^hKvw1a%ODBho>KKfA<0B^Bs(FSeF&33eL*m*cbwA ztD-5|5}6-U#IlM=sFGK=t`V2(6~nZ^x4m!>73O6|E~H!!OGJJfQIyB|ctYRbp^CYMf85K>FV=`Q1OL;Dm~ z`KLpVwrSp%z3=e&uA58iTke{&P;FsSNx+9yS}~gn#~7N_rg`CD)OrAf^C`_-5oGSl zDKXc?n0NdJv$uJI$|+F^*7r0EwH+EaA+9UiZkjhrPLSSX*-z%$5dFQZi=-^F|7g9Z zlu;{b0~O>FkfaB_h6Pd5_Hqg|*=dCkXVemLcRu3j=@Ez10jpGP%ew4YET{_WJY$(B zXt&l{HJTDVM z%4oU+?j9a?)!VkQdhan$JP=jXeKzwR2g^{q4Jn`V<`O6Rqbk7q25sMqdt0HXfg}^By7a zo;{!M#17z)a)x!hR*2gvC{a+%)Aq5KBNOgZmT`Hh+! z!i3xHmGL6m>}VWCAQ1Lkq9V#dXoFOk%!(zzUT4&5kSi+|1qPgj5K%JFHZ8ioL)Ra8 z5R>^O4a^=@d1ynkq_+HyQc8eI(6$2F1IoYOABN`LPJ}+&2BVz;jQd8}`QLwhXDM=E zq9UkG50QO8>Jkc^XBJ3~5wm2l7;AxAaXcK*bsdsq+hYV#--#azX&G4-a06>BocGKY zv2ItXu*59;=H?xte%4wna(doy54BQKdN>|Ya>cK|eZ?@%=(+Ho@xsr3I~eTOOpHj8hliT$ zt^nK+E?eoY6syUcGA6;dYcYInn-&MYg6NS7X__duu-5QUlNp;Z%_F@yHUgT-gGQ51 zZRGujLqJ$1Ing=9H6X6<15d^S$fBSXaxMaVH1OWSH!ZC9nAa7Tw~MqBD-MSv`r`@C zH~91VM_eugTHkRqFb>HTtm}-+g;@6M^$I}2$l)%;g(Csjdh~pYb(-=+^1^Gw3m6=mf@aqL`c#`k@=T~LaB7eLmPBGTYL8p4>+FA z6cpqF-?Y2ej6xEPVHjisAz|X>pXnZ;Cf^0 zQ)yrcD;kM>(0U=~P7H>|7$IY@%aL=Y8Mgv&Z>+9T${22=T>m|c^@5VoSeH>MkFuj! z00LB>pPx}mk0d1anlDx=^lWS*RmGJvB++ZX_r z0dPXQs4y7E6~GE@v_xF^Jva_9C`F@`8M&;eMWbYmB;K)L8RKG?_`>IV6<@r_KszRue&oAqu>Z630d2 zlT!-N8Zg>2FD6=~5Mdy^Dj9M%FUZn#O-#)+uIull_ew03qJnv z8J~Xm0sY}XW>Cy1SfQ;#l8ca1#ThkIZs=_Tt$`4Lbp=g&#<1EFAS4u9Sfv8FD3r>< zrmjSxc7yEu_OH#r7NH7R=txDWytP zSWyaFJKOVYc@=~u5}hAHL|j)SYe^B-9L8<~f9D)qamEUaF=7b|nzoT)F00mMnE_?c zc0iMOlJt#-Rc!qnk4MTpW5%*9FiIo&gc0N3+S@!l&Keow0?RUES|ZNp6HbEDzh2+) z*Ps8+>%Z}68fMX)?iHHfe#1NrxD7MT=ZsP`!kY1R8SwJ*hRfT4d5x67gQ~Am3qp`t zTIFG`NSK{X5pBoBQ0BRCXnZ&vsNk{&rI1aw(Q#u+^gRiiOKAhO$?8$1+oO;KsbZ~$ z)rMFhZBU^1&80scV4D_I4o|rhSTN$+Sr6yguKxP^f)En={(xZ^@$&M5rlkzH>jhE^ zibtwky8uCwFa}PrNwH)sVa54;#=$x?-2p`b!#tsBTD1KEwN{Mt%=x0+n=!6}3z9i; zDTqOGTO<=`^EZVUFwJDgIp@&#oealktjmIVrW0RlC2-t?s>;qNi((T9 zD>x)c87&|w0-DrpO%X>)G+36ra#QpT4u>8}nY|51!GhzJpp{&Y6}4(uTL7#m8M}yz z)jpFtjWKWytqAIygWrGm@qHconzp%;>Ey1p096(%1>&45t$9`p%PJ>ch?SDqB#Vc! zT5#nGNo9WM#qb3y1*5p>Uj z3os5uzF2Y3LRG9`#_Q!3(>y^+JcO8W|L};r^I7H(lDAR-RSOIXYDrjEI)IDdFsx>E zSTg(4Ng@ME$%0hJ{yW&hl1S6-^sgCcH+Xe~-am}!jQIuWA28~TA!7Fa0)-t`c zVj8Gw%l1%J<&)J7>XZ0IG++xMTmr{~^F{_Y3`OldASEvOSm$FuXQwmw}P!g62 zmy$3J17Z&7yOvP3$|1D|39|YdoOwpa651Mdu!Y7tgy^))COD4FherGT)`NO^^~ z23_AkLE|9YV-}GDuug=_ZbJ)Yh7y zHE&qwD5Y&&0}b$oP45HRjdToPuQuLw_Y&A7`1B12k!3M|pO2_roUvoZ#e1?<4O@1| zmNBt;Dgf{#oY^|m#-c)2>Tfoa?RmB^rw!G=g@~~NZlUeFk+Xu{m~WE}i{e7Ht_#Lt z!2R7Fj>n@!#%kPdBVu6K*EkOQ$-CMtn@f z-|$4;6ZptbEEM}Lm7ij%%KcPzKw5Ttc7n9PNzFz0B&?+zSf6_M==~`EX#!BxySKv zg7X&hJYgI&j)w!R*^u-E+D`KVrFi|W;-A}Eg)b3h49mAOe9jl5RA9+ERisen?u{GWb6@%@X|Aeg=rkHE;D&dP>5?l z$^pwV3+92u(6;TwDW8!t4U*pWJ9w^?B>oL1>kT&vFA|_;*L7%pgL#=T&m&Ug5H^bu z(`bciG?Ikql#-bJz0wDwjDfORa2kGBaA>Weo!-mdySqDZt}-D?-o2NMkem}eF^RsO@0CtCRjNIh6R7t`O6;fLFO>G-aZqNH|rLsxN zN0Cf^`!L3mnFj3dXRm%l0?bOLAmxa0ykVYaJUujYyp?jP zybU+L)@XO`G4uWM?&)wY}ZnqKZ60nAV5Xb}E z4$0mcoQ?Q?^}sb zXe553LECmfC4hAoZJ^4*=)JPvVi7i<9}zfeuQn+#F>>HqrR51QVwxhId7g0_u2_~y z4myy~0mkr4-*!+cjS4**qE2DIpBI$( zd6&edln@k$bZZERF_4LsD{AFQ7L}-WtvHLY;xREw!#hUuF5=pUEV#}X-V}Zp#GDZl;{ckrMI&o5#&xZMU0e~sg*+&TER!R^K5W<3(7KBJ2juF720 zh_Rr88ts?@N{z6_!#6~KSZ8r}=H>#GP-{e#)V5NRr0UTpLWJ~tS+@<8H$&wjP)eR; zJ!O?eS}TP=DT;atRH}6ybIO%cNJ(Q(5g{fxPme&;HZXDuWm+3i9(kx3#$lIEGQ^6w z|5|xUQd(hIgACkQ-a0wCZos%00+i_ckH-@}eE0~ZG+~sfV4ef!WyLbDh>0hVlvbMf z3>U~GiIjD#yo}!U>e~RD&gOT;*4EB)5+%K-_{mTg*yO}zUnn*YP$~3RY*os8WwKQ@ z8_u7D_7Hd>Z=1!p>5`k|cf+}Cn@Y}EQUT4rz;8F#GA~#bUQ^`9QAD9sg_hPBKX2i% z$tieqNQbbH0AMYGybohnO!EkP^RU+MGb&@4>d5O);u#c~Oh(c+*`i~svu%5HeTyW5 zhjk5Tn+_j8eqzPu*zO1+Vj3qHqtN#)y8ei+Kk+k;8Mf*0>GKzy?iUQh4es>?wX)Tx zK%P{JfYO{HIq%^co`N^8(DtbE8Ei7zExlA}i>_rQw)uG2HmSQ}N*k&tYz+Uu)&-{0pu2^U z*Yw3SZ4YA=#-Sj@3hxct z)}d)h1b6?emCL{X`~MQ7?f=H zKrL(S-a^?<&pAhgkoEyI$-eB>YSEdensy9#SObRZ4X*L~skfrQd5f-Z5pM%xTuHcX zJ?9vPnC^95u!fA76AB8tw!xw6(f0?sghRsNc*KvNKf}6)ec_S`i4;>_44eZ@^C%l& zk$|8c#}h$GTIB$24$kr}WO3TgpelxFv z`>^)CHMJQPx6NYvtV0O<-z8>T@73S7fo&Vjwqb0)+xxt?%1BjU+hhAZ<2d3yWe@+b z$$i_7+y1=K8YrA#v;e0{qz)|0!q#R<$hpE>sswM>Hyn>=#2_1u0w6QM7$e5pfDkgA zZ_u^}Fcs5Ef~LXCnufO2e-@fAM=>vZH{U5NdD_&k+@Lzxa6JB3mu`Ua+&HzM2 zr4*)R!Pl1;JiopG5+AI!Len_>_~o-~u#wL0rr~#=6E4>`jN^=HoH36xUS8ht`g%c# zk@@!802209YK68AhvNa~^LcMGc~39R`R)$=kpX!e;0MVB0#hZeg)yX0JUl$0KOChR zw0M1eLCirmIbO%y*sUB;0cAMYzTIvTq8G5Ni_CC1-}FrjXhKGzHA-U6%d)J>vcfa&?+W^(NRA6D`cmuOtx#)( z_maYD9ITB{%Agb=rVOPsDmH(P->cza7%;CBeCrrOSQDoC2BkFa&SxBtEnZ$;5F)dL zN=;ZpVjI>ejN=V$caP)wglQb{`udD%y5ev=Am@x}9x%@fN=Z@IBFfFra;6)&y-&;wHGfjvw;Cj1aS{4)u*vUEVro*aO8Ngs4UPEb| z&u5&^_jJh46RQR#VO(GZHjV>^+aMQnMcbb7@c4xOctoj{Io%V3f4pzdw4PbqapkEv z2Il8TMC{gw2Ox3Gb~k@oZ!<2-x_^iKclsaxywMd>O8bKHEpB|C@#Vgl5Rwj*h~NQ}WI<6a`;j%{*SLqOLx z2rD#||N>RC;T$Lr9app=C&7T$MwetyN<+ZDC`5B&7g z?{If_w+B1{1cvIu0k75slHP^^fBX6Gm;?*cb}c@B{DAxWGv@gwGYSRg35H$Pgv;9% zm)9%iX~r_IxV&C5j^lg#QYwFlYtyR3;U*kApxZOB&?iuy0twK$iqJflnXv-^G)0LEr zHhK8gqJSILv`C*G%mOyLlje||UdZ6-Njk@kfW zBN%|4<%PQa3G(kGKV6&cz`3_;Hl`JT_uqkmJ>?B&y~}8mu)Rd(BuXzRrrXu}UUDl1 zDAA#BIP#PdD%cNI)*`H74-?C|;O_p31}tMR&kL4yV+j%1*EB7bdB8l)7_L{8l3_Ge zMW^!_r_&j2*W>x+3Wg1NVUU%*6dr~v#^DNQ4Qk2EX)qepwby+U-!_qb!GVkB(*1Dr?dV3G={u!RY zIXKNC0O3C~W}7P&8B#KQ%Oytzp?Bi?S4fdFuC{HNBNHNW;dNEDv`XoPje5>_nJh;>=;>BAF@K2SO4J(SUSy= zW2-`{yjm&_{Q-^h==%fy{O3QRl!B&lIGs+S-r5KS5-+{Yj#9#HnDE!X{*0H`SJYDR z`1FXw;ehkqJyHRdX@s#J_xE?u+9Rcax9bhBudf&f=E6_IBvmChdnbz>Gvr%V11NHR z@X*KE41=n+%?8pMtu=|rhKrVU4xOkCbIy_!sdfjt_XZU-goY4d4PXuLuOc$?uIs`1 zBERESsZ2`!9qsKUon5Jpp_%_%2*7{}TO%7^83-Zg_ip z#pUe+pyG5o;&AK%rT2-q@Slz9Pr6FFx-N4M1in z#>hs)R!I?{r8OEF*q>`xc4L{8{D9-lr6 zX@D|Op4x%q@yLL*T9~IX+%Vp*NNYf`d|l2tw0%#fbK5fF*jS))t`gS;Q32n+P8z!S-nLkRQr_n++x%kpzkKu94li5VYK!!Z5mMzAiW)TbI{b$=`ytjL`!{;op)}U$JE>TuW!GNJ~Mw?wC zUQEEUiL1t0SykMMH8fA?`$}>4$nZxjD z4w$9|%feY=Sb`X26RfRRmKoZL5T)@r9D1Ji*9A2vdCvj^%5rj!0f2**d7Dx+cg7rH z5;O1VMPjI6DHW&+Mxvv6xC>Yp9!!jO!hIte9-vB-2N_0fZy7(^b)8eiJk7|tqU#RQ zvI@9e2fV(#(YsQMT*pObdK7Q0b6{Gk)w?jMZCm8DVjOP>f%8uO^A6|JJyKEc%(m^l zLGNC$?I4^*s;m^Rp_nT@L)yan292X}bPeJCP?sqTpx4Xqo5(bcD5b*f)q2FTtY}+` z1gtd}#{u&^!a0kFhX;}htPvyW`}^MDw56#3-&*kBd3@K+<@4|U06;1c_5Q!xB7zDk ztz=QBnrmyL$%$LuTTU!lV`6KBF7x-_wYA%}7LL{$MhmtAKrU4r*_kb)%3v@fi`^E{ zn`=Q%MfCh!P`&f-o1x)iqjZ4>iM|Zf;rz&03#$#osI0^Bc*Nm&5X?kChzVZ&EiosI za=Sqr@Wd_)m{9}=ZlB?X z$*+Po*$)jk22;V^jE)vQw6Bi8;_79Qe><`%^4{MD!{-E zJ**Rk;f9C%GivKF&jZ$V#c#j-9l!qaGp1?A)6)YzUv|rH&nT$)!%sgUtTX=4|Mh?1 zFaPx?47WE7EqFgQfCDYrMIYL?=0HBMc;W?s}W>zjWHvpf^nGe^74w5GCqB>aIWI{ z9QX)xyKb(cI0${6{>l>*W=9|N}6;>a8GLVq~&@}CiU2={p z$Kf_pbm3YY4=0S{hZC0QOtkOs z@>AI?#6%urB!4KZGT^29MFH=?NlA(P_6wros8WryP&MJKh0#hBXad%fmI7xW9Q1GP zk8MyLVnD@)iQi6V5g`SXNI9$02DNIeZpG<*hu{D7dz{aAtWKthajlNIHn;1H%i9}X zUtTay<1WS3#^QWF<9IwGXJD3e$!(@lOOf1rD(GSeSl4+!@uOr>jA((@@%x}tecL?9 zEc#aNyOr+S=Cb{4rnv1SxXB~G-Bh*=m0`Gj^Y^xv+Be@Pw)PwUH%t5LTVVz_JlVv* zY2|GhKw2AwW7rWZn>p^=%4mCCCuQS*EC8)L>fS6J7;RfSwMYGpS0x~@=g zsIV}Ws-`7GSWk3J)3z{5L0bc54GJpOWkKT{oYg2XVwnb%6!GwI2cyq4-6G@l@|B#h zw>SL#=U?&s{K7Ubz*t)Oyx3zeaL(d%I-qeDzs{p9a-0=yhpz2@scIt@7@;-0UFN#3 z5zo&T9E(o{Wn_-E<*_)Yp>#%=**>Z$@RoT;dn9(C1l~Dj?R1?-*Ym%z zF#uThK&)k5Bq*)o<40aE!}$L)_omUhW@UNqHRpWWuUp;j+hSKoS&cx7Dyo1&KtUuS zfX#`bK?4V)Cnu6L%rO!D5CYaI8Vk+^6i&=n+LIWMF*crdbX@%Q7a%Eb z#35TnjEd;ZeMHB|z*-i{YZn(qUX&z>$o8!F0@|~lEY&1gDw0Yo20I0yHCicAqQ!r| zE3d6>NxjIKmDz7ERaJ$qG-kfyGv7jt?=fl+Y9isGp(d#tSu(FkX6XZH%1 zFJELfo-iIySj;Q&&$JD`wWt^qZ4!+Riuq#3Y&Ii!N0ug_JZ;m^wl%@qr3tmJYwEV4 zC<^J_7jkkf%RcMt>k>f`6iSI{FiVRVNTvkfIbTSND?TqFO`-wU;af{Ruh`L&+q0NX z&`Q&pFpV)3y^`Kwz+g0_bOqkFc%?{;l4QoVV!ja6f0CxrAlS8~JEbOI3`y(Is*zy4 zydW`VDew`~YA-I>QnAQfs2k!Z%jd0orlnP##u+S2(ZP5!jt5CYhFqw=&Ir{w}RW*;^kQQsFq-Xi?u8d;V8+n(n^yU`A$AaB4yP$0wT0X(t<_ZvbQ(IIm_DG8Y?R!l2nwrB4$uD z5&KiOPAV~#qLUn>{(?I67q#^AyjSQXC&7T0#j*3ebb0q7qV&6r^{!&+7D(`T6=y9S zvfoQiwF?3?3SKG@V+=_Q7n4dNNRGTtuqx2HKxm~h@m7Y%3I!&b3AKh8dL>wrfDM5~ zEsJQUeUsG{p*tJF{nxE$&>wRA_$h9<;SBx$kl9SyM7{oyUQyuMmP?l|v9)=TOBXM2 zb>}McMJ1W*S;p$>I;$(|lx0uafptyOM2vh?w*>Dbjm}yUtthgbEHyYMl4N5*U(-*O zYEhHKJoIjZ?ocn?%iTp9??+L`g_?+g@t%N1uvU^^6;R$&SJDEWFBa5`2BYM;bzagOMM5iz zJ`)cDNt)uknvOvYpRzIDAcPd9Ci z(t#vP$dVL|4AQ&9P1pL(GYKUdPxhGCbNc;^!JyB4HfEwV^R_`LgY{6B5`)|?4GM$S z0=iTYrPSqB$@?H1YLa$B7!wa|vMy<*1ne8*nzO8=%*4!Xmu+cH)5w2ol`t4c=c6nK zRMmna?V)o;zZf#;tzfQE!zJUZ+3Id<|Sx7~IJW!Yyw zubD08(I}HhwTfpln_*QT z?-i7Tk~|)8j0a^5{o#-*O3S-!lX^bo>8qEp^_;e;*txpR-tLZ6f=KR;R;KIDMx~ru zicHchWn*KFsya$gfvZ=qlBTke+t$kF?}I22`+bfbJ;v$Nr#W);cx1du9*{V|#VFft z#$8*}+m_%gTbq}eHLX<5^M&xT2=QJ?t93G-VOvj{<{UaQWH9Iha?n~`TW583m43fZ z)6`4;+1}nRo12%IPNr0g8lx41K_9JCf-mII<2$uAX!OGP1DvC z*_x~c@xa#WNidhRT7?s4QjIo&pd2AWHhpmNzAdZ$ZuaORth1}!4bIkhC%&yT$w`we zR;Bw%oJ0kviO+RNl9;mDV4Dg;pv()3JQq5N4~&MxsG`fHec3p&T;en4b3rPtjE0y* z0>oNtX>}q7_UrVyzLm>V9Mww8kWJ7O@=tWw_cTcbcOAqe*r|)MEF(6`qM}F9S}7|# zC>?6QyiuL}*ci|T*N890`he2W9j;A;vo-Oznob_IY`1h}sC5<{5g)R+nx$i076a+| zc0Ea(B#c&8IC1I}&pLAx{goB!s$sU6qtld?l~pN;ouh6W#*-;~lL@oMB4(n1C|`OE zhbt6$pAb}R1xaM0>jSN8aWN%xIjC2PprqAD zv;uUPjk;~<@>~)legW%50<7Z8uVTQLj*GHvS_+e-m^39-8s!7zT;o--`wFmF!E|!s z&bOp=pv7WTAl317>ebS{Uls*P4CHFsI`*E^U#7BOjcG+ZIiWut9cIm`?OBaR%A`Bbm$3$Z{ajK||B7nau0`uaLY zjvV3W(W4wadUP52+$DfEO)UXxS})1vy`tdo;lnuJE~6!8^Eq`RX3Kq5XG*G!+}kY2 z#Eolpb)7Udcm@4IpMJkjnx?dE6CLU`i|LH%?jGCQ+gNKE_Im6NM-*j0D!!y^pn;}p zgdB~EEiRUag%F4`-xg~XS(=h-h0!?yO=AU-v{*>hGM~?7y-|wYovTtAx0Vnbi+M{` z&Dq=CmN{BdFenG;U__PXJ#D?fwk_Jox}dbCC`)?%0d1TgHCFOjh*1Ue#R8?;IFl0Y zS?9y^cru+!wdrM+B?`rgItqAty&h?vlO%z}L=u4y1TPhg3JUK#uUH}!bOTleG!7Lk zbu~jGDiVaTd!BLs1{82CXjRqK-cGUT{jo!TCz+M54{s2 zZ@*Vytz+8AkXlZk(aGwiMUW;bWswUOKQ2gVCQPQTO`?s#D|rbTYe^DCnxvBDVKUM@ z0V5~()_KqoMW5wlURp0{lE%}6l&I}B!>gq0eR`s|LeytQIT8~S`kX_Xl)T94uZ%c( z!)eZ(xrw#44X*C&GMP-t^Mcj&HOiu7zL--_8(fg&xWq`s&{$bui!xz-?I2}uKi$as>xrf*wE6B7>0vZTm!Xj}QNarobQ z9~WTRRD#k%dUgS8J=O`fC(Ux16IoBdAnCi3xY@Q1I7`_p8T3bp!BYT(Wm$+4Xg-q& z+(aT`%U+K%E2RL@KrX*>iBYw6(~_hXZ9G17Vh#;nd``hQ5+sZ*Bnqbjm95#jx=m#* zy}^KfIURj#yh?XE<7A zxUxc7mb7h4l6GyKb}0;yK(ZNaUE!J<+qP_8I*+q8qm^}h1EUE>2ySvP0(vI>@(m1Q>3={1L&bLfw6E0mo z&r?r7fwzvel~wF;ojfZU^oMeAb&Yt(f@61g2Ok{k>udCSeYUr@+1%V_GM$R4dJ*WD zY(jL9u8ZU+dHMOj_HQIW7`Jm9}^k zM(wu_q-Q;+%ai%<2ivkp*3~{AOHSM}?@1EFa4_J+i4&Z<;RX&IJHpC_1c7-6Bkz|d zpES0ovMeJYeh6a>D=VucCSm*XB_>rZCyc>>JS*@HW>evbNgFW+c3H`{uNHHf2$WPx zVt|{rMk^~rRv++A$23R-D#d7NA$ceAX=%SeYgH6jXzE5z_N|p`rj%JKT7>l$AO=5) zAzV(}N_D99Kqm)RN*3rK5<7}A=GjE$ozf<%W~4plgP_O3ptNjeCdp7H0VNSwPLj97&5Lgvgi@Ur0yRl~h-$d{QyeDzkqKVR)+(| zlRd6%U1U1hVK`i6^YSH*9=(C}^`jK!5OhkK74m#&sgRY1)(KHO5XkbBvM4Evf<%i9 zes6b=z1>~*#(Oy1GVBdlJF-GkSL|Nhk*p@$P`j3peE^koz9~r3M7(Lld1dtP znK%os>sn?^NrF~}YR*zk8@z~UlBhBh6T0A*ilPvtzYj}ATPJq%OUeH}ZF(^1V+S!P zZ6+z2TFdNKHats~rj)&MsmfD;xqgMqbp}^vhRI}tF$ts55KvTYEnm3Iu|ZPbj7iWc zL3@Yt4yOW*w-^jQ_AOg4Lr&|W^wB3^j11j%Jn>qQ@wIUf4bjKp6A~aOy&N<*5f$Rx zHL9~~sKA5}1qR)G2fVc+XU#KKS4SK^e3)BqxrLi=xrP4vnw<1vDqwNoz;a;Mp;lV& z(Lwwt9ixa4xDs1@W!a-B`-C7$5$F&$E}n$UlAhbia+lO&W2FD?YdCP`T`l3EwyfH7K7@c1}0Z>^8YE>U20EgAslJ>&6o zsf6he79k+{=9##&n?@2Uo5sfs9D@&vwrb4c z);;m1bjvQ8u%&h<3$#j>G1!V5`KxbyHMb83WYsx7@V+P544_D4bB_r1tSC^aJex}G zn{MU!CvehKhj^dUc#sj#!(uVVw=F7&_ajLq--ReEUMv<|+1}=C|13pWa^TQmfpjJb zd0sG|FWA}HL+c57p0T$#WNK2;gDXhM51)XL(#Q+ z>!!g&gnGuqmPyFV9yvlQKXBj(x4!Dz`JPvvp!^>#JW9uTj;OR$kjt`nb%)EBE>dPG zqtTGMHiY1q&&GJ~nM`IltJv9@va))RjRQx?^WO6Mnnd1pzX$@PRFEVB=gjf~g2bxN z7B%y#p=vBDK+zj891U4aCrtJxac0yopG_H$ud+AW71iE!OrEBATVtC!HDK!js>m@~ zW*XIE06H(s!5J-$6HOX?`DLgifck-Q4qK*{NN{I8Dgsc#Og{UOsVg4HbUluV= zodmlhm0YjSb=_PV?`WJQQ4qAkI>&fArYH(=`SwcOQh9|aV{|J0RILa`EosI|DO%@1 z8?wAdH_msh$E&z|n+&6(5-7ww>81MdI*=rg7PBqF&4>^OUvGkY>KX zE-Hd;DT{*Cq^z#4F&qq+>Me2gHgTvfCz-ZsBygd1L%pQS6Llwtmbr+Lf8RQk@;ED)eW_|h#iLb%Nu~W&)r**8 zE-jUAUe!r8m5Q7xukfxxCth62iR1w}d^7^~F;T^2QX#ws?a^_@;;i3iAq8opK|mQL zO119641uP#G%nCK6{*QY-DPg#8~^4T`Gy?aGwDA`)2%s4Nk+P>e(kvA=5~@`Tnd=LK*L zEmvvsEMMa7gZI$^?3N};ZygSW)h#A5aY$_-&u~sJWzZn5Xl<0tx5XqOUnqD8jy#^e zM#Dby$%OOg&N8hQ1SM$w0|yQe)@yoYk905;gh!sz6d5Uj44CbWneOd@_Z-;RAkPbW zG?jt-yS`AU?AL>ZJ0bPTSbWOmY3S=|5@t>XeAX?9whB_MP^^r?+WoAUj= z7wvl&79{1k0n9bS)P3VA(VHNOE)fJs#ULe-MB&CPb}c`5qQptwMXG8g`5`*ZDRV=X zONd%si$^ImBudw9^2ztUkEEy3yH7GL zNAyBNZ5oWpu#Kk?MSJ`Nyi&4Il_eW%>y!h@gzpaqV4$%Li^g){D;LP~6k{t|Wf+tt z-nAqq5YkeJ$|@5%dE*E{O20N(v}wNzztc1glgSus9S05_;@F83B*|g%UU*?_O{a4% zT)c$$E)Me>F+2M1S?NR-(%#(L8;jSb*CWewHa0fs^#l#ywk^}yR74;s>cxWH9of7V z^SMZywZxJ;Ybl;}n&YWlpT*OU@S#udP_^<-mA!)bRN$+LG1%5Jn@%`)?i|}&+stM& zs`-?wJDQ@%$?`P%R8o?(U^25*%>=CrLWFj%9XLSIE6}xy8T6Vg&##f5%iIpcLss^L z@>?wy_yCKDyRWO7MeDe_H(@#%ixDvxbdu8_tf1x!tpaspNmWDbTjq<3$#fQBQ4Q5}O7JeG-)1Ny??>%gk;evy@Ct+o5|DRN$4VyA29reDyLBQ8iON%8 z>Fy__Bt~JQDpRXKnx|+jC@54Q(NQTGV#kH<^;ApsZ3j{%7HoGM#tSE!6E8-FZXmh9os4raNi3Smz|tR4KAfW-7NPo&dxH zk*GxS6S87Cpl{k1<>Q88#W|}?K%?-{E$*G<&TFkmltQIxyzo|V7dEgY40n>hTyAi$ z%qcSQOU&mp#=ASzZH-Pe*qWx76NY_EnWKZHsl?|pC<=-sL3z(;&|^N3DAV=z4MxM2 zC|iWVpih#>Vw7g`0C{hyo183{9P!i;_3$1a$MRasBHl$5hajBBWp6j)YtlSNrO~_M z!M0uodF}oNCe=&3Got>!2bPy}+- z@VSqCjwc2y&Ns9G>U<@P)bz@^1rewFMC`Ij3T0@)-<#|q)YqDIjO!meT(ky2% z9MSLhm*!le+HgLfF&XbsRdb2EZAENg8_8lZWiL+D0=t`6X`DkVNQ}l?fq@b{!$BW! zEf+6b;KGFq?C$MSMTn;h8W$Xng27-I4;%?vd%#dN747yGI!(#@1!=CS8&8_0g6WTy zwX}2{Iv$>~EF&>V1kHLd35!_;-qALeY1OiIbr0uS%Dl(MfejYbl%&YHc=0ULy&Z{n zHZxgcg2XiIB*D`y*h-$6F0d;}Q9%s4MSKT50o4Xv=&V?Z;Jj=MAs&jHbO4H&P2_`6 zxJ5J}5e(K^oQmR~)WoXaP^*^IX!?DbkIZMYNNH%65@&@Ro(1zFI3PhbB@|H(y;v-w z+BGcEPMx?$#JBro_3QDuuA9s1+S<~5Ro69Tl2ELz(PegYxCQHMl);KL)&|*_drxNm{JLo$sXsPX=6(&&?{0}XW6^DjSh}1Q7GRs-o3)^-h`c)~TdL2Hr6b`b_$ zshgyN5ow(~n8rw8QxzAZ(#we{NsPb-18AgD3tkW`UI|mmHj?nz`9?ZKj5eA)7v@jaosH;bi7_rQSz96x@X;c&=wI+qiF)8(y0*`Lw(8)V(f zqzx*S!;Nig#yeM~3Q9EPAScTciheiHC_oEX%6z&g+t5|t5x0X)HaE?&6E8d9{!Q zRT=P-DQ~@}j^TQVG31$|-y3jX;{XQ_9ukwDPUynov@&QFu&rZ0pR;-SGFP{^SxjdH z=Lk*?Bq4Yf^EvZ&U*5gAa+d8)O|K{^dZo;a=2Lpn2v}7W=gysDb90luy)lbw5oyvg zlWDD^ZY(tq_mqXC2s*#UxBbW8;U`}t zRe(GHpLyN=|Add!`$+yI#ujk%oB93Uc?-9iz~W;+!?*nCL-@gn)wKg)5?n|)dh1=> z``nwk>C_<(tq)iq!bfT#0xfpV_V)elN z{LsJp4xW>Nzw$8u@CV<;pGWaQa^maxw?Fw!+haP1rB|5-)%C zPxFOo%I&ZDF5dEnZ{&gJ-pG+rMmxF8lb?H-_rLR3`Nj7=!F)dF(xpqBJ^KtrQLwgN zG8&FJeE0~LFK;rNE>P2G~I zKlSaWF?cS1{6T*EvpXVys458J@~*3zE8AOKym*n_on65iMS^j5_ut@`{@Ke|`>Io{ z;moVv!1rJKOMaU_{Zl3$>Qyg9`(RR+&i%;^% zXFkpc-}`<(^4JcfJxpS0+Ylp@rG*L}Gkg|*<#o4mRD-|rB=7vtd8SF9Bd3n?>=P>- zS;^^T8WR?L`j4OH3#!lRnw6My8)#aGN;3K@t0YEK^!hjqjg@M<7#!fn7u>?<*<6BbKuMP1g9He6 z=ox9@@55k?k(p$c`HZ^;hN}G0lcHBD}16! zbOBysj+?fY7FxWljgsm?YcZWQO&txFlEvQd_0VOy-$wB*E<3{;|M}nL+iqW3j%fgr z^^-jBmEX;CA9#unzT+MI!P9}PSm$fL>3jJ0m!4*DZDc}!#IalM;@B;>@tjY7gkOID zlWesOKDhXEG%-X-dZfjXdwI)0`oH+WSDgOu)H}WPUl()edE9&2@zF=vS6gK=KtFoV-JH=6K%l!N`hCkQ%4 z=>px&js90Z!QyR2aEj2Tw2KAH!@S*N=h9g&j~A@2u2JL(!OP*Qd$CmSD2Hx-fCql) zZT!e9j_p@UK)QCE+h6i}Zhzp_y!JQ#A#eJTkFc||%hOLi&1kermiH-#tE{fBarD?p zvRhxy-+Rk_+%&k>>XvZ$%$>aA%$t4lg{qvvYp=&On&Uy@naTXaBMOEFfwY|-y z^B0*-W=nZHA<)_eRY&#Z|MW5`%F!yx#Iv=z$x}}~O*r*(e&X%l&I8Btum0m^z@Z!N zD<|HF^}>_a?0ZwSFK7?unM63V4wR?q&&<8+VbzVHs7cQEDJ*M}f2 zt1Qn%C05l!$5zlf%c828PR49s-6J&`?^=`|@ohi$_xa!NEdPhk+F;`tw{0Bbwimpd zH~ql(@hd;_cK-gmAER~_U$wZzkQ;+h28%)k9V0ee1hWc8$N3N|EQ864m@pfd*A2>~ zWJx9>rJxB)fShR}Hiq$JjMi$Iqf=G$W#^|TdiZ4(B82d!sUz_u=D&DP$RW#w&HynA zIfP}rdY34xjUmla;D70+|1W>8@8(jqsK%kam>#taRO2}z7yeUeGHJmqMEcm^1-qaW ziP9LQ39ZLB9^bSyL5RjGH6)3mZ9Pq0v9K1Dl40&OPJ56LuYRvwrZ84ji&l}5G_JXJ zejub_aKT}$qOHaG-L|b{Stuy792>c0-An@@*gh|K%irZ&?ik_rp61gJf0`$@7W9wa z%3aTY4kv~NRo=kMzVp?5@om4r^u=%DyIyvh+|Rl6=$Coy{0>br;>4}Dam(QnP0EqK z^dkQ9*-d`xtiyUakt`N-oU_d54Qlls{?SkUL%!qYLMBp+OZ?eKKgK5>InVYq&^vr1 z_q_b2yx@ib>EZkM;dlLK`rq=+yzL`9wASPN0vpw4ol2~GpmZW9r=UF;sdo6n$NBW) zukotB=D>?y%026U&ZibqZrfH!&E-A!aBu(Go%Kdu^5WzC+!I@%6-kyx1MEyiJj%(TLG=#v(!c(C z!hiU6e)DP1VAQAA%h5)bow{kLZLweC`-;V)B3)kr6np1B&j0;So?&g}cE0m(y@*>9 z@K+z<9l!J`o}SO4X-E?V!NL3@3u8%Dg$aggKE^JefgQHbeuZ7H8T3=qWEG>ujM^=L zYIrMe`so+)iaYu+Im^Qzd5F(HwL_C1;`Xn5885nN1*3A#e9MpVlVAES{>HCe;;}~` zV=!2uD2E)*`($O08}5A>Z~gjH9FB~)>hhy}=tH08i{~bo)nnZCq8IVvTW{j^Z~p;~ zexcZZCv7Xj31cEC)6&$tY;Rp5qPtx4rKPHZNYLt{PIM z$c!-kGVf?({)`WTF>*d)hoZ_Y7)_=`rarG*rqv8%syH)EDSI$*hCGulOj~Qx%m5ix z?bz9wv%9;8caA(y0HLI7C9J+IEg`hHXr4tyqIwWga;F>=FH45aTvToX7}~a8icGH8 z=lZh6rc*H$X@!e<8yzz#1Zdl4iBs{x$6-0 z5DjTD)iMFJ@t7nMNnOpNp5tsAA&uQn+fCmBT0m2TAoGl6R6t@R-ngn{aG5Wb-U)N_ ztN3Qs^3-qr1K#?h@8;fx8Gc#Ld(F4vplPRD6vdC&fjF7$gzPmYOAk^o0a{DM}j;DO> zea~V2zkHavG1P613xVF+*Ydz~O4$@APw@H2E0Uxy`0=(uYtQ)6KjGIt@MS*pOhv5{ z(kvRslwvxaFmDXcf6Z(7-mgDSFIng7UVAs6{P|BYi9U;}st}C5UK-itR(o7)Y3c^h zRJ&Vz>9c!`4j*D1?`LRsc>3}4d}T3%W`S=T+IEgnj$Ua<0ytX}np)iBC} zZ+Qdv{I`F}$7WMDw>CMlyUWUf!}Qlr^0Eg`%El5L=Rf*i_<so;V<|-8_2lOs z;@`dN(>(mx4vR+I|A!A9;`pNAnG2ui4?g&5Zuz>G@E!LZrc4g<`oI0Xe0uu3{Lz=b z%(1vB8k&6k~E!1hiTp&q|73k327FL!g~o za$_jVA^l!~Ner|3jM=iFKED_h|b6q!=&C8d++K>}JOEi1Td6sxnkpe5Nm*|y!+`3dWB3(@AQs=td zgKKj|y7WbBWjI#X3+j3yOf%Ktw`K0qwvrWpZM-ikAofKiGQs$Fc19@c#3z!bDdnJ8 zmeESX^iTc;Z+h#0sR`RRZ8`@Hz)znLT2aPq$U@sm&TZ-4k7^9Q>n z!`_g=aKynwIf+{E(O>yZzUGea<$*PgK6nH7+_b^vC$AEMXE+=Xd`olsHGJ=VD`-69 zkNh~V{qFz7lU9r2E?&bVHMEP%eDq(unYSEyKkt6?4VY8k%3J^1&+^c(UW_kmRF(NI z!Z&U($V>~}DZm`{;z>U8;1js#-%66)!o7DXe(KK!F`<=0Cx^K21vg-T_OtKgr@!1Cu$*C^ilp;L!75$a6-r@YG*nlP~WX6zWbH4D050Rvq z1S1(Bl`0_1GDf2TdNSej@A+NcdH9Wd_gy{Ak+0$26QAP$-KngNuENn{rqc;+)39>-FlT!5W$gCjyz9Y=hY4wxEqQSE8c1$F zI>fQ#2NjUx-LB{UvqC;a)l z-p+US4)dX(e1MV8xb?4n8?XA(`?-4fFhwCgI7h&!YZ^34;rGt+zK=e|71JZhB~UFf z!aGw+i||89L~*YyX`4Et@fQ?D%KFBtNY#T!sW~5h*ZVO_u{s!XP%ewNsJ(o%5~eIZ1?{j*NXaTI-Rnzvcf1!Szda7ncw~Qzsn<4Aj=e!d4(}1Lg)tU zJ^WD~+Iti9qmi79$(HmPA23J}mh22Onbdt+#Sa=iGhoZDhalN6e#I#}4k~ zzB^MCmd8K*hy3Q}Z|0x=_17?3e=hgk9Qg2OHEZi@+<4{;H$U(^4#(uoC%*U?K2I@G zsg@c;q7}ZWaNc3k9DGYPv$zn*QY}WnP%@uQ`LjFWVE-E&P<+ z$@03`zgMQuaJ0(onTrG@nt3suP^&%cviIT$uA#p&A~!j^SGTaP5jkz`$!ZT?qx0q( z=YNB%r`R-Q_i97iR%jC_*PpfD(g_t$e(7oQlQ(eRizO@mPapnMTvbyR1+M-AzxjJl z^8L5oL}J#t`KBR!Vvn7jE1Z4i2{sO$;l87N`7WX5?3ee*PdcvAN93hoTE^ok&zwEaxr>g!eE%)vO0LN#-|-8)`|+zx7c-ebxt5|V=naM#ov{6$ zcko~T<_met8G{}^hnKwMN&awiMNGc7#)m)_eP?lH;oM^vxoRZG#e0bqHqqScoTPsG zAW;NGo-i{a$4^vXWzeT>g>JCBH^q6+>gp=1!x8I!38VZoKtbJS%}-IV3gGF28X88Rm~9k*Dh%BWNA*&Dbrd4(aK(*eqY}A z<0ntBy0S`YQi*Tw0ILNk?`anmNjhb3cZX_TQ#US#i+OD8qais&jJ_NUK1yDoF>bSpbKw;eP`)@ zDT=iO=xaUC;9lYO8=y9K>Eu(`q)@}AWTx7T=?K`TdMpg$OJ?D$c(E(a## zD?%eS7N4hNs=3Db-{M`3Z);4ZAy}-H_RMnsX}5U%>=d01ICImj%ohz`dGbl>s*%}3 z5_snEr*Pavg681S4KzEkl}*(up-R`REYCc}`F; zozB?W-eNqS;IcE^ezR09*e~(k_dd;{ZY2}PdlHkdGFs!v(W9hE&UCuR2R?kBH=Q|! zQ7NZyI*Hz#iFr29mUxq8<>JPiy=*0$sHGSrdm)$d9hw%38Y1%P#%)Z#EnKC&~Coc1?zMO z_l^=O+0@z6W7FC;S}^6}bq}hKYAC{f*)0&oAd8$56JYf26Ra4~P?u;{uTpnC`pf5d zYTD4ogvhe&(I2jm6+Nn^qG_gFoyOnnE^>Y|f+Fi05~!Pst*uRrF^pE$z;_E$z)dc5 z6uWz3jE0?u z_~>UEUi*?9bMjv9KVf67$>xcJ;>PoY|agbBTk8^yN>*$XPhQlF7EB3~Vedqt8VHylUB@Bl{ZoKIhZolI$n%c5? z@d8=}R9j;MH1er0M>>4~r>Rss>9SF+t3(MjYj>vjo?o2_!mTl*ike*<_d07zV3D zwx@e+T|Up{^Ur|N3`ZjpU~uGFeEkD=aQCy1aH#)3f7TM!@YGkH#OsuPUU257n=wZ7 z#1mg;GTozY8$!&aan1`NeRYkE0|z;N;v|QU9%r<&ic*S2B`*8X>VQFiAZVv^=cDaF zW0HiPNho@Kdh;o>#T1hn#^XGiLNkiIKx-I}ud-+=P)b^w-r`!Bc{?p@o6#ncGnC}c zfV5`gui3bkYWEj(b8&z&5(<_@4-4#LTYTIU*nsjPg*GwZD@ml~vy9GlJ{pi>J8qfxZI?L`&I*IeImhmJ%Hr~v zD()A4w#&?eP9=w?KU(3?(PR97%)NK4X6b$3_j$^xZ@+E&?9A-WF58k^HnE6YDpZds zDY0x?avVFck;IV__@Bs%fy6KpIEiB;hMWLK6w9&<8&YCOwxvjlt%wwRr&yND<@Vi~ zxpV7VPe0G|wbLnhz-AwKfGHyHezOyB#?^v>5Mz8qs@KdEXb&bMN!p`-Mve^^PS&CTep0E zm2rA}h;VGaePJy{mScnw24@bVz>`;H>q2dOLdz)3YPOA<6QLJ9qE#(km~rzkiRz z!vhvq6>GwvJw4*Eb_7w%cs%CHb7QPKTs{CJZ}cM^h1M;r-kIfyFfywl0xLOdw%CJ?73!&$F7&xN-9q z*RJ2>O+WHe{Pc%!G5$BW*Ibj)R2BQjhbZ8otCxBF@i)`&_ju{$=UB`a6h+Q*xx!$$ zu(!vX9)B~JE?pt*^}WzDO0f>4^d4j5$%N5(>}{SLj6Hq z545<%X@cFDA^Ne_0yunRaW@^TS1zuL-LwMMyip;A2f*Cg&C?efCA~AQ>KJB1`n+-9 zg)5rIVvJ8TG)CZ@!XOaV7bIi7skG~?rM(AMcS-#35W;7P&}FW-?Z%4-z$$gtwOT__ z)>ssc1t$YgA;z@cO<2j-$SKOjoTAe7Qh#%;vVtH?2*Qvg?Gfs;jzLJx>FFs*!FW8R zF?RD>+vk3jzwp!lkXKvZdHTGK5Ggw5N0(6}q>ue|&SA|VPqo^US=MVs=}Wliey!^K zi~MUA8#bA>j%R-VQ|y~Jb6v%J*Y~`K!7u(M`Q*KP@T~#R^7O|)&3tJPvXEQisFjYYu2JG!@ zQ?ISzo#U*w1WdLk6rCSi-8A(2Lq@|b>ay_Qf7L=+QlGnV!Z0Gw3-0e9uqrC5){^&c zoDl`AAzNh}mzFf`vo##Dw|9xRyyXe%qU5Vz`7&8~mMi2;Ls=AvFeJ+}_K!1P%(`c! zHyDzxa@xjF6ctrf(=^6gpfv3{EYW|D9)u4m%aYk_Mp<~Vq!X@llwL>W%FUtUgZ-eW zYL;gm5~e9QJUQj1S6=1xbVi;RES4))W>CU z+$IgSZmTZW$D;Mx&EqW172&r;el_RCm=60u{ly+E=F;!`Zof0qv%aOm%M<-SqRR^R z(*jr_SZ8|(yp!k}^U%r%WzpG{=x%b6N}{xYz-?lZo5q7&-f=fVO1rV5@#c?S-G27q zt#j2o-3w+@c-9_`QaD85ea5V{wDQ~@*g1-#rj#LwfTo4Awn!ndXyT|xu<42<$bdNR zk@WgqZcIg4HDr0W=RUV<5z4y*TO9pdq)O zn}Tg|I2CpPx7c(r=Px18Saklcxy|QizxruDz4%YKJ`oJR`$^uJ{0?7w?~}YI6=3f3 z$&WvW!CUNPpZXYItN$cV#us_)4Hx<37elV!*z+&T-sh>W?~`4)$j*3+ei{>Lg-|^n zd;24JGFi@xANxP~^gRJOAj=Ahvc#GOYaObaI-)gePY7>Y;~aUGbp(gV<4K$E%HvQ; z91;eK`P?v@&8TE?)?f%loJIt#j}s`0lKx=8U^HPmJt1F}e!_O{90@=mWk}l=%;pQq z+TfJJMQ6KZh$ITR{?IMJr)549pW%>n&&4{3ZGQilg@p?ekTtSt z3AB%>E{n<+n7XDay@{s^LZW`Mxea8PG8#Gt{Q&~uqnPWa`;Oa5w$((X^I4Ur|>TNs_WX-ezZK zkFA}-<~wx7irI2W(`byVDeD4f#%Be(!(ElYNAgw`LFn-&+cv(Ta?q3oQ5cYf0h2+G z+4Piy{S&4~_tDa^JsHyP?eYE(y|HU{3cmSkzsleJ?dQphlF4MkL$`V)k*2{>GzDdC z&JIauF;$7gAaP8Ok1$Qal`9w68jl$DQU?8$UK(Q>!;S0L*d7nPTD~f&nzl30gd|Dn z4+q3y;G3%?A<~Loq-n~Ge9`l3+D=SeRs~5Kv9-O;_SP2G8eYs+RFz+!r@cPHnXWPL zQ%V#Ctk>LY+av!>o9@~1tkI^eH!dD)Z@~v~J<#If^B^QjsExa>F@}5{>eMtFP~SWF zdJ&(sou|<`23V*9wDyU5zAJ0Gm6}C4u}O;z!vHDUbHYHmp(lG>#+x(xeBo8z+*A>2jAnl3e(T= ziEmhR;L|X5_67dnS;Lc$E3Q2H5aAasSFdyw)%lCObfQ^uA6r+9217>MW30Nyl}r9s zblFS1c;Jvquv*S3%96TiyU;g96aP&4qV`B_uRWTWj84iaCp{c5tC{V;vTtxAp>$LqB~Za>7WvEvKJD^{z#bA_;MPbS>B zaf2(DF4Ip&T)#5xnjJ@e|5aW++((50G7z9aC+6(?YfB$lA-rJHxRx;Vlxf>GG-c^K zbSa5LjV56^6`UL$@WOM?ad`h8X_9d9!VYo&CXZb8K)zi(!|#3iEKKVK)_1 z2(<|m0y;6HUw`@Jx{jsf)fOnB5GZh6IvUoZ{&GG^<-6>NX(v#5K0&w$bamz=_i z5yLeWDtcUh^Lu$$oe)JKP1`V=PRUj)%Bms^BZkSj?p1krUJxD&DZa&*o~e276A?l` z%AfxC-p=3r>L)ShsMu@!dt(i)wVUZy2-o3O-72zUi+$%Mgg|tKWi3$McV9>2D8BefKC|*3XhLX0b&oH7X&?LeHS~?gc=UG5&G-y&S&b%? zWx?r*A&n!3!2s3koq^U>O{*lzK@dn{=hG*Be6GXVfa^DQH#B3{mXt-oGAqbdImTE5 z9r&I6`pr2XsW2Gyu+|XAW3-kS**^pHm832*%Er-J2!hbNZ^sGXGjaru*qxtV8}ckC z&l{4SMk!68wPy>S``tm{W4x78U3QVe&?19?8@Fy@?AAKV6NEP%ZH++(A!_+`KJ!$| z_q`)PL|3>N{3d^Ja+xrU7>&kEr_)WsD^lVnZ|A#TzkaM8ZN4DOAnro8k~sBDCF7{; zh9K~9xn)swHX^mxW(bgVOVyq=UDfiKzSr$ptTqrPNY2g=*2Tids~n%7nFH{M4_eE?wuSR5GA2^Qg@DiFQvCN z_R#{$XT$G0TBcHpvZ{Spl`#leqm}L`&;qRkRB#p)CBiY+Zrx^QYZoCD z{r-q3NoiU`6b+Di#3Vl3eK)P6u@dDpr?VMl(Q@(9Lkx!_oP%HzZz!KC98eoe-L@D9 zb$!b3{PWN9Q*U{a9jUne7ykx-_1Axtzy8@JdD8&yj6U5_PHo4$Q!*wDp)sOc0lIUm zAkI#~^_miQhRdw6GYKz!=JVV!Z{?;6c>BNmmxm_JuAenm~sE!5ywSA-FRF>>u{4*1K?~)HlGvj?2#l9aU2tb3MV5(>p%-c zoDw~_l`ZX)Bwr*Hv8BQwVeu~lp9f&glr+_Hb?CtpJ zR!EC!8~>1Z_|E06-sb0Jx`hY=zq+yx>F)9y|KjWX+}qzqBznBc(Q&{Ur(rw=U=YN9toim-Qvnh+Yq}S{Dsmxl86|}9-iUBZ9OOY4eu(dVB zbUH61D9^bf*Q-;Cs`5k|r75e5s;p=l!|(j7r}+<+Sk*oN03ZNKL_t*E_&BKudFP+~ zlYGzr_4oLq>vQGuC9Yk)%5cy}098S%zG_LH=cJFmi8qY9W+#7+&p);B>iV`sX@@bA zn*407XRd@%*#T^8B;Ua&)jyQ?|bB2EJL%TT266|&;AiXgmacWFOdrJ zrUtCH4#HyEinh^6{Dcxj3LPbswO8+lVbC>B70zm$YcOp^s3mE?N1y}hx*~}}dTF1* zV2sugZR=*IS zb@?CXdT_impqKRMr+xZKpI+P}jZ#7#`boqIgcWF^2~|j>BSIAtr~oYkq|`VeaZ=%= z#9}eF!8zme)dNKwMNywm|v+~=VyyJx18df*vqoxWx~+Tz0A6|P^q&8>&u zz@6vh{L;>Ui5pa1QT@ppbO@bp7r zal+y~_k9SN)B>pmLV-}A14S4IgmFL+Y4234HSU=&@VSLASpD}s$-83#<_@3v!VzKG zBMc&>@MeDQsju)t?LZE>eq(#1Z+Yp(C1svbR|QpFvsf)To=?fLyBwT$d*J9MPrPFf zSue>}Gn}nGcI5==weR9jeAw^HHw~7ly~Vn54NF1-85D4mACT5JKo8qD_3v=7TKI<|HhcfpKmFbRh>yJYO}yoaCwT0!$JpB5!n6)9Jj#!~|B`1vx`vnk?~n53c}82W zsEQeF?W2W5aZW@jy(Y(pbU`nP7^bOzW~`yDOWLO74-D}BhKJ-Jk5#^GiDp?g7hllq$JUpd$>)m|h!>{w$%=!|FBoL&b zrI$z$HP$wO0-*`Cr$`4jklQu~cl=Nb!es9RtYujur0Xq-0x~>TVZ~tEuB?yBl?%sWsyePoE!aw;de}&7x z@VEHS9`7T^Z{uhF!KeANf9(r=^kZM-={r+$7crPzm)00Bn5@6bC%#bG9zjk~uALGLppX0d~4=7wn z+~1vybxE zf9{|0u3z|fcsLBW{sVu3pL@qEeDm9Q8O0>gS%DTRCJX{9+hW@m5xUI^w{2={+t9WRv*{_*>6Gc|F;$Tx z@Q&tbl5Cn%!Gf=S?gifUAM6nTsMK!vQ98F^W-TCE6UztSy>f*`b=J95luG~~w3hdDhyW_o<=W3H{C zF*Q-_riTkMDaWa`p*+?nnLv z-~4a>NB+j2d7Le!7~Om~KYsJw{P-XGjX3I)=lJ%1moss`u+TBB+-t|+PFn|fOB`oC z7S%L|eEj22(|+h}9ZuoMKlcefv8bqwXYvGE6Gbs`IOm0DkFk$j+@u(mufD=7MNLtb z-Jf_P)1vTZd-42ReEX#dw{J{Hg(Tj2lsD}>`r6lKmOS&@zrsIz>5csPw|DO&8W1Nj zCR<@!1HxMY`8DX~FH&V0t@W5~r&3fC{Fr2?wcfWLlpV*)->{Ia5()D_Y?L+tMTgr@Zv2u364!%+m6l zqQ7J`==0_`zJa~%EndEMm6u<+!}Lr4D?jy@HNW^j{0MIxNTThBc;Y<|@x-~;YO|O4 zrN8>O`Nt3c7yLx`XT|i0JNK4^I$*I_vRY=eb>l^L-LoO2!U>-a>1c5%kQx=n8`%JO zrdCmu%x6=y#%Cp27!HP9ym*O6(r5YKf8`7G{?t3T*_Vj0&$U~9uKjEGWy8_eKFKfs z@|U<E+k+{>!g_?MpNnFMaA?@u{On_~A#dZThb;2nhRq zq9o;HHm7dpe!b-%7=(kiuE~m$sw^2)HBp=rrv~e4tW;NT`d@VVkb z__56yN82432HYtey52LZzPKW`0ZlM9Br%&2Nj(7jG2CCkNv*>r)m zj?2?(v&v|)8B%(M^l&(0fBzm$S^G&Vdy4<uYV=x+O3DU{m>mc z-fsWw9a+Gjr9cUPUmhIX!hIi6u>A>Z%KD z+Whh}XKtkw7)MzY98b?MBwR~XWEidJrG19I7}G*o*5s=NZB-!8sAZVtJ|_or29pst zAG*fwWWv?US2#F0;qZlj!B79iZ}LMw_Cdb?y^r$nr4c<*GdsM`H@@-}{^>vc7$1GU z=Jpe*e~Hd8Kb>-L7;NIjo2uzLgX@u3uvk7kuucU*pAVJKVT5Vt16#ixgNxxms{^cb{*6;~Bp8 z{0S$mMmo2lm}{kxT>@>SSxGO~1q{OOWNJd*PtLfB12du)VXzg^L&1 z-rDM%Q(IQ66*|ydym*PhU_fiU?qRW5u)lww#bSYJYLxW(=xKkz#fw)-(jiJmNU534 zW*i;gr)ewVBxHMg%+_Q~zn3B%?BCnxYhV2aFTU_H#u!H95pf!l_7iSBe3RYXU7Tro z?zw09)-zABT+GO`C1svt+PV{!sf`Dd=y>ew&#rAdMKfIi5&r8|N_NH87Y_HDQ@9H` z^8WjN_>{i0wGNbK=G`i!@jFl~*nUgVaWA=#BNlknz@t(P)5k-2~XSGcw3(-UUX6QVHSp@*&!hXHj}@$}PAaeQ=0 z632|ko;o@j4M~!S#hU<>gmi!PI{BH=E6=%Z8?IXlkFx87C>d{s5&lwp+tS zX~M-zmw4#r4R&{TNs^Q}Nr3qgA&nTOQIO%(5UF*nl!*~76&+=crCqkGbe)YfpJN(j1KJL4z zTgsxKt|~v-wO%vQHjURyDc^L2NlcQa-tnUK?%6@;S1fH)lO!P*FYL0jJz;lyoAGGq zz2ESOiBdWO?S1{4${+MXc&iyxH(u9fj9=4Dr<7%Z&zzA+9WWVB*xuQrH|SH<6-`sp zv?W?=#-pKcBI}m2E||@y9Na%(F`rY_B}Gwie0G1?PEkLd&Y8~UASIVBUm}cS_79G@w||7S zeoGQZ0mDI$KnRM}iur6#5Qc2+?6Q6F3SnS;9WwDX*oVT z<>=^`lao^~H0}*N_8Udqc<3hAuRr9W24j#|PEU^b)F(d9Z~fM9&@?4Vi!NNu_&gcA zwtU*0v>RE5KN>ux9|869<^R`nUI_6%;M0FpJ$Rs#i&CD4PG_Yr&+AS)n+YX70ADu^ zbyXv}Y!=Z?8bJ^ecKgA)su8eJ4zJl^X9ecG50+o6MNzyl%hX!aww5fUQIrtHDRt9ue0s`qu_P}GPG@t3Z5i}>eq>de zJkN0`v~H0yV7Xjye0%da2GFy>Q-8wYAvK92zM~=sn9)=@!WnE+Qxzo+gEcKj&KsfbZ0~XXp_}YoxWc8qZG?(wjAfZ;EV7KnYURbh z%8Lq(zQ_+h?io(5Ez#HB!@qU2hiwgISuvfSvRe4K>ZYnVIygiK!S3D`QRGcmThsc& zuLFb>L}AQmH1_ch0-`ve-%E%>MbPCiDI8^<`FL^(+WEC-ldZ_Il}}D=yoHXEiZF^u zLPZk?*tWzpUI5q{Lsb-1c}9{%oo5&{w(W2MkC#?;iD_$`X%YB1jUvxkEEbeSf!l;* zc@s?2wiHD{6orgOLnf1fUvoN(k**6ERIC;SuB`}7NLf_~Iitucrn5Os(=r^7sLGty zG*o2{wxzAT$!r`*upZZ~%L->&T}X&*JtPY-@isMoP%|Q z{DWkRJy~@B(qq(+cK4sRP zJ0#6(1eohTv({2~{~n~3$9CJEBP!TtM`WdYWA9$^q7h43kO zZhiB3A*Jd*52gI-?)(j;l-p={)|Zsd3nw`fR?>-K;hew}fxz$Vwe*tID2hpv)W;fw ze=my#QRLZtgW-^>swvBoe!tHu%V@2)Bp(b0OePcRy4qx5j7JlS-2c2(+UIQ;kEs+z z?rmCXPZ^Jb5Q(6!O3JciG#b+D^@t)xpd4CD!XTikQRs8kO~Z0NBhVqHu>@h_T>z~0l-1a0d<2nSWo^ItO}wR3{WXUf z%l;NSNwU#R9S?dO9UM|t6-AM;n4Qq?_qp}(O$LJ=ZELuHbl7DWg+x*0pOfL3UYZgH znlREH2<|*BgtOSX2G^pTFCtCrXo`Y5U(gnLH#t?^l-3eQ5n&L6GYD(3YvWewsLGr? zU(p-%h?0;njL5P%ZCjHmNfd;brUBa`g(D0!aTHMGj<%^h4wL5quW?}y14R@DKCG>- zI?adIsx(zWT@@7Bie=k)5u%jnAfU)=R?Ey2f3&1+YXA9Y#h~9~HeVrxcjFF}^3zsb zAv=2}CA}4tmWsNnaAHO4993Oo+8V7u3(wRPcpt?z_GvoT@VfS?yn$9o;V`B~3x&Xu z7X`vu;y7Y78nRr@{JpC+O1X_P|2y?-=S^(a#pOX>50)(!MBO$;5(K()SQR*n=UZ=p zcP|puS`o$3Cd=7(#m#1wRu;apx0`Bfy0wi5o`N9oamqsbHBH-krMR`Ul@HE|;*{;3 z9n#*AB<_)Rg=KwMI_t-CPg`sd%CnxrDD1?C60N+4l(CMysHm!jNc+QcwOV0}V=~@m z*dLSj2IwH*_*hYwC3RI|S~xzeSS=R*;0OcKBxN)hbK&A1&I!UWLOchv#fL_G3^>~zbe`?Fn9r%JlJR)V_RbF0SXNboX=cplEAlKuI3E|? zHVt*@RqwW~{lN*?$davAxWVgq+hZxufAMARti0Wg6JVSpN&0BH%Z0~Z&-cA~=m{6D z;M-3hvT7|dYYB%VMx!CF9Z)Q%*fz&VL!d26wj{A;XJ>-3hOAst*9}pWkoMA!!KsKM z<);ZLXzCJcTC|iNPbo6WY=NswlxWdPV49q!T2U7n)*9-{=h-(+OB+QbNgrb^ZCiNa zjZ#4pKC4I~aJIvLI>LuB27#rnDl+E?y5w6a#D?@Fl*Cz2VV2$Iz%#!rSU(l7 za(};Ttr!jmD6P6@`mB(^8K!;aPS0kV@dT;|s!VyX#l;^!0Z|xjGVIp^$Mu?O-8l;( z2tqF+bI!Z+t_7D~;cw2U$LoovHPlVrB?_!o`bRzI=t#(^Hnq%zq9_p;WNxM5NNNw$$l5 z5~v3?Sw@K0g(EX z*G??w(`eWK|AV?7XmKgak{}2+U+#JglTs4L@n-BQih`mjHl0Nqnhlk6{dY{$V44|K2s#))&3ia>?}cl%^_u zhrW(bjvPVg-$PwDWO>GXK4&_eQ&lxpS&=WNIO7AKs>*99r0k|CsoCA$W-u6V=k6;s zd5I7XB?W<=poF9@D})st-jfpO5TPVlo^x<~z`?-*ZBsKE4Vcd7w5Ikq_tqA}(S-Z^ zhcwoJmI$%dRroO+;iwz0z?E8Uv`6Rhs`Z4p{;sUGSm7UX%{ee1*A?-g>$K>cMkKn+ z2UmE*P8|eDsk*hMqZOV#wYJr1jqMb{n!0KTgOJf=La*ri#LaHy*&0J#w=9=SCX;P0 zT)2SL0cBZ{#3{YrfU2qpg0Les_z6}kMK4X++8UFlDF90A%~~K$65m}xs_@LDQQzZA%Nb3X5i1Cl#Z(!t&8e!2lcT##COwqAM4&7t z03j_}Ta@mOCf88c2B{@NdXt;h)X=T9+P0!x&6%AZaB_5yDqn(Wu*Pn(owU-J?ohMN z5XJ#<9FtcSRoxOujgXeAE+~$3R@t0hFQ%*tw3Gx=B07B$!Vv_@I}A%`+h)_ut~>Lx zs*p{Cb-pq3_pM?y8X~3Ss)q;ti$0?O1I=5cr6O&Qiy14sq{`sI#!%Nac~N*%IKigyD5db2u-gbC+q&`0mF|X+Qf+|YwQ#a5ORB2sIuVcY z42MIux3{@)VUMk?3C6z8DIW3h4C) z2q9Q3mMoSF>MWz5Zlv=x@o&|)#+EeIETXa4=?EJO~`n*0N@wInT`N zY<|}4z#s@1kH?f%m)PhWgTbKtZli8A7n^1P2U}ZPB)vYXWkywbqQGLYWIP%(9*+sb zh}mquS#u}cp~vV@P9lS-nsBu+wly_A01qo1aJ*WMj`bqmYvL%u30P(; z?0rYm)F`Ex&t@JpZ~YYJ&#KmAiAs?s2{ytcDQ))B6+c-EHea_qR5!drfg5Py>i_6q3%eI_yPhPVb-*Bu&?;bhI_30q%JK0b0K?&s@p#yEtuyp*Nr~Wn8uqq0gwnd20A0oywozFQuJjAr#=^+Rd zO;uA=rN`5hr_(Dn1BkdRqZBu&^juYOEyloH* zOYr|N_nuLgrgfR`?+#De;SCkLsuSHbnFf@`7Dd2-VnQ9jG$JbM(Gf-tqmGI*>R=wT zq7G*S@hBWT$Z?hqK|w)95llb>3f<7TtLm*c?DWJtoDctd@3$B|Yn`>M5AL;UbytU~ z+Iv6GbN|D2{VrorA+RVbk$nf`UaMu?wOB6kX>XHTE2Hut*-AwQaNCHkPQ8=QAcCTRqz6{N9rOx;IbR*WYT%CZ!~$I&4}-{Jhg zaye(dn9HQXNZw0UWcVnfNT2pIB(CFndUNGVXzf>K0sYHgS2rxI8sVMCm`wE7S_396 z`4v`MGLzwyV+dZ9JA+53WxqW1EM;yn%HW(N()qywfh@?LMaaHjGg;OR&J&}fCiC@-PV*<#dJEQt`8+nc#z8b;OLMCFFc6S zn$u^`V)Kls9Z`D%j@b9O80d_a2ba;*ZA;e=6lKNPbLTNS$Gbq+4R|M5^{OiI-ico# ziyQ1to3P~TLu1|PDYd2|9Ct2PEYvU~5*9RI&oE0l^@qp^7|AJF&R}+K^o@?FKyW1fNUm;ohIdkjH-%LCwDPg(G4=9 zbc3KmY#sY9zWzEw7$^&iu_Iy_ zIGWGsn{vQUjWkN86DoK~ zrcGTz=RCNc%qxr$&Rf(GrLFkb5Oc3q8f8q98cTQVU0_u=WO+$hjnLZSeWb2inp&b6 z(5V2`n&7<bx;wE(#`PKr zgY#bAr&6Cx>iAcCxWquhi&vW)Fl^dZmlpX_^%-q2*_v*wl9EiSTcgxw2hw$2;)cZp zt{iWE%{|eS>a8i|=ICX+iF{Ugl#*-=ATietJ2lQP-R34P4s7mU3#X}b#qRexq;|V8D?o!uF zLWtBW*Oe+7fVYMX+{ry}h#;y=iT5&a+r8ao#hXZV{uT z3=YEpN->>Im~KtUGEvPKquJV$CI7{}OEh&&T_ns)+A*1w3|iL>2L}ht=L@=iVDK$Q zD|WYcs0#7n486k-o~CYT>V}~g%t=6@!&@QEIrRe@IZ{XeqhyfG((TA zM&#uP0yJ%x#1uKFPM%IVFowgUJyxrREVq;NM`0Cn@ z#bU{FF{i33#*>jyHGtJ}PQ6;mNZuVMdOGh}tX3(OLq^_p*W*GYD@(?cEwnXh52+}M z9IK!ll?<&E6lx=m5k(=+GdLkVUv4nHmsUCMr(?)5X@7MwLwIlr=s4?&^nV)Fq?_*C><{HS`XN+-s`F!F018I4wnRp z`{dBBB)3d6(JZr6BWV!@moEyhEVD@gC0}k`*VJ{LMkb}q_0x`Et-&9SMw`RT7>P@D zF`$jYWHKji+7)eEGYlOBk5QUDGngWiw9LU_qU5KPrA^CL*$=Inp1SMM+AtnZ$ZgK5 z8^DM{V1NHI}0q=dQ=c$l<7>X;$?8iXtyisbc8+j%KwYIB8k8x3&|QuEJ=; zbTZ}CsZ-1j_Lv_X3erLa%C6+-=s+?wstTi|6Fhlh7w;UGm6$xcgrbP_C>6+Zd8iIf zoaID=Rat70JZO4T|BzQTTHaH2bllR7=l3cj! zI=Z%Hu~^78G8!`)WlXoW*xA{Ujwcljkx1RN%w{vnYD8X?#FowItSn2;oH;{Ll#IvY zjkI|>oibl8n9XLJVr3m^oMky7MlN2s#DfoApzEDfvOY?+-Fu1xf^$UIZ3HEPly_3u zMVT(>pdiXjUK@jt5-*$Q8ROB2swmKDIjT{Zgw_us()EtPc`}=`wYANulV{l8+2Q1= zlU%&G!(ws7s$R*VHZC|u$G_;sdjaw$StFhsG$e}of`%psm5Da zYsfN7+e#LSR*J5v>FQdHvxrx16=rm8Pf?D^OUKYT>a3w|dwS<6@`@&NC}rrnfv)ph z-algR;syLr)7C3O=rJ1lp~Wc8xGII1VJvx;F&Z1HIFNfoWdI{xSmz`i)}qMDoFdZ{ zR#O=94y|{scC|ulBVls=An_C-Qe-mfS}tqm%O%@8J9zInJUXIZHMC8`af z6$7)ylI47s0u2>emNS{i4!Q4p2%@aaih@cRT!_pU3!*aQWhorPD0?@Pa8gDaLR3Tq za@+MCc~+8T5~Uua$47;+7B$Geckq#6@F=CJ%4+lHGg=ez^u53@VxfX#DpX}1lvmiIClk1<+NuU7PfW44gF@!7NI zn9mM~(X(7E@Tn46ET#3Xij3uQL2h%DCZ%!0VmW8IT!?AWL{J{*HCn^qda1yp#yEou zS?UtpC;eFORMt!S7z0k{5L3kT`Vd!|QCXrC_@ToZwUL1m0xHkRGfhk>nd>F1kc*|r zkOlrRBMwN1N5yzN*~q@v>7_2YtVbg$UZzt~V#(-Et|^h4JIb;UKLCRHK`EB2nvdOi zC->fWKW$S}W;tL4tulB@2P&!!CM67x;QU4jrc^{}BeBxv7y^j*m`pLMN=DTPYwTup ztFV+QHGjLxX4DOon6ZaS8W6(J#DtWmgN zAw&k>V;fJNWfWPUb%v^kvQ&6gkPSUi>GUv`BG2l8Ei-(G1S8W9tpi=#(+@}Z7+BUd zb=#%ST9OopzNhW`lo8`tu0#>nE}P_P_pDYmN3$7OCNR;_c#O4{u5anPPP%QSm`tXO zQ8bP0g_YLiWsVNW;Ss`S$`WD_^I~Qt{#hCN!P5;A_nrm0KSrYpWgUJgg)kxxxlj+P29bH?qn9VpmI>3j3Qh|PGaeYG=dWm*53O_`8 z*9&R29T?hVRRIFoc1IB}FD?%I(P*O{88eSuU3-1?SG4!}T@R7#_Uv0K?Fe=Q&+F zu!swWrl%RTOe#@^?CkCUYLktwlpHL^X4qVzbwnA1(gWU0nx}kEYd?&P%LMAT-jUc1 z%7tL)dpUTtT2p34wL=J-%na`aL2V?D$GUUvd%^guWzS91aBy@eu5a(907%!2&a&hw zs8Cwt28T8lZ8HY%Ih-94h*U*MRaI1D+4Je-Jy|bKV~jLyLp2$(wY^Q}2JZgYeSGA@ z|G?$_BQz0;1igtcTh^cqWyRLcHmA;dmEz_M@I+Z1n+AG7XgE@naucC zD`tmB3`0**mK3(2D#ujS7@HN;ooCf_g4Oo{omJ#T#*iYkjn0zU*mC~7L~QI`y2vWU zAS(q`md4y6h>38JUz2&yWHPY3n}Hd~b23DBc!J7 zXnPrniSMZu^K~i;nnv<|1b5@GRyz5`vc`oA46f(wnbTy}V#|W4HT~eI>xS`EVe zXt7{eECCs3TWcw@3|-{pR(v~d=w+1c1{9G|StU_HLEClA7YhdGs45W$Xx5S2vRAP- zCr`WTwHbOyQzLza8trPluIk}(`t%uqP0q=XvNbjiaHUXMvcX-~2?9Pw&|1(2d4@{( zm9@byq??yC@+!-M>#jS``Sa&kEm!RAU8HSm+NNc>lwA6wqZw^o%aYy?xH#a$K=1=9 zI-G|%^z;!}=g&vMX+*8CS`i5x9_(ZDlHHSMP!?uKa}Ex~+!TBu`oMg?5ZPjuVe*WJ z#mIPThpfoaRFkQ{VvU6`7_-*9 zvyosLD=I&eC+_SJ#H6LWbAb?LEVTBS2;WS)mgTBWW0GEWG~TndvqN5%bX~`tciqJU z4?ZMwX{A^;Ejq%GXPBcogA2r+ElzAr$g(Ylw#D~7!(arkYQ+4OWf^&1rsb%Y2U8)& z+p;Jih`%BL#)^uo?*@7outnNOB0H!ukBq8{vJ%6ewU%l$;pC~aELXy2Yuk=~aCj6x z%0pP$9FyfJW7*z0K~a>1;4wjS`qT+doY)air1zXSaf-fOu`RT)yLo zA_PU#4h)Ny`KqO920~O6WksIla+ng(%1BbI$r)7>PM$c;wdb$r!i5L9w0D7v7cVlK z&r>*7ha0?HPgxF#YE*ZDYKWL-AahF8a)n5EgAYU;xgAhG;0Fnfiy_dojeO6}(+vZw zRYTYHDLMe6(&TvsN|aa5dr(%A8nqS`TQ6P0d|6}c5k;O+B#>n}n#e(CbNV6BH!TN8 zbC#PvXld`oiU%y>HA*p3n~9#E#SVwa|MF#gi1I}$Y5ApFi?{^en@qN_MMd2T(`XnRi$%?Y4_%Ns+b#6oB4gnT* zLjbJRRHbD)9zzUhB)L7bB?FMh=;{?r`McC=%=y zesK7~5w@mj5iF`IV+&3`{Na4+6CcJ+=XTf`=VXaLACEr9t6%$m?&|!e(%;_M#h8q? zNiyNl1Y-+gG8Au3cbR#2Tr9*$+cqo~OQO}gj5BAZWLd`U?g@5xPjUHhpT%;?Y&N4=t&s38=_*%?g^X=%AwNtmhXGnV zROzpSj~E7A?=V^rDL%?>s2hgO7^&+AvO)?Ilsw#x&G3joz#56Wkgh!ySOogPadm0jW5 z;U5I=zY$j{+~A~WLrk9kYCD%UNq+l&kP%9f1?HKI3ViTV$!fuCZ03K~id-+t2*|@w zX_;xtT-P!kk2tYAWjq-JaCmsg#fulXc;P}a6GarFUd^n+_Yp(D>PQU9=w~vtQCOoX zGK1BU#HJNVVHJr=vpKs%&HV5(YG^r;W$f&pVE4pHwzl@@ni-3Jh4T`iv|O#|I`R2* zy^I;ooIT5R*WbY9y-TcShoT&@mKYpbEAq@RpB=Hiy+b(}li7;#ctlZF>~5c+ZF=s$ z`yS?pGw{GVEzWtmx?wqAaF|Ps^v?DP#^VXsUV8(x*^*0pd-Ow#))7>|`3@H%&dDx6 zLnPK(E255RX)Op7r7W647V=7zFy4u=Rhy)W%5(ZoX3cAS#e6=eYfds9kLkOXp%cDS zQ5KtVsj-%-s>D#cssWk*R--W?Mr3e7#u&rt(`VQ{`v|`L)6R2>K!0>M zZ+`O~Jg{7fu*G{8^I4)aWC?7V_EbT zx;7aym2^9bwcu5?ZPuiGq%)3SA#8ir_^I z&<*_tlapCXo>YCK$rQXp2eQ+GXwvl&{!q%0T}IaQHl!Or1=fILy+KZ;S19d2+8uHP6``(eNh9_J%E z%LS;a0fIwd4nBB+o%+FkB%y(S=#QofJIM7Ei33v4&3k5}CaVzn6 z3{6Lt732ULLFB$!E?x?y=-Q6uVu|Zo+62hV)3l)L8|u}PzH4#L%5=e#?oT=3A^~k9 zSwfO1qY0tMxqvp2u36C*5^2%29Ys;HySu}9JSEQyTy~zPJmXV&l!b6~lI7uqyJkze zWTI|TuFN_qQoKyk-HF%5({(j{Thk8>Dmru~a%<-tP1n=*LRxoTBFnq3l>#Lzq!Y|? z*_}lxp4xUr2$8bPF*?Wj_4g&$^IEJjIFBE^jMEbSNNX8cDs!AY6=I}qJC2Sdjnb9k zGpcLB!mJg7ZP!sKBYO}n{IRMi#Hj1!{m0}*F*e8O4x49WMTxy)S3M+t+WK=t1-iQD z;P8<`>um_0y}e6xU4upt`mPs8fAHdzmDbZ? zG!$hiGkTqGDiWn4K?zJwkq|UW&>@J3R9?!Gk19y+|LJtfHRrFDJ%AeUuHo?V9&KAQ zo=n&|vCGcx4mQj1sY*X}`ZN!_>1Ga(4%pwjMD#KS3qMLy3&&Eg_iIpzAnarT;P z+1)wK=~JgUeexuGmmXs1TPBl|%xu%vwY-PuXq%OEOI?q(d19%7N;B8B!pq7(OtaXK z^zO$wIATakbW|)c%Aqy%o{${XS!NUdCHZBvp)4{~^dg7|VZ+EW#!?j-Dhicg9g|?R zrcQ+AdR60nq^c_EN-{BG$^%X!gWIkp%q6U8wX88&M%xd}mn(|AWL%9f#?W;gQy-*% zRk9GxldIo50si@Q{Bhdffv9CrDs^$v#ttE{Ts0UJnawGJ5-Onv!XWN&7YKd;93hYr z0|%y)i6{u86YiEaa)2X33aucxfj&5bmnwHJl0cJlGpaa|4&S$^bw{K0$YsG`6V zaUn_v7o=oVUW>D zluB2jFfejsj;?_EDoFI(w2kk3pju@bmJMnP-jk90*s zaL^ddJ!rlWg|*S!O{0<+lt`A7&#QZ94=ko zpp;_bC#V=VEVn$*2~nf<`nu~AAw-G}WlZ9M$-~+?0at1zBd5h;$<{68wmd}54h{?WFAg`i=HP#Z50&tDG3EqQ-rf!(e=B$>h zWOSD2jzY%S>$NuPk~xjTv{}b#NKtLH-8?I<*6XSsE+9#;T2XLUuW+1JZ)L8x=X$s153+EDID;*$Jyjey^_USS%I{ z-ZK7uIm4P1a;8Wkf#FyxZ?r%=qo?Zz4u=KH`AQ`7`uOIIkW_gZ73E=5Hx0@t zf`YQD$csV_=a3+w5p)(L7|lssf=cr4u352K%&F@YC-Nda1_FnBa|Qyj7xh!nLI-G9 zEB5vdo5XK?q*P zqS_W1111StI5fcEO z#bUAkDy0}!g5r^pQAqS=Nn@1}lEY+1NDoQSq9SCO#pyuPbWA6aq4z8o4PECLR~4JY zTw`!v{4#CZ;+-ci3o>mJ76^=+>*Ii5$$*Xh6rac$DfakpE z!?jM4#ehMfLIm%yYMtcPvN)QdQ+3?79rO8|+0h|&y#$~ta`Gaz#73i(d~nV~R8~|r z%BT6fh8X1E`G6zPYe`A$*Y`zqbWMY+Ylgm&w7=k}a>Jx5$P>~e4j!V$C?iR8Dx?6U zi0gZT_l$}{0CPi2bPg9HtJMN)G+9}aTa8WR)p|7tCqAJwr%uo{=V?|m7K>S`u6pK+ zBic5{T3LJ>D{7mVqEZLf0SfIECdiCD1Q|;T{#$K~s*othMjX-B7AQ0^Cpq>9nNzDI zD>o8YL=5<$gS5CWGK0-ain3xdozS&4tAn*yMbuq=s=nHOz-C3N0AV~HVX};5X zBe7wSW$I!nGHuzpl#D97$>~r@;u%Plp?7k44?`L~4nkSzI&3CB52e@S0JrI=WIU}f zF`{FTZ1-VcS@*~J?MA#mpztxscMa5aokHU*c_}8jo$YN@orUzr!i7a0_#szJ=q$({+ zN7}w+e}A8&gUbXj-lP!SC;68m3ay0jV3dqX)(<>Qkj~Bbc-P@wmr_tk67`YBc7B;>6uHrSvwf6(_GeUnCFod83JD3Qs1--?sn4P<$V2mqw3 z5!k1EKWWe{qxC3H?GSt#&pUCg=UFnPCb2|}D8$EPtq=?(;=`wu+!Q>P5K2XsZAMlB z7@VW)d-|c5MAWvUX*;@pKpPq7ZUVdHa>IL<4vn6Gn8``}HLW5hdALF!5`sqV;bpzz z=|su1Ja~I8%=PsBem9Sq|`AY-Yu=JTnhY)UspGYa&X5! z7vjdvt*x|rHZAr;5OqQz#cw7xleF6ktCS!$`VOl!ix@aMT5+(y$6|iOaw&`2#bQR& zG{Q5p25oc7(O6vcnY^{ZJNiC>^Nax{9aD5pfO=sNeo>S|4rMnp)fhVJ#SFKc(bhZU zS&C*&gx}qpZ{_Qs{lz@>$&cn!AA1wmotjc*ilJ*cI-K!|yYAsFZ+j0PeBgeXrOdy5 z*P*nSt(vAG5}7{og}mzbzmrd~;O_h%{HI^IgVmPimZ#jtmp=Y;x$&AQyOpM&U*fJ0 z{1w0dTffdPyzwDcePFp@4ji9@M?(h&$Omvfq?V|4vf_?mBe4qx`n$8pQKU8cHa z|Ngu9>p%NrUiZ4U@}3KUTfX_1dGmKZ3d_KIe)8LR$^Tri#(#ste%d$kmY;YAJ34at z_kNUr^UEJ4WEPEpgoobItBCWKh~;rFcnL56((`CMfA=dd<>&sy9k=|(By(5B=|?=7 zCqMadJmygkkX*_{!kb}aTUa>sk##ed)b2i|uv^6+o^Ro?WHM`IcIi&y*`zUg-^ zvmQd57|9eUG=3OR8g_5}Y@YYr&*K@lKaN{&IL%f8-TV^w{o@Dt%eVa=|HrF-kB>T$ z@-A03LG2TjW;&gsGK)=za*Up#?NA|#YRl#rrBRRnx4i26pU%!F-PeYjp7lJw?aF@? zF7xg;zMDUF4jaL^6ppoAapvYn@o7)KnTKDu%c<>>!oX0^xp412{No2c$UENoejZ%R z*gLq);lVzchS8{$0?T=-7|HSpXK(#Xp7ylcdD0Ue&CNGn%jxYgRTk-%hg`h(<9zt< z-p9M%^?vSeR#=-Vn6BuPkL63g=AS+<{3qVUPrd36dJQU; zaKn>%@pErxq$0C-{WdTBxjE4dXavR7cO8qxjJjTtiY)#kKlR1m z%q#CYR<=UUb+>;3&wtKm@$}ms%_FWmA>aFApL_rD4&MDoZ{c-sd^aDjkI5Cz4|IJe zJC?F!zE}v0&3m#$f|eXAwXs)_I_Q2F@LtK@D2TGvYL!feBWKdwaoGv7yEjW|<{ICK6SPx+Mdy#5tG!4JRXa&prqKqQgDd)#u)Y|*fp zA`D9|>_?vctqUU`fulcSY#x3&SN(ZSpDMr17L2ONWt_JVUStBTQRBxX!V`>3_QN#nB|qQ?xL z$p4R5bS(ETad3G_bRC&igq@rDoNs&{U;4ydvj64JSWI@f@v%GH_}C}#IiLTjyyoTq znU}x!BD2LI)++j;*o2vlr;p@Czx_Y?zNc;fv)@UzeTIkKdWMJHdOKhE+SpN0_V&ePGj3t$%(sURT%Wl2G7UWmua^m!wwkZje}1YcY8yxQ^r| zS4t%|lEDXYe!C#>z`;e@Rn2O(#D_rBH3T0Sk0y+#6N!|ydNY0l61G}W2(=L~9qSY~ zlG;P3)-*2!ytUNRYtv08I-J4dTXe{e5<^WHnStRV(@m`IL;XTECK3=z~xp7qi% z;VW<5g1+XydmiHNKXNx07J*0HemkG_@GXogdHC~xgkSmSojmtdcQFh-v)POgB6(i1 zsynWE*2{R~E1$zHh0I)=3;)17{`l|s$U`+|=NwP?%+KKIk9suU^s}$vYv$Bur`+=k8Sn8OKwz1h#FeW3Ys){TRjHe}9 zMci_a2k*PYVKVInQ!v>*&9ygO$JvQRjj!j~-}zGLe}-4Tf3X>>t#5=p&ne3id);k( z-B&!8GZrAyAKu4@K6D@V?KjMv;oM`N$kQMF7{1}BUqSJ9vpM3!&}^zptun&q|Fb{meILG`{RYO@+`?_2{S0ouaYAj#ZW$zU0Mx>*t(C}DW<#F74 zuEL&pEZ_WdKTdbw7xP_zcqnlKZHqx5oY6SStub0fhS`05>?3z_*F6uhKdW(O#K~)K z;R&~Y3ODcOsPV)2{D1#a>@WO0e{iqZ1#Fg~2@D5!@zysyfYs;t?B_j+^9JJL9^Uzz+yM;Wyh zMG2^lxM>r`tPMmF5ol{SQ57Mr4b~>(w(Am#CXg3mo*bOR`-qECDA2{)dnBq`g&Zy> znX1?Acxa*iCPi7>~@S5jER`< z`cJAN`?h1~C2E!EF($IJQ!za7F<$xV-{qHn>ur4e!XDZfCetaW&z|9$Yp&tOhd+T& z`--pNh0i$0I6KcbzWl5Cjd%Vuf8`9m6TgHumN4|x&9FIK%p*UauU3JB5Bwp2@b1gp zbq ziZ7LeB@W#4=2!AbU&b%L^ftciS;y};xPg8Ux3d8mC33}q zs{|bB`wl{+EGqI$GF@WuNda|5-;j;*Nr9t{rm9LZyWrCM-^OqK?tA#)JxfAXVe<^< zJ)>%Z%`A)7aQ^Af;hVqkW+vHLKL3SZ$Y1@Jw{XX7xxwgz$f@(`!+7QwJVp+d=(+gb z|A$}v?Z4$vmCWaJ?)t=?+<*TOw|v!q=5;^(*?i5H9lu}S)y(H}`V@^_WI1_p6JPgB zKfqT#qC~}kd*A%ie8+damiO%^6j2)IdbQ1`zvSn6_4hrEGv%ZBmY@3%{NdAI&Y#wr z<*LO!c!9dEId$@+#NG~rqvpM*d_kDzaxFa%}PROf@ z!3XB627<$=ZJzp~uabi$I`;nNt-S6{ALhX9qOIY=rH8n5@dC?Vg`1!ABL2&Zp2+F) z7QX$JKfoV<)_3v8N0LXh_J%3d^NDx9iXZvK-{;Rid_Zrqls&KUN#U7KuIK45`aWL# zWshQP&+^Q#{#@?(r9b16vWb1=aLoZ1?heGfq)VT192VU34|lQ}jTxM0|MF!};$u^p zNpATbKe*%T%y;yC!w|(+bPQ9qDcdO{UeQ%(o29V2<9)BT$Fn)}m@nk(6db+x|Kw%g z^BVs6es{dH3(4=L&hV8#_I-TaBTH0t-2aaM&dYxAcX`jnZd1@GrO??4p89P+$gjNg zHcpoh=No_g+j;l%ev!XiiCWQzm~b>Qt`{Yq7`F4G-0Y&2l6dg(ctlwhG<{E&Ntl{~ zB+(ui1|wF0LBi2OjF>c$u~~*q^a>ZEn8me3Cre(FOCfh6w>DPkTGV1EO9yhooeY3JKMWLg}j`2yQgCR3A+EPW1&vW{&qfgZyTNB2kiWtRU z6;jnYc<~)*BW~V6NRgg~K$OZRh=zQA*$9i}am%a>eb+KO zI%IZuK=hu;xZ?DwoKO7Cef-G>FEbmC*=Hfh($N~j*^?!!4}XBSoZIEOk1DZ`csAeg zv|s0M-`*4PsNlpbW~~_W*7y~zXzqADKlJ18W;lI)s&ph_E>jnH`zwBcU-_Ij^4*WN zn6uC1^Pltz{`7rLIx`;$(QwmqzLw`)BgEqNLvP@vKlW$b=S%WD$Y-P!Ry#iWrdRU4 z*ZnB3`pRoJ7lI!Ii-B?|)l(E6HC#DH3Q3VAi_E-~3<>cKDO60tg7trnEIQp%R53-K zWAvQ&{>~dkHkoBu+n|&tFDv@aVY7^W82Gz4{5rpJ@_YG?+ozawxADx!y_=8yji_e4 z_i689nLhH-Jbp{QwBdoj zC$d)YUwQh$apLLU%*&p!izYCC*N^d>7rchM203Vrk;4VR`^&uZzy5E0%elAkrWf6a zx$!IcjxYa3-u~JP$xPeQG!1Rtu(dVC8qFvxD07>3S|Vo1Gm9<^gOk1E`jd0@AxDRv z&UH+~b|O?ORA$H@|M@)kiDMLz)!)CKpZLkYq~1QsWLpZVW;rMLfz|9HZ~LkLz+Uzm z-tdh#U~YIGFL~b2^3K=XhtithB-Jsv`}n_p@a5#zGM!E&8)#Gs$vDZ-wZF*UzV4@a z{dGUXi*DP(oV$%DU;h{U;e#R$30@Rw)@GQ(9*?Emip9ZYj+z={EDDbsJWb!zG=jKM zN}<{-M`{7zOI*SF>NCbLo`~62>x|s2$DayYOc+lBQ3+BWrBLH?b6qQ~a36mYFMjcF z^4GOxG9G=>eG8ToPk#~r`)6&Vi7fy2b-d(<-_D)gn6k3;ZI_B;jkP@=cI}*sPe*T;Jll2H&?yiPB>; zBN+4PnC;zNwsy8tCi#TXSdtINlPROoRDM3$k{{D4lj*kn*xF@#XP2$*9mZn`_bJON zB^(NNA}>cww|3duKFMUVeZ{<9Xjz)||W3sZ6?!cx@j`b^CL1L|}`3Wmi>dZ3fasT({^=ji?MuP0b>==xrabA7+L zh=-Jpxvt1S0zdH5yS>6-92ZFhn=J`?ucA$Luy+TU%7)(Xr{a zs;I`N`Ml>pjnnBf{ry+Jg9nwk2!GS_ z&4sL7q=*VJkcx4<8jpl^n0!AGF@Q$ESVLYG6h$E!Hvd|EE>CXm9M15MLNU`=9Q zp(RPKsoP^NR+14eS1VRcvr#x`Wzb3w-r z!ET^|CPRZsZfN=uAJFC*8v9{vvfDObY(HmPwj?LXS=q|Ey7#2LE3NQ8%vH6Ic+mYA zz8~0Q+#%`QqjUDITD8`k|M?F|1bN1SKK@xg{Q1B&R|$o)SU(=^%alcZSo`v$FEc=;i%G*3ge&rrFQ<($dE!<=$t6Ps;+s;a=clC?9Z z88XxyIy6V4sH$r0T2y%wXB^IzSbqv;c-X(XaR%DElVC8La(72Wj(ZrYAK=CG!G=IMKkQFpQXg03}?>+vWTlxG>;_`!v;(`l_>hA>( ziwWzD=1{4KWfTw7u9Z_~`K=LXfE2nDIwr zEv~m%qv#sRQ*qX^zBXrLZG)z1SnTZy)Z#s8w_4;%gR;V3Z(FQ0Z0~Nfy}Lz3tz%3{K? zV_T9|=qilwXzNB`G$qvBkW}_pQs|RT zszcex)1foRf0!-k{hdo*dm+PcecwsIR>}vtan$?RXTDn!g52x2X|rFGL2JkQxsT-q zFMJkPUwJ;K%;} zOh*f0qAWErCW+`J(eLZ}LMP^uy0$cJ3);#|@RS1_$;M-9_Fx_+VZ@NIT4JHwT5|6J zQci=deNVTLTozO!w!7@@?oqc5Z7*i7#uhpCQPgld&A_rtv^x)S-~HRt!MieRPxi*S zPrUbYeEjpbb2pB%s506hw<3f9XB^_pdDeU#cqYH|!Ds%%5nlIaT0GO4OAH=x;F!IFb8ok0c=q+ThrN!#)!5jAGk5karQ@; zdoKd^6r;?VbGDNA5?YtCVQppfXc~N?UMKW$iHR`=cV-8j@o)p7tP;zmXJ=i8)M^Vgq#5aCBuYSd)9Q>DFKOaV=v)H)U@qVSIW|>yGF>Tw*&>RGV*J3ug zv%M>J_yERa2V0@9>Vt+rrfBo9$aC-4CxF<>xeZaR}&I%Ik zgq}95&LxTPxsFMS$z#WO;K2uSil{^%w_QuzY4>#+3zmxojhB>3r8U}TCRM&x{Xc?V zV~XgcMt{5gpnu#x&I5}DjgeGXA4HHCgA^)uGULEkBlEC2XSB$WeLA0^l_cp(GoZ(V z%vvW}lgw~KDSGe40JN_2!I1aQyw~-8PuKelkE`qyp+;yu0U--Ml{S>w#}C8-+vg(C zW~~`WDr(a-^xjJm?rbJNotW1NJzW0b-S1^Ot(ebe6jdpXqrI0@xYpDA#B#6Up@)vM zy|bGmQrpb`_jJA=tK4PX&~zYM5JMtGD;6fX zdu+Rou4!rNn!-6$$}E&j-*e+eI_L1|r?I}bB#~&lPCTwoemvjw?6WweA%)|7;;;XL zKYHtj_}m>wnH)I6DW{#o>1UkDsi&V#Jvob4y!2vDleU1#bjs#*P9(_!?>dy*2Roqw zO-!;G3Ds6o^0dv_6#D^$q=;xx29+1cxIv{v@R2U|XdOli7U=@BB3XHs-LRk%{oWSG zj~~zO#};i8-BPYI3J4ut*Wm{%o!kKp5T3Zuj&F|S`%Dd0W1!RgvTxvfzxh%QYDJ2> z-1?#S^X?Dd$es6Z^U(GlO_!L==A3-$X}B}4;X7aXSP|tVad=SKi>fG!htpBBW<_x8 zA$tT&CX?u#Us3Ek&<4v3dH)e*%&0B$UwSjI{)xZi-jD~KiA-ddk~idHWVkqqMDj=Z zoHwKO5Xp<{wo<~x^WuxL6ZAll#ZfutNVV-Tlt}%eHRZX(aeMpa=uK;?_p&h6hnrV>=IX$ z8M0H-o#zgs$RTp8=T@My6u}!gFnoqI+qR)B%Q2dwr)OC&+1*>Pv$IP*!n~1?B8%m6 zET(+!<|X&4V0~>3V+>8bV7Zhy46Br^HRr@8rk5nj)OS!1aN3D^ozTPOUGI4>Md_H$ zr%a|(j27Wz({2U*c9I3J1^UwUlD!CM(Ch20E4Vu!0z+QQC>BII z%GuggmwPu;e35l|9aJUCqsjJ!#?njI)pFrUxZ%biUh<~-)9 zmvcZXNW0whrr+leKYWx29(oA!d`)h@&4-v87imfft&GsE%L!FA6__y}d}=afW*kjc zAd?TgAy&In5{7l)!1`F!4iKS;C^cz!o9(;+^m^jHk6p_L>LK$cW+&y`H!AUKQVL== zeFWK9j855$EnBQa#JenSSWVv%ceV*Ju&ie}XlzQi4^q^o#JQ3bLx%Z!oQ1DlL``S?d-6%was$59Dmjr#T)&oA5lmIHtI~i^+#ULSw_h)`@5gR zH^1=?dL>pugY}Owo~{c-Z^kv9x&=p%9-}XcEM^rJ+>&}_qZB*p<$|rIXM1~_wrxkV zQjiVpA0IAa4l%$ygKkYftVoztZv1@O$gn)bI2NfY?t|vE!Br*NXZ!q+vTv8jBUH1; z&T!x7fxEA}o*Pt|pOKJVML_2`?ZLoun4J{Wl(MWOvp&Z}3~a2TC`Oi8QOF#*>l=D6 zkeRVE^B8iG`o1UhJ#7->`Fe&-t~rsf6MDEjxU+}W3b(UhI-4@7W)eAz#wX#Wt0FO*6)0u$u;0@6 zL(X-NLSad0n=6+n6@!l<=b5Jwf*B~uI@=@^Wsw~f#Pl+yY_h0^n9~kxELB;coDx<0 zR9tnJb(<|1{74HX1+i5ydQ4qx{JC6kp&SO`!T0m}x84bM!o*c9mqJ_KI(|$TT)_O` z`aW9^S#&;E)Cwa*c)PE2$t)~m#ZRj3I;ttmrc+$$DB21=FURlKWv@C@iB6XS%-5 zd@`ZU$%P|(47nG+*PMFVfpPQJ#xb9*(Y7@qM!Y_Sv(K`5VE!pS{@I$zY=%9)Eh^_2 zbMTTdgl2~ivOaW@Ial13CDX~2>2yk8*K7wkS%cc#-}fWu-^T-- zf5D-#N=>29ZW4Kbdgra&vP@jQuF!|B;Og_>eV+>?on*7iVOdJ493eZ{g@{#-3@P-A zQmhn&NQmO$Wu1~;C(4@MTP*0iUR2#~!SUtFlPd+EBN6g@_dOx>_`7f8&L;85xk4Yj zn5)i#8*Wpml<1Sh0Q>0CR`d=^tE|8dfUMoLkA6yZHBWl1tf_F%+xX2typYI+8=Tr5?!W&&x}uT+by-l94kr6HhS;%l>=?VbU|Gc;3|smSL-q#3VJ(E{x3^x0YZv@>(&*h+A<^ zA&n`Cl)`(A>7_u+xl}3i`F;(QcgcTpg{6!IHjA)_i1m<*N1GwGu50Prju6BSM;p=p z6gj^tB@xbs{9G7gN7Bv14M)Ga*9kpb4xW6@??}dvMgvq!g%^ zHH!$tq*SV$ec-UNOlE6rIGc5yGH6pqoKg==rxcr$@o+KIgB&_^nAT^ABi_ZQZwWl- zGK-pA%CoLH$ooDZwll;0s&FNf$&9k7@UzQ!#wDwnkDIKsv8iaghPG*l$xwC+wjvzS zit?;;IB)h@ZjXAzedTk=2G(#9Prqu_2`Mc@M{6yq?}){O$#DI4cj=tN4x0kPehD$R z{%OL+mz~atVwsBBd<|8UI)UDE(i6b^Od zi9GkpRmD57hQ?Xc@)NxG`i2)iV}f#z;H9s)g5Q444YZ?U>}tCbe1CvprF+?LTRv>y zT05eN18{~Sh--L)w(sc&wY)Akx>yaVeX~a&1Fn<^F& zqh4j`=3@->yEpK@Pd2>ZDHD`EpO?J+Dqi=CpPLGUhHS~cFN%ng?f5La!X_dTeH6o3&_8Y`3iRJy?y!f8pCOiAJMB1j~h7R`ya4pI`@DUhOK zGMO@&Oy&0ldEilg-yBdVf_>lTIOBxUOZGBVOP_H8k2$Vp)4n~ZOeSV#$+;O zcIE|Kb^3m;eUdDO43Q+2G0qSlCO8Ti#~mVum4@JZ+7@DRsD58{p%jI&Vi6G{aFh?e z?-u^!rH`OcGoJZP&*G1-eLG)h0x1bIXLXQjE_%rmc}zLJLt>Ep`NeWU*EKk2DDJ=+N zTu)sun3NThvXq#BlqiZ#p782_$J57%M};Zp%w}z-X(v)#@XkMd4-Y==1su_a3%=t& z^P}&4CBO2C#fYbiMY*`ln!IsHb!%`o;e%}GF-l>hf)e$*@AKCJ3Wd?)z#C9PwNHt9 z-;la*8x{>z+R_DRI`NL`{5`z&P4DGbh{|i)obxEIJoONFY)fuW#7l7(WFtEG?4ReSo;};QreSZ< zu%lY6ZCTU}&MlaC_wrDkpj5Cn!z`B^qn8;=jv)v+#Wcjg?%tB+mv7{zoyZl3H1@LR z^YxGT1Ag;X2g;EUOL&3GN-lflt9kK})l(B=$|!>*TB6M`R>_ZvrkYNfB(cmNpwbaW z4|}}hE$`>Yp7cD9Xv2B0_&&b>9k1rUe!3owbyv``6vxI`ibBHms!9`*#u<%Dk*=v} zv+z>q?sJe+6qACu(m#DIumi!d_HG=T_Rx*9z4jQLx(tg_#_S; zIK{x14B_x3f4E~9653l)rdI> z2fT3NUp1*F%*{P~;b!5_>-DGdeLws(jyQpctSgyLXF$Qu>^z?IHK(zz2J97xfx=m; zs$e>ipsUGbLbXpvqD+6jRAq%ThI{_u?|A1? znMsw8{5pR1N1n*}Q;lNC$!MsXz{yX25&!ucjtJ>tc#FOn+wj4LJuJS+2d>+bJUe?X z-}Zyg=h8|v7=72#_bq`5SH0|2{MNT$K$-Rr*=3llNVHwUa_dXnewQ3>YI+$@dDhvK zT}_Hnm@8dJiiSg1y@>Dp)<<(dudbge*Ex9T5Yy>Yy4?&N?A>}hUtY*Jxzn!Xo4?^w z&X`palWi<(vo$t1&)_lN@yq<~cbxsO&uiS2vZ!!Yl<1`^X+QXf{M!4s72=Q#&jm)yXkzL zYC6Z26O=7LTaq>;3yQ}iLMXq?A09K-r<4! zZsJon%cs%nSMa!t6kCfW4{mMq(9SN$7YmNz%7xR68_`CeV3oqh;8+0cr&#ojZB^4Vy`nfOXwSV;c{Ngj# zn3M(1iuNgHinYxG*`WZ7F;Z0%rc)v5SZ#2|5VPE2=)6RUpR%Y?MgdLRu)Dj<-rg=v zQ)f@He2sIr9OFni5e8UM=E&zP0M3PwkVA5OM35n^(H3hTuC@AVUMIA3sTXzbDukL! zLN@L~au%djwK@51=sE^SMAW7#x1c0pQw1+Wru}|W19mFDKyoAdv7=dGx}lehY@-cj zkt=7PH#?#kyLeI1*bDxZ4SjU2!1Dh?{k+0XxB-gL$1 zc>hPf#2s5bZtV~kJo-w$=Hf$C>~h`PKEp}RzlL*+Ktu;OH>rw}GK&Cxip0&$m7{HO zfRj!+jbn=zg~SExOlWXLA+79w%4AHaOaWI&if5{C>v2TlU~Fn zrDE+-FXHuYdORQf$Y=TT(T?iiDO~!P%X!qvB|P*A-hBPZy!?4*U{Hjv#(Oum?@fI- z*S-7GJni2G3b)N6xx}Yp?wrx8Ap4dgxTnx%?^~^N2$f)O_W}`SuY_3baOw~e&j2h{EV|WU^Is=c@jVRBj@vk_ngc1U%D52;0&&K@>6)q z#RqZAFYq@XEcm+TohOUmIGiaYk7USoNyqq$pL`7$zWx{a&P%4~jZ68C|MsW6%9S zZM^NBU*@MDa|zC#%d7tQjhy?+&w55N0HKKb?E z&toQs*}#*(bqhdt4^y(_kV!jdEXhl>J{hbP0SK}0v$8? zAkRDYJu1O_`bdU@29k>$MncZGpFjKQpXb8Y{Q}>4@f5xONWSA&|A?1-|4n@O+RyRj z`?gu8g0;<)IQzm2x#Ce5aC*M)@A$J0r4+NOl*6KrnR_F}t+A^ZWvxY&*`_8Jhb|K# z)GENM>!>E{6lE#2`xt2IhPqy6QiH*VEIKzv(sHw&OTmg+OO*83y#BNzn^&6L)(ynm+8b0>JUnlf%amGP}KJ;Svm{r)z0UyuIuwfA8bA~x&RlZ)~)nY+i1B3HzDN27< z>pXxf#{V9&XygPk6lKN4NHrlz zbg=x?JNU1EvB{6U_*^!%W`5>nJpbjFJ?vVf{um#5-LLX<*FToud;V~>Cv0wRQdJXy z2%WIh;^ro0{ubrdICSc1oU&{nLg9*x@oKDfLQkCTW0wtdLM8aQH5%g#^(X(5pZP7z z&%WwwICr9`PCB1wz3_aVwf{ZV_wcvB{};UT^l##M!`F~Joun03JHqgbzVdE<<@e6! zwXb>%rxgmjaVAgx+B13b>Zj4&`*D8#r+$ymJn83ndHz~x_SoAiImkDtFBVMnm}IpYzjye1zBj+edInYu3+yJTE{0@elvM`=fmDcYl!|`N-q=-gXS|kI z$-6+?3D!0wq*ydY9>0w*ePsug)+nq+k?8xD82XF=$V}5(CqmGiouXMeWgD$2om;sWJIj1N zLmAEP-VV#UrfzDwRzm4e3Ki7|H!EZ=Q{*mb*h_t8$U<7#Ol3kzjG_~ZCO)jFIZ>|@ zdbr3;#ba{@^zg7+yGjlmvdjBkf_3`7mpMdA+3!Z$Hl@K@O-wQdZ99oQT~!>4!phAs z#)v_i?}=V;X_cwP0}XF)Z;u#-uf( z`S1UQPrUDHUj7YF;K`3Zn==khDPqI1d++A6H++n@{n_904`14)y7a2m1yY$(9ik+~ zDT8(8n7|2uE}5-uux?98g3AvU!r78^DH@uY}|MAcA ztmi#}CtYzCXC9t2Q9U~k-p`kAx{-Ii>l1wDsOOyX^Uq6>E@;-*=4d5Ms3Fm@swx(r z{2PAa=Wpf(U;8*7_sG*YZL`9Jnxl8$!Sx^be|Y0tKE$mH#rfB)K63Oe%cVyvnZ>nD zM^hi;OK<&cUi+md@~me)j!Vuzm4oXQHZ<%!a5uMo_LE%qfos{Fp2Pf{3-{ssA=5uK z#yO00s7w}7D7HWMFu}1AmlqcWjry&lgyvQ^ z^pJ(8ob(Sl^#MlB`KPzdN4>yxpS(P8v!i!i$3lrfVm~t6T(=DIdyGqcoX(9+53t|n z+aZg~mK)Dq&-wLE|6xcW2CVA07xYM{@c7=3maZFd?RzE`FAU}0JA)ZP!J-&0w5@w= zhprF3kC$o3{p;SgVDAGnZO2W;HC|uzSQT%>e`}Zrd(8f?odFpvJqPDcFEqvzRL6Nk z1-fM7z~Th{Unk~Dh^i`3Me{TDj|HG33y?n)=q~E`=3>-v%!_8$>75w7<-|Y|aQ*6e zuP-ugKb?bQ$-uj&$dg$Yo!}hONqvY2o((OxE8h#+JjAjo{g3Uc<5J7vWs2sh?^R^Vr?xw_B=gq`9Rb$!fAE>h z0`*wA*v+Qg`RZEOL%aj#!O&v;o^6m6Z)IcQJ<(&Mr4KOL5|Vjb;Zx=ENkciH0a7M% zU)z|enEj(&Y-fmM1G+n}nAJ>EW+haN(KsC4eS+J(P32ApKRX@0*O5Lkk;8*A$}}oS zH+jcMlr*n}CJ)6-Lj}l4sY}>f=}bq+NH(k{jK*Zs#Vy@!wrEMoOI6!1yTcXmP#Q=o z8tIPCW_^4g_R)RE+KHi+lVz!p>o0zt`G~Ajei_h0B0sq|q`{$8UH#F2Y%Xs;I46gE z4m+xSc=)LpTxDNYMfoDN2AYwX2cnu!f z)BE4clzyAg0Z5Dv=IWhMHdHSdfO;EN{=oR$KMI-LGLVZD-p~Xvn6gx;HeIkD{A#pN z-1w_gB-2wwPn5jyU3~OtJ!Y-B&~TaaF)6l%i*21DWVh_U?n@$^XqfT{?yyt4k^dDu z?d)@zC4#iYCg#F+5UHCo`-<~aSyWfJdaf%flZH+E%S7Jk9D3i~#S%7=3kq-q@6(NE z>x6(oh#t3apqJdYbwwM(1v!OgLem-9ba{VPIFIWT4V?Bz@`Gux6kS2}^>vTg4WLAe zAWv=~P;x%EI8l{qpcjw~EpUj4WlqZgotBa*N*!LCYO27STkHFz(rn1mFu5ERKr9!7 z+{Ci^8w;Gtn>?`ddv4LKCcy@sJ=V8&=_N5-AlCfrT78Jrc}^Qm(U??P6ktIls6eZu zsK5-c+}et75lV$$n10MG1IW~Jh}m1RY*CG(^2?Xy%N3-vg@+|` z@O(U(w&A7wV2%_5wTgUVZUy72|R8^v8-*0SmD$N*y6F>=-Zbhq{P&+vmjxhRx zk}{VXp-38t9W7lU>Olb|-yVlrvIm$*shspW(p-CJct-pq$ZEo!oDtUFK}lU<87(GO zul0fu%2aX^!Pa09Wf(r23sw=l%tt9@^yHATl5=BLxLe=q-MuQ4KnoDba7c;?iL=Q~ z1!35WCS^dRv+z*Cm|}eZj+q}D+eJ&iaUjZF|GD5|fOS^Zp_=MSqG)-yh@AINRs?*L zM!x-@j12s!_B9FSF`^b7X$|fNUk=pKxWX2BcbMWv7YAuOs_9)sWx1YGjTo{k)F3eUW~1n zfhARo-uRzfA#c5sdK)>=@E;j9UzFcmnhtOzAdOFj%`FfhIAe=SylQT59|tD3XPQZU z0#GfGL;C`tr@cNlqm8QV4^`Y|Oj3!6OA=dNS#OVewHzBtzY7h^^><|z^wB3+dM1Po zTBfojj38Rg!6Qd!J5v!7hNxg1ER7GysD0W9X$Ti0oCv7)hwn6G-FEXG(>n7MIPdNK z_Fwoj55sVEzGyKg9fUK z5?YPj;ASuVZZo(rP{-&~bsOAAtZyH$#lIneWqp2ET6s$r=e|X+UJ;D;WW>*_M*a`Q zqJTD+A}p^pPnLE;V%29vM$Bl8Tz76QgC+K!ox?%zyM5F}U~2Ri`+0LG(+{&6LQ1w* zfyeE|$0S8&^x|)ayw}6C$9QlD_sjV&Sox@!mA1deBvI2yTY$Q0ZG~gGQW)zVx^dLM zTN6y|;hle>g-^oE(h6z4NS${niBrplG*l7ty8(wCZDoj3POkIFL`L``5!030Ff7`W z28(S7UP=odMVA|$o`mQA=CYOp&;z+=->CV%HY7MujGORhYCODqU+olT5Fhyvr;Gwc zYEPGru>x;(T=7UPL^`0|Rq{tQrBN{q1+6&`G8Osu={n){Z_yXaH{H+z2F~8Sz6+z( zH;6`eir4ehA?gqYzh=w2TMC;ISj7NxMt71FroIVJGiV0~ko{i-TM z`9rg@3dInlvVy|F5ZXr?g$2H;ZWvE-D``~Db5pQXKf1?T24r;{tv{qflLmh-1#+YO-0|G2=LL9YG3*IbEl?1PNgYN~$KkG$%hx;eeY*SOmB;@-kv zoQh*u`ngcvl$fQo@)G66DtbSEci7*OeNUc&lPEo0rv(L@lj<|~-+0o_P)#7r9Suk=VO8Y6*+BHj&xnne~F*+WR4(mijk!81yi z%AJYFA9nT#-{$djg)49O64sr6`K01HPD+3O@_7t4rsvze75%uXbNH>VZ+6vTFzi|2 za)z^IKGJwVC>fbg|ko)nT7abK|kxp6KZp)jGV0sJPCzM1Wf`7>4_atU`;#TlXzq+AJ)xA(D)-%vU{4!Gpu*J^nD&;T)U;7}0s*R1#dIR`-Ibc?6A|P5& zp784Z*EA&2oUOo4x$raA%+EfzF-hmB6}YysR#cgmLyX zlGZEB`y8Yd73=}%Y?5@)N0_wTODM*t7@WUhG_kt@T+HT>kYm{VWaiMjAT z)AnK;eKACZldAEt?*a_~)<204+ZsgH~?|JJHbs%%V2h38b% z67{g>5FU~fJ(ZY+bnML4qK{RdLm=Ys38HnBykp?JEyIRyst-Dg1yjEd6X+{01xMs& zB3bLqDdhfhk&59nOSmb8vbu{2_*8uBW9ZFhG4Oy|+42>z%lceazKR%B#+zuYH{nl>*LjW5Wc_wrv3BpR0k{b9P(d1uR z8k6f0ndX{`lmOW}(i!xHGZ04%WskJC>wj14al+JgTx;4+_!>A6_qQ3Z_@4i&>e@1j zz{H2k0@ue~iz{vSfzl1`2gtobGXv{!NUkhcxui7p9R^ zxg_P51VlBtr|syGm4hpSk?C3MU{%Y9&8YrGFBYl%!j2RaRTTVCR@5BrIocu0aL*~C zByRjaO+4;ew2CVpu70FX5;5d5OB1Y_Gg5@x2Y42$5ga4MmA~4Nkk+oOJUrraFL@i6 zQx@#(2!GQOvOTlS`g@{=1G)P)**sX6`M$qd#7cpDoT$F={SJyCrbyy5b?r%4l`WHi zR@{ak?$5mN%^~>DcMgZIPBxY(R

yukBKSs9bHLp!Auf`BBY$AxI|7FN`&(OIDGWvtDU5YYkD~bbWaWQiAy#R;f5RZhVaA{nPoZksvUUcf zRrxkf31f5jYsa57vxD*Jc&);+_NA;@9pUY@mYKvUHh3g|;4c3D6Yf1o`mKWN z&K{mIEwSB#@u9c}xXYh^mf9Td!Bi5bRXI?IHur$Ad2%Yd(7ugcg5Tjemm}X5SB%B3 z5E28aQTi)6eHhmjaeZSL1J2WLSW$TfNXd1O{HRDM%T7vtG}kCsu(}di7QQksFrP&R zSBqkz01Ej$?=C_q4A$9Wsq#C-8;zA_6c$1_eslU zBNiNL`Q3!KnVCYaq#r$WbVH4{#*cU(&n|u$f5aF1#isypxO={PpD9L-3dI(VO=p4- zoG_?%MRsjqXzKP)TGcBHb;!l zPuJq5-1PF!zWpX<6w;X0h^3hljS{V)Bs%2u=WAp;cEkzw4;2Q9jhnH{Xb+CR%8W%* zTH98Pv}hmkF7ccUFb=yZ(g$T$a#ei9vgqGTv%6+qmF{jmBAnu9B;f5B+VG&m9Gsf9 zQ?C=|@M5Lg4`v&HzR`qIjhf@4J$Xszf!%*h#aP2qxbmWLoD4E=L{%5$gc@B(X1S)C zxVsxKZroySazRKxh|Du0(l{ctetLnu_rhniwgf7Hk(MRl+VauM z6Z9x>)WmmY)AL2f#wc{o%AmL6)0SC4ptrUigFcDoq`sK;MEO-f)>Ww2W(7Z8tjQ^1 ztxjSdH6cLt9Tbp_h?eE>aZT)j;t&U2k{>ZPKL8}2I(pv3r-FLRs?@qFNwHLfLDe{D zY5`_+(tA;w<)!ay+2_wuH`*|kM03XAQ%}ClDsM1hl(ULe%g%kdlqIELLpGwK$Vf|! z@3V{XuUg9mw#6KEkjUjYW?id@LDAFDwK)A+pJ%ZmzJe~Be4E!WAX5s{BJXfO+_QCv zplbh~qUXu&f~|#=p#T1!V)8B2ukkr2W_3e36wzFC(p^(a4Zz$~e>{`NPp?U0!`|(& z$M+6##fXd6n&}BzT_@vrrvu;W^zmtT zGI3Q&6AumW2@c8z?Q|B{Gm7UPyp=UUYopt53|@}8Kr8qm^W95;`~ZW@u4C)sn5b$z zwA6aYDdH`Cg8#woxMt7ZuhG+`X2Iv{(%M5Rg0 z+~S$PmO^pYtIe}11+zY+A*!M&qs1R639nhf|8O6*_x?ivS%T!1M9)9VgRXEH?e#bP z+v+XkO=Cd~?@URHbz7IVJ>y-^Jos1gd2&nNq%)A1*G4TnK7UzrIKoY z%)4u^C{AQ=>AQuH&pCO?5B7;Mh6@0{@`gsQy4D7udFA;(6A=;ud}|LTbWK4m9x zRM->VA6-!`;Jt_r3j;cgA*(H{+!oD`?I9Gj)ws`&+NHsM09FLmXgSQsqmD$*!Qvxa zl54B#K?r@lY&u{i&L_aaHg?P_C~q?b!O*OcYB5M1T7hcOq;5sVsSF?3@dwH!Al)6h z7FKBTIUu`ix&B$QzYfGPQ$r~xwIrtdDhLM0ew}Tg8z3=eKlUJOI=OfFux&Su`bGX$ zih$@`#k_hN$b>W~+RRiFDJ6)-$V(U=(>1T4YsfJ-7)ax}#Al~jVN`3pwLo`Mr=*Ui z=|~5O(Jq$`ET%$f-jD0t^h?by|F%X}kppv1P;bwT`e5yrazvNWqDo3jNquWbRMu7# zwTV!g3V*F)rTvjf{fB9CLKr`x*l)FoqH3zaK#$lFAE;XNcCZ_=rYw&@1+(%%W3(6Z zdK4ZXTy%kqKL>+LA?n-!q=@;Br-RyVmer{bUy5M~+e&QGrpuE>+45-Vl+CkMWIE^G zEZeew8%h(&PmMx)WW#fGg*z|JG~f*rCmCc%YU0t-RN>y5(43W*Mn%>mV*FB+6a5Fu zAm@Z!432zP;XbD!UOJz3B|etY*G``hciOBgE@TlY$`5|`RiYH{y%Qd15yuW*xQjG) z!!opyDw)>4cX8m-aaXj(#{taANwjBAO>gX00X+ije zIID-i;3eZuILVjp|c?s3r2pHYnManwKw3kt8`VGQ`Sn!aXi@Nzu z3f;_Ip&W68-^GT-7UWIQ!~M6yDAwa;eJ_UT{`01|s*qAB>h-km?N$L_>IDhWmEA&i zC^fG~-FdB;)u7Mm7w9j8L`92;==WgfKi+>z2U}5qFo86?wuTk-eLsI;BUc1N#K`ge z{r#}YmtU||PXcT2H7>3F^2}7=^`}^dTUNV&{Fp8B2#ABW0bjwX4n0q?JppC)U0o%Wm1SMK9iCmfVg3_aQ&&i*X4)isqPr_0*tGB8774HavP96)B@+A)+M|cF zOkAxR6q($Um|eTc+^->Yueb&|~i#!|N8 zTF~h{T3`Qp@)RRyh@!p2@}>rhMhhUfs34c1>ELUOr(&+Bc^d4Ky6I2P&uE9xbTF%< zp`dHanZEv0aZ6mZBTe{`E5!ZRZ^p2O5U1n!D!;Sbs985ajUZt=srQYxpJ|69<02~w z7A;sCX{574FzH0cfsa4ZwGT0JXkdV7UI#AQ{-aqR9Fm|KkbE=4AdgKEp@~#t{@Msf zx%PJ^GZHf%#F+n00AbG=z1No-4M5+(csJZSC3S!V++JtTWmam>)TKIfP;WUUm>Ab9(xWh_hVoFDd3s+Nv^|qr_;lm~Ww3~IUQ<^jei^H45 z4+!GRd5o#kONo#`B@H9P;r7JCvi)zoBiIhwW9$4c{}T=)y)bO@|zcpL1n zVIbEEV0xX+vjvQa&-vhYk|N|PI!=7+E}nexiCfouxeIk)a6?5`YWaKGKctMUv^Zo8 zW>9qdjPv%~v(#-oimrJB_y|sbEs@u_bZnW$ZTH>aIxlnkoW21AlWdK>alIAy7Hy7PNEIj~h=Ju;*UH5-dZ(Wan+*SK75a2)TX}4|oJNFu^Dl?JW>NURg9LMaq zDHW`4*zKcE#GL|zIE3#zb4@jzZ-`a~A%8^c1*D;#8lQLj&+Ups(X+Ee%>cR!%`E9- zLfOY#&ZIkZQG^;Mdyi=twN)ZoX2b9>-Es)%ct`UR>MDk`iolQp?9S1?&7rF!-Od}^ zyqwuNl8avKqlef;v#-MAxFtieaOT^q#NVC)y${x#vHa1^W3sOI{=@kWD;hW)>ctf1 z0Qkng3FmgVtAr=z;7P*pKp>L%P%-C&LZ@rMM8w7b>n9AcRvF%^w5}PUs7hLVu^z3X z)ExQbfgZwHb3K9=?}%C{T4Q2DWIORg&S-UZ*|4J^lT6?>m`IAPo1|V0>MFlC-{S)h zBHP*MsSk;%pcR9Q5^tf-IP&PkkdbN)^t3cWz&Z)k$>f_3d-1!!yDuPQ%}#r~1W{3< za5DFa_x$4fvbitrnDNV7PF=)N2z`eNIRX!sE>x1gheo-FBw1PRJNoxH=yH@PT17r- zb)s}v`v+fJNRMTh}z4Zn^eDjq5_y4>A zmt#WXrb%Zy62nxrPTV@Y{d_p$A4A^{P-XNI6$t~0OuIA$T5Bd%8nRjI0U^|XO;(J~ zP-Uuy}P|C?U&) z7o)?uRD+IY^*!-Env2>+$H-JO%eeJ8pFAlBkPhnY5!pbME)gk&apg?rerXWdklj`- z1}~o0(b#mqF(zf0!>Ld~xD;|0kQMqNWDa-YAvq!LU}%eNMS3p+O@(rD;(xL){w!By`M;>@=Uc2}MvhRBW?>7=$NB!2`N zMVPEI;7drNR)mr=EE`GRo2u~Vz2>vfX?xArlzk@I6@4Ex$dj!yWhq@eTt2VjT|c-m z9ubA%W`<0wo4(fZq0_pmG|siy11l#EX=~OD2uRSxrwOHjP%E!y4)=mT8Y}!1jNmel z#Zy<|6bbG)r$4090DQkX_*Dqv=p5|yuoMCLZUEiv2C zoA5b8&+FDahHe2t-7?Qo4ECRHlH_B`!;jiE3_SmD@TgZ_4M@} zg}iyPeo+k?xcl}YOPRL-U3YSp^F!x=ec)KD259y0>19ip-R`2^%ji3d^~ya|M5O)J!lDj?dm7DNNeoVX<{{~`{{C%C<~%klOBb4~74MZ> zQ7IjC;H$7w%O}`l=;qf)YVO{_+1!!CewwdEvXK_wLqdQywIM0oV+=iQ-qHSW0OCI3!X>SYY_amJu$$W2I_&dSBA$E)%(hA0o`VcCZ!=i&O+^AF#1MMH`o{GJU8_VzBY{Vx3*Q;ul2{%GZ z)M@cOUAMVtEjFFtT(dGJHIE%c^yAHk6;|fG_EPDKiMs#nj!DbpoQxelpING-`krc> z6=~lZ-hhiVbMfFf$|@oBF_E?)rnItiXlk4K5gTx2@9kX^d{M8SXMztqzBtN7bFPmh z=9<>K#h_&Teuba97DLsa@plfqB7cHgTe;(?7-4k4NBZ|LELLCrCjwHkQ?JY~8Os%R z#p3GnrlfGhR3z(IzJ;k~<8)ykpPws79RqY!vRM}yjZwC`o4x}Bcl;e|vCVep>%*Qh z414KB`!c-${%r?d=2o*PP#2=unKiRgFD3-xS#79QGsZbs`>KBX74%U|G-u}n9|78l zwG^`;)$hvKUzKLx-SD`b_&RqT0V*)=1Xn*wA{*DI?V2|UcLQ=?C?msF1swi(=2m*{1(kw=vC%QilGk=Md__BKOZ6i zcMF~G^m#ib3+KukrKX)#FPygQC zR{@0veKzy}p5W?*{lkIMn^7k4@S_wbaAHKN6@WXkF*KYya{>|g_O~B~+2R~jmHa1_Y zm*>xZPg8vZpr~nr{Z1_96jw>ana%|+-x4l4$C;(7RGA>p;;%gbElA$@Pz^k3SPl^ER7WU4pQTTokqFC@PZ?AW^od(8A)ti_AGl zk#j|I`k6t~f!o>#b8lXmIG&X4^S~P%Lxi6uzFofCqiK_KjG!1uL87Cg?Zn2nQrHQJ zv3zIlmyEQGdRdXTGJNXyaPG?ak6G%_^&Q}VQ^!FmxIp2Q_ZEXF@@d}vJB(PCX>NIl zvGe)uEqr-#L1gm#{O})qLZHV$JCzf~YV0`lE0og>m5)yLdX-V@w1ubyDX0wA^j?Q9 zYE7qD+I{=`0Z{Sbq)v_I9Qk#e~f-UV8e&S$ii0Nw3kmELuqJ&SvS>g+D>%jMh@&Q#Rd_v^XJPj15dY zt|J0)DGIG@J1>N5_nz-n!W3-ZL zxbkP}Z^6MWlcD17CUKaU#h}(nk8VGo&Fw)I`~x2KI1ltj>i)%6T0MEnhN&Eac9+Z`T{YXOf+2vRlpN2Fo12``r~ z_dRW^wS{jz2OC-c_5IlN+;Q(Xe|ee}IX}4yc{!haNm^^&b`?0k_XfiLkJJEgF5pAc z{&tyC9!OyF&@-N+H5vIxTJ}W|_kJ+UV-8wAqFh<3tOC!E{^?F`7G?Q$=#384OrLkp zi*h%*S;Lgz4dVi4?qJww#t^T}r7ei;YdfKp=8+q#ffM&_M@#KMod}!PN9-eoDaWXR zyq^Ciou_BPAdDuAoM&gwEOKOC^jj zw&8r6deyX}BT#mzU&!OXBA~QdOLo*LtGMH6x>BsPA~3$)C+IvO?r-oND@~WIkq4zj z0HQ)qnnNNrG8gn(djY-Vhpy6G%?X=T=?cy8meHWS(D@_l5C)^>-qBdQeg*Bc_9*+m znhgUZvbn;8&waZq@b>ZkVbL{JYeRhmBmHnA0+M5+-vFW=V7APskn%L)##`>wKA6@d zAhrs-nnd3wPw9}y&Re>g#H8pPdJmqvit1XuFTq2uC+@rKpu-qMT-U}J6n^?W%#hHS zU<|GqqAZ9u2OJhxAx1q#%^xZmp)_Sfb5u*wdPosH_Dq+JfzAJl3{~kfvQecYetjaG zQa4KJtBi&EI7gQYG!J+UbbK`eIn`S5lJfV+@2DwD8)f%0B8Q;Vyi!g8>Q6h&37kBQ zaWXw>aHNrF=PhV1gHeL%JLs#rw5DT>T9O#I02`&>;6vW}C6<)2Ku&C;Z2Pb>p136> z=oqBbfeVAw)Fmek|4ei#rWsadV99O)A;8Sc^+2>N99p8*_FejQ%CvS1S_FjlvY_!B+z};lPpnbsazQH)( zM|%FO8I4yDPJ>}_dF*h`uq(jqzRL0{sN#o>H} zuiX-}@`RzY=@V7JvQ@NY`I($N?@e0$c%#8LoY~*&s7O&qyO9VDFLqFATkR1ppMMUUGMg4sj2N!E7 z4t?_Ue~CV=)~jL)&MIJ#%R;&7r5K0+Xw(1f?~kgNaiyF1~B^Qq%x zW#=D^5(_b|-8K^8PJ0f>Ef=Z3Q&HE6XolX`*)|Cdxb0a{l!WZ74d;Hf@B6sQ^Ua z=xzFN5B&%+d*;NxVdt!&Mz*5|F?TAzK>})iq;l*^u6hAfbr=egP#b~0N5$FI#D${( z2iF*;x;15V;-vb%k9!|78IzpOlq;yH-k_*y?ql@!kkQMlUyX_hwJyf!3rLZs1B@3g zR!J3-kd$7YGEy~48D&n6)j#e>iYJ#9Lpng&Z{>AYWiwfc)HTn#6rTJ%W2yPxl7ZFCiY2PFq zrMa0z;if%geChco^ht;l<8vs`5~fRIDsX&v``j|Ob$5LNch;2wa~w-Q|EU9Reh+b^ zv6#2r)O%yQ&e+K8X6#UjXW&Qxrcg?cM?KF>c|HCFv{Y~A-FA1cq?9@4IoIeg!oGb7 zuim}8BeJnWePH!{zT*7yDIlRsuBr_*cpjGXPUN5Cc@3z_bU4D7tz?8{aluXETT#m1 zqdYzJfbqmIrLs+eV@bu1?+=05S3y4a0?PQot=Ql5J4=e`TN)X`7?KFExjjRKh3cwa zUZ|FZ?ob@>tx1KpJ&Pi$3}?g|SDN_y##cPcJ!F<`ev6ETHH++N{Marfv%=d3O&ey1 z;ZC@^R%*(07}zK3Pp@x(524$qx!`}6NqI4_p4TcNDaKkN zTP;JfK!3Nkb=QA7UqvZ!C|c<$o1-wXZ?Uo@J7)Ad$ z7{nXEd#2x-mkyRNu>rMjXi|FFLtPpP{JYxuGklHP(I!S^F z6E@`)!Xr3;70Qhx<35r9PU4iTy{!c@x`4;gChhbHV|4(`EXf6H_nZ*aZZ2G&J=*BlmVM|q2%ze6EhhFkTfD5fK`)9~^t7PT zhV=sFtzd25)IFTp(qCtV;ATTV>I7>mEt1e&ukMC{44vKa@3p9K>wAOuc?tiwOwNuZ8Z-YiKDR1HV(3e!6%+879jlPC0DqMz|7*$_2t_;s~_F zQNt|Nz*_qaBMIv8LyR))sInT%q{aD+2Vb)mibL|Z;5U49Np2GdsTP&m;(;C0Vv)=) z`2wwaJ;s`0jiG~sh`L%s3^=M%l$gdcd{qZsC5GUMu7)}BZ67PUWfoog59|D!7GB7u z#MFtki`9U|RagF3qzXD*hpGI!TOk6fVJshPNROvB5zk2*OpuA|m@%BH$kfSWt4lS` z%gU|1J;p=9M;7PWW%DmmQoRDn{Bt|b!RqV8c=wX^LbH#}ArDvbijdO7b?zkb)Em1* z_A`RN^eNNQAKh$Na&AB|tF4WX@(9H#!bZ^vURfl>$k7C@ao|`r>ih%mIH>r#AIZN! zQd|b=gbt}O+Q^Kx{J7%4Eutcni`*EeBN^>9hMBRV9*z?JY0(rXkOdNfEp=ajWwL$P zKNv?LB`g#4-OJnG+=H)Cu*bPWUsn4)#?3>{?k5-FFYli|PC`n;{Y>?x?78QI64uu2 za$EISsUDtx)KU1f76)@9e3@O&Z_;DxBN%r3sl{MWIAcohxPE>{uld=IOSiQM-Ex;6 z7Vn%o1Kt@gZ78OCK1JbMn04D)t5fHA*A%ZKp8>&-r^e~8e*al!q+XIkxt%Q9K}sj_ z%aGK^79-MOqQmM1$jnl^VYXJ53wkggF7!i+D68-YUpBYH%+DrsW0bk<^IspX25>z4 z>7l4oTKiLCiI1v9$&k{r_kuEF?@2B>hM(bbQRX8NUb##2l9BmMW(V%Rb+X;r4tlJF z&@tb~!;HS?p>`qzgC1qb?sixnU+xY{jw&UscDXkj&4Eq_L3)zme&1m~yQ{4(WpGF) zl2#=QN6?n7`66-WriYcp1O{U6B0C(D9zn8T?pQB$-RjnYhP%2O9!Pt)(AkXc(mH#k zVm>ho2Dx>abd@o(@D8;$)+Uzo&NtC?#eCv zznFkpHyrH#EJSzYf{dABj_9R=rl{l~1QYZL1=hHSuIjGcxV>J{hBTGGYtYDyk}5Iw z(cn4)3$sfYO*^B}&T5R{&(>dAOq-A*%?~^}0|;DV?B}oDk`~&O&vRB6QxXbhBNPXx z_?L!L)J0ouTQM*okk0C*a7yP-U$n^d3^e_pu2Sm0u<5ZerKQDyaJ~TNq<;peoqXRL zV-Oc<;O-NcrI##gpU5(?0tP6YSI*d@&A9t3tIJL{b{)NH%LYm#Gu1E$=EhT0Ka=QW z(%dgu1w}yPML-X48kDht0GjF-4orQXbgAw>tz}9`kbWqiVc+B^+0TCOL|Yc@EKQ0% zvDryyi+zNyFM^dMBm=vfc;s*}odZ$xn?hbM=upZ%F#VDr$$+Ge>}Jc*8YLI(t(Gz% ze@8YjD1ey&7{nvfLmS$Nzk*Sx(qcwCF)M0XsY3)Px_>}wbb=o^W;+{8V)P1+y{mC* zHBvAmXN>(t)e{D*OG>ALLgkJ|cy0}W9Gky!a&@JvVM_x)Bi)e-T^|$1EE93a12YXT(r+y!%<$#F()&@J{ z6Y|i6HG3t+5Hn=vQE@cw)FE{V6-zUsjs|o}lx>_5)BD;%-KZ;K3julrsq9i&%h9z! zpM&>|1svtj!%ldU-(b69jE1tT?&ow1G<=KTgl5*L{Idt3KT1VY4xb=X&#a;ZYb#WP zDrPTv2-$fm`B)hi7D|OfANDagW#t6kTyueSB8dDvfc}ltngOZT7vIVfbnd4#J~LFV z7N$aOA`Fx4y_#s0C2KnMmLYTcYDciJ)GAUxmgL$}j>2yexK>c)@p=9VV*s}gqRt*I z>?Z<2p!jN8+S+K3Tg0uVzHHMv(l;pgKodBxGWJeg6@plApHRPc=xauL!^ivk_=oWL zOt>{;m{_KA2{pr%8`-i>xH=l0w2DhYR<7H>^-)AUIeN{H$0=>{|GLxk?ZS&sC0~`C z&2QzD&9ByTc0YYL&f;xmk%@7rDTl6LD1`RwNbY+2t`^j1PZHM7<~%8eQk$UZpSG>p zk6Y_km^KmY0$U2!?tYg7F27lYjR)~QS=vIx;YFS0Rqw*2$MYe@^UxJ3sDt|9oNQU^ zr*X=w$^S(U@M%md(>9k)zs@hPU~JLwyiFB~SZ!oYLeELNbwOmo@-P=zR2`?1nf=CED$*;3bO zg!f=-^DSA4*wx5HPDjJZpA>j2^#8K>odN^2wGdYt3t(Z4 z|H2(Mx}EuQ+2`fb@hMq@;}@GX@M}0IYkj-AnvH0ip0G)ke4O!6*@j}V9fra66TpD% zC;zu!Qi1Wbjqt$f_}*TgHRL04O6&&c1cRpMXHTW8fuUgB ziBBqYagXRoc$q%+AqS7=)1gJXUtA@*gNJ0lep?Mur5PzkF&5ITjvO`15$`PeT+4Gw zOTBZoDV^X)8|LzB3$%oK^`?uOYwxh{QL8vPrI(5S)_dU`ljGzDGAhTlH!CsQn?IiG zll1i?WkQ-m7}Ke_>vllvG~L-Nta9qn+{f2~dKOE~=)Yrd3X%&xO6hTSgylj}R#G!Q zzLvn~%dJVR%3qrUm`XP9CJSF_SLW8 zssgE>kzHT&%u-(Qx8V%3r1gmlvMQoKH<BvSxMYWENf(*fe@DSL7D)UUi**yzF9%#2w!v~XaJ{Wq&b;@ zYK4!~0~kp$X4rM$_D0S~ty-ygkM*#zND<>k+ChSbHBpciYMuMILQ^TQvPW(>xQ&K} zDNzx8|J9ah-0i2+AXAu#GEpLHsxS3QSK=25I?E>OIoU<{dmpg7M= zs15Z+Vb^0ZQ^)Z846sf5k2OZ?YxP>3qsJmzB zsinV~=@;`9;yI6|x=OI&HdorEErU1c>{|qNes0zi3MslpcO+mX9Xm(=q>^=&|0xi4 z^41sc+kkGxy#3^+Bb9B2*RrF#$?C~rXQ;D@uEpMiv?gga5(P>hy_p$=sKRn6!!4&C zGJQjC!7_575nNs@rXeWL_RwBHLEl|pE;<*klqtf=QdMhWwHCMKq08&kYN~|{Pb)1W zQj25y;wLx!;%U#KF&-fsyFb*8AcQJ31!OvtDDO4kk&3+$Pm+>}$p6hP6bri2r`04T zUcet!^9v<(!%rlziP9dyTy3Nvhb{@Mqe`N&F31)}5Ls_to$KTvxh%PuSl^r|ratH| zR8WI6)6h^HE+0;m%xG&=KtZ~!Ht%L+K$kr`p2r58ti>%iuR*fmo~Cz>RW3=ur5!rY zPFgjmcVOnJ;r0{Zzz{SVGRuhcTQISU>*a}lk(Qd~SJKl&US)`zZHIlZu0A;{{mh`S zaFtvwV`7#=4QAm>aT1iGAhR(DH+o$M!rUUyB4lbFXMCWnPFQGT+-hcDn}{wN3T&gF zXL0oN+w^TqOvGy2e@L-Qfs0sEjwPaN2@Y5@sWT+lkA_l@G}SRq48#G{ z=*@&yBmzY*Mp2w#`+g9;SFiShyGCea6K`tvnR$O@>^h&d&Qh(4ACQG}({BG}3 z^=cip5`|#-YqQEZeFsF{eC-z|9ey<=lm7GFwXfNl(RZ=>(=*|gIMT?4>zRtHSyE5B zwZqz93z~^vRT>?59LEWdsMWR*-uZfNSa#%YpNsA@mr&lPRP1ERaAQG#XcN^pc^IO7 zn_t8ND-QjF$Wdm2iML%*Js|FO+5}LX1xuEhI@hjs?bQA-%piMj@7q_Pc`0{nOJukST4!Y=bzA^?BAQ&Cu)@h32DlnhP}bW#h4}pL&$u zI#6n!cBT6p8kUl4llAZh7-OhE z8{ml@dGe=30>Onhy1UQZx-VvxVzd!T!3HLU;6{MDX}X1B~li#?CuMRKS=Nldju>@@#d zU?JIugL-Jo}wRfd+(iSZI?-Pk|w@!?#p)nesCaO_kf7^B!w(b*ct(c5I6YTaJz z!}3$$QS{czS}k+sYJvbk2@}(@40#2D5m89$ce$`nI*{>s^HW_gOE}rD@GOYWxTg?% zwoqk~cq2PqGtRl-DEPFY+a!Z(g;8|8_U=((cy)s9Ak!&_Zg*_-DCCPsz^*%Ct-35! zqzbQCmiUuCf!EpNXby*d{lr%&^FCYWvu%i0pwN#Pn3e+r19l6tMZRxOo9R-USupKh zwrL$}8fWc|=LVz>LTUTDvNSjl6D8oRUn@cv?)_Sv(PH{vIY&}UjMe?vNiFg@3ioD| zS&yLdmBZcDWu3h0PHS4e-f##G=Q{cHwy3)EW$No94%f_eO(;q}io|I-eJXe4qrlKQ zbxDjJXH3wvkvxD)v?E>i?!>JawM_7rh_u_MDh-F&BbH3zrM7ORta`#`J(*~=FNLs8 z5;1aXB{HZ!f)Ja(qXETRJ%b)(l+w@&tp%61u^&vQ8-nXy4?~ClhIX%0@}!c_Hj+)|D)+F!=mcmc>NkEp-3~N zv~+ifbb}1t-7s{QB0~-cNOvRMUCPi6BP}^}!+?POwB&wv4NbArzTIUPf?O*TL;89*@>wo?Wyl8 z%)~!xC{jb7*|2?A``~rAzIrlVlrLciHjrk@%21G+C*mwEoD`WX z=`Hb&F~(ME0zU=V06m6|6un4wD3;RGN%3G0yDN9#IK>S3H?wsbGm!&ZO5T1^O`6;vFz8 z8NS!4=mT9<%|UZy%B|vPWS7q*wi8W1L$d!Dn(CdJgW9sXzZ{t+FAyF(TbD^Am#-rJ z=DJCy&@786QR#4zfQ)iqDYpEGmLh@Iy-K#i6Pf{FOr^vAa}1U8ylZdcLgH%f;tius zV={Z*C0DR=v4s|rjTeD6f49cg&cVL*EGg>hxJB$@A|KJK%p?8?;=lb{Qq3AIXoH1-L60cV4B>hSGbPRRSL8I%5G zei8cSP0I+ctI7v!%B;QxDzD8`=Zi&gbYxmQLQyK(cF+S>DRIU3VBL&NS|v{lRtH^1 zE?kW~NLt*RmAASl^Nni|^fb?J});+rMEzCh)f*gAPeQ4rRtbBv~3dT#AZemnH@-^z)Z#GuQ z?Bh1!?6!ZcN`b)x+whxYCilmi(oJf=?tmF33a2w=42bROOe@WmBKa(Z-#r8o#O2p| z%%aA+&cWk_EmPkCu;gA~NQI?$E*7a?{=^m8)j^VHn}n**>XbiLU#^2hsd5Z%U0gz? z`?*GvJO=KLXfa&`8NGxG(E+&-^Eq>t#Ox<9)V^=3IKxvHV;~fa)rETFmCHKDr-!wn zs-uh5rE{(NHDMVp==V%+G2}AVo*P<;+rzTRkXXvd=F3_qMJ6YH__+-D!$evnVrrEw z(Dr-dE}MtzA+^jJ6x+*6h30-OYox z8VEkU4Ddw`J1LB$!gG&jwk8QO)w2P|n*ZX8lKhHUI=CZiH#AI$X`7d8z?Kug{HR{` z9H&&7sn6_xX4Bd}5{slziqgXYAkzMX&NA+AuP(TZ+dSMbXtTeJj0}AGRVQ71rx+=q z>JPR4wLi$cD%8EQ5F;06_CZ{&YJU9e@<1o~X2Nz$ko?LyOAran09mCU8&>JW>f=k{ zkte4}KL{(eZgf;S^CLmDi^H~3FCAWyI6C|2t%z&W@Mg7$*R=AF z@BLuK2=Jm$GyhOq%%}Qri(SG-J)FSQuWVT7GLV0f%2+AS^(o$Tu?Z4K@NLyqWI`92 z1_xT@ldWhfBllV8H8b5{L2^S$H~i{uM5!jDp#*gIe1i7etQw!lhWZ$3gJm5=2x7^( z4_G7hqs-F^)j5mbddL_^REJh@t~^Uir{#+tb33KYx^zVK)>Uv13CoP0`~P%`&v7$f zqUpcPcQR1J4uLCRRFF&#ufd3omPxg>K6`9h&Vx5l)zyVB#UC!>2g0xZo-}Vya^>oD z1^BK5a~LpW?89Tk<;G##Du++CVD>8*ZfP|cMG}n&*XE=E2!e%>Sl^&Byy~q`&ynGp`4d4tFZ7@(wW890<&Xdrgpx1H3?oDK5M%+;b|HVZz2MU*A5<8}cnmX}vz0zh8$iU&5 z9lL19#Tb$uEnX>$2s}A8*4I!PGZ)OQOMLt7bg|!+fWaX9l$YT91UaQz<_g8GtQrk2 zQjzc6x2DO|$Xd_ZctU^yvF;fDM{QISQ7=QUX@8Ot%{p?vf+<`wE6Gk~tYE8I9^xHl z3O-O)^m$$M%CEXc`_-^hyHcQRZ7$u7iNm(vN7_4RUMqqi_{Yi1cfC#Esqz32n3lCxielaJd!n;LV4-E9XSi`?E`_ zcPRsK1xcu@1tu9^RF%^03Z31&{hC*+TMiK=<=b}G@EOW-ip^nR=S{kV&#GT{KJ3w$ z%og!&P;4v{(Ph^SM#?m6j3Mt<4;EtWen>B5yFF*7(2=EjZj4)>rC;^2+0Zm zzxLO!f^#ij%z!cfoyy*=IiBUVL`+JK(Qf{`uQ4k1$}@W7GdjUU5ej6I^Ycy6M3FFwYZWFe z(?3FR&OxcqEE2ouiiXdtfNB3 z9!r(IA0X!Wo9B>MJUVwS8NpLZWyCwKj@8SilsYZkQGe*=Z~oIU<8N=jSz&$p9r?nE z94xGs?DGuRgMsYBZ&@d@q+hjYdi*xb2kG>Nn$NKb5+OMs`(t`fU=gZ}y3raSN6&mGYED4kX@^f|$uu>o z=g?cx7qjIRvA8NOAaSHt^qt}x9}^zZxdID#5t#~3J!lx3M7}0MHnG4Dx9P5x|*Fo zY5h#hbTtCNEBeZJdT*)@_JlFe*++o4UeB6~r7*W8oA~j1AlT~fTT!u(3bS@>1SPt~ zy}V8p8q!OYQAj`I>)QjC;70`U_EM-iwzGd`ym2XkDK^hY-4JBkqX(om|6Hp31+WNX zZukXC9kwTeZ?G1HRqqNW8>;guBPwi9SK{mC4TVyg14f#h3KLI_&qb@NtHCUFP6@A{ z$8%cHK)=jBd2t5XM2d-vqxKL$0}ec+@=h+`!KF#J63wP?T(f{)P)EXyl-rnRRR_47 ze-n3E6f^BK+kKf9JjX-Lk#H*47>lOctX0uJj-g+m(mX;V##yIZ9g&F~GcfRsZV$C#kAB@j-z?t=Q`!J&)k z2|b{JmQ{uDVct%aY=ikvgu)!Zhv!m&Hi{Ul$N-CgVc(xh~AVSc=UBJ^tWK(o?$!{fhdwZ!di^s zA_qiyd`&VQzBF5$xn1kmB)him){zQVCuan?AfXqM63|TDoG0BK^M2qC8J@FE!XK6v8f@t?q(f}NY2ubx?Y+i6>r zObWP?>-V|R&k}YeXTJoB`nS~m1@em7?H-EqXII_&0!%wC3U26V-_Zw3($=&oJ?{ntPT?3Df{vEHCxMLb$wr=fnyKU^|` zWm7JFhCqqk4?TWXX*4AdrC%}7ct7~~(U0bMZd~3cEd}f>-^pQ^k;-7Qm>IMhedr1b zEIRoYaC>0@>`hd?^0GBl=4gLiWQU?#R(ZyFR*kzk$FSA}DYF;8Q<75n?8?Os;1_8o zTR~FaaJ|T!*wOaj=gn}3DsWRHtB~vKc@kV`1R#svwiiZo?(NF}BYS#?+YgNCyg*cH zLS&rwAE}DJ1(rVCS1CoLAp!f%aKtMi7kBEyPnDBbFMxD>`|<$mz4${|Nr_EzGWA~D zS0^K%KwmTer|c4MHQ=irbS1Ko1z5@(W&<8>S%U9V#LvRT?*)Rc1cLikAC`lA^v%oy z@BS$&*QuqKB(=QUHlx`dd~n;kJsRbAZZR6r@V4x#RGt%Y&>dp>p;VYZuis>G8lF5e z#3oQP2{2tjoc&YY*hX)gxh0aM=0QU{g>-G+${TIv^gL=h$y}V5+BVuwO#H zMWH>bwg9J#H_I*Qul*x&EZcbt{4puqk=2PD8vpZGdN zKB^l`jGkRkv5Tei%-DURdA^h$+M0@4`e`u9kT3`*V)IBXxSw?HmDRxCb3HE11$`zN zbam|FWTVo?8dfDZ`{gJ~85R%B2!d!459~fE@N9UCMKhUiP|$$$)3!Gt(BeYl^Xsc) z6+aZct`#7ji;tfCUOD5u>$7v)U+-!=o!$=)VryGUu4F02Gs3PpE$t;Hs%F<$IK(5#havef9Hc=x6<`m=_P zo8k8{^@J%XXvrN9(#yP=kTI9JhLsccu=rN~z@UdN`ZRTtF@$~7b?xuf{r&oj49J96 z@Y*ZfI{@v$`}U{I_8znc@44~|_c+7gH&`Vj7&1_AgY^99|N9}T*-SW7aIbemYsFC2a5^aPQB{$&iV9(!pzJ- z*09R?6KwLPv^jw^q{ak1h1PQH@;H6{FY5aG*Pfl}K0d1B%XEX05&~kobh!<*9m4`f zI8`-O2D%8k0v?9p5423{U;1AaARy9jVgDU+WC0pkHLGB3{icT!& zz~LAIX>D7q?_R9m14v4v|C^OzC(iBoTpS!D-p&4K)tM}W)OO#9(w&lTlQmFe`_&Si zhVE`jNiP@t(HIm)c_h8YGf__$V|`}noh3>oKqk~#QkrsLq{F2~sMUz)J~z0s?iXF% zE2<+u>bf1!;S%Vt5-n-PCLHrKwI7=IB%Mlp3~_czqGe40EjeGYjwrV`{54$V3dgX@ z=3@Um6LarUUzm}MQ+T&77RZq++1Q4+-Kf$X3MiZzS(Ws!1D>FEAsKGwQ>v5`>y1(d+w3GiyV0shDcg30~&aFCT`gXj6rcUe53__U--E z;6C(vT~ce2sYBdq@WrJ#T}jr@3HjWl)jY0Dsf14^$_x%l&D|R_?auRu-lKbT ze=s#7gllVZhotdcwBQ*hCR2wZ=7TVei3H*xRQrj~!x2UQZ*sYgA7lz<)O4S$GIh`$ zetyB+tYC8J5GzRvawHA?ZUp$J<%mWGiD|2&n_XxZ+>252bX44RQGlVMzx& ze2afTm9v!c5(jkjme2dqPu2qW#5VJ4c9SztnYugL75)$BrR5P{Mipy zh+`^h>FOd%)P%8oP$?#L?)H^iY6``SczXYlgd!C+kEP0^xUdZ ztyJ3JYtPv_@P8Bc? zZEpdmMSh~O2q>O_N9PWEm`%wrH5r4)4!A-9KSfYuiqF7nDYE6|$DsRPHy+!!E`6Tf zGDFXH-U3-3E{faL)4dOQmYu*eJ2Yp(pZwq@r!|y+?9rCnXx+So=Vq;+JVR{087Gfx zqI3A~^{>+{R3yh$j;~J(=fAHR2VeMTiV`TaH{5(5O$E2Np1(B53pv2+PeQyx{6X;2 z$gP06`g~Y59^&JRTLu~xo5f-y4oT((|Mc#3+THvrgE#^)X;ehq8JfQ;v_5ax%gdI2x%&hypowd9T z`UO&2YI^f05%4&d@nfi zyZtm~&t$hLwlhy>81I}+d9qeX^plxW!v71_QvDRZQqWjHz^LacXo%pu^K=#Xst7EH zMMl*fIm%-hma+!c35(3q4%)snwfEh4lBU_O?Wn60Y7>dpb(!Ee*2TVh10J|1TlPVs zIcQ((-l%B(a4P=y|7?f4$&tmCc8jujA|vRe|CT6rjMp+`g^C5IuO5a^OXodA%F5^m zMsIwI?a17iJyhf{BdxMQVevTMe5_ywWQ&CDN6DOoigj+LNizLL@2)Q3(98{Cr7-1~ z+B7)uzLxq5e>}TAdRuM0T)XUL`@-`;+E`0h{UOdhVOwNtive*3A35svwX@pkz2&ES z5-Z}xtbfjG6U9^4Vp6+9&^SJVr82XYZe64v-7=PrTl7YVz)pRRVkL`72I8irf!xL{ zc-U8uN4KU%-Of-v%{@H?pYI`Fmkr}?gfu2UsA_iZpwM>6s<7vHjlxA{K{{uD-YKU% zvk`3$5Bp@MZ_SR1uyepBTOZs?Y>maN6lG%U3J{t$VYqcSCBbx8wcV;+#8;<_>9{6P za2kt-v1q_F`*EjPAF6O7sJT9%_tjbUWnwWo1T4p=U|6wwF4Zg@xmKBz6CdYvO;21& z8)4crnZTLlO^p0J!)0!(s;a6o#x4O=#?2=yXUOm3 zb*o20Srek7qH$n=_mC{P9vAui&fxk-;uh>w1)^_AIYV39sfeWn-%dw5B} z#J{b~6cWGUBpfx4cfr=GUuy#pFE)|%6DU?4iIdauNiT|V ze>bMgahnA$4^wR%W5xKfVwrmhNQcB8`x$Emq;DwE0 z^fkvAg&o!nFIbQmMXYvwOIw<~xbL}>oOO!_kq?oHc+GRkRh31IINhiec>J?naw;vA8|h&N;t0`lMROoP1*(ZtmhLM?^!RRj_?f1%2XsD-7Il{#F|QFh z#CL)t4kok;xNPYI*d18SC|aY!=I(DUZ~%ZAOAsjX?#cQ5a_IPg*2>UG5s zQOp;*nU{hVFIx)<>0g_tevRk{WMkKEiPM1nFX+F>EeHB$s;J*-7*X`lQEtW8g9~4- zpg7$0OciJ4E;YY>&0>?tFe2HUW%5tnz55l+BlK?KsyFWXIOBb5Ygf@ZndaGH+lzO1_(&?|ID`V^rSnQxF~ok# z?ms|c^M&Kx)xn7$Lv^1U(@)`sX-T|huO#~6xu?V4_;WAa;0b&cL`QF1miyno=*!o8 zdl)BTK-ckBbN9_#07o*BBaT{!bHI@DMtsT#>lYrPm4(pz<_sc4ajpkLFO+wp@bGIg zIKi^X3F=OWxjDN|k+J;hwx)-a>K|G4e`xgY5}p$iZ{UI4`~5~Zu?xw8x$%nPpM&rR z{NP(uPNdm-MzgbB2VGXWwbI-%XMfG;S0pkmJRFc=;wuvVYxe(NK^=)4P$S^2HV&3T z9Jem4x&r8k4)N(LwZkTV2&9=D0u&%wJ_g?o-nf}#e4zYZv+R+JRW;w z%vdtu&xjo;nb1r!d1v~a8EQxRb3c8on0BWZSukpyV>dDJW%wr=WcNXFSEgF<_KQH6 zuV;Uu?))E-T1EB{ZoO@3%oqCA? z`FAx|v*+0&f>byv6)*cx|uJ-&-cMi+h=v7vV=1lY^4BG z|B)bhmp*Ku+=TNgQO`x|H-Xe))K|s6rr2WrEOiN6 zo};u-l7{{kntdo!f<|s>5!RVu_Q3=(0ko;qb+#Z$Mw=0{oNrt>Kk2nWtQ#34ompVL zE@u%B3XviFCJA9!Qq^38!lvF*V++!9Ee(rQ;0BMQ>in~@r~G>RW0)^$@P)3q?D4qZ9rjV=Sz!Y(DUQFeUshi5*hoa3om(+DSv~(M@PP+@G`9 zP1)G{!}g$F!1LyySFZn`VBq3H8W#UQxZdi+vG*ZA88EMz^D%G(RRXM&h^uT!b0AZ# z*HWi)eDao#$h#mbJzYbD5hus9#)=m7f+^u@oB>I6w5Z=AdYVHJYE$^WNY^|1 zvA{Q}W*HbHKwODYj|$rC@w?4mNp-JizDbHdXgVCYSiHggVG^Z~T&xY&7#N_Xwmhyf zK{RF2nR4qQeFF$&br8IoTF`oIhfL`&KjNYq{fs{Wjo$G>5!l{96U2feNN&%7b)?5i zunKp+12dLfj~;9Yv;d{@SjcxgU4K2_BbJN;Y-H-qY{eC^-UQ?Pn+=@G3HeHTyS>Bu zY0(ol;1IBMF()(+IFx%4&7tuL);R6*Muq9#L+ax9ahUa4j~K z($7tC_13ZYGEmQ)`Zx{i?p0(bL%EC#N-?O(^GHGfRF3ZY@`s(i+~|3G4nR(Oc0@St zAK=*+r1L{5@wC6~1YxVI)y+g?K3e`mmeLNvi=QmFXsxt$d7B14I0>DsSITByiKYSdBNFf|Ovl+h4kWCPT>#k4o1a&wIw z+3yQjif;fmGDo{iksg;^G;GU)!3J8-m!Tpvln;{~s=VK~|M2e7H_vYWQae*#$Q-8c zxyH9$wQ=h*lA&`l-xR$5{^=liXCn9>e+1;y(VhEqmm{7N>suwnplwX{9~EMdS4DSc z{)nF(J3J*4xJ>MZ`^OTmhi0jM2s2xA6GBwqB?AxD2$41soSox6eMV;W4jV%e07Z^s(i!U^kKYdf%iIBEX7toSX6{DUIkGT$z6 zV{v1pj8W1sje>=Mh#NTm*>oA#SnTUvx>KL@5 zshT%AF2$C^zhaN;m zj~uA68L=Q^@~ym)uu;#-c)_G!uZmo5@A0M^2wMlG%(JZ48C^1UK9-HdA$fMYCEj z#EL;tXE3|s!Z)`2!}%RX?}MQE+T)5?Rn2AHAc?e1r%>@=RiX-w&%{^RIcv1gDg~9p`+lguYzv@OA>DykN z$iyt0(2TGK<`!3~_i}DePekQuKVf`nkMt?zBZl2A_zGb z2FN87#u)0_`;)QHRJqffI=^8wI-#{$-Dl^t&5WcVR~koZyN-^1=c^TV+*_wktsG4kH10Dyo;9cyCP5 z^-*y3v)YS0m9Z^HD&xWR5Zbu94L4DX(s@sc6=81Zu&^c@t%fE|B6JbU)H4l#JGmlCTV2$fmIP5NBtK@dS5v;s<*ZuS& z`07gBts`K4{r;;jX$!YO<`pB4M#BYYb5P@8m+86U#)E!!=rMNXjNiBTDP45T6DZ47 zKy*@k5W(-HOWPmxst{?mjs?fOi&2EMGy85OQ7$7NsxIzFO91Sl`~cbNaCQjIBS=); z!~o(tmGcQ(A(&H}t$ z+s)$lu^A5rkM|`xzE6+%^f@i<2QK6Fg}*%fdP&#eM-SP)=@Im<`)WQGK&2K4Z-JxM zYt;c-*K8qiiqeC0;1l3~> zV)D`D!l}?@UfwGu19qfOh6=(DMwH0qbVmuj;Tr+EZR^L1Sse zYt%{}p5)^JHy252IbEh6G72(X88R9)pdECx!czUJYDnrfuE`8=1y{Dnb;FXy>ilJ| zmyk?OlKcrBSW;J#FF!*U{Z~5t#zZHS5k1AY7s@cZhjxH+&$3vI8*(UIt;HfW*bW`x zb*20cGAiIQJo*RfWXHK2UWp1h)5e>D+j8(v_)1&N&iXZWDGaL?Z^jqvX?OQgM&c+a zvdK!+i;Gw${!3LX*odmvouWX}`5Cq+pHWR|##(ols&9UiRk%p`T4Py-oemG02)>4& z-2BVX@hLxhrHQTURI~Aw9x5##RWrCEN2UiJ5X9esY3F8r%TFEnC8$_f9~z#S$v1+L|9zF_9*JodZBx;;OIpY%!5ZoGC@0QRe_Jzd__1BH)SK*T{DX*#c|9~BB)T?tqG+(L!{Q|aqWJKKlsIqy}Z(a00x zu{+?wZ}Z?mto?!Qq$_X?dDgR2{Z7}RwY}Xy>gBVf7f$tZ&;G}534TQ7K)Y=!KAAKo zq?|T>mt?wtQ(FuVQMu7vkp0&B5wiU!2P$Yyc{?Sb8(`Abu z)@-?uC!Ynid3~!VfztQabp?+DQ5~H*Rx^g}P|tr`-{RfPNOv0949@oScX^%mgWodFp@$zGU|0)=vOwS{>%j_5+S3tUOACt zDqNyFBGx+@w$gkf8E3(VnCyQmZvtvvWL4kUz}z}~@4}8Vyp<8Lu5F(TL8{*!+sPnR z_8X4s3xn%9BbXNmMpkOe$RyIS)aOh@q^qtiZQHk;rVG>BubYmZK{oMd3k zIXP^kUra5o8A93WGRI2g9lc`XXuBZSYEMh=?oTt`gNpH=j^00sXo!A08X|A;otZu+ zjbayMD?7p|JgVX=?^XJ*5+(X$BeeP8+CI~cbm}=Ps%H`_vPU;^uYK4eM%IE$v4iJX zYt~Kz*Kpl}Bj+Oix4*WE?4uGP??>=bdqN{4nOT@mB%+ledNerdG9d49`;H$kAlY)T zTFoRIjCi}mjB2p)Pr@PfL~54sS!}CNE$iqw%&2Jswr=m-LX%>#eqXmVj6U^5))VTr z3duc5J9}7ysl0}BYM36;Ehcc!6yzBzpn8PYl`-Tx@RNISAG0siEE#IFCMWO(rYSs2 zuE~XMFE_8Q9q=$Q0Hic&E$;>vnZgr}UOmMjE=<0*?hBw74w`qOw~e-{m)^9#{m;7d zau}ySW#s?flV{+7m4z!HIbUmO22`;5Eg7m6YHl=XUxAc)OjPO>Qqq{C z$*H3}%CxmWV$Mhf%rG(RL%wkljz0m+;!QBmm+Weai|tqyZTfw4H%Hr> zS5J?YoPpZfmle`tyX5A!H`EN6vZ_~aQ0a}$vt}`JdNsy~pw+y@;&VQgc8T?$6pn3` zu$e?abB?#>^%R9dqV13`d1>*gO}CznM<-3|#}h!Ib<9?sKaStc66SK9RW$Q>)@xwYU##?)Q8`=hSEv&0n$O4^DO(ykAGX4+(1n3xV?4czcz7W{RNuP?|3$t6hFUp8&Q+;g(UmeyWzl zpXp*=TL-gOC6&_sI<(e0bA~6}cFclBH3Tp)jBAaLksIYAU7~E{M13=3tyjBeFUdKI z=-u*QC}NCuS;Dh!T|aD|>j=6GL#CuPby+X1`TfU$=p|kEi15 zds0JYvFx>obX4Hq#qS4!#;uc^<0a?o_fPk$*L&UfQ1QpRr%&y;$lwX*JDtL{&#HwE z`VvM8lk~~*>U9GZ9aNu+C3LN24MqbZw z8ktlO4BX+TD1D!n)H0U*v=>rKxYShS1SMF@w3r)$Fv{%izd#X8E!Hh-iHc?3%mqIP zY+G%JKMr);qyy;EfQgccoSP%(;E7_VT@K<~WIRfN`6Uy5ESFnwuv&1}T9!%tBQfAW zDB_%rIQHw~6tggbarIazk;HtS*NDiZ%$XG{`LNl`jft^9_4Q{1-RE>)W8;=+K$+WC z1@+1QUquk8aB#hOVbT@g_j~Bi<*KdJsxDWT6|bTQjPGaaWPgI3?ED#Cp$v6d2YWl|c;=8E&5zmM#+IF}LRGUO%#r+I ztuP#7bKJ+IdT#SvDoB!je2WG98+b^qeIGlcrUFeNuoSd5|C27TC#n8y=`At!M~iJr zzPxuSD7pVQ$a~B=xaN-v6r9Fk()Agfy9AjxInohI?-x-UM+11_G1H_aTTM9Itg1do zgJl&^9wm)v(%Vdq%n7ysflIu|^#1FQ^34REV5F7*2sdB|nt&JBq`jE+bNz9h?wXw| ze;ra$c-ir2lvz4e*<=4skMh5j84wE=WM}`9p;2Cax_0`TPLm!%?+y32YUXr%j%P2A zbT^bS@#z)RdfFssJV01X9HSN-wsB2c)+XyJEbrFAy2T{m{L;djlCPjwG*O%e;0D3Y zc=)(r@tI_Bt0~N^c>!@9i$~leT7QHcfT}vZ_M~BZWhHII$&PP<6T6Urrx9To7GDf8 z##VP?ZAEt;9Z0V^Ugf_Nt6uHgI=*D7f>hlchp(PKBD+y)Pyb9>Gbw?8FxgkuP(KZ1 zec=~pN$#s(C|_RGtaXQ3!Xt!fUkYLp?H9_O6g)~DmX1s#$8?Pit$7@g?szx-Yc8sV zH8FokKd-Lg!opAXWaNZY=CkndH=gVSU`E{KW6mIbg~tYL7&=V0c!cdFGr$J%lVfG^ z|7>@2<(_={{l^QaC8HwEU@O&_kJhPnfwoGWdM=x}h6-r`f#RHQR+`d;VD^x2d;`g+ zuU3XWx7^e3XvbL+ryLi7laT7IMpAB=;&3mOqL~)!IHm~Ohe>UX#0{U1XE!4ss;W<} z;qM>6(%UBg1Py!|I`2N2ARaFPI-g7{f0<6~{CLS~o*3u^n_g41i*X#e65e7RZSegq zT#8$Rx7KMgrBqbG@g+f#B0Roo$<5ziN^9s!w21E2{H1q?(^FeP=|NPJ6L3j*wdSFp zL#*=}Xh&D_Ma^BK4*nS?7L+#s(HgKud`?XKomq~dB+Uf(YBwTVjV}DQpPc%F3!3uW zMDbICsMr^->`XvFfia~$^rp?J>A)_B1R)Poa11!8SP*7uX2_aa#5`Zo;q`=XxmlAk zq!;T+J=+M0WHN8)wau#RjjrNb9L$^hBkRIWU>>&-Kl+O==_L0T@3^K`%v5&MLY#Z2 zKCXdzrUZReb(OqXu@lSwFfubq;7;qr@P??)8dNAf!}}J=S@#oqc}wpY6@J#}HIzVx7?Y7{?EK;n^LUoFq}rGC z>#zc+ra~$K{1f|4BZHy56e4rw#QfA^v>Nl33(}|;^kWc}Z-^Mfn}XkylUg|NUS1PU zw5ltE+x5tn3(dBEQkhs&-IkR(U55x?>fXrZCfa_5OzLsutbnm%kI*Co4pg!s?Zd4e#J9ks!aP>U&go;MU`TPQPn!h0+e^yOvjaD=e)} z`2?6uOeL(;8eH{|DZ=OnZkZc}Bkr2J%Fh>y5dHTEC>}D9`xKj08O;k$Tt2by=0e zwu~^lK3P?@L$*qb(cGlwTNH1!&49e99zow}`|3li`2G6HQ0wXAga7yrR;&C8y%lxn zV01$q$9}Ojxh&927{Zs_>}-PIB`dbuI6FK0U(hfEM4n7 zduNP?Yo#$M+iAI9Sv%^E^F~I&(pjDh$*bALuwx@w45MynN^m!+U0Km#@zmVzT(rb= z`^iNA^_wd>Fr=-je;8}=JH2HCy!kAZJD1t+P(+GJG9*hD_p*?)K)$eM@OcFze}>rN zV5X+oT(yeVOQ>Yl4CVHq6)~6a8FU zLF?RoHEWq$8O|&5?$+(e^p#wiD;h#_s<;JM{UJuWd0(?tnr-yB5vf8SvtA18dUGhv zx0Mg7uRD#U%1X-bcHl@#9}s>ndrM8&;C0xfqdSMmMQwHFW~*l8dzQBpmjCCriIiy} zzfkr=gH?A?=@r3qS(3%YJi7=ped?cSntoJ6*n|ERmzK{>r~Dp1ld@393dcuFs_UNj za-vO|vP?A4b^R4rzhPq{NrVg)SsTCNPNwf6$4jFcv2t=v>K6>3o%Z-n|6_*)CQ-s_ z-hh*uJjnYxk-s-V=#uzx&*U*}phWKY7&{as_?P_j=@`%|hsr2tkI*PEW&N_f32dIN zC@>~*va58dDsrPNAeWFEB(=#`#&DCRUHOrK1~RyLRe+|+%uc{jP?4`byrJ@~mXO{d zQ`NzH$duQ%8ZAu&Z+uwQ5^;>7lQz}_ZzuXaHAJ(D z;X?$qd5n+E%NNvEk_B(zK0uUP=wwiVXi*gAXmTq|O(Wi0oV16b9G4D~rp1t#p?j9B z-HybW%?*`_-=xq5O*DL=dDhId zIC6lDIui6E!)atkt^4#6A*Q9}>K^#5HtaFLI?bBY@;d18rt|(ObKF6Vk?S9jUg0_stOni1E<*qi zdcfl~V@21pSLe~ouArO2GY|7?gTC(2xGDX`g>mgr`dU_~mFgddVzDB$O4i%HFh*@& zs07KSBoRAPopK~ORx4W_-CUd!Lp9bvO-qF={7WhvQpvFQ57)WGqqlV-Egc~{U+=0p6T@R?)>#Myx@Ml z|GCl{Ynpt<6PpEX=$A}}mF&tAl@&91-oB)}3y`4ZW z!Mq0rino@vzR^|+alGqhQ&X*m1%2y$~^g_rAqL@lF- zpT+d2h9%IJ`MCWdKx+l1^|2@!>2;I?Y?aCHZvt~IqpL|PE_W|~clVO$oemS`RMe`j z{ItjgyQ?d%^WjM**UknV1cBYE)O2ZPGA0!uJ!*Jysq3S#>p{ zB*QPG>|ca{>zccdzmkqp!6VOgti+A|kG&SG)+fR(uL)5U#Wd~|WSqj%?=fB<=+voS zG-bCxy#XIF>oHAfD)-NhIZ}8P8W;Mxgufzkrb)ll9QACGG9Wo%VH@{ldSilQKwQsp zus4*K_>?e>f_~W8WIux{F=-%`=nf!=9HQ&rdmSOiH#6Pc$C+_IMK2ni^;=KsdP~iS z;+DiVy|)u}ru`G^@QZ5z%|^yUrwPl?B#qUXYjGMz<>PF!w< zzS8ymk`iEFiUaA~M6$NHNGn2e)`Hd%Hzy|6UH}Qt$ zEw+b@maN?^4u*95AYSx7zIR#i@*7V(%A-60dMRhp@a*3;ksYR5!v8q&lQ+b`@I}u* zckKH&M>Zx-|zSKMc*Ac_&0GOev6J@1lHjN()>o5h5!fFSR8l!{WGVN(hqDc!7m zU6oNn^--FB#Hk3QrSvLJSq`O$px+@yc7|x4cKw3PMpcGA+r7gm->&Z;#>C~oWnjzU_8-{sQ$yKmIcVJ zMMXN#!UQ$fAhp}VJOhu#K339y9&30YorVfo|YW5{Eo2ltVSB{A=_~9-q3JC zrTkwa<>K#YQFfT&rN2cYo!QtR7d!CcWAt$TlziKNhI#cga$}+~_Rgj})ZLAaLgdwg z#=z$0c39M;rm<$lls8@t^DC8X+-LU2(e3)pSm-PAIiX6InqnzJHAq_6E1Mnl51O$T z#eELpt0rhax^+QYQOsKBGz(d!Q;o&v6uR?JJj_=(Uwrs5WTupf!EDly(wBs00S7p3 z^E6w+yAPdHjK4#osJ>Zi6vBCo3W=UxZdTg&Eg6!P-;lgUI=xf5{xp|IJipBApCH?e z8Xki~g>#CqEx!p|6Ds5qaT;ER7Lx_wL@HgPtEBjTImzION|nj|=Gn_6z+E+(RXIW( z9c|3o#r0XG=lD*>QS-wAM(w06iSs;8aZ)YWeyc7LTiIG6vH^Mk~bkIQQN76Q0*?v6tm4}Nt9nSXlXKzNN@)ojGr8` z|J`bD(~jkiE!YZhiTVgUoBzw^GE*t4DNgw^^CoudH`g^2K2v&;^+iFCoSHT%rVJss zLuecx`|+FoY62VKocf(04rB&OAi0YzT(+5tpX4*G=d|cV;kU_p@@vM$#-vpxYIBJq z+Z=yG9#t`m&}s^L=#OErO0s2ax>k1Tv0{P9yGY(uW;`Ry6dQZ8VzkHYQ`G{?;mLs} zOZzm0@;8KWLLECN;7w1qFXd@|Mbm4MaA}Qals|hgP08#v)?GX=(F#Vk<5r2692r^^ zQdyIRMSr0hDFPgZbcsp8c$*4Y>QAo6WH%+oFmAVkjIh+O$mzQx_C4qjJ>QCq0CK&e zy111aQtqWqZ#Z(Mu5};OV*@-R^^Wj;L}0hPlFZ|_2KCoaN%R^pG*=-?@So?%Q_nku zOiWI#5qfgS4Qgsuui05@;-`X+oiJ0DefN+n}%d&#i2;I7@lq0y4 z8eLC0@OnfkqSA6Hx{Q`VQ;IG`JzU(qA$_r|WZ6 z$}YxHx(D;Na9R0^aub#<@V&d-ifWWv;IfCam9Vj*`S()sN2%iFWR7686f?+x6>vpO zc$13J95mgJ)yRG9Du?yiIevAt*wl4MC27ucf=p1scYjW2)+Em6J0G#C_?jqPH5AXz z&uLgTs}cKm;V-vKYqtkxFW-QLT*vYnzLj-tBKOU{*O%8vhRIxG?X|sh+BR3VIY+G_ zS6@avnk`#(TtOKiLh3jFE+C#O3iGm(FntbAPKBAUk`jL)5K%|~OD6-UU3(@0_Y$B9 zVq*8-eu+&B`tkGU2vN-R7^)<9yqKbmt8aS8$*ydgUC=^1HAZZb)}hm<3qty;BqR0M zc=u>N6&0w>xdp!zM?WeV>jW>0nVYadM90?IzC{Gz8;yf^=L}}rq0RH?f8&_$aHMii zMCy~UGm~Kw&a_h-eehmTTtaq-t3xYqvMX~sbH$aWDEilL*hze4lZ#P9xMDfhMgQ#u zQ0a9`#0=vzZg_vLy3{6klOvM%kL50}ks;NH0*67~BuD7|HCuV;L8j7&iiQ;YZ`4hi z_nLzkGOrC~E7{#vH`>_(MtJ)E;hnJA)KX8R|I#Q(DGDdvte@gEZsEcs=>O~<>VUw(^SACD_O zp+C>ikHa3V#yra+n1vnOQ0iB64%Oi~@wm6gddzsw^zy~?Irr>qkJ!n9TSW!Wo+|60 zfYC;`0>wn)^rrJg<}}2$!*9Y{t83A{w%r!wI9H*RqIkw(K22^#$Q5$N#LL-YXPefY zufrff+)Lsbmty$PwFOpyB4sKV=v2hgO`uIFtTFfd0gi_rTzLSP7mAUZ#1iIYo>Lj5H=QTaz+6HW-c4Q&<2!6dk5u6w9IG+t^JQPvtDDr9kFID zB{5-n$zLODiEIcQ(xyKjjXFYK0>OksP)?ed{*^%av_jvBN5osJzNT7zZ92%#j?KWz z3I+F@)pq|#23+6bIqewhuefNstM>+znz~`6h`#`DuAA4^}=EM9T{}`xA zF25#Br@04EG!Mg#o~wCz{N>~&f3oSNv+3czJJm8LCAUuidkp8(jli3?S<0jI^0ej~ zVrM>P8wK99uAQFsu&*YFimzJ5;n7QJ6U5NJTm(JmJkH#%-9DYTGM{5{%<2EY)0RU0 z<|SVbO+?Es#l*$n#{W{I$n6+1B}DCr$NIoo!3r0p4ZFL>$Nz|5MZPKXxqOm)a8M&L z#r{a4l9=>Ype)OnttQ2*Nbh$xRCuTk(Zy1%HN4Xj#c;;Uea_k3R+Ai6{*XFNXQbr`&heMr$KK%glSad>HPTWHJ|tLB zSP2Xc42(p-vPItDmr8#Ost?I^^=#LLUZcvjmx zI~k4mttZ>t{U9q}r+?CghAEYLWE>nElZI1(rtZ~^Q^42RbRhV(-dPD&oU#+zak6l7 z<0&cstYc_2S8*h&M{uk$k4B|twQaG^P;4O+E-3KuV|4agN||X4)DX=?09h#flfV*5 z68F$J?JzSH7|#y}dE(BOt~Q@TI*LozMOUZt+JhqD(?I zV*0O$jDCfros=SrLwrjvdwNLLwWx+QiVkxJtSi>q%G?WHiA`+|4aG@GG+^cSaOC6Y z%~1RSALm(SWmpEdc?!^B3>pTS7Gr13acN672VHb{A0t5SFc!I=8Ux|*+TGI@#2hA+ zWSG2t;+njICwt5=J%oYwTLQh!Q#?KWLIsm-926iJ2Bg`hhUnB|b&%G{)rp^m;qZ^Mwx$1w zn)ZH^B1M(oucacT3sN(n}wI*9azWgHrZG9a$T-6!iTus(*tb zmSTaAx|SY-Yr-`(u}4d*KE4r)MtYQbnG=nKXcN@m{na4j#&2UVzI7q^;zuK^p{|4S z0j$oQxQJ}C^RXhOJ1)5t$DX7mq@D7gxg;O`aLH>H}WnnE*gtm z*LYj}{XAFkC9QUWj~m2+&-;4+JjZNXZG1$}gPzu2uz}a(X%99a)BXVIohg`{s=~#S zicPAeM5Bhn2r`G+RSht@kdn%c>x|j;tI{gx$x@)-M$UW-4}|~S_wEBDv&_3hHq4G8 ztk|B9E9CnT@fLVrd|`@Hi%j%rA~cXGSIY)Ec6|bR+trMqxSv0b^8chE28fHN&Yo99 zV)2YNDsoFtL`aBb<8lgXt5RTyfG^JsbaY@Tt(+na(V=}>u*?=o0Zq`=+=PvUBt0e+ zbB2^Fcav@LjESBZ^W^o_J|-?v48Ppc-_tZL0(ut@J{6_;&)Pc7_J?^pg1E0$4DZB#Ij5Z*_Y|ycmZcH;P(~aAF(!QW{!VW+>7x`7Cem^Vk z%c4`--oQaJWCf!$J1hl09QgprTk(;t@5f49BlB@&^F}A&(RDGNXO$+zr{3?;`9Pg|N3gXO<2A{Zviw5!Q;TQXE@p_DDJ$c!+yZ3Rs z{}|NPd^~V!rrY8b$08vS)x@A2498uaB0yx<6 zuP$-$@0ZL?8WN%%8cX;(V>jPAg7|(LbL#E5OKxl$UsV(x zFO9e+hv)vU-XwQWhMYThyGI?gmnR-RkdZ~JL6kX!A^koDRyp`_$o_F`6oe#eIEWE7 z|6i9=w3CpCU%y|Dp=WJ-B2GfGS*tOdJ_pgKCNi`YWQ9-Y+~<#%qu3IUztcH^Btx-j z>=m}Z=gTW=p2Fk{M>l{kk$)QZ%gR}3Azs1&sS~@No`9E$#7RC1WxXLA;vFyXsHu$HgG*Oy?-#QcDd4HmWci zCM*u$OUz2Ar9f{%5Rnc&%Q|0rCO#LY*jyoxX%Al3!1t7spa(H-dmsr|=zaXQUx-F% z3CUZvCCm$bx?vC}Sc56TH1M`3rKXgHPl%i0vT9(DpupyC6?bpx_tsN(u{YZ=#`!17 zwBpc!GJ=ZPh(M5Upx?&XSx7$9DRqr8M<4!A0`XDr){M_|t*oU7uyll7grqle~g_*RJ0ekuMwp!nzu5}q_gBrc+mc)H;Sxx1vM?)Vs_o5`4+{o-cX+L|HL zU(c4|YFJ6XM&?{9LBkuLX(MmwS*@SdVNsou9;HOP@FbfUj`Dw60E(x{={SnUIzDIi zKV}7ci%^HdQAaEo@xF;(#-TG6Vi4p*OFO}nEVL>t zmF(Z;ng#8?y>)Cat|U@UE^r|0 zcQ3#IC+Sad&}XB)>4L zDMQ16q9NK?l-r;?u(QBlv77~=|gOR*M9NPL`(S3 zi~n^94zM~?XWR6s(Yu%c$uy!coS_T!$%_$cXfcYMLt7GdOC}wJkQOMUrb^#IrzYT8 zd1n`?QnsC-z}Q(E#nKUqU-l%Q7{W8olqA}Cvu^a(nc1q? z7lF95R@=}jXOSn9)d90qPzrmoEC#nm`uBIadtPK;IVuTY*00DcC3p(-D{5A<)Hp;# zc%o6iel(KS&;?cLSI-gnsfLjdQn!|x|Nb7_oowG#NahR#CsROF0Iq9Ko^5Nhd24gN zvwtx&w3x`L*9uBVuNud+_EDX#n64H@cwYInm$P;Bs{)VnLTdwqv=O2z@7Q+hgA#YV zH_1A#*^t&&fAObtNaG2UA_*jJ1~uA1_Q#gAz>T)GD5G;f3PuoSeslvI>@FKUBt~!`A}H-^s9*}qD+${ zYt6Gi^gs>{fV!7{j;N5Cu8gt#RbOxp&3P>*GUqWF7`(%zl{*^>(vV zrfaURFA~UTvM!#NLYND@QC1KzuYYG4Xi2l>nf%|Hf3#UtG$(pZCkIGyMrnjzrb` zd;`pzmT*H$n9lu9=0_$v2`NI=HST%Ln@4lVrawhjJnb?pWM{stDXF0288dAPfW;RZ~ z^}5}*|I)R+&4LSO4WzAhW^}SKEj=CZFz+t^3C2l?d!tSx4Qm@MBd+6=QVJ06{itDm zj-|N$8ZSvpYpEeuL>c&s-aZ4{8cP+aY+_?mV_?`-V%4+ZW(gBDU@5u9sA7r^ct?VI z+)_?-5kyNc3l$yPYfTenMNB*N?8$9Xag7{(G40@IH%J4#-2$Rw;#xVR$KyAjKIm=x zQIB$@)-j>PKpD}#+ApyEoD`-XV|hgO(@e~DTlpvv)=Z3q{H+UaVCL4m;_=llyaBTA zSsv|aa&e(1akix<0bmdfT$`3x1I-%@>((SZgI+$SAr|O>m~6E70jx?xd$e)}X|vHF zS$)FL?!OB8d|(*iHs-e122Xc~KisAh7U%s75#HxvJ6Ex6y*HXM_ z%EY=-Cw2$@mI-Z5+cX_H3`p~nH0b2STQ_tVB4~EG;^KvU^XKi8adkp6u;S-nO-8eP z*UH>n*I1D~@uFjccy}Zu14@t)T|%&Ka71uAPpxV#ql&uE1!6X77MV=<(+^Bu3zm$H=-p1~!y_zU3jKD7 zUIM;1^J8NkiJrA(_a!?SRHPQkvTKotF~BRcd))ykZLhBIz>+LU9=&?X&h{)`5g$TM z3g{?;p~U|#E-nISxd>$Yug3Tt(x$u_v$M^9wYDPC%>petMQTi4N$%r&0u!cTuAL9@ zn>Gp9ZsG!$Pq+PV$>eStmo9+8g8s+$7=oD4Sx2x&imO0qLwN*FhdcrJ%6xpxfHGylFTf$Tdr!e%d;+qN;@bK2KXb(NpAKA@Pb3JpHJ%I%2l%>ePHVrj;tb25P-jzLJk=C?dvBpM8b{_75 zCA4sPwGDB<8yyo9(|qd)YKf-|dQ1v>+@kbq&sw!+{J^Ec2^bB5&i!hxMj7K{)EJ^A zwRe&WCuLQS$PCKuDVo zgxh?yQ&Xn@u-*P!dQ*WU_ZHPcyr*Btd|l|h6YvxA4fwMAaNo2X7%=h01g(jqsZcnH z3GV(KgknZuvtO+oI*n#nB>0mFopFJb@=P2(h!bgW@GnDJAD>6<%IP`0@SHhakC-hT zqwb_x0r;uVh{Ob@a9cE#x{Z6j4fd=g2<2x#ssa1bW?P*mBS_5N_b<$VDb z@e+Si6D3^@?^}G}NqvC;6lCIV3rDMy`m!2u<6&`|2E*|QnvBEPt&eL?ROfJizt$DV zzMlHaPn6MFkD=C^lfNz>!f*t04*V`T8}+O(XY)5707Vowr8tkujGjMbfQg$;O1Rx= zlEw(-@&Yp9Sgfb}g;aS-Ig+e~=B`qG#Pza!(90ljTK4YW2&gjOVF_qEJG}P=4)&H~>qoJyA8$ISI?Wifknv? zqeXlY8=rbm%Ct{mUR89NvNS<#m6>PiTiqf3Y#|#IXC3DvdK7E=P2y@xJDvC*+@v ze64ZR>Tg5}os12)Fbbxw(p%;5j2=5W&B}UN`K|^%280gYY@;s0U+PJ0F*(-hUN=wA zp&6?_m$j)TeiqeV4p2I4b$!-ebY>SrD4kVprM}sx!5D44s4{aU?JO-AcmCv07r}to z3nm4ZcjCUA%C85VIV_+Hc`3AVkT9i%?ya3Trp^+ncMu1~9r9!{#Md2}kKP_YpgRGu zwKADsURwbME4#@7?QGWUDZl(rLDsPi(O>_?aGz?Hy-2be}RhI!t_Pjs$&e)eO> zaw>|Fw6L9|$tyZwD4z7JCIjR2QOPOc(?7V-7*Ln6oKP5~A>lghd@;x^%M{sDS+O3kwH?t0rl+K1SyeXmO@Vd1qbof$SYqKZTIslCN27daM-0t@HSbx~q z{TB_d1X}PkiqyGazzp@=1qj3Z-TMX-*3=0IotL;VRr|m7X-d5^;cP0yK@_#77!c-@ z&9%Yk$(Fa7D^TtpeF#&E0mjvwecoS3*%{&G!Wv<_Rs)Or{s%OHY*gL~4nd*btOMAS zh1!z0D<=VBm*~80uX=*NXYvf4?-E@(``g?f1hBX^uOcU%Bn`LKU?1W+8)l^sc`d;B zCnB%p#K^smE=`o!ltKpBLIIwYWz#Y8KJTQ)A0LO1{^CLw6ZPYC(QVjtA^9X%_p}wK zlD1lg@~?Cp=~K?66xwL8@a^Kf$VIKz&I5wv=bLzg#zw~b^xG2lG6Y5AUS$?mHnIXD zi2~!4LIXvOv`SqkxaixD4r7+JIK_*Pp1P^@U6Fs~3%BV@?OvrN-PT4+@x)K@s)zyn zk+|2?=o!)m(%RjQta?fgHA~2pJz0hr%G8O4Xce=X*EA39f_c$W+W4=g+X~BxVw0)- z@29xqX(gU+vHxvBDw%$@G+Q+MRoJ0^qYMq!T$T{6S)(KwND8`3584m_fHH<;$H(t) zH%=rx%0&YB+72B9@2=h<^2%kX^BQ8cXkl=}T4Oe*kt_$0jZBcZXF0tb+u{~+v4gdN z4jU1D#cZ_CiHkmmjrH^G?dZrO?{^!Ii^GSsr$Dut!77_t{Th9?|Nc^R77w0_B7B8C z7fyt-9skKe?ZB3PJ`YJJ9S`w0Cu^SK05tbPO;kcGsNtqdub3tV3$K2AAvO4*7-yAe z$w4#!Pw$y86}MQX4wVuwHAXsX;7coXBFEEW<1l`CwWFjGeOjBG(+vIMM5TiL zlA$WCq9~56#`v#f1zWZcYD3fX)dY`scgq{aA@FkRadAwqYWmu=a>LQw(F}!Ln{B8K zk1*L{T4QRrwhrON=u&R|q@%zAp&ux>+5zFoY7nqRLZr+A z5cL#UB>XH@{?99uS3LnR{@bC>+5u&lg$j?nAGL~RnkVwZY)v|-tAnfp(glbF7~($- z6F3uCID!yMYuhsR{FwPnF0hE*<;k0GGD3Fb^7GfeluRSQ$yC6LyMe;?BVYX}W^yGF zp7`1Ms2CefH->my6s8KLOFd2*o79!DPxcJe%h|f_-@D_bu~JV7(;lCv7}+7pEVP!D z?d9>46+sS#p(;*0ITTN!1L56m{F8f3t&~-^be(h4l+l5zoy^SpEZ>Whc8#}If@w5Q zu$4{JK=N71CwibC|1q}5uC-x%nI!O|_0)8!u-i2BG7u5JmIVeK?TKC)b8P^{+OhVx zpI@`7iK!Gpik2moAIp@DEhcn2txZ4pT-izuN-u*_Vt8w714|}E(QpFmjK7Tm(Yl9L zGNE3?7&F2=G;n2IetR?^qnNA}T!u+&q@nrg;Kfnz@gj;XnnY@tFgosbX;0Qncva%l zpD?bP(>_Y-y7_&@`qIy6Fv2wy(m+We0ZdKQa*l6D)&jRTH(@woxW0f8=7gqXCcCfO z&E1drbF?4WEJsy_lY1j@4}qJ0m~tUnRId182@AMy3LWH@K4kratsG}u+#$0-iAfC7 zI?8@klmqQ%t!WGs_Xu2o5MCQm?Ck63XVJ6-w8oi7ZxG~u*%t#6&jNrk_3w$#<4=hv z2&b9&L~`oSOO9K|PJEtWbw#TZhIBW7tahs zZF~^LT5P1&}Ki_Re!;N`V+yir?;eae8azOrn z?#Y>YJe4tzVaKi=?~!7|+^E9-T%BGgHAng)y=|d6(BB{S;DP3@jgrC1rmTOjdlsNJ zx~eXbV&f{-e&W)K^nuThkIDcwXEqerarrl9Vq{$a>d*7XHoHCfxdSW#ffIcWy|8sz zl>_n}N9jLlK%mc0fb8QbI_EV89>m#^QoS+7bN_)a)1v;X=v7<-j`{hyy2FIspV;xA z3H%ci{%Io^L>27wC#!YK##)WEMLfY)rX)#pxqO9l8rDeT+Fz~@MhiH^*5E3Wu0Ntm z!?tr9pf1vGhdE^Z9R-8v&!?>tiTWyE#m|5;{+lal{kmL4$R5Le_0C=GmfOM@iV2s) z@Xl4-pv5fuT5ek0z!>(K`yiit>=St=X zd;zSZBqc>I1sTPQ*2%XfJ3kwY1BW=#JhT))jFC5b>{?chUjO{~dx; zhV5jn>GAqut)N~uBTUCYJ&nF+vTp4NP!_J&ti1{e_@FghC2QHEqGeUJvC>K=zPzgV z_Y26ja3sSWL?Um&Qw&_P+ZP=~KzRieYTJI}747Fb=)0lIbHxrw^kIo?69!et-atZk z^V2DS=XSjBodFnXz3mr09TI3iSQpD?mPkx$MICnL zOidEXc4aL?liS(L0<6JKw)^x6P;i8P#4pHbnye~C%R-s+Uy03QQS-48DZ%T%Yf(x5 z8Tr%gD5iFSHFR}V|0e=~qj_sgq?o4(Hobjdu z4?8wkG%u>_5?08{0-nG1TJ%sKJQ6j!j!b(MuXhsffc*q2zV!U$m0ip6C?8fXQdI~@ ztSnX5O@q*Q&A86+Cs2Y=2His<5sY&cST9>Iw~Q{;Yg=E}kB^hm(<#Q9=|>6$Gi^{5 znX51T;cQmz9ldX5msB1dE{OAa>yLux(sUZKRSJj%gcgelPc31ie_ZZjRZOpuS0-mZ z^PFoL4tF~vzB7DlBpH{Dn3^!5q$XAyAM0*Wh{|ST*H7W;NJVXdVUsvEg2us3^DhFU zV#Fi)mHI!4jGZ}AT?$WNe+}>)mfi>m!9_E#=BF34<-j6WPrtc@1GG0Q&v4?3ONrR# zSU*9zRN`AwP4>%(Iu>1;O4xt~)=5`Kvb|KFJ&izCF3HZ?)qyu|NTwuM2UBZeTOQV! zx}<1;CzU9!_=0Y!BJ(O3`Rg}g!LlDpscLEy9tVmT(K4ZwX2-{S5fFC|;IZK@dfeRh zYn?ObiFHCv?a+r4sJTvDUH4l<($mFaW}|l;Wi>ds7u`fD?v}8Fwl32B-{)kPWxgRs z@-sD`iFK@no^^5`-T)Zo=icL;j2;X5c|}c^2IHs@cr_q+$9tI5jOys+JuTJ#OLbvfC*K#-(h)$&{M)9p*1 z6XW!s(Pb`@9{uEGIvy9{dAqC_pb3LBv9?rO-N5adallht%9vjd#a&*H_lwZT0k7vs(0 z0>jb*!mm(lg&5fP+P~u@S6bIDZhoWY6hj~LZv7gQn$V*FML!s4kRr;?>WPGG&mJXt z+b8oVcYEOZ7n!?940*Z$Dgv|b#lL4~>19)siM=C0@yL(MCb;NQ`L?*<h%<0OD5K&2S3ho_rGGzLjO^taZ9!{k!#2} z$dR5!ZY4!V`X7r2Cf7e0Nc(O1a&%cMcRUW;4q zA&WZ6#~2Yv)8L`?S3=y)Cukya$%uoa5t-3yQB-A0QDfe2{9@z8Z6O&UL_ESSn>6k9 z+UF+cc0jGuO_=|C29mq@;or_fpyuX%_xj)n3WNk{N9UI>7#n*$Y|s)D8?~4Y$3(W+ z1UdSy&ik^>dW?)+u`eC<8K0_>^h2HiWK-b%Th57zQUgMGwkt4IvNi_8G*ZI7%7V+w z2jQ{lc4&-(j6iz4BLMOKQ^Gqw;pj-vL)9cxlWxM` z`Sn{8e`c;lF3i_g&9*S>*b2nb$^89&ivV$}R5)(cim_BoZt>sXw@j-F4Gy|Vbnl9U z15Q(96TQIy2^c`F$NJ`i-yra$Mh8DhX4`pv%}T9;@g?iFNUwWxe+jMQvy)%*x%~Q@ zjlB!>SP1;3iy{W<1{7|ld-vZWzeyfJ?pD9CUMWgDYBI>Rfb-%|T=$oVFCysgj?lWqn`-;&da%{*gMpcKOpwMbz)I7w(d%PgDVIBM9qk zd~bt3z9J(cNR+7r_ke&kxzef~Zg*yW^0nL5c5L4NgGCjS$<^0xf_*}|gchr}0;&yu z&TU4oeL~qvvPrR_whr$Ycu4BC?+>K<(%gk3mP}^1p)JF!VXY`iuHn8Y;a=%f-_d1{ zI^`*tb$ja!)bG(#BKhF52S_6sNvNb9YyMOlxyU~TVAd=ln8mZFeaa->jq{oTq^6&gFT{`{j?{!_CB%eJR~= zE629`jo9`Uv)z63oedj_ovK|qcDy6ub&Rq9rv;!E&JC(V4v@}(2?hGU-ShKCVk)p2gD)9iADJ_@x#eB^s7o5 z^-hl2|KtJOv+p8rBfpC=?>lCd6`W$Kt`LW9-vwTwJYVbP-rft*t_L7dJbdLi8&NWm z^)Djkh){2d5c@_=zeqoYzMKWM>%uo^fWbMj{J%sHZ)h^>PV&KfE@3pY7+n zi2r%`-clNdP)^=DJ9~8^^W*ICcJR!Ns`s~ddoddZ+%L$(Wt`4HvAOhnv8gHOqHLY3 zz-mz!GsVV0gNS}qv!&wzTt`q97p60gCBq!=+C*GfrmSt6qy>i7nEuQth71hI1LmvG z?3~bf>w?(%ltX^3;4K~87vL(YhIlA!Bfr=B#B%3bL1Dpw-e%fduUXifOa6&x{l{-q z=}S+eKUVB)^G;ObzfL~6@Hq8zTaaSgI}cqry7a|cXDF0JnAWg7^klH{vJorQ^B_wk zE=b`S{Y9$qjF8+0b2I&05}z3@}xJh`cA!2M4ARtMr?%~5v*BZ^rzV+1t*Rw}sVpft^?+#?1X zZOa-c81k#hva_Ehc2}LiaMrQ$$422{S>Mt>Iw;zD?yy4_5BvI!2Z^3U-YP{T1(M;} zB%`suPFi3v5QARFBTb!@fqOh~^W0~+c8?(^5BbrMokEz?5wMl>a<%5rO3`^gw&wZO zbA->o<@4_5d2|-9nwlD4>XzQg8gK0XkoNXQQ>XJPTB9znm7oi=ToZhs$Chty{b>3W zY_L?={p-tlDs@F#bU|8?GufTbmv-Y@5Qk$)G>&IZ0F7C9^7eV)(0TFaK!&!t&EBpZa{n2dua&#RDoj}&w z2(~V!1@TN=31)6>{mnBZFpSqZs`H>t?O-){P0AKAvOzC^AYTe&zF1eO~ zPG4}tCA{>grNwyA;2l~QJx0D9hKF1d5G&vJ==2F~K?|m>tv{{ZcF~$%UbZJ@NV$=anK=4zp9Dc zw0&d$ETqNA-P3dA>Wc8-3f;=OaN+Yi`0lOm_7Xy*e_vrnsN>;SL^qT0YtZIW6K829 zT3`>)pr(=2!V$;qX~hkn^H{y_yGVQhNn)G9Xu7iM_Svt`#itL*Tbb9>yLD%XP*8=2 zp96%L;Hk%d0&6qXbBEZB*J|?j7S^Unz^8vtiM{-_6|uRAXU7^}g8y`OdH&2?G<<6Y zco(*>4(5AteziXIBPMdx6#+9pyN->}jb+G!sY!my=JRv*(*|Vy^}+OzsF|>jj}N)p z+bn#tKF#e*L$oNKyWdR{X7)>f5q@p6k@#FWY|tTS{dh$0I#LXx{mVJ@saDtOht2F~ z5LTeUvo~kDdyPVTGmUSg=6ZX5{^@W(sdNF1RIm_k z+iz|?=Wt%V(CgBy|E~VT=F{2?v6n3)1A17e7F+3g-R-JhhC_dkm@%_pde zDGI3#-{D1Wo%+D82u9hCZn0}bc>Pdo&Ob|6BF4T*NAW%}=YE#c+OiwFTe!Gfuxi*E zs}L|YZLKdHeR|(H5oqus2mjRw`)m zCA8Q#H-#XB;v@o^r7Kd)UVrLeEo0Fm6=WQZPCSyiVX4VCc?|(KE3Se!cEE1J*Ee8$ z_nQ6l%=8WZ%frhZF?{ZFW;D}>(%x_gr7Sb8k+2+|fJPbiD=QyFnwmtBJB4SE_3c(C zES#wJ1H@v=UU;6s&6>p&nOeojj$VwQi_E~e%y^@KowqKBTeo!CponI2aQc;1sdWEd zbcbX5+DVL#0sJb)~~^NG-Su*S3&Gc7Mp z;+Cg;euJbzGaC=MCCbi7l>@ipV_rs7@J9$|{{xD|L?tXj;HS&4mIY0cUn^C&C7mxK zY2eX#Y&HLB#Lq&%LJ83%sqT`|c}}zDuU9ba&U->Vf%N)Rx7T_{5lybEGjoJy9ghkM z7{mI2D(Ck4h;@tW^mvS{k(f-g$%6ciCZ@ep^tOpQqsoyz%fQZYXrqyqjt7&-)~{6) zck!$##kx@-`Y2Z&h*p^0A#`1Bw?l&rl)N6e$Z$9OPBhWC8!F8@^Q~vbR5)rY$vx|P zzsBCEv(ikX_Bh@*1OO_Hj1(z$&n+j9d@A6Y)+{Wm*tCKuU);i#{GNRxw=|;PaXyfo zwBPR4cZ13nq)!jA{cAOu`hb(Ch`y8hND}#amD3VluXE?wJ;GFJ;`3>aqRW31j=FPA ze19*?nZ6~N78fcI;+IX*p9G4xuiAfW;3(j%q@~A%!Yw;Uf?(_ahg60imHjz>Y;l8y zmX=r3eP@1KyKWTiB%CM~3R+MuhSxX}9N2d0z*;`=RTWjpNuB5SOpvDXR|s$DL9+P9 z=Qsn(QfNN2uO&y5Wo6XpZYjq#qJMBIE@QlnHm{&*Pg7Lb`R)BgdJy*JM=DX9Ty_RS z-yPe#<;J7$awA(?6p=l7lbT}b=^~^EeOrxRvF)Ydu;R_*rPo2XKxV>##A6aU;o8%# zzj)gnAp@C*SHSaQ@AE0`T;r$4AO7Bnc%nAbGt%Bi2PI*}lnTk^r-<4!Vd&=K5h#f~Txm|QQF5-O(jy00L< z<@UYpz}T1##3r%*$4&Q`zju!lgoOsN8KU7)EBejC3RCt!TKg|?+eAekfeVUJ7);?( z`4KjJKayS+6XAy@DbV>Y5I8uF+f$reNL&nHsQjQ!>n*QB%Zz{GnVJLASf1iLA6h%N z9D;Tu)pG8(I-f8Q4i=v7LwC!(6Byiq13NqMDoYzF0J&v!D_A!z#Wohs8LSC5H%`J+ zP9Au8L?Zh^tfn)6>z5~SLoZQ=gOauDaf4n!Vco~WL5{6?8}N9UQSuaW>(wiN>wTlp zwCMIygW$ttGYvxzd>3wppbK_0m{c6Ot#AgwLMwfJ7_g#~3GxL0e)mLo2lQC!gej;m zt2lF?u_YuGZ}_)kL%06~@ZOZSl>TiCzQgPZo+MW0KIspg`LbJeM=Uey=^c}}f`Wx# z&`ZnLU{i-%ouR?S&fE2ZRnaH@?8`RHcK2I#rdQqVjSvDaNEBD=OA^lWp-Wmh2R*mu zXXl=sS;BM?=_P&uy8$xDmO?#8_;Z#%RXaPh^3RdLT8hgZ?Ip`(hB2lXVfTjKJmB}* zP#O_>(UQ<0Kgn^2tBcB|{?H3zG#k|H>egH*F>c5v*a<}lH{Y&dRa2*lPlfiaBA)jQ zm+I(D=oFz)gTB$s9RGZJ2*Gg%0!?CG`5U#4T-t36ZGU_&miYgp>8!${{Q55Z7eu-{ z1nG{ULApBzW@w~_lny}=L}`YY0fvz7M!G?|y97j~1*E&b=RNq&IhgBW?`QvFt$P`A zbXa!;jUTwKANy>cIEB>jC&sdz=1r`};A9ukh#_K=+EZhxF6T#F6+_p0b@ik7W39giG8%r=Q|a5 zf~K&F1RheFKR}LH&?^IA_1*mmX2VhBRP!=H8Dz=J-*XpYGg1hi)de&wIJMY$4QY*n zwc?}yY~92#g78Rpg6#gX4*+pFVF^qSi<(uplCKo5r0Sd~s!{{K8LOLNEq(a#53Udj z&JK>Uf0LP5?bpT>Z-{tU`M%T0|13_$l0p5>*Z5{RK-tpqCKSDKrD``l`p*4Lz^$LI z0qt@bDs>&k7vdk+>eSNNnd`LpkAR&dy7(c=;3;jAA$T)T^5kID;jlAk`|hY~M~oq; z|6raK!korO+4ge&UnF+Lesg=!7bc-`1b=q$pZXMB$9FCEZ5G6{ApvPooTtavYC36v zn+sZA`Q6oa-KMU{)u`mJf1vm=a6#_IoPE1fs^0+H*hlo>`>U>*s)g(4%T(K}0uzGK zwaY^VGHe+&J}c?t_7;2za5lsS{EgJ$19NdN>GY&Ax=OF}yw?YB?ItAFhJ#Wk_;a#z zdUUIwO}!Moo<>betIet}UWY$)^JB~@J z7`v}_3^@Ni^`f6Wo$XV0m;)a^{sNxX^RhB!M1ADD&4A%%o?1AAYKRifviZ*rPBs#S zmzfUQW9YqD+7{DQeXk4`@9(YYrO#@ISjkC8Nxq4KpwW%w4uLwjjP~^t!rFX)->1nJ z@6-<}05Rq%HJS3e@GEciR)aaHeQC^_Dd$`-1un~x3@~je8F#XyGlm5ck>y|BuWRsO z+oYt^R6RB2mwm-jZJYm~l&)G;lzD5ih@o4Iex_lmUHW_A*+%br(#C8pKQ>X|o%r*t!>(FR!pHX=0M`a+ z2sk;xw=K*fVW%3=p)dqq)J9g#kwhlp&)>gme#_1fvg=nWO-2wNEmau_L;8U%&zt)b zq3o`pHJf+CUyZ7NSXRh!*Df>{*f79AX^XBnoz!$G{ANnG z!G(LK)yeW_c<>yomZ{7BIVIz=wG=d9&Bbn6Xu_1$ug8(kdBnVPHYBdYzpAdGa3hlm zXvRYP=0{E?Im10shw@H_T2^>1KBQ$+oUy(f3)gwB~CS_b)< zlZoxrHLzvxQXXc6oXm+X@>Bma_;awb_>XTPL-#|^y2(MKA*5IMgO_N1`O7NQJ(IyZ zx;uoE$%XrDq`QKm0&TgOwq?LH(h^8I*DMBQG1!mgE!C9v_NOf+o z27D(ZU;*wO{;xD$Z8l^y+%x+8%eR#xPYO<7Im3^V;3aZEYQiWpP1qw|zT!JfR>r8C zp~IZrHR9&@fsw0`jEP2Ge2e7;#E5AD@*>~rBLiRr5Em$O4sJXST5KyDJ&`T@P5)lm2@qVva-E=n3S@62 z#|MpEk87=>8%mMSlLK1NUuuQRYe1WRTFJh4^ew8wEs2k0v(4ms&B|Irkgo9Eo$wj5I%G8?FPV^ zx}Yt#{__y==IrX}=IG|(DCo;{+PM9=eTU6C!kthTSd{|p(D}xgFGYylm=F*>6cK?5 z4qxq$12#~nQI9@FWoBG1)cSN;ms+!0TUpfh`Qm+F!;8qNYrw77V6-6Y0=n->u;K@a z{&R^Wz5z8neIk}$8=6WN!jlXgPANln_fN#W#1xil+@?BtL%PDsK_&m#~$w(ac=vT+q2xOYOYrs5Gq z&$(?42kjTvo#pRC3$VHqN>jJPdi4$SB4)oA^Iti-wlx2!F|nu(rb*o%)0GX}26jS2 zYaRt=zFOXP4ZpnZ_Fn4he(1cfej2Akl2HzjB(fyFIC{fDT7~R5705E#jtZb3R<~)` z3E)d5w{Czylp!sY|G^@WKz59SO+^T_-NDp*A}aUVHcLBsVwHIs}^{I29~mMV_21vMB3kbhkY55vfd+ZJBDEnY|{x9x_oCo=?vu*0?m`S)P9-=n43(RjS>pmk#&@ zXl~D~L$FEW78llqPx;y>j2OoakEGx+s~eJ(2KICF~12 zM^vrV5$Ur+@=4ADq=iAn2Z=6tK;7H^8i+E7{VdhlWd2&kkfY$%QKZ7xs(k_%F5s>x z=_T>Wu%q0GoMtNX2KYJBJmgyX}04b{#jsN=}WQdUniHn)i=GsSRh*_ z2=&{A;F|Sxw)pkH^x5vd7;wS>i5dVe1vv74AG(EO>VqVuyu|;hvobc7Irsc?T7I!O z2UDfPwgaC(=Pylql@GP`(eG8?$!)MPVLLqPBDS##7EijyR>nJBc3|Q(%0WKIgQ7hD zNo4Buw;3ij{QIY%BW@%Vj}8R00h*0(zbbC-Z|X8?&c*~VoY~b|Tvv#MV4m5fAw<*F9Po2J?KmL+xAKXL+*Xvy8;jzl>s3I@#>w zF#m2C6ofwFEJ{fm^zh(*ec;}eZ&t0xm1v-}5?#USGzZ0}dDcZ^RI^-RQn~0QPSNZ* z5k-Zzv+=C*73cMwFA$9$HQpb0afuAoOCIF(+LQK$l@^71C)6?PgC+#Dq;V#N>5Z#_ z!qe^gcw5@kh-&43yZY=+YVnI;rhJJ@>8m?w-9cuCpo@@7sMNpgYrkOry*Z-eARxo2 z)lGSej;IvK6MET=X+snS!Fpspy>1bT1c4VJ)bTr~S{nYQSn|<2`EMj&9c7PK%xM3} z!#cBM%3&pju(3%LgU8e;bXGL*`fdWZ*G{sMUMcM=)Qi}_MQt(+72Wd!uPRws&hEMc47j-D#77uU_%BQym3`Ga*wPFS7iBqKy!>MzcVRf__?o5ts| zZ+);)D=7e^-Sw`c0&2hRf%)&Dv*);Jsee&`l9@VX1&+9xN9Qp#+fHfQYq&>53E}2viu||(n9MhBVFmta7B5 zdQ?z^?+or_ou{0nhlUo1s zc!Ef@l#LVMABJt!k-_k~xC%Qmgvd47^U*A(C>EkOti(F%x9_xIjLCaU*LhV5VxrsT z0~}WHdzo^x4A)T(d8T*6OvaxK1zs_o)i>t5Vw8d=>5=UecMkxABj9WszxqvAu3zmJ zc_)Pg>Oi_LRLA!UP!cZaqR9Syx+j%#oBPXhmAt}1&Z%tHa#p3%i3X9Go`^6{sl?gO zP)oElxcrtH0d99Z&)F-FaTcixDyfKG=`-;^JJ|a?i~E{nr`F>1gtaclY`{B3qY9W+ zOEP$}#P*Z_VS~A{@KQhinFEYX43FQxTCX3hh?)QHw57vb7p$|W1Tp|qDJw*KLSxd} zS(5yI0`#q;$5~mcf6*IjW8hjS)FQ0ZSqkY<(jYz}Bq(S)?|aipI^wuXP^(tEG0I9D zldjngAqzKBK^U<0b96!T8XFu#rZqO;EFi9ewz&!G3Rc)~rC4K+}`g8}x3*3QnN(iL#Y@Rdt_V!#c_w+$^QW>QFIOHSEKt^$Rpg}I5`T%VToGDOvl z7xSwhFw4|pljtzyvqV6$($6vJ#=5ayvhK3e`u|!0!39Y`eMH%YKj8#E<~VELAI7kE z!e;Ee53c-#wQS;-k`j1*9HJ}xFyz_gfZciD?y-kiM$~Qmc$>l?o}p6JDRcaIcjP3R zV)Jr}AgTXuOgKY**rUc`ql_FohH%Oce}m-uKB9}L2N;0!VLpLnW~q}Bo~1YDTU1L> zCTym-znNaPa_;TlqHu-vEuos-j--42*^03=B%x8ODA1$Op3IK|+`T#k)DNtx6g$G!caH%dZ zCAy?X7rE)HjLJLWjZne8LzC3xBGUp8Qpeu>0^hBv#OZZd`At=@wP$Nr4h0&SZq!C* zYQ{#f3Zuc_NytVY#~ym0<>NsNX6x}6S_MfEExX>Zvig2hq1#0CUvdKu5~%Gc&znRD zQ)n0!h5-`H1k;{%1G=vOiI_H;SVBbaiPCIUb8G9??dgk3-YN=P$1!3C<`}|SBAr|w zG*z9Q5T{gQ3f(O{R}0OH*s!;rMfN6WoOhp>bqoGFxhTek3+R@x;AFie@us5=|M<*3 zYgmKsFfltVJR}2c|02D7RY!?@At!cw?J)#Uq4ouJsX84qdWzFyU|09;8%m#*)UvUS z(=ibess>%32YX-iIy{cb-lH3(q}Y@gM$eWNdxg{W5waXlg?f`OJ61SdKeqj@+w;o+ ztWYUJ0IGN-YU6|>58c(Sow#t>8={Pb2(Z)}Ak%PN_m^Dz`2FwBJ;RBDI$zWje%~ES ziYC{nSD}c6yw!g zQ<9DlHQv!kNF&2+^rFgtg;`(6l&h%ql^Q!c#$?V#k{eXOwE4Hl!rNfz_tQX^7rhFJ z-aLNH)p>3TBE1q@9dxZ!PcBx?*the&BT|9Psw@S|w(@29cwCV9tS+KP)+6|x?gRp| zVik+ZC{3asz=jD@QW}|CyqWdk4uAaY{_YI`7YTi3hqght`kvR>s9@@KRvbz1Pf-@T z5yXgEZB>7aO(nc2%U0M6YLmr>irLYV+~IL$e>uA5LG+jdLh9{0n`aJ9n&6Y6DGKv* zzo^9Dkjk(3iBfElQyjqX97m4-@ze#(|lhh`nzqc+NP4 zPGif5>#nc){D>NJ7pn|-rZSt`V&RxW>vR_FgA&SHN?c;PQJzwQlWFtsapi(9>Ee;@ z(&y;DkXd1x{r~8kZ2y|Gw`>o5yH2x4wjUIgP7Sm>4jdgGMl#m^dh36&M=sVRChW`3 zw;y0bgQ;)o!|Phd$ujeughh3LBEZ_>`G0i``pZ__yi1@$+>xz6%1#O-Q`x@X`^BV*mLc6%GXSZ!JNt0Lz7wN)jo zZs~tY@DxC`e=?Z;gW)oP6eTNKse6G6Q{XBLu{YFZNFKX6l{qYb1Oj3Wf2le(l zk3XbfRzTZZTVPq6pM!K*L?)2a;w#5%57lAGg#`v~uc9&6h<);CH|}3D?)tx zMpEcfpR8D!qF?GqP$~Fgm=#CUj)onzD-kW9!to+Vlq)H29x;N099D!3%9LhLV4Q2 zXa#AyhW=vae>KN&5Iq=z%eg%N9tWPyji#;9hE}C88)P$*`PnRF79$h^)x}{}f{<&|`Zh$d&eXsX3%ZXR zZoU1u%MDUWhqAF1d2O=zT+L455@V{1CZAa6xxHTaiaS>)wK^)SXnD_avY?N*z)zZp zH(O7nXhpXb5IAtj9z>tJoe_O+q0$IqD^eeruF*mdx3)SFvMc#&D%cQR(d=Zl+}dqo z2E`_oc@C)b#=jc9T~KhLznzW2-$=Q=h4H6YMVc;e{^4v|(<^&`gBt$HBAH(F3;WyL zd_(6CQG{6FVpB~m)jGdkD97Dv(GZyHO@K@eEnEEPMm{4nNo3u$D16^BFlS@AIGmr1o{fycrG59JN%gci2YE5K9 zno*)a`v6#%LiR`Zd)i47bD^esdj~W|M4Z1n8^&gb#Lu;YiU^`&6Sp>-dFZk)$DX0# z7&PGZeqZyPoQr?EB0}k^dai%3HX;zO$tZpwXgt7D?ZRN#uJjgVUmo+0$FC(>gp#yn@y?I13BZjL}#$n$!9@s4=&h zUSP!xq0ZWqsNW-Mx%B@HdqEL(sq1^oGc++ZIu!k^EaMSru+phU@v}sx7bjt166-s1 z0x*{1>|~D__$G_9aN#CefXwA)En-yr+VS%*PhV}Q$($y!j~^_9IV^wdE;|gL6;$WL zHOVZeOo50IB*IvBdaJnTS~DMA!DZf2R>y;rSQgX_YFaqF%PO|BeB8v6GKmh_IZ96M1qfVKfd|m+W!uAVZn*K9ut1Hx4ZI zEL_`IwLd!;hQroQG;q+hGLul>2TG05@KjSxFrd3bn~TC9BPKJr!+VcerIfha4* znW{pbq)_my6uxvyV>SD#Wp0l=<;a8MxE8s*O!o3g9w-gPA?0zX6@hm~h}T+HHvjP9 z30fO%`mjv|g7hAG4fgkwYq!}GAf)(N$AuETWagutxfH_I6RtXNmKM{P|6whe(@X1Ah{|j%E~IAYNBjMk4d5@J27sw))NpE3tmTx&bl}J|c;ypkBqreyW|Vxh6oW!0|~fHg4TD z8g}03Km5~k0qI4Np|P6*4*wgLa8LKIAW1DE%$YyNyKwVcT!3|&ebhT+iU2lv(IL>( z`7vEtP)z>N<;jdt89uB{;8)cQ> z!{@XE_i(UMmVuOai{3mZSulpzT>o8?m6C^>S2X1~>xuMIQSXe+Z($t$?%LSfCV}BU z9mzfk$=;tc?*zoN3t{Y@R=JZdRMzwh&~!Nb{ji%ehm&MC-t4Wag|IfKiXa_)Nc^WJ zr_#4zqi9dnrJ#O-r;gNZtAcfOd?$-r3`hms?FFu;RaLJmd`rwh6Eo_<7O~K1>%Y_k zVH>$SC%Z%KJcho?9LyK}?5Kp&z35a7(X_f(l_cSfE++1LN(CFmDHEFxpQGBhH8|B} zScy}@cCL{-7P(~gf*R#qpm5C|SH89IxFR=4XY~&A>c#b3YE@389;^Cw%FX}ON5#eH zJKk@uUxT}cGED8~sr@HFMka{QDFp*$HBgQbYaP5!hcq+^>LjoF@$f$|PSMybG9eai zJi#N&Y5;V{{ukfKU@5%JImSrdmRnw534Fr+{o>**Qh{K!6{+#}CeNdhcMcW-T8}0V zk$=uSFtBl=XK37bZ{ArFdm6JTP}t|pn`C97X=Bb6glPn8_3IZuKkpp^`(X~GQhu=< zA>QX{a4Fr7E1N$aN6M{aonsIvlnhw5M*}P3@T3v#plSe(%42?=!gT z&x3hJb8(Ab<>aYBIjxlE9o}d%UC)h5mAEXnc`tGeTa(IIs(-n-xH#wAPa@}}y6WoG znpHv%C$!%bUo>=b zi}h9gP+AY}J;Hgqq+9J+D0?=JXgyhgXvqJ8hnv zAUtU#E^wEtj=M?n?6b(D1i{Q+GB1rklMw(S?I1F>0?`?en$dxAC2Q^s=9>Xqt9pUS z#+6tf>u#Y~!6Mfc3NB@M8WjtgsSR1Ekt5uHEQ>$S!Koco`{a^Nu~RTry%^V8WjSHF zPp7?7%YzFjTmh;VIN<2f{)C^C2k&g?#)SHu0R^lT>!B)K&{4iA$yfuh6Pmb#$!CWQ zcHk2WlPJUk+S&k9su#QA3dd+CLa3tBr`{v69J_E{^3LNFNcTH&cC7Q((p_j}U@(S# zssSHv>zH_!MCORv#*!h_XJf$8>vWUujeXLj{e%P07d0XaYHbJy3XKF0(Hyy^`oTc2TcmO5l+D(TgX6j4-pk~-{3N@ia0rb?jSr68e`Q_rV zq}m4FQuMo%(gRfCOQdzy*a8#8Vwn2h?lE6>)P)xg#n*}brCX|^5#6T%aQ@r%M5LGMmJ&fo1$jE0Q{Jq|A5-Bx!B)QG zISKb1Xa=oO4 z@KwPi(akd|hDs{QEYsj&XYFW2=aKSoD)algJg*`paSku880*5mqcEnyo?BXWnc({| zAfwCpo@Ya<{JG-XT!k3zUL)Jq*gs0Ik#*4~5#R^4t2rcXfhkOGKYOM-VQ1(_Gsu3l zp|eN*x9>OFdjfZbwl7(DUEK1PIj1Sun6lkk18*OZ(5xV_w-R-~)P+_f+p-osJwU?{ zR7c-5*U%dQuOr_dNA<3irlO0K;@75_Qs^Zsq1te4l|-B^!pd=Wh@-AbOphv!c!b}-7mcY?zY2A>rF@;nQNh56n%26{HfD4U41Fj@zde`gdD8XeXje* zGJ>%Vz*Y>m0lo~U!ty!mq#l zt7hX@f-ZPQTpgVG;d2eDG4XH`LQ~FIKD3Uxt(-x(U@ZTIDrQ0hDZaDw_LZi^>l-=t zu+AVLRXYcsIvja zW4^o+ng#N4^vTSdua3OuSdve?DMtL%y`-}zGA5->sh8(zHa1NRH27fq^-4NqeNW?75;1uwL?vIo0B_ZU!zV9=BCJtC@8ICU?5BH5L6R@8{w!(DHkez!sp)8zGh@E{ z4qV^HO~0_|I2ggTQ#a<5Am_3C5bd(0KwS0j&XaSW&6QPV6$l{AO)e1zq)Q2Fy1_Rg z!8cb?PJ2Kg>m9IWWiE*XW4{SlZe+dNoJQTyP^=z&As(}}0u%{V|J*~n8~kWRDVwBZekLM&p)U0Y9;P)j3bg9e zLi`D}{izhyB)+rO=Kb$^!!`Fq-(^pDU2Q6Fsf!vt~j}ql>u-tJUu=2qZ0(Sh+;=w5$6pPo z6y(;OuE^ zZbWB&+uhh1mbtZn;`-0Zs@UZqDPcS?0heODOC%49 zf+xa<#rE+5a8&kgL?_Q=;VXPbIgM*r-u}Y9Wc1A5$y(gJ^8-_$8s|C}b&AaE^WuQq zsudt+>dG1UPjb>H8+P?;cf`*(|Jf84X(eS2(sH~;>XvS zjJ?;%Z-}SzUD+1~J#3IU>zu@OR4{H1ed%m#GC>k^_>mnnr6Cwx&u6@1Q0AIPq6}Av z|27a6?fbVHjlhLhh1QGfyiFcwt2e94yJArxmSGUFxG2r(V2+O3PV)E_Q+vk!@#FmH zRxf`rF*Mct=Rdbil?!tT%YhN}yVKK=M-RC)QFrqwF_mWxFO3Hu5J;8vS|W30kRAz7 z4Y<6xt7Yx+AeKj^fx}^9hjiy;jBcG=pqb{yKYLcfng#!_rRst-s9hz~xB?E_Mny-@ z(oRMFzk&U2abGQTf6s9)j4(pI>}b$O1J@lfZX0-TBOXF}Pv(yINr?Y+6d!#!bYl%T z+6MC4$RtcGI|CU*!<@1JD5Te)?Qp363tLv@lgrCEK#b<|GLkDl*@~m$L~A1iCX)-v z+y1@=_#6}R$DAadEuD%mj1aRcUPFSkqGG`^sTEz)92pi!)X(5t`=P7uxyQG5^u`&n8e0rlksQ>?Wu1_x3By zkcA2cjkjP~m_AbO-Z(^b8EQADtt_woyd59JzKHq2zDPEKgYf>a+>7<-ma=GioL zLr^L8%j~xM>~Q7X{bkb;&_Mv^PE0qq|JC3M=KhbT)JMF4ob&!n_JP^`SG#rHFEkX4 z;D1b6Ku^~d5Fl;dp&apmUC6uaub1vL{L_c_S68rNp@$>`pxBuUDA*qJf@2Y##pTi- zFLU7hJJkj=7eR@Q?^-@HEMb{=ewi;qvThGc=kl#%_&cH@xhCT+zns=+je(X z?Z*%ZT#KFT$3PLR%(&N4dle~AEw{z98$cg{V$HmQ7b`{Y*k6yh9%e={T62hJ4y_H{ zKtN{l`?M}t8~9G0iH1!@PXyMC{d2EEPrv&vfX-h+OtxW+VM3$k*w$>tq3`mVBN>~} z1&Jt1k)@|c1!v#REog-{XH2!#!EnaLUM7*ny5sP6Z^z8d_4m>Ox~k!wJAthm{y)|_ zb^;~!HEc}nw>?<~-y5HGYzcvAXKtg~Q!OFLZ{0rmd5VzK$> zMsQ>S)8E^q%}j>8`wBZ))ijTK9j+l@uQ-Y2Imv@xvKZ}#N9nOrDAHnFZ=K<6(;+cd6MAU=K6OMS~7UaJ!YL5vuSE~J}_$>22*Th+G(PVK6>+3qr zxlX$MFZn%`mB_TlY{lHX96nFo-yeCmfBNgL>SLo_9z6;pEN{QV++RXShZ!)y_1>tx zI}W7+^p0AIKd_U)*XGm9YZg!QhhM78DLzmv7uST(o*w|c-llk%U)G;4bPe8mcr6g~A&}~}wvci)fVM=gyb%CxcFK5Q??Xx3R zc9w#3ZqhQ||$p^pr=xwUL(4Zxo%&+4r~VYgW~fozHebEUE;8ST@Bi&voH? zZGwg*87092ffelk8jbH0>qi2P2&Le~(Yu#S8|_$pg8|Ok_|FWYB!)O<0+K*|837+x zo6@}VhZ=4ABx2@oN4#oPu*=%%?*Cs45Y9S`@hiZ(e7-%w>__q}GPT5oMf-y0Uqc2Y z@r9ASa+`n>mwCCl-+GpxPl90M27h z_x>-Z@*BukCNh^M+8lU~AM(x9_A2e+k^A-PQ4nz6gV#4EWzS{-650lT7uJ_OACi8s z&@zN9isw3!C9=S@kQ-guL5W=4cyjiguFuE#i!5WlZd(Lk2ryBi0O+oR(h?JTf@RPX zySMJw+XrGm2u$!sQ`g;A9YEvIj23V#!v>Ht!rnXOq8ZZvw0Zi6>xiY1cMZk56^R$go3-n=CJO^bPO zLq2kVSJ^-=m3$e4H6J9w?m|wU4N{S$z&I1Og#*>;pG@1}1WrUG0w6sXDk%?BHO4v_ z%xKweetY8AP_{&s_D6FeagBP@gwmTMJA<(0?Q1!$W1Sq`TU?)kv2v^$>GN5o)x^}L)L_@0J^R2$uK%}&C0nX4^xU#kh1eg3D}H7 zfAX(AT%;?GH0Gb9GxDZY?q1MavyRNW$a(aTqu%@|vVkOTXwYS&Qy)ihF;|o}yt6m$ zb5-d_(WK2X$DtP$xi3eO&6D7n&IrDO&2Xtn%C>N|P|cpXpFhl#(@6`oIwIxsavLX= z`N->?$?S4J?wFfKT$Fd?7j7{*rXYEhbK)gye^r>czx%l=0~k~K4pyZtx}LeN^cUuE ze&YMh4rAQh-EL)2rB0LUre)S(EyoC%@#EEaqhdFs6_u^*arg+>gaO{c!=o6T#5Sne}cX=&;>=H1cKvGxqC$PXVk`d^yR5Qjo z(6WKyQLy;*h4j<$9mDmTr?aQ^cz{*h)`n?QWmER^ZNS;}kYCdppfi&Se(VFXNCr%j zpbt};Oj{|F02OmmDj3;}aq@-b*T=KCySooT*K6?AU2&lW=)Mv zn$(`Ovw%q{T(dD}#T~k@7vKHbUzzzbi@)HAyqM$h8f^AoGZ9I1{Qd5_DiI;~dkx+>(7%l=bp=(H@uba4OkZUE zBJ>xM6Zu4(togbmy3EmF>bbLp#|t+xl!e&0)e2)1-jo>qBwRbic;lze~n75S<(#t2#3zYk4q6wc76Yb(RC(5sD_0qQC?N8;HeX4iJ%HW zBnu`tqz|p|V|alrWti?rSI-NBiA@q}T8_GXBdLle0OalU?rNy*>i609?#r(is37CD zHu}Q0fj#6;s(lNC;0CQMu7siJu_bT3K9(_l+xilMa&w&4BY|ZN0ps4kw5*)@ROp62 zm3US83=41FjsgI%UBS1=h{6$!vWDEoyy}9U{?qJd@Eo_K=^P9@&Y+L|ti&}G*z5)k zHnF+eBZGvpXFCA&IQVh2>xBR5l>h!3Sa-AmzoHao%IO6#P&pWnAH*Vlco0HIrKX>Bs+!_?X^As(oZHqXBi;fE--E&#G|71 zp$cFhP>I@1!6k6)kUR(}s7k|xZj*-Ep~my= zLfZ?cWc_Lp;so>ZjQ+$F8gk}fY1UICl|zR|Qi?oi)KF}xo{QpQlPDh#!W%vVGYlcY z=`?HTMi(7Co|4e(ZR74kb*6* zylWtX_JW`od3KzYtRCfke^@4zqlRR!FHmN9t)zbt9cKrB-#Yd}P!eQ{dTdBi(YJ_H zCwPD4`nm+XZzGvY#PMZ;eij8+#$Ge|s<0RW2`dwd**DHZYp^!1{>xDi@IQRdIP=bI zlsIOIhK%DvooVIqFCd*Z9gRWeqZ83M5LNnsYBMwWm#I^{{S5i{d8JFfoF?{mhm=~O zf`qDbO%mDAumW+ZCvONH8wwVhKCQi`ggP0NicccpWVLp-7Ew!99`1t`DJk=s6!hy4 zVUiG~V0&*BFmt+Sm~be2slx@SHar%r)6)c5^&dhrmgV1YK!{`RKaQ9T5r`YkJ094* zP48F!tq@W|=^!n*&IOsitT>fP(%{5Nazd+77z&&4y`GpRqzzp3emedxdw(2%e|aT) ze10CcI__#fIGi0LxXI(=Vy%rWZ65v(Vt@4c`o;66B!i^vO0p>Ji6|tgN{9<+-f^{6 zn6u}6>ta(>CckmI0AXP!E5{rAiZAQii|^~VJzwWqN>tFNqMe`5zrh%qZ&fleii$El z{ZhYx_cg2dO80(N_9;a6el7lfS2uWFDh|Ltx&vkT5EVg0ekg`0i>@+!bjP#Lv3H|) z1M-a32RJCVDP5;GXATN@J`Gto*g@B7toeJmgCL(NH>`= z!JhMNmB5fC`>((F%sW*#_oHuB?gJ{IMlSR(M~sw~g#3Zm*SK=|95D_U`9Bcyn#2+M zc>5vNTU!r&wb=;i!=FreWUEs#YfT>;19v!~fU`hAA1vqcp9^G^)_LYb=waOFXbL$u z6t=coNkR3+1%y8Z=-(q6%_qURgWoZPc+a}SzfF35$5}AP##N`SuQ^?F|Cg7F%ZmM^ zR?F&`&sjxaw`+OcK$35mi^*=6R#m8>2k{_pEe-cN6YfLZJzIxYH;`x~zs2AGreVRo zlS-=Tq#o*Om+xrR^+K=RE==43dn2@FJ-9}P0I%@5t?VSJW~#F5CSKvl%yRt$q9<3N zS%vnSsIgw=A($cYYu=4Kb&!2+Y>qkqgKfjF$jS323&fm+E5W!-pnu{b73|LgO<8agI z9X3BVf2VXAKE3J*i2yHK`>QMB{Y6H76{+g4vh;YkJ>v6=wtKf1uEA+i``rZr3!ES> zgEMFP9!OK}l|y-5o^NVFTMta_k_;0REzE*Ny6hc2@rH7jBrRv@Zd#zuT#Gt?^Qg)- zqG@+tH;Re12l)5)ZqSOlU{ADmv~8`5{q}r14i92Av@I-HUR(wf>uOdBrt^|d@uq5q zfRW*4N&iZ`P+uNwS|Rmns~mIn?Ou(VqjCQViu>aMru@d6VK$CF-;v8fLMZ z&$Xk=SbOs7do?8`K!$IMaQD0zDZZO}5qp=NWPP3g?$!kR;61o8`#R`$MYk^_O;IVW zanSi!wNtt{-5XYVCS0XPhR}v$XBfSMWfm*fU7!rEyqq#0XD*q33XN?Pqu09+ntbV# zZ!ED(*8}-8opt6W!_It=Io;qPkQWX6wv(L!PTR_B>h<*xhhX@`tchr>Nu*^8Gd9>l8 zSx0i1)lPv5fGrC>2sGBjz}ngz8d|yuU0SVU4p=nT*B*6P%0M3J>=TLq78G!Ut|Pj+k)gc-jP9T; zt(L^{;u)Q?sZ2d5aDSs&G^LZ%p_1;(hJ6L;DgiW-YMCtS`peewW9&)i6Ia|dUeD+| z6$YzCuNyOQ?L_#Jf`X`(>LDQoCN zAaVU7la*Y)F)GNoWCjwPBtfHHp&QBgk?UJvI%(^~>0ei#<|nLxE&|Lzbutz$ig08! z=dmpDM9xgJ^ZUj%i#v76ICZS?wei^86SmfxbtfaIeidstJ$I0Ox{)^VOkLQxL%&VO zOFht|gaYtg`pI=;N31T`!~UCScLhI0n|(_fi+lel3PknP=>(d4)X zz1ZFTKw?{_4K0gITlP`be7%m1XO9`=OPp^pEbTs!X=IYa-L z9^V=E)Jv3@TM$R+!(D)y^TnD%IyyMi*s*2;BetC@%p)0ZTwWhLc$|0Qd!BA&p#v*~ zfjA=w#BuwU%~Uv!K#wq^r`a6=%c~D-{3wiHpC_0|sq?crHkrIczP@j)j!7~w5Y`qt z?>%_b`_8!`N!`9#`cB}7SCYJlNtey9)!(mKwnlSAK)YmMkGK2EGg8U-uN$XvGD$`p z;K}Mb6xMXGNmrGgsHD7k_7E$)tE?usn-<7V-c zRj*&aUk9witbS>|hC+XJeeHaAoU;AoJG*7Pp@naJf(|vY`|=tuLPm*^Gp|N z95K$4n=C6ZjX5QH(*seYSMrq6P6?K87g%oSP;RS%ylpGdQB|EC+xM}4I_s%Z^_&1V z*lIcU+SC*97$%o|MeynAHOw-|)xNA_IFy;z6XoDHCO4kMWR?DBpyg%EIJ#qxCCqc| zjS~AGq0P)psj=>L!X-1ZEtZf7>0|Ts4+>3h6B{RAx=vvr{VS}dHd4;UW`6V>f<*%} zvBLq6As9j}7yUmFaO%xl26wgrb%1^cDU5_3|4)lrY=9u8zN4epOG1EUILN4SFPvnV zqBZdMk-b8)`dBwYuKgao`TGjILGXXo-3VGh6I*?;wN zVkV>>u!Oie>8T{kJ5+}L`UGyI#&5*L)7H5`T%AYwNL$ZcLSm<)GDt$-vdbe>^~v;f zr6Un`nrxem1ze(qOO^T|nugl2*U9k0LxYR#v5V-sK19oBAK>|hTRzS;fJ=E(%k$!|(N zHEz067d=YzGWHV<=jp1$%c$JLYL&aH!y0|7N}G;-*Y%-pdz=N)FtaW5?1af};aI2L z?B@24GA^)=`i!q#v>^3@4?n4QHm6B>;u#KihXrt`uYj{fjjrej2LBKq)Uz*xnl}>zF$$`7-^*Iu+aKu zEq+S6_0^ge;Z@Pjvk@b2;q?eDZMN=zp8_BI4$t`}$o`qZgH0DbK9f>Hl-7lUTA*Z^ zkre#a*5W1tQ@Sa}@0M8DjQCMZV!v`}HPB}AeT+|%+`m}@k-eP!URz*}=HZ94pS<+-fYD;MiIM{^OyPk69{YJyhCGod{ z1>d0jS^=8G-F2Q|c``3guzmOU23a;XG|?Si*=UHMu9Lgv{RL7P-D%BdS2x-Y`ts)bH? z?^y~v36)@Zd|}g1Dd1H{{^N>s>Ds*7Yw zx$+}Zgj_08Kwf;5am7iTNy#YDaB&112I$^5^71#9_Y5v3j z+1U7HYm zHiY)&y11lejDa|4CBZS&dwqY+VDCLb{H@`7neDW*kh4OAChe=W4idUNq(G& zW?efea3rS*)NSh|3u>fF;6fWQEJN&!u?3(Q)1cie!do^Ez3FrgH9nzMeJ{=n(@BTD z2m!vqC~xYf-q_A(?Ahlxxr2C=-BV)Wf<3RG%IyEmDWxbe10El4p zM4<1cepZ)UG*#PS3gBh{V8rLa2c%f*n!*Ag%b{Xi}T)TopD#{JeXl+kc6V!hReGAwld= zQLKE~7&aBLhE^e_#i0n!GNtYjO$PALj{C2!-xZ)ix~{KSB4|bD6o>qS0nyp6VE{`B zC9zDAfSh_hAHj%xNNrPG2UnDQuAckUe*e%g`8cWa63Mf+KlFR@J(tb)=cLOR%ee zjUwq78%zH3`Ph#qIX6I$wQD)x?>rCb$`(J*T{6Jp0V)31+)3xi1%iFRuw%REcWYcF zv&qAPEb3o!?3SvO3!|V}&zXrE)Mu6{xngh2zA&6WU@iOd<^(J3L^Nj1JN&1&ug-FY z(&+odkPIEbT<$k+z@1AhH7%T+>5j+NM>{D75!!lk zZCj@A_M9I^h$)(Ec=%rrecX5oJNbMrc6_q&-Be>JnBewo2b)$(>U{H@WAMDs&$j!e zOa_I{=#($Ebr?>0V87pW#EE(2B{ovns?k~3zN9wZoi6#sgtBv(8@0>2IKZKLeyc1k>Rxx=^BaAL8v&Dm|9XZwME5#4>X=^f4D z`OzR3{~EN|lg1Dl)ffxVE>Qgy`r4h$1<59IMNMYY)7UYKSe>5@FURWJ7;xPQjFSa_ zXXmE$*wcu_CF!~=rz9_{X0ZU3`%#&J?;ZC-P`3Nudj^gU@?&15&wDD*vTZvkn(L;Z z((?*vQ6Y~M!dR5<(A$d3Wu@dVUEP+;=yRnzC+;ZpZ_>*5_&6r{0MZpOAoHgD0Ae?A!!#Nn7DB2_UmL1f7G9{7q2D=|1m5DNSkPsV zip#<79$}u-h#(}>u;r{;qLAw#-}W*h5K+n~_1r|@l$l%y4fObt-CSi}`y4iRwIN4~ zHGl$t0&rukimDekKrxml+vZqzSGe0$Xp^zOHP8wsKV(H8fLXlOx-aeqJXH#*PU2poLqeOO#Y zeFg@|rj>_c{Vu^!!$q$@-a8pq|DDlolPR-dJLxszd}Sa(qT9x=aJDif@TLNJ3Eysk z`xdX@Y_sacsm?(Vf-}TbqQQE7kGw&NooC_`63v0Us^usOpU5x4Bn6R_Hhi%YAN^D5 z1XP|YnBF*68OraNsinN1vhU2-ECrx(u*g59J&s(S| zq(VtP=^!#H0SmV~q7OeUHR4AO(EdpGMV=VBcmtW2A1l<2Hu|y~G!DLLj@%(eN@##n z*Z2C0>m+A==A(p&N>QkOnQ}N$Dq=+2x|(TsnVm6x_qbDczcoTe^{@+jjGcT)Eo%L> z3h@Y;=!u&d@~acZ8|g20`Mm4zP0mZ_-rN)j1V}Yd$NwIJNt#xfMr#>+3l?g-JG2-5 zbF48*d=1NaZY=f|2+f3cJzNldlT@)KwED1Gy{g(xPFz4-jodkM2B5>Zz^&Zs`nqLI zA??dsRa*jSVN{8{fWWW*NrpAuR%@KgoPLKCe6sdpcF<&alEmbWO2K@h?5r2HkdV-y zZ#h2Ap8@3jW2kxHzsTOh|Mf=>CBbnlx}j=Pynb=)B>o*2zy(XPjq&r@I!(lLj%;kD zxoT$!3h`prb9Z(S@813M=&k22a`2l`O2SH}n0|RIF`+D~dFiNm$*GUDsQc9Qke#;(aT{W67&sX@&?y~Yk5x>)WvYdk)JNvcZ8=Ev>nF+0%&nsBdWK=W9G zFQ!&87Aj%LyygAerBgwYZ*8J+YN!`E@I5}74Yav9pIB9NSg2-)00zDDm>4G#Ehv3I zD`Q8I!`u{CFLw^e!S>?tC#Hi#>avRsdtqz6E^QR4$3oh1TT_T z$`Q6MMXWX+4i!SUa;5hb+%^^5Mm8$+g;7-_4Wq&Ol$bW!{Ck`Iw(t8@lC;~o2f613 zB3j1`!x!>?EFF7~jl+HD-==cj?rdGwZfE?hVqvx~)ywoSe=TU$@V}Tc6XuJ0`E+(#Rl}1ut&2n zT?Ni}v*ZW^0-n^cEg<9H(;^nB&g8ifz5q*OmS5#LGEq2N0g!y$ef_@Tku*@IP>7#Y znQN|0b!<})>oD^0_&B<@CUJfJu|mI`IX~qa2a7KPp5k21)RIQ3tm!!VZ^k>v9n;Uz z&{tzaMElM^hLBd3PrQf|2||f~Y`R|kA1U8w3wVgq($d_yURStCXE&^+R*!&*~CnJDfx;1~O-ixr+~`?&LDo;LA{0FRUJWJB_F zyzLs$ffd>3p1fKYU$0+x4&^A(qeN%7M5O)BBC4O>D|(&O!y=Ga^WBIzUWZ{U+K>R6 z%qxVozVe33pafhSB7+sQYANEtr8EE}nw#L6&NE6N8P7Zw$8VE0?^k ztZ`q*P`0j@(GsSO`*gpP`hOwSes+4waG3LrtH>U5HNn6UYG~{%zsQs+acnc#&Pk<_ zxGAB=SB4cV6HgrP!SqrK-mlN*dGtcNWSdIlTPzoP9R#P`QMKd$3j~#x!KU1H7%UaC17&nozrtW}XcJEA=P#nH z>q=S9s?Q13ET9s}nnYyvO_A~m*lKZK=4kU3-r6Ae#w-X#-9qh+N)~h~tMu+-W^-;R;c1v-e>MMn#8 z+Z+}kx1JgadmTchEMm4llrQADZc)i~iAb}Y` zBVkcl8nXg|zl@dfJHG2Q2pTX=5xxQ5mN}&A#a5$%_A^(?bM~VQ8z(;EFWm7>@*-s; zIJxZW%_~76&h^Osqj&3_M9`iZQ(%ic;j6_}q&krssx}O=OJ?SXXv7-QHsJkd{1>sH zmYqUwD)?jJSX|J``}`M480yZN&i z2yoo*6Ah-?N(S77rlNSV{wGJ#`D#4k!@Dh~2Qe3$uTKsP zixTcu#2RJ*Kzu0jv~MloEr(%B0`ie>z#r=HBPfeaK3=$NjDZRK28N#F2xl0G{PhXC zOxAvGxQNW|Zi%w7$aph>?1QK?I8ViDvxB)S&)?X$vi^Kyng7LH<{aT1`Vo53*-JL= z<0sEX)*94#Qq}J~lHj(Qbk1q3j%iqanz_mTP^~u?)F_u?6qWxH@=p}-4d1E%M6Nl> z;tl;`9Pl}M|D89^R@*Q_CHl6bWE2kn+3umn%r+8%=%X`oce?RN*bzC|zl*)(9dfTp zDIX9MT2-n{*It%UFTxETQi^Vf18>0{hFuww5#HK5sUZYtL;<##TJ0~_{r@@7&#|G; zL#B1oFh@DNIIX}D5Cw~O74-yN3M5%!tj|bN=R^x}^pqoX*h8rp`XZ{vLzW`@>dKb4 z7c5&ZL~QpSC_$?Ez*9Bc`k>-5y}kmH6bVh zMzFkwqP}zrTiv6Q*57cFK+2_Ed#U_KunBFO{g*KVBgY~bpN3MWmkV6v^co-LdJn`|nixtw)`0!Dv zxzlB;8yczop4B@2sFDOFet9tE;z!0wq046=_|<_snHX6;T%m7S;g#Q6z+}dR_#UiH zyi=%MQzo(CwYpvn+yKaOMN&Nv@8uX=BsKfi^>-ij&Byn)=NuJxe>VFHfQ1&%M)sZ# z*;9o=)j?xK^w8^rY^%8~l+j0O-BZSFbMsPgjdA6^0Y^g_f(k==YgT6hr#DLI6wtm3 z70iKgUWmvS?T_t$`rRzWD?l=jj_nFIGe?9q>Jq$|XD`Wab`?FYhAK<1O%*(a{ow*# z&8g@r5J(y*Cs3twbg7fX%_ciMV?41{CjzM<2$jI~+qKzA(m!QM-#aRQXJ6LM3Qp@& z&63H)+JVj`M}=$wDZX$r3nQB%x5NlXNYN3IN@+8Dl!z@TBfyLqPObz70_kXEAIAT0 zM+o@bGnWTVNHafIzaqVi=3I>pKP{^{%^vhi55LZaCopOM*d$Mx^07`xgbau!)QH}q zFA6U2Wo-v5Nh(;X*NW@`{cXb{`)#i-l&kQ6iD-*nrswR!+8;cIIftFsqqN5NqUJ-5 z8T7HWP4%XTE6NP#y;WskiBG8!BV8j79SOfI5)?<^5<*>}vzjr?#Ut86%8#!=k(Xo1o(##C`5!KuJ4R;Y6ce4_zQwGaCWfjIamGVH3KMq*W|9GY^Ehp| zrl?^MK@VqsrF0b5yiA@ud<+@%FsfyVSEu`%u($OYQmKWo-nF2IRmH9H{oX4;2Cq*E z9&wOYOPGRK;ZxGv^$T--0)ofA`(I|t&?mc3eReN*NGb&sPfpFnO{3XjrMYpz6BF)A zMV@PIeXPvmWQA?x;HFqTUE@Uhg1s=3UI);?#%0*NO)nBjc}zgt+@hez+-NhjmeENxn9Bw&%b{X5G;H3;x?tUv$q5T+KP0Yn>H zDBWHoW8b8#8aasOTrwF{ za~}qDF55M{8fH;8Ff>{D{t_7mLQCtc$!+3yVTmDkI~0G_wS^o7#yl)a6SCZUZ{Jqd zvbkcH&;NXQ02*iE0SpQWS}KSamPKZ72AVaYifj-X&O-kD*3F&&xlDPU#hLFP9)^W> zeCieum@Yfw>C@b=j=s<01IqUSV!wInt!j&97o>M5%Phrx%J)00y(yhCC*{lP$ogd= zv5Zw75L;c0_mJTsl{Y@IWc=s+?#{K1ph$8)PNI8i(XT~j=cbA#Ha4hfbp-~itn>** zqdY$ryz=L>?<%eqvxjzM&D%Er-jUFPPITAJ(&#`?V!UoB@vj(=Pfr^k<~N{4a4paz9_c{@vGO?d%BM`!qtw~IKjsB_jkUJs7xg(07Xw4Nu6 z9YQJ{^XIGyES^l7AoK3BBo_UebwwXpuyPH{uD|3_|IVZAtzU2 znkJ65($HD|m$-^rP9ddVY&iAG5#PctF*CAxWveK`Z<@(icEYbQugXy{Gi7j)1+emx zt&IuCG}FxnZQVvz9l8cScUq$LUiB8jmpK3B@#{ppTitc4VQ=wYzEmWW!l@a+NK6l| zm!s5#nrBGo{T=_1LLh6MMJ4OdoSYbjOmlr4P%;VUv8G!0qL!6XX5C1?itp1{Fg_4v zoYZ+yDFJP0HwFEL6=iY~ z$$fmf#ttkZwr1Pgu%Ka1Bdwa2)^W*OAg_$}J72bNEu0FA&q>UD&dMu!cCJ5^hTW|wkFI{8&W_?k&h%ws*OawDbZd&q zfg3)LijC$p3))xfCC9?IApG|c!pQ?(^t=-cd|8e3e1wOGMUnBu9suqNL1ThWubO(A zM7GUfl%h2c8l5Lhg58iY^~@W${s0MwXEM{jEuPj{93K65aUu8dfWBvbp2RCXX@x3O zQJ%#gPaI}rw+_grozsdUyIROm=>B;Pt8>IrJ-dkX!sQQ46MEfOUPXugU{gOl%&FV^ zn`hC3lPp_vV5by>p1Qv{KITP0Ol^uUaq5$0Z9D<$*EH=lL}!9{z2`T}ausSWr!NAy zYh`LR8(MN^`X~Lf&}?_mc=Q?g4sdW}wVH|gaYR*!!zuw6_Tn&vCT~cFK~#a}HO)ra4te^KSW||nLV6=;XaTEQQnG1)v zMC8>$jCFh_EgAEnCpN3XGVyDMAAi+;4(Pv>;GvcL+tl^&)4403((fw#1yZXy*{lpe=+u?k=rIg4T}VM$Ae=q^*d27<0ZJ`O|~`Z|TRYA1ek~ zN#J_Q@V?{3;m}WslOq(l0R?W>DVWEP@U*CDQ2Cb@e)_u4Khl6xk;n7R9NZQ#6j7H} zO(KbN(LwhwJn(%^fM1Rjdslf3UGROQkg9H@fKc~PO|`Unp+&D8izyUH!=a?7 zuv)2QGluG_6ZL4Z(K>*i_iYyy{CVyqkLOa6+##L!DK>v^h|f{JBZ0xe3jZ`$K#)LI z&D~9fAT#4Om@#tUEyA}@`?sv6u05l^C8M z5D|WbNJEP^Ma$xN2-tvMheeB_hxiX--!M0ahr8??XoYITIL9ke8U2mLyBAJ=SuORSv^RX;s&IIRHnp0P=(ryl1nEALpmIG(KK z9I~Gd2}BxlaH9S+4Y5Ur&E>Z^|6{}s_LECB;IV|Q+hbH{`Q z@z+irv?Icg=OD~@xvCnR0jcf!=MkANxJS940wt}?2ZFwBJRuA}0O7K&t-)L3ZyJty zCRID~*{FiB#Hydgug|DPMQ~r7Gdb_2X;PEwB}1|K^NlJp5m;pLbD_NjBrVca zNd0&m=;1}bdjihL>aXwleVtfRBZ=v{b`wS%DBz0kzn}G-%cc+t9H#r$p22fgIoC(9 z&$Ap3P3FA(59WXQpwTTlCcgpHiJh0S9dU#AL4(dKx6VY$Z2m*=m$;kmY4u9p5pB6I zwIb`7^z-9HS_yxVr-UChchQ9w7u!3!@|_)+Plh0o^ki!oXa_}1_Iviv@|8ge|3 zDnG>4V#_hlJ@k(~GW#$1NcxO@BvI6Fb#>ay{k#rqInerwdL1u>*Y$&W`oIb{_Lwh$ z5kNV22GnSNzMBoo*p9zk%nPv9*)p_+VK{risl5zb@11(`vphmpIZtP1MG}RSG)iovQV3B`3vDN;UiFvI_B_W9~J;RrVNg`x* zg1rSrdMKURtVr22#Gm5U*s4SO6<|gRDo!;3R{H^qg<&j=+I(=5LFDO7j3dZFsE{v@ z)XEwI`g+Q9syxlvYX3v==M)d%Anl@Muh zB9eDt;)P#h`e3G;DQEx*GTO>Rm(g!THbUr+Qx-#5AL?Cs-)V`ltOws z$>i-F&4a9DCvAg5xjah3L}rn@n9H#M7HKCl;dk`VA^@dVRMp(kxqIO7wf2od0vnbm zZ*c|WtY-#~@dz^^pj-)qZvibOILbF(DVGY)(>J z4`8%7&M&q+yD|mQ$vm1fOq-uN0kDU7-AH{_U76PM)ExHu>c;4J0YTNgd!tRuGRCbK zPsnrlBkKon#&>>?2+MBege7p%4IgdN64><@t&eZA<=Ma1stud zdGy5xC7m}(_oD2#Mm9#?k*hhym<)vaFcRc1aBS?urjj!bEJvrHuxmPMWyP`c{>;O> zjk}01=>tSwI?(P({;7BlEoBHh^NFUJRvKJ>cIdUB8k%a9sHRfw z@R{y?1C$7NX_MbT1XjQO?<#hsO-yic@zdk2!KbH(k3hxd^ZTX^2pkD&uQK9J>v#e3 zXZ1BG7#=bGd26&z$`z`Zo20u8@{^vh@#ud%`03D6L@P-%6hG&~_KXm;Yo91<&PH$w z1!J61h1c)ARj}w4R)Ll^rg~^cMJp5whmdu^S(AMZCZ0~thc3tPUgXmCvBsbcKNZB# z%Y_ofYC(MbJZTf+we}P z`oBlde|F9AI+vlStRf@J^XH_&Xm7~7zn~VNq@UL}w}bn>&F zB!^}5F^4KGda?Q)7>k2p&jv=O7}2zfVrDrLt+HQZC7anCq0wuM_$a?DJ}3N4V^gH{ zcZo@{DN`|z)MfOGN_^Xw==hzy%}Ju}x!ZJ+P4yW841~!^Kz#Uwq6k{0z;`v#ct#_A zGjX}3q*wFSd3`zr1G&W#G{aFI|5(1P{!uL|J$O$0TtQaLhFE?;JeF*S)uZ2C55H8H zhO0XcCm>FcT#f7eDi;ru7ZD^9(KOJ8Nz%vRDN4-?Jw4YrG2(U{sSELRe8)*@QmJ3U zUv{=$EUR5u^@OvlLeNz2nFl5J)W;xse|CXXwwaT5PGjyTam-|yPfv}sA?yXP-6?(TqGjY~_*no^*u9)T>w*}tEE zOqXY2ktX=uA+JK=pIe>j6f~q_8)OwlwzmrlYbY{NCS4tyLdQa$vp+W*Pykc#!THro z)zs;xSL;tV)Ly1_OBF!3X!o(+zp6s{uVI3C`0#Ao&#N8z<}dQnv;1?>p%Kz>f_(F# zp>w5_VoDbF+X_Ze9mK%d56+g3HWck6^79t3hq3bV3S~KaxZaq?%jVbA51|R*DO#wj z2!&>MuJnw~buYtzhzogQG|PT0eQfl6jPMgk9o4iMvkZuSgp4`mKegbQAx{__4H4 zG{!254qn_M>#n}t1s<-6A$tN)Y`;%eQ#lH)7M<@MgQX@#1GJ0N=iHQ8_GEvusc8}( zSU0K*r~ed}-xc|d`jTmN&`dwd9x1H%{6{8=9Gw{URoQtHo2JJwa!5@@3I%f`Bk0nQ z!bs)haYt(;?TZ%@sT0pH!-9{8eEKaeO3yuDzqNCjUgZe-wsjnP=!dKCA>4@bK;ZNo z1~>)n^rI8Mo}3={iBs>r8$8}gKfZbHR=^6oI=l}#d!`2Ynhiuu#b1-ubZGouvm+E! zaSW5jQq~I%*}Yaxq7$?JMwgvFV?RU{pgs1VsI7OxZ0=WL0xEmn^u#aK{OpYbBZ0C; zXYB>fZ*;w6>+KA=Q#s#YYrUN(kvG!XMrVfkBJ`3A4n*XQes}QW$ZL%pkJ_l#%f<+D z?Rng$7p$qhef>^ooMB5ziV{TyNb%O30r?mpI|1f;w#XzV5NS`JO~>x>ni!zyGIV)U z=dXPC45j2MyZ_0=~(-oae%krf4Z7_b(Bim1YT&*#M+ zyMs$PKR;ZFJzfk-)vO$+{UefXLpAGIr*AfL``*L4dnXr7Hr5kUL&JN{8DDeai75v=I_o2t75G?^l_(&W_*-7_C8zaQTtlN|GJT;Kv!8DH zK1WTmaB&AxOdG|5DQG)>6K3^NjxG_1#u3em=YDA|8!C^=!$)h9}NrF$ydzmm;T zk&wHMbN`;fV3czmRy$;#tdK7yoFG4)R;gv`Z3|i&hbJ-Z*%Ke-T9Jh#L|^G?nE;L1 zl+Z`tSG+8AED`xF-)zH_8Nx1=wcf~M@#@$=V-u=uW$zaW6qQb#g_aeO)>~$ks)N!4 z!nycz%*6(B8JQ=;plenMj%BNw$zf$va#Aym?}86ojOXR7_F9A19z#@AoE@e7UPLez zrVp?V@7F5SmQcR&dLdWD1jeI}O5_+8o0Mcm^cjU4&3&QYx%{pg{F$Ahg)?RtY^1KG zyTxcvvGkcA^`NM1%41Ze&zS;QPoz{*Pe7%Oy-)IAD;{77p-U%){>+km$!~0PxlR=S zAvZpcNJf-+!tEKm!s^X59uZ+gjgvfk+u8^#CmQCpvCA9&7`pdW)zwCo3!JIg`iC6$ zRCUBhtJkWt@Q(@hP=6}We$_x$n}wEueSR7;i&&ANO|YeZK?FQ2Ozp}HX?>R8KpgzB z={~&YZ1*^9r*(5h>LJoR&~I||oX<*%IeDEGce`}wcK-$QXelYSOD9XlGu-|MQnkS@+JWS1AQcvfT@ANuu4lH}M}w+AdcA@x9*vtVIMfB~u!5 zScOM&m!|IaNw{CEMRt-Z|M3|ShTY0rnh=Y~n%0jY&ns#ObGrhr!g;S! zX%!-Rn%NHz5``?F`@6~7C3H|8ONFVrC(Y85kcPL>`-O0*N?16EBzKP0JjL=9K!TeU zT6)sRV<@S!g=!^mYDm6doPM4-${<36`f8@2ZCpbj{TF*7E4m_rS_!Wjl3`-++$_)5 z|5%gyrEUq6mxKM2D^7mCSoYs@RSVqEMoxEnJ(Te@G5Wwy-b--_iL+ya6GNC|Zk>9M z;n{42t@_Yk%$WRAcEQ6aUvETc4|?R&QE|GYDEurws|U43_=4?3zMZ3mXsk|!Qh|PXJp$bdO$9jQml-?m%JaI2 zP&6ZQMxoTYvP6|OM28Y0kh|myB#+M8J9TBo$cFpGovv>P(N1Lfs1LYKq~H)5Mv{4q zb72n$jgUE~iSxdFPpD9e#4NuB+_JvKvVI9T?DPX$$kD=*(TpPHZfk`rRm_zQFKRii zewg>Zt^3Q0Sh7rrqYVoHf72#Jg@|UeUXg>(5wO?^V(HObn?{BdOzo4z5q3s87kBE`3f6x zo`za@1Wnlp4zl*Tw`}bit7f1OGifG&M#z9O!|CMHKOU+$MH)%*vx|$g0Zk0Z26mKf zVq69IE-P6Ww&vstwr z`+ncDPUhlE-jj?T(o?l6d8dkV2osU?vx+VC1KliDvq-LDWZ+8Z->%tHGi!A;_ zE6@Ad^W9E01P6Y)O|GjqK7NViAzr&en?68uqBz2!C{r)@-3; zRh>5?WGylF@7^Q+)G%Pd<<>IVdv4>+es2Y1kDS3ddF(PkdW{A4f}D$s2teKlU~ila zIa76Gh62?H(S{gwurWzbONFH=i3pf9_zxhAUHEM=3M@O+kDN@dWG6%qhD`Hc`ph)8 z5_q9}o-f*ta*obZd=pcB$mDPZ;nbr2bL(qsXSb+tzzt&n`F!>u=uE{juGrrCfaTw8 zWap7~Fh$|QhB>mzhy~tO^5?|RczW}I zOMz=4mz#rVo)!R~28_x(y}dl*Qov;YuV?Cd8}?f3Og=0ZxqoU~$DYrvLZFT|Wu#z) zkkJ})uTz!d2g_&~ROoY5jAPihH@0=4&L^d86R<@xmsY{^UM->Jt%g23xb`}g$@(!XUdE%T*F$3yNgy zMJ5w{g7Isa^LX+3!O(Y+tI`O2&jOQwowM{9`CTvz%6YiM3QeD(OvXu4AaE14;Vu zHr6j((%ww{;E%%@(7Hdesz|PGF80Fo2h|Pgv4?2zQV828Pp;%r@leW`+MGX9m<} z3$0tNB)G@HxoV*zRiIn(U*Cpkwt7}9??r;W`02&X&ob_tU4w7+W?Wj}siW&ZKi2CM<=SpfA_$n!bLfDl@)7wRcvJa( z9iN_&($_tfJa<*;d>QNc3fA(B$c*2_hfS^FTlb%& zu>R`K`^3-xia+mqwUJD`TLI%Rd>{TZIo6sW87*khGTIDV) zE2>HXh#5*0cGqq)-z%YN-{I4kylmuRZSOG%&Y0XLAkh-94q4UA5W|#(;4tgvani6ZJVw6Z&x~g_gygxlIdZq@Fl}9>tuhatWEibZ zh}1l4Ry*NngFq72E3da>$jGda$JyZtIn9-!07+{NnXASzR14HI3_O#PAMm71pLr}8 z`##1;rxE^DoqI8@hA!{x1e|4-Pl4V6#NvQiX`Nfx$XuT?qA&sryJnCPwiVr*3;jkL zm~JbZz=6m(rLhs(4C8kDIupXKjM4b~Q{GFPe{W}j&a^0#yQ%$mUT)Q z@l%Y_8Fe5|!>m$y2*5NU(KAZY6B%WTy}o5@d^hUjwTof3;QyoPtAnC!-*7((X=zvlLAtw< zknRov>2B!`X;`{@LAsHY4rvxxxGeXBGr?3WTjb1O;BMhmND0upJvo z9gXySqx!W8rjK=%g>+~K-D2GqL>bIO;2=T9$t6@jkK}#xBKUui*&WK4#}9dYmR$=> z_Nn8PHUEmbbE&{>WMQt;F~bQp5j~u7>W?m#Q$>GhBN7|};>}=#NaJ}Uy&E#i?xXdl z*%o-2z)J@DBOTvv0mIdrbHH2J(Gg>2u@o`6LT=j4o@z`87zOueXD8+EEP(vIb`7sK zBT2a+F2jFc=iMaEaM*RFgs1r?bNVJp#U#GR5X19H5-{_C?AYK~Z-lh0(WNMm2D&X8 z|7K?2%wkl`;-3k>C9-xse0p2%^#L5d32(3KZ^QwQSGfxghKYpC`FedAV*cY(ihiT- z?P#Xnt~}Lj6|;qmaRL&=jCqMQkj2h~NiuQ@${G9t4}qhH2P-SFnCRQ#d{^<1e6e-0 z{rAUeaYpf)r>N+c)7Mldk~fEP>>;#amyzQkcb~!|B_;xShabd1Jybo>xX6~;U+dJr zizX037V8XBvF7xSl+`7LfGGD$u@k|AxJKYz>H3{T%@J=<6?rykCr+fdYm*HtbA(-=YO-) z7G+&}hE$eX%0)ST)MG1qWTT`@-d@M#>3 zLpjyq)EA=;r%QmIgQX!pmHdVF%TM-Iwer@&GMmFJ^wT^hriphwMf!mTrn}yp$?%P$Vl;SNF%evv#VML4kHDH6=SC+%~>`? zz~MV7{Y&ykMK^dQ(c*@ixP}Purr#toMB&l=R)-i{J!}kiO%{gUTzJNVH1=3{0Xk3h zQq}~>B{kz4u5DCugA(- zr|jyr*EJult7IV^Vk2oHTuHgjVQUKrt&yKn!}+3Gn-aBSN{%36Oroen;@2!Db5c?} zhB><2@Ev}ls1|i#*koQ1Uu((rp1_&d$}v#))cfj)9e9tG$SVm^J~L}iSw<%V$#;iJDpc$M|CIl6-OQDx$DF$Wy-6z3jiiuIS*=fZ$5i z>25c*oT1iy*rsJ5yxYIalEkusgHX2SE;0P_`B_3UO>bR~wkNbehp8+RpVdiu5vY}+ z4DSt;tlt}3{oc@&4aBZGyS{X@DJg7a-}@d6Ak#}*Dy%iSsMcm<-|LIL4xp2VGlIes^1Mn+VNk|}%XguO6pHA0c-xeJra50MDK07w_7itwMMYIwVgLTmfB#26~8Bh}DJ5*M|hXFT?I^f8kI^puI6N_AwY% z_!HiJu**b5Ufdw6k8>@>BdB`6GWIf<)RSA%Pq-2*OJn-2+5Hex6m%*3#G?HZi139N z)cZKZt3JA7`HoC)!Sf!uUB)A$EN%1uSnt?5JbnM&jDA(Ew2K{KsTU}ztE21p{AiM# zcDHbOzmc#gT{))1gJ!2S!I`j}U2NBEFyHQXN1Yq+ipcxt&$bu&>79hm`P#;_f=-GU zQaWw&WU{%e1=?cp!&eKJ{JAu}PxfY&*6OGSi)2`h7O`R>A0|y>#E#+}D1(F&%+1@G z_Vx48bCs$rfPKN?sPQgq)rt$Dp#ex`nLQ;{rB}cl(0{oGgrvfcy64X(P z7LD6L7K+2!X>*s)pk=P#`0PzsYxR^2uYnY)@DN>L^$}XSTi5y(Am@k)c={tUaTgrH z;(MPvr4RE*9Z#GA@kiMXuotQpP|@oa5d}R*hdUHPzYv&9s^W7s^=J}F$6gNxt{zpW zq+Vs;dYVjfflMVlliWXRYN{~J`CdIy1L1#{m~8>uHx~&dgGdGt(ueaa_!?PkT7<9* z=YP^?k>jeV_!&x)jD(KIP7r?5yJStpdfi|3(f?&D(Kam$_0|N8S)Q%we^9YDzF!bFiluUpVitx3?JAma12G6gux_nAefr{o&|TL@pow zt;^hxy0Htb*4!thVELWV@zoDTq&|n5KakmV*Vh-)me~KMv+GNW`~Q}SZyO@7lxsdf zP$+ZLk_T)vnTW9pUuU15~Kn%DP4lgorD4Xo~XV47E*k(j2z2Ar;i!5 zNTdw5wLIdNvu-2DrDnCK7SFDKt)es;h6`!Az<-gsT--@{bJ7Kd2pKu>t(B1;JNpqu zJ-?a9dK83c#|Y{8_uAB&xi$8L51G{GJJ{%5H-kzmGDo!ya&xUczMxi>*~Mn{_q4B` zJS@kFT%2Ez0t63$(DkcSCZ|6sXD`JHG6E*Zy$aT@?Ng# z#~A09CkspD2X;k;f^;Xz$uz95qL;gS+wgq6GC{Z*D4x+%5@a|SqV=WJl9xb*xWnlw zK+S9&J_5|s_ww?d^scBIB~($AhD{12`(<2_*L(PY2dE+7J}2|^^(`zTw5DM#-ZsX% zv`-+k_Mqqo(kOggQ37$)1LN7s^6AWFPv8gjqsWAybu?Yx!J6+2oU6ahlMwiHzMc9Q z7(gcH>Q)`f4sq<6ZcK)q0l2QGszt4+UuVG01?B$sjkxn+jCZv6Yk-}XzxVFWLk5}u zJ>p|zA`^tSQpW3U)aRY-Fv~v6^foU$9E9P5XMRd4t3WEo5|@{G zx6P&2-4KF789An)ai5+zqbWgdDhhLvVJaEF(H)SHn+=k{n#8+(%Zr&fKwK@Y9^}kNM!<+`BwGCH?FtH^?#<%%rfd9!6x8FMZ zIHjb8b~W$wPlcZXHyxaa42+dBfH8pC=o=Dn*g;q3ljMpDBxwSc{&Fp*&rD%(h)$k+y)X3DUP@wq(m4k{)95?Ts`fVDi1+ z*&y_PzMvKMy$42tzhE$`%;bzH`)$$$NqNH-A0vK2TB)&pI?kE0?Um~L8gw4^qe>nG z!hiqF)!WDcA~}e-(0e0WtLcxz`pXM)X#`QFjk2Xb48prv>+k>?PE`=p z*{$Ei4VZ3Ufw%S{Z2k2WKv079>py@ua>MOu=<&fu&YsoY;+rD<4*bDHYiOS}3Q9*3 zvGN$?lhqnd6883Ju~UGpnWpUOOtN1%hX8k&vm>Eb;2hWs!cx{CoP*|&C_COMl*f%j zFDN-MIeEhjtAXLUiRx^RUP()IhMkDTo1TxYZa;8S7=J!Ht)A@prVB{19Aow>@Rlx z@76u=iqbz;wC-Sv&7DXPtWwW}E@5!1;aPszX#`W`A7^0{oamF_R?z zZuaOv3I`pYgR^X`o`DRU-28qrOt@tIEU}etAo)l2&K%|MFGE*wXYF_$lEcR(X3@?d zc+*rvv7dDc|Dr~8pPzCUPVX89ag~9v6r3_m1~$%;rrvU9bDhaM%4w>nTm~Y;5~poP z-#jv!CG|K8XCIgTn;S5QB>aU@Qm0;*S!E8V1D*XN1`2b^1`UeVK@&1cuKs$1 z_Xrt=SkE**ZlM%;D$HzvD3frXU-`gY)XFSZtpv0$fc4kV|A9K!4}f+a9!%dDhgFpm zm)TJelM@~5>X_cKCy>S=k&=-;oVK0aAC!;*pH?NWb8^5nZwC!{|d6yG@8 z@1R$XpxY8U%U-DrmZ_^69#ZG6NHzf#eVx;k)!eD%v8{HfVGEcBc#+!WA7w|0v%BEY zb(Z4)uLUsqQ{?S$5g_R7=BHR+I#g9O%3M-iIO1|Ss_G<^pUU zUaOtw8+(TL4=*ra$$EKz-VMD4@{IN$V}}*-%q7#LvRlT6u7Y~LkctTAnf?#50TlG< z4SufJ)h>v?m&E)!i8eRhGP{pXR|}Edy;MR4nOtR?A~t=bsUJo zKI~Bp*nrF9pVQ0ndYkXWB<^CpAp5Pjy$fKyE*otY+jiLEiID#MCA8P4Zsqr4<@r@M zf+QjXYOOa!|KkCaML;=53mLU43L0@_*M4pA9K;p5RjQ^DmS{N5WdH}PpJbB|ov!Yb z-jpvM3j24~U#|g%7RS%5UT1ng(E*HJpYH+QvxkoQkP5eNY7AI(kTa$p$5F1ooOd5x zp#^5QJsDms-dN6z;s02B1(OBbL$)@4&ZYKS6xs>Lxd5@jwhf;7vPo*^34?>%EJXdg0Dy!Fi>+ytu z7VUUe*4Gm(`P*J%Zyv#a&V(%+4FKBc*yFqRp6BWrkp*l-F8en#V^~3f5Qc07ktv<{Y~m#Aur8BY=tmeplgyY^O4K{=oT zTQjNJ+1SJ6GLISKDE7)f5y&T)fQ)e*T8MI@2X$l!vD;MAg9anh4pL^ld-vh=*Ks45 z<`^5odYxd5H0tC1E;p~)4Z67R4@<|j$BS{I$Kpk$vc z7keAYHi~0RBG{b4_hn{*Db}<&vS%_U*4jy+*sw01R%T+JYeZCjbAibI_iz~# z`{L!91|B!Dszaf;2q*1!RBfuo>J&e zP9|JAvH8Yqfr}t|MqYDMGt4}dNDZdM^WhkYda4?iKI^Y?3 zy%%{!!o_mtY$Q~lr@KK`W}jyS)+}1RjRM2??6lB z{0SOpY<8AAN^;D(@gJaU>D`F;k3EO7ico{9T0OVzIB;POcvQ;9Rs@JgF@l6T)eD~x z_S>{m^$ZPv{rq*dlPcI6Rc=c{yX)26LQmgQ*U+b|7?hGz$eqgcXIsbX0TPv;SC0C% z?nl!yvpr)U!rt>+NRt2~1F*FP2nvzs3!h@^{2`atwTo+CBNE!Cnwo5H7@L%Vq4K>^ zORKm1G#3I#?1_S=VQtH>YEyBp5h@XM44ki5x0-?tJZ4hGP|x? z=f@hBn-Z^gok`FBzvZ)lU0A>a=eqyXr?%d}*7DL3@cP>+P}L9sT&DY#`9t`{rEHR+ zV`v`+g;;F-{XLD_RxfW)gvLz9US7h=BP(khbnL2Cy_87tiL)jv{iVziS2w=$j+)#v z*lgCCdhoHum`=gw`>^0hmZ zV5T~&)P|B+VSJ<<6qn*_v{8 zE6+m+&fJlb zf|uc)$}YAp{5``B;O>4Ca;q1*i~0W~Qvv=_l0|K5MR$0EU26BK2bV_KLOyzU_#{Ik zexser0TKp@$yLo5kW}Vdf5yFxIfMU9a0#8M_`F9}Rg)t;@AjB0yU*#=f+ShF=jpNiPJj3$POR|K3Ry6BXlp+RohNEmRWq(;75 z(7NamKBSZTGpQ;6fX zpnYE-YSZ{HYyBlt5SC#%2$bedhtr-qoY8T@!Ut(PUruZA+{S>Tf6PL>Ue`E!Oiv>j_!Z?ef*~%(EU7!G$92j#j16d<0GK6kVM~&!6M)De-`;yIG!nc zLGdUpcoNc;AD&)rcZfsAFC}# z!Ej~14TJyF(>h12(A;0c*Jn#%L4Tuwg#<#xX|8xT#KB$zljx^FAUI*!BX^Q1je=cE zcYv(~P_ET~vCs%z=_F8O-dY$nN|7SWl;AUsPY4{dfO|hd0yz*)C=3jz^UVzxzdfl80-VnbV(L z#rr`2{Pu&BnN$4Ml~+en>l-;?_-4|7+EM!S#F9@88Xl&!J8z7;NLOr~xLo z(70mEFDoR>k>}IkwP_U{4)B0Hg~Qv=Pc)Eb!CDN!z1ju)Quh}(Nab~X7E>Ngb8KO% z-9cu2xe0{w4yPO})u$5{1MVV@Zx@02?Vl@Hsp6KsQlZp3E&18&dB>^l|Ha8zM?EIm z5FMqdz_c}8l24XjHysbHGBJXJe)>D+2Vz3T zwjjN=*k)2cl`(B&ODF+y4Rh4ujTg{y1ib78h)R~V@72ppH#Yc%moXfA4>-5vGr2fd z>A?1yo6I}Yudatbm23sBS|e$38jfbL5^(8DPouH@CM)ECWUrg68pRBNBsI0=d3j-L`}XND=PnfO@FB4x>&q^b+MK(f z+A@en?kcu3jr=Y7l$I1j)|5m#tvfOH*U{pS|JB}{-<}YYk`^{nkXvF`RWjK?@zc`M z=!&$N2m}LeqbrVVe{J8w5B6e@kQAW-LSgHV(JAp?azp3`WNgtj)$kIGhs?%HLY=r{ z;l#$;2XR&CT^%|MP0_?B((p3)2MI;|9woxA>%p@-h;I+T?CkY29hcoi95$W6#M&Re zDd@LcX8=@zxC?r{W>>V?68R&AADLeXaha4hma+Ld(^mBZYSQFDJj`ml@#jtO&MY&) zfPN4WSP}>5tIgi0yXS-1JD~GS`T6_>^EgiWJ+BEz)Y)LjT|%hlzxsE3NRK_g*AO1Z zH}tnRHwB6^X$Ji?X3WQv+K5%XPHxfld%a&Gp%rK>)eg;_t;y4aWj!ULp8DVVG(KZ& zeVr$XL|Alfr=$>0F3#9&>4&;IImxEt^AR5W&#X$b>CJa=T1kQz`P-c5d#zq(gA+0` zQ0-u8B=!h>zoEvyq0UuL@DxNyE}Lq;t)sSM?boSXGIW}|b+p&t)u8@`juskJSZ&>V z>L^C9I>l7cG9;6gYK-39&8Bdz;xziixvx|!;)+sWL^K%4lqA~5VSX84md8~xFxdbx zR*5#Hx=+9YBy#smb)$08_VXL-Lcf=JC{Cc%TfHD6-!iTcksPUH$gh~JC70%mY_RaF`acgM@lmwoHtdu=7fB$+xY zU;lm^ub$a448pXum6f%+*7jn(Dmv&#GV;ENF;tWkM$}}2uRE`v$pjiKFUKG;wbO{d zKh!|C`hynr8$gJ*9SIooo%;9 zC|zK3zOpaRp5KTW8SXjWJNecS7CAq!Gpgx+epXtwU_7go(%kLWkCOuV(kL%eQtDdV z0dJUZu~ASU$r?Z4em-F5L|Nqb_aFOh@1(c);ejUJ{I!CH{5#6<)32JE0Ap&xQ!D?v8a3n}s>er-ADCfIAu#8xH3zb`WJr8bbDr792{wSUVTHH<-eb#OG2k0`~MmdIs1(*s~(7 z`RWmSY*#=|AM#z$fl;z>SIML$=@R-;UQ_e0n0Q{bIe!6!IletVVt`gPu3gxaTb(X9 zFXS&j*pz||UP07MWN;o;e<2Hb5KlM6x~krnR-koNtY63RSfG>i}b{!CAEY` zbb;mdJ3=HqH7+VK>S!I7QLTNNa|JBMKAHeDC+{eY?oTOEXg)u?c+zW4l~!yC8OrO*kf%r-_N zq8R|Ss1w!iP-isG)a!6)3n6Y73vn}l<87;_K%my4_;1{Hz(ad`>e zISeW%I87dQ`OUNQSAn<5vGOlMj3OT~iZN&Omgnt=LhXkEAP$!D3`l@3nXmDB+wjXI zx@k~koIS1FT&ynvyq2}utj%(?fL=tK$;Q~K|Lc5Ch_0%xH}y$7AobwJDA|?JA-pz? z8pbnEk$s}V2+P52$mzz8sijMaw4-w)j3!8|DRdvHv;^UZFuxD0wroi^O)f5H=zQ4y z!a^Yby78xLXO`@3NaSrgU}Lu88;P>?V-w|mLJ$9pPw#=N(bIiozsWE#;XkOyu*&1r z4I!O58aPUM(UKe6FaJW<(4>A4D8dt+1G&=JhAMs@Y!7?b49cQaez;BR+V%)|_IZT{ zJiwlzUC+2c6Y_5JdcMX0UMe>_JOjfBg))BE=tbr&70lgnL2&S+qNatQmvdG=o7`C}a^(nn?b@3UK|iKS{YtM+Ha zV1*c$q)6KG8)F2^%T|zY=umjmhRNj4=_a9?Z#3&PbjOaP3)vP4l{QpnT?#7x)DqQE zES}0eI-9LaxrQlR$TAPk7khN^bW(K@^@zf z1LQ{0|NG?ViTH(KCU~5kC6(qWhwv#z1gbAzY#s5E#4&5qkH73VOL>&Pi_=oU0O&?e}^-lKI${EPS&+VCCcC3cW9SJ*ERcewV~Q7hH7rj@PaZA+_} zm(#Fatr<_6v8Pa)UUC$a@$ezLy_9V(KSsjh3FJs_UTix&^;zjof$yzth$D6o_ioVV zvnVTmS$F*0^28{yb&xTiga)T&6Jj|5)zZiE_KoU2N`J z`_}YU*w}0Lk=yq z1PLp_QVI=0`>@HD;!*|{7OfTGmaTqhTD#{(cEI!CThjlKZLxKnwmKD=jB;wEt1n5R zc#q^N4@46?<*Q@2THpH&87juI_UT`u>%y829;iM6@CJ&~#4gxI~UU}&YW zn2yO!Uv-{(PA*E@Hl@z@^ZWjNcy{#s_cIXC_FAMtdWddC$O?>3K5+Z-AB;1RzCvyv zcKYn2&LzWpeeLIQ3hGODPNn!+=n}@a)305pz;15yqGu>_v}=+q`(ijwEQQXVgN(EF zUKNHw2RsGA?RdrV9^9;X~ZV>=QRo*8-(^z$|pcR zGfE1)55t&!x3IL-8@vGsvY`Rogb$ z+PjDP#3VQcW=&{cj8tNxCKH(ERYn6hXVnPz! zJkt>zT13Z46Y^&g#kGXH$7^X9Vc53>nd>BSf3@XrolaORYF4C7-hsEZ4}-YIgd6-> z7Si02&{gZd-OI#k9VezDzYI&UvRL*h9*ngoE(Pv9>dr+k=`5xH3S7iqm{EtPK-Ao@ z@XvM)lfz<3JkQW0VsJjr^s@7?bE8R%p0kr%@8u?V(L_{p3@1)ucvulFcl=l4lVNoi zon>)DXIJ~6zCh8n9}K`Uu7{M$gfGE?|o)2z{ffl<%lLFC8gH0>-eRJjBi_oOr(}N@u0(n6H^&u z?pi0>kdr+HtxL5flU$jQzEH(C@8R?O02qKVMvpRoMWg#c!=I4a$#h078|p-zOATYok zn7D`wzh#%o;C~R_6d{3{3}8GTC_J2mvC$mDYfj6N~QJwY2OR7tMBaN+VVdKSf!c=~9oY-NIZ z{P5C}2H(I~rRjSRwNP*_waYCg#_f_j_6wvScC4UOMV^5A;OhnyvJ(Y4T6G z%o(+2ni>D4$NFO(I7K*rMDJn$aKLAWC+B4X0!W5R=eiZFh-*ck;@WB!4m&L@wOw~r zJPoe_6CO$!2dS_hMHqHLe?g(>c8Yl{v;3p~;g0S5z5OTh1QXntCB(35(=HL`QKplF zK0u_v;xfWv+LB(M37cG+aIYFQ&R^loNgAss3q!!eX#Pjknoypqql~Uf;dqrjqHR-@ zF-EATr|0P8)W5Ss4c$S!QQ!dx-y*rHz9BTMqCNV%Z+Mb*cCm8c_p~6)P^Q+TwEz0F zKZ^5VD#yvXf2pt~h@zg;C7rkJe7je@96MTGGk%p#d6Y$ZNrDx3cv7ts%ViQ&3<8qg|U?(Vc7h)KLya$9Y z{zf;LnJ#4yB)eD8ZTm>jBj+Sx=vKtSr^)-8sVubdB@jC(6ua4aM=_ z9qW%#iVc%1DyJw+l8~cpm?}tBlrXMjYI07Hm}K`;6qQX1aRmPtL%x}FjjlT7BDklr zM>My_oM!k_nFcYl-%~r7gJYb^6)fD^+=#hbf`QN~#)F{&LAhixq^@SMZ0< zCTkisw&u~vU$)10x@#5%%rm9RYgrpm&@RE5az+o26NeGQEzv|2CNyPB;16Cg4HU_# zR@c5evued1>GBupm>64FYAm)RKBSknEk@$qI)e^abm=7s(%&*51 zUN+KwaTC-N)OS;LsNtg8+Gtl+g*LKky0&hz{s4Itz-H#<4$yD{joX+F_E8B)*{_~| z-GHPZnfle=K6=x~n1X({AyHA(G_c=Rt(`j)T-hI_Z`*{99 ztmy@FG@Nu_cp7!B)@th+RTY)nSlmPx3&}p&@AqHZ;tzbC0V}>YTK)f80FtONgrO`# zNw6brmDg0uZ-FtFKM)r&ostS=yI=tFRpFmMPgYOP@*DqJbYCyc!8hb!s}Ti6x*1r#@a zTmt+|)Jnr-%(a~%#M-?%ml`O<;6E7#cVIg##br)CWW@3mMY>HyZH!@>Oj^qWSA}az@@UpGHDW#DVHXbpR&ksJq80c}U!{{Zekud&B?@yw%PRc0B}RX+}F zf`v}Lsjoo$MO@QTLL?u#6oj}dD>d!2RLh@>nptez`4bo(7u!ubwK=jPnY=r-3nSpu zS$AjZiLMrdY_!w~isDh!1Z&kk;(Q!j(#w9q&c>9WPI+#4D3I{l7Dr%4Nx}{#LrT!R zgGW$yEEwgU+Qkw3tXy8*FUBTet~$Ym0cZ&+-)_2IA#r3P6nzIka>{qW=G-D15(0Pz zJ36*D57ltK<$NLLb=yqvE55(wQUqXy&sw|JSQ{o89|@)vo*Vbp;U!p*5r7JUevcZ> zb~OEZPZ1vxG4Tqp$W88}c`{VarEE>Eqm|;>UGx3+8$c0J%9g(CsK5lZI&=JPrj@CN_CC(Ls} zJegk)WYd5tLHOIsG4|BetX6Nx&X~k1{KMWSX;Z!#ZcXk2hMms+Os%jt$sYIm0v5DG z@A0G(So#=&pkTGCZqgpUCO0J%2*e;ar&+{%V}g)p?OI~1zLX_baa7nImYXb~AyRk) zStA`sN!@1KTZ3_2C6t;O>hsiI#_VCqMHDTXR}VqyXy*DQbIGcS+7&Uy`SFcIPcG!2 z)Byg-e<9?V{z^=ZYucK+Fn&^@!xIb3ik7Eu3bwO2czWp4%7sqc*pQWXnO0w5D<$0U*~{v2^9wW5OR~cGK_S+nlpi z&oT}U%8X07KxJMd&E0z{uJm%S)4uu+M_xqwC@Q zfJLJWaW56F68m3r&&OYB$(>U)wLt`-V;6mVe3fHEbu!UHpS^Ck_P6m&sYLp0Bq2H@ zV)?N#v!fQA1XuhzsV)F20N`_Dd$MA2HGKt<7iyeM+lMM{O}Rq6=|T#qO9S_HaGqT@ z*?*zKG9?O%5eM~Cb&DaQx=Kr66IDJH3a|A~AAr5!ho@k@tzRXIbyh`q=Bk@l*_}sT zfCl!=oZ!#uiRazvry9eqUraXs7g2`)Ljw^Tr;nLYQBhZ7pHVWY<%lYIPzqS)SE%7m zdwb#I;(&*cR_M8j9Lfk0{%#zzVdF;4e-1iq-91R6#R}CjPBuQ44pN@~Jan~y2@gm- zPN~S%r@V=}DM2K7rVNit^zUYLhdt*}zTr*Nx0W-YC!9D0uSZ6@X`#^TC7}NeHr=88 zmWJ3g)B>3WB5%)U=UMM}fRo!J;10+&Kg1V#J%>MA? zE_@^xYY8c#ptNPJa)0xT+0^{eahlam+sF}<=*>$LNfFP-YV&$8GoJ79=7{rYgbia5 zY`M&dXL~LocYHR{njo|}>(a}au?NOgJrjxT zzQe1UqMRKR0~L5S{`#ATLbe-%#;JuqxkUH;hRS3$%N?S!%=9oFc2r?M(EGB#iJLvT zlGk8%p%q>0I*m_Cy;TR>uB0Y8ye$YU3gT{ABx~v%Ml$d!RkQpdqx-TWMAKtNbR$7( zK;~TI%cAU&rdS31k{qMr0bVN28N}P8N5S&hEihZn#n}R_5hY0>{O>HCS>p4OH#gTuqvkJm86x5s(G7N5U%Jf=KZ341N+%b8MPFZ#4L%=Qrmg4DwA zmx?zwE)sHqYLmemT|BvQRTu-1APa0G0asbQT+jxd%D0s5?Py8{spozE7-_-S9cTKp zf+K#2(zU+wx|^j_^!C<1m2UjcFEJE+w6xB=kPLG-%^)xinlY0S@qj35OZmZ2RAOav z(m3ezwU9%b>G@^LY`w0wT?H^r1Z8E}`rkm$Jb})bfX6K|ud7FlJ2GJ)!0q7i!|kT( zmrr*ZZlbsSH}g`)E{h8Vm>|l54S;ZvjuUh8a-+W3SjuZCVzQK=cIoWBkP!M#Mc)a8 zO_CjW>xhK;W3gl5$W}ID8yzle1k>aLV#EG+i#DP2(;M4eDE_x^-!$CD`fY}RuM%K$ z*<4~RNRB;R#qKGR-)Pab3x=qOC&WWOP(q-S zDpT3r;#NG3%>vz~4*fShAW07?y5qG|=sBazBy&_cGb|OI;m!&SIMR9R=;O?Kv z9j)w_axq9QnMci@wVDp&>hS+Bi6|Lc=;8YF$Wf{YneXRf8-42-PO&FV)Sx^RGjWx7 zWbj&xA%?k$JA&8=KfW^u%wK1&@a4@CmWAr_#2AynXbH8BSbdccu_<~NYJcR*}Nj|)M+h`n%kY{Ek z(@+#T*F6YVSsskJlW(@!_jUb`Yg_E}#n7YEScx(jK#Rys^IZN1+_p;wtIl6G)7K<{|HGw}+wG+ipO1wxcssL5q|Jo!k5>o$)EkHS;g zIg`CoC&VZjY%HRvYmW+zF6to7d0!))N1xbt%A)Bg*5b5Hn_F5fT-+q*femtO-@aq8 zjK4k2ztN^o>L-0f9zBw;mZ(Wu~5@^oh|Rb6nsO=SWe44wjNA&q`D$}gI!;NdiT~0ulGoe z70?D;1I^@e+Yxntb?sB%`oS(d&5qwkBkSZ7Z@_r^Euec)7LhF8`=&Dr7jfkHavGcCsxQ}(HFX0Js9 zIdK1(=+lozavJy|r4p7ip%*?!!BcZlbg(f<6w%pslG4+7_p{W3b+R`~`@q#rt(liC5@czKDhb?&t2Np#|Id$uSDQ~PP*5OeQ!JKcXyP!T~vEEP+W9`Cl26C^!k z^sS*S?-;ePN;)-Z>IvyM?#$Y=gUrS2c$7cdfwFDJaQL3*+dy#0+*tJpTuO z^+4k019j@!x!9mw9;5u{gpeUlGmxRoDQk)#Vum}Zt@HsWp0GfPzA5z|oW2!`lVD9Q zhxqIs+4QmI@w++!iQ=Zt=gz4q9x}DoB45_2l^PmYRM%SIYns3T>mJ4Qd$`}$v#|3x5Qc1k0@X-1~y~k&YKn7&=Nz1Pb~NWA*8FqRqKU|rKqRh z;4pF)SKUol;8Dkly#F`g0-el}MHYB@d7nkt?)#8PXy})+WQ{*Ak2U)*Tg4{E1f6z3 zRggqS6)U;e`pc3-h{lCd#KcNybiP#v@Sa(m(IBXOMG-v3nRT7dc~yx#^2rlz)koSQ!oZ7FK82`! zL-b;)^S0$;c^@ga5AVOXkc;P)Nv<%QWUk{3Y&yrLX`e6WyS7iVa_@V|{9#%1H4o>n zLM2Tp1X{dC(bQA{P!o2rE*q364AOfMf=00f92F!VXe*ij8~aDmgW1p_Az{W-FzTWr zwuj8FMsP`TEl&Gc{_FsW{g*eU&gnKpdo)S&>xSN-H}m#pD@#jT$HwWYQnTj?w)KyS z?W!altq5#haLLG1#Pqu@!AP7a3ghdfH#6}2T!np}s$hws%j413r0Zc%hbKvsr9xMm zqP9XRe3U=3Fs z#`bf6e>2aYJF_!8$$g(U&bhAFMVKI>`*h_3i|L2={grEQl)6MVtx^nM%$y+)mtrU7 zr+9%-+0FWlcou#<&VV~lc!Vh{jKac5e__3C_&6eAMJ0WG>Q7!PF>H7Fq|i?$Bp@Lo zVi2RXfLK#M9?QJQWJa3!;nXSm_xitYl5i9PcA=O))PY?_?OQYL`MjKR6ev$nB}mQ8 zJ~s-5Uuey?Ovyk+Zs{L8Ji|MH*MCj-yhyTiMgj<9 zUVnyU#qq6m{cIJ`_^a0P83CQT9Os*P-BWqOh&-``e7#&YhH|29%uXoD7jlgIfAOhJ zgsj0e7M$5C%DIz7u3y&MAA#Hu{*~LL7N!yls@wAIZO6X3K8y+uxeW(fl-<-^TE~`} zyt8lnQrcNd89>Nq60S@ZpJz`U?!@E6+b5FqbNBZ%VxV;%vPM>r`Xrh@d9xz~W&uZy zxlEk7nYu1I@r8$OJw2)Kw<^U5ablte;lZ+V$_V=i`yiQ2lyEC2aAQ^)%!4v-#N)bE z7ZO9m`m-EvG;LDG5Y%xIvjlzneOkBPOmfZ%Nk6?w;hY?uHcS;_vL0yq!$ z<5I0S(G`_O1;~N}NfZXL$>~ekQxX}e+(4R9V-gwAulY{yfRI~ zoJF!SLDbhQnYAjr)K^1;bor}*vaMg~g~ofqfr|*(=-_Y3(IgJypcXvH^d;qCO10w( zau|-q*M*Wj5eM$wizA-(0L3RIfo`j!|L4K|Og_j12!qAZsi%(7yli+=Un51N~>FRlD}@VQXLk5T5(J`b-Eo%qCzIELc=?WrYk1wSxt24*mXVlXeY|4%FLulaQWi4Z_Lp{^+0LPEdo#WmrnM$|2O8Q83p5-PaSy?5|4LXMH1s^$FV zTI!8g?Xau4^llx#(hI>}IwA>Ru2@)I;*f|ZJS0(K-dVKyNwFcEe`FHZh0`P%tPP#k z+CHF6&Gg56(Q3x=`ooM8z~k)(a`Qqm+}*`&z#x)KOSEK6C#6^O(ATZ5eJ)C;`rJcH z6X}CDQTjJVt`tm*m~n5a&e=0`5?5~z|A}cm0Wumt?k!t<9`i=MOIa}9DLKp=ku{n; zIMP5Zb4`CKX4-5YQ_J_`YQMmHu8}chN7$Uf;;JlOxJp^b5RVv2`!}iMe32xIC@QkL z3E>0EogN|=nEq0TS2`_g3IUtnWCKGjhyCM|leoOgcqG`HCM$Ht@6-hf5EEZ8D0Yt; z`GM$O@o!grPy)t^Sg2p_dHj{QcKRy|iwkkCLUzD(f|mSfI2Ld9?$dGbl6Bwqe$uaw z*C=4NUb@8Kr_y(yr%KM`NmCLXdiASr{R$Waqw`|Hrk^G?0haK!pRn!Ijej0^viQ7v z02Ov~OUwSFQ)(u!~eqw>7kigypiw&c=uuU2o ze~oruLtFtPM-tQsT9T@C#)`7S*g8hhuyGZ2>7V7b%j zHh3_xS`^Tg;!kvzx?OJD^gC?6K>;q}))$|rBN{-r3FLm>|BL#P)`-m@Pq{=?$k}ci zr=rB(ke0tjDD=qYFC}*AP8VZ}6y{#+naAjVl zO&0%qIKv3{*}ZdseTS*b@qb^W2YbVrUueRN83_Z*la=#_>bSA1RcI`n&xmGD+sh^5 z6o-~1nchQ%2JsvYBCON{+2I8SEjBhLu5a07VvESQEl8K&t%YtL9}-*qL4_{TToabE z=48nDpU^qCRuThr)7{goS5C3?GbVW~H?a1^yG}%(Pm|e%es6QMAf5bj()x=_vhR>%j_F+fR+# zgpZx4evmqk?}{nLMaqS0WfCSlg67p5In6T@#+Q>|$Z_0)k*JURkny?(2l0_Tyh@SH z5@qp6cF2n{Qz)VURM;|p;_H!a8pHQs`C7g>je%yR2Sv3=SM=|9yAG!M*s~G%zq6)X z`9W^-c2I|=LMw%07DI<#mTA|b3HF5!;Qx(NFTje#UwNXWpI@@hjRLgd3S);=A~1l} zWW2TGaGRK`B}*nC?2UX0T#P2%N*; zybhJ5mmBEU6quC$>U}JOU;$zSX8iA%maIjNzb{O%VEg-ub{1!*?Mhj#RBrbR@%Y2GIsp#)B_GM=a?^Q+AHJHN4vWdG|709gjzWyJYm@HHpGVtc7Am& z2N7Fu^;Rzv${QsWY+^ryDFt1G<*DPP2Q4$7Vp(P2|HvS+V4lc?F~byGfTX_};f2x< z3a#Lg#XluD#gy9HFuKFk<6V%W*9X%gFn_Qs6i#dS$PWYg5+9tNf6v*TjrP$EmKx$u zwy^I-T!=q5i!j3jik|+RTDi7Vhe0%M6HEsCC36F6AWmpma3OCBR$o$`l5CxbM#26# zti4rHLTcB`JnKQelAt29(g?3L@ff&-JpFZq)m_LNj(sd_=aN*5hJJe>OT{C`yiVIq zPDrrcxgtm2{1)kjmaPtr_BoDTqnIVnh8LwZ(@pTJfaCktryt5c`e-d9j|Qt04@pat zYZAM?R-8*a}D-Gl~r1Lx^c;{?M}|?Gxhv= zgen{i;q(Rdq&mwe*8mIxxy_ZN*52jZs#kE z`n0RiKMFrq=**i)KHse{p09W8IrE{t{5Lh_N)voWOQ^T1cgF@W1sS8dF02`0Ue~bG)R}f#TaIu27ca8S) zraJ5N_2oXZK6!1iXd@b2DdWaO_W~SCFVg9;nfWh0Q_I>bIdi_5E9*(-QNOqJAqUb9pRd#JB*pKvGr zu9qI>Ee^JzyJNY5q0!7N$;6uZ?0skG)oqFy{n5>2;>W&N@yt1WsEUqE##4O4Qgaww zIYyqXY`8!!_Wh6>c9_*${){nw+T*6gRsIf1umJK#t~xAwvKQ+!jDT}5Wsvi@QPX60 z<79xK&HvW|sG3P_pw`PlS#AJDf-_$ALp}oxkY+w&QIwFo5Z*y@7*&J?`>lQ-FQ0(O z`+v>};5A;@@cN(S?fZ9E24<#|Ffb94|^Vc-hAFdc9o${Kqn?u3)SAq~K|9nRIz?=p?3B zqPY>joRew0dk**4Ngid>v`tU(1qZ%Ut8|wcCS_A&UWg~6~SI!${2dkSby zwcY>=%E4XKm~83tm#CsoMe+G8IL(9c4dFLG27Y#88%b(y_e+{1l#i!q)ON3yGo>bD zSLwf^eg#T-(H6foiD9O`xxhxAec)5{{r%`ZTZhjh$J-;@{xvo=GvzlpszPz*T4NhV zxfM{hhH67haGA)*)$rQw?W?q3ozGD-C3~~ZwwyZp?N5M-DtY67RC~g=2wg&SuTY1n z=h)o%ZeR0A+hJ*1l$}FBE(M*V z`qxVRHHGU&6QR$#g~1=2CWv>`@E5t#AFgiNIFjMq+o2=jQzE+j}+o`0CsQVAim4$Y1zXN6I(Z|6kJ~ekxAp#!);jnpX zeQ`aN_|U?|I9toarwRtfTKA+KJ42!Z4)lz8%m_@|HaYC%8gZPo8bONZg5Ol(;L*_O zp%73eo+wpe94n1D9H&&V%E{Ov%##WxhPdgF%Dr;qtlQbOIsDB*LJxYJtX6i2J4kHo z2`2v9YVs^26q{Pu?;@VN>6}zrS}*0PQFxMMeWyQ`Z)C8%fB_+#9BLWV7>g!RI|>K+ znD335Aqkma6yT2Ju#;JEwaUX#^i89HBjKh`B z2cHSPv(^vn(jgRcO%pGeYRTJwFzZ#+F%9ogN6IWbB{06hBUU+~+kO>Vku-na@dzN~ z9}jbCEj8EG)2;sd*U;T*;2M|N?dqn4^buF)cnK+fFA$EY=aAnGt_16NIm$@(hcbz! zJTf4S2QqIi{Q6#Kk?QkJGw3@TPcGJ-e!F)Aisq4c8il_d9s5T!MZh~g5=IsF;h0Z? zj3!6L$@tJyHAA~yntt8+Nfl&V5xj}l61-z1kG$Y z7xU>o1_O>5NE*mj9nx;0wAc3ZrT|<}v+nHk+4PY@O`^|rqI5uNPd{_GiT<`EQBJzI z=P*!ly5H~vA#-7bMxbjnLvOG3>UCp#FrhF=`2>8!UfEbh~&zTbO8RX0UeZSoHTl0I#OdyH)U~B;@%k zWT9|JhE7?qejfUH%8%qjc^DdvA|gZ=F&C`sr-5SgQQNa6zw!!7idq6B)cnoBGNLzs z*gcf6@^=O6qc@Cl6bg~I4Pr!srsczrehO_lNd3Zrx0uOe_$NX&H(eUxH&l$xVj0A6 z*eDWck3dWl)~JeXf^}30Pe!$4c0fp9x8JrUYd#H3?W5^p)ge;W=n@-EKyXyH!|&fx zYRRm8UJ7V=-*Z3cgffO9K}X{`>O{2*>CF zVpK?`WI#IdkAl6tCtKPC44J@!|AWb6z-Q4XPy8bmqR-hEHWYjJ=d(JPan&P9^|Bdoj_?%wl! z$++T|l^tn#E+@=H3IFu(*S)`It@@_Z@kMrDT%G|-NbHg=pv2y~yNmh`v_@8bb?%*Q zAvdOuK#OQ=U3*!A135xhzYll&?Ej7Y!F)Lq|9ATS8Q^oo&KwP1PC8oa2o#`}FW3mN zMQzufKLaT;zev_E)?7C(qu(E*+kCELVqd1QpAYNYD1V3p1kWuYq$OPsK4{-?=H@g9E!IMkYrz#|gx$kU#e=-j1fhmfZp&UhdBqU8iHg z-%;;hn%?gW9)a;oMRO927DOe9^FpgNtRQ~{22YWD(l`W*XGL!O*l_axJqEy>@jitS->eDh~Ue`i1&d-_Ej+1MsY5s4jSyIhi z;+sFMVqiW~-d}^A+p@1r*V_H6pfGx}eoCfUTHF9egoHTxK3EAWp~N_Fa@;WP0RAUN zb955~Qe(CJgt^ZJQu$mEk={VkT=i}hy6FDAdff6R<-n4@#}7J*s=ujFRZS+7_>3_U zW#8(#P|J2d#_B~le}Yd8T3SjFbN(2&f^~*JN*Bo5$ zyIxPeoRO?MI(d(H0I`(XtWTsAv1oK)u&U?xT#>FtF!}WEUOU6+L|(zE%YaXl$#AX# z9Zwq}_g4k4rN?>`G`2F@ ztvLK{h#hB?6PZEDIvq)3&K3xT*kl|kNMs54?(ZE@%q$v#A?%-Z5W}g&(Eo!gu8#>> zVHeULq)DVqf^ZG|uw)mf93tDFIuISj48kLdCtPaxB5Rg!X~)tUkI=Prd-92PLa|Yp zl^faoJb!}Sw6LJNrdzkl@b`aI{SB{y*6g>Q5TH$bb=B+8i3tjJ5XvBZ%P)ng7TFx`lEt77kW#xv1kz;VYy-PtYJ1f)-7wb}-k&|jMe0KoRNv8_$A zEpQ5_0CQPenL2=%=8=XK>p>cyJ36~O=^$7=43Ahkf)yA&cu6;34?XXpS+*wKT4&a% zOYKg?n=Zx=PGq^cznHp0`;@9C6L>a=j#s@y`N>3w{_xb@Fl_&VS4w(>VqFIc%Pw&~ z4>_;T>5gt`zptS@EO@-OnADJ0pQA1rs%{pBE!m2P#^p_oTDJ+>3`ywUc^WJC+Wui} zG;L^x(3Y=K4l6EDsV^X%qF2E9DyIR-5t1N9YdPWkdUUhy$G~gD2n0LER~A-}qo3g) z!LgYVVAfjtaWM}Tdu% z0gj9XBg~gvU0f(jmfr!9(Sd_GnXn-@%>efRcWPCA){r;9ZADE!WyBiu8HM+TxkB73 zT0d<$28^r~hnZ4NoYC|W5$A6=Ls!1(yH7j2TwitW29g?2E(I{id{NUHrfrY$bAa%M zZ06>cj)SNDs3zd?J2n_~XsV3u|Mz!j#teHRCDH7xI(f=Gt~$RKOVdItSvEe;Mj<1L zw{hiw?=$aow)~P4mJ=k8Hu_1QRiT{mZ>R6rxz9bX&-?R+ldCI@UUlqf(ykDp);}8? zrY#ErNv|^>U&?~sTXQ)hByT|$XGZ2|g@4&i#eCCi{O$H`?qp!hDegF2b2X(|d{Mf6 zIh#IaOvt~^glPcD4JdJe*-a9sjB4Em16{BcaC87bZFURW0Hvq?rU+NR1Dr4q(7u5J zEzBC*wLx<*GA4p8p=@@8*P+942u7HkW%GFt5xfZTeWTIO61*Px-_pL|`^fxq()qFh z_Lf-q{ZJ?CCGaB%{kzLUO;NSI0j;bOrbw@ZqJEyEkiiCOa=YHbEyl>?C=6Tu#t7V? z_GCB!$wC$MnrL+ubl@Ql6Rth(`$&2`gvU3-f*}$&F*oQY`z?`oCTh=GN(-xp?^-F4 z;&HOBA42c0&`CYmQXYflqT$Iibx*9OrJNYV@Ynz;Egzf+h|jchPCnbSUB?-$1aFoS z>05&Lh(anGR!wM^RHTY_otEe~%J|?#nF?30PGX(DYX(+-@PLx1^P6DIfr zyV%kh%r-6s&4x*8wYBl#z1Pc2Y9n!%W@Y6st9=eKxSR7asLpYVdAnwfR!0zv<6?&) z5;)WRFbZ$?W6}-3Qu@uSq;fFiXDGbUeTD38Z6Va`2Qv(uoS%FSw;so5|6%G;{Tl^)=|2fOT$iq!6Oiqvr(hl$ zQWrf}{A)NtDU?owI+%N|L^qukNAtCe|o{;mRrvPeNiN ztR63i-lo!^ef#V#iv)N80JlcxOuroiOM-LjxUDTnR84Aq^v!M8p09R=_~GU;R%K=S zmLK7-He;&zz};ie>rdwVb3Cj2FF=PA!uwUy>SI2dRDVuQ9EBVw=Ub7-Zb)^ z8)QKJ2XO4JccKOL?~1OfljfHW$#JuLbnE67ld)ra(Y`b@2cxGaKdEWOB=rC07Z3x_ zaetD|Yk)>?BNFthS1!4a&Ey?8^K6!d*Xo)?VoeuLEO8E^h+8<`E;w(*yg#>jlHsOa z{Eqyu5sgYSbQ=AU=*!RR@iEKSx%{81g=3O_A95aVr)hoXpnGR$1d13M96v>iJML-?Z@GO9zI??#ugnAtH>v}c678%$_2d_90vR4 zl2nWT=O~Szfw_k+ef_W(d#WzZG4zMduK!Xa*}8yM+BvTBl!$Y;jc>HHWk@PusneJN zD>zq>d4#HrQrxPcfgUcg`9*hKZo0&h%0MuffhQ(b*B(<;xYUq=JCdUHS+C9`QZSTU5&di;alI{G^shG~5BMo?fvb2&R#WdFPK& zS1VomU(u(3-d!|7oK(wrA}OImaS4UAHuLE=X9j{7D;sY~8dYan4EwWkV_u-VN^?Ub zGAi){DW1VkcV5EOC6nY~Q@rpatkefN=Xjs-86}hCsCG9=g^iwHlY9=D^mbXI{z|np zmX?DsT@_aw^1gmuo@*;xitmEiILp6Y`^QVp? z1{qy@+4UKPD0dZy`zPck*L$z~*Iy5BAtVnc+3!8A**@EAtt3Y%%=LN`heUSFp)Zd` z%(@$^HO(Dn9n00ry6{^R!zteO`sAfQ@=L9s8~|5>0#f|WSo*J&vHhFZKO8v9#tpj4 zIIJG(Jf8b)n>Ue+Ec)Wo@#)20bPyB_p3tr4bM0_QFKn3eWdA1O$l-W+f8Z2C8OPTn z+TdJ@&k}0bSOq!v&)qfl+fD>UVLox>LZkJNX?87Adz@ok7miC=VRhVw1&xys@M7dt zf>@Z+K@`om_=GrYQT2kXgDH#J!K%k6HPmF^hgU&_8LRotm)-;B?8lYo&da?S+*0kI ze-92U_OH2J?_FP*QGY#beeV=IdJph@zmA@j>vQBdxP^YYuR4D$@_qWmykgOoU5p@B z8{XFfU<0md-+Obtw>|10T6mlb$YkNP=Rlm^qjltP+|HC(QaZQm%BKMpg@s$)4O=%i zH#sewjAaTlEeEcQhnGi05cM$RqZy@{5@O@CuGFcEXTm@Iqi6lEoN972ql>njn*4d^ z^4u_`xc|T$l*`IDEfcoeh0gK-K){};&szvPPcW0}1fQEJ&T{@UhB zB(_}thpNUpd>rLxCD)P!Q>;T`^-Nbe3_@F5KSuflrf$5nR7i$_(ikpq%On1^?gL$E z+W4QRVZXU$C@8$RS-vQ0YKUxV^y8Q)_j(Pr)2J?q548eW%$;-fh=@1cG5@kRyRQNi%%bMMn6p@8?kQl&6k%{BrHkSG{S>y(hv_-Wu)8H)zxo%QPzD>}NvIcP z0g5@j@yW&>TmTRax!)I|aMeGAJEpu3n6}|8o{9Da0IH|aZOu=*!DbGnsjdt=637>E&AahA~>Op@WPX6<2$3%4aeejEMCjy1+(E4S=Lq-zH0lqoZKC_?O_NcXChsW%uK%IXbhNbrW`wxf zpMQPbp!)zdWJN=DEG{}b>+mV8&w6a^lw-r|Iyj{1m)q?V_V=pF$CpR8iEM#M5>%pA z%=7iv-t4y<3F)%GE&6PqB?OWGl3sPX5NNs5gtv4z5AK>;bu5pjG7@|x$+icAg(Z~K z!OZ->^&Fhqsl_H-S}oE(H!}N&;F>4z9c24%?}T(ZSnHG)Qd{*s-=9mttCt~f_}+U9 zR5J|B_yL+HRE*3P+Jy&1BR5DTy()dGt|1<;d=chAJOkk4nT;g+`Flojj!i0wuvbh6 z?}t|Cc^5ag=&JixhO+qI!2rtHujjb9$>;7!IC1|v1iYVmS&#s-iM_XXkZGah+3=Aw z)tKN~Z#!Kt(;m#p53Rd*8?Xg3>vZeN30tI-y$(pI%*T zDE*hg_0!n*w#U2wP1&0mG;Hc?L`e=?mFVRT@QY$qJRyWn|A-|WXF}pOF^hJhl8cy= z*MiY`*-y8+9GdcYv+~O>!g5cT&)3)^k>pXRNcdj0{OuS3%>Om1W#+&uO-U57LS)hwxug|I*+5wgnRD~t#SoKQ}^hwpm$X z<)GwCO)WL8E|$s6C?va)Ln4xQ^OE$>3Ftq5X@!5_?0<3JYhv}GYFer5<$7mG3oIpX zp-%zwJ1*7{zX}SgeIBALMULdevkL=lWrU<~aSas%ct>5mp}@Vl*Kc1ty*}&;lv;2| zTTy@CXUOyK$>PPxL?vXQ)^DRdINN*wr7mbN;0W(^>P#vV?Bnp~h1KbVDCote!v{D& zP562;I}QLLQ(840?tMB3+_#^^t$v=LH@A0eovt(){~`ROjos$sHUiy2^y@u6WxTI4 zsMD_c5X2}AyzGyH?^W-zt)Axpbl$GceYdYefNgfnre*5#@iM4175L(%%80?+>jY(i zrX8oH9ry1~baa)!&M0m2Rb|H=xK3&5@nN~YUmnj9i&=4Hx$p_LUjX4FqapVs@aW}q zk3eq4noBfiu!p)-OGY*qkjTSbCX*DwZKic`^GLBnS;+W(D5LR&5~hS6VIElWhZa(fkAze_Y4lu$2DzETdCn*AUL4&Y-s&{nL5lTA^DEjZH4I}rS zo|0NyJu^^=qG-w+u!2-;fQ9}3TyS$$R46UNDtArL5cs)&)fz3`f zLZZ}@Oq}_{UDzrxAK$x2;RAnJ$#HNYw~R5xa6-Zuc+MK&^qSYKRs$1)t+DT`tL>1i ziJHd$`NAash4AYM>h3OF@r#*{Ar)-duVS`Sh(*t(4O`Ra^{HUxvZU?uhnz;OUCR_= z;L=hq&Fp2@kUYzhqiNYtg3|wYqu;(g`R?@&1*!*VI-U@!kEqEr%(^2{TctoQ5Ru}Y zy#Z*!Gb*59yq>5py1OzgF7=M_%hgvgpWed#+nGkyJ}^WlRPNn8`tFS~66i~gl?Ya^nhPhnPvVxaFg?)8LJLCQlZ zi_89jM$Ud6C!oF$Cf~vxsXzSOkyMd+%60l!50mTgyh*nl7uZiQR+HFwH)lR}deQ`# z^e$h2`3?-+3(6$lF9=>gUegG8KL8nZ7I;xN_&bi)3Zp0Za%>|drEIzYP*l1e;MP2joXwQwSb9~*y zzHC&?!XqiSMCz_!q8KwelP`5p-{a;qmix^c3FpM##JK<{DlYu~_%3b9OMHPx7F0yb zFy;k)dcu}UZnM27ijEc$w!Z#NXr(60qpz~QYVRE0cWasgG7q856a2!q3M4GW^`aDPUg0h+KCSkckh zQgl-djOk_H5|o#?eOka7NeddI2W)pCpMcGcQhbQ710ZaTc|_KxHQI1zYIABVtsiP!7Y&^kERb4K+G3dI*nj6Jzs3##P-dp( z_8k&*(5Tbm{z`HX7jS*xO*51H7yAb1HoOP!}u z7)rJh&IV^KVbV%(Y25g8Eb@rH3@yEy7WXk@C#dWH^73A?-!MbgqE1H;Nql`KiYBt% zygc^Zc&2_6w-#CC|HoKdN_~AVoe>XyHp-w4kGu7tI1iDwXZ``(Hq2{+9q)-rzM_^*6IpfttX)l3WF%UDY1iS8T9Uj8lfn=T62>ELQ4 zruX{c^kw2Tt;*om-u?bEtd@ZmA;5PPlHEvK05=4w`G?A1Y@zIB+9_DO_7!*yS6X=! z=oN>74}cdY`{*eanoC7B_I$5nY%4_Qby&R@Tv{)>|1UcB@KY%smrL5%DL)`_{3O`E zae4FNU&A(^9tmTnh8(S6z*YaL2pYTR*uDQ0)$)_;H$~AI#keN`2I^(!acSibQ5o2B z8$NR=E=90I3|3lQG+R@guPdMRH^RtTVnIr296UQk=NSCq!I@sOY%583)#kl5k}MG? z4VbMftM-KB|J*II%ApiAz_^(8D`}}Q;L4QOAbEdNo`-%AL{d$xUtrb#mNIcb?mIT( zGF3|`5)Lq8GEJJbYu4f3UfuW%!~Lgc^Ra65Lhd14Qc8E!K!PHnoMf!SRSG2EYM&wL z8<^4U^&(iK>T7X$T1Rqad392crhjt2gdO|uIs5mgERFlBR1T*oyKgn^J8;}X)u(-@ z>!Y~I=~SlVwm_n{3ykTM2cIpxPfM`{ICz>sT#&_uMw^**`mWl7;PdKk;LRoz0JGch|Bc>bL zbJP>YOOn`qQv^m58Zusy860<5uzgTS_^#y zf))~<14BU{gJz}l{^Vhhrm!8A(f`mC8y5iQt-fokEGqL^&_UEhib&!A9LuVq%@s>t zRA@3?EtXbeN9+->aeoZAa?Ur1kw_T6SVr2sJ!_jp#huw@UJ9`I^8R=`Qt(cN%=LUf zzF2JVRr)x&JFbAqJZ0GNAI~bgGEPzp1H1~vch!L_68yML@Fj%*4lMukMXPRq zB$=3*nb_`om_eU|BxZerWa8(xx(N(Asem zDIo1ghQb#hK}kUs!^2w`5K@D-2+I0=G6EUB1#*l*{1c6Z?+gpyY_*I>{Iwbk+m{u; zQ`vcLIuDz$ew+T+(ZqoBZR#SL!pyyQInJ<+uRapoli@_kzO$<}i=2KN+`3Q&V2A#% zf3rX4I%*zaEBfyuFXbyhsDpA1!odrd;Qs!hn&yJ%wseY@VZzNV6x!aO(k4rMxSZs0 z*r)ZA9UR-pJMBv2vVyDZh}B=KJN6+cJgerM`^@$6vpV4PD>O1r^AgY+l|6Ky^2}rvy&gg+hePU}6WY(EG8u%YUU^ z%t&5vfI{)FY-?|4XdTdJg&3)~Hv=~k?-|B#$@@d2@QCKgP0wRsVYFF8cRzennrGsA zdZT=f7GZfmwaPwkRYrN0eJO*#bUWMXrL^$(=8Wov$x!t?en)MMI!q$xxP-ScPZ>Bzeky0DBrL z5;4i0a}Ei|!grOv{74kpJ%hT|cg+#CL)F6z6OD{Nv`Ygak<#{}pk=IHNnlAM>ZPu# zr4N-xZ`hxW9@O)?s|7lHu)f`$T*=8d!y?LDG~1D;&2ZMH{?rK7*OIb&nr773Fz;_d zk9$#jWi#)B#S>;V9V6WP1ZtLW!NpjG+ME5cXhhH$JQ~GPbKrm`)RNWmGlkhAL!RHR zDbEULG1u{V+TWpc)8-}HSGeCo-Zzd1YK!I%BU~(4Vo&k zif&)%Xl9WE23qro7MYahoNyvIcrXhlWSbzg#p(P0d?o3@3&2%Mli{cZ({ANzZv@v} z5(~E9T7EzsgFr76Hz2JrRfQl7RbY=+mEc)45Mw+Q_Y()hyf7A{8*=_4{?4v0sAlMVUhVbMua2K2D} z+6N$$mlykhb=<$v=JCo(Mm4tVgacuMU96soMSDA7K-W~$CTv{=KSCL355SbCVx+{F z4TTAz{d?j603`R0|> zU6kyqo>$Qly30q$9ehWd2c^vQNZwTs7z~TVVerL3Qi1bxz=MI&!a3Ae(O@Ny;9FpOG{_Ja55SRaS?_|ZXF_65OxX#!e!DB zZ_&s?Nlu4v%rMyqp(CJPP$>zA)ML%V$@jV^WY(-Qzza;f5MTF!A4Txw%#@@?nM29g zWn;+2^y*42Mm5sCj%DWTEB{mGp{R_A*iu@F<7KbgBls>KgJEW+v^>p@INM-!^`YXM z!^N`l#aDZ!h%s}utO%JiS7+cvk#xt-VlYZOqD^$5H*mkf%;eCta*9|q^Wh*vQY;ey za$xuys{b!t&Y?UR16F5&Ew~PWw)Jsf2n7B_7CyW?>f*Sh*u3`3sx-I|gZTZ(E$(Nj zb+vl+=D31tU3fv_YC;0vj}2*9JnC|g^C@TpFKf;?@?Ic5k;-jEQ%nV$>pLitqG%`U z)CJIsgWFTqb(6eZ^}fZ~=cO#L`4#Phh5=o^W`#PiL*bloXt=trw)@0%RTQE>{em-| zCw!{<;&@lffP>glxnmFHY`lO`Yt!+b;NuGGIW*F30C<66!|JBq=E#9Wzm%5@07|Mx z1|eCh<*>xC{}7zY@(A|nwPtK>XARlO4N`EeROOc7mOL9^$L`$(5tJ)osVBV$aV&~# z=1Ipw*L4eBz7*!>oks;)^%7kA*Cx}zz5uJaQm%#sqd>US@rGgz? zSUUN*p_PPfnlZd9DrE&W!xIng7&EdbD8ne?WU&-e8xHVTA4{EMvnAX1hXB*A?YlQ@ zwYr?Niifc`p%oV*c>tqTv-Wd|L>|aq?N=G$g8MfU$q%9&hQtU7##lygmrr9@_j|OH z_XELUVeHgNU0lfI3RQ&Q27DP)ssdIw5qptHCWK?{KQ$sK4)v!}rqB5Q**G@FaXm6} z9`J=}tA?V%gDkD{B*~;lCEh&M5gR)h%t+XycFgj>81Q18^G}7m_z;d?(j<=-8~oGv zsaUA;_?zPR8N@1w4^I-$K!UBwh^PpgP%w^4E^Ln_CBsonby3W~h!=bFxS79)3Nl%C zN|HkQSTs7CJp`-7ubRj(%bwD+X%gJ!Vf5z+LK+ho$SXd3*awaMcw3%JYfb)DhX5P| zDW*k;wI^U)cGJRff%$HRTcP^Z0=Ze;(GsU|a80I5)2Rf(*2-%Cv&uN-Hn%is%GjL5 zjN~&vr#lfOGXKMVKp9I?E&E@qKrE}$a4aIjltRBpFL5m#Bok&fr!uxH@t&UH()_Ci zuwxuietbG$e)e+rNLX@YtTVI8Up{%#cfquvbJS9{^b8xt4i^$unF~Zal&4XKvoza% zC1}YgQQ1p55k-*anY1$frvQeAS^dGHdS!u0KKd--q96JNu<(U|;2CCb+tHE-Vms`p z_^gP;Y+1Oe4?bwMDf}eQ@2xGN>MSTNDZ@{1J85a@0LI8sdmfP$))@2~FT1-VS&b(! zs$A()qvo>XPCN}>Pd8zxBmr;GQWPa;eAfZHX2ThQa?!`RDkDzNmy1}do9E>|om82yG-tCCEM{DFl!{&}{ zYv-Gt!LhC0E$3}#Kraj=bn<5lzK;65`=8Uqebfo>8PSwe!j@!8BaH%cjN-8MTghKw zdT_o@RASd}q{>_^l^XFBGmxasP^Es-T01JY@!( zoG7Z%tmAmo00Rb6z+$-0oeY=ou~m}H-oQetrm&*!Zz<)r2{k$oPx$ePW}VX~8vMHD zRu>LE&BC&Bl7#wNCBrJi-MVIEhiJa?%ItqsDf+RRp|N+9L8Q%-pq%l*EwoxXTC==Z z2GM~STKK=D*zJf>XtglRgV0A=d>3IuZ#wFJsSa~llyhg4gCX-mT5;KP&U>@i~&sTI&FP){{c<-c^-*=Z5`b!0${Q@R^F{SwzIPn^s;)-Kaj^#Pf2Rir498G z7~u9bsKc;2Q*nEooFhi?b@~4;YQPu6hAGMwBg{k?a&>1XI%kOrLTqKpz1SGRi@&y;#|@` zSbF078X#zDUs6;<9`ow~-k+|! zuQd2U?Y7zY66j>AW@ERv#8p25Oz%EN`WW&L-de%0eThysbOW*FNXafPj-%Bdi z0{AvZFuh${xW-JvEo;z*zI`~(aP$~wRQ_nLwp)WLdXC?MX|jN^N{RT3;)BmmqUyxm znR}?@#&33DEd86O2WU;SS$8h5{+MD?+9uCgPmY3bu} zQil;K9jisAU(tn;3WY;N>Eg#Egmb(IFg_GefCe3vGNaYJIpL+0^Eq(>b`1u0DboW6 zcL!`)MH3h_r71%hsDnV*Qtx|T{zq~;_dM3Cn&9s{|vbvoG} zF|{x)7XOI~AHkbZT$wi48@&;qXAu!lHe;YNi{yWr7bYkLal1;1Tka+svD=~-Q5}(* z*tF$)DX0b49X2V{Eu*?lJE5-frd{KRQ9sgki9}0lAzBQYzvj!;3DcIqkOcG{Th1bY zdk%5!=pyjc0)Im`GfJtIw(Rr;((dvS%$v0paex{c0iZ~|2Lm+vE}o#SJ$_j&EZcd& zgnp-UcCOEsT}1|;__vh4v}HKo7Cuczv|sAuX}B^15EM0d4@7snAPzjY7N|25jy1QWzhH~hkyFpSK1nKS$>8>H9k?uyi8!2h&XaAnH{vTjo z&0c%o_jR4;aZvxvRNP1M&g^zUclCfcarY1q_%>+Y{Mt~6hzF+#Ts~so`B3uyb=6UE>PN?tP0xW zsrw^L9CL*a?$DocwDq!}4Ek9a-`}E%P>&_%lz%AVMpN*ao)OO)fg7{l^7YJz^fdNx zb)74AN@bA~wNcU!^B7qo?Rp3Q1*SKrl@d^EnhGj*5ZUZ(Z>i`9Q6YnvAs4@;3{(ND zk|Ze_3X7(9>3BYGFa}=8hc^(Tob8R4z1j$=fZ(W`m%+Ztg7B>O5Vybhz33algI$B> z5y;7$K8=kQ!ZyismNF(8?fCa2h5p<`w*|i}Pi?xRKby-@$hz3n8qeJMbGiA)kOx{j zO}#1)*M|X7Dwy_8xeO$a7cY)Lv)3BN5RaGV6CRUO3&xzn3LZ5=-+vbbKU2Z)N$+tO zFs!ET6@^QG8|OQ!D6xDOgu5aTNHJ6x0ahv)kX@0PB($;D+=k~fcB1)OpacEpP$V|T zmLY}ya9iK*XKJ&zfuaW6zet;?!1KPYyTyO}0B->Tj9(MlcIj{bBaF1%xcJDSyH<&B zgI_`*V2{4xEm^y8nT>_HsUvo3=_xq2xL#B%J!RV29u~)8Z%gyblK#eLydDK#mF^RL3i-IP#Wc{*>xb5!B z17OWbh*YnB{5!y*r^1*d+i%na`6noh<`-emslimRV6la%tQx#^d1!JP66T~v_g&^y zX}*hq3y1dyJEJ~UC&o=B{`-Lmvk*7cL_$glm(Hk<28ZwggOK_B$1qpBw~#mLqvS>D z(mNmN#cpL2VW2KcyV{_Si+y82@uw-~LCb~uBaR6~n1KxC$yo9;CZAQ0`FAy%L`egj{T)Dv zqV9SBFXZ%;BhC>JN(U=o<_1ti<2pP@S}^Vg`$1~1=&e|x??{I!UlY7s@JV=;WFiBf z*)xdmGIlt8_j=xfMqY$BvGi@JvzRKVyM$Wua~|X7sJ?u+za~g&&Ydm}i!YsK(;`)n z!o7Ba_dQ$5(0Wdt6j2x)Qra8qX?w#TGJze}iJw@RTL1L;-)S1N>$y_E@8=P5uT3!X zcsDW_Q8BcFpEHf!MGQPwklEcc^mop~fk8poDx$^GYgSzLjXz?#C{6mBtrA8+XzE!0*$oJ@U}Q9Z@O^LjHh}9};x_H>#iuL=zWGAw zHI2cK3cuV8@G__*>tbQ7G%}f(qu5K`-6@{*^GklpGD#|OCZh-zQYV~FNAbM^Vf%L) zH73s=!zb#0{3x+XZR*8`Dh$MJwE{0eU?Y3-x~aY$tl;-v++G1^RgkZb6*Fl}bDA~N zmhkf+Kms%W^GZu&VH1r9w}mmo;yD4IH0SfFsXfaOQ9EcV`7D)f#24mw&i` z3?+5<=h;c+j9W+ay6)uGTbudyeLlx1K8`d3OHjoyWsMBC3;_sDuTKZg>m$XJN4+GGPpSDwwL?svnT+u)Wl=oTd|z%fx7L69 zK8IBng7uhttX(l1n;R1={W$^-T3}7X;7ShOO7TbA9VMDZ&tPO5l90e;-%^G1!u|+8 zp_1ibeKzWUX9^(x&qpOnwU=Q-X5k|Pfw7PyT0}H413mHXC+)u)R^S8`ayGs<8#U7O zzSSFZqsD2^74Mx!%Ci!BhZ~5fJkt0VD zMfTl+5uL$yHe-6 zeM|%iGV#%rRwgK5o-9FyUO32NY>Z{vSppva&m!jpg*Z1VMGx93|Bff3n_RVKQpVO_ zID1S~ewPN=+kke`y(l}3M_)I2Zw-ANT6d-VCkY3L;VY-jfZCns{TDyy07Bqf^|T=VR1>^I!E*m3l85ft%S-yfo@ zUnJ-iGp=4Bbdqz6XQZ8Q`dYO+NPsLCKmONJ2uBh)ze^y;qnTp0<3Hp(yiT^1nm3or zXDz^&abC4ov1^_GyS(^%($)BGT?pW@#`Hyz@dDixK_T|lvWB+Cb)frDI`S5vq#Z00 zKi@zcu9=ksN<`k2?$Vm93v7=*!>zM%9}$_W z*L<`ib=z>ew-@^E!%8`RhTx(%`|`Jacw#Vjebzi0D09-r@o+6svcqh?kiz@+I7ISq z2GSiV6{nYAP{n|t$hk9iDK(xlUG}Z~K$sK+6I;HM4=&+xf~Kpq^dd(8?Sy$*Vr^Ry z4nM@nKpHMO60%(ot08G_#Tw6>5X|gPAnZ^pKS(3hy-M$fSGly&T5TF z#$KPa>U4{%^H8(PNu$?gY8t^$ZJp)MY6;PzN}YtVQ_h@TbjoIkU{@EC5Nd10a5sig z!1UjL7yVt!X1(_MjoM0yG%hZM>9($Giar1aIEXI&Tzl)^f;vzF1Lz0905C2$s>igO zFQ_`TCnr7STdw2MvdG`lsZYnG$G|GMbs4ES=om79?H5dBgaPF(&I34bHm3o%i{V}s%L;##Q)3G^>4_TD^<8ry++$9 zs6DsMFvqsK7Wou|slX{XLk=k&U(?v4qzz<4Y>yX)(Pa<63IGtFsD|o7M)dFrj_}X% zu~-;NEoF7nbtpf7oAgiyHOMp1+l5zo6~=Ol`z=2E(40 zQi=`q6MGsC`yz5E6DiW-sXUg0XI|o9Gp!+FF3BM@eq+myu@6o4_z?p#A-X80P&6?@ z_Oaoh^xtbQIzrN_G&C@~$z>ea+(Cx5<|@X2V;?ota@e_h^_|r!UZAste|&ADpnxI? zG6kW$kr*TVIFKYxriPwCiQl~;C}$BlKR;b$ee-Mv-CQ1)Yz?Dp@N;UZuj(A0WW_`) z4X75Ux6jS!>Jk5Io@+`aoRA{4;vusm0sqYfOh_KQ6{l)BaOGwcHr{gu=mro5_~tsB zUKJC$(3jCrsI3%E$=GU_qH>7S${B%Xz;YC&F!_3JMYK{TXA2WpEDD!Wv~kx|arVjU z7maD$iD_x-jB5Yc2Hfthgeq5B3~GeBKzO~Hy%X!bQr#xzxAw+9f>?&Y!~CPR7kc`k z^sFT3NHY@v=InGIuV+4Z(}h!z5%$Ie1-*`>lj*xZ+s<60N>Vqhx-Hf7TI&iTbA7l4 zh9{<19>|&8J2b+?k2m8{f`TCwf4Ziqy4I*eDF*I9ozjaWd$+jXt^V3$1sa^WiWpLq zHf~d3PvAJvnFjb#DO~YHCO5leFs)>e9QLkJmn3itYE^$5opR9vf9Y8?`=b7Z=jAB!ml8zzt^SenVVMXNLVk zcyTTGZMzz2DFK*j;-PS0{?}WnABgG)0^PBMxs)>PEoH}KSZ+A2A>9+omayBS+wdK%d*1?2xd7dyz z?vsUrd+92oq=E-V!z_Uj6&k(p3-44Wpz+Wa;*b}QWGXtiWl?GGB3IVa;h0J_Tcyl@ zX7Hwm6$ia>&Y9VJD1cX5D?yzX%+`Ua`|W(wm%^iNe@Qei&)BktChd3X`H<}B=vZT0 z)B0^sd09I$!(Dt`9K<~~J|z$}FfnbInt!@7arF`gNv$xbF6xnG{BRW{boUSm&~B|!yj^(G?iahFXrF079+Dv?QjM0 zXPsnm+ysRw}j@9@=a;OU>p!`M=b=YY>` z^Hcxo!^7(7W|YsClc3*wl50ieJ5tTSDWI;uik#1c&v2PbpvUm?OJzwLh;D)hQN1s^ zS(Vf=>eILmE@1^PS+u?-UrJDX!YK-&#x~}{%=z@kBWNPSc&<_n2RdGlXeR*fCDV23 z3~~MTBp+w`E4`w%?_}((;v0-tm$c8XMu-C|41RjV%1m4OVYr?=?+Bq=uwQjKN3R{f zxu;M9p{~5G1q8mV?EFC^*{-oeRBUflRgv0^ryWCsx0SyiY21<>GKP?%M2(`ac?Qv; z7M>SQ5|JuLnt^S7Z%G4kka$L_92cs>Rd0I-O9~iENel$sj=&|z{)UM0FU#P@Im=W- z!(Zgz(zycGjG;p3o$%1f!HBo|p*VhY64XSJqhIPLiJrxE)@U$8!q_Y4wybW)X#}+1 z>Bm0X)RcK`fpJQ7Ag?%!k)`YBgJp`4^9Pyc4#;5T$Ae@}yy}CJh?k>sYLA)~7(0U$ zLL-rRd2CYF2N+t}bul@hsj`Bk7j!3mTUmK^8GRPzZ`ovsDw1Rqhg3(yWNLn4NzVOt z{^%_y`33F_)lpRm0Gh<;Nvjb6cc!p@(}|bWBs@$k-?-oh;~=PPMr)MCR)bL;aKxSb zd+d52uNonaoiLY2NA>K8^&O!VQ92bp_zzD0k-F6n(N$+~KBP2uPw1%F;IJoW$5k*` z!IF@dRB_4cv9s%8Gn~iy;g@CW`u364iuZLUK*!c?bq642U*>Jc-oOuS^NhG|yyCO2 z?R>_7<5Gy0x#saPsU0&?NWiRFDEGiaZ3ypRJM_W(hm}Aua)n*<)-*p~fH?u@0jfgu zEg=vZj<$XBkC2U3S<#Wdg<3JSd*5lzmETxguHfZRMt}=trm8gGbNt?WCRStrA(OapdvAzXtFX$D5I`KWeJ@%W))9iK=hOPstpO^6>#j%Sb_C!8fNyHB!(| zi=p<1KefZX7OSd~sZ8s@$03@o)4JF#PTRuNhS7|G0tht>(nCC8$?*Cs{2R_={rewA z&p1o^+e}Poj67C8D&U_hPe_ZQ%fhh9UUX=6_za^+m8R_D#06Kx*Pd(Gpzw}he#DWa z(Fq^TR;M4RRrWUV_$ZDQT68_n#ATxCTlTz;?Od2!imLH#huKw>oRpaSMVgt_A)5B} zD6X?UN$=qu%`&YfKeJZ+Tyjwz30-{^A(KiE*48e#QXhTsj{xa8dXdcs!@qo4QoUwr zt6^9)V}{MkO0!%PAs$uTWjm4F+l-i2W)I)5Glgkd&THj^CPK5VEYhe(WDH->YkmIB zRTBO1XjrG;$Zysvw7YQ@`13^A&fB}^Xox3XHKVJKQYPd_G-j;kmLs7A*32^Rj&}I3 z@t+!?AyIbytj~9PprYnqoO*3)P<{JjPeke zQyVz$y>4p5rIOb&QWEVEolMPd!jqHtU~kz8JYPUA=fjZlSx>g7u(*MZ41dETR!x z`KA@!jfwF5SaMQpTbESol#UUDPp?2~#3PHy)-M=P%cx>lP0YQtS&TExv(ZutjZfIV zzfZqDY3sZD^^k#5Ab*|AiHBPsFGMt5a}=*ONvH<(<%;&Bg94O9Kl{V|=D@X#xl@p7 z?>AcU>7VYNQyc6ipP;C^G_kSi{`OdQOug~*im9D5^Y#2Sxs-%73Z(%|!4URvDhlXC zxWA|Y`YCwu!XzO@yO`RD3tDe(=Sa$%Lc~Upxn!?6b53q3U7iq3LAP!19cL6?6z|WM zh#*7X`3z=@jeB=}0BWe5ryzIj^|U8nE2`5(mrq8Q8T9I!&gehKn5Q(&@zpdUZ!W^; zubFKrR8zt%V4L5$f7g-5Xo(Yu+Bfd9w);8JV-fi1;$r;C2esk7m>L zTGtNmL&Ju&W)7I3s#EXZB^7k38kbXdcmo;Abj-c@abw5!?7mAOui3DgBe0AgfF%_? z&NMwud5;5OeFyvrn>s&A=+%;}beC4nc%Ba1*Smm6d8dczU?fG(0ozci0Wn;#YgKmQ z0Z2+4+M74m*CQXivzQD7HIuA?F9$cyl+}N`$IV{m#Wu;?3L3Av+i;34xvw49w6m|% za-BF>ISdXv8|31YyB!0Y1}Ol6k#yV}WoR~$#EMI?+ofRRer%QX@AcEoD$wQ_;~07i(mQVZyM0V*vc0V?a%BFe^hN$(=_Z(S98eCHSPJ)tb9av0V<&aX6Y3~U zqo&o!+E!FFw6tw(?4S}PskbzE4cz?32t~d!`71NgCptx9&x{pYHDhQx_75CyEdu*c zsIMH#dT~(*cx!(d_~`oxB3Fl~*-Yy-L@;@IHd@SIP@^Mgix&xYfd*gTA^>d#W&@{x zF17GW@#?Xr+9yHbqh{-=y@`QSr{EtqyniqL_OpmQ4L>|&5Yk>Td9CKwvBm?3ZlF`Z zp)9AY=1UO3O3~NW7exheizR+DS_5W?eXjzg$jTYh#I`}nQ^d{;U>;})Qvp#yLcvV@?i|}$bn4=(P`1h`xWG>NYzg%6Le`!9CtM*^LM|*w~J*}@k z>D}K?MO}R7#dq-4~S8Dsj1+&e=ndm0mUT|ov%AOM@L6l3-n2P zBqmG_ih+7lDAKf5c=z-a&Bp)D_*?enP+e_1(~bpWy#3{1cxV%jvM%6l_6Sv~r+qE~ zj{sA>P%~n<&Hj|~LhBw+kr`t0r504vr`T_W$zD}{Zom+fOE`}z?vPjHxL&QHoKr)V z5`u=?vL_kuTlA(gI~GIlyV9%jo^ysC$!WGJoSt1U^e+(KAmL~o|8w(7SuFhD)+bm8 z_MpR!wRSRX$Cjga9rxHF^CiLBl}fmhsRxDaXd@LmLi?tUZG#g#AKcRu-A*7aJUphz zXuy8Q9QBtiux!bBK8g`;`aD^i9xbPV6nxpTl7=qP|0>S#A8(arIi##7f(iy%Y4zwk zn63Qha80!9Z-9fW*6ZgyF(BM|qhnO&pJVg0EYa%p3$Z&8FUrtp0WRY}HhTo{0yVl_ zYMPH;`sI|IQcPS?HE&wz(pkn~SgNo(8$)2EAq1?kgr~ViPqmx->u}NA%@E~9pe+-$ z8Iw(xM>Ud_AQmq6Hnry5QMc8rD@f00Er`tfN14fkiFN&Q2%1*#OJ+As2>oe3KWWtc z#Z;7_kkBMaBruDc;*_udgZ1@)=D={@nNPy(;KDKI7VKZD8GN z$yAkkcbe>~03Y59Y2bS!^p8(b2-j#DMXB(Hp?Dx!NzIg>AZz$FRhAL*>%>iylG3>0 z=W|Uc1UlKTkwPSN=Ez=OMg$cli*syDZRh}aR2=I*MzK{gO12?rQ&2_^4JB2D1t}5!8)QsZW}IPEo41JSqQK?&-6DWSqBGAd1A|+?l~C{5JE z{l#d-wfggDP`+axn)()Vo!tk)b+uGO9}U@GIOpPWx#_?YQ45tNR8@f_bCo7Wv`F~N zgpwVhX0;DijJkL8x_}mK^Xe**=L;?E@6X)P=hi>kmf7 z|17hfF&5Ea(yCpfS^n?u`pfp4wAJ%t^^-a4nZx&=AO!*WC9)G;gdCOftz<;s%Q(K? z2?5g1jpHGLz=~W8;_5FU4&_YvcmxCl=~-FNm8_L1+s*h)H9~;#=#-zTc!1<2^wqG3 zp(LlK<%?7*ID_1)nU{RTx+cA9smDVWt#_WTMe(^`YMjGTpW!9=ZjdxF_i2jn;w5q; ztP+hW34%h0H{=kV>D$jNnsjkNYTUT)li4(9^vpOdpD?~9+n9o=pN}?I6oR?Xy2d@6 zLK$I0BS%*Cy96zFj{vBBitJ{w{Xq-J_bLh=eyv^p7H2QAS{N#w$4E`0m_GVeGXiW< zrN&9_XVHIf*|8bd6-9c|biY97NaV&e5b7<{JeW#kLgZ*-8nu!loMWV9u~GGAw@%oM{&~*gqlzM&g2`wBppoDVp1QwJ|y0JTibb$OUhUh1k-Tm-{I$yx@f|jfdFZX-ijp7 zz7Wb3fyMi+0MgW>Nem-nNoE+#3KFVB`Al5@(7l3%`LqjMnr1*=&}|8~uV0boO`2pZ zNv-*vT76{SDnSReU=&M?bYP>U{-lj4Lo$}qB$*{yCu${LhK8NXhUOUe->_4lEGY2v z%RR48lu`DOLtx`#=5AJrgqB*@i3W7fy%!W-%B{_*fGu=oPT2;XcrTi6TXrr1y1E*1JkE?-tHv2{ zZFGlET)&lf?6w4?WPDyO)X*qqrVdn4Xj>epPg+;NdlZ_WNd6!g6MicbezRFL~HCB;jrVHy6uG|6?T@d7lS)^VpST~q&&L z5UlwsTt0jQJB}PsrZ)IgZNoUo&(!7MY$!l7+~y zN=nZmO&c{#l;NKiok0n~5ubL!gPLmlo6>yc&lu!I(^0#tRBOFw@Ie5>IZ8u$Aap@Z zU)D2rYa$1HR*++Mfu4(Fj&P?72+omb8zLuvbJL?)V%g))q+zhg4df+pHPQ9FOjmbK z<-@{8Z^krDG|RatcR27*f1!03?H+rx%Y@~y4re5Do+zo%)-|RQX(M-F-{`gv?edY( zuQ0;=ssQRG8hhVdPPGdxJ!rCmfuddwvY-#;4<8-nKqc;C!S_`+#aS1QZC98N%Fa_3 ze*jkZsYbrV(N&9|tXvZ|T}FwLV|Fa_P2&%l$EJL_ZS@cFtdJJueEyGR? zjzk;@5!MSKv&Exf{@CS)@O=~Sk0x-W&KF7Yc@q20f7a7UtGSi)HqQ<&1BZrW0rxkB z)YrS0VEeYO%xmmW4&zX>VkVgZ>WOp(&cat(gYEDnz+?DXokmT}h2L&L$bkO)!COTj zyzh03vXW~Eg8J0kll6)T4%3cnQX%#!KC5Erwt9D^{rutv{GYo?1lD7td?Et5VATY}-DSShmBdl?!kN?%K3+oN)v^kt!tO0VE$WLxr1qq`dsjK5<0Gjt!lfadL zFpesp7h@Hu#q8aYWK>Z!L}rswgsDpe&mn&;#KvP0_ny|Gd)Bz zDvK{Kg2|X+1Xs(+XLne6!=S*a0kcTquAv<>rx_iv1yRNYt>K1kvo8|;{?}G$p#bKR z=1pN{r8TKf=6nHR8Ht;8+Ybrm<9I%}H4BfQWF=JIQ52AGiTHB$ub>CI|Bd@qeBaGC zg;%BM@%TFd)jz0WhnPsDlwgzY*>x}nLFA^%t?mnY;Zhp!lCf{z;g zhDl`I_(L$iXNCFelREH@&TQZ8q);hxFzi?r%-{c`&vK_voYJ(W7v(rY?7oX`XH-#6 z;)JL4Rhz+L(vpSuOWVJj&a`@Z0r1PC*&9+d;^!B28s*Jv(vmHXz{+4}`f~yv&+M%0 zE-&f3Jd~jx_L`{|st5<~uTplAfTBAxNNAEqq+M}9@FbM(n|pP?domU;$-8IMmpHrI zH%$0pWy=G&AJ+OZE3iEtpxVKWkms`*f1Q12v1dOLExeo|)`l(l-1MJT<<rZ!psb~nr$MJbk~vVIlQ9AL-%WF{4qI&L+>zD zRYRG)G2JM6TvvDBek%*FV!_i-#JbdWvi z!n3^7Q*SU(_8ogh1a~3rAGaPssD5yk>fpw9v`YPrPw#S|!Lx3fk4(xbQS;vIU`QD! zAMVPt*!|5V>6AD!8xb5F%!~#i5OgGs=R~8d-g>kGAo2jnytCagJ%BA~h%OLk#g)dt z;P6;Ce!#JLT*~~I@`_|vK9oBZabC0j(`#|_Gn?oj&UNQ~U1QkX4eUm`lB=xVXxzk8Yw0BPuT9V?8!? zgo(g!8~}(w(EIj{hdURbJ!MeJMOP-Hon8qZ@-wjG!_bjTZZ3TNwVAFqaYu@nYf2xw zNtK*j^u)wX5EMPjL9h2xrbn(J7>g4>qMqn%tYJ`+TtQ4DjNXc5S|tH1oYT~0HF{D` zOaV&^I#MRR@@HJ-;y?*WddXwkLuA zY@VXXgd}rVRENrZFzSh`DEZ^&mr_p{YtOmOzKvHJBf=AqugMHa3#_oQSWKMMD5nPEUt{0!N*G2gasbTxg`Ymz1Esse@WU`(KM&v2|qkGBO&OuSD zltvPZ2{(*wPO0|0_#fE@u-40Xs6~if@_@Wgxm9(&06RaOju&FfkP>#izwvh7uL)ch z{)a+8g0K={RdAsBu55S^jc6~H*U(-a22;j4zYbO|=1K*1?{qe@nFSAp%9%KqInhJk zftCNs1mSEYrlEIoy2=S^`D4kCY)^la(suXy-x z&&P|DseNfxRqLN-DXo-pJi8=5kN;xs3I#ktS-JaW2&3`(;fd1J97cc2jOM)kf^^ne z0}^nlS;-miJ4}fvrO%)bEmW8vbrwIXqF$PIUG@ZuqXIXepod6%!q3%(2ks$TLLb}c z!IXhqYVUXmj2{{oY=ILS(+QwH0|Gw{O-;RXen&T`COT}r-;fR(MsJ0sfJSYWu+J+X z4N0!a_# zo%4#o0M^Vf=3xYO)l5fvoUhL{5`#?siyH=~RXm^xND#M0F4imf(d`|ck&8M}Z?o~` zy`hLx&gmSUssZ7y2T2Z?$i#`|j*j%_Jy%AQXYMe&vWL*H1*y1wap?X|;g-T4KRIui zXVS_iVU;njjHe!>5XtqZAtYa>#jTr4Bt-)V3H={c3;07Qruu}1| z*8hwK!mo;eX-k+|4DzW-J05aWq-U@VQfk>lXd*l)s!#ne25OU)9z7*`t&zqXT0(6W z_BWMJfAs)5^yYr|p0?@yv|*obYQiuS{uw`?*Z)4LU z;H70CGJ$WHYN_OZwiuY-pf>y)8y1a2{Ssm&>nUm>@y22OpalmU>X%b1_h^7?WQcUO zA01(+F8&!Cc}o5Nn(IUd?8a0DMrymP?n79NRxt-o}wLbxSFJSZw zOmRch0&NKi7x8se#UoG$p)?52{QP~bcZIojPXW7;LL|H-Q2-e@;OXoM;HW+Rv&YYQ z>%|h+00&eUe;@Cz?~h&Dw~x|z$`To}aew9r>M>fDm77);Z#&4m$uuyxNR@~jjNmJk zuoFly-Ucs!Ic7@eW)U<)>DPP05VHHFR{hc5sbA1LJB?kmJcmTatO96-Rsf047UNNZXep0tQbf zPMe|PBUTgWYLtpIz*E>bybnLGd3#weWi>LjN#)`arJ_3EUMGo%{J_~5B5u(_Fnjvj zw9C@5_iOX^_K^CaORRwtFUbucQYH$7m+8S$s@?^Cmosw97cL(i@U=mfypEQdRvczH zsS)r8rX;C+>s-yh6hW?B3FaLM5ycwQc&douQW0epN^M~h)`GSBvrxd?%gTFo*D8vR zpel@rshuc^rDd*UFfuJwm`kXdkfh@-zcq5FH5wUt;Bf^uVrSPrPcF}Zxx-XFH4TNT z2_hDRnY$FtQA4lD0uwU`4VM7h+S)d>dJQaheROfT#@qy3g#Q)~J z*h2AqObM1PKFq0$KqbnjrXGqy;aPK+O)A76$c_n{H%D+iBg{zo3NeT;y3FsYVf>@{ zwX?frL7A^bZpNpc^P=!qaSZVfFuI&U5k8mAV$2!!Y?RjuSL_!-dump&VBA3ATs(t` z`C{VT-5nyHoA=Y~PeXqT)hnl1!E4a=_+>@DMI?~MYP0FMUejFop0Fx%44;Ve%OwVs zT0%OD(MmatvICIQ%zCmA^U=yLu6N4*nq3?R#CmtekaK`i$J2 ztiluWyM@Sm>Q6jIN4Xi3h-F^>er4GGR%k?waesL{#N(@QRXMkK`&ffEJn=mHecX2m zNyO*pA!)2rTv^7;30!8(TM}#`QiFRIe-bWfAzOA;yAo!plM(elOggHnJEt~mKW4e4RDUJu!f2*zsj~2*=+(0 zIb-^p_lmBM|YQt*2@n&PFYTrK} z68C(jK1B0CPT@W37OntNo8qGLiz2jQpP|I+Ot$Ez$9)-(FEKgc!T%ta9$T~F*2NZQ zudn;@fTZxAiEOpDL2yZ=YQC&E6h{x0P50pSysGJkq8WM)4*h=Ih^?%HvKd8CFJOG` z;05@SUhC7GAd`?fn%wJ}-;a6hbu&2}J#!!ARY8W+g>>23;rslhDRtOZHql%N9rcaN zTJ7P{PCYC2Hhcw`z0ADK{4gWQ{P!@_5$bLwO-7YiCBUvX2ul_Q-v2v7XAaff9&}K) zyL&L@=p~BCXd-8Qm1`2NP)yj;+l}1(&ngI^%wVvIB+Iv=xjH;c*I>f|_5cF66EjTn z91}&#l4L&;ESZbNRbS&dQpVWFk{x5zq%nLp~=dprJ*ZVN)l zRgv}H=LAwqa~M!{hXRw0%nM0n>@_#2RXjE^Azshy7z`ChSq05EHLZXX+dlviA5YmM z2UUR3hCixGNs@&XSXXlJU$!oBkactyb@m%GAa6|}p{G@g|3v{gz6q{zK zK@VMhPncU&8{=1)w|HgS4Zxl84QnQAseyYauUVrua527n$m|Px&CEQyOOl9WG{sM2 z{fH8Wb6NuGLo&`=&rIGINUmPX>H28Ksp~)Ei??DfLhyzL8yUgEZGTu0Hz{0DIzuX- zrqh9Q)|z#VNu8z%or6IyO^&fZOtd!r5R#q`-*DG3;`2|5a7?eRhorIY1LE)rVE1E) zOA|&LIx0W2?O?-8Q`{K0*^FhobRJJc=i!AqkMb2==Uy%9i>7w?jJQd;mC{uQ_Ilnk z>4o4Du0JGAx!tBfRq*6PKJ=|XaO~Cg5d(k(lbgDdyJ3038YnopJsh|c>>( z6=bHRAJo-yzS~oo?P@iqgqwc{y6)tWq*=!8p&Rq9e1aZ1GRWl%GrmgNlX*P)EEv+~ zz03ulrb&mSE(Ym4;J)-azR{TEW8qZDL=-h;*EssO#v&l7Xsw)zE9_E{|N9>s@Ce;p z?Bo7m4KQh4!7|D_l4@Gvh>R)1u|QEyZ1MCOayjwosq}t$S-I*N#1zUW{NvzLr2KcK zDs9_2+p*#j%@0v%ai4QO?k_|xZvy9JuMH>5xsz+pM~AUu8#FffZ@%l+3P@?_e3 z>$BQAI_TNrkcE1h-hS`)LL0>fEHDhaU8dzLcc`2UQlQNfJIS0ySKChjQJYv7tWlTb zX9dN+mY;`4>uA=Fhtwf&)?f|To}(CI0~9zMiwsg7f4gs`Ns{Z>f8f%aRF;I}(Q{Q> zp7A4O*pyOwt)1!-;>VZmcH^G|327wlQhyDJ?^R6*%=0GWdEONf zRwKAXjN2QU=n<7_Bv$~x{Dd$tvx(UxBJsV06~=A$(Cb1P6NCEEiM}xC2rz5T5`IW2 z5Hj?{S;}EfVGpCVNmoiiq$)Eg)ADtbziMR00LftMsqcZzSelzk8k$-*fJ6*&l1gVO0ERRh^CIMXT%-M-iU`G}X4A4h9wzQTad93cw}aH%O%V-OD}d3Sf?0n9hU zpz>4P98_{vfTRdNHRt_dX6BCck^$j344{Poo80$8ULtn9q@t~97@6!JObTSBL(A_o zr4Z1`&hRMuoU-2d069MDSG$BQxbBS@nD7#r;LsO4bg1$kTSG~T)HK|; z%$Ru;c7o8}Yy)jZqNY@XJ>HLzm|i@Kt?KzSybx)d+3dQGIwr+tszJhz_tsDY`V#k$ za)NXn?b9@%`Q$<-Y0uS z5;@-_d+cXvzh_UAkJX{6jq!3rr~%R(M>j8_W^BUT{ZzHGDcQ#IUVG#ARb>^LpDbVU z7cbZZC?wN~8`|4<*Vh#s_}IDT-GZ3d|CKt;FctCbG5Jehtf$Q8(iUvQtMKuu64yrN zbcTk(QLG;>^8q1bVN?q@}AFeIYIs|A?0*If9oK%$*A*SOZ%G`#X`_AT4)W7Pz4xV|kc zlcy~B7^wx>W7gH;3}rI_%X71fN-AtvzfN;o9_q_vOq0?Q?Sbz+@U?YR-i5ruH%Av) zB)iaNM53vLUPd6hFdBR1SNAGcEa0$!Nm&a$gu?Y!SU|w6g)aZlI427-6W4#KB@A5j z8e3Wn>vYG+;jQuJV{iV$C0k@3?I{nI;aA&YN47o-DKzTpi^@V&@Mtg)d=HI%I*R){ zW|EendeytN2y3z`l`LlAe=cJ`y?{gO^324s`{;au!ryx8^8f|)YuSR(oxYYZDHHnh zX`zC2?LBG!G{YU|lq!p@_SdCE%c5{ipmAT7SYQJj#tbQV2JPEl>nEHW2K!d<{imNl zyqXHL|)FT*;%u(kDtB;v!>XnUcUNWk)gj#Fb{&^E6qS+i0 zwoCzo5lR}d;#8$`SJVjnED@g_MW1_IGM`(Hy9Z$_ZcLN9UkiTjjm93{1KXEeEPAbm zt;@rr*SwKFzRKNTfiw4N{W^rBo7;2x2~sV%dKAu+htCrrCh23n=mwpE0<@L)=X<^R zQL50b0!Y)ZV^bP0<>)fVLK-LF2=r`8`P6C>X_?J9am5ui+RCo!>1gtc%i(Ao7uy>? zxQP?p>e!Yc_3M}8DRj=y|lrBgQ04=W|u;w-c>ytP> zOA3uw1)g!-PB3&-!T8qz^oq-gk+ze~1hC>BSOBs&hqN z`iFnBt8*iijSh+r2&iN*ed~|xzHi;>V=i8zYbCPJ2e1@a>KJP{JQaubS+;-I9u3Qvyr^68Gc27f+2VRmGC!H%lvz zCw=A_%IQ{vGQVR_c-IAhD2+U;c*F#+{#&0 z1+4$p_%b4`XROc}2Ir#jX4p`cc*SAqdgh@9*M@A}QV7-60K1Hx4jJ3qua2 zbc1vZ-QAs%(ozG`-Q6t>($D?<*Lq&C7Vj9~+;i^P-@W%o79TMHEs)Ruf)9X$`*udE zb~>^Wusku9dJkFosji3kJ#FDiygc#(Hc7Ahf3dBcu4FfIkO;smeh8P`bW3KP=x_5J z16uiDGr~x}!m?8bKk0HKwp5M8(*tiCwL&8KW!5!MnEsB}Ko{}f*p)4y-3wdbD)gi+ z_03r?$j_okD<)A(Qfu5{omX$Kc=$ei;eaN7%Z$D#%g-&7s)XuYJoaZHRN7ws?{vfy zrpZW^_zc9U->0@KVs{-aak~A<{1dj63)=j=04^ z>V(D+6_~ogU*UtUvP$aEmZ~FZvZesKG?4J-`bg7%Za9&&$>WX+M z(m`86bLAK7q@f_E`Aj0_D4{vpBKh{1eGR>7OO0^$eyXTkvj(G7@_?st9;cHE&1g_t zIV5EmAt;yrl@EMo29Y^TORn4>4}Wz4UavnBS5J&kz7u{_ZXKRy{!8NQV9P?aAJ<@M ztoam((r096?lo=4wmyjHV;RrNJUe0=501{qv@g7p%n`~22qnNPg=bn3t*i`4GltJV zWW3R!NNq4^_B!)(uoTuYo!O3y;??kM%e+Jy{9$A`GnRqwHrpPT_i!#P}_{rIf*30TJL%=}vmP$5h{?jYz%e*yd^gjqRi z$5(G-Uky}L9RFRMe)ui5_C$VYsulMZaJ!MY|xo#}p^@4B1sc1N&}= za`F?WKx?{w?Y6{`J_jdKRrNO<_V09WyKKIc)0^pR7W)B_M-erNtIH-4y&Fb94e5^4 zo)Aw|z4f+avuDA{XbO!%N&5+T0+sI=^=5SvXJ`NZY+Wk(2IO?r85?%uu05|CP}orh?nw1FF?&^bGdt+^^HFKSjc}-}O&- zyI4#qXi-yrt$6dQu5%PMgCW;o(%yANen}-`kwVX=^u{hQ2RtgVi3a z9*nh9*VfWvUemJv6cYXT?|}E)sy9H=NHTU({};anI4S+_ZV@*4RoJV3qe9Z^E3~l0 zihKONg}jNz#C&`@_1#+f^$h@YsGfjOZ4De99fy`&zX5}os<4OPH%#^7PGXY~`slfyx3d}go<~0S3(DcwzUix=&P2{1hfvyNE z(oT7@Ls6=K@v)ATE*C{GQj!}szq*t}2adOB zw)`2C!6*e(ogWh+jqQx^U)ScA;UtO@_qk+ts*Q0*dp+F0H!&@CvUgU|;9U6T%0?RY zvHB>us0v!9NJE<8^o+_(G~s#2=v_%n!0>9Hg7@sp_%irD3^`(z9art52o-_;cAPh(4JCmAvUS8 z^Uyy-2RFaTY`-CTMfT>1W|);M#uYl&5S(`B21E7YHQ&~ii`tdirX~gS z*0dIupSly*2+7JD(seECncQ_^H$YHp?%V3mCT+Bkjw4GsInd0siqy(9Fr2n`cUM^X z<4Gv_gJ>5`kTdnS&r`Uhbj-qtPT?k3kJ!_X+q`&gEw6&ZmaIyy-a&{_8iKR!MBirH zeD@c#pc+4Js7$aimEag~ewHX5))r{6doMA#n$@7V#s`M86SA%XGsNWVm*MnZw`@s- zmKs=+cqK+;2O5@frU`%keN95#G71H05P?FYd*qk0<|$pEsF9*xp6f@aziSq3kWm_g z{v2-l-%|Q+SNlF?d;Qx$0#a->jdXO^zR5hgKpVy~mxH5YB!BS85N-5Wbi`CAqt-7>T=arn^SeUW0(@&E4y&~^fU)`s=1 zXUZe@ChFY#W69V{OkFxlCvT3E*=v{o)DFc>Kfw)o(hD!}V;%Ho7G7MP!lW=^NwuV% z21^;BI934|m&dk^jg26Ir_N~K``8&>lK2^ikdmd4O5g6A0UB?(c*Wc~!B4!dkNt?J0lePJ_TZ+AB-eMv-?Q9WRi z$VLY_ZT$Aw#j~s|!-UI;hJWPeFI*FF%?Y=Imh7`TY{=a8V=+BAmdiInyUmR&NBy+fbnND7PR?TxQ6Y~*jytJ)`(>9Y)WrJHdJ!iRcu?(~9-s^)`rp(MCc{SLi z3LZGrm>E;ooobsJ1sNro4b04gHg9@F#e%Si45%VD+28sB8c|z^iMP8F2#-fWsDJ$S zGS@b;kklipSSsxu&B%qnxjXk#t~Gg$ZcQ0UxK-E4iWmfV*fTLAdgQ?b6-!s(yaf&b%C!M7iLR~qPwPDBr`~-$n;dvc_}ZSE35F0!V10|MMcNm5&3TA8 z8tI#YT4(L2E?YYmLQPDRcE=DA8Z#4=GSC0r*?k1_R024un_ILUMUU@J=GLImXyzXlv8XD+d&V=O8xC6p%htAJ)5DP%tZ*Hd$zkrxB-<4rmiUqsE7?a<{E zE%nL~(C&S4Avt$_2`r%u@*r$^)gxuy&;O|A41N$t4Rh~lK<@AG0@iWsY)}Vy`aFlX ziM9e4?PS{YvSgN5J-I@C-ZB4^f!b??!PT`K*zFo6S5dIN@HBIQ+Q5o0j`8!(j4mN> zU@hhi`Y_tN?~2&e10mem-*h*Md8v0i#X79*KQaCqr&}Bn#_@XQ`iSu@fZf!6nvH;s z0G5!)6p~Ivne?_Z=ub+8w3`h6s6fvVh;o$H5<`V0zDNqHK#m8>J3FmAO{~G);$t9( zeZ*1BtOS2-8LXH_N>=B?r#{46BTLoqltbZ%g~~*tL40}8g+zxn=6SfAo%|;PRcLSB z--;R6xAhHL9>RGd*AeK+TQT-zJ3k8`knbL_(X`;{CGp1h3(0{846XM)7UN5n0x+k+ zBiA$Ufx5uE_b6+OveX}dzi?=6Aba`6%mdlksAKcml&gRI7cktzn_VRBD)kC_%o*?K=j%Jpfk7jgwZ_<<*WtN;!;v+$wVD zQWO>qz}!0(GjR1shVA&nu5l`j*0O+7D`1x;MoO&;HkEE(I>E_c8P2VWU(=9mtNPE0 z?|XlNdn(~&3Mg5hWzKLXl%{)thEfAgP{UO3luv)Dn1g8Mco0)b^?!k@rkn~Ezzlj> zyK%7Lmz@0Gj!fv}mh4tNIAa#eL2U(!^f8{(WfwCG6 zlBTa7^X&I|kO$)}8-B$$7<=24v(piVtC(COSz(;kQdGuD01F1dD9_)G>K3?!`wyHp zSDwUNzx`F0n)~kh5DZvC93jdmB2}lVqN1Y6VGO3-k(=k|VO7@jNOEY?SUvbiI zcSiH?GNDq;cULT!_vy>usL=x%j1jFhOPw*P(AvI+CZ~Uc1+v8y?k1TiAKlr=(t@0 zu8Qg(Dw+0_Y~w}lC}AW&@TKe`;=I31enWjT?tiMM|4UAVyf1owk|)wItuY7GNb?Wd zgvPF+K#ShYOsDz_nHth!ag^`l7Nyt2O=NMh#q;By1mGq4q%-L44qOk$BwkYCkb&zN z{+IKYX9+S4r20wyuWOUH{HCOt(3L2op~HadW&?HGl%8+?bmm9f(GQOszkx`vjS3(#W1^( z;lL88i_qLMU2;4?mu5mW+1n&G$ru31vL5QHLq{a6?Nc+10!A&!{)s}MmCW^-gsaSg zl1A0WDF+cBbi$f4vMZ%S3&Lq42M$K|Y)DG;RawpxeiY-t1p=odL#7euO~dR}eG?wv z4ZyLcgj};MpNA3x-`V0ZaDU>d_)I__B&N4+G0d;Gt!JyP$!`f7SKA77rKqN}YLbTw z;t*%x4hwhkAwRG!%`@RM*PH8b9z0-VPo8P=SsHv!0%%?W5Dh!_DLR37f8w;HljMp9 z>}xvKFD~MWi;HyzC`_^*1L3>v0P7=aAXsKhI+X1tcJ4?cWXHTUCPT<1LPe&SN>;sO z_MJr3e@h6M5BBMfoPU>}hDvG1`j7}_-OvoutK+9hCg<>*<(}K+9AVU=P57NC4a{Sb z-E8J~31{xNMD_TH#N#H+I#wKcwC@5|=H0cIr?tC{ExAP>`S^(5d12S6!t3}R6I zH+zInc!clPzxML%I^mQ!sZ0?i*C8%G&IiT;i_qjvCNr>D>-ORf$87Y_@eYcx?WVEp z#Wz}>gbJSuBW!VvZXTm|nboa6df#QySjB#F%O&~+)Ltb416fIBjQ0u=6!?J(=*%I; zMm5?$bvXeCq$GHTjJi@Dn*y}8BK;ksvf#Wzo$X$No$cmiNx)$q3A z7E%>N$-l_>OrII7D$GUp|PcXe_q>fneuA(}bvO zVvWWhT)zP_7GRY-_KU;)aXig7DpC(p?&w!>2+(7li=)Bn=^anDO}%4Nk@JDVkOj8BE)0e-|kT z>5xiFtiw%zGROAC?n|L|;%eb=>#*kTT8m97@7#a6{B6SE+-|ri+x&&cSqP2V%te74 zTQQV@o1{J*OH6rEUPU}dlFlQ9lTC#l8w z%O75IWSN#$MX6n(MPx11$oPC7?VA&kvf8(8WeCoT4iDuIm&A%Y=1xMvcK=F0KtZfH zoF;a@f!2kaDGjz*kdzNv|1S8dAW(5Zgb>Bytq`oLs*0)XwaJj_-6XFHEq0=V_hbkA zJ75PAzTeiTa?u#_h;3UYBdJ*{Eyvkogj`L7Q9w9?dp0GfXaB0;W~~eAGx&KY^5}>r z7V=OfKCLx%LUINB}T}C z$|6zE$_lx}%LQ-w3~GLArj4y}iL)5Y*5EtM2eJ@TDM~ob8VLkX(3vc%cU*%ot!46G z4G`WtyZG06a}ef3Bx8+_@Ky*5@D<$wFRl_#k7(II0~){qb?{qxrW&1=r5f!~J)V8& z$UoI>R&BRv_1-u?j~&@XJbhDs{okSR__*i0aq@60T?j>*_-E6oN6{f>l#pkw*YSKK z(z<6+RAaI){K)j|Uc5yiq3{kQ9}>?)vUGd#%#yh2l)v8+Aw!z|xNd5nk^A#SSN~7h zv)Ail@XOHy9hN%VjgDw?`j<-0G%G$9-Fj3eeB{}|?Gv#s_j^MdCq8UjlEH5EZ8L7! z?w&S+8!%pY{cRS_&Ysgs?8;4;2MBT$Jjs;cQZhd@jmwCPQO*JZsS~^b8|zH-6B4rG z#cIr50O$OWGv{BVU#@fdRkN1#?x5`Ft5{e$T60IG_L8r+R}LwVHU#pq>Yb^|%+%Wi z+@mzpHb306FdVx+6^XMePcwx~D|6^_1cqLctd8x?3r3Me%QY^s>!#y*Q{PTFG#Av< zb4ViB_C!E;xSD_5cB4+~YUtQglpdx5HutcT4+Pmc2UF*vq;jFbWfecgdC-CTPnwgt z_gKFxJBM?7OpxZx=Xsp`%AY{Tin4LvPgrdZ7yTd+7jitSd-R>tyag>vW)AbE70>It z?{zZI)p&yiv46)6HMNGT^z(%h=kgOvi}$pA~851CVCLBpQU|e^^8zuLZ&`M1E7^ zBqe2J=l7)`h`p@ZbG(gPW`@JHd+dJ4+YOLZeXHVbk&hnMN0z6KDkK2-vLd&0U`4QhY?h|628IV>3AzN?su$~kIvzl;9h_{Lb-0X~y=4IrtY z#~=_vf^@&#L$^z7;kW3`&`PU}OTZ5e@H$tXJbmtV#(>Pd8XqjNNmLqV$u>`IXl$K~ zg%~$#U{H#xFKlE87D^G~x8nd``gQsrdLFRuL)>f3Q}n}SRD@Jr%48Bn)uQzhF%SwiiphRku=(ZW4bu|Jr~P_b%G7(AJtFwt z^uvhP$f$-2i{+lRNcqKBmIezxr%GqZtD=vI4khmc_+HWNFR0+^(t4ob7v>Nx*e1== zy{-&^()7v~vReW(wf$~~+ne`hVD3nub?7s&Kl?YL*)(Hiw===7?^)V=nHH0BZ5LRL z#ZNwPzI~xh@fNNQ6PgLo*_zz45q#9VXV{O&y3(pD^ zz8P;XyI+pkGSHNad#7^PhEg-QRW$O*(V%@qQfs$P21+1p0yMuy@U*53N*_;9C=^W+ z?@MeIWgsMT7JZS4gL78@>(|TO6FqDVYn3?{o2;*Hf)wumo&+FQfRBCgkGCG)CN#-p z;rHBDD?#$n5Ni#G01m>38`>#WL4|GybncIH*V2_1<@dE^hGA!u-P~)YrAGsvPotG=+JJCtI48$wD%?|kl=v_9F4^sN64+1P%`2;z|fKPMQMpopAU`UhF9C9L7qL{6Vvrvcut_#E{gMolg*#|--mWWS!)dM=VOd6tBnfhaqd_!?^Abpl)ybqvB zdhCW=TB-ki)Jcp8;JQ#Pru8BDM4BcuatIlD3i)rAhYRehyhHG`#?zD{YIv`ekZF|M z@;1oL36E)zk?~vX#lj7j}EcDfvfc>NB{zk9T%`%7;!s)J*4lE_;^}6Ij!)N@Rpu4Iz5K zd8=-3rW`ID3LQQgWAO|bs1+)tu}W37n5Y|^s%|nPO!T5M#H2YLh^23qz{@?fg0g=;v>~rr^^W>v7jmQomFwj;{gHRRJ@r(wRdeeqU_~X%$B`V6OuRF$0eL@1@7Ke))HtxOv?N-^S1P zSPC5-Dw^W0O|@MBEB4w-ObvOH8Sg9kjfV?C7Q+GFSfAtj#-GfKGj!Id#OLP4#`0-c z{H{7WP6?DOk>}OET4#PK&o-m1Vc{(-+`41#H!_eY=ETfzLB1RkW01)7)=0M4u(%R> zEyfU9A<;jJG&|Mub}Ik9As@B(xJRl~@c9j*-u2I?UdIx3^_te$<$Vm4g^g*V`{hjT zQ%J`{l>PY4gvk(Cm>2{m8|1=1i#61HGlqMxtImk;HcfHqT}uP2u@9Pu>bL(!RtYyJ zLuujAx7WN5rDT?2VsvbJ&PysXf7{oBJwY9NPt4%n%k@FbU@jLAPm6IjYTrC6m@(ZR_6o25ZPuY;DE1?im+@rDMDP#dApXf34tudpwQH*a?ms^%`5nU^_V0{00&~ z-QA5_m%^-Vjcb^H6`azYU)8(Rg~GFzjtrNDE(1!rao6?i{_5y4SqTFS)ebuTbzW{MJR@q>JAhn!iT_6 z=8A3=T?T6bl-J#!elu-E#RQF1hyHmS%w_NNIO76-nP2&B)tIFq9F>z7;Y|$^X_S>p zKwx5E@K(3{1w~FNA>WYfdP6;oq!<*6z@Oh5^*RQ!aUhoW4;Xz22y@S3c{t=8H zP`{WgLPAY*<83lR56D&6ei0i+xNA|LymstEgLY*nKXP}4vBc{2y7BV%_1PyFaN;0l zAx;tNj!F|#23k?%$0_79PxUfqK^38gx;Lo+Ix!8wOWyNS&kh{%_V$~*&tu=vu3vvK z;myOya;IjZv|qx`Z9rc~^^;P>rEwhQ$-)sUehRM^Gpy4%tX=UwthpXb5#bdBrJJqi5<8Bwqlt6$z(@Y*VL%3`}pr$D#Gd5f}qM;r*vPYX$r_-np`G1+&JJvLNs~JKf@L2 zMR*}13O|$Z8t_a%ymUzFTDIbHa*oy8%FQ_+H460coZjI+cV$5tJAc(y3XBr=QTTt*Iu6S}2 zD$sb6H!7f+dZ~UqvLGA_gT3A`p0#gxhC@gc(*6^gEg7eEDH$pG!s#ZcgH*ZBr~%Bp z%#1O!;m~h14;n#k#))QrA6SUn&F9(ZS)(v0Y3B}s3h><0@Rqjh$%I@(>yXjN>KOb{5NWCy zqkNc2vp%+eeicj6e-&FMYhx(CdblpGt}?D%zB_xfJNYs)w5rgOB$|WjTzqaA`TEqs zN*uGvnr83083;Idm+$^QiLD9+ms+&0)vVZ>CX>_70%L@sFAA+MPyfBkayZ{WE(oYw z8)bDIu!D9jBiYt7)ukPnz*zTYF@gO*$ZCaABXOSP<3&!z!!P*~L~D3LL^;PBlEy0r zkaU)HciRXFr9T(q@UmOUOe;Dt7ahmb3lu5KA_h&M+{8-p5oYVJ8*(1;Brt5U49Le; zeJza2RXoNq9y7Db|KPD|(94AMk1ulaqm07PaF))d2MddG;=H)+oWuOLURCqD9XGtC z=l&22)#9X#-c@l_$>GtV9 zEcGvXcARhxHz zF+ep~Y4w~F(NF;pky0^u) z{s}B<49z?D4&(;Bjc9ilsiEM2CZTE4kYFP?>o~YN(q=)s#(3VLyh95+#~*E7iV4bh z_^P&*z;`{|ZP}dd5R-fCZ4!ziEH1Eccl^ry&6-r+&YpAE$q6~X6~h}#TkQ{MgJpeb zlBku9OwxMA4GOxX)Lw6C8s#@9e|>XveaV9Te#rz9x+7OkCa7g)cYEv{1;YW#b3@uy zt{9W)c6)9{1MwK2&Te=Sd8DAj)4wxxo;>{6FcY2F?9F|f@d7fE)5zO|k8zb_*c2|h z%5YrRzFzjzH4^K}3sfk6dRQn()l(;_q!VTYWuFYIfvlc z9Xxmxv1jARopP+vpK_u5xbRU!GNrcMudS%jcHyM=!jwpM&@?yB`}c+Qh(NFkZYmo- z^)8z$yFnZ`L5;s!Ge`W{`O3C=UJ$17>}TYRoq5|22xvkBBPHpufPC(ILo4Z2J!Y(;_Pzl_u0Xe#b8U4H+ar3E^Je58#@2VC}<2aTeJWMVcHRiQLZF1Y8rF=Lo;!;I^%3}MAl)7ymSs9 zr9qr5KL4&_Eonkt=9PF8s8p%BEhU|NV-PIq&l`J;c2~A_G})$a+`kOmJzsp{Q&%m_ z=}?B$;DBT6EadOFbY;Tu7@W_ANB_VrW%K+ekZx?11R@oz)x&pSw{I)MY6>W6#?s%2 zYjb?N@^ZWB=@hg*qnK69tv|k?`8?BIpvO+o*6!Ie4b&Nl+b^G5sxjUK6*#uwHM!b* z!>>=sf$1MKgGv^N_elTAd|Sth#@`HFT2#Lc4}+S0i=4((O8@MxC@W7JLK%j-FFYnu z#79}VPetRin3Va^##^g)?sigPLuee;8~}Bi2vHUP%?jcWJY0shYAya!*<_KD71V$p zul!pvK4U1Ttya4VsGA{=Ud!6|^!pyk917Z6X2tpAdwHH2$vS3JHJ4}@uDlvsa7LT2 zGd<$<#{)812S`&hmh8@RA;(y(XG$DQkgH-1SGFu=vsC8VQnd5u8Tj|r7gN22xwcDv z(IYdr1uRc0zeHw-BIhzQ4SHyIfBZHD@ zc=XLf7WKi?{rIKSkSxZLQcY;J9pA|BcAOC9IF5|f&nz@+VOH2b|&yVN$` zz?cxul#d)QcZ3{@u)-8ni@>@`3tXYR9aR?iEH$w6I+I#^{E}BN5_X=SFe^AYn?wyz zuzTf~8@%j-_L=<0y9i-${dsGv!0-KzxCd3|Tcm zj^RS>EQ%2F-6tw&Hnt&u@}2XjNcnU|7<`;+$}@OIayC*hgHTf0JW0od$@Wv~@jnZ7 z^>D@N^6-xZMa7wh>TuvX#HmIh_8BI~413M3 zoQRE1o^e_qjap0=W&eM8(Cor9j?vc2$27R1c^=bbZZ5x~ z9wg1DzJ`d;PT9UvIwN`-oFQi~fLgqRVXJ^m<#k|_;1p-f3V$@7|A2M2!OqLj4#9&Hy!WV`^PjS^J6+>l5 zsD)+j!l$aX{#@j;3li#&0iSK@8$S2Obg4NRaN6{ae-&vC?`k$@EIRpLu}AzFHunB^k$i^!ynZTKA1;S@g*Dt6>*^E45H(t8rX<*c6pVq*C zXJJ*j+pP_z?}%Hkn+i)EU2J@94QD7~t1Lifn2jwEWYFh#3s>i*vt$cINH{L9#dRVG zf@1}}PjX=&y_3M}v(MPQ)j~!xQo+eFcbxcwAXexEu_^S=$QfSNM2_94c*TiYV@Db6 zw_+zJal=$#*?0o=8Ixogym+=EQ0ejT?mAf^FHhW82DZsM!>{9P1cHP_NQ?^U#Yt18 zw3A_2yj_*WTioQYvY>c>p!-ORRfR|I6anNefO<%arj)pt`~8gRbALy;+UBYB_MJds z8;;D!{o^gJ@dmjMoMWP*kE6z|N-;VPdr>*40V*NcT9Q0r)Lc$hcA74&-}{=J32lLHwVMR1Xw2k;R&44ZHz1i!6BQ7(9e3$Irvg|V|JgN!vp9Oe3Q z`(M}K;mSffTR&3DwZQ^&dIzPMqvV9Rf>u~v6t@H+5$5e3y-c~voM|MNyYI{4{yld6 zcE5XWDH8UVXOENy7*MnRPD94`)m=(h!kU;b_%qT}DsgcymzQxg0)Ku;QAa@(!FS$+ zD|o6a++|yC=_>izn=ya4KMNzu-8IIO13*YqAa1{$L7D z=9W%SFm(At!A#e3$ER}aqSs<SUtL19fa(do~X&+DC*+ItBf7|WK^bw$!e}RGv7kL z)7l+UTcXmwmr4A)Cv+gA6Tv<%qfmlxa%wL{<*^_(-yQmIF~fLg>s)Y+*L!WFEx$xD zfhQ#oFAs*3Y_))>h+5u|RDNXrSHkNfagWQdo$tcj&0!!O9nLcbab07or^pNmhW0zO!qxofcG4UaToR@7}~-df~*pVB|NRqK8}vKPC-%!} zk{IzS#|(0phwmDQB3LXgx;@%^-5JqolXQW!DFr%(qO#S=cg-xXI+D`n1|N9h77ju2 z0}O6ecB`K`lcXz!oX8)hPzu=>wZep)jq0$&>n6f)=DC|utlyi_zYDy3!U&Y$!;&#B zWvMY0XdgFU*`{++DNh~D+77U^#!39jrteQ`sb`-^aUXY7&Oc-pFtHBqeJ?&?9@M06 zg&mT|HyVIh+sZ8)&=3JMNmMpzxKTfA>vc?KmKGo$1SS#{#tM_)O5+_}(`&ItJpknM z8vRPRAGIRa+{g$yrO#vU#YH%9Za<$NRXcfe21cDkVQshb%%XDlAR(uo5#i)=)X407 zNHi!`<3f? zM&@xZQ@=v&3jt;CI;h{YHJU~m6fvjr34}^(X8y4-K$S+HeDz>EHU1cH+C3WRys=s1 zUvcm z`lXREEIi8s=rn`ES*m1FjKTIPty5K}3fCXb&*=MRw54>y_58VIH{TY0JloVanCD%= zrV)3~9FR+p{uzcX2-9iE3QEQqW1Ul&a~?RgQHY2e2Rvyb{m~NN9UTMs)qCk^cOY7S z1)LR(-}i;ac@XJl+-{cqD5BIofJ{AGkjQ0y%_0WeP^x53#R;ONf3oYwBYppE$UR?F z`|eEbWpgc#Uz3j_0`b6R59rTnR|3}F#Cd1 z)8AOQ2ERE56ExIuffZ{l?)4aJ-rSvpZz(n7%B05=fh!#;W$*3Xv-HcgO;qAM+xLa^ zYkzfEa21!Xx{yU=s<QVO+=+hXscC8%N^c57Z?6(J`aQEZgg)K zsuRpo9}oMkD2NSt<-h7lw9jIqkTK)_?zKg>;)*i4xJ*Na?n#PfQ_ET>!4PLV51cwf zK7x{Ha#V87EEoZtK`Z0EyunNxFs9nQASvWm0dMt#T#|R?L0Wt>aor@%u8M+`4e8~?(lY8#UsLx^&LK+Z<3fqEPs@!k? zW&yLx-jNZ0Ze&fJIeg#%uVstB?D}y@+h7&54T_c?N6nmVHQa9%AI}snsOC|$#9&e(u!Q30Tj=(;j&AXr*J~pU&tIb8bVXkli zPPXQj7SjgZ^MffyzVIiPXoT=dh7@&isr*sXgk_!VYa9=T{9Ym=xd{*E!uTik!CPc^ z>~9*Eh}_}pO{7KJg<6m*G_A;9+;U`D*xan3AOcRX`4A7H7O~g3WA?S<^9l)UxLP5+@IYv#ql3&2CS z*!ZU49BuSc`0s*{z}J`R({Dx{r@R^a?Sx2SP%NcVO>Ia50x8aNTTL zDRYEM^F`Wv=0680(1ezAeW7aBS3foOM;VwlCZlOJol%=_l$epdDV|E%|6wMK$G2L3 z)uDpkBkhUf?BT@G{wprtxKbe`^H`@Wfq+=DfDJKf@zkZ>R>=T%?Ol{hVq&gDnyVvH z&vUuKdlXmSXGv{tdRVWp8yL5cJNcUOGl~8m{~_fEhFIp_7GE;C7Gud&|Lek!2CG1g z%i85uG$pVYlyjA24xJD^lPj?2$$!-w$kkc?Z0rn)B|~_}^`7=*qtnNCeaCEQ*9^$$ z8OO+UP@2^8VK)K)uU}q|=W^n{&%+}tq-kalYD7$7l}s~*>AVf1em_7+1~$eA(%&yP zq?}`FWNLDuKnaph8kcNu(c9)=#NF}|LbR@5xSl0tB(q1(i>@*h6j>=5d(*DR7;-H> zy+J>sQTKZD|DG$<=qlXro{Zr8-cMz_RZt31V8jSNr=FCIZ7wc54Wp!&rk;O7*G!x( zVfuP(Vx&0Q4}qkGelYWsCE>GWo1*I;#gc<8JCv~=cGv3j@tINkD>81lO2(_ed~r*x zRCsl05UKGjQTwwW+pyLVsNWdkC0QyNUz&r6$}LjcIa( zfbQ%e`qx2~R#kSaHVa%q^0(1ni8TasXVc0`OXDca$Q(TK=Wq7wT~R-6hVwRbh*9hd z+k^kM5ESMx6`a@3s%z2fCi7R%tTtEbB_ZEl!&-BKh+?{ z?LWCgNr$txb#4F~>gkzt{}tm*-dPS^uTZL)W%!`6JE!y^q`!<;6_plf&bN%+rxDud1iI5G5BuyH53>@1;mSxedo>ZSEh zEe$+`Rxp@Zpp+n}mR*sXZCbZO;I8z&31hf2%&oCNw!XVoDYp^qD3lY3#)#RK&YDy z=iTC4=^_wD#(KuFP5rTapoh&K47B{lANeRxQ8vG}T(Xqdfg0b}I4<)R0X*~F(^1Oc z%kt_9s;dNQtW*w$y;n-#Yl#~&3=x;5leT&}C_-!vWuRT#()rcDULRK@GKM1V)J&^p zjux%Q8LcD!?B8A+L&==W?e0DB8G1AJm2JLj6jDM4RWO0HK#kb(yiL~KlJ7I)SKo)k zCp)>dn|0bC?s-Y-$qv41nV&^Q4ca4c1LjC;1}_}`nSHq08Qlta(6*6AkH)iLR}*%?@I_ui~V z6X6H#$g2CqYny3xP$X`0Kyt_#?pHzDJzQOIoWmk2D%XGZP*1(pv=B1Dnl;?QScm10k8T zj#6A3A?9eE2pqxFb>ibU3_X2c2@A9+SS}WlcQrYp5l^?^9cTk8N?fvYLVG_Put}44 zW}!x!#(@$f;(5E}_uqeGe`*qbp+F z9f+U|27}f$T3gxA`2WM)do;;$W!bvlQLaLy06?%*chBFm_y7OPwKwUmDiR`9C>KZF z!QSo(-aEyBX+|T9MF5!*9_MVa*0)w=-1~SeM(I9;TCC1;Yj9RLRv0ek4- zR?|I=>9Ks~b^S`i>G=JB=f!*Ee2YUb$UwG@+I6SNCqqBqPP4@A>@8Cjn6Y z*MG@q&Z{rT8A^qrZ>gO`NPyvbxp6ta@$&q{+siYj(~0Rik{3bdTPH+aGYlfO} zHW0iNCuxb4B50I(o;OufseF7p%IaYaMLXINJa9W5_Dy9*N zd9{uuFI=6WrUln@6yvb95@*ltB5>ThyCXg{#F!a|9f!jmm(!ViOS+sF2fI*^b%aRO zNOXPXmt_+vm6DmJ8?SG#Jbrv+*A4nSkK3-)IY($bjrSx4jf(Vq;c`BcnvR^(cDbb> zBeax+*q)1+$V&;tFf)!f-ri(i)-JINtdF z?Hg!^al74!abei?Io<`XrbyFt;t8>qoU3GatmC#2czk^1?%|#l zi}L#V%8FE3mW8Hi*zIg;s<$`bR4AAAB!JhqPAa z#t61NuX`Pg78{9CBEP6jXI7rELBmW;6i8a2u31!>6DVXKitxJqRm zR7vSoC0dmBE4e%iZv!)$6Zg??fCxmigT6^A0LU! z%*2N0 zbk)r-e5=Sj&0H=Q#@mhCc!70+S1S(>5A?g9wreDxA^5Ett)^nV0b7|AMV?DX+q43x zTbEWbY2HL(iL$U;;=<{CW|?JPzaF~l1GIkcYnadKi>by4Vx{fa?FK?4%A#-Izw!M1 zOf7}BYjs&IdDx3qJ+d2-eaPi}!dXY(^%7Bfy=}XrH7~<^r);h)6;3CA<}gT**PAYB zQxV5_N(t)&OI)~JuabPY`gkx@C$dRrEs1qEB5iwIW}OQ=@(Oy?P6_;g6#xJr07*na zR3n#+u`74#{qnK8{58gC9F%axKvr6sQZdp>^p$S?1Qd&iHL_%!!|KZd zOx?_qrApUPNvfhu*edUNaE_*H>AH@t7sXIP4ventaIWESJn-q`FRFG5jN{DZc9XG3 zvm+;%=d8O=5fH3o1zQS~RblDmy)}kH(!ISLpw)#yDH6wtR0_s9jB_+zFEyN|)k-%vD`U-DgE!J;`OwfgM;|8WV4?PxQkbhr@x_;g$ScsX60}jI2yq z6=Co31vzJlA*jeGt8LjI_U!k2USD73Gn2zcxe&l5crRU~_fn9Crp5b(X>`n!WD~8T z9qVLAjXJW5KRbF{r2%;)o&>-CB;hQslI51!#XFin%}6ueSbZNd9W*9qM>#>mUd zs~qsbGfoS)%Z;}6Kd5KkO_OaakjJ>h&BZ<~vsTy*UDwd}9n&;2jyDOhDuv_muqn}` z^O2M}W8~kLQh0rRT{YND<3fy)H9}yO;fh>#p=ko2KYym{d-nT-nC8^u0&L^Q5Q4gW zElt~S*zchf#(AQov`+41L{jC0weFjwL)4{XirOK*qjlb~H7nCiOrcGc9EcbN!@e%W zYmvqOs+OZxj9m}>OwN&IF}%G#@qFlU4w~R8X=XKKc3s1Mzvp_r@cjJ5*Dr-(x0(qh zQ0;WOaJk$z!(z!0OTn77ja@%~{w!Jd5BHiO6fjgh>;?RJI-NvZ(I=d-OyejH@8@UE zuPt3{P1G(=w?h8W~ zXj>;P_IVblC!(g5e0cGkc?X@hc&pLr#?Ur_rtw^F7jCmm3J!fs%!O&bQN6>LNbjns zx26l{=Wpc0J+2mfu-Ir=(!%+2!BFYjmf*#MC)0|$DeTs<(OPI(=jew)a_U3i`^z)_ z@+M==EOO(fX$ftM^?_<+uOv#@4(l6SGtnsNqo`tZ$wlON*5N{nZxbd(tn*as$iR{l z`F3Sm78xa4OSJ~;118HTyBZnYS?4h(&~!cBZlLXY^`ptC)0wdCnB-~rlU^?OcOS6U zN+s_*ylb(>Gf(1DmaeAdu)n7X3#D3Wl`3YaatO6;plKyg=X`qO?ev0kmVUR}kkreP zh_UecdgkTjnYL}YySwM^?vefe$mw+6=8)+!DyqeDxH}SDORbW`m@5p<)As}3>SEh_ z_Pape%lHk@{l!Gi7uu%B`$kaxDo<|O24i5+Wpj+Ps>Ukk^ND3yWI=zsvfuBwK%RM? zx4*`5WS*m--S;24oG!%p&MpgH+S*|l*c}e+jz`kG@b>n~`Etd#ZZj4-=ZN!yvxbM` z9rf45YuEGq^33bo3vpV&2nZR!1X#3V+M_PsJ7?_Tu?5bK7Hgr{^K8f`0xSa>?SZMwQ{@N$mPs+6nW-6jhtRz zvBnXXs3W&Gu9qv*I4UO!j9!{6Q!N+SC#__HQZilN&=0MQnn=Vvu|z@l1Rv4$+Z&tM!=jLdUljsm@G+9&??uP^ldz;3q_%uO{Y1Cu3Y+>)?1v(ghn zXw-Z3E=gXo@y1F*YC%#@SF3=KjxC{ha*CvRWJwFHcNp)Lpi#AWGT;mt5v4S}r`UE2 zK)a12%d|*F(f+`0*wciLzI7Pe;hS}D2vB8Y6Fk8Md?VpltXVR((D#AHTT-;#$|7$0 z`6?MN*3kQkuM25Bvs|teO?I?fRS!ZvlQ@d zXadLkJ03rN;P)@TbGh9JO`zWm^nK66$4~V813>|mRuy{&=z34v?L?7QGUIgP?d_Fi ziY!@+vZkd)qD+il7Lo*8B*GyZ<|qUO5QDmFIxYM}P3D`Hw%ZfhL2{cgAmiw@sQwvWKlO6?fBxV9@BPrx!z1U+us1X@ZrRYoFwk~|ZrJk|6sfO?i$eYt zli7#IM{c)YWLFV1M}A#A8O!~B#X9-W+~41GI2>@+ak*Z&oG*;Gk@H!)Bj*E;A07!! zOG=WBf-!Qj_#hFw)5!IDC1t^uho+IS%RDnJ3zyr--F;=f^{o}0MlF@=b>!{!#5B#U z9Iv;x6Z1T8#>R1+RJA2-_dGA^33?|zhY~Zi$w)M7j`|#+#VRjN$9o%$F};czb*0mrtKG#7Mr6 zuImJJd3xjZ^-bilKCmp2X_|2wlbm9~TMt%bz-`lVe}B)%k01HVUq18k;|IBTvzXl~ zP*Y^mJ;7C-=j)|zjU~s-`FxWgFY4xZF`$=I!FfleV5(eJSY7O+SRfr4B2gZ)cQ6I( z4PD>T_Z=~2g_cT(bG=jy<#t`byl$eAd7fpFo+HkQLUCTCqVL)u zT}suxSW#>|MUX7klCn^(!D6$)C9BcMqHe4?vE+rC7bKOk;MDwVt;2bX@rG)p3vaE* zH-;E3mQ0)zHCL7;aXw%9{{4lT3w@`t<4M?PHn`2)>n#{>Y5JCGtkSm^N-S$}PvZ@3 z5PV6TZ}_IA>j%2lL6xb=cs)~%qaF4%JnXW-mP5gDC8$3#xpGR9vRGtXf`Q{vjE*8{Eq^e8?RNKk z{HUG}E7gPnj)#`MJ*r1!-WI=Y+bX|Ie(bES?yl?c&U3k(xLhyqGgeLS>-vGi@knS| z{`R-Ou`CP2b%*zk!(q?ia7WIW{r`i-~K8(k-d+&IqqGdKEsTSDlB z-Q^M~iCOFJ?v7fGRMauiG%Zah820bqpBTrHzVAfnFplIRNpc}b_DikuT9zW=Q`Wpg zBvTf((&c*FOp))>Wf`sgc=6OKkDCwgOtv3cY#^?FucC}~gpl&c?IwT5pnjC9?&NU{ z1SBhFl;Rw^0&|S^{toyzDLIj}p^ysa4cPRJ>wgd}9Gm zHnK;nrjSV#>r`Epe^ARgTI0l+8x5Yq5)viCqTH+Jr&pF~rtccMUQj456pDjtwcsh4 z-T)!si(+$JCE1McBrYJuKxhMTS#%8P=(>icag-v@i*w+c28qYM(%w$I-V)!xedBVy z>dz}M*OgANeyz5OcLbFsMd@}{W9qOQ_}qBr<&K=H;+OWUoV=3W-Tjiyrk^W)mQzwt zto0b{$*JIx3)@zs#?Upp2l?5ObTI4Z-Kx9QR7WacvV1OMu9!Jtf^rv4QIwDu?wn>R zHN8wze&WjI=Uy)3I1_>%Vk#$;1)WT3~uk2&?+*pps%?ngqtz1{qH| z`##zFx0eo^|ko ziP`Ut91aKOWo9>snyhIXg70Ws%Rm0!@;AL)Qc8jYxm;8>*l>UM0f`gsrR{dD8mkiX zBIpO-NTqQ+9=Ah$x7*Qmy|~MPw(IHp9jDVt)nqOE{gGi9u*PnOu5+HD@0rI*zYi<< zC%Zk1iW}g4VF_}%Op{dbqIhcvZA;rryFHF0m&-+RIW#2H)T+|%jJJW5g$y7D*2+AK zf5JOQ6J%^B3vIoua%7sMi+g%{){d^=t>Yj6_y^7kqfEwJ4VTM>+bH2j-pkC`djT0X zp`mR8hr^yYT5h+IX_?3+;e(;K4bz;-NZychvd9%^XcZ4m$|MqP zXl1YBWt?Zcr8Tk}ko@?9Ges^Jc}Rr(+wa6syDThm!MKWVI(;8x?CG>~^Ujd1!`Fr! zJY>t{Jo6OEY2kE=+-|yO@)p}x_OTAvSTnoL`rT~)R@2JQ?iVMjIju=(n8w`qNT#JB$l|yE$K7*&Kh88s}+LeMTMrByQQw-j2rVIax~`*XMbEyD+q$;FJI`!jiSNk&mB}VVg0hj8S4sHlXBmb;X8+y$w5aG^L9FulX^f>B6v02IS1ZzIlb}q`I*!C4XcJlV=HarvB5F)9n(CCDXuC8 z#RpQ%YM_LaikOEtVzj00#1I@)rYsp_#VcWL!DMmGdoNvS(|Ag?O!Jj#nk1^YK)oco zzGp{YA6hN=1iwTn81Jy&;waQCqdY;w7&&|?lA4k4;Be)TM6Y} zmff`$#<*Zp#8Sw{FeUk1H)KpnT&IQW+nKj(=QGndQ_740SfyC*`iKp^6mhedL7ji6H8ftu0LXhlsej_jB{X!c#Pd4m z1Rkff+w2N0N-Qob!%B7+Z7YXzPV&LZVq=w1og!H7b!KVI`r-77N)OD7RFi^0f9HA0 zsK;VW#+Zb&m7pk$&^DXDV0AB7m86QJUtZ{S$MB=yrPej|vcq7=xk`4rnQ7aOu5ZO_ zvU+>SbgjqPpd+X9Lz^u)80ST?lh%NtW!WMLa!%x!n5Rjjk6S9xG_CBJbf<%{Snmne zk*pp}F_DYl>^D|emIu1)x-Hk^$K=V~Zcp2Gn~%n~4K7I4v>xVb+rM5QE8?eZTm3M~ zg;uMu=B#GEh+3s3#|7&GAyi5$7qx&f!*=-zivEqqhX+b2yuH1#EDOiOj{R=OG)s`! z{lf$I_m4b2e&GJ@p8bBHZ3Bnhj(+G=7MxiY<=r_$+cdOYOE*Q%;i}k@u(8`@kUHD^KFuUj*A`^^0_&k zPh77T5m4x7!+XaP7y6;+{_%ls7nfq(|Si6oVxnu(wA{*kxcH(7o~bD4QRw7Rlj}k#pWKOEHRQsA*b` z#|PO(8rey;8dE+^GvB^_T(t~Q7&2jUdxvEZH&Q(bp*DEL{l?FteV}LrqksT#3gTlxb;?@ z=lBO2aa@ufaPP}#kP3?`2X1RcYaWxxqK!4%fhLuvEW=Vt!hN#x>%9J%>zsP6>Vs?P zJ6X<4M$MufKn5Z?6`XrF8di!vFh!U6lDlD6ifye#-IJ{C`D)_KszJv&?U<}4*ok^; zy(Eq99@Z>y)Nw5fS5K}I6(IXA2}a5}i!4`v_86lS2fD)wp~1C{C}h-+b37impKFyt zZ=gh>8nP@RD9EKK3r_q!$HShsZMa-^)RN_ct7;rjDr=ShJa z|H8MYCzh1Nv!h*=bBffk3_0y7o3nZrittI$}~%WoI%FW!CCq?u#*w}eCeSKwK7E+GP^FmB#hCNc8 zg9hixnd+T{5QZAWuk{0*^Jjeh)XSysWtVWdT*NWDEc}S2UT21rA~*zgScy@juFm>* z{6rNkIkt!zLR&d;WXrtQMP*!R5Y@V1mQb8RR=!v3`ppz&tR)sXXreCrX*aNf!2tIDgiQ>nNRrz=g@%kQ&^0Hj-OyAJ0q z{U9<-?}eZ%2eK}5^&;rfKpO(ad3J|A504LwqeS%fUC-`t;N#;X$Gdxxpmr_ZJ8G5J zJ*HXqa5-_go_KkEg$n&J&~?4Yf2Wb>mlvL%o_KzF;_dB?^I1BXbvLpFC{-~n3Y*Cj zryG~^MHl?)+;*0%U9z)=91C-f%u$}T5FAUYlrfT1q~uKF8?1>c%4m6f{J^ij{*{M^ z2ijprXgdKpIwv&lTEwGc4gJvb`SY(lJU()}UHJXC-}(2y{>|-rAuS6DwxGG-MRA#O zh77LpG;ND@cH1dc%~%2?XDJ(HlZkWYwxD?vXFc%qFJHQy3 zLbQ!g7fLPkF|*53-QT8#IcBmEE?6^p%%yNTpSh+RQ-#(-*Eoj0p=&H@PRuzn&5}ZC zeV`&cg=%C!WpLmH4--@2<@L(T>y;&0d=PM~F^-%y4N{-S5TtNz+CWj#x>1pXnB!M< zl?JMcI=mvIym4G+ z2?H}2hTVa?{hp5x54^k{nQkN3+nH}K&k{g4JDl9g+ErENX<-^?rhXP_df(ETW*a;I zjIW=1xvWdz^+M^o?uTmsJsEQIN!WE<(%^kVtws;tMzGz+$e1Xl?Q%&eF-@b$CXJ-~ zxnQ@MCApAdA?8e~YtH-HEy%cr4ZvssQE*VIl9|i)KuD*R$mTsJdDXzzQiyrkqJm|A zV77y@B3TjEtr~QBV~wfQnx&*Ol7ZvBRFf&oZbC+YauF>{#9G-twN0ZA`NE{$n3aYs zUWP!f;_P)G(nRM38kmu>N0L~Bs>ZyOE6y97Z!s=XihM8CR2)`6SY|`0%u50zx$Kn{ z5?Xaee=f4v| z5DZM)aX22?4Lh0;lsvsE4hz<4e6Yq7jPsRoyhzvCcuJLwl=Jz_)AuKyo}bi@)bsH0 zi1&@|?dj|yOLT9O9*&x*$+DzW8_TN?(ja~f@eupc1Ae~ zhTTEVm0{?3czEQ~r_bEq-D9oedb_Z^y^yk)5O34MoD#WKLKDCkj>jYW{Z5R_-Hzko zp2PmgKmYr`d3k;!#VG!)Mv@$tMfh25*NfOD%ZO&(1H@Q#e5P^Zp&=HSmxX1HBwg-9 zAlD4FFh}_QeBn0DJUra->G6?W+pudJ8YifhR5OjWbWLE`NpM;&a2scqRH)9g)XL@J zF(s15QT9UC35MT!`fgx9wB!_tHM1XD+ODB(I}t-QcT%*=;Jx!#P+3z~`yFJH4N7q=!X=Isq zbba9UbYWBoY07omSyw&pQc6sV5CCLk_b1)CT(8${TqX2Z9Vz`EzKHi!M)`O0&t4B{ z!^-6XDA{dpc4Ht$=>l9bx==2pH0y{r?^~h#(HXze2p9lN@#5dKxsbk8b9LunLPX$7?cDAdzxk+%9@0;cGKlB$_8dhr_hcSR$5 zx7Wf5DLd!P>3n8dW`_Nay*)7WJ%e^X(=vgrI3UGEMm0X@$Ti|@!P(4y*V1)8xf)(x zo;aPZeEt5y^UI02WQKl6XnKbIk&hpAG*M;rw=4^kHT12)8&7CG{ui%sQIXEh^GL~= zu50LeQ8`*hob`l8Mr89mvE&JBJ$={HwXG71?S@I3rish#%G1j;=gXC8mM$@4G0su+ z^#Q}(-I2rbNY}QsP0L??{X3sNd}bK-{Qv*!fAReEMBBFdnX;sElbu^LNZjr$G1|^J zuz^&g^25Bi;&BQ)j4Ux@jKjD<#!3{1ftVdnZ&$uP&3t=$XI`TzBGA3nix0&C+eB<9=zVX|aC#ES;O+!J9s}(k1kTKwm7%kSwE-p z=Kk@FTc!Q0Sjg%aQi$ON@0=1UGbugr@`=C-O=7iF>xPus&F`;Mqo zRWYmu5xp4JjQR?!_4;>tU0c2ImSujQ>Fa?MLZEAVobjYN ziLO3~`lYBr(>hPz?{V(L5@oqqs^Igh9-_`Qv|WK|!m#GK1e_D9Z_{>Q*=F1zqeNpZ zZD=SZu}sS*GnRr+g59hJh#9TqjFCTA z+qcYd=6XIeuYQTP!C6D!wKyj`J%hO9LlF0Tt%cXuH@Hr^`jqFUHY!1IPW5{r*VP_grryr_+hkNlb~QRPOKY_^?`;k1nJ`OK5s(g|_X;Q7G6!i2}wLY?ThiRN+p6fow5WiVQJGLrgMec1@7% zl@gg_~X+=1L-COwpoN^Kf)DwsP61RU^KYh5*~yQRZ3nM$CJ>ffzf5=dB=T!&)u=7X$;5XzJlaBpvzl?T0xcS|F#@A21T$)CJjBVR)(p^dJ%iH2v@++ooVJ~AShxdY_ z9>`Fy0Jl{xsLC$ip7%RCj&U?)rPs$=QdO5mnQ7Eo;U9y)|;PFmbsA?!%m+z${ zar;~OU|p^^F4r56A3tE7XSzsb|Mv1q6CB6AjL7;*(G3r%PlhMu5E`L>TN^Gqc3dRwU9Ux@|A8rv#PS`#Mq7NTTP&{bo%|6axhMS!M8cxl#J za-6BUr(4ya#ej7kZPyUIj8?@aaU-RU&<5t|%G=8~3?et)?>as_-f@3-#9$dmF*JAG z4ygBR1gbm&=fFD&v z?;jw+Ra~#4$+y-r3?1G}sFyJ-=yAe(OWOp@dSE%J)~Qv@K^jvlK{r)hxoPtx$RVew zi&zQT?yuGk&CpHf)CC1?-$MfSo3j=fnGa@bp+{*A!kmzfgf63J2Gqq|NhwY6q)S}@*Gt6n6|kg_L^k(iU1M?)iRzIIe1;)pnJlv?c( zNxmA+GOQoEwfk~L-XCi%##yYY4A)CFmxA*RwPbGN$kX!+T|aPtcPAnY7nqmGJdZMp z)Dc9Z9*7T*4|o$eU(fvOUtjq4{e|mwB(y!lPDVvGBQp4$sPlx;y^vgTGOqB>BMpby zq}$TL7@FX*RDzQz?Y0#L-c<{wT8fB5)JG6pAUL5olu`t+iHtQQ9W-t64!`{JnScD_ zKY4uoNYnPX&@kO5&gXGU{Cv23Y0$wbHPyb*_~%ej~xc#XstU{QIR=PjLh?e7;mJq@OB!hN=LZg zHynmQ@I95xG|eJ^HXdsN!_djN&3XF1BUhn$WIfcqsWgMA*RJO)(`{m!BDdRubq%E& zUS3c9_VtO^(~ZlxP_m&3Jz1skGPRIEJ#;5;l)JV~UzP>x`=w&5d`7J?YNeCoQy3QS z-Otwb+f`&_AWI=7ujQ%|)neG_c&-UFI!+Bf5Sq+9&4Bor`mW`CzVQ0`OpG&K*U|s- zncdK`8#;0-lq?Y@&db>{^bMc=2hQg+-+uqXvp&L6g^PXj%4IqF<>vbe%dZdC<#R~F8V~ zGp)~7MRqO5t~-d8mMbmzs%Fbsh`QnveOJNdoCzUlFqlRdP-z=E;A>7S%Sh9B+Q##~ z!*DdMM?9(ptK)*CGI6ZDmP^b8kD_r3DbE<=Nl~Pug5;3!q+DcV<-OudipU;Qj%d6R zRmXkuVbw~mzK_356*XQ_N$sYpTQ6GgWTL2-ZC2O#`F!Kswt#NE7rCc6R6b^qkNMg$SgdiMJrWF39SW!HCV->SYz-( z1RfKqZ@LAYk-e_dOI#V|mvXXbL-uza=)uwr-8c_iq4o95x!pi&p zEU^W}h^ngTNL9oXyThL2@rd`1@ivL0zZ4-&Od}X*o4|FvNklLrWo^1a;+Wk#jMV#} z5@x57+#+be+KsLZa*S>iZfoRnaE_GM?*AYc%y_1zh3k|s^`@CGffU6zl#_+(Rqmg_ z2l}0UKAoecBL0&K(>N2CncXnZwH=qs$h;(s3v`3Ug`T=3I8T73>vlB#kyHvxF3Oe5 zYT$%YD>+NtLdj*jC@@Bg3{B7#PQey_Coh0e!H(`?Rqg1U#1O2}-{|jIk!cQ85)xu) zeM2o11qe;Uus_grov3K%NLArQ2#tO|iu$$GN>LFKfYLD5Sn#z-jY{hN^zkEy!;Y7i zC)(h7yuauEc*G$4=@e&Dnm1C)&-nVOmrGT2d0yW<3*BnVEF zJZ;y|1dlP5m?T)IWHFARqlxlEwO^|EB`QKXt+{M_9;2D?DM?<%JPC`-SgYeBuODvt z-kK&*tBMkaUPn>OHY!`H1nbmNwx0+6kgemNlrrNu$z@_zc%j|)F>?781divou4&!7 ztQYb6->=@FUaKl+HKkEI5o--G&KNx1ZpYf$)*30*YWP^d*uu1o+{P<&l!|CozDUI) z?K?)sCCegC=L)1Kqsldz(CGZRRQXV13SAq>*{F*d-HWNY)vo)BinW!RD%#3W%etI? zmvyeAuu=*oE9B1zU+nAG?_4f7+O}btCgy3xJ0pIYoVi|ZOt(q*LK9C<;^Ua-0(3N; z817QhC|N4jJB@hGm?9tCtjU4S6tWQ}n|B^>oT{p1e3X*e6n=7G2?Ayvd6bf*s?CvH z4LLj3nA}{-X6Rj?QH*8iJJ~gjGyn5H|HCvclxo=R4|LrQ-}RI#-;bbLyimw3R0I3N zp1=P6@A#(SfByO3jN^^VH8IUM`mU3ZuOQ}3AA%B|4Jl@_K98=-;aRPCK59xh9V4%b z&$ZK~nCur=kwj$@#_WR9|s8ornv~wA7 z$yB1GBI7|7Amp<0?F3}H7N$Rj>>0&Tt+H+@l7%FZ(n3lWoWuG6DPdiu?RPXPIGL4u z*9`~m9zW9U_Oc(#QtXv7<6Ofy$;3dWL_yC3EqLe1oHE9Hf;a4T9j$uA?(dIuUBfcX zN^YO9=zjVqef`wSMer7N8*{8*#)x!R#tB9%wlWRJ>;mh)v-p%G%3CQLRmY;n7)n#6Si^45Hr9*G9of%OI;;^F+BG`HT*XXV z3zY?LD~)ze-daqNZgEak3%5cnGjl!>i{b*2%H>wcjZgh7GqSk*}9|2I17E( zG0ziKg)lY*d?{G(F+PYrAT5Al=yyDP_{hVDj|^?g<@82O;~ zu4C2n^(qic@0b<|vHSG#QA7hy!pi1l=H=yu^XXN8jz8%_pPJ*YnNe1NWyHs*FRa-{9IIlk z@j|5a&I*Gq$r92zO9Dz>)a>cS6sXEB6C-h&sa}3BA1sacSiq$uGHmC?aHu|jqDE0l zk@#X`bu1*~A^2mw^7@|2!7EV8;)L5YO_N-FO;GVel?$+1oQ~kE6BSc66`T_ki;;a& zO!AsYW`~L=)=Nq^yfPv*a#^XDN&HAz0f*9!Rb#07&(Z?Rc&ku10=TtK(jH@EoMy&( zB&AGf-$T|ahF~2zS8n6P5)*fadmbJhd3bna7{n`MTp*XqG~aL`Fob4PA@0MGySoP+ zqgY}}eE9g0)8)*|>+=?-W{jm!m>0=XFS%->q*L0%JJKg9If7DTjcg5M={9nSIz=*= zoFx#;D!@wj5T#l$9^3TT+EPm-#+fuHQceOCEg7o{sm3N6FZ--@?Bm>R+waK zmGPPNmQ>`m@m|Jb(dnhV3cV%-=4GNA26?W%rwQ7%=EC`WCFjC^f8g%! zfe#NK*zXQ9y0ljjEaXZskcxyBPV+?D210Pm(J)Ul*V~PkmltAzYAoX{G?ZUHeWdRP zN7&hkF;C*8T6Pj9SQ7rB%TTnY7E`>lqz5abYy{Gi;*Md#}gG{w&c zh01x0!AM)1-(|w<4ue(RsWQo2&>6ohJ;clzsQn=O8sDfwYoS)DE~hHklB!GoA603q ziV4_8KHkfyPw39?e4uF>$t4ShMI&ujZ;SKq7obR~6Vz3vTi11P1X(Y`^%*)I z4|HA7E?N8~f|#k>`?W?!SNwL+`?jIjMZO>H0%e>j`w5Xu%bzc(mH=%f%@JedzfBse zY_w}Mn(HIxGx^I{dF`!pG);@ChAB&4%k_GbXUrN7$32JR9lmLpbU|K9C3uyWcf#r0 z@An)I2l{@%D75f=xp8`X<8r&`#sxN#b5Y%G+@6y@_< zlF}KR!v^_0wZZ8#gKoH`Knb1fOk>e!D+Ed|_+V&kz{qdfz5dw0GNzXEiv5wHT!UNMCoxe%3U?gAH7v~#uAjkLR}s#bGl+qTrc zmqJ?2N!C=nMJrhVOJ3CYsA@20)E|?eB#ET63X*fxVT#!#fgi%~9mStz8 zzpmCSn2)%cN96%so&Re!EU21HP9wIyFTbiTOxhQ! z8VbSrcn>pQi2BZQBw>kpxiFnR1BXKI|QNieC4v@!(pEixNcvg;SXkd;domr)mAY z3kr>7RTpZ6ht+|^V4x9hFL+NX^D3iX>zje!rDl{ODmddX9=vrpZ^(KuwXL)j-rc|B z?*1Mh0>{&thlfXE%yjJ_A)jrB4}oc#czJnIHDXW7h12Q8;qbze3-gkg<3iJRJiVOg z`kt<9wRA4fwF7V7yy0^B#O>u)Dhc*Gx>k~r?N*-qe(FuziJ2 z*_E_7H za>V(oZ!KoY5L;$RU(PXORbpO>p;S`US|~C>6y*~!MuOBb3Wv*|Nz&FO$XPp1($$hu;(R>u{QSZ=&RpghjHBzNf2s;W#~(XXm6YV=iQ=&L z&LWGUvDx-fst5M~WQ0)ocQS>FyMN*mxHAK`K4@Oc3ivFxH=BlcLwZU->6kXMPuhM2y zEjg1U-K3DmtZjxVXSt*rkMZKm!H6;~ku^a;2N7F{B}t@vikM=t4oph8Ec}bWAXX9v zw8O)$>b9)VkI}8r0%8%n_$LCl$1__LTIMOC9%5urF^z&K*A zyn=2iI!uVDQBV-MbgUK-Ivs{Zj%~fcB#EZVnvXcoSz%SD3FURbo`r)}`@}TW{4nXc zmk53lt61mpjiVd3?6x=f(8?C_auQ*TlO*&7iC1cx4r66|iZPNeiD?>nel(r+SCrrP z_TMTcA>BxKcS%Vzgn-o0-67o|NDUvxfDL}7f zrhaBqT+@G=6jhI}Fi&2gyme;RBF#WGntCN^9&ZOp23{Q@!cph91ERU}hkO~b_C|@N z4UL@K0!tQgZXIL2EQ=bJO124M2FzS7vG`TPQI)u5eNmITR(olGjk9IFl~Ky-y_}ZY zN>mV?gXsl4+}&Ro4iGJ_hH14>+i4W03LeZb^AY166#~}=>!pQaI?C5K@oeSvs!>Gd z>bA<@ndm{|=w#!fy|XMY4kK4?dX}cKR%J4aWUPnTC__-P6p>X3X&{3X8%IeqlALe# z-43{Lq2ZIgn2ombw`QZzD_q>K1F2$pk$5XBe?EC$M}_?6bruGYTJHoww@J zh%g|5zLV=;P89y~?#VJd9=Y)F>S?S|R;idv4vw0=QTh62nO3tr`7U&M?{kBOhPk}14Lbg8_i)TatcLTHd5g1%{OzM ziK?W@u zqTEz(cmN3PC#gJ)uKZ(>f35(8uSJwnd2;HKvbnv}3zKQR@QYg=^Ft!y2|(2~Yj454 z_)}sc9W^32P_);7R3>YdTvzc=ZEVvUbf6YpRHVvtV@=8-o9j`lRx;1pyH&B9P{5cD z!vQY_iOSPZHw{i-V#-@ zYM!GSu_=eV1f9%TlzE70hzMCFm?~@Io6k~yl+L>&7kkCb67(wq)5#kdb-p)#D^U{` zmxgP!F2kT{`|H9yxv1se)w@O4washklgF>2Ydc3cKvarFI~{31e7&chQ$j-W>?^>f z7#>DX9DY>_&-AAl6?3>UEh6jh?|=1S$9-^F&R%|bt4694Qz?p;>NiD>^?o{dn$O?t zBSB{EH=M}swjInnAwexEqq(aY3Ria07g^#}w|?ck6Ies?x>m$voRlHz9Vflj2o+=7 zZAAPVpYSS_W8TFNI;)hlT(dv#6%_kZrk&ArqDXe|)vstmgn) z_^z%rW#(iY`_HjEL=n3%%v^``fattCr zbgC9#;B!D+XtqP{v2(S9W|t%QCx=HL@{|2fQGzBkYc#Sb(prHg1R~j8LS2;?SHdxZ zSj31peHLId36?%1=ZgEL(`otd@?{kHCYa$@0^dzZZ^%F;$Ny;o_69Q3?9=>iqMBVs zTC32@f@l_%72V4r$$iJiRn^qSHsXwJ8cY z??|L1S89>+mnKo`K%ZVV8YYv=z6I1+z5rI$rpS&4C|AsBk%Yj6K!!UrN=vhnqJm%r zuQiZNqOXq1NPqKL6mcfdTMGl1qs=+?OzJndX{cD0ITEFSQ^eBG<=Iqto{Aj#9z%Zh zRT+b}J;I0;l6-rs3r7-9K`P+`p@G`WcTKe;$q-vfVC=A0f7saR4pJ_EAOHv6xV>*2;5&~DKY?fb}c5YLqjxsMiavBWzCQr z&gjr-gcCGL$e{fA!$>6{*%{O_RL?n%WKANmY{u$+kvKROX8Gbk(&WSgkBIKD2HipE zc@`Z}JK&Y`ro_RRMPzT5Ta+|L)jD^_+tE~KTUT!|d((rY;3-@__0P(mwfJPV#}3|v zLd7)wCZpt^84kuRxljRh!r#ZfjV}G$LEx5jJo#z@S-C$dXh=Z>XG)_-6rSm<7(7FL zL#~3riM=EBTzs^ZK05MWxE{~*+5QRpLAM!U-a%+BA%8_tC8j`1f@{mmrf>9kj**I6 z2*&G{7fYsSP5wI`tyAUij4}3C?|;holA)4o zVyM0BJjWEGwBoBV_h8hp+ffK~tm;K61j)+Pg@uDt_@NYq+w;jd`9*4Dkw4Y^f{$Y9 zG0NquwB9RJ82^)Xd^Kdm`Pz+tZe~AH|V$vnJQ+B`V*nQqxS?+Jab6y`3 z2`oOa5QqPL+{*9(S zcJwJITS&Lr@sglVJDh*nJ7L?uOv#pBc?;2Oc~|Z&ou@%|aLTRx*d$y3?6PS_-Swcz zZR1@THO1S4GrXzdsAn-j2PLlU53IdaO0LoWqQwSN8l56gsxX$wwlMz}h=P`agPyRR zw88$mw~F*zgq^VXtm!(YQ&rm&VexU1kH{npVV4uWMQ22k%!FRs8?WG(G9YWEfcZ_; zSUp9^bF8ejHtIz>%&R_alnfJ2Z^BE!#K6OEAmnKSn5+~*MO9eg)#)5RI+u=tb}b|0 z)qm|1ia-Ce`WerlMQlY}qMD*s)m*1>Dnw_I$ub027_W9w6|$Y9)rR<}9588#RAR<; zc1f7Iam+GkrTOOf=@%yz4j?*KG@qP?j2@r6^%7GM;8Bf!Dph^EgGKMzPAi}Xp;$bcEt_sD7=YpMhu5Fe3+g_x?G}vHiv&H~gk96D0G`qehaIo3PvmyoNcyKj`rr4B zGc%_OEWh7oPxRO}FrXj=)g`2*&VhJ02_B9{LtJD3^l89r-u4;3NNw2S?t~q#>3HW0 zV^bwi_|0#jIz${dfyHDf`L6=1ImpW&uo+Q?7t)-1xe?13P8#xqcBKJ|S;k5*#`6T#+!7>Qr#VsuGiUACfq;;!g;?AhG>B7@LE`+hD~ zt?97Td@xAAe^8WH%G~@o-&n1fMeIYSlX)g*YTEZb6RM5sIbtb1Y}a5!>rW_BGf9Qz);5JCt< z_Y0VHhXhCdATfDyZD6H;M87k#?ltuA^ejGygxIcU2lU!x;>Gimq;MglT}Vyx7Jq==4uf9Bus~wmH2I-wH*hi-xl7%2^&sc z4jBdtfrkY3&4Jl-3Ud2pk88ITneaHDyHw7%T@`(|WT_p-PJ#ZZhGlHOuNU& z$N@JwKB0luHaJaRe0L6B&=<|oic`sAqcV>*Z*Je7J|#>MRpx+Goc?80^+ort5zKS( zJw0=OWvC4p*Yu)(Vxc+=%ExRuNyhczTw`p69bz`&3fNFHA*XI<{@BrY=Zo- zA5LM%iHn73>p4YKI}kWjW1p_@AsEcM9)`{viqKb=mjSmFAX>68wM|z*duzq0LR$iE zNo|uPODBWG^@OsG)=>oY1AV-S&^_hW5^p7iz}{!8@u;b0PB@TUVw*+kBO)SdC;C?5 zZIrul3F`SppHEBSv1D%xN29*T#@egjGHi;~^s7EjVQz<>TC)j%+lyU}`Axs2`{V3# z(AHS@XT|&x^f&>&cIrjHD{s%(7nr3ai9$cTDL|{z9lTnbL%%6{whgySx3OqnruVa> zz3JKW+uGZMxWoJcpVMK*wzol2R@F9H#UpzFNyr_5D^VZ6>VCT7=tXaCua^HR3Kz|F zkd?E4>8U2sP1R~#RN3KTcqJmz(b)~0cwBfpvgN) z$^qTg60ft*0pl;XX6NR>#9_kxy}$Q~K*Tx!2fyQ+z0z)XsXXNmkjDuemsP7An@mG| z5GU5?_)l{tYRMS(-5}@v&Z$gD6H~{E>*q?4Vl*zq1E1J(EF6L$>mX)Ix-ik% zG&5xgW(RjvMDwy|r0&NR3p>A+T{WqrR0W|PTQdmG@vD?{td_W$``i%LWxcnP8SX9{wyG-8X-wSp^o!?EE#4>9KQy7TkIOicYrYt@7Zh+Ie ztLvb@knF^%_NYWZ15y4RCfsLhPg&k~(q)rN`evALxF4*|T4m9)i`Q_C=;XI>3m&R2I|-3Fl*4V#3o z7gXhCodcIo(Q1AVofr!wmj+EZJM7eJ$3qNQLKF=g-g*%|N@gDVzz+|NfLbd?^`@dr z?EJxF%?o<$-miZ-ERNgv1AcLjHtqMng?j3Xl~VG(aop_+kc?_-mO! zUKI3NeJO_ZzsxDmUxH3fbzrq>I%QEYG+0)ZW14J^kH_Tr{#*89JX7!c&(5ERlnu(S z=PgC|Qd>O)o^?%b?v5`#%Dc_tlf`0>(RY(C~+*&7QWZxkG0m(W&2O#k@n*zjcy>T?Ke74Tx_w&1AQM4&PM~mE*lMU){8RVwB5N(Uny~`* zQJwkkeQwS1=}PS{M=R|6$He^O3k9PZ^qb=c0oTEfgZYDr;*i1AI(XB9ARV5(M!m}G z`5|_`v@#mD%L=yti1a>Y%Lf^^F!JHXuE}w8(sep9IoBn2k$#)LkE*28O9hp9kckOQ z;x`iX8K|y`{Q0x&@qEQ)BEqYI@6?&a!({VbJhleiOuEro1b85iBZ12C zjhZ_1GKsPj49dp_Dya>GgS>0OnLG-|1nD6`Wwv3sYVD9bz^O zV%P5-32$iT_RU{7#BMP`W36{*?W$ZT>!NJZiK3h@>|CrpYBkG;0x|5qnUbQ7AuN7- zsd>VYNP!HvN{DUkgO)U0y7$4>@#UsCq7G47E&~{H+-6Zf#u$V#y7h zZXa$101_|e>ye_RW-ee7_jNUR>+${?fI53f|%4iLk$F@)*|NaU@oBy6K&t_aq+jISZ6T^UTHi<8zpH}XosSgY*$fMuFvZx##&sQ zs*Ot?g5LQ)C#yEJI{b_AoJ+p}e(<-uUH&K?0tL^ts!z~`bt-bDv~Khd z8rt#A;{t==v`Zs^OXarm$FmUea2vF~ciS^R4BV3fo19&VWl?`h4(w;!fq`A{{EwwW zuipp$&rh#brKQ>C0isN^tf^0Am0Z%9Ks;DZ8C87d3%d=pkKLE;`sOj#EJL9s|L85{3+5~pY4`Y2B<+gh4=uwT~6w90$2A`-^V60HQBmwI} z#24!3`Wli}W1@X%Lg`sMv`z~93-rd0TP5ZJ6DgA5oT$>zS$V_Eq=R1))_FH8$OQz- zZ}&&z{#or#BeI$xsU*f8>T~Tbc3HYSIc@{|3QB4K(BrG|ke1WP7h`t053AV98`0lF zI&rf~|JLmo-X7&(f7lprc@E~uC~;w`s&y%H;8Den#>G)*F?il45QR;uopVMi%K^u$ zLdsE3R}*8Sjx^XWoS#s(--p9As~?WFX~XO)ppK_v0t`ldMF3hY1ovy^xk}8f#qYX3 z^b+{bJ7(^T6bYFjN5gWp=K4fo;JlrcNl;i$o`qP{a_ot6g?0X%Z>p)Uy#ni?GAFYvyHg;Sb z%n@>~d;QPt>MRg7EDYu?AqmWuyPp%{(&fd3g0xuDQcuOVOX=U7!M2N48&2q$6&+rT z*HT@;!*fcSB*rKh@Y%I=v@~8{f<|^(J4M-;TqtdVr`1|bLA7u1YSZjD)L%QfX|O>{ zBoAb0`(=`f!YVl7vvgb)`OOZf?+^-3vj zLwYp^sax+#0g4%eSH=ln!Uv;eG*5@tKUrpN;c1lH7Tg8d21;~ z8X2keEZ6tlHPFA=_Jho-83K ze9oI|QWZs8D}MkpBfu#||>bKhqG9J?rwH9yD;=}wi zStE7-Y{H6?=1Ufv9R%Gsb?a(wJN>l@%9z5e$QFr6S9&;w6u=P8oOk`{ zt-#v7s7m8WvBi7BD7(L1e4U#qL6hSjbqI@?A`+2%F>KWJ{R_EWt7khC@7_eeirxgC zhCF0TnB<34?aPw=pWr~IF&|fuzn`rkL4V!$(GkwX6k+#BgbOTUVNlF6T=`|CnA_ig zr<+pgvpwYXzw38Tr(Z))fP*tGn(%Oo2xTtrJ3p15cl+7dzPa4)+Yxx3h$n$S@B}@b zWdf@*i4P+lbOv7WS|xJcJn!88MsaPzfaqY076vV+5T*dh?fnaHYli%|O;Lh|s!1pp z(+}SB#=5sY9l_^`_xFLYmWQ(?o&mx0>+a_?SV70sf-2J))%LoGeSc9Z>#d@2X_@6` zCcEmK*)Pq;>kJu$!nc=9&^R_ZsQ6a=38(t%nr#1`mvyG2ca5GnB^~*}mrhyLF(bdh zq{@JCRIO^R^FE1*zS^S5DTBqDey69oJ^ml#0xR!Vo19yWbXTp1++Sk%3i%zz@?fUO z&luTE=)TNp2q4>==^17v7M3u#M*+2>s1xPljUN7TmGv_28kVsts9N?|(Pe1jn z-VL96*&5O#I{@o#SbPy5f; zvu7-vB!apbF}J$t;)1c|$ts4|OGDV~+iS-QTmk{I<(~%L|N=zm6CH5&pePELnd2B8LDekrKxu_*VL1{lf!1?-_k~Gdc7g zZYK5?*V?*5;wz;2@Nb~%IC$}@4e0g|2ms>sb@k@51z3$r3Gie#Q_h|A;Jus_sVGaf zeNVT>yy)6(6E;Z0~tOfZcvn|HFuA3uz$1}OX6#LuauaTCXzmhmeAiqIlyS&y3qu`9;iwQ_r`Gu6iXFtEZ)6fA5Kofg<(8vL7x0IeE^CayVk{%qYY^g#;VE7_Y|a4Hv1Z- zgt-fy8K_X4q*uXcUk36%a3)c`qnv0EoaCQ~4KFAN0>tCAD`_Rq_-riG5gf!?+b%7E z$vJOcsY|Z~X|5`oD)65-0{dg2FBK=hZgg1-5+j^Htj)S;{NWA$WGeMyfoxmaPMy(b zMb=~BXB9F)S1*cLS(Txl4)emF_@m$P9G$GxTETJf_R>}XiFa1z^O)`xwrFE}`OF1o zxq8wQUAZ+kW&@bRwKNqx3lXzvb-k#E0@k&+S5n3tqOksVA7Yc4V>Gw7-Y_1bvfD@c z*5K92)Sh{2j@}VKw7N2CD1Wd1sarVeF_?G-JFT&3e>*oZVyI-ye=gy;XRv;Io5_>c zon&djFe^Pa={{6TW%PU7dGQGZ* zcn577(v9P`6t5q1VI<)VoP%pwTA`gEMB1`vatOX`-;V61Ox2iK^RQROIpb-iWjHV)ww9<^ke{W}s<(5L zX*L;CKG@v5-4%`APQTS%tIP_*$!B3FXCFQ=PFBh%kf~jp?IxYd7xhT`pZmBD9i%Hl zARPI(epShixM6?zxkm)3GO|w0o1DjMrn1>|Io%`Q#`RfT9yc@dq=uj8PF@JoVHCBq ziHnX1Buz9S6}r5BmJKb^=Q*w7bhNhbK0UovU-FPj=%7keJ1-!G1A*Z&bVyN462kLs zdQ@{B9v<_x9b3diHRG#q;d9wDhBoabATn#bSa1iZhUk%sQZi*aZ?!{ees$v@+Z0%M zr0hClvL%j@$GDFJ-uUiLY7L6RHRD45_lI%3nelWb6tC8KSN==3$@-R#y8AMFnesHu zI?Tj1nlk)4OCi12Hp*76yHyU>&!0((j04wqY~W%V(lYPR?@}QN{t90QoxHP*ZB&oL z&4q8vYG_CAcV6WifcvBAPL6`j8#>qTX=8f^~OQ; zi1TsL4?vAQ1L$SDr>DuHJikmuG~!DI&TZvjihBYonKrQzbC#VQ#=R|#hyRhUbhY;H z-SN~P0jP&wGFi&H(ftT^j-pGFY%HdEHYM}qdAzv;3}UOAHvck3d3X1(g=%5#%ZVb_ z*F}B|1Ai5Wc#+VWeJT#jCeWObq?fjab^~P!Hsf4UMjwG)(Wo|*NKH5F#gOotq$>aK zjRhAsKVTFu(&GE4+aKP3?+fjp@!qQc)J1i3cF7U?yypgmUoN?g!_}rs#*5Nk(xFfs zV9eqc<>#b*1?U-Y&aPPP{3@Loh42r!rG%R{eG5?z5HhPh=N9Uae22LnO-{ifko)hD z;r449zk3Z7Mi(9_NHfi+6;JX~U4o;|-DsMSgs8B_|I-4b!aC?Bd4bKq!_|^q$lab> z(Bm1HYIm2Ai7SbaZDwkoKGS=$w80=937=+4|^-$@;R(^~X$7#CGa=*-ACrLHnOl z*+uHL`JlhJ5KYr6rnx49Iy2}T4~ZJjz3AyS&=FSe9rS}yFbB2vP}cVyhp&9OkFJQr zL&-;5mX1u<#Ys?`GO}?)K(=^Ii*Xs(jOOOyz%71rq=Y6l&SAuV8aC+v*4!j1_P{xb zB3XL`3?0BqP9?Q$E-JvR|E5wQe-CWtuRJn~^u-59I+P#FMfIG(A75eo`$0R^+d;Hr zgEj-NgSMp?m55q#E{Lkxe^Q7KU?XMP#`a8SpJ4-?{rGsM!CWJQkz2ym2zZN1F}Zb( z$aUBl<^2xTe&o-`WHjnskzkf9(>shdNU0^399|*-?upwro;JTeZI+fP_tf9$pEc8b z%sWh$CTm{eR#nd4E-d)MyYS5Zy@6A&jUW=Mw2K_dswmsU3@jBEXS=sz%pgqxYqWST z=`ALFSwu;O_w&42Xm3f3uf;@ApKTT4LJ2O0@vi)-c5z>ACo`KaOx#RFU|BCBb@oJ# zg>p!6k}R^4>j<4I1|NWI@Ue|Nj^)WC6U4FN+(rwkg{3{~en8YKq6~^=MaQ@+8`}q;; z`QGeVx8$)Oh&}iKT`IN+T~O9fBvV6$;})~N$8pcSKro`ar~y8GK7(xpbDKsHz*x_n z@M#ZeZdGQrH>S_$!_I!Y3Q*bGeUEQ%mRZ&*%$NkbJ33B0i1G&Zyh>90CMIxJgNb<5 zBk7Nij($5gJGW3iZLS(^@Sk6tq!AT+SVA^F`L6J4*imvVaWfKrJ5I$Rv8&tl zZ;mY8f#S3a+^I4rw(-v(9b9~OekW<@Iq@Q8U8Om57VL&n{2!|p!vz)*f$Ah?g2~6G z`LHtAcIuvW6NXQ}pAwswlKA6?1xn9HpacmO7IGM5jrsZwXt=|#5D0`C^5@xN!nJ6m zT|&80K6W%TAxmMI6lVH85>IfC0)Nh2&_rw^o?_s(x~pq%8yZJ-Glv?^?uL>b#faqP$ydI{x@nCY@#v?+vf_x5rx^YwU#@KPU}3(L2VvlnTDUtbU2s0 zZi36I1zz$8&o?&%9T?3WOUI}Az0pzrhKw|7rHUWlS5UlOY<a z*Z&##@M_oQJx$2g)lshY*rL?!<@qZ>;CaJbx3qe;TnZf7QwEnMfeAtY>{H3&471Gz z(r~DYqdQ%egcAC|-Jrv03-gvGz?SmA1_jj)(=6mZZ8(~tFvX8J+0T0D6cES{P>}}J z6)|Qg1XCwW#D7dXCEeMk*WR)Lua;J3l>bGYs*~fkFUJa-o({H7Iz-S9Aoo+E8MK&>-c7Pp#$THzP2ho zTf$3=ki!4HbCsX)y5k=H%k<;PfCtcxNE5k!A2Z1DL}9^|Qvtv0eLIR_nmyJO+swS9 z*W$9&ELcHy4#Fr&mANO2x6Qb1rehT|z=E?U6Bo{fR{YWV{x11;he-d-Kt~z7_I80A^w8*svvfDj%zVc|E?vUH$$JKA8s~jZU7{9A42*$=QJq)^^0RJMb!#! zWWD9Xa^2>{RPCQ(iMVci3Okr88L8j-6;~**liL6^poG4@ZbfJk*_W*kcUKUz&_~@; zH^iRT`raPuW+I^7Jy~+=cAx7jhYd11#TOq0LazbgKcJFll*=O?y*)qe*@TC+XG`86 zM$v@agq03I_nJNVT9_&h394Fal0>)tfR5U7hBMpi1g~D9sLvVX`A=jM!q_UeI%B06 zeM--)bctTBeeq(SfV1Y}rHl-!9LmH~D8>ybXk2txm>pb#=i=pNKlmSiF61>qS@9c^nj; zsq1b2v&+*k|E%pmt**9IwI#G)1mqc+$kU$lbHZKZd-G}a50o#FUg^HB>6rhu+8?qD z^9hF~C&C;u$%nO8tO$A8Ff4VZ`sxRGBZN>ljDmuZ@c-?dR*lZ?vlj2>LDUXN%h?za z7tdw93p5jz-P8d-O2P(VY7!=yQR)<34}+p^IvxR481ebch-- zbs4TXhAEC=fuFnH+@yadr0{{Z!)HRrUhUJ4BPAFy_oKVjqPyD$R@!vlM|SI+&Xi2= z+$=(7P+VRRkSvell%pKxV$1^wxMh>1om?iW4pV3$wN2M1Qbs(l`xo^;zWOiwllN?4 z-fW%4A(ePujz0Vwbjl_0zBrXpH=o@?<;2H^9YWH}zIkA!r-h={Zef4uPTKd6kN$TLxr@rbD z5@TXDb*m<|N(^)(elewVQ8sP9T95*mV4zleMAS|wRr_p0=BdL!Ol%TUWb|B_jlvPFsV^GT!kbj29g$}f zfYYabzWyZ-Vp|-#KP0jOl%}_}$$LGq-E&{8T{r}z>>C++m8HWx^@uFz#)@h#bNL@Z z=T_Po#}w${Ov90EEWmS?jrmYDxxd@RXz`C_tO<>y6PGG-s?jvTSaIISpS)1fk4TgyN z00tS%b#^uAtg24ld_nyRo;YymX1wX%2%hMEUzWpY#bV? zAlku!+n|lT+vM}T0#H#OAg;Tkw63pNrc+<~6`}aZoNFO4)r|AMPU_+uq4V3eJB72Y z=2*Yj6k~!t0vH-9zFzt13gegI+H7>iz0WpUWM1q4no1z_Ui|dtA`Ljr=jRCN^B_NP z{;IZPeQhsUD@G0>=}*2)3Osi7#(qsBrUY4AA$o-Z->Qrgy-M}`vzm%E#g>A$*;%{S zQzReO-&6_woT@T{Q|S8LaKvcbxF?>T`mID@7#V3}`upNlc9&iEQr+@Jfy6jg1{`vJE6;6-OC}5~ zF?$3*JX|2n{`V&-FJ3G*aV=F3IIH}1>_h*cj$O9W-+VAq%=>|mk4fF4OOc0bEHo4t zZ^2u2JU^N!U3S-+9AO>+@X=Ildykh4J1Ts~3LbO6GrX4lc*9-v=pTh1m~UK+TMERN z{b>F!Qd@PD<*~oN(ac*#~Svk#GJ3^Q~;+;K$jlDhi58x`=h zgt6-}$b;7Rwljx!?YN0$Pq^}5t7R~z)uGH!-K5vxO%a_RBEpOfG?*ka;TF#iqZ z7h?`TM>!zhO+F2>APZRO3P$iclegix9fj;112;aRJD9no%mH76NIuR_C#ox&lhPI0 zTuDT34#CRn4xtNuif>wst9c(ytEq|sfJr`#;d=(cZ#}HrjDNOv+JrJB-nSb;oM?Rd z16oI}7;fzq?xJSDS7tBxSx_kD($I)fzxj79;w=0Y2vef5H$w1#00e6ufxe}(#BukB z0-K^WAi?z+iIpaU8sc>#jz>Z87tJ4JAEVg?GqB??zZD3*R`rg3=P^e+2&`QvlVZJU zX4Kos{67@^_hB*`>92!YIw*o;gMUQ0-OG6QE4ChLXjRki)++u?H@~3C!#+@_g5OyC z4m!L2igWmzJn<U z^XM04KzvGGIjJJNlHl1udqEfxqK z^bJlXtpt+Lu>5(cOnT_k#Ut2wNFa){H-ruHwWQp}QKN8MVb94~?`LiPF$F9I z@X&X(P3D;P=q~HG=oCiv7X)E#WDgOW+QeT1fe)2!so_;A#TUQhD(VymX7V1P49tPA zOD^6U(l+$a87NVb@<&ZPrT^%TWx zMH6Pe-@^IeFZwyuS8--QPu|fPIxMKfy*Um)7ifSE&XKh>52NqZ0S?3$j3ae#biob4 zjE#FE9ZYNhJ!g`nOG!F7FLD%8>FNUB2um$)4(*A{u84`JsK@18ifQ^&>b|8}`E~Kr zU1N-uX+J(C>O}NN$IZJ2zaWyXl2mz60aZt9uv}$^YT6+@j6HOc%%)CROZbw#l?PLQ zJ|7hSm7eN9pMMBKs;L;r{fJAKJ7TIAUo{Cv1XT_e(}noRFFWvA1u=)H$~l ztaohQexvtBfIf$7#us1u%x zZg!Gs2}Ex0F|JqU=g*b%h)p+3s@vD?MEZ|4icMdC=?nYyY(=bB`{npRt59$0jBF4~fff;dMj{LnpPSzr*!o{@HJDyE zJs;G%RgxIVo7f~IfA6yan-Pr;Im|pK*9}d3YmA%a`$y)1de#L^V%%*_OD^a0Y|H7n zi>Cr>e=QtDrf|Hs!(I`)6aJ)vUw^{VN|dg^obnCDu+>$z!dFB&Pt7NwlBJr5m`Y?j z;?lezO^%tR#KyEZwl$`{`pz51Za3s!v?nfmAIMTQa7B7|7`1$eQ{zyl{{1~PD8oOD zlk{3T5dTBtgGgr5;wQKU8E!MUL)0Mj&~5^Oz_x@njw~xJF1|(sAfIdN5kbG z&SpWH7HZ@$M)VI1O81bo)|CoQpnZP+7TCa~QqR%uv8eah;wIe)$#UX!TcQd z*y0x1POIKxy^4n=VX)`Fq7AL}iP%>0)_TMenyMC&uJAfNsWM+2b^($4lE9H0Fn1|x z`+gWHI^`9AUmuJRW5GnN+=p?pcnn?*!-U0ZiIP7i)DsDw6F^j6b`1%}FDD+X9h94_ zTjdvp3x5YOC)>jqievbF0-Lw>?BpvyM9RF>?!0{mbNcV&wES7a5Nr0uKhh8&7f{t3 zNzQOG#{|;vFmWR`+~E#+%}Ix`{5{R+$WS-9U3x^FjZ%B+;pwn_eA=UjY{UT#JGiCP z$@dJV8&kYUkB)XISaX|Su!t_p`m3y>SM2p`pSd4PY*+0{-|Loe)XJz->d(o-LNk1 zR@3MYd-v2KC6Vj`#svD*PN!-qeT68VjU<$-5KNvMnq z%^lAtVM~wHmD|iKx0zJ;gPR{;Wh@%jH!YzxnyRciPdF7HQBH0Q`_J4RvoY-`XdgVfvN)I3 zRJ)dq2j%QTWbt=1S3~ayR-dj!a`WoHz6UZ+8*7)$= zCuMZz>ia07aZ*V(=})XM$rN!sg=ij+5r3Bh#U#>u>6;!Hdy6?GAEcp}1mc@+dJEs$ zTT0v$_w3|0<`FBGE?nKqEbknU}aH=^{4}W z;x1~QvkfdX*FSxH1OQqO@15OVf)+@BR7>N~>D@ojpTx^_w&-PpeuO3cw9utS`CCbg_vOSP z<)?Je`i-ljFu+$t<|9&6;D|@Aa@C&RMI-hHu=@YD(kU5WMTNi}yImc!5|j9m-Xw+S zv5)IfUoX?EWyTIFyvRDdaPkFf@cHjtjafm{-VAe~7-Ni=ZD^}le6f5RE;|>;p^q~Y z3T)FFs;P7<0rgx=^SCiT{q=^Y>c?M}sJX+xjW@ssQe{6;fyaIhxhq*^bD96Xmh5>J z{%lApRQI#QrloegUfkR@3(e}E;;f1HF!bEEGOc;A#dxeD`Tx;$)`kd$ta zlosg*X;?s{yQRB3C8RrDx+He#F6mf$g+-8VmK0E$-}C11dFl zF7~*9+C{Hw+XYbl1Xe}b`{AbfYuXcDOMV085M_|MeWaIyQVy__)*}g?9n$^&y&ebW zYd3E|pelyTNmnit&#)p|#p=h5%v)2!b{Ll-Lp7yi_S4X_!cXB@;^jO=W_{{5$BpRvlVH$4m;{<#q*GUtIDNJ~bP#CFb zDDk5Z?Z`a|oH;aAY1d-P>OZD^FQKP>Ge<=9b%#y=Ebb zrW`6rFUY zcI#}Y(Bs)6{H)J;4GeFc)BEd^vnz7oJD~B%fl2Dll}P~?{M0W$qoeVJ@;?5NV5t{0 zM4X*nrWj!wGouCvpZ{K!SODuM&AAGjX73$Hp6t?7+`X1kl8w8s7gDHfeo%3$&=%fT zo|AZq0fz{tme)5Wh<%-EQ`OCTdtj$exCwelZsBrN#C2e5V~*Rp-5YPg__X+OrE-bd zYrZ-|{zV=@N5EiKWnjirg7%gjTgK1XX*_Y*ezNuu-K8(=)N{eTpzjGXbZ|%H{M;0; zK*}cO3}a5X=UWN&a$q@x$iAA3_Z6cdAHhe6NT;4QA8c>4b@QijBrCEr7|X!P3=lmB zqr{%A*4~3C4DDc}NFG%FE0fP}(+F899qX5izx#bLB*C;s0WBT>ZCSOjh@U?h^Tv9p zUm;lBZqO!u&8@@wL769!BJ6xo;*| zI;K+e)=&nOfAVoUEh7x?<2L{<@Xdt{5Nf!eVEL5U<97776?-7x<4o`9|GWUxra)>X zU$2WfO0H)btS*<*SarekX?%_^YB=UW_u$HhF8bpa+J{D+IjXqN?(QkHuIi5Hd;Ibn zL4!g$Ltc45Y$N;FF1UoV?V@^s$Wzpc&|EVPlS1IbilCFJ%O1rk3gQ=`h17CXPsVhQ z!{PI`aQWsG`>P8jwj{X*qP_34I=EHy?d?;od4x&}2Cyr4I$zUCTFJdDO~EXf{w`fR zJ-$YBDb#%?cVl0qFIZ7Ox$wICHDHyHjE~=9geHIN_jT7KXWZV3oFwx2z^>`lA8G+9 zHhyKY%Lpx|jbE5I{`?pgL|jrjt&4yqwbvSubkMEEF zWaA0Y$9X#+RGcntIM7Df-rik?^mhlohIGrTvC|S3O7Zlog7p0*?73u(6;x{cl&z}w67Qxm}VRZUGGR*f5nmu$H_s>}1WS4mFs%P3l9_45j~ z&2PUMF;(T7csCbuW7S=bOcu5^*sWVfN*;P88aqp!FkA0Vt`Xag7$FJ(*{g?MxW2F6gV zhPHb%%G%3|lz{U@M$$FFXG9NDS5eXimrYF>kYC1JpVjNumiP{~H5yr2;gmsmbWdRq zeB2EM!RVYa4PIN~tO9ISn(M#Elt40c2ZnF~Pm{WjN%IPngTQ_PCOc+~Zzi%|lmZYq6K$bN>bv&D+e2=IB$}rTaUVfwd zJ25M1jf0-u#E|{1`mCo6|H!seO)?u@i6&YFKTDh!HB_B!%igVE;%?WN;jHVS#B4Pq;Q5Yuv#F(nfvrSi@b9u5Z zCOogmnECUaxE@w9uVktW9~*ga%fxdU>LVBAe+VfMT}Wb|6Gf$KHE)a;*K@=;=(V$}6QA*L&8O(10}gp=KtZvZuG6+UW5{{p1rn;k?gn>fA# zMIS(B2MgBlH8TOs=i=;qy_1!6zk!f+_X*+R3ndyON>}Hg!wdH`0&r}q>7b}6VFeN{ zefknY)>su(>C%sOdFBw}N_Nbk<5yWen+li%v81)Ua-fu--Js3)yx%7ENN9B`RiC!( z4o2E1*|?l}b8ctG4QdN_%NGzyGM|jY5`~#GGNI?$J0FVnw{v26;O?W5tg1K-2x2R6_`FAiki zAyuJePLw$~RZDYnQj~Jb!Zm3&LwEn#K5jfMa!KOr+gd7BTX5)Po4Bc*|B7`7Yy)1K zjf=h7`=pRN-TzvtJtSc9n0Vx@SfY?R0>(M(9b=TP+$B(D`UF@-TnmF(!&!7ZHSP1M zVyyR3TYJFv`GL5T;Cn8MW8#7Ma%2Qj0QciQ`d4$aTxKYoalfdAVFw5`uSETGTHeg1 z*;}Q5&aP2uN4+2vk3qI#b{Kf;Z~T>YGdFR{pgl#0v|5Nud^Ju=_E%0Z$L(IxQ1Hnv zf%Ib3XXLsGRX%D#|1P!xwe&iDz^|* z-DtyKjT(uQ^sjMdBHx3bhTC!E^6eKLka4+Up zB*Bb`1g3?w@*i8J9}YJTVg@F0TI}==vF(Bi%8?m})3ux1oodFPDd^RDFWLWW0Q>eo z=tj%jlMSO~sYCKP+Z#U6fnQNAZe-~~8EgsOG9`QTEx+i$d^Qx7V&s1C_DE~~iv#Ki zf7HPIX3{+urm5eT`NwOiWu-q|688@x#56=r63q=^-R+gxGUXr7?@s^oNzu+^nPDfO zie#sQuAGRa(yY0UO?5OTb-}1b5tViPSXaBcQHLCR`E3c`c5+L|w6?{(f#o;v#wbd} z47;!vB!~vC4eH!(ve!!$q8@RZ<`N76TpCV-NVNh9?VG)(p!^yqfQ~9AA@K*sB`vpl z>`jFm4f1it?xZfObJA!hBI*5*(moB?w%pr)l2_c<2+KkdF@E{4g6ZFKGqw%SkTZ8H zCoox=<|z>nrB4o-u@SYTx90AVk?syLG#v-w{EMV;&Hu!<1tuvS3;zD~t!iId!$>rS zRH~xTj}OriWQ8R zn|Kf9xS>==pwx+6jX!FY(|(l=WOBI8ai%Zj%5VlAf0+OG-om_9lxc4xoH>Vum!N5? z&1pFNHgpxH6-tHm&^~_7M-gtWd?a65nj-XJX1<5bO}{Gp@E`j-ekUqb8v&F!2TT$D z8V5I3nQHqh50bs*D}Oo4gYJXd=Wx%bWvSD(i`&X?Ft5}I&zjsd%(8STT{Hb{bHU*m zKPf}o68$2q4uSF=@Zp&gDy>NSl%2j_Iq?fU!D1YQv8juU8COLTy+OOtmmS69L-2qO z4Iy``a=8!nfDq8&w|ce)(hcysoG@W&Le~96ulEz+9-VI(7e!V|M1;Qcl6vRvzzv$U z9eSVmdrf@i>I;!knGyV)y*L;kCj+@-;*BKzgASi?VgT-2df@Mlc3|sbCFI*(cl{Lz z7GmmPY@#~UL1ijK%RxHxnN^L7ehbZp{f5OpIjQiszZTyFOZcK_I`iVM&QLlSJ83qX zP}Ir4_*O;anF88qSkev2MzoK^Qj>M>pBvM!y@qB+*)eHjX;b{_k;F7!eveIEl<8}A z;Z6DLMS(UAY!pl8DFIs=ommvG>T{N6M9_>yYa|H$LyOuvPu-_Uc zuRiF|Syf}E1K7}e+x{!zJ5$0MB&2pK7)XOALsgK$AKQ8DPIRxtnkHO>^lr3)5roV0QlR=s z{Y!#Ga@^8y>_6t`bJ{fHyF73ZA^3V#xx9SGshge+12Nwo>E-RKHaadL{Y5)GdK5|aEkmmyGqzc&3iq#a-@IXT<-UtfwR6-ke`-BTPBQ(# zd)I&vh2?(@ZJ8>wsWz{IH?Hom{u{z2Xv%0>>=gAKE4Q2#deiV$x+Wr$_isO*Jp^y~ zce}TbO3Jf>x!Z;}YviI_7#x0;f(aConNJ)MQY;u~BQc>L>r^t)>qSCi97 z7FR*_h1+DFP@s{oc)mWm>y}VqdL@xD28lz-L3IANZh^ zhHMq$&wiDkChT(k{QRCn0M~x$seelBr2o>JLx?uX2<&DM3ByvgJPY2v(zZv<)!A+- z#)Nu#<}H`1)ze^^I)0JWv0ES;*>G*tc2$EjI=9=)A1p*4gKIGrs847C| zsD8!z9^oa8t;jml^1{~hV}3Oh`IYr-2Wj*74h7)GvFJ$XA1l=JAaMFzDBoqu0iQ;%_4;Up8F`J7{5U7$gRRUcb* zcwv<}uB9axw~H@Xry+7Se2K2?xbTVBMAFZrebj3Lz~r|<+^IiM7`t#7x8k7c0?nOO z52W!{TLxw6=jPTOQ(!LAPyKdt25^3P&wI9@vh0>{I!z`>&G=t5wwFI!rvm%w1q+N| z2`XNSL;LDz(wH13xm>zAHR-u4>dC2&@1S-9Y#(%Ycp-eOFL~xCo-Oxx81Q)D2mf;B zx*@T|rW;yvwowP+;Q>O|#m(rZO+5L`=#dO13|jujBL%c1-M8qUR~r?p(JN2}N?md$ zSs`P1+a0v7%N#eC%$9zNb3hL}9{y78|0EJ;&`9kr%I89HKaO4#q6SiO#_(D=fAS%P z*1j>eKzcM-*;EbgTbkwWsrnOkw50ue9UA^REKvCT;f_5E=Jicm@x$dY^6@%|%#yCQ z#iMaDCw*a%B~M}wp;^`3JWd%`@dk|sS8zG}=?caRGBjd88zmzM&Z)k9OLUM<@E>s| zpPBU;Z-)+kua1neE=sOfBc!#9e+$6T08t3Qrx&Zi5tsFTgKze=INi%zXWE55Jt40Z z!x;_M_{`It^K&HuCfQ7R7>USq+HV@X+vo!dFeUUQ% z$ydkUZJEoR0TO}tk$2JP@d7GY>~I1${8G!KfWMt4DsmYTcqKC_dw$R$Ag;{=7|pp% zdwK4D%p`awh!IXfo-ejekIKtPX)`-j7383%)Bg$|BTrXA6@CSJ7?A#0PqWV+ez0e3 z5L(dPeyv2pBeSB7mD|6F!8*^6V{FJj06sIhm587H%%t0$j^e~n(Kat1AWrUhck1cXk>ZpO~iw^Faoei4d9%nMgH-%sVr{yB`Qam;Z6M}8OOwI2Ln0W-KdeQ)f zBr?cBvBsmQhtx5)L4%XSno$2)ppjm=-(AOoL5;wRjhZ=J%v!h>{KlN4FP!U1^9DsWP--FiXz)wNuGT*MlwH^G*yiZRClfSnpwoOqd z*3+0)1}{BsEK!~vOzbI91Lf>{s%`k06^?T&}#v@=;1Ba3`u%V~T2iY90SzNZE@NqY6?<;{^*n@Me{UKK?D z?U&XjlF)2D> zZ_Vi5xqfb4#vu4EPh8`cYNdo)&ACPEeO`2WuuS5>CoJF3!<&ebjB0MmBhQ-of=Of5IkF#l zo-wTF9ZlWNIF*G(hjHhOPG%J&wad`XScA_yipgw@aX44k?ueF@5lO1~VgJnD13J#h znGEXv&_xbPVP9K13}<1@HfgMqw8aW%9e8*vx(>{a|ePdPjf((L;d3?aT69 zgEmqT6N`zlJeaZRFch5Bku66^C5n_2d+ zIrR40dV6;s|3(c9zdeniOPeKwW7ct5^>-x~XC($el;jpok7pVssaQb%%An@C@fS2X z?`+;xFpP2W$@2#I)mq5f>sJ#urpK$L;91$*HI=D`NfF0Zq1w;CZNHW)l{d@T_Eu6A zt?ko*B!J5wUa)k`IW^d@Haip(I9nzX92(iDl?PWVJ#wFOG2eT`<_d|KMCouQur3I) z_t@=^#kof5^Rc!gsw#T$HZuhc!m@KTAUQvO%dZ-lSGP+=_2e`sXzGr64 zV0_#DxWmyKeX%ofae+1PentT2JbK-ED*OfkdQr=LBO+-xW9_5`x!^5DQFNGerfO^d zRib5{`$FQg3O>>Su9q@j9IBdBtv2CL{r|GoQu=!$o2E{h=qde%hp4lG`Kaj4=aT^A&zkc% zfR(E&;3=i&O*YB&j(gc@G@Bn=$M9x+6nLh}3<7N|;`qC5UU(2-Vrl}+I1qA)n+H}* z1Jd}gZNj1jvdb0PR1bX{_VNyAQgGUr2R=0wL{4&9`X{X@imn=T3vFIgsD_A+?*6pz z!}cTqtABeN%qaHTGGWJ8Bu#plpL2n)=3t{d#k|Kur}UjAi&7M{lBnpp4>jsgps-uF z(SGN1n?kpKywpU86uyon*>(_b@Kjg6iJh@>Y}&f&j1kt+Ff|LO$s^f8XTAkd{m&Or zdKrBOrZ9)RV(oH^Zie&^O6#QhrP}!SojevKpO`F1(?ups)Fz}~;315V*n*uY#%nTD z+u5^AI+QMS*Q0?s*;6)Ol`!i;^fr+WqCl03tq3{o-ivWzKH>;6de{{RT$?NgGGs|1 z(x$Gnk(wZ_Y9bi4FvK(<5Bz)0a)FW@^}{M3quNQ`F4aWzn4Po3&R#D31FH=erF>E0 zq@nhu{gnyRccN|2wxy&H*^`>oMUfh`mPxrs=lTedt(oIjmFvt&I-Ant!aTNP4hw`@=Ub7zEBv9znhW#Vg=M(_ zT#TG8WWB*S6Ytf@faopMGG{2m69_PDx(oBF5rQy6s?$~Ad>IdAtzuDgE*`8H&!?L= z^>sUI`uPm%o}7m^YX7<%ERMA&BMc4VIVzp2=wRg=L=r?6#jA@$JY720pD~BYEfndu z4BGW4P5js2I6Jp>_l`6NQ4iXxSi0$u{M+AY0$bqu{Tw~}Z5yX9k2$4L%tGeFV7$hQ z%OFf5&3;_A5ChS1mP}o4>lVh7A-JjAv}b&=QQGo>lGRf=#?M6P2uK@V=dVdVOu6(1 zRh>3gjrklV%=37n1e=uVGFiv-41!rPmdb%`eg4RZ&t>;d64Q6O;je#FQAMvPvi4(Z zezwqCJpEgU3HJ(5Z*OlW-m3vB-h13d3IxA(@}uowPU%w!;%N?myiNk>ij)P@-)|14 za-v_7$@LrZnt|pmOct$qD1=o6hC!e7INT(UuRI8Eh26W2vfq(vWUG(6isXOgM*N}I z!M|b>zqzr+gSVUyC@eU_1BLS2 zenvwoD`qu#9^L~Cuz)D@ZKH$Hg+(WioIU-cxxTb6g&om_yE0I0j$-p4 z64k^%PrTNu&%dx0rVN7T&HnN|Gz{(q-jZBRh*8Lm%L{nV(R zj#!>q-hJy0CzCdgADT0X&4lNpSt2M?^^PBS2m|R!hs6BKk+OQ3OG735ONr6ZqL23# zl5_v4fl(Nucd1Y_fB$%Q3W&Pe-{-Gv444wj>m|hyJTFaMVl~3GUAtcw@{wMBh^F2-q>YBeYgGp8q;k7#8;pqjj}`tU_%*S!(5VwMefr>-K|QvN zfDwQ#9<-L$HB-*-PBY5dFcJ5|{9E~y`RbvtMSS=*vo1=^%2y2cB^OsHL8F72Ka-B0 z!&n*3N5Uqjq{aj)@L`t^6*2$Nq#*cr^pKD zcXw{lreb>+8CkW{*#>v|?sT8~nz72oc`HJ%NCsZXB&qYG6MQ!36E4!;{aZJ}#cS&R z`48^`OMPZkB=U-*Q}oM(kCwtz4*Y=lRD9%uJqUhw{vbNVdUgYI(LTmZ|41+x01V)9#{)0f#1p89d`*ql}A)i8oBCNFXA z9H!Aoi>ZZQ8ssph)L|8IurqV0a1@&fM68%^p?dDhpoVrb;e=|D!bw(q2bLfFIK$*1 zYf6y{T1LnAgBVo7a>YxNKcXOfJ{Ikkll)14YJQpx@u5$@jA7xX)_ff_92Dtn;AsUD z(*j|@NU8-pzsw76Eur+k?WtxmrzlwUwWHO@QMAml%RRf8*l>MzQ~CV)J2uGS23<+4 z*2FkRt(>{u&v1IU(7=qKo{jL4_x+!9>NgT%&tq#%CAYG2+^BB$dhc_R-mG05BXu8d z5l{b}cNX~-w?{R}pHf~mCuWq=_F_Rk|BuKE+^3=k!rYj>2)2aYCyE+%TPfA?@J?gF zwJ8X?lLl|s@}`-m_Rm1A?XJYfZmOGJf~qBU zxtUNWZu!LsIN$92Ku@DfN+R&s?`1}k4+N7bO1xL4Nw99EEUJ^bPUpGu6vy|VmrL;= ziUhx4y;aTnNfA|KMfNhKZbJFt0;8k>To?CNZom^`t_b>LTK641!>{Ad&V>sZC&lA? zKE98H{luX1HwIwMuHX=+8w{HTIxnfL4`B9~0>Q)Rq%} zg9;^XfcOsQNz<^_FRl7_a2~eY37juVcXWUL9g6g}l@H$d@Ayi@QL_2|8cZ*z_C9iP zAscps&DMZfOxqnR;3=nT1viiP;s3Cphu2KZ8t_jI)vs5=-AQW1BK(`Z=P6|qo_{?m z9@@2K%awk|t&di|Fc*&k!YWkLM*6T8Di3Q4+`M4&&0eoY%CmcFe&cNRM71xQsRBsf z#B>up%o;9UtuP+^u8R6hFwv}XM?ijUS5MCwpX6MUH~=+i2Mb-JY_*jXD#>Ys!Y1wo zL|RfeJN!B}NdW+Z(&4^rtcC?YtS%ymdgYRViO)ZKGzf)WzlHCzip;NHUV$ zn{W+a&p=57L|(TBf_4rk18?~d38t|FHO4YSVPr6CS^Ybp0_-a3{yeD{SpO<4cN6~= zW>zF^mxD!ldU(i;S(iLlYqZf90|0emlC4IyHt!IGXs$I||K|k=HaUYejHR;=vzDp6 zQb(Imr_gb6ak;*F-TMbw@D$^7y5^#Ezx@Tfw%NMF=nR$tmbTgwcF){%CqpZIubL~& z(xiUbN!{tj+@3^6-jUhj_8;r^;Gf#IhHqft_Q^@h3zxm)y_TsNJ~W3b9ddljQoEh* zfWSb;ZCRBV$%g|qfcO+chJpYb)c&yY8lmsycECqsgbdc|vbNs=Bo2Lmg7PpovK$*O zKm-GphGv2%GoSWkEvQnaQ&K<|-~*8&@9B$vAk*ld=MWm;R57pj?fu)IDv2+3N#7je z6@Y}t=E<{^OsKq&oPqizO^t?lepadXWK7?oH2QnH{l!mTG9!&^br6ILQ|w{ z2Px#%d@hZ-g0S?XE|F$_WdvBNiyH3z!jnRm@iNi>beo=Q6{jms<%iS1mBCIiceMK! z)#EbLF{3vrW_o?M_QVVvJ0lgMnXWsY=f780H^7^|fxF1oHP+9=AE~HW+JAwkXk;?~ z6zBdf*v;7{wZ%+uBZ7?PihPLw4t6uBe`EDZUxQX|NCT4XOdTAfbhF&|H2sHo<-YVHF2hX zY?JODgqukW+Rn`l z``!imYIlHiM*qQep1Gh_A(LL2fPI5@c{nM5m3Qa_jGi~_P>;u9P9rX6%O5|=IgU?_XcT0=z}Zu`3ue2(}h4fWiUN(pS|xE+KcK zs{tP?JmmTjDl*4(26Q#_82_61nH%4IMFzs!NlGT)W|`FTUNj}o9g0J;@BJ4K{YSct zglSB(p``AK957i{_1pE5&tl~;;xfLF+bz>;wWkBgi;V$=zs+v-Z_v!29onT0f|#d` zu(7JfTU8m*GkZ>F(Q4pL^(lQf!6VMh)SME&ANzR8Cjp8cRqVoc>I@o%rFzGZzou0S zu?4%gTiK8uY4OOfs0Z`u1NS1@^f-VWrP~v9_ZHQ-?C1B0F3BEH3y>;Udo$YZ>T?IA z*)N%a%MZp9=?+x(EdtPoi&)Mb) zP%u|2c8EiA8ex7mIusrWFj*}jI}dk0i^HxRRKoc^$}82GezFLkKi$yZjF4F^q~DRs*KIMb}4*p9lgiKwtwc_O;>T%=z$UwJcqGJQkgt zMe?7L@*gV?D6KxPLzf&2hAG@*h$7H{lo_jR=?!AW3ukMlenNMXr^LP7g|cShn(Qp@ zCkQ#8kb#(Fl7ceX%Wq|2I8doZ8VMxOPRr;C^#n6(6-&p*w0C6H)MIabSZ>jF$(K8w zX150d;GAWOA4|1b;T`#gy1!JL&*27!4kcw-49{R(l|_h*Z-BE7B3ZH3x)!`FkOf8VFPZfB zHNPp_?ib?>y!%58+TF2|Wfi{J1p}1)fyXEybyw*smVf>5Z<@+f&DQeQDQv30O*bT`$U%6mJVY&bvU5y*o-UDrM}8@P%uuz=@TIGBWU z=(CKdjm3j=&P+;A=euZy3G3Hd$HyvrYUf{GOz=#D6Kj)s7nF2x%MLdKf7?=4se9?+ zNKEWw<~+<|Yj9H4{Lr+-`S4KgIr{?YEk$*Yx7=R^1_iB5NU+MKk_y^E+nX{%-%$23>MaaG`MBksFjZ@xcX0n9)P2FbfDmF zHCbVHsbNc@-KZ|Z6GS%_+jM@SIw^8%HkBRAFG0&F6>iOC9Tb+y{zg+;uq~S{=4P(= zey7;UEp2&OaHd>CAiW7--_7?ixX-SZd6mz)LPEZH>(BBZMxOdN?{G}I-b*B_Uw zs6=+X;xRVMsKPS(2RGtalA`gHrZMGv!uC zlDDm^nimTYRWC98$Lv5H!|rq7+AN$K6#7mGw6fgp>wK7is&XDH_8{$kss<0-2nY^K zggj2%C7F)N5o%P;4DbrdzbBJJ;{co&fM3HcHP&nhP__KLk4Eww*M*&(+t*3mi*!&z zDx3mvo3&KN1l3~m5BxLllc(-)VF7L@+ltG2OLvCu1XZ;wUa>+Vt$ITW4RA!L_85O*atg?)fuDF;$`a98x7H@@Jfekh#n2L8_m2#7)&f3K|p6x!|ePj>|`Mf9In zENEe(e}MiXQko^*_Dh_7qPz>^YHbPw)fiX7s}TkOIQA)S#0HlxE*niGy*zHVB%es*NupCs zNia~~lFwvvEUaV~gMBkd64f#_rB%YrLzIhVyxp~(!6oG0>FI4D{%WGHo^eGeiXJ^H zLfNC&kD0gISt{!J6$wz3>jNZ0WI7W&2XK6nPS2Hq(#r8|h81Tn<{&`1#Yf=qtc|4< zQ|;#tYIA}VXn|uAx)SrC14CCNSFn&06j#zO#=I`h)_7Z3|1kOxZQ2&{?>QW2Q2$mW zou@Q+GP^wHlxs~mFL45%Q$Uo=YVDg1>wB>f%Bb-o2sc8cyd4IaQo>5*1kHu?fJvFz!DbzPx}dA@Z6Y2G{bYv7diecB;if}-;w zU=gOW6720-`f7N$ERl1W;I0|UhPsmbn}~L;YGTd?gQxc&-m!s5fm-0reGUR~+FUDtxT5QkP;bodteA1vRkKJgx7OOMRfq4Pti&%`et5yq z{Yl3GlcbE@x|fC}&#BG;H=A{|$j=1o3GC#(pWId~G@sd6xi-n-X+&(+rG2m>Eau48 zj&=cYJzy|x@m*?b*nf+Hp4#TEuU5RDZAv~Vai$6wFk{rjs| z6qE08ko98R10LLbIm)N^K4xWQOa7Jj0#NKV@E+v*o^fgq>!K?;jiaff!!&owJnwCk zo|l5m`JB7emBbgUSA!D0#{G^a~IeUAg!FQL2 zD|&eJjXHzb?cE`tL)yyh3^Ij^AnDJHp}JFhu&7PwtKdU#*dK!;>f_&Fl!IJPbNm2lQW@};c$D25&MXl^N zxl5#&(xw=lZp)4uDxcQf+v}DSGJe8R{Fpm9pFW^D<%wF zxo_;;04q9{)?9zzIRm34r#1D%fLskTGPJ*)DMoCucX))qDBmr9E?< z)UA}q+yZ^%fMujAi_hr3`d;5mL9fd@88Y)txwmtfqfvQ=$hdP)RYCAX;MgaB&tAru zB`$&_Qd1jHRzClYA;VfF0ci;d&UiyY5t&8-Gn~UsRDaRaGt*$Y26afsj8z~!#qZRe3m1TD$PN|ErO{N|^ zn4I&CtVLdNP84oM#C<<+@f?z(2=Gc%6V$6}82sgiDCIy_cfrz51PQE!nK3%1 z3fjwUueNu@sCCQ77<52j1=#a^Q40UmoRO0B3m{SdY9ahiQYzSGf zmf|Ehi+=t8xk+M^M(@(HjdP=V(m+Qm&LbnQPpgdh)|bj(n07kN8vU|Sg`3A)>2LG8 zi{+E`jM4jbW7eHtU3tNh$NFUI7(m31T<>RkvTphpU)N;p43E4(nIweHf<}YrG|}Ri8*Cg zb9{)F*7gxLY=lIs#4y!2rXS!0JSi$nbYHa0L=k3xGoh5W-vAi*#18$buIXA@#MM6Pk+H$YG7ew|LhKOXi3e$r%gg?c-t?gys)Z|UivRs(Q0_+q>5#2_}X!Knh6cra*g8eMe#f=aLEfW z^_8S_mc4A3ixXtX+bs-iSZ$?AI<4VX9~f_Pm_8?F#enUZqZ;@gXb@G9`dJafKED{P zAHNd4$;#sVQ{hq{;NBb4ERhjhaIgP zDH!aH(iKCt21b(joY?(4n}rtnE-byWr0~DFuMzkwoN1!2dI4U-F$Y>z#*A-<13k_p zlAvb}KAp29mR`-s*e+T*rv~3!+OPpFtI;v8Y}zkF$qW7w&unvBYLzZ>->^Ach3TS0g*>r;@QUUK0s)WLBa(kiA1^{ILdXsi zhO~GwzTI0wetjoXWneuWa2`3HVdG{{-WaciNMkWEW z<|OB7{_6Slwc;8dSsDAg%DtN%@;8r?K$*N!>NaRW(=aH8skQ15DviSH!_xKiG@Yy~ zM1_e)_AKE9IuRd#Hm@VG?>7D7M(8ROPw9D8Cp!;`53lIn_h5?WG7{hBNmdQCh-%FH zmaoEdu>f*><5t3Bw1gxl7Fy7B)z4Sjp)5!4N;72TrSNpkW#>@0s;j|u*l_I~j(XZEkG zX1O=|`l=Td{5nfL@}Xr~nNH*AQ(&^}(SH{YbNxNY-9NViM-^JAN8LwEj5X)6FfWVU zaQa&+mQaD2s$#YTEnew&sk;4UtYuA~Oa@L~=#2l+!>H0ggUh~6CZN%R)0kmKTU4^y zB4<3AiL{!Q7_#F1jMYJ*0_^Tqg~<s!?yJKWq@!Ux)zVg%3^I;isHL+0vPcQQ0jk-HS z`$`Sz)7=Z7H1il9Mo9k_JqBqmt&;7o;U{4QZLBJDHcOZF+%8MAChHbOR@5njck9Hq zS*WlHFs{@083#z@IZeXeUN+V;Yx9dGKj58uqf;eKoQ+0ulAnsrQQ+@=t>WPz;UEkF zAFp$mCG7m8MbR2BwiB9{-(M)Bhp4NxVi=I`%QIxq7h|?)=0qsc*PH4#3?|xeTzpNB zL6Ex$cHRFaHVwHO*BTq{Z$6$PFf74dL|_aHT}G1xox1J^bcuxw?Hq^Ok+p|WCjm8S zT-R%l$EN4kzVfX2!jQTa8OTd<+yR`PbKue#;pL1@;;emeuJ}7>YwXLi0Uu;SeHcmH z+Dci7*>%1TJ2>aVWkxyeVi0MA?DsX^rl2VCn|z;Ta*C|29^m6AbZzEXm__{ zfAv%`F_eGpz2BL>z9@K%C{YJlW>eP&GN%5zLw zXZiRcK5~T=QJ;WNqZFY7C~}scy2*lFw49NVshRh6!VPm?yB7Hzn{d3|-umASakZq@ zupP6tRv{Yy_7oho5#skBWmsP`GizxR7h?~*o0|rTrU>tm5ouvsj6Z8=a@)tvU%+Vj z)Cz5uN;P*SNYsiaXZoDN!c#5dfWpFQb^8KBNKw1qy@A(t3_KFHy5>P~FTS{uaYHcP z;yY}JNx6TLuX^9IdHXkXxLFZ4dXI$Ul@eKie1kgIcdk&|d1$(7|IM7F0b#`4pV5k6pCv zN;dv%GnY&0)uc|J5W3SMLfhd7LA1A0dVrA#VEJvnJ7KWEH!6`|TtMX9zU^2js^Ya^&gj5WqiaWGHLrT^6A zWcV{ZMOhAP%|V!$-`I49lam57NZ-z%Sfdvo4_|#3P5H`P6FlH%SWXXJ4C5r?g8V2Xx3$#Z;hEiV^TJE!+5 zSQd&}0`HI}8!R6PSbp(zimq)$t4Yp~+HgW$T=cSDqJA0J2!$VnLN6wwDht`)5W~bQ zj7guxv-g^CUBg2j@k8#GO}Vidn$V(@o)xF^Hfe(s{^^mhW6q$Sa>!Ez3n!J@2{U8d zyAwTdAma_{s|8zczBfiG<_?67gX{tfx|yPTzQy(;wmO~P$=6}xHGbr%F}sDzz}?>; z$ET*1S*{srFIE)|QoE!}vthtHq_v|QSRqAua-+|cv+JSk;D3B#hnUBFv5JvJM3+_d zHCWCA&rZdG@HY73E8WQ-TNfNhIDL6&E@ppMzaQ=Z_+k`wG|Ehn8G4z{J8UOEfjT_P z@IwFh=v#MNiZP)|RAg#|Qz^iUp-zm(og&{h?B|*O9_y}-YDNL1V|R4By2RkGmfY(q z()$iPfq$%Is#z7b+Ql$_lkl|YYMwAV4*11D8(TH1Ev!X5o<-gD?is~eAshN>nY6kg z9!a6Ll)6eN2P-}E6npBAGokk@XCxpt?J)!O&{V0zfYk`I6U{L0WE`cmbuskx)cvJe z;wg=D%lM41tFdIia%1cJ{ibwxh0Ssgk`?&taB#jDSotEP?ONbX*nm8pOH zi|FmQMRhoMYuXy{YtZ`OK*@&<374oOMr~3k-g446B*4n|c?XLwP zH{_B}$6R`u7*qQ3aK^aWeqbFAJoE~D3CmWkOIqBqAHQG3n`a9p*-?UXNun8c9-I(; zBGD%^Kdwh>yTU5m}TzyboQh z@i75G+S`WgV_fhZUL@`J2EgJ_`*)@}m^ACfK0C8Y2A;>}n^_)=& zjT-NvDq=W|P-T3yu*>uLZielQjkS<0doeWxGdx^fZXsq2U&e84Cn2*bgrLPsONF_S zka*72!q^7P?WX53OZd8)Ul~p~Y;g3wC>>ZBynn@_PDAdyhw;OMI=z92Y%r8xw%Eab zTWQiy%WX2#2*06Jn}kjFW5xdiT0y106YkF^IBSvCfMuExmWBS2)}xk;X&i95ykHs! z90W05GEXH>AE**5r3%omMFI0>hH2!6Co)@O3@`9f0bO_3d4+-z0AvR@j)y zN|S&uqYVHfb~B9vgQ~b#>Z+hDL3$ffq81J=q4>KYglM%4SfpM0>(JBZ4U*o4In43oH9blC^?Es&Le~Zh|nN}glU|hVBwn; z@t6cwkpas44R55N=3}~ky1ts15zsJ`vWU=ZPE5UDu56fI@NZa7~AM)v2BYK zBhx=q#O+Eo+3|ejec>p4$xTArw0L~D!|}lOjc**Q#>#*$%FVABha3L*$Nxl(3rbG7 zzdxhvI!2AJGrcEPQ_6e2U|ANlZ42*PEbEGCoRCsQsbozZ4o5igpeSW z0e=1MSG+tw<9IsZ(+@x3a6C%lB$;ZyX*gSpfeNh5nBH1AQ=6ud&icqGUu|esjae3C zYj%Xm7UoxKMSoy*Jq!bCB{HQEa3|*ti&O_d*LC|rXIX+AASzrdxl1Y|g}_QHXN1U% zB&~UvjcG+n0Y$>!x~|9PFF)bK$4@T?5552ZAOJ~3K~!+^+EUsuQaw(mqpVF-YGuLc z$5g}u5TFgwMgR4eKjYv3@Ba(8;f-ri)eG%U0= zq8iit?6KC0bsjO#i&TFc>^sftM~j%ks0vh}qVyfSd1sxGoS;M%`+XkYw=GsPtl}H; zcFV#BtWkipvW(kEqYVlYmZiv!J2U>aR%oNpb`4I)BfM*c??pqDZw_dsAGv4LCnml% zwnY{$7A2WxPmFVxgT)*p7Qu1kREb*G6)1`)+e{~{_YIVVz!o`w;BeHTRJPPY$gpO^ ze6zQzDmSZ?2!(Xk;Qn;Ru|F`xYgsT)6G~1niYKj-BgWesZr2N9Sdp#95V`1n`1A>P z_YcrUs;SD^MifKhG%tJfYL-pCDg|9Dw9KqhPN+)38Oo=TG)fFe1t@ET3JFSEp87@c zwaH#{68FAh?unN4!j05RwU>Y#mFDl%gkEmSvLbU37$pb`$akJ(P%Cm^r3LaC0D)?D zeaGItv^Ch%=G?{t@V@T6tF7%r*)@rE+Bj5Hgf&26Lam%}^~VE@<&C$^fFN#e=Nme} z1@S@w9SyQ!UTCbXRDxCUf5aG(N@a*ubA+CNk~zQ7s$fWoH@>q-G8BG!`HF|fJ3Kx; zzwZJkH)Va(fLRhfO6W%T_Sl1ap{`e7h4|h19j`;fPirX?{X&hc( zpK-aoh|w?MbULB$518i#<2XTUhqgPySi5J#uM%{nG|3K+A0AO^#u^sRNk!^i1k-f? z@BlAS#+$Tv62+rZ3a8@{^E6_bMx+$s8%n54rHaaml|X5Ok}_gs(45Lyus2pd14|)8 z+sYuiV3`A6USFV;!spK|I}TDE=3FH1+`t$Ir43ZhP=!eSEHjEVtQf`t!!XKwCm!a< z&tC+ke?TepzW@S$)egQPC^bnK9D%HLuZr2WH~9MX1%Lb7U-A6>8!Jj}BCnRIOZWNoVbbeWMaiBAK-U zrg6Zpzx)la&%ePLplv*+H9;FXg75Ahk#mLbjwsb2B=*6FalkZA7>5DNI3p}8;<`Yi zqOlfjYhkS2d*7_efK)2EVNgtg&lR;qK*ew5iZaO06}pn!1);oFnNy%rGMTa@foec$ z=Gkzw0Ez;V%y4p8zfq-;p|oY4Sk2A7=Dfr7))bLOUhMA?(H2!AYn^k@&cn4DPPG2k zF+9sPjquG_S*4gUmjwj?ltOaBYXf@hp=05lLF96$;8Y6lhEf zm0(sY#H`Q@b-5yAUKdnF_@cK4ISPg*C%D$5=_s+jyuRZ0cEP7lPq4-y=7@P2X>N_2 zcf^&4n0cHK*MQsG3+CYsH3b+|;H`#HJS?RU;2gj6+wF!o$&;y-6~XN`qH8-*z7-sf zC(;UXfhrY;BiqJCb3qPaMVLqAxFRkyYKnN4E=0|YeGco4`+Fj0ssi3F&oItmnkHCd zacCPFGv@(XDV*=`a5^0M9&3RCpbR(nH71m*U|q9gp;D(|2Edi!ey+5w%fu} z5!MA4@r>le_EM>AqZMhh)XHdNy0+i@;>K7k>x>v8=4k;+Mc=hMt=Cu$>n+SOBSiya z4UDtMwZa(6S)FeMX<_)KYAb!xgd8KZRT9p#BCInr#v{w>Wf@RX!ZamxorCiVZR4;k zqqt%Vyla>fk`sp86<>e(4Y%9d?wr?0g|0v1haY~#Q3XbV*|ec|gPqd4%QS&13m)4WwQ>P8R*Uz68D>e*yDG61ok%9tK z%U;Q_-Ab%~Ma8^KSmVMhj9N)nUin>)vgzdS!Ot7Q449*VyWy30pl=X znS;bb0~#3`843xik`6vxFZekJT#qMoZ36?+cjsva6o=$h0drjt*R+3M8Z%Nzs8!*3 zUB-^NH=p6ksf^0@`S-%ZzE75L3dT z>v23Dxd1ASrtP4u!N$;3TBGed`p~o?&PL?%PzGyENGSs~OT|osW7D+QQbO52bZ%~L^mKfHa~_{R|AdE!k62f>%d{!*-e6xE1m?_@LMSL#?^E_dm1C(}neEhge`TPC^YqbahPK*W9LQNMzQAsz9}|^9r0Hi8{t8uWQ-c)yjByVU=wMsqgXlzMG5SOUlH- z*EA80K>08cCDS}%UN}TV&EozhBPynZ{?McA8suEDhJbmYsb}K`vCp0ayH38=rl2?; zkGrFL7)K1_gcKP1#S^y17Dw&&*Gy&=H-KC?uNuZ1IZu5HlQ*CvTRh`9qPbpSokvj` zMjNSGIs7d`B52wc&Uh@#g0eDa9H2VNXhKqB%t(c%wf=ZQ*EO;LCTJA2Esb_=XprK< z_HiLT{d&FP<>dv(y93&;Mb~(EPqtTzGsf!$mzOsZZ*#%$_KFe~AV<E2K~nmI>=T zP_!FN-em&(oLR2fNdOV zQdkqI#Lilj#-YT3b(!QIU!kqRr%#{I_6OWNypw_w@OjBZ;)>p=ougkI{;EC&@ zx{He^q}@vSd6tDTr3`01K7am#w(TU+BA{tIb})opM{z&{rLEk@Bw>V@v91v@6~tH( zW5xOI315Ev9X@{iz{5tEpmc#!R%Su$f;i`JJe_cVe=kb08N)DOo<`XmS}e$s-24I0UR z%B4u#3;V`Q0Y^nx*r9RW?g4GnIAR#bot_NT!imblZrT7FI>rcX8z{xfZCwMV zVZ`n7hTG*8*UKv-jge6cG42`_&U*R)Hm7~H4Ea(TB}Mjha~3LsY?=Ta?UEOwng&%B zSnZ@jz~0tk^|_f3x4}43A8S}JiQi=7S^?PI;zbhohzsHAv~8RH{iXyNuv?VUVU=tV zV+CN!0j$%w-QJj?ZZ%4w2O-6XWt}mO1C%kaQl)MiiZXhy z_5h8dIHWG6z{qE#m2A4Y!73^~nkWr?+d`pWp6E$A^gJ+4!wqk5FIdBbc^Z+1jN3Hf z`Er5rM60Bf;5Ik=vS56B#p`dsVVPH?QZdgns|HA(QRbl_leL7~ZQyV`S2)+~gk@`; zNZWb3W^D6{zG+YkFy~R8gPTj&wt!I#a|;wBXeh=UY^{@Qkz#`w7AQkmeJ&YV{7yMW z+-@}X9u7TxL&cu6H1#TDP(sEU5@MosnF*wuxCV?_P#R6g15z#gUJJN+7;TYCVPteE ztc>~|#?h2LEdjYIz&PllrS(>^hKvw1a%ODBho>KKfA<0B^Bs(FSeF&33eL*m*cbwA ztD-5|5}6-U#IlM=sFGK=t`V2(6~nZ^x4m!>73O6|E~H!!OGJJfQIyB|ctYRbp^CYMf85K>FV=`Q1OL;Dm~ z`KLpVwrSp%z3=e&uA58iTke{&P;FsSNx+9yS}~gn#~7N_rg`CD)OrAf^C`_-5oGSl zDKXc?n0NdJv$uJI$|+F^*7r0EwH+EaA+9UiZkjhrPLSSX*-z%$5dFQZi=-^F|7g9Z zlu;{b0~O>FkfaB_h6Pd5_Hqg|*=dCkXVemLcRu3j=@Ez10jpGP%ew4YET{_WJY$(B zXt&l{HJTDVM z%4oU+?j9a?)!VkQdhan$JP=jXeKzwR2g^{q4Jn`V<`O6Rqbk7q25sMqdt0HXfg}^By7a zo;{!M#17z)a)x!hR*2gvC{a+%)Aq5KBNOgZmT`Hh+! z!i3xHmGL6m>}VWCAQ1Lkq9V#dXoFOk%!(zzUT4&5kSi+|1qPgj5K%JFHZ8ioL)Ra8 z5R>^O4a^=@d1ynkq_+HyQc8eI(6$2F1IoYOABN`LPJ}+&2BVz;jQd8}`QLwhXDM=E zq9UkG50QO8>Jkc^XBJ3~5wm2l7;AxAaXcK*bsdsq+hYV#--#azX&G4-a06>BocGKY zv2ItXu*59;=H?xte%4wna(doy54BQKdN>|Ya>cK|eZ?@%=(+Ho@xsr3I~eTOOpHj8hliT$ zt^nK+E?eoY6syUcGA6;dYcYInn-&MYg6NS7X__duu-5QUlNp;Z%_F@yHUgT-gGQ51 zZRGujLqJ$1Ing=9H6X6<15d^S$fBSXaxMaVH1OWSH!ZC9nAa7Tw~MqBD-MSv`r`@C zH~91VM_eugTHkRqFb>HTtm}-+g;@6M^$I}2$l)%;g(Csjdh~pYb(-=+^1^Gw3m6=mf@aqL`c#`k@=T~LaB7eLmPBGTYL8p4>+FA z6cpqF-?Y2ej6xEPVHjisAz|X>pXnZ;Cf^0 zQ)yrcD;kM>(0U=~P7H>|7$IY@%aL=Y8Mgv&Z>+9T${22=T>m|c^@5VoSeH>MkFuj! z00LB>pPx}mk0d1anlDx=^lWS*RmGJvB++ZX_r z0dPXQs4y7E6~GE@v_xF^Jva_9C`F@`8M&;eMWbYmB;K)L8RKG?_`>IV6<@r_KszRue&oAqu>Z630d2 zlT!-N8Zg>2FD6=~5Mdy^Dj9M%FUZn#O-#)+uIull_ew03qJnv z8J~Xm0sY}XW>Cy1SfQ;#l8ca1#ThkIZs=_Tt$`4Lbp=g&#<1EFAS4u9Sfv8FD3r>< zrmjSxc7yEu_OH#r7NH7R=txDWytP zSWyaFJKOVYc@=~u5}hAHL|j)SYe^B-9L8<~f9D)qamEUaF=7b|nzoT)F00mMnE_?c zc0iMOlJt#-Rc!qnk4MTpW5%*9FiIo&gc0N3+S@!l&Keow0?RUES|ZNp6HbEDzh2+) z*Ps8+>%Z}68fMX)?iHHfe#1NrxD7MT=ZsP`!kY1R8SwJ*hRfT4d5x67gQ~Am3qp`t zTIFG`NSK{X5pBoBQ0BRCXnZ&vsNk{&rI1aw(Q#u+^gRiiOKAhO$?8$1+oO;KsbZ~$ z)rMFhZBU^1&80scV4D_I4o|rhSTN$+Sr6yguKxP^f)En={(xZ^@$&M5rlkzH>jhE^ zibtwky8uCwFa}PrNwH)sVa54;#=$x?-2p`b!#tsBTD1KEwN{Mt%=x0+n=!6}3z9i; zDTqOGTO<=`^EZVUFwJDgIp@&#oealktjmIVrW0RlC2-t?s>;qNi((T9 zD>x)c87&|w0-DrpO%X>)G+36ra#QpT4u>8}nY|51!GhzJpp{&Y6}4(uTL7#m8M}yz z)jpFtjWKWytqAIygWrGm@qHconzp%;>Ey1p096(%1>&45t$9`p%PJ>ch?SDqB#Vc! zT5#nGNo9WM#qb3y1*5p>Uj z3os5uzF2Y3LRG9`#_Q!3(>y^+JcO8W|L};r^I7H(lDAR-RSOIXYDrjEI)IDdFsx>E zSTg(4Ng@ME$%0hJ{yW&hl1S6-^sgCcH+Xe~-am}!jQIuWA28~TA!7Fa0)-t`c zVj8Gw%l1%J<&)J7>XZ0IG++xMTmr{~^F{_Y3`OldASEvOSm$FuXQwmw}P!g62 zmy$3J17Z&7yOvP3$|1D|39|YdoOwpa651Mdu!Y7tgy^))COD4FherGT)`NO^^~ z23_AkLE|9YV-}GDuug=_ZbJ)Yh7y zHE&qwD5Y&&0}b$oP45HRjdToPuQuLw_Y&A7`1B12k!3M|pO2_roUvoZ#e1?<4O@1| zmNBt;Dgf{#oY^|m#-c)2>Tfoa?RmB^rw!G=g@~~NZlUeFk+Xu{m~WE}i{e7Ht_#Lt z!2R7Fj>n@!#%kPdBVu6K*EkOQ$-CMtn@f z-|$4;6ZptbEEM}Lm7ij%%KcPzKw5Ttc7n9PNzFz0B&?+zSf6_M==~`EX#!BxySKv zg7X&hJYgI&j)w!R*^u-E+D`KVrFi|W;-A}Eg)b3h49mAOe9jl5RA9+ERisen?u{GWb6@%@X|Aeg=rkHE;D&dP>5?l z$^pwV3+92u(6;TwDW8!t4U*pWJ9w^?B>oL1>kT&vFA|_;*L7%pgL#=T&m&Ug5H^bu z(`bciG?Ikql#-bJz0wDwjDfORa2kGBaA>Weo!-mdySqDZt}-D?-o2NMkem}eF^RsO@0CtCRjNIh6R7t`O6;fLFO>G-aZqNH|rLsxN zN0Cf^`!L3mnFj3dXRm%l0?bOLAmxa0ykVYaJUujYyp?jP zybU+L)@XO`G4uWM?&)wY}ZnqKZ60nAV5Xb}E z4$0mcoQ?Q?^}sb zXe553LECmfC4hAoZJ^4*=)JPvVi7i<9}zfeuQn+#F>>HqrR51QVwxhId7g0_u2_~y z4myy~0mkr4-*!+cjS4**qE2DIpBI$( zd6&edln@k$bZZERF_4LsD{AFQ7L}-WtvHLY;xREw!#hUuF5=pUEV#}X-V}Zp#GDZl;{ckrMI&o5#&xZMU0e~sg*+&TER!R^K5W<3(7KBJ2juF720 zh_Rr88ts?@N{z6_!#6~KSZ8r}=H>#GP-{e#)V5NRr0UTpLWJ~tS+@<8H$&wjP)eR; zJ!O?eS}TP=DT;atRH}6ybIO%cNJ(Q(5g{fxPme&;HZXDuWm+3i9(kx3#$lIEGQ^6w z|5|xUQd(hIgACkQ-a0wCZos%00+i_ckH-@}eE0~ZG+~sfV4ef!WyLbDh>0hVlvbMf z3>U~GiIjD#yo}!U>e~RD&gOT;*4EB)5+%K-_{mTg*yO}zUnn*YP$~3RY*os8WwKQ@ z8_u7D_7Hd>Z=1!p>5`k|cf+}Cn@Y}EQUT4rz;8F#GA~#bUQ^`9QAD9sg_hPBKX2i% z$tieqNQbbH0AMYGybohnO!EkP^RU+MGb&@4>d5O);u#c~Oh(c+*`i~svu%5HeTyW5 zhjk5Tn+_j8eqzPu*zO1+Vj3qHqtN#)y8ei+Kk+k;8Mf*0>GKzy?iUQh4es>?wX)Tx zK%P{JfYO{HIq%^co`N^8(DtbE8Ei7zExlA}i>_rQw)uG2HmSQ}N*k&tYz+Uu)&-{0pu2^U z*Yw3SZ4YA=#-Sj@3hxct z)}d)h1b6?emCL{X`~MQ7?f=H zKrL(S-a^?<&pAhgkoEyI$-eB>YSEdensy9#SObRZ4X*L~skfrQd5f-Z5pM%xTuHcX zJ?9vPnC^95u!fA76AB8tw!xw6(f0?sghRsNc*KvNKf}6)ec_S`i4;>_44eZ@^C%l& zk$|8c#}h$GTIB$24$kr}WO3TgpelxFv z`>^)CHMJQPx6NYvtV0O<-z8>T@73S7fo&Vjwqb0)+xxt?%1BjU+hhAZ<2d3yWe@+b z$$i_7+y1=K8YrA#v;e0{qz)|0!q#R<$hpE>sswM>Hyn>=#2_1u0w6QM7$e5pfDkgA zZ_u^}Fcs5Ef~LXCnufO2e-@fAM=>vZH{U5NdD_&k+@Lzxa6JB3mu`Ua+&HzM2 zr4*)R!Pl1;JiopG5+AI!Len_>_~o-~u#wL0rr~#=6E4>`jN^=HoH36xUS8ht`g%c# zk@@!802209YK68AhvNa~^LcMGc~39R`R)$=kpX!e;0MVB0#hZeg)yX0JUl$0KOChR zw0M1eLCirmIbO%y*sUB;0cAMYzTIvTq8G5Ni_CC1-}FrjXhKGzHA-U6%d)J>vcfa&?+W^(NRA6D`cmuOtx#)( z_maYD9ITB{%Agb=rVOPsDmH(P->cza7%;CBeCrrOSQDoC2BkFa&SxBtEnZ$;5F)dL zN=;ZpVjI>ejN=V$caP)wglQb{`udD%y5ev=Am@x}9x%@fN=Z@IBFfFra;6)&y-&;wHGfjvw;Cj1aS{4)u*vUEVro*aO8Ngs4UPEb| z&u5&^_jJh46RQR#VO(GZHjV>^+aMQnMcbb7@c4xOctoj{Io%V3f4pzdw4PbqapkEv z2Il8TMC{gw2Ox3Gb~k@oZ!<2-x_^iKclsaxywMd>O8bKHEpB|C@#Vgl5Rwj*h~NQ}WI<6a`;j%{*SLqOLx z2rD#||N>RC;T$Lr9app=C&7T$MwetyN<+ZDC`5B&7g z?{If_w+B1{1cvIu0k75slHP^^fBX6Gm;?*cb}c@B{DAxWGv@gwGYSRg35H$Pgv;9% zm)9%iX~r_IxV&C5j^lg#QYwFlYtyR3;U*kApxZOB&?iuy0twK$iqJflnXv-^G)0LEr zHhK8gqJSILv`C*G%mOyLlje||UdZ6-Njk@kfW zBN%|4<%PQa3G(kGKV6&cz`3_;Hl`JT_uqkmJ>?B&y~}8mu)Rd(BuXzRrrXu}UUDl1 zDAA#BIP#PdD%cNI)*`H74-?C|;O_p31}tMR&kL4yV+j%1*EB7bdB8l)7_L{8l3_Ge zMW^!_r_&j2*W>x+3Wg1NVUU%*6dr~v#^DNQ4Qk2EX)qepwby+U-!_qb!GVkB(*1Dr?dV3G={u!RY zIXKNC0O3C~W}7P&8B#KQ%Oytzp?Bi?S4fdFuC{HNBNHNW;dNEDv`XoPje5>_nJh;>=;>BAF@K2SO4J(SUSy= zW2-`{yjm&_{Q-^h==%fy{O3QRl!B&lIGs+S-r5KS5-+{Yj#9#HnDE!X{*0H`SJYDR z`1FXw;ehkqJyHRdX@s#J_xE?u+9Rcax9bhBudf&f=E6_IBvmChdnbz>Gvr%V11NHR z@X*KE41=n+%?8pMtu=|rhKrVU4xOkCbIy_!sdfjt_XZU-goY4d4PXuLuOc$?uIs`1 zBERESsZ2`!9qsKUon5Jpp_%_%2*7{}TO%7^83-Zg_ip z#pUe+pyG5o;&AK%rT2-q@Slz9Pr6FFx-N4M1in z#>hs)R!I?{r8OEF*q>`xc4L{8{D9-lr6 zX@D|Op4x%q@yLL*T9~IX+%Vp*NNYf`d|l2tw0%#fbK5fF*jS))t`gS;Q32n+P8z!S-nLkRQr_n++x%kpzkKu94li5VYK!!Z5mMzAiW)TbI{b$=`ytjL`!{;op)}U$JE>TuW!GNJ~Mw?wC zUQEEUiL1t0SykMMH8fA?`$}>4$nZxjD z4w$9|%feY=Sb`X26RfRRmKoZL5T)@r9D1Ji*9A2vdCvj^%5rj!0f2**d7Dx+cg7rH z5;O1VMPjI6DHW&+Mxvv6xC>Yp9!!jO!hIte9-vB-2N_0fZy7(^b)8eiJk7|tqU#RQ zvI@9e2fV(#(YsQMT*pObdK7Q0b6{Gk)w?jMZCm8DVjOP>f%8uO^A6|JJyKEc%(m^l zLGNC$?I4^*s;m^Rp_nT@L)yan292X}bPeJCP?sqTpx4Xqo5(bcD5b*f)q2FTtY}+` z1gtd}#{u&^!a0kFhX;}htPvyW`}^MDw56#3-&*kBd3@K+<@4|U06;1c_5Q!xB7zDk ztz=QBnrmyL$%$LuTTU!lV`6KBF7x-_wYA%}7LL{$MhmtAKrU4r*_kb)%3v@fi`^E{ zn`=Q%MfCh!P`&f-o1x)iqjZ4>iM|Zf;rz&03#$#osI0^Bc*Nm&5X?kChzVZ&EiosI za=Sqr@Wd_)m{9}=ZlB?X z$*+Po*$)jk22;V^jE)vQw6Bi8;_79Qe><`%^4{MD!{-E zJ**Rk;f9C%GivKF&jZ$V#c#j-9l!qaGp1?A)6)YzUv|rH&nT$)!%sgUtTX=4|Mh?1 zFaPx?47WE7EqFgQfCDYrMIYL?=0HBMc;W?s}W>zjWHvpf^nGe^74w5GCqB>aIWI{ z9QX)xyKb(cI0${6{>l>*W=9|N}6;>a8GLVq~&@}CiU2={p z$Kf_pbm3YY4=0S{hZC0QOtkOs z@>AI?#6%urB!4KZGT^29MFH=?NlA(P_6wros8WryP&MJKh0#hBXad%fmI7xW9Q1GP zk8MyLVnD@)iQi6V5g`SXNI9$02DNIeZpG<*hu{D7dz{aAtWKthajlNIHn;1H%i9}X zUtTay<1WS3#^QWF<9IwGXJD3e$!(@lOOf1rD(GSeSl4+!@uOr>jA((@@%x}tecL?9 zEc#aNyOr+S=Cb{4rnv1SxXB~G-Bh*=m0`Gj^Y^xv+Be@Pw)PwUH%t5LTVVz_JlVv* zY2|GhKw2AwW7rWZn>p^=%4mCCCuQS*EC8)L>fS6J7;RfSwMYGpS0x~@=g zsIV}Ws-`7GSWk3J)3z{5L0bc54GJpOWkKT{oYg2XVwnb%6!GwI2cyq4-6G@l@|B#h zw>SL#=U?&s{K7Ubz*t)Oyx3zeaL(d%I-qeDzs{p9a-0=yhpz2@scIt@7@;-0UFN#3 z5zo&T9E(o{Wn_-E<*_)Yp>#%=**>Z$@RoT;dn9(C1l~Dj?R1?-*Ym%z zF#uThK&)k5Bq*)o<40aE!}$L)_omUhW@UNqHRpWWuUp;j+hSKoS&cx7Dyo1&KtUuS zfX#`bK?4V)Cnu6L%rO!D5CYaI8Vk+^6i&=n+LIWMF*crdbX@%Q7a%Eb z#35TnjEd;ZeMHB|z*-i{YZn(qUX&z>$o8!F0@|~lEY&1gDw0Yo20I0yHCicAqQ!r| zE3d6>NxjIKmDz7ERaJ$qG-kfyGv7jt?=fl+Y9isGp(d#tSu(FkX6XZH%1 zFJELfo-iIySj;Q&&$JD`wWt^qZ4!+Riuq#3Y&Ii!N0ug_JZ;m^wl%@qr3tmJYwEV4 zC<^J_7jkkf%RcMt>k>f`6iSI{FiVRVNTvkfIbTSND?TqFO`-wU;af{Ruh`L&+q0NX z&`Q&pFpV)3y^`Kwz+g0_bOqkFc%?{;l4QoVV!ja6f0CxrAlS8~JEbOI3`y(Is*zy4 zydW`VDew`~YA-I>QnAQfs2k!Z%jd0orlnP##u+S2(ZP5!jt5CYhFqw=&Ir{w}RW*;^kQQsFq-Xi?u8d;V8+n(n^yU`A$AaB4yP$0wT0X(t<_ZvbQ(IIm_DG8Y?R!l2nwrB4$uD z5&KiOPAV~#qLUn>{(?I67q#^AyjSQXC&7T0#j*3ebb0q7qV&6r^{!&+7D(`T6=y9S zvfoQiwF?3?3SKG@V+=_Q7n4dNNRGTtuqx2HKxm~h@m7Y%3I!&b3AKh8dL>wrfDM5~ zEsJQUeUsG{p*tJF{nxE$&>wRA_$h9<;SBx$kl9SyM7{oyUQyuMmP?l|v9)=TOBXM2 zb>}McMJ1W*S;p$>I;$(|lx0uafptyOM2vh?w*>Dbjm}yUtthgbEHyYMl4N5*U(-*O zYEhHKJoIjZ?ocn?%iTp9??+L`g_?+g@t%N1uvU^^6;R$&SJDEWFBa5`2BYM;bzagOMM5iz zJ`)cDNt)uknvOvYpRzIDAcPd9Ci z(t#vP$dVL|4AQ&9P1pL(GYKUdPxhGCbNc;^!JyB4HfEwV^R_`LgY{6B5`)|?4GM$S z0=iTYrPSqB$@?H1YLa$B7!wa|vMy<*1ne8*nzO8=%*4!Xmu+cH)5w2ol`t4c=c6nK zRMmna?V)o;zZf#;tzfQE!zJUZ+3Id<|Sx7~IJW!Yyw zubD08(I}HhwTfpln_*QT z?-i7Tk~|)8j0a^5{o#-*O3S-!lX^bo>8qEp^_;e;*txpR-tLZ6f=KR;R;KIDMx~ru zicHchWn*KFsya$gfvZ=qlBTke+t$kF?}I22`+bfbJ;v$Nr#W);cx1du9*{V|#VFft z#$8*}+m_%gTbq}eHLX<5^M&xT2=QJ?t93G-VOvj{<{UaQWH9Iha?n~`TW583m43fZ z)6`4;+1}nRo12%IPNr0g8lx41K_9JCf-mII<2$uAX!OGP1DvC z*_x~c@xa#WNidhRT7?s4QjIo&pd2AWHhpmNzAdZ$ZuaORth1}!4bIkhC%&yT$w`we zR;Bw%oJ0kviO+RNl9;mDV4Dg;pv()3JQq5N4~&MxsG`fHec3p&T;en4b3rPtjE0y* z0>oNtX>}q7_UrVyzLm>V9Mww8kWJ7O@=tWw_cTcbcOAqe*r|)MEF(6`qM}F9S}7|# zC>?6QyiuL}*ci|T*N890`he2W9j;A;vo-Oznob_IY`1h}sC5<{5g)R+nx$i076a+| zc0Ea(B#c&8IC1I}&pLAx{goB!s$sU6qtld?l~pN;ouh6W#*-;~lL@oMB4(n1C|`OE zhbt6$pAb}R1xaM0>jSN8aWN%xIjC2PprqAD zv;uUPjk;~<@>~)legW%50<7Z8uVTQLj*GHvS_+e-m^39-8s!7zT;o--`wFmF!E|!s z&bOp=pv7WTAl317>ebS{Uls*P4CHFsI`*E^U#7BOjcG+ZIiWut9cIm`?OBaR%A`Bbm$3$Z{ajK||B7nau0`uaLY zjvV3W(W4wadUP52+$DfEO)UXxS})1vy`tdo;lnuJE~6!8^Eq`RX3Kq5XG*G!+}kY2 z#Eolpb)7Udcm@4IpMJkjnx?dE6CLU`i|LH%?jGCQ+gNKE_Im6NM-*j0D!!y^pn;}p zgdB~EEiRUag%F4`-xg~XS(=h-h0!?yO=AU-v{*>hGM~?7y-|wYovTtAx0Vnbi+M{` z&Dq=CmN{BdFenG;U__PXJ#D?fwk_Jox}dbCC`)?%0d1TgHCFOjh*1Ue#R8?;IFl0Y zS?9y^cru+!wdrM+B?`rgItqAty&h?vlO%z}L=u4y1TPhg3JUK#uUH}!bOTleG!7Lk zbu~jGDiVaTd!BLs1{82CXjRqK-cGUT{jo!TCz+M54{s2 zZ@*Vytz+8AkXlZk(aGwiMUW;bWswUOKQ2gVCQPQTO`?s#D|rbTYe^DCnxvBDVKUM@ z0V5~()_KqoMW5wlURp0{lE%}6l&I}B!>gq0eR`s|LeytQIT8~S`kX_Xl)T94uZ%c( z!)eZ(xrw#44X*C&GMP-t^Mcj&HOiu7zL--_8(fg&xWq`s&{$bui!xz-?I2}uKi$as>xrf*wE6B7>0vZTm!Xj}QNarobQ z9~WTRRD#k%dUgS8J=O`fC(Ux16IoBdAnCi3xY@Q1I7`_p8T3bp!BYT(Wm$+4Xg-q& z+(aT`%U+K%E2RL@KrX*>iBYw6(~_hXZ9G17Vh#;nd``hQ5+sZ*Bnqbjm95#jx=m#* zy}^KfIURj#yh?XE<7A zxUxc7mb7h4l6GyKb}0;yK(ZNaUE!J<+qP_8I*+q8qm^}h1EUE>2ySvP0(vI>@(m1Q>3={1L&bLfw6E0mo z&r?r7fwzvel~wF;ojfZU^oMeAb&Yt(f@61g2Ok{k>udCSeYUr@+1%V_GM$R4dJ*WD zY(jL9u8ZU+dHMOj_HQIW7`Jm9}^k zM(wu_q-Q;+%ai%<2ivkp*3~{AOHSM}?@1EFa4_J+i4&Z<;RX&IJHpC_1c7-6Bkz|d zpES0ovMeJYeh6a>D=VucCSm*XB_>rZCyc>>JS*@HW>evbNgFW+c3H`{uNHHf2$WPx zVt|{rMk^~rRv++A$23R-D#d7NA$ceAX=%SeYgH6jXzE5z_N|p`rj%JKT7>l$AO=5) zAzV(}N_D99Kqm)RN*3rK5<7}A=GjE$ozf<%W~4plgP_O3ptNjeCdp7H0VNSwPLj97&5Lgvgi@Ur0yRl~h-$d{QyeDzkqKVR)+(| zlRd6%U1U1hVK`i6^YSH*9=(C}^`jK!5OhkK74m#&sgRY1)(KHO5XkbBvM4Evf<%i9 zes6b=z1>~*#(Oy1GVBdlJF-GkSL|Nhk*p@$P`j3peE^koz9~r3M7(Lld1dtP znK%os>sn?^NrF~}YR*zk8@z~UlBhBh6T0A*ilPvtzYj}ATPJq%OUeH}ZF(^1V+S!P zZ6+z2TFdNKHats~rj)&MsmfD;xqgMqbp}^vhRI}tF$ts55KvTYEnm3Iu|ZPbj7iWc zL3@Yt4yOW*w-^jQ_AOg4Lr&|W^wB3^j11j%Jn>qQ@wIUf4bjKp6A~aOy&N<*5f$Rx zHL9~~sKA5}1qR)G2fVc+XU#KKS4SK^e3)BqxrLi=xrP4vnw<1vDqwNoz;a;Mp;lV& z(Lwwt9ixa4xDs1@W!a-B`-C7$5$F&$E}n$UlAhbia+lO&W2FD?YdCP`T`l3EwyfH7K7@c1}0Z>^8YE>U20EgAslJ>&6o zsf6he79k+{=9##&n?@2Uo5sfs9D@&vwrb4c z);;m1bjvQ8u%&h<3$#j>G1!V5`KxbyHMb83WYsx7@V+P544_D4bB_r1tSC^aJex}G zn{MU!CvehKhj^dUc#sj#!(uVVw=F7&_ajLq--ReEUMv<|+1}=C|13pWa^TQmfpjJb zd0sG|FWA}HL+c57p0T$#WNK2;gDXhM51)XL(#Q+ z>!!g&gnGuqmPyFV9yvlQKXBj(x4!Dz`JPvvp!^>#JW9uTj;OR$kjt`nb%)EBE>dPG zqtTGMHiY1q&&GJ~nM`IltJv9@va))RjRQx?^WO6Mnnd1pzX$@PRFEVB=gjf~g2bxN z7B%y#p=vBDK+zj891U4aCrtJxac0yopG_H$ud+AW71iE!OrEBATVtC!HDK!js>m@~ zW*XIE06H(s!5J-$6HOX?`DLgifck-Q4qK*{NN{I8Dgsc#Og{UOsVg4HbUluV= zodmlhm0YjSb=_PV?`WJQQ4qAkI>&fArYH(=`SwcOQh9|aV{|J0RILa`EosI|DO%@1 z8?wAdH_msh$E&z|n+&6(5-7ww>81MdI*=rg7PBqF&4>^OUvGkY>KX zE-Hd;DT{*Cq^z#4F&qq+>Me2gHgTvfCz-ZsBygd1L%pQS6Llwtmbr+Lf8RQk@;ED)eW_|h#iLb%Nu~W&)r**8 zE-jUAUe!r8m5Q7xukfxxCth62iR1w}d^7^~F;T^2QX#ws?a^_@;;i3iAq8opK|mQL zO119641uP#G%nCK6{*QY-DPg#8~^4T`Gy?aGwDA`)2%s4Nk+P>e(kvA=5~@`Tnd=LK*L zEmvvsEMMa7gZI$^?3N};ZygSW)h#A5aY$_-&u~sJWzZn5Xl<0tx5XqOUnqD8jy#^e zM#Dby$%OOg&N8hQ1SM$w0|yQe)@yoYk905;gh!sz6d5Uj44CbWneOd@_Z-;RAkPbW zG?jt-yS`AU?AL>ZJ0bPTSbWOmY3S=|5@t>XeAX?9whB_MP^^r?+WoAUj= z7wvl&79{1k0n9bS)P3VA(VHNOE)fJs#ULe-MB&CPb}c`5qQptwMXG8g`5`*ZDRV=X zONd%si$^ImBudw9^2ztUkEEy3yH7GL zNAyBNZ5oWpu#Kk?MSJ`Nyi&4Il_eW%>y!h@gzpaqV4$%Li^g){D;LP~6k{t|Wf+tt z-nAqq5YkeJ$|@5%dE*E{O20N(v}wNzztc1glgSus9S05_;@F83B*|g%UU*?_O{a4% zT)c$$E)Me>F+2M1S?NR-(%#(L8;jSb*CWewHa0fs^#l#ywk^}yR74;s>cxWH9of7V z^SMZywZxJ;Ybl;}n&YWlpT*OU@S#udP_^<-mA!)bRN$+LG1%5Jn@%`)?i|}&+stM& zs`-?wJDQ@%$?`P%R8o?(U^25*%>=CrLWFj%9XLSIE6}xy8T6Vg&##f5%iIpcLss^L z@>?wy_yCKDyRWO7MeDe_H(@#%ixDvxbdu8_tf1x!tpaspNmWDbTjq<3$#fQBQ4Q5}O7JeG-)1Ny??>%gk;evy@Ct+o5|DRN$4VyA29reDyLBQ8iON%8 z>Fy__Bt~JQDpRXKnx|+jC@54Q(NQTGV#kH<^;ApsZ3j{%7HoGM#tSE!6E8-FZXmh9os4raNi3Smz|tR4KAfW-7NPo&dxH zk*GxS6S87Cpl{k1<>Q88#W|}?K%?-{E$*G<&TFkmltQIxyzo|V7dEgY40n>hTyAi$ z%qcSQOU&mp#=ASzZH-Pe*qWx76NY_EnWKZHsl?|pC<=-sL3z(;&|^N3DAV=z4MxM2 zC|iWVpih#>Vw7g`0C{hyo183{9P!i;_3$1a$MRasBHl$5hajBBWp6j)YtlSNrO~_M z!M0uodF}oNCe=&3Got>!2bPy}+- z@VSqCjwc2y&Ns9G>U<@P)bz@^1rewFMC`Ij3T0@)-<#|q)YqDIjO!meT(ky2% z9MSLhm*!le+HgLfF&XbsRdb2EZAENg8_8lZWiL+D0=t`6X`DkVNQ}l?fq@b{!$BW! zEf+6b;KGFq?C$MSMTn;h8W$Xng27-I4;%?vd%#dN747yGI!(#@1!=CS8&8_0g6WTy zwX}2{Iv$>~EF&>V1kHLd35!_;-qALeY1OiIbr0uS%Dl(MfejYbl%&YHc=0ULy&Z{n zHZxgcg2XiIB*D`y*h-$6F0d;}Q9%s4MSKT50o4Xv=&V?Z;Jj=MAs&jHbO4H&P2_`6 zxJ5J}5e(K^oQmR~)WoXaP^*^IX!?DbkIZMYNNH%65@&@Ro(1zFI3PhbB@|H(y;v-w z+BGcEPMx?$#JBro_3QDuuA9s1+S<~5Ro69Tl2ELz(PegYxCQHMl);KL)&|*_drxNm{JLo$sXsPX=6(&&?{0}XW6^DjSh}1Q7GRs-o3)^-h`c)~TdL2Hr6b`b_$ zshgyN5ow(~n8rw8QxzAZ(#we{NsPb-18AgD3tkW`UI|mmHj?nz`9?ZKj5eA)7v@jaosH;bi7_rQSz96x@X;c&=wI+qiF)8(y0*`Lw(8)V(f zqzx*S!;Nig#yeM~3Q9EPAScTciheiHC_oEX%6z&g+t5|t5x0X)HaE?&6E8d9{!Q zRT=P-DQ~@}j^TQVG31$|-y3jX;{XQ_9ukwDPUynov@&QFu&rZ0pR;-SGFP{^SxjdH z=Lk*?Bq4Yf^EvZ&U*5gAa+d8)O|K{^dZo;a=2Lpn2v}7W=gysDb90luy)lbw5oyvg zlWDD^ZY(tq_mqXC2s*#UxBbW8;U`}t zRe(GHpLyN=|Add!`$+yI#ujk%oB93Uc?-9iz~W;+!?*nCL-@gn)wKg)5?n|)dh1=> z``nwk>C_<(tq)iq!bfT#0xfpV_V)elN z{LsJp4xW>Nzw$8u@CV<;pGWaQa^maxw?Fw!+haP1rB|5-)%C zPxFOo%I&ZDF5dEnZ{&gJ-pG+rMmxF8lb?H-_rLR3`Nj7=!F)dF(xpqBJ^KtrQLwgN zG8&FJeE0~LFK;rNE>P2G~I zKlSaWF?cS1{6T*EvpXVys458J@~*3zE8AOKym*n_on65iMS^j5_ut@`{@Ke|`>Io{ z;moVv!1rJKOMaU_{Zl3$>Qyg9`(RR+&i%;^% zXFkpc-}`<(^4JcfJxpS0+Ylp@rG*L}Gkg|*<#o4mRD-|rB=7vtd8SF9Bd3n?>=P>- zS;^^T8WR?L`j4OH3#!lRnw6My8)#aGN;3K@t0YEK^!hjqjg@M<7#!fn7u>?<*<6BbKuMP1g9He6 z=ox9@@55k?k(p$c`HZ^;hN}G0lcHBD}16! zbOBysj+?fY7FxWljgsm?YcZWQO&txFlEvQd_0VOy-$wB*E<3{;|M}nL+iqW3j%fgr z^^-jBmEX;CA9#unzT+MI!P9}PSm$fL>3jJ0m!4*DZDc}!#IalM;@B;>@tjY7gkOID zlWesOKDhXEG%-X-dZfjXdwI)0`oH+WSDgOu)H}WPUl()edE9&2@zF=vS6gK=KtFoV-JH=6K%l!N`hCkQ%4 z=>px&js90Z!QyR2aEj2Tw2KAH!@S*N=h9g&j~A@2u2JL(!OP*Qd$CmSD2Hx-fCql) zZT!e9j_p@UK)QCE+h6i}Zhzp_y!JQ#A#eJTkFc||%hOLi&1kermiH-#tE{fBarD?p zvRhxy-+Rk_+%&k>>XvZ$%$>aA%$t4lg{qvvYp=&On&Uy@naTXaBMOEFfwY|-y z^B0*-W=nZHA<)_eRY&#Z|MW5`%F!yx#Iv=z$x}}~O*r*(e&X%l&I8Btum0m^z@Z!N zD<|HF^}>_a?0ZwSFK7?unM63V4wR?q&&<8+VbzVHs7cQEDJ*M}f2 zt1Qn%C05l!$5zlf%c828PR49s-6J&`?^=`|@ohi$_xa!NEdPhk+F;`tw{0Bbwimpd zH~ql(@hd;_cK-gmAER~_U$wZzkQ;+h28%)k9V0ee1hWc8$N3N|EQ864m@pfd*A2>~ zWJx9>rJxB)fShR}Hiq$JjMi$Iqf=G$W#^|TdiZ4(B82d!sUz_u=D&DP$RW#w&HynA zIfP}rdY34xjUmla;D70+|1W>8@8(jqsK%kam>#taRO2}z7yeUeGHJmqMEcm^1-qaW ziP9LQ39ZLB9^bSyL5RjGH6)3mZ9Pq0v9K1Dl40&OPJ56LuYRvwrZ84ji&l}5G_JXJ zejub_aKT}$qOHaG-L|b{Stuy792>c0-An@@*gh|K%irZ&?ik_rp61gJf0`$@7W9wa z%3aTY4kv~NRo=kMzVp?5@om4r^u=%DyIyvh+|Rl6=$Coy{0>br;>4}Dam(QnP0EqK z^dkQ9*-d`xtiyUakt`N-oU_d54Qlls{?SkUL%!qYLMBp+OZ?eKKgK5>InVYq&^vr1 z_q_b2yx@ib>EZkM;dlLK`rq=+yzL`9wASPN0vpw4ol2~GpmZW9r=UF;sdo6n$NBW) zukotB=D>?y%026U&ZibqZrfH!&E-A!aBu(Go%Kdu^5WzC+!I@%6-kyx1MEyiJj%(TLG=#v(!c(C z!hiU6e)DP1VAQAA%h5)bow{kLZLweC`-;V)B3)kr6np1B&j0;So?&g}cE0m(y@*>9 z@K+z<9l!J`o}SO4X-E?V!NL3@3u8%Dg$aggKE^JefgQHbeuZ7H8T3=qWEG>ujM^=L zYIrMe`so+)iaYu+Im^Qzd5F(HwL_C1;`Xn5885nN1*3A#e9MpVlVAES{>HCe;;}~` zV=!2uD2E)*`($O08}5A>Z~gjH9FB~)>hhy}=tH08i{~bo)nnZCq8IVvTW{j^Z~p;~ zexcZZCv7Xj31cEC)6&$tY;Rp5qPtx4rKPHZNYLt{PIM z$c!-kGVf?({)`WTF>*d)hoZ_Y7)_=`rarG*rqv8%syH)EDSI$*hCGulOj~Qx%m5ix z?bz9wv%9;8caA(y0HLI7C9J+IEg`hHXr4tyqIwWga;F>=FH45aTvToX7}~a8icGH8 z=lZh6rc*H$X@!e<8yzz#1Zdl4iBs{x$6-0 z5DjTD)iMFJ@t7nMNnOpNp5tsAA&uQn+fCmBT0m2TAoGl6R6t@R-ngn{aG5Wb-U)N_ ztN3Qs^3-qr1K#?h@8;fx8Gc#Ld(F4vplPRD6vdC&fjF7$gzPmYOAk^o0a{DM}j;DO> zea~V2zkHavG1P613xVF+*Ydz~O4$@APw@H2E0Uxy`0=(uYtQ)6KjGIt@MS*pOhv5{ z(kvRslwvxaFmDXcf6Z(7-mgDSFIng7UVAs6{P|BYi9U;}st}C5UK-itR(o7)Y3c^h zRJ&Vz>9c!`4j*D1?`LRsc>3}4d}T3%W`S=T+IEgnj$Ua<0ytX}np)iBC} zZ+Qdv{I`F}$7WMDw>CMlyUWUf!}Qlr^0Eg`%El5L=Rf*i_<so;V<|-8_2lOs z;@`dN(>(mx4vR+I|A!A9;`pNAnG2ui4?g&5Zuz>G@E!LZrc4g<`oI0Xe0uu3{Lz=b z%(1vB8k&6k~E!1hiTp&q|73k327FL!g~o za$_jVA^l!~Ner|3jM=iFKED_h|b6q!=&C8d++K>}JOEi1Td6sxnkpe5Nm*|y!+`3dWB3(@AQs=td zgKKj|y7WbBWjI#X3+j3yOf%Ktw`K0qwvrWpZM-ikAofKiGQs$Fc19@c#3z!bDdnJ8 zmeESX^iTc;Z+h#0sR`RRZ8`@Hz)znLT2aPq$U@sm&TZ-4k7^9Q>n z!`_g=aKynwIf+{E(O>yZzUGea<$*PgK6nH7+_b^vC$AEMXE+=Xd`olsHGJ=VD`-69 zkNh~V{qFz7lU9r2E?&bVHMEP%eDq(unYSEyKkt6?4VY8k%3J^1&+^c(UW_kmRF(NI z!Z&U($V>~}DZm`{;z>U8;1js#-%66)!o7DXe(KK!F`<=0Cx^K21vg-T_OtKgr@!1Cu$*C^ilp;L!75$a6-r@YG*nlP~WX6zWbH4D050Rvq z1S1(Bl`0_1GDf2TdNSej@A+NcdH9Wd_gy{Ak+0$26QAP$-KngNuENn{rqc;+)39>-FlT!5W$gCjyz9Y=hY4wxEqQSE8c1$F zI>fQ#2NjUx-LB{UvqC;a)l z-p+US4)dX(e1MV8xb?4n8?XA(`?-4fFhwCgI7h&!YZ^34;rGt+zK=e|71JZhB~UFf z!aGw+i||89L~*YyX`4Et@fQ?D%KFBtNY#T!sW~5h*ZVO_u{s!XP%ewNsJ(o%5~eIZ1?{j*NXaTI-Rnzvcf1!Szda7ncw~Qzsn<4Aj=e!d4(}1Lg)tU zJ^WD~+Iti9qmi79$(HmPA23J}mh22Onbdt+#Sa=iGhoZDhalN6e#I#}4k~ zzB^MCmd8K*hy3Q}Z|0x=_17?3e=hgk9Qg2OHEZi@+<4{;H$U(^4#(uoC%*U?K2I@G zsg@c;q7}ZWaNc3k9DGYPv$zn*QY}WnP%@uQ`LjFWVE-E&P<+ z$@03`zgMQuaJ0(onTrG@nt3suP^&%cviIT$uA#p&A~!j^SGTaP5jkz`$!ZT?qx0q( z=YNB%r`R-Q_i97iR%jC_*PpfD(g_t$e(7oQlQ(eRizO@mPapnMTvbyR1+M-AzxjJl z^8L5oL}J#t`KBR!Vvn7jE1Z4i2{sO$;l87N`7WX5?3ee*PdcvAN93hoTE^ok&zwEaxr>g!eE%)vO0LN#-|-8)`|+zx7c-ebxt5|V=naM#ov{6$ zcko~T<_met8G{}^hnKwMN&awiMNGc7#)m)_eP?lH;oM^vxoRZG#e0bqHqqScoTPsG zAW;NGo-i{a$4^vXWzeT>g>JCBH^q6+>gp=1!x8I!38VZoKtbJS%}-IV3gGF28X88Rm~9k*Dh%BWNA*&Dbrd4(aK(*eqY}A z<0ntBy0S`YQi*Tw0ILNk?`anmNjhb3cZX_TQ#US#i+OD8qais&jJ_NUK1yDoF>bSpbKw;eP`)@ zDT=iO=xaUC;9lYO8=y9K>Eu(`q)@}AWTx7T=?K`TdMpg$OJ?D$c(E(a## zD?%eS7N4hNs=3Db-{M`3Z);4ZAy}-H_RMnsX}5U%>=d01ICImj%ohz`dGbl>s*%}3 z5_snEr*Pavg681S4KzEkl}*(up-R`REYCc}`F; zozB?W-eNqS;IcE^ezR09*e~(k_dd;{ZY2}PdlHkdGFs!v(W9hE&UCuR2R?kBH=Q|! zQ7NZyI*Hz#iFr29mUxq8<>JPiy=*0$sHGSrdm)$d9hw%38Y1%P#%)Z#EnKC&~Coc1?zMO z_l^=O+0@z6W7FC;S}^6}bq}hKYAC{f*)0&oAd8$56JYf26Ra4~P?u;{uTpnC`pf5d zYTD4ogvhe&(I2jm6+Nn^qG_gFoyOnnE^>Y|f+Fi05~!Pst*uRrF^pE$z;_E$z)dc5 z6uWz3jE0?u z_~>UEUi*?9bMjv9KVf67$>xcJ;>PoY|agbBTk8^yN>*$XPhQlF7EB3~Vedqt8VHylUB@Bl{ZoKIhZolI$n%c5? z@d8=}R9j;MH1er0M>>4~r>Rss>9SF+t3(MjYj>vjo?o2_!mTl*ike*<_d07zV3D zwx@e+T|Up{^Ur|N3`ZjpU~uGFeEkD=aQCy1aH#)3f7TM!@YGkH#OsuPUU257n=wZ7 z#1mg;GTozY8$!&aan1`NeRYkE0|z;N;v|QU9%r<&ic*S2B`*8X>VQFiAZVv^=cDaF zW0HiPNho@Kdh;o>#T1hn#^XGiLNkiIKx-I}ud-+=P)b^w-r`!Bc{?p@o6#ncGnC}c zfV5`gui3bkYWEj(b8&z&5(<_@4-4#LTYTIU*nsjPg*GwZD@ml~vy9GlJ{pi>J8qfxZI?L`&I*IeImhmJ%Hr~v zD()A4w#&?eP9=w?KU(3?(PR97%)NK4X6b$3_j$^xZ@+E&?9A-WF58k^HnE6YDpZds zDY0x?avVFck;IV__@Bs%fy6KpIEiB;hMWLK6w9&<8&YCOwxvjlt%wwRr&yND<@Vi~ zxpV7VPe0G|wbLnhz-AwKfGHyHezOyB#?^v>5Mz8qs@KdEXb&bMN!p`-Mve^^PS&CTep0E zm2rA}h;VGaePJy{mScnw24@bVz>`;H>q2dOLdz)3YPOA<6QLJ9qE#(km~rzkiRz z!vhvq6>GwvJw4*Eb_7w%cs%CHb7QPKTs{CJZ}cM^h1M;r-kIfyFfywl0xLOdw%CJ?73!&$F7&xN-9q z*RJ2>O+WHe{Pc%!G5$BW*Ibj)R2BQjhbZ8otCxBF@i)`&_ju{$=UB`a6h+Q*xx!$$ zu(!vX9)B~JE?pt*^}WzDO0f>4^d4j5$%N5(>}{SLj6Hq z545<%X@cFDA^Ne_0yunRaW@^TS1zuL-LwMMyip;A2f*Cg&C?efCA~AQ>KJB1`n+-9 zg)5rIVvJ8TG)CZ@!XOaV7bIi7skG~?rM(AMcS-#35W;7P&}FW-?Z%4-z$$gtwOT__ z)>ssc1t$YgA;z@cO<2j-$SKOjoTAe7Qh#%;vVtH?2*Qvg?Gfs;jzLJx>FFs*!FW8R zF?RD>+vk3jzwp!lkXKvZdHTGK5Ggw5N0(6}q>ue|&SA|VPqo^US=MVs=}Wliey!^K zi~MUA8#bA>j%R-VQ|y~Jb6v%J*Y~`K!7u(M`Q*KP@T~#R^7O|)&3tJPvXEQisFjYYu2JG!@ zQ?ISzo#U*w1WdLk6rCSi-8A(2Lq@|b>ay_Qf7L=+QlGnV!Z0Gw3-0e9uqrC5){^&c zoDl`AAzNh}mzFf`vo##Dw|9xRyyXe%qU5Vz`7&8~mMi2;Ls=AvFeJ+}_K!1P%(`c! zHyDzxa@xjF6ctrf(=^6gpfv3{EYW|D9)u4m%aYk_Mp<~Vq!X@llwL>W%FUtUgZ-eW zYL;gm5~e9QJUQj1S6=1xbVi;RES4))W>CU z+$IgSZmTZW$D;Mx&EqW172&r;el_RCm=60u{ly+E=F;!`Zof0qv%aOm%M<-SqRR^R z(*jr_SZ8|(yp!k}^U%r%WzpG{=x%b6N}{xYz-?lZo5q7&-f=fVO1rV5@#c?S-G27q zt#j2o-3w+@c-9_`QaD85ea5V{wDQ~@*g1-#rj#LwfTo4Awn!ndXyT|xu<42<$bdNR zk@WgqZcIg4HDr0W=RUV<5z4y*TO9pdq)O zn}Tg|I2CpPx7c(r=Px18Saklcxy|QizxruDz4%YKJ`oJR`$^uJ{0?7w?~}YI6=3f3 z$&WvW!CUNPpZXYItN$cV#us_)4Hx<37elV!*z+&T-sh>W?~`4)$j*3+ei{>Lg-|^n zd;24JGFi@xANxP~^gRJOAj=Ahvc#GOYaObaI-)gePY7>Y;~aUGbp(gV<4K$E%HvQ; z91;eK`P?v@&8TE?)?f%loJIt#j}s`0lKx=8U^HPmJt1F}e!_O{90@=mWk}l=%;pQq z+TfJJMQ6KZh$ITR{?IMJr)549pW%>n&&4{3ZGQilg@p?ekTtSt z3AB%>E{n<+n7XDay@{s^LZW`Mxea8PG8#Gt{Q&~uqnPWa`;Oa5w$((X^I4Ur|>TNs_WX-ezZK zkFA}-<~wx7irI2W(`byVDeD4f#%Be(!(ElYNAgw`LFn-&+cv(Ta?q3oQ5cYf0h2+G z+4Piy{S&4~_tDa^JsHyP?eYE(y|HU{3cmSkzsleJ?dQphlF4MkL$`V)k*2{>GzDdC z&JIauF;$7gAaP8Ok1$Qal`9w68jl$DQU?8$UK(Q>!;S0L*d7nPTD~f&nzl30gd|Dn z4+q3y;G3%?A<~Loq-n~Ge9`l3+D=SeRs~5Kv9-O;_SP2G8eYs+RFz+!r@cPHnXWPL zQ%V#Ctk>LY+av!>o9@~1tkI^eH!dD)Z@~v~J<#If^B^QjsExa>F@}5{>eMtFP~SWF zdJ&(sou|<`23V*9wDyU5zAJ0Gm6}C4u}O;z!vHDUbHYHmp(lG>#+x(xeBo8z+*A>2jAnl3e(T= ziEmhR;L|X5_67dnS;Lc$E3Q2H5aAasSFdyw)%lCObfQ^uA6r+9217>MW30Nyl}r9s zblFS1c;Jvquv*S3%96TiyU;g96aP&4qV`B_uRWTWj84iaCp{c5tC{V;vTtxAp>$LqB~Za>7WvEvKJD^{z#bA_;MPbS>B zaf2(DF4Ip&T)#5xnjJ@e|5aW++((50G7z9aC+6(?YfB$lA-rJHxRx;Vlxf>GG-c^K zbSa5LjV56^6`UL$@WOM?ad`h8X_9d9!VYo&CXZb8K)zi(!|#3iEKKVK)_1 z2(<|m0y;6HUw`@Jx{jsf)fOnB5GZh6IvUoZ{&GG^<-6>NX(v#5K0&w$bamz=_i z5yLeWDtcUh^Lu$$oe)JKP1`V=PRUj)%Bms^BZkSj?p1krUJxD&DZa&*o~e276A?l` z%AfxC-p=3r>L)ShsMu@!dt(i)wVUZy2-o3O-72zUi+$%Mgg|tKWi3$McV9>2D8BefKC|*3XhLX0b&oH7X&?LeHS~?gc=UG5&G-y&S&b%? zWx?r*A&n!3!2s3koq^U>O{*lzK@dn{=hG*Be6GXVfa^DQH#B3{mXt-oGAqbdImTE5 z9r&I6`pr2XsW2Gyu+|XAW3-kS**^pHm832*%Er-J2!hbNZ^sGXGjaru*qxtV8}ckC z&l{4SMk!68wPy>S``tm{W4x78U3QVe&?19?8@Fy@?AAKV6NEP%ZH++(A!_+`KJ!$| z_q`)PL|3>N{3d^Ja+xrU7>&kEr_)WsD^lVnZ|A#TzkaM8ZN4DOAnro8k~sBDCF7{; zh9K~9xn)swHX^mxW(bgVOVyq=UDfiKzSr$ptTqrPNY2g=*2Tids~n%7nFH{M4_eE?wuSR5GA2^Qg@DiFQvCN z_R#{$XT$G0TBcHpvZ{Spl`#leqm}L`&;qRkRB#p)CBiY+Zrx^QYZoCD z{r-q3NoiU`6b+Di#3Vl3eK)P6u@dDpr?VMl(Q@(9Lkx!_oP%HzZz!KC98eoe-L@D9 zb$!b3{PWN9Q*U{a9jUne7ykx-_1Axtzy8@JdD8&yj6U5_PHo4$Q!*wDp)sOc0lIUm zAkI#~^_miQhRdw6GYKz!=JVV!Z{?;6c>BNmmxm_JuAenm~sE!5ywSA-FRF>>u{4*1K?~)HlGvj?2#l9aU2tb3MV5(>p%-c zoDw~_l`ZX)Bwr*Hv8BQwVeu~lp9f&glr+_Hb?CtpJ zR!EC!8~>1Z_|E06-sb0Jx`hY=zq+yx>F)9y|KjWX+}qzqBznBc(Q&{Ur(rw=U=YN9toim-Qvnh+Yq}S{Dsmxl86|}9-iUBZ9OOY4eu(dVB zbUH61D9^bf*Q-;Cs`5k|r75e5s;p=l!|(j7r}+<+Sk*oN03ZNKL_t*E_&BKudFP+~ zlYGzr_4oLq>vQGuC9Yk)%5cy}098S%zG_LH=cJFmi8qY9W+#7+&p);B>iV`sX@@bA zn*407XRd@%*#T^8B;Ua&)jyQ?|bB2EJL%TT266|&;AiXgmacWFOdrJ zrUtCH4#HyEinh^6{Dcxj3LPbswO8+lVbC>B70zm$YcOp^s3mE?N1y}hx*~}}dTF1* zV2sugZR=*IS zb@?CXdT_impqKRMr+xZKpI+P}jZ#7#`boqIgcWF^2~|j>BSIAtr~oYkq|`VeaZ=%= z#9}eF!8zme)dNKwMNywm|v+~=VyyJx18df*vqoxWx~+Tz0A6|P^q&8>&u zz@6vh{L;>Ui5pa1QT@ppbO@bp7r zal+y~_k9SN)B>pmLV-}A14S4IgmFL+Y4234HSU=&@VSLASpD}s$-83#<_@3v!VzKG zBMc&>@MeDQsju)t?LZE>eq(#1Z+Yp(C1svbR|QpFvsf)To=?fLyBwT$d*J9MPrPFf zSue>}Gn}nGcI5==weR9jeAw^HHw~7ly~Vn54NF1-85D4mACT5JKo8qD_3v=7TKI<|HhcfpKmFbRh>yJYO}yoaCwT0!$JpB5!n6)9Jj#!~|B`1vx`vnk?~n53c}82W zsEQeF?W2W5aZW@jy(Y(pbU`nP7^bOzW~`yDOWLO74-D}BhKJ-Jk5#^GiDp?g7hllq$JUpd$>)m|h!>{w$%=!|FBoL&b zrI$z$HP$wO0-*`Cr$`4jklQu~cl=Nb!es9RtYujur0Xq-0x~>TVZ~tEuB?yBl?%sWsyePoE!aw;de}&7x z@VEHS9`7T^Z{uhF!KeANf9(r=^kZM-={r+$7crPzm)00Bn5@6bC%#bG9zjk~uALGLppX0d~4=7wn z+~1vybxE zf9{|0u3z|fcsLBW{sVu3pL@qEeDm9Q8O0>gS%DTRCJX{9+hW@m5xUI^w{2={+t9WRv*{_*>6Gc|F;$Tx z@Q&tbl5Cn%!Gf=S?gifUAM6nTsMK!vQ98F^W-TCE6UztSy>f*`b=J95luG~~w3hdDhyW_o<=W3H{C zF*Q-_riTkMDaWa`p*+?nnLv z-~4a>NB+j2d7Le!7~Om~KYsJw{P-XGjX3I)=lJ%1moss`u+TBB+-t|+PFn|fOB`oC z7S%L|eEj22(|+h}9ZuoMKlcefv8bqwXYvGE6Gbs`IOm0DkFk$j+@u(mufD=7MNLtb z-Jf_P)1vTZd-42ReEX#dw{J{Hg(Tj2lsD}>`r6lKmOS&@zrsIz>5csPw|DO&8W1Nj zCR<@!1HxMY`8DX~FH&V0t@W5~r&3fC{Fr2?wcfWLlpV*)->{Ia5()D_Y?L+tMTgr@Zv2u364!%+m6l zqQ7J`==0_`zJa~%EndEMm6u<+!}Lr4D?jy@HNW^j{0MIxNTThBc;Y<|@x-~;YO|O4 zrN8>O`Nt3c7yLx`XT|i0JNK4^I$*I_vRY=eb>l^L-LoO2!U>-a>1c5%kQx=n8`%JO zrdCmu%x6=y#%Cp27!HP9ym*O6(r5YKf8`7G{?t3T*_Vj0&$U~9uKjEGWy8_eKFKfs z@|U<E+k+{>!g_?MpNnFMaA?@u{On_~A#dZThb;2nhRq zq9o;HHm7dpe!b-%7=(kiuE~m$sw^2)HBp=rrv~e4tW;NT`d@VVkb z__56yN82432HYtey52LZzPKW`0ZlM9Br%&2Nj(7jG2CCkNv*>r)m zj?2?(v&v|)8B%(M^l&(0fBzm$S^G&Vdy4<uYV=x+O3DU{m>mc z-fsWw9a+Gjr9cUPUmhIX!hIi6u>A>Z%KD z+Whh}XKtkw7)MzY98b?MBwR~XWEidJrG19I7}G*o*5s=NZB-!8sAZVtJ|_or29pst zAG*fwWWv?US2#F0;qZlj!B79iZ}LMw_Cdb?y^r$nr4c<*GdsM`H@@-}{^>vc7$1GU z=Jpe*e~Hd8Kb>-L7;NIjo2uzLgX@u3uvk7kuucU*pAVJKVT5Vt16#ixgNxxms{^cb{*6;~Bp8 z{0S$mMmo2lm}{kxT>@>SSxGO~1q{OOWNJd*PtLfB12du)VXzg^L&1 z-rDM%Q(IQ66*|ydym*PhU_fiU?qRW5u)lww#bSYJYLxW(=xKkz#fw)-(jiJmNU534 zW*i;gr)ewVBxHMg%+_Q~zn3B%?BCnxYhV2aFTU_H#u!H95pf!l_7iSBe3RYXU7Tro z?zw09)-zABT+GO`C1svt+PV{!sf`Dd=y>ew&#rAdMKfIi5&r8|N_NH87Y_HDQ@9H` z^8WjN_>{i0wGNbK=G`i!@jFl~*nUgVaWA=#BNlknz@t(P)5k-2~XSGcw3(-UUX6QVHSp@*&!hXHj}@$}PAaeQ=0 z632|ko;o@j4M~!S#hU<>gmi!PI{BH=E6=%Z8?IXlkFx87C>d{s5&lwp+tS zX~M-zmw4#r4R&{TNs^Q}Nr3qgA&nTOQIO%(5UF*nl!*~76&+=crCqkGbe)YfpJN(j1KJL4z zTgsxKt|~v-wO%vQHjURyDc^L2NlcQa-tnUK?%6@;S1fH)lO!P*FYL0jJz;lyoAGGq zz2ESOiBdWO?S1{4${+MXc&iyxH(u9fj9=4Dr<7%Z&zzA+9WWVB*xuQrH|SH<6-`sp zv?W?=#-pKcBI}m2E||@y9Na%(F`rY_B}Gwie0G1?PEkLd&Y8~UASIVBUm}cS_79G@w||7S zeoGQZ0mDI$KnRM}iur6#5Qc2+?6Q6F3SnS;9WwDX*oVT z<>=^`lao^~H0}*N_8Udqc<3hAuRr9W24j#|PEU^b)F(d9Z~fM9&@?4Vi!NNu_&gcA zwtU*0v>RE5KN>ux9|869<^R`nUI_6%;M0FpJ$Rs#i&CD4PG_Yr&+AS)n+YX70ADu^ zbyXv}Y!=Z?8bJ^ecKgA)su8eJ4zJl^X9ecG50+o6MNzyl%hX!aww5fUQIrtHDRt9ue0s`qu_P}GPG@t3Z5i}>eq>de zJkN0`v~H0yV7Xjye0%da2GFy>Q-8wYAvK92zM~=sn9)=@!WnE+Qxzo+gEcKj&KsfbZ0~XXp_}YoxWc8qZG?(wjAfZ;EV7KnYURbh z%8Lq(zQ_+h?io(5Ez#HB!@qU2hiwgISuvfSvRe4K>ZYnVIygiK!S3D`QRGcmThsc& zuLFb>L}AQmH1_ch0-`ve-%E%>MbPCiDI8^<`FL^(+WEC-ldZ_Il}}D=yoHXEiZF^u zLPZk?*tWzpUI5q{Lsb-1c}9{%oo5&{w(W2MkC#?;iD_$`X%YB1jUvxkEEbeSf!l;* zc@s?2wiHD{6orgOLnf1fUvoN(k**6ERIC;SuB`}7NLf_~Iitucrn5Os(=r^7sLGty zG*o2{wxzAT$!r`*upZZ~%L->&T}X&*JtPY-@isMoP%|Q z{DWkRJy~@B(qq(+cK4sRP zJ0#6(1eohTv({2~{~n~3$9CJEBP!TtM`WdYWA9$^q7h43kO zZhiB3A*Jd*52gI-?)(j;l-p={)|Zsd3nw`fR?>-K;hew}fxz$Vwe*tID2hpv)W;fw ze=my#QRLZtgW-^>swvBoe!tHu%V@2)Bp(b0OePcRy4qx5j7JlS-2c2(+UIQ;kEs+z z?rmCXPZ^Jb5Q(6!O3JciG#b+D^@t)xpd4CD!XTikQRs8kO~Z0NBhVqHu>@h_T>z~0l-1a0d<2nSWo^ItO}wR3{WXUf z%l;NSNwU#R9S?dO9UM|t6-AM;n4Qq?_qp}(O$LJ=ZELuHbl7DWg+x*0pOfL3UYZgH znlREH2<|*BgtOSX2G^pTFCtCrXo`Y5U(gnLH#t?^l-3eQ5n&L6GYD(3YvWewsLGr? zU(p-%h?0;njL5P%ZCjHmNfd;brUBa`g(D0!aTHMGj<%^h4wL5quW?}y14R@DKCG>- zI?adIsx(zWT@@7Bie=k)5u%jnAfU)=R?Ey2f3&1+YXA9Y#h~9~HeVrxcjFF}^3zsb zAv=2}CA}4tmWsNnaAHO4993Oo+8V7u3(wRPcpt?z_GvoT@VfS?yn$9o;V`B~3x&Xu z7X`vu;y7Y78nRr@{JpC+O1X_P|2y?-=S^(a#pOX>50)(!MBO$;5(K()SQR*n=UZ=p zcP|puS`o$3Cd=7(#m#1wRu;apx0`Bfy0wi5o`N9oamqsbHBH-krMR`Ul@HE|;*{;3 z9n#*AB<_)Rg=KwMI_t-CPg`sd%CnxrDD1?C60N+4l(CMysHm!jNc+QcwOV0}V=~@m z*dLSj2IwH*_*hYwC3RI|S~xzeSS=R*;0OcKBxN)hbK&A1&I!UWLOchv#fL_G3^>~zbe`?Fn9r%JlJR)V_RbF0SXNboX=cplEAlKuI3E|? zHVt*@RqwW~{lN*?$davAxWVgq+hZxufAMARti0Wg6JVSpN&0BH%Z0~Z&-cA~=m{6D z;M-3hvT7|dYYB%VMx!CF9Z)Q%*fz&VL!d26wj{A;XJ>-3hOAst*9}pWkoMA!!KsKM z<);ZLXzCJcTC|iNPbo6WY=NswlxWdPV49q!T2U7n)*9-{=h-(+OB+QbNgrb^ZCiNa zjZ#4pKC4I~aJIvLI>LuB27#rnDl+E?y5w6a#D?@Fl*Cz2VV2$Iz%#!rSU(l7 za(};Ttr!jmD6P6@`mB(^8K!;aPS0kV@dT;|s!VyX#l;^!0Z|xjGVIp^$Mu?O-8l;( z2tqF+bI!Z+t_7D~;cw2U$LoovHPlVrB?_!o`bRzI=t#(^Hnq%zq9_p;WNxM5NNNw$$l5 z5~v3?Sw@K0g(EX z*G??w(`eWK|AV?7XmKgak{}2+U+#JglTs4L@n-BQih`mjHl0Nqnhlk6{dY{$V44|K2s#))&3ia>?}cl%^_u zhrW(bjvPVg-$PwDWO>GXK4&_eQ&lxpS&=WNIO7AKs>*99r0k|CsoCA$W-u6V=k6;s zd5I7XB?W<=poF9@D})st-jfpO5TPVlo^x<~z`?-*ZBsKE4Vcd7w5Ikq_tqA}(S-Z^ zhcwoJmI$%dRroO+;iwz0z?E8Uv`6Rhs`Z4p{;sUGSm7UX%{ee1*A?-g>$K>cMkKn+ z2UmE*P8|eDsk*hMqZOV#wYJr1jqMb{n!0KTgOJf=La*ri#LaHy*&0J#w=9=SCX;P0 zT)2SL0cBZ{#3{YrfU2qpg0Les_z6}kMK4X++8UFlDF90A%~~K$65m}xs_@LDQQzZA%Nb3X5i1Cl#Z(!t&8e!2lcT##COwqAM4&7t z03j_}Ta@mOCf88c2B{@NdXt;h)X=T9+P0!x&6%AZaB_5yDqn(Wu*Pn(owU-J?ohMN z5XJ#<9FtcSRoxOujgXeAE+~$3R@t0hFQ%*tw3Gx=B07B$!Vv_@I}A%`+h)_ut~>Lx zs*p{Cb-pq3_pM?y8X~3Ss)q;ti$0?O1I=5cr6O&Qiy14sq{`sI#!%Nac~N*%IKigyD5db2u-gbC+q&`0mF|X+Qf+|YwQ#a5ORB2sIuVcY z42MIux3{@)VUMk?3C6z8DIW3h4C) z2q9Q3mMoSF>MWz5Zlv=x@o&|)#+EeIETXa4=?EJO~`n*0N@wInT`N zY<|}4z#s@1kH?f%m)PhWgTbKtZli8A7n^1P2U}ZPB)vYXWkywbqQGLYWIP%(9*+sb zh}mquS#u}cp~vV@P9lS-nsBu+wly_A01qo1aJ*WMj`bqmYvL%u30P(; z?0rYm)F`Ex&t@JpZ~YYJ&#KmAiAs?s2{ytcDQ))B6+c-EHea_qR5!drfg5Py>i_6q3%eI_yPhPVb-*Bu&?;bhI_30q%JK0b0K?&s@p#yEtuyp*Nr~Wn8uqq0gwnd20A0oywozFQuJjAr#=^+Rd zO;uA=rN`5hr_(Dn1BkdRqZBu&^juYOEyloH* zOYr|N_nuLgrgfR`?+#De;SCkLsuSHbnFf@`7Dd2-VnQ9jG$JbM(Gf-tqmGI*>R=wT zq7G*S@hBWT$Z?hqK|w)95llb>3f<7TtLm*c?DWJtoDctd@3$B|Yn`>M5AL;UbytU~ z+Iv6GbN|D2{VrorA+RVbk$nf`UaMu?wOB6kX>XHTE2Hut*-AwQaNCHkPQ8=QAcCTRqz6{N9rOx;IbR*WYT%CZ!~$I&4}-{Jhg zaye(dn9HQXNZw0UWcVnfNT2pIB(CFndUNGVXzf>K0sYHgS2rxI8sVMCm`wE7S_396 z`4v`MGLzwyV+dZ9JA+53WxqW1EM;yn%HW(N()qywfh@?LMaaHjGg;OR&J&}fCiC@-PV*<#dJEQt`8+nc#z8b;OLMCFFc6S zn$u^`V)Kls9Z`D%j@b9O80d_a2ba;*ZA;e=6lKNPbLTNS$Gbq+4R|M5^{OiI-ico# ziyQ1to3P~TLu1|PDYd2|9Ct2PEYvU~5*9RI&oE0l^@qp^7|AJF&R}+K^o@?FKyW1fNUm;ohIdkjH-%LCwDPg(G4=9 zbc3KmY#sY9zWzEw7$^&iu_Iy_ zIGWGsn{vQUjWkN86DoK~ zrcGTz=RCNc%qxr$&Rf(GrLFkb5Oc3q8f8q98cTQVU0_u=WO+$hjnLZSeWb2inp&b6 z(5V2`n&7<bx;wE(#`PKr zgY#bAr&6Cx>iAcCxWquhi&vW)Fl^dZmlpX_^%-q2*_v*wl9EiSTcgxw2hw$2;)cZp zt{iWE%{|eS>a8i|=ICX+iF{Ugl#*-=ATietJ2lQP-R34P4s7mU3#X}b#qRexq;|V8D?o!uF zLWtBW*Oe+7fVYMX+{ry}h#;y=iT5&a+r8ao#hXZV{uT z3=YEpN->>Im~KtUGEvPKquJV$CI7{}OEh&&T_ns)+A*1w3|iL>2L}ht=L@=iVDK$Q zD|WYcs0#7n486k-o~CYT>V}~g%t=6@!&@QEIrRe@IZ{XeqhyfG((TA zM&#uP0yJ%x#1uKFPM%IVFowgUJyxrREVq;NM`0Cn@ z#bU{FF{i33#*>jyHGtJ}PQ6;mNZuVMdOGh}tX3(OLq^_p*W*GYD@(?cEwnXh52+}M z9IK!ll?<&E6lx=m5k(=+GdLkVUv4nHmsUCMr(?)5X@7MwLwIlr=s4?&^nV)Fq?_*C><{HS`XN+-s`F!F018I4wnRp z`{dBBB)3d6(JZr6BWV!@moEyhEVD@gC0}k`*VJ{LMkb}q_0x`Et-&9SMw`RT7>P@D zF`$jYWHKji+7)eEGYlOBk5QUDGngWiw9LU_qU5KPrA^CL*$=Inp1SMM+AtnZ$ZgK5 z8^DM{V1NHI}0q=dQ=c$l<7>X;$?8iXtyisbc8+j%KwYIB8k8x3&|QuEJ=; zbTZ}CsZ-1j_Lv_X3erLa%C6+-=s+?wstTi|6Fhlh7w;UGm6$xcgrbP_C>6+Zd8iIf zoaID=Rat70JZO4T|BzQTTHaH2bllR7=l3cj! zI=Z%Hu~^78G8!`)WlXoW*xA{Ujwcljkx1RN%w{vnYD8X?#FowItSn2;oH;{Ll#IvY zjkI|>oibl8n9XLJVr3m^oMky7MlN2s#DfoApzEDfvOY?+-Fu1xf^$UIZ3HEPly_3u zMVT(>pdiXjUK@jt5-*$Q8ROB2swmKDIjT{Zgw_us()EtPc`}=`wYANulV{l8+2Q1= zlU%&G!(ws7s$R*VHZC|u$G_;sdjaw$StFhsG$e}of`%psm5Da zYsfN7+e#LSR*J5v>FQdHvxrx16=rm8Pf?D^OUKYT>a3w|dwS<6@`@&NC}rrnfv)ph z-algR;syLr)7C3O=rJ1lp~Wc8xGII1VJvx;F&Z1HIFNfoWdI{xSmz`i)}qMDoFdZ{ zR#O=94y|{scC|ulBVls=An_C-Qe-mfS}tqm%O%@8J9zInJUXIZHMC8`af z6$7)ylI47s0u2>emNS{i4!Q4p2%@aaih@cRT!_pU3!*aQWhorPD0?@Pa8gDaLR3Tq za@+MCc~+8T5~Uua$47;+7B$Geckq#6@F=CJ%4+lHGg=ez^u53@VxfX#DpX}1lvmiIClk1<+NuU7PfW44gF@!7NI zn9mM~(X(7E@Tn46ET#3Xij3uQL2h%DCZ%!0VmW8IT!?AWL{J{*HCn^qda1yp#yEou zS?UtpC;eFORMt!S7z0k{5L3kT`Vd!|QCXrC_@ToZwUL1m0xHkRGfhk>nd>F1kc*|r zkOlrRBMwN1N5yzN*~q@v>7_2YtVbg$UZzt~V#(-Et|^h4JIb;UKLCRHK`EB2nvdOi zC->fWKW$S}W;tL4tulB@2P&!!CM67x;QU4jrc^{}BeBxv7y^j*m`pLMN=DTPYwTup ztFV+QHGjLxX4DOon6ZaS8W6(J#DtWmgN zAw&k>V;fJNWfWPUb%v^kvQ&6gkPSUi>GUv`BG2l8Ei-(G1S8W9tpi=#(+@}Z7+BUd zb=#%ST9OopzNhW`lo8`tu0#>nE}P_P_pDYmN3$7OCNR;_c#O4{u5anPPP%QSm`tXO zQ8bP0g_YLiWsVNW;Ss`S$`WD_^I~Qt{#hCN!P5;A_nrm0KSrYpWgUJgg)kxxxlj+P29bH?qn9VpmI>3j3Qh|PGaeYG=dWm*53O_`8 z*9&R29T?hVRRIFoc1IB}FD?%I(P*O{88eSuU3-1?SG4!}T@R7#_Uv0K?Fe=Q&+F zu!swWrl%RTOe#@^?CkCUYLktwlpHL^X4qVzbwnA1(gWU0nx}kEYd?&P%LMAT-jUc1 z%7tL)dpUTtT2p34wL=J-%na`aL2V?D$GUUvd%^guWzS91aBy@eu5a(907%!2&a&hw zs8Cwt28T8lZ8HY%Ih-94h*U*MRaI1D+4Je-Jy|bKV~jLyLp2$(wY^Q}2JZgYeSGA@ z|G?$_BQz0;1igtcTh^cqWyRLcHmA;dmEz_M@I+Z1n+AG7XgE@naucC zD`tmB3`0**mK3(2D#ujS7@HN;ooCf_g4Oo{omJ#T#*iYkjn0zU*mC~7L~QI`y2vWU zAS(q`md4y6h>38JUz2&yWHPY3n}Hd~b23DBc!J7 zXnPrniSMZu^K~i;nnv<|1b5@GRyz5`vc`oA46f(wnbTy}V#|W4HT~eI>xS`EVe zXt7{eECCs3TWcw@3|-{pR(v~d=w+1c1{9G|StU_HLEClA7YhdGs45W$Xx5S2vRAP- zCr`WTwHbOyQzLza8trPluIk}(`t%uqP0q=XvNbjiaHUXMvcX-~2?9Pw&|1(2d4@{( zm9@byq??yC@+!-M>#jS``Sa&kEm!RAU8HSm+NNc>lwA6wqZw^o%aYy?xH#a$K=1=9 zI-G|%^z;!}=g&vMX+*8CS`i5x9_(ZDlHHSMP!?uKa}Ex~+!TBu`oMg?5ZPjuVe*WJ z#mIPThpfoaRFkQ{VvU6`7_-*9 zvyosLD=I&eC+_SJ#H6LWbAb?LEVTBS2;WS)mgTBWW0GEWG~TndvqN5%bX~`tciqJU z4?ZMwX{A^;Ejq%GXPBcogA2r+ElzAr$g(Ylw#D~7!(arkYQ+4OWf^&1rsb%Y2U8)& z+p;Jih`%BL#)^uo?*@7outnNOB0H!ukBq8{vJ%6ewU%l$;pC~aELXy2Yuk=~aCj6x z%0pP$9FyfJW7*z0K~a>1;4wjS`qT+doY)air1zXSaf-fOu`RT)yLo zA_PU#4h)Ny`KqO920~O6WksIla+ng(%1BbI$r)7>PM$c;wdb$r!i5L9w0D7v7cVlK z&r>*7ha0?HPgxF#YE*ZDYKWL-AahF8a)n5EgAYU;xgAhG;0Fnfiy_dojeO6}(+vZw zRYTYHDLMe6(&TvsN|aa5dr(%A8nqS`TQ6P0d|6}c5k;O+B#>n}n#e(CbNV6BH!TN8 zbC#PvXld`oiU%y>HA*p3n~9#E#SVwa|MF#gi1I}$Y5ApFi?{^en@qN_MMd2T(`XnRi$%?Y4_%Ns+b#6oB4gnT* zLjbJRRHbD)9zzUhB)L7bB?FMh=;{?r`McC=%=y zesK7~5w@mj5iF`IV+&3`{Na4+6CcJ+=XTf`=VXaLACEr9t6%$m?&|!e(%;_M#h8q? zNiyNl1Y-+gG8Au3cbR#2Tr9*$+cqo~OQO}gj5BAZWLd`U?g@5xPjUHhpT%;?Y&N4=t&s38=_*%?g^X=%AwNtmhXGnV zROzpSj~E7A?=V^rDL%?>s2hgO7^&+AvO)?Ilsw#x&G3joz#56Wkgh!ySOogPadm0jW5 z;U5I=zY$j{+~A~WLrk9kYCD%UNq+l&kP%9f1?HKI3ViTV$!fuCZ03K~id-+t2*|@w zX_;xtT-P!kk2tYAWjq-JaCmsg#fulXc;P}a6GarFUd^n+_Yp(D>PQU9=w~vtQCOoX zGK1BU#HJNVVHJr=vpKs%&HV5(YG^r;W$f&pVE4pHwzl@@ni-3Jh4T`iv|O#|I`R2* zy^I;ooIT5R*WbY9y-TcShoT&@mKYpbEAq@RpB=Hiy+b(}li7;#ctlZF>~5c+ZF=s$ z`yS?pGw{GVEzWtmx?wqAaF|Ps^v?DP#^VXsUV8(x*^*0pd-Ow#))7>|`3@H%&dDx6 zLnPK(E255RX)Op7r7W647V=7zFy4u=Rhy)W%5(ZoX3cAS#e6=eYfds9kLkOXp%cDS zQ5KtVsj-%-s>D#cssWk*R--W?Mr3e7#u&rt(`VQ{`v|`L)6R2>K!0>M zZ+`O~Jg{7fu*G{8^I4)aWC?7V_EbT zx;7aym2^9bwcu5?ZPuiGq%)3SA#8ir_^I z&<*_tlapCXo>YCK$rQXp2eQ+GXwvl&{!q%0T}IaQHl!Or1=fILy+KZ;S19d2+8uHP6``(eNh9_J%E z%LS;a0fIwd4nBB+o%+FkB%y(S=#QofJIM7Ei33v4&3k5}CaVzn6 z3{6Lt732ULLFB$!E?x?y=-Q6uVu|Zo+62hV)3l)L8|u}PzH4#L%5=e#?oT=3A^~k9 zSwfO1qY0tMxqvp2u36C*5^2%29Ys;HySu}9JSEQyTy~zPJmXV&l!b6~lI7uqyJkze zWTI|TuFN_qQoKyk-HF%5({(j{Thk8>Dmru~a%<-tP1n=*LRxoTBFnq3l>#Lzq!Y|? z*_}lxp4xUr2$8bPF*?Wj_4g&$^IEJjIFBE^jMEbSNNX8cDs!AY6=I}qJC2Sdjnb9k zGpcLB!mJg7ZP!sKBYO}n{IRMi#Hj1!{m0}*F*e8O4x49WMTxy)S3M+t+WK=t1-iQD z;P8<`>um_0y}e6xU4upt`mPs8fAHdzmDbZ? zG!$hiGkTqGDiWn4K?zJwkq|UW&>@J3R9?!Gk19y+|LJtfHRrFDJ%AeUuHo?V9&KAQ zo=n&|vCGcx4mQj1sY*X}`ZN!_>1Ga(4%pwjMD#KS3qMLy3&&Eg_iIpzAnarT;P z+1)wK=~JgUeexuGmmXs1TPBl|%xu%vwY-PuXq%OEOI?q(d19%7N;B8B!pq7(OtaXK z^zO$wIATakbW|)c%Aqy%o{${XS!NUdCHZBvp)4{~^dg7|VZ+EW#!?j-Dhicg9g|?R zrcQ+AdR60nq^c_EN-{BG$^%X!gWIkp%q6U8wX88&M%xd}mn(|AWL%9f#?W;gQy-*% zRk9GxldIo50si@Q{Bhdffv9CrDs^$v#ttE{Ts0UJnawGJ5-Onv!XWN&7YKd;93hYr z0|%y)i6{u86YiEaa)2X33aucxfj&5bmnwHJl0cJlGpaa|4&S$^bw{K0$YsG`6V zaUn_v7o=oVUW>D zluB2jFfejsj;?_EDoFI(w2kk3pju@bmJMnP-jk90*s zaL^ddJ!rlWg|*S!O{0<+lt`A7&#QZ94=ko zpp;_bC#V=VEVn$*2~nf<`nu~AAw-G}WlZ9M$-~+?0at1zBd5h;$<{68wmd}54h{?WFAg`i=HP#Z50&tDG3EqQ-rf!(e=B$>h zWOSD2jzY%S>$NuPk~xjTv{}b#NKtLH-8?I<*6XSsE+9#;T2XLUuW+1JZ)L8x=X$s153+EDID;*$Jyjey^_USS%I{ z-ZK7uIm4P1a;8Wkf#FyxZ?r%=qo?Zz4u=KH`AQ`7`uOIIkW_gZ73E=5Hx0@t zf`YQD$csV_=a3+w5p)(L7|lssf=cr4u352K%&F@YC-Nda1_FnBa|Qyj7xh!nLI-G9 zEB5vdo5XK?q*P zqS_W1111StI5fcEO z#bUAkDy0}!g5r^pQAqS=Nn@1}lEY+1NDoQSq9SCO#pyuPbWA6aq4z8o4PECLR~4JY zTw`!v{4#CZ;+-ci3o>mJ76^=+>*Ii5$$*Xh6rac$DfakpE z!?jM4#ehMfLIm%yYMtcPvN)QdQ+3?79rO8|+0h|&y#$~ta`Gaz#73i(d~nV~R8~|r z%BT6fh8X1E`G6zPYe`A$*Y`zqbWMY+Ylgm&w7=k}a>Jx5$P>~e4j!V$C?iR8Dx?6U zi0gZT_l$}{0CPi2bPg9HtJMN)G+9}aTa8WR)p|7tCqAJwr%uo{=V?|m7K>S`u6pK+ zBic5{T3LJ>D{7mVqEZLf0SfIECdiCD1Q|;T{#$K~s*othMjX-B7AQ0^Cpq>9nNzDI zD>o8YL=5<$gS5CWGK0-ain3xdozS&4tAn*yMbuq=s=nHOz-C3N0AV~HVX};5X zBe7wSW$I!nGHuzpl#D97$>~r@;u%Plp?7k44?`L~4nkSzI&3CB52e@S0JrI=WIU}f zF`{FTZ1-VcS@*~J?MA#mpztxscMa5aokHU*c_}8jo$YN@orUzr!i7a0_#szJ=q$({+ zN7}w+e}A8&gUbXj-lP!SC;68m3ay0jV3dqX)(<>Qkj~Bbc-P@wmr_tk67`YBc7B;>6uHrSvwf6(_GeUnCFod83JD3Qs1--?sn4P<$V2mqw3 z5!k1EKWWe{qxC3H?GSt#&pUCg=UFnPCb2|}D8$EPtq=?(;=`wu+!Q>P5K2XsZAMlB z7@VW)d-|c5MAWvUX*;@pKpPq7ZUVdHa>IL<4vn6Gn8``}HLW5hdALF!5`sqV;bpzz z=|su1Ja~I8%=PsBem9Sq|`AY-Yu=JTnhY)UspGYa&X5! z7vjdvt*x|rHZAr;5OqQz#cw7xleF6ktCS!$`VOl!ix@aMT5+(y$6|iOaw&`2#bQR& zG{Q5p25oc7(O6vcnY^{ZJNiC>^Nax{9aD5pfO=sNeo>S|4rMnp)fhVJ#SFKc(bhZU zS&C*&gx}qpZ{_Qs{lz@>$&cn!AA1wmotjc*ilJ*cI-K!|yYAsFZ+j0PeBgeXrOdy5 z*P*nSt(vAG5}7{og}mzbzmrd~;O_h%{HI^IgVmPimZ#jtmp=Y;x$&AQyOpM&U*fJ0 z{1w0dTffdPyzwDcePFp@4ji9@M?(h&$Omvfq?V|4vf_?mBe4qx`n$8pQKU8cHa z|Ngu9>p%NrUiZ4U@}3KUTfX_1dGmKZ3d_KIe)8LR$^Tri#(#ste%d$kmY;YAJ34at z_kNUr^UEJ4WEPEpgoobItBCWKh~;rFcnL56((`CMfA=dd<>&sy9k=|(By(5B=|?=7 zCqMadJmygkkX*_{!kb}aTUa>sk##ed)b2i|uv^6+o^Ro?WHM`IcIi&y*`zUg-^ zvmQd57|9eUG=3OR8g_5}Y@YYr&*K@lKaN{&IL%f8-TV^w{o@Dt%eVa=|HrF-kB>T$ z@-A03LG2TjW;&gsGK)=za*Up#?NA|#YRl#rrBRRnx4i26pU%!F-PeYjp7lJw?aF@? zF7xg;zMDUF4jaL^6ppoAapvYn@o7)KnTKDu%c<>>!oX0^xp412{No2c$UENoejZ%R z*gLq);lVzchS8{$0?T=-7|HSpXK(#Xp7ylcdD0Ue&CNGn%jxYgRTk-%hg`h(<9zt< z-p9M%^?vSeR#=-Vn6BuPkL63g=AS+<{3qVUPrd36dJQU; zaKn>%@pErxq$0C-{WdTBxjE4dXavR7cO8qxjJjTtiY)#kKlR1m z%q#CYR<=UUb+>;3&wtKm@$}ms%_FWmA>aFApL_rD4&MDoZ{c-sd^aDjkI5Cz4|IJe zJC?F!zE}v0&3m#$f|eXAwXs)_I_Q2F@LtK@D2TGvYL!feBWKdwaoGv7yEjW|<{ICK6SPx+Mdy#5tG!4JRXa&prqKqQgDd)#u)Y|*fp zA`D9|>_?vctqUU`fulcSY#x3&SN(ZSpDMr17L2ONWt_JVUStBTQRBxX!V`>3_QN#nB|qQ?xL z$p4R5bS(ETad3G_bRC&igq@rDoNs&{U;4ydvj64JSWI@f@v%GH_}C}#IiLTjyyoTq znU}x!BD2LI)++j;*o2vlr;p@Czx_Y?zNc;fv)@UzeTIkKdWMJHdOKhE+SpN0_V&ePGj3t$%(sURT%Wl2G7UWmua^m!wwkZje}1YcY8yxQ^r| zS4t%|lEDXYe!C#>z`;e@Rn2O(#D_rBH3T0Sk0y+#6N!|ydNY0l61G}W2(=L~9qSY~ zlG;P3)-*2!ytUNRYtv08I-J4dTXe{e5<^WHnStRV(@m`IL;XTECK3=z~xp7qi% z;VW<5g1+XydmiHNKXNx07J*0HemkG_@GXogdHC~xgkSmSojmtdcQFh-v)POgB6(i1 zsynWE*2{R~E1$zHh0I)=3;)17{`l|s$U`+|=NwP?%+KKIk9suU^s}$vYv$Bur`+=k8Sn8OKwz1h#FeW3Ys){TRjHe}9 zMci_a2k*PYVKVInQ!v>*&9ygO$JvQRjj!j~-}zGLe}-4Tf3X>>t#5=p&ne3id);k( z-B&!8GZrAyAKu4@K6D@V?KjMv;oM`N$kQMF7{1}BUqSJ9vpM3!&}^zptun&q|Fb{meILG`{RYO@+`?_2{S0ouaYAj#ZW$zU0Mx>*t(C}DW<#F74 zuEL&pEZ_WdKTdbw7xP_zcqnlKZHqx5oY6SStub0fhS`05>?3z_*F6uhKdW(O#K~)K z;R&~Y3ODcOsPV)2{D1#a>@WO0e{iqZ1#Fg~2@D5!@zysyfYs;t?B_j+^9JJL9^Uzz+yM;Wyh zMG2^lxM>r`tPMmF5ol{SQ57Mr4b~>(w(Am#CXg3mo*bOR`-qECDA2{)dnBq`g&Zy> znX1?Acxa*iCPi7>~@S5jER`< z`cJAN`?h1~C2E!EF($IJQ!za7F<$xV-{qHn>ur4e!XDZfCetaW&z|9$Yp&tOhd+T& z`--pNh0i$0I6KcbzWl5Cjd%Vuf8`9m6TgHumN4|x&9FIK%p*UauU3JB5Bwp2@b1gp zbq ziZ7LeB@W#4=2!AbU&b%L^ftciS;y};xPg8Ux3d8mC33}q zs{|bB`wl{+EGqI$GF@WuNda|5-;j;*Nr9t{rm9LZyWrCM-^OqK?tA#)JxfAXVe<^< zJ)>%Z%`A)7aQ^Af;hVqkW+vHLKL3SZ$Y1@Jw{XX7xxwgz$f@(`!+7QwJVp+d=(+gb z|A$}v?Z4$vmCWaJ?)t=?+<*TOw|v!q=5;^(*?i5H9lu}S)y(H}`V@^_WI1_p6JPgB zKfqT#qC~}kd*A%ie8+damiO%^6j2)IdbQ1`zvSn6_4hrEGv%ZBmY@3%{NdAI&Y#wr z<*LO!c!9dEId$@+#NG~rqvpM*d_kDzaxFa%}PROf@ z!3XB627<$=ZJzp~uabi$I`;nNt-S6{ALhX9qOIY=rH8n5@dC?Vg`1!ABL2&Zp2+F) z7QX$JKfoV<)_3v8N0LXh_J%3d^NDx9iXZvK-{;Rid_Zrqls&KUN#U7KuIK45`aWL# zWshQP&+^Q#{#@?(r9b16vWb1=aLoZ1?heGfq)VT192VU34|lQ}jTxM0|MF!};$u^p zNpATbKe*%T%y;yC!w|(+bPQ9qDcdO{UeQ%(o29V2<9)BT$Fn)}m@nk(6db+x|Kw%g z^BVs6es{dH3(4=L&hV8#_I-TaBTH0t-2aaM&dYxAcX`jnZd1@GrO??4p89P+$gjNg zHcpoh=No_g+j;l%ev!XiiCWQzm~b>Qt`{Yq7`F4G-0Y&2l6dg(ctlwhG<{E&Ntl{~ zB+(ui1|wF0LBi2OjF>c$u~~*q^a>ZEn8me3Cre(FOCfh6w>DPkTGV1EO9yhooeY3JKMWLg}j`2yQgCR3A+EPW1&vW{&qfgZyTNB2kiWtRU z6;jnYc<~)*BW~V6NRgg~K$OZRh=zQA*$9i}am%a>eb+KO zI%IZuK=hu;xZ?DwoKO7Cef-G>FEbmC*=Hfh($N~j*^?!!4}XBSoZIEOk1DZ`csAeg zv|s0M-`*4PsNlpbW~~_W*7y~zXzqADKlJ18W;lI)s&ph_E>jnH`zwBcU-_Ij^4*WN zn6uC1^Pltz{`7rLIx`;$(QwmqzLw`)BgEqNLvP@vKlW$b=S%WD$Y-P!Ry#iWrdRU4 z*ZnB3`pRoJ7lI!Ii-B?|)l(E6HC#DH3Q3VAi_E-~3<>cKDO60tg7trnEIQp%R53-K zWAvQ&{>~dkHkoBu+n|&tFDv@aVY7^W82Gz4{5rpJ@_YG?+ozawxADx!y_=8yji_e4 z_i689nLhH-Jbp{QwBdoj zC$d)YUwQh$apLLU%*&p!izYCC*N^d>7rchM203Vrk;4VR`^&uZzy5E0%elAkrWf6a zx$!IcjxYa3-u~JP$xPeQG!1Rtu(dVC8qFvxD07>3S|Vo1Gm9<^gOk1E`jd0@AxDRv z&UH+~b|O?ORA$H@|M@)kiDMLz)!)CKpZLkYq~1QsWLpZVW;rMLfz|9HZ~LkLz+Uzm z-tdh#U~YIGFL~b2^3K=XhtithB-Jsv`}n_p@a5#zGM!E&8)#Gs$vDZ-wZF*UzV4@a z{dGUXi*DP(oV$%DU;h{U;e#R$30@Rw)@GQ(9*?Emip9ZYj+z={EDDbsJWb!zG=jKM zN}<{-M`{7zOI*SF>NCbLo`~62>x|s2$DayYOc+lBQ3+BWrBLH?b6qQ~a36mYFMjcF z^4GOxG9G=>eG8ToPk#~r`)6&Vi7fy2b-d(<-_D)gn6k3;ZI_B;jkP@=cI}*sPe*T;Jll2H&?yiPB>; zBN+4PnC;zNwsy8tCi#TXSdtINlPROoRDM3$k{{D4lj*kn*xF@#XP2$*9mZn`_bJON zB^(NNA}>cww|3duKFMUVeZ{<9Xjz)||W3sZ6?!cx@j`b^CL1L|}`3Wmi>dZ3fasT({^=ji?MuP0b>==xrabA7+L zh=-Jpxvt1S0zdH5yS>6-92ZFhn=J`?ucA$Luy+TU%7)(Xr{a zs;I`N`Ml>pjnnBf{ry+Jg9nwk2!GS_ z&4sL7q=*VJkcx4<8jpl^n0!AGF@Q$ESVLYG6h$E!Hvd|EE>CXm9M15MLNU`=9Q zp(RPKsoP^NR+14eS1VRcvr#x`Wzb3w-r z!ET^|CPRZsZfN=uAJFC*8v9{vvfDObY(HmPwj?LXS=q|Ey7#2LE3NQ8%vH6Ic+mYA zz8~0Q+#%`QqjUDITD8`k|M?F|1bN1SKK@xg{Q1B&R|$o)SU(=^%alcZSo`v$FEc=;i%G*3ge&rrFQ<($dE!<=$t6Ps;+s;a=clC?9Z z88XxyIy6V4sH$r0T2y%wXB^IzSbqv;c-X(XaR%DElVC8La(72Wj(ZrYAK=CG!G=IMKkQFpQXg03}?>+vWTlxG>;_`!v;(`l_>hA>( ziwWzD=1{4KWfTw7u9Z_~`K=LXfE2nDIwr zEv~m%qv#sRQ*qX^zBXrLZG)z1SnTZy)Z#s8w_4;%gR;V3Z(FQ0Z0~Nfy}Lz3tz%3{K? zV_T9|=qilwXzNB`G$qvBkW}_pQs|RT zszcex)1foRf0!-k{hdo*dm+PcecwsIR>}vtan$?RXTDn!g52x2X|rFGL2JkQxsT-q zFMJkPUwJ;K%;} zOh*f0qAWErCW+`J(eLZ}LMP^uy0$cJ3);#|@RS1_$;M-9_Fx_+VZ@NIT4JHwT5|6J zQci=deNVTLTozO!w!7@@?oqc5Z7*i7#uhpCQPgld&A_rtv^x)S-~HRt!MieRPxi*S zPrUbYeEjpbb2pB%s506hw<3f9XB^_pdDeU#cqYH|!Ds%%5nlIaT0GO4OAH=x;F!IFb8ok0c=q+ThrN!#)!5jAGk5karQ@; zdoKd^6r;?VbGDNA5?YtCVQppfXc~N?UMKW$iHR`=cV-8j@o)p7tP;zmXJ=i8)M^Vgq#5aCBuYSd)9Q>DFKOaV=v)H)U@qVSIW|>yGF>Tw*&>RGV*J3ug zv%M>J_yERa2V0@9>Vt+rrfBo9$aC-4CxF<>xeZaR}&I%Ik zgq}95&LxTPxsFMS$z#WO;K2uSil{^%w_QuzY4>#+3zmxojhB>3r8U}TCRM&x{Xc?V zV~XgcMt{5gpnu#x&I5}DjgeGXA4HHCgA^)uGULEkBlEC2XSB$WeLA0^l_cp(GoZ(V z%vvW}lgw~KDSGe40JN_2!I1aQyw~-8PuKelkE`qyp+;yu0U--Ml{S>w#}C8-+vg(C zW~~`WDr(a-^xjJm?rbJNotW1NJzW0b-S1^Ot(ebe6jdpXqrI0@xYpDA#B#6Up@)vM zy|bGmQrpb`_jJA=tK4PX&~zYM5JMtGD;6fX zdu+Rou4!rNn!-6$$}E&j-*e+eI_L1|r?I}bB#~&lPCTwoemvjw?6WweA%)|7;;;XL zKYHtj_}m>wnH)I6DW{#o>1UkDsi&V#Jvob4y!2vDleU1#bjs#*P9(_!?>dy*2Roqw zO-!;G3Ds6o^0dv_6#D^$q=;xx29+1cxIv{v@R2U|XdOli7U=@BB3XHs-LRk%{oWSG zj~~zO#};i8-BPYI3J4ut*Wm{%o!kKp5T3Zuj&F|S`%Dd0W1!RgvTxvfzxh%QYDJ2> z-1?#S^X?Dd$es6Z^U(GlO_!L==A3-$X}B}4;X7aXSP|tVad=SKi>fG!htpBBW<_x8 zA$tT&CX?u#Us3Ek&<4v3dH)e*%&0B$UwSjI{)xZi-jD~KiA-ddk~idHWVkqqMDj=Z zoHwKO5Xp<{wo<~x^WuxL6ZAll#ZfutNVV-Tlt}%eHRZX(aeMpa=uK;?_p&h6hnrV>=IX$ z8M0H-o#zgs$RTp8=T@My6u}!gFnoqI+qR)B%Q2dwr)OC&+1*>Pv$IP*!n~1?B8%m6 zET(+!<|X&4V0~>3V+>8bV7Zhy46Br^HRr@8rk5nj)OS!1aN3D^ozTPOUGI4>Md_H$ zr%a|(j27Wz({2U*c9I3J1^UwUlD!CM(Ch20E4Vu!0z+QQC>BII z%GuggmwPu;e35l|9aJUCqsjJ!#?njI)pFrUxZ%biUh<~-)9 zmvcZXNW0whrr+leKYWx29(oA!d`)h@&4-v87imfft&GsE%L!FA6__y}d}=afW*kjc zAd?TgAy&In5{7l)!1`F!4iKS;C^cz!o9(;+^m^jHk6p_L>LK$cW+&y`H!AUKQVL== zeFWK9j855$EnBQa#JenSSWVv%ceV*Ju&ie}XlzQi4^q^o#JQ3bLx%Z!oQ1DlL``S?d-6%was$59Dmjr#T)&oA5lmIHtI~i^+#ULSw_h)`@5gR zH^1=?dL>pugY}Owo~{c-Z^kv9x&=p%9-}XcEM^rJ+>&}_qZB*p<$|rIXM1~_wrxkV zQjiVpA0IAa4l%$ygKkYftVoztZv1@O$gn)bI2NfY?t|vE!Br*NXZ!q+vTv8jBUH1; z&T!x7fxEA}o*Pt|pOKJVML_2`?ZLoun4J{Wl(MWOvp&Z}3~a2TC`Oi8QOF#*>l=D6 zkeRVE^B8iG`o1UhJ#7->`Fe&-t~rsf6MDEjxU+}W3b(UhI-4@7W)eAz#wX#Wt0FO*6)0u$u;0@6 zL(X-NLSad0n=6+n6@!l<=b5Jwf*B~uI@=@^Wsw~f#Pl+yY_h0^n9~kxELB;coDx<0 zR9tnJb(<|1{74HX1+i5ydQ4qx{JC6kp&SO`!T0m}x84bM!o*c9mqJ_KI(|$TT)_O` z`aW9^S#&;E)Cwa*c)PE2$t)~m#ZRj3I;ttmrc+$$DB21=FURlKWv@C@iB6XS%-5 zd@`ZU$%P|(47nG+*PMFVfpPQJ#xb9*(Y7@qM!Y_Sv(K`5VE!pS{@I$zY=%9)Eh^_2 zbMTTdgl2~ivOaW@Ial13CDX~2>2yk8*K7wkS%cc#-}fWu-^T-- zf5D-#N=>29ZW4Kbdgra&vP@jQuF!|B;Og_>eV+>?on*7iVOdJ493eZ{g@{#-3@P-A zQmhn&NQmO$Wu1~;C(4@MTP*0iUR2#~!SUtFlPd+EBN6g@_dOx>_`7f8&L;85xk4Yj zn5)i#8*Wpml<1Sh0Q>0CR`d=^tE|8dfUMoLkA6yZHBWl1tf_F%+xX2typYI+8=Tr5?!W&&x}uT+by-l94kr6HhS;%l>=?VbU|Gc;3|smSL-q#3VJ(E{x3^x0YZv@>(&*h+A<^ zA&n`Cl)`(A>7_u+xl}3i`F;(QcgcTpg{6!IHjA)_i1m<*N1GwGu50Prju6BSM;p=p z6gj^tB@xbs{9G7gN7Bv14M)Ga*9kpb4xW6@??}dvMgvq!g%^ zHH!$tq*SV$ec-UNOlE6rIGc5yGH6pqoKg==rxcr$@o+KIgB&_^nAT^ABi_ZQZwWl- zGK-pA%CoLH$ooDZwll;0s&FNf$&9k7@UzQ!#wDwnkDIKsv8iaghPG*l$xwC+wjvzS zit?;;IB)h@ZjXAzedTk=2G(#9Prqu_2`Mc@M{6yq?}){O$#DI4cj=tN4x0kPehD$R z{%OL+mz~atVwsBBd<|8UI)UDE(i6b^Od zi9GkpRmD57hQ?Xc@)NxG`i2)iV}f#z;H9s)g5Q444YZ?U>}tCbe1CvprF+?LTRv>y zT05eN18{~Sh--L)w(sc&wY)Akx>yaVeX~a&1Fn<^F& zqh4j`=3@->yEpK@Pd2>ZDHD`EpO?J+Dqi=CpPLGUhHS~cFN%ng?f5La!X_dTeH6o3&_8Y`3iRJy?y!f8pCOiAJMB1j~h7R`ya4pI`@DUhOK zGMO@&Oy&0ldEilg-yBdVf_>lTIOBxUOZGBVOP_H8k2$Vp)4n~ZOeSV#$+;O zcIE|Kb^3m;eUdDO43Q+2G0qSlCO8Ti#~mVum4@JZ+7@DRsD58{p%jI&Vi6G{aFh?e z?-u^!rH`OcGoJZP&*G1-eLG)h0x1bIXLXQjE_%rmc}zLJLt>Ep`NeWU*EKk2DDJ=+N zTu)sun3NThvXq#BlqiZ#p782_$J57%M};Zp%w}z-X(v)#@XkMd4-Y==1su_a3%=t& z^P}&4CBO2C#fYbiMY*`ln!IsHb!%`o;e%}GF-l>hf)e$*@AKCJ3Wd?)z#C9PwNHt9 z-;la*8x{>z+R_DRI`NL`{5`z&P4DGbh{|i)obxEIJoONFY)fuW#7l7(WFtEG?4ReSo;};QreSZ< zu%lY6ZCTU}&MlaC_wrDkpj5Cn!z`B^qn8;=jv)v+#Wcjg?%tB+mv7{zoyZl3H1@LR z^YxGT1Ag;X2g;EUOL&3GN-lflt9kK})l(B=$|!>*TB6M`R>_ZvrkYNfB(cmNpwbaW z4|}}hE$`>Yp7cD9Xv2B0_&&b>9k1rUe!3owbyv``6vxI`ibBHms!9`*#u<%Dk*=v} zv+z>q?sJe+6qACu(m#DIumi!d_HG=T_Rx*9z4jQLx(tg_#_S; zIK{x14B_x3f4E~9653l)rdI> z2fT3NUp1*F%*{P~;b!5_>-DGdeLws(jyQpctSgyLXF$Qu>^z?IHK(zz2J97xfx=m; zs$e>ipsUGbLbXpvqD+6jRAq%ThI{_u?|A1? znMsw8{5pR1N1n*}Q;lNC$!MsXz{yX25&!ucjtJ>tc#FOn+wj4LJuJS+2d>+bJUe?X z-}Zyg=h8|v7=72#_bq`5SH0|2{MNT$K$-Rr*=3llNVHwUa_dXnewQ3>YI+$@dDhvK zT}_Hnm@8dJiiSg1y@>Dp)<<(dudbge*Ex9T5Yy>Yy4?&N?A>}hUtY*Jxzn!Xo4?^w z&X`palWi<(vo$t1&)_lN@yq<~cbxsO&uiS2vZ!!Yl<1`^X+QXf{M!4s72=Q#&jm)yXkzL zYC6Z26O=7LTaq>;3yQ}iLMXq?A09K-r<4! zZsJon%cs%nSMa!t6kCfW4{mMq(9SN$7YmNz%7xR68_`CeV3oqh;8+0cr&#ojZB^4Vy`nfOXwSV;c{Ngj# zn3M(1iuNgHinYxG*`WZ7F;Z0%rc)v5SZ#2|5VPE2=)6RUpR%Y?MgdLRu)Dj<-rg=v zQ)f@He2sIr9OFni5e8UM=E&zP0M3PwkVA5OM35n^(H3hTuC@AVUMIA3sTXzbDukL! zLN@L~au%djwK@51=sE^SMAW7#x1c0pQw1+Wru}|W19mFDKyoAdv7=dGx}lehY@-cj zkt=7PH#?#kyLeI1*bDxZ4SjU2!1Dh?{k+0XxB-gL$1 zc>hPf#2s5bZtV~kJo-w$=Hf$C>~h`PKEp}RzlL*+Ktu;OH>rw}GK&Cxip0&$m7{HO zfRj!+jbn=zg~SExOlWXLA+79w%4AHaOaWI&if5{C>v2TlU~Fn zrDE+-FXHuYdORQf$Y=TT(T?iiDO~!P%X!qvB|P*A-hBPZy!?4*U{Hjv#(Oum?@fI- z*S-7GJni2G3b)N6xx}Yp?wrx8Ap4dgxTnx%?^~^N2$f)O_W}`SuY_3baOw~e&j2h{EV|WU^Is=c@jVRBj@vk_ngc1U%D52;0&&K@>6)q z#RqZAFYq@XEcm+TohOUmIGiaYk7USoNyqq$pL`7$zWx{a&P%4~jZ68C|MsW6%9S zZM^NBU*@MDa|zC#%d7tQjhy?+&w55N0HKKb?E z&toQs*}#*(bqhdt4^y(_kV!jdEXhl>J{hbP0SK}0v$8? zAkRDYJu1O_`bdU@29k>$MncZGpFjKQpXb8Y{Q}>4@f5xONWSA&|A?1-|4n@O+RyRj z`?gu8g0;<)IQzm2x#Ce5aC*M)@A$J0r4+NOl*6KrnR_F}t+A^ZWvxY&*`_8Jhb|K# z)GENM>!>E{6lE#2`xt2IhPqy6QiH*VEIKzv(sHw&OTmg+OO*83y#BNzn^&6L)(ynm+8b0>JUnlf%amGP}KJ;Svm{r)z0UyuIuwfA8bA~x&RlZ)~)nY+i1B3HzDN27< z>pXxf#{V9&XygPk6lKN4NHrlz zbg=x?JNU1EvB{6U_*^!%W`5>nJpbjFJ?vVf{um#5-LLX<*FToud;V~>Cv0wRQdJXy z2%WIh;^ro0{ubrdICSc1oU&{nLg9*x@oKDfLQkCTW0wtdLM8aQH5%g#^(X(5pZP7z z&%WwwICr9`PCB1wz3_aVwf{ZV_wcvB{};UT^l##M!`F~Joun03JHqgbzVdE<<@e6! zwXb>%rxgmjaVAgx+B13b>Zj4&`*D8#r+$ymJn83ndHz~x_SoAiImkDtFBVMnm}IpYzjye1zBj+edInYu3+yJTE{0@elvM`=fmDcYl!|`N-q=-gXS|kI z$-6+?3D!0wq*ydY9>0w*ePsug)+nq+k?8xD82XF=$V}5(CqmGiouXMeWgD$2om;sWJIj1N zLmAEP-VV#UrfzDwRzm4e3Ki7|H!EZ=Q{*mb*h_t8$U<7#Ol3kzjG_~ZCO)jFIZ>|@ zdbr3;#ba{@^zg7+yGjlmvdjBkf_3`7mpMdA+3!Z$Hl@K@O-wQdZ99oQT~!>4!phAs z#)v_i?}=V;X_cwP0}XF)Z;u#-uf( z`S1UQPrUDHUj7YF;K`3Zn==khDPqI1d++A6H++n@{n_904`14)y7a2m1yY$(9ik+~ zDT8(8n7|2uE}5-uux?98g3AvU!r78^DH@uY}|MAcA ztmi#}CtYzCXC9t2Q9U~k-p`kAx{-Ii>l1wDsOOyX^Uq6>E@;-*=4d5Ms3Fm@swx(r z{2PAa=Wpf(U;8*7_sG*YZL`9Jnxl8$!Sx^be|Y0tKE$mH#rfB)K63Oe%cVyvnZ>nD zM^hi;OK<&cUi+md@~me)j!Vuzm4oXQHZ<%!a5uMo_LE%qfos{Fp2Pf{3-{ssA=5uK z#yO00s7w}7D7HWMFu}1AmlqcWjry&lgyvQ^ z^pJ(8ob(Sl^#MlB`KPzdN4>yxpS(P8v!i!i$3lrfVm~t6T(=DIdyGqcoX(9+53t|n z+aZg~mK)Dq&-wLE|6xcW2CVA07xYM{@c7=3maZFd?RzE`FAU}0JA)ZP!J-&0w5@w= zhprF3kC$o3{p;SgVDAGnZO2W;HC|uzSQT%>e`}Zrd(8f?odFpvJqPDcFEqvzRL6Nk z1-fM7z~Th{Unk~Dh^i`3Me{TDj|HG33y?n)=q~E`=3>-v%!_8$>75w7<-|Y|aQ*6e zuP-ugKb?bQ$-uj&$dg$Yo!}hONqvY2o((OxE8h#+JjAjo{g3Uc<5J7vWs2sh?^R^Vr?xw_B=gq`9Rb$!fAE>h z0`*wA*v+Qg`RZEOL%aj#!O&v;o^6m6Z)IcQJ<(&Mr4KOL5|Vjb;Zx=ENkciH0a7M% zU)z|enEj(&Y-fmM1G+n}nAJ>EW+haN(KsC4eS+J(P32ApKRX@0*O5Lkk;8*A$}}oS zH+jcMlr*n}CJ)6-Lj}l4sY}>f=}bq+NH(k{jK*Zs#Vy@!wrEMoOI6!1yTcXmP#Q=o z8tIPCW_^4g_R)RE+KHi+lVz!p>o0zt`G~Ajei_h0B0sq|q`{$8UH#F2Y%Xs;I46gE z4m+xSc=)LpTxDNYMfoDN2AYwX2cnu!f z)BE4clzyAg0Z5Dv=IWhMHdHSdfO;EN{=oR$KMI-LGLVZD-p~Xvn6gx;HeIkD{A#pN z-1w_gB-2wwPn5jyU3~OtJ!Y-B&~TaaF)6l%i*21DWVh_U?n@$^XqfT{?yyt4k^dDu z?d)@zC4#iYCg#F+5UHCo`-<~aSyWfJdaf%flZH+E%S7Jk9D3i~#S%7=3kq-q@6(NE z>x6(oh#t3apqJdYbwwM(1v!OgLem-9ba{VPIFIWT4V?Bz@`Gux6kS2}^>vTg4WLAe zAWv=~P;x%EI8l{qpcjw~EpUj4WlqZgotBa*N*!LCYO27STkHFz(rn1mFu5ERKr9!7 z+{Ci^8w;Gtn>?`ddv4LKCcy@sJ=V8&=_N5-AlCfrT78Jrc}^Qm(U??P6ktIls6eZu zsK5-c+}et75lV$$n10MG1IW~Jh}m1RY*CG(^2?Xy%N3-vg@+|` z@O(U(w&A7wV2%_5wTgUVZUy72|R8^v8-*0SmD$N*y6F>=-Zbhq{P&+vmjxhRx zk}{VXp-38t9W7lU>Olb|-yVlrvIm$*shspW(p-CJct-pq$ZEo!oDtUFK}lU<87(GO zul0fu%2aX^!Pa09Wf(r23sw=l%tt9@^yHATl5=BLxLe=q-MuQ4KnoDba7c;?iL=Q~ z1!35WCS^dRv+z*Cm|}eZj+q}D+eJ&iaUjZF|GD5|fOS^Zp_=MSqG)-yh@AINRs?*L zM!x-@j12s!_B9FSF`^b7X$|fNUk=pKxWX2BcbMWv7YAuOs_9)sWx1YGjTo{k)F3eUW~1n zfhARo-uRzfA#c5sdK)>=@E;j9UzFcmnhtOzAdOFj%`FfhIAe=SylQT59|tD3XPQZU z0#GfGL;C`tr@cNlqm8QV4^`Y|Oj3!6OA=dNS#OVewHzBtzY7h^^><|z^wB3+dM1Po zTBfojj38Rg!6Qd!J5v!7hNxg1ER7GysD0W9X$Ti0oCv7)hwn6G-FEXG(>n7MIPdNK z_Fwoj55sVEzGyKg9fUK z5?YPj;ASuVZZo(rP{-&~bsOAAtZyH$#lIneWqp2ET6s$r=e|X+UJ;D;WW>*_M*a`Q zqJTD+A}p^pPnLE;V%29vM$Bl8Tz76QgC+K!ox?%zyM5F}U~2Ri`+0LG(+{&6LQ1w* zfyeE|$0S8&^x|)ayw}6C$9QlD_sjV&Sox@!mA1deBvI2yTY$Q0ZG~gGQW)zVx^dLM zTN6y|;hle>g-^oE(h6z4NS${niBrplG*l7ty8(wCZDoj3POkIFL`L``5!030Ff7`W z28(S7UP=odMVA|$o`mQA=CYOp&;z+=->CV%HY7MujGORhYCODqU+olT5Fhyvr;Gwc zYEPGru>x;(T=7UPL^`0|Rq{tQrBN{q1+6&`G8Osu={n){Z_yXaH{H+z2F~8Sz6+z( zH;6`eir4ehA?gqYzh=w2TMC;ISj7NxMt71FroIVJGiV0~ko{i-TM z`9rg@3dInlvVy|F5ZXr?g$2H;ZWvE-D``~Db5pQXKf1?T24r;{tv{qflLmh-1#+YO-0|G2=LL9YG3*IbEl?1PNgYN~$KkG$%hx;eeY*SOmB;@-kv zoQh*u`ngcvl$fQo@)G66DtbSEci7*OeNUc&lPEo0rv(L@lj<|~-+0o_P)#7r9Suk=VO8Y6*+BHj&xnne~F*+WR4(mijk!81yi z%AJYFA9nT#-{$djg)49O64sr6`K01HPD+3O@_7t4rsvze75%uXbNH>VZ+6vTFzi|2 za)z^IKGJwVC>fbg|ko)nT7abK|kxp6KZp)jGV0sJPCzM1Wf`7>4_atU`;#TlXzq+AJ)xA(D)-%vU{4!Gpu*J^nD&;T)U;7}0s*R1#dIR`-Ibc?6A|P5& zp784Z*EA&2oUOo4x$raA%+EfzF-hmB6}YysR#cgmLyX zlGZEB`y8Yd73=}%Y?5@)N0_wTODM*t7@WUhG_kt@T+HT>kYm{VWaiMjAT z)AnK;eKACZldAEt?*a_~)<204+ZsgH~?|JJHbs%%V2h38b% z67{g>5FU~fJ(ZY+bnML4qK{RdLm=Ys38HnBykp?JEyIRyst-Dg1yjEd6X+{01xMs& zB3bLqDdhfhk&59nOSmb8vbu{2_*8uBW9ZFhG4Oy|+42>z%lceazKR%B#+zuYH{nl>*LjW5Wc_wrv3BpR0k{b9P(d1uR z8k6f0ndX{`lmOW}(i!xHGZ04%WskJC>wj14al+JgTx;4+_!>A6_qQ3Z_@4i&>e@1j zz{H2k0@ue~iz{vSfzl1`2gtobGXv{!NUkhcxui7p9R^ zxg_P51VlBtr|syGm4hpSk?C3MU{%Y9&8YrGFBYl%!j2RaRTTVCR@5BrIocu0aL*~C zByRjaO+4;ew2CVpu70FX5;5d5OB1Y_Gg5@x2Y42$5ga4MmA~4Nkk+oOJUrraFL@i6 zQx@#(2!GQOvOTlS`g@{=1G)P)**sX6`M$qd#7cpDoT$F={SJyCrbyy5b?r%4l`WHi zR@{ak?$5mN%^~>DcMgZIPBxY(R

The **dioxus-cli** (inspired by wasm-pack and webpack) is a tool for getting Dioxus projects up and running. -It handles all building, bundling, development and publishing to simplify development. +It handles building, bundling, development and publishing to simplify development. ## Installation diff --git a/packages/cli/docs/.gitignore b/packages/cli/docs/.gitignore deleted file mode 100644 index 7585238ef..000000000 --- a/packages/cli/docs/.gitignore +++ /dev/null @@ -1 +0,0 @@ -book diff --git a/packages/cli/docs/book.toml b/packages/cli/docs/book.toml deleted file mode 100644 index a1e57f634..000000000 --- a/packages/cli/docs/book.toml +++ /dev/null @@ -1,6 +0,0 @@ -[book] -authors = ["YuKun Liu"] -language = "en" -multilingual = false -src = "src" -title = "Dioxus CLI" diff --git a/packages/cli/docs/src/SUMMARY.md b/packages/cli/docs/src/SUMMARY.md deleted file mode 100644 index 98a66ae21..000000000 --- a/packages/cli/docs/src/SUMMARY.md +++ /dev/null @@ -1,13 +0,0 @@ -# Summary - -- [Introduction](./introduction.md) -- [Installation](./installation.md) -- [Create a project](./creating.md) -- [Configure a project](./configure.md) -- [Plugin development](./plugin/README.md) - - [API.Log](plugin/interface/log.md) - - [API.Command](plugin/interface/command.md) - - [API.OS](plugin/interface/os.md) - - [API.Directories](plugin/interface/dirs.md) - - [API.Network](plugin/interface/network.md) - - [API.Path](plugin/interface/path.md) \ No newline at end of file diff --git a/packages/cli/docs/src/configure.md b/packages/cli/docs/src/configure.md deleted file mode 100644 index 3b9f6189b..000000000 --- a/packages/cli/docs/src/configure.md +++ /dev/null @@ -1,197 +0,0 @@ -# Configure Project - -This chapter will teach you how to configure the CLI with the `Dioxus.toml` file. -There's an [example](#config-example) which has comments to describe individual keys. -You can copy that or view this documentation for a more complete learning experience. - -"πŸ”’" indicates a mandatory item. Some headers are mandatory, but none of the keys inside them are. It might look weird, but it's normal. Simply don't include any keys. - -## Structure - -Each header has it's TOML form directly under it. - -### Application πŸ”’ - -```toml -[application] -``` - -Application-wide configuration. Applies to both web and desktop. - -1. **name** πŸ”’ - Project name & title. - ```toml - name = "my_project" - ``` - -2. **default_platform** πŸ”’ - The platform this project targets - ```toml - # Currently supported platforms: web, desktop - default_platform = "web" - ``` - -3. **out_dir** - The directory to place the build artifacts from `dx build` or `dx serve` into. This is also where the `assets` directory will be copied into. - ```toml - out_dir = "dist" - ``` - -4. **asset_dir** - The directory with your static assets. The CLI will automatically copy these assets into the **out_dir** after a build/serve. - ```toml - asset_dir = "public" - ``` - -5. **sub_package** - The sub package in the workspace to build by default. - ```toml - sub_package = "my-crate" - ``` - -### Web.App πŸ”’ - -```toml -[web.app] -``` - -Web-specific configuration. - -1. **title** - The title of the web page. - ```toml - # HTML title tag content - title = "project_name" - ``` - -2. **base_path** - The base path to build the application for serving at. This can be useful when serving your application in a subdirectory under a domain. For example when building a site to be served on GitHub Pages. - ```toml - # The application will be served at domain.com/my_application/, so we need to modify the base_path to the path where the application will be served - base_path = "my_application" - ``` - -### Web.Watcher ✍ - -```toml -[web.watcher] -``` - -Development server configuration. - -1. **reload_html** - If this is true, the cli will rebuild the index.html file every time the application is rebuilt - ```toml - reload_html = true - ``` - -2. **watch_path** - The files & directories to monitor for changes - ```toml - watch_path = ["src", "public"] - ``` - -3. **index_on_404** - If enabled, Dioxus will serve the root page when a route is not found. -*This is needed when serving an application that uses the router*. -However, when serving your app using something else than Dioxus (e.g. GitHub Pages), you will have to check how to configure it on that platform. -In GitHub Pages, you can make a copy of `index.html` named `404.html` in the same directory. - ```toml - index_on_404 = true - ``` - -### Web.Resource πŸ”’ - -```toml -[web.resource] -``` - -Static resource configuration. - -1. **style** - CSS files to include in your application. - ```toml - style = [ - # Include from public_dir. - "./assets/style.css", - # Or some asset from online cdn. - "https://cdn.jsdelivr.net/npm/bootstrap/dist/css/bootstrap.css" - ] - ``` - -2. **script** - JavaScript files to include in your application. - ```toml - script = [ - # Include from asset_dir. - "./public/index.js", - # Or from an online CDN. - "https://cdn.jsdelivr.net/npm/bootstrap/dist/js/bootstrap.js" - ] - ``` - -### Web.Resource.Dev πŸ”’ - -```toml -[web.resource.dev] -``` - -This is the same as [`[web.resource]`](#webresource-), but it only works in development servers. -For example, if you want to include a file in a `dx serve` server, but not a `dx serve --release` server, put it here. - -### Web.Proxy - -```toml -[[web.proxy]] -``` - -Configuration related to any proxies your application requires during development. Proxies will forward requests to a new service. - -1. **backend** - The URL to the server to proxy. The CLI will forward any requests under the backend relative route to the backend instead of returning 404 - ```toml - backend = "http://localhost:8000/api/" - ``` - This will cause any requests made to the dev server with prefix /api/ to be redirected to the backend server at http://localhost:8000. The path and query parameters will be passed on as-is (path rewriting is currently not supported). - -## Config example - -This includes all fields, mandatory or not. - -```toml -[application] - -# App name -name = "project_name" - -# The Dioxus platform to default to -default_platform = "web" - -# `build` & `serve` output path -out_dir = "dist" - -# The static resource path -asset_dir = "public" - -[web.app] - -# HTML title tag content -title = "project_name" - -[web.watcher] - -# When watcher is triggered, regenerate the `index.html` -reload_html = true - -# Which files or dirs will be monitored -watch_path = ["src", "public"] - -# Include style or script assets -[web.resource] - -# CSS style file -style = [] - -# Javascript code file -script = [] - -[web.resource.dev] - -# Same as [web.resource], but for development servers - -# CSS style file -style = [] - -# JavaScript files -script = [] - -[[web.proxy]] -backend = "http://localhost:8000/api/" -``` diff --git a/packages/cli/docs/src/creating.md b/packages/cli/docs/src/creating.md deleted file mode 100644 index 4c594dfd8..000000000 --- a/packages/cli/docs/src/creating.md +++ /dev/null @@ -1,37 +0,0 @@ -# Create a Project - -Once you have the Dioxus CLI installed, you can use it to create your own project! - -## Initializing a default project - -First, run the `dx create` command to create a new project: -``` -dx create hello-dioxus -``` - -> It will clone this [template](https://github.com/DioxusLabs/dioxus-template). -> This default template is used for `web` platform application. -> -> You can choose to create your project from a different template by passing the `template` argument: -> ``` -> dx init hello-dioxus --template=gh:dioxuslabs/dioxus-template -> ``` - -Next, navigate into your new project: - -``` -cd hello-dioxus -``` - -> Make sure the WASM target is installed before running the projects. -> You can install the WASM target for rust using rustup: -> ``` -> rustup target add wasm32-unknown-unknown -> ``` - -Finally, serve your project: -``` -dx serve -``` - -By default, the CLI serves your website at [`http://127.0.0.1:8080/`](http://127.0.0.1:8080/). diff --git a/packages/cli/docs/src/installation.md b/packages/cli/docs/src/installation.md deleted file mode 100644 index 22803be61..000000000 --- a/packages/cli/docs/src/installation.md +++ /dev/null @@ -1,23 +0,0 @@ -# Installation - -## Install the latest development build through git - -To get the latest bug fixes and features, you can install the development version from git. - -``` -cargo install --git https://github.com/Dioxuslabs/cli -``` - -This will download `Dioxus-CLI` source from GitHub master branch, -and install it in Cargo's global binary directory (`~/.cargo/bin/` by default). - -## Install stable through `crates.io` - -The published version of the Dioxus CLI is updated less often, but is more stable than the git version. - -``` -cargo install dioxus-cli --locked -``` - -Run `dx --help` for a list of all the available commands. -Furthermore, you can run `dx --help` to get help with a specific command. diff --git a/packages/cli/docs/src/introduction.md b/packages/cli/docs/src/introduction.md deleted file mode 100644 index 8b10b0546..000000000 --- a/packages/cli/docs/src/introduction.md +++ /dev/null @@ -1,18 +0,0 @@ -# Introduction - -The πŸ“¦βœ¨ **Dioxus CLI** is a tool to help get Dioxus projects off the ground. - -## Features - -* Build and pack a Dioxus project -* `html` to `rsx` conversion tool -* Hot Reload for `web` platform -* Create a Dioxus project from `git` repo -* And more! - \ No newline at end of file diff --git a/packages/cli/docs/src/plugin/README.md b/packages/cli/docs/src/plugin/README.md deleted file mode 100644 index fe7375618..000000000 --- a/packages/cli/docs/src/plugin/README.md +++ /dev/null @@ -1,140 +0,0 @@ -# CLI Plugin development - -**IMPORTANT: Ignore this documentation. Plugins are yet to be released and chances are it won't work for you. This is just what plugins *could* look like.** - -In the past we used `dx tool` to use and install tools, but it was a flawed system. -Tools were hard-coded by us, but people want more tools than we could code, so this plugin system was made to let -anyone develop plugins and use them in Dioxus projects. - -Plugin resources: -* [Source code](https://github.com/DioxusLabs/dioxus/tree/master/packages/cli/src/plugin) -* [Unofficial Dioxus plugin community](https://github.com/DioxusPluginCommunity). Contains certain plugins you can use right now. - -### Why Lua? - -We chose Lua `5.4` to be the plugin developing language, -because it's extremely lightweight, embeddable and easy to learn. -We installed Lua into the CLI, so you don't need to do it yourself. - -Lua resources: -* [Official website](https://www.lua.org/). You can basically find everything here. -* [Awesome Lua](https://github.com/LewisJEllis/awesome-lua). Additional resources (such as Lua plugins for your favorite IDE), and other *awesome* tools! - - -## Creating a plugin - -A plugin is just an `init.lua` file. -You can include other files using `dofile(path)`. -You need to have a plugin and a manager instance, which you can get using `require`: -```lua -local plugin = require("plugin") -local manager = require("manager") -``` - -You need to set some `manager` fields and then initialize the plugin: -```lua -manager.name = "My first plugin" -manager.repository = "https://github.com/john-doe/my-first-plugin" -- The repository URL. -manager.author = "John Doe " -manager.version = "0.1.0" -plugin.init(manager) -``` - -You also need to return the `manager`, which basically represents your plugin: -```lua --- Your code here. --- End of file. - -manager.serve.interval = 1000 -return manager -``` - -And you're ready to go. Now, go and have a look at the stuff below and the API documentation. - -### Plugin info - -You will encounter this type in the events below. The keys are as follows: -* `name: string` - The name of the plugin. -* `repository: string` - The plugin repository URL. -* `author: string` - The author of the plugin. -* `version: string` - The plugin version. - -### Event management - -The plugin library has certain events that you can subscribe to. - -* `manager.on_init` - Triggers the first time the plugin is loaded. -* `manager.build.on_start(info)` - Triggers before the build process. E.g., before `dx build`. -* `manager.build.on_finish(info)` - Triggers after the build process. E.g., after `dx build`. -* `manager.serve.on_start(info)` - Triggers before the serving process. E.g., before `dx serve`. -* `manager.serve.on_rebuild_start(info)` - Triggers before the server rebuilds the web with hot reload. -* `manager.serve.on_rebuild_end(info)` - Triggers after the server rebuilds the web with hot reload. -* `manager.serve.on_shutdown` - Triggers when the server is shutdown. E.g., when the `dx serve` process is terminated. - -To subscribe to an event, you simply need to assign it to a function: - -```lua -manager.build.on_start = function (info) - log.info("[plugin] Build starting: " .. info.name) -end -``` - -### Plugin template - -```lua -package.path = library_dir .. "/?.lua" - -local plugin = require("plugin") -local manager = require("manager") - --- deconstruct api functions -local log = plugin.log - --- plugin information -manager.name = "Hello Dixous Plugin" -manager.repository = "https://github.com/mrxiaozhuox/hello-dioxus-plugin" -manager.author = "YuKun Liu " -manager.version = "0.0.1" - --- init manager info to plugin api -plugin.init(manager) - -manager.on_init = function () - -- when the first time plugin been load, this function will be execute. - -- system will create a `dcp.json` file to verify init state. - log.info("[plugin] Start to init plugin: " .. manager.name) -end - ----@param info BuildInfo -manager.build.on_start = function (info) - -- before the build work start, system will execute this function. - log.info("[plugin] Build starting: " .. info.name) -end - ----@param info BuildInfo -manager.build.on_finish = function (info) - -- when the build work is done, system will execute this function. - log.info("[plugin] Build finished: " .. info.name) -end - ----@param info ServeStartInfo -manager.serve.on_start = function (info) - -- this function will after clean & print to run, so you can print some thing. - log.info("[plugin] Serve start: " .. info.name) -end - ----@param info ServeRebuildInfo -manager.serve.on_rebuild = function (info) - -- this function will after clean & print to run, so you can print some thing. - local files = plugin.tool.dump(info.changed_files) - log.info("[plugin] Serve rebuild: '" .. files .. "'") -end - -manager.serve.on_shutdown = function () - log.info("[plugin] Serve shutdown") -end - -manager.serve.interval = 1000 - -return manager -``` diff --git a/packages/cli/docs/src/plugin/interface/command.md b/packages/cli/docs/src/plugin/interface/command.md deleted file mode 100644 index 2882e5153..000000000 --- a/packages/cli/docs/src/plugin/interface/command.md +++ /dev/null @@ -1,21 +0,0 @@ -# Command Functions - -You can use command functions to execute code and scripts. - -Type definition: -``` -Stdio: "Inherit" | "Piped" | "Null" -``` - -### `exec(commands: [string], stdout: Stdio, stderr: Stdio)` - -You can use this function to run some commands on the current system. - -```lua -local cmd = plugin.command - -manager.test = function () - cmd.exec({"git", "clone", "https://github.com/DioxusLabs/cli-plugin-library"}) -end -``` -> Warning: This function doesn't catch exceptions. \ No newline at end of file diff --git a/packages/cli/docs/src/plugin/interface/dirs.md b/packages/cli/docs/src/plugin/interface/dirs.md deleted file mode 100644 index 9984802ff..000000000 --- a/packages/cli/docs/src/plugin/interface/dirs.md +++ /dev/null @@ -1,30 +0,0 @@ -# Dirs Functions - -Dirs functions are for getting various directory paths. Not to be confused with `plugin.path`. - -### `plugin_dir() -> string` - -Get the plugin's root directory path. - -```lua -local path = plugin.dirs.plugin_dir() --- example: ~/Development/DioxusCli/plugin/test-plugin/ -``` - -### `bin_dir() -> string` - -Get the plugin's binary directory path. Put binary files like `tailwind-cli` or `sass-cli` in this directory. - -```lua -local path = plugin.dirs.bin_dir() --- example: ~/Development/DioxusCli/plugin/test-plugin/bin/ -``` - -### `temp_dir() -> string` - -Get the plugin's temporary directory path. Put any temporary files here. - -```lua -local path = plugin.dirs.bin_dir() --- example: ~/Development/DioxusCli/plugin/test-plugin/temp/ -``` \ No newline at end of file diff --git a/packages/cli/docs/src/plugin/interface/log.md b/packages/cli/docs/src/plugin/interface/log.md deleted file mode 100644 index ee437b77a..000000000 --- a/packages/cli/docs/src/plugin/interface/log.md +++ /dev/null @@ -1,48 +0,0 @@ -# Log Functions - -You can use log functions to print various logging information. - -### `trace(info: string)` - -Print trace log info. - -```lua -local log = plugin.log -log.trace("trace information") -``` - -### `debug(info: string)` - -Print debug log info. - -```lua -local log = plugin.log -log.debug("debug information") -``` - -### `info(info: string)` - -Print info log info. - -```lua -local log = plugin.log -log.info("info information") -``` - -### `warn(info: string)` - -Print warning log info. - -```lua -local log = plugin.log -log.warn("warn information") -``` - -### `error(info: string)` - -Print error log info. - -```lua -local log = plugin.log -log.error("error information") -``` \ No newline at end of file diff --git a/packages/cli/docs/src/plugin/interface/network.md b/packages/cli/docs/src/plugin/interface/network.md deleted file mode 100644 index 566bc5073..000000000 --- a/packages/cli/docs/src/plugin/interface/network.md +++ /dev/null @@ -1,37 +0,0 @@ -# Network Functions - -You can use Network functions to download & read some data from the internet. - -### `download_file(url: string, path: string) -> boolean` - -Downloads a file from the specified URL, -and returns a `boolean` that represents the download status (true: success, false: failure). - -You need to pass a target URL and a local path (where you want to save this file). - -```lua --- this file will download to plugin temp directory -local status = plugin.network.download_file( - "http://xxx.com/xxx.zip", - plugin.dirs.temp_dir() -) -if status != true then - log.error("Download Failed") -end -``` - -### `clone_repo(url: string, path: string) -> boolean` - -Clone a repository from the given URL into the given path. -Returns a `boolean` that represents the clone status (true: success, false: failure). -The system executing this function must have git installed. - -```lua -local status = plugin.network.clone_repo( - "http://github.com/mrxiaozhuox/dioxus-starter", - plugin.dirs.bin_dir() -) -if status != true then - log.error("Clone Failed") -end -``` \ No newline at end of file diff --git a/packages/cli/docs/src/plugin/interface/os.md b/packages/cli/docs/src/plugin/interface/os.md deleted file mode 100644 index 84f4697b8..000000000 --- a/packages/cli/docs/src/plugin/interface/os.md +++ /dev/null @@ -1,11 +0,0 @@ -# OS Functions - -OS functions are for getting system information. - -### `current_platform() -> string ("windows" | "macos" | "linux")` - -Get the current OS platform. - -```lua -local platform = plugin.os.current_platform() -``` \ No newline at end of file diff --git a/packages/cli/docs/src/plugin/interface/path.md b/packages/cli/docs/src/plugin/interface/path.md deleted file mode 100644 index a5bee1eb9..000000000 --- a/packages/cli/docs/src/plugin/interface/path.md +++ /dev/null @@ -1,38 +0,0 @@ -# Path Functions - -You can use path functions to perform operations on valid path strings. - -### `join(path: string, extra: string) -> string` - - -Extend a path; you can extend both directory and file paths. - -```lua -local current_path = "~/hello/dioxus" -local new_path = plugin.path.join(current_path, "world") --- new_path = "~/hello/dioxus/world" -``` - -### `parent(path: string) -> string` - -Return the parent path of the specified path. The parent path is always a directory. - -```lua -local current_path = "~/hello/dioxus" -local new_path = plugin.path.parent(current_path) --- new_path = "~/hello/" -``` - -### `exists(path: string) -> boolean` - -Check if the specified path exists, as either a file or a directory. - -### `is_file(path: string) -> boolean` - -Check if the specified path is a file. - -### `is_dir(path: string) -> boolean` - -Check if the specified path is a directory. \ No newline at end of file diff --git a/packages/cli/examples/plugin/init.lua b/packages/cli/examples/plugin/init.lua deleted file mode 100644 index 7d6b710ef..000000000 --- a/packages/cli/examples/plugin/init.lua +++ /dev/null @@ -1,18 +0,0 @@ -local Api = require("./interface") -local log = Api.log; - -local manager = { - name = "Dioxus-CLI Plugin Demo", - repository = "http://github.com/DioxusLabs/cli", - author = "YuKun Liu ", -} - -manager.onLoad = function () - log.info("plugin loaded.") -end - -manager.onStartBuild = function () - log.warn("system start to build") -end - -return manager \ No newline at end of file diff --git a/packages/cli/examples/plugin/interface.lua b/packages/cli/examples/plugin/interface.lua deleted file mode 100644 index bc6c91cb1..000000000 --- a/packages/cli/examples/plugin/interface.lua +++ /dev/null @@ -1,25 +0,0 @@ -local interface = {} - -if plugin_logger ~= nil then - interface.log = plugin_logger -else - interface.log = { - trace = function (info) - print("trace: " .. info) - end, - debug = function (info) - print("debug: " .. info) - end, - info = function (info) - print("info: " .. info) - end, - warn = function (info) - print("warn: " .. info) - end, - error = function (info) - print("error: " .. info) - end, - } -end - -return interface \ No newline at end of file diff --git a/packages/cli/src/builder.rs b/packages/cli/src/builder.rs index c551d788a..135bf7962 100644 --- a/packages/cli/src/builder.rs +++ b/packages/cli/src/builder.rs @@ -719,7 +719,6 @@ fn build_assets(config: &CrateConfig) -> Result> { Ok(result) } - /// Process any assets collected from the binary fn process_assets(config: &CrateConfig) -> anyhow::Result<()> { let manifest = config.asset_manifest(); @@ -740,38 +739,6 @@ fn process_assets(config: &CrateConfig) -> anyhow::Result<()> { Ok(()) } -// use binary_install::{Cache, Download}; - -// /// Attempts to find `wasm-opt` in `PATH` locally, or failing that downloads a -// /// precompiled binary. -// /// -// /// Returns `Some` if a binary was found or it was successfully downloaded. -// /// Returns `None` if a binary wasn't found in `PATH` and this platform doesn't -// /// have precompiled binaries. Returns an error if we failed to download the -// /// binary. -// pub fn find_wasm_opt( -// cache: &Cache, -// install_permitted: bool, -// ) -> Result { -// // First attempt to look up in PATH. If found assume it works. -// if let Ok(path) = which::which("wasm-opt") { -// PBAR.info(&format!("found wasm-opt at {:?}", path)); - -// match path.as_path().parent() { -// Some(path) => return Ok(install::Status::Found(Download::at(path))), -// None => {} -// } -// } - -// let version = "version_78"; -// Ok(install::download_prebuilt( -// &install::Tool::WasmOpt, -// cache, -// version, -// install_permitted, -// )?) -// } - pub(crate) struct WebAssetConfigDropGuard; impl WebAssetConfigDropGuard { diff --git a/packages/cli/src/cli/autoformat.rs b/packages/cli/src/cli/autoformat.rs index f436ab4c4..1d1cbcd24 100644 --- a/packages/cli/src/cli/autoformat.rs +++ b/packages/cli/src/cli/autoformat.rs @@ -46,18 +46,28 @@ impl Autoformat { // Format single file if let Some(file) = self.file { - let file_content = fs::read_to_string(&file); + let file_content = if file == "-" { + let mut contents = String::new(); + std::io::stdin().read_to_string(&mut contents)?; + Ok(contents) + } else { + fs::read_to_string(&file) + }; match file_content { Ok(s) => { let edits = dioxus_autofmt::fmt_file(&s); let out = dioxus_autofmt::apply_formats(&s, edits); - match fs::write(&file, out) { - Ok(_) => { - println!("formatted {}", file); - } - Err(e) => { - eprintln!("failed to write formatted content to file: {}", e); + if file == "-" { + print!("{}", out); + } else { + match fs::write(&file, out) { + Ok(_) => { + println!("formatted {}", file); + } + Err(e) => { + eprintln!("failed to write formatted content to file: {}", e); + } } } } diff --git a/packages/cli/src/server/desktop/mod.rs b/packages/cli/src/server/desktop/mod.rs index c45dc8b5f..8922489b5 100644 --- a/packages/cli/src/server/desktop/mod.rs +++ b/packages/cli/src/server/desktop/mod.rs @@ -118,27 +118,34 @@ async fn start_desktop_hot_reload(hot_reload_state: HotReloadState) -> Result<() let _ = local_socket_stream.set_nonblocking(true); move || { loop { - if let Ok(mut connection) = local_socket_stream.accept() { - // send any templates than have changed before the socket connected - let templates: Vec<_> = { - file_map - .lock() - .unwrap() - .map - .values() - .filter_map(|(_, template_slot)| *template_slot) - .collect() - }; - for template in templates { - if !send_msg( - HotReloadMsg::UpdateTemplate(template), - &mut connection, - ) { - continue; + match local_socket_stream.accept() { + Ok(mut connection) => { + // send any templates than have changed before the socket connected + let templates: Vec<_> = { + file_map + .lock() + .unwrap() + .map + .values() + .filter_map(|(_, template_slot)| *template_slot) + .collect() + }; + for template in templates { + if !send_msg( + HotReloadMsg::UpdateTemplate(template), + &mut connection, + ) { + continue; + } + } + channels.lock().unwrap().push(connection); + println!("Connected to hot reloading πŸš€"); + } + Err(err) => { + if err.kind() != std::io::ErrorKind::WouldBlock { + println!("Error connecting to hot reloading: {} (Hot reloading is a feature of the dioxus-cli. If you are not using the CLI, this error can be ignored)", err); } } - channels.lock().unwrap().push(connection); - println!("Connected to hot reloading πŸš€"); } if *aborted.lock().unwrap() { break; diff --git a/packages/cli/src/server/output.rs b/packages/cli/src/server/output.rs index ce0f55064..71323dd29 100644 --- a/packages/cli/src/server/output.rs +++ b/packages/cli/src/server/output.rs @@ -129,7 +129,7 @@ pub fn print_console_info( log::warn!( "{}", format!( - "There were {} warning messages during the build.", + "There were {} warning messages during the build. Run `cargo check` to see them.", options.warnings.len() - 1 ) .yellow() diff --git a/packages/core-macro/README.md b/packages/core-macro/README.md index 31b0cca90..497c7c587 100644 --- a/packages/core-macro/README.md +++ b/packages/core-macro/README.md @@ -23,9 +23,12 @@ `dioxus-core-macro` provides a handful of helpful macros used by the `dioxus` crate. These include: -- The `rsx!` macro that underpins templates and node creation -- The `inline_props` macro transforms function arguments into an auto-derived struct -- The `format_args_f` macro which allows f-string formatting with support for expressions +- The `rsx!` macro that underpins templates and node creation. +- The `component` attribute macro denotes a function as a Dioxus component. Currently, this: + - Transforms function arguments into an auto-derived struct. + - Ensures that your component name uses PascalCase. + - Probably more stuff in the future. This macro allows us to have a way of distinguishing functions and components, which can be quite handy. +- The `format_args_f` macro which allows f-string formatting with support for expressions. ## Contributing diff --git a/packages/core/src/scope_context.rs b/packages/core/src/scope_context.rs index 79ed05d75..59bed3b1f 100644 --- a/packages/core/src/scope_context.rs +++ b/packages/core/src/scope_context.rs @@ -128,7 +128,7 @@ impl ScopeContext { parent.name ); if let Some(shared) = parent.shared_contexts.borrow().iter().find_map(|any| { - tracing::trace!("found context {:?}", any.type_id()); + tracing::trace!("found context {:?}", (**any).type_id()); any.downcast_ref::() }) { return Some(shared.clone()); diff --git a/packages/core/tests/suspense.rs b/packages/core/tests/suspense.rs index 7b2516447..abce7f8a6 100644 --- a/packages/core/tests/suspense.rs +++ b/packages/core/tests/suspense.rs @@ -36,7 +36,7 @@ fn suspended_child(cx: Scope) -> Element { cx.spawn(async move { val += 1; }); - return cx.suspend()?; + cx.suspend()?; } render!("child") diff --git a/packages/dioxus-tui/Cargo.toml b/packages/dioxus-tui/Cargo.toml index 0d0bb59f4..47ff3f536 100644 --- a/packages/dioxus-tui/Cargo.toml +++ b/packages/dioxus-tui/Cargo.toml @@ -10,7 +10,6 @@ keywords = ["dom", "ui", "gui", "react", "terminal"] license = "MIT OR Apache-2.0" [dependencies] -dioxus = { workspace = true } dioxus-core = { workspace = true, features = ["serialize"] } dioxus-html = { workspace = true } dioxus-native-core = { workspace = true, features = ["dioxus"] } diff --git a/packages/hooks/src/lib.rs b/packages/hooks/src/lib.rs index 6d7ab6f53..ec2889e55 100644 --- a/packages/hooks/src/lib.rs +++ b/packages/hooks/src/lib.rs @@ -1,7 +1,7 @@ #![cfg_attr(feature = "nightly-features", feature(debug_refcell))] #[macro_export] -/// A helper macro for using hooks and properties in async environements. +/// A helper macro for using hooks and properties in async environments. /// /// # Usage /// @@ -54,35 +54,37 @@ macro_rules! to_owned { pub mod computed; -mod use_on_unmount; -pub use use_on_unmount::*; +mod use_on_destroy; +pub use use_on_destroy::*; -mod usecontext; -pub use usecontext::*; +mod use_context; +pub use use_context::*; -mod usestate; -pub use usestate::{use_state, UseState}; +mod use_state; +pub use use_state::{use_state, UseState}; -mod useref; -pub use useref::*; +mod use_ref; +pub use use_ref::*; mod use_shared_state; pub use use_shared_state::*; -mod usecoroutine; -pub use usecoroutine::*; +mod use_coroutine; +pub use use_coroutine::*; -mod usefuture; -pub use usefuture::*; +mod use_future; +pub use use_future::*; -mod useeffect; -pub use useeffect::*; +mod use_effect; +pub use use_effect::*; -mod usecallback; -pub use usecallback::*; +mod use_callback; +pub use use_callback::*; -mod usememo; -pub use usememo::*; +mod use_memo; +pub use use_memo::*; -mod userootcontext; -pub use userootcontext::*; +mod use_on_create; +pub use use_on_create::*; +mod use_root_context; +pub use use_root_context::*; diff --git a/packages/hooks/src/usecallback.rs b/packages/hooks/src/use_callback.rs similarity index 100% rename from packages/hooks/src/usecallback.rs rename to packages/hooks/src/use_callback.rs diff --git a/packages/hooks/src/usecollection.rs b/packages/hooks/src/use_collection.rs similarity index 100% rename from packages/hooks/src/usecollection.rs rename to packages/hooks/src/use_collection.rs diff --git a/packages/hooks/src/usecontext.rs b/packages/hooks/src/use_context.rs similarity index 100% rename from packages/hooks/src/usecontext.rs rename to packages/hooks/src/use_context.rs diff --git a/packages/hooks/src/usecoroutine.rs b/packages/hooks/src/use_coroutine.rs similarity index 100% rename from packages/hooks/src/usecoroutine.rs rename to packages/hooks/src/use_coroutine.rs diff --git a/packages/hooks/src/useeffect.rs b/packages/hooks/src/use_effect.rs similarity index 87% rename from packages/hooks/src/useeffect.rs rename to packages/hooks/src/use_effect.rs index 76a3f5245..e72afe27f 100644 --- a/packages/hooks/src/useeffect.rs +++ b/packages/hooks/src/use_effect.rs @@ -3,13 +3,18 @@ use std::{any::Any, cell::Cell, future::Future}; use crate::UseFutureDep; -/// A hook that provides a future that executes after the hooks have been applied +/// A hook that provides a future that executes after the hooks have been applied. /// /// Whenever the hooks dependencies change, the future will be re-evaluated. /// If a future is pending when the dependencies change, the previous future -/// will be allowed to continue +/// will be allowed to continue. /// -/// - dependencies: a tuple of references to values that are `PartialEq` + `Clone` +/// **Note:** If your dependency list is always empty, use [`use_on_create`](crate::use_on_create). +/// +/// ## Arguments +/// +/// - `dependencies`: a tuple of references to values that are `PartialEq` + `Clone`. +/// - `future`: a closure that takes the `dependencies` as arguments and returns a `'static` future. /// /// ## Examples /// diff --git a/packages/hooks/src/usefuture.rs b/packages/hooks/src/use_future.rs similarity index 100% rename from packages/hooks/src/usefuture.rs rename to packages/hooks/src/use_future.rs diff --git a/packages/hooks/src/usememo.rs b/packages/hooks/src/use_memo.rs similarity index 100% rename from packages/hooks/src/usememo.rs rename to packages/hooks/src/use_memo.rs diff --git a/packages/hooks/src/usemodel.rs b/packages/hooks/src/use_model.rs similarity index 100% rename from packages/hooks/src/usemodel.rs rename to packages/hooks/src/use_model.rs diff --git a/packages/hooks/src/use_on_create.rs b/packages/hooks/src/use_on_create.rs new file mode 100644 index 000000000..28f7bcd6f --- /dev/null +++ b/packages/hooks/src/use_on_create.rs @@ -0,0 +1,27 @@ +use dioxus_core::ScopeState; +use std::cell::Cell; +use std::future::Future; + +/// A hook that runs a future when the component is mounted. +/// +/// This is just [`use_effect`](crate::use_effect), but with no dependencies. +/// If you have no dependencies, it's recommended to use this, not just because it's more readable, +/// but also because it's a tiny bit more efficient. +pub fn use_on_create(cx: &ScopeState, future: impl FnOnce() -> F) +where + T: 'static, + F: Future + 'static, +{ + let needs_regen = cx.use_hook(|| Cell::new(true)); + + if needs_regen.get() { + // We don't need regen anymore + needs_regen.set(false); + + let fut = future(); + + cx.push_future(async move { + fut.await; + }); + } +} diff --git a/packages/hooks/src/use_on_unmount.rs b/packages/hooks/src/use_on_destroy.rs similarity index 76% rename from packages/hooks/src/use_on_unmount.rs rename to packages/hooks/src/use_on_destroy.rs index 1309ca122..8b09b6a20 100644 --- a/packages/hooks/src/use_on_unmount.rs +++ b/packages/hooks/src/use_on_destroy.rs @@ -1,9 +1,20 @@ -/// Creates a callback that will be run before the component is removed. This can be used to clean up side effects from the component (created with use_effect) +#[deprecated( + note = "Use `use_on_destroy` instead, which has the same functionality. \ +This is deprecated because of the introduction of `use_on_create` which is better mirrored by `use_on_destroy`. \ +The reason why `use_on_create` is not `use_on_mount` is because of potential confusion with `dioxus::events::onmounted`." +)] +pub fn use_on_unmount(cx: &dioxus_core::ScopeState, destroy: D) { + use_on_destroy(cx, destroy); +} + +/// Creates a callback that will be run before the component is removed. +/// This can be used to clean up side effects from the component +/// (created with [`use_effect`](crate::use_effect)). /// /// Example: /// ```rust /// use dioxus::prelude::*; - +/// /// fn app(cx: Scope) -> Element { /// let state = use_state(cx, || true); /// render! { @@ -25,7 +36,7 @@ /// } /// } /// } - +/// /// fn child_component(cx: Scope) -> Element { /// let original_scroll_position = use_state(cx, || 0.0); /// use_effect(cx, (), move |_| { @@ -38,8 +49,8 @@ /// original_scroll_position.set(window.scroll_y().unwrap()); /// } /// }); - -/// use_on_unmount(cx, { +/// +/// use_on_destroy(cx, { /// to_owned![original_scroll_position]; /// /// restore scroll to the top of the page /// move || { @@ -47,7 +58,7 @@ /// window.scroll_with_x_and_y(*original_scroll_position.current(), 0.0); /// } /// }); - +/// /// render!{ /// div { /// id: "my_element", @@ -56,7 +67,7 @@ /// } /// } /// ``` -pub fn use_on_unmount(cx: &dioxus_core::ScopeState, destroy: D) { +pub fn use_on_destroy(cx: &dioxus_core::ScopeState, destroy: D) { cx.use_hook(|| LifeCycle { ondestroy: Some(destroy), }); diff --git a/packages/hooks/src/useref.rs b/packages/hooks/src/use_ref.rs similarity index 100% rename from packages/hooks/src/useref.rs rename to packages/hooks/src/use_ref.rs diff --git a/packages/hooks/src/userootcontext.rs b/packages/hooks/src/use_root_context.rs similarity index 100% rename from packages/hooks/src/userootcontext.rs rename to packages/hooks/src/use_root_context.rs diff --git a/packages/cli/examples/README.md b/packages/hooks/src/use_signal.rs similarity index 100% rename from packages/cli/examples/README.md rename to packages/hooks/src/use_signal.rs diff --git a/packages/hooks/src/usestate.rs b/packages/hooks/src/use_state.rs similarity index 100% rename from packages/hooks/src/usestate.rs rename to packages/hooks/src/use_state.rs diff --git a/packages/hooks/src/usesignal.rs b/packages/hooks/src/usesignal.rs deleted file mode 100644 index e69de29bb..000000000 diff --git a/packages/html/src/elements.rs b/packages/html/src/elements.rs index 7800369a9..7004ac1b7 100644 --- a/packages/html/src/elements.rs +++ b/packages/html/src/elements.rs @@ -1203,6 +1203,7 @@ builder_constructors! { value: String DEFAULT, selected: Bool volatile, + initial_selected: Bool DEFAULT, }; /// Build a diff --git a/packages/interpreter/src/common.js b/packages/interpreter/src/common.js index 1583da10e..0587d60d4 100644 --- a/packages/interpreter/src/common.js +++ b/packages/interpreter/src/common.js @@ -54,6 +54,9 @@ export function setAttributeInner(node, field, value, ns) { case "selected": node.selected = truthy(value); break; + case "initial_selected": + node.defaultSelected = truthy(value); + break; case "dangerous_inner_html": node.innerHTML = value; break; diff --git a/packages/interpreter/src/sledgehammer_bindings.rs b/packages/interpreter/src/sledgehammer_bindings.rs index 7d5f44f7d..23430688e 100644 --- a/packages/interpreter/src/sledgehammer_bindings.rs +++ b/packages/interpreter/src/sledgehammer_bindings.rs @@ -83,6 +83,9 @@ mod js { case "selected": node.selected = truthy(value); break; + case "initial_selected": + node.defaultSelected = truthy(value); + break; case "dangerous_inner_html": node.innerHTML = value; break; diff --git a/packages/liveview/examples/axum.rs b/packages/liveview/examples/axum.rs index 2e7f10ee7..6584d5e9b 100644 --- a/packages/liveview/examples/axum.rs +++ b/packages/liveview/examples/axum.rs @@ -19,32 +19,43 @@ async fn main() { let addr: std::net::SocketAddr = ([127, 0, 0, 1], 3030).into(); let view = dioxus_liveview::LiveViewPool::new(); + let index_page_with_glue = |glue: &str| { + Html(format!( + r#" + + + Dioxus LiveView with axum +
+ {glue} + + "#, + )) + }; - let app = Router::new() - .route( - "/", - get(move || async move { - Html(format!( - r#" - - - Dioxus LiveView with axum -
- {glue} - - "#, - glue = dioxus_liveview::interpreter_glue(&format!("ws://{addr}/ws")) - )) - }), - ) - .route( - "/ws", - get(move |ws: WebSocketUpgrade| async move { - ws.on_upgrade(move |socket| async move { - _ = view.launch(dioxus_liveview::axum_socket(socket), app).await; - }) - }), - ); + let app = + Router::new() + .route( + "/", + get(move || async move { + index_page_with_glue(&dioxus_liveview::interpreter_glue(&format!( + "ws://{addr}/ws" + ))) + }), + ) + .route( + "/as-path", + get(move || async move { + index_page_with_glue(&dioxus_liveview::interpreter_glue("/ws")) + }), + ) + .route( + "/ws", + get(move |ws: WebSocketUpgrade| async move { + ws.on_upgrade(move |socket| async move { + _ = view.launch(dioxus_liveview::axum_socket(socket), app).await; + }) + }), + ); println!("Listening on http://{addr}"); diff --git a/packages/liveview/src/lib.rs b/packages/liveview/src/lib.rs index 92cce63e6..a7370e91c 100644 --- a/packages/liveview/src/lib.rs +++ b/packages/liveview/src/lib.rs @@ -93,14 +93,49 @@ static MAIN_JS: &str = include_str!("./main.js"); /// This script that gets injected into your app connects this page to the websocket endpoint /// /// Once the endpoint is connected, it will send the initial state of the app, and then start -/// processing user events and returning edits to the liveview instance -pub fn interpreter_glue(url: &str) -> String { +/// processing user events and returning edits to the liveview instance. +/// +/// You can pass a relative path prefixed with "/", or enter a full URL including the protocol +/// (`ws:` or `wss:`) as an argument. +/// +/// If you enter a relative path, the web client automatically prefixes the host address in +/// `window.location` when creating a web socket to LiveView. +/// +/// ``` +/// // Creates websocket connection to same host as current page +/// interpreter_glue("/api/liveview"); +/// +/// // Creates websocket connection to specified url +/// interpreter_glue("ws://localhost:8080/api/liveview"); +/// ``` +pub fn interpreter_glue(url_or_path: &str) -> String { + // If the url starts with a `/`, generate glue which reuses current host + let get_ws_url = if url_or_path.starts_with('/') { + r#" + let loc = window.location; + let new_url = ""; + if (loc.protocol === "https:") {{ + new_url = "wss:"; + }} else {{ + new_url = "ws:"; + }} + new_url += "//" + loc.host + path; + return new_url; + "# + } else { + "return path;" + }; + let js = &*INTERPRETER_JS; let common = &*COMMON_JS; format!( r#" "# @@ -87,6 +77,7 @@ pub(super) fn desktop_handler( match Response::builder() .header("Content-Type", "text/html") + .header("Access-Control-Allow-Origin", "*") .body(Cow::from(body)) { Ok(response) => { @@ -95,18 +86,7 @@ pub(super) fn desktop_handler( } Err(err) => tracing::error!("error building response: {}", err), } - } else if request.uri().path() == "/common.js" { - match Response::builder() - .header("Content-Type", "text/javascript") - .body(Cow::from(COMMON_JS.as_bytes())) - { - Ok(response) => { - responder.respond(response); - return; - } - Err(err) => tracing::error!("error building response: {}", err), - } - } else if request.uri().path() == "/edits" { + } else if request.uri().path().trim_matches('/') == "edits" { edit_queue.handle_request(responder); return; } diff --git a/packages/desktop/src/webview.rs b/packages/desktop/src/webview.rs index 0b253b497..44b5a3bf0 100644 --- a/packages/desktop/src/webview.rs +++ b/packages/desktop/src/webview.rs @@ -1,8 +1,6 @@ use crate::desktop_context::{EditQueue, EventData}; use crate::protocol; use crate::{desktop_context::UserWindowEvent, Config}; -use std::sync::Arc; -use std::sync::Mutex; use tao::event_loop::{EventLoopProxy, EventLoopWindowTarget}; pub use wry; pub use wry::application as tao; diff --git a/packages/fullstack/src/adapters/warp_adapter.rs b/packages/fullstack/src/adapters/warp_adapter.rs index 5afcb5077..316d70e56 100644 --- a/packages/fullstack/src/adapters/warp_adapter.rs +++ b/packages/fullstack/src/adapters/warp_adapter.rs @@ -143,7 +143,7 @@ pub fn register_server_fns(server_fn_route: &'static str) -> BoxedFilter<(impl R let req = warp::hyper::Request::from_parts(parts, bytes.into()); service.run(req).await.map_err(|err| { tracing::error!("Server function error: {}", err); - + struct WarpServerFnError(String); impl std::fmt::Debug for WarpServerFnError { fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { @@ -152,7 +152,7 @@ pub fn register_server_fns(server_fn_route: &'static str) -> BoxedFilter<(impl R } impl warp::reject::Reject for WarpServerFnError {} - + warp::reject::custom(WarpServerFnError(err.to_string())) }) } diff --git a/packages/liveview/build.rs b/packages/liveview/build.rs index 87e168590..fc38e29c4 100644 --- a/packages/liveview/build.rs +++ b/packages/liveview/build.rs @@ -1,6 +1,6 @@ -use dioxus_interpreter_js::COMMON_JS; use dioxus_interpreter_js::SLEDGEHAMMER_JS; use minify_js::*; +use std::io::Write; fn main() { let serialize_file_uploads = r#"if ( @@ -53,11 +53,11 @@ fn main() { let main_js = std::fs::read_to_string("src/main.js").unwrap(); let js = format!("{interpreter}\n{main_js}"); - // std::fs::write("src/minified.js", &js).unwrap(); let session = Session::new(); let mut out = Vec::new(); minify(&session, TopLevelMode::Module, js.as_bytes(), &mut out).unwrap(); let minified = String::from_utf8(out).unwrap(); - std::fs::write("src/minified.js", minified).unwrap(); + let mut file = std::fs::File::create("src/minified.js").unwrap(); + file.write_all(minified.as_bytes()).unwrap(); } From c8078082318604621746bd43294127b49691861d Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Tue, 17 Oct 2023 14:32:31 -0500 Subject: [PATCH 181/447] remove logging --- packages/desktop/src/desktop_context.rs | 3 --- 1 file changed, 3 deletions(-) diff --git a/packages/desktop/src/desktop_context.rs b/packages/desktop/src/desktop_context.rs index cc55134d9..1b253eafc 100644 --- a/packages/desktop/src/desktop_context.rs +++ b/packages/desktop/src/desktop_context.rs @@ -59,7 +59,6 @@ impl Debug for EditQueue { impl EditQueue { pub fn handle_request(&self, responder: wry::webview::RequestAsyncResponder) { - println!("handling request {self:?}"); let mut queue = self.queue.lock().unwrap(); if let Some(bytes) = queue.pop() { responder.respond(wry::http::Response::new(bytes)); @@ -69,10 +68,8 @@ impl EditQueue { } pub fn add_edits(&self, edits: Vec) { - println!("adding edits {self:?}"); let mut responder = self.responder.lock().unwrap(); if let Some(responder) = responder.take() { - println!("responding with {edits:?}"); responder.respond(wry::http::Response::new(edits)); } else { self.queue.lock().unwrap().push(edits); From a4fbeeb9326e28b1e47556f611780f8f8b53c422 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Tue, 17 Oct 2023 14:45:37 -0500 Subject: [PATCH 182/447] add stress test for desktop --- packages/desktop/examples/stress.rs | 32 ++++++++++++++++ packages/desktop/src/minified.js | 58 ++++++++++++++--------------- 2 files changed, 61 insertions(+), 29 deletions(-) create mode 100644 packages/desktop/examples/stress.rs diff --git a/packages/desktop/examples/stress.rs b/packages/desktop/examples/stress.rs new file mode 100644 index 000000000..5f317bc99 --- /dev/null +++ b/packages/desktop/examples/stress.rs @@ -0,0 +1,32 @@ +use dioxus::prelude::*; + +fn app(cx: Scope) -> Element { + let state = use_state(cx, || 0); + use_future(cx, (), |_| { + to_owned![state]; + async move { + loop { + state += 1; + tokio::time::sleep(std::time::Duration::from_millis(1)).await; + } + } + }); + + cx.render(rsx! { + button { + onclick: move |_| { + state.set(0); + }, + "reset" + } + for _ in 0..10000 { + div { + "hello desktop! {state}" + } + } + }) +} + +fn main() { + dioxus_desktop::launch(app); +} diff --git a/packages/desktop/src/minified.js b/packages/desktop/src/minified.js index b1ef5e4d1..4083b6411 100644 --- a/packages/desktop/src/minified.js +++ b/packages/desktop/src/minified.js @@ -853,7 +853,19 @@ function event_bubbles(event) { return true; } -let u8buf,u8bufp;let s = "";let lsp,sp,sl; let c = new TextDecoder();let u32buf,u32bufp;const attr = []; +let u32buf,u32bufp;let u8buf,u8bufp;let s = "";let lsp,sp,sl; let c = new TextDecoder();const ns_cache = []; + let ns_cache_cache_hit, ns_cache_cache_idx; + function get_ns_cache() { + ns_cache_cache_idx = u8buf[u8bufp++]; + if(ns_cache_cache_idx & 128){ + ns_cache_cache_hit=s.substring(sp,sp+=u8buf[u8bufp++]); + ns_cache[ns_cache_cache_idx&4294967167]=ns_cache_cache_hit; + return ns_cache_cache_hit; + } + else{ + return ns_cache[ns_cache_cache_idx&4294967167]; + } + }const attr = []; let attr_cache_hit, attr_cache_idx; function get_attr() { attr_cache_idx = u8buf[u8bufp++]; @@ -877,17 +889,17 @@ let u8buf,u8bufp;let s = "";let lsp,sp,sl; let c = new TextDecoder();let u32buf, else{ return evt[evt_cache_idx&4294967167]; } - }const ns_cache = []; - let ns_cache_cache_hit, ns_cache_cache_idx; - function get_ns_cache() { - ns_cache_cache_idx = u8buf[u8bufp++]; - if(ns_cache_cache_idx & 128){ - ns_cache_cache_hit=s.substring(sp,sp+=u8buf[u8bufp++]); - ns_cache[ns_cache_cache_idx&4294967167]=ns_cache_cache_hit; - return ns_cache_cache_hit; + }const namespace = []; + let namespace_cache_hit, namespace_cache_idx; + function get_namespace() { + namespace_cache_idx = u8buf[u8bufp++]; + if(namespace_cache_idx & 128){ + namespace_cache_hit=s.substring(sp,sp+=u8buf[u8bufp++]); + namespace[namespace_cache_idx&4294967167]=namespace_cache_hit; + return namespace_cache_hit; } else{ - return ns_cache[ns_cache_cache_idx&4294967167]; + return namespace[namespace_cache_idx&4294967167]; } }const el = []; let el_cache_hit, el_cache_idx; @@ -901,20 +913,8 @@ let u8buf,u8bufp;let s = "";let lsp,sp,sl; let c = new TextDecoder();let u32buf, else{ return el[el_cache_idx&4294967167]; } - }const namespace = []; - let namespace_cache_hit, namespace_cache_idx; - function get_namespace() { - namespace_cache_idx = u8buf[u8bufp++]; - if(namespace_cache_idx & 128){ - namespace_cache_hit=s.substring(sp,sp+=u8buf[u8bufp++]); - namespace[namespace_cache_idx&4294967167]=namespace_cache_hit; - return namespace_cache_hit; - } - else{ - return namespace[namespace_cache_idx&4294967167]; - } }let u16buf,u16bufp; - let value,event_name,array,ns,many,bubbles,id,field; + let bubbles,field,value,array,event_name,many,id,ns; function create(r){ d=r; } @@ -927,7 +927,11 @@ let u8buf,u8bufp;let s = "";let lsp,sp,sl; let c = new TextDecoder();let u32buf, ls=m.getUint32(d+6*4,true); } p=ls; - if ((metaflags>>>5)&1){ + if ((metaflags>>>3)&1){ + t = m.getUint32(d+3*4,true); + u32buf=new Uint32Array(m.buffer,t,((m.buffer.byteLength-t)-(m.buffer.byteLength-t)%4)/4); + } + u32bufp=0;if ((metaflags>>>5)&1){ t = m.getUint32(d+5*4,true); u8buf=new Uint8Array(m.buffer,t,((m.buffer.byteLength-t)-(m.buffer.byteLength-t)%1)/1); } @@ -957,11 +961,7 @@ let u8buf,u8bufp;let s = "";let lsp,sp,sl; let c = new TextDecoder();let u32buf, s = c.decode(new DataView(m.buffer, lsp, sl)); } } - sp=0;if ((metaflags>>>3)&1){ - t = m.getUint32(d+3*4,true); - u32buf=new Uint32Array(m.buffer,t,((m.buffer.byteLength-t)-(m.buffer.byteLength-t)%4)/4); - } - u32bufp=0;if ((metaflags>>>4)&1){ + sp=0;if ((metaflags>>>4)&1){ t = m.getUint32(d+4*4,true); u16buf=new Uint16Array(m.buffer,t,((m.buffer.byteLength-t)-(m.buffer.byteLength-t)%2)/2); } From 06ca8c53d8708182a1907ad9b1925273419fd8d4 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Tue, 17 Oct 2023 14:47:11 -0500 Subject: [PATCH 183/447] gitignore minified.js --- packages/desktop/.gitignore | 1 + packages/desktop/src/minified.js | 1051 ------------------------------ 2 files changed, 1 insertion(+), 1051 deletions(-) create mode 100644 packages/desktop/.gitignore delete mode 100644 packages/desktop/src/minified.js diff --git a/packages/desktop/.gitignore b/packages/desktop/.gitignore new file mode 100644 index 000000000..1aec3a9f9 --- /dev/null +++ b/packages/desktop/.gitignore @@ -0,0 +1 @@ +/src/minified.js \ No newline at end of file diff --git a/packages/desktop/src/minified.js b/packages/desktop/src/minified.js deleted file mode 100644 index 4083b6411..000000000 --- a/packages/desktop/src/minified.js +++ /dev/null @@ -1,1051 +0,0 @@ -let m,p,ls,d,t,op,i,e,z,metaflags; - ; - -class InterpreterConfig { - constructor(intercept_link_redirects) { - this.intercept_link_redirects = intercept_link_redirects; - } -} - -// this handler is only provided on the desktop and liveview implementations since this -// method is not used by the web implementation -function handler(event, name, bubbles, config) { - let target = event.target; - if (target != null) { - let preventDefaultRequests = null; - // Some events can be triggered on text nodes, which don't have attributes - if (target instanceof Element) { - preventDefaultRequests = target.getAttribute(`dioxus-prevent-default`); - } - - if (event.type === "click") { - // todo call prevent default if it's the right type of event - if (config.intercept_link_redirects) { - let a_element = target.closest("a"); - if (a_element != null) { - event.preventDefault(); - - let elementShouldPreventDefault = - preventDefaultRequests && preventDefaultRequests.includes(`onclick`); - let aElementShouldPreventDefault = a_element.getAttribute( - `dioxus-prevent-default` - ); - let linkShouldPreventDefault = - aElementShouldPreventDefault && - aElementShouldPreventDefault.includes(`onclick`); - - if (!elementShouldPreventDefault && !linkShouldPreventDefault) { - const href = a_element.getAttribute("href"); - if (href !== "" && href !== null && href !== undefined) { - window.ipc.postMessage( - serializeIpcMessage("browser_open", { href }) - ); - } - } - } - } - - // also prevent buttons from submitting - if (target.tagName === "BUTTON" && event.type == "submit") { - event.preventDefault(); - } - } - - const realId = find_real_id(target); - - if ( - preventDefaultRequests && - preventDefaultRequests.includes(`on${event.type}`) - ) { - event.preventDefault(); - } - - if (event.type === "submit") { - event.preventDefault(); - } - - let contents = serialize_event(event); - - // TODO: this should be liveview only - if ( - target.tagName === "INPUT" && - (event.type === "change" || event.type === "input") - ) { - const type = target.getAttribute("type"); - if (type === "file") { - async function read_files() { - const files = target.files; - const file_contents = {}; - - for (let i = 0; i < files.length; i++) { - const file = files[i]; - - file_contents[file.name] = Array.from( - new Uint8Array(await file.arrayBuffer()) - ); - } - let file_engine = { - files: file_contents, - }; - contents.files = file_engine; - - if (realId === null) { - return; - } - const message = serializeIpcMessage("user_event", { - name: name, - element: parseInt(realId), - data: contents, - bubbles, - }); - window.ipc.postMessage(message); - } - read_files(); - return; - } - } - - if ( - target.tagName === "FORM" && - (event.type === "submit" || event.type === "input") - ) { - const formData = new FormData(target); - - for (let name of formData.keys()) { - let value = formData.getAll(name); - contents.values[name] = value; - } - } - - if ( - target.tagName === "SELECT" && - event.type === "input" - ) { - const selectData = target.options; - contents.values["options"] = []; - for (let i = 0; i < selectData.length; i++) { - let option = selectData[i]; - if (option.selected) { - contents.values["options"].push(option.value.toString()); - } - } - } - - if (realId === null) { - return; - } - window.ipc.postMessage( - serializeIpcMessage("user_event", { - name: name, - element: parseInt(realId), - data: contents, - bubbles, - }) - ); - } -} - -function find_real_id(target) { - let realId = null; - if (target instanceof Element) { - realId = target.getAttribute(`data-dioxus-id`); - } - // walk the tree to find the real element - while (realId == null) { - // we've reached the root we don't want to send an event - if (target.parentElement === null) { - return; - } - - target = target.parentElement; - if (target instanceof Element) { - realId = target.getAttribute(`data-dioxus-id`); - } - } - return realId; -} - -class ListenerMap { - constructor(root) { - // bubbling events can listen at the root element - this.global = {}; - // non bubbling events listen at the element the listener was created at - this.local = {}; - this.root = null; - } - - create(event_name, element, bubbles, handler) { - if (bubbles) { - if (this.global[event_name] === undefined) { - this.global[event_name] = {}; - this.global[event_name].active = 1; - this.root.addEventListener(event_name, handler); - } else { - this.global[event_name].active++; - } - } - else { - const id = element.getAttribute("data-dioxus-id"); - if (!this.local[id]) { - this.local[id] = {}; - } - element.addEventListener(event_name, handler); - } - } - - remove(element, event_name, bubbles) { - if (bubbles) { - this.global[event_name].active--; - if (this.global[event_name].active === 0) { - this.root.removeEventListener(event_name, this.global[event_name].callback); - delete this.global[event_name]; - } - } - else { - const id = element.getAttribute("data-dioxus-id"); - delete this.local[id][event_name]; - if (this.local[id].length === 0) { - delete this.local[id]; - } - element.removeEventListener(event_name, this.global[event_name].callback); - } - } - - removeAllNonBubbling(element) { - const id = element.getAttribute("data-dioxus-id"); - delete this.local[id]; - } -} -function SetAttributeInner(node, field, value, ns) { - const name = field; - if (ns === "style") { - // ????? why do we need to do this - if (node.style === undefined) { - node.style = {}; - } - node.style[name] = value; - } else if (ns !== null && ns !== undefined && ns !== "") { - node.setAttributeNS(ns, name, value); - } else { - switch (name) { - case "value": - if (value !== node.value) { - node.value = value; - } - break; - case "initial_value": - node.defaultValue = value; - break; - case "checked": - node.checked = truthy(value); - break; - case "selected": - node.selected = truthy(value); - break; - case "dangerous_inner_html": - node.innerHTML = value; - break; - default: - // https://github.com/facebook/react/blob/8b88ac2592c5f555f315f9440cbb665dd1e7457a/packages/react-dom/src/shared/DOMProperty.js#L352-L364 - if (!truthy(value) && bool_attrs.hasOwnProperty(name)) { - node.removeAttribute(name); - } else { - node.setAttribute(name, value); - } - } - } -} -function LoadChild(array) { - // iterate through each number and get that child - node = stack[stack.length - 1]; - - for (let i = 0; i < array.length; i++) { - end = array[i]; - for (node = node.firstChild; end > 0; end--) { - node = node.nextSibling; - } - } - return node; -} -const listeners = new ListenerMap(); -let nodes = []; -let stack = []; -let root; -const templates = {}; -let node, els, end, k; -function initialize(root) { - nodes = [root]; - stack = [root]; - listeners.root = root; -} -function AppendChildren(id, many) { - root = nodes[id]; - els = stack.splice(stack.length - many); - for (k = 0; k < many; k++) { - root.appendChild(els[k]); - } -} -const bool_attrs = { - allowfullscreen: true, - allowpaymentrequest: true, - async: true, - autofocus: true, - autoplay: true, - checked: true, - controls: true, - default: true, - defer: true, - disabled: true, - formnovalidate: true, - hidden: true, - ismap: true, - itemscope: true, - loop: true, - multiple: true, - muted: true, - nomodule: true, - novalidate: true, - open: true, - playsinline: true, - readonly: true, - required: true, - reversed: true, - selected: true, - truespeed: true, - webkitdirectory: true, -}; -function truthy(val) { - return val === "true" || val === true; -} - - -function getClientRect(id) { - const node = nodes[id]; - if (!node) { - return; - } - const rect = node.getBoundingClientRect(); - return { - type: "GetClientRect", - origin: [rect.x, rect.y], - size: [rect.width, rect.height], - }; -} - -function scrollTo(id, behavior) { - const node = nodes[id]; - if (!node) { - return false; - } - node.scrollIntoView({ - behavior: behavior, - }); - return true; -} - -/// Set the focus on the element -function setFocus(id, focus) { - const node = nodes[id]; - if (!node) { - return false; - } - if (focus) { - node.focus(); - } else { - node.blur(); - } - return true; -} - -function saveTemplate(template) { - let roots = []; - for (let root of template.roots) { - roots.push(this.MakeTemplateNode(root)); - } - this.templates[template.name] = roots; -} - -function makeTemplateNode(node) { - switch (node.type) { - case "Text": - return document.createTextNode(node.text); - case "Dynamic": - let dyn = document.createElement("pre"); - dyn.hidden = true; - return dyn; - case "DynamicText": - return document.createTextNode("placeholder"); - case "Element": - let el; - - if (node.namespace != null) { - el = document.createElementNS(node.namespace, node.tag); - } else { - el = document.createElement(node.tag); - } - - for (let attr of node.attrs) { - if (attr.type == "Static") { - setAttributeInner(el, attr.name, attr.value, attr.namespace); - } - } - - for (let child of node.children) { - el.appendChild(this.MakeTemplateNode(child)); - } - - return el; - } -} - -function get_mouse_data(event) { - const { - altKey, - button, - buttons, - clientX, - clientY, - ctrlKey, - metaKey, - offsetX, - offsetY, - pageX, - pageY, - screenX, - screenY, - shiftKey, - } = event; - return { - alt_key: altKey, - button: button, - buttons: buttons, - client_x: clientX, - client_y: clientY, - ctrl_key: ctrlKey, - meta_key: metaKey, - offset_x: offsetX, - offset_y: offsetY, - page_x: pageX, - page_y: pageY, - screen_x: screenX, - screen_y: screenY, - shift_key: shiftKey, - }; -} - -function serialize_event(event) { - switch (event.type) { - case "copy": - case "cut": - case "past": { - return {}; - } - case "compositionend": - case "compositionstart": - case "compositionupdate": { - let { data } = event; - return { - data, - }; - } - case "keydown": - case "keypress": - case "keyup": { - let { - charCode, - key, - altKey, - ctrlKey, - metaKey, - keyCode, - shiftKey, - location, - repeat, - which, - code, - } = event; - return { - char_code: charCode, - key: key, - alt_key: altKey, - ctrl_key: ctrlKey, - meta_key: metaKey, - key_code: keyCode, - shift_key: shiftKey, - location: location, - repeat: repeat, - which: which, - code, - }; - } - case "focus": - case "blur": { - return {}; - } - case "change": { - let target = event.target; - let value; - if (target.type === "checkbox" || target.type === "radio") { - value = target.checked ? "true" : "false"; - } else { - value = target.value ?? target.textContent; - } - return { - value: value, - values: {}, - }; - } - case "input": - case "invalid": - case "reset": - case "submit": { - let target = event.target; - let value = target.value ?? target.textContent; - - if (target.type === "checkbox") { - value = target.checked ? "true" : "false"; - } - - return { - value: value, - values: {}, - }; - } - case "drag": - case "dragend": - case "dragenter": - case "dragexit": - case "dragleave": - case "dragover": - case "dragstart": - case "drop": { - return { mouse: get_mouse_data(event) }; - } - case "click": - case "contextmenu": - case "doubleclick": - case "dblclick": - case "mousedown": - case "mouseenter": - case "mouseleave": - case "mousemove": - case "mouseout": - case "mouseover": - case "mouseup": { - return get_mouse_data(event); - } - case "pointerdown": - case "pointermove": - case "pointerup": - case "pointercancel": - case "gotpointercapture": - case "lostpointercapture": - case "pointerenter": - case "pointerleave": - case "pointerover": - case "pointerout": { - const { - altKey, - button, - buttons, - clientX, - clientY, - ctrlKey, - metaKey, - pageX, - pageY, - screenX, - screenY, - shiftKey, - pointerId, - width, - height, - pressure, - tangentialPressure, - tiltX, - tiltY, - twist, - pointerType, - isPrimary, - } = event; - return { - alt_key: altKey, - button: button, - buttons: buttons, - client_x: clientX, - client_y: clientY, - ctrl_key: ctrlKey, - meta_key: metaKey, - page_x: pageX, - page_y: pageY, - screen_x: screenX, - screen_y: screenY, - shift_key: shiftKey, - pointer_id: pointerId, - width: width, - height: height, - pressure: pressure, - tangential_pressure: tangentialPressure, - tilt_x: tiltX, - tilt_y: tiltY, - twist: twist, - pointer_type: pointerType, - is_primary: isPrimary, - }; - } - case "select": { - return {}; - } - case "touchcancel": - case "touchend": - case "touchmove": - case "touchstart": { - const { altKey, ctrlKey, metaKey, shiftKey } = event; - return { - // changed_touches: event.changedTouches, - // target_touches: event.targetTouches, - // touches: event.touches, - alt_key: altKey, - ctrl_key: ctrlKey, - meta_key: metaKey, - shift_key: shiftKey, - }; - } - case "scroll": { - return {}; - } - case "wheel": { - const { deltaX, deltaY, deltaZ, deltaMode } = event; - return { - delta_x: deltaX, - delta_y: deltaY, - delta_z: deltaZ, - delta_mode: deltaMode, - }; - } - case "animationstart": - case "animationend": - case "animationiteration": { - const { animationName, elapsedTime, pseudoElement } = event; - return { - animation_name: animationName, - elapsed_time: elapsedTime, - pseudo_element: pseudoElement, - }; - } - case "transitionend": { - const { propertyName, elapsedTime, pseudoElement } = event; - return { - property_name: propertyName, - elapsed_time: elapsedTime, - pseudo_element: pseudoElement, - }; - } - case "abort": - case "canplay": - case "canplaythrough": - case "durationchange": - case "emptied": - case "encrypted": - case "ended": - case "error": - case "loadeddata": - case "loadedmetadata": - case "loadstart": - case "pause": - case "play": - case "playing": - case "progress": - case "ratechange": - case "seeked": - case "seeking": - case "stalled": - case "suspend": - case "timeupdate": - case "volumechange": - case "waiting": { - return {}; - } - case "toggle": { - return {}; - } - default: { - return {}; - } - } -} -function serializeIpcMessage(method, params = {}) { - return JSON.stringify({ method, params }); -} - -function is_element_node(node) { - return node.nodeType == 1; -} - -function event_bubbles(event) { - switch (event) { - case "copy": - return true; - case "cut": - return true; - case "paste": - return true; - case "compositionend": - return true; - case "compositionstart": - return true; - case "compositionupdate": - return true; - case "keydown": - return true; - case "keypress": - return true; - case "keyup": - return true; - case "focus": - return false; - case "focusout": - return true; - case "focusin": - return true; - case "blur": - return false; - case "change": - return true; - case "input": - return true; - case "invalid": - return true; - case "reset": - return true; - case "submit": - return true; - case "click": - return true; - case "contextmenu": - return true; - case "doubleclick": - return true; - case "dblclick": - return true; - case "drag": - return true; - case "dragend": - return true; - case "dragenter": - return false; - case "dragexit": - return false; - case "dragleave": - return true; - case "dragover": - return true; - case "dragstart": - return true; - case "drop": - return true; - case "mousedown": - return true; - case "mouseenter": - return false; - case "mouseleave": - return false; - case "mousemove": - return true; - case "mouseout": - return true; - case "scroll": - return false; - case "mouseover": - return true; - case "mouseup": - return true; - case "pointerdown": - return true; - case "pointermove": - return true; - case "pointerup": - return true; - case "pointercancel": - return true; - case "gotpointercapture": - return true; - case "lostpointercapture": - return true; - case "pointerenter": - return false; - case "pointerleave": - return false; - case "pointerover": - return true; - case "pointerout": - return true; - case "select": - return true; - case "touchcancel": - return true; - case "touchend": - return true; - case "touchmove": - return true; - case "touchstart": - return true; - case "wheel": - return true; - case "abort": - return false; - case "canplay": - return false; - case "canplaythrough": - return false; - case "durationchange": - return false; - case "emptied": - return false; - case "encrypted": - return true; - case "ended": - return false; - case "error": - return false; - case "loadeddata": - case "loadedmetadata": - case "loadstart": - case "load": - return false; - case "pause": - return false; - case "play": - return false; - case "playing": - return false; - case "progress": - return false; - case "ratechange": - return false; - case "seeked": - return false; - case "seeking": - return false; - case "stalled": - return false; - case "suspend": - return false; - case "timeupdate": - return false; - case "volumechange": - return false; - case "waiting": - return false; - case "animationstart": - return true; - case "animationend": - return true; - case "animationiteration": - return true; - case "transitionend": - return true; - case "toggle": - return true; - case "mounted": - return false; - } - - return true; -} -let u32buf,u32bufp;let u8buf,u8bufp;let s = "";let lsp,sp,sl; let c = new TextDecoder();const ns_cache = []; - let ns_cache_cache_hit, ns_cache_cache_idx; - function get_ns_cache() { - ns_cache_cache_idx = u8buf[u8bufp++]; - if(ns_cache_cache_idx & 128){ - ns_cache_cache_hit=s.substring(sp,sp+=u8buf[u8bufp++]); - ns_cache[ns_cache_cache_idx&4294967167]=ns_cache_cache_hit; - return ns_cache_cache_hit; - } - else{ - return ns_cache[ns_cache_cache_idx&4294967167]; - } - }const attr = []; - let attr_cache_hit, attr_cache_idx; - function get_attr() { - attr_cache_idx = u8buf[u8bufp++]; - if(attr_cache_idx & 128){ - attr_cache_hit=s.substring(sp,sp+=u8buf[u8bufp++]); - attr[attr_cache_idx&4294967167]=attr_cache_hit; - return attr_cache_hit; - } - else{ - return attr[attr_cache_idx&4294967167]; - } - }const evt = []; - let evt_cache_hit, evt_cache_idx; - function get_evt() { - evt_cache_idx = u8buf[u8bufp++]; - if(evt_cache_idx & 128){ - evt_cache_hit=s.substring(sp,sp+=u8buf[u8bufp++]); - evt[evt_cache_idx&4294967167]=evt_cache_hit; - return evt_cache_hit; - } - else{ - return evt[evt_cache_idx&4294967167]; - } - }const namespace = []; - let namespace_cache_hit, namespace_cache_idx; - function get_namespace() { - namespace_cache_idx = u8buf[u8bufp++]; - if(namespace_cache_idx & 128){ - namespace_cache_hit=s.substring(sp,sp+=u8buf[u8bufp++]); - namespace[namespace_cache_idx&4294967167]=namespace_cache_hit; - return namespace_cache_hit; - } - else{ - return namespace[namespace_cache_idx&4294967167]; - } - }const el = []; - let el_cache_hit, el_cache_idx; - function get_el() { - el_cache_idx = u8buf[u8bufp++]; - if(el_cache_idx & 128){ - el_cache_hit=s.substring(sp,sp+=u8buf[u8bufp++]); - el[el_cache_idx&4294967167]=el_cache_hit; - return el_cache_hit; - } - else{ - return el[el_cache_idx&4294967167]; - } - }let u16buf,u16bufp; - let bubbles,field,value,array,event_name,many,id,ns; - function create(r){ - d=r; - } - function update_memory(b){ - m=new DataView(b.buffer) - } - function run(){ - metaflags=m.getUint32(d,true); - if((metaflags>>>6)&1){ - ls=m.getUint32(d+6*4,true); - } - p=ls; - if ((metaflags>>>3)&1){ - t = m.getUint32(d+3*4,true); - u32buf=new Uint32Array(m.buffer,t,((m.buffer.byteLength-t)-(m.buffer.byteLength-t)%4)/4); - } - u32bufp=0;if ((metaflags>>>5)&1){ - t = m.getUint32(d+5*4,true); - u8buf=new Uint8Array(m.buffer,t,((m.buffer.byteLength-t)-(m.buffer.byteLength-t)%1)/1); - } - u8bufp=0;if (metaflags&1){ - lsp = m.getUint32(d+1*4,true); - } - if ((metaflags>>>2)&1) { - sl = m.getUint32(d+2*4,true); - if ((metaflags>>>1)&1) { - sp = lsp; - s = ""; - e = sp + ((sl / 4) | 0) * 4; - while (sp < e) { - t = m.getUint32(sp, true); - s += String.fromCharCode( - t & 255, - (t & 65280) >> 8, - (t & 16711680) >> 16, - t >> 24 - ); - sp += 4; - } - while (sp < lsp + sl) { - s += String.fromCharCode(m.getUint8(sp++)); - } - } else { - s = c.decode(new DataView(m.buffer, lsp, sl)); - } - } - sp=0;if ((metaflags>>>4)&1){ - t = m.getUint32(d+4*4,true); - u16buf=new Uint16Array(m.buffer,t,((m.buffer.byteLength-t)-(m.buffer.byteLength-t)%2)/2); - } - u16bufp=0; - for(;;){ - op=m.getUint32(p,true); - p+=4; - z=0; - while(z++<4){ - switch(op&255){ - case 0:{AppendChildren(root, stack.length-1);}break;case 1:{stack.push(nodes[u32buf[u32bufp++]]);}break;case 2:{AppendChildren(u32buf[u32bufp++], u16buf[u16bufp++]);}break;case 3:many=u16buf[u16bufp++];{ - root = stack[stack.length-many-1]; - els = stack.splice(stack.length-many); - for (k = 0; k < many; k++) { - root.appendChild(els[k]); - } - }break;case 4:{stack.pop();}break;case 5:{root = nodes[u32buf[u32bufp++]]; els = stack.splice(stack.length-u16buf[u16bufp++]); if (root.listening) { listeners.removeAllNonBubbling(root); } root.replaceWith(...els);}break;case 6:{nodes[u32buf[u32bufp++]].after(...stack.splice(stack.length-u16buf[u16bufp++]));}break;case 7:{nodes[u32buf[u32bufp++]].before(...stack.splice(stack.length-u16buf[u16bufp++]));}break;case 8:{node = nodes[u32buf[u32bufp++]]; if (node !== undefined) { if (node.listening) { listeners.removeAllNonBubbling(node); } node.remove(); }}break;case 9:{stack.push(document.createTextNode(s.substring(sp,sp+=u32buf[u32bufp++])));}break;case 10:{node = document.createTextNode(s.substring(sp,sp+=u32buf[u32bufp++])); nodes[u32buf[u32bufp++]] = node; stack.push(node);}break;case 11:{stack.push(document.createElement(get_el()))}break;case 12:{stack.push(document.createElementNS(get_namespace(), get_el()))}break;case 13:{node = document.createElement('pre'); node.hidden = true; stack.push(node); nodes[u32buf[u32bufp++]] = node;}break;case 14:{node = document.createElement('pre'); node.hidden = true; stack.push(node);}break;case 15:event_name=get_evt();id=u32buf[u32bufp++];bubbles=u8buf[u8bufp++]; - bubbles = bubbles == 1; - node = nodes[id]; - if(node.listening){ - node.listening += 1; - } else { - node.listening = 1; - } - node.setAttribute('data-dioxus-id', `${id}`); - - // if this is a mounted listener, we send the event immediately - if (event_name === "mounted") { - window.ipc.postMessage( - serializeIpcMessage("user_event", { - name: event_name, - element: edit.id, - data: null, - bubbles, - }) - ); - } else { - listeners.create(event_name, node, bubbles, (event) => { - handler(event, event_name, bubbles, config); - }); - }break;case 16:{node = nodes[u32buf[u32bufp++]]; node.listening -= 1; node.removeAttribute('data-dioxus-id'); listeners.remove(node, get_evt(), u8buf[u8bufp++]);}break;case 17:{nodes[u32buf[u32bufp++]].textContent = s.substring(sp,sp+=u32buf[u32bufp++]);}break;case 18:{node = nodes[u32buf[u32bufp++]]; SetAttributeInner(node, get_attr(), s.substring(sp,sp+=u32buf[u32bufp++]), get_ns_cache());}break;case 19:{SetAttributeInner(stack[stack.length-1], get_attr(), s.substring(sp,sp+=u32buf[u32bufp++]), get_ns_cache());}break;case 20:id=u32buf[u32bufp++];field=get_attr();ns=get_ns_cache();{ - node = nodes[id]; - if (!ns) { - switch (field) { - case "value": - node.value = ""; - break; - case "checked": - node.checked = false; - break; - case "selected": - node.selected = false; - break; - case "dangerous_inner_html": - node.innerHTML = ""; - break; - default: - node.removeAttribute(field); - break; - } - } else if (ns == "style") { - node.style.removeProperty(name); - } else { - node.removeAttributeNS(ns, field); - } - }break;case 21:{nodes[u32buf[u32bufp++]] = LoadChild((()=>{e=u8bufp+u32buf[u32bufp++];const final_array = u8buf.slice(u8bufp,e);u8bufp=e;return final_array;})());}break;case 22:array=(()=>{e=u8bufp+u32buf[u32bufp++];const final_array = u8buf.slice(u8bufp,e);u8bufp=e;return final_array;})();value=s.substring(sp,sp+=u32buf[u32bufp++]);id=u32buf[u32bufp++];{ - node = LoadChild(array); - if (node.nodeType == Node.TEXT_NODE) { - node.textContent = value; - } else { - let text = document.createTextNode(value); - node.replaceWith(text); - node = text; - } - nodes[id] = node; - }break;case 23:{els = stack.splice(stack.length - u16buf[u16bufp++]); node = LoadChild((()=>{e=u8bufp+u32buf[u32bufp++];const final_array = u8buf.slice(u8bufp,e);u8bufp=e;return final_array;})()); node.replaceWith(...els);}break;case 24:{node = templates[u16buf[u16bufp++]][u16buf[u16bufp++]].cloneNode(true); nodes[u32buf[u32bufp++]] = node; stack.push(node);}break;case 25:{templates[u16buf[u16bufp++]] = stack.splice(stack.length-u16buf[u16bufp++]);}break;case 26:return true; - } - op>>>=8; - } - } - } - function run_from_bytes(bytes){ - d = 0; - update_memory(new Uint8Array(bytes)) - run() - } -const config = new InterpreterConfig(false); \ No newline at end of file From e819702fc516c79a813e0d82bad23998e572a49b Mon Sep 17 00:00:00 2001 From: Jonathan Kelley Date: Tue, 17 Oct 2023 15:42:21 -0700 Subject: [PATCH 184/447] Add into_vnode temporary logic for more things This commit adjusts how rsx! works, making it more forgiving with signals. Notably, we add the temporaries to if chains too. --- examples/signals.rs | 13 +++++++++++-- packages/core/src/lib.rs | 6 +++--- packages/rsx/src/node.rs | 14 +++++++++----- 3 files changed, 23 insertions(+), 10 deletions(-) diff --git a/examples/signals.rs b/examples/signals.rs index c16bfe927..559c3f5ce 100644 --- a/examples/signals.rs +++ b/examples/signals.rs @@ -8,8 +8,10 @@ fn main() { fn app(cx: Scope) -> Element { let running = dioxus_signals::use_signal(cx, || true); let mut count = dioxus_signals::use_signal(cx, || 0); - let saved_values = dioxus_signals::use_signal(cx, || vec![0]); + let saved_values = dioxus_signals::use_signal(cx, || vec![0.to_string()]); + // Signals can be used in async functions without an explicit clone since they're 'static and Copy + // Signals are backed by a runtime that is designed to deeply integrate with Dioxus apps use_future!(cx, || async move { loop { if running.value() { @@ -24,7 +26,7 @@ fn app(cx: Scope) -> Element { button { onclick: move |_| count += 1, "Up high!" } button { onclick: move |_| count -= 1, "Down low!" } button { onclick: move |_| running.toggle(), "Toggle counter" } - button { onclick: move |_| saved_values.push(count.value()), "Save this value" } + button { onclick: move |_| saved_values.push(count.value().to_string()), "Save this value" } // We can do boolean operations on the current signal value if count.value() > 5 { @@ -35,5 +37,12 @@ fn app(cx: Scope) -> Element { for value in saved_values.read().iter() { h3 { "Saved value: {value}" } } + + // We can also use the signal value as a slice + if let &[ref first, .., ref last] = saved_values.read().as_slice() { + rsx! { li { "single element: {first}, {last}" } } + } else { + rsx! { "No saved values" } + } }) } diff --git a/packages/core/src/lib.rs b/packages/core/src/lib.rs index ee557af2d..392774767 100644 --- a/packages/core/src/lib.rs +++ b/packages/core/src/lib.rs @@ -91,9 +91,9 @@ pub mod prelude { consume_context, consume_context_from_scope, current_scope_id, fc_to_builder, has_context, provide_context, provide_context_to_scope, provide_root_context, push_future, remove_future, schedule_update_any, spawn, spawn_forever, suspend, throw, AnyValue, - Component, Element, Event, EventHandler, Fragment, IntoAttributeValue, LazyNodes, - Properties, Runtime, RuntimeGuard, Scope, ScopeId, ScopeState, Scoped, TaskId, Template, - TemplateAttribute, TemplateNode, Throw, VNode, VirtualDom, + Component, Element, Event, EventHandler, Fragment, IntoAttributeValue, IntoDynNode, + LazyNodes, Properties, Runtime, RuntimeGuard, Scope, ScopeId, ScopeState, Scoped, TaskId, + Template, TemplateAttribute, TemplateNode, Throw, VNode, VirtualDom, }; } diff --git a/packages/rsx/src/node.rs b/packages/rsx/src/node.rs index 9c2f7b330..ed5e0bff4 100644 --- a/packages/rsx/src/node.rs +++ b/packages/rsx/src/node.rs @@ -126,8 +126,7 @@ impl ToTokens for BodyNode { }), BodyNode::RawExpr(exp) => tokens.append_all(quote! { { - use ::dioxus::core::IntoDynNode; - let ___nodes =(#exp).into_vnode(__cx); + let ___nodes = (#exp).into_vnode(__cx); ___nodes } }), @@ -146,7 +145,6 @@ impl ToTokens for BodyNode { // And then we can return them into the dyn loop tokens.append_all(quote! { { - use ::dioxus::core::IntoDynNode; let ___nodes =(#expr).into_iter().map(|#pat| { #renderer }).into_vnode(__cx); ___nodes } @@ -155,7 +153,10 @@ impl ToTokens for BodyNode { BodyNode::IfChain(chain) => { if is_if_chain_terminated(chain) { tokens.append_all(quote! { - __cx.make_node(#chain) + { + let ___nodes = (#chain).into_vnode(__cx); + ___nodes + } }); } else { let ExprIf { @@ -209,7 +210,10 @@ impl ToTokens for BodyNode { }); tokens.append_all(quote! { - __cx.make_node(#body) + { + let ___nodes = (#body).into_vnode(__cx); + ___nodes + } }); } } From 65e21d7874e9dfac7b2a5dcdec653500a954c057 Mon Sep 17 00:00:00 2001 From: Jonathan Kelley Date: Tue, 17 Oct 2023 15:52:13 -0700 Subject: [PATCH 185/447] Change signals example a bit --- examples/signals.rs | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/examples/signals.rs b/examples/signals.rs index 559c3f5ce..49f8e2de1 100644 --- a/examples/signals.rs +++ b/examples/signals.rs @@ -27,6 +27,7 @@ fn app(cx: Scope) -> Element { button { onclick: move |_| count -= 1, "Down low!" } button { onclick: move |_| running.toggle(), "Toggle counter" } button { onclick: move |_| saved_values.push(count.value().to_string()), "Save this value" } + button { onclick: move |_| saved_values.write().clear(), "Clear saved values" } // We can do boolean operations on the current signal value if count.value() > 5 { @@ -40,7 +41,7 @@ fn app(cx: Scope) -> Element { // We can also use the signal value as a slice if let &[ref first, .., ref last] = saved_values.read().as_slice() { - rsx! { li { "single element: {first}, {last}" } } + rsx! { li { "First and last: {first}, {last}" } } } else { rsx! { "No saved values" } } From 9cdbf81a4bc8ae528db090173c84d63c07e850e8 Mon Sep 17 00:00:00 2001 From: Jonathan Kelley Date: Tue, 17 Oct 2023 16:06:43 -0700 Subject: [PATCH 186/447] fix clippy lint --- examples/signals.rs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/examples/signals.rs b/examples/signals.rs index 49f8e2de1..0faac0af4 100644 --- a/examples/signals.rs +++ b/examples/signals.rs @@ -40,7 +40,7 @@ fn app(cx: Scope) -> Element { } // We can also use the signal value as a slice - if let &[ref first, .., ref last] = saved_values.read().as_slice() { + if let [ref first, .., ref last] = saved_values.read().as_slice() { rsx! { li { "First and last: {first}, {last}" } } } else { rsx! { "No saved values" } From 9b7b2e7877137bce4bd879aa716b497878fd3268 Mon Sep 17 00:00:00 2001 From: Jonathan Kelley Date: Tue, 17 Oct 2023 17:51:44 -0700 Subject: [PATCH 187/447] Try making the cache faster using mozilla's cache --- .github/workflows/main.yml | 34 +++++++++++++++++++++++++++++----- 1 file changed, 29 insertions(+), 5 deletions(-) diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml index 037525557..6c8471874 100644 --- a/.github/workflows/main.yml +++ b/.github/workflows/main.yml @@ -36,9 +36,14 @@ jobs: if: github.event.pull_request.draft == false name: Check runs-on: ubuntu-latest + env: + CARGO_TERM_COLOR: always + CARGO_INCREMENTAL: 0 + SCCACHE_GHA_ENABLED: "true" + RUSTC_WRAPPER: "sccache" steps: - uses: dtolnay/rust-toolchain@stable - - uses: Swatinem/rust-cache@v2 + - uses: mozilla-actions/sccache-action@v0.0.3 - run: sudo apt-get update - run: sudo apt install libwebkit2gtk-4.1-dev libgtk-3-dev libayatana-appindicator3-dev - uses: actions/checkout@v4 @@ -48,9 +53,14 @@ jobs: if: github.event.pull_request.draft == false name: Test Suite runs-on: ubuntu-latest + env: + CARGO_TERM_COLOR: always + CARGO_INCREMENTAL: 0 + SCCACHE_GHA_ENABLED: "true" + RUSTC_WRAPPER: "sccache" steps: - uses: dtolnay/rust-toolchain@stable - - uses: Swatinem/rust-cache@v2 + - uses: mozilla-actions/sccache-action@v0.0.3 - run: sudo apt-get update - run: sudo apt install libwebkit2gtk-4.1-dev libgtk-3-dev libayatana-appindicator3-dev - uses: davidB/rust-cargo-make@v1 @@ -63,9 +73,14 @@ jobs: if: github.event.pull_request.draft == false name: Rustfmt runs-on: ubuntu-latest + env: + CARGO_TERM_COLOR: always + CARGO_INCREMENTAL: 0 + SCCACHE_GHA_ENABLED: "true" + RUSTC_WRAPPER: "sccache" steps: - uses: dtolnay/rust-toolchain@stable - - uses: Swatinem/rust-cache@v2 + - uses: mozilla-actions/sccache-action@v0.0.3 - run: rustup component add rustfmt - uses: actions/checkout@v4 - run: cargo fmt --all -- --check @@ -74,9 +89,14 @@ jobs: if: github.event.pull_request.draft == false name: Clippy runs-on: ubuntu-latest + env: + CARGO_TERM_COLOR: always + CARGO_INCREMENTAL: 0 + SCCACHE_GHA_ENABLED: "true" + RUSTC_WRAPPER: "sccache" steps: - uses: dtolnay/rust-toolchain@stable - - uses: Swatinem/rust-cache@v2 + - uses: mozilla-actions/sccache-action@v0.0.3 - run: sudo apt-get update - run: sudo apt install libwebkit2gtk-4.1-dev libgtk-3-dev libayatana-appindicator3-dev - run: rustup component add clippy @@ -86,6 +106,10 @@ jobs: matrix_test: runs-on: ${{ matrix.platform.os }} env: + CARGO_TERM_COLOR: always + CARGO_INCREMENTAL: 0 + SCCACHE_GHA_ENABLED: "true" + RUSTC_WRAPPER: "sccache" RUST_CARGO_COMMAND: ${{ matrix.platform.cross == true && 'cross' || 'cargo' }} strategy: matrix: @@ -136,7 +160,7 @@ jobs: if: ${{ matrix.platform.cross == true }} uses: taiki-e/install-action@cross - - uses: Swatinem/rust-cache@v2 + - uses: mozilla-actions/sccache-action@v0.0.3 with: workspaces: core -> ../target save-if: ${{ matrix.features.key == 'all' }} From 37c6c67a17ffba67fc37bc67917c0ca529e9f249 Mon Sep 17 00:00:00 2001 From: Alexander Date: Thu, 19 Oct 2023 15:26:17 +0100 Subject: [PATCH 188/447] refactor todo mvc example (#1556) --- examples/todomvc.rs | 182 +++++++++++++++++++++++++++----------------- 1 file changed, 114 insertions(+), 68 deletions(-) diff --git a/examples/todomvc.rs b/examples/todomvc.rs index 4b25507a5..9ec2dc228 100644 --- a/examples/todomvc.rs +++ b/examples/todomvc.rs @@ -24,8 +24,6 @@ pub struct TodoItem { pub fn app(cx: Scope<()>) -> Element { let todos = use_state(cx, im_rc::HashMap::::default); let filter = use_state(cx, || FilterState::All); - let draft = use_state(cx, || "".to_string()); - let todo_id = use_state(cx, || 0); // Filter the todos based on the filter state let mut filtered_todos = todos @@ -47,42 +45,11 @@ pub fn app(cx: Scope<()>) -> Element { let show_clear_completed = todos.values().any(|todo| todo.checked); - let selected = |state| { - if *filter == state { - "selected" - } else { - "false" - } - }; - cx.render(rsx! { section { class: "todoapp", style { include_str!("./assets/todomvc.css") } - header { class: "header", - h1 {"todos"} - input { - class: "new-todo", - placeholder: "What needs to be done?", - value: "{draft}", - autofocus: "true", - oninput: move |evt| { - draft.set(evt.value.clone()); - }, - onkeydown: move |evt| { - if evt.key() == Key::Enter && !draft.is_empty() { - todos.make_mut().insert( - **todo_id, - TodoItem { - id: **todo_id, - checked: false, - contents: draft.to_string(), - }, - ); - *todo_id.make_mut() += 1; - draft.set("".to_string()); - } - } - } + TodoHeader { + todos: todos, } section { class: "main", @@ -111,44 +78,56 @@ pub fn app(cx: Scope<()>) -> Element { })) } (!todos.is_empty()).then(|| rsx!( - footer { class: "footer", - span { class: "todo-count", - strong {"{active_todo_count} "} - span {"{active_todo_text} left"} - } - ul { class: "filters", - for (state, state_text, url) in [ - (FilterState::All, "All", "#/"), - (FilterState::Active, "Active", "#/active"), - (FilterState::Completed, "Completed", "#/completed"), - ] { - li { - a { - href: url, - class: selected(state), - onclick: move |_| filter.set(state), - prevent_default: "onclick", - state_text - } - } - } - } - show_clear_completed.then(|| rsx!( - button { - class: "clear-completed", - onclick: move |_| todos.make_mut().retain(|_, todo| !todo.checked), - "Clear completed" - } - )) + ListFooter { + active_todo_count: active_todo_count, + active_todo_text: active_todo_text, + show_clear_completed: show_clear_completed, + todos: todos, + filter: filter, } )) } } - footer { class: "info", - p { "Double-click to edit a todo" } - p { "Created by ", a { href: "http://github.com/jkelleyrtp/", "jkelleyrtp" }} - p { "Part of ", a { href: "http://todomvc.com", "TodoMVC" }} + PageFooter {} + }) +} + +#[derive(Props)] +pub struct TodoHeaderProps<'a> { + todos: &'a UseState>, +} + +pub fn TodoHeader<'a>(cx: Scope<'a, TodoHeaderProps<'a>>) -> Element { + let draft = use_state(cx, || "".to_string()); + let todo_id = use_state(cx, || 0); + + cx.render(rsx! { + header { class: "header", + h1 {"todos"} + input { + class: "new-todo", + placeholder: "What needs to be done?", + value: "{draft}", + autofocus: "true", + oninput: move |evt| { + draft.set(evt.value.clone()); + }, + onkeydown: move |evt| { + if evt.key() == Key::Enter && !draft.is_empty() { + cx.props.todos.make_mut().insert( + **todo_id, + TodoItem { + id: **todo_id, + checked: false, + contents: draft.to_string(), + }, + ); + *todo_id.make_mut() += 1; + draft.set("".to_string()); + } + } } + } }) } @@ -209,3 +188,70 @@ pub fn TodoEntry<'a>(cx: Scope<'a, TodoEntryProps<'a>>) -> Element { } }) } + +#[derive(Props)] +pub struct ListFooterProps<'a> { + todos: &'a UseState>, + active_todo_count: usize, + active_todo_text: &'a str, + show_clear_completed: bool, + filter: &'a UseState, +} + +pub fn ListFooter<'a>(cx: Scope<'a, ListFooterProps<'a>>) -> Element { + let active_todo_count = cx.props.active_todo_count; + let active_todo_text = cx.props.active_todo_text; + + let selected = |state| { + if *cx.props.filter == state { + "selected" + } else { + "false" + } + }; + + cx.render(rsx! { + footer { class: "footer", + span { class: "todo-count", + strong {"{active_todo_count} "} + span {"{active_todo_text} left"} + } + ul { class: "filters", + for (state, state_text, url) in [ + (FilterState::All, "All", "#/"), + (FilterState::Active, "Active", "#/active"), + (FilterState::Completed, "Completed", "#/completed"), + ] { + li { + a { + href: url, + class: selected(state), + onclick: move |_| cx.props.filter.set(state), + prevent_default: "onclick", + state_text + } + } + } + } + if cx.props.show_clear_completed { + cx.render(rsx! { + button { + class: "clear-completed", + onclick: move |_| cx.props.todos.make_mut().retain(|_, todo| !todo.checked), + "Clear completed" + } + }) + } + } + }) +} + +pub fn PageFooter(cx: Scope) -> Element { + cx.render(rsx! { + footer { class: "info", + p { "Double-click to edit a todo" } + p { "Created by ", a { href: "http://github.com/jkelleyrtp/", "jkelleyrtp" }} + p { "Part of ", a { href: "http://todomvc.com", "TodoMVC" }} + } + }) +} From 000edc055243ad3a0f03cfc59b5dddfc22c6da5b Mon Sep 17 00:00:00 2001 From: ealmloff Date: Thu, 19 Oct 2023 13:01:38 -0500 Subject: [PATCH 189/447] document generational box --- packages/generational-box/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/generational-box/README.md b/packages/generational-box/README.md index 63c539e08..cbd4af5fb 100644 --- a/packages/generational-box/README.md +++ b/packages/generational-box/README.md @@ -31,4 +31,4 @@ let store = Store::default(); ## How it works -Internally \ No newline at end of file +Internally, `generational-box` creates an arena of generational RefCell's that are recyled when the owner is dropped. You can think of the cells as something like `&'static RefCell>` with some a generational check to make recyling a cell easier to debug. Then GenerationalBox's are `Copy` because the `&'static` pointer is `Copy` From 1cf8f7136846c07a2799f9813fdd68f6b5a2f345 Mon Sep 17 00:00:00 2001 From: ealmloff Date: Thu, 19 Oct 2023 13:03:26 -0500 Subject: [PATCH 190/447] Fix typo in generational box readme --- packages/generational-box/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/generational-box/README.md b/packages/generational-box/README.md index cbd4af5fb..7d3088eda 100644 --- a/packages/generational-box/README.md +++ b/packages/generational-box/README.md @@ -31,4 +31,4 @@ let store = Store::default(); ## How it works -Internally, `generational-box` creates an arena of generational RefCell's that are recyled when the owner is dropped. You can think of the cells as something like `&'static RefCell>` with some a generational check to make recyling a cell easier to debug. Then GenerationalBox's are `Copy` because the `&'static` pointer is `Copy` +Internally, `generational-box` creates an arena of generational RefCell's that are recyled when the owner is dropped. You can think of the cells as something like `&'static RefCell>` with a generational check to make recyling a cell easier to debug. Then GenerationalBox's are `Copy` because the `&'static` pointer is `Copy` From ad9c59c2b4c49941d512aa126c07d96a9f7a3281 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Thu, 19 Oct 2023 13:23:58 -0500 Subject: [PATCH 191/447] add an readable error when you name a prop key --- packages/core-macro/src/props/mod.rs | 15 +++++++++------ 1 file changed, 9 insertions(+), 6 deletions(-) diff --git a/packages/core-macro/src/props/mod.rs b/packages/core-macro/src/props/mod.rs index c1931e497..1fca9baf7 100644 --- a/packages/core-macro/src/props/mod.rs +++ b/packages/core-macro/src/props/mod.rs @@ -467,7 +467,7 @@ fn type_from_inside_option(ty: &syn::Type, check_option_name: bool) -> Option<&s mod struct_info { use proc_macro2::TokenStream; - use quote::quote; + use quote::{quote, quote_spanned}; use syn::parse::Error; use syn::punctuated::Punctuated; use syn::Expr; @@ -701,6 +701,14 @@ Finally, call `.build()` to create the instance of `{name}`. } pub fn field_impl(&self, field: &FieldInfo) -> Result { + let FieldInfo { + name: field_name, + ty: field_type, + .. + } = field; + if field_name.to_string() == "key" { + return Err(Error::new_spanned(field_name, "Naming a prop `key` is not allowed because the name can conflict with the built in key attribute. See https://dioxuslabs.com/learn/0.4/reference/dynamic_rendering#rendering-lists for more information about keys")); + } let StructInfo { ref builder_name, .. } = *self; @@ -715,11 +723,6 @@ Finally, call `.build()` to create the instance of `{name}`. }); let reconstructing = self.included_fields().map(|f| f.name); - let FieldInfo { - name: field_name, - ty: field_type, - .. - } = field; let mut ty_generics: Vec = self .generics .params From 42eb4b5098c3980171e4690d482d2e7a8021a3ef Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Thu, 19 Oct 2023 15:48:06 -0500 Subject: [PATCH 192/447] fix clippy --- packages/core-macro/src/props/mod.rs | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/packages/core-macro/src/props/mod.rs b/packages/core-macro/src/props/mod.rs index 1fca9baf7..605983afc 100644 --- a/packages/core-macro/src/props/mod.rs +++ b/packages/core-macro/src/props/mod.rs @@ -467,7 +467,7 @@ fn type_from_inside_option(ty: &syn::Type, check_option_name: bool) -> Option<&s mod struct_info { use proc_macro2::TokenStream; - use quote::{quote, quote_spanned}; + use quote::quote; use syn::parse::Error; use syn::punctuated::Punctuated; use syn::Expr; @@ -706,7 +706,7 @@ Finally, call `.build()` to create the instance of `{name}`. ty: field_type, .. } = field; - if field_name.to_string() == "key" { + if *field_name == "key" { return Err(Error::new_spanned(field_name, "Naming a prop `key` is not allowed because the name can conflict with the built in key attribute. See https://dioxuslabs.com/learn/0.4/reference/dynamic_rendering#rendering-lists for more information about keys")); } let StructInfo { From c9612a085ed1a96a5d8acd573337643395efa5ae Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Thu, 19 Oct 2023 16:40:08 -0500 Subject: [PATCH 193/447] fix liveview mounted event --- packages/desktop/Cargo.toml | 4 +- packages/desktop/build.rs | 2 +- packages/desktop/src/desktop_context.rs | 2 +- packages/interpreter/Cargo.toml | 3 +- .../interpreter/src/sledgehammer_bindings.rs | 290 +++++++++--------- packages/liveview/Cargo.toml | 4 +- packages/liveview/build.rs | 10 +- packages/liveview/src/element.rs | 9 +- packages/liveview/src/main.js | 25 +- packages/liveview/src/pool.rs | 22 +- 10 files changed, 195 insertions(+), 176 deletions(-) diff --git a/packages/desktop/Cargo.toml b/packages/desktop/Cargo.toml index 57326db98..fcc47e4d8 100644 --- a/packages/desktop/Cargo.toml +++ b/packages/desktop/Cargo.toml @@ -12,7 +12,7 @@ keywords = ["dom", "ui", "gui", "react"] [dependencies] dioxus-core = { workspace = true, features = ["serialize"] } dioxus-html = { workspace = true, features = ["serialize", "native-bind"] } -dioxus-interpreter-js = { workspace = true, features = ["sledgehammer"]} +dioxus-interpreter-js = { workspace = true, features = ["binary-protocol"] } dioxus-hot-reload = { workspace = true, optional = true } serde = "1.0.136" @@ -74,7 +74,7 @@ exitcode = "1.1.2" scraper = "0.16.0" [build-dependencies] -dioxus-interpreter-js = { workspace = true, features = ["sledgehammer"] } +dioxus-interpreter-js = { workspace = true, features = ["binary-protocol"] } minify-js = "0.5.6" # These tests need to be run on the main thread, so they cannot use rust's test harness. diff --git a/packages/desktop/build.rs b/packages/desktop/build.rs index 77930cb8c..bd7445637 100644 --- a/packages/desktop/build.rs +++ b/packages/desktop/build.rs @@ -1,4 +1,4 @@ -use dioxus_interpreter_js::SLEDGEHAMMER_JS; +use dioxus_interpreter_js::binary_protocol::SLEDGEHAMMER_JS; use std::io::Write; diff --git a/packages/desktop/src/desktop_context.rs b/packages/desktop/src/desktop_context.rs index 1b253eafc..de5eefc89 100644 --- a/packages/desktop/src/desktop_context.rs +++ b/packages/desktop/src/desktop_context.rs @@ -8,7 +8,7 @@ use dioxus_core::ScopeState; use dioxus_core::VirtualDom; #[cfg(all(feature = "hot-reload", debug_assertions))] use dioxus_hot_reload::HotReloadMsg; -use dioxus_interpreter_js::Channel; +use dioxus_interpreter_js::binary_protocol::Channel; use rustc_hash::FxHashMap; use slab::Slab; use std::cell::RefCell; diff --git a/packages/interpreter/Cargo.toml b/packages/interpreter/Cargo.toml index 7dea0fe79..8d155db6d 100644 --- a/packages/interpreter/Cargo.toml +++ b/packages/interpreter/Cargo.toml @@ -14,7 +14,7 @@ keywords = ["dom", "ui", "gui", "react", "wasm"] wasm-bindgen = { workspace = true, optional = true } js-sys = { version = "0.3.56", optional = true } web-sys = { version = "0.3.56", optional = true, features = ["Element", "Node"] } -sledgehammer_bindgen = { path = "/Users/evanalmloff/Desktop/Github/sledgehammer_bindgen", default-features = false, optional = true } +sledgehammer_bindgen = { git = "https://github.com/ealmloff/sledgehammer_bindgen", default-features = false, optional = true } sledgehammer_utils = { version = "0.2", optional = true } serde = { version = "1.0", features = ["derive"], optional = true } @@ -23,4 +23,5 @@ default = [] serialize = ["serde"] sledgehammer = ["sledgehammer_bindgen", "sledgehammer_utils"] web = ["sledgehammer", "wasm-bindgen", "js-sys", "web-sys", "sledgehammer_bindgen/web"] +binary-protocol = ["sledgehammer"] minimal_bindings = [] diff --git a/packages/interpreter/src/sledgehammer_bindings.rs b/packages/interpreter/src/sledgehammer_bindings.rs index 6726b48f6..ac1fbf5f0 100644 --- a/packages/interpreter/src/sledgehammer_bindings.rs +++ b/packages/interpreter/src/sledgehammer_bindings.rs @@ -1,10 +1,13 @@ #[cfg(feature = "web")] use js_sys::Function; +#[cfg(feature = "web")] use sledgehammer_bindgen::bindgen; #[cfg(feature = "web")] use web_sys::Node; +#[cfg(feature = "web")] pub const SLEDGEHAMMER_JS: &str = GENERATED_JS; + #[cfg(feature = "web")] #[bindgen(module)] mod js { @@ -285,152 +288,157 @@ mod js { } } -#[cfg(not(feature = "web"))] -#[bindgen] -mod js { - const JS_FILE: &str = "./packages/interpreter/src/interpreter.js"; +#[cfg(feature = "binary-protocol")] +pub mod binary_protocol { + use sledgehammer_bindgen::bindgen; + pub const SLEDGEHAMMER_JS: &str = GENERATED_JS; - fn mount_to_root() { - "{AppendChildren(root, stack.length-1);}" - } - fn push_root(root: u32) { - "{stack.push(nodes[$root$]);}" - } - fn append_children(id: u32, many: u16) { - "{AppendChildren($id$, $many$);}" - } - fn append_children_to_top(many: u16) { - "{ - root = stack[stack.length-many-1]; - els = stack.splice(stack.length-many); - for (k = 0; k < many; k++) { - root.appendChild(els[k]); - } - }" - } - fn pop_root() { - "{stack.pop();}" - } - fn replace_with(id: u32, n: u16) { - "{root = nodes[$id$]; els = stack.splice(stack.length-$n$); if (root.listening) { listeners.removeAllNonBubbling(root); } root.replaceWith(...els);}" - } - fn insert_after(id: u32, n: u16) { - "{nodes[$id$].after(...stack.splice(stack.length-$n$));}" - } - fn insert_before(id: u32, n: u16) { - "{nodes[$id$].before(...stack.splice(stack.length-$n$));}" - } - fn remove(id: u32) { - "{node = nodes[$id$]; if (node !== undefined) { if (node.listening) { listeners.removeAllNonBubbling(node); } node.remove(); }}" - } - fn create_raw_text(text: &str) { - "{stack.push(document.createTextNode($text$));}" - } - fn create_text_node(text: &str, id: u32) { - "{node = document.createTextNode($text$); nodes[$id$] = node; stack.push(node);}" - } - fn create_element(element: &'static str) { - "{stack.push(document.createElement($element$))}" - } - fn create_element_ns(element: &'static str, ns: &'static str) { - "{stack.push(document.createElementNS($ns$, $element$))}" - } - fn create_placeholder(id: u32) { - "{node = document.createElement('pre'); node.hidden = true; stack.push(node); nodes[$id$] = node;}" - } - fn add_placeholder() { - "{node = document.createElement('pre'); node.hidden = true; stack.push(node);}" - } - fn new_event_listener(event_name: &str, id: u32, bubbles: u8) { - r#" - bubbles = bubbles == 1; - node = nodes[id]; - if(node.listening){ - node.listening += 1; - } else { - node.listening = 1; + #[bindgen] + mod protocol_js { + const JS_FILE: &str = "./packages/interpreter/src/interpreter.js"; + + fn mount_to_root() { + "{AppendChildren(root, stack.length-1);}" } - node.setAttribute('data-dioxus-id', `\${id}`); - - // if this is a mounted listener, we send the event immediately - if (event_name === "mounted") { - window.ipc.postMessage( - serializeIpcMessage("user_event", { - name: event_name, - element: edit.id, - data: null, - bubbles, - }) - ); - } else { - listeners.create(event_name, node, bubbles, (event) => { - handler(event, event_name, bubbles, config); - }); - }"# - } - fn remove_event_listener(event_name: &str, id: u32, bubbles: u8) { - "{node = nodes[$id$]; node.listening -= 1; node.removeAttribute('data-dioxus-id'); listeners.remove(node, $event_name$, $bubbles$);}" - } - fn set_text(id: u32, text: &str) { - "{nodes[$id$].textContent = $text$;}" - } - fn set_attribute(id: u32, field: &str, value: &str, ns: &str) { - "{node = nodes[$id$]; SetAttributeInner(node, $field$, $value$, $ns$);}" - } - fn set_top_attribute(field: &str, value: &str, ns: &str) { - "{SetAttributeInner(stack[stack.length-1], $field$, $value$, $ns$);}" - } - fn remove_attribute(id: u32, field: &str, ns: &str) { - r#"{ - node = nodes[$id$]; - if (!ns) { - switch (field) { - case "value": - node.value = ""; - break; - case "checked": - node.checked = false; - break; - case "selected": - node.selected = false; - break; - case "dangerous_inner_html": - node.innerHTML = ""; - break; - default: - node.removeAttribute(field); - break; + fn push_root(root: u32) { + "{stack.push(nodes[$root$]);}" + } + fn append_children(id: u32, many: u16) { + "{AppendChildren($id$, $many$);}" + } + fn append_children_to_top(many: u16) { + "{ + root = stack[stack.length-many-1]; + els = stack.splice(stack.length-many); + for (k = 0; k < many; k++) { + root.appendChild(els[k]); } - } else if (ns == "style") { - node.style.removeProperty(name); + }" + } + fn pop_root() { + "{stack.pop();}" + } + fn replace_with(id: u32, n: u16) { + "{root = nodes[$id$]; els = stack.splice(stack.length-$n$); if (root.listening) { listeners.removeAllNonBubbling(root); } root.replaceWith(...els);}" + } + fn insert_after(id: u32, n: u16) { + "{nodes[$id$].after(...stack.splice(stack.length-$n$));}" + } + fn insert_before(id: u32, n: u16) { + "{nodes[$id$].before(...stack.splice(stack.length-$n$));}" + } + fn remove(id: u32) { + "{node = nodes[$id$]; if (node !== undefined) { if (node.listening) { listeners.removeAllNonBubbling(node); } node.remove(); }}" + } + fn create_raw_text(text: &str) { + "{stack.push(document.createTextNode($text$));}" + } + fn create_text_node(text: &str, id: u32) { + "{node = document.createTextNode($text$); nodes[$id$] = node; stack.push(node);}" + } + fn create_element(element: &'static str) { + "{stack.push(document.createElement($element$))}" + } + fn create_element_ns(element: &'static str, ns: &'static str) { + "{stack.push(document.createElementNS($ns$, $element$))}" + } + fn create_placeholder(id: u32) { + "{node = document.createElement('pre'); node.hidden = true; stack.push(node); nodes[$id$] = node;}" + } + fn add_placeholder() { + "{node = document.createElement('pre'); node.hidden = true; stack.push(node);}" + } + fn new_event_listener(event_name: &str, id: u32, bubbles: u8) { + r#" + bubbles = bubbles == 1; + node = nodes[id]; + if(node.listening){ + node.listening += 1; } else { - node.removeAttributeNS(ns, field); + node.listening = 1; } - }"# - } - fn assign_id(array: &[u8], id: u32) { - "{nodes[$id$] = LoadChild($array$);}" - } - fn hydrate_text(array: &[u8], value: &str, id: u32) { - r#"{ - node = LoadChild($array$); - if (node.nodeType == Node.TEXT_NODE) { - node.textContent = value; + node.setAttribute('data-dioxus-id', `\${id}`); + + // if this is a mounted listener, we send the event immediately + if (event_name === "mounted") { + window.ipc.postMessage( + serializeIpcMessage("user_event", { + name: event_name, + element: id, + data: null, + bubbles, + }) + ); } else { - let text = document.createTextNode(value); - node.replaceWith(text); - node = text; - } - nodes[$id$] = node; - }"# - } - fn replace_placeholder(array: &[u8], n: u16) { - "{els = stack.splice(stack.length - $n$); node = LoadChild($array$); node.replaceWith(...els);}" - } - fn load_template(tmpl_id: u16, index: u16, id: u32) { - "{node = templates[$tmpl_id$][$index$].cloneNode(true); nodes[$id$] = node; stack.push(node);}" - } - fn add_templates(tmpl_id: u16, len: u16) { - "{templates[$tmpl_id$] = stack.splice(stack.length-$len$);}" + listeners.create(event_name, node, bubbles, (event) => { + handler(event, event_name, bubbles, config); + }); + }"# + } + fn remove_event_listener(event_name: &str, id: u32, bubbles: u8) { + "{node = nodes[$id$]; node.listening -= 1; node.removeAttribute('data-dioxus-id'); listeners.remove(node, $event_name$, $bubbles$);}" + } + fn set_text(id: u32, text: &str) { + "{nodes[$id$].textContent = $text$;}" + } + fn set_attribute(id: u32, field: &str, value: &str, ns: &str) { + "{node = nodes[$id$]; SetAttributeInner(node, $field$, $value$, $ns$);}" + } + fn set_top_attribute(field: &str, value: &str, ns: &str) { + "{SetAttributeInner(stack[stack.length-1], $field$, $value$, $ns$);}" + } + fn remove_attribute(id: u32, field: &str, ns: &str) { + r#"{ + node = nodes[$id$]; + if (!ns) { + switch (field) { + case "value": + node.value = ""; + break; + case "checked": + node.checked = false; + break; + case "selected": + node.selected = false; + break; + case "dangerous_inner_html": + node.innerHTML = ""; + break; + default: + node.removeAttribute(field); + break; + } + } else if (ns == "style") { + node.style.removeProperty(name); + } else { + node.removeAttributeNS(ns, field); + } + }"# + } + fn assign_id(array: &[u8], id: u32) { + "{nodes[$id$] = LoadChild($array$);}" + } + fn hydrate_text(array: &[u8], value: &str, id: u32) { + r#"{ + node = LoadChild($array$); + if (node.nodeType == Node.TEXT_NODE) { + node.textContent = value; + } else { + let text = document.createTextNode(value); + node.replaceWith(text); + node = text; + } + nodes[$id$] = node; + }"# + } + fn replace_placeholder(array: &[u8], n: u16) { + "{els = stack.splice(stack.length - $n$); node = LoadChild($array$); node.replaceWith(...els);}" + } + fn load_template(tmpl_id: u16, index: u16, id: u32) { + "{node = templates[$tmpl_id$][$index$].cloneNode(true); nodes[$id$] = node; stack.push(node);}" + } + fn add_templates(tmpl_id: u16, len: u16) { + "{templates[$tmpl_id$] = stack.splice(stack.length-$len$);}" + } } } diff --git a/packages/liveview/Cargo.toml b/packages/liveview/Cargo.toml index 512edd16a..008ab48cb 100644 --- a/packages/liveview/Cargo.toml +++ b/packages/liveview/Cargo.toml @@ -25,7 +25,7 @@ serde_json = "1.0.91" rustc-hash = { workspace = true } dioxus-html = { workspace = true, features = ["serialize"] } dioxus-core = { workspace = true, features = ["serialize"] } -dioxus-interpreter-js = { workspace = true, features = ["sledgehammer"] } +dioxus-interpreter-js = { workspace = true, features = ["binary-protocol"] } dioxus-hot-reload = { workspace = true, optional = true } # warp @@ -54,7 +54,7 @@ salvo = { version = "0.44.1", features = ["affix", "ws"] } tower = "0.4.13" [build-dependencies] -dioxus-interpreter-js = { workspace = true, features = ["sledgehammer"] } +dioxus-interpreter-js = { workspace = true, features = ["binary-protocol"] } minify-js = "0.5.6" [features] diff --git a/packages/liveview/build.rs b/packages/liveview/build.rs index fc38e29c4..b62a09da0 100644 --- a/packages/liveview/build.rs +++ b/packages/liveview/build.rs @@ -1,4 +1,4 @@ -use dioxus_interpreter_js::SLEDGEHAMMER_JS; +use dioxus_interpreter_js::binary_protocol::SLEDGEHAMMER_JS; use minify_js::*; use std::io::Write; @@ -55,9 +55,9 @@ fn main() { let js = format!("{interpreter}\n{main_js}"); let session = Session::new(); - let mut out = Vec::new(); - minify(&session, TopLevelMode::Module, js.as_bytes(), &mut out).unwrap(); - let minified = String::from_utf8(out).unwrap(); + // let mut out = Vec::new(); + // minify(&session, TopLevelMode::Module, js.as_bytes(), &mut out).unwrap(); + // let minified = String::from_utf8(out).unwrap(); let mut file = std::fs::File::create("src/minified.js").unwrap(); - file.write_all(minified.as_bytes()).unwrap(); + file.write_all(js.as_bytes()).unwrap(); } diff --git a/packages/liveview/src/element.rs b/packages/liveview/src/element.rs index ae0eb4efe..6fb1fb436 100644 --- a/packages/liveview/src/element.rs +++ b/packages/liveview/src/element.rs @@ -29,7 +29,7 @@ impl RenderedElementBacking for LiveviewElement { >, >, > { - let script = format!("return window.interpreter.GetClientRect({});", self.id.0); + let script = format!("return getClientRect({});", self.id.0); let fut = self .query @@ -53,7 +53,7 @@ impl RenderedElementBacking for LiveviewElement { behavior: dioxus_html::ScrollBehavior, ) -> std::pin::Pin>>> { let script = format!( - "return window.interpreter.ScrollTo({}, {});", + "return scrollTo({}, {});", self.id.0, serde_json::to_string(&behavior).expect("Failed to serialize ScrollBehavior") ); @@ -76,10 +76,7 @@ impl RenderedElementBacking for LiveviewElement { &self, focus: bool, ) -> std::pin::Pin>>> { - let script = format!( - "return window.interpreter.SetFocus({}, {});", - self.id.0, focus - ); + let script = format!("return setFocus({}, {});", self.id.0, focus); let fut = self.query.new_query::(&script).resolve(); diff --git a/packages/liveview/src/main.js b/packages/liveview/src/main.js index 4ca557127..54b575263 100644 --- a/packages/liveview/src/main.js +++ b/packages/liveview/src/main.js @@ -28,19 +28,26 @@ class IPC { }; ws.onmessage = (message) => { - if (message.data instanceof ArrayBuffer) { + console.log(message.data); + const u8view = new Uint8Array(message.data); + const binaryFrame = u8view[0] == 1; + const messageData = message.data.slice(1) + // The first byte tells the shim if this is a binary of text frame + if (binaryFrame) { // binary frame - run_from_bytes(message.data); - } else { + run_from_bytes(messageData); + } + else { // text frame + + let decoder = new TextDecoder("utf-8"); + + // Using decode method to get string output + let str = decoder.decode(messageData); // Ignore pongs - if (message.data != "__pong__") { - const event = JSON.parse(message.data); + if (str != "__pong__") { + const event = JSON.parse(str); switch (event.type) { - case "edits": - let edits = event.data; - window.interpreter.handleEdits(edits); - break; case "query": Function("Eval", `"use strict";${event.data};`)(); break; diff --git a/packages/liveview/src/pool.rs b/packages/liveview/src/pool.rs index a74c183df..64adfa3d1 100644 --- a/packages/liveview/src/pool.rs +++ b/packages/liveview/src/pool.rs @@ -6,7 +6,7 @@ use crate::{ }; use dioxus_core::{prelude::*, BorrowedAttributeValue, Mutations}; use dioxus_html::{event_bubbles, EventData, HtmlEvent, MountedData}; -use dioxus_interpreter_js::Channel; +use dioxus_interpreter_js::binary_protocol::Channel; use futures_util::{pin_mut, SinkExt, StreamExt}; use rustc_hash::FxHashMap; use serde::Serialize; @@ -173,7 +173,7 @@ pub async fn run(mut vdom: VirtualDom, ws: impl LiveViewSocket) -> Result<(), Li match evt.as_ref().map(|o| o.as_deref()) { // respond with a pong every ping to keep the websocket alive Some(Ok(b"__ping__")) => { - // ws.send(b"__pong__".to_vec()).await?; + ws.send(text_frame("__pong__")).await?; } Some(Ok(evt)) => { if let Ok(message) = serde_json::from_str::(&String::from_utf8_lossy(evt)) { @@ -212,7 +212,7 @@ pub async fn run(mut vdom: VirtualDom, ws: impl LiveViewSocket) -> Result<(), Li // handle any new queries Some(query) = query_rx.recv() => { - // ws.send(serde_json::to_string(&ClientUpdate::Query(query)).unwrap().into_bytes()).await?; + ws.send(text_frame(&serde_json::to_string(&ClientUpdate::Query(query)).unwrap())).await?; } Some(msg) = hot_reload_wait => { @@ -247,13 +247,19 @@ pub async fn run(mut vdom: VirtualDom, ws: impl LiveViewSocket) -> Result<(), Li } } +fn text_frame(text: &str) -> Vec { + let mut bytes = vec![0]; + bytes.extend(text.as_bytes()); + bytes +} + fn add_template( template: &Template<'static>, channel: &mut Channel, templates: &mut FxHashMap, max_template_count: &mut u16, ) { - for (idx, root) in template.roots.iter().enumerate() { + for root in template.roots.iter() { create_template_node(channel, root); templates.insert(template.name.to_owned(), *max_template_count); } @@ -368,16 +374,16 @@ fn apply_edits( } } - let bytes: Vec<_> = channel.export_memory().collect(); + // Add an extra one at the beginning to tell the shim this is a binary frame + let mut bytes = vec![1]; + bytes.extend(channel.export_memory()); channel.reset(); Some(bytes) } #[derive(Serialize)] #[serde(tag = "type", content = "data")] -enum ClientUpdate<'a> { - #[serde(rename = "edits")] - Edits(Mutations<'a>), +enum ClientUpdate { #[serde(rename = "query")] Query(String), } From 007aacc24706061128f56a72b108688281e24c17 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Thu, 19 Oct 2023 16:41:47 -0500 Subject: [PATCH 194/447] remove liveview logging --- packages/liveview/src/main.js | 1 - 1 file changed, 1 deletion(-) diff --git a/packages/liveview/src/main.js b/packages/liveview/src/main.js index 54b575263..0c60386e3 100644 --- a/packages/liveview/src/main.js +++ b/packages/liveview/src/main.js @@ -28,7 +28,6 @@ class IPC { }; ws.onmessage = (message) => { - console.log(message.data); const u8view = new Uint8Array(message.data); const binaryFrame = u8view[0] == 1; const messageData = message.data.slice(1) From 378cbfabd9234892f357b31dc21f972b127a4020 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Fri, 20 Oct 2023 08:45:04 -0500 Subject: [PATCH 195/447] fix desktop mounted event --- packages/desktop/src/element.rs | 6 +- packages/desktop/src/lib.rs | 2 +- packages/interpreter/src/interpreter.js | 121 +----------------- .../interpreter/src/sledgehammer_bindings.rs | 5 +- packages/liveview/src/element.rs | 9 +- 5 files changed, 17 insertions(+), 126 deletions(-) diff --git a/packages/desktop/src/element.rs b/packages/desktop/src/element.rs index 20ca951bf..b5f12c3f2 100644 --- a/packages/desktop/src/element.rs +++ b/packages/desktop/src/element.rs @@ -30,7 +30,7 @@ impl RenderedElementBacking for DesktopElement { >, >, > { - let script = format!("return window.interpreter.GetClientRect({});", self.id.0); + let script = format!("return window.interpreter.getClientRect({});", self.id.0); let fut = self .query @@ -54,7 +54,7 @@ impl RenderedElementBacking for DesktopElement { behavior: dioxus_html::ScrollBehavior, ) -> std::pin::Pin>>> { let script = format!( - "return window.interpreter.ScrollTo({}, {});", + "return window.interpreter.scrollTo({}, {});", self.id.0, serde_json::to_string(&behavior).expect("Failed to serialize ScrollBehavior") ); @@ -81,7 +81,7 @@ impl RenderedElementBacking for DesktopElement { focus: bool, ) -> std::pin::Pin>>> { let script = format!( - "return window.interpreter.SetFocus({}, {});", + "return window.interpreter.setFocus({}, {});", self.id.0, focus ); diff --git a/packages/desktop/src/lib.rs b/packages/desktop/src/lib.rs index 406d6ffb8..b092ceeec 100644 --- a/packages/desktop/src/lib.rs +++ b/packages/desktop/src/lib.rs @@ -29,7 +29,7 @@ use desktop_context::{EventData, UserWindowEvent, WebviewQueue, WindowEventHandl use dioxus_core::*; use dioxus_html::{event_bubbles, MountedData}; use dioxus_html::{native_bind::NativeFileEngine, FormData, HtmlEvent}; -use dioxus_interpreter_js::Channel; +use dioxus_interpreter_js::binary_protocol::Channel; use element::DesktopElement; use eval::init_eval; use futures_util::{pin_mut, FutureExt}; diff --git a/packages/interpreter/src/interpreter.js b/packages/interpreter/src/interpreter.js index aaeb3a871..b5f80a377 100644 --- a/packages/interpreter/src/interpreter.js +++ b/packages/interpreter/src/interpreter.js @@ -1,5 +1,3 @@ -import { setAttributeInner } from "./common.js"; - class InterpreterConfig { constructor(intercept_link_redirects) { this.intercept_link_redirects = intercept_link_redirects; @@ -215,45 +213,6 @@ class ListenerMap { delete this.local[id]; } } -function SetAttributeInner(node, field, value, ns) { - const name = field; - if (ns === "style") { - // ????? why do we need to do this - if (node.style === undefined) { - node.style = {}; - } - node.style[name] = value; - } else if (ns !== null && ns !== undefined && ns !== "") { - node.setAttributeNS(ns, name, value); - } else { - switch (name) { - case "value": - if (value !== node.value) { - node.value = value; - } - break; - case "initial_value": - node.defaultValue = value; - break; - case "checked": - node.checked = truthy(value); - break; - case "selected": - node.selected = truthy(value); - break; - case "dangerous_inner_html": - node.innerHTML = value; - break; - default: - // https://github.com/facebook/react/blob/8b88ac2592c5f555f315f9440cbb665dd1e7457a/packages/react-dom/src/shared/DOMProperty.js#L352-L364 - if (!truthy(value) && bool_attrs.hasOwnProperty(name)) { - node.removeAttribute(name); - } else { - node.setAttribute(name, value); - } - } - } -} function LoadChild(array) { // iterate through each number and get that child node = stack[stack.length - 1]; @@ -284,41 +243,10 @@ function AppendChildren(id, many) { root.appendChild(els[k]); } } -const bool_attrs = { - allowfullscreen: true, - allowpaymentrequest: true, - async: true, - autofocus: true, - autoplay: true, - checked: true, - controls: true, - default: true, - defer: true, - disabled: true, - formnovalidate: true, - hidden: true, - ismap: true, - itemscope: true, - loop: true, - multiple: true, - muted: true, - nomodule: true, - novalidate: true, - open: true, - playsinline: true, - readonly: true, - required: true, - reversed: true, - selected: true, - truespeed: true, - webkitdirectory: true, -}; -function truthy(val) { - return val === "true" || val === true; -} +window.interpreter = {} -function getClientRect(id) { +window.interpreter.getClientRect = function (id) { const node = nodes[id]; if (!node) { return; @@ -331,7 +259,7 @@ function getClientRect(id) { }; } -function scrollTo(id, behavior) { +window.interpreter.scrollTo = function (id, behavior) { const node = nodes[id]; if (!node) { return false; @@ -343,7 +271,7 @@ function scrollTo(id, behavior) { } /// Set the focus on the element -function setFocus(id, focus) { +window.interpreter.setFocus = function (id, focus) { const node = nodes[id]; if (!node) { return false; @@ -356,47 +284,6 @@ function setFocus(id, focus) { return true; } -function saveTemplate(template) { - let roots = []; - for (let root of template.roots) { - roots.push(this.MakeTemplateNode(root)); - } - this.templates[template.name] = roots; -} - -function makeTemplateNode(node) { - switch (node.type) { - case "Text": - return document.createTextNode(node.text); - case "Dynamic": - let dyn = document.createElement("pre"); - dyn.hidden = true; - return dyn; - case "DynamicText": - return document.createTextNode("placeholder"); - case "Element": - let el; - - if (node.namespace != null) { - el = document.createElementNS(node.namespace, node.tag); - } else { - el = document.createElement(node.tag); - } - - for (let attr of node.attrs) { - if (attr.type == "Static") { - setAttributeInner(el, attr.name, attr.value, attr.namespace); - } - } - - for (let child of node.children) { - el.appendChild(this.MakeTemplateNode(child)); - } - - return el; - } -} - function get_mouse_data(event) { const { altKey, diff --git a/packages/interpreter/src/sledgehammer_bindings.rs b/packages/interpreter/src/sledgehammer_bindings.rs index ac1fbf5f0..4203f4d15 100644 --- a/packages/interpreter/src/sledgehammer_bindings.rs +++ b/packages/interpreter/src/sledgehammer_bindings.rs @@ -296,6 +296,7 @@ pub mod binary_protocol { #[bindgen] mod protocol_js { const JS_FILE: &str = "./packages/interpreter/src/interpreter.js"; + const JS_FILE: &str = "./packages/interpreter/src/common.js"; fn mount_to_root() { "{AppendChildren(root, stack.length-1);}" @@ -382,10 +383,10 @@ pub mod binary_protocol { "{nodes[$id$].textContent = $text$;}" } fn set_attribute(id: u32, field: &str, value: &str, ns: &str) { - "{node = nodes[$id$]; SetAttributeInner(node, $field$, $value$, $ns$);}" + "{node = nodes[$id$]; setAttributeInner(node, $field$, $value$, $ns$);}" } fn set_top_attribute(field: &str, value: &str, ns: &str) { - "{SetAttributeInner(stack[stack.length-1], $field$, $value$, $ns$);}" + "{setAttributeInner(stack[stack.length-1], $field$, $value$, $ns$);}" } fn remove_attribute(id: u32, field: &str, ns: &str) { r#"{ diff --git a/packages/liveview/src/element.rs b/packages/liveview/src/element.rs index 6fb1fb436..600f7f20d 100644 --- a/packages/liveview/src/element.rs +++ b/packages/liveview/src/element.rs @@ -29,7 +29,7 @@ impl RenderedElementBacking for LiveviewElement { >, >, > { - let script = format!("return getClientRect({});", self.id.0); + let script = format!("return window.interpreter.getClientRect({});", self.id.0); let fut = self .query @@ -53,7 +53,7 @@ impl RenderedElementBacking for LiveviewElement { behavior: dioxus_html::ScrollBehavior, ) -> std::pin::Pin>>> { let script = format!( - "return scrollTo({}, {});", + "return window.interpreter.scrollTo({}, {});", self.id.0, serde_json::to_string(&behavior).expect("Failed to serialize ScrollBehavior") ); @@ -76,7 +76,10 @@ impl RenderedElementBacking for LiveviewElement { &self, focus: bool, ) -> std::pin::Pin>>> { - let script = format!("return setFocus({}, {});", self.id.0, focus); + let script = format!( + "return window.interpreter.setFocus({}, {});", + self.id.0, focus + ); let fut = self.query.new_query::(&script).resolve(); From 2404bfeeb3a863bc6cd01105d22a9ca6c178c7ff Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Fri, 20 Oct 2023 09:06:19 -0500 Subject: [PATCH 196/447] fix liveview element --- packages/desktop/build.rs | 4 +++- packages/liveview/build.rs | 5 +++-- packages/liveview/src/query.rs | 5 +---- 3 files changed, 7 insertions(+), 7 deletions(-) diff --git a/packages/desktop/build.rs b/packages/desktop/build.rs index bd7445637..770ebd2d6 100644 --- a/packages/desktop/build.rs +++ b/packages/desktop/build.rs @@ -26,7 +26,9 @@ fn main() { } } }"#; - let mut interpreter = SLEDGEHAMMER_JS.replace("/*POST_HANDLE_EDITS*/", prevent_file_upload); + let mut interpreter = SLEDGEHAMMER_JS + .replace("/*POST_HANDLE_EDITS*/", prevent_file_upload) + .replace("export", ""); while let Some(import_start) = interpreter.find("import") { let import_end = interpreter[import_start..] .find(|c| c == ';' || c == '\n') diff --git a/packages/liveview/build.rs b/packages/liveview/build.rs index b62a09da0..824bc4f70 100644 --- a/packages/liveview/build.rs +++ b/packages/liveview/build.rs @@ -40,8 +40,9 @@ fn main() { return; } }"#; - let mut interpreter = - SLEDGEHAMMER_JS.replace("/*POST_EVENT_SERIALIZATION*/", serialize_file_uploads); + let mut interpreter = SLEDGEHAMMER_JS + .replace("/*POST_EVENT_SERIALIZATION*/", serialize_file_uploads) + .replace("export", ""); while let Some(import_start) = interpreter.find("import") { let import_end = interpreter[import_start..] .find(|c| c == ';' || c == '\n') diff --git a/packages/liveview/src/query.rs b/packages/liveview/src/query.rs index a638625c1..c99dd5151 100644 --- a/packages/liveview/src/query.rs +++ b/packages/liveview/src/query.rs @@ -169,10 +169,7 @@ pub(crate) struct Query { impl Query { /// Resolve the query pub async fn resolve(mut self) -> Result { - match self.receiver.recv().await { - Some(result) => V::deserialize(result).map_err(QueryError::Deserialize), - None => Err(QueryError::Recv(RecvError::Closed)), - } + V::deserialize(self.result().await?).map_err(QueryError::Deserialize) } /// Send a message to the query From 1d664c616eada1119274358ebe3de2215bdab352 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Fri, 20 Oct 2023 09:18:16 -0500 Subject: [PATCH 197/447] restore desktop/liveview minification --- packages/desktop/build.rs | 33 ++++++++++++------- packages/desktop/src/protocol.rs | 18 ++-------- packages/interpreter/src/interpreter.js | 20 ++++++----- .../interpreter/src/sledgehammer_bindings.rs | 2 +- packages/liveview/build.rs | 10 +++--- packages/liveview/src/main.js | 4 +-- 6 files changed, 43 insertions(+), 44 deletions(-) diff --git a/packages/desktop/build.rs b/packages/desktop/build.rs index 770ebd2d6..8be7761c0 100644 --- a/packages/desktop/build.rs +++ b/packages/desktop/build.rs @@ -16,7 +16,7 @@ fn main() { let target_id = find_real_id(target); if (target_id !== null) { const send = (event_name) => { - const message = serializeIpcMessage("file_diolog", { accept: target.getAttribute("accept"), directory: target.getAttribute("webkitdirectory") === "true", multiple: target.hasAttribute("multiple"), target: parseInt(target_id), bubbles: event_bubbles(event_name), event: event_name }); + const message = window.interpreter.serializeIpcMessage("file_diolog", { accept: target.getAttribute("accept"), directory: target.getAttribute("webkitdirectory") === "true", multiple: target.hasAttribute("multiple"), target: parseInt(target_id), bubbles: event_bubbles(event_name), event: event_name }); window.ipc.postMessage(message); }; send("change&input"); @@ -26,9 +26,21 @@ fn main() { } } }"#; + let polling_request = r#"// Poll for requests + window.interpreter.wait_for_request = () => { + fetch(new Request("dioxus://index.html/edits")) + .then(response => { + response.arrayBuffer() + .then(bytes => { + run_from_bytes(bytes); + window.interpreter.wait_for_request(); + }); + }) + }"#; let mut interpreter = SLEDGEHAMMER_JS .replace("/*POST_HANDLE_EDITS*/", prevent_file_upload) - .replace("export", ""); + .replace("export", "") + + polling_request; while let Some(import_start) = interpreter.find("import") { let import_end = interpreter[import_start..] .find(|c| c == ';' || c == '\n') @@ -38,15 +50,12 @@ fn main() { } let js = format!("{interpreter}\nconst config = new InterpreterConfig(false);"); - let mut file = std::fs::File::create("src/minified.js").unwrap(); - file.write_all(js.as_bytes()).unwrap(); - // TODO: Enable minification on desktop - // use minify_js::*; - // let session = Session::new(); - // let mut out = Vec::new(); - // minify(&session, TopLevelMode::Module, js.as_bytes(), &mut out).unwrap(); - // let minified = String::from_utf8(out).unwrap(); - // let mut file = std::fs::File::create("src/minified.js").unwrap(); - // file.write_all(minified.as_bytes()).unwrap(); + use minify_js::*; + let session = Session::new(); + let mut out = Vec::new(); + minify(&session, TopLevelMode::Module, js.as_bytes(), &mut out).unwrap(); + let minified = String::from_utf8(out).unwrap(); + let mut file = std::fs::File::create("src/minified.js").unwrap(); + file.write_all(minified.as_bytes()).unwrap(); } diff --git a/packages/desktop/src/protocol.rs b/packages/desktop/src/protocol.rs index f8ba940f4..41a491749 100644 --- a/packages/desktop/src/protocol.rs +++ b/packages/desktop/src/protocol.rs @@ -17,27 +17,15 @@ fn module_loader(root_name: &str) -> String { r#" "# diff --git a/packages/interpreter/src/interpreter.js b/packages/interpreter/src/interpreter.js index b5f80a377..54f1d517c 100644 --- a/packages/interpreter/src/interpreter.js +++ b/packages/interpreter/src/interpreter.js @@ -35,7 +35,7 @@ function handler(event, name, bubbles, config) { const href = a_element.getAttribute("href"); if (href !== "" && href !== null && href !== undefined) { window.ipc.postMessage( - serializeIpcMessage("browser_open", { href }) + window.interpreter.serializeIpcMessage("browser_open", { href }) ); } } @@ -89,7 +89,7 @@ function handler(event, name, bubbles, config) { if (realId === null) { return; } - const message = serializeIpcMessage("user_event", { + const message = window.interpreter.serializeIpcMessage("user_event", { name: name, element: parseInt(realId), data: contents, @@ -132,7 +132,7 @@ function handler(event, name, bubbles, config) { return; } window.ipc.postMessage( - serializeIpcMessage("user_event", { + window.interpreter.serializeIpcMessage("user_event", { name: name, element: parseInt(realId), data: contents, @@ -231,11 +231,7 @@ let stack = []; let root; const templates = {}; let node, els, end, k; -function initialize(root) { - nodes = [root]; - stack = [root]; - listeners.root = root; -} + function AppendChildren(id, many) { root = nodes[id]; els = stack.splice(stack.length - many); @@ -246,6 +242,12 @@ function AppendChildren(id, many) { window.interpreter = {} +window.interpreter.initialize = function (root) { + nodes = [root]; + stack = [root]; + listeners.root = root; +} + window.interpreter.getClientRect = function (id) { const node = nodes[id]; if (!node) { @@ -560,7 +562,7 @@ function serialize_event(event) { } } } -function serializeIpcMessage(method, params = {}) { +window.interpreter.serializeIpcMessage = function (method, params = {}) { return JSON.stringify({ method, params }); } diff --git a/packages/interpreter/src/sledgehammer_bindings.rs b/packages/interpreter/src/sledgehammer_bindings.rs index 4203f4d15..e0d4f7045 100644 --- a/packages/interpreter/src/sledgehammer_bindings.rs +++ b/packages/interpreter/src/sledgehammer_bindings.rs @@ -363,7 +363,7 @@ pub mod binary_protocol { // if this is a mounted listener, we send the event immediately if (event_name === "mounted") { window.ipc.postMessage( - serializeIpcMessage("user_event", { + window.interpreter.serializeIpcMessage("user_event", { name: event_name, element: id, data: null, diff --git a/packages/liveview/build.rs b/packages/liveview/build.rs index 824bc4f70..d4dbeb09a 100644 --- a/packages/liveview/build.rs +++ b/packages/liveview/build.rs @@ -28,7 +28,7 @@ fn main() { if (realId === null) { return; } - const message = serializeIpcMessage("user_event", { + const message = window.interpreter.serializeIpcMessage("user_event", { name: name, element: parseInt(realId), data: contents, @@ -56,9 +56,9 @@ fn main() { let js = format!("{interpreter}\n{main_js}"); let session = Session::new(); - // let mut out = Vec::new(); - // minify(&session, TopLevelMode::Module, js.as_bytes(), &mut out).unwrap(); - // let minified = String::from_utf8(out).unwrap(); + let mut out = Vec::new(); + minify(&session, TopLevelMode::Module, js.as_bytes(), &mut out).unwrap(); + let minified = String::from_utf8(out).unwrap(); let mut file = std::fs::File::create("src/minified.js").unwrap(); - file.write_all(js.as_bytes()).unwrap(); + file.write_all(minified.as_bytes()).unwrap(); } diff --git a/packages/liveview/src/main.js b/packages/liveview/src/main.js index 0c60386e3..22267dbab 100644 --- a/packages/liveview/src/main.js +++ b/packages/liveview/src/main.js @@ -9,7 +9,7 @@ function main() { class IPC { constructor(root) { - initialize(root); + window.interpreter.initialize(root); const ws = new WebSocket(WS_ADDR); ws.binaryType = "arraybuffer"; @@ -20,7 +20,7 @@ class IPC { ws.onopen = () => { // we ping every 30 seconds to keep the websocket alive setInterval(ping, 30000); - ws.send(serializeIpcMessage("initialize")); + ws.send(window.interpreter.serializeIpcMessage("initialize")); }; ws.onerror = (err) => { From 33f0f0c17206b02424562f192e7436ddaae2dc1c Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Fri, 20 Oct 2023 09:38:10 -0500 Subject: [PATCH 198/447] fix clippy --- packages/cli/src/builder.rs | 2 +- packages/core/src/scope_context.rs | 2 +- packages/desktop/src/lib.rs | 2 +- packages/desktop/src/protocol.rs | 3 +-- packages/interpreter/Cargo.toml | 2 +- packages/liveview/src/pool.rs | 2 +- packages/server-macro/src/lib.rs | 2 +- packages/web/Cargo.toml | 1 - 8 files changed, 7 insertions(+), 9 deletions(-) diff --git a/packages/cli/src/builder.rs b/packages/cli/src/builder.rs index c4d1bde6f..fd3202d2e 100644 --- a/packages/cli/src/builder.rs +++ b/packages/cli/src/builder.rs @@ -312,7 +312,7 @@ pub fn build_desktop(config: &CrateConfig, _is_serve: bool) -> Result() }) { return Some(shared.clone()); diff --git a/packages/desktop/src/lib.rs b/packages/desktop/src/lib.rs index b092ceeec..4780690ee 100644 --- a/packages/desktop/src/lib.rs +++ b/packages/desktop/src/lib.rs @@ -484,7 +484,7 @@ fn apply_edits( HydrateText { path, value, id } => channel.hydrate_text(path, value, id.0 as u32), LoadTemplate { name, index, id } => { if let Some(tmpl_id) = templates.get(name) { - channel.load_template(*tmpl_id as u16, index as u16, id.0 as u32) + channel.load_template(*tmpl_id, index as u16, id.0 as u32) } } ReplaceWith { id, m } => channel.replace_with(id.0 as u32, m as u16), diff --git a/packages/desktop/src/protocol.rs b/packages/desktop/src/protocol.rs index 41a491749..1dca21759 100644 --- a/packages/desktop/src/protocol.rs +++ b/packages/desktop/src/protocol.rs @@ -126,7 +126,6 @@ pub(super) fn desktop_handler( { Ok(response) => { responder.respond(response); - return; } Err(err) => tracing::error!("error building response: {}", err), } @@ -167,7 +166,7 @@ fn get_asset_root() -> Option { /// Get the mime type from a path-like string fn get_mime_from_path(trimmed: &Path) -> Result<&'static str> { - if trimmed.ends_with(".svg") { + if trimmed.extension().is_some_and(|ext| ext == "svg") { return Ok("image/svg+xml"); } diff --git a/packages/interpreter/Cargo.toml b/packages/interpreter/Cargo.toml index 8d155db6d..7d046fbc8 100644 --- a/packages/interpreter/Cargo.toml +++ b/packages/interpreter/Cargo.toml @@ -23,5 +23,5 @@ default = [] serialize = ["serde"] sledgehammer = ["sledgehammer_bindgen", "sledgehammer_utils"] web = ["sledgehammer", "wasm-bindgen", "js-sys", "web-sys", "sledgehammer_bindgen/web"] -binary-protocol = ["sledgehammer"] +binary-protocol = ["sledgehammer", "wasm-bindgen"] minimal_bindings = [] diff --git a/packages/liveview/src/pool.rs b/packages/liveview/src/pool.rs index 64adfa3d1..eaf699248 100644 --- a/packages/liveview/src/pool.rs +++ b/packages/liveview/src/pool.rs @@ -329,7 +329,7 @@ fn apply_edits( HydrateText { path, value, id } => channel.hydrate_text(path, value, id.0 as u32), LoadTemplate { name, index, id } => { if let Some(tmpl_id) = templates.get(name) { - channel.load_template(*tmpl_id as u16, index as u16, id.0 as u32) + channel.load_template(*tmpl_id, index as u16, id.0 as u32) } } ReplaceWith { id, m } => channel.replace_with(id.0 as u32, m as u16), diff --git a/packages/server-macro/src/lib.rs b/packages/server-macro/src/lib.rs index d00c009d0..2afa19742 100644 --- a/packages/server-macro/src/lib.rs +++ b/packages/server-macro/src/lib.rs @@ -105,7 +105,7 @@ pub fn server(args: proc_macro::TokenStream, s: TokenStream) -> TokenStream { let upper_cammel_case_name = Converter::new() .from_case(Case::Snake) .to_case(Case::UpperCamel) - .convert(&sig.ident.to_string()); + .convert(sig.ident.to_string()); args.struct_name = Some(Ident::new(&upper_cammel_case_name, sig.ident.span())); } let struct_name = args.struct_name.as_ref().unwrap(); diff --git a/packages/web/Cargo.toml b/packages/web/Cargo.toml index 428815576..a21acded7 100644 --- a/packages/web/Cargo.toml +++ b/packages/web/Cargo.toml @@ -13,7 +13,6 @@ keywords = ["dom", "ui", "gui", "react", "wasm"] dioxus-core = { workspace = true, features = ["serialize"] } dioxus-html = { workspace = true, features = ["wasm-bind"] } dioxus-interpreter-js = { workspace = true, features = [ - "sledgehammer", "minimal_bindings", "web", ] } From b836851d0282f63d469165bf6cfdc730fdf7779f Mon Sep 17 00:00:00 2001 From: Stygmates Date: Fri, 20 Oct 2023 19:43:24 +0200 Subject: [PATCH 199/447] Add openidconnect authentication demo (#1500) * Add openidconnect authentication demo * use_atom_ref usage to have a read/write handle on the atom * Use default * Code rewrite to better reflect the authentication flow * Use the env macro instead of the build.rs to load env variables * Add env variables * Remove unnecessary dependency * Add env variables to the root workspace * Update readme * Bump openidconnect version * Use props to pass the client to the child components * Code clean up --------- Co-authored-by: Truong Tan Dat --- .cargo/config.toml | 5 + Cargo.toml | 1 + examples/openid_connect_demo/.gitignore | 3 + examples/openid_connect_demo/Cargo.toml | 24 ++ examples/openid_connect_demo/Dioxus.toml | 47 ++++ examples/openid_connect_demo/README.md | 13 + examples/openid_connect_demo/src/constants.rs | 2 + examples/openid_connect_demo/src/errors.rs | 20 ++ examples/openid_connect_demo/src/main.rs | 60 +++++ examples/openid_connect_demo/src/model/mod.rs | 1 + .../openid_connect_demo/src/model/user.rs | 7 + examples/openid_connect_demo/src/oidc.rs | 125 +++++++++ .../openid_connect_demo/src/props/client.rs | 20 ++ examples/openid_connect_demo/src/props/mod.rs | 1 + examples/openid_connect_demo/src/router.rs | 17 ++ examples/openid_connect_demo/src/storage.rs | 38 +++ .../openid_connect_demo/src/views/header.rs | 250 ++++++++++++++++++ .../openid_connect_demo/src/views/home.rs | 5 + .../openid_connect_demo/src/views/login.rs | 86 ++++++ examples/openid_connect_demo/src/views/mod.rs | 4 + .../src/views/not_found.rs | 7 + 21 files changed, 736 insertions(+) create mode 100644 .cargo/config.toml create mode 100644 examples/openid_connect_demo/.gitignore create mode 100644 examples/openid_connect_demo/Cargo.toml create mode 100644 examples/openid_connect_demo/Dioxus.toml create mode 100644 examples/openid_connect_demo/README.md create mode 100644 examples/openid_connect_demo/src/constants.rs create mode 100644 examples/openid_connect_demo/src/errors.rs create mode 100644 examples/openid_connect_demo/src/main.rs create mode 100644 examples/openid_connect_demo/src/model/mod.rs create mode 100644 examples/openid_connect_demo/src/model/user.rs create mode 100644 examples/openid_connect_demo/src/oidc.rs create mode 100644 examples/openid_connect_demo/src/props/client.rs create mode 100644 examples/openid_connect_demo/src/props/mod.rs create mode 100644 examples/openid_connect_demo/src/router.rs create mode 100644 examples/openid_connect_demo/src/storage.rs create mode 100644 examples/openid_connect_demo/src/views/header.rs create mode 100644 examples/openid_connect_demo/src/views/home.rs create mode 100644 examples/openid_connect_demo/src/views/login.rs create mode 100644 examples/openid_connect_demo/src/views/mod.rs create mode 100644 examples/openid_connect_demo/src/views/not_found.rs diff --git a/.cargo/config.toml b/.cargo/config.toml new file mode 100644 index 000000000..464189e01 --- /dev/null +++ b/.cargo/config.toml @@ -0,0 +1,5 @@ +# All of these variables are used in the `openid_connect_demo` example, they are set here for the CI to work, they are set here because as stated here for now: `https://doc.rust-lang.org/cargo/reference/config.html` the .cargo/config.toml of the inner workspaces are not read when being invoked from the root workspace. +[env] +DIOXUS_FRONT_ISSUER_URL = "" +DIOXUS_FRONT_CLIENT_ID = "" +DIOXUS_FRONT_URL = "" diff --git a/Cargo.toml b/Cargo.toml index e6b07eb8c..a78f60d3e 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -41,6 +41,7 @@ members = [ "examples/tailwind", "examples/PWA-example", "examples/query_segments_demo", + "examples/openid_connect_demo", # Playwright tests "playwright-tests/liveview", "playwright-tests/web", diff --git a/examples/openid_connect_demo/.gitignore b/examples/openid_connect_demo/.gitignore new file mode 100644 index 000000000..919c8ee55 --- /dev/null +++ b/examples/openid_connect_demo/.gitignore @@ -0,0 +1,3 @@ +/target +/dist +.env diff --git a/examples/openid_connect_demo/Cargo.toml b/examples/openid_connect_demo/Cargo.toml new file mode 100644 index 000000000..4c5f47061 --- /dev/null +++ b/examples/openid_connect_demo/Cargo.toml @@ -0,0 +1,24 @@ +[package] +name = "openid_auth_demo" +version = "0.1.0" +edition = "2021" + +# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html + +[dependencies] +console_error_panic_hook = "0.1" +dioxus-logger = "0.4.1" +dioxus = { path = "../../packages/dioxus", version = "*" } +dioxus-router = { path = "../../packages/router", version = "*" } +dioxus-web = { path = "../../packages/web", version = "*" } +fermi = { path = "../../packages/fermi", version = "*" } +form_urlencoded = "1.2.0" +gloo-storage = "0.3.0" +log = "0.4" +openidconnect = "3.4.0" +reqwest = "0.11.20" +serde = { version = "1.0.188", features = ["derive"] } +serde_json = "1.0.105" +thiserror = "1.0.48" +uuid = "1.4" +web-sys = { version = "0.3", features = ["Request", "Document"] } diff --git a/examples/openid_connect_demo/Dioxus.toml b/examples/openid_connect_demo/Dioxus.toml new file mode 100644 index 000000000..483dfe957 --- /dev/null +++ b/examples/openid_connect_demo/Dioxus.toml @@ -0,0 +1,47 @@ +[application] + +# dioxus project name +name = "OpenID Connect authentication demo" + +# default platfrom +# you can also use `dioxus serve/build --platform XXX` to use other platform +# value: web | desktop +default_platform = "web" + +# Web `build` & `serve` dist path +out_dir = "dist" + +# resource (static) file folder +asset_dir = "public" + +[web.app] + +# HTML title tag content +title = "OpenID Connect authentication demo" + +[web.watcher] + +index_on_404 = true + +watch_path = ["src"] + +# include `assets` in web platform +[web.resource] + +# CSS style file +style = [] + +# Javascript code file +script = [] + +[web.resource.dev] + +# Javascript code file +# serve: [dev-server] only +script = [] + +[application.plugins] + +available = true + +required = [] diff --git a/examples/openid_connect_demo/README.md b/examples/openid_connect_demo/README.md new file mode 100644 index 000000000..e16467ddf --- /dev/null +++ b/examples/openid_connect_demo/README.md @@ -0,0 +1,13 @@ +# OpenID Connect example to show how to authenticate an user + +The environment variables in `.cargo/config.toml` must be set in order for this example to work(if this example is just being compiled from the root workspace, the `.cargo/config.toml` from the root workspace must be set as stated in the [Cargo book](https://doc.rust-lang.org/cargo/reference/config.html)). + +Once they are set, you can run `dx serve` + +### Environment variables summary + +```DIOXUS_FRONT_ISSUER_URL``` The openid-connect's issuer url + +```DIOXUS_FRONT_CLIENT_ID``` The openid-connect's client id + +```DIOXUS_FRONT_URL``` The url the frontend is supposed to be running on, it could be for example `http://localhost:8080` \ No newline at end of file diff --git a/examples/openid_connect_demo/src/constants.rs b/examples/openid_connect_demo/src/constants.rs new file mode 100644 index 000000000..0a0b4950a --- /dev/null +++ b/examples/openid_connect_demo/src/constants.rs @@ -0,0 +1,2 @@ +pub const DIOXUS_FRONT_AUTH_TOKEN: &str = "auth_token"; +pub const DIOXUS_FRONT_AUTH_REQUEST: &str = "auth_request"; diff --git a/examples/openid_connect_demo/src/errors.rs b/examples/openid_connect_demo/src/errors.rs new file mode 100644 index 000000000..2b7e3f145 --- /dev/null +++ b/examples/openid_connect_demo/src/errors.rs @@ -0,0 +1,20 @@ +use openidconnect::{core::CoreErrorResponseType, url, RequestTokenError, StandardErrorResponse}; +use thiserror::Error; + +#[derive(Error, Debug)] +pub enum Error { + #[error("Discovery error: {0}")] + OpenIdConnect( + #[from] openidconnect::DiscoveryError>, + ), + #[error("Parsing error: {0}")] + Parse(#[from] url::ParseError), + #[error("Request token error: {0}")] + RequestToken( + #[from] + RequestTokenError< + openidconnect::reqwest::Error, + StandardErrorResponse, + >, + ), +} diff --git a/examples/openid_connect_demo/src/main.rs b/examples/openid_connect_demo/src/main.rs new file mode 100644 index 000000000..7ed8db8a9 --- /dev/null +++ b/examples/openid_connect_demo/src/main.rs @@ -0,0 +1,60 @@ +#![allow(non_snake_case)] +use dioxus::prelude::*; +use fermi::*; +use gloo_storage::{LocalStorage, Storage}; +use log::LevelFilter; +pub(crate) mod constants; +pub(crate) mod errors; +pub(crate) mod model; +pub(crate) mod oidc; +pub(crate) mod props; +pub(crate) mod router; +pub(crate) mod storage; +pub(crate) mod views; +use oidc::{AuthRequestState, AuthTokenState}; +use router::Route; + +use dioxus_router::prelude::*; + +use crate::{ + constants::{DIOXUS_FRONT_AUTH_REQUEST, DIOXUS_FRONT_AUTH_TOKEN}, + oidc::ClientState, +}; +pub static FERMI_CLIENT: fermi::AtomRef = AtomRef(|_| ClientState::default()); + +// An option is required to prevent the component from being constantly refreshed +pub static FERMI_AUTH_TOKEN: fermi::AtomRef> = AtomRef(|_| None); +pub static FERMI_AUTH_REQUEST: fermi::AtomRef> = AtomRef(|_| None); + +pub static DIOXUS_FRONT_ISSUER_URL: &str = env!("DIOXUS_FRONT_ISSUER_URL"); +pub static DIOXUS_FRONT_CLIENT_ID: &str = env!("DIOXUS_FRONT_CLIENT_ID"); +pub static DIOXUS_FRONT_URL: &str = env!("DIOXUS_FRONT_URL"); + +fn App(cx: Scope) -> Element { + use_init_atom_root(cx); + + // Retrieve the value stored in the browser's storage + let stored_auth_token = LocalStorage::get(DIOXUS_FRONT_AUTH_TOKEN) + .ok() + .unwrap_or(AuthTokenState::default()); + let fermi_auth_token = use_atom_ref(cx, &FERMI_AUTH_TOKEN); + if fermi_auth_token.read().is_none() { + *fermi_auth_token.write() = Some(stored_auth_token); + } + + let stored_auth_request = LocalStorage::get(DIOXUS_FRONT_AUTH_REQUEST) + .ok() + .unwrap_or(AuthRequestState::default()); + let fermi_auth_request = use_atom_ref(cx, &FERMI_AUTH_REQUEST); + if fermi_auth_request.read().is_none() { + *fermi_auth_request.write() = Some(stored_auth_request); + } + render! { Router:: {} } +} + +fn main() { + dioxus_logger::init(LevelFilter::Info).expect("failed to init logger"); + console_error_panic_hook::set_once(); + log::info!("starting app"); + dioxus_web::launch(App); +} diff --git a/examples/openid_connect_demo/src/model/mod.rs b/examples/openid_connect_demo/src/model/mod.rs new file mode 100644 index 000000000..68a79f5c0 --- /dev/null +++ b/examples/openid_connect_demo/src/model/mod.rs @@ -0,0 +1 @@ +pub(crate) mod user; diff --git a/examples/openid_connect_demo/src/model/user.rs b/examples/openid_connect_demo/src/model/user.rs new file mode 100644 index 000000000..b1005fdd2 --- /dev/null +++ b/examples/openid_connect_demo/src/model/user.rs @@ -0,0 +1,7 @@ +use uuid::Uuid; + +#[derive(PartialEq)] +pub struct User { + pub id: Uuid, + pub name: String, +} diff --git a/examples/openid_connect_demo/src/oidc.rs b/examples/openid_connect_demo/src/oidc.rs new file mode 100644 index 000000000..7fa96c14b --- /dev/null +++ b/examples/openid_connect_demo/src/oidc.rs @@ -0,0 +1,125 @@ +use openidconnect::{ + core::{CoreClient, CoreErrorResponseType, CoreIdToken, CoreResponseType, CoreTokenResponse}, + reqwest::async_http_client, + url::Url, + AuthenticationFlow, AuthorizationCode, ClaimsVerificationError, ClientId, CsrfToken, IssuerUrl, + LogoutRequest, Nonce, ProviderMetadataWithLogout, RedirectUrl, RefreshToken, RequestTokenError, + StandardErrorResponse, +}; +use serde::{Deserialize, Serialize}; + +use crate::{props::client::ClientProps, DIOXUS_FRONT_CLIENT_ID}; + +#[derive(Clone, Debug, Default)] +pub struct ClientState { + pub oidc_client: Option, +} + +/// State that holds the nonce and authorization url and the nonce generated to log in an user +#[derive(Clone, Deserialize, Serialize, Default)] +pub struct AuthRequestState { + pub auth_request: Option, +} + +#[derive(Clone, Deserialize, Serialize)] +pub struct AuthRequest { + pub nonce: Nonce, + pub authorize_url: String, +} + +/// State the tokens returned once the user is authenticated +#[derive(Debug, Deserialize, Serialize, Default, Clone)] +pub struct AuthTokenState { + /// Token used to identify the user + pub id_token: Option, + /// Token used to refresh the tokens if they expire + pub refresh_token: Option, +} + +pub fn email( + client: CoreClient, + id_token: CoreIdToken, + nonce: Nonce, +) -> Result { + match id_token.claims(&client.id_token_verifier(), &nonce) { + Ok(claims) => Ok(claims.clone().email().unwrap().to_string()), + Err(error) => Err(error), + } +} + +pub fn authorize_url(client: CoreClient) -> AuthRequest { + let (authorize_url, _csrf_state, nonce) = client + .authorize_url( + AuthenticationFlow::::AuthorizationCode, + CsrfToken::new_random, + Nonce::new_random, + ) + .add_scope(openidconnect::Scope::new("email".to_string())) + .add_scope(openidconnect::Scope::new("profile".to_string())) + .url(); + AuthRequest { + authorize_url: authorize_url.to_string(), + nonce, + } +} + +pub async fn init_provider_metadata() -> Result { + let issuer_url = IssuerUrl::new(crate::DIOXUS_FRONT_ISSUER_URL.to_string())?; + Ok(ProviderMetadataWithLogout::discover_async(issuer_url, async_http_client).await?) +} + +pub async fn init_oidc_client() -> Result<(ClientId, CoreClient), crate::errors::Error> { + let client_id = ClientId::new(crate::DIOXUS_FRONT_CLIENT_ID.to_string()); + let provider_metadata = init_provider_metadata().await?; + let client_secret = None; + let redirect_url = RedirectUrl::new(format!("{}/login", crate::DIOXUS_FRONT_URL))?; + + Ok(( + client_id.clone(), + CoreClient::from_provider_metadata(provider_metadata, client_id, client_secret) + .set_redirect_uri(redirect_url), + )) +} + +///TODO: Add pkce_pacifier +pub async fn token_response( + oidc_client: CoreClient, + code: String, +) -> Result { + // let (pkce_challenge, pkce_verifier) = PkceCodeChallenge::new_random_sha256(); + Ok(oidc_client + .exchange_code(AuthorizationCode::new(code.clone())) + // .set_pkce_verifier(pkce_verifier) + .request_async(async_http_client) + .await?) +} + +pub async fn exchange_refresh_token( + oidc_client: CoreClient, + refresh_token: RefreshToken, +) -> Result< + CoreTokenResponse, + RequestTokenError< + openidconnect::reqwest::Error, + StandardErrorResponse, + >, +> { + oidc_client + .exchange_refresh_token(&refresh_token) + .request_async(async_http_client) + .await +} + +pub async fn log_out_url(id_token_hint: CoreIdToken) -> Result { + let provider_metadata = init_provider_metadata().await?; + let end_session_url = provider_metadata + .additional_metadata() + .clone() + .end_session_endpoint + .unwrap(); + let logout_request: LogoutRequest = LogoutRequest::from(end_session_url); + Ok(logout_request + .set_client_id(ClientId::new(DIOXUS_FRONT_CLIENT_ID.to_string())) + .set_id_token_hint(&id_token_hint) + .http_get_url()) +} diff --git a/examples/openid_connect_demo/src/props/client.rs b/examples/openid_connect_demo/src/props/client.rs new file mode 100644 index 000000000..2e02111e1 --- /dev/null +++ b/examples/openid_connect_demo/src/props/client.rs @@ -0,0 +1,20 @@ +use dioxus::prelude::*; +use openidconnect::{core::CoreClient, ClientId}; + +#[derive(Props, Clone, Debug)] +pub struct ClientProps { + pub client: CoreClient, + pub client_id: ClientId, +} + +impl PartialEq for ClientProps { + fn eq(&self, other: &Self) -> bool { + self.client_id == other.client_id + } +} + +impl ClientProps { + pub fn new(client_id: ClientId, client: CoreClient) -> Self { + ClientProps { client_id, client } + } +} diff --git a/examples/openid_connect_demo/src/props/mod.rs b/examples/openid_connect_demo/src/props/mod.rs new file mode 100644 index 000000000..1d3313153 --- /dev/null +++ b/examples/openid_connect_demo/src/props/mod.rs @@ -0,0 +1 @@ +pub(crate) mod client; diff --git a/examples/openid_connect_demo/src/router.rs b/examples/openid_connect_demo/src/router.rs new file mode 100644 index 000000000..0bb80afbb --- /dev/null +++ b/examples/openid_connect_demo/src/router.rs @@ -0,0 +1,17 @@ +use crate::views::{header::AuthHeader, home::Home, login::Login, not_found::NotFound}; +use dioxus::prelude::*; +use dioxus_router::prelude::*; + +#[derive(Routable, Clone)] +pub enum Route { + #[layout(AuthHeader)] + #[route("/")] + Home {}, + + // https://dioxuslabs.com/learn/0.4/router/reference/routes#query-segments + #[route("/login?:query_string")] + Login { query_string: String }, + #[end_layout] + #[route("/:..route")] + NotFound { route: Vec }, +} diff --git a/examples/openid_connect_demo/src/storage.rs b/examples/openid_connect_demo/src/storage.rs new file mode 100644 index 000000000..402740cdf --- /dev/null +++ b/examples/openid_connect_demo/src/storage.rs @@ -0,0 +1,38 @@ +use fermi::UseAtomRef; +use gloo_storage::{LocalStorage, Storage}; +use serde::{Deserialize, Serialize}; + +use crate::{ + constants::{DIOXUS_FRONT_AUTH_REQUEST, DIOXUS_FRONT_AUTH_TOKEN}, + oidc::{AuthRequestState, AuthTokenState}, +}; + +#[derive(Serialize, Deserialize, Clone)] +pub struct StorageEntry { + pub key: String, + pub value: T, +} + +pub trait PersistentWrite { + fn persistent_set(atom_ref: &UseAtomRef>, entry: Option); +} + +impl PersistentWrite for AuthTokenState { + fn persistent_set( + atom_ref: &UseAtomRef>, + entry: Option, + ) { + *atom_ref.write() = entry.clone(); + LocalStorage::set(DIOXUS_FRONT_AUTH_TOKEN, entry).unwrap(); + } +} + +impl PersistentWrite for AuthRequestState { + fn persistent_set( + atom_ref: &UseAtomRef>, + entry: Option, + ) { + *atom_ref.write() = entry.clone(); + LocalStorage::set(DIOXUS_FRONT_AUTH_REQUEST, entry).unwrap(); + } +} diff --git a/examples/openid_connect_demo/src/views/header.rs b/examples/openid_connect_demo/src/views/header.rs new file mode 100644 index 000000000..1f2c6e057 --- /dev/null +++ b/examples/openid_connect_demo/src/views/header.rs @@ -0,0 +1,250 @@ +use crate::{ + oidc::{ + authorize_url, email, exchange_refresh_token, init_oidc_client, log_out_url, + AuthRequestState, AuthTokenState, ClientState, + }, + props::client::ClientProps, + router::Route, + storage::PersistentWrite, + FERMI_AUTH_REQUEST, FERMI_AUTH_TOKEN, FERMI_CLIENT, +}; +use dioxus::prelude::*; +use dioxus_router::prelude::{Link, Outlet}; +use fermi::*; +use openidconnect::{url::Url, OAuth2TokenResponse, TokenResponse}; + +#[component] +pub fn LogOut(cx: Scope) -> Element { + let fermi_auth_token = use_atom_ref(cx, &FERMI_AUTH_TOKEN); + let fermi_auth_token_read = fermi_auth_token.read().clone(); + let log_out_url_state = use_state(cx, || None::>>); + cx.render(match fermi_auth_token_read { + Some(fermi_auth_token_read) => match fermi_auth_token_read.id_token.clone() { + Some(id_token) => match log_out_url_state.get() { + Some(log_out_url_result) => match log_out_url_result { + Some(uri) => match uri { + Ok(uri) => { + rsx! { + Link { + onclick: move |_| { + { + AuthTokenState::persistent_set( + fermi_auth_token, + Some(AuthTokenState::default()), + ); + } + }, + to: uri.to_string(), + "Log out" + } + } + } + Err(error) => { + rsx! { + div { format!{"Failed to load disconnection url: {:?}", error} } + } + } + }, + None => { + rsx! { div { "Loading... Please wait" } } + } + }, + None => { + let logout_url_task = move || { + cx.spawn({ + let log_out_url_state = log_out_url_state.to_owned(); + async move { + let logout_url = log_out_url(id_token).await; + let logout_url_option = Some(logout_url); + log_out_url_state.set(Some(logout_url_option)); + } + }) + }; + logout_url_task(); + rsx! { div{"Loading log out url... Please wait"}} + } + }, + None => { + rsx! {{}} + } + }, + None => { + rsx! {{}} + } + }) +} + +#[component] +pub fn RefreshToken(cx: Scope) -> Element { + let fermi_auth_token = use_atom_ref(cx, &FERMI_AUTH_TOKEN); + let fermi_auth_request = use_atom_ref(cx, &FERMI_AUTH_REQUEST); + let fermi_auth_token_read = fermi_auth_token.read().clone(); + cx.render(match fermi_auth_token_read { + Some(fermi_auth_client_read) => match fermi_auth_client_read.refresh_token { + Some(refresh_token) => { + let fermi_auth_token = fermi_auth_token.to_owned(); + let fermi_auth_request = fermi_auth_request.to_owned(); + let client = cx.props.client.clone(); + let exchange_refresh_token_spawn = move || { + cx.spawn({ + async move { + let exchange_refresh_token = + exchange_refresh_token(client, refresh_token).await; + match exchange_refresh_token { + Ok(response_token) => { + AuthTokenState::persistent_set( + &fermi_auth_token, + Some(AuthTokenState { + id_token: response_token.id_token().cloned(), + refresh_token: response_token.refresh_token().cloned(), + }), + ); + } + Err(_error) => { + AuthTokenState::persistent_set( + &fermi_auth_token, + Some(AuthTokenState::default()), + ); + AuthRequestState::persistent_set( + &fermi_auth_request, + Some(AuthRequestState::default()), + ); + } + } + } + }) + }; + exchange_refresh_token_spawn(); + rsx! { div { "Refreshing session, please wait" } } + } + None => { + rsx! { div { "Id token expired and no refresh token found" } } + } + }, + None => { + rsx! {{}} + } + }) +} + +#[component] +pub fn LoadClient(cx: Scope) -> Element { + let init_client_future = use_future(cx, (), |_| async move { init_oidc_client().await }); + let fermi_client: &UseAtomRef = use_atom_ref(cx, &FERMI_CLIENT); + cx.render(match init_client_future.value() { + Some(client_props) => match client_props { + Ok((client_id, client)) => { + *fermi_client.write() = ClientState { + oidc_client: Some(ClientProps::new(client_id.clone(), client.clone())), + }; + rsx! { + div { "Client successfully loaded" } + Outlet:: {} + } + } + Err(error) => { + rsx! { + div { format!{"Failed to load client: {:?}", error} } + log::info!{"Failed to load client: {:?}", error}, + Outlet:: {} + } + } + }, + None => { + rsx! { + div { + div { "Loading client, please wait" } + Outlet:: {} + } + } + } + }) +} + +#[component] +pub fn AuthHeader(cx: Scope) -> Element { + let auth_token = use_atom_ref(cx, &FERMI_AUTH_TOKEN); + let fermi_auth_request = use_atom_ref(cx, &FERMI_AUTH_REQUEST); + let fermi_client: &UseAtomRef = use_atom_ref(cx, &FERMI_CLIENT); + let client = fermi_client.read().oidc_client.clone(); + let auth_request_read = fermi_auth_request.read().clone(); + let auth_token_read = auth_token.read().clone(); + cx.render(match (client, auth_request_read, auth_token_read) { + // We have everything we need to attempt to authenticate the user + (Some(client_props), Some(auth_request), Some(auth_token)) => { + match auth_request.auth_request { + Some(auth_request) => { + match auth_token.id_token { + Some(id_token) => { + match email( + client_props.client.clone(), + id_token.clone(), + auth_request.nonce.clone(), + ) { + Ok(email) => { + rsx! { + div { + div { email } + LogOut { client_id: client_props.client_id, client: client_props.client } + Outlet:: {} + } + } + } + //Β Id token failed to be decoded + Err(error) => match error { + // Id token failed to be decoded because it expired, we refresh it + openidconnect::ClaimsVerificationError::Expired(_message) => { + log::info!("Token expired"); + rsx! { + div { + RefreshToken {client_id: client_props.client_id, client: client_props.client} + Outlet:: {} + } + } + } + //Β Other issue with token decoding + _ => { + log::info!("Other issue with token"); + rsx! { + div { + div { error.to_string() } + Outlet:: {} + } + } + } + }, + } + } + // User is not logged in + None => { + rsx! { + div { + Link { to: auth_request.authorize_url.clone(), "Log in" } + Outlet:: {} + } + } + } + } + } + None => { + let auth_request = authorize_url(client_props.client); + AuthRequestState::persistent_set( + fermi_auth_request, + Some(AuthRequestState { + auth_request: Some(auth_request), + }), + ); + rsx! { div { "Loading nonce" } } + } + } + } + // Client is not initialized yet, we need it for everything + (None, _, _) => { + rsx! { LoadClient {} } + } + // We need everything loaded before doing anything + (_client, _auth_request, _auth_token) => { + rsx! {{}} + } + }) +} diff --git a/examples/openid_connect_demo/src/views/home.rs b/examples/openid_connect_demo/src/views/home.rs new file mode 100644 index 000000000..f39695302 --- /dev/null +++ b/examples/openid_connect_demo/src/views/home.rs @@ -0,0 +1,5 @@ +use dioxus::prelude::*; + +pub fn Home(cx: Scope) -> Element { + render! { div { "Hello world" } } +} diff --git a/examples/openid_connect_demo/src/views/login.rs b/examples/openid_connect_demo/src/views/login.rs new file mode 100644 index 000000000..2583503de --- /dev/null +++ b/examples/openid_connect_demo/src/views/login.rs @@ -0,0 +1,86 @@ +use crate::{ + oidc::{token_response, AuthRequestState, AuthTokenState}, + router::Route, + storage::PersistentWrite, + DIOXUS_FRONT_URL, FERMI_AUTH_REQUEST, FERMI_AUTH_TOKEN, FERMI_CLIENT, +}; +use dioxus::prelude::*; +use dioxus_router::prelude::{Link, NavigationTarget}; +use fermi::*; +use openidconnect::{OAuth2TokenResponse, TokenResponse}; + +#[component] +pub fn Login(cx: Scope, query_string: String) -> Element { + let fermi_client = use_atom_ref(cx, &FERMI_CLIENT); + let fermi_auth_token = use_atom_ref(cx, &FERMI_AUTH_TOKEN); + let home_url: NavigationTarget = DIOXUS_FRONT_URL.parse().unwrap(); + let fermi_auth_request = use_atom_ref(cx, &FERMI_AUTH_REQUEST); + let client = fermi_client.read().oidc_client.clone(); + let auth_token_read = fermi_auth_token.read().clone(); + cx.render(match (client, auth_token_read) { + (Some(client_props), Some(auth_token_read)) => { + match (auth_token_read.id_token, auth_token_read.refresh_token) { + (Some(_id_token), Some(_refresh_token)) => { + rsx! { + div { "Sign in successful" } + Link { to: home_url, "Go back home" } + } + } + // If the refresh token is set but not the id_token, there was an error, we just go back home and reset their value + (None, Some(_)) | (Some(_), None) => { + rsx! { + div { "Error while attempting to log in" } + Link { + to: home_url, + onclick: move |_| { + AuthTokenState::persistent_set(fermi_auth_token, Some(AuthTokenState::default())); + AuthRequestState::persistent_set( + fermi_auth_request, + Some(AuthRequestState::default()), + ); + }, + "Go back home" + } + } + } + (None, None) => { + let mut query_pairs = form_urlencoded::parse(query_string.as_bytes()); + let code_pair = query_pairs.find(|(key, _value)| key == "code"); + match code_pair { + Some((_key, code)) => { + let auth_code = code.to_string(); + let token_response_spawn = move ||{ + cx.spawn({ + let fermi_auth_token = fermi_auth_token.to_owned(); + async move { + let token_response_result = token_response(client_props.client, auth_code).await; + match token_response_result{ + Ok(token_response) => { + let id_token = token_response.id_token().unwrap(); + AuthTokenState::persistent_set(&fermi_auth_token, Some(AuthTokenState { + id_token: Some(id_token.clone()), + refresh_token: token_response.refresh_token().cloned() + })); + } + Err(error) => { + log::warn!{"{error}"}; + } + } + } + }) + }; + token_response_spawn(); + rsx!{ div {} } + } + None => { + rsx! { div { "No code provided" } } + } + } + } + } + } + (_, _) => { + rsx! {{}} + } + }) +} diff --git a/examples/openid_connect_demo/src/views/mod.rs b/examples/openid_connect_demo/src/views/mod.rs new file mode 100644 index 000000000..1b8e08a58 --- /dev/null +++ b/examples/openid_connect_demo/src/views/mod.rs @@ -0,0 +1,4 @@ +pub(crate) mod header; +pub(crate) mod home; +pub(crate) mod login; +pub(crate) mod not_found; diff --git a/examples/openid_connect_demo/src/views/not_found.rs b/examples/openid_connect_demo/src/views/not_found.rs new file mode 100644 index 000000000..6321dc9fc --- /dev/null +++ b/examples/openid_connect_demo/src/views/not_found.rs @@ -0,0 +1,7 @@ +use dioxus::prelude::*; + +#[component] +pub fn NotFound(cx: Scope, route: Vec) -> Element { + let routes = route.join(""); + render! {rsx! {div{routes}}} +} From 129d0a68ff746e29625aa9d4d4ffbf9cd967ad48 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marc=20Esp=C3=ADn?= Date: Fri, 20 Oct 2023 19:59:49 +0200 Subject: [PATCH 200/447] feat: Optional web support for hot-reload crate (#1527) * feat: Optional web support for hot-reload crate * rename feature * tweak * tweak --- packages/hot-reload/Cargo.toml | 7 ++++--- packages/hot-reload/src/file_watcher.rs | 8 +++++--- packages/hot-reload/src/lib.rs | 4 ++-- 3 files changed, 11 insertions(+), 8 deletions(-) diff --git a/packages/hot-reload/Cargo.toml b/packages/hot-reload/Cargo.toml index b724ad685..70057114a 100644 --- a/packages/hot-reload/Cargo.toml +++ b/packages/hot-reload/Cargo.toml @@ -12,7 +12,7 @@ keywords = ["dom", "ui", "gui", "react", "hot-reloading"] [dependencies] dioxus-rsx = { workspace = true } dioxus-core = { workspace = true, features = ["serialize"] } -dioxus-html = { workspace = true } +dioxus-html = { workspace = true, optional = true } interprocess-docfix = { version = "1.2.2" } notify = { version = "5.0.0", optional = true } @@ -24,5 +24,6 @@ once_cell = { version = "1.17.0", optional = true } ignore = { version = "0.4.19", optional = true } [features] -default = [] -file_watcher = ["ignore", "chrono", "notify", "execute", "once_cell", "ignore", "dioxus-html/hot-reload-context"] +default = ["dioxus-html"] +custom_file_watcher = ["ignore", "chrono", "notify", "execute", "once_cell", "ignore"] +file_watcher = ["custom_file_watcher", "dioxus-html/hot-reload-context"] diff --git a/packages/hot-reload/src/file_watcher.rs b/packages/hot-reload/src/file_watcher.rs index 48d97dfa7..2509dd789 100644 --- a/packages/hot-reload/src/file_watcher.rs +++ b/packages/hot-reload/src/file_watcher.rs @@ -13,11 +13,12 @@ use dioxus_rsx::{ }; use interprocess_docfix::local_socket::{LocalSocketListener, LocalSocketStream}; use notify::{RecommendedWatcher, RecursiveMode, Watcher}; - -pub use dioxus_html::HtmlCtx; use serde::{Deserialize, Serialize}; -pub struct Config { +#[cfg(feature = "file_watcher")] +use dioxus_html::HtmlCtx; + +pub struct Config { root_path: &'static str, listening_paths: &'static [&'static str], excluded_paths: &'static [&'static str], @@ -39,6 +40,7 @@ impl Default for Config { } } +#[cfg(feature = "file_watcher")] impl Config { pub const fn new() -> Self { Self { diff --git a/packages/hot-reload/src/lib.rs b/packages/hot-reload/src/lib.rs index f7906b141..68692b72b 100644 --- a/packages/hot-reload/src/lib.rs +++ b/packages/hot-reload/src/lib.rs @@ -6,9 +6,9 @@ pub use dioxus_html::HtmlCtx; use interprocess_docfix::local_socket::LocalSocketStream; use serde::{Deserialize, Serialize}; -#[cfg(feature = "file_watcher")] +#[cfg(feature = "custom_file_watcher")] mod file_watcher; -#[cfg(feature = "file_watcher")] +#[cfg(feature = "custom_file_watcher")] pub use file_watcher::*; /// A message the hot reloading server sends to the client From b14aaca7b2ed9c5df91dc2a907a05924c23dd844 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Fri, 20 Oct 2023 13:05:13 -0500 Subject: [PATCH 201/447] fix desktop renderer on windows --- packages/desktop/build.rs | 31 ++++++++++++++++++++++--------- packages/desktop/src/webview.rs | 2 +- 2 files changed, 23 insertions(+), 10 deletions(-) diff --git a/packages/desktop/build.rs b/packages/desktop/build.rs index 8be7761c0..b7989c595 100644 --- a/packages/desktop/build.rs +++ b/packages/desktop/build.rs @@ -2,6 +2,17 @@ use dioxus_interpreter_js::binary_protocol::SLEDGEHAMMER_JS; use std::io::Write; +const EDITS_PATH: &str = { + #[cfg(any(target_os = "android", target_os = "windows"))] + { + "http://dioxus.index.html/edits" + } + #[cfg(not(any(target_os = "android", target_os = "windows")))] + { + "dioxus://index.html/edits" + } +}; + fn main() { let prevent_file_upload = r#"// Prevent file inputs from opening the file dialog on click let inputs = document.querySelectorAll("input"); @@ -26,21 +37,23 @@ fn main() { } } }"#; - let polling_request = r#"// Poll for requests - window.interpreter.wait_for_request = () => { - fetch(new Request("dioxus://index.html/edits")) - .then(response => { + let polling_request = format!( + r#"// Poll for requests + window.interpreter.wait_for_request = () => {{ + fetch(new Request("{EDITS_PATH}")) + .then(response => {{ response.arrayBuffer() - .then(bytes => { + .then(bytes => {{ run_from_bytes(bytes); window.interpreter.wait_for_request(); - }); - }) - }"#; + }}); + }}) + }}"# + ); let mut interpreter = SLEDGEHAMMER_JS .replace("/*POST_HANDLE_EDITS*/", prevent_file_upload) .replace("export", "") - + polling_request; + + &polling_request; while let Some(import_start) = interpreter.find("import") { let import_end = interpreter[import_start..] .find(|c| c == ';' || c == '\n') diff --git a/packages/desktop/src/webview.rs b/packages/desktop/src/webview.rs index 44b5a3bf0..0992363e6 100644 --- a/packages/desktop/src/webview.rs +++ b/packages/desktop/src/webview.rs @@ -7,7 +7,7 @@ pub use wry::application as tao; use wry::application::window::Window; use wry::webview::{WebContext, WebView, WebViewBuilder}; -pub fn build( +pub(crate) fn build( cfg: &mut Config, event_loop: &EventLoopWindowTarget, proxy: EventLoopProxy, From e41278af4539f3a46ac8bd9cd9940ef0b56cfeec Mon Sep 17 00:00:00 2001 From: Leonard Date: Fri, 20 Oct 2023 23:10:06 +0200 Subject: [PATCH 202/447] Add link to website section on contributing to root README (#1559) --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index 5b6a99ad3..d1ec98019 100644 --- a/README.md +++ b/README.md @@ -159,6 +159,7 @@ So... Dioxus is great, but why won't it work for me? ## Contributing +- Check out the website [section on contributing](https://dioxuslabs.com/learn/0.4/contributing). - Report issues on our [issue tracker](https://github.com/dioxuslabs/dioxus/issues). - Join the discord and ask questions! From 0f0d90ee193d17310545ba245b26e22fbe7ce2f1 Mon Sep 17 00:00:00 2001 From: Sridhar Ratnakumar Date: Thu, 12 Oct 2023 15:29:02 -0400 Subject: [PATCH 203/447] Add a simple nix dev shell --- flake.lock | 247 +++++++++++++++++++++++++++++++++++++++++++++++++++++ flake.nix | 63 ++++++++++++++ 2 files changed, 310 insertions(+) create mode 100644 flake.lock create mode 100644 flake.nix diff --git a/flake.lock b/flake.lock new file mode 100644 index 000000000..e5c50616d --- /dev/null +++ b/flake.lock @@ -0,0 +1,247 @@ +{ + "nodes": { + "crane": { + "inputs": { + "flake-compat": "flake-compat", + "flake-utils": "flake-utils", + "nixpkgs": [ + "nixpkgs" + ], + "rust-overlay": "rust-overlay" + }, + "locked": { + "lastModified": 1696384830, + "narHash": "sha256-j8ZsVqzmj5sOm5MW9cqwQJUZELFFwOislDmqDDEMl6k=", + "owner": "ipetkov", + "repo": "crane", + "rev": "f2143cd27f8bd09ee4f0121336c65015a2a0a19c", + "type": "github" + }, + "original": { + "owner": "ipetkov", + "repo": "crane", + "type": "github" + } + }, + "flake-compat": { + "flake": false, + "locked": { + "lastModified": 1696267196, + "narHash": "sha256-AAQ/2sD+0D18bb8hKuEEVpHUYD1GmO2Uh/taFamn6XQ=", + "owner": "edolstra", + "repo": "flake-compat", + "rev": "4f910c9827911b1ec2bf26b5a062cd09f8d89f85", + "type": "github" + }, + "original": { + "owner": "edolstra", + "repo": "flake-compat", + "type": "github" + } + }, + "flake-parts": { + "inputs": { + "nixpkgs-lib": "nixpkgs-lib" + }, + "locked": { + "lastModified": 1696343447, + "narHash": "sha256-B2xAZKLkkeRFG5XcHHSXXcP7To9Xzr59KXeZiRf4vdQ=", + "owner": "hercules-ci", + "repo": "flake-parts", + "rev": "c9afaba3dfa4085dbd2ccb38dfade5141e33d9d4", + "type": "github" + }, + "original": { + "owner": "hercules-ci", + "repo": "flake-parts", + "type": "github" + } + }, + "flake-utils": { + "inputs": { + "systems": "systems" + }, + "locked": { + "lastModified": 1694529238, + "narHash": "sha256-zsNZZGTGnMOf9YpHKJqMSsa0dXbfmxeoJ7xHlrt+xmY=", + "owner": "numtide", + "repo": "flake-utils", + "rev": "ff7b65b44d01cf9ba6a71320833626af21126384", + "type": "github" + }, + "original": { + "owner": "numtide", + "repo": "flake-utils", + "type": "github" + } + }, + "flake-utils_2": { + "inputs": { + "systems": "systems_2" + }, + "locked": { + "lastModified": 1681202837, + "narHash": "sha256-H+Rh19JDwRtpVPAWp64F+rlEtxUWBAQW28eAi3SRSzg=", + "owner": "numtide", + "repo": "flake-utils", + "rev": "cfacdce06f30d2b68473a46042957675eebb3401", + "type": "github" + }, + "original": { + "owner": "numtide", + "repo": "flake-utils", + "type": "github" + } + }, + "nixpkgs": { + "locked": { + "lastModified": 1697009197, + "narHash": "sha256-viVRhBTFT8fPJTb1N3brQIpFZnttmwo3JVKNuWRVc3s=", + "owner": "nixos", + "repo": "nixpkgs", + "rev": "01441e14af5e29c9d27ace398e6dd0b293e25a54", + "type": "github" + }, + "original": { + "owner": "nixos", + "ref": "nixpkgs-unstable", + "repo": "nixpkgs", + "type": "github" + } + }, + "nixpkgs-lib": { + "locked": { + "dir": "lib", + "lastModified": 1696019113, + "narHash": "sha256-X3+DKYWJm93DRSdC5M6K5hLqzSya9BjibtBsuARoPco=", + "owner": "NixOS", + "repo": "nixpkgs", + "rev": "f5892ddac112a1e9b3612c39af1b72987ee5783a", + "type": "github" + }, + "original": { + "dir": "lib", + "owner": "NixOS", + "ref": "nixos-unstable", + "repo": "nixpkgs", + "type": "github" + } + }, + "nixpkgs_2": { + "locked": { + "lastModified": 1681358109, + "narHash": "sha256-eKyxW4OohHQx9Urxi7TQlFBTDWII+F+x2hklDOQPB50=", + "owner": "NixOS", + "repo": "nixpkgs", + "rev": "96ba1c52e54e74c3197f4d43026b3f3d92e83ff9", + "type": "github" + }, + "original": { + "owner": "NixOS", + "ref": "nixpkgs-unstable", + "repo": "nixpkgs", + "type": "github" + } + }, + "root": { + "inputs": { + "crane": "crane", + "flake-parts": "flake-parts", + "nixpkgs": "nixpkgs", + "rust-overlay": "rust-overlay_2", + "systems": "systems_3" + } + }, + "rust-overlay": { + "inputs": { + "flake-utils": [ + "crane", + "flake-utils" + ], + "nixpkgs": [ + "crane", + "nixpkgs" + ] + }, + "locked": { + "lastModified": 1696299134, + "narHash": "sha256-RS77cAa0N+Sfj5EmKbm5IdncNXaBCE1BSSQvUE8exvo=", + "owner": "oxalica", + "repo": "rust-overlay", + "rev": "611ccdceed92b4d94ae75328148d84ee4a5b462d", + "type": "github" + }, + "original": { + "owner": "oxalica", + "repo": "rust-overlay", + "type": "github" + } + }, + "rust-overlay_2": { + "inputs": { + "flake-utils": "flake-utils_2", + "nixpkgs": "nixpkgs_2" + }, + "locked": { + "lastModified": 1697076655, + "narHash": "sha256-NcCtVUOd0X81srZkrdP8qoA1BMsPdO2tGtlZpsGijeU=", + "owner": "oxalica", + "repo": "rust-overlay", + "rev": "aa7584f5bbf5947716ad8ec14eccc0334f0d28f0", + "type": "github" + }, + "original": { + "owner": "oxalica", + "repo": "rust-overlay", + "type": "github" + } + }, + "systems": { + "locked": { + "lastModified": 1681028828, + "narHash": "sha256-Vy1rq5AaRuLzOxct8nz4T6wlgyUR7zLU309k9mBC768=", + "owner": "nix-systems", + "repo": "default", + "rev": "da67096a3b9bf56a91d16901293e51ba5b49a27e", + "type": "github" + }, + "original": { + "owner": "nix-systems", + "repo": "default", + "type": "github" + } + }, + "systems_2": { + "locked": { + "lastModified": 1681028828, + "narHash": "sha256-Vy1rq5AaRuLzOxct8nz4T6wlgyUR7zLU309k9mBC768=", + "owner": "nix-systems", + "repo": "default", + "rev": "da67096a3b9bf56a91d16901293e51ba5b49a27e", + "type": "github" + }, + "original": { + "owner": "nix-systems", + "repo": "default", + "type": "github" + } + }, + "systems_3": { + "locked": { + "lastModified": 1681028828, + "narHash": "sha256-Vy1rq5AaRuLzOxct8nz4T6wlgyUR7zLU309k9mBC768=", + "owner": "nix-systems", + "repo": "default", + "rev": "da67096a3b9bf56a91d16901293e51ba5b49a27e", + "type": "github" + }, + "original": { + "owner": "nix-systems", + "repo": "default", + "type": "github" + } + } + }, + "root": "root", + "version": 7 +} diff --git a/flake.nix b/flake.nix new file mode 100644 index 000000000..7f151a660 --- /dev/null +++ b/flake.nix @@ -0,0 +1,63 @@ +{ + inputs = { + nixpkgs.url = "github:nixos/nixpkgs/nixpkgs-unstable"; + flake-parts.url = "github:hercules-ci/flake-parts"; + systems.url = "github:nix-systems/default"; + + rust-overlay.url = "github:oxalica/rust-overlay"; + crane.url = "github:ipetkov/crane"; + crane.inputs.nixpkgs.follows = "nixpkgs"; + }; + + outputs = inputs: + inputs.flake-parts.lib.mkFlake { inherit inputs; } { + systems = import inputs.systems; + + perSystem = { config, self', pkgs, lib, system, ... }: + let + rustToolchain = pkgs.rust-bin.stable.latest.default.override { + extensions = [ + "rust-src" + "rust-analyzer" + "clippy" + ]; + }; + rustBuildInputs = [ + pkgs.openssl + pkgs.libiconv + pkgs.pkg-config + ] ++ lib.optionals pkgs.stdenv.isDarwin (with pkgs.darwin.apple_sdk.frameworks; [ + IOKit + Carbon + WebKit + Security + Cocoa + ]); + + # This is useful when building crates as packages + # Note that it does require a `Cargo.lock` which this repo does not have + # craneLib = (inputs.crane.mkLib pkgs).overrideToolchain rustToolchain; + in + { + _module.args.pkgs = import inputs.nixpkgs { + inherit system; + overlays = [ + inputs.rust-overlay.overlays.default + ]; + }; + + devShells.default = pkgs.mkShell { + name = "dioxus-dev"; + buildInputs = rustBuildInputs; + nativeBuildInputs = [ + # Add shell dependencies here + rustToolchain + ]; + shellHook = '' + # For rust-analyzer 'hover' tooltips to work. + export RUST_SRC_PATH="${rustToolchain}/lib/rustlib/src/rust/library"; + ''; + }; + }; + }; +} From 74952179db25e37ae6f9957bc7109ee276889d31 Mon Sep 17 00:00:00 2001 From: Leonard Date: Sun, 22 Oct 2023 16:28:17 +0200 Subject: [PATCH 204/447] Append prop documentation to function when using `#[inline_props]` or `#[component]` (#1563) * Do the stuff * Add deprecated warning and attribute list Also move out methods that didn't take self as a parameter from `InlinePropsDeserializer` --- .../inline_props.rs | 420 ++++++++++++------ 1 file changed, 276 insertions(+), 144 deletions(-) diff --git a/packages/core-macro/src/component_body_deserializers/inline_props.rs b/packages/core-macro/src/component_body_deserializers/inline_props.rs index 8e4581c19..a6e0a07d2 100644 --- a/packages/core-macro/src/component_body_deserializers/inline_props.rs +++ b/packages/core-macro/src/component_body_deserializers/inline_props.rs @@ -30,166 +30,298 @@ impl ToTokens for InlinePropsDeserializerOutput { impl DeserializerArgs for InlinePropsDeserializerArgs { fn to_output(&self, component_body: &ComponentBody) -> Result { Ok(InlinePropsDeserializerOutput { - comp_fn: Self::get_function(component_body), - props_struct: Self::get_props_struct(component_body), + comp_fn: get_function(component_body), + props_struct: get_props_struct(component_body), }) } } -impl InlinePropsDeserializerArgs { - fn get_props_struct(component_body: &ComponentBody) -> ItemStruct { - let ComponentBody { item_fn, .. } = component_body; - let ItemFn { vis, sig, .. } = item_fn; - let Signature { - inputs, - ident: fn_ident, - generics, - .. - } = sig; +fn get_props_struct(component_body: &ComponentBody) -> ItemStruct { + let ComponentBody { item_fn, .. } = component_body; + let ItemFn { vis, sig, .. } = item_fn; + let Signature { + inputs, + ident: fn_ident, + generics, + .. + } = sig; - // Skip first arg since that's the context - let struct_fields = inputs.iter().skip(1).map(move |f| { - match f { - FnArg::Receiver(_) => unreachable!(), // Unreachable because of ComponentBody parsing - FnArg::Typed(pt) => { - let arg_pat = &pt.pat; // Pattern (identifier) - let arg_colon = &pt.colon_token; - let arg_ty = &pt.ty; // Type - let arg_attrs = &pt.attrs; // Attributes + // Skip first arg since that's the context + let struct_fields = inputs.iter().skip(1).map(move |f| { + match f { + FnArg::Receiver(_) => unreachable!(), // Unreachable because of ComponentBody parsing + FnArg::Typed(pt) => { + let arg_pat = &pt.pat; // Pattern (identifier) + let arg_colon = &pt.colon_token; + let arg_ty = &pt.ty; // Type + let arg_attrs = &pt.attrs; // Attributes - quote! { - #(#arg_attrs) - * - #vis #arg_pat #arg_colon #arg_ty - } + quote! { + #(#arg_attrs) + * + #vis #arg_pat #arg_colon #arg_ty } } - }); - - let struct_ident = Ident::new(&format!("{fn_ident}Props"), fn_ident.span()); - - let first_lifetime = if let Some(GenericParam::Lifetime(lt)) = generics.params.first() { - Some(lt) - } else { - None - }; - - let struct_attrs = if first_lifetime.is_some() { - quote! { #[derive(Props)] } - } else { - quote! { #[derive(Props, PartialEq)] } - }; - - let struct_generics = if first_lifetime.is_some() { - let struct_generics: Punctuated = component_body - .item_fn - .sig - .generics - .params - .iter() - .map(|it| match it { - GenericParam::Type(tp) => { - let mut tp = tp.clone(); - tp.bounds.push(parse_quote!( 'a )); - - GenericParam::Type(tp) - } - _ => it.clone(), - }) - .collect(); - - quote! { <#struct_generics> } - } else { - quote! { #generics } - }; - - parse_quote! { - #struct_attrs - #[allow(non_camel_case_types)] - #vis struct #struct_ident #struct_generics - { - #(#struct_fields),* - } } - } + }); - fn get_function(component_body: &ComponentBody) -> ItemFn { - let ComponentBody { - item_fn, - cx_pat_type, - .. - } = component_body; - let ItemFn { - attrs: fn_attrs, - vis, - sig, - block: fn_block, - } = item_fn; - let Signature { - inputs, - ident: fn_ident, - generics, - output: fn_output, - asyncness, - .. - } = sig; - let Generics { where_clause, .. } = generics; + let struct_ident = Ident::new(&format!("{fn_ident}Props"), fn_ident.span()); - let cx_pat = &cx_pat_type.pat; - let struct_ident = Ident::new(&format!("{fn_ident}Props"), fn_ident.span()); + let first_lifetime = if let Some(GenericParam::Lifetime(lt)) = generics.params.first() { + Some(lt) + } else { + None + }; - // Skip first arg since that's the context - let struct_field_names = inputs.iter().skip(1).filter_map(|f| match f { - FnArg::Receiver(_) => unreachable!(), // ComponentBody prohibits receiver parameters. - FnArg::Typed(t) => Some(&t.pat), - }); + let struct_attrs = if first_lifetime.is_some() { + quote! { #[derive(Props)] } + } else { + quote! { #[derive(Props, PartialEq)] } + }; - let first_lifetime = if let Some(GenericParam::Lifetime(lt)) = generics.params.first() { - Some(lt) - } else { - None - }; + let struct_generics = if first_lifetime.is_some() { + let struct_generics: Punctuated = component_body + .item_fn + .sig + .generics + .params + .iter() + .map(|it| match it { + GenericParam::Type(tp) => { + let mut tp = tp.clone(); + tp.bounds.push(parse_quote!( 'a )); - let (scope_lifetime, fn_generics) = if let Some(lt) = first_lifetime { - (quote! { #lt, }, generics.clone()) - } else { - let lifetime: LifetimeParam = parse_quote! { 'a }; + GenericParam::Type(tp) + } + _ => it.clone(), + }) + .collect(); - let mut fn_generics = generics.clone(); - fn_generics - .params - .insert(0, GenericParam::Lifetime(lifetime.clone())); + quote! { <#struct_generics> } + } else { + quote! { #generics } + }; - (quote! { #lifetime, }, fn_generics) - }; - - let generics_no_bounds = { - let mut generics = generics.clone(); - generics.params = generics - .params - .iter() - .map(|it| match it { - GenericParam::Type(tp) => { - let mut tp = tp.clone(); - tp.bounds.clear(); - - GenericParam::Type(tp) - } - _ => it.clone(), - }) - .collect(); - - generics - }; - - parse_quote! { - #(#fn_attrs)* - #asyncness #vis fn #fn_ident #fn_generics (#cx_pat: Scope<#scope_lifetime #struct_ident #generics_no_bounds>) #fn_output - #where_clause - { - let #struct_ident { #(#struct_field_names),* } = &#cx_pat.props; - #fn_block - } + parse_quote! { + #struct_attrs + #[allow(non_camel_case_types)] + #vis struct #struct_ident #struct_generics + { + #(#struct_fields),* } } } + +fn get_props_docs(fn_ident: &Ident, inputs: Vec<&FnArg>) -> Vec { + if inputs.len() <= 1 { + return Vec::new(); + } + + let arg_docs = inputs + .iter() + .filter_map(|f| match f { + FnArg::Receiver(_) => unreachable!(), // ComponentBody prohibits receiver parameters. + FnArg::Typed(pt) => { + let arg_doc = pt + .attrs + .iter() + .filter_map(|attr| { + // TODO: Error reporting + // Check if the path of the attribute is "doc" + if !is_attr_doc(attr) { + return None; + }; + + let Meta::NameValue(meta_name_value) = &attr.meta else { + return None; + }; + + let Expr::Lit(doc_lit) = &meta_name_value.value else { + return None; + }; + + let Lit::Str(doc_lit_str) = &doc_lit.lit else { + return None; + }; + + Some(doc_lit_str.value()) + }) + .fold(String::new(), |mut doc, next_doc_line| { + doc.push('\n'); + doc.push_str(&next_doc_line); + doc + }); + + Some(( + pt.pat.to_token_stream().to_string(), + pt.ty.to_token_stream().to_string(), + pt.attrs.iter().filter(|a| !is_attr_doc(a)), + arg_doc, + )) + } + }) + .collect::>(); + + let mut props_docs = Vec::with_capacity(5); + let props_def_link = fn_ident.to_string() + "Props"; + let header = + format!("# Props\n*For details, see the [props struct definition]({props_def_link}).*"); + + props_docs.push(parse_quote! { + #[doc = #header] + }); + + for (arg_name, arg_type, attrs, input_arg_doc) in arg_docs { + let input_arg_doc = + keep_up_to_two_consecutive_chars(input_arg_doc.trim_matches('\n'), '\n') + .replace('\n', "
"); + let prop_def_link = format!("{props_def_link}::{arg_name}"); + let mut attribute_list = String::new(); + let mut is_deprecated = false; + + for attr in attrs { + if attr.path() == &parse_quote!(deprecated) { + is_deprecated = true; + continue; + } + + attribute_list.push('`'); + attribute_list.push_str("e!(#attr).into_token_stream().to_string()); + attribute_list.push_str("`, "); + } + + let mut arg_doc = format!("- [`{arg_name}`]({prop_def_link})"); + + if is_deprecated { + arg_doc.push_str(" πŸ‘Ž Deprecated"); + } + + arg_doc.push_str(&format!("
Type: `{arg_type}`")); + + if !attribute_list.is_empty() { + // Truncate the last `, ` + attribute_list.truncate(attribute_list.len() - 2); + arg_doc.push_str(&format!("
Attributes: {attribute_list}")); + } + + arg_doc.push_str(&format!("
{input_arg_doc}")); + + props_docs.push(parse_quote! { + #[doc = #arg_doc] + }); + } + + props_docs +} + +fn get_function(component_body: &ComponentBody) -> ItemFn { + let ComponentBody { + item_fn, + cx_pat_type, + .. + } = component_body; + let ItemFn { + attrs: fn_attrs, + vis, + sig, + block: fn_block, + } = item_fn; + let Signature { + inputs, + ident: fn_ident, + generics, + output: fn_output, + asyncness, + .. + } = sig; + let Generics { where_clause, .. } = generics; + + let cx_pat = &cx_pat_type.pat; + let struct_ident = Ident::new(&format!("{fn_ident}Props"), fn_ident.span()); + + // Skip first arg since that's the context + let struct_field_names = inputs.iter().skip(1).filter_map(|f| match f { + FnArg::Receiver(_) => unreachable!(), // ComponentBody prohibits receiver parameters. + FnArg::Typed(pt) => Some(&pt.pat), + }); + + let first_lifetime = if let Some(GenericParam::Lifetime(lt)) = generics.params.first() { + Some(lt) + } else { + None + }; + + let (scope_lifetime, fn_generics) = if let Some(lt) = first_lifetime { + (quote! { #lt, }, generics.clone()) + } else { + let lifetime: LifetimeParam = parse_quote! { 'a }; + + let mut fn_generics = generics.clone(); + fn_generics + .params + .insert(0, GenericParam::Lifetime(lifetime.clone())); + + (quote! { #lifetime, }, fn_generics) + }; + + let generics_no_bounds = { + let mut generics = generics.clone(); + generics.params = generics + .params + .iter() + .map(|it| match it { + GenericParam::Type(tp) => { + let mut tp = tp.clone(); + tp.bounds.clear(); + + GenericParam::Type(tp) + } + _ => it.clone(), + }) + .collect(); + + generics + }; + + let props_docs = get_props_docs(fn_ident, inputs.iter().skip(1).collect()); + + parse_quote! { + #(#fn_attrs)* + #(#props_docs)* + #asyncness #vis fn #fn_ident #fn_generics (#cx_pat: Scope<#scope_lifetime #struct_ident #generics_no_bounds>) #fn_output + #where_clause + { + let #struct_ident { #(#struct_field_names),* } = &#cx_pat.props; + #fn_block + } + } +} + +/// Checks if the attribute is a `#[doc]` attribute. +fn is_attr_doc(attr: &Attribute) -> bool { + attr.path() == &parse_quote!(doc) +} + +fn keep_up_to_two_consecutive_chars(input: &str, target_char: char) -> String { + let mut output = String::new(); + let mut prev_char: Option = None; + let mut consecutive_count = 0; + + for c in input.chars() { + match prev_char { + Some(prev) if c == target_char && prev == target_char => { + if consecutive_count < 2 { + output.push(c); + consecutive_count += 1; + } + } + _ => { + output.push(c); + prev_char = Some(c); + consecutive_count = 1; + } + } + } + + output +} From cea9563e259e51f45de40d8ac1078024aef29be6 Mon Sep 17 00:00:00 2001 From: Leonard Date: Mon, 23 Oct 2023 15:41:26 +0200 Subject: [PATCH 205/447] Improve prop docs (#1565) * Do the stuff * More sanitizing + fix warnings and format --- packages/core-macro/Cargo.toml | 1 + .../inline_props.rs | 80 ++++++----- packages/core-macro/src/lib.rs | 1 + packages/core-macro/src/utils.rs | 129 ++++++++++++++++++ 4 files changed, 177 insertions(+), 34 deletions(-) create mode 100644 packages/core-macro/src/utils.rs diff --git a/packages/core-macro/Cargo.toml b/packages/core-macro/Cargo.toml index d928d5fec..1898d8bd1 100644 --- a/packages/core-macro/Cargo.toml +++ b/packages/core-macro/Cargo.toml @@ -19,6 +19,7 @@ syn = { version = "2.0", features = ["full", "extra-traits"] } dioxus-rsx = { workspace = true } dioxus-core = { workspace = true } constcat = "0.3.0" +prettyplease = "0.2.15" # testing [dev-dependencies] diff --git a/packages/core-macro/src/component_body_deserializers/inline_props.rs b/packages/core-macro/src/component_body_deserializers/inline_props.rs index a6e0a07d2..670a14d88 100644 --- a/packages/core-macro/src/component_body_deserializers/inline_props.rs +++ b/packages/core-macro/src/component_body_deserializers/inline_props.rs @@ -153,9 +153,20 @@ fn get_props_docs(fn_ident: &Ident, inputs: Vec<&FnArg>) -> Vec { }); Some(( - pt.pat.to_token_stream().to_string(), - pt.ty.to_token_stream().to_string(), - pt.attrs.iter().filter(|a| !is_attr_doc(a)), + &pt.pat, + &pt.ty, + pt.attrs.iter().find_map(|attr| { + if attr.path() != &parse_quote!(deprecated) { + return None; + } + + let res = crate::utils::DeprecatedAttribute::from_meta(&attr.meta); + + match res { + Err(e) => panic!("{}", e.to_string()), + Ok(v) => Some(v), + } + }), arg_doc, )) } @@ -171,40 +182,37 @@ fn get_props_docs(fn_ident: &Ident, inputs: Vec<&FnArg>) -> Vec { #[doc = #header] }); - for (arg_name, arg_type, attrs, input_arg_doc) in arg_docs { - let input_arg_doc = - keep_up_to_two_consecutive_chars(input_arg_doc.trim_matches('\n'), '\n') - .replace('\n', "
"); - let prop_def_link = format!("{props_def_link}::{arg_name}"); - let mut attribute_list = String::new(); - let mut is_deprecated = false; + for (arg_name, arg_type, deprecation, input_arg_doc) in arg_docs { + let arg_name = arg_name.into_token_stream().to_string(); + let arg_type = crate::utils::format_type_string(arg_type); - for attr in attrs { - if attr.path() == &parse_quote!(deprecated) { - is_deprecated = true; - continue; + let input_arg_doc = + keep_up_to_n_consecutive_chars(input_arg_doc.trim(), 2, '\n').replace('\n', "
"); + let prop_def_link = format!("{props_def_link}::{arg_name}"); + let mut arg_doc = format!("- [`{arg_name}`]({prop_def_link}) : `{arg_type}`"); + + if let Some(deprecation) = deprecation { + arg_doc.push_str("
πŸ‘Ž Deprecated"); + + if let Some(since) = deprecation.since { + arg_doc.push_str(&format!(" since {since}")); } - attribute_list.push('`'); - attribute_list.push_str("e!(#attr).into_token_stream().to_string()); - attribute_list.push_str("`, "); + if let Some(note) = deprecation.note { + let note = keep_up_to_n_consecutive_chars(¬e, 1, '\n').replace('\n', " "); + let note = keep_up_to_n_consecutive_chars(¬e, 1, '\t').replace('\t', " "); + + arg_doc.push_str(&format!(": {note}")); + } + + if !input_arg_doc.is_empty() { + arg_doc.push_str("
"); + } + } else { + arg_doc.push_str("
"); } - let mut arg_doc = format!("- [`{arg_name}`]({prop_def_link})"); - - if is_deprecated { - arg_doc.push_str(" πŸ‘Ž Deprecated"); - } - - arg_doc.push_str(&format!("
Type: `{arg_type}`")); - - if !attribute_list.is_empty() { - // Truncate the last `, ` - attribute_list.truncate(attribute_list.len() - 2); - arg_doc.push_str(&format!("
Attributes: {attribute_list}")); - } - - arg_doc.push_str(&format!("
{input_arg_doc}")); + arg_doc.push_str(&input_arg_doc); props_docs.push(parse_quote! { #[doc = #arg_doc] @@ -302,7 +310,11 @@ fn is_attr_doc(attr: &Attribute) -> bool { attr.path() == &parse_quote!(doc) } -fn keep_up_to_two_consecutive_chars(input: &str, target_char: char) -> String { +fn keep_up_to_n_consecutive_chars( + input: &str, + n_of_consecutive_chars_allowed: usize, + target_char: char, +) -> String { let mut output = String::new(); let mut prev_char: Option = None; let mut consecutive_count = 0; @@ -310,7 +322,7 @@ fn keep_up_to_two_consecutive_chars(input: &str, target_char: char) -> String { for c in input.chars() { match prev_char { Some(prev) if c == target_char && prev == target_char => { - if consecutive_count < 2 { + if consecutive_count < n_of_consecutive_chars_allowed { output.push(c); consecutive_count += 1; } diff --git a/packages/core-macro/src/lib.rs b/packages/core-macro/src/lib.rs index 477c05d76..4686bc797 100644 --- a/packages/core-macro/src/lib.rs +++ b/packages/core-macro/src/lib.rs @@ -12,6 +12,7 @@ use syn::{parse_macro_input, Path, Token}; mod component_body; mod component_body_deserializers; mod props; +mod utils; // mod rsx; use crate::component_body::ComponentBody; diff --git a/packages/core-macro/src/utils.rs b/packages/core-macro/src/utils.rs new file mode 100644 index 000000000..7e066f773 --- /dev/null +++ b/packages/core-macro/src/utils.rs @@ -0,0 +1,129 @@ +use quote::ToTokens; +use syn::parse::{Parse, ParseStream}; +use syn::spanned::Spanned; +use syn::{parse_quote, Expr, Lit, Meta, Token, Type}; + +const FORMATTED_TYPE_START: &str = "static TY_AFTER_HERE:"; +const FORMATTED_TYPE_END: &str = "= todo!();"; + +/// Attempts to convert the given literal to a string. +/// Converts ints and floats to their base 10 counterparts. +/// +/// Returns `None` if the literal is [`Lit::Verbatim`] or if the literal is [`Lit::ByteStr`] +/// and the byte string could not be converted to UTF-8. +pub fn lit_to_string(lit: Lit) -> Option { + match lit { + Lit::Str(l) => Some(l.value()), + Lit::ByteStr(l) => String::from_utf8(l.value()).ok(), + Lit::Byte(l) => Some(String::from(l.value() as char)), + Lit::Char(l) => Some(l.value().to_string()), + Lit::Int(l) => Some(l.base10_digits().to_string()), + Lit::Float(l) => Some(l.base10_digits().to_string()), + Lit::Bool(l) => Some(l.value().to_string()), + Lit::Verbatim(_) => None, + _ => None, + } +} + +pub fn format_type_string(ty: &Type) -> String { + let ty_unformatted = ty.into_token_stream().to_string(); + let ty_unformatted = ty_unformatted.trim(); + + // This should always be valid syntax. + // Not Rust code, but syntax, which is the only thing that `syn` cares about. + let Ok(file_unformatted) = syn::parse_file(&format!( + "{FORMATTED_TYPE_START}{ty_unformatted}{FORMATTED_TYPE_END}" + )) else { + return ty_unformatted.to_string(); + }; + + let file_formatted = prettyplease::unparse(&file_unformatted); + + let file_trimmed = file_formatted.trim(); + let start_removed = file_trimmed.trim_start_matches(FORMATTED_TYPE_START); + let end_removed = start_removed.trim_end_matches(FORMATTED_TYPE_END); + let ty_formatted = end_removed.trim(); + + ty_formatted.to_string() +} + +/// Represents the `#[deprecated]` attribute. +/// +/// You can use the [`DeprecatedAttribute::from_meta`] function to try to parse an attribute to this struct. +#[derive(Default)] +pub struct DeprecatedAttribute { + pub since: Option, + pub note: Option, +} + +impl DeprecatedAttribute { + /// Returns `None` if the given attribute was not a valid form of the `#[deprecated]` attribute. + pub fn from_meta(meta: &Meta) -> syn::Result { + if meta.path() != &parse_quote!(deprecated) { + return Err(syn::Error::new( + meta.span(), + "attribute path is not `deprecated`", + )); + } + + match &meta { + Meta::Path(_) => Ok(Self::default()), + Meta::NameValue(name_value) => { + let Expr::Lit(expr_lit) = &name_value.value else { + return Err(syn::Error::new( + name_value.span(), + "literal in `deprecated` value must be a string", + )); + }; + + Ok(Self { + since: None, + note: lit_to_string(expr_lit.lit.clone()).map(|s| s.trim().to_string()), + }) + } + Meta::List(list) => { + let parsed = list.parse_args::()?; + + Ok(Self { + since: parsed.since.map(|s| s.trim().to_string()), + note: parsed.note.map(|s| s.trim().to_string()), + }) + } + } + } +} + +mod kw { + use syn::custom_keyword; + custom_keyword!(since); + custom_keyword!(note); +} + +struct DeprecatedAttributeArgsParser { + since: Option, + note: Option, +} + +impl Parse for DeprecatedAttributeArgsParser { + fn parse(input: ParseStream) -> syn::Result { + let mut since: Option = None; + let mut note: Option = None; + + if input.peek(kw::since) { + input.parse::()?; + input.parse::()?; + + since = lit_to_string(input.parse()?); + } + + if input.peek(Token![,]) && input.peek2(kw::note) { + input.parse::()?; + input.parse::()?; + input.parse::()?; + + note = lit_to_string(input.parse()?); + } + + Ok(Self { since, note }) + } +} From d9b32afd64615e8c2a7eb247d20533286c38aaaa Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Mon, 23 Oct 2023 12:45:10 -0500 Subject: [PATCH 206/447] add error message when overlapping fullstack features are enabled --- packages/fullstack/src/launch.rs | 11 +++++++++-- packages/fullstack/src/lib.rs | 7 +++++++ 2 files changed, 16 insertions(+), 2 deletions(-) diff --git a/packages/fullstack/src/launch.rs b/packages/fullstack/src/launch.rs index c982a1c90..bd145f363 100644 --- a/packages/fullstack/src/launch.rs +++ b/packages/fullstack/src/launch.rs @@ -121,8 +121,15 @@ impl Date: Mon, 23 Oct 2023 16:26:10 -0400 Subject: [PATCH 207/447] Feat: add global context functions Add functions like window() and router() to allow dynamically grabbing global contexts without have to use the hook variants. Deprecates the existing hook variants to discourage folks from adding more noise to their codebases. --- examples/button.rs | 18 ------------ examples/compose.rs | 11 ++----- examples/crm.rs | 4 +-- examples/eval.rs | 23 ++++++--------- examples/login_form.rs | 34 ++++++++++------------ examples/multiwindow.rs | 4 +-- examples/overlay.rs | 6 ++-- examples/window_zoom.rs | 4 +-- packages/desktop/src/desktop_context.rs | 9 ++++++ packages/desktop/src/lib.rs | 2 +- packages/html/src/eval.rs | 9 ++++++ packages/router/examples/simple_routes.rs | 7 ++--- packages/router/src/contexts/navigator.rs | 14 +++++++++ packages/router/src/hooks/use_navigator.rs | 1 + packages/router/src/hooks/use_router.rs | 7 ++++- packages/router/src/lib.rs | 2 ++ 16 files changed, 77 insertions(+), 78 deletions(-) delete mode 100644 examples/button.rs diff --git a/examples/button.rs b/examples/button.rs deleted file mode 100644 index f001ed531..000000000 --- a/examples/button.rs +++ /dev/null @@ -1,18 +0,0 @@ -use dioxus::prelude::*; - -fn main() { - dioxus_desktop::launch(app); -} - -fn app(cx: Scope) -> Element { - cx.render(rsx! { - button { - onclick: |_| async move { - println!("hello, desktop!"); - tokio::time::sleep(std::time::Duration::from_secs(1)).await; - println!("goodbye, desktop!"); - }, - "hello, desktop!" - } - }) -} diff --git a/examples/compose.rs b/examples/compose.rs index 3ee6d36ae..f544b5a9c 100644 --- a/examples/compose.rs +++ b/examples/compose.rs @@ -1,7 +1,6 @@ //! This example shows how to create a popup window and send data back to the parent window. use dioxus::prelude::*; -use dioxus_desktop::use_window; use futures_util::StreamExt; fn main() { @@ -9,7 +8,6 @@ fn main() { } fn app(cx: Scope) -> Element { - let window = use_window(cx); let emails_sent = use_ref(cx, Vec::new); let tx = use_coroutine(cx, |mut rx: UnboundedReceiver| { @@ -34,7 +32,7 @@ fn app(cx: Scope) -> Element { // this returns a weak reference to the other window // Be careful not to keep a strong reference to the other window or it will never be dropped // and the window will never close. - window.new_window(dom, Default::default()); + dioxus_desktop::window().new_window(dom, Default::default()); }, "Click to compose a new email" } @@ -57,7 +55,6 @@ struct ComposeProps { fn compose(cx: Scope) -> Element { let user_input = use_state(cx, String::new); - let window = use_window(cx); cx.render(rsx! { div { @@ -66,15 +63,13 @@ fn compose(cx: Scope) -> Element { button { onclick: move |_| { cx.props.app_tx.send(user_input.get().clone()); - window.close(); + dioxus_desktop::window().close(); }, "Click to send" } input { - oninput: move |e| { - user_input.set(e.value.clone()); - }, + oninput: move |e| user_input.set(e.value.clone()), value: "{user_input}" } } diff --git a/examples/crm.rs b/examples/crm.rs index d2cd98118..189f98e5a 100644 --- a/examples/crm.rs +++ b/examples/crm.rs @@ -87,8 +87,6 @@ fn ClientAdd(cx: Scope) -> Element { let last_name = use_state(cx, String::new); let description = use_state(cx, String::new); - let navigator = use_navigator(cx); - cx.render(rsx! { h2 { "Add new Client" } @@ -103,7 +101,7 @@ fn ClientAdd(cx: Scope) -> Element { description: description.to_string(), }); - navigator.push(Route::ClientList {}); + dioxus_router::router().push(Route::ClientList {}); }, fieldset { diff --git a/examples/eval.rs b/examples/eval.rs index 54959df69..65c8acbeb 100644 --- a/examples/eval.rs +++ b/examples/eval.rs @@ -5,26 +5,21 @@ fn main() { } fn app(cx: Scope) -> Element { - let eval_provider = use_eval(cx); - - let future = use_future(cx, (), |_| { - to_owned![eval_provider]; - async move { - let eval = eval_provider( - r#" + let future = use_future(cx, (), |_| async move { + let eval = eval( + r#" dioxus.send("Hi from JS!"); let msg = await dioxus.recv(); console.log(msg); return "hello world"; "#, - ) - .unwrap(); + ) + .unwrap(); - eval.send("Hi from Rust!".into()).unwrap(); - let res = eval.recv().await.unwrap(); - println!("{:?}", eval.await); - res - } + eval.send("Hi from Rust!".into()).unwrap(); + let res = eval.recv().await.unwrap(); + println!("{:?}", eval.await); + res }); match future.value() { diff --git a/examples/login_form.rs b/examples/login_form.rs index 5ee47e4b5..d14338c3d 100644 --- a/examples/login_form.rs +++ b/examples/login_form.rs @@ -8,27 +8,25 @@ fn main() { } fn app(cx: Scope) -> Element { - let onsubmit = move |evt: FormEvent| { - cx.spawn(async move { - let resp = reqwest::Client::new() - .post("http://localhost:8080/login") - .form(&[ - ("username", &evt.values["username"]), - ("password", &evt.values["password"]), - ]) - .send() - .await; + let onsubmit = move |evt: FormEvent| async move { + let resp = reqwest::Client::new() + .post("http://localhost:8080/login") + .form(&[ + ("username", &evt.values["username"]), + ("password", &evt.values["password"]), + ]) + .send() + .await; - match resp { - // Parse data from here, such as storing a response token - Ok(_data) => println!("Login successful!"), + match resp { + // Parse data from here, such as storing a response token + Ok(_data) => println!("Login successful!"), - //Handle any errors from the fetch here - Err(_err) => { - println!("Login failed - you need a login server running on localhost:8080.") - } + //Handle any errors from the fetch here + Err(_err) => { + println!("Login failed - you need a login server running on localhost:8080.") } - }); + } }; cx.render(rsx! { diff --git a/examples/multiwindow.rs b/examples/multiwindow.rs index e2caeba80..c7ad2c603 100644 --- a/examples/multiwindow.rs +++ b/examples/multiwindow.rs @@ -5,14 +5,12 @@ fn main() { } fn app(cx: Scope) -> Element { - let window = dioxus_desktop::use_window(cx); - cx.render(rsx! { div { button { onclick: move |_| { let dom = VirtualDom::new(popup); - window.new_window(dom, Default::default()); + dioxus_desktop::window().new_window(dom, Default::default()); }, "New Window" } diff --git a/examples/overlay.rs b/examples/overlay.rs index 0afd830be..a4b9e7bfe 100644 --- a/examples/overlay.rs +++ b/examples/overlay.rs @@ -1,13 +1,11 @@ use dioxus::prelude::*; -use dioxus_desktop::{tao::dpi::PhysicalPosition, use_window, LogicalSize, WindowBuilder}; +use dioxus_desktop::{tao::dpi::PhysicalPosition, LogicalSize, WindowBuilder}; fn main() { dioxus_desktop::launch_cfg(app, make_config()); } fn app(cx: Scope) -> Element { - let window = use_window(cx); - cx.render(rsx! { div { width: "100%", @@ -19,7 +17,7 @@ fn app(cx: Scope) -> Element { width: "100%", height: "10px", background_color: "black", - onmousedown: move |_| window.drag(), + onmousedown: move |_| dioxus_desktop::window().drag(), } "This is an overlay!" diff --git a/examples/window_zoom.rs b/examples/window_zoom.rs index e45d71be2..bf0949d1f 100644 --- a/examples/window_zoom.rs +++ b/examples/window_zoom.rs @@ -1,12 +1,10 @@ use dioxus::prelude::*; -use dioxus_desktop::use_window; fn main() { dioxus_desktop::launch(app); } fn app(cx: Scope) -> Element { - let window = use_window(cx); let level = use_state(cx, || 1.0); cx.render(rsx! { @@ -16,7 +14,7 @@ fn app(cx: Scope) -> Element { oninput: |e| { if let Ok(new_zoom) = e.value.parse::() { level.set(new_zoom); - window.webview.zoom(new_zoom); + dioxus_desktop::window().webview.zoom(new_zoom); } } } diff --git a/packages/desktop/src/desktop_context.rs b/packages/desktop/src/desktop_context.rs index 897f8eba8..22f6dbf8f 100644 --- a/packages/desktop/src/desktop_context.rs +++ b/packages/desktop/src/desktop_context.rs @@ -28,6 +28,15 @@ use wry::webview::WebView; pub type ProxyType = EventLoopProxy; +/// Get an imperative handle to the current window without using a hook +/// +/// ## Panics +/// +/// This function will panic if it is called outside of the context of a Dioxus App. +pub fn window() -> DesktopContext { + dioxus_core::prelude::consume_context().unwrap() +} + /// Get an imperative handle to the current window pub fn use_window(cx: &ScopeState) -> &DesktopContext { cx.use_hook(|| cx.consume_context::()) diff --git a/packages/desktop/src/lib.rs b/packages/desktop/src/lib.rs index badbe3276..1aac7dfcb 100644 --- a/packages/desktop/src/lib.rs +++ b/packages/desktop/src/lib.rs @@ -23,7 +23,7 @@ use crate::query::QueryResult; pub use cfg::{Config, WindowCloseBehaviour}; pub use desktop_context::DesktopContext; pub use desktop_context::{ - use_window, use_wry_event_handler, DesktopService, WryEventHandler, WryEventHandlerId, + use_window, use_wry_event_handler, window, DesktopService, WryEventHandler, WryEventHandlerId, }; use desktop_context::{EventData, UserWindowEvent, WebviewQueue, WindowEventHandlers}; use dioxus_core::*; diff --git a/packages/html/src/eval.rs b/packages/html/src/eval.rs index 292de70fc..394713af6 100644 --- a/packages/html/src/eval.rs +++ b/packages/html/src/eval.rs @@ -48,6 +48,15 @@ pub fn use_eval(cx: &ScopeState) -> &EvalCreator { }) } +pub fn eval(script: &str) -> Result { + let eval_provider = dioxus_core::prelude::consume_context::>() + .expect("evaluator not provided"); + + eval_provider + .new_evaluator(script.to_string()) + .map(UseEval::new) +} + /// A wrapper around the target platform's evaluator. #[derive(Clone)] pub struct UseEval { diff --git a/packages/router/examples/simple_routes.rs b/packages/router/examples/simple_routes.rs index 3634f7df3..d7738beab 100644 --- a/packages/router/examples/simple_routes.rs +++ b/packages/router/examples/simple_routes.rs @@ -66,7 +66,6 @@ fn Route2(cx: Scope, user_id: usize) -> Element { #[component] fn Route3(cx: Scope, dynamic: String) -> Element { - let navigator = use_navigator(cx); let current_route = use_route(cx)?; let current_route_str = use_ref(cx, String::new); let parsed = Route::from_str(¤t_route_str.read()); @@ -78,9 +77,7 @@ fn Route3(cx: Scope, dynamic: String) -> Element { render! { input { - oninput: move |evt| { - *current_route_str.write() = evt.value.clone(); - }, + oninput: move |evt| *current_route_str.write() = evt.value.clone(), value: "{current_route_str.read()}" } "dynamic: {dynamic}" @@ -89,7 +86,7 @@ fn Route3(cx: Scope, dynamic: String) -> Element { "hello world link" } button { - onclick: move |_| { navigator.push("https://www.google.com"); }, + onclick: move |_| { dioxus_router::router().push("https://www.google.com"); }, "google link" } p { "Site Map" } diff --git a/packages/router/src/contexts/navigator.rs b/packages/router/src/contexts/navigator.rs index 961122c05..8c8bdd109 100644 --- a/packages/router/src/contexts/navigator.rs +++ b/packages/router/src/contexts/navigator.rs @@ -1,5 +1,19 @@ use crate::prelude::{ExternalNavigationFailure, IntoRoutable, RouterContext}; +/// Acquire the navigator without subscribing to updates. +/// +/// Can be called anywhere in the application provided a Router has been initialized. +/// +/// ## Panics +/// +/// Panics if there is no router present. +pub fn navigator() -> Navigator { + Navigator( + dioxus::core::prelude::consume_context::() + .expect("A router must be present to use navigator"), + ) +} + /// A view into the navigation state of a router. #[derive(Clone)] pub struct Navigator(pub(crate) RouterContext); diff --git a/packages/router/src/hooks/use_navigator.rs b/packages/router/src/hooks/use_navigator.rs index a05cd036f..9d367d83d 100644 --- a/packages/router/src/hooks/use_navigator.rs +++ b/packages/router/src/hooks/use_navigator.rs @@ -49,6 +49,7 @@ use crate::prelude::{Navigator, RouterContext}; /// # let _ = vdom.rebuild(); /// ``` #[must_use] +#[deprecated = "Prefer acquiring the router directly with `dioxus_router::router()`"] pub fn use_navigator(cx: &ScopeState) -> &Navigator { &*cx.use_hook(|| { let router = cx diff --git a/packages/router/src/hooks/use_router.rs b/packages/router/src/hooks/use_router.rs index 5f1f13e45..2cb628160 100644 --- a/packages/router/src/hooks/use_router.rs +++ b/packages/router/src/hooks/use_router.rs @@ -2,7 +2,7 @@ use dioxus::prelude::ScopeState; use crate::{prelude::RouterContext, utils::use_router_internal::use_router_internal}; -#[deprecated = "prefer the use_navigator or use_route functions"] +#[deprecated = "prefer the `router()` function or `use_route` functions"] #[must_use] /// A hook that provides access to information about the router. pub fn use_router(cx: &ScopeState) -> &RouterContext { @@ -10,3 +10,8 @@ pub fn use_router(cx: &ScopeState) -> &RouterContext { .as_ref() .expect("use_route must have access to a router") } + +/// Aquire the router without subscribing to updates. +pub fn router() -> RouterContext { + dioxus::core::prelude::consume_context().unwrap() +} diff --git a/packages/router/src/lib.rs b/packages/router/src/lib.rs index e871dc6c9..a1432d5b9 100644 --- a/packages/router/src/lib.rs +++ b/packages/router/src/lib.rs @@ -53,6 +53,8 @@ pub mod hooks { pub use use_navigator::*; } +pub use hooks::router; + /// A collection of useful items most applications might need. pub mod prelude { pub use crate::components::*; From 1fe8e940637ac151e5f93af2581cc0cc947253b0 Mon Sep 17 00:00:00 2001 From: Jonathan Kelley Date: Mon, 23 Oct 2023 16:30:39 -0400 Subject: [PATCH 208/447] Deprecate use_window --- packages/desktop/src/desktop_context.rs | 1 + 1 file changed, 1 insertion(+) diff --git a/packages/desktop/src/desktop_context.rs b/packages/desktop/src/desktop_context.rs index 22f6dbf8f..74a2da8b0 100644 --- a/packages/desktop/src/desktop_context.rs +++ b/packages/desktop/src/desktop_context.rs @@ -38,6 +38,7 @@ pub fn window() -> DesktopContext { } /// Get an imperative handle to the current window +#[deprecated = "Prefer the using the `window` function directly for cleaner code"] pub fn use_window(cx: &ScopeState) -> &DesktopContext { cx.use_hook(|| cx.consume_context::()) .as_ref() From 33d4721fbe06908b6cd7e41ede63333e697bb37c Mon Sep 17 00:00:00 2001 From: Leonard Date: Tue, 24 Oct 2023 00:10:56 +0200 Subject: [PATCH 209/447] Fix --- .../component_body_deserializers/inline_props.rs | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/packages/core-macro/src/component_body_deserializers/inline_props.rs b/packages/core-macro/src/component_body_deserializers/inline_props.rs index 670a14d88..d51132623 100644 --- a/packages/core-macro/src/component_body_deserializers/inline_props.rs +++ b/packages/core-macro/src/component_body_deserializers/inline_props.rs @@ -186,13 +186,13 @@ fn get_props_docs(fn_ident: &Ident, inputs: Vec<&FnArg>) -> Vec { let arg_name = arg_name.into_token_stream().to_string(); let arg_type = crate::utils::format_type_string(arg_type); - let input_arg_doc = - keep_up_to_n_consecutive_chars(input_arg_doc.trim(), 2, '\n').replace('\n', "
"); + let input_arg_doc = keep_up_to_n_consecutive_chars(input_arg_doc.trim(), 2, '\n') + .replace("\n\n", "

"); let prop_def_link = format!("{props_def_link}::{arg_name}"); let mut arg_doc = format!("- [`{arg_name}`]({prop_def_link}) : `{arg_type}`"); if let Some(deprecation) = deprecation { - arg_doc.push_str("
πŸ‘Ž Deprecated"); + arg_doc.push_str("

πŸ‘Ž Deprecated"); if let Some(since) = deprecation.since { arg_doc.push_str(&format!(" since {since}")); @@ -205,14 +205,16 @@ fn get_props_docs(fn_ident: &Ident, inputs: Vec<&FnArg>) -> Vec { arg_doc.push_str(&format!(": {note}")); } + arg_doc.push_str("

"); + if !input_arg_doc.is_empty() { arg_doc.push_str("
"); } - } else { - arg_doc.push_str("
"); } - arg_doc.push_str(&input_arg_doc); + if !input_arg_doc.is_empty() { + arg_doc.push_str(&format!("

{input_arg_doc}

")); + } props_docs.push(parse_quote! { #[doc = #arg_doc] From 85839abe5668a34c87a2d325ef2dd5a115ec7978 Mon Sep 17 00:00:00 2001 From: Leonard Date: Tue, 24 Oct 2023 01:35:59 +0200 Subject: [PATCH 210/447] Fix random clippy warning --- packages/desktop/src/protocol.rs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/desktop/src/protocol.rs b/packages/desktop/src/protocol.rs index 53652f82f..3d51e3ac1 100644 --- a/packages/desktop/src/protocol.rs +++ b/packages/desktop/src/protocol.rs @@ -153,7 +153,7 @@ fn get_asset_root() -> Option { /// Get the mime type from a path-like string fn get_mime_from_path(trimmed: &Path) -> Result<&'static str> { - if trimmed.ends_with(".svg") { + if trimmed.extension().is_some_and(|ext| ext == ".svg") { return Ok("image/svg+xml"); } From 613f2f9acaff5295395c7ce001cb41561203a6b6 Mon Sep 17 00:00:00 2001 From: Leonard Date: Tue, 24 Oct 2023 01:41:46 +0200 Subject: [PATCH 211/447] Revert "Fix random clippy warning" This reverts commit 85839abe5668a34c87a2d325ef2dd5a115ec7978. --- packages/desktop/src/protocol.rs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/desktop/src/protocol.rs b/packages/desktop/src/protocol.rs index 3d51e3ac1..53652f82f 100644 --- a/packages/desktop/src/protocol.rs +++ b/packages/desktop/src/protocol.rs @@ -153,7 +153,7 @@ fn get_asset_root() -> Option { /// Get the mime type from a path-like string fn get_mime_from_path(trimmed: &Path) -> Result<&'static str> { - if trimmed.extension().is_some_and(|ext| ext == ".svg") { + if trimmed.ends_with(".svg") { return Ok("image/svg+xml"); } From 9de56c00f305a71cc25e491dad0e4a1f5ef94616 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Tue, 24 Oct 2023 13:09:10 -0500 Subject: [PATCH 212/447] fix multiple types of desktop/liveview listeners in the same app --- packages/desktop/src/lib.rs | 5 ++++- packages/interpreter/src/sledgehammer_bindings.rs | 3 ++- 2 files changed, 6 insertions(+), 2 deletions(-) diff --git a/packages/desktop/src/lib.rs b/packages/desktop/src/lib.rs index 4780690ee..c67ecbc80 100644 --- a/packages/desktop/src/lib.rs +++ b/packages/desktop/src/lib.rs @@ -276,7 +276,10 @@ pub fn launch_with_props(root: Component

, props: P, cfg: Config) let evt = match serde_json::from_value::(params) { Ok(value) => value, - Err(_) => return, + Err(err) => { + tracing::error!("Error parsing user_event: {:?}", err); + return; + } }; let HtmlEvent { diff --git a/packages/interpreter/src/sledgehammer_bindings.rs b/packages/interpreter/src/sledgehammer_bindings.rs index 981197787..fc66fb5a8 100644 --- a/packages/interpreter/src/sledgehammer_bindings.rs +++ b/packages/interpreter/src/sledgehammer_bindings.rs @@ -355,7 +355,7 @@ pub mod binary_protocol { fn add_placeholder() { "{node = document.createElement('pre'); node.hidden = true; stack.push(node);}" } - fn new_event_listener(event_name: &str, id: u32, bubbles: u8) { + fn new_event_listener(event: &str, id: u32, bubbles: u8) { r#" bubbles = bubbles == 1; node = nodes[id]; @@ -365,6 +365,7 @@ pub mod binary_protocol { node.listening = 1; } node.setAttribute('data-dioxus-id', `\${id}`); + const event_name = $event$; // if this is a mounted listener, we send the event immediately if (event_name === "mounted") { From dc306a51ba8479a8f93fbe3f22d57021e3165698 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Tue, 24 Oct 2023 13:17:34 -0500 Subject: [PATCH 213/447] fix desktop inner html --- packages/interpreter/src/common.js | 2 +- .../interpreter/src/sledgehammer_bindings.rs | 46 +------------------ 2 files changed, 2 insertions(+), 46 deletions(-) diff --git a/packages/interpreter/src/common.js b/packages/interpreter/src/common.js index 3745e8c6b..381939fb8 100644 --- a/packages/interpreter/src/common.js +++ b/packages/interpreter/src/common.js @@ -36,7 +36,7 @@ export function setAttributeInner(node, field, value, ns) { node.style = {}; } node.style[name] = value; - } else if (ns != null && ns != undefined) { + } else if (!!ns) { node.setAttributeNS(ns, name, value); } else { switch (name) { diff --git a/packages/interpreter/src/sledgehammer_bindings.rs b/packages/interpreter/src/sledgehammer_bindings.rs index fc66fb5a8..54162fc8a 100644 --- a/packages/interpreter/src/sledgehammer_bindings.rs +++ b/packages/interpreter/src/sledgehammer_bindings.rs @@ -11,6 +11,7 @@ pub const SLEDGEHAMMER_JS: &str = GENERATED_JS; #[cfg(feature = "web")] #[bindgen(module)] mod js { + const JS_FILE: &str = "./packages/interpreter/src/common.js"; const JS: &str = r#" class ListenerMap { constructor(root) { @@ -64,51 +65,6 @@ mod js { delete this.local[id]; } } - function SetAttributeInner(node, field, value, ns) { - const name = field; - if (ns === "style") { - // ????? why do we need to do this - if (node.style === undefined) { - node.style = {}; - } - node.style[name] = value; - } else if (ns !== null && ns !== undefined && ns !== "") { - node.setAttributeNS(ns, name, value); - } else { - switch (name) { - case "value": - if (value !== node.value) { - node.value = value; - } - break; - case "initial_value": - node.defaultValue = value; - break; - case "checked": - node.checked = truthy(value); - break; - case "initial_checked": - node.defaultChecked = truthy(value); - break; - case "selected": - node.selected = truthy(value); - break; - case "initial_selected": - node.defaultSelected = truthy(value); - break; - case "dangerous_inner_html": - node.innerHTML = value; - break; - default: - // https://github.com/facebook/react/blob/8b88ac2592c5f555f315f9440cbb665dd1e7457a/packages/react-dom/src/shared/DOMProperty.js#L352-L364 - if (!truthy(value) && bool_attrs.hasOwnProperty(name)) { - node.removeAttribute(name); - } else { - node.setAttribute(name, value); - } - } - } - } function LoadChild(ptr, len) { // iterate through each number and get that child node = stack[stack.length - 1]; From 3bb6042e42bdf1e07c7f2364a54347cf59153e41 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Wed, 25 Oct 2023 10:22:05 -0500 Subject: [PATCH 214/447] fix web renderer imports --- packages/interpreter/src/common.js | 60 +++++++++---------- .../interpreter/src/sledgehammer_bindings.rs | 34 +---------- 2 files changed, 31 insertions(+), 63 deletions(-) diff --git a/packages/interpreter/src/common.js b/packages/interpreter/src/common.js index 381939fb8..0c64085f9 100644 --- a/packages/interpreter/src/common.js +++ b/packages/interpreter/src/common.js @@ -1,33 +1,3 @@ -const bool_attrs = { - allowfullscreen: true, - allowpaymentrequest: true, - async: true, - autofocus: true, - autoplay: true, - checked: true, - controls: true, - default: true, - defer: true, - disabled: true, - formnovalidate: true, - hidden: true, - ismap: true, - itemscope: true, - loop: true, - multiple: true, - muted: true, - nomodule: true, - novalidate: true, - open: true, - playsinline: true, - readonly: true, - required: true, - reversed: true, - selected: true, - truespeed: true, - webkitdirectory: true, -}; - export function setAttributeInner(node, field, value, ns) { const name = field; if (ns === "style") { @@ -74,6 +44,36 @@ export function setAttributeInner(node, field, value, ns) { } } +const bool_attrs = { + allowfullscreen: true, + allowpaymentrequest: true, + async: true, + autofocus: true, + autoplay: true, + checked: true, + controls: true, + default: true, + defer: true, + disabled: true, + formnovalidate: true, + hidden: true, + ismap: true, + itemscope: true, + loop: true, + multiple: true, + muted: true, + nomodule: true, + novalidate: true, + open: true, + playsinline: true, + readonly: true, + required: true, + reversed: true, + selected: true, + truespeed: true, + webkitdirectory: true, +}; + function truthy(val) { return val === "true" || val === true; } diff --git a/packages/interpreter/src/sledgehammer_bindings.rs b/packages/interpreter/src/sledgehammer_bindings.rs index 54162fc8a..00b6d8ca0 100644 --- a/packages/interpreter/src/sledgehammer_bindings.rs +++ b/packages/interpreter/src/sledgehammer_bindings.rs @@ -105,38 +105,6 @@ mod js { root.appendChild(els[k]); } } - const bool_attrs = { - allowfullscreen: true, - allowpaymentrequest: true, - async: true, - autofocus: true, - autoplay: true, - checked: true, - controls: true, - default: true, - defer: true, - disabled: true, - formnovalidate: true, - hidden: true, - ismap: true, - itemscope: true, - loop: true, - multiple: true, - muted: true, - nomodule: true, - novalidate: true, - open: true, - playsinline: true, - readonly: true, - required: true, - reversed: true, - selected: true, - truespeed: true, - webkitdirectory: true, - }; - function truthy(val) { - return val === "true" || val === true; - } "#; extern "C" { @@ -196,7 +164,7 @@ mod js { "{nodes[$id$].textContent = $text$;}" } fn set_attribute(id: u32, field: &str, value: &str, ns: &str) { - "{node = nodes[$id$]; SetAttributeInner(node, $field$, $value$, $ns$);}" + "{node = nodes[$id$]; setAttributeInner(node, $field$, $value$, $ns$);}" } fn remove_attribute(id: u32, field: &str, ns: &str) { r#"{ From 6e85ecea128d5d30aaadc6ae3f466623950b8c75 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Wed, 25 Oct 2023 10:23:23 -0500 Subject: [PATCH 215/447] fix use shared state lint in release mode --- packages/hooks/src/use_shared_state.rs | 1 + 1 file changed, 1 insertion(+) diff --git a/packages/hooks/src/use_shared_state.rs b/packages/hooks/src/use_shared_state.rs index 37226c759..0c0f43508 100644 --- a/packages/hooks/src/use_shared_state.rs +++ b/packages/hooks/src/use_shared_state.rs @@ -26,6 +26,7 @@ macro_rules! debug_location { } pub mod error { + #[cfg(debug_assertions)] fn locations_display(locations: &[&'static std::panic::Location<'static>]) -> String { locations .iter() From b9dae3e1e0c535225a64756e58dd7570caabf9ad Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Wed, 25 Oct 2023 15:06:08 -0500 Subject: [PATCH 216/447] don't ignore leaks in miri --- .github/workflows/miri.yml | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/.github/workflows/miri.yml b/.github/workflows/miri.yml index 4a467b9b2..f9ad3855f 100644 --- a/.github/workflows/miri.yml +++ b/.github/workflows/miri.yml @@ -86,8 +86,7 @@ jobs: # working-directory: tokio env: - # todo: disable memory leaks ignore - MIRIFLAGS: -Zmiri-disable-isolation -Zmiri-strict-provenance -Zmiri-retag-fields -Zmiri-ignore-leaks + MIRIFLAGS: -Zmiri-disable-isolation -Zmiri-strict-provenance -Zmiri-retag-fields PROPTEST_CASES: 10 # Cache the global cargo directory, but NOT the local `target` directory which From b25fada776c61013217540c0a3cd6f4294563c81 Mon Sep 17 00:00:00 2001 From: Stephen Andary Date: Wed, 25 Oct 2023 16:36:38 -0400 Subject: [PATCH 217/447] Add Newtype so that Rust-url can be IntoRoutable (#1579) * add newtype so that rust-url can IntoRoutable * add doc line * implement From directly --------- Co-authored-by: Evan Almloff --- packages/router/src/components/link.rs | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/packages/router/src/components/link.rs b/packages/router/src/components/link.rs index 787f9cdc9..639d99ae7 100644 --- a/packages/router/src/components/link.rs +++ b/packages/router/src/components/link.rs @@ -11,6 +11,8 @@ use crate::navigation::NavigationTarget; use crate::prelude::Routable; use crate::utils::use_router_internal::use_router_internal; +use url::Url; + /// Something that can be converted into a [`NavigationTarget`]. #[derive(Clone)] pub enum IntoRoutable { @@ -53,6 +55,18 @@ impl From<&str> for IntoRoutable { } } +impl From for IntoRoutable { + fn from(url: Url) -> Self { + IntoRoutable::FromStr(url.to_string()) + } +} + +impl From<&Url> for IntoRoutable { + fn from(url: &Url) -> Self { + IntoRoutable::FromStr(url.to_string()) + } +} + /// The properties for a [`Link`]. #[derive(Props)] pub struct LinkProps<'a> { From b99f081c0839defc9d9c61cb428f5e6b1464aab6 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Wed, 25 Oct 2023 16:37:04 -0500 Subject: [PATCH 218/447] drop any attribute after rendering --- packages/core/src/arena.rs | 5 +---- packages/core/src/bump_frame.rs | 28 +++++++++++++++++++++++++--- packages/core/src/scope_arena.rs | 4 ++-- packages/core/src/scopes.rs | 12 +++++++++--- 4 files changed, 37 insertions(+), 12 deletions(-) diff --git a/packages/core/src/arena.rs b/packages/core/src/arena.rs index b7f768755..4f441bb81 100644 --- a/packages/core/src/arena.rs +++ b/packages/core/src/arena.rs @@ -164,16 +164,13 @@ impl VirtualDom { }); // Now that all the references are gone, we can safely drop our own references in our listeners. - let mut listeners = scope.attributes_to_drop.borrow_mut(); + let mut listeners = scope.attributes_to_drop_before_render.borrow_mut(); listeners.drain(..).for_each(|listener| { let listener = unsafe { &*listener }; match &listener.value { AttributeValue::Listener(l) => { _ = l.take(); } - AttributeValue::Any(a) => { - _ = a.take(); - } _ => (), } }); diff --git a/packages/core/src/bump_frame.rs b/packages/core/src/bump_frame.rs index 0fe7b3867..d4b3d2e07 100644 --- a/packages/core/src/bump_frame.rs +++ b/packages/core/src/bump_frame.rs @@ -1,10 +1,13 @@ use crate::nodes::RenderReturn; +use crate::{Attribute, AttributeValue}; use bumpalo::Bump; +use std::cell::RefCell; use std::cell::{Cell, UnsafeCell}; pub(crate) struct BumpFrame { pub bump: UnsafeCell, pub node: Cell<*const RenderReturn<'static>>, + pub(crate) attributes_to_drop_before_reset: RefCell>>, } impl BumpFrame { @@ -13,6 +16,7 @@ impl BumpFrame { Self { bump: UnsafeCell::new(bump), node: Cell::new(std::ptr::null()), + attributes_to_drop_before_reset: Default::default(), } } @@ -31,8 +35,26 @@ impl BumpFrame { unsafe { &*self.bump.get() } } - #[allow(clippy::mut_from_ref)] - pub(crate) unsafe fn bump_mut(&self) -> &mut Bump { - unsafe { &mut *self.bump.get() } + pub(crate) fn add_attribute_to_drop(&self, attribute: *const Attribute<'static>) { + self.attributes_to_drop_before_reset + .borrow_mut() + .push(attribute); + } + + pub(crate) unsafe fn reset(&self) { + let mut attributes = self.attributes_to_drop_before_reset.borrow_mut(); + attributes.drain(..).for_each(|attribute| { + let attribute = unsafe { &*attribute }; + match &attribute.value { + AttributeValue::Any(l) => { + _ = l.take(); + } + _ => (), + } + }); + unsafe { + let bump = &mut *self.bump.get(); + bump.reset(); + } } } diff --git a/packages/core/src/scope_arena.rs b/packages/core/src/scope_arena.rs index 1ed5b816c..397f5328e 100644 --- a/packages/core/src/scope_arena.rs +++ b/packages/core/src/scope_arena.rs @@ -35,7 +35,7 @@ impl VirtualDom { hook_idx: Default::default(), borrowed_props: Default::default(), - attributes_to_drop: Default::default(), + attributes_to_drop_before_render: Default::default(), })); let context = @@ -54,7 +54,7 @@ impl VirtualDom { let new_nodes = unsafe { let scope = &self.scopes[scope_id.0]; - scope.previous_frame().bump_mut().reset(); + scope.previous_frame().reset(); scope.context().suspended.set(false); diff --git a/packages/core/src/scopes.rs b/packages/core/src/scopes.rs index 996529a0d..3fd2aac30 100644 --- a/packages/core/src/scopes.rs +++ b/packages/core/src/scopes.rs @@ -94,7 +94,7 @@ pub struct ScopeState { pub(crate) hook_idx: Cell, pub(crate) borrowed_props: RefCell>>, - pub(crate) attributes_to_drop: RefCell>>, + pub(crate) attributes_to_drop_before_render: RefCell>>, pub(crate) props: Option>>, } @@ -348,13 +348,19 @@ impl<'src> ScopeState { pub fn render(&'src self, rsx: LazyNodes<'src, '_>) -> Element<'src> { let element = rsx.call(self); - let mut listeners = self.attributes_to_drop.borrow_mut(); + let mut listeners = self.attributes_to_drop_before_render.borrow_mut(); for attr in element.dynamic_attrs { match attr.value { - AttributeValue::Any(_) | AttributeValue::Listener(_) => { + // We need to drop listeners before the next render because they may borrow data from the borrowed props which will be dropped + AttributeValue::Listener(_) => { let unbounded = unsafe { std::mem::transmute(attr as *const Attribute) }; listeners.push(unbounded); } + // We need to drop any values manually to make sure that their drop implementation is called before the next render + AttributeValue::Any(_) => { + let unbounded = unsafe { std::mem::transmute(attr as *const Attribute) }; + self.previous_frame().add_attribute_to_drop(unbounded); + } _ => (), } From 370c6cb9d2333b5bee1f5bafe92d9dad05d8f11f Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Wed, 25 Oct 2023 16:47:04 -0500 Subject: [PATCH 219/447] fix clippy --- packages/core/src/arena.rs | 7 ++----- packages/core/src/bump_frame.rs | 7 ++----- 2 files changed, 4 insertions(+), 10 deletions(-) diff --git a/packages/core/src/arena.rs b/packages/core/src/arena.rs index 4f441bb81..785d4b174 100644 --- a/packages/core/src/arena.rs +++ b/packages/core/src/arena.rs @@ -167,11 +167,8 @@ impl VirtualDom { let mut listeners = scope.attributes_to_drop_before_render.borrow_mut(); listeners.drain(..).for_each(|listener| { let listener = unsafe { &*listener }; - match &listener.value { - AttributeValue::Listener(l) => { - _ = l.take(); - } - _ => (), + if let AttributeValue::Listener(l) = &listener.value { + _ = l.take(); } }); } diff --git a/packages/core/src/bump_frame.rs b/packages/core/src/bump_frame.rs index d4b3d2e07..bf630c605 100644 --- a/packages/core/src/bump_frame.rs +++ b/packages/core/src/bump_frame.rs @@ -45,11 +45,8 @@ impl BumpFrame { let mut attributes = self.attributes_to_drop_before_reset.borrow_mut(); attributes.drain(..).for_each(|attribute| { let attribute = unsafe { &*attribute }; - match &attribute.value { - AttributeValue::Any(l) => { - _ = l.take(); - } - _ => (), + if let AttributeValue::Any(l) = &attribute.value { + _ = l.take(); } }); unsafe { From eea4a02ef59c07fcd2e143e838a4080a8d59cb49 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Thu, 26 Oct 2023 13:23:12 -0500 Subject: [PATCH 220/447] add comments about the cause of the leak --- packages/core/src/bump_frame.rs | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/packages/core/src/bump_frame.rs b/packages/core/src/bump_frame.rs index 9ae11ab79..6927bd8bc 100644 --- a/packages/core/src/bump_frame.rs +++ b/packages/core/src/bump_frame.rs @@ -7,6 +7,8 @@ use std::cell::{Cell, UnsafeCell}; pub(crate) struct BumpFrame { pub bump: UnsafeCell, pub node: Cell<*const RenderReturn<'static>>, + + // The bump allocator will not call the destructor of the objects it allocated. Attributes and props need to have there destructor called, so we keep a list of them to drop before the bump allocator is reset. pub(crate) attributes_to_drop_before_reset: RefCell>>, pub(crate) props_to_drop_before_reset: RefCell>>, } @@ -43,6 +45,10 @@ impl BumpFrame { .push(attribute); } + /// Reset the bump allocator and drop all the attributes and props that were allocated in it. + /// + /// # Safety + /// The caller must insure that no reference to anything allocated in the bump allocator is available after this function is called. pub(crate) unsafe fn reset(&self) { let mut attributes = self.attributes_to_drop_before_reset.borrow_mut(); attributes.drain(..).for_each(|attribute| { From f5bc1a9856c0287f14526830df6c83d98f1116e8 Mon Sep 17 00:00:00 2001 From: Emil Boman Date: Thu, 26 Oct 2023 21:19:51 +0200 Subject: [PATCH 221/447] Implement LiveView Router Integration (#1505) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Fix GoForwardButton calling can_go_back instead of can_go_forward * Add first draft of LiveviewHistory * Add external URL redirect * Lock evaluator channel outside loop * Add liveview to router examples * fixup! Add liveview to router examples * Communicate with liveview server on page load * Add PopState event to Liveview routing * Call updater callback from liveview history * Add rudimentary PopState functionality to liveview router. * Fix linter errors * Refactor * Fix navigator external redirection not working. * Add go back and go forward buttons to router examples * Finish functionality for timeline stack in liveview router * Add docs to LiveviewHistory * Replace Liveview history context attachment with constructor that takes context * Fix go forward/backward history/future shuffle * Support history across entire liveview session, if contiguous page jumps. * Remove unnecessary bounds * Add query and hash to location string * Run rustfmt * fix: Update server function docs link (#1489) * liveview: Add `interpreter_glue_relative_uri (#1481) * liveview: Add `interpreter_glue_relative_uri` By utilizing `window.location.host` in the client-side JavaScript, we can easily derive the WebSocket URI from a relative path URI. This approach obviates the need for host address retrieval on the server side, unlike the method of serving glue code in liveview using `interpreter_glue`. * liveview: Merge `.._relative_url` functionality - Merged `.._relative_url` to current API `interpreter_glue`. - Edit axum example to work with new feature. * liveview: Fix clippy warning * Rename modules to use snake_case (#1498) * Change Scope into &ScopeState * Move synchronization of state into router and make it opt-in --------- Co-authored-by: Marc EspΓ­n Co-authored-by: Seungwoo Kang Co-authored-by: Leonard Co-authored-by: Evan Almloff --- packages/router/Cargo.toml | 5 + packages/router/examples/simple_routes.rs | 72 ++- .../router/src/components/history_buttons.rs | 2 +- packages/router/src/contexts/router.rs | 2 +- packages/router/src/history/liveview.rs | 441 ++++++++++++++++++ packages/router/src/history/mod.rs | 5 + 6 files changed, 517 insertions(+), 10 deletions(-) create mode 100644 packages/router/src/history/liveview.rs diff --git a/packages/router/Cargo.toml b/packages/router/Cargo.toml index 80923d539..da9d3fe85 100644 --- a/packages/router/Cargo.toml +++ b/packages/router/Cargo.toml @@ -19,6 +19,7 @@ thiserror = { workspace = true } futures-util = { workspace = true } urlencoding = "2.1.3" serde = { version = "1", features = ["derive"], optional = true } +serde_json = { version = "1.0.91", optional = true } url = "2.3.1" wasm-bindgen = { workspace = true, optional = true } web-sys = { version = "0.3.60", optional = true, features = [ @@ -26,18 +27,22 @@ web-sys = { version = "0.3.60", optional = true, features = [ ] } js-sys = { version = "0.3.63", optional = true } gloo-utils = { version = "0.1.6", optional = true } +dioxus-liveview = { workspace = true, optional = true } dioxus-ssr = { workspace = true, optional = true } tokio = { workspace = true, features = ["full"], optional = true } [features] default = ["web"] ssr = ["dioxus-ssr", "tokio"] +liveview = ["dioxus-liveview", "tokio", "dep:serde", "serde_json"] wasm_test = [] serde = ["dep:serde", "gloo-utils/serde"] web = ["gloo", "web-sys", "wasm-bindgen", "gloo-utils", "js-sys"] [dev-dependencies] +axum = { version = "0.6.1", features = ["ws"] } dioxus = { path = "../dioxus" } +dioxus-liveview = { workspace = true, features = ["axum"] } dioxus-ssr = { path = "../ssr" } criterion = { version = "0.5", features = ["async_tokio", "html_reports"] } diff --git a/packages/router/examples/simple_routes.rs b/packages/router/examples/simple_routes.rs index 3634f7df3..aac1e8658 100644 --- a/packages/router/examples/simple_routes.rs +++ b/packages/router/examples/simple_routes.rs @@ -2,6 +2,47 @@ use dioxus::prelude::*; use dioxus_router::prelude::*; use std::str::FromStr; +#[cfg(feature = "liveview")] +#[tokio::main] +async fn main() { + use axum::{extract::ws::WebSocketUpgrade, response::Html, routing::get, Router}; + + let listen_address: std::net::SocketAddr = ([127, 0, 0, 1], 3030).into(); + let view = dioxus_liveview::LiveViewPool::new(); + let app = Router::new() + .fallback(get(move || async move { + Html(format!( + r#" + + + +

+ {glue} + + "#, + glue = dioxus_liveview::interpreter_glue(&format!("ws://{listen_address}/ws")) + )) + })) + .route( + "/ws", + get(move |ws: WebSocketUpgrade| async move { + ws.on_upgrade(move |socket| async move { + _ = view + .launch(dioxus_liveview::axum_socket(socket), Root) + .await; + }) + }), + ); + + println!("Listening on http://{listen_address}"); + + axum::Server::bind(&listen_address.to_string().parse().unwrap()) + .serve(app.into_make_service()) + .await + .unwrap(); +} + +#[cfg(not(feature = "liveview"))] fn main() { #[cfg(not(target_arch = "wasm32"))] dioxus_desktop::launch(Root); @@ -10,21 +51,26 @@ fn main() { dioxus_web::launch(root); } +#[cfg(feature = "liveview")] #[component] fn Root(cx: Scope) -> Element { - render! { - Router:: {} - } + let history = LiveviewHistory::new(cx); + render! { Router:: { + config: || RouterConfig::default().history(history), + } } +} + +#[cfg(not(feature = "liveview"))] +#[component] +fn Root(cx: Scope) -> Element { + render! { Router:: {} } } #[component] fn UserFrame(cx: Scope, user_id: usize) -> Element { render! { - pre { - "UserFrame{{\n\tuser_id:{user_id}\n}}" - } - div { - background_color: "rgba(0,0,0,50%)", + pre { "UserFrame{{\n\tuser_id:{user_id}\n}}" } + div { background_color: "rgba(0,0,0,50%)", "children:" Outlet:: {} } @@ -88,6 +134,16 @@ fn Route3(cx: Scope, dynamic: String) -> Element { to: Route::Route2 { user_id: 8888 }, "hello world link" } + button { + disabled: !navigator.can_go_back(), + onclick: move |_| { navigator.go_back(); }, + "go back" + } + button { + disabled: !navigator.can_go_forward(), + onclick: move |_| { navigator.go_forward(); }, + "go forward" + } button { onclick: move |_| { navigator.push("https://www.google.com"); }, "google link" diff --git a/packages/router/src/components/history_buttons.rs b/packages/router/src/components/history_buttons.rs index eb62e9285..ae11ad276 100644 --- a/packages/router/src/components/history_buttons.rs +++ b/packages/router/src/components/history_buttons.rs @@ -142,7 +142,7 @@ pub fn GoForwardButton<'a>(cx: Scope<'a, HistoryButtonProps<'a>>) -> Element { } }; - let disabled = !router.can_go_back(); + let disabled = !router.can_go_forward(); render! { button { diff --git a/packages/router/src/contexts/router.rs b/packages/router/src/contexts/router.rs index b15956991..079640e61 100644 --- a/packages/router/src/contexts/router.rs +++ b/packages/router/src/contexts/router.rs @@ -232,7 +232,7 @@ impl RouterContext { IntoRoutable::FromStr(url) => { let parsed_route: NavigationTarget> = match self.route_from_str(&url) { Ok(route) => NavigationTarget::Internal(route), - Err(err) => NavigationTarget::External(err), + Err(_) => NavigationTarget::External(url), }; parsed_route } diff --git a/packages/router/src/history/liveview.rs b/packages/router/src/history/liveview.rs new file mode 100644 index 000000000..9ffb09c34 --- /dev/null +++ b/packages/router/src/history/liveview.rs @@ -0,0 +1,441 @@ +use super::HistoryProvider; +use crate::routable::Routable; +use dioxus::prelude::*; +use serde::{Deserialize, Serialize}; +use std::sync::{Mutex, RwLock}; +use std::{collections::BTreeMap, rc::Rc, str::FromStr, sync::Arc}; + +/// A [`HistoryProvider`] that evaluates history through JS. +pub struct LiveviewHistory +where + ::Err: std::fmt::Display, +{ + action_tx: tokio::sync::mpsc::UnboundedSender>, + timeline: Arc>>, + updater_callback: Arc>>, +} + +struct Timeline +where + ::Err: std::fmt::Display, +{ + current_index: usize, + routes: BTreeMap, +} + +#[derive(Serialize, Deserialize, Debug)] +struct State { + index: usize, +} + +#[derive(Serialize, Deserialize, Debug)] +struct Session +where + ::Err: std::fmt::Display, +{ + #[serde(with = "routes")] + routes: BTreeMap, + last_visited: usize, +} + +#[derive(Serialize, Deserialize)] +struct SessionStorage { + liveview: Option, +} + +enum Action { + GoBack, + GoForward, + Push(R), + Replace(R), + External(String), +} + +impl Timeline +where + ::Err: std::fmt::Display, +{ + fn new(initial_path: R) -> Self { + Self { + current_index: 0, + routes: BTreeMap::from([(0, initial_path)]), + } + } + + fn init( + &mut self, + route: R, + state: Option, + session: Option>, + depth: usize, + ) -> State { + if let Some(session) = session { + self.routes = session.routes; + if state.is_none() { + // top of stack + let last_visited = session.last_visited; + self.routes.retain(|&lhs, _| lhs <= last_visited); + } + }; + let state = match state { + Some(state) => { + self.current_index = state.index; + state + } + None => { + let index = depth - 1; + self.current_index = index; + State { index } + } + }; + self.routes.insert(state.index, route); + state + } + + fn update(&mut self, route: R, state: Option) -> State { + if let Some(state) = state { + self.current_index = state.index; + self.routes.insert(self.current_index, route); + state + } else { + self.push(route) + } + } + + fn push(&mut self, route: R) -> State { + // top of stack + let index = self.current_index + 1; + self.current_index = index; + self.routes.insert(index, route); + self.routes.retain(|&rhs, _| index >= rhs); + State { + index: self.current_index, + } + } + + fn replace(&mut self, route: R) -> State { + self.routes.insert(self.current_index, route); + State { + index: self.current_index, + } + } + + fn current_route(&self) -> &R { + &self.routes[&self.current_index] + } + + fn session(&self) -> Session { + Session { + routes: self.routes.clone(), + last_visited: self.current_index, + } + } +} + +impl LiveviewHistory +where + ::Err: std::fmt::Display, +{ + /// Create a [`LiveviewHistory`] in the given scope. + /// When using a [`LiveviewHistory`] in combination with use_eval, history must be untampered with. + /// + /// # Panics + /// + /// Panics if not in a Liveview context. + pub fn new(cx: &ScopeState) -> Self { + Self::new_with_initial_path( + cx, + "/".parse().unwrap_or_else(|err| { + panic!("index route does not exist:\n{}\n use LiveviewHistory::new_with_initial_path to set a custom path", err) + }), + ) + } + + /// Create a [`LiveviewHistory`] in the given scope, starting at `initial_path`. + /// When using a [`LiveviewHistory`] in combination with use_eval, history must be untampered with. + /// + /// # Panics + /// + /// Panics if not in a Liveview context. + pub fn new_with_initial_path(cx: &ScopeState, initial_path: R) -> Self { + let (action_tx, action_rx) = tokio::sync::mpsc::unbounded_channel::>(); + let action_rx = Arc::new(Mutex::new(action_rx)); + let timeline = Arc::new(Mutex::new(Timeline::new(initial_path))); + let updater_callback: Arc>> = + Arc::new(RwLock::new(Arc::new(|| {}))); + + let eval_provider = cx + .consume_context::>() + .expect("evaluator not provided"); + + let create_eval = Rc::new(move |script: &str| { + eval_provider + .new_evaluator(script.to_string()) + .map(UseEval::new) + }) as Rc Result>; + + // Listen to server actions + cx.push_future({ + let timeline = timeline.clone(); + let action_rx = action_rx.clone(); + let create_eval = create_eval.clone(); + async move { + let mut action_rx = action_rx.lock().expect("unpoisoned mutex"); + loop { + let eval = action_rx.recv().await.expect("sender to exist"); + let _ = match eval { + Action::GoBack => create_eval( + r#" + // this triggers a PopState event + history.back(); + "#, + ), + Action::GoForward => create_eval( + r#" + // this triggers a PopState event + history.forward(); + "#, + ), + Action::Push(route) => { + let mut timeline = timeline.lock().expect("unpoisoned mutex"); + let state = timeline.push(route.clone()); + let state = serde_json::to_string(&state).expect("serializable state"); + let session = serde_json::to_string(&timeline.session()) + .expect("serializable session"); + create_eval(&format!( + r#" + // this does not trigger a PopState event + history.pushState({state}, "", "{route}"); + sessionStorage.setItem("liveview", '{session}'); + "# + )) + } + Action::Replace(route) => { + let mut timeline = timeline.lock().expect("unpoisoned mutex"); + let state = timeline.replace(route.clone()); + let state = serde_json::to_string(&state).expect("serializable state"); + let session = serde_json::to_string(&timeline.session()) + .expect("serializable session"); + create_eval(&format!( + r#" + // this does not trigger a PopState event + history.replaceState({state}, "", "{route}"); + sessionStorage.setItem("liveview", '{session}'); + "# + )) + } + Action::External(url) => create_eval(&format!( + r#" + location.href = "{url}"; + "# + )), + }; + } + } + }); + + // Listen to browser actions + cx.push_future({ + let updater = updater_callback.clone(); + let timeline = timeline.clone(); + let create_eval = create_eval.clone(); + async move { + let popstate_eval = { + let init_eval = create_eval( + r#" + return [ + document.location.pathname + "?" + document.location.search + "\#" + document.location.hash, + history.state, + JSON.parse(sessionStorage.getItem("liveview")), + history.length, + ]; + "#, + ).expect("failed to load state").await.expect("serializable state"); + let (route, state, session, depth) = serde_json::from_value::<( + String, + Option, + Option>, + usize, + )>(init_eval).expect("serializable state"); + let Ok(route) = R::from_str(&route.to_string()) else { + return; + }; + let mut timeline = timeline.lock().expect("unpoisoned mutex"); + let state = timeline.init(route.clone(), state, session, depth); + let state = serde_json::to_string(&state).expect("serializable state"); + let session = serde_json::to_string(&timeline.session()) + .expect("serializable session"); + + // Call the updater callback + (updater.read().unwrap())(); + + create_eval(&format!(r#" + // this does not trigger a PopState event + history.replaceState({state}, "", "{route}"); + sessionStorage.setItem("liveview", '{session}'); + + window.addEventListener("popstate", (event) => {{ + dioxus.send([ + document.location.pathname + "?" + document.location.search + "\#" + document.location.hash, + event.state, + ]); + }}); + "#)).expect("failed to initialize popstate") + }; + + loop { + let event = match popstate_eval.recv().await { + Ok(event) => event, + Err(_) => continue, + }; + let (route, state) = serde_json::from_value::<(String, Option)>(event).expect("serializable state"); + let Ok(route) = R::from_str(&route.to_string()) else { + return; + }; + let mut timeline = timeline.lock().expect("unpoisoned mutex"); + let state = timeline.update(route.clone(), state); + let state = serde_json::to_string(&state).expect("serializable state"); + let session = serde_json::to_string(&timeline.session()) + .expect("serializable session"); + + let _ = create_eval(&format!( + r#" + // this does not trigger a PopState event + history.replaceState({state}, "", "{route}"); + sessionStorage.setItem("liveview", '{session}'); + "#)); + + // Call the updater callback + (updater.read().unwrap())(); + } + } + }); + + Self { + action_tx, + timeline, + updater_callback, + } + } +} + +impl HistoryProvider for LiveviewHistory +where + ::Err: std::fmt::Display, +{ + fn go_back(&mut self) { + let _ = self.action_tx.send(Action::GoBack); + } + + fn go_forward(&mut self) { + let _ = self.action_tx.send(Action::GoForward); + } + + fn push(&mut self, route: R) { + let _ = self.action_tx.send(Action::Push(route)); + } + + fn replace(&mut self, route: R) { + let _ = self.action_tx.send(Action::Replace(route)); + } + + fn external(&mut self, url: String) -> bool { + let _ = self.action_tx.send(Action::External(url)); + true + } + + fn current_route(&self) -> R { + let timeline = self.timeline.lock().expect("unpoisoned mutex"); + timeline.current_route().clone() + } + + fn can_go_back(&self) -> bool { + let timeline = self.timeline.lock().expect("unpoisoned mutex"); + // Check if the one before is contiguous (i.e., not an external page) + let visited_indices: Vec = timeline.routes.keys().cloned().collect(); + visited_indices + .iter() + .position(|&rhs| timeline.current_index == rhs) + .map_or(false, |index| { + index > 0 && visited_indices[index - 1] == timeline.current_index - 1 + }) + } + + fn can_go_forward(&self) -> bool { + let timeline = self.timeline.lock().expect("unpoisoned mutex"); + // Check if the one after is contiguous (i.e., not an external page) + let visited_indices: Vec = timeline.routes.keys().cloned().collect(); + visited_indices + .iter() + .rposition(|&rhs| timeline.current_index == rhs) + .map_or(false, |index| { + index < visited_indices.len() - 1 + && visited_indices[index + 1] == timeline.current_index + 1 + }) + } + + fn updater(&mut self, callback: Arc) { + let mut updater_callback = self.updater_callback.write().unwrap(); + *updater_callback = callback; + } +} + +mod routes { + use crate::prelude::Routable; + use core::str::FromStr; + use serde::de::{MapAccess, Visitor}; + use serde::{ser::SerializeMap, Deserializer, Serializer}; + use std::collections::BTreeMap; + + pub fn serialize(routes: &BTreeMap, serializer: S) -> Result + where + S: Serializer, + R: Routable, + { + let mut map = serializer.serialize_map(Some(routes.len()))?; + for (index, route) in routes.iter() { + map.serialize_entry(&index.to_string(), &route.to_string())?; + } + map.end() + } + + pub fn deserialize<'de, D, R>(deserializer: D) -> Result, D::Error> + where + D: Deserializer<'de>, + R: Routable, + ::Err: std::fmt::Display, + { + struct BTreeMapVisitor { + marker: std::marker::PhantomData, + } + + impl<'de, R> Visitor<'de> for BTreeMapVisitor + where + R: Routable, + ::Err: std::fmt::Display, + { + type Value = BTreeMap; + + fn expecting(&self, formatter: &mut std::fmt::Formatter) -> std::fmt::Result { + formatter.write_str("a map with indices and routable values") + } + + fn visit_map(self, mut map: M) -> Result + where + M: MapAccess<'de>, + { + let mut routes = BTreeMap::new(); + while let Some((index, route)) = map.next_entry::()? { + let index = index.parse::().map_err(serde::de::Error::custom)?; + let route = R::from_str(&route).map_err(serde::de::Error::custom)?; + routes.insert(index, route); + } + Ok(routes) + } + } + + deserializer.deserialize_map(BTreeMapVisitor { + marker: std::marker::PhantomData, + }) + } +} diff --git a/packages/router/src/history/mod.rs b/packages/router/src/history/mod.rs index e9668b979..cf7183366 100644 --- a/packages/router/src/history/mod.rs +++ b/packages/router/src/history/mod.rs @@ -22,6 +22,11 @@ pub use web::*; #[cfg(feature = "web")] pub(crate) mod web_history; +#[cfg(feature = "liveview")] +mod liveview; +#[cfg(feature = "liveview")] +pub use liveview::*; + // #[cfg(feature = "web")] // mod web_hash; // #[cfg(feature = "web")] From d4e6876ff648159c78ad008ade4e3b1b469bb996 Mon Sep 17 00:00:00 2001 From: Falco Hirschenberger Date: Fri, 27 Oct 2023 15:29:43 +0200 Subject: [PATCH 222/447] Silence desktop build outputs from cargo (#1584) Silence additional disturbing output from cargo in desktop builds --- packages/cli/src/builder.rs | 1 + 1 file changed, 1 insertion(+) diff --git a/packages/cli/src/builder.rs b/packages/cli/src/builder.rs index 68c494c42..c85cdc484 100644 --- a/packages/cli/src/builder.rs +++ b/packages/cli/src/builder.rs @@ -254,6 +254,7 @@ pub fn build_desktop(config: &CrateConfig, _is_serve: bool) -> Result Date: Sun, 29 Oct 2023 21:39:07 +0330 Subject: [PATCH 223/447] Make window invisible until the first render (#1588) --- packages/desktop/src/lib.rs | 7 +++++++ packages/desktop/src/webview.rs | 2 +- 2 files changed, 8 insertions(+), 1 deletion(-) diff --git a/packages/desktop/src/lib.rs b/packages/desktop/src/lib.rs index badbe3276..bfefaf547 100644 --- a/packages/desktop/src/lib.rs +++ b/packages/desktop/src/lib.rs @@ -161,6 +161,7 @@ pub fn launch_with_props(root: Component

, props: P, cfg: Config) // iOS panics if we create a window before the event loop is started let props = Rc::new(Cell::new(Some(props))); let cfg = Rc::new(Cell::new(Some(cfg))); + let mut is_visible_before_start = true; event_loop.run(move |window_event, event_loop, control_flow| { *control_flow = ControlFlow::Wait; @@ -210,6 +211,8 @@ pub fn launch_with_props(root: Component

, props: P, cfg: Config) // Create a dom let dom = VirtualDom::new_with_props(root, props); + is_visible_before_start = cfg.window.window.visible; + let handler = create_new_window( cfg, event_loop, @@ -323,6 +326,10 @@ pub fn launch_with_props(root: Component

, props: P, cfg: Config) EventData::Ipc(msg) if msg.method() == "initialize" => { let view = webviews.get_mut(&event.1).unwrap(); send_edits(view.dom.rebuild(), &view.desktop_context.webview); + view.desktop_context + .webview + .window() + .set_visible(is_visible_before_start); } EventData::Ipc(msg) if msg.method() == "browser_open" => { diff --git a/packages/desktop/src/webview.rs b/packages/desktop/src/webview.rs index 469aa8068..6e6d26b17 100644 --- a/packages/desktop/src/webview.rs +++ b/packages/desktop/src/webview.rs @@ -13,7 +13,7 @@ pub fn build( proxy: EventLoopProxy, ) -> (WebView, WebContext) { let builder = cfg.window.clone(); - let window = builder.build(event_loop).unwrap(); + let window = builder.with_visible(false).build(event_loop).unwrap(); let file_handler = cfg.file_drop_handler.take(); let custom_head = cfg.custom_head.clone(); let index_file = cfg.custom_index.clone(); From c5e647e97d0567e8362662a80ce474b95aa638ac Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Mon, 30 Oct 2023 08:39:37 -0500 Subject: [PATCH 224/447] add read untracked to signals --- packages/signals/src/signal.rs | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/packages/signals/src/signal.rs b/packages/signals/src/signal.rs index 9213307ff..0ad96349d 100644 --- a/packages/signals/src/signal.rs +++ b/packages/signals/src/signal.rs @@ -200,6 +200,13 @@ impl Signal { Ref::map(inner, |v| &v.value) } + /// Get the current value of the signal. **Unlike read, this will not subscribe the current scope to the signal which can cause parts of your UI to not update.** + /// If the signal has been dropped, this will panic. + pub fn read_untracked(&self) -> Ref { + let inner = self.inner.read(); + Ref::map(inner, |v| &v.value) + } + /// Get a mutable reference to the signal's value. /// If the signal has been dropped, this will panic. pub fn write(&self) -> Write<'_, T> { @@ -385,6 +392,12 @@ impl ReadOnlySignal { self.inner.read() } + /// Get the current value of the signal. **Unlike read, this will not subscribe the current scope to the signal which can cause parts of your UI to not update.** + /// If the signal has been dropped, this will panic. + pub fn read_untracked(&self) -> Ref { + self.inner.read_untracked() + } + /// Run a closure with a reference to the signal's value. pub fn with(&self, f: impl FnOnce(&T) -> O) -> O { self.inner.with(f) From 78120ca0e260c9986612b254da7f4afc95edbe97 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Mon, 30 Oct 2023 08:44:28 -0500 Subject: [PATCH 225/447] Bump actions/setup-node from 3 to 4 (#1592) Bumps [actions/setup-node](https://github.com/actions/setup-node) from 3 to 4. - [Release notes](https://github.com/actions/setup-node/releases) - [Commits](https://github.com/actions/setup-node/compare/v3...v4) --- updated-dependencies: - dependency-name: actions/setup-node dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- .github/workflows/playwright.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/playwright.yml b/.github/workflows/playwright.yml index 500d41564..cb5a1f1bb 100644 --- a/.github/workflows/playwright.yml +++ b/.github/workflows/playwright.yml @@ -20,7 +20,7 @@ jobs: steps: # Do our best to cache the toolchain and node install steps - uses: actions/checkout@v4 - - uses: actions/setup-node@v3 + - uses: actions/setup-node@v4 with: node-version: 16 - name: Install Rust From 51f342417a856dc0dfea3701d1488953879f2d73 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Mon, 30 Oct 2023 14:41:41 -0500 Subject: [PATCH 226/447] add examples to the default watch path --- packages/cli/src/assets/dioxus.toml | 2 +- packages/cli/src/config.rs | 2 +- packages/cli/src/server/mod.rs | 14 +++++++------- 3 files changed, 9 insertions(+), 9 deletions(-) diff --git a/packages/cli/src/assets/dioxus.toml b/packages/cli/src/assets/dioxus.toml index 6386fb76e..892a6cdf8 100644 --- a/packages/cli/src/assets/dioxus.toml +++ b/packages/cli/src/assets/dioxus.toml @@ -23,7 +23,7 @@ title = "Dioxus | An elegant GUI library for Rust" index_on_404 = true -watch_path = ["src"] +watch_path = ["src", "examples"] # include `assets` in web platform [web.resource] diff --git a/packages/cli/src/config.rs b/packages/cli/src/config.rs index 0654dc375..3abf47f0c 100644 --- a/packages/cli/src/config.rs +++ b/packages/cli/src/config.rs @@ -105,7 +105,7 @@ impl Default for DioxusConfig { }, proxy: Some(vec![]), watcher: WebWatcherConfig { - watch_path: Some(vec![PathBuf::from("src")]), + watch_path: Some(vec![PathBuf::from("src"), PathBuf::from("examples")]), reload_html: Some(false), index_on_404: Some(true), }, diff --git a/packages/cli/src/server/mod.rs b/packages/cli/src/server/mod.rs index c6073d787..79a5531b6 100644 --- a/packages/cli/src/server/mod.rs +++ b/packages/cli/src/server/mod.rs @@ -32,7 +32,7 @@ async fn setup_file_watcher Result + Send + 'static>( .watcher .watch_path .clone() - .unwrap_or_else(|| vec![PathBuf::from("src")]); + .unwrap_or_else(|| vec![PathBuf::from("src"), PathBuf::from("examples")]); let watcher_config = config.clone(); let mut watcher = notify::recommended_watcher(move |info: notify::Result| { @@ -121,12 +121,12 @@ async fn setup_file_watcher Result + Send + 'static>( .unwrap(); for sub_path in allow_watch_path { - watcher - .watch( - &config.crate_dir.join(sub_path), - notify::RecursiveMode::Recursive, - ) - .unwrap(); + if let Err(err) = watcher.watch( + &config.crate_dir.join(sub_path), + notify::RecursiveMode::Recursive, + ) { + log::error!("Failed to watch path: {}", err); + } } Ok(watcher) } From 5fdff4b7ed1d2ea5b6af9ff98261f96c2cdb6578 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Tue, 31 Oct 2023 13:49:29 -0500 Subject: [PATCH 227/447] bump wry to 0.34 --- examples/mobile_demo/Cargo.toml | 2 +- packages/desktop/Cargo.toml | 6 ++---- packages/desktop/src/webview.rs | 33 +++++++++++++++++++++++++++++---- packages/html/Cargo.toml | 2 +- 4 files changed, 33 insertions(+), 10 deletions(-) diff --git a/examples/mobile_demo/Cargo.toml b/examples/mobile_demo/Cargo.toml index ba2af2312..a90ff4f36 100644 --- a/examples/mobile_demo/Cargo.toml +++ b/examples/mobile_demo/Cargo.toml @@ -35,7 +35,7 @@ frameworks = ["WebKit"] [dependencies] anyhow = "1.0.56" log = "0.4.11" -wry = "0.31.0" +wry = "0.34.0" dioxus = { path = "../../packages/dioxus" } dioxus-desktop = { path = "../../packages/desktop", features = [ "tokio_runtime", diff --git a/packages/desktop/Cargo.toml b/packages/desktop/Cargo.toml index e9b95e573..31324e728 100644 --- a/packages/desktop/Cargo.toml +++ b/packages/desktop/Cargo.toml @@ -19,7 +19,7 @@ serde = "1.0.136" serde_json = "1.0.79" thiserror = { workspace = true } tracing = { workspace = true } -wry = { version = "0.31.0", default-features = false, features = ["protocol", "file-drop"] } +wry = { version = "0.34.0", default-features = false, features = ["tao", "protocol", "file-drop"] } futures-channel = { workspace = true } tokio = { workspace = true, features = [ "sync", @@ -41,7 +41,7 @@ crossbeam-channel = "0.5.8" [target.'cfg(any(target_os = "windows",target_os = "macos",target_os = "linux",target_os = "dragonfly", target_os = "freebsd", target_os = "netbsd", target_os = "openbsd"))'.dependencies] -rfd = "0.11.3" +rfd = "0.12" global-hotkey = { git = "https://github.com/tauri-apps/global-hotkey" } [target.'cfg(target_os = "ios")'.dependencies] @@ -58,8 +58,6 @@ tokio_runtime = ["tokio"] fullscreen = ["wry/fullscreen"] transparent = ["wry/transparent"] devtools = ["wry/devtools"] -tray = ["wry/tray"] -dox = ["wry/dox"] hot-reload = ["dioxus-hot-reload"] [package.metadata.docs.rs] diff --git a/packages/desktop/src/webview.rs b/packages/desktop/src/webview.rs index 6e6d26b17..cffb6f6b5 100644 --- a/packages/desktop/src/webview.rs +++ b/packages/desktop/src/webview.rs @@ -5,6 +5,7 @@ use tao::event_loop::{EventLoopProxy, EventLoopWindowTarget}; pub use wry; pub use wry::application as tao; use wry::application::window::Window; +use wry::http::Response; use wry::webview::{WebContext, WebView, WebViewBuilder}; pub fn build( @@ -44,9 +45,24 @@ pub fn build( _ = proxy.send_event(UserWindowEvent(EventData::Ipc(message), window.id())); } }) - .with_custom_protocol(String::from("dioxus"), move |r| { - protocol::desktop_handler(r, custom_head.clone(), index_file.clone(), &root_name) - }) + .with_custom_protocol( + String::from("dioxus"), + move |r| match protocol::desktop_handler( + &r, + custom_head.clone(), + index_file.clone(), + &root_name, + ) { + Ok(response) => response, + Err(err) => { + tracing::error!("Error: {}", err); + Response::builder() + .status(500) + .body(err.to_string().into_bytes().into()) + .unwrap() + } + }, + ) .with_file_drop_handler(move |window, evet| { file_handler .as_ref() @@ -71,7 +87,16 @@ pub fn build( // .with_web_context(&mut web_context); for (name, handler) in cfg.protocols.drain(..) { - webview = webview.with_custom_protocol(name, handler) + webview = webview.with_custom_protocol(name, move |r| match handler(&r) { + Ok(response) => response, + Err(err) => { + tracing::error!("Error: {}", err); + Response::builder() + .status(500) + .body(err.to_string().into_bytes().into()) + .unwrap() + } + }) } if cfg.disable_context_menu { diff --git a/packages/html/Cargo.toml b/packages/html/Cargo.toml index 5644b440c..39b5455f2 100644 --- a/packages/html/Cargo.toml +++ b/packages/html/Cargo.toml @@ -21,7 +21,7 @@ keyboard-types = "0.7" async-trait = "0.1.58" serde-value = "0.7.0" tokio = { workspace = true, features = ["fs", "io-util"], optional = true } -rfd = { version = "0.11.3", optional = true } +rfd = { version = "0.12", optional = true } async-channel = "1.8.0" serde_json = { version = "1", optional = true } From ff7aca761761f5dd287a2ec4e243a604f4bb9e7e Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Tue, 31 Oct 2023 13:56:27 -0500 Subject: [PATCH 228/447] fix todomvc --- examples/todomvc.rs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/examples/todomvc.rs b/examples/todomvc.rs index ff691b4cb..212c4d807 100644 --- a/examples/todomvc.rs +++ b/examples/todomvc.rs @@ -110,7 +110,7 @@ pub fn TodoHeader<'a>(cx: Scope<'a, TodoHeaderProps<'a>>) -> Element { value: "{draft}", autofocus: "true", oninput: move |evt| { - draft.set(evt.value.clone()); + draft.set(evt.value().clone()); }, onkeydown: move |evt| { if evt.key() == Key::Enter && !draft.is_empty() { From bf36fc6def522c75f0f608d5c6a779ca1477f1ec Mon Sep 17 00:00:00 2001 From: tigerros Date: Wed, 1 Nov 2023 14:14:07 +0100 Subject: [PATCH 229/447] Fix `#[component]` expansion Clippy warning (#1599) Adds a `#[allow(clippy::inline_always)]` attribute to the generated `__dx_inner_comp` function. --- .../core-macro/src/component_body_deserializers/component.rs | 1 + 1 file changed, 1 insertion(+) diff --git a/packages/core-macro/src/component_body_deserializers/component.rs b/packages/core-macro/src/component_body_deserializers/component.rs index e43b1819f..36cda850c 100644 --- a/packages/core-macro/src/component_body_deserializers/component.rs +++ b/packages/core-macro/src/component_body_deserializers/component.rs @@ -31,6 +31,7 @@ fn get_out_comp_fn(orig_comp_fn: &ItemFn, cx_pat: &Pat) -> ItemFn { block: parse_quote! { { #[warn(non_snake_case)] + #[allow(clippy::inline_always)] #[inline(always)] #inner_comp_fn #inner_comp_ident (#cx_pat) From fdec47b90bc09945ccb5f26012b492f38587d872 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Wed, 1 Nov 2023 08:19:35 -0500 Subject: [PATCH 230/447] fix clippy --- packages/generational-box/src/lib.rs | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/packages/generational-box/src/lib.rs b/packages/generational-box/src/lib.rs index 628308340..f56904ede 100644 --- a/packages/generational-box/src/lib.rs +++ b/packages/generational-box/src/lib.rs @@ -485,7 +485,7 @@ pub struct GenerationalRef { borrow: GenerationalRefBorrowInfo, } -impl<'a, T: 'static> GenerationalRef { +impl GenerationalRef { /// Map one ref type to another. pub fn map(orig: GenerationalRef, f: F) -> GenerationalRef where @@ -522,7 +522,7 @@ impl<'a, T: 'static> GenerationalRef { } } -impl<'a, T: 'static> Deref for GenerationalRef { +impl Deref for GenerationalRef { type Target = T; fn deref(&self) -> &Self::Target { @@ -586,7 +586,7 @@ impl GenerationalRefMut { } } -impl<'a, T: 'static> Deref for GenerationalRefMut { +impl Deref for GenerationalRefMut { type Target = T; fn deref(&self) -> &Self::Target { @@ -594,7 +594,7 @@ impl<'a, T: 'static> Deref for GenerationalRefMut { } } -impl<'a, T: 'static> DerefMut for GenerationalRefMut { +impl DerefMut for GenerationalRefMut { fn deref_mut(&mut self) -> &mut Self::Target { self.inner.deref_mut() } From 52fb0801933eed40bea1c9edb58544693810e544 Mon Sep 17 00:00:00 2001 From: Alex Parrill Date: Tue, 31 Oct 2023 20:48:19 -0400 Subject: [PATCH 231/447] Use indentation settings in dx fmt and vscode extension Adds the ability to specify an indent string to public autofmt methods - either a sequence of spaces or a tab character. Get the indentation style and size from rustfmt for dx fmt, or from the editor settings for the vscode extension. Closes #1595 --- packages/autofmt/src/buffer.rs | 11 +- packages/autofmt/src/element.rs | 12 +- packages/autofmt/src/expr.rs | 6 +- packages/autofmt/src/indent.rs | 108 ++++++++++++++++++ packages/autofmt/src/lib.rs | 27 ++--- packages/autofmt/src/writer.rs | 4 +- packages/autofmt/tests/samples.rs | 2 +- packages/autofmt/tests/wrong.rs | 15 ++- .../wrong/{comments.rsx => comments-4sp.rsx} | 0 ...ments.wrong.rsx => comments-4sp.wrong.rsx} | 0 packages/autofmt/tests/wrong/comments-tab.rsx | 7 ++ .../tests/wrong/comments-tab.wrong.rsx | 5 + .../tests/wrong/{multi.rsx => multi-4sp.rsx} | 0 .../{multi.wrong.rsx => multi-4sp.wrong.rsx} | 0 packages/autofmt/tests/wrong/multi-tab.rsx | 3 + .../autofmt/tests/wrong/multi-tab.wrong.rsx | 5 + .../{multiexpr.rsx => multiexpr-4sp.rsx} | 0 ...expr.wrong.rsx => multiexpr-4sp.wrong.rsx} | 0 .../autofmt/tests/wrong/multiexpr-tab.rsx | 8 ++ .../tests/wrong/multiexpr-tab.wrong.rsx | 5 + packages/cli/src/cli/autoformat.rs | 68 ++++++++++- packages/extension/src/lib.rs | 46 ++++++-- packages/extension/src/main.ts | 2 +- 23 files changed, 283 insertions(+), 51 deletions(-) create mode 100644 packages/autofmt/src/indent.rs rename packages/autofmt/tests/wrong/{comments.rsx => comments-4sp.rsx} (100%) rename packages/autofmt/tests/wrong/{comments.wrong.rsx => comments-4sp.wrong.rsx} (100%) create mode 100644 packages/autofmt/tests/wrong/comments-tab.rsx create mode 100644 packages/autofmt/tests/wrong/comments-tab.wrong.rsx rename packages/autofmt/tests/wrong/{multi.rsx => multi-4sp.rsx} (100%) rename packages/autofmt/tests/wrong/{multi.wrong.rsx => multi-4sp.wrong.rsx} (100%) create mode 100644 packages/autofmt/tests/wrong/multi-tab.rsx create mode 100644 packages/autofmt/tests/wrong/multi-tab.wrong.rsx rename packages/autofmt/tests/wrong/{multiexpr.rsx => multiexpr-4sp.rsx} (100%) rename packages/autofmt/tests/wrong/{multiexpr.wrong.rsx => multiexpr-4sp.wrong.rsx} (100%) create mode 100644 packages/autofmt/tests/wrong/multiexpr-tab.rsx create mode 100644 packages/autofmt/tests/wrong/multiexpr-tab.wrong.rsx diff --git a/packages/autofmt/src/buffer.rs b/packages/autofmt/src/buffer.rs index fea5a4a3f..f19a7d8dc 100644 --- a/packages/autofmt/src/buffer.rs +++ b/packages/autofmt/src/buffer.rs @@ -8,13 +8,14 @@ use std::fmt::{Result, Write}; use dioxus_rsx::IfmtInput; -use crate::write_ifmt; +use crate::{indent::IndentOptions, write_ifmt}; /// The output buffer that tracks indent and string #[derive(Debug, Default)] pub struct Buffer { pub buf: String, - pub indent: usize, + pub indent_level: usize, + pub indent: IndentOptions, } impl Buffer { @@ -31,16 +32,16 @@ impl Buffer { } pub fn tab(&mut self) -> Result { - self.write_tabs(self.indent) + self.write_tabs(self.indent_level) } pub fn indented_tab(&mut self) -> Result { - self.write_tabs(self.indent + 1) + self.write_tabs(self.indent_level + 1) } pub fn write_tabs(&mut self, num: usize) -> std::fmt::Result { for _ in 0..num { - write!(self.buf, " ")? + write!(self.buf, "{}", self.indent.indent_str())? } Ok(()) } diff --git a/packages/autofmt/src/element.rs b/packages/autofmt/src/element.rs index dbc336401..27e7b31f1 100644 --- a/packages/autofmt/src/element.rs +++ b/packages/autofmt/src/element.rs @@ -66,7 +66,7 @@ impl Writer<'_> { // check if we have a lot of attributes let attr_len = self.is_short_attrs(attributes); - let is_short_attr_list = (attr_len + self.out.indent * 4) < 80; + let is_short_attr_list = (attr_len + self.out.indent_level * 4) < 80; let children_len = self.is_short_children(children); let is_small_children = children_len.is_some(); @@ -86,7 +86,7 @@ impl Writer<'_> { // if we have few children and few attributes, make it a one-liner if is_short_attr_list && is_small_children { - if children_len.unwrap() + attr_len + self.out.indent * 4 < 100 { + if children_len.unwrap() + attr_len + self.out.indent_level * 4 < 100 { opt_level = ShortOptimization::Oneliner; } else { opt_level = ShortOptimization::PropsOnTop; @@ -185,11 +185,11 @@ impl Writer<'_> { } while let Some(attr) = attr_iter.next() { - self.out.indent += 1; + self.out.indent_level += 1; if !sameline { self.write_comments(attr.attr.start())?; } - self.out.indent -= 1; + self.out.indent_level -= 1; if !sameline { self.out.indented_tabbed_line()?; @@ -398,14 +398,14 @@ impl Writer<'_> { for idx in start.line..end.line { let line = &self.src[idx]; if line.trim().starts_with("//") { - for _ in 0..self.out.indent + 1 { + for _ in 0..self.out.indent_level + 1 { write!(self.out, " ")? } writeln!(self.out, "{}", line.trim()).unwrap(); } } - for _ in 0..self.out.indent { + for _ in 0..self.out.indent_level { write!(self.out, " ")? } diff --git a/packages/autofmt/src/expr.rs b/packages/autofmt/src/expr.rs index b0257f8c3..b7a93a4fc 100644 --- a/packages/autofmt/src/expr.rs +++ b/packages/autofmt/src/expr.rs @@ -29,7 +29,7 @@ impl Writer<'_> { let first_line = &self.src[start.line - 1]; write!(self.out, "{}", &first_line[start.column - 1..].trim_start())?; - let prev_block_indent_level = crate::leading_whitespaces(first_line) / 4; + let prev_block_indent_level = self.out.indent.count_indents(first_line); for (id, line) in self.src[start.line..end.line].iter().enumerate() { writeln!(self.out)?; @@ -43,9 +43,9 @@ impl Writer<'_> { }; // trim the leading whitespace - let previous_indent = crate::leading_whitespaces(line) / 4; + let previous_indent = self.out.indent.count_indents(line); let offset = previous_indent.saturating_sub(prev_block_indent_level); - let required_indent = self.out.indent + offset; + let required_indent = self.out.indent_level + offset; self.out.write_tabs(required_indent)?; let line = line.trim_start(); diff --git a/packages/autofmt/src/indent.rs b/packages/autofmt/src/indent.rs new file mode 100644 index 000000000..2cce7cf1e --- /dev/null +++ b/packages/autofmt/src/indent.rs @@ -0,0 +1,108 @@ +#[derive(Clone, Copy, PartialEq, Eq, Debug)] +pub enum IndentType { + Spaces, + Tabs, +} + +#[derive(Debug, Clone)] +pub struct IndentOptions { + width: usize, + indent_string: String, +} + +impl IndentOptions { + pub fn new(typ: IndentType, width: usize) -> Self { + assert_ne!(width, 0, "Cannot have an indent width of 0"); + Self { + width, + indent_string: match typ { + IndentType::Tabs => "\t".into(), + IndentType::Spaces => " ".repeat(width), + }, + } + } + + /// Gets a string containing one indent worth of whitespace + pub fn indent_str(&self) -> &str { + &self.indent_string + } + + /// Computes the line length in characters, counting tabs as the indent width. + pub fn line_length(&self, line: &str) -> usize { + line.chars() + .map(|ch| if ch == '\t' { self.width } else { 1 }) + .sum() + } + + /// Estimates how many times the line has been indented. + pub fn count_indents(&self, mut line: &str) -> usize { + let mut indent = 0; + while !line.is_empty() { + // Try to count tabs + let num_tabs = line.chars().take_while(|ch| *ch == '\t').count(); + if num_tabs > 0 { + indent += num_tabs; + line = &line[num_tabs..]; + continue; + } + + // Try to count spaces + let num_spaces = line.chars().take_while(|ch| *ch == ' ').count(); + if num_spaces >= self.width { + // Intentionally floor here to take only the amount of space that matches an indent + let num_space_indents = num_spaces / self.width; + indent += num_space_indents; + line = &line[num_space_indents * self.width..]; + continue; + } + + // Line starts with either non-indent characters or an unevent amount of spaces, + // so no more indent remains. + break; + } + indent + } +} + +impl Default for IndentOptions { + fn default() -> Self { + Self::new(IndentType::Spaces, 4) + } +} + +#[cfg(test)] +mod tests { + use super::*; + + #[test] + fn count_indents() { + assert_eq!( + IndentOptions::new(IndentType::Spaces, 4).count_indents("no indentation here!"), + 0 + ); + assert_eq!( + IndentOptions::new(IndentType::Spaces, 4).count_indents(" v += 2"), + 1 + ); + assert_eq!( + IndentOptions::new(IndentType::Spaces, 4).count_indents(" v += 2"), + 2 + ); + assert_eq!( + IndentOptions::new(IndentType::Spaces, 4).count_indents(" v += 2"), + 2 + ); + assert_eq!( + IndentOptions::new(IndentType::Spaces, 4).count_indents("\t\tv += 2"), + 2 + ); + assert_eq!( + IndentOptions::new(IndentType::Spaces, 4).count_indents("\t\t v += 2"), + 2 + ); + assert_eq!( + IndentOptions::new(IndentType::Spaces, 2).count_indents(" v += 2"), + 2 + ); + } +} diff --git a/packages/autofmt/src/lib.rs b/packages/autofmt/src/lib.rs index 64a342885..0c3fe6bb8 100644 --- a/packages/autofmt/src/lib.rs +++ b/packages/autofmt/src/lib.rs @@ -16,8 +16,11 @@ mod collect_macros; mod component; mod element; mod expr; +mod indent; mod writer; +pub use indent::{IndentOptions, IndentType}; + /// A modification to the original file to be applied by an IDE /// /// Right now this re-writes entire rsx! blocks at a time, instead of precise line-by-line changes. @@ -47,7 +50,7 @@ pub struct FormattedBlock { /// back to the file precisely. /// /// Nested blocks of RSX will be handled automatically -pub fn fmt_file(contents: &str) -> Vec { +pub fn fmt_file(contents: &str, indent: IndentOptions) -> Vec { let mut formatted_blocks = Vec::new(); let parsed = syn::parse_file(contents).unwrap(); @@ -61,6 +64,7 @@ pub fn fmt_file(contents: &str) -> Vec { } let mut writer = Writer::new(contents); + writer.out.indent = indent; // Don't parse nested macros let mut end_span = LineColumn { column: 0, line: 0 }; @@ -76,7 +80,10 @@ pub fn fmt_file(contents: &str) -> Vec { let rsx_start = macro_path.span().start(); - writer.out.indent = leading_whitespaces(writer.src[rsx_start.line - 1]) / 4; + writer.out.indent_level = writer + .out + .indent + .count_indents(writer.src[rsx_start.line - 1]); write_body(&mut writer, &body); @@ -159,12 +166,13 @@ pub fn fmt_block_from_expr(raw: &str, expr: ExprMacro) -> Option { buf.consume() } -pub fn fmt_block(block: &str, indent_level: usize) -> Option { +pub fn fmt_block(block: &str, indent_level: usize, indent: IndentOptions) -> Option { let body = syn::parse_str::(block).unwrap(); let mut buf = Writer::new(block); - buf.out.indent = indent_level; + buf.out.indent = indent; + buf.out.indent_level = indent_level; write_body(&mut buf, &body); @@ -230,14 +238,3 @@ pub(crate) fn write_ifmt(input: &IfmtInput, writable: &mut impl Write) -> std::f let display = DisplayIfmt(input); write!(writable, "{}", display) } - -pub fn leading_whitespaces(input: &str) -> usize { - input - .chars() - .map_while(|c| match c { - ' ' => Some(1), - '\t' => Some(4), - _ => None, - }) - .sum() -} diff --git a/packages/autofmt/src/writer.rs b/packages/autofmt/src/writer.rs index 59f135592..bb333e8df 100644 --- a/packages/autofmt/src/writer.rs +++ b/packages/autofmt/src/writer.rs @@ -96,11 +96,11 @@ impl<'a> Writer<'a> { // Push out the indent level and write each component, line by line pub fn write_body_indented(&mut self, children: &[BodyNode]) -> Result { - self.out.indent += 1; + self.out.indent_level += 1; self.write_body_no_indent(children)?; - self.out.indent -= 1; + self.out.indent_level -= 1; Ok(()) } diff --git a/packages/autofmt/tests/samples.rs b/packages/autofmt/tests/samples.rs index 8145b0e8e..9431d700e 100644 --- a/packages/autofmt/tests/samples.rs +++ b/packages/autofmt/tests/samples.rs @@ -12,7 +12,7 @@ macro_rules! twoway { #[test] fn $name() { let src = include_str!(concat!("./samples/", stringify!($name), ".rsx")); - let formatted = dioxus_autofmt::fmt_file(src); + let formatted = dioxus_autofmt::fmt_file(src, Default::default()); let out = dioxus_autofmt::apply_formats(src, formatted); // normalize line endings let out = out.replace("\r", ""); diff --git a/packages/autofmt/tests/wrong.rs b/packages/autofmt/tests/wrong.rs index 5a0fb8a87..145d03807 100644 --- a/packages/autofmt/tests/wrong.rs +++ b/packages/autofmt/tests/wrong.rs @@ -1,10 +1,12 @@ +use dioxus_autofmt::{IndentType, IndentOptions}; + macro_rules! twoway { - ($val:literal => $name:ident) => { + ($val:literal => $name:ident ($indent:expr)) => { #[test] fn $name() { let src_right = include_str!(concat!("./wrong/", $val, ".rsx")); let src_wrong = include_str!(concat!("./wrong/", $val, ".wrong.rsx")); - let formatted = dioxus_autofmt::fmt_file(src_wrong); + let formatted = dioxus_autofmt::fmt_file(src_wrong, $indent); let out = dioxus_autofmt::apply_formats(src_wrong, formatted); // normalize line endings @@ -16,8 +18,11 @@ macro_rules! twoway { }; } -twoway!("comments" => comments); +twoway!("comments-4sp" => comments_4sp (IndentOptions::new(IndentType::Spaces, 4))); +twoway!("comments-tab" => comments_tab (IndentOptions::new(IndentType::Tabs, 4))); -twoway!("multi" => multi); +twoway!("multi-4sp" => multi_4sp (IndentOptions::new(IndentType::Spaces, 4))); +twoway!("multi-tab" => multi_tab (IndentOptions::new(IndentType::Tabs, 4))); -twoway!("multiexpr" => multiexpr); +twoway!("multiexpr-4sp" => multiexpr_4sp (IndentOptions::new(IndentType::Spaces, 4))); +twoway!("multiexpr-tab" => multiexpr_tab (IndentOptions::new(IndentType::Tabs, 4))); diff --git a/packages/autofmt/tests/wrong/comments.rsx b/packages/autofmt/tests/wrong/comments-4sp.rsx similarity index 100% rename from packages/autofmt/tests/wrong/comments.rsx rename to packages/autofmt/tests/wrong/comments-4sp.rsx diff --git a/packages/autofmt/tests/wrong/comments.wrong.rsx b/packages/autofmt/tests/wrong/comments-4sp.wrong.rsx similarity index 100% rename from packages/autofmt/tests/wrong/comments.wrong.rsx rename to packages/autofmt/tests/wrong/comments-4sp.wrong.rsx diff --git a/packages/autofmt/tests/wrong/comments-tab.rsx b/packages/autofmt/tests/wrong/comments-tab.rsx new file mode 100644 index 000000000..4c05e347e --- /dev/null +++ b/packages/autofmt/tests/wrong/comments-tab.rsx @@ -0,0 +1,7 @@ +rsx! { + div { + // Comments + class: "asdasd", + "hello world" + } +} diff --git a/packages/autofmt/tests/wrong/comments-tab.wrong.rsx b/packages/autofmt/tests/wrong/comments-tab.wrong.rsx new file mode 100644 index 000000000..eac96642d --- /dev/null +++ b/packages/autofmt/tests/wrong/comments-tab.wrong.rsx @@ -0,0 +1,5 @@ +rsx! { + div { + // Comments + class: "asdasd", "hello world" } +} diff --git a/packages/autofmt/tests/wrong/multi.rsx b/packages/autofmt/tests/wrong/multi-4sp.rsx similarity index 100% rename from packages/autofmt/tests/wrong/multi.rsx rename to packages/autofmt/tests/wrong/multi-4sp.rsx diff --git a/packages/autofmt/tests/wrong/multi.wrong.rsx b/packages/autofmt/tests/wrong/multi-4sp.wrong.rsx similarity index 100% rename from packages/autofmt/tests/wrong/multi.wrong.rsx rename to packages/autofmt/tests/wrong/multi-4sp.wrong.rsx diff --git a/packages/autofmt/tests/wrong/multi-tab.rsx b/packages/autofmt/tests/wrong/multi-tab.rsx new file mode 100644 index 000000000..1fb85c3d0 --- /dev/null +++ b/packages/autofmt/tests/wrong/multi-tab.rsx @@ -0,0 +1,3 @@ +fn app(cx: Scope) -> Element { + cx.render(rsx! { div { "hello world" } }) +} diff --git a/packages/autofmt/tests/wrong/multi-tab.wrong.rsx b/packages/autofmt/tests/wrong/multi-tab.wrong.rsx new file mode 100644 index 000000000..d818f9535 --- /dev/null +++ b/packages/autofmt/tests/wrong/multi-tab.wrong.rsx @@ -0,0 +1,5 @@ +fn app(cx: Scope) -> Element { + cx.render(rsx! { + div {"hello world" } + }) +} diff --git a/packages/autofmt/tests/wrong/multiexpr.rsx b/packages/autofmt/tests/wrong/multiexpr-4sp.rsx similarity index 100% rename from packages/autofmt/tests/wrong/multiexpr.rsx rename to packages/autofmt/tests/wrong/multiexpr-4sp.rsx diff --git a/packages/autofmt/tests/wrong/multiexpr.wrong.rsx b/packages/autofmt/tests/wrong/multiexpr-4sp.wrong.rsx similarity index 100% rename from packages/autofmt/tests/wrong/multiexpr.wrong.rsx rename to packages/autofmt/tests/wrong/multiexpr-4sp.wrong.rsx diff --git a/packages/autofmt/tests/wrong/multiexpr-tab.rsx b/packages/autofmt/tests/wrong/multiexpr-tab.rsx new file mode 100644 index 000000000..1fc3401c4 --- /dev/null +++ b/packages/autofmt/tests/wrong/multiexpr-tab.rsx @@ -0,0 +1,8 @@ +fn ItWroks() { + cx.render(rsx! { + div { class: "flex flex-wrap items-center dark:text-white py-16 border-t font-light", + left, + right + } + }) +} diff --git a/packages/autofmt/tests/wrong/multiexpr-tab.wrong.rsx b/packages/autofmt/tests/wrong/multiexpr-tab.wrong.rsx new file mode 100644 index 000000000..073107541 --- /dev/null +++ b/packages/autofmt/tests/wrong/multiexpr-tab.wrong.rsx @@ -0,0 +1,5 @@ +fn ItWroks() { + cx.render(rsx! { + div { class: "flex flex-wrap items-center dark:text-white py-16 border-t font-light", left, right } + }) +} diff --git a/packages/cli/src/cli/autoformat.rs b/packages/cli/src/cli/autoformat.rs index 1d1cbcd24..6c1ce04a1 100644 --- a/packages/cli/src/cli/autoformat.rs +++ b/packages/cli/src/cli/autoformat.rs @@ -1,3 +1,4 @@ +use dioxus_autofmt::{IndentOptions, IndentType}; use futures::{stream::FuturesUnordered, StreamExt}; use std::{fs, path::Path, process::exit}; @@ -35,7 +36,8 @@ impl Autoformat { } if let Some(raw) = self.raw { - if let Some(inner) = dioxus_autofmt::fmt_block(&raw, 0) { + let indent = indentation_for(".")?; + if let Some(inner) = dioxus_autofmt::fmt_block(&raw, 0, indent) { println!("{}", inner); } else { // exit process with error @@ -46,17 +48,21 @@ impl Autoformat { // Format single file if let Some(file) = self.file { - let file_content = if file == "-" { + let file_content; + let indent; + if file == "-" { + indent = indentation_for(".")?; let mut contents = String::new(); std::io::stdin().read_to_string(&mut contents)?; - Ok(contents) + file_content = Ok(contents); } else { - fs::read_to_string(&file) + indent = indentation_for(".")?; + file_content = fs::read_to_string(&file); }; match file_content { Ok(s) => { - let edits = dioxus_autofmt::fmt_file(&s); + let edits = dioxus_autofmt::fmt_file(&s, indent); let out = dioxus_autofmt::apply_formats(&s, edits); if file == "-" { print!("{}", out); @@ -93,6 +99,12 @@ async fn autoformat_project(check: bool) -> Result<()> { let mut files_to_format = vec![]; collect_rs_files(&crate_config.crate_dir, &mut files_to_format); + if files_to_format.is_empty() { + return Ok(()); + } + + let indent = indentation_for(&files_to_format[0])?; + let counts = files_to_format .into_iter() .filter(|file| { @@ -104,10 +116,11 @@ async fn autoformat_project(check: bool) -> Result<()> { }) .map(|path| async { let _path = path.clone(); + let _indent = indent.clone(); let res = tokio::spawn(async move { let contents = tokio::fs::read_to_string(&path).await?; - let edits = dioxus_autofmt::fmt_file(&contents); + let edits = dioxus_autofmt::fmt_file(&contents, _indent.clone()); let len = edits.len(); if !edits.is_empty() { @@ -151,6 +164,49 @@ async fn autoformat_project(check: bool) -> Result<()> { Ok(()) } +fn indentation_for(file_or_dir: impl AsRef) -> Result { + let out = std::process::Command::new("cargo") + .args(["fmt", "--", "--print-config", "current"]) + .arg(file_or_dir.as_ref()) + .stdout(std::process::Stdio::piped()) + .stderr(std::process::Stdio::inherit()) + .output()?; + if !out.status.success() { + return Err(Error::CargoError("cargo fmt failed".into())); + } + + let config = String::from_utf8_lossy(&out.stdout); + + let hard_tabs = config + .lines() + .find(|line| line.starts_with("hard_tabs ")) + .and_then(|line| line.split_once('=')) + .map(|(_, value)| value.trim() == "true") + .ok_or_else(|| { + Error::RuntimeError("Could not find hard_tabs option in rustfmt config".into()) + })?; + let tab_spaces = config + .lines() + .find(|line| line.starts_with("tab_spaces ")) + .and_then(|line| line.split_once('=')) + .map(|(_, value)| value.trim().parse::()) + .ok_or_else(|| { + Error::RuntimeError("Could not find tab_spaces option in rustfmt config".into()) + })? + .map_err(|_| { + Error::RuntimeError("Could not parse tab_spaces option in rustfmt config".into()) + })?; + + Ok(IndentOptions::new( + if hard_tabs { + IndentType::Tabs + } else { + IndentType::Spaces + }, + tab_spaces, + )) +} + fn collect_rs_files(folder: &Path, files: &mut Vec) { let Ok(folder) = folder.read_dir() else { return; diff --git a/packages/extension/src/lib.rs b/packages/extension/src/lib.rs index abcdaf598..fb9cca8a9 100644 --- a/packages/extension/src/lib.rs +++ b/packages/extension/src/lib.rs @@ -1,17 +1,39 @@ //! This file exports functions into the vscode extension -use dioxus_autofmt::FormattedBlock; +use dioxus_autofmt::{FormattedBlock, IndentOptions, IndentType}; use wasm_bindgen::prelude::*; #[wasm_bindgen] -pub fn format_rsx(raw: String) -> String { - let block = dioxus_autofmt::fmt_block(&raw, 0); +pub fn format_rsx(raw: String, use_tabs: bool, indent_size: usize) -> String { + let block = dioxus_autofmt::fmt_block( + &raw, + 0, + IndentOptions::new( + if use_tabs { + IndentType::Tabs + } else { + IndentType::Spaces + }, + indent_size, + ), + ); block.unwrap() } #[wasm_bindgen] -pub fn format_selection(raw: String) -> String { - let block = dioxus_autofmt::fmt_block(&raw, 0); +pub fn format_selection(raw: String, use_tabs: bool, indent_size: usize) -> String { + let block = dioxus_autofmt::fmt_block( + &raw, + 0, + IndentOptions::new( + if use_tabs { + IndentType::Tabs + } else { + IndentType::Spaces + }, + indent_size, + ), + ); block.unwrap() } @@ -35,8 +57,18 @@ impl FormatBlockInstance { } #[wasm_bindgen] -pub fn format_file(contents: String) -> FormatBlockInstance { - let _edits = dioxus_autofmt::fmt_file(&contents); +pub fn format_file(contents: String, use_tabs: bool, indent_size: usize) -> FormatBlockInstance { + let _edits = dioxus_autofmt::fmt_file( + &contents, + IndentOptions::new( + if use_tabs { + IndentType::Tabs + } else { + IndentType::Spaces + }, + indent_size, + ), + ); let out = dioxus_autofmt::apply_formats(&contents, _edits.clone()); FormatBlockInstance { new: out, _edits } } diff --git a/packages/extension/src/main.ts b/packages/extension/src/main.ts index fc12457ad..4ceee487c 100644 --- a/packages/extension/src/main.ts +++ b/packages/extension/src/main.ts @@ -90,7 +90,7 @@ function fmtDocument(document: vscode.TextDocument) { if (!editor) return; // Need an editor to apply text edits. const contents = editor.document.getText(); - const formatted = dioxus.format_file(contents); + const formatted = dioxus.format_file(contents, !editor.options.insertSpaces, editor.options.tabSize); // Replace the entire text document // Yes, this is a bit heavy handed, but the dioxus side doesn't know the line/col scheme that vscode is using From 0f2923a385c94e13f53ba6920a632ed21d9fcc8d Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Thu, 2 Nov 2023 13:17:21 -0500 Subject: [PATCH 232/447] fix extension types --- packages/extension/src/main.ts | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/packages/extension/src/main.ts b/packages/extension/src/main.ts index 4ceee487c..76b7261f1 100644 --- a/packages/extension/src/main.ts +++ b/packages/extension/src/main.ts @@ -90,7 +90,13 @@ function fmtDocument(document: vscode.TextDocument) { if (!editor) return; // Need an editor to apply text edits. const contents = editor.document.getText(); - const formatted = dioxus.format_file(contents, !editor.options.insertSpaces, editor.options.tabSize); + let tabSize: number; + if (typeof editor.options.tabSize === 'number') { + tabSize = editor.options.tabSize; + } else { + tabSize = 4; + } + const formatted = dioxus.format_file(contents, !editor.options.insertSpaces, tabSize); // Replace the entire text document // Yes, this is a bit heavy handed, but the dioxus side doesn't know the line/col scheme that vscode is using From 46fec1ae482e38cfee26e925ea22b88544dcf18a Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Thu, 2 Nov 2023 13:46:57 -0500 Subject: [PATCH 233/447] fix clippy --- packages/core-macro/src/props/mod.rs | 4 +--- packages/core/src/diff.rs | 2 +- packages/rsx/src/lib.rs | 2 +- 3 files changed, 3 insertions(+), 5 deletions(-) diff --git a/packages/core-macro/src/props/mod.rs b/packages/core-macro/src/props/mod.rs index 2ef213762..59a5c0cd6 100644 --- a/packages/core-macro/src/props/mod.rs +++ b/packages/core-macro/src/props/mod.rs @@ -936,9 +936,7 @@ Finally, call `.build()` to create the instance of `{name}`. pub fn field_impl(&self, field: &FieldInfo) -> Result { let FieldInfo { - name: field_name, - ty: field_type, - .. + name: field_name, .. } = field; if *field_name == "key" { return Err(Error::new_spanned(field_name, "Naming a prop `key` is not allowed because the name can conflict with the built in key attribute. See https://dioxuslabs.com/learn/0.4/reference/dynamic_rendering#rendering-lists for more information about keys")); diff --git a/packages/core/src/diff.rs b/packages/core/src/diff.rs index 64d16b1ce..5e7bf7573 100644 --- a/packages/core/src/diff.rs +++ b/packages/core/src/diff.rs @@ -626,7 +626,7 @@ impl<'b> VirtualDom { // If none of the old keys are reused by the new children, then we remove all the remaining old children and // create the new children afresh. if shared_keys.is_empty() { - if old.get(0).is_some() { + if !old.is_empty() { self.remove_nodes(&old[1..]); self.replace(&old[0], new); } else { diff --git a/packages/rsx/src/lib.rs b/packages/rsx/src/lib.rs index d4170ffe9..7a705ba6b 100644 --- a/packages/rsx/src/lib.rs +++ b/packages/rsx/src/lib.rs @@ -195,7 +195,7 @@ impl<'a> ToTokens for TemplateRenderer<'a> { fn to_tokens(&self, out_tokens: &mut TokenStream2) { let mut context = DynamicContext::default(); - let key = match self.roots.get(0) { + let key = match self.roots.first() { Some(BodyNode::Element(el)) if self.roots.len() == 1 => el.key.clone(), Some(BodyNode::Component(comp)) if self.roots.len() == 1 => comp.key().cloned(), _ => None, From 0aa4875ec0b32e85f8d2d4e23997dacb9ddec3b6 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Thu, 2 Nov 2023 13:59:46 -0500 Subject: [PATCH 234/447] fix formating --- packages/autofmt/tests/wrong.rs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/autofmt/tests/wrong.rs b/packages/autofmt/tests/wrong.rs index 145d03807..06a0f00d1 100644 --- a/packages/autofmt/tests/wrong.rs +++ b/packages/autofmt/tests/wrong.rs @@ -1,4 +1,4 @@ -use dioxus_autofmt::{IndentType, IndentOptions}; +use dioxus_autofmt::{IndentOptions, IndentType}; macro_rules! twoway { ($val:literal => $name:ident ($indent:expr)) => { From 7590cf822d892c360ed24b0825a5db034584e2e6 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Thu, 2 Nov 2023 21:00:43 -0500 Subject: [PATCH 235/447] fix the scroll event on the web renderer --- packages/web/src/dom.rs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/web/src/dom.rs b/packages/web/src/dom.rs index 4fa5c9444..f45d6558a 100644 --- a/packages/web/src/dom.rs +++ b/packages/web/src/dom.rs @@ -294,7 +294,7 @@ pub fn virtual_event_from_websys_event(event: web_sys::Event, target: Element) - "select" => Rc::new(SelectionData {}), "touchcancel" | "touchend" | "touchmove" | "touchstart" => Rc::new(TouchData::from(event)), - "scroll" => Rc::new(()), + "scroll" => Rc::new(ScrollData {}), "wheel" => Rc::new(WheelData::from(event)), "animationstart" | "animationend" | "animationiteration" => { Rc::new(AnimationData::from(event)) From f372144fd7b903896636781d469568127a0789c3 Mon Sep 17 00:00:00 2001 From: divinerapier Date: Fri, 3 Nov 2023 10:59:04 +0800 Subject: [PATCH 236/447] Bump tauri bundler for using proxy to fetch resources Signed-off-by: divinerapier --- packages/cli/Cargo.toml | 4 ++-- packages/cli/src/config.rs | 1 + 2 files changed, 3 insertions(+), 2 deletions(-) diff --git a/packages/cli/Cargo.toml b/packages/cli/Cargo.toml index adb0239f2..a11ed3545 100644 --- a/packages/cli/Cargo.toml +++ b/packages/cli/Cargo.toml @@ -72,8 +72,8 @@ cargo-generate = "0.18" toml_edit = "0.19.11" # bundling -tauri-bundler = { version = "=1.3.0", features = ["native-tls-vendored"] } -tauri-utils = "=1.4.*" +tauri-bundler = { version = "=1.4.*", features = ["native-tls-vendored"] } +tauri-utils = "=1.5.*" dioxus-autofmt = { workspace = true } dioxus-check = { workspace = true } diff --git a/packages/cli/src/config.rs b/packages/cli/src/config.rs index 3abf47f0c..037b5f167 100644 --- a/packages/cli/src/config.rs +++ b/packages/cli/src/config.rs @@ -525,6 +525,7 @@ impl From for tauri_bundler::NsisSettings { display_language_selector: val.display_language_selector, custom_language_files: None, template: None, + compression: None, } } } From 4215e2b247c53c3af49b73315d0a79892842f11e Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Fri, 3 Nov 2023 13:09:33 -0500 Subject: [PATCH 237/447] fix cargo.toml/lock path capitalization for linux --- packages/cli/src/config.rs | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/packages/cli/src/config.rs b/packages/cli/src/config.rs index 0f5bfd370..97c1557ba 100644 --- a/packages/cli/src/config.rs +++ b/packages/cli/src/config.rs @@ -301,8 +301,8 @@ impl CrateConfig { pub fn asset_manifest(&self) -> AssetManifest { AssetManifest::load_from_path( - self.crate_dir.join("cargo.toml"), - self.workspace_dir.join("cargo.lock"), + self.crate_dir.join("Cargo.toml"), + self.workspace_dir.join("Cargo.lock"), ) } From 02e91d8b9aee3b1815c3ad86c506c0f2cc27741a Mon Sep 17 00:00:00 2001 From: Bunny Bites Date: Sat, 4 Nov 2023 21:50:11 +0530 Subject: [PATCH 238/447] add get_parsed_values function --- packages/rink/src/hooks.rs | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/packages/rink/src/hooks.rs b/packages/rink/src/hooks.rs index f8c4500d2..a78194753 100644 --- a/packages/rink/src/hooks.rs +++ b/packages/rink/src/hooks.rs @@ -74,6 +74,29 @@ impl FormData { files: None, } } + + // ***** function to parse the 'values' to make it ready to use******* + // e.g - self.values = { username: ["rust"], password: ["dioxus"]} + // what we need it to be: { username: "rust", password: "dioxus"} + pub fn get_parsed_values(&self) -> Option> { + if (self.values.is_empty()) { + return None; + } + + let raw_values = self.values.clone(); + + let mut parsed_values: HashMap = HashMap::new(); + + for (fieldname, values) in raw_values.into_iter() { + // convert array of string value to string + // eg - ["rust", "javascript"] => "rust, javascript" + let prepared_value = values.join(", "); + + parsed_values.insert(fieldname, prepared_value); + } + + Some(parsed_values) + } } #[derive(Clone, Debug, PartialEq)] From bb5738a0baf9f43af3db98a9a6fb481687026d86 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marc=20Esp=C3=ADn?= Date: Sat, 4 Nov 2023 19:22:47 +0100 Subject: [PATCH 239/447] fix: Read value from root when calling `AtomState::current()` (#1609) --- packages/fermi/src/hooks/state.rs | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/packages/fermi/src/hooks/state.rs b/packages/fermi/src/hooks/state.rs index d4ebc529c..7d473588a 100644 --- a/packages/fermi/src/hooks/state.rs +++ b/packages/fermi/src/hooks/state.rs @@ -86,7 +86,9 @@ impl AtomState { /// ``` #[must_use] pub fn current(&self) -> Rc { - self.value.as_ref().unwrap().clone() + let atoms = self.root.atoms.borrow(); + let slot = atoms.get(&self.id).unwrap(); + slot.value.clone().downcast().unwrap() } /// Get the `setter` function directly without the `AtomState` wrapper. From be1decf9f2ffc0b66cb7a176e9aafcabc2a529b2 Mon Sep 17 00:00:00 2001 From: Lee TaeWoo Date: Sun, 5 Nov 2023 03:53:50 +0900 Subject: [PATCH 240/447] fix syntax error at derive `Props` using const generics (#1607) --- packages/core-macro/src/props/mod.rs | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) diff --git a/packages/core-macro/src/props/mod.rs b/packages/core-macro/src/props/mod.rs index 605983afc..aba8137e7 100644 --- a/packages/core-macro/src/props/mod.rs +++ b/packages/core-macro/src/props/mod.rs @@ -551,18 +551,16 @@ mod struct_info { let generics_with_empty = modify_types_generics_hack(&ty_generics, |args| { args.insert(0, syn::GenericArgument::Type(empties_tuple.clone().into())); }); - let phantom_generics = self.generics.params.iter().map(|param| match param { + let phantom_generics = self.generics.params.iter().filter_map(|param| match param { syn::GenericParam::Lifetime(lifetime) => { let lifetime = &lifetime.lifetime; - quote!(::core::marker::PhantomData<&#lifetime ()>) + Some(quote!(::core::marker::PhantomData<&#lifetime ()>)) } syn::GenericParam::Type(ty) => { let ty = &ty.ident; - quote!(::core::marker::PhantomData<#ty>) - } - syn::GenericParam::Const(_cnst) => { - quote!() + Some(quote!(::core::marker::PhantomData<#ty>)) } + syn::GenericParam::Const(_cnst) => None, }); let builder_method_doc = match self.builder_attr.builder_method_doc { Some(ref doc) => quote!(#doc), From c18f91142937937a32708d9f9c9294cf249e9d76 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marc=20Esp=C3=ADn?= Date: Sat, 4 Nov 2023 20:04:14 +0100 Subject: [PATCH 241/447] Update atom_root.rs (#1611) --- packages/fermi/src/hooks/atom_root.rs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/fermi/src/hooks/atom_root.rs b/packages/fermi/src/hooks/atom_root.rs index 24fd70093..468f5f980 100644 --- a/packages/fermi/src/hooks/atom_root.rs +++ b/packages/fermi/src/hooks/atom_root.rs @@ -7,6 +7,6 @@ use dioxus_core::ScopeState; pub fn use_atom_root(cx: &ScopeState) -> &Rc { cx.use_hook(|| match cx.consume_context::>() { Some(root) => root, - None => panic!("No atom root found in context. Did you forget place an AtomRoot component at the top of your app?"), + None => panic!("No atom root found in context. Did you forget to call use_init_atom_root at the top of your app?"), }) } From d54ec57192b191cabb6f8ca138c369788fccaeb2 Mon Sep 17 00:00:00 2001 From: Bunny Bites Date: Sun, 5 Nov 2023 08:16:09 +0530 Subject: [PATCH 242/447] 1. migrated code to form.rs 2. made get_parsed_values as private fn. 3. handled multi-valued data while parsing --- packages/html/src/events/form.rs | 55 ++++++++++++++++++++++++++++++-- packages/rink/src/hooks.rs | 23 ------------- 2 files changed, 53 insertions(+), 25 deletions(-) diff --git a/packages/html/src/events/form.rs b/packages/html/src/events/form.rs index fab13482b..e3b35b098 100644 --- a/packages/html/src/events/form.rs +++ b/packages/html/src/events/form.rs @@ -1,9 +1,16 @@ use std::{any::Any, collections::HashMap, fmt::Debug}; use dioxus_core::Event; +use serde::{Deserialize, Serialize}; pub type FormEvent = Event; +#[derive(Serialize, Deserialize)] +enum ValueType { + Text(String), + VecText(Vec), +} + /* DOMEvent: Send + SyncTarget relatedTarget */ #[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] #[derive(Clone)] @@ -23,6 +30,52 @@ pub struct FormData { pub files: Option>, } +impl FormData { + // ***** function to parse the 'values' to make it ready to use******* + // e.g - self.values = { username: ["rust"], password: ["dioxus"]} + // what we need it to be: { username: "rust", password: "dioxus"} + fn get_parsed_values(&self) -> Option> { + if self.values.is_empty() { + return None; + } + + let raw_values = self.values.clone(); + + let mut parsed_values: HashMap = HashMap::new(); + + for (fieldname, values) in raw_values.into_iter() { + /* + case 1 - multiple values, example { driving_types: ["manual", "automatic"] } + In this case we want to return the values as it is, NO point in making + driving_types: "manual, automatic" + + case 2 - single value, example { favourite_language: ["rust"] } + In this case we would want to deserialize the value as follows + favourite_language: "rust" + */ + if values.len() > 1 { + // handling multiple values - case 1 + parsed_values.insert(fieldname, ValueType::VecText(values.clone())); + } else { + // handle single value - case 2 + let prepared_value = values.into_iter().next()?; + parsed_values.insert(fieldname, ValueType::Text(prepared_value)); + } + } + + Some(parsed_values) + } + + pub fn parse_json(&self) -> Result + where + T: serde::de::DeserializeOwned, + { + let formatted = self.get_parsed_values(); + let as_string = serde_json::to_string(&formatted)?; + serde_json::from_str(&as_string) + } +} + #[cfg(feature = "serialize")] #[derive(serde::Serialize, serde::Deserialize)] struct SerializedFileEngine { @@ -60,8 +113,6 @@ fn deserialize_file_engine<'de, D>( where D: serde::Deserializer<'de>, { - use serde::Deserialize; - let Ok(file_engine) = SerializedFileEngine::deserialize(deserializer) else { return Ok(None); }; diff --git a/packages/rink/src/hooks.rs b/packages/rink/src/hooks.rs index a78194753..f8c4500d2 100644 --- a/packages/rink/src/hooks.rs +++ b/packages/rink/src/hooks.rs @@ -74,29 +74,6 @@ impl FormData { files: None, } } - - // ***** function to parse the 'values' to make it ready to use******* - // e.g - self.values = { username: ["rust"], password: ["dioxus"]} - // what we need it to be: { username: "rust", password: "dioxus"} - pub fn get_parsed_values(&self) -> Option> { - if (self.values.is_empty()) { - return None; - } - - let raw_values = self.values.clone(); - - let mut parsed_values: HashMap = HashMap::new(); - - for (fieldname, values) in raw_values.into_iter() { - // convert array of string value to string - // eg - ["rust", "javascript"] => "rust, javascript" - let prepared_value = values.join(", "); - - parsed_values.insert(fieldname, prepared_value); - } - - Some(parsed_values) - } } #[derive(Clone, Debug, PartialEq)] From b9554fd744426eeb1fd2ae03202ec9c57f8d5d58 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Sun, 5 Nov 2023 08:32:39 -0600 Subject: [PATCH 243/447] add a noop evaluator to the ssr renderer --- .../examples/axum-hello-world/src/main.rs | 1 + packages/fullstack/src/render.rs | 2 + packages/ssr/Cargo.toml | 3 ++ packages/ssr/src/eval.rs | 42 +++++++++++++++++++ packages/ssr/src/incremental.rs | 1 + packages/ssr/src/lib.rs | 2 + 6 files changed, 51 insertions(+) create mode 100644 packages/ssr/src/eval.rs diff --git a/packages/fullstack/examples/axum-hello-world/src/main.rs b/packages/fullstack/examples/axum-hello-world/src/main.rs index 8f1d3c8c6..64e5b44a0 100644 --- a/packages/fullstack/examples/axum-hello-world/src/main.rs +++ b/packages/fullstack/examples/axum-hello-world/src/main.rs @@ -24,6 +24,7 @@ fn app(cx: Scope) -> Element { let mut count = use_state(cx, || 0); let text = use_state(cx, || "...".to_string()); + let eval = use_eval(cx); cx.render(rsx! { div { diff --git a/packages/fullstack/src/render.rs b/packages/fullstack/src/render.rs index cda41f82c..886a5bd99 100644 --- a/packages/fullstack/src/render.rs +++ b/packages/fullstack/src/render.rs @@ -45,6 +45,8 @@ impl SsrRendererPool { .expect("couldn't spawn runtime") .block_on(async move { let mut vdom = VirtualDom::new_with_props(component, props); + // Make sure the evaluator is initialized + dioxus_ssr::eval::init_eval(vdom.base_scope()); let mut to = WriteBuffer { buffer: Vec::new() }; // before polling the future, we need to set the context let prev_context = diff --git a/packages/ssr/Cargo.toml b/packages/ssr/Cargo.toml index f6376452d..71f5b26a0 100644 --- a/packages/ssr/Cargo.toml +++ b/packages/ssr/Cargo.toml @@ -10,6 +10,7 @@ keywords = ["dom", "ui", "gui", "react", "ssr"] [dependencies] dioxus-core = { workspace = true, features = ["serialize"] } +dioxus-html = { workspace = true } askama_escape = "0.10.3" thiserror = "1.0.23" rustc-hash = "1.1.0" @@ -17,6 +18,8 @@ lru = "0.10.0" tracing = { workspace = true } http = "0.2.9" tokio = { version = "1.28", features = ["full"], optional = true } +async-trait = "0.1.58" +serde_json = { version = "1.0" } [dev-dependencies] dioxus = { workspace = true } diff --git a/packages/ssr/src/eval.rs b/packages/ssr/src/eval.rs new file mode 100644 index 000000000..2ab74f4e1 --- /dev/null +++ b/packages/ssr/src/eval.rs @@ -0,0 +1,42 @@ +use async_trait::async_trait; +use dioxus_core::ScopeState; +use dioxus_html::prelude::{EvalError, EvalProvider, Evaluator}; +use std::rc::Rc; + +/// Provides the SSREvalProvider through [`cx.provide_context`]. +pub fn init_eval(cx: &ScopeState) { + let provider: Rc = Rc::new(SSREvalProvider {}); + cx.provide_context(provider); +} + +/// Reprents the ssr-target's provider of evaluators. +pub struct SSREvalProvider; +impl EvalProvider for SSREvalProvider { + fn new_evaluator(&self, _: String) -> Result, EvalError> { + Ok(Rc::new(SSREvaluator) as Rc) + } +} + +/// Represents a ssr-target's JavaScript evaluator. +pub struct SSREvaluator; + +// In ssr rendering we never run or resolve evals. +#[async_trait(?Send)] +impl Evaluator for SSREvaluator { + /// Runs the evaluated JavaScript. + async fn join(&self) -> Result { + std::future::pending::<()>().await; + unreachable!() + } + + /// Sends a message to the evaluated JavaScript. + fn send(&self, _el: serde_json::Value) -> Result<(), EvalError> { + Ok(()) + } + + /// Gets an UnboundedReceiver to receive messages from the evaluated JavaScript. + async fn recv(&self) -> Result { + std::future::pending::<()>().await; + unreachable!() + } +} diff --git a/packages/ssr/src/incremental.rs b/packages/ssr/src/incremental.rs index c3bb25314..34ffa3443 100644 --- a/packages/ssr/src/incremental.rs +++ b/packages/ssr/src/incremental.rs @@ -81,6 +81,7 @@ impl IncrementalRenderer { let mut html_buffer = WriteBuffer { buffer: Vec::new() }; { let mut vdom = VirtualDom::new_with_props(comp, props); + crate::eval::init_eval(vdom.base_scope()); rebuild_with(&mut vdom).await; renderer.render_before_body(&mut *html_buffer)?; diff --git a/packages/ssr/src/lib.rs b/packages/ssr/src/lib.rs index 6794d1f14..fdc0e9333 100644 --- a/packages/ssr/src/lib.rs +++ b/packages/ssr/src/lib.rs @@ -10,6 +10,7 @@ pub mod incremental; #[cfg(feature = "incremental")] mod incremental_cfg; +pub mod eval; pub mod renderer; pub mod template; @@ -42,6 +43,7 @@ pub fn render_lazy(f: LazyNodes<'_, '_>) -> String { }; let mut dom = VirtualDom::new_with_props(lazy_app, props); + crate::eval::init_eval(dom.base_scope()); _ = dom.rebuild(); Renderer::new().render(&dom) From ca556ea9cbeef5217b05b84d467049daa9ae76fc Mon Sep 17 00:00:00 2001 From: xTeKc <81730792+xTeKc@users.noreply.github.com> Date: Mon, 6 Nov 2023 14:32:42 -0500 Subject: [PATCH 244/447] update readme (#1615) * Fix wasm-bindgen version mismatch * fixes #1613 --- Cargo.toml | 2 +- packages/cli/README.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/Cargo.toml b/Cargo.toml index a78f60d3e..d687d74d0 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -88,7 +88,7 @@ slab = "0.4.2" futures-channel = "0.3.21" futures-util = { version = "0.3", default-features = false } rustc-hash = "1.1.0" -wasm-bindgen = "0.2.87" +wasm-bindgen = "0.2.88" html_parser = "0.7.0" thiserror = "1.0.40" prettyplease = { package = "prettier-please", version = "0.2", features = [ diff --git a/packages/cli/README.md b/packages/cli/README.md index 72a813468..8379f22cc 100644 --- a/packages/cli/README.md +++ b/packages/cli/README.md @@ -11,7 +11,7 @@ It handles building, bundling, development and publishing to simplify developmen ### Install the stable version (recommended) ``` -cargo install dioxus-cli --locked +cargo install dioxus-cli ``` ### Install the latest development build through git From 6141aeb037746eb98aed6ca2371621357fdf9db6 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Tue, 7 Nov 2023 18:24:07 -0600 Subject: [PATCH 245/447] polish the throw trait --- Cargo.toml | 3 + examples/error_handle.rs | 27 +- packages/core/src/diff.rs | 2 +- packages/core/src/error_boundary.rs | 410 +++++++++++++++++++++++----- packages/core/src/lib.rs | 9 +- packages/core/src/scope_context.rs | 21 +- packages/core/src/scopes.rs | 14 - packages/core/src/virtual_dom.rs | 7 +- 8 files changed, 374 insertions(+), 119 deletions(-) diff --git a/Cargo.toml b/Cargo.toml index a78f60d3e..2f5815a02 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -133,3 +133,6 @@ fern = { version = "0.6.0", features = ["colored"] } env_logger = "0.10.0" simple_logger = "4.0.0" thiserror = { workspace = true } + +[dependencies] +tracing-subscriber = "0.3.17" diff --git a/examples/error_handle.rs b/examples/error_handle.rs index d1fb57933..21b16ec45 100644 --- a/examples/error_handle.rs +++ b/examples/error_handle.rs @@ -1,4 +1,4 @@ -use dioxus::prelude::*; +use dioxus::{core::CapturedError, prelude::*}; fn main() { dioxus_desktop::launch(App); @@ -6,30 +6,25 @@ fn main() { #[component] fn App(cx: Scope) -> Element { - let val = use_state(cx, || "0.0001"); - - let num = match val.parse::() { - Err(_) => return cx.render(rsx!("Parsing failed")), - Ok(num) => num, - }; - cx.render(rsx! { - h1 { "The parsed value is {num}" } - button { - onclick: move |_| val.set("invalid"), - "Set an invalid number" + ErrorBoundary { + handle_error: |error: CapturedError| rsx! {"Found error {error}"}, + DemoC { + x: 1 + } } - (0..5).map(|i| rsx! { - DemoC { x: i } - }) }) } #[component] fn DemoC(cx: Scope, x: i32) -> Element { + let result = Err("Error"); + + result.throw()?; + cx.render(rsx! { h1 { - "asdasdasdasd {x}" + "{x}" } }) } diff --git a/packages/core/src/diff.rs b/packages/core/src/diff.rs index 74017db0f..b2145a806 100644 --- a/packages/core/src/diff.rs +++ b/packages/core/src/diff.rs @@ -560,7 +560,7 @@ impl<'b> VirtualDom { // If none of the old keys are reused by the new children, then we remove all the remaining old children and // create the new children afresh. if shared_keys.is_empty() { - if old.get(0).is_some() { + if !old.is_empty() { self.remove_nodes(&old[1..]); self.replace(&old[0], new); } else { diff --git a/packages/core/src/error_boundary.rs b/packages/core/src/error_boundary.rs index 819d2f99e..2f64bea9f 100644 --- a/packages/core/src/error_boundary.rs +++ b/packages/core/src/error_boundary.rs @@ -1,25 +1,68 @@ -use crate::{ScopeId, ScopeState}; +use crate::{ + scope_context::{consume_context, current_scope_id, schedule_update_any}, + Element, IntoDynNode, LazyNodes, Properties, Scope, ScopeId, ScopeState, Template, + TemplateAttribute, TemplateNode, VNode, +}; use std::{ any::{Any, TypeId}, + backtrace::Backtrace, cell::RefCell, - fmt::Debug, + error::Error, + fmt::{Debug, Display}, + rc::Rc, + sync::Arc, }; -/// A boundary that will capture any errors from child components -pub struct ErrorBoundary { - error: RefCell>, - _id: ScopeId, +/// Provide an error boundary to catch errors from child components +pub fn use_error_boundary(cx: &ScopeState) -> &ErrorBoundary { + cx.use_hook(|| cx.provide_context(ErrorBoundary::new())) } +/// A boundary that will capture any errors from child components +#[derive(Debug, Clone, Default)] +pub struct ErrorBoundary { + inner: Rc, +} + +/// A boundary that will capture any errors from child components +pub struct ErrorBoundaryInner { + error: RefCell>, + _id: ScopeId, + rerun_boundary: Arc, +} + +impl Debug for ErrorBoundaryInner { + fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { + f.debug_struct("ErrorBoundaryInner") + .field("error", &self.error) + .finish() + } +} + +#[derive(Debug)] /// An instance of an error captured by a descendant component. pub struct CapturedError { /// The error captured by the error boundary pub error: Box, + /// The backtrace of the error + pub backtrace: Backtrace, + /// The scope that threw the error pub scope: ScopeId, } +impl Display for CapturedError { + fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { + f.write_fmt(format_args!( + "Encountered error: {:?}\nIn scope: {:?}\nBacktrace: {}", + self.error, self.scope, self.backtrace + )) + } +} + +impl Error for CapturedError {} + impl CapturedError { /// Downcast the error type into a concrete error type pub fn downcast(&self) -> Option<&T> { @@ -32,17 +75,56 @@ impl CapturedError { } } -impl ErrorBoundary { - pub fn new(id: ScopeId) -> Self { +impl Default for ErrorBoundaryInner { + fn default() -> Self { Self { error: RefCell::new(None), - _id: id, + _id: current_scope_id() + .expect("Cannot create an error boundary outside of a component's scope."), + rerun_boundary: schedule_update_any().unwrap(), + } + } +} + +impl ErrorBoundary { + /// Create a new error boundary + pub fn new() -> Self { + Self::default() + } + + /// Create a new error boundary in the current scope + pub(crate) fn new_in_scope( + scope: ScopeId, + rerun_boundary: Arc, + ) -> Self { + Self { + inner: Rc::new(ErrorBoundaryInner { + error: RefCell::new(None), + _id: scope, + rerun_boundary, + }), } } /// Push an error into this Error Boundary - pub fn insert_error(&self, scope: ScopeId, error: Box) { - self.error.replace(Some(CapturedError { error, scope })); + pub fn insert_error( + &self, + scope: ScopeId, + error: Box, + backtrace: Backtrace, + ) { + println!("{:?} {:?}", error, self.inner._id); + self.inner.error.replace(Some(CapturedError { + error, + scope, + backtrace, + })); + (self.inner.rerun_boundary)(self.inner._id); + } + + /// Take any error that has been captured by this error boundary + pub fn take_error(&self) -> Option { + self.inner.error.take() } } @@ -59,7 +141,7 @@ impl ErrorBoundary { /// ```rust, ignore /// #[component] /// fn App(cx: Scope, count: String) -> Element { -/// let id: i32 = count.parse().throw(cx)?; +/// let id: i32 = count.parse().throw()?; /// /// cx.render(rsx! { /// div { "Count {}" } @@ -84,14 +166,14 @@ pub trait Throw: Sized { /// ```rust, ignore /// #[component] /// fn App(cx: Scope, count: String) -> Element { - /// let id: i32 = count.parse().throw(cx)?; + /// let id: i32 = count.parse().throw()?; /// /// cx.render(rsx! { /// div { "Count {}" } /// }) /// } /// ``` - fn throw(self, cx: &ScopeState) -> Option; + fn throw(self) -> Option; /// Returns an option that evaluates to None if there is an error, injecting the error to the nearest error boundary. /// @@ -107,45 +189,46 @@ pub trait Throw: Sized { /// ```rust, ignore /// #[component] /// fn App(cx: Scope, count: String) -> Element { - /// let id: i32 = count.parse().throw(cx)?; + /// let id: i32 = count.parse().throw()?; /// /// cx.render(rsx! { /// div { "Count {}" } /// }) /// } /// ``` - fn throw_with( - self, - cx: &ScopeState, - e: impl FnOnce() -> D, - ) -> Option; + fn throw_with(self, e: impl FnOnce() -> D) -> Option { + self.throw().or_else(|| throw_error(e())) + } +} + +fn throw_error(e: impl Debug + 'static) -> Option { + if let Some(cx) = consume_context::() { + match current_scope_id() { + Some(id) => cx.insert_error(id, Box::new(e), Backtrace::capture()), + None => { + tracing::error!("Cannot throw error outside of a component's scope.") + } + } + } + + None } /// We call clone on any errors that can be owned out of a reference impl<'a, T, O: Debug + 'static, E: ToOwned> Throw for &'a Result { type Out = &'a T; - fn throw(self, cx: &ScopeState) -> Option { + fn throw(self) -> Option { match self { Ok(t) => Some(t), - Err(e) => { - cx.throw(e.to_owned()); - None - } + Err(e) => throw_error(e.to_owned()), } } - fn throw_with( - self, - cx: &ScopeState, - err: impl FnOnce() -> D, - ) -> Option { + fn throw_with(self, err: impl FnOnce() -> D) -> Option { match self { Ok(t) => Some(t), - Err(_e) => { - cx.throw(err()); - None - } + Err(_e) => throw_error(err()), } } } @@ -154,25 +237,15 @@ impl<'a, T, O: Debug + 'static, E: ToOwned> Throw for &'a Result Throw for Result { type Out = T; - fn throw(self, cx: &ScopeState) -> Option { + fn throw(self) -> Option { match self { Ok(t) => Some(t), - Err(e) => { - cx.throw(e); - None - } + Err(e) => throw_error(e), } } - fn throw_with( - self, - cx: &ScopeState, - error: impl FnOnce() -> D, - ) -> Option { - self.ok().or_else(|| { - cx.throw(error()); - None - }) + fn throw_with(self, error: impl FnOnce() -> D) -> Option { + self.ok().or_else(|| throw_error(error())) } } @@ -180,21 +253,234 @@ impl Throw for Result { impl Throw for Option { type Out = T; - fn throw(self, cx: &ScopeState) -> Option { - self.or_else(|| { - cx.throw("None error."); - None - }) + fn throw(self) -> Option { + self.or_else(|| throw_error("Attempted to unwrap a None value.")) } - fn throw_with( - self, - cx: &ScopeState, - error: impl FnOnce() -> D, - ) -> Option { - self.or_else(|| { - cx.throw(error()); - None - }) + fn throw_with(self, error: impl FnOnce() -> D) -> Option { + self.or_else(|| throw_error(error())) + } +} + +pub struct ErrorHandler<'a>(Box LazyNodes<'a, 'a> + 'a>); +impl<'a, F: Fn(CapturedError) -> LazyNodes<'a, 'a> + 'a> From for ErrorHandler<'a> { + fn from(value: F) -> Self { + Self(Box::new(value)) + } +} +fn default_handler<'a>(error: CapturedError) -> LazyNodes<'a, 'a> { + LazyNodes::new(move |__cx: &ScopeState| -> VNode { + static TEMPLATE: Template = Template { + name: "error_handle.rs:42:5:884", + roots: &[TemplateNode::Element { + tag: "pre", + namespace: None, + attrs: &[TemplateAttribute::Static { + name: "color", + namespace: Some("style"), + value: "red", + }], + children: &[TemplateNode::DynamicText { id: 0usize }], + }], + node_paths: &[&[0u8, 0u8]], + attr_paths: &[], + }; + VNode { + parent: None, + key: None, + template: std::cell::Cell::new(TEMPLATE), + root_ids: bumpalo::collections::Vec::with_capacity_in(1usize, __cx.bump()).into(), + dynamic_nodes: __cx + .bump() + .alloc([__cx.text_node(format_args!("{0}", error))]), + dynamic_attrs: __cx.bump().alloc([]), + } + }) +} +pub struct ErrorBoundaryProps<'a> { + children: Element<'a>, + handle_error: ErrorHandler<'a>, +} +impl<'a> ErrorBoundaryProps<'a> { + /** + Create a builder for building `ErrorBoundaryProps`. + On the builder, call `.children(...)`(optional), `.handle_error(...)`(optional) to set the values of the fields. + Finally, call `.build()` to create the instance of `ErrorBoundaryProps`. + */ + #[allow(dead_code)] + pub fn builder() -> ErrorBoundaryPropsBuilder<'a, ((), ())> { + ErrorBoundaryPropsBuilder { + fields: ((), ()), + _phantom: ::core::default::Default::default(), + } + } +} +#[must_use] +#[doc(hidden)] +#[allow(dead_code, non_camel_case_types, non_snake_case)] +pub struct ErrorBoundaryPropsBuilder<'a, TypedBuilderFields> { + fields: TypedBuilderFields, + _phantom: ::core::marker::PhantomData<&'a ()>, +} +impl<'a, TypedBuilderFields> Clone for ErrorBoundaryPropsBuilder<'a, TypedBuilderFields> +where + TypedBuilderFields: Clone, +{ + fn clone(&self) -> Self { + Self { + fields: self.fields.clone(), + _phantom: ::core::default::Default::default(), + } + } +} +impl<'a> Properties for ErrorBoundaryProps<'a> { + type Builder = ErrorBoundaryPropsBuilder<'a, ((), ())>; + const IS_STATIC: bool = false; + fn builder() -> Self::Builder { + ErrorBoundaryProps::builder() + } + unsafe fn memoize(&self, _: &Self) -> bool { + false + } +} +#[doc(hidden)] +#[allow(dead_code, non_camel_case_types, non_snake_case)] +pub trait ErrorBoundaryPropsBuilder_Optional { + fn into_value T>(self, default: F) -> T; +} +impl ErrorBoundaryPropsBuilder_Optional for () { + fn into_value T>(self, default: F) -> T { + default() + } +} +impl ErrorBoundaryPropsBuilder_Optional for (T,) { + fn into_value T>(self, _: F) -> T { + self.0 + } +} +#[allow(dead_code, non_camel_case_types, missing_docs)] +impl<'a, __handle_error> ErrorBoundaryPropsBuilder<'a, ((), __handle_error)> { + pub fn children( + self, + children: Element<'a>, + ) -> ErrorBoundaryPropsBuilder<'a, ((Element<'a>,), __handle_error)> { + let children = (children,); + let (_, handle_error) = self.fields; + ErrorBoundaryPropsBuilder { + fields: (children, handle_error), + _phantom: self._phantom, + } + } +} +#[doc(hidden)] +#[allow(dead_code, non_camel_case_types, non_snake_case)] +pub enum ErrorBoundaryPropsBuilder_Error_Repeated_field_children {} +#[doc(hidden)] +#[allow(dead_code, non_camel_case_types, missing_docs)] +impl<'a, __handle_error> ErrorBoundaryPropsBuilder<'a, ((Element<'a>,), __handle_error)> { + #[deprecated(note = "Repeated field children")] + pub fn children( + self, + _: ErrorBoundaryPropsBuilder_Error_Repeated_field_children, + ) -> ErrorBoundaryPropsBuilder<'a, ((Element<'a>,), __handle_error)> { + self + } +} +#[allow(dead_code, non_camel_case_types, missing_docs)] +impl<'a, __children> ErrorBoundaryPropsBuilder<'a, (__children, ())> { + pub fn handle_error( + self, + handle_error: impl ::core::convert::Into>, + ) -> ErrorBoundaryPropsBuilder<'a, (__children, (ErrorHandler<'a>,))> { + let handle_error = (handle_error.into(),); + let (children, _) = self.fields; + ErrorBoundaryPropsBuilder { + fields: (children, handle_error), + _phantom: self._phantom, + } + } +} +#[doc(hidden)] +#[allow(dead_code, non_camel_case_types, non_snake_case)] +pub enum ErrorBoundaryPropsBuilder_Error_Repeated_field_handle_error {} +#[doc(hidden)] +#[allow(dead_code, non_camel_case_types, missing_docs)] +impl<'a, __children> ErrorBoundaryPropsBuilder<'a, (__children, (ErrorHandler<'a>,))> { + #[deprecated(note = "Repeated field handle_error")] + pub fn handle_error( + self, + _: ErrorBoundaryPropsBuilder_Error_Repeated_field_handle_error, + ) -> ErrorBoundaryPropsBuilder<'a, (__children, (ErrorHandler<'a>,))> { + self + } +} +#[allow(dead_code, non_camel_case_types, missing_docs)] +impl< + 'a, + __handle_error: ErrorBoundaryPropsBuilder_Optional>, + __children: ErrorBoundaryPropsBuilder_Optional>, + > ErrorBoundaryPropsBuilder<'a, (__children, __handle_error)> +{ + pub fn build(self) -> ErrorBoundaryProps<'a> { + let (children, handle_error) = self.fields; + let children = ErrorBoundaryPropsBuilder_Optional::into_value(children, || { + ::core::default::Default::default() + }); + let handle_error = ErrorBoundaryPropsBuilder_Optional::into_value(handle_error, || { + ErrorHandler(Box::new(default_handler)) + }); + ErrorBoundaryProps { + children, + handle_error, + } + } +} +/// Create a new error boundary component. +/// +/// ## Details +/// +/// Error boundaries handle errors within a specific part of your application. Any errors passed in a child with [`Throw`] will be caught by the nearest error boundary. +/// +/// ## Example +/// +/// ```rust, ignore +/// rsx!{ +/// ErrorBoundary { +/// handle_error: |error| rsx! { "Oops, we encountered an error. Please report {error} to the developer of this application" } +/// ThrowsError {} +/// } +/// } +/// ``` +/// +/// ## Usage +/// +/// Error boundaries are an easy way to handle errors in your application. +/// They are similar to `try/catch` in JavaScript, but they only catch errors in the tree below them. +/// Error boundaries are quick to implement, but it can be useful to individually handle errors in your components to provide a better user experience when you know that an error is likely to occur. +#[allow(non_upper_case_globals, non_snake_case)] +pub fn ErrorBoundary<'a>(cx: Scope<'a, ErrorBoundaryProps<'a>>) -> Element { + let error_boundary = use_error_boundary(cx); + match error_boundary.take_error() { + Some(error) => cx.render((cx.props.handle_error.0)(error)), + None => Some({ + let __cx = cx; + static TEMPLATE: Template = Template { + name: "examples/error_handle.rs:81:17:2342", + roots: &[TemplateNode::Dynamic { id: 0usize }], + node_paths: &[&[0u8]], + attr_paths: &[], + }; + VNode { + parent: None, + key: None, + template: std::cell::Cell::new(TEMPLATE), + root_ids: bumpalo::collections::Vec::with_capacity_in(1usize, __cx.bump()).into(), + dynamic_nodes: __cx.bump().alloc([{ + let ___nodes = (&cx.props.children).into_vnode(__cx); + ___nodes + }]), + dynamic_attrs: __cx.bump().alloc([]), + } + }), } } diff --git a/packages/core/src/lib.rs b/packages/core/src/lib.rs index 392774767..13d55826b 100644 --- a/packages/core/src/lib.rs +++ b/packages/core/src/lib.rs @@ -90,10 +90,11 @@ pub mod prelude { pub use crate::innerlude::{ consume_context, consume_context_from_scope, current_scope_id, fc_to_builder, has_context, provide_context, provide_context_to_scope, provide_root_context, push_future, - remove_future, schedule_update_any, spawn, spawn_forever, suspend, throw, AnyValue, - Component, Element, Event, EventHandler, Fragment, IntoAttributeValue, IntoDynNode, - LazyNodes, Properties, Runtime, RuntimeGuard, Scope, ScopeId, ScopeState, Scoped, TaskId, - Template, TemplateAttribute, TemplateNode, Throw, VNode, VirtualDom, + remove_future, schedule_update_any, spawn, spawn_forever, suspend, use_error_boundary, + AnyValue, Component, Element, ErrorBoundary, Event, EventHandler, Fragment, + IntoAttributeValue, IntoDynNode, LazyNodes, Properties, Runtime, RuntimeGuard, Scope, + ScopeId, ScopeState, Scoped, TaskId, Template, TemplateAttribute, TemplateNode, Throw, + VNode, VirtualDom, }; } diff --git a/packages/core/src/scope_context.rs b/packages/core/src/scope_context.rs index 59bed3b1f..fd88dde12 100644 --- a/packages/core/src/scope_context.rs +++ b/packages/core/src/scope_context.rs @@ -1,5 +1,5 @@ use crate::{ - innerlude::{ErrorBoundary, Scheduler, SchedulerMsg}, + innerlude::{Scheduler, SchedulerMsg}, runtime::{with_current_scope, with_runtime}, Element, ScopeId, TaskId, }; @@ -7,7 +7,6 @@ use rustc_hash::FxHashSet; use std::{ any::Any, cell::{Cell, RefCell}, - fmt::Debug, future::Future, rc::Rc, sync::Arc, @@ -250,19 +249,6 @@ impl ScopeContext { self.tasks.remove(id); } - /// Inject an error into the nearest error boundary and quit rendering - /// - /// The error doesn't need to implement Error or any specific traits since the boundary - /// itself will downcast the error into a trait object. - pub fn throw(&self, error: impl Debug + 'static) -> Option<()> { - if let Some(cx) = self.consume_context::>() { - cx.insert_error(self.scope_id(), Box::new(error)); - } - - // Always return none during a throw - None - } - /// Mark this component as suspended and then return None pub fn suspend(&self) -> Option { self.suspended.set(true); @@ -332,11 +318,6 @@ pub fn suspend() -> Option> { None } -/// Throw an error into the nearest error boundary -pub fn throw(error: impl Debug + 'static) -> Option<()> { - with_current_scope(|cx| cx.throw(error)).flatten() -} - /// Pushes the future onto the poll queue to be polled after the component renders. pub fn push_future(fut: impl Future + 'static) -> Option { with_current_scope(|cx| cx.push_future(fut)) diff --git a/packages/core/src/scopes.rs b/packages/core/src/scopes.rs index 996529a0d..5a673c1a6 100644 --- a/packages/core/src/scopes.rs +++ b/packages/core/src/scopes.rs @@ -2,7 +2,6 @@ use crate::{ any_props::AnyProps, any_props::VProps, bump_frame::BumpFrame, - innerlude::ErrorBoundary, innerlude::{DynamicNode, EventHandler, VComponent, VText}, lazynodes::LazyNodes, nodes::{IntoAttributeValue, IntoDynNode, RenderReturn}, @@ -506,19 +505,6 @@ impl<'src> ScopeState { AttributeValue::Any(RefCell::new(Some(boxed))) } - /// Inject an error into the nearest error boundary and quit rendering - /// - /// The error doesn't need to implement Error or any specific traits since the boundary - /// itself will downcast the error into a trait object. - pub fn throw(&self, error: impl Debug + 'static) -> Option<()> { - if let Some(cx) = self.consume_context::>() { - cx.insert_error(self.scope_id(), Box::new(error)); - } - - // Always return none during a throw - None - } - /// Mark this component as suspended and then return None pub fn suspend(&self) -> Option { let cx = self.context(); diff --git a/packages/core/src/virtual_dom.rs b/packages/core/src/virtual_dom.rs index 2d83ba63a..13f030d3e 100644 --- a/packages/core/src/virtual_dom.rs +++ b/packages/core/src/virtual_dom.rs @@ -16,7 +16,7 @@ use crate::{ use futures_util::{pin_mut, StreamExt}; use rustc_hash::{FxHashMap, FxHashSet}; use slab::Slab; -use std::{any::Any, cell::Cell, collections::BTreeSet, future::Future, rc::Rc}; +use std::{any::Any, cell::Cell, collections::BTreeSet, future::Future, rc::Rc, sync::Arc}; /// A virtual node system that progresses user events and diffs UI trees. /// @@ -273,7 +273,10 @@ impl VirtualDom { ); // Unlike react, we provide a default error boundary that just renders the error as a string - root.provide_context(Rc::new(ErrorBoundary::new(ScopeId::ROOT))); + root.provide_context(Rc::new(ErrorBoundary::new_in_scope( + ScopeId::ROOT, + Arc::new(|_| {}), + ))); // the root element is always given element ID 0 since it's the container for the entire tree dom.elements.insert(ElementRef::none()); From 8ea7f076e5ff2b0a4ccc06cbfb93e93428d41b4b Mon Sep 17 00:00:00 2001 From: Joshua Wolfe <1369773+WolfeCub@users.noreply.github.com> Date: Wed, 8 Nov 2023 09:33:41 -0500 Subject: [PATCH 246/447] Updated server_fn to 0.5.2 (#1620) --- packages/fullstack/Cargo.toml | 2 +- packages/fullstack/src/server_fn.rs | 8 -------- packages/server-macro/Cargo.toml | 2 +- 3 files changed, 2 insertions(+), 10 deletions(-) diff --git a/packages/fullstack/Cargo.toml b/packages/fullstack/Cargo.toml index 8ab213e78..8de27a9b1 100644 --- a/packages/fullstack/Cargo.toml +++ b/packages/fullstack/Cargo.toml @@ -11,7 +11,7 @@ keywords = ["ui", "gui", "react", "ssr", "fullstack"] [dependencies] # server functions -server_fn = { version = "0.4.6", default-features = false } +server_fn = { version = "0.5.2", default-features = false } dioxus_server_macro = { workspace = true } # warp diff --git a/packages/fullstack/src/server_fn.rs b/packages/fullstack/src/server_fn.rs index 539a0d70a..fd0639372 100644 --- a/packages/fullstack/src/server_fn.rs +++ b/packages/fullstack/src/server_fn.rs @@ -125,14 +125,6 @@ impl server_fn::ServerFunctionRegistry<()> for DioxusServerFnRegistry { } } - fn register( - url: &'static str, - server_function: ServerFunction, - encoding: server_fn::Encoding, - ) -> Result<(), Self::Error> { - Self::register_explicit("", url, server_function, encoding) - } - /// Returns the server function registered at the given URL, or `None` if no function is registered at that URL. fn get(url: &str) -> Option> { REGISTERED_SERVER_FUNCTIONS diff --git a/packages/server-macro/Cargo.toml b/packages/server-macro/Cargo.toml index 5a38acb40..a91cc626a 100644 --- a/packages/server-macro/Cargo.toml +++ b/packages/server-macro/Cargo.toml @@ -17,7 +17,7 @@ proc-macro2 = "^1.0.63" quote = "^1.0.26" syn = { version = "2", features = ["full"] } convert_case = "^0.6.0" -server_fn_macro = "^0.4.6" +server_fn_macro = "^0.5.2" [lib] proc-macro = true From f1533781a4e0caed102f8e74ae836f37239bbb22 Mon Sep 17 00:00:00 2001 From: Bunny Bites Date: Thu, 9 Nov 2023 00:38:22 +0530 Subject: [PATCH 247/447] add fn to convert hashmap to json --- packages/html/src/events/form.rs | 30 +++++++++++++++++++++--------- 1 file changed, 21 insertions(+), 9 deletions(-) diff --git a/packages/html/src/events/form.rs b/packages/html/src/events/form.rs index e3b35b098..6346a99e6 100644 --- a/packages/html/src/events/form.rs +++ b/packages/html/src/events/form.rs @@ -1,11 +1,12 @@ use std::{any::Any, collections::HashMap, fmt::Debug}; use dioxus_core::Event; -use serde::{Deserialize, Serialize}; +use serde::{de::Error, Deserialize, Serialize}; pub type FormEvent = Event; -#[derive(Serialize, Deserialize)] +#[derive(Serialize, Deserialize, Debug)] +#[serde(untagged)] // this will serialize Text(String) -> String and VecText(Vec) to Vec enum ValueType { Text(String), VecText(Vec), @@ -30,13 +31,21 @@ pub struct FormData { pub files: Option>, } +fn convert_hashmap_to_json(hashmap: &HashMap) -> serde_json::Result +where + K: Serialize + std::hash::Hash + Eq, + V: Serialize, +{ + serde_json::to_string(hashmap) +} + impl FormData { // ***** function to parse the 'values' to make it ready to use******* // e.g - self.values = { username: ["rust"], password: ["dioxus"]} // what we need it to be: { username: "rust", password: "dioxus"} - fn get_parsed_values(&self) -> Option> { + fn get_parsed_values(&self) -> Result { if self.values.is_empty() { - return None; + return Err(serde_json::Error::custom("Values is empty")); } let raw_values = self.values.clone(); @@ -58,21 +67,24 @@ impl FormData { parsed_values.insert(fieldname, ValueType::VecText(values.clone())); } else { // handle single value - case 2 - let prepared_value = values.into_iter().next()?; + let prepared_value = values.into_iter().next().unwrap(); parsed_values.insert(fieldname, ValueType::Text(prepared_value)); } } - Some(parsed_values) + // convert HashMap to JSON string + convert_hashmap_to_json(&parsed_values) } pub fn parse_json(&self) -> Result where T: serde::de::DeserializeOwned, { - let formatted = self.get_parsed_values(); - let as_string = serde_json::to_string(&formatted)?; - serde_json::from_str(&as_string) + let parsed_json = self + .get_parsed_values() + .expect("Failed to parse values to JSON"); + + serde_json::from_str(&parsed_json) } } From 1a9d1eda19827c53da48a966d7418ad1f241466b Mon Sep 17 00:00:00 2001 From: Bunny Bites Date: Thu, 9 Nov 2023 00:41:50 +0530 Subject: [PATCH 248/447] optimize hashmap insertion --- packages/html/src/events/form.rs | 23 +++++++++++++++-------- 1 file changed, 15 insertions(+), 8 deletions(-) diff --git a/packages/html/src/events/form.rs b/packages/html/src/events/form.rs index 6346a99e6..1303dc209 100644 --- a/packages/html/src/events/form.rs +++ b/packages/html/src/events/form.rs @@ -62,14 +62,21 @@ impl FormData { In this case we would want to deserialize the value as follows favourite_language: "rust" */ - if values.len() > 1 { - // handling multiple values - case 1 - parsed_values.insert(fieldname, ValueType::VecText(values.clone())); - } else { - // handle single value - case 2 - let prepared_value = values.into_iter().next().unwrap(); - parsed_values.insert(fieldname, ValueType::Text(prepared_value)); - } + parsed_values.insert( + fieldname, + if values.len() > 1 { + // handling multiple values - case 1 + ValueType::VecText(values) + } else { + // handle single value - case 2 + ValueType::Text( + values + .into_iter() + .next() + .ok_or_else(|| serde_json::Error::custom("Values array is empty"))?, + ) + }, + ); } // convert HashMap to JSON string From c2749b3371e9806a6d8af3f7c5c6e9bb9c43746d Mon Sep 17 00:00:00 2001 From: Erithax Date: Thu, 9 Nov 2023 02:00:36 +0100 Subject: [PATCH 249/447] rename IntoDynNode and IntoTemplate traits --- packages/core/src/nodes.rs | 50 ++++++++++++++++++------------------- packages/core/src/scopes.rs | 2 +- packages/rsx/src/node.rs | 8 +++--- 3 files changed, 30 insertions(+), 30 deletions(-) diff --git a/packages/core/src/nodes.rs b/packages/core/src/nodes.rs index c83b1059a..ed4f44064 100644 --- a/packages/core/src/nodes.rs +++ b/packages/core/src/nodes.rs @@ -651,52 +651,52 @@ pub trait IntoDynNode<'a, A = ()> { /// Consume this item along with a scopestate and produce a DynamicNode /// /// You can use the bump alloactor of the scopestate to creat the dynamic node - fn into_vnode(self, cx: &'a ScopeState) -> DynamicNode<'a>; + fn into_dyn_node(self, cx: &'a ScopeState) -> DynamicNode<'a>; } impl<'a> IntoDynNode<'a> for () { - fn into_vnode(self, _cx: &'a ScopeState) -> DynamicNode<'a> { + fn into_dyn_node(self, _cx: &'a ScopeState) -> DynamicNode<'a> { DynamicNode::default() } } impl<'a> IntoDynNode<'a> for VNode<'a> { - fn into_vnode(self, _cx: &'a ScopeState) -> DynamicNode<'a> { + fn into_dyn_node(self, _cx: &'a ScopeState) -> DynamicNode<'a> { DynamicNode::Fragment(_cx.bump().alloc([self])) } } impl<'a> IntoDynNode<'a> for DynamicNode<'a> { - fn into_vnode(self, _cx: &'a ScopeState) -> DynamicNode<'a> { + fn into_dyn_node(self, _cx: &'a ScopeState) -> DynamicNode<'a> { self } } impl<'a, T: IntoDynNode<'a>> IntoDynNode<'a> for Option { - fn into_vnode(self, _cx: &'a ScopeState) -> DynamicNode<'a> { + fn into_dyn_node(self, _cx: &'a ScopeState) -> DynamicNode<'a> { match self { - Some(val) => val.into_vnode(_cx), + Some(val) => val.into_dyn_node(_cx), None => DynamicNode::default(), } } } impl<'a> IntoDynNode<'a> for &Element<'a> { - fn into_vnode(self, _cx: &'a ScopeState) -> DynamicNode<'a> { + fn into_dyn_node(self, _cx: &'a ScopeState) -> DynamicNode<'a> { match self.as_ref() { - Some(val) => val.clone().into_vnode(_cx), + Some(val) => val.clone().into_dyn_node(_cx), _ => DynamicNode::default(), } } } impl<'a, 'b> IntoDynNode<'a> for LazyNodes<'a, 'b> { - fn into_vnode(self, cx: &'a ScopeState) -> DynamicNode<'a> { + fn into_dyn_node(self, cx: &'a ScopeState) -> DynamicNode<'a> { DynamicNode::Fragment(cx.bump().alloc([cx.render(self).unwrap()])) } } impl<'a, 'b> IntoDynNode<'b> for &'a str { - fn into_vnode(self, cx: &'b ScopeState) -> DynamicNode<'b> { + fn into_dyn_node(self, cx: &'b ScopeState) -> DynamicNode<'b> { DynamicNode::Text(VText { value: cx.bump().alloc_str(self), id: Default::default(), @@ -705,7 +705,7 @@ impl<'a, 'b> IntoDynNode<'b> for &'a str { } impl IntoDynNode<'_> for String { - fn into_vnode(self, cx: &ScopeState) -> DynamicNode { + fn into_dyn_node(self, cx: &ScopeState) -> DynamicNode { DynamicNode::Text(VText { value: cx.bump().alloc(self), id: Default::default(), @@ -714,13 +714,13 @@ impl IntoDynNode<'_> for String { } impl<'b> IntoDynNode<'b> for Arguments<'_> { - fn into_vnode(self, cx: &'b ScopeState) -> DynamicNode<'b> { + fn into_dyn_node(self, cx: &'b ScopeState) -> DynamicNode<'b> { cx.text_node(self) } } impl<'a> IntoDynNode<'a> for &'a VNode<'a> { - fn into_vnode(self, _cx: &'a ScopeState) -> DynamicNode<'a> { + fn into_dyn_node(self, _cx: &'a ScopeState) -> DynamicNode<'a> { DynamicNode::Fragment(_cx.bump().alloc([VNode { parent: self.parent, template: self.template.clone(), @@ -732,24 +732,24 @@ impl<'a> IntoDynNode<'a> for &'a VNode<'a> { } } -pub trait IntoTemplate<'a> { - fn into_template(self, _cx: &'a ScopeState) -> VNode<'a>; +pub trait IntoVNode<'a> { + fn into_vnode(self, _cx: &'a ScopeState) -> VNode<'a>; } -impl<'a> IntoTemplate<'a> for VNode<'a> { - fn into_template(self, _cx: &'a ScopeState) -> VNode<'a> { +impl<'a> IntoVNode<'a> for VNode<'a> { + fn into_vnode(self, _cx: &'a ScopeState) -> VNode<'a> { self } } -impl<'a> IntoTemplate<'a> for Element<'a> { - fn into_template(self, cx: &'a ScopeState) -> VNode<'a> { +impl<'a> IntoVNode<'a> for Element<'a> { + fn into_vnode(self, cx: &'a ScopeState) -> VNode<'a> { match self { - Some(val) => val.into_template(cx), + Some(val) => val.into_vnode(cx), _ => VNode::empty(cx).unwrap(), } } } -impl<'a, 'b> IntoTemplate<'a> for LazyNodes<'a, 'b> { - fn into_template(self, cx: &'a ScopeState) -> VNode<'a> { +impl<'a, 'b> IntoVNode<'a> for LazyNodes<'a, 'b> { + fn into_vnode(self, cx: &'a ScopeState) -> VNode<'a> { cx.render(self).unwrap() } } @@ -759,12 +759,12 @@ pub struct FromNodeIterator; impl<'a, T, I> IntoDynNode<'a, FromNodeIterator> for T where T: Iterator, - I: IntoTemplate<'a>, + I: IntoVNode<'a>, { - fn into_vnode(self, cx: &'a ScopeState) -> DynamicNode<'a> { + fn into_dyn_node(self, cx: &'a ScopeState) -> DynamicNode<'a> { let mut nodes = bumpalo::collections::Vec::new_in(cx.bump()); - nodes.extend(self.into_iter().map(|node| node.into_template(cx))); + nodes.extend(self.into_iter().map(|node| node.into_vnode(cx))); match nodes.into_bump_slice() { children if children.is_empty() => DynamicNode::default(), diff --git a/packages/core/src/scopes.rs b/packages/core/src/scopes.rs index 3fd2aac30..a1cb7c485 100644 --- a/packages/core/src/scopes.rs +++ b/packages/core/src/scopes.rs @@ -401,7 +401,7 @@ impl<'src> ScopeState { /// Convert any item that implements [`IntoDynNode`] into a [`DynamicNode`] using the internal [`Bump`] allocator pub fn make_node<'c, I>(&'src self, into: impl IntoDynNode<'src, I> + 'c) -> DynamicNode { - into.into_vnode(self) + into.into_dyn_node(self) } /// Create a new [`Attribute`] from a name, value, namespace, and volatile bool diff --git a/packages/rsx/src/node.rs b/packages/rsx/src/node.rs index ed5e0bff4..350403e67 100644 --- a/packages/rsx/src/node.rs +++ b/packages/rsx/src/node.rs @@ -126,7 +126,7 @@ impl ToTokens for BodyNode { }), BodyNode::RawExpr(exp) => tokens.append_all(quote! { { - let ___nodes = (#exp).into_vnode(__cx); + let ___nodes = (#exp).into_dyn_node(__cx); ___nodes } }), @@ -145,7 +145,7 @@ impl ToTokens for BodyNode { // And then we can return them into the dyn loop tokens.append_all(quote! { { - let ___nodes =(#expr).into_iter().map(|#pat| { #renderer }).into_vnode(__cx); + let ___nodes =(#expr).into_iter().map(|#pat| { #renderer }).into_dyn_node(__cx); ___nodes } }) @@ -154,7 +154,7 @@ impl ToTokens for BodyNode { if is_if_chain_terminated(chain) { tokens.append_all(quote! { { - let ___nodes = (#chain).into_vnode(__cx); + let ___nodes = (#chain).into_dyn_node(__cx); ___nodes } }); @@ -211,7 +211,7 @@ impl ToTokens for BodyNode { tokens.append_all(quote! { { - let ___nodes = (#body).into_vnode(__cx); + let ___nodes = (#body).into_dyn_node(__cx); ___nodes } }); From 2cbbdc23c6bda33609cd10d85e0d3cc6450b7186 Mon Sep 17 00:00:00 2001 From: Bunny Bites Date: Thu, 9 Nov 2023 11:04:47 +0530 Subject: [PATCH 250/447] add impl fn for FormData to get input types --- packages/html/src/events/form.rs | 15 ++++++++++++++- packages/rink/src/hooks.rs | 3 +++ packages/rink/src/widgets/button.rs | 1 + packages/rink/src/widgets/checkbox.rs | 1 + packages/rink/src/widgets/slider.rs | 1 + packages/rink/src/widgets/text_like.rs | 1 + packages/web/src/dom.rs | 18 +++++++++++++++++- 7 files changed, 38 insertions(+), 2 deletions(-) diff --git a/packages/html/src/events/form.rs b/packages/html/src/events/form.rs index 1303dc209..2e2fc5934 100644 --- a/packages/html/src/events/form.rs +++ b/packages/html/src/events/form.rs @@ -20,6 +20,8 @@ pub struct FormData { pub values: HashMap>, + pub value_types: HashMap, + #[cfg_attr( feature = "serialize", serde( @@ -53,6 +55,17 @@ impl FormData { let mut parsed_values: HashMap = HashMap::new(); for (fieldname, values) in raw_values.into_iter() { + // check if the fieldname can hold multiple values based on its types + let field_type = self + .value_types + .get(&fieldname) + .expect("Provided invalid field"); + + let is_multi_valued_input = match field_type.as_str() { + "select" | "checkbox" => true, + _ => false, + }; + /* case 1 - multiple values, example { driving_types: ["manual", "automatic"] } In this case we want to return the values as it is, NO point in making @@ -64,7 +77,7 @@ impl FormData { */ parsed_values.insert( fieldname, - if values.len() > 1 { + if is_multi_valued_input { // handling multiple values - case 1 ValueType::VecText(values) } else { diff --git a/packages/rink/src/hooks.rs b/packages/rink/src/hooks.rs index f8c4500d2..47efc9e7e 100644 --- a/packages/rink/src/hooks.rs +++ b/packages/rink/src/hooks.rs @@ -63,6 +63,8 @@ pub struct FormData { pub values: HashMap>, + pub value_types: HashMap, + pub files: Option, } @@ -71,6 +73,7 @@ impl FormData { dioxus_html::FormData { value: self.value, values: self.values, + value_types: self.value_types, files: None, } } diff --git a/packages/rink/src/widgets/button.rs b/packages/rink/src/widgets/button.rs index 523b2392a..41be40da5 100644 --- a/packages/rink/src/widgets/button.rs +++ b/packages/rink/src/widgets/button.rs @@ -93,6 +93,7 @@ impl Button { let data = FormData { value: self.value.to_string(), values: HashMap::new(), + value_types: HashMap::new(), files: None, }; ctx.send(crate::Event { diff --git a/packages/rink/src/widgets/checkbox.rs b/packages/rink/src/widgets/checkbox.rs index fab809ed2..ea5a0ba53 100644 --- a/packages/rink/src/widgets/checkbox.rs +++ b/packages/rink/src/widgets/checkbox.rs @@ -129,6 +129,7 @@ impl CheckBox { .then(|| self.value.to_string()) .unwrap_or_default(), values: HashMap::new(), + value_types: HashMap::new(), files: None, }; { diff --git a/packages/rink/src/widgets/slider.rs b/packages/rink/src/widgets/slider.rs index 7080b6c12..dd1b50a7b 100644 --- a/packages/rink/src/widgets/slider.rs +++ b/packages/rink/src/widgets/slider.rs @@ -198,6 +198,7 @@ impl Slider { let data = FormData { value: self.value.to_string(), values: HashMap::new(), + value_types: HashMap::new(), files: None, }; ctx.send(Event { diff --git a/packages/rink/src/widgets/text_like.rs b/packages/rink/src/widgets/text_like.rs index 6521073d0..c9dacb74e 100644 --- a/packages/rink/src/widgets/text_like.rs +++ b/packages/rink/src/widgets/text_like.rs @@ -171,6 +171,7 @@ impl TextLike { let data: FormData = FormData { value: self.text.clone(), values: HashMap::new(), + value_types: HashMap::new(), files: None, }; let ctx: UniqueView = world.borrow().expect("expected widget context"); diff --git a/packages/web/src/dom.rs b/packages/web/src/dom.rs index f45d6558a..556d9ab9a 100644 --- a/packages/web/src/dom.rs +++ b/packages/web/src/dom.rs @@ -15,7 +15,7 @@ use dioxus_interpreter_js::{get_node, minimal_bindings, save_template, Channel}; use futures_channel::mpsc; use js_sys::Array; use rustc_hash::FxHashMap; -use std::{any::Any, rc::Rc}; +use std::{any::Any, collections::HashMap, rc::Rc}; use wasm_bindgen::{closure::Closure, prelude::wasm_bindgen, JsCast, JsValue}; use web_sys::{Document, Element, Event}; @@ -365,6 +365,21 @@ fn read_input_to_data(target: Element) -> Rc { }) .expect("only an InputElement or TextAreaElement or an element with contenteditable=true can have an oninput event listener"); + let mut value_types = HashMap::new(); + + // to get the input_type for the corresponding input + for input_el in target.dyn_ref::().into_iter() { + for index in 0..input_el.length() { + if let Some(element) = input_el.get_with_index(index as u32) { + if let Some(input) = element.dyn_into::().ok() { + let name = input.name(); + let input_type = input.type_(); + value_types.insert(name, input_type); + } + } + } + } + let mut values = std::collections::HashMap::new(); // try to fill in form values @@ -400,6 +415,7 @@ fn read_input_to_data(target: Element) -> Rc { Rc::new(FormData { value, values, + value_types, files, }) } From 9f0e00029503ce0a3807ea37f2aa72c44da9e5af Mon Sep 17 00:00:00 2001 From: Bunny Bites Date: Thu, 9 Nov 2023 11:09:07 +0530 Subject: [PATCH 251/447] provide proper error message --- packages/html/src/events/form.rs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/html/src/events/form.rs b/packages/html/src/events/form.rs index 2e2fc5934..e86f72167 100644 --- a/packages/html/src/events/form.rs +++ b/packages/html/src/events/form.rs @@ -47,7 +47,7 @@ impl FormData { // what we need it to be: { username: "rust", password: "dioxus"} fn get_parsed_values(&self) -> Result { if self.values.is_empty() { - return Err(serde_json::Error::custom("Values is empty")); + return Err(serde_json::Error::custom("Values array is empty")); } let raw_values = self.values.clone(); From 4b4dcbed6a34c870b95fdc6d988b86fd7ae10154 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Thu, 9 Nov 2023 08:43:38 -0600 Subject: [PATCH 252/447] fix error boundary test --- packages/core/tests/error_boundary.rs | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/packages/core/tests/error_boundary.rs b/packages/core/tests/error_boundary.rs index ce26fba31..58d861169 100644 --- a/packages/core/tests/error_boundary.rs +++ b/packages/core/tests/error_boundary.rs @@ -24,9 +24,9 @@ fn NoneChild(_cx: Scope) -> Element { } fn ThrowChild(cx: Scope) -> Element { - cx.throw(std::io::Error::new(std::io::ErrorKind::AddrInUse, "asd"))?; + Err(std::io::Error::new(std::io::ErrorKind::AddrInUse, "asd")).throw()?; - let _g: i32 = "123123".parse().throw(cx)?; + let _g: i32 = "123123".parse().throw()?; cx.render(rsx! { div {} From d4b0451d096c67616be4b27de7a9e482ac5d8fd6 Mon Sep 17 00:00:00 2001 From: tigerros Date: Thu, 9 Nov 2023 19:31:59 +0100 Subject: [PATCH 253/447] Allow warning in necessary functions (#1626) --- packages/core-macro/src/props/mod.rs | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/packages/core-macro/src/props/mod.rs b/packages/core-macro/src/props/mod.rs index aba8137e7..6e6c43d66 100644 --- a/packages/core-macro/src/props/mod.rs +++ b/packages/core-macro/src/props/mod.rs @@ -631,7 +631,7 @@ Finally, call `.build()` to create the instance of `{name}`. Ok(quote! { impl #impl_generics #name #ty_generics #where_clause { #[doc = #builder_method_doc] - #[allow(dead_code)] + #[allow(dead_code, clippy::type_complexity)] #vis fn builder() -> #builder_name #generics_with_empty { #builder_name { fields: #empties_tuple, @@ -823,6 +823,7 @@ Finally, call `.build()` to create the instance of `{name}`. #[allow(dead_code, non_camel_case_types, missing_docs)] impl #impl_generics #builder_name < #( #ty_generics ),* > #where_clause { #doc + #[allow(clippy::type_complexity)] pub fn #field_name (self, #field_name: #arg_type) -> #builder_name < #( #target_generics ),* > { let #field_name = (#arg_expr,); let ( #(#descructuring,)* ) = self.fields; @@ -841,6 +842,7 @@ Finally, call `.build()` to create the instance of `{name}`. #[deprecated( note = #repeated_fields_error_message )] + #[allow(clippy::type_complexity)] pub fn #field_name (self, _: #repeated_fields_error_type_name) -> #builder_name < #( #target_generics ),* > { self } From c6b39c05b704e7f0151eff00c5f6f774d7883702 Mon Sep 17 00:00:00 2001 From: Bunny Bites Date: Fri, 10 Nov 2023 11:44:19 +0530 Subject: [PATCH 254/447] 1. remove value_types from FormData. 2. modify type of values to accept dynamic type. --- packages/html/src/events/form.rs | 69 +++----------------------- packages/rink/src/hooks.rs | 5 +- packages/rink/src/widgets/button.rs | 1 - packages/rink/src/widgets/slider.rs | 1 - packages/rink/src/widgets/text_like.rs | 1 - packages/web/src/dom.rs | 40 +++++++-------- 6 files changed, 26 insertions(+), 91 deletions(-) diff --git a/packages/html/src/events/form.rs b/packages/html/src/events/form.rs index e86f72167..5bdf5124d 100644 --- a/packages/html/src/events/form.rs +++ b/packages/html/src/events/form.rs @@ -1,13 +1,13 @@ use std::{any::Any, collections::HashMap, fmt::Debug}; use dioxus_core::Event; -use serde::{de::Error, Deserialize, Serialize}; +use serde::{Deserialize, Serialize}; pub type FormEvent = Event; -#[derive(Serialize, Deserialize, Debug)] +#[derive(Serialize, Deserialize, Debug, Clone, PartialEq)] #[serde(untagged)] // this will serialize Text(String) -> String and VecText(Vec) to Vec -enum ValueType { +pub enum ValueType { Text(String), VecText(Vec), } @@ -18,9 +18,7 @@ enum ValueType { pub struct FormData { pub value: String, - pub values: HashMap>, - - pub value_types: HashMap, + pub values: HashMap, #[cfg_attr( feature = "serialize", @@ -42,67 +40,12 @@ where } impl FormData { - // ***** function to parse the 'values' to make it ready to use******* - // e.g - self.values = { username: ["rust"], password: ["dioxus"]} - // what we need it to be: { username: "rust", password: "dioxus"} - fn get_parsed_values(&self) -> Result { - if self.values.is_empty() { - return Err(serde_json::Error::custom("Values array is empty")); - } - - let raw_values = self.values.clone(); - - let mut parsed_values: HashMap = HashMap::new(); - - for (fieldname, values) in raw_values.into_iter() { - // check if the fieldname can hold multiple values based on its types - let field_type = self - .value_types - .get(&fieldname) - .expect("Provided invalid field"); - - let is_multi_valued_input = match field_type.as_str() { - "select" | "checkbox" => true, - _ => false, - }; - - /* - case 1 - multiple values, example { driving_types: ["manual", "automatic"] } - In this case we want to return the values as it is, NO point in making - driving_types: "manual, automatic" - - case 2 - single value, example { favourite_language: ["rust"] } - In this case we would want to deserialize the value as follows - favourite_language: "rust" - */ - parsed_values.insert( - fieldname, - if is_multi_valued_input { - // handling multiple values - case 1 - ValueType::VecText(values) - } else { - // handle single value - case 2 - ValueType::Text( - values - .into_iter() - .next() - .ok_or_else(|| serde_json::Error::custom("Values array is empty"))?, - ) - }, - ); - } - - // convert HashMap to JSON string - convert_hashmap_to_json(&parsed_values) - } - pub fn parse_json(&self) -> Result where T: serde::de::DeserializeOwned, { - let parsed_json = self - .get_parsed_values() - .expect("Failed to parse values to JSON"); + let parsed_json = + convert_hashmap_to_json(&self.values.clone()).expect("Failed to parse values to JSON"); serde_json::from_str(&parsed_json) } diff --git a/packages/rink/src/hooks.rs b/packages/rink/src/hooks.rs index 47efc9e7e..f457de29f 100644 --- a/packages/rink/src/hooks.rs +++ b/packages/rink/src/hooks.rs @@ -61,9 +61,7 @@ impl EventData { pub struct FormData { pub value: String, - pub values: HashMap>, - - pub value_types: HashMap, + pub values: HashMap, pub files: Option, } @@ -73,7 +71,6 @@ impl FormData { dioxus_html::FormData { value: self.value, values: self.values, - value_types: self.value_types, files: None, } } diff --git a/packages/rink/src/widgets/button.rs b/packages/rink/src/widgets/button.rs index 41be40da5..523b2392a 100644 --- a/packages/rink/src/widgets/button.rs +++ b/packages/rink/src/widgets/button.rs @@ -93,7 +93,6 @@ impl Button { let data = FormData { value: self.value.to_string(), values: HashMap::new(), - value_types: HashMap::new(), files: None, }; ctx.send(crate::Event { diff --git a/packages/rink/src/widgets/slider.rs b/packages/rink/src/widgets/slider.rs index dd1b50a7b..7080b6c12 100644 --- a/packages/rink/src/widgets/slider.rs +++ b/packages/rink/src/widgets/slider.rs @@ -198,7 +198,6 @@ impl Slider { let data = FormData { value: self.value.to_string(), values: HashMap::new(), - value_types: HashMap::new(), files: None, }; ctx.send(Event { diff --git a/packages/rink/src/widgets/text_like.rs b/packages/rink/src/widgets/text_like.rs index c9dacb74e..6521073d0 100644 --- a/packages/rink/src/widgets/text_like.rs +++ b/packages/rink/src/widgets/text_like.rs @@ -171,7 +171,6 @@ impl TextLike { let data: FormData = FormData { value: self.text.clone(), values: HashMap::new(), - value_types: HashMap::new(), files: None, }; let ctx: UniqueView = world.borrow().expect("expected widget context"); diff --git a/packages/web/src/dom.rs b/packages/web/src/dom.rs index 556d9ab9a..3188e0935 100644 --- a/packages/web/src/dom.rs +++ b/packages/web/src/dom.rs @@ -10,7 +10,7 @@ use dioxus_core::{ BorrowedAttributeValue, ElementId, Mutation, Template, TemplateAttribute, TemplateNode, }; -use dioxus_html::{event_bubbles, CompositionData, FormData, MountedData}; +use dioxus_html::{event_bubbles, CompositionData, FormData, MountedData, ValueType}; use dioxus_interpreter_js::{get_node, minimal_bindings, save_template, Channel}; use futures_channel::mpsc; use js_sys::Array; @@ -365,22 +365,7 @@ fn read_input_to_data(target: Element) -> Rc { }) .expect("only an InputElement or TextAreaElement or an element with contenteditable=true can have an oninput event listener"); - let mut value_types = HashMap::new(); - - // to get the input_type for the corresponding input - for input_el in target.dyn_ref::().into_iter() { - for index in 0..input_el.length() { - if let Some(element) = input_el.get_with_index(index as u32) { - if let Some(input) = element.dyn_into::().ok() { - let name = input.name(); - let input_type = input.type_(); - value_types.insert(name, input_type); - } - } - } - } - - let mut values = std::collections::HashMap::new(); + let mut values = HashMap::new(); // try to fill in form values if let Some(form) = target.dyn_ref::() { @@ -389,10 +374,12 @@ fn read_input_to_data(target: Element) -> Rc { if let Ok(array) = value.dyn_into::() { if let Some(name) = array.get(0).as_string() { if let Ok(item_values) = array.get(1).dyn_into::() { - let item_values = + let item_values: Vec = item_values.iter().filter_map(|v| v.as_string()).collect(); - values.insert(name, item_values); + values.insert(name, ValueType::VecText(item_values)); + } else if let Ok(item_value) = array.get(1).dyn_into::() { + values.insert(name, ValueType::Text(item_value.as_string().unwrap())); } } } @@ -415,7 +402,6 @@ fn read_input_to_data(target: Element) -> Rc { Rc::new(FormData { value, values, - value_types, files, }) } @@ -424,10 +410,22 @@ fn read_input_to_data(target: Element) -> Rc { #[wasm_bindgen(inline_js = r#" export function get_form_data(form) { let values = new Map(); + const formData = new FormData(form); for (let name of formData.keys()) { - values.set(name, formData.getAll(name)); + const fieldType = form.elements[name].type; + + switch (fieldType) { + case "select-multiple": + values.set(name, formData.getAll(name)); + break; + + // add cases for fieldTypes that can hold multiple values here + default: + values.set(name, formData.get(name)); + break; + } } return values; From 6398af1d65fe10a0f4aefc831cdbe78947bf1de8 Mon Sep 17 00:00:00 2001 From: Bunny Bites Date: Fri, 10 Nov 2023 23:23:26 +0530 Subject: [PATCH 255/447] code cleanup --- packages/rink/src/hooks.rs | 1 + packages/rink/src/widgets/checkbox.rs | 1 - 2 files changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/rink/src/hooks.rs b/packages/rink/src/hooks.rs index f457de29f..494d3224f 100644 --- a/packages/rink/src/hooks.rs +++ b/packages/rink/src/hooks.rs @@ -13,6 +13,7 @@ use dioxus_html::geometry::{ use dioxus_html::input_data::keyboard_types::{Code, Key, Location, Modifiers}; use dioxus_html::input_data::MouseButtonSet as DioxusMouseButtons; use dioxus_html::input_data::{MouseButton as DioxusMouseButton, MouseButtonSet}; +use dioxus_html::ValueType; use dioxus_html::{event_bubbles, FocusData, KeyboardData, MouseData, WheelData}; use std::any::Any; use std::collections::HashMap; diff --git a/packages/rink/src/widgets/checkbox.rs b/packages/rink/src/widgets/checkbox.rs index ea5a0ba53..fab809ed2 100644 --- a/packages/rink/src/widgets/checkbox.rs +++ b/packages/rink/src/widgets/checkbox.rs @@ -129,7 +129,6 @@ impl CheckBox { .then(|| self.value.to_string()) .unwrap_or_default(), values: HashMap::new(), - value_types: HashMap::new(), files: None, }; { From 2b459e6fc14a75aa3820905d9f5e35f6d69d8504 Mon Sep 17 00:00:00 2001 From: Bunny Bites Date: Fri, 10 Nov 2023 23:32:41 +0530 Subject: [PATCH 256/447] 1. optimize import. 2. modify post event serialization. --- packages/interpreter/src/interpreter.js | 14 ++++++++++++-- packages/rink/src/hooks.rs | 3 +-- 2 files changed, 13 insertions(+), 4 deletions(-) diff --git a/packages/interpreter/src/interpreter.js b/packages/interpreter/src/interpreter.js index a03983ffa..2a1841171 100644 --- a/packages/interpreter/src/interpreter.js +++ b/packages/interpreter/src/interpreter.js @@ -453,8 +453,18 @@ function handler(event, name, bubbles, config) { const formData = new FormData(target); for (let name of formData.keys()) { - let value = formData.getAll(name); - contents.values[name] = value; + const fieldType = form.elements[name].type; + + switch (fieldType) { + case "select-multiple": + contents.values[name] = formData.getAll(name); + break; + + // add cases for fieldTypes that can hold multiple values here + default: + contents.values[name] = formData.get(name); + break; + } } } diff --git a/packages/rink/src/hooks.rs b/packages/rink/src/hooks.rs index 494d3224f..8842ffe60 100644 --- a/packages/rink/src/hooks.rs +++ b/packages/rink/src/hooks.rs @@ -13,8 +13,7 @@ use dioxus_html::geometry::{ use dioxus_html::input_data::keyboard_types::{Code, Key, Location, Modifiers}; use dioxus_html::input_data::MouseButtonSet as DioxusMouseButtons; use dioxus_html::input_data::{MouseButton as DioxusMouseButton, MouseButtonSet}; -use dioxus_html::ValueType; -use dioxus_html::{event_bubbles, FocusData, KeyboardData, MouseData, WheelData}; +use dioxus_html::{event_bubbles, FocusData, KeyboardData, MouseData, ValueType, WheelData}; use std::any::Any; use std::collections::HashMap; use std::{ From 8183935f661cd489b3fa7e101c2ed147547912b3 Mon Sep 17 00:00:00 2001 From: Bunny Bites Date: Sat, 11 Nov 2023 09:36:26 +0530 Subject: [PATCH 257/447] remove unwanted cloning while passing reference. --- packages/html/src/events/form.rs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/html/src/events/form.rs b/packages/html/src/events/form.rs index 5bdf5124d..de2494a50 100644 --- a/packages/html/src/events/form.rs +++ b/packages/html/src/events/form.rs @@ -45,7 +45,7 @@ impl FormData { T: serde::de::DeserializeOwned, { let parsed_json = - convert_hashmap_to_json(&self.values.clone()).expect("Failed to parse values to JSON"); + convert_hashmap_to_json(&self.values).expect("Failed to parse values to JSON"); serde_json::from_str(&parsed_json) } From 48295b021c377ce53921d50c4521ba183b2de6d6 Mon Sep 17 00:00:00 2001 From: Bunny Bites Date: Sat, 11 Nov 2023 21:27:44 +0530 Subject: [PATCH 258/447] remove optional config of serde_json --- packages/html/Cargo.toml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/html/Cargo.toml b/packages/html/Cargo.toml index 5644b440c..b8e91e5ac 100644 --- a/packages/html/Cargo.toml +++ b/packages/html/Cargo.toml @@ -23,7 +23,7 @@ serde-value = "0.7.0" tokio = { workspace = true, features = ["fs", "io-util"], optional = true } rfd = { version = "0.11.3", optional = true } async-channel = "1.8.0" -serde_json = { version = "1", optional = true } +serde_json = { version = "1" } [dependencies.web-sys] optional = true From 13a82a370500ad0c7f498618d20bd5a3b6f133f6 Mon Sep 17 00:00:00 2001 From: Bunny Bites Date: Sat, 11 Nov 2023 21:55:08 +0530 Subject: [PATCH 259/447] remove serde and serde_json from serialize dependency. --- packages/html/Cargo.toml | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/packages/html/Cargo.toml b/packages/html/Cargo.toml index b8e91e5ac..0d9085f6a 100644 --- a/packages/html/Cargo.toml +++ b/packages/html/Cargo.toml @@ -12,7 +12,7 @@ keywords = ["dom", "ui", "gui", "react"] [dependencies] dioxus-core = { workspace = true } dioxus-rsx = { workspace = true, features = ["hot_reload"], optional = true } -serde = { version = "1", features = ["derive"], optional = true } +serde = { version = "1", features = ["derive"] } serde_repr = { version = "0.1", optional = true } wasm-bindgen = { workspace = true, optional = true } euclid = "0.22.7" @@ -50,9 +50,7 @@ serde_json = "1" [features] default = ["serialize", "mounted"] serialize = [ - "serde", "serde_repr", - "serde_json", "euclid/serde", "keyboard-types/serde", "dioxus-core/serialize", From a74e6d82c73338cf9f5d05ecd47d1f19e86d0a14 Mon Sep 17 00:00:00 2001 From: Bunny Bites Date: Sun, 12 Nov 2023 13:09:51 +0530 Subject: [PATCH 260/447] rename parse_json to parsed_values --- packages/html/src/events/form.rs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/html/src/events/form.rs b/packages/html/src/events/form.rs index de2494a50..d48c20370 100644 --- a/packages/html/src/events/form.rs +++ b/packages/html/src/events/form.rs @@ -40,7 +40,7 @@ where } impl FormData { - pub fn parse_json(&self) -> Result + pub fn parsed_values(&self) -> Result where T: serde::de::DeserializeOwned, { From 7f4e2af0c48e33915e96f0ac5e75b4c18e706632 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Mon, 13 Nov 2023 08:17:08 -0600 Subject: [PATCH 261/447] fix string memory leak --- packages/core/src/nodes.rs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/core/src/nodes.rs b/packages/core/src/nodes.rs index c83b1059a..b6a685ad3 100644 --- a/packages/core/src/nodes.rs +++ b/packages/core/src/nodes.rs @@ -707,7 +707,7 @@ impl<'a, 'b> IntoDynNode<'b> for &'a str { impl IntoDynNode<'_> for String { fn into_vnode(self, cx: &ScopeState) -> DynamicNode { DynamicNode::Text(VText { - value: cx.bump().alloc(self), + value: cx.bump().alloc_str(&self), id: Default::default(), }) } From 67670875bba323829dc9f9097700b07dffc66ee8 Mon Sep 17 00:00:00 2001 From: Bunny Bites Date: Tue, 14 Nov 2023 01:13:47 +0530 Subject: [PATCH 262/447] fix parsing issue for desktop platform --- packages/interpreter/src/interpreter.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/interpreter/src/interpreter.js b/packages/interpreter/src/interpreter.js index 2a1841171..7f55c2da3 100644 --- a/packages/interpreter/src/interpreter.js +++ b/packages/interpreter/src/interpreter.js @@ -453,7 +453,7 @@ function handler(event, name, bubbles, config) { const formData = new FormData(target); for (let name of formData.keys()) { - const fieldType = form.elements[name].type; + const fieldType = target.elements[name].type; switch (fieldType) { case "select-multiple": From 62719c309a26e5320b0bc9dde04a9d1689e351e4 Mon Sep 17 00:00:00 2001 From: Alexander Date: Tue, 14 Nov 2023 16:39:37 +0000 Subject: [PATCH 263/447] fix keyboard input on calc example (#1639) --- examples/calculator.rs | 1 + 1 file changed, 1 insertion(+) diff --git a/examples/calculator.rs b/examples/calculator.rs index bc7f13459..648ccfbc3 100644 --- a/examples/calculator.rs +++ b/examples/calculator.rs @@ -62,6 +62,7 @@ fn app(cx: Scope) -> Element { div { id: "wrapper", div { class: "app", div { class: "calculator", + tabindex: "0", onkeydown: handle_key_down_event, div { class: "calculator-display", val.to_string() } div { class: "calculator-keypad", From 20bbf959797f4d6ebdc2e76e2b61ddba2cbfd147 Mon Sep 17 00:00:00 2001 From: ealmloff Date: Tue, 14 Nov 2023 10:45:53 -0600 Subject: [PATCH 264/447] document parsed_values and FormValue --- packages/html/src/events/form.rs | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/packages/html/src/events/form.rs b/packages/html/src/events/form.rs index d48c20370..1f8127f3b 100644 --- a/packages/html/src/events/form.rs +++ b/packages/html/src/events/form.rs @@ -5,9 +5,10 @@ use serde::{Deserialize, Serialize}; pub type FormEvent = Event; +/// A form value that may either be a list of values or a single value #[derive(Serialize, Deserialize, Debug, Clone, PartialEq)] #[serde(untagged)] // this will serialize Text(String) -> String and VecText(Vec) to Vec -pub enum ValueType { +pub enum FormValue { Text(String), VecText(Vec), } @@ -18,7 +19,7 @@ pub enum ValueType { pub struct FormData { pub value: String, - pub values: HashMap, + pub values: HashMap, #[cfg_attr( feature = "serialize", @@ -40,6 +41,7 @@ where } impl FormData { + /// Parse the values into a struct with one field per value pub fn parsed_values(&self) -> Result where T: serde::de::DeserializeOwned, From 4631050a043da826f5e35f841cf326c63a1f9be1 Mon Sep 17 00:00:00 2001 From: ealmloff Date: Tue, 14 Nov 2023 10:52:39 -0600 Subject: [PATCH 265/447] fix FormValue --- packages/rink/src/hooks.rs | 4 ++-- packages/web/src/dom.rs | 6 +++--- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/packages/rink/src/hooks.rs b/packages/rink/src/hooks.rs index 8842ffe60..109b39dd7 100644 --- a/packages/rink/src/hooks.rs +++ b/packages/rink/src/hooks.rs @@ -13,7 +13,7 @@ use dioxus_html::geometry::{ use dioxus_html::input_data::keyboard_types::{Code, Key, Location, Modifiers}; use dioxus_html::input_data::MouseButtonSet as DioxusMouseButtons; use dioxus_html::input_data::{MouseButton as DioxusMouseButton, MouseButtonSet}; -use dioxus_html::{event_bubbles, FocusData, KeyboardData, MouseData, ValueType, WheelData}; +use dioxus_html::{event_bubbles, FocusData, KeyboardData, MouseData, FormValue, WheelData}; use std::any::Any; use std::collections::HashMap; use std::{ @@ -61,7 +61,7 @@ impl EventData { pub struct FormData { pub value: String, - pub values: HashMap, + pub values: HashMap, pub files: Option, } diff --git a/packages/web/src/dom.rs b/packages/web/src/dom.rs index 3188e0935..1f3cecb0f 100644 --- a/packages/web/src/dom.rs +++ b/packages/web/src/dom.rs @@ -10,7 +10,7 @@ use dioxus_core::{ BorrowedAttributeValue, ElementId, Mutation, Template, TemplateAttribute, TemplateNode, }; -use dioxus_html::{event_bubbles, CompositionData, FormData, MountedData, ValueType}; +use dioxus_html::{event_bubbles, CompositionData, FormData, MountedData, FormValue}; use dioxus_interpreter_js::{get_node, minimal_bindings, save_template, Channel}; use futures_channel::mpsc; use js_sys::Array; @@ -377,9 +377,9 @@ fn read_input_to_data(target: Element) -> Rc { let item_values: Vec = item_values.iter().filter_map(|v| v.as_string()).collect(); - values.insert(name, ValueType::VecText(item_values)); + values.insert(name, FormValue::VecText(item_values)); } else if let Ok(item_value) = array.get(1).dyn_into::() { - values.insert(name, ValueType::Text(item_value.as_string().unwrap())); + values.insert(name, FormValue::Text(item_value.as_string().unwrap())); } } } From cf77325f678f1a598b5a2642cd71535f7b3d487a Mon Sep 17 00:00:00 2001 From: Bunny Bites Date: Tue, 14 Nov 2023 23:27:50 +0530 Subject: [PATCH 266/447] fix code format issues (pipeline) --- packages/rink/src/hooks.rs | 2 +- packages/web/src/dom.rs | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/packages/rink/src/hooks.rs b/packages/rink/src/hooks.rs index 109b39dd7..96d6c9f62 100644 --- a/packages/rink/src/hooks.rs +++ b/packages/rink/src/hooks.rs @@ -13,7 +13,7 @@ use dioxus_html::geometry::{ use dioxus_html::input_data::keyboard_types::{Code, Key, Location, Modifiers}; use dioxus_html::input_data::MouseButtonSet as DioxusMouseButtons; use dioxus_html::input_data::{MouseButton as DioxusMouseButton, MouseButtonSet}; -use dioxus_html::{event_bubbles, FocusData, KeyboardData, MouseData, FormValue, WheelData}; +use dioxus_html::{event_bubbles, FocusData, FormValue, KeyboardData, MouseData, WheelData}; use std::any::Any; use std::collections::HashMap; use std::{ diff --git a/packages/web/src/dom.rs b/packages/web/src/dom.rs index 1f3cecb0f..d9fec9203 100644 --- a/packages/web/src/dom.rs +++ b/packages/web/src/dom.rs @@ -10,7 +10,7 @@ use dioxus_core::{ BorrowedAttributeValue, ElementId, Mutation, Template, TemplateAttribute, TemplateNode, }; -use dioxus_html::{event_bubbles, CompositionData, FormData, MountedData, FormValue}; +use dioxus_html::{event_bubbles, CompositionData, FormData, FormValue, MountedData}; use dioxus_interpreter_js::{get_node, minimal_bindings, save_template, Channel}; use futures_channel::mpsc; use js_sys::Array; From 098689083d9961640ac2da7f2a4c12c58a80ed07 Mon Sep 17 00:00:00 2001 From: Raman Hafiyatulin Date: Wed, 15 Nov 2023 23:14:16 +0200 Subject: [PATCH 267/447] Related to #1547: use `dioxus-cli` within a workspace (wildcard-members, real package names) (#1642) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Related to #1547: use `dioxus-cli` within a workspace Although the `dx` CLI allows to specify a package name to chose from workspace members, it does not support workspace members specified as glob-wildcards. Neither it respects the effective package name, specified in the crate's `Cargo.toml`. This PR addresses that issue: - upon `dx build ...`, if the `--bin` CLI-argument is provided, treat the current dir as a workspace; - search through the workspace's `members`: resolve each of them with `glob`; - assume that any workspace member has a `Cargo.toml` in it (cargo does it, so it's okay); - read said manifest, and check the package name in it; - if found β€”Β there we have our sought package. * Use cargo-metadata to find out the workspace structure * glob is unused --- packages/cli/src/error.rs | 3 ++ packages/cli/src/main.rs | 67 ++++++++++++++++----------------------- 2 files changed, 31 insertions(+), 39 deletions(-) diff --git a/packages/cli/src/error.rs b/packages/cli/src/error.rs index 84b9d4b71..d577b2b40 100644 --- a/packages/cli/src/error.rs +++ b/packages/cli/src/error.rs @@ -29,6 +29,9 @@ pub enum Error { #[error("Cargo Error: {0}")] CargoError(String), + #[error("Couldn't retrieve cargo metadata")] + CargoMetadata(#[source] cargo_metadata::Error), + #[error("{0}")] CustomError(String), diff --git a/packages/cli/src/main.rs b/packages/cli/src/main.rs index fe860a0e6..7ca1b2c9a 100644 --- a/packages/cli/src/main.rs +++ b/packages/cli/src/main.rs @@ -9,42 +9,31 @@ use dioxus_cli::plugin::PluginManager; use Commands::*; -fn get_bin(bin: Option) -> Result> { - const ERR_MESSAGE: &str = "The `--bin` flag has to be ran in a Cargo workspace."; +fn get_bin(bin: Option) -> Result { + let metadata = cargo_metadata::MetadataCommand::new() + .exec() + .map_err(Error::CargoMetadata)?; + let package = if let Some(bin) = bin { + metadata + .workspace_packages() + .into_iter() + .find(|p| p.name == bin) + .ok_or(format!("no such package: {}", bin)) + .map_err(Error::CargoError)? + } else { + metadata + .root_package() + .ok_or("no root package?".into()) + .map_err(Error::CargoError)? + }; - if let Some(ref bin) = bin { - let manifest = cargo_toml::Manifest::from_path("./Cargo.toml") - .map_err(|_| Error::CargoError(ERR_MESSAGE.to_string()))?; + let crate_dir = package + .manifest_path + .parent() + .ok_or("couldn't take parent dir".into()) + .map_err(Error::CargoError)?; - if let Some(workspace) = manifest.workspace { - for item in workspace.members.iter() { - let path = PathBuf::from(item); - - if !path.exists() { - continue; - } - - if !path.is_dir() { - continue; - } - - if path.ends_with(bin.clone()) { - return Ok(Some(path)); - } - } - } else { - return Err(Error::CargoError(ERR_MESSAGE.to_string())); - } - } - - // If the bin exists but we couldn't find it - if bin.is_some() { - return Err(Error::CargoError( - "The specified bin does not exist.".to_string(), - )); - } - - Ok(None) + Ok(crate_dir.into()) } #[tokio::main] @@ -55,7 +44,7 @@ async fn main() -> anyhow::Result<()> { let bin = get_bin(args.bin)?; - let _dioxus_config = DioxusConfig::load(bin.clone()) + let _dioxus_config = DioxusConfig::load(Some(bin.clone())) .map_err(|e| anyhow!("Failed to load Dioxus config because: {e}"))? .unwrap_or_else(|| { log::warn!("You appear to be creating a Dioxus project from scratch; we will use the default config"); @@ -72,15 +61,15 @@ async fn main() -> anyhow::Result<()> { .map_err(|e| anyhow!("🚫 Translation of HTML into RSX failed: {}", e)), Build(opts) => opts - .build(bin.clone()) + .build(Some(bin.clone())) .map_err(|e| anyhow!("🚫 Building project failed: {}", e)), Clean(opts) => opts - .clean(bin.clone()) + .clean(Some(bin.clone())) .map_err(|e| anyhow!("🚫 Cleaning project failed: {}", e)), Serve(opts) => opts - .serve(bin.clone()) + .serve(Some(bin.clone())) .await .map_err(|e| anyhow!("🚫 Serving project failed: {}", e)), @@ -93,7 +82,7 @@ async fn main() -> anyhow::Result<()> { .map_err(|e| anyhow!("🚫 Configuring new project failed: {}", e)), Bundle(opts) => opts - .bundle(bin.clone()) + .bundle(Some(bin.clone())) .map_err(|e| anyhow!("🚫 Bundling project failed: {}", e)), #[cfg(feature = "plugin")] From 83f7ef9a447547c720e310b10e1682dc7762bdbc Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Sun, 19 Nov 2023 09:58:00 -0600 Subject: [PATCH 268/447] add an optional cleanup closure to the use effect hook --- examples/readme.rs | 6 +++ packages/hooks/src/use_effect.rs | 79 ++++++++++++++++++++++++++++---- 2 files changed, 76 insertions(+), 9 deletions(-) diff --git a/examples/readme.rs b/examples/readme.rs index f4668488b..b39c04765 100644 --- a/examples/readme.rs +++ b/examples/readme.rs @@ -11,6 +11,12 @@ fn main() { fn app(cx: Scope) -> Element { let mut count = use_state(cx, || 0); + use_effect(cx, (), move |()| async {}); + + use_effect(cx, (count.get(),), move |(count,)| async move { + move || println!("Count unmounted from {}", count) + }); + cx.render(rsx! { h1 { "High-Five counter: {count}" } button { onclick: move |_| count += 1, "Up high!" } diff --git a/packages/hooks/src/use_effect.rs b/packages/hooks/src/use_effect.rs index e72afe27f..1f5faecdd 100644 --- a/packages/hooks/src/use_effect.rs +++ b/packages/hooks/src/use_effect.rs @@ -1,5 +1,10 @@ use dioxus_core::{ScopeState, TaskId}; -use std::{any::Any, cell::Cell, future::Future}; +use std::{ + any::Any, + cell::{Cell, RefCell}, + future::Future, + rc::Rc, +}; use crate::UseFutureDep; @@ -14,7 +19,7 @@ use crate::UseFutureDep; /// ## Arguments /// /// - `dependencies`: a tuple of references to values that are `PartialEq` + `Clone`. -/// - `future`: a closure that takes the `dependencies` as arguments and returns a `'static` future. +/// - `future`: a closure that takes the `dependencies` as arguments and returns a `'static` future. That future may return nothing or a closure that will be executed when the dependencies change to clean up the effect. /// /// ## Examples /// @@ -33,6 +38,16 @@ use crate::UseFutureDep; /// } /// }); /// +/// // Only fetch the user data when the id changes. +/// use_effect(cx, (id,), |(id,)| { +/// to_owned![name]; +/// async move { +/// let user = fetch_user(id).await; +/// name.set(user.name); +/// move || println!("Cleaning up from {}", id); +/// } +/// }); +/// /// let name = name.get().clone().unwrap_or("Loading...".to_string()); /// /// render!( @@ -45,34 +60,80 @@ use crate::UseFutureDep; /// render!(Profile { id: 0 }) /// } /// ``` -pub fn use_effect(cx: &ScopeState, dependencies: D, future: impl FnOnce(D::Out) -> F) +pub fn use_effect(cx: &ScopeState, dependencies: D, future: impl FnOnce(D::Out) -> R) where - T: 'static, - F: Future + 'static, D: UseFutureDep, + R: UseEffectReturn, { struct UseEffect { needs_regen: bool, task: Cell>, dependencies: Vec>, + cleanup: UseEffectCleanup, + } + + impl Drop for UseEffect { + fn drop(&mut self) { + if let Some(cleanup) = self.cleanup.borrow_mut().take() { + cleanup(); + } + } } let state = cx.use_hook(move || UseEffect { needs_regen: true, task: Cell::new(None), dependencies: Vec::new(), + cleanup: Rc::new(RefCell::new(None)), }); if dependencies.clone().apply(&mut state.dependencies) || state.needs_regen { + // Call the cleanup function if it exists + if let Some(cleanup) = state.cleanup.borrow_mut().take() { + cleanup(); + } + // We don't need regen anymore state.needs_regen = false; // Create the new future - let fut = future(dependencies.out()); + let return_value = future(dependencies.out()); - state.task.set(Some(cx.push_future(async move { - fut.await; - }))); + if let Some(task) = return_value.apply(state.cleanup.clone(), cx) { + state.task.set(Some(task)); + } + } +} + +type UseEffectCleanup = Rc>>>; + +/// Something that can be returned from a `use_effect` hook. +pub trait UseEffectReturn { + fn apply(self, oncleanup: UseEffectCleanup, cx: &ScopeState) -> Option; +} + +impl UseEffectReturn<()> for T +where + T: Future + 'static, +{ + fn apply(self, _: UseEffectCleanup, cx: &ScopeState) -> Option { + Some(cx.push_future(self)) + } +} + +#[doc(hidden)] +pub struct CleanupFutureMarker; +impl UseEffectReturn for T +where + T: Future + 'static, + F: FnOnce() + 'static, +{ + fn apply(self, oncleanup: UseEffectCleanup, cx: &ScopeState) -> Option { + let task = cx.push_future(async move { + let cleanup = self.await; + *oncleanup.borrow_mut() = Some(Box::new(cleanup) as Box); + }); + Some(task) } } From 3c115bbef76f21435d8db886a799a47503026e5f Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Sun, 19 Nov 2023 10:03:18 -0600 Subject: [PATCH 269/447] add into attribute value impl for String --- packages/core/src/nodes.rs | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/packages/core/src/nodes.rs b/packages/core/src/nodes.rs index c83b1059a..b489a7e4d 100644 --- a/packages/core/src/nodes.rs +++ b/packages/core/src/nodes.rs @@ -791,6 +791,12 @@ impl<'a> IntoAttributeValue<'a> for &'a str { } } +impl<'a> IntoAttributeValue<'a> for String { + fn into_value(self, cx: &'a Bump) -> AttributeValue<'a> { + AttributeValue::Text(cx.alloc_str(&self)) + } +} + impl<'a> IntoAttributeValue<'a> for f64 { fn into_value(self, _: &'a Bump) -> AttributeValue<'a> { AttributeValue::Float(self) From ff6c7efb41ef16bea467bfad164b33a2fb20219e Mon Sep 17 00:00:00 2001 From: "HJin.me" Date: Mon, 20 Nov 2023 01:22:54 +0800 Subject: [PATCH 270/447] fix: tailwind.css use absolute path (#1649) --- packages/cli/src/builder.rs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/cli/src/builder.rs b/packages/cli/src/builder.rs index c85cdc484..71be8f115 100644 --- a/packages/cli/src/builder.rs +++ b/packages/cli/src/builder.rs @@ -469,7 +469,7 @@ pub fn gen_page(config: &DioxusConfig, serve: bool) -> String { .unwrap_or_default() .contains_key("tailwindcss") { - style_str.push_str("\n"); + style_str.push_str("\n"); } replace_or_insert_before("{style_include}", &style_str, " Date: Mon, 20 Nov 2023 22:24:16 +0800 Subject: [PATCH 271/447] Fix grammar typo in comment (#1652) --- packages/fullstack/src/router.rs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/fullstack/src/router.rs b/packages/fullstack/src/router.rs index b556aa000..b8d93f0e0 100644 --- a/packages/fullstack/src/router.rs +++ b/packages/fullstack/src/router.rs @@ -53,7 +53,7 @@ fn default_external_navigation_handler() -> fn(Scope) -> Element { dioxus_router::prelude::FailureExternalNavigation } -/// The configeration for the router +/// The configuration for the router #[derive(Props, serde::Serialize, serde::Deserialize)] pub struct FullstackRouterConfig where From 0ee21dff1e962bb5e1c22cfde15ecb4bc07c49fb Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Mon, 20 Nov 2023 09:33:39 -0600 Subject: [PATCH 272/447] fix missing item in hot reloading diffing --- packages/cli/src/logging.rs | 14 +++++- packages/cli/src/server/output.rs | 25 ++++++----- packages/rsx/Cargo.toml | 1 + .../rsx/src/hot_reload/hot_reload_diff.rs | 44 ++++++++++++++++--- .../src/hot_reload/hot_reloading_file_map.rs | 27 +++++++++--- 5 files changed, 87 insertions(+), 24 deletions(-) diff --git a/packages/cli/src/logging.rs b/packages/cli/src/logging.rs index 48c2a2788..31d088737 100644 --- a/packages/cli/src/logging.rs +++ b/packages/cli/src/logging.rs @@ -28,7 +28,19 @@ pub fn set_up_logging() { message = message, )); }) - .level(log::LevelFilter::Info) + .level(match std::env::var("DIOXUS_LOG") { + Ok(level) => match level.to_lowercase().as_str() { + "error" => log::LevelFilter::Error, + "warn" => log::LevelFilter::Warn, + "info" => log::LevelFilter::Info, + "debug" => log::LevelFilter::Debug, + "trace" => log::LevelFilter::Trace, + _ => { + panic!("Invalid log level: {}", level) + } + }, + Err(_) => log::LevelFilter::Info, + }) .chain(std::io::stdout()) .apply() .unwrap(); diff --git a/packages/cli/src/server/output.rs b/packages/cli/src/server/output.rs index 71323dd29..4e148b0f1 100644 --- a/packages/cli/src/server/output.rs +++ b/packages/cli/src/server/output.rs @@ -22,17 +22,20 @@ pub fn print_console_info( options: PrettierOptions, web_info: Option, ) { - if let Ok(native_clearseq) = Command::new(if cfg!(target_os = "windows") { - "cls" - } else { - "clear" - }) - .output() - { - print!("{}", String::from_utf8_lossy(&native_clearseq.stdout)); - } else { - // Try ANSI-Escape characters - print!("\x1b[2J\x1b[H"); + // Don't clear the screen if the user has set the DIOXUS_LOG environment variable to "trace" so that we can see the logs + if Some("trace") != std::env::var("DIOXUS_LOG").ok().as_deref() { + if let Ok(native_clearseq) = Command::new(if cfg!(target_os = "windows") { + "cls" + } else { + "clear" + }) + .output() + { + print!("{}", String::from_utf8_lossy(&native_clearseq.stdout)); + } else { + // Try ANSI-Escape characters + print!("\x1b[2J\x1b[H"); + } } let mut profile = if config.release { "Release" } else { "Debug" }.to_string(); diff --git a/packages/rsx/Cargo.toml b/packages/rsx/Cargo.toml index bc866acb7..72b51a051 100644 --- a/packages/rsx/Cargo.toml +++ b/packages/rsx/Cargo.toml @@ -20,6 +20,7 @@ quote = { version = "1.0" } serde = { version = "1.0", features = ["derive"], optional = true } internment = { version = "0.7.0", optional = true } krates = { version = "0.12.6", optional = true } +tracing.workspace = true [features] hot_reload = ["krates", "internment"] diff --git a/packages/rsx/src/hot_reload/hot_reload_diff.rs b/packages/rsx/src/hot_reload/hot_reload_diff.rs index 22a01875d..7e19d3aad 100644 --- a/packages/rsx/src/hot_reload/hot_reload_diff.rs +++ b/packages/rsx/src/hot_reload/hot_reload_diff.rs @@ -1,4 +1,5 @@ use proc_macro2::TokenStream; +use quote::ToTokens; use syn::{File, Macro}; pub enum DiffResult { @@ -10,13 +11,30 @@ pub enum DiffResult { pub fn find_rsx(new: &File, old: &File) -> DiffResult { let mut rsx_calls = Vec::new(); if new.items.len() != old.items.len() { + tracing::trace!( + "found not hot reload-able change {:#?} != {:#?}", + new.items + .iter() + .map(|i| i.to_token_stream().to_string()) + .collect::>(), + old.items + .iter() + .map(|i| i.to_token_stream().to_string()) + .collect::>() + ); return DiffResult::CodeChanged; } for (new, old) in new.items.iter().zip(old.items.iter()) { if find_rsx_item(new, old, &mut rsx_calls) { + tracing::trace!( + "found not hot reload-able change {:#?} != {:#?}", + new.to_token_stream().to_string(), + old.to_token_stream().to_string() + ); return DiffResult::CodeChanged; } } + tracing::trace!("found hot reload-able changes {:#?}", rsx_calls); DiffResult::RsxChanged(rsx_calls) } @@ -94,6 +112,9 @@ fn find_rsx_item( (syn::ImplItem::Macro(new_item), syn::ImplItem::Macro(old_item)) => { old_item != new_item } + (syn::ImplItem::Verbatim(stream), syn::ImplItem::Verbatim(stream2)) => { + stream.to_string() != stream2.to_string() + } _ => true, } { return true; @@ -186,10 +207,12 @@ fn find_rsx_trait( } } (syn::TraitItem::Fn(new_item), syn::TraitItem::Fn(old_item)) => { - if let (Some(new_block), Some(old_block)) = (&new_item.default, &old_item.default) { - find_rsx_block(new_block, old_block, rsx_calls) - } else { - true + match (&new_item.default, &old_item.default) { + (Some(new_block), Some(old_block)) => { + find_rsx_block(new_block, old_block, rsx_calls) + } + (None, None) => false, + _ => true, } } (syn::TraitItem::Type(new_item), syn::TraitItem::Type(old_item)) => { @@ -198,6 +221,9 @@ fn find_rsx_trait( (syn::TraitItem::Macro(new_item), syn::TraitItem::Macro(old_item)) => { old_item != new_item } + (syn::TraitItem::Verbatim(stream), syn::TraitItem::Verbatim(stream2)) => { + stream.to_string() != stream2.to_string() + } _ => true, } { return true; @@ -355,6 +381,11 @@ fn find_rsx_expr( || new_expr.or2_token != old_expr.or2_token || new_expr.output != old_expr.output } + (syn::Expr::Const(new_expr), syn::Expr::Const(old_expr)) => { + find_rsx_block(&new_expr.block, &old_expr.block, rsx_calls) + || new_expr.attrs != old_expr.attrs + || new_expr.const_token != old_expr.const_token + } (syn::Expr::Continue(new_expr), syn::Expr::Continue(old_expr)) => old_expr != new_expr, (syn::Expr::Field(new_expr), syn::Expr::Field(old_expr)) => { find_rsx_expr(&new_expr.base, &old_expr.base, rsx_calls) @@ -402,6 +433,7 @@ fn find_rsx_expr( || new_expr.attrs != old_expr.attrs || new_expr.bracket_token != old_expr.bracket_token } + (syn::Expr::Infer(new_expr), syn::Expr::Infer(old_expr)) => new_expr != old_expr, (syn::Expr::Let(new_expr), syn::Expr::Let(old_expr)) => { find_rsx_expr(&new_expr.expr, &old_expr.expr, rsx_calls) || new_expr.attrs != old_expr.attrs @@ -589,7 +621,9 @@ fn find_rsx_expr( _ => true, } } - (syn::Expr::Verbatim(_), syn::Expr::Verbatim(_)) => false, + (syn::Expr::Verbatim(stream), syn::Expr::Verbatim(stream2)) => { + stream.to_string() != stream2.to_string() + } _ => true, } } diff --git a/packages/rsx/src/hot_reload/hot_reloading_file_map.rs b/packages/rsx/src/hot_reload/hot_reloading_file_map.rs index 0393142b4..7e36dddf9 100644 --- a/packages/rsx/src/hot_reload/hot_reloading_file_map.rs +++ b/packages/rsx/src/hot_reload/hot_reloading_file_map.rs @@ -51,17 +51,24 @@ impl FileMap { fn find_rs_files( root: PathBuf, filter: &mut impl FnMut(&Path) -> bool, - ) -> io::Result { + ) -> FileMapSearchResult { let mut files = HashMap::new(); let mut errors = Vec::new(); if root.is_dir() { - for entry in (fs::read_dir(root)?).flatten() { + let read_dir = match fs::read_dir(root) { + Ok(read_dir) => read_dir, + Err(err) => { + errors.push(err); + return FileMapSearchResult { map: files, errors }; + } + }; + for entry in read_dir.flatten() { let path = entry.path(); if !filter(&path) { let FileMapSearchResult { map, errors: child_errors, - } = find_rs_files(path, filter)?; + } = find_rs_files(path, filter); errors.extend(child_errors); files.extend(map); } @@ -69,14 +76,20 @@ impl FileMap { } else if root.extension().and_then(|s| s.to_str()) == Some("rs") { if let Ok(mut file) = File::open(root.clone()) { let mut src = String::new(); - file.read_to_string(&mut src)?; - files.insert(root, (src, None)); + match file.read_to_string(&mut src) { + Ok(_) => { + files.insert(root, (src, None)); + } + Err(err) => { + errors.push(err); + } + } } } - Ok(FileMapSearchResult { map: files, errors }) + FileMapSearchResult { map: files, errors } } - let FileMapSearchResult { map, errors } = find_rs_files(path, &mut filter)?; + let FileMapSearchResult { map, errors } = find_rs_files(path, &mut filter); let result = Self { map, in_workspace: HashMap::new(), From 8cf8f66c272e0bc13942d7fa01c1adfae3d2155d Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Mon, 20 Nov 2023 09:47:03 -0600 Subject: [PATCH 273/447] add more logging to desktop hot reloading --- packages/cli/src/server/desktop/mod.rs | 3 +++ 1 file changed, 3 insertions(+) diff --git a/packages/cli/src/server/desktop/mod.rs b/packages/cli/src/server/desktop/mod.rs index 978b97d43..be722323b 100644 --- a/packages/cli/src/server/desktop/mod.rs +++ b/packages/cli/src/server/desktop/mod.rs @@ -73,6 +73,7 @@ pub async fn serve(config: CrateConfig, hot_reload_state: Option move || { let mut current_child = currently_running_child.write().unwrap(); + log::trace!("Killing old process"); current_child.kill()?; let (child, result) = start_desktop(&config)?; *current_child = child; @@ -212,6 +213,7 @@ fn send_msg(msg: HotReloadMsg, channel: &mut impl std::io::Write) -> bool { pub fn start_desktop(config: &CrateConfig) -> Result<(Child, BuildResult)> { // Run the desktop application + log::trace!("Building application"); let result = crate::builder::build_desktop(config, true)?; match &config.executable { @@ -222,6 +224,7 @@ pub fn start_desktop(config: &CrateConfig) -> Result<(Child, BuildResult)> { if cfg!(windows) { file.set_extension("exe"); } + log::trace!("Running application from {:?}", file); let child = Command::new(file.to_str().unwrap()).spawn()?; Ok((child, result)) From f8ce72c6054701f03786bf55df1bba1a82471884 Mon Sep 17 00:00:00 2001 From: Exotik850 <60969639+Exotik850@users.noreply.github.com> Date: Mon, 20 Nov 2023 09:49:18 -0600 Subject: [PATCH 274/447] Fix outdated lazynode documentation (#1648) * Fix outdated lazynode documentation * Use expanded rsx! instead of just rsx macro --- packages/core/src/lazynodes.rs | 33 +++++++++++++++++++++++++++++++-- 1 file changed, 31 insertions(+), 2 deletions(-) diff --git a/packages/core/src/lazynodes.rs b/packages/core/src/lazynodes.rs index 811dbb734..3189086b4 100644 --- a/packages/core/src/lazynodes.rs +++ b/packages/core/src/lazynodes.rs @@ -23,8 +23,37 @@ use crate::{innerlude::VNode, ScopeState}; /// /// /// ```rust, ignore -/// LazyNodes::new(|f| f.element("div", [], [], [] None)) +/// LazyNodes::new(|f| { +/// static TEMPLATE: dioxus::core::Template = dioxus::core::Template { +/// name: "main.rs:5:5:20", // Source location of the template for hot reloading +/// roots: &[ +/// dioxus::core::TemplateNode::Element { +/// tag: dioxus_elements::div::TAG_NAME, +/// namespace: dioxus_elements::div::NAME_SPACE, +/// attrs: &[], +/// children: &[], +/// }, +/// ], +/// node_paths: &[], +/// attr_paths: &[], +/// }; +/// dioxus::core::VNode { +/// parent: None, +/// key: None, +/// template: std::cell::Cell::new(TEMPLATE), +/// root_ids: dioxus::core::exports::bumpalo::collections::Vec::with_capacity_in( +/// 1usize, +/// f.bump(), +/// ) +/// .into(), +/// dynamic_nodes: f.bump().alloc([]), +/// dynamic_attrs: f.bump().alloc([]), +/// }) +/// } /// ``` +/// +/// Find more information about how to construct [`VNode`] at + pub struct LazyNodes<'a, 'b> { #[cfg(not(miri))] inner: SmallBox VNode<'a> + 'b, S16>, @@ -61,7 +90,7 @@ impl<'a, 'b> LazyNodes<'a, 'b> { /// Call the closure with the given factory to produce real [`VNode`]. /// /// ```rust, ignore - /// let f = LazyNodes::new(move |f| f.element("div", [], [], [] None)); + /// let f = LazyNodes::new(/* Closure for creating VNodes */); /// /// let node = f.call(cac); /// ``` From 7a459e15d8316abfdb5b39d25deb4fff9318fbfe Mon Sep 17 00:00:00 2001 From: ealmloff Date: Tue, 21 Nov 2023 16:28:06 -0600 Subject: [PATCH 275/447] Update packages/hooks/src/use_effect.rs MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Marc EspΓ­n --- packages/hooks/src/use_effect.rs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/hooks/src/use_effect.rs b/packages/hooks/src/use_effect.rs index 1f5faecdd..6fb2fcf9e 100644 --- a/packages/hooks/src/use_effect.rs +++ b/packages/hooks/src/use_effect.rs @@ -44,7 +44,7 @@ use crate::UseFutureDep; /// async move { /// let user = fetch_user(id).await; /// name.set(user.name); -/// move || println!("Cleaning up from {}", id); +/// move || println!("Cleaning up from {}", id) /// } /// }); /// From 017d7e96bf1ed70463f01d3fb9dc52824179269e Mon Sep 17 00:00:00 2001 From: ealmloff Date: Tue, 21 Nov 2023 16:28:31 -0600 Subject: [PATCH 276/447] restore readme.rs --- examples/readme.rs | 6 ------ 1 file changed, 6 deletions(-) diff --git a/examples/readme.rs b/examples/readme.rs index b39c04765..f4668488b 100644 --- a/examples/readme.rs +++ b/examples/readme.rs @@ -11,12 +11,6 @@ fn main() { fn app(cx: Scope) -> Element { let mut count = use_state(cx, || 0); - use_effect(cx, (), move |()| async {}); - - use_effect(cx, (count.get(),), move |(count,)| async move { - move || println!("Count unmounted from {}", count) - }); - cx.render(rsx! { h1 { "High-Five counter: {count}" } button { onclick: move |_| count += 1, "Up high!" } From d9220d4e42b86114096a639ba0b308062b6d763a Mon Sep 17 00:00:00 2001 From: tigerros Date: Thu, 23 Nov 2023 23:44:39 +0100 Subject: [PATCH 277/447] Add it (#1660) --- packages/html/src/global_attributes.rs | 3 +++ 1 file changed, 3 insertions(+) diff --git a/packages/html/src/global_attributes.rs b/packages/html/src/global_attributes.rs index 3792397ad..02b0b32ed 100644 --- a/packages/html/src/global_attributes.rs +++ b/packages/html/src/global_attributes.rs @@ -269,6 +269,9 @@ trait_methods! { /// azimuth: "azimuth", "style"; + /// + backdrop_filter: "backdrop-filter", "style"; + /// backface_visibility: "backface-visibility", "style"; From 1c0b33cef44678beab17bbcccaeabff48f3c2027 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Sun, 26 Nov 2023 09:21:27 -0600 Subject: [PATCH 278/447] fix hot reloading svg elements --- packages/hot-reload/src/file_watcher.rs | 2 +- packages/html/src/elements.rs | 53 +++++++++++++++++++++++-- 2 files changed, 50 insertions(+), 5 deletions(-) diff --git a/packages/hot-reload/src/file_watcher.rs b/packages/hot-reload/src/file_watcher.rs index 2509dd789..5b8b76b37 100644 --- a/packages/hot-reload/src/file_watcher.rs +++ b/packages/hot-reload/src/file_watcher.rs @@ -122,7 +122,7 @@ pub fn init(cfg: Config) { } = cfg; if let Ok(crate_dir) = PathBuf::from_str(root_path) { - // try to find the gitingore file + // try to find the gitignore file let gitignore_file_path = crate_dir.join(".gitignore"); let (gitignore, _) = ignore::gitignore::Gitignore::new(gitignore_file_path); diff --git a/packages/html/src/elements.rs b/packages/html/src/elements.rs index 6a0e546fa..5e0d0995d 100644 --- a/packages/html/src/elements.rs +++ b/packages/html/src/elements.rs @@ -74,7 +74,7 @@ macro_rules! impl_attribute_match { $attr:ident $fil:ident: $vil:ident (in $ns:literal), ) => { if $attr == stringify!($fil) { - return Some((stringify!(fil), Some(ns))); + return Some((stringify!(fil), Some($ns))); } }; } @@ -180,14 +180,26 @@ macro_rules! impl_element_match { }; ( - $el:ident $name:ident $namespace:tt { + $el:ident $name:ident $namespace:literal { $( $fil:ident: $vil:ident $extra:tt, )* } ) => { if $el == stringify!($name) { - return Some((stringify!($name), Some(stringify!($namespace)))); + return dbg!(Some((stringify!($name), Some($namespace)))); + } + }; + + ( + $el:ident $name:ident [$_:literal, $namespace:tt] { + $( + $fil:ident: $vil:ident $extra:tt, + )* + } + ) => { + if $el == stringify!($name) { + return dbg!(Some((stringify!($name), Some($namespace)))); } }; } @@ -207,6 +219,8 @@ macro_rules! impl_element_match_attributes { $attr $fil: $vil ($extra), ); )* + + return impl_map_global_attributes!($el $attr $name None); } }; @@ -223,10 +237,41 @@ macro_rules! impl_element_match_attributes { $attr $fil: $vil ($extra), ); )* + + return impl_map_global_attributes!($el $attr $name $namespace); } } } +#[cfg(feature = "hot-reload-context")] +macro_rules! impl_map_global_attributes { + ( + $el:ident $attr:ident $element:ident None + ) => { + map_global_attributes($attr) + }; + + ( + $el:ident $attr:ident $element:ident $namespace:literal + ) => { + if $namespace == "http://www.w3.org/2000/svg" { + map_svg_attributes($attr) + } else { + map_global_attributes($attr) + } + }; + + ( + $el:ident $attr:ident $element:ident [$name:literal, $namespace:tt] + ) => { + if $namespace == "http://www.w3.org/2000/svg" { + map_svg_attributes($attr) + } else { + map_global_attributes($attr) + } + }; +} + macro_rules! builder_constructors { ( $( @@ -254,7 +299,7 @@ macro_rules! builder_constructors { } ); )* - map_global_attributes(attribute).or_else(|| map_svg_attributes(attribute)) + None } fn map_element(element: &str) -> Option<(&'static str, Option<&'static str>)> { From 141554a7861f8c589f246a611f10c332f4e8a711 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Sun, 26 Nov 2023 09:23:27 -0600 Subject: [PATCH 279/447] remove logging --- packages/html/src/elements.rs | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/packages/html/src/elements.rs b/packages/html/src/elements.rs index 5e0d0995d..d7db36a04 100644 --- a/packages/html/src/elements.rs +++ b/packages/html/src/elements.rs @@ -187,7 +187,7 @@ macro_rules! impl_element_match { } ) => { if $el == stringify!($name) { - return dbg!(Some((stringify!($name), Some($namespace)))); + return Some((stringify!($name), Some($namespace))); } }; @@ -199,7 +199,7 @@ macro_rules! impl_element_match { } ) => { if $el == stringify!($name) { - return dbg!(Some((stringify!($name), Some($namespace)))); + return Some((stringify!($name), Some($namespace))); } }; } From 18fa1e4831b372ec1cba805de8a1df8626801cd6 Mon Sep 17 00:00:00 2001 From: Exotik850 <60969639+Exotik850@users.noreply.github.com> Date: Mon, 27 Nov 2023 15:42:48 -0600 Subject: [PATCH 280/447] Make UseFuture Clone, factor out dependencies field (#1666) --- packages/hooks/src/use_future.rs | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/packages/hooks/src/use_future.rs b/packages/hooks/src/use_future.rs index 67bcdc74e..b9aa20c31 100644 --- a/packages/hooks/src/use_future.rs +++ b/packages/hooks/src/use_future.rs @@ -31,13 +31,14 @@ where let state = cx.use_hook(move || UseFuture { update: cx.schedule_update(), - needs_regen: Cell::new(true), + needs_regen: Rc::new(Cell::new(true)), state: val.clone(), task: Default::default(), - dependencies: Vec::new(), }); - if dependencies.clone().apply(&mut state.dependencies) || state.needs_regen.get() { + let state_dependencies = cx.use_hook(Vec::new); + + if dependencies.clone().apply(state_dependencies) || state.needs_regen.get() { // kill the old one, if it exists if let Some(task) = state.task.take() { cx.remove_future(task); @@ -69,11 +70,11 @@ pub enum FutureState<'a, T> { Regenerating(&'a T), // the old value } +#[derive(Clone)] pub struct UseFuture { update: Arc, - needs_regen: Cell, + needs_regen: Rc>, task: Rc>>, - dependencies: Vec>, state: UseState>, } From 8e4debb22632f1673c7d943f4382b1ca7b6b9fa9 Mon Sep 17 00:00:00 2001 From: Exotik850 <60969639+Exotik850@users.noreply.github.com> Date: Mon, 27 Nov 2023 15:45:29 -0600 Subject: [PATCH 281/447] remove #[doc(hidden)] from EventHandler (#1665) * remove #[doc(hidden)] from EventHandler * Make UseFuture Clone, factor out dependencies field * Revert "Make UseFuture Clone, factor out dependencies field" This reverts commit 9ca09e595d1cda3f2047750a923a5bdc49a8fa76. * fix formatting --------- Co-authored-by: Evan Almloff --- packages/core/src/events.rs | 2 -- 1 file changed, 2 deletions(-) diff --git a/packages/core/src/events.rs b/packages/core/src/events.rs index 3b8edb05c..784a8c865 100644 --- a/packages/core/src/events.rs +++ b/packages/core/src/events.rs @@ -107,8 +107,6 @@ impl std::fmt::Debug for Event { } } -#[doc(hidden)] - /// The callback type generated by the `rsx!` macro when an `on` field is specified for components. /// /// This makes it possible to pass `move |evt| {}` style closures into components as property fields. From b3c7ebfdbab8bd4f88f4db61ecf706492c531a43 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Mon, 27 Nov 2023 16:12:48 -0600 Subject: [PATCH 282/447] fix merged changes --- packages/core/src/scopes.rs | 28 +++++++++++++++------------- 1 file changed, 15 insertions(+), 13 deletions(-) diff --git a/packages/core/src/scopes.rs b/packages/core/src/scopes.rs index 6123efddd..f54e3d5cf 100644 --- a/packages/core/src/scopes.rs +++ b/packages/core/src/scopes.rs @@ -351,20 +351,22 @@ impl<'src> ScopeState { let mut listeners = self.attributes_to_drop_before_render.borrow_mut(); for attr in element.dynamic_attrs { - match attr.value { - // We need to drop listeners before the next render because they may borrow data from the borrowed props which will be dropped - AttributeValue::Listener(_) => { - let unbounded = unsafe { std::mem::transmute(attr as *const Attribute) }; - listeners.push(unbounded); - } - // We need to drop any values manually to make sure that their drop implementation is called before the next render - AttributeValue::Any(_) => { - let unbounded = unsafe { std::mem::transmute(attr as *const Attribute) }; - self.previous_frame().add_attribute_to_drop(unbounded); - } + attr.ty.for_each(|attr| { + match attr.value { + // We need to drop listeners before the next render because they may borrow data from the borrowed props which will be dropped + AttributeValue::Listener(_) => { + let unbounded = unsafe { std::mem::transmute(attr as *const Attribute) }; + listeners.push(unbounded); + } + // We need to drop any values manually to make sure that their drop implementation is called before the next render + AttributeValue::Any(_) => { + let unbounded = unsafe { std::mem::transmute(attr as *const Attribute) }; + self.previous_frame().add_attribute_to_drop(unbounded); + } - _ => (), - } + _ => (), + } + }) } let mut props = self.borrowed_props.borrow_mut(); From 694989e82692e17c1712ddb3e79d6198a73fb3c1 Mon Sep 17 00:00:00 2001 From: Exotik850 <60969639+Exotik850@users.noreply.github.com> Date: Tue, 28 Nov 2023 09:51:09 -0600 Subject: [PATCH 283/447] Add use_const hook (#1667) * Add use_const hook * cargo fmt * clippy allow * pub fn on get_rc --- packages/hooks/src/lib.rs | 3 ++ packages/hooks/src/use_const.rs | 76 +++++++++++++++++++++++++++++++++ 2 files changed, 79 insertions(+) create mode 100644 packages/hooks/src/use_const.rs diff --git a/packages/hooks/src/lib.rs b/packages/hooks/src/lib.rs index a5b92a036..8178d4d3d 100644 --- a/packages/hooks/src/lib.rs +++ b/packages/hooks/src/lib.rs @@ -60,6 +60,9 @@ pub mod computed; mod use_on_destroy; pub use use_on_destroy::*; +mod use_const; +pub use use_const::*; + mod use_context; pub use use_context::*; diff --git a/packages/hooks/src/use_const.rs b/packages/hooks/src/use_const.rs new file mode 100644 index 000000000..47ddb1ed2 --- /dev/null +++ b/packages/hooks/src/use_const.rs @@ -0,0 +1,76 @@ +use std::rc::Rc; + +use dioxus_core::prelude::*; + +/// Store constant state between component renders. +/// +/// UseConst allows you to store state that is initialized once and then remains constant across renders. +/// You can only get an immutable reference after initalization. +/// This can be useful for values that don't need to update reactively, thus can be memoized easily +/// +/// ```rust, ignore +/// struct ComplexData(i32); +/// +/// fn Component(cx: Scope) -> Element { +/// let id = use_const(cx, || ComplexData(100)); +/// +/// cx.render(rsx! { +/// div { "{id.0}" } +/// }) +/// } +/// ``` +#[must_use] +pub fn use_const( + cx: &ScopeState, + initial_state_fn: impl FnOnce() -> T, +) -> &UseConst { + cx.use_hook(|| UseConst { + value: Rc::new(initial_state_fn()), + }) +} + +#[derive(Clone)] +pub struct UseConst { + value: Rc, +} + +impl PartialEq for UseConst { + fn eq(&self, other: &Self) -> bool { + Rc::ptr_eq(&self.value, &other.value) + } +} + +impl core::fmt::Display for UseConst { + fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { + self.value.fmt(f) + } +} + +impl UseConst { + pub fn get_rc(&self) -> &Rc { + &self.value + } +} + +impl std::ops::Deref for UseConst { + type Target = T; + + fn deref(&self) -> &Self::Target { + self.value.as_ref() + } +} + +#[test] +fn use_const_makes_sense() { + #[allow(unused)] + + fn app(cx: Scope) -> Element { + let const_val = use_const(cx, || vec![0, 1, 2, 3]); + + assert!(const_val[0] == 0); + + // const_val.remove(0); // Cannot Compile, cannot get mutable reference now + + None + } +} From b4fe3829d18a8a8d6ce1a293da12e93bd94c76f5 Mon Sep 17 00:00:00 2001 From: Exotik850 <60969639+Exotik850@users.noreply.github.com> Date: Tue, 28 Nov 2023 16:41:14 -0600 Subject: [PATCH 284/447] Add cargo make tidy/miri (#1670) * Add cargo make tidy/miri * fmt * seperate tidy and tests --- Makefile.toml | 74 ++++++++++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 70 insertions(+), 4 deletions(-) diff --git a/Makefile.toml b/Makefile.toml index 6f331b98f..1bfb02217 100644 --- a/Makefile.toml +++ b/Makefile.toml @@ -24,12 +24,64 @@ script = [ ] script_runner = "@duckscript" +[tasks.format] +command = "cargo" +args = ["fmt", "--all"] + +[tasks.check] +command = "cargo" +args = ["check", "--workspace", "--examples", "--tests"] + +[tasks.clippy] +command = "cargo" +args = [ + "clippy", + "--workspace", + "--examples", + "--tests", + "--", + "-D", + "warnings", +] + +[tasks.tidy] +category = "Formatting" +dependencies = ["format", "check", "clippy"] +description = "Format and Check workspace" + +[tasks.install-miri] +toolchain = "nightly" +install_crate = { rustup_component_name = "miri", binary = "cargo +nightly miri", test_arg = "--help" } +private = true + +[tasks.miri-native] +command = "cargo" +toolchain = "nightly" +dependencies = ["install-miri"] +args = [ + "miri", + "test", + "--package", + "dioxus-native-core", + "--test", + "miri_native", +] + +[tasks.miri-stress] +command = "cargo" +toolchain = "nightly" +dependencies = ["install-miri"] +args = ["miri", "test", "--package", "dioxus-core", "--test", "miri_stress"] + +[tasks.miri] +dependencies = ["miri-native", "miri-stress"] + [tasks.tests] category = "Testing" dependencies = ["tests-setup"] description = "Run all tests" -env = {CARGO_MAKE_WORKSPACE_SKIP_MEMBERS = ["**/examples/*"]} -run_task = {name = ["test-flow", "test-with-browser"], fork = true} +env = { CARGO_MAKE_WORKSPACE_SKIP_MEMBERS = ["**/examples/*"] } +run_task = { name = ["test-flow", "test-with-browser"], fork = true } [tasks.build] command = "cargo" @@ -42,10 +94,24 @@ private = true [tasks.test] dependencies = ["build"] command = "cargo" -args = ["test", "--lib", "--bins", "--tests", "--examples", "--workspace", "--exclude", "dioxus-router", "--exclude", "dioxus-desktop"] +args = [ + "test", + "--lib", + "--bins", + "--tests", + "--examples", + "--workspace", + "--exclude", + "dioxus-router", + "--exclude", + "dioxus-desktop", +] private = true [tasks.test-with-browser] -env = { CARGO_MAKE_WORKSPACE_INCLUDE_MEMBERS = ["**/packages/router", "**/packages/desktop"] } +env = { CARGO_MAKE_WORKSPACE_INCLUDE_MEMBERS = [ + "**/packages/router", + "**/packages/desktop", +] } private = true workspace = true From e0fbed7eea90592d2769e8e763b69aea58af0106 Mon Sep 17 00:00:00 2001 From: Exotik850 <60969639+Exotik850@users.noreply.github.com> Date: Tue, 28 Nov 2023 16:54:17 -0600 Subject: [PATCH 285/447] Switch outdated tui crate for ratatui (#1671) * Switch outdated tui crate for ratatui * fix query docs whoops --- packages/rink/Cargo.toml | 2 +- packages/rink/src/lib.rs | 6 +++--- packages/rink/src/render.rs | 7 +++---- packages/rink/src/style.rs | 3 ++- packages/rink/src/style_attributes.rs | 8 ++++---- packages/rink/src/widget.rs | 2 +- 6 files changed, 14 insertions(+), 14 deletions(-) diff --git a/packages/rink/Cargo.toml b/packages/rink/Cargo.toml index ba3d549f8..92d1eae8c 100644 --- a/packages/rink/Cargo.toml +++ b/packages/rink/Cargo.toml @@ -14,7 +14,7 @@ dioxus-html = { workspace = true } dioxus-native-core = { workspace = true, features = ["layout-attributes"] } dioxus-native-core-macro = { workspace = true } -tui = "0.17.0" +ratatui = "0.24.0" crossterm = "0.26.1" anyhow = "1.0.42" tokio = { workspace = true, features = ["full"] } diff --git a/packages/rink/src/lib.rs b/packages/rink/src/lib.rs index 2eba1b98a..4a7261b55 100644 --- a/packages/rink/src/lib.rs +++ b/packages/rink/src/lib.rs @@ -17,6 +17,7 @@ use futures::{channel::mpsc::UnboundedSender, pin_mut, Future, StreamExt}; use futures_channel::mpsc::unbounded; use layout::TaffyLayout; use prevent_default::PreventDefault; +use ratatui::{backend::CrosstermBackend, Terminal}; use std::{io, time::Duration}; use std::{ pin::Pin, @@ -26,7 +27,6 @@ use std::{rc::Rc, sync::RwLock}; use style_attributes::StyleModifier; pub use taffy::{geometry::Point, prelude::*}; use tokio::select; -use tui::{backend::CrosstermBackend, Terminal}; use widgets::{register_widgets, RinkWidgetResponder, RinkWidgetTraitObject}; mod config; @@ -180,7 +180,7 @@ pub fn render( if !to_rerender.is_empty() || updated { updated = false; - fn resize(dims: tui::layout::Rect, taffy: &mut Taffy, rdom: &RealDom) { + fn resize(dims: ratatui::layout::Rect, taffy: &mut Taffy, rdom: &RealDom) { let width = screen_to_layout_space(dims.width); let height = screen_to_layout_space(dims.height); let root_node = rdom @@ -222,7 +222,7 @@ pub fn render( } else { let rdom = rdom.read().unwrap(); resize( - tui::layout::Rect { + ratatui::layout::Rect { x: 0, y: 0, width: 1000, diff --git a/packages/rink/src/render.rs b/packages/rink/src/render.rs index 19d642720..4185f3a62 100644 --- a/packages/rink/src/render.rs +++ b/packages/rink/src/render.rs @@ -1,11 +1,10 @@ use dioxus_native_core::{prelude::*, tree::TreeRef}; -use std::io::Stdout; +use ratatui::{layout::Rect, style::Color}; use taffy::{ geometry::Point, prelude::{Dimension, Layout, Size}, Taffy, }; -use tui::{backend::CrosstermBackend, layout::Rect, style::Color}; use crate::{ focus::Focused, @@ -20,7 +19,7 @@ use crate::{ const RADIUS_MULTIPLIER: [f32; 2] = [1.0, 0.5]; pub(crate) fn render_vnode( - frame: &mut tui::Frame>, + frame: &mut ratatui::Frame, layout: &Taffy, node: NodeRef, cfg: Config, @@ -96,7 +95,7 @@ pub(crate) fn render_vnode( impl RinkWidget for NodeRef<'_> { fn render(self, area: Rect, mut buf: RinkBuffer<'_>) { - use tui::symbols::line::*; + use ratatui::symbols::line::*; enum Direction { Left, diff --git a/packages/rink/src/style.rs b/packages/rink/src/style.rs index 857322079..905cc4b34 100644 --- a/packages/rink/src/style.rs +++ b/packages/rink/src/style.rs @@ -1,6 +1,6 @@ use std::{num::ParseFloatError, str::FromStr}; -use tui::style::{Color, Modifier, Style}; +use ratatui::style::{Color, Modifier, Style}; use crate::RenderingMode; @@ -442,6 +442,7 @@ impl RinkStyle { impl From for Style { fn from(val: RinkStyle) -> Self { Style { + underline_color: None, fg: val.fg.map(|c| c.color), bg: val.bg.map(|c| c.color), add_modifier: val.add_modifier, diff --git a/packages/rink/src/style_attributes.rs b/packages/rink/src/style_attributes.rs index 0c87e3f83..d1e8c6bee 100644 --- a/packages/rink/src/style_attributes.rs +++ b/packages/rink/src/style_attributes.rs @@ -187,8 +187,8 @@ pub enum BorderStyle { } impl BorderStyle { - pub fn symbol_set(&self) -> Option { - use tui::symbols::line::*; + pub fn symbol_set(&self) -> Option { + use ratatui::symbols::line::*; const DASHED: Set = Set { horizontal: "β•Œ", vertical: "β•Ž", @@ -570,7 +570,7 @@ fn apply_animation(name: &str, _value: &str, _style: &mut StyleModifier) { } fn apply_font(name: &str, value: &str, style: &mut StyleModifier) { - use tui::style::Modifier; + use ratatui::style::Modifier; match name { "font" => (), "font-family" => (), @@ -593,7 +593,7 @@ fn apply_font(name: &str, value: &str, style: &mut StyleModifier) { } fn apply_text(name: &str, value: &str, style: &mut StyleModifier) { - use tui::style::Modifier; + use ratatui::style::Modifier; match name { "text-align" => todo!(), diff --git a/packages/rink/src/widget.rs b/packages/rink/src/widget.rs index ab9044998..91af5b4f6 100644 --- a/packages/rink/src/widget.rs +++ b/packages/rink/src/widget.rs @@ -1,4 +1,4 @@ -use tui::{ +use ratatui::{ buffer::Buffer, layout::Rect, style::{Color, Modifier}, From be94c69f116ede6bec01373b1a47277256fd2db9 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Wed, 29 Nov 2023 11:38:28 -0600 Subject: [PATCH 286/447] make optional props accept T or Option --- examples/optional_props.rs | 6 +++++ packages/core-macro/src/props/mod.rs | 33 ++++++++-------------------- 2 files changed, 15 insertions(+), 24 deletions(-) diff --git a/examples/optional_props.rs b/examples/optional_props.rs index c5652a2e7..d5cf1e711 100644 --- a/examples/optional_props.rs +++ b/examples/optional_props.rs @@ -12,6 +12,12 @@ fn main() { fn app(cx: Scope) -> Element { cx.render(rsx! { + Button { + a: "asd".to_string(), + c: "asd".to_string(), + d: Some("asd".to_string()), + e: Some("asd".to_string()), + } Button { a: "asd".to_string(), c: "asd".to_string(), diff --git a/packages/core-macro/src/props/mod.rs b/packages/core-macro/src/props/mod.rs index 6e6c43d66..f8450e36a 100644 --- a/packages/core-macro/src/props/mod.rs +++ b/packages/core-macro/src/props/mod.rs @@ -783,31 +783,16 @@ Finally, call `.build()` to create the instance of `{name}`. None => quote!(), }; - // NOTE: both auto_into and strip_option affect `arg_type` and `arg_expr`, but the order of - // nesting is different so we have to do this little dance. - let arg_type = if field.builder_attr.strip_option { - field.type_from_inside_option(false).ok_or_else(|| { - Error::new_spanned( - field_type, - "can't `strip_option` - field is not `Option<...>`", + let arg_type = field_type; + let (arg_type, arg_expr) = + if field.builder_attr.auto_into || field.builder_attr.strip_option { + ( + quote!(impl ::core::convert::Into<#arg_type>), + quote!(#field_name.into()), ) - })? - } else { - field_type - }; - let (arg_type, arg_expr) = if field.builder_attr.auto_into { - ( - quote!(impl ::core::convert::Into<#arg_type>), - quote!(#field_name.into()), - ) - } else { - (quote!(#arg_type), quote!(#field_name)) - }; - let arg_expr = if field.builder_attr.strip_option { - quote!(Some(#arg_expr)) - } else { - arg_expr - }; + } else { + (quote!(#arg_type), quote!(#field_name)) + }; let repeated_fields_error_type_name = syn::Ident::new( &format!( From 533c7bab492d121b79b126458429fc5774c3a39e Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Wed, 29 Nov 2023 11:39:38 -0600 Subject: [PATCH 287/447] show more cases in the optional props example --- examples/optional_props.rs | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/examples/optional_props.rs b/examples/optional_props.rs index d5cf1e711..8108d437d 100644 --- a/examples/optional_props.rs +++ b/examples/optional_props.rs @@ -20,10 +20,16 @@ fn app(cx: Scope) -> Element { } Button { a: "asd".to_string(), + b: "asd".to_string(), c: "asd".to_string(), d: Some("asd".to_string()), e: "asd".to_string(), } + Button { + a: "asd".to_string(), + c: "asd".to_string(), + d: Some("asd".to_string()), + } }) } From a840e012d81d6b2de5b3ec7fcd91a65552c40a18 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Wed, 29 Nov 2023 11:46:18 -0600 Subject: [PATCH 288/447] fix clippy --- packages/core-macro/src/props/mod.rs | 4 ---- 1 file changed, 4 deletions(-) diff --git a/packages/core-macro/src/props/mod.rs b/packages/core-macro/src/props/mod.rs index f8450e36a..d7a580705 100644 --- a/packages/core-macro/src/props/mod.rs +++ b/packages/core-macro/src/props/mod.rs @@ -243,10 +243,6 @@ mod field_info { } .into() } - - pub fn type_from_inside_option(&self, check_option_name: bool) -> Option<&syn::Type> { - type_from_inside_option(self.ty, check_option_name) - } } #[derive(Debug, Default, Clone)] From c8a9a7b1d5cf06c59c90ee54d5ccbe12f06c6b7a Mon Sep 17 00:00:00 2001 From: zhangzhonglai Date: Fri, 1 Dec 2023 21:52:20 +0800 Subject: [PATCH 289/447] docs(desktop): fix wrong example code (#1678) * docs(desktop): fix wrong example code * stop ignoring doctests in dioxus desktop --------- Co-authored-by: ealmloff --- packages/desktop/src/lib.rs | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/packages/desktop/src/lib.rs b/packages/desktop/src/lib.rs index bfefaf547..63a8914f3 100644 --- a/packages/desktop/src/lib.rs +++ b/packages/desktop/src/lib.rs @@ -54,7 +54,7 @@ use wry::{application::window::WindowId, webview::WebContext}; /// /// This function will start a multithreaded Tokio runtime as well the WebView event loop. /// -/// ```rust, ignore +/// ```rust, no_run /// use dioxus::prelude::*; /// /// fn main() { @@ -77,11 +77,12 @@ pub fn launch(root: Component) { /// /// You can configure the WebView window with a configuration closure /// -/// ```rust, ignore +/// ```rust, no_run /// use dioxus::prelude::*; +/// use dioxus_desktop::*; /// /// fn main() { -/// dioxus_desktop::launch_cfg(app, |c| c.with_window(|w| w.with_title("My App"))); +/// dioxus_desktop::launch_cfg(app, Config::default().with_window(WindowBuilder::new().with_title("My App"))); /// } /// /// fn app(cx: Scope) -> Element { @@ -100,8 +101,9 @@ pub fn launch_cfg(root: Component, config_builder: Config) { /// /// You can configure the WebView window with a configuration closure /// -/// ```rust, ignore +/// ```rust, no_run /// use dioxus::prelude::*; +/// use dioxus_desktop::Config; /// /// fn main() { /// dioxus_desktop::launch_with_props(app, AppProps { name: "asd" }, Config::default()); From 8a44fe8d03bfc7917b1ae4a3c1dd3cd61f998d19 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Fri, 1 Dec 2023 15:31:45 -0600 Subject: [PATCH 290/447] derive query parsing in the router macro --- examples/query_segments_demo/src/main.rs | 29 ++++++--- packages/router-macro/src/lib.rs | 2 +- packages/router-macro/src/query.rs | 80 +++++++++++++++++++++++- packages/router-macro/src/route.rs | 2 +- packages/router-macro/src/segment.rs | 42 +++++++++++-- packages/router/src/routable.rs | 37 ++++++++++- 6 files changed, 175 insertions(+), 17 deletions(-) diff --git a/examples/query_segments_demo/src/main.rs b/examples/query_segments_demo/src/main.rs index aafcc0f43..de85bf563 100644 --- a/examples/query_segments_demo/src/main.rs +++ b/examples/query_segments_demo/src/main.rs @@ -14,29 +14,35 @@ use dioxus_router::prelude::*; #[derive(Routable, Clone)] #[rustfmt::skip] enum Route { - // segments that start with ?: are query segments - #[route("/blog?:query_params")] + // segments that start with ?:.. are query segments that capture the entire query + #[route("/blog?:..query_params")] BlogPost { // You must include query segments in child variants - query_params: BlogQuerySegments, + query_params: ManualBlogQuerySegments, + }, + // segments that follow the ?:field&:other_field syntax are query segments that follow the standard url query syntax + #[route("/autoblog?:name&:surname")] + AutomaticBlogPost { + name: String, + surname: String, }, } #[derive(Debug, Clone, PartialEq)] -struct BlogQuerySegments { +struct ManualBlogQuerySegments { name: String, surname: String, } /// The display impl needs to display the query in a way that can be parsed: -impl Display for BlogQuerySegments { +impl Display for ManualBlogQuerySegments { fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { write!(f, "name={}&surname={}", self.name, self.surname) } } /// The query segment is anything that implements . You can implement that trait for a struct if you want to parse multiple query parameters. -impl FromQuery for BlogQuerySegments { +impl FromQuery for ManualBlogQuerySegments { fn from_query(query: &str) -> Self { let mut name = None; let mut surname = None; @@ -57,13 +63,22 @@ impl FromQuery for BlogQuerySegments { } #[component] -fn BlogPost(cx: Scope, query_params: BlogQuerySegments) -> Element { +fn BlogPost(cx: Scope, query_params: ManualBlogQuerySegments) -> Element { render! { div{"This is your blogpost with a query segment:"} div{format!("{:?}", query_params)} } } + +#[component] +fn AutomaticBlogPost(cx: Scope, name: String, surname: String) -> Element { + render! { + div{"This is your blogpost with a query segment:"} + div{format!("name={}&surname={}", name, surname)} + } +} + #[component] fn App(cx: Scope) -> Element { render! { Router::{} } diff --git a/packages/router-macro/src/lib.rs b/packages/router-macro/src/lib.rs index 8844c6a35..024570ae1 100644 --- a/packages/router-macro/src/lib.rs +++ b/packages/router-macro/src/lib.rs @@ -36,7 +36,7 @@ mod segment; /// 1. Static Segments: "/static" /// 2. Dynamic Segments: "/:dynamic" (where dynamic has a type that is FromStr in all child Variants) /// 3. Catch all Segments: "/:..segments" (where segments has a type that is FromSegments in all child Variants) -/// 4. Query Segments: "/?:query" (where query has a type that is FromQuery in all child Variants) +/// 4. Query Segments: "/?:..query" (where query has a type that is FromQuery in all child Variants) or "/?:query&:other_query" (where query and other_query has a type that is FromQueryArgument in all child Variants) /// /// Routes are matched: /// 1. By there specificity this order: Query Routes ("/?:query"), Static Routes ("/route"), Dynamic Routes ("/:route"), Catch All Routes ("/:..route") diff --git a/packages/router-macro/src/query.rs b/packages/router-macro/src/query.rs index c97d3be29..40af2b39a 100644 --- a/packages/router-macro/src/query.rs +++ b/packages/router-macro/src/query.rs @@ -4,12 +4,62 @@ use syn::{Ident, Type}; use proc_macro2::TokenStream as TokenStream2; #[derive(Debug)] -pub struct QuerySegment { +pub enum QuerySegment { + Single(FullQuerySegment), + Segments(Vec), +} + +impl QuerySegment { + pub fn contains_ident(&self, ident: &Ident) -> bool { + match self { + QuerySegment::Single(segment) => segment.ident == *ident, + QuerySegment::Segments(segments) => { + segments.iter().any(|segment| segment.ident == *ident) + } + } + } + + pub fn parse(&self) -> TokenStream2 { + match self { + QuerySegment::Single(segment) => segment.parse(), + QuerySegment::Segments(segments) => { + let mut tokens = TokenStream2::new(); + tokens.extend(quote! { let split_query: std::collections::HashMap<&str, &str> = query.split('&').filter_map(|s| s.split_once('=')).collect(); }); + for segment in segments { + tokens.extend(segment.parse()); + } + tokens + } + } + } + + pub fn write(&self) -> TokenStream2 { + match self { + QuerySegment::Single(segment) => segment.write(), + QuerySegment::Segments(segments) => { + let mut tokens = TokenStream2::new(); + tokens.extend(quote! { write!(f, "?")?; }); + let mut segments_iter = segments.iter(); + if let Some(first_segment) = segments_iter.next() { + tokens.extend(first_segment.write()); + } + for segment in segments_iter { + tokens.extend(quote! { write!(f, "&")?; }); + tokens.extend(segment.write()); + } + tokens + } + } + } +} + +#[derive(Debug)] +pub struct FullQuerySegment { pub ident: Ident, pub ty: Type, } -impl QuerySegment { +impl FullQuerySegment { pub fn parse(&self) -> TokenStream2 { let ident = &self.ident; let ty = &self.ty; @@ -25,3 +75,29 @@ impl QuerySegment { } } } + +#[derive(Debug)] +pub struct QueryArgument { + pub ident: Ident, + pub ty: Type, +} + +impl QueryArgument { + pub fn parse(&self) -> TokenStream2 { + let ident = &self.ident; + let ty = &self.ty; + quote! { + let #ident = match split_query.get(stringify!(#ident)) { + Some(query_argument) => <#ty as dioxus_router::routable::FromQueryArgument>::from_query_argument(query_argument).unwrap_or_default(), + None => <#ty as Default>::default(), + }; + } + } + + pub fn write(&self) -> TokenStream2 { + let ident = &self.ident; + quote! { + write!(f, "{}={}", stringify!(#ident), #ident)?; + } + } +} diff --git a/packages/router-macro/src/route.rs b/packages/router-macro/src/route.rs index 26665e575..4724a4d7b 100644 --- a/packages/router-macro/src/route.rs +++ b/packages/router-macro/src/route.rs @@ -282,7 +282,7 @@ impl Route { } } if let Some(query) = &self.query { - if &query.ident == name { + if query.contains_ident(name) { from_route = true } } diff --git a/packages/router-macro/src/segment.rs b/packages/router-macro/src/segment.rs index 7e4e40662..21ebe5b60 100644 --- a/packages/router-macro/src/segment.rs +++ b/packages/router-macro/src/segment.rs @@ -3,7 +3,7 @@ use syn::{Ident, Type}; use proc_macro2::{Span, TokenStream as TokenStream2}; -use crate::query::QuerySegment; +use crate::query::{FullQuerySegment, QueryArgument, QuerySegment}; #[derive(Debug, Clone)] pub enum RouteSegment { @@ -201,7 +201,7 @@ pub fn parse_route_segments<'a>( // check if the route has a query string let parsed_query = match query { Some(query) => { - if let Some(query) = query.strip_prefix(':') { + if let Some(query) = query.strip_prefix(":..") { let query_ident = Ident::new(query, Span::call_site()); let field = fields.find(|(name, _)| *name == &query_ident); @@ -214,12 +214,44 @@ pub fn parse_route_segments<'a>( )); }; - Some(QuerySegment { + Some(QuerySegment::Single(FullQuerySegment { ident: query_ident, ty, - }) + })) } else { - None + let mut query_arguments = Vec::new(); + for segment in query.split('&') { + if segment.is_empty() { + return Err(syn::Error::new( + route_span, + "Query segments should be non-empty", + )); + } + if let Some(query_argument) = segment.strip_prefix(':') { + let query_ident = Ident::new(query_argument, Span::call_site()); + let field = fields.find(|(name, _)| *name == &query_ident); + + let ty = if let Some((_, ty)) = field { + ty.clone() + } else { + return Err(syn::Error::new( + route_span, + format!("Could not find a field with the name '{}'", query_ident), + )); + }; + + query_arguments.push(QueryArgument { + ident: query_ident, + ty, + }); + } else { + return Err(syn::Error::new( + route_span, + "Query segments should be a : followed by the name of the query argument", + )); + } + } + Some(QuerySegment::Segments(query_arguments)) } } None => None, diff --git a/packages/router/src/routable.rs b/packages/router/src/routable.rs index b1bb6d915..92277fd71 100644 --- a/packages/router/src/routable.rs +++ b/packages/router/src/routable.rs @@ -24,7 +24,7 @@ impl Display for RouteParseError { } } -/// Something that can be created from a query string. +/// Something that can be created from an entire query string. /// /// This trait needs to be implemented if you want to turn a query string into a struct. /// @@ -40,6 +40,41 @@ impl From<&'a str>> FromQuery for T { } } +/// Something that can be created from a query argument. +/// +/// This trait must be implemented for every type used within a query string in the router macro. +pub trait FromQueryArgument: Default { + /// The error that can occur when parsing a query argument. + type Err; + + /// Create an instance of `Self` from a query string. + fn from_query_argument(argument: &str) -> Result; +} + +impl FromQueryArgument for T +where + ::Err: Display, +{ + type Err = ::Err; + + fn from_query_argument(argument: &str) -> Result { + let result = match urlencoding::decode(argument) { + Ok(argument) => T::from_str(&argument), + Err(err) => { + tracing::error!("Failed to decode url encoding: {}", err); + T::from_str(argument) + } + }; + match result { + Ok(result) => Ok(result), + Err(err) => { + tracing::error!("Failed to parse query argument: {}", err); + Err(err) + } + } + } +} + /// Something that can be created from a route segment. pub trait FromRouteSegment: Sized { /// The error that can occur when parsing a route segment. From 35582e21eba456eb36ce17e2d72fec62475e8f63 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Fri, 1 Dec 2023 15:32:11 -0600 Subject: [PATCH 291/447] fix formatting --- examples/query_segments_demo/src/main.rs | 1 - 1 file changed, 1 deletion(-) diff --git a/examples/query_segments_demo/src/main.rs b/examples/query_segments_demo/src/main.rs index de85bf563..3303aeecd 100644 --- a/examples/query_segments_demo/src/main.rs +++ b/examples/query_segments_demo/src/main.rs @@ -70,7 +70,6 @@ fn BlogPost(cx: Scope, query_params: ManualBlogQuerySegments) -> Element { } } - #[component] fn AutomaticBlogPost(cx: Scope, name: String, surname: String) -> Element { render! { From 0a3b794a1cc3a9c215ca37b0d0510f70850778b5 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Fri, 1 Dec 2023 15:56:14 -0600 Subject: [PATCH 292/447] add a warning about wry gnu support to dioxus desktop --- packages/desktop/src/lib.rs | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/packages/desktop/src/lib.rs b/packages/desktop/src/lib.rs index 63a8914f3..13d52b032 100644 --- a/packages/desktop/src/lib.rs +++ b/packages/desktop/src/lib.rs @@ -19,6 +19,17 @@ mod webview; #[cfg(any(target_os = "ios", target_os = "android"))] mod mobile_shortcut; +// WARN about wry support on windows gnu targets. GNU windows targets don't work well in wry currently +#[cfg(all(windows, target_env = "gnu"))] +mod wry_gnu_warning { + #[allow(dead_code)] + #[must_use = "GNU windows targets can have issues with Wry. Using the MSVC toolchain is recommended"] + struct WryGnuWarning; + const _: () = { + let dont_use_gnu = WryGnuWarning; + }; +} + use crate::query::QueryResult; pub use cfg::{Config, WindowCloseBehaviour}; pub use desktop_context::DesktopContext; From a4600294c5c5dfc9c130b0db652d7ba2d036a1e8 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Fri, 1 Dec 2023 22:17:51 -0600 Subject: [PATCH 293/447] allow users to disable the warning in a feature --- packages/desktop/Cargo.toml | 1 + packages/desktop/src/lib.rs | 4 ++-- 2 files changed, 3 insertions(+), 2 deletions(-) diff --git a/packages/desktop/Cargo.toml b/packages/desktop/Cargo.toml index dcb994120..f0ea9e189 100644 --- a/packages/desktop/Cargo.toml +++ b/packages/desktop/Cargo.toml @@ -59,6 +59,7 @@ devtools = ["wry/devtools"] tray = ["wry/tray"] dox = ["wry/dox"] hot-reload = ["dioxus-hot-reload"] +gnu = [] [package.metadata.docs.rs] default-features = false diff --git a/packages/desktop/src/lib.rs b/packages/desktop/src/lib.rs index 13d52b032..9a5ba6c64 100644 --- a/packages/desktop/src/lib.rs +++ b/packages/desktop/src/lib.rs @@ -20,10 +20,10 @@ mod webview; mod mobile_shortcut; // WARN about wry support on windows gnu targets. GNU windows targets don't work well in wry currently -#[cfg(all(windows, target_env = "gnu"))] +#[cfg(all(windows, target_env = "gnu", not(feature = "gnu")))] mod wry_gnu_warning { #[allow(dead_code)] - #[must_use = "GNU windows targets can have issues with Wry. Using the MSVC toolchain is recommended"] + #[must_use = "GNU windows targets have some limitations within Wry. Using the MSVC windows toolchain is recommended. If you would like to use continue using GNU, you can read https://github.com/wravery/webview2-rs#cross-compilation and disable this warning by adding the gnu feature to dioxus-desktop in your Cargo.toml"] struct WryGnuWarning; const _: () = { let dont_use_gnu = WryGnuWarning; From a2ca1760c9f679c8904df2d4a9bde9c43a8697a4 Mon Sep 17 00:00:00 2001 From: Felix F Xu <84662027+felixf4xu@users.noreply.github.com> Date: Sun, 3 Dec 2023 09:25:27 +0800 Subject: [PATCH 294/447] Set local_socket_stream to blocking (default) (#1682) --- packages/cli/src/server/desktop/mod.rs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/cli/src/server/desktop/mod.rs b/packages/cli/src/server/desktop/mod.rs index 978b97d43..98d6e9244 100644 --- a/packages/cli/src/server/desktop/mod.rs +++ b/packages/cli/src/server/desktop/mod.rs @@ -121,9 +121,9 @@ async fn start_desktop_hot_reload(hot_reload_state: HotReloadState) -> Result<() let file_map = hot_reload_state.file_map.clone(); let channels = channels.clone(); let aborted = aborted.clone(); - let _ = local_socket_stream.set_nonblocking(true); move || { loop { + //accept() will block the thread when local_socket_stream is in blocking mode (default) match local_socket_stream.accept() { Ok(mut connection) => { // send any templates than have changed before the socket connected From d404ddfccfdacc57ec6043079fa1f07f3a50b947 Mon Sep 17 00:00:00 2001 From: Felix F Xu <84662027+felixf4xu@users.noreply.github.com> Date: Mon, 4 Dec 2023 10:02:30 +0800 Subject: [PATCH 295/447] fix false notification/rebuild for dx hot-reload (#1684) * fix false notification/rebuild for dx hot-reload * Make sure we have permissions and the changed file exists before reading the metadata --------- Co-authored-by: ealmloff --- packages/cli/src/server/mod.rs | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/packages/cli/src/server/mod.rs b/packages/cli/src/server/mod.rs index 79a5531b6..eb4021184 100644 --- a/packages/cli/src/server/mod.rs +++ b/packages/cli/src/server/mod.rs @@ -55,6 +55,16 @@ async fn setup_file_watcher Result + Send + 'static>( break; } + // Workaround for notify and vscode-like editor: + // when edit & save a file in vscode, there will be two notifications, + // the first one is a file with empty content. + // filter the empty file notification to avoid false rebuild during hot-reload + if let Ok(metadata) = fs::metadata(path) { + if metadata.len() == 0 { + continue; + } + } + match rsx_file_map.update_rsx(path, &config.crate_dir) { Ok(UpdateResult::UpdatedRsx(msgs)) => { messages.extend(msgs); From e69a4a7cd84da0ac371d4933f7704493c5a9735a Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Mon, 4 Dec 2023 07:07:35 -0600 Subject: [PATCH 296/447] Bump JamesIves/github-pages-deploy-action from 4.4.3 to 4.5.0 (#1685) Bumps [JamesIves/github-pages-deploy-action](https://github.com/jamesives/github-pages-deploy-action) from 4.4.3 to 4.5.0. - [Release notes](https://github.com/jamesives/github-pages-deploy-action/releases) - [Commits](https://github.com/jamesives/github-pages-deploy-action/compare/v4.4.3...v4.5.0) --- updated-dependencies: - dependency-name: JamesIves/github-pages-deploy-action dependency-type: direct:production update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- .github/workflows/docs stable.yml | 2 +- .github/workflows/docs.yml | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/docs stable.yml b/.github/workflows/docs stable.yml index 642216f0f..523a24067 100644 --- a/.github/workflows/docs stable.yml +++ b/.github/workflows/docs stable.yml @@ -33,7 +33,7 @@ jobs: # cd fermi && mdbook build -d ../nightly/fermi && cd .. - name: Deploy πŸš€ - uses: JamesIves/github-pages-deploy-action@v4.4.3 + uses: JamesIves/github-pages-deploy-action@v4.5.0 with: branch: gh-pages # The branch the action should deploy to. folder: docs/nightly # The folder the action should deploy. diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml index 88542aea8..7701209c1 100644 --- a/.github/workflows/docs.yml +++ b/.github/workflows/docs.yml @@ -39,7 +39,7 @@ jobs: # cd fermi && mdbook build -d ../nightly/fermi && cd .. - name: Deploy πŸš€ - uses: JamesIves/github-pages-deploy-action@v4.4.3 + uses: JamesIves/github-pages-deploy-action@v4.5.0 with: branch: gh-pages # The branch the action should deploy to. folder: docs/nightly # The folder the action should deploy. From 8149868ebc8610c4c2bc6fc41b50d9be4f4bfb40 Mon Sep 17 00:00:00 2001 From: Raul Cesar Teixeira Date: Mon, 4 Dec 2023 21:11:02 -0300 Subject: [PATCH 297/447] Fixed conflict of "--verbose" and "--quiet" flags (#1686) Co-authored-by: Raul Cesar --- packages/cli/src/builder.rs | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/packages/cli/src/builder.rs b/packages/cli/src/builder.rs index 71be8f115..08e636237 100644 --- a/packages/cli/src/builder.rs +++ b/packages/cli/src/builder.rs @@ -54,8 +54,7 @@ pub fn build(config: &CrateConfig, quiet: bool) -> Result { .arg("build") .arg("--target") .arg("wasm32-unknown-unknown") - .arg("--message-format=json") - .arg("--quiet"); + .arg("--message-format=json"); let cmd = if config.release { cmd.arg("--release") @@ -65,7 +64,7 @@ pub fn build(config: &CrateConfig, quiet: bool) -> Result { let cmd = if config.verbose { cmd.arg("--verbose") } else { - cmd + cmd.arg("--quiet") }; let cmd = if config.custom_profile.is_some() { From 71f7481dedf6590e91b03a12df7b1f5cfd447bab Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Mon, 4 Dec 2023 20:45:26 -0600 Subject: [PATCH 298/447] use requestAnimationFrame on desktop --- packages/desktop/build.rs | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/packages/desktop/build.rs b/packages/desktop/build.rs index b7989c595..795cc2ace 100644 --- a/packages/desktop/build.rs +++ b/packages/desktop/build.rs @@ -44,7 +44,9 @@ fn main() { .then(response => {{ response.arrayBuffer() .then(bytes => {{ - run_from_bytes(bytes); + requestAnimationFrame(() => {{ + run_from_bytes(bytes); + }}); window.interpreter.wait_for_request(); }}); }}) From 04fd2487b3edaf3c8f5cc347562de942fb10504c Mon Sep 17 00:00:00 2001 From: Ben Sully Date: Tue, 5 Dec 2023 20:10:18 +0000 Subject: [PATCH 299/447] feat(fullstack): add `render_handler_with_state` (#1687) * feat(fullstack): add `render_handler_with_state` When using server functions, the current pattern to access state such as database connections is to use `register_server_fns_with_handler` on an Axum router and 'inject' the state into the context provided to the server function. However, this only affects function calls which go via the Axum router; SSR renders bypass this, and therefore don't have access to any state. This commit adds an alternative `render_handler` which accepts some additional state. That state is injected into the context in a similar manner to `register_server_fns_with_handler`. SSR renders can then proceed to run in the same way as HTTP calls. * Change state object to 'inject_state' callback Also add a compiling doctest example. * remove the explicit for<'a> lifetime * remove unused assets_path from render_handler_with_context example --------- Co-authored-by: Evan Almloff --- .../fullstack/src/adapters/axum_adapter.rs | 66 +++++++++++++++++-- 1 file changed, 62 insertions(+), 4 deletions(-) diff --git a/packages/fullstack/src/adapters/axum_adapter.rs b/packages/fullstack/src/adapters/axum_adapter.rs index 95d9ee6cd..41a7c92be 100644 --- a/packages/fullstack/src/adapters/axum_adapter.rs +++ b/packages/fullstack/src/adapters/axum_adapter.rs @@ -369,15 +369,65 @@ fn apply_request_parts_to_response( } } -/// SSR renderer handler for Axum -pub async fn render_handler( - State((cfg, ssr_state)): State<(ServeConfig

, SSRState)>, +/// SSR renderer handler for Axum with added context injection. +/// +/// # Example +/// ```rust,no_run +/// #![allow(non_snake_case)] +/// use std::sync::{Arc, Mutex}; +/// +/// use axum::routing::get; +/// use dioxus::prelude::*; +/// use dioxus_fullstack::{axum_adapter::render_handler_with_context, prelude::*}; +/// +/// fn app(cx: Scope) -> Element { +/// render! { +/// "hello!" +/// } +/// } +/// +/// #[tokio::main] +/// async fn main() { +/// let cfg = ServeConfigBuilder::new(app, ()) +/// .assets_path("dist") +/// .build(); +/// let ssr_state = SSRState::new(&cfg); +/// +/// // This could be any state you want to be accessible from your server +/// // functions using `[DioxusServerContext::get]`. +/// let state = Arc::new(Mutex::new("state".to_string())); +/// +/// let addr = std::net::SocketAddr::from(([127, 0, 0, 1], 8080)); +/// axum::Server::bind(&addr) +/// .serve( +/// axum::Router::new() +/// // Register server functions, etc. +/// // Note you probably want to use `register_server_fns_with_handler` +/// // to inject the context into server functions running outside +/// // of an SSR render context. +/// .fallback(get(render_handler_with_context).with_state(( +/// move |ctx| ctx.insert(state.clone()).unwrap(), +/// cfg, +/// ssr_state, +/// ))) +/// .into_make_service(), +/// ) +/// .await +/// .unwrap(); +/// } +/// ``` +pub async fn render_handler_with_context< + P: Clone + serde::Serialize + Send + Sync + 'static, + F: FnMut(&mut DioxusServerContext), +>( + State((mut inject_context, cfg, ssr_state)): State<(F, ServeConfig

, SSRState)>, request: Request, ) -> impl IntoResponse { let (parts, _) = request.into_parts(); let url = parts.uri.path_and_query().unwrap().to_string(); let parts: Arc> = Arc::new(RwLock::new(parts.into())); - let server_context = DioxusServerContext::new(parts.clone()); + let mut server_context = DioxusServerContext::new(parts.clone()); + inject_context(&mut server_context); match ssr_state.render(url, &cfg, &server_context).await { Ok(rendered) => { @@ -395,6 +445,14 @@ pub async fn render_handler } } +/// SSR renderer handler for Axum +pub async fn render_handler( + State((cfg, ssr_state)): State<(ServeConfig

, SSRState)>, + request: Request, +) -> impl IntoResponse { + render_handler_with_context(State((|_: &mut _| (), cfg, ssr_state)), request).await +} + fn report_err(e: E) -> Response { Response::builder() .status(StatusCode::INTERNAL_SERVER_ERROR) From 0c9248688372cdefd3fedb8bc884ee3fcb3ddcca Mon Sep 17 00:00:00 2001 From: Jonathan Kelley Date: Tue, 5 Dec 2023 22:57:20 -0800 Subject: [PATCH 300/447] publish generational box --- Cargo.toml | 4 ++-- packages/generational-box/Cargo.toml | 7 +++++-- 2 files changed, 7 insertions(+), 4 deletions(-) diff --git a/Cargo.toml b/Cargo.toml index d687d74d0..153866883 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -76,8 +76,8 @@ plasmo = { path = "packages/rink", version = "0.4.0" } dioxus-native-core = { path = "packages/native-core", version = "0.4.0" } dioxus-native-core-macro = { path = "packages/native-core-macro", version = "0.4.0" } rsx-rosetta = { path = "packages/rsx-rosetta", version = "0.4.0" } -dioxus-signals = { path = "packages/signals" } -generational-box = { path = "packages/generational-box" } +dioxus-signals = { path = "packages/signals", version = "0.1.0" } +generational-box = { path = "packages/generational-box", version = "0.1.0" } dioxus-hot-reload = { path = "packages/hot-reload", version = "0.4.0" } dioxus-fullstack = { path = "packages/fullstack", version = "0.4.1" } dioxus_server_macro = { path = "packages/server-macro", version = "0.4.1" } diff --git a/packages/generational-box/Cargo.toml b/packages/generational-box/Cargo.toml index 6c5a5a841..661c9725b 100644 --- a/packages/generational-box/Cargo.toml +++ b/packages/generational-box/Cargo.toml @@ -1,9 +1,12 @@ [package] name = "generational-box" authors = ["Evan Almloff"] -version = "0.0.0" +version = "0.1.0" edition = "2018" - +description = "A box backed by a generational runtime" +license = "MIT OR Apache-2.0" +repository = "https://github.com/DioxusLabs/dioxus/" +keywords = ["generational", "box", "memory", "allocator"] # See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html [dependencies] From 6088483fb2cdd27a0c536a6a596f0c986fe23927 Mon Sep 17 00:00:00 2001 From: Jonathan Kelley Date: Tue, 5 Dec 2023 23:01:10 -0800 Subject: [PATCH 301/447] fix signals import --- Cargo.toml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Cargo.toml b/Cargo.toml index 153866883..06e4ca1fa 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -76,7 +76,7 @@ plasmo = { path = "packages/rink", version = "0.4.0" } dioxus-native-core = { path = "packages/native-core", version = "0.4.0" } dioxus-native-core-macro = { path = "packages/native-core-macro", version = "0.4.0" } rsx-rosetta = { path = "packages/rsx-rosetta", version = "0.4.0" } -dioxus-signals = { path = "packages/signals", version = "0.1.0" } +dioxus-signals = { path = "packages/signals" } generational-box = { path = "packages/generational-box", version = "0.1.0" } dioxus-hot-reload = { path = "packages/hot-reload", version = "0.4.0" } dioxus-fullstack = { path = "packages/fullstack", version = "0.4.1" } From 8530f53692ec4ce2df6dcec4fb2af85576d6fdac Mon Sep 17 00:00:00 2001 From: JMS55 <47158642+JMS55@users.noreply.github.com> Date: Wed, 6 Dec 2023 04:55:07 -0800 Subject: [PATCH 302/447] Fix typo (#1695) * Fix typo * Fix typo again --- packages/core/src/mutations.rs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/core/src/mutations.rs b/packages/core/src/mutations.rs index 27976c157..f33590e2e 100644 --- a/packages/core/src/mutations.rs +++ b/packages/core/src/mutations.rs @@ -91,7 +91,7 @@ pub enum Mutation<'a> { id: ElementId, }, - /// Create an placeholder int he DOM that we will use later. + /// Create a placeholder in the DOM that we will use later. /// /// Dioxus currently requires the use of placeholders to maintain a re-entrance point for things like list diffing CreatePlaceholder { From e4d60c8dfcf7c1633d9868dd91a65afcdf48dfb7 Mon Sep 17 00:00:00 2001 From: Pascal Date: Wed, 6 Dec 2023 21:39:31 +0100 Subject: [PATCH 303/447] add default menu bar in dioxus-desktop to resolve #1691 fixup naming and expose disable_default_menu_bar with builder function --- packages/desktop/src/cfg.rs | 8 +++++ packages/desktop/src/webview.rs | 64 +++++++++++++++++++++++++++++++-- 2 files changed, 70 insertions(+), 2 deletions(-) diff --git a/packages/desktop/src/cfg.rs b/packages/desktop/src/cfg.rs index 07281e364..ba42ffa01 100644 --- a/packages/desktop/src/cfg.rs +++ b/packages/desktop/src/cfg.rs @@ -36,6 +36,7 @@ pub struct Config { pub(crate) root_name: String, pub(crate) background_color: Option<(u8, u8, u8, u8)>, pub(crate) last_window_close_behaviour: WindowCloseBehaviour, + pub(crate) disable_default_menu_bar: bool, } type DropHandler = Box bool>; @@ -65,9 +66,16 @@ impl Config { root_name: "main".to_string(), background_color: None, last_window_close_behaviour: WindowCloseBehaviour::LastWindowExitsApp, + disable_default_menu_bar: false, } } + /// Set whether the default menu bar should be disabled. + pub fn with_disable_default_menu_bar(mut self, disable: bool) -> Self { + self.disable_default_menu_bar = disable; + self + } + /// set the directory from which assets will be searched in release mode pub fn with_resource_directory(mut self, path: impl Into) -> Self { self.resource_dir = Some(path.into()); diff --git a/packages/desktop/src/webview.rs b/packages/desktop/src/webview.rs index 6e6d26b17..9beae702a 100644 --- a/packages/desktop/src/webview.rs +++ b/packages/desktop/src/webview.rs @@ -4,6 +4,7 @@ use crate::{desktop_context::UserWindowEvent, Config}; use tao::event_loop::{EventLoopProxy, EventLoopWindowTarget}; pub use wry; pub use wry::application as tao; +use wry::application::menu::{MenuBar, MenuItem}; use wry::application::window::Window; use wry::webview::{WebContext, WebView, WebViewBuilder}; @@ -12,13 +13,18 @@ pub fn build( event_loop: &EventLoopWindowTarget, proxy: EventLoopProxy, ) -> (WebView, WebContext) { - let builder = cfg.window.clone(); - let window = builder.with_visible(false).build(event_loop).unwrap(); + let mut builder = cfg.window.clone(); let file_handler = cfg.file_drop_handler.take(); let custom_head = cfg.custom_head.clone(); let index_file = cfg.custom_index.clone(); let root_name = cfg.root_name.clone(); + if !cfg.disable_default_menu_bar { + builder = builder.with_menu(create_default_menu_bar()); + } + + let window = builder.with_visible(false).build(event_loop).unwrap(); + // We assume that if the icon is None in cfg, then the user just didnt set it if cfg.window.window.window_icon.is_none() { window.set_window_icon(Some( @@ -96,3 +102,57 @@ pub fn build( (webview.build().unwrap(), web_context) } + +/// Creates a standard menu bar depending on the platform +fn create_default_menu_bar() -> MenuBar { + let mut menu_bar = MenuBar::new(); + + // since it is uncommon on windows to have an "application menu" + // we add a "window" menu to be more consistent across platforms with the standard menu + let mut window_menu = MenuBar::new(); + #[cfg(target_os = "macos")] + { + window_menu.add_native_item(MenuItem::EnterFullScreen); + window_menu.add_native_item(MenuItem::Zoom); + window_menu.add_native_item(MenuItem::Separator); + } + + window_menu.add_native_item(MenuItem::Hide); + + #[cfg(target_os = "macos")] + { + window_menu.add_native_item(MenuItem::HideOthers); + window_menu.add_native_item(MenuItem::ShowAll); + } + + window_menu.add_native_item(MenuItem::Minimize); + window_menu.add_native_item(MenuItem::CloseWindow); + window_menu.add_native_item(MenuItem::Separator); + window_menu.add_native_item(MenuItem::Quit); + menu_bar.add_submenu("Window", true, window_menu); + + // since tao supports none of the below items on linux we should only add them on macos/windows + #[cfg(not(target_os = "linux"))] + { + let mut edit_menu = MenuBar::new(); + #[cfg(target_os = "macos")] + { + edit_menu.add_native_item(MenuItem::Undo); + edit_menu.add_native_item(MenuItem::Redo); + edit_menu.add_native_item(MenuItem::Separator); + } + + edit_menu.add_native_item(MenuItem::Cut); + edit_menu.add_native_item(MenuItem::Copy); + edit_menu.add_native_item(MenuItem::Paste); + + #[cfg(target_os = "macos")] + { + edit_menu.add_native_item(MenuItem::Separator); + edit_menu.add_native_item(MenuItem::SelectAll); + } + menu_bar.add_submenu("Edit", true, edit_menu); + } + + menu_bar +} From b965fc23e96fb8a56b5e8e4b601bbd76f28ad74f Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Wed, 6 Dec 2023 17:01:51 -0600 Subject: [PATCH 304/447] use a temp directory for the hot reloading pipe on desktop, fullstack and liveview --- packages/cli/src/server/desktop/mod.rs | 5 +++-- packages/hot-reload/src/file_watcher.rs | 7 ++++--- packages/hot-reload/src/lib.rs | 3 ++- 3 files changed, 9 insertions(+), 6 deletions(-) diff --git a/packages/cli/src/server/desktop/mod.rs b/packages/cli/src/server/desktop/mod.rs index 98d6e9244..6373487b3 100644 --- a/packages/cli/src/server/desktop/mod.rs +++ b/packages/cli/src/server/desktop/mod.rs @@ -109,7 +109,8 @@ pub async fn serve(config: CrateConfig, hot_reload_state: Option } async fn start_desktop_hot_reload(hot_reload_state: HotReloadState) -> Result<()> { - match LocalSocketListener::bind("@dioxusin") { + let path = std::env::temp_dir().join("dioxusin"); + match LocalSocketListener::bind(path) { Ok(local_socket_stream) => { let aborted = Arc::new(Mutex::new(false)); // States @@ -188,7 +189,7 @@ fn clear_paths() { // We check if the file socket is already open from an old session and then delete it let paths = ["./dioxusin", "./@dioxusin"]; for path in paths { - let path = std::path::PathBuf::from(path); + let path = std::env::temp_dir().join(path); if path.exists() { let _ = std::fs::remove_file(path); } diff --git a/packages/hot-reload/src/file_watcher.rs b/packages/hot-reload/src/file_watcher.rs index 2509dd789..bbd0a7660 100644 --- a/packages/hot-reload/src/file_watcher.rs +++ b/packages/hot-reload/src/file_watcher.rs @@ -157,16 +157,17 @@ pub fn init(cfg: Config) { // On unix, if you force quit the application, it can leave the file socket open // This will cause the local socket listener to fail to open // We check if the file socket is already open from an old session and then delete it - let paths = ["./dioxusin", "./@dioxusin"]; + let paths = ["./dioxusin"]; for path in paths { - let path = PathBuf::from(path); + let path = std::env::temp_dir().join(path); if path.exists() { let _ = std::fs::remove_file(path); } } } - match LocalSocketListener::bind("@dioxusin") { + let path = std::env::temp_dir().join("dioxusin"); + match LocalSocketListener::bind(path) { Ok(local_socket_stream) => { let aborted = Arc::new(Mutex::new(false)); diff --git a/packages/hot-reload/src/lib.rs b/packages/hot-reload/src/lib.rs index 68692b72b..07bd70a8d 100644 --- a/packages/hot-reload/src/lib.rs +++ b/packages/hot-reload/src/lib.rs @@ -24,7 +24,8 @@ pub enum HotReloadMsg { /// Connect to the hot reloading listener. The callback provided will be called every time a template change is detected pub fn connect(mut f: impl FnMut(HotReloadMsg) + Send + 'static) { std::thread::spawn(move || { - if let Ok(socket) = LocalSocketStream::connect("@dioxusin") { + let path = std::env::temp_dir().join("dioxusin"); + if let Ok(socket) = LocalSocketStream::connect(path) { let mut buf_reader = BufReader::new(socket); loop { let mut buf = String::new(); From ab1fab5f50e5e9b487ce2f7e4535d659b1d3e274 Mon Sep 17 00:00:00 2001 From: Jonathan Kelley Date: Wed, 6 Dec 2023 16:49:05 -0800 Subject: [PATCH 305/447] No publish demos --- examples/openid_connect_demo/Cargo.toml | 1 + examples/query_segments_demo/Cargo.toml | 1 + 2 files changed, 2 insertions(+) diff --git a/examples/openid_connect_demo/Cargo.toml b/examples/openid_connect_demo/Cargo.toml index 4c5f47061..2a1abe173 100644 --- a/examples/openid_connect_demo/Cargo.toml +++ b/examples/openid_connect_demo/Cargo.toml @@ -2,6 +2,7 @@ name = "openid_auth_demo" version = "0.1.0" edition = "2021" +publish = false # See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html diff --git a/examples/query_segments_demo/Cargo.toml b/examples/query_segments_demo/Cargo.toml index 4a7d784c7..ee9f49c70 100644 --- a/examples/query_segments_demo/Cargo.toml +++ b/examples/query_segments_demo/Cargo.toml @@ -2,6 +2,7 @@ name = "query_segments_demo" version = "0.1.0" edition = "2021" +publish = false # See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html From d3f6ff703c0f90cd58da8d459be056db29f3c38e Mon Sep 17 00:00:00 2001 From: Jonathan Kelley Date: Wed, 6 Dec 2023 16:56:35 -0800 Subject: [PATCH 306/447] Release 0.4.3 dioxus@0.4.3 dioxus-autofmt@0.4.3 dioxus-check@0.4.3 dioxus-cli@0.4.3 dioxus-core@0.4.3 dioxus-core-macro@0.4.3 dioxus-desktop@0.4.3 dioxus-fullstack@0.4.3 dioxus-hooks@0.4.3 dioxus-hot-reload@0.4.3 dioxus-html@0.4.3 dioxus-interpreter-js@0.4.3 dioxus-liveview@0.4.3 dioxus-mobile@0.4.3 dioxus-native-core@0.4.3 dioxus-native-core-macro@0.4.3 dioxus-router@0.4.3 dioxus-router-macro@0.4.3 dioxus-rsx@0.4.3 dioxus-signals@0.4.3 dioxus-ssr@0.4.3 dioxus-tui@0.4.3 dioxus-web@0.4.3 dioxus_server_macro@0.4.3 fermi@0.4.3 generational-box@0.4.3 plasmo@0.4.3 rsx-rosetta@0.4.3 Generated by cargo-workspaces --- Cargo.toml | 6 +++--- examples/tailwind/Cargo.toml | 2 +- packages/cli/Cargo.toml | 2 +- packages/generational-box/Cargo.toml | 2 +- packages/signals/Cargo.toml | 4 ++-- 5 files changed, 8 insertions(+), 8 deletions(-) diff --git a/Cargo.toml b/Cargo.toml index 06e4ca1fa..1772c1f47 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -50,7 +50,7 @@ members = [ exclude = ["examples/mobile_demo"] [workspace.package] -version = "0.4.2" +version = "0.4.3" # dependencies that are shared across packages [workspace.dependencies] @@ -77,7 +77,7 @@ dioxus-native-core = { path = "packages/native-core", version = "0.4.0" } dioxus-native-core-macro = { path = "packages/native-core-macro", version = "0.4.0" } rsx-rosetta = { path = "packages/rsx-rosetta", version = "0.4.0" } dioxus-signals = { path = "packages/signals" } -generational-box = { path = "packages/generational-box", version = "0.1.0" } +generational-box = { path = "packages/generational-box", version = "0.4.3" } dioxus-hot-reload = { path = "packages/hot-reload", version = "0.4.0" } dioxus-fullstack = { path = "packages/fullstack", version = "0.4.1" } dioxus_server_macro = { path = "packages/server-macro", version = "0.4.1" } @@ -99,7 +99,7 @@ prettyplease = { package = "prettier-please", version = "0.2", features = [ # It is not meant to be published, but is used so "cargo run --example XYZ" works properly [package] name = "dioxus-examples" -version = "0.0.0" +version = "0.4.3" authors = ["Jonathan Kelley"] edition = "2021" description = "Top level crate for the Dioxus repository" diff --git a/examples/tailwind/Cargo.toml b/examples/tailwind/Cargo.toml index 5c2fbe666..26ac202f1 100644 --- a/examples/tailwind/Cargo.toml +++ b/examples/tailwind/Cargo.toml @@ -18,4 +18,4 @@ dioxus = { path = "../../packages/dioxus" } dioxus-desktop = { path = "../../packages/desktop" } [target.'cfg(target_arch = "wasm32")'.dependencies] -dioxus-web = { path = "../../packages/web" } \ No newline at end of file +dioxus-web = { path = "../../packages/web" } diff --git a/packages/cli/Cargo.toml b/packages/cli/Cargo.toml index adb0239f2..128133602 100644 --- a/packages/cli/Cargo.toml +++ b/packages/cli/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "dioxus-cli" -version = "0.4.1" +version = "0.4.3" authors = ["Jonathan Kelley"] edition = "2021" description = "CLI tool for developing, testing, and publishing Dioxus apps" diff --git a/packages/generational-box/Cargo.toml b/packages/generational-box/Cargo.toml index 661c9725b..f070c1805 100644 --- a/packages/generational-box/Cargo.toml +++ b/packages/generational-box/Cargo.toml @@ -1,7 +1,7 @@ [package] name = "generational-box" authors = ["Evan Almloff"] -version = "0.1.0" +version = "0.4.3" edition = "2018" description = "A box backed by a generational runtime" license = "MIT OR Apache-2.0" diff --git a/packages/signals/Cargo.toml b/packages/signals/Cargo.toml index 56e19bbd8..34ae671b3 100644 --- a/packages/signals/Cargo.toml +++ b/packages/signals/Cargo.toml @@ -1,7 +1,7 @@ [package] name = "dioxus-signals" authors = ["Jonathan Kelley"] -version = "0.0.0" +version = "0.4.3" edition = "2018" # See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html @@ -20,4 +20,4 @@ tokio = { version = "1", features = ["full"] } [features] default = [] -serialize = ["serde"] \ No newline at end of file +serialize = ["serde"] From 16982c9f69adcebae9d9f086328bb20b11d6882b Mon Sep 17 00:00:00 2001 From: Jonathan Kelley Date: Wed, 6 Dec 2023 20:54:50 -0800 Subject: [PATCH 307/447] Add metadata for signals crate --- packages/signals/Cargo.toml | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/packages/signals/Cargo.toml b/packages/signals/Cargo.toml index 34ae671b3..c85fb6d7f 100644 --- a/packages/signals/Cargo.toml +++ b/packages/signals/Cargo.toml @@ -3,6 +3,12 @@ name = "dioxus-signals" authors = ["Jonathan Kelley"] version = "0.4.3" edition = "2018" +description = "Signals for Dioxus" +license = "MIT OR Apache-2.0" +repository = "https://github.com/DioxusLabs/dioxus/" +homepage = "https://dioxuslabs.com" +keywords = ["dom", "ui", "gui", "react", "wasm"] +rust-version = "1.60.0" # See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html From 69bf6b9dd7a8872e38a846ea8094d76589d05b21 Mon Sep 17 00:00:00 2001 From: Jonathan Kelley Date: Wed, 6 Dec 2023 21:27:26 -0800 Subject: [PATCH 308/447] CI: adjust matrix test to install rustfmt during autofmt tests --- .github/workflows/main.yml | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml index 037525557..1b1f1ed7b 100644 --- a/.github/workflows/main.yml +++ b/.github/workflows/main.yml @@ -124,8 +124,6 @@ jobs: } steps: - - uses: actions/checkout@v4 - - name: install stable uses: dtolnay/rust-toolchain@master with: @@ -141,6 +139,11 @@ jobs: workspaces: core -> ../target save-if: ${{ matrix.features.key == 'all' }} + - name: Install rustfmt + run: rustup component add rustfmt + + - uses: actions/checkout@v4 + - name: test run: | ${{ env.RUST_CARGO_COMMAND }} ${{ matrix.platform.command }} ${{ matrix.platform.args }} --target ${{ matrix.platform.target }} From 9a13df2c737b4232bcf76946eff2cbac5d111896 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Thu, 7 Dec 2023 07:00:59 -0600 Subject: [PATCH 309/447] move hot reload socket into the target directory --- packages/cli/src/server/desktop/mod.rs | 21 +++++++++++---------- packages/hot-reload/src/file_watcher.rs | 14 ++++++-------- packages/hot-reload/src/lib.rs | 7 +++++-- 3 files changed, 22 insertions(+), 20 deletions(-) diff --git a/packages/cli/src/server/desktop/mod.rs b/packages/cli/src/server/desktop/mod.rs index 6373487b3..86f9d971a 100644 --- a/packages/cli/src/server/desktop/mod.rs +++ b/packages/cli/src/server/desktop/mod.rs @@ -43,8 +43,6 @@ pub async fn startup(config: CrateConfig) -> Result<()> { let hot_reload_tx = broadcast::channel(100).0; - clear_paths(); - Some(HotReloadState { messages: hot_reload_tx.clone(), file_map: file_map.clone(), @@ -109,7 +107,13 @@ pub async fn serve(config: CrateConfig, hot_reload_state: Option } async fn start_desktop_hot_reload(hot_reload_state: HotReloadState) -> Result<()> { - let path = std::env::temp_dir().join("dioxusin"); + let metadata = cargo_metadata::MetadataCommand::new() + .no_deps() + .exec() + .unwrap(); + let target_dir = metadata.target_directory.as_std_path(); + let path = target_dir.join("dioxusin"); + clear_paths(&path); match LocalSocketListener::bind(path) { Ok(local_socket_stream) => { let aborted = Arc::new(Mutex::new(false)); @@ -182,17 +186,14 @@ async fn start_desktop_hot_reload(hot_reload_state: HotReloadState) -> Result<() Ok(()) } -fn clear_paths() { +fn clear_paths(file_socket_path: &std::path::Path) { if cfg!(target_os = "macos") { // On unix, if you force quit the application, it can leave the file socket open // This will cause the local socket listener to fail to open // We check if the file socket is already open from an old session and then delete it - let paths = ["./dioxusin", "./@dioxusin"]; - for path in paths { - let path = std::env::temp_dir().join(path); - if path.exists() { - let _ = std::fs::remove_file(path); - } + + if file_socket_path.exists() { + let _ = std::fs::remove_file(file_socket_path); } } } diff --git a/packages/hot-reload/src/file_watcher.rs b/packages/hot-reload/src/file_watcher.rs index bbd0a7660..c83c62ad9 100644 --- a/packages/hot-reload/src/file_watcher.rs +++ b/packages/hot-reload/src/file_watcher.rs @@ -152,22 +152,20 @@ pub fn init(cfg: Config) { } let file_map = Arc::new(Mutex::new(file_map)); + let target_dir = crate_dir.join("target"); + let hot_reload_socket_path = target_dir.join("dioxusin"); + #[cfg(target_os = "macos")] { // On unix, if you force quit the application, it can leave the file socket open // This will cause the local socket listener to fail to open // We check if the file socket is already open from an old session and then delete it - let paths = ["./dioxusin"]; - for path in paths { - let path = std::env::temp_dir().join(path); - if path.exists() { - let _ = std::fs::remove_file(path); - } + if hot_reload_socket_path.exists() { + let _ = std::fs::remove_file(hot_reload_socket_path); } } - let path = std::env::temp_dir().join("dioxusin"); - match LocalSocketListener::bind(path) { + match LocalSocketListener::bind(hot_reload_socket_path) { Ok(local_socket_stream) => { let aborted = Arc::new(Mutex::new(false)); diff --git a/packages/hot-reload/src/lib.rs b/packages/hot-reload/src/lib.rs index 07bd70a8d..46efb8341 100644 --- a/packages/hot-reload/src/lib.rs +++ b/packages/hot-reload/src/lib.rs @@ -1,4 +1,7 @@ -use std::io::{BufRead, BufReader}; +use std::{ + io::{BufRead, BufReader}, + path::PathBuf, +}; use dioxus_core::Template; #[cfg(feature = "file_watcher")] @@ -24,7 +27,7 @@ pub enum HotReloadMsg { /// Connect to the hot reloading listener. The callback provided will be called every time a template change is detected pub fn connect(mut f: impl FnMut(HotReloadMsg) + Send + 'static) { std::thread::spawn(move || { - let path = std::env::temp_dir().join("dioxusin"); + let path = PathBuf::from("./").join("target").join("dioxusin"); if let Ok(socket) = LocalSocketStream::connect(path) { let mut buf_reader = BufReader::new(socket); loop { From 2bab4eb6c3748ca8803a1332ff57502979da7e55 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Thu, 7 Dec 2023 07:06:43 -0600 Subject: [PATCH 310/447] rename read_untracked to peak --- packages/signals/src/signal.rs | 16 +++++++++++----- 1 file changed, 11 insertions(+), 5 deletions(-) diff --git a/packages/signals/src/signal.rs b/packages/signals/src/signal.rs index 0ad96349d..88853c473 100644 --- a/packages/signals/src/signal.rs +++ b/packages/signals/src/signal.rs @@ -171,7 +171,8 @@ impl Signal { self.inner.origin_scope() } - /// Get the current value of the signal. This will subscribe the current scope to the signal. + /// Get the current value of the signal. This will subscribe the current scope to the signal. If you would like to read the signal without subscribing to it, you can use [`Self::peak`] instead. + /// /// If the signal has been dropped, this will panic. pub fn read(&self) -> Ref { let inner = self.inner.read(); @@ -201,13 +202,15 @@ impl Signal { } /// Get the current value of the signal. **Unlike read, this will not subscribe the current scope to the signal which can cause parts of your UI to not update.** + /// /// If the signal has been dropped, this will panic. - pub fn read_untracked(&self) -> Ref { + pub fn peak(&self) -> Ref { let inner = self.inner.read(); Ref::map(inner, |v| &v.value) } /// Get a mutable reference to the signal's value. + /// /// If the signal has been dropped, this will panic. pub fn write(&self) -> Write<'_, T> { let inner = self.inner.write(); @@ -387,15 +390,18 @@ impl ReadOnlySignal { self.inner.origin_scope() } - /// Get the current value of the signal. This will subscribe the current scope to the signal. + /// Get the current value of the signal. This will subscribe the current scope to the signal. If you would like to read the signal without subscribing to it, you can use [`Self::peak`] instead. + /// + /// If the signal has been dropped, this will panic. pub fn read(&self) -> Ref { self.inner.read() } /// Get the current value of the signal. **Unlike read, this will not subscribe the current scope to the signal which can cause parts of your UI to not update.** + /// /// If the signal has been dropped, this will panic. - pub fn read_untracked(&self) -> Ref { - self.inner.read_untracked() + pub fn peak(&self) -> Ref { + self.inner.peak() } /// Run a closure with a reference to the signal's value. From 7d2bbda53dc94b07cfe0aad8499b3eb408ecce99 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Thu, 7 Dec 2023 07:10:53 -0600 Subject: [PATCH 311/447] move gnu warning to build script --- packages/desktop/build.rs | 9 +++++++++ packages/desktop/src/lib.rs | 11 ----------- 2 files changed, 9 insertions(+), 11 deletions(-) create mode 100644 packages/desktop/build.rs diff --git a/packages/desktop/build.rs b/packages/desktop/build.rs new file mode 100644 index 000000000..2061732e8 --- /dev/null +++ b/packages/desktop/build.rs @@ -0,0 +1,9 @@ +fn main() { + // WARN about wry support on windows gnu targets. GNU windows targets don't work well in wry currently + if std::env::var("CARGO_CFG_WINDOWS").is_ok() + && std::env::var("CARGO_CFG_TARGET_ENV").unwrap() == "gnu" + && !cfg!(feature = "gnu") + { + println!("cargo:warning=GNU windows targets have some limitations within Wry. Using the MSVC windows toolchain is recommended. If you would like to use continue using GNU, you can read https://github.com/wravery/webview2-rs#cross-compilation and disable this warning by adding the gnu feature to dioxus-desktop in your Cargo.toml") + } +} diff --git a/packages/desktop/src/lib.rs b/packages/desktop/src/lib.rs index 9a5ba6c64..63a8914f3 100644 --- a/packages/desktop/src/lib.rs +++ b/packages/desktop/src/lib.rs @@ -19,17 +19,6 @@ mod webview; #[cfg(any(target_os = "ios", target_os = "android"))] mod mobile_shortcut; -// WARN about wry support on windows gnu targets. GNU windows targets don't work well in wry currently -#[cfg(all(windows, target_env = "gnu", not(feature = "gnu")))] -mod wry_gnu_warning { - #[allow(dead_code)] - #[must_use = "GNU windows targets have some limitations within Wry. Using the MSVC windows toolchain is recommended. If you would like to use continue using GNU, you can read https://github.com/wravery/webview2-rs#cross-compilation and disable this warning by adding the gnu feature to dioxus-desktop in your Cargo.toml"] - struct WryGnuWarning; - const _: () = { - let dont_use_gnu = WryGnuWarning; - }; -} - use crate::query::QueryResult; pub use cfg::{Config, WindowCloseBehaviour}; pub use desktop_context::DesktopContext; From 1c2a6fa010fb8c7f209a229b59750951123670a7 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Thu, 7 Dec 2023 07:19:41 -0600 Subject: [PATCH 312/447] fix signals with debug information --- packages/signals/src/signal.rs | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/packages/signals/src/signal.rs b/packages/signals/src/signal.rs index a5ee6b198..6c4052b98 100644 --- a/packages/signals/src/signal.rs +++ b/packages/signals/src/signal.rs @@ -237,9 +237,9 @@ impl Signal { /// Get the current value of the signal. **Unlike read, this will not subscribe the current scope to the signal which can cause parts of your UI to not update.** /// /// If the signal has been dropped, this will panic. - pub fn peak(&self) -> Ref { + pub fn peak(&self) -> GenerationalRef { let inner = self.inner.read(); - Ref::map(inner, |v| &v.value) + GenerationalRef::map(inner, |v| &v.value) } /// Get a mutable reference to the signal's value. @@ -439,7 +439,7 @@ impl ReadOnlySignal { /// Get the current value of the signal. **Unlike read, this will not subscribe the current scope to the signal which can cause parts of your UI to not update.** /// /// If the signal has been dropped, this will panic. - pub fn peak(&self) -> Ref { + pub fn peak(&self) -> GenerationalRef { self.inner.peak() } From df57cc7d9c69fe20566cc5a3af39add83ce5e694 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Thu, 7 Dec 2023 08:29:14 -0600 Subject: [PATCH 313/447] fix disconnects that happen while a server function is being resolved --- packages/fullstack/src/adapters/mod.rs | 38 +++++++++++++------------- 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/packages/fullstack/src/adapters/mod.rs b/packages/fullstack/src/adapters/mod.rs index 98d190919..d368b9c73 100644 --- a/packages/fullstack/src/adapters/mod.rs +++ b/packages/fullstack/src/adapters/mod.rs @@ -89,26 +89,26 @@ impl Service for ServerFnHandler { let parts = Arc::new(RwLock::new(parts)); // Because the future returned by `server_fn_handler` is `Send`, and the future returned by this function must be send, we need to spawn a new runtime - let (resp_tx, resp_rx) = tokio::sync::oneshot::channel(); let pool = get_local_pool(); - pool.spawn_pinned({ - let function = function.clone(); - let mut server_context = server_context.clone(); - server_context.parts = parts; - move || async move { - let data = match function.encoding() { - Encoding::Url | Encoding::Cbor => &body, - Encoding::GetJSON | Encoding::GetCBOR => &query, - }; - let server_function_future = function.call((), data); - let server_function_future = - ProvideServerContext::new(server_function_future, server_context.clone()); - let resp = server_function_future.await; - - resp_tx.send(resp).unwrap(); - } - }); - let result = resp_rx.await.unwrap(); + let result = pool + .spawn_pinned({ + let function = function.clone(); + let mut server_context = server_context.clone(); + server_context.parts = parts; + move || async move { + let data = match function.encoding() { + Encoding::Url | Encoding::Cbor => &body, + Encoding::GetJSON | Encoding::GetCBOR => &query, + }; + let server_function_future = function.call((), data); + let server_function_future = ProvideServerContext::new( + server_function_future, + server_context.clone(), + ); + server_function_future.await + } + }) + .await?; let mut res = http::Response::builder(); // Set the headers from the server context From adfbb6c380ba2079ed7159e9cf84175e301476c7 Mon Sep 17 00:00:00 2001 From: Pascal Date: Thu, 7 Dec 2023 16:36:20 +0100 Subject: [PATCH 314/447] improved documentation and refactored naming to be more self-explanatory --- examples/all_events.rs | 15 +- examples/callback.rs | 19 +- examples/compose.rs | 15 +- examples/error_handle.rs | 9 +- examples/eval.rs | 27 +- examples/file_explorer.rs | 11 +- examples/framework_benchmark.rs | 55 +- examples/login_form.rs | 42 +- examples/openid_connect_demo/src/oidc.rs | 11 +- .../openid_connect_demo/src/views/header.rs | 42 +- examples/rsx_compile_fail.rs | 26 +- examples/svg.rs | 30 +- examples/todomvc.rs | 15 +- packages/autofmt/src/expr.rs | 15 +- packages/cli/src/builder.rs | 109 ++-- packages/cli/src/cargo.rs | 6 +- packages/cli/src/cli/autoformat.rs | 73 +-- packages/cli/src/cli/create.rs | 15 +- packages/cli/src/plugin/interface/fs.rs | 11 +- packages/cli/src/plugin/mod.rs | 11 +- packages/cli/src/server/output.rs | 36 +- packages/cli/src/server/web/mod.rs | 13 +- packages/cli/src/tools.rs | 50 +- .../inline_props.rs | 31 +- packages/core-macro/src/props/mod.rs | 217 ++++--- packages/core-macro/src/utils.rs | 11 +- packages/core/src/create.rs | 15 +- packages/core/src/nodes.rs | 6 +- packages/core/src/virtual_dom.rs | 9 +- packages/core/tests/attr_cleanup.rs | 29 +- packages/core/tests/bubble_error.rs | 11 +- packages/core/tests/create_dom.rs | 47 +- packages/core/tests/create_fragments.rs | 13 +- packages/core/tests/diff_unkeyed_list.rs | 63 +- packages/core/tests/fuzzing.rs | 113 ++-- packages/desktop/headless_tests/rendering.rs | 11 +- packages/desktop/src/cfg.rs | 12 +- packages/desktop/src/lib.rs | 20 +- packages/desktop/src/webview.rs | 12 +- .../examples/all_terminal_events.rs | 7 +- packages/dioxus/benches/jsframework.rs | 55 +- packages/dioxus/examples/stress.rs | 55 +- .../fullstack/examples/axum-auth/src/main.rs | 13 +- .../examples/static-hydrated/src/main.rs | 6 +- .../fullstack/src/adapters/axum_adapter.rs | 19 +- .../fullstack/src/adapters/salvo_adapter.rs | 19 +- .../fullstack/src/html_storage/deserialize.rs | 15 +- packages/fullstack/src/layer.rs | 8 +- packages/fullstack/src/render.rs | 9 +- packages/fullstack/src/serve_config.rs | 16 +- packages/fullstack/src/server_context.rs | 18 +- packages/hooks/src/use_coroutine.rs | 11 +- packages/hooks/src/use_shared_state.rs | 43 +- packages/hooks/src/use_state.rs | 49 +- packages/liveview/examples/axum.rs | 6 +- packages/liveview/src/pool.rs | 15 +- packages/native-core-macro/src/lib.rs | 93 +-- packages/native-core/examples/custom_attr.rs | 13 +- packages/native-core/examples/simple.rs | 13 +- .../native-core/examples/simple_dioxus.rs | 13 +- packages/native-core/src/layout_attributes.rs | 51 +- .../src/utils/persistant_iterator.rs | 5 +- packages/native-core/tests/fuzzing.rs | 62 +- packages/rink/src/focus.rs | 51 +- packages/rink/src/hooks.rs | 90 +-- packages/rink/src/layout.rs | 11 +- packages/rink/src/prevent_default.rs | 43 +- packages/rink/src/style.rs | 34 +- packages/rink/src/widgets/button.rs | 11 +- packages/rink/src/widgets/slider.rs | 29 +- packages/router-macro/src/route.rs | 24 +- packages/router-macro/src/segment.rs | 37 +- packages/router/src/history/liveview.rs | 23 +- packages/router/src/history/web.rs | 34 +- packages/router/src/navigation.rs | 8 +- packages/router/src/routable.rs | 11 +- .../router/src/utils/use_router_internal.rs | 13 +- packages/rsx-rosetta/tests/simple.rs | 5 +- packages/rsx/src/component.rs | 18 +- packages/rsx/src/element.rs | 97 +-- .../src/hot_reload/hot_reloading_file_map.rs | 11 +- packages/rsx/src/ifmt.rs | 35 +- packages/rsx/src/lib.rs | 22 +- packages/server-macro/src/lib.rs | 9 +- packages/signals/src/effect.rs | 11 +- packages/signals/src/selector.rs | 7 +- packages/signals/tests/create.rs | 43 +- packages/signals/tests/selector.rs | 17 +- packages/web/src/cache.rs | 601 +++++++++--------- packages/web/src/dom.rs | 13 +- packages/web/src/eval.rs | 18 +- 91 files changed, 1663 insertions(+), 1553 deletions(-) diff --git a/examples/all_events.rs b/examples/all_events.rs index 594a736d5..5f3b257bb 100644 --- a/examples/all_events.rs +++ b/examples/all_events.rs @@ -43,14 +43,15 @@ const RECT_STYLE: &str = r#" fn app(cx: Scope) -> Element { let events = use_ref(cx, std::collections::VecDeque::new); - let log_event = move |event: Event| { - let mut events = events.write(); + let log_event = + move |event: Event| { + let mut events = events.write(); - if events.len() >= MAX_EVENTS { - events.pop_front(); - } - events.push_back(event); - }; + if events.len() >= MAX_EVENTS { + events.pop_front(); + } + events.push_back(event); + }; cx.render(rsx! ( div { diff --git a/examples/callback.rs b/examples/callback.rs index cb300b701..ff07607b7 100644 --- a/examples/callback.rs +++ b/examples/callback.rs @@ -5,16 +5,17 @@ fn main() { } fn app(cx: Scope) -> Element { - let login = use_callback!(cx, move |_| async move { - let res = reqwest::get("https://dog.ceo/api/breeds/list/all") - .await - .unwrap() - .text() - .await - .unwrap(); + let login = + use_callback!(cx, move |_| async move { + let res = reqwest::get("https://dog.ceo/api/breeds/list/all") + .await + .unwrap() + .text() + .await + .unwrap(); - println!("{res:#?}, "); - }); + println!("{res:#?}, "); + }); cx.render(rsx! { button { onclick: login, "Click me!" } diff --git a/examples/compose.rs b/examples/compose.rs index 3ee6d36ae..d5a5d5c90 100644 --- a/examples/compose.rs +++ b/examples/compose.rs @@ -12,14 +12,15 @@ fn app(cx: Scope) -> Element { let window = use_window(cx); let emails_sent = use_ref(cx, Vec::new); - let tx = use_coroutine(cx, |mut rx: UnboundedReceiver| { - to_owned![emails_sent]; - async move { - while let Some(message) = rx.next().await { - emails_sent.write().push(message); + let tx = + use_coroutine(cx, |mut rx: UnboundedReceiver| { + to_owned![emails_sent]; + async move { + while let Some(message) = rx.next().await { + emails_sent.write().push(message); + } } - } - }); + }); cx.render(rsx! { div { diff --git a/examples/error_handle.rs b/examples/error_handle.rs index d1fb57933..c0524f741 100644 --- a/examples/error_handle.rs +++ b/examples/error_handle.rs @@ -8,10 +8,11 @@ fn main() { fn App(cx: Scope) -> Element { let val = use_state(cx, || "0.0001"); - let num = match val.parse::() { - Err(_) => return cx.render(rsx!("Parsing failed")), - Ok(num) => num, - }; + let num = + match val.parse::() { + Err(_) => return cx.render(rsx!("Parsing failed")), + Ok(num) => num, + }; cx.render(rsx! { h1 { "The parsed value is {num}" } diff --git a/examples/eval.rs b/examples/eval.rs index 54959df69..f6a61ae15 100644 --- a/examples/eval.rs +++ b/examples/eval.rs @@ -7,25 +7,26 @@ fn main() { fn app(cx: Scope) -> Element { let eval_provider = use_eval(cx); - let future = use_future(cx, (), |_| { - to_owned![eval_provider]; - async move { - let eval = eval_provider( - r#" + let future = + use_future(cx, (), |_| { + to_owned![eval_provider]; + async move { + let eval = eval_provider( + r#" dioxus.send("Hi from JS!"); let msg = await dioxus.recv(); console.log(msg); return "hello world"; "#, - ) - .unwrap(); + ) + .unwrap(); - eval.send("Hi from Rust!".into()).unwrap(); - let res = eval.recv().await.unwrap(); - println!("{:?}", eval.await); - res - } - }); + eval.send("Hi from Rust!".into()).unwrap(); + let res = eval.recv().await.unwrap(); + println!("{:?}", eval.await); + res + } + }); match future.value() { Some(v) => cx.render(rsx!( diff --git a/examples/file_explorer.rs b/examples/file_explorer.rs index 88b37789d..cea860643 100644 --- a/examples/file_explorer.rs +++ b/examples/file_explorer.rs @@ -73,11 +73,12 @@ struct Files { impl Files { fn new() -> Self { - let mut files = Self { - path_stack: vec!["./".to_string()], - path_names: vec![], - err: None, - }; + let mut files = + Self { + path_stack: vec!["./".to_string()], + path_names: vec![], + err: None, + }; files.reload_path_list(); diff --git a/examples/framework_benchmark.rs b/examples/framework_benchmark.rs index 7e7a320a9..f1d75d8e9 100644 --- a/examples/framework_benchmark.rs +++ b/examples/framework_benchmark.rs @@ -112,33 +112,34 @@ fn ActionButton<'a>(cx: Scope<'a, ActionButtonProps<'a>>) -> Element { }) } -static ADJECTIVES: &[&str] = &[ - "pretty", - "large", - "big", - "small", - "tall", - "short", - "long", - "handsome", - "plain", - "quaint", - "clean", - "elegant", - "easy", - "angry", - "crazy", - "helpful", - "mushy", - "odd", - "unsightly", - "adorable", - "important", - "inexpensive", - "cheap", - "expensive", - "fancy", -]; +static ADJECTIVES: &[&str] = + &[ + "pretty", + "large", + "big", + "small", + "tall", + "short", + "long", + "handsome", + "plain", + "quaint", + "clean", + "elegant", + "easy", + "angry", + "crazy", + "helpful", + "mushy", + "odd", + "unsightly", + "adorable", + "important", + "inexpensive", + "cheap", + "expensive", + "fancy", + ]; static COLOURS: &[&str] = &[ "red", "yellow", "blue", "green", "pink", "brown", "purple", "brown", "white", "black", diff --git a/examples/login_form.rs b/examples/login_form.rs index 5ee47e4b5..585fe15f6 100644 --- a/examples/login_form.rs +++ b/examples/login_form.rs @@ -8,28 +8,32 @@ fn main() { } fn app(cx: Scope) -> Element { - let onsubmit = move |evt: FormEvent| { - cx.spawn(async move { - let resp = reqwest::Client::new() - .post("http://localhost:8080/login") - .form(&[ - ("username", &evt.values["username"]), - ("password", &evt.values["password"]), - ]) - .send() - .await; + let onsubmit = + move |evt: FormEvent| { + cx.spawn(async move { + let resp = + reqwest::Client::new() + .post("http://localhost:8080/login") + .form(&[ + ("username", &evt.values["username"]), + ("password", &evt.values["password"]), + ]) + .send() + .await; - match resp { - // Parse data from here, such as storing a response token - Ok(_data) => println!("Login successful!"), + match resp { + // Parse data from here, such as storing a response token + Ok(_data) => println!("Login successful!"), - //Handle any errors from the fetch here - Err(_err) => { - println!("Login failed - you need a login server running on localhost:8080.") + //Handle any errors from the fetch here + Err(_err) => { + println!( + "Login failed - you need a login server running on localhost:8080." + ) + } } - } - }); - }; + }); + }; cx.render(rsx! { h1 { "Login" } diff --git a/examples/openid_connect_demo/src/oidc.rs b/examples/openid_connect_demo/src/oidc.rs index 7fa96c14b..07c9b2314 100644 --- a/examples/openid_connect_demo/src/oidc.rs +++ b/examples/openid_connect_demo/src/oidc.rs @@ -112,11 +112,12 @@ pub async fn exchange_refresh_token( pub async fn log_out_url(id_token_hint: CoreIdToken) -> Result { let provider_metadata = init_provider_metadata().await?; - let end_session_url = provider_metadata - .additional_metadata() - .clone() - .end_session_endpoint - .unwrap(); + let end_session_url = + provider_metadata + .additional_metadata() + .clone() + .end_session_endpoint + .unwrap(); let logout_request: LogoutRequest = LogoutRequest::from(end_session_url); Ok(logout_request .set_client_id(ClientId::new(DIOXUS_FRONT_CLIENT_ID.to_string())) diff --git a/examples/openid_connect_demo/src/views/header.rs b/examples/openid_connect_demo/src/views/header.rs index 1f2c6e057..4a0ccea0d 100644 --- a/examples/openid_connect_demo/src/views/header.rs +++ b/examples/openid_connect_demo/src/views/header.rs @@ -22,29 +22,31 @@ pub fn LogOut(cx: Scope) -> Element { Some(fermi_auth_token_read) => match fermi_auth_token_read.id_token.clone() { Some(id_token) => match log_out_url_state.get() { Some(log_out_url_result) => match log_out_url_result { - Some(uri) => match uri { - Ok(uri) => { - rsx! { - Link { - onclick: move |_| { - { - AuthTokenState::persistent_set( - fermi_auth_token, - Some(AuthTokenState::default()), - ); - } - }, - to: uri.to_string(), - "Log out" + Some(uri) => { + match uri { + Ok(uri) => { + rsx! { + Link { + onclick: move |_| { + { + AuthTokenState::persistent_set( + fermi_auth_token, + Some(AuthTokenState::default()), + ); + } + }, + to: uri.to_string(), + "Log out" + } + } + } + Err(error) => { + rsx! { + div { format!{"Failed to load disconnection url: {:?}", error} } } } } - Err(error) => { - rsx! { - div { format!{"Failed to load disconnection url: {:?}", error} } - } - } - }, + } None => { rsx! { div { "Loading... Please wait" } } } diff --git a/examples/rsx_compile_fail.rs b/examples/rsx_compile_fail.rs index 40bad709b..f6df332ff 100644 --- a/examples/rsx_compile_fail.rs +++ b/examples/rsx_compile_fail.rs @@ -13,19 +13,21 @@ fn main() { } fn example(cx: Scope) -> Element { - let items = use_state(cx, || { - vec![Thing { - a: "asd".to_string(), - b: 10, - }] - }); + let items = + use_state(cx, || { + vec![Thing { + a: "asd".to_string(), + b: 10, + }] + }); - let things = use_ref(cx, || { - vec![Thing { - a: "asd".to_string(), - b: 10, - }] - }); + let things = + use_ref(cx, || { + vec![Thing { + a: "asd".to_string(), + b: 10, + }] + }); let things_list = things.read(); let mything = use_ref(cx, || Some(String::from("asd"))); diff --git a/examples/svg.rs b/examples/svg.rs index 329cbe6ae..e947c575a 100644 --- a/examples/svg.rs +++ b/examples/svg.rs @@ -63,23 +63,23 @@ pub fn Die<'a>(cx: Scope<'a, DieProps<'a>>) -> Element { let active_dots = &DOTS_FOR_VALUE[(value - 1) as usize]; let fill = if keep { HELD_COLOR } else { UNHELD_COLOR }; - let dots = DOTS - .iter() - .zip(active_dots.iter()) - .filter(|(_, &active)| active) - .map(|((x, y), _)| { - let dcx = x * OFFSET; - let dcy = y * OFFSET; + let dots = + DOTS.iter() + .zip(active_dots.iter()) + .filter(|(_, &active)| active) + .map(|((x, y), _)| { + let dcx = x * OFFSET; + let dcy = y * OFFSET; - rsx! { - circle { - cx: "{dcx}", - cy: "{dcy}", - r: "{DOT_RADIUS}", - fill: "#333" + rsx! { + circle { + cx: "{dcx}", + cy: "{dcy}", + r: "{DOT_RADIUS}", + fill: "#333" + } } - } - }); + }); cx.render(rsx! { svg { diff --git a/examples/todomvc.rs b/examples/todomvc.rs index 9ec2dc228..a5a687374 100644 --- a/examples/todomvc.rs +++ b/examples/todomvc.rs @@ -202,13 +202,14 @@ pub fn ListFooter<'a>(cx: Scope<'a, ListFooterProps<'a>>) -> Element { let active_todo_count = cx.props.active_todo_count; let active_todo_text = cx.props.active_todo_text; - let selected = |state| { - if *cx.props.filter == state { - "selected" - } else { - "false" - } - }; + let selected = + |state| { + if *cx.props.filter == state { + "selected" + } else { + "false" + } + }; cx.render(rsx! { footer { class: "footer", diff --git a/packages/autofmt/src/expr.rs b/packages/autofmt/src/expr.rs index b0257f8c3..dc8417c35 100644 --- a/packages/autofmt/src/expr.rs +++ b/packages/autofmt/src/expr.rs @@ -34,13 +34,14 @@ impl Writer<'_> { for (id, line) in self.src[start.line..end.line].iter().enumerate() { writeln!(self.out)?; // check if this is the last line - let line = { - if id == (end.line - start.line) - 1 { - &line[..end.column] - } else { - line - } - }; + let line = + { + if id == (end.line - start.line) - 1 { + &line[..end.column] + } else { + line + } + }; // trim the leading whitespace let previous_indent = crate::leading_whitespaces(line) / 4; diff --git a/packages/cli/src/builder.rs b/packages/cli/src/builder.rs index 08e636237..2352ed262 100644 --- a/packages/cli/src/builder.rs +++ b/packages/cli/src/builder.rs @@ -67,19 +67,21 @@ pub fn build(config: &CrateConfig, quiet: bool) -> Result { cmd.arg("--quiet") }; - let cmd = if config.custom_profile.is_some() { - let custom_profile = config.custom_profile.as_ref().unwrap(); - cmd.arg("--profile").arg(custom_profile) - } else { - cmd - }; + let cmd = + if config.custom_profile.is_some() { + let custom_profile = config.custom_profile.as_ref().unwrap(); + cmd.arg("--profile").arg(custom_profile) + } else { + cmd + }; - let cmd = if config.features.is_some() { - let features_str = config.features.as_ref().unwrap().join(" "); - cmd.arg("--features").arg(features_str) - } else { - cmd - }; + let cmd = + if config.features.is_some() { + let features_str = config.features.as_ref().unwrap().join(" "); + cmd.arg("--features").arg(features_str) + } else { + cmd + }; let cmd = match executable { ExecutableType::Binary(name) => cmd.arg("--bin").arg(name), @@ -92,13 +94,14 @@ pub fn build(config: &CrateConfig, quiet: bool) -> Result { // [2] Establish the output directory structure let bindgen_outdir = out_dir.join("assets").join("dioxus"); - let build_profile = if config.custom_profile.is_some() { - config.custom_profile.as_ref().unwrap() - } else if config.release { - "release" - } else { - "debug" - }; + let build_profile = + if config.custom_profile.is_some() { + config.custom_profile.as_ref().unwrap() + } else if config.release { + "release" + } else { + "debug" + }; let input_path = match executable { ExecutableType::Binary(name) | ExecutableType::Lib(name) => target_dir @@ -207,14 +210,15 @@ pub fn build(config: &CrateConfig, quiet: bool) -> Result { } // this code will copy all public file to the output dir - let copy_options = fs_extra::dir::CopyOptions { - overwrite: true, - skip_exist: false, - buffer_size: 64000, - copy_inside: false, - content_only: false, - depth: 0, - }; + let copy_options = + fs_extra::dir::CopyOptions { + overwrite: true, + skip_exist: false, + buffer_size: 64000, + copy_inside: false, + content_only: false, + depth: 0, + }; if asset_dir.is_dir() { for entry in std::fs::read_dir(asset_dir)? { let path = entry?.path(); @@ -287,20 +291,21 @@ pub fn build_desktop(config: &CrateConfig, _is_serve: bool) -> Result { - file_name = name.clone(); - config.target_dir.join(release_type).join(name) - } - crate::ExecutableType::Example(name) => { - file_name = name.clone(); - config - .target_dir - .join(release_type) - .join("examples") - .join(name) - } - }; + let mut res_path = + match &config.executable { + crate::ExecutableType::Binary(name) | crate::ExecutableType::Lib(name) => { + file_name = name.clone(); + config.target_dir.join(release_type).join(name) + } + crate::ExecutableType::Example(name) => { + file_name = name.clone(); + config + .target_dir + .join(release_type) + .join("examples") + .join(name) + } + }; let target_file = if cfg!(windows) { res_path.set_extension("exe"); @@ -396,9 +401,7 @@ fn prettier_build(cmd: subprocess::Exec) -> anyhow::Result> { match message.level { cargo_metadata::diagnostic::DiagnosticLevel::Error => { return { - Err(anyhow::anyhow!(message - .rendered - .unwrap_or("Unknown".into()))) + Err(anyhow::anyhow!(message.rendered.unwrap_or("Unknown".into()))) }; } cargo_metadata::diagnostic::DiagnosticLevel::Warning => { @@ -475,10 +478,7 @@ pub fn gen_page(config: &DioxusConfig, serve: bool) -> String { let mut script_str = String::new(); for script in script_list { - script_str.push_str(&format!( - "\n", - &script.to_str().unwrap(), - )) + script_str.push_str(&format!("\n", &script.to_str().unwrap(),)) } replace_or_insert_before("{script_include}", &script_str, " String { html = html.replace("{base_path}", base_path); } else { // If not, insert the script - html = html.replace( - " + html = + html.replace( + " import init from "/{base_path}/assets/dioxus/{app_name}.js"; init("/{base_path}/assets/dioxus/{app_name}_bg.wasm").then(wasm => {{ if (wasm.__wbindgen_start == undefined) {{ @@ -514,8 +515,8 @@ pub fn gen_page(config: &DioxusConfig, serve: bool) -> String { }}); Result { } None }) - .ok_or_else(|| { - Error::CargoError("Failed to find directory containing Cargo.toml".to_string()) - }) + .ok_or_else( + || Error::CargoError("Failed to find directory containing Cargo.toml".to_string()) + ) } /// Checks if the directory contains `Cargo.toml` diff --git a/packages/cli/src/cli/autoformat.rs b/packages/cli/src/cli/autoformat.rs index 1d1cbcd24..4f6c42751 100644 --- a/packages/cli/src/cli/autoformat.rs +++ b/packages/cli/src/cli/autoformat.rs @@ -93,47 +93,48 @@ async fn autoformat_project(check: bool) -> Result<()> { let mut files_to_format = vec![]; collect_rs_files(&crate_config.crate_dir, &mut files_to_format); - let counts = files_to_format - .into_iter() - .filter(|file| { - if file.components().any(|f| f.as_os_str() == "target") { - return false; - } - - true - }) - .map(|path| async { - let _path = path.clone(); - let res = tokio::spawn(async move { - let contents = tokio::fs::read_to_string(&path).await?; - - let edits = dioxus_autofmt::fmt_file(&contents); - let len = edits.len(); - - if !edits.is_empty() { - let out = dioxus_autofmt::apply_formats(&contents, edits); - tokio::fs::write(&path, out).await?; + let counts = + files_to_format + .into_iter() + .filter(|file| { + if file.components().any(|f| f.as_os_str() == "target") { + return false; } - Ok(len) as Result + true }) - .await; + .map(|path| async { + let _path = path.clone(); + let res = tokio::spawn(async move { + let contents = tokio::fs::read_to_string(&path).await?; - match res { - Err(err) => { - eprintln!("error formatting file: {}\n{err}", _path.display()); - None + let edits = dioxus_autofmt::fmt_file(&contents); + let len = edits.len(); + + if !edits.is_empty() { + let out = dioxus_autofmt::apply_formats(&contents, edits); + tokio::fs::write(&path, out).await?; + } + + Ok(len) as Result + }) + .await; + + match res { + Err(err) => { + eprintln!("error formatting file: {}\n{err}", _path.display()); + None + } + Ok(Err(err)) => { + eprintln!("error formatting file: {}\n{err}", _path.display()); + None + } + Ok(Ok(res)) => Some(res), } - Ok(Err(err)) => { - eprintln!("error formatting file: {}\n{err}", _path.display()); - None - } - Ok(Ok(res)) => Some(res), - } - }) - .collect::>() - .collect::>() - .await; + }) + .collect::>() + .collect::>() + .await; let files_formatted: usize = counts .into_iter() diff --git a/packages/cli/src/cli/create.rs b/packages/cli/src/cli/create.rs index 92b0334f5..4893dab80 100644 --- a/packages/cli/src/cli/create.rs +++ b/packages/cli/src/cli/create.rs @@ -35,13 +35,14 @@ impl Create { let toml_paths = [path.join("Cargo.toml"), path.join("Dioxus.toml")]; for toml_path in &toml_paths { let toml = std::fs::read_to_string(toml_path)?; - let mut toml = toml.parse::().map_err(|e| { - anyhow::anyhow!( - "failed to parse toml at {}: {}", - toml_path.display(), - e.to_string() - ) - })?; + let mut toml = + toml.parse::().map_err(|e| { + anyhow::anyhow!( + "failed to parse toml at {}: {}", + toml_path.display(), + e.to_string() + ) + })?; toml.as_table_mut().fmt(); diff --git a/packages/cli/src/plugin/interface/fs.rs b/packages/cli/src/plugin/interface/fs.rs index 5668dbe33..18918a592 100644 --- a/packages/cli/src/plugin/interface/fs.rs +++ b/packages/cli/src/plugin/interface/fs.rs @@ -67,11 +67,12 @@ impl UserData for PluginFileSystem { let file = PathBuf::from(args.0); let target = PathBuf::from(args.1); - let tar_gz = if let Ok(v) = File::open(file) { - v - } else { - return Ok(false); - }; + let tar_gz = + if let Ok(v) = File::open(file) { + v + } else { + return Ok(false); + }; let tar = GzDecoder::new(tar_gz); let mut archive = Archive::new(tar); diff --git a/packages/cli/src/plugin/mod.rs b/packages/cli/src/plugin/mod.rs index 481dd0984..97adaf08f 100644 --- a/packages/cli/src/plugin/mod.rs +++ b/packages/cli/src/plugin/mod.rs @@ -317,11 +317,12 @@ impl PluginManager { let name = i.get::<_, String>("name").unwrap(); let loader = i.get::<_, bool>("loader").unwrap(); - let text = if loader { - format!("{name} [:loader]") - } else { - name - }; + let text = + if loader { + format!("{name} [:loader]") + } else { + name + }; res.push(text); } } diff --git a/packages/cli/src/server/output.rs b/packages/cli/src/server/output.rs index 71323dd29..92a286c9a 100644 --- a/packages/cli/src/server/output.rs +++ b/packages/cli/src/server/output.rs @@ -22,12 +22,13 @@ pub fn print_console_info( options: PrettierOptions, web_info: Option, ) { - if let Ok(native_clearseq) = Command::new(if cfg!(target_os = "windows") { - "cls" - } else { - "clear" - }) - .output() + if let Ok(native_clearseq) = + Command::new(if cfg!(target_os = "windows") { + "cls" + } else { + "clear" + }) + .output() { print!("{}", String::from_utf8_lossy(&native_clearseq.stdout)); } else { @@ -46,17 +47,18 @@ pub fn print_console_info( } else { "Default" }; - let url_rewrite = if config - .dioxus_config - .web - .watcher - .index_on_404 - .unwrap_or(false) - { - "True" - } else { - "False" - }; + let url_rewrite = + if config + .dioxus_config + .web + .watcher + .index_on_404 + .unwrap_or(false) + { + "True" + } else { + "False" + }; let proxies = config.dioxus_config.web.proxy.as_ref(); diff --git a/packages/cli/src/server/web/mod.rs b/packages/cli/src/server/web/mod.rs index 0e1413597..f507f78e6 100644 --- a/packages/cli/src/server/web/mod.rs +++ b/packages/cli/src/server/web/mod.rs @@ -165,9 +165,7 @@ async fn get_rustls(config: &CrateConfig) -> Result> { get_rustls_without_mkcert(web_config)? }; - Ok(Some( - RustlsConfig::from_pem_file(cert_path, key_path).await?, - )) + Ok(Some(RustlsConfig::from_pem_file(cert_path, key_path).await?)) } fn get_rustls_with_mkcert(web_config: &WebHttpsConfig) -> Result<(String, String)> { @@ -314,10 +312,11 @@ async fn setup_router( )); // Setup routes - router = router - .route("/_dioxus/hot_reload", get(hot_reload_handler)) - .layer(cors) - .layer(Extension(ws_reload)); + router = + router + .route("/_dioxus/hot_reload", get(hot_reload_handler)) + .layer(cors) + .layer(Extension(ws_reload)); if let Some(hot_reload) = hot_reload { router = router.layer(Extension(hot_reload)) diff --git a/packages/cli/src/tools.rs b/packages/cli/src/tools.rs index 4045b236e..9b8801e0a 100644 --- a/packages/cli/src/tools.rs +++ b/packages/cli/src/tools.rs @@ -162,10 +162,11 @@ impl Tool { ) } Self::Tailwind => { - let windows_extension = match self.target_platform() { - "windows" => ".exe", - _ => "", - }; + let windows_extension = + match self.target_platform() { + "windows" => ".exe", + _ => "", + }; format!( "https://github.com/tailwindlabs/tailwindcss/releases/download/{version}/tailwindcss-{target}-x64{optional_ext}", version = self.tool_version(), @@ -280,29 +281,30 @@ impl Tool { pub fn call(&self, command: &str, args: Vec<&str>) -> anyhow::Result> { let bin_path = tools_path().join(self.name()).join(self.bin_path()); - let command_file = match self { - Tool::Binaryen => { - if cfg!(target_os = "windows") { - format!("{}.exe", command) - } else { - command.to_string() + let command_file = + match self { + Tool::Binaryen => { + if cfg!(target_os = "windows") { + format!("{}.exe", command) + } else { + command.to_string() + } } - } - Tool::Sass => { - if cfg!(target_os = "windows") { - format!("{}.bat", command) - } else { - command.to_string() + Tool::Sass => { + if cfg!(target_os = "windows") { + format!("{}.bat", command) + } else { + command.to_string() + } } - } - Tool::Tailwind => { - if cfg!(target_os = "windows") { - format!("{}.exe", command) - } else { - command.to_string() + Tool::Tailwind => { + if cfg!(target_os = "windows") { + format!("{}.exe", command) + } else { + command.to_string() + } } - } - }; + }; if !bin_path.join(&command_file).is_file() { return Err(anyhow::anyhow!("Command file not found.")); diff --git a/packages/core-macro/src/component_body_deserializers/inline_props.rs b/packages/core-macro/src/component_body_deserializers/inline_props.rs index d51132623..e56ba32b2 100644 --- a/packages/core-macro/src/component_body_deserializers/inline_props.rs +++ b/packages/core-macro/src/component_body_deserializers/inline_props.rs @@ -67,11 +67,12 @@ fn get_props_struct(component_body: &ComponentBody) -> ItemStruct { let struct_ident = Ident::new(&format!("{fn_ident}Props"), fn_ident.span()); - let first_lifetime = if let Some(GenericParam::Lifetime(lt)) = generics.params.first() { - Some(lt) - } else { - None - }; + let first_lifetime = + if let Some(GenericParam::Lifetime(lt)) = generics.params.first() { + Some(lt) + } else { + None + }; let struct_attrs = if first_lifetime.is_some() { quote! { #[derive(Props)] } @@ -250,16 +251,18 @@ fn get_function(component_body: &ComponentBody) -> ItemFn { let struct_ident = Ident::new(&format!("{fn_ident}Props"), fn_ident.span()); // Skip first arg since that's the context - let struct_field_names = inputs.iter().skip(1).filter_map(|f| match f { - FnArg::Receiver(_) => unreachable!(), // ComponentBody prohibits receiver parameters. - FnArg::Typed(pt) => Some(&pt.pat), - }); + let struct_field_names = + inputs.iter().skip(1).filter_map(|f| match f { + FnArg::Receiver(_) => unreachable!(), // ComponentBody prohibits receiver parameters. + FnArg::Typed(pt) => Some(&pt.pat), + }); - let first_lifetime = if let Some(GenericParam::Lifetime(lt)) = generics.params.first() { - Some(lt) - } else { - None - }; + let first_lifetime = + if let Some(GenericParam::Lifetime(lt)) = generics.params.first() { + Some(lt) + } else { + None + }; let (scope_lifetime, fn_generics) = if let Some(lt) = first_lifetime { (quote! { #lt, }, generics.clone()) diff --git a/packages/core-macro/src/props/mod.rs b/packages/core-macro/src/props/mod.rs index 6e6c43d66..6a87fb7ad 100644 --- a/packages/core-macro/src/props/mod.rs +++ b/packages/core-macro/src/props/mod.rs @@ -41,16 +41,10 @@ pub fn impl_my_derive(ast: &syn::DeriveInput) -> Result { } } syn::Fields::Unnamed(_) => { - return Err(Error::new( - ast.span(), - "Props is not supported for tuple structs", - )) + return Err(Error::new(ast.span(), "Props is not supported for tuple structs")) } syn::Fields::Unit => { - return Err(Error::new( - ast.span(), - "Props is not supported for unit structs", - )) + return Err(Error::new(ast.span(), "Props is not supported for unit structs")) } }, syn::Data::Enum(_) => { @@ -334,10 +328,9 @@ mod field_info { } Ok(()) } - _ => Err(Error::new_spanned( - &assign, - format!("Unknown parameter {name:?}"), - )), + _ => { + Err(Error::new_spanned(&assign, format!("Unknown parameter {name:?}"))) + } } } @@ -452,12 +445,13 @@ fn type_from_inside_option(ty: &syn::Type, check_option_name: bool) -> Option<&s if check_option_name && segment.ident != "Option" { return None; } - let generic_params = - if let syn::PathArguments::AngleBracketed(generic_params) = &segment.arguments { - generic_params - } else { - return None; - }; + let generic_params = if let syn::PathArguments::AngleBracketed(generic_params) = + &segment.arguments + { + generic_params + } else { + return None; + }; if let syn::GenericArgument::Type(ty) = generic_params.args.first()? { Some(ty) } else { @@ -562,37 +556,38 @@ mod struct_info { } syn::GenericParam::Const(_cnst) => None, }); - let builder_method_doc = match self.builder_attr.builder_method_doc { - Some(ref doc) => quote!(#doc), - None => { - let doc = format!( - " + let builder_method_doc = + match self.builder_attr.builder_method_doc { + Some(ref doc) => quote!(#doc), + None => { + let doc = format!( + " Create a builder for building `{name}`. On the builder, call {setters} to set the values of the fields. Finally, call `.build()` to create the instance of `{name}`. ", - name = self.name, - setters = { - let mut result = String::new(); - let mut is_first = true; - for field in self.included_fields() { - use std::fmt::Write; - if is_first { - is_first = false; - } else { - write!(&mut result, ", ").unwrap(); - } - write!(&mut result, "`.{}(...)`", field.name).unwrap(); - if field.builder_attr.default.is_some() { - write!(&mut result, "(optional)").unwrap(); + name = self.name, + setters = { + let mut result = String::new(); + let mut is_first = true; + for field in self.included_fields() { + use std::fmt::Write; + if is_first { + is_first = false; + } else { + write!(&mut result, ", ").unwrap(); + } + write!(&mut result, "`.{}(...)`", field.name).unwrap(); + if field.builder_attr.default.is_some() { + write!(&mut result, "(optional)").unwrap(); + } } + result } - result - } - ); - quote!(#doc) - } - }; + ); + quote!(#doc) + } + }; let builder_type_doc = if self.builder_attr.doc { match self.builder_attr.builder_type_doc { Some(ref doc) => quote!(#[doc = #doc]), @@ -623,10 +618,11 @@ Finally, call `.build()` to create the instance of `{name}`. false => quote! { self == other }, }; - let is_static = match are_there_generics { - true => quote! { false }, - false => quote! { true }, - }; + let is_static = + match are_there_generics { + true => quote! { false }, + false => quote! { true }, + }; Ok(quote! { impl #impl_generics #name #ty_generics #where_clause { @@ -711,14 +707,15 @@ Finally, call `.build()` to create the instance of `{name}`. ref builder_name, .. } = *self; - let descructuring = self.included_fields().map(|f| { - if f.ordinal == field.ordinal { - quote!(_) - } else { - let name = f.name; - quote!(#name) - } - }); + let descructuring = + self.included_fields().map(|f| { + if f.ordinal == field.ordinal { + quote!(_) + } else { + let name = f.name; + quote!(#name) + } + }); let reconstructing = self.included_fields().map(|f| f.name); let mut ty_generics: Vec = self @@ -785,16 +782,17 @@ Finally, call `.build()` to create the instance of `{name}`. // NOTE: both auto_into and strip_option affect `arg_type` and `arg_expr`, but the order of // nesting is different so we have to do this little dance. - let arg_type = if field.builder_attr.strip_option { - field.type_from_inside_option(false).ok_or_else(|| { - Error::new_spanned( - field_type, - "can't `strip_option` - field is not `Option<...>`", - ) - })? - } else { - field_type - }; + let arg_type = + if field.builder_attr.strip_option { + field.type_from_inside_option(false).ok_or_else(|| { + Error::new_spanned( + field_type, + "can't `strip_option` - field is not `Option<...>`", + ) + })? + } else { + field_type + }; let (arg_type, arg_expr) = if field.builder_attr.auto_into { ( quote!(impl ::core::convert::Into<#arg_type>), @@ -880,44 +878,45 @@ Finally, call `.build()` to create the instance of `{name}`. }) .collect(); let mut builder_generics_tuple = empty_type_tuple(); - let generics = self.modify_generics(|g| { - let index_after_lifetime_in_generics = g - .params - .iter() - .filter(|arg| matches!(arg, syn::GenericParam::Lifetime(_))) - .count(); - for f in self.included_fields() { - if f.builder_attr.default.is_some() { - // `f` is not mandatory - it does not have it's own fake `build` method, so `field` will need - // to warn about missing `field` whether or not `f` is set. - assert!( - f.ordinal != field.ordinal, - "`required_field_impl` called for optional field {}", - field.name - ); - g.params - .insert(index_after_lifetime_in_generics, f.generic_ty_param()); - builder_generics_tuple.elems.push_value(f.type_ident()); - } else if f.ordinal < field.ordinal { - // Only add a `build` method that warns about missing `field` if `f` is set. If `f` is not set, - // `f`'s `build` method will warn, since it appears earlier in the argument list. - builder_generics_tuple - .elems - .push_value(f.tuplized_type_ty_param()); - } else if f.ordinal == field.ordinal { - builder_generics_tuple.elems.push_value(empty_type()); - } else { - // `f` appears later in the argument list after `field`, so if they are both missing we will - // show a warning for `field` and not for `f` - which means this warning should appear whether - // or not `f` is set. - g.params - .insert(index_after_lifetime_in_generics, f.generic_ty_param()); - builder_generics_tuple.elems.push_value(f.type_ident()); - } + let generics = + self.modify_generics(|g| { + let index_after_lifetime_in_generics = g + .params + .iter() + .filter(|arg| matches!(arg, syn::GenericParam::Lifetime(_))) + .count(); + for f in self.included_fields() { + if f.builder_attr.default.is_some() { + // `f` is not mandatory - it does not have it's own fake `build` method, so `field` will need + // to warn about missing `field` whether or not `f` is set. + assert!( + f.ordinal != field.ordinal, + "`required_field_impl` called for optional field {}", + field.name + ); + g.params + .insert(index_after_lifetime_in_generics, f.generic_ty_param()); + builder_generics_tuple.elems.push_value(f.type_ident()); + } else if f.ordinal < field.ordinal { + // Only add a `build` method that warns about missing `field` if `f` is set. If `f` is not set, + // `f`'s `build` method will warn, since it appears earlier in the argument list. + builder_generics_tuple + .elems + .push_value(f.tuplized_type_ty_param()); + } else if f.ordinal == field.ordinal { + builder_generics_tuple.elems.push_value(empty_type()); + } else { + // `f` appears later in the argument list after `field`, so if they are both missing we will + // show a warning for `field` and not for `f` - which means this warning should appear whether + // or not `f` is set. + g.params + .insert(index_after_lifetime_in_generics, f.generic_ty_param()); + builder_generics_tuple.elems.push_value(f.type_ident()); + } - builder_generics_tuple.elems.push_punct(Default::default()); - } - }); + builder_generics_tuple.elems.push_punct(Default::default()); + } + }); let index_after_lifetime_in_generics = builder_generics .iter() @@ -1139,10 +1138,9 @@ Finally, call `.build()` to create the instance of `{name}`. self.doc = true; Ok(()) } - _ => Err(Error::new_spanned( - &assign, - format!("Unknown parameter {name:?}"), - )), + _ => { + Err(Error::new_spanned(&assign, format!("Unknown parameter {name:?}"))) + } } } syn::Expr::Path(path) => { @@ -1153,10 +1151,9 @@ Finally, call `.build()` to create the instance of `{name}`. self.doc = true; Ok(()) } - _ => Err(Error::new_spanned( - &path, - format!("Unknown parameter {name:?}"), - )), + _ => { + Err(Error::new_spanned(&path, format!("Unknown parameter {name:?}"))) + } } } syn::Expr::Call(call) => { diff --git a/packages/core-macro/src/utils.rs b/packages/core-macro/src/utils.rs index 7e066f773..114a07e73 100644 --- a/packages/core-macro/src/utils.rs +++ b/packages/core-macro/src/utils.rs @@ -31,9 +31,9 @@ pub fn format_type_string(ty: &Type) -> String { // This should always be valid syntax. // Not Rust code, but syntax, which is the only thing that `syn` cares about. - let Ok(file_unformatted) = syn::parse_file(&format!( - "{FORMATTED_TYPE_START}{ty_unformatted}{FORMATTED_TYPE_END}" - )) else { + let Ok(file_unformatted) = + syn::parse_file(&format!("{FORMATTED_TYPE_START}{ty_unformatted}{FORMATTED_TYPE_END}")) + else { return ty_unformatted.to_string(); }; @@ -60,10 +60,7 @@ impl DeprecatedAttribute { /// Returns `None` if the given attribute was not a valid form of the `#[deprecated]` attribute. pub fn from_meta(meta: &Meta) -> syn::Result { if meta.path() != &parse_quote!(deprecated) { - return Err(syn::Error::new( - meta.span(), - "attribute path is not `deprecated`", - )); + return Err(syn::Error::new(meta.span(), "attribute path is not `deprecated`")); } match &meta { diff --git a/packages/core/src/create.rs b/packages/core/src/create.rs index a61a8cace..b68cd6086 100644 --- a/packages/core/src/create.rs +++ b/packages/core/src/create.rs @@ -36,13 +36,14 @@ fn sort_bfs(paths: &[&'static [u8]]) -> Vec<(usize, &'static [u8])> { #[test] #[cfg(debug_assertions)] fn sorting() { - let r: [(usize, &[u8]); 5] = [ - (0, &[0, 1]), - (1, &[0, 2]), - (2, &[1, 0]), - (3, &[1, 0, 1]), - (4, &[1, 2]), - ]; + let r: [(usize, &[u8]); 5] = + [ + (0, &[0, 1]), + (1, &[0, 2]), + (2, &[1, 0]), + (3, &[1, 0, 1]), + (4, &[1, 2]), + ]; assert_eq!( sort_bfs(&[&[0, 1,], &[0, 2,], &[1, 0,], &[1, 0, 1,], &[1, 2,],]), r diff --git a/packages/core/src/nodes.rs b/packages/core/src/nodes.rs index c83b1059a..a1c6e7be9 100644 --- a/packages/core/src/nodes.rs +++ b/packages/core/src/nodes.rs @@ -531,9 +531,9 @@ impl<'a> From<&'a AttributeValue<'a>> for BorrowedAttributeValue<'a> { } AttributeValue::Any(value) => { let value = value.borrow(); - BorrowedAttributeValue::Any(std::cell::Ref::map(value, |value| { - &**value.as_ref().unwrap() - })) + BorrowedAttributeValue::Any( + std::cell::Ref::map(value, |value| &**value.as_ref().unwrap()) + ) } AttributeValue::None => BorrowedAttributeValue::None, } diff --git a/packages/core/src/virtual_dom.rs b/packages/core/src/virtual_dom.rs index 2d83ba63a..4c8adfdb6 100644 --- a/packages/core/src/virtual_dom.rs +++ b/packages/core/src/virtual_dom.rs @@ -267,10 +267,11 @@ impl VirtualDom { suspended_scopes: Default::default(), }; - let root = dom.new_scope( - Box::new(VProps::new(root, |_, _| unreachable!(), root_props)), - "app", - ); + let root = + dom.new_scope( + Box::new(VProps::new(root, |_, _| unreachable!(), root_props)), + "app", + ); // Unlike react, we provide a default error boundary that just renders the error as a string root.provide_context(Rc::new(ErrorBoundary::new(ScopeId::ROOT))); diff --git a/packages/core/tests/attr_cleanup.rs b/packages/core/tests/attr_cleanup.rs index 539a0b399..ea8135dd6 100644 --- a/packages/core/tests/attr_cleanup.rs +++ b/packages/core/tests/attr_cleanup.rs @@ -9,20 +9,23 @@ use dioxus_core::BorrowedAttributeValue; #[test] fn attrs_cycle() { - let mut dom = VirtualDom::new(|cx| { - let id = cx.generation(); - match cx.generation() % 2 { - 0 => cx.render(rsx! { - div {} - }), - 1 => cx.render(rsx! { - div { - h1 { class: "{id}", id: "{id}" } + let mut dom = + VirtualDom::new(|cx| { + let id = cx.generation(); + match cx.generation() % 2 { + 0 => { + cx.render(rsx! { + div {} + }) } - }), - _ => unreachable!(), - } - }); + 1 => cx.render(rsx! { + div { + h1 { class: "{id}", id: "{id}" } + } + }), + _ => unreachable!(), + } + }); let bump = Bump::new(); diff --git a/packages/core/tests/bubble_error.rs b/packages/core/tests/bubble_error.rs index af2a34219..901f93f46 100644 --- a/packages/core/tests/bubble_error.rs +++ b/packages/core/tests/bubble_error.rs @@ -3,11 +3,12 @@ use dioxus::prelude::*; fn app(cx: Scope) -> Element { - let raw = match cx.generation() % 2 { - 0 => "123.123", - 1 => "123.123.123", - _ => unreachable!(), - }; + let raw = + match cx.generation() % 2 { + 0 => "123.123", + 1 => "123.123.123", + _ => unreachable!(), + }; let value = raw.parse::().unwrap_or(123.123); diff --git a/packages/core/tests/create_dom.rs b/packages/core/tests/create_dom.rs index 5e5005d3f..b923a9eec 100644 --- a/packages/core/tests/create_dom.rs +++ b/packages/core/tests/create_dom.rs @@ -11,15 +11,16 @@ use dioxus_core::ElementId; #[test] fn test_original_diff() { - let mut dom = VirtualDom::new(|cx| { - cx.render(rsx! { - div { + let mut dom = + VirtualDom::new(|cx| { + cx.render(rsx! { div { - "Hello, world!" + div { + "Hello, world!" + } } - } - }) - }); + }) + }); let edits = dom.rebuild().santize(); @@ -82,11 +83,12 @@ fn create() { #[test] fn create_list() { - let mut dom = VirtualDom::new(|cx| { - cx.render(rsx! { - (0..3).map(|f| rsx!( div { "hello" } )) - }) - }); + let mut dom = + VirtualDom::new(|cx| { + cx.render(rsx! { + (0..3).map(|f| rsx!( div { "hello" } )) + }) + }); let _edits = dom.rebuild().santize(); @@ -160,16 +162,17 @@ fn create_components() { #[test] fn anchors() { - let mut dom = VirtualDom::new(|cx| { - cx.render(rsx! { - if true { - rsx!( div { "hello" } ) - } - if false { - rsx!( div { "goodbye" } ) - } - }) - }); + let mut dom = + VirtualDom::new(|cx| { + cx.render(rsx! { + if true { + rsx!( div { "hello" } ) + } + if false { + rsx!( div { "goodbye" } ) + } + }) + }); // note that the template under "false" doesn't show up since it's not loaded let edits = dom.rebuild().santize(); diff --git a/packages/core/tests/create_fragments.rs b/packages/core/tests/create_fragments.rs index ee312f34b..4e94fddbe 100644 --- a/packages/core/tests/create_fragments.rs +++ b/packages/core/tests/create_fragments.rs @@ -24,12 +24,13 @@ fn empty_fragment_creates_nothing() { #[test] fn root_fragments_work() { - let mut vdom = VirtualDom::new(|cx| { - cx.render(rsx!( - div { "hello" } - div { "goodbye" } - )) - }); + let mut vdom = + VirtualDom::new(|cx| { + cx.render(rsx!( + div { "hello" } + div { "goodbye" } + )) + }); assert_eq!( vdom.rebuild().edits.last().unwrap(), diff --git a/packages/core/tests/diff_unkeyed_list.rs b/packages/core/tests/diff_unkeyed_list.rs index b5be161ef..d51ecf452 100644 --- a/packages/core/tests/diff_unkeyed_list.rs +++ b/packages/core/tests/diff_unkeyed_list.rs @@ -4,17 +4,18 @@ use pretty_assertions::assert_eq; #[test] fn list_creates_one_by_one() { - let mut dom = VirtualDom::new(|cx| { - let gen = cx.generation(); + let mut dom = + VirtualDom::new(|cx| { + let gen = cx.generation(); - cx.render(rsx! { - div { - (0..gen).map(|i| rsx! { - div { "{i}" } - }) - } - }) - }); + cx.render(rsx! { + div { + (0..gen).map(|i| rsx! { + div { "{i}" } + }) + } + }) + }); // load the div and then assign the empty fragment as a placeholder assert_eq!( @@ -73,17 +74,18 @@ fn list_creates_one_by_one() { #[test] fn removes_one_by_one() { - let mut dom = VirtualDom::new(|cx| { - let gen = 3 - cx.generation() % 4; + let mut dom = + VirtualDom::new(|cx| { + let gen = 3 - cx.generation() % 4; - cx.render(rsx! { - div { - (0..gen).map(|i| rsx! { - div { "{i}" } - }) - } - }) - }); + cx.render(rsx! { + div { + (0..gen).map(|i| rsx! { + div { "{i}" } + }) + } + }) + }); // load the div and then assign the empty fragment as a placeholder assert_eq!( @@ -150,16 +152,17 @@ fn removes_one_by_one() { #[test] fn list_shrink_multiroot() { - let mut dom = VirtualDom::new(|cx| { - cx.render(rsx! { - div { - (0..cx.generation()).map(|i| rsx! { - div { "{i}" } - div { "{i}" } - }) - } - }) - }); + let mut dom = + VirtualDom::new(|cx| { + cx.render(rsx! { + div { + (0..cx.generation()).map(|i| rsx! { + div { "{i}" } + div { "{i}" } + }) + } + }) + }); assert_eq!( dom.rebuild().santize().edits, diff --git a/packages/core/tests/fuzzing.rs b/packages/core/tests/fuzzing.rs index 1523c4e22..4338a49c1 100644 --- a/packages/core/tests/fuzzing.rs +++ b/packages/core/tests/fuzzing.rs @@ -8,9 +8,7 @@ fn random_ns() -> Option<&'static str> { let namespace = rand::random::() % 2; match namespace { 0 => None, - 1 => Some(Box::leak( - format!("ns{}", rand::random::()).into_boxed_str(), - )), + 1 => Some(Box::leak(format!("ns{}", rand::random::()).into_boxed_str())), _ => unreachable!(), } } @@ -22,13 +20,15 @@ fn create_random_attribute(attr_idx: &mut usize) -> TemplateAttribute<'static> { value: Box::leak(format!("value{}", rand::random::()).into_boxed_str()), namespace: random_ns(), }, - 1 => TemplateAttribute::Dynamic { - id: { - let old_idx = *attr_idx; - *attr_idx += 1; - old_idx - }, - }, + 1 => { + TemplateAttribute::Dynamic { + id: { + let old_idx = *attr_idx; + *attr_idx += 1; + old_idx + }, + } + } _ => unreachable!(), } } @@ -73,22 +73,26 @@ fn create_random_template_node( 1 => TemplateNode::Text { text: Box::leak(format!("{}", rand::random::()).into_boxed_str()), }, - 2 => TemplateNode::DynamicText { - id: { - let old_idx = *template_idx; - *template_idx += 1; - dynamic_node_types.push(DynamicNodeType::Text); - old_idx - }, - }, - 3 => TemplateNode::Dynamic { - id: { - let old_idx = *template_idx; - *template_idx += 1; - dynamic_node_types.push(DynamicNodeType::Other); - old_idx - }, - }, + 2 => { + TemplateNode::DynamicText { + id: { + let old_idx = *template_idx; + *template_idx += 1; + dynamic_node_types.push(DynamicNodeType::Text); + old_idx + }, + } + } + 3 => { + TemplateNode::Dynamic { + id: { + let old_idx = *template_idx; + *template_idx += 1; + dynamic_node_types.push(DynamicNodeType::Other); + old_idx + }, + } + } _ => unreachable!(), } } @@ -207,9 +211,9 @@ fn create_random_dynamic_node(cx: &ScopeState, depth: usize) -> DynamicNode { fn create_random_dynamic_attr(cx: &ScopeState) -> Attribute { let value = match rand::random::() % 7 { - 0 => AttributeValue::Text(Box::leak( - format!("{}", rand::random::()).into_boxed_str(), - )), + 0 => { + AttributeValue::Text(Box::leak(format!("{}", rand::random::()).into_boxed_str())) + } 1 => AttributeValue::Float(rand::random()), 2 => AttributeValue::Int(rand::random()), 3 => AttributeValue::Bool(rand::random()), @@ -272,31 +276,32 @@ fn create_random_element(cx: Scope) -> Element { .into_boxed_str(), )); // println!("{template:#?}"); - let node = VNode { - key: None, - parent: None, - template: Cell::new(template), - root_ids: bumpalo::collections::Vec::new_in(cx.bump()).into(), - dynamic_nodes: { - let dynamic_nodes: Vec<_> = dynamic_node_types - .iter() - .map(|ty| match ty { - DynamicNodeType::Text => DynamicNode::Text(VText::new(Box::leak( - format!("{}", rand::random::()).into_boxed_str(), - ))), - DynamicNodeType::Other => { - create_random_dynamic_node(cx, cx.props.depth + 1) - } - }) - .collect(); - cx.bump().alloc(dynamic_nodes) - }, - dynamic_attrs: cx.bump().alloc( - (0..template.attr_paths.len()) - .map(|_| create_random_dynamic_attr(cx)) - .collect::>(), - ), - }; + let node = + VNode { + key: None, + parent: None, + template: Cell::new(template), + root_ids: bumpalo::collections::Vec::new_in(cx.bump()).into(), + dynamic_nodes: { + let dynamic_nodes: Vec<_> = dynamic_node_types + .iter() + .map(|ty| match ty { + DynamicNodeType::Text => DynamicNode::Text(VText::new(Box::leak( + format!("{}", rand::random::()).into_boxed_str(), + ))), + DynamicNodeType::Other => { + create_random_dynamic_node(cx, cx.props.depth + 1) + } + }) + .collect(); + cx.bump().alloc(dynamic_nodes) + }, + dynamic_attrs: cx.bump().alloc( + (0..template.attr_paths.len()) + .map(|_| create_random_dynamic_attr(cx)) + .collect::>(), + ), + }; Some(node) } _ => None, diff --git a/packages/desktop/headless_tests/rendering.rs b/packages/desktop/headless_tests/rendering.rs index 0907121d4..31dc28256 100644 --- a/packages/desktop/headless_tests/rendering.rs +++ b/packages/desktop/headless_tests/rendering.rs @@ -34,12 +34,13 @@ fn use_inner_html(cx: &ScopeState, id: &'static str) -> Option { to_owned![value, eval_provider]; async move { tokio::time::sleep(std::time::Duration::from_millis(100)).await; - let html = eval_provider(&format!( - r#"let element = document.getElementById('{}'); + let html = + eval_provider(&format!( + r#"let element = document.getElementById('{}'); return element.innerHTML"#, - id - )) - .unwrap(); + id + )) + .unwrap(); if let Ok(serde_json::Value::String(html)) = html.await { println!("html: {}", html); value.set(Some(html)); diff --git a/packages/desktop/src/cfg.rs b/packages/desktop/src/cfg.rs index ba42ffa01..3b0409ae8 100644 --- a/packages/desktop/src/cfg.rs +++ b/packages/desktop/src/cfg.rs @@ -36,7 +36,7 @@ pub struct Config { pub(crate) root_name: String, pub(crate) background_color: Option<(u8, u8, u8, u8)>, pub(crate) last_window_close_behaviour: WindowCloseBehaviour, - pub(crate) disable_default_menu_bar: bool, + pub(crate) enable_default_menu_bar: bool, } type DropHandler = Box bool>; @@ -66,13 +66,15 @@ impl Config { root_name: "main".to_string(), background_color: None, last_window_close_behaviour: WindowCloseBehaviour::LastWindowExitsApp, - disable_default_menu_bar: false, + enable_default_menu_bar: true, } } - /// Set whether the default menu bar should be disabled. - pub fn with_disable_default_menu_bar(mut self, disable: bool) -> Self { - self.disable_default_menu_bar = disable; + /// Set whether the default menu bar should be enabled. + /// + /// > Note: `enable` is `true` by default. To disable the default menu bar pass `false`. + pub fn with_default_menu_bar(mut self, enable: bool) -> Self { + self.enable_default_menu_bar = enable; self } diff --git a/packages/desktop/src/lib.rs b/packages/desktop/src/lib.rs index 63a8914f3..7b8f024be 100644 --- a/packages/desktop/src/lib.rs +++ b/packages/desktop/src/lib.rs @@ -240,18 +240,20 @@ pub fn launch_with_props(root: Component

, props: P, cfg: Config) Event::UserEvent(event) => match event.0 { #[cfg(all(feature = "hot-reload", debug_assertions))] - EventData::HotReloadEvent(msg) => match msg { - dioxus_hot_reload::HotReloadMsg::UpdateTemplate(template) => { - for webview in webviews.values_mut() { - webview.dom.replace_template(template); + EventData::HotReloadEvent(msg) => { + match msg { + dioxus_hot_reload::HotReloadMsg::UpdateTemplate(template) => { + for webview in webviews.values_mut() { + webview.dom.replace_template(template); - poll_vdom(webview); + poll_vdom(webview); + } + } + dioxus_hot_reload::HotReloadMsg::Shutdown => { + *control_flow = ControlFlow::Exit; } } - dioxus_hot_reload::HotReloadMsg::Shutdown => { - *control_flow = ControlFlow::Exit; - } - }, + } EventData::CloseWindow => { webviews.remove(&event.1); diff --git a/packages/desktop/src/webview.rs b/packages/desktop/src/webview.rs index 9beae702a..f03878242 100644 --- a/packages/desktop/src/webview.rs +++ b/packages/desktop/src/webview.rs @@ -19,8 +19,8 @@ pub fn build( let index_file = cfg.custom_index.clone(); let root_name = cfg.root_name.clone(); - if !cfg.disable_default_menu_bar { - builder = builder.with_menu(create_default_menu_bar()); + if cfg.enable_default_menu_bar { + builder = builder.with_menu(build_default_menu_bar()); } let window = builder.with_visible(false).build(event_loop).unwrap(); @@ -103,8 +103,12 @@ pub fn build( (webview.build().unwrap(), web_context) } -/// Creates a standard menu bar depending on the platform -fn create_default_menu_bar() -> MenuBar { +/// Builds a standard menu bar depending on the users platform. It may be used as a starting point +/// to further customize the menu bar and pass it to a [`WindowBuilder`](tao::window::WindowBuilder). +/// > Note: The default menu bar enables macOS shortcuts like cut/copy/paste. +/// > The menu bar differs per platform because of constraints introduced +/// > by [`MenuItem`](tao::menu::MenuItem). +pub fn build_default_menu_bar() -> MenuBar { let mut menu_bar = MenuBar::new(); // since it is uncommon on windows to have an "application menu" diff --git a/packages/dioxus-tui/examples/all_terminal_events.rs b/packages/dioxus-tui/examples/all_terminal_events.rs index 483e9afdf..dd160c9b7 100644 --- a/packages/dioxus-tui/examples/all_terminal_events.rs +++ b/packages/dioxus-tui/examples/all_terminal_events.rs @@ -40,9 +40,10 @@ fn app(cx: Scope) -> Element { rsx!(p { "{trimmed}" }) }); - let log_event = move |event: Event| { - events.write().push(event); - }; + let log_event = + move |event: Event| { + events.write().push(event); + }; cx.render(rsx! { div { diff --git a/packages/dioxus/benches/jsframework.rs b/packages/dioxus/benches/jsframework.rs index b3405b2bd..e313cdee6 100644 --- a/packages/dioxus/benches/jsframework.rs +++ b/packages/dioxus/benches/jsframework.rs @@ -87,33 +87,34 @@ impl Label { } } -static ADJECTIVES: &[&str] = &[ - "pretty", - "large", - "big", - "small", - "tall", - "short", - "long", - "handsome", - "plain", - "quaint", - "clean", - "elegant", - "easy", - "angry", - "crazy", - "helpful", - "mushy", - "odd", - "unsightly", - "adorable", - "important", - "inexpensive", - "cheap", - "expensive", - "fancy", -]; +static ADJECTIVES: &[&str] = + &[ + "pretty", + "large", + "big", + "small", + "tall", + "short", + "long", + "handsome", + "plain", + "quaint", + "clean", + "elegant", + "easy", + "angry", + "crazy", + "helpful", + "mushy", + "odd", + "unsightly", + "adorable", + "important", + "inexpensive", + "cheap", + "expensive", + "fancy", + ]; static COLOURS: &[&str] = &[ "red", "yellow", "blue", "green", "pink", "brown", "purple", "brown", "white", "black", diff --git a/packages/dioxus/examples/stress.rs b/packages/dioxus/examples/stress.rs index 248d851d2..ef0bbbf6c 100644 --- a/packages/dioxus/examples/stress.rs +++ b/packages/dioxus/examples/stress.rs @@ -62,33 +62,34 @@ impl Label { } } -static ADJECTIVES: &[&str] = &[ - "pretty", - "large", - "big", - "small", - "tall", - "short", - "long", - "handsome", - "plain", - "quaint", - "clean", - "elegant", - "easy", - "angry", - "crazy", - "helpful", - "mushy", - "odd", - "unsightly", - "adorable", - "important", - "inexpensive", - "cheap", - "expensive", - "fancy", -]; +static ADJECTIVES: &[&str] = + &[ + "pretty", + "large", + "big", + "small", + "tall", + "short", + "long", + "handsome", + "plain", + "quaint", + "clean", + "elegant", + "easy", + "angry", + "crazy", + "helpful", + "mushy", + "odd", + "unsightly", + "adorable", + "important", + "inexpensive", + "cheap", + "expensive", + "fancy", + ]; static COLOURS: &[&str] = &[ "red", "yellow", "blue", "green", "pink", "brown", "purple", "brown", "white", "black", diff --git a/packages/fullstack/examples/axum-auth/src/main.rs b/packages/fullstack/examples/axum-auth/src/main.rs index 6643f718b..ea7a0efe0 100644 --- a/packages/fullstack/examples/axum-auth/src/main.rs +++ b/packages/fullstack/examples/axum-auth/src/main.rs @@ -37,12 +37,13 @@ fn main() { //To enable Private cookies for integrity, and authenticity please check the next Example. let session_config = SessionConfig::default().with_table_name("test_table"); let auth_config = AuthConfig::::default().with_anonymous_user_id(Some(1)); - let session_store = SessionStore::::new( - Some(pool.clone().into()), - session_config, - ) - .await - .unwrap(); + let session_store = + SessionStore::::new( + Some(pool.clone().into()), + session_config, + ) + .await + .unwrap(); //Create the Database table for storing our Session Data. session_store.initiate().await.unwrap(); diff --git a/packages/fullstack/examples/static-hydrated/src/main.rs b/packages/fullstack/examples/static-hydrated/src/main.rs index 2539d0deb..536971524 100644 --- a/packages/fullstack/examples/static-hydrated/src/main.rs +++ b/packages/fullstack/examples/static-hydrated/src/main.rs @@ -16,9 +16,9 @@ use serde::{Deserialize, Serialize}; #[tokio::main] async fn main() { pre_cache_static_routes_with_props( - &ServeConfigBuilder::new_with_router(dioxus_fullstack::router::FullstackRouterConfig::< - Route, - >::default()) + &ServeConfigBuilder::new_with_router( + dioxus_fullstack::router::FullstackRouterConfig::::default() + ) .assets_path("docs") .incremental(IncrementalRendererConfig::default().static_dir("docs")) .build(), diff --git a/packages/fullstack/src/adapters/axum_adapter.rs b/packages/fullstack/src/adapters/axum_adapter.rs index 41a7c92be..089784c94 100644 --- a/packages/fullstack/src/adapters/axum_adapter.rs +++ b/packages/fullstack/src/adapters/axum_adapter.rs @@ -280,12 +280,13 @@ where let assets_path = assets_path.into(); // Serve all files in dist folder except index.html - let dir = std::fs::read_dir(&assets_path).unwrap_or_else(|e| { - panic!( - "Couldn't read assets directory at {:?}: {}", - &assets_path, e - ) - }); + let dir = + std::fs::read_dir(&assets_path).unwrap_or_else(|e| { + panic!( + "Couldn't read assets directory at {:?}: {}", + &assets_path, e + ) + }); for entry in dir.flatten() { let path = entry.path(); @@ -297,9 +298,9 @@ where .unwrap() .iter() .map(|segment| { - segment.to_str().unwrap_or_else(|| { - panic!("Failed to convert path segment {:?} to string", segment) - }) + segment.to_str().unwrap_or_else( + || panic!("Failed to convert path segment {:?} to string", segment) + ) }) .collect::>() .join("/"); diff --git a/packages/fullstack/src/adapters/salvo_adapter.rs b/packages/fullstack/src/adapters/salvo_adapter.rs index 674722665..9953a1192 100644 --- a/packages/fullstack/src/adapters/salvo_adapter.rs +++ b/packages/fullstack/src/adapters/salvo_adapter.rs @@ -244,12 +244,13 @@ impl DioxusRouterExt for Router { let assets_path = assets_path.into(); // Serve all files in dist folder except index.html - let dir = std::fs::read_dir(&assets_path).unwrap_or_else(|e| { - panic!( - "Couldn't read assets directory at {:?}: {}", - &assets_path, e - ) - }); + let dir = + std::fs::read_dir(&assets_path).unwrap_or_else(|e| { + panic!( + "Couldn't read assets directory at {:?}: {}", + &assets_path, e + ) + }); for entry in dir.flatten() { let path = entry.path(); @@ -261,9 +262,9 @@ impl DioxusRouterExt for Router { .unwrap() .iter() .map(|segment| { - segment.to_str().unwrap_or_else(|| { - panic!("Failed to convert path segment {:?} to string", segment) - }) + segment.to_str().unwrap_or_else( + || panic!("Failed to convert path segment {:?} to string", segment) + ) }) .collect::>() .join("/"); diff --git a/packages/fullstack/src/html_storage/deserialize.rs b/packages/fullstack/src/html_storage/deserialize.rs index 7fc70ba6c..1c860a7a2 100644 --- a/packages/fullstack/src/html_storage/deserialize.rs +++ b/packages/fullstack/src/html_storage/deserialize.rs @@ -7,13 +7,14 @@ use super::HTMLDataCursor; #[allow(unused)] pub(crate) fn serde_from_bytes(string: &[u8]) -> Option { - let decompressed = match STANDARD.decode(string) { - Ok(bytes) => bytes, - Err(err) => { - tracing::error!("Failed to decode base64: {}", err); - return None; - } - }; + let decompressed = + match STANDARD.decode(string) { + Ok(bytes) => bytes, + Err(err) => { + tracing::error!("Failed to decode base64: {}", err); + return None; + } + }; match postcard::from_bytes(&decompressed) { Ok(data) => Some(data), diff --git a/packages/fullstack/src/layer.rs b/packages/fullstack/src/layer.rs index 10e67b3f5..3b68fa2d6 100644 --- a/packages/fullstack/src/layer.rs +++ b/packages/fullstack/src/layer.rs @@ -46,11 +46,9 @@ where > + Send, >, > { - let fut = self.call(req).instrument(tracing::trace_span!( - "service", - "{}", - std::any::type_name::() - )); + let fut = self.call(req).instrument( + tracing::trace_span!("service", "{}", std::any::type_name::()) + ); Box::pin(async move { fut.await.map_err(|err| err.into()) }) } } diff --git a/packages/fullstack/src/render.rs b/packages/fullstack/src/render.rs index cda41f82c..f14b97acc 100644 --- a/packages/fullstack/src/render.rs +++ b/packages/fullstack/src/render.rs @@ -91,10 +91,11 @@ impl SsrRendererPool { Ok((freshness, html)) } Self::Incremental(pool) => { - let mut renderer = - pool.write().unwrap().pop().unwrap_or_else(|| { - incremental_pre_renderer(cfg.incremental.as_ref().unwrap()) - }); + let mut renderer = pool + .write() + .unwrap() + .pop() + .unwrap_or_else(|| incremental_pre_renderer(cfg.incremental.as_ref().unwrap())); let (tx, rx) = tokio::sync::oneshot::channel(); diff --git a/packages/fullstack/src/serve_config.rs b/packages/fullstack/src/serve_config.rs index 75a473c89..4d1a3c007 100644 --- a/packages/fullstack/src/serve_config.rs +++ b/packages/fullstack/src/serve_config.rs @@ -122,14 +122,16 @@ fn load_index_html(path: PathBuf, root_id: &'static str) -> IndexHtml { let (pre_main, post_main) = contents.split_once(&format!("id=\"{root_id}\"")).unwrap_or_else(|| panic!("Failed to find id=\"{root_id}\" in index.html. The id is used to inject the application into the page.")); - let post_main = post_main.split_once('>').unwrap_or_else(|| { - panic!("Failed to find closing > after id=\"{root_id}\" in index.html.") - }); + let post_main = + post_main.split_once('>').unwrap_or_else( + || panic!("Failed to find closing > after id=\"{root_id}\" in index.html.") + ); - let (pre_main, post_main) = ( - pre_main.to_string() + &format!("id=\"{root_id}\"") + post_main.0 + ">", - post_main.1.to_string(), - ); + let (pre_main, post_main) = + ( + pre_main.to_string() + &format!("id=\"{root_id}\"") + post_main.0 + ">", + post_main.1.to_string(), + ); IndexHtml { pre_main, diff --git a/packages/fullstack/src/server_context.rs b/packages/fullstack/src/server_context.rs index 6f3b4b6c9..7d1bc63fe 100644 --- a/packages/fullstack/src/server_context.rs +++ b/packages/fullstack/src/server_context.rs @@ -22,9 +22,9 @@ impl Default for DioxusServerContext { fn default() -> Self { Self { shared_context: std::sync::Arc::new(std::sync::RwLock::new(anymap::Map::new())), - response_parts: std::sync::Arc::new(RwLock::new( - http::response::Response::new(()).into_parts().0, - )), + response_parts: std::sync::Arc::new( + RwLock::new(http::response::Response::new(()).into_parts().0) + ), parts: std::sync::Arc::new(RwLock::new(http::request::Request::new(()).into_parts().0)), html_data: Arc::new(RwLock::new(HTMLData::default())), } @@ -45,9 +45,9 @@ mod server_fn_impl { Self { parts: parts.into(), shared_context: Arc::new(RwLock::new(SendSyncAnyMap::new())), - response_parts: std::sync::Arc::new(RwLock::new( - http::response::Response::new(()).into_parts().0, - )), + response_parts: std::sync::Arc::new( + RwLock::new(http::response::Response::new(()).into_parts().0) + ), html_data: Arc::new(RwLock::new(HTMLData::default())), } } @@ -221,9 +221,9 @@ impl FromServerContext for FromContext { type Rejection = NotFoundInServerContext; async fn from_request(req: &DioxusServerContext) -> Result { - Ok(Self(req.clone().get::().ok_or_else(|| { - NotFoundInServerContext::(std::marker::PhantomData::) - })?)) + Ok(Self(req.clone().get::().ok_or_else( + || NotFoundInServerContext::(std::marker::PhantomData::) + )?)) } } diff --git a/packages/hooks/src/use_coroutine.rs b/packages/hooks/src/use_coroutine.rs index f2577b90c..c7990d0d1 100644 --- a/packages/hooks/src/use_coroutine.rs +++ b/packages/hooks/src/use_coroutine.rs @@ -129,11 +129,12 @@ mod tests { use futures_util::StreamExt; fn app(cx: Scope, name: String) -> Element { - let task = use_coroutine(cx, |mut rx: UnboundedReceiver| async move { - while let Some(msg) = rx.next().await { - println!("got message: {msg}"); - } - }); + let task = + use_coroutine(cx, |mut rx: UnboundedReceiver| async move { + while let Some(msg) = rx.next().await { + println!("got message: {msg}"); + } + }); let task2 = use_coroutine(cx, view_task); diff --git a/packages/hooks/src/use_shared_state.rs b/packages/hooks/src/use_shared_state.rs index 37226c759..54b7f720f 100644 --- a/packages/hooks/src/use_shared_state.rs +++ b/packages/hooks/src/use_shared_state.rs @@ -226,10 +226,12 @@ impl UseSharedState { pub fn read(&self) -> Ref<'_, T> { match self.try_read() { Ok(value) => value, - Err(message) => panic!( - "Reading the shared state failed: {}\n({:?})", - message, message - ), + Err(message) => { + panic!( + "Reading the shared state failed: {}\n({:?})", + message, message + ) + } } } @@ -258,10 +260,12 @@ impl UseSharedState { pub fn write(&self) -> RefMut<'_, T> { match self.try_write() { Ok(value) => value, - Err(message) => panic!( - "Writing to shared state failed: {}\n({:?})", - message, message - ), + Err(message) => { + panic!( + "Writing to shared state failed: {}\n({:?})", + message, message + ) + } } } @@ -284,10 +288,12 @@ impl UseSharedState { pub fn write_silent(&self) -> RefMut<'_, T> { match self.try_write_silent() { Ok(value) => value, - Err(message) => panic!( - "Writing to shared state silently failed: {}\n({:?})", - message, message - ), + Err(message) => { + panic!( + "Writing to shared state silently failed: {}\n({:?})", + message, message + ) + } } } @@ -363,12 +369,13 @@ impl PartialEq for UseSharedState { /// ``` pub fn use_shared_state_provider(cx: &ScopeState, f: impl FnOnce() -> T) { cx.use_hook(|| { - let state: ProvidedState = Rc::new(RefCell::new(ProvidedStateInner { - value: f(), - notify_any: cx.schedule_update_any(), - consumers: HashSet::new(), - gen: 0, - })); + let state: ProvidedState = + Rc::new(RefCell::new(ProvidedStateInner { + value: f(), + notify_any: cx.schedule_update_any(), + consumers: HashSet::new(), + gen: 0, + })); cx.provide_context(state); }); diff --git a/packages/hooks/src/use_state.rs b/packages/hooks/src/use_state.rs index 254493510..21120abf0 100644 --- a/packages/hooks/src/use_state.rs +++ b/packages/hooks/src/use_state.rs @@ -35,36 +35,37 @@ pub fn use_state( cx: &ScopeState, initial_state_fn: impl FnOnce() -> T, ) -> &UseState { - let hook = cx.use_hook(move || { - let current_val = Rc::new(initial_state_fn()); - let update_callback = cx.schedule_update(); - let slot = Rc::new(RefCell::new(current_val.clone())); - let setter = Rc::new({ - to_owned![update_callback, slot]; - move |new| { - { - let mut slot = slot.borrow_mut(); + let hook = + cx.use_hook(move || { + let current_val = Rc::new(initial_state_fn()); + let update_callback = cx.schedule_update(); + let slot = Rc::new(RefCell::new(current_val.clone())); + let setter = Rc::new({ + to_owned![update_callback, slot]; + move |new| { + { + let mut slot = slot.borrow_mut(); - // if there's only one reference (weak or otherwise), we can just swap the values - // Typically happens when the state is set multiple times - we don't want to create a new Rc for each new value - if let Some(val) = Rc::get_mut(&mut slot) { - *val = new; - } else { - *slot = Rc::new(new); + // if there's only one reference (weak or otherwise), we can just swap the values + // Typically happens when the state is set multiple times - we don't want to create a new Rc for each new value + if let Some(val) = Rc::get_mut(&mut slot) { + *val = new; + } else { + *slot = Rc::new(new); + } } + update_callback(); } - update_callback(); + }); + + UseState { + current_val, + update_callback, + setter, + slot, } }); - UseState { - current_val, - update_callback, - setter, - slot, - } - }); - hook.current_val = hook.slot.borrow().clone(); hook diff --git a/packages/liveview/examples/axum.rs b/packages/liveview/examples/axum.rs index 6584d5e9b..b188e8270 100644 --- a/packages/liveview/examples/axum.rs +++ b/packages/liveview/examples/axum.rs @@ -37,9 +37,9 @@ async fn main() { .route( "/", get(move || async move { - index_page_with_glue(&dioxus_liveview::interpreter_glue(&format!( - "ws://{addr}/ws" - ))) + index_page_with_glue( + &dioxus_liveview::interpreter_glue(&format!("ws://{addr}/ws")) + ) }), ) .route( diff --git a/packages/liveview/src/pool.rs b/packages/liveview/src/pool.rs index 2fd06cec6..05e892f47 100644 --- a/packages/liveview/src/pool.rs +++ b/packages/liveview/src/pool.rs @@ -112,13 +112,14 @@ impl LiveViewSocket for S where /// You might need to transform the error types of the web backend into the LiveView error type. pub async fn run(mut vdom: VirtualDom, ws: impl LiveViewSocket) -> Result<(), LiveViewError> { #[cfg(all(feature = "hot-reload", debug_assertions))] - let mut hot_reload_rx = { - let (tx, rx) = tokio::sync::mpsc::unbounded_channel(); - dioxus_hot_reload::connect(move |template| { - let _ = tx.send(template); - }); - rx - }; + let mut hot_reload_rx = + { + let (tx, rx) = tokio::sync::mpsc::unbounded_channel(); + dioxus_hot_reload::connect(move |template| { + let _ = tx.send(template); + }); + rx + }; // Create the a proxy for query engine let (query_tx, mut query_rx) = tokio::sync::mpsc::unbounded_channel(); diff --git a/packages/native-core-macro/src/lib.rs b/packages/native-core-macro/src/lib.rs index fdaa12cf5..3d5ba4464 100644 --- a/packages/native-core-macro/src/lib.rs +++ b/packages/native-core-macro/src/lib.rs @@ -66,12 +66,13 @@ pub fn partial_derive_state(_: TokenStream, input: TokenStream) -> TokenStream { Some(tuple) => { let mut parent_dependencies = Vec::new(); for type_ in &tuple.elems { - let mut type_ = extract_type_path(type_).unwrap_or_else(|| { - panic!( - "ParentDependencies must be a tuple of type paths, found {}", - quote!(#type_) - ) - }); + let mut type_ = + extract_type_path(type_).unwrap_or_else(|| { + panic!( + "ParentDependencies must be a tuple of type paths, found {}", + quote!(#type_) + ) + }); if type_ == self_path { type_ = this_type.clone(); } @@ -80,21 +81,24 @@ pub fn partial_derive_state(_: TokenStream, input: TokenStream) -> TokenStream { } parent_dependencies } - _ => panic!( - "ParentDependencies must be a tuple, found {}", - quote!(#parent_dependencies) - ), + _ => { + panic!( + "ParentDependencies must be a tuple, found {}", + quote!(#parent_dependencies) + ) + } }; let child_dependencies = match extract_tuple(child_dependencies) { Some(tuple) => { let mut child_dependencies = Vec::new(); for type_ in &tuple.elems { - let mut type_ = extract_type_path(type_).unwrap_or_else(|| { - panic!( - "ChildDependencies must be a tuple of type paths, found {}", - quote!(#type_) - ) - }); + let mut type_ = + extract_type_path(type_).unwrap_or_else(|| { + panic!( + "ChildDependencies must be a tuple of type paths, found {}", + quote!(#type_) + ) + }); if type_ == self_path { type_ = this_type.clone(); } @@ -103,34 +107,39 @@ pub fn partial_derive_state(_: TokenStream, input: TokenStream) -> TokenStream { } child_dependencies } - _ => panic!( - "ChildDependencies must be a tuple, found {}", - quote!(#child_dependencies) - ), - }; - let node_dependencies = match extract_tuple(node_dependencies) { - Some(tuple) => { - let mut node_dependencies = Vec::new(); - for type_ in &tuple.elems { - let mut type_ = extract_type_path(type_).unwrap_or_else(|| { - panic!( - "NodeDependencies must be a tuple of type paths, found {}", - quote!(#type_) - ) - }); - if type_ == self_path { - type_ = this_type.clone(); - } - combined_dependencies.insert(type_.clone()); - node_dependencies.push(type_); - } - node_dependencies + _ => { + panic!( + "ChildDependencies must be a tuple, found {}", + quote!(#child_dependencies) + ) } - _ => panic!( - "NodeDependencies must be a tuple, found {}", - quote!(#node_dependencies) - ), }; + let node_dependencies = + match extract_tuple(node_dependencies) { + Some(tuple) => { + let mut node_dependencies = Vec::new(); + for type_ in &tuple.elems { + let mut type_ = extract_type_path(type_).unwrap_or_else(|| { + panic!( + "NodeDependencies must be a tuple of type paths, found {}", + quote!(#type_) + ) + }); + if type_ == self_path { + type_ = this_type.clone(); + } + combined_dependencies.insert(type_.clone()); + node_dependencies.push(type_); + } + node_dependencies + } + _ => { + panic!( + "NodeDependencies must be a tuple, found {}", + quote!(#node_dependencies) + ) + } + }; combined_dependencies.insert(this_type.clone()); let combined_dependencies: Vec<_> = combined_dependencies.into_iter().collect(); diff --git a/packages/native-core/examples/custom_attr.rs b/packages/native-core/examples/custom_attr.rs index e7bbb36ea..1089766ed 100644 --- a/packages/native-core/examples/custom_attr.rs +++ b/packages/native-core/examples/custom_attr.rs @@ -160,12 +160,13 @@ impl State for Border { _context: &SendAnyMap, ) -> bool { // check if the node contians a border attribute - let new = Self( - node_view - .attributes() - .and_then(|mut attrs| attrs.next().map(|a| a.attribute.name == "border")) - .is_some(), - ); + let new = + Self( + node_view + .attributes() + .and_then(|mut attrs| attrs.next().map(|a| a.attribute.name == "border")) + .is_some(), + ); // check if the member has changed let changed = new != *self; *self = new; diff --git a/packages/native-core/examples/simple.rs b/packages/native-core/examples/simple.rs index 276d06d08..02ce83886 100644 --- a/packages/native-core/examples/simple.rs +++ b/packages/native-core/examples/simple.rs @@ -151,12 +151,13 @@ impl State for Border { _context: &SendAnyMap, ) -> bool { // check if the node contians a border attribute - let new = Self( - node_view - .attributes() - .and_then(|mut attrs| attrs.next().map(|a| a.attribute.name == "border")) - .is_some(), - ); + let new = + Self( + node_view + .attributes() + .and_then(|mut attrs| attrs.next().map(|a| a.attribute.name == "border")) + .is_some(), + ); // check if the member has changed let changed = new != *self; *self = new; diff --git a/packages/native-core/examples/simple_dioxus.rs b/packages/native-core/examples/simple_dioxus.rs index af0e4ca00..d3f1cdfcb 100644 --- a/packages/native-core/examples/simple_dioxus.rs +++ b/packages/native-core/examples/simple_dioxus.rs @@ -152,12 +152,13 @@ impl State for Border { _context: &SendAnyMap, ) -> bool { // check if the node contians a border attribute - let new = Self( - node_view - .attributes() - .and_then(|mut attrs| attrs.next().map(|a| a.attribute.name == "border")) - .is_some(), - ); + let new = + Self( + node_view + .attributes() + .and_then(|mut attrs| attrs.next().map(|a| a.attribute.name == "border")) + .is_some(), + ); // check if the member has changed let changed = new != *self; *self = new; diff --git a/packages/native-core/src/layout_attributes.rs b/packages/native-core/src/layout_attributes.rs index 4eb39292b..c5c2c2aa4 100644 --- a/packages/native-core/src/layout_attributes.rs +++ b/packages/native-core/src/layout_attributes.rs @@ -340,26 +340,27 @@ pub fn apply_layout_attributes_cfg( } Property::JustifyContent(justify, _) => { use AlignContent::*; - style.justify_content = match justify { - align::JustifyContent::ContentDistribution(distribution) => { - match distribution { - align::ContentDistribution::SpaceBetween => Some(SpaceBetween), - align::ContentDistribution::SpaceAround => Some(SpaceAround), - align::ContentDistribution::SpaceEvenly => Some(SpaceEvenly), - _ => return, + style.justify_content = + match justify { + align::JustifyContent::ContentDistribution(distribution) => { + match distribution { + align::ContentDistribution::SpaceBetween => Some(SpaceBetween), + align::ContentDistribution::SpaceAround => Some(SpaceAround), + align::ContentDistribution::SpaceEvenly => Some(SpaceEvenly), + _ => return, + } } - } - align::JustifyContent::ContentPosition { - value: position, .. - } => match position { - align::ContentPosition::Center => Some(Center), - align::ContentPosition::Start => Some(Start), - align::ContentPosition::FlexStart => Some(FlexStart), - align::ContentPosition::End => Some(End), - align::ContentPosition::FlexEnd => Some(FlexEnd), - }, - _ => return, - }; + align::JustifyContent::ContentPosition { + value: position, .. + } => match position { + align::ContentPosition::Center => Some(Center), + align::ContentPosition::Start => Some(Start), + align::ContentPosition::FlexStart => Some(FlexStart), + align::ContentPosition::End => Some(End), + align::ContentPosition::FlexEnd => Some(FlexEnd), + }, + _ => return, + }; } Property::AlignSelf(align, _) => { use AlignItems::*; @@ -585,11 +586,13 @@ fn convert_grid_track_size(input: grid::TrackSize) -> NonRepeatedTrackSizingFunc convert_track_breadth_min(&min), convert_track_breadth_max(&max), ), - grid::TrackSize::FitContent(limit) => match limit { - DimensionPercentage::Dimension(LengthValue::Px(len)) => minmax(auto(), points(len)), - DimensionPercentage::Percentage(Percentage(pct)) => minmax(auto(), percent(pct)), - _ => unimplemented!(), - }, + grid::TrackSize::FitContent(limit) => { + match limit { + DimensionPercentage::Dimension(LengthValue::Px(len)) => minmax(auto(), points(len)), + DimensionPercentage::Percentage(Percentage(pct)) => minmax(auto(), percent(pct)), + _ => unimplemented!(), + } + } } } diff --git a/packages/native-core/src/utils/persistant_iterator.rs b/packages/native-core/src/utils/persistant_iterator.rs index 2442af29f..fbaab5bed 100644 --- a/packages/native-core/src/utils/persistant_iterator.rs +++ b/packages/native-core/src/utils/persistant_iterator.rs @@ -488,8 +488,5 @@ fn persist_instertions_after() { )); let text = "hello world".to_string(); let idx = iter.next(&rdom).id(); - assert!(matches!( - &*rdom.get(idx).unwrap().node_type(), - NodeType::Text(text) - )); + assert!(matches!(&*rdom.get(idx).unwrap().node_type(), NodeType::Text(text))); } diff --git a/packages/native-core/tests/fuzzing.rs b/packages/native-core/tests/fuzzing.rs index 4f0a34b70..6c56178f8 100644 --- a/packages/native-core/tests/fuzzing.rs +++ b/packages/native-core/tests/fuzzing.rs @@ -9,9 +9,7 @@ fn random_ns() -> Option<&'static str> { let namespace = rand::random::() % 2; match namespace { 0 => None, - 1 => Some(Box::leak( - format!("ns{}", rand::random::()).into_boxed_str(), - )), + 1 => Some(Box::leak(format!("ns{}", rand::random::()).into_boxed_str())), _ => unreachable!(), } } @@ -23,13 +21,15 @@ fn create_random_attribute(attr_idx: &mut usize) -> TemplateAttribute<'static> { value: Box::leak(format!("value{}", rand::random::()).into_boxed_str()), namespace: random_ns(), }, - 1 => TemplateAttribute::Dynamic { - id: { - let old_idx = *attr_idx; - *attr_idx += 1; - old_idx - }, - }, + 1 => { + TemplateAttribute::Dynamic { + id: { + let old_idx = *attr_idx; + *attr_idx += 1; + old_idx + }, + } + } _ => unreachable!(), } } @@ -74,22 +74,26 @@ fn create_random_template_node( 1 => TemplateNode::Text { text: Box::leak(format!("{}", rand::random::()).into_boxed_str()), }, - 2 => TemplateNode::DynamicText { - id: { - let old_idx = *template_idx; - *template_idx += 1; - dynamic_node_types.push(DynamicNodeType::Text); - old_idx - }, - }, - 3 => TemplateNode::Dynamic { - id: { - let old_idx = *template_idx; - *template_idx += 1; - dynamic_node_types.push(DynamicNodeType::Other); - old_idx - }, - }, + 2 => { + TemplateNode::DynamicText { + id: { + let old_idx = *template_idx; + *template_idx += 1; + dynamic_node_types.push(DynamicNodeType::Text); + old_idx + }, + } + } + 3 => { + TemplateNode::Dynamic { + id: { + let old_idx = *template_idx; + *template_idx += 1; + dynamic_node_types.push(DynamicNodeType::Other); + old_idx + }, + } + } _ => unreachable!(), } } @@ -206,9 +210,9 @@ fn create_random_dynamic_node(cx: &ScopeState, depth: usize) -> DynamicNode { fn create_random_dynamic_attr(cx: &ScopeState) -> Attribute { let value = match rand::random::() % 6 { - 0 => AttributeValue::Text(Box::leak( - format!("{}", rand::random::()).into_boxed_str(), - )), + 0 => { + AttributeValue::Text(Box::leak(format!("{}", rand::random::()).into_boxed_str())) + } 1 => AttributeValue::Float(rand::random()), 2 => AttributeValue::Int(rand::random()), 3 => AttributeValue::Bool(rand::random()), diff --git a/packages/rink/src/focus.rs b/packages/rink/src/focus.rs index 704d13b46..3f1ebb2d8 100644 --- a/packages/rink/src/focus.rs +++ b/packages/rink/src/focus.rs @@ -83,36 +83,37 @@ impl State for Focus { _: &SendAnyMap, ) -> bool { let new = Focus { - level: if let Some(a) = node_view - .attributes() - .and_then(|mut a| a.find(|a| a.attribute.name == "tabindex")) - { - if let Some(index) = a - .value - .as_int() - .or_else(|| a.value.as_text().and_then(|v| v.parse::().ok())) + level: + if let Some(a) = node_view + .attributes() + .and_then(|mut a| a.find(|a| a.attribute.name == "tabindex")) { - match index.cmp(&0) { - Ordering::Less => FocusLevel::Unfocusable, - Ordering::Equal => FocusLevel::Focusable, - Ordering::Greater => { - FocusLevel::Ordered(NonZeroU16::new(index as u16).unwrap()) + if let Some(index) = a + .value + .as_int() + .or_else(|| a.value.as_text().and_then(|v| v.parse::().ok())) + { + match index.cmp(&0) { + Ordering::Less => FocusLevel::Unfocusable, + Ordering::Equal => FocusLevel::Focusable, + Ordering::Greater => { + FocusLevel::Ordered(NonZeroU16::new(index as u16).unwrap()) + } } + } else { + FocusLevel::Unfocusable } + } else if node_view + .listeners() + .and_then( + |mut listeners| listeners.any(|l| FOCUS_EVENTS.contains(&l)).then_some(()) + ) + .is_some() + { + FocusLevel::Focusable } else { FocusLevel::Unfocusable - } - } else if node_view - .listeners() - .and_then(|mut listeners| { - listeners.any(|l| FOCUS_EVENTS.contains(&l)).then_some(()) - }) - .is_some() - { - FocusLevel::Focusable - } else { - FocusLevel::Unfocusable - }, + }, }; if *self != new { *self = new; diff --git a/packages/rink/src/hooks.rs b/packages/rink/src/hooks.rs index f8c4500d2..7afed77e4 100644 --- a/packages/rink/src/hooks.rs +++ b/packages/rink/src/hooks.rs @@ -585,13 +585,14 @@ impl RinkInputHandler { let queued_events = Rc::new(RefCell::new(Vec::new())); let queued_events2 = Rc::downgrade(&queued_events); - let regester_event = move |evt: crossterm::event::Event| { - if let Some(evt) = get_event(evt) { - if let Some(v) = queued_events2.upgrade() { - (*v).borrow_mut().push(evt); + let regester_event = + move |evt: crossterm::event::Event| { + if let Some(evt) = get_event(evt) { + if let Some(v) = queued_events2.upgrade() { + (*v).borrow_mut().push(evt); + } } - } - }; + }; let state = Rc::new(RefCell::new(InnerInputState::create(rdom))); @@ -680,48 +681,49 @@ fn get_event(evt: TermEvent) -> Option<(&'static str, EventData)> { let ctrl = m.modifiers.contains(KeyModifiers::CONTROL); let meta = false; - let get_mouse_data = |crossterm_button: Option| { - let button = crossterm_button.map(|b| match b { - MouseButton::Left => DioxusMouseButton::Primary, - MouseButton::Right => DioxusMouseButton::Secondary, - MouseButton::Middle => DioxusMouseButton::Auxiliary, - }); + let get_mouse_data = + |crossterm_button: Option| { + let button = crossterm_button.map(|b| match b { + MouseButton::Left => DioxusMouseButton::Primary, + MouseButton::Right => DioxusMouseButton::Secondary, + MouseButton::Middle => DioxusMouseButton::Auxiliary, + }); - // from https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent + // from https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent - // The `page` and `screen` coordinates are inconsistent with the MDN definition, as they are relative to the viewport (client), not the target element/page/screen, respectively. - // todo? - // But then, MDN defines them in terms of pixels, yet crossterm provides only row/column, and it might not be possible to get pixels. So we can't get 100% consistency anyway. - let coordinates = Coordinates::new( - ScreenPoint::new(x, y), - ClientPoint::new(x, y), - // offset x/y are set when the origin of the event is assigned to an element - ElementPoint::new(0., 0.), - PagePoint::new(x, y), - ); + // The `page` and `screen` coordinates are inconsistent with the MDN definition, as they are relative to the viewport (client), not the target element/page/screen, respectively. + // todo? + // But then, MDN defines them in terms of pixels, yet crossterm provides only row/column, and it might not be possible to get pixels. So we can't get 100% consistency anyway. + let coordinates = Coordinates::new( + ScreenPoint::new(x, y), + ClientPoint::new(x, y), + // offset x/y are set when the origin of the event is assigned to an element + ElementPoint::new(0., 0.), + PagePoint::new(x, y), + ); - let mut modifiers = Modifiers::empty(); - if shift { - modifiers.insert(Modifiers::SHIFT); - } - if ctrl { - modifiers.insert(Modifiers::CONTROL); - } - if meta { - modifiers.insert(Modifiers::META); - } - if alt { - modifiers.insert(Modifiers::ALT); - } + let mut modifiers = Modifiers::empty(); + if shift { + modifiers.insert(Modifiers::SHIFT); + } + if ctrl { + modifiers.insert(Modifiers::CONTROL); + } + if meta { + modifiers.insert(Modifiers::META); + } + if alt { + modifiers.insert(Modifiers::ALT); + } - // held mouse buttons get set later by maintaining state, as crossterm does not provide them - EventData::Mouse(MouseData::new( - coordinates, - button, - DioxusMouseButtons::empty(), - modifiers, - )) - }; + // held mouse buttons get set later by maintaining state, as crossterm does not provide them + EventData::Mouse(MouseData::new( + coordinates, + button, + DioxusMouseButtons::empty(), + modifiers, + )) + }; let get_wheel_data = |up| { let y = if up { -1.0 } else { 1.0 }; diff --git a/packages/rink/src/layout.rs b/packages/rink/src/layout.rs index dbdadac3f..f9a29408e 100644 --- a/packages/rink/src/layout.rs +++ b/packages/rink/src/layout.rs @@ -195,11 +195,12 @@ impl State for TaffyLayout { taffy.set_children(n, &child_layout).unwrap(); } } else { - self.node = PossiblyUninitalized::Initialized( - taffy - .new_with_children(scaled_style, &child_layout) - .unwrap(), - ); + self.node = + PossiblyUninitalized::Initialized( + taffy + .new_with_children(scaled_style, &child_layout) + .unwrap(), + ); changed = true; } } diff --git a/packages/rink/src/prevent_default.rs b/packages/rink/src/prevent_default.rs index 4ad5ad87f..d42516d9f 100644 --- a/packages/rink/src/prevent_default.rs +++ b/packages/rink/src/prevent_default.rs @@ -43,27 +43,28 @@ impl State for PreventDefault { _: Vec<::ElementBorrowed<'a>>, _: &SendAnyMap, ) -> bool { - let new = match node_view.attributes().and_then(|mut attrs| { - attrs - .find(|a| a.attribute.name == "dioxus-prevent-default") - .and_then(|a| a.value.as_text()) - }) { - Some("onfocus") => PreventDefault::Focus, - Some("onkeypress") => PreventDefault::KeyPress, - Some("onkeyrelease") => PreventDefault::KeyRelease, - Some("onkeydown") => PreventDefault::KeyDown, - Some("onkeyup") => PreventDefault::KeyUp, - Some("onclick") => PreventDefault::Click, - Some("onmousedown") => PreventDefault::MouseDown, - Some("onmouseup") => PreventDefault::MouseUp, - Some("onmouseenter") => PreventDefault::MouseEnter, - Some("onmouseover") => PreventDefault::MouseOver, - Some("onmouseleave") => PreventDefault::MouseLeave, - Some("onmouseout") => PreventDefault::MouseOut, - Some("onwheel") => PreventDefault::Wheel, - Some("oncontextmenu") => PreventDefault::ContextMenu, - _ => return false, - }; + let new = + match node_view.attributes().and_then(|mut attrs| { + attrs + .find(|a| a.attribute.name == "dioxus-prevent-default") + .and_then(|a| a.value.as_text()) + }) { + Some("onfocus") => PreventDefault::Focus, + Some("onkeypress") => PreventDefault::KeyPress, + Some("onkeyrelease") => PreventDefault::KeyRelease, + Some("onkeydown") => PreventDefault::KeyDown, + Some("onkeyup") => PreventDefault::KeyUp, + Some("onclick") => PreventDefault::Click, + Some("onmousedown") => PreventDefault::MouseDown, + Some("onmouseup") => PreventDefault::MouseUp, + Some("onmouseenter") => PreventDefault::MouseEnter, + Some("onmouseover") => PreventDefault::MouseOver, + Some("onmouseleave") => PreventDefault::MouseLeave, + Some("onmouseout") => PreventDefault::MouseOut, + Some("onwheel") => PreventDefault::Wheel, + Some("oncontextmenu") => PreventDefault::ContextMenu, + _ => return false, + }; if new == *self { false } else { diff --git a/packages/rink/src/style.rs b/packages/rink/src/style.rs index 905cc4b34..efd300774 100644 --- a/packages/rink/src/style.rs +++ b/packages/rink/src/style.rs @@ -350,24 +350,26 @@ pub fn convert(mode: RenderingMode, c: Color) -> Color { let rgb = to_rgb(c); Color::Rgb(rgb[0], rgb[1], rgb[2]) } - crate::RenderingMode::Ansi => match c { - Color::Indexed(_) => c, - _ => { - let rgb = to_rgb(c); - // 16-231: 6 Γ— 6 Γ— 6 color cube - // 232-255: 23 step grayscale - if rgb[0] == rgb[1] && rgb[1] == rgb[2] { - let idx = 232 + (rgb[0] as u16 * 23 / 255) as u8; - Color::Indexed(idx) - } else { - let r = (rgb[0] as u16 * 5) / 255; - let g = (rgb[1] as u16 * 5) / 255; - let b = (rgb[2] as u16 * 5) / 255; - let idx = 16 + r * 36 + g * 6 + b; - Color::Indexed(idx as u8) + crate::RenderingMode::Ansi => { + match c { + Color::Indexed(_) => c, + _ => { + let rgb = to_rgb(c); + // 16-231: 6 Γ— 6 Γ— 6 color cube + // 232-255: 23 step grayscale + if rgb[0] == rgb[1] && rgb[1] == rgb[2] { + let idx = 232 + (rgb[0] as u16 * 23 / 255) as u8; + Color::Indexed(idx) + } else { + let r = (rgb[0] as u16 * 5) / 255; + let g = (rgb[1] as u16 * 5) / 255; + let b = (rgb[2] as u16 * 5) / 255; + let idx = 16 + r * 36 + g * 6 + b; + Color::Indexed(idx as u8) + } } } - }, + } } } } diff --git a/packages/rink/src/widgets/button.rs b/packages/rink/src/widgets/button.rs index 523b2392a..bc1b16c9f 100644 --- a/packages/rink/src/widgets/button.rs +++ b/packages/rink/src/widgets/button.rs @@ -90,11 +90,12 @@ impl Button { } fn switch(&mut self, ctx: &WidgetContext, node: NodeMut) { - let data = FormData { - value: self.value.to_string(), - values: HashMap::new(), - files: None, - }; + let data = + FormData { + value: self.value.to_string(), + values: HashMap::new(), + files: None, + }; ctx.send(crate::Event { id: node.id(), name: "input", diff --git a/packages/rink/src/widgets/slider.rs b/packages/rink/src/widgets/slider.rs index 7080b6c12..1ed4f903e 100644 --- a/packages/rink/src/widgets/slider.rs +++ b/packages/rink/src/widgets/slider.rs @@ -236,10 +236,11 @@ impl Slider { let id = root.id(); let rdom = root.real_dom_mut(); let world = rdom.raw_world_mut(); - let taffy = { - let query: UniqueView = world.borrow().unwrap(); - query.stretch.clone() - }; + let taffy = + { + let query: UniqueView = world.borrow().unwrap(); + query.stretch.clone() + }; let taffy = taffy.lock().unwrap(); @@ -267,10 +268,11 @@ impl CustomElement for Slider { panic!("input must be an element") }; - let value = el.attributes.get(&OwnedAttributeDiscription { - name: "value".to_string(), - namespace: None, - }); + let value = + el.attributes.get(&OwnedAttributeDiscription { + name: "value".to_string(), + namespace: None, + }); let value = value .and_then(|value| match value { OwnedAttributeValue::Text(text) => text.as_str().parse().ok(), @@ -301,11 +303,12 @@ impl CustomElement for Slider { let cursor_text = rdom.create_node("|".to_string()); let cursor_text_id = cursor_text.id(); - let mut cursor_span = rdom.create_node(NodeType::Element(ElementNode { - tag: "div".to_string(), - attributes: [].into_iter().collect(), - ..Default::default() - })); + let mut cursor_span = + rdom.create_node(NodeType::Element(ElementNode { + tag: "div".to_string(), + attributes: [].into_iter().collect(), + ..Default::default() + })); cursor_span.add_child(cursor_text_id); let cursor_span_id = cursor_span.id(); diff --git a/packages/router-macro/src/route.rs b/packages/router-macro/src/route.rs index 26665e575..dd2689698 100644 --- a/packages/router-macro/src/route.rs +++ b/packages/router-macro/src/route.rs @@ -144,13 +144,14 @@ impl Route { _ => Vec::new(), }; - let (route_segments, query) = { - parse_route_segments( - variant.ident.span(), - fields.iter().map(|f| (&f.0, &f.1)), - &route, - )? - }; + let (route_segments, query) = + { + parse_route_segments( + variant.ident.span(), + fields.iter().map(|f| (&f.0, &f.1)), + &route, + )? + }; Ok(Self { ty, @@ -323,10 +324,11 @@ impl Route { pub fn error_type(&self) -> TokenStream2 { let error_name = self.error_ident(); - let child_type = match &self.ty { - RouteType::Child(field) => Some(&field.ty), - RouteType::Leaf { .. } => None, - }; + let child_type = + match &self.ty { + RouteType::Child(field) => Some(&field.ty), + RouteType::Leaf { .. } => None, + }; create_error_type(error_name, &self.segments, child_type) } diff --git a/packages/router-macro/src/segment.rs b/packages/router-macro/src/segment.rs index 7e4e40662..510bc13a2 100644 --- a/packages/router-macro/src/segment.rs +++ b/packages/router-macro/src/segment.rs @@ -135,10 +135,11 @@ pub fn parse_route_segments<'a>( ) -> syn::Result<(Vec, Option)> { let mut route_segments = Vec::new(); - let (route_string, query) = match route.rsplit_once('?') { - Some((route, query)) => (route, Some(query)), - None => (route, None), - }; + let (route_string, query) = + match route.rsplit_once('?') { + Some((route, query)) => (route, Some(query)), + None => (route, None), + }; let mut iterator = route_string.split('/'); // skip the first empty segment @@ -157,11 +158,12 @@ pub fn parse_route_segments<'a>( if let Some(segment) = segment.strip_prefix(':') { let spread = segment.starts_with(".."); - let ident = if spread { - segment[2..].to_string() - } else { - segment.to_string() - }; + let ident = + if spread { + segment[2..].to_string() + } else { + segment.to_string() + }; let field = fields.find(|(name, _)| **name == ident); @@ -205,14 +207,15 @@ pub fn parse_route_segments<'a>( let query_ident = Ident::new(query, Span::call_site()); let field = fields.find(|(name, _)| *name == &query_ident); - let ty = if let Some((_, ty)) = field { - ty.clone() - } else { - return Err(syn::Error::new( - route_span, - format!("Could not find a field with the name '{}'", query_ident), - )); - }; + let ty = + if let Some((_, ty)) = field { + ty.clone() + } else { + return Err(syn::Error::new( + route_span, + format!("Could not find a field with the name '{}'", query_ident), + )); + }; Some(QuerySegment { ident: query_ident, diff --git a/packages/router/src/history/liveview.rs b/packages/router/src/history/liveview.rs index 9ffb09c34..a7ecc89f6 100644 --- a/packages/router/src/history/liveview.rs +++ b/packages/router/src/history/liveview.rs @@ -77,17 +77,18 @@ where self.routes.retain(|&lhs, _| lhs <= last_visited); } }; - let state = match state { - Some(state) => { - self.current_index = state.index; - state - } - None => { - let index = depth - 1; - self.current_index = index; - State { index } - } - }; + let state = + match state { + Some(state) => { + self.current_index = state.index; + state + } + None => { + let index = depth - 1; + self.current_index = index; + State { index } + } + }; self.routes.insert(state.index, route); state } diff --git a/packages/router/src/history/web.rs b/packages/router/src/history/web.rs index 789eed76e..80cde3173 100644 --- a/packages/router/src/history/web.rs +++ b/packages/router/src/history/web.rs @@ -302,15 +302,16 @@ where let s = self.listener_animation_frame.clone(); let d = self.do_scroll_restoration; - self.listener_navigation = Some(EventListener::new(&self.window, "popstate", move |_| { - (*callback)(); - if d { - let mut s = s.lock().expect("unpoisoned scroll mutex"); - if let Some(current_state) = get_current::>(&h) { - *s = Some(current_state.scroll.scroll_to(w.clone())); + self.listener_navigation = + Some(EventListener::new(&self.window, "popstate", move |_| { + (*callback)(); + if d { + let mut s = s.lock().expect("unpoisoned scroll mutex"); + if let Some(current_state) = get_current::>(&h) { + *s = Some(current_state.scroll.scroll_to(w.clone())); + } } - } - })); + })); } } @@ -377,14 +378,15 @@ where let s = self.listener_animation_frame.clone(); let d = self.do_scroll_restoration; - self.listener_navigation = Some(EventListener::new(&self.window, "popstate", move |_| { - (*callback)(); - if d { - let mut s = s.lock().expect("unpoisoned scroll mutex"); - if let Some([x, y]) = get_current(&h) { - *s = Some(ScrollPosition { x, y }.scroll_to(w.clone())); + self.listener_navigation = + Some(EventListener::new(&self.window, "popstate", move |_| { + (*callback)(); + if d { + let mut s = s.lock().expect("unpoisoned scroll mutex"); + if let Some([x, y]) = get_current(&h) { + *s = Some(ScrollPosition { x, y }.scroll_to(w.clone())); + } } - } - })); + })); } } diff --git a/packages/router/src/navigation.rs b/packages/router/src/navigation.rs index 2d7a3f90f..e84a8b381 100644 --- a/packages/router/src/navigation.rs +++ b/packages/router/src/navigation.rs @@ -114,11 +114,9 @@ impl FromStr for NavigationTarget { fn from_str(s: &str) -> Result { match Url::parse(s) { Ok(_) => Ok(Self::External(s.to_string())), - Err(ParseError::RelativeUrlWithoutBase) => { - Ok(Self::Internal(R::from_str(s).map_err(|e| { - NavigationTargetParseError::InvalidInternalURL(e) - })?)) - } + Err(ParseError::RelativeUrlWithoutBase) => Ok(Self::Internal( + R::from_str(s).map_err(|e| NavigationTargetParseError::InvalidInternalURL(e))?, + )), Err(e) => Err(NavigationTargetParseError::InvalidUrl(e)), } } diff --git a/packages/router/src/routable.rs b/packages/router/src/routable.rs index b1bb6d915..094dcafe1 100644 --- a/packages/router/src/routable.rs +++ b/packages/router/src/routable.rs @@ -134,11 +134,12 @@ impl> FromRouteSegments for I { /// A flattened version of [`Routable::SITE_MAP`]. /// This essentially represents a `Vec>`, which you can collect it into. -type SiteMapFlattened<'a> = FlatMap< - Iter<'a, SiteMapSegment>, - Vec>, - fn(&SiteMapSegment) -> Vec>, ->; +type SiteMapFlattened<'a> = + FlatMap< + Iter<'a, SiteMapSegment>, + Vec>, + fn(&SiteMapSegment) -> Vec>, + >; fn seg_strs_to_route(segs_maybe: &Option>) -> Option where diff --git a/packages/router/src/utils/use_router_internal.rs b/packages/router/src/utils/use_router_internal.rs index 9ac33f5fb..32a71d13c 100644 --- a/packages/router/src/utils/use_router_internal.rs +++ b/packages/router/src/utils/use_router_internal.rs @@ -11,14 +11,15 @@ use crate::prelude::*; /// - [`None`], when the current component isn't a descendant of a [`Link`] component. /// - Otherwise [`Some`]. pub(crate) fn use_router_internal(cx: &ScopeState) -> &Option { - let inner = cx.use_hook(|| { - let router = cx.consume_context::()?; + let inner = + cx.use_hook(|| { + let router = cx.consume_context::()?; - let id = cx.scope_id(); - router.subscribe(id); + let id = cx.scope_id(); + router.subscribe(id); - Some(Subscription { router, id }) - }); + Some(Subscription { router, id }) + }); cx.use_hook(|| inner.as_ref().map(|s| s.router.clone())) } diff --git a/packages/rsx-rosetta/tests/simple.rs b/packages/rsx-rosetta/tests/simple.rs index b8fd095e1..de5e1c6a9 100644 --- a/packages/rsx-rosetta/tests/simple.rs +++ b/packages/rsx-rosetta/tests/simple.rs @@ -36,7 +36,8 @@ fn simple_elements() { #[test] fn deeply_nested() { - let html = r#" + let html = + r#"

@@ -48,7 +49,7 @@ fn deeply_nested() {
"# - .trim(); + .trim(); let dom = Dom::parse(html).unwrap(); diff --git a/packages/rsx/src/component.rs b/packages/rsx/src/component.rs index 6487e5ab7..f28859352 100644 --- a/packages/rsx/src/component.rs +++ b/packages/rsx/src/component.rs @@ -162,10 +162,11 @@ impl ToTokens for Component { } if !self.children.is_empty() { - let renderer: TemplateRenderer = TemplateRenderer { - roots: &self.children, - location: None, - }; + let renderer: TemplateRenderer = + TemplateRenderer { + roots: &self.children, + location: None, + }; toks.append_all(quote! { .children( @@ -183,10 +184,11 @@ impl ToTokens for Component { let fn_name = self.name.segments.last().unwrap().ident.to_string(); - let gen_name = match &self.prop_gen_args { - Some(gen) => quote! { #name #gen }, - None => quote! { #name }, - }; + let gen_name = + match &self.prop_gen_args { + Some(gen) => quote! { #name #gen }, + None => quote! { #name }, + }; tokens.append_all(quote! { __cx.component( diff --git a/packages/rsx/src/element.rs b/packages/rsx/src/element.rs index 8f45d91ff..136eeaea2 100644 --- a/packages/rsx/src/element.rs +++ b/packages/rsx/src/element.rs @@ -332,59 +332,60 @@ impl ToTokens for ElementAttrNamed { } }; - let attribute = match attr { - ElementAttr::AttrText { name, value } => { - let ns = ns(name); - let volitile = volitile(name); - let attribute = attribute(name); - quote! { - __cx.attr( - #attribute, - #value, - #ns, - #volitile - ) + let attribute = + match attr { + ElementAttr::AttrText { name, value } => { + let ns = ns(name); + let volitile = volitile(name); + let attribute = attribute(name); + quote! { + __cx.attr( + #attribute, + #value, + #ns, + #volitile + ) + } } - } - ElementAttr::AttrExpression { name, value } => { - let ns = ns(name); - let volitile = volitile(name); - let attribute = attribute(name); - quote! { - __cx.attr( - #attribute, - #value, - #ns, - #volitile - ) + ElementAttr::AttrExpression { name, value } => { + let ns = ns(name); + let volitile = volitile(name); + let attribute = attribute(name); + quote! { + __cx.attr( + #attribute, + #value, + #ns, + #volitile + ) + } } - } - ElementAttr::CustomAttrText { name, value } => { - quote! { - __cx.attr( - #name, - #value, - None, - false - ) + ElementAttr::CustomAttrText { name, value } => { + quote! { + __cx.attr( + #name, + #value, + None, + false + ) + } } - } - ElementAttr::CustomAttrExpression { name, value } => { - quote! { - __cx.attr( - #name, - #value, - None, - false - ) + ElementAttr::CustomAttrExpression { name, value } => { + quote! { + __cx.attr( + #name, + #value, + None, + false + ) + } } - } - ElementAttr::EventTokens { name, tokens } => { - quote! { - dioxus_elements::events::#name(__cx, #tokens) + ElementAttr::EventTokens { name, tokens } => { + quote! { + dioxus_elements::events::#name(__cx, #tokens) + } } - } - }; + }; tokens.append_all(attribute); } diff --git a/packages/rsx/src/hot_reload/hot_reloading_file_map.rs b/packages/rsx/src/hot_reload/hot_reloading_file_map.rs index 0393142b4..875323405 100644 --- a/packages/rsx/src/hot_reload/hot_reloading_file_map.rs +++ b/packages/rsx/src/hot_reload/hot_reloading_file_map.rs @@ -77,11 +77,12 @@ impl FileMap { } let FileMapSearchResult { map, errors } = find_rs_files(path, &mut filter)?; - let result = Self { - map, - in_workspace: HashMap::new(), - phantom: std::marker::PhantomData, - }; + let result = + Self { + map, + in_workspace: HashMap::new(), + phantom: std::marker::PhantomData, + }; Ok(FileMapBuildResult { map: result, errors, diff --git a/packages/rsx/src/ifmt.rs b/packages/rsx/src/ifmt.rs index 6c72f5025..31d7c6a78 100644 --- a/packages/rsx/src/ifmt.rs +++ b/packages/rsx/src/ifmt.rs @@ -99,10 +99,9 @@ impl FromStr for IfmtInput { current_literal.push(c); continue; } else { - return Err(Error::new( - Span::call_site(), - "unmatched closing '}' in format string", - )); + return Err( + Error::new(Span::call_site(), "unmatched closing '}' in format string") + ); } } current_literal.push(c); @@ -147,17 +146,18 @@ impl ToTokens for IfmtInput { } } - let positional_args = self.segments.iter().filter_map(|seg| { - if let Segment::Formatted(FormattedSegment { - segment: FormattedSegmentType::Expr(expr), - .. - }) = seg - { - Some(expr) - } else { - None - } - }); + let positional_args = + self.segments.iter().filter_map(|seg| { + if let Segment::Formatted(FormattedSegment { + segment: FormattedSegmentType::Expr(expr), + .. + }) = seg + { + Some(expr) + } else { + None + } + }); // remove duplicate idents let named_args_idents: HashSet<_> = self @@ -228,10 +228,7 @@ impl FormattedSegmentType { if let Ok(expr) = parse_str(input) { Ok(Self::Expr(Box::new(expr))) } else { - Err(Error::new( - Span::call_site(), - "Expected Ident or Expression", - )) + Err(Error::new(Span::call_site(), "Expected Ident or Expression")) } } } diff --git a/packages/rsx/src/lib.rs b/packages/rsx/src/lib.rs index bdf32b272..6657ac722 100644 --- a/packages/rsx/src/lib.rs +++ b/packages/rsx/src/lib.rs @@ -199,10 +199,11 @@ impl<'a> ToTokens for TemplateRenderer<'a> { _ => None, }; - let key_tokens = match key { - Some(tok) => quote! { Some( __cx.raw_text(#tok) ) }, - None => quote! { None }, - }; + let key_tokens = + match key { + Some(tok) => quote! { Some( __cx.raw_text(#tok) ) }, + None => quote! { None }, + }; let spndbg = format!("{:?}", self.roots[0].span()); let root_col = spndbg @@ -518,12 +519,13 @@ impl<'a> DynamicContext<'a> { let attrs = quote! { #(#static_attrs),*}; - let children = el.children.iter().enumerate().map(|(idx, root)| { - self.current_path.push(idx as u8); - let out = self.render_static_node(root); - self.current_path.pop(); - out - }); + let children = + el.children.iter().enumerate().map(|(idx, root)| { + self.current_path.push(idx as u8); + let out = self.render_static_node(root); + self.current_path.pop(); + out + }); let _opt = el.children.len() == 1; let children = quote! { #(#children),* }; diff --git a/packages/server-macro/src/lib.rs b/packages/server-macro/src/lib.rs index 5ad9a682b..75cf7790c 100644 --- a/packages/server-macro/src/lib.rs +++ b/packages/server-macro/src/lib.rs @@ -65,10 +65,11 @@ use syn::{ #[proc_macro_attribute] pub fn server(args: proc_macro::TokenStream, s: TokenStream) -> TokenStream { // before we pass this off to the server function macro, we apply extractors and middleware - let mut function: syn::ItemFn = match syn::parse(s).map_err(|e| e.to_compile_error()) { - Ok(f) => f, - Err(e) => return e.into(), - }; + let mut function: syn::ItemFn = + match syn::parse(s).map_err(|e| e.to_compile_error()) { + Ok(f) => f, + Err(e) => return e.into(), + }; // extract all #[middleware] attributes let mut middlewares: Vec = vec![]; diff --git a/packages/signals/src/effect.rs b/packages/signals/src/effect.rs index 307ee98ab..87755180b 100644 --- a/packages/signals/src/effect.rs +++ b/packages/signals/src/effect.rs @@ -87,11 +87,12 @@ impl Effect { /// /// The signal will be owned by the current component and will be dropped when the component is dropped. pub fn new(callback: impl FnMut() + 'static) -> Self { - let myself = Self { - source: current_scope_id().expect("in a virtual dom"), - callback: CopyValue::new(Box::new(callback)), - effect_stack: get_effect_stack(), - }; + let myself = + Self { + source: current_scope_id().expect("in a virtual dom"), + callback: CopyValue::new(Box::new(callback)), + effect_stack: get_effect_stack(), + }; myself.try_run(); diff --git a/packages/signals/src/selector.rs b/packages/signals/src/selector.rs index 556c8437c..3dd1c2291 100644 --- a/packages/signals/src/selector.rs +++ b/packages/signals/src/selector.rs @@ -72,9 +72,10 @@ where /// /// Selectors can be used to efficiently compute derived data from signals. pub fn selector(mut f: impl FnMut() -> R + 'static) -> ReadOnlySignal { - let state = Signal:: { - inner: CopyValue::invalid(), - }; + let state = + Signal:: { + inner: CopyValue::invalid(), + }; let effect = Effect { source: current_scope_id().expect("in a virtual dom"), callback: CopyValue::invalid(), diff --git a/packages/signals/tests/create.rs b/packages/signals/tests/create.rs index ecda2f376..0a172617e 100644 --- a/packages/signals/tests/create.rs +++ b/packages/signals/tests/create.rs @@ -6,13 +6,14 @@ use dioxus_signals::*; #[test] fn create_signals_global() { - let mut dom = VirtualDom::new(|cx| { - render! { - for _ in 0..10 { - Child {} + let mut dom = + VirtualDom::new(|cx| { + render! { + for _ in 0..10 { + Child {} + } } - } - }); + }); fn Child(cx: Scope) -> Element { let signal = create_without_cx(); @@ -31,13 +32,14 @@ fn create_signals_global() { #[test] fn deref_signal() { - let mut dom = VirtualDom::new(|cx| { - render! { - for _ in 0..10 { - Child {} + let mut dom = + VirtualDom::new(|cx| { + render! { + for _ in 0..10 { + Child {} + } } - } - }); + }); fn Child(cx: Scope) -> Element { let signal = Signal::new("hello world".to_string()); @@ -55,16 +57,17 @@ fn deref_signal() { #[test] fn drop_signals() { - let mut dom = VirtualDom::new(|cx| { - let generation = cx.generation(); + let mut dom = + VirtualDom::new(|cx| { + let generation = cx.generation(); - let count = if generation % 2 == 0 { 10 } else { 0 }; - render! { - for _ in 0..count { - Child {} + let count = if generation % 2 == 0 { 10 } else { 0 }; + render! { + for _ in 0..count { + Child {} + } } - } - }); + }); fn Child(cx: Scope) -> Element { let signal = create_without_cx(); diff --git a/packages/signals/tests/selector.rs b/packages/signals/tests/selector.rs index 811871e88..b31e32a89 100644 --- a/packages/signals/tests/selector.rs +++ b/packages/signals/tests/selector.rs @@ -100,14 +100,15 @@ fn memos_prevents_component_rerun() { let signal = cx.props.signal; counter.borrow_mut().component += 1; - let memo = cx.use_hook(move || { - to_owned![counter]; - selector(move || { - counter.borrow_mut().effect += 1; - println!("Signal: {:?}", signal); - signal.value() - }) - }); + let memo = + cx.use_hook(move || { + to_owned![counter]; + selector(move || { + counter.borrow_mut().effect += 1; + println!("Signal: {:?}", signal); + signal.value() + }) + }); match cx.generation() { 0 => { assert_eq!(memo.value(), 0); diff --git a/packages/web/src/cache.rs b/packages/web/src/cache.rs index e17203a65..7648b1c47 100644 --- a/packages/web/src/cache.rs +++ b/packages/web/src/cache.rs @@ -1,300 +1,301 @@ -pub static BUILTIN_INTERNED_STRINGS: &[&str] = &[ - // Important tags to dioxus - "dioxus-id", - "dioxus", - "dioxus-event-click", // todo: more events - "click", - // All the HTML Tags - "a", - "abbr", - "address", - "area", - "article", - "aside", - "audio", - "b", - "base", - "bdi", - "bdo", - "big", - "blockquote", - "body", - "br", - "button", - "canvas", - "caption", - "cite", - "code", - "col", - "colgroup", - "command", - "data", - "datalist", - "dd", - "del", - "details", - "dfn", - "dialog", - "div", - "dl", - "dt", - "em", - "embed", - "fieldset", - "figcaption", - "figure", - "footer", - "form", - "h1", - "h2", - "h3", - "h4", - "h5", - "h6", - "head", - "header", - "hr", - "html", - "i", - "iframe", - "img", - "input", - "ins", - "kbd", - "keygen", - "label", - "legend", - "li", - "link", - "main", - "map", - "mark", - "menu", - "menuitem", - "meta", - "meter", - "nav", - "noscript", - "object", - "ol", - "optgroup", - "option", - "output", - "p", - "param", - "picture", - "pre", - "progress", - "q", - "rp", - "rt", - "ruby", - "s", - "samp", - "script", - "section", - "select", - "small", - "source", - "span", - "strong", - "style", - "sub", - "summary", - "sup", - "table", - "tbody", - "td", - "textarea", - "tfoot", - "th", - "thead", - "time", - "title", - "tr", - "track", - "u", - "ul", - "var", - "video", - "wbr", - // All the event handlers - "Attribute", - "accept", - "accept-charset", - "accesskey", - "action", - "alt", - "async", - "autocomplete", - "autofocus", - "autoplay", - "charset", - "checked", - "cite", - "class", - "cols", - "colspan", - "content", - "contenteditable", - "controls", - "coords", - "data", - "data-*", - "datetime", - "default", - "defer", - "dir", - "dirname", - "disabled", - "download", - "draggable", - "enctype", - "for", - "form", - "formaction", - "headers", - "height", - "hidden", - "high", - "href", - "hreflang", - "http-equiv", - "id", - "ismap", - "kind", - "label", - "lang", - "list", - "loop", - "low", - "max", - "maxlength", - "media", - "method", - "min", - "multiple", - "muted", - "name", - "novalidate", - "onabort", - "onafterprint", - "onbeforeprint", - "onbeforeunload", - "onblur", - "oncanplay", - "oncanplaythrough", - "onchange", - "onclick", - "oncontextmenu", - "oncopy", - "oncuechange", - "oncut", - "ondblclick", - "ondrag", - "ondragend", - "ondragenter", - "ondragleave", - "ondragover", - "ondragstart", - "ondrop", - "ondurationchange", - "onemptied", - "onended", - "onerror", - "onfocus", - "onfocusout", - "onfocusin", - "onhashchange", - "oninput", - "oninvalid", - "onkeydown", - "onkeypress", - "onkeyup", - "onload", - "onloadeddata", - "onloadedmetadata", - "onloadstart", - "onmousedown", - "onmousemove", - "onmouseout", - "onmouseover", - "onmouseup", - "onmousewheel", - "onoffline", - "ononline", - "onpageshow", - "onpaste", - "onpause", - "onplay", - "onplaying", - "onprogress", - "onratechange", - "onreset", - "onresize", - "onscroll", - "onsearch", - "onseeked", - "onseeking", - "onselect", - "onstalled", - "onsubmit", - "onsuspend", - "ontimeupdate", - "ontoggle", - "onunload", - "onvolumechange", - "onwaiting", - "onwheel", - "open", - "optimum", - "pattern", - "placeholder", - "poster", - "preload", - "readonly", - "rel", - "required", - "reversed", - "rows", - "rowspan", - "sandbox", - "scope", - "selected", - "shape", - "size", - "sizes", - "span", - "spellcheck", - "src", - "srcdoc", - "srclang", - "srcset", - "start", - "step", - "style", - "tabindex", - "target", - "title", - "translate", - "type", - "usemap", - "value", - "width", - "wrap", - "0", - "1", - "2", - "3", - "4", - "5", - "6", - "7", - "8", - "9", - "10", - "11", - "12", - "13", - "14", -]; +pub static BUILTIN_INTERNED_STRINGS: &[&str] = + &[ + // Important tags to dioxus + "dioxus-id", + "dioxus", + "dioxus-event-click", // todo: more events + "click", + // All the HTML Tags + "a", + "abbr", + "address", + "area", + "article", + "aside", + "audio", + "b", + "base", + "bdi", + "bdo", + "big", + "blockquote", + "body", + "br", + "button", + "canvas", + "caption", + "cite", + "code", + "col", + "colgroup", + "command", + "data", + "datalist", + "dd", + "del", + "details", + "dfn", + "dialog", + "div", + "dl", + "dt", + "em", + "embed", + "fieldset", + "figcaption", + "figure", + "footer", + "form", + "h1", + "h2", + "h3", + "h4", + "h5", + "h6", + "head", + "header", + "hr", + "html", + "i", + "iframe", + "img", + "input", + "ins", + "kbd", + "keygen", + "label", + "legend", + "li", + "link", + "main", + "map", + "mark", + "menu", + "menuitem", + "meta", + "meter", + "nav", + "noscript", + "object", + "ol", + "optgroup", + "option", + "output", + "p", + "param", + "picture", + "pre", + "progress", + "q", + "rp", + "rt", + "ruby", + "s", + "samp", + "script", + "section", + "select", + "small", + "source", + "span", + "strong", + "style", + "sub", + "summary", + "sup", + "table", + "tbody", + "td", + "textarea", + "tfoot", + "th", + "thead", + "time", + "title", + "tr", + "track", + "u", + "ul", + "var", + "video", + "wbr", + // All the event handlers + "Attribute", + "accept", + "accept-charset", + "accesskey", + "action", + "alt", + "async", + "autocomplete", + "autofocus", + "autoplay", + "charset", + "checked", + "cite", + "class", + "cols", + "colspan", + "content", + "contenteditable", + "controls", + "coords", + "data", + "data-*", + "datetime", + "default", + "defer", + "dir", + "dirname", + "disabled", + "download", + "draggable", + "enctype", + "for", + "form", + "formaction", + "headers", + "height", + "hidden", + "high", + "href", + "hreflang", + "http-equiv", + "id", + "ismap", + "kind", + "label", + "lang", + "list", + "loop", + "low", + "max", + "maxlength", + "media", + "method", + "min", + "multiple", + "muted", + "name", + "novalidate", + "onabort", + "onafterprint", + "onbeforeprint", + "onbeforeunload", + "onblur", + "oncanplay", + "oncanplaythrough", + "onchange", + "onclick", + "oncontextmenu", + "oncopy", + "oncuechange", + "oncut", + "ondblclick", + "ondrag", + "ondragend", + "ondragenter", + "ondragleave", + "ondragover", + "ondragstart", + "ondrop", + "ondurationchange", + "onemptied", + "onended", + "onerror", + "onfocus", + "onfocusout", + "onfocusin", + "onhashchange", + "oninput", + "oninvalid", + "onkeydown", + "onkeypress", + "onkeyup", + "onload", + "onloadeddata", + "onloadedmetadata", + "onloadstart", + "onmousedown", + "onmousemove", + "onmouseout", + "onmouseover", + "onmouseup", + "onmousewheel", + "onoffline", + "ononline", + "onpageshow", + "onpaste", + "onpause", + "onplay", + "onplaying", + "onprogress", + "onratechange", + "onreset", + "onresize", + "onscroll", + "onsearch", + "onseeked", + "onseeking", + "onselect", + "onstalled", + "onsubmit", + "onsuspend", + "ontimeupdate", + "ontoggle", + "onunload", + "onvolumechange", + "onwaiting", + "onwheel", + "open", + "optimum", + "pattern", + "placeholder", + "poster", + "preload", + "readonly", + "rel", + "required", + "reversed", + "rows", + "rowspan", + "sandbox", + "scope", + "selected", + "shape", + "size", + "sizes", + "span", + "spellcheck", + "src", + "srcdoc", + "srclang", + "srcset", + "start", + "step", + "style", + "tabindex", + "target", + "title", + "translate", + "type", + "usemap", + "value", + "width", + "wrap", + "0", + "1", + "2", + "3", + "4", + "5", + "6", + "7", + "8", + "9", + "10", + "11", + "12", + "13", + "14", + ]; diff --git a/packages/web/src/dom.rs b/packages/web/src/dom.rs index f45d6558a..135ad8ede 100644 --- a/packages/web/src/dom.rs +++ b/packages/web/src/dom.rs @@ -80,12 +80,13 @@ impl WebsysDom { } let data = virtual_event_from_websys_event(event.clone(), target); - let _ = event_channel.unbounded_send(UiEvent { - name, - bubbles, - element, - data, - }); + let _ = + event_channel.unbounded_send(UiEvent { + name, + bubbles, + element, + data, + }); } } })); diff --git a/packages/web/src/eval.rs b/packages/web/src/eval.rs index eefece50e..f4da3e69b 100644 --- a/packages/web/src/eval.rs +++ b/packages/web/src/eval.rs @@ -62,24 +62,18 @@ impl WebEvaluator { if let Ok(stringified) = js_sys::JSON::stringify(&result) { if !stringified.is_undefined() && stringified.is_valid_utf16() { let string: String = stringified.into(); - Value::from_str(&string).map_err(|e| { - EvalError::Communication(format!("Failed to parse result - {}", e)) - })? + Value::from_str(&string).map_err( + |e| EvalError::Communication(format!("Failed to parse result - {}", e)) + )? } else { - return Err(EvalError::Communication( - "Failed to stringify result".into(), - )); + return Err(EvalError::Communication("Failed to stringify result".into())); } } else { - return Err(EvalError::Communication( - "Failed to stringify result".into(), - )); + return Err(EvalError::Communication("Failed to stringify result".into())); } } Err(err) => { - return Err(EvalError::InvalidJs( - err.as_string().unwrap_or("unknown".to_string()), - )); + return Err(EvalError::InvalidJs(err.as_string().unwrap_or("unknown".to_string()))); } }; From 906c466e780d56e9c48d9e78dd6a7d0b71fd31fc Mon Sep 17 00:00:00 2001 From: Pascal Date: Thu, 7 Dec 2023 17:11:56 +0100 Subject: [PATCH 315/447] Revert "improved documentation and refactored naming to be more self-explanatory" This reverts commit adfbb6c380ba2079ed7159e9cf84175e301476c7. --- examples/all_events.rs | 15 +- examples/callback.rs | 19 +- examples/compose.rs | 15 +- examples/error_handle.rs | 9 +- examples/eval.rs | 27 +- examples/file_explorer.rs | 11 +- examples/framework_benchmark.rs | 55 +- examples/login_form.rs | 42 +- examples/openid_connect_demo/src/oidc.rs | 11 +- .../openid_connect_demo/src/views/header.rs | 42 +- examples/rsx_compile_fail.rs | 26 +- examples/svg.rs | 30 +- examples/todomvc.rs | 15 +- packages/autofmt/src/expr.rs | 15 +- packages/cli/src/builder.rs | 109 ++-- packages/cli/src/cargo.rs | 6 +- packages/cli/src/cli/autoformat.rs | 75 ++- packages/cli/src/cli/create.rs | 15 +- packages/cli/src/plugin/interface/fs.rs | 11 +- packages/cli/src/plugin/mod.rs | 11 +- packages/cli/src/server/output.rs | 36 +- packages/cli/src/server/web/mod.rs | 13 +- packages/cli/src/tools.rs | 50 +- .../inline_props.rs | 31 +- packages/core-macro/src/props/mod.rs | 217 +++---- packages/core-macro/src/utils.rs | 11 +- packages/core/src/create.rs | 15 +- packages/core/src/nodes.rs | 6 +- packages/core/src/virtual_dom.rs | 9 +- packages/core/tests/attr_cleanup.rs | 29 +- packages/core/tests/bubble_error.rs | 11 +- packages/core/tests/create_dom.rs | 47 +- packages/core/tests/create_fragments.rs | 13 +- packages/core/tests/diff_unkeyed_list.rs | 63 +- packages/core/tests/fuzzing.rs | 113 ++-- packages/desktop/headless_tests/rendering.rs | 11 +- packages/desktop/src/cfg.rs | 12 +- packages/desktop/src/lib.rs | 20 +- packages/desktop/src/webview.rs | 12 +- .../examples/all_terminal_events.rs | 7 +- packages/dioxus/benches/jsframework.rs | 55 +- packages/dioxus/examples/stress.rs | 55 +- .../fullstack/examples/axum-auth/src/main.rs | 13 +- .../examples/static-hydrated/src/main.rs | 6 +- .../fullstack/src/adapters/axum_adapter.rs | 19 +- .../fullstack/src/adapters/salvo_adapter.rs | 19 +- .../fullstack/src/html_storage/deserialize.rs | 15 +- packages/fullstack/src/layer.rs | 8 +- packages/fullstack/src/render.rs | 9 +- packages/fullstack/src/serve_config.rs | 16 +- packages/fullstack/src/server_context.rs | 18 +- packages/hooks/src/use_coroutine.rs | 11 +- packages/hooks/src/use_shared_state.rs | 43 +- packages/hooks/src/use_state.rs | 49 +- packages/liveview/examples/axum.rs | 6 +- packages/liveview/src/pool.rs | 15 +- packages/native-core-macro/src/lib.rs | 91 ++- packages/native-core/examples/custom_attr.rs | 13 +- packages/native-core/examples/simple.rs | 13 +- .../native-core/examples/simple_dioxus.rs | 13 +- packages/native-core/src/layout_attributes.rs | 51 +- .../src/utils/persistant_iterator.rs | 5 +- packages/native-core/tests/fuzzing.rs | 62 +- packages/rink/src/focus.rs | 51 +- packages/rink/src/hooks.rs | 90 ++- packages/rink/src/layout.rs | 11 +- packages/rink/src/prevent_default.rs | 43 +- packages/rink/src/style.rs | 34 +- packages/rink/src/widgets/button.rs | 11 +- packages/rink/src/widgets/slider.rs | 29 +- packages/router-macro/src/route.rs | 24 +- packages/router-macro/src/segment.rs | 37 +- packages/router/src/history/liveview.rs | 23 +- packages/router/src/history/web.rs | 34 +- packages/router/src/navigation.rs | 8 +- packages/router/src/routable.rs | 11 +- .../router/src/utils/use_router_internal.rs | 13 +- packages/rsx-rosetta/tests/simple.rs | 5 +- packages/rsx/src/component.rs | 18 +- packages/rsx/src/element.rs | 97 ++- .../src/hot_reload/hot_reloading_file_map.rs | 11 +- packages/rsx/src/ifmt.rs | 35 +- packages/rsx/src/lib.rs | 22 +- packages/server-macro/src/lib.rs | 9 +- packages/signals/src/effect.rs | 11 +- packages/signals/src/selector.rs | 7 +- packages/signals/tests/create.rs | 43 +- packages/signals/tests/selector.rs | 17 +- packages/web/src/cache.rs | 601 +++++++++--------- packages/web/src/dom.rs | 13 +- packages/web/src/eval.rs | 18 +- 91 files changed, 1553 insertions(+), 1663 deletions(-) diff --git a/examples/all_events.rs b/examples/all_events.rs index 5f3b257bb..594a736d5 100644 --- a/examples/all_events.rs +++ b/examples/all_events.rs @@ -43,15 +43,14 @@ const RECT_STYLE: &str = r#" fn app(cx: Scope) -> Element { let events = use_ref(cx, std::collections::VecDeque::new); - let log_event = - move |event: Event| { - let mut events = events.write(); + let log_event = move |event: Event| { + let mut events = events.write(); - if events.len() >= MAX_EVENTS { - events.pop_front(); - } - events.push_back(event); - }; + if events.len() >= MAX_EVENTS { + events.pop_front(); + } + events.push_back(event); + }; cx.render(rsx! ( div { diff --git a/examples/callback.rs b/examples/callback.rs index ff07607b7..cb300b701 100644 --- a/examples/callback.rs +++ b/examples/callback.rs @@ -5,17 +5,16 @@ fn main() { } fn app(cx: Scope) -> Element { - let login = - use_callback!(cx, move |_| async move { - let res = reqwest::get("https://dog.ceo/api/breeds/list/all") - .await - .unwrap() - .text() - .await - .unwrap(); + let login = use_callback!(cx, move |_| async move { + let res = reqwest::get("https://dog.ceo/api/breeds/list/all") + .await + .unwrap() + .text() + .await + .unwrap(); - println!("{res:#?}, "); - }); + println!("{res:#?}, "); + }); cx.render(rsx! { button { onclick: login, "Click me!" } diff --git a/examples/compose.rs b/examples/compose.rs index d5a5d5c90..3ee6d36ae 100644 --- a/examples/compose.rs +++ b/examples/compose.rs @@ -12,15 +12,14 @@ fn app(cx: Scope) -> Element { let window = use_window(cx); let emails_sent = use_ref(cx, Vec::new); - let tx = - use_coroutine(cx, |mut rx: UnboundedReceiver| { - to_owned![emails_sent]; - async move { - while let Some(message) = rx.next().await { - emails_sent.write().push(message); - } + let tx = use_coroutine(cx, |mut rx: UnboundedReceiver| { + to_owned![emails_sent]; + async move { + while let Some(message) = rx.next().await { + emails_sent.write().push(message); } - }); + } + }); cx.render(rsx! { div { diff --git a/examples/error_handle.rs b/examples/error_handle.rs index c0524f741..d1fb57933 100644 --- a/examples/error_handle.rs +++ b/examples/error_handle.rs @@ -8,11 +8,10 @@ fn main() { fn App(cx: Scope) -> Element { let val = use_state(cx, || "0.0001"); - let num = - match val.parse::() { - Err(_) => return cx.render(rsx!("Parsing failed")), - Ok(num) => num, - }; + let num = match val.parse::() { + Err(_) => return cx.render(rsx!("Parsing failed")), + Ok(num) => num, + }; cx.render(rsx! { h1 { "The parsed value is {num}" } diff --git a/examples/eval.rs b/examples/eval.rs index f6a61ae15..54959df69 100644 --- a/examples/eval.rs +++ b/examples/eval.rs @@ -7,26 +7,25 @@ fn main() { fn app(cx: Scope) -> Element { let eval_provider = use_eval(cx); - let future = - use_future(cx, (), |_| { - to_owned![eval_provider]; - async move { - let eval = eval_provider( - r#" + let future = use_future(cx, (), |_| { + to_owned![eval_provider]; + async move { + let eval = eval_provider( + r#" dioxus.send("Hi from JS!"); let msg = await dioxus.recv(); console.log(msg); return "hello world"; "#, - ) - .unwrap(); + ) + .unwrap(); - eval.send("Hi from Rust!".into()).unwrap(); - let res = eval.recv().await.unwrap(); - println!("{:?}", eval.await); - res - } - }); + eval.send("Hi from Rust!".into()).unwrap(); + let res = eval.recv().await.unwrap(); + println!("{:?}", eval.await); + res + } + }); match future.value() { Some(v) => cx.render(rsx!( diff --git a/examples/file_explorer.rs b/examples/file_explorer.rs index cea860643..88b37789d 100644 --- a/examples/file_explorer.rs +++ b/examples/file_explorer.rs @@ -73,12 +73,11 @@ struct Files { impl Files { fn new() -> Self { - let mut files = - Self { - path_stack: vec!["./".to_string()], - path_names: vec![], - err: None, - }; + let mut files = Self { + path_stack: vec!["./".to_string()], + path_names: vec![], + err: None, + }; files.reload_path_list(); diff --git a/examples/framework_benchmark.rs b/examples/framework_benchmark.rs index f1d75d8e9..7e7a320a9 100644 --- a/examples/framework_benchmark.rs +++ b/examples/framework_benchmark.rs @@ -112,34 +112,33 @@ fn ActionButton<'a>(cx: Scope<'a, ActionButtonProps<'a>>) -> Element { }) } -static ADJECTIVES: &[&str] = - &[ - "pretty", - "large", - "big", - "small", - "tall", - "short", - "long", - "handsome", - "plain", - "quaint", - "clean", - "elegant", - "easy", - "angry", - "crazy", - "helpful", - "mushy", - "odd", - "unsightly", - "adorable", - "important", - "inexpensive", - "cheap", - "expensive", - "fancy", - ]; +static ADJECTIVES: &[&str] = &[ + "pretty", + "large", + "big", + "small", + "tall", + "short", + "long", + "handsome", + "plain", + "quaint", + "clean", + "elegant", + "easy", + "angry", + "crazy", + "helpful", + "mushy", + "odd", + "unsightly", + "adorable", + "important", + "inexpensive", + "cheap", + "expensive", + "fancy", +]; static COLOURS: &[&str] = &[ "red", "yellow", "blue", "green", "pink", "brown", "purple", "brown", "white", "black", diff --git a/examples/login_form.rs b/examples/login_form.rs index 585fe15f6..5ee47e4b5 100644 --- a/examples/login_form.rs +++ b/examples/login_form.rs @@ -8,32 +8,28 @@ fn main() { } fn app(cx: Scope) -> Element { - let onsubmit = - move |evt: FormEvent| { - cx.spawn(async move { - let resp = - reqwest::Client::new() - .post("http://localhost:8080/login") - .form(&[ - ("username", &evt.values["username"]), - ("password", &evt.values["password"]), - ]) - .send() - .await; + let onsubmit = move |evt: FormEvent| { + cx.spawn(async move { + let resp = reqwest::Client::new() + .post("http://localhost:8080/login") + .form(&[ + ("username", &evt.values["username"]), + ("password", &evt.values["password"]), + ]) + .send() + .await; - match resp { - // Parse data from here, such as storing a response token - Ok(_data) => println!("Login successful!"), + match resp { + // Parse data from here, such as storing a response token + Ok(_data) => println!("Login successful!"), - //Handle any errors from the fetch here - Err(_err) => { - println!( - "Login failed - you need a login server running on localhost:8080." - ) - } + //Handle any errors from the fetch here + Err(_err) => { + println!("Login failed - you need a login server running on localhost:8080.") } - }); - }; + } + }); + }; cx.render(rsx! { h1 { "Login" } diff --git a/examples/openid_connect_demo/src/oidc.rs b/examples/openid_connect_demo/src/oidc.rs index 07c9b2314..7fa96c14b 100644 --- a/examples/openid_connect_demo/src/oidc.rs +++ b/examples/openid_connect_demo/src/oidc.rs @@ -112,12 +112,11 @@ pub async fn exchange_refresh_token( pub async fn log_out_url(id_token_hint: CoreIdToken) -> Result { let provider_metadata = init_provider_metadata().await?; - let end_session_url = - provider_metadata - .additional_metadata() - .clone() - .end_session_endpoint - .unwrap(); + let end_session_url = provider_metadata + .additional_metadata() + .clone() + .end_session_endpoint + .unwrap(); let logout_request: LogoutRequest = LogoutRequest::from(end_session_url); Ok(logout_request .set_client_id(ClientId::new(DIOXUS_FRONT_CLIENT_ID.to_string())) diff --git a/examples/openid_connect_demo/src/views/header.rs b/examples/openid_connect_demo/src/views/header.rs index 4a0ccea0d..1f2c6e057 100644 --- a/examples/openid_connect_demo/src/views/header.rs +++ b/examples/openid_connect_demo/src/views/header.rs @@ -22,31 +22,29 @@ pub fn LogOut(cx: Scope) -> Element { Some(fermi_auth_token_read) => match fermi_auth_token_read.id_token.clone() { Some(id_token) => match log_out_url_state.get() { Some(log_out_url_result) => match log_out_url_result { - Some(uri) => { - match uri { - Ok(uri) => { - rsx! { - Link { - onclick: move |_| { - { - AuthTokenState::persistent_set( - fermi_auth_token, - Some(AuthTokenState::default()), - ); - } - }, - to: uri.to_string(), - "Log out" - } - } - } - Err(error) => { - rsx! { - div { format!{"Failed to load disconnection url: {:?}", error} } + Some(uri) => match uri { + Ok(uri) => { + rsx! { + Link { + onclick: move |_| { + { + AuthTokenState::persistent_set( + fermi_auth_token, + Some(AuthTokenState::default()), + ); + } + }, + to: uri.to_string(), + "Log out" } } } - } + Err(error) => { + rsx! { + div { format!{"Failed to load disconnection url: {:?}", error} } + } + } + }, None => { rsx! { div { "Loading... Please wait" } } } diff --git a/examples/rsx_compile_fail.rs b/examples/rsx_compile_fail.rs index f6df332ff..40bad709b 100644 --- a/examples/rsx_compile_fail.rs +++ b/examples/rsx_compile_fail.rs @@ -13,21 +13,19 @@ fn main() { } fn example(cx: Scope) -> Element { - let items = - use_state(cx, || { - vec![Thing { - a: "asd".to_string(), - b: 10, - }] - }); + let items = use_state(cx, || { + vec![Thing { + a: "asd".to_string(), + b: 10, + }] + }); - let things = - use_ref(cx, || { - vec![Thing { - a: "asd".to_string(), - b: 10, - }] - }); + let things = use_ref(cx, || { + vec![Thing { + a: "asd".to_string(), + b: 10, + }] + }); let things_list = things.read(); let mything = use_ref(cx, || Some(String::from("asd"))); diff --git a/examples/svg.rs b/examples/svg.rs index e947c575a..329cbe6ae 100644 --- a/examples/svg.rs +++ b/examples/svg.rs @@ -63,23 +63,23 @@ pub fn Die<'a>(cx: Scope<'a, DieProps<'a>>) -> Element { let active_dots = &DOTS_FOR_VALUE[(value - 1) as usize]; let fill = if keep { HELD_COLOR } else { UNHELD_COLOR }; - let dots = - DOTS.iter() - .zip(active_dots.iter()) - .filter(|(_, &active)| active) - .map(|((x, y), _)| { - let dcx = x * OFFSET; - let dcy = y * OFFSET; + let dots = DOTS + .iter() + .zip(active_dots.iter()) + .filter(|(_, &active)| active) + .map(|((x, y), _)| { + let dcx = x * OFFSET; + let dcy = y * OFFSET; - rsx! { - circle { - cx: "{dcx}", - cy: "{dcy}", - r: "{DOT_RADIUS}", - fill: "#333" - } + rsx! { + circle { + cx: "{dcx}", + cy: "{dcy}", + r: "{DOT_RADIUS}", + fill: "#333" } - }); + } + }); cx.render(rsx! { svg { diff --git a/examples/todomvc.rs b/examples/todomvc.rs index a5a687374..9ec2dc228 100644 --- a/examples/todomvc.rs +++ b/examples/todomvc.rs @@ -202,14 +202,13 @@ pub fn ListFooter<'a>(cx: Scope<'a, ListFooterProps<'a>>) -> Element { let active_todo_count = cx.props.active_todo_count; let active_todo_text = cx.props.active_todo_text; - let selected = - |state| { - if *cx.props.filter == state { - "selected" - } else { - "false" - } - }; + let selected = |state| { + if *cx.props.filter == state { + "selected" + } else { + "false" + } + }; cx.render(rsx! { footer { class: "footer", diff --git a/packages/autofmt/src/expr.rs b/packages/autofmt/src/expr.rs index dc8417c35..b0257f8c3 100644 --- a/packages/autofmt/src/expr.rs +++ b/packages/autofmt/src/expr.rs @@ -34,14 +34,13 @@ impl Writer<'_> { for (id, line) in self.src[start.line..end.line].iter().enumerate() { writeln!(self.out)?; // check if this is the last line - let line = - { - if id == (end.line - start.line) - 1 { - &line[..end.column] - } else { - line - } - }; + let line = { + if id == (end.line - start.line) - 1 { + &line[..end.column] + } else { + line + } + }; // trim the leading whitespace let previous_indent = crate::leading_whitespaces(line) / 4; diff --git a/packages/cli/src/builder.rs b/packages/cli/src/builder.rs index 2352ed262..08e636237 100644 --- a/packages/cli/src/builder.rs +++ b/packages/cli/src/builder.rs @@ -67,21 +67,19 @@ pub fn build(config: &CrateConfig, quiet: bool) -> Result { cmd.arg("--quiet") }; - let cmd = - if config.custom_profile.is_some() { - let custom_profile = config.custom_profile.as_ref().unwrap(); - cmd.arg("--profile").arg(custom_profile) - } else { - cmd - }; + let cmd = if config.custom_profile.is_some() { + let custom_profile = config.custom_profile.as_ref().unwrap(); + cmd.arg("--profile").arg(custom_profile) + } else { + cmd + }; - let cmd = - if config.features.is_some() { - let features_str = config.features.as_ref().unwrap().join(" "); - cmd.arg("--features").arg(features_str) - } else { - cmd - }; + let cmd = if config.features.is_some() { + let features_str = config.features.as_ref().unwrap().join(" "); + cmd.arg("--features").arg(features_str) + } else { + cmd + }; let cmd = match executable { ExecutableType::Binary(name) => cmd.arg("--bin").arg(name), @@ -94,14 +92,13 @@ pub fn build(config: &CrateConfig, quiet: bool) -> Result { // [2] Establish the output directory structure let bindgen_outdir = out_dir.join("assets").join("dioxus"); - let build_profile = - if config.custom_profile.is_some() { - config.custom_profile.as_ref().unwrap() - } else if config.release { - "release" - } else { - "debug" - }; + let build_profile = if config.custom_profile.is_some() { + config.custom_profile.as_ref().unwrap() + } else if config.release { + "release" + } else { + "debug" + }; let input_path = match executable { ExecutableType::Binary(name) | ExecutableType::Lib(name) => target_dir @@ -210,15 +207,14 @@ pub fn build(config: &CrateConfig, quiet: bool) -> Result { } // this code will copy all public file to the output dir - let copy_options = - fs_extra::dir::CopyOptions { - overwrite: true, - skip_exist: false, - buffer_size: 64000, - copy_inside: false, - content_only: false, - depth: 0, - }; + let copy_options = fs_extra::dir::CopyOptions { + overwrite: true, + skip_exist: false, + buffer_size: 64000, + copy_inside: false, + content_only: false, + depth: 0, + }; if asset_dir.is_dir() { for entry in std::fs::read_dir(asset_dir)? { let path = entry?.path(); @@ -291,21 +287,20 @@ pub fn build_desktop(config: &CrateConfig, _is_serve: bool) -> Result { - file_name = name.clone(); - config.target_dir.join(release_type).join(name) - } - crate::ExecutableType::Example(name) => { - file_name = name.clone(); - config - .target_dir - .join(release_type) - .join("examples") - .join(name) - } - }; + let mut res_path = match &config.executable { + crate::ExecutableType::Binary(name) | crate::ExecutableType::Lib(name) => { + file_name = name.clone(); + config.target_dir.join(release_type).join(name) + } + crate::ExecutableType::Example(name) => { + file_name = name.clone(); + config + .target_dir + .join(release_type) + .join("examples") + .join(name) + } + }; let target_file = if cfg!(windows) { res_path.set_extension("exe"); @@ -401,7 +396,9 @@ fn prettier_build(cmd: subprocess::Exec) -> anyhow::Result> { match message.level { cargo_metadata::diagnostic::DiagnosticLevel::Error => { return { - Err(anyhow::anyhow!(message.rendered.unwrap_or("Unknown".into()))) + Err(anyhow::anyhow!(message + .rendered + .unwrap_or("Unknown".into()))) }; } cargo_metadata::diagnostic::DiagnosticLevel::Warning => { @@ -478,7 +475,10 @@ pub fn gen_page(config: &DioxusConfig, serve: bool) -> String { let mut script_str = String::new(); for script in script_list { - script_str.push_str(&format!("\n", &script.to_str().unwrap(),)) + script_str.push_str(&format!( + "\n", + &script.to_str().unwrap(), + )) } replace_or_insert_before("{script_include}", &script_str, " String { html = html.replace("{base_path}", base_path); } else { // If not, insert the script - html = - html.replace( - " + html = html.replace( + " import init from "/{base_path}/assets/dioxus/{app_name}.js"; init("/{base_path}/assets/dioxus/{app_name}_bg.wasm").then(wasm => {{ if (wasm.__wbindgen_start == undefined) {{ @@ -515,8 +514,8 @@ pub fn gen_page(config: &DioxusConfig, serve: bool) -> String { }}); Result { } None }) - .ok_or_else( - || Error::CargoError("Failed to find directory containing Cargo.toml".to_string()) - ) + .ok_or_else(|| { + Error::CargoError("Failed to find directory containing Cargo.toml".to_string()) + }) } /// Checks if the directory contains `Cargo.toml` diff --git a/packages/cli/src/cli/autoformat.rs b/packages/cli/src/cli/autoformat.rs index 4f6c42751..1d1cbcd24 100644 --- a/packages/cli/src/cli/autoformat.rs +++ b/packages/cli/src/cli/autoformat.rs @@ -93,49 +93,48 @@ async fn autoformat_project(check: bool) -> Result<()> { let mut files_to_format = vec![]; collect_rs_files(&crate_config.crate_dir, &mut files_to_format); - let counts = - files_to_format - .into_iter() - .filter(|file| { - if file.components().any(|f| f.as_os_str() == "target") { - return false; + let counts = files_to_format + .into_iter() + .filter(|file| { + if file.components().any(|f| f.as_os_str() == "target") { + return false; + } + + true + }) + .map(|path| async { + let _path = path.clone(); + let res = tokio::spawn(async move { + let contents = tokio::fs::read_to_string(&path).await?; + + let edits = dioxus_autofmt::fmt_file(&contents); + let len = edits.len(); + + if !edits.is_empty() { + let out = dioxus_autofmt::apply_formats(&contents, edits); + tokio::fs::write(&path, out).await?; } - true + Ok(len) as Result }) - .map(|path| async { - let _path = path.clone(); - let res = tokio::spawn(async move { - let contents = tokio::fs::read_to_string(&path).await?; - - let edits = dioxus_autofmt::fmt_file(&contents); - let len = edits.len(); - - if !edits.is_empty() { - let out = dioxus_autofmt::apply_formats(&contents, edits); - tokio::fs::write(&path, out).await?; - } - - Ok(len) as Result - }) - .await; - - match res { - Err(err) => { - eprintln!("error formatting file: {}\n{err}", _path.display()); - None - } - Ok(Err(err)) => { - eprintln!("error formatting file: {}\n{err}", _path.display()); - None - } - Ok(Ok(res)) => Some(res), - } - }) - .collect::>() - .collect::>() .await; + match res { + Err(err) => { + eprintln!("error formatting file: {}\n{err}", _path.display()); + None + } + Ok(Err(err)) => { + eprintln!("error formatting file: {}\n{err}", _path.display()); + None + } + Ok(Ok(res)) => Some(res), + } + }) + .collect::>() + .collect::>() + .await; + let files_formatted: usize = counts .into_iter() .map(|f| match f { diff --git a/packages/cli/src/cli/create.rs b/packages/cli/src/cli/create.rs index 4893dab80..92b0334f5 100644 --- a/packages/cli/src/cli/create.rs +++ b/packages/cli/src/cli/create.rs @@ -35,14 +35,13 @@ impl Create { let toml_paths = [path.join("Cargo.toml"), path.join("Dioxus.toml")]; for toml_path in &toml_paths { let toml = std::fs::read_to_string(toml_path)?; - let mut toml = - toml.parse::().map_err(|e| { - anyhow::anyhow!( - "failed to parse toml at {}: {}", - toml_path.display(), - e.to_string() - ) - })?; + let mut toml = toml.parse::().map_err(|e| { + anyhow::anyhow!( + "failed to parse toml at {}: {}", + toml_path.display(), + e.to_string() + ) + })?; toml.as_table_mut().fmt(); diff --git a/packages/cli/src/plugin/interface/fs.rs b/packages/cli/src/plugin/interface/fs.rs index 18918a592..5668dbe33 100644 --- a/packages/cli/src/plugin/interface/fs.rs +++ b/packages/cli/src/plugin/interface/fs.rs @@ -67,12 +67,11 @@ impl UserData for PluginFileSystem { let file = PathBuf::from(args.0); let target = PathBuf::from(args.1); - let tar_gz = - if let Ok(v) = File::open(file) { - v - } else { - return Ok(false); - }; + let tar_gz = if let Ok(v) = File::open(file) { + v + } else { + return Ok(false); + }; let tar = GzDecoder::new(tar_gz); let mut archive = Archive::new(tar); diff --git a/packages/cli/src/plugin/mod.rs b/packages/cli/src/plugin/mod.rs index 97adaf08f..481dd0984 100644 --- a/packages/cli/src/plugin/mod.rs +++ b/packages/cli/src/plugin/mod.rs @@ -317,12 +317,11 @@ impl PluginManager { let name = i.get::<_, String>("name").unwrap(); let loader = i.get::<_, bool>("loader").unwrap(); - let text = - if loader { - format!("{name} [:loader]") - } else { - name - }; + let text = if loader { + format!("{name} [:loader]") + } else { + name + }; res.push(text); } } diff --git a/packages/cli/src/server/output.rs b/packages/cli/src/server/output.rs index 92a286c9a..71323dd29 100644 --- a/packages/cli/src/server/output.rs +++ b/packages/cli/src/server/output.rs @@ -22,13 +22,12 @@ pub fn print_console_info( options: PrettierOptions, web_info: Option, ) { - if let Ok(native_clearseq) = - Command::new(if cfg!(target_os = "windows") { - "cls" - } else { - "clear" - }) - .output() + if let Ok(native_clearseq) = Command::new(if cfg!(target_os = "windows") { + "cls" + } else { + "clear" + }) + .output() { print!("{}", String::from_utf8_lossy(&native_clearseq.stdout)); } else { @@ -47,18 +46,17 @@ pub fn print_console_info( } else { "Default" }; - let url_rewrite = - if config - .dioxus_config - .web - .watcher - .index_on_404 - .unwrap_or(false) - { - "True" - } else { - "False" - }; + let url_rewrite = if config + .dioxus_config + .web + .watcher + .index_on_404 + .unwrap_or(false) + { + "True" + } else { + "False" + }; let proxies = config.dioxus_config.web.proxy.as_ref(); diff --git a/packages/cli/src/server/web/mod.rs b/packages/cli/src/server/web/mod.rs index f507f78e6..0e1413597 100644 --- a/packages/cli/src/server/web/mod.rs +++ b/packages/cli/src/server/web/mod.rs @@ -165,7 +165,9 @@ async fn get_rustls(config: &CrateConfig) -> Result> { get_rustls_without_mkcert(web_config)? }; - Ok(Some(RustlsConfig::from_pem_file(cert_path, key_path).await?)) + Ok(Some( + RustlsConfig::from_pem_file(cert_path, key_path).await?, + )) } fn get_rustls_with_mkcert(web_config: &WebHttpsConfig) -> Result<(String, String)> { @@ -312,11 +314,10 @@ async fn setup_router( )); // Setup routes - router = - router - .route("/_dioxus/hot_reload", get(hot_reload_handler)) - .layer(cors) - .layer(Extension(ws_reload)); + router = router + .route("/_dioxus/hot_reload", get(hot_reload_handler)) + .layer(cors) + .layer(Extension(ws_reload)); if let Some(hot_reload) = hot_reload { router = router.layer(Extension(hot_reload)) diff --git a/packages/cli/src/tools.rs b/packages/cli/src/tools.rs index 9b8801e0a..4045b236e 100644 --- a/packages/cli/src/tools.rs +++ b/packages/cli/src/tools.rs @@ -162,11 +162,10 @@ impl Tool { ) } Self::Tailwind => { - let windows_extension = - match self.target_platform() { - "windows" => ".exe", - _ => "", - }; + let windows_extension = match self.target_platform() { + "windows" => ".exe", + _ => "", + }; format!( "https://github.com/tailwindlabs/tailwindcss/releases/download/{version}/tailwindcss-{target}-x64{optional_ext}", version = self.tool_version(), @@ -281,30 +280,29 @@ impl Tool { pub fn call(&self, command: &str, args: Vec<&str>) -> anyhow::Result> { let bin_path = tools_path().join(self.name()).join(self.bin_path()); - let command_file = - match self { - Tool::Binaryen => { - if cfg!(target_os = "windows") { - format!("{}.exe", command) - } else { - command.to_string() - } + let command_file = match self { + Tool::Binaryen => { + if cfg!(target_os = "windows") { + format!("{}.exe", command) + } else { + command.to_string() } - Tool::Sass => { - if cfg!(target_os = "windows") { - format!("{}.bat", command) - } else { - command.to_string() - } + } + Tool::Sass => { + if cfg!(target_os = "windows") { + format!("{}.bat", command) + } else { + command.to_string() } - Tool::Tailwind => { - if cfg!(target_os = "windows") { - format!("{}.exe", command) - } else { - command.to_string() - } + } + Tool::Tailwind => { + if cfg!(target_os = "windows") { + format!("{}.exe", command) + } else { + command.to_string() } - }; + } + }; if !bin_path.join(&command_file).is_file() { return Err(anyhow::anyhow!("Command file not found.")); diff --git a/packages/core-macro/src/component_body_deserializers/inline_props.rs b/packages/core-macro/src/component_body_deserializers/inline_props.rs index e56ba32b2..d51132623 100644 --- a/packages/core-macro/src/component_body_deserializers/inline_props.rs +++ b/packages/core-macro/src/component_body_deserializers/inline_props.rs @@ -67,12 +67,11 @@ fn get_props_struct(component_body: &ComponentBody) -> ItemStruct { let struct_ident = Ident::new(&format!("{fn_ident}Props"), fn_ident.span()); - let first_lifetime = - if let Some(GenericParam::Lifetime(lt)) = generics.params.first() { - Some(lt) - } else { - None - }; + let first_lifetime = if let Some(GenericParam::Lifetime(lt)) = generics.params.first() { + Some(lt) + } else { + None + }; let struct_attrs = if first_lifetime.is_some() { quote! { #[derive(Props)] } @@ -251,18 +250,16 @@ fn get_function(component_body: &ComponentBody) -> ItemFn { let struct_ident = Ident::new(&format!("{fn_ident}Props"), fn_ident.span()); // Skip first arg since that's the context - let struct_field_names = - inputs.iter().skip(1).filter_map(|f| match f { - FnArg::Receiver(_) => unreachable!(), // ComponentBody prohibits receiver parameters. - FnArg::Typed(pt) => Some(&pt.pat), - }); + let struct_field_names = inputs.iter().skip(1).filter_map(|f| match f { + FnArg::Receiver(_) => unreachable!(), // ComponentBody prohibits receiver parameters. + FnArg::Typed(pt) => Some(&pt.pat), + }); - let first_lifetime = - if let Some(GenericParam::Lifetime(lt)) = generics.params.first() { - Some(lt) - } else { - None - }; + let first_lifetime = if let Some(GenericParam::Lifetime(lt)) = generics.params.first() { + Some(lt) + } else { + None + }; let (scope_lifetime, fn_generics) = if let Some(lt) = first_lifetime { (quote! { #lt, }, generics.clone()) diff --git a/packages/core-macro/src/props/mod.rs b/packages/core-macro/src/props/mod.rs index 6a87fb7ad..6e6c43d66 100644 --- a/packages/core-macro/src/props/mod.rs +++ b/packages/core-macro/src/props/mod.rs @@ -41,10 +41,16 @@ pub fn impl_my_derive(ast: &syn::DeriveInput) -> Result { } } syn::Fields::Unnamed(_) => { - return Err(Error::new(ast.span(), "Props is not supported for tuple structs")) + return Err(Error::new( + ast.span(), + "Props is not supported for tuple structs", + )) } syn::Fields::Unit => { - return Err(Error::new(ast.span(), "Props is not supported for unit structs")) + return Err(Error::new( + ast.span(), + "Props is not supported for unit structs", + )) } }, syn::Data::Enum(_) => { @@ -328,9 +334,10 @@ mod field_info { } Ok(()) } - _ => { - Err(Error::new_spanned(&assign, format!("Unknown parameter {name:?}"))) - } + _ => Err(Error::new_spanned( + &assign, + format!("Unknown parameter {name:?}"), + )), } } @@ -445,13 +452,12 @@ fn type_from_inside_option(ty: &syn::Type, check_option_name: bool) -> Option<&s if check_option_name && segment.ident != "Option" { return None; } - let generic_params = if let syn::PathArguments::AngleBracketed(generic_params) = - &segment.arguments - { - generic_params - } else { - return None; - }; + let generic_params = + if let syn::PathArguments::AngleBracketed(generic_params) = &segment.arguments { + generic_params + } else { + return None; + }; if let syn::GenericArgument::Type(ty) = generic_params.args.first()? { Some(ty) } else { @@ -556,38 +562,37 @@ mod struct_info { } syn::GenericParam::Const(_cnst) => None, }); - let builder_method_doc = - match self.builder_attr.builder_method_doc { - Some(ref doc) => quote!(#doc), - None => { - let doc = format!( - " + let builder_method_doc = match self.builder_attr.builder_method_doc { + Some(ref doc) => quote!(#doc), + None => { + let doc = format!( + " Create a builder for building `{name}`. On the builder, call {setters} to set the values of the fields. Finally, call `.build()` to create the instance of `{name}`. ", - name = self.name, - setters = { - let mut result = String::new(); - let mut is_first = true; - for field in self.included_fields() { - use std::fmt::Write; - if is_first { - is_first = false; - } else { - write!(&mut result, ", ").unwrap(); - } - write!(&mut result, "`.{}(...)`", field.name).unwrap(); - if field.builder_attr.default.is_some() { - write!(&mut result, "(optional)").unwrap(); - } + name = self.name, + setters = { + let mut result = String::new(); + let mut is_first = true; + for field in self.included_fields() { + use std::fmt::Write; + if is_first { + is_first = false; + } else { + write!(&mut result, ", ").unwrap(); + } + write!(&mut result, "`.{}(...)`", field.name).unwrap(); + if field.builder_attr.default.is_some() { + write!(&mut result, "(optional)").unwrap(); } - result } - ); - quote!(#doc) - } - }; + result + } + ); + quote!(#doc) + } + }; let builder_type_doc = if self.builder_attr.doc { match self.builder_attr.builder_type_doc { Some(ref doc) => quote!(#[doc = #doc]), @@ -618,11 +623,10 @@ Finally, call `.build()` to create the instance of `{name}`. false => quote! { self == other }, }; - let is_static = - match are_there_generics { - true => quote! { false }, - false => quote! { true }, - }; + let is_static = match are_there_generics { + true => quote! { false }, + false => quote! { true }, + }; Ok(quote! { impl #impl_generics #name #ty_generics #where_clause { @@ -707,15 +711,14 @@ Finally, call `.build()` to create the instance of `{name}`. ref builder_name, .. } = *self; - let descructuring = - self.included_fields().map(|f| { - if f.ordinal == field.ordinal { - quote!(_) - } else { - let name = f.name; - quote!(#name) - } - }); + let descructuring = self.included_fields().map(|f| { + if f.ordinal == field.ordinal { + quote!(_) + } else { + let name = f.name; + quote!(#name) + } + }); let reconstructing = self.included_fields().map(|f| f.name); let mut ty_generics: Vec = self @@ -782,17 +785,16 @@ Finally, call `.build()` to create the instance of `{name}`. // NOTE: both auto_into and strip_option affect `arg_type` and `arg_expr`, but the order of // nesting is different so we have to do this little dance. - let arg_type = - if field.builder_attr.strip_option { - field.type_from_inside_option(false).ok_or_else(|| { - Error::new_spanned( - field_type, - "can't `strip_option` - field is not `Option<...>`", - ) - })? - } else { - field_type - }; + let arg_type = if field.builder_attr.strip_option { + field.type_from_inside_option(false).ok_or_else(|| { + Error::new_spanned( + field_type, + "can't `strip_option` - field is not `Option<...>`", + ) + })? + } else { + field_type + }; let (arg_type, arg_expr) = if field.builder_attr.auto_into { ( quote!(impl ::core::convert::Into<#arg_type>), @@ -878,45 +880,44 @@ Finally, call `.build()` to create the instance of `{name}`. }) .collect(); let mut builder_generics_tuple = empty_type_tuple(); - let generics = - self.modify_generics(|g| { - let index_after_lifetime_in_generics = g - .params - .iter() - .filter(|arg| matches!(arg, syn::GenericParam::Lifetime(_))) - .count(); - for f in self.included_fields() { - if f.builder_attr.default.is_some() { - // `f` is not mandatory - it does not have it's own fake `build` method, so `field` will need - // to warn about missing `field` whether or not `f` is set. - assert!( - f.ordinal != field.ordinal, - "`required_field_impl` called for optional field {}", - field.name - ); - g.params - .insert(index_after_lifetime_in_generics, f.generic_ty_param()); - builder_generics_tuple.elems.push_value(f.type_ident()); - } else if f.ordinal < field.ordinal { - // Only add a `build` method that warns about missing `field` if `f` is set. If `f` is not set, - // `f`'s `build` method will warn, since it appears earlier in the argument list. - builder_generics_tuple - .elems - .push_value(f.tuplized_type_ty_param()); - } else if f.ordinal == field.ordinal { - builder_generics_tuple.elems.push_value(empty_type()); - } else { - // `f` appears later in the argument list after `field`, so if they are both missing we will - // show a warning for `field` and not for `f` - which means this warning should appear whether - // or not `f` is set. - g.params - .insert(index_after_lifetime_in_generics, f.generic_ty_param()); - builder_generics_tuple.elems.push_value(f.type_ident()); - } - - builder_generics_tuple.elems.push_punct(Default::default()); + let generics = self.modify_generics(|g| { + let index_after_lifetime_in_generics = g + .params + .iter() + .filter(|arg| matches!(arg, syn::GenericParam::Lifetime(_))) + .count(); + for f in self.included_fields() { + if f.builder_attr.default.is_some() { + // `f` is not mandatory - it does not have it's own fake `build` method, so `field` will need + // to warn about missing `field` whether or not `f` is set. + assert!( + f.ordinal != field.ordinal, + "`required_field_impl` called for optional field {}", + field.name + ); + g.params + .insert(index_after_lifetime_in_generics, f.generic_ty_param()); + builder_generics_tuple.elems.push_value(f.type_ident()); + } else if f.ordinal < field.ordinal { + // Only add a `build` method that warns about missing `field` if `f` is set. If `f` is not set, + // `f`'s `build` method will warn, since it appears earlier in the argument list. + builder_generics_tuple + .elems + .push_value(f.tuplized_type_ty_param()); + } else if f.ordinal == field.ordinal { + builder_generics_tuple.elems.push_value(empty_type()); + } else { + // `f` appears later in the argument list after `field`, so if they are both missing we will + // show a warning for `field` and not for `f` - which means this warning should appear whether + // or not `f` is set. + g.params + .insert(index_after_lifetime_in_generics, f.generic_ty_param()); + builder_generics_tuple.elems.push_value(f.type_ident()); } - }); + + builder_generics_tuple.elems.push_punct(Default::default()); + } + }); let index_after_lifetime_in_generics = builder_generics .iter() @@ -1138,9 +1139,10 @@ Finally, call `.build()` to create the instance of `{name}`. self.doc = true; Ok(()) } - _ => { - Err(Error::new_spanned(&assign, format!("Unknown parameter {name:?}"))) - } + _ => Err(Error::new_spanned( + &assign, + format!("Unknown parameter {name:?}"), + )), } } syn::Expr::Path(path) => { @@ -1151,9 +1153,10 @@ Finally, call `.build()` to create the instance of `{name}`. self.doc = true; Ok(()) } - _ => { - Err(Error::new_spanned(&path, format!("Unknown parameter {name:?}"))) - } + _ => Err(Error::new_spanned( + &path, + format!("Unknown parameter {name:?}"), + )), } } syn::Expr::Call(call) => { diff --git a/packages/core-macro/src/utils.rs b/packages/core-macro/src/utils.rs index 114a07e73..7e066f773 100644 --- a/packages/core-macro/src/utils.rs +++ b/packages/core-macro/src/utils.rs @@ -31,9 +31,9 @@ pub fn format_type_string(ty: &Type) -> String { // This should always be valid syntax. // Not Rust code, but syntax, which is the only thing that `syn` cares about. - let Ok(file_unformatted) = - syn::parse_file(&format!("{FORMATTED_TYPE_START}{ty_unformatted}{FORMATTED_TYPE_END}")) - else { + let Ok(file_unformatted) = syn::parse_file(&format!( + "{FORMATTED_TYPE_START}{ty_unformatted}{FORMATTED_TYPE_END}" + )) else { return ty_unformatted.to_string(); }; @@ -60,7 +60,10 @@ impl DeprecatedAttribute { /// Returns `None` if the given attribute was not a valid form of the `#[deprecated]` attribute. pub fn from_meta(meta: &Meta) -> syn::Result { if meta.path() != &parse_quote!(deprecated) { - return Err(syn::Error::new(meta.span(), "attribute path is not `deprecated`")); + return Err(syn::Error::new( + meta.span(), + "attribute path is not `deprecated`", + )); } match &meta { diff --git a/packages/core/src/create.rs b/packages/core/src/create.rs index b68cd6086..a61a8cace 100644 --- a/packages/core/src/create.rs +++ b/packages/core/src/create.rs @@ -36,14 +36,13 @@ fn sort_bfs(paths: &[&'static [u8]]) -> Vec<(usize, &'static [u8])> { #[test] #[cfg(debug_assertions)] fn sorting() { - let r: [(usize, &[u8]); 5] = - [ - (0, &[0, 1]), - (1, &[0, 2]), - (2, &[1, 0]), - (3, &[1, 0, 1]), - (4, &[1, 2]), - ]; + let r: [(usize, &[u8]); 5] = [ + (0, &[0, 1]), + (1, &[0, 2]), + (2, &[1, 0]), + (3, &[1, 0, 1]), + (4, &[1, 2]), + ]; assert_eq!( sort_bfs(&[&[0, 1,], &[0, 2,], &[1, 0,], &[1, 0, 1,], &[1, 2,],]), r diff --git a/packages/core/src/nodes.rs b/packages/core/src/nodes.rs index a1c6e7be9..c83b1059a 100644 --- a/packages/core/src/nodes.rs +++ b/packages/core/src/nodes.rs @@ -531,9 +531,9 @@ impl<'a> From<&'a AttributeValue<'a>> for BorrowedAttributeValue<'a> { } AttributeValue::Any(value) => { let value = value.borrow(); - BorrowedAttributeValue::Any( - std::cell::Ref::map(value, |value| &**value.as_ref().unwrap()) - ) + BorrowedAttributeValue::Any(std::cell::Ref::map(value, |value| { + &**value.as_ref().unwrap() + })) } AttributeValue::None => BorrowedAttributeValue::None, } diff --git a/packages/core/src/virtual_dom.rs b/packages/core/src/virtual_dom.rs index 4c8adfdb6..2d83ba63a 100644 --- a/packages/core/src/virtual_dom.rs +++ b/packages/core/src/virtual_dom.rs @@ -267,11 +267,10 @@ impl VirtualDom { suspended_scopes: Default::default(), }; - let root = - dom.new_scope( - Box::new(VProps::new(root, |_, _| unreachable!(), root_props)), - "app", - ); + let root = dom.new_scope( + Box::new(VProps::new(root, |_, _| unreachable!(), root_props)), + "app", + ); // Unlike react, we provide a default error boundary that just renders the error as a string root.provide_context(Rc::new(ErrorBoundary::new(ScopeId::ROOT))); diff --git a/packages/core/tests/attr_cleanup.rs b/packages/core/tests/attr_cleanup.rs index ea8135dd6..539a0b399 100644 --- a/packages/core/tests/attr_cleanup.rs +++ b/packages/core/tests/attr_cleanup.rs @@ -9,23 +9,20 @@ use dioxus_core::BorrowedAttributeValue; #[test] fn attrs_cycle() { - let mut dom = - VirtualDom::new(|cx| { - let id = cx.generation(); - match cx.generation() % 2 { - 0 => { - cx.render(rsx! { - div {} - }) + let mut dom = VirtualDom::new(|cx| { + let id = cx.generation(); + match cx.generation() % 2 { + 0 => cx.render(rsx! { + div {} + }), + 1 => cx.render(rsx! { + div { + h1 { class: "{id}", id: "{id}" } } - 1 => cx.render(rsx! { - div { - h1 { class: "{id}", id: "{id}" } - } - }), - _ => unreachable!(), - } - }); + }), + _ => unreachable!(), + } + }); let bump = Bump::new(); diff --git a/packages/core/tests/bubble_error.rs b/packages/core/tests/bubble_error.rs index 901f93f46..af2a34219 100644 --- a/packages/core/tests/bubble_error.rs +++ b/packages/core/tests/bubble_error.rs @@ -3,12 +3,11 @@ use dioxus::prelude::*; fn app(cx: Scope) -> Element { - let raw = - match cx.generation() % 2 { - 0 => "123.123", - 1 => "123.123.123", - _ => unreachable!(), - }; + let raw = match cx.generation() % 2 { + 0 => "123.123", + 1 => "123.123.123", + _ => unreachable!(), + }; let value = raw.parse::().unwrap_or(123.123); diff --git a/packages/core/tests/create_dom.rs b/packages/core/tests/create_dom.rs index b923a9eec..5e5005d3f 100644 --- a/packages/core/tests/create_dom.rs +++ b/packages/core/tests/create_dom.rs @@ -11,16 +11,15 @@ use dioxus_core::ElementId; #[test] fn test_original_diff() { - let mut dom = - VirtualDom::new(|cx| { - cx.render(rsx! { + let mut dom = VirtualDom::new(|cx| { + cx.render(rsx! { + div { div { - div { - "Hello, world!" - } + "Hello, world!" } - }) - }); + } + }) + }); let edits = dom.rebuild().santize(); @@ -83,12 +82,11 @@ fn create() { #[test] fn create_list() { - let mut dom = - VirtualDom::new(|cx| { - cx.render(rsx! { - (0..3).map(|f| rsx!( div { "hello" } )) - }) - }); + let mut dom = VirtualDom::new(|cx| { + cx.render(rsx! { + (0..3).map(|f| rsx!( div { "hello" } )) + }) + }); let _edits = dom.rebuild().santize(); @@ -162,17 +160,16 @@ fn create_components() { #[test] fn anchors() { - let mut dom = - VirtualDom::new(|cx| { - cx.render(rsx! { - if true { - rsx!( div { "hello" } ) - } - if false { - rsx!( div { "goodbye" } ) - } - }) - }); + let mut dom = VirtualDom::new(|cx| { + cx.render(rsx! { + if true { + rsx!( div { "hello" } ) + } + if false { + rsx!( div { "goodbye" } ) + } + }) + }); // note that the template under "false" doesn't show up since it's not loaded let edits = dom.rebuild().santize(); diff --git a/packages/core/tests/create_fragments.rs b/packages/core/tests/create_fragments.rs index 4e94fddbe..ee312f34b 100644 --- a/packages/core/tests/create_fragments.rs +++ b/packages/core/tests/create_fragments.rs @@ -24,13 +24,12 @@ fn empty_fragment_creates_nothing() { #[test] fn root_fragments_work() { - let mut vdom = - VirtualDom::new(|cx| { - cx.render(rsx!( - div { "hello" } - div { "goodbye" } - )) - }); + let mut vdom = VirtualDom::new(|cx| { + cx.render(rsx!( + div { "hello" } + div { "goodbye" } + )) + }); assert_eq!( vdom.rebuild().edits.last().unwrap(), diff --git a/packages/core/tests/diff_unkeyed_list.rs b/packages/core/tests/diff_unkeyed_list.rs index d51ecf452..b5be161ef 100644 --- a/packages/core/tests/diff_unkeyed_list.rs +++ b/packages/core/tests/diff_unkeyed_list.rs @@ -4,18 +4,17 @@ use pretty_assertions::assert_eq; #[test] fn list_creates_one_by_one() { - let mut dom = - VirtualDom::new(|cx| { - let gen = cx.generation(); + let mut dom = VirtualDom::new(|cx| { + let gen = cx.generation(); - cx.render(rsx! { - div { - (0..gen).map(|i| rsx! { - div { "{i}" } - }) - } - }) - }); + cx.render(rsx! { + div { + (0..gen).map(|i| rsx! { + div { "{i}" } + }) + } + }) + }); // load the div and then assign the empty fragment as a placeholder assert_eq!( @@ -74,18 +73,17 @@ fn list_creates_one_by_one() { #[test] fn removes_one_by_one() { - let mut dom = - VirtualDom::new(|cx| { - let gen = 3 - cx.generation() % 4; + let mut dom = VirtualDom::new(|cx| { + let gen = 3 - cx.generation() % 4; - cx.render(rsx! { - div { - (0..gen).map(|i| rsx! { - div { "{i}" } - }) - } - }) - }); + cx.render(rsx! { + div { + (0..gen).map(|i| rsx! { + div { "{i}" } + }) + } + }) + }); // load the div and then assign the empty fragment as a placeholder assert_eq!( @@ -152,17 +150,16 @@ fn removes_one_by_one() { #[test] fn list_shrink_multiroot() { - let mut dom = - VirtualDom::new(|cx| { - cx.render(rsx! { - div { - (0..cx.generation()).map(|i| rsx! { - div { "{i}" } - div { "{i}" } - }) - } - }) - }); + let mut dom = VirtualDom::new(|cx| { + cx.render(rsx! { + div { + (0..cx.generation()).map(|i| rsx! { + div { "{i}" } + div { "{i}" } + }) + } + }) + }); assert_eq!( dom.rebuild().santize().edits, diff --git a/packages/core/tests/fuzzing.rs b/packages/core/tests/fuzzing.rs index 4338a49c1..1523c4e22 100644 --- a/packages/core/tests/fuzzing.rs +++ b/packages/core/tests/fuzzing.rs @@ -8,7 +8,9 @@ fn random_ns() -> Option<&'static str> { let namespace = rand::random::() % 2; match namespace { 0 => None, - 1 => Some(Box::leak(format!("ns{}", rand::random::()).into_boxed_str())), + 1 => Some(Box::leak( + format!("ns{}", rand::random::()).into_boxed_str(), + )), _ => unreachable!(), } } @@ -20,15 +22,13 @@ fn create_random_attribute(attr_idx: &mut usize) -> TemplateAttribute<'static> { value: Box::leak(format!("value{}", rand::random::()).into_boxed_str()), namespace: random_ns(), }, - 1 => { - TemplateAttribute::Dynamic { - id: { - let old_idx = *attr_idx; - *attr_idx += 1; - old_idx - }, - } - } + 1 => TemplateAttribute::Dynamic { + id: { + let old_idx = *attr_idx; + *attr_idx += 1; + old_idx + }, + }, _ => unreachable!(), } } @@ -73,26 +73,22 @@ fn create_random_template_node( 1 => TemplateNode::Text { text: Box::leak(format!("{}", rand::random::()).into_boxed_str()), }, - 2 => { - TemplateNode::DynamicText { - id: { - let old_idx = *template_idx; - *template_idx += 1; - dynamic_node_types.push(DynamicNodeType::Text); - old_idx - }, - } - } - 3 => { - TemplateNode::Dynamic { - id: { - let old_idx = *template_idx; - *template_idx += 1; - dynamic_node_types.push(DynamicNodeType::Other); - old_idx - }, - } - } + 2 => TemplateNode::DynamicText { + id: { + let old_idx = *template_idx; + *template_idx += 1; + dynamic_node_types.push(DynamicNodeType::Text); + old_idx + }, + }, + 3 => TemplateNode::Dynamic { + id: { + let old_idx = *template_idx; + *template_idx += 1; + dynamic_node_types.push(DynamicNodeType::Other); + old_idx + }, + }, _ => unreachable!(), } } @@ -211,9 +207,9 @@ fn create_random_dynamic_node(cx: &ScopeState, depth: usize) -> DynamicNode { fn create_random_dynamic_attr(cx: &ScopeState) -> Attribute { let value = match rand::random::() % 7 { - 0 => { - AttributeValue::Text(Box::leak(format!("{}", rand::random::()).into_boxed_str())) - } + 0 => AttributeValue::Text(Box::leak( + format!("{}", rand::random::()).into_boxed_str(), + )), 1 => AttributeValue::Float(rand::random()), 2 => AttributeValue::Int(rand::random()), 3 => AttributeValue::Bool(rand::random()), @@ -276,32 +272,31 @@ fn create_random_element(cx: Scope) -> Element { .into_boxed_str(), )); // println!("{template:#?}"); - let node = - VNode { - key: None, - parent: None, - template: Cell::new(template), - root_ids: bumpalo::collections::Vec::new_in(cx.bump()).into(), - dynamic_nodes: { - let dynamic_nodes: Vec<_> = dynamic_node_types - .iter() - .map(|ty| match ty { - DynamicNodeType::Text => DynamicNode::Text(VText::new(Box::leak( - format!("{}", rand::random::()).into_boxed_str(), - ))), - DynamicNodeType::Other => { - create_random_dynamic_node(cx, cx.props.depth + 1) - } - }) - .collect(); - cx.bump().alloc(dynamic_nodes) - }, - dynamic_attrs: cx.bump().alloc( - (0..template.attr_paths.len()) - .map(|_| create_random_dynamic_attr(cx)) - .collect::>(), - ), - }; + let node = VNode { + key: None, + parent: None, + template: Cell::new(template), + root_ids: bumpalo::collections::Vec::new_in(cx.bump()).into(), + dynamic_nodes: { + let dynamic_nodes: Vec<_> = dynamic_node_types + .iter() + .map(|ty| match ty { + DynamicNodeType::Text => DynamicNode::Text(VText::new(Box::leak( + format!("{}", rand::random::()).into_boxed_str(), + ))), + DynamicNodeType::Other => { + create_random_dynamic_node(cx, cx.props.depth + 1) + } + }) + .collect(); + cx.bump().alloc(dynamic_nodes) + }, + dynamic_attrs: cx.bump().alloc( + (0..template.attr_paths.len()) + .map(|_| create_random_dynamic_attr(cx)) + .collect::>(), + ), + }; Some(node) } _ => None, diff --git a/packages/desktop/headless_tests/rendering.rs b/packages/desktop/headless_tests/rendering.rs index 31dc28256..0907121d4 100644 --- a/packages/desktop/headless_tests/rendering.rs +++ b/packages/desktop/headless_tests/rendering.rs @@ -34,13 +34,12 @@ fn use_inner_html(cx: &ScopeState, id: &'static str) -> Option { to_owned![value, eval_provider]; async move { tokio::time::sleep(std::time::Duration::from_millis(100)).await; - let html = - eval_provider(&format!( - r#"let element = document.getElementById('{}'); + let html = eval_provider(&format!( + r#"let element = document.getElementById('{}'); return element.innerHTML"#, - id - )) - .unwrap(); + id + )) + .unwrap(); if let Ok(serde_json::Value::String(html)) = html.await { println!("html: {}", html); value.set(Some(html)); diff --git a/packages/desktop/src/cfg.rs b/packages/desktop/src/cfg.rs index 3b0409ae8..ba42ffa01 100644 --- a/packages/desktop/src/cfg.rs +++ b/packages/desktop/src/cfg.rs @@ -36,7 +36,7 @@ pub struct Config { pub(crate) root_name: String, pub(crate) background_color: Option<(u8, u8, u8, u8)>, pub(crate) last_window_close_behaviour: WindowCloseBehaviour, - pub(crate) enable_default_menu_bar: bool, + pub(crate) disable_default_menu_bar: bool, } type DropHandler = Box bool>; @@ -66,15 +66,13 @@ impl Config { root_name: "main".to_string(), background_color: None, last_window_close_behaviour: WindowCloseBehaviour::LastWindowExitsApp, - enable_default_menu_bar: true, + disable_default_menu_bar: false, } } - /// Set whether the default menu bar should be enabled. - /// - /// > Note: `enable` is `true` by default. To disable the default menu bar pass `false`. - pub fn with_default_menu_bar(mut self, enable: bool) -> Self { - self.enable_default_menu_bar = enable; + /// Set whether the default menu bar should be disabled. + pub fn with_disable_default_menu_bar(mut self, disable: bool) -> Self { + self.disable_default_menu_bar = disable; self } diff --git a/packages/desktop/src/lib.rs b/packages/desktop/src/lib.rs index 7b8f024be..63a8914f3 100644 --- a/packages/desktop/src/lib.rs +++ b/packages/desktop/src/lib.rs @@ -240,20 +240,18 @@ pub fn launch_with_props(root: Component

, props: P, cfg: Config) Event::UserEvent(event) => match event.0 { #[cfg(all(feature = "hot-reload", debug_assertions))] - EventData::HotReloadEvent(msg) => { - match msg { - dioxus_hot_reload::HotReloadMsg::UpdateTemplate(template) => { - for webview in webviews.values_mut() { - webview.dom.replace_template(template); + EventData::HotReloadEvent(msg) => match msg { + dioxus_hot_reload::HotReloadMsg::UpdateTemplate(template) => { + for webview in webviews.values_mut() { + webview.dom.replace_template(template); - poll_vdom(webview); - } - } - dioxus_hot_reload::HotReloadMsg::Shutdown => { - *control_flow = ControlFlow::Exit; + poll_vdom(webview); } } - } + dioxus_hot_reload::HotReloadMsg::Shutdown => { + *control_flow = ControlFlow::Exit; + } + }, EventData::CloseWindow => { webviews.remove(&event.1); diff --git a/packages/desktop/src/webview.rs b/packages/desktop/src/webview.rs index f03878242..9beae702a 100644 --- a/packages/desktop/src/webview.rs +++ b/packages/desktop/src/webview.rs @@ -19,8 +19,8 @@ pub fn build( let index_file = cfg.custom_index.clone(); let root_name = cfg.root_name.clone(); - if cfg.enable_default_menu_bar { - builder = builder.with_menu(build_default_menu_bar()); + if !cfg.disable_default_menu_bar { + builder = builder.with_menu(create_default_menu_bar()); } let window = builder.with_visible(false).build(event_loop).unwrap(); @@ -103,12 +103,8 @@ pub fn build( (webview.build().unwrap(), web_context) } -/// Builds a standard menu bar depending on the users platform. It may be used as a starting point -/// to further customize the menu bar and pass it to a [`WindowBuilder`](tao::window::WindowBuilder). -/// > Note: The default menu bar enables macOS shortcuts like cut/copy/paste. -/// > The menu bar differs per platform because of constraints introduced -/// > by [`MenuItem`](tao::menu::MenuItem). -pub fn build_default_menu_bar() -> MenuBar { +/// Creates a standard menu bar depending on the platform +fn create_default_menu_bar() -> MenuBar { let mut menu_bar = MenuBar::new(); // since it is uncommon on windows to have an "application menu" diff --git a/packages/dioxus-tui/examples/all_terminal_events.rs b/packages/dioxus-tui/examples/all_terminal_events.rs index dd160c9b7..483e9afdf 100644 --- a/packages/dioxus-tui/examples/all_terminal_events.rs +++ b/packages/dioxus-tui/examples/all_terminal_events.rs @@ -40,10 +40,9 @@ fn app(cx: Scope) -> Element { rsx!(p { "{trimmed}" }) }); - let log_event = - move |event: Event| { - events.write().push(event); - }; + let log_event = move |event: Event| { + events.write().push(event); + }; cx.render(rsx! { div { diff --git a/packages/dioxus/benches/jsframework.rs b/packages/dioxus/benches/jsframework.rs index e313cdee6..b3405b2bd 100644 --- a/packages/dioxus/benches/jsframework.rs +++ b/packages/dioxus/benches/jsframework.rs @@ -87,34 +87,33 @@ impl Label { } } -static ADJECTIVES: &[&str] = - &[ - "pretty", - "large", - "big", - "small", - "tall", - "short", - "long", - "handsome", - "plain", - "quaint", - "clean", - "elegant", - "easy", - "angry", - "crazy", - "helpful", - "mushy", - "odd", - "unsightly", - "adorable", - "important", - "inexpensive", - "cheap", - "expensive", - "fancy", - ]; +static ADJECTIVES: &[&str] = &[ + "pretty", + "large", + "big", + "small", + "tall", + "short", + "long", + "handsome", + "plain", + "quaint", + "clean", + "elegant", + "easy", + "angry", + "crazy", + "helpful", + "mushy", + "odd", + "unsightly", + "adorable", + "important", + "inexpensive", + "cheap", + "expensive", + "fancy", +]; static COLOURS: &[&str] = &[ "red", "yellow", "blue", "green", "pink", "brown", "purple", "brown", "white", "black", diff --git a/packages/dioxus/examples/stress.rs b/packages/dioxus/examples/stress.rs index ef0bbbf6c..248d851d2 100644 --- a/packages/dioxus/examples/stress.rs +++ b/packages/dioxus/examples/stress.rs @@ -62,34 +62,33 @@ impl Label { } } -static ADJECTIVES: &[&str] = - &[ - "pretty", - "large", - "big", - "small", - "tall", - "short", - "long", - "handsome", - "plain", - "quaint", - "clean", - "elegant", - "easy", - "angry", - "crazy", - "helpful", - "mushy", - "odd", - "unsightly", - "adorable", - "important", - "inexpensive", - "cheap", - "expensive", - "fancy", - ]; +static ADJECTIVES: &[&str] = &[ + "pretty", + "large", + "big", + "small", + "tall", + "short", + "long", + "handsome", + "plain", + "quaint", + "clean", + "elegant", + "easy", + "angry", + "crazy", + "helpful", + "mushy", + "odd", + "unsightly", + "adorable", + "important", + "inexpensive", + "cheap", + "expensive", + "fancy", +]; static COLOURS: &[&str] = &[ "red", "yellow", "blue", "green", "pink", "brown", "purple", "brown", "white", "black", diff --git a/packages/fullstack/examples/axum-auth/src/main.rs b/packages/fullstack/examples/axum-auth/src/main.rs index ea7a0efe0..6643f718b 100644 --- a/packages/fullstack/examples/axum-auth/src/main.rs +++ b/packages/fullstack/examples/axum-auth/src/main.rs @@ -37,13 +37,12 @@ fn main() { //To enable Private cookies for integrity, and authenticity please check the next Example. let session_config = SessionConfig::default().with_table_name("test_table"); let auth_config = AuthConfig::::default().with_anonymous_user_id(Some(1)); - let session_store = - SessionStore::::new( - Some(pool.clone().into()), - session_config, - ) - .await - .unwrap(); + let session_store = SessionStore::::new( + Some(pool.clone().into()), + session_config, + ) + .await + .unwrap(); //Create the Database table for storing our Session Data. session_store.initiate().await.unwrap(); diff --git a/packages/fullstack/examples/static-hydrated/src/main.rs b/packages/fullstack/examples/static-hydrated/src/main.rs index 536971524..2539d0deb 100644 --- a/packages/fullstack/examples/static-hydrated/src/main.rs +++ b/packages/fullstack/examples/static-hydrated/src/main.rs @@ -16,9 +16,9 @@ use serde::{Deserialize, Serialize}; #[tokio::main] async fn main() { pre_cache_static_routes_with_props( - &ServeConfigBuilder::new_with_router( - dioxus_fullstack::router::FullstackRouterConfig::::default() - ) + &ServeConfigBuilder::new_with_router(dioxus_fullstack::router::FullstackRouterConfig::< + Route, + >::default()) .assets_path("docs") .incremental(IncrementalRendererConfig::default().static_dir("docs")) .build(), diff --git a/packages/fullstack/src/adapters/axum_adapter.rs b/packages/fullstack/src/adapters/axum_adapter.rs index 089784c94..41a7c92be 100644 --- a/packages/fullstack/src/adapters/axum_adapter.rs +++ b/packages/fullstack/src/adapters/axum_adapter.rs @@ -280,13 +280,12 @@ where let assets_path = assets_path.into(); // Serve all files in dist folder except index.html - let dir = - std::fs::read_dir(&assets_path).unwrap_or_else(|e| { - panic!( - "Couldn't read assets directory at {:?}: {}", - &assets_path, e - ) - }); + let dir = std::fs::read_dir(&assets_path).unwrap_or_else(|e| { + panic!( + "Couldn't read assets directory at {:?}: {}", + &assets_path, e + ) + }); for entry in dir.flatten() { let path = entry.path(); @@ -298,9 +297,9 @@ where .unwrap() .iter() .map(|segment| { - segment.to_str().unwrap_or_else( - || panic!("Failed to convert path segment {:?} to string", segment) - ) + segment.to_str().unwrap_or_else(|| { + panic!("Failed to convert path segment {:?} to string", segment) + }) }) .collect::>() .join("/"); diff --git a/packages/fullstack/src/adapters/salvo_adapter.rs b/packages/fullstack/src/adapters/salvo_adapter.rs index 9953a1192..674722665 100644 --- a/packages/fullstack/src/adapters/salvo_adapter.rs +++ b/packages/fullstack/src/adapters/salvo_adapter.rs @@ -244,13 +244,12 @@ impl DioxusRouterExt for Router { let assets_path = assets_path.into(); // Serve all files in dist folder except index.html - let dir = - std::fs::read_dir(&assets_path).unwrap_or_else(|e| { - panic!( - "Couldn't read assets directory at {:?}: {}", - &assets_path, e - ) - }); + let dir = std::fs::read_dir(&assets_path).unwrap_or_else(|e| { + panic!( + "Couldn't read assets directory at {:?}: {}", + &assets_path, e + ) + }); for entry in dir.flatten() { let path = entry.path(); @@ -262,9 +261,9 @@ impl DioxusRouterExt for Router { .unwrap() .iter() .map(|segment| { - segment.to_str().unwrap_or_else( - || panic!("Failed to convert path segment {:?} to string", segment) - ) + segment.to_str().unwrap_or_else(|| { + panic!("Failed to convert path segment {:?} to string", segment) + }) }) .collect::>() .join("/"); diff --git a/packages/fullstack/src/html_storage/deserialize.rs b/packages/fullstack/src/html_storage/deserialize.rs index 1c860a7a2..7fc70ba6c 100644 --- a/packages/fullstack/src/html_storage/deserialize.rs +++ b/packages/fullstack/src/html_storage/deserialize.rs @@ -7,14 +7,13 @@ use super::HTMLDataCursor; #[allow(unused)] pub(crate) fn serde_from_bytes(string: &[u8]) -> Option { - let decompressed = - match STANDARD.decode(string) { - Ok(bytes) => bytes, - Err(err) => { - tracing::error!("Failed to decode base64: {}", err); - return None; - } - }; + let decompressed = match STANDARD.decode(string) { + Ok(bytes) => bytes, + Err(err) => { + tracing::error!("Failed to decode base64: {}", err); + return None; + } + }; match postcard::from_bytes(&decompressed) { Ok(data) => Some(data), diff --git a/packages/fullstack/src/layer.rs b/packages/fullstack/src/layer.rs index 3b68fa2d6..10e67b3f5 100644 --- a/packages/fullstack/src/layer.rs +++ b/packages/fullstack/src/layer.rs @@ -46,9 +46,11 @@ where > + Send, >, > { - let fut = self.call(req).instrument( - tracing::trace_span!("service", "{}", std::any::type_name::()) - ); + let fut = self.call(req).instrument(tracing::trace_span!( + "service", + "{}", + std::any::type_name::() + )); Box::pin(async move { fut.await.map_err(|err| err.into()) }) } } diff --git a/packages/fullstack/src/render.rs b/packages/fullstack/src/render.rs index f14b97acc..cda41f82c 100644 --- a/packages/fullstack/src/render.rs +++ b/packages/fullstack/src/render.rs @@ -91,11 +91,10 @@ impl SsrRendererPool { Ok((freshness, html)) } Self::Incremental(pool) => { - let mut renderer = pool - .write() - .unwrap() - .pop() - .unwrap_or_else(|| incremental_pre_renderer(cfg.incremental.as_ref().unwrap())); + let mut renderer = + pool.write().unwrap().pop().unwrap_or_else(|| { + incremental_pre_renderer(cfg.incremental.as_ref().unwrap()) + }); let (tx, rx) = tokio::sync::oneshot::channel(); diff --git a/packages/fullstack/src/serve_config.rs b/packages/fullstack/src/serve_config.rs index 4d1a3c007..75a473c89 100644 --- a/packages/fullstack/src/serve_config.rs +++ b/packages/fullstack/src/serve_config.rs @@ -122,16 +122,14 @@ fn load_index_html(path: PathBuf, root_id: &'static str) -> IndexHtml { let (pre_main, post_main) = contents.split_once(&format!("id=\"{root_id}\"")).unwrap_or_else(|| panic!("Failed to find id=\"{root_id}\" in index.html. The id is used to inject the application into the page.")); - let post_main = - post_main.split_once('>').unwrap_or_else( - || panic!("Failed to find closing > after id=\"{root_id}\" in index.html.") - ); + let post_main = post_main.split_once('>').unwrap_or_else(|| { + panic!("Failed to find closing > after id=\"{root_id}\" in index.html.") + }); - let (pre_main, post_main) = - ( - pre_main.to_string() + &format!("id=\"{root_id}\"") + post_main.0 + ">", - post_main.1.to_string(), - ); + let (pre_main, post_main) = ( + pre_main.to_string() + &format!("id=\"{root_id}\"") + post_main.0 + ">", + post_main.1.to_string(), + ); IndexHtml { pre_main, diff --git a/packages/fullstack/src/server_context.rs b/packages/fullstack/src/server_context.rs index 7d1bc63fe..6f3b4b6c9 100644 --- a/packages/fullstack/src/server_context.rs +++ b/packages/fullstack/src/server_context.rs @@ -22,9 +22,9 @@ impl Default for DioxusServerContext { fn default() -> Self { Self { shared_context: std::sync::Arc::new(std::sync::RwLock::new(anymap::Map::new())), - response_parts: std::sync::Arc::new( - RwLock::new(http::response::Response::new(()).into_parts().0) - ), + response_parts: std::sync::Arc::new(RwLock::new( + http::response::Response::new(()).into_parts().0, + )), parts: std::sync::Arc::new(RwLock::new(http::request::Request::new(()).into_parts().0)), html_data: Arc::new(RwLock::new(HTMLData::default())), } @@ -45,9 +45,9 @@ mod server_fn_impl { Self { parts: parts.into(), shared_context: Arc::new(RwLock::new(SendSyncAnyMap::new())), - response_parts: std::sync::Arc::new( - RwLock::new(http::response::Response::new(()).into_parts().0) - ), + response_parts: std::sync::Arc::new(RwLock::new( + http::response::Response::new(()).into_parts().0, + )), html_data: Arc::new(RwLock::new(HTMLData::default())), } } @@ -221,9 +221,9 @@ impl FromServerContext for FromContext { type Rejection = NotFoundInServerContext; async fn from_request(req: &DioxusServerContext) -> Result { - Ok(Self(req.clone().get::().ok_or_else( - || NotFoundInServerContext::(std::marker::PhantomData::) - )?)) + Ok(Self(req.clone().get::().ok_or_else(|| { + NotFoundInServerContext::(std::marker::PhantomData::) + })?)) } } diff --git a/packages/hooks/src/use_coroutine.rs b/packages/hooks/src/use_coroutine.rs index c7990d0d1..f2577b90c 100644 --- a/packages/hooks/src/use_coroutine.rs +++ b/packages/hooks/src/use_coroutine.rs @@ -129,12 +129,11 @@ mod tests { use futures_util::StreamExt; fn app(cx: Scope, name: String) -> Element { - let task = - use_coroutine(cx, |mut rx: UnboundedReceiver| async move { - while let Some(msg) = rx.next().await { - println!("got message: {msg}"); - } - }); + let task = use_coroutine(cx, |mut rx: UnboundedReceiver| async move { + while let Some(msg) = rx.next().await { + println!("got message: {msg}"); + } + }); let task2 = use_coroutine(cx, view_task); diff --git a/packages/hooks/src/use_shared_state.rs b/packages/hooks/src/use_shared_state.rs index 54b7f720f..37226c759 100644 --- a/packages/hooks/src/use_shared_state.rs +++ b/packages/hooks/src/use_shared_state.rs @@ -226,12 +226,10 @@ impl UseSharedState { pub fn read(&self) -> Ref<'_, T> { match self.try_read() { Ok(value) => value, - Err(message) => { - panic!( - "Reading the shared state failed: {}\n({:?})", - message, message - ) - } + Err(message) => panic!( + "Reading the shared state failed: {}\n({:?})", + message, message + ), } } @@ -260,12 +258,10 @@ impl UseSharedState { pub fn write(&self) -> RefMut<'_, T> { match self.try_write() { Ok(value) => value, - Err(message) => { - panic!( - "Writing to shared state failed: {}\n({:?})", - message, message - ) - } + Err(message) => panic!( + "Writing to shared state failed: {}\n({:?})", + message, message + ), } } @@ -288,12 +284,10 @@ impl UseSharedState { pub fn write_silent(&self) -> RefMut<'_, T> { match self.try_write_silent() { Ok(value) => value, - Err(message) => { - panic!( - "Writing to shared state silently failed: {}\n({:?})", - message, message - ) - } + Err(message) => panic!( + "Writing to shared state silently failed: {}\n({:?})", + message, message + ), } } @@ -369,13 +363,12 @@ impl PartialEq for UseSharedState { /// ``` pub fn use_shared_state_provider(cx: &ScopeState, f: impl FnOnce() -> T) { cx.use_hook(|| { - let state: ProvidedState = - Rc::new(RefCell::new(ProvidedStateInner { - value: f(), - notify_any: cx.schedule_update_any(), - consumers: HashSet::new(), - gen: 0, - })); + let state: ProvidedState = Rc::new(RefCell::new(ProvidedStateInner { + value: f(), + notify_any: cx.schedule_update_any(), + consumers: HashSet::new(), + gen: 0, + })); cx.provide_context(state); }); diff --git a/packages/hooks/src/use_state.rs b/packages/hooks/src/use_state.rs index 21120abf0..254493510 100644 --- a/packages/hooks/src/use_state.rs +++ b/packages/hooks/src/use_state.rs @@ -35,37 +35,36 @@ pub fn use_state( cx: &ScopeState, initial_state_fn: impl FnOnce() -> T, ) -> &UseState { - let hook = - cx.use_hook(move || { - let current_val = Rc::new(initial_state_fn()); - let update_callback = cx.schedule_update(); - let slot = Rc::new(RefCell::new(current_val.clone())); - let setter = Rc::new({ - to_owned![update_callback, slot]; - move |new| { - { - let mut slot = slot.borrow_mut(); + let hook = cx.use_hook(move || { + let current_val = Rc::new(initial_state_fn()); + let update_callback = cx.schedule_update(); + let slot = Rc::new(RefCell::new(current_val.clone())); + let setter = Rc::new({ + to_owned![update_callback, slot]; + move |new| { + { + let mut slot = slot.borrow_mut(); - // if there's only one reference (weak or otherwise), we can just swap the values - // Typically happens when the state is set multiple times - we don't want to create a new Rc for each new value - if let Some(val) = Rc::get_mut(&mut slot) { - *val = new; - } else { - *slot = Rc::new(new); - } + // if there's only one reference (weak or otherwise), we can just swap the values + // Typically happens when the state is set multiple times - we don't want to create a new Rc for each new value + if let Some(val) = Rc::get_mut(&mut slot) { + *val = new; + } else { + *slot = Rc::new(new); } - update_callback(); } - }); - - UseState { - current_val, - update_callback, - setter, - slot, + update_callback(); } }); + UseState { + current_val, + update_callback, + setter, + slot, + } + }); + hook.current_val = hook.slot.borrow().clone(); hook diff --git a/packages/liveview/examples/axum.rs b/packages/liveview/examples/axum.rs index b188e8270..6584d5e9b 100644 --- a/packages/liveview/examples/axum.rs +++ b/packages/liveview/examples/axum.rs @@ -37,9 +37,9 @@ async fn main() { .route( "/", get(move || async move { - index_page_with_glue( - &dioxus_liveview::interpreter_glue(&format!("ws://{addr}/ws")) - ) + index_page_with_glue(&dioxus_liveview::interpreter_glue(&format!( + "ws://{addr}/ws" + ))) }), ) .route( diff --git a/packages/liveview/src/pool.rs b/packages/liveview/src/pool.rs index 05e892f47..2fd06cec6 100644 --- a/packages/liveview/src/pool.rs +++ b/packages/liveview/src/pool.rs @@ -112,14 +112,13 @@ impl LiveViewSocket for S where /// You might need to transform the error types of the web backend into the LiveView error type. pub async fn run(mut vdom: VirtualDom, ws: impl LiveViewSocket) -> Result<(), LiveViewError> { #[cfg(all(feature = "hot-reload", debug_assertions))] - let mut hot_reload_rx = - { - let (tx, rx) = tokio::sync::mpsc::unbounded_channel(); - dioxus_hot_reload::connect(move |template| { - let _ = tx.send(template); - }); - rx - }; + let mut hot_reload_rx = { + let (tx, rx) = tokio::sync::mpsc::unbounded_channel(); + dioxus_hot_reload::connect(move |template| { + let _ = tx.send(template); + }); + rx + }; // Create the a proxy for query engine let (query_tx, mut query_rx) = tokio::sync::mpsc::unbounded_channel(); diff --git a/packages/native-core-macro/src/lib.rs b/packages/native-core-macro/src/lib.rs index 3d5ba4464..fdaa12cf5 100644 --- a/packages/native-core-macro/src/lib.rs +++ b/packages/native-core-macro/src/lib.rs @@ -66,13 +66,12 @@ pub fn partial_derive_state(_: TokenStream, input: TokenStream) -> TokenStream { Some(tuple) => { let mut parent_dependencies = Vec::new(); for type_ in &tuple.elems { - let mut type_ = - extract_type_path(type_).unwrap_or_else(|| { - panic!( - "ParentDependencies must be a tuple of type paths, found {}", - quote!(#type_) - ) - }); + let mut type_ = extract_type_path(type_).unwrap_or_else(|| { + panic!( + "ParentDependencies must be a tuple of type paths, found {}", + quote!(#type_) + ) + }); if type_ == self_path { type_ = this_type.clone(); } @@ -81,24 +80,21 @@ pub fn partial_derive_state(_: TokenStream, input: TokenStream) -> TokenStream { } parent_dependencies } - _ => { - panic!( - "ParentDependencies must be a tuple, found {}", - quote!(#parent_dependencies) - ) - } + _ => panic!( + "ParentDependencies must be a tuple, found {}", + quote!(#parent_dependencies) + ), }; let child_dependencies = match extract_tuple(child_dependencies) { Some(tuple) => { let mut child_dependencies = Vec::new(); for type_ in &tuple.elems { - let mut type_ = - extract_type_path(type_).unwrap_or_else(|| { - panic!( - "ChildDependencies must be a tuple of type paths, found {}", - quote!(#type_) - ) - }); + let mut type_ = extract_type_path(type_).unwrap_or_else(|| { + panic!( + "ChildDependencies must be a tuple of type paths, found {}", + quote!(#type_) + ) + }); if type_ == self_path { type_ = this_type.clone(); } @@ -107,39 +103,34 @@ pub fn partial_derive_state(_: TokenStream, input: TokenStream) -> TokenStream { } child_dependencies } - _ => { - panic!( - "ChildDependencies must be a tuple, found {}", - quote!(#child_dependencies) - ) - } + _ => panic!( + "ChildDependencies must be a tuple, found {}", + quote!(#child_dependencies) + ), }; - let node_dependencies = - match extract_tuple(node_dependencies) { - Some(tuple) => { - let mut node_dependencies = Vec::new(); - for type_ in &tuple.elems { - let mut type_ = extract_type_path(type_).unwrap_or_else(|| { - panic!( - "NodeDependencies must be a tuple of type paths, found {}", - quote!(#type_) - ) - }); - if type_ == self_path { - type_ = this_type.clone(); - } - combined_dependencies.insert(type_.clone()); - node_dependencies.push(type_); + let node_dependencies = match extract_tuple(node_dependencies) { + Some(tuple) => { + let mut node_dependencies = Vec::new(); + for type_ in &tuple.elems { + let mut type_ = extract_type_path(type_).unwrap_or_else(|| { + panic!( + "NodeDependencies must be a tuple of type paths, found {}", + quote!(#type_) + ) + }); + if type_ == self_path { + type_ = this_type.clone(); } - node_dependencies + combined_dependencies.insert(type_.clone()); + node_dependencies.push(type_); } - _ => { - panic!( - "NodeDependencies must be a tuple, found {}", - quote!(#node_dependencies) - ) - } - }; + node_dependencies + } + _ => panic!( + "NodeDependencies must be a tuple, found {}", + quote!(#node_dependencies) + ), + }; combined_dependencies.insert(this_type.clone()); let combined_dependencies: Vec<_> = combined_dependencies.into_iter().collect(); diff --git a/packages/native-core/examples/custom_attr.rs b/packages/native-core/examples/custom_attr.rs index 1089766ed..e7bbb36ea 100644 --- a/packages/native-core/examples/custom_attr.rs +++ b/packages/native-core/examples/custom_attr.rs @@ -160,13 +160,12 @@ impl State for Border { _context: &SendAnyMap, ) -> bool { // check if the node contians a border attribute - let new = - Self( - node_view - .attributes() - .and_then(|mut attrs| attrs.next().map(|a| a.attribute.name == "border")) - .is_some(), - ); + let new = Self( + node_view + .attributes() + .and_then(|mut attrs| attrs.next().map(|a| a.attribute.name == "border")) + .is_some(), + ); // check if the member has changed let changed = new != *self; *self = new; diff --git a/packages/native-core/examples/simple.rs b/packages/native-core/examples/simple.rs index 02ce83886..276d06d08 100644 --- a/packages/native-core/examples/simple.rs +++ b/packages/native-core/examples/simple.rs @@ -151,13 +151,12 @@ impl State for Border { _context: &SendAnyMap, ) -> bool { // check if the node contians a border attribute - let new = - Self( - node_view - .attributes() - .and_then(|mut attrs| attrs.next().map(|a| a.attribute.name == "border")) - .is_some(), - ); + let new = Self( + node_view + .attributes() + .and_then(|mut attrs| attrs.next().map(|a| a.attribute.name == "border")) + .is_some(), + ); // check if the member has changed let changed = new != *self; *self = new; diff --git a/packages/native-core/examples/simple_dioxus.rs b/packages/native-core/examples/simple_dioxus.rs index d3f1cdfcb..af0e4ca00 100644 --- a/packages/native-core/examples/simple_dioxus.rs +++ b/packages/native-core/examples/simple_dioxus.rs @@ -152,13 +152,12 @@ impl State for Border { _context: &SendAnyMap, ) -> bool { // check if the node contians a border attribute - let new = - Self( - node_view - .attributes() - .and_then(|mut attrs| attrs.next().map(|a| a.attribute.name == "border")) - .is_some(), - ); + let new = Self( + node_view + .attributes() + .and_then(|mut attrs| attrs.next().map(|a| a.attribute.name == "border")) + .is_some(), + ); // check if the member has changed let changed = new != *self; *self = new; diff --git a/packages/native-core/src/layout_attributes.rs b/packages/native-core/src/layout_attributes.rs index c5c2c2aa4..4eb39292b 100644 --- a/packages/native-core/src/layout_attributes.rs +++ b/packages/native-core/src/layout_attributes.rs @@ -340,27 +340,26 @@ pub fn apply_layout_attributes_cfg( } Property::JustifyContent(justify, _) => { use AlignContent::*; - style.justify_content = - match justify { - align::JustifyContent::ContentDistribution(distribution) => { - match distribution { - align::ContentDistribution::SpaceBetween => Some(SpaceBetween), - align::ContentDistribution::SpaceAround => Some(SpaceAround), - align::ContentDistribution::SpaceEvenly => Some(SpaceEvenly), - _ => return, - } + style.justify_content = match justify { + align::JustifyContent::ContentDistribution(distribution) => { + match distribution { + align::ContentDistribution::SpaceBetween => Some(SpaceBetween), + align::ContentDistribution::SpaceAround => Some(SpaceAround), + align::ContentDistribution::SpaceEvenly => Some(SpaceEvenly), + _ => return, } - align::JustifyContent::ContentPosition { - value: position, .. - } => match position { - align::ContentPosition::Center => Some(Center), - align::ContentPosition::Start => Some(Start), - align::ContentPosition::FlexStart => Some(FlexStart), - align::ContentPosition::End => Some(End), - align::ContentPosition::FlexEnd => Some(FlexEnd), - }, - _ => return, - }; + } + align::JustifyContent::ContentPosition { + value: position, .. + } => match position { + align::ContentPosition::Center => Some(Center), + align::ContentPosition::Start => Some(Start), + align::ContentPosition::FlexStart => Some(FlexStart), + align::ContentPosition::End => Some(End), + align::ContentPosition::FlexEnd => Some(FlexEnd), + }, + _ => return, + }; } Property::AlignSelf(align, _) => { use AlignItems::*; @@ -586,13 +585,11 @@ fn convert_grid_track_size(input: grid::TrackSize) -> NonRepeatedTrackSizingFunc convert_track_breadth_min(&min), convert_track_breadth_max(&max), ), - grid::TrackSize::FitContent(limit) => { - match limit { - DimensionPercentage::Dimension(LengthValue::Px(len)) => minmax(auto(), points(len)), - DimensionPercentage::Percentage(Percentage(pct)) => minmax(auto(), percent(pct)), - _ => unimplemented!(), - } - } + grid::TrackSize::FitContent(limit) => match limit { + DimensionPercentage::Dimension(LengthValue::Px(len)) => minmax(auto(), points(len)), + DimensionPercentage::Percentage(Percentage(pct)) => minmax(auto(), percent(pct)), + _ => unimplemented!(), + }, } } diff --git a/packages/native-core/src/utils/persistant_iterator.rs b/packages/native-core/src/utils/persistant_iterator.rs index fbaab5bed..2442af29f 100644 --- a/packages/native-core/src/utils/persistant_iterator.rs +++ b/packages/native-core/src/utils/persistant_iterator.rs @@ -488,5 +488,8 @@ fn persist_instertions_after() { )); let text = "hello world".to_string(); let idx = iter.next(&rdom).id(); - assert!(matches!(&*rdom.get(idx).unwrap().node_type(), NodeType::Text(text))); + assert!(matches!( + &*rdom.get(idx).unwrap().node_type(), + NodeType::Text(text) + )); } diff --git a/packages/native-core/tests/fuzzing.rs b/packages/native-core/tests/fuzzing.rs index 6c56178f8..4f0a34b70 100644 --- a/packages/native-core/tests/fuzzing.rs +++ b/packages/native-core/tests/fuzzing.rs @@ -9,7 +9,9 @@ fn random_ns() -> Option<&'static str> { let namespace = rand::random::() % 2; match namespace { 0 => None, - 1 => Some(Box::leak(format!("ns{}", rand::random::()).into_boxed_str())), + 1 => Some(Box::leak( + format!("ns{}", rand::random::()).into_boxed_str(), + )), _ => unreachable!(), } } @@ -21,15 +23,13 @@ fn create_random_attribute(attr_idx: &mut usize) -> TemplateAttribute<'static> { value: Box::leak(format!("value{}", rand::random::()).into_boxed_str()), namespace: random_ns(), }, - 1 => { - TemplateAttribute::Dynamic { - id: { - let old_idx = *attr_idx; - *attr_idx += 1; - old_idx - }, - } - } + 1 => TemplateAttribute::Dynamic { + id: { + let old_idx = *attr_idx; + *attr_idx += 1; + old_idx + }, + }, _ => unreachable!(), } } @@ -74,26 +74,22 @@ fn create_random_template_node( 1 => TemplateNode::Text { text: Box::leak(format!("{}", rand::random::()).into_boxed_str()), }, - 2 => { - TemplateNode::DynamicText { - id: { - let old_idx = *template_idx; - *template_idx += 1; - dynamic_node_types.push(DynamicNodeType::Text); - old_idx - }, - } - } - 3 => { - TemplateNode::Dynamic { - id: { - let old_idx = *template_idx; - *template_idx += 1; - dynamic_node_types.push(DynamicNodeType::Other); - old_idx - }, - } - } + 2 => TemplateNode::DynamicText { + id: { + let old_idx = *template_idx; + *template_idx += 1; + dynamic_node_types.push(DynamicNodeType::Text); + old_idx + }, + }, + 3 => TemplateNode::Dynamic { + id: { + let old_idx = *template_idx; + *template_idx += 1; + dynamic_node_types.push(DynamicNodeType::Other); + old_idx + }, + }, _ => unreachable!(), } } @@ -210,9 +206,9 @@ fn create_random_dynamic_node(cx: &ScopeState, depth: usize) -> DynamicNode { fn create_random_dynamic_attr(cx: &ScopeState) -> Attribute { let value = match rand::random::() % 6 { - 0 => { - AttributeValue::Text(Box::leak(format!("{}", rand::random::()).into_boxed_str())) - } + 0 => AttributeValue::Text(Box::leak( + format!("{}", rand::random::()).into_boxed_str(), + )), 1 => AttributeValue::Float(rand::random()), 2 => AttributeValue::Int(rand::random()), 3 => AttributeValue::Bool(rand::random()), diff --git a/packages/rink/src/focus.rs b/packages/rink/src/focus.rs index 3f1ebb2d8..704d13b46 100644 --- a/packages/rink/src/focus.rs +++ b/packages/rink/src/focus.rs @@ -83,37 +83,36 @@ impl State for Focus { _: &SendAnyMap, ) -> bool { let new = Focus { - level: - if let Some(a) = node_view - .attributes() - .and_then(|mut a| a.find(|a| a.attribute.name == "tabindex")) + level: if let Some(a) = node_view + .attributes() + .and_then(|mut a| a.find(|a| a.attribute.name == "tabindex")) + { + if let Some(index) = a + .value + .as_int() + .or_else(|| a.value.as_text().and_then(|v| v.parse::().ok())) { - if let Some(index) = a - .value - .as_int() - .or_else(|| a.value.as_text().and_then(|v| v.parse::().ok())) - { - match index.cmp(&0) { - Ordering::Less => FocusLevel::Unfocusable, - Ordering::Equal => FocusLevel::Focusable, - Ordering::Greater => { - FocusLevel::Ordered(NonZeroU16::new(index as u16).unwrap()) - } + match index.cmp(&0) { + Ordering::Less => FocusLevel::Unfocusable, + Ordering::Equal => FocusLevel::Focusable, + Ordering::Greater => { + FocusLevel::Ordered(NonZeroU16::new(index as u16).unwrap()) } - } else { - FocusLevel::Unfocusable } - } else if node_view - .listeners() - .and_then( - |mut listeners| listeners.any(|l| FOCUS_EVENTS.contains(&l)).then_some(()) - ) - .is_some() - { - FocusLevel::Focusable } else { FocusLevel::Unfocusable - }, + } + } else if node_view + .listeners() + .and_then(|mut listeners| { + listeners.any(|l| FOCUS_EVENTS.contains(&l)).then_some(()) + }) + .is_some() + { + FocusLevel::Focusable + } else { + FocusLevel::Unfocusable + }, }; if *self != new { *self = new; diff --git a/packages/rink/src/hooks.rs b/packages/rink/src/hooks.rs index 7afed77e4..f8c4500d2 100644 --- a/packages/rink/src/hooks.rs +++ b/packages/rink/src/hooks.rs @@ -585,14 +585,13 @@ impl RinkInputHandler { let queued_events = Rc::new(RefCell::new(Vec::new())); let queued_events2 = Rc::downgrade(&queued_events); - let regester_event = - move |evt: crossterm::event::Event| { - if let Some(evt) = get_event(evt) { - if let Some(v) = queued_events2.upgrade() { - (*v).borrow_mut().push(evt); - } + let regester_event = move |evt: crossterm::event::Event| { + if let Some(evt) = get_event(evt) { + if let Some(v) = queued_events2.upgrade() { + (*v).borrow_mut().push(evt); } - }; + } + }; let state = Rc::new(RefCell::new(InnerInputState::create(rdom))); @@ -681,49 +680,48 @@ fn get_event(evt: TermEvent) -> Option<(&'static str, EventData)> { let ctrl = m.modifiers.contains(KeyModifiers::CONTROL); let meta = false; - let get_mouse_data = - |crossterm_button: Option| { - let button = crossterm_button.map(|b| match b { - MouseButton::Left => DioxusMouseButton::Primary, - MouseButton::Right => DioxusMouseButton::Secondary, - MouseButton::Middle => DioxusMouseButton::Auxiliary, - }); + let get_mouse_data = |crossterm_button: Option| { + let button = crossterm_button.map(|b| match b { + MouseButton::Left => DioxusMouseButton::Primary, + MouseButton::Right => DioxusMouseButton::Secondary, + MouseButton::Middle => DioxusMouseButton::Auxiliary, + }); - // from https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent + // from https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent - // The `page` and `screen` coordinates are inconsistent with the MDN definition, as they are relative to the viewport (client), not the target element/page/screen, respectively. - // todo? - // But then, MDN defines them in terms of pixels, yet crossterm provides only row/column, and it might not be possible to get pixels. So we can't get 100% consistency anyway. - let coordinates = Coordinates::new( - ScreenPoint::new(x, y), - ClientPoint::new(x, y), - // offset x/y are set when the origin of the event is assigned to an element - ElementPoint::new(0., 0.), - PagePoint::new(x, y), - ); + // The `page` and `screen` coordinates are inconsistent with the MDN definition, as they are relative to the viewport (client), not the target element/page/screen, respectively. + // todo? + // But then, MDN defines them in terms of pixels, yet crossterm provides only row/column, and it might not be possible to get pixels. So we can't get 100% consistency anyway. + let coordinates = Coordinates::new( + ScreenPoint::new(x, y), + ClientPoint::new(x, y), + // offset x/y are set when the origin of the event is assigned to an element + ElementPoint::new(0., 0.), + PagePoint::new(x, y), + ); - let mut modifiers = Modifiers::empty(); - if shift { - modifiers.insert(Modifiers::SHIFT); - } - if ctrl { - modifiers.insert(Modifiers::CONTROL); - } - if meta { - modifiers.insert(Modifiers::META); - } - if alt { - modifiers.insert(Modifiers::ALT); - } + let mut modifiers = Modifiers::empty(); + if shift { + modifiers.insert(Modifiers::SHIFT); + } + if ctrl { + modifiers.insert(Modifiers::CONTROL); + } + if meta { + modifiers.insert(Modifiers::META); + } + if alt { + modifiers.insert(Modifiers::ALT); + } - // held mouse buttons get set later by maintaining state, as crossterm does not provide them - EventData::Mouse(MouseData::new( - coordinates, - button, - DioxusMouseButtons::empty(), - modifiers, - )) - }; + // held mouse buttons get set later by maintaining state, as crossterm does not provide them + EventData::Mouse(MouseData::new( + coordinates, + button, + DioxusMouseButtons::empty(), + modifiers, + )) + }; let get_wheel_data = |up| { let y = if up { -1.0 } else { 1.0 }; diff --git a/packages/rink/src/layout.rs b/packages/rink/src/layout.rs index f9a29408e..dbdadac3f 100644 --- a/packages/rink/src/layout.rs +++ b/packages/rink/src/layout.rs @@ -195,12 +195,11 @@ impl State for TaffyLayout { taffy.set_children(n, &child_layout).unwrap(); } } else { - self.node = - PossiblyUninitalized::Initialized( - taffy - .new_with_children(scaled_style, &child_layout) - .unwrap(), - ); + self.node = PossiblyUninitalized::Initialized( + taffy + .new_with_children(scaled_style, &child_layout) + .unwrap(), + ); changed = true; } } diff --git a/packages/rink/src/prevent_default.rs b/packages/rink/src/prevent_default.rs index d42516d9f..4ad5ad87f 100644 --- a/packages/rink/src/prevent_default.rs +++ b/packages/rink/src/prevent_default.rs @@ -43,28 +43,27 @@ impl State for PreventDefault { _: Vec<::ElementBorrowed<'a>>, _: &SendAnyMap, ) -> bool { - let new = - match node_view.attributes().and_then(|mut attrs| { - attrs - .find(|a| a.attribute.name == "dioxus-prevent-default") - .and_then(|a| a.value.as_text()) - }) { - Some("onfocus") => PreventDefault::Focus, - Some("onkeypress") => PreventDefault::KeyPress, - Some("onkeyrelease") => PreventDefault::KeyRelease, - Some("onkeydown") => PreventDefault::KeyDown, - Some("onkeyup") => PreventDefault::KeyUp, - Some("onclick") => PreventDefault::Click, - Some("onmousedown") => PreventDefault::MouseDown, - Some("onmouseup") => PreventDefault::MouseUp, - Some("onmouseenter") => PreventDefault::MouseEnter, - Some("onmouseover") => PreventDefault::MouseOver, - Some("onmouseleave") => PreventDefault::MouseLeave, - Some("onmouseout") => PreventDefault::MouseOut, - Some("onwheel") => PreventDefault::Wheel, - Some("oncontextmenu") => PreventDefault::ContextMenu, - _ => return false, - }; + let new = match node_view.attributes().and_then(|mut attrs| { + attrs + .find(|a| a.attribute.name == "dioxus-prevent-default") + .and_then(|a| a.value.as_text()) + }) { + Some("onfocus") => PreventDefault::Focus, + Some("onkeypress") => PreventDefault::KeyPress, + Some("onkeyrelease") => PreventDefault::KeyRelease, + Some("onkeydown") => PreventDefault::KeyDown, + Some("onkeyup") => PreventDefault::KeyUp, + Some("onclick") => PreventDefault::Click, + Some("onmousedown") => PreventDefault::MouseDown, + Some("onmouseup") => PreventDefault::MouseUp, + Some("onmouseenter") => PreventDefault::MouseEnter, + Some("onmouseover") => PreventDefault::MouseOver, + Some("onmouseleave") => PreventDefault::MouseLeave, + Some("onmouseout") => PreventDefault::MouseOut, + Some("onwheel") => PreventDefault::Wheel, + Some("oncontextmenu") => PreventDefault::ContextMenu, + _ => return false, + }; if new == *self { false } else { diff --git a/packages/rink/src/style.rs b/packages/rink/src/style.rs index efd300774..905cc4b34 100644 --- a/packages/rink/src/style.rs +++ b/packages/rink/src/style.rs @@ -350,26 +350,24 @@ pub fn convert(mode: RenderingMode, c: Color) -> Color { let rgb = to_rgb(c); Color::Rgb(rgb[0], rgb[1], rgb[2]) } - crate::RenderingMode::Ansi => { - match c { - Color::Indexed(_) => c, - _ => { - let rgb = to_rgb(c); - // 16-231: 6 Γ— 6 Γ— 6 color cube - // 232-255: 23 step grayscale - if rgb[0] == rgb[1] && rgb[1] == rgb[2] { - let idx = 232 + (rgb[0] as u16 * 23 / 255) as u8; - Color::Indexed(idx) - } else { - let r = (rgb[0] as u16 * 5) / 255; - let g = (rgb[1] as u16 * 5) / 255; - let b = (rgb[2] as u16 * 5) / 255; - let idx = 16 + r * 36 + g * 6 + b; - Color::Indexed(idx as u8) - } + crate::RenderingMode::Ansi => match c { + Color::Indexed(_) => c, + _ => { + let rgb = to_rgb(c); + // 16-231: 6 Γ— 6 Γ— 6 color cube + // 232-255: 23 step grayscale + if rgb[0] == rgb[1] && rgb[1] == rgb[2] { + let idx = 232 + (rgb[0] as u16 * 23 / 255) as u8; + Color::Indexed(idx) + } else { + let r = (rgb[0] as u16 * 5) / 255; + let g = (rgb[1] as u16 * 5) / 255; + let b = (rgb[2] as u16 * 5) / 255; + let idx = 16 + r * 36 + g * 6 + b; + Color::Indexed(idx as u8) } } - } + }, } } } diff --git a/packages/rink/src/widgets/button.rs b/packages/rink/src/widgets/button.rs index bc1b16c9f..523b2392a 100644 --- a/packages/rink/src/widgets/button.rs +++ b/packages/rink/src/widgets/button.rs @@ -90,12 +90,11 @@ impl Button { } fn switch(&mut self, ctx: &WidgetContext, node: NodeMut) { - let data = - FormData { - value: self.value.to_string(), - values: HashMap::new(), - files: None, - }; + let data = FormData { + value: self.value.to_string(), + values: HashMap::new(), + files: None, + }; ctx.send(crate::Event { id: node.id(), name: "input", diff --git a/packages/rink/src/widgets/slider.rs b/packages/rink/src/widgets/slider.rs index 1ed4f903e..7080b6c12 100644 --- a/packages/rink/src/widgets/slider.rs +++ b/packages/rink/src/widgets/slider.rs @@ -236,11 +236,10 @@ impl Slider { let id = root.id(); let rdom = root.real_dom_mut(); let world = rdom.raw_world_mut(); - let taffy = - { - let query: UniqueView = world.borrow().unwrap(); - query.stretch.clone() - }; + let taffy = { + let query: UniqueView = world.borrow().unwrap(); + query.stretch.clone() + }; let taffy = taffy.lock().unwrap(); @@ -268,11 +267,10 @@ impl CustomElement for Slider { panic!("input must be an element") }; - let value = - el.attributes.get(&OwnedAttributeDiscription { - name: "value".to_string(), - namespace: None, - }); + let value = el.attributes.get(&OwnedAttributeDiscription { + name: "value".to_string(), + namespace: None, + }); let value = value .and_then(|value| match value { OwnedAttributeValue::Text(text) => text.as_str().parse().ok(), @@ -303,12 +301,11 @@ impl CustomElement for Slider { let cursor_text = rdom.create_node("|".to_string()); let cursor_text_id = cursor_text.id(); - let mut cursor_span = - rdom.create_node(NodeType::Element(ElementNode { - tag: "div".to_string(), - attributes: [].into_iter().collect(), - ..Default::default() - })); + let mut cursor_span = rdom.create_node(NodeType::Element(ElementNode { + tag: "div".to_string(), + attributes: [].into_iter().collect(), + ..Default::default() + })); cursor_span.add_child(cursor_text_id); let cursor_span_id = cursor_span.id(); diff --git a/packages/router-macro/src/route.rs b/packages/router-macro/src/route.rs index dd2689698..26665e575 100644 --- a/packages/router-macro/src/route.rs +++ b/packages/router-macro/src/route.rs @@ -144,14 +144,13 @@ impl Route { _ => Vec::new(), }; - let (route_segments, query) = - { - parse_route_segments( - variant.ident.span(), - fields.iter().map(|f| (&f.0, &f.1)), - &route, - )? - }; + let (route_segments, query) = { + parse_route_segments( + variant.ident.span(), + fields.iter().map(|f| (&f.0, &f.1)), + &route, + )? + }; Ok(Self { ty, @@ -324,11 +323,10 @@ impl Route { pub fn error_type(&self) -> TokenStream2 { let error_name = self.error_ident(); - let child_type = - match &self.ty { - RouteType::Child(field) => Some(&field.ty), - RouteType::Leaf { .. } => None, - }; + let child_type = match &self.ty { + RouteType::Child(field) => Some(&field.ty), + RouteType::Leaf { .. } => None, + }; create_error_type(error_name, &self.segments, child_type) } diff --git a/packages/router-macro/src/segment.rs b/packages/router-macro/src/segment.rs index 510bc13a2..7e4e40662 100644 --- a/packages/router-macro/src/segment.rs +++ b/packages/router-macro/src/segment.rs @@ -135,11 +135,10 @@ pub fn parse_route_segments<'a>( ) -> syn::Result<(Vec, Option)> { let mut route_segments = Vec::new(); - let (route_string, query) = - match route.rsplit_once('?') { - Some((route, query)) => (route, Some(query)), - None => (route, None), - }; + let (route_string, query) = match route.rsplit_once('?') { + Some((route, query)) => (route, Some(query)), + None => (route, None), + }; let mut iterator = route_string.split('/'); // skip the first empty segment @@ -158,12 +157,11 @@ pub fn parse_route_segments<'a>( if let Some(segment) = segment.strip_prefix(':') { let spread = segment.starts_with(".."); - let ident = - if spread { - segment[2..].to_string() - } else { - segment.to_string() - }; + let ident = if spread { + segment[2..].to_string() + } else { + segment.to_string() + }; let field = fields.find(|(name, _)| **name == ident); @@ -207,15 +205,14 @@ pub fn parse_route_segments<'a>( let query_ident = Ident::new(query, Span::call_site()); let field = fields.find(|(name, _)| *name == &query_ident); - let ty = - if let Some((_, ty)) = field { - ty.clone() - } else { - return Err(syn::Error::new( - route_span, - format!("Could not find a field with the name '{}'", query_ident), - )); - }; + let ty = if let Some((_, ty)) = field { + ty.clone() + } else { + return Err(syn::Error::new( + route_span, + format!("Could not find a field with the name '{}'", query_ident), + )); + }; Some(QuerySegment { ident: query_ident, diff --git a/packages/router/src/history/liveview.rs b/packages/router/src/history/liveview.rs index a7ecc89f6..9ffb09c34 100644 --- a/packages/router/src/history/liveview.rs +++ b/packages/router/src/history/liveview.rs @@ -77,18 +77,17 @@ where self.routes.retain(|&lhs, _| lhs <= last_visited); } }; - let state = - match state { - Some(state) => { - self.current_index = state.index; - state - } - None => { - let index = depth - 1; - self.current_index = index; - State { index } - } - }; + let state = match state { + Some(state) => { + self.current_index = state.index; + state + } + None => { + let index = depth - 1; + self.current_index = index; + State { index } + } + }; self.routes.insert(state.index, route); state } diff --git a/packages/router/src/history/web.rs b/packages/router/src/history/web.rs index 80cde3173..789eed76e 100644 --- a/packages/router/src/history/web.rs +++ b/packages/router/src/history/web.rs @@ -302,16 +302,15 @@ where let s = self.listener_animation_frame.clone(); let d = self.do_scroll_restoration; - self.listener_navigation = - Some(EventListener::new(&self.window, "popstate", move |_| { - (*callback)(); - if d { - let mut s = s.lock().expect("unpoisoned scroll mutex"); - if let Some(current_state) = get_current::>(&h) { - *s = Some(current_state.scroll.scroll_to(w.clone())); - } + self.listener_navigation = Some(EventListener::new(&self.window, "popstate", move |_| { + (*callback)(); + if d { + let mut s = s.lock().expect("unpoisoned scroll mutex"); + if let Some(current_state) = get_current::>(&h) { + *s = Some(current_state.scroll.scroll_to(w.clone())); } - })); + } + })); } } @@ -378,15 +377,14 @@ where let s = self.listener_animation_frame.clone(); let d = self.do_scroll_restoration; - self.listener_navigation = - Some(EventListener::new(&self.window, "popstate", move |_| { - (*callback)(); - if d { - let mut s = s.lock().expect("unpoisoned scroll mutex"); - if let Some([x, y]) = get_current(&h) { - *s = Some(ScrollPosition { x, y }.scroll_to(w.clone())); - } + self.listener_navigation = Some(EventListener::new(&self.window, "popstate", move |_| { + (*callback)(); + if d { + let mut s = s.lock().expect("unpoisoned scroll mutex"); + if let Some([x, y]) = get_current(&h) { + *s = Some(ScrollPosition { x, y }.scroll_to(w.clone())); } - })); + } + })); } } diff --git a/packages/router/src/navigation.rs b/packages/router/src/navigation.rs index e84a8b381..2d7a3f90f 100644 --- a/packages/router/src/navigation.rs +++ b/packages/router/src/navigation.rs @@ -114,9 +114,11 @@ impl FromStr for NavigationTarget { fn from_str(s: &str) -> Result { match Url::parse(s) { Ok(_) => Ok(Self::External(s.to_string())), - Err(ParseError::RelativeUrlWithoutBase) => Ok(Self::Internal( - R::from_str(s).map_err(|e| NavigationTargetParseError::InvalidInternalURL(e))?, - )), + Err(ParseError::RelativeUrlWithoutBase) => { + Ok(Self::Internal(R::from_str(s).map_err(|e| { + NavigationTargetParseError::InvalidInternalURL(e) + })?)) + } Err(e) => Err(NavigationTargetParseError::InvalidUrl(e)), } } diff --git a/packages/router/src/routable.rs b/packages/router/src/routable.rs index 094dcafe1..b1bb6d915 100644 --- a/packages/router/src/routable.rs +++ b/packages/router/src/routable.rs @@ -134,12 +134,11 @@ impl> FromRouteSegments for I { /// A flattened version of [`Routable::SITE_MAP`]. /// This essentially represents a `Vec>`, which you can collect it into. -type SiteMapFlattened<'a> = - FlatMap< - Iter<'a, SiteMapSegment>, - Vec>, - fn(&SiteMapSegment) -> Vec>, - >; +type SiteMapFlattened<'a> = FlatMap< + Iter<'a, SiteMapSegment>, + Vec>, + fn(&SiteMapSegment) -> Vec>, +>; fn seg_strs_to_route(segs_maybe: &Option>) -> Option where diff --git a/packages/router/src/utils/use_router_internal.rs b/packages/router/src/utils/use_router_internal.rs index 32a71d13c..9ac33f5fb 100644 --- a/packages/router/src/utils/use_router_internal.rs +++ b/packages/router/src/utils/use_router_internal.rs @@ -11,15 +11,14 @@ use crate::prelude::*; /// - [`None`], when the current component isn't a descendant of a [`Link`] component. /// - Otherwise [`Some`]. pub(crate) fn use_router_internal(cx: &ScopeState) -> &Option { - let inner = - cx.use_hook(|| { - let router = cx.consume_context::()?; + let inner = cx.use_hook(|| { + let router = cx.consume_context::()?; - let id = cx.scope_id(); - router.subscribe(id); + let id = cx.scope_id(); + router.subscribe(id); - Some(Subscription { router, id }) - }); + Some(Subscription { router, id }) + }); cx.use_hook(|| inner.as_ref().map(|s| s.router.clone())) } diff --git a/packages/rsx-rosetta/tests/simple.rs b/packages/rsx-rosetta/tests/simple.rs index de5e1c6a9..b8fd095e1 100644 --- a/packages/rsx-rosetta/tests/simple.rs +++ b/packages/rsx-rosetta/tests/simple.rs @@ -36,8 +36,7 @@ fn simple_elements() { #[test] fn deeply_nested() { - let html = - r#" + let html = r#"

"# .trim(); @@ -28,8 +26,6 @@ fn simple_elements() { div { id: "asd", "hello world!" } div { r#for: "asd", "hello world!" } div { r#async: "asd", "hello world!" } - div { large_thing: "asd", "hello world!" } - ai_is_awesome { "hello world!" } }"#; pretty_assertions::assert_eq!(&out, &expected); } diff --git a/packages/rsx-rosetta/tests/web-component.rs b/packages/rsx-rosetta/tests/web-component.rs new file mode 100644 index 000000000..c7309e1b7 --- /dev/null +++ b/packages/rsx-rosetta/tests/web-component.rs @@ -0,0 +1,21 @@ +use html_parser::Dom; + +#[test] +fn web_components_translate() { + let html = r#" +
+ +
+ "# + .trim(); + + let dom = Dom::parse(html).unwrap(); + + let body = rsx_rosetta::rsx_from_html(&dom); + + let out = dioxus_autofmt::write_block_out(body).unwrap(); + + let expected = r#" + div { my-component {} }"#; + pretty_assertions::assert_eq!(&out, &expected); +} From bc557906fe798e0bd1403fb609d7a5e6eb5b62be Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Wed, 3 Jan 2024 15:18:37 -0600 Subject: [PATCH 381/447] fix formatting --- packages/fullstack/src/hooks/server_cached.rs | 2 +- packages/html/src/events/mouse.rs | 5 ++++- packages/rsx-rosetta/src/lib.rs | 14 ++++---------- 3 files changed, 9 insertions(+), 12 deletions(-) diff --git a/packages/fullstack/src/hooks/server_cached.rs b/packages/fullstack/src/hooks/server_cached.rs index 572efd2b7..b3f9113b5 100644 --- a/packages/fullstack/src/hooks/server_cached.rs +++ b/packages/fullstack/src/hooks/server_cached.rs @@ -15,7 +15,7 @@ use serde::{de::DeserializeOwned, Serialize}; /// let state1 = use_state(cx, || server_cached(|| { /// 1234 /// })); -/// +/// /// todo!() /// } /// ``` diff --git a/packages/html/src/events/mouse.rs b/packages/html/src/events/mouse.rs index ea5bf29d3..17128f4e4 100644 --- a/packages/html/src/events/mouse.rs +++ b/packages/html/src/events/mouse.rs @@ -148,7 +148,10 @@ impl_event! { /// ondoubleclick #[inline] -pub fn ondoubleclick<'a, E: crate::EventReturn, T>(_cx: &'a ::dioxus_core::ScopeState, mut _f: impl FnMut(::dioxus_core::Event) -> E + 'a) -> ::dioxus_core::Attribute<'a> { +pub fn ondoubleclick<'a, E: crate::EventReturn, T>( + _cx: &'a ::dioxus_core::ScopeState, + mut _f: impl FnMut(::dioxus_core::Event) -> E + 'a, +) -> ::dioxus_core::Attribute<'a> { ::dioxus_core::Attribute::new( "ondblclick", _cx.listener(move |e: ::dioxus_core::Event| { diff --git a/packages/rsx-rosetta/src/lib.rs b/packages/rsx-rosetta/src/lib.rs index e12c6f021..49b6b6fc7 100644 --- a/packages/rsx-rosetta/src/lib.rs +++ b/packages/rsx-rosetta/src/lib.rs @@ -2,8 +2,8 @@ #![doc(html_logo_url = "https://avatars.githubusercontent.com/u/79236386")] #![doc(html_favicon_url = "https://avatars.githubusercontent.com/u/79236386")] -use dioxus_html::{map_html_element_to_rsx, map_html_attribute_to_rsx}; use convert_case::{Case, Casing}; +use dioxus_html::{map_html_attribute_to_rsx, map_html_element_to_rsx}; use dioxus_rsx::{ BodyNode, CallBody, Component, Element, ElementAttr, ElementAttrNamed, ElementName, IfmtInput, }; @@ -33,10 +33,7 @@ pub fn rsx_node_from_html(node: &Node) -> Option { ElementName::Custom(LitStr::new(&el.name, Span::call_site())) } else { // otherwise, it might be an element that isn't supported yet - ElementName::Ident(Ident::new( - &el.name.to_case(Case::Snake), - Span::call_site(), - )) + ElementName::Ident(Ident::new(&el.name.to_case(Case::Snake), Span::call_site())) } }; @@ -51,10 +48,7 @@ pub fn rsx_node_from_html(node: &Node) -> Option { } else { Ident::new(name, Span::call_site()) }; - ElementAttr::AttrText { - value, - name: ident, - } + ElementAttr::AttrText { value, name: ident } } else { // If we don't recognize the attribute, we assume it's a custom attribute ElementAttr::CustomAttrText { @@ -65,7 +59,7 @@ pub fn rsx_node_from_html(node: &Node) -> Option { ElementAttrNamed { el_name: el_name.clone(), - attr + attr, } }) .collect(); From 422df68fea099edbf93f3e345dac05552c549801 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Wed, 3 Jan 2024 15:35:24 -0600 Subject: [PATCH 382/447] fix formatting --- packages/fullstack/src/hooks/server_cached.rs | 2 +- packages/html/src/events/mouse.rs | 5 ++++- 2 files changed, 5 insertions(+), 2 deletions(-) diff --git a/packages/fullstack/src/hooks/server_cached.rs b/packages/fullstack/src/hooks/server_cached.rs index 572efd2b7..b3f9113b5 100644 --- a/packages/fullstack/src/hooks/server_cached.rs +++ b/packages/fullstack/src/hooks/server_cached.rs @@ -15,7 +15,7 @@ use serde::{de::DeserializeOwned, Serialize}; /// let state1 = use_state(cx, || server_cached(|| { /// 1234 /// })); -/// +/// /// todo!() /// } /// ``` diff --git a/packages/html/src/events/mouse.rs b/packages/html/src/events/mouse.rs index ea5bf29d3..17128f4e4 100644 --- a/packages/html/src/events/mouse.rs +++ b/packages/html/src/events/mouse.rs @@ -148,7 +148,10 @@ impl_event! { /// ondoubleclick #[inline] -pub fn ondoubleclick<'a, E: crate::EventReturn, T>(_cx: &'a ::dioxus_core::ScopeState, mut _f: impl FnMut(::dioxus_core::Event) -> E + 'a) -> ::dioxus_core::Attribute<'a> { +pub fn ondoubleclick<'a, E: crate::EventReturn, T>( + _cx: &'a ::dioxus_core::ScopeState, + mut _f: impl FnMut(::dioxus_core::Event) -> E + 'a, +) -> ::dioxus_core::Attribute<'a> { ::dioxus_core::Attribute::new( "ondblclick", _cx.listener(move |e: ::dioxus_core::Event| { From 682beeccfd87ba1f6e06fd2d5b17bfcff9797253 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Wed, 3 Jan 2024 15:45:19 -0600 Subject: [PATCH 383/447] fallback to global attributes when mapping rsx rosetta html attribute names --- packages/html/src/elements.rs | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/packages/html/src/elements.rs b/packages/html/src/elements.rs index 03231c0e9..ca3f4aee7 100644 --- a/packages/html/src/elements.rs +++ b/packages/html/src/elements.rs @@ -345,6 +345,14 @@ macro_rules! builder_constructors { )* )* + if let Some(name) = crate::map_html_global_attributes_to_rsx(html) { + return Some(name); + } + + if let Some(name) = crate::map_html_svg_attributes_to_rsx(html) { + return Some(name); + } + None } From c56d3662e973f60b05ba06e29a38cfe1b34b1ff5 Mon Sep 17 00:00:00 2001 From: ealmloff Date: Thu, 4 Jan 2024 09:06:38 -0600 Subject: [PATCH 384/447] document the type name as optional in the server function docs (#1748) --- packages/server-macro/src/lib.rs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/server-macro/src/lib.rs b/packages/server-macro/src/lib.rs index 5ad9a682b..871de33bc 100644 --- a/packages/server-macro/src/lib.rs +++ b/packages/server-macro/src/lib.rs @@ -19,7 +19,7 @@ use syn::{ /// are enabled), it will instead make a network request to the server. /// /// You can specify one, two, or three arguments to the server function: -/// 1. **Required**: A type name that will be used to identify and register the server function +/// 1. *Optional*: A type name that will be used to identify and register the server function /// (e.g., `MyServerFn`). /// 2. *Optional*: A URL prefix at which the function will be mounted when it’s registered /// (e.g., `"/api"`). Defaults to `"/"`. From f913b2ce53483b9c352d0ba633e665d7017eb10b Mon Sep 17 00:00:00 2001 From: ealmloff Date: Thu, 4 Jan 2024 09:06:57 -0600 Subject: [PATCH 385/447] don't cache assets in the CLI (#1742) --- packages/cli/src/server/web/mod.rs | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/packages/cli/src/server/web/mod.rs b/packages/cli/src/server/web/mod.rs index 0e1413597..98ff1e078 100644 --- a/packages/cli/src/server/web/mod.rs +++ b/packages/cli/src/server/web/mod.rs @@ -11,6 +11,7 @@ use axum::{ body::{Full, HttpBody}, extract::{ws::Message, Extension, TypedHeader, WebSocketUpgrade}, http::{ + self, header::{HeaderName, HeaderValue}, Method, Response, StatusCode, }, @@ -262,7 +263,7 @@ async fn setup_router( .override_response_header(HeaderName::from_static("cross-origin-opener-policy"), coop) .and_then( move |response: Response| async move { - let response = if file_service_config + let mut response = if file_service_config .dioxus_config .web .watcher @@ -290,6 +291,13 @@ async fn setup_router( } else { response.map(|body| body.boxed()) }; + let headers = response.headers_mut(); + headers.insert( + http::header::CACHE_CONTROL, + HeaderValue::from_static("no-cache"), + ); + headers.insert(http::header::PRAGMA, HeaderValue::from_static("no-cache")); + headers.insert(http::header::EXPIRES, HeaderValue::from_static("0")); Ok(response) }, ) From f6acaba061edbd517f3dbdba8d542443e032ef9f Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Thu, 4 Jan 2024 17:04:56 -0600 Subject: [PATCH 386/447] fix compilation --- packages/core/src/error_boundary.rs | 8 +- packages/desktop/Cargo.toml | 3 +- packages/desktop/src/desktop_context.rs | 3 +- packages/desktop/src/lib.rs | 7 +- packages/desktop/src/protocol.rs | 15 ++- packages/desktop/src/shortcut.rs | 5 +- packages/desktop/src/webview.rs | 164 ++++++++++++------------ packages/rsx-rosetta/src/lib.rs | 20 +-- 8 files changed, 113 insertions(+), 112 deletions(-) diff --git a/packages/core/src/error_boundary.rs b/packages/core/src/error_boundary.rs index 2f64bea9f..d42f59395 100644 --- a/packages/core/src/error_boundary.rs +++ b/packages/core/src/error_boundary.rs @@ -286,7 +286,8 @@ fn default_handler<'a>(error: CapturedError) -> LazyNodes<'a, 'a> { attr_paths: &[], }; VNode { - parent: None, + parent: Default::default(), + stable_id: Default::default(), key: None, template: std::cell::Cell::new(TEMPLATE), root_ids: bumpalo::collections::Vec::with_capacity_in(1usize, __cx.bump()).into(), @@ -471,12 +472,13 @@ pub fn ErrorBoundary<'a>(cx: Scope<'a, ErrorBoundaryProps<'a>>) -> Element { attr_paths: &[], }; VNode { - parent: None, + parent: Default::default(), + stable_id: Default::default(), key: None, template: std::cell::Cell::new(TEMPLATE), root_ids: bumpalo::collections::Vec::with_capacity_in(1usize, __cx.bump()).into(), dynamic_nodes: __cx.bump().alloc([{ - let ___nodes = (&cx.props.children).into_vnode(__cx); + let ___nodes = (&cx.props.children).into_dyn_node(__cx); ___nodes }]), dynamic_attrs: __cx.bump().alloc([]), diff --git a/packages/desktop/Cargo.toml b/packages/desktop/Cargo.toml index 3d8c2d31b..1064d2c1e 100644 --- a/packages/desktop/Cargo.toml +++ b/packages/desktop/Cargo.toml @@ -59,13 +59,12 @@ tokio_runtime = ["tokio"] fullscreen = ["wry/fullscreen"] transparent = ["wry/transparent"] devtools = ["wry/devtools"] -dox = ["wry/dox"] hot-reload = ["dioxus-hot-reload"] gnu = [] [package.metadata.docs.rs] default-features = false -features = [ "dox", "tokio_runtime", "hot-reload" ] +features = ["tokio_runtime", "hot-reload"] [dev-dependencies] dioxus-core-macro = { workspace = true } diff --git a/packages/desktop/src/desktop_context.rs b/packages/desktop/src/desktop_context.rs index 79c943851..62a574d9b 100644 --- a/packages/desktop/src/desktop_context.rs +++ b/packages/desktop/src/desktop_context.rs @@ -466,9 +466,8 @@ pub fn use_wry_event_handler( cx: &ScopeState, handler: impl FnMut(&Event, &EventLoopWindowTarget) + 'static, ) -> &WryEventHandler { - let desktop = use_window(cx); cx.use_hook(move || { - let desktop = desktop.clone(); + let desktop = window(); let id = desktop.create_wry_event_handler(handler); diff --git a/packages/desktop/src/lib.rs b/packages/desktop/src/lib.rs index 63f030b3f..9460ca87d 100644 --- a/packages/desktop/src/lib.rs +++ b/packages/desktop/src/lib.rs @@ -22,6 +22,7 @@ use crate::query::QueryResult; use crate::shortcut::GlobalHotKeyEvent; pub use cfg::{Config, WindowCloseBehaviour}; pub use desktop_context::DesktopContext; +#[allow(deprecated)] pub use desktop_context::{ use_window, use_wry_event_handler, window, DesktopService, WryEventHandler, WryEventHandlerId, }; @@ -33,8 +34,8 @@ use dioxus_interpreter_js::binary_protocol::Channel; use element::DesktopElement; use eval::init_eval; use futures_util::{pin_mut, FutureExt}; -use rustc_hash::FxHashMap; pub use protocol::{use_asset_handler, AssetFuture, AssetHandler, AssetRequest, AssetResponse}; +use rustc_hash::FxHashMap; use shortcut::ShortcutRegistry; pub use shortcut::{use_global_shortcut, ShortcutHandle, ShortcutId, ShortcutRegistryError}; use std::cell::Cell; @@ -49,7 +50,7 @@ use tao::{ event::{Event, StartCause, WindowEvent}, event_loop::ControlFlow, }; -pub use webview::build_default_menu_bar; +// pub use webview::build_default_menu_bar; pub use wry; pub use wry::application as tao; use wry::application::event_loop::EventLoopBuilder; @@ -412,8 +413,8 @@ fn create_new_window( queue.clone(), event_handlers.clone(), shortcut_manager, - asset_handlers, edit_queue, + asset_handlers, )); let cx = dom.base_scope(); diff --git a/packages/desktop/src/protocol.rs b/packages/desktop/src/protocol.rs index f00221d85..61c6af661 100644 --- a/packages/desktop/src/protocol.rs +++ b/packages/desktop/src/protocol.rs @@ -1,5 +1,6 @@ +use crate::{window, DesktopContext}; use dioxus_core::ScopeState; -use dioxus_interpreter_js::{COMMON_JS, INTERPRETER_JS}; +use dioxus_interpreter_js::INTERPRETER_JS; use slab::Slab; use std::{ borrow::Cow, @@ -16,10 +17,8 @@ use tokio::{ }; use wry::{ http::{status::StatusCode, Request, Response}, - webview::RequestAsyncResponder, Result, }; -use crate::{use_window, DesktopContext}; use crate::desktop_context::EditQueue; @@ -52,7 +51,7 @@ fn module_loader(root_name: &str, headless: bool) -> String { } }"#, ); - + format!( r#" -"# - ) -} - -/// An arbitrary asset is an HTTP response containing a binary body. -pub type AssetResponse = Response>; - -/// A future that returns an [`AssetResponse`]. This future may be spawned in a new thread, -/// so it must be [`Send`], [`Sync`], and `'static`. -pub trait AssetFuture: Future> + Send + Sync + 'static {} -impl> + Send + Sync + 'static> AssetFuture for T {} - -#[derive(Debug, Clone)] -/// A request for an asset. This is a wrapper around [`Request>`] that provides methods specific to asset requests. -pub struct AssetRequest { - path: PathBuf, - request: Arc>>, -} - -impl AssetRequest { - /// Get the path the asset request is for - pub fn path(&self) -> &Path { - &self.path - } -} - -impl From>> for AssetRequest { - fn from(request: Request>) -> Self { - let decoded = urlencoding::decode(request.uri().path().trim_start_matches('/')) - .expect("expected URL to be UTF-8 encoded"); - let path = PathBuf::from(&*decoded); - Self { - request: Arc::new(request), - path, - } - } -} - -impl Deref for AssetRequest { - type Target = Request>; - - fn deref(&self) -> &Self::Target { - &self.request - } -} - -/// A handler that takes an [`AssetRequest`] and returns a future that either loads the asset, or returns `None`. -/// This handler is stashed indefinitely in a context object, so it must be `'static`. -pub trait AssetHandler: Send + Sync + 'static { - /// Handle an asset request, returning a future that either loads the asset, or returns `None` - fn handle_request(&self, request: &AssetRequest) -> F; -} - -impl F + Send + Sync + 'static> AssetHandler for T { - fn handle_request(&self, request: &AssetRequest) -> F { - self(request) - } -} - -type AssetHandlerRegistryInner = - Slab Pin> + Send + Sync + 'static>>; - -#[derive(Clone)] -pub struct AssetHandlerRegistry(Arc>); - -impl AssetHandlerRegistry { - pub fn new() -> Self { - AssetHandlerRegistry(Arc::new(RwLock::new(Slab::new()))) - } - - pub async fn register_handler(&self, f: impl AssetHandler) -> usize { - let mut registry = self.0.write().await; - registry.insert(Box::new(move |req| Box::pin(f.handle_request(req)))) - } - - pub async fn remove_handler(&self, id: usize) -> Option<()> { - let mut registry = self.0.write().await; - registry.try_remove(id).map(|_| ()) - } - - pub async fn try_handlers(&self, req: &AssetRequest) -> Option { - let registry = self.0.read().await; - for (_, handler) in registry.iter() { - if let Some(response) = handler(req).await { - return Some(response); - } - } - None - } -} - -/// A handle to a registered asset handler. -pub struct AssetHandlerHandle { - desktop: DesktopContext, - handler_id: Rc>, -} - -impl AssetHandlerHandle { - /// Returns the ID for this handle. - /// - /// Because registering an ID is asynchronous, this may return `None` if the - /// registration has not completed yet. - pub fn handler_id(&self) -> Option { - self.handler_id.get().copied() - } -} - -impl Drop for AssetHandlerHandle { - fn drop(&mut self) { - let cell = Rc::clone(&self.handler_id); - let desktop = Rc::clone(&self.desktop); - tokio::task::block_in_place(move || { - Handle::current().block_on(async move { - if let Some(id) = cell.get() { - desktop.asset_handlers.remove_handler(*id).await; - } - }) - }); - } -} - -/// Provide a callback to handle asset loading yourself. -/// -/// The callback takes a path as requested by the web view, and it should return `Some(response)` -/// if you want to load the asset, and `None` if you want to fallback on the default behavior. -pub fn use_asset_handler( - cx: &ScopeState, - handler: impl AssetHandler, -) -> &AssetHandlerHandle { - cx.use_hook(|| { - let desktop = crate::window(); - let handler_id = Rc::new(OnceCell::new()); - let handler_id_ref = Rc::clone(&handler_id); - let desktop_ref = Rc::clone(&desktop); - cx.push_future(async move { - let id = desktop.asset_handlers.register_handler(handler).await; - handler_id.set(id).unwrap(); - }); - AssetHandlerHandle { - desktop: desktop_ref, - handler_id: handler_id_ref, - } - }) -} - pub(super) async fn desktop_handler( request: Request>, custom_head: Option, custom_index: Option, root_name: &str, asset_handlers: &AssetHandlerRegistry, - edit_queue: &EditQueue, + edit_queue: &crate::edits::EditQueue, headless: bool, responder: wry::RequestAsyncResponder, ) { @@ -293,6 +119,26 @@ pub(super) async fn desktop_handler( } } +fn module_loader(root_name: &str, headless: bool) -> String { + format!( + r#" + +"# + ) +} + #[allow(unreachable_code)] fn get_asset_root() -> Option { /* diff --git a/packages/desktop/src/waker.rs b/packages/desktop/src/waker.rs index 11f23d8d8..488c8f677 100644 --- a/packages/desktop/src/waker.rs +++ b/packages/desktop/src/waker.rs @@ -1,5 +1,5 @@ use crate::desktop_context::{EventData, UserWindowEvent}; -use futures_util::{pin_mut, task::ArcWake, FutureExt}; +use futures_util::task::ArcWake; use std::sync::Arc; use tao::{event_loop::EventLoopProxy, window::WindowId}; @@ -8,7 +8,7 @@ use tao::{event_loop::EventLoopProxy, window::WindowId}; /// This lets the VirtualDom "come up for air" and process events while the main thread is blocked by the WebView. /// /// All other IO lives in the Tokio runtime, -pub fn tao_waker(proxy: &EventLoopProxy, id: WindowId) -> std::task::Waker { +pub fn tao_waker(proxy: EventLoopProxy, id: WindowId) -> std::task::Waker { struct DomHandle { proxy: EventLoopProxy, id: WindowId, @@ -27,8 +27,5 @@ pub fn tao_waker(proxy: &EventLoopProxy, id: WindowId) -> std:: } } - futures_util::task::waker(Arc::new(DomHandle { - id, - proxy: proxy.clone(), - })) + futures_util::task::waker(Arc::new(DomHandle { id, proxy })) } diff --git a/packages/desktop/src/webview.rs b/packages/desktop/src/webview.rs index 275678d73..537b3e241 100644 --- a/packages/desktop/src/webview.rs +++ b/packages/desktop/src/webview.rs @@ -1,26 +1,50 @@ -use crate::desktop_context::{EditQueue, EventData}; -use crate::protocol::{self, AssetHandlerRegistry}; -use crate::{desktop_context::UserWindowEvent, Config}; -use muda::{Menu, MenuItem, PredefinedMenuItem, Submenu}; +use std::{rc::Rc, task::Waker}; + +use crate::edits::{EditQueue, WebviewQueue}; +use crate::{ + assets::AssetHandlerRegistry, desktop_context::UserWindowEvent, waker::tao_waker, Config, + DesktopContext, +}; +use crate::{ + desktop_context::{EventData, WindowEventHandlers}, + eval::init_eval, + shortcut::ShortcutRegistry, +}; +use crate::{ + protocol::{self}, + DesktopService, +}; +use dioxus_core::VirtualDom; use tao::event_loop::{EventLoopProxy, EventLoopWindowTarget}; -use tao::window::Window; -use wry::http::Response; -use wry::{WebContext, WebView, WebViewBuilder}; +use wry::{WebContext, WebViewBuilder}; -pub(crate) fn build( - cfg: &mut Config, +pub struct WebviewHandler { + pub dom: VirtualDom, + pub desktop_context: DesktopContext, + pub waker: Waker, + + // Wry assumes the webcontext is alive for the lifetime of the webview. + // We need to keep the webcontext alive, otherwise the webview will crash + _web_context: WebContext, +} + +pub fn create_new_window( + mut cfg: Config, event_loop: &EventLoopWindowTarget, - proxy: EventLoopProxy, -) -> (WebView, WebContext, AssetHandlerRegistry, EditQueue, Window) { - let mut builder = cfg.window.clone(); + proxy: &EventLoopProxy, + dom: VirtualDom, + queue: &WebviewQueue, + event_handlers: &WindowEventHandlers, + shortcut_manager: ShortcutRegistry, +) -> WebviewHandler { + let window = cfg.window.clone().build(event_loop).unwrap(); - // TODO: restore the menu bar with muda: https://github.com/tauri-apps/muda/blob/dev/examples/wry.rs + // TODO: allow users to specify their own menubars, again :/ if cfg.enable_default_menu_bar { - // builder = builder.with_menu(build_default_menu_bar()); + use crate::menubar::*; + build_menu_bar(build_default_menu_bar(), &window); } - let window = builder.build(event_loop).unwrap(); - let window_id = window.id(); let file_handler = cfg.file_drop_handler.take(); let custom_head = cfg.custom_head.clone(); @@ -49,10 +73,13 @@ pub(crate) fn build( .with_transparent(cfg.window.window.transparent) .with_url("dioxus://index.html/") .unwrap() - .with_ipc_handler(move |payload: String| { - // defer the event to the main thread - if let Ok(message) = serde_json::from_str(&payload) { - _ = proxy.send_event(UserWindowEvent(EventData::Ipc(message), window_id)); + .with_ipc_handler({ + let proxy = proxy.clone(); + move |payload: String| { + // defer the event to the main thread + if let Ok(message) = serde_json::from_str(&payload) { + _ = proxy.send_event(UserWindowEvent(EventData::Ipc(message), window_id)); + } } }) .with_asynchronous_custom_protocol(String::from("dioxus"), { @@ -101,76 +128,49 @@ pub(crate) fn build( webview = webview.with_custom_protocol(name, move |r| handler(r)) } + const INITIALIZATION_SCRIPT: &str = r#" + if (document.addEventListener) { + document.addEventListener('contextmenu', function(e) { + e.preventDefault(); + }, false); + } else { + document.attachEvent('oncontextmenu', function() { + window.event.returnValue = false; + }); + } + "#; + if cfg.disable_context_menu { // in release mode, we don't want to show the dev tool or reload menus - webview = webview.with_initialization_script( - r#" - if (document.addEventListener) { - document.addEventListener('contextmenu', function(e) { - e.preventDefault(); - }, false); - } else { - document.attachEvent('oncontextmenu', function() { - window.event.returnValue = false; - }); - } - "#, - ) + webview = webview.with_initialization_script(INITIALIZATION_SCRIPT) } else { // in debug, we are okay with the reload menu showing and dev tool webview = webview.with_devtools(true); } - ( - webview.build().unwrap(), - web_context, - asset_handlers, - edit_queue, + let webview = webview.build().unwrap(); + + let desktop_context = Rc::from(DesktopService::new( window, - ) -} + webview, + proxy.clone(), + event_loop.clone(), + queue.clone(), + event_handlers.clone(), + shortcut_manager, + edit_queue, + asset_handlers, + )); -/// Builds a standard menu bar depending on the users platform. It may be used as a starting point -/// to further customize the menu bar and pass it to a [`WindowBuilder`](tao::window::WindowBuilder). -/// > Note: The default menu bar enables macOS shortcuts like cut/copy/paste. -/// > The menu bar differs per platform because of constraints introduced -/// > by [`MenuItem`](tao::menu::MenuItem). -pub fn build_default_menu_bar() -> Menu { - let menu = Menu::new(); + dom.base_scope().provide_context(desktop_context.clone()); - // since it is uncommon on windows to have an "application menu" - // we add a "window" menu to be more consistent across platforms with the standard menu - let window_menu = Submenu::new("Window", true); - window_menu - .append_items(&[ - &PredefinedMenuItem::fullscreen(None), - &PredefinedMenuItem::separator(), - &PredefinedMenuItem::hide(None), - &PredefinedMenuItem::hide_others(None), - &PredefinedMenuItem::show_all(None), - &PredefinedMenuItem::maximize(None), - &PredefinedMenuItem::minimize(None), - &PredefinedMenuItem::close_window(None), - &PredefinedMenuItem::separator(), - &PredefinedMenuItem::quit(None), - ]) - .unwrap(); + init_eval(dom.base_scope()); - let edit_menu = Submenu::new("Window", true); - edit_menu - .append_items(&[ - &PredefinedMenuItem::undo(None), - &PredefinedMenuItem::redo(None), - &PredefinedMenuItem::separator(), - &PredefinedMenuItem::cut(None), - &PredefinedMenuItem::copy(None), - &PredefinedMenuItem::paste(None), - &PredefinedMenuItem::separator(), - &PredefinedMenuItem::select_all(None), - ]) - .unwrap(); - - menu.append_items(&[&window_menu, &edit_menu]).unwrap(); - - menu + WebviewHandler { + // We want to poll the virtualdom and the event loop at the same time, so the waker will be connected to both + waker: tao_waker(proxy.clone(), desktop_context.window.id()), + desktop_context, + dom, + _web_context: web_context, + } } From 6e08703c6c18f5d82cda66825ee76a78900244df Mon Sep 17 00:00:00 2001 From: Jonathan Kelley Date: Thu, 4 Jan 2024 17:21:38 -0800 Subject: [PATCH 400/447] Fix compile issue --- packages/desktop/src/app.rs | 12 +++++++----- packages/desktop/src/desktop_context.rs | 6 +++--- 2 files changed, 10 insertions(+), 8 deletions(-) diff --git a/packages/desktop/src/app.rs b/packages/desktop/src/app.rs index 85e4eecbd..fac223ab0 100644 --- a/packages/desktop/src/app.rs +++ b/packages/desktop/src/app.rs @@ -334,12 +334,14 @@ impl App

{ let mut cx = std::task::Context::from_waker(&view.waker); loop { - let fut = view.dom.wait_for_work(); - pin_mut!(fut); + { + let fut = view.dom.wait_for_work(); + pin_mut!(fut); - match fut.poll_unpin(&mut cx) { - std::task::Poll::Ready(_) => {} - std::task::Poll::Pending => break, + match fut.poll_unpin(&mut cx) { + std::task::Poll::Ready(_) => {} + std::task::Poll::Pending => break, + } } send_edits(view.dom.render_immediate(), &view.desktop_context); diff --git a/packages/desktop/src/desktop_context.rs b/packages/desktop/src/desktop_context.rs index af1204b06..866056558 100644 --- a/packages/desktop/src/desktop_context.rs +++ b/packages/desktop/src/desktop_context.rs @@ -34,6 +34,9 @@ pub fn window() -> DesktopContext { dioxus_core::prelude::consume_context().unwrap() } +/// A handle to the [`DesktopService`] that can be passed around. +pub type DesktopContext = Rc; + /// An imperative interface to the current window. /// /// To get a handle to the current window, use the [`use_window`] hook. @@ -78,9 +81,6 @@ pub struct DesktopService { pub(crate) views: Rc>>, } -/// A handle to the [`DesktopService`] that can be passed around. -pub type DesktopContext = Rc; - /// A smart pointer to the current window. impl std::ops::Deref for DesktopService { type Target = Window; From d47e49478666619d682d0bc9be5d2f43cc019a4d Mon Sep 17 00:00:00 2001 From: Jonathan Kelley Date: Thu, 4 Jan 2024 17:28:54 -0800 Subject: [PATCH 401/447] More cleaning up of the desktop crate --- packages/desktop/src/app.rs | 11 +++-- packages/desktop/src/desktop_context.rs | 16 +++++++- packages/desktop/src/edits.rs | 54 +++++++------------------ packages/desktop/src/menubar.rs | 8 ++-- 4 files changed, 39 insertions(+), 50 deletions(-) diff --git a/packages/desktop/src/app.rs b/packages/desktop/src/app.rs index fac223ab0..931d239cb 100644 --- a/packages/desktop/src/app.rs +++ b/packages/desktop/src/app.rs @@ -2,7 +2,7 @@ pub use crate::assets::{AssetFuture, AssetHandler, AssetRequest, AssetResponse}; pub use crate::cfg::{Config, WindowCloseBehaviour}; pub use crate::desktop_context::DesktopContext; pub use crate::desktop_context::{window, DesktopService, WryEventHandler, WryEventHandlerId}; -use crate::edits::{send_edits, EditQueue, WebviewQueue}; +use crate::edits::{EditQueue, WebviewQueue}; use crate::element::DesktopElement; use crate::eval::init_eval; use crate::events::{IpcMessage, IpcMethod}; @@ -198,7 +198,7 @@ impl App

{ pub fn handle_initialize_msg(&mut self, id: WindowId) { let view = self.webviews.get_mut(&id).unwrap(); - send_edits(view.dom.rebuild(), &view.desktop_context); + view.desktop_context.send_edits(view.dom.rebuild()); view.desktop_context .window .set_visible(self.is_visible_before_start); @@ -271,8 +271,7 @@ impl App

{ }; view.dom.handle_event(&name, as_any, element, bubbles); - - send_edits(view.dom.render_immediate(), &view.desktop_context); + view.desktop_context.send_edits(view.dom.render_immediate()); } #[cfg(all(feature = "hot-reload", debug_assertions))] @@ -319,7 +318,7 @@ impl App

{ view.dom.handle_event(event_name, data, id, event_bubbles); } - send_edits(view.dom.render_immediate(), &view.desktop_context); + view.desktop_context.send_edits(view.dom.render_immediate()); } } @@ -344,7 +343,7 @@ impl App

{ } } - send_edits(view.dom.render_immediate(), &view.desktop_context); + view.desktop_context.send_edits(view.dom.render_immediate()); } } } diff --git a/packages/desktop/src/desktop_context.rs b/packages/desktop/src/desktop_context.rs index 866056558..0a2a768e4 100644 --- a/packages/desktop/src/desktop_context.rs +++ b/packages/desktop/src/desktop_context.rs @@ -5,8 +5,8 @@ use crate::Config; use crate::{assets::AssetFuture, edits::WebviewQueue}; use crate::{assets::AssetHandlerRegistry, edits::EditQueue}; use crate::{events::IpcMessage, webview::WebviewHandler}; -use dioxus_core::ScopeState; use dioxus_core::VirtualDom; +use dioxus_core::{Mutations, ScopeState}; use dioxus_interpreter_js::binary_protocol::Channel; use rustc_hash::FxHashMap; use slab::Slab; @@ -121,6 +121,20 @@ impl DesktopService { } } + /// Send a list of mutations to the webview + pub(crate) fn send_edits(&self, edits: Mutations) { + let mut channel = self.channel.borrow_mut(); + let mut templates = self.templates.borrow_mut(); + if let Some(bytes) = crate::edits::apply_edits( + edits, + &mut channel, + &mut templates, + &self.max_template_count, + ) { + self.edit_queue.add_edits(bytes) + } + } + /// Create a new window using the props and window builder /// /// Returns the webview handle for the new window. diff --git a/packages/desktop/src/edits.rs b/packages/desktop/src/edits.rs index 5a09d1933..fa9306156 100644 --- a/packages/desktop/src/edits.rs +++ b/packages/desktop/src/edits.rs @@ -1,24 +1,21 @@ -use crate::assets::AssetHandlerRegistry; use crate::query::QueryEngine; use crate::shortcut::{HotKey, ShortcutId, ShortcutRegistry, ShortcutRegistryError}; use crate::AssetHandler; use crate::Config; use crate::{assets::AssetFuture, DesktopContext}; +use crate::{assets::AssetHandlerRegistry, DesktopService}; use crate::{events::IpcMessage, webview::WebviewHandler}; use dioxus_core::{BorrowedAttributeValue, Template, TemplateAttribute, TemplateNode, VirtualDom}; use dioxus_core::{Mutations, ScopeState}; use dioxus_html::event_bubbles; use dioxus_interpreter_js::binary_protocol::Channel; use rustc_hash::FxHashMap; -use slab::Slab; use std::{ - cell::RefCell, fmt::Debug, fmt::Formatter, rc::Rc, rc::Weak, sync::atomic::AtomicU16, - sync::Arc, sync::Mutex, -}; -use tao::{ - event::Event, - event_loop::{EventLoopProxy, EventLoopWindowTarget}, - window::{Fullscreen as WryFullscreen, Window, WindowId}, + cell::RefCell, + rc::Rc, + sync::atomic::AtomicU16, + sync::Arc, + sync::{atomic::Ordering, Mutex}, }; use wry::{RequestAsyncResponder, WebView}; @@ -33,17 +30,6 @@ pub(crate) struct EditQueue { responder: Arc>>, } -impl Debug for EditQueue { - fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result { - f.debug_struct("EditQueue") - .field("queue", &self.queue) - .field("responder", { - &self.responder.lock().unwrap().as_ref().map(|_| ()) - }) - .finish() - } -} - impl EditQueue { pub fn handle_request(&self, responder: RequestAsyncResponder) { let mut queue = self.queue.lock().unwrap(); @@ -64,33 +50,21 @@ impl EditQueue { } } -/// Send a list of mutations to the webview -pub fn send_edits(edits: Mutations, desktop_context: &DesktopContext) { - let mut channel = desktop_context.channel.borrow_mut(); - let mut templates = desktop_context.templates.borrow_mut(); - if let Some(bytes) = apply_edits( - edits, - &mut channel, - &mut templates, - &desktop_context.max_template_count, - ) { - desktop_context.edit_queue.add_edits(bytes) - } -} - -pub fn apply_edits( +pub(crate) fn apply_edits( mutations: Mutations, channel: &mut Channel, templates: &mut FxHashMap, max_template_count: &AtomicU16, ) -> Option> { - use dioxus_core::Mutation::*; if mutations.templates.is_empty() && mutations.edits.is_empty() { return None; } + for template in mutations.templates { add_template(&template, channel, templates, max_template_count); } + + use dioxus_core::Mutation::*; for edit in mutations.edits { match edit { AppendChildren { id, m } => channel.append_children(id.0 as u32, m as u16), @@ -156,19 +130,19 @@ pub fn add_template( templates: &mut FxHashMap, max_template_count: &AtomicU16, ) { - let current_max_template_count = max_template_count.load(std::sync::atomic::Ordering::Relaxed); + let current_max_template_count = max_template_count.load(Ordering::Relaxed); for root in template.roots.iter() { create_template_node(channel, root); templates.insert(template.name.to_owned(), current_max_template_count); } channel.add_templates(current_max_template_count, template.roots.len() as u16); - max_template_count.fetch_add(1, std::sync::atomic::Ordering::Relaxed); + max_template_count.fetch_add(1, Ordering::Relaxed); } -pub fn create_template_node(channel: &mut Channel, v: &'static TemplateNode<'static>) { +pub fn create_template_node(channel: &mut Channel, node: &'static TemplateNode<'static>) { use TemplateNode::*; - match v { + match node { Element { tag, namespace, diff --git a/packages/desktop/src/menubar.rs b/packages/desktop/src/menubar.rs index 44cc12c84..2f7f3951a 100644 --- a/packages/desktop/src/menubar.rs +++ b/packages/desktop/src/menubar.rs @@ -1,12 +1,14 @@ -use muda::{Menu, MenuItem, PredefinedMenuItem, Submenu}; +use muda::{Menu, PredefinedMenuItem, Submenu}; use tao::window::Window; +#[allow(unused)] pub fn build_menu_bar(menu: Menu, window: &Window) { #[cfg(target_os = "windows")] - menu.init_for_hwnd(window_hwnd); + menu.init_for_hwnd(window); #[cfg(target_os = "linux")] - menu.init_for_gtk_window(>k_window, Some(&vertical_gtk_box)); + menu.init_for_gtk_window(window, None); + // menu.init_for_gtk_window(window, Some(&vertical_gtk_box)); #[cfg(target_os = "macos")] menu.init_for_nsapp(); From fae81e2364ba7bdd75670cc1af609dcfdd149251 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Thu, 4 Jan 2024 19:32:00 -0600 Subject: [PATCH 402/447] fix event tests in core --- examples/compose.rs | 2 +- packages/core/tests/event_propagation.rs | 16 ++++++---------- 2 files changed, 7 insertions(+), 11 deletions(-) diff --git a/examples/compose.rs b/examples/compose.rs index 23f703bd2..133192281 100644 --- a/examples/compose.rs +++ b/examples/compose.rs @@ -26,7 +26,7 @@ fn app(cx: Scope) -> Element { button { onclick: move |_| { let dom = VirtualDom::new_with_props(compose, ComposeProps { app_tx: tx.clone() }); - window.new_window(dom, Default::default()); + dioxus_desktop::window().new_window(dom, Default::default()); }, "Click to compose a new email" } diff --git a/packages/core/tests/event_propagation.rs b/packages/core/tests/event_propagation.rs index d694b1ff1..1c294aa37 100644 --- a/packages/core/tests/event_propagation.rs +++ b/packages/core/tests/event_propagation.rs @@ -10,7 +10,7 @@ fn events_propagate() { _ = dom.rebuild(); // Top-level click is registered - dom.handle_event("click", Rc::new(MouseData::default()), ElementId(1), true); + dom.handle_event("click", Rc::new(PlatformEventData::new(Box::::default())), ElementId(1), true); assert_eq!(*CLICKS.lock().unwrap(), 1); // break reference.... @@ -20,7 +20,7 @@ fn events_propagate() { } // Lower click is registered - dom.handle_event("click", Rc::new(MouseData::default()), ElementId(2), true); + dom.handle_event("click", Rc::new(PlatformEventData::new(Box::::default())), ElementId(2), true); assert_eq!(*CLICKS.lock().unwrap(), 3); // break reference.... @@ -30,14 +30,13 @@ fn events_propagate() { } // Stop propagation occurs - dom.handle_event("click", Rc::new(MouseData::default()), ElementId(2), true); + dom.handle_event("click", Rc::new(PlatformEventData::new(Box::::default())), ElementId(2), true); assert_eq!(*CLICKS.lock().unwrap(), 3); } fn app(cx: Scope) -> Element { render! { - div { - onclick: move |_| { + div { onclick: move |_| { println!("top clicked"); *CLICKS.lock().unwrap() += 1; }, @@ -53,17 +52,14 @@ fn app(cx: Scope) -> Element { fn problematic_child(cx: Scope) -> Element { render! { - button { - onclick: move |evt| { + button { onclick: move |evt| { println!("bottom clicked"); let mut clicks = CLICKS.lock().unwrap(); - if *clicks == 3 { evt.stop_propagation(); } else { *clicks += 1; } - } - } + } } } } From fef7b83b792a5e6db1563c1a9fd70d464acf7e4e Mon Sep 17 00:00:00 2001 From: Jonathan Kelley Date: Thu, 4 Jan 2024 17:35:58 -0800 Subject: [PATCH 403/447] Rename editqueue type --- packages/desktop/src/protocol.rs | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/packages/desktop/src/protocol.rs b/packages/desktop/src/protocol.rs index 6910495f0..77acebad6 100644 --- a/packages/desktop/src/protocol.rs +++ b/packages/desktop/src/protocol.rs @@ -1,4 +1,4 @@ -use crate::assets::*; +use crate::{assets::*, edits::EditQueue}; use std::{ borrow::Cow, path::{Path, PathBuf}, @@ -16,7 +16,7 @@ pub(super) async fn desktop_handler( custom_index: Option, root_name: &str, asset_handlers: &AssetHandlerRegistry, - edit_queue: &crate::edits::EditQueue, + edit_queue: &EditQueue, headless: bool, responder: wry::RequestAsyncResponder, ) { From 7ffb204eacebcabc5dcd52497b1fb8b5d3f1a1d6 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Thu, 4 Jan 2024 19:36:10 -0600 Subject: [PATCH 404/447] fix event tests in core --- examples/compose.rs | 2 +- packages/core/tests/event_propagation.rs | 18 ++++++++---------- packages/ssr/Cargo.toml | 2 +- 3 files changed, 10 insertions(+), 12 deletions(-) diff --git a/examples/compose.rs b/examples/compose.rs index 23f703bd2..133192281 100644 --- a/examples/compose.rs +++ b/examples/compose.rs @@ -26,7 +26,7 @@ fn app(cx: Scope) -> Element { button { onclick: move |_| { let dom = VirtualDom::new_with_props(compose, ComposeProps { app_tx: tx.clone() }); - window.new_window(dom, Default::default()); + dioxus_desktop::window().new_window(dom, Default::default()); }, "Click to compose a new email" } diff --git a/packages/core/tests/event_propagation.rs b/packages/core/tests/event_propagation.rs index d694b1ff1..d9d96ac32 100644 --- a/packages/core/tests/event_propagation.rs +++ b/packages/core/tests/event_propagation.rs @@ -6,11 +6,13 @@ static CLICKS: Mutex = Mutex::new(0); #[test] fn events_propagate() { + set_event_converter(Box::new(dioxus_html::SerializedHtmlEventConverter)); + let mut dom = VirtualDom::new(app); _ = dom.rebuild(); // Top-level click is registered - dom.handle_event("click", Rc::new(MouseData::default()), ElementId(1), true); + dom.handle_event("click", Rc::new(PlatformEventData::new(Box::::default())), ElementId(1), true); assert_eq!(*CLICKS.lock().unwrap(), 1); // break reference.... @@ -20,7 +22,7 @@ fn events_propagate() { } // Lower click is registered - dom.handle_event("click", Rc::new(MouseData::default()), ElementId(2), true); + dom.handle_event("click", Rc::new(PlatformEventData::new(Box::::default())), ElementId(2), true); assert_eq!(*CLICKS.lock().unwrap(), 3); // break reference.... @@ -30,14 +32,13 @@ fn events_propagate() { } // Stop propagation occurs - dom.handle_event("click", Rc::new(MouseData::default()), ElementId(2), true); + dom.handle_event("click", Rc::new(PlatformEventData::new(Box::::default())), ElementId(2), true); assert_eq!(*CLICKS.lock().unwrap(), 3); } fn app(cx: Scope) -> Element { render! { - div { - onclick: move |_| { + div { onclick: move |_| { println!("top clicked"); *CLICKS.lock().unwrap() += 1; }, @@ -53,17 +54,14 @@ fn app(cx: Scope) -> Element { fn problematic_child(cx: Scope) -> Element { render! { - button { - onclick: move |evt| { + button { onclick: move |evt| { println!("bottom clicked"); let mut clicks = CLICKS.lock().unwrap(); - if *clicks == 3 { evt.stop_propagation(); } else { *clicks += 1; } - } - } + } } } } diff --git a/packages/ssr/Cargo.toml b/packages/ssr/Cargo.toml index 71f5b26a0..1a8d475ee 100644 --- a/packages/ssr/Cargo.toml +++ b/packages/ssr/Cargo.toml @@ -10,7 +10,7 @@ keywords = ["dom", "ui", "gui", "react", "ssr"] [dependencies] dioxus-core = { workspace = true, features = ["serialize"] } -dioxus-html = { workspace = true } +dioxus-html = { workspace = true, features = ["eval"]} askama_escape = "0.10.3" thiserror = "1.0.23" rustc-hash = "1.1.0" From bb8341241d085c57e9e6d1c4a85ae24fb912504d Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Thu, 4 Jan 2024 19:57:02 -0600 Subject: [PATCH 405/447] bump sledgehammer --- packages/interpreter/Cargo.toml | 2 +- packages/interpreter/src/sledgehammer_bindings.rs | 6 +++--- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/packages/interpreter/Cargo.toml b/packages/interpreter/Cargo.toml index bac04d496..63113872d 100644 --- a/packages/interpreter/Cargo.toml +++ b/packages/interpreter/Cargo.toml @@ -14,7 +14,7 @@ keywords = ["dom", "ui", "gui", "react", "wasm"] wasm-bindgen = { workspace = true, optional = true } js-sys = { version = "0.3.56", optional = true } web-sys = { version = "0.3.56", optional = true, features = ["Element", "Node"] } -sledgehammer_bindgen = { versio = "0.3.0", default-features = false, optional = true } +sledgehammer_bindgen = { versio = "0.3.1", default-features = false, optional = true } sledgehammer_utils = { version = "0.2", optional = true } serde = { version = "1.0", features = ["derive"], optional = true } diff --git a/packages/interpreter/src/sledgehammer_bindings.rs b/packages/interpreter/src/sledgehammer_bindings.rs index a42824e15..23831f3e6 100644 --- a/packages/interpreter/src/sledgehammer_bindings.rs +++ b/packages/interpreter/src/sledgehammer_bindings.rs @@ -11,7 +11,7 @@ pub const SLEDGEHAMMER_JS: &str = GENERATED_JS; #[cfg(feature = "web")] #[bindgen(module)] mod js { - const JS_FILE: &str = "./packages/interpreter/src/common.js"; + const JS_FILE: &str = "./src/common.js"; const JS: &str = r#" class ListenerMap { constructor(root) { @@ -260,8 +260,8 @@ pub mod binary_protocol { #[bindgen] mod protocol_js { - const JS_FILE: &str = "./packages/interpreter/src/interpreter.js"; - const JS_FILE: &str = "./packages/interpreter/src/common.js"; + const JS_FILE: &str = "./src/interpreter.js"; + const JS_FILE: &str = "./src/common.js"; fn mount_to_root() { "{AppendChildren(root, stack.length-1);}" From 7444796a85646605e56a063bc4c1116d82fe490f Mon Sep 17 00:00:00 2001 From: Jonathan Kelley Date: Thu, 4 Jan 2024 18:01:13 -0800 Subject: [PATCH 406/447] Simplify asset code a bit --- packages/desktop/src/app.rs | 8 +-- packages/desktop/src/assets.rs | 6 +- packages/desktop/src/desktop_context.rs | 27 +++----- packages/desktop/src/edits.rs | 22 +++--- packages/desktop/src/hooks.rs | 20 +++++- packages/desktop/src/lib.rs | 6 +- packages/desktop/src/shortcut.rs | 89 ++++++++++--------------- packages/desktop/src/webview.rs | 2 +- 8 files changed, 84 insertions(+), 96 deletions(-) diff --git a/packages/desktop/src/app.rs b/packages/desktop/src/app.rs index 931d239cb..4e954d496 100644 --- a/packages/desktop/src/app.rs +++ b/packages/desktop/src/app.rs @@ -11,7 +11,7 @@ use crate::hooks::*; use crate::query::QueryResult; use crate::shortcut::GlobalHotKeyEvent; use crate::shortcut::ShortcutRegistry; -pub use crate::shortcut::{use_global_shortcut, ShortcutHandle, ShortcutId, ShortcutRegistryError}; +pub use crate::shortcut::{ShortcutHandle, ShortcutId, ShortcutRegistryError}; use crate::{ desktop_context::{EventData, UserWindowEvent, WindowEventHandlers}, webview::WebviewHandler, @@ -171,9 +171,9 @@ impl App

{ let handler = crate::webview::create_new_window( cfg, + dom, target, &self.proxy, - dom, &self.queue, &self.event_handlers, self.shortcut_manager.clone(), @@ -212,10 +212,6 @@ impl App

{ } } - pub fn handle_poll_msg(&mut self, id: WindowId) { - self.poll_vdom(id); - } - pub fn handle_query_msg(&mut self, msg: IpcMessage, id: WindowId) { let Ok(result) = serde_json::from_value::(msg.params()) else { return; diff --git a/packages/desktop/src/assets.rs b/packages/desktop/src/assets.rs index f27dcb504..f80c7542a 100644 --- a/packages/desktop/src/assets.rs +++ b/packages/desktop/src/assets.rs @@ -75,8 +75,10 @@ impl F + Send + Sync + 'static> AssetHan } } -type AssetHandlerRegistryInner = - Slab Pin> + Send + Sync + 'static>>; +type UserAssetHandler = + Box Pin> + Send + Sync + 'static>; + +type AssetHandlerRegistryInner = Slab; #[derive(Clone)] pub struct AssetHandlerRegistry(Arc>); diff --git a/packages/desktop/src/desktop_context.rs b/packages/desktop/src/desktop_context.rs index 0a2a768e4..240f8ec24 100644 --- a/packages/desktop/src/desktop_context.rs +++ b/packages/desktop/src/desktop_context.rs @@ -1,26 +1,22 @@ +use crate::events::IpcMessage; use crate::query::QueryEngine; use crate::shortcut::{HotKey, ShortcutId, ShortcutRegistry, ShortcutRegistryError}; use crate::AssetHandler; use crate::Config; use crate::{assets::AssetFuture, edits::WebviewQueue}; use crate::{assets::AssetHandlerRegistry, edits::EditQueue}; -use crate::{events::IpcMessage, webview::WebviewHandler}; +use dioxus_core::Mutations; use dioxus_core::VirtualDom; -use dioxus_core::{Mutations, ScopeState}; use dioxus_interpreter_js::binary_protocol::Channel; use rustc_hash::FxHashMap; use slab::Slab; -use std::{ - cell::RefCell, fmt::Debug, fmt::Formatter, rc::Rc, rc::Weak, sync::atomic::AtomicU16, - sync::Arc, sync::Mutex, -}; +use std::{cell::RefCell, fmt::Debug, rc::Rc, rc::Weak, sync::atomic::AtomicU16}; use tao::{ event::Event, event_loop::{EventLoopProxy, EventLoopWindowTarget}, window::{Fullscreen as WryFullscreen, Window, WindowId}, }; - -use wry::{RequestAsyncResponder, WebView}; +use wry::WebView; #[cfg(target_os = "ios")] use tao::platform::ios::WindowExtIOS; @@ -123,16 +119,13 @@ impl DesktopService { /// Send a list of mutations to the webview pub(crate) fn send_edits(&self, edits: Mutations) { - let mut channel = self.channel.borrow_mut(); - let mut templates = self.templates.borrow_mut(); - if let Some(bytes) = crate::edits::apply_edits( + crate::edits::apply_edits( edits, - &mut channel, - &mut templates, + &mut self.channel.borrow_mut(), + &mut self.templates.borrow_mut(), &self.max_template_count, - ) { - self.edit_queue.add_edits(bytes) - } + ) + .map(|bytes| self.edit_queue.add_edits(bytes)); } /// Create a new window using the props and window builder @@ -145,9 +138,9 @@ impl DesktopService { pub fn new_window(&self, dom: VirtualDom, cfg: Config) -> Weak { let window = crate::webview::create_new_window( cfg, + dom, &self.event_loop, &self.proxy, - dom, &self.pending_windows, &self.event_handlers, self.shortcut_manager.clone(), diff --git a/packages/desktop/src/edits.rs b/packages/desktop/src/edits.rs index fa9306156..4eeb48a9b 100644 --- a/packages/desktop/src/edits.rs +++ b/packages/desktop/src/edits.rs @@ -1,12 +1,6 @@ -use crate::query::QueryEngine; -use crate::shortcut::{HotKey, ShortcutId, ShortcutRegistry, ShortcutRegistryError}; -use crate::AssetHandler; -use crate::Config; -use crate::{assets::AssetFuture, DesktopContext}; -use crate::{assets::AssetHandlerRegistry, DesktopService}; -use crate::{events::IpcMessage, webview::WebviewHandler}; -use dioxus_core::{BorrowedAttributeValue, Template, TemplateAttribute, TemplateNode, VirtualDom}; -use dioxus_core::{Mutations, ScopeState}; +use crate::webview::WebviewHandler; +use dioxus_core::Mutations; +use dioxus_core::{BorrowedAttributeValue, Template, TemplateAttribute, TemplateNode}; use dioxus_html::event_bubbles; use dioxus_interpreter_js::binary_protocol::Channel; use rustc_hash::FxHashMap; @@ -18,12 +12,16 @@ use std::{ sync::{atomic::Ordering, Mutex}, }; -use wry::{RequestAsyncResponder, WebView}; +use wry::RequestAsyncResponder; pub(crate) type WebviewQueue = Rc>>; -/// This handles communication between the requests that the webview makes and the interpreter. The interpreter constantly makes long running requests to the webview to get any edits that should be made to the DOM almost like server side events. -/// It will hold onto the requests until the interpreter is ready to handle them and hold onto any pending edits until a new request is made. +/// This handles communication between the requests that the webview makes and the interpreter. The interpreter +/// constantly makes long running requests to the webview to get any edits that should be made to the DOM almost like +/// server side events. +/// +/// It will hold onto the requests until the interpreter is ready to handle them and hold onto any pending edits until +/// a new request is made. #[derive(Default, Clone)] pub(crate) struct EditQueue { queue: Arc>>>, diff --git a/packages/desktop/src/hooks.rs b/packages/desktop/src/hooks.rs index 7ebdf4963..54d114abb 100644 --- a/packages/desktop/src/hooks.rs +++ b/packages/desktop/src/hooks.rs @@ -1,6 +1,6 @@ use std::rc::Rc; -use crate::assets::*; +use crate::{assets::*, shortcut::IntoAccelerator, ShortcutHandle, ShortcutRegistryError}; use crate::{desktop_context::UserWindowEvent, window, DesktopContext, WryEventHandler}; use dioxus_core::ScopeState; use tao::{event::Event, event_loop::EventLoopWindowTarget}; @@ -52,3 +52,21 @@ pub fn use_asset_handler( } }) } + +/// Get a closure that executes any JavaScript in the WebView context. +pub fn use_global_shortcut( + cx: &ScopeState, + accelerator: impl IntoAccelerator, + handler: impl FnMut() + 'static, +) -> &Result { + cx.use_hook(move || { + let desktop = window(); + + let id = desktop.create_shortcut(accelerator.accelerator(), handler); + + Ok(ShortcutHandle { + desktop, + shortcut_id: id?, + }) + }) +} diff --git a/packages/desktop/src/lib.rs b/packages/desktop/src/lib.rs index 3e8608200..ca1e851fb 100644 --- a/packages/desktop/src/lib.rs +++ b/packages/desktop/src/lib.rs @@ -37,9 +37,9 @@ pub use cfg::{Config, WindowCloseBehaviour}; pub use desktop_context::{ window, DesktopContext, DesktopService, WryEventHandler, WryEventHandlerId, }; -pub use hooks::{use_asset_handler, use_window, use_wry_event_handler}; +pub use hooks::{use_asset_handler, use_global_shortcut, use_window, use_wry_event_handler}; pub use menubar::build_default_menu_bar; -pub use shortcut::{use_global_shortcut, ShortcutHandle, ShortcutId, ShortcutRegistryError}; +pub use shortcut::{ShortcutHandle, ShortcutId, ShortcutRegistryError}; #[allow(deprecated)] use desktop_context::{EventData, UserWindowEvent}; @@ -139,7 +139,7 @@ pub fn launch_with_props(root: Component

, props: P, cfg: Config) _ => {} }, Event::UserEvent(UserWindowEvent(event, id)) => match event { - EventData::Poll => app.handle_poll_msg(id), + EventData::Poll => app.poll_vdom(id), EventData::NewWindow => app.handle_new_window(), EventData::CloseWindow => app.handle_close_msg(id), EventData::HotReloadEvent(msg) => app.handle_hot_reload_msg(msg), diff --git a/packages/desktop/src/shortcut.rs b/packages/desktop/src/shortcut.rs index 55d49b405..f67d21a4d 100644 --- a/packages/desktop/src/shortcut.rs +++ b/packages/desktop/src/shortcut.rs @@ -1,11 +1,10 @@ use std::{cell::RefCell, collections::HashMap, rc::Rc, str::FromStr}; -use dioxus_core::ScopeState; use dioxus_html::input_data::keyboard_types::Modifiers; use slab::Slab; use tao::keyboard::ModifiersState; -use crate::{desktop_context::DesktopContext, window}; +use crate::desktop_context::DesktopContext; #[cfg(any( target_os = "windows", @@ -26,7 +25,7 @@ pub use crate::mobile_shortcut::*; #[derive(Clone)] pub(crate) struct ShortcutRegistry { - manager: Rc>, + manager: Rc, shortcuts: ShortcutMap, } @@ -55,7 +54,7 @@ impl Shortcut { impl ShortcutRegistry { pub fn new() -> Self { Self { - manager: Rc::new(RefCell::new(GlobalHotKeyManager::new().unwrap())), + manager: Rc::new(GlobalHotKeyManager::new().unwrap()), shortcuts: Rc::new(RefCell::new(HashMap::new())), } } @@ -74,36 +73,36 @@ impl ShortcutRegistry { callback: Box, ) -> Result { let accelerator_id = hotkey.clone().id(); + let mut shortcuts = self.shortcuts.borrow_mut(); - Ok( - if let Some(callbacks) = shortcuts.get_mut(&accelerator_id) { - let id = callbacks.insert(callback); - ShortcutId { - id: accelerator_id, - number: id, - } - } else { - match self.manager.borrow_mut().register(hotkey) { - Ok(_) => { - let mut slab = Slab::new(); - let id = slab.insert(callback); - let shortcut = Shortcut { - shortcut: hotkey, - callbacks: slab, - }; - shortcuts.insert(accelerator_id, shortcut); - ShortcutId { - id: accelerator_id, - number: id, - } - } - Err(HotkeyError::HotKeyParseError(shortcut)) => { - return Err(ShortcutRegistryError::InvalidShortcut(shortcut)) - } - Err(err) => return Err(ShortcutRegistryError::Other(Box::new(err))), - } - }, - ) + + if let Some(callbacks) = shortcuts.get_mut(&accelerator_id) { + return Ok(ShortcutId { + id: accelerator_id, + number: callbacks.insert(callback), + }); + }; + + self.manager.register(hotkey).map_err(|e| match e { + HotkeyError::HotKeyParseError(shortcut) => { + ShortcutRegistryError::InvalidShortcut(shortcut) + } + err => ShortcutRegistryError::Other(Box::new(err)), + })?; + + let mut shortcut = Shortcut { + shortcut: hotkey, + callbacks: Slab::new(), + }; + + let id = shortcut.callbacks.insert(callback); + + shortcuts.insert(accelerator_id, shortcut); + + Ok(ShortcutId { + id: accelerator_id, + number: id, + }) } pub(crate) fn remove_shortcut(&self, id: ShortcutId) { @@ -112,7 +111,7 @@ impl ShortcutRegistry { callbacks.remove(id.number); if callbacks.is_empty() { if let Some(_shortcut) = shortcuts.remove(&id.id) { - let _ = self.manager.borrow_mut().unregister(_shortcut.shortcut); + let _ = self.manager.unregister(_shortcut.shortcut); } } } @@ -121,7 +120,7 @@ impl ShortcutRegistry { pub(crate) fn remove_all(&self) { let mut shortcuts = self.shortcuts.borrow_mut(); let hotkeys: Vec<_> = shortcuts.drain().map(|(_, v)| v.shortcut).collect(); - let _ = self.manager.borrow_mut().unregister_all(&hotkeys); + let _ = self.manager.unregister_all(&hotkeys); } } @@ -144,7 +143,7 @@ pub struct ShortcutId { /// A global shortcut. This will be automatically removed when it is dropped. pub struct ShortcutHandle { - desktop: DesktopContext, + pub(crate) desktop: DesktopContext, /// The id of the shortcut pub shortcut_id: ShortcutId, } @@ -177,24 +176,6 @@ impl IntoAccelerator for &str { } } -/// Get a closure that executes any JavaScript in the WebView context. -pub fn use_global_shortcut( - cx: &ScopeState, - accelerator: impl IntoAccelerator, - handler: impl FnMut() + 'static, -) -> &Result { - cx.use_hook(move || { - let desktop = window(); - - let id = desktop.create_shortcut(accelerator.accelerator(), handler); - - Ok(ShortcutHandle { - desktop, - shortcut_id: id?, - }) - }) -} - impl ShortcutHandle { /// Remove the shortcut. pub fn remove(&self) { diff --git a/packages/desktop/src/webview.rs b/packages/desktop/src/webview.rs index 537b3e241..cd83362b5 100644 --- a/packages/desktop/src/webview.rs +++ b/packages/desktop/src/webview.rs @@ -30,9 +30,9 @@ pub struct WebviewHandler { pub fn create_new_window( mut cfg: Config, + dom: VirtualDom, event_loop: &EventLoopWindowTarget, proxy: &EventLoopProxy, - dom: VirtualDom, queue: &WebviewQueue, event_handlers: &WindowEventHandlers, shortcut_manager: ShortcutRegistry, From 060490892ac6d3ff7d6dc1362d1583b46e3d817e Mon Sep 17 00:00:00 2001 From: Jonathan Kelley Date: Thu, 4 Jan 2024 18:19:28 -0800 Subject: [PATCH 407/447] Clean up desktop even more --- packages/desktop/src/app.rs | 142 +++++++++--------------- packages/desktop/src/assets.rs | 7 +- packages/desktop/src/desktop_context.rs | 14 +-- packages/desktop/src/eval.rs | 16 ++- packages/desktop/src/file_upload.rs | 125 +++++++++++---------- packages/desktop/src/webview.rs | 11 +- 6 files changed, 137 insertions(+), 178 deletions(-) diff --git a/packages/desktop/src/app.rs b/packages/desktop/src/app.rs index 4e954d496..9a45e6c19 100644 --- a/packages/desktop/src/app.rs +++ b/packages/desktop/src/app.rs @@ -1,48 +1,25 @@ -pub use crate::assets::{AssetFuture, AssetHandler, AssetRequest, AssetResponse}; -pub use crate::cfg::{Config, WindowCloseBehaviour}; -pub use crate::desktop_context::DesktopContext; -pub use crate::desktop_context::{window, DesktopService, WryEventHandler, WryEventHandlerId}; -use crate::edits::{EditQueue, WebviewQueue}; -use crate::element::DesktopElement; -use crate::eval::init_eval; -use crate::events::{IpcMessage, IpcMethod}; -use crate::file_upload; -use crate::hooks::*; -use crate::query::QueryResult; -use crate::shortcut::GlobalHotKeyEvent; -use crate::shortcut::ShortcutRegistry; -pub use crate::shortcut::{ShortcutHandle, ShortcutId, ShortcutRegistryError}; use crate::{ + cfg::{Config, WindowCloseBehaviour}, desktop_context::{EventData, UserWindowEvent, WindowEventHandlers}, + edits::WebviewQueue, + element::DesktopElement, + events::IpcMessage, + file_upload::FileDialogRequest, + query::QueryResult, + shortcut::{GlobalHotKeyEvent, ShortcutRegistry}, webview::WebviewHandler, }; -use dioxus_core::*; -use dioxus_html::{event_bubbles, MountedData}; +use dioxus_core::{Component, ElementId, VirtualDom}; +use dioxus_html::MountedData; use dioxus_html::{native_bind::NativeFileEngine, FormData, HtmlEvent}; -use dioxus_interpreter_js::binary_protocol::Channel; use futures_util::{pin_mut, FutureExt}; -use global_hotkey::{ - hotkey::{Code, HotKey, Modifiers}, - GlobalHotKeyManager, -}; -use rustc_hash::FxHashMap; +use std::cell::Cell; use std::rc::Rc; -use std::sync::atomic::AtomicU16; -use std::task::Waker; -use std::{borrow::Borrow, cell::Cell}; use std::{collections::HashMap, sync::Arc}; -pub use tao::dpi::{LogicalSize, PhysicalSize}; +use tao::event_loop::EventLoopBuilder; use tao::event_loop::{EventLoop, EventLoopProxy, EventLoopWindowTarget}; -pub use tao::window::WindowBuilder; use tao::window::WindowId; -use tao::{ - event::{Event, StartCause, WindowEvent}, - event_loop::ControlFlow, -}; -use tao::{event_loop::EventLoopBuilder, window::Window}; -use tokio::runtime::Builder; -pub use wry; -use wry::WebContext; +use tao::{event::Event, event_loop::ControlFlow}; use wry::WebView; pub struct App

{ @@ -221,24 +198,14 @@ impl App

{ return; }; - view.dom - .base_scope() - .consume_context::() - .unwrap() - .query - .send(result); + view.desktop_context.query.send(result); } pub fn handle_user_event_msg(&mut self, msg: IpcMessage, id: WindowId) { - let params = msg.params(); + let parsed_params = serde_json::from_value(msg.params()) + .map_err(|err| tracing::error!("Error parsing user_event: {:?}", err)); - let evt = match serde_json::from_value::(params) { - Ok(value) => value, - Err(err) => { - tracing::error!("Error parsing user_event: {:?}", err); - return; - } - }; + let Ok(evt) = parsed_params else { return }; let HtmlEvent { element, @@ -250,20 +217,13 @@ impl App

{ let view = self.webviews.get_mut(&id).unwrap(); // check for a mounted event placeholder and replace it with a desktop specific element - let as_any = if let dioxus_html::EventData::Mounted = &data { - let query = view - .dom - .base_scope() - .consume_context::() - .unwrap() - .query - .clone(); - - let element = DesktopElement::new(element, view.desktop_context.clone(), query); - - Rc::new(MountedData::new(element)) - } else { - data.into_any() + let as_any = match data { + dioxus_html::EventData::Mounted => Rc::new(MountedData::new(DesktopElement::new( + element, + view.desktop_context.clone(), + view.desktop_context.query.clone(), + ))), + _ => data.into_any(), }; view.dom.handle_event(&name, as_any, element, bubbles); @@ -278,9 +238,7 @@ impl App

{ webview.dom.replace_template(template); } - let ids = self.webviews.keys().copied().collect::>(); - - for id in ids { + for id in self.webviews.keys().copied().collect::>() { self.poll_vdom(id); } } @@ -291,31 +249,32 @@ impl App

{ } pub fn handle_file_dialog_msg(&mut self, msg: IpcMessage, window: WindowId) { - if let Ok(file_diolog) = - serde_json::from_value::(msg.params()) - { - let id = ElementId(file_diolog.target); - let event_name = &file_diolog.event; - let event_bubbles = file_diolog.bubbles; - let files = file_upload::get_file_event(&file_diolog); - let data = Rc::new(FormData { - value: Default::default(), - values: Default::default(), - files: Some(Arc::new(NativeFileEngine::new(files))), - }); + let Ok(file_dialog) = serde_json::from_value::(msg.params()) else { + return; + }; - let view = self.webviews.get_mut(&window).unwrap(); + let id = ElementId(file_dialog.target); + let event_name = &file_dialog.event; + let event_bubbles = file_dialog.bubbles; + let files = file_dialog.get_file_event(); - if event_name == "change&input" { - view.dom - .handle_event("input", data.clone(), id, event_bubbles); - view.dom.handle_event("change", data, id, event_bubbles); - } else { - view.dom.handle_event(event_name, data, id, event_bubbles); - } + let data = Rc::new(FormData { + value: Default::default(), + values: Default::default(), + files: Some(Arc::new(NativeFileEngine::new(files))), + }); - view.desktop_context.send_edits(view.dom.render_immediate()); + let view = self.webviews.get_mut(&window).unwrap(); + + if event_name == "change&input" { + view.dom + .handle_event("input", data.clone(), id, event_bubbles); + view.dom.handle_event("change", data, id, event_bubbles); + } else { + view.dom.handle_event(event_name, data, id, event_bubbles); } + + view.desktop_context.send_edits(view.dom.render_immediate()); } /// Poll the virtualdom until it's pending @@ -324,10 +283,15 @@ impl App

{ /// /// All IO is done on the tokio runtime we started earlier pub fn poll_vdom(&mut self, id: WindowId) { - let view = self.webviews.get_mut(&id).unwrap(); + let Some(view) = self.webviews.get_mut(&id) else { + return; + }; let mut cx = std::task::Context::from_waker(&view.waker); + // Continously poll the virtualdom until it's pending + // Wait for work will return Ready when it has edits to be sent to the webview + // It will return Pending when it needs to be polled again - nothing is ready loop { { let fut = view.dom.wait_for_work(); @@ -335,7 +299,7 @@ impl App

{ match fut.poll_unpin(&mut cx) { std::task::Poll::Ready(_) => {} - std::task::Poll::Pending => break, + std::task::Poll::Pending => return, } } diff --git a/packages/desktop/src/assets.rs b/packages/desktop/src/assets.rs index f80c7542a..7f86b6184 100644 --- a/packages/desktop/src/assets.rs +++ b/packages/desktop/src/assets.rs @@ -1,6 +1,4 @@ -use crate::edits::EditQueue; use crate::DesktopContext; -use dioxus_core::ScopeState; use slab::Slab; use std::{ borrow::Cow, @@ -15,10 +13,7 @@ use tokio::{ runtime::Handle, sync::{OnceCell, RwLock}, }; -use wry::{ - http::{status::StatusCode, Request, Response}, - Result, -}; +use wry::http::{Request, Response}; /// An arbitrary asset is an HTTP response containing a binary body. pub type AssetResponse = Response>; diff --git a/packages/desktop/src/desktop_context.rs b/packages/desktop/src/desktop_context.rs index 240f8ec24..ef2f671b2 100644 --- a/packages/desktop/src/desktop_context.rs +++ b/packages/desktop/src/desktop_context.rs @@ -146,25 +146,19 @@ impl DesktopService { self.shortcut_manager.clone(), ); - let desktop_context = window - .dom - .base_scope() - .consume_context::>() - .unwrap(); - - let id = window.desktop_context.window.id(); + let cx = window.desktop_context.clone(); self.proxy - .send_event(UserWindowEvent(EventData::NewWindow, id)) + .send_event(UserWindowEvent(EventData::NewWindow, cx.id())) .unwrap(); self.proxy - .send_event(UserWindowEvent(EventData::Poll, id)) + .send_event(UserWindowEvent(EventData::Poll, cx.id())) .unwrap(); self.pending_windows.borrow_mut().push(window); - Rc::downgrade(&desktop_context) + Rc::downgrade(&cx) } /// trigger the drag-window event diff --git a/packages/desktop/src/eval.rs b/packages/desktop/src/eval.rs index e187be450..e9b0f036b 100644 --- a/packages/desktop/src/eval.rs +++ b/packages/desktop/src/eval.rs @@ -1,21 +1,19 @@ #![allow(clippy::await_holding_refcell_ref)] use async_trait::async_trait; -use dioxus_core::ScopeState; use dioxus_html::prelude::{EvalError, EvalProvider, Evaluator}; use std::{cell::RefCell, rc::Rc}; use crate::{query::Query, DesktopContext}; -/// Provides the DesktopEvalProvider through [`cx.provide_context`]. -pub fn init_eval(cx: &ScopeState) { - let desktop_ctx = cx.consume_context::().unwrap(); - let provider: Rc = Rc::new(DesktopEvalProvider { desktop_ctx }); - cx.provide_context(provider); -} - /// Reprents the desktop-target's provider of evaluators. pub struct DesktopEvalProvider { - desktop_ctx: DesktopContext, + pub(crate) desktop_ctx: DesktopContext, +} + +impl DesktopEvalProvider { + pub fn new(desktop_ctx: DesktopContext) -> Self { + Self { desktop_ctx } + } } impl EvalProvider for DesktopEvalProvider { diff --git a/packages/desktop/src/file_upload.rs b/packages/desktop/src/file_upload.rs index 7b5f08fc3..98dbec437 100644 --- a/packages/desktop/src/file_upload.rs +++ b/packages/desktop/src/file_upload.rs @@ -14,74 +14,77 @@ pub(crate) struct FileDialogRequest { pub bubbles: bool, } -#[cfg(not(any( - target_os = "windows", - target_os = "macos", - target_os = "linux", - target_os = "dragonfly", - target_os = "freebsd", - target_os = "netbsd", - target_os = "openbsd" -)))] -pub(crate) fn get_file_event(_request: &FileDialogRequest) -> Vec { - vec![] -} +#[allow(unused)] +impl FileDialogRequest { + #[cfg(not(any( + target_os = "windows", + target_os = "macos", + target_os = "linux", + target_os = "dragonfly", + target_os = "freebsd", + target_os = "netbsd", + target_os = "openbsd" + )))] + pub(crate) fn get_file_event(&self) -> Vec { + vec![] + } -#[cfg(any( - target_os = "windows", - target_os = "macos", - target_os = "linux", - target_os = "dragonfly", - target_os = "freebsd", - target_os = "netbsd", - target_os = "openbsd" -))] -pub(crate) fn get_file_event(request: &FileDialogRequest) -> Vec { - fn get_file_event_for_folder( - request: &FileDialogRequest, - dialog: rfd::FileDialog, - ) -> Vec { - if request.multiple { - dialog.pick_folders().into_iter().flatten().collect() - } else { - dialog.pick_folder().into_iter().collect() + #[cfg(any( + target_os = "windows", + target_os = "macos", + target_os = "linux", + target_os = "dragonfly", + target_os = "freebsd", + target_os = "netbsd", + target_os = "openbsd" + ))] + pub(crate) fn get_file_event(&self) -> Vec { + fn get_file_event_for_folder( + request: &FileDialogRequest, + dialog: rfd::FileDialog, + ) -> Vec { + if request.multiple { + dialog.pick_folders().into_iter().flatten().collect() + } else { + dialog.pick_folder().into_iter().collect() + } } - } - fn get_file_event_for_file( - request: &FileDialogRequest, - mut dialog: rfd::FileDialog, - ) -> Vec { - let filters: Vec<_> = request - .accept - .as_deref() - .unwrap_or_default() - .split(',') - .filter_map(|s| Filters::from_str(s).ok()) - .collect(); + fn get_file_event_for_file( + request: &FileDialogRequest, + mut dialog: rfd::FileDialog, + ) -> Vec { + let filters: Vec<_> = request + .accept + .as_deref() + .unwrap_or_default() + .split(',') + .filter_map(|s| Filters::from_str(s).ok()) + .collect(); - let file_extensions: Vec<_> = filters - .iter() - .flat_map(|f| f.as_extensions().into_iter()) - .collect(); + let file_extensions: Vec<_> = filters + .iter() + .flat_map(|f| f.as_extensions().into_iter()) + .collect(); - dialog = dialog.add_filter("name", file_extensions.as_slice()); + dialog = dialog.add_filter("name", file_extensions.as_slice()); - let files: Vec<_> = if request.multiple { - dialog.pick_files().into_iter().flatten().collect() + let files: Vec<_> = if request.multiple { + dialog.pick_files().into_iter().flatten().collect() + } else { + dialog.pick_file().into_iter().collect() + }; + + files + } + + let dialog = rfd::FileDialog::new(); + + if self.directory { + get_file_event_for_folder(self, dialog) } else { - dialog.pick_file().into_iter().collect() - }; - - files - } - - let dialog = rfd::FileDialog::new(); - - if request.directory { - get_file_event_for_folder(request, dialog) - } else { - get_file_event_for_file(request, dialog) + get_file_event_for_file(self, dialog) + } } } diff --git a/packages/desktop/src/webview.rs b/packages/desktop/src/webview.rs index cd83362b5..6eac25b62 100644 --- a/packages/desktop/src/webview.rs +++ b/packages/desktop/src/webview.rs @@ -1,15 +1,17 @@ use std::{rc::Rc, task::Waker}; -use crate::edits::{EditQueue, WebviewQueue}; use crate::{ assets::AssetHandlerRegistry, desktop_context::UserWindowEvent, waker::tao_waker, Config, DesktopContext, }; use crate::{ desktop_context::{EventData, WindowEventHandlers}, - eval::init_eval, shortcut::ShortcutRegistry, }; +use crate::{ + edits::{EditQueue, WebviewQueue}, + eval::DesktopEvalProvider, +}; use crate::{ protocol::{self}, DesktopService, @@ -162,9 +164,12 @@ pub fn create_new_window( asset_handlers, )); + // Provide the desktop context to the virtualdom dom.base_scope().provide_context(desktop_context.clone()); - init_eval(dom.base_scope()); + // Also set up its eval provider + dom.base_scope() + .provide_context(Rc::new(DesktopEvalProvider::new(desktop_context.clone()))); WebviewHandler { // We want to poll the virtualdom and the event loop at the same time, so the waker will be connected to both From 73d5069a2056c0a2ea4a0d88e00c91a7e0d12185 Mon Sep 17 00:00:00 2001 From: Jonathan Kelley Date: Thu, 4 Jan 2024 18:31:22 -0800 Subject: [PATCH 408/447] Move launch functions into their own file --- packages/desktop/src/launch.rs | 120 ++++++++++++++++++++++++++++++ packages/desktop/src/lib.rs | 130 ++------------------------------- 2 files changed, 126 insertions(+), 124 deletions(-) create mode 100644 packages/desktop/src/launch.rs diff --git a/packages/desktop/src/launch.rs b/packages/desktop/src/launch.rs new file mode 100644 index 000000000..8af51e137 --- /dev/null +++ b/packages/desktop/src/launch.rs @@ -0,0 +1,120 @@ +use crate::{ + app::App, + desktop_context::{EventData, UserWindowEvent}, + events::IpcMethod, + Config, +}; +use dioxus_core::*; +use tao::event::{Event, StartCause, WindowEvent}; +use tokio::runtime::Builder; + +/// Launch the WebView and run the event loop. +/// +/// This function will start a multithreaded Tokio runtime as well the WebView event loop. +/// +/// ```rust, no_run +/// use dioxus::prelude::*; +/// +/// fn main() { +/// dioxus_desktop::launch(app); +/// } +/// +/// fn app(cx: Scope) -> Element { +/// cx.render(rsx!{ +/// h1 {"hello world!"} +/// }) +/// } +/// ``` +pub fn launch(root: Component) { + launch_with_props(root, (), Config::default()) +} + +/// Launch the WebView and run the event loop, with configuration. +/// +/// This function will start a multithreaded Tokio runtime as well the WebView event loop. +/// +/// You can configure the WebView window with a configuration closure +/// +/// ```rust, no_run +/// use dioxus::prelude::*; +/// use dioxus_desktop::*; +/// +/// fn main() { +/// dioxus_desktop::launch_cfg(app, Config::default().with_window(WindowBuilder::new().with_title("My App"))); +/// } +/// +/// fn app(cx: Scope) -> Element { +/// cx.render(rsx!{ +/// h1 {"hello world!"} +/// }) +/// } +/// ``` +pub fn launch_cfg(root: Component, config_builder: Config) { + launch_with_props(root, (), config_builder) +} + +/// Launch the WebView and run the event loop, with configuration and root props. +/// +/// This function will start a multithreaded Tokio runtime as well the WebView event loop. This will block the current thread. +/// +/// You can configure the WebView window with a configuration closure +/// +/// ```rust, no_run +/// use dioxus::prelude::*; +/// use dioxus_desktop::Config; +/// +/// fn main() { +/// dioxus_desktop::launch_with_props(app, AppProps { name: "asd" }, Config::default()); +/// } +/// +/// struct AppProps { +/// name: &'static str +/// } +/// +/// fn app(cx: Scope) -> Element { +/// cx.render(rsx!{ +/// h1 {"hello {cx.props.name}!"} +/// }) +/// } +/// ``` +pub fn launch_with_props(root: Component

, props: P, cfg: Config) { + // We start the tokio runtime *on this thread* + // Any future we poll later will use this runtime to spawn tasks and for IO + // I would love to just allow dioxus to work with any runtime... but tokio is weird + let rt = Builder::new_multi_thread().enable_all().build().unwrap(); + let _guard = rt.enter(); + + let (event_loop, mut app) = App::new(cfg, props, root); + + event_loop.run(move |window_event, event_loop, control_flow| { + app.tick(&window_event, event_loop); + + match window_event { + Event::NewEvents(StartCause::Init) => app.handle_start_cause_init(event_loop), + Event::WindowEvent { + event, window_id, .. + } => match event { + WindowEvent::CloseRequested => app.handle_close_requested(window_id), + WindowEvent::Destroyed { .. } => app.window_destroyed(window_id), + _ => {} + }, + Event::UserEvent(UserWindowEvent(event, id)) => match event { + EventData::Poll => app.poll_vdom(id), + EventData::NewWindow => app.handle_new_window(), + EventData::CloseWindow => app.handle_close_msg(id), + EventData::HotReloadEvent(msg) => app.handle_hot_reload_msg(msg), + EventData::Ipc(msg) => match msg.method() { + IpcMethod::FileDialog => app.handle_file_dialog_msg(msg, id), + IpcMethod::UserEvent => app.handle_user_event_msg(msg, id), + IpcMethod::Query => app.handle_query_msg(msg, id), + IpcMethod::BrowserOpen => app.handle_browser_open(msg), + IpcMethod::Initialize => app.handle_initialize_msg(id), + IpcMethod::Other(_) => {} + }, + }, + _ => {} + } + + *control_flow = app.control_flow; + }) +} diff --git a/packages/desktop/src/lib.rs b/packages/desktop/src/lib.rs index ca1e851fb..818605dc5 100644 --- a/packages/desktop/src/lib.rs +++ b/packages/desktop/src/lib.rs @@ -23,12 +23,12 @@ mod shortcut; mod waker; mod webview; -// Re-exports -pub use tao::{ - self, - dpi::{LogicalSize, PhysicalSize}, - window::WindowBuilder, -}; +// The main entrypoint for this crate +pub use launch::*; +mod launch; + +// Reexport tao and wry, might want to re-export other important things +pub use tao; pub use wry; // Public exports @@ -40,121 +40,3 @@ pub use desktop_context::{ pub use hooks::{use_asset_handler, use_global_shortcut, use_window, use_wry_event_handler}; pub use menubar::build_default_menu_bar; pub use shortcut::{ShortcutHandle, ShortcutId, ShortcutRegistryError}; - -#[allow(deprecated)] -use desktop_context::{EventData, UserWindowEvent}; -use dioxus_core::*; -use events::IpcMethod; -use tao::event::{Event, StartCause, WindowEvent}; -use tokio::runtime::Builder; - -/// Launch the WebView and run the event loop. -/// -/// This function will start a multithreaded Tokio runtime as well the WebView event loop. -/// -/// ```rust, no_run -/// use dioxus::prelude::*; -/// -/// fn main() { -/// dioxus_desktop::launch(app); -/// } -/// -/// fn app(cx: Scope) -> Element { -/// cx.render(rsx!{ -/// h1 {"hello world!"} -/// }) -/// } -/// ``` -pub fn launch(root: Component) { - launch_with_props(root, (), Config::default()) -} - -/// Launch the WebView and run the event loop, with configuration. -/// -/// This function will start a multithreaded Tokio runtime as well the WebView event loop. -/// -/// You can configure the WebView window with a configuration closure -/// -/// ```rust, no_run -/// use dioxus::prelude::*; -/// use dioxus_desktop::*; -/// -/// fn main() { -/// dioxus_desktop::launch_cfg(app, Config::default().with_window(WindowBuilder::new().with_title("My App"))); -/// } -/// -/// fn app(cx: Scope) -> Element { -/// cx.render(rsx!{ -/// h1 {"hello world!"} -/// }) -/// } -/// ``` -pub fn launch_cfg(root: Component, config_builder: Config) { - launch_with_props(root, (), config_builder) -} - -/// Launch the WebView and run the event loop, with configuration and root props. -/// -/// This function will start a multithreaded Tokio runtime as well the WebView event loop. This will block the current thread. -/// -/// You can configure the WebView window with a configuration closure -/// -/// ```rust, no_run -/// use dioxus::prelude::*; -/// use dioxus_desktop::Config; -/// -/// fn main() { -/// dioxus_desktop::launch_with_props(app, AppProps { name: "asd" }, Config::default()); -/// } -/// -/// struct AppProps { -/// name: &'static str -/// } -/// -/// fn app(cx: Scope) -> Element { -/// cx.render(rsx!{ -/// h1 {"hello {cx.props.name}!"} -/// }) -/// } -/// ``` -pub fn launch_with_props(root: Component

, props: P, cfg: Config) { - // We start the tokio runtime *on this thread* - // Any future we poll later will use this runtime to spawn tasks and for IO - // I would love to just allow dioxus to work with any runtime... but tokio is weird - let rt = &Builder::new_multi_thread().enable_all().build().unwrap(); - let _guard = rt.enter(); - - let (event_loop, mut app) = app::App::new(cfg, props, root); - - event_loop.run(move |window_event, event_loop, control_flow| { - app.tick(&window_event, event_loop); - - match window_event { - Event::NewEvents(StartCause::Init) => app.handle_start_cause_init(event_loop), - Event::WindowEvent { - event, window_id, .. - } => match event { - WindowEvent::CloseRequested => app.handle_close_requested(window_id), - WindowEvent::Destroyed { .. } => app.window_destroyed(window_id), - _ => {} - }, - Event::UserEvent(UserWindowEvent(event, id)) => match event { - EventData::Poll => app.poll_vdom(id), - EventData::NewWindow => app.handle_new_window(), - EventData::CloseWindow => app.handle_close_msg(id), - EventData::HotReloadEvent(msg) => app.handle_hot_reload_msg(msg), - EventData::Ipc(msg) => match msg.method() { - IpcMethod::FileDialog => app.handle_file_dialog_msg(msg, id), - IpcMethod::UserEvent => app.handle_user_event_msg(msg, id), - IpcMethod::Query => app.handle_query_msg(msg, id), - IpcMethod::BrowserOpen => app.handle_browser_open(msg), - IpcMethod::Initialize => app.handle_initialize_msg(id), - IpcMethod::Other(_) => {} - }, - }, - _ => {} - } - - *control_flow = app.control_flow; - }) -} From 38216fa2729a8f07fcb055d60dc66bebdd6db908 Mon Sep 17 00:00:00 2001 From: Jonathan Kelley Date: Thu, 4 Jan 2024 19:09:59 -0800 Subject: [PATCH 409/447] Make the tokio runtime optional --- examples/clock.rs | 5 +++-- packages/desktop/src/app.rs | 24 +++++++++----------- packages/desktop/src/cfg.rs | 15 +++++++++++++ packages/desktop/src/desktop_context.rs | 2 +- packages/desktop/src/{events.rs => ipc.rs} | 0 packages/desktop/src/launch.rs | 26 ++++++++++++++++------ packages/desktop/src/lib.rs | 7 +++--- packages/desktop/src/protocol.rs | 9 ++++++-- 8 files changed, 60 insertions(+), 28 deletions(-) rename packages/desktop/src/{events.rs => ipc.rs} (100%) diff --git a/examples/clock.rs b/examples/clock.rs index f9c1892d9..4b7be3d3b 100644 --- a/examples/clock.rs +++ b/examples/clock.rs @@ -1,7 +1,8 @@ use dioxus::prelude::*; use dioxus_signals::use_signal; -fn main() { +#[tokio::main] +async fn main() { dioxus_desktop::launch(app); } @@ -10,7 +11,7 @@ fn app(cx: Scope) -> Element { use_future!(cx, || async move { loop { - tokio::time::sleep(std::time::Duration::from_millis(100)).await; + tokio::time::sleep(std::time::Duration::from_millis(10)).await; count += 1; println!("current: {count}"); } diff --git a/packages/desktop/src/app.rs b/packages/desktop/src/app.rs index 9a45e6c19..c8ca8a92a 100644 --- a/packages/desktop/src/app.rs +++ b/packages/desktop/src/app.rs @@ -3,30 +3,28 @@ use crate::{ desktop_context::{EventData, UserWindowEvent, WindowEventHandlers}, edits::WebviewQueue, element::DesktopElement, - events::IpcMessage, file_upload::FileDialogRequest, + ipc::IpcMessage, query::QueryResult, shortcut::{GlobalHotKeyEvent, ShortcutRegistry}, webview::WebviewHandler, }; use dioxus_core::{Component, ElementId, VirtualDom}; -use dioxus_html::MountedData; -use dioxus_html::{native_bind::NativeFileEngine, FormData, HtmlEvent}; +use dioxus_html::{native_bind::NativeFileEngine, FormData, HtmlEvent, MountedData}; use futures_util::{pin_mut, FutureExt}; -use std::cell::Cell; -use std::rc::Rc; -use std::{collections::HashMap, sync::Arc}; -use tao::event_loop::EventLoopBuilder; -use tao::event_loop::{EventLoop, EventLoopProxy, EventLoopWindowTarget}; -use tao::window::WindowId; -use tao::{event::Event, event_loop::ControlFlow}; -use wry::WebView; +use std::{cell::Cell, collections::HashMap, rc::Rc, sync::Arc}; +use tao::{ + event::Event, + event_loop::{ControlFlow, EventLoop, EventLoopBuilder, EventLoopProxy, EventLoopWindowTarget}, + window::WindowId, +}; -pub struct App

{ +pub(crate) struct App

{ // move the props into a cell so we can pop it out later to create the first window // iOS panics if we create a window before the event loop is started pub(crate) props: Rc>>, pub(crate) cfg: Rc>>, + pub(crate) root: Component

, pub(crate) webviews: HashMap, pub(crate) event_handlers: WindowEventHandlers, @@ -310,7 +308,7 @@ impl App

{ /// Different hide implementations per platform #[allow(unused)] -pub fn hide_app_window(webview: &WebView) { +pub fn hide_app_window(webview: &wry::WebView) { #[cfg(target_os = "windows")] { use wry::application::platform::windows::WindowExtWindows; diff --git a/packages/desktop/src/cfg.rs b/packages/desktop/src/cfg.rs index 4fb7f6ecb..a5d17b541 100644 --- a/packages/desktop/src/cfg.rs +++ b/packages/desktop/src/cfg.rs @@ -1,6 +1,7 @@ use std::borrow::Cow; use std::path::PathBuf; +use dioxus_core::prelude::Component; use tao::window::{Icon, WindowBuilder, WindowId}; use wry::{ http::{Request as HttpRequest, Response as HttpResponse}, @@ -68,6 +69,20 @@ impl Config { } } + /// Launch a Dioxus app using the given component and config + /// + /// See the [`crate::launch::launch`] function for more details. + pub fn launch(self, root: Component<()>) { + crate::launch::launch_cfg(root, self) + } + + /// Launch a Dioxus app using the given component, config, and props + /// + /// See the [`crate::launch::launch_with_props`] function for more details. + pub fn launch_with_props(self, root: Component

, props: P) { + crate::launch::launch_with_props(root, props, self) + } + /// Set whether the default menu bar should be enabled. /// /// > Note: `enable` is `true` by default. To disable the default menu bar pass `false`. diff --git a/packages/desktop/src/desktop_context.rs b/packages/desktop/src/desktop_context.rs index ef2f671b2..e1ed1f07a 100644 --- a/packages/desktop/src/desktop_context.rs +++ b/packages/desktop/src/desktop_context.rs @@ -1,4 +1,4 @@ -use crate::events::IpcMessage; +use crate::ipc::IpcMessage; use crate::query::QueryEngine; use crate::shortcut::{HotKey, ShortcutId, ShortcutRegistry, ShortcutRegistryError}; use crate::AssetHandler; diff --git a/packages/desktop/src/events.rs b/packages/desktop/src/ipc.rs similarity index 100% rename from packages/desktop/src/events.rs rename to packages/desktop/src/ipc.rs diff --git a/packages/desktop/src/launch.rs b/packages/desktop/src/launch.rs index 8af51e137..8ee939494 100644 --- a/packages/desktop/src/launch.rs +++ b/packages/desktop/src/launch.rs @@ -1,12 +1,11 @@ use crate::{ app::App, desktop_context::{EventData, UserWindowEvent}, - events::IpcMethod, + ipc::IpcMethod, Config, }; use dioxus_core::*; use tao::event::{Event, StartCause, WindowEvent}; -use tokio::runtime::Builder; /// Launch the WebView and run the event loop. /// @@ -55,6 +54,7 @@ pub fn launch_cfg(root: Component, config_builder: Config) { /// Launch the WebView and run the event loop, with configuration and root props. /// +/// If the [`tokio`] feature is enabled, this will also startup and block a tokio runtime using the unconstrained task. /// This function will start a multithreaded Tokio runtime as well the WebView event loop. This will block the current thread. /// /// You can configure the WebView window with a configuration closure @@ -78,12 +78,24 @@ pub fn launch_cfg(root: Component, config_builder: Config) { /// } /// ``` pub fn launch_with_props(root: Component

, props: P, cfg: Config) { - // We start the tokio runtime *on this thread* - // Any future we poll later will use this runtime to spawn tasks and for IO - // I would love to just allow dioxus to work with any runtime... but tokio is weird - let rt = Builder::new_multi_thread().enable_all().build().unwrap(); - let _guard = rt.enter(); + #[cfg(feature = "tokio")] + tokio::runtime::Builder::new_multi_thread() + .enable_all() + .build() + .unwrap() + .block_on(tokio::task::unconstrained(async move { + launch_with_props_blocking(root, props, cfg); + })); + #[cfg(not(feature = "tokio"))] + launch_with_props_blocking(root, props, cfg); +} + +/// Launch the WebView and run the event loop, with configuration and root props. +/// +/// This will block the main thread, and *must* be spawned on the main thread. This function does not assume any runtime +/// and is equivalent to calling launch_with_props with the tokio feature disabled. +pub fn launch_with_props_blocking(root: Component

, props: P, cfg: Config) { let (event_loop, mut app) = App::new(cfg, props, root); event_loop.run(move |window_event, event_loop, control_flow| { diff --git a/packages/desktop/src/lib.rs b/packages/desktop/src/lib.rs index 818605dc5..3f8d9d3ce 100644 --- a/packages/desktop/src/lib.rs +++ b/packages/desktop/src/lib.rs @@ -11,18 +11,19 @@ mod edits; mod element; mod escape; mod eval; -mod events; mod file_upload; mod hooks; +mod ipc; mod menubar; -#[cfg(any(target_os = "ios", target_os = "android"))] -mod mobile_shortcut; mod protocol; mod query; mod shortcut; mod waker; mod webview; +#[cfg(any(target_os = "ios", target_os = "android"))] +mod mobile_shortcut; + // The main entrypoint for this crate pub use launch::*; mod launch; diff --git a/packages/desktop/src/protocol.rs b/packages/desktop/src/protocol.rs index 77acebad6..bdcefa473 100644 --- a/packages/desktop/src/protocol.rs +++ b/packages/desktop/src/protocol.rs @@ -57,7 +57,8 @@ pub(super) async fn desktop_handler( .body(Cow::from(body)) { Ok(response) => { - return responder.respond(response); + responder.respond(response); + return; } Err(err) => tracing::error!("error building response: {}", err), } @@ -103,7 +104,10 @@ pub(super) async fn desktop_handler( .header("Content-Type", content_type) .body(Cow::from(asset)) { - Ok(response) => return responder.respond(response), + Ok(response) => { + responder.respond(response); + return; + } Err(err) => tracing::error!("error building response: {}", err), } } @@ -114,6 +118,7 @@ pub(super) async fn desktop_handler( { Ok(response) => { responder.respond(response); + return; } Err(err) => tracing::error!("error building response: {}", err), } From 2e9737ef57ad37a8eb7444ebe3b32aa6c3fbf75f Mon Sep 17 00:00:00 2001 From: Jonathan Kelley Date: Thu, 4 Jan 2024 19:52:49 -0800 Subject: [PATCH 410/447] Clean up and document the protocol handler --- examples/clock.rs | 3 +- packages/desktop/src/index.html | 18 +-- packages/desktop/src/protocol.rs | 199 ++++++++++++++----------------- 3 files changed, 99 insertions(+), 121 deletions(-) diff --git a/examples/clock.rs b/examples/clock.rs index 4b7be3d3b..ba47d994a 100644 --- a/examples/clock.rs +++ b/examples/clock.rs @@ -1,8 +1,7 @@ use dioxus::prelude::*; use dioxus_signals::use_signal; -#[tokio::main] -async fn main() { +fn main() { dioxus_desktop::launch(app); } diff --git a/packages/desktop/src/index.html b/packages/desktop/src/index.html index 0704fd0f0..45926e3f1 100644 --- a/packages/desktop/src/index.html +++ b/packages/desktop/src/index.html @@ -1,12 +1,12 @@ - - Dioxus app - - - - -

- - + + Dioxus app + + + + +
+ + diff --git a/packages/desktop/src/protocol.rs b/packages/desktop/src/protocol.rs index bdcefa473..be3c12231 100644 --- a/packages/desktop/src/protocol.rs +++ b/packages/desktop/src/protocol.rs @@ -5,10 +5,11 @@ use std::{ }; use wry::{ http::{status::StatusCode, Request, Response}, - Result, + RequestAsyncResponder, Result, }; static MINIFIED: &str = include_str!("./minified.js"); +static DEFAULT_INDEX: &str = include_str!("./index.html"); pub(super) async fn desktop_handler( request: Request>, @@ -18,120 +19,110 @@ pub(super) async fn desktop_handler( asset_handlers: &AssetHandlerRegistry, edit_queue: &EditQueue, headless: bool, - responder: wry::RequestAsyncResponder, + responder: RequestAsyncResponder, ) { let request = AssetRequest::from(request); // If the request is for the root, we'll serve the index.html file. if request.uri().path() == "/" { - // If a custom index is provided, just defer to that, expecting the user to know what they're doing. - // we'll look for the closing tag and insert our little module loader there. - let body = match custom_index { - Some(custom_index) => custom_index - .replace( - "", - &format!("{}", module_loader(root_name, headless)), - ) - .into_bytes(), - - None => { - // Otherwise, we'll serve the default index.html and apply a custom head if that's specified. - let mut template = include_str!("./index.html").to_string(); - - if let Some(custom_head) = custom_head { - template = template.replace("", &custom_head); - } - - template - .replace( - "", - &module_loader(root_name, headless), - ) - .into_bytes() - } - }; - - match Response::builder() - .header("Content-Type", "text/html") - .header("Access-Control-Allow-Origin", "*") - .body(Cow::from(body)) - { - Ok(response) => { - responder.respond(response); - return; - } - Err(err) => tracing::error!("error building response: {}", err), + match build_index_file(custom_index, custom_head, root_name, headless) { + Ok(response) => return responder.respond(response), + Err(err) => return tracing::error!("error building response: {}", err), } - } else if request.uri().path().trim_matches('/') == "edits" { - edit_queue.handle_request(responder); - return; } - // If the user provided a custom asset handler, then call it and return the response - // if the request was handled. + // If the request is asking for edits (ie binary protocol streaming, do that) + if request.uri().path().trim_matches('/') == "edits" { + return edit_queue.handle_request(responder); + } + + // If the user provided a custom asset handler, then call it and return the response if the request was handled. if let Some(response) = asset_handlers.try_handlers(&request).await { - responder.respond(response); - return; + return responder.respond(response); } // Else, try to serve a file from the filesystem. + match serve_from_fs(request) { + Ok(res) => responder.respond(res), + Err(e) => tracing::error!("Error serving request from filesystem {}", e), + } +} +fn serve_from_fs(request: AssetRequest) -> Result { // If the path is relative, we'll try to serve it from the assets directory. let mut asset = get_asset_root() .unwrap_or_else(|| Path::new(".").to_path_buf()) .join(&request.path); + // If we can't find it, make it absolute and try again if !asset.exists() { asset = PathBuf::from("/").join(request.path); } if asset.exists() { - let content_type = match get_mime_from_path(&asset) { - Ok(content_type) => content_type, - Err(err) => { - tracing::error!("error getting mime type: {}", err); - return; - } - }; - let asset = match std::fs::read(asset) { - Ok(asset) => asset, - Err(err) => { - tracing::error!("error reading asset: {}", err); - return; - } - }; - match Response::builder() - .header("Content-Type", content_type) - .body(Cow::from(asset)) - { - Ok(response) => { - responder.respond(response); - return; - } - Err(err) => tracing::error!("error building response: {}", err), - } - } + let content_type = get_mime_from_path(&asset)?; + let asset = std::fs::read(asset)?; - match Response::builder() - .status(StatusCode::NOT_FOUND) - .body(Cow::from(String::from("Not Found").into_bytes())) - { - Ok(response) => { - responder.respond(response); - return; - } - Err(err) => tracing::error!("error building response: {}", err), + Ok(Response::builder() + .header("Content-Type", content_type) + .body(Cow::from(asset))?) + } else { + Ok(Response::builder() + .status(StatusCode::NOT_FOUND) + .body(Cow::from(String::from("Not Found").into_bytes()))?) } } -fn module_loader(root_name: &str, headless: bool) -> String { +/// Build the index.html file we use for bootstrapping a new app +/// +/// We use wry/webview by building a special index.html that forms a bridge between the webview and your rust code +/// +/// This is similar to tauri, except we give more power to your rust code and less power to your frontend code. +/// This lets us skip a build/bundle step - your code just works - but limits how your Rust code can actually +/// mess with UI elements. We make this decision since other renderers like LiveView are very separate and can +/// never properly bridge the gap. Eventually of course, the idea is to build a custom CSS/HTML renderer where you +/// *do* have native control over elements, but that still won't work with liveview. +fn build_index_file( + custom_index: Option, + custom_head: Option, + root_name: &str, + headless: bool, +) -> std::result::Result>, wry::http::Error> { + // Load a custom index file if provided + let mut index = custom_index.unwrap_or_else(|| DEFAULT_INDEX.to_string()); + + // Insert a custom head if provided + // We look just for the closing head tag. If a user provided a custom index with weird syntax, this might fail + if let Some(head) = custom_head { + index.insert_str(index.find("").expect("Head element to exist"), &head); + } + + // Inject our module loader + index.insert_str( + index.find("").expect("Body element to exist"), + &module_loader(root_name, headless), + ); + + Response::builder() + .header("Content-Type", "text/html") + .header("Access-Control-Allow-Origin", "*") + .body(Cow::from(index.into_bytes())) +} + +/// Construct the inline script that boots up the page and bridges the webview with rust code. +/// +/// The arguments here: +/// - root_name: the root element (by Id) that we stream edits into +/// - headless: is this page being loaded but invisible? Important because not all windows are visible and the +/// interpreter can't connect until the window is ready. +fn module_loader(root_id: &str, headless: bool) -> String { format!( r#"
@@ -49,7 +48,7 @@ fn deeply_nested() {
"# - .trim(); + .trim(); let dom = Dom::parse(html).unwrap(); diff --git a/packages/rsx/src/component.rs b/packages/rsx/src/component.rs index f28859352..6487e5ab7 100644 --- a/packages/rsx/src/component.rs +++ b/packages/rsx/src/component.rs @@ -162,11 +162,10 @@ impl ToTokens for Component { } if !self.children.is_empty() { - let renderer: TemplateRenderer = - TemplateRenderer { - roots: &self.children, - location: None, - }; + let renderer: TemplateRenderer = TemplateRenderer { + roots: &self.children, + location: None, + }; toks.append_all(quote! { .children( @@ -184,11 +183,10 @@ impl ToTokens for Component { let fn_name = self.name.segments.last().unwrap().ident.to_string(); - let gen_name = - match &self.prop_gen_args { - Some(gen) => quote! { #name #gen }, - None => quote! { #name }, - }; + let gen_name = match &self.prop_gen_args { + Some(gen) => quote! { #name #gen }, + None => quote! { #name }, + }; tokens.append_all(quote! { __cx.component( diff --git a/packages/rsx/src/element.rs b/packages/rsx/src/element.rs index 136eeaea2..8f45d91ff 100644 --- a/packages/rsx/src/element.rs +++ b/packages/rsx/src/element.rs @@ -332,60 +332,59 @@ impl ToTokens for ElementAttrNamed { } }; - let attribute = - match attr { - ElementAttr::AttrText { name, value } => { - let ns = ns(name); - let volitile = volitile(name); - let attribute = attribute(name); - quote! { - __cx.attr( - #attribute, - #value, - #ns, - #volitile - ) - } + let attribute = match attr { + ElementAttr::AttrText { name, value } => { + let ns = ns(name); + let volitile = volitile(name); + let attribute = attribute(name); + quote! { + __cx.attr( + #attribute, + #value, + #ns, + #volitile + ) } - ElementAttr::AttrExpression { name, value } => { - let ns = ns(name); - let volitile = volitile(name); - let attribute = attribute(name); - quote! { - __cx.attr( - #attribute, - #value, - #ns, - #volitile - ) - } + } + ElementAttr::AttrExpression { name, value } => { + let ns = ns(name); + let volitile = volitile(name); + let attribute = attribute(name); + quote! { + __cx.attr( + #attribute, + #value, + #ns, + #volitile + ) } - ElementAttr::CustomAttrText { name, value } => { - quote! { - __cx.attr( - #name, - #value, - None, - false - ) - } + } + ElementAttr::CustomAttrText { name, value } => { + quote! { + __cx.attr( + #name, + #value, + None, + false + ) } - ElementAttr::CustomAttrExpression { name, value } => { - quote! { - __cx.attr( - #name, - #value, - None, - false - ) - } + } + ElementAttr::CustomAttrExpression { name, value } => { + quote! { + __cx.attr( + #name, + #value, + None, + false + ) } - ElementAttr::EventTokens { name, tokens } => { - quote! { - dioxus_elements::events::#name(__cx, #tokens) - } + } + ElementAttr::EventTokens { name, tokens } => { + quote! { + dioxus_elements::events::#name(__cx, #tokens) } - }; + } + }; tokens.append_all(attribute); } diff --git a/packages/rsx/src/hot_reload/hot_reloading_file_map.rs b/packages/rsx/src/hot_reload/hot_reloading_file_map.rs index 875323405..0393142b4 100644 --- a/packages/rsx/src/hot_reload/hot_reloading_file_map.rs +++ b/packages/rsx/src/hot_reload/hot_reloading_file_map.rs @@ -77,12 +77,11 @@ impl FileMap { } let FileMapSearchResult { map, errors } = find_rs_files(path, &mut filter)?; - let result = - Self { - map, - in_workspace: HashMap::new(), - phantom: std::marker::PhantomData, - }; + let result = Self { + map, + in_workspace: HashMap::new(), + phantom: std::marker::PhantomData, + }; Ok(FileMapBuildResult { map: result, errors, diff --git a/packages/rsx/src/ifmt.rs b/packages/rsx/src/ifmt.rs index 31d7c6a78..6c72f5025 100644 --- a/packages/rsx/src/ifmt.rs +++ b/packages/rsx/src/ifmt.rs @@ -99,9 +99,10 @@ impl FromStr for IfmtInput { current_literal.push(c); continue; } else { - return Err( - Error::new(Span::call_site(), "unmatched closing '}' in format string") - ); + return Err(Error::new( + Span::call_site(), + "unmatched closing '}' in format string", + )); } } current_literal.push(c); @@ -146,18 +147,17 @@ impl ToTokens for IfmtInput { } } - let positional_args = - self.segments.iter().filter_map(|seg| { - if let Segment::Formatted(FormattedSegment { - segment: FormattedSegmentType::Expr(expr), - .. - }) = seg - { - Some(expr) - } else { - None - } - }); + let positional_args = self.segments.iter().filter_map(|seg| { + if let Segment::Formatted(FormattedSegment { + segment: FormattedSegmentType::Expr(expr), + .. + }) = seg + { + Some(expr) + } else { + None + } + }); // remove duplicate idents let named_args_idents: HashSet<_> = self @@ -228,7 +228,10 @@ impl FormattedSegmentType { if let Ok(expr) = parse_str(input) { Ok(Self::Expr(Box::new(expr))) } else { - Err(Error::new(Span::call_site(), "Expected Ident or Expression")) + Err(Error::new( + Span::call_site(), + "Expected Ident or Expression", + )) } } } diff --git a/packages/rsx/src/lib.rs b/packages/rsx/src/lib.rs index 6657ac722..bdf32b272 100644 --- a/packages/rsx/src/lib.rs +++ b/packages/rsx/src/lib.rs @@ -199,11 +199,10 @@ impl<'a> ToTokens for TemplateRenderer<'a> { _ => None, }; - let key_tokens = - match key { - Some(tok) => quote! { Some( __cx.raw_text(#tok) ) }, - None => quote! { None }, - }; + let key_tokens = match key { + Some(tok) => quote! { Some( __cx.raw_text(#tok) ) }, + None => quote! { None }, + }; let spndbg = format!("{:?}", self.roots[0].span()); let root_col = spndbg @@ -519,13 +518,12 @@ impl<'a> DynamicContext<'a> { let attrs = quote! { #(#static_attrs),*}; - let children = - el.children.iter().enumerate().map(|(idx, root)| { - self.current_path.push(idx as u8); - let out = self.render_static_node(root); - self.current_path.pop(); - out - }); + let children = el.children.iter().enumerate().map(|(idx, root)| { + self.current_path.push(idx as u8); + let out = self.render_static_node(root); + self.current_path.pop(); + out + }); let _opt = el.children.len() == 1; let children = quote! { #(#children),* }; diff --git a/packages/server-macro/src/lib.rs b/packages/server-macro/src/lib.rs index 75cf7790c..5ad9a682b 100644 --- a/packages/server-macro/src/lib.rs +++ b/packages/server-macro/src/lib.rs @@ -65,11 +65,10 @@ use syn::{ #[proc_macro_attribute] pub fn server(args: proc_macro::TokenStream, s: TokenStream) -> TokenStream { // before we pass this off to the server function macro, we apply extractors and middleware - let mut function: syn::ItemFn = - match syn::parse(s).map_err(|e| e.to_compile_error()) { - Ok(f) => f, - Err(e) => return e.into(), - }; + let mut function: syn::ItemFn = match syn::parse(s).map_err(|e| e.to_compile_error()) { + Ok(f) => f, + Err(e) => return e.into(), + }; // extract all #[middleware] attributes let mut middlewares: Vec = vec![]; diff --git a/packages/signals/src/effect.rs b/packages/signals/src/effect.rs index 87755180b..307ee98ab 100644 --- a/packages/signals/src/effect.rs +++ b/packages/signals/src/effect.rs @@ -87,12 +87,11 @@ impl Effect { /// /// The signal will be owned by the current component and will be dropped when the component is dropped. pub fn new(callback: impl FnMut() + 'static) -> Self { - let myself = - Self { - source: current_scope_id().expect("in a virtual dom"), - callback: CopyValue::new(Box::new(callback)), - effect_stack: get_effect_stack(), - }; + let myself = Self { + source: current_scope_id().expect("in a virtual dom"), + callback: CopyValue::new(Box::new(callback)), + effect_stack: get_effect_stack(), + }; myself.try_run(); diff --git a/packages/signals/src/selector.rs b/packages/signals/src/selector.rs index 3dd1c2291..556c8437c 100644 --- a/packages/signals/src/selector.rs +++ b/packages/signals/src/selector.rs @@ -72,10 +72,9 @@ where /// /// Selectors can be used to efficiently compute derived data from signals. pub fn selector(mut f: impl FnMut() -> R + 'static) -> ReadOnlySignal { - let state = - Signal:: { - inner: CopyValue::invalid(), - }; + let state = Signal:: { + inner: CopyValue::invalid(), + }; let effect = Effect { source: current_scope_id().expect("in a virtual dom"), callback: CopyValue::invalid(), diff --git a/packages/signals/tests/create.rs b/packages/signals/tests/create.rs index 0a172617e..ecda2f376 100644 --- a/packages/signals/tests/create.rs +++ b/packages/signals/tests/create.rs @@ -6,14 +6,13 @@ use dioxus_signals::*; #[test] fn create_signals_global() { - let mut dom = - VirtualDom::new(|cx| { - render! { - for _ in 0..10 { - Child {} - } + let mut dom = VirtualDom::new(|cx| { + render! { + for _ in 0..10 { + Child {} } - }); + } + }); fn Child(cx: Scope) -> Element { let signal = create_without_cx(); @@ -32,14 +31,13 @@ fn create_signals_global() { #[test] fn deref_signal() { - let mut dom = - VirtualDom::new(|cx| { - render! { - for _ in 0..10 { - Child {} - } + let mut dom = VirtualDom::new(|cx| { + render! { + for _ in 0..10 { + Child {} } - }); + } + }); fn Child(cx: Scope) -> Element { let signal = Signal::new("hello world".to_string()); @@ -57,17 +55,16 @@ fn deref_signal() { #[test] fn drop_signals() { - let mut dom = - VirtualDom::new(|cx| { - let generation = cx.generation(); + let mut dom = VirtualDom::new(|cx| { + let generation = cx.generation(); - let count = if generation % 2 == 0 { 10 } else { 0 }; - render! { - for _ in 0..count { - Child {} - } + let count = if generation % 2 == 0 { 10 } else { 0 }; + render! { + for _ in 0..count { + Child {} } - }); + } + }); fn Child(cx: Scope) -> Element { let signal = create_without_cx(); diff --git a/packages/signals/tests/selector.rs b/packages/signals/tests/selector.rs index b31e32a89..811871e88 100644 --- a/packages/signals/tests/selector.rs +++ b/packages/signals/tests/selector.rs @@ -100,15 +100,14 @@ fn memos_prevents_component_rerun() { let signal = cx.props.signal; counter.borrow_mut().component += 1; - let memo = - cx.use_hook(move || { - to_owned![counter]; - selector(move || { - counter.borrow_mut().effect += 1; - println!("Signal: {:?}", signal); - signal.value() - }) - }); + let memo = cx.use_hook(move || { + to_owned![counter]; + selector(move || { + counter.borrow_mut().effect += 1; + println!("Signal: {:?}", signal); + signal.value() + }) + }); match cx.generation() { 0 => { assert_eq!(memo.value(), 0); diff --git a/packages/web/src/cache.rs b/packages/web/src/cache.rs index 7648b1c47..e17203a65 100644 --- a/packages/web/src/cache.rs +++ b/packages/web/src/cache.rs @@ -1,301 +1,300 @@ -pub static BUILTIN_INTERNED_STRINGS: &[&str] = - &[ - // Important tags to dioxus - "dioxus-id", - "dioxus", - "dioxus-event-click", // todo: more events - "click", - // All the HTML Tags - "a", - "abbr", - "address", - "area", - "article", - "aside", - "audio", - "b", - "base", - "bdi", - "bdo", - "big", - "blockquote", - "body", - "br", - "button", - "canvas", - "caption", - "cite", - "code", - "col", - "colgroup", - "command", - "data", - "datalist", - "dd", - "del", - "details", - "dfn", - "dialog", - "div", - "dl", - "dt", - "em", - "embed", - "fieldset", - "figcaption", - "figure", - "footer", - "form", - "h1", - "h2", - "h3", - "h4", - "h5", - "h6", - "head", - "header", - "hr", - "html", - "i", - "iframe", - "img", - "input", - "ins", - "kbd", - "keygen", - "label", - "legend", - "li", - "link", - "main", - "map", - "mark", - "menu", - "menuitem", - "meta", - "meter", - "nav", - "noscript", - "object", - "ol", - "optgroup", - "option", - "output", - "p", - "param", - "picture", - "pre", - "progress", - "q", - "rp", - "rt", - "ruby", - "s", - "samp", - "script", - "section", - "select", - "small", - "source", - "span", - "strong", - "style", - "sub", - "summary", - "sup", - "table", - "tbody", - "td", - "textarea", - "tfoot", - "th", - "thead", - "time", - "title", - "tr", - "track", - "u", - "ul", - "var", - "video", - "wbr", - // All the event handlers - "Attribute", - "accept", - "accept-charset", - "accesskey", - "action", - "alt", - "async", - "autocomplete", - "autofocus", - "autoplay", - "charset", - "checked", - "cite", - "class", - "cols", - "colspan", - "content", - "contenteditable", - "controls", - "coords", - "data", - "data-*", - "datetime", - "default", - "defer", - "dir", - "dirname", - "disabled", - "download", - "draggable", - "enctype", - "for", - "form", - "formaction", - "headers", - "height", - "hidden", - "high", - "href", - "hreflang", - "http-equiv", - "id", - "ismap", - "kind", - "label", - "lang", - "list", - "loop", - "low", - "max", - "maxlength", - "media", - "method", - "min", - "multiple", - "muted", - "name", - "novalidate", - "onabort", - "onafterprint", - "onbeforeprint", - "onbeforeunload", - "onblur", - "oncanplay", - "oncanplaythrough", - "onchange", - "onclick", - "oncontextmenu", - "oncopy", - "oncuechange", - "oncut", - "ondblclick", - "ondrag", - "ondragend", - "ondragenter", - "ondragleave", - "ondragover", - "ondragstart", - "ondrop", - "ondurationchange", - "onemptied", - "onended", - "onerror", - "onfocus", - "onfocusout", - "onfocusin", - "onhashchange", - "oninput", - "oninvalid", - "onkeydown", - "onkeypress", - "onkeyup", - "onload", - "onloadeddata", - "onloadedmetadata", - "onloadstart", - "onmousedown", - "onmousemove", - "onmouseout", - "onmouseover", - "onmouseup", - "onmousewheel", - "onoffline", - "ononline", - "onpageshow", - "onpaste", - "onpause", - "onplay", - "onplaying", - "onprogress", - "onratechange", - "onreset", - "onresize", - "onscroll", - "onsearch", - "onseeked", - "onseeking", - "onselect", - "onstalled", - "onsubmit", - "onsuspend", - "ontimeupdate", - "ontoggle", - "onunload", - "onvolumechange", - "onwaiting", - "onwheel", - "open", - "optimum", - "pattern", - "placeholder", - "poster", - "preload", - "readonly", - "rel", - "required", - "reversed", - "rows", - "rowspan", - "sandbox", - "scope", - "selected", - "shape", - "size", - "sizes", - "span", - "spellcheck", - "src", - "srcdoc", - "srclang", - "srcset", - "start", - "step", - "style", - "tabindex", - "target", - "title", - "translate", - "type", - "usemap", - "value", - "width", - "wrap", - "0", - "1", - "2", - "3", - "4", - "5", - "6", - "7", - "8", - "9", - "10", - "11", - "12", - "13", - "14", - ]; +pub static BUILTIN_INTERNED_STRINGS: &[&str] = &[ + // Important tags to dioxus + "dioxus-id", + "dioxus", + "dioxus-event-click", // todo: more events + "click", + // All the HTML Tags + "a", + "abbr", + "address", + "area", + "article", + "aside", + "audio", + "b", + "base", + "bdi", + "bdo", + "big", + "blockquote", + "body", + "br", + "button", + "canvas", + "caption", + "cite", + "code", + "col", + "colgroup", + "command", + "data", + "datalist", + "dd", + "del", + "details", + "dfn", + "dialog", + "div", + "dl", + "dt", + "em", + "embed", + "fieldset", + "figcaption", + "figure", + "footer", + "form", + "h1", + "h2", + "h3", + "h4", + "h5", + "h6", + "head", + "header", + "hr", + "html", + "i", + "iframe", + "img", + "input", + "ins", + "kbd", + "keygen", + "label", + "legend", + "li", + "link", + "main", + "map", + "mark", + "menu", + "menuitem", + "meta", + "meter", + "nav", + "noscript", + "object", + "ol", + "optgroup", + "option", + "output", + "p", + "param", + "picture", + "pre", + "progress", + "q", + "rp", + "rt", + "ruby", + "s", + "samp", + "script", + "section", + "select", + "small", + "source", + "span", + "strong", + "style", + "sub", + "summary", + "sup", + "table", + "tbody", + "td", + "textarea", + "tfoot", + "th", + "thead", + "time", + "title", + "tr", + "track", + "u", + "ul", + "var", + "video", + "wbr", + // All the event handlers + "Attribute", + "accept", + "accept-charset", + "accesskey", + "action", + "alt", + "async", + "autocomplete", + "autofocus", + "autoplay", + "charset", + "checked", + "cite", + "class", + "cols", + "colspan", + "content", + "contenteditable", + "controls", + "coords", + "data", + "data-*", + "datetime", + "default", + "defer", + "dir", + "dirname", + "disabled", + "download", + "draggable", + "enctype", + "for", + "form", + "formaction", + "headers", + "height", + "hidden", + "high", + "href", + "hreflang", + "http-equiv", + "id", + "ismap", + "kind", + "label", + "lang", + "list", + "loop", + "low", + "max", + "maxlength", + "media", + "method", + "min", + "multiple", + "muted", + "name", + "novalidate", + "onabort", + "onafterprint", + "onbeforeprint", + "onbeforeunload", + "onblur", + "oncanplay", + "oncanplaythrough", + "onchange", + "onclick", + "oncontextmenu", + "oncopy", + "oncuechange", + "oncut", + "ondblclick", + "ondrag", + "ondragend", + "ondragenter", + "ondragleave", + "ondragover", + "ondragstart", + "ondrop", + "ondurationchange", + "onemptied", + "onended", + "onerror", + "onfocus", + "onfocusout", + "onfocusin", + "onhashchange", + "oninput", + "oninvalid", + "onkeydown", + "onkeypress", + "onkeyup", + "onload", + "onloadeddata", + "onloadedmetadata", + "onloadstart", + "onmousedown", + "onmousemove", + "onmouseout", + "onmouseover", + "onmouseup", + "onmousewheel", + "onoffline", + "ononline", + "onpageshow", + "onpaste", + "onpause", + "onplay", + "onplaying", + "onprogress", + "onratechange", + "onreset", + "onresize", + "onscroll", + "onsearch", + "onseeked", + "onseeking", + "onselect", + "onstalled", + "onsubmit", + "onsuspend", + "ontimeupdate", + "ontoggle", + "onunload", + "onvolumechange", + "onwaiting", + "onwheel", + "open", + "optimum", + "pattern", + "placeholder", + "poster", + "preload", + "readonly", + "rel", + "required", + "reversed", + "rows", + "rowspan", + "sandbox", + "scope", + "selected", + "shape", + "size", + "sizes", + "span", + "spellcheck", + "src", + "srcdoc", + "srclang", + "srcset", + "start", + "step", + "style", + "tabindex", + "target", + "title", + "translate", + "type", + "usemap", + "value", + "width", + "wrap", + "0", + "1", + "2", + "3", + "4", + "5", + "6", + "7", + "8", + "9", + "10", + "11", + "12", + "13", + "14", +]; diff --git a/packages/web/src/dom.rs b/packages/web/src/dom.rs index 135ad8ede..f45d6558a 100644 --- a/packages/web/src/dom.rs +++ b/packages/web/src/dom.rs @@ -80,13 +80,12 @@ impl WebsysDom { } let data = virtual_event_from_websys_event(event.clone(), target); - let _ = - event_channel.unbounded_send(UiEvent { - name, - bubbles, - element, - data, - }); + let _ = event_channel.unbounded_send(UiEvent { + name, + bubbles, + element, + data, + }); } } })); diff --git a/packages/web/src/eval.rs b/packages/web/src/eval.rs index f4da3e69b..eefece50e 100644 --- a/packages/web/src/eval.rs +++ b/packages/web/src/eval.rs @@ -62,18 +62,24 @@ impl WebEvaluator { if let Ok(stringified) = js_sys::JSON::stringify(&result) { if !stringified.is_undefined() && stringified.is_valid_utf16() { let string: String = stringified.into(); - Value::from_str(&string).map_err( - |e| EvalError::Communication(format!("Failed to parse result - {}", e)) - )? + Value::from_str(&string).map_err(|e| { + EvalError::Communication(format!("Failed to parse result - {}", e)) + })? } else { - return Err(EvalError::Communication("Failed to stringify result".into())); + return Err(EvalError::Communication( + "Failed to stringify result".into(), + )); } } else { - return Err(EvalError::Communication("Failed to stringify result".into())); + return Err(EvalError::Communication( + "Failed to stringify result".into(), + )); } } Err(err) => { - return Err(EvalError::InvalidJs(err.as_string().unwrap_or("unknown".to_string()))); + return Err(EvalError::InvalidJs( + err.as_string().unwrap_or("unknown".to_string()), + )); } }; From cbfb80d5c6f4d0b75a4328d4cd221a6f376d34c7 Mon Sep 17 00:00:00 2001 From: Pascal Date: Thu, 7 Dec 2023 17:23:14 +0100 Subject: [PATCH 316/447] fixup: improved documentation and refactored naming to be more self-explanatory Note: This is the actual correct commit. The previous one contained files touched by cargo fmt which are unrelated. Sorry for that. --- packages/desktop/src/cfg.rs | 12 +++++++----- packages/desktop/src/webview.rs | 12 ++++++++---- 2 files changed, 15 insertions(+), 9 deletions(-) diff --git a/packages/desktop/src/cfg.rs b/packages/desktop/src/cfg.rs index ba42ffa01..3b0409ae8 100644 --- a/packages/desktop/src/cfg.rs +++ b/packages/desktop/src/cfg.rs @@ -36,7 +36,7 @@ pub struct Config { pub(crate) root_name: String, pub(crate) background_color: Option<(u8, u8, u8, u8)>, pub(crate) last_window_close_behaviour: WindowCloseBehaviour, - pub(crate) disable_default_menu_bar: bool, + pub(crate) enable_default_menu_bar: bool, } type DropHandler = Box bool>; @@ -66,13 +66,15 @@ impl Config { root_name: "main".to_string(), background_color: None, last_window_close_behaviour: WindowCloseBehaviour::LastWindowExitsApp, - disable_default_menu_bar: false, + enable_default_menu_bar: true, } } - /// Set whether the default menu bar should be disabled. - pub fn with_disable_default_menu_bar(mut self, disable: bool) -> Self { - self.disable_default_menu_bar = disable; + /// Set whether the default menu bar should be enabled. + /// + /// > Note: `enable` is `true` by default. To disable the default menu bar pass `false`. + pub fn with_default_menu_bar(mut self, enable: bool) -> Self { + self.enable_default_menu_bar = enable; self } diff --git a/packages/desktop/src/webview.rs b/packages/desktop/src/webview.rs index 9beae702a..f03878242 100644 --- a/packages/desktop/src/webview.rs +++ b/packages/desktop/src/webview.rs @@ -19,8 +19,8 @@ pub fn build( let index_file = cfg.custom_index.clone(); let root_name = cfg.root_name.clone(); - if !cfg.disable_default_menu_bar { - builder = builder.with_menu(create_default_menu_bar()); + if cfg.enable_default_menu_bar { + builder = builder.with_menu(build_default_menu_bar()); } let window = builder.with_visible(false).build(event_loop).unwrap(); @@ -103,8 +103,12 @@ pub fn build( (webview.build().unwrap(), web_context) } -/// Creates a standard menu bar depending on the platform -fn create_default_menu_bar() -> MenuBar { +/// Builds a standard menu bar depending on the users platform. It may be used as a starting point +/// to further customize the menu bar and pass it to a [`WindowBuilder`](tao::window::WindowBuilder). +/// > Note: The default menu bar enables macOS shortcuts like cut/copy/paste. +/// > The menu bar differs per platform because of constraints introduced +/// > by [`MenuItem`](tao::menu::MenuItem). +pub fn build_default_menu_bar() -> MenuBar { let mut menu_bar = MenuBar::new(); // since it is uncommon on windows to have an "application menu" From a1550460ce8cda98998d074243c995955cf6557a Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Thu, 7 Dec 2023 11:37:59 -0600 Subject: [PATCH 317/447] Fix peek spelling --- packages/signals/src/signal.rs | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/packages/signals/src/signal.rs b/packages/signals/src/signal.rs index 6c4052b98..1dc4bd36e 100644 --- a/packages/signals/src/signal.rs +++ b/packages/signals/src/signal.rs @@ -203,7 +203,7 @@ impl Signal { self.inner.origin_scope() } - /// Get the current value of the signal. This will subscribe the current scope to the signal. If you would like to read the signal without subscribing to it, you can use [`Self::peak`] instead. + /// Get the current value of the signal. This will subscribe the current scope to the signal. If you would like to read the signal without subscribing to it, you can use [`Self::peek`] instead. /// /// If the signal has been dropped, this will panic. #[track_caller] @@ -237,7 +237,7 @@ impl Signal { /// Get the current value of the signal. **Unlike read, this will not subscribe the current scope to the signal which can cause parts of your UI to not update.** /// /// If the signal has been dropped, this will panic. - pub fn peak(&self) -> GenerationalRef { + pub fn peek(&self) -> GenerationalRef { let inner = self.inner.read(); GenerationalRef::map(inner, |v| &v.value) } @@ -428,7 +428,7 @@ impl ReadOnlySignal { self.inner.origin_scope() } - /// Get the current value of the signal. This will subscribe the current scope to the signal. If you would like to read the signal without subscribing to it, you can use [`Self::peak`] instead. + /// Get the current value of the signal. This will subscribe the current scope to the signal. If you would like to read the signal without subscribing to it, you can use [`Self::peek`] instead. /// /// If the signal has been dropped, this will panic. #[track_caller] @@ -439,8 +439,8 @@ impl ReadOnlySignal { /// Get the current value of the signal. **Unlike read, this will not subscribe the current scope to the signal which can cause parts of your UI to not update.** /// /// If the signal has been dropped, this will panic. - pub fn peak(&self) -> GenerationalRef { - self.inner.peak() + pub fn peek(&self) -> GenerationalRef { + self.inner.peek() } /// Run a closure with a reference to the signal's value. From 29f9d002e2b9a422c519b934124009ed1d8ffc93 Mon Sep 17 00:00:00 2001 From: Pascal Date: Thu, 7 Dec 2023 19:03:37 +0100 Subject: [PATCH 318/447] expose dioxus_desktop::build_default_menu_bar() --- packages/desktop/src/lib.rs | 1 + 1 file changed, 1 insertion(+) diff --git a/packages/desktop/src/lib.rs b/packages/desktop/src/lib.rs index 63a8914f3..4825fa5da 100644 --- a/packages/desktop/src/lib.rs +++ b/packages/desktop/src/lib.rs @@ -45,6 +45,7 @@ use tao::{ event::{Event, StartCause, WindowEvent}, event_loop::{ControlFlow, EventLoop}, }; +pub use webview::build_default_menu_bar; pub use wry; pub use wry::application as tao; use wry::webview::WebView; From fc31876a573a42ed03549c102bd15b709e60f197 Mon Sep 17 00:00:00 2001 From: Exotik850 <60969639+Exotik850@users.noreply.github.com> Date: Thu, 7 Dec 2023 12:35:16 -0600 Subject: [PATCH 319/447] Wasm target check before build (#1689) * Add `rustup show` check for wasm32 target * better place for check * fmt * clippy fmt --- packages/cli/src/builder.rs | 12 ++++++++++++ packages/cli/src/cli/build.rs | 8 ++++---- packages/core/src/diff.rs | 2 +- packages/dioxus-tui/examples/colorpicker.rs | 12 ++++++------ packages/fermi/src/lib.rs | 2 -- packages/router-macro/src/redirect.rs | 1 + packages/rsx/src/lib.rs | 2 +- .../signals/examples/split_subscriptions.rs | 18 +++++------------- packages/web/src/hot_reload.rs | 15 ++++++--------- 9 files changed, 36 insertions(+), 36 deletions(-) diff --git a/packages/cli/src/builder.rs b/packages/cli/src/builder.rs index 08e636237..f7b6a3071 100644 --- a/packages/cli/src/builder.rs +++ b/packages/cli/src/builder.rs @@ -48,6 +48,18 @@ pub fn build(config: &CrateConfig, quiet: bool) -> Result { // [1] Build the .wasm module log::info!("πŸš… Running build command..."); + + let wasm_check_command = std::process::Command::new("rustup") + .args(["show"]) + .output()?; + let wasm_check_output = String::from_utf8(wasm_check_command.stdout).unwrap(); + if !wasm_check_output.contains("wasm32-unknown-unknown") { + log::info!("wasm32-unknown-unknown target not detected, installing.."); + let _ = std::process::Command::new("rustup") + .args(["target", "add", "wasm32-unknown-unknown"]) + .output()?; + } + let cmd = subprocess::Exec::cmd("cargo"); let cmd = cmd .cwd(crate_dir) diff --git a/packages/cli/src/cli/build.rs b/packages/cli/src/cli/build.rs index 7fe29f8ce..63a2969e0 100644 --- a/packages/cli/src/cli/build.rs +++ b/packages/cli/src/cli/build.rs @@ -37,8 +37,8 @@ impl Build { .platform .unwrap_or(crate_config.dioxus_config.application.default_platform); - #[cfg(feature = "plugin")] - let _ = PluginManager::on_build_start(&crate_config, &platform); + // #[cfg(feature = "plugin")] + // let _ = PluginManager::on_build_start(&crate_config, &platform); match platform { Platform::Web => { @@ -66,8 +66,8 @@ impl Build { )?; file.write_all(temp.as_bytes())?; - #[cfg(feature = "plugin")] - let _ = PluginManager::on_build_finish(&crate_config, &platform); + // #[cfg(feature = "plugin")] + // let _ = PluginManager::on_build_finish(&crate_config, &platform); Ok(()) } diff --git a/packages/core/src/diff.rs b/packages/core/src/diff.rs index 74017db0f..2de862218 100644 --- a/packages/core/src/diff.rs +++ b/packages/core/src/diff.rs @@ -560,7 +560,7 @@ impl<'b> VirtualDom { // If none of the old keys are reused by the new children, then we remove all the remaining old children and // create the new children afresh. if shared_keys.is_empty() { - if old.get(0).is_some() { + if old.first().is_some() { self.remove_nodes(&old[1..]); self.replace(&old[0], new); } else { diff --git a/packages/dioxus-tui/examples/colorpicker.rs b/packages/dioxus-tui/examples/colorpicker.rs index 00f8ef7e0..01cc38cda 100644 --- a/packages/dioxus-tui/examples/colorpicker.rs +++ b/packages/dioxus-tui/examples/colorpicker.rs @@ -15,21 +15,21 @@ fn app(cx: Scope) -> Element { let mapping: DioxusElementToNodeId = cx.consume_context().unwrap(); // disable templates so that every node has an id and can be queried cx.render(rsx! { - div{ + div { width: "100%", background_color: "hsl({hue}, 70%, {brightness}%)", onmousemove: move |evt| { if let RenderReturn::Ready(node) = cx.root_node() { - if let Some(id) = node.root_ids.borrow().get(0).cloned() { + if let Some(id) = node.root_ids.borrow().first().cloned() { let node = tui_query.get(mapping.get_node_id(id).unwrap()); - let Size{width, height} = node.size().unwrap(); + let Size { width, height } = node.size().unwrap(); let pos = evt.inner().element_coordinates(); - hue.set((pos.x as f32/width as f32)*255.0); - brightness.set((pos.y as f32/height as f32)*100.0); + hue.set((pos.x as f32 / width as f32) * 255.0); + brightness.set((pos.y as f32 / height as f32) * 100.0); } } }, - "hsl({hue}, 70%, {brightness}%)", + "hsl({hue}, 70%, {brightness}%)" } }) } diff --git a/packages/fermi/src/lib.rs b/packages/fermi/src/lib.rs index 52bf4cd09..dc5ccf010 100644 --- a/packages/fermi/src/lib.rs +++ b/packages/fermi/src/lib.rs @@ -22,8 +22,6 @@ mod atoms { pub use atom::*; pub use atomfamily::*; pub use atomref::*; - pub use selector::*; - pub use selectorfamily::*; } pub mod hooks { diff --git a/packages/router-macro/src/redirect.rs b/packages/router-macro/src/redirect.rs index c1efb8b4d..2933bbc8e 100644 --- a/packages/router-macro/src/redirect.rs +++ b/packages/router-macro/src/redirect.rs @@ -75,6 +75,7 @@ impl Redirect { let (segments, query) = parse_route_segments( path.span(), + #[allow(clippy::map_identity)] closure_arguments.iter().map(|(name, ty)| (name, ty)), &path.value(), )?; diff --git a/packages/rsx/src/lib.rs b/packages/rsx/src/lib.rs index bdf32b272..5db6baee9 100644 --- a/packages/rsx/src/lib.rs +++ b/packages/rsx/src/lib.rs @@ -193,7 +193,7 @@ impl<'a> ToTokens for TemplateRenderer<'a> { fn to_tokens(&self, out_tokens: &mut TokenStream2) { let mut context = DynamicContext::default(); - let key = match self.roots.get(0) { + let key = match self.roots.first() { Some(BodyNode::Element(el)) if self.roots.len() == 1 => el.key.clone(), Some(BodyNode::Component(comp)) if self.roots.len() == 1 => comp.key().cloned(), _ => None, diff --git a/packages/signals/examples/split_subscriptions.rs b/packages/signals/examples/split_subscriptions.rs index 3eb60ed29..bb286b4b7 100644 --- a/packages/signals/examples/split_subscriptions.rs +++ b/packages/signals/examples/split_subscriptions.rs @@ -22,15 +22,9 @@ fn app(cx: Scope) -> Element { use_context_provider(cx, ApplicationData::default); render! { - div { - ReadsFirst {} - } - div { - ReadsSecond {} - } - div { - ReadsManySignals {} - } + div { ReadsFirst {} } + div { ReadsSecond {} } + div { ReadsManySignals {} } } } @@ -107,16 +101,14 @@ fn ReadsManySignals(cx: Scope) -> Element { } button { onclick: move |_| { - if let Some(first) = data.many_signals.read().get(0) { + if let Some(first) = data.many_signals.read().first() { *first.write() += 1; } }, "Increase First Item" } for signal in data.many_signals { - Child { - count: signal, - } + Child { count: signal } } } } diff --git a/packages/web/src/hot_reload.rs b/packages/web/src/hot_reload.rs index 6256cc935..e8b4e42e4 100644 --- a/packages/web/src/hot_reload.rs +++ b/packages/web/src/hot_reload.rs @@ -5,7 +5,6 @@ use futures_channel::mpsc::UnboundedReceiver; use dioxus_core::Template; pub(crate) fn init() -> UnboundedReceiver> { - use std::convert::TryInto; use wasm_bindgen::closure::Closure; use wasm_bindgen::JsCast; use web_sys::{MessageEvent, WebSocket}; @@ -31,14 +30,12 @@ pub(crate) fn init() -> UnboundedReceiver> { // change the rsx when new data is received let cl = Closure::wrap(Box::new(move |e: MessageEvent| { if let Ok(text) = e.data().dyn_into::() { - let text: Result = text.try_into(); - if let Ok(string) = text { - let val = serde_json::from_str::(&string).unwrap(); - // leak the value - let val: &'static serde_json::Value = Box::leak(Box::new(val)); - let template: Template<'_> = Template::deserialize(val).unwrap(); - tx.unbounded_send(template).unwrap(); - } + let string: String = text.into(); + let val = serde_json::from_str::(&string).unwrap(); + // leak the value + let val: &'static serde_json::Value = Box::leak(Box::new(val)); + let template: Template<'_> = Template::deserialize(val).unwrap(); + tx.unbounded_send(template).unwrap(); } }) as Box); From 6b7545f60a85a3add0259ecc801c03737cc9fddd Mon Sep 17 00:00:00 2001 From: Alex Parrill Date: Thu, 7 Dec 2023 17:13:50 -0500 Subject: [PATCH 320/447] Add loading attribute to img element (#1699) Useful for lazy loading: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/img#loading --- packages/html/src/elements.rs | 1 + 1 file changed, 1 insertion(+) diff --git a/packages/html/src/elements.rs b/packages/html/src/elements.rs index d7db36a04..a42c01950 100644 --- a/packages/html/src/elements.rs +++ b/packages/html/src/elements.rs @@ -827,6 +827,7 @@ builder_constructors! { decoding: ImageDecoding DEFAULT, height: usize DEFAULT, ismap: Bool DEFAULT, + loading: String DEFAULT, src: Uri DEFAULT, srcset: String DEFAULT, // FIXME this is much more complicated usemap: String DEFAULT, // FIXME should be a fragment starting with '#' From 73bd30cea4df33ab87b51b1c140c7b362de662b2 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Fri, 8 Dec 2023 08:47:47 -0600 Subject: [PATCH 321/447] add nasm setup to CI --- .github/workflows/cli_release.yml | 2 ++ .github/workflows/main.yml | 5 +++++ .github/workflows/miri.yml | 1 + .github/workflows/playwright.yml | 1 + 4 files changed, 9 insertions(+) diff --git a/.github/workflows/cli_release.yml b/.github/workflows/cli_release.yml index 4cd33f47e..544c375a2 100644 --- a/.github/workflows/cli_release.yml +++ b/.github/workflows/cli_release.yml @@ -36,6 +36,8 @@ jobs: toolchain: ${{ matrix.platform.toolchain }} targets: ${{ matrix.platform.target }} + - uses: ilammy/setup-nasm@v1 + # Setup the Github Actions Cache for the CLI package - name: Setup cache uses: Swatinem/rust-cache@v2 diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml index 037525557..b1b1b5c22 100644 --- a/.github/workflows/main.yml +++ b/.github/workflows/main.yml @@ -39,6 +39,7 @@ jobs: steps: - uses: dtolnay/rust-toolchain@stable - uses: Swatinem/rust-cache@v2 + - uses: ilammy/setup-nasm@v1 - run: sudo apt-get update - run: sudo apt install libwebkit2gtk-4.1-dev libgtk-3-dev libayatana-appindicator3-dev - uses: actions/checkout@v4 @@ -51,6 +52,7 @@ jobs: steps: - uses: dtolnay/rust-toolchain@stable - uses: Swatinem/rust-cache@v2 + - uses: ilammy/setup-nasm@v1 - run: sudo apt-get update - run: sudo apt install libwebkit2gtk-4.1-dev libgtk-3-dev libayatana-appindicator3-dev - uses: davidB/rust-cargo-make@v1 @@ -66,6 +68,7 @@ jobs: steps: - uses: dtolnay/rust-toolchain@stable - uses: Swatinem/rust-cache@v2 + - uses: ilammy/setup-nasm@v1 - run: rustup component add rustfmt - uses: actions/checkout@v4 - run: cargo fmt --all -- --check @@ -77,6 +80,7 @@ jobs: steps: - uses: dtolnay/rust-toolchain@stable - uses: Swatinem/rust-cache@v2 + - uses: ilammy/setup-nasm@v1 - run: sudo apt-get update - run: sudo apt install libwebkit2gtk-4.1-dev libgtk-3-dev libayatana-appindicator3-dev - run: rustup component add clippy @@ -125,6 +129,7 @@ jobs: steps: - uses: actions/checkout@v4 + - uses: ilammy/setup-nasm@v1 - name: install stable uses: dtolnay/rust-toolchain@master diff --git a/.github/workflows/miri.yml b/.github/workflows/miri.yml index 4a467b9b2..c6974f03f 100644 --- a/.github/workflows/miri.yml +++ b/.github/workflows/miri.yml @@ -70,6 +70,7 @@ jobs: run: echo "MIRIFLAGS=-Zmiri-tag-gc=1" >> $GITHUB_ENV - uses: actions/checkout@v4 + - uses: ilammy/setup-nasm@v1 - name: Install Rust ${{ env.rust_nightly }} uses: dtolnay/rust-toolchain@master with: diff --git a/.github/workflows/playwright.yml b/.github/workflows/playwright.yml index 500d41564..25e26f9a7 100644 --- a/.github/workflows/playwright.yml +++ b/.github/workflows/playwright.yml @@ -20,6 +20,7 @@ jobs: steps: # Do our best to cache the toolchain and node install steps - uses: actions/checkout@v4 + - uses: ilammy/setup-nasm@v1 - uses: actions/setup-node@v3 with: node-version: 16 From 8984482b631e623ea5c022496c9e030db13f50f0 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Fri, 8 Dec 2023 15:14:32 -0600 Subject: [PATCH 322/447] fix headless windows --- packages/desktop/build.rs | 14 ++++++++++---- packages/desktop/headless_tests/events.rs | 2 +- packages/desktop/src/protocol.rs | 9 +++++---- packages/desktop/src/webview.rs | 2 ++ 4 files changed, 18 insertions(+), 9 deletions(-) diff --git a/packages/desktop/build.rs b/packages/desktop/build.rs index f114ae084..8d1f4b3e5 100644 --- a/packages/desktop/build.rs +++ b/packages/desktop/build.rs @@ -51,15 +51,21 @@ fn main() { }"#; let polling_request = format!( r#"// Poll for requests - window.interpreter.wait_for_request = () => {{ + window.interpreter.wait_for_request = (headless) => {{ fetch(new Request("{EDITS_PATH}")) .then(response => {{ response.arrayBuffer() .then(bytes => {{ - requestAnimationFrame(() => {{ + // In headless mode, the requestAnimationFrame callback is never called, so we need to run the bytes directly + if (headless) {{ run_from_bytes(bytes); - }}); - window.interpreter.wait_for_request(); + }} + else {{ + requestAnimationFrame(() => {{ + run_from_bytes(bytes); + }}); + }} + window.interpreter.wait_for_request(headless); }}); }}) }}"# diff --git a/packages/desktop/headless_tests/events.rs b/packages/desktop/headless_tests/events.rs index bb3b46206..646b951e1 100644 --- a/packages/desktop/headless_tests/events.rs +++ b/packages/desktop/headless_tests/events.rs @@ -17,7 +17,7 @@ pub(crate) fn check_app_exits(app: Component) { dioxus_desktop::launch_cfg( app, - Config::new().with_window(WindowBuilder::new().with_visible(true)), + Config::new().with_window(WindowBuilder::new().with_visible(false)), ); // Stop deadman's switch diff --git a/packages/desktop/src/protocol.rs b/packages/desktop/src/protocol.rs index 1dca21759..8184821ba 100644 --- a/packages/desktop/src/protocol.rs +++ b/packages/desktop/src/protocol.rs @@ -12,7 +12,7 @@ use crate::desktop_context::EditQueue; static MINIFIED: &str = include_str!("./minified.js"); -fn module_loader(root_name: &str) -> String { +fn module_loader(root_name: &str, headless: bool) -> String { format!( r#" "# @@ -39,6 +39,7 @@ pub(super) fn desktop_handler( custom_index: Option, root_name: &str, edit_queue: &EditQueue, + headless: bool, ) { // If the request is for the root, we'll serve the index.html file. if request.uri().path() == "/" { @@ -46,7 +47,7 @@ pub(super) fn desktop_handler( // we'll look for the closing tag and insert our little module loader there. let body = match custom_index { Some(custom_index) => custom_index - .replace("", &format!("{}", module_loader(root_name))) + .replace("", &format!("{}", module_loader(root_name, headless))) .into_bytes(), None => { @@ -58,7 +59,7 @@ pub(super) fn desktop_handler( } template - .replace("", &module_loader(root_name)) + .replace("", &module_loader(root_name, headless)) .into_bytes() } }; diff --git a/packages/desktop/src/webview.rs b/packages/desktop/src/webview.rs index 426cc8706..d921a880f 100644 --- a/packages/desktop/src/webview.rs +++ b/packages/desktop/src/webview.rs @@ -33,6 +33,7 @@ pub(crate) fn build( let mut web_context = WebContext::new(cfg.data_dir.clone()); let edit_queue = EditQueue::default(); + let headless = !cfg.window.window.visible; let mut webview = WebViewBuilder::new(window) .unwrap() @@ -55,6 +56,7 @@ pub(crate) fn build( index_file.clone(), &root_name, &edit_queue, + headless ) } }) From 972235bd6fba872c72a236e21fd4f5b855434d8f Mon Sep 17 00:00:00 2001 From: Benjamin Manns Date: Sun, 10 Dec 2023 13:16:59 -0500 Subject: [PATCH 323/447] Fix doc tests by adding formatting to CLI README (#1706) The README for cli gets included in lib.rs via `include_str!`. The code snippets then get assumed to be Rust, which fails if running `cargo test --doc`. This is not a huge problem, but was brought to my attention because Nix's `buildRustPackage` runs `cargo test` including doc tests (unlike what get run for this project on CI). This means I can't update the Nix package to 0.4.3 without changing the test flags (which I think I'll see about doing anyways, as that's how Dioxus runs CI). --- packages/cli/README.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/packages/cli/README.md b/packages/cli/README.md index 8379f22cc..2325d6784 100644 --- a/packages/cli/README.md +++ b/packages/cli/README.md @@ -10,7 +10,7 @@ It handles building, bundling, development and publishing to simplify developmen ### Install the stable version (recommended) -``` +```shell cargo install dioxus-cli ``` @@ -20,7 +20,7 @@ To get the latest bug fixes and features, you can install the development versio However, this is not fully tested. That means you're probably going to have more bugs despite having the latest bug fixes. -``` +```shell cargo install --git https://github.com/DioxusLabs/dioxus dioxus-cli ``` @@ -29,7 +29,7 @@ and install it in Cargo's global binary directory (`~/.cargo/bin/` by default). ### Install from local folder -``` +```shell cargo install --path . --debug ``` @@ -40,7 +40,7 @@ It will be cloned from the [dioxus-template](https://github.com/DioxusLabs/dioxu Alternatively, you can specify the template path: -``` +```shell dx create hello --template gh:dioxuslabs/dioxus-template ``` From 695bf009d11be0a8b717257ab2d56adf8873c489 Mon Sep 17 00:00:00 2001 From: YuKun Liu Date: Mon, 11 Dec 2023 11:27:55 -0800 Subject: [PATCH 324/447] fix: dx create not work (#1709) --- packages/cli/src/main.rs | 29 ++++++++++++++++------------- 1 file changed, 16 insertions(+), 13 deletions(-) diff --git a/packages/cli/src/main.rs b/packages/cli/src/main.rs index 7ca1b2c9a..2358551f2 100644 --- a/packages/cli/src/main.rs +++ b/packages/cli/src/main.rs @@ -42,34 +42,36 @@ async fn main() -> anyhow::Result<()> { set_up_logging(); - let bin = get_bin(args.bin)?; + let bin = get_bin(args.bin); - let _dioxus_config = DioxusConfig::load(Some(bin.clone())) + if let Ok(bin) = &bin { + let _dioxus_config = DioxusConfig::load(Some(bin.clone())) .map_err(|e| anyhow!("Failed to load Dioxus config because: {e}"))? .unwrap_or_else(|| { log::warn!("You appear to be creating a Dioxus project from scratch; we will use the default config"); DioxusConfig::default() }); - #[cfg(feature = "plugin")] - PluginManager::init(_dioxus_config.plugin) - .map_err(|e| anyhow!("🚫 Plugin system initialization failed: {e}"))?; + #[cfg(feature = "plugin")] + PluginManager::init(_dioxus_config.plugin) + .map_err(|e| anyhow!("🚫 Plugin system initialization failed: {e}"))?; + } match args.action { Translate(opts) => opts .translate() .map_err(|e| anyhow!("🚫 Translation of HTML into RSX failed: {}", e)), - Build(opts) => opts - .build(Some(bin.clone())) + Build(opts) if bin.is_ok() => opts + .build(Some(bin.unwrap().clone())) .map_err(|e| anyhow!("🚫 Building project failed: {}", e)), - Clean(opts) => opts - .clean(Some(bin.clone())) + Clean(opts) if bin.is_ok() => opts + .clean(Some(bin.unwrap().clone())) .map_err(|e| anyhow!("🚫 Cleaning project failed: {}", e)), - Serve(opts) => opts - .serve(Some(bin.clone())) + Serve(opts) if bin.is_ok() => opts + .serve(Some(bin.unwrap().clone())) .await .map_err(|e| anyhow!("🚫 Serving project failed: {}", e)), @@ -81,8 +83,8 @@ async fn main() -> anyhow::Result<()> { .config() .map_err(|e| anyhow!("🚫 Configuring new project failed: {}", e)), - Bundle(opts) => opts - .bundle(Some(bin.clone())) + Bundle(opts) if bin.is_ok() => opts + .bundle(Some(bin.unwrap().clone())) .map_err(|e| anyhow!("🚫 Bundling project failed: {}", e)), #[cfg(feature = "plugin")] @@ -107,5 +109,6 @@ async fn main() -> anyhow::Result<()> { Ok(()) } + _ => Err(anyhow::anyhow!(bin.unwrap_err())), } } From 3afb3131106506ae0cf42cb384dfb813912bc9e2 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Mon, 11 Dec 2023 14:00:45 -0600 Subject: [PATCH 325/447] fix formatting --- packages/desktop/src/protocol.rs | 10 ++++++++-- packages/desktop/src/webview.rs | 2 +- 2 files changed, 9 insertions(+), 3 deletions(-) diff --git a/packages/desktop/src/protocol.rs b/packages/desktop/src/protocol.rs index 8184821ba..d8ed0478c 100644 --- a/packages/desktop/src/protocol.rs +++ b/packages/desktop/src/protocol.rs @@ -47,7 +47,10 @@ pub(super) fn desktop_handler( // we'll look for the closing tag and insert our little module loader there. let body = match custom_index { Some(custom_index) => custom_index - .replace("", &format!("{}", module_loader(root_name, headless))) + .replace( + "", + &format!("{}", module_loader(root_name, headless)), + ) .into_bytes(), None => { @@ -59,7 +62,10 @@ pub(super) fn desktop_handler( } template - .replace("", &module_loader(root_name, headless)) + .replace( + "", + &module_loader(root_name, headless), + ) .into_bytes() } }; diff --git a/packages/desktop/src/webview.rs b/packages/desktop/src/webview.rs index d921a880f..216c7a1a8 100644 --- a/packages/desktop/src/webview.rs +++ b/packages/desktop/src/webview.rs @@ -56,7 +56,7 @@ pub(crate) fn build( index_file.clone(), &root_name, &edit_queue, - headless + headless, ) } }) From 69ca1fd8a702fdc596411cea5d865f38b946affd Mon Sep 17 00:00:00 2001 From: "kidkool850@gmail.com" Date: Mon, 11 Dec 2023 16:01:40 -0600 Subject: [PATCH 326/447] Make cx.spawn() return an Option, returns None if finished immediately --- examples/compose.rs | 11 +++-------- packages/core/src/scheduler/task.rs | 19 ++++++++++++++----- packages/core/src/scope_context.rs | 16 ++++++++-------- packages/core/src/scopes.rs | 4 ++-- packages/fullstack/src/hooks/server_future.rs | 4 ++-- packages/hooks/src/use_coroutine.rs | 10 ++++------ packages/hooks/src/use_effect.rs | 7 +++---- packages/hooks/src/use_future.rs | 4 ++-- 8 files changed, 38 insertions(+), 37 deletions(-) diff --git a/examples/compose.rs b/examples/compose.rs index 3ee6d36ae..4206383d3 100644 --- a/examples/compose.rs +++ b/examples/compose.rs @@ -19,7 +19,8 @@ fn app(cx: Scope) -> Element { emails_sent.write().push(message); } } - }); + }) + .unwrap(); cx.render(rsx! { div { @@ -27,13 +28,7 @@ fn app(cx: Scope) -> Element { button { onclick: move |_| { - let dom = VirtualDom::new_with_props(compose, ComposeProps { - app_tx: tx.clone() - }); - - // this returns a weak reference to the other window - // Be careful not to keep a strong reference to the other window or it will never be dropped - // and the window will never close. + let dom = VirtualDom::new_with_props(compose, ComposeProps { app_tx: tx.clone() }); window.new_window(dom, Default::default()); }, "Click to compose a new email" diff --git a/packages/core/src/scheduler/task.rs b/packages/core/src/scheduler/task.rs index fc668b364..7f6ae8021 100644 --- a/packages/core/src/scheduler/task.rs +++ b/packages/core/src/scheduler/task.rs @@ -19,7 +19,7 @@ pub struct TaskId(pub usize); /// the task itself is the waker pub(crate) struct LocalTask { pub scope: ScopeId, - pub(super) task: RefCell + 'static>>>, + pub task: RefCell + 'static>>>, pub waker: Waker, } @@ -33,7 +33,11 @@ impl Scheduler { /// /// Spawning a future onto the root scope will cause it to be dropped when the root component is dropped - which /// will only occur when the VirtuaalDom itself has been dropped. - pub fn spawn(&self, scope: ScopeId, task: impl Future + 'static) -> TaskId { + pub fn spawn( + &self, + scope: ScopeId, + task: impl Future + 'static, + ) -> Option { let mut tasks = self.tasks.borrow_mut(); let entry = tasks.vacant_entry(); @@ -48,20 +52,25 @@ impl Scheduler { })), }; + let mut cx = std::task::Context::from_waker(&task.waker); + if task.task.borrow_mut().as_mut().poll(&mut cx).is_ready() { + return None; + } + entry.insert(task); self.sender .unbounded_send(SchedulerMsg::TaskNotified(task_id)) .expect("Scheduler should exist"); - task_id + Some(task_id) } /// Drop the future with the given TaskId /// /// This does not abort the task, so you'll want to wrap it in an aborthandle if that's important to you - pub fn remove(&self, id: TaskId) { - self.tasks.borrow_mut().try_remove(id.0); + pub fn remove(&self, id: TaskId) -> Option { + self.tasks.borrow_mut().try_remove(id.0) } } diff --git a/packages/core/src/scope_context.rs b/packages/core/src/scope_context.rs index 59bed3b1f..45df068f4 100644 --- a/packages/core/src/scope_context.rs +++ b/packages/core/src/scope_context.rs @@ -214,10 +214,10 @@ impl ScopeContext { } /// Pushes the future onto the poll queue to be polled after the component renders. - pub fn push_future(&self, fut: impl Future + 'static) -> TaskId { - let id = self.tasks.spawn(self.id, fut); + pub fn push_future(&self, fut: impl Future + 'static) -> Option { + let id = self.tasks.spawn(self.id, fut)?; self.spawned_tasks.borrow_mut().insert(id); - id + Some(id) } /// Spawns the future but does not return the [`TaskId`] @@ -228,9 +228,9 @@ impl ScopeContext { /// Spawn a future that Dioxus won't clean up when this component is unmounted /// /// This is good for tasks that need to be run after the component has been dropped. - pub fn spawn_forever(&self, fut: impl Future + 'static) -> TaskId { + pub fn spawn_forever(&self, fut: impl Future + 'static) -> Option { // The root scope will never be unmounted so we can just add the task at the top of the app - let id = self.tasks.spawn(ScopeId::ROOT, fut); + let id = self.tasks.spawn(ScopeId::ROOT, fut)?; // wake up the scheduler if it is sleeping self.tasks @@ -240,7 +240,7 @@ impl ScopeContext { self.spawned_tasks.borrow_mut().insert(id); - id + Some(id) } /// Informs the scheduler that this task is no longer needed and should be removed. @@ -339,7 +339,7 @@ pub fn throw(error: impl Debug + 'static) -> Option<()> { /// Pushes the future onto the poll queue to be polled after the component renders. pub fn push_future(fut: impl Future + 'static) -> Option { - with_current_scope(|cx| cx.push_future(fut)) + with_current_scope(|cx| cx.push_future(fut)).flatten() } /// Spawns the future but does not return the [`TaskId`] @@ -351,7 +351,7 @@ pub fn spawn(fut: impl Future + 'static) { /// /// This is good for tasks that need to be run after the component has been dropped. pub fn spawn_forever(fut: impl Future + 'static) -> Option { - with_current_scope(|cx| cx.spawn_forever(fut)) + with_current_scope(|cx| cx.spawn_forever(fut)).flatten() } /// Informs the scheduler that this task is no longer needed and should be removed. diff --git a/packages/core/src/scopes.rs b/packages/core/src/scopes.rs index f0bbd776c..463217370 100644 --- a/packages/core/src/scopes.rs +++ b/packages/core/src/scopes.rs @@ -309,7 +309,7 @@ impl<'src> ScopeState { } /// Pushes the future onto the poll queue to be polled after the component renders. - pub fn push_future(&self, fut: impl Future + 'static) -> TaskId { + pub fn push_future(&self, fut: impl Future + 'static) -> Option { self.context().push_future(fut) } @@ -321,7 +321,7 @@ impl<'src> ScopeState { /// Spawn a future that Dioxus won't clean up when this component is unmounted /// /// This is good for tasks that need to be run after the component has been dropped. - pub fn spawn_forever(&self, fut: impl Future + 'static) -> TaskId { + pub fn spawn_forever(&self, fut: impl Future + 'static) -> Option { self.context().spawn_forever(fut) } diff --git a/packages/fullstack/src/hooks/server_future.rs b/packages/fullstack/src/hooks/server_future.rs index f8eaef963..8d9f09f71 100644 --- a/packages/fullstack/src/hooks/server_future.rs +++ b/packages/fullstack/src/hooks/server_future.rs @@ -76,7 +76,7 @@ where cx.remove_future(current); } - state.task.set(Some(cx.push_future(async move { + state.task.set(cx.push_future(async move { let data; #[cfg(feature = "ssr")] { @@ -94,7 +94,7 @@ where *value.borrow_mut() = Some(Box::new(data)); schedule_update(); - }))); + })); } if first_run { diff --git a/packages/hooks/src/use_coroutine.rs b/packages/hooks/src/use_coroutine.rs index f2577b90c..6de43a667 100644 --- a/packages/hooks/src/use_coroutine.rs +++ b/packages/hooks/src/use_coroutine.rs @@ -63,17 +63,15 @@ use std::future::Future; /// } /// }) /// ``` -pub fn use_coroutine(cx: &ScopeState, init: G) -> &Coroutine +pub fn use_coroutine(cx: &ScopeState, init: G) -> Option<&Coroutine> where M: 'static, G: FnOnce(UnboundedReceiver) -> F, F: Future + 'static, { - cx.use_hook(|| { - let (tx, rx) = futures_channel::mpsc::unbounded(); - let task = cx.push_future(init(rx)); - cx.provide_context(Coroutine { tx, task }) - }) + let (tx, rx) = futures_channel::mpsc::unbounded(); + let task = cx.push_future(init(rx))?; + Some(cx.use_hook(|| cx.provide_context(Coroutine { tx, task }))) } /// Get a handle to a coroutine higher in the tree diff --git a/packages/hooks/src/use_effect.rs b/packages/hooks/src/use_effect.rs index 6fb2fcf9e..49d8c6dd4 100644 --- a/packages/hooks/src/use_effect.rs +++ b/packages/hooks/src/use_effect.rs @@ -117,7 +117,7 @@ where T: Future + 'static, { fn apply(self, _: UseEffectCleanup, cx: &ScopeState) -> Option { - Some(cx.push_future(self)) + cx.push_future(self) } } @@ -129,11 +129,10 @@ where F: FnOnce() + 'static, { fn apply(self, oncleanup: UseEffectCleanup, cx: &ScopeState) -> Option { - let task = cx.push_future(async move { + cx.push_future(async move { let cleanup = self.await; *oncleanup.borrow_mut() = Some(Box::new(cleanup) as Box); - }); - Some(task) + }) } } diff --git a/packages/hooks/src/use_future.rs b/packages/hooks/src/use_future.rs index b9aa20c31..d3fdac1bc 100644 --- a/packages/hooks/src/use_future.rs +++ b/packages/hooks/src/use_future.rs @@ -49,10 +49,10 @@ where let val = val.clone(); let task = state.task.clone(); - state.task.set(Some(cx.push_future(async move { + state.task.set(cx.push_future(async move { val.set(Some(fut.await)); task.take(); - }))); + })); // Mark that we don't need to regenerate state.needs_regen.set(false); From fdce7bbe5ae5e081a49be94b0e95e2f2405bb96a Mon Sep 17 00:00:00 2001 From: Exotik850 Date: Tue, 12 Dec 2023 13:02:35 -0600 Subject: [PATCH 327/447] Return to just `TaskId`, still polling --- examples/compose.rs | 3 +-- packages/core/src/scheduler/task.rs | 12 +++--------- packages/core/src/scope_context.rs | 16 ++++++++-------- packages/core/src/scopes.rs | 4 ++-- packages/fullstack/src/hooks/server_future.rs | 4 ++-- packages/hooks/src/use_coroutine.rs | 6 +++--- packages/hooks/src/use_effect.rs | 11 +++++------ packages/hooks/src/use_future.rs | 4 ++-- 8 files changed, 26 insertions(+), 34 deletions(-) diff --git a/examples/compose.rs b/examples/compose.rs index 4206383d3..4b6a7450c 100644 --- a/examples/compose.rs +++ b/examples/compose.rs @@ -19,8 +19,7 @@ fn app(cx: Scope) -> Element { emails_sent.write().push(message); } } - }) - .unwrap(); + }); cx.render(rsx! { div { diff --git a/packages/core/src/scheduler/task.rs b/packages/core/src/scheduler/task.rs index 7f6ae8021..bf1075688 100644 --- a/packages/core/src/scheduler/task.rs +++ b/packages/core/src/scheduler/task.rs @@ -33,11 +33,7 @@ impl Scheduler { /// /// Spawning a future onto the root scope will cause it to be dropped when the root component is dropped - which /// will only occur when the VirtuaalDom itself has been dropped. - pub fn spawn( - &self, - scope: ScopeId, - task: impl Future + 'static, - ) -> Option { + pub fn spawn(&self, scope: ScopeId, task: impl Future + 'static) -> TaskId { let mut tasks = self.tasks.borrow_mut(); let entry = tasks.vacant_entry(); @@ -53,9 +49,7 @@ impl Scheduler { }; let mut cx = std::task::Context::from_waker(&task.waker); - if task.task.borrow_mut().as_mut().poll(&mut cx).is_ready() { - return None; - } + let _ = task.task.borrow_mut().as_mut().poll(&mut cx); entry.insert(task); @@ -63,7 +57,7 @@ impl Scheduler { .unbounded_send(SchedulerMsg::TaskNotified(task_id)) .expect("Scheduler should exist"); - Some(task_id) + task_id } /// Drop the future with the given TaskId diff --git a/packages/core/src/scope_context.rs b/packages/core/src/scope_context.rs index 45df068f4..59bed3b1f 100644 --- a/packages/core/src/scope_context.rs +++ b/packages/core/src/scope_context.rs @@ -214,10 +214,10 @@ impl ScopeContext { } /// Pushes the future onto the poll queue to be polled after the component renders. - pub fn push_future(&self, fut: impl Future + 'static) -> Option { - let id = self.tasks.spawn(self.id, fut)?; + pub fn push_future(&self, fut: impl Future + 'static) -> TaskId { + let id = self.tasks.spawn(self.id, fut); self.spawned_tasks.borrow_mut().insert(id); - Some(id) + id } /// Spawns the future but does not return the [`TaskId`] @@ -228,9 +228,9 @@ impl ScopeContext { /// Spawn a future that Dioxus won't clean up when this component is unmounted /// /// This is good for tasks that need to be run after the component has been dropped. - pub fn spawn_forever(&self, fut: impl Future + 'static) -> Option { + pub fn spawn_forever(&self, fut: impl Future + 'static) -> TaskId { // The root scope will never be unmounted so we can just add the task at the top of the app - let id = self.tasks.spawn(ScopeId::ROOT, fut)?; + let id = self.tasks.spawn(ScopeId::ROOT, fut); // wake up the scheduler if it is sleeping self.tasks @@ -240,7 +240,7 @@ impl ScopeContext { self.spawned_tasks.borrow_mut().insert(id); - Some(id) + id } /// Informs the scheduler that this task is no longer needed and should be removed. @@ -339,7 +339,7 @@ pub fn throw(error: impl Debug + 'static) -> Option<()> { /// Pushes the future onto the poll queue to be polled after the component renders. pub fn push_future(fut: impl Future + 'static) -> Option { - with_current_scope(|cx| cx.push_future(fut)).flatten() + with_current_scope(|cx| cx.push_future(fut)) } /// Spawns the future but does not return the [`TaskId`] @@ -351,7 +351,7 @@ pub fn spawn(fut: impl Future + 'static) { /// /// This is good for tasks that need to be run after the component has been dropped. pub fn spawn_forever(fut: impl Future + 'static) -> Option { - with_current_scope(|cx| cx.spawn_forever(fut)).flatten() + with_current_scope(|cx| cx.spawn_forever(fut)) } /// Informs the scheduler that this task is no longer needed and should be removed. diff --git a/packages/core/src/scopes.rs b/packages/core/src/scopes.rs index 463217370..f0bbd776c 100644 --- a/packages/core/src/scopes.rs +++ b/packages/core/src/scopes.rs @@ -309,7 +309,7 @@ impl<'src> ScopeState { } /// Pushes the future onto the poll queue to be polled after the component renders. - pub fn push_future(&self, fut: impl Future + 'static) -> Option { + pub fn push_future(&self, fut: impl Future + 'static) -> TaskId { self.context().push_future(fut) } @@ -321,7 +321,7 @@ impl<'src> ScopeState { /// Spawn a future that Dioxus won't clean up when this component is unmounted /// /// This is good for tasks that need to be run after the component has been dropped. - pub fn spawn_forever(&self, fut: impl Future + 'static) -> Option { + pub fn spawn_forever(&self, fut: impl Future + 'static) -> TaskId { self.context().spawn_forever(fut) } diff --git a/packages/fullstack/src/hooks/server_future.rs b/packages/fullstack/src/hooks/server_future.rs index 8d9f09f71..f8eaef963 100644 --- a/packages/fullstack/src/hooks/server_future.rs +++ b/packages/fullstack/src/hooks/server_future.rs @@ -76,7 +76,7 @@ where cx.remove_future(current); } - state.task.set(cx.push_future(async move { + state.task.set(Some(cx.push_future(async move { let data; #[cfg(feature = "ssr")] { @@ -94,7 +94,7 @@ where *value.borrow_mut() = Some(Box::new(data)); schedule_update(); - })); + }))); } if first_run { diff --git a/packages/hooks/src/use_coroutine.rs b/packages/hooks/src/use_coroutine.rs index 6de43a667..8d2212162 100644 --- a/packages/hooks/src/use_coroutine.rs +++ b/packages/hooks/src/use_coroutine.rs @@ -63,15 +63,15 @@ use std::future::Future; /// } /// }) /// ``` -pub fn use_coroutine(cx: &ScopeState, init: G) -> Option<&Coroutine> +pub fn use_coroutine(cx: &ScopeState, init: G) -> &Coroutine where M: 'static, G: FnOnce(UnboundedReceiver) -> F, F: Future + 'static, { let (tx, rx) = futures_channel::mpsc::unbounded(); - let task = cx.push_future(init(rx))?; - Some(cx.use_hook(|| cx.provide_context(Coroutine { tx, task }))) + let task = cx.push_future(init(rx)); + cx.use_hook(|| cx.provide_context(Coroutine { tx, task })) } /// Get a handle to a coroutine higher in the tree diff --git a/packages/hooks/src/use_effect.rs b/packages/hooks/src/use_effect.rs index 49d8c6dd4..72744e8ae 100644 --- a/packages/hooks/src/use_effect.rs +++ b/packages/hooks/src/use_effect.rs @@ -99,9 +99,8 @@ where // Create the new future let return_value = future(dependencies.out()); - if let Some(task) = return_value.apply(state.cleanup.clone(), cx) { - state.task.set(Some(task)); - } + let task = return_value.apply(state.cleanup.clone(), cx); + state.task.set(Some(task)); } } @@ -109,14 +108,14 @@ type UseEffectCleanup = Rc>>>; /// Something that can be returned from a `use_effect` hook. pub trait UseEffectReturn { - fn apply(self, oncleanup: UseEffectCleanup, cx: &ScopeState) -> Option; + fn apply(self, oncleanup: UseEffectCleanup, cx: &ScopeState) -> TaskId; } impl UseEffectReturn<()> for T where T: Future + 'static, { - fn apply(self, _: UseEffectCleanup, cx: &ScopeState) -> Option { + fn apply(self, _: UseEffectCleanup, cx: &ScopeState) -> TaskId { cx.push_future(self) } } @@ -128,7 +127,7 @@ where T: Future + 'static, F: FnOnce() + 'static, { - fn apply(self, oncleanup: UseEffectCleanup, cx: &ScopeState) -> Option { + fn apply(self, oncleanup: UseEffectCleanup, cx: &ScopeState) -> TaskId { cx.push_future(async move { let cleanup = self.await; *oncleanup.borrow_mut() = Some(Box::new(cleanup) as Box); diff --git a/packages/hooks/src/use_future.rs b/packages/hooks/src/use_future.rs index d3fdac1bc..b9aa20c31 100644 --- a/packages/hooks/src/use_future.rs +++ b/packages/hooks/src/use_future.rs @@ -49,10 +49,10 @@ where let val = val.clone(); let task = state.task.clone(); - state.task.set(cx.push_future(async move { + state.task.set(Some(cx.push_future(async move { val.set(Some(fut.await)); task.take(); - })); + }))); // Mark that we don't need to regenerate state.needs_regen.set(false); From 493b0693c5be8429f98f93bc30bc98f96568bc2c Mon Sep 17 00:00:00 2001 From: Exotik850 Date: Tue, 12 Dec 2023 13:15:41 -0600 Subject: [PATCH 328/447] Put channels back in hook --- packages/hooks/src/use_coroutine.rs | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/packages/hooks/src/use_coroutine.rs b/packages/hooks/src/use_coroutine.rs index 8d2212162..f2577b90c 100644 --- a/packages/hooks/src/use_coroutine.rs +++ b/packages/hooks/src/use_coroutine.rs @@ -69,9 +69,11 @@ where G: FnOnce(UnboundedReceiver) -> F, F: Future + 'static, { - let (tx, rx) = futures_channel::mpsc::unbounded(); - let task = cx.push_future(init(rx)); - cx.use_hook(|| cx.provide_context(Coroutine { tx, task })) + cx.use_hook(|| { + let (tx, rx) = futures_channel::mpsc::unbounded(); + let task = cx.push_future(init(rx)); + cx.provide_context(Coroutine { tx, task }) + }) } /// Get a handle to a coroutine higher in the tree From 0cb13942daffa8aa69a9a61aaa7982ea165d586f Mon Sep 17 00:00:00 2001 From: xfalcon Date: Wed, 13 Dec 2023 22:30:40 +0800 Subject: [PATCH 329/447] fix: command error with dx build --verbose (#1715) error msg: cannot set both --verbose and --quiet --- packages/cli/src/builder.rs | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/packages/cli/src/builder.rs b/packages/cli/src/builder.rs index f7b6a3071..759be7dec 100644 --- a/packages/cli/src/builder.rs +++ b/packages/cli/src/builder.rs @@ -265,7 +265,6 @@ pub fn build_desktop(config: &CrateConfig, _is_serve: bool) -> Result Result Date: Wed, 13 Dec 2023 09:44:01 -0600 Subject: [PATCH 330/447] Autoformat ignores files in `.gitignore` (#1704) * Make autofmt ignore gitignored files * don't panic if it can't get the git ignore files * replace some with ok * Filter rs files from gitignore * fmt * remove early return * only ignore paths that start with target --------- Co-authored-by: Evan Almloff --- packages/cli/Cargo.toml | 1 + packages/cli/src/cli/autoformat.rs | 175 ++++++++++++++++------------- 2 files changed, 96 insertions(+), 80 deletions(-) diff --git a/packages/cli/Cargo.toml b/packages/cli/Cargo.toml index 128133602..4c115184e 100644 --- a/packages/cli/Cargo.toml +++ b/packages/cli/Cargo.toml @@ -83,6 +83,7 @@ dioxus-html = { workspace = true, features = ["hot-reload-context"] } dioxus-core = { workspace = true, features = ["serialize"] } dioxus-hot-reload = { workspace = true } interprocess-docfix = { version = "1.2.2" } +gitignore = "1.0.8" [features] default = [] diff --git a/packages/cli/src/cli/autoformat.rs b/packages/cli/src/cli/autoformat.rs index 6c1ce04a1..812a4c325 100644 --- a/packages/cli/src/cli/autoformat.rs +++ b/packages/cli/src/cli/autoformat.rs @@ -27,15 +27,17 @@ pub struct Autoformat { impl Autoformat { // Todo: autoformat the entire crate pub async fn autoformat(self) -> Result<()> { + let Autoformat { check, raw, file } = self; + // Default to formatting the project - if self.raw.is_none() && self.file.is_none() { - if let Err(e) = autoformat_project(self.check).await { + if raw.is_none() && file.is_none() { + if let Err(e) = autoformat_project(check).await { eprintln!("error formatting project: {}", e); exit(1); } } - if let Some(raw) = self.raw { + if let Some(raw) = raw { let indent = indentation_for(".")?; if let Some(inner) = dioxus_autofmt::fmt_block(&raw, 0, indent) { println!("{}", inner); @@ -47,47 +49,90 @@ impl Autoformat { } // Format single file - if let Some(file) = self.file { - let file_content; - let indent; - if file == "-" { - indent = indentation_for(".")?; - let mut contents = String::new(); - std::io::stdin().read_to_string(&mut contents)?; - file_content = Ok(contents); - } else { - indent = indentation_for(".")?; - file_content = fs::read_to_string(&file); - }; - - match file_content { - Ok(s) => { - let edits = dioxus_autofmt::fmt_file(&s, indent); - let out = dioxus_autofmt::apply_formats(&s, edits); - if file == "-" { - print!("{}", out); - } else { - match fs::write(&file, out) { - Ok(_) => { - println!("formatted {}", file); - } - Err(e) => { - eprintln!("failed to write formatted content to file: {}", e); - } - } - } - } - Err(e) => { - eprintln!("failed to open file: {}", e); - exit(1); - } - } + if let Some(file) = file { + refactor_file(file)?; } Ok(()) } } +fn refactor_file(file: String) -> Result<(), Error> { + let indent = indentation_for(".")?; + let file_content = if file == "-" { + let mut contents = String::new(); + std::io::stdin().read_to_string(&mut contents)?; + Ok(contents) + } else { + fs::read_to_string(&file) + }; + let Ok(s) = file_content else { + eprintln!("failed to open file: {}", file_content.unwrap_err()); + exit(1); + }; + let edits = dioxus_autofmt::fmt_file(&s, indent); + let out = dioxus_autofmt::apply_formats(&s, edits); + + if file == "-" { + print!("{}", out); + } else if let Err(e) = fs::write(&file, out) { + eprintln!("failed to write formatted content to file: {e}",); + } else { + println!("formatted {}", file); + } + + Ok(()) +} + +fn get_project_files(config: &CrateConfig) -> Vec { + let mut files = vec![]; + + let gitignore_path = config.crate_dir.join(".gitignore"); + if gitignore_path.is_file() { + let gitigno = gitignore::File::new(gitignore_path.as_path()).unwrap(); + if let Ok(git_files) = gitigno.included_files() { + let git_files = git_files + .into_iter() + .filter(|f| f.ends_with(".rs") && !is_target_dir(f)); + files.extend(git_files) + }; + } else { + collect_rs_files(&config.crate_dir, &mut files); + } + + files +} + +fn is_target_dir(file: &Path) -> bool { + let stripped = if let Ok(cwd) = std::env::current_dir() { + file.strip_prefix(cwd).unwrap_or(file) + } else { + file + }; + if let Some(first) = stripped.components().next() { + first.as_os_str() == "target" + } else { + false + } +} + +async fn format_file( + path: impl AsRef, + indent: IndentOptions, +) -> Result { + let contents = tokio::fs::read_to_string(&path).await?; + + let edits = dioxus_autofmt::fmt_file(&contents, indent); + let len = edits.len(); + + if !edits.is_empty() { + let out = dioxus_autofmt::apply_formats(&contents, edits); + tokio::fs::write(path, out).await?; + } + + Ok(len) +} + /// Read every .rs file accessible when considering the .gitignore and try to format it /// /// Runs using Tokio for multithreading, so it should be really really fast @@ -96,8 +141,7 @@ impl Autoformat { async fn autoformat_project(check: bool) -> Result<()> { let crate_config = crate::CrateConfig::new(None)?; - let mut files_to_format = vec![]; - collect_rs_files(&crate_config.crate_dir, &mut files_to_format); + let files_to_format = get_project_files(&crate_config); if files_to_format.is_empty() { return Ok(()); @@ -107,38 +151,17 @@ async fn autoformat_project(check: bool) -> Result<()> { let counts = files_to_format .into_iter() - .filter(|file| { - if file.components().any(|f| f.as_os_str() == "target") { - return false; - } - - true - }) .map(|path| async { - let _path = path.clone(); - let _indent = indent.clone(); - let res = tokio::spawn(async move { - let contents = tokio::fs::read_to_string(&path).await?; - - let edits = dioxus_autofmt::fmt_file(&contents, _indent.clone()); - let len = edits.len(); - - if !edits.is_empty() { - let out = dioxus_autofmt::apply_formats(&contents, edits); - tokio::fs::write(&path, out).await?; - } - - Ok(len) as Result - }) - .await; + let path_clone = path.clone(); + let res = tokio::spawn(format_file(path, indent.clone())).await; match res { Err(err) => { - eprintln!("error formatting file: {}\n{err}", _path.display()); + eprintln!("error formatting file: {}\n{err}", path_clone.display()); None } Ok(Err(err)) => { - eprintln!("error formatting file: {}\n{err}", _path.display()); + eprintln!("error formatting file: {}\n{err}", path_clone.display()); None } Ok(Ok(res)) => Some(res), @@ -148,13 +171,7 @@ async fn autoformat_project(check: bool) -> Result<()> { .collect::>() .await; - let files_formatted: usize = counts - .into_iter() - .map(|f| match f { - Some(res) => res, - _ => 0, - }) - .sum(); + let files_formatted: usize = counts.into_iter().flatten().sum(); if files_formatted > 0 && check { eprintln!("{} files needed formatting", files_formatted); @@ -207,26 +224,24 @@ fn indentation_for(file_or_dir: impl AsRef) -> Result { )) } -fn collect_rs_files(folder: &Path, files: &mut Vec) { - let Ok(folder) = folder.read_dir() else { +fn collect_rs_files(folder: &impl AsRef, files: &mut Vec) { + if is_target_dir(folder.as_ref()) { + return; + } + let Ok(folder) = folder.as_ref().read_dir() else { return; }; - // load the gitignore - for entry in folder { let Ok(entry) = entry else { continue; }; - let path = entry.path(); - if path.is_dir() { collect_rs_files(&path, files); } - if let Some(ext) = path.extension() { - if ext == "rs" { + if ext == "rs" && !is_target_dir(&path) { files.push(path); } } From d5ec22a26f3148f12712e2ff1a4ea4849ddc12f6 Mon Sep 17 00:00:00 2001 From: Will Crichton Date: Fri, 15 Dec 2023 11:16:25 -0800 Subject: [PATCH 331/447] Add custom asynchronous asset handlers --- packages/desktop/src/desktop_context.rs | 23 ++++ packages/desktop/src/lib.rs | 5 +- packages/desktop/src/protocol.rs | 143 +++++++++++++++++++++++- packages/desktop/src/webview.rs | 42 ++++--- 4 files changed, 194 insertions(+), 19 deletions(-) diff --git a/packages/desktop/src/desktop_context.rs b/packages/desktop/src/desktop_context.rs index a48068d84..7f4ef9d1d 100644 --- a/packages/desktop/src/desktop_context.rs +++ b/packages/desktop/src/desktop_context.rs @@ -1,11 +1,18 @@ use std::cell::RefCell; +use std::future::Future; +use std::path::Path; use std::rc::Rc; use std::rc::Weak; use crate::create_new_window; use crate::events::IpcMessage; +use crate::protocol::AssetFuture; +use crate::protocol::AssetHandlerId; +use crate::protocol::AssetHandlerRegistry; +use crate::protocol::AssetResponse; use crate::query::QueryEngine; use crate::shortcut::{HotKey, ShortcutId, ShortcutRegistry, ShortcutRegistryError}; +use crate::AssetHandler; use crate::Config; use crate::WebviewHandler; use dioxus_core::ScopeState; @@ -64,6 +71,8 @@ pub struct DesktopService { pub(crate) shortcut_manager: ShortcutRegistry, + pub(crate) asset_handlers: AssetHandlerRegistry, + #[cfg(target_os = "ios")] pub(crate) views: Rc>>, } @@ -88,6 +97,7 @@ impl DesktopService { webviews: WebviewQueue, event_handlers: WindowEventHandlers, shortcut_manager: ShortcutRegistry, + asset_handlers: AssetHandlerRegistry, ) -> Self { Self { webview: Rc::new(webview), @@ -97,6 +107,7 @@ impl DesktopService { pending_windows: webviews, event_handlers, shortcut_manager, + asset_handlers, #[cfg(target_os = "ios")] views: Default::default(), } @@ -247,6 +258,18 @@ impl DesktopService { self.shortcut_manager.remove_all() } + /// Provide a callback to handle asset loading yourself. + /// + /// See [`use_asset_handle`](crate::use_asset_handle) for a convenient hook. + pub async fn register_asset_handler(&self, f: impl AssetHandler) { + self.asset_handlers.register_handler(f).await; + } + + /// Removes an asset handler by its identifier. + pub async fn remove_asset_handler(&self, id: AssetHandlerId) { + self.asset_handlers.remove_handler(id).await; + } + /// Push an objc view to the window #[cfg(target_os = "ios")] pub fn push_view(&self, view: objc_id::ShareId) { diff --git a/packages/desktop/src/lib.rs b/packages/desktop/src/lib.rs index d6d5ef4a5..f8155c333 100644 --- a/packages/desktop/src/lib.rs +++ b/packages/desktop/src/lib.rs @@ -32,6 +32,7 @@ use dioxus_html::{native_bind::NativeFileEngine, FormData, HtmlEvent}; use element::DesktopElement; use eval::init_eval; use futures_util::{pin_mut, FutureExt}; +pub use protocol::{use_asset_handler, AssetFuture, AssetHandler, AssetHandlerId, AssetResponse}; use shortcut::ShortcutRegistry; pub use shortcut::{use_global_shortcut, ShortcutHandle, ShortcutId, ShortcutRegistryError}; use std::cell::Cell; @@ -393,7 +394,8 @@ fn create_new_window( event_handlers: &WindowEventHandlers, shortcut_manager: ShortcutRegistry, ) -> WebviewHandler { - let (webview, web_context) = webview::build(&mut cfg, event_loop, proxy.clone()); + let (webview, web_context, asset_handlers) = + webview::build(&mut cfg, event_loop, proxy.clone()); let desktop_context = Rc::from(DesktopService::new( webview, proxy.clone(), @@ -401,6 +403,7 @@ fn create_new_window( queue.clone(), event_handlers.clone(), shortcut_manager, + asset_handlers, )); let cx = dom.base_scope(); diff --git a/packages/desktop/src/protocol.rs b/packages/desktop/src/protocol.rs index 2f660b7a2..774c0900a 100644 --- a/packages/desktop/src/protocol.rs +++ b/packages/desktop/src/protocol.rs @@ -1,13 +1,25 @@ +use dioxus_core::ScopeState; use dioxus_interpreter_js::{COMMON_JS, INTERPRETER_JS}; use std::{ borrow::Cow, + collections::HashMap, + future::Future, path::{Path, PathBuf}, + pin::Pin, + rc::Rc, + sync::Arc, +}; +use tokio::{ + runtime::Handle, + sync::{OnceCell, RwLock}, }; use wry::{ http::{status::StatusCode, Request, Response}, Result, }; +use crate::{use_window, DesktopContext}; + fn module_loader(root_name: &str) -> String { let js = INTERPRETER_JS.replace( "/*POST_HANDLE_EDITS*/", @@ -51,12 +63,132 @@ fn module_loader(root_name: &str) -> String { ) } -pub(super) fn desktop_handler( +/// An arbitrary asset is an HTTP response containing a binary body. +pub type AssetResponse = Response>; + +/// A future that returns an [`AssetResponse`]. This future may be spawned in a new thread, +/// so it must be [`Send`], [`Sync`], and `'static`. +pub trait AssetFuture: Future> + Send + Sync + 'static {} +impl> + Send + Sync + 'static> AssetFuture for T {} + +/// A handler that takes an asset [`Path`] and returns a future that loads the path. +/// This handler is stashed indefinitely in a context object, so it must be `'static`. +pub trait AssetHandler: Fn(&Path) -> F + Send + Sync + 'static {} +impl F + Send + Sync + 'static> AssetHandler for T {} + +/// An identifier for a registered asset handler, returned by [`AssetHandlerRegistry::register_handler`]. +#[derive(PartialEq, Eq, Hash, Clone, Copy, Debug)] +pub struct AssetHandlerId(usize); + +struct AssetHandlerRegistryInner { + handlers: HashMap< + AssetHandlerId, + Box Pin> + Send + Sync + 'static>, + >, + counter: AssetHandlerId, +} + +#[derive(Clone)] +pub struct AssetHandlerRegistry(Arc>); + +impl AssetHandlerRegistry { + pub fn new() -> Self { + AssetHandlerRegistry(Arc::new(RwLock::new(AssetHandlerRegistryInner { + handlers: HashMap::new(), + counter: AssetHandlerId(0), + }))) + } + + pub async fn register_handler( + &self, + f: impl AssetHandler, + ) -> AssetHandlerId { + let mut registry = self.0.write().await; + let id = registry.counter; + registry + .handlers + .insert(id, Box::new(move |path| Box::pin(f(path)))); + registry.counter.0 += 1; + id + } + + pub async fn remove_handler(&self, id: AssetHandlerId) -> Option<()> { + let mut registry = self.0.write().await; + registry.handlers.remove(&id).map(|_| ()) + } + + pub async fn try_handlers(&self, path: &Path) -> Option { + let registry = self.0.read().await; + for handler in registry.handlers.values() { + if let Some(response) = handler(path).await { + return Some(response); + } + } + None + } +} + +/// A handle to a registered asset handler. +pub struct AssetHandlerHandle { + desktop: DesktopContext, + handler_id: Rc>, +} + +impl AssetHandlerHandle { + /// Returns the [`AssetHandlerId`] for this handle. + /// + /// Because registering an ID is asynchronous, this may return `None` if the + /// registration has not completed yet. + pub fn handler_id(&self) -> Option { + self.handler_id.get().copied() + } +} + +impl Drop for AssetHandlerHandle { + fn drop(&mut self) { + let cell = Rc::clone(&self.handler_id); + let desktop = Rc::clone(&self.desktop); + tokio::task::block_in_place(move || { + Handle::current().block_on(async move { + if let Some(id) = cell.get() { + desktop.asset_handlers.remove_handler(*id).await; + } + }) + }); + } +} + +/// Provide a callback to handle asset loading yourself. +/// +/// The callback takes a path as requested by the web view, and it should return `Some(response)` +/// if you want to load the asset, and `None` if you want to fallback on the default behavior. +pub fn use_asset_handler( + cx: &ScopeState, + handler: impl AssetHandler, +) -> &AssetHandlerHandle { + let desktop = Rc::clone(&use_window(cx)); + cx.use_hook(|| { + let handler_id = Rc::new(OnceCell::new()); + let handler_id_ref = Rc::clone(&handler_id); + let desktop_ref = Rc::clone(&desktop); + cx.push_future(async move { + let id = desktop.asset_handlers.register_handler(handler).await; + handler_id.set(id).unwrap(); + }); + AssetHandlerHandle { + desktop: desktop_ref, + handler_id: handler_id_ref, + } + }) +} + +pub(super) async fn desktop_handler( request: &Request>, custom_head: Option, custom_index: Option, root_name: &str, -) -> Result>> { + asset_handlers: &AssetHandlerRegistry, +) -> Result { // If the request is for the root, we'll serve the index.html file. if request.uri().path() == "/" { // If a custom index is provided, just defer to that, expecting the user to know what they're doing. @@ -96,6 +228,13 @@ pub(super) fn desktop_handler( .expect("expected URL to be UTF-8 encoded"); let path = PathBuf::from(&*decoded); + // If the user provided a custom asset handler, then call it and return the response + // if the request was handled. + if let Some(response) = asset_handlers.try_handlers(&path).await { + return Ok(response); + } + + // Else, try to serve a file from the filesystem. // If the path is relative, we'll try to serve it from the assets directory. let mut asset = get_asset_root() .unwrap_or_else(|| Path::new(".").to_path_buf()) diff --git a/packages/desktop/src/webview.rs b/packages/desktop/src/webview.rs index cffb6f6b5..e2179352f 100644 --- a/packages/desktop/src/webview.rs +++ b/packages/desktop/src/webview.rs @@ -1,5 +1,7 @@ +use std::sync::Arc; + use crate::desktop_context::EventData; -use crate::protocol; +use crate::protocol::{self, AssetHandlerRegistry}; use crate::{desktop_context::UserWindowEvent, Config}; use tao::event_loop::{EventLoopProxy, EventLoopWindowTarget}; pub use wry; @@ -12,7 +14,7 @@ pub fn build( cfg: &mut Config, event_loop: &EventLoopWindowTarget, proxy: EventLoopProxy, -) -> (WebView, WebContext) { +) -> (WebView, WebContext, AssetHandlerRegistry) { let builder = cfg.window.clone(); let window = builder.with_visible(false).build(event_loop).unwrap(); let file_handler = cfg.file_drop_handler.take(); @@ -33,6 +35,8 @@ pub fn build( } let mut web_context = WebContext::new(cfg.data_dir.clone()); + let asset_handlers = AssetHandlerRegistry::new(); + let asset_handlers_ref = asset_handlers.clone(); let mut webview = WebViewBuilder::new(window) .unwrap() @@ -45,24 +49,30 @@ pub fn build( _ = proxy.send_event(UserWindowEvent(EventData::Ipc(message), window.id())); } }) - .with_custom_protocol( - String::from("dioxus"), - move |r| match protocol::desktop_handler( - &r, - custom_head.clone(), - index_file.clone(), - &root_name, - ) { - Ok(response) => response, - Err(err) => { + .with_asynchronous_custom_protocol(String::from("dioxus"), move |request, responder| { + let custom_head = custom_head.clone(); + let index_file = index_file.clone(); + let root_name = root_name.clone(); + let asset_handlers_ref = asset_handlers_ref.clone(); + tokio::spawn(async move { + let response_res = protocol::desktop_handler( + &request, + custom_head.clone(), + index_file.clone(), + &root_name, + &asset_handlers_ref, + ) + .await; + let response = response_res.unwrap_or_else(|err| { tracing::error!("Error: {}", err); Response::builder() .status(500) .body(err.to_string().into_bytes().into()) .unwrap() - } - }, - ) + }); + responder.respond(response); + }); + }) .with_file_drop_handler(move |window, evet| { file_handler .as_ref() @@ -119,5 +129,5 @@ pub fn build( webview = webview.with_devtools(true); } - (webview.build().unwrap(), web_context) + (webview.build().unwrap(), web_context, asset_handlers) } From 7bede0be59c9e48d55342c9f01978c34f8cc3a53 Mon Sep 17 00:00:00 2001 From: Will Crichton Date: Fri, 15 Dec 2023 11:30:19 -0800 Subject: [PATCH 332/447] Remove unused imports --- packages/desktop/src/desktop_context.rs | 3 --- packages/desktop/src/webview.rs | 2 -- 2 files changed, 5 deletions(-) diff --git a/packages/desktop/src/desktop_context.rs b/packages/desktop/src/desktop_context.rs index 7f4ef9d1d..cab3b4589 100644 --- a/packages/desktop/src/desktop_context.rs +++ b/packages/desktop/src/desktop_context.rs @@ -1,6 +1,4 @@ use std::cell::RefCell; -use std::future::Future; -use std::path::Path; use std::rc::Rc; use std::rc::Weak; @@ -9,7 +7,6 @@ use crate::events::IpcMessage; use crate::protocol::AssetFuture; use crate::protocol::AssetHandlerId; use crate::protocol::AssetHandlerRegistry; -use crate::protocol::AssetResponse; use crate::query::QueryEngine; use crate::shortcut::{HotKey, ShortcutId, ShortcutRegistry, ShortcutRegistryError}; use crate::AssetHandler; diff --git a/packages/desktop/src/webview.rs b/packages/desktop/src/webview.rs index e2179352f..1b13216c7 100644 --- a/packages/desktop/src/webview.rs +++ b/packages/desktop/src/webview.rs @@ -1,5 +1,3 @@ -use std::sync::Arc; - use crate::desktop_context::EventData; use crate::protocol::{self, AssetHandlerRegistry}; use crate::{desktop_context::UserWindowEvent, Config}; From 2321c1ad4448aa8b2759972fa695a9944bc8c203 Mon Sep 17 00:00:00 2001 From: w3irdrobot <3712883+w3irdrobot@users.noreply.github.com> Date: Fri, 15 Dec 2023 18:55:19 -0500 Subject: [PATCH 333/447] add error log when root element isn't found (#1724) --- packages/web/Cargo.toml | 1 + packages/web/src/dom.rs | 11 ++++++++++- 2 files changed, 11 insertions(+), 1 deletion(-) diff --git a/packages/web/Cargo.toml b/packages/web/Cargo.toml index 35eb9c5f1..b2a8e94c8 100644 --- a/packages/web/Cargo.toml +++ b/packages/web/Cargo.toml @@ -42,6 +42,7 @@ features = [ "HtmlFormElement", "Text", "Window", + "console", ] [features] diff --git a/packages/web/src/dom.rs b/packages/web/src/dom.rs index f45d6558a..b8e9255f7 100644 --- a/packages/web/src/dom.rs +++ b/packages/web/src/dom.rs @@ -45,7 +45,16 @@ impl WebsysDom { let document = load_document(); let root = match document.get_element_by_id(&cfg.rootname) { Some(root) => root, - None => document.create_element("body").ok().unwrap(), + None => { + web_sys::console::error_1( + &format!( + "element '#{}' not found. mounting to the body.", + cfg.rootname + ) + .into(), + ); + document.create_element("body").ok().unwrap() + } }; let interpreter = Channel::default(); From ed2ce6e0391d7eff8bbde747e653d4426c6dea1a Mon Sep 17 00:00:00 2001 From: "kidkool850@gmail.com" Date: Fri, 15 Dec 2023 22:23:59 -0600 Subject: [PATCH 334/447] Don't notify task if ready --- packages/core/src/scheduler/task.rs | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/packages/core/src/scheduler/task.rs b/packages/core/src/scheduler/task.rs index bf1075688..d2e9135e6 100644 --- a/packages/core/src/scheduler/task.rs +++ b/packages/core/src/scheduler/task.rs @@ -49,14 +49,15 @@ impl Scheduler { }; let mut cx = std::task::Context::from_waker(&task.waker); - let _ = task.task.borrow_mut().as_mut().poll(&mut cx); + + if !task.task.borrow_mut().as_mut().poll(&mut cx).is_ready() { + self.sender + .unbounded_send(SchedulerMsg::TaskNotified(task_id)) + .expect("Scheduler should exist"); + } entry.insert(task); - self.sender - .unbounded_send(SchedulerMsg::TaskNotified(task_id)) - .expect("Scheduler should exist"); - task_id } From b91e97ca434a5d34c048eabde9b93a7bdb17f732 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Sat, 16 Dec 2023 19:54:26 -0600 Subject: [PATCH 335/447] document events are only triggerable on elements --- packages/core/src/virtual_dom.rs | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/packages/core/src/virtual_dom.rs b/packages/core/src/virtual_dom.rs index b4dfba2c7..d1951b388 100644 --- a/packages/core/src/virtual_dom.rs +++ b/packages/core/src/virtual_dom.rs @@ -318,9 +318,9 @@ impl VirtualDom { } } - /// Call a listener inside the VirtualDom with data from outside the VirtualDom. + /// Call a listener inside the VirtualDom with data from outside the VirtualDom. **The ElementId passed in must be the id of an dynamic element, not a static node or a text node.** /// - /// This method will identify the appropriate element. The data must match up with the listener delcared. Note that + /// This method will identify the appropriate element. The data must match up with the listener declared. Note that /// this method does not give any indication as to the success of the listener call. If the listener is not found, /// nothing will happen. /// From 22f2c0ad9beb479a1f69c02b03c17a4685ff7cfa Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Sat, 16 Dec 2023 21:24:47 -0600 Subject: [PATCH 336/447] reduce how many times the create and diff fuzzing runs --- packages/core/tests/fuzzing.rs | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/packages/core/tests/fuzzing.rs b/packages/core/tests/fuzzing.rs index b847dc04e..be3dbadfb 100644 --- a/packages/core/tests/fuzzing.rs +++ b/packages/core/tests/fuzzing.rs @@ -305,10 +305,9 @@ fn create_random_element(cx: Scope) -> Element { } // test for panics when creating random nodes and templates -#[cfg(not(miri))] #[test] fn create() { - for _ in 0..1000 { + for _ in 0..100 { let mut vdom = VirtualDom::new_with_props(create_random_element, DepthProps { depth: 0, root: true }); let _ = vdom.rebuild(); @@ -317,10 +316,9 @@ fn create() { // test for panics when diffing random nodes // This test will change the template every render which is not very realistic, but it helps stress the system -#[cfg(not(miri))] #[test] fn diff() { - for _ in 0..100000 { + for _ in 0..10 { let mut vdom = VirtualDom::new_with_props(create_random_element, DepthProps { depth: 0, root: true }); let _ = vdom.rebuild(); From 7b45a3a98bde103e5c86a469159e2432da96bdda Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Sat, 16 Dec 2023 21:27:31 -0600 Subject: [PATCH 337/447] run fuzzing more when miri is deactivated --- packages/core/tests/fuzzing.rs | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/packages/core/tests/fuzzing.rs b/packages/core/tests/fuzzing.rs index be3dbadfb..65d131eb8 100644 --- a/packages/core/tests/fuzzing.rs +++ b/packages/core/tests/fuzzing.rs @@ -2,7 +2,7 @@ use dioxus::prelude::Props; use dioxus_core::*; -use std::collections::HashSet; +use std::{cfg, collections::HashSet}; fn random_ns() -> Option<&'static str> { let namespace = rand::random::() % 2; @@ -307,7 +307,8 @@ fn create_random_element(cx: Scope) -> Element { // test for panics when creating random nodes and templates #[test] fn create() { - for _ in 0..100 { + let repeat_count = if cfg!(miri) { 100 } else { 1000 }; + for _ in 0..repeat_count { let mut vdom = VirtualDom::new_with_props(create_random_element, DepthProps { depth: 0, root: true }); let _ = vdom.rebuild(); @@ -318,7 +319,8 @@ fn create() { // This test will change the template every render which is not very realistic, but it helps stress the system #[test] fn diff() { - for _ in 0..10 { + let repeat_count = if cfg!(miri) { 100 } else { 1000 }; + for _ in 0..repeat_count { let mut vdom = VirtualDom::new_with_props(create_random_element, DepthProps { depth: 0, root: true }); let _ = vdom.rebuild(); From 1002bc955b5f569eb9e74da90b62b16c45d43bc6 Mon Sep 17 00:00:00 2001 From: Will Crichton Date: Sat, 16 Dec 2023 21:44:39 -0800 Subject: [PATCH 338/447] Replace AssetHandlerId with slab and usize --- packages/desktop/src/desktop_context.rs | 11 +++--- packages/desktop/src/lib.rs | 2 +- packages/desktop/src/protocol.rs | 45 +++++++------------------ 3 files changed, 20 insertions(+), 38 deletions(-) diff --git a/packages/desktop/src/desktop_context.rs b/packages/desktop/src/desktop_context.rs index cab3b4589..fb0615900 100644 --- a/packages/desktop/src/desktop_context.rs +++ b/packages/desktop/src/desktop_context.rs @@ -5,7 +5,6 @@ use std::rc::Weak; use crate::create_new_window; use crate::events::IpcMessage; use crate::protocol::AssetFuture; -use crate::protocol::AssetHandlerId; use crate::protocol::AssetHandlerRegistry; use crate::query::QueryEngine; use crate::shortcut::{HotKey, ShortcutId, ShortcutRegistry, ShortcutRegistryError}; @@ -258,13 +257,15 @@ impl DesktopService { /// Provide a callback to handle asset loading yourself. /// /// See [`use_asset_handle`](crate::use_asset_handle) for a convenient hook. - pub async fn register_asset_handler(&self, f: impl AssetHandler) { - self.asset_handlers.register_handler(f).await; + pub async fn register_asset_handler(&self, f: impl AssetHandler) -> usize { + self.asset_handlers.register_handler(f).await } /// Removes an asset handler by its identifier. - pub async fn remove_asset_handler(&self, id: AssetHandlerId) { - self.asset_handlers.remove_handler(id).await; + /// + /// Returns `None` if the handler did not exist. + pub async fn remove_asset_handler(&self, id: usize) -> Option<()> { + self.asset_handlers.remove_handler(id).await } /// Push an objc view to the window diff --git a/packages/desktop/src/lib.rs b/packages/desktop/src/lib.rs index f8155c333..515c26009 100644 --- a/packages/desktop/src/lib.rs +++ b/packages/desktop/src/lib.rs @@ -32,7 +32,7 @@ use dioxus_html::{native_bind::NativeFileEngine, FormData, HtmlEvent}; use element::DesktopElement; use eval::init_eval; use futures_util::{pin_mut, FutureExt}; -pub use protocol::{use_asset_handler, AssetFuture, AssetHandler, AssetHandlerId, AssetResponse}; +pub use protocol::{use_asset_handler, AssetFuture, AssetHandler, AssetResponse}; use shortcut::ShortcutRegistry; pub use shortcut::{use_global_shortcut, ShortcutHandle, ShortcutId, ShortcutRegistryError}; use std::cell::Cell; diff --git a/packages/desktop/src/protocol.rs b/packages/desktop/src/protocol.rs index 774c0900a..cb21245f8 100644 --- a/packages/desktop/src/protocol.rs +++ b/packages/desktop/src/protocol.rs @@ -1,5 +1,6 @@ use dioxus_core::ScopeState; use dioxus_interpreter_js::{COMMON_JS, INTERPRETER_JS}; +use slab::Slab; use std::{ borrow::Cow, collections::HashMap, @@ -76,50 +77,30 @@ impl> + Send + Sync + 'static> AssetFut pub trait AssetHandler: Fn(&Path) -> F + Send + Sync + 'static {} impl F + Send + Sync + 'static> AssetHandler for T {} -/// An identifier for a registered asset handler, returned by [`AssetHandlerRegistry::register_handler`]. -#[derive(PartialEq, Eq, Hash, Clone, Copy, Debug)] -pub struct AssetHandlerId(usize); - -struct AssetHandlerRegistryInner { - handlers: HashMap< - AssetHandlerId, - Box Pin> + Send + Sync + 'static>, - >, - counter: AssetHandlerId, -} +type AssetHandlerRegistryInner = + Slab Pin> + Send + Sync + 'static>>; #[derive(Clone)] pub struct AssetHandlerRegistry(Arc>); impl AssetHandlerRegistry { pub fn new() -> Self { - AssetHandlerRegistry(Arc::new(RwLock::new(AssetHandlerRegistryInner { - handlers: HashMap::new(), - counter: AssetHandlerId(0), - }))) + AssetHandlerRegistry(Arc::new(RwLock::new(Slab::new()))) } - pub async fn register_handler( - &self, - f: impl AssetHandler, - ) -> AssetHandlerId { + pub async fn register_handler(&self, f: impl AssetHandler) -> usize { let mut registry = self.0.write().await; - let id = registry.counter; - registry - .handlers - .insert(id, Box::new(move |path| Box::pin(f(path)))); - registry.counter.0 += 1; - id + registry.insert(Box::new(move |path| Box::pin(f(path)))) } - pub async fn remove_handler(&self, id: AssetHandlerId) -> Option<()> { + pub async fn remove_handler(&self, id: usize) -> Option<()> { let mut registry = self.0.write().await; - registry.handlers.remove(&id).map(|_| ()) + registry.try_remove(id).map(|_| ()) } pub async fn try_handlers(&self, path: &Path) -> Option { let registry = self.0.read().await; - for handler in registry.handlers.values() { + for (_, handler) in registry.iter() { if let Some(response) = handler(path).await { return Some(response); } @@ -131,15 +112,15 @@ impl AssetHandlerRegistry { /// A handle to a registered asset handler. pub struct AssetHandlerHandle { desktop: DesktopContext, - handler_id: Rc>, + handler_id: Rc>, } impl AssetHandlerHandle { - /// Returns the [`AssetHandlerId`] for this handle. + /// Returns the ID for this handle. /// /// Because registering an ID is asynchronous, this may return `None` if the /// registration has not completed yet. - pub fn handler_id(&self) -> Option { + pub fn handler_id(&self) -> Option { self.handler_id.get().copied() } } @@ -166,7 +147,7 @@ pub fn use_asset_handler( cx: &ScopeState, handler: impl AssetHandler, ) -> &AssetHandlerHandle { - let desktop = Rc::clone(&use_window(cx)); + let desktop = Rc::clone(use_window(cx)); cx.use_hook(|| { let handler_id = Rc::new(OnceCell::new()); let handler_id_ref = Rc::clone(&handler_id); From a647ce2f36aedbec13ea4f380cef108830f458e1 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Sun, 17 Dec 2023 11:30:17 -0600 Subject: [PATCH 339/447] remove headless tests for CI --- packages/desktop/headless_tests/events.rs | 2 +- packages/desktop/headless_tests/rendering.rs | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/packages/desktop/headless_tests/events.rs b/packages/desktop/headless_tests/events.rs index ac62cd37b..7cf9407af 100644 --- a/packages/desktop/headless_tests/events.rs +++ b/packages/desktop/headless_tests/events.rs @@ -17,7 +17,7 @@ pub(crate) fn check_app_exits(app: Component) { dioxus_desktop::launch_cfg( app, - Config::new().with_window(WindowBuilder::new().with_visible(false)), + Config::new().with_window(WindowBuilder::new().with_visible(true)), ); // Stop deadman's switch diff --git a/packages/desktop/headless_tests/rendering.rs b/packages/desktop/headless_tests/rendering.rs index 0907121d4..e12d8644d 100644 --- a/packages/desktop/headless_tests/rendering.rs +++ b/packages/desktop/headless_tests/rendering.rs @@ -16,7 +16,7 @@ pub(crate) fn check_app_exits(app: Component) { dioxus_desktop::launch_cfg( app, - Config::new().with_window(WindowBuilder::new().with_visible(false)), + Config::new().with_window(WindowBuilder::new().with_visible(true)), ); should_panic.store(false, std::sync::atomic::Ordering::SeqCst); From d627153ccc78131b8db02622eb035484138207a4 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Sun, 17 Dec 2023 11:45:27 -0600 Subject: [PATCH 340/447] show off the new asset system in the examples --- examples/custom_assets.rs | 2 +- examples/file_explorer.rs | 3 ++- examples/tailwind/Dioxus.toml | 2 +- examples/tailwind/dist/tailwind3531548035813279582.css | 1 + examples/tailwind/src/main.rs | 8 +++----- examples/todomvc.rs | 3 ++- packages/dioxus/Cargo.toml | 1 + packages/dioxus/src/lib.rs | 3 +++ 8 files changed, 14 insertions(+), 9 deletions(-) create mode 100644 examples/tailwind/dist/tailwind3531548035813279582.css diff --git a/examples/custom_assets.rs b/examples/custom_assets.rs index 1253efba2..7eb9db375 100644 --- a/examples/custom_assets.rs +++ b/examples/custom_assets.rs @@ -10,7 +10,7 @@ fn app(cx: Scope) -> Element { p { "This should show an image:" } - img { src: "examples/assets/logo.png" } + img { src: mg!(image("examples/assets/logo.png").format(ImageType::Avif)).to_string() } } }) } diff --git a/examples/file_explorer.rs b/examples/file_explorer.rs index 88b37789d..f0534cbf8 100644 --- a/examples/file_explorer.rs +++ b/examples/file_explorer.rs @@ -18,13 +18,14 @@ fn main() { ); } +const _STYLE: &str = mg!(file("./examples/assets/fileexplorer.css")); + fn app(cx: Scope) -> Element { let files = use_ref(cx, Files::new); cx.render(rsx! { div { link { href:"https://fonts.googleapis.com/icon?family=Material+Icons", rel:"stylesheet", } - style { include_str!("./assets/fileexplorer.css") } header { i { class: "material-icons icon-menu", "menu" } h1 { "Files: ", files.read().current() } diff --git a/examples/tailwind/Dioxus.toml b/examples/tailwind/Dioxus.toml index b440d6a69..b7e78ff7f 100644 --- a/examples/tailwind/Dioxus.toml +++ b/examples/tailwind/Dioxus.toml @@ -30,7 +30,7 @@ watch_path = ["src", "public"] [web.resource] # CSS style file -style = ["/tailwind.css"] +style = [] # Javascript code file script = [] diff --git a/examples/tailwind/dist/tailwind3531548035813279582.css b/examples/tailwind/dist/tailwind3531548035813279582.css new file mode 100644 index 000000000..2196a9412 --- /dev/null +++ b/examples/tailwind/dist/tailwind3531548035813279582.css @@ -0,0 +1 @@ +*,:before,:after{box-sizing:border-box;border:0 solid #e5e7eb}:before,:after{--tw-content:""}html{-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-feature-settings:normal;font-family:ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,Segoe UI,Roboto,Helvetica Neue,Arial,Noto Sans,sans-serif,Apple Color Emoji,Segoe UI Emoji,Segoe UI Symbol,Noto Color Emoji;line-height:1.5}body{line-height:inherit;margin:0}hr{color:inherit;border-top-width:1px;height:0}abbr:where([title]){text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-size:1em}small{font-size:80%}sub,sup{vertical-align:baseline;font-size:75%;line-height:0;position:relative}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;font-weight:inherit;line-height:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button;background-color:#0000;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{margin:0;padding:0;list-style:none}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{vertical-align:middle;display:block}img,video{max-width:100%;height:auto}[hidden]{display:none}*,:before,:after,::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:#3b82f680;--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: }.container{width:100%}@media (width>=640px){.container{max-width:640px}}@media (width>=768px){.container{max-width:768px}}@media (width>=1024px){.container{max-width:1024px}}@media (width>=1280px){.container{max-width:1280px}}@media (width>=1536px){.container{max-width:1536px}}.mx-auto{margin-left:auto;margin-right:auto}.mb-16{margin-bottom:4rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-1{margin-left:.25rem}.ml-3{margin-left:.75rem}.ml-4{margin-left:1rem}.mr-5{margin-right:1.25rem}.mt-4{margin-top:1rem}.flex{display:flex}.inline-flex{display:inline-flex}.hidden{display:none}.h-10{height:2.5rem}.h-4{height:1rem}.w-10{width:2.5rem}.w-4{width:1rem}.w-5\/6{width:83.3333%}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-center{justify-content:center}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.border-0{border-width:0}.bg-gray-800{--tw-bg-opacity:1;background-color:rgb(31 41 55/var(--tw-bg-opacity))}.bg-gray-900{--tw-bg-opacity:1;background-color:rgb(17 24 39/var(--tw-bg-opacity))}.bg-indigo-500{--tw-bg-opacity:1;background-color:rgb(99 102 241/var(--tw-bg-opacity))}.object-cover{-o-object-fit:cover;object-fit:cover}.object-center{-o-object-position:center;object-position:center}.p-2{padding:.5rem}.p-5{padding:1.25rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-5{padding-left:1.25rem;padding-right:1.25rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.text-center{text-align:center}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-xl{font-size:1.25rem;line-height:1.75rem}.font-medium{font-weight:500}.leading-relaxed{line-height:1.625}.text-gray-400{--tw-text-opacity:1;color:rgb(156 163 175/var(--tw-text-opacity))}.text-white{--tw-text-opacity:1;color:rgb(255 255 255/var(--tw-text-opacity))}.hover\:bg-gray-700:hover{--tw-bg-opacity:1;background-color:rgb(55 65 81/var(--tw-bg-opacity))}.hover\:bg-indigo-600:hover{--tw-bg-opacity:1;background-color:rgb(79 70 229/var(--tw-bg-opacity))}.hover\:text-white:hover{--tw-text-opacity:1;color:rgb(255 255 255/var(--tw-text-opacity))}.focus\:outline-none:focus{outline-offset:2px;outline:2px solid #0000}@media (width>=640px){.sm\:text-4xl{font-size:2.25rem;line-height:2.5rem}}@media (width>=768px){.md\:mb-0{margin-bottom:0}.md\:ml-auto{margin-left:auto}.md\:mt-0{margin-top:0}.md\:w-1\/2{width:50%}.md\:flex-row{flex-direction:row}.md\:items-start{align-items:flex-start}.md\:pr-16{padding-right:4rem}.md\:text-left{text-align:left}}@media (width>=1024px){.lg\:inline-block{display:inline-block}.lg\:w-full{width:100%}.lg\:max-w-lg{max-width:32rem}.lg\:flex-grow{flex-grow:1}.lg\:pr-24{padding-right:6rem}} \ No newline at end of file diff --git a/examples/tailwind/src/main.rs b/examples/tailwind/src/main.rs index 2dbb183c9..36ff6d168 100644 --- a/examples/tailwind/src/main.rs +++ b/examples/tailwind/src/main.rs @@ -2,13 +2,11 @@ use dioxus::prelude::*; +const _STYLE: &str = mg!(file("./public/tailwind.css")); + fn main() { #[cfg(not(target_arch = "wasm32"))] - dioxus_desktop::launch_cfg( - app, - dioxus_desktop::Config::new() - .with_custom_head(r#""#.to_string()), - ); + dioxus_desktop::launch(app); #[cfg(target_arch = "wasm32")] dioxus_web::launch(app); } diff --git a/examples/todomvc.rs b/examples/todomvc.rs index 9ec2dc228..0a32cdff9 100644 --- a/examples/todomvc.rs +++ b/examples/todomvc.rs @@ -7,6 +7,8 @@ fn main() { dioxus_desktop::launch(app); } +const _STYLE: &str = mg!(file("./examples/assets/todomvc.css")); + #[derive(PartialEq, Eq, Clone, Copy)] pub enum FilterState { All, @@ -47,7 +49,6 @@ pub fn app(cx: Scope<()>) -> Element { cx.render(rsx! { section { class: "todoapp", - style { include_str!("./assets/todomvc.css") } TodoHeader { todos: todos, } diff --git a/packages/dioxus/Cargo.toml b/packages/dioxus/Cargo.toml index 2c284bf1a..170f0321e 100644 --- a/packages/dioxus/Cargo.toml +++ b/packages/dioxus/Cargo.toml @@ -16,6 +16,7 @@ dioxus-html = { workspace = true, optional = true } dioxus-core-macro = { workspace = true, optional = true } dioxus-hooks = { workspace = true, optional = true } dioxus-rsx = { workspace = true, optional = true } +manganis = { git = "https://github.com/DioxusLabs/collect-assets" } [target.'cfg(not(target_arch = "wasm32"))'.dependencies] dioxus-hot-reload = { workspace = true, optional = true } diff --git a/packages/dioxus/src/lib.rs b/packages/dioxus/src/lib.rs index 6256e96d7..1e64715b0 100644 --- a/packages/dioxus/src/lib.rs +++ b/packages/dioxus/src/lib.rs @@ -22,6 +22,9 @@ pub use dioxus_rsx as rsx; pub use dioxus_core_macro as core_macro; pub mod prelude { + pub use manganis; + pub use manganis::mg; + #[cfg(feature = "hooks")] pub use crate::hooks::*; From b0586843b246e4133340651810eaaa3b6757ecb6 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Sun, 17 Dec 2023 11:50:57 -0600 Subject: [PATCH 341/447] bump miri CI version --- .github/workflows/miri.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/miri.yml b/.github/workflows/miri.yml index 3864edb32..6c8a260b3 100644 --- a/.github/workflows/miri.yml +++ b/.github/workflows/miri.yml @@ -26,8 +26,8 @@ env: RUST_BACKTRACE: 1 # Change to specific Rust release to pin rust_stable: stable - rust_nightly: nightly-2022-11-03 - rust_clippy: 1.65.0 + rust_nightly: nightly-2023-11-16 + rust_clippy: 1.70.0 # When updating this, also update: # - README.md # - tokio/README.md From cf413780c1a00240ec9eaf9f4bd19c09119f5250 Mon Sep 17 00:00:00 2001 From: Exotik850 <60969639+Exotik850@users.noreply.github.com> Date: Sun, 17 Dec 2023 15:26:40 -0600 Subject: [PATCH 342/447] Make hot reload error only show once (#1725) --- packages/cli/src/server/desktop/mod.rs | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/packages/cli/src/server/desktop/mod.rs b/packages/cli/src/server/desktop/mod.rs index fec1e5a99..97f316d3c 100644 --- a/packages/cli/src/server/desktop/mod.rs +++ b/packages/cli/src/server/desktop/mod.rs @@ -127,6 +127,7 @@ async fn start_desktop_hot_reload(hot_reload_state: HotReloadState) -> Result<() let file_map = hot_reload_state.file_map.clone(); let channels = channels.clone(); let aborted = aborted.clone(); + let mut error_shown = false; move || { loop { //accept() will block the thread when local_socket_stream is in blocking mode (default) @@ -154,7 +155,8 @@ async fn start_desktop_hot_reload(hot_reload_state: HotReloadState) -> Result<() println!("Connected to hot reloading πŸš€"); } Err(err) => { - if err.kind() != std::io::ErrorKind::WouldBlock { + if !error_shown && err.kind() != std::io::ErrorKind::WouldBlock { + error_shown = true; println!("Error connecting to hot reloading: {} (Hot reloading is a feature of the dioxus-cli. If you are not using the CLI, this error can be ignored)", err); } } From e7515d18c1eef6f8547ea7e3ee1137561fdbb165 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Sun, 17 Dec 2023 15:39:48 -0600 Subject: [PATCH 343/447] show multiple different error messages in hot reloading --- packages/cli/src/server/desktop/mod.rs | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/packages/cli/src/server/desktop/mod.rs b/packages/cli/src/server/desktop/mod.rs index 97f316d3c..c89fb858c 100644 --- a/packages/cli/src/server/desktop/mod.rs +++ b/packages/cli/src/server/desktop/mod.rs @@ -7,10 +7,11 @@ use crate::{ }; use dioxus_hot_reload::HotReloadMsg; -use dioxus_html::HtmlCtx; +use dioxus_html::{HtmlCtx, SvgAttributes}; use dioxus_rsx::hot_reload::*; use interprocess_docfix::local_socket::LocalSocketListener; use std::{ + collections::HashSet, process::{Child, Command}, sync::{Arc, Mutex, RwLock}, }; @@ -127,7 +128,6 @@ async fn start_desktop_hot_reload(hot_reload_state: HotReloadState) -> Result<() let file_map = hot_reload_state.file_map.clone(); let channels = channels.clone(); let aborted = aborted.clone(); - let mut error_shown = false; move || { loop { //accept() will block the thread when local_socket_stream is in blocking mode (default) @@ -155,8 +155,11 @@ async fn start_desktop_hot_reload(hot_reload_state: HotReloadState) -> Result<() println!("Connected to hot reloading πŸš€"); } Err(err) => { - if !error_shown && err.kind() != std::io::ErrorKind::WouldBlock { - error_shown = true; + let error_string = err.to_string(); + // Filter out any error messages about a operation that may block and an error message that triggers on some operating systems that says "Waiting for a process to open the other end of the pipe" without WouldBlock being set + let display_error = err.kind() != std::io::ErrorKind::WouldBlock + && !error_string.contains("Waiting for a process"); + if display_error { println!("Error connecting to hot reloading: {} (Hot reloading is a feature of the dioxus-cli. If you are not using the CLI, this error can be ignored)", err); } } From 2a764aaf6a3854469a005e533b5dc8547116ca1e Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Sun, 17 Dec 2023 15:42:58 -0600 Subject: [PATCH 344/447] remove some unused CLI imports --- packages/cli/src/server/desktop/mod.rs | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/packages/cli/src/server/desktop/mod.rs b/packages/cli/src/server/desktop/mod.rs index c89fb858c..ec21fa4c0 100644 --- a/packages/cli/src/server/desktop/mod.rs +++ b/packages/cli/src/server/desktop/mod.rs @@ -7,11 +7,10 @@ use crate::{ }; use dioxus_hot_reload::HotReloadMsg; -use dioxus_html::{HtmlCtx, SvgAttributes}; +use dioxus_html::HtmlCtx; use dioxus_rsx::hot_reload::*; use interprocess_docfix::local_socket::LocalSocketListener; use std::{ - collections::HashSet, process::{Child, Command}, sync::{Arc, Mutex, RwLock}, }; From c48788270ecf6c92760b1c766053895834b65483 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Sun, 17 Dec 2023 16:46:32 -0600 Subject: [PATCH 345/447] fix lints in miri --- packages/core/src/runtime.rs | 2 +- packages/core/tests/task.rs | 50 ++++++++++++++++++------------------ 2 files changed, 26 insertions(+), 26 deletions(-) diff --git a/packages/core/src/runtime.rs b/packages/core/src/runtime.rs index 566e9ba7c..6b5e5408a 100644 --- a/packages/core/src/runtime.rs +++ b/packages/core/src/runtime.rs @@ -98,7 +98,7 @@ impl Runtime { } } -/// A gaurd for a new runtime. This must be used to override the current runtime when importing components from a dynamic library that has it's own runtime. +/// A guard for a new runtime. This must be used to override the current runtime when importing components from a dynamic library that has it's own runtime. /// /// ```rust /// use dioxus::prelude::*; diff --git a/packages/core/tests/task.rs b/packages/core/tests/task.rs index 1d190ccaf..e1ff55c85 100644 --- a/packages/core/tests/task.rs +++ b/packages/core/tests/task.rs @@ -1,13 +1,33 @@ //! Verify that tasks get polled by the virtualdom properly, and that we escape wait_for_work safely -use dioxus::prelude::*; -use std::{sync::atomic::AtomicUsize, time::Duration}; - -static POLL_COUNT: AtomicUsize = AtomicUsize::new(0); - #[cfg(not(miri))] #[tokio::test] async fn it_works() { + use dioxus::prelude::*; + use std::{sync::atomic::AtomicUsize, time::Duration}; + + static POLL_COUNT: AtomicUsize = AtomicUsize::new(0); + + fn app(cx: Scope) -> Element { + cx.use_hook(|| { + cx.spawn(async { + for x in 0..10 { + tokio::time::sleep(Duration::from_micros(50)).await; + POLL_COUNT.fetch_add(x, std::sync::atomic::Ordering::Relaxed); + } + }); + + cx.spawn(async { + for x in 0..10 { + tokio::time::sleep(Duration::from_micros(25)).await; + POLL_COUNT.fetch_add(x * 2, std::sync::atomic::Ordering::Relaxed); + } + }); + }); + + cx.render(rsx!(())) + } + let mut dom = VirtualDom::new(app); let _ = dom.rebuild(); @@ -24,23 +44,3 @@ async fn it_works() { 135 ); } - -fn app(cx: Scope) -> Element { - cx.use_hook(|| { - cx.spawn(async { - for x in 0..10 { - tokio::time::sleep(Duration::from_micros(50)).await; - POLL_COUNT.fetch_add(x, std::sync::atomic::Ordering::Relaxed); - } - }); - - cx.spawn(async { - for x in 0..10 { - tokio::time::sleep(Duration::from_micros(25)).await; - POLL_COUNT.fetch_add(x * 2, std::sync::atomic::Ordering::Relaxed); - } - }); - }); - - cx.render(rsx!(())) -} From 7649ad84a14aaf920f6ac9facbbdbb5787f41a25 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Sun, 17 Dec 2023 17:14:49 -0600 Subject: [PATCH 346/447] allow asset handlers to read the whole request --- packages/desktop/src/lib.rs | 2 +- packages/desktop/src/protocol.rs | 76 +++++++++++++++++++++++++------- packages/desktop/src/webview.rs | 2 +- 3 files changed, 61 insertions(+), 19 deletions(-) diff --git a/packages/desktop/src/lib.rs b/packages/desktop/src/lib.rs index 515c26009..18739aeda 100644 --- a/packages/desktop/src/lib.rs +++ b/packages/desktop/src/lib.rs @@ -32,7 +32,7 @@ use dioxus_html::{native_bind::NativeFileEngine, FormData, HtmlEvent}; use element::DesktopElement; use eval::init_eval; use futures_util::{pin_mut, FutureExt}; -pub use protocol::{use_asset_handler, AssetFuture, AssetHandler, AssetResponse}; +pub use protocol::{use_asset_handler, AssetFuture, AssetHandler, AssetRequest, AssetResponse}; use shortcut::ShortcutRegistry; pub use shortcut::{use_global_shortcut, ShortcutHandle, ShortcutId, ShortcutRegistryError}; use std::cell::Cell; diff --git a/packages/desktop/src/protocol.rs b/packages/desktop/src/protocol.rs index cb21245f8..31930da50 100644 --- a/packages/desktop/src/protocol.rs +++ b/packages/desktop/src/protocol.rs @@ -3,8 +3,8 @@ use dioxus_interpreter_js::{COMMON_JS, INTERPRETER_JS}; use slab::Slab; use std::{ borrow::Cow, - collections::HashMap, future::Future, + ops::{Deref, DerefMut}, path::{Path, PathBuf}, pin::Pin, rc::Rc, @@ -72,13 +72,57 @@ pub type AssetResponse = Response>; pub trait AssetFuture: Future> + Send + Sync + 'static {} impl> + Send + Sync + 'static> AssetFuture for T {} -/// A handler that takes an asset [`Path`] and returns a future that loads the path. +/// A request for an asset. This is a wrapper around [`Request>`] that provides methods specific to asset requests. +pub struct AssetRequest { + path: PathBuf, + request: Request>, +} + +impl AssetRequest { + /// Get the path the asset request is for + pub fn path(&self) -> &Path { + &self.path + } +} + +impl From>> for AssetRequest { + fn from(request: Request>) -> Self { + let decoded = urlencoding::decode(request.uri().path().trim_start_matches('/')) + .expect("expected URL to be UTF-8 encoded"); + let path = PathBuf::from(&*decoded); + Self { request, path } + } +} + +impl Deref for AssetRequest { + type Target = Request>; + + fn deref(&self) -> &Self::Target { + &self.request + } +} + +impl DerefMut for AssetRequest { + fn deref_mut(&mut self) -> &mut Self::Target { + &mut self.request + } +} + +/// A handler that takes an [`AssetRequest`] and returns a future that either loads the asset, or returns `None`. /// This handler is stashed indefinitely in a context object, so it must be `'static`. -pub trait AssetHandler: Fn(&Path) -> F + Send + Sync + 'static {} -impl F + Send + Sync + 'static> AssetHandler for T {} +pub trait AssetHandler: Send + Sync + 'static { + /// Handle an asset request, returning a future that either loads the asset, or returns `None` + fn handle_request(&self, request: &AssetRequest) -> F; +} + +impl F + Send + Sync + 'static> AssetHandler for T { + fn handle_request(&self, request: &AssetRequest) -> F { + self(request) + } +} type AssetHandlerRegistryInner = - Slab Pin> + Send + Sync + 'static>>; + Slab Pin> + Send + Sync + 'static>>; #[derive(Clone)] pub struct AssetHandlerRegistry(Arc>); @@ -90,7 +134,7 @@ impl AssetHandlerRegistry { pub async fn register_handler(&self, f: impl AssetHandler) -> usize { let mut registry = self.0.write().await; - registry.insert(Box::new(move |path| Box::pin(f(path)))) + registry.insert(Box::new(move |req| Box::pin(f.handle_request(req)))) } pub async fn remove_handler(&self, id: usize) -> Option<()> { @@ -98,10 +142,10 @@ impl AssetHandlerRegistry { registry.try_remove(id).map(|_| ()) } - pub async fn try_handlers(&self, path: &Path) -> Option { + pub async fn try_handlers(&self, req: &AssetRequest) -> Option { let registry = self.0.read().await; for (_, handler) in registry.iter() { - if let Some(response) = handler(path).await { + if let Some(response) = handler(req).await { return Some(response); } } @@ -164,12 +208,14 @@ pub fn use_asset_handler( } pub(super) async fn desktop_handler( - request: &Request>, + request: Request>, custom_head: Option, custom_index: Option, root_name: &str, asset_handlers: &AssetHandlerRegistry, ) -> Result { + let request = AssetRequest::from(request); + // If the request is for the root, we'll serve the index.html file. if request.uri().path() == "/" { // If a custom index is provided, just defer to that, expecting the user to know what they're doing. @@ -204,25 +250,21 @@ pub(super) async fn desktop_handler( .map_err(From::from); } - // Else, try to serve a file from the filesystem. - let decoded = urlencoding::decode(request.uri().path().trim_start_matches('/')) - .expect("expected URL to be UTF-8 encoded"); - let path = PathBuf::from(&*decoded); - // If the user provided a custom asset handler, then call it and return the response // if the request was handled. - if let Some(response) = asset_handlers.try_handlers(&path).await { + if let Some(response) = asset_handlers.try_handlers(&request).await { return Ok(response); } // Else, try to serve a file from the filesystem. + // If the path is relative, we'll try to serve it from the assets directory. let mut asset = get_asset_root() .unwrap_or_else(|| Path::new(".").to_path_buf()) - .join(&path); + .join(&request.path); if !asset.exists() { - asset = PathBuf::from("/").join(path); + asset = PathBuf::from("/").join(request.path); } if asset.exists() { diff --git a/packages/desktop/src/webview.rs b/packages/desktop/src/webview.rs index 1b13216c7..0294d3460 100644 --- a/packages/desktop/src/webview.rs +++ b/packages/desktop/src/webview.rs @@ -54,7 +54,7 @@ pub fn build( let asset_handlers_ref = asset_handlers_ref.clone(); tokio::spawn(async move { let response_res = protocol::desktop_handler( - &request, + request, custom_head.clone(), index_file.clone(), &root_name, From 9eee4ab8f8ae0c58929adca2c411b84c02d82372 Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Sun, 17 Dec 2023 17:14:55 -0600 Subject: [PATCH 347/447] add a dynamic asset example --- examples/dynamic_asset.rs | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 examples/dynamic_asset.rs diff --git a/examples/dynamic_asset.rs b/examples/dynamic_asset.rs new file mode 100644 index 000000000..1c004e015 --- /dev/null +++ b/examples/dynamic_asset.rs @@ -0,0 +1,29 @@ +use dioxus::prelude::*; +use dioxus_desktop::wry::http::Response; +use dioxus_desktop::{use_asset_handler, AssetRequest}; +use std::path::Path; + +fn main() { + dioxus_desktop::launch(app); +} + +fn app(cx: Scope) -> Element { + use_asset_handler(cx, |request: &AssetRequest| { + let path = request.path().to_path_buf(); + async move { + if path != Path::new("logo.png") { + return None; + } + let image_data: &[u8] = include_bytes!("./assets/logo.png"); + Some(Response::new(image_data.into())) + } + }); + + cx.render(rsx! { + div { + img { + src: "logo.png" + } + } + }) +} From cd019db9ef89a39bf58e33064a4f32b370018acb Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Mon, 18 Dec 2023 08:04:53 -0600 Subject: [PATCH 348/447] Bump actions/upload-artifact from 3 to 4 (#1726) Bumps [actions/upload-artifact](https://github.com/actions/upload-artifact) from 3 to 4. - [Release notes](https://github.com/actions/upload-artifact/releases) - [Commits](https://github.com/actions/upload-artifact/compare/v3...v4) --- updated-dependencies: - dependency-name: actions/upload-artifact dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- .github/workflows/playwright.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/playwright.yml b/.github/workflows/playwright.yml index cb5a1f1bb..7b23c6111 100644 --- a/.github/workflows/playwright.yml +++ b/.github/workflows/playwright.yml @@ -43,7 +43,7 @@ jobs: # args: --path packages/cli - name: Run Playwright tests run: npx playwright test - - uses: actions/upload-artifact@v3 + - uses: actions/upload-artifact@v4 if: always() with: name: playwright-report From ec4c1e0a441a6c475632de5244db9b889680471d Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Mon, 18 Dec 2023 08:32:50 -0600 Subject: [PATCH 349/447] add video stream example --- Cargo.toml | 1 + examples/video_stream.rs | 178 +++++++++++++++++++++++++++++++++++++++ 2 files changed, 179 insertions(+) create mode 100644 examples/video_stream.rs diff --git a/Cargo.toml b/Cargo.toml index a78f60d3e..41cd7cd83 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -133,3 +133,4 @@ fern = { version = "0.6.0", features = ["colored"] } env_logger = "0.10.0" simple_logger = "4.0.0" thiserror = { workspace = true } +http-range = "0.1.5" diff --git a/examples/video_stream.rs b/examples/video_stream.rs new file mode 100644 index 000000000..6338a7d68 --- /dev/null +++ b/examples/video_stream.rs @@ -0,0 +1,178 @@ +use dioxus::prelude::*; +use dioxus_desktop::wry::http; +use dioxus_desktop::wry::http::Response; +use dioxus_desktop::{use_asset_handler, AssetRequest}; +use http::{header::*, response::Builder as ResponseBuilder, status::StatusCode}; +use std::borrow::Cow; +use std::sync::{Arc, Mutex}; +use std::{ + io::{Read, Seek, SeekFrom, Write}, + path::PathBuf, +}; + +fn main() { + dioxus_desktop::launch(app); +} + +fn app(cx: Scope) -> Element { + let id = Arc::new(Mutex::new(0)); + use_asset_handler(cx, move |request: &AssetRequest| { + let response: Option>> = match get_stream_response(request, &id) + { + Ok(response) => Some(response.map(Cow::Owned)), + Err(err) => { + eprintln!("Error: {}", err); + None + } + }; + async move { response } + }); + + cx.render(rsx! { + div { + video { + src: "test_video.mp4", + autoplay: true, + controls: true, + width: 640, + height: 480, + } + } + }) +} + +fn get_stream_response( + request: &AssetRequest, + boundary_id: &Arc>, +) -> Result>, Box> { + let video_file = PathBuf::from("./examples/assets/test_video.mp4"); + + let mut file = std::fs::File::open(&video_file)?; + + // get file length + let len = { + let old_pos = file.stream_position()?; + let len = file.seek(SeekFrom::End(0))?; + file.seek(SeekFrom::Start(old_pos))?; + len + }; + + let mut resp = ResponseBuilder::new().header(CONTENT_TYPE, "video/mp4"); + + // if the webview sent a range header, we need to send a 206 in return + // Actually only macOS and Windows are supported. Linux will ALWAYS return empty headers. + let http_response = if let Some(range_header) = request.headers().get("range") { + let not_satisfiable = || { + ResponseBuilder::new() + .status(StatusCode::RANGE_NOT_SATISFIABLE) + .header(CONTENT_RANGE, format!("bytes */{len}")) + .body(vec![]) + }; + + // parse range header + let ranges = if let Ok(ranges) = http_range::HttpRange::parse(range_header.to_str()?, len) { + ranges + .iter() + // map the output back to spec range , example: 0-499 + .map(|r| (r.start, r.start + r.length - 1)) + .collect::>() + } else { + return Ok(not_satisfiable()?); + }; + + /// The Maximum bytes we send in one range + const MAX_LEN: u64 = 1000 * 1024; + + if ranges.len() == 1 { + let &(start, mut end) = ranges.first().unwrap(); + + // check if a range is not satisfiable + // + // this should be already taken care of by HttpRange::parse + // but checking here again for extra assurance + if start >= len || end >= len || end < start { + return Ok(not_satisfiable()?); + } + + // adjust end byte for MAX_LEN + end = start + (end - start).min(len - start).min(MAX_LEN - 1); + + // calculate number of bytes needed to be read + let bytes_to_read = end + 1 - start; + + // allocate a buf with a suitable capacity + let mut buf = Vec::with_capacity(bytes_to_read as usize); + // seek the file to the starting byte + file.seek(SeekFrom::Start(start))?; + // read the needed bytes + file.take(bytes_to_read).read_to_end(&mut buf)?; + + resp = resp.header(CONTENT_RANGE, format!("bytes {start}-{end}/{len}")); + resp = resp.header(CONTENT_LENGTH, end + 1 - start); + resp = resp.status(StatusCode::PARTIAL_CONTENT); + resp.body(buf) + } else { + let mut buf = Vec::new(); + let ranges = ranges + .iter() + .filter_map(|&(start, mut end)| { + // filter out unsatisfiable ranges + // + // this should be already taken care of by HttpRange::parse + // but checking here again for extra assurance + if start >= len || end >= len || end < start { + None + } else { + // adjust end byte for MAX_LEN + end = start + (end - start).min(len - start).min(MAX_LEN - 1); + Some((start, end)) + } + }) + .collect::>(); + + let mut id = boundary_id.lock().unwrap(); + *id += 1; + let boundary = format!("sadasq2e{id}"); + let boundary_sep = format!("\r\n--{boundary}\r\n"); + let boundary_closer = format!("\r\n--{boundary}\r\n"); + + resp = resp.header( + CONTENT_TYPE, + format!("multipart/byteranges; boundary={boundary}"), + ); + + for (end, start) in ranges { + // a new range is being written, write the range boundary + buf.write_all(boundary_sep.as_bytes())?; + + // write the needed headers `Content-Type` and `Content-Range` + buf.write_all(format!("{CONTENT_TYPE}: video/mp4\r\n").as_bytes())?; + buf.write_all( + format!("{CONTENT_RANGE}: bytes {start}-{end}/{len}\r\n").as_bytes(), + )?; + + // write the separator to indicate the start of the range body + buf.write_all("\r\n".as_bytes())?; + + // calculate number of bytes needed to be read + let bytes_to_read = end + 1 - start; + + let mut local_buf = vec![0_u8; bytes_to_read as usize]; + file.seek(SeekFrom::Start(start))?; + file.read_exact(&mut local_buf)?; + buf.extend_from_slice(&local_buf); + } + // all ranges have been written, write the closing boundary + buf.write_all(boundary_closer.as_bytes())?; + + resp.body(buf) + } + } else { + resp = resp.header(CONTENT_LENGTH, len); + let mut buf = Vec::with_capacity(len as usize); + file.read_to_end(&mut buf)?; + resp.body(buf) + }; + + http_response.map_err(Into::into) +} From dfb118e06ccc97885979da3bd8924de330b2078d Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Mon, 18 Dec 2023 09:34:30 -0600 Subject: [PATCH 350/447] make the video streaming async --- .gitignore | 1 + examples/video_stream.rs | 108 ++++++++++++++++--------------- packages/desktop/src/protocol.rs | 16 ++--- 3 files changed, 65 insertions(+), 60 deletions(-) diff --git a/.gitignore b/.gitignore index b8025753e..364e8d0fb 100644 --- a/.gitignore +++ b/.gitignore @@ -4,6 +4,7 @@ /dist Cargo.lock .DS_Store +/examples/assets/test_video.mp4 .vscode/* !.vscode/settings.json diff --git a/examples/video_stream.rs b/examples/video_stream.rs index 6338a7d68..f495299f4 100644 --- a/examples/video_stream.rs +++ b/examples/video_stream.rs @@ -4,56 +4,64 @@ use dioxus_desktop::wry::http::Response; use dioxus_desktop::{use_asset_handler, AssetRequest}; use http::{header::*, response::Builder as ResponseBuilder, status::StatusCode}; use std::borrow::Cow; -use std::sync::{Arc, Mutex}; -use std::{ - io::{Read, Seek, SeekFrom, Write}, - path::PathBuf, -}; +use std::{io::SeekFrom, path::PathBuf}; +use tokio::io::AsyncReadExt; +use tokio::io::AsyncSeekExt; +use tokio::io::AsyncWriteExt; + +const VIDEO_PATH: &str = "./examples/assets/test_video.mp4"; fn main() { + let video_file = PathBuf::from(VIDEO_PATH); + if !video_file.exists() { + tokio::runtime::Runtime::new() + .unwrap() + .block_on(async move { + println!("Downloading video file..."); + let video_url = + "http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4"; + let mut response = reqwest::get(video_url).await.unwrap(); + let mut file = tokio::fs::File::create(&video_file).await.unwrap(); + while let Some(chunk) = response.chunk().await.unwrap() { + file.write_all(&chunk).await.unwrap(); + } + }); + } dioxus_desktop::launch(app); } fn app(cx: Scope) -> Element { - let id = Arc::new(Mutex::new(0)); use_asset_handler(cx, move |request: &AssetRequest| { - let response: Option>> = match get_stream_response(request, &id) - { - Ok(response) => Some(response.map(Cow::Owned)), - Err(err) => { - eprintln!("Error: {}", err); - None - } - }; - async move { response } + let request = request.clone(); + async move { + let video_file = PathBuf::from(VIDEO_PATH); + let mut file = tokio::fs::File::open(&video_file).await.unwrap(); + let response: Option>> = + match get_stream_response(&mut file, &request).await { + Ok(response) => Some(response.map(Cow::Owned)), + Err(err) => { + eprintln!("Error: {}", err); + None + } + }; + response + } }); - cx.render(rsx! { - div { - video { - src: "test_video.mp4", - autoplay: true, - controls: true, - width: 640, - height: 480, - } - } - }) + render! { + div { video { src: "test_video.mp4", autoplay: true, controls: true, width: 640, height: 480 } } + } } -fn get_stream_response( +async fn get_stream_response( + asset: &mut (impl tokio::io::AsyncSeek + tokio::io::AsyncRead + Unpin + Send + Sync), request: &AssetRequest, - boundary_id: &Arc>, ) -> Result>, Box> { - let video_file = PathBuf::from("./examples/assets/test_video.mp4"); - - let mut file = std::fs::File::open(&video_file)?; - - // get file length + // get stream length let len = { - let old_pos = file.stream_position()?; - let len = file.seek(SeekFrom::End(0))?; - file.seek(SeekFrom::Start(old_pos))?; + let old_pos = asset.stream_position().await?; + let len = asset.seek(SeekFrom::End(0)).await?; + asset.seek(SeekFrom::Start(old_pos)).await?; len }; @@ -103,9 +111,9 @@ fn get_stream_response( // allocate a buf with a suitable capacity let mut buf = Vec::with_capacity(bytes_to_read as usize); // seek the file to the starting byte - file.seek(SeekFrom::Start(start))?; + asset.seek(SeekFrom::Start(start)).await?; // read the needed bytes - file.take(bytes_to_read).read_to_end(&mut buf)?; + asset.take(bytes_to_read).read_to_end(&mut buf).await?; resp = resp.header(CONTENT_RANGE, format!("bytes {start}-{end}/{len}")); resp = resp.header(CONTENT_LENGTH, end + 1 - start); @@ -130,9 +138,7 @@ fn get_stream_response( }) .collect::>(); - let mut id = boundary_id.lock().unwrap(); - *id += 1; - let boundary = format!("sadasq2e{id}"); + let boundary = format!("{:x}", rand::random::()); let boundary_sep = format!("\r\n--{boundary}\r\n"); let boundary_closer = format!("\r\n--{boundary}\r\n"); @@ -143,34 +149,34 @@ fn get_stream_response( for (end, start) in ranges { // a new range is being written, write the range boundary - buf.write_all(boundary_sep.as_bytes())?; + buf.write_all(boundary_sep.as_bytes()).await?; // write the needed headers `Content-Type` and `Content-Range` - buf.write_all(format!("{CONTENT_TYPE}: video/mp4\r\n").as_bytes())?; - buf.write_all( - format!("{CONTENT_RANGE}: bytes {start}-{end}/{len}\r\n").as_bytes(), - )?; + buf.write_all(format!("{CONTENT_TYPE}: video/mp4\r\n").as_bytes()) + .await?; + buf.write_all(format!("{CONTENT_RANGE}: bytes {start}-{end}/{len}\r\n").as_bytes()) + .await?; // write the separator to indicate the start of the range body - buf.write_all("\r\n".as_bytes())?; + buf.write_all("\r\n".as_bytes()).await?; // calculate number of bytes needed to be read let bytes_to_read = end + 1 - start; let mut local_buf = vec![0_u8; bytes_to_read as usize]; - file.seek(SeekFrom::Start(start))?; - file.read_exact(&mut local_buf)?; + asset.seek(SeekFrom::Start(start)).await?; + asset.read_exact(&mut local_buf).await?; buf.extend_from_slice(&local_buf); } // all ranges have been written, write the closing boundary - buf.write_all(boundary_closer.as_bytes())?; + buf.write_all(boundary_closer.as_bytes()).await?; resp.body(buf) } } else { resp = resp.header(CONTENT_LENGTH, len); let mut buf = Vec::with_capacity(len as usize); - file.read_to_end(&mut buf)?; + asset.read_to_end(&mut buf).await?; resp.body(buf) }; diff --git a/packages/desktop/src/protocol.rs b/packages/desktop/src/protocol.rs index 31930da50..46be1b942 100644 --- a/packages/desktop/src/protocol.rs +++ b/packages/desktop/src/protocol.rs @@ -4,7 +4,7 @@ use slab::Slab; use std::{ borrow::Cow, future::Future, - ops::{Deref, DerefMut}, + ops::Deref, path::{Path, PathBuf}, pin::Pin, rc::Rc, @@ -72,10 +72,11 @@ pub type AssetResponse = Response>; pub trait AssetFuture: Future> + Send + Sync + 'static {} impl> + Send + Sync + 'static> AssetFuture for T {} +#[derive(Debug, Clone)] /// A request for an asset. This is a wrapper around [`Request>`] that provides methods specific to asset requests. pub struct AssetRequest { path: PathBuf, - request: Request>, + request: Arc>>, } impl AssetRequest { @@ -90,7 +91,10 @@ impl From>> for AssetRequest { let decoded = urlencoding::decode(request.uri().path().trim_start_matches('/')) .expect("expected URL to be UTF-8 encoded"); let path = PathBuf::from(&*decoded); - Self { request, path } + Self { + request: Arc::new(request), + path, + } } } @@ -102,12 +106,6 @@ impl Deref for AssetRequest { } } -impl DerefMut for AssetRequest { - fn deref_mut(&mut self) -> &mut Self::Target { - &mut self.request - } -} - /// A handler that takes an [`AssetRequest`] and returns a future that either loads the asset, or returns `None`. /// This handler is stashed indefinitely in a context object, so it must be `'static`. pub trait AssetHandler: Send + Sync + 'static { From 2d7d721fd6fb3618d9bda54dd57348c64ea9189a Mon Sep 17 00:00:00 2001 From: Evan Almloff Date: Tue, 19 Dec 2023 16:02:07 -0600 Subject: [PATCH 351/447] make hydration more resilient using ids to hydrate --- .../examples/axum-hello-world/src/main.rs | 4 +- .../interpreter/src/sledgehammer_bindings.rs | 40 ++- packages/ssr/src/cache.rs | 36 ++- packages/ssr/src/renderer.rs | 46 ++- packages/ssr/tests/hydration.rs | 120 ++++++++ packages/web/examples/hydrate.rs | 22 +- packages/web/src/lib.rs | 31 +- packages/web/src/rehydrate.rs | 280 +----------------- 8 files changed, 255 insertions(+), 324 deletions(-) create mode 100644 packages/ssr/tests/hydration.rs diff --git a/packages/fullstack/examples/axum-hello-world/src/main.rs b/packages/fullstack/examples/axum-hello-world/src/main.rs index 64e5b44a0..e9d3dcad6 100644 --- a/packages/fullstack/examples/axum-hello-world/src/main.rs +++ b/packages/fullstack/examples/axum-hello-world/src/main.rs @@ -27,9 +27,7 @@ fn app(cx: Scope) -> Element { let eval = use_eval(cx); cx.render(rsx! { - div { - "Server state: {state}" - } + div { "Server state: {state}" } h1 { "High-Five counter: {count}" } button { onclick: move |_| count += 1, "Up high!" } button { onclick: move |_| count -= 1, "Down low!" } diff --git a/packages/interpreter/src/sledgehammer_bindings.rs b/packages/interpreter/src/sledgehammer_bindings.rs index e2633d024..fcd72937c 100644 --- a/packages/interpreter/src/sledgehammer_bindings.rs +++ b/packages/interpreter/src/sledgehammer_bindings.rs @@ -123,8 +123,42 @@ mod js { export function save_template(nodes, tmpl_id) { templates[tmpl_id] = nodes; } - export function set_node(id, node) { - nodes[id] = node; + export function hydrate() { + const hydrateNodes = document.querySelectorAll('[data-node-hydration]'); + for (let i = 0; i < hydrateNodes.length; i++) { + const hydrateNode = hydrateNodes[i]; + const hydration = hydrateNode.getAttribute('data-node-hydration'); + const split = hydration.split(','); + const id = parseInt(split[0]); + nodes[id] = hydrateNode; + console.log("hydrating node", hydrateNode, id); + if (split.length > 1) { + hydrateNode.listening = split.length - 1; + hydrateNode.setAttribute('data-dioxus-id', id); + for (let j = 1; j < split.length; j++) { + const listener = split[j]; + const split2 = listener.split(':'); + const event_name = split2[0]; + const bubbles = split2[1] === '1'; + console.log("hydrating listener", event_name, bubbles); + listeners.create(event_name, hydrateNode, bubbles); + } + } + } + const treeWalker = document.createTreeWalker( + document.body, + NodeFilter.SHOW_COMMENT, + ); + let currentNode = treeWalker.nextNode(); + while (currentNode) { + const id = currentNode.textContent; + const split = id.split('node-id'); + if (split.length > 1) { + console.log("hydrating text", currentNode.nextSibling, id); + nodes[parseInt(split[1])] = currentNode.nextSibling; + } + currentNode = treeWalker.nextNode(); + } } export function get_node(id) { return nodes[id]; @@ -181,7 +215,7 @@ mod js { pub fn save_template(nodes: Vec, tmpl_id: u32); #[wasm_bindgen] - pub fn set_node(id: u32, node: Node); + pub fn hydrate(); #[wasm_bindgen] pub fn get_node(id: u32) -> Node; diff --git a/packages/ssr/src/cache.rs b/packages/ssr/src/cache.rs index bcd6ba71f..9adcf395b 100644 --- a/packages/ssr/src/cache.rs +++ b/packages/ssr/src/cache.rs @@ -27,6 +27,10 @@ pub enum Segment { }, /// A marker for where to insert a dynamic inner html InnerHtmlMarker, + /// A marker for where to insert a node id for an attribute + AttributeNodeMarker(usize), + /// A marker for where to insert a node id for a root node + RootNodeMarker(usize), } impl std::fmt::Write for StringChain { @@ -41,13 +45,13 @@ impl std::fmt::Write for StringChain { } impl StringCache { - pub fn from_template(template: &VNode) -> Result { + pub fn from_template(template: &VNode, prerender: bool) -> Result { let mut chain = StringChain::default(); let mut cur_path = vec![]; for (root_idx, root) in template.template.get().roots.iter().enumerate() { - Self::recurse(root, &mut cur_path, root_idx, &mut chain)?; + Self::recurse(root, &mut cur_path, root_idx, true, prerender, &mut chain)?; } Ok(Self { @@ -60,6 +64,8 @@ impl StringCache { root: &TemplateNode, cur_path: &mut Vec, root_idx: usize, + is_root: bool, + prerender: bool, chain: &mut StringChain, ) -> Result<(), std::fmt::Error> { match root { @@ -76,7 +82,7 @@ impl StringCache { // we need to collect the inner html and write it at the end let mut inner_html = None; // we need to keep track of if we have dynamic attrs to know if we need to insert a style and inner_html marker - let mut has_dynamic_attrs = false; + let mut last_dyn_attr_id = None; for attr in *attrs { match attr { TemplateAttribute::Static { @@ -97,8 +103,9 @@ impl StringCache { } } TemplateAttribute::Dynamic { id: index } => { - chain.segments.push(Segment::Attr(*index)); - has_dynamic_attrs = true; + let index = *index; + chain.segments.push(Segment::Attr(index)); + last_dyn_attr_id = Some(index); } } } @@ -113,12 +120,25 @@ impl StringCache { inside_style_tag: true, }); write!(chain, "\"")?; - } else if has_dynamic_attrs { + } else if last_dyn_attr_id.is_some() { chain.segments.push(Segment::StyleMarker { inside_style_tag: false, }); } + // write the id if we are prerendering and this is either a root node or a node with a dynamic attribute + if prerender { + write!(chain, " data-node-hydration=\"")?; + if let Some(last_dyn_attr_id) = last_dyn_attr_id { + chain + .segments + .push(Segment::AttributeNodeMarker(last_dyn_attr_id)); + } else if is_root { + chain.segments.push(Segment::RootNodeMarker(root_idx)); + } + write!(chain, "\"")?; + } + if children.is_empty() && tag_is_self_closing(tag) { write!(chain, "/>")?; } else { @@ -126,12 +146,12 @@ impl StringCache { // Write the static inner html, or insert a marker if dynamic inner html is possible if let Some(inner_html) = inner_html { chain.write_str(inner_html)?; - } else if has_dynamic_attrs { + } else if last_dyn_attr_id.is_some() { chain.segments.push(Segment::InnerHtmlMarker); } for child in *children { - Self::recurse(child, cur_path, root_idx, chain)?; + Self::recurse(child, cur_path, root_idx, false, prerender, chain)?; } write!(chain, "")?; } diff --git a/packages/ssr/src/renderer.rs b/packages/ssr/src/renderer.rs index 98afef8b7..87c882cde 100644 --- a/packages/ssr/src/renderer.rs +++ b/packages/ssr/src/renderer.rs @@ -69,7 +69,10 @@ impl Renderer { let entry = self .template_cache .entry(template.template.get().name) - .or_insert_with(|| Arc::new(StringCache::from_template(template).unwrap())) + .or_insert_with({ + let prerender = self.pre_render; + move || Arc::new(StringCache::from_template(template, prerender).unwrap()) + }) .clone(); let mut inner_html = None; @@ -77,6 +80,9 @@ impl Renderer { // We need to keep track of the dynamic styles so we can insert them into the right place let mut accumulated_dynamic_styles = Vec::new(); + // We need to keep track of the listeners so we can insert them into the right place + let mut accumulated_listeners = Vec::new(); + for segment in entry.segments.iter() { match segment { Segment::Attr(idx) => { @@ -93,6 +99,12 @@ impl Renderer { } else { write_attribute(buf, attr)?; } + + if self.pre_render { + if let AttributeValue::Listener(_) = &attr.value { + accumulated_listeners.push(attr.name); + } + } } Segment::Node(idx) => match &template.dynamic_nodes[*idx] { DynamicNode::Component(node) => { @@ -115,7 +127,10 @@ impl Renderer { DynamicNode::Text(text) => { // in SSR, we are concerned that we can't hunt down the right text node since they might get merged if self.pre_render { - write!(buf, "")?; + let node_id = text + .mounted_element() + .expect("Text nodes must be mounted before rendering"); + write!(buf, "", node_id.0)?; } write!( @@ -134,9 +149,12 @@ impl Renderer { } } - DynamicNode::Placeholder(_el) => { + DynamicNode::Placeholder(el) => { if self.pre_render { - write!(buf, "
")?;
+                            let id = el
+                                .mounted_element()
+                                .expect("Elements must be mounted before rendering");
+                            write!(buf, "
", id.0)?;
                         }
                     }
                 },
@@ -175,6 +193,22 @@ impl Renderer {
                         }
                     }
                 }
+
+                Segment::AttributeNodeMarker(idx) => {
+                    let id = template.dynamic_attrs[*idx].mounted_element();
+                    // first write the id
+                    write!(buf, "{}", id.0)?;
+                    // then write any listeners
+                    for name in accumulated_listeners.drain(..) {
+                        write!(buf, ",{}:", &name[2..])?;
+                        write!(buf, "{}", dioxus_html::event_bubbles(name) as u8)?;
+                    }
+                }
+
+                Segment::RootNodeMarker(idx) => {
+                    let id = template.root_ids.borrow()[*idx];
+                    write!(buf, "{}", id.0)?;
+                }
             }
         }
 
@@ -192,7 +226,9 @@ fn to_string_works() {
 
         render! {
             div { class: "asdasdasd", class: "asdasdasd", id: "id-{dynamic}",
-                "Hello world 1 -->" "{dynamic}" "<-- Hello world 2"
+                "Hello world 1 -->"
+                "{dynamic}"
+                "<-- Hello world 2"
                 div { "nest 1" }
                 div {}
                 div { "nest 2" }
diff --git a/packages/ssr/tests/hydration.rs b/packages/ssr/tests/hydration.rs
new file mode 100644
index 000000000..736a1435b
--- /dev/null
+++ b/packages/ssr/tests/hydration.rs
@@ -0,0 +1,120 @@
+use dioxus::prelude::*;
+
+#[test]
+fn root_ids() {
+    fn app(cx: Scope) -> Element {
+        render! { div { width: "100px" } }
+    }
+
+    let mut dom = VirtualDom::new(app);
+    _ = dom.rebuild();
+
+    assert_eq!(
+        dioxus_ssr::pre_render(&dom),
+        r#"
"#
+    );
+}
+
+#[test]
+fn dynamic_attributes() {
+    fn app(cx: Scope) -> Element {
+        let dynamic = 123;
+        render! {
+            div { width: "100px", div { width: "{dynamic}px" } }
+        }
+    }
+
+    let mut dom = VirtualDom::new(app);
+    _ = dom.rebuild();
+
+    assert_eq!(
+        dioxus_ssr::pre_render(&dom),
+        r#"
"#
+    );
+}
+
+#[test]
+fn listeners() {
+    fn app(cx: Scope) -> Element {
+        render! {
+            div { width: "100px", div { onclick: |_| {} } }
+        }
+    }
+
+    let mut dom = VirtualDom::new(app);
+    _ = dom.rebuild();
+
+    assert_eq!(
+        dioxus_ssr::pre_render(&dom),
+        r#"
"#
+    );
+
+    fn app2(cx: Scope) -> Element {
+        let dynamic = 123;
+        render! {
+            div { width: "100px", div { width: "{dynamic}px", onclick: |_| {} } }
+        }
+    }
+
+    let mut dom = VirtualDom::new(app2);
+    _ = dom.rebuild();
+
+    assert_eq!(
+        dioxus_ssr::pre_render(&dom),
+        r#"
"#
+    );
+}
+
+#[test]
+fn text_nodes() {
+    fn app(cx: Scope) -> Element {
+        let dynamic_text = "hello";
+        render! {
+            div { dynamic_text }
+        }
+    }
+
+    let mut dom = VirtualDom::new(app);
+    _ = dom.rebuild();
+
+    assert_eq!(
+        dioxus_ssr::pre_render(&dom),
+        r#"
hello
"#
+    );
+
+    fn app2(cx: Scope) -> Element {
+        let dynamic = 123;
+        render! {
+            div { "{dynamic}", "{1234}" }
+        }
+    }
+
+    let mut dom = VirtualDom::new(app2);
+    _ = dom.rebuild();
+
+    assert_eq!(
+        dioxus_ssr::pre_render(&dom),
+        r#"
1231234
"#
+    );
+}
+
+#[test]
+fn hello_world_hydrates() {
+    fn app(cx: Scope) -> Element {
+        let mut count = use_state(cx, || 0);
+
+        cx.render(rsx! {
+            h1 { "High-Five counter: {count}" }
+            button { onclick: move |_| count += 1, "Up high!" }
+            button { onclick: move |_| count -= 1, "Down low!" }
+        })
+    }
+
+    let mut dom = VirtualDom::new(app);
+    _ = dbg!(dom.rebuild());
+
+    assert_eq!(
+        dioxus_ssr::pre_render(&dom),
+        r#"
High-Five counter: 0
"#
+    );
+}
diff --git a/packages/web/examples/hydrate.rs b/packages/web/examples/hydrate.rs
index 08c0f95cd..8a6cd464e 100644
--- a/packages/web/examples/hydrate.rs
+++ b/packages/web/examples/hydrate.rs
@@ -4,14 +4,10 @@ use web_sys::window;
 
 fn app(cx: Scope) -> Element {
     cx.render(rsx! {
+        div { h1 { "thing 1" } }
+        div { h2 { "thing 2" } }
         div {
-            h1 { "thing 1" }
-        }
-        div {
-            h2 { "thing 2"}
-        }
-        div {
-            h2 { "thing 2"}
+            h2 { "thing 2" }
             "asd"
             "asd"
             Bapp {}
@@ -27,14 +23,10 @@ fn app(cx: Scope) -> Element {
 #[allow(non_snake_case)]
 fn Bapp(cx: Scope) -> Element {
     cx.render(rsx! {
+        div { h1 { "thing 1" } }
+        div { h2 { "thing 2" } }
         div {
-            h1 { "thing 1" }
-        }
-        div {
-            h2 { "thing 2"}
-        }
-        div {
-            h2 { "thing 2"}
+            h2 { "thing 2" }
             "asd"
             "asd"
         }
@@ -60,6 +52,6 @@ fn main() {
         .unwrap()
         .set_inner_html(&pre);
 
-    // now rehydtrate
+    // now rehydrate
     dioxus_web::launch_with_props(app, (), Config::new().hydrate(true));
 }
diff --git a/packages/web/src/lib.rs b/packages/web/src/lib.rs
index 944ed3150..9b80dc325 100644
--- a/packages/web/src/lib.rs
+++ b/packages/web/src/lib.rs
@@ -215,21 +215,21 @@ pub async fn run_with_props(root: fn(Scope) -> Element, root_prop
             // todo: we need to split rebuild and initialize into two phases
             // it's a waste to produce edits just to get the vdom loaded
 
-            let templates = dom.rebuild().templates;
+            let mutations = dom.rebuild();
+            web_sys::console::log_1(&format!("mutations: {:#?}", mutations).into());
+            let templates = mutations.templates;
             websys_dom.load_templates(&templates);
+            websys_dom.interpreter.flush();
+            websys_dom.rehydrate();
+            // if !true {
+            //     tracing::error!("Rehydration failed. Rebuild DOM into element from scratch");
+            //     websys_dom.root.set_text_content(None);
 
-            if let Err(err) = websys_dom.rehydrate(&dom) {
-                tracing::error!(
-                    "Rehydration failed {:?}. Rebuild DOM into element from scratch",
-                    &err
-                );
-                websys_dom.root.set_text_content(None);
+            //     let edits = dom.rebuild();
 
-                let edits = dom.rebuild();
-
-                websys_dom.load_templates(&edits.templates);
-                websys_dom.apply_edits(edits.edits);
-            }
+            //     websys_dom.load_templates(&edits.templates);
+            //     websys_dom.apply_edits(edits.edits);
+            // }
         }
     } else {
         let edits = dom.rebuild();
@@ -277,6 +277,13 @@ pub async fn run_with_props(root: fn(Scope) -> Element, root_prop
         // Dequeue all of the events from the channel in send order
         // todo: we should re-order these if possible
         while let Some(evt) = res {
+            web_sys::console::log_1(
+                &format!(
+                    "event: {:?}, {:?}, {:?}",
+                    evt.name, evt.bubbles, evt.element
+                )
+                .into(),
+            );
             dom.handle_event(evt.name.as_str(), evt.data, evt.element, evt.bubbles);
             res = rx.try_next().transpose().unwrap().ok();
         }
diff --git a/packages/web/src/rehydrate.rs b/packages/web/src/rehydrate.rs
index 4415ceb37..e151bb13f 100644
--- a/packages/web/src/rehydrate.rs
+++ b/packages/web/src/rehydrate.rs
@@ -6,286 +6,10 @@ use dioxus_html::event_bubbles;
 use wasm_bindgen::JsCast;
 use web_sys::{Comment, Node};
 
-#[derive(Debug, Copy, Clone)]
-pub enum RehydrationError {
-    NodeTypeMismatch,
-    NodeNotFound,
-    VNodeNotInitialized,
-}
-use RehydrationError::*;
-
-fn set_node(hydrated: &mut Vec, id: ElementId, node: Node) {
-    let idx = id.0;
-    if idx >= hydrated.len() {
-        hydrated.resize(idx + 1, false);
-    }
-    if !hydrated[idx] {
-        dioxus_interpreter_js::set_node(idx as u32, node);
-        hydrated[idx] = true;
-    }
-}
-
 impl WebsysDom {
     // we're streaming in patches, but the nodes already exist
     // so we're just going to write the correct IDs to the node and load them in
-    pub fn rehydrate(&mut self, dom: &VirtualDom) -> Result<(), RehydrationError> {
-        let mut root = self
-            .root
-            .clone()
-            .dyn_into::()
-            .map_err(|_| NodeTypeMismatch)?
-            .first_child()
-            .ok_or(NodeNotFound);
-
-        let root_scope = dom.base_scope();
-
-        let mut hydrated = vec![true];
-
-        let mut last_node_was_static_text = false;
-
-        // Recursively rehydrate the dom from the VirtualDom
-        self.rehydrate_scope(
-            root_scope,
-            &mut root,
-            &mut hydrated,
-            dom,
-            &mut last_node_was_static_text,
-        )?;
-
-        self.interpreter.flush();
-        Ok(())
-    }
-
-    fn rehydrate_scope(
-        &mut self,
-        scope: &ScopeState,
-        current_child: &mut Result,
-        hydrated: &mut Vec,
-        dom: &VirtualDom,
-        last_node_was_static_text: &mut bool,
-    ) -> Result<(), RehydrationError> {
-        let vnode = match scope.root_node() {
-            dioxus_core::RenderReturn::Ready(ready) => ready,
-            _ => return Err(VNodeNotInitialized),
-        };
-        self.rehydrate_vnode(
-            current_child,
-            hydrated,
-            dom,
-            vnode,
-            last_node_was_static_text,
-        )
-    }
-
-    fn rehydrate_vnode(
-        &mut self,
-        current_child: &mut Result,
-        hydrated: &mut Vec,
-        dom: &VirtualDom,
-        vnode: &VNode,
-        last_node_was_static_text: &mut bool,
-    ) -> Result<(), RehydrationError> {
-        for (i, root) in vnode.template.get().roots.iter().enumerate() {
-            // make sure we set the root node ids even if the node is not dynamic
-            set_node(
-                hydrated,
-                *vnode.root_ids.borrow().get(i).ok_or(VNodeNotInitialized)?,
-                current_child.clone()?,
-            );
-
-            self.rehydrate_template_node(
-                current_child,
-                hydrated,
-                dom,
-                vnode,
-                root,
-                last_node_was_static_text,
-            )?;
-        }
-        Ok(())
-    }
-
-    fn rehydrate_template_node(
-        &mut self,
-        current_child: &mut Result,
-        hydrated: &mut Vec,
-        dom: &VirtualDom,
-        vnode: &VNode,
-        node: &TemplateNode,
-        last_node_was_static_text: &mut bool,
-    ) -> Result<(), RehydrationError> {
-        tracing::trace!("rehydrate template node: {:?}", node);
-        if let Ok(current_child) = current_child {
-            if tracing::event_enabled!(tracing::Level::TRACE) {
-                web_sys::console::log_1(¤t_child.clone().into());
-            }
-        }
-        match node {
-            TemplateNode::Element {
-                children, attrs, ..
-            } => {
-                let mut mounted_id = None;
-                for attr in *attrs {
-                    if let dioxus_core::TemplateAttribute::Dynamic { id } = attr {
-                        let attribute = &vnode.dynamic_attrs[*id];
-                        let value = &attribute.value;
-                        let id = attribute.mounted_element();
-                        mounted_id = Some(id);
-                        let name = attribute.name;
-                        if let AttributeValue::Listener(_) = value {
-                            let event_name = &name[2..];
-                            self.interpreter.new_event_listener(
-                                event_name,
-                                id.0 as u32,
-                                event_bubbles(event_name) as u8,
-                            );
-                        }
-                    }
-                }
-                if let Some(id) = mounted_id {
-                    set_node(hydrated, id, current_child.clone()?);
-                }
-                if !children.is_empty() {
-                    let mut children_current_child = current_child
-                        .as_mut()
-                        .map_err(|e| *e)?
-                        .first_child()
-                        .ok_or(NodeNotFound)?
-                        .dyn_into::()
-                        .map_err(|_| NodeTypeMismatch);
-                    for child in *children {
-                        self.rehydrate_template_node(
-                            &mut children_current_child,
-                            hydrated,
-                            dom,
-                            vnode,
-                            child,
-                            last_node_was_static_text,
-                        )?;
-                    }
-                }
-                *current_child = current_child
-                    .as_mut()
-                    .map_err(|e| *e)?
-                    .next_sibling()
-                    .ok_or(NodeNotFound);
-                *last_node_was_static_text = false;
-            }
-            TemplateNode::Text { .. } => {
-                // if the last node was static text, it got merged with this one
-                if !*last_node_was_static_text {
-                    *current_child = current_child
-                        .as_mut()
-                        .map_err(|e| *e)?
-                        .next_sibling()
-                        .ok_or(NodeNotFound);
-                }
-                *last_node_was_static_text = true;
-            }
-            TemplateNode::Dynamic { id } | TemplateNode::DynamicText { id } => {
-                self.rehydrate_dynamic_node(
-                    current_child,
-                    hydrated,
-                    dom,
-                    &vnode.dynamic_nodes[*id],
-                    last_node_was_static_text,
-                )?;
-            }
-        }
-        Ok(())
-    }
-
-    fn rehydrate_dynamic_node(
-        &mut self,
-        current_child: &mut Result,
-        hydrated: &mut Vec,
-        dom: &VirtualDom,
-        dynamic: &DynamicNode,
-        last_node_was_static_text: &mut bool,
-    ) -> Result<(), RehydrationError> {
-        tracing::trace!("rehydrate dynamic node: {:?}", dynamic);
-        if let Ok(current_child) = current_child {
-            if tracing::event_enabled!(tracing::Level::TRACE) {
-                web_sys::console::log_1(¤t_child.clone().into());
-            }
-        }
-        match dynamic {
-            dioxus_core::DynamicNode::Text(text) => {
-                let id = text.mounted_element();
-                // skip comment separator before node
-                if cfg!(debug_assertions) {
-                    assert!(current_child
-                        .as_mut()
-                        .map_err(|e| *e)?
-                        .has_type::());
-                }
-                *current_child = current_child
-                    .as_mut()
-                    .map_err(|e| *e)?
-                    .next_sibling()
-                    .ok_or(NodeNotFound);
-
-                set_node(
-                    hydrated,
-                    id.ok_or(VNodeNotInitialized)?,
-                    current_child.clone()?,
-                );
-                *current_child = current_child
-                    .as_mut()
-                    .map_err(|e| *e)?
-                    .next_sibling()
-                    .ok_or(NodeNotFound);
-
-                // skip comment separator after node
-                if cfg!(debug_assertions) {
-                    assert!(current_child
-                        .as_mut()
-                        .map_err(|e| *e)?
-                        .has_type::());
-                }
-                *current_child = current_child
-                    .as_mut()
-                    .map_err(|e| *e)?
-                    .next_sibling()
-                    .ok_or(NodeNotFound);
-
-                *last_node_was_static_text = false;
-            }
-            dioxus_core::DynamicNode::Placeholder(placeholder) => {
-                set_node(
-                    hydrated,
-                    placeholder.mounted_element().ok_or(VNodeNotInitialized)?,
-                    current_child.clone()?,
-                );
-                *current_child = current_child
-                    .as_mut()
-                    .map_err(|e| *e)?
-                    .next_sibling()
-                    .ok_or(NodeNotFound);
-                *last_node_was_static_text = false;
-            }
-            dioxus_core::DynamicNode::Component(comp) => {
-                let scope = comp.mounted_scope().ok_or(VNodeNotInitialized)?;
-                self.rehydrate_scope(
-                    dom.get_scope(scope).unwrap(),
-                    current_child,
-                    hydrated,
-                    dom,
-                    last_node_was_static_text,
-                )?;
-            }
-            dioxus_core::DynamicNode::Fragment(fragment) => {
-                for vnode in *fragment {
-                    self.rehydrate_vnode(
-                        current_child,
-                        hydrated,
-                        dom,
-                        vnode,
-                        last_node_was_static_text,
-                    )?;
-                }
-            }
-        }
-        Ok(())
+    pub fn rehydrate(&mut self) {
+        dioxus_interpreter_js::hydrate()
     }
 }

From 1880bdb308c15233a78cf313190ec41254137b93 Mon Sep 17 00:00:00 2001
From: ealmloff 
Date: Wed, 20 Dec 2023 10:28:24 -0600
Subject: [PATCH 352/447] Remove link to Tide's contributing guidelines

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index d1ec98019..65cd08263 100644
--- a/README.md
+++ b/README.md
@@ -161,7 +161,7 @@ So... Dioxus is great, but why won't it work for me?
 ## Contributing
 - Check out the website [section on contributing](https://dioxuslabs.com/learn/0.4/contributing).
 - Report issues on our [issue tracker](https://github.com/dioxuslabs/dioxus/issues).
-- Join the discord and ask questions!
+- [Join](https://discord.gg/XgGxMSkvUM) the discord and ask questions!
 
 
 

From 37e9876a703e03b891f795aaf70142f461ba3bd5 Mon Sep 17 00:00:00 2001
From: Evan Almloff 
Date: Wed, 20 Dec 2023 15:18:20 -0600
Subject: [PATCH 353/447] bump salvo

---
 packages/fullstack/Cargo.toml                            | 2 +-
 packages/fullstack/examples/salvo-hello-world/Cargo.toml | 2 +-
 packages/liveview/Cargo.toml                             | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/fullstack/Cargo.toml b/packages/fullstack/Cargo.toml
index 8de27a9b1..2f3eca420 100644
--- a/packages/fullstack/Cargo.toml
+++ b/packages/fullstack/Cargo.toml
@@ -26,7 +26,7 @@ tower = { version = "0.4.13", features = ["util"], optional = true }
 axum-macros = "0.3.7"
 
 # salvo
-salvo = { version = "0.46.0", optional = true, features = ["serve-static", "websocket", "compression"] }
+salvo = { version = "0.63.0", optional = true, features = ["serve-static", "websocket", "compression"] }
 serde = "1.0.159"
 
 # Dioxus + SSR
diff --git a/packages/fullstack/examples/salvo-hello-world/Cargo.toml b/packages/fullstack/examples/salvo-hello-world/Cargo.toml
index ca0d85ecf..3d4e74c5b 100644
--- a/packages/fullstack/examples/salvo-hello-world/Cargo.toml
+++ b/packages/fullstack/examples/salvo-hello-world/Cargo.toml
@@ -12,7 +12,7 @@ dioxus = { workspace = true }
 dioxus-fullstack = { workspace = true }
 tokio = { workspace = true, features = ["full"], optional = true }
 serde = "1.0.159"
-salvo = { version = "0.37.9", optional = true }
+salvo = { version = "0.63.0", optional = true }
 execute = "0.2.12"
 reqwest = "0.11.18"
 simple_logger = "4.2.0"
diff --git a/packages/liveview/Cargo.toml b/packages/liveview/Cargo.toml
index cbd7b75f5..50d984c7e 100644
--- a/packages/liveview/Cargo.toml
+++ b/packages/liveview/Cargo.toml
@@ -34,7 +34,7 @@ warp = { version = "0.3.3", optional = true }
 axum = { version = "0.6.1", optional = true, features = ["ws"] }
 
 # salvo
-salvo = { version = "0.44.1", optional = true, features = ["ws"] }
+salvo = { version = "0.63.0", optional = true, features = ["websocket"] }
 once_cell = "1.17.1"
 async-trait = "0.1.71"
 
@@ -49,7 +49,7 @@ tokio = { workspace = true, features = ["full"] }
 dioxus = { workspace = true }
 warp = "0.3.3"
 axum = { version = "0.6.1", features = ["ws"] }
-salvo = { version = "0.44.1", features = ["affix", "ws"] }
+salvo = { version = "0.63.0", features = ["affix", "websocket"] }
 tower = "0.4.13"
 
 [features]

From 8b125231f05336e87444464a4b2dd6b2cf522501 Mon Sep 17 00:00:00 2001
From: Evan Almloff 
Date: Thu, 21 Dec 2023 18:04:35 -0600
Subject: [PATCH 354/447] make backend and frontend builds happen in parallel

---
 packages/cli/src/builder.rs                   | 27 ++++++++--------
 packages/cli/src/cli/build.rs                 |  5 ++-
 packages/cli/src/cli/cfg.rs                   |  2 +-
 packages/cli/src/main.rs                      |  2 +-
 packages/cli/src/server/fullstack/mod.rs      | 31 ++++++++++++++-----
 .../fullstack/examples/axum-auth/.gitignore   |  3 +-
 .../examples/axum-desktop/.gitignore          |  4 ++-
 .../examples/axum-hello-world/.gitignore      |  3 +-
 .../fullstack/examples/axum-router/.gitignore |  3 +-
 .../examples/salvo-hello-world/.gitignore     |  3 +-
 .../examples/static-hydrated/.gitignore       |  3 +-
 .../examples/warp-hello-world/.gitignore      |  3 +-
 12 files changed, 58 insertions(+), 31 deletions(-)

diff --git a/packages/cli/src/builder.rs b/packages/cli/src/builder.rs
index 3e27a603c..e930a52bb 100644
--- a/packages/cli/src/builder.rs
+++ b/packages/cli/src/builder.rs
@@ -5,6 +5,7 @@ use crate::{
 };
 use cargo_metadata::{diagnostic::Diagnostic, Message};
 use indicatif::{ProgressBar, ProgressStyle};
+use lazy_static::lazy_static;
 use manganis_cli_support::AssetManifestExt;
 use serde::Serialize;
 use std::{
@@ -16,6 +17,10 @@ use std::{
 };
 use wasm_bindgen_cli_support::Bindgen;
 
+lazy_static! {
+    static ref PROGRESS_BARS: indicatif::MultiProgress = indicatif::MultiProgress::new();
+}
+
 #[derive(Serialize, Debug, Clone)]
 pub struct BuildResult {
     pub warnings: Vec,
@@ -25,7 +30,7 @@ pub struct BuildResult {
 pub fn build(config: &CrateConfig, _: bool, skip_assets: bool) -> Result {
     // [1] Build the project with cargo, generating a wasm32-unknown-unknown target (is there a more specific, better target to leverage?)
     // [2] Generate the appropriate build folders
-    // [3] Wasm-bindgen the .wasm fiile, and move it into the {builddir}/modules/xxxx/xxxx_bg.wasm
+    // [3] Wasm-bindgen the .wasm file, and move it into the {builddir}/modules/xxxx/xxxx_bg.wasm
     // [4] Wasm-opt the .wasm file with whatever optimizations need to be done
     // [5][OPTIONAL] Builds the Tailwind CSS file using the Tailwind standalone binary
     // [6] Link up the html page to the wasm module
@@ -61,8 +66,8 @@ pub fn build(config: &CrateConfig, _: bool, skip_assets: bool) -> Result Result<()> {
 fn prettier_build(cmd: subprocess::Exec) -> anyhow::Result> {
     let mut warning_messages: Vec = vec![];
 
-    let pb = ProgressBar::new_spinner();
+    let mut pb = ProgressBar::new_spinner();
     pb.enable_steady_tick(Duration::from_millis(200));
+    pb = PROGRESS_BARS.add(pb);
     pb.set_style(
         ProgressStyle::with_template("{spinner:.dim.bold} {wide_msg}")
             .unwrap()
@@ -413,14 +420,6 @@ fn prettier_build(cmd: subprocess::Exec) -> anyhow::Result> {
     );
     pb.set_message("πŸ’Ό Waiting to start build the project...");
 
-    struct StopSpinOnDrop(ProgressBar);
-
-    impl Drop for StopSpinOnDrop {
-        fn drop(&mut self) {
-            self.0.finish_and_clear();
-        }
-    }
-
     let stdout = cmd.detached().stream_stdout()?;
     let reader = std::io::BufReader::new(stdout);
 
@@ -456,7 +455,9 @@ fn prettier_build(cmd: subprocess::Exec) -> anyhow::Result> {
                     std::process::exit(1);
                 }
             }
-            _ => (), // Unknown message
+            _ => {
+                // Unknown message
+            }
         }
     }
     Ok(warning_messages)
diff --git a/packages/cli/src/cli/build.rs b/packages/cli/src/cli/build.rs
index e1e8ac607..00e3deb43 100644
--- a/packages/cli/src/cli/build.rs
+++ b/packages/cli/src/cli/build.rs
@@ -15,8 +15,11 @@ pub struct Build {
 }
 
 impl Build {
-    pub fn build(self, bin: Option) -> Result<()> {
+    pub fn build(self, bin: Option, target_dir: Option<&std::path::Path>) -> Result<()> {
         let mut crate_config = crate::CrateConfig::new(bin)?;
+        if let Some(target_dir) = target_dir {
+            crate_config.target_dir = target_dir.to_path_buf();
+        }
 
         // change the release state.
         crate_config.with_release(self.build.release);
diff --git a/packages/cli/src/cli/cfg.rs b/packages/cli/src/cli/cfg.rs
index b2c2c9c1a..6416084d2 100644
--- a/packages/cli/src/cli/cfg.rs
+++ b/packages/cli/src/cli/cfg.rs
@@ -112,7 +112,7 @@ pub struct ConfigOptsServe {
     #[clap(long)]
     pub profile: Option,
 
-    /// Build platform: support Web & Desktop [default: "default_platform"]
+    /// Build platform: support Web, Desktop, and Fullstack [default: "default_platform"]
     #[clap(long, value_enum)]
     pub platform: Option,
 
diff --git a/packages/cli/src/main.rs b/packages/cli/src/main.rs
index 7ca1b2c9a..3571ca074 100644
--- a/packages/cli/src/main.rs
+++ b/packages/cli/src/main.rs
@@ -61,7 +61,7 @@ async fn main() -> anyhow::Result<()> {
             .map_err(|e| anyhow!("🚫 Translation of HTML into RSX failed: {}", e)),
 
         Build(opts) => opts
-            .build(Some(bin.clone()))
+            .build(Some(bin.clone()), None)
             .map_err(|e| anyhow!("🚫 Building project failed: {}", e)),
 
         Clean(opts) => opts
diff --git a/packages/cli/src/server/fullstack/mod.rs b/packages/cli/src/server/fullstack/mod.rs
index 2ee8f7415..62bc4ea88 100644
--- a/packages/cli/src/server/fullstack/mod.rs
+++ b/packages/cli/src/server/fullstack/mod.rs
@@ -9,6 +9,16 @@ pub async fn startup(config: CrateConfig, serve: &ConfigOptsServe) -> Result<()>
     desktop::startup_with_platform::(config, serve).await
 }
 
+fn start_web_build_thread(
+    config: &CrateConfig,
+    serve: &ConfigOptsServe,
+) -> std::thread::JoinHandle> {
+    let serve = serve.clone();
+    let target_directory = config.crate_dir.join(".dioxus").join("web");
+    std::fs::create_dir_all(&target_directory).unwrap();
+    std::thread::spawn(move || build_web(serve, &target_directory))
+}
+
 struct FullstackPlatform {
     serve: ConfigOptsServe,
     desktop: desktop::DesktopPlatform,
@@ -20,9 +30,7 @@ impl Platform for FullstackPlatform {
     where
         Self: Sized,
     {
-        {
-            build_web(serve.clone())?;
-        }
+        let thread_handle = start_web_build_thread(config, serve);
 
         let mut desktop_config = config.clone();
         let desktop_feature = serve.server_feature.clone();
@@ -35,6 +43,9 @@ impl Platform for FullstackPlatform {
         };
         let config = WebAssetConfigDropGuard::new();
         let desktop = desktop::DesktopPlatform::start(&desktop_config, serve)?;
+        thread_handle
+            .join()
+            .map_err(|_| anyhow::anyhow!("Failed to join thread"))??;
 
         Ok(Self {
             desktop,
@@ -44,8 +55,8 @@ impl Platform for FullstackPlatform {
     }
 
     fn rebuild(&mut self, crate_config: &CrateConfig) -> Result {
-        build_web(self.serve.clone())?;
-        {
+        let thread_handle = start_web_build_thread(crate_config, &self.serve);
+        let result = {
             let mut desktop_config = crate_config.clone();
             let desktop_feature = self.serve.server_feature.clone();
             let features = &mut desktop_config.features;
@@ -57,11 +68,15 @@ impl Platform for FullstackPlatform {
             };
             let _gaurd = FullstackServerEnvGuard::new(self.serve.debug);
             self.desktop.rebuild(&desktop_config)
-        }
+        };
+        thread_handle
+            .join()
+            .map_err(|_| anyhow::anyhow!("Failed to join thread"))??;
+        result
     }
 }
 
-fn build_web(serve: ConfigOptsServe) -> Result<()> {
+fn build_web(serve: ConfigOptsServe, target_directory: &std::path::Path) -> Result<()> {
     let mut web_config: ConfigOptsBuild = serve.into();
     let web_feature = web_config.client_feature.clone();
     let features = &mut web_config.features;
@@ -74,7 +89,7 @@ fn build_web(serve: ConfigOptsServe) -> Result<()> {
     web_config.platform = Some(crate::cfg::Platform::Web);
 
     let _gaurd = FullstackWebEnvGuard::new(web_config.debug);
-    crate::cli::build::Build { build: web_config }.build(None)
+    crate::cli::build::Build { build: web_config }.build(None, Some(target_directory))
 }
 
 // Debug mode web builds have a very large size by default. If debug mode is not enabled, we strip some of the debug info by default
diff --git a/packages/fullstack/examples/axum-auth/.gitignore b/packages/fullstack/examples/axum-auth/.gitignore
index b2a16319f..21fff11dd 100644
--- a/packages/fullstack/examples/axum-auth/.gitignore
+++ b/packages/fullstack/examples/axum-auth/.gitignore
@@ -1,3 +1,4 @@
 dist
 target
-static
\ No newline at end of file
+static
+.dioxus
\ No newline at end of file
diff --git a/packages/fullstack/examples/axum-desktop/.gitignore b/packages/fullstack/examples/axum-desktop/.gitignore
index 6047329c6..21fff11dd 100644
--- a/packages/fullstack/examples/axum-desktop/.gitignore
+++ b/packages/fullstack/examples/axum-desktop/.gitignore
@@ -1,2 +1,4 @@
 dist
-target
\ No newline at end of file
+target
+static
+.dioxus
\ No newline at end of file
diff --git a/packages/fullstack/examples/axum-hello-world/.gitignore b/packages/fullstack/examples/axum-hello-world/.gitignore
index b2a16319f..21fff11dd 100644
--- a/packages/fullstack/examples/axum-hello-world/.gitignore
+++ b/packages/fullstack/examples/axum-hello-world/.gitignore
@@ -1,3 +1,4 @@
 dist
 target
-static
\ No newline at end of file
+static
+.dioxus
\ No newline at end of file
diff --git a/packages/fullstack/examples/axum-router/.gitignore b/packages/fullstack/examples/axum-router/.gitignore
index b2a16319f..21fff11dd 100644
--- a/packages/fullstack/examples/axum-router/.gitignore
+++ b/packages/fullstack/examples/axum-router/.gitignore
@@ -1,3 +1,4 @@
 dist
 target
-static
\ No newline at end of file
+static
+.dioxus
\ No newline at end of file
diff --git a/packages/fullstack/examples/salvo-hello-world/.gitignore b/packages/fullstack/examples/salvo-hello-world/.gitignore
index b2a16319f..21fff11dd 100644
--- a/packages/fullstack/examples/salvo-hello-world/.gitignore
+++ b/packages/fullstack/examples/salvo-hello-world/.gitignore
@@ -1,3 +1,4 @@
 dist
 target
-static
\ No newline at end of file
+static
+.dioxus
\ No newline at end of file
diff --git a/packages/fullstack/examples/static-hydrated/.gitignore b/packages/fullstack/examples/static-hydrated/.gitignore
index c7f237de8..b98a2a695 100644
--- a/packages/fullstack/examples/static-hydrated/.gitignore
+++ b/packages/fullstack/examples/static-hydrated/.gitignore
@@ -1,3 +1,4 @@
 docs
 target
-static
\ No newline at end of file
+static
+.dioxus
\ No newline at end of file
diff --git a/packages/fullstack/examples/warp-hello-world/.gitignore b/packages/fullstack/examples/warp-hello-world/.gitignore
index b2a16319f..21fff11dd 100644
--- a/packages/fullstack/examples/warp-hello-world/.gitignore
+++ b/packages/fullstack/examples/warp-hello-world/.gitignore
@@ -1,3 +1,4 @@
 dist
 target
-static
\ No newline at end of file
+static
+.dioxus
\ No newline at end of file

From 601c63b67f0c649024fc2974e360f59e8630fab5 Mon Sep 17 00:00:00 2001
From: Evan Almloff 
Date: Fri, 22 Dec 2023 09:25:35 -0600
Subject: [PATCH 355/447] manually apply debug assertions flag for fullstack
 debug mode

---
 packages/cli/src/server/fullstack/mod.rs | 29 ++++++++++++++++++------
 1 file changed, 22 insertions(+), 7 deletions(-)

diff --git a/packages/cli/src/server/fullstack/mod.rs b/packages/cli/src/server/fullstack/mod.rs
index 62bc4ea88..abe4fe82d 100644
--- a/packages/cli/src/server/fullstack/mod.rs
+++ b/packages/cli/src/server/fullstack/mod.rs
@@ -66,7 +66,7 @@ impl Platform for FullstackPlatform {
                 }
                 None => desktop_config.features = Some(vec![desktop_feature]),
             };
-            let _gaurd = FullstackServerEnvGuard::new(self.serve.debug);
+            let _gaurd = FullstackServerEnvGuard::new(&self.serve);
             self.desktop.rebuild(&desktop_config)
         };
         thread_handle
@@ -88,7 +88,7 @@ fn build_web(serve: ConfigOptsServe, target_directory: &std::path::Path) -> Resu
     };
     web_config.platform = Some(crate::cfg::Platform::Web);
 
-    let _gaurd = FullstackWebEnvGuard::new(web_config.debug);
+    let _gaurd = FullstackWebEnvGuard::new(&web_config);
     crate::cli::build::Build { build: web_config }.build(None, Some(target_directory))
 }
 
@@ -99,14 +99,21 @@ pub(crate) struct FullstackWebEnvGuard {
 }
 
 impl FullstackWebEnvGuard {
-    pub fn new(debug_mode: bool) -> Self {
+    pub fn new(serve: &ConfigOptsBuild) -> Self {
         Self {
-            old_rustflags: (!debug_mode).then(|| {
+            old_rustflags: (!serve.debug).then(|| {
                 let old_rustflags = std::env::var("RUSTFLAGS").unwrap_or_default();
+                let debug_assertions = if serve.release {
+                    ""
+                } else {
+                    " -C debug-assertions"
+                };
 
                 std::env::set_var(
                     "RUSTFLAGS",
-                    format!("{old_rustflags} -C debuginfo=none -C strip=debuginfo"),
+                    format!(
+                        "{old_rustflags} -C debuginfo=none -C strip=debuginfo{debug_assertions}"
+                    ),
                 );
                 old_rustflags
             }),
@@ -129,12 +136,20 @@ pub(crate) struct FullstackServerEnvGuard {
 }
 
 impl FullstackServerEnvGuard {
-    pub fn new(debug_mode: bool) -> Self {
+    pub fn new(debug_mode: bool, release_mode: bool) -> Self {
         Self {
             old_rustflags: (!debug_mode).then(|| {
                 let old_rustflags = std::env::var("RUSTFLAGS").unwrap_or_default();
+                let debug_assertions = if serve.release {
+                    ""
+                } else {
+                    " -C debug-assertions"
+                };
 
-                std::env::set_var("RUSTFLAGS", format!("{old_rustflags} -C opt-level=2"));
+                std::env::set_var(
+                    "RUSTFLAGS",
+                    format!("{old_rustflags} -C opt-level=2 {debug_assertions}"),
+                );
                 old_rustflags
             }),
         }

From e2646e655e9a45223e388881e302d272930deed5 Mon Sep 17 00:00:00 2001
From: Evan Almloff 
Date: Wed, 27 Dec 2023 10:17:18 -0600
Subject: [PATCH 356/447] fix hydration after suspense

---
 .../fullstack/src/adapters/axum_adapter.rs    |   1 -
 .../interpreter/src/sledgehammer_bindings.rs  |   9 +-
 packages/ssr/src/cache.rs                     |  22 ++--
 packages/ssr/src/renderer.rs                  |  34 ++---
 packages/ssr/tests/hydration.rs               |  92 ++++++++++++--
 packages/ssr/tests/simple.rs                  |   4 +-
 packages/web/src/dom.rs                       |   3 +-
 packages/web/src/lib.rs                       |  28 +++--
 packages/web/src/rehydrate.rs                 | 116 +++++++++++++++++-
 9 files changed, 250 insertions(+), 59 deletions(-)

diff --git a/packages/fullstack/src/adapters/axum_adapter.rs b/packages/fullstack/src/adapters/axum_adapter.rs
index 41a7c92be..09e6e1aa1 100644
--- a/packages/fullstack/src/adapters/axum_adapter.rs
+++ b/packages/fullstack/src/adapters/axum_adapter.rs
@@ -254,7 +254,6 @@ where
 
     fn register_server_fns(self, server_fn_route: &'static str) -> Self {
         self.register_server_fns_with_handler(server_fn_route, |func| {
-            use crate::layer::Service;
             move |req: Request| {
                 let mut service = crate::server_fn_service(Default::default(), func);
                 async move {
diff --git a/packages/interpreter/src/sledgehammer_bindings.rs b/packages/interpreter/src/sledgehammer_bindings.rs
index fcd72937c..8b44f4486 100644
--- a/packages/interpreter/src/sledgehammer_bindings.rs
+++ b/packages/interpreter/src/sledgehammer_bindings.rs
@@ -123,13 +123,14 @@ mod js {
     export function save_template(nodes, tmpl_id) {
         templates[tmpl_id] = nodes;
     }
-    export function hydrate() {
+    export function hydrate(ids) {
+        console.log("hydrating", ids);
         const hydrateNodes = document.querySelectorAll('[data-node-hydration]');
         for (let i = 0; i < hydrateNodes.length; i++) {
             const hydrateNode = hydrateNodes[i];
             const hydration = hydrateNode.getAttribute('data-node-hydration');
             const split = hydration.split(',');
-            const id = parseInt(split[0]);
+            const id = ids[parseInt(split[0])];
             nodes[id] = hydrateNode;
             console.log("hydrating node", hydrateNode, id);
             if (split.length > 1) {
@@ -155,7 +156,7 @@ mod js {
             const split = id.split('node-id');
             if (split.length > 1) {
                 console.log("hydrating text", currentNode.nextSibling, id);
-                nodes[parseInt(split[1])] = currentNode.nextSibling;
+                nodes[ids[parseInt(split[1])]] = currentNode.nextSibling;
             }
             currentNode = treeWalker.nextNode();
         }
@@ -215,7 +216,7 @@ mod js {
         pub fn save_template(nodes: Vec, tmpl_id: u32);
 
         #[wasm_bindgen]
-        pub fn hydrate();
+        pub fn hydrate(ids: Vec);
 
         #[wasm_bindgen]
         pub fn get_node(id: u32) -> Node;
diff --git a/packages/ssr/src/cache.rs b/packages/ssr/src/cache.rs
index 9adcf395b..11f90058a 100644
--- a/packages/ssr/src/cache.rs
+++ b/packages/ssr/src/cache.rs
@@ -28,9 +28,9 @@ pub enum Segment {
     /// A marker for where to insert a dynamic inner html
     InnerHtmlMarker,
     /// A marker for where to insert a node id for an attribute
-    AttributeNodeMarker(usize),
+    AttributeNodeMarker,
     /// A marker for where to insert a node id for a root node
-    RootNodeMarker(usize),
+    RootNodeMarker,
 }
 
 impl std::fmt::Write for StringChain {
@@ -82,7 +82,7 @@ impl StringCache {
                 // we need to collect the inner html and write it at the end
                 let mut inner_html = None;
                 // we need to keep track of if we have dynamic attrs to know if we need to insert a style and inner_html marker
-                let mut last_dyn_attr_id = None;
+                let mut has_dyn_attrs = false;
                 for attr in *attrs {
                     match attr {
                         TemplateAttribute::Static {
@@ -105,7 +105,7 @@ impl StringCache {
                         TemplateAttribute::Dynamic { id: index } => {
                             let index = *index;
                             chain.segments.push(Segment::Attr(index));
-                            last_dyn_attr_id = Some(index);
+                            has_dyn_attrs = true
                         }
                     }
                 }
@@ -120,21 +120,19 @@ impl StringCache {
                         inside_style_tag: true,
                     });
                     write!(chain, "\"")?;
-                } else if last_dyn_attr_id.is_some() {
+                } else if has_dyn_attrs {
                     chain.segments.push(Segment::StyleMarker {
                         inside_style_tag: false,
                     });
                 }
 
                 // write the id if we are prerendering and this is either a root node or a node with a dynamic attribute
-                if prerender {
+                if prerender && (has_dyn_attrs || is_root) {
                     write!(chain, " data-node-hydration=\"")?;
-                    if let Some(last_dyn_attr_id) = last_dyn_attr_id {
-                        chain
-                            .segments
-                            .push(Segment::AttributeNodeMarker(last_dyn_attr_id));
+                    if has_dyn_attrs {
+                        chain.segments.push(Segment::AttributeNodeMarker);
                     } else if is_root {
-                        chain.segments.push(Segment::RootNodeMarker(root_idx));
+                        chain.segments.push(Segment::RootNodeMarker);
                     }
                     write!(chain, "\"")?;
                 }
@@ -146,7 +144,7 @@ impl StringCache {
                     // Write the static inner html, or insert a marker if dynamic inner html is possible
                     if let Some(inner_html) = inner_html {
                         chain.write_str(inner_html)?;
-                    } else if last_dyn_attr_id.is_some() {
+                    } else if has_dyn_attrs {
                         chain.segments.push(Segment::InnerHtmlMarker);
                     }
 
diff --git a/packages/ssr/src/renderer.rs b/packages/ssr/src/renderer.rs
index 87c882cde..9b0d9e7bb 100644
--- a/packages/ssr/src/renderer.rs
+++ b/packages/ssr/src/renderer.rs
@@ -28,6 +28,9 @@ pub struct Renderer {
 
     /// A cache of templates that have been rendered
     template_cache: HashMap<&'static str, Arc>,
+
+    /// The current dynamic node id for hydration
+    dynamic_node_id: usize,
 }
 
 impl Renderer {
@@ -54,6 +57,7 @@ impl Renderer {
         // We should never ever run into async or errored nodes in SSR
         // Error boundaries and suspense boundaries will convert these to sync
         if let RenderReturn::Ready(node) = dom.get_scope(scope).unwrap().root_node() {
+            self.dynamic_node_id = 0;
             self.render_template(buf, dom, node)?
         };
 
@@ -127,10 +131,8 @@ impl Renderer {
                     DynamicNode::Text(text) => {
                         // in SSR, we are concerned that we can't hunt down the right text node since they might get merged
                         if self.pre_render {
-                            let node_id = text
-                                .mounted_element()
-                                .expect("Text nodes must be mounted before rendering");
-                            write!(buf, "", node_id.0)?;
+                            write!(buf, "", self.dynamic_node_id)?;
+                            self.dynamic_node_id += 1;
                         }
 
                         write!(
@@ -149,12 +151,14 @@ impl Renderer {
                         }
                     }
 
-                    DynamicNode::Placeholder(el) => {
+                    DynamicNode::Placeholder(_) => {
                         if self.pre_render {
-                            let id = el
-                                .mounted_element()
-                                .expect("Elements must be mounted before rendering");
-                            write!(buf, "
", id.0)?;
+                            write!(
+                                buf,
+                                "
",
+                                self.dynamic_node_id
+                            )?;
+                            self.dynamic_node_id += 1;
                         }
                     }
                 },
@@ -194,10 +198,10 @@ impl Renderer {
                     }
                 }
 
-                Segment::AttributeNodeMarker(idx) => {
-                    let id = template.dynamic_attrs[*idx].mounted_element();
+                Segment::AttributeNodeMarker => {
                     // first write the id
-                    write!(buf, "{}", id.0)?;
+                    write!(buf, "{}", self.dynamic_node_id)?;
+                    self.dynamic_node_id += 1;
                     // then write any listeners
                     for name in accumulated_listeners.drain(..) {
                         write!(buf, ",{}:", &name[2..])?;
@@ -205,9 +209,9 @@ impl Renderer {
                     }
                 }
 
-                Segment::RootNodeMarker(idx) => {
-                    let id = template.root_ids.borrow()[*idx];
-                    write!(buf, "{}", id.0)?;
+                Segment::RootNodeMarker => {
+                    write!(buf, "{}", self.dynamic_node_id)?;
+                    self.dynamic_node_id += 1
                 }
             }
         }
diff --git a/packages/ssr/tests/hydration.rs b/packages/ssr/tests/hydration.rs
index 736a1435b..360aa0c5f 100644
--- a/packages/ssr/tests/hydration.rs
+++ b/packages/ssr/tests/hydration.rs
@@ -11,7 +11,7 @@ fn root_ids() {
 
     assert_eq!(
         dioxus_ssr::pre_render(&dom),
-        r#"
"#
+        r#"
"#
     );
 }
 
@@ -29,7 +29,7 @@ fn dynamic_attributes() {
 
     assert_eq!(
         dioxus_ssr::pre_render(&dom),
-        r#"
"#
+        r#"
"#
     );
 }
 
@@ -46,7 +46,7 @@ fn listeners() {
 
     assert_eq!(
         dioxus_ssr::pre_render(&dom),
-        r#"
"#
+        r#"
"#
     );
 
     fn app2(cx: Scope) -> Element {
@@ -61,7 +61,7 @@ fn listeners() {
 
     assert_eq!(
         dioxus_ssr::pre_render(&dom),
-        r#"
"#
+        r#"
"#
     );
 }
 
@@ -79,7 +79,7 @@ fn text_nodes() {
 
     assert_eq!(
         dioxus_ssr::pre_render(&dom),
-        r#"
hello
"#
+        r#"
hello
"#
     );
 
     fn app2(cx: Scope) -> Element {
@@ -94,7 +94,85 @@ fn text_nodes() {
 
     assert_eq!(
         dioxus_ssr::pre_render(&dom),
-        r#"
1231234
"#
+        r#"
1231234
"#
+    );
+}
+
+#[test]
+fn components_hydrate() {
+    fn app(cx: Scope) -> Element {
+        render! { Child {} }
+    }
+
+    fn Child(cx: Scope) -> Element {
+        render! { div { "hello" } }
+    }
+
+    let mut dom = VirtualDom::new(app);
+    _ = dom.rebuild();
+
+    assert_eq!(
+        dioxus_ssr::pre_render(&dom),
+        r#"
hello
"#
+    );
+
+    fn app2(cx: Scope) -> Element {
+        render! { Child2 {} }
+    }
+
+    fn Child2(cx: Scope) -> Element {
+        let dyn_text = "hello";
+        render! {
+            div { dyn_text }
+        }
+    }
+
+    let mut dom = VirtualDom::new(app2);
+    _ = dom.rebuild();
+
+    assert_eq!(
+        dioxus_ssr::pre_render(&dom),
+        r#"
hello
"#
+    );
+
+    fn app3(cx: Scope) -> Element {
+        render! { Child3 {} }
+    }
+
+    fn Child3(cx: Scope) -> Element {
+        render! { div { width: "{1}" } }
+    }
+
+    let mut dom = VirtualDom::new(app3);
+    _ = dom.rebuild();
+
+    assert_eq!(
+        dioxus_ssr::pre_render(&dom),
+        r#"
"#
+    );
+
+    fn app4(cx: Scope) -> Element {
+        render! { Child4 {} }
+    }
+
+    fn Child4(cx: Scope) -> Element {
+        render! {
+            for _ in 0..2 {
+                render! {
+                    render! {
+                        "{1}"
+                    }
+                }
+            }
+        }
+    }
+
+    let mut dom = VirtualDom::new(app4);
+    _ = dom.rebuild();
+
+    assert_eq!(
+        dioxus_ssr::pre_render(&dom),
+        r#"11"#
     );
 }
 
@@ -115,6 +193,6 @@ fn hello_world_hydrates() {
 
     assert_eq!(
         dioxus_ssr::pre_render(&dom),
-        r#"
High-Five counter: 0
"#
+        r#"
High-Five counter: 0
"#
     );
 }
diff --git a/packages/ssr/tests/simple.rs b/packages/ssr/tests/simple.rs
index cdf186a80..a9034df9b 100644
--- a/packages/ssr/tests/simple.rs
+++ b/packages/ssr/tests/simple.rs
@@ -47,9 +47,7 @@ fn dynamic() {
 fn components() {
     #[component]
     fn MyComponent(cx: Scope, name: i32) -> Element {
-        render! {
-            div { "component {name}" }
-        }
+        render! { div { "component {name}" } }
     }
 
     assert_eq!(
diff --git a/packages/web/src/dom.rs b/packages/web/src/dom.rs
index b8e9255f7..bcf2065ec 100644
--- a/packages/web/src/dom.rs
+++ b/packages/web/src/dom.rs
@@ -1,11 +1,10 @@
 //! Implementation of a renderer for Dioxus on the web.
 //!
 //! Oustanding todos:
-//! - Removing event listeners (delegation)
 //! - Passive event listeners
 //! - no-op event listener patch for safari
 //! - tests to ensure dyn_into works for various event types.
-//! - Partial delegation?>
+//! - Partial delegation?
 
 use dioxus_core::{
     BorrowedAttributeValue, ElementId, Mutation, Template, TemplateAttribute, TemplateNode,
diff --git a/packages/web/src/lib.rs b/packages/web/src/lib.rs
index 9b80dc325..3d8ecf03f 100644
--- a/packages/web/src/lib.rs
+++ b/packages/web/src/lib.rs
@@ -215,21 +215,23 @@ pub async fn run_with_props(root: fn(Scope) -> Element, root_prop
             // todo: we need to split rebuild and initialize into two phases
             // it's a waste to produce edits just to get the vdom loaded
 
-            let mutations = dom.rebuild();
-            web_sys::console::log_1(&format!("mutations: {:#?}", mutations).into());
-            let templates = mutations.templates;
-            websys_dom.load_templates(&templates);
-            websys_dom.interpreter.flush();
-            websys_dom.rehydrate();
-            // if !true {
-            //     tracing::error!("Rehydration failed. Rebuild DOM into element from scratch");
-            //     websys_dom.root.set_text_content(None);
+            {
+                let mutations = dom.rebuild();
+                web_sys::console::log_1(&format!("mutations: {:#?}", mutations).into());
+                let templates = mutations.templates;
+                websys_dom.load_templates(&templates);
+                websys_dom.interpreter.flush();
+            }
+            if let Err(err) = websys_dom.rehydrate(&dom) {
+                tracing::error!("Rehydration failed. {:?}", err);
+                tracing::error!("Rebuild DOM into element from scratch");
+                websys_dom.root.set_text_content(None);
 
-            //     let edits = dom.rebuild();
+                let edits = dom.rebuild();
 
-            //     websys_dom.load_templates(&edits.templates);
-            //     websys_dom.apply_edits(edits.edits);
-            // }
+                websys_dom.load_templates(&edits.templates);
+                websys_dom.apply_edits(edits.edits);
+            }
         }
     } else {
         let edits = dom.rebuild();
diff --git a/packages/web/src/rehydrate.rs b/packages/web/src/rehydrate.rs
index e151bb13f..2c67cd544 100644
--- a/packages/web/src/rehydrate.rs
+++ b/packages/web/src/rehydrate.rs
@@ -6,10 +6,122 @@ use dioxus_html::event_bubbles;
 use wasm_bindgen::JsCast;
 use web_sys::{Comment, Node};
 
+#[derive(Debug)]
+pub enum RehydrationError {
+    VNodeNotInitialized,
+}
+
+use RehydrationError::*;
+
 impl WebsysDom {
     // we're streaming in patches, but the nodes already exist
     // so we're just going to write the correct IDs to the node and load them in
-    pub fn rehydrate(&mut self) {
-        dioxus_interpreter_js::hydrate()
+    pub fn rehydrate(&mut self, dom: &VirtualDom) -> Result<(), RehydrationError> {
+        let root_scope = dom.base_scope();
+        let mut ids = Vec::new();
+
+        // Recursively rehydrate the dom from the VirtualDom
+        self.rehydrate_scope(root_scope, dom, &mut ids)?;
+
+        dioxus_interpreter_js::hydrate(ids);
+
+        Ok(())
+    }
+
+    fn rehydrate_scope(
+        &mut self,
+        scope: &ScopeState,
+        dom: &VirtualDom,
+        ids: &mut Vec,
+    ) -> Result<(), RehydrationError> {
+        let vnode = match scope.root_node() {
+            dioxus_core::RenderReturn::Ready(ready) => ready,
+            _ => return Err(VNodeNotInitialized),
+        };
+        self.rehydrate_vnode(dom, vnode, ids)
+    }
+
+    fn rehydrate_vnode(
+        &mut self,
+        dom: &VirtualDom,
+        vnode: &VNode,
+        ids: &mut Vec,
+    ) -> Result<(), RehydrationError> {
+        for (i, root) in vnode.template.get().roots.iter().enumerate() {
+            self.rehydrate_template_node(
+                dom,
+                vnode,
+                root,
+                ids,
+                Some(*vnode.root_ids.borrow().get(i).ok_or(VNodeNotInitialized)?),
+            )?;
+        }
+        Ok(())
+    }
+
+    fn rehydrate_template_node(
+        &mut self,
+        dom: &VirtualDom,
+        vnode: &VNode,
+        node: &TemplateNode,
+        ids: &mut Vec,
+        root_id: Option,
+    ) -> Result<(), RehydrationError> {
+        tracing::trace!("rehydrate template node: {:?}", node);
+        match node {
+            TemplateNode::Element {
+                children, attrs, ..
+            } => {
+                let mut mounted_id = root_id;
+                for attr in *attrs {
+                    if let dioxus_core::TemplateAttribute::Dynamic { id } = attr {
+                        let attribute = &vnode.dynamic_attrs[*id];
+                        let value = &attribute.value;
+                        let id = attribute.mounted_element();
+                        mounted_id = Some(id);
+                    }
+                }
+                if let Some(id) = mounted_id {
+                    ids.push(id.0 as u32);
+                }
+                if !children.is_empty() {
+                    for child in *children {
+                        self.rehydrate_template_node(dom, vnode, child, ids, None)?;
+                    }
+                }
+            }
+            TemplateNode::Dynamic { id } | TemplateNode::DynamicText { id } => {
+                self.rehydrate_dynamic_node(dom, &vnode.dynamic_nodes[*id], ids)?;
+            }
+            _ => {}
+        }
+        Ok(())
+    }
+
+    fn rehydrate_dynamic_node(
+        &mut self,
+        dom: &VirtualDom,
+        dynamic: &DynamicNode,
+        ids: &mut Vec,
+    ) -> Result<(), RehydrationError> {
+        tracing::trace!("rehydrate dynamic node: {:?}", dynamic);
+        match dynamic {
+            dioxus_core::DynamicNode::Text(text) => {
+                ids.push(text.mounted_element().ok_or(VNodeNotInitialized)?.0 as u32);
+            }
+            dioxus_core::DynamicNode::Placeholder(placeholder) => {
+                ids.push(placeholder.mounted_element().ok_or(VNodeNotInitialized)?.0 as u32);
+            }
+            dioxus_core::DynamicNode::Component(comp) => {
+                let scope = comp.mounted_scope().ok_or(VNodeNotInitialized)?;
+                self.rehydrate_scope(dom.get_scope(scope).ok_or(VNodeNotInitialized)?, dom, ids)?;
+            }
+            dioxus_core::DynamicNode::Fragment(fragment) => {
+                for vnode in *fragment {
+                    self.rehydrate_vnode(dom, vnode, ids)?;
+                }
+            }
+        }
+        Ok(())
     }
 }

From 9e9b7a2459b4b40b47cc265e5211865d9171ead1 Mon Sep 17 00:00:00 2001
From: Evan Almloff 
Date: Wed, 27 Dec 2023 10:23:56 -0600
Subject: [PATCH 357/447] fix clippy

---
 packages/core/tests/suspense.rs | 2 +-
 packages/ssr/tests/hydration.rs | 1 +
 packages/web/src/rehydrate.rs   | 6 +-----
 3 files changed, 3 insertions(+), 6 deletions(-)

diff --git a/packages/core/tests/suspense.rs b/packages/core/tests/suspense.rs
index abce7f8a6..1a7ab3d58 100644
--- a/packages/core/tests/suspense.rs
+++ b/packages/core/tests/suspense.rs
@@ -11,7 +11,7 @@ fn it_works() {
             let mut dom = VirtualDom::new(app);
             _ = dom.rebuild();
             dom.wait_for_suspense().await;
-            let out = dioxus_ssr::pre_render(&dom);
+            let out = dioxus_ssr::render(&dom);
 
             assert_eq!(out, "
Waiting for... child
");
 
diff --git a/packages/ssr/tests/hydration.rs b/packages/ssr/tests/hydration.rs
index 360aa0c5f..8c9e9f5c8 100644
--- a/packages/ssr/tests/hydration.rs
+++ b/packages/ssr/tests/hydration.rs
@@ -98,6 +98,7 @@ fn text_nodes() {
     );
 }
 
+#[allow(non_snake_case)]
 #[test]
 fn components_hydrate() {
     fn app(cx: Scope) -> Element {
diff --git a/packages/web/src/rehydrate.rs b/packages/web/src/rehydrate.rs
index 2c67cd544..84f92ac19 100644
--- a/packages/web/src/rehydrate.rs
+++ b/packages/web/src/rehydrate.rs
@@ -1,10 +1,7 @@
 use crate::dom::WebsysDom;
 use dioxus_core::{
-    AttributeValue, DynamicNode, ElementId, ScopeState, TemplateNode, VNode, VirtualDom,
+     DynamicNode, ElementId, ScopeState, TemplateNode, VNode, VirtualDom,
 };
-use dioxus_html::event_bubbles;
-use wasm_bindgen::JsCast;
-use web_sys::{Comment, Node};
 
 #[derive(Debug)]
 pub enum RehydrationError {
@@ -76,7 +73,6 @@ impl WebsysDom {
                 for attr in *attrs {
                     if let dioxus_core::TemplateAttribute::Dynamic { id } = attr {
                         let attribute = &vnode.dynamic_attrs[*id];
-                        let value = &attribute.value;
                         let id = attribute.mounted_element();
                         mounted_id = Some(id);
                     }

From b7aea9653f9ad4a6448ce3c7eda4a48cea6ecfcc Mon Sep 17 00:00:00 2001
From: Evan Almloff 
Date: Wed, 27 Dec 2023 10:25:42 -0600
Subject: [PATCH 358/447] fix server cached docs

---
 packages/fullstack/src/hooks/server_cached.rs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/fullstack/src/hooks/server_cached.rs b/packages/fullstack/src/hooks/server_cached.rs
index 519f70dae..827ba22c5 100644
--- a/packages/fullstack/src/hooks/server_cached.rs
+++ b/packages/fullstack/src/hooks/server_cached.rs
@@ -12,9 +12,11 @@ use serde::{de::DeserializeOwned, Serialize};
 /// use dioxus_fullstack::prelude::*;
 ///
 /// fn app(cx: Scope) -> Element {
-///    let state1 = use_state(cx, || from_server(|| {
+///    let state1 = server_cached(cx, || from_server(|| {
 ///       1234
 ///    }));
+///
+///    todo!()
 /// }
 /// ```
 pub fn server_cached(server_fn: impl Fn() -> O) -> O {

From f34053c18f329f682bbad247fc5418b82335a81c Mon Sep 17 00:00:00 2001
From: Evan Almloff 
Date: Wed, 27 Dec 2023 10:32:01 -0600
Subject: [PATCH 359/447] fix formatting

---
 packages/web/src/rehydrate.rs | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/web/src/rehydrate.rs b/packages/web/src/rehydrate.rs
index 84f92ac19..9fa20e56a 100644
--- a/packages/web/src/rehydrate.rs
+++ b/packages/web/src/rehydrate.rs
@@ -1,7 +1,5 @@
 use crate::dom::WebsysDom;
-use dioxus_core::{
-     DynamicNode, ElementId, ScopeState, TemplateNode, VNode, VirtualDom,
-};
+use dioxus_core::{DynamicNode, ElementId, ScopeState, TemplateNode, VNode, VirtualDom};
 
 #[derive(Debug)]
 pub enum RehydrationError {

From f7881aa1f0b6b51725498b9723eed64f29488dc5 Mon Sep 17 00:00:00 2001
From: Evan Almloff 
Date: Fri, 29 Dec 2023 09:46:58 -0600
Subject: [PATCH 360/447] fix some merge conflicts

---
 packages/cli/src/cli/build.rs            | 10 +++++-----
 packages/cli/src/server/fullstack/mod.rs |  8 ++++----
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/packages/cli/src/cli/build.rs b/packages/cli/src/cli/build.rs
index 00e3deb43..5958d2f03 100644
--- a/packages/cli/src/cli/build.rs
+++ b/packages/cli/src/cli/build.rs
@@ -26,15 +26,15 @@ impl Build {
         crate_config.with_verbose(self.build.verbose);
 
         if self.build.example.is_some() {
-            crate_config.as_example(self.build.example.unwrap());
+            crate_config.as_example(self.build.example.clone().unwrap());
         }
 
         if self.build.profile.is_some() {
-            crate_config.set_profile(self.build.profile.unwrap());
+            crate_config.set_profile(self.build.profile.clone().unwrap());
         }
 
         if self.build.features.is_some() {
-            crate_config.set_features(self.build.features.unwrap());
+            crate_config.set_features(self.build.features.clone().unwrap());
         }
 
         let platform = self
@@ -57,6 +57,7 @@ impl Build {
                 let _config = WebAssetConfigDropGuard::new();
                 {
                     let mut web_config = crate_config.clone();
+                    let _gaurd = FullstackWebEnvGuard::new(&self.build);
                     let web_feature = self.build.client_feature;
                     let features = &mut web_config.features;
                     match features {
@@ -65,7 +66,6 @@ impl Build {
                         }
                         None => web_config.features = Some(vec![web_feature]),
                     };
-                    let _gaurd = FullstackWebEnvGuard::new(self.build.debug);
                     crate::builder::build(&crate_config, false, self.build.skip_assets)?;
                 }
                 {
@@ -78,7 +78,7 @@ impl Build {
                         }
                         None => desktop_config.features = Some(vec![desktop_feature]),
                     };
-                    let _gaurd = FullstackServerEnvGuard::new(self.build.debug);
+                    let _gaurd = FullstackServerEnvGuard::new(self.build.debug, self.build.release);
                     crate::builder::build_desktop(&desktop_config, false, self.build.skip_assets)?;
                 }
             }
diff --git a/packages/cli/src/server/fullstack/mod.rs b/packages/cli/src/server/fullstack/mod.rs
index abe4fe82d..f41d0e263 100644
--- a/packages/cli/src/server/fullstack/mod.rs
+++ b/packages/cli/src/server/fullstack/mod.rs
@@ -66,7 +66,7 @@ impl Platform for FullstackPlatform {
                 }
                 None => desktop_config.features = Some(vec![desktop_feature]),
             };
-            let _gaurd = FullstackServerEnvGuard::new(&self.serve);
+            let _gaurd = FullstackServerEnvGuard::new(self.serve.debug, self.serve.release);
             self.desktop.rebuild(&desktop_config)
         };
         thread_handle
@@ -136,11 +136,11 @@ pub(crate) struct FullstackServerEnvGuard {
 }
 
 impl FullstackServerEnvGuard {
-    pub fn new(debug_mode: bool, release_mode: bool) -> Self {
+    pub fn new(debug: bool, release: bool) -> Self {
         Self {
-            old_rustflags: (!debug_mode).then(|| {
+            old_rustflags: (!debug).then(|| {
                 let old_rustflags = std::env::var("RUSTFLAGS").unwrap_or_default();
-                let debug_assertions = if serve.release {
+                let debug_assertions = if release {
                     ""
                 } else {
                     " -C debug-assertions"

From 1acfd46b0b768fa5aaf7e51e563fd09db86452e3 Mon Sep 17 00:00:00 2001
From: Evan Almloff 
Date: Fri, 29 Dec 2023 10:08:10 -0600
Subject: [PATCH 361/447] fix formatting

---
 packages/cli/src/server/fullstack/mod.rs | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/packages/cli/src/server/fullstack/mod.rs b/packages/cli/src/server/fullstack/mod.rs
index f41d0e263..4a787783f 100644
--- a/packages/cli/src/server/fullstack/mod.rs
+++ b/packages/cli/src/server/fullstack/mod.rs
@@ -140,11 +140,7 @@ impl FullstackServerEnvGuard {
         Self {
             old_rustflags: (!debug).then(|| {
                 let old_rustflags = std::env::var("RUSTFLAGS").unwrap_or_default();
-                let debug_assertions = if release {
-                    ""
-                } else {
-                    " -C debug-assertions"
-                };
+                let debug_assertions = if release { "" } else { " -C debug-assertions" };
 
                 std::env::set_var(
                     "RUSTFLAGS",

From d88a66287706b74496e5c788b38608d4acfe6b60 Mon Sep 17 00:00:00 2001
From: Evan Almloff 
Date: Fri, 29 Dec 2023 11:11:39 -0600
Subject: [PATCH 362/447] Rename --debug to --force-debug and improve docs

---
 packages/cli/src/cli/build.rs            |  3 ++-
 packages/cli/src/cli/cfg.rs              | 10 +++++-----
 packages/cli/src/server/fullstack/mod.rs |  4 ++--
 3 files changed, 9 insertions(+), 8 deletions(-)

diff --git a/packages/cli/src/cli/build.rs b/packages/cli/src/cli/build.rs
index 5958d2f03..f623378cd 100644
--- a/packages/cli/src/cli/build.rs
+++ b/packages/cli/src/cli/build.rs
@@ -78,7 +78,8 @@ impl Build {
                         }
                         None => desktop_config.features = Some(vec![desktop_feature]),
                     };
-                    let _gaurd = FullstackServerEnvGuard::new(self.build.debug, self.build.release);
+                    let _gaurd =
+                        FullstackServerEnvGuard::new(self.build.force_debug, self.build.release);
                     crate::builder::build_desktop(&desktop_config, false, self.build.skip_assets)?;
                 }
             }
diff --git a/packages/cli/src/cli/cfg.rs b/packages/cli/src/cli/cfg.rs
index 6416084d2..4c379f3e9 100644
--- a/packages/cli/src/cli/cfg.rs
+++ b/packages/cli/src/cli/cfg.rs
@@ -15,10 +15,10 @@ pub struct ConfigOptsBuild {
     #[serde(default)]
     pub release: bool,
 
-    /// Build with all debug info [default: false]
+    /// This flag only applies to fullstack builds. By default fullstack builds will run with something in between debug and release mode. This flag will force the build to run in debug mode. [default: false]
     #[clap(long)]
     #[serde(default)]
-    pub debug: bool,
+    pub force_debug: bool,
 
     // Use verbose output [default: false]
     #[clap(long)]
@@ -68,7 +68,7 @@ impl From for ConfigOptsBuild {
             client_feature: serve.client_feature,
             server_feature: serve.server_feature,
             skip_assets: serve.skip_assets,
-            debug: serve.debug,
+            force_debug: serve.force_debug,
         }
     }
 }
@@ -98,10 +98,10 @@ pub struct ConfigOptsServe {
     #[serde(default)]
     pub release: bool,
 
-    /// Build with all debug info [default: false]
+    /// This flag only applies to fullstack builds. By default fullstack builds will run with something in between debug and release mode. This flag will force the build to run in debug mode. [default: false]
     #[clap(long)]
     #[serde(default)]
-    pub debug: bool,
+    pub force_debug: bool,
 
     // Use verbose output [default: false]
     #[clap(long)]
diff --git a/packages/cli/src/server/fullstack/mod.rs b/packages/cli/src/server/fullstack/mod.rs
index 4a787783f..fa9c77459 100644
--- a/packages/cli/src/server/fullstack/mod.rs
+++ b/packages/cli/src/server/fullstack/mod.rs
@@ -66,7 +66,7 @@ impl Platform for FullstackPlatform {
                 }
                 None => desktop_config.features = Some(vec![desktop_feature]),
             };
-            let _gaurd = FullstackServerEnvGuard::new(self.serve.debug, self.serve.release);
+            let _gaurd = FullstackServerEnvGuard::new(self.serve.force_debug, self.serve.release);
             self.desktop.rebuild(&desktop_config)
         };
         thread_handle
@@ -101,7 +101,7 @@ pub(crate) struct FullstackWebEnvGuard {
 impl FullstackWebEnvGuard {
     pub fn new(serve: &ConfigOptsBuild) -> Self {
         Self {
-            old_rustflags: (!serve.debug).then(|| {
+            old_rustflags: (!serve.force_debug).then(|| {
                 let old_rustflags = std::env::var("RUSTFLAGS").unwrap_or_default();
                 let debug_assertions = if serve.release {
                     ""

From 1683ec8a7236088530bd06e267cb93803aaf80ee Mon Sep 17 00:00:00 2001
From: Evan Almloff 
Date: Fri, 29 Dec 2023 14:36:18 -0600
Subject: [PATCH 363/447] introduce RAIIChild to drop the child process for
 desktop even when the exit is not planned

---
 packages/cli/src/server/desktop/mod.rs | 17 ++++++++++++-----
 packages/web/src/lib.rs                |  7 -------
 2 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/packages/cli/src/server/desktop/mod.rs b/packages/cli/src/server/desktop/mod.rs
index fe78240b4..361d110c5 100644
--- a/packages/cli/src/server/desktop/mod.rs
+++ b/packages/cli/src/server/desktop/mod.rs
@@ -210,7 +210,7 @@ fn send_msg(msg: HotReloadMsg, channel: &mut impl std::io::Write) -> bool {
     }
 }
 
-fn start_desktop(config: &CrateConfig, skip_assets: bool) -> Result<(Child, BuildResult)> {
+fn start_desktop(config: &CrateConfig, skip_assets: bool) -> Result<(RAIIChild, BuildResult)> {
     // Run the desktop application
     let result = crate::builder::build_desktop(config, true, skip_assets)?;
 
@@ -223,9 +223,9 @@ fn start_desktop(config: &CrateConfig, skip_assets: bool) -> Result<(Child, Buil
                 file.set_extension("exe");
             }
             let active = "DIOXUS_ACTIVE";
-            let child = Command::new(file.to_str().unwrap())
+            let child = RAIIChild(Command::new(file.to_str().unwrap())
                 .env(active, "true")
-                .spawn()?;
+                .spawn()?);
 
             Ok((child, result))
         }
@@ -233,7 +233,7 @@ fn start_desktop(config: &CrateConfig, skip_assets: bool) -> Result<(Child, Buil
 }
 
 pub(crate) struct DesktopPlatform {
-    currently_running_child: Child,
+    currently_running_child: RAIIChild,
     skip_assets: bool,
 }
 
@@ -261,9 +261,16 @@ impl Platform for DesktopPlatform {
     }
 
     fn rebuild(&mut self, config: &CrateConfig) -> Result {
-        self.currently_running_child.kill()?;
         let (child, result) = start_desktop(config, self.skip_assets)?;
         self.currently_running_child = child;
         Ok(result)
     }
 }
+
+struct RAIIChild(Child);
+
+impl Drop for RAIIChild {
+    fn drop(&mut self) {
+        let _ = self.0.kill();
+    }
+}
\ No newline at end of file
diff --git a/packages/web/src/lib.rs b/packages/web/src/lib.rs
index 30a2952fa..46858b131 100644
--- a/packages/web/src/lib.rs
+++ b/packages/web/src/lib.rs
@@ -252,13 +252,6 @@ pub async fn run_with_props(root: fn(Scope) -> Element, root_prop
             pin_mut!(work);
 
             #[cfg(all(feature = "hot_reload", debug_assertions))]
-            // futures_util::select! {
-            //     _ = work => (None, None),
-            //     new_template = hotreload_rx.next() => {
-            //         (None, new_template)
-            //     }
-            //     evt = rx.next() =>
-            // }
             match select(work, select(hotreload_rx.next(), rx.next())).await {
                 Either::Left((_, _)) => (None, None),
                 Either::Right((Either::Left((new_template, _)), _)) => (None, new_template),

From 49be972507ad2b3b5641914e89b6ad5e45f8a2a3 Mon Sep 17 00:00:00 2001
From: Evan Almloff 
Date: Fri, 29 Dec 2023 15:20:30 -0600
Subject: [PATCH 364/447] make dx clean clean the new .dioxus directory

---
 packages/cli/src/cli/clean.rs          |  6 ++++++
 packages/cli/src/server/desktop/mod.rs | 10 ++++++----
 2 files changed, 12 insertions(+), 4 deletions(-)

diff --git a/packages/cli/src/cli/clean.rs b/packages/cli/src/cli/clean.rs
index 5fed1e1a6..9a0f0d4fb 100644
--- a/packages/cli/src/cli/clean.rs
+++ b/packages/cli/src/cli/clean.rs
@@ -28,6 +28,12 @@ impl Clean {
             remove_dir_all(crate_config.crate_dir.join(&out_dir))?;
         }
 
+        let fullstack_out_dir = crate_config.crate_dir.join(".dioxus");
+
+        if fullstack_out_dir.is_dir() {
+            remove_dir_all(fullstack_out_dir)?;
+        }
+
         Ok(())
     }
 }
diff --git a/packages/cli/src/server/desktop/mod.rs b/packages/cli/src/server/desktop/mod.rs
index 361d110c5..62be45019 100644
--- a/packages/cli/src/server/desktop/mod.rs
+++ b/packages/cli/src/server/desktop/mod.rs
@@ -223,9 +223,11 @@ fn start_desktop(config: &CrateConfig, skip_assets: bool) -> Result<(RAIIChild,
                 file.set_extension("exe");
             }
             let active = "DIOXUS_ACTIVE";
-            let child = RAIIChild(Command::new(file.to_str().unwrap())
-                .env(active, "true")
-                .spawn()?);
+            let child = RAIIChild(
+                Command::new(file.to_str().unwrap())
+                    .env(active, "true")
+                    .spawn()?,
+            );
 
             Ok((child, result))
         }
@@ -273,4 +275,4 @@ impl Drop for RAIIChild {
     fn drop(&mut self) {
         let _ = self.0.kill();
     }
-}
\ No newline at end of file
+}

From ab79c00cd89e04aedcabadc38998f19cbfa96c56 Mon Sep 17 00:00:00 2001
From: Evan Almloff 
Date: Fri, 29 Dec 2023 16:07:44 -0600
Subject: [PATCH 365/447] kill the fullstack server before starting another one

---
 packages/cli/src/server/desktop/mod.rs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/cli/src/server/desktop/mod.rs b/packages/cli/src/server/desktop/mod.rs
index 62be45019..4051f2199 100644
--- a/packages/cli/src/server/desktop/mod.rs
+++ b/packages/cli/src/server/desktop/mod.rs
@@ -263,6 +263,7 @@ impl Platform for DesktopPlatform {
     }
 
     fn rebuild(&mut self, config: &CrateConfig) -> Result {
+        self.currently_running_child.0.kill()?;
         let (child, result) = start_desktop(config, self.skip_assets)?;
         self.currently_running_child = child;
         Ok(result)

From 451d935aa2cadbf0c681b6296b89d7220feda4d2 Mon Sep 17 00:00:00 2001
From: tigerros 
Date: Sat, 30 Dec 2023 01:18:50 +0100
Subject: [PATCH 366/447] fix typo (#1759)

---
 packages/core/src/lazynodes.rs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/core/src/lazynodes.rs b/packages/core/src/lazynodes.rs
index 3189086b4..ae1bd2109 100644
--- a/packages/core/src/lazynodes.rs
+++ b/packages/core/src/lazynodes.rs
@@ -18,7 +18,7 @@ use crate::{innerlude::VNode, ScopeState};
 
 /// A concrete type provider for closures that build [`VNode`] structures.
 ///
-/// This struct wraps lazy structs that build [`VNode`] trees Normally, we cannot perform a blanket implementation over
+/// This struct wraps lazy structs that build [`VNode`] trees. Normally, we cannot perform a blanket implementation over
 /// closures, but if we wrap the closure in a concrete type, we can use it for different branches in matching.
 ///
 ///

From 15dff7ad55388e90f057a1b90d372facf8927ce7 Mon Sep 17 00:00:00 2001
From: Evan Almloff 
Date: Sat, 30 Dec 2023 11:58:09 -0600
Subject: [PATCH 367/447] delete a leftover dioxusin file on all unix operating
 systems, not just mac

---
 packages/cli/src/server/desktop/mod.rs  | 2 +-
 packages/hot-reload/src/file_watcher.rs | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/cli/src/server/desktop/mod.rs b/packages/cli/src/server/desktop/mod.rs
index 4051f2199..34f85a312 100644
--- a/packages/cli/src/server/desktop/mod.rs
+++ b/packages/cli/src/server/desktop/mod.rs
@@ -185,7 +185,7 @@ async fn start_desktop_hot_reload(hot_reload_state: HotReloadState) -> Result<()
 }
 
 fn clear_paths(file_socket_path: &std::path::Path) {
-    if cfg!(target_os = "macos") {
+    if cfg!(unix) {
         // On unix, if you force quit the application, it can leave the file socket open
         // This will cause the local socket listener to fail to open
         // We check if the file socket is already open from an old session and then delete it
diff --git a/packages/hot-reload/src/file_watcher.rs b/packages/hot-reload/src/file_watcher.rs
index 0323561fe..b3be7de11 100644
--- a/packages/hot-reload/src/file_watcher.rs
+++ b/packages/hot-reload/src/file_watcher.rs
@@ -155,7 +155,7 @@ pub fn init(cfg: Config) {
         let target_dir = crate_dir.join("target");
         let hot_reload_socket_path = target_dir.join("dioxusin");
 
-        #[cfg(target_os = "macos")]
+        #[cfg(unix)]
         {
             // On unix, if you force quit the application, it can leave the file socket open
             // This will cause the local socket listener to fail to open

From 3733fbf47d8da934432778c149073473297f6715 Mon Sep 17 00:00:00 2001
From: Georges KABBOUCHI 
Date: Sat, 30 Dec 2023 21:49:32 +0200
Subject: [PATCH 368/447] feat(liveview): add rocket adapter (#1761)

---
 packages/liveview/Cargo.toml                  | 13 +++-
 packages/liveview/README.md                   |  1 +
 packages/liveview/examples/rocket.rs          | 76 +++++++++++++++++++
 .../liveview/src/adapters/rocket_adapter.rs   | 25 ++++++
 packages/liveview/src/lib.rs                  |  5 ++
 5 files changed, 119 insertions(+), 1 deletion(-)
 create mode 100644 packages/liveview/examples/rocket.rs
 create mode 100644 packages/liveview/src/adapters/rocket_adapter.rs

diff --git a/packages/liveview/Cargo.toml b/packages/liveview/Cargo.toml
index cbd7b75f5..0f35f4ae6 100644
--- a/packages/liveview/Cargo.toml
+++ b/packages/liveview/Cargo.toml
@@ -38,6 +38,10 @@ salvo = { version = "0.44.1", optional = true, features = ["ws"] }
 once_cell = "1.17.1"
 async-trait = "0.1.71"
 
+# rocket
+rocket = { version = "0.5.0", optional = true }
+rocket_ws = { version = "0.1.0", optional = true }
+
 # actix is ... complicated?
 # actix-files = { version = "0.6.2", optional = true }
 # actix-web = { version = "4.2.1", optional = true }
@@ -49,13 +53,16 @@ tokio = { workspace = true, features = ["full"] }
 dioxus = { workspace = true }
 warp = "0.3.3"
 axum = { version = "0.6.1", features = ["ws"] }
-salvo = { version = "0.44.1", features = ["affix", "ws"] }
+# salvo = { version = "0.44.1", features = ["affix", "ws"] }
+rocket = "0.5.0"
+rocket_ws = "0.1.0"
 tower = "0.4.13"
 
 [features]
 default = ["hot-reload"]
 # actix = ["actix-files", "actix-web", "actix-ws"]
 hot-reload = ["dioxus-hot-reload"]
+rocket = ["dep:rocket", "dep:rocket_ws"]
 
 [[example]]
 name = "axum"
@@ -68,3 +75,7 @@ required-features = ["salvo"]
 [[example]]
 name = "warp"
 required-features = ["warp"]
+
+[[example]]
+name = "rocket"
+required-features = ["rocket"]
diff --git a/packages/liveview/README.md b/packages/liveview/README.md
index cbae3c53a..13af3c36f 100644
--- a/packages/liveview/README.md
+++ b/packages/liveview/README.md
@@ -28,6 +28,7 @@ The current backend frameworks supported include:
 - Axum
 - Warp
 - Salvo
+- Rocket
 
 Dioxus-LiveView exports some primitives to wire up an app into an existing backend framework.
 
diff --git a/packages/liveview/examples/rocket.rs b/packages/liveview/examples/rocket.rs
new file mode 100644
index 000000000..8256db7f8
--- /dev/null
+++ b/packages/liveview/examples/rocket.rs
@@ -0,0 +1,76 @@
+#[macro_use]
+extern crate rocket;
+
+use dioxus::prelude::*;
+use dioxus_liveview::LiveViewPool;
+use rocket::response::content::RawHtml;
+use rocket::{Config, Rocket, State};
+use rocket_ws::{Channel, WebSocket};
+
+fn app(cx: Scope) -> Element {
+    let mut num = use_state(cx, || 0);
+
+    cx.render(rsx! {
+        div {
+            "hello Rocket! {num}"
+            button { onclick: move |_| num += 1, "Increment" }
+        }
+    })
+}
+
+fn index_page_with_glue(glue: &str) -> RawHtml {
+    RawHtml(format!(
+        r#"
+        
+        
+             Dioxus LiveView with Rocket  
+             
 
+            {glue}
+        
+        "#,
+        glue = glue
+    ))
+}
+
+#[get("/")]
+async fn index(config: &Config) -> RawHtml {
+    index_page_with_glue(&dioxus_liveview::interpreter_glue(&format!(
+        "ws://{addr}:{port}/ws",
+        addr = config.address,
+        port = config.port,
+    )))
+}
+
+#[get("/as-path")]
+async fn as_path() -> RawHtml {
+    index_page_with_glue(&dioxus_liveview::interpreter_glue("/ws"))
+}
+
+#[get("/ws")]
+fn ws(ws: WebSocket, pool: &State) -> Channel<'static> {
+    let pool = pool.inner().to_owned();
+
+    ws.channel(move |stream| {
+        Box::pin(async move {
+            let _ = pool
+                .launch(dioxus_liveview::rocket_socket(stream), app)
+                .await;
+            Ok(())
+        })
+    })
+}
+
+#[tokio::main]
+async fn main() {
+    let view = dioxus_liveview::LiveViewPool::new();
+
+    Rocket::build()
+        .manage(view)
+        .mount("/", routes![index, as_path, ws])
+        .ignite()
+        .await
+        .expect("Failed to ignite rocket")
+        .launch()
+        .await
+        .expect("Failed to launch rocket");
+}
diff --git a/packages/liveview/src/adapters/rocket_adapter.rs b/packages/liveview/src/adapters/rocket_adapter.rs
new file mode 100644
index 000000000..8a9840bf2
--- /dev/null
+++ b/packages/liveview/src/adapters/rocket_adapter.rs
@@ -0,0 +1,25 @@
+use crate::{LiveViewError, LiveViewSocket};
+use rocket::futures::{SinkExt, StreamExt};
+use rocket_ws::{result::Error, stream::DuplexStream, Message};
+
+/// Convert a rocket websocket into a LiveViewSocket
+///
+/// This is required to launch a LiveView app using the rocket web framework
+pub fn rocket_socket(stream: DuplexStream) -> impl LiveViewSocket {
+    stream
+        .map(transform_rx)
+        .with(transform_tx)
+        .sink_map_err(|_| LiveViewError::SendingFailed)
+}
+
+fn transform_rx(message: Result) -> Result, LiveViewError> {
+    message
+        .map_err(|_| LiveViewError::SendingFailed)?
+        .into_text()
+        .map(|s| s.into_bytes())
+        .map_err(|_| LiveViewError::SendingFailed)
+}
+
+async fn transform_tx(message: Vec) -> Result {
+    Ok(Message::Text(String::from_utf8_lossy(&message).to_string()))
+}
diff --git a/packages/liveview/src/lib.rs b/packages/liveview/src/lib.rs
index 6a2768fd5..40d6186dc 100644
--- a/packages/liveview/src/lib.rs
+++ b/packages/liveview/src/lib.rs
@@ -18,6 +18,11 @@ pub mod adapters {
 
     #[cfg(feature = "salvo")]
     pub use salvo_adapter::*;
+
+    #[cfg(feature = "rocket")]
+    pub mod rocket_adapter;
+    #[cfg(feature = "rocket")]
+    pub use rocket_adapter::*;
 }
 
 pub use adapters::*;

From 0166eafafb20eaf7acdbdd67bae44d037c3870b1 Mon Sep 17 00:00:00 2001
From: Hampus Lidin 
Date: Sat, 30 Dec 2023 20:53:12 +0100
Subject: [PATCH 369/447] Send mount event when hydrating (#1764)

---
 packages/web/src/dom.rs       | 26 +++++++++++++++-----------
 packages/web/src/rehydrate.rs | 19 ++++++++++++++-----
 2 files changed, 29 insertions(+), 16 deletions(-)

diff --git a/packages/web/src/dom.rs b/packages/web/src/dom.rs
index b8e9255f7..22701bf4e 100644
--- a/packages/web/src/dom.rs
+++ b/packages/web/src/dom.rs
@@ -256,17 +256,21 @@ impl WebsysDom {
         i.flush();
 
         for id in to_mount {
-            let node = get_node(id.0 as u32);
-            if let Some(element) = node.dyn_ref::() {
-                let data: MountedData = element.into();
-                let data = Rc::new(data);
-                let _ = self.event_channel.unbounded_send(UiEvent {
-                    name: "mounted".to_string(),
-                    bubbles: false,
-                    element: id,
-                    data,
-                });
-            }
+            self.send_mount_event(id);
+        }
+    }
+
+    pub(crate) fn send_mount_event(&self, id: ElementId) {
+        let node = get_node(id.0 as u32);
+        if let Some(element) = node.dyn_ref::() {
+            let data: MountedData = element.into();
+            let data = Rc::new(data);
+            let _ = self.event_channel.unbounded_send(UiEvent {
+                name: "mounted".to_string(),
+                bubbles: false,
+                element: id,
+                data,
+            });
         }
     }
 }
diff --git a/packages/web/src/rehydrate.rs b/packages/web/src/rehydrate.rs
index 4415ceb37..11c68f89c 100644
--- a/packages/web/src/rehydrate.rs
+++ b/packages/web/src/rehydrate.rs
@@ -125,6 +125,7 @@ impl WebsysDom {
                 children, attrs, ..
             } => {
                 let mut mounted_id = None;
+                let mut should_send_mount_event = true;
                 for attr in *attrs {
                     if let dioxus_core::TemplateAttribute::Dynamic { id } = attr {
                         let attribute = &vnode.dynamic_attrs[*id];
@@ -134,16 +135,24 @@ impl WebsysDom {
                         let name = attribute.name;
                         if let AttributeValue::Listener(_) = value {
                             let event_name = &name[2..];
-                            self.interpreter.new_event_listener(
-                                event_name,
-                                id.0 as u32,
-                                event_bubbles(event_name) as u8,
-                            );
+                            match event_name {
+                                "mounted" => should_send_mount_event = true,
+                                _ => {
+                                    self.interpreter.new_event_listener(
+                                        event_name,
+                                        id.0 as u32,
+                                        event_bubbles(event_name) as u8,
+                                    );
+                                }
+                            }
                         }
                     }
                 }
                 if let Some(id) = mounted_id {
                     set_node(hydrated, id, current_child.clone()?);
+                    if should_send_mount_event {
+                        self.send_mount_event(id);
+                    }
                 }
                 if !children.is_empty() {
                     let mut children_current_child = current_child

From 0a7873fcd0dbde76e9e4dc2869f49b97dc641bb7 Mon Sep 17 00:00:00 2001
From: Evan Almloff 
Date: Sat, 30 Dec 2023 14:12:21 -0600
Subject: [PATCH 370/447] merge upstream

---
 README.md                                     |  2 +-
 packages/core/src/lazynodes.rs                |  2 +-
 packages/liveview/Cargo.toml                  | 13 +++-
 packages/liveview/README.md                   |  1 +
 packages/liveview/examples/rocket.rs          | 76 +++++++++++++++++++
 .../liveview/src/adapters/rocket_adapter.rs   | 25 ++++++
 packages/liveview/src/lib.rs                  |  5 ++
 packages/ssr/src/renderer.rs                  |  5 +-
 packages/web/src/dom.rs                       | 26 ++++---
 packages/web/src/lib.rs                       |  7 --
 packages/web/src/rehydrate.rs                 | 32 ++++++--
 11 files changed, 166 insertions(+), 28 deletions(-)
 create mode 100644 packages/liveview/examples/rocket.rs
 create mode 100644 packages/liveview/src/adapters/rocket_adapter.rs

diff --git a/README.md b/README.md
index d1ec98019..65cd08263 100644
--- a/README.md
+++ b/README.md
@@ -161,7 +161,7 @@ So... Dioxus is great, but why won't it work for me?
 ## Contributing
 - Check out the website [section on contributing](https://dioxuslabs.com/learn/0.4/contributing).
 - Report issues on our [issue tracker](https://github.com/dioxuslabs/dioxus/issues).
-- Join the discord and ask questions!
+- [Join](https://discord.gg/XgGxMSkvUM) the discord and ask questions!
 
 
 
diff --git a/packages/core/src/lazynodes.rs b/packages/core/src/lazynodes.rs
index 3189086b4..ae1bd2109 100644
--- a/packages/core/src/lazynodes.rs
+++ b/packages/core/src/lazynodes.rs
@@ -18,7 +18,7 @@ use crate::{innerlude::VNode, ScopeState};
 
 /// A concrete type provider for closures that build [`VNode`] structures.
 ///
-/// This struct wraps lazy structs that build [`VNode`] trees Normally, we cannot perform a blanket implementation over
+/// This struct wraps lazy structs that build [`VNode`] trees. Normally, we cannot perform a blanket implementation over
 /// closures, but if we wrap the closure in a concrete type, we can use it for different branches in matching.
 ///
 ///
diff --git a/packages/liveview/Cargo.toml b/packages/liveview/Cargo.toml
index cbd7b75f5..0f35f4ae6 100644
--- a/packages/liveview/Cargo.toml
+++ b/packages/liveview/Cargo.toml
@@ -38,6 +38,10 @@ salvo = { version = "0.44.1", optional = true, features = ["ws"] }
 once_cell = "1.17.1"
 async-trait = "0.1.71"
 
+# rocket
+rocket = { version = "0.5.0", optional = true }
+rocket_ws = { version = "0.1.0", optional = true }
+
 # actix is ... complicated?
 # actix-files = { version = "0.6.2", optional = true }
 # actix-web = { version = "4.2.1", optional = true }
@@ -49,13 +53,16 @@ tokio = { workspace = true, features = ["full"] }
 dioxus = { workspace = true }
 warp = "0.3.3"
 axum = { version = "0.6.1", features = ["ws"] }
-salvo = { version = "0.44.1", features = ["affix", "ws"] }
+# salvo = { version = "0.44.1", features = ["affix", "ws"] }
+rocket = "0.5.0"
+rocket_ws = "0.1.0"
 tower = "0.4.13"
 
 [features]
 default = ["hot-reload"]
 # actix = ["actix-files", "actix-web", "actix-ws"]
 hot-reload = ["dioxus-hot-reload"]
+rocket = ["dep:rocket", "dep:rocket_ws"]
 
 [[example]]
 name = "axum"
@@ -68,3 +75,7 @@ required-features = ["salvo"]
 [[example]]
 name = "warp"
 required-features = ["warp"]
+
+[[example]]
+name = "rocket"
+required-features = ["rocket"]
diff --git a/packages/liveview/README.md b/packages/liveview/README.md
index cbae3c53a..13af3c36f 100644
--- a/packages/liveview/README.md
+++ b/packages/liveview/README.md
@@ -28,6 +28,7 @@ The current backend frameworks supported include:
 - Axum
 - Warp
 - Salvo
+- Rocket
 
 Dioxus-LiveView exports some primitives to wire up an app into an existing backend framework.
 
diff --git a/packages/liveview/examples/rocket.rs b/packages/liveview/examples/rocket.rs
new file mode 100644
index 000000000..8256db7f8
--- /dev/null
+++ b/packages/liveview/examples/rocket.rs
@@ -0,0 +1,76 @@
+#[macro_use]
+extern crate rocket;
+
+use dioxus::prelude::*;
+use dioxus_liveview::LiveViewPool;
+use rocket::response::content::RawHtml;
+use rocket::{Config, Rocket, State};
+use rocket_ws::{Channel, WebSocket};
+
+fn app(cx: Scope) -> Element {
+    let mut num = use_state(cx, || 0);
+
+    cx.render(rsx! {
+        div {
+            "hello Rocket! {num}"
+            button { onclick: move |_| num += 1, "Increment" }
+        }
+    })
+}
+
+fn index_page_with_glue(glue: &str) -> RawHtml {
+    RawHtml(format!(
+        r#"
+        
+        
+             Dioxus LiveView with Rocket  
+             
 
+            {glue}
+        
+        "#,
+        glue = glue
+    ))
+}
+
+#[get("/")]
+async fn index(config: &Config) -> RawHtml {
+    index_page_with_glue(&dioxus_liveview::interpreter_glue(&format!(
+        "ws://{addr}:{port}/ws",
+        addr = config.address,
+        port = config.port,
+    )))
+}
+
+#[get("/as-path")]
+async fn as_path() -> RawHtml {
+    index_page_with_glue(&dioxus_liveview::interpreter_glue("/ws"))
+}
+
+#[get("/ws")]
+fn ws(ws: WebSocket, pool: &State) -> Channel<'static> {
+    let pool = pool.inner().to_owned();
+
+    ws.channel(move |stream| {
+        Box::pin(async move {
+            let _ = pool
+                .launch(dioxus_liveview::rocket_socket(stream), app)
+                .await;
+            Ok(())
+        })
+    })
+}
+
+#[tokio::main]
+async fn main() {
+    let view = dioxus_liveview::LiveViewPool::new();
+
+    Rocket::build()
+        .manage(view)
+        .mount("/", routes![index, as_path, ws])
+        .ignite()
+        .await
+        .expect("Failed to ignite rocket")
+        .launch()
+        .await
+        .expect("Failed to launch rocket");
+}
diff --git a/packages/liveview/src/adapters/rocket_adapter.rs b/packages/liveview/src/adapters/rocket_adapter.rs
new file mode 100644
index 000000000..8a9840bf2
--- /dev/null
+++ b/packages/liveview/src/adapters/rocket_adapter.rs
@@ -0,0 +1,25 @@
+use crate::{LiveViewError, LiveViewSocket};
+use rocket::futures::{SinkExt, StreamExt};
+use rocket_ws::{result::Error, stream::DuplexStream, Message};
+
+/// Convert a rocket websocket into a LiveViewSocket
+///
+/// This is required to launch a LiveView app using the rocket web framework
+pub fn rocket_socket(stream: DuplexStream) -> impl LiveViewSocket {
+    stream
+        .map(transform_rx)
+        .with(transform_tx)
+        .sink_map_err(|_| LiveViewError::SendingFailed)
+}
+
+fn transform_rx(message: Result) -> Result, LiveViewError> {
+    message
+        .map_err(|_| LiveViewError::SendingFailed)?
+        .into_text()
+        .map(|s| s.into_bytes())
+        .map_err(|_| LiveViewError::SendingFailed)
+}
+
+async fn transform_tx(message: Vec) -> Result {
+    Ok(Message::Text(String::from_utf8_lossy(&message).to_string()))
+}
diff --git a/packages/liveview/src/lib.rs b/packages/liveview/src/lib.rs
index 6a2768fd5..40d6186dc 100644
--- a/packages/liveview/src/lib.rs
+++ b/packages/liveview/src/lib.rs
@@ -18,6 +18,11 @@ pub mod adapters {
 
     #[cfg(feature = "salvo")]
     pub use salvo_adapter::*;
+
+    #[cfg(feature = "rocket")]
+    pub mod rocket_adapter;
+    #[cfg(feature = "rocket")]
+    pub use rocket_adapter::*;
 }
 
 pub use adapters::*;
diff --git a/packages/ssr/src/renderer.rs b/packages/ssr/src/renderer.rs
index 9b0d9e7bb..31c7f33f5 100644
--- a/packages/ssr/src/renderer.rs
+++ b/packages/ssr/src/renderer.rs
@@ -106,7 +106,10 @@ impl Renderer {
 
                     if self.pre_render {
                         if let AttributeValue::Listener(_) = &attr.value {
-                            accumulated_listeners.push(attr.name);
+                            // The onmounted event doesn't need a DOM listener
+                            if attr.name != "onmounted" {
+                                accumulated_listeners.push(attr.name);
+                            }
                         }
                     }
                 }
diff --git a/packages/web/src/dom.rs b/packages/web/src/dom.rs
index bcf2065ec..c535d961b 100644
--- a/packages/web/src/dom.rs
+++ b/packages/web/src/dom.rs
@@ -255,17 +255,21 @@ impl WebsysDom {
         i.flush();
 
         for id in to_mount {
-            let node = get_node(id.0 as u32);
-            if let Some(element) = node.dyn_ref::() {
-                let data: MountedData = element.into();
-                let data = Rc::new(data);
-                let _ = self.event_channel.unbounded_send(UiEvent {
-                    name: "mounted".to_string(),
-                    bubbles: false,
-                    element: id,
-                    data,
-                });
-            }
+            self.send_mount_event(id);
+        }
+    }
+
+    pub(crate) fn send_mount_event(&self, id: ElementId) {
+        let node = get_node(id.0 as u32);
+        if let Some(element) = node.dyn_ref::() {
+            let data: MountedData = element.into();
+            let data = Rc::new(data);
+            let _ = self.event_channel.unbounded_send(UiEvent {
+                name: "mounted".to_string(),
+                bubbles: false,
+                element: id,
+                data,
+            });
         }
     }
 }
diff --git a/packages/web/src/lib.rs b/packages/web/src/lib.rs
index 3d8ecf03f..90959a517 100644
--- a/packages/web/src/lib.rs
+++ b/packages/web/src/lib.rs
@@ -253,13 +253,6 @@ pub async fn run_with_props(root: fn(Scope) -> Element, root_prop
             pin_mut!(work);
 
             #[cfg(all(feature = "hot_reload", debug_assertions))]
-            // futures_util::select! {
-            //     _ = work => (None, None),
-            //     new_template = hotreload_rx.next() => {
-            //         (None, new_template)
-            //     }
-            //     evt = rx.next() =>
-            // }
             match select(work, select(hotreload_rx.next(), rx.next())).await {
                 Either::Left((_, _)) => (None, None),
                 Either::Right((Either::Left((new_template, _)), _)) => (None, new_template),
diff --git a/packages/web/src/rehydrate.rs b/packages/web/src/rehydrate.rs
index 9fa20e56a..4905d1e24 100644
--- a/packages/web/src/rehydrate.rs
+++ b/packages/web/src/rehydrate.rs
@@ -14,12 +14,17 @@ impl WebsysDom {
     pub fn rehydrate(&mut self, dom: &VirtualDom) -> Result<(), RehydrationError> {
         let root_scope = dom.base_scope();
         let mut ids = Vec::new();
+        let mut to_mount = Vec::new();
 
         // Recursively rehydrate the dom from the VirtualDom
-        self.rehydrate_scope(root_scope, dom, &mut ids)?;
+        self.rehydrate_scope(root_scope, dom, &mut ids, &mut to_mount)?;
 
         dioxus_interpreter_js::hydrate(ids);
 
+        for id in to_mount {
+            self.send_mount_event(id);
+        }
+
         Ok(())
     }
 
@@ -28,12 +33,13 @@ impl WebsysDom {
         scope: &ScopeState,
         dom: &VirtualDom,
         ids: &mut Vec,
+        to_mount: &mut Vec,
     ) -> Result<(), RehydrationError> {
         let vnode = match scope.root_node() {
             dioxus_core::RenderReturn::Ready(ready) => ready,
             _ => return Err(VNodeNotInitialized),
         };
-        self.rehydrate_vnode(dom, vnode, ids)
+        self.rehydrate_vnode(dom, vnode, ids, to_mount)
     }
 
     fn rehydrate_vnode(
@@ -41,6 +47,7 @@ impl WebsysDom {
         dom: &VirtualDom,
         vnode: &VNode,
         ids: &mut Vec,
+        to_mount: &mut Vec,
     ) -> Result<(), RehydrationError> {
         for (i, root) in vnode.template.get().roots.iter().enumerate() {
             self.rehydrate_template_node(
@@ -48,6 +55,7 @@ impl WebsysDom {
                 vnode,
                 root,
                 ids,
+                to_mount,
                 Some(*vnode.root_ids.borrow().get(i).ok_or(VNodeNotInitialized)?),
             )?;
         }
@@ -60,6 +68,7 @@ impl WebsysDom {
         vnode: &VNode,
         node: &TemplateNode,
         ids: &mut Vec,
+        to_mount: &mut Vec,
         root_id: Option,
     ) -> Result<(), RehydrationError> {
         tracing::trace!("rehydrate template node: {:?}", node);
@@ -73,6 +82,11 @@ impl WebsysDom {
                         let attribute = &vnode.dynamic_attrs[*id];
                         let id = attribute.mounted_element();
                         mounted_id = Some(id);
+                        if let dioxus_core::AttributeValue::Listener(_) = attribute.value {
+                            if attribute.name == "onmounted" {
+                                to_mount.push(id);
+                            }
+                        }
                     }
                 }
                 if let Some(id) = mounted_id {
@@ -80,12 +94,12 @@ impl WebsysDom {
                 }
                 if !children.is_empty() {
                     for child in *children {
-                        self.rehydrate_template_node(dom, vnode, child, ids, None)?;
+                        self.rehydrate_template_node(dom, vnode, child, ids, to_mount, None)?;
                     }
                 }
             }
             TemplateNode::Dynamic { id } | TemplateNode::DynamicText { id } => {
-                self.rehydrate_dynamic_node(dom, &vnode.dynamic_nodes[*id], ids)?;
+                self.rehydrate_dynamic_node(dom, &vnode.dynamic_nodes[*id], ids, to_mount)?;
             }
             _ => {}
         }
@@ -97,6 +111,7 @@ impl WebsysDom {
         dom: &VirtualDom,
         dynamic: &DynamicNode,
         ids: &mut Vec,
+        to_mount: &mut Vec,
     ) -> Result<(), RehydrationError> {
         tracing::trace!("rehydrate dynamic node: {:?}", dynamic);
         match dynamic {
@@ -108,11 +123,16 @@ impl WebsysDom {
             }
             dioxus_core::DynamicNode::Component(comp) => {
                 let scope = comp.mounted_scope().ok_or(VNodeNotInitialized)?;
-                self.rehydrate_scope(dom.get_scope(scope).ok_or(VNodeNotInitialized)?, dom, ids)?;
+                self.rehydrate_scope(
+                    dom.get_scope(scope).ok_or(VNodeNotInitialized)?,
+                    dom,
+                    ids,
+                    to_mount,
+                )?;
             }
             dioxus_core::DynamicNode::Fragment(fragment) => {
                 for vnode in *fragment {
-                    self.rehydrate_vnode(dom, vnode, ids)?;
+                    self.rehydrate_vnode(dom, vnode, ids, to_mount)?;
                 }
             }
         }

From a0b95a82a0fa16d9101897554444878da7096f74 Mon Sep 17 00:00:00 2001
From: werner291 
Date: Mon, 1 Jan 2024 17:22:52 +0100
Subject: [PATCH 371/447] Implemented From> for ReadOnlySignal
 (#1772)

---
 packages/signals/src/signal.rs | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/packages/signals/src/signal.rs b/packages/signals/src/signal.rs
index 1dc4bd36e..946a6c380 100644
--- a/packages/signals/src/signal.rs
+++ b/packages/signals/src/signal.rs
@@ -495,3 +495,9 @@ impl Deref for ReadOnlySignal {
         reference_to_closure as &Self::Target
     }
 }
+
+impl From> for ReadOnlySignal {
+    fn from(signal: Signal) -> Self {
+        Self::new(signal)
+    }
+}

From 8230566c4d761f6235ce4eba5a990bcb35af194f Mon Sep 17 00:00:00 2001
From: Hampus Lidin 
Date: Tue, 2 Jan 2024 17:01:53 +0100
Subject: [PATCH 372/447] Add doc comment on generated inline properties struct
 (#1775)

---
 .../core-macro/src/component_body_deserializers/component.rs   | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/core-macro/src/component_body_deserializers/component.rs b/packages/core-macro/src/component_body_deserializers/component.rs
index 36cda850c..994e51709 100644
--- a/packages/core-macro/src/component_body_deserializers/component.rs
+++ b/packages/core-macro/src/component_body_deserializers/component.rs
@@ -58,8 +58,11 @@ impl ToTokens for ComponentDeserializerOutput {
     fn to_tokens(&self, tokens: &mut TokenStream2) {
         let comp_fn = &self.comp_fn;
         let props_struct = &self.props_struct;
+        let fn_ident = &comp_fn.sig.ident;
 
+        let doc = format!("Properties for the [`{fn_ident}`] component.");
         tokens.append_all(quote! {
+            #[doc = #doc]
             #props_struct
             #[allow(non_snake_case)]
             #comp_fn

From fd7c9e0359823f767f8b90a0b156be4babdb7a22 Mon Sep 17 00:00:00 2001
From: abhi 
Date: Tue, 2 Jan 2024 16:02:58 +0000
Subject: [PATCH 373/447] fix empty render causing panic (#1769) (#1774)

* fix empty render causing panic (#1769)

* use an default root column instead of an empty root column

* fix formatting

* restore create.rs in core

---------

Co-authored-by: Evan Almloff 
---
 packages/core/src/create.rs  |  3 +-
 packages/rsx/src/lib.rs      | 17 ++++---
 packages/ssr/src/renderer.rs | 88 ++++++++++++++++++++++++++++++++++++
 3 files changed, 101 insertions(+), 7 deletions(-)

diff --git a/packages/core/src/create.rs b/packages/core/src/create.rs
index a61a8cace..733a796ce 100644
--- a/packages/core/src/create.rs
+++ b/packages/core/src/create.rs
@@ -205,7 +205,7 @@ impl<'b> VirtualDom {
         });
     }
 
-    /// We write all the descndent data for this element
+    /// We write all the descendent data for this element
     ///
     /// Elements can contain other nodes - and those nodes can be dynamic or static
     ///
@@ -405,6 +405,7 @@ impl<'b> VirtualDom {
     #[allow(unused_mut)]
     pub(crate) fn register_template(&mut self, mut template: Template<'static>) {
         let (path, byte_index) = template.name.rsplit_once(':').unwrap();
+
         let byte_index = byte_index.parse::().unwrap();
         // First, check if we've already seen this template
         if self
diff --git a/packages/rsx/src/lib.rs b/packages/rsx/src/lib.rs
index 5db6baee9..458075b63 100644
--- a/packages/rsx/src/lib.rs
+++ b/packages/rsx/src/lib.rs
@@ -204,12 +204,17 @@ impl<'a> ToTokens for TemplateRenderer<'a> {
             None => quote! { None },
         };
 
-        let spndbg = format!("{:?}", self.roots[0].span());
-        let root_col = spndbg
-            .rsplit_once("..")
-            .and_then(|(_, after)| after.split_once(')').map(|(before, _)| before))
-            .unwrap_or_default();
-
+        let root_col = match self.roots.first() {
+            Some(first_root) => {
+                let first_root_span = format!("{:?}", first_root.span());
+                first_root_span
+                    .rsplit_once("..")
+                    .and_then(|(_, after)| after.split_once(')').map(|(before, _)| before))
+                    .unwrap_or_default()
+                    .to_string()
+            }
+            _ => "0".to_string(),
+        };
         let root_printer = self.roots.iter().enumerate().map(|(idx, root)| {
             context.current_path.push(idx as u8);
             let out = context.render_static_node(root);
diff --git a/packages/ssr/src/renderer.rs b/packages/ssr/src/renderer.rs
index 98afef8b7..c0f9b6c75 100644
--- a/packages/ssr/src/renderer.rs
+++ b/packages/ssr/src/renderer.rs
@@ -238,6 +238,94 @@ fn to_string_works() {
     assert_eq!(out, "
Hello world 1 -->123<-- Hello world 2
nest 1
nest 2
</diiiiiiiiv>
finalize 0
finalize 1
finalize 2
finalize 3
finalize 4
");
 }
 
+#[test]
+fn empty_for_loop_works() {
+    use dioxus::prelude::*;
+
+    fn app(cx: Scope) -> Element {
+        render! {
+            div { class: "asdasdasd",
+                for _ in (0..5) {
+
+                }
+            }
+        }
+    }
+
+    let mut dom = VirtualDom::new(app);
+    _ = dom.rebuild();
+
+    let mut renderer = Renderer::new();
+    let out = renderer.render(&dom);
+
+    for item in renderer.template_cache.iter() {
+        if item.1.segments.len() > 5 {
+            assert_eq!(
+                item.1.segments,
+                vec![
+                    PreRendered("
".into()),
+                    InnerHtmlMarker,
+                    PreRendered("
".into(),),
+                ]
+            );
+        }
+    }
+
+    use Segment::*;
+
+    assert_eq!(out, "
");
+}
+
+#[test]
+fn empty_render_works() {
+    use dioxus::prelude::*;
+
+    fn app(cx: Scope) -> Element {
+        render! {}
+    }
+
+    let mut dom = VirtualDom::new(app);
+    _ = dom.rebuild();
+
+    let mut renderer = Renderer::new();
+    let out = renderer.render(&dom);
+
+    for item in renderer.template_cache.iter() {
+        if item.1.segments.len() > 5 {
+            assert_eq!(item.1.segments, vec![]);
+        }
+    }
+    assert_eq!(out, "");
+}
+
+#[test]
+fn empty_rsx_works() {
+    use dioxus::prelude::*;
+
+    fn app(_: Scope) -> Element {
+        rsx! {};
+        None
+    }
+
+    let mut dom = VirtualDom::new(app);
+    _ = dom.rebuild();
+
+    let mut renderer = Renderer::new();
+    let out = renderer.render(&dom);
+
+    for item in renderer.template_cache.iter() {
+        if item.1.segments.len() > 5 {
+            assert_eq!(item.1.segments, vec![]);
+        }
+    }
+    assert_eq!(out, "");
+}
+
 pub(crate) const BOOL_ATTRS: &[&str] = &[
     "allowfullscreen",
     "allowpaymentrequest",

From 80a8e1f512bbaeb71695107e64d1d2d3c10477f9 Mon Sep 17 00:00:00 2001
From: Bennett-Petzold <46354948+Bennett-Petzold@users.noreply.github.com>
Date: Tue, 2 Jan 2024 16:19:29 -0500
Subject: [PATCH 374/447] Add Cargo Arguments and Cross-Architecture Support
 (#1777)

* Add passthrough to cargo build

* Add platform_triple flag

* Add handling to bundle and serve commands

* Show full stacked error from Tauri in bundling

Previously only the top-level error was shown, giving only vague data
for debugging the build process

* Adjust bundle platform triple when cross compiling

* Rename --platform-triple to --target

* restore some deleted docs on CLI commands

---------

Co-authored-by: Evan Almloff 
---
 packages/cli/src/builder.rs    | 17 ++++++++++++++++-
 packages/cli/src/cli/build.rs  |  6 ++++++
 packages/cli/src/cli/bundle.rs | 15 +++++++++++++--
 packages/cli/src/cli/cfg.rs    | 32 ++++++++++++++++++++++++--------
 packages/cli/src/cli/serve.rs  |  6 ++++++
 packages/cli/src/config.rs     | 16 ++++++++++++++++
 6 files changed, 81 insertions(+), 11 deletions(-)

diff --git a/packages/cli/src/builder.rs b/packages/cli/src/builder.rs
index 759be7dec..a5721d7a6 100644
--- a/packages/cli/src/builder.rs
+++ b/packages/cli/src/builder.rs
@@ -93,6 +93,8 @@ pub fn build(config: &CrateConfig, quiet: bool) -> Result {
         cmd
     };
 
+    let cmd = cmd.args(&config.cargo_args);
+
     let cmd = match executable {
         ExecutableType::Binary(name) => cmd.arg("--bin").arg(name),
         ExecutableType::Lib(name) => cmd.arg("--lib").arg(name),
@@ -286,6 +288,14 @@ pub fn build_desktop(config: &CrateConfig, _is_serve: bool) -> Result cmd.arg("--bin").arg(name),
         crate::ExecutableType::Lib(name) => cmd.arg("--lib").arg(name),
@@ -303,12 +313,17 @@ pub fn build_desktop(config: &CrateConfig, _is_serve: bool) -> Result {
             file_name = name.clone();
-            config.target_dir.join(release_type).join(name)
+            config
+                .target_dir
+                .join(target_platform)
+                .join(release_type)
+                .join(name)
         }
         crate::ExecutableType::Example(name) => {
             file_name = name.clone();
             config
                 .target_dir
+                .join(target_platform)
                 .join(release_type)
                 .join("examples")
                 .join(name)
diff --git a/packages/cli/src/cli/build.rs b/packages/cli/src/cli/build.rs
index 63a2969e0..0deeb38ca 100644
--- a/packages/cli/src/cli/build.rs
+++ b/packages/cli/src/cli/build.rs
@@ -37,6 +37,12 @@ impl Build {
             .platform
             .unwrap_or(crate_config.dioxus_config.application.default_platform);
 
+        if let Some(target) = self.build.target {
+            crate_config.set_target(target);
+        }
+
+        crate_config.set_cargo_args(self.build.cargo_args);
+
         // #[cfg(feature = "plugin")]
         // let _ = PluginManager::on_build_start(&crate_config, &platform);
 
diff --git a/packages/cli/src/cli/bundle.rs b/packages/cli/src/cli/bundle.rs
index 80b52cf2f..fd97930ed 100644
--- a/packages/cli/src/cli/bundle.rs
+++ b/packages/cli/src/cli/bundle.rs
@@ -76,6 +76,12 @@ impl Bundle {
             crate_config.set_profile(self.build.profile.unwrap());
         }
 
+        if let Some(target) = &self.build.target {
+            crate_config.set_target(target.to_string());
+        }
+
+        crate_config.set_cargo_args(self.build.cargo_args);
+
         // build the desktop app
         build_desktop(&crate_config, false)?;
 
@@ -148,6 +154,11 @@ impl Bundle {
                     .collect(),
             );
         }
+
+        if let Some(target) = &self.build.target {
+            settings = settings.target(target.to_string());
+        }
+
         let settings = settings.build();
 
         // on macos we need to set CI=true (https://github.com/tauri-apps/tauri/issues/2567)
@@ -156,9 +167,9 @@ impl Bundle {
 
         tauri_bundler::bundle::bundle_project(settings.unwrap()).unwrap_or_else(|err|{
             #[cfg(target_os = "macos")]
-            panic!("Failed to bundle project: {}\nMake sure you have automation enabled in your terminal (https://github.com/tauri-apps/tauri/issues/3055#issuecomment-1624389208) and full disk access enabled for your terminal (https://github.com/tauri-apps/tauri/issues/3055#issuecomment-1624389208)", err);
+            panic!("Failed to bundle project: {:#?}\nMake sure you have automation enabled in your terminal (https://github.com/tauri-apps/tauri/issues/3055#issuecomment-1624389208) and full disk access enabled for your terminal (https://github.com/tauri-apps/tauri/issues/3055#issuecomment-1624389208)", err);
             #[cfg(not(target_os = "macos"))]
-            panic!("Failed to bundle project: {}", err);
+            panic!("Failed to bundle project: {:#?}", err);
         });
 
         Ok(())
diff --git a/packages/cli/src/cli/cfg.rs b/packages/cli/src/cli/cfg.rs
index 2a441a1c8..0d2a5e212 100644
--- a/packages/cli/src/cli/cfg.rs
+++ b/packages/cli/src/cli/cfg.rs
@@ -6,10 +6,6 @@ use super::*;
 /// Config options for the build system.
 #[derive(Clone, Debug, Default, Deserialize, Parser)]
 pub struct ConfigOptsBuild {
-    /// The index HTML file to drive the bundling process [default: index.html]
-    #[arg(long)]
-    pub target: Option,
-
     /// Build in release mode [default: false]
     #[clap(long)]
     #[serde(default)]
@@ -35,14 +31,18 @@ pub struct ConfigOptsBuild {
     /// Space separated list of features to activate
     #[clap(long)]
     pub features: Option>,
+
+    /// Rustc platform triple
+    #[clap(long)]
+    pub target: Option,
+
+    /// Extra arguments passed to cargo build
+    #[clap(last = true)]
+    pub cargo_args: Vec,
 }
 
 #[derive(Clone, Debug, Default, Deserialize, Parser)]
 pub struct ConfigOptsServe {
-    /// The index HTML file to drive the bundling process [default: index.html]
-    #[arg(short, long)]
-    pub target: Option,
-
     /// Port of dev server
     #[clap(long)]
     #[clap(default_value_t = 8080)]
@@ -89,6 +89,14 @@ pub struct ConfigOptsServe {
     /// Space separated list of features to activate
     #[clap(long)]
     pub features: Option>,
+
+    /// Rustc platform triple
+    #[clap(long)]
+    pub target: Option,
+
+    /// Extra arguments passed to cargo build
+    #[clap(last = true)]
+    pub cargo_args: Vec,
 }
 
 #[derive(Copy, Clone, PartialEq, Eq, PartialOrd, Ord, ValueEnum, Serialize, Deserialize, Debug)]
@@ -129,4 +137,12 @@ pub struct ConfigOptsBundle {
     /// Space separated list of features to activate
     #[clap(long)]
     pub features: Option>,
+
+    /// Rustc platform triple
+    #[clap(long)]
+    pub target: Option,
+
+    /// Extra arguments passed to cargo build
+    #[clap(last = true)]
+    pub cargo_args: Vec,
 }
diff --git a/packages/cli/src/cli/serve.rs b/packages/cli/src/cli/serve.rs
index 433d611b7..e08b02339 100644
--- a/packages/cli/src/cli/serve.rs
+++ b/packages/cli/src/cli/serve.rs
@@ -34,6 +34,12 @@ impl Serve {
         // Subdirectories don't work with the server
         crate_config.dioxus_config.web.app.base_path = None;
 
+        if let Some(target) = self.serve.target {
+            crate_config.set_target(target);
+        }
+
+        crate_config.set_cargo_args(self.serve.cargo_args);
+
         let platform = self
             .serve
             .platform
diff --git a/packages/cli/src/config.rs b/packages/cli/src/config.rs
index 3abf47f0c..727504e6a 100644
--- a/packages/cli/src/config.rs
+++ b/packages/cli/src/config.rs
@@ -211,6 +211,8 @@ pub struct CrateConfig {
     pub verbose: bool,
     pub custom_profile: Option,
     pub features: Option>,
+    pub target: Option,
+    pub cargo_args: Vec,
 }
 
 #[derive(Debug, Clone)]
@@ -278,6 +280,8 @@ impl CrateConfig {
         let verbose = false;
         let custom_profile = None;
         let features = None;
+        let target = None;
+        let cargo_args = vec![];
 
         Ok(Self {
             out_dir,
@@ -294,6 +298,8 @@ impl CrateConfig {
             custom_profile,
             features,
             verbose,
+            target,
+            cargo_args,
         })
     }
 
@@ -331,6 +337,16 @@ impl CrateConfig {
         self.features = Some(features);
         self
     }
+
+    pub fn set_target(&mut self, target: String) -> &mut Self {
+        self.target = Some(target);
+        self
+    }
+
+    pub fn set_cargo_args(&mut self, cargo_args: Vec) -> &mut Self {
+        self.cargo_args = cargo_args;
+        self
+    }
 }
 
 #[derive(Debug, Clone, Serialize, Deserialize, Default)]

From 2f9b6e7dea89f4af422d6c56f315e7ecc8880c37 Mon Sep 17 00:00:00 2001
From: Evan Almloff 
Date: Wed, 3 Jan 2024 08:26:14 -0600
Subject: [PATCH 375/447] fix non string layout attributes in rink

---
 packages/rink/src/layout.rs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/rink/src/layout.rs b/packages/rink/src/layout.rs
index dbdadac3f..72c8f68b2 100644
--- a/packages/rink/src/layout.rs
+++ b/packages/rink/src/layout.rs
@@ -92,10 +92,10 @@ impl State for TaffyLayout {
                     attribute, value, ..
                 } in attributes
                 {
-                    if let Some(text) = value.as_text() {
+                    if value.as_custom().is_none() {
                         apply_layout_attributes_cfg(
                             &attribute.name,
-                            text,
+                            &value.to_string(),
                             &mut style,
                             &LayoutConfigeration {
                                 border_widths: BorderWidths {

From cde5ac5f585c607d6b53f29e8e7ecac88df34306 Mon Sep 17 00:00:00 2001
From: ealmloff 
Date: Wed, 3 Jan 2024 14:01:50 -0600
Subject: [PATCH 376/447] fix invalid locations never being dropped (#1747)

---
 packages/generational-box/src/lib.rs | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/packages/generational-box/src/lib.rs b/packages/generational-box/src/lib.rs
index f56904ede..57a02a5d7 100644
--- a/packages/generational-box/src/lib.rs
+++ b/packages/generational-box/src/lib.rs
@@ -700,14 +700,16 @@ impl Owner {
     /// Creates an invalid handle. This is useful for creating a handle that will be filled in later. If you use this before the value is filled in, you will get may get a panic or an out of date value.
     pub fn invalid(&self) -> GenerationalBox {
         let location = self.store.claim();
-        GenerationalBox {
+        let key = GenerationalBox {
             raw: location,
             #[cfg(any(debug_assertions, feature = "check_generation"))]
             generation: location.0.generation.get(),
             #[cfg(any(debug_assertions, feature = "debug_ownership"))]
             created_at: std::panic::Location::caller(),
             _marker: PhantomData,
-        }
+        };
+        self.owned.borrow_mut().push(location);
+        key
     }
 }
 

From 937be8b752c48b03f02014130970fa924981cc91 Mon Sep 17 00:00:00 2001
From: ealmloff 
Date: Wed, 3 Jan 2024 14:02:08 -0600
Subject: [PATCH 377/447] fix the on double click event and depreciate
 ondblclick (#1743)

---
 examples/all_events.rs                        |  11 +-
 examples/todomvc.rs                           |  89 ++++++++-------
 packages/desktop/headless_tests/events.rs     | 101 ++++++++++++------
 .../examples/all_terminal_events.rs           |  20 ++--
 packages/fullstack/src/hooks/server_cached.rs |   4 +-
 packages/html/src/events/mouse.rs             |  18 +++-
 packages/web/src/cache.rs                     |   2 +-
 7 files changed, 143 insertions(+), 102 deletions(-)

diff --git a/examples/all_events.rs b/examples/all_events.rs
index 594a736d5..3f57ec747 100644
--- a/examples/all_events.rs
+++ b/examples/all_events.rs
@@ -53,8 +53,7 @@ fn app(cx: Scope) -> Element {
     };
 
     cx.render(rsx! (
-        div {
-            style: "{CONTAINER_STYLE}",
+        div { style: "{CONTAINER_STYLE}",
             div {
                 style: "{RECT_STYLE}",
                 // focusing is necessary to catch keyboard events
@@ -62,7 +61,7 @@ fn app(cx: Scope) -> Element {
 
                 onmousemove: move |event| log_event(Event::MouseMove(event)),
                 onclick: move |event| log_event(Event::MouseClick(event)),
-                ondblclick: move |event| log_event(Event::MouseDoubleClick(event)),
+                ondoubleclick: move |event| log_event(Event::MouseDoubleClick(event)),
                 onmousedown: move |event| log_event(Event::MouseDown(event)),
                 onmouseup: move |event| log_event(Event::MouseUp(event)),
 
@@ -77,9 +76,7 @@ fn app(cx: Scope) -> Element {
 
                 "Hover, click, type or scroll to see the info down below"
             }
-            div {
-                events.read().iter().map(|event| rsx!( div { "{event:?}" } ))
-            },
-        },
+            div { events.read().iter().map(|event| rsx!( div { "{event:?}" } )) }
+        }
     ))
 }
diff --git a/examples/todomvc.rs b/examples/todomvc.rs
index 9ec2dc228..0f3fada71 100644
--- a/examples/todomvc.rs
+++ b/examples/todomvc.rs
@@ -48,11 +48,8 @@ pub fn app(cx: Scope<()>) -> Element {
     cx.render(rsx! {
         section { class: "todoapp",
             style { include_str!("./assets/todomvc.css") }
-            TodoHeader {
-                todos: todos,
-            }
-            section {
-                class: "main",
+            TodoHeader { todos: todos }
+            section { class: "main",
                 if !todos.is_empty() {
                     rsx! {
                         input {
@@ -103,31 +100,34 @@ pub fn TodoHeader<'a>(cx: Scope<'a, TodoHeaderProps<'a>>) -> Element {
 
     cx.render(rsx! {
         header { class: "header",
-        h1 {"todos"}
-        input {
-            class: "new-todo",
-            placeholder: "What needs to be done?",
-            value: "{draft}",
-            autofocus: "true",
-            oninput: move |evt| {
-                draft.set(evt.value.clone());
-            },
-            onkeydown: move |evt| {
-                if evt.key() == Key::Enter && !draft.is_empty() {
-                    cx.props.todos.make_mut().insert(
-                        **todo_id,
-                        TodoItem {
-                            id: **todo_id,
-                            checked: false,
-                            contents: draft.to_string(),
-                        },
-                    );
-                    *todo_id.make_mut() += 1;
-                    draft.set("".to_string());
+            h1 { "todos" }
+            input {
+                class: "new-todo",
+                placeholder: "What needs to be done?",
+                value: "{draft}",
+                autofocus: "true",
+                oninput: move |evt| {
+                    draft.set(evt.value.clone());
+                },
+                onkeydown: move |evt| {
+                    if evt.key() == Key::Enter && !draft.is_empty() {
+                        cx.props
+                            .todos
+                            .make_mut()
+                            .insert(
+                                **todo_id,
+                                TodoItem {
+                                    id: **todo_id,
+                                    checked: false,
+                                    contents: draft.to_string(),
+                                },
+                            );
+                        *todo_id.make_mut() += 1;
+                        draft.set("".to_string());
+                    }
                 }
             }
         }
-    }
     })
 }
 
@@ -146,8 +146,7 @@ pub fn TodoEntry<'a>(cx: Scope<'a, TodoEntryProps<'a>>) -> Element {
     let editing = if **is_editing { "editing" } else { "" };
 
     cx.render(rsx!{
-        li {
-            class: "{completed} {editing}",
+        li { class: "{completed} {editing}",
             div { class: "view",
                 input {
                     class: "toggle",
@@ -160,14 +159,16 @@ pub fn TodoEntry<'a>(cx: Scope<'a, TodoEntryProps<'a>>) -> Element {
                 }
                 label {
                     r#for: "cbg-{todo.id}",
-                    ondblclick: move |_| is_editing.set(true),
+                    ondoubleclick: move |_| is_editing.set(true),
                     prevent_default: "onclick",
                     "{todo.contents}"
                 }
                 button {
                     class: "destroy",
-                    onclick: move |_| { cx.props.todos.make_mut().remove(&todo.id); },
-                    prevent_default: "onclick",
+                    onclick: move |_| {
+                        cx.props.todos.make_mut().remove(&todo.id);
+                    },
+                    prevent_default: "onclick"
                 }
             }
             is_editing.then(|| rsx!{
@@ -213,15 +214,15 @@ pub fn ListFooter<'a>(cx: Scope<'a, ListFooterProps<'a>>) -> Element {
     cx.render(rsx! {
         footer { class: "footer",
             span { class: "todo-count",
-                strong {"{active_todo_count} "}
-                span {"{active_todo_text} left"}
+                strong { "{active_todo_count} " }
+                span { "{active_todo_text} left" }
             }
             ul { class: "filters",
-                for (state, state_text, url) in [
-                    (FilterState::All, "All", "#/"),
-                    (FilterState::Active, "Active", "#/active"),
-                    (FilterState::Completed, "Completed", "#/completed"),
-                ] {
+                for (state , state_text , url) in [
+    (FilterState::All, "All", "#/"),
+    (FilterState::Active, "Active", "#/active"),
+    (FilterState::Completed, "Completed", "#/completed"),
+] {
                     li {
                         a {
                             href: url,
@@ -250,8 +251,14 @@ pub fn PageFooter(cx: Scope) -> Element {
     cx.render(rsx! {
         footer { class: "info",
             p { "Double-click to edit a todo" }
-            p { "Created by ", a { href: "http://github.com/jkelleyrtp/", "jkelleyrtp" }}
-            p { "Part of ", a { href: "http://todomvc.com", "TodoMVC" }}
+            p {
+                "Created by "
+                a { href: "http://github.com/jkelleyrtp/", "jkelleyrtp" }
+            }
+            p {
+                "Part of "
+                a { href: "http://todomvc.com", "TodoMVC" }
+            }
         }
     })
 }
diff --git a/packages/desktop/headless_tests/events.rs b/packages/desktop/headless_tests/events.rs
index ac62cd37b..6d29b6ffa 100644
--- a/packages/desktop/headless_tests/events.rs
+++ b/packages/desktop/headless_tests/events.rs
@@ -229,75 +229,111 @@ fn app(cx: Scope) -> Element {
                     println!("{:?}", event.data);
                     assert!(event.data.modifiers().is_empty());
                     assert!(event.data.held_buttons().is_empty());
-                    assert_eq!(event.data.trigger_button(), Some(dioxus_html::input_data::MouseButton::Primary));
+                    assert_eq!(
+                        event.data.trigger_button(),
+                        Some(dioxus_html::input_data::MouseButton::Primary),
+                    );
                     recieved_events.modify(|x| *x + 1)
-                },
+                }
             }
             div {
                 id: "mouse_move_div",
                 onmousemove: move |event| {
                     println!("{:?}", event.data);
                     assert!(event.data.modifiers().is_empty());
-                    assert!(event.data.held_buttons().contains(dioxus_html::input_data::MouseButton::Secondary));
+                    assert!(
+                        event
+                            .data
+                            .held_buttons()
+                            .contains(dioxus_html::input_data::MouseButton::Secondary),
+                    );
                     recieved_events.modify(|x| *x + 1)
-                },
+                }
             }
             div {
                 id: "mouse_click_div",
                 onclick: move |event| {
                     println!("{:?}", event.data);
                     assert!(event.data.modifiers().is_empty());
-                    assert!(event.data.held_buttons().contains(dioxus_html::input_data::MouseButton::Secondary));
-                    assert_eq!(event.data.trigger_button(), Some(dioxus_html::input_data::MouseButton::Secondary));
-                    recieved_events.modify(|x| *x + 1)
-                },
-            }
-            div{
-                id: "mouse_dblclick_div",
-                ondblclick: move |event| {
-                    println!("{:?}", event.data);
-                    assert!(event.data.modifiers().is_empty());
-                    assert!(event.data.held_buttons().contains(dioxus_html::input_data::MouseButton::Primary));
-                    assert!(event.data.held_buttons().contains(dioxus_html::input_data::MouseButton::Secondary));
-                    assert_eq!(event.data.trigger_button(), Some(dioxus_html::input_data::MouseButton::Secondary));
+                    assert!(
+                        event
+                            .data
+                            .held_buttons()
+                            .contains(dioxus_html::input_data::MouseButton::Secondary),
+                    );
+                    assert_eq!(
+                        event.data.trigger_button(),
+                        Some(dioxus_html::input_data::MouseButton::Secondary),
+                    );
                     recieved_events.modify(|x| *x + 1)
                 }
             }
-            div{
+            div {
+                id: "mouse_dblclick_div",
+                ondoubleclick: move |event| {
+                    println!("{:?}", event.data);
+                    assert!(event.data.modifiers().is_empty());
+                    assert!(
+                        event.data.held_buttons().contains(dioxus_html::input_data::MouseButton::Primary),
+                    );
+                    assert!(
+                        event
+                            .data
+                            .held_buttons()
+                            .contains(dioxus_html::input_data::MouseButton::Secondary),
+                    );
+                    assert_eq!(
+                        event.data.trigger_button(),
+                        Some(dioxus_html::input_data::MouseButton::Secondary),
+                    );
+                    recieved_events.modify(|x| *x + 1)
+                }
+            }
+            div {
                 id: "mouse_down_div",
                 onmousedown: move |event| {
                     println!("{:?}", event.data);
                     assert!(event.data.modifiers().is_empty());
-                    assert!(event.data.held_buttons().contains(dioxus_html::input_data::MouseButton::Secondary));
-                    assert_eq!(event.data.trigger_button(), Some(dioxus_html::input_data::MouseButton::Secondary));
+                    assert!(
+                        event
+                            .data
+                            .held_buttons()
+                            .contains(dioxus_html::input_data::MouseButton::Secondary),
+                    );
+                    assert_eq!(
+                        event.data.trigger_button(),
+                        Some(dioxus_html::input_data::MouseButton::Secondary),
+                    );
                     recieved_events.modify(|x| *x + 1)
                 }
             }
-            div{
+            div {
                 id: "mouse_up_div",
                 onmouseup: move |event| {
                     println!("{:?}", event.data);
                     assert!(event.data.modifiers().is_empty());
                     assert!(event.data.held_buttons().is_empty());
-                    assert_eq!(event.data.trigger_button(), Some(dioxus_html::input_data::MouseButton::Primary));
+                    assert_eq!(
+                        event.data.trigger_button(),
+                        Some(dioxus_html::input_data::MouseButton::Primary),
+                    );
                     recieved_events.modify(|x| *x + 1)
                 }
             }
-            div{
+            div {
                 id: "wheel_div",
                 width: "100px",
                 height: "100px",
                 background_color: "red",
                 onwheel: move |event| {
                     println!("{:?}", event.data);
-                    let dioxus_html::geometry::WheelDelta::Pixels(delta)= event.data.delta()else{
-                        panic!("Expected delta to be in pixels")
-                    };
+                    let dioxus_html::geometry::WheelDelta::Pixels(delta) = event.data.delta() else {
+                    panic!("Expected delta to be in pixels") };
                     assert_eq!(delta, Vector3D::new(1.0, 2.0, 3.0));
                     recieved_events.modify(|x| *x + 1)
                 }
             }
-            input{
+            input {
                 id: "key_down_div",
                 onkeydown: move |event| {
                     println!("{:?}", event.data);
@@ -306,11 +342,10 @@ fn app(cx: Scope) -> Element {
                     assert_eq!(event.data.code().to_string(), "KeyA");
                     assert_eq!(event.data.location, 0);
                     assert!(event.data.is_auto_repeating());
-
                     recieved_events.modify(|x| *x + 1)
                 }
             }
-            input{
+            input {
                 id: "key_up_div",
                 onkeyup: move |event| {
                     println!("{:?}", event.data);
@@ -319,11 +354,10 @@ fn app(cx: Scope) -> Element {
                     assert_eq!(event.data.code().to_string(), "KeyA");
                     assert_eq!(event.data.location, 0);
                     assert!(!event.data.is_auto_repeating());
-
                     recieved_events.modify(|x| *x + 1)
                 }
             }
-            input{
+            input {
                 id: "key_press_div",
                 onkeypress: move |event| {
                     println!("{:?}", event.data);
@@ -332,18 +366,17 @@ fn app(cx: Scope) -> Element {
                     assert_eq!(event.data.code().to_string(), "KeyA");
                     assert_eq!(event.data.location, 0);
                     assert!(!event.data.is_auto_repeating());
-
                     recieved_events.modify(|x| *x + 1)
                 }
             }
-            input{
+            input {
                 id: "focus_in_div",
                 onfocusin: move |event| {
                     println!("{:?}", event.data);
                     recieved_events.modify(|x| *x + 1)
                 }
             }
-            input{
+            input {
                 id: "focus_out_div",
                 onfocusout: move |event| {
                     println!("{:?}", event.data);
diff --git a/packages/dioxus-tui/examples/all_terminal_events.rs b/packages/dioxus-tui/examples/all_terminal_events.rs
index 483e9afdf..004578807 100644
--- a/packages/dioxus-tui/examples/all_terminal_events.rs
+++ b/packages/dioxus-tui/examples/all_terminal_events.rs
@@ -37,7 +37,7 @@ fn app(cx: Scope) -> Element {
         // todo: remove
         let mut trimmed = format!("{event:?}");
         trimmed.truncate(200);
-        rsx!(p { "{trimmed}" })
+        rsx!( p { "{trimmed}" } )
     });
 
     let log_event = move |event: Event| {
@@ -45,10 +45,7 @@ fn app(cx: Scope) -> Element {
     };
 
     cx.render(rsx! {
-        div {
-            width: "100%",
-            height: "100%",
-            flex_direction: "column",
+        div { width: "100%", height: "100%", flex_direction: "column",
             div {
                 width: "80%",
                 height: "50%",
@@ -59,7 +56,7 @@ fn app(cx: Scope) -> Element {
 
                 onmousemove: move |event| log_event(Event::MouseMove(event.inner().clone())),
                 onclick: move |event| log_event(Event::MouseClick(event.inner().clone())),
-                ondblclick: move |event| log_event(Event::MouseDoubleClick(event.inner().clone())),
+                ondoubleclick: move |event| log_event(Event::MouseDoubleClick(event.inner().clone())),
                 onmousedown: move |event| log_event(Event::MouseDown(event.inner().clone())),
                 onmouseup: move |event| log_event(Event::MouseUp(event.inner().clone())),
 
@@ -73,13 +70,8 @@ fn app(cx: Scope) -> Element {
                 onfocusout: move |event| log_event(Event::FocusOut(event.inner().clone())),
 
                 "Hover, click, type or scroll to see the info down below"
-            },
-            div {
-                width: "80%",
-                height: "50%",
-                flex_direction: "column",
-                events_rendered,
-            },
-        },
+            }
+            div { width: "80%", height: "50%", flex_direction: "column", events_rendered }
+        }
     })
 }
diff --git a/packages/fullstack/src/hooks/server_cached.rs b/packages/fullstack/src/hooks/server_cached.rs
index 519f70dae..572efd2b7 100644
--- a/packages/fullstack/src/hooks/server_cached.rs
+++ b/packages/fullstack/src/hooks/server_cached.rs
@@ -12,9 +12,11 @@ use serde::{de::DeserializeOwned, Serialize};
 /// use dioxus_fullstack::prelude::*;
 ///
 /// fn app(cx: Scope) -> Element {
-///    let state1 = use_state(cx, || from_server(|| {
+///    let state1 = use_state(cx, || server_cached(|| {
 ///       1234
 ///    }));
+/// 
+///    todo!()
 /// }
 /// ```
 pub fn server_cached(server_fn: impl Fn() -> O) -> O {
diff --git a/packages/html/src/events/mouse.rs b/packages/html/src/events/mouse.rs
index 55d081900..ea5bf29d3 100644
--- a/packages/html/src/events/mouse.rs
+++ b/packages/html/src/events/mouse.rs
@@ -119,10 +119,7 @@ impl_event! {
     /// oncontextmenu
     oncontextmenu
 
-    /// ondoubleclick
-    ondoubleclick
-
-    /// ondoubleclick
+    #[deprecated(since = "0.5.0", note = "use ondoubleclick instead")]
     ondblclick
 
     /// onmousedown
@@ -149,6 +146,19 @@ impl_event! {
     onmouseup
 }
 
+/// ondoubleclick
+#[inline]
+pub fn ondoubleclick<'a, E: crate::EventReturn, T>(_cx: &'a ::dioxus_core::ScopeState, mut _f: impl FnMut(::dioxus_core::Event) -> E + 'a) -> ::dioxus_core::Attribute<'a> {
+    ::dioxus_core::Attribute::new(
+        "ondblclick",
+        _cx.listener(move |e: ::dioxus_core::Event| {
+            _f(e).spawn(_cx);
+        }),
+        None,
+        false,
+    )
+}
+
 impl MouseData {
     /// Construct MouseData with the specified properties
     ///
diff --git a/packages/web/src/cache.rs b/packages/web/src/cache.rs
index e17203a65..bfd0fd197 100644
--- a/packages/web/src/cache.rs
+++ b/packages/web/src/cache.rs
@@ -190,7 +190,7 @@ pub static BUILTIN_INTERNED_STRINGS: &[&str] = &[
     "oncopy",
     "oncuechange",
     "oncut",
-    "ondblclick",
+    "ondoubleclick",
     "ondrag",
     "ondragend",
     "ondragenter",

From 43d9fe1ab0c626611d787f1d3052738e810db215 Mon Sep 17 00:00:00 2001
From: ealmloff 
Date: Wed, 3 Jan 2024 14:02:21 -0600
Subject: [PATCH 378/447] Clear the cache on rebuild in the incremental
 renderer (#1741)

---
 packages/ssr/src/incremental_cfg.rs | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/packages/ssr/src/incremental_cfg.rs b/packages/ssr/src/incremental_cfg.rs
index 1a4ea3418..15a6ad44e 100644
--- a/packages/ssr/src/incremental_cfg.rs
+++ b/packages/ssr/src/incremental_cfg.rs
@@ -67,6 +67,7 @@ pub struct IncrementalRendererConfig {
     memory_cache_limit: usize,
     invalidate_after: Option,
     map_path: Option,
+    clear_cache: bool,
 }
 
 impl Default for IncrementalRendererConfig {
@@ -83,9 +84,16 @@ impl IncrementalRendererConfig {
             memory_cache_limit: 10000,
             invalidate_after: None,
             map_path: None,
+            clear_cache: true,
         }
     }
 
+    /// Clear the cache on startup (default: true)
+    pub fn clear_cache(mut self, clear_cache: bool) -> Self {
+        self.clear_cache = clear_cache;
+        self
+    }
+
     /// Set a mapping from the route to the file path. This will override the default mapping configured with `static_dir`.
     /// The function should return the path to the folder to store the index.html file in.
     pub fn map_path PathBuf + Send + Sync + 'static>(mut self, map_path: F) -> Self {
@@ -114,7 +122,7 @@ impl IncrementalRendererConfig {
     /// Build the incremental renderer.
     pub fn build(self) -> IncrementalRenderer {
         let static_dir = self.static_dir.clone();
-        IncrementalRenderer {
+        let mut renderer = IncrementalRenderer {
             static_dir: self.static_dir.clone(),
             memory_cache: NonZeroUsize::new(self.memory_cache_limit)
                 .map(|limit| lru::LruCache::with_hasher(limit, Default::default())),
@@ -129,6 +137,12 @@ impl IncrementalRendererConfig {
                     path
                 })
             }),
+        };
+
+        if self.clear_cache {
+            renderer.invalidate_all();
         }
+
+        renderer
     }
 }

From 2e424436b362d2c72165d6b51a1683fe7d3e7e66 Mon Sep 17 00:00:00 2001
From: ealmloff 
Date: Wed, 3 Jan 2024 14:02:36 -0600
Subject: [PATCH 379/447] don't remove futures spawned by spawn_forever when
 the component is removed (#1708)

---
 packages/core/src/scope_context.rs | 12 +-----------
 1 file changed, 1 insertion(+), 11 deletions(-)

diff --git a/packages/core/src/scope_context.rs b/packages/core/src/scope_context.rs
index 59bed3b1f..eeede6a81 100644
--- a/packages/core/src/scope_context.rs
+++ b/packages/core/src/scope_context.rs
@@ -230,17 +230,7 @@ impl ScopeContext {
     /// This is good for tasks that need to be run after the component has been dropped.
     pub fn spawn_forever(&self, fut: impl Future + 'static) -> TaskId {
         // The root scope will never be unmounted so we can just add the task at the top of the app
-        let id = self.tasks.spawn(ScopeId::ROOT, fut);
-
-        // wake up the scheduler if it is sleeping
-        self.tasks
-            .sender
-            .unbounded_send(SchedulerMsg::TaskNotified(id))
-            .expect("Scheduler should exist");
-
-        self.spawned_tasks.borrow_mut().insert(id);
-
-        id
+        self.tasks.spawn(ScopeId::ROOT, fut)
     }
 
     /// Informs the scheduler that this task is no longer needed and should be removed.

From afb258b658f55a1568b8d7c97b617b34f75c1aea Mon Sep 17 00:00:00 2001
From: Evan Almloff 
Date: Wed, 3 Jan 2024 15:18:27 -0600
Subject: [PATCH 380/447] Fix elements and attributes mapping for dx translate

---
 packages/html/Cargo.toml                    |  1 +
 packages/html/src/elements.rs               | 48 +++++++++++++++++++--
 packages/html/src/global_attributes.rs      | 46 ++++++++++++++++++++
 packages/html/src/lib.rs                    |  2 +
 packages/rsx-rosetta/Cargo.toml             |  1 +
 packages/rsx-rosetta/src/lib.rs             | 42 +++++++++++++-----
 packages/rsx-rosetta/tests/h-tags.rs        | 33 ++++++++++++++
 packages/rsx-rosetta/tests/raw.rs           | 21 +++++++++
 packages/rsx-rosetta/tests/simple.rs        |  4 --
 packages/rsx-rosetta/tests/web-component.rs | 21 +++++++++
 10 files changed, 202 insertions(+), 17 deletions(-)
 create mode 100644 packages/rsx-rosetta/tests/h-tags.rs
 create mode 100644 packages/rsx-rosetta/tests/raw.rs
 create mode 100644 packages/rsx-rosetta/tests/web-component.rs

diff --git a/packages/html/Cargo.toml b/packages/html/Cargo.toml
index 5644b440c..d12f7cf52 100644
--- a/packages/html/Cargo.toml
+++ b/packages/html/Cargo.toml
@@ -68,3 +68,4 @@ mounted = [
 wasm-bind = ["web-sys", "wasm-bindgen"]
 native-bind = ["tokio"]
 hot-reload-context = ["dioxus-rsx"]
+html-to-rsx = []
diff --git a/packages/html/src/elements.rs b/packages/html/src/elements.rs
index a42c01950..03231c0e9 100644
--- a/packages/html/src/elements.rs
+++ b/packages/html/src/elements.rs
@@ -79,6 +79,25 @@ macro_rules! impl_attribute_match {
     };
 }
 
+#[cfg(feature = "html-to-rsx")]
+macro_rules! impl_html_to_rsx_attribute_match {
+    (
+        $attr:ident $fil:ident $name:literal
+    ) => {
+        if $attr == $name {
+            return Some(stringify!($fil));
+        }
+    };
+
+    (
+        $attr:ident $fil:ident $_:tt
+    ) => {
+        if $attr == stringify!($fil) {
+            return Some(stringify!($fil));
+        }
+    };
+}
+
 macro_rules! impl_element {
     (
         $(#[$attr:meta])*
@@ -316,6 +335,30 @@ macro_rules! builder_constructors {
             }
         }
 
+        #[cfg(feature = "html-to-rsx")]
+        pub fn map_html_attribute_to_rsx(html: &str) -> Option<&'static str> {
+            $(
+                $(
+                    impl_html_to_rsx_attribute_match!(
+                        html $fil $extra
+                    );
+                )*
+            )*
+
+            None
+        }
+
+        #[cfg(feature = "html-to-rsx")]
+        pub fn map_html_element_to_rsx(html: &str) -> Option<&'static str> {
+            $(
+                if html == stringify!($name) {
+                    return Some(stringify!($name));
+                }
+            )*
+
+            None
+        }
+
         $(
             impl_element!(
                 $(#[$attr])*
@@ -998,9 +1041,8 @@ builder_constructors! {
         src: Uri DEFAULT,
         text: String DEFAULT,
 
-        // r#async: Bool,
-        // r#type: String, // TODO could be an enum
-        r#type: String "type",
+        r#async: Bool "async",
+        r#type: String "type", // TODO could be an enum
         r#script: String "script",
     };
 
diff --git a/packages/html/src/global_attributes.rs b/packages/html/src/global_attributes.rs
index 02b0b32ed..639026b33 100644
--- a/packages/html/src/global_attributes.rs
+++ b/packages/html/src/global_attributes.rs
@@ -33,12 +33,44 @@ macro_rules! trait_method_mapping {
     };
 }
 
+#[cfg(feature = "html-to-rsx")]
+macro_rules! html_to_rsx_attribute_mapping {
+    (
+        $matching:ident;
+        $(#[$attr:meta])*
+        $name:ident;
+    ) => {
+        if $matching == stringify!($name) {
+            return Some(stringify!($name));
+        }
+    };
+    (
+        $matching:ident;
+        $(#[$attr:meta])*
+        $name:ident: $lit:literal;
+    ) => {
+        if $matching == stringify!($lit) {
+            return Some(stringify!($name));
+        }
+    };
+    (
+        $matching:ident;
+        $(#[$attr:meta])*
+        $name:ident: $lit:literal, $ns:literal;
+    ) => {
+        if $matching == stringify!($lit) {
+            return Some(stringify!($name));
+        }
+    };
+}
+
 macro_rules! trait_methods {
     (
         @base
         $(#[$trait_attr:meta])*
         $trait:ident;
         $fn:ident;
+        $fn_html_to_rsx:ident;
         $(
             $(#[$attr:meta])*
             $name:ident $(: $($arg:literal),*)*;
@@ -62,6 +94,18 @@ macro_rules! trait_methods {
             )*
             None
         }
+
+        #[cfg(feature = "html-to-rsx")]
+        #[doc = "Converts an HTML attribute to an RSX attribute"]
+        pub(crate) fn $fn_html_to_rsx(html: &str) -> Option<&'static str> {
+            $(
+                html_to_rsx_attribute_mapping! {
+                    html;
+                    $name$(: $($arg),*)*;
+                }
+            )*
+            None
+        }
     };
 
     // Rename the incoming ident and apply a custom namespace
@@ -79,6 +123,7 @@ trait_methods! {
 
     GlobalAttributes;
     map_global_attributes;
+    map_html_global_attributes_to_rsx;
 
     /// Prevent the default action for this element.
     ///
@@ -1593,6 +1638,7 @@ trait_methods! {
     @base
     SvgAttributes;
     map_svg_attributes;
+    map_html_svg_attributes_to_rsx;
 
     /// Prevent the default action for this element.
     ///
diff --git a/packages/html/src/lib.rs b/packages/html/src/lib.rs
index 6dd7c42bd..c44777801 100644
--- a/packages/html/src/lib.rs
+++ b/packages/html/src/lib.rs
@@ -19,6 +19,8 @@
 mod elements;
 #[cfg(feature = "hot-reload-context")]
 pub use elements::HtmlCtx;
+#[cfg(feature = "html-to-rsx")]
+pub use elements::{map_html_attribute_to_rsx, map_html_element_to_rsx};
 pub mod events;
 pub mod geometry;
 mod global_attributes;
diff --git a/packages/rsx-rosetta/Cargo.toml b/packages/rsx-rosetta/Cargo.toml
index ab5d4e882..9cd53b02f 100644
--- a/packages/rsx-rosetta/Cargo.toml
+++ b/packages/rsx-rosetta/Cargo.toml
@@ -15,6 +15,7 @@ keywords = ["dom", "ui", "gui", "react"]
 [dependencies]
 dioxus-autofmt = { workspace = true }
 dioxus-rsx = { workspace = true }
+dioxus-html = { workspace = true, features = ["html-to-rsx"]}
 html_parser.workspace = true
 proc-macro2 = "1.0.49"
 quote = "1.0.23"
diff --git a/packages/rsx-rosetta/src/lib.rs b/packages/rsx-rosetta/src/lib.rs
index 3c11f3a90..e12c6f021 100644
--- a/packages/rsx-rosetta/src/lib.rs
+++ b/packages/rsx-rosetta/src/lib.rs
@@ -2,6 +2,7 @@
 #![doc(html_logo_url = "https://avatars.githubusercontent.com/u/79236386")]
 #![doc(html_favicon_url = "https://avatars.githubusercontent.com/u/79236386")]
 
+use dioxus_html::{map_html_element_to_rsx, map_html_attribute_to_rsx};
 use convert_case::{Case, Casing};
 use dioxus_rsx::{
     BodyNode, CallBody, Component, Element, ElementAttr, ElementAttrNamed, ElementName, IfmtInput,
@@ -24,26 +25,47 @@ pub fn rsx_node_from_html(node: &Node) -> Option {
     match node {
         Node::Text(text) => Some(BodyNode::Text(ifmt_from_text(text))),
         Node::Element(el) => {
-            let el_name = el.name.to_case(Case::Snake);
-            let el_name = ElementName::Ident(Ident::new(el_name.as_str(), Span::call_site()));
+            let el_name = if let Some(name) = map_html_element_to_rsx(&el.name) {
+                ElementName::Ident(Ident::new(name, Span::call_site()))
+            } else {
+                // if we don't recognize it and it has a dash, we assume it's a web component
+                if el.name.contains('-') {
+                    ElementName::Custom(LitStr::new(&el.name, Span::call_site()))
+                } else {
+                    // otherwise, it might be an element that isn't supported yet
+                    ElementName::Ident(Ident::new(
+                        &el.name.to_case(Case::Snake),
+                        Span::call_site(),
+                    ))
+                }
+            };
 
             let mut attributes: Vec<_> = el
                 .attributes
                 .iter()
                 .map(|(name, value)| {
-                    let ident = if matches!(name.as_str(), "for" | "async" | "type" | "as") {
-                        Ident::new_raw(name.as_str(), Span::call_site())
+                    let value = ifmt_from_text(value.as_deref().unwrap_or("false"));
+                    let attr = if let Some(name) = map_html_attribute_to_rsx(name) {
+                        let ident = if let Some(name) = name.strip_prefix("r#") {
+                            Ident::new_raw(name, Span::call_site())
+                        } else {
+                            Ident::new(name, Span::call_site())
+                        };
+                        ElementAttr::AttrText {
+                            value,
+                            name: ident,
+                        }
                     } else {
-                        let new_name = name.to_case(Case::Snake);
-                        Ident::new(new_name.as_str(), Span::call_site())
+                        // If we don't recognize the attribute, we assume it's a custom attribute
+                        ElementAttr::CustomAttrText {
+                            value,
+                            name: LitStr::new(name, Span::call_site()),
+                        }
                     };
 
                     ElementAttrNamed {
                         el_name: el_name.clone(),
-                        attr: ElementAttr::AttrText {
-                            value: ifmt_from_text(value.as_deref().unwrap_or("false")),
-                            name: ident,
-                        },
+                        attr
                     }
                 })
                 .collect();
diff --git a/packages/rsx-rosetta/tests/h-tags.rs b/packages/rsx-rosetta/tests/h-tags.rs
new file mode 100644
index 000000000..eb179c57f
--- /dev/null
+++ b/packages/rsx-rosetta/tests/h-tags.rs
@@ -0,0 +1,33 @@
+use html_parser::Dom;
+
+#[test]
+fn h_tags_translate() {
+    let html = r#"
+    

+        
hello world!

+        
hello world!

+        
hello world!

+        
hello world!

+        
hello world!

+        
hello world!

+    

+    "#
+    .trim();
+
+    let dom = Dom::parse(html).unwrap();
+
+    let body = rsx_rosetta::rsx_from_html(&dom);
+
+    let out = dioxus_autofmt::write_block_out(body).unwrap();
+
+    let expected = r#"
+    div {
+        h1 { "hello world!" }
+        h2 { "hello world!" }
+        h3 { "hello world!" }
+        h4 { "hello world!" }
+        h5 { "hello world!" }
+        h6 { "hello world!" }
+    }"#;
+    pretty_assertions::assert_eq!(&out, &expected);
+}
diff --git a/packages/rsx-rosetta/tests/raw.rs b/packages/rsx-rosetta/tests/raw.rs
new file mode 100644
index 000000000..a3ed1eef8
--- /dev/null
+++ b/packages/rsx-rosetta/tests/raw.rs
@@ -0,0 +1,21 @@
+use html_parser::Dom;
+
+#[test]
+fn raw_attribute() {
+    let html = r#"
+    

+        
hello world!

+    

+    "#
+    .trim();
+
+    let dom = Dom::parse(html).unwrap();
+
+    let body = rsx_rosetta::rsx_from_html(&dom);
+
+    let out = dioxus_autofmt::write_block_out(body).unwrap();
+
+    let expected = r#"
+    div { div { "unrecognizedattribute": "asd", "hello world!" } }"#;
+    pretty_assertions::assert_eq!(&out, &expected);
+}
diff --git a/packages/rsx-rosetta/tests/simple.rs b/packages/rsx-rosetta/tests/simple.rs
index b8fd095e1..3f3f8230a 100644
--- a/packages/rsx-rosetta/tests/simple.rs
+++ b/packages/rsx-rosetta/tests/simple.rs
@@ -9,8 +9,6 @@ fn simple_elements() {
         
hello world!

         
hello world!

         
hello world!

-        
hello world!

-        hello world!
     
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