jest-preset-angular 14.2.4 → 14.3.0

package/build/transformers/replace-resources.d.ts

@@ -0,0 +1,2 @@
+import ts from 'typescript';
+export declare function replaceResources(program: ts.Program): ts.TransformerFactory<ts.SourceFile>;

package/build/utils/ngcc-jest-processor.d.ts

@@ -0,0 +1 @@
+export declare const runNgccJestProcessor: (tsconfigPath: string | undefined) => void;

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "jest-preset-angular",
-  "version": "14.2.4",
+  "version": "14.3.0",
   "description": "Jest preset configuration for Angular projects",
   "license": "MIT",
   "engines": {
     "node": "^14.15.0 || >=16.10.0"
   },
   "main": "build/index.js",
+  "typings": "build/index.d.ts",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/thymikee/jest-preset-angular.git"
@@ -64,30 +65,30 @@
     "typescript": ">=4.8"
   },
   "devDependencies": {
-    "@angular-devkit/build-angular": "^18.2.4",
-    "@angular-eslint/eslint-plugin": "^18.3.1",
-    "@angular-eslint/eslint-plugin-template": "^18.3.1",
-    "@angular-eslint/template-parser": "^18.3.1",
-    "@angular/animations": "^18.2.4",
-    "@angular/cdk": "^18.2.3",
-    "@angular/common": "^18.2.4",
-    "@angular/compiler": "^18.2.4",
-    "@angular/compiler-cli": "^18.2.4",
-    "@angular/core": "^18.2.4",
-    "@angular/forms": "^18.2.4",
-    "@angular/material": "^18.2.3",
-    "@angular/platform-browser": "^18.2.4",
-    "@angular/platform-browser-dynamic": "^18.2.4",
-    "@babel/core": "^7.25.2",
-    "@babel/preset-env": "^7.25.4",
+    "@angular-devkit/build-angular": "^18.2.12",
+    "@angular-eslint/eslint-plugin": "^18.4.0",
+    "@angular-eslint/eslint-plugin-template": "^18.4.0",
+    "@angular-eslint/template-parser": "^18.4.0",
+    "@angular/animations": "^18.2.12",
+    "@angular/cdk": "^18.2.13",
+    "@angular/common": "^18.2.12",
+    "@angular/compiler": "^18.2.12",
+    "@angular/compiler-cli": "^18.2.12",
+    "@angular/core": "^18.2.12",
+    "@angular/forms": "^18.2.12",
+    "@angular/material": "^18.2.13",
+    "@angular/platform-browser": "^18.2.12",
+    "@angular/platform-browser-dynamic": "^18.2.12",
+    "@babel/core": "^7.26.0",
+    "@babel/preset-env": "^7.26.0",
     "@commitlint/cli": "^19.5.0",
     "@commitlint/config-angular": "^19.5.0",
     "@jest/transform": "^29.7.0",
     "@jest/types": "^29.6.3",
     "@types/babel__core": "^7.20.5",
     "@types/babel__preset-env": "^7.9.7",
-    "@types/jest": "^29.5.12",
-    "@types/node": "^20.16.5",
+    "@types/jest": "^29.5.14",
+    "@types/node": "^22.9.0",
     "@types/semver": "^7.5.8",
     "@typescript-eslint/eslint-plugin": "^7.18.0",
     "@typescript-eslint/parser": "^7.18.0",
@@ -95,11 +96,11 @@
     "chalk": "^4.1.2",
     "conventional-changelog-cli": "^5.0.0",
     "cross-env": "^7.0.3",
-    "eslint": "^8.57.0",
+    "eslint": "^8.57.1",
     "eslint-config-prettier": "^9.1.0",
-    "eslint-plugin-import": "^2.30.0",
-    "eslint-plugin-jest": "^28.8.3",
-    "eslint-plugin-jsdoc": "^50.2.2",
+    "eslint-plugin-import": "^2.31.0",
+    "eslint-plugin-jest": "^28.9.0",
+    "eslint-plugin-jsdoc": "^50.5.0",
     "eslint-plugin-prettier": "^4.2.1",
     "execa": "5.1.1",
     "fs-extra": "^11.2.0",
@@ -112,9 +113,9 @@
     "rimraf": "^5.0.10",
     "rxjs": "^7.8.1",
     "ts-node": "^10.9.2",
-    "tslib": "^2.7.0",
+    "tslib": "^2.8.1",
     "typescript": "~5.5.4",
     "zone.js": "~0.15.0"
   },
-  "packageManager": "yarn@4.4.1"
+  "packageManager": "yarn@4.5.1"
 }

package/setup-env/utils.mjs

@@ -0,0 +1,19 @@
+import { TextDecoder, TextEncoder } from 'util';
+
+export const polyfillEncoder = () => {
+    if (typeof globalThis.TextEncoder === 'undefined') {
+        globalThis.TextEncoder = TextEncoder;
+        globalThis.TextDecoder = TextDecoder;
+    }
+};
+
+export const resolveTestEnvOptions = (options) => {
+    const globalTestEnvOptions = globalThis.ngJest?.testEnvironmentOptions;
+    if (globalTestEnvOptions) {
+        console.warn(
+            'Setting testEnvironmentOptions via globalThis.ngJest is deprecated. Please provide testEnvironmentOptions via function argument',
+        );
+    }
+
+    return globalTestEnvOptions ?? options;
+};

package/setup-env/zone/index.d.mts

@@ -0,0 +1,3 @@
+import type { TestEnvironmentOptions } from '@angular/core/testing';
+
+export declare const setupZoneTestEnv: (options?: TestEnvironmentOptions) => void;

package/setup-env/zone/index.d.ts

@@ -0,0 +1,6 @@
+import type { TestEnvironmentOptions } from '@angular/core/testing';
+
+declare const _default: {
+    setupZoneTestEnv: (options?: TestEnvironmentOptions) => void;
+};
+export = _default;

package/setup-env/zone/index.js

@@ -0,0 +1,43 @@
+require('zone.js');
+require('zone.js/testing');
+
+const { TextEncoder, TextDecoder } = require('util');
+
+const { getTestBed } = require('@angular/core/testing');
+const {
+    BrowserDynamicTestingModule,
+    platformBrowserDynamicTesting,
+} = require('@angular/platform-browser-dynamic/testing');
+
+const polyfillEncoder = () => {
+    if (typeof globalThis.TextEncoder === 'undefined') {
+        globalThis.TextEncoder = TextEncoder;
+        globalThis.TextDecoder = TextDecoder;
+    }
+};
+
+const resolveTestEnvOptions = (options) => {
+    const globalTestEnvOptions = globalThis.ngJest?.testEnvironmentOptions;
+    if (globalTestEnvOptions) {
+        console.warn(
+            'Setting testEnvironmentOptions via globalThis.ngJest is deprecated. Please provide testEnvironmentOptions via function argument',
+        );
+    }
+
+    return globalTestEnvOptions ?? options;
+};
+
+const setupZoneTestEnv = (options) => {
+    polyfillEncoder();
+    const testEnvironmentOptions = resolveTestEnvOptions(options);
+
+    getTestBed().initTestEnvironment(
+        BrowserDynamicTestingModule,
+        platformBrowserDynamicTesting(),
+        testEnvironmentOptions,
+    );
+};
+
+module.exports = {
+    setupZoneTestEnv,
+};

package/setup-env/zone/index.mjs

@@ -0,0 +1,18 @@
+import 'zone.js';
+import 'zone.js/testing';
+
+import { getTestBed } from '@angular/core/testing';
+import { BrowserDynamicTestingModule, platformBrowserDynamicTesting } from '@angular/platform-browser-dynamic/testing';
+
+import { polyfillEncoder, resolveTestEnvOptions } from '../utils.mjs';
+
+export const setupZoneTestEnv = (options) => {
+    polyfillEncoder();
+    const testEnvironmentOptions = resolveTestEnvOptions(options);
+
+    getTestBed().initTestEnvironment(
+        BrowserDynamicTestingModule,
+        platformBrowserDynamicTesting(),
+        testEnvironmentOptions,
+    );
+};

package/setup-env/zoneless/index.d.mts

@@ -0,0 +1,3 @@
+import type { TestEnvironmentOptions } from '@angular/core/testing';
+
+export declare const setupZonelessTestEnv: (options?: TestEnvironmentOptions) => void;

package/setup-env/zoneless/index.d.ts

@@ -0,0 +1,6 @@
+import type { TestEnvironmentOptions } from '@angular/core/testing';
+
+declare const _default: {
+    setupZonelessTestEnv: (options?: TestEnvironmentOptions) => void;
+};
+export = _default;

package/setup-env/zoneless/index.js

@@ -0,0 +1,11 @@
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+const setupZonelessTestEnv = (_options) => {
+    throw Error(
+        'Zoneless testing environment only works when running Jest in ESM mode with Jest 29. ' +
+            'Jest 30+ will support to work with CommonJS mode.',
+    );
+};
+
+module.exports = {
+    setupZonelessTestEnv,
+};

package/setup-env/zoneless/index.mjs

@@ -0,0 +1,39 @@
+import { ErrorHandler, NgModule, provideExperimentalZonelessChangeDetection } from '@angular/core';
+import { getTestBed } from '@angular/core/testing';
+import { BrowserDynamicTestingModule, platformBrowserDynamicTesting } from '@angular/platform-browser-dynamic/testing';
+
+import { polyfillEncoder, resolveTestEnvOptions } from '../utils.mjs';
+
+export const setupZonelessTestEnv = (options) => {
+    if (typeof provideExperimentalZonelessChangeDetection !== 'undefined') {
+        polyfillEncoder();
+        const testEnvironmentOptions = resolveTestEnvOptions(options);
+        @NgModule({
+            providers: [
+                provideExperimentalZonelessChangeDetection(),
+                {
+                    provide: ErrorHandler,
+                    useValue: {
+                        handleError: (e) => {
+                            throw e;
+                        },
+                    },
+                },
+            ],
+        })
+        export class TestModule {}
+
+        getTestBed().initTestEnvironment(
+            [BrowserDynamicTestingModule, TestModule],
+            platformBrowserDynamicTesting(),
+            testEnvironmentOptions,
+        );
+
+        return;
+    }
+
+    throw Error(
+        'Cannot find provideExperimentalZonelessChangeDetection() to setup zoneless testing environment. ' +
+            'Please use setupZoneTestEnv() from jest-preset-angular/setup-env/setup-zone-env.mjs instead.',
+    );
+};

package/setup-jest.js

@@ -1,3 +1,13 @@
+console.warn(`
+    Importing "setup-jest.js" directly is deprecated. The file "setup-jest.js" will be removed in the future.
+    Please use "setupZoneTestEnv" function instead. Example:
+
+    // setup-jest.ts
+    import { setupZoneTestEnv } from 'jest-preset-angular/setup-env/zone';
+
+    setupZoneTestEnv();
+`);
+
 require('zone.js');
 require('zone.js/testing');
 const { TextEncoder, TextDecoder } = require('util');

package/setup-jest.mjs

@@ -1,8 +1,19 @@
+console.warn(`
+    Importing "setup-jest.mjs" directly is deprecated. The file "setup-jest.mjs" will be removed in the future.
+    Please use "setupZoneTestEnv" function instead. Example:
+
+    // setup-jest.ts
+    import { setupZoneTestEnv } from 'jest-preset-angular/setup-env/zone/index.mjs';
+
+    setupZoneTestEnv();
+`);
+
 import 'zone.js';
 import 'zone.js/testing';
+import { TextEncoder, TextDecoder } from 'util';
+
 import { getTestBed } from '@angular/core/testing';
 import { BrowserDynamicTestingModule, platformBrowserDynamicTesting } from '@angular/platform-browser-dynamic/testing';
-import { TextEncoder, TextDecoder } from 'util';
 
 if (typeof globalThis.TextEncoder === 'undefined') {
     globalThis.TextEncoder = TextEncoder;

package/jest-cjs.config.ts

@@ -1,8 +0,0 @@
-import type { Config } from '@jest/types';
-
-const config: Config.InitialOptions = {
-    globalSetup: './setup-e2e-test.ts',
-    projects: ['e2e/**/jest-cjs.config.ts'],
-};
-
-export default config;

package/jest-esm.config.ts

@@ -1,8 +0,0 @@
-import type { Config } from '@jest/types';
-
-const config: Config.InitialOptions = {
-    globalSetup: './setup-e2e-test.ts',
-    projects: ['e2e/**/jest-esm.config.ts'],
-};
-
-export default config;

package/jest-src.config.ts

@@ -1,18 +0,0 @@
-import type { JestConfigWithTsJest } from 'ts-jest';
-
-const config: JestConfigWithTsJest = {
-    modulePathIgnorePatterns: ['examples/.*', 'website/.*'],
-    testMatch: ['<rootDir>/src/**/*.spec.ts'],
-    testEnvironment: 'jsdom',
-    transform: {
-        '^.+\\.(ts|js|mjs|html)$': [
-            '<rootDir>/build/index.js',
-            {
-                tsconfig: 'tsconfig-base.spec.json',
-                isolatedModules: true,
-            },
-        ],
-    },
-};
-
-export default config;

package/jest-transpile-cjs.config.ts

@@ -1,8 +0,0 @@
-import type { Config } from '@jest/types';
-
-const config: Config.InitialOptions = {
-    globalSetup: './setup-e2e-test.ts',
-    projects: ['jest-src.config.ts', 'e2e/**/jest-transpile-cjs.config.ts'],
-};
-
-export default config;

package/jest-transpile-esm.config.ts

@@ -1,8 +0,0 @@
-import type { Config } from '@jest/types';
-
-const config: Config.InitialOptions = {
-    globalSetup: './setup-e2e-test.ts',
-    projects: ['e2e/**/jest-transpile-esm.config.ts'],
-};
-
-export default config;

package/tsconfig-base.spec.json

@@ -1,7 +0,0 @@
-{
-  "extends": "./tsconfig.json",
-  "compilerOptions": {
-    "module": "CommonJS",
-    "types": ["jest"]
-  }
-}