reflex-components-core 0.9.0a1__py3-none-any.whl

reflex_components_core/__init__.py

@@ -0,0 +1,20 @@
+"""Reflex base UI components package."""
+
+from __future__ import annotations
+
+from reflex_base.utils import lazy_loader
+
+_SUBMODULES: set[str] = {
+    "base",
+    "core",
+    "datadisplay",
+    "el",
+}
+
+_SUBMOD_ATTRS: dict[str, list[str]] = {}
+
+__getattr__, __dir__, __all__ = lazy_loader.attach(
+    __name__,
+    submodules=_SUBMODULES,
+    submod_attrs=_SUBMOD_ATTRS,
+)

reflex_components_core/__init__.pyi

@@ -0,0 +1,8 @@
+"""Stub file for reflex_components_core/__init__.py"""
+# ------------------- DO NOT EDIT ----------------------
+# This file was generated by `reflex/utils/pyi_generator.py`!
+# ------------------------------------------------------
+
+from . import base, core, datadisplay, el
+
+__all__ = ["base", "core", "datadisplay", "el"]

reflex_components_core/base/__init__.py

@@ -0,0 +1,29 @@
+"""Base components."""
+
+from __future__ import annotations
+
+from reflex_base.utils import lazy_loader
+
+_SUBMODULES: set[str] = {"app_wrap", "bare"}
+
+_SUBMOD_ATTRS: dict[str, list[str]] = {
+    "body": ["Body"],
+    "document": ["Scripts", "Outlet", "ScrollRestoration", "Links", "Meta"],
+    "fragment": [
+        "Fragment",
+        "fragment",
+    ],
+    "error_boundary": [
+        "ErrorBoundary",
+        "error_boundary",
+    ],
+    "link": ["RawLink", "ScriptTag"],
+    "meta": ["Description", "Image", "Meta", "Title"],
+    "script": ["Script", "script"],
+}
+
+__getattr__, __dir__, __all__ = lazy_loader.attach(
+    __name__,
+    submodules=_SUBMODULES,
+    submod_attrs=_SUBMOD_ATTRS,
+)

reflex_components_core/base/__init__.pyi

@@ -0,0 +1,35 @@
+"""Stub file for reflex_components_core/base/__init__.py"""
+# ------------------- DO NOT EDIT ----------------------
+# This file was generated by `reflex/utils/pyi_generator.py`!
+# ------------------------------------------------------
+
+from . import app_wrap, bare
+from .body import Body
+from .document import Links, Outlet, Scripts, ScrollRestoration
+from .error_boundary import ErrorBoundary, error_boundary
+from .fragment import Fragment, fragment
+from .link import RawLink, ScriptTag
+from .meta import Description, Image, Meta, Title
+from .script import Script, script
+
+__all__ = [
+    "Body",
+    "Description",
+    "ErrorBoundary",
+    "Fragment",
+    "Image",
+    "Links",
+    "Meta",
+    "Outlet",
+    "RawLink",
+    "Script",
+    "ScriptTag",
+    "Scripts",
+    "ScrollRestoration",
+    "Title",
+    "app_wrap",
+    "bare",
+    "error_boundary",
+    "fragment",
+    "script",
+]

reflex_components_core/base/app_wrap.py

@@ -0,0 +1,19 @@
+"""Top-level component that wraps the entire app."""
+
+from reflex_base.components.component import Component
+from reflex_base.vars.base import Var
+
+from reflex_components_core.base.fragment import Fragment
+
+
+class AppWrap(Fragment):
+    """Top-level component that wraps the entire app."""
+
+    @classmethod
+    def create(cls) -> Component:
+        """Create a new AppWrap component.
+
+        Returns:
+            A new AppWrap component containing {children}.
+        """
+        return super().create(Var(_js_expr="children"))

reflex_components_core/base/app_wrap.pyi

@@ -0,0 +1,52 @@
+"""Stub file for reflex_components_core/base/app_wrap.py"""
+
+# ------------------- DO NOT EDIT ----------------------
+# This file was generated by `reflex/utils/pyi_generator.py`!
+# ------------------------------------------------------
+from collections.abc import Mapping, Sequence
+from typing import Any
+
+from reflex_base.event import EventType, PointerEventInfo
+from reflex_base.vars.base import Var
+
+from reflex_components_core.base.fragment import Fragment
+from reflex_components_core.core.breakpoints import Breakpoints
+
+class AppWrap(Fragment):
+    @classmethod
+    def create(
+        cls,
+        *children,
+        style: Sequence[Mapping[str, Any]]
+        | Mapping[str, Any]
+        | Var[Mapping[str, Any]]
+        | Breakpoints
+        | None = None,
+        key: Any | None = None,
+        id: Any | None = None,
+        ref: Var | None = None,
+        class_name: Any | None = None,
+        custom_attrs: dict[str, Var | Any] | None = None,
+        on_blur: 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,
+        on_mouse_enter: EventType[()] | None = None,
+        on_mouse_leave: EventType[()] | None = None,
+        on_mouse_move: EventType[()] | None = None,
+        on_mouse_out: EventType[()] | None = None,
+        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,
+    ) -> AppWrap:
+        """Create a new AppWrap component.
+
+        Returns:
+        A new AppWrap component containing {children}.
+        """

reflex_components_core/base/bare.py

@@ -0,0 +1,247 @@
+"""A bare component."""
+
+from __future__ import annotations
+
+from collections.abc import Iterator, Sequence
+from typing import Any
+
+from reflex_base.components.component import BaseComponent, Component, ComponentStyle
+from reflex_base.components.tags import Tag
+from reflex_base.components.tags.tagless import Tagless
+from reflex_base.environment import PerformanceMode, environment
+from reflex_base.utils import console
+from reflex_base.utils.decorator import once
+from reflex_base.utils.imports import ParsedImportDict
+from reflex_base.vars import BooleanVar, ObjectVar, Var
+from reflex_base.vars.base import GLOBAL_CACHE, VarData
+from reflex_base.vars.sequence import LiteralStringVar
+
+
+@once
+def get_performance_mode():
+    """Get the performance mode.
+
+    Returns:
+        The performance mode.
+    """
+    return environment.REFLEX_PERF_MODE.get()
+
+
+def validate_str(value: str):
+    """Validate a string value.
+
+    Args:
+        value: The value to validate.
+
+    Raises:
+        ValueError: If the value is a Var and the performance mode is set to raise.
+    """
+    perf_mode = get_performance_mode()
+    if perf_mode != PerformanceMode.OFF and value.startswith("reflex___state"):
+        if perf_mode == PerformanceMode.WARN:
+            console.warn(
+                f"Output includes {value!s} which will be displayed as a string. If you are calling `str` on a Var, consider using .to_string() instead."
+            )
+        elif perf_mode == PerformanceMode.RAISE:
+            msg = f"Output includes {value!s} which will be displayed as a string. If you are calling `str` on a Var, consider using .to_string() instead."
+            raise ValueError(msg)
+
+
+def _components_from_var(var: Var) -> Sequence[BaseComponent]:
+    var_data = var._get_all_var_data()
+    return var_data.components if var_data else ()
+
+
+class Bare(Component):
+    """A component with no tag."""
+
+    contents: Var[Any]
+
+    @classmethod
+    def create(cls, contents: Any) -> Component:
+        """Create a Bare component, with no tag.
+
+        Args:
+            contents: The contents of the component.
+
+        Returns:
+            The component.
+        """
+        if isinstance(contents, Var):
+            if isinstance(contents, LiteralStringVar):
+                validate_str(contents._var_value)
+            return cls._unsafe_create(children=[], contents=contents)
+        if isinstance(contents, str):
+            validate_str(contents)
+        contents = Var.create(contents if contents is not None else "")
+
+        return cls._unsafe_create(children=[], contents=contents)
+
+    def _get_all_hooks_internal(self) -> dict[str, VarData | None]:
+        """Include the hooks for the component.
+
+        Returns:
+            The hooks for the component.
+        """
+        hooks = super()._get_all_hooks_internal()
+        if isinstance(self.contents, Var):
+            for component in _components_from_var(self.contents):
+                hooks |= component._get_all_hooks_internal()
+        return hooks
+
+    def _get_all_hooks(self) -> dict[str, VarData | None]:
+        """Include the hooks for the component.
+
+        Returns:
+            The hooks for the component.
+        """
+        hooks = super()._get_all_hooks()
+        if isinstance(self.contents, Var):
+            for component in _components_from_var(self.contents):
+                hooks |= component._get_all_hooks()
+        return hooks
+
+    def _get_all_imports(self, collapse: bool = False) -> ParsedImportDict:
+        """Include the imports for the component.
+
+        Args:
+            collapse: Whether to collapse the imports.
+
+        Returns:
+            The imports for the component.
+        """
+        imports = super()._get_all_imports(collapse=collapse)
+        if isinstance(self.contents, Var):
+            var_data = self.contents._get_all_var_data()
+            if var_data:
+                imports |= {k: list(v) for k, v in var_data.imports}
+        return imports
+
+    def _get_all_dynamic_imports(self) -> set[str]:
+        """Get dynamic imports for the component.
+
+        Returns:
+            The dynamic imports.
+        """
+        dynamic_imports = super()._get_all_dynamic_imports()
+        if isinstance(self.contents, Var):
+            for component in _components_from_var(self.contents):
+                dynamic_imports |= component._get_all_dynamic_imports()
+        return dynamic_imports
+
+    def _get_all_custom_code(self) -> dict[str, None]:
+        """Get custom code for the component.
+
+        Returns:
+            The custom code.
+        """
+        custom_code = super()._get_all_custom_code()
+        if isinstance(self.contents, Var):
+            for component in _components_from_var(self.contents):
+                custom_code |= component._get_all_custom_code()
+        return custom_code
+
+    def _get_all_app_wrap_components(
+        self, *, ignore_ids: set[int] | None = None
+    ) -> dict[tuple[int, str], Component]:
+        """Get the components that should be wrapped in the app.
+
+        Args:
+            ignore_ids: The ids to ignore when collecting components.
+
+        Returns:
+            The components that should be wrapped in the app.
+        """
+        ignore_ids = ignore_ids or set()
+        app_wrap_components = super()._get_all_app_wrap_components(
+            ignore_ids=ignore_ids
+        )
+        if isinstance(self.contents, Var):
+            for component in _components_from_var(self.contents):
+                component_id = id(component)
+                if isinstance(component, Component) and component_id not in ignore_ids:
+                    ignore_ids.add(component_id)
+                    app_wrap_components |= component._get_all_app_wrap_components(
+                        ignore_ids=ignore_ids
+                    )
+        return app_wrap_components
+
+    def _get_all_refs(self) -> dict[str, None]:
+        """Get the refs for the children of the component.
+
+        Returns:
+            The refs for the children.
+        """
+        refs = super()._get_all_refs()
+        if isinstance(self.contents, Var):
+            for component in _components_from_var(self.contents):
+                refs |= component._get_all_refs()
+        return refs
+
+    def _render(self) -> Tag:
+        contents = (
+            Var.create(self.contents)
+            if not isinstance(self.contents, Var)
+            else self.contents
+        )
+        if isinstance(contents, (BooleanVar, ObjectVar)):
+            return Tagless(contents=f"{contents.to_string()!s}")
+        return Tagless(contents=f"{contents!s}")
+
+    def render(self) -> dict:
+        """Render the component as a dictionary.
+
+        This is overridden to provide a short performant path for rendering.
+
+        Returns:
+            The rendered component.
+        """
+        contents = (
+            Var.create(self.contents)
+            if not isinstance(self.contents, Var)
+            else self.contents
+        )
+        if isinstance(contents, (BooleanVar, ObjectVar)):
+            return {"contents": f"{contents.to_string()!s}"}
+        return {"contents": f"{contents!s}"}
+
+    def _add_style_recursive(
+        self, style: ComponentStyle, theme: Component | None = None
+    ) -> Component:
+        """Add style to the component and its children.
+
+        Args:
+            style: The style to add.
+            theme: The theme to add.
+
+        Returns:
+            The component with the style added.
+        """
+        new_self = super()._add_style_recursive(style, theme)
+
+        are_components_touched = False
+
+        if isinstance(self.contents, Var):
+            for component in _components_from_var(self.contents):
+                if isinstance(component, Component):
+                    component._add_style_recursive(style, theme)
+                    are_components_touched = True
+
+        if are_components_touched:
+            GLOBAL_CACHE.clear()
+
+        return new_self
+
+    def _get_vars(
+        self, include_children: bool = False, ignore_ids: set[int] | None = None
+    ) -> Iterator[Var]:
+        """Walk all Vars used in this component.
+
+        Args:
+            include_children: Whether to include Vars from children.
+            ignore_ids: The ids to ignore.
+
+        Yields:
+            The contents if it is a Var, otherwise nothing.
+        """
+        yield self.contents

reflex_components_core/base/body.py

@@ -0,0 +1,7 @@
+"""Display the page body."""
+
+from reflex_components_core.el import elements
+
+
+class Body(elements.Body):
+    """A body component."""

reflex_components_core/base/body.pyi

@@ -0,0 +1,56 @@
+"""Stub file for reflex_components_core/base/body.py"""
+
+# ------------------- DO NOT EDIT ----------------------
+# This file was generated by `reflex/utils/pyi_generator.py`!
+# ------------------------------------------------------
+from collections.abc import Mapping, Sequence
+from typing import Any
+
+from reflex_base.event import EventType, PointerEventInfo
+from reflex_base.vars.base import Var
+
+from reflex_components_core.core.breakpoints import Breakpoints
+from reflex_components_core.el import elements
+
+class Body(elements.Body):
+    @classmethod
+    def create(
+        cls,
+        *children,
+        style: Sequence[Mapping[str, Any]]
+        | Mapping[str, Any]
+        | Var[Mapping[str, Any]]
+        | Breakpoints
+        | None = None,
+        key: Any | None = None,
+        id: Any | None = None,
+        ref: Var | None = None,
+        class_name: Any | None = None,
+        custom_attrs: dict[str, Var | Any] | None = None,
+        on_blur: 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,
+        on_mouse_enter: EventType[()] | None = None,
+        on_mouse_leave: EventType[()] | None = None,
+        on_mouse_move: EventType[()] | None = None,
+        on_mouse_out: EventType[()] | None = None,
+        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,
+    ) -> Body:
+        """Create the component.
+
+        Args:
+        *children: The children of the component.
+        **props: The props of the component.
+
+        Returns:
+        The component.
+        """

reflex_components_core/base/document.py

@@ -0,0 +1,39 @@
+"""Document components."""
+
+from reflex_base.components.component import Component
+
+
+class ReactRouterLib(Component):
+    """Root document components."""
+
+    library = "react-router"
+
+
+class Meta(ReactRouterLib):
+    """The document meta tags."""
+
+    tag = "Meta"
+
+
+class Links(ReactRouterLib):
+    """The document link tags."""
+
+    tag = "Links"
+
+
+class ScrollRestoration(ReactRouterLib):
+    """The document scroll restoration."""
+
+    tag = "ScrollRestoration"
+
+
+class Outlet(ReactRouterLib):
+    """The document outlet."""
+
+    tag = "Outlet"
+
+
+class Scripts(ReactRouterLib):
+    """The document main scripts."""
+
+    tag = "Scripts"