reflex 0.7.14a6__py3-none-any.whl → 0.8.0a1__py3-none-any.whl

reflex/components/base/script.py

@@ -1,76 +1,78 @@
-"""Next.js script wrappers and inline script functionality.
-
-https://nextjs.org/docs/app/api-reference/components/script
-"""
+"""Wrapper for the script element. Uses the Helmet component to manage the head."""
 
 from __future__ import annotations
 
-from typing import Literal
-
-from reflex.components.component import Component
-from reflex.event import EventHandler, no_args_event_spec
-from reflex.vars.base import LiteralVar, Var
-
-
-class Script(Component):
-    """Next.js script component.
-
-    Note that this component differs from reflex.components.base.document.NextScript
-    in that it is intended for use with custom and user-defined scripts.
-
-    It also differs from reflex.components.base.link.ScriptTag, which is the plain
-    HTML <script> tag which does not work when rendering a component.
-    """
-
-    library = "next/script"
-    tag = "Script"
-    is_default = True
+from reflex.components import el as elements
+from reflex.components.core.helmet import helmet
+from reflex.utils import console
 
-    # Required unless inline script is used
-    src: Var[str]
 
-    # When the script will execute: afterInteractive (defer-like behavior) | beforeInteractive | lazyOnload (async-like behavior)
-    strategy: Var[Literal["afterInteractive", "beforeInteractive", "lazyOnload"]] = (
-        LiteralVar.create("afterInteractive")
-    )
-
-    # Triggered when the script is loading
-    on_load: EventHandler[no_args_event_spec]
-
-    # Triggered when the script has loaded
-    on_ready: EventHandler[no_args_event_spec]
-
-    # Triggered when the script has errored
-    on_error: EventHandler[no_args_event_spec]
+class Script(elements.Script):
+    """Wrapper for the script element."""
 
     @classmethod
-    def create(cls, *children, **props) -> Component:
-        """Create an inline or user-defined script.
-
-        If a string is provided as the first child, it will be rendered as an inline script
-        otherwise the `src` prop must be provided.
-
-        The following event triggers are provided:
-
-        on_load: Execute code after the script has finished loading.
-        on_ready: Execute code after the script has finished loading and every
-            time the component is mounted.
-        on_error: Execute code if the script fails to load.
+    def create(
+        cls,
+        *children,
+        **props,
+    ):
+        """Display the script element.
 
         Args:
-            *children: The children of the component.
-            **props: The props of the component.
+            *children: The children of the element.
+            **props: The properties of the element.
 
         Returns:
-            The component.
+            The script element.
 
         Raises:
-            ValueError: when neither children nor `src` are specified.
+            ValueError: If neither children nor src is specified.
         """
-        if not children and not props.get("src"):
-            msg = "Must provide inline script or `src` prop."
+        async_ = props.pop("async_", None)
+        char_set = props.pop("char_set", None)
+        cross_origin = props.pop("cross_origin", None)
+        defer = props.pop("defer", None)
+        integrity = props.pop("integrity", None)
+        referrer_policy = props.pop("referrer_policy", None)
+        src = props.pop("src", None)
+        type = props.pop("type", None)
+        key = props.pop("key", None)
+        id = props.pop("id", None)
+        class_name = props.pop("class_name", None)
+        autofocus = props.pop("autofocus", None)
+        custom_attrs = props.pop("custom_attrs", None)
+        on_mount = props.pop("on_mount", None)
+        on_unmount = props.pop("on_unmount", None)
+
+        if props:
+            console.warn(
+                f"rx.script does not support the following properties: {list(props.keys())}"
+            )
+
+        if not children and not src:
+            msg = "You must specify either children or src for the script element."
             raise ValueError(msg)
-        return super().create(*children, **props)
+
+        return helmet(
+            elements.Script.create(
+                *children,
+                async_=async_,
+                char_set=char_set,
+                cross_origin=cross_origin,
+                defer=defer,
+                integrity=integrity,
+                referrer_policy=referrer_policy,
+                src=src,
+                type=type,
+                key=key,
+                id=id,
+                class_name=class_name,
+                autofocus=autofocus,
+                custom_attrs=custom_attrs,
+                on_mount=on_mount,
+                on_unmount=on_unmount,
+            )
+        )
 
 
 script = Script.create

reflex/components/base/script.pyi

@@ -6,21 +6,229 @@
 from collections.abc import Mapping, Sequence
 from typing import Any, Literal, overload
 
-from reflex.components.component import Component
+from reflex.components import el as elements
 from reflex.components.core.breakpoints import Breakpoints
-from reflex.event import EventType
+from reflex.event import EventType, PointerEventInfo
 from reflex.vars.base import Var
 
-class Script(Component):
+class Script(elements.Script):
     @overload
     @classmethod
     def create(  # type: ignore
         cls,
         *children,
+        async_: Var[bool] | bool | None = None,
+        char_set: Var[str] | str | None = None,
+        cross_origin: Literal["", "anonymous", "use-credentials"]
+        | Var[Literal["", "anonymous", "use-credentials"]]
+        | None = None,
+        defer: Var[bool] | bool | None = None,
+        integrity: Var[str] | str | None = None,
+        referrer_policy: Literal[
+            "",
+            "no-referrer",
+            "no-referrer-when-downgrade",
+            "origin",
+            "origin-when-cross-origin",
+            "same-origin",
+            "strict-origin",
+            "strict-origin-when-cross-origin",
+            "unsafe-url",
+        ]
+        | Var[
+            Literal[
+                "",
+                "no-referrer",
+                "no-referrer-when-downgrade",
+                "origin",
+                "origin-when-cross-origin",
+                "same-origin",
+                "strict-origin",
+                "strict-origin-when-cross-origin",
+                "unsafe-url",
+            ]
+        ]
+        | None = None,
         src: Var[str] | str | None = None,
-        strategy: Literal["afterInteractive", "beforeInteractive", "lazyOnload"]
-        | Var[Literal["afterInteractive", "beforeInteractive", "lazyOnload"]]
+        type: Var[str] | str | None = None,
+        access_key: Var[str] | str | None = None,
+        auto_capitalize: Literal[
+            "characters", "none", "off", "on", "sentences", "words"
+        ]
+        | Var[Literal["characters", "none", "off", "on", "sentences", "words"]]
+        | None = None,
+        content_editable: Literal["inherit", "plaintext-only", False, True]
+        | Var[Literal["inherit", "plaintext-only", False, True]]
+        | None = None,
+        context_menu: Var[str] | str | None = None,
+        dir: Var[str] | str | None = None,
+        draggable: Var[bool] | bool | None = None,
+        enter_key_hint: Literal[
+            "done", "enter", "go", "next", "previous", "search", "send"
+        ]
+        | Var[Literal["done", "enter", "go", "next", "previous", "search", "send"]]
+        | None = None,
+        hidden: Var[bool] | bool | None = None,
+        input_mode: Literal[
+            "decimal", "email", "none", "numeric", "search", "tel", "text", "url"
+        ]
+        | Var[
+            Literal[
+                "decimal", "email", "none", "numeric", "search", "tel", "text", "url"
+            ]
+        ]
         | None = None,
+        item_prop: Var[str] | str | None = None,
+        lang: Var[str] | str | None = None,
+        role: Literal[
+            "alert",
+            "alertdialog",
+            "application",
+            "article",
+            "banner",
+            "button",
+            "cell",
+            "checkbox",
+            "columnheader",
+            "combobox",
+            "complementary",
+            "contentinfo",
+            "definition",
+            "dialog",
+            "directory",
+            "document",
+            "feed",
+            "figure",
+            "form",
+            "grid",
+            "gridcell",
+            "group",
+            "heading",
+            "img",
+            "link",
+            "list",
+            "listbox",
+            "listitem",
+            "log",
+            "main",
+            "marquee",
+            "math",
+            "menu",
+            "menubar",
+            "menuitem",
+            "menuitemcheckbox",
+            "menuitemradio",
+            "navigation",
+            "none",
+            "note",
+            "option",
+            "presentation",
+            "progressbar",
+            "radio",
+            "radiogroup",
+            "region",
+            "row",
+            "rowgroup",
+            "rowheader",
+            "scrollbar",
+            "search",
+            "searchbox",
+            "separator",
+            "slider",
+            "spinbutton",
+            "status",
+            "switch",
+            "tab",
+            "table",
+            "tablist",
+            "tabpanel",
+            "term",
+            "textbox",
+            "timer",
+            "toolbar",
+            "tooltip",
+            "tree",
+            "treegrid",
+            "treeitem",
+        ]
+        | Var[
+            Literal[
+                "alert",
+                "alertdialog",
+                "application",
+                "article",
+                "banner",
+                "button",
+                "cell",
+                "checkbox",
+                "columnheader",
+                "combobox",
+                "complementary",
+                "contentinfo",
+                "definition",
+                "dialog",
+                "directory",
+                "document",
+                "feed",
+                "figure",
+                "form",
+                "grid",
+                "gridcell",
+                "group",
+                "heading",
+                "img",
+                "link",
+                "list",
+                "listbox",
+                "listitem",
+                "log",
+                "main",
+                "marquee",
+                "math",
+                "menu",
+                "menubar",
+                "menuitem",
+                "menuitemcheckbox",
+                "menuitemradio",
+                "navigation",
+                "none",
+                "note",
+                "option",
+                "presentation",
+                "progressbar",
+                "radio",
+                "radiogroup",
+                "region",
+                "row",
+                "rowgroup",
+                "rowheader",
+                "scrollbar",
+                "search",
+                "searchbox",
+                "separator",
+                "slider",
+                "spinbutton",
+                "status",
+                "switch",
+                "tab",
+                "table",
+                "tablist",
+                "tabpanel",
+                "term",
+                "textbox",
+                "timer",
+                "toolbar",
+                "tooltip",
+                "tree",
+                "treegrid",
+                "treeitem",
+            ]
+        ]
+        | None = None,
+        slot: Var[str] | str | None = None,
+        spell_check: Var[bool] | bool | None = None,
+        tab_index: Var[int] | int | None = None,
+        title: Var[str] | str | None = None,
         style: Sequence[Mapping[str, Any]]
         | Mapping[str, Any]
         | Var[Mapping[str, Any]]
@@ -33,12 +241,10 @@ class Script(Component):
         autofocus: bool | None = None,
         custom_attrs: dict[str, Var | Any] | None = None,
         on_blur: EventType[()] | None = None,
-        on_click: EventType[()] | None = None,
-        on_context_menu: EventType[()] | None = None,
-        on_double_click: EventType[()] | None = None,
-        on_error: EventType[()] | None = None,
+        on_click: EventType[()] | EventType[PointerEventInfo] | None = None,
+        on_context_menu: EventType[()] | EventType[PointerEventInfo] | None = None,
+        on_double_click: EventType[()] | EventType[PointerEventInfo] | None = None,
         on_focus: EventType[()] | None = None,
-        on_load: EventType[()] | None = None,
         on_mount: EventType[()] | None = None,
         on_mouse_down: EventType[()] | None = None,
         on_mouse_enter: EventType[()] | None = None,
@@ -47,30 +253,39 @@ class Script(Component):
         on_mouse_out: EventType[()] | None = None,
         on_mouse_over: EventType[()] | None = None,
         on_mouse_up: EventType[()] | None = None,
-        on_ready: EventType[()] | None = None,
         on_scroll: EventType[()] | None = None,
+        on_scroll_end: EventType[()] | None = None,
         on_unmount: EventType[()] | None = None,
         **props,
     ) -> Script:
-        """Create an inline or user-defined script.
-
-        If a string is provided as the first child, it will be rendered as an inline script
-        otherwise the `src` prop must be provided.
-
-        The following event triggers are provided:
-
-        on_load: Execute code after the script has finished loading.
-        on_ready: Execute code after the script has finished loading and every
-            time the component is mounted.
-        on_error: Execute code if the script fails to load.
+        """Display the script element.
 
         Args:
-            *children: The children of the component.
-            src: Required unless inline script is used
-            strategy: When the script will execute: afterInteractive (defer-like behavior) | beforeInteractive | lazyOnload (async-like behavior)
-            on_load: Triggered when the script is loading
-            on_ready: Triggered when the script has loaded
-            on_error: Triggered when the script has errored
+            *children: The children of the element.
+            async_: Indicates that the script should be executed asynchronously
+            char_set: Character encoding of the external script
+            cross_origin: Configures the CORS requests for the script
+            defer: Indicates that the script should be executed after the page has finished parsing
+            integrity: Security feature allowing browsers to verify what they fetch
+            referrer_policy: Specifies which referrer information to send when fetching the script
+            src: URL of an external script
+            type: Specifies the MIME type of the script
+            access_key: Provides a hint for generating a keyboard shortcut for the current element.
+            auto_capitalize: Controls whether and how text input is automatically capitalized as it is entered/edited by the user.
+            content_editable: Indicates whether the element's content is editable.
+            context_menu: Defines the ID of a <menu> element which will serve as the element's context menu.
+            dir: Defines the text direction. Allowed values are ltr (Left-To-Right) or rtl (Right-To-Left)
+            draggable: Defines whether the element can be dragged.
+            enter_key_hint: Hints what media types the media element is able to play.
+            hidden: Defines whether the element is hidden.
+            input_mode: Defines the type of the element.
+            item_prop: Defines the name of the element for metadata purposes.
+            lang: Defines the language used in the element.
+            role: Defines the role of the element.
+            slot: Assigns a slot in a shadow DOM shadow tree to an element.
+            spell_check: Defines whether the element may be checked for spelling errors.
+            tab_index: Defines the position of the current element in the tabbing order.
+            title: Defines a tooltip for the element.
             style: The style of the component.
             key: A unique key for the component.
             id: The id for the component.
@@ -78,13 +293,13 @@ class Script(Component):
             class_name: The class name for the component.
             autofocus: Whether the component should take the focus once the page is loaded
             custom_attrs: custom attribute
-            **props: The props of the component.
+            **props: The properties of the element.
 
         Returns:
-            The component.
+            The script element.
 
         Raises:
-            ValueError: when neither children nor `src` are specified.
+            ValueError: If neither children nor src is specified.
         """
 
 script = Script.create

reflex/components/base/strict_mode.pyi

@@ -8,7 +8,7 @@ from typing import Any, overload
 
 from reflex.components.component import Component
 from reflex.components.core.breakpoints import Breakpoints
-from reflex.event import EventType
+from reflex.event import EventType, PointerEventInfo
 from reflex.vars.base import Var
 
 class StrictMode(Component):
@@ -29,9 +29,9 @@ class StrictMode(Component):
         autofocus: bool | None = None,
         custom_attrs: dict[str, Var | Any] | None = None,
         on_blur: EventType[()] | None = None,
-        on_click: EventType[()] | None = None,
-        on_context_menu: EventType[()] | None = None,
-        on_double_click: EventType[()] | None = None,
+        on_click: EventType[()] | EventType[PointerEventInfo] | None = None,
+        on_context_menu: EventType[()] | EventType[PointerEventInfo] | None = None,
+        on_double_click: EventType[()] | EventType[PointerEventInfo] | None = None,
         on_focus: EventType[()] | None = None,
         on_mount: EventType[()] | None = None,
         on_mouse_down: EventType[()] | None = None,
@@ -42,6 +42,7 @@ class StrictMode(Component):
         on_mouse_over: EventType[()] | None = None,
         on_mouse_up: EventType[()] | None = None,
         on_scroll: EventType[()] | None = None,
+        on_scroll_end: EventType[()] | None = None,
         on_unmount: EventType[()] | None = None,
         **props,
     ) -> StrictMode: