fix: handle processWithEsbuild transform option

When we migrate from `globals` to transform option, the object `ngJest` wasn't copied by `ts-jest` parent class `ConfigSet`.

This fix adds the handling option `processWithEsbuild` directly to `NgJestTransformer` class to manage it properly and add a deprecation warning to `globals.ngJest.processWithEsbuild` option

Author: ahnpnl

src/config/config.ts

@@ -0,0 +1,5 @@
+import type { TsJestTransformerOptions } from 'ts-jest';
+
+export type NgJestTransformerOptions = TsJestTransformerOptions & {
+    processWithEsbuild?: string[];
+};

src/config/ng-jest-config.ts

@@ -14,6 +14,11 @@ export class NgJestConfig extends ConfigSet {
     constructor(jestConfig: TsJestTransformOptions['config'] | undefined, parentLogger?: Logger | undefined) {
         super(jestConfig, parentLogger);
         const jestGlobalsConfig = jestConfig?.globals?.ngJest ?? Object.create(null);
+        if (jestGlobalsConfig.processWithEsbuild) {
+            this.logger.warn(
+                'Specifying `processWithEsbuild` in `ngJest` config is deprecated and will be removed in the next major version. Please follow this documentation https://thymikee.github.io/jest-preset-angular/docs/getting-started/options#processing-with-esbuild instead.',
+            );
+        }
         this.processWithEsbuild = globsToMatcher([
             ...(jestGlobalsConfig.processWithEsbuild ?? []),
             ...defaultProcessWithEsbuildPatterns,

src/ng-jest-transformer.spec.ts

@@ -98,6 +98,32 @@ describe('NgJestTransformer', () => {
         expect(mockedTransformSync).not.toHaveBeenCalled();
     });
 
+    test('should use esbuild to process files defined via "processWithEsbuild" transform option', () => {
+        const tr = new NgJestTransformer({
+            processWithEsbuild: ['foo.js'],
+        });
+        tr.process(
+            `
+      const pi = parseFloat(3.124);
+
+      export { pi };
+    `,
+            'foo.js',
+            {
+                config: {
+                    cwd: process.cwd(),
+                    extensionsToTreatAsEsm: [],
+                    testMatch: [],
+                    testRegex: [],
+                },
+            } as any, // eslint-disable-line @typescript-eslint/no-explicit-any,
+        );
+
+        expect(mockedTransformSync).toHaveBeenCalled();
+
+        mockedTransformSync.mockClear();
+    });
+
     test.each([
         {
             sourceMap: false,

src/ng-jest-transformer.ts

@@ -3,11 +3,13 @@ import { createHash } from 'node:crypto';
 import type { TransformedSource } from '@jest/transform';
 import { LogContexts, LogLevels, type Logger, createLogger } from 'bs-logger';
 import { transformSync } from 'esbuild';
-import { type TsJestTransformerOptions, ConfigSet, TsJestTransformer, type TsJestTransformOptions } from 'ts-jest';
+import { globsToMatcher } from 'jest-util';
+import { ConfigSet, TsJestTransformer, type TsJestTransformOptions } from 'ts-jest';
 import { updateOutput } from 'ts-jest/dist/legacy/compiler/compiler-utils';
 import type { TranspileOutput } from 'typescript';
 
 import { NgJestCompiler } from './compiler/ng-jest-compiler';
+import type { NgJestTransformerOptions } from './config/config';
 import { NgJestConfig } from './config/ng-jest-config';
 
 // stores hashes made out of only one argument being a string
@@ -47,8 +49,10 @@ const sha1 = (...data: DataItem[]): string => {
 
 export class NgJestTransformer extends TsJestTransformer {
     readonly #ngJestLogger: Logger;
+    readonly #processWithEsbuild: ReturnType<typeof globsToMatcher>;
 
-    constructor(tsJestConfig?: TsJestTransformerOptions) {
+    constructor(transformerConfig?: NgJestTransformerOptions) {
+        const { processWithEsbuild, ...tsJestConfig } = transformerConfig ?? {};
         super(tsJestConfig);
         this.#ngJestLogger = createLogger({
             context: {
@@ -58,6 +62,7 @@ export class NgJestTransformer extends TsJestTransformer {
             },
             targets: process.env.NG_JEST_LOG ?? undefined,
         });
+        this.#processWithEsbuild = globsToMatcher(processWithEsbuild ?? []);
     }
 
     protected _createConfigSet(config: TsJestTransformOptions['config'] | undefined): ConfigSet {
@@ -75,7 +80,7 @@ export class NgJestTransformer extends TsJestTransformer {
     process(fileContent: string, filePath: string, transformOptions: TsJestTransformOptions): TransformedSource {
         // @ts-expect-error we are accessing the private cache to avoid creating new objects all the time
         const configSet = super._configsFor(transformOptions);
-        if (configSet.processWithEsbuild(filePath)) {
+        if (configSet.processWithEsbuild(filePath) || this.#processWithEsbuild(filePath)) {
             this.#ngJestLogger.debug({ filePath }, 'process with esbuild');
 
             const compilerOpts = configSet.parsedTsConfig.options;