Refactor debounce detection to provide granular debounce state information

[lonesometraveler]

This pull request enhances the detect_change_with_debounce function by introducing granular debounce state information. The function now returns DebounceState enums representing various states of the debounce process, providing more detailed feedback on the key's behavior.