arui-scripts 23.8.1 → 23.9.0

package/build/commands/util/docker-build.d.ts

@@ -1,8 +1,13 @@
-export declare function getBuildParamsFromArgs(): {
-    pathToTempDir: string;
-    imageFullName: string;
-    tempDirName: string;
-};
+import { type BuildParams, dockerVersionSatisfies, getBuildParams } from '@alfalab/arui-scripts-artifacts';
+export { dockerVersionSatisfies };
+/**
+ * Совместимый слой поверх @alfalab/arui-scripts-artifacts: сохраняет исторические сигнатуры, которыми
+ * пользуются сторонние сборки и реэкспорт из `arui-scripts`.
+ *
+ * @deprecated Используйте одноименные функции из `@alfalab/arui-scripts-artifacts` — они принимают явный
+ * конфиг и не зависят от глобального `configs`. В следующей мажорной версии реэкспорт будет удален.
+ */
+export declare function getBuildParamsFromArgs(): BuildParams;
 type PrepareFilesForDockerParams = {
     dockerfileTemplate: string;
     nginxConfTemplate: string;
@@ -13,11 +18,18 @@ type PrepareFilesForDockerParams = {
     allowLocalStartScript: boolean;
     addNodeModulesToDockerIgnore: boolean;
 };
-export declare function prepareFilesForDocker({ dockerfileTemplate, nginxConfTemplate, nginxBaseConfTemplate, startScriptTemplate, pathToTempDir, allowLocalDockerfile, allowLocalStartScript, addNodeModulesToDockerIgnore, }: PrepareFilesForDockerParams): Promise<void>;
-export declare function dockerVersionSatisfies(request: string): boolean;
+/**
+ * @deprecated Используйте `prepareFilesForDocker` из `@alfalab/arui-scripts-artifacts`. В следующей
+ * мажорной версии реэкспорт будет удален.
+ */
+export declare function prepareFilesForDocker({ dockerfileTemplate, nginxConfTemplate, nginxBaseConfTemplate, startScriptTemplate, pathToTempDir, allowLocalDockerfile, allowLocalStartScript, addNodeModulesToDockerIgnore, }: PrepareFilesForDockerParams): Promise<import("@alfalab/arui-scripts-artifacts").PrepareFilesForDockerResult>;
 type DockerBuildCommandParams = {
     tempDirName: string;
     imageFullName: string;
 };
+/**
+ * @deprecated Используйте `getDockerBuildCommand` из `@alfalab/arui-scripts-artifacts`. В следующей
+ * мажорной версии реэкспорт будет удален.
+ */
 export declare function getDockerBuildCommand({ tempDirName, imageFullName }: DockerBuildCommandParams): string;
-export {};
+export { getBuildParams };

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

@@ -12,116 +12,65 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.getBuildParams = exports.dockerVersionSatisfies = void 0;
 exports.getBuildParamsFromArgs = getBuildParamsFromArgs;
 exports.prepareFilesForDocker = prepareFilesForDocker;
-exports.dockerVersionSatisfies = dockerVersionSatisfies;
 exports.getDockerBuildCommand = getDockerBuildCommand;
 const path_1 = __importDefault(require("path"));
-const fs_extra_1 = __importDefault(require("fs-extra"));
-const satisfies_1 = __importDefault(require("semver/functions/satisfies"));
-const shelljs_1 = __importDefault(require("shelljs"));
-const app_configs_1 = require("../../configs/app-configs");
-const get_defaults_1 = require("../../configs/app-configs/get-defaults");
+const arui_scripts_artifacts_1 = require("@alfalab/arui-scripts-artifacts");
+Object.defineProperty(exports, "dockerVersionSatisfies", { enumerable: true, get: function () { return arui_scripts_artifacts_1.dockerVersionSatisfies; } });
+Object.defineProperty(exports, "getBuildParams", { enumerable: true, get: function () { return arui_scripts_artifacts_1.getBuildParams; } });
+const artifacts_config_1 = require("./artifacts-config");
+/**
+ * Совместимый слой поверх @alfalab/arui-scripts-artifacts: сохраняет исторические сигнатуры, которыми
+ * пользуются сторонние сборки и реэкспорт из `arui-scripts`.
+ *
+ * @deprecated Используйте одноименные функции из `@alfalab/arui-scripts-artifacts` — они принимают явный
+ * конфиг и не зависят от глобального `configs`. В следующей мажорной версии реэкспорт будет удален.
+ */
 function getBuildParamsFromArgs() {
-    let imageVersion = app_configs_1.configs.version;
-    let imageName = app_configs_1.configs.name;
-    let { dockerRegistry } = app_configs_1.configs;
-    const commandLineArguments = process.argv.slice(3);
-    commandLineArguments.forEach((arg) => {
-        let [argName, argValue] = arg.split('=');
-        argName = argName.toLowerCase().trim();
-        argValue = argValue ? argValue.trim() : '';
-        switch (argName) {
-            case 'version':
-                imageVersion = argValue;
-                break;
-            case 'name':
-                imageName = argValue;
-                break;
-            case 'registry':
-                dockerRegistry = argValue;
-                break;
-            default:
-                console.warn(`Unknown argument ${argName}`);
-        }
-    });
-    const tempDirName = '.docker-build';
-    const pathToTempDir = path_1.default.join(app_configs_1.configs.cwd, tempDirName);
-    const imageFullName = `${dockerRegistry ? `${dockerRegistry}/` : ''}${imageName}:${imageVersion}`;
-    return {
-        pathToTempDir,
-        imageFullName,
-        tempDirName,
-    };
+    return (0, arui_scripts_artifacts_1.getBuildParamsFromArgs)((0, artifacts_config_1.getResolvedArtifactsConfig)(), process.argv.slice(3));
+}
+/**
+ * Разбирает `registry/name:version` обратно на имя и версию, чтобы собрать конфиг, из которого
+ * @alfalab/arui-scripts-artifacts соберет ровно ту же строку.
+ */
+function splitImageFullName(imageFullName) {
+    const lastColon = imageFullName.lastIndexOf(':');
+    const lastSlash = imageFullName.lastIndexOf('/');
+    if (lastColon > lastSlash) {
+        return {
+            name: imageFullName.slice(0, lastColon),
+            version: imageFullName.slice(lastColon + 1),
+        };
+    }
+    return { name: imageFullName, version: '' };
 }
+/**
+ * @deprecated Используйте `prepareFilesForDocker` из `@alfalab/arui-scripts-artifacts`. В следующей
+ * мажорной версии реэкспорт будет удален.
+ */
 function prepareFilesForDocker(_a) {
     return __awaiter(this, arguments, void 0, function* ({ dockerfileTemplate, nginxConfTemplate, nginxBaseConfTemplate, startScriptTemplate, pathToTempDir, allowLocalDockerfile, allowLocalStartScript, addNodeModulesToDockerIgnore, }) {
-        yield fs_extra_1.default.emptyDir(pathToTempDir);
-        let nginxBaseConf = '';
-        if (app_configs_1.configs.nginx) {
-            nginxBaseConf = app_configs_1.configs.localNginxBaseConf
-                ? yield fs_extra_1.default.readFile(app_configs_1.configs.localNginxBaseConf, 'utf8')
-                : nginxBaseConfTemplate;
-        }
-        const nginxConf = app_configs_1.configs.localNginxConf
-            ? yield fs_extra_1.default.readFile(app_configs_1.configs.localNginxConf, 'utf8')
-            : nginxConfTemplate;
-        const dockerfile = app_configs_1.configs.localDockerfile && allowLocalDockerfile
-            ? yield fs_extra_1.default.readFile(app_configs_1.configs.localDockerfile, 'utf8')
-            : dockerfileTemplate;
-        const startScript = app_configs_1.configs.localStartScript && allowLocalStartScript
-            ? yield fs_extra_1.default.readFile(app_configs_1.configs.localStartScript, 'utf8')
-            : startScriptTemplate;
-        const dockerIgnoreFilePath = path_1.default.join(process.cwd(), '.dockerignore');
-        const dockerIgnoreFileContent = addNodeModulesToDockerIgnore &&
-            (yield getAndModifyDockerIgnoreContent(dockerIgnoreFilePath));
-        yield Promise.all([
-            fs_extra_1.default.writeFile(path_1.default.join(pathToTempDir, 'Dockerfile'), dockerfile, 'utf8'),
-            fs_extra_1.default.writeFile(path_1.default.join(pathToTempDir, get_defaults_1.nginxConfigFileName), nginxConf, 'utf8'),
-            nginxBaseConf &&
-                fs_extra_1.default.writeFile(path_1.default.join(pathToTempDir, get_defaults_1.baseNginxConfigFileName), nginxBaseConf, 'utf8'),
-            fs_extra_1.default.writeFile(path_1.default.join(pathToTempDir, 'start.sh'), startScript, {
-                encoding: 'utf8',
-                mode: 0o555,
-            }),
-            addNodeModulesToDockerIgnore &&
-                dockerIgnoreFileContent &&
-                fs_extra_1.default.writeFile(dockerIgnoreFilePath, dockerIgnoreFileContent, 'utf-8'),
-        ].filter(Boolean));
+        const config = (0, artifacts_config_1.getResolvedArtifactsConfig)();
+        return (0, arui_scripts_artifacts_1.prepareFilesForDocker)({
+            config: Object.assign(Object.assign({}, config), { cwd: path_1.default.dirname(pathToTempDir), docker: Object.assign(Object.assign({}, config.docker), { tempDirName: path_1.default.basename(pathToTempDir), addNodeModulesToDockerIgnore }), localFiles: Object.assign(Object.assign({}, config.localFiles), { allowDockerfile: allowLocalDockerfile, allowStartScript: allowLocalStartScript }) }),
+            templates: {
+                dockerfile: dockerfileTemplate,
+                nginxConf: nginxConfTemplate,
+                nginxBaseConf: nginxBaseConfTemplate,
+                startScript: startScriptTemplate,
+            },
+        });
     });
 }
-function dockerVersionSatisfies(request) {
-    const dockerServerVersion = shelljs_1.default.exec("docker version --format '{{.Server.Version}}'", {
-        silent: true,
-    });
-    const dockerClientVersion = shelljs_1.default.exec("docker version --format '{{.Client.Version}}'", {
-        silent: true,
-    });
-    return ((0, satisfies_1.default)(dockerServerVersion.toString(), request) &&
-        (0, satisfies_1.default)(dockerClientVersion.toString(), request));
-}
+/**
+ * @deprecated Используйте `getDockerBuildCommand` из `@alfalab/arui-scripts-artifacts`. В следующей
+ * мажорной версии реэкспорт будет удален.
+ */
 function getDockerBuildCommand({ tempDirName, imageFullName }) {
-    // если пытаться собрать проект на маках с m1, докер будет пытаться вытянуть базовый образ под свою платформу и
-    // упадет с ошибкой. Чтобы этого избежать - достаточно использовать флаг --platform. Но он поддерживается без экспериментальных
-    // флагов только начиная с docker 20.10.21, а на многих серверах, используемых для сборки до сих пор живет докер 1.13.1
-    // Соответственно они будут падать при наличии этого флага.
-    // https://docs.docker.com/engine/release-notes/20.10/
-    const canUsePlatformFlag = dockerVersionSatisfies('>=20.10.21');
-    return `docker build ${canUsePlatformFlag ? '--platform linux/x86_64' : ''} \
-    -f "./${tempDirName}/Dockerfile" \
-    --build-arg START_SH_LOCATION="./${tempDirName}/start.sh" \
-    --build-arg NGINX_CONF_LOCATION="./${tempDirName}/${get_defaults_1.nginxConfigFileName}" \
-    --build-arg NGINX_BASE_CONF_LOCATION="./${tempDirName}/${get_defaults_1.baseNginxConfigFileName}" \
-    -t ${imageFullName} .`;
-}
-function getAndModifyDockerIgnoreContent(dockerIgnoreFilePath) {
-    return __awaiter(this, void 0, void 0, function* () {
-        if (fs_extra_1.default.existsSync(dockerIgnoreFilePath)) {
-            return fs_extra_1.default
-                .readFile(dockerIgnoreFilePath, 'utf-8')
-                .then((ignores) => `${ignores}\nnode_modules`);
-        }
-        yield fs_extra_1.default.createFile(dockerIgnoreFilePath);
-        return 'node_modules';
-    });
+    const config = (0, artifacts_config_1.getResolvedArtifactsConfig)();
+    return (0, arui_scripts_artifacts_1.getDockerBuildCommand)(Object.assign(Object.assign(Object.assign({}, config), splitImageFullName(imageFullName)), { 
+        // имя образа уже содержит registry, второй раз подставлять его не нужно
+        docker: Object.assign(Object.assign({}, config.docker), { registry: '', tempDirName }) }));
 }

package/build/commands/util/exec.d.ts

@@ -1 +1 @@
-export declare function exec(command: string): Promise<unknown>;
+export { exec, ExecError } from '@alfalab/arui-scripts-artifacts';

package/build/commands/util/exec.js

@@ -1,18 +1,6 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.exec = exec;
-const shelljs_1 = __importDefault(require("shelljs"));
-function exec(command) {
-    return new Promise((resolve, reject) => {
-        console.log(`Executing command: ${command}`);
-        shelljs_1.default.exec(command, (code) => {
-            if (code === 0) {
-                return resolve(code);
-            }
-            return reject(code);
-        });
-    });
-}
+exports.ExecError = exports.exec = void 0;
+var arui_scripts_artifacts_1 = require("@alfalab/arui-scripts-artifacts");
+Object.defineProperty(exports, "exec", { enumerable: true, get: function () { return arui_scripts_artifacts_1.exec; } });
+Object.defineProperty(exports, "ExecError", { enumerable: true, get: function () { return arui_scripts_artifacts_1.ExecError; } });

package/build/commands/util/run-artifacts-cli.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Запускает команду CLI @alfalab/arui-scripts-artifacts с конфигом arui-scripts.
+ *
+ * Позиционные аргументы (`name=...`, `version=...`, `registry=...`) прокидываются как есть — их
+ * разбирает сам CLI.
+ */
+export declare function runArtifactsCli(command: string): Promise<void>;

package/build/commands/util/run-artifacts-cli.js

@@ -0,0 +1,60 @@
+"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());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runArtifactsCli = runArtifactsCli;
+const path_1 = __importDefault(require("path"));
+const arui_scripts_artifacts_1 = require("@alfalab/arui-scripts-artifacts");
+/**
+ * Конфиг едет вместе с arui-scripts — см. `arui-scripts-artifacts.ts`. `require.resolve` дает абсолютный
+ * путь до собранного файла и не выполняет его: конфиг исполнит уже CLI, в процессе сборки.
+ */
+const ARTIFACTS_CONFIG_PATH = require.resolve('./arui-scripts-artifacts');
+/**
+ * Абсолютный путь до бинарника CLI @alfalab/arui-scripts-artifacts.
+ *
+ * Резолвим через package.json пакета, а не полагаемся на `node_modules/.bin` в PATH: команды
+ * arui-scripts запускают не только из yarn-скриптов.
+ */
+function getArtifactsCliPath() {
+    const packageJsonPath = require.resolve('@alfalab/arui-scripts-artifacts/package.json');
+    // eslint-disable-next-line global-require, import/no-dynamic-require, @typescript-eslint/no-var-requires
+    const { bin } = require(packageJsonPath);
+    return path_1.default.join(path_1.default.dirname(packageJsonPath), typeof bin === 'string' ? bin : bin['arui-scripts-artifacts']);
+}
+/**
+ * Запускает команду CLI @alfalab/arui-scripts-artifacts с конфигом arui-scripts.
+ *
+ * Позиционные аргументы (`name=...`, `version=...`, `registry=...`) прокидываются как есть — их
+ * разбирает сам CLI.
+ */
+function runArtifactsCli(command) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const args = process.argv.slice(3);
+        const cliCommand = [
+            (0, arui_scripts_artifacts_1.shellQuote)(process.execPath),
+            (0, arui_scripts_artifacts_1.shellQuote)(getArtifactsCliPath()),
+            command,
+            '-c',
+            (0, arui_scripts_artifacts_1.shellQuote)(ARTIFACTS_CONFIG_PATH),
+            ...args,
+        ].join(' ');
+        try {
+            yield (0, arui_scripts_artifacts_1.exec)(cliCommand);
+        }
+        catch (_a) {
+            // CLI уже напечатал ошибку (и стек, если включен debug)
+            process.exit(1);
+        }
+    });
+}

package/build/commands/util/yarn.d.ts

@@ -1,4 +1,10 @@
-type YarnVersion = '1' | '2+' | 'unavailable';
+import { type YarnVersion } from '@alfalab/arui-scripts-artifacts';
+/**
+ * Совместимый слой поверх @alfalab/arui-scripts-artifacts: сохраняет исторические сигнатуры без аргументов,
+ * подставляя значения из глобального `configs`.
+ *
+ * @deprecated Используйте одноименные функции из `@alfalab/arui-scripts-artifacts`.
+ */
 export declare function getYarnVersion(): YarnVersion;
 export declare function getPruningCommand(): string;
 export declare function getInstallProductionCommand(): string;
@@ -14,4 +20,3 @@ export declare function getYarnPathFromRc(): string | null;
  * Возвращает пустую строку, если symlink не нужен.
  */
 export declare function getYarnBinSymlinkCommand(): string;
-export {};

package/build/commands/util/yarn.js

@@ -1,82 +1,36 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getYarnVersion = getYarnVersion;
 exports.getPruningCommand = getPruningCommand;
 exports.getInstallProductionCommand = getInstallProductionCommand;
 exports.getYarnPathFromRc = getYarnPathFromRc;
 exports.getYarnBinSymlinkCommand = getYarnBinSymlinkCommand;
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-const shelljs_1 = __importDefault(require("shelljs"));
+const arui_scripts_artifacts_1 = require("@alfalab/arui-scripts-artifacts");
 const app_configs_1 = require("../../configs/app-configs");
+/**
+ * Совместимый слой поверх @alfalab/arui-scripts-artifacts: сохраняет исторические сигнатуры без аргументов,
+ * подставляя значения из глобального `configs`.
+ *
+ * @deprecated Используйте одноименные функции из `@alfalab/arui-scripts-artifacts`.
+ */
 function getYarnVersion() {
-    if (app_configs_1.configs.useYarn && shelljs_1.default.which('yarn')) {
-        const yarnVersion = shelljs_1.default.exec('yarn -v', { silent: true });
-        const yarnMajorVersion = Number(yarnVersion.split('.')[0]);
-        return yarnMajorVersion > 1 ? '2+' : '1';
-    }
-    return 'unavailable';
+    return (0, arui_scripts_artifacts_1.getYarnVersion)({ useYarn: app_configs_1.configs.useYarn });
 }
 function getPruningCommand() {
-    if (app_configs_1.configs.clientOnly) {
-        return 'echo "Skipping pruning in client only mode"';
-    }
-    const yarnVersion = getYarnVersion();
-    switch (yarnVersion) {
-        case '1': {
-            return 'yarn install --production --ignore-optional --frozen-lockfile --ignore-scripts --prefer-offline';
-        }
-        case '2+': {
-            return 'yarn workspaces focus --production --all';
-        }
-        case 'unavailable': {
-            return 'npm prune --production';
-        }
-        default: {
-            return '';
-        }
-    }
+    return (0, arui_scripts_artifacts_1.getPruningCommand)({
+        yarnVersion: getYarnVersion(),
+        clientOnly: app_configs_1.configs.clientOnly,
+    });
 }
 function getInstallProductionCommand() {
-    const yarnVersion = getYarnVersion();
-    switch (yarnVersion) {
-        case '1': {
-            return 'yarn install --production --ignore-optional --frozen-lockfile --ignore-scripts --prefer-offline';
-        }
-        case '2+': {
-            return 'yarn workspaces focus --production --all';
-        }
-        case 'unavailable': {
-            return 'npm install --production';
-        }
-        default: {
-            return '';
-        }
-    }
+    return (0, arui_scripts_artifacts_1.getInstallProductionCommand)(getYarnVersion());
 }
 /**
  * Читает значение yarnPath из .yarnrc.yml.
  * Возвращает путь к бинарнику yarn (например .yarn/releases/yarn-4.18.0.cjs) или null.
  */
 function getYarnPathFromRc() {
-    const rcPath = path_1.default.join(app_configs_1.configs.cwd, '.yarnrc.yml');
-    if (!shelljs_1.default.test('-f', rcPath)) {
-        return null;
-    }
-    let content;
-    try {
-        content = fs_1.default.readFileSync(rcPath, 'utf8');
-    }
-    catch (_a) {
-        return null;
-    }
-    // Ищем строку вида: yarnPath: .yarn/releases/yarn-4.18.0.cjs
-    // Значение может быть в кавычках или без
-    const match = content.match(/^\s*yarnPath:\s*['"]?([^'"\s]+)['"]?\s*$/m);
-    return match ? match[1] : null;
+    return (0, arui_scripts_artifacts_1.getYarnPathFromRc)(app_configs_1.configs.cwd);
 }
 /**
  * Возвращает команду для создания symlink на yarn бинарник в Docker-образе.
@@ -85,13 +39,5 @@ function getYarnPathFromRc() {
  * Возвращает пустую строку, если symlink не нужен.
  */
 function getYarnBinSymlinkCommand() {
-    if (getYarnVersion() !== '2+') {
-        return '';
-    }
-    const yarnPath = getYarnPathFromRc();
-    if (!yarnPath) {
-        return '';
-    }
-    // WORKDIR в Dockerfile = /src
-    return `ln -sf /src/${yarnPath} /usr/local/bin/yarn && \\\n    `;
+    return (0, arui_scripts_artifacts_1.getYarnBinSymlinkCommand)({ yarnVersion: getYarnVersion(), cwd: app_configs_1.configs.cwd });
 }

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

@@ -32,22 +32,24 @@ function getDefaultAppConfig() {
         // paths
         buildPath: '.build',
         assetsPath: 'assets',
-        additionalBuildPath: ['config'],
         statsOutputFilename: 'stats.json',
         serverEntry: path_1.default.resolve(absoluteSrcPath, 'server/index'),
         serverOutput: 'server.js',
         clientPolyfillsEntry: null,
         clientEntry: path_1.default.resolve(absoluteSrcPath, 'index'),
-        // docker compilation configs
-        dockerRegistry: '',
-        baseDockerImage: 'alfabankui/arui-scripts:24.10.0-slim',
-        nginxRootPath: '/src',
-        nginx: null,
-        runFromNonRootUser: true,
-        removeDevDependenciesDuringDockerBuild: true,
-        deleteNpm: false,
-        // archive compilation configs
-        archiveName: 'build.tar',
+        // docker/archive compilation configs
+        // Дефолты этих настроек живут в @alfalab/arui-scripts-artifacts (resolveArtifactsConfig).
+        // Здесь ключи объявлены без значений, чтобы настройка из package.json/конфига не считалась
+        // неизвестной, а `undefined` доехал до scripts-artifacts и был заполнен там.
+        dockerRegistry: undefined,
+        baseDockerImage: undefined,
+        nginxRootPath: undefined,
+        nginx: undefined,
+        runFromNonRootUser: undefined,
+        removeDevDependenciesDuringDockerBuild: undefined,
+        deleteNpm: undefined,
+        archiveName: undefined,
+        additionalBuildPath: undefined,
         dictionaryCompression: {
             dictionaryPath: [],
             enablePreviousVersionHeaders: false,

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

@@ -2,6 +2,7 @@ import { type DevTool, type Shared } from '@rspack/core';
 import { type Configuration as DevServerConfiguration } from '@rspack/dev-server';
 import { type PluginOptions as ReactCompilerOptions } from 'babel-plugin-react-compiler';
 import type webpackNodeExternals from 'webpack-node-externals';
+import { type NginxBaseConfOptions } from '@alfalab/arui-scripts-artifacts';
 /**
  * Конфигурация arui-scripts, которая может быть переопределена приложением
  */
@@ -17,26 +18,32 @@ export type AppConfigs = {
     clientOnly: boolean;
     buildPath: string;
     assetsPath: string;
-    additionalBuildPath: string[];
     statsOutputFilename: string;
     serverEntry: string | string[] | Record<string, string | string[]>;
     serverOutput: string;
     clientPolyfillsEntry: null | string | string[];
     clientEntry: string | string[] | Record<string, string | string[]>;
-    dockerRegistry: string;
-    baseDockerImage: string;
-    nginxRootPath: string;
-    nginx: {
-        workerProcesses?: number;
-        workerRlimitNoFile?: number;
-        workerConnections?: number;
-        eventsUse?: string;
-        daemon?: string;
-    } | null;
-    runFromNonRootUser: boolean;
-    removeDevDependenciesDuringDockerBuild: boolean;
-    deleteNpm: boolean;
-    archiveName: string;
+    /** @deprecated Используйте `docker.registry` в конфиге @alfalab/arui-scripts-artifacts. */
+    dockerRegistry?: string;
+    /** @deprecated Используйте `docker.baseImage` в конфиге @alfalab/arui-scripts-artifacts. */
+    baseDockerImage?: string;
+    /** @deprecated Используйте `nginx.rootPath` в конфиге @alfalab/arui-scripts-artifacts. */
+    nginxRootPath?: string;
+    /** @deprecated Используйте `nginx.baseConf` в конфиге @alfalab/arui-scripts-artifacts. */
+    nginx?: NginxBaseConfOptions | null;
+    /** @deprecated Используйте `docker.runFromNonRootUser` в конфиге @alfalab/arui-scripts-artifacts. */
+    runFromNonRootUser?: boolean;
+    /** @deprecated Используйте `build.removeDevDependencies` в конфиге @alfalab/arui-scripts-artifacts. */
+    removeDevDependenciesDuringDockerBuild?: boolean;
+    /** @deprecated Используйте `docker.deleteNpm` в конфиге @alfalab/arui-scripts-artifacts. */
+    deleteNpm?: boolean;
+    /** @deprecated Используйте `archive.name` в конфиге @alfalab/arui-scripts-artifacts. */
+    archiveName?: string;
+    /**
+     * Директории проекта, которые кладутся в tar-архив рядом со сборкой.
+     * @deprecated Используйте `archive.additionalPaths` в конфиге @alfalab/arui-scripts-artifacts.
+     */
+    additionalBuildPath?: string[];
     dictionaryCompression: {
         dictionaryPath: string[];
         enablePreviousVersionHeaders?: boolean;

package/build/configs/app-configs/validate-settings-keys.d.ts

@@ -1,4 +1,7 @@
 /**
- * Функция проверяет что все ключи объекта settingsObject есть в уже существующей конфигурации
+ * Функция проверяет что все ключи объекта settingsObject есть в уже существующей конфигурации.
+ *
+ * Проверяется именно наличие ключа, а не значения: у части настроек (например, docker-специфичных)
+ * дефолт живет в @alfalab/arui-scripts-artifacts, поэтому в конфиге они лежат со значением `undefined`.
  */
 export declare function validateSettingsKeys(existingConfig: Record<string, unknown>, settingsObject: Record<string, unknown>, source?: string): void;

package/build/configs/app-configs/validate-settings-keys.js

@@ -2,11 +2,14 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.validateSettingsKeys = validateSettingsKeys;
 /**
- * Функция проверяет что все ключи объекта settingsObject есть в уже существующей конфигурации
+ * Функция проверяет что все ключи объекта settingsObject есть в уже существующей конфигурации.
+ *
+ * Проверяется именно наличие ключа, а не значения: у части настроек (например, docker-специфичных)
+ * дефолт живет в @alfalab/arui-scripts-artifacts, поэтому в конфиге они лежат со значением `undefined`.
  */
 function validateSettingsKeys(existingConfig, settingsObject, source) {
     Object.keys(settingsObject).forEach((setting) => {
-        if (typeof existingConfig[setting] === 'undefined') {
+        if (!Object.prototype.hasOwnProperty.call(existingConfig, setting)) {
             console.warn(`Неизвестная настройка "${setting}" в ${source || 'конфигурации'}`);
         }
     });

package/build/configs/util/apply-overrides.d.ts

@@ -29,10 +29,15 @@ type Overrides = {
     browsers: string[];
     supportingBrowsers: string[];
     supportingNode: string[];
+    /** @deprecated Используйте `overrides.dockerfile` в конфиге @alfalab/arui-scripts-artifacts. */
     Dockerfile: string;
+    /** @deprecated Используйте `overrides.dockerfileCompiled` в конфиге @alfalab/arui-scripts-artifacts. */
     DockerfileCompiled: string;
+    /** @deprecated Используйте `overrides.nginxConf` в конфиге @alfalab/arui-scripts-artifacts. */
     nginx: string;
+    /** @deprecated Используйте `overrides.baseNginxConf` в конфиге @alfalab/arui-scripts-artifacts. */
     nginxConf: string;
+    /** @deprecated Используйте `overrides.startScript` в конфиге @alfalab/arui-scripts-artifacts. */
     'start.sh': string;
     serverExternalsExemptions: Array<string | RegExp>;
     html: string;
@@ -96,6 +101,11 @@ type OverrideFunction<K extends keyof Overrides> = (config: Overrides[K], appCon
 export type OverrideFile = {
     [K in keyof Overrides]?: OverrideFunction<K>;
 } & Partial<Record<DeprecatedOverrideKey, OverrideFunction<'rspack'>>>;
+/**
+ * Объявлен ли оверрайд с таким ключом хоть в одном файле оверрайдов. Нужно, чтобы предупреждать об
+ * устаревших ключах только тем, кто ими действительно пользуется.
+ */
+export declare function hasOverride(overridesKey: keyof Overrides): boolean;
 /**
  *
  * @param {String|String[]} overridesKey Ключи оверрайда

package/build/configs/util/apply-overrides.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasOverride = hasOverride;
 exports.applyOverrides = applyOverrides;
 const app_configs_1 = require("../app-configs");
 // Маппинг устаревших webpack-ключей оверрайдов на актуальные ключи для rspack
@@ -54,6 +55,13 @@ overrides = app_configs_1.configs.overridesPath.map((path) => {
         return {};
     }
 });
+/**
+ * Объявлен ли оверрайд с таким ключом хоть в одном файле оверрайдов. Нужно, чтобы предупреждать об
+ * устаревших ключах только тем, кто ими действительно пользуется.
+ */
+function hasOverride(overridesKey) {
+    return overrides.some((override) => Object.prototype.hasOwnProperty.call(override, overridesKey));
+}
 /**
  *
  * @param {String|String[]} overridesKey Ключи оверрайда

package/build/index.d.ts

@@ -1,6 +1,19 @@
 export type { OverrideFile } from './configs/util/apply-overrides';
 export type { AppConfigs, CompatModuleConfig, PackageSettings } from './configs/app-configs/types';
+/**
+ * Утилиты сборки docker-образа, привязанные к глобальному конфигу arui-scripts.
+ * @deprecated Используйте `@alfalab/arui-scripts-artifacts` — там те же функции принимают явный конфиг.
+ * В следующей мажорной версии эти реэкспорты будут удалены.
+ */
 export { prepareFilesForDocker } from './commands/util/docker-build';
 export { getBuildParamsFromArgs } from './commands/util/docker-build';
 export { getDockerBuildCommand } from './commands/util/docker-build';
+/**
+ * Опции сборки docker-образа, собранные из конфига arui-scripts. Точка входа для тех, кто хочет
+ * собрать образ через `@alfalab/arui-scripts-artifacts`, но переиспользовать настройки arui-scripts.
+ * @deprecated Слой обратной совместимости: в следующей мажорной версии настройки сборки артефактов
+ * будут жить только в конфиге `arui-scripts-artifacts.ts`.
+ */
+export { getArtifactsOptions, getResolvedArtifactsConfig } from './commands/util/artifacts-config';
+export { buildDockerImage, getBuildParams, renderBaseNginxConf, renderDockerfile, renderDockerfileCompiled, renderTemplates, renderNginxConf, renderStartScript, resolveArtifactsConfig, type ArtifactsOptions, type ArtifactTemplateOverrides, type ArtifactTemplates, type ResolvedArtifactsConfig, } from '@alfalab/arui-scripts-artifacts';
 export { patchMainRspackConfigForModules, patchMainWebpackConfigForModules, } from './configs/modules';