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.
@@ -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 (27.986 s)
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: 42.131 s
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.0",
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.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",