pythonnative 0.22.0__tar.gz → 0.22.1__tar.gz

{pythonnative-0.22.0/src/pythonnative.egg-info → pythonnative-0.22.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pythonnative
-Version: 0.22.0
+Version: 0.22.1
 Summary: Cross-platform native UI toolkit for Android and iOS
 Author: Owen Carey
 License: MIT License
@@ -28,7 +28,7 @@ License: MIT License
 Project-URL: Homepage, https://github.com/pythonnative/pythonnative
 Project-URL: Repository, https://github.com/pythonnative/pythonnative
 Project-URL: Issues, https://github.com/pythonnative/pythonnative/issues
-Project-URL: Documentation, https://docs.pythonnative.com/
+Project-URL: Documentation, https://pythonnative.com/
 Classifier: Development Status :: 2 - Pre-Alpha
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
@@ -83,13 +83,13 @@ Dynamic: license-file
   <a href="https://pypi.org/project/pythonnative/"><img src="https://img.shields.io/pypi/v/pythonnative" alt="PyPI Version" /></a>
   <a href="https://pypi.org/project/pythonnative/"><img src="https://img.shields.io/pypi/pyversions/pythonnative" alt="Python Versions" /></a>
   <a href="LICENSE"><img src="https://img.shields.io/pypi/l/pythonnative" alt="License: MIT" /></a>
-  <a href="https://docs.pythonnative.com/"><img src="https://img.shields.io/website?url=https%3A%2F%2Fdocs.pythonnative.com&label=docs" alt="Docs" /></a>
+  <a href="https://pythonnative.com/"><img src="https://img.shields.io/website?url=https%3A%2F%2Fpythonnative.com&label=docs" alt="Docs" /></a>
 </p>
 
 <p align="center">
-  <a href="https://docs.pythonnative.com/">Documentation</a> ·
-  <a href="https://docs.pythonnative.com/getting-started/">Getting Started</a> ·
-  <a href="https://docs.pythonnative.com/examples/">Examples</a> ·
+  <a href="https://pythonnative.com/">Documentation</a> ·
+  <a href="https://pythonnative.com/getting-started/">Getting Started</a> ·
+  <a href="https://pythonnative.com/examples/">Examples</a> ·
   <a href="CONTRIBUTING.md">Contributing</a>
 </p>
 
@@ -102,19 +102,19 @@ PythonNative is a cross-platform toolkit for building native Android and iOS app
 ## Features
 
 - **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.
+- **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.
 - **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.
+- **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.
 - **Native-driven animations:** The `Animated` API (timing / spring / decay, awaitable or fire-and-forget) hands animations to Core Animation and `ViewPropertyAnimator` whenever possible, so no Python code runs per frame; a pure-Python ticker covers the rest.
-- **Native gesture system:** Attach `Tap`, `LongPress`, `Pan`, `Swipe`, `Pinch`, and `Rotation` recognizers to any view via the `gestures=` prop — backed by `UIGestureRecognizer` on iOS and a unit-testable pure-Python arbiter on Android and desktop.
-- **Virtualized lists:** `FlatList` / `SectionList` window their rows in Python over the platform scroll view — uniform, exact, or measured variable heights, grids, headers/footers, infinite scroll, and an imperative scroll controller, identical on every platform.
+- **Native gesture system:** Attach `Tap`, `LongPress`, `Pan`, `Swipe`, `Pinch`, and `Rotation` recognizers to any view via the `gestures=` prop, backed by `UIGestureRecognizer` on iOS and a unit-testable pure-Python arbiter on Android and desktop.
+- **Virtualized lists:** `FlatList` / `SectionList` window their rows in Python over the platform scroll view: uniform, exact, or measured variable heights, grids, headers/footers, infinite scroll, and an imperative scroll controller, identical on every platform.
 - **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.
-- **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.
+- **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.
 - **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.
@@ -148,7 +148,7 @@ def App():
 
 ## Documentation
 
-Visit [docs.pythonnative.com](https://docs.pythonnative.com/) for the full documentation, including getting started guides, platform-specific instructions for Android and iOS, API reference, and working examples.
+Visit [pythonnative.com](https://pythonnative.com/) for the full documentation, including getting started guides, platform-specific instructions for Android and iOS, API reference, and working examples.
 
 ## Contributing
 

{pythonnative-0.22.0 → pythonnative-0.22.1}/README.md

@@ -12,13 +12,13 @@
   <a href="https://pypi.org/project/pythonnative/"><img src="https://img.shields.io/pypi/v/pythonnative" alt="PyPI Version" /></a>
   <a href="https://pypi.org/project/pythonnative/"><img src="https://img.shields.io/pypi/pyversions/pythonnative" alt="Python Versions" /></a>
   <a href="LICENSE"><img src="https://img.shields.io/pypi/l/pythonnative" alt="License: MIT" /></a>
-  <a href="https://docs.pythonnative.com/"><img src="https://img.shields.io/website?url=https%3A%2F%2Fdocs.pythonnative.com&label=docs" alt="Docs" /></a>
+  <a href="https://pythonnative.com/"><img src="https://img.shields.io/website?url=https%3A%2F%2Fpythonnative.com&label=docs" alt="Docs" /></a>
 </p>
 
 <p align="center">
-  <a href="https://docs.pythonnative.com/">Documentation</a> ·
-  <a href="https://docs.pythonnative.com/getting-started/">Getting Started</a> ·
-  <a href="https://docs.pythonnative.com/examples/">Examples</a> ·
+  <a href="https://pythonnative.com/">Documentation</a> ·
+  <a href="https://pythonnative.com/getting-started/">Getting Started</a> ·
+  <a href="https://pythonnative.com/examples/">Examples</a> ·
   <a href="CONTRIBUTING.md">Contributing</a>
 </p>
 
@@ -31,19 +31,19 @@ PythonNative is a cross-platform toolkit for building native Android and iOS app
 ## Features
 
 - **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.
+- **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.
 - **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.
+- **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.
 - **Native-driven animations:** The `Animated` API (timing / spring / decay, awaitable or fire-and-forget) hands animations to Core Animation and `ViewPropertyAnimator` whenever possible, so no Python code runs per frame; a pure-Python ticker covers the rest.
-- **Native gesture system:** Attach `Tap`, `LongPress`, `Pan`, `Swipe`, `Pinch`, and `Rotation` recognizers to any view via the `gestures=` prop — backed by `UIGestureRecognizer` on iOS and a unit-testable pure-Python arbiter on Android and desktop.
-- **Virtualized lists:** `FlatList` / `SectionList` window their rows in Python over the platform scroll view — uniform, exact, or measured variable heights, grids, headers/footers, infinite scroll, and an imperative scroll controller, identical on every platform.
+- **Native gesture system:** Attach `Tap`, `LongPress`, `Pan`, `Swipe`, `Pinch`, and `Rotation` recognizers to any view via the `gestures=` prop, backed by `UIGestureRecognizer` on iOS and a unit-testable pure-Python arbiter on Android and desktop.
+- **Virtualized lists:** `FlatList` / `SectionList` window their rows in Python over the platform scroll view: uniform, exact, or measured variable heights, grids, headers/footers, infinite scroll, and an imperative scroll controller, identical on every platform.
 - **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.
-- **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.
+- **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.
 - **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.
@@ -77,7 +77,7 @@ def App():
 
 ## Documentation
 
-Visit [docs.pythonnative.com](https://docs.pythonnative.com/) for the full documentation, including getting started guides, platform-specific instructions for Android and iOS, API reference, and working examples.
+Visit [pythonnative.com](https://pythonnative.com/) for the full documentation, including getting started guides, platform-specific instructions for Android and iOS, API reference, and working examples.
 
 ## Contributing
 

{pythonnative-0.22.0 → pythonnative-0.22.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pythonnative"
-version = "0.22.0"
+version = "0.22.1"
 description = "Cross-platform native UI toolkit for Android and iOS"
 authors = [
   { name = "Owen Carey" }
@@ -66,7 +66,8 @@ pn = "pythonnative.cli.pn:main"
 Homepage = "https://github.com/pythonnative/pythonnative"
 Repository = "https://github.com/pythonnative/pythonnative"
 Issues = "https://github.com/pythonnative/pythonnative/issues"
-Documentation = "https://docs.pythonnative.com/"
+Documentation = "https://pythonnative.com/"
+
 
 
 

{pythonnative-0.22.0 → pythonnative-0.22.1}/src/pythonnative/__init__.py

@@ -60,7 +60,7 @@ Example:
     ```
 """
 
-__version__ = "0.22.0"
+__version__ = "0.22.1"
 
 from . import gestures, runtime, sdk
 from .alerts import Alert

{pythonnative-0.22.0 → pythonnative-0.22.1}/src/pythonnative/animated.py

@@ -24,7 +24,7 @@ native view the value is attached to
 
 - **Accepted** (iOS Core Animation, Android ``ViewPropertyAnimator`` /
   ``DynamicAnimation``): the platform animates the property entirely
-  natively — no Python code runs per frame. Python receives exactly one
+  natively; no Python code runs per frame. Python receives exactly one
   callback when the animation settles, updates the
   [`AnimatedValue`][pythonnative.animated.AnimatedValue], and resolves
   any awaiting tasks.
@@ -135,7 +135,7 @@ class AnimatedValue:
     Animated components (``Animated.View`` et al.) **attach** the value
     to ``(tag, prop)`` bindings after mount. Setting the value pushes
     the new number to every attached native view through the registry's
-    ``set_animated_property`` — and when an animation can be driven
+    ``set_animated_property``, and when an animation can be driven
     natively, the platform animates those same bindings directly.
 
     Python-side listeners registered via
@@ -217,7 +217,7 @@ class AnimatedValue:
     def add_listener(self, prop: str, callback: Callable[[float], None]) -> Callable[[], None]:
         """Register ``callback`` for Python-driven changes to this value.
 
-        Returns an unsubscribe callable. ``prop`` is metadata only — it
+        Returns an unsubscribe callable. ``prop`` is metadata only; it
         lets the subscriber differentiate this binding from others on
         the same ``AnimatedValue``.
         """
@@ -686,7 +686,7 @@ class _AnimationHandle(_AwaitableAnimation):
 
     Each ``.start()`` call snapshots the value's current state, prefers
     the native driver, and falls back to a fresh Python-ticked
-    animation otherwise (matches React Native — the ``Animated.timing``
+    animation otherwise (matches React Native: the ``Animated.timing``
     return value is reusable).
     """
 
@@ -780,7 +780,7 @@ class _CompositeAnimation(_AwaitableAnimation):
         if item is None:
             return
         # ``_AwaitableAnimation`` and plain awaitables/coroutines are
-        # both supported — lets users mix in ``asyncio.sleep``.
+        # both supported: lets users mix in ``asyncio.sleep``.
         await item
 
 
@@ -824,7 +824,7 @@ def _make_animated_factory(
 
         # ``@component`` packs positional children into the ``children``
         # prop (this function declares ``*args``), and the reconciler
-        # re-invokes it with keyword props only — so at render time the
+        # re-invokes it with keyword props only, so at render time the
         # payload arrives in ``kwargs``, never in ``args``.
         children = list(args) or list(kwargs.pop("children", ()) or ())
 

{pythonnative-0.22.0 → pythonnative-0.22.1}/src/pythonnative/cli/pn.py

@@ -5,7 +5,7 @@ The console script `pn` (declared in `pyproject.toml`) dispatches to:
 - `pn init [name]`: scaffold a new project (``pythonnative.toml`` + ``app/``).
 - `pn doctor [platform]`: diagnose the local toolchain and config.
 - `pn preview [component]`: render the app in a desktop (Tkinter) window
-  with Fast Refresh — the fast inner dev loop, no device required.
+  with Fast Refresh, the fast inner dev loop, no device required.
 - `pn run android|ios`: stage + build + install + launch on a device or
   simulator, with optional on-device hot reload.
 - `pn build android|ios`: produce standalone artifacts (signed APK/AAB,

{pythonnative-0.22.0 → pythonnative-0.22.1}/src/pythonnative/components.py

@@ -1,7 +1,7 @@
 """Built-in element factories and the typed prop schemas they share.
 
-Each ``@dataclass(frozen=True)`` class in this module — ``TextProps``,
-``ButtonProps``, etc. — is the canonical schema for one built-in
+Each ``@dataclass(frozen=True)`` class in this module (``TextProps``,
+``ButtonProps``, etc.) is the canonical schema for one built-in
 component. Each factory function (``Text``, ``Button``, …) is a thin
 ergonomic wrapper that builds an [`Element`][pythonnative.Element]
 through the shared :func:`_make_element` helper, so style resolution,
@@ -827,7 +827,7 @@ def Spacer(
 
     Args:
         size: Fixed gap in dp/pt along the parent's main axis. Mirrored
-            on both axes — whichever axis the parent's
+            on both axes: whichever axis the parent's
             ``flex_direction`` chooses as main becomes the actual gap.
         flex: Flex-grow weight; useful for pushing siblings to the
             opposite end of a [`Row`][pythonnative.Row] or
@@ -912,14 +912,14 @@ def View(
     - ``flex_direction``: ``"column"`` (default), ``"row"``,
       ``"column_reverse"``, ``"row_reverse"``.
     - ``flex_wrap``: ``"nowrap"`` (default), ``"wrap"``,
-      ``"wrap_reverse"`` — with ``align_content`` controlling how
+      ``"wrap_reverse"``, with ``align_content`` controlling how
       wrapped lines share leftover cross-axis space.
     - ``justify_content``: main-axis distribution. Accepts
       ``"flex_start"`` (default), ``"center"``, ``"flex_end"``,
       ``"space_between"``, ``"space_around"``, ``"space_evenly"``.
     - ``align_items``: cross-axis alignment. Accepts ``"stretch"``
       (default), ``"flex_start"``, ``"center"``, ``"flex_end"``.
-    - ``direction``: ``"ltr"`` (default) or ``"rtl"`` — flips rows and
+    - ``direction``: ``"ltr"`` (default) or ``"rtl"``. Flips rows and
       resolves ``margin_start`` / ``padding_end`` / absolute ``start``
       / ``end`` insets.
     - ``overflow``: ``"visible"`` (default) or ``"hidden"``.
@@ -1061,7 +1061,7 @@ def ScrollView(
             wrapper (padding, alignment, spacing of the scrollable
             content), distinct from ``style`` (the scroll view frame).
         keyboard_dismiss_mode: ``"none"`` (default), ``"on_drag"``, or
-            ``"interactive"`` — controls whether scrolling dismisses
+            ``"interactive"``. Controls whether scrolling dismisses
             the keyboard.
         style: Style dict (or list of dicts).
         ref: Optional ``use_ref()`` dict.
@@ -1145,7 +1145,7 @@ def Modal(
         animation_type: ``"slide"`` (default), ``"fade"``, or ``"none"``.
         transparent: When ``True``, the underlying view is dimmed
             instead of fully covered.
-        presentation_style: iOS presentation style —
+        presentation_style: iOS presentation style,
             ``"page_sheet"`` (default), ``"form_sheet"``,
             ``"full_screen"``, or ``"overlay"`` (custom dimmed
             overlay). On Android, ``"overlay"`` keeps the dialog
@@ -1604,8 +1604,8 @@ def ErrorBoundary(
 # ======================================================================
 #
 # FlatList and SectionList are pure Python components, not native
-# elements. They render a windowed slice of rows into a ScrollView —
-# leading spacer, visible rows, trailing spacer — and shift the window
+# elements. They render a windowed slice of rows into a ScrollView
+# (leading spacer, visible rows, trailing spacer) and shift the window
 # from scroll events (the same architecture as React Native's
 # VirtualizedList). Because every windowed row lives in the *main*
 # layout tree, rows may be any height: estimates only steer the spacer
@@ -1872,7 +1872,7 @@ def FlatList(
     leading and trailing spacers stand in for everything else, and the
     window shifts as the user scrolls. Rows may have **variable
     heights**: pass ``item_height`` when rows are uniform,
-    ``get_item_height`` for exact per-item extents, or nothing at all —
+    ``get_item_height`` for exact per-item extents, or nothing at all;
     unknown rows start at ``estimated_item_height`` and are corrected
     with their measured extent once they've been on screen.
 
@@ -2040,7 +2040,7 @@ def SectionList(
 
     Flattens ``sections`` into a single virtualized sequence where each
     entry is either a header or an item, then reuses the same windowing
-    engine as [`FlatList`][pythonnative.FlatList] — headers and items
+    engine as [`FlatList`][pythonnative.FlatList]; headers and items
     may have different (and variable) heights.
 
     Args:
@@ -2177,7 +2177,7 @@ def StatusBar(
             ``"dark"`` (dark icons over light backgrounds), or
             ``"default"`` (system default).
         background_color: Color of the status-bar background (Android
-            only — iOS draws the bar transparent over your content).
+            only; iOS draws the bar transparent over your content).
         hidden: When ``True``, the status bar is hidden.
         key: Stable identity for keyed reconciliation.
 

{pythonnative-0.22.0 → pythonnative-0.22.1}/src/pythonnative/events.py

@@ -10,7 +10,7 @@ the bridge. This module replaces that with a single dispatch channel:
 - Handlers wire their platform listener **once** at view creation; the
   listener calls [`dispatch_event`][pythonnative.events.dispatch_event]
   with the view's tag and the event name.
-- Re-renders only mutate this Python-side registry — no native call is
+- Re-renders only mutate this Python-side registry; no native call is
   made when just a callback identity changes.
 
 The set of event names present on an element is forwarded to handlers
@@ -78,7 +78,7 @@ class EventRegistry:
 
         Returns:
             ``True`` when a callback existed and was invoked (even if
-            it raised — exceptions are swallowed so a buggy app
+            it raised: exceptions are swallowed so a buggy app
             callback can't crash the platform's UI thread), ``False``
             when nothing is registered.
         """
@@ -115,7 +115,7 @@ def dispatch_event(tag: int, name: str, *args: Any) -> bool:
 
     Args:
         tag: The view's reconciler-assigned tag.
-        name: Event name — the original prop name (``"on_click"``,
+        name: Event name, the original prop name (``"on_click"``,
             ``"on_change"``, …) or a gesture channel (``"gesture:0"``).
         *args: Positional arguments forwarded to the user callback,
             preserving each prop's documented signature.
@@ -144,8 +144,8 @@ def extract_events(props: Dict[str, Any]) -> Tuple[Dict[str, Any], Dict[str, Cal
     - ``gestures`` lists of gesture descriptors are serialized to plain
       dicts (handlers wire recognizers from them) while their callbacks
       are folded into per-gesture ``"gesture:<i>"`` routers.
-    - The resulting payload carries ``_pn_events`` — a frozenset of the
-      event names present — so handlers can wire listeners
+    - The resulting payload carries ``_pn_events`` (a frozenset of the
+      event names present), so handlers can wire listeners
       conditionally and the prop differ can detect listener
       addition/removal without comparing closures.
 

{pythonnative-0.22.0 → pythonnative-0.22.1}/src/pythonnative/gestures.py

@@ -351,7 +351,7 @@ def serialize_gestures(
 # guarantees identical semantics on both backends.
 
 EmitFn = Callable[[int, Dict[str, Any]], None]
-"""``emit(gesture_index, payload)`` — the arbiter's output channel."""
+"""``emit(gesture_index, payload)``: the arbiter's output channel."""
 
 
 class _VelocityTracker:
@@ -400,7 +400,7 @@ class _Recognizer:
     def kind(self) -> str:
         return str(self.config.get("kind", ""))
 
-    # Event hooks — ``pointers`` maps pointer id -> (x, y).
+    # Event hooks: ``pointers`` maps pointer id -> (x, y).
     def down(self, pointers: Dict[int, Tuple[float, float]], t: float) -> None:
         pass
 
@@ -805,7 +805,7 @@ class GestureArbiter:
 
     One arbiter serves one view. The host backend feeds it normalized
     pointer events (positions in the view's coordinate space, times in
-    seconds — any monotonic clock) and provides an ``emit`` callback
+    seconds, any monotonic clock) and provides an ``emit`` callback
     that forwards ``(gesture_index, payload)`` pairs to
     [`dispatch_event`][pythonnative.events.dispatch_event].
 

{pythonnative-0.22.0 → pythonnative-0.22.1}/src/pythonnative/hooks.py

@@ -613,7 +613,7 @@ def use_query(
     Args:
         fetcher: Zero-arg ``async`` callable that resolves to the
             current data.
-        deps: Dependency list — refetches whenever any entry changes.
+        deps: Dependency list. Refetches whenever any entry changes.
         initial: Optional starting value for ``data`` before the
             first fetch completes.
 
@@ -698,7 +698,7 @@ class MutationCall(Generic[T]):
     Returned by the second element of the
     [`use_mutation`][pythonnative.use_mutation] tuple. Awaiting the
     handle resolves to the mutator's return value (or re-raises its
-    exception); discarding the handle is safe — Python won't warn
+    exception); discarding the handle is safe. Python won't warn
     about an unawaited coroutine because this is a plain object.
 
     Example:
@@ -1068,7 +1068,7 @@ class NavigationHandle:
     Wraps the host's push/pop primitives so screens can navigate
     without knowing the underlying native navigation stack. The
     typical user-facing surface is the declarative handle returned by
-    a [`Stack`][pythonnative.create_stack_navigator] — this class is
+    a [`Stack`][pythonnative.create_stack_navigator]; this class is
     the lower-level fallback used when no navigator is rendered (and
     as the bridge that declarative navigators delegate to when they
     need to push real native screens).

{pythonnative-0.22.0 → pythonnative-0.22.1}/src/pythonnative/hot_reload.py

@@ -17,7 +17,7 @@ Two strategies share the device-side surface:
   the reconciler tree is walked and every component function whose
   module was reloaded is swapped in place. Hook state, navigation
   state, and even scroll positions survive because the underlying
-  ``VNode`` objects are reused — the next render simply calls the
+  ``VNode`` objects are reused; the next render simply calls the
   new function bodies through the old slots.
 - **Full remount**: when the in-place swap fails (e.g. the new
   module raised at import time, or a render exception bubbled out
@@ -197,8 +197,8 @@ class ModuleReloader:
 
     Designed to be invoked from device-side glue when a hot-reload
     push completes. All public methods are static; the class holds a
-    single piece of process-wide state — the manifest version that
-    has most recently been applied to ``sys.modules`` — so that
+    single piece of process-wide state (the manifest version that
+    has most recently been applied to ``sys.modules``) so that
     multiple screen hosts polling the same manifest do not each
     re-execute the user-app modules. The first host to see a new
     version pays the ``reload_modules`` cost; subsequent hosts on the
@@ -302,7 +302,7 @@ class ModuleReloader:
 
         Returns:
             The list of module names that are currently fresh in
-            ``sys.modules`` — either freshly reloaded by this call, or
+            ``sys.modules``, either freshly reloaded by this call, or
             already reloaded by an earlier host for the same version.
         """
         with ModuleReloader._reload_lock:

{pythonnative-0.22.0 → pythonnative-0.22.1}/src/pythonnative/layout.py

@@ -9,7 +9,7 @@ The engine is invoked by the reconciler after each commit pass:
 
 1. The reconciler maintains a parallel
    [`LayoutNode`][pythonnative.layout.LayoutNode] tree (cached across
-   passes — clean subtrees keep their nodes, dirty ones are rebuilt).
+   passes: clean subtrees keep their nodes, dirty ones are rebuilt).
 2. [`calculate_layout`][pythonnative.layout.calculate_layout] is called
    with the viewport size; it recursively determines each node's
    ``(x, y, width, height)`` relative to its parent's coordinate space.
@@ -618,7 +618,7 @@ def _measure_node(
     resolved_direction = _resolve_direction(style, direction)
 
     # Incremental-layout memo: a clean node measured under identical
-    # inputs reuses its previous result without recursing — its whole
+    # inputs reuses its previous result without recursing; its whole
     # subtree keeps the sizes from the prior pass.
     memo = node._measure_memo
     if (
@@ -863,7 +863,7 @@ def _layout_flex_children(
     their line's cross size. The computed line structure is stored on
     ``parent._lines`` for the positioning pass.
 
-    Returns ``(used_main, used_cross)`` — the total content size used
+    Returns ``(used_main, used_cross)``, the total content size used
     by the in-flow children, including inter-child gaps but excluding
     the parent's own padding. The caller adds padding back in for the
     container's outer size.

{pythonnative-0.22.0 → pythonnative-0.22.1}/src/pythonnative/mutations.py

@@ -49,7 +49,7 @@ class CreateOp:
     Attributes:
         tag: Unique integer identity assigned by the reconciler.
         type_name: Element type name (e.g. ``"Text"``).
-        props: Initial *clean* props — callables have already been
+        props: Initial *clean* props; callables have already been
             routed to the [`EventRegistry`][pythonnative.events.EventRegistry]
             and replaced by the ``_pn_events`` name set.
     """

{pythonnative-0.22.0 → pythonnative-0.22.1}/src/pythonnative/native_modules/camera.py

@@ -152,7 +152,7 @@ def _ios_launch_picker(on_result: Callable[[Optional[str]], None], source: str)
             _pending_delegates.pop(id(delegate), None)
             on_result(None)
 
-        # Reference SEL/objc_method so the lint pass keeps the import —
+        # Reference SEL/objc_method so the lint pass keeps the import;
         # they're needed for the delegate class above.
         _ = (SEL, objc_method)
     except Exception:

{pythonnative-0.22.0 → pythonnative-0.22.1}/src/pythonnative/native_modules/haptics.py

@@ -2,11 +2,11 @@
 
 Two interfaces live here:
 
-- [`Haptics`][pythonnative.Haptics] — semantic, iOS-style feedback
+- [`Haptics`][pythonnative.Haptics]: semantic, iOS-style feedback
   (impact / notification / selection) backed by
   ``UIFeedbackGenerator`` on iOS and ``VibrationEffect`` patterns on
   Android.
-- [`Vibration`][pythonnative.Vibration] — a blunt "buzz for N
+- [`Vibration`][pythonnative.Vibration]: a blunt "buzz for N
   milliseconds" interface for cases where you want an explicit
   duration.
 

{pythonnative-0.22.0 → pythonnative-0.22.1}/src/pythonnative/native_modules/location.py

@@ -167,7 +167,7 @@ def _android_get(on_result: Callable[[Optional[Coords]], None]) -> None:
         Context = jclass("android.content.Context")
         lm = ctx.getSystemService(Context.LOCATION_SERVICE)
 
-        # Try the most recent known fix first — it's instant and avoids
+        # Try the most recent known fix first; it's instant and avoids
         # the GPS warm-up delay.
         try:
             for provider in ("gps", "network", "passive"):

{pythonnative-0.22.0 → pythonnative-0.22.1}/src/pythonnative/native_modules/permissions.py

@@ -3,9 +3,9 @@
 [`Permissions`][pythonnative.Permissions] normalizes the very different
 iOS and Android permission models behind two calls:
 
-- ``check(permission)`` — synchronous, returns a status string without
+- ``check(permission)``: synchronous, returns a status string without
   prompting.
-- ``request(permission)`` — a coroutine that shows the system prompt
+- ``request(permission)``: a coroutine that shows the system prompt
   (if needed) and resolves to the resulting status.
 
 Statuses are ``"granted"``, ``"denied"``, ``"blocked"`` (denied with

{pythonnative-0.22.0 → pythonnative-0.22.1}/src/pythonnative/native_modules/secure_store.py

@@ -1,7 +1,7 @@
 """Encrypted key/value storage for secrets (tokens, credentials).
 
 [`SecureStore`][pythonnative.SecureStore] persists small string values
-in the iOS Keychain and Android ``EncryptedSharedPreferences`` — the
+in the iOS Keychain and Android ``EncryptedSharedPreferences``, the
 right place for auth tokens and other secrets that
 [`AsyncStorage`][pythonnative.AsyncStorage] (plain, unencrypted) should
 never hold.