wtf is debounce?

Debounce is a small JavaScript utility that prevents a function from running too many times in quick succession. Instead of executing every time it's called, it waits until a specified amount of time has passed without any new calls before actually running. This is useful when something triggers frequently and you only care about the final action. The classic example is handling browser window resizing. Without any protection, a resize function might fire dozens of times per second as a user drags the edge of their browser window. With debounce, you wrap that function and set a delay of, say, 200 milliseconds. Now the function only runs once, 200ms after the user stops resizing. Each new call during the wait period resets the timer, so the function waits until things settle down. Anyone building a web interface where user actions fire repeatedly would find this handy. Beyond window resizing, common use cases include search boxes that query a server as you type, autosave features that should wait until you stop editing, and button clicks where you want to prevent accidental double-submissions. There's an "immediate" mode that runs the function right away on the first call rather than waiting, which is specifically designed to stop double-clicks on buttons. The tool also provides a few control methods on the wrapped function. You can check whether a delayed execution is still pending, cancel a scheduled run entirely, force it to execute immediately if one is waiting, or trigger it on demand while clearing any existing timer. The project is intentionally minimal and focused, doing one thing cleanly without extra complexity.