Update comparison methods to support BigInt (#44368)

As per jestjs/jest#8382

TypeScript 3.2+ supports BigInt with esnext target.
TypeScript 3.8+ supports it with es2020 target.

dtslint is very particular on how the `typesVersions`
should be handled, hence the code duplication.

types/jest/package.json

@@ -3,5 +3,9 @@
     "dependencies": {
         "jest-diff": "^25.2.1",
         "pretty-format": "^25.2.1"
+    },
+    "types": "index",
+    "typesVersions": {
+        ">=3.2.0-0": { "*": ["ts3.2/*"] }
     }
 }

types/jest/ts3.2/index.d.ts

@@ -0,0 +1,23 @@
+// tslint:disable-next-line:no-bad-reference
+/// <reference path="../index.d.ts" />
+
+declare namespace jest {
+    interface Matchers<R, T = {}> {
+        /**
+         * For comparing numbers or big integer values.
+         */
+        toBeGreaterThan(expected: number | bigint): R;
+        /**
+         * For comparing numbers or big integer values.
+         */
+        toBeGreaterThanOrEqual(expected: number | bigint): R;
+        /**
+         * For comparing numbers or big integer values.
+         */
+        toBeLessThan(expected: number | bigint): R;
+        /**
+         * For comparing numbers or big integer values.
+         */
+        toBeLessThanOrEqual(expected: number | bigint): R;
+    }
+}

types/jest/ts3.2/jest-tests.ts

@@ -0,0 +1,13 @@
+/* Basic matchers */
+
+describe('', () => {
+    it('', () => {
+        expect(BigInt(0)).toBeGreaterThan(BigInt(1));
+
+        expect(BigInt(0)).toBeGreaterThanOrEqual(BigInt(1));
+
+        expect(BigInt(0)).toBeLessThan(BigInt(1));
+
+        expect(BigInt(0)).toBeLessThanOrEqual(BigInt(1));
+    });
+});

types/jest/ts3.2/tsconfig.json

@@ -0,0 +1,20 @@
+{
+    "compilerOptions": {
+        "module": "commonjs",
+        "lib": ["dom", "es6", "esnext", "es2020"],
+        "noImplicitAny": true,
+        "noImplicitThis": false,
+        "strictNullChecks": true,
+        "strictFunctionTypes": true,
+        "baseUrl": "../../",
+        "typeRoots": ["../../"],
+        "target": "esnext",
+        "types": [],
+        "noEmit": true,
+        "forceConsistentCasingInFileNames": true
+    },
+    "files": [
+        "index.d.ts",
+        "jest-tests.ts"
+    ]
+}

types/jest/ts3.2/tslint.json

@@ -0,0 +1,6 @@
+{
+    "extends": "dtslint/dt.json",
+    "rules": {
+        "no-unnecessary-generics": false
+    }
+}