arui-scripts 23.8.1 → 23.9.0

package/.turbo/turbo-test.log

@@ -1,25 +1,25 @@
 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/templates/__tests__/dockerfile-templates.tests.ts (36.188 s)
-PASS src/plugins/postcss-global-variables/utils/__tests__/add-global-variable.tests.ts
+PASS src/plugins/postcss-global-variables/utils/__tests__/add-global-variable.tests.ts (17.834 s)
 PASS src/bin/__tests__/create-cli.tests.ts
 PASS src/configs/app-configs/__tests__/update-with-presets.tests.ts
 PASS src/configs/util/__tests__/create-watch-ignore-regex.tests.ts
 PASS src/configs/util/__tests__/apply-overrides.tests.ts
+PASS src/commands/util/__tests__/artifacts-deprecations.tests.ts
 PASS src/configs/app-configs/__tests__/update-with-env.tests.ts
-PASS src/plugins/__tests__/attribute-module-css.tests.ts (41.808 s)
+PASS src/plugins/__tests__/attribute-module-css.tests.ts (36.576 s)
 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 (7.961 s)
-PASS src/configs/util/__tests__/find-plugin.tests.ts (45.786 s)
+PASS src/configs/__tests__/webpack-client-modules.tests.ts (19.679 s)
+PASS src/configs/util/__tests__/find-plugin.tests.ts (40.022 s)
 
 Test Suites: 16 passed, 16 total
-Tests:       52 passed, 52 total
+Tests:       46 passed, 46 total
 Snapshots:   0 total
-Time:        47.32 s
+Time:        40.869 s
 Ran all test suites.

package/CHANGELOG.md

@@ -1,5 +1,57 @@
 # arui-scripts
 
+## 23.9.0
+
+### Minor Changes
+
+-   [#599](https://github.com/core-ds/arui-scripts/pull/599) [`03f84fad`](https://github.com/core-ds/arui-scripts/commit/03f84fadb4d4a13c455624630d1902113ac29906) Thanks [@Burzachil](https://github.com/Burzachil)! - **Что изменилось**
+    Rspack обновлён с 2.0.0 до 2.2.5 (анонсы [2.1](https://rspack.rs/blog/announcing-2-1) и [2.2](https://rspack.rs/blog/announcing-2-2)): исправлены ошибки генерации кода, утечки памяти в dev-режиме и CSS HMR. Вместе с ним обновлены `@swc/core`, `swc-plugin-coverage-instrument`, `ts-checker-rspack-plugin` (проверка типов в `build` стала быстрее), `@rsdoctor/rspack-plugin` и `rspack-manifest-plugin`.
+
+## 23.8.2
+
+### Patch Changes
+
+-   [#565](https://github.com/core-ds/arui-scripts/pull/565) [`a6c84b42`](https://github.com/core-ds/arui-scripts/commit/a6c84b4246fdeb156da2a0e5980dfba796e2d7d5) Thanks [@sowtame](https://github.com/sowtame)! - Сборка артефактов поставки вынесена в отдельный пакет `@alfalab/arui-scripts-artifacts`.
+
+        Пакет устроен как набор чистых функций и настраивается одним файлом `arui-scripts-artifacts.ts` в
+        корне проекта (путь можно задать через `--c`/`--config`). Конфиг может быть на TypeScript, ESM или
+        CommonJS и описывает всё: базовый образ, параметры nginx, кастомные шаблоны и свои команды сборки —
+        так что кастомные сборочные скрипты в проектах больше не нужны.
+
+        Поддерживаются оба типа артефактов: docker-образ (`docker-build`, `docker-build:compiled`) и
+        tar-архив (`archive-build`). Хост-пайплайн (очистка `buildPath` → сборка приложения → удаление
+        dev-зависимостей) у них общий.
+
+        `arui-scripts` теперь использует этот пакет вместо собственной копии шаблонов и утилит. Поведение
+        команд и все ключи оверрайдов (`Dockerfile`, `DockerfileCompiled`, `nginx`, `nginxConf`, `start.sh`)
+        сохранены без изменений — отрендеренные Dockerfile, nginx-конфиги и start.sh совпадают побайтово.
+
+        Попутно починен `archive-build`: он падал с `TypeError: Cannot read properties of undefined
+
+    (reading 'c')`, потому что в `tar@7`нет default-экспорта, а код использовал`import tar from 'tar'`.
+
+        Команды `arui-scripts docker-build`, `docker-build:compiled` и `archive-build` теперь запускают CLI
+        `@alfalab/arui-scripts-artifacts` с конфигом, который arui-scripts возит с собой. Благодаря этому
+        `arui-scripts-artifacts.ts` в корне проекта работает и через команды arui-scripts: он находится по
+        обычным правилам и кладется поверх настроек из конфига arui-scripts. Заводить его по-прежнему не
+        обязательно.
+
+        Настройки сборки артефактов в конфиге arui-scripts (`dockerRegistry`, `baseDockerImage`,
+        `nginxRootPath`, `nginx`, `runFromNonRootUser`, `removeDevDependenciesDuringDockerBuild`,
+        `deleteNpm`, `archiveName`, `additionalBuildPath`) и оверрайды `Dockerfile`, `DockerfileCompiled`, `nginx`,
+        `nginxConf`, `start.sh` объявлены устаревшими: они продолжают работать, но команды сборки печатают
+        предупреждение со ссылкой на замену, а в следующей мажорной версии будут удалены.
+
+        Настройки в конфиге @alfalab/arui-scripts-artifacts сгруппированы по доменам: `docker`, `nginx`, `archive`, `build`,
+        `packageManager`, `localFiles`. Так же разложен и код пакета — по папке на домен.
+
+        Единственное отличие в поведении: `archive-build` теперь подхватывает локальный `start.sh` из корня
+        проекта так же, как уже подхватывал `nginx.conf` (раньше игнорировал). Отключается опцией
+        `localFiles.allowStartScript: false`.
+
+-   Updated dependencies [[`a6c84b42`](https://github.com/core-ds/arui-scripts/commit/a6c84b4246fdeb156da2a0e5980dfba796e2d7d5)]:
+    -   @alfalab/arui-scripts-artifacts@1.0.0
+
 ## 23.8.1
 
 ### Patch Changes

package/build/commands/archive-build/index.js

@@ -8,73 +8,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-const path_1 = __importDefault(require("path"));
-const fs_extra_1 = __importDefault(require("fs-extra"));
-const tar_1 = __importDefault(require("tar"));
-const app_configs_1 = require("../../configs/app-configs");
-const nginx_conf_template_1 = require("../../templates/nginx.conf.template");
-const start_template_1 = require("../../templates/start.template");
-const exec_1 = require("../util/exec");
-const yarn_1 = require("../util/yarn");
-const tempDirName = '.archive-build';
-const nginxConfFileName = 'nginx.conf';
-const startScriptFileName = 'start.sh';
-const nodeModulesDirName = 'node_modules';
-const packageJsonFileName = 'package.json';
-const pathToTempDir = path_1.default.join(app_configs_1.configs.cwd, tempDirName);
-const nginxConfPath = path_1.default.join(pathToTempDir, nginxConfFileName);
-const startScriptPath = path_1.default.join(pathToTempDir, startScriptFileName);
-const nodeModulesPath = path_1.default.join(app_configs_1.configs.cwd, nodeModulesDirName);
-const packageJsonPath = path_1.default.join(app_configs_1.configs.cwd, packageJsonFileName);
+const run_artifacts_cli_1 = require("../util/run-artifacts-cli");
 (() => __awaiter(void 0, void 0, void 0, function* () {
-    try {
-        console.time('Total time');
-        console.time('Setting up time');
-        yield fs_extra_1.default.emptyDir(pathToTempDir);
-        const nginxConf = app_configs_1.configs.localNginxConf
-            ? yield fs_extra_1.default.readFile(app_configs_1.configs.localNginxConf, 'utf8')
-            : nginx_conf_template_1.nginxConfTemplate;
-        yield Promise.all([
-            fs_extra_1.default.writeFile(nginxConfPath, nginxConf, 'utf8'),
-            fs_extra_1.default.writeFile(startScriptPath, start_template_1.startScript, { encoding: 'utf8', mode: 0o555 }),
-            fs_extra_1.default.remove(app_configs_1.configs.buildPath),
-        ]);
-        console.timeEnd('Setting up time');
-        console.time('Build application time');
-        // run build script
-        yield (0, exec_1.exec)('npm run build');
-        console.timeEnd('Build application time');
-        console.time('Remove build dependencies time');
-        const pruneCommand = (0, yarn_1.getPruningCommand)();
-        yield (0, exec_1.exec)(pruneCommand);
-        console.timeEnd('Remove build dependencies time');
-        console.time('Archive build time');
-        yield Promise.all([
-            fs_extra_1.default.copy(app_configs_1.configs.buildPath, path_1.default.join(pathToTempDir, app_configs_1.configs.buildPath)),
-            fs_extra_1.default.copy(nodeModulesPath, path_1.default.join(pathToTempDir, nodeModulesDirName)),
-            fs_extra_1.default.copy(packageJsonPath, path_1.default.join(pathToTempDir, packageJsonFileName)),
-            ...app_configs_1.configs.additionalBuildPath.map((additionalPath) => fs_extra_1.default.copy(path_1.default.join(app_configs_1.configs.cwd, additionalPath), path_1.default.join(pathToTempDir, additionalPath))),
-        ]);
-        yield tar_1.default.c({
-            file: app_configs_1.configs.archiveName,
-            cwd: pathToTempDir,
-        }, fs_extra_1.default.readdirSync(pathToTempDir));
-        console.timeEnd('Archive build time');
-        console.time('Cleanup time');
-        // remove temp directory
-        yield fs_extra_1.default.remove(pathToTempDir);
-        console.timeEnd('Cleanup time');
-        console.timeEnd('Total time');
-    }
-    catch (err) {
-        console.error('Error during archive-build.');
-        if (app_configs_1.configs.debug) {
-            console.error(err);
-        }
-        process.exit(1);
-    }
+    yield (0, run_artifacts_cli_1.runArtifactsCli)('archive-build');
 }))();

package/build/commands/build/build-wrapper.d.ts

@@ -1,4 +1,4 @@
-import { Stats, MultiStats, Configuration } from '@rspack/core';
+import { type Configuration, type MultiStats, type Stats } from '@rspack/core';
 type BuildResult = {
     stats: Stats | MultiStats;
     warnings: string[];

package/build/commands/build/build-wrapper.js

@@ -3,11 +3,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const chalk_1 = __importDefault(require("chalk"));
 const core_1 = require("@rspack/core");
+const chalk_1 = __importDefault(require("chalk"));
 const format_webpack_messages_1 = require("../util/format-webpack-messages");
 function build(config, previousFileSizes) {
-    let compiler = (0, core_1.rspack)(config);
+    const compiler = (0, core_1.rspack)(config);
     return new Promise((resolve, reject) => {
         compiler.run((err, stats) => {
             if (err) {

package/build/commands/build/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-const run_compilers_1 = require("../util/run-compilers");
 const app_configs_1 = require("../../configs/app-configs");
+const run_compilers_1 = require("../util/run-compilers");
 process.env.BABEL_ENV = 'production';
 process.env.NODE_ENV = 'production';
 const compilersCommands = [require.resolve('./client')];

package/build/commands/build/server.js

@@ -4,10 +4,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const chalk_1 = __importDefault(require("chalk"));
-const build_wrapper_1 = __importDefault(require("./build-wrapper"));
 const rspack_server_prod_1 = require("../../configs/rspack.server.prod");
 const supporting_node_1 = require("../../configs/supporting-node");
 const print_build_error_1 = require("../util/print-build-error");
+const build_wrapper_1 = __importDefault(require("./build-wrapper"));
 process.env.BROWSERSLIST = supporting_node_1.supportingNode.join(',');
 console.log(chalk_1.default.magenta('Building server...'));
 (0, build_wrapper_1.default)(rspack_server_prod_1.webpackServerConfig)

package/build/commands/docker-build/index.js

@@ -8,66 +8,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-const fs_extra_1 = __importDefault(require("fs-extra"));
-const app_configs_1 = require("../../configs/app-configs");
-const base_nginx_conf_template_1 = require("../../templates/base-nginx.conf.template");
-const dockerfile_template_1 = require("../../templates/dockerfile.template");
-const nginx_conf_template_1 = require("../../templates/nginx.conf.template");
-const start_template_1 = require("../../templates/start.template");
-const docker_build_1 = require("../util/docker-build");
-const exec_1 = require("../util/exec");
-const yarn_1 = require("../util/yarn");
+const run_artifacts_cli_1 = require("../util/run-artifacts-cli");
 (() => __awaiter(void 0, void 0, void 0, function* () {
-    const { imageFullName, pathToTempDir, tempDirName } = (0, docker_build_1.getBuildParamsFromArgs)();
-    try {
-        console.log(`Build docker image ${imageFullName}`);
-        console.time('Total time');
-        console.time('Setting up time');
-        yield (0, docker_build_1.prepareFilesForDocker)({
-            pathToTempDir,
-            dockerfileTemplate: dockerfile_template_1.dockerfileTemplate,
-            nginxConfTemplate: nginx_conf_template_1.nginxConfTemplate,
-            nginxBaseConfTemplate: base_nginx_conf_template_1.nginxBaseConfTemplate,
-            startScriptTemplate: start_template_1.startScript,
-            allowLocalDockerfile: true,
-            allowLocalStartScript: true,
-            addNodeModulesToDockerIgnore: false,
-        });
-        yield fs_extra_1.default.remove(app_configs_1.configs.buildPath);
-        console.timeEnd('Setting up time');
-        console.time('Build application time');
-        // run build script
-        yield (0, exec_1.exec)('npm run build');
-        console.timeEnd('Build application time');
-        if (app_configs_1.configs.removeDevDependenciesDuringDockerBuild) {
-            console.time('Remove dev dependencies time');
-            const pruneCommand = (0, yarn_1.getPruningCommand)();
-            yield (0, exec_1.exec)(pruneCommand);
-            console.timeEnd('Remove dev dependencies time');
-        }
-        console.time('Build docker image time');
-        yield (0, exec_1.exec)((0, docker_build_1.getDockerBuildCommand)({ tempDirName, imageFullName }));
-        console.timeEnd('Build docker image time');
-        console.time('Cleanup time');
-        // remove temp directory
-        yield fs_extra_1.default.remove(pathToTempDir);
-        // guard against pushing the image during tests
-        if (!app_configs_1.configs.debug) {
-            yield (0, exec_1.exec)(`docker push ${imageFullName}`);
-        }
-        console.timeEnd('Cleanup time');
-        console.timeEnd('Total time');
-    }
-    catch (err) {
-        yield fs_extra_1.default.remove(pathToTempDir);
-        console.error('Error during docker-build.');
-        if (app_configs_1.configs.debug) {
-            console.error(err);
-        }
-        process.exit(1);
-    }
+    yield (0, run_artifacts_cli_1.runArtifactsCli)('docker-build');
 }))();

package/build/commands/docker-build-compiled/index.js

@@ -8,47 +8,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-const fs_extra_1 = __importDefault(require("fs-extra"));
-const app_configs_1 = require("../../configs/app-configs");
-const base_nginx_conf_template_1 = require("../../templates/base-nginx.conf.template");
-const dockerfile_compiled_template_1 = require("../../templates/dockerfile-compiled.template");
-const nginx_conf_template_1 = require("../../templates/nginx.conf.template");
-const start_template_1 = require("../../templates/start.template");
-const docker_build_1 = require("../util/docker-build");
-const exec_1 = require("../util/exec");
+const run_artifacts_cli_1 = require("../util/run-artifacts-cli");
 (() => __awaiter(void 0, void 0, void 0, function* () {
-    const { imageFullName, pathToTempDir, tempDirName } = (0, docker_build_1.getBuildParamsFromArgs)();
-    try {
-        console.log(`Build docker image ${imageFullName}`);
-        console.time('Total time');
-        yield (0, docker_build_1.prepareFilesForDocker)({
-            pathToTempDir,
-            dockerfileTemplate: dockerfile_compiled_template_1.dockerfileTemplate,
-            nginxConfTemplate: nginx_conf_template_1.nginxConfTemplate,
-            nginxBaseConfTemplate: base_nginx_conf_template_1.nginxBaseConfTemplate,
-            startScriptTemplate: start_template_1.startScript,
-            allowLocalDockerfile: false,
-            allowLocalStartScript: false,
-            addNodeModulesToDockerIgnore: true,
-        });
-        yield (0, exec_1.exec)((0, docker_build_1.getDockerBuildCommand)({ tempDirName, imageFullName }));
-        yield fs_extra_1.default.remove(pathToTempDir);
-        // guard against pushing the image during tests
-        if (!app_configs_1.configs.debug) {
-            yield (0, exec_1.exec)(`docker push ${imageFullName}`);
-        }
-        console.timeEnd('Total time');
-    }
-    catch (err) {
-        yield fs_extra_1.default.remove(pathToTempDir);
-        console.error('Error during docker-build.');
-        if (app_configs_1.configs.debug) {
-            console.error(err);
-        }
-        process.exit(1);
-    }
+    yield (0, run_artifacts_cli_1.runArtifactsCli)('docker-build:compiled');
 }))();

package/build/commands/util/artifacts-config.d.ts

@@ -0,0 +1,25 @@
+import { type ArtifactsConfigFile, type ResolvedArtifactsConfig } from '@alfalab/arui-scripts-artifacts';
+/**
+ * Собирает из плоского конфига arui-scripts полноценный конфиг @alfalab/arui-scripts-artifacts —
+ * ровно в той же форме, в какой его пишут руками в `arui-scripts-artifacts.ts` в корне проекта: на
+ * верхнем уровне общее для всех сборок, в `commands` — то, чем конкретная команда отличается.
+ *
+ * Это единственная точка связи между двумя пакетами: сами шаблоны и утилиты сборки живут в
+ * @alfalab/arui-scripts-artifacts и ничего не знают про `configs`.
+ *
+ * Здесь происходит только маппинг значений. Дефолты docker/nginx/archive-настроек не дублируются:
+ * если пользователь ничего не задал, сюда приезжает `undefined` и значение подставит
+ * `resolveArtifactsConfig`.
+ *
+ * @deprecated Сам маппинг — слой обратной совместимости. В следующей мажорной версии настройки
+ * сборки артефактов будут жить только в конфиге @alfalab/arui-scripts-artifacts.
+ */
+export declare function getArtifactsOptions(extraOptions?: ArtifactsConfigFile): ArtifactsConfigFile;
+/**
+ * Донасыщенный конфиг сборки, построенный из `configs`. Мемоизирован, потому что резолв читает
+ * package.json и версию yarn.
+ *
+ * Резолвится только верхний уровень: командные секции разбирает CLI, когда знает, какую команду
+ * запустили.
+ */
+export declare function getResolvedArtifactsConfig(): ResolvedArtifactsConfig;

package/build/commands/util/artifacts-config.js

@@ -0,0 +1,120 @@
+"use strict";
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getArtifactsOptions = getArtifactsOptions;
+exports.getResolvedArtifactsConfig = getResolvedArtifactsConfig;
+const arui_scripts_artifacts_1 = require("@alfalab/arui-scripts-artifacts");
+const app_configs_1 = require("../../configs/app-configs");
+const apply_overrides_1 = require("../../configs/util/apply-overrides");
+const artifacts_deprecations_1 = require("./artifacts-deprecations");
+/**
+ * Оверрайды шаблонов из `arui-scripts.overrides.ts`. Ключи в @alfalab/arui-scripts-artifacts переименованы,
+ * поэтому здесь мы явно транслируем их в исторические имена arui-scripts.
+ *
+ * @deprecated Слой обратной совместимости: в следующей мажорной версии оверрайды шаблонов останутся
+ * только в конфиге @alfalab/arui-scripts-artifacts (`overrides`).
+ *
+ * Обратите внимание: в arui-scripts `nginx` — это server-блок (`nginx.conf`), а `nginxConf` —
+ * базовый http-блок (`base-nginx.conf`). Имена исторически перепутаны, и эта таблица — единственное
+ * место, где это знание нужно.
+ */
+const legacyTemplateOverrides = {
+    dockerfile: (generated) => (0, apply_overrides_1.applyOverrides)('Dockerfile', generated),
+    dockerfileCompiled: (generated) => (0, apply_overrides_1.applyOverrides)('DockerfileCompiled', generated),
+    nginxConf: (generated) => (0, apply_overrides_1.applyOverrides)('nginx', generated),
+    baseNginxConf: (generated) => (0, apply_overrides_1.applyOverrides)('nginxConf', generated),
+    startScript: (generated) => (0, apply_overrides_1.applyOverrides)('start.sh', generated),
+};
+/**
+ * Собирает из плоского конфига arui-scripts полноценный конфиг @alfalab/arui-scripts-artifacts —
+ * ровно в той же форме, в какой его пишут руками в `arui-scripts-artifacts.ts` в корне проекта: на
+ * верхнем уровне общее для всех сборок, в `commands` — то, чем конкретная команда отличается.
+ *
+ * Это единственная точка связи между двумя пакетами: сами шаблоны и утилиты сборки живут в
+ * @alfalab/arui-scripts-artifacts и ничего не знают про `configs`.
+ *
+ * Здесь происходит только маппинг значений. Дефолты docker/nginx/archive-настроек не дублируются:
+ * если пользователь ничего не задал, сюда приезжает `undefined` и значение подставит
+ * `resolveArtifactsConfig`.
+ *
+ * @deprecated Сам маппинг — слой обратной совместимости. В следующей мажорной версии настройки
+ * сборки артефактов будут жить только в конфиге @alfalab/arui-scripts-artifacts.
+ */
+function getArtifactsOptions(extraOptions = {}) {
+    (0, artifacts_deprecations_1.warnAboutArtifactsDeprecations)();
+    const options = {
+        name: app_configs_1.configs.name,
+        version: app_configs_1.configs.version,
+        cwd: app_configs_1.configs.cwd,
+        debug: app_configs_1.configs.debug,
+        clientOnly: app_configs_1.configs.clientOnly,
+        buildPath: app_configs_1.configs.buildPath,
+        serverOutput: app_configs_1.configs.serverOutput,
+        serverPort: app_configs_1.configs.serverPort,
+        assetsPath: app_configs_1.configs.assetsPath,
+        publicPath: app_configs_1.configs.publicPath,
+        docker: {
+            registry: app_configs_1.configs.dockerRegistry,
+            baseImage: app_configs_1.configs.baseDockerImage,
+            runFromNonRootUser: app_configs_1.configs.runFromNonRootUser,
+            deleteNpm: app_configs_1.configs.deleteNpm,
+        },
+        nginx: {
+            port: app_configs_1.configs.clientServerPort,
+            rootPath: app_configs_1.configs.nginxRootPath,
+            enablePreviousVersionHeaders: app_configs_1.configs.dictionaryCompression.enablePreviousVersionHeaders,
+            baseConf: app_configs_1.configs.nginx,
+        },
+        archive: {
+            name: app_configs_1.configs.archiveName,
+            additionalPaths: app_configs_1.configs.additionalBuildPath,
+        },
+        build: {
+            removeDevDependencies: app_configs_1.configs.removeDevDependenciesDuringDockerBuild,
+        },
+        packageManager: {
+            useYarn: app_configs_1.configs.useYarn,
+        },
+        localFiles: {
+            dockerfile: app_configs_1.configs.localDockerfile,
+            startScript: app_configs_1.configs.localStartScript,
+            nginxConf: app_configs_1.configs.localNginxConf,
+            nginxBaseConf: app_configs_1.configs.localNginxBaseConf,
+        },
+        overrides: legacyTemplateOverrides,
+        commands: {
+            'archive-build': {
+                // archive-build исторически всегда удаляет dev-зависимости, независимо от
+                // removeDevDependenciesDuringDockerBuild
+                build: { removeDevDependencies: true },
+            },
+        },
+    };
+    // сливаем по тем же правилам, что и сам файл конфига: секции по полям, `commands` по имени
+    return (0, arui_scripts_artifacts_1.mergeConfigFiles)(options, extraOptions);
+}
+let cachedConfig = null;
+/**
+ * Донасыщенный конфиг сборки, построенный из `configs`. Мемоизирован, потому что резолв читает
+ * package.json и версию yarn.
+ *
+ * Резолвится только верхний уровень: командные секции разбирает CLI, когда знает, какую команду
+ * запустили.
+ */
+function getResolvedArtifactsConfig() {
+    if (!cachedConfig) {
+        const _a = getArtifactsOptions(), { commands } = _a, sharedOptions = __rest(_a, ["commands"]);
+        cachedConfig = (0, arui_scripts_artifacts_1.resolveArtifactsConfig)(sharedOptions);
+    }
+    return cachedConfig;
+}

package/build/commands/util/artifacts-deprecations.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Предупреждает о настройках и оверрайдах сборки артефактов, которые задает проект. Вызывается из
+ * команд сборки (docker-build, docker-build:compiled, archive-build), поэтому при обычной разработке
+ * в консоль ничего не сыпется.
+ *
+ * Дефолты этих настроек живут в @alfalab/arui-scripts-artifacts, а в конфиге arui-scripts они
+ * `undefined` — так что «настройка задана» здесь означает именно «проект ее переопределил».
+ */
+export declare function warnAboutArtifactsDeprecations(): void;

package/build/commands/util/artifacts-deprecations.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.warnAboutArtifactsDeprecations = warnAboutArtifactsDeprecations;
+const app_configs_1 = require("../../configs/app-configs");
+const apply_overrides_1 = require("../../configs/util/apply-overrides");
+/**
+ * Настройки сборки артефактов, которые остались в arui-scripts только ради обратной совместимости.
+ * В следующей мажорной версии они будут удалены — их место в конфиге `arui-scripts-artifacts.ts`.
+ *
+ * Значение — путь до той же настройки в @alfalab/arui-scripts-artifacts.
+ */
+const DEPRECATED_SETTINGS = {
+    dockerRegistry: 'docker.registry',
+    baseDockerImage: 'docker.baseImage',
+    runFromNonRootUser: 'docker.runFromNonRootUser',
+    deleteNpm: 'docker.deleteNpm',
+    nginxRootPath: 'nginx.rootPath',
+    nginx: 'nginx.baseConf',
+    archiveName: 'archive.name',
+    additionalBuildPath: 'archive.additionalPaths',
+    removeDevDependenciesDuringDockerBuild: 'build.removeDevDependencies',
+};
+/**
+ * Ключи оверрайдов шаблонов из `arui-scripts.overrides.ts` и их замена в конфиге артефактов.
+ *
+ * Напоминание: в arui-scripts `nginx` — это server-блок, а `nginxConf` — базовый http-блок; в
+ * @alfalab/arui-scripts-artifacts они названы по смыслу, поэтому имена не совпадают.
+ */
+const DEPRECATED_OVERRIDES = {
+    Dockerfile: 'overrides.dockerfile',
+    DockerfileCompiled: 'overrides.dockerfileCompiled',
+    nginx: 'overrides.nginxConf',
+    nginxConf: 'overrides.baseNginxConf',
+    'start.sh': 'overrides.startScript',
+};
+let warned = false;
+/**
+ * Предупреждает о настройках и оверрайдах сборки артефактов, которые задает проект. Вызывается из
+ * команд сборки (docker-build, docker-build:compiled, archive-build), поэтому при обычной разработке
+ * в консоль ничего не сыпется.
+ *
+ * Дефолты этих настроек живут в @alfalab/arui-scripts-artifacts, а в конфиге arui-scripts они
+ * `undefined` — так что «настройка задана» здесь означает именно «проект ее переопределил».
+ */
+function warnAboutArtifactsDeprecations() {
+    if (warned) {
+        return;
+    }
+    warned = true;
+    const usedSettings = Object.keys(DEPRECATED_SETTINGS)
+        .filter((setting) => app_configs_1.configs[setting] !== undefined)
+        .map((setting) => `  ${setting} → ${DEPRECATED_SETTINGS[setting]}`);
+    const usedOverrides = Object.keys(DEPRECATED_OVERRIDES)
+        .filter((key) => (0, apply_overrides_1.hasOverride)(key))
+        .map((key) => `  оверрайд ${key} → ${DEPRECATED_OVERRIDES[key]}`);
+    if (!usedSettings.length && !usedOverrides.length) {
+        return;
+    }
+    console.warn([
+        'Настройки сборки артефактов в arui-scripts объявлены устаревшими и будут удалены в следующей мажорной версии.',
+        'Перенесите их в конфиг @alfalab/arui-scripts-artifacts (arui-scripts-artifacts.ts в корне проекта):',
+        ...usedSettings,
+        ...usedOverrides,
+        'Подробнее: https://github.com/core-ds/arui-scripts/blob/master/packages/arui-scripts-artifacts/docs/migration.md',
+    ].join('\n'));
+}

package/build/commands/util/arui-scripts-artifacts.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `arui-scripts-artifacts.ts`, который arui-scripts возит с собой. Назван так же, как конфиг в
+ * корне проекта, потому что это он и есть — просто дефолтный, собранный из настроек arui-scripts.
+ *
+ * Команды `docker-build`, `docker-build:compiled` и `archive-build` не зовут либу напрямую, а
+ * запускают ее CLI с этим файлом в `-c` — тот же прием, что и `rsbuild build -c ...`. Поэтому
+ * заводить свой конфиг в корне проекта не обязательно: без него настройки берутся отсюда.
+ *
+ * Если такой файл в проекте есть, он подхватывается по стандартным правилам либы и кладется
+ * поверх — именно туда deprecated-настройки arui-scripts и просят перенести.
+ *
+ * Экспортируется функция, а не объект: `configs` читает package.json и файлы проекта, и делать это
+ * нужно в момент запуска команды, а не при загрузке модуля.
+ */
+declare const _default: import("@alfalab/arui-scripts-artifacts").ArtifactsConfigFileExport;
+export default _default;

package/build/commands/util/arui-scripts-artifacts.js

@@ -0,0 +1,29 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const arui_scripts_artifacts_1 = require("@alfalab/arui-scripts-artifacts");
+const app_configs_1 = require("../../configs/app-configs");
+const artifacts_config_1 = require("./artifacts-config");
+/**
+ * `arui-scripts-artifacts.ts`, который arui-scripts возит с собой. Назван так же, как конфиг в
+ * корне проекта, потому что это он и есть — просто дефолтный, собранный из настроек arui-scripts.
+ *
+ * Команды `docker-build`, `docker-build:compiled` и `archive-build` не зовут либу напрямую, а
+ * запускают ее CLI с этим файлом в `-c` — тот же прием, что и `rsbuild build -c ...`. Поэтому
+ * заводить свой конфиг в корне проекта не обязательно: без него настройки берутся отсюда.
+ *
+ * Если такой файл в проекте есть, он подхватывается по стандартным правилам либы и кладется
+ * поверх — именно туда deprecated-настройки arui-scripts и просят перенести.
+ *
+ * Экспортируется функция, а не объект: `configs` читает package.json и файлы проекта, и делать это
+ * нужно в момент запуска команды, а не при загрузке модуля.
+ */
+exports.default = (0, arui_scripts_artifacts_1.defineConfig)(() => __awaiter(void 0, void 0, void 0, function* () { return (0, arui_scripts_artifacts_1.mergeConfigFiles)((0, artifacts_config_1.getArtifactsOptions)(), yield (0, arui_scripts_artifacts_1.resolveConfigFile)(app_configs_1.configs.cwd)); }));