Add overloads for buffer handling

[MorningStarTM]

Relates to #1112

Changes proposed in this PR include:

• Added @overload type hints in buffer_handling.py to improve static typing and mypy inference.
• No runtime behavior changes; typing-only update.

Could you please pay extra attention to the points below when reviewing the PR:

• Please review the overload signatures in buffer_handling.py to confirm they match supported runtime inputs and outputs.

Checks

• Unit tests (pytest) passed locally
• If changes are related to CI/CD, are they verified via a manual run on this branch? (N/A)

[figueroa1395]

Hi @MorningStarTM and thanks for your contribution! I have triggered CI (maintainers have to manually activate it for new contributors) and I will assign you to this PR as well as add the respective labels.

On the other hand, I will also review the PR, of course :)

[MorningStarTM]

Thank you very much! Please let me know if any changes or adjustments are needed.

[figueroa1395]

The changes look good! However, CI (ruff) is complaining about formatting (imports), could you fix that, please?

On the other hand, I see other functions in this module could also use @overload; do you want/intend to fix those as well? It is also fine if this PR stays small, any improvements are welcome :)

[MorningStarTM]

Thanks for the feedback!
I’ll fix the ruff formatting issues and update the PR shortly.
I’ll let you know once it’s done.