pythonnative 0.24.0__tar.gz → 0.25.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pythonnative
-Version: 0.24.0
+Version: 0.25.0
 Summary: Cross-platform native UI toolkit for Android and iOS
 Author: Owen Carey
 License: MIT License
@@ -105,6 +105,7 @@ PythonNative is a cross-platform toolkit for building native Android and iOS app
 - **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` / `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.

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

@@ -34,6 +34,7 @@ PythonNative is a cross-platform toolkit for building native Android and iOS app
 - **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` / `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.

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

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

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

@@ -60,7 +60,7 @@ Example:
     ```
 """
 
-__version__ = "0.24.0"
+__version__ = "0.25.0"
 
 from . import appearance, diagnostics, gestures, images, runtime, sdk
 from .alerts import Alert
@@ -92,6 +92,7 @@ from .components import (
     Slider,
     Spacer,
     StatusBar,
+    Suspense,
     Switch,
     Text,
     TextInput,
@@ -111,11 +112,11 @@ from .hooks import (
     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,
@@ -126,8 +127,10 @@ from .hooks import (
     use_query,
     use_reducer,
     use_ref,
+    use_resource,
     use_safe_area_insets,
     use_state,
+    use_transition,
     use_window_dimensions,
 )
 from .native_modules import (
@@ -160,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,
@@ -204,6 +207,7 @@ from .style import (
     style,
     use_theme,
 )
+from .suspense import Resource, lazy, start_resource
 
 __all__ = [
     # Components
@@ -233,6 +237,7 @@ __all__ = [
     "Slider",
     "Spacer",
     "StatusBar",
+    "Suspense",
     "Switch",
     "Text",
     "TextInput",
@@ -251,11 +256,11 @@ __all__ = [
     "MutationState",
     "QueryResult",
     "Ref",
-    "use_async_effect",
     "use_back_handler",
     "use_callback",
     "use_color_scheme",
     "use_context",
+    "use_deferred_value",
     "use_effect",
     "use_focus_effect",
     "use_imperative_handle",
@@ -268,11 +273,17 @@ __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",
@@ -349,6 +360,7 @@ __all__ = [
     "Response",
     # Runtime
     "run_async",
+    "run_blocking",
     "runtime",
     # Diagnostics
     "HookOrderError",

{pythonnative-0.24.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!"),
@@ -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.24.0 → pythonnative-0.25.0}/src/pythonnative/components.py

@@ -1732,6 +1732,65 @@ def ErrorBoundary(
     return Element("__ErrorBoundary__", props, list(children), key=key)
 
 
+def Suspense(
+    *children: Element,
+    fallback: Optional[Any] = None,
+    key: Optional[str] = None,
+) -> Element:
+    """Show ``fallback`` while descendants wait on async work, then swap in the content.
+
+    A Suspense boundary catches **suspensions** from the subtree it
+    wraps: an ``async def`` component body blocking on a pending
+    await, or a regular component calling
+    [`Resource.read`][pythonnative.suspense.Resource.read] on data that hasn't
+    arrived (see [`use_resource`][pythonnative.use_resource] and
+    [`lazy`][pythonnative.lazy]). While anything is pending the
+    boundary renders ``fallback``; when the awaited work completes it
+    retries the content and swaps it in. Suspended components keep
+    their hook state across retries, so cached resources aren't
+    refetched.
+
+    Two timing behaviors, matching React:
+
+    - **Initial mount**: the fallback shows until the content is ready.
+    - **Updates**: a component that's already on screen and suspends
+      again (its dependencies changed) keeps its previous content
+      visible and re-renders when ready; there's no fallback flash.
+
+    Args:
+        *children: Subtree to wrap (the async content).
+        fallback: Content shown while suspended: an
+            [`Element`][pythonnative.Element] or a zero-arg callable
+            returning one. Without it, suspensions propagate to the
+            next Suspense boundary up.
+        key: Stable identity for keyed reconciliation.
+
+    Returns:
+        An [`Element`][pythonnative.Element] of type ``"__Suspense__"``.
+
+    Example:
+        ```python
+        import pythonnative as pn
+
+        @pn.component
+        async def Profile(user_id: str):
+            user = await api.fetch_user(user_id)
+            return pn.Text(user.name)
+
+        @pn.component
+        def Screen():
+            return pn.Suspense(
+                Profile(user_id="42"),
+                fallback=pn.ActivityIndicator(),
+            )
+        ```
+    """
+    props: Dict[str, Any] = {}
+    if fallback is not None:
+        props["__fallback__"] = fallback
+    return Element("__Suspense__", props, list(children), key=key)
+
+
 # ======================================================================
 # Lists (native virtualization with a Python-windowed fallback)
 # ======================================================================