Merge branch 'main' into react-18-upgrade

# Conflicts:
#	.github/workflows/validate.yml
#	package.json

Author: snowystinger

.all-contributorsrc

@@ -566,6 +566,24 @@
         "bug",
         "review"
       ]
+    },
+    {
+      "login": "snowystinger",
+      "name": "Robert Snow",
+      "avatar_url": "https://avatars.githubusercontent.com/u/698229?v=4",
+      "profile": "https://github.com/snowystinger",
+      "contributions": [
+        "test"
+      ]
+    },
+    {
+      "login": "chris110408",
+      "name": "Chris Chen",
+      "avatar_url": "https://avatars.githubusercontent.com/u/10645051?v=4",
+      "profile": "https://github.com/chris110408",
+      "contributions": [
+        "test"
+      ]
     }
   ],
   "skipCi": true,

.github/workflows/validate.yml

@@ -23,7 +23,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: 🛑 Cancel Previous Runs
-        uses: styfle/[email protected].0
+        uses: styfle/[email protected].1
 
       - name: ⬇️ Checkout repo
         uses: actions/checkout@v2
@@ -40,14 +40,14 @@ jobs:
         env:
           HUSKY_SKIP_INSTALL: true
 
-      - name: Use React version
-        run: npm install --save-dev react@"${{ matrix.react }}" react-dom@"${{ matrix.react }}" react-test-renderer@"${{ matrix.react }}"
+      - name: ⚛️ Use React version
+        run: REACT_VERSION=${{ matrix.react }} npm run install:react
 
       - name: ▶️ Run validate script
         run: npm run validate
 
       - name: ⬆️ Upload coverage report
-        uses: codecov/[email protected].1
+        uses: codecov/[email protected].2
 
   release:
     needs: main
@@ -58,7 +58,7 @@ jobs:
       github.event_name == 'push' }}
     steps:
       - name: 🛑 Cancel Previous Runs
-        uses: styfle/[email protected].0
+        uses: styfle/[email protected].1
 
       - name: ⬇️ Checkout repo
         uses: actions/checkout@v2

README.md

@@ -246,6 +246,8 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
     <td align="center"><a href="https://matan.io"><img src="https://avatars.githubusercontent.com/u/12711091?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Matan Borenkraout</b></sub></a><br /><a href="#maintenance-MatanBobi" title="Maintenance">🚧</a></td>
     <td align="center"><a href="https://github.com/andyrooger"><img src="https://avatars.githubusercontent.com/u/420834?v=4?s=100" width="100px;" alt=""/><br /><sub><b>andyrooger</b></sub></a><br /><a href="https://github.com/testing-library/react-hooks-testing-library/commits?author=andyrooger" title="Code">💻</a></td>
     <td align="center"><a href="https://github.com/bdwain"><img src="https://avatars.githubusercontent.com/u/3982094?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Bryan Wain</b></sub></a><br /><a href="https://github.com/testing-library/react-hooks-testing-library/issues?q=author%3Abdwain" title="Bug reports">🐛</a> <a href="https://github.com/testing-library/react-hooks-testing-library/pulls?q=is%3Apr+reviewed-by%3Abdwain" title="Reviewed Pull Requests">👀</a></td>
+    <td align="center"><a href="https://github.com/snowystinger"><img src="https://avatars.githubusercontent.com/u/698229?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Robert Snow</b></sub></a><br /><a href="https://github.com/testing-library/react-hooks-testing-library/commits?author=snowystinger" title="Tests">⚠️</a></td>
+    <td align="center"><a href="https://github.com/chris110408"><img src="https://avatars.githubusercontent.com/u/10645051?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Chris Chen</b></sub></a><br /><a href="https://github.com/testing-library/react-hooks-testing-library/commits?author=chris110408" title="Tests">⚠️</a></td>
   </tr>
 </table>
 

package.json

@@ -43,8 +43,10 @@
     "docs:dev": "docz dev",
     "docs:build": "docz build",
     "contributors:add": "all-contributors add",
-    "install-16": "npm install --save-dev react@\"^16.9.0\" react-dom@\"^16.9.0\" react-test-renderer@\"^16.9.0\"",
-    "install-next": "npm install --save-dev react@next react-dom@next react-test-renderer@next"
+    "install:react": "npm install --no-save react@${REACT_VERSION:-latest} react-dom@${REACT_VERSION:-latest} react-test-renderer@${REACT_VERSION:-latest}",
+    "install:react-16.9.0": "cross-env REACT_VERSION=16.9.0 npm run install:react",
+    "install:react-16": "cross-env REACT_VERSION=^16 npm run install:react",
+    "install:react-17": "cross-env REACT_VERSION=^17 npm run install:react"
   },
   "dependencies": {
     "@babel/runtime": "^7.12.5",
@@ -54,20 +56,22 @@
     "react-error-boundary": "^3.1.0"
   },
   "devDependencies": {
-    "@typescript-eslint/eslint-plugin": "^4.9.1",
-    "@typescript-eslint/parser": "^4.9.1",
+    "@typescript-eslint/eslint-plugin": "4.28.5",
+    "@typescript-eslint/parser": "4.28.5",
     "all-contributors-cli": "6.20.0",
     "codecov": "3.8.3",
+    "cross-env": "^7.0.3",
     "docz": "2.3.1",
     "docz-theme-default": "1.2.0",
     "docz-utils": "2.3.0",
-    "eslint": "7.31.0",
+    "eslint": "7.32.0",
+    "get-pkg-repo": "4.1.1",
     "kcd-scripts": "11.2.0",
-    "prettier": "^2.2.1",
+    "prettier": "2.3.2",
     "react": "17.0.2",
     "react-dom": "17.0.2",
     "react-test-renderer": "17.0.2",
-    "ts-node": "^10.0.0",
+    "ts-node": "10.1.0",
     "typescript": "4.3.5"
   },
   "peerDependencies": {

src/__tests__/asyncHook.fakeTimers.test.ts

@@ -0,0 +1,58 @@
+describe('async hook (fake timers) tests', () => {
+  beforeEach(() => {
+    jest.useFakeTimers()
+  })
+
+  afterEach(() => {
+    jest.useRealTimers()
+  })
+
+  runForRenderers(['default', 'dom', 'native', 'server/hydrated'], ({ renderHook }) => {
+    test('should wait for arbitrary expectation to pass when using advanceTimersByTime()', async () => {
+      const { waitFor } = renderHook(() => null)
+
+      let actual = 0
+      const expected = 1
+
+      setTimeout(() => {
+        actual = expected
+      }, 200)
+
+      let complete = false
+
+      jest.advanceTimersByTime(200)
+
+      await waitFor(() => {
+        expect(actual).toBe(expected)
+        complete = true
+      })
+
+      expect(complete).toBe(true)
+    })
+
+    test('should wait for arbitrary expectation to pass when using runOnlyPendingTimers()', async () => {
+      const { waitFor } = renderHook(() => null)
+
+      let actual = 0
+      const expected = 1
+
+      setTimeout(() => {
+        actual = expected
+      }, 200)
+
+      let complete = false
+
+      jest.runOnlyPendingTimers()
+
+      await waitFor(() => {
+        expect(actual).toBe(expected)
+        complete = true
+      })
+
+      expect(complete).toBe(true)
+    })
+  })
+})
+
+// eslint-disable-next-line jest/no-export
+export {}