PyPI - refast - Versions diffs - 0.0.1__py3-none-any.whl - Mend

refast 0.0.1__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (114) hide show

refast/__init__.py +32 -0
refast/app.py +330 -0
refast/components/__init__.py +433 -0
refast/components/base.py +264 -0
refast/components/registry.py +139 -0
refast/components/shadcn/__init__.py +421 -0
refast/components/shadcn/button.py +151 -0
refast/components/shadcn/card.py +213 -0
refast/components/shadcn/charts/__init__.py +100 -0
refast/components/shadcn/charts/area.py +212 -0
refast/components/shadcn/charts/bar.py +221 -0
refast/components/shadcn/charts/base.py +279 -0
refast/components/shadcn/charts/composed.py +102 -0
refast/components/shadcn/charts/funnel.py +155 -0
refast/components/shadcn/charts/line.py +192 -0
refast/components/shadcn/charts/pie.py +230 -0
refast/components/shadcn/charts/radar.py +197 -0
refast/components/shadcn/charts/radial.py +123 -0
refast/components/shadcn/charts/sankey.py +125 -0
refast/components/shadcn/charts/scatter.py +251 -0
refast/components/shadcn/charts/treemap.py +113 -0
refast/components/shadcn/charts/utils.py +868 -0
refast/components/shadcn/controls.py +828 -0
refast/components/shadcn/data_display.py +700 -0
refast/components/shadcn/feedback.py +288 -0
refast/components/shadcn/form.py +129 -0
refast/components/shadcn/icon.py +311 -0
refast/components/shadcn/input.py +585 -0
refast/components/shadcn/layout.py +226 -0
refast/components/shadcn/navigation.py +2349 -0
refast/components/shadcn/overlay.py +1777 -0
refast/components/shadcn/typography.py +212 -0
refast/components/shadcn/utility.py +899 -0
refast/components/slot.py +57 -0
refast/context.py +1087 -0
refast/events/__init__.py +19 -0
refast/events/broadcast.py +247 -0
refast/events/manager.py +267 -0
refast/events/stream.py +322 -0
refast/events/types.py +140 -0
refast/extensions/__init__.py +9 -0
refast/extensions/base.py +184 -0
refast/router.py +421 -0
refast/security/__init__.py +76 -0
refast/security/csp.py +254 -0
refast/security/csrf.py +305 -0
refast/security/middleware.py +222 -0
refast/security/rate_limit.py +312 -0
refast/security/sanitizer.py +351 -0
refast/session/__init__.py +23 -0
refast/session/middleware.py +177 -0
refast/session/session.py +231 -0
refast/session/stores/__init__.py +13 -0
refast/session/stores/base.py +111 -0
refast/session/stores/memory.py +184 -0
refast/session/stores/redis.py +168 -0
refast/state.py +78 -0
refast/static/App.d.ts +22 -0
refast/static/__init__.py +1 -0
refast/static/components/ComponentRenderer.d.ts +13 -0
refast/static/components/ToastManager.d.ts +49 -0
refast/static/components/__tests__/components.test.d.ts +1 -0
refast/static/components/__tests__/registry.test.d.ts +1 -0
refast/static/components/base.d.ts +32 -0
refast/static/components/charts/area-chart.d.ts +2 -0
refast/static/components/charts/bar-chart.d.ts +2 -0
refast/static/components/charts/chart.d.ts +48 -0
refast/static/components/charts/composed-chart.d.ts +1 -0
refast/static/components/charts/funnel-chart.d.ts +4 -0
refast/static/components/charts/line-chart.d.ts +2 -0
refast/static/components/charts/pie-chart.d.ts +6 -0
refast/static/components/charts/radar-chart.d.ts +10 -0
refast/static/components/charts/radial-chart.d.ts +4 -0
refast/static/components/charts/sankey.d.ts +3 -0
refast/static/components/charts/scatter-chart.d.ts +5 -0
refast/static/components/charts/treemap.d.ts +3 -0
refast/static/components/charts/utils.d.ts +13 -0
refast/static/components/registry.d.ts +19 -0
refast/static/components/shadcn/ConnectionStatus.d.ts +36 -0
refast/static/components/shadcn/button.d.ts +35 -0
refast/static/components/shadcn/calendar.d.ts +7 -0
refast/static/components/shadcn/card.d.ts +63 -0
refast/static/components/shadcn/controls.d.ts +189 -0
refast/static/components/shadcn/data_display.d.ts +186 -0
refast/static/components/shadcn/feedback.d.ts +86 -0
refast/static/components/shadcn/icon.d.ts +25 -0
refast/static/components/shadcn/input.d.ts +190 -0
refast/static/components/shadcn/layout.d.ts +61 -0
refast/static/components/shadcn/navigation.d.ts +493 -0
refast/static/components/shadcn/overlay.d.ts +306 -0
refast/static/components/shadcn/slot.d.ts +14 -0
refast/static/components/shadcn/types.d.ts +24 -0
refast/static/components/shadcn/typography.d.ts +113 -0
refast/static/components/shadcn/utility.d.ts +127 -0
refast/static/events/EventManager.d.ts +32 -0
refast/static/events/WebSocketClient.d.ts +40 -0
refast/static/index.d.ts +61 -0
refast/static/state/PersistentStateManager.d.ts +78 -0
refast/static/state/PropStore.d.ts +67 -0
refast/static/state/StateManager.d.ts +22 -0
refast/static/state/__tests__/StateManager.test.d.ts +1 -0
refast/static/test/setup.d.ts +1 -0
refast/static/types.d.ts +180 -0
refast/static/utils/__tests__/index.test.d.ts +1 -0
refast/static/utils/index.d.ts +26 -0
refast/store.py +423 -0
refast/theme/__init__.py +27 -0
refast/theme/presets.py +252 -0
refast/theme/theme.py +191 -0
refast/utils/__init__.py +15 -0
refast/utils/case.py +244 -0
refast-0.0.1.dist-info/METADATA +79 -0
refast-0.0.1.dist-info/RECORD +114 -0
refast-0.0.1.dist-info/WHEEL +4 -0

refast/__init__.py ADDED Viewed

@@ -0,0 +1,32 @@
+"""
+Refast - Python + React UI Framework
+A framework for building reactive web applications with Python-first development.
+"""
+from refast.app import RefastApp
+from refast.context import BoundJsCallback, Callback, Context, JsAction, JsCallback
+from refast.extensions import Extension
+from refast.state import State
+from refast.store import BrowserStore, JSONEncoder, LocalStore, SessionStore, Store
+from refast.theme import Theme, ThemeColors, ThemeMode
+__version__ = "0.1.0"
+__all__ = [
+    "RefastApp",
+    "Context",
+    "Callback",
+    "JsCallback",
+    "JsAction",
+    "BoundJsCallback",
+    "State",
+    "Store",
+    "LocalStore",
+    "SessionStore",
+    "BrowserStore",
+    "JSONEncoder",
+    "Extension",
+    "Theme",
+    "ThemeColors",
+    "ThemeMode",
+]

refast/app.py ADDED Viewed

@@ -0,0 +1,330 @@
+"""Main RefastApp class."""
+import logging
+from collections.abc import Callable
+from typing import TYPE_CHECKING, Any, TypeVar
+from fastapi import APIRouter
+from refast.router import RefastRouter
+from refast.theme.theme import Theme
+if TYPE_CHECKING:
+    from refast.context import Context
+    from refast.extensions import Extension
+PageFunc = TypeVar("PageFunc", bound=Callable[..., Any])
+logger = logging.getLogger(__name__)
+class RefastApp:
+    """
+    Main Refast application class.
+    Example:
+        ```python
+        from refast import RefastApp
+        from refast.theme import rose_theme
+        ui = RefastApp(
+            title="My App",
+            theme=rose_theme,
+            favicon="/static/favicon.ico",
+            custom_css=["https://fonts.googleapis.com/css2?family=Inter&display=swap"],
+            custom_js=["console.log('loaded');"],
+            head_tags=['<meta name="description" content="My Refast App">'],
+        )
+        @ui.page("/")
+        def home(ctx: Context):
+            return Container(Text("Hello World"))
+        # Mount to FastAPI
+        app.include_router(ui.router, prefix="/ui")
+        ```
+    Args:
+        title: Application title
+        theme: Theme configuration — a ``Theme`` instance, or ``None`` for defaults
+        secret_key: Secret key for session encryption
+        debug: Enable debug mode
+        favicon: URL to a favicon (e.g. ``"/static/favicon.ico"``)
+        custom_css: Additional CSS — inline snippets or URLs. URLs (starting
+            with ``http`` or ``/``) are injected as ``<link>`` tags; anything
+            else is wrapped in an inline ``<style>`` block.
+        custom_js: Additional JavaScript — inline snippets or URLs. URLs are
+            injected as ``<script src>`` tags; anything else is wrapped in
+            an inline ``<script>`` block. Placed at the end of ``<body>``.
+        head_tags: Raw HTML strings injected verbatim into ``<head>``
+            (e.g. ``<meta>``, ``<link>``, ``<style>``).
+        extensions: List of Extension instances to register
+        auto_discover_extensions: Whether to auto-discover extensions via entry points
+    """
+    def __init__(
+        self,
+        title: str = "Refast App",
+        theme: Theme | None = None,
+        secret_key: str | None = None,
+        debug: bool = False,
+        favicon: str | None = None,
+        custom_css: str | list[str] | None = None,
+        custom_js: str | list[str] | None = None,
+        head_tags: list[str] | None = None,
+        extensions: list["Extension"] | None = None,
+        auto_discover_extensions: bool = True,
+    ):
+        self.title = title
+        self.theme = theme
+        self.secret_key = secret_key
+        self.debug = debug
+        self.favicon = favicon
+        # Normalise custom_css / custom_js to lists
+        if custom_css is None:
+            self._custom_css: list[str] = []
+        elif isinstance(custom_css, str):
+            self._custom_css = [custom_css]
+        else:
+            self._custom_css = list(custom_css)
+        if custom_js is None:
+            self._custom_js: list[str] = []
+        elif isinstance(custom_js, str):
+            self._custom_js = [custom_js]
+        else:
+            self._custom_js = list(custom_js)
+        self._head_tags: list[str] = list(head_tags) if head_tags else []
+        self._pages: dict[str, Callable] = {}
+        self._callbacks: dict[str, Callable] = {}
+        self._event_handlers: dict[str, Callable] = {}
+        self._router: RefastRouter | None = None
+        self._extensions: dict[str, Extension] = {}
+        # Auto-discover extensions via entry points
+        if auto_discover_extensions:
+            self._discover_extensions()
+        # Register manually provided extensions
+        if extensions:
+            for ext in extensions:
+                self.register_extension(ext)
+    @property
+    def router(self) -> APIRouter:
+        """Get the FastAPI router for mounting."""
+        if self._router is None:
+            self._router = RefastRouter(self)
+        return self._router.api_router
+    @property
+    def active_contexts(self) -> list["Context"]:
+        """Get all active WebSocket contexts."""
+        if self._router is None:
+            return []
+        return self._router.active_contexts
+    @property
+    def pages(self) -> dict[str, Callable]:
+        """Get registered pages."""
+        return self._pages.copy()
+    def page(self, path: str) -> Callable[[PageFunc], PageFunc]:
+        """
+        Decorator to register a page.
+        Args:
+            path: URL path for the page
+        Returns:
+            Decorator function
+        Example:
+            ```python
+            @ui.page("/dashboard")
+            def dashboard(ctx: Context):
+                return Container(...)
+            ```
+        """
+        def decorator(func: PageFunc) -> PageFunc:
+            self._pages[path] = func
+            return func
+        return decorator
+    def on_event(self, event_type: str) -> Callable[[Callable], Callable]:
+        """
+        Decorator to register an event handler.
+        Args:
+            event_type: The event type to handle (e.g., "user:click")
+        Returns:
+            Decorator function
+        """
+        def decorator(func: Callable) -> Callable:
+            self._event_handlers[event_type] = func
+            return func
+        return decorator
+    def register_callback(self, callback_id: str, func: Callable) -> None:
+        """Register a callback function."""
+        self._callbacks[callback_id] = func
+    def get_callback(self, callback_id: str) -> Callable | None:
+        """Get a registered callback by ID."""
+        return self._callbacks.get(callback_id)
+    # Extension methods
+    @property
+    def extensions(self) -> dict[str, "Extension"]:
+        """Get registered extensions."""
+        return self._extensions.copy()
+    def register_extension(self, extension: "Extension") -> None:
+        """
+        Register an extension with this app.
+        Args:
+            extension: The Extension instance to register.
+        Raises:
+            ValueError: If an extension with the same name is already registered.
+        Example:
+            ```python
+            from refast_leaflet import LeafletExtension
+            ui = RefastApp()
+            ui.register_extension(LeafletExtension())
+            ```
+        """
+        from refast.extensions import Extension
+        if not isinstance(extension, Extension):
+            raise TypeError(f"Expected Extension instance, got {type(extension).__name__}")
+        if extension.name in self._extensions:
+            raise ValueError(f"Extension '{extension.name}' is already registered")
+        # Validate extension configuration
+        errors = extension.validate()
+        if errors and self.debug:
+            for error in errors:
+                logger.warning(f"Extension validation warning: {error}")
+        # Register the extension
+        self._extensions[extension.name] = extension
+        # Call the extension's on_register hook
+        extension.on_register(self)
+        logger.debug(f"Registered extension: {extension.name} v{extension.version}")
+    def _discover_extensions(self) -> None:
+        """
+        Discover and register extensions via Python entry points.
+        Extensions can register themselves using the 'refast.extensions'
+        entry point group in their pyproject.toml:
+            [project.entry-points."refast.extensions"]
+            my_extension = "my_package:MyExtension"
+        """
+        try:
+            from importlib.metadata import entry_points
+        except ImportError:
+            # Python < 3.10 fallback
+            from importlib_metadata import entry_points  # type: ignore
+        try:
+            # Python 3.10+ style
+            eps = entry_points(group="refast.extensions")
+        except TypeError:
+            # Python 3.9 style
+            all_eps = entry_points()
+            eps = all_eps.get("refast.extensions", [])
+        for ep in eps:
+            try:
+                extension_class = ep.load()
+                extension = extension_class()
+                self.register_extension(extension)
+                logger.debug(f"Auto-discovered extension: {ep.name}")
+            except Exception as e:
+                logger.warning(f"Failed to load extension '{ep.name}': {e}")
+    def get_extension(self, name: str) -> "Extension | None":
+        """
+        Get a registered extension by name.
+        Args:
+            name: The extension name.
+        Returns:
+            The Extension instance, or None if not found.
+        """
+        return self._extensions.get(name)
+    # ------------------------------------------------------------------
+    # Theming & customisation helpers
+    # ------------------------------------------------------------------
+    def add_css(self, css: str) -> None:
+        """
+        Add a CSS snippet or URL after construction.
+        URLs (starting with ``http`` or ``/``) become ``<link>`` tags;
+        everything else is wrapped in an inline ``<style>`` block.
+        Args:
+            css: A CSS URL or inline CSS string.
+        Example:
+            ```python
+            ui.add_css("https://fonts.googleapis.com/css2?family=Inter")
+            ui.add_css("body { font-family: Inter, sans-serif; }")
+            ```
+        """
+        self._custom_css.append(css)
+    def add_js(self, js: str) -> None:
+        """
+        Add a JavaScript snippet or URL after construction.
+        URLs (starting with ``http`` or ``/``) become ``<script src>`` tags;
+        everything else is wrapped in an inline ``<script>`` block.
+        Scripts are placed at the end of ``<body>``.
+        Args:
+            js: A JS URL or inline script string.
+        Example:
+            ```python
+            ui.add_js("https://cdn.example.com/lib.js")
+            ui.add_js("console.log('app ready');")
+            ```
+        """
+        self._custom_js.append(js)
+    def add_head_tag(self, html: str) -> None:
+        """
+        Add a raw HTML string to ``<head>``.
+        Args:
+            html: A raw HTML tag (``<meta>``, ``<link>``, etc.).
+        Example:
+            ```python
+            ui.add_head_tag('<meta name="description" content="My app">')
+            ui.add_head_tag('<link rel="preconnect" href="https://fonts.gstatic.com">')
+            ```
+        """
+        self._head_tags.append(html)