pythonnative 0.14.0__tar.gz → 0.16.0__tar.gz

{pythonnative-0.14.0/src/pythonnative.egg-info → pythonnative-0.16.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pythonnative
-Version: 0.14.0
+Version: 0.16.0
 Summary: Cross-platform native UI toolkit for Android and iOS
 Author: Owen Carey
 License: MIT License
@@ -96,10 +96,11 @@ PythonNative is a cross-platform toolkit for building native Android and iOS app
 
 - **Declarative UI:** Describe *what* your UI should look like with element functions (`Text`, `Button`, `Column`, `Row`, etc.). PythonNative creates and updates native views automatically.
 - **Hooks and function components:** Manage state with `use_state`, side effects with `use_effect`, and navigation with `use_navigation`, all through one consistent pattern.
-- **`style` prop:** Pass all visual and layout properties through a single `style` dict, composable via `StyleSheet`.
+- **Typed `style` prop:** Pass all visual and layout properties through a single `style` dict, fully described by the `pn.Style` `TypedDict` and the ergonomic `pn.style(...)` helper for IDE autocomplete and static checking. Compose reusable styles with `StyleSheet`.
 - **Cross-platform flexbox engine:** A pure-Python, Yoga-style layout engine computes frames once and applies them to native views, so `flex`, `padding`, `aspect_ratio`, and `position: "absolute"` produce the same geometry on Android and iOS.
 - **Virtual view tree + reconciler:** Element trees are diffed and patched with minimal native mutations, similar to React's reconciliation.
 - **Direct native bindings:** Python calls platform APIs directly through Chaquopy and rubicon-objc, with no JavaScript bridge.
+- **Custom-component SDK:** Wrap any platform widget as a first-class element with type-checked props via `pythonnative.sdk` (`Props`, `@native_component`, `element_factory`). Plugins distributed on PyPI auto-register through the `pythonnative.handlers` entry-point group.
 - **CLI scaffolding:** `pn init` creates a ready-to-run project; `pn run android` and `pn run ios` build and launch your app.
 - **Native-backed navigation:** Declarative `Stack`, `Tab`, and `Drawer` navigators inspired by React Navigation. The root stack drives the platform's native navigation controller (`UINavigationController` on iOS, AndroidX Navigation Component on Android), so transitions, back gestures, and the hardware back button match what users expect.
 - **Fast Refresh hot reload:** `pn run --hot-reload` watches `app/` and patches edits into the running app on save, preserving component state across most changes.
@@ -123,12 +124,12 @@ import pythonnative as pn
 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, bold=True)),
         pn.Button(
             "Tap me",
             on_click=lambda: set_count(count + 1),
         ),
-        style={"spacing": 12, "padding": 16},
+        style=pn.style(spacing=12, padding=16),
     )
 ```
 

{pythonnative-0.14.0 → pythonnative-0.16.0}/README.md

@@ -32,10 +32,11 @@ PythonNative is a cross-platform toolkit for building native Android and iOS app
 
 - **Declarative UI:** Describe *what* your UI should look like with element functions (`Text`, `Button`, `Column`, `Row`, etc.). PythonNative creates and updates native views automatically.
 - **Hooks and function components:** Manage state with `use_state`, side effects with `use_effect`, and navigation with `use_navigation`, all through one consistent pattern.
-- **`style` prop:** Pass all visual and layout properties through a single `style` dict, composable via `StyleSheet`.
+- **Typed `style` prop:** Pass all visual and layout properties through a single `style` dict, fully described by the `pn.Style` `TypedDict` and the ergonomic `pn.style(...)` helper for IDE autocomplete and static checking. Compose reusable styles with `StyleSheet`.
 - **Cross-platform flexbox engine:** A pure-Python, Yoga-style layout engine computes frames once and applies them to native views, so `flex`, `padding`, `aspect_ratio`, and `position: "absolute"` produce the same geometry on Android and iOS.
 - **Virtual view tree + reconciler:** Element trees are diffed and patched with minimal native mutations, similar to React's reconciliation.
 - **Direct native bindings:** Python calls platform APIs directly through Chaquopy and rubicon-objc, with no JavaScript bridge.
+- **Custom-component SDK:** Wrap any platform widget as a first-class element with type-checked props via `pythonnative.sdk` (`Props`, `@native_component`, `element_factory`). Plugins distributed on PyPI auto-register through the `pythonnative.handlers` entry-point group.
 - **CLI scaffolding:** `pn init` creates a ready-to-run project; `pn run android` and `pn run ios` build and launch your app.
 - **Native-backed navigation:** Declarative `Stack`, `Tab`, and `Drawer` navigators inspired by React Navigation. The root stack drives the platform's native navigation controller (`UINavigationController` on iOS, AndroidX Navigation Component on Android), so transitions, back gestures, and the hardware back button match what users expect.
 - **Fast Refresh hot reload:** `pn run --hot-reload` watches `app/` and patches edits into the running app on save, preserving component state across most changes.
@@ -59,12 +60,12 @@ import pythonnative as pn
 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, bold=True)),
         pn.Button(
             "Tap me",
             on_click=lambda: set_count(count + 1),
         ),
-        style={"spacing": 12, "padding": 16},
+        style=pn.style(spacing=12, padding=16),
     )
 ```
 

{pythonnative-0.14.0 → pythonnative-0.16.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pythonnative"
-version = "0.14.0"
+version = "0.16.0"
 description = "Cross-platform native UI toolkit for Android and iOS"
 authors = [
   { name = "Owen Carey" }
@@ -64,6 +64,8 @@ Documentation = "https://docs.pythonnative.com/"
 
 
 
+
+
 [tool.setuptools.packages.find]
 where = ["src"]
 

{pythonnative-0.14.0 → pythonnative-0.16.0}/src/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-0.14.0 → pythonnative-0.16.0}/src/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",
 ]