reflex 0.8.13a1__py3-none-any.whl → 0.8.14a1__py3-none-any.whl

reflex/app.py

@@ -69,7 +69,6 @@ from reflex.components.core.banner import (
 )
 from reflex.components.core.breakpoints import set_breakpoints
 from reflex.components.core.sticky import sticky
-from reflex.components.core.upload import Upload, get_upload_dir
 from reflex.components.radix import themes
 from reflex.components.sonner.toast import toast
 from reflex.config import get_config
@@ -628,6 +627,18 @@ class App(MiddlewareMixin, LifespanMixin):
 
         asgi_app = self._api
 
+        if environment.REFLEX_MOUNT_FRONTEND_COMPILED_APP.get():
+            asgi_app.mount(
+                "/" + config.frontend_path.strip("/"),
+                StaticFiles(
+                    directory=prerequisites.get_web_dir()
+                    / constants.Dirs.STATIC
+                    / config.frontend_path.strip("/"),
+                    html=True,
+                ),
+                name="frontend",
+            )
+
         if self.api_transformer is not None:
             api_transformers: Sequence[Starlette | Callable[[ASGIApp], ASGIApp]] = (
                 [self.api_transformer]
@@ -670,6 +681,8 @@ class App(MiddlewareMixin, LifespanMixin):
 
     def _add_optional_endpoints(self):
         """Add optional api endpoints (_upload)."""
+        from reflex.components.core.upload import Upload, get_upload_dir
+
         if not self._api:
             return
         upload_is_used_marker = (
@@ -1010,11 +1023,18 @@ class App(MiddlewareMixin, LifespanMixin):
         for component in tuple(app_wrappers.values()):
             app_wrappers.update(component._get_all_app_wrap_components())
         order = sorted(app_wrappers, key=lambda k: k[0], reverse=True)
-        root = parent = copy.deepcopy(app_wrappers[order[0]])
-        for key in order[1:]:
+        root = copy.deepcopy(app_wrappers[order[0]])
+
+        def reducer(parent: Component, key: tuple[int, str]) -> Component:
             child = copy.deepcopy(app_wrappers[key])
             parent.children.append(child)
-            parent = child
+            return child
+
+        functools.reduce(
+            lambda parent, key: reducer(parent, key),
+            order[1:],
+            root,
+        )
         return root
 
     def _should_compile(self) -> bool:
@@ -1274,7 +1294,7 @@ class App(MiddlewareMixin, LifespanMixin):
 
             toast_provider = Fragment.create(memoized_toast_provider())
 
-            app_wrappers[(1, "ToasterProvider")] = toast_provider
+            app_wrappers[(44, "ToasterProvider")] = toast_provider
 
         # Add the app wraps to the app.
         for key, app_wrap in chain(

reflex/components/core/upload.py

@@ -6,6 +6,7 @@ from collections.abc import Callable, Sequence
 from pathlib import Path
 from typing import Any, ClassVar
 
+from reflex.app import UploadFile
 from reflex.components.base.fragment import Fragment
 from reflex.components.component import (
     Component,
@@ -29,7 +30,9 @@ from reflex.event import (
     call_event_fn,
     call_event_handler,
     parse_args_spec,
+    passthrough_event_spec,
     run_script,
+    upload_files,
 )
 from reflex.style import Style
 from reflex.utils import format
@@ -168,16 +171,7 @@ def get_upload_url(file_path: str | Var[str]) -> Var[str]:
     return Var.create(f"{uploaded_files_url_prefix}/{file_path}")
 
 
-def _on_drop_spec(files: Var) -> tuple[Var[Any]]:
-    """Args spec for the on_drop event trigger.
-
-    Args:
-        files: The files to upload.
-
-    Returns:
-        Signature for on_drop handler including the files to upload.
-    """
-    return (files,)
+_on_drop_spec = passthrough_event_spec(list[UploadFile])
 
 
 def _default_drop_rejected(rejected_files: ArrayVar[list[dict[str, Any]]]) -> EventSpec:
@@ -302,11 +296,11 @@ class Upload(MemoizationLeaf):
         }
 
         # Create the component.
-        upload_props["id"] = props.get("id", DEFAULT_UPLOAD_ID)
+        upload_props["id"] = upload_id = props.get("id", DEFAULT_UPLOAD_ID)
 
         if upload_props.get("on_drop") is None:
             # If on_drop is not provided, save files to be uploaded later.
-            upload_props["on_drop"] = upload_file(upload_props["id"])
+            upload_props["on_drop"] = upload_file(upload_id)
         else:
             on_drop = (
                 [on_drop_prop]
@@ -314,7 +308,9 @@ class Upload(MemoizationLeaf):
                 else list(on_drop_prop)
             )
             for ix, event in enumerate(on_drop):
-                if isinstance(event, (EventHandler, EventSpec)):
+                if isinstance(event, EventHandler):
+                    event = event(upload_files(upload_id))
+                if isinstance(event, EventSpec):
                     # Call the lambda to get the event chain.
                     event = call_event_handler(event, _on_drop_spec)
                 elif isinstance(event, Callable):

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.0"]
+    lib_dependencies: list[str] = ["plotly.js@3.1.1"]
 
     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.0"]
+    lib_dependencies: list[str] = ["plotly.js-basic-dist-min@3.1.1"]
 
     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.0"]
+    lib_dependencies: list[str] = ["plotly.js-cartesian-dist-min@3.1.1"]
 
     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.0"]
+    lib_dependencies: list[str] = ["plotly.js-geo-dist-min@3.1.1"]
 
     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.0"]
+    lib_dependencies: list[str] = ["plotly.js-gl3d-dist-min@3.1.1"]
 
     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.0"]
+    lib_dependencies: list[str] = ["plotly.js-gl2d-dist-min@3.1.1"]
 
     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.0"]
+    lib_dependencies: list[str] = ["plotly.js-mapbox-dist-min@3.1.1"]
 
     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.0"]
+    lib_dependencies: list[str] = ["plotly.js-finance-dist-min@3.1.1"]
 
     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.0"]
+    lib_dependencies: list[str] = ["plotly.js-strict-dist-min@3.1.1"]
 
     def add_imports(self) -> ImportDict | list[ImportDict]:
         """Add imports for the plotly strict component.

reflex/components/radix/primitives/slider.py

@@ -7,7 +7,7 @@ from typing import Any, Literal
 
 from reflex.components.component import Component, ComponentNamespace
 from reflex.components.radix.primitives.base import RadixPrimitiveComponentWithClassName
-from reflex.event import EventHandler
+from reflex.event import EventHandler, passthrough_event_spec
 from reflex.vars.base import Var
 
 LiteralSliderOrientation = Literal["horizontal", "vertical"]
@@ -20,20 +20,6 @@ class SliderComponent(RadixPrimitiveComponentWithClassName):
     library = "@radix-ui/react-slider@1.3.6"
 
 
-def on_value_event_spec(
-    value: Var[list[int]],
-) -> tuple[Var[list[int]]]:
-    """Event handler spec for the value event.
-
-    Args:
-        value: The value of the event.
-
-    Returns:
-        The event handler spec.
-    """
-    return (value,)
-
-
 class SliderRoot(SliderComponent):
     """The Slider component containing all slider parts."""
 
@@ -63,10 +49,10 @@ class SliderRoot(SliderComponent):
     min_steps_between_thumbs: Var[int]
 
     # Fired when the value of a thumb changes.
-    on_value_change: EventHandler[on_value_event_spec]
+    on_value_change: EventHandler[passthrough_event_spec(list[float])]
 
     # Fired when a thumb is released.
-    on_value_commit: EventHandler[on_value_event_spec]
+    on_value_commit: EventHandler[passthrough_event_spec(list[float])]
 
     def add_style(self) -> dict[str, Any] | None:
         """Add style to the component.

reflex/components/radix/primitives/slider.pyi

@@ -66,8 +66,6 @@ class SliderComponent(RadixPrimitiveComponentWithClassName):
             The component.
         """
 
-def on_value_event_spec(value: Var[list[int]]) -> tuple[Var[list[int]]]: ...
-
 class SliderRoot(SliderComponent):
     def add_style(self) -> dict[str, Any] | None: ...
     @classmethod
@@ -114,8 +112,8 @@ class SliderRoot(SliderComponent):
         on_scroll: EventType[()] | None = None,
         on_scroll_end: EventType[()] | None = None,
         on_unmount: EventType[()] | None = None,
-        on_value_change: EventType[()] | EventType[list[int]] | None = None,
-        on_value_commit: EventType[()] | EventType[list[int]] | None = None,
+        on_value_change: EventType[()] | EventType[list[float]] | None = None,
+        on_value_commit: EventType[()] | EventType[list[float]] | None = None,
         **props,
     ) -> SliderRoot:
         """Create the component.

reflex/components/radix/themes/components/slider.py

@@ -13,9 +13,8 @@ from reflex.utils.types import typehint_issubclass
 from reflex.vars.base import Var
 
 on_value_event_spec = (
-    passthrough_event_spec(list[int | float]),
-    passthrough_event_spec(list[int]),
     passthrough_event_spec(list[float]),
+    passthrough_event_spec(list[int]),
 )
 
 

reflex/components/radix/themes/components/slider.pyi

@@ -12,9 +12,8 @@ from reflex.event import EventType, PointerEventInfo, passthrough_event_spec
 from reflex.vars.base import Var
 
 on_value_event_spec = (
-    passthrough_event_spec(list[int | float]),
-    passthrough_event_spec(list[int]),
     passthrough_event_spec(list[float]),
+    passthrough_event_spec(list[int]),
 )
 
 class Slider(RadixThemesComponent):
@@ -120,9 +119,8 @@ class Slider(RadixThemesComponent):
         custom_attrs: dict[str, Var | Any] | None = None,
         on_blur: EventType[()] | None = None,
         on_change: EventType[()]
-        | EventType[list[int | float]]
+        | EventType[list[float]]
         | (EventType[()] | EventType[list[int]])
-        | (EventType[()] | EventType[list[float]])
         | None = None,
         on_click: EventType[()] | EventType[PointerEventInfo] | None = None,
         on_context_menu: EventType[()] | EventType[PointerEventInfo] | None = None,
@@ -140,9 +138,8 @@ class Slider(RadixThemesComponent):
         on_scroll_end: EventType[()] | None = None,
         on_unmount: EventType[()] | None = None,
         on_value_commit: EventType[()]
-        | EventType[list[int | float]]
+        | EventType[list[float]]
         | (EventType[()] | EventType[list[int]])
-        | (EventType[()] | EventType[list[float]])
         | None = None,
         **props,
     ) -> Slider:

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.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.
         """