feat: change args for useThrottledCallback and useDebouncedCallback

[xobotyi]

useThrottledCallback and useDebouncedCallback has different arguments order comparing to useCallback (delay argument is before deps list). It is mentally harder to handle such differences.

BREAKING CHANGE:
delay and deps arguments are swapped position for useThrottledCallback and useDebouncedCallback hooks to be aligned with useCallback signature.

merge after #131

Checklist

• Have you read contribution guideline?
• Have you added an explanation of what your changes do and why you'd like us to include them?
• Is there an existing issue for this PR?
  • link issue here
• Have the files been linted and formatted?
• Have the docs been updated to match the changes in the PR?
• Have the tests been updated to match the changes in the PR?
• Have you run the tests locally to confirm they pass?

[codecov]

Codecov Report

Merging #132 (c383b58) into master (021d02a) will not change coverage.
The diff coverage is 100.00%.

@@            Coverage Diff             @@
##            master      #132    +/-   ##
==========================================
  Coverage   100.00%   100.00%            
==========================================
  Files           15        32    +17     
  Lines          111       543   +432     
  Branches        14       100    +86     
==========================================
+ Hits           111       543   +432     

Impacted Files	Coverage Δ
src/useFirstMountState/useFirstMountState.ts	100.00% <ø> (ø)
src/useIsMounted/useIsMounted.ts	100.00% <ø> (ø)
src/useMountEffect/useMountEffect.ts	100.00% <ø> (ø)
src/usePrevious/usePrevious.ts	100.00% <ø> (ø)
src/useUnmountEffect/useUnmountEffect.ts	100.00% <ø> (ø)
src/index.ts	100.00% <100.00%> (ø)
src/useAsync/useAsync.ts	100.00% <100.00%> (ø)
src/useConditionalEffect/useConditionalEffect.ts	100.00% <100.00%> (ø)
...ditionalUpdateEffect/useConditionalUpdateEffect.ts	100.00% <100.00%> (ø)
src/useCookieValue/useCookieValue.ts	100.00% <100.00%> (ø)
... and 40 more

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 600baa8...c383b58. Read the comment docs.

[JoeDuncko]

Actually, I think I'm less convinced that the dependency list shouldn't be the last argument. How do other libraries handle this?

Thinking about this more, I'm wondering if we should move to an options object here like lodash.

[xobotyi]

Disagree about options object, since is longer record:

useDebouncedEffect(()=>{}, [], 200, 600);

vs

useDebouncedEffect(()=>{}, [], { delay: 200, maxWait: 600 });

Options object is more obvious though, but most IDE highlight arguments so this should not be an issue.

If there would be more options - i would agree, but at leas for now, on my taste, arguments are better solution

[xobotyi]

How do other libraries handle this?

Have no idea, havent watched any other solutions =)

Ed: react-use have delay right after the function, but as you see i disagree with that.
IMO API should be aligned with react's useCallback

[JoeDuncko]

kk, you've convinced me. Until we have more args this should be fine.

[xobotyi]

🎉 This PR is included in version 3.0.0 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀