arui-scripts 0.0.0-beta-20260824133302
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.eslintignore +2 -0
- package/.eslintrc.js +17 -0
- package/.prettierignore +2 -0
- package/.turbo/turbo-build.log +0 -0
- package/.turbo/turbo-test.log +23 -0
- package/CHANGELOG.md +1976 -0
- package/README.md +59 -0
- package/bin/build.sh +2 -0
- package/build/bin/index.d.ts +2 -0
- package/build/bin/index.js +26 -0
- package/build/commands/archive-build/index.d.ts +1 -0
- package/build/commands/archive-build/index.js +15 -0
- package/build/commands/build/build-wrapper.d.ts +8 -0
- package/build/commands/build/build-wrapper.js +40 -0
- package/build/commands/build/client.d.ts +1 -0
- package/build/commands/build/client.js +54 -0
- package/build/commands/build/index.d.ts +1 -0
- package/build/commands/build/index.js +11 -0
- package/build/commands/build/server.d.ts +1 -0
- package/build/commands/build/server.js +29 -0
- package/build/commands/bundle-analyze/index.d.ts +1 -0
- package/build/commands/bundle-analyze/index.js +62 -0
- package/build/commands/changelog/index.d.ts +5 -0
- package/build/commands/changelog/index.js +141 -0
- package/build/commands/docker-build/index.d.ts +1 -0
- package/build/commands/docker-build/index.js +15 -0
- package/build/commands/docker-build-compiled/index.d.ts +1 -0
- package/build/commands/docker-build-compiled/index.js +15 -0
- package/build/commands/ensure-yarn/index.d.ts +1 -0
- package/build/commands/ensure-yarn/index.js +8 -0
- package/build/commands/start/client.d.ts +1 -0
- package/build/commands/start/client.js +7 -0
- package/build/commands/start/index.d.ts +1 -0
- package/build/commands/start/index.js +13 -0
- package/build/commands/start/print-compiler-output.d.ts +2 -0
- package/build/commands/start/print-compiler-output.js +16 -0
- package/build/commands/start/server.d.ts +1 -0
- package/build/commands/start/server.js +7 -0
- package/build/commands/start-prod/client.d.ts +1 -0
- package/build/commands/start-prod/client.js +7 -0
- package/build/commands/start-prod/index.d.ts +1 -0
- package/build/commands/start-prod/index.js +13 -0
- package/build/commands/start-prod/server.d.ts +1 -0
- package/build/commands/start-prod/server.js +7 -0
- package/build/commands/test/get-config.d.ts +1 -0
- package/build/commands/test/get-config.js +83 -0
- package/build/commands/test/index.d.ts +1 -0
- package/build/commands/test/index.js +68 -0
- package/build/commands/test-vitest/index.d.ts +1 -0
- package/build/commands/test-vitest/index.js +15 -0
- package/build/commands/util/artifacts-config.d.ts +25 -0
- package/build/commands/util/artifacts-config.js +119 -0
- package/build/commands/util/artifacts-deprecations.d.ts +9 -0
- package/build/commands/util/artifacts-deprecations.js +65 -0
- package/build/commands/util/arui-scripts-artifacts.d.ts +16 -0
- package/build/commands/util/arui-scripts-artifacts.js +29 -0
- package/build/commands/util/client-assets-sizes.d.ts +2 -0
- package/build/commands/util/client-assets-sizes.js +71 -0
- package/build/commands/util/docker-build.d.ts +35 -0
- package/build/commands/util/docker-build.js +76 -0
- package/build/commands/util/exec.d.ts +1 -0
- package/build/commands/util/exec.js +6 -0
- package/build/commands/util/format-webpack-messages.d.ts +5 -0
- package/build/commands/util/format-webpack-messages.js +95 -0
- package/build/commands/util/get-local-ident.d.ts +6 -0
- package/build/commands/util/get-local-ident.js +29 -0
- package/build/commands/util/load-browserslist.d.ts +1 -0
- package/build/commands/util/load-browserslist.js +15 -0
- package/build/commands/util/make-tmp-dir.d.ts +5 -0
- package/build/commands/util/make-tmp-dir.js +29 -0
- package/build/commands/util/print-build-error.d.ts +1 -0
- package/build/commands/util/print-build-error.js +32 -0
- package/build/commands/util/run-artifacts-cli.d.ts +7 -0
- package/build/commands/util/run-artifacts-cli.js +60 -0
- package/build/commands/util/run-client-dev-server.d.ts +2 -0
- package/build/commands/util/run-client-dev-server.js +47 -0
- package/build/commands/util/run-compilers.d.ts +1 -0
- package/build/commands/util/run-compilers.js +37 -0
- package/build/commands/util/run-server-watch-compiler.d.ts +2 -0
- package/build/commands/util/run-server-watch-compiler.js +17 -0
- package/build/commands/util/run-vitest.d.ts +7 -0
- package/build/commands/util/run-vitest.js +41 -0
- package/build/commands/util/tsc.d.ts +1 -0
- package/build/commands/util/tsc.js +13 -0
- package/build/commands/util/yarn.d.ts +10 -0
- package/build/commands/util/yarn.js +25 -0
- package/build/configs/app-configs/calculate-dependent-config.d.ts +9 -0
- package/build/configs/app-configs/calculate-dependent-config.js +55 -0
- package/build/configs/app-configs/get-defaults.d.ts +5 -0
- package/build/configs/app-configs/get-defaults.js +151 -0
- package/build/configs/app-configs/index.d.ts +5 -0
- package/build/configs/app-configs/index.js +25 -0
- package/build/configs/app-configs/read-config-file.d.ts +2 -0
- package/build/configs/app-configs/read-config-file.js +28 -0
- package/build/configs/app-configs/types.d.ts +146 -0
- package/build/configs/app-configs/types.js +2 -0
- package/build/configs/app-configs/update-with-config-file.d.ts +2 -0
- package/build/configs/app-configs/update-with-config-file.js +17 -0
- package/build/configs/app-configs/update-with-env.d.ts +2 -0
- package/build/configs/app-configs/update-with-env.js +23 -0
- package/build/configs/app-configs/update-with-package.d.ts +2 -0
- package/build/configs/app-configs/update-with-package.js +13 -0
- package/build/configs/app-configs/update-with-presets.d.ts +3 -0
- package/build/configs/app-configs/update-with-presets.js +41 -0
- package/build/configs/app-configs/validate-config.d.ts +2 -0
- package/build/configs/app-configs/validate-config.js +8 -0
- package/build/configs/app-configs/validate-settings-keys.d.ts +7 -0
- package/build/configs/app-configs/validate-settings-keys.js +16 -0
- package/build/configs/app-configs/warn-about-deprecations.d.ts +2 -0
- package/build/configs/app-configs/warn-about-deprecations.js +22 -0
- package/build/configs/babel-client.d.ts +31 -0
- package/build/configs/babel-client.js +69 -0
- package/build/configs/babel-dependencies.d.ts +14 -0
- package/build/configs/babel-dependencies.js +36 -0
- package/build/configs/babel-server.d.ts +26 -0
- package/build/configs/babel-server.js +45 -0
- package/build/configs/client-env-config/add-env-to-html-template.d.ts +1 -0
- package/build/configs/client-env-config/add-env-to-html-template.js +7 -0
- package/build/configs/client-env-config/client-config-plugin.d.ts +5 -0
- package/build/configs/client-env-config/client-config-plugin.js +26 -0
- package/build/configs/client-env-config/constants.d.ts +1 -0
- package/build/configs/client-env-config/constants.js +4 -0
- package/build/configs/client-env-config/get-env-config.d.ts +2 -0
- package/build/configs/client-env-config/get-env-config.js +28 -0
- package/build/configs/client-env-config/index.d.ts +3 -0
- package/build/configs/client-env-config/index.js +9 -0
- package/build/configs/config-extras/minimizers/imagemin/imagemin.d.ts +28 -0
- package/build/configs/config-extras/minimizers/imagemin/imagemin.js +65 -0
- package/build/configs/config-extras/minimizers/imagemin/index.d.ts +1 -0
- package/build/configs/config-extras/minimizers/imagemin/index.js +17 -0
- package/build/configs/config-extras/minimizers/index.d.ts +1 -0
- package/build/configs/config-extras/minimizers/index.js +17 -0
- package/build/configs/dev-server.d.ts +2 -0
- package/build/configs/dev-server.js +78 -0
- package/build/configs/jest/babel-transform.d.ts +2 -0
- package/build/configs/jest/babel-transform.js +6 -0
- package/build/configs/jest/css-mock.d.ts +1 -0
- package/build/configs/jest/css-mock.js +2 -0
- package/build/configs/jest/file-transform.d.ts +3 -0
- package/build/configs/jest/file-transform.js +11 -0
- package/build/configs/jest/settings.d.ts +21 -0
- package/build/configs/jest/settings.js +58 -0
- package/build/configs/modules.d.ts +17 -0
- package/build/configs/modules.js +181 -0
- package/build/configs/mq.css +22 -0
- package/build/configs/postcss.config.d.ts +35 -0
- package/build/configs/postcss.config.js +65 -0
- package/build/configs/postcss.d.ts +6 -0
- package/build/configs/postcss.js +21 -0
- package/build/configs/process-assets-plugin-output.d.ts +2 -0
- package/build/configs/process-assets-plugin-output.js +45 -0
- package/build/configs/server-externals-exemptions.d.ts +1 -0
- package/build/configs/server-externals-exemptions.js +18 -0
- package/build/configs/stats-options.d.ts +2 -0
- package/build/configs/stats-options.js +46 -0
- package/build/configs/supporting-browsers.d.ts +1 -0
- package/build/configs/supporting-browsers.js +5 -0
- package/build/configs/supporting-node.d.ts +1 -0
- package/build/configs/supporting-node.js +5 -0
- package/build/configs/swc.d.ts +4 -0
- package/build/configs/swc.js +30 -0
- package/build/configs/util/apply-overrides.d.ts +87 -0
- package/build/configs/util/apply-overrides.js +56 -0
- package/build/configs/util/check-node-version.d.ts +1 -0
- package/build/configs/util/check-node-version.js +7 -0
- package/build/configs/util/compress-with-dcb.d.ts +2 -0
- package/build/configs/util/compress-with-dcb.js +28 -0
- package/build/configs/util/compression-plugins-for-dictionaries.d.ts +2 -0
- package/build/configs/util/compression-plugins-for-dictionaries.js +78 -0
- package/build/configs/util/create-watch-ignore-regex.d.ts +1 -0
- package/build/configs/util/create-watch-ignore-regex.js +16 -0
- package/build/configs/util/dcb-compression-plugin.d.ts +21 -0
- package/build/configs/util/dcb-compression-plugin.js +130 -0
- package/build/configs/util/find-loader.d.ts +2 -0
- package/build/configs/util/find-loader.js +24 -0
- package/build/configs/util/find-plugin.d.ts +78 -0
- package/build/configs/util/find-plugin.js +21 -0
- package/build/configs/util/get-entry.d.ts +8 -0
- package/build/configs/util/get-entry.js +22 -0
- package/build/configs/util/get-polyfills.d.ts +2 -0
- package/build/configs/util/get-polyfills.js +13 -0
- package/build/configs/util/get-webpack-cache-dependencies.d.ts +1 -0
- package/build/configs/util/get-webpack-cache-dependencies.js +15 -0
- package/build/configs/util/install-sourcemap-support.d.ts +1 -0
- package/build/configs/util/install-sourcemap-support.js +10 -0
- package/build/configs/util/node-assets-ignore.d.ts +1 -0
- package/build/configs/util/node-assets-ignore.js +34 -0
- package/build/configs/util/noop.d.ts +1 -0
- package/build/configs/util/noop.js +2 -0
- package/build/configs/util/register-ts-node.d.ts +1 -0
- package/build/configs/util/register-ts-node.js +18 -0
- package/build/configs/util/resolve.d.ts +14 -0
- package/build/configs/util/resolve.js +29 -0
- package/build/configs/vitest/config.d.ts +2 -0
- package/build/configs/vitest/config.js +5 -0
- package/build/configs/vitest/settings.d.ts +30 -0
- package/build/configs/vitest/settings.js +77 -0
- package/build/configs/webpack.client.d.ts +10 -0
- package/build/configs/webpack.client.dev.d.ts +1 -0
- package/build/configs/webpack.client.dev.js +12 -0
- package/build/configs/webpack.client.js +508 -0
- package/build/configs/webpack.client.prod.d.ts +1 -0
- package/build/configs/webpack.client.prod.js +12 -0
- package/build/configs/webpack.server.d.ts +2 -0
- package/build/configs/webpack.server.dev.d.ts +1 -0
- package/build/configs/webpack.server.dev.js +8 -0
- package/build/configs/webpack.server.js +283 -0
- package/build/configs/webpack.server.prod.d.ts +1 -0
- package/build/configs/webpack.server.prod.js +8 -0
- package/build/index.d.ts +19 -0
- package/build/index.js +35 -0
- package/build/plugins/arui-runtime/arui-runtime-module.d.ts +7 -0
- package/build/plugins/arui-runtime/arui-runtime-module.js +20 -0
- package/build/plugins/arui-runtime/index.d.ts +11 -0
- package/build/plugins/arui-runtime/index.js +47 -0
- package/build/plugins/postcss-global-variables/postcss-global-variables.d.ts +6 -0
- package/build/plugins/postcss-global-variables/postcss-global-variables.js +38 -0
- package/build/plugins/postcss-global-variables/utils/utils.d.ts +7 -0
- package/build/plugins/postcss-global-variables/utils/utils.js +91 -0
- package/build/plugins/postcss-prefix-selector.d.ts +6 -0
- package/build/plugins/postcss-prefix-selector.js +65 -0
- package/build/plugins/reload-server-plugin.d.ts +10 -0
- package/build/plugins/reload-server-plugin.js +46 -0
- package/build/plugins/turn-off-split-remote-entry.d.ts +11 -0
- package/build/plugins/turn-off-split-remote-entry.js +71 -0
- package/build/plugins/watch-missing-node-modules-plugin.d.ts +6 -0
- package/build/plugins/watch-missing-node-modules-plugin.js +20 -0
- package/build/templates/html.template.d.ts +1 -0
- package/build/templates/html.template.js +22 -0
- package/docs/artifact.md +62 -0
- package/docs/caveats.md +41 -0
- package/docs/client-only.md +77 -0
- package/docs/commands.md +159 -0
- package/docs/compilers.md +18 -0
- package/docs/compression-dictionary.md +130 -0
- package/docs/examples.md +100 -0
- package/docs/modules.md +834 -0
- package/docs/overrides.md +175 -0
- package/docs/presets.md +65 -0
- package/docs/settings.md +336 -0
- package/jest-preset.js +5 -0
- package/package.json +215 -0
- package/stylelint.config.js +11 -0
- package/tsconfig-local.json +17 -0
- package/tsconfig-local.tsbuildinfo +1 -0
- package/tsconfig.eslint.json +5 -0
- package/tsconfig.json +29 -0
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.postCssPrefix = void 0;
|
|
4
|
+
const VisitedRule = Symbol('VisitedRule');
|
|
5
|
+
const ROOT_SELECTOR = ':root';
|
|
6
|
+
const KEYFRAME_RULES = ['keyframes', '-webkit-keyframes', '-moz-keyframes', '-o-keyframes'];
|
|
7
|
+
const postCssPrefix = (options) => {
|
|
8
|
+
const prefix = (options === null || options === void 0 ? void 0 : options.prefix) || '.prefix ';
|
|
9
|
+
return {
|
|
10
|
+
postcssPlugin: '@alfalab/postcss-prefix-selector',
|
|
11
|
+
/* eslint-disable no-param-reassign */
|
|
12
|
+
RootExit(root) {
|
|
13
|
+
if (root[VisitedRule]) {
|
|
14
|
+
return;
|
|
15
|
+
}
|
|
16
|
+
root[VisitedRule] = true;
|
|
17
|
+
root.walkRules((rule) => {
|
|
18
|
+
const hasParent = !!rule.parent;
|
|
19
|
+
const parentIsAtRule = rule.parent && rule.parent.type === 'atrule';
|
|
20
|
+
const parentIsKeyframe = parentIsAtRule &&
|
|
21
|
+
KEYFRAME_RULES.includes(rule.parent.name);
|
|
22
|
+
if (hasParent && parentIsKeyframe) {
|
|
23
|
+
// Нам не нужно добавлять префиксы для keyframes и элементов внутри них
|
|
24
|
+
return;
|
|
25
|
+
}
|
|
26
|
+
rule[VisitedRule] = true;
|
|
27
|
+
if (isAnyParentVisited(rule)) {
|
|
28
|
+
// если хотя бы один из родителей (кроме root) был посещен, то не добавляем префикс
|
|
29
|
+
return;
|
|
30
|
+
}
|
|
31
|
+
rule.selectors = rule.selectors.map((selector) => {
|
|
32
|
+
/**
|
|
33
|
+
* Оборачивам только самим префиксом без :root.
|
|
34
|
+
* Позволяет инкапсулировать css переменные под классом.
|
|
35
|
+
* В таком случае они будут доступны в модулях приложений после использования флага keepCssVars.
|
|
36
|
+
*/
|
|
37
|
+
if (selector === ROOT_SELECTOR) {
|
|
38
|
+
return prefix;
|
|
39
|
+
}
|
|
40
|
+
return `${prefix}${selector}`;
|
|
41
|
+
});
|
|
42
|
+
});
|
|
43
|
+
},
|
|
44
|
+
/* eslint-enable no-param-reassign */
|
|
45
|
+
};
|
|
46
|
+
};
|
|
47
|
+
exports.postCssPrefix = postCssPrefix;
|
|
48
|
+
/**
|
|
49
|
+
* Проверяет, что хотя бы один из родителей был посещен. Если посещен Root элемент, то возвращает false
|
|
50
|
+
* @param rule
|
|
51
|
+
*/
|
|
52
|
+
function isAnyParentVisited(rule) {
|
|
53
|
+
let { parent } = rule;
|
|
54
|
+
while (parent) {
|
|
55
|
+
if (!parent.parent) {
|
|
56
|
+
return false;
|
|
57
|
+
}
|
|
58
|
+
if (parent[VisitedRule]) {
|
|
59
|
+
return true;
|
|
60
|
+
}
|
|
61
|
+
parent = parent.parent;
|
|
62
|
+
}
|
|
63
|
+
return false;
|
|
64
|
+
}
|
|
65
|
+
postCssPrefix.postcss = true;
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import { type Worker } from 'cluster';
|
|
2
|
+
import { type Compiler } from 'webpack';
|
|
3
|
+
export declare class ReloadServerPlugin {
|
|
4
|
+
workers: Worker[];
|
|
5
|
+
done: null | (() => void);
|
|
6
|
+
constructor({ script }?: {
|
|
7
|
+
script: string;
|
|
8
|
+
});
|
|
9
|
+
apply(compiler: Compiler): void;
|
|
10
|
+
}
|
|
@@ -0,0 +1,46 @@
|
|
|
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.ReloadServerPlugin = void 0;
|
|
7
|
+
const cluster_1 = __importDefault(require("cluster"));
|
|
8
|
+
const path_1 = __importDefault(require("path"));
|
|
9
|
+
const defaultOptions = {
|
|
10
|
+
script: 'server.js',
|
|
11
|
+
};
|
|
12
|
+
class ReloadServerPlugin {
|
|
13
|
+
constructor({ script } = defaultOptions) {
|
|
14
|
+
this.workers = [];
|
|
15
|
+
this.done = null;
|
|
16
|
+
this.done = null;
|
|
17
|
+
this.workers = [];
|
|
18
|
+
cluster_1.default.setupMaster({
|
|
19
|
+
exec: path_1.default.resolve(process.cwd(), script),
|
|
20
|
+
});
|
|
21
|
+
cluster_1.default.on('online', (worker) => {
|
|
22
|
+
this.workers.push(worker);
|
|
23
|
+
if (this.done) {
|
|
24
|
+
this.done();
|
|
25
|
+
}
|
|
26
|
+
});
|
|
27
|
+
}
|
|
28
|
+
apply(compiler) {
|
|
29
|
+
compiler.hooks.afterEmit.tapAsync('ReloadServerPlugin', (compilation, callback) => {
|
|
30
|
+
this.done = callback;
|
|
31
|
+
this.workers.forEach((worker) => {
|
|
32
|
+
try {
|
|
33
|
+
if (worker.process.pid) {
|
|
34
|
+
process.kill(worker.process.pid, 'SIGTERM');
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
catch (e) {
|
|
38
|
+
console.warn(`Unable to kill process #${worker.process.pid}`);
|
|
39
|
+
}
|
|
40
|
+
});
|
|
41
|
+
this.workers = [];
|
|
42
|
+
cluster_1.default.fork();
|
|
43
|
+
});
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
exports.ReloadServerPlugin = ReloadServerPlugin;
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import { type Compiler, type RspackPluginInstance } from '@rspack/core';
|
|
2
|
+
/**
|
|
3
|
+
* Force remote entry not be affected by user's chunkSplit strategy,
|
|
4
|
+
* Otherwise, the remote chunk will not be loaded correctly.
|
|
5
|
+
* @see https://github.com/web-infra-dev/rsbuild/discussions/1461#discussioncomment-8329790
|
|
6
|
+
*/
|
|
7
|
+
export declare class TurnOffSplitRemoteEntry implements RspackPluginInstance {
|
|
8
|
+
name: string;
|
|
9
|
+
constructor(wmfContainerName: string);
|
|
10
|
+
apply(compiler: Compiler): void;
|
|
11
|
+
}
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.TurnOffSplitRemoteEntry = void 0;
|
|
4
|
+
const util_1 = require("util");
|
|
5
|
+
/**
|
|
6
|
+
* Force remote entry not be affected by user's chunkSplit strategy,
|
|
7
|
+
* Otherwise, the remote chunk will not be loaded correctly.
|
|
8
|
+
* @see https://github.com/web-infra-dev/rsbuild/discussions/1461#discussioncomment-8329790
|
|
9
|
+
*/
|
|
10
|
+
class TurnOffSplitRemoteEntry {
|
|
11
|
+
constructor(wmfContainerName) {
|
|
12
|
+
this.name = wmfContainerName;
|
|
13
|
+
}
|
|
14
|
+
apply(compiler) {
|
|
15
|
+
const { splitChunks } = compiler.options.optimization;
|
|
16
|
+
if (!splitChunks) {
|
|
17
|
+
return;
|
|
18
|
+
}
|
|
19
|
+
/* eslint-disable no-param-reassign */
|
|
20
|
+
const applyPatch = (cacheGroup) => {
|
|
21
|
+
if (typeof cacheGroup !== 'object' || util_1.types.isRegExp(cacheGroup)) {
|
|
22
|
+
return;
|
|
23
|
+
}
|
|
24
|
+
// cacheGroup.chunks will inherit splitChunks.chunks
|
|
25
|
+
// so we only need to modify the chunks that are set separately.
|
|
26
|
+
const { chunks } = cacheGroup;
|
|
27
|
+
if (!chunks || chunks === 'async') {
|
|
28
|
+
return;
|
|
29
|
+
}
|
|
30
|
+
if (typeof chunks === 'function') {
|
|
31
|
+
const prevChunks = chunks;
|
|
32
|
+
cacheGroup.chunks = (chunk) => {
|
|
33
|
+
if (chunk.name && chunk.name === this.name) {
|
|
34
|
+
return false;
|
|
35
|
+
}
|
|
36
|
+
return prevChunks(chunk);
|
|
37
|
+
};
|
|
38
|
+
return;
|
|
39
|
+
}
|
|
40
|
+
if (chunks === 'all') {
|
|
41
|
+
cacheGroup.chunks = (chunk) => {
|
|
42
|
+
if (chunk.name && chunk.name === this.name) {
|
|
43
|
+
return false;
|
|
44
|
+
}
|
|
45
|
+
return true;
|
|
46
|
+
};
|
|
47
|
+
return;
|
|
48
|
+
}
|
|
49
|
+
if (chunks === 'initial') {
|
|
50
|
+
cacheGroup.chunks = (chunk) => {
|
|
51
|
+
if (chunk.name && chunk.name === this.name) {
|
|
52
|
+
return false;
|
|
53
|
+
}
|
|
54
|
+
return chunk.isOnlyInitial();
|
|
55
|
+
};
|
|
56
|
+
}
|
|
57
|
+
};
|
|
58
|
+
/* eslint-enable no-param-reassign */
|
|
59
|
+
// patch splitChunk.chunks
|
|
60
|
+
applyPatch(splitChunks);
|
|
61
|
+
const { cacheGroups } = splitChunks;
|
|
62
|
+
if (!cacheGroups) {
|
|
63
|
+
return;
|
|
64
|
+
}
|
|
65
|
+
// patch splitChunk.cacheGroups[key].chunks
|
|
66
|
+
for (const cacheGroupKey of Object.keys(cacheGroups)) {
|
|
67
|
+
applyPatch(cacheGroups[cacheGroupKey]);
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
exports.TurnOffSplitRemoteEntry = TurnOffSplitRemoteEntry;
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.WatchMissingNodeModulesPlugin = void 0;
|
|
4
|
+
class WatchMissingNodeModulesPlugin {
|
|
5
|
+
constructor(nodeModulesPath) {
|
|
6
|
+
this.nodeModulesPath = nodeModulesPath;
|
|
7
|
+
}
|
|
8
|
+
apply(compiler) {
|
|
9
|
+
compiler.hooks.emit.tap('WatchMissingNodeModulesPlugin', (compilation) => {
|
|
10
|
+
const missingDeps = Array.from(compilation.missingDependencies);
|
|
11
|
+
const { nodeModulesPath } = this;
|
|
12
|
+
// If any missing files are expected to appear in node_modules...
|
|
13
|
+
if (missingDeps.some((file) => file.includes(nodeModulesPath))) {
|
|
14
|
+
// ...tell webpack to watch node_modules recursively until they appear.
|
|
15
|
+
compilation.contextDependencies.add(nodeModulesPath);
|
|
16
|
+
}
|
|
17
|
+
});
|
|
18
|
+
}
|
|
19
|
+
}
|
|
20
|
+
exports.WatchMissingNodeModulesPlugin = WatchMissingNodeModulesPlugin;
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export declare const htmlTemplate = "<!doctype html>\n<html lang=\"ru\">\n <head>\n <meta charset=\"utf-8\" />\n <title>React-app</title>\n <link\n rel=\"shortcut icon\"\n href=\"data:image/svg+xml,%3Csvg viewBox='0 0 100 100' xmlns='http://www.w3.org/2000/svg'%3E%3Ccircle cx='50' cy='50' r='50' fill='%23EF3124' /%3E%3C/svg%3E\"\n >\n </head>\n <body>\n <div id=\"react-app\"></div>\n <script id=\"env-settings\" type=\"application/json\">\n <%= envConfig %>\n </script>\n </body>\n</html>";
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.htmlTemplate = void 0;
|
|
4
|
+
const apply_overrides_1 = require("../configs/util/apply-overrides");
|
|
5
|
+
const template = `<!doctype html>
|
|
6
|
+
<html lang="ru">
|
|
7
|
+
<head>
|
|
8
|
+
<meta charset="utf-8" />
|
|
9
|
+
<title>React-app</title>
|
|
10
|
+
<link
|
|
11
|
+
rel="shortcut icon"
|
|
12
|
+
href="data:image/svg+xml,%3Csvg viewBox='0 0 100 100' xmlns='http://www.w3.org/2000/svg'%3E%3Ccircle cx='50' cy='50' r='50' fill='%23EF3124' /%3E%3C/svg%3E"
|
|
13
|
+
>
|
|
14
|
+
</head>
|
|
15
|
+
<body>
|
|
16
|
+
<div id="react-app"></div>
|
|
17
|
+
<script id="env-settings" type="application/json">
|
|
18
|
+
<%= envConfig %>
|
|
19
|
+
</script>
|
|
20
|
+
</body>
|
|
21
|
+
</html>`;
|
|
22
|
+
exports.htmlTemplate = (0, apply_overrides_1.applyOverrides)('html', template);
|
package/docs/artifact.md
ADDED
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
Настройки сборки артефакта
|
|
2
|
+
===
|
|
3
|
+
|
|
4
|
+
> ⚠️ Сборка артефактов живет в отдельном пакете [@alfalab/arui-scripts-artifacts](../../arui-scripts-artifacts/README.md).
|
|
5
|
+
> Настройки и оверрайды артефакта в конфиге arui-scripts объявлены устаревшими и будут удалены в
|
|
6
|
+
> следующей мажорной версии — новые проекты настраивают сборку через `arui-scripts-artifacts.ts`.
|
|
7
|
+
|
|
8
|
+
## docker
|
|
9
|
+
|
|
10
|
+
По-умолчанию, базовым образом для сборки артефакта является [alpine-node-nginx](../../alpine-node-nginx).
|
|
11
|
+
|
|
12
|
+
На `8080` порту будет поднят nginx, который будет раздавать статику и проксировать все остальные запросы к `nodejs`.
|
|
13
|
+
|
|
14
|
+
Вы также можете переопределить полностью процесс сборки docker-образа используя механизм [overrides](#тонкая-настройка)
|
|
15
|
+
или создав в корневой директории проекта `Dockerfile` содержащий необходимый набор инструкций.
|
|
16
|
+
Пример [Dockerfile](../../arui-scripts-artifacts/src/docker/templates/dockerfile.template.ts).
|
|
17
|
+
|
|
18
|
+
`Dockerfile` в корне проекта имеет приоритет над overrides.
|
|
19
|
+
|
|
20
|
+
Чтобы переопределить скрипт запуска, воспользуйтесь механизмом [overrides](#тонкая-настройка)
|
|
21
|
+
или создайте в корневой директории проекта `start.sh` файл содержащий необходимый набор инструкций.
|
|
22
|
+
Пример [start.sh](../../arui-scripts-artifacts/src/start-script/start.template.ts).
|
|
23
|
+
|
|
24
|
+
`start.sh` в корне проекта имеет приоритет над overrides.
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
## Концигурация nginx
|
|
28
|
+
Несмотря на то, что nginx имеет готовый конфиг с роутингом, иногда возникает необходимость добавлять свои роуты.
|
|
29
|
+
Вы можете использовать механизм [overrides](overrides.md).
|
|
30
|
+
Так же вы можете создать `nginx.conf` на уровне проекта со своими роутами. Пример конфига [тут](../../arui-scripts-artifacts/src/nginx/templates/nginx.conf.template.ts).
|
|
31
|
+
Файл nginx.conf имеет приоритет над оверрайдами.
|
|
32
|
+
|
|
33
|
+
### Использование env переменных в nginx.conf
|
|
34
|
+
|
|
35
|
+
Иногда у вас может возникнуть потребность переопределять какие-то из настроек nginx в зависимости
|
|
36
|
+
от среды, на которой запущен контейнер. Это можно сделать задав свой `nginx.conf` и передав ENV переменные
|
|
37
|
+
в контейнер. По умолчанию конфигурация nginx прогоняется при старте
|
|
38
|
+
через [envsubst](https://www.gnu.org/software/gettext/manual/html_node/envsubst-Invocation.html).
|
|
39
|
+
|
|
40
|
+
Если вы используете свой базовый docker-образ для работы приложения - убедитесь что в нем доступен `envsubst`.
|
|
41
|
+
Для alpine он является частью пакета [`gettext`](https://pkgs.alpinelinux.org/contents?branch=edge&name=gettext&arch=x86&repo=main)
|
|
42
|
+
|
|
43
|
+
**Важно**. Для того чтобы сохранить нормальную работу специальных переменных nginx, типа `$proxy_add_x_forwarded_for`
|
|
44
|
+
перед запуском envsubst они будут заменены на `~~proxy_add_x_forwarded_for~~`, а затем возвращены в исходный вид.
|
|
45
|
+
envsubst будет заменять переменные записанные **только** как `${MY_VAR}`.
|
|
46
|
+
|
|
47
|
+
|
|
48
|
+
Вы можете использовать это так:
|
|
49
|
+
|
|
50
|
+
```nginx.conf
|
|
51
|
+
server {
|
|
52
|
+
listen 8080;
|
|
53
|
+
server_name ${SERVICE_NAME};
|
|
54
|
+
...
|
|
55
|
+
}
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
```shell
|
|
59
|
+
docker run my-awesome-app --env SERVICE_NAME=my-app
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
После запуска nginx будет иметь server_name `my-app`.
|
package/docs/caveats.md
ADDED
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
Особенности поведения
|
|
2
|
+
===
|
|
3
|
+
|
|
4
|
+
## node-externals
|
|
5
|
+
|
|
6
|
+
Сборка серверной части устроена таким образом, что большая часть `node_modules` не попадает в сборку (в файл `.build/server.js`),
|
|
7
|
+
а загружается стандартным `require` node.js.
|
|
8
|
+
Основной мотивацией для это являются многие старые пакеты, которые делают "странные" вещи с require - например, пытаются
|
|
9
|
+
подключать файлы динамически, используют `require.extensions` и т.д. Это может приводить к ошибкам сборки или даже к
|
|
10
|
+
ошибкам во время выполнения.
|
|
11
|
+
|
|
12
|
+
Но в случае react-компонентов, мы зачастую запрашиваем кроме кода компонентов еще и `.css`, `.png` и другие файлы.
|
|
13
|
+
`require` из node.js на таких местах ломается. Поэтому наши внутренние библиотеки компонентов все же должны попадать в
|
|
14
|
+
собранный файл `.build/server.js`. Всё это сделано с помощью [добавления их в исключение](src/configs/webpack.server.dev.ts#L59)
|
|
15
|
+
плагина [webpack-node-externals](https://www.npmjs.com/package/webpack-node-externals).
|
|
16
|
+
В случае, если вам необходима обработка не-js файлов из других внешних модулей - вы можете
|
|
17
|
+
воспользоваться механизмом `overrides`, и ключом `serverExternalsExemptions`.
|
|
18
|
+
По умолчанию же все не-js файлы из внешних модулей будут проигнорированы.
|
|
19
|
+
|
|
20
|
+
## Кеширование сборки
|
|
21
|
+
В dev сборке для сервера и клиента настроено кеширование. Оно должно нормально работать когда вы просто работаете
|
|
22
|
+
над проектом - меняете ваш код, ставите новые зависимости и тд.
|
|
23
|
+
|
|
24
|
+
Но когда вы руками меняете код внутри node_modules - вы не сможете увидеть ваши изменения, так как rspack будет
|
|
25
|
+
использовать данные из кеша. Для того чтобы ваши изменения применились в сборке вам необходимо очистить кеш
|
|
26
|
+
rspack и перезапустить сборку. Кеши хранятся в папке `.cache` внутри `node_modules` вашего проекта.
|
|
27
|
+
|
|
28
|
+
```
|
|
29
|
+
rm -rf ./node_modules/.cache
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
## Использование NODE_ENV
|
|
33
|
+
arui-scripts в билд режиме ВСЕГДА будет ставить `NODE_ENV=production` для того, чтобы удалить из сборки дев код.
|
|
34
|
+
|
|
35
|
+
Переменную `process.env.NODE_ENV` используют многие библиотеки для того, чтобы показывать дополнительные варнинги,
|
|
36
|
+
добавлять дополнительные проверки, измерять производительность и так далее. Например `StrictMode` в react при NODE_ENV,
|
|
37
|
+
отличном от `produciton` будет делать дополнительные рендеры ваших компонентов, вызывать `useEffect` по два раза и [другие вещи](https://react.dev/reference/react/StrictMode).
|
|
38
|
+
|
|
39
|
+
Ваш интеграционный стенд и прод должны иметь ОДИНАКОВЫЙ код, который ведет себя схожим образом в одних и тех же ситуациях.
|
|
40
|
+
Если вы хотите делать различия между двумя разными стендами - используйте свою env переменную.
|
|
41
|
+
Договоритесь о том, как она должна называться. Это может быть что угодно другое кроме `NODE_ENV` - `ENV_NAME`, `ALFA_ENV`, ...
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
## Режим clientOnly
|
|
2
|
+
Если на вашем проекте не требуется иметь nodejs-сервер, то clientOnly режим работы - для вас.
|
|
3
|
+
|
|
4
|
+
Он полностью отключает сборку сервера, добавляет [HtmlWebpackPlugin](https://webpack.js.org/plugins/html-webpack-plugin/) для генерации
|
|
5
|
+
простой html, а так же значительно упрощает докер-контейнер, собираемый в качестве артефакта.
|
|
6
|
+
|
|
7
|
+
По-умолчанию html, создаваемый скриптами будет иметь div с id `react-app`, подключенные скрипты, а так же специальный тег `<script>` для работы с конфигурацией.
|
|
8
|
+
Вы можете модифицировать этот html используя [механизм оверрайдов](./overrides.md).
|
|
9
|
+
|
|
10
|
+
docker-контейнер, формируемый командой [arui-scripts docker-build](./commands.md#docker-build) будет содержать
|
|
11
|
+
только собранные файлы. node_modules, все что лежит в вашем `src` и других папках проекта будет игнорироваться.
|
|
12
|
+
|
|
13
|
+
### Работа с конфигурацией
|
|
14
|
+
Поскольку в client-only режиме нет никакого сервера - возникает вопрос как получать хоть какую то конфигурацию, которая
|
|
15
|
+
будет различаться для разных сред.
|
|
16
|
+
|
|
17
|
+
Для этого для client-only режима arui-scripts предоставляет механизм env-config.
|
|
18
|
+
|
|
19
|
+
**Помните - такая конфигурация будет доступна любому пользователю - она не должна содержать приватных данных и секретных ключей.**
|
|
20
|
+
|
|
21
|
+
Он позволяет вам создать json-шаблон, который будет наполняться данными из env-переменных.
|
|
22
|
+
|
|
23
|
+
В качестве шаблона используется файл `env-config.json` из root папки вашего проекта. Все вхождения `${NAME}` в нем
|
|
24
|
+
будут заменены на значения из env-переменных, а сам файл станет доступен по адресу `/env-config.json`.
|
|
25
|
+
|
|
26
|
+
Этот же шаблон будет встроен в `index.html` проекта на место, помеченное как `<%= envConfig %>`. В шаблоне для html
|
|
27
|
+
по-умолчанию он добавляется в тег `<script id="env-settings" type="application/json">`.
|
|
28
|
+
Таким образом вы можете получить те же настройки без дополнительных запросов: `JSON.parse(document.getElementById('env-settings').innerText)`.
|
|
29
|
+
|
|
30
|
+
В дев-режиме env переменные берутся из того окружения, в котором запущен dev-server.
|
|
31
|
+
Собранное приложение будет получать настройки только при запуске докер-контейнера - скрипт `start.sh` обработает все шаблоны таким же образом, как и dev-сервер.
|
|
32
|
+
|
|
33
|
+
**Пример:**
|
|
34
|
+
|
|
35
|
+
Содержимое `/env-config.json` вашего проекта:
|
|
36
|
+
```json
|
|
37
|
+
{
|
|
38
|
+
"backendUrl": "${BACKEND_URL}",
|
|
39
|
+
"staticData": "something very important",
|
|
40
|
+
"unknownEnv": "${UNKNOWN_ENV}"
|
|
41
|
+
}
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
Пример запуска в dev-режиме:
|
|
45
|
+
```shell
|
|
46
|
+
BACKEND_URL=http://example.com yarn arui-scripts start
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
Пример запуска собранного docker-контейнера:
|
|
50
|
+
```shell
|
|
51
|
+
docker run --env BACKEND_URL=http://example.com -p 8080:8080 example:1.1.42 /src/start.sh
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
В обоих случаях по адресу http://localhost:8080/env-config.json будет такое содержимое:
|
|
55
|
+
```json
|
|
56
|
+
{
|
|
57
|
+
"backendUrl": "http://example.com",
|
|
58
|
+
"staticData": "something very important",
|
|
59
|
+
"unknownEnv": ""
|
|
60
|
+
}
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
С дефолтным html-шаблоном index.html будет выглядеть так:
|
|
64
|
+
```html
|
|
65
|
+
<!doctype html>
|
|
66
|
+
<html lang="ru">
|
|
67
|
+
<div id="react-app"></div>
|
|
68
|
+
<script id="env-settings" type="application/json">
|
|
69
|
+
{
|
|
70
|
+
"backendUrl": "http://example.com",
|
|
71
|
+
"staticData": "something very important",
|
|
72
|
+
"unknownEnv": ""
|
|
73
|
+
}
|
|
74
|
+
</script>
|
|
75
|
+
</body>
|
|
76
|
+
</html>
|
|
77
|
+
```
|
package/docs/commands.md
ADDED
|
@@ -0,0 +1,159 @@
|
|
|
1
|
+
Доступные команды
|
|
2
|
+
===
|
|
3
|
+
|
|
4
|
+
### start
|
|
5
|
+
Запускает dev-сервер для клиентского кода и серверный код в watch-режиме.
|
|
6
|
+
|
|
7
|
+
**Как запустить?**
|
|
8
|
+
```bash
|
|
9
|
+
arui-scripts start
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
### start:prod
|
|
13
|
+
Запускает dev-сервер для клиентского кода и серверный код в watch-режиме. При этом использует production-конфигурацию для rspack.
|
|
14
|
+
Может быть полезна для сбора метрик производительности.
|
|
15
|
+
|
|
16
|
+
**Как запустить?**
|
|
17
|
+
```bash
|
|
18
|
+
arui-scripts start:prod
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
### build
|
|
22
|
+
Собирает клиентский и серверный код в production-режиме.
|
|
23
|
+
|
|
24
|
+
**Как запустить?**
|
|
25
|
+
```bash
|
|
26
|
+
arui-scripts build
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
### test
|
|
30
|
+
Команда `arui-scripts test` внутри запускает jest с дополнительной конфигурацией.
|
|
31
|
+
|
|
32
|
+
Конфигурация включает в себя:
|
|
33
|
+
- Использование `jest-snapshot-serializer-class-name-to-string` для правильной работы с `cn`
|
|
34
|
+
- Замену всех импортов css файлов на пустые файлы
|
|
35
|
+
- Компиляцию .js/.jsx файлов используя babel
|
|
36
|
+
- Компиляцию .ts/.tsx файлов используя tsc
|
|
37
|
+
- Замену импортов остальных типов файлов на импорт строк с названием файла
|
|
38
|
+
|
|
39
|
+
По умолчанию под маску для поиска тестов попадают все файлы `*test*.(js|jsx|ts|tsx)`, `*spec*.((js|jsx|ts|tsx))`, `*/__test__/*.(js|jsx|ts|tsx)`.
|
|
40
|
+
|
|
41
|
+
Вы можете переопределять любые настройки jest в `package.json`, [документация](https://facebook.github.io/jest/docs/en/configuration.html).
|
|
42
|
+
|
|
43
|
+
Если какие либо из ваших инструментов (например VSСode или WebStorm) не могут запустить тесты поскольку не находят конфигурацию, вы можете так же указать `arui-scripts` как preset для jest.
|
|
44
|
+
Таким образом будет работать как запуск тестов через arui-script, так и любые сторонние инструменты, запускающие jest.
|
|
45
|
+
|
|
46
|
+
_package.json_
|
|
47
|
+
```json
|
|
48
|
+
{
|
|
49
|
+
"jest": {
|
|
50
|
+
"preset": "arui-scripts"
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
**Как запустить?**
|
|
56
|
+
```bash
|
|
57
|
+
arui-scripts test
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
### test:vitest
|
|
61
|
+
Команда `arui-scripts test:vitest` запускает unit тесты через [Vitest](https://vitest.dev/).
|
|
62
|
+
|
|
63
|
+
Если в корне проекта есть `vitest.config.ts` (или `.js`, `.mjs`, `.cjs`), то используется он.
|
|
64
|
+
Иначе применяется конфигурация arui-scripts.
|
|
65
|
+
|
|
66
|
+
**Рекомендуемый способ настройки** - создать `vitest.config.js` с `mergeConfig`:
|
|
67
|
+
|
|
68
|
+
```javascript
|
|
69
|
+
import { defineConfig, mergeConfig } from 'vitest/config';
|
|
70
|
+
import aruiConfig from 'arui-scripts/vitest';
|
|
71
|
+
|
|
72
|
+
export default mergeConfig(aruiConfig, defineConfig({
|
|
73
|
+
test: {
|
|
74
|
+
setupFiles: ['./__tests__/setup.js'],
|
|
75
|
+
// другие настройки Vitest
|
|
76
|
+
},
|
|
77
|
+
}));
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
Базовый конфиг arui-scripts включает:
|
|
81
|
+
- API Vitest - используйте явные импорты: `import { describe, it, expect } from 'vitest'` (без глобальных переменных)
|
|
82
|
+
- Замену импортов `.css` на пустые модули, ассетов (svg, png, шрифты и др.) - на строку с именем файла
|
|
83
|
+
- Маппинг путей из `tsconfig.json` (paths) через [vite-tsconfig-paths](https://www.npmjs.com/package/vite-tsconfig-paths)
|
|
84
|
+
- Маски для тестов: `src/**/__tests__/**/*`, `src/**/__test__/**/*`, `src/**/*.{test,spec,tests}.*`
|
|
85
|
+
|
|
86
|
+
**Обратная совместимость**: при отсутствии `vitest.config.*` по-прежнему читается `jest.setupFiles` из `package.json`.
|
|
87
|
+
|
|
88
|
+
**Как запустить?**
|
|
89
|
+
|
|
90
|
+
```bash
|
|
91
|
+
arui-scripts test:vitest
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
### docker-build
|
|
95
|
+
Собирает клиентский и серверный код в production-режиме, создает docker-образ и пушит его в docker-репозиторий.
|
|
96
|
+
|
|
97
|
+
**Как запустить?**
|
|
98
|
+
```bash
|
|
99
|
+
arui-scripts docker-build
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
Имя контейнера определяется как `{configs.dockerRegistry}/{name}:{version}`. Переменные `name` и `version` по умолчанию берутся из package.json,
|
|
103
|
+
но вы так же можете переопределить их из командной строки, например
|
|
104
|
+
`arui-scripts docker-build name=container-name version=0.1-beta`.
|
|
105
|
+
|
|
106
|
+
Команда предполагает наличие установленных `node_modules` перед сборкой, в процессе работы же очищает дев зависимости используя `yarn` или `npm`.
|
|
107
|
+
yarn будет использоваться когда в рутовой папке проекта есть `yarn.lock` и `yarn` доступен в системе.
|
|
108
|
+
Если вы используете yarn 2, для выполнения команды очистки используется плагин [workspace-tools](https://github.com/yarnpkg/berry/blob/HEAD/packages/plugin-workspace-tools/README.md), поэтому он должен быть установлен и указан в `.yarnrc.yml` вашего проекта.
|
|
109
|
+
|
|
110
|
+
Итоговый контейнер будет содержать `nginx` и скрипт для запуска `nginx` одновременно с `nodejs` сервером.
|
|
111
|
+
|
|
112
|
+
В итоге, для корректного запуска вашего докер-контейнера вам надо будет выполнить команду
|
|
113
|
+
|
|
114
|
+
```bash
|
|
115
|
+
docker run -p 8080:8080 container-name:version ./start.sh
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
### docker-build:compiled
|
|
119
|
+
|
|
120
|
+
Команда `arui-scripts docker-build:compiled` во многом аналогична `docker-build`, но вместо сборки проекта использует уже скомпилированный в папку `.build` код.
|
|
121
|
+
При этом в контейнер будут устанавливаться только production зависимости.
|
|
122
|
+
Команду предполагается использовать в CI/CD, когда проект собирается в отдельном шаге и результат сборки уже доступен.
|
|
123
|
+
За счет того, что в контейнер папки node_modules не копируются, а устанавливаются только production зависимости, скорость сборки контейнера значительно увеличивается.
|
|
124
|
+
В процессе сборки так же будет модифицироваться файл `.dockerignore` для того чтобы гарантировано исключить папку `node_modules` из контекста сборки докера.
|
|
125
|
+
|
|
126
|
+
**⚠️ Внимание** команда не работает с `clientOnly` режимом.
|
|
127
|
+
|
|
128
|
+
`arui-scripts docker-build:compiled` имеет те же опции, что и `arui-scripts docker-build`.
|
|
129
|
+
Dockerfile при этом будет сгенерирован автоматически, но вы можете переопределить его используя механизм [overrides](overrides.md).
|
|
130
|
+
Локальный `Dockerfile` в корне проекта в данном случае полностью игнорируется.
|
|
131
|
+
|
|
132
|
+
**Как запустить?**
|
|
133
|
+
```bash
|
|
134
|
+
arui-scripts docker-build:compiled
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
### archive-build
|
|
138
|
+
|
|
139
|
+
Собирает архив с production сборкой.
|
|
140
|
+
|
|
141
|
+
Этот вариант может быть полезен если вы хотите деплоить ваше приложение через подключение архива в марафоне.
|
|
142
|
+
|
|
143
|
+
Команда предполагает наличие установленных `node_modules` перед сборкой, в процессе работы же очищает дев зависимости используя `yarn` или `npm`.
|
|
144
|
+
yarn будет использоваться когда в рутовой папке проекта есть `yarn.lock` и `yarn` доступен в системе.
|
|
145
|
+
Если вы используете yarn 2, для выполнения команды очистки используется плагин [workspace-tools](https://github.com/yarnpkg/berry/blob/HEAD/packages/plugin-workspace-tools/README.md), поэтому он должен быть установлен и указан в `.yarnrc.yml` вашего проекта.
|
|
146
|
+
|
|
147
|
+
Итоговый архив будет содержать в себе `.build`, `node_modules`, `package.json` и `config` папки вашего проекта.
|
|
148
|
+
|
|
149
|
+
**Как запустить?**
|
|
150
|
+
```bash
|
|
151
|
+
arui-scripts archive-build
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
### bundle-analyze
|
|
155
|
+
|
|
156
|
+
Запускает [webpack-bundle-analyzer](https://www.npmjs.com/package/webpack-bundle-analyzer) и [rsdoctor](https://rsdoctor.dev/) для анализа бандла и сборки.
|
|
157
|
+
Так же при запуске будет генерироваться [stats-файл](https://webpack.js.org/api/stats/), который можно использовать в
|
|
158
|
+
[сторонних](http://webpack.github.io/analyse/) инструментах, например для понимания почему тот или иной модуль попал в бандл.
|
|
159
|
+
По умолчанию файл будет писаться в `.build/stats.json`, вы можете поменять это через отдельную [настройку statsOutputFilename](settings.md#statsOutputFilename).
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
## Конфигурация typescripts
|
|
2
|
+
|
|
3
|
+
Компиляция TS работает из коробки, если в корне проекта есть файл `tsconfig.json`.
|
|
4
|
+
За основу можно использовать дефолтный конфиг:
|
|
5
|
+
|
|
6
|
+
```json
|
|
7
|
+
{
|
|
8
|
+
"extends": "./node_modules/arui-scripts/tsconfig.json"
|
|
9
|
+
}
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
По умолчанию TS будет компилироваться через babel, но у этого есть ряд ограничений:
|
|
13
|
+
- нельзя использовать namespace
|
|
14
|
+
- Нельзя использовать устаревший синтаксис import/export (`import foo = require(...)`, `export = foo`)
|
|
15
|
+
- enum merging
|
|
16
|
+
|
|
17
|
+
Если вы используете что-то из вышеперечисленного - вы можете вернуться к использованию tsc для компиляции ts файлов используя
|
|
18
|
+
настройку [`useTscLoader`](settings.md#usetscloader).
|