bugfix: TypeScript support for Jest now works in standalone projects

Author: oetr

README.md

@@ -98,6 +98,7 @@ following example:
 
 ```typescript
 // file: "Target.fuzz.ts"
+import "@jazzer.js/jest-runner";
 import * as target from "./target";
 
 describe("Target", () => {

docs/jest-integration.md

@@ -127,7 +127,7 @@ To introduce the `fuzz` function types globally, add the following import to
 `globals.d.ts`. This could also be done in the individual test files.
 
 ```typescript
-import "@jazzer.js/jest-runner/jest-extension";
+import "@jazzer.js/jest-runner";
 ```
 
 To provide accurate coverage reports for TypeScript fuzz tests, make sure to
@@ -224,12 +224,8 @@ describe("My describe", () => {
 After the setup mentioned previously, Jest fuzz tests can be written in
 TypeScript, just as one would expect.
 
-**Note**: To satisfy TypeScript's type checker, add an import of
-`@jazzer.js/jest-runner/jest-extension` in `globals.d.ts` or in the individual
-test file.
-
 ```typescript
-import "@jazzer.js/jest-runner/jest-extension";
+import "@jazzer.js/jest-runner";
 import * as target from "./target";
 
 describe("Target", () => {

examples/jest_typescript_integration/globals.d.ts

@@ -14,10 +14,7 @@
  * limitations under the License.
  */
 
-// Import the fuzz testing extension definition to compile TS code,
-// or import it globally in globals.d.ts, like in this example.
-// import "@jazzer.js/jest-runner/jest-extension";
-
+import "@jazzer.js/jest-runner";
 import * as target from "./target";
 
 describe("Target", () => {

examples/jest_typescript_integration/integration.fuzz.ts

@@ -14,22 +14,22 @@
  * limitations under the License.
  */
 
+import { loadConfig } from "./config";
+import { cleanupJestRunnerStack } from "./errorUtils";
+import { FuzzTest } from "./fuzz";
+import { JazzerWorker } from "./worker";
+import { registerGlobals, initFuzzing } from "@jazzer.js/core";
 import {
-	TestRunnerOptions,
-	Test,
-	TestRunnerContext,
-	TestWatcher,
 	CallbackTestRunner,
+	OnTestFailure,
 	OnTestStart,
 	OnTestSuccess,
-	OnTestFailure,
+	Test,
+	TestRunnerContext,
+	TestRunnerOptions,
+	TestWatcher,
 } from "jest-runner";
-
 import { Config } from "@jest/types";
-import { JazzerWorker } from "./worker";
-import { registerGlobals, initFuzzing } from "@jazzer.js/core";
-import { loadConfig } from "./config";
-import { cleanupJestRunnerStack } from "./errorUtils";
 import * as reports from "istanbul-reports";
 
 class FuzzRunner extends CallbackTestRunner {
@@ -97,3 +97,14 @@ class CancelRun extends Error {
 }
 
 export default FuzzRunner;
+
+// Global definition of the Jest fuzz test extension function.
+// This is required to allow the Typescript compiler to recognize it.
+declare global {
+	// eslint-disable-next-line @typescript-eslint/no-namespace
+	namespace jest {
+		interface It {
+			fuzz: FuzzTest;
+		}
+	}
+}

packages/jest-runner/index.ts

@@ -27,7 +27,6 @@ import { inspect } from "util";
 import { fuzz, FuzzerStartError, skip } from "./fuzz";
 import { cleanupJestRunnerStack, removeTopFramesFromError } from "./errorUtils";
 import { createScriptTransformer } from "@jest/transform";
-import "./jest-extension";
 
 function isGeneratorFunction(obj?: unknown): boolean {
 	return (

packages/jest-runner/jest-extension.ts

@@ -3,7 +3,7 @@
 		"statementMap": {
 			"0": {
 				"start": { "line": 17, "column": 0 },
-				"end": { "line": 17, "column": 47 }
+				"end": { "line": 17, "column": 32 }
 			},
 			"1": {
 				"start": { "line": 18, "column": 0 },

packages/jest-runner/worker.ts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import "@jazzer.js/jest-runner/jest-extension";
+import "@jazzer.js/jest-runner";
 import { fuzz } from "./fuzz.js";
 
 describe("My describe", () => {