arui-scripts 25.1.1 → 26.0.1
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/.turbo/turbo-test.log +11 -6
- package/CHANGELOG.md +37 -0
- package/README.md +17 -0
- package/build/commands/start/index.js +1 -1
- package/build/commands/start-prod/index.js +1 -1
- package/build/commands/util/artifacts-config.d.ts +2 -13
- package/build/commands/util/artifacts-config.js +8 -75
- package/build/commands/util/arui-scripts-artifacts.d.ts +3 -12
- package/build/commands/util/arui-scripts-artifacts.js +4 -23
- package/build/commands/util/docker-build.d.ts +3 -9
- package/build/commands/util/docker-build.js +3 -9
- package/build/commands/util/map-artifacts-config.d.ts +8 -0
- package/build/commands/util/map-artifacts-config.js +57 -0
- package/build/commands/util/tsc.d.ts +1 -1
- package/build/commands/util/tsc.js +7 -9
- package/build/commands/util/yarn.d.ts +1 -4
- package/build/commands/util/yarn.js +1 -4
- package/build/configs/app-configs/index.d.ts +0 -1
- package/build/configs/app-configs/index.js +0 -1
- package/build/configs/app-configs/read-config-file.js +3 -5
- package/build/configs/app-configs/types.d.ts +2 -9
- package/build/configs/app-configs/update-with-presets.js +3 -3
- package/build/configs/app-configs/validate-config.js +6 -0
- package/build/configs/app-configs/warn-about-deprecations.js +5 -0
- package/build/configs/jest/settings.js +7 -3
- package/build/configs/rspack.client.js +3 -1
- package/build/configs/util/apply-overrides.d.ts +0 -10
- package/build/configs/util/apply-overrides.js +3 -11
- package/build/configs/util/load-config-file.d.ts +1 -0
- package/build/configs/util/load-config-file.js +14 -0
- package/build/configs/util/resolve.js +9 -5
- package/build/configs/util/typescript.d.ts +8 -0
- package/build/configs/util/typescript.js +18 -0
- package/build/index.d.ts +1 -6
- package/build/index.js +1 -6
- package/docs/artifact.md +4 -3
- package/docs/compilers.md +31 -8
- package/docs/migration-v26.md +27 -0
- package/docs/overrides.md +5 -11
- package/docs/settings.md +5 -11
- package/package.json +5 -4
- package/test-start.js +200 -0
- package/test-typescript-watch.js +86 -0
- package/test-typescript.js +146 -0
- package/tsconfig-local.tsbuildinfo +1 -1
- package/build/commands/util/artifacts-deprecations.d.ts +0 -9
- package/build/commands/util/artifacts-deprecations.js +0 -66
- package/build/configs/util/register-ts-node.d.ts +0 -1
- package/build/configs/util/register-ts-node.js +0 -19
|
@@ -1,9 +1,15 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
3
|
exports.validateConfig = validateConfig;
|
|
4
|
+
const typescript_1 = require("../util/typescript");
|
|
4
5
|
const validate_build_size_budgets_1 = require("./validate-build-size-budgets");
|
|
5
6
|
function validateConfig(config) {
|
|
6
7
|
(0, validate_build_size_budgets_1.validateBuildSizeBudgets)(config.buildSizeBudgets);
|
|
8
|
+
const tscSettings = ['codeLoader', 'jestCodeTransformer'].filter((key) => config[key] === 'tsc');
|
|
9
|
+
if (tscSettings.length > 0 &&
|
|
10
|
+
Number.parseInt((0, typescript_1.getProjectTypeScript)(config.cwd).version, 10) >= 7) {
|
|
11
|
+
throw new Error(`${tscSettings.join(', ')}: режим "tsc" deprecated и поддерживается только с TypeScript <7. Используйте "swc" или "babel".`);
|
|
12
|
+
}
|
|
7
13
|
if (config.experimentalReactCompiler !== 'disabled' && config.codeLoader !== 'swc') {
|
|
8
14
|
throw new Error('Использование `experimentalReactCompiler` на данный момент поддерживается только с `codeLoader: "swc"`. \nЛибо выключите `experimentalReactCompiler`, либо измените настройку для `codeLoader`.');
|
|
9
15
|
}
|
|
@@ -2,6 +2,11 @@
|
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
3
|
exports.warnAboutDeprecations = warnAboutDeprecations;
|
|
4
4
|
function warnAboutDeprecations(config) {
|
|
5
|
+
['codeLoader', 'jestCodeTransformer'].forEach((key) => {
|
|
6
|
+
if (config[key] === 'tsc') {
|
|
7
|
+
console.warn(`${key}: режим "tsc" deprecated и поддерживается только с TypeScript <7. Используйте "swc" или "babel".`);
|
|
8
|
+
}
|
|
9
|
+
});
|
|
5
10
|
if (!Array.isArray(config.proxy) && config.proxy) {
|
|
6
11
|
console.warn('Передача config.proxy как объекта больше не поддерживается. ', 'arui-scripts попробует привести конфигурацию к корректному виду, но это не всегда может работать корректно', 'Правильный формат конфигурации можно посмотреть в документации rspack: https://rspack.dev/guide/features/dev-server#proxy');
|
|
7
12
|
// eslint-disable-next-line no-param-reassign
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
// нам приходится отвязывать его от основного кода скриптов
|
|
7
7
|
const fs = require('fs');
|
|
8
8
|
const { pathsToModuleNameMapper } = require('ts-jest');
|
|
9
|
-
const {
|
|
9
|
+
const { parse, printParseErrorCode } = require('jsonc-parser');
|
|
10
10
|
const { swcJestConfig } = require('../swc');
|
|
11
11
|
const { configs } = require('../app-configs');
|
|
12
12
|
// Значения по умолчанию из самого jest, см. https://jestjs.io/docs/configuration#transformignorepatterns-arraystring
|
|
@@ -42,8 +42,12 @@ function getPathMapping() {
|
|
|
42
42
|
return {};
|
|
43
43
|
}
|
|
44
44
|
const tsConfigText = fs.readFileSync(configs.tsconfig, 'utf8');
|
|
45
|
-
const
|
|
46
|
-
|
|
45
|
+
const errors = [];
|
|
46
|
+
const tsConfig = parse(tsConfigText, errors, { allowTrailingComma: true });
|
|
47
|
+
if (errors.length > 0) {
|
|
48
|
+
throw new Error(`Не удалось прочитать ${configs.tsconfig}: ${printParseErrorCode(errors[0].error)}`);
|
|
49
|
+
}
|
|
50
|
+
return ((_a = tsConfig === null || tsConfig === void 0 ? void 0 : tsConfig.compilerOptions) === null || _a === void 0 ? void 0 : _a.paths) || {};
|
|
47
51
|
}
|
|
48
52
|
function getTsTransformer() {
|
|
49
53
|
if (configs.jestCodeTransformer === 'tsc') {
|
|
@@ -298,7 +298,9 @@ const createSingleClientRspackConfig = (mode, entry, configName) => (Object.assi
|
|
|
298
298
|
(mode === 'prod' || !app_configs_1.configs.disableDevRspackTypecheck) &&
|
|
299
299
|
app_configs_1.configs.tsconfig !== null &&
|
|
300
300
|
app_configs_1.configs.codeLoader !== 'tsc' &&
|
|
301
|
-
new ts_checker_rspack_plugin_1.TsCheckerRspackPlugin(
|
|
301
|
+
new ts_checker_rspack_plugin_1.TsCheckerRspackPlugin({
|
|
302
|
+
typescript: { resolveRoot: app_configs_1.configs.cwd, configFile: app_configs_1.configs.tsconfig },
|
|
303
|
+
}),
|
|
302
304
|
// moment.js очень большая библиотека, которая включает в себя массу локализаций, которые мы не используем.
|
|
303
305
|
// Поэтому мы их просто игнорируем, чтобы не включать в сборку.
|
|
304
306
|
// https://github.com/jmblog/how-to-optimize-momentjs-with-webpack
|
|
@@ -29,15 +29,10 @@ type Overrides = {
|
|
|
29
29
|
browsers: string[];
|
|
30
30
|
supportingBrowsers: string[];
|
|
31
31
|
supportingNode: string[];
|
|
32
|
-
/** @deprecated Используйте `overrides.dockerfile` в конфиге @alfalab/arui-scripts-artifacts. */
|
|
33
32
|
Dockerfile: string;
|
|
34
|
-
/** @deprecated Используйте `overrides.dockerfileCompiled` в конфиге @alfalab/arui-scripts-artifacts. */
|
|
35
33
|
DockerfileCompiled: string;
|
|
36
|
-
/** @deprecated Используйте `overrides.nginxConf` в конфиге @alfalab/arui-scripts-artifacts. */
|
|
37
34
|
nginx: string;
|
|
38
|
-
/** @deprecated Используйте `overrides.baseNginxConf` в конфиге @alfalab/arui-scripts-artifacts. */
|
|
39
35
|
nginxConf: string;
|
|
40
|
-
/** @deprecated Используйте `overrides.startScript` в конфиге @alfalab/arui-scripts-artifacts. */
|
|
41
36
|
'start.sh': string;
|
|
42
37
|
serverExternalsExemptions: Array<string | RegExp>;
|
|
43
38
|
html: string;
|
|
@@ -71,11 +66,6 @@ type OverrideFunction<K extends keyof Overrides> = (config: Overrides[K], appCon
|
|
|
71
66
|
export type OverrideFile = {
|
|
72
67
|
[K in keyof Overrides]?: OverrideFunction<K>;
|
|
73
68
|
};
|
|
74
|
-
/**
|
|
75
|
-
* Объявлен ли оверрайд с таким ключом хоть в одном файле оверрайдов. Нужно, чтобы предупреждать об
|
|
76
|
-
* устаревших ключах только тем, кто ими действительно пользуется.
|
|
77
|
-
*/
|
|
78
|
-
export declare function hasOverride(overridesKey: keyof Overrides): boolean;
|
|
79
69
|
/**
|
|
80
70
|
*
|
|
81
71
|
* @param {String|String[]} overridesKey Ключи оверрайда
|
|
@@ -1,16 +1,15 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.hasOverride = hasOverride;
|
|
4
3
|
exports.applyOverrides = applyOverrides;
|
|
5
4
|
const app_configs_1 = require("../app-configs");
|
|
5
|
+
const load_config_file_1 = require("./load-config-file");
|
|
6
6
|
let overrides = [];
|
|
7
7
|
overrides = app_configs_1.configs.overridesPath.map((path) => {
|
|
8
8
|
try {
|
|
9
|
-
|
|
10
|
-
const requireResult = require(path);
|
|
9
|
+
const requireResult = (0, load_config_file_1.loadConfigFile)(path);
|
|
11
10
|
// eslint-disable-next-line no-underscore-dangle
|
|
12
11
|
if (requireResult.__esModule) {
|
|
13
|
-
//
|
|
12
|
+
// ES-модули возвращаются с default export в обёртке.
|
|
14
13
|
return requireResult.default;
|
|
15
14
|
}
|
|
16
15
|
return requireResult;
|
|
@@ -21,13 +20,6 @@ overrides = app_configs_1.configs.overridesPath.map((path) => {
|
|
|
21
20
|
return {};
|
|
22
21
|
}
|
|
23
22
|
});
|
|
24
|
-
/**
|
|
25
|
-
* Объявлен ли оверрайд с таким ключом хоть в одном файле оверрайдов. Нужно, чтобы предупреждать об
|
|
26
|
-
* устаревших ключах только тем, кто ими действительно пользуется.
|
|
27
|
-
*/
|
|
28
|
-
function hasOverride(overridesKey) {
|
|
29
|
-
return overrides.some((override) => Object.prototype.hasOwnProperty.call(override, overridesKey));
|
|
30
|
-
}
|
|
31
23
|
/**
|
|
32
24
|
*
|
|
33
25
|
* @param {String|String[]} overridesKey Ключи оверрайда
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export declare function loadConfigFile(filename: string): any;
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.loadConfigFile = loadConfigFile;
|
|
4
|
+
const jiti_1 = require("jiti");
|
|
5
|
+
// Compile TS as CommonJS so conditional exports keep selecting "require" on newer Node versions.
|
|
6
|
+
const loadTypeScript = (0, jiti_1.createJiti)(__filename, { interopDefault: true, tryNative: false });
|
|
7
|
+
// Keep JavaScript dependencies on Node's native loader, including dynamic ESM chunks.
|
|
8
|
+
function loadConfigFile(filename) {
|
|
9
|
+
if (/\.[cm]?tsx?$/.test(filename)) {
|
|
10
|
+
return loadTypeScript(filename);
|
|
11
|
+
}
|
|
12
|
+
// eslint-disable-next-line import/no-dynamic-require, global-require, @typescript-eslint/no-var-requires
|
|
13
|
+
return require(filename);
|
|
14
|
+
}
|
|
@@ -7,12 +7,16 @@ exports.tryResolve = tryResolve;
|
|
|
7
7
|
exports.resolveNodeModuleRelativeTo = resolveNodeModuleRelativeTo;
|
|
8
8
|
const path_1 = __importDefault(require("path"));
|
|
9
9
|
function tryResolve(...args) {
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
10
|
+
// Discover TS configs without globally registering a TypeScript loader.
|
|
11
|
+
for (const extension of ['', '.ts', '.tsx']) {
|
|
12
|
+
try {
|
|
13
|
+
return require.resolve(`${args[0]}${extension}`, args[1]);
|
|
14
|
+
}
|
|
15
|
+
catch (e) {
|
|
16
|
+
// Try the next supported configuration extension.
|
|
17
|
+
}
|
|
15
18
|
}
|
|
19
|
+
return undefined;
|
|
16
20
|
}
|
|
17
21
|
/**
|
|
18
22
|
* Возвращает полный путь до модуля из node_modules относительно базового пути.
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
3
|
+
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
4
|
+
};
|
|
5
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
+
exports.getProjectTypeScript = getProjectTypeScript;
|
|
7
|
+
exports.getProjectTscPath = getProjectTscPath;
|
|
8
|
+
const fs_1 = __importDefault(require("fs"));
|
|
9
|
+
const path_1 = __importDefault(require("path"));
|
|
10
|
+
function getProjectTypeScript(cwd) {
|
|
11
|
+
const packagePath = require.resolve('typescript/package.json', { paths: [cwd] });
|
|
12
|
+
const metadata = JSON.parse(fs_1.default.readFileSync(packagePath, 'utf8'));
|
|
13
|
+
return Object.assign({ packagePath }, metadata);
|
|
14
|
+
}
|
|
15
|
+
function getProjectTscPath(cwd) {
|
|
16
|
+
const { packagePath, bin } = getProjectTypeScript(cwd);
|
|
17
|
+
return path_1.default.resolve(path_1.default.dirname(packagePath), bin.tsc);
|
|
18
|
+
}
|
package/build/index.d.ts
CHANGED
|
@@ -2,17 +2,12 @@ export type { OverrideFile } from './configs/util/apply-overrides';
|
|
|
2
2
|
export type { AppConfigs, CompatModuleConfig, PackageSettings } from './configs/app-configs/types';
|
|
3
3
|
/**
|
|
4
4
|
* Утилиты сборки docker-образа, привязанные к глобальному конфигу arui-scripts.
|
|
5
|
-
* @deprecated Используйте `@alfalab/arui-scripts-artifacts` — там те же функции принимают явный конфиг.
|
|
6
|
-
* В следующей мажорной версии эти реэкспорты будут удалены.
|
|
7
5
|
*/
|
|
8
6
|
export { prepareFilesForDocker } from './commands/util/docker-build';
|
|
9
7
|
export { getBuildParamsFromArgs } from './commands/util/docker-build';
|
|
10
8
|
export { getDockerBuildCommand } from './commands/util/docker-build';
|
|
11
9
|
/**
|
|
12
|
-
* Опции сборки
|
|
13
|
-
* собрать образ через `@alfalab/arui-scripts-artifacts`, но переиспользовать настройки arui-scripts.
|
|
14
|
-
* @deprecated Слой обратной совместимости: в следующей мажорной версии настройки сборки артефактов
|
|
15
|
-
* будут жить только в конфиге `arui-scripts-artifacts.ts`.
|
|
10
|
+
* Опции и разрешённая конфигурация сборки артефактов из настроек arui-scripts.
|
|
16
11
|
*/
|
|
17
12
|
export { getArtifactsOptions, getResolvedArtifactsConfig } from './commands/util/artifacts-config';
|
|
18
13
|
export { buildDockerImage, getBuildParams, renderBaseNginxConf, renderDockerfile, renderDockerfileCompiled, renderTemplates, renderNginxConf, renderStartScript, resolveArtifactsConfig, type ArtifactsOptions, type ArtifactTemplateOverrides, type ArtifactTemplates, type ResolvedArtifactsConfig, } from '@alfalab/arui-scripts-artifacts';
|
package/build/index.js
CHANGED
|
@@ -3,8 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
|
|
|
3
3
|
exports.patchMainRspackConfigForModules = exports.resolveArtifactsConfig = exports.renderStartScript = exports.renderNginxConf = exports.renderTemplates = exports.renderDockerfileCompiled = exports.renderDockerfile = exports.renderBaseNginxConf = exports.getBuildParams = exports.buildDockerImage = exports.getResolvedArtifactsConfig = exports.getArtifactsOptions = exports.getDockerBuildCommand = exports.getBuildParamsFromArgs = exports.prepareFilesForDocker = void 0;
|
|
4
4
|
/**
|
|
5
5
|
* Утилиты сборки docker-образа, привязанные к глобальному конфигу arui-scripts.
|
|
6
|
-
* @deprecated Используйте `@alfalab/arui-scripts-artifacts` — там те же функции принимают явный конфиг.
|
|
7
|
-
* В следующей мажорной версии эти реэкспорты будут удалены.
|
|
8
6
|
*/
|
|
9
7
|
var docker_build_1 = require("./commands/util/docker-build");
|
|
10
8
|
Object.defineProperty(exports, "prepareFilesForDocker", { enumerable: true, get: function () { return docker_build_1.prepareFilesForDocker; } });
|
|
@@ -13,10 +11,7 @@ Object.defineProperty(exports, "getBuildParamsFromArgs", { enumerable: true, get
|
|
|
13
11
|
var docker_build_3 = require("./commands/util/docker-build");
|
|
14
12
|
Object.defineProperty(exports, "getDockerBuildCommand", { enumerable: true, get: function () { return docker_build_3.getDockerBuildCommand; } });
|
|
15
13
|
/**
|
|
16
|
-
* Опции сборки
|
|
17
|
-
* собрать образ через `@alfalab/arui-scripts-artifacts`, но переиспользовать настройки arui-scripts.
|
|
18
|
-
* @deprecated Слой обратной совместимости: в следующей мажорной версии настройки сборки артефактов
|
|
19
|
-
* будут жить только в конфиге `arui-scripts-artifacts.ts`.
|
|
14
|
+
* Опции и разрешённая конфигурация сборки артефактов из настроек arui-scripts.
|
|
20
15
|
*/
|
|
21
16
|
var artifacts_config_1 = require("./commands/util/artifacts-config");
|
|
22
17
|
Object.defineProperty(exports, "getArtifactsOptions", { enumerable: true, get: function () { return artifacts_config_1.getArtifactsOptions; } });
|
package/docs/artifact.md
CHANGED
|
@@ -1,9 +1,10 @@
|
|
|
1
1
|
Настройки сборки артефакта
|
|
2
2
|
===
|
|
3
3
|
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
4
|
+
Сборка Docker-образов и tar-архивов настраивается через конфигурацию arui-scripts.
|
|
5
|
+
Используйте `dockerRegistry`, `baseDockerImage`, `archiveName` и остальные
|
|
6
|
+
[настройки сборки артефактов](settings.md#настройки-сборки-артефактов).
|
|
7
|
+
Для изменения шаблонов используйте `arui-scripts.overrides.ts` или локальные файлы проекта.
|
|
7
8
|
|
|
8
9
|
## docker
|
|
9
10
|
|
package/docs/compilers.md
CHANGED
|
@@ -1,18 +1,41 @@
|
|
|
1
|
-
##
|
|
1
|
+
## TypeScript
|
|
2
2
|
|
|
3
3
|
Компиляция TS работает из коробки, если в корне проекта есть файл `tsconfig.json`.
|
|
4
4
|
За основу можно использовать дефолтный конфиг:
|
|
5
5
|
|
|
6
6
|
```json
|
|
7
7
|
{
|
|
8
|
-
"extends": "
|
|
8
|
+
"extends": "arui-scripts/tsconfig.json"
|
|
9
9
|
}
|
|
10
10
|
```
|
|
11
11
|
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
12
|
+
TypeScript остаётся peer-зависимостью: установите нужную версию в проект.
|
|
13
|
+
Проверка типов использует TypeScript проекта. Версии 5–6 работают через JavaScript-компилятор,
|
|
14
|
+
версия 7 — через нативный компилятор. Это относится и к отдельному процессу watch,
|
|
15
|
+
и к проверке типов в Rspack.
|
|
16
16
|
|
|
17
|
-
|
|
18
|
-
|
|
17
|
+
Транспиляция кода приложения и тестов по умолчанию выполняется через SWC.
|
|
18
|
+
Для TypeScript 7 используйте `swc` или `babel`:
|
|
19
|
+
|
|
20
|
+
```ts
|
|
21
|
+
export default {
|
|
22
|
+
codeLoader: 'swc',
|
|
23
|
+
jestCodeTransformer: 'swc',
|
|
24
|
+
};
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
### Устаревшие режимы tsc
|
|
28
|
+
|
|
29
|
+
Значение `tsc` в настройках [`codeLoader`](settings.md#codeloader) и
|
|
30
|
+
[`jestCodeTransformer`](settings.md#jestcodetransformer) **deprecated**.
|
|
31
|
+
Оно использует `ts-loader` / `ts-jest` и поддерживается только с TypeScript <7.
|
|
32
|
+
На TypeScript 5–6 режимы продолжают работать с предупреждением; на TypeScript 7
|
|
33
|
+
arui-scripts выдаёт ошибку с рекомендацией перейти на SWC/Babel.
|
|
34
|
+
|
|
35
|
+
Это ограничение относится к транспиляции. Проверка типов через `tsc` продолжает работать
|
|
36
|
+
на TypeScript 7 при использовании SWC/Babel.
|
|
37
|
+
|
|
38
|
+
### Конфиги и overrides
|
|
39
|
+
|
|
40
|
+
Файлы `arui-scripts.config.ts`, `arui-scripts.overrides.ts` и TS-presets загружаются через `jiti`.
|
|
41
|
+
Для их выполнения не нужен старый TypeScript Compiler API и не устанавливается отдельный TS 6.
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
Миграция на arui-scripts 26
|
|
2
|
+
===
|
|
3
|
+
|
|
4
|
+
## Конфигурация сборки артефактов
|
|
5
|
+
|
|
6
|
+
`dockerRegistry`, `baseDockerImage`, `nginxRootPath`, `nginx`, `runFromNonRootUser`,
|
|
7
|
+
`removeDevDependenciesDuringDockerBuild`, `deleteNpm`, `archiveName`, `additionalBuildPath`
|
|
8
|
+
и оверрайды `Dockerfile`, `DockerfileCompiled`, `nginx`, `nginxConf`, `start.sh`
|
|
9
|
+
остаются поддерживаемой частью arui-scripts. Предупреждения об устаревании удалены.
|
|
10
|
+
Если вы не переносили эти настройки, менять ничего не нужно.
|
|
11
|
+
|
|
12
|
+
Команды `arui-scripts docker-build`, `docker-build:compiled` и `archive-build` больше
|
|
13
|
+
не загружают проектный `arui-scripts-artifacts.ts` (и остальные варианты имени этого конфига).
|
|
14
|
+
При обновлении выберите один из вариантов:
|
|
15
|
+
|
|
16
|
+
- Продолжать использовать команды arui-scripts: вернуть настройки сборки в
|
|
17
|
+
`arui-scripts.config.ts`, `package.json#aruiScripts` или presets, а оверрайды —
|
|
18
|
+
в `arui-scripts.overrides.ts`.
|
|
19
|
+
- Использовать самостоятельную сборку артефактов: оставить `arui-scripts-artifacts.ts`
|
|
20
|
+
и переключить команды на `arui-scripts-artifacts docker-build`,
|
|
21
|
+
`arui-scripts-artifacts docker-build:compiled`, `arui-scripts-artifacts archive-build`.
|
|
22
|
+
Пакет `@alfalab/arui-scripts-artifacts` нужно установить явно; arui-scripts ему не требуется.
|
|
23
|
+
|
|
24
|
+
Соответствие полей и оверрайдов приведено в
|
|
25
|
+
[таблице миграции](../../arui-scripts-artifacts/docs/migration.md#таблица-соответствия).
|
|
26
|
+
Особенно обратите внимание на nginx: `overrides.nginxConf` в artifacts соответствует
|
|
27
|
+
`nginx` в arui-scripts, а `overrides.baseNginxConf` — `nginxConf`.
|
package/docs/overrides.md
CHANGED
|
@@ -64,17 +64,17 @@ export default overrides;
|
|
|
64
64
|
Альтернативно вы можете использовать любые методы передачи списка браузеров, поддерживаемые пакетом browserslist.
|
|
65
65
|
Ключи: `browsers`, `supportingBrowsers`
|
|
66
66
|
- `supportingNode` - список поддерживаемых версий nodejs в формате [browserslist](https://github.com/browserslist/browserslist).
|
|
67
|
-
- `Dockerfile` -
|
|
67
|
+
- `Dockerfile` - Докерфайл, который будет использоваться для сборки контейнера.
|
|
68
68
|
Базовый шаблон [тут](../../arui-scripts-artifacts/src/docker/templates/dockerfile.template.ts).
|
|
69
69
|
[`Dockerfile` в корне проекта](#docker) имеет приоритет над overrides.
|
|
70
|
-
- `DockerfileCompiled` -
|
|
71
|
-
- `nginx` -
|
|
70
|
+
- `DockerfileCompiled` - Докерфайл, который будет использоваться для сборки контейнера при использовании команды `arui-scripts docker-build:compiled`
|
|
71
|
+
- `nginx` - Шаблон конфигурации для nginx внутри контейнера.
|
|
72
72
|
Базовый шаблон [тут](../../arui-scripts-artifacts/src/nginx/templates/nginx.conf.template.ts).
|
|
73
73
|
[Файл `nginx.conf`](nginx.md) в корне имеет приоритет над оверрайдами.
|
|
74
|
-
- `nginxConf` -
|
|
74
|
+
- `nginxConf` - Шаблон базовой конфигурации для nginx внутри контейнера
|
|
75
75
|
Базовый шаблон аналогичный тому, который добавлется в базовый образ [тут](../../arui-scripts-artifacts/src/nginx/templates/base-nginx.conf.template.ts).
|
|
76
76
|
[Файл `base-nginx.conf`](base-nginx.md) в корне имеет приоритет над оверрайдами.
|
|
77
|
-
- `start.sh` -
|
|
77
|
+
- `start.sh` - Шаблон entrypoint докер контейнера. Базовый шаблон [тут](../../arui-scripts-artifacts/src/start-script/start.template.ts).
|
|
78
78
|
- `serverExternalsExemptions` - список модулей, которые не будут добавлены в список внешних зависимостей сервера. [Подробнее](caveats.md#node-externals).
|
|
79
79
|
- `html` - шаблон для htmlWebpackPlugin, будет использоваться только в режиме [`clientOnly`](./settings.md#clientonly).
|
|
80
80
|
- `swc-client` - конфигурация `swc` для клиентского кода. Ключи: `swc`, `swcClient`.
|
|
@@ -83,12 +83,6 @@ export default overrides;
|
|
|
83
83
|
|
|
84
84
|
Для некоторых конфигураций определены несколько ключей, они будут применяться в том порядке, в котором они приведены в этом файле.
|
|
85
85
|
|
|
86
|
-
> ⚠️ Оверрайды файлов артефакта поставки (`Dockerfile`, `DockerfileCompiled`, `nginx`, `nginxConf`,
|
|
87
|
-
> `start.sh`) объявлены устаревшими и будут удалены в следующей мажорной версии arui-scripts.
|
|
88
|
-
> Переносите их в секцию `overrides` конфига `arui-scripts-artifacts.ts`
|
|
89
|
-
> ([таблица соответствия](../../arui-scripts-artifacts/docs/migration.md)).
|
|
90
|
-
> Команды сборки предупреждают о таких оверрайдах в консоли.
|
|
91
|
-
|
|
92
86
|
### Создание дополнительных конфигураций для rspack
|
|
93
87
|
На некоторых проектах может потребоваться создать дополнительные конфигурации для rspack. Например, для создания
|
|
94
88
|
service worker'а (или любых других кейсов). Для этого можно использовать функцию-хелпер `createSingleClientRspackConfig`:
|
package/docs/settings.md
CHANGED
|
@@ -132,9 +132,6 @@ export default settings;
|
|
|
132
132
|
#### additionalBuildPath
|
|
133
133
|
Массив путей, которые попадут в архив при использовании [команды archive-build](./commands.md#archive-build). По умолчанию `['config']`.
|
|
134
134
|
|
|
135
|
-
:warning: Настройка устарела, см. [настройки сборки артефактов](#настройки-сборки-артефактов).
|
|
136
|
-
Замена — `archive.additionalPaths` в конфиге `arui-scripts-artifacts.ts`.
|
|
137
|
-
|
|
138
135
|
#### statsOutputFilename
|
|
139
136
|
Имя [stats-файла](https://webpack.js.org/api/stats/), которое будет использоваться в [bundle-analyze команде](./commands.md#bundle-analyze). По умолчанию `stats.json`
|
|
140
137
|
|
|
@@ -169,12 +166,9 @@ const settings = {
|
|
|
169
166
|
|
|
170
167
|
### Настройки сборки артефактов
|
|
171
168
|
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
> `arui-scripts-artifacts.ts` в корне проекта (таблица соответствия — в
|
|
176
|
-
> [документации пакета](../../arui-scripts-artifacts/docs/migration.md)).
|
|
177
|
-
> Команды сборки предупреждают о таких настройках в консоли.
|
|
169
|
+
Настройки команд `docker-build`, `docker-build:compiled` и `archive-build` задаются в
|
|
170
|
+
конфигурации arui-scripts и поддерживают presets и переменные окружения
|
|
171
|
+
наравне с остальными настройками. Шаблоны можно менять через [overrides](overrides.md).
|
|
178
172
|
|
|
179
173
|
#### dockerRegistry
|
|
180
174
|
Адрес используемого docker registry, по умолчанию `''`, то есть используется публичный registry
|
|
@@ -250,7 +244,7 @@ const settings = {
|
|
|
250
244
|
|
|
251
245
|
Возможные значения:
|
|
252
246
|
- `babel` - для всего кода будет использоваться `babel-loader`;
|
|
253
|
-
- `tsc` - для ts кода будет использоваться `ts-loader`, для всего остального - `babel-loader`;
|
|
247
|
+
- `tsc` (**deprecated**, только TypeScript <7) - для ts кода будет использоваться `ts-loader`, для всего остального - `babel-loader`;
|
|
254
248
|
- `swc` - для всего кода будет использоваться `swc-loader`.
|
|
255
249
|
|
|
256
250
|
`swc` является предпочтительным режимом, дефолты не меняются для сохранения обратной совместимости.
|
|
@@ -284,7 +278,7 @@ const packageSettings = {
|
|
|
284
278
|
|
|
285
279
|
Возможные значения:
|
|
286
280
|
- `babel` - для всего кода будет использоваться `babel-jest`;
|
|
287
|
-
- `tsc` - для ts кода будет использоваться `ts-jest`, для всего остального - `babel-jest`;
|
|
281
|
+
- `tsc` (**deprecated**, только TypeScript <7) - для ts кода будет использоваться `ts-jest`, для всего остального - `babel-jest`;
|
|
288
282
|
- `swc` - для всего кода будет использоваться `@swc/jest`.
|
|
289
283
|
Swc более строго следует спецификациям и [не дает возможности](https://github.com/swc-project/swc/issues/5059) делать `spyOn` для экспортов из esm модулей.
|
|
290
284
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "arui-scripts",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "26.0.1",
|
|
4
4
|
"main": "./build/index.js",
|
|
5
5
|
"typings": "./build/index.d.ts",
|
|
6
6
|
"exports": {
|
|
@@ -22,7 +22,7 @@
|
|
|
22
22
|
"homepage": "https://github.com/core-ds/arui-scripts#readme",
|
|
23
23
|
"bin": "./build/bin/index.js",
|
|
24
24
|
"dependencies": {
|
|
25
|
-
"@alfalab/arui-scripts-artifacts": "^1.0.
|
|
25
|
+
"@alfalab/arui-scripts-artifacts": "^1.0.3",
|
|
26
26
|
"@alfalab/postcss-custom-properties": "^9.1.2",
|
|
27
27
|
"@babel/core": "7.29.7",
|
|
28
28
|
"@babel/plugin-proposal-decorators": "^7.29.7",
|
|
@@ -85,6 +85,8 @@
|
|
|
85
85
|
"jest-config": "^29.7.0",
|
|
86
86
|
"jest-resolve": "^29.7.0",
|
|
87
87
|
"jest-snapshot-serializer-class-name-to-string": "1.0.0",
|
|
88
|
+
"jiti": "^2.7.0",
|
|
89
|
+
"jsonc-parser": "^3.3.1",
|
|
88
90
|
"lodash.merge": "4.6.2",
|
|
89
91
|
"mini-css-extract-plugin": "2.7.6",
|
|
90
92
|
"mini-svg-data-uri": "^1.4.4",
|
|
@@ -115,7 +117,7 @@
|
|
|
115
117
|
"rspack-manifest-plugin": "5.2.2",
|
|
116
118
|
"run-script-webpack-plugin": "0.0.11",
|
|
117
119
|
"semver": "^7.5.4",
|
|
118
|
-
"serialize-javascript": "^7.
|
|
120
|
+
"serialize-javascript": "^7.1.3",
|
|
119
121
|
"shelljs": "0.8.5",
|
|
120
122
|
"strip-ansi": "6.0.1",
|
|
121
123
|
"style-loader": "3.3.3",
|
|
@@ -126,7 +128,6 @@
|
|
|
126
128
|
"ts-checker-rspack-plugin": "^1.6.1",
|
|
127
129
|
"ts-jest": "29.1.0",
|
|
128
130
|
"ts-loader": "9.4.4",
|
|
129
|
-
"ts-node": "10.9.2",
|
|
130
131
|
"vite": "^8.3.3",
|
|
131
132
|
"vite-tsconfig-paths": "^6.1.1",
|
|
132
133
|
"vitest": "^5.0.2",
|