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

pythonnative/__init__.py

@@ -51,36 +51,55 @@ Example:
     ```
 """
 
-__version__ = "0.15.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 (
@@ -88,6 +107,7 @@ from .hooks import (
     batch_updates,
     component,
     create_context,
+    memo,
     use_callback,
     use_context,
     use_effect,
@@ -152,6 +172,7 @@ __all__ = [
     "Column",
     "ErrorBoundary",
     "FlatList",
+    "Fragment",
     "Image",
     "KeyboardAvoidingView",
     "Modal",
@@ -171,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",
@@ -178,6 +218,7 @@ __all__ = [
     "batch_updates",
     "component",
     "create_context",
+    "memo",
     "use_callback",
     "use_context",
     "use_effect",
@@ -225,6 +266,7 @@ __all__ = [
     # Animation
     "Animated",
     "AnimatedValue",
+    "use_animated_value",
     # Imperative
     "Alert",
     # Native modules

pythonnative/animated.py

@@ -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",
 ]