Improve - Add range annotations & validation

[vectrixdevelops]

Overview

Description: Adds @Range annotations and validation to improve API clarity in some places. Values that fail validation will throw an exception.

---

Review Request Checklist

• [x] Your code follows the style guidelines of this project.
• [x] I have performed a self-review of my code.
• [x] I have tested this change myself. (If applicable)
• [x] I have made corresponding changes to the documentation. (If applicable)
• [x] The branch name follows the projects naming conventions. (e.g. feature/add-module & bugfix/fix-issue)

---