pythonnative 0.23.0__tar.gz → 0.25.0__tar.gz

{pythonnative-0.23.0/src/pythonnative.egg-info → pythonnative-0.25.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pythonnative
-Version: 0.23.0
+Version: 0.25.0
 Summary: Cross-platform native UI toolkit for Android and iOS
 Author: Owen Carey
 License: MIT License
@@ -104,7 +104,9 @@ 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.
 - **Rich component library:** 25+ built-in components backed by real native widgets: `TextInput`, `Image` / `ImageBackground`, `ScrollView`, `FlatList` / `SectionList`, `Modal`, `Pressable` / `TouchableOpacity`, `Switch` / `Checkbox`, `Slider`, `SegmentedControl`, `Picker`, `DatePicker`, `ProgressBar` / `ActivityIndicator`, `WebView`, and more.
 - **Device APIs:** Cross-platform modules for `Camera`, `Location`, `FileSystem`, `Notifications`, `Clipboard`, `Share`, `Linking`, `Permissions`, `AppState`, `NetInfo`, `SecureStore`, `Battery`, `Haptics` / `Vibration`, and `Biometrics`, plus reactive `use_app_state` and `use_net_info` hooks.
-- **Hooks and function components:** Manage state with `use_state`, side effects with `use_effect`, and navigation with `use_navigation`, all through one consistent pattern.
+- **Hooks and function components:** Manage state with `use_state`, side effects with `use_effect` / `use_layout_effect`, refs and imperative handles with `use_ref` / `use_imperative_handle`, and navigation with `use_navigation`, all through one consistent pattern. Components can return a single element, a list of siblings, or `None`, and `Fragment`, `Portal`, and reactive `Provider` context work the way they do in React.
+- **Async-first rendering:** One `asyncio` event loop runs the whole framework on the platform's main thread. Components can be `async def` and `await` data directly in the body; `Suspense` boundaries show declarative loading states while they wait. `use_resource` fetches during render, `use_effect` accepts coroutine callbacks (cancelled automatically on unmount), `lazy` code-splits components, and `use_transition` / `use_deferred_value` keep the UI responsive during expensive updates.
+- **Developer feedback that finds your bugs:** In dev mode (`pn preview`, hot reload, or `PN_DEV=1`), uncaught errors from renders, effects, and event handlers show a full-screen RedBox with the traceback; unknown style keys and duplicate list keys print "did you mean" warnings; and conditional hooks raise a `HookOrderError` at the source instead of silently cross-wiring state.
 - **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. Each commit lands as **one batched transaction** of mutation ops, and event callbacks are routed through a tag-based registry so re-renders that only change closures cost zero native calls. State updates re-render **locally**: only the component whose state changed (and its subtree) re-runs, and unchanged leaves reuse cached intrinsic measurements, so deep UIs stay responsive instead of re-rendering the whole app from the root on every tap.
@@ -115,7 +117,7 @@ PythonNative is a cross-platform toolkit for building native Android and iOS app
 - **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.
 - **Instant desktop preview:** `pn preview` renders your app in a native desktop window via Tkinter with Fast Refresh on every save: iterate on layout, state, and navigation in milliseconds without booting a simulator or device. The reconciler, hooks, layout engine, and navigation are the same code that ships to the phone.
-- **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.
+- **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; `use_back_handler` intercepts the back action when a screen needs to.
 - **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.
 - **Bundled templates:** Android Gradle and iOS Xcode templates are included, so scaffolding requires no network access.
 
@@ -140,7 +142,7 @@ def App():
         pn.Text(f"Count: {count}", style=pn.style(font_size=24, bold=True)),
         pn.Button(
             "Tap me",
-            on_click=lambda: set_count(count + 1),
+            on_press=lambda: set_count(count + 1),
         ),
         style=pn.style(spacing=12, padding=16),
     )

{pythonnative-0.23.0 → pythonnative-0.25.0}/README.md

@@ -33,7 +33,9 @@ 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.
 - **Rich component library:** 25+ built-in components backed by real native widgets: `TextInput`, `Image` / `ImageBackground`, `ScrollView`, `FlatList` / `SectionList`, `Modal`, `Pressable` / `TouchableOpacity`, `Switch` / `Checkbox`, `Slider`, `SegmentedControl`, `Picker`, `DatePicker`, `ProgressBar` / `ActivityIndicator`, `WebView`, and more.
 - **Device APIs:** Cross-platform modules for `Camera`, `Location`, `FileSystem`, `Notifications`, `Clipboard`, `Share`, `Linking`, `Permissions`, `AppState`, `NetInfo`, `SecureStore`, `Battery`, `Haptics` / `Vibration`, and `Biometrics`, plus reactive `use_app_state` and `use_net_info` hooks.
-- **Hooks and function components:** Manage state with `use_state`, side effects with `use_effect`, and navigation with `use_navigation`, all through one consistent pattern.
+- **Hooks and function components:** Manage state with `use_state`, side effects with `use_effect` / `use_layout_effect`, refs and imperative handles with `use_ref` / `use_imperative_handle`, and navigation with `use_navigation`, all through one consistent pattern. Components can return a single element, a list of siblings, or `None`, and `Fragment`, `Portal`, and reactive `Provider` context work the way they do in React.
+- **Async-first rendering:** One `asyncio` event loop runs the whole framework on the platform's main thread. Components can be `async def` and `await` data directly in the body; `Suspense` boundaries show declarative loading states while they wait. `use_resource` fetches during render, `use_effect` accepts coroutine callbacks (cancelled automatically on unmount), `lazy` code-splits components, and `use_transition` / `use_deferred_value` keep the UI responsive during expensive updates.
+- **Developer feedback that finds your bugs:** In dev mode (`pn preview`, hot reload, or `PN_DEV=1`), uncaught errors from renders, effects, and event handlers show a full-screen RedBox with the traceback; unknown style keys and duplicate list keys print "did you mean" warnings; and conditional hooks raise a `HookOrderError` at the source instead of silently cross-wiring state.
 - **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. Each commit lands as **one batched transaction** of mutation ops, and event callbacks are routed through a tag-based registry so re-renders that only change closures cost zero native calls. State updates re-render **locally**: only the component whose state changed (and its subtree) re-runs, and unchanged leaves reuse cached intrinsic measurements, so deep UIs stay responsive instead of re-rendering the whole app from the root on every tap.
@@ -44,7 +46,7 @@ PythonNative is a cross-platform toolkit for building native Android and iOS app
 - **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.
 - **Instant desktop preview:** `pn preview` renders your app in a native desktop window via Tkinter with Fast Refresh on every save: iterate on layout, state, and navigation in milliseconds without booting a simulator or device. The reconciler, hooks, layout engine, and navigation are the same code that ships to the phone.
-- **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.
+- **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; `use_back_handler` intercepts the back action when a screen needs to.
 - **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.
 - **Bundled templates:** Android Gradle and iOS Xcode templates are included, so scaffolding requires no network access.
 
@@ -69,7 +71,7 @@ def App():
         pn.Text(f"Count: {count}", style=pn.style(font_size=24, bold=True)),
         pn.Button(
             "Tap me",
-            on_click=lambda: set_count(count + 1),
+            on_press=lambda: set_count(count + 1),
         ),
         style=pn.style(spacing=12, padding=16),
     )

{pythonnative-0.23.0 → pythonnative-0.25.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pythonnative"
-version = "0.23.0"
+version = "0.25.0"
 description = "Cross-platform native UI toolkit for Android and iOS"
 authors = [
   { name = "Owen Carey" }

{pythonnative-0.23.0 → pythonnative-0.25.0}/src/pythonnative/__init__.py

@@ -54,96 +54,83 @@ Example:
         count, set_count = pn.use_state(0)
         return pn.Column(
             pn.Text(f"Count: {count}", style=pn.style(font_size=24)),
-            pn.Button("+", on_click=lambda: set_count(count + 1)),
+            pn.Button("+", on_press=lambda: set_count(count + 1)),
             style=pn.style(spacing=12),
         )
     ```
 """
 
-__version__ = "0.23.0"
+__version__ = "0.25.0"
 
-from . import appearance, gestures, images, runtime, sdk
+from . import appearance, diagnostics, gestures, images, runtime, sdk
 from .alerts import Alert
 from .animated import Animated, AnimatedValue, use_animated_value
 from .components import (
     ActivityIndicator,
-    ActivityIndicatorProps,
     Button,
-    ButtonProps,
     Checkbox,
-    CheckboxProps,
     Column,
     DatePicker,
-    DatePickerProps,
     ErrorBoundary,
     FlatList,
     Fragment,
     Image,
     ImageBackground,
-    ImageBackgroundProps,
-    ImageProps,
     KeyboardAvoidingView,
-    KeyboardAvoidingViewProps,
+    ListController,
     Modal,
-    ModalProps,
     Picker,
-    PickerProps,
+    Portal,
     Pressable,
-    PressableProps,
     ProgressBar,
-    ProgressBarProps,
     RefreshControl,
     Row,
     SafeAreaView,
-    SafeAreaViewProps,
     ScrollView,
-    ScrollViewProps,
     SectionList,
     SegmentedControl,
-    SegmentedControlProps,
     Slider,
-    SliderProps,
     Spacer,
-    SpacerProps,
     StatusBar,
-    StatusBarProps,
+    Suspense,
     Switch,
-    SwitchProps,
     Text,
     TextInput,
-    TextInputProps,
-    TextProps,
     TouchableOpacity,
-    TouchableOpacityProps,
     View,
-    ViewProps,
     WebView,
-    WebViewProps,
 )
+from .diagnostics import HookOrderError
 from .element import Element
 from .hooks import (
     MutationCall,
     MutationState,
     Provider,
     QueryResult,
+    Ref,
     batch_updates,
     component,
     create_context,
     memo,
-    use_async_effect,
+    use_back_handler,
     use_callback,
     use_color_scheme,
     use_context,
+    use_deferred_value,
     use_effect,
+    use_imperative_handle,
     use_keyboard_height,
+    use_layout_effect,
     use_memo,
     use_mutation,
     use_navigation,
     use_query,
     use_reducer,
     use_ref,
+    use_resource,
     use_safe_area_insets,
     use_state,
+    use_transition,
     use_window_dimensions,
 )
 from .native_modules import (
@@ -167,6 +154,7 @@ from .native_modules import (
 )
 from .navigation import (
     NavigationContainer,
+    ScreenOptions,
     create_drawer_navigator,
     create_stack_navigator,
     create_tab_navigator,
@@ -175,7 +163,7 @@ from .navigation import (
 )
 from .net import HTTPError, Response, fetch
 from .platform import Platform
-from .runtime import run_async
+from .runtime import run_async, run_blocking
 from .screen import create_screen
 from .sdk import (
     Props,
@@ -188,6 +176,8 @@ from .storage import AsyncStorage, use_persisted_state
 from .style import (
     DEFAULT_DARK_THEME,
     DEFAULT_LIGHT_THEME,
+    AccessibilityState,
+    AlignContent,
     AlignItems,
     AlignSelf,
     AutoCapitalize,
@@ -195,9 +185,11 @@ from .style import (
     Dimension,
     EdgeInsets,
     FlexDirection,
+    FlexWrap,
     FontWeight,
     JustifyContent,
     KeyboardType,
+    LayoutDirection,
     Overflow,
     Position,
     ReturnKeyType,
@@ -215,6 +207,7 @@ from .style import (
     style,
     use_theme,
 )
+from .suspense import Resource, lazy, start_resource
 
 __all__ = [
     # Components
@@ -229,8 +222,10 @@ __all__ = [
     "Image",
     "ImageBackground",
     "KeyboardAvoidingView",
+    "ListController",
     "Modal",
     "Picker",
+    "Portal",
     "Pressable",
     "ProgressBar",
     "RefreshControl",
@@ -242,36 +237,13 @@ __all__ = [
     "Slider",
     "Spacer",
     "StatusBar",
+    "Suspense",
     "Switch",
     "Text",
     "TextInput",
     "TouchableOpacity",
     "View",
     "WebView",
-    # Built-in Props dataclasses
-    "ActivityIndicatorProps",
-    "ButtonProps",
-    "CheckboxProps",
-    "DatePickerProps",
-    "ImageBackgroundProps",
-    "ImageProps",
-    "KeyboardAvoidingViewProps",
-    "ModalProps",
-    "PickerProps",
-    "PressableProps",
-    "ProgressBarProps",
-    "SafeAreaViewProps",
-    "ScrollViewProps",
-    "SegmentedControlProps",
-    "SliderProps",
-    "SpacerProps",
-    "StatusBarProps",
-    "SwitchProps",
-    "TextInputProps",
-    "TextProps",
-    "TouchableOpacityProps",
-    "ViewProps",
-    "WebViewProps",
     # Core
     "Element",
     "create_screen",
@@ -283,13 +255,17 @@ __all__ = [
     "MutationCall",
     "MutationState",
     "QueryResult",
-    "use_async_effect",
+    "Ref",
+    "use_back_handler",
     "use_callback",
     "use_color_scheme",
     "use_context",
+    "use_deferred_value",
     "use_effect",
     "use_focus_effect",
+    "use_imperative_handle",
     "use_keyboard_height",
+    "use_layout_effect",
     "use_memo",
     "use_mutation",
     "use_navigation",
@@ -297,17 +273,26 @@ __all__ = [
     "use_query",
     "use_reducer",
     "use_ref",
+    "use_resource",
     "use_route",
     "use_safe_area_insets",
     "use_state",
+    "use_transition",
     "use_window_dimensions",
     "Provider",
+    # Suspense and async rendering
+    "Resource",
+    "lazy",
+    "start_resource",
     # Navigation
     "NavigationContainer",
+    "ScreenOptions",
     "create_drawer_navigator",
     "create_stack_navigator",
     "create_tab_navigator",
     # Styling - typed primitives
+    "AccessibilityState",
+    "AlignContent",
     "AlignItems",
     "AlignSelf",
     "AutoCapitalize",
@@ -317,9 +302,11 @@ __all__ = [
     "Dimension",
     "EdgeInsets",
     "FlexDirection",
+    "FlexWrap",
     "FontWeight",
     "JustifyContent",
     "KeyboardType",
+    "LayoutDirection",
     "Overflow",
     "Position",
     "ReturnKeyType",
@@ -373,7 +360,11 @@ __all__ = [
     "Response",
     # Runtime
     "run_async",
+    "run_blocking",
     "runtime",
+    # Diagnostics
+    "HookOrderError",
+    "diagnostics",
     # Platform
     "Platform",
     # Custom-component SDK

{pythonnative-0.23.0 → pythonnative-0.25.0}/src/pythonnative/animated.py

@@ -47,7 +47,7 @@ Example:
             await pn.Animated.timing(opacity, to=1.0, duration=400)
             await pn.Animated.timing(opacity, to=0.5, duration=200)
 
-        pn.use_async_effect(fade_in, [])
+        pn.use_effect(fade_in, [])
 
         return pn.Animated.View(
             pn.Text("Hello!"),
@@ -834,7 +834,7 @@ def _make_animated_factory(
         ref = use_ref(None)
 
         def _attach_bindings() -> Callable[[], None]:
-            tag = ref.get("_pn_tag")
+            tag = ref._pn_tag
             if tag is None:
                 return lambda: None
             detachers = [value.attach(tag, _animated_prop_name(prop)) for prop, value in bindings.items()]
@@ -1014,7 +1014,7 @@ def use_animated_value(initial: float = 0.0) -> AnimatedValue:
             async def fade_in():
                 await pn.Animated.timing(opacity, to=1.0, duration=300)
 
-            pn.use_async_effect(fade_in, [])
+            pn.use_effect(fade_in, [])
             return pn.Animated.View(
                 pn.Text("Hello"),
                 style=pn.style(opacity=opacity),

{pythonnative-0.23.0 → pythonnative-0.25.0}/src/pythonnative/cli/pn.py

@@ -59,8 +59,8 @@ def HomeScreen():
         pn.Column(
             pn.Text("Hello from PythonNative!", style={"font_size": 24, "bold": True}),
             pn.Text(f"Tapped {count} times"),
-            pn.Button("Tap me", on_click=lambda: set_count(count + 1)),
-            pn.Button("Open detail", on_click=lambda: nav.navigate("Detail", {"count": count})),
+            pn.Button("Tap me", on_press=lambda: set_count(count + 1)),
+            pn.Button("Open detail", on_press=lambda: nav.navigate("Detail", {"count": count})),
             style={"spacing": 12, "padding": 16, "align_items": "stretch"},
         )
     )
@@ -72,7 +72,7 @@ def DetailScreen():
     params = pn.use_route()
     return pn.Column(
         pn.Text(f"Detail: count was {params.get('count', 0)}", style={"font_size": 20}),
-        pn.Button("Back", on_click=nav.go_back),
+        pn.Button("Back", on_press=nav.go_back),
         style={"spacing": 12, "padding": 16},
     )