Add a extend-expect to globally require matchers

.changeset/giant-coats-confess.md

@@ -0,0 +1,5 @@
+---
+'@emotion/jest': minor
+---
+
+Add a `@emotion/jest/extend-expect` module to simplify adding matchers

packages/jest/README.md

@@ -215,6 +215,10 @@ test('renders with correct link styles', () => {
 })
 ```
 
+### Include custom matchers globally
+
+You can add the custom matchers globally by adding a `import '@emotion/jest/extend-expect` to a setupFilesAfterEnv script.
+
 ## Thanks
 
 Thanks to [Kent C. Dodds](https://twitter.com/kentcdodds) who wrote [jest-glamor-react](https://github.com/kentcdodds/jest-glamor-react) which this library is largely based on. ❤️

packages/jest/extend-expect/package.json

@@ -0,0 +1,5 @@
+{
+  "main": "dist/emotion-jest-extend-expect.cjs.js",
+  "module": "dist/emotion-jest-extend-expect.esm.js",
+  "types": "../types/index.d.ts"
+}

packages/jest/package.json

@@ -17,6 +17,10 @@
       "module": "./serializer/dist/emotion-jest-serializer.esm.js",
       "default": "./serializer/dist/emotion-jest-serializer.cjs.js"
     },
+    "./extend-expect": {
+      "module": "./extend-expect/dist/emotion-jest-extend-expect.esm.js",
+      "default": "./extend-expect/dist/emotion-jest-extend-expect.cjs.js"
+    },
     "./enzyme-serializer": {
       "module": "./enzyme-serializer/dist/emotion-jest-enzyme-serializer.esm.js",
       "default": "./enzyme-serializer/dist/emotion-jest-enzyme-serializer.cjs.js"
@@ -30,7 +34,8 @@
     "types/*.d.ts",
     "serializer",
     "enzyme",
-    "enzyme-serializer"
+    "enzyme-serializer",
+    "extend-expect"
   ],
   "scripts": {
     "test:typescript": "dtslint types"
@@ -86,7 +91,8 @@
       "./index.js",
       "./serializer.js",
       "./enzyme.js",
-      "./enzyme-serializer.js"
+      "./enzyme-serializer.js",
+      "./extend-expect.js"
     ]
   }
 }

packages/jest/src/extend-expect.d.ts

@@ -0,0 +1 @@
+import '../types'

packages/jest/src/extend-expect.js

@@ -0,0 +1,4 @@
+import { matchers } from './matchers'
+
+// eslint-disable-next-line no-undef
+expect.extend(matchers)