feat(config): Add unstable_advanceTimersWrapper

[eps1lon]

What:

Add unstable_advanceTimersWrapper config option

Why:

Required for backwards compatible support of concurrent rendering in React 18.
Example usage for fixing testing-library/react-testing-library#937:

diff --git a/src/pure.js b/src/pure.js
index a25000e..041e78e 100644
--- a/src/pure.js
+++ b/src/pure.js
@@ -20,6 +18,15 @@ configureDTL({
   },
 })
 
+if (typeof React.startTransition !== undefined) {
+  configureDTL({
+    advanceTimersWrapper: cb => {
+      return act(cb)
+    },
+    asyncWrapper: cb => cb(),
+  })
+}
+
 // Ideally we'd just use a WeakMap where containers are keys and roots are values.
 // We use two variables so that we can bail out in constant time when we render with a new container (most common use case)
 /**

How:

Wrap advancing timers for jest in getConfig.advanceTimersWrapper().

Checklist:

• [ ] Documentation added to the
  docs site
  No documentation yet.
• Tests
• TypeScript definitions updated
• Ready to be merged
  

[codecov]

Codecov Report

Merging #1022 (f35d8c1) into main (c7ba193) will not change coverage.
The diff coverage is 100.00%.

@@            Coverage Diff            @@
##              main     #1022   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files           25        25           
  Lines          916       920    +4     
  Branches       286       286           
=========================================
+ Hits           916       920    +4     

Flag	Coverage Δ
node-12	100.00% <100.00%> (ø)
node-14	100.00% <100.00%> (?)
node-16.9.1	100.00% <100.00%> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

Impacted Files	Coverage Δ
src/config.ts	100.00% <100.00%> (ø)
src/wait-for.js	100.00% <100.00%> (ø)

---

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 c7ba193...f35d8c1. Read the comment docs.

[codesandbox-ci]

This pull request is automatically built and testable in CodeSandbox.

To see build info of the built libraries, click here or the icon next to each commit SHA.

Latest deployment of this branch, based on commit f35d8c1:

Sandbox	Source
react-testing-library-examples	Configuration

[eps1lon]

Going to merge soon-ish to unblock an alpha release of testing-library/react-testing-library#937. It's behind an unstable prefix and not documented so it is safe to change the API freely.

[github-actions]

🎉 This PR is included in version 8.5.0 🎉

The release is available on:

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

Your semantic-release bot 📦🚀