Merge remote-tracking branch 'origin/main' into alpha

# Conflicts:
#	README.md
#	docs/rules/await-fire-event.md
#	docs/rules/no-render-in-lifecycle.md
#	docs/rules/prefer-wait-for.md
#	lib/rules/await-fire-event.ts
#	tests/__snapshots__/index.test.ts.snap
#	tests/index.test.ts
#	tests/lib/rules/await-fire-event.test.ts

Author: Belco90

.all-contributorsrc

@@ -544,6 +544,36 @@
         "code",
         "test"
       ]
+    },
+    {
+      "login": "NickBolles",
+      "name": "Nick Bolles",
+      "avatar_url": "https://avatars.githubusercontent.com/u/7891759?v=4",
+      "profile": "https://nickbolles.com",
+      "contributions": [
+        "code",
+        "test",
+        "doc"
+      ]
+    },
+    {
+      "login": "bmish",
+      "name": "Bryan Mishkin",
+      "avatar_url": "https://avatars.githubusercontent.com/u/698306?v=4",
+      "profile": "http://www.linkedin.com/in/bmish",
+      "contributions": [
+        "doc",
+        "tool"
+      ]
+    },
+    {
+      "login": "theredspoon",
+      "name": "Nim G",
+      "avatar_url": "https://avatars.githubusercontent.com/u/20975696?v=4",
+      "profile": "https://github.com/theredspoon",
+      "contributions": [
+        "doc"
+      ]
     }
   ],
   "contributorsPerLine": 7,

.github/pull_request_template.md

@@ -1,8 +1,6 @@
 ## Checks
 
 - [ ] I have read the [contributing guidelines](https://github.com/testing-library/eslint-plugin-testing-library/blob/main/CONTRIBUTING.md).
-- [ ] If some rule is added/updated/removed, I've regenerated the rules list (`npm run generate:rules-list`)
-- [ ] If some rule meta info is changed, I've regenerated the plugin shared configs (`npm run generate:configs`)
 
 ## Changes
 

.github/workflows/pipeline.yml

@@ -21,7 +21,7 @@ jobs:
 
     steps:
       - name: Cancel Previous Runs
-        uses: styfle/cancel-workflow-action@0.10.1
+        uses: styfle/cancel-workflow-action@0.11.0
 
       - name: Checkout
         uses: actions/checkout@v3
@@ -45,6 +45,9 @@ jobs:
       - name: Check format
         run: npm run format:check
 
+      - name: Check autogenerated docs
+        run: npm run docs:gen && npm run format && git diff --exit-code
+
   tests:
     name: Tests (Node v${{ matrix.node }} - ESLint v${{ matrix.eslint }})
     runs-on: ubuntu-latest
@@ -56,7 +59,7 @@ jobs:
 
     steps:
       - name: Cancel Previous Runs
-        uses: styfle/cancel-workflow-action@0.10.1
+        uses: styfle/cancel-workflow-action@0.11.0
 
       - name: Checkout
         uses: actions/checkout@v3
@@ -88,7 +91,7 @@ jobs:
 
     steps:
       - name: Cancel Previous Runs
-        uses: styfle/cancel-workflow-action@0.10.1
+        uses: styfle/cancel-workflow-action@0.11.0
 
       - name: Checkout
         uses: actions/checkout@v3

.gitpod.yml

@@ -0,0 +1,2 @@
+tasks:
+  - init: npm install

README.md

@@ -1,5 +1,9 @@
 # Enforce promises from async queries to be handled (`testing-library/await-async-queries`)
 
+💼 This rule is enabled in the following configs: `angular`, `dom`, `marko`, `react`, `vue`.
+
+<!-- end auto-generated rule header -->
+
 Ensure that promises returned by async queries are handled properly.
 
 ## Rule Details
@@ -19,6 +23,7 @@ problems in the tests. The promise will be considered as handled when:
 - wrapped within `Promise.all` or `Promise.allSettled` methods
 - chaining the `then` method
 - chaining `resolves` or `rejects` from jest
+- chaining `toResolve()` or `toReject()` from [jest-extended](https://github.com/jest-community/jest-extended#promise)
 - it's returned from a function (in this case, that particular function will be analyzed by this rule too)
 
 Examples of **incorrect** code for this rule:
@@ -90,6 +95,12 @@ expect(findByTestId('alert')).resolves.toBe('Success');
 expect(findByTestId('alert')).rejects.toBe('Error');
 ```
 
+```js
+// using a toResolve/toReject matcher is also correct
+expect(findByTestId('alert')).toResolve();
+expect(findByTestId('alert')).toReject();
+```
+
 ```js
 // sync queries don't need to handle any promise
 const element = getByRole('role');

docs/rules/await-async-queries.md

@@ -1,4 +1,8 @@
-# Enforce promises from async utils to be handled (`testing-library/await-async-utils`)
+# Enforce promises from async utils to be awaited properly (`testing-library/await-async-utils`)
+
+💼 This rule is enabled in the following configs: `angular`, `dom`, `marko`, `react`, `vue`.
+
+<!-- end auto-generated rule header -->
 
 Ensure that promises returned by async utils are handled properly.
 
@@ -20,6 +24,7 @@ problems in the tests. The promise will be considered as handled when:
 - wrapped within `Promise.all` or `Promise.allSettled` methods
 - chaining the `then` method
 - chaining `resolves` or `rejects` from jest
+- chaining `toResolve()` or `toReject()` from [jest-extended](https://github.com/jest-community/jest-extended#promise)
 - it's returned from a function (in this case, that particular function will be analyzed by this rule too)
 
 Examples of **incorrect** code for this rule:
@@ -85,6 +90,12 @@ test('something correctly', async () => {
 		waitFor(() => getByLabelText('email')),
 		waitForElementToBeRemoved(() => document.querySelector('div.getOuttaHere')),
 	]);
+
+	// Using jest resolves or rejects
+	expect(waitFor(() => getByLabelText('email'))).resolves.toBeUndefined();
+
+	// Using jest-extended a toResolve/toReject matcher is also correct
+	expect(waitFor(() => getByLabelText('email'))).toResolve();
 });
 ```
 

docs/rules/await-async-utils.md

@@ -1,4 +1,6 @@
-# Enforces consistent naming for the data-testid attribute (`testing-library/consistent-data-testid`)
+# Ensures consistent usage of `data-testid` (`testing-library/consistent-data-testid`)
+
+<!-- end auto-generated rule header -->
 
 Ensure `data-testid` values match a provided regex. This rule is un-opinionated, and requires configuration.
 

docs/rules/consistent-data-testid.md

@@ -1,5 +1,7 @@
 # Disallow unnecessary `await` for sync events (`testing-library/no-await-sync-events`)
 
+<!-- end auto-generated rule header -->
+
 Ensure that sync simulated events are not awaited unnecessarily.
 
 ## Rule Details

docs/rules/no-await-sync-events.md

@@ -1,5 +1,9 @@
 # Disallow unnecessary `await` for sync queries (`testing-library/no-await-sync-queries`)
 
+💼 This rule is enabled in the following configs: `angular`, `dom`, `marko`, `react`, `vue`.
+
+<!-- end auto-generated rule header -->
+
 Ensure that sync queries are not awaited unnecessarily.
 
 ## Rule Details