arui-scripts 25.1.0 → 25.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.turbo/turbo-test.log +3 -3
- package/CHANGELOG.md +7 -0
- package/docs/modules.md +43 -0
- package/package.json +2 -2
- package/tsconfig-local.tsbuildinfo +1 -1
package/.turbo/turbo-test.log
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
ts-jest[versions] (WARN) Version 6.0.2 of typescript installed has not been tested with ts-jest. If you're experiencing issues, consider using a supported version (>=4.3.0 <6.0.0-0). Please do not report issues in ts-jest if you are using unsupported versions.
|
|
2
|
-
PASS src/commands/util/__tests__/build-size-budgets.tests.ts (
|
|
2
|
+
PASS src/commands/util/__tests__/build-size-budgets.tests.ts (29.606 s)
|
|
3
3
|
PASS src/commands/bundle-diff/__tests__/report.tests.ts
|
|
4
4
|
PASS src/commands/util/__tests__/rsdoctor-snapshot.tests.ts
|
|
5
|
-
PASS src/configs/util/__tests__/register-ts-node.tests.ts
|
|
5
|
+
PASS src/configs/util/__tests__/register-ts-node.tests.ts (5.017 s)
|
|
6
6
|
PASS src/plugins/__tests__/attribute-module-css.tests.ts
|
|
7
7
|
PASS src/commands/bundle-diff/__tests__/snapshot.tests.ts
|
|
8
8
|
PASS src/configs/util/__tests__/find-plugin.tests.ts
|
|
@@ -32,5 +32,5 @@ PASS src/configs/app-configs/__tests__/validate-settings-keys.tests.ts
|
|
|
32
32
|
Test Suites: 29 passed, 29 total
|
|
33
33
|
Tests: 165 passed, 165 total
|
|
34
34
|
Snapshots: 0 total
|
|
35
|
-
Time:
|
|
35
|
+
Time: 43.824 s
|
|
36
36
|
Ran all test suites.
|
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,12 @@
|
|
|
1
1
|
# arui-scripts
|
|
2
2
|
|
|
3
|
+
## 25.1.1
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- Updated dependencies [[`9d06c377`](https://github.com/core-ds/arui-scripts/commit/9d06c377de947b415c4e0b5f382a47350db38320)]:
|
|
8
|
+
- @alfalab/arui-scripts-artifacts@1.0.1
|
|
9
|
+
|
|
3
10
|
## 25.1.0
|
|
4
11
|
|
|
5
12
|
### Minor Changes
|
package/docs/modules.md
CHANGED
|
@@ -1058,3 +1058,46 @@ type GetResourcesRequest<GetResourcesParams = void> = {
|
|
|
1058
1058
|
params: GetResourcesParams; // параметры, которые передаются в функцию получения ресурсов модуля
|
|
1059
1059
|
};
|
|
1060
1060
|
```
|
|
1061
|
+
|
|
1062
|
+
# Контекст готовности и ошибок модуля
|
|
1063
|
+
|
|
1064
|
+
`mount`, `hydrate` и `update` получают опциональный четвёртый аргумент
|
|
1065
|
+
`ModuleLifecycleContext` с `signal`, `reportReady()` и `reportError(error)`.
|
|
1066
|
+
Старые модули продолжают работать без изменений. Чтобы хост ожидал явную готовность,
|
|
1067
|
+
добавьте к экспорту модуля `readiness: 'explicit'` и вызывайте
|
|
1068
|
+
`context?.reportReady()` после инициализации приложения. Контекст может отсутствовать
|
|
1069
|
+
при запуске в старом хосте. Без `readiness` готовность определяется завершением
|
|
1070
|
+
`mount` / `hydrate`, включая возвращённый Promise.
|
|
1071
|
+
|
|
1072
|
+
На хосте доступны `onReady`, `onError({ error, stage })` и `readyTimeoutMs`:
|
|
1073
|
+
в параметрах `useModuleMounter`, в настройках фабрики `createLazyMounter` или в props
|
|
1074
|
+
`ModuleComponent` от `createSsrMounter`. Таймаут по умолчанию отключён и применяется
|
|
1075
|
+
только к явной готовности. `reportError` сообщает фатальную ошибку экземпляра,
|
|
1076
|
+
останавливает его обновления и запускает cleanup. Внутренний Error Boundary React-модуля
|
|
1077
|
+
может передавать ошибки в этот callback; внешний Boundary хоста не видит другой root.
|
|
1078
|
+
|
|
1079
|
+
[Подробный контракт, примеры и правила очистки](../../arui-scripts-modules/README.md#готовность-и-ошибки-экземпляра-модуля).
|
|
1080
|
+
|
|
1081
|
+
|
|
1082
|
+
# Готовый адаптер React-модуля
|
|
1083
|
+
|
|
1084
|
+
Ручные `mount`, `hydrate`, `update`, `unmount` можно заменить на
|
|
1085
|
+
`createReactModule` из `@alfalab/scripts-modules/react`:
|
|
1086
|
+
|
|
1087
|
+
```tsx
|
|
1088
|
+
import { createReactModule } from '@alfalab/scripts-modules/react';
|
|
1089
|
+
import { App } from './app';
|
|
1090
|
+
|
|
1091
|
+
export default createReactModule({ Component: App });
|
|
1092
|
+
```
|
|
1093
|
+
|
|
1094
|
+
App получает props `{ runParams, serverState }`. Хелпер создаёт отдельный root для
|
|
1095
|
+
каждого контейнера, сохраняет состояние при update, гидрирует серверный HTML и
|
|
1096
|
+
сообщает ошибки через внутренний Error Boundary. Нужны React и ReactDOM 18+.
|
|
1097
|
+
|
|
1098
|
+
По умолчанию готовность наступает после первого commit, в том числе с Suspense
|
|
1099
|
+
fallback. Для ожидания данных задайте `readiness: 'explicit'` и вызовите в App
|
|
1100
|
+
`useModuleReady(data.status === 'success')`. Готовность отправляется один раз после
|
|
1101
|
+
commit с истинным условием. На сервере можно рендерить обычный App без обёрток хелпера.
|
|
1102
|
+
|
|
1103
|
+
[Подробные примеры и контракт](../../arui-scripts-modules/README.md#react-хелпер-модуля).
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "arui-scripts",
|
|
3
|
-
"version": "25.1.
|
|
3
|
+
"version": "25.1.1",
|
|
4
4
|
"main": "./build/index.js",
|
|
5
5
|
"typings": "./build/index.d.ts",
|
|
6
6
|
"exports": {
|
|
@@ -22,7 +22,7 @@
|
|
|
22
22
|
"homepage": "https://github.com/core-ds/arui-scripts#readme",
|
|
23
23
|
"bin": "./build/bin/index.js",
|
|
24
24
|
"dependencies": {
|
|
25
|
-
"@alfalab/arui-scripts-artifacts": "^1.0.
|
|
25
|
+
"@alfalab/arui-scripts-artifacts": "^1.0.1",
|
|
26
26
|
"@alfalab/postcss-custom-properties": "^9.1.2",
|
|
27
27
|
"@babel/core": "7.29.7",
|
|
28
28
|
"@babel/plugin-proposal-decorators": "^7.29.7",
|