Add raygeo build tooling

- Add scripts/build-raygeo.sh for maturin wheel build/install
- Add raygeo-build, raygeo-check, raygeo-test pixi tasks
- Bump raygeo dependency to >=0.2.0
- Add patchelf to native dependencies
- Document raygeo section in AGENTS.md

Author: knipknap

AGENTS.md

@@ -8,6 +8,9 @@
    o `pixi run test`: Run backend tests
    o `pixi run uitest`: Run UI tests
    o `pixi run lint`. Performs linting and static code analysis
+   o `pixi run raygeo-check`: Check Raygeo changes before compilation
+   o `pixi run raygeo-build`: Build and install the raygeo Rust extension
+   o `pixi run raygeo-test`: Run raygeo tests
    o `pixi run print-untranslated list`: List languages with untranslated strings
    o `pixi run print-untranslated <lang>`: Print untranslated strings from po file
 
@@ -18,6 +21,12 @@
 - Never mark your changes with inline comments. Code is for clean, final implementation only
 - Retain exiting formatting, docstrings, and comments
 
+## Raygeo (Rust/PyO3 geometry library)
+
+- Location: a separate repository in `external/raygeo/` that you may also edit
+- All commands must be run via pixi from the workspace root
+- The pixi environment includes `maturin`, `cargo`, and `rustc` — never install these separately
+
 ## Other rules
 
 - Do not run the full test suite prematurely. Fix all linter errors first. Run targeted tests.

pixi.lock

@@ -31,9 +31,10 @@ PyOpenGL-accelerate = "==3.1.10"
 PyGObject = "==3.50.0"
 pkg-config = "*"
 rust = "*"
+patchelf = "*"
 
 [feature.app.pypi-dependencies]
-raygeo = "==0.1.9"
+raygeo = ">=0.2.0"
 rayforge = { editable = true, path = "." }
 aiohttp = "==3.13.5"
 asyncudp = "==0.11.0"
@@ -144,6 +145,15 @@ cmd = "scripts/with_gdk.sh scripts/screenshot/cli.py"
 cmd = "python3 -m build"
 depends-on = ["compile-translations"]
 
+[tasks.raygeo-build]
+cmd = "bash scripts/build-raygeo.sh"
+
+[tasks.raygeo-check]
+cmd = "cargo check --manifest-path external/raygeo/Cargo.toml"
+
+[tasks.raygeo-test]
+cmd = "cargo test --manifest-path external/raygeo/crates/raygeo/Cargo.toml && pytest -v external/raygeo/tests/"
+
 [tasks.build-deb]
 # Builds a binary .deb package for local installation and testing.
 cmd = "bash scripts/build-deb.sh"

pixi.toml

@@ -1,4 +1,4 @@
-raygeo==0.1.9
+raygeo>=0.2.0
 aiohttp==3.13.5
 asyncudp==0.11.0
 blinker==1.9.0

requirements.txt

@@ -0,0 +1,44 @@
+#!/bin/bash
+set -euo pipefail
+
+RAYGEO_DIR="external/raygeo"
+PYPROJECT="$RAYGEO_DIR/pyproject.toml"
+
+# Derive PEP 440 version from git describe.
+# Use .postN so the version sorts HIGHER than the PyPI release, ensuring
+# that uv/pip treats it as an upgrade over the published package.
+# Example: v0.2.0-1-gb7e8413 -> 0.2.0.post1+gb7e8413
+RAW=$(git -C "$RAYGEO_DIR" describe --tags --long --abbrev=7 2>/dev/null) || {
+    echo "Error: No git tags found in $RAYGEO_DIR" >&2
+    exit 1
+}
+PEP440=$(echo "$RAW" | sed -e 's/^v//' -e 's/-\([0-9]*\)-g/.post\1+g/')
+
+echo "Building raygeo wheel with version: $PEP440"
+
+# Temporarily set the version in pyproject.toml for maturin to pick up.
+# pyproject.toml takes precedence over Cargo.toml for maturin.
+sed -i "s/^dynamic = \[\"version\"\]/version = \"$PEP440\"/" "$PYPROJECT"
+
+# Restore on exit (even on failure).
+restore() {
+    sed -i "s/^version = \"$PEP440\"/dynamic = [\"version\"]/" "$PYPROJECT"
+}
+trap restore EXIT
+
+rm -rf "$RAYGEO_DIR/target"
+mkdir -p "$RAYGEO_DIR/target/wheels"
+touch "$RAYGEO_DIR/target/wheels/.gitkeep"
+maturin build --manifest-path "$RAYGEO_DIR/Cargo.toml" --release
+
+WHEEL=$(ls "$RAYGEO_DIR"/target/wheels/raygeo-*.whl)
+echo "Wheel built: $WHEEL"
+
+echo "Installing wheel into pixi environment..."
+pixi run uv pip install --no-cache --no-deps --force-reinstall "$WHEEL"
+
+# uv pip install does not reliably replace the .so file in the site-packages
+# directory. Extract it manually from the wheel to ensure the new binary
+# is used.
+SITE_PACKAGES=$(pixi run python -c "import site; print(site.getsitepackages()[0])")
+unzip -o "$WHEEL" raygeo/raygeo.abi3.so -d "$SITE_PACKAGES/"