reflex 0.8.12a2__py3-none-any.whl → 0.8.13__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/audio.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 Audio(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 Audio(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 Audio(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,
     ) -> Audio:
-        """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/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/react_player/react_player.pyi

@@ -6,29 +6,49 @@
 from collections.abc import Mapping, Sequence
 from typing import Any, TypedDict
 
-from reflex.components.component import NoSSRComponent
+from reflex.components.component import Component
 from reflex.components.core.breakpoints import Breakpoints
 from reflex.event import EventType, PointerEventInfo
 from reflex.vars.base import Var
+from reflex.vars.object import ObjectVar
+
+ReactPlayerEvent = ObjectVar[dict[str, dict[str, dict[str, Any]]]]
 
 class Progress(TypedDict):
     played: float
     playedSeconds: float
     loaded: float
     loadedSeconds: float
+    duration: float
+
+_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(NoSSRComponent):
+class ReactPlayer(Component):
     @classmethod
     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]]
@@ -40,18 +60,16 @@ class ReactPlayer(NoSSRComponent):
         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,
@@ -62,52 +80,29 @@ class ReactPlayer(NoSSRComponent):
         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[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,
     ) -> ReactPlayer:
-        """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.
         """