docs(useDefault): Suggest useMediatedState instead

[AndreasNel]

What new hook does?

It works like useSafeState, except it will return the provided default value when the state is set to undefined or null.

Checklist

• Have you read contribution guideline?
• Does the code have comments in hard-to-understand areas?
• Is there an existing issue for this PR?
  • Port remaining hooks from react-use #33
• Have the files been linted and formatted?
• Have the docs been updated?
• Have the tests been added to cover new hook?
• Have you run the tests locally to confirm they pass?

[xobotyi]

TBH i dont think we need that hook since it is easily (and versatile) achievable via useMediatedState hook.

@JoeDuncko WDYT?

[JoeDuncko]

I wonder if we should have a cookbook of common hooks that can be easily derived from our hooks, or something like that.

Maybe as examples in Storybook?

I know that doesn't exactly answer the question though.

[xobotyi]

I've been thinking about that too (cookbook). Maybe separte page near migration and reference in mugration like we dont have this hook implemented directly as it can be easily achieved via other hook, and here is example link.

[AndreasNel]

Yeah a cookbook sounds good, do you want me to create such a page? Or would you prefer doing it?

[JoeDuncko]

Yeah a cookbook sounds good, do you want me to create such a page? Or would you prefer doing it?

Sorry for the slow reply. If you know your way around Storybook, go for it! I'm still new to Storybook, so I'd have to figure out the best way to present alternative examples. Ideas welcome.

[AndreasNel]

Apologies for leaving this for so long, life kind of got in the way and this got away from me. Please check if the documentation suggestion is correct.

[xobotyi]

LGTM, merging after all check passed.

[codecov]

Codecov Report

Merging #562 (9311a17) into master (409a21f) will not change coverage.
The diff coverage is n/a.

@@            Coverage Diff            @@
##            master      #562   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files           50        50           
  Lines          865       865           
  Branches       162       162           
=========================================
  Hits           865       865           

---

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 9f8c615...9311a17. Read the comment docs.

[xobotyi]

🎉 This PR is included in version 13.3.0 🎉

The release is available on:

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

Your semantic-release bot 📦🚀