pythonnative 0.43.1__tar.gz → 0.44.0__tar.gz

{pythonnative-0.43.1/src/pythonnative.egg-info → pythonnative-0.44.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pythonnative
-Version: 0.43.1
+Version: 0.44.0
 Summary: Cross-platform native UI toolkit for Android and iOS
 Author: Owen Carey
 License: MIT License

{pythonnative-0.43.1 → pythonnative-0.44.0}/pyproject.toml

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

{pythonnative-0.43.1 → pythonnative-0.44.0}/src/pythonnative/__init__.py

@@ -64,7 +64,7 @@ Example:
     ```
 """
 
-__version__ = "0.43.1"
+__version__ = "0.44.0"
 
 from . import appearance, diagnostics, gestures, runtime, sdk
 from .alerts import Alert
@@ -81,6 +81,7 @@ from .components import (
     Fragment,
     Image,
     ImageBackground,
+    ImageLoadEvent,
     KeyboardAvoidingView,
     ListController,
     Modal,
@@ -103,6 +104,7 @@ from .components import (
     TextInput,
     TouchableOpacity,
     View,
+    WebNavigationEvent,
     WebView,
 )
 from .diagnostics import HookOrderError
@@ -136,6 +138,7 @@ from .hooks import (
     use_window_dimensions,
 )
 from .hosts import create_screen
+from .mutations import UNSET, UnsetType
 from .native_modules import (
     AppState,
     Battery,
@@ -223,6 +226,8 @@ from .style import (
 from .suspense import Resource, lazy, start_resource
 
 __all__ = [
+    "UNSET",
+    "UnsetType",
     # Components
     "ActivityIndicator",
     "Button",
@@ -234,6 +239,8 @@ __all__ = [
     "Fragment",
     "Image",
     "ImageBackground",
+    "ImageLoadEvent",
+    "WebNavigationEvent",
     "KeyboardAvoidingView",
     "ListController",
     "Modal",

{pythonnative-0.43.1 → pythonnative-0.44.0}/src/pythonnative/bridge/codec.py

@@ -5,17 +5,21 @@ Prop values coming out of the reconciler are almost, but not quite,
 JSON: they may contain ``frozenset`` event-name sets, tuples, floats
 that are infinite, and Python callables that native must never see.
 [`to_jsonable`][pythonnative.bridge.codec.to_jsonable] normalizes a
-value into something ``json.dumps`` accepts and reports the keys it had
-to drop so the backend can keep them Python-side.
+value into something ``json.dumps`` accepts. Callbacks and declared
+Python-only fields stay in the backend's sidecar; unsupported native
+values raise an error.
 """
 
 from __future__ import annotations
 
+import dataclasses
+import enum
 import json
 import math
+from collections.abc import Mapping
 from typing import Any, Dict, List, Sequence, Tuple, Union
 
-from ..mutations import CreateOp, DestroyOp, InsertOp, Mutation, SetFrameOp, UpdateOp
+from ..mutations import UNSET, CreateOp, DestroyOp, InsertOp, Mutation, SetFrameOp, UpdateOp
 
 __all__ = [
     "INF",
@@ -48,8 +52,14 @@ def to_jsonable(value: Any) -> Any:
 
     Raises:
         TypeError: When ``value`` (or something nested in it) has no
-            JSON representation; callers decide whether to drop it.
+            JSON representation.
     """
+    if isinstance(value, enum.Enum):
+        return to_jsonable(value.value)
+    if dataclasses.is_dataclass(value) and not isinstance(value, type):
+        return {
+            field.name: to_jsonable(getattr(value, field.name)) for field in dataclasses.fields(value) if field.init
+        }
     if isinstance(value, _SCALARS):
         return value
     if isinstance(value, float):
@@ -58,8 +68,10 @@ def to_jsonable(value: Any) -> Any:
         if math.isnan(value):
             return None
         return INF if value > 0 else NEG_INF
-    if isinstance(value, dict):
-        return {str(k): to_jsonable(v) for k, v in value.items()}
+    if isinstance(value, Mapping):
+        if not all(isinstance(key, str) for key in value):
+            raise TypeError("Native mappings require string keys")
+        return {key: to_jsonable(item) for key, item in value.items()}
     if isinstance(value, (list, tuple)):
         return [to_jsonable(v) for v in value]
     if isinstance(value, (set, frozenset)):
@@ -75,18 +87,23 @@ def to_jsonable(value: Any) -> Any:
     raise TypeError(f"value of type {type(value).__name__} is not bridge-serializable")
 
 
-def split_props(props: Dict[str, Any]) -> Tuple[Dict[str, Any], Dict[str, Any]]:
+def split_props(
+    props: Dict[str, Any], python_only: frozenset[str] = frozenset()
+) -> Tuple[Dict[str, Any], Dict[str, Any]]:
     """Split ``props`` into ``(wire_props, python_props)``.
 
-    ``wire_props`` is JSON-ready; ``python_props`` holds every prop
-    that can't cross the bridge (callables such as ``render_row``,
-    arbitrary objects). The backend keeps the latter in a per-tag
-    sidecar so native-backed handlers that need them (virtualized
-    list rows) can still reach them.
+    ``wire_props`` is JSON-ready; ``python_props`` holds callbacks and
+    fields explicitly declared Python-only. Other unsupported values
+    fail encoding. The backend keeps Python props in a per-tag sidecar.
     """
     wire: Dict[str, Any] = {}
     python: Dict[str, Any] = {}
     for key, value in props.items():
+        if value is UNSET:
+            continue
+        if key in python_only:
+            python[key] = value
+            continue
         if callable(value) and not isinstance(value, type):
             from ..animated import AnimatedEvent
 
@@ -96,41 +113,50 @@ def split_props(props: Dict[str, Any]) -> Tuple[Dict[str, Any], Dict[str, Any]]:
                 }
             python[key] = value
             continue
-        try:
-            wire[key] = to_jsonable(value)
-        except TypeError:
-            python[key] = value
+        wire[key] = to_jsonable(value)
     return wire, python
 
 
 def encode_transaction(
-    ops: Sequence[Mutation], prop_filter: Any = None
+    ops: Sequence[Mutation], types: Mapping[int, str] | None = None
 ) -> Tuple[str, List[Tuple[int, Dict[str, Any]]]]:
     """Encode a mutation batch as the bridge's transaction JSON.
 
     Args:
         ops: Ordered mutations from the reconciler.
-        prop_filter: Unused hook kept for symmetry with the test
-            registry; reserved for per-type prop rewriting.
+        types: Native component names for tags, used to identify Python-only props.
 
     Returns:
         ``(json_text, python_props)`` where ``python_props`` lists
         ``(tag, props)`` pairs for values that stayed Python-side (for
-        ``c`` and ``u`` ops). An update that *removes* a Python-side
-        prop reports it as ``None`` so the sidecar can drop it.
+        ``c`` and ``u`` ops). The backend removes sidecar entries using
+        ``UNSET`` values in the original update operations.
     """
-    del prop_filter
+    from ..sdk.schema import COMPONENTS
+
+    names = dict(types or {})
+
+    def python_fields(name: str) -> frozenset[str]:
+        schema = COMPONENTS.get(name)
+        return (
+            frozenset(key for key, field in schema.props.items() if field.get("native", {}).get("python_only"))
+            if schema
+            else frozenset()
+        )
+
     encoded: List[Any] = []
     sidecar: List[Tuple[int, Dict[str, Any]]] = []
     for op in ops:
         if isinstance(op, CreateOp):
-            wire, python = split_props(op.props)
+            names[op.tag] = op.type_name
+            wire, python = split_props(op.props, python_fields(op.type_name))
             encoded.append(["c", op.tag, op.type_name, wire])
             if python:
                 sidecar.append((op.tag, python))
         elif isinstance(op, UpdateOp):
-            wire, python = split_props(op.changed_props)
-            encoded.append(["u", op.tag, wire])
+            removed = [key for key, value in op.changed_props.items() if value is UNSET]
+            wire, python = split_props(op.changed_props, python_fields(names.get(op.tag, "")))
+            encoded.append(["u", op.tag, wire, removed])
             if python:
                 sidecar.append((op.tag, python))
         elif isinstance(op, InsertOp):

{pythonnative-0.43.1 → pythonnative-0.44.0}/src/pythonnative/bridge/commits.py

@@ -14,7 +14,7 @@ from typing import Any
 
 from ..profiling import count, profiled
 
-PROTOCOL_VERSION = 2
+PROTOCOL_VERSION = 3
 
 
 class CommitError(RuntimeError):
@@ -97,7 +97,7 @@ class CommitState:
     def prepare(self, envelope: Any) -> CommitState:
         """Validate without mutating this state and return the candidate state."""
         if not isinstance(envelope, dict) or envelope.get("version") != PROTOCOL_VERSION:
-            raise CommitError("Expected a protocol v2 commit envelope; rebuild the native client")
+            raise CommitError("Expected a protocol v3 commit envelope; rebuild the native client")
         application, surface, revision = (envelope.get(k) for k in ("application", "surface", "revision"))
         if not isinstance(application, str) or not application or type(surface) is not int or surface <= 0:
             raise CommitError("Invalid application or surface identity")
@@ -132,7 +132,7 @@ class CommitState:
         if not isinstance(op, list) or len(op) < 2:
             raise ValueError("Expected an operation array")
         code, tag = op[:2]
-        lengths = {"c": 4, "u": 3, "i": 4, "d": 2, "f": 6}
+        lengths = {"c": 4, "u": 4, "i": 4, "d": 2, "f": 6}
         if code not in lengths or len(op) != lengths[code] or type(tag) is not int or tag <= 0:
             raise ValueError("Invalid opcode, arity, or tag")
         if code == "c":
@@ -146,11 +146,17 @@ class CommitState:
             if not isinstance(op[2], dict):
                 raise ValueError("Update requires a property mapping")
             self._validate_props(view.type_name, op[2], True)
-            for name, value in op[2].items():
-                if value is None:
-                    view.props.pop(name, None)
-                else:
-                    view.props[name] = value
+            removed = op[3]
+            if not isinstance(removed, list) or any(not isinstance(name, str) for name in removed):
+                raise ValueError("Removed properties must be a list of names")
+            if len(set(removed)) != len(removed) or set(removed) & op[2].keys():
+                raise ValueError("A property can't be both set and removed")
+            from ..mutations import UNSET
+
+            self._validate_props(view.type_name, {name: UNSET for name in removed}, True)
+            view.props.update(op[2])
+            for name in removed:
+                view.props.pop(name, None)
         elif code == "i":
             child_tag, index = op[2:]
             if type(child_tag) is not int or type(index) is not int or index < 0:

{pythonnative-0.43.1 → pythonnative-0.44.0}/src/pythonnative/bridge/fake.py

@@ -109,13 +109,11 @@ class FakeTransport:
                 raise AssertionError(f"create: tag {tag} already exists")
             self.views[tag] = FakeNativeView(tag, type_name, props)
         elif code == "u":
-            _, tag, changed = op
+            _, tag, changed, removed = op
             view = self._require(tag, "update")
-            for key, value in changed.items():
-                if value is None:
-                    view.props.pop(key, None)
-                else:
-                    view.props[key] = value
+            view.props.update(changed)
+            for key in removed:
+                view.props.pop(key, None)
         elif code == "i":
             _, parent_tag, child_tag, index = op
             parent = self._require(parent_tag, "insert")

{pythonnative-0.43.1 → pythonnative-0.44.0}/src/pythonnative/components/__init__.py

@@ -60,6 +60,7 @@ from .lists import (  # noqa: F401
     _RowSpec,
 )
 from .media import Image, ImageBackground, WebView
+from .media_events import ImageLoadEvent, WebNavigationEvent
 from .overlays import Modal, Portal
 from .pressable import Pressable, TouchableOpacity, _StatefulPressable  # noqa: F401
 from .structural import ErrorBoundary, Fragment, Suspense
@@ -76,6 +77,8 @@ __all__ = [
     "Fragment",
     "Image",
     "ImageBackground",
+    "ImageLoadEvent",
+    "WebNavigationEvent",
     "KeyboardAvoidingView",
     "ListController",
     "Modal",

{pythonnative-0.43.1 → pythonnative-0.44.0}/src/pythonnative/components/controls.py

@@ -17,6 +17,9 @@ def Switch(
     *,
     value: bool = False,
     on_change: Optional[Callable[[bool], Any]] = None,
+    disabled: bool = False,
+    on_tint_color: Optional[Color] = None,
+    thumb_color: Optional[Color] = None,
     accessibility_label: Optional[str] = None,
     style: StyleProp = None,
     key: Optional[str] = None,
@@ -26,6 +29,9 @@ def Switch(
     Args:
         value: Current on/off state.
         on_change: Callback invoked with the new boolean state.
+        disabled: Prevent changes while keeping the switch visible.
+        on_tint_color: Track color when the switch is on.
+        thumb_color: Thumb color, or the platform default.
         accessibility_label: Label exposed to assistive technology (and
             UI test drivers) for the switch.
         style: Style dict (or list of dicts).
@@ -40,6 +46,9 @@ def Switch(
         key=key,
         value=value,
         on_change=on_change,
+        disabled=disabled,
+        on_tint_color=on_tint_color,
+        thumb_color=thumb_color,
         accessibility_label=accessibility_label,
     )
 
@@ -50,6 +59,13 @@ def Slider(
     min_value: float = 0.0,
     max_value: float = 1.0,
     on_change: Optional[Callable[[float], Any]] = None,
+    disabled: bool = False,
+    step: float = 0.0,
+    minimum_track_color: Optional[Color] = None,
+    maximum_track_color: Optional[Color] = None,
+    thumb_color: Optional[Color] = None,
+    on_sliding_start: Optional[Callable[[float], Any]] = None,
+    on_sliding_complete: Optional[Callable[[float], Any]] = None,
     accessibility_label: Optional[str] = None,
     style: StyleProp = None,
     key: Optional[str] = None,
@@ -62,6 +78,13 @@ def Slider(
         max_value: Upper bound.
         on_change: Callback invoked with the new value as the user
             drags.
+        disabled: Prevent dragging the slider.
+        step: Snap values to this increment, or zero for continuous movement.
+        minimum_track_color: Filled track color.
+        maximum_track_color: Unfilled track color.
+        thumb_color: Thumb color, or the platform default.
+        on_sliding_start: Callback when the user starts dragging.
+        on_sliding_complete: Callback when the user finishes dragging.
         accessibility_label: Label exposed to assistive technology (and
             UI test drivers) for the slider.
         style: Style dict (or list of dicts).
@@ -78,6 +101,13 @@ def Slider(
         min_value=min_value,
         max_value=max_value,
         on_change=on_change,
+        disabled=disabled,
+        step=step,
+        minimum_track_color=minimum_track_color,
+        maximum_track_color=maximum_track_color,
+        thumb_color=thumb_color,
+        on_sliding_start=on_sliding_start,
+        on_sliding_complete=on_sliding_complete,
         accessibility_label=accessibility_label,
     )