feat: automatically extend matchers (#1684)

README.md

@@ -44,11 +44,7 @@ This library has a `peerDependencies` listing for `react-test-renderer`. Make su
 
 ### Additional Jest matchers
 
-You can use the built-in Jest matchers by adding the following line to your `jest-setup.ts` file (configured using [`setupFilesAfterEnv`](https://jestjs.io/docs/configuration#setupfilesafterenv-array)):
-
-```ts
-import '@testing-library/react-native/extend-expect';
-```
+You can use the built-in Jest matchers automatically by having any import from `@testing-library/react-native` in your test.
 
 ## Example
 

jest-setup.ts

@@ -1,5 +1,4 @@
 import { resetToDefaults } from './src/pure';
-import './src/matchers/extend-expect';
 
 beforeEach(() => {
   resetToDefaults();

matchers.d.ts

@@ -0,0 +1 @@
+export * from './build/matchers';

matchers.js

@@ -0,0 +1,2 @@
+// makes it so people can import from '@testing-library/react-native/pure'
+module.exports = require('./build/matchers');

package.json

@@ -38,8 +38,8 @@
   "files": [
     "build/",
     "jest-preset/",
-    "extend-expect.js",
-    "extend-expect.d.ts",
+    "matchers.js",
+    "matchers.d.ts",
     "pure.js",
     "pure.d.ts",
     "dont-cleanup-after-each.js",

src/index.ts

@@ -1,6 +1,7 @@
 import { cleanup } from './pure';
 import { flushMicroTasks } from './flush-micro-tasks';
 import { getIsReactActEnvironment, setReactActEnvironment } from './act';
+import './matchers/extend-expect';
 
 if (!process?.env?.RNTL_SKIP_AUTO_CLEANUP) {
   // If we're running in a test runner that supports afterEach

src/matchers/__tests__/to-be-checked.test.tsx

@@ -1,7 +1,6 @@
 import React from 'react';
 import { type AccessibilityRole, Switch, View } from 'react-native';
-import render from '../../render';
-import { screen } from '../../screen';
+import { render, screen } from '../..';
 
 function renderViewsWithRole(role: AccessibilityRole) {
   render(

src/matchers/__tests__/to-be-partially-checked.test.tsx

@@ -1,7 +1,6 @@
 import React from 'react';
 import { type AccessibilityRole, View } from 'react-native';
-import render from '../../render';
-import { screen } from '../../screen';
+import { render, screen } from '../..';
 
 function renderViewsWithRole(role: AccessibilityRole) {
   return render(