pyxpo 0.1.0a1__tar.gz

pyxpo-0.1.0a1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vishal Chaubey
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pyxpo-0.1.0a1/MANIFEST.in

@@ -0,0 +1,12 @@
+include LICENSE README.md
+recursive-include src/pyxpo/templates *
+recursive-include src/pyxpo/_native *
+include src/pyxpo/build/runtime_manifest.json
+prune dist
+prune native
+prune .cache
+prune tests
+prune wheels
+prune examples
+prune packages
+global-exclude __pycache__ *.pyc .DS_Store

pyxpo-0.1.0a1/PKG-INFO

@@ -0,0 +1,136 @@
+Metadata-Version: 2.4
+Name: pyxpo
+Version: 0.1.0a1
+Summary: Python-first mobile app framework with React-style components and native widgets
+Author: Vishal Chaubey
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/pyxpo/pyxpo
+Project-URL: Issues, https://github.com/pyxpo/pyxpo/issues
+Keywords: mobile,android,ios,react-native,expo,python,ui,framework
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: User Interfaces
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: tomli>=2; python_version < "3.11"
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Dynamic: license-file
+
+# Pyxpo
+
+React-Native-style Python framework: declarative components + hooks -> reconciler -> batched JSON ops -> native widgets.
+See DESIGN.md (architecture) and PLAN.md (roadmap). Android and iOS are both supported.
+
+## Install
+```
+pip install pyxpo
+pyxpo create demo && cd demo
+pyxpo doctor            # check Xcode / Android SDK / Gradle
+pyxpo run android       # or: pyxpo run ios
+```
+The first mobile build downloads the prebuilt CPython runtime (about 20-60 MB per target) into `~/.cache/pyxpo`.
+
+## Develop pyxpo itself
+```
+tools/dev_install.sh    # .venv with core + every module package in packages/, all editable
+.venv/bin/pyxpo create demo && cd demo && ../.venv/bin/pyxpo run desktop   # type 1 + Enter to press the button, q to quit
+.venv/bin/pytest
+```
+
+A project is an `app/` folder of routes, like Expo Router:
+
+```
+app/
+  _layout.py        # Stack / Tabs / Drawer / Slot around the routes below
+  index.py          # "/"
+  details/[id].py   # "/details/7"   -> useLocalSearchParams()["id"]
+  +not-found.py     # unmatched URLs
+```
+
+```python
+# app/index.py
+from pyxpo import Button, Text, View, useState
+from pyxpo.router import Link
+
+def Index():
+    n, setN = useState(0)
+    return View(Text("Count: ", n), Button(title="Add", onPress=lambda: setN(n + 1)),
+                Link("Details", href="/details/%d" % n))
+
+default = Index
+```
+
+Hooks: use_state, use_effect, use_ref, use_memo, use_callback, use_context, use_async. Lists need `key=`.
+`pyxpo add-lib <pkg>` checks mobile wheel availability (note: full tensorflow/torch cannot run on mobile).
+
+## Native modules
+
+Features beyond the core are optional native modules, each its own pip package (like Expo's `expo-image-picker`).
+Only the modules an app lists are compiled into it.
+
+| Package | Import | `modules` entry |
+|---|---|---|
+| `pyxpo-file-system` | `from pyxpo_file_system import File, Directory, Paths` | `file-system` |
+| `pyxpo-image-manipulator` | `from pyxpo_image_manipulator import ImageManipulator` | `image-manipulator` |
+| `pyxpo-image-picker` | `from pyxpo_image_picker import ImagePicker` | `image-picker` |
+| `pyxpo-media-library` | `from pyxpo_media_library import MediaLibrary` | `media-library` |
+| `pyxpo-secure-store` | `import pyxpo_secure_store as SecureStore` | `secure-store` |
+| `pyxpo-sharing` | `from pyxpo_sharing import Share` | `sharing` |
+| `pyxpo-storage` | `from pyxpo_storage import storage` | `storage` |
+
+```
+pip install pyxpo-image-picker
+```
+```toml
+[tool.pyxpo]
+modules = ["image-picker"]
+```
+Their sources live in `packages/`; see each package's README. Third-party modules are pip packages that register a
+`pyxpo.modules` entry point the same way.
+
+## React Native style API
+Every RN spelling is an alias; the snake_case API keeps working. No JSX (not valid Python), so children are call arguments.
+
+```python
+from pyxpo import StyleSheet, View, Text, Pressable, FlatList, SectionList, useState, useEffect, component
+
+styles = StyleSheet.create(                      # or StyleSheet.create({"title": {...}})
+    title=dict(fontSize=24, fontWeight="bold", marginBottom=12),
+)
+
+@component
+def App():
+    count, setCount = useState(0)
+    useEffect(lambda: print("count", count), [count])
+    return View(
+        Text("Hello", style=styles.title),
+        Pressable(Text("+"), onPress=lambda: setCount(count + 1),
+                  style=lambda state: {"opacity": 0.5 if state.pressed else 1}),
+        FlatList(data=[1, 2], renderItem=lambda p: Text(p["item"]), keyExtractor=lambda i, _: i),
+    )
+```
+
+- Style keys and props accept camelCase (`backgroundColor`, `onPress`, `numberOfLines`, `placeholderTextColor`, `testID`). Giving both spellings of one prop raises `TypeError`. User components accept a camelCase key when its snake_case form is a parameter.
+- Hooks: `useState`, `useEffect`, `useLayoutEffect`, `useReducer`, `useRef`, `useMemo`, `useCallback`, `useContext`, `useId`, `useImperativeHandle`, `useSyncExternalStore`, `useTransition`, `useDeferredValue`. Effects are exception-safe: one failing effect or cleanup does not stop the others, errors go to `ErrorBoundary(on_error=...)` or `app.on_error`. Child effects run before parent effects. Effects must be sync functions (an `async def` effect runs as a task and warns).
+- `ErrorBoundary(*children, fallback=lambda error, reset: ...)`.
+- `FlatList` `renderItem` with one parameter gets `{"item", "index"}`; with two it gets `(item, index)`. `SectionList(sections=[{"title", "data"}], renderItem, renderSectionHeader)` (no sticky headers yet).
+- Modules: `Platform.OS`, `Dimensions.addEventListener("change", fn)` (returns an object with `.remove()`), `BackHandler.addEventListener("hardwareBackPress", fn)`, `Keyboard.addListener("keyboardDidShow", fn)`, `Linking.openURL`, `Alert.alert(title, msg, [{"text", "onPress"}])`.
+- RN style values that have no native equivalent (`borderStyle`, `tintColor`, `resizeMode`, ...) log a warning and are ignored. `Pressable` `hit_slop` and `delay_long_press` are accepted but not applied natively yet.
+- Example: `examples/rn_style`.
+
+## Routing (`pyxpo.router`, Expo Router)
+- Files under `app/` are routes: `index`, `[id]` (dynamic), `[...rest]` (catch-all), `(group)/` (no URL segment), `_layout.py` (navigator), `+not-found.py`. A route module exports `default` (or has a single `@component`).
+- Layouts: `Stack`, `Tabs`, `Drawer`, `Slot`; configure with `Stack.Screen(name=..., options={...})` or `screenOptions`. Options follow react-navigation (`title`, `headerShown`, `headerRight`, `tabBarIcon`, ...). A layout may export `unstable_settings = {"initialRouteName": ...}`.
+- `router.push/navigate/replace/back/dismiss/dismissAll/setParams`, `<Link href=...>`, `<Redirect href=...>`; hooks `useRouter`, `useLocalSearchParams`, `useGlobalSearchParams`, `usePathname`, `useSegments`, `useNavigation`, `useIsFocused`, `useFocusEffect`. Theme: `ThemeProvider`, `DefaultTheme`, `DarkTheme`, `useTheme`.
+- Android hardware back, the stack edge-swipe and the drawer all go through one navigation store. iOS Swift controls and the native stack are not ported yet.

pyxpo-0.1.0a1/README.md

@@ -0,0 +1,107 @@
+# Pyxpo
+
+React-Native-style Python framework: declarative components + hooks -> reconciler -> batched JSON ops -> native widgets.
+See DESIGN.md (architecture) and PLAN.md (roadmap). Android and iOS are both supported.
+
+## Install
+```
+pip install pyxpo
+pyxpo create demo && cd demo
+pyxpo doctor            # check Xcode / Android SDK / Gradle
+pyxpo run android       # or: pyxpo run ios
+```
+The first mobile build downloads the prebuilt CPython runtime (about 20-60 MB per target) into `~/.cache/pyxpo`.
+
+## Develop pyxpo itself
+```
+tools/dev_install.sh    # .venv with core + every module package in packages/, all editable
+.venv/bin/pyxpo create demo && cd demo && ../.venv/bin/pyxpo run desktop   # type 1 + Enter to press the button, q to quit
+.venv/bin/pytest
+```
+
+A project is an `app/` folder of routes, like Expo Router:
+
+```
+app/
+  _layout.py        # Stack / Tabs / Drawer / Slot around the routes below
+  index.py          # "/"
+  details/[id].py   # "/details/7"   -> useLocalSearchParams()["id"]
+  +not-found.py     # unmatched URLs
+```
+
+```python
+# app/index.py
+from pyxpo import Button, Text, View, useState
+from pyxpo.router import Link
+
+def Index():
+    n, setN = useState(0)
+    return View(Text("Count: ", n), Button(title="Add", onPress=lambda: setN(n + 1)),
+                Link("Details", href="/details/%d" % n))
+
+default = Index
+```
+
+Hooks: use_state, use_effect, use_ref, use_memo, use_callback, use_context, use_async. Lists need `key=`.
+`pyxpo add-lib <pkg>` checks mobile wheel availability (note: full tensorflow/torch cannot run on mobile).
+
+## Native modules
+
+Features beyond the core are optional native modules, each its own pip package (like Expo's `expo-image-picker`).
+Only the modules an app lists are compiled into it.
+
+| Package | Import | `modules` entry |
+|---|---|---|
+| `pyxpo-file-system` | `from pyxpo_file_system import File, Directory, Paths` | `file-system` |
+| `pyxpo-image-manipulator` | `from pyxpo_image_manipulator import ImageManipulator` | `image-manipulator` |
+| `pyxpo-image-picker` | `from pyxpo_image_picker import ImagePicker` | `image-picker` |
+| `pyxpo-media-library` | `from pyxpo_media_library import MediaLibrary` | `media-library` |
+| `pyxpo-secure-store` | `import pyxpo_secure_store as SecureStore` | `secure-store` |
+| `pyxpo-sharing` | `from pyxpo_sharing import Share` | `sharing` |
+| `pyxpo-storage` | `from pyxpo_storage import storage` | `storage` |
+
+```
+pip install pyxpo-image-picker
+```
+```toml
+[tool.pyxpo]
+modules = ["image-picker"]
+```
+Their sources live in `packages/`; see each package's README. Third-party modules are pip packages that register a
+`pyxpo.modules` entry point the same way.
+
+## React Native style API
+Every RN spelling is an alias; the snake_case API keeps working. No JSX (not valid Python), so children are call arguments.
+
+```python
+from pyxpo import StyleSheet, View, Text, Pressable, FlatList, SectionList, useState, useEffect, component
+
+styles = StyleSheet.create(                      # or StyleSheet.create({"title": {...}})
+    title=dict(fontSize=24, fontWeight="bold", marginBottom=12),
+)
+
+@component
+def App():
+    count, setCount = useState(0)
+    useEffect(lambda: print("count", count), [count])
+    return View(
+        Text("Hello", style=styles.title),
+        Pressable(Text("+"), onPress=lambda: setCount(count + 1),
+                  style=lambda state: {"opacity": 0.5 if state.pressed else 1}),
+        FlatList(data=[1, 2], renderItem=lambda p: Text(p["item"]), keyExtractor=lambda i, _: i),
+    )
+```
+
+- Style keys and props accept camelCase (`backgroundColor`, `onPress`, `numberOfLines`, `placeholderTextColor`, `testID`). Giving both spellings of one prop raises `TypeError`. User components accept a camelCase key when its snake_case form is a parameter.
+- Hooks: `useState`, `useEffect`, `useLayoutEffect`, `useReducer`, `useRef`, `useMemo`, `useCallback`, `useContext`, `useId`, `useImperativeHandle`, `useSyncExternalStore`, `useTransition`, `useDeferredValue`. Effects are exception-safe: one failing effect or cleanup does not stop the others, errors go to `ErrorBoundary(on_error=...)` or `app.on_error`. Child effects run before parent effects. Effects must be sync functions (an `async def` effect runs as a task and warns).
+- `ErrorBoundary(*children, fallback=lambda error, reset: ...)`.
+- `FlatList` `renderItem` with one parameter gets `{"item", "index"}`; with two it gets `(item, index)`. `SectionList(sections=[{"title", "data"}], renderItem, renderSectionHeader)` (no sticky headers yet).
+- Modules: `Platform.OS`, `Dimensions.addEventListener("change", fn)` (returns an object with `.remove()`), `BackHandler.addEventListener("hardwareBackPress", fn)`, `Keyboard.addListener("keyboardDidShow", fn)`, `Linking.openURL`, `Alert.alert(title, msg, [{"text", "onPress"}])`.
+- RN style values that have no native equivalent (`borderStyle`, `tintColor`, `resizeMode`, ...) log a warning and are ignored. `Pressable` `hit_slop` and `delay_long_press` are accepted but not applied natively yet.
+- Example: `examples/rn_style`.
+
+## Routing (`pyxpo.router`, Expo Router)
+- Files under `app/` are routes: `index`, `[id]` (dynamic), `[...rest]` (catch-all), `(group)/` (no URL segment), `_layout.py` (navigator), `+not-found.py`. A route module exports `default` (or has a single `@component`).
+- Layouts: `Stack`, `Tabs`, `Drawer`, `Slot`; configure with `Stack.Screen(name=..., options={...})` or `screenOptions`. Options follow react-navigation (`title`, `headerShown`, `headerRight`, `tabBarIcon`, ...). A layout may export `unstable_settings = {"initialRouteName": ...}`.
+- `router.push/navigate/replace/back/dismiss/dismissAll/setParams`, `<Link href=...>`, `<Redirect href=...>`; hooks `useRouter`, `useLocalSearchParams`, `useGlobalSearchParams`, `usePathname`, `useSegments`, `useNavigation`, `useIsFocused`, `useFocusEffect`. Theme: `ThemeProvider`, `DefaultTheme`, `DarkTheme`, `useTheme`.
+- Android hardware back, the stack edge-swipe and the drawer all go through one navigation store. iOS Swift controls and the native stack are not ported yet.

pyxpo-0.1.0a1/pyproject.toml

@@ -0,0 +1,54 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pyxpo"
+dynamic = ["version"]
+description = "Python-first mobile app framework with React-style components and native widgets"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Vishal Chaubey" }]
+keywords = ["mobile", "android", "ios", "react-native", "expo", "python", "ui", "framework"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Operating System :: MacOS",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: User Interfaces",
+    "Topic :: Software Development :: Libraries :: Application Frameworks",
+]
+requires-python = ">=3.9"
+dependencies = ["tomli>=2; python_version < '3.11'"]
+
+[project.optional-dependencies]
+dev = ["pytest"]
+
+[project.urls]
+Homepage = "https://github.com/pyxpo/pyxpo"
+Issues = "https://github.com/pyxpo/pyxpo/issues"
+
+[project.scripts]
+pyxpo = "pyxpo.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.dynamic]
+version = { attr = "pyxpo.__version__" }
+
+[tool.setuptools.package-data]
+pyxpo = ["templates/**/*", "_native/**/*", "build/runtime_manifest.json"]
+
+[tool.setuptools.exclude-package-data]
+"*" = ["__pycache__", "*.pyc"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

pyxpo-0.1.0a1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

pyxpo-0.1.0a1/src/pyxpo/__init__.py

@@ -0,0 +1,106 @@
+"""Pyxpo: React-Native-style mobile UI framework for Python.
+
+The top-level namespace mirrors `react-native` (components, APIs, hooks); routing lives in `pyxpo.router`
+(the `expo-router` equivalent) and icons in `pyxpo.vector_icons`.
+"""
+from __future__ import annotations
+
+import os as _os
+
+from .component import enable_registry as _enable_registry
+
+if _os.environ.get("PYXPO_DEV_URL"):
+    _enable_registry(True)  # keep Component identity across hot reloads; must run before app code
+
+from .animated import Animated, Easing, use_animated_value
+from .app import App, create_app, run_app
+from .channel import Channel, LocalChannel
+from .component import Component, ErrorBoundary, component, memo
+from .element import Element
+
+from .components.activity_indicator import ActivityIndicator
+from .components.button import Button
+from .components.image import Image, ImageBackground
+from .components.keyboard_avoiding_view import KeyboardAvoidingView
+from .components.lists import FlatList, SectionList, VirtualizedList
+from .components.modal import Modal
+from .components.picker import Picker
+from .components.pressable import Pressable
+from .components.refresh_control import RefreshControl
+from .components.safe_area_view import SafeAreaView
+from .components.scroll_view import ScrollView
+from .components.slider import Slider
+from .components.status_bar import StatusBar
+from .components.switch import Switch
+from .components.text import Text
+from .components.text_input import TextInput
+from .components.touchables import (TouchableHighlight, TouchableNativeFeedback, TouchableOpacity,
+                                    TouchableWithoutFeedback)
+from .components.view import View
+
+from .apis.alert import Alert
+from .apis.appearance import Appearance
+from .apis.appstate import AppState
+from .apis.back_handler import BackHandler
+from .apis.clipboard import Clipboard
+from .apis.dimensions import Dimensions
+from .apis.i18n_manager import I18nManager
+from .apis.keyboard import Keyboard
+from .apis.linking import Linking
+from .apis.pan_responder import PanResponder
+from .apis.pixel_ratio import PixelRatio
+from .apis.platform import Platform
+from .apis.toast_android import ToastAndroid
+from .apis.splash_screen import SplashScreen
+from .apis.constants import Constants
+from .apis.vibration import Vibration
+
+from .style import StyleSheet, processColor
+from .hooks import (HookError, createContext, create_context, use_async, use_callback, use_context, use_debug_value,
+                    use_deferred_value, use_effect, use_id, use_imperative_handle, use_layout_effect, use_memo,
+                    use_reducer, use_ref, use_state, use_sync_external_store, use_transition, use_color_scheme,
+                    use_safe_area_frame, use_safe_area_insets, use_window_dimensions, useAsync, useCallback, useColorScheme, useContext,
+                    useDebugValue, useDeferredValue, useEffect, useId, useImperativeHandle, useLayoutEffect, useMemo,
+                    useReducer, useRef, useSafeAreaFrame, useSafeAreaInsets, useState, useSyncExternalStore, useTransition,
+                    useWindowDimensions)
+
+useAnimatedValue = use_animated_value
+
+__version__ = "0.1.0a1"
+
+__all__ = [
+    # app
+    "App", "create_app", "run_app", "Channel", "LocalChannel", "Component", "component", "memo", "Element",
+    # components
+    "View", "Text", "TextInput", "Image", "ImageBackground", "ScrollView", "FlatList", "SectionList",
+    "VirtualizedList", "Pressable", "TouchableOpacity", "TouchableHighlight", "TouchableWithoutFeedback",
+    "TouchableNativeFeedback", "Button", "Switch", "ActivityIndicator", "Modal", "KeyboardAvoidingView",
+    "SafeAreaView", "StatusBar", "RefreshControl", "Picker", "Slider", "ErrorBoundary",
+    # apis
+    "Alert", "Animated", "Easing", "Appearance", "AppState", "BackHandler", "Clipboard", "Dimensions",
+    "I18nManager", "Keyboard", "Linking", "PanResponder", "PixelRatio", "Platform", "StyleSheet", "ToastAndroid",
+    "SplashScreen", "Constants", "Vibration", "processColor",
+    # hooks
+    "HookError", "createContext", "create_context", "use_async", "use_callback", "use_context", "use_debug_value",
+    "use_deferred_value", "use_effect", "use_id", "use_imperative_handle", "use_layout_effect", "use_memo",
+    "use_reducer", "use_ref", "use_state", "use_sync_external_store", "use_transition", "use_color_scheme",
+    "use_safe_area_frame", "use_safe_area_insets", "use_window_dimensions", "use_animated_value", "useAnimatedValue", "useAsync",
+    "useCallback", "useColorScheme", "useContext", "useDebugValue", "useDeferredValue", "useEffect", "useId",
+    "useImperativeHandle", "useLayoutEffect", "useMemo", "useReducer", "useRef", "useSafeAreaFrame", "useSafeAreaInsets", "useState",
+    "useSyncExternalStore", "useTransition", "useWindowDimensions",
+]
+
+
+_MOVED = {"Share": "sharing", "MediaLibrary": "media-library", "ImagePicker": "image-picker", "ImageManipulator": "image-manipulator",
+          "ImageTooLargeError": "image-manipulator"}
+
+
+def __getattr__(name: str):
+    if name in _MOVED:
+        mod = _MOVED[name]
+        raise AttributeError(
+            "pyxpo.%s moved to the optional native module package pyxpo-%s: run `pip install pyxpo-%s`, "
+            "add '%s' to [tool.pyxpo] modules in pyproject.toml, and use `from pyxpo_%s import %s`"
+            % (name, mod, mod, mod, mod.replace("-", "_"), name)
+        )
+    raise AttributeError("module 'pyxpo' has no attribute %r" % name)

pyxpo-0.1.0a1/src/pyxpo/__main__.py

@@ -0,0 +1,6 @@
+"""`python -m pyxpo` runs the CLI (native build scripts of ejected projects call it this way)."""
+import sys
+
+from .cli import main
+
+sys.exit(main())

pyxpo-0.1.0a1/src/pyxpo/_internal/modname.py

@@ -0,0 +1,15 @@
+"""Module naming shared by the router's route loader and the hot reloader."""
+from __future__ import annotations
+
+from typing import Optional
+
+
+def module_name_for(rel: str) -> Optional[str]:
+    """`app/(tabs)/[id].py` -> `app.(tabs).[id]`; `app/__init__.py` -> `app`. None for non-.py paths.
+
+    Names with brackets or parentheses are not importable with `import`; the router loads them by file path.
+    """
+    if not rel.endswith(".py"):
+        return None
+    name = rel[:-3].replace("/", ".")
+    return name[: -len(".__init__")] if name.endswith(".__init__") else name

pyxpo-0.1.0a1/src/pyxpo/_internal/svgpath.py

@@ -0,0 +1,117 @@
+"""SVG path data -> absolute move/line/cubic/close commands, which the native `Path` view replays."""
+from __future__ import annotations
+
+import math
+import re
+from typing import Any, Dict, List
+
+_TOKEN = re.compile(r"[MmLlHhVvCcSsQqAaZz]|[-+]?(?:\d*\.\d+|\d+\.?)(?:[eE][-+]?\d+)?")
+_ARGC = {"M": 2, "L": 2, "H": 1, "V": 1, "C": 6, "S": 4, "Q": 4, "A": 7, "Z": 0}
+
+
+def _arc(x1: float, y1: float, rx: float, ry: float, phi: float, fa: int, fs: int, x2: float, y2: float) -> List[List[float]]:
+    if rx == 0 or ry == 0 or (x1 == x2 and y1 == y2):
+        return [[1, x2, y2]]
+    rx, ry = abs(rx), abs(ry)
+    cp, sp = math.cos(math.radians(phi)), math.sin(math.radians(phi))
+    dx, dy = (x1 - x2) / 2, (y1 - y2) / 2
+    x1p, y1p = cp * dx + sp * dy, -sp * dx + cp * dy
+    lam = x1p ** 2 / rx ** 2 + y1p ** 2 / ry ** 2
+    if lam > 1:
+        s = math.sqrt(lam)
+        rx, ry = rx * s, ry * s
+    num = rx ** 2 * ry ** 2 - rx ** 2 * y1p ** 2 - ry ** 2 * x1p ** 2
+    den = rx ** 2 * y1p ** 2 + ry ** 2 * x1p ** 2
+    co = math.sqrt(max(0.0, num / den)) * (-1 if fa == fs else 1)
+    cxp, cyp = co * rx * y1p / ry, -co * ry * x1p / rx
+    cx, cy = cp * cxp - sp * cyp + (x1 + x2) / 2, sp * cxp + cp * cyp + (y1 + y2) / 2
+
+    def ang(ux: float, uy: float, vx: float, vy: float) -> float:
+        a = math.atan2(ux * vy - uy * vx, ux * vx + uy * vy)
+        return a
+
+    t1 = ang(1, 0, (x1p - cxp) / rx, (y1p - cyp) / ry)
+    dt = ang((x1p - cxp) / rx, (y1p - cyp) / ry, (-x1p - cxp) / rx, (-y1p - cyp) / ry)
+    if not fs and dt > 0:
+        dt -= 2 * math.pi
+    elif fs and dt < 0:
+        dt += 2 * math.pi
+    n = max(1, int(math.ceil(abs(dt) / (math.pi / 2) - 1e-9)))
+    step = dt / n
+    k = 4 / 3 * math.tan(step / 4)
+    out: List[List[float]] = []
+    t = t1
+    for _ in range(n):
+        c1, s1, c2, s2 = math.cos(t), math.sin(t), math.cos(t + step), math.sin(t + step)
+        p = [(c1 - k * s1), (s1 + k * c1), (c2 + k * s2), (s2 - k * c2), c2, s2]
+        pts = []
+        for i in range(0, 6, 2):
+            ux, uy = p[i] * rx, p[i + 1] * ry
+            pts += [cp * ux - sp * uy + cx, sp * ux + cp * uy + cy]
+        out.append([2] + pts)
+        t += step
+    out[-1][-2:] = [x2, y2]
+    return out
+
+
+def parse_path(d: str) -> List[List[float]]:
+    """SVG path data -> commands: [0,x,y] move, [1,x,y] line, [2,x1,y1,x2,y2,x,y] cubic, [3] close."""
+    toks = _TOKEN.findall(d)
+    out: List[List[float]] = []
+    i = 0
+    cmd = ""
+    x = y = sx = sy = 0.0
+    lcx = lcy = None  # last control point (for S)
+    prev = ""
+    while i < len(toks):
+        if toks[i].isalpha():
+            cmd = toks[i]
+            i += 1
+            if cmd in "Zz":
+                out.append([3])
+                x, y = sx, sy
+                prev = "Z"
+                continue
+        up = cmd.upper()
+        n = _ARGC[up]
+        a = [float(t) for t in toks[i:i + n]]
+        if len(a) < n:
+            break
+        i += n
+        rel = cmd.islower()
+        ox, oy = (x, y) if rel else (0.0, 0.0)
+        if up == "M":
+            x, y = a[0] + ox, a[1] + oy
+            sx, sy = x, y
+            out.append([0, x, y])
+            cmd = "l" if rel else "L"
+            prev = "M"
+            continue
+        if up == "L":
+            x, y = a[0] + ox, a[1] + oy
+            out.append([1, x, y])
+        elif up == "H":
+            x = a[0] + ox
+            out.append([1, x, y])
+        elif up == "V":
+            y = a[0] + oy
+            out.append([1, x, y])
+        elif up == "C":
+            c = [a[0] + ox, a[1] + oy, a[2] + ox, a[3] + oy, a[4] + ox, a[5] + oy]
+            out.append([2] + c)
+            lcx, lcy, x, y = c[2], c[3], c[4], c[5]
+        elif up == "S":
+            c1x, c1y = (2 * x - lcx, 2 * y - lcy) if prev == "C" and lcx is not None else (x, y)
+            c = [c1x, c1y, a[0] + ox, a[1] + oy, a[2] + ox, a[3] + oy]
+            out.append([2] + c)
+            lcx, lcy, x, y = c[2], c[3], c[4], c[5]
+        elif up == "Q":
+            qx, qy, ex, ey = a[0] + ox, a[1] + oy, a[2] + ox, a[3] + oy
+            out.append([2, x + 2 / 3 * (qx - x), y + 2 / 3 * (qy - y), ex + 2 / 3 * (qx - ex), ey + 2 / 3 * (qy - ey), ex, ey])
+            x, y = ex, ey
+        elif up == "A":
+            ex, ey = a[5] + ox, a[6] + oy
+            out.extend(_arc(x, y, a[0], a[1], a[2], int(a[3]), int(a[4]), ex, ey))
+            x, y = ex, ey
+        prev = up
+    return out

pyxpo-0.1.0a1/src/pyxpo/_keys.py

@@ -0,0 +1,53 @@
+"""camelCase -> snake_case name conversion shared by style keys and props (React Native spellings are aliases)."""
+from __future__ import annotations
+
+import re
+from typing import Any, Dict
+
+_SPLIT = re.compile(r"(?<=[a-z0-9])(?=[A-Z])|(?<=[A-Z])(?=[A-Z][a-z])")
+_SNAKE: Dict[str, str] = {}
+# names whose RN spelling does not follow the mechanical rule
+_OVERRIDES: Dict[str, str] = {"testID": "test_id", "nativeID": "native_id"}
+
+
+def to_snake(name: str) -> str:
+    """`fontSize` -> `font_size`; names that are already lower case pass through untouched."""
+    if name.islower():
+        return name
+    hit = _SNAKE.get(name)
+    if hit is None:
+        hit = _OVERRIDES.get(name) or _SPLIT.sub("_", name).lower()
+        if len(_SNAKE) > 4096:
+            _SNAKE.clear()
+        _SNAKE[name] = hit
+    return hit
+
+
+# RN prop names that map to a differently named pyxpo prop (everything else follows to_snake)
+PROP_OVERRIDES: Dict[str, str] = {
+    "placeholderTextColor": "placeholder_color", "returnKeyType": "return_key", "secureTextEntry": "secure",
+    "viewBox": "viewbox", "testID": "test_id", "nativeID": "native_id",
+}
+
+
+def prop_name(k: str) -> str:
+    return k if k.islower() else (PROP_OVERRIDES.get(k) or to_snake(k))
+
+
+def alias_props(props: Dict[str, Any]) -> Dict[str, Any]:
+    """Converts camelCase prop names to the snake_case ones. Giving both spellings raises like a duplicate kwarg."""
+    out: Dict[str, Any] = {}
+    for k, v in props.items():
+        n = prop_name(k)
+        if n in out or (n != k and n in props):
+            raise TypeError("got both %r and %r" % (k, n))
+        out[n] = v
+    return out
+
+
+def snake_aliases(cls: Any) -> Any:
+    """Gives every camelCase static method of `cls` a snake_case twin (`addEventListener` -> `add_event_listener`)."""
+    for name, val in list(vars(cls).items()):
+        if not name.startswith("_") and not name.islower() and isinstance(val, (staticmethod, classmethod)):
+            setattr(cls, to_snake(name), val)
+    return cls