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,130 @@
|
|
|
1
|
+
# Compression dictionary transport
|
|
2
|
+
|
|
3
|
+
## Настройки
|
|
4
|
+
|
|
5
|
+
### `dictionaryCompression.dictionaryPath`
|
|
6
|
+
**Тип:** `string[]`
|
|
7
|
+
**По умолчанию:** `[]`
|
|
8
|
+
**Описание:** Массив путей до предыдущих версий ассетов или готовых словарей для сжатия бандла приложения.
|
|
9
|
+
|
|
10
|
+
- Поддерживает как абсолютные, так и относительные пути (относительно корня проекта)
|
|
11
|
+
- Может содержать как файлы (готовые словари), так и директории (предыдущие версии приложения)
|
|
12
|
+
- Словари будут скопированы в директорию сборки
|
|
13
|
+
- Директории используются для создания DCB-файлов из предыдущих версий
|
|
14
|
+
|
|
15
|
+
### `dictionaryCompression.enablePreviousVersionHeaders`
|
|
16
|
+
**Тип:** `boolean`
|
|
17
|
+
**По умолчанию:** `false`
|
|
18
|
+
**Описание:** Включает автоматическую простановку заголовка `brotli_auto_dictionary on;` в конфигурации nginx для использования ресурсов приложения как словарей.
|
|
19
|
+
|
|
20
|
+
## Пример конфигурации
|
|
21
|
+
|
|
22
|
+
```ts
|
|
23
|
+
import { PackageSettings } from 'arui-scripts';
|
|
24
|
+
|
|
25
|
+
const settings: PackageSettings = {
|
|
26
|
+
dictionaryCompression: {
|
|
27
|
+
dictionaryPath: [
|
|
28
|
+
'./build-v1.0', // Предыдущая версия (директория)
|
|
29
|
+
'./custom.dict' // Готовый словарь (файл)
|
|
30
|
+
],
|
|
31
|
+
enablePreviousVersionHeaders: true
|
|
32
|
+
}
|
|
33
|
+
};
|
|
34
|
+
|
|
35
|
+
export default settings;
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
## Общее описание механизма
|
|
39
|
+
|
|
40
|
+
Механизм [compression dictionary transport](https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/Compression_dictionary_transport)
|
|
41
|
+
позволяет использовать кастомные словари для сжатия ресурсов приложения.
|
|
42
|
+
|
|
43
|
+
На данный момент arui-scripts поддерживает два механизма работы со словарями:
|
|
44
|
+
1. Использование вашего собственного словаря для сжатия ресурсов приложения
|
|
45
|
+
2. Использование одной версии вашего приложения для сжатия ресурсов другой версии.
|
|
46
|
+
|
|
47
|
+
Оба механизма работают только для prod сборки приложения при использовании базового docker образа, поставляемого с arui-scripts.
|
|
48
|
+
|
|
49
|
+
### Использование вашего словаря
|
|
50
|
+
|
|
51
|
+
По умолчанию brotli использует встроенный в него словарь для более эффективного сжатия. Встроенный в brotli словарь подготовлен
|
|
52
|
+
на основании данных из всего интернета. Если сделать словарь персонально под ваши ресурсы - можно получить более эффективное сжатие, даже
|
|
53
|
+
учитывая дополнительные затраты на загрузку словаря на клиент.
|
|
54
|
+
|
|
55
|
+
#### Создание персонального словаря
|
|
56
|
+
Для создания персонального словаря вы можете использовать утилиту [brotli-dict](https://www.npmjs.com/package/brotli-dict).
|
|
57
|
+
|
|
58
|
+
```shell
|
|
59
|
+
npx brotli-dict generate file1.js file2.js file3.css -o dictionary.dict -s 200000
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
Здесь:
|
|
63
|
+
- `file1.js`, `file2.js`, `file3.css` - произвольные текстовые файлы которые вы хотите использовать для создания словаря
|
|
64
|
+
- `dictionary.dict` - имя файла для создаваемого словаря
|
|
65
|
+
- `-s 200000` - ограничивает максимальную длину словаря в 200000. Имейте в виду, что словарь после создания так же можно сжать, поэтому по сети будет передаваться меньше данных.
|
|
66
|
+
|
|
67
|
+
Рекомендуется создать 1 словарь на всю систему, живущую на одном домене. Вы можете взять ресурсы с самых посещаемых страниц и использовать их как исходники для словаря.
|
|
68
|
+
Обновлять их при изменении приложений не обязательно - словари скорее всего не будут содержать сильно специфичного для конкретной версии контента.
|
|
69
|
+
|
|
70
|
+
#### Выбор идентификатора для словаря
|
|
71
|
+
|
|
72
|
+
Для корректной работы со словарем у него должен быть идентификатор. Он будет:
|
|
73
|
+
- использоваться как имя файла для словаря
|
|
74
|
+
- использоваться как суффикс имени сжатых словарем ассетов
|
|
75
|
+
- использоваться в заголовке `Use-As-Dictionary`.
|
|
76
|
+
|
|
77
|
+
В дальнейших примерах я буду использовать идентификатор `dict-id`.
|
|
78
|
+
|
|
79
|
+
#### Загрузка словаря на клиент
|
|
80
|
+
Для того чтобы браузер начал использовать словари их нужно как то загрузить на клиент.
|
|
81
|
+
Это можно сделать 3 способами:
|
|
82
|
+
|
|
83
|
+
- Указав заголовок `Link '</assets/dict-id.dict>; rel="compression-dictionary"';` в ответе на запрос за любым документом
|
|
84
|
+
- Добавив тег `<link rel="compression-dictionary" href="./assets/dict-id.dict" />` в html вашего приложения
|
|
85
|
+
- Сделав `fetch` адреса словаря из вашего кода (`fetch('./assets/dict-id.dict')`).
|
|
86
|
+
|
|
87
|
+
В независимости от метода, в ответ браузер **должен** получить помимо контента словаря так же заголовок `Use-As-Dictionary`, например:
|
|
88
|
+
```
|
|
89
|
+
Use-As-Dictionary: 'match="/assets/*", id="dict-id"'
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
Вы можете добиться этого добавив такие строки в nginx.conf:
|
|
93
|
+
|
|
94
|
+
```
|
|
95
|
+
location /assets/dict-id.dict {
|
|
96
|
+
expires max;
|
|
97
|
+
add_header Use-As-Dictionary 'match="/assets/*", id="dict-id"';
|
|
98
|
+
root /src/.build;
|
|
99
|
+
}
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
Про то, как корректно настраивать заголовок `Use-As-Dictionary` можно прочитать в [mdn](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Use-As-Dictionary).
|
|
103
|
+
|
|
104
|
+
### Использование предыдущих версий приложения
|
|
105
|
+
|
|
106
|
+
Если ваше приложение часто обновляется, а пользователи все время возвращаются - можно использовать механизм сжатия с помощью предыдущих версий.
|
|
107
|
+
Он может давать очень высокий коэффицент сжатия если у пользователя есть предыдущая версия приложения в кеше.
|
|
108
|
+
|
|
109
|
+
#### Настройка
|
|
110
|
+
|
|
111
|
+
```ts
|
|
112
|
+
const settings: PackageSettings = {
|
|
113
|
+
dictionaryCompression: {
|
|
114
|
+
dictionaryPath: [
|
|
115
|
+
'./previous-builds/v1.0/assets',
|
|
116
|
+
'./previous-builds/v1.1/assets'
|
|
117
|
+
],
|
|
118
|
+
enablePreviousVersionHeaders: true
|
|
119
|
+
}
|
|
120
|
+
};
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
При такой конфигурации:
|
|
124
|
+
1. **arui-scripts** найдёт все `.js` и `.css` файлы в указанных директориях
|
|
125
|
+
2. Создаст DCB-файлы (Dictionary Compressed Brotli) для каждого файла текущей сборки, используя соответствующие файлы из предыдущих версий как словари
|
|
126
|
+
3. Nginx будет настроен с `brotli_auto_dictionary on;` для автоматического использования этих словарей
|
|
127
|
+
|
|
128
|
+
Соответствие файлов определяется по их имени. Считаем что файлы в сборке используют формат вида `{stable-name}.{hash}.{ext}`. Соответствующими считаются файлы с одинаковым
|
|
129
|
+
`{stable-name}` и `{ext}`.
|
|
130
|
+
DCB файлы будут иметь название `{stable-name}.{hash}.{ext}.{dict hash}.dcb`.
|
package/docs/examples.md
ADDED
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
Примеры входных точек для сервера и клиента
|
|
2
|
+
===
|
|
3
|
+
|
|
4
|
+
## Клиент
|
|
5
|
+
Для корректной работы hot-module-replacement на клиенте вам надо добавить примерно такой код:
|
|
6
|
+
|
|
7
|
+
_./src/index.tsx_
|
|
8
|
+
```tsx
|
|
9
|
+
import React from 'react';
|
|
10
|
+
import ReactDOM from 'react-dom';
|
|
11
|
+
import { App } from './components/app';
|
|
12
|
+
|
|
13
|
+
const targetElement = document.getElementById('react-app');
|
|
14
|
+
|
|
15
|
+
ReactDOM.render(
|
|
16
|
+
<App />,
|
|
17
|
+
targetElement
|
|
18
|
+
);
|
|
19
|
+
|
|
20
|
+
if (process.env.NODE_ENV !== 'production' && module.hot) {
|
|
21
|
+
module.hot.accept('./components/app', () => {
|
|
22
|
+
let NextAppAssignments = require('./components/app').App;
|
|
23
|
+
|
|
24
|
+
ReactDOM.render(
|
|
25
|
+
<NextAppAssignments />,
|
|
26
|
+
targetElement
|
|
27
|
+
);
|
|
28
|
+
});
|
|
29
|
+
}
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
## Сервер
|
|
33
|
+
|
|
34
|
+
### Использование hot-module-replacement
|
|
35
|
+
По умолчанию серверная часть приложения будет просто перезапускаться после каждого изменения кода,
|
|
36
|
+
для использования hot module replacement на сервере можно использовать настройку [`useServerHMR`](settings.md#useserverhmr).
|
|
37
|
+
|
|
38
|
+
Ваша входная точка сервера должна выглядеть примерно так (на примере hapi):
|
|
39
|
+
|
|
40
|
+
_./src/server/index.ts_
|
|
41
|
+
```ts
|
|
42
|
+
import server from './server';
|
|
43
|
+
|
|
44
|
+
let currentServer = server;
|
|
45
|
+
|
|
46
|
+
async function startServer() {
|
|
47
|
+
try {
|
|
48
|
+
await currentServer.start();
|
|
49
|
+
} catch (error) {
|
|
50
|
+
console.error('Failed to start server', error);
|
|
51
|
+
process.exit(1);
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
startServer();
|
|
56
|
+
|
|
57
|
+
if (module.hot) {
|
|
58
|
+
module.hot.accept(['./server'], async () => {
|
|
59
|
+
try {
|
|
60
|
+
await currentServer.stop();
|
|
61
|
+
|
|
62
|
+
currentServer = server; // импорт из сервера заменится самостоятельно
|
|
63
|
+
await startServer();
|
|
64
|
+
} catch (error) {
|
|
65
|
+
console.log('Failed to update server. You probably need to restart application', error);
|
|
66
|
+
}
|
|
67
|
+
});
|
|
68
|
+
}
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
_./src/server/server.ts_
|
|
72
|
+
```ts
|
|
73
|
+
import hapi from 'hapi';
|
|
74
|
+
const server = new hapi.Server();
|
|
75
|
+
|
|
76
|
+
server.ext('onPostStart', (_, done) => {
|
|
77
|
+
console.log(`Server is running: ${server.info.uri}`);
|
|
78
|
+
done();
|
|
79
|
+
});
|
|
80
|
+
|
|
81
|
+
(async () => {
|
|
82
|
+
server.connection({ port: 3000 });
|
|
83
|
+
|
|
84
|
+
// ...
|
|
85
|
+
// конфигурация вашего сервера
|
|
86
|
+
// ...
|
|
87
|
+
})();
|
|
88
|
+
|
|
89
|
+
export default server;
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
Таким образом после изменения кода сервер не будет полностью пререзагружаться, что во многих случаях быстрее.
|
|
93
|
+
В случае изменения входной точки сервера при использовании HMR вам надо будет перезапускать сервер вручную.
|
|
94
|
+
|
|
95
|
+
### Формирование html для серверного рендеринга
|
|
96
|
+
|
|
97
|
+
Для того чтобы корректно формировать html вам нужно знать имена чанков, которые будут сгенерированы вебпаком.
|
|
98
|
+
Для этого рекомендуется использовать метод `readAssetsManifest` из `@alfalab/scripts-server`, который возвращает объект с именами чанков.
|
|
99
|
+
|
|
100
|
+
Документация по `readAssetsManifest` доступна [здесь](../../arui-scripts-server/README.md#readassetsmanifest).
|