User story

As a developer, I want the project to have full type annotations to improve IDE autocompletion, enhance code readability, and catch potential type-related bugs via static analysis.

Conditions of satisfaction

• Comprehensive type annotations implemented across the entire repository.
• Implementation uses modern Python 3.10+ syntax (e.g., | for Unions/Optional).
• Integration of numpy.typing for array-like structures.
• A py.typed marker file is included to support type checking for downstream users.
• Static type checking configuration via pyproject.toml is established to enforce consistency.

Acceptance tests

• mypy . passes successfully with no errors.
• Public API methods show correct type hints and return types in standard IDEs (VS Code/PyCharm).