Improve auto-generated documentation and type stubs (#1413)

* Improve auto-generated documentation and type stubs
-  Use `bytes` and `str | Path` where appropriate.
- Extend the type stub generation to generate the full enum definitions and define `Operation` and `Introspect`.
- Extend the type stub with more operations (all apart from nifti-based ones).

* Re-format `voperation.py` to satisfy flake8

* Fix two small typing issues that mypy found

* Improve the type stubs massively so that all examples now pass mypy and pyright
- Create a separate stub for `enums.py` to support importing these separately.
- Properly type the NumPy functions, which mypy and pyright ignore is NumPy is not available.
- Add the missing trigonometric, exponential, and complex operations.
- Force keyword arguments to be keyword arguments.
- Type `interpolate` as `Interpolate`, not the overly broad `GObject`.
- Introduce type aliases to reduce duplication.
- Make very minor adjustments elsewhere to avoid mypy errors.

* Add the missing libraries to `ci.yml`

* Switch to PyPy 3.11 for CI

* Switch to PyPy 3.10, which works on Ubuntu 22.04

Author: KurtBoehm

.github/workflows/ci.yml

@@ -11,7 +11,7 @@ jobs:
       matrix:
         # Only test supported Python versions:
         # https://endoflife.date/python
-        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14", "pypy3.9"]
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14", "pypy3.10"]
 
     steps:
       - name: Checkout code
@@ -36,11 +36,9 @@ jobs:
         run: |
           # Pin mypy to <1.19 due to librt dependency in 1.19+
           # which is not available on PyPy 3.9
-          pip install "mypy<1.19"
+          pip install "mypy<1.19" "numpy" "pillow" "requests" "types-requests"
           mypy pyvips/__init__.pyi --no-error-summary
-          mypy examples/affine.py examples/convolve.py examples/try5.py examples/watermark.py \
-                examples/annotate-animation.py examples/join-animation.py examples/progress.py \
-                --no-error-summary
+          mypy examples/*.py --no-error-summary
 
       - name: Install tox and any other packages
         run: pip install tox