pythonnative 0.14.0__py3-none-any.whl → 0.16.0__py3-none-any.whl

pythonnative/__init__.py

@@ -23,8 +23,18 @@ Key building blocks:
   factories.
 - **Styling** uses a single ``style`` dict per element (or a list of
   dicts), composable via [`StyleSheet`][pythonnative.StyleSheet].
+  PythonNative ships a fully-typed [`Style`][pythonnative.style.Style]
+  TypedDict so editors and ``mypy`` validate every key as you type.
 - **Animations** use the ``Animated`` namespace, modeled on React
   Native's animation API.
+- **Custom native components** can be authored with the
+  ``pythonnative.sdk`` package: define a typed
+  [`Props`][pythonnative.sdk.Props] dataclass, implement a
+  [`ViewHandler`][pythonnative.native_views.base.ViewHandler] for each
+  platform, and register it via
+  [`@native_component`][pythonnative.sdk.native_component] (or expose
+  it from a PyPI package via the ``pythonnative.handlers`` entry-point
+  group).
 
 Example:
     ```python
@@ -34,42 +44,62 @@ Example:
     def App():
         count, set_count = pn.use_state(0)
         return pn.Column(
-            pn.Text(f"Count: {count}", style={"font_size": 24}),
+            pn.Text(f"Count: {count}", style=pn.style(font_size=24)),
             pn.Button("+", on_click=lambda: set_count(count + 1)),
-            style={"spacing": 12},
+            style=pn.style(spacing=12),
         )
     ```
 """
 
-__version__ = "0.14.0"
+__version__ = "0.16.0"
 
+from . import sdk
 from .alerts import Alert
-from .animated import Animated, AnimatedValue
+from .animated import Animated, AnimatedValue, use_animated_value
 from .components import (
     ActivityIndicator,
+    ActivityIndicatorProps,
     Button,
+    ButtonProps,
     Column,
     ErrorBoundary,
     FlatList,
+    Fragment,
     Image,
+    ImageProps,
     KeyboardAvoidingView,
+    KeyboardAvoidingViewProps,
     Modal,
+    ModalProps,
     Picker,
+    PickerProps,
     Pressable,
+    PressableProps,
     ProgressBar,
+    ProgressBarProps,
     RefreshControl,
     Row,
     SafeAreaView,
+    SafeAreaViewProps,
     ScrollView,
+    ScrollViewProps,
     SectionList,
     Slider,
+    SliderProps,
     Spacer,
+    SpacerProps,
     StatusBar,
+    StatusBarProps,
     Switch,
+    SwitchProps,
     Text,
     TextInput,
+    TextInputProps,
+    TextProps,
     View,
+    ViewProps,
     WebView,
+    WebViewProps,
 )
 from .element import Element
 from .hooks import (
@@ -77,6 +107,7 @@ from .hooks import (
     batch_updates,
     component,
     create_context,
+    memo,
     use_callback,
     use_context,
     use_effect,
@@ -100,7 +131,39 @@ from .navigation import (
 )
 from .platform import Platform
 from .screen import create_screen
-from .style import StyleSheet, ThemeContext
+from .sdk import (
+    Props,
+    ViewHandler,
+    element_factory,
+    native_component,
+    register_component,
+)
+from .style import (
+    AlignItems,
+    AlignSelf,
+    AutoCapitalize,
+    Color,
+    Dimension,
+    EdgeInsets,
+    FlexDirection,
+    FontWeight,
+    JustifyContent,
+    KeyboardType,
+    Overflow,
+    Position,
+    ReturnKeyType,
+    ScaleType,
+    ShadowOffset,
+    Style,
+    StyleProp,
+    StyleSheet,
+    TextAlign,
+    TextDecoration,
+    ThemeContext,
+    TransformSpec,
+    resolve_style,
+    style,
+)
 
 __all__ = [
     # Components
@@ -109,6 +172,7 @@ __all__ = [
     "Column",
     "ErrorBoundary",
     "FlatList",
+    "Fragment",
     "Image",
     "KeyboardAvoidingView",
     "Modal",
@@ -128,6 +192,25 @@ __all__ = [
     "TextInput",
     "View",
     "WebView",
+    # Built-in Props dataclasses
+    "ActivityIndicatorProps",
+    "ButtonProps",
+    "ImageProps",
+    "KeyboardAvoidingViewProps",
+    "ModalProps",
+    "PickerProps",
+    "PressableProps",
+    "ProgressBarProps",
+    "SafeAreaViewProps",
+    "ScrollViewProps",
+    "SliderProps",
+    "SpacerProps",
+    "StatusBarProps",
+    "SwitchProps",
+    "TextInputProps",
+    "TextProps",
+    "ViewProps",
+    "WebViewProps",
     # Core
     "Element",
     "create_screen",
@@ -135,6 +218,7 @@ __all__ = [
     "batch_updates",
     "component",
     "create_context",
+    "memo",
     "use_callback",
     "use_context",
     "use_effect",
@@ -154,12 +238,35 @@ __all__ = [
     "create_drawer_navigator",
     "create_stack_navigator",
     "create_tab_navigator",
-    # Styling
+    # Styling - typed primitives
+    "AlignItems",
+    "AlignSelf",
+    "AutoCapitalize",
+    "Color",
+    "Dimension",
+    "EdgeInsets",
+    "FlexDirection",
+    "FontWeight",
+    "JustifyContent",
+    "KeyboardType",
+    "Overflow",
+    "Position",
+    "ReturnKeyType",
+    "ScaleType",
+    "ShadowOffset",
+    "Style",
+    "StyleProp",
     "StyleSheet",
+    "TextAlign",
+    "TextDecoration",
     "ThemeContext",
+    "TransformSpec",
+    "resolve_style",
+    "style",
     # Animation
     "Animated",
     "AnimatedValue",
+    "use_animated_value",
     # Imperative
     "Alert",
     # Native modules
@@ -169,4 +276,11 @@ __all__ = [
     "Notifications",
     # Platform
     "Platform",
+    # Custom-component SDK
+    "Props",
+    "ViewHandler",
+    "element_factory",
+    "native_component",
+    "register_component",
+    "sdk",
 ]

pythonnative/animated.py

@@ -58,7 +58,7 @@ from typing import Any, Callable, Dict, List, Optional, Tuple
 
 from .element import Element
 from .hooks import use_effect, use_ref
-from .style import StyleValue, resolve_style
+from .style import StyleProp, resolve_style
 
 # Maximum frame rate at which the Python ticker drives animations.
 # We aim for 60 Hz but back off when no animation is active.
@@ -433,7 +433,7 @@ class _AnimationHandle:
 # ======================================================================
 
 
-def _resolve_style_with_values(style: StyleValue) -> Tuple[Dict[str, Any], Dict[str, AnimatedValue]]:
+def _resolve_style_with_values(style: StyleProp) -> Tuple[Dict[str, Any], Dict[str, AnimatedValue]]:
     """Return ``(plain_style, animated_bindings)``.
 
     AnimatedValue entries in the style are replaced with their
@@ -661,7 +661,45 @@ class _AnimatedNamespace:
 Animated = _AnimatedNamespace()
 
 
+def use_animated_value(initial: float = 0.0) -> AnimatedValue:
+    """Return an [`AnimatedValue`][pythonnative.AnimatedValue] with a stable identity across renders.
+
+    Convenience wrapper for the common pattern
+    ``pn.use_memo(lambda: AnimatedValue(initial), [])``. The same
+    instance is returned on every render of the same component, so
+    you can drive it from event handlers without recreating it.
+
+    Args:
+        initial: The starting numeric value.
+
+    Returns:
+        A mount-stable [`AnimatedValue`][pythonnative.AnimatedValue].
+
+    Example:
+        ```python
+        import pythonnative as pn
+
+        @pn.component
+        def FadeIn():
+            opacity = pn.use_animated_value(0.0)
+
+            def fade_in():
+                pn.Animated.timing(opacity, to=1.0, duration=300).start()
+
+            pn.use_effect(lambda: fade_in(), [])
+            return pn.Animated.View(
+                pn.Text("Hello"),
+                style=pn.style(opacity=opacity),
+            )
+        ```
+    """
+    from .hooks import use_memo
+
+    return use_memo(lambda: AnimatedValue(initial), [])
+
+
 __all__ = [
     "AnimatedValue",
     "Animated",
+    "use_animated_value",
 ]