feat(typescript): Provide typescript definitions (#11)

* Provide typescript definitions

* Move typescript definitions to root dir

See #11 (comment)

* Add note about typescript caveat

Author: gnapse

README.md

@@ -46,7 +46,6 @@ to maintain.
   * [`toHaveTextContent`](#tohavetextcontent)
   * [`toHaveAttribute`](#tohaveattribute)
   * [`toHaveClass`](#tohaveclass)
-  * [Using with Typescript](#using-with-typescript)
 * [Inspiration](#inspiration)
 * [Other Solutions](#other-solutions)
 * [Guiding Principles](#guiding-principles)
@@ -84,6 +83,9 @@ import {toBeInTheDOM, toHaveClass} from 'jest-dom'
 expect.extend({toBeInTheDOM, toHaveClass})
 ```
 
+> Note: when using TypeScript, this way of importing matchers won't provide the
+> necessary type definitions. More on this [here](https://github.com/gnapse/jest-dom/pull/11#issuecomment-387817459).
+
 ## Custom matchers
 
 ### `toBeInTheDOM`
@@ -161,23 +163,6 @@ expect(getByTestId(container, 'delete-button')).not.toHaveClass('btn-link')
 // ...
 ```
 
-### Using with Typescript
-
-When you use custom Jest Matchers with Typescript, you can extend `jest.Matchers`
-interface provided by `@types/jest` package by creating `.d.ts` file somewhere
-in your project with following content:
-
-```typescript
-declare namespace jest {
-  interface Matchers<R> {
-    toHaveAttribute: (attr: string, value?: string) => R
-    toHaveTextContent: (htmlElement: string) => R
-    toHaveClass: (className: string) => R
-    toBeInTheDOM: () => R
-  }
-}
-```
-
 ## Inspiration
 
 This whole library was extracted out of Kent C. Dodds' [dom-testing-library][],

extend-expect.d.ts

@@ -0,0 +1,8 @@
+declare namespace jest {
+  interface Matchers<R> {
+    toHaveAttribute: (attr: string, value?: string) => R
+    toHaveTextContent: (text: string) => R
+    toHaveClass: (className: string) => R
+    toBeInTheDOM: () => R
+  }
+}

package.json

@@ -20,7 +20,8 @@
   },
   "files": [
     "dist",
-    "extend-expect.js"
+    "extend-expect.js",
+    "extend-expect.d.ts"
   ],
   "keywords": [
     "testing",