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

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

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/istate/proxy.py

@@ -71,10 +71,15 @@ class StateProxy(wrapt.ObjectProxy):
             state_instance: The state instance to proxy.
             parent_state_proxy: The parent state proxy, for linked mutability and context tracking.
         """
+        from reflex.state import _substate_key
+
         super().__init__(state_instance)
-        # compile is not relevant to backend logic
         self._self_app = prerequisites.get_and_validate_app().app
         self._self_substate_path = tuple(state_instance.get_full_name().split("."))
+        self._self_substate_token = _substate_key(
+            state_instance.router.session.client_token,
+            self._self_substate_path,
+        )
         self._self_actx = None
         self._self_mutable = False
         self._self_actx_lock = asyncio.Lock()
@@ -127,16 +132,9 @@ class StateProxy(wrapt.ObjectProxy):
             msg = "The state is already mutable. Do not nest `async with self` blocks."
             raise ImmutableStateError(msg)
 
-        from reflex.state import _substate_key
-
         await self._self_actx_lock.acquire()
         self._self_actx_lock_holder = current_task
-        self._self_actx = self._self_app.modify_state(
-            token=_substate_key(
-                self.__wrapped__.router.session.client_token,
-                self._self_substate_path,
-            )
-        )
+        self._self_actx = self._self_app.modify_state(token=self._self_substate_token)
         mutable_state = await self._self_actx.__aenter__()
         super().__setattr__(
             "__wrapped__", mutable_state.get_substate(self._self_substate_path)
@@ -378,17 +376,6 @@ class MutableProxy(wrapt.ObjectProxy):
         pydantic.BaseModel.__dict__
     )
 
-    # These types will be wrapped in MutableProxy
-    __mutable_types__ = (
-        list,
-        dict,
-        set,
-        Base,
-        DeclarativeBase,
-        BaseModelV2,
-        BaseModelV1,
-    )
-
     # Dynamically generated classes for tracking dataclass mutations.
     __dataclass_proxies__: dict[type, type] = {}
 
@@ -469,20 +456,6 @@ class MutableProxy(wrapt.ObjectProxy):
             return wrapped(*args, **(kwargs or {}))
         return None
 
-    @classmethod
-    def _is_mutable_type(cls, value: Any) -> bool:
-        """Check if a value is of a mutable type and should be wrapped.
-
-        Args:
-            value: The value to check.
-
-        Returns:
-            Whether the value is of a mutable type.
-        """
-        return isinstance(value, cls.__mutable_types__) or (
-            dataclasses.is_dataclass(value) and not isinstance(value, Var)
-        )
-
     @staticmethod
     def _is_called_from_dataclasses_internal() -> bool:
         """Check if the current function is called from dataclasses helper.
@@ -514,7 +487,7 @@ class MutableProxy(wrapt.ObjectProxy):
         if self._is_called_from_dataclasses_internal():
             return value
         # Recursively wrap mutable types, but do not re-wrap MutableProxy instances.
-        if self._is_mutable_type(value) and not isinstance(value, MutableProxy):
+        if is_mutable_type(type(value)) and not isinstance(value, MutableProxy):
             base_cls = globals()[self.__base_proxy__]
             return base_cls(
                 wrapped=value,
@@ -575,7 +548,7 @@ class MutableProxy(wrapt.ObjectProxy):
                     self._wrap_recursive_decorator,
                 )
 
-        if self._is_mutable_type(value) and __name not in (
+        if is_mutable_type(type(value)) and __name not in (
             "__wrapped__",
             "_self_state",
             "__dict__",
@@ -764,3 +737,30 @@ class ImmutableMutableProxy(MutableProxy):
         return super()._mark_dirty(
             wrapped=wrapped, instance=instance, args=args, kwargs=kwargs
         )
+
+
+# These types will be wrapped in MutableProxy
+MUTABLE_TYPES = (
+    list,
+    dict,
+    set,
+    Base,
+    DeclarativeBase,
+    BaseModelV2,
+    BaseModelV1,
+)
+
+
+@functools.lru_cache(maxsize=1024)
+def is_mutable_type(type_: type) -> bool:
+    """Check if a type is mutable and should be wrapped.
+
+    Args:
+        type_: The type to check.
+
+    Returns:
+        Whether the type is mutable and should be wrapped.
+    """
+    return issubclass(type_, MUTABLE_TYPES) or (
+        dataclasses.is_dataclass(type_) and not issubclass(type_, Var)
+    )