Add type hinting to public-facing API  in pandas/core/generic.py #26792
- [x] Part of #26792
- [x] tests passed
- [x] passes `black pandas`
- [x] passes `git diff upstream/master -u -- "*.py" | flake8 --diff`