v0.3.0

[gbj]

v0.3.0 is another incremental-ish release with a bunch of new features, many on the server end but including a bunch of general-purpose improvements. It includes several things that are breaking changes in the semantic-versioning sense, but you may find that not much breaks in your actual app. (For example, no code in any of the the three starter templates needed to change.)

New Features and Small Fixes

General

• No longer necessary to import __Props types for components; you can just use app::MyComponent; instead of app::{MyComponent, MyComponentProps};
• #[slot] syntax to define typed component children.
• Typed events in window_event_listener
• Optional event listeners with HtmlElement::optional_event
• Adds style: syntax in the view macro to set individual styles, much like class: sets individual classes
• Simplify work with resources by adding a Resource::update method to reactively update current value.
• expect_context::<T>(cx) shorthand for use_context::<T>(cx).unwrap()

Server

• Support for server functions that use GET requests (with either URL or CBOR encoding), for easier caching.
• extract helper to directly use Actix extractors in a server function.
• Allow more complex data like structs and Vec<_> as server function arguments (anything that can be de/serialized by serde_qs)
• Support for rendering a <Route/> in response to additional HTTP methods/verbs, e.g., the classic PHP/multi-page-app style in which a POST request can be sent to a page and it will render a response. (See methods prop.)
• Support for SsrMode::PartiallyBlocked which works like out-of-order streaming but replaces the HTML for any “blocked” fragments on the server. Improves UX when JS is disabled.

Developer Experience and Ergonomics

• Top-to-bottom integration with the tracing crate
• Adding some "real-time docs" via several runtime warnings and compile-time errors to prevent common bugs (for example, using leptos_meta with no features enabled or accidentally ending the view a component returns with a semicolon, meaning it renders nothing)

Performance

• Improve performance of Axum integration by spawning requests into a local threadpool.
• Improve performance of router on the server side by caching branch generation.
• Performance improvements in the reactive system and renderer, and closing a memory leak in <Suspense/>/<Transition/>.

And as always...

• Lots of bug fixes! Full changelog below.

Breaking Changes

• &'a str can no longer be directly rendered as a view: add .to_string() to effected variables. (Previously, all &str were converted to String by the renderer; using Cow<'static, str> now allows &'static str to be rendered without the additional allocation, at the cost of requiring the conversion of &str to String to be more explicit.)
• window_event_listener now takes a typed event (like ev::keypress). Use window_event_listener_untyped for the old behavior.
• When deriving Params to use typed router search/params, the FromStr error for any type needs to be Send + Sync so they are ErrorBoundary compatible
• Generics in create_slice have changed to allow different input types for getter/setter; only relevant if (for some reason?) you were specifying them manually.
• Exact interfaces for a few public-but-rarely-needed functions in the server integrations have changed.

What's Changed

• Fix server functions default macro on stable by @Demonthos in Fix server functions default macro on stable #784

• docs: add runtime "strict mode" checks that warn if you’re non-reactively accessing a value by @gbj in docs: add runtime "strict mode" checks that warn if you’re non-reactively accessing a value #786

• fix: warnings about untracked signal access in <Router/> by @gbj in fix: warnings about untracked signal access in <Router/> #790

• Remove unused fs dependency from leptos_config by @valeth in Remove unused fs dependency from leptos_config #787

• fix: untrack should disable warnings about untracked reads by @gbj in fix: untrack should disable warnings about untracked reads #791

• fix: nested <Suspense/> by @gbj in fix: nested <Suspense/> #781

• docs: <Form/> component by @gbj in docs: <Form/> component #792

• Fix server functions with non-copy server contexts by @Demonthos in Fix server functions with non-copy server contexts #785

• fix: unused warning on cx in server functions by @markcatley in fix: unused warning on cx in server functions #794

• docs: warn if you are using leptos_meta without features by @gbj in docs: warn if you are using leptos_meta without features #797

• fix: warning in Cargo.toml by @markcatley in fix: warning in Cargo.toml #800

• feat: Add ability to include options to event listeners by @Ofenhed in feat: Add ability to include options to event listeners #799

• fix: fixes Fixing scope handling on dynamic children #802 as a temporary measure without resorting to Fix DynChild scope handling #803 yet by @gbj in fix: fixes #802 as a temporary measure without resorting to #803 yet #804

• fix: prevent router panic on root-level <Redirect/> during route list generation by @gbj in fix: prevent router panic on root-level <Redirect/> during route list generation #801

• Reduce size of RuntimeId when slotmap is not used by @novacrazy in Reduce size of RuntimeId when slotmap is not used #805

• fix: unused warning in reactive signal diagnostics by @markcatley in fix: unused warning in reactive signal diagnostics #807

• Add the ability for server fns to be submitted via GET requests by @benwis in Add the ability for server fns to be submitted via GET requests #789

• chore: fix unused variable warning in property now that it's not memoized by @gbj in chore: fix unused variable warning in property now that it's not memoized #810

• Optimize Runtime::mark_dirty by @novacrazy in Optimize Runtime::mark_dirty #808

• Optimize memory usage of update methods by @novacrazy in Optimize memory usage of update methods #809

• fix: correctly escape HTML special characters in text nodes during SSR by @gbj in fix: correctly escape HTML special characters in text nodes during SSR #812

• Publish book ci by @bram209 in Publish book ci #817

• remove Leptos guide link by @bram209 in remove Leptos guide link #818

• docs: add sandbox links and max height by @gbj in docs: add sandbox links and max height #824

• fix: correctly pass server fn errors to client by @gbj in fix: correctly pass server fn errors to client #822

• fix: server functions with url as argument name (closes issue Server Function generates invalid code with an argument named url #823) by @gbj in fix: server functions with url as argument name (closes issue #823) #825

• chore: deny warnings on github actions by @markcatley in chore: deny warnings on github actions #814

• Use local pools for axum handlers by @akarras in Use local pools for axum handlers #815

• tests: update benchmarks by @gbj in tests: update benchmarks #827

• feat: make __Props imports unnecessary (closes Do not require FooProps for component Foo to be imported #746) by @gbj in feat: make __Props imports unnecessary (closes #746) #828

• Various optimizations, size reductions and stability improvements by @novacrazy in Various optimizations, size reductions and stability improvements #831

• Fix leaked memo nodes by @novacrazy in Fix leaked memo nodes #841

• [Fix] Correct broken MaybeSignal link by @hoangph271 in [Fix] Correct broken MaybeSignal link #840

• feat: rustls feature for reqwest and any other relevant dependencies by @gbj in feat: rustls feature for reqwest and any other relevant dependencies #842

• fix: don't entity-encode HTML special characters inside <script> or <style> (closes <script> and <Script> not decoding the children correctly #837) by @gbj in fix: don't entity-encode HTML special characters inside <script> or <style> (closes #837) #846

• feat: allow multiple HTTP request methods/verbs by @gbj in feat: allow multiple HTTP request methods/verbs #695

• [WIP] Trigger prototype by @novacrazy in [WIP] Trigger prototype #838

• fix static text nodes with curly braces in SSR by @gbj in fix static text nodes with curly braces in SSR #849

• docs: emit error when trying to combine global class and dynamic class in a bugged way by @gbj in docs: emit error when trying to combine global class and dynamic class in a bugged way #850

• fix: custom events in SSR mode by @gbj in fix: custom events in SSR mode #852

• fix: Strip & from the end of params queries by @mondeja in fix: Strip & from the end of params queries #854

• fix: match statement in leptos book by @chroth7 in fix: match statement in leptos book #860

• Fix the counter without macros test by @agilarity in Fix the counter without macros test #863

• feat: add ability to set node_ref and pass additional attributes to <Form/> and friends by @gbj in feat: add ability to set node_ref and pass additional attributes to <Form/> and friends #853

• Fixed typo in life cycle docs by @Stackingttv in Fixed typo in life cycle docs #869

• examples: fix error handling in fetch example by @gbj in examples: fix error handling in fetch example #870

• feat: add the ability to specify animations on route transitions by @gbj in feat: add the ability to specify animations on route transitions #736

• [fix] updated nix flakes lock files on session auth axum examples by @mustafasegf in [fix] updated nix flakes lock files on session auth axum examples #872

• docs: Add per-project toolchain override readme by @kamilogorek in docs: Add per-project toolchain override readme #876

• feat: add non-animation base classes to <AnimatedOutlet/> and <AnimatedRoutes/> by @gbj in feat: add non-animation base classes to <AnimatedOutlet/> and <AnimatedRoutes/> #877

• Use override key, if available, for server function calling by @snapbug in Use override key, if available, for server function calling #878

• feat: add expect_context function by @markcatley in feat: add expect_context function #864

• fix: rendering error in SSR InOrder/Async Mode by @hjin-me in fix: <For/> rendering error in SSR InOrder/Async Mode #879

• Split counter without macros web test by @agilarity in Split counter without macros web test #884

• fix: dispose of scope when server fns return error by @gbj in fix: dispose of scope when server fns return error #888

• perf: tiny optimization on primitive child values by @gbj in perf: tiny optimization on primitive child values #887

• chore(readme): add link to Matrix bridge by @filipdutescu in chore(readme): add link to Matrix bridge #894

• Fixes leptos_axum does not build on stable due to use of unstable OnceLock #890 that was using OnceLock, which is nightly only, by adding the once_cell crate as a dependency. by @OvermindDL1 in Fixes #890 that was using OnceLock, which is nightly only, by adding the once_cell crate as a dependency. #891

• This should solve ParamsMap / LinearMap serde serialization and deserialization ParamsMap / LinearMap serde serialization and deserialization #892 by @dgsantana in This should solve ParamsMap / LinearMap serde serialization and deserialization #892 #895

• feat: add ability to mutate resources by @gbj in feat: add ability to mutate resources #886

• fix: erroneous non-reactive access warning in undelegated events by @gbj in fix: erroneous non-reactive access warning in undelegated events #900

• perf: improve router performance on server by calculating route branches once by @gbj in perf: improve router performance on server by calculating route branches once #898

• Added get_untracked for node_ref. by @dgsantana in Added get_untracked for node_ref. #902

• Use cargo make to run tests for examples by @agilarity in Use cargo make to run tests for examples #904

• Add a window event listener with a callback that receives an event that has been cast to its non-generic type. by @loganbnielsen in Add a window event listener with a callback that receives an event that has been cast to its non-generic type. #910

• docs: compile error on mutually-exclusive features by @gbj in docs: compile error on mutually-exclusive features #911

• fix: issue with ordering of class attribute and class=("fancy-name-200", true) (closes class=("name", true) syntax not reordered correctly #907) by @gbj in fix: issue with ordering of class attribute and class=("fancy-name-200", true) (closes #907) #914

• change: add window_event_listener_untyped and deprecate window_event_listener pending 0.3.0 by @gbj in change: add window_event_listener_untyped and deprecate window_event_listener pending 0.3.0 #913

• feat: add slots by @yuuma03 in feat: add slots #909

• examples: fix broken counters tests by @gbj in examples: fix broken counters tests #915

• fix some issues with animated routing by @gbj in fix some issues with animated routing #889

• fix: panic when creating nested StoredValue by @gbj in fix: panic when creating nested StoredValue #920

• Tracing Updates by @benwis in Tracing Updates #908

• docs: fixed a minor typo in async readme by @escwxyz in docs: fixed a minor typo in async readme #921

• docs: removed extra unused code blocks in form.md by @escwxyz in docs: removed extra unused code blocks in form.md #923

• docs: fixed typo in interlude_styling.md by @escwxyz in docs: fixed typo in interlude_styling.md #924

• fix: features related compile error by @agilarity in fix: features related compile error #919

• fix: allow nested slots by @yuuma03 in fix: allow nested slots #928

• docs: add some content on server-side rendering by @gbj in docs: add some content on server-side rendering #930

• chore: specify dependency version for cached by @rodrigc in chore: specify dependency version for cached #929

• Remove need for LEPTOS_OUTPUT_NAME env var after compilation by @benwis in Remove need for LEPTOS_OUTPUT_NAME env var after compilation #899

• Added (potentially broken) timer example by @bluenote10 in Added (potentially broken) timer example #925

• Link to actual type instead of Into trait for component properties by @ModProg in Link to actual type instead of Into trait for component properties #932

• feat: add allow missing_docs to children field by @ModProg in feat: add allow missing_docs to children field #934

• Adds the GetCbor and GetJson to server macro documentation. by @dgsantana in Adds the GetCbor and GetJson to server macro documentation. #938

• Fix ServerFnError::Serialization error string by @mtsr in Fix ServerFnError::Serialization error string #939

• examples: better practice for view types in todos by @gbj in examples: better practice for view types in todos #940

• CI: fix unused variables breaking tests by @gbj in CI: fix unused variables breaking tests #950

• fix: generics on impl From slot to Vec<slot> by @yuuma03 in fix: generics on impl From slot to Vec<slot> #946

• feat: add Actix extract helper by @gbj in feat: add Actix extract helper #936

• Test business logic for counter_without_macros by @agilarity in Test business logic for counter_without_macros #927

• impl IntoView for component props by @jquesada2016 in impl IntoView for component props #948

• impl FromIterator for View by @ModProg in impl FromIterator for View #945

• Add From for RequestParts into Parts for Axum and add an option to ge… by @benwis in Add From for RequestParts into Parts for Axum and add an option to ge… #931

• fix: <ErrorBoundary/> toggling between states (closes issue <ErrorBoundary/> not rendering in release mode #820) by @gbj in fix: <ErrorBoundary/> toggling between states (closes issue #820) #957

• docs: add note on projecting children by @gbj in docs: add note on projecting children #959

• fix: escapes in doc comments on component properties by @ModProg in fix: escapes in doc comments on component properties #958

• Add wasm web test and common tasks by @agilarity in Add wasm web test and common tasks #954

• docs: note need for serde dependency for server functions (closes Document need for serde dependency when using #[server] #947) by @gbj in docs: note need for serde dependency for server functions (closes #947) #962

• fix: use a HashMap on Branches::initialize by @yuuma03 in fix: use a HashMap on Branches::initialize #966

• chore: fix typos by @fattenap in chore: fix typos #964

• feat: add collect_view(cx) by @ModProg in feat: add collect_view(cx) #956

• v0.3.0-alpha by @gbj in v0.3.0-alpha #968

• Replace serde_urlencoded with serde_html_form to support cross-input vec serverfn by @snapbug in Replace serde_urlencoded with serde_html_form to support cross-input vec serverfn #973

• change/fix: require FromStr errors on Params to be Send + Sync so they are ErrorBoundary compatible by @gbj in change/fix: require FromStr errors on Params to be Send + Sync so they are ErrorBoundary compatible #974

• Fix the lint issues in the counter example by @agilarity in Fix the lint issues in the counter example #971

• feat: add builder syntax for optional event listener by @gbj in feat: add builder syntax for optional event listener #969

• Fix lint issues in counter_isomorphic example by @agilarity in Fix lint issues in counter_isomorphic example #980

• fix: suppress warning loading local resource without <Suspense/> in hydrate mode (closes Resource::read() warnings should not show for local resources when reading outside <Suspense/> #979) by @gbj in fix: suppress warning loading local resource without <Suspense/> in hydrate mode (closes #979) #984

• feat: allow structs in server function arguments by @gbj in feat: allow structs in server function arguments #987

• docs: switch from compile errors to runtime warnings for incompatible feature flags by @gbj in docs: switch from compile errors to runtime warnings for incompatible feature flags #990

• docs: error when component ends with view! { ... }; (closes Better warnings when a component returns () #985) by @gbj in docs: error when component ends with view! { ... }; (closes #985) #993

• fix: lint issues in counters example by @agilarity in fix: lint issues in counters example #986

• fix: lint issues in erros_axum example by @agilarity in fix: lint issues in erros_axum example #988

• fix: lint issues in fetch example by @agilarity in fix: lint issues in fetch example #989

• fix: lint issues in hackernews example by @agilarity in fix: lint issues in hackernews example #991

• fix: lint issues in hackernews_axum example by @agilarity in fix: lint issues in hackernews_axum example #992

• fix: lint issues in login_with_token_csr_only example by @agilarity in fix: lint issues in login_with_token_csr_only example #995

• fix: lint issues in router example by @agilarity in fix: lint issues in router example #996

• fix: lint issues in session_auth_axum example by @agilarity in fix: lint issues in session_auth_axum example #997

• fix: lint issues in todo_app_sqlite example by @agilarity in fix: lint issues in todo_app_sqlite example #998

• fix: lint issues in todo_app_sqlite_axum example by @agilarity in fix: lint issues in todo_app_sqlite_axum example #999

• fix: lint issues in todo_app_sqlite_viz example by @agilarity in fix: lint issues in todo_app_sqlite_viz example #1000

• fix: lint issues in todomvc example by @agilarity in fix: lint issues in todomvc example #1001

• [docs] Reduce firmness of overlapping signal warning by @dglsparsons in [docs] Reduce firmness of overlapping signal warning #1004

• docs: document that <ActionForm/> only works with form-encoded server functions by @gbj in docs: document that <ActionForm/> only works with form-encoded server functions #1005

• fix: properly dispose of <Suspense/> scopes (closes Detached Nodes memory leak #834) by @gbj in fix: properly dispose of <Suspense/> scopes (closes #834) #1006

• test: lint examples with --all-features by @agilarity in test: lint examples with --all-features #1008

• feat: add style: to view by @gbj in feat: add style: to view #1009

• Relax Debug trait bounds by @Wadu436 in Relax Debug trait bounds #1010

• docs: add a server fn section by @gbj in docs: add a server fn section #1014

• book: close iframe tag on global state management page by @Wadu436 in book: close iframe tag on global state management page #1013

• docs: adjust Dynamic Attributes page by @FrankReh in docs: adjust Dynamic Attributes page #1011

• book: fix link to cargo-leptos README by @Wadu436 in book: fix link to cargo-leptos README #1012

• docs: add examples for manual server integration by @ChristopherPerry6060 in docs: add examples for manual server integration #1015

• Clean up examples after verification by @agilarity in Clean up examples after verification #1019

• build tailwind CSS with trunk by @agilarity in build tailwind CSS with trunk #1016

• [fix] indentation erros in examples by @hoangph271 in [fix] indentation erros in examples #1017

• fix: maintain insertion order of meta tags by @gbj in fix: maintain insertion order of meta tags #1021

• fix: corrects error-deserialization behavior of ActionForm (closes ActionForm should deserialize errors #1024) by @gbj in fix: corrects error-deserialization behavior of ActionForm (closes #1024) #1025

• feat: SsrMode::PartiallyBlocked by @gbj in feat: SsrMode::PartiallyBlocked #1026

• fix: flicking <Transition/> in release mode (closes Flickering <Transition> in release mode #960) by @gbj in fix: flicking <Transition/> in release mode (closes #960) #1030

• fix: avoid extra { escaping (closes Extra escaping with SSR rendering #1035) by @gbj in fix: avoid extra { escaping (closes #1035) #1038

• change: remove APIs that had been marked deprecated by @gbj in change: remove APIs that had been marked deprecated #1037

• Update slice.rs by @sjud in Update slice.rs #1036

• examples: fix trunk config to run tailwind at the right time by @flosse in examples: fix trunk config to run tailwind at the right time #1040

• Migrate axum integration to use with_state over layer(Extension by @snapbug in Migrate axum integration to use with_state over layer(Extension #1032

New Contributors

• @valeth made their first contribution in Remove unused fs dependency from leptos_config #787
• @markcatley made their first contribution in fix: unused warning on cx in server functions #794
• @Ofenhed made their first contribution in feat: Add ability to include options to event listeners #799
• @novacrazy made their first contribution in Reduce size of RuntimeId when slotmap is not used #805
• @bram209 made their first contribution in Publish book ci #817
• @akarras made their first contribution in Use local pools for axum handlers #815
• @hoangph271 made their first contribution in [Fix] Correct broken MaybeSignal link #840
• @chroth7 made their first contribution in fix: match statement in leptos book #860
• @agilarity made their first contribution in Fix the counter without macros test #863
• @Stackingttv made their first contribution in Fixed typo in life cycle docs #869
• @mustafasegf made their first contribution in [fix] updated nix flakes lock files on session auth axum examples #872
• @kamilogorek made their first contribution in docs: Add per-project toolchain override readme #876
• @hjin-me made their first contribution in fix: <For/> rendering error in SSR InOrder/Async Mode #879
• @filipdutescu made their first contribution in chore(readme): add link to Matrix bridge #894
• @OvermindDL1 made their first contribution in Fixes #890 that was using OnceLock, which is nightly only, by adding the once_cell crate as a dependency. #891
• @dgsantana made their first contribution in This should solve ParamsMap / LinearMap serde serialization and deserialization #892 #895
• @loganbnielsen made their first contribution in Add a window event listener with a callback that receives an event that has been cast to its non-generic type. #910
• @yuuma03 made their first contribution in feat: add slots #909
• @escwxyz made their first contribution in docs: fixed a minor typo in async readme #921
• @rodrigc made their first contribution in chore: specify dependency version for cached #929
• @bluenote10 made their first contribution in Added (potentially broken) timer example #925
• @mtsr made their first contribution in Fix ServerFnError::Serialization error string #939
• @fattenap made their first contribution in chore: fix typos #964
• @Wadu436 made their first contribution in Relax Debug trait bounds #1010
• @FrankReh made their first contribution in docs: adjust Dynamic Attributes page #1011
• @ChristopherPerry6060 made their first contribution in docs: add examples for manual server integration #1015
• @sjud made their first contribution in Update slice.rs #1036

Full Changelog: v0.2.5...v0.3.0

---

This discussion was created from the release `v0.3.0`.