fix: debounce cancel() should clear pending timeout

[adamhamlin]

Tip

The owner of this PR can publish a preview release by commenting /publish in this PR. Afterwards, anyone can try it out by running pnpm add radashi@pr<PR_NUMBER>.

Summary

This PR changes the behavior of a debounced function's cancel() method:

BEFORE: Calling cancel() preempts any pending invocation and permanently makes all future invocations execute immediately (i.e., not be debounced)
AFTER: Calling cancel() cancels/clears any pending invocation. Subsequent invocations are debounced as normal.

Related issue, if any:

Closes #105

For any code change,

• Related documentation has been updated, if needed
• Related tests have been added or updated, if needed
• Related benchmarks have been added or updated, if needed

Does this PR introduce a breaking change?

Yes

@aleclarson sounds like we're considering this a "bug", so not sure we'd do anything other than make a note in release notes? Please advise

Bundle impact

Calculating...

[aleclarson]

Looks like we fixed this at the same time: #107. Sorry for the communication fail on my part.

I will add Co-Authored-By: + you to that PR to show appreciation for your work here. ✌️

Lastly, I'll be treating this as a breaking change, since its old behavior was documented.

[adamhamlin]

Looks like we fixed this at the same time: #107. Sorry for the communication fail on my part.

No worries, I didn't communicate either. I would've just assigned the issue to myself, but I don't have the perms. Do you wanna go that route for deconfliction? Or just claim the issue by commenting on it? Something else?

[aleclarson]

Sorry @adamhamlin, I somehow missed your reply!

I would've just assigned the issue to myself, but I don't have the perms. Do you wanna go that route for deconfliction? Or just claim the issue by commenting on it? Something else?

Oh darn, I figured adding you to the team would give you such permissions. You should have them now, though, as well as some others.

[adamhamlin]

Oh darn, I figured adding you to the team would give you such permissions. You should have them now, though, as well as some others.

All good. And thanks, I do have assignment perms now. Tho the link you posted is a 404 for me