reflex 0.5.5a1__py3-none-any.whl → 0.5.6__py3-none-any.whl

reflex/components/core/banner.pyi

@@ -1,31 +1,19 @@
 """Stub file for reflex/components/core/banner.py"""
+
 # ------------------- DO NOT EDIT ----------------------
 # This file was generated by `reflex/utils/pyi_generator.py`!
 # ------------------------------------------------------
+from typing import Any, Callable, Dict, Literal, Optional, Union, overload
 
-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 Optional
 from reflex.components.base.bare import Bare
 from reflex.components.component import Component
-from reflex.components.core.cond import cond
 from reflex.components.el.elements.typography import Div
 from reflex.components.lucide.icon import Icon
-from reflex.components.radix.themes.components.dialog import (
-    DialogContent,
-    DialogRoot,
-    DialogTitle,
-)
-from reflex.components.radix.themes.layout.flex import Flex
-from reflex.components.radix.themes.typography.text import Text
 from reflex.components.sonner.toast import Toaster, ToastProps
-from reflex.constants import Dirs, Hooks, Imports
-from reflex.constants.compiler import CompileVars
+from reflex.event import EventHandler, EventSpec
+from reflex.style import Style
 from reflex.utils.imports import ImportDict, ImportVar
-from reflex.utils.serializers import serialize
-from reflex.vars import Var, VarData
+from reflex.vars import BaseVar, Var, VarData
 
 connect_error_var_data: VarData
 connect_errors: Var
@@ -49,51 +37,51 @@ class WebsocketTargetURL(Bare):
         autofocus: Optional[bool] = None,
         custom_attrs: Optional[Dict[str, Union[Var, str]]] = None,
         on_blur: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_click: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_context_menu: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_double_click: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_focus: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mount: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_down: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_enter: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_leave: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_move: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_out: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_over: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_up: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_scroll: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_unmount: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
-        **props
+        **props,
     ) -> "WebsocketTargetURL":
         """Create a websocket target URL component.
 
@@ -153,51 +141,51 @@ class ConnectionToaster(Toaster):
         autofocus: Optional[bool] = None,
         custom_attrs: Optional[Dict[str, Union[Var, str]]] = None,
         on_blur: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_click: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_context_menu: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_double_click: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_focus: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mount: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_down: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_enter: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_leave: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_move: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_out: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_over: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_up: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_scroll: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_unmount: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
-        **props
+        **props,
     ) -> "ConnectionToaster":
         """Create the component.
 
@@ -243,51 +231,51 @@ class ConnectionBanner(Component):
         autofocus: Optional[bool] = None,
         custom_attrs: Optional[Dict[str, Union[Var, str]]] = None,
         on_blur: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_click: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_context_menu: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_double_click: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_focus: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mount: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_down: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_enter: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_leave: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_move: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_out: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_over: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_up: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_scroll: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_unmount: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
-        **props
+        **props,
     ) -> "ConnectionBanner":
         """Create a connection banner component.
 
@@ -312,51 +300,51 @@ class ConnectionModal(Component):
         autofocus: Optional[bool] = None,
         custom_attrs: Optional[Dict[str, Union[Var, str]]] = None,
         on_blur: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_click: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_context_menu: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_double_click: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_focus: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mount: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_down: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_enter: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_leave: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_move: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_out: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_over: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_up: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_scroll: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_unmount: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
-        **props
+        **props,
     ) -> "ConnectionModal":
         """Create a connection banner component.
 
@@ -382,51 +370,51 @@ class WifiOffPulse(Icon):
         autofocus: Optional[bool] = None,
         custom_attrs: Optional[Dict[str, Union[Var, str]]] = None,
         on_blur: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_click: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_context_menu: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_double_click: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_focus: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mount: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_down: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_enter: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_leave: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_move: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_out: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_over: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_up: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_scroll: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_unmount: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
-        **props
+        **props,
     ) -> "WifiOffPulse":
         """Create a wifi_off icon with an animated opacity pulse.
 
@@ -454,46 +442,30 @@ class ConnectionPulser(Div):
     def create(  # type: ignore
         cls,
         *children,
-        access_key: Optional[
-            Union[Var[Union[str, int, bool]], Union[str, int, bool]]
-        ] = None,
+        access_key: Optional[Union[Var[Union[bool, int, str]], str, int, bool]] = None,
         auto_capitalize: Optional[
-            Union[Var[Union[str, int, bool]], Union[str, int, bool]]
+            Union[Var[Union[bool, int, str]], str, int, bool]
         ] = None,
         content_editable: Optional[
-            Union[Var[Union[str, int, bool]], Union[str, int, bool]]
+            Union[Var[Union[bool, int, str]], str, int, bool]
         ] = None,
         context_menu: Optional[
-            Union[Var[Union[str, int, bool]], Union[str, int, bool]]
-        ] = None,
-        dir: Optional[Union[Var[Union[str, int, bool]], Union[str, int, bool]]] = None,
-        draggable: Optional[
-            Union[Var[Union[str, int, bool]], Union[str, int, bool]]
+            Union[Var[Union[bool, int, str]], str, int, bool]
         ] = None,
+        dir: Optional[Union[Var[Union[bool, int, str]], str, int, bool]] = None,
+        draggable: Optional[Union[Var[Union[bool, int, str]], str, int, bool]] = None,
         enter_key_hint: Optional[
-            Union[Var[Union[str, int, bool]], Union[str, int, bool]]
-        ] = None,
-        hidden: Optional[
-            Union[Var[Union[str, int, bool]], Union[str, int, bool]]
-        ] = None,
-        input_mode: Optional[
-            Union[Var[Union[str, int, bool]], Union[str, int, bool]]
-        ] = None,
-        item_prop: Optional[
-            Union[Var[Union[str, int, bool]], Union[str, int, bool]]
-        ] = None,
-        lang: Optional[Union[Var[Union[str, int, bool]], Union[str, int, bool]]] = None,
-        role: Optional[Union[Var[Union[str, int, bool]], Union[str, int, bool]]] = None,
-        slot: Optional[Union[Var[Union[str, int, bool]], Union[str, int, bool]]] = None,
-        spell_check: Optional[
-            Union[Var[Union[str, int, bool]], Union[str, int, bool]]
-        ] = None,
-        tab_index: Optional[
-            Union[Var[Union[str, int, bool]], Union[str, int, bool]]
-        ] = None,
-        title: Optional[
-            Union[Var[Union[str, int, bool]], Union[str, int, bool]]
-        ] = None,
+            Union[Var[Union[bool, int, str]], str, int, bool]
+        ] = None,
+        hidden: Optional[Union[Var[Union[bool, int, str]], str, int, bool]] = None,
+        input_mode: Optional[Union[Var[Union[bool, int, str]], str, int, bool]] = None,
+        item_prop: Optional[Union[Var[Union[bool, int, str]], str, int, bool]] = None,
+        lang: Optional[Union[Var[Union[bool, int, str]], str, int, bool]] = None,
+        role: Optional[Union[Var[Union[bool, int, str]], str, int, bool]] = None,
+        slot: Optional[Union[Var[Union[bool, int, str]], str, int, bool]] = None,
+        spell_check: Optional[Union[Var[Union[bool, int, str]], str, int, bool]] = None,
+        tab_index: Optional[Union[Var[Union[bool, int, str]], str, int, bool]] = None,
+        title: Optional[Union[Var[Union[bool, int, str]], str, int, bool]] = None,
         style: Optional[Style] = None,
         key: Optional[Any] = None,
         id: Optional[Any] = None,
@@ -501,51 +473,51 @@ class ConnectionPulser(Div):
         autofocus: Optional[bool] = None,
         custom_attrs: Optional[Dict[str, Union[Var, str]]] = None,
         on_blur: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_click: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_context_menu: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_double_click: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_focus: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mount: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_down: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_enter: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_leave: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_move: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_out: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_over: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_mouse_up: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_scroll: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
         on_unmount: Optional[
-            Union[EventHandler, EventSpec, list, function, BaseVar]
+            Union[EventHandler, EventSpec, list, Callable, BaseVar]
         ] = None,
-        **props
+        **props,
     ) -> "ConnectionPulser":
         """Create a connection pulser component.
 

reflex/components/core/breakpoints.py

@@ -0,0 +1,95 @@
+"""Breakpoints utility."""
+
+from __future__ import annotations
+
+from typing import Dict, Tuple, TypeVar, Union
+
+breakpoints_values = ["30em", "48em", "62em", "80em", "96em"]
+breakpoint_names = ["xs", "sm", "md", "lg", "xl"]
+
+
+def set_breakpoints(values: Tuple[str, str, str, str, str]):
+    """Overwrite default breakpoint values.
+
+    Args:
+        values: CSS values in order defining the breakpoints of responsive layouts
+    """
+    breakpoints_values.clear()
+    breakpoints_values.extend(values)
+
+
+K = TypeVar("K")
+V = TypeVar("V")
+
+
+class Breakpoints(Dict[K, V]):
+    """A responsive styling helper."""
+
+    def factorize(self):
+        """Removes references to breakpoints names and instead replaces them with their corresponding values.
+
+        Returns:
+            The factorized breakpoints.
+        """
+        return Breakpoints(
+            {
+                (
+                    breakpoints_values[breakpoint_names.index(k)]
+                    if k in breakpoint_names
+                    else ("0px" if k == "initial" else k)
+                ): v
+                for k, v in self.items()
+                if v is not None
+            }
+        )
+
+    @classmethod
+    def create(
+        cls,
+        custom: Dict[K, V] | None = None,
+        initial: V | None = None,
+        xs: V | None = None,
+        sm: V | None = None,
+        md: V | None = None,
+        lg: V | None = None,
+        xl: V | None = None,
+    ):
+        """Create a new instance of the helper. Only provide a custom component OR use named props.
+
+        Args:
+            custom: Custom mapping using CSS values or variables.
+            initial: Styling when in the inital width
+            xs: Styling when in the extra-small width
+            sm: Styling when in the small width
+            md: Styling when in the medium width
+            lg: Styling when in the large width
+            xl: Styling when in the extra-large width
+
+        Raises:
+            ValueError: If both custom and any other named parameters are provided.
+
+        Returns:
+            The responsive mapping.
+        """
+        thresholds = [initial, xs, sm, md, lg, xl]
+
+        if custom is not None:
+            if any((threshold is not None for threshold in thresholds)):
+                raise ValueError("Named props cannot be used with custom thresholds")
+
+            return Breakpoints(custom)
+        else:
+            return Breakpoints(
+                {
+                    k: v
+                    for k, v in zip(["initial", *breakpoint_names], thresholds)
+                    if v is not None
+                }
+            )
+
+
+breakpoints = Breakpoints.create
+
+T = TypeVar("T")
+
+Responsive = Union[T, Breakpoints[str, T]]