feat: add typings for ts-jest options via transform config (#3805)

ahnpnl · web-flow · commit 664b0f2b446a · 2022-09-12T00:35:50.000+02:00
diff --git a/e2e/ast-transformers/hoist-jest/jest-isolated.config.js b/e2e/ast-transformers/hoist-jest/jest-isolated.config.js
@@ -1,4 +1,4 @@
-/** @type {import('../../../dist').InitialOptionsTsJest} */
+/** @type {import('../../../dist').JestConfigWithTsJest} */
 module.exports = {
   automock: true,
   moduleNameMapper: {
diff --git a/e2e/ast-transformers/transformer-options/jest-isolated.config.js b/e2e/ast-transformers/transformer-options/jest-isolated.config.js
@@ -1,4 +1,4 @@
-/** @type {import('../../../dist').InitialOptionsTsJest} */
+/** @type {import('../../../dist').JestConfigWithTsJest} */
 module.exports = {
   transform: {
     '^.+.[tj]sx?$': [
diff --git a/e2e/config-typing/jest.config.ts b/e2e/config-typing/jest.config.ts
@@ -1,6 +1,6 @@
-import type { InitialOptionsTsJest } from 'ts-jest'
+import type { JestConfigWithTsJest } from '../../dist'
 
-const jestCfg: InitialOptionsTsJest = {
+const jestCfg: JestConfigWithTsJest = {
   transform: {
     '^.+.tsx?$': [
       'ts-jest',
diff --git a/e2e/const-enum/jest-isolated.config.js b/e2e/const-enum/jest-isolated.config.js
@@ -1,4 +1,4 @@
-/** @type {import('../../dist').InitialOptionsTsJest} */
+/** @type {import('../../dist').JestConfigWithTsJest} */
 module.exports = {
   transform: {
     '^.+.tsx?$': [
diff --git a/e2e/coverage-report/jest-isolated.config.js b/e2e/coverage-report/jest-isolated.config.js
@@ -1,4 +1,4 @@
-/** @type {import('../../dist').InitialOptionsTsJest} */
+/** @type {import('../../dist').JestConfigWithTsJest} */
 module.exports = {
   collectCoverageFrom: ['**/*.js', '**/*.ts', '!**/node_modules/**', '!**/coverage/**'],
   transform: {
diff --git a/e2e/diagnostics/jest-disabled.config.js b/e2e/diagnostics/jest-disabled.config.js
@@ -1,4 +1,4 @@
-/** @type {import('../../dist').InitialOptionsTsJest} */
+/** @type {import('../../dist').JestConfigWithTsJest} */
 module.exports = {
   transform: {
     '^.+.tsx?$': [
diff --git a/e2e/diagnostics/jest-exclude.config.js b/e2e/diagnostics/jest-exclude.config.js
@@ -1,4 +1,4 @@
-/** @type {import('../../dist').InitialOptionsTsJest} */
+/** @type {import('../../dist').JestConfigWithTsJest} */
 module.exports = {
   transform: {
     '^.+.tsx?$': [
diff --git a/e2e/diagnostics/jest-ignored-code.config.js b/e2e/diagnostics/jest-ignored-code.config.js
@@ -1,4 +1,4 @@
-/** @type {import('../../dist').InitialOptionsTsJest} */
+/** @type {import('../../dist').JestConfigWithTsJest} */
 module.exports = {
   transform: {
     '^.+.tsx?$': [
diff --git a/e2e/diagnostics/jest-isolated.config.js b/e2e/diagnostics/jest-isolated.config.js
@@ -1,4 +1,4 @@
-/** @type {import('../../dist').InitialOptionsTsJest} */
+/** @type {import('../../dist').JestConfigWithTsJest} */
 module.exports = {
   transform: {
     '^.+.tsx?$': [
diff --git a/e2e/diagnostics/jest-warn.config.js b/e2e/diagnostics/jest-warn.config.js
@@ -1,4 +1,4 @@
-/** @type {import('../../dist').InitialOptionsTsJest} */
+/** @type {import('../../dist').JestConfigWithTsJest} */
 module.exports = {
   transform: {
     '^.+.tsx?$': [
diff --git a/e2e/enum/jest-isolated.config.js b/e2e/enum/jest-isolated.config.js
@@ -1,4 +1,4 @@
-/** @type {import('../../dist').InitialOptionsTsJest} */
+/** @type {import('../../dist').JestConfigWithTsJest} */
 module.exports = {
   transform: {
     '^.+.tsx?$': [
diff --git a/e2e/native-esm-ts/jest-isolated.config.js b/e2e/native-esm-ts/jest-isolated.config.js
@@ -1,4 +1,4 @@
-/** @type {import('../../dist').InitialOptionsTsJest} */
+/** @type {import('../../dist').JestConfigWithTsJest} */
 module.exports = {
   extensionsToTreatAsEsm: ['.ts'],
   resolver: '<rootDir>/mjs-resolver.ts',
diff --git a/e2e/source-map/disabled/jest-isolated.config.js b/e2e/source-map/disabled/jest-isolated.config.js
@@ -1,4 +1,4 @@
-/** @type {import('../../../dist').InitialOptionsTsJest} */
+/** @type {import('../../../dist').JestConfigWithTsJest} */
 module.exports = {
   displayName: 'sourcemap-disabled-isolated',
   roots: ['<rootDir>', '<rootDir>/../__tests__'],
diff --git a/e2e/source-map/disabled/jest.config.js b/e2e/source-map/disabled/jest.config.js
@@ -1,4 +1,4 @@
-/** @type {import('../../../dist').InitialOptionsTsJest} */
+/** @type {import('../../../dist').JestConfigWithTsJest} */
 module.exports = {
   displayName: 'sourcemap-disabled',
   roots: ['<rootDir>', '<rootDir>/../__tests__'],
diff --git a/e2e/source-map/enabled/jest-isolated.config.js b/e2e/source-map/enabled/jest-isolated.config.js
@@ -1,4 +1,4 @@
-/** @type {import('../../../dist').InitialOptionsTsJest} */
+/** @type {import('../../../dist').JestConfigWithTsJest} */
 module.exports = {
   displayName: 'sourcemap-enabled-isolated',
   roots: ['<rootDir>', '<rootDir>/../__tests__'],
diff --git a/e2e/source-map/enabled/jest.config.js b/e2e/source-map/enabled/jest.config.js
@@ -1,4 +1,4 @@
-/** @type {import('../../../dist').InitialOptionsTsJest} */
+/** @type {import('../../../dist').JestConfigWithTsJest} */
 module.exports = {
   displayName: 'sourcemap-enabled',
   roots: ['<rootDir>', '<rootDir>/../__tests__'],
diff --git a/e2e/transform-js/babel-cjs-file/jest.config.js b/e2e/transform-js/babel-cjs-file/jest.config.js
@@ -1,4 +1,4 @@
-/** @type {import('../../../dist').InitialOptionsTsJest} */
+/** @type {import('../../../dist').JestConfigWithTsJest} */
 module.exports = {
   displayName: 'babel-cjs-file',
   roots: ['<rootDir>', '<rootDir>/../__tests__/for-babel'],
diff --git a/e2e/transform-js/babel-enabled/jest.config.js b/e2e/transform-js/babel-enabled/jest.config.js
@@ -1,4 +1,4 @@
-/** @type {import('../../../dist').InitialOptionsTsJest} */
+/** @type {import('../../../dist').JestConfigWithTsJest} */
 module.exports = {
   displayName: 'babel-enabled',
   roots: ['<rootDir>', '<rootDir>/../__tests__/for-babel'],
diff --git a/e2e/transform-js/babel-js-file/jest.config.js b/e2e/transform-js/babel-js-file/jest.config.js
@@ -1,4 +1,4 @@
-/** @type {import('../../../dist').InitialOptionsTsJest} */
+/** @type {import('../../../dist').JestConfigWithTsJest} */
 module.exports = {
   displayName: 'babel-js-file',
   roots: ['<rootDir>', '<rootDir>/../__tests__/for-babel'],
diff --git a/e2e/transform-js/no-type-check/jest.config.js b/e2e/transform-js/no-type-check/jest.config.js
@@ -1,4 +1,4 @@
-/** @type {import('../../../dist').InitialOptionsTsJest} */
+/** @type {import('../../../dist').JestConfigWithTsJest} */
 module.exports = {
   displayName: 'no-type-check',
   roots: ['<rootDir>', '<rootDir>/../__tests__/for-ts'],
diff --git a/e2e/transform-js/type-check/jest.config.js b/e2e/transform-js/type-check/jest.config.js
@@ -1,4 +1,4 @@
-/** @type {import('../../../dist').InitialOptionsTsJest} */
+/** @type {import('../../../dist').JestConfigWithTsJest} */
 module.exports = {
   displayName: 'type-check',
   roots: ['<rootDir>', '<rootDir>/../__tests__/for-ts'],
diff --git a/e2e/transform-tsx/jest-isolated.config.js b/e2e/transform-tsx/jest-isolated.config.js
@@ -1,4 +1,4 @@
-/** @type {import('../../dist').InitialOptionsTsJest} */
+/** @type {import('../../dist').JestConfigWithTsJest} */
 module.exports = {
   testEnvironment: 'jsdom',
   transform: {
diff --git a/examples/js-with-babel/jest-esm-isolated.config.js b/examples/js-with-babel/jest-esm-isolated.config.js
@@ -1,4 +1,4 @@
-/** @type {import('ts-jest').InitialOptionsTsJest} */
+/** @type {import('ts-jest').JestConfigWithTsJest} */
 module.exports = {
   preset: 'ts-jest/presets/js-with-babel-esm',
   transform: {
diff --git a/examples/js-with-babel/jest-esm.config.js b/examples/js-with-babel/jest-esm.config.js
@@ -1,4 +1,4 @@
-/** @type {import('ts-jest').InitialOptionsTsJest} */
+/** @type {import('ts-jest').JestConfigWithTsJest} */
 module.exports = {
   preset: 'ts-jest/presets/js-with-babel-esm',
   transform: {
diff --git a/examples/js-with-babel/jest-isolated.config.js b/examples/js-with-babel/jest-isolated.config.js
@@ -1,4 +1,4 @@
-/** @type {import('ts-jest').InitialOptionsTsJest} */
+/** @type {import('ts-jest').JestConfigWithTsJest} */
 module.exports = {
   preset: 'ts-jest/presets/js-with-babel',
   transform: {
diff --git a/examples/js-with-babel/jest.config.js b/examples/js-with-babel/jest.config.js
@@ -1,4 +1,4 @@
-/** @type {import('ts-jest').InitialOptionsTsJest} */
+/** @type {import('ts-jest').JestConfigWithTsJest} */
 module.exports = {
   preset: 'ts-jest/presets/js-with-babel',
   transform: {
diff --git a/examples/js-with-ts/jest-esm-isolated.config.js b/examples/js-with-ts/jest-esm-isolated.config.js
@@ -1,4 +1,4 @@
-/** @type {import('ts-jest').InitialOptionsTsJest} */
+/** @type {import('ts-jest').JestConfigWithTsJest} */
 module.exports = {
   preset: 'ts-jest/presets/js-with-ts-esm',
   transform: {
diff --git a/examples/js-with-ts/jest-esm.config.js b/examples/js-with-ts/jest-esm.config.js
@@ -1,4 +1,4 @@
-/** @type {import('ts-jest').InitialOptionsTsJest} */
+/** @type {import('ts-jest').JestConfigWithTsJest} */
 module.exports = {
   preset: 'ts-jest/presets/js-with-ts-esm',
   transform: {
diff --git a/examples/js-with-ts/jest-isolated.config.js b/examples/js-with-ts/jest-isolated.config.js
@@ -1,4 +1,4 @@
-/** @type {import('ts-jest').InitialOptionsTsJest} */
+/** @type {import('ts-jest').JestConfigWithTsJest} */
 module.exports = {
   preset: 'ts-jest/presets/js-with-ts',
   transform: {
diff --git a/examples/js-with-ts/jest.config.js b/examples/js-with-ts/jest.config.js
@@ -1,4 +1,4 @@
-/** @type {import('ts-jest').InitialOptionsTsJest} */
+/** @type {import('ts-jest').JestConfigWithTsJest} */
 module.exports = {
   preset: 'ts-jest/presets/js-with-ts',
 }
diff --git a/examples/react-app/jest-esm-isolated.config.js b/examples/react-app/jest-esm-isolated.config.js
@@ -1,7 +1,7 @@
 const baseEsmCfg = require('./jest-esm.config')
 const baseCfg = require('./jest.config')
 
-/** @type {import('ts-jest').InitialOptionsTsJest} */
+/** @type {import('ts-jest').JestConfigWithTsJest} */
 module.exports = {
   ...baseEsmCfg,
   transform: {
diff --git a/examples/react-app/jest-esm.config.js b/examples/react-app/jest-esm.config.js
@@ -1,6 +1,6 @@
 const baseCfg = require('./jest.config')
 
-/** @type {import('ts-jest').InitialOptionsTsJest} */
+/** @type {import('ts-jest').JestConfigWithTsJest} */
 module.exports = {
   ...baseCfg,
   preset: 'ts-jest/presets/js-with-babel-esm',
diff --git a/examples/react-app/jest-isolated.config.js b/examples/react-app/jest-isolated.config.js
@@ -1,6 +1,6 @@
 const baseCfg = require('./jest.config')
 
-/** @type {import('ts-jest').InitialOptionsTsJest} */
+/** @type {import('ts-jest').JestConfigWithTsJest} */
 module.exports = {
   ...baseCfg,
   transform: {
diff --git a/examples/ts-only/jest-esm-isolated.config.js b/examples/ts-only/jest-esm-isolated.config.js
@@ -1,4 +1,4 @@
-/** @type {import('ts-jest').InitialOptionsTsJest} */
+/** @type {import('ts-jest').JestConfigWithTsJest} */
 module.exports = {
   preset: 'ts-jest/presets/default-esm',
   transform: {
diff --git a/examples/ts-only/jest-esm.config.js b/examples/ts-only/jest-esm.config.js
@@ -1,4 +1,4 @@
-/** @type {import('ts-jest').InitialOptionsTsJest} */
+/** @type {import('ts-jest').JestConfigWithTsJest} */
 module.exports = {
   preset: 'ts-jest/presets/default-esm',
   transform: {
diff --git a/examples/ts-only/jest-isolated.config.js b/examples/ts-only/jest-isolated.config.js
@@ -1,4 +1,4 @@
-/** @type {import('ts-jest').InitialOptionsTsJest} */
+/** @type {import('ts-jest').JestConfigWithTsJest} */
 module.exports = {
   preset: 'ts-jest',
   transform: {
diff --git a/examples/ts-only/jest.config.js b/examples/ts-only/jest.config.js
@@ -1,4 +1,4 @@
-/** @type {import('ts-jest').InitialOptionsTsJest} */
+/** @type {import('ts-jest').JestConfigWithTsJest} */
 module.exports = {
   preset: 'ts-jest',
 }
diff --git a/jest.config.js b/jest.config.js
@@ -1,4 +1,4 @@
-/** @type {import('./dist').InitialOptionsTsJest} */
+/** @type {import('./dist').JestConfigWithTsJest} */
 module.exports = {
   collectCoverageFrom: ['src/**/*.ts'],
   modulePathIgnorePatterns: ['examples/.*', 'website/.*'],
diff --git a/src/legacy/config/config-set.ts b/src/legacy/config/config-set.ts
@@ -27,7 +27,6 @@ import type {
   BabelJestTransformer,
   ProjectConfigTsJest,
   TsJestAstTransformer,
-  TsJestDiagnosticsCfg,
   TsJestGlobalOptions,
   TTypeScript,
 } from '../../types'
@@ -40,6 +39,14 @@ import { normalizeSlashes } from '../../utils/normalize-slashes'
 import { sha1 } from '../../utils/sha1'
 import { TSError } from '../../utils/ts-error'
 
+interface TsJestDiagnosticsCfg {
+  pretty: boolean
+  ignoreCodes: number[]
+  exclude: string[]
+  throws: boolean
+  warnOnly?: boolean
+}
+
 /**
  * @internal
  */
diff --git a/src/types.ts b/src/types.ts
@@ -26,9 +26,15 @@ declare module '@jest/types' {
  * @internal
  */
 export type TBabelCore = typeof _babel
+/**
+ * @internal
+ */
 export type TBabelJest = typeof babelJest
 export type TTypeScript = typeof _ts
 // Stimulate `esbuild` type to avoid import `esbuild` while building the assets which are shipped to npm
+/**
+ * @internal
+ */
 export interface TEsBuild {
   transformSync(
     input: string,
@@ -62,6 +68,9 @@ export interface ConfigCustomTransformer {
   afterDeclarations?: Array<string | AstTransformer>
 }
 
+/**
+ * @deprecated use `TsJestTransformerOptions` instead
+ */
 export interface TsJestGlobalOptions {
   /**
    * Compiler options. It can be:
@@ -156,67 +165,44 @@ export interface TsJestGlobalOptions {
   useESM?: boolean
 }
 
-interface TsJestConfig$tsConfig$file {
-  kind: 'file'
-  value: string | undefined
-}
-interface TsJestConfig$tsConfig$inline {
-  kind: 'inline'
-  value: _ts.CompilerOptions
-}
-type TsJestConfig$tsConfig = TsJestConfig$tsConfig$file | TsJestConfig$tsConfig$inline | undefined
-export interface TsJestDiagnosticsCfg {
-  pretty: boolean
-  ignoreCodes: number[]
-  exclude: string[]
-  throws: boolean
-  warnOnly?: boolean
-}
-interface TsJestConfig$babelConfig$file {
-  kind: 'file'
-  value: string | undefined
-}
-interface TsJestConfig$babelConfig$inline {
-  kind: 'inline'
-  value: BabelConfig
-}
-type TsJestConfig$babelConfig = TsJestConfig$babelConfig$file | TsJestConfig$babelConfig$inline | undefined
-/**
- * @internal
- */
-export interface TsJestConfig {
-  tsconfig: TsJestConfig$tsConfig
-  isolatedModules: boolean
-  compiler: string
-  diagnostics: TsJestDiagnosticsCfg
-  babelConfig: TsJestConfig$babelConfig
-  transformers: ConfigCustomTransformer
-  // to deprecate / deprecated === === ===
-  stringifyContentPathRegex: string | undefined
-}
-
 /**
  * For transformers which extends `ts-jest`
+ * @deprecated use `JestConfigWithTsJest` instead
  */
 export interface ProjectConfigTsJest extends Config.ProjectConfig {
   globals: GlobalConfigTsJest
 }
+/**
+ * @deprecated use `JestConfigWithTsJest` instead
+ */
 export interface TransformOptionsTsJest extends TransformOptions {
   config: ProjectConfigTsJest
 }
 
 /**
  * For typings in `jest.config.ts`
+ * @deprecated use `JestConfigWithTsJest` instead
  */
 export interface GlobalConfigTsJest extends Config.ConfigGlobals {
   'ts-jest': TsJestGlobalOptions
 }
+/**
+ * @deprecated use `JestConfigWithTsJest` instead
+ */
 export interface InitialOptionsTsJest extends Config.InitialOptions {
   globals?: GlobalConfigTsJest
 }
+type TsJestTransformerOptions = TsJestGlobalOptions
+export interface JestConfigWithTsJest extends Partial<Omit<Config.ProjectConfig, 'transform'>> {
+  transform: {
+    [regex: string]: 'ts-jest' | ['ts-jest', TsJestTransformerOptions] | string | [string, Record<string, unknown>]
+  }
+}
 
 export type StringMap = Map<string, string>
-
+/**
+ * @internal
+ */
 export interface DepGraphInfo {
   fileContent: string
   resolvedModuleNames: string[]
diff --git a/website/docs/getting-started/options.md b/website/docs/getting-started/options.md
@@ -47,7 +47,7 @@ module.exports = {
 To utilize IDE suggestions, you can use `JSDoc` comments to provide suggested `ts-jest` configs for your Jest config:
 
 ```js
-/** @type {import('ts-jest').InitialOptionsTsJest} */
+/** @type {import('ts-jest').JestConfigWithTsJest} */
 module.exports = config = {
   // [...]
   transform: {
@@ -67,9 +67,9 @@ Or through TypeScript (if `ts-node` is installed):
 
 ```ts
 // jest.config.ts
-import type { InitialOptionsTsJest } from 'ts-jest'
+import type { JestConfigWithTsJest } from 'ts-jest'
 
-const config: InitialOptionsTsJest = {
+const config: JestConfigWithTsJest = {
   transform: {
     '<regex_match_files>': [
       'ts-jest',
diff --git a/website/docs/getting-started/presets.md b/website/docs/getting-started/presets.md

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-/** @type {import('../../../dist').InitialOptionsTsJest} */`
	`1`	`+/** @type {import('../../../dist').JestConfigWithTsJest} */`
`2`	`2`	`module.exports = {`
`3`	`3`	`automock: true,`
`4`	`4`	`moduleNameMapper: {`