arui-scripts 23.2.0 → 23.3.0

package/.turbo/turbo-test.log

@@ -1,24 +1,24 @@
 ts-jest[versions] (WARN) Version 6.0.2 of typescript installed has not been tested with ts-jest. If you're experiencing issues, consider using a supported version (>=4.3.0 <6.0.0-0). Please do not report issues in ts-jest if you are using unsupported versions.
 ts-jest[versions] (WARN) Version 6.0.2 of typescript installed has not been tested with ts-jest. If you're experiencing issues, consider using a supported version (>=4.3.0 <6.0.0-0). Please do not report issues in ts-jest if you are using unsupported versions.
 ts-jest[versions] (WARN) Version 6.0.2 of typescript installed has not been tested with ts-jest. If you're experiencing issues, consider using a supported version (>=4.3.0 <6.0.0-0). Please do not report issues in ts-jest if you are using unsupported versions.
-PASS src/bin/__tests__/create-cli.tests.ts (33.121 s)
-PASS src/plugins/postcss-global-variables/utils/__tests__/add-global-variable.tests.ts (33.348 s)
-PASS src/configs/util/__tests__/create-watch-ignore-regex.tests.ts
+PASS src/bin/__tests__/create-cli.tests.ts (32.447 s)
 PASS src/configs/app-configs/__tests__/update-with-presets.tests.ts
-PASS src/configs/app-configs/__tests__/update-with-env.tests.ts
+PASS src/configs/util/__tests__/create-watch-ignore-regex.tests.ts
+PASS src/plugins/postcss-global-variables/utils/__tests__/add-global-variable.tests.ts (32.626 s)
 PASS src/configs/util/__tests__/apply-overrides.tests.ts
+PASS src/configs/app-configs/__tests__/update-with-env.tests.ts
 PASS src/configs/app-configs/__tests__/update-with-package.tests.ts
 PASS src/configs/util/__tests__/compress-with-dcb.test.ts
 PASS src/configs/util/__tests__/get-polyfills.tests.ts
 PASS src/plugins/postcss-global-variables/utils/__tests__/parse-variables.tests.ts
 PASS src/plugins/postcss-global-variables/utils/__tests__/get-media-query-name.tests.ts
 PASS src/configs/app-configs/__tests__/validate-settings-keys.tests.ts
-PASS src/configs/__tests__/webpack-client-modules.tests.ts (11.904 s)
-PASS src/configs/util/__tests__/find-plugin.tests.ts (46.13 s)
+PASS src/configs/__tests__/webpack-client-modules.tests.ts (9.936 s)
+PASS src/configs/util/__tests__/find-plugin.tests.ts (43.865 s)
 A worker process has failed to exit gracefully and has been force exited. This is likely caused by tests leaking due to improper teardown. Try running with --detectOpenHandles to find leaks. Active timers can also cause this, ensure that .unref() was called on them.
 
 Test Suites: 14 passed, 14 total
 Tests:       37 passed, 37 total
 Snapshots:   0 total
-Time:        48.013 s
+Time:        45.272 s
 Ran all test suites.

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # arui-scripts
 
+## 23.3.0
+
+### Minor Changes
+
+-   [#561](https://github.com/core-ds/arui-scripts/pull/561) [`98a2da5`](https://github.com/core-ds/arui-scripts/commit/98a2da587e1f0bc1d9b053cf509d96379b2e9af2) Thanks [@heymdall-legal](https://github.com/heymdall-legal)! - Добавлена настройка `jestTransformNodeModules` — список пакетов из `node_modules`, которые нужно прогонять
+    через трансформер при запуске тестов. Нужна для зависимостей, публикующихся только в формате ESM: рантайм jest
+    работает в CommonJS, а его нативный ESM-режим до сих пор требует `--experimental-vm-modules`.
+    По умолчанию `[]`, поведение не меняется.
+
 ## 23.2.0
 
 ### Minor Changes

package/build/configs/app-configs/get-defaults.js

@@ -58,6 +58,7 @@ function getDefaultAppConfig() {
         installServerSourceMaps: false,
         disableDevRspackTypecheck: true,
         jestCodeTransformer: 'swc',
+        jestTransformNodeModules: [],
         collectCoverage: process.env.NODE_ENV === 'cypress' || process.env.USE_ISTANBUL === 'enabled',
         // image processing
         dataUrlMaxSize: 1536,

package/build/configs/app-configs/types.d.ts

@@ -48,6 +48,7 @@ export type AppConfigs = {
     /** @deprecated используйте `disableDevRspackTypecheck` */
     disableDevWebpackTypecheck?: boolean;
     jestCodeTransformer: 'babel' | 'tsc' | 'swc';
+    jestTransformNodeModules: string[];
     collectCoverage: boolean;
     dataUrlMaxSize?: number;
     imageMinimizer?: {

package/build/configs/jest/settings.d.ts

@@ -10,6 +10,7 @@ export let transform: {
     '^.+\\.tsx?$': string | (string | import("@swc/types").Options)[];
     '^(?!.*\\.(js|jsx|ts|tsx|css|json)$)': string;
 };
+export let transformIgnorePatterns: string[];
 export let moduleNameMapper: {
     '\\.css$': string;
 };

package/build/configs/jest/settings.js

@@ -9,6 +9,9 @@ const { pathsToModuleNameMapper } = require('ts-jest');
 const { parseConfigFileTextToJson } = require('typescript');
 const { swcJestConfig } = require('../swc');
 const { configs } = require('../app-configs');
+// Значения по умолчанию из самого jest, см. https://jestjs.io/docs/configuration#transformignorepatterns-arraystring
+const PNP_TRANSFORM_IGNORE_PATTERN = '\\.pnp\\.[^\\\\/]+$';
+const DEFAULT_TRANSFORM_IGNORE_PATTERNS = ['/node_modules/', PNP_TRANSFORM_IGNORE_PATTERN];
 module.exports = {
     testRegex: 'src/.*(((/__test__/|/__tests__/).*)|(test|spec|tests)).(jsx?|tsx?)$',
     moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx'],
@@ -22,6 +25,7 @@ module.exports = {
         '^.+\\.tsx?$': getTsTransformer(),
         '^(?!.*\\.(js|jsx|ts|tsx|css|json)$)': require.resolve('./file-transform'),
     },
+    transformIgnorePatterns: getTransformIgnorePatterns(),
     moduleNameMapper: Object.assign({ 
         // replace all css files with simple empty exports
         '\\.css$': require.resolve('./css-mock') }, pathsToModuleNameMapper(getPathMapping(), { prefix: '<rootDir>/' })),
@@ -56,3 +60,17 @@ function getJsTransformer() {
     }
     return require.resolve('./babel-transform');
 }
+function getTransformIgnorePatterns() {
+    const packages = configs.jestTransformNodeModules;
+    if (!packages || packages.length === 0) {
+        return DEFAULT_TRANSFORM_IGNORE_PATTERNS;
+    }
+    const list = packages.map((name) => name.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')).join('|');
+    // Игнорируем всё в node_modules, кроме путей, содержащих /node_modules/<пакет>/.
+    // Вхождение ищется в любом месте пути, чтобы работали вложенные установки
+    // вида node_modules/foo/node_modules/uuid.
+    return [
+        `^(?!.*[\\\\/]node_modules[\\\\/](?:${list})[\\\\/]).*[\\\\/]node_modules[\\\\/]`,
+        PNP_TRANSFORM_IGNORE_PATTERN,
+    ];
+}

package/docs/settings.md

@@ -271,6 +271,28 @@ const packageSettings = {
 - `swc` - для всего кода будет использоваться `@swc/jest`.
   Swc более строго следует спецификациям и [не дает возможности](https://github.com/swc-project/swc/issues/5059) делать `spyOn` для экспортов из esm модулей.
 
+#### jestTransformNodeModules
+Список пакетов из `node_modules`, которые нужно прогонять через трансформер при запуске тестов. По умолчанию `[]`.
+
+```js
+module.exports = {
+    jestTransformNodeModules: ['uuid', '@scope/some-package'],
+};
+```
+
+Нужно для пакетов, которые публикуются только в формате ESM (`"type": "module"` без CommonJS сборки).
+По умолчанию jest не трансформирует ничего внутри `node_modules`, а его рантайм — CommonJS: он оборачивает
+файл в `function(module, exports, require, ...)` и выполняет его, поэтому на ESM-коде падает с
+`SyntaxError: Unexpected token 'export'`. Собственный `require(esm)` из Node тут не помогает — jest его не использует,
+а нативный ESM-режим самого jest до сих пор требует запуска ноды с `--experimental-vm-modules`.
+
+Настройка добавляет перечисленные пакеты в исключения `transformIgnorePatterns`, так что их код будет обработан
+тем же трансформером, который выбран в [jestCodeTransformer](#jestcodetransformer). Вложенные установки
+(`node_modules/foo/node_modules/uuid`) тоже учитываются.
+
+Если нужно что-то более тонкое, `transformIgnorePatterns` по-прежнему можно задать напрямую — через ключ `jest`
+в `package.json` или через `jest.config.js`, настройки приложения имеют приоритет над пресетом.
+
 #### collectCoverage
 Добавлять ли инструменты для сборки coverage при сборке. По умолчанию определяется по env переменным - будет выставлено в `true` если `NODE_ENV = 'cypress'` или `USE_ISTANBUL = 'enabled'`.
 Сбор coverage не будет работать при использовании `codeLoader=tsc`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arui-scripts",
-  "version": "23.2.0",
+  "version": "23.3.0",
   "main": "./build/index.js",
   "typings": "./build/index.d.ts",
   "exports": {
@@ -116,7 +116,7 @@
     "style-loader": "3.3.3",
     "swc-loader": "^0.2.6",
     "swc-plugin-coverage-instrument": "0.0.32",
-    "tar": "7.5.16",
+    "tar": "7.5.21",
     "terser-webpack-plugin": "5.3.14",
     "ts-checker-rspack-plugin": "^1.3.0",
     "ts-jest": "29.1.0",