Add type stubs for IDE support and update README

[Sarxzer]

This pull request adds .pyi type stub files to enhance IDE support for the library. These stubs provide type hints and docstrings for all classes and methods, making development easier and more efficient in editors like VS Code