docs: expose jest matchers publically (docs, examples, etc) (#1523)

* docs: update references to Jest Native

* chore: update docs

* chore: update example apps

* docs: update

* chore: upgrade example apps

* chore: self code review

* chore: docs tweaks

* docs: code review changes

.gitignore

@@ -16,6 +16,5 @@ build
 !.yarn/sdks
 !.yarn/versions
 
-# Ignore lock files in examples for now
-examples/**/yarn.lock
+# Docusaurus
 .docusaurus

README.md

@@ -50,27 +50,10 @@ This library has a `peerDependencies` listing for `react-test-renderer`. Make su
 
 ### Additional Jest matchers
 
-To use additional React Native-specific jest matchers from [@testing-library/jest-native](https://github.com/testing-library/jest-native) package add it to your project:
+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)):
 
-#### Using `yarn`
-
-```sh
-yarn add --dev @testing-library/jest-native
-```
-
-#### Using `npm`
-
-```sh
-npm install --save-dev @testing-library/jest-native
-```
-
-Then automatically add it to your jest tests by using the `setupFilesAfterEnv` option in your Jest configuration (it's usually located either in `package.json` under the `"jest"` key or in a `jest.config.json` file):
-
-```json
-{
-  "preset": "react-native",
-  "setupFilesAfterEnv": ["@testing-library/jest-native/extend-expect"]
-}
+```ts
+import '@testing-library/react-native/extend-expect';
 ```
 
 ### Custom Jest Preset (React Native before 0.71)

examples/basic/jest-setup.ts

@@ -1,7 +1,7 @@
 /* eslint-disable no-undef, import/no-extraneous-dependencies */
 
-// Import Jest Native matchers
-import '@testing-library/jest-native/extend-expect';
+// Import built-in Jest matchers
+import '@testing-library/react-native/extend-expect';
 
 // Silence the warning: Animated: `useNativeDriver` is not supported because the native animated module is missing
 jest.mock('react-native/Libraries/Animated/NativeAnimatedHelper');

examples/basic/package.json

@@ -19,8 +19,7 @@
   },
   "devDependencies": {
     "@babel/core": "^7.20.0",
-    "@testing-library/jest-native": "^5.4.3",
-    "@testing-library/react-native": "^12.3.2",
+    "@testing-library/react-native": "^12.3.3",
     "@types/react": "~18.2.14",
     "jest": "^29.7.0",
     "react-test-renderer": "18.2.0",