pythonnative 0.22.1__py3-none-any.whl → 0.24.0__py3-none-any.whl

pythonnative/__init__.py

@@ -54,87 +54,72 @@ 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.22.1"
+__version__ = "0.24.0"
 
-from . import gestures, 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,
     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_effect,
+    use_imperative_handle,
     use_keyboard_height,
+    use_layout_effect,
     use_memo,
     use_mutation,
     use_navigation,
@@ -166,6 +151,7 @@ from .native_modules import (
 )
 from .navigation import (
     NavigationContainer,
+    ScreenOptions,
     create_drawer_navigator,
     create_stack_navigator,
     create_tab_navigator,
@@ -185,6 +171,10 @@ from .sdk import (
 )
 from .storage import AsyncStorage, use_persisted_state
 from .style import (
+    DEFAULT_DARK_THEME,
+    DEFAULT_LIGHT_THEME,
+    AccessibilityState,
+    AlignContent,
     AlignItems,
     AlignSelf,
     AutoCapitalize,
@@ -192,9 +182,11 @@ from .style import (
     Dimension,
     EdgeInsets,
     FlexDirection,
+    FlexWrap,
     FontWeight,
     JustifyContent,
     KeyboardType,
+    LayoutDirection,
     Overflow,
     Position,
     ReturnKeyType,
@@ -207,8 +199,10 @@ from .style import (
     TextDecoration,
     ThemeContext,
     TransformSpec,
+    default_theme,
     resolve_style,
     style,
+    use_theme,
 )
 
 __all__ = [
@@ -224,8 +218,10 @@ __all__ = [
     "Image",
     "ImageBackground",
     "KeyboardAvoidingView",
+    "ListController",
     "Modal",
     "Picker",
+    "Portal",
     "Pressable",
     "ProgressBar",
     "RefreshControl",
@@ -243,30 +239,6 @@ __all__ = [
     "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",
@@ -278,12 +250,17 @@ __all__ = [
     "MutationCall",
     "MutationState",
     "QueryResult",
+    "Ref",
     "use_async_effect",
+    "use_back_handler",
     "use_callback",
+    "use_color_scheme",
     "use_context",
     "use_effect",
     "use_focus_effect",
+    "use_imperative_handle",
     "use_keyboard_height",
+    "use_layout_effect",
     "use_memo",
     "use_mutation",
     "use_navigation",
@@ -298,20 +275,27 @@ __all__ = [
     "Provider",
     # Navigation
     "NavigationContainer",
+    "ScreenOptions",
     "create_drawer_navigator",
     "create_stack_navigator",
     "create_tab_navigator",
     # Styling - typed primitives
+    "AccessibilityState",
+    "AlignContent",
     "AlignItems",
     "AlignSelf",
     "AutoCapitalize",
     "Color",
+    "DEFAULT_DARK_THEME",
+    "DEFAULT_LIGHT_THEME",
     "Dimension",
     "EdgeInsets",
     "FlexDirection",
+    "FlexWrap",
     "FontWeight",
     "JustifyContent",
     "KeyboardType",
+    "LayoutDirection",
     "Overflow",
     "Position",
     "ReturnKeyType",
@@ -324,8 +308,14 @@ __all__ = [
     "TextDecoration",
     "ThemeContext",
     "TransformSpec",
+    "default_theme",
     "resolve_style",
     "style",
+    "use_theme",
+    # Appearance
+    "appearance",
+    # Image pipeline
+    "images",
     # Animation
     "Animated",
     "AnimatedValue",
@@ -360,6 +350,9 @@ __all__ = [
     # Runtime
     "run_async",
     "runtime",
+    # Diagnostics
+    "HookOrderError",
+    "diagnostics",
     # Platform
     "Platform",
     # Custom-component SDK

pythonnative/animated.py

@@ -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()]

pythonnative/appearance.py

@@ -0,0 +1,124 @@
+"""System color-scheme (light / dark mode) tracking.
+
+The platform screen host publishes the operating system's current
+appearance here (Android: ``Configuration.uiMode``; iOS:
+``UITraitCollection.userInterfaceStyle``), and components read it back
+through [`use_color_scheme`][pythonnative.use_color_scheme] or
+[`use_theme`][pythonnative.use_theme], both of which re-render when
+the scheme changes.
+
+Apps can also *override* the scheme (e.g. an in-app appearance
+setting) with [`set_color_scheme`][pythonnative.appearance.set_color_scheme];
+the override wins over the system value until cleared with ``None``.
+
+Example:
+    >>> from pythonnative import appearance
+    >>> appearance.get_color_scheme()
+    'light'
+    >>> appearance.set_color_scheme("dark")   # app-level override
+    >>> appearance.get_color_scheme()
+    'dark'
+    >>> appearance.set_color_scheme(None)     # follow the system again
+"""
+
+from __future__ import annotations
+
+import threading
+from typing import Callable, List, Literal, Optional
+
+ColorScheme = Literal["light", "dark"]
+"""The two supported appearance values."""
+
+_system_scheme: str = "light"
+_override_scheme: Optional[str] = None
+
+_subscribers: List[Callable[[], None]] = []
+_subscribers_lock = threading.Lock()
+
+
+def _notify_subscribers() -> None:
+    """Invoke every registered subscriber, swallowing exceptions."""
+    with _subscribers_lock:
+        callbacks = list(_subscribers)
+    for cb in callbacks:
+        try:
+            cb()
+        except Exception:
+            pass
+
+
+def subscribe(callback: Callable[[], None]) -> Callable[[], None]:
+    """Register ``callback`` to fire whenever the effective scheme changes.
+
+    Returns an unsubscribe function. Threadsafe.
+    """
+    with _subscribers_lock:
+        _subscribers.append(callback)
+
+    def _unsub() -> None:
+        with _subscribers_lock:
+            try:
+                _subscribers.remove(callback)
+            except ValueError:
+                pass
+
+    return _unsub
+
+
+def _coerce(scheme: object) -> Optional[str]:
+    if scheme in ("light", "dark"):
+        return str(scheme)
+    return None
+
+
+def set_system_color_scheme(scheme: str) -> None:
+    """Publish the operating system's current scheme.
+
+    Called by the platform screen host on create/resume and whenever
+    the system reports an appearance change. Invalid values are
+    ignored. Subscribers are only notified when the *effective* scheme
+    (after any app override) actually changes.
+    """
+    global _system_scheme
+    coerced = _coerce(scheme)
+    if coerced is None or coerced == _system_scheme:
+        return
+    effective_before = get_color_scheme()
+    _system_scheme = coerced
+    if get_color_scheme() != effective_before:
+        _notify_subscribers()
+
+
+def set_color_scheme(scheme: Optional[str]) -> None:
+    """Set (or clear) the app-level scheme override.
+
+    Args:
+        scheme: ``"light"`` or ``"dark"`` to force that appearance
+            regardless of the system setting, or ``None`` to follow
+            the system again.
+    """
+    global _override_scheme
+    coerced = _coerce(scheme) if scheme is not None else None
+    if scheme is not None and coerced is None:
+        return
+    effective_before = get_color_scheme()
+    _override_scheme = coerced
+    if get_color_scheme() != effective_before:
+        _notify_subscribers()
+
+
+def get_color_scheme() -> str:
+    """Return the effective scheme: the app override if set, else the system value."""
+    return _override_scheme if _override_scheme is not None else _system_scheme
+
+
+def get_system_color_scheme() -> str:
+    """Return the system-reported scheme, ignoring any app override."""
+    return _system_scheme
+
+
+def reset_color_scheme() -> None:
+    """Reset to system ``"light"`` with no override. Intended for tests."""
+    global _system_scheme, _override_scheme
+    _system_scheme = "light"
+    _override_scheme = None

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},
     )