ENHANCEMENT: Add comprehensive type hints throughout codebase

# 🎯 Problem

Programming challenge.

## Steps
1. Understand
2. Plan
3. Code
4. Test

## Requirements
- [ ] Solution works
- [ ] Clean code

## Resources
[LeetCode](https://leetcode.com/)

---
**Contribute!** 🚀