feat: export ts-jest public apis from index.js (#3080)

Closes #3045 

DEPRECATION
* Import internal `ts-jest` stuffs from `ts-jest/<sub_path>` is discouraged. Users should switch to `import <name> from 'ts-jest'` instead.

* Deprecation import path `import <name> from 'ts-jest/utils'`. Users should switch to `import <name> from 'ts-jest'` instead.

Author: ahnpnl

.github/workflows/ci.yml

@@ -75,7 +75,7 @@ jobs:
       - name: Install and build
         run: npm ci
       - name: Run tests with coverage
-        run: npm run test-ci -- --coverage && cat ./coverage/lcov.info
+        run: npm run test -- --coverage && cat ./coverage/lcov.info
         env:
           CI: true
       - name: Coveralls parallel

.gitignore

@@ -45,14 +45,8 @@ jspm_packages
 .idea
 .cache
 
-# tests specific
-tests/simple-long-path/long-src-path
 # is linked to the temp dir of the os
-e2e/__workdir_synlink__
-**/.ts-jest-e2e.json
 .ts-jest-digest
-# while refactoring...
-old/
 
 # binaries
 *.tgz

.npmignore

@@ -26,6 +26,7 @@ jest-base.js
 
 # Tsconfig
 tsconfig.build.json
+tsconfig.eslint.json
 tsconfig.json
 tsconfig.spec.json
 

e2e/__tests__/ast-transformers.test.ts

@@ -3,9 +3,7 @@ import path from 'path'
 import execa from 'execa'
 
 import { json as runWithJson } from '../run-jest'
-import { runNpmInstall } from '../utils'
-
-const { createBundle } = require('../../scripts/lib/bundle')
+import { runNpmInstall, tsJestBundle } from '../utils'
 
 const AST_TRANSFORMERS_DIR_NAME = 'ast-transformers'
 
@@ -35,8 +33,7 @@ describe('path-mapping', () => {
 
     beforeAll(() => {
       runNpmInstall(DIR)
-      const bundle = createBundle()
-      execa.sync('npm', ['install', '--no-package-lock', '--no-shrinkwrap', '--no-save', bundle], {
+      execa.sync('npm', ['install', '--no-package-lock', '--no-shrinkwrap', '--no-save', tsJestBundle], {
         cwd: DIR,
       })
     })
@@ -69,8 +66,7 @@ describe('hoist-jest', () => {
 
     beforeAll(() => {
       runNpmInstall(DIR)
-      const bundle = createBundle()
-      execa.sync('npm', ['install', '--no-package-lock', '--no-shrinkwrap', '--no-save', bundle], {
+      execa.sync('npm', ['install', '--no-package-lock', '--no-shrinkwrap', '--no-save', tsJestBundle], {
         cwd: DIR,
       })
     })

e2e/__tests__/config-typing.test.ts

@@ -1,7 +1,18 @@
+import path from 'path'
+
+import execa from 'execa'
+
 import { json as runWithJson } from '../run-jest'
+import { tsJestBundle } from '../utils'
 
 const DIR_NAME = 'config-typing'
 
+beforeAll(() => {
+  execa.sync('npm', ['install', '--no-package-lock', '--no-shrinkwrap', '--no-save', tsJestBundle], {
+    cwd: path.join(__dirname, '..', DIR_NAME),
+  })
+})
+
 test(`successfully runs the tests inside ${DIR_NAME}`, () => {
   const { json } = runWithJson(DIR_NAME)
 

e2e/__tests__/test-utils.test.ts

@@ -1,7 +1,18 @@
+import path from 'path'
+
+import execa from 'execa'
+
 import { json as runWithJson } from '../run-jest'
+import { tsJestBundle } from '../utils'
 
 const DIR_NAME = 'test-utils'
 
+beforeAll(() => {
+  execa.sync('npm', ['install', '--no-package-lock', '--no-shrinkwrap', '--no-save', tsJestBundle], {
+    cwd: path.join(__dirname, '..', DIR_NAME),
+  })
+})
+
 test(`successfully runs the tests inside ${DIR_NAME}`, () => {
   const { json } = runWithJson(DIR_NAME, undefined, {
     stripAnsi: true,

e2e/ast-transformers/hoist-jest/non-ts-factory/jest-isolated.config.js

@@ -1,4 +1,4 @@
-/** @type {import('../../../dist/types').InitialOptionsTsJest} */
+/** @type {import('../../../../dist').InitialOptionsTsJest} */
 module.exports = {
   automock: true,
   globals: {

e2e/ast-transformers/hoist-jest/ts-factory/jest-isolated.config.js

@@ -1,4 +1,4 @@
-/** @type {import('../../../dist/types').InitialOptionsTsJest} */
+/** @type {import('../../../../dist').InitialOptionsTsJest} */
 module.exports = {
   automock: true,
   globals: {

e2e/ast-transformers/path-mapping/ts-4.5+/jest-isolated.config.js

@@ -1,4 +1,4 @@
-/** @type {import('../../../../dist/types').InitialOptionsTsJest} */
+/** @type {import('../../../../dist').InitialOptionsTsJest} */
 module.exports = {
   globals: {
     'ts-jest': {

e2e/ast-transformers/path-mapping/ts-4.5-/jest-isolated.config.js

@@ -1,4 +1,4 @@
-/** @type {import('../../../../dist/types').InitialOptionsTsJest} */
+/** @type {import('../../../../dist').InitialOptionsTsJest} */
 module.exports = {
   globals: {
     'ts-jest': {

e2e/ast-transformers/transformer-in-ts/package-lock.json

@@ -1,4 +1,4 @@
-/** @type {import('../../../dist/types').InitialOptionsTsJest} */
+/** @type {import('../../../dist').InitialOptionsTsJest} */
 module.exports = {
   globals: {
     'ts-jest': {

e2e/ast-transformers/transformer-options/jest-isolated.config.js

@@ -0,0 +1,3 @@
+test('should expose TypeScript types for Jest config', () => {
+  expect(true).toBe(true)
+})

e2e/config-typing/__tests__/config-typing.spec.ts

@@ -0,0 +1,14 @@
+import type { InitialOptionsTsJest } from 'ts-jest'
+
+const jestCfg: InitialOptionsTsJest = {
+  globals: {
+    'ts-jest': {
+      isolatedModules: true,
+    },
+  },
+  transform: {
+    '^.+.tsx?$': 'ts-jest',
+  },
+}
+
+export default jestCfg