reflex 0.8.16__py3-none-any.whl → 0.8.17__py3-none-any.whl

reflex/.templates/web/utils/state.js

@@ -665,7 +665,9 @@ export const connect = async (
       }
     }
     applyClientStorageDelta(client_storage, update.delta);
-    event_processing = !update.final;
+    if (update.final !== null) {
+      event_processing = !update.final;
+    }
     if (update.events) {
       queueEvents(update.events, socket, false, navigate, params);
     }

reflex/app.py

@@ -1556,11 +1556,14 @@ class App(MiddlewareMixin, LifespanMixin):
         )
 
     @contextlib.asynccontextmanager
-    async def modify_state(self, token: str) -> AsyncIterator[BaseState]:
+    async def modify_state(
+        self, token: str, background: bool = False
+    ) -> AsyncIterator[BaseState]:
         """Modify the state out of band.
 
         Args:
             token: The token to modify the state for.
+            background: Whether the modification is happening in a background task.
 
         Yields:
             The state to modify.
@@ -1581,7 +1584,10 @@ class App(MiddlewareMixin, LifespanMixin):
                 # When the state is modified reset dirty status and emit the delta to the frontend.
                 state._clean()
                 await self.event_namespace.emit_update(
-                    update=StateUpdate(delta=delta),
+                    update=StateUpdate(
+                        delta=delta,
+                        final=True if not background else None,
+                    ),
                     token=token,
                 )
 
@@ -1758,7 +1764,9 @@ async def process(
             constants.RouteVar.CLIENT_IP: client_ip,
         })
         # Get the state for the session exclusively.
-        async with app.state_manager.modify_state(event.substate_token) as state:
+        async with app.state_manager.modify_state(
+            event.substate_token, event=event
+        ) as state:
             # When this is a brand new instance of the state, signal the
             # frontend to reload before processing it.
             if (

reflex/compiler/templates.py

@@ -4,7 +4,7 @@ from __future__ import annotations
 
 import json
 from collections.abc import Iterable, Mapping
-from typing import TYPE_CHECKING, Any
+from typing import TYPE_CHECKING, Any, Literal
 
 from reflex import constants
 from reflex.constants import Hooks
@@ -492,13 +492,21 @@ def package_json_template(
     })
 
 
-def vite_config_template(base: str, hmr: bool, force_full_reload: bool):
+def vite_config_template(
+    base: str,
+    hmr: bool,
+    force_full_reload: bool,
+    experimental_hmr: bool,
+    sourcemap: bool | Literal["inline", "hidden"],
+):
     """Template for vite.config.js.
 
     Args:
         base: The base path for the Vite config.
         hmr: Whether to enable hot module replacement.
         force_full_reload: Whether to force a full reload on changes.
+        experimental_hmr: Whether to enable experimental HMR features.
+        sourcemap: The sourcemap configuration.
 
     Returns:
         Rendered vite.config.js content as string.
@@ -550,6 +558,7 @@ export default defineConfig((config) => ({{
   ].concat({"[fullReload()]" if force_full_reload else "[]"}),
   build: {{
     assetsDir: "{base}assets".slice(1),
+    sourcemap: {"true" if sourcemap is True else "false" if sourcemap is False else repr(sourcemap)},
     rollupOptions: {{
       onwarn(warning, warn) {{
         if (warning.code === "EVAL" && warning.id && warning.id.endsWith("state.js")) return;
@@ -570,6 +579,7 @@ export default defineConfig((config) => ({{
   }},
   experimental: {{
     enableNativePlugin: false,
+    hmr: {"true" if experimental_hmr else "false"},
   }},
   server: {{
     port: process.env.PORT,

reflex/components/base/error_boundary.py

@@ -4,7 +4,7 @@ from __future__ import annotations
 
 from reflex.components.component import Component
 from reflex.components.datadisplay.logo import svg_logo
-from reflex.components.el import a, button, details, div, h2, hr, p, pre, summary
+from reflex.components.el import a, button, div, h2, hr, p, pre, svg
 from reflex.event import EventHandler, set_clipboard
 from reflex.state import FrontendEventExceptionState
 from reflex.vars.base import Var
@@ -65,53 +65,67 @@ class ErrorBoundary(Component):
                     div(
                         div(
                             div(
+                                svg(
+                                    svg.circle(cx="12", cy="12", r="10"),
+                                    svg.path(d="M16 16s-1.5-2-4-2-4 2-4 2"),
+                                    svg.line(x1="9", x2="9.01", y1="9", y2="9"),
+                                    svg.line(x1="15", x2="15.01", y1="9", y2="9"),
+                                    xmlns="http://www.w3.org/2000/svg",
+                                    width="25vmin",
+                                    view_box="0 0 24 24",
+                                    class_name="lucide lucide-frown-icon lucide-frown",
+                                    custom_attrs={
+                                        "fill": "none",
+                                        "stroke": "currentColor",
+                                        "stroke-width": "2",
+                                        "stroke-linecap": "round",
+                                        "stroke-linejoin": "round",
+                                    },
+                                ),
                                 h2(
                                     "An error occurred while rendering this page.",
-                                    font_size="1.25rem",
+                                    font_size="5vmin",
                                     font_weight="bold",
                                 ),
-                                p(
-                                    "This is an error with the application itself.",
-                                    opacity="0.75",
-                                ),
-                                details(
-                                    summary("Error message", padding="0.5rem"),
-                                    div(
-                                        div(
-                                            pre(
-                                                Var(_js_expr=_ERROR_DISPLAY),
-                                            ),
-                                            padding="0.5rem",
-                                            width="fit-content",
-                                        ),
-                                        width="100%",
-                                        max_height="50vh",
-                                        overflow="auto",
-                                        background="#000",
-                                        color="#fff",
-                                        border_radius="0.25rem",
-                                    ),
-                                    button(
-                                        "Copy",
-                                        on_click=set_clipboard(
-                                            Var(_js_expr=_ERROR_DISPLAY)
-                                        ),
-                                        padding="0.35rem 0.75rem",
-                                        margin="0.5rem",
-                                        background="#fff",
-                                        color="#000",
-                                        border="1px solid #000",
-                                        border_radius="0.25rem",
-                                        font_weight="bold",
+                                opacity="0.5",
+                                display="flex",
+                                gap="4vmin",
+                                align_items="center",
+                            ),
+                            p(
+                                "This is an error with the application itself. Refreshing the page might help.",
+                                opacity="0.75",
+                                margin_block="1rem",
+                            ),
+                            div(
+                                div(
+                                    pre(
+                                        Var(_js_expr=_ERROR_DISPLAY),
                                     ),
+                                    padding="0.5rem",
+                                    width="fit-content",
                                 ),
-                                display="flex",
-                                flex_direction="column",
-                                gap="1rem",
-                                max_width="50ch",
-                                border="1px solid #888888",
-                                border_radius="0.25rem",
-                                padding="1rem",
+                                width="100%",
+                                background="color-mix(in srgb, currentColor 5%, transparent)",
+                                max_height="15rem",
+                                overflow="auto",
+                                border_radius="0.4rem",
+                            ),
+                            button(
+                                "Copy",
+                                on_click=set_clipboard(Var(_js_expr=_ERROR_DISPLAY)),
+                                padding="0.35rem 1.35rem",
+                                margin_block="0.5rem",
+                                margin_inline_start="auto",
+                                background="color-mix(in srgb, currentColor 15%, transparent)",
+                                border_radius="0.4rem",
+                                width="fit-content",
+                                _hover={
+                                    "background": "color-mix(in srgb, currentColor 25%, transparent)"
+                                },
+                                _active={
+                                    "background": "color-mix(in srgb, currentColor 35%, transparent)"
+                                },
                             ),
                             hr(
                                 border_color="currentColor",
@@ -131,7 +145,10 @@ class ErrorBoundary(Component):
                             ),
                             display="flex",
                             flex_direction="column",
-                            gap="1rem",
+                            gap="0.5rem",
+                            max_width="min(80ch, 90vw)",
+                            border_radius="0.25rem",
+                            padding="1rem",
                         ),
                         height="100%",
                         width="100%",

reflex/components/core/window_events.py

@@ -1,7 +1,12 @@
 """Window event listener component for Reflex."""
 
+from __future__ import annotations
+
+from typing import Any, cast
+
 import reflex as rx
 from reflex.components.base.fragment import Fragment
+from reflex.components.component import StatefulComponent, field
 from reflex.constants.compiler import Hooks
 from reflex.event import key_event, no_args_event_spec
 from reflex.vars.base import Var, VarData
@@ -61,6 +66,23 @@ class WindowEventListener(Fragment):
     on_popstate: rx.EventHandler[no_args_event_spec]
     on_storage: rx.EventHandler[_on_storage_spec]
 
+    hooks: list[str] = field(default_factory=list, is_javascript_property=False)
+
+    @classmethod
+    def create(cls, **props) -> WindowEventListener:
+        """Create a WindowEventListener component.
+
+        Args:
+            **props: The props to set on the component.
+
+        Returns:
+            The created component.
+        """
+        real_component = cast("WindowEventListener", super().create(**props))
+        hooks = StatefulComponent._fix_event_triggers(real_component)
+        real_component.hooks = hooks
+        return real_component
+
     def _exclude_props(self) -> list[str]:
         """Exclude event handler props from being passed to Fragment.
 
@@ -69,31 +91,30 @@ class WindowEventListener(Fragment):
         """
         return [*super()._exclude_props(), *self.event_triggers.keys()]
 
-    def add_hooks(self) -> list[str | Var[str]]:
+    def add_hooks(self) -> list[str | Var[Any]]:
         """Add hooks to register window event listeners.
 
         Returns:
             The hooks to add to the component.
         """
-        hooks = []
+        hooks: list[str | Var[Any]] = [*self.hooks]
 
         for prop_name, event_trigger in self.event_triggers.items():
             # Get JS event name: remove on_ prefix and underscores
             event_name = prop_name.removeprefix("on_").replace("_", "")
 
             hook_expr = f"""
-                    useEffect(() => {{
-                        if (typeof window === 'undefined') return;
-
-                        window.addEventListener('{event_name}', {event_trigger});
-                        return () => window.removeEventListener('{event_name}', {event_trigger});
-                    }}, []);
+useEffect(() => {{
+    if (typeof window === 'undefined') return;
+    const fn = {Var.create(event_trigger)};
+    window.addEventListener('{event_name}', fn);
+    return () => window.removeEventListener('{event_name}', fn);
+}}, []);
                 """
 
             hooks.append(
                 Var(
                     hook_expr,
-                    _var_type="str",
                     _var_data=VarData(position=Hooks.HookPosition.POST_TRIGGER),
                 )
             )

reflex/components/lucide/icon.py

@@ -6,7 +6,7 @@ from reflex.utils.imports import ImportVar
 from reflex.vars.base import LiteralVar, Var
 from reflex.vars.sequence import LiteralStringVar, StringVar
 
-LUCIDE_LIBRARY = "lucide-react@0.545.0"
+LUCIDE_LIBRARY = "lucide-react@0.546.0"
 
 
 class LucideIconComponent(Component):
@@ -1115,6 +1115,7 @@ LUCIDE_ICON_LIST = [
     "minimize",
     "minus",
     "monitor_check",
+    "monitor_cloud",
     "monitor_cog",
     "monitor_dot",
     "monitor_down",

reflex/components/lucide/icon.pyi

@@ -11,7 +11,7 @@ from reflex.components.core.breakpoints import Breakpoints
 from reflex.event import EventType, PointerEventInfo
 from reflex.vars.base import Var
 
-LUCIDE_LIBRARY = "lucide-react@0.545.0"
+LUCIDE_LIBRARY = "lucide-react@0.546.0"
 
 class LucideIconComponent(Component):
     @classmethod
@@ -1176,6 +1176,7 @@ LUCIDE_ICON_LIST = [
     "minimize",
     "minus",
     "monitor_check",
+    "monitor_cloud",
     "monitor_cog",
     "monitor_dot",
     "monitor_down",

reflex/components/plotly/plotly.py

@@ -72,7 +72,7 @@ class Plotly(NoSSRComponent):
 
     library = "react-plotly.js@2.6.0"
 
-    lib_dependencies: list[str] = ["plotly.js@3.1.1"]
+    lib_dependencies: list[str] = ["plotly.js@3.1.2"]
 
     tag = "Plot"
 
@@ -303,7 +303,7 @@ class PlotlyBasic(Plotly):
 
     library = "react-plotly.js@2.6.0"
 
-    lib_dependencies: list[str] = ["plotly.js-basic-dist-min@3.1.1"]
+    lib_dependencies: list[str] = ["plotly.js-basic-dist-min@3.1.2"]
 
     def add_imports(self) -> ImportDict | list[ImportDict]:
         """Add imports for the plotly basic component.
@@ -329,7 +329,7 @@ class PlotlyCartesian(Plotly):
 
     library = "react-plotly.js@2.6.0"
 
-    lib_dependencies: list[str] = ["plotly.js-cartesian-dist-min@3.1.1"]
+    lib_dependencies: list[str] = ["plotly.js-cartesian-dist-min@3.1.2"]
 
     def add_imports(self) -> ImportDict | list[ImportDict]:
         """Add imports for the plotly cartesian component.
@@ -355,7 +355,7 @@ class PlotlyGeo(Plotly):
 
     library = "react-plotly.js@2.6.0"
 
-    lib_dependencies: list[str] = ["plotly.js-geo-dist-min@3.1.1"]
+    lib_dependencies: list[str] = ["plotly.js-geo-dist-min@3.1.2"]
 
     def add_imports(self) -> ImportDict | list[ImportDict]:
         """Add imports for the plotly geo component.
@@ -381,7 +381,7 @@ class PlotlyGl3d(Plotly):
 
     library = "react-plotly.js@2.6.0"
 
-    lib_dependencies: list[str] = ["plotly.js-gl3d-dist-min@3.1.1"]
+    lib_dependencies: list[str] = ["plotly.js-gl3d-dist-min@3.1.2"]
 
     def add_imports(self) -> ImportDict | list[ImportDict]:
         """Add imports for the plotly 3d component.
@@ -407,7 +407,7 @@ class PlotlyGl2d(Plotly):
 
     library = "react-plotly.js@2.6.0"
 
-    lib_dependencies: list[str] = ["plotly.js-gl2d-dist-min@3.1.1"]
+    lib_dependencies: list[str] = ["plotly.js-gl2d-dist-min@3.1.2"]
 
     def add_imports(self) -> ImportDict | list[ImportDict]:
         """Add imports for the plotly 2d component.
@@ -433,7 +433,7 @@ class PlotlyMapbox(Plotly):
 
     library = "react-plotly.js@2.6.0"
 
-    lib_dependencies: list[str] = ["plotly.js-mapbox-dist-min@3.1.1"]
+    lib_dependencies: list[str] = ["plotly.js-mapbox-dist-min@3.1.2"]
 
     def add_imports(self) -> ImportDict | list[ImportDict]:
         """Add imports for the plotly mapbox component.
@@ -459,7 +459,7 @@ class PlotlyFinance(Plotly):
 
     library = "react-plotly.js@2.6.0"
 
-    lib_dependencies: list[str] = ["plotly.js-finance-dist-min@3.1.1"]
+    lib_dependencies: list[str] = ["plotly.js-finance-dist-min@3.1.2"]
 
     def add_imports(self) -> ImportDict | list[ImportDict]:
         """Add imports for the plotly finance component.
@@ -485,7 +485,7 @@ class PlotlyStrict(Plotly):
 
     library = "react-plotly.js@2.6.0"
 
-    lib_dependencies: list[str] = ["plotly.js-strict-dist-min@3.1.1"]
+    lib_dependencies: list[str] = ["plotly.js-strict-dist-min@3.1.2"]
 
     def add_imports(self) -> ImportDict | list[ImportDict]:
         """Add imports for the plotly strict component.

reflex/components/recharts/recharts.py

@@ -8,7 +8,7 @@ from reflex.components.component import Component, MemoizationLeaf, NoSSRCompone
 class Recharts(Component):
     """A component that wraps a recharts lib."""
 
-    library = "recharts@3.2.1"
+    library = "recharts@3.3.0"
 
     def _get_style(self) -> dict:
         return {"wrapperStyle": self.style}
@@ -17,7 +17,7 @@ class Recharts(Component):
 class RechartsCharts(NoSSRComponent, MemoizationLeaf):
     """A component that wraps a recharts lib."""
 
-    library = "recharts@3.2.1"
+    library = "recharts@3.3.0"
 
 
 LiteralAnimationEasing = Literal["ease", "ease-in", "ease-out", "ease-in-out", "linear"]

reflex/constants/installer.py

@@ -143,11 +143,11 @@ class PackageJson(SimpleNamespace):
         "postcss-import": "16.1.1",
         "@react-router/dev": _react_router_version,
         "@react-router/fs-routes": _react_router_version,
-        "vite": "npm:rolldown-vite@7.1.17",
+        "vite": "npm:rolldown-vite@7.1.18",
     }
     OVERRIDES = {
         # This should always match the `react` version in DEPENDENCIES for recharts compatibility.
         "react-is": _react_version,
         "cookie": "1.0.2",
-        "vite": "npm:rolldown-vite@7.1.17",
+        "vite": "npm:rolldown-vite@7.1.18",
     }

reflex/environment.py

@@ -17,6 +17,7 @@ from typing import (
     Annotated,
     Any,
     Generic,
+    Literal,
     TypeVar,
     get_args,
     get_origin,
@@ -256,6 +257,27 @@ def interpret_env_var_value(
         return interpret_existing_path_env(value, field_name)
     if field_type is Plugin:
         return interpret_plugin_env(value, field_name)
+    if get_origin(field_type) is Literal:
+        literal_values = get_args(field_type)
+        for literal_value in literal_values:
+            if isinstance(literal_value, str) and literal_value == value:
+                return literal_value
+            if isinstance(literal_value, bool):
+                try:
+                    interpreted_bool = interpret_boolean_env(value, field_name)
+                    if interpreted_bool == literal_value:
+                        return interpreted_bool
+                except EnvironmentVarValueError:
+                    continue
+            if isinstance(literal_value, int):
+                try:
+                    interpreted_int = interpret_int_env(value, field_name)
+                    if interpreted_int == literal_value:
+                        return interpreted_int
+                except EnvironmentVarValueError:
+                    continue
+        msg = f"Invalid literal value: {value!r} for {field_name}, expected one of {literal_values}"
+        raise EnvironmentVarValueError(msg)
     if get_origin(field_type) in (list, Sequence):
         return [
             interpret_env_var_value(
@@ -687,6 +709,12 @@ class EnvironmentVariables:
     # Whether to force a full reload on changes.
     VITE_FORCE_FULL_RELOAD: EnvVar[bool] = env_var(False)
 
+    # Whether to enable Rolldown's experimental HMR.
+    VITE_EXPERIMENTAL_HMR: EnvVar[bool] = env_var(False)
+
+    # Whether to generate sourcemaps for the frontend.
+    VITE_SOURCEMAP: EnvVar[Literal[False, True, "inline", "hidden"]] = env_var(False)  # noqa: RUF038
+
     # Whether to enable SSR for the frontend.
     REFLEX_SSR: EnvVar[bool] = env_var(True)
 
@@ -696,6 +724,9 @@ class EnvironmentVariables:
     # How long to delay writing updated states to disk. (Higher values mean less writes, but more chance of lost data.)
     REFLEX_STATE_MANAGER_DISK_DEBOUNCE_SECONDS: EnvVar[float] = env_var(2.0)
 
+    # How long to wait between automatic reload on frontend error to avoid reload loops.
+    REFLEX_AUTO_RELOAD_COOLDOWN_TIME_MS: EnvVar[int] = env_var(10_000)
+
 
 environment = EnvironmentVariables()
 

reflex/istate/manager/__init__.py

@@ -4,14 +4,27 @@ import contextlib
 import dataclasses
 from abc import ABC, abstractmethod
 from collections.abc import AsyncIterator
+from typing import TypedDict
+
+from typing_extensions import ReadOnly, Unpack
 
 from reflex import constants
 from reflex.config import get_config
+from reflex.event import Event
 from reflex.state import BaseState
 from reflex.utils import console, prerequisites
 from reflex.utils.exceptions import InvalidStateManagerModeError
 
 
+class StateModificationContext(TypedDict, total=False):
+    """The context for modifying state."""
+
+    event: ReadOnly[Event]
+
+
+EmptyContext = StateModificationContext()
+
+
 @dataclasses.dataclass
 class StateManager(ABC):
     """A class to manage many client states."""
@@ -71,21 +84,30 @@ class StateManager(ABC):
         """
 
     @abstractmethod
-    async def set_state(self, token: str, state: BaseState):
+    async def set_state(
+        self,
+        token: str,
+        state: BaseState,
+        **context: Unpack[StateModificationContext],
+    ):
         """Set the state for a token.
 
         Args:
             token: The token to set the state for.
             state: The state to set.
+            context: The state modification context.
         """
 
     @abstractmethod
     @contextlib.asynccontextmanager
-    async def modify_state(self, token: str) -> AsyncIterator[BaseState]:
+    async def modify_state(
+        self, token: str, **context: Unpack[StateModificationContext]
+    ) -> AsyncIterator[BaseState]:
         """Modify the state for a token while holding exclusive lock.
 
         Args:
             token: The token to modify the state for.
+            context: The state modification context.
 
         Yields:
             The state for the token.

reflex/istate/manager/disk.py

@@ -9,10 +9,14 @@ from collections.abc import AsyncIterator
 from hashlib import md5
 from pathlib import Path
 
-from typing_extensions import override
+from typing_extensions import Unpack, override
 
 from reflex.environment import environment
-from reflex.istate.manager import StateManager, _default_token_expiration
+from reflex.istate.manager import (
+    StateManager,
+    StateModificationContext,
+    _default_token_expiration,
+)
 from reflex.state import BaseState, _split_substate_key, _substate_key
 from reflex.utils import console, path_ops, prerequisites
 from reflex.utils.misc import run_in_thread
@@ -301,12 +305,15 @@ class StateManagerDisk(StateManager):
                     await asyncio.sleep(0)  # Yield to allow the task to start.
 
     @override
-    async def set_state(self, token: str, state: BaseState):
+    async def set_state(
+        self, token: str, state: BaseState, **context: Unpack[StateModificationContext]
+    ):
         """Set the state for a token.
 
         Args:
             token: The token to set the state for.
             state: The state to set.
+            context: The state modification context.
         """
         client_token, _ = _split_substate_key(token)
         if self._write_debounce_seconds > 0:
@@ -325,11 +332,14 @@ class StateManagerDisk(StateManager):
 
     @override
     @contextlib.asynccontextmanager
-    async def modify_state(self, token: str) -> AsyncIterator[BaseState]:
+    async def modify_state(
+        self, token: str, **context: Unpack[StateModificationContext]
+    ) -> AsyncIterator[BaseState]:
         """Modify the state for a token while holding exclusive lock.
 
         Args:
             token: The token to modify the state for.
+            context: The state modification context.
 
         Yields:
             The state for the token.
@@ -344,7 +354,7 @@ class StateManagerDisk(StateManager):
         async with self._states_locks[client_token]:
             state = await self.get_state(token)
             yield state
-            await self.set_state(token, state)
+            await self.set_state(token, state, **context)
 
     async def close(self):
         """Close the state manager, flushing any pending writes to disk."""

reflex/istate/manager/memory.py

@@ -5,9 +5,9 @@ import contextlib
 import dataclasses
 from collections.abc import AsyncIterator
 
-from typing_extensions import override
+from typing_extensions import Unpack, override
 
-from reflex.istate.manager import StateManager
+from reflex.istate.manager import StateManager, StateModificationContext
 from reflex.state import BaseState, _split_substate_key
 
 
@@ -43,23 +43,32 @@ class StateManagerMemory(StateManager):
         return self.states[token]
 
     @override
-    async def set_state(self, token: str, state: BaseState):
+    async def set_state(
+        self,
+        token: str,
+        state: BaseState,
+        **context: Unpack[StateModificationContext],
+    ):
         """Set the state for a token.
 
         Args:
             token: The token to set the state for.
             state: The state to set.
+            context: The state modification context.
         """
         token = _split_substate_key(token)[0]
         self.states[token] = state
 
     @override
     @contextlib.asynccontextmanager
-    async def modify_state(self, token: str) -> AsyncIterator[BaseState]:
+    async def modify_state(
+        self, token: str, **context: Unpack[StateModificationContext]
+    ) -> AsyncIterator[BaseState]:
         """Modify the state for a token while holding exclusive lock.
 
         Args:
             token: The token to modify the state for.
+            context: The state modification context.
 
         Yields:
             The state for the token.

reflex/istate/manager/redis.py

@@ -10,11 +10,15 @@ from collections.abc import AsyncIterator
 from redis import ResponseError
 from redis.asyncio import Redis
 from redis.asyncio.client import PubSub
-from typing_extensions import override
+from typing_extensions import Unpack, override
 
 from reflex.config import get_config
 from reflex.environment import environment
-from reflex.istate.manager import StateManager, _default_token_expiration
+from reflex.istate.manager import (
+    StateManager,
+    StateModificationContext,
+    _default_token_expiration,
+)
 from reflex.state import BaseState, _split_substate_key, _substate_key
 from reflex.utils import console
 from reflex.utils.exceptions import (
@@ -261,7 +265,9 @@ class StateManagerRedis(StateManager):
         self,
         token: str,
         state: BaseState,
+        *,
         lock_id: bytes | None = None,
+        **context: Unpack[StateModificationContext],
     ):
         """Set the state for a token.
 
@@ -269,6 +275,7 @@ class StateManagerRedis(StateManager):
             token: The token to set the state for.
             state: The state to set.
             lock_id: If provided, the lock_key must be set to this value to set the state.
+            context: The event context.
 
         Raises:
             LockExpiredError: If lock_id is provided and the lock for the token is not held by that ID.
@@ -283,6 +290,11 @@ class StateManagerRedis(StateManager):
                 f"Lock expired for token {token} while processing. Consider increasing "
                 f"`app.state_manager.lock_expiration` (currently {self.lock_expiration}) "
                 "or use `@rx.event(background=True)` decorator for long-running tasks."
+                + (
+                    f" Happened in event: {event.name}"
+                    if (event := context.get("event")) is not None
+                    else ""
+                )
             )
             raise LockExpiredError(msg)
         if lock_id is not None:
@@ -292,7 +304,12 @@ class StateManagerRedis(StateManager):
             if time_taken > self.lock_warning_threshold / 1000:
                 console.warn(
                     f"Lock for token {token} was held too long {time_taken=}s, "
-                    f"use `@rx.event(background=True)` decorator for long-running tasks.",
+                    f"use `@rx.event(background=True)` decorator for long-running tasks."
+                    + (
+                        f" Happened in event: {event.name}"
+                        if (event := context.get("event")) is not None
+                        else ""
+                    ),
                     dedupe=True,
                 )
 
@@ -308,7 +325,8 @@ class StateManagerRedis(StateManager):
                 self.set_state(
                     _substate_key(client_token, substate),
                     substate,
-                    lock_id,
+                    lock_id=lock_id,
+                    **context,
                 ),
                 name=f"reflex_set_state|{client_token}|{substate.get_full_name()}",
             )
@@ -330,11 +348,14 @@ class StateManagerRedis(StateManager):
 
     @override
     @contextlib.asynccontextmanager
-    async def modify_state(self, token: str) -> AsyncIterator[BaseState]:
+    async def modify_state(
+        self, token: str, **context: Unpack[StateModificationContext]
+    ) -> AsyncIterator[BaseState]:
         """Modify the state for a token while holding exclusive lock.
 
         Args:
             token: The token to modify the state for.
+            context: The state modification context.
 
         Yields:
             The state for the token.
@@ -342,7 +363,7 @@ class StateManagerRedis(StateManager):
         async with self._lock(token) as lock_id:
             state = await self.get_state(token)
             yield state
-            await self.set_state(token, state, lock_id)
+            await self.set_state(token, state, lock_id=lock_id, **context)
 
     @staticmethod
     def _lock_key(token: str) -> bytes:

reflex/istate/proxy.py

@@ -131,7 +131,9 @@ class StateProxy(wrapt.ObjectProxy):
 
         await self._self_actx_lock.acquire()
         self._self_actx_lock_holder = current_task
-        self._self_actx = self._self_app.modify_state(token=self._self_substate_token)
+        self._self_actx = self._self_app.modify_state(
+            token=self._self_substate_token, background=True
+        )
         mutable_state = await self._self_actx.__aenter__()
         super().__setattr__(
             "__wrapped__", mutable_state.get_substate(self._self_substate_path)
@@ -198,7 +200,7 @@ class StateProxy(wrapt.ObjectProxy):
             )
             raise ImmutableStateError(msg)
 
-        value = super().__getattr__(name)
+        value = super().__getattr__(name)  # pyright: ignore[reportAttributeAccessIssue]
         if not name.startswith("_self_") and isinstance(value, MutableProxy):
             # ensure mutations to these containers are blocked unless proxy is _mutable
             return ImmutableMutableProxy(
@@ -397,7 +399,7 @@ class MutableProxy(wrapt.ObjectProxy):
     }
 
     # Dynamically generated classes for tracking dataclass mutations.
-    __dataclass_proxies__: dict[type, type] = {}
+    __dataclass_proxies__: dict[str, type] = {}
 
     def __new__(cls, wrapped: Any, *args, **kwargs) -> MutableProxy:
         """Create a proxy instance for a mutable object that tracks changes.
@@ -427,7 +429,7 @@ class MutableProxy(wrapt.ObjectProxy):
                     },
                 )
             cls = cls.__dataclass_proxies__[wrapper_cls_name]
-        return super().__new__(cls)
+        return super().__new__(cls)  # pyright: ignore[reportArgumentType]
 
     def __init__(self, wrapped: Any, state: BaseState, field_name: str):
         """Create a proxy for a mutable object that tracks changes.
@@ -543,7 +545,7 @@ class MutableProxy(wrapt.ObjectProxy):
         Returns:
             The attribute value.
         """
-        value = super().__getattr__(__name)
+        value = super().__getattr__(__name)  # pyright: ignore[reportAttributeAccessIssue]
 
         if callable(value):
             if __name in self.__mark_dirty_attrs__:
@@ -554,7 +556,7 @@ class MutableProxy(wrapt.ObjectProxy):
                 # Wrap methods that may return mutable objects tied to the state.
                 value = wrapt.FunctionWrapper(
                     value,
-                    self._wrap_recursive_decorator,
+                    self._wrap_recursive_decorator,  # pyright: ignore[reportArgumentType]
                 )
 
             if (
@@ -564,8 +566,8 @@ class MutableProxy(wrapt.ObjectProxy):
             ):
                 # Wrap methods called on Base subclasses, which might do _anything_
                 return wrapt.FunctionWrapper(
-                    functools.partial(value.__func__, self),  # pyright: ignore [reportFunctionMemberAccess]
-                    self._wrap_recursive_decorator,
+                    functools.partial(value.__func__, self),  # pyright: ignore [reportFunctionMemberAccess, reportAttributeAccessIssue]
+                    self._wrap_recursive_decorator,  # pyright: ignore[reportArgumentType]
                 )
 
         if is_mutable_type(type(value)) and __name not in (
@@ -587,7 +589,7 @@ class MutableProxy(wrapt.ObjectProxy):
         Returns:
             The item value.
         """
-        value = super().__getitem__(key)
+        value = super().__getitem__(key)  # pyright: ignore[reportAttributeAccessIssue]
         if isinstance(key, slice) and isinstance(value, list):
             return [self._wrap_recursive(item) for item in value]
         # Recursively wrap mutable items retrieved through this proxy.
@@ -599,7 +601,7 @@ class MutableProxy(wrapt.ObjectProxy):
         Yields:
             Each item value (possibly wrapped in MutableProxy).
         """
-        for value in super().__iter__():
+        for value in super().__iter__():  # pyright: ignore[reportAttributeAccessIssue]
             # Recursively wrap mutable items retrieved through this proxy.
             yield self._wrap_recursive(value)
 
@@ -617,7 +619,7 @@ class MutableProxy(wrapt.ObjectProxy):
         Args:
             key: The key of the item.
         """
-        self._mark_dirty(super().__delitem__, args=(key,))
+        self._mark_dirty(super().__delitem__, args=(key,))  # pyright: ignore[reportAttributeAccessIssue]
 
     def __setitem__(self, key: str, value: Any):
         """Set the item on the proxied object and mark state dirty.
@@ -626,7 +628,7 @@ class MutableProxy(wrapt.ObjectProxy):
             key: The key of the item.
             value: The value of the item.
         """
-        self._mark_dirty(super().__setitem__, args=(key, value))
+        self._mark_dirty(super().__setitem__, args=(key, value))  # pyright: ignore[reportAttributeAccessIssue]
 
     def __setattr__(self, name: str, value: Any):
         """Set the attribute on the proxied object and mark state dirty.

reflex/plugins/tailwind_v4.py

@@ -17,7 +17,7 @@ class Constants(SimpleNamespace):
     """Tailwind constants."""
 
     # The Tailwindcss version
-    VERSION = "tailwindcss@4.1.14"
+    VERSION = "tailwindcss@4.1.15"
     # The Tailwind config.
     CONFIG = "tailwind.config.js"
     # Default Tailwind content paths
@@ -156,7 +156,7 @@ class TailwindV4Plugin(TailwindPlugin):
         return [
             *super().get_frontend_development_dependencies(**context),
             Constants.VERSION,
-            "@tailwindcss/postcss@4.1.14",
+            "@tailwindcss/postcss@4.1.15",
         ]
 
     def pre_compile(self, **context):

reflex/state.py

@@ -11,11 +11,12 @@ import datetime
 import functools
 import inspect
 import pickle
+import re
 import sys
 import time
 import typing
 import warnings
-from collections.abc import AsyncIterator, Callable, Sequence
+from collections.abc import AsyncIterator, Callable, Iterator, Sequence
 from enum import Enum
 from hashlib import md5
 from importlib.util import find_spec
@@ -34,6 +35,7 @@ from reflex.event import (
     Event,
     EventHandler,
     EventSpec,
+    call_script,
     fix_events,
 )
 from reflex.istate import HANDLED_PICKLE_ERRORS, debug_failed_pickles
@@ -523,15 +525,17 @@ class BaseState(EvenMoreBasicBaseState):
 
         new_backend_vars = {
             name: value if not isinstance(value, Field) else value.default_value()
-            for name, value in list(cls.__dict__.items())
-            if types.is_backend_base_variable(name, cls)
+            for mixin_cls in [*cls._mixins(), cls]
+            for name, value in list(mixin_cls.__dict__.items())
+            if types.is_backend_base_variable(name, mixin_cls)
         }
         # Add annotated backend vars that may not have a default value.
         new_backend_vars.update({
             name: cls._get_var_default(name, annotation_value)
-            for name, annotation_value in cls._get_type_hints().items()
+            for mixin_cls in [*cls._mixins(), cls]
+            for name, annotation_value in mixin_cls._get_type_hints().items()
             if name not in new_backend_vars
-            and types.is_backend_base_variable(name, cls)
+            and types.is_backend_base_variable(name, mixin_cls)
         })
 
         cls.backend_vars = {
@@ -579,9 +583,6 @@ class BaseState(EvenMoreBasicBaseState):
                     cls.computed_vars[name] = newcv
                     cls.vars[name] = newcv
                     continue
-                if types.is_backend_base_variable(name, mixin_cls):
-                    cls.backend_vars[name] = copy.deepcopy(value)
-                    continue
                 if events.get(name) is not None:
                     continue
                 if not cls._item_is_event_handler(name, value):
@@ -1779,7 +1780,7 @@ class BaseState(EvenMoreBasicBaseState):
             return StateUpdate(
                 delta=delta,
                 events=fixed_events,
-                final=final if not handler.is_background else True,
+                final=final if not handler.is_background else None,
             )
         except Exception as ex:
             state._clean()
@@ -2471,11 +2472,34 @@ def dynamic(func: Callable[[T], Component]):
     return wrapper
 
 
+# sessionStorage key holding the ms timestamp of the last reload on error
+LAST_RELOADED_KEY = "reflex_last_reloaded_on_error"
+
+
 class FrontendEventExceptionState(State):
     """Substate for handling frontend exceptions."""
 
+    # If the frontend error message contains any of these strings, automatically reload the page.
+    auto_reload_on_errors: ClassVar[list[re.Pattern]] = [
+        re.compile(  # Chrome/Edge
+            re.escape("TypeError: Cannot read properties of null")
+        ),
+        re.compile(re.escape("TypeError: null is not an object")),  # Safari
+        re.compile(r"TypeError: can't access property \".*\" of null"),  # Firefox
+        # Firefox: property access is on a function that returns null.
+        re.compile(
+            re.escape("TypeError: can't access property \"")
+            + r".*"
+            + re.escape('", ')
+            + r".*"
+            + re.escape(" is null")
+        ),
+    ]
+
     @event
-    def handle_frontend_exception(self, info: str, component_stack: str) -> None:
+    def handle_frontend_exception(
+        self, info: str, component_stack: str
+    ) -> Iterator[EventSpec]:
         """Handle frontend exceptions.
 
         If a frontend exception handler is provided, it will be called.
@@ -2485,7 +2509,21 @@ class FrontendEventExceptionState(State):
             info: The exception information.
             component_stack: The stack trace of the component where the exception occurred.
 
+        Yields:
+            Optional auto-reload event for certain errors outside cooldown period.
         """
+        # Handle automatic reload for certain errors.
+        if type(self).auto_reload_on_errors and any(
+            error.search(info) for error in type(self).auto_reload_on_errors
+        ):
+            yield call_script(
+                f"const last_reload = parseInt(window.sessionStorage.getItem('{LAST_RELOADED_KEY}')) || 0;"
+                f"if (Date.now() - last_reload > {environment.REFLEX_AUTO_RELOAD_COOLDOWN_TIME_MS.get()})"
+                "{"
+                f"window.sessionStorage.setItem('{LAST_RELOADED_KEY}', Date.now().toString());"
+                "window.location.reload();"
+                "}"
+            )
         prerequisites.get_and_validate_app().app.frontend_exception_handler(
             Exception(info)
         )
@@ -2684,7 +2722,7 @@ class StateUpdate:
     events: list[Event] = dataclasses.field(default_factory=list)
 
     # Whether this is the final state update for the event.
-    final: bool = True
+    final: bool | None = True
 
     def json(self) -> str:
         """Convert the state update to a JSON string.

reflex/utils/frontend_skeleton.py

@@ -195,6 +195,8 @@ def _compile_vite_config(config: Config):
         base=base,
         hmr=environment.VITE_HMR.get(),
         force_full_reload=environment.VITE_FORCE_FULL_RELOAD.get(),
+        experimental_hmr=environment.VITE_EXPERIMENTAL_HMR.get(),
+        sourcemap=environment.VITE_SOURCEMAP.get(),
     )
 
 

{reflex-0.8.16.dist-info → reflex-0.8.17.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: reflex
-Version: 0.8.16
+Version: 0.8.17
 Summary: Web apps in pure Python.
 Project-URL: homepage, https://reflex.dev
 Project-URL: repository, https://github.com/reflex-dev/reflex
@@ -31,12 +31,12 @@ Requires-Dist: pydantic<3.0,>=1.10.21
 Requires-Dist: python-multipart<1.0,>=0.0.20
 Requires-Dist: python-socketio<6.0,>=5.12.0
 Requires-Dist: redis<7.0,>=5.2.1
-Requires-Dist: reflex-hosting-cli>=0.1.55
+Requires-Dist: reflex-hosting-cli>=0.1.57
 Requires-Dist: rich<15,>=13
 Requires-Dist: sqlmodel<0.1,>=0.0.27
 Requires-Dist: starlette>=0.47.0
 Requires-Dist: typing-extensions>=4.13.0
-Requires-Dist: wrapt<2.0,>=1.17.0
+Requires-Dist: wrapt<3.0,>=1.17.0
 Provides-Extra: db
 Requires-Dist: alembic<2.0,>=1.15.2; extra == 'db'
 Requires-Dist: pydantic<3.0,>=1.10.21; extra == 'db'
@@ -86,25 +86,50 @@ See our [architecture page](https://reflex.dev/blog/2024-03-21-reflex-architectu
 
 ## ⚙️ Installation
 
-Open a terminal and run (Requires Python 3.10+):
-
-```bash
-pip install reflex
-```
+**Important:** We strongly recommend using a virtual environment to ensure the `reflex` command is available in your PATH.
 
 ## 🥳 Create your first app
 
-Installing `reflex` also installs the `reflex` command line tool.
+### 1. Create the project directory
 
-Test that the install was successful by creating a new project. (Replace `my_app_name` with your project name):
+Replace `my_app_name` with your project name:
 
 ```bash
 mkdir my_app_name
 cd my_app_name
+```
+
+### 2. Set up a virtual environment
+
+Create and activate virtual environment
+
+```bash
+# On Windows:
+python -m venv .venv
+.venv\Scripts\activate
+
+# On macOS/Linux:
+python3 -m venv .venv
+source .venv/bin/activate
+```
+
+### 3. Install Reflex
+
+Reflex is available as a pip package (Requires Python 3.10+):
+
+```bash
+pip install reflex
+```
+
+### 4. Initialize the project
+
+This command initializes a template app in your new directory:
+
+```bash
 reflex init
 ```
 
-This command initializes a template app in your new directory.
+### 5. Run the app
 
 You can run this app in development mode:
 
@@ -116,6 +141,10 @@ You should see your app running at http://localhost:3000.
 
 Now you can modify the source code in `my_app_name/my_app_name.py`. Reflex has fast refreshes so you can see your changes instantly when you save your code.
 
+### Troubleshooting
+
+If you installed Reflex without a virtual environment and the `reflex` command is not found, you can run commands using: `python3 -m reflex init` and `python3 -m reflex run`
+
 ## 🫧 Example App
 
 Let's go over an example: creating an image generation UI around [DALL·E](https://platform.openai.com/docs/guides/images/image-generation?context=node). For simplicity, we just call the [OpenAI API](https://platform.openai.com/docs/api-reference/authentication), but you could replace this with an ML model run locally.

{reflex-0.8.16.dist-info → reflex-0.8.17.dist-info}/RECORD

@@ -2,18 +2,18 @@ reflex/__init__.py,sha256=7iJASSyU1dxLM-l6q6gFAkw6FniXvawAekgfwN5zKjM,10328
 reflex/__init__.pyi,sha256=Yy3exOO_7-O7fCjTKO1VDFbjPyeMM7F12WBnEXWx_tk,10428
 reflex/__main__.py,sha256=6cVrGEyT3j3tEvlEVUatpaYfbB5EF3UVY-6vc_Z7-hw,108
 reflex/admin.py,sha256=Nbc38y-M8iaRBvh1W6DQu_D3kEhO8JFvxrog4q2cB_E,434
-reflex/app.py,sha256=noSvr5FnmbNeQM7c_wK8fAedaMkzdTB2Lu49P6WULNM,79082
+reflex/app.py,sha256=s3Grrt3p_Lsk9I1gOhEaxyMj0Zj0IgmfFOzmqlQU3IM,79352
 reflex/assets.py,sha256=l5O_mlrTprC0lF7Rc_McOe3a0OtSLnRdNl_PqCpDCBA,3431
 reflex/base.py,sha256=ROoDZCLWyEdVqfYKnhYKPZINklTl5nHKWo2x0J4MfoE,2327
 reflex/config.py,sha256=LsHAtdH4nkSn3q_Ie-KNdOGdflLXrFICUQov29oFjVk,21229
-reflex/environment.py,sha256=i2uDE6OZk8ISl4gzw8ulpt5hB0qKNVtjZ7lDJIgEw-g,24970
+reflex/environment.py,sha256=-RpVj3yM8lX4c8T7Z3YAAX0PV92DHILEuHkbxWwq0kk,26460
 reflex/event.py,sha256=8vaqS2MBVTQwMVEemtKpjLlMxdlM95IO8u8U9YB_31Q,76443
 reflex/model.py,sha256=d9qCuIEK0mscG2Ng3HTsEgS39rXOfzqXzLZOl3DG_fc,22487
 reflex/page.py,sha256=ssCbMVFuIy60vH-YhJUzN0OxzUwXFCCD3ej56dVjp3g,3525
 reflex/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 reflex/reflex.py,sha256=urU9hMWIkmVl6BPuw_-NmfaE8Zlls4s_t31ueFl4uBo,25915
 reflex/route.py,sha256=TnS4m6Hm-b3LfGFpm37iAMEd-_JISAouPW5FqUxTAfU,7858
-reflex/state.py,sha256=IQW8zSlxGCnSlQSFx-MQSsW80sXp-litEaRv8LouZQo,95389
+reflex/state.py,sha256=oBDulNnUSU10EjoWo6sPQwykT9cxNcXm_uw2qCJyQg0,96993
 reflex/style.py,sha256=q5Zyc16ULY9xw9CKPPawknrBXIcNNdaSLALXAgdcm2g,13298
 reflex/testing.py,sha256=EzFAVOD9iRfTlQ805NJG6vUynRt1TEkPxId5aCK8eAQ,41974
 reflex/.templates/apps/blank/assets/favicon.ico,sha256=baxxgDAQ2V4-G5Q4S2yK5uUJTUGkv-AOWBQ0xd6myUo,4286
@@ -30,7 +30,7 @@ reflex/.templates/web/components/reflex/radix_themes_color_mode_provider.js,sha2
 reflex/.templates/web/components/shiki/code.js,sha256=4Es1pxsr-lX4hTQ5mglrwwC6O_SI-z-O60k03z8VFzQ,1144
 reflex/.templates/web/styles/__reflex_style_reset.css,sha256=qbC6JIT643YEsvSQ0D7xBmWE5vXy94JGrKNihRuEjnA,8913
 reflex/.templates/web/utils/react-theme.js,sha256=Aa-RND3ooGCXW6Zavzitc-v0ciKlcQDTFlDtE4mPkFI,2713
-reflex/.templates/web/utils/state.js,sha256=7gRWc8ABMOKY3KMF6SpaVEhNILW03wivd7eENVC7ADg,34858
+reflex/.templates/web/utils/state.js,sha256=4vbzLxusJhiFLvmODxX5gB7drCtNtgSXzc5j3MLW_Cs,34899
 reflex/.templates/web/utils/helpers/dataeditor.js,sha256=pG6MgsHuStDR7-qPipzfiK32j9bKDBa-4hZ0JSUo4JM,1623
 reflex/.templates/web/utils/helpers/debounce.js,sha256=xGhtTRtS_xIcaeqnYVvYJNseLgQVk-DW-eFiHJYO9As,528
 reflex/.templates/web/utils/helpers/paste.js,sha256=ef30HsR83jRzzvZnl8yV79yqFP8TC_u8SlN99cCS_OM,1799
@@ -43,7 +43,7 @@ reflex/app_mixins/middleware.py,sha256=BKhe0jUFO1_TylEC48LUZyaeYyPmAYW-NV4H5Rw22
 reflex/app_mixins/mixin.py,sha256=R1YncalqDrbdPZvpKVbm72ZKmQZxYAWfuFq9JknzTqQ,305
 reflex/compiler/__init__.py,sha256=r8jqmDSFf09iV2lHlNhfc9XrTLjNxfDNwPYlxS4cmHE,27
 reflex/compiler/compiler.py,sha256=aaAgnbplyzkTWSfRKkvtT70l72qkbDdwQut-5OPWbL0,29114
-reflex/compiler/templates.py,sha256=iw6yYC23iFlUfM_7LAMTQyLjSWIAddEKInHbPqjMEwo,20611
+reflex/compiler/templates.py,sha256=vIpdW0j0Ti1h3VnWmrS6S4OtDRglYHynTT7959sHI5w,20987
 reflex/compiler/utils.py,sha256=TvVSVhlYPpNEH3-PUnih-RMpHa4HmgGCSCnUxASdzFE,19633
 reflex/components/__init__.py,sha256=eWpgWFbSQDj2TpGp6StEbxU7roQgzY7ZM0XIcIc5RE8,588
 reflex/components/__init__.pyi,sha256=7VFHtJGIjvGtD3IiPk848IPWYSCcPRT1EyPGljLhYlU,736
@@ -61,7 +61,7 @@ reflex/components/base/body.py,sha256=KLPOhxVsKyjPwrY9AziCOOG_c9ckOqIhI4n2i3_Q3N
 reflex/components/base/body.pyi,sha256=u_Y3lBkSwGZlnsHWKr_Rtm49UI2bP8Rx2e99gkshENw,2357
 reflex/components/base/document.py,sha256=Fr7y22NbeKeiz8kWPH2q5BpFjKdq-AmY-sxZilee_H8,636
 reflex/components/base/document.pyi,sha256=PlvclB2vyGcQ8zLJpFac_37LHeXLwpe8Qh0UqzXAPfE,11788
-reflex/components/base/error_boundary.py,sha256=sp6W7G6uFWdls6nzl17XSizSSm6zS2OAu3ZqTE2W1CE,6438
+reflex/components/base/error_boundary.py,sha256=eXLO4SxNx2QoIC5tXk7f0kMulXNDJJaEkZNJ985FAcw,7456
 reflex/components/base/error_boundary.pyi,sha256=SvKnZ09jwIL_4-J5BKVZuATclrB4o3Eh457iTmmoNb4,2926
 reflex/components/base/fragment.py,sha256=ys7wkokq-N8WBxa9fqkEaNIrBlSximyD7vqlFVe02hQ,342
 reflex/components/base/fragment.pyi,sha256=1vl8p6SCWd0_QzYVAb-Em70IX6FwIWFvJLxMl5OJTwU,2401
@@ -97,7 +97,7 @@ reflex/components/core/sticky.py,sha256=UD5x4cHqRkwUY87L5tmKwQYqW-j5fELqiPaozoSQ
 reflex/components/core/sticky.pyi,sha256=_iqFMzHRaHcL23TYy0sL4x7Sdc5rEcp5W2ESTOFlPdc,10282
 reflex/components/core/upload.py,sha256=NbcpZ_zNltvBQFBQ-sJNriQg3Bw9Q8VwUL7cKY2kKIU,15165
 reflex/components/core/upload.pyi,sha256=TQVUHt47YsfleD_O-gbLJMzie5slnjft-KVs_7jjRtQ,16820
-reflex/components/core/window_events.py,sha256=opbuO20zVxt252kQLk49V7cltb_Um2oh7iePeGNJ538,3355
+reflex/components/core/window_events.py,sha256=21IX9CqdkpLuExnxhYOmwj9FJORLJXLz09uF8Hn7wKc,3954
 reflex/components/core/window_events.pyi,sha256=RWE1wTGGERr8dSmdyfHtyEUJXXEHN_rR5ZM7WzeTD4g,3226
 reflex/components/core/layout/__init__.py,sha256=znldZaj_NGt8qCZDG70GMwjMTskcvCf_2N_EjCAHwdc,30
 reflex/components/datadisplay/__init__.py,sha256=L8pWWKNHWdUD2fbZRoEKjd_8c_hpDdGYO463hwkoIi4,438
@@ -139,8 +139,8 @@ reflex/components/gridjs/__init__.py,sha256=xJwDm1AZ70L5-t9LLqZwGUtDpijbf1KuMYDT
 reflex/components/gridjs/datatable.py,sha256=7JKrRw1zkpFB0_wwoaIhrVrldsm7-dyi3PASgqLq8Hc,4224
 reflex/components/gridjs/datatable.pyi,sha256=kFgv82vCgfdWZaUq4bZ73G8X3mkw6ecvSRkZ9G9-28E,5185
 reflex/components/lucide/__init__.py,sha256=EggTK2MuQKQeOBLKW-mF0VaDK9zdWBImu1HO2dvHZbE,73
-reflex/components/lucide/icon.py,sha256=kApdAoKlDFsy5785776DBVIwY0s7ceOX_5aSA7YoRWc,35375
-reflex/components/lucide/icon.pyi,sha256=oFXjvb5SBULQlbeGDY4K5WWkqemktGIaCsiyrentjKY,37987
+reflex/components/lucide/icon.py,sha256=WLEzDeVlS68XWj1y4F0DV6pa8S19g-vwuZxMe6BT2Yo,35396
+reflex/components/lucide/icon.pyi,sha256=O4HM8EACvZt3s8s8KgC0QLYITvy-gHLn3D01jRcHk8Q,38008
 reflex/components/markdown/__init__.py,sha256=Dfl1At5uYoY7H4ufZU_RY2KOGQDLtj75dsZ2BTqqAns,87
 reflex/components/markdown/markdown.py,sha256=Sg3AioKZsNn27KdOzR3o53k1bHzPa2pjpHFVYbxBgCg,16464
 reflex/components/markdown/markdown.pyi,sha256=5SbgUBrklIdxEJOHtOqKVM2aobgulnkWp5DEGUFNmEI,4323
@@ -148,7 +148,7 @@ reflex/components/moment/__init__.py,sha256=jGnZgRBivYJQPIcFgtLaXFteCeIG3gGH5ACX
 reflex/components/moment/moment.py,sha256=fhhzrun9USb8J30btpyyDD3JuXF_N7EL5Dou3x7NQYw,4080
 reflex/components/moment/moment.pyi,sha256=3CQSmhMF4MetFCrjuds9wpz7FnFeXdXzR39A8n3nhy0,2872
 reflex/components/plotly/__init__.py,sha256=6B_woBJhkrVA9O_AbOTbsA_SxWsqjicYHmLA9FLjGfU,650
-reflex/components/plotly/plotly.py,sha256=4PugE2Gy2x02CSz_0GbnUbuIJAfjydQoMWxv1K43kQA,15172
+reflex/components/plotly/plotly.py,sha256=xy9MNprtmO67RIrFkc2D9QfbjzP8eX4Tkk4UfPz5JBM,15172
 reflex/components/plotly/plotly.pyi,sha256=5Nhph2PL9eIb-Xd6CUZHQf79P-tOazy1alwRQl7CKWw,46821
 reflex/components/radix/__init__.py,sha256=fRsLvIO3MrTtPOXtmnxYDB9phvzlcbyB_utgpafYMho,474
 reflex/components/radix/__init__.pyi,sha256=ke_dGrpFMNHd3MgQ9qiStSQDlGcJ39KVSrpIxayBU3c,3927
@@ -301,7 +301,7 @@ reflex/components/recharts/general.py,sha256=c3SRcKzNvSeKcbVInl-zNrDxNe0Lgejqcbl
 reflex/components/recharts/general.pyi,sha256=e77vGL8lo-t1jI79h0O12qSK5e9wbjerPslCxQQgSBw,23462
 reflex/components/recharts/polar.py,sha256=zocHpwWQ0lbg4BTnEBwQ6J9SSJsOYRwZGf9UPzxoNKs,15682
 reflex/components/recharts/polar.pyi,sha256=8ShEcGK9KJyu0FN6KPys1kgAYrzOZ6wtiRuytHJ--38,26937
-reflex/components/recharts/recharts.py,sha256=rAarxOawhHiWUDIHNrizmChitgoNV4zas1y5SuSsr7E,3221
+reflex/components/recharts/recharts.py,sha256=8GJIjIcJMHQCFV5gkHOhqa1L9DzSFO_bBIgzIichyx0,3221
 reflex/components/recharts/recharts.pyi,sha256=9j8cVSMqyBkkOBBrx9pzDpP1clnbM9kD0TTViTUGDYc,7084
 reflex/components/sonner/__init__.py,sha256=L_mdRIy7-ccRGSz5VK6J8O-c-e-D1p9xWw29_ErrvGg,68
 reflex/components/sonner/toast.py,sha256=VBtoRnxBhKD029njAjhbLeYtiUSL3aNPOSmA9Lmsqvg,12512
@@ -319,7 +319,7 @@ reflex/constants/compiler.py,sha256=1FXPYQNotaSrTwWcOspA1gCVmEdoiWkNMbbrz_qU0YU,
 reflex/constants/config.py,sha256=8OIjiBdZZJrRVHsNBheMwopE9AwBFFzau0SXqXKcrPg,1715
 reflex/constants/custom_components.py,sha256=joJt4CEt1yKy7wsBH6vYo7_QRW0O_fWXrrTf0VY2q14,1317
 reflex/constants/event.py,sha256=tgoynWQi2L0_Kqc3XhXo7XXL76A-OKhJGHRrNjm7gFw,2885
-reflex/constants/installer.py,sha256=nzyvtCXgcGt7Anbbx4gC3s7QYdupFVZZUOfztxgjk14,4191
+reflex/constants/installer.py,sha256=iZvdnTIl2zh0_fPr1G-RsOiHbA4vnnse8ykPJVFBUbE,4191
 reflex/constants/route.py,sha256=UBjqaAOxiUxlDZCSY4O2JJChKvA4MZrhUU0E5rNvKbM,2682
 reflex/constants/state.py,sha256=VrEeYxXfE9ss8RmOHIXD4T6EGsV9PDqbtMCQMmZxW3I,383
 reflex/constants/utils.py,sha256=e1ChEvbHfmE_V2UJvCSUhD_qTVAIhEGPpRJSqdSd6PA,780
@@ -331,13 +331,13 @@ reflex/experimental/hooks.py,sha256=CHYGrAE5t8riltrJmDFgJ4D2Vhmhw-y3B3MSGNlOQow,
 reflex/istate/__init__.py,sha256=afq_pCS5B_REC-Kl3Rbaa538uWi59xNz4INeuENcWnk,2039
 reflex/istate/data.py,sha256=ZT7uW_Ish3A0V4x2Lu8PD__GkiOd3nHY0lAeGcghp68,7872
 reflex/istate/dynamic.py,sha256=xOQ9upZVPf6ngqcLQZ9HdAAYmoWwJ8kRFPH34Q5HTiM,91
-reflex/istate/proxy.py,sha256=BwlJYWR5FMItqbHVulhgI_TH8jtP69HkXXpTtClXXcs,25993
+reflex/istate/proxy.py,sha256=nqL-MPWp2Ldo8GsjCdzfeWK1wQ9LK-fUoB8XyIZfJwQ,26458
 reflex/istate/storage.py,sha256=gCPoiZxuG-Rw0y-Pz3OC7rv4o08dQ_jK1fE2u8Jhxqg,4339
 reflex/istate/wrappers.py,sha256=p8uuioXRbR5hperwbOJHUcWdu7hukLikQdoR7qrnKsI,909
-reflex/istate/manager/__init__.py,sha256=jG5A1lmVtU7BC3dRMfXhd7jI3keUVX8QMEXTteTzhO8,3876
-reflex/istate/manager/disk.py,sha256=2gtMg2aQK1ZuIbgz7EHshOBUGNTHxI__4D3HDTdvePo,13450
-reflex/istate/manager/memory.py,sha256=5rAJlgQAhBB0B3hQT3TYyu-N37TzRvhLcCItcyWkrcw,2477
-reflex/istate/manager/redis.py,sha256=TBOdZfeXigL6nbKVDOgkxX595ZQJtRYOEToSlE6MZyM,18297
+reflex/istate/manager/__init__.py,sha256=hTg5uqxVbz-xayUZNin-wP51PfAkz1CHDez-jncXTTg,4406
+reflex/istate/manager/disk.py,sha256=RVWDnPt4d2a0El8RBnWDVCksLKv7rPuWbkUPR6Y7Szc,13736
+reflex/istate/manager/memory.py,sha256=tnK2JzJNcEbiXAdGIT5tNA0U1-mQZoeXKF8XNJCfnts,2760
+reflex/istate/manager/redis.py,sha256=LGR8ilvrCZmxKznhIKBHP4-Oe_JT5htcoJldVH53MlU,19020
 reflex/middleware/__init__.py,sha256=x7xTeDuc73Hjj43k1J63naC9x8vzFxl4sq7cCFBX7sk,111
 reflex/middleware/hydrate_middleware.py,sha256=1ch7bx2ZhojOR15b-LHD2JztrWCnpPJjTe8MWHJe-5Y,1510
 reflex/middleware/middleware.py,sha256=p5VVoIgQ_NwOg_GOY6g0S4fmrV76_VE1zt-HiwbMw-s,1158
@@ -347,7 +347,7 @@ reflex/plugins/base.py,sha256=5BgzCM7boj9kJ6FGzVzVlgQk-crJuVmOLCl1PXvv4-E,3372
 reflex/plugins/shared_tailwind.py,sha256=XPnswswPW3UIeEu5ghecdEeYtpikG5ksD92sM-VwKYM,7221
 reflex/plugins/sitemap.py,sha256=X_CtH5B1w3CZno-gdPj1rp63WjOuNjFnX4B3fx_-VFQ,6135
 reflex/plugins/tailwind_v3.py,sha256=jCEZ5UYdr706Mw48L-WSHOUB6O55o1C3uG6AMwXqZoI,4810
-reflex/plugins/tailwind_v4.py,sha256=8G7iXj6wYRRJlCWlce_vtCgs1YittFvLucyUP-sPXhc,5230
+reflex/plugins/tailwind_v4.py,sha256=Cjp3vJnrZDYiflwm4imj4SEI0pYBv36mLvmpbI6olao,5230
 reflex/utils/__init__.py,sha256=y-AHKiRQAhk2oAkvn7W8cRVTZVK625ff8tTwvZtO7S4,24
 reflex/utils/build.py,sha256=j-OY90O7gMP_bclVt_6J3Q2GFgOHQH_uFpTfdaWmuqU,9746
 reflex/utils/codespaces.py,sha256=SIATnmlGCABPvjvRIENUCwP-fcjqKhdoOYiFY_Eua6M,4339
@@ -358,7 +358,7 @@ reflex/utils/exceptions.py,sha256=Wwu7Ji2xgq521bJKtU2NgjwhmFfnG8erirEVN2h8S-g,88
 reflex/utils/exec.py,sha256=xMwRnCd9SyTbvwBPS5i3C6ZcorLSFViqB_fOoCqsDEc,22833
 reflex/utils/export.py,sha256=dR8Q7OymxcS8PCvx5zV2kOZmjKgOmuAfKfL8XifHJd4,2907
 reflex/utils/format.py,sha256=BAq-BO0ON5ionaDaO0yJIZ3Y1YT7hhpYlGHZ5-x9w4o,20981
-reflex/utils/frontend_skeleton.py,sha256=FqvNWclY_lRR-odjQmP-xaY3uiWVD2l5qqExt8qRzEI,8769
+reflex/utils/frontend_skeleton.py,sha256=Tr3GUsvJoA6PceVt1jHhowtObgrnRvaeJc4ABTrfv18,8887
 reflex/utils/imports.py,sha256=SlQfMTbJasXHxrpcHdWKPWiIZ1Kn2-tulMF32_YA2ek,4262
 reflex/utils/js_runtimes.py,sha256=Xia4pIyWGwUmNnTgELm04oxVQobwdQvmK87AHTr3B1o,13542
 reflex/utils/lazy_loader.py,sha256=BiY9OvmAJDCz10qpuyTYv9duXgMFQa6RXKQmTO9hqKU,4453
@@ -387,8 +387,8 @@ reflex/vars/number.py,sha256=Cejba-47shtQt-j0uD_HRfTGOm1IF1uZ1WwpWSrcLSE,28865
 reflex/vars/object.py,sha256=j3b-j66Qa0XDJofMkcJtb8e-TdNx2_hjyEPnrGJEaFY,17833
 reflex/vars/sequence.py,sha256=OyCfMsv50Zr6W26DMISWjLX6FzK3rbxNcgKepgYr7Pk,52326
 scripts/hatch_build.py,sha256=-4pxcLSFmirmujGpQX9UUxjhIC03tQ_fIQwVbHu9kc0,1861
-reflex-0.8.16.dist-info/METADATA,sha256=w8BQum0qhf-ClDDsjNvLxelDGVbH3OdDbBUk5BtjOxY,12560
-reflex-0.8.16.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-reflex-0.8.16.dist-info/entry_points.txt,sha256=Rxt4dXc7MLBNt5CSHTehVPuSe9Xqow4HLX55nD9tQQ0,45
-reflex-0.8.16.dist-info/licenses/LICENSE,sha256=dw3zLrp9f5ObD7kqS32vWfhcImfO52PMmRqvtxq_YEE,11358
-reflex-0.8.16.dist-info/RECORD,,
+reflex-0.8.17.dist-info/METADATA,sha256=8G9xli6KokdQj47HhQ8cKHo0nfVhTnHasc2K6A4A5fk,13100
+reflex-0.8.17.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+reflex-0.8.17.dist-info/entry_points.txt,sha256=Rxt4dXc7MLBNt5CSHTehVPuSe9Xqow4HLX55nD9tQQ0,45
+reflex-0.8.17.dist-info/licenses/LICENSE,sha256=dw3zLrp9f5ObD7kqS32vWfhcImfO52PMmRqvtxq_YEE,11358
+reflex-0.8.17.dist-info/RECORD,,