feat(*): add support vitest

Author: Боровский Дмитрий

.changeset/smart-planes-greet.md

@@ -0,0 +1,5 @@
+---
+'arui-scripts': minor
+---
+
+добавлена возможность запускать тесты c помощью vitest

packages/arui-scripts/docs/commands.md

@@ -57,6 +57,40 @@ _package.json_
 arui-scripts test
 ```
 
+### test:vitest
+Команда `arui-scripts test:vitest` запускает unit тесты через [Vitest](https://vitest.dev/).
+
+Если в корне проекта есть `vitest.config.ts` (или `.js`, `.mjs`, `.cjs`), то используется он.
+Иначе применяется конфигурация arui-scripts.
+
+**Рекомендуемый способ настройки** - создать `vitest.config.js` с `mergeConfig`:
+
+```javascript
+import { defineConfig, mergeConfig } from 'vitest/config';
+import aruiConfig from 'arui-scripts/vitest';
+
+export default mergeConfig(aruiConfig, defineConfig({
+    test: {
+        setupFiles: ['./__tests__/setup.js'],
+        // другие настройки Vitest
+    },
+}));
+```
+
+Базовый конфиг arui-scripts включает:
+- API Vitest - используйте явные импорты: `import { describe, it, expect } from 'vitest'` (без глобальных переменных)
+- Замену импортов `.css` на пустые модули, ассетов (svg, png, шрифты и др.) - на строку с именем файла
+- Маппинг путей из `tsconfig.json` (paths) через [vite-tsconfig-paths](https://www.npmjs.com/package/vite-tsconfig-paths)
+- Маски для тестов: `src/**/__tests__/**/*`, `src/**/__test__/**/*`, `src/**/*.{test,spec,tests}.*`
+
+**Обратная совместимость**: при отсутствии `vitest.config.*` по-прежнему читается `jest.setupFiles` из `package.json`.
+
+**Как запустить?**
+
+```bash
+arui-scripts test:vitest
+```
+
 ### docker-build
 Собирает клиентский и серверный код в production-режиме, создает docker-образ и пушит его в docker-репозиторий.
 

packages/arui-scripts/package.json

@@ -3,6 +3,10 @@
     "version": "20.11.1",
     "main": "./build/index.js",
     "typings": "./build/index.d.ts",
+    "exports": {
+        ".": "./build/index.js",
+        "./vitest": "./build/configs/vitest/config.js"
+    },
     "license": "MPL-2.0",
     "repository": {
         "type": "git",
@@ -114,6 +118,8 @@
         "ts-jest": "29.1.0",
         "ts-loader": "9.4.4",
         "ts-node": "9.1.1",
+        "vite-tsconfig-paths": "^5.1.0",
+        "vitest": "^2.1.0",
         "webpack-bundle-analyzer": "4.10.2",
         "webpack-deduplication-plugin": "^0.0.8",
         "webpack-manifest-plugin": "3.2.0",
@@ -148,6 +154,7 @@
     "scripts": {
         "build": "sh bin/build.sh",
         "test": "jest",
+        "test:vitest": "vitest",
         "lint:scripts": "arui-presets-lint scripts",
         "format": "arui-presets-lint format",
         "format:check": "arui-presets-lint format:check",

packages/arui-scripts/src/bin/index.ts

@@ -9,6 +9,7 @@ const commands: Record<string, () => void> = {
     'docker-build': () => require('../commands/docker-build'),
     'docker-build:compiled': () => require('../commands/docker-build-compiled'),
     test: () => require('../commands/test'),
+    'test:vitest': () => require('../commands/test-vitest'),
     'ensure-yarn': () => require('../commands/ensure-yarn'),
     'archive-build': () => require('../commands/archive-build'),
     'bundle-analyze': () => require('../commands/bundle-analyze'),

packages/arui-scripts/src/commands/test-vitest/index.ts

@@ -0,0 +1,42 @@
+import { spawn } from 'child_process';
+import fs from 'fs';
+import path from 'path';
+
+// Do this as the first thing so that any code reading it knows the right env.
+process.env.BABEL_ENV = 'test';
+process.env.NODE_ENV = 'test';
+process.env.PUBLIC_URL = '';
+
+// расширения как в Vite (vite.config.* -> vitest.config.*)
+const VITEST_CONFIG_FILES = [
+    'vitest.config.js',
+    'vitest.config.mjs',
+    'vitest.config.ts',
+    'vitest.config.cjs',
+    'vitest.config.mts',
+    'vitest.config.cts',
+];
+
+function hasProjectVitestConfig(cwd: string): boolean {
+    return VITEST_CONFIG_FILES.some((file) => fs.existsSync(path.join(cwd, file)));
+}
+
+const cwd = process.cwd();
+const aruiVitestConfigPath = path.resolve(__dirname, '../../configs/vitest/config.js');
+const args = process.argv.slice(3);
+
+const vitestArgs = hasProjectVitestConfig(cwd)
+    ? ['run', ...args]
+    : ['run', '--config', aruiVitestConfigPath, ...args];
+
+const vitestDir = path.dirname(require.resolve('vitest/package.json'));
+const vitestBin = path.join(vitestDir, 'vitest.mjs');
+
+const vitestProcess = spawn(process.execPath, [vitestBin, ...vitestArgs], {
+    stdio: 'inherit',
+    shell: false,
+});
+
+vitestProcess.on('close', (code) => {
+    process.exit(code ?? 0);
+});

packages/arui-scripts/src/configs/vitest/config.ts

@@ -0,0 +1,5 @@
+import { defineConfig } from 'vitest/config';
+
+import { getVitestConfig } from './settings';
+
+export default defineConfig(getVitestConfig());

packages/arui-scripts/src/configs/vitest/settings.ts

@@ -0,0 +1,86 @@
+import fs from 'fs';
+import path from 'path';
+
+import tsconfigPaths from 'vite-tsconfig-paths';
+
+function getSetupFiles(cwd: string): string[] {
+    const packagePath = path.join(cwd, 'package.json');
+
+    let setupFiles: string[] = [];
+
+    if (fs.existsSync(packagePath)) {
+        const pkg = JSON.parse(fs.readFileSync(packagePath, 'utf8')) as {
+            jest?: { setupFiles?: string[] };
+        };
+
+        setupFiles = pkg.jest?.setupFiles ?? [];
+    }
+
+    return setupFiles.map((file: string) => path.resolve(cwd, file.replace('<rootDir>', '.')));
+}
+
+const ASSET_EXTENSIONS = [
+    '.svg',
+    '.png',
+    '.jpg',
+    '.jpeg',
+    '.gif',
+    '.webp',
+    '.ico',
+    '.bmp',
+    '.woff',
+    '.woff2',
+    '.ttf',
+    '.eot',
+];
+
+function isAsset(id: string): boolean {
+    return ASSET_EXTENSIONS.some((extension) => id.endsWith(extension));
+}
+
+const staticFilesMockPlugin = {
+    name: 'arui-scripts-static-files-mock',
+    enforce: 'pre' as const,
+    load(id: string) {
+        if (id.endsWith('.css')) {
+            return 'export default {}';
+        }
+
+        if (isAsset(id)) {
+            const filename = path.basename(id);
+
+            return `export default ${JSON.stringify(filename)}`;
+        }
+
+        return undefined;
+    },
+};
+
+export function getVitestConfig() {
+    const cwd = process.cwd();
+    const setupFiles = getSetupFiles(cwd);
+
+    return {
+        plugins: [tsconfigPaths({ root: cwd }), staticFilesMockPlugin],
+        test: {
+            environment: 'jsdom' as const,
+            setupFiles,
+            include: [
+                'src/**/__tests__/**/*.{ts,tsx,js,jsx}',
+                'src/**/__test__/**/*.{ts,tsx,js,jsx}',
+                'src/**/*.{test,spec,tests}.{ts,tsx,js,jsx}',
+            ],
+            exclude: ['**/node_modules/**', '**/build/**', '**/.build/**'],
+            coverage: {
+                provider: 'v8' as const,
+                include: ['src/**/*.{js,jsx,ts,tsx}'],
+                exclude: ['**/*.d.ts', '**/__tests__/**'],
+            },
+            environmentOptions: {
+                jsdom: {
+                    url: 'http://localhost',
+                },
+            },
+        },
+    };
+}

packages/example/package.json

@@ -8,6 +8,7 @@
         "bundle-analyze": "arui-scripts bundle-analyze",
         "start": "NODE_ENV=localhost arui-scripts start",
         "test": "arui-scripts test",
+        "test:vitest": "arui-scripts test:vitest",
         "lint:styles": "arui-presets-lint styles",
         "lint:scripts": "arui-presets-lint scripts",
         "format": "arui-presets-lint format",

packages/example/src/__tests__/__snapshots__/app.tests.tsx.snap

@@ -1,3 +1,5 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
+exports[`app > should be match to snapshot 1`] = `ShallowWrapper {}`;
+
 exports[`app should be match to snapshot 1`] = `ShallowWrapper {}`;