Add Python type hints

[MikeWinkelmannXL2]

First off, thanks for this library! It has some very interesting concepts. As a Python user, I noticed that the lack of type hints makes the developer experience (IDE autocomplete, static analysis) a bit limited.

This PR addresses that by introducing type stubs for the Python bindings.

Changes:

• Added .pyi stub files to the Python API to enable IDE support and type checking.
• Included a utility script used to auto-generate these stubs.

Notes on the Utility Script: The generation script is included to ensure reproducibility. However, it currently has a few limitations:

• It assumes a .venv exists in the project directory.
• It is currently a standalone script. Ideally, this logic could be integrated directly into the build process (CMake or setup.py) in the future to ensure stubs are always up to date?