reflex 0.8.12a2__py3-none-any.whl → 0.8.13a1__py3-none-any.whl

reflex/app.py

@@ -113,7 +113,12 @@ from reflex.utils import (
     prerequisites,
     types,
 )
-from reflex.utils.exec import get_compile_context, is_prod_mode, is_testing_env
+from reflex.utils.exec import (
+    get_compile_context,
+    is_prod_mode,
+    is_testing_env,
+    should_prerender_routes,
+)
 from reflex.utils.imports import ImportVar
 from reflex.utils.token_manager import TokenManager
 from reflex.utils.types import ASGIApp, Message, Receive, Scope, Send
@@ -607,7 +612,7 @@ class App(MiddlewareMixin, LifespanMixin):
         """
         from reflex.vars.base import GLOBAL_CACHE
 
-        self._compile(prerender_routes=is_prod_mode())
+        self._compile(prerender_routes=should_prerender_routes())
 
         config = get_config()
 

reflex/components/core/upload.pyi

@@ -108,6 +108,7 @@ class GhostUpload(Fragment):
         on_context_menu: EventType[()] | EventType[PointerEventInfo] | None = None,
         on_double_click: EventType[()] | EventType[PointerEventInfo] | None = None,
         on_drop: EventType[()] | EventType[Any] | None = None,
+        on_drop_rejected: EventType[()] | EventType[Any] | None = None,
         on_focus: EventType[()] | None = None,
         on_mount: EventType[()] | None = None,
         on_mouse_down: EventType[()] | None = None,
@@ -127,6 +128,7 @@ class GhostUpload(Fragment):
         Args:
             *children: The children of the component.
             on_drop: Fired when files are dropped.
+            on_drop_rejected: Fired when dropped files do not meet the specified criteria.
             style: The style of the component.
             key: A unique key for the component.
             id: The id for the component.
@@ -171,6 +173,7 @@ class Upload(MemoizationLeaf):
         on_context_menu: EventType[()] | EventType[PointerEventInfo] | None = None,
         on_double_click: EventType[()] | EventType[PointerEventInfo] | None = None,
         on_drop: EventType[()] | EventType[Any] | None = None,
+        on_drop_rejected: EventType[()] | EventType[Any] | None = None,
         on_focus: EventType[()] | None = None,
         on_mount: EventType[()] | None = None,
         on_mouse_down: EventType[()] | None = None,
@@ -199,6 +202,7 @@ class Upload(MemoizationLeaf):
             no_drag: Whether to disable drag and drop.
             no_keyboard: Whether to disable using the space/enter keys to upload.
             on_drop: Fired when files are dropped.
+            on_drop_rejected: Fired when dropped files do not meet the specified criteria.
             drag_active_style: Style rules to apply when actively dragging.
             style: The style of the component.
             key: A unique key for the component.
@@ -242,6 +246,7 @@ class StyledUpload(Upload):
         on_context_menu: EventType[()] | EventType[PointerEventInfo] | None = None,
         on_double_click: EventType[()] | EventType[PointerEventInfo] | None = None,
         on_drop: EventType[()] | EventType[Any] | None = None,
+        on_drop_rejected: EventType[()] | EventType[Any] | None = None,
         on_focus: EventType[()] | None = None,
         on_mount: EventType[()] | None = None,
         on_mouse_down: EventType[()] | None = None,
@@ -270,6 +275,7 @@ class StyledUpload(Upload):
             no_drag: Whether to disable drag and drop.
             no_keyboard: Whether to disable using the space/enter keys to upload.
             on_drop: Fired when files are dropped.
+            on_drop_rejected: Fired when dropped files do not meet the specified criteria.
             drag_active_style: Style rules to apply when actively dragging.
             style: The style of the component.
             key: A unique key for the component.
@@ -314,6 +320,7 @@ class UploadNamespace(ComponentNamespace):
         on_context_menu: EventType[()] | EventType[PointerEventInfo] | None = None,
         on_double_click: EventType[()] | EventType[PointerEventInfo] | None = None,
         on_drop: EventType[()] | EventType[Any] | None = None,
+        on_drop_rejected: EventType[()] | EventType[Any] | None = None,
         on_focus: EventType[()] | None = None,
         on_mount: EventType[()] | None = None,
         on_mouse_down: EventType[()] | None = None,
@@ -342,6 +349,7 @@ class UploadNamespace(ComponentNamespace):
             no_drag: Whether to disable drag and drop.
             no_keyboard: Whether to disable using the space/enter keys to upload.
             on_drop: Fired when files are dropped.
+            on_drop_rejected: Fired when dropped files do not meet the specified criteria.
             drag_active_style: Style rules to apply when actively dragging.
             style: The style of the component.
             key: A unique key for the component.

reflex/components/react_player/react_player.py

@@ -4,9 +4,14 @@ from __future__ import annotations
 
 from typing import Any, TypedDict
 
-from reflex.components.component import NoSSRComponent
-from reflex.event import EventHandler, no_args_event_spec, passthrough_event_spec
+from reflex.components.component import Component
+from reflex.components.core.cond import cond
+from reflex.event import EventHandler, no_args_event_spec
+from reflex.utils import console
 from reflex.vars.base import Var
+from reflex.vars.object import ObjectVar
+
+ReactPlayerEvent = ObjectVar[dict[str, dict[str, dict[str, Any]]]]
 
 
 class Progress(TypedDict):
@@ -16,21 +21,123 @@ class Progress(TypedDict):
     playedSeconds: float
     loaded: float
     loadedSeconds: float
+    duration: float
+
+
+def _on_progress_signature(event: ReactPlayerEvent) -> list[Var[Progress]]:
+    """Type signature for on_progress event.
+
+    Args:
+        event: The event variable.
+
+    Returns:
+        The progress information extracted from the event.
+    """
+    player_info = event["target"]["api"]["playerInfo"].to(dict)
+    progress_state = player_info["progressState"].to(dict)
+    current = progress_state["current"].to(float)
+    loaded = progress_state["loaded"].to(float)
+    duration = progress_state["duration"].to(float)
+    return [
+        cond(
+            progress_state,
+            {
+                "played": cond(duration, current / duration, 0.0),
+                "playedSeconds": current,
+                "loaded": cond(duration, loaded / duration, 0.0),
+                "loadedSeconds": loaded,
+                "duration": duration,
+            },
+            {
+                "played": 0.0,
+                "playedSeconds": 0.0,
+                "loaded": 0.0,
+                "loadedSeconds": 0.0,
+                "duration": 0.0,
+            },
+        ).to(Progress)
+    ]
+
+
+def _player_info_key_or_zero(event: ReactPlayerEvent, key: str) -> Var[float]:
+    """Helper to extract a value from playerInfo or return 0.0 if not available.
+
+    Args:
+        event: The event variable.
+        key: The key to extract from playerInfo.
+
+    Returns:
+        The extracted value or 0.0 if not available.
+    """
+    player_info = event["target"]["api"]["playerInfo"].to(dict)
+    return cond(
+        player_info[key],
+        player_info[key],
+        0.0,
+    ).to(float)
+
+
+def _on_time_update_signature(event: ReactPlayerEvent) -> list[Var[float]]:
+    """Type signature for on_time_update event.
+
+    Args:
+        event: The event variable.
+
+    Returns:
+        The current timestamp in seconds.
+    """
+    return [_player_info_key_or_zero(event, "currentTime")]
+
+
+def _on_duration_change_signature(event: ReactPlayerEvent) -> list[Var[float]]:
+    """Type signature for on_duration_change event.
+
+    Args:
+        event: The event variable.
+
+    Returns:
+        The active media's duration in seconds.
+    """
+    return [_player_info_key_or_zero(event, "duration")]
+
+
+def _on_rate_change_signature(event: ReactPlayerEvent) -> list[Var[float]]:
+    """Type signature for on_rate_change event.
 
+    Args:
+        event: The event variable.
 
-class ReactPlayer(NoSSRComponent):
+    Returns:
+        The current playback rate.
+    """
+    return [_player_info_key_or_zero(event, "playbackRate")]
+
+
+_DEPRECATED_PROP_MAP = {
+    "url": "src",
+    "on_duration": "on_duration_change",
+    "on_playback_rate_change": "on_rate_change",
+    "on_seek": "on_seeked",
+    "on_buffer": "on_waiting",
+    "on_buffer_end": "on_playing",
+    "on_enable_pip": "on_enter_picture_in_picture",
+    "on_disable_pip": "on_leave_picture_in_picture",
+}
+
+
+class ReactPlayer(Component):
     """Using react-player and not implement all props and callback yet.
     reference: https://github.com/cookpete/react-player.
     """
 
-    library = "react-player@2.16.0"
+    library = "react-player@3.3.3"
 
     tag = "ReactPlayer"
 
     is_default = True
 
     # The url of a video or song to play
-    url: Var[str]
+    src: Var[str | list[str] | list[dict[str, str]]]
 
     # Set to true or false to pause or play the media
     playing: Var[bool]
@@ -50,38 +157,44 @@ class ReactPlayer(NoSSRComponent):
     # Mutes the player
     muted: Var[bool]
 
+    # Player-specific configuration parameters.
+    config: Var[dict[str, Any]]
+
     # Called when media is loaded and ready to play. If playing is set to true, media will play immediately.
     on_ready: EventHandler[no_args_event_spec]
 
     # Called when media starts playing.
     on_start: EventHandler[no_args_event_spec]
 
-    # Called when media starts or resumes playing after pausing or buffering.
+    # Called when playing is set to true.
     on_play: EventHandler[no_args_event_spec]
 
-    # Callback containing played and loaded progress as a fraction, and playedSeconds and loadedSeconds in seconds. eg { played: 0.12, playedSeconds: 11.3, loaded: 0.34, loadedSeconds: 16.7 }
-    on_progress: EventHandler[passthrough_event_spec(Progress)]
+    # Called when media starts or resumes playing after pausing or buffering.
+    on_playing: EventHandler[no_args_event_spec]
+
+    # Called while the video is loading only. Contains played and loaded progress as a fraction, and playedSeconds and loadedSeconds in seconds. eg { played: 0.12, playedSeconds: 11.3, loaded: 0.34, loadedSeconds: 16.7 }
+    on_progress: EventHandler[_on_progress_signature]
+
+    # Called when the media's current time changes (~4Hz, use .throttle to limit calls to backend).
+    on_time_update: EventHandler[_on_time_update_signature]
 
     # Callback containing duration of the media, in seconds.
-    on_duration: EventHandler[passthrough_event_spec(float)]
+    on_duration_change: EventHandler[_on_duration_change_signature]
 
     # Called when media is paused.
     on_pause: EventHandler[no_args_event_spec]
 
     # Called when media starts buffering.
-    on_buffer: EventHandler[no_args_event_spec]
+    on_waiting: EventHandler[no_args_event_spec]
 
-    # Called when media has finished buffering. Works for files, YouTube and Facebook.
-    on_buffer_end: EventHandler[no_args_event_spec]
+    # Called when the media is seeking.
+    on_seeking: EventHandler[no_args_event_spec]
 
     # Called when media seeks with seconds parameter.
-    on_seek: EventHandler[passthrough_event_spec(float)]
+    on_seeked: EventHandler[_on_time_update_signature]
 
     # Called when playback rate of the player changed. Only supported by YouTube, Vimeo (if enabled), Wistia, and file paths.
-    on_playback_rate_change: EventHandler[no_args_event_spec]
-
-    # Called when playback quality of the player changed. Only supported by YouTube (if enabled).
-    on_playback_quality_change: EventHandler[no_args_event_spec]
+    on_rate_change: EventHandler[_on_rate_change_signature]
 
     # Called when media finishes playing. Does not fire when loop is set to true.
     on_ended: EventHandler[no_args_event_spec]
@@ -93,10 +206,37 @@ class ReactPlayer(NoSSRComponent):
     on_click_preview: EventHandler[no_args_event_spec]
 
     # Called when picture-in-picture mode is enabled.
-    on_enable_pip: EventHandler[no_args_event_spec]
+    on_enter_picture_in_picture: EventHandler[no_args_event_spec]
 
     # Called when picture-in-picture mode is disabled.
-    on_disable_pip: EventHandler[no_args_event_spec]
+    on_leave_picture_in_picture: EventHandler[no_args_event_spec]
+
+    @classmethod
+    def create(cls, *children, **props) -> ReactPlayer:
+        """Create a component.
+
+        Args:
+            children: The children of the component.
+            props: The props of the component.
+
+        Returns:
+            The created component.
+
+        Raises:
+            ValueError: If both a deprecated prop and its replacement are both passed.
+        """
+        for prop, new_prop in _DEPRECATED_PROP_MAP.items():
+            if prop in props:
+                if new_prop in props:
+                    msg = (
+                        f"The prop {prop!r} is deprecated, but the replacement {new_prop!r} is also passed. Please remove {prop!r}.",
+                    )
+                    raise ValueError(msg)
+                console.warn(
+                    f"The prop {prop!r} has been replaced by {new_prop!r}, please update your code.",
+                )
+                props[new_prop] = props.pop(prop)
+        return super().create(*children, **props)  # type: ignore[return-value]
 
     def _render(self, props: dict[str, Any] | None = None):
         """Render the component. Adds width and height set to None because

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.0"
+    library = "recharts@3.2.1"
 
     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.0"
+    library = "recharts@3.2.1"
 
 
 LiteralAnimationEasing = Literal["ease", "ease-in", "ease-out", "ease-in-out", "linear"]

reflex/constants/colors.py

@@ -96,4 +96,6 @@ class Color:
         Returns:
             The formatted color.
         """
-        return format_color(self.color, self.shade, self.alpha)
+        from reflex.vars import LiteralColorVar
+
+        return LiteralColorVar.create(self).__format__(format_spec)

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.9",
+        "vite": "npm:rolldown-vite@7.1.12",
     }
     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.9",
+        "vite": "npm:rolldown-vite@7.1.12",
     }

reflex/environment.py

@@ -657,6 +657,9 @@ class EnvironmentVariables:
     # Whether to force a full reload on changes.
     VITE_FORCE_FULL_RELOAD: EnvVar[bool] = env_var(False)
 
+    # Whether to enable SSR for the frontend.
+    REFLEX_SSR: EnvVar[bool] = env_var(True)
+
 
 environment = EnvironmentVariables()
 

reflex/plugins/shared_tailwind.py

@@ -179,7 +179,7 @@ class TailwindPlugin(PluginBase):
     config: TailwindConfig = dataclasses.field(
         default_factory=lambda: TailwindConfig(
             plugins=[
-                "@tailwindcss/typography@0.5.16",
+                "@tailwindcss/typography@0.5.18",
             ],
         )
     )

reflex/reflex.py

@@ -204,7 +204,7 @@ def _run(
     args = (frontend,)
     kwargs = {
         "check_if_schema_up_to_date": True,
-        "prerender_routes": env == constants.Env.PROD,
+        "prerender_routes": exec.should_prerender_routes(),
     }
 
     # Granian fails if the app is already imported.
@@ -216,9 +216,12 @@ def _run(
             *args,
             **kwargs,
         )
-        compile_future.result()
+        return_result = compile_future.result()
     else:
-        app_task(*args, **kwargs)
+        return_result = app_task(*args, **kwargs)
+
+    if not return_result:
+        raise SystemExit(1)
 
     # Get the frontend and backend commands, based on the environment.
     setup_frontend = frontend_cmd = backend_cmd = None
@@ -429,6 +432,14 @@ def compile(dry: bool, rich: bool):
     type=click.Path(exists=True, path_type=Path, resolve_path=True),
     help="Files or directories to exclude from the backend zip. Can be used multiple times.",
 )
+@click.option(
+    "--server-side-rendering/--no-server-side-rendering",
+    "--ssr/--no-ssr",
+    "ssr",
+    default=True,
+    is_flag=True,
+    help="Whether to enable server side rendering for the frontend.",
+)
 def export(
     zip: bool,
     frontend_only: bool,
@@ -437,11 +448,17 @@ def export(
     upload_db_file: bool,
     env: LITERAL_ENV,
     backend_excluded_dirs: tuple[Path, ...] = (),
+    ssr: bool = True,
 ):
     """Export the app to a zip file."""
     from reflex.utils import export as export_utils
     from reflex.utils import prerequisites
 
+    if not environment.REFLEX_SSR.is_set():
+        environment.REFLEX_SSR.set(ssr)
+    elif environment.REFLEX_SSR.get() != ssr:
+        ssr = environment.REFLEX_SSR.get()
+
     environment.REFLEX_COMPILE_CONTEXT.set(constants.CompileContext.EXPORT)
 
     should_frontend_run, should_backend_run = prerequisites.check_running_mode(
@@ -464,6 +481,7 @@ def export(
         env=constants.Env.DEV if env == constants.Env.DEV else constants.Env.PROD,
         loglevel=config.loglevel.subprocess_level(),
         backend_excluded_dirs=backend_excluded_dirs,
+        prerender_routes=ssr,
     )
 
 
@@ -676,6 +694,14 @@ def makemigrations(message: str | None):
     type=click.Path(exists=True, path_type=Path, resolve_path=True),
     help="Files or directories to exclude from the backend zip. Can be used multiple times.",
 )
+@click.option(
+    "--server-side-rendering/--no-server-side-rendering",
+    "--ssr/--no-ssr",
+    "ssr",
+    default=True,
+    is_flag=True,
+    help="Whether to enable server side rendering for the frontend.",
+)
 def deploy(
     app_name: str | None,
     app_id: str | None,
@@ -690,6 +716,7 @@ def deploy(
     token: str | None,
     config_path: str | None,
     backend_excluded_dirs: tuple[Path, ...] = (),
+    ssr: bool = True,
 ):
     """Deploy the app to the Reflex hosting service."""
     from reflex_cli.utils import dependency
@@ -707,6 +734,11 @@ def deploy(
 
     environment.REFLEX_COMPILE_CONTEXT.set(constants.CompileContext.DEPLOY)
 
+    if not environment.REFLEX_SSR.is_set():
+        environment.REFLEX_SSR.set(ssr)
+    elif environment.REFLEX_SSR.get() != ssr:
+        ssr = environment.REFLEX_SSR.get()
+
     # Only check requirements if interactive.
     # There is user interaction for requirements update.
     if interactive:
@@ -739,6 +771,7 @@ def deploy(
                 loglevel=config.loglevel.subprocess_level(),
                 upload_db_file=upload_db,
                 backend_excluded_dirs=backend_excluded_dirs,
+                prerender_routes=ssr,
             )
         ),
         regions=list(region),

reflex/state.py

@@ -7,6 +7,7 @@ import builtins
 import contextlib
 import copy
 import dataclasses
+import datetime
 import functools
 import inspect
 import pickle
@@ -306,6 +307,14 @@ async def _resolve_delta(delta: Delta) -> Delta:
     return delta
 
 
+_deserializers = {
+    int: int,
+    float: float,
+    datetime.datetime: datetime.datetime.fromisoformat,
+    datetime.date: datetime.date.fromisoformat,
+    datetime.time: datetime.time.fromisoformat,
+}
+
 all_base_state_classes: dict[str, None] = {}
 
 
@@ -1872,11 +1881,12 @@ class BaseState(EvenMoreBasicBaseState):
                 hinted_args is tuple or hinted_args is tuple
             ):
                 payload[arg] = tuple(value)
-            elif isinstance(value, str) and (
-                hinted_args is int or hinted_args is float
+            elif (
+                isinstance(value, str)
+                and (deserializer := _deserializers.get(hinted_args)) is not None
             ):
                 try:
-                    payload[arg] = hinted_args(value)
+                    payload[arg] = deserializer(value)
                 except ValueError:
                     msg = f"Received a string value ({value}) for {arg} but expected a {hinted_args}"
                     raise ValueError(msg) from None

reflex/utils/build.py

@@ -215,10 +215,16 @@ def build():
     )
     processes.show_progress("Creating Production Build", process, checkpoints)
     _duplicate_index_html_to_parent_directory(wdir / constants.Dirs.STATIC)
-    path_ops.cp(
-        wdir / constants.Dirs.STATIC / constants.ReactRouter.SPA_FALLBACK,
-        wdir / constants.Dirs.STATIC / "404.html",
-    )
+
+    spa_fallback = wdir / constants.Dirs.STATIC / constants.ReactRouter.SPA_FALLBACK
+    if not spa_fallback.exists():
+        spa_fallback = wdir / constants.Dirs.STATIC / "index.html"
+
+    if spa_fallback.exists():
+        path_ops.cp(
+            spa_fallback,
+            wdir / constants.Dirs.STATIC / "404.html",
+        )
 
     config = get_config()
 

reflex/utils/exec.py

@@ -743,6 +743,17 @@ def is_prod_mode() -> bool:
     return current_mode == constants.Env.PROD
 
 
+def should_prerender_routes() -> bool:
+    """Check if the app should prerender routes.
+
+    Returns:
+        True if the app should prerender routes.
+    """
+    if not environment.REFLEX_SSR.is_set():
+        return is_prod_mode()
+    return environment.REFLEX_SSR.get()
+
+
 def get_compile_context() -> constants.CompileContext:
     """Check if the app is compiled for deploy.
 

reflex/utils/export.py

@@ -19,6 +19,7 @@ def export(
     env: constants.Env = constants.Env.PROD,
     loglevel: constants.LogLevel = console._LOG_LEVEL,
     backend_excluded_dirs: tuple[Path, ...] = (),
+    prerender_routes: bool = True,
 ):
     """Export the app to a zip file.
 
@@ -33,6 +34,7 @@ def export(
         env: The environment to use. Defaults to constants.Env.PROD.
         loglevel: The log level to use. Defaults to console._LOG_LEVEL.
         backend_excluded_dirs: A tuple of files or directories to exclude from the backend zip.  Defaults to ().
+        prerender_routes: Whether to prerender the routes. Defaults to True.
     """
     config = get_config()
 
@@ -58,7 +60,7 @@ def export(
 
     if frontend:
         # Ensure module can be imported and app.compile() is called.
-        prerequisites.get_compiled_app(prerender_routes=True)
+        prerequisites.get_compiled_app(prerender_routes=prerender_routes)
         # Set up .web directory and install frontend dependencies.
         build.setup_frontend(Path.cwd())