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

reflex/components/react_player/video.pyi

@@ -6,7 +6,6 @@
 from collections.abc import Mapping, Sequence
 from typing import Any
 
-import reflex
 from reflex.components.core.breakpoints import Breakpoints
 from reflex.components.react_player.react_player import ReactPlayer
 from reflex.event import EventType, PointerEventInfo
@@ -17,13 +16,18 @@ class Video(ReactPlayer):
     def create(
         cls,
         *children,
-        url: Var[str] | str | None = None,
+        src: Var[list[dict[str, str]] | list[str] | str]
+        | list[dict[str, str]]
+        | list[str]
+        | str
+        | None = None,
         playing: Var[bool] | bool | None = None,
         loop: Var[bool] | bool | None = None,
         controls: Var[bool] | bool | None = None,
         light: Var[bool] | bool | None = None,
         volume: Var[float] | float | None = None,
         muted: Var[bool] | bool | None = None,
+        config: Var[dict[str, Any]] | dict[str, Any] | None = None,
         style: Sequence[Mapping[str, Any]]
         | Mapping[str, Any]
         | Var[Mapping[str, Any]]
@@ -35,18 +39,16 @@ class Video(ReactPlayer):
         class_name: Any | None = None,
         custom_attrs: dict[str, Var | Any] | None = None,
         on_blur: EventType[()] | None = None,
-        on_buffer: EventType[()] | None = None,
-        on_buffer_end: EventType[()] | None = None,
         on_click: EventType[()] | EventType[PointerEventInfo] | None = None,
         on_click_preview: EventType[()] | None = None,
         on_context_menu: EventType[()] | EventType[PointerEventInfo] | None = None,
-        on_disable_pip: EventType[()] | None = None,
         on_double_click: EventType[()] | EventType[PointerEventInfo] | None = None,
-        on_duration: EventType[()] | EventType[float] | None = None,
-        on_enable_pip: EventType[()] | None = None,
+        on_duration_change: EventType[Any] | None = None,
         on_ended: EventType[()] | None = None,
+        on_enter_picture_in_picture: EventType[()] | None = None,
         on_error: EventType[()] | None = None,
         on_focus: EventType[()] | None = None,
+        on_leave_picture_in_picture: EventType[()] | None = None,
         on_mount: EventType[()] | None = None,
         on_mouse_down: EventType[()] | None = None,
         on_mouse_enter: EventType[()] | None = None,
@@ -57,54 +59,29 @@ class Video(ReactPlayer):
         on_mouse_up: EventType[()] | None = None,
         on_pause: EventType[()] | None = None,
         on_play: EventType[()] | None = None,
-        on_playback_quality_change: EventType[()] | None = None,
-        on_playback_rate_change: EventType[()] | None = None,
-        on_progress: EventType[()]
-        | EventType[reflex.components.react_player.react_player.Progress]
-        | None = None,
+        on_playing: EventType[()] | None = None,
+        on_progress: EventType[Any] | None = None,
+        on_rate_change: EventType[Any] | None = None,
         on_ready: EventType[()] | None = None,
         on_scroll: EventType[()] | None = None,
         on_scroll_end: EventType[()] | None = None,
-        on_seek: EventType[()] | EventType[float] | None = None,
+        on_seeked: EventType[Any] | None = None,
+        on_seeking: EventType[()] | None = None,
         on_start: EventType[()] | None = None,
+        on_time_update: EventType[Any] | None = None,
         on_unmount: EventType[()] | None = None,
+        on_waiting: EventType[()] | None = None,
         **props,
     ) -> Video:
-        """Create the component.
+        """Create a component.
 
         Args:
-            *children: The children of the component.
-            url: The url of a video or song to play
-            playing: Set to true or false to pause or play the media
-            loop: Set to true or false to loop the media
-            controls: Set to true or false to display native player controls.
-            light: Set to true to show just the video thumbnail, which loads the full player on click
-            volume: Set the volume of the player, between 0 and 1
-            muted: Mutes the player
-            on_ready: Called when media is loaded and ready to play. If playing is set to true, media will play immediately.
-            on_start: Called when media starts playing.
-            on_play: Called when media starts or resumes playing after pausing or buffering.
-            on_progress: 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_duration: Callback containing duration of the media, in seconds.
-            on_pause: Called when media is paused.
-            on_buffer: Called when media starts buffering.
-            on_buffer_end: Called when media has finished buffering. Works for files, YouTube and Facebook.
-            on_seek: Called when media seeks with seconds parameter.
-            on_playback_rate_change: Called when playback rate of the player changed. Only supported by YouTube, Vimeo (if enabled), Wistia, and file paths.
-            on_playback_quality_change: Called when playback quality of the player changed. Only supported by YouTube (if enabled).
-            on_ended: Called when media finishes playing. Does not fire when loop is set to true.
-            on_error: Called when an error occurs whilst attempting to play media.
-            on_click_preview: Called when user clicks the light mode preview.
-            on_enable_pip: Called when picture-in-picture mode is enabled.
-            on_disable_pip: Called when picture-in-picture mode is disabled.
-            style: The style of the component.
-            key: A unique key for the component.
-            id: The id for the component.
-            ref: The Var to pass as the ref to the component.
-            class_name: The class name for the component.
-            custom_attrs: custom attribute
-            **props: The props of the component.
+            children: The children of the component.
+            props: The props of the component.
 
         Returns:
-            The component.
+            The created component.
+
+        Raises:
+            ValueError: If both a deprecated prop and its replacement are both passed.
         """

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())
 

reflex/utils/prerequisites.py

@@ -269,25 +269,100 @@ def get_compiled_app(
     return app_module
 
 
+def _can_colorize() -> bool:
+    """Check if the output can be colorized.
+
+    Copied from _colorize.can_colorize.
+
+    https://raw.githubusercontent.com/python/cpython/refs/heads/main/Lib/_colorize.py
+
+    Returns:
+        If the output can be colorized
+    """
+    import io
+    import os
+
+    def _safe_getenv(k: str, fallback: str | None = None) -> str | None:
+        """Exception-safe environment retrieval. See gh-128636.
+
+        Args:
+            k: The environment variable key.
+            fallback: The fallback value if the environment variable is not set.
+
+        Returns:
+            The value of the environment variable or the fallback value.
+        """
+        try:
+            return os.environ.get(k, fallback)
+        except Exception:
+            return fallback
+
+    file = sys.stdout
+
+    if not sys.flags.ignore_environment:
+        if _safe_getenv("PYTHON_COLORS") == "0":
+            return False
+        if _safe_getenv("PYTHON_COLORS") == "1":
+            return True
+    if _safe_getenv("NO_COLOR"):
+        return False
+    if _safe_getenv("FORCE_COLOR"):
+        return True
+    if _safe_getenv("TERM") == "dumb":
+        return False
+
+    if not hasattr(file, "fileno"):
+        return False
+
+    if sys.platform == "win32":
+        try:
+            import nt
+
+            if not nt._supports_virtual_terminal():
+                return False
+        except (ImportError, AttributeError):
+            return False
+
+    try:
+        return os.isatty(file.fileno())
+    except io.UnsupportedOperation:
+        return hasattr(file, "isatty") and file.isatty()
+
+
 def compile_or_validate_app(
     compile: bool = False,
     check_if_schema_up_to_date: bool = False,
     prerender_routes: bool = False,
-):
+) -> bool:
     """Compile or validate the app module based on the default config.
 
     Args:
         compile: Whether to compile the app.
         check_if_schema_up_to_date: If True, check if the schema is up to date.
         prerender_routes: Whether to prerender routes.
+
+    Returns:
+        True if the app was successfully compiled or validated, False otherwise.
     """
-    if compile:
-        get_compiled_app(
-            check_if_schema_up_to_date=check_if_schema_up_to_date,
-            prerender_routes=prerender_routes,
-        )
+    try:
+        if compile:
+            get_compiled_app(
+                check_if_schema_up_to_date=check_if_schema_up_to_date,
+                prerender_routes=prerender_routes,
+            )
+        else:
+            get_and_validate_app(check_if_schema_up_to_date=check_if_schema_up_to_date)
+    except Exception as e:
+        import traceback
+
+        try:
+            colorize = _can_colorize()
+            traceback.print_exception(e, colorize=colorize)  # pyright: ignore[reportCallIssue]
+        except Exception:
+            traceback.print_exception(e)
+        return False
     else:
-        get_and_validate_app(check_if_schema_up_to_date=check_if_schema_up_to_date)
+        return True
 
 
 def get_redis() -> Redis | None:

reflex/utils/serializers.py

@@ -20,7 +20,7 @@ from pydantic import BaseModel as BaseModelV2
 from pydantic.v1 import BaseModel as BaseModelV1
 
 from reflex.base import Base
-from reflex.constants.colors import Color, format_color
+from reflex.constants.colors import Color
 from reflex.utils import console, types
 
 # Mapping from type to a serializer.
@@ -413,8 +413,8 @@ def serialize_decimal(value: decimal.Decimal) -> float:
     return float(value)
 
 
-@serializer(to=str)
-def serialize_color(color: Color) -> str:
+@serializer(to=dict)
+def serialize_color(color: Color) -> dict:
     """Serialize a color.
 
     Args:
@@ -423,7 +423,11 @@ def serialize_color(color: Color) -> str:
     Returns:
         The serialized color.
     """
-    return format_color(color.color, color.shade, color.alpha)
+    return {
+        "color": color.color,
+        "shade": color.shade,
+        "alpha": color.alpha,
+    }
 
 
 with contextlib.suppress(ImportError):

reflex/vars/__init__.py

@@ -1,28 +1,58 @@
 """Immutable-Based Var System."""
 
-from .base import BaseStateMeta as BaseStateMeta
-from .base import EvenMoreBasicBaseState as EvenMoreBasicBaseState
-from .base import Field as Field
-from .base import LiteralVar as LiteralVar
-from .base import Var as Var
-from .base import VarData as VarData
-from .base import field as field
-from .base import get_unique_variable_name as get_unique_variable_name
-from .base import get_uuid_string_var as get_uuid_string_var
-from .base import var_operation as var_operation
-from .base import var_operation_return as var_operation_return
-from .datetime import DateTimeVar as DateTimeVar
-from .function import FunctionStringVar as FunctionStringVar
-from .function import FunctionVar as FunctionVar
-from .function import VarOperationCall as VarOperationCall
-from .number import BooleanVar as BooleanVar
-from .number import LiteralBooleanVar as LiteralBooleanVar
-from .number import LiteralNumberVar as LiteralNumberVar
-from .number import NumberVar as NumberVar
-from .object import LiteralObjectVar as LiteralObjectVar
-from .object import ObjectVar as ObjectVar
-from .sequence import ArrayVar as ArrayVar
-from .sequence import ConcatVarOperation as ConcatVarOperation
-from .sequence import LiteralArrayVar as LiteralArrayVar
-from .sequence import LiteralStringVar as LiteralStringVar
-from .sequence import StringVar as StringVar
+from .base import (
+    BaseStateMeta,
+    EvenMoreBasicBaseState,
+    Field,
+    LiteralVar,
+    Var,
+    VarData,
+    field,
+    get_unique_variable_name,
+    get_uuid_string_var,
+    var_operation,
+    var_operation_return,
+)
+from .color import ColorVar, LiteralColorVar
+from .datetime import DateTimeVar
+from .function import FunctionStringVar, FunctionVar, VarOperationCall
+from .number import BooleanVar, LiteralBooleanVar, LiteralNumberVar, NumberVar
+from .object import LiteralObjectVar, ObjectVar
+from .sequence import (
+    ArrayVar,
+    ConcatVarOperation,
+    LiteralArrayVar,
+    LiteralStringVar,
+    StringVar,
+)
+
+__all__ = [
+    "ArrayVar",
+    "BaseStateMeta",
+    "BooleanVar",
+    "ColorVar",
+    "ConcatVarOperation",
+    "DateTimeVar",
+    "EvenMoreBasicBaseState",
+    "Field",
+    "FunctionStringVar",
+    "FunctionVar",
+    "LiteralArrayVar",
+    "LiteralBooleanVar",
+    "LiteralColorVar",
+    "LiteralNumberVar",
+    "LiteralObjectVar",
+    "LiteralStringVar",
+    "LiteralVar",
+    "NumberVar",
+    "ObjectVar",
+    "StringVar",
+    "Var",
+    "VarData",
+    "VarOperationCall",
+    "field",
+    "get_unique_variable_name",
+    "get_uuid_string_var",
+    "var_operation",
+    "var_operation_return",
+]