reflex 0.5.4a3__py3-none-any.whl → 0.5.5__py3-none-any.whl

reflex/components/chakra/forms/input.py

@@ -1,7 +1,5 @@
 """An input component."""
 
-from typing import Any, Dict
-
 from reflex.components.chakra import (
     ChakraComponent,
     LiteralButtonSize,
@@ -10,8 +8,9 @@ from reflex.components.chakra import (
 from reflex.components.component import Component
 from reflex.components.core.debounce import DebounceInput
 from reflex.components.literals import LiteralInputType
-from reflex.constants import EventTriggers, MemoizationMode
-from reflex.utils import imports
+from reflex.constants import MemoizationMode
+from reflex.event import EventHandler
+from reflex.utils.imports import ImportDict
 from reflex.vars import Var
 
 
@@ -59,26 +58,28 @@ class Input(ChakraComponent):
     # The name of the form field
     name: Var[str]
 
-    def _get_imports(self) -> imports.ImportDict:
-        return imports.merge_imports(
-            super()._get_imports(),
-            {"/utils/state": {imports.ImportVar(tag="set_val")}},
-        )
+    # Fired when the input value changes.
+    on_change: EventHandler[lambda e0: [e0.target.value]]
+
+    # Fired when the input is focused.
+    on_focus: EventHandler[lambda e0: [e0.target.value]]
+
+    # Fired when the input lose focus.
+    on_blur: EventHandler[lambda e0: [e0.target.value]]
+
+    # Fired when a key is pressed down.
+    on_key_down: EventHandler[lambda e0: [e0.key]]
+
+    # Fired when a key is released.
+    on_key_up: EventHandler[lambda e0: [e0.key]]
 
-    def get_event_triggers(self) -> Dict[str, Any]:
-        """Get the event triggers that pass the component's value to the handler.
+    def add_imports(self) -> ImportDict:
+        """Add imports for the Input component.
 
         Returns:
-            A dict mapping the event trigger to the var that is passed to the handler.
+            The import dict.
         """
-        return {
-            **super().get_event_triggers(),
-            EventTriggers.ON_CHANGE: lambda e0: [e0.target.value],
-            EventTriggers.ON_FOCUS: lambda e0: [e0.target.value],
-            EventTriggers.ON_BLUR: lambda e0: [e0.target.value],
-            EventTriggers.ON_KEY_DOWN: lambda e0: [e0.key],
-            EventTriggers.ON_KEY_UP: lambda e0: [e0.key],
-        }
+        return {"/utils/state": "set_val"}
 
     @classmethod
     def create(cls, *children, **props) -> Component:
@@ -91,7 +92,7 @@ class Input(ChakraComponent):
         Returns:
             The component.
         """
-        if props.get("value") is not None and props.get("on_change"):
+        if props.get("value") is not None and props.get("on_change") is not None:
             # create a debounced input if the user requests full control to avoid typing jank
             return DebounceInput.create(super().create(*children, **props))
         return super().create(*children, **props)

reflex/components/chakra/forms/input.pyi

@@ -7,7 +7,6 @@ from typing import Any, Dict, Literal, Optional, Union, overload
 from reflex.vars import Var, BaseVar, ComputedVar
 from reflex.event import EventChain, EventHandler, EventSpec
 from reflex.style import Style
-from typing import Any, Dict
 from reflex.components.chakra import (
     ChakraComponent,
     LiteralButtonSize,
@@ -16,12 +15,13 @@ from reflex.components.chakra import (
 from reflex.components.component import Component
 from reflex.components.core.debounce import DebounceInput
 from reflex.components.literals import LiteralInputType
-from reflex.constants import EventTriggers, MemoizationMode
-from reflex.utils import imports
+from reflex.constants import MemoizationMode
+from reflex.event import EventHandler
+from reflex.utils.imports import ImportDict
 from reflex.vars import Var
 
 class Input(ChakraComponent):
-    def get_event_triggers(self) -> Dict[str, Any]: ...
+    def add_imports(self) -> ImportDict: ...
     @overload
     @classmethod
     def create(  # type: ignore

reflex/components/chakra/forms/multiselect.py

@@ -1,4 +1,5 @@
 """Provides a feature-rich Select and some (not all) related components."""
+
 from __future__ import annotations
 
 from typing import Any, Dict, List, Optional, Set, Union

reflex/components/chakra/forms/numberinput.py

@@ -1,7 +1,6 @@
 """A number input component."""
 
 from numbers import Number
-from typing import Any, Dict
 
 from reflex.components.chakra import (
     ChakraComponent,
@@ -9,7 +8,7 @@ from reflex.components.chakra import (
     LiteralInputVariant,
 )
 from reflex.components.component import Component
-from reflex.constants import EventTriggers
+from reflex.event import EventHandler
 from reflex.vars import Var
 
 
@@ -75,16 +74,8 @@ class NumberInput(ChakraComponent):
     # The name of the form field
     name: Var[str]
 
-    def get_event_triggers(self) -> Dict[str, Any]:
-        """Get the event triggers that pass the component's value to the handler.
-
-        Returns:
-            A dict mapping the event trigger to the var that is passed to the handler.
-        """
-        return {
-            **super().get_event_triggers(),
-            EventTriggers.ON_CHANGE: lambda e0: [e0],
-        }
+    # Fired when the input value changes.
+    on_change: EventHandler[lambda e0: [e0]]
 
     @classmethod
     def create(cls, *children, **props) -> Component:

reflex/components/chakra/forms/numberinput.pyi

@@ -8,18 +8,16 @@ from reflex.vars import Var, BaseVar, ComputedVar
 from reflex.event import EventChain, EventHandler, EventSpec
 from reflex.style import Style
 from numbers import Number
-from typing import Any, Dict
 from reflex.components.chakra import (
     ChakraComponent,
     LiteralButtonSize,
     LiteralInputVariant,
 )
 from reflex.components.component import Component
-from reflex.constants import EventTriggers
+from reflex.event import EventHandler
 from reflex.vars import Var
 
 class NumberInput(ChakraComponent):
-    def get_event_triggers(self) -> Dict[str, Any]: ...
     @overload
     @classmethod
     def create(  # type: ignore

reflex/components/chakra/forms/pininput.py

@@ -2,12 +2,12 @@
 
 from __future__ import annotations
 
-from typing import Any, Optional, Union
+from typing import Optional
 
 from reflex.components.chakra import ChakraComponent, LiteralInputVariant
 from reflex.components.component import Component
 from reflex.components.tags.tag import Tag
-from reflex.constants import EventTriggers
+from reflex.event import EventHandler
 from reflex.utils import format
 from reflex.utils.imports import ImportDict, merge_imports
 from reflex.vars import Var
@@ -63,6 +63,12 @@ class PinInput(ChakraComponent):
     # The name of the form field
     name: Var[str]
 
+    # Fired when the pin input is changed.
+    on_change: EventHandler[lambda e0: [e0]]
+
+    # Fired when the pin input is completed.
+    on_complete: EventHandler[lambda e0: [e0]]
+
     def _get_imports(self) -> ImportDict:
         """Include PinInputField explicitly because it may not be a child component at compile time.
 
@@ -76,18 +82,6 @@ class PinInput(ChakraComponent):
             range_var._var_data.imports if range_var._var_data is not None else {},
         )
 
-    def get_event_triggers(self) -> dict[str, Union[Var, Any]]:
-        """Get the event triggers that pass the component's value to the handler.
-
-        Returns:
-            A dict mapping the event trigger to the var that is passed to the handler.
-        """
-        return {
-            **super().get_event_triggers(),
-            EventTriggers.ON_CHANGE: lambda e0: [e0],
-            EventTriggers.ON_COMPLETE: lambda e0: [e0],
-        }
-
     def get_ref(self) -> str | None:
         """Override ref handling to handle array refs.
 

reflex/components/chakra/forms/pininput.pyi

@@ -7,17 +7,16 @@ from typing import Any, Dict, Literal, Optional, Union, overload
 from reflex.vars import Var, BaseVar, ComputedVar
 from reflex.event import EventChain, EventHandler, EventSpec
 from reflex.style import Style
-from typing import Any, Optional, Union
+from typing import Optional
 from reflex.components.chakra import ChakraComponent, LiteralInputVariant
 from reflex.components.component import Component
 from reflex.components.tags.tag import Tag
-from reflex.constants import EventTriggers
+from reflex.event import EventHandler
 from reflex.utils import format
 from reflex.utils.imports import ImportDict, merge_imports
 from reflex.vars import Var
 
 class PinInput(ChakraComponent):
-    def get_event_triggers(self) -> dict[str, Union[Var, Any]]: ...
     def get_ref(self) -> str | None: ...
     @overload
     @classmethod

reflex/components/chakra/forms/radio.py

@@ -1,13 +1,12 @@
 """A radio component."""
 
-
-from typing import Any, Dict, List, Union
+from typing import Any, List
 
 from reflex.components.chakra import ChakraComponent
 from reflex.components.chakra.typography.text import Text
 from reflex.components.component import Component
 from reflex.components.core.foreach import Foreach
-from reflex.constants import EventTriggers
+from reflex.event import EventHandler
 from reflex.utils.types import _issubclass
 from reflex.vars import Var
 
@@ -26,16 +25,8 @@ class RadioGroup(ChakraComponent):
     # The name of the form field
     name: Var[str]
 
-    def get_event_triggers(self) -> Dict[str, Union[Var, Any]]:
-        """Get the event triggers that pass the component's value to the handler.
-
-        Returns:
-            A dict mapping the event trigger to the var that is passed to the handler.
-        """
-        return {
-            **super().get_event_triggers(),
-            EventTriggers.ON_CHANGE: lambda e0: [e0],
-        }
+    # Fired when the radio group value changes.
+    on_change: EventHandler[lambda e0: [e0]]
 
     @classmethod
     def create(cls, *children, **props) -> Component:

reflex/components/chakra/forms/radio.pyi

@@ -7,17 +7,16 @@ from typing import Any, Dict, Literal, Optional, Union, overload
 from reflex.vars import Var, BaseVar, ComputedVar
 from reflex.event import EventChain, EventHandler, EventSpec
 from reflex.style import Style
-from typing import Any, Dict, List, Union
+from typing import Any, List
 from reflex.components.chakra import ChakraComponent
 from reflex.components.chakra.typography.text import Text
 from reflex.components.component import Component
 from reflex.components.core.foreach import Foreach
-from reflex.constants import EventTriggers
+from reflex.event import EventHandler
 from reflex.utils.types import _issubclass
 from reflex.vars import Var
 
 class RadioGroup(ChakraComponent):
-    def get_event_triggers(self) -> Dict[str, Union[Var, Any]]: ...
     @overload
     @classmethod
     def create(  # type: ignore

reflex/components/chakra/forms/rangeslider.py

@@ -1,11 +1,12 @@
 """A range slider component."""
+
 from __future__ import annotations
 
-from typing import Any, List, Optional, Union
+from typing import List, Optional
 
 from reflex.components.chakra import ChakraComponent, LiteralChakraDirection
 from reflex.components.component import Component
-from reflex.constants import EventTriggers
+from reflex.event import EventHandler
 from reflex.utils import format
 from reflex.vars import Var
 
@@ -48,18 +49,14 @@ class RangeSlider(ChakraComponent):
     # The name of the form field
     name: Var[str]
 
-    def get_event_triggers(self) -> dict[str, Union[Var, Any]]:
-        """Get the event triggers that pass the component's value to the handler.
+    # Fired when the value changes.
+    on_change: EventHandler[lambda e0: [e0]]
 
-        Returns:
-            A dict mapping the event trigger to the var that is passed to the handler.
-        """
-        return {
-            **super().get_event_triggers(),
-            EventTriggers.ON_CHANGE: lambda e0: [e0],
-            EventTriggers.ON_CHANGE_END: lambda e0: [e0],
-            EventTriggers.ON_CHANGE_START: lambda e0: [e0],
-        }
+    # Fired when the value starts changing.
+    on_change_start: EventHandler[lambda e0: [e0]]
+
+    # Fired when the value stops changing.
+    on_change_end: EventHandler[lambda e0: [e0]]
 
     def get_ref(self):
         """Get the ref of the component.

reflex/components/chakra/forms/rangeslider.pyi

@@ -7,15 +7,14 @@ from typing import Any, Dict, Literal, Optional, Union, overload
 from reflex.vars import Var, BaseVar, ComputedVar
 from reflex.event import EventChain, EventHandler, EventSpec
 from reflex.style import Style
-from typing import Any, List, Optional, Union
+from typing import List, Optional
 from reflex.components.chakra import ChakraComponent, LiteralChakraDirection
 from reflex.components.component import Component
-from reflex.constants import EventTriggers
+from reflex.event import EventHandler
 from reflex.utils import format
 from reflex.vars import Var
 
 class RangeSlider(ChakraComponent):
-    def get_event_triggers(self) -> dict[str, Union[Var, Any]]: ...
     def get_ref(self): ...
     @overload
     @classmethod

reflex/components/chakra/forms/select.py

@@ -1,12 +1,12 @@
 """A select component."""
 
-from typing import Any, Dict, List, Union
+from typing import Any, List
 
 from reflex.components.chakra import ChakraComponent, LiteralInputVariant
 from reflex.components.chakra.typography.text import Text
 from reflex.components.component import Component
 from reflex.components.core.foreach import Foreach
-from reflex.constants import EventTriggers
+from reflex.event import EventHandler
 from reflex.utils.types import _issubclass
 from reflex.vars import Var
 
@@ -49,16 +49,8 @@ class Select(ChakraComponent):
     # The name of the form field
     name: Var[str]
 
-    def get_event_triggers(self) -> Dict[str, Union[Var, Any]]:
-        """Get the event triggers that pass the component's value to the handler.
-
-        Returns:
-            A dict mapping the event trigger to the var that is passed to the handler.
-        """
-        return {
-            **super().get_event_triggers(),
-            EventTriggers.ON_CHANGE: lambda e0: [e0.target.value],
-        }
+    # Fired when the value changes.
+    on_change: EventHandler[lambda e0: [e0.target.value]]
 
     @classmethod
     def create(cls, *children, **props) -> Component:

reflex/components/chakra/forms/select.pyi

@@ -7,17 +7,16 @@ from typing import Any, Dict, Literal, Optional, Union, overload
 from reflex.vars import Var, BaseVar, ComputedVar
 from reflex.event import EventChain, EventHandler, EventSpec
 from reflex.style import Style
-from typing import Any, Dict, List, Union
+from typing import Any, List
 from reflex.components.chakra import ChakraComponent, LiteralInputVariant
 from reflex.components.chakra.typography.text import Text
 from reflex.components.component import Component
 from reflex.components.core.foreach import Foreach
-from reflex.constants import EventTriggers
+from reflex.event import EventHandler
 from reflex.utils.types import _issubclass
 from reflex.vars import Var
 
 class Select(ChakraComponent):
-    def get_event_triggers(self) -> Dict[str, Union[Var, Any]]: ...
     @overload
     @classmethod
     def create(  # type: ignore

reflex/components/chakra/forms/slider.py

@@ -1,11 +1,12 @@
 """A slider component."""
+
 from __future__ import annotations
 
-from typing import Any, Literal, Union
+from typing import Literal
 
 from reflex.components.chakra import ChakraComponent, LiteralChakraDirection
 from reflex.components.component import Component
-from reflex.constants import EventTriggers
+from reflex.event import EventHandler
 from reflex.vars import Var
 
 LiteralLayout = Literal["horizontal", "vertical"]
@@ -70,18 +71,14 @@ class Slider(ChakraComponent):
     # The name of the form field
     name: Var[str]
 
-    def get_event_triggers(self) -> dict[str, Union[Var, Any]]:
-        """Get the event triggers that pass the component's value to the handler.
+    # Fired when the value changes.
+    on_change: EventHandler[lambda e0: [e0]]
 
-        Returns:
-            A dict mapping the event trigger to the var that is passed to the handler.
-        """
-        return {
-            **super().get_event_triggers(),
-            EventTriggers.ON_CHANGE: lambda e0: [e0],
-            EventTriggers.ON_CHANGE_END: lambda e0: [e0],
-            EventTriggers.ON_CHANGE_START: lambda e0: [e0],
-        }  # type: ignore
+    # Fired when the value starts changing.
+    on_change_start: EventHandler[lambda e0: [e0]]
+
+    # Fired when the value stops changing.
+    on_change_end: EventHandler[lambda e0: [e0]]
 
     @classmethod
     def create(cls, *children, **props) -> Component:

reflex/components/chakra/forms/slider.pyi

@@ -7,16 +7,15 @@ from typing import Any, Dict, Literal, Optional, Union, overload
 from reflex.vars import Var, BaseVar, ComputedVar
 from reflex.event import EventChain, EventHandler, EventSpec
 from reflex.style import Style
-from typing import Any, Literal, Union
+from typing import Literal
 from reflex.components.chakra import ChakraComponent, LiteralChakraDirection
 from reflex.components.component import Component
-from reflex.constants import EventTriggers
+from reflex.event import EventHandler
 from reflex.vars import Var
 
 LiteralLayout = Literal["horizontal", "vertical"]
 
 class Slider(ChakraComponent):
-    def get_event_triggers(self) -> dict[str, Union[Var, Any]]: ...
     @overload
     @classmethod
     def create(  # type: ignore

reflex/components/chakra/forms/switch.py

@@ -1,10 +1,9 @@
 """A switch component."""
-from __future__ import annotations
 
-from typing import Any, Union
+from __future__ import annotations
 
 from reflex.components.chakra import ChakraComponent, LiteralColorScheme
-from reflex.constants import EventTriggers
+from reflex.event import EventHandler
 from reflex.vars import Var
 
 
@@ -46,13 +45,5 @@ class Switch(ChakraComponent):
     # The color scheme of the switch (e.g. "blue", "green", "red", etc.)
     color_scheme: Var[LiteralColorScheme]
 
-    def get_event_triggers(self) -> dict[str, Union[Var, Any]]:
-        """Get the event triggers that pass the component's value to the handler.
-
-        Returns:
-            A dict mapping the event trigger to the var that is passed to the handler.
-        """
-        return {
-            **super().get_event_triggers(),
-            EventTriggers.ON_CHANGE: lambda e0: [e0.target.checked],
-        }
+    # Fired when the switch value changes
+    on_change: EventHandler[lambda e0: [e0.target.checked]]

reflex/components/chakra/forms/switch.pyi

@@ -7,13 +7,11 @@ from typing import Any, Dict, Literal, Optional, Union, overload
 from reflex.vars import Var, BaseVar, ComputedVar
 from reflex.event import EventChain, EventHandler, EventSpec
 from reflex.style import Style
-from typing import Any, Union
 from reflex.components.chakra import ChakraComponent, LiteralColorScheme
-from reflex.constants import EventTriggers
+from reflex.event import EventHandler
 from reflex.vars import Var
 
 class Switch(ChakraComponent):
-    def get_event_triggers(self) -> dict[str, Union[Var, Any]]: ...
     @overload
     @classmethod
     def create(  # type: ignore

reflex/components/chakra/forms/textarea.py

@@ -1,12 +1,11 @@
 """A textarea component."""
-from __future__ import annotations
 
-from typing import Any, Union
+from __future__ import annotations
 
 from reflex.components.chakra import ChakraComponent, LiteralInputVariant
 from reflex.components.component import Component
 from reflex.components.core.debounce import DebounceInput
-from reflex.constants import EventTriggers
+from reflex.event import EventHandler
 from reflex.vars import Var
 
 
@@ -48,20 +47,20 @@ class TextArea(ChakraComponent):
     # The name of the form field
     name: Var[str]
 
-    def get_event_triggers(self) -> dict[str, Union[Var, Any]]:
-        """Get the event triggers that pass the component's value to the handler.
+    # Fired when the value changes.
+    on_change: EventHandler[lambda e0: [e0.target.value]]
 
-        Returns:
-            A dict mapping the event trigger to the var that is passed to the handler.
-        """
-        return {
-            **super().get_event_triggers(),
-            EventTriggers.ON_CHANGE: lambda e0: [e0.target.value],
-            EventTriggers.ON_FOCUS: lambda e0: [e0.target.value],
-            EventTriggers.ON_BLUR: lambda e0: [e0.target.value],
-            EventTriggers.ON_KEY_DOWN: lambda e0: [e0.key],
-            EventTriggers.ON_KEY_UP: lambda e0: [e0.key],
-        }
+    # Fired when the textarea gets focus.
+    on_focus: EventHandler[lambda e0: [e0.target.value]]
+
+    # Fired when the textarea loses focus.
+    on_blur: EventHandler[lambda e0: [e0.target.value]]
+
+    # Fired when a key is pressed down.
+    on_key_down: EventHandler[lambda e0: [e0.key]]
+
+    # Fired when a key is released.
+    on_key_up: EventHandler[lambda e0: [e0.key]]
 
     @classmethod
     def create(cls, *children, **props) -> Component:
@@ -74,7 +73,7 @@ class TextArea(ChakraComponent):
         Returns:
             The component.
         """
-        if props.get("value") is not None and props.get("on_change"):
+        if props.get("value") is not None and props.get("on_change") is not None:
             # create a debounced input if the user requests full control to avoid typing jank
             return DebounceInput.create(super().create(*children, **props))
         return super().create(*children, **props)

reflex/components/chakra/forms/textarea.pyi

@@ -7,15 +7,13 @@ from typing import Any, Dict, Literal, Optional, Union, overload
 from reflex.vars import Var, BaseVar, ComputedVar
 from reflex.event import EventChain, EventHandler, EventSpec
 from reflex.style import Style
-from typing import Any, Union
 from reflex.components.chakra import ChakraComponent, LiteralInputVariant
 from reflex.components.component import Component
 from reflex.components.core.debounce import DebounceInput
-from reflex.constants import EventTriggers
+from reflex.event import EventHandler
 from reflex.vars import Var
 
 class TextArea(ChakraComponent):
-    def get_event_triggers(self) -> dict[str, Union[Var, Any]]: ...
     @overload
     @classmethod
     def create(  # type: ignore

reflex/components/chakra/media/avatar.py

@@ -1,9 +1,9 @@
 """Avatar components."""
-from __future__ import annotations
 
-from typing import Any, Union
+from __future__ import annotations
 
 from reflex.components.chakra import ChakraComponent, LiteralAvatarSize
+from reflex.event import EventHandler
 from reflex.vars import Var
 
 
@@ -36,16 +36,8 @@ class Avatar(ChakraComponent):
     # "2xs" | "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "full"
     size: Var[LiteralAvatarSize]
 
-    def get_event_triggers(self) -> dict[str, Union[Var, Any]]:
-        """Get the event triggers for the component.
-
-        Returns:
-            The event triggers.
-        """
-        return {
-            **super().get_event_triggers(),
-            "on_error": lambda: [],
-        }
+    # Fired when the image fails to load.
+    on_error: EventHandler[lambda: []]
 
 
 class AvatarBadge(ChakraComponent):

reflex/components/chakra/media/avatar.pyi

@@ -7,12 +7,11 @@ from typing import Any, Dict, Literal, Optional, Union, overload
 from reflex.vars import Var, BaseVar, ComputedVar
 from reflex.event import EventChain, EventHandler, EventSpec
 from reflex.style import Style
-from typing import Any, Union
 from reflex.components.chakra import ChakraComponent, LiteralAvatarSize
+from reflex.event import EventHandler
 from reflex.vars import Var
 
 class Avatar(ChakraComponent):
-    def get_event_triggers(self) -> dict[str, Union[Var, Any]]: ...
     @overload
     @classmethod
     def create(  # type: ignore

reflex/components/chakra/media/icon.py

@@ -1,4 +1,5 @@
 """An icon component."""
+
 from typing import List
 
 from reflex.components.chakra import ChakraComponent