arui-scripts 0.0.0-beta-20260824133302
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.eslintignore +2 -0
- package/.eslintrc.js +17 -0
- package/.prettierignore +2 -0
- package/.turbo/turbo-build.log +0 -0
- package/.turbo/turbo-test.log +23 -0
- package/CHANGELOG.md +1976 -0
- package/README.md +59 -0
- package/bin/build.sh +2 -0
- package/build/bin/index.d.ts +2 -0
- package/build/bin/index.js +26 -0
- package/build/commands/archive-build/index.d.ts +1 -0
- package/build/commands/archive-build/index.js +15 -0
- package/build/commands/build/build-wrapper.d.ts +8 -0
- package/build/commands/build/build-wrapper.js +40 -0
- package/build/commands/build/client.d.ts +1 -0
- package/build/commands/build/client.js +54 -0
- package/build/commands/build/index.d.ts +1 -0
- package/build/commands/build/index.js +11 -0
- package/build/commands/build/server.d.ts +1 -0
- package/build/commands/build/server.js +29 -0
- package/build/commands/bundle-analyze/index.d.ts +1 -0
- package/build/commands/bundle-analyze/index.js +62 -0
- package/build/commands/changelog/index.d.ts +5 -0
- package/build/commands/changelog/index.js +141 -0
- package/build/commands/docker-build/index.d.ts +1 -0
- package/build/commands/docker-build/index.js +15 -0
- package/build/commands/docker-build-compiled/index.d.ts +1 -0
- package/build/commands/docker-build-compiled/index.js +15 -0
- package/build/commands/ensure-yarn/index.d.ts +1 -0
- package/build/commands/ensure-yarn/index.js +8 -0
- package/build/commands/start/client.d.ts +1 -0
- package/build/commands/start/client.js +7 -0
- package/build/commands/start/index.d.ts +1 -0
- package/build/commands/start/index.js +13 -0
- package/build/commands/start/print-compiler-output.d.ts +2 -0
- package/build/commands/start/print-compiler-output.js +16 -0
- package/build/commands/start/server.d.ts +1 -0
- package/build/commands/start/server.js +7 -0
- package/build/commands/start-prod/client.d.ts +1 -0
- package/build/commands/start-prod/client.js +7 -0
- package/build/commands/start-prod/index.d.ts +1 -0
- package/build/commands/start-prod/index.js +13 -0
- package/build/commands/start-prod/server.d.ts +1 -0
- package/build/commands/start-prod/server.js +7 -0
- package/build/commands/test/get-config.d.ts +1 -0
- package/build/commands/test/get-config.js +83 -0
- package/build/commands/test/index.d.ts +1 -0
- package/build/commands/test/index.js +68 -0
- package/build/commands/test-vitest/index.d.ts +1 -0
- package/build/commands/test-vitest/index.js +15 -0
- package/build/commands/util/artifacts-config.d.ts +25 -0
- package/build/commands/util/artifacts-config.js +119 -0
- package/build/commands/util/artifacts-deprecations.d.ts +9 -0
- package/build/commands/util/artifacts-deprecations.js +65 -0
- package/build/commands/util/arui-scripts-artifacts.d.ts +16 -0
- package/build/commands/util/arui-scripts-artifacts.js +29 -0
- package/build/commands/util/client-assets-sizes.d.ts +2 -0
- package/build/commands/util/client-assets-sizes.js +71 -0
- package/build/commands/util/docker-build.d.ts +35 -0
- package/build/commands/util/docker-build.js +76 -0
- package/build/commands/util/exec.d.ts +1 -0
- package/build/commands/util/exec.js +6 -0
- package/build/commands/util/format-webpack-messages.d.ts +5 -0
- package/build/commands/util/format-webpack-messages.js +95 -0
- package/build/commands/util/get-local-ident.d.ts +6 -0
- package/build/commands/util/get-local-ident.js +29 -0
- package/build/commands/util/load-browserslist.d.ts +1 -0
- package/build/commands/util/load-browserslist.js +15 -0
- package/build/commands/util/make-tmp-dir.d.ts +5 -0
- package/build/commands/util/make-tmp-dir.js +29 -0
- package/build/commands/util/print-build-error.d.ts +1 -0
- package/build/commands/util/print-build-error.js +32 -0
- package/build/commands/util/run-artifacts-cli.d.ts +7 -0
- package/build/commands/util/run-artifacts-cli.js +60 -0
- package/build/commands/util/run-client-dev-server.d.ts +2 -0
- package/build/commands/util/run-client-dev-server.js +47 -0
- package/build/commands/util/run-compilers.d.ts +1 -0
- package/build/commands/util/run-compilers.js +37 -0
- package/build/commands/util/run-server-watch-compiler.d.ts +2 -0
- package/build/commands/util/run-server-watch-compiler.js +17 -0
- package/build/commands/util/run-vitest.d.ts +7 -0
- package/build/commands/util/run-vitest.js +41 -0
- package/build/commands/util/tsc.d.ts +1 -0
- package/build/commands/util/tsc.js +13 -0
- package/build/commands/util/yarn.d.ts +10 -0
- package/build/commands/util/yarn.js +25 -0
- package/build/configs/app-configs/calculate-dependent-config.d.ts +9 -0
- package/build/configs/app-configs/calculate-dependent-config.js +55 -0
- package/build/configs/app-configs/get-defaults.d.ts +5 -0
- package/build/configs/app-configs/get-defaults.js +151 -0
- package/build/configs/app-configs/index.d.ts +5 -0
- package/build/configs/app-configs/index.js +25 -0
- package/build/configs/app-configs/read-config-file.d.ts +2 -0
- package/build/configs/app-configs/read-config-file.js +28 -0
- package/build/configs/app-configs/types.d.ts +146 -0
- package/build/configs/app-configs/types.js +2 -0
- package/build/configs/app-configs/update-with-config-file.d.ts +2 -0
- package/build/configs/app-configs/update-with-config-file.js +17 -0
- package/build/configs/app-configs/update-with-env.d.ts +2 -0
- package/build/configs/app-configs/update-with-env.js +23 -0
- package/build/configs/app-configs/update-with-package.d.ts +2 -0
- package/build/configs/app-configs/update-with-package.js +13 -0
- package/build/configs/app-configs/update-with-presets.d.ts +3 -0
- package/build/configs/app-configs/update-with-presets.js +41 -0
- package/build/configs/app-configs/validate-config.d.ts +2 -0
- package/build/configs/app-configs/validate-config.js +8 -0
- package/build/configs/app-configs/validate-settings-keys.d.ts +7 -0
- package/build/configs/app-configs/validate-settings-keys.js +16 -0
- package/build/configs/app-configs/warn-about-deprecations.d.ts +2 -0
- package/build/configs/app-configs/warn-about-deprecations.js +22 -0
- package/build/configs/babel-client.d.ts +31 -0
- package/build/configs/babel-client.js +69 -0
- package/build/configs/babel-dependencies.d.ts +14 -0
- package/build/configs/babel-dependencies.js +36 -0
- package/build/configs/babel-server.d.ts +26 -0
- package/build/configs/babel-server.js +45 -0
- package/build/configs/client-env-config/add-env-to-html-template.d.ts +1 -0
- package/build/configs/client-env-config/add-env-to-html-template.js +7 -0
- package/build/configs/client-env-config/client-config-plugin.d.ts +5 -0
- package/build/configs/client-env-config/client-config-plugin.js +26 -0
- package/build/configs/client-env-config/constants.d.ts +1 -0
- package/build/configs/client-env-config/constants.js +4 -0
- package/build/configs/client-env-config/get-env-config.d.ts +2 -0
- package/build/configs/client-env-config/get-env-config.js +28 -0
- package/build/configs/client-env-config/index.d.ts +3 -0
- package/build/configs/client-env-config/index.js +9 -0
- package/build/configs/config-extras/minimizers/imagemin/imagemin.d.ts +28 -0
- package/build/configs/config-extras/minimizers/imagemin/imagemin.js +65 -0
- package/build/configs/config-extras/minimizers/imagemin/index.d.ts +1 -0
- package/build/configs/config-extras/minimizers/imagemin/index.js +17 -0
- package/build/configs/config-extras/minimizers/index.d.ts +1 -0
- package/build/configs/config-extras/minimizers/index.js +17 -0
- package/build/configs/dev-server.d.ts +2 -0
- package/build/configs/dev-server.js +78 -0
- package/build/configs/jest/babel-transform.d.ts +2 -0
- package/build/configs/jest/babel-transform.js +6 -0
- package/build/configs/jest/css-mock.d.ts +1 -0
- package/build/configs/jest/css-mock.js +2 -0
- package/build/configs/jest/file-transform.d.ts +3 -0
- package/build/configs/jest/file-transform.js +11 -0
- package/build/configs/jest/settings.d.ts +21 -0
- package/build/configs/jest/settings.js +58 -0
- package/build/configs/modules.d.ts +17 -0
- package/build/configs/modules.js +181 -0
- package/build/configs/mq.css +22 -0
- package/build/configs/postcss.config.d.ts +35 -0
- package/build/configs/postcss.config.js +65 -0
- package/build/configs/postcss.d.ts +6 -0
- package/build/configs/postcss.js +21 -0
- package/build/configs/process-assets-plugin-output.d.ts +2 -0
- package/build/configs/process-assets-plugin-output.js +45 -0
- package/build/configs/server-externals-exemptions.d.ts +1 -0
- package/build/configs/server-externals-exemptions.js +18 -0
- package/build/configs/stats-options.d.ts +2 -0
- package/build/configs/stats-options.js +46 -0
- package/build/configs/supporting-browsers.d.ts +1 -0
- package/build/configs/supporting-browsers.js +5 -0
- package/build/configs/supporting-node.d.ts +1 -0
- package/build/configs/supporting-node.js +5 -0
- package/build/configs/swc.d.ts +4 -0
- package/build/configs/swc.js +30 -0
- package/build/configs/util/apply-overrides.d.ts +87 -0
- package/build/configs/util/apply-overrides.js +56 -0
- package/build/configs/util/check-node-version.d.ts +1 -0
- package/build/configs/util/check-node-version.js +7 -0
- package/build/configs/util/compress-with-dcb.d.ts +2 -0
- package/build/configs/util/compress-with-dcb.js +28 -0
- package/build/configs/util/compression-plugins-for-dictionaries.d.ts +2 -0
- package/build/configs/util/compression-plugins-for-dictionaries.js +78 -0
- package/build/configs/util/create-watch-ignore-regex.d.ts +1 -0
- package/build/configs/util/create-watch-ignore-regex.js +16 -0
- package/build/configs/util/dcb-compression-plugin.d.ts +21 -0
- package/build/configs/util/dcb-compression-plugin.js +130 -0
- package/build/configs/util/find-loader.d.ts +2 -0
- package/build/configs/util/find-loader.js +24 -0
- package/build/configs/util/find-plugin.d.ts +78 -0
- package/build/configs/util/find-plugin.js +21 -0
- package/build/configs/util/get-entry.d.ts +8 -0
- package/build/configs/util/get-entry.js +22 -0
- package/build/configs/util/get-polyfills.d.ts +2 -0
- package/build/configs/util/get-polyfills.js +13 -0
- package/build/configs/util/get-webpack-cache-dependencies.d.ts +1 -0
- package/build/configs/util/get-webpack-cache-dependencies.js +15 -0
- package/build/configs/util/install-sourcemap-support.d.ts +1 -0
- package/build/configs/util/install-sourcemap-support.js +10 -0
- package/build/configs/util/node-assets-ignore.d.ts +1 -0
- package/build/configs/util/node-assets-ignore.js +34 -0
- package/build/configs/util/noop.d.ts +1 -0
- package/build/configs/util/noop.js +2 -0
- package/build/configs/util/register-ts-node.d.ts +1 -0
- package/build/configs/util/register-ts-node.js +18 -0
- package/build/configs/util/resolve.d.ts +14 -0
- package/build/configs/util/resolve.js +29 -0
- package/build/configs/vitest/config.d.ts +2 -0
- package/build/configs/vitest/config.js +5 -0
- package/build/configs/vitest/settings.d.ts +30 -0
- package/build/configs/vitest/settings.js +77 -0
- package/build/configs/webpack.client.d.ts +10 -0
- package/build/configs/webpack.client.dev.d.ts +1 -0
- package/build/configs/webpack.client.dev.js +12 -0
- package/build/configs/webpack.client.js +508 -0
- package/build/configs/webpack.client.prod.d.ts +1 -0
- package/build/configs/webpack.client.prod.js +12 -0
- package/build/configs/webpack.server.d.ts +2 -0
- package/build/configs/webpack.server.dev.d.ts +1 -0
- package/build/configs/webpack.server.dev.js +8 -0
- package/build/configs/webpack.server.js +283 -0
- package/build/configs/webpack.server.prod.d.ts +1 -0
- package/build/configs/webpack.server.prod.js +8 -0
- package/build/index.d.ts +19 -0
- package/build/index.js +35 -0
- package/build/plugins/arui-runtime/arui-runtime-module.d.ts +7 -0
- package/build/plugins/arui-runtime/arui-runtime-module.js +20 -0
- package/build/plugins/arui-runtime/index.d.ts +11 -0
- package/build/plugins/arui-runtime/index.js +47 -0
- package/build/plugins/postcss-global-variables/postcss-global-variables.d.ts +6 -0
- package/build/plugins/postcss-global-variables/postcss-global-variables.js +38 -0
- package/build/plugins/postcss-global-variables/utils/utils.d.ts +7 -0
- package/build/plugins/postcss-global-variables/utils/utils.js +91 -0
- package/build/plugins/postcss-prefix-selector.d.ts +6 -0
- package/build/plugins/postcss-prefix-selector.js +65 -0
- package/build/plugins/reload-server-plugin.d.ts +10 -0
- package/build/plugins/reload-server-plugin.js +46 -0
- package/build/plugins/turn-off-split-remote-entry.d.ts +11 -0
- package/build/plugins/turn-off-split-remote-entry.js +71 -0
- package/build/plugins/watch-missing-node-modules-plugin.d.ts +6 -0
- package/build/plugins/watch-missing-node-modules-plugin.js +20 -0
- package/build/templates/html.template.d.ts +1 -0
- package/build/templates/html.template.js +22 -0
- package/docs/artifact.md +62 -0
- package/docs/caveats.md +41 -0
- package/docs/client-only.md +77 -0
- package/docs/commands.md +159 -0
- package/docs/compilers.md +18 -0
- package/docs/compression-dictionary.md +130 -0
- package/docs/examples.md +100 -0
- package/docs/modules.md +834 -0
- package/docs/overrides.md +175 -0
- package/docs/presets.md +65 -0
- package/docs/settings.md +336 -0
- package/jest-preset.js +5 -0
- package/package.json +215 -0
- package/stylelint.config.js +11 -0
- package/tsconfig-local.json +17 -0
- package/tsconfig-local.tsbuildinfo +1 -0
- package/tsconfig.eslint.json +5 -0
- package/tsconfig.json +29 -0
|
@@ -0,0 +1,175 @@
|
|
|
1
|
+
Тонкая настройка
|
|
2
|
+
===
|
|
3
|
+
|
|
4
|
+
Если вам не хватает гибкости при использовании `arui-scripts`, например вы хотите добавить свой плагин для вебпака -
|
|
5
|
+
вы можете воспользоваться механизмом `overrides`.
|
|
6
|
+
|
|
7
|
+
Для этого вам необходимо создать в корне вашего проекта файл `arui-scripts.overrides.js` или `arui-scripts.overrides.ts`, из которого вы сможете управлять
|
|
8
|
+
конфигурацией почти всех инструментов, используемых в `arui-scripts`.
|
|
9
|
+
|
|
10
|
+
Принцип работы тут следующий. Для всех конфигураций определен набор ключей, которые они будут искать в `arui-scripts.overrides.js`,
|
|
11
|
+
В случае если такой ключ найден и это функция - она будет вызвана, и в качестве аргументов ей будут переданы
|
|
12
|
+
существующая конфигурация и полный конфиг приложения (см [AppConfig](../src/configs/app-configs/types.ts)).
|
|
13
|
+
Возвращать такая функция должна так же конфигурацию.
|
|
14
|
+
|
|
15
|
+
Пример `arui-scripts.overrides.js`:
|
|
16
|
+
```javascript
|
|
17
|
+
const path = require('path');
|
|
18
|
+
module.exports = {
|
|
19
|
+
webpack: (config, applicationConfig) => {
|
|
20
|
+
config.resolve.alias = {
|
|
21
|
+
components: path.resolve(__dirname, 'src/components')
|
|
22
|
+
};
|
|
23
|
+
return config;
|
|
24
|
+
}
|
|
25
|
+
};
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
Пример `arui-scripts.overrides.ts`:
|
|
29
|
+
```ts
|
|
30
|
+
import type { OverrideFile } from 'arui-scripts';
|
|
31
|
+
import path from 'path';
|
|
32
|
+
|
|
33
|
+
const overrides: OverrideFile = {
|
|
34
|
+
webpack: (config, applicationConfig) => {
|
|
35
|
+
config.resolve.alias = {
|
|
36
|
+
components: path.resolve(__dirname, 'src/components')
|
|
37
|
+
};
|
|
38
|
+
return config;
|
|
39
|
+
}
|
|
40
|
+
};
|
|
41
|
+
|
|
42
|
+
export default overrides;
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
**В случае, если у вас на проекте лежит и ts, и js файл с overrides, использоваться будет js версия.**
|
|
46
|
+
|
|
47
|
+
С помощью этой конфигурации ко всем настройкам вебпака будет добавлен `alias` *components*.
|
|
48
|
+
|
|
49
|
+
На данный момент можно переопределять следующие конфигурации:
|
|
50
|
+
- `babel-client` - конфигурация `babel` для клиентского кода. Ключи: `babel`, `babelClient`.
|
|
51
|
+
- `babel-server` - конфигурация `babel` для серверноого кода. Ключи: `babel`, `babelServer`.
|
|
52
|
+
- `dev-server` - конфигурация `webpack-dev-server`. Ключи: `devServer`.
|
|
53
|
+
- `postcss` - конфигурация плагинов для [`postcss`](https://github.com/postcss/postcss#webpack). Ключи: `postcss`.
|
|
54
|
+
- `stats-options` - конфигурация для [webpack-stats](https://webpack.js.org/configuration/stats/). Ключи: `stats`.
|
|
55
|
+
- `webpack.client.dev` - конфигурация для клиентского webpack в dev режиме.
|
|
56
|
+
Ключи: `webpack`, `webpackClient`, `webpackDev`, `webpackClientDev`.
|
|
57
|
+
- `webpack.client.prod` - конфигурация для клиентского webpack в prod режиме.
|
|
58
|
+
Ключи: `webpack`, `webpackClient`, `webpackProd`, `webpackClientProd`.
|
|
59
|
+
- `webpack.server.dev` - конфигурация для серверного webpack в dev режиме.
|
|
60
|
+
Ключи: `webpack`, `webpackServer`, `webpackDev`, `webpackServerDev`.
|
|
61
|
+
- `webpack.server.prod` - конфигурация для серверного webpack в prod режиме.
|
|
62
|
+
Ключи: `webpack`, `webpackServer`, `webpackProd`, `webpackServerProd`.
|
|
63
|
+
- `supporting-browsers` - список поддерживаемых браузеров в формате [browserslist](https://github.com/browserslist/browserslist).
|
|
64
|
+
Альтернативно вы можете использовать любые методы передачи списка браузеров, поддерживаемые пакетом browserslist.
|
|
65
|
+
Ключи: `browsers`, `supportingBrowsers`
|
|
66
|
+
- `supportingNode` - список поддерживаемых версий nodejs в формате [browserslist](https://github.com/browserslist/browserslist).
|
|
67
|
+
- `Dockerfile` - :warning: устарел, см. врезку ниже. Докерфайл, который будет использоваться для сборки контейнера.
|
|
68
|
+
Базовый шаблон [тут](../../arui-scripts-artifacts/src/docker/templates/dockerfile.template.ts).
|
|
69
|
+
[`Dockerfile` в корне проекта](#docker) имеет приоритет над overrides.
|
|
70
|
+
- `DockerfileCompiled` - :warning: устарел. Докерфайл, который будет использоваться для сборки контейнера при использовании команды `arui-scripts docker-build:compiled`
|
|
71
|
+
- `nginx` - :warning: устарел. Шаблон конфигурации для nginx внутри контейнера.
|
|
72
|
+
Базовый шаблон [тут](../../arui-scripts-artifacts/src/nginx/templates/nginx.conf.template.ts).
|
|
73
|
+
[Файл `nginx.conf`](nginx.md) в корне имеет приоритет над оверрайдами.
|
|
74
|
+
- `nginxConf` - :warning: устарел. Шаблон базовой конфигурации для nginx внутри контейнера
|
|
75
|
+
Базовый шаблон аналогичный тому, который добавлется в базовый образ [тут](../../arui-scripts-artifacts/src/nginx/templates/base-nginx.conf.template.ts).
|
|
76
|
+
[Файл `base-nginx.conf`](base-nginx.md) в корне имеет приоритет над оверрайдами.
|
|
77
|
+
- `start.sh` - :warning: устарел. Шаблон entrypoint докер контейнера. Базовый шаблон [тут](../../arui-scripts-artifacts/src/start-script/start.template.ts).
|
|
78
|
+
- `serverExternalsExemptions` - список модулей, которые не будут добавлены в список внешних зависимостей сервера. [Подробнее](caveats.md#node-externals).
|
|
79
|
+
- `html` - шаблон для htmlWebpackPlugin, будет использоваться только в режиме [`clientOnly`](./settings.md#clientonly).
|
|
80
|
+
- `swc-client` - конфигурация `swc` для клиентского кода. Ключи: `swc`, `swcClient`.
|
|
81
|
+
- `swc-server` - конфигурация `swc` для серверного кода. Ключи: `swc`, `swcServer`.
|
|
82
|
+
- `swc-jest` - конфигурация `swc` для тестов. Ключи: `swc`, `swcJest`.
|
|
83
|
+
|
|
84
|
+
Для некоторых конфигураций определены несколько ключей, они будут применяться в том порядке, в котором они приведены в этом файле.
|
|
85
|
+
|
|
86
|
+
> ⚠️ Оверрайды файлов артефакта поставки (`Dockerfile`, `DockerfileCompiled`, `nginx`, `nginxConf`,
|
|
87
|
+
> `start.sh`) объявлены устаревшими и будут удалены в следующей мажорной версии arui-scripts.
|
|
88
|
+
> Переносите их в секцию `overrides` конфига `arui-scripts-artifacts.ts`
|
|
89
|
+
> ([таблица соответствия](../../arui-scripts-artifacts/README.md#миграция-с-arui-scripts-docker-build)).
|
|
90
|
+
> Команды сборки предупреждают о таких оверрайдах в консоли.
|
|
91
|
+
|
|
92
|
+
### Создание дополнительных конфигураций для webpack
|
|
93
|
+
На некоторых проектах может потребоваться создать дополнительные конфигурации для webpack. Например, для создания
|
|
94
|
+
service worker'а (или любых других кейсов). Для этого можно использовать функцию-хелпер `createSingleWebpackConfig`:
|
|
95
|
+
|
|
96
|
+
```ts
|
|
97
|
+
import type { OverrideFile } from 'arui-scripts';
|
|
98
|
+
|
|
99
|
+
const overrides: OverrideFile = {
|
|
100
|
+
webpackClient: (config, appConfig, { createSingleClientWebpackConfig }) => {
|
|
101
|
+
return [
|
|
102
|
+
config,
|
|
103
|
+
createSingleClientWebpackConfig(
|
|
104
|
+
'./src/sw.js', // entrypoint, может быть массивом/объектом
|
|
105
|
+
'sw', // наименование сборки, влияет на имена чанков
|
|
106
|
+
),
|
|
107
|
+
];
|
|
108
|
+
}
|
|
109
|
+
};
|
|
110
|
+
|
|
111
|
+
export default overrides;
|
|
112
|
+
```
|
|
113
|
+
Эта функция вернет независимую конфигурацию для webpack, которую можно использовать в качестве оверрайда. Вы так же можете ее модифицировать,
|
|
114
|
+
не боясь что это повлияет на другие конфигурации.
|
|
115
|
+
|
|
116
|
+
Созданная таким образом конфигурация будет шарить с оригинальной конфигурацией только плагин для формирования assets-manifest'а.
|
|
117
|
+
|
|
118
|
+
### Переопределение плагинов или загрузчиков для конфигураций webpack
|
|
119
|
+
Иногда может понадобиться возможность поменять конфигурацию конкретного загрузчика или плагина, для этого в `webpackClient`, `webpackClientDev`, `webpackServer` и `webpackServerDev` третьим параметром можно получить хелпер-функции `findLoader` и `findPlugin`:
|
|
120
|
+
```ts
|
|
121
|
+
import type { OverrideFile } from 'arui-scripts';
|
|
122
|
+
|
|
123
|
+
const overrides: OverrideFile = {
|
|
124
|
+
webpackClient: (config, appConfig, { findLoader, findPlugin }) => {
|
|
125
|
+
// ...
|
|
126
|
+
}
|
|
127
|
+
};
|
|
128
|
+
|
|
129
|
+
export default overrides;
|
|
130
|
+
```
|
|
131
|
+
- `findLoader` - помогает найти загрузчик для переопределения. Функция возвращает ссылку, поэтому вы можете спокойно мутировать этот результат и обходиться без создания нового объекта через spread-оператор. В качестве аргументов принимает `config` и `testRule`, по которому будет искаться загрузчик. Пример:
|
|
132
|
+
```ts
|
|
133
|
+
import type { OverrideFile } from 'arui-scripts';
|
|
134
|
+
|
|
135
|
+
const overrides: OverrideFile = {
|
|
136
|
+
webpackClient: (config, appConfig, { findLoader }) => {
|
|
137
|
+
const cssModulesLoader = findLoader(config, '/\\.module\\.css$/')
|
|
138
|
+
const currentCssLoader = cssModulesLoader.use.find((cssLoader) => {
|
|
139
|
+
return cssLoader.loader.includes('css-loader') && !cssLoader.loader.includes('postcss-loader')
|
|
140
|
+
})
|
|
141
|
+
|
|
142
|
+
currentCssLoader.options.modules = {
|
|
143
|
+
localIdentName: '[name]-[local]-[hash:base64:5]'
|
|
144
|
+
}
|
|
145
|
+
|
|
146
|
+
return config
|
|
147
|
+
}
|
|
148
|
+
};
|
|
149
|
+
|
|
150
|
+
export default overrides
|
|
151
|
+
```
|
|
152
|
+
- `findPlugin` - помогает найти плагин для переопределения. Функция так же возвращает ссылку. В качестве аргументов принимает `config` и название плагина. Все типизировано, поэтому название можете достать из автокомплита. для `webpackClient` и `webpackClientDev` из автокомплита будут приходить клиентские плагины, а для `webpackServer` и `webpackServerDev` серверные. Примеры:
|
|
153
|
+
```ts
|
|
154
|
+
import type { OverrideFile } from 'arui-scripts';
|
|
155
|
+
|
|
156
|
+
const overrides: OverrideFile = {
|
|
157
|
+
webpackClient: (config, appConfig, { findPlugin }) => {
|
|
158
|
+
const [MiniCssExtractPlugin] = findPlugin(config, 'MiniCssExtractPlugin')
|
|
159
|
+
|
|
160
|
+
// возвращаемые плагины так же типизированы
|
|
161
|
+
MiniCssExtractPlugin.options.ignoreOrder = false
|
|
162
|
+
|
|
163
|
+
return config
|
|
164
|
+
},
|
|
165
|
+
webpackServerDev: (config, appConfig, { findPlugin }) => {
|
|
166
|
+
const [BannerPlugin] = findPlugin(config, 'BannerPlugin');
|
|
167
|
+
|
|
168
|
+
BannerPlugin.options.banner = 'unexpected error';
|
|
169
|
+
|
|
170
|
+
return config
|
|
171
|
+
}
|
|
172
|
+
};
|
|
173
|
+
|
|
174
|
+
export default overrides
|
|
175
|
+
```
|
package/docs/presets.md
ADDED
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
Пресеты
|
|
2
|
+
===
|
|
3
|
+
|
|
4
|
+
В случае, если вы хотите использовать определенный набор конфигураций и оверрайдов сразу в нескольких проектах - вам может
|
|
5
|
+
помочь механизм пресетов. Он позволяет выносить конфигурацию и оверрайды в отдельный пакет.
|
|
6
|
+
Для того, чтобы использовать пресеты на проекте, вы должны указать в настройках проекта имя пакета с пресетами:
|
|
7
|
+
|
|
8
|
+
```json
|
|
9
|
+
{
|
|
10
|
+
"aruiScripts": {
|
|
11
|
+
"presets": "my-company-presets"
|
|
12
|
+
}
|
|
13
|
+
}
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
Как пресет должен быть указан путь до папки с общими настройками (для поиска пути будет использоваться `require.resolve`
|
|
17
|
+
от папки, содержащей package.json. Так что это может быть как папка в проекте, так и пакет из node_modules).
|
|
18
|
+
|
|
19
|
+
Сам пакет с пресетами может содержать два файла:
|
|
20
|
+
- `arui-scripts.config.js` (или `arui-scripts.config.ts`)
|
|
21
|
+
- `arui-scripts.overrides.js` (или `arui-scripts.overrides.ts`)
|
|
22
|
+
|
|
23
|
+
### arui-scripts.config (js | ts)
|
|
24
|
+
С помощью этого файла можно задать любые ключи [конфигурации](settings.md).
|
|
25
|
+
```js
|
|
26
|
+
module.exports = {
|
|
27
|
+
baseDockerImage: 'my-company-artifactory.com/arui-scripts-base:11.2'
|
|
28
|
+
};
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
Или в виде ts:
|
|
32
|
+
```ts
|
|
33
|
+
import type { PackageSettings } from 'arui-scripts';
|
|
34
|
+
|
|
35
|
+
const settings: PackageSettings = {
|
|
36
|
+
baseDockerImage: 'my-company-artifactory.com/arui-scripts-base:11.2'
|
|
37
|
+
};
|
|
38
|
+
|
|
39
|
+
export default settings;
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
На проекте конфигурация будет загружаться в следующем порядке:
|
|
43
|
+
1. базовые настройки из arui-scripts
|
|
44
|
+
2. настройки из presets
|
|
45
|
+
3. настройки из package.json проекта
|
|
46
|
+
4. настройки, переданные через env переменную.
|
|
47
|
+
|
|
48
|
+
**Важно!**
|
|
49
|
+
|
|
50
|
+
Если вы будете задавать относительные пути через общие конфигурации (например `serverEntry`, `additionalBuildPath` и другие),
|
|
51
|
+
они будут вычисляться относительно корня проекта, а не вашей конфигурации.
|
|
52
|
+
Вы можете использовать абсолютные пути при необходимости задать путь до файла внутри пакета с пресетами.
|
|
53
|
+
|
|
54
|
+
### arui-scripts.overrides (js | ts)
|
|
55
|
+
С помощью этого файла можно задать базовые оверрайды проекта, аналогично [заданию оверрайдов на проекте](overrides.md).
|
|
56
|
+
```js
|
|
57
|
+
module.exports = {
|
|
58
|
+
babelClient(config) {
|
|
59
|
+
config.plugins.push('my-awesome-babel-plugin');
|
|
60
|
+
return config;
|
|
61
|
+
}
|
|
62
|
+
};
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
На проекте оверрайды из пресетов будут выполняться в первую очередь, после них будут выполняться оверрайды из проекта.
|
package/docs/settings.md
ADDED
|
@@ -0,0 +1,336 @@
|
|
|
1
|
+
Настройка arui-scripts
|
|
2
|
+
===
|
|
3
|
+
|
|
4
|
+
`arui-scripts` - гибкий инструмент, и зачастую вам необходимо настроить его под свои нужды.
|
|
5
|
+
|
|
6
|
+
Для этого предусмотрено несколько механизмов:
|
|
7
|
+
|
|
8
|
+
1. [Пресеты](presets.md)
|
|
9
|
+
2. Настройки в `package.json` (см. раздел [настройка через package.json](#настройка-через-packagejson))
|
|
10
|
+
3. [Конфигурационный файл](#Конфигурационный-файл)
|
|
11
|
+
4. [Переменные окружения](#переменные-окружения)
|
|
12
|
+
|
|
13
|
+
Если вы задаете одну и ту же настройку в разных местах, то она будет применена именно в том порядке, в котором они перечислены выше.
|
|
14
|
+
|
|
15
|
+
Предпочтительным способом настройки является использование конфигурационного файла.
|
|
16
|
+
|
|
17
|
+
## Механизмы настройки
|
|
18
|
+
|
|
19
|
+
### Настройка через package.json
|
|
20
|
+
Пример настройки через package.json:
|
|
21
|
+
```json
|
|
22
|
+
{
|
|
23
|
+
"aruiScripts": {
|
|
24
|
+
"clientEntry": {
|
|
25
|
+
"mobile": "./src/mobile",
|
|
26
|
+
"desktop": "./src/desktop"
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
### Конфигурационный файл - arui-scripts.config (js | ts)
|
|
33
|
+
Пример конфигурационного файла:
|
|
34
|
+
|
|
35
|
+
```ts
|
|
36
|
+
import { PackageSettings } from 'arui-scripts';
|
|
37
|
+
|
|
38
|
+
const settings: PackageSettings = {
|
|
39
|
+
clientEntry: {
|
|
40
|
+
mobile: './src/mobile',
|
|
41
|
+
desktop: './src/desktop',
|
|
42
|
+
},
|
|
43
|
+
};
|
|
44
|
+
|
|
45
|
+
export default settings;
|
|
46
|
+
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
### Переменные окружения
|
|
50
|
+
Использование переменных окружения для настройки может быть полезным для отладки или использования в специфических сценариях на CI.
|
|
51
|
+
|
|
52
|
+
Пример настройки через переменные окружения:
|
|
53
|
+
```bash
|
|
54
|
+
ARUI_SCRIPTS_CONFIG="{\"clientEntry\":{\"mobile\":\"./src/mobile\",\"desktop\":\"./src/desktop\"}}" yarn start
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
## Список настроек
|
|
58
|
+
|
|
59
|
+
### Общие настройки
|
|
60
|
+
#### clientServerPort
|
|
61
|
+
Порт WebpackDevServer и nginx итогового контейнера. По умолчанию `8080`.
|
|
62
|
+
|
|
63
|
+
#### serverPort
|
|
64
|
+
Порт нодового сервера. Нужен для правильного проксирования запросов от дев сервера и nginx. По умолчанию `3000`.
|
|
65
|
+
|
|
66
|
+
#### debug
|
|
67
|
+
Режим отладки, в котором не выполняются некоторые нежелательные операции и выводится больше сообщений об ошибках, по умолчанию `false`.
|
|
68
|
+
|
|
69
|
+
#### devSourceMaps
|
|
70
|
+
Какой вид source-map использовать в режиме разработки. По умолчанию `inline-cheap-source-map`. Эта настройка может сильно влиять на время сборки.
|
|
71
|
+
Подробнее можно почитать [здесь](https://webpack.js.org/configuration/devtool/).
|
|
72
|
+
|
|
73
|
+
:warning: **Внимание**. При использовании любых source-map на основании eval webpack-dev-server будет
|
|
74
|
+
модифицировать заголовок `Content-Security-Policy` (при наличии) и добавлять в разрешенные источники для `script-src` `unsafe-eval`.
|
|
75
|
+
|
|
76
|
+
Это необходимо для того, чтобы код вообще запускался в браузере. Это не влияет на реальную безопасность приложения,
|
|
77
|
+
так как используется ТОЛЬКО в дев-режиме. Если по каким-то причинам вас такое поведение не устраивает - вы можете поменять
|
|
78
|
+
тип source-map на любой другой, не использующий eval.
|
|
79
|
+
|
|
80
|
+
#### devServerCors
|
|
81
|
+
Включает добавление CORS заголовков в ответы dev-сервера. По умолчанию `false`.
|
|
82
|
+
|
|
83
|
+
#### useServerHMR
|
|
84
|
+
Использовать ли HotModuleReplacement для сервера. По умолчанию `false`.
|
|
85
|
+
|
|
86
|
+
#### presets
|
|
87
|
+
Пресеты, которые будут использоваться для настройки сборки. См. [пресеты](presets.md).
|
|
88
|
+
|
|
89
|
+
#### proxy
|
|
90
|
+
Позволяет настроить проксирование запросов в dev-режиме. По умолчанию `[]`. Так же этот параметр можно задать в `package.json`.
|
|
91
|
+
|
|
92
|
+
В случае, если ваш фронт должен обращаться к API, отличному от вашего nodejs сервера, в **дев режиме** вы можете настроить проксирование запросов.
|
|
93
|
+
|
|
94
|
+
Например:
|
|
95
|
+
|
|
96
|
+
```ts
|
|
97
|
+
import { PackageSettings } from 'arui-scripts';
|
|
98
|
+
|
|
99
|
+
const settings: PackageSettings = {
|
|
100
|
+
proxy: [
|
|
101
|
+
{
|
|
102
|
+
context: '/corp-shared-ui',
|
|
103
|
+
target: 'http://some-other-host',
|
|
104
|
+
headers: {
|
|
105
|
+
host: 'some-other-host',
|
|
106
|
+
},
|
|
107
|
+
},
|
|
108
|
+
],
|
|
109
|
+
};
|
|
110
|
+
|
|
111
|
+
export default settings;
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
Такая конфигурация будет проксировать запросы к `http://localhost:8080/corp-shared-ui/` на `http://some-other-host/corp-shared-ui`.
|
|
115
|
+
Подробнее о конфигурации прокси сервера можно почитать в [документации rspack](https://rspack.dev/guide/features/dev-server#proxy).
|
|
116
|
+
|
|
117
|
+
:warning: Эта настройка работает только в **дев режиме**.
|
|
118
|
+
|
|
119
|
+
#### clientOnly
|
|
120
|
+
Позволяет отключить сборку сервера, оставив только клиентскую часть. По умолчанию `false`. Подробнее можно прочитать в
|
|
121
|
+
[документации client-only режима](./client-only.md).
|
|
122
|
+
|
|
123
|
+
|
|
124
|
+
### Настройки путей
|
|
125
|
+
|
|
126
|
+
#### buildPath
|
|
127
|
+
Папка, в которую будет производиться сборка. По умолчанию `.build`
|
|
128
|
+
|
|
129
|
+
#### assetsPath
|
|
130
|
+
Папка, в которую будут попадать статические файлы. По умолчанию `assets`.
|
|
131
|
+
|
|
132
|
+
#### additionalBuildPath
|
|
133
|
+
Массив путей, которые попадут в архив при использовании [команды archive-build](./commands.md#archive-build). По умолчанию `['config']`.
|
|
134
|
+
|
|
135
|
+
:warning: Настройка устарела, см. [настройки сборки артефактов](#настройки-сборки-артефактов).
|
|
136
|
+
Замена — `archive.additionalPaths` в конфиге `arui-scripts-artifacts.ts`.
|
|
137
|
+
|
|
138
|
+
#### statsOutputFilename
|
|
139
|
+
Имя [stats-файла](https://webpack.js.org/api/stats/), которое будет использоваться в [bundle-analyze команде](./commands.md#bundle-analyze). По умолчанию `stats.json`
|
|
140
|
+
|
|
141
|
+
#### serverEntry
|
|
142
|
+
Точка входа для исходников сервера, по умолчанию `./src/server/index`
|
|
143
|
+
|
|
144
|
+
#### serverOutput
|
|
145
|
+
Имя файла для компиляции сервера, по умолчанию `server.js`
|
|
146
|
+
|
|
147
|
+
#### clientPolyfillsEntry
|
|
148
|
+
Точка входа для полифилов. Будет подключаться до основной клиентской точки входа (можно передать одну строку или массив путей или не задавать, тогда отдельный бандл полифилов не добавляется).
|
|
149
|
+
|
|
150
|
+
По умолчанию ключ не задан: для многих проектов отдельный файл не нужен. Если нужны полифилы при `codeLoader: 'swc'` или Babel с `useBuiltIns: 'entry'`, обычно создают файл с `import 'core-js/stable'` и указывают путь в этом поле (пакет `core-js` должен быть в зависимостях приложения). Пример для новых проектов см. в [README](../README.md).
|
|
151
|
+
|
|
152
|
+
#### clientEntry
|
|
153
|
+
Точка входа для клиентского приложения. По умолчанию `./src/index`.
|
|
154
|
+
|
|
155
|
+
Этот ключ принимает не только строки, но и любые возможные в [webpack варианты](https://webpack.js.org/concepts/entry-points/).
|
|
156
|
+
Например, вы можете создать две отдельных входных точки для мобильной и десктопной версии приложения:
|
|
157
|
+
|
|
158
|
+
```ts
|
|
159
|
+
const settings = {
|
|
160
|
+
clientEntry: {
|
|
161
|
+
mobile: './src/mobile',
|
|
162
|
+
desktop: './src/desktop',
|
|
163
|
+
},
|
|
164
|
+
};
|
|
165
|
+
```
|
|
166
|
+
|
|
167
|
+
Ко всем клиентским entryPoint так же будут добавлены `clientPolyfillsEntry` (если задан)
|
|
168
|
+
и, в dev режиме, необходимые для hot-module-reload файлы
|
|
169
|
+
|
|
170
|
+
### Настройки сборки артефактов
|
|
171
|
+
|
|
172
|
+
> ⚠️ **Объявлены устаревшими.** Эти настройки arui-scripts просто транслирует в
|
|
173
|
+
> [@alfalab/arui-scripts-artifacts](../../arui-scripts-artifacts/README.md), где и живут их значения по
|
|
174
|
+
> умолчанию. В следующей мажорной версии arui-scripts они будут удалены — переносите их в конфиг
|
|
175
|
+
> `arui-scripts-artifacts.ts` в корне проекта (таблица соответствия — в
|
|
176
|
+
> [README пакета](../../arui-scripts-artifacts/README.md#миграция-с-arui-scripts-docker-build)).
|
|
177
|
+
> Команды сборки предупреждают о таких настройках в консоли.
|
|
178
|
+
|
|
179
|
+
#### dockerRegistry
|
|
180
|
+
Адрес используемого docker registry, по умолчанию `''`, то есть используется публичный registry
|
|
181
|
+
|
|
182
|
+
#### baseDockerImage
|
|
183
|
+
Имя базового образа, используемого для построения docker образа. По умолчанию `'alfabankui/arui-scripts:latest'`
|
|
184
|
+
|
|
185
|
+
#### nginxRootPath
|
|
186
|
+
Базовый путь, до файлов в контейнере, который будет использоваться в nginx. По умолчанию `'/src'`.
|
|
187
|
+
|
|
188
|
+
#### nginx
|
|
189
|
+
|
|
190
|
+
Некоторые настройки для базовой конфигурации `nginx` (`/etc/nginx/nginx.conf`).
|
|
191
|
+
|
|
192
|
+
```ts
|
|
193
|
+
const settings = {
|
|
194
|
+
nginx: {
|
|
195
|
+
workerProcesses: 2,
|
|
196
|
+
workerRlimitNoFile: 20000,
|
|
197
|
+
workerConnections: 19000,
|
|
198
|
+
eventsUse: 'epoll',
|
|
199
|
+
daemon: 'off'
|
|
200
|
+
},
|
|
201
|
+
};
|
|
202
|
+
```
|
|
203
|
+
|
|
204
|
+
#### runFromNonRootUser
|
|
205
|
+
Сборка образа под пользователем nginx. Нужна для совместимости с k8s, т.к там зачастую запрещен запуск контейнера из под root По умолчанию `true`.
|
|
206
|
+
|
|
207
|
+
#### removeDevDependenciesDuringDockerBuild
|
|
208
|
+
Отключает удаление devDependencies из node_modules при сборке докер образа. Используется когда вам не нужно удалять devDependencies,
|
|
209
|
+
т.к. в своём Dockerfile вы не переносите node_modules в докер-контейнер. По умолчанию `true`.
|
|
210
|
+
|
|
211
|
+
#### archiveName
|
|
212
|
+
Имя архива, который будет создан при использовании команды [archive-build](./commands.md#archive-build). По умолчанию `'build.tar'`.
|
|
213
|
+
|
|
214
|
+
#### dictionaryCompression
|
|
215
|
+
|
|
216
|
+
Настройки сжатия со словарём. Используется для сжатия ассетов с поддержкой compression dictionary transport.
|
|
217
|
+
|
|
218
|
+
- `dictionaryCompression.dictionaryPath` - массив строк с путями до предыдущих версий ассетов или словарей, с помощью которых будет сжат бандл приложения.
|
|
219
|
+
- `dictionaryCompression.enablePreviousVersionHeaders` - включает автоматическую простановку заголовков `Use-As-Dictionary` для использования ресурсов приложения как словарей. Можно включать только при использовании последних версий базовых докер-образов.
|
|
220
|
+
|
|
221
|
+
Если `dictionaryPath` содержит путь до единичного файла - этот файл будет использован как словарь для сжатия всех ассетов приложения.
|
|
222
|
+
Сам словарь так же будет добавлен в сборку и сжат с помощью brotli.
|
|
223
|
+
|
|
224
|
+
Если `dictionaryPath` содержит путь до папки - эта папка будет рассматриваться как папка с предыдущей версией приложения. Файлы из текущей сборки будут сжиматься с помощью совпадающих файлов предыдущей версии.
|
|
225
|
+
|
|
226
|
+
Подробнее об этой фиче можно почитать в [отдельном документе](./compression-dictionary).
|
|
227
|
+
|
|
228
|
+
### Модификация сборки
|
|
229
|
+
#### keepPropTypes
|
|
230
|
+
Позволяет отключить удаление `prop-types` из бандла. По умолчанию `false`.
|
|
231
|
+
|
|
232
|
+
Так как в production режими proptypes не проверяются, их имеет смысл удалить из production сборки.
|
|
233
|
+
|
|
234
|
+
Сами объявления proptypes удаляются с помощью [babel-plugin-transform-react-remove-prop-types](https://www.npmjs.com/package/babel-plugin-transform-react-remove-prop-types).
|
|
235
|
+
Но импорты пакетов `prop-types` при этом не удаляются. Чтобы это реализовать, используется `webpack.NormalModuleReplacementPlugin`.
|
|
236
|
+
С помощью него заменяются на пустышку пакеты, попадающие под маску:
|
|
237
|
+
|
|
238
|
+
- `/^react-style-proptype$/`
|
|
239
|
+
- `/^thrift-services\/proptypes/`
|
|
240
|
+
|
|
241
|
+
#### codeLoader
|
|
242
|
+
Позволяет выбрать какой инструмент использовать для обработки js и ts кода приложения. По умолчанию `swc`.
|
|
243
|
+
|
|
244
|
+
Возможные значения:
|
|
245
|
+
- `babel` - для всего кода будет использоваться `babel-loader`;
|
|
246
|
+
- `tsc` - для ts кода будет использоваться `ts-loader`, для всего остального - `babel-loader`;
|
|
247
|
+
- `swc` - для всего кода будет использоваться `swc-loader`.
|
|
248
|
+
|
|
249
|
+
`swc` является предпочтительным режимом, дефолты не меняются для сохранения обратной совместимости.
|
|
250
|
+
Использование swc позволяет значительно ускорить сборку (до 2 раз на больших проектах), но не будет создавать полностью идентичный с babel код.
|
|
251
|
+
Итоговый бандл может получиться немного больше, чем при использовании babel, но разница полностью компенсируется при использовании сжатия.
|
|
252
|
+
|
|
253
|
+
#### experimentalReactCompiler
|
|
254
|
+
Позволяет включить [react-compiler](https://react.dev/learn/react-compiler/introduction) в вашем проекте. **Внимание!** Этот режим находится в статусе эксперимента и использовать его в продакшене на данный момент не рекомендуется!
|
|
255
|
+
|
|
256
|
+
Включение этой опции на данный момент поддерживается только вместе с `codeLoader=swc`.
|
|
257
|
+
|
|
258
|
+
Возможные значения:
|
|
259
|
+
- `disabled` - дефолт, react-compiler выключен
|
|
260
|
+
- `ReactCompilerOptions` - [конфигурация](https://react.dev/reference/react-compiler/configuration) компилятора.
|
|
261
|
+
|
|
262
|
+
При использовании с react < 19 вам необходимо добавить в зависимости вашего проекта `react-compiler-runtime` и использовать настройку `target`, например:
|
|
263
|
+
```ts
|
|
264
|
+
const packageSettings = {
|
|
265
|
+
// ...
|
|
266
|
+
experimentalReactCompiler: {
|
|
267
|
+
target: '18', // или '17'
|
|
268
|
+
},
|
|
269
|
+
};
|
|
270
|
+
```
|
|
271
|
+
|
|
272
|
+
#### installServerSourceMaps
|
|
273
|
+
Добавлять ли в серверную сборку пакет source-map-support. По умолчанию `false`.
|
|
274
|
+
|
|
275
|
+
#### jestCodeTransformer
|
|
276
|
+
Позволяет выбрать какой инструмент использовать для обработки js и ts кода приложения при запуске тестов. По умолчанию `swc`.
|
|
277
|
+
|
|
278
|
+
Возможные значения:
|
|
279
|
+
- `babel` - для всего кода будет использоваться `babel-jest`;
|
|
280
|
+
- `tsc` - для ts кода будет использоваться `ts-jest`, для всего остального - `babel-jest`;
|
|
281
|
+
- `swc` - для всего кода будет использоваться `@swc/jest`.
|
|
282
|
+
Swc более строго следует спецификациям и [не дает возможности](https://github.com/swc-project/swc/issues/5059) делать `spyOn` для экспортов из esm модулей.
|
|
283
|
+
|
|
284
|
+
#### collectCoverage
|
|
285
|
+
Добавлять ли инструменты для сборки coverage при сборке. По умолчанию определяется по env переменным - будет выставлено в `true` если `NODE_ENV = 'cypress'` или `USE_ISTANBUL = 'enabled'`.
|
|
286
|
+
Сбор coverage не будет работать при использовании `codeLoader=tsc`.
|
|
287
|
+
|
|
288
|
+
#### disableDevWebpackTypecheck
|
|
289
|
+
Выключает проверку типов вебпаком во время разработки. По умолчанию `true`.
|
|
290
|
+
Вместо этого будет запускаться отдельный процесс `tsc`, который будет выдавать сообщения об ошибках в типах только в консоль.
|
|
291
|
+
|
|
292
|
+
#### nodeExternals
|
|
293
|
+
Настройки для `webpack-node-externals`, см. [документацию](https://www.npmjs.com/package/webpack-node-externals). По умолчанию `{ modulesFromFile: true }`.
|
|
294
|
+
|
|
295
|
+
`allowlist` настраивается через систему [оверайдов](overrides.md), свойство `serverExternalsExemptions`
|
|
296
|
+
|
|
297
|
+
### Обработка изображений
|
|
298
|
+
#### dataUrlMaxSize
|
|
299
|
+
Ресурсы, не превышающие данный размер (в байтах), будут включены в исходники `inline`, иначе вынесены в отдельный файл. По умолчанию `1536`.
|
|
300
|
+
|
|
301
|
+
#### imageMinimizer
|
|
302
|
+
Раздел настроек, связанных с оптимизацией графики.
|
|
303
|
+
|
|
304
|
+
:warning: **Внимание!** Если вы планируете использовать любые `imagemin`-плагины, кроме `svgo`, необходимо установить их дополнительно. <br/>
|
|
305
|
+
Так как после установки плагинам необходим прямой доступ в сеть для скачивания утилит (`cjpeg` и пр.), они указаны в `peerDependencies` `arui-scripts`, чтобы не приводить к ошибкам в закрытых контурах.<br/><br/>
|
|
306
|
+
|
|
307
|
+
- `imageMinimizer.svg.enabled` - включает/отключает оптимизацию `svg`. По умолчанию `true`.
|
|
308
|
+
- `imageMinimizer.gif.enabled` - включает/отключает оптимизацию `gif`. По умолчанию `false`.
|
|
309
|
+
- `imageMinimizer.gif.optimizationLevel` - уровень сжатия `gif`. От `1` до `3`. По умолчанию `1`.
|
|
310
|
+
- `imageMinimizer.jpg.enabled` - включает/отключает оптимизацию `jpg`. По умолчанию `false`.
|
|
311
|
+
- `imageMinimizer.jpg.quality` - качество выходного файла. От `0` до `100`. По умолчанию `75`.
|
|
312
|
+
- `imageMinimizer.png.enabled` - включает/отключает оптимизацию `png`. По умолчанию `false`. О структуре формата png и влиянии описанных далее оптимизаций можно прочитать [здесь](https://www.w3.org/TR/PNG-Chunks.html)
|
|
313
|
+
- `imageMinimizer.png.optimizationLevel` - уровень сжатия `png`. От `0` до `7`. По умолчанию `3`. [Подробнее](https://github.com/imagemin/imagemin-optipng#optimizationlevel)
|
|
314
|
+
- `imageMinimizer.png.bitDepthReduction` - допускает уменьшение глубины цвета изображения. По умолчанию `false`. [Подробнее](https://github.com/imagemin/imagemin-optipng#bitdepthreduction)
|
|
315
|
+
- `imageMinimizer.png.colorTypeReduction` - допускает изменение представления изображения (оттенки серого / прозрачность / пр.). По умолчанию `false`. [Подробнее](https://github.com/imagemin/imagemin-optipng#colortypereduction)
|
|
316
|
+
- `imageMinimizer.png.paletteReduction` - допускает уменьшение палитры изображения. По умолчанию `false`. [Подробнее](https://github.com/imagemin/imagemin-optipng#palettereduction)
|
|
317
|
+
- `imageMinimizer.png.interlaced` - потоковый порядок передачи изображение. По умолчанию этот параметр идентичен значению из входного изображения. [Подробнее](https://github.com/imagemin/imagemin-optipng#interlaced)
|
|
318
|
+
|
|
319
|
+
### Обработка стилей
|
|
320
|
+
#### componentsTheme
|
|
321
|
+
Путь к css файлу с темой для [core-components](https://github.com/core-ds/core-components). По умолчанию `null`.
|
|
322
|
+
|
|
323
|
+
#### keepCssVars
|
|
324
|
+
Отключает postcss-custom-properties, css переменные будут оставаться в бандле. По умолчанию `false`.
|
|
325
|
+
|
|
326
|
+
### Модули
|
|
327
|
+
|
|
328
|
+
#### modules
|
|
329
|
+
Позволяет настроить работу с модулями. По умолчанию `{}`. Подробнее в разделе [модули](modules.md).
|
|
330
|
+
|
|
331
|
+
#### compatModules
|
|
332
|
+
Позволяет настроить работу с `compat` модулями. По умолчанию `{}`. Подробнее в разделе [модули](modules.md).
|
|
333
|
+
|
|
334
|
+
#### disableModulesSupport
|
|
335
|
+
Полностью выключает любые манипуляции с WMF плагином. По умолчанию `false`.
|
|
336
|
+
Нужно для проектов, которые хотят реализовывать модули самостоятельно, чтобы избежать конфликтов в конфигурации плагинов.
|