arui-scripts 12.0.1 → 12.3.0-feat-ts-config-files.1

package/CHANGELOG.md

@@ -1,7 +1,6 @@
-## [12.0.1](https://github.com/alfa-laboratory/arui-scripts/compare/v12.0.0...v12.0.1) (2021-11-16)
+# [12.3.0-feat-ts-config-files.1](https://github.com/alfa-laboratory/arui-scripts/compare/v12.2.0...v12.3.0-feat-ts-config-files.1) (2022-02-17)
 
 
-### Bug Fixes
+### Features
 
-* **package.json:** up peerDependencies ([7ff5c69](https://github.com/alfa-laboratory/arui-scripts/commit/7ff5c69ade098078e4f3980ddb2f66c3a79c2a1b))
-* **yarn.lock:** up ([3496603](https://github.com/alfa-laboratory/arui-scripts/commit/3496603b59984c90b1cece92c647b926f5743375))
+* **overrides:** allow typescript overrides and config files ([8d7b0a6](https://github.com/alfa-laboratory/arui-scripts/commit/8d7b0a663c469b54d9a033a821f39061632d1298))

package/README.md

@@ -68,6 +68,7 @@ npm install arui-scripts --save-dev
 - `archiveName` - имя архива, который будет создан при использовании команды `archive-build`. По умолчанию `build.tar`.
 - `keepPropTypes` - если `true`, пакеты с prop-types не будут удалены из production билда.
 - `debug` - режим отладки, в котором не выполняются некоторые нежелательные операции и выводится больше сообщений об ошибках, по умолчанию `false`.
+- `statsOutputFilename` - имя [stats-файла](https://webpack.js.org/api/stats/), которое будет использоваться в [bundle-analyze](#анализ-бандла) команде
 - `useTscLoader` -  использовать ts-loader вместо babel-loader для обработки ts файлов. У babel-loader есть [ряд ограничений](https://blogs.msdn.microsoft.com/typescript/2018/08/27/typescript-and-babel-7/). По умолчанию `false`.
 - `componentsTheme` - путь к css файлу с темой для [core-components](https://alfa-laboratory.github.io/core-components). Используется для настройки [postcss-custom-properties](https://github.com/postcss/postcss-custom-properties#importfrom).
 - `keepCssVars` - отключает `postcss-custom-properties`, css переменные будут оставаться в бандле.
@@ -426,14 +427,23 @@ require node.js на таких местах ломается. Поэтому н
 воспользоваться механизмом `overrides`, описанным ниже.
 По умолчанию же все не-js файлы из внешних модулей будут проигнорированы.
 
-
+Анализ бандла
+---
+Для изучения итогового бандла приложения и просмотра его размеров и включенных файлов в arui-scripts есть команда
+```
+arui-scripts bundle-analyze
+```
+Она запускает [webpack-bundle-analyzer](https://www.npmjs.com/package/webpack-bundle-analyzer) для клиентского кода.
+Так же при запуске будет генерироваться [stats-файл](https://webpack.js.org/api/stats/), который можно использовать в
+[сторонних](http://webpack.github.io/analyse/) инструментах, например для понимания почему тот или иной модуль попал в бандл.
+По умолчанию файл будет писаться в `.build/stats.json`.
 
 Тонкая настройка
 ===
 Если вам не хватает гибкости при использовании `arui-scripts`, например вы хотите добавить свой плагин для вебпака -
 вы можете воспользоваться механизмом `overrides`.
 
-Для этого вам необходимо создать в корне вашего проекта файл `arui-scripts.overrides.js`, из которого вы сможете управлять
+Для этого вам необходимо создать в корне вашего проекта файл `arui-scripts.overrides.js` или `arui-scripts.overrides.ts`, из которого вы сможете управлять
 конфигурацией почти всех инструментов, используемых в `arui-scripts`.
 
 Принцип работы тут следующий. Для всех конфигураций определен набор ключей, которые они будут искать в `arui-scripts.overrides.js`,
@@ -441,7 +451,7 @@ require node.js на таких местах ломается. Поэтому н
 существующая конфигурация и полный конфиг приложения (см [AppConfig](./src/configs/app-configs/types.ts)).
 Возвращать такая функция должна так же конфигурацию.
 
-Например такое содержимое `arui-scripts.overrides.js`:
+Пример `arui-scripts.overrides.js`:
 ```javascript
 const path = require('path');
 module.exports = {
@@ -454,6 +464,23 @@ module.exports = {
 };
 ```
 
+Пример `arui-scripts.overrides.ts`:
+```ts
+import type { OverrideFile } from 'arui-scripts';
+import path from 'path';
+
+const overrides: OverrideFile = {
+    webpack: (config, applicationConfig) => {
+        config.resolve.alias = {
+            components: path.resolve(__dirname, 'src/components')
+        };
+        return config;
+    }
+};
+
+export default overrides;
+```
+
 С помощью этой конфигурации ко всем настройкам вебпака будет добавлен `alias` *components*.
 
 На данный момент можно переопределять следующие конфигурации:
@@ -522,10 +549,10 @@ module.exports = {
 от папки, содержащей package.json. Так что это может быть как папка в проекте, так и пакет из node_modules).
 
 Сам пакет с пресетами может содержать два файла:
-- `arui-scirpts.config.js`
-- `arui-scripts.overrides.js`
+- `arui-scirpts.config.js` (или `arui-scripts.config.ts`)
+- `arui-scripts.overrides.js` (или `arui-scirpts.overrides.ts`)
 
-### arui-scripts.config.js
+### arui-scripts.config (js | ts)
 С помощью этого файла можно задать любые ключи [конфигурации](#настройки).
 ```js
 module.exports = {
@@ -533,6 +560,17 @@ module.exports = {
 };
 ```
 
+Или в виде ts:
+```ts
+import type { PackageSettings } from 'arui-scripts';
+
+const settings: PackageSettings = {
+    baseDockerImage: 'my-company-artifactory.com/arui-scripts-base:11.2'
+};
+
+export default settings;
+```
+
 На проекте конфиурация будет загружаться в следующем порядке:
 1. базовые настройки из arui-scripts
 2. настройки из presets
@@ -545,7 +583,7 @@ module.exports = {
 они будут вычисляться относительно корня проекта, а не вашей конфигурации.
 Вы можете использовать абсолютные пути при необходимости задать путь до файла внутри пакета с пресетами.
 
-### arui-scripts.overrides.js
+### arui-scripts.overrides (js | ts)
 С помощью этого файла можно задать базовые оверрайды проекта, аналогично [заданию оверрайдов на проекте](#тонкая-настройка).
 ```js
 module.exports = {

package/build/bin/index.d.ts

@@ -0,0 +1,2 @@
+#! /usr/bin/env node
+export {};

package/build/bin/index.js

@@ -1,6 +1,15 @@
 #! /usr/bin/env node
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
 /* eslint import/no-dynamic-require: 0 */
+const ts_node_1 = __importDefault(require("ts-node"));
+// Мы используем ts-node для работы c конфигами, описаными на ts
+ts_node_1.default.register({
+    transpileOnly: true,
+});
 const commands = [
     'start',
     'build',

package/build/commands/archive-build/index.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,8 @@
+import webpack from 'webpack';
+declare type BuildResult = {
+    stats: webpack.Stats;
+    warnings: string[];
+    previousFileSizes: unknown;
+};
+declare function build(config: webpack.Configuration, previousFileSizes?: unknown): Promise<BuildResult>;
+export default build;

package/build/commands/build/client.d.ts

@@ -0,0 +1 @@
+export {};

package/build/commands/build/index.d.ts

@@ -0,0 +1 @@
+export {};

package/build/commands/build/server.d.ts

@@ -0,0 +1 @@
+export {};

package/build/commands/bundle-analyze/index.d.ts

@@ -0,0 +1 @@
+export {};

package/build/commands/bundle-analyze/index.js

@@ -16,10 +16,15 @@ const webpack_1 = __importDefault(require("webpack"));
 const webpack_bundle_analyzer_1 = require("webpack-bundle-analyzer");
 const make_tmp_dir_1 = __importDefault(require("../util/make-tmp-dir"));
 const webpack_client_prod_1 = __importDefault(require("../../configs/webpack.client.prod"));
+const app_configs_1 = __importDefault(require("../../configs/app-configs"));
 (() => __awaiter(void 0, void 0, void 0, function* () {
     var _a;
     const tmpDir = yield make_tmp_dir_1.default();
-    (_a = webpack_client_prod_1.default === null || webpack_client_prod_1.default === void 0 ? void 0 : webpack_client_prod_1.default.plugins) === null || _a === void 0 ? void 0 : _a.push((new webpack_bundle_analyzer_1.BundleAnalyzerPlugin()));
+    const plugin = new webpack_bundle_analyzer_1.BundleAnalyzerPlugin({
+        generateStatsFile: true,
+        statsFilename: app_configs_1.default.statsOutputPath,
+    });
+    (_a = webpack_client_prod_1.default.plugins) === null || _a === void 0 ? void 0 : _a.push(plugin);
     webpack_client_prod_1.default.output.path = tmpDir;
     webpack_1.default(webpack_client_prod_1.default).run(() => { });
 }))();

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

@@ -0,0 +1 @@
+export {};

package/build/commands/start/client.d.ts

@@ -0,0 +1 @@
+export {};

package/build/commands/start/index.d.ts

@@ -0,0 +1 @@
+export {};

package/build/commands/start/print-compiler-output.d.ts

@@ -0,0 +1 @@
+export default function printCompilerOutput(compilerName: string, stats: any): void;

package/build/commands/start/server.d.ts

@@ -0,0 +1 @@
+export {};

package/build/commands/test/index.d.ts

@@ -0,0 +1 @@
+export {};

package/build/commands/util/check-required-files.d.ts

@@ -0,0 +1,2 @@
+declare function checkRequiredFiles(): boolean;
+export default checkRequiredFiles;

package/build/commands/util/client-assets-sizes.d.ts

@@ -0,0 +1,26 @@
+import { Stats } from 'webpack';
+declare type AssetSize = {
+    name: string;
+    fullName: string;
+    gzipSize: number;
+    brotliSize: number;
+    size: number;
+    sizeLabel: string;
+    gzipLabel: string;
+    brotliLabel: string;
+};
+declare type TotalSizes = {
+    size: number;
+    sizeLabel: string;
+    gzipSize: number;
+    gzipLabel: string;
+    brotliSize: number;
+    brotliLabel: string;
+};
+declare type ClientAssetsSizes = {
+    totalSizes: TotalSizes;
+    assets: AssetSize[];
+};
+export declare function calculateAssetsSizes(webpackStats: Stats, rootDir?: string): ClientAssetsSizes;
+export declare function printAssetsSizes(sizes: ClientAssetsSizes): void;
+export {};

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

@@ -0,0 +1,2 @@
+declare function exec(command: string): Promise<unknown>;
+export default exec;

package/build/commands/util/format-webpack-messages.d.ts

@@ -0,0 +1,5 @@
+export = formatWebpackMessages;
+declare function formatWebpackMessages(json: any): {
+    errors: any;
+    warnings: any;
+};

package/build/commands/util/make-tmp-dir.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Создает и возвращает временную папку
+ * @returns {Promise<string>}
+ */
+declare function makeTmpDir(): Promise<string>;
+export default makeTmpDir;

package/build/configs/app-configs/available-package-settings.d.ts

@@ -0,0 +1,8 @@
+import { AppConfigs } from './types';
+/**
+ * Эти ключи из конфига будут обновляться из package.json при их наличии
+ */
+export declare const availablePackageSettings: readonly ["dockerRegistry", "baseDockerImage", "serverEntry", "buildPath", "assetsPath", "additionalBuildPath", "nginxRootPath", "runFromNonRootUser", "archiveName", "serverOutput", "clientPolyfillsEntry", "clientEntry", "keepPropTypes", "useTscLoader", "useServerHMR", "clientServerPort", "serverPort", "debug", "statsOutputFilename", "componentsTheme", "keepCssVars"];
+declare type ArrayElementType<ArrayType extends ReadonlyArray<unknown>> = ArrayType[number];
+export declare type PackageSettings = Partial<Pick<AppConfigs, ArrayElementType<typeof availablePackageSettings>>>;
+export {};

package/build/configs/app-configs/available-package-settings.js

@@ -23,6 +23,7 @@ exports.availablePackageSettings = [
     'clientServerPort',
     'serverPort',
     'debug',
+    'statsOutputFilename',
     'componentsTheme',
     'keepCssVars',
 ];

package/build/configs/app-configs/calculate-dependent-config.d.ts

@@ -0,0 +1,11 @@
+import { AppConfigs } from './types';
+/**
+ * Обновление ключей конфига, зависящих от других. Это нужно делать в самый последний момент
+ */
+export declare function calculateDependentConfig(config: AppConfigs): AppConfigs & {
+    publicPath: string;
+    serverOutputPath: string;
+    clientOutputPath: string;
+    clientPolyfillsEntry: string[];
+    statsOutputPath: string;
+};

package/build/configs/app-configs/calculate-dependent-config.js

@@ -16,6 +16,7 @@ function calculateDependentConfig(config) {
         serverOutputPath: path_1.default.resolve(config.cwd, config.buildPath),
         clientOutputPath: path_1.default.resolve(config.cwd, config.buildPath, config.assetsPath),
         clientPolyfillsEntry: get_polyfills_1.getPolyfills(config),
+        statsOutputPath: path_1.default.resolve(config.cwd, config.buildPath, config.statsOutputFilename),
     });
 }
 exports.calculateDependentConfig = calculateDependentConfig;

package/build/configs/app-configs/get-defaults.d.ts

@@ -0,0 +1,2 @@
+import { AppConfigs } from './types';
+export declare function getDefaults(): AppConfigs;

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

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getDefaults = void 0;
 const path_1 = __importDefault(require("path"));
 const fs_1 = __importDefault(require("fs"));
+const try_resolve_1 = require("../util/try-resolve");
 function getDefaults() {
     const CWD = process.cwd();
     const appPackage = JSON.parse(fs_1.default.readFileSync(path_1.default.join(CWD, 'package.json'), 'utf8'));
@@ -16,7 +17,7 @@ function getDefaults() {
     const absoluteNodeModulesPath = path_1.default.resolve(CWD, 'node_modules');
     const projectTsConfigPath = path_1.default.join(CWD, 'tsconfig.json');
     const yarnLockFilePath = path_1.default.join(CWD, 'yarn.lock');
-    const overridesPath = path_1.default.join(CWD, 'arui-scripts.overrides.js');
+    const overridesPath = try_resolve_1.tryResolve(path_1.default.join(CWD, 'arui-scripts.overrides'));
     const nginxConfFilePath = path_1.default.join(CWD, 'nginx.conf');
     const dockerfileFilePath = path_1.default.join(CWD, 'Dockerfile');
     return {
@@ -52,13 +53,15 @@ function getDefaults() {
         clientServerPort: 8080,
         serverPort: 3000,
         debug: false,
-        overridesPath: [overridesPath],
+        overridesPath: overridesPath ? [overridesPath] : [],
+        statsOutputFilename: 'stats.json',
         componentsTheme: undefined,
         keepCssVars: false,
         // Эти пути зависят от других настроек, которые могут быть переопределены пользователем
         publicPath: '',
         serverOutputPath: '',
         clientOutputPath: '',
+        statsOutputPath: '',
     };
 }
 exports.getDefaults = getDefaults;

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

@@ -0,0 +1,3 @@
+import { AppConfigs } from './types';
+declare let config: AppConfigs;
+export default config;

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

@@ -0,0 +1,38 @@
+export declare type AppConfigs = {
+    appPackage: any;
+    name: string;
+    version: string;
+    dockerRegistry: string;
+    baseDockerImage: string;
+    cwd: string;
+    appSrc: string;
+    appNodeModules: string;
+    buildPath: string;
+    assetsPath: string;
+    additionalBuildPath: string[];
+    nginxRootPath: string;
+    runFromNonRootUser: boolean;
+    archiveName: string;
+    serverEntry: string | string[] | Record<string, string | string[]>;
+    serverOutput: string;
+    clientPolyfillsEntry: null | string | string[];
+    clientEntry: string;
+    keepPropTypes: boolean;
+    tsconfig: string | null;
+    localNginxConf: string | null;
+    localDockerfile: string | null;
+    useTscLoader: boolean;
+    useServerHMR: boolean;
+    useYarn: boolean;
+    clientServerPort: number;
+    serverPort: number;
+    debug: boolean;
+    overridesPath: string[];
+    statsOutputFilename: string;
+    componentsTheme: string | undefined;
+    keepCssVars: boolean;
+    publicPath: string;
+    serverOutputPath: string;
+    clientOutputPath: string;
+    statsOutputPath: string;
+};

package/build/configs/app-configs/update-with-env.d.ts

@@ -0,0 +1,2 @@
+import { AppConfigs } from './types';
+export declare function updateWithEnv(config: AppConfigs): any;

package/build/configs/app-configs/update-with-package.d.ts

@@ -0,0 +1,2 @@
+import { AppConfigs } from './types';
+export declare function updateWithPackage(config: AppConfigs): any;

package/build/configs/app-configs/update-with-presets.d.ts

@@ -0,0 +1,2 @@
+import { AppConfigs } from './types';
+export declare function updateWithPresets(config: AppConfigs): AppConfigs;

package/build/configs/app-configs/update-with-presets.js

@@ -13,8 +13,8 @@ function updateWithPresets(config) {
     if (!packageSettings.presets) {
         return config;
     }
-    const presetsConfigPath = try_resolve_1.tryResolve(`${packageSettings.presets}/arui-scripts.config.js`, { paths: [config.cwd] });
-    const presetsOverridesPath = try_resolve_1.tryResolve(`${packageSettings.presets}/arui-scripts.overrides.js`, { paths: [config.cwd] });
+    const presetsConfigPath = try_resolve_1.tryResolve(`${packageSettings.presets}/arui-scripts.config`, { paths: [config.cwd] });
+    const presetsOverridesPath = try_resolve_1.tryResolve(`${packageSettings.presets}/arui-scripts.overrides`, { paths: [config.cwd] });
     if (presetsConfigPath) {
         const presetsSettings = require(presetsConfigPath);
         validate_settings_keys_1.default(available_package_settings_1.availablePackageSettings, presetsSettings);

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

@@ -0,0 +1,7 @@
+/**
+ * Функция проверяет что все ключи объекта settingsObject есть в массиве availableKeys
+ * @param {string[]} availableKeys Массив допустимых настроек
+ * @param settingsObject Объект с настройками
+ */
+declare function validateSettingsKeys(availableKeys: ReadonlyArray<string>, settingsObject: Record<string, unknown>): void;
+export default validateSettingsKeys;

package/build/configs/babel-client.d.ts

@@ -0,0 +1,2 @@
+declare const babelClientConfig: any;
+export default babelClientConfig;

package/build/configs/babel-server.d.ts

@@ -0,0 +1,2 @@
+declare const config: any;
+export default config;

package/build/configs/dev-server.d.ts

@@ -0,0 +1,3 @@
+/// <reference types="webpack-dev-server" />
+declare const devServerConfig: import("webpack-dev-server").Configuration;
+export default devServerConfig;

package/build/configs/jest/babel-transform.d.ts

@@ -0,0 +1,7 @@
+declare const _exports: {
+    canInstrument?: boolean | undefined;
+    createTransformer?: ((options?: any) => import("@jest/transform").Transformer) | undefined;
+    getCacheKey?: ((fileData: string, filePath: string, configStr: string, options: import("@jest/transform").CacheKeyOptions) => string) | undefined;
+    process: (sourceText: string, sourcePath: string, config: import("@jest/types/build/Config").ProjectConfig, options?: import("@jest/transform").TransformOptions | undefined) => import("@jest/transform").TransformedSource;
+};
+export = _exports;

package/build/configs/jest/css-mock.d.ts

@@ -0,0 +1 @@
+export {};

package/build/configs/jest/file-transform.d.ts

@@ -0,0 +1,2 @@
+export declare function process(src: any, filename: any): string;
+export declare function process(src: any, filename: any): string;

package/build/configs/jest/index.d.ts

@@ -0,0 +1,19 @@
+export declare const testRegex: string;
+export declare const moduleFileExtensions: string[];
+export declare const collectCoverageFrom: string[];
+export declare const transform: {
+    '^.+\\.jsx?$': string;
+    '^.+\\.tsx?$': string;
+    '^(?!.*\\.(js|jsx|ts|tsx|css|json)$)': string;
+};
+export declare const moduleNameMapper: {
+    '\\.css$': string;
+};
+export declare const setupFiles: string[];
+export declare const snapshotSerializers: string[];
+export declare const globals: {
+    'ts-jest': {
+        tsconfig: string | null;
+        babelConfig: any;
+    };
+};

package/build/configs/jest/setup.d.ts

@@ -0,0 +1 @@
+export {};

package/build/configs/mq.d.ts

@@ -0,0 +1,24 @@
+export declare const customMedia: {
+    "--small": string;
+    "--small-only": string;
+    "--medium": string;
+    "--medium-only": string;
+    "--large": string;
+    "--large-only": string;
+    "--xlarge": string;
+    "--xlarge-only": string;
+    "--xxlarge": string;
+    "--xxlarge-only": string;
+    "--mobile-s": string;
+    "--mobile-m": string;
+    "--mobile-l": string;
+    "--mobile": string;
+    "--tablet-s": string;
+    "--tablet-m": string;
+    "--tablet": string;
+    "--desktop-s": string;
+    "--desktop-m": string;
+    "--desktop-l": string;
+    "--desktop-xl": string;
+    "--desktop": string;
+};

package/build/configs/postcss.config.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Функция для создания конфигурационного файла postcss
+ * @param {String[]} plugins список плагинов
+ * @param {Object} options коллекция конфигураций плагинов, где ключ - название плагина, а значение - аргумент для инициализации
+ * @returns {*}
+ */
+export declare function createPostcssConfig(plugins: string[], options: Record<string, unknown>): any[];
+export declare const postcssPlugins: string[];
+export declare const postcssPluginsOptions: {
+    'postcss-custom-properties'?: {
+        preserve: boolean;
+        importFrom: string | undefined;
+    };
+    'postcss-import': {
+        path: string[];
+        plugins: any[];
+    };
+    'postcss-url': {
+        url: string;
+    };
+    'postcss-custom-media': {
+        importFrom: string;
+    };
+    'postcss-color-mod-function': {
+        unresolved: string;
+    };
+};

package/build/configs/postcss.d.ts

@@ -0,0 +1,2 @@
+declare const postcssConfig: any[];
+export default postcssConfig;

package/build/configs/stats-options.d.ts

@@ -0,0 +1,3 @@
+import type { WebpackOptionsNormalized } from 'webpack';
+declare const statsOptions: WebpackOptionsNormalized['stats'];
+export default statsOptions;

package/build/configs/stats-options.js

@@ -29,8 +29,6 @@ const statsOptions = apply_overrides_1.default('stats', {
     hash: false,
     // Add built modules information
     modules: true,
-    // Set the maximum number of modules to be shown
-    maxModules: 0,
     // Show dependencies and origin of warnings/errors (since webpack 2.5.0)
     moduleTrace: true,
     // Show performance hint when file size exceeds `performance.maxAssetSize`

package/build/configs/supporting-browsers.d.ts

@@ -0,0 +1,2 @@
+declare const supportingBrowsers: string[];
+export default supportingBrowsers;

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

@@ -0,0 +1,37 @@
+import type { Configuration as WebpackConfiguration, WebpackOptionsNormalized } from 'webpack';
+import type { Configuration as WebpackDevServerConfiguration } from 'webpack-dev-server';
+import { AppConfigs } from '../app-configs/types';
+declare type Overrides = {
+    webpack: WebpackConfiguration;
+    webpackClient: WebpackConfiguration;
+    webpackDev: WebpackConfiguration;
+    webpackClientDev: WebpackConfiguration;
+    webpackServer: WebpackConfiguration;
+    webpackServerDev: WebpackConfiguration;
+    webpackProd: WebpackConfiguration;
+    webpackClientProd: WebpackConfiguration;
+    webpackServerProd: WebpackConfiguration;
+    devServer: WebpackDevServerConfiguration;
+    stats: WebpackOptionsNormalized['stats'];
+    babel: any;
+    babelClient: any;
+    babelServer: any;
+    postcss: any[];
+    browsers: string[];
+    supportingBrowsers: string[];
+    Dockerfile: string;
+    nginx: string;
+    'start.sh': string;
+};
+declare type OverrideFunction<K extends keyof Overrides> = (config: Overrides[K], appConfig: AppConfigs) => Overrides[K];
+export declare type OverrideFile = {
+    [K in keyof Overrides]?: OverrideFunction<K>;
+};
+/**
+ *
+ * @param {String|String[]} overridesKey Ключи оверрайда
+ * @param {Object} config Конфиг, к которому нужно применить оверрайды
+ * @returns {*}
+ */
+declare function applyOverrides<Key extends keyof Overrides>(overridesKey: Key | Key[], config: Overrides[Key]): Overrides[Key];
+export default applyOverrides;

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

@@ -25,11 +25,12 @@ function applyOverrides(overridesKey, config) {
     }
     overridesKey.forEach(key => {
         overrides.forEach((override) => {
+            var _a;
             if (override.hasOwnProperty(key)) {
                 if (typeof override[key] !== 'function') {
                     console.error(`Override ${key} must be a function`);
                 }
-                config = override[key](config, app_configs_1.default);
+                config = (_a = override[key]) === null || _a === void 0 ? void 0 : _a.call(override, config, app_configs_1.default);
             }
         });
     });

package/build/configs/util/check-node-version.d.ts

@@ -0,0 +1,2 @@
+declare function checkNodeVersion(majorVersion: number): boolean;
+export default checkNodeVersion;

package/build/configs/util/get-entry.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @param {string|string[]|object} entryPoint Строка, массив строк или объект с энтрипоинтами
+ * @param {Function} getSingleEntry Функция, возвращающая конфигурацию для одного entryPoint
+ * @returns {*}
+ */
+declare function getEntry(entryPoint: string | string[] | Record<string, string | string[]>, getSingleEntry: (entry: string[]) => string[]): string[] | Record<string, string | string[]>;
+export default getEntry;

package/build/configs/util/get-polyfills.d.ts

@@ -0,0 +1,3 @@
+/// <reference types="node" />
+import { AppConfigs } from '../app-configs/types';
+export declare function getPolyfills(config: AppConfigs, requireResolve?: RequireResolve): string[];

package/build/configs/util/install-sourcemap-support.d.ts

@@ -0,0 +1 @@
+export {};

package/build/configs/util/noop.d.ts

@@ -0,0 +1 @@
+export {};