Add type hints to folder_paths.py

[PhilWun]

This PR adds type hints to function declarations and some variables in folder_paths.py to improve the developer experience. If its OK I would add type hints to more parts of the codebase in future PRs.