Annotate return types for better IDE code completion.

[hhslepicka]

What's the problem this feature will solve?
Adding the return types will make IDEs better provide users with autocomplete for methods and code in general.

Describe the solution you'd like
Types to be annotated where possible.

Additional context
Motivated by forum post https://community.botcity.dev/t/function-menu-select-error/646/2

[welli7ngton]

Hi there!

I'm currently working on this issue, and I wanted to get your thoughts before diving deeper.

Questions:
- Do you think annotating the entire bot.py file on the first attempt is too ambitious?
My concern is that it might be overwhelming without a clear strategy.
- Would creating interfaces for the classes in this file be a good idea?
I’m considering this to improve modularity and clarity.

If you have any advice or suggestions on where to start, I'd appreciate to hear them!

[hhslepicka]

@welli7ngton thank you for working on this issue.

As far as your questions:

• That would be great! As far as splitting the work to make it more manageable I would suggest maybe following the division we have in our documentation portal. This way we can review and merge your changes faster.
• No, please don't add interfaces for the classes. This is not a good idea for this particular case.

When contributing please make sure to:

• Use a feature/bug branch
• Use clear commit messages

Let me know if you have questions!
Feel free to join our Community Slack and send me and the team a message there if you prefer.

[welli7ngton]

Should we keep matching and grayscale optional?

• attention to grayscale and matching

what do you guys think about removing the optional annotation to just float, I got this warning when I try to call the cv2.locate_all_open_cv function

I asked because in the documentation there is a field saying that the argument must also be optional, before my changes the arguments were just name=default_value.

@hhslepicka