@vnejs/docs 0.2.53 → 0.2.55

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.
Files changed (39) hide show
  1. package/CHANGELOG.md +24 -1
  2. package/architecture.md +22 -22
  3. package/package.json +1 -1
  4. package/plugins/canvas.layers/bl.md +8 -3
  5. package/plugins/canvas.layers/fl.md +8 -3
  6. package/plugins/canvas.layers/ml.md +8 -3
  7. package/plugins/canvas.layers/ul.md +8 -3
  8. package/plugins/controls/controls.md +4 -4
  9. package/plugins/controls/cursor.md +15 -12
  10. package/plugins/core/components.md +2 -1
  11. package/plugins/views/achievement.md +14 -9
  12. package/plugins/views/comment.md +10 -7
  13. package/plugins/views/controls.hints.md +12 -7
  14. package/plugins/views/fps.md +9 -6
  15. package/plugins/views/gamepad.debug.md +9 -6
  16. package/plugins/views/settings.md +4 -3
  17. package/plugins/views/video.md +13 -10
  18. package/plugins/views.scenario/choose.md +11 -11
  19. package/plugins/views.scenario/interface.controls.md +14 -11
  20. package/plugins/views.scenario/interface.fastforward.md +10 -7
  21. package/plugins/views.scenario/interface.md +23 -20
  22. package/plugins/views.scenario/point_and_click.md +16 -14
  23. package/plugins/views.scenario/qte.md +33 -35
  24. package/plugins/views.screens/checkers.md +1 -1
  25. package/plugins/views.screens/confirm.md +6 -5
  26. package/plugins/views.screens/credits.md +17 -14
  27. package/plugins/views.screens/disclaimer.md +14 -11
  28. package/plugins/views.screens/eula.md +4 -3
  29. package/plugins/views.screens/gallery.full.md +8 -5
  30. package/plugins/views.screens/gallery.md +9 -9
  31. package/plugins/views.screens/gamemenu.md +5 -4
  32. package/plugins/views.screens/history.md +5 -4
  33. package/plugins/views.screens/intro.md +17 -17
  34. package/plugins/views.screens/loading.md +15 -15
  35. package/plugins/views.screens/mainmenu.md +18 -19
  36. package/plugins/views.screens/mainmenu.socials.md +6 -3
  37. package/plugins/views.screens/save.md +10 -10
  38. package/plugins/views.screens/settings.defaults.md +17 -17
  39. package/plugins/views.screens/settings.md +15 -15
package/plugins/views.screens/gamemenu.md CHANGED
@@ -15,8 +15,9 @@ Payloads и результаты хендлеров типизированы ч
15
15
  | `ITEMS` | `vne:gamemenu:items` | Резолв фабрик пунктов меню. |
16
16
  | `CLICK` | `vne:gamemenu:click` | Событие `CLICK` namespace плагина. |
17
17
  | `UPDATE` | `vne:gamemenu:update` | Обновить состояние или отображение. |
18
- | `STATE_UPDATE` | `vne:gamemenu:state_update` | Слить partial в стейт контроллера без UPDATE view. |
18
+ | `UPDATE_STATE` | `vne:gamemenu:update_state` | Слить partial в стейт контроллера без UPDATE view. |
19
19
  | `UPDATE_FAST` | `vne:gamemenu:update_fast` | Перерисовать view с `isFast`, стейт не меняет. |
20
+ | `UPDATE_FORCE` | `vne:gamemenu:update_force` | Перерисовать view с `isForce`, стейт не меняет. |
20
21
  | `ACCEPT` | `vne:gamemenu:accept` | Событие `ACCEPT` namespace плагина. |
21
22
 
22
23
  ## Константы
@@ -43,9 +44,9 @@ Payloads и результаты хендлеров типизированы ч
43
44
 
44
45
  | Модуль | Зона ответственности |
45
46
  | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
46
- | `gamemenu.controller` | Обрабатывает UPDATE, HIDE, SHOW, STATE_UPDATE, UPDATE_FAST, …. Пустой `controls` на `ZINDEX`, чтобы стопорить слои ниже. Резолвит `ITEMS` → `items` / `realItems`. |
47
- | `gamemenu.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CLICK` по полному индексу пункта (через `realItems`); зеркалит `STATE_UPDATE`; PUSH/POP на SHOW/HIDE. |
48
- | `gamemenu.controller.arrows` | Наследует `@vnejs/module.controller.arrows.vertical`: `ARROW_UP` / `ARROW_BOTTOM` по видимым пунктам; PUSH/POP controls на SHOW/HIDE; эмитит `STATE_UPDATE` с `{ currentArrowVerticalItem }` и `UPDATE_FAST`. |
47
+ | `gamemenu.controller` | Обрабатывает UPDATE, HIDE, SHOW, UPDATE_STATE, UPDATE_FAST, …. Пустой `controls` на `ZINDEX`, чтобы стопорить слои ниже. Резолвит `ITEMS` → `items` / `realItems`. |
48
+ | `gamemenu.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CLICK` по полному индексу пункта (через `realItems`); зеркалит `UPDATE_STATE`; PUSH/POP на SHOW/HIDE. |
49
+ | `gamemenu.controller.arrows` | Наследует `@vnejs/module.controller.arrows.vertical`: `ARROW_UP` / `ARROW_BOTTOM` по видимым пунктам; PUSH/POP controls на SHOW/HIDE; эмитит `UPDATE_STATE` с `{ currentArrowVerticalItem }` и `UPDATE_FAST`. |
49
50
  | `gamemenu.hide.controls` | Наследует `@vnejs/module.controller.hide.on.controls`: `BACK` / `MENU` / `GAMEMENU` → `HIDE`; PUSH/POP на SHOW/HIDE. |
50
51
  | `gamemenu.hide.state` | Наследует `@vnejs/module.controller.hide.on.state`: `STATE.SET` / `STATE.CLEAR` → `HIDE` с `{ isForce: true }`. |
51
52
  | `gamemenu` | `ITEMS` / `CLICK`; пропускает disabled/hided. |
package/plugins/views.screens/history.md CHANGED
@@ -14,8 +14,9 @@ Payloads и результаты хендлеров типизированы ч
14
14
  | `SHOW` | `vne:history_view:show` | Показать экран. |
15
15
  | `CLICK` | `vne:history_view:click` | Клик по строке. Если `uid` есть в ключах журнала — `HISTORY.LOAD`. |
16
16
  | `UPDATE` | `vne:history_view:update` | Перерисовать view. |
17
- | `STATE_UPDATE` | `vne:history_view:state_update` | Слить partial в стейт контроллера без UPDATE view. |
17
+ | `UPDATE_STATE` | `vne:history_view:update_state` | Слить partial в стейт контроллера без UPDATE view. |
18
18
  | `UPDATE_FAST` | `vne:history_view:update_fast` | Перерисовать view с `isFast`, стейт не меняет. |
19
+ | `UPDATE_FORCE` | `vne:history_view:update_force` | Перерисовать view с `isForce`, стейт не меняет. |
19
20
  | `ACCEPT` | `vne:history_view:accept` | `ACCEPT` / `INTERACT` → `CLICK` по `currentArrowVerticalItem`. |
20
21
 
21
22
  Строки журнала и шаг назад — `EVENTS.HISTORY.GET` / `KEYS` / `LOAD` / `BACK` / `ADD` (`scenario/history`).
@@ -41,9 +42,9 @@ Payloads и результаты хендлеров типизированы ч
41
42
 
42
43
  | Модуль | Зона ответственности |
43
44
  | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
44
- | `history.controller` | SHOW/HIDE/CLICK/STATE_UPDATE/UPDATE_FAST; перед SHOW резолвит тексты строк (`TEXT.REPLACE`). Для `locKey` — через `PARAMS.HISTORY_VIEW.LOC_LABEL` (локализация view), иначе через label сценария. Пустой `controls` на `ZINDEX`, чтобы стопорить слои ниже. |
45
- | `history.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CLICK` по `currentArrowVerticalItem`; зеркалит `STATE_UPDATE`; PUSH/POP на SHOW/HIDE. |
46
- | `history.controller.arrows` | Наследует `@vnejs/module.controller.arrows.vertical`: `ARROW_UP` / `ARROW_BOTTOM` по записям журнала; PUSH/POP controls на SHOW/HIDE; эмитит `STATE_UPDATE` с `{ currentArrowVerticalItem }` и `UPDATE_FAST`. |
45
+ | `history.controller` | SHOW/HIDE/CLICK/UPDATE_STATE/UPDATE_FAST; перед SHOW резолвит тексты строк (`TEXT.REPLACE`). Для `locKey` — через `PARAMS.HISTORY_VIEW.LOC_LABEL` (локализация view), иначе через label сценария. Пустой `controls` на `ZINDEX`, чтобы стопорить слои ниже. |
46
+ | `history.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CLICK` по `currentArrowVerticalItem`; зеркалит `UPDATE_STATE`; PUSH/POP на SHOW/HIDE. |
47
+ | `history.controller.arrows` | Наследует `@vnejs/module.controller.arrows.vertical`: `ARROW_UP` / `ARROW_BOTTOM` по записям журнала; PUSH/POP controls на SHOW/HIDE; эмитит `UPDATE_STATE` с `{ currentArrowVerticalItem }` и `UPDATE_FAST`. |
47
48
  | `history.hide.controls` | Наследует `@vnejs/module.controller.hide.on.controls`: `BACK` / `MENU` / `GAMEMENU` → `HIDE`; PUSH/POP на SHOW/HIDE. |
48
49
  | `history.hide.state` | Наследует `@vnejs/module.controller.hide.on.state`: `STATE.SET` → `HIDE` с `{ isForce: true }` (`IS_STATE_CLEAR_ENABLED = false`). |
49
50
  | `history.view` | Подмодуль `view` плагина. |
package/plugins/views.screens/intro.md CHANGED
@@ -8,17 +8,17 @@
8
8
 
9
9
  Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.screens.intro`.
10
10
 
11
- | Ключ | Строка | Смысл |
12
- | -------------- | ------------------------ | --------------------------------------- |
13
- | `SHOW` | `vne:intro:show` | Показать UI или слой. |
14
- | `SHOW_BEFORE` | `vne:intro:show_before` | Хук перед показом: пишет `bgSrc`. |
15
- | `HIDE` | `vne:intro:hide` | Скрыть UI или слой. |
16
- | `CLICK` | `vne:intro:click` | Продвинуть сценарий к следующей строке. |
17
- | `UPDATE` | `vne:intro:update` | Обновить состояние или отображение. |
18
- | `UPDATE_FAST` | `vne:intro:update_fast` | Перерисовать view с `isFast`. |
19
- | `SKIP` | `vne:intro:skip` | Продвинуть сценарий к следующей строке. |
20
- | `INTERACT` | `vne:intro:interact` | Продвинуть сценарий к следующей строке. |
21
- | `STATE_UPDATE` | `vne:intro:state_update` | Слить partial в стейт. |
11
+ | Ключ | Строка | Смысл |
12
+ | -------------- | ------------------------ | ----------------------------------------------- |
13
+ | `SHOW` | `vne:intro:show` | Показать UI или слой. |
14
+ | `HIDE` | `vne:intro:hide` | Скрыть UI или слой. |
15
+ | `CLICK` | `vne:intro:click` | Продвинуть сценарий к следующей строке. |
16
+ | `UPDATE` | `vne:intro:update` | Обновить состояние или отображение. |
17
+ | `UPDATE_FAST` | `vne:intro:update_fast` | Перерисовать view с `isFast`. |
18
+ | `UPDATE_FORCE` | `vne:intro:update_force` | Перерисовать view с `isForce`, стейт не меняет. |
19
+ | `SKIP` | `vne:intro:skip` | Продвинуть сценарий к следующей строке. |
20
+ | `INTERACT` | `vne:intro:interact` | Продвинуть сценарий к следующей строке. |
21
+ | `UPDATE_STATE` | `vne:intro:update_state` | Слить partial в стейт. |
22
22
 
23
23
  ## Константы
24
24
 
@@ -36,12 +36,12 @@ Payloads и результаты хендлеров типизированы ч
36
36
 
37
37
  ## Модули
38
38
 
39
- | Модуль | Зона ответственности |
40
- | --------------------- | ---------------------------------------------------------------------------------------- |
41
- | `intro.controller` | SHOW/HIDE; `beforeShow` → `SHOW_BEFORE`; `STATE_UPDATE` / `UPDATE_FAST`; ANY → INTERACT. |
42
- | `intro.controller.bg` | Наследует `@vnejs/module.controller.bg`: `SHOW_BEFORE` → `bgSrc`; `start` preload. |
43
- | `intro` | Связь со сценарием: шаг next после завершения действия. |
44
- | `intro.view` | Подмодуль `view` плагина. |
39
+ | Модуль | Зона ответственности |
40
+ | --------------------- | -------------------------------------------------------------------------------------------------------------- |
41
+ | `intro.controller` | SHOW/HIDE по фазам `CONST.COMPONENTS.LIFECYCLE_PRIORITY`; `UPDATE_STATE` / `UPDATE_FAST`; ANY → INTERACT. |
42
+ | `intro.controller.bg` | Наследует `@vnejs/module.controller.bg`: `SHOW` + `LIFECYCLE_PRIORITY.SHOW.BEFORE` → `bgSrc`; `start` preload. |
43
+ | `intro` | Связь со сценарием: шаг next после завершения действия. |
44
+ | `intro.view` | Подмодуль `view` плагина. |
45
45
 
46
46
  ## Близкие плагины
47
47
 
package/plugins/views.screens/loading.md CHANGED
@@ -8,15 +8,15 @@
8
8
 
9
9
  Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.screens.loading`.
10
10
 
11
- | Ключ | Строка | Смысл |
12
- | -------------- | -------------------------- | ----------------------------------------- |
13
- | `SHOW` | `vne:loading:show` | Показать UI или слой. |
14
- | `SHOW_BEFORE` | `vne:loading:show_before` | Хук перед показом: пишет `bgSrc`. |
15
- | `HIDE` | `vne:loading:hide` | Скрыть UI или слой. |
16
- | `EMIT` | `vne:loading:emit` | Записать диагностическое сообщение в лог. |
17
- | `UPDATE` | `vne:loading:update` | Обновить состояние или отображение. |
18
- | `UPDATE_FAST` | `vne:loading:update_fast` | Перерисовать view с `isFast`. |
19
- | `STATE_UPDATE` | `vne:loading:state_update` | Слить partial в стейт. |
11
+ | Ключ | Строка | Смысл |
12
+ | -------------- | -------------------------- | ----------------------------------------------- |
13
+ | `SHOW` | `vne:loading:show` | Показать UI или слой. |
14
+ | `HIDE` | `vne:loading:hide` | Скрыть UI или слой. |
15
+ | `EMIT` | `vne:loading:emit` | Записать диагностическое сообщение в лог. |
16
+ | `UPDATE` | `vne:loading:update` | Обновить состояние или отображение. |
17
+ | `UPDATE_FAST` | `vne:loading:update_fast` | Перерисовать view с `isFast`. |
18
+ | `UPDATE_FORCE` | `vne:loading:update_force` | Перерисовать view с `isForce`, стейт не меняет. |
19
+ | `UPDATE_STATE` | `vne:loading:update_state` | Слить partial в стейт. |
20
20
 
21
21
  ## Константы
22
22
 
@@ -34,12 +34,12 @@ Payloads и результаты хендлеров типизированы ч
34
34
 
35
35
  ## Модули
36
36
 
37
- | Модуль | Зона ответственности |
38
- | ----------------------- | ----------------------------------------------------------------------------------------------------------------- |
39
- | `loading.controller` | SHOW/HIDE; `beforeShow` → `SHOW_BEFORE`; `STATE_UPDATE` / `UPDATE_FAST`. |
40
- | `loading.controller.bg` | Наследует `@vnejs/module.controller.bg`: `SHOW_BEFORE` → `bgSrc`; `start`; `MEMORY.CLEARED` refresh при `isShow`. |
41
- | `loading` | Точка входа emit: подготовка и запуск process. |
42
- | `loading.view` | Подмодуль `view` плагина. |
37
+ | Модуль | Зона ответственности |
38
+ | ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
39
+ | `loading.controller` | SHOW/HIDE по фазам `CONST.COMPONENTS.LIFECYCLE_PRIORITY`; `UPDATE_STATE` / `UPDATE_FAST`. |
40
+ | `loading.controller.bg` | Наследует `@vnejs/module.controller.bg`: `SHOW` + `LIFECYCLE_PRIORITY.SHOW.BEFORE` → `bgSrc`; `start`; `MEMORY.CLEARED` refresh при `isShow`. |
41
+ | `loading` | Точка входа emit: подготовка и запуск process. |
42
+ | `loading.view` | Подмодуль `view` плагина. |
43
43
 
44
44
  ## Близкие плагины
45
45
 
package/plugins/views.screens/mainmenu.md CHANGED
@@ -4,25 +4,24 @@
4
4
 
5
5
  Главное меню с пунктами, сменой фона и предзагрузкой меток сценария.
6
6
 
7
- Ротация `BACKGROUNDS`: модуль `mainmenu.backgrounds` по `SHOW` сразу грузит следующий фон и по `BACKGROUNDS_INTERVAL` эмитит `STATE_UPDATE` с `{ bgSrc }` и затем `UPDATE_FAST`.
7
+ Ротация `BACKGROUNDS`: модуль `mainmenu.backgrounds` по `SHOW` сразу грузит следующий фон и по `BACKGROUNDS_INTERVAL` эмитит `UPDATE_STATE` с `{ bgSrc }` и затем `UPDATE_FAST`.
8
8
 
9
9
  ## События
10
10
 
11
11
  Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.screens.mainmenu`.
12
12
 
13
- | Ключ | Строка | Смысл |
14
- | -------------- | --------------------------- | -------------------------------------------------------------------- |
15
- | `HIDE` | `vne:mainmenu:hide` | Скрыть UI или слой. |
16
- | `SHOW` | `vne:mainmenu:show` | Показать UI или слой. |
17
- | `SHOW_BEFORE` | `vne:mainmenu:show_before` | Хук перед показом: начальный `bgSrc` через `mainmenu.controller.bg`. |
18
- | `ITEMS` | `vne:mainmenu:items` | Событие `ITEMS` namespace плагина. |
19
- | `PRELOAD` | `vne:mainmenu:preload` | Предзагрузить метки `PRELOAD_LABELS` и события `PRELOAD_EVENTS`. |
20
- | `CLICK` | `vne:mainmenu:click` | Событие `CLICK` namespace плагина. |
21
- | `ACCEPT` | `vne:mainmenu:accept` | Событие `ACCEPT` namespace плагина. |
22
- | `UPDATE` | `vne:mainmenu:update` | Обновить состояние или отображение. |
23
- | `STATE_UPDATE` | `vne:mainmenu:state_update` | Слить partial в стейт контроллера без UPDATE view. |
24
- | `UPDATE_FORCE` | `vne:mainmenu:update_force` | Перерисовать view с `isForce`, стейт не меняет. |
25
- | `UPDATE_FAST` | `vne:mainmenu:update_fast` | Перерисовать view с `isFast`, стейт не меняет. |
13
+ | Ключ | Строка | Смысл |
14
+ | -------------- | --------------------------- | ---------------------------------------------------------------- |
15
+ | `HIDE` | `vne:mainmenu:hide` | Скрыть UI или слой. |
16
+ | `SHOW` | `vne:mainmenu:show` | Показать UI или слой. |
17
+ | `ITEMS` | `vne:mainmenu:items` | Событие `ITEMS` namespace плагина. |
18
+ | `PRELOAD` | `vne:mainmenu:preload` | Предзагрузить метки `PRELOAD_LABELS` и события `PRELOAD_EVENTS`. |
19
+ | `CLICK` | `vne:mainmenu:click` | Событие `CLICK` namespace плагина. |
20
+ | `ACCEPT` | `vne:mainmenu:accept` | Событие `ACCEPT` namespace плагина. |
21
+ | `UPDATE` | `vne:mainmenu:update` | Обновить состояние или отображение. |
22
+ | `UPDATE_STATE` | `vne:mainmenu:update_state` | Слить partial в стейт контроллера без UPDATE view. |
23
+ | `UPDATE_FORCE` | `vne:mainmenu:update_force` | Перерисовать view с `isForce`, стейт не меняет. |
24
+ | `UPDATE_FAST` | `vne:mainmenu:update_fast` | Перерисовать view с `isFast`, стейт не меняет. |
26
25
 
27
26
  ## Константы
28
27
 
@@ -51,12 +50,12 @@ Payloads и результаты хендлеров типизированы ч
51
50
 
52
51
  | Модуль | Зона ответственности |
53
52
  | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
54
- | `mainmenu.controller` | UPDATE, SHOW, HIDE, STATE_UPDATE, UPDATE_FAST, UPDATE_FORCE; `beforeShow` → `SHOW_BEFORE` + ITEMS. На SHOW пушит пустой `controls` на `ZINDEX`. |
55
- | `mainmenu.controller.bg` | Наследует `@vnejs/module.controller.bg`: начальный `bgSrc` на `SHOW_BEFORE`; `start` / `STATE.CLEAR` preload. Ротацию не трогает. |
53
+ | `mainmenu.controller` | UPDATE, SHOW, HIDE по фазам `CONST.COMPONENTS.LIFECYCLE_PRIORITY`; на `SHOW.BEFORE` — ITEMS. Пустой `controls` на `ZINDEX`. UPDATE_STATE, UPDATE_FAST, UPDATE_FORCE. |
54
+ | `mainmenu.controller.bg` | Наследует `@vnejs/module.controller.bg`: начальный `bgSrc` на `SHOW` + `LIFECYCLE_PRIORITY.SHOW.BEFORE`; `start` / `STATE.CLEAR` preload. Ротацию не трогает. |
56
55
  | `mainmenu.hide` | Наследует `@vnejs/module.controller.hide.on.state`: `STATE.SET` / `STATE.CLEAR` → `HIDE` с `{ isForce: true }`. |
57
- | `mainmenu.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CLICK` по `currentArrowVerticalItem`; зеркалит `STATE_UPDATE`; PUSH/POP на SHOW/HIDE. |
58
- | `mainmenu.controller.arrows` | Наследует `@vnejs/module.controller.arrows.vertical`: `ARROW_UP` / `ARROW_BOTTOM` по видимым пунктам; PUSH/POP controls на SHOW/HIDE; эмитит `STATE_UPDATE` с `{ currentArrowVerticalItem }` и `UPDATE_FAST`. |
59
- | `mainmenu.backgrounds` | Наследует `@vnejs/module.controller.backgrounds`: ротация `BACKGROUNDS`, preload и таймер; эмитит `STATE_UPDATE` и `UPDATE_FAST`. |
56
+ | `mainmenu.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CLICK` по `currentArrowVerticalItem`; зеркалит `UPDATE_STATE`; PUSH/POP на SHOW/HIDE. |
57
+ | `mainmenu.controller.arrows` | Наследует `@vnejs/module.controller.arrows.vertical`: `ARROW_UP` / `ARROW_BOTTOM` по видимым пунктам; PUSH/POP controls на SHOW/HIDE; эмитит `UPDATE_STATE` с `{ currentArrowVerticalItem }` и `UPDATE_FAST`. |
58
+ | `mainmenu.backgrounds` | Наследует `@vnejs/module.controller.backgrounds`: ротация `BACKGROUNDS`, preload и таймер; эмитит `UPDATE_STATE` и `UPDATE_FAST`. |
60
59
  | `mainmenu.preload` | Наследует `@vnejs/module.controller.preload`: по SHOW / PRELOAD / MEMORY.CLEARED грузит `PRELOAD_LABELS` и `PRELOAD_EVENTS`. |
61
60
  | `mainmenu.scenario` | LINE_EXEC → SHOW, LINE_LOAD → PRELOAD. |
62
61
  | `mainmenu` | Обрабатывает ITEMS и CLICK. |
package/plugins/views.screens/mainmenu.socials.md CHANGED
@@ -8,9 +8,12 @@
8
8
 
9
9
  Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.screens.mainmenu.socials`.
10
10
 
11
- | Ключ | Строка | Смысл |
12
- | -------- | ----------------------------- | ----------------------------------- |
13
- | `UPDATE` | `vne:mainmenu_socials:update` | Обновить состояние или отображение. |
11
+ | Ключ | Строка | Смысл |
12
+ | -------------- | ----------------------------------- | ----------------------------------------------- |
13
+ | `UPDATE` | `vne:mainmenu_socials:update` | Обновить состояние или отображение. |
14
+ | `UPDATE_FAST` | `vne:mainmenu_socials:update_fast` | Быстрое обновление отображения. |
15
+ | `UPDATE_FORCE` | `vne:mainmenu_socials:update_force` | Перерисовать view с `isForce`, стейт не меняет. |
16
+ | `UPDATE_STATE` | `vne:mainmenu_socials:update_state` | Слить partial в стейт контроллера. |
14
17
 
15
18
  ## Константы
16
19
 
package/plugins/views.screens/save.md CHANGED
@@ -13,7 +13,6 @@ Payloads и результаты хендлеров типизированы ч
13
13
  | Ключ | Строка | Смысл |
14
14
  | ------------------- | --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
15
15
  | `SHOW` | `vne:save_view:show` | Показать UI или слой. |
16
- | `SHOW_BEFORE` | `vne:save_view:show_before` | Хук перед показом: `save.controller.bg` пишет `bgSrc` в стейт. |
17
16
  | `HIDE` | `vne:save_view:hide` | Скрыть UI или слой. |
18
17
  | `PAGE_SET` | `vne:save_view:page_set` | Абсолютный прыжок пагинации UI (`{ pageIndex }`). |
19
18
  | `TAB_SET` | `vne:save_view:tab_set` | Выбрать вкладку save/load/autosave (`{ tab }`). |
@@ -22,13 +21,14 @@ Payloads и результаты хендлеров типизированы ч
22
21
  | `LOAD` | `vne:save_view:load` | Загрузить слот (`{ key, group }`) → `SAVE.PRELOAD` / `SAVE.LOAD`. |
23
22
  | `UPDATE` | `vne:save_view:update` | Обновить состояние или отображение. |
24
23
  | `UPDATE_FAST` | `vne:save_view:update_fast` | Перерисовать view с `isFast`, без смены стейта. |
24
+ | `UPDATE_FORCE` | `vne:save_view:update_force` | Перерисовать view с `isForce`, стейт не меняет. |
25
25
  | `PRELOAD` | `vne:save_view:preload` | Событие `PRELOAD` namespace плагина. |
26
26
  | `ACCEPT` | `vne:save_view:accept` | ACCEPT / INTERACT по выбранному слоту. |
27
- | `STATE_UPDATE` | `vne:save_view:state_update` | Слить partial в стейт controller/accept/grid без UPDATE view. |
27
+ | `UPDATE_STATE` | `vne:save_view:update_state` | Слить partial в стейт controller/accept/grid без UPDATE view. |
28
28
  | `GRID_NEXT` | `vne:save_view:grid_next` | Край сетки вперёд; `save.controller.pages` слушает как `EVENT_PAGE_NEXT` (намеренный мост, без знания сетки в pages). |
29
29
  | `GRID_PREV` | `vne:save_view:grid_prev` | Край сетки назад; `save.controller.pages` слушает как `EVENT_PAGE_PREV`. |
30
- | `GRID_CLEAR` | `vne:save_view:grid_clear` | Сбросить выбор ячейки: `gridRow` / `gridColumn` → `null` (+ `STATE_UPDATE`). |
31
- | `GRID_UPDATE_ITEMS` | `vne:save_view:grid_update_items` | Пересобрать сетку из стейта (без payload) → `STATE_UPDATE` `{ gridItems }`. Meta (`gridIndex` / `gridsCount` / `tab`) — заранее через `STATE_UPDATE`. |
30
+ | `GRID_CLEAR` | `vne:save_view:grid_clear` | Сбросить выбор ячейки: `gridRow` / `gridColumn` → `null` (+ `UPDATE_STATE`). |
31
+ | `GRID_UPDATE_ITEMS` | `vne:save_view:grid_update_items` | Пересобрать сетку из стейта (без payload) → `UPDATE_STATE` `{ gridItems }`. Meta (`gridIndex` / `gridsCount` / `tab`) — заранее через `UPDATE_STATE`. |
32
32
  | `SLOT_CREATE` | `vne:save_view:slot_create` | Собрать UI-слот → `SAVE.GET` + дата/время; result: `SaveViewSlotCreateResult`. |
33
33
 
34
34
  ## Константы
@@ -51,16 +51,16 @@ Payloads и результаты хендлеров типизированы ч
51
51
  | Модуль | Зона ответственности |
52
52
  | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
53
53
  | `save.controller.audio` | Наследник `ModuleControllerAudio`: SHOW/HIDE/PRELOAD → pause global, play/stop `view`-трека; `VOLUME_SETTING = MUSIC.VOLUME`; SHOW передаёт в `AUDIO.PLAY` уже посчитанный `volume`; при `VOLUME_CHANGED` / смене `VOLUME_SETTING` — повторный `AUDIO.VOLUME`. |
54
- | `save.controller` | SHOW/HIDE; `beforeShow` → `SHOW_BEFORE` + `TAB_SET`; `STATE_UPDATE` / `UPDATE_FAST`; пустой `controls` на `ZINDEX`. |
55
- | `save.controller.bg` | Наследует `@vnejs/module.controller.bg`: `SHOW_BEFORE` → `bgSrc`; PRELOAD / `start`; `MEMORY.CLEARED` — preload и refresh при `isShow`. |
54
+ | `save.controller` | SHOW/HIDE по фазам `CONST.COMPONENTS.LIFECYCLE_PRIORITY`; на `SHOW.BEFORE` — `TAB_SET`. `UPDATE_STATE` / `UPDATE_FAST`; пустой `controls` на `ZINDEX`. |
55
+ | `save.controller.bg` | Наследует `@vnejs/module.controller.bg`: `SHOW` + `LIFECYCLE_PRIORITY.SHOW.BEFORE` → `bgSrc`; PRELOAD / `start`; `MEMORY.CLEARED` — preload и refresh при `isShow`. |
56
56
  | `save.controller.actions` | CREATE → `SAVE.CREATE`, DELETE → `SAVE.DELETE`; `group` из payload или `getSaveGroup` (autosave / `pageIndex`); затем `GRID_UPDATE_ITEMS` + `UPDATE_FAST`. |
57
- | `save.controller.pages` | Наследует `@vnejs/module.controller.pages`: `EVENT_*` → `SAVE_VIEW`; `applyPage` → `STATE_UPDATE` `{ gridIndex, gridsCount }` + `GRID_UPDATE_ITEMS`; `init` пишет `pagesCount`. |
58
- | `save.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CREATE` на вкладке save, иначе `LOAD` при `screen`; зеркалит `STATE_UPDATE`; PUSH/POP на SHOW/HIDE. |
59
- | `save.controller.grid` | Наследует `@vnejs/module.controller.arrows.grid`: четыре стрелки; `isDisableGridChangeVertical = true` (вертикаль не листает страницы); на краю колонок — `GRID_NEXT`/`PREV`; `GRID_CLEAR`; `GRID_UPDATE_ITEMS` → `getGridItems` / `STATE_UPDATE` `{ gridItems }`. |
57
+ | `save.controller.pages` | Наследует `@vnejs/module.controller.pages`: `EVENT_*` → `SAVE_VIEW`; `applyPage` → `UPDATE_STATE` `{ gridIndex, gridsCount }` + `GRID_UPDATE_ITEMS`; `init` пишет `pagesCount`. |
58
+ | `save.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CREATE` на вкладке save, иначе `LOAD` при `screen`; зеркалит `UPDATE_STATE`; PUSH/POP на SHOW/HIDE. |
59
+ | `save.controller.grid` | Наследует `@vnejs/module.controller.arrows.grid`: четыре стрелки; `isDisableGridChangeVertical = true` (вертикаль не листает страницы); на краю колонок — `GRID_NEXT`/`PREV`; `GRID_CLEAR`; `GRID_UPDATE_ITEMS` → `getGridItems` / `UPDATE_STATE` `{ gridItems }`. |
60
60
  | `save.view.slot` | На `SLOT_CREATE` собирает UI-слот: `SAVE.GET` → `screen` / `ts` / `date` / `time` / `locKey`. |
61
61
  | `save.hide.controls` | Наследует `@vnejs/module.controller.hide.on.controls`: `BACK` / `MENU` / `GAMEMENU` → `HIDE`; PUSH/POP на SHOW/HIDE. |
62
62
  | `save.hide.state` | Наследует `@vnejs/module.controller.hide.on.state`: `STATE.SET` / `STATE.CLEAR` → `HIDE` с `{ isForce: true }`. |
63
- | `save.controller.tabs` | Наследник `ModuleControllerTabs`: `TAB_SET` → `applyTab` + `onTabSet` (`pageIndex: 0`, `GRID_CLEAR`, `STATE_UPDATE` `{ gridIndex, gridsCount }`, `GRID_UPDATE_ITEMS`, опционально `UPDATE_FAST`); TAB_PREV/TAB_NEXT → `TAB_SET`; `getTabKeys` фильтрует SAVE vs LOAD/AUTOSAVE. |
63
+ | `save.controller.tabs` | Наследник `ModuleControllerTabs`: `TAB_SET` → `applyTab` + `onTabSet` (`pageIndex: 0`, `GRID_CLEAR`, `UPDATE_STATE` `{ gridIndex, gridsCount }`, `GRID_UPDATE_ITEMS`, опционально `UPDATE_FAST`); TAB_PREV/TAB_NEXT → `TAB_SET`; `getTabKeys` фильтрует SAVE vs LOAD/AUTOSAVE. |
64
64
  | `save.controller.load` | Подмодуль `controller.load` плагина. |
65
65
  | `save.view` | Подмодуль `view` плагина. |
66
66
 
package/plugins/views.screens/settings.defaults.md CHANGED
@@ -10,17 +10,17 @@ Breaking: раньше namespace был `SETTINGS_DEFAULTS`, события `vne
10
10
 
11
11
  Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.screens.settings.defaults`.
12
12
 
13
- | Ключ | Строка | Смысл |
14
- | -------------- | ---------------------------------------- | --------------------------------------- |
15
- | `UPDATE` | `vne:settings_default_view:update` | Обновить состояние или отображение. |
16
- | `UPDATE_FAST` | `vne:settings_default_view:update_fast` | Перерисовать view с `isFast`. |
17
- | `SHOW` | `vne:settings_default_view:show` | Показать UI или слой. |
18
- | `SHOW_BEFORE` | `vne:settings_default_view:show_before` | Хук перед показом: пишет `bgSrc`. |
19
- | `HIDE` | `vne:settings_default_view:hide` | Скрыть UI или слой. |
20
- | `CONFIRM` | `vne:settings_default_view:confirm` | Продвинуть сценарий к следующей строке. |
21
- | `STATE_UPDATE` | `vne:settings_default_view:state_update` | Слить partial в стейт. |
22
-
23
- На `SHOW_BEFORE` fields-модуль эмитит `SETTINGS_VIEW.SHOW` с `{ tab: TABS[CONST.SETTINGS_VIEW.DEFAULT_TAB], tabKey: CONST.SETTINGS_VIEW.DEFAULT_TAB, locs }`; на `HIDE` — `SETTINGS_VIEW.HIDE`.
13
+ | Ключ | Строка | Смысл |
14
+ | -------------- | ---------------------------------------- | ----------------------------------------------- |
15
+ | `UPDATE` | `vne:settings_default_view:update` | Обновить состояние или отображение. |
16
+ | `UPDATE_FAST` | `vne:settings_default_view:update_fast` | Перерисовать view с `isFast`. |
17
+ | `UPDATE_FORCE` | `vne:settings_default_view:update_force` | Перерисовать view с `isForce`, стейт не меняет. |
18
+ | `SHOW` | `vne:settings_default_view:show` | Показать UI или слой. |
19
+ | `HIDE` | `vne:settings_default_view:hide` | Скрыть UI или слой. |
20
+ | `CONFIRM` | `vne:settings_default_view:confirm` | Продвинуть сценарий к следующей строке. |
21
+ | `UPDATE_STATE` | `vne:settings_default_view:update_state` | Слить partial в стейт. |
22
+
23
+ На `SHOW` с `CONST.COMPONENTS.LIFECYCLE_PRIORITY.SHOW.BEFORE` fields-модуль эмитит `SETTINGS_VIEW.SHOW` с `{ tab: TABS[CONST.SETTINGS_VIEW.DEFAULT_TAB], tabKey: CONST.SETTINGS_VIEW.DEFAULT_TAB, locs }`. На `HIDE` с `LIFECYCLE_PRIORITY.HIDE.BEFORE` — `SETTINGS_VIEW.HIDE`.
24
24
 
25
25
  ## Константы
26
26
 
@@ -40,14 +40,14 @@ Payloads и результаты хендлеров типизированы ч
40
40
 
41
41
  ## Модули
42
42
 
43
- | Модуль | Зона ответственности |
44
- | ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
45
- | `settings.default.controller` | SHOW/HIDE; `beforeShow` → `SHOW_BEFORE`; `STATE_UPDATE` / `UPDATE_FAST`. |
46
- | `settings.default.controller.bg` | Наследует `@vnejs/module.controller.bg`: `SHOW_BEFORE` → `bgSrc`; `MEMORY.CLEARED` при `isShow` → refresh. |
47
- | `settings.default.controller.fields` | На `SHOW_BEFORE`: `STATE_UPDATE` `{ tab }` + `SETTINGS_VIEW.SHOW` с `CONST.SETTINGS_VIEW.DEFAULT_TAB`. |
43
+ | Модуль | Зона ответственности |
44
+ | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
45
+ | `settings.default.controller` | SHOW/HIDE по фазам `CONST.COMPONENTS.LIFECYCLE_PRIORITY`; на `HIDE.BEFORE` — `SETTINGS_VIEW.HIDE`. `UPDATE_STATE` / `UPDATE_FAST`. |
46
+ | `settings.default.controller.bg` | Наследует `@vnejs/module.controller.bg`: `SHOW` + `LIFECYCLE_PRIORITY.SHOW.BEFORE` → `bgSrc`; `MEMORY.CLEARED` при `isShow` → refresh. |
47
+ | `settings.default.controller.fields` | На `SHOW` + `LIFECYCLE_PRIORITY.SHOW.BEFORE`: `UPDATE_STATE` `{ tab }` + `SETTINGS_VIEW.SHOW` с `CONST.SETTINGS_VIEW.DEFAULT_TAB`. |
48
48
  | `settings.default.controller.accept` | Наследует `@vnejs/module.controller.accept`: только `ACCEPT` (`IS_INTERACT_ENABLED = false`) → `CONFIRM` → `INITED`, `HIDE`, `emit SCENARIO.NEXT`; PUSH/POP на SHOW/HIDE. |
49
49
  | `settings.default` | `SETTINGS.INIT` INITED в `setup`; `LINE_EXEC` как `$ settings.defaults` → `SHOW`, либо `emit SCENARIO.NEXT` при `skip_if_possible` и `INITED`. |
50
- | `settings.default.view` | Chrome: title + кнопка Accept. |
50
+ | `settings.default.view` | Chrome: title + кнопка Accept. |
51
51
 
52
52
  ## Близкие плагины
53
53
 
package/plugins/views.screens/settings.md CHANGED
@@ -8,18 +8,18 @@
8
8
 
9
9
  Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.screens.settings`.
10
10
 
11
- | Ключ | Строка | Смысл |
12
- | -------------- | --------------------------------------- | ----------------------------------------------------------------------------------- |
13
- | `SHOW` | `vne:settings_screen_view:show` | Показать UI или слой. |
14
- | `SHOW_BEFORE` | `vne:settings_screen_view:show_before` | Хук перед показом: bg + `settings.screen.controller.fields` → `SETTINGS_VIEW.SHOW`. |
15
- | `HIDE` | `vne:settings_screen_view:hide` | Скрыть UI или слой. |
16
- | `UPDATE` | `vne:settings_screen_view:update` | Обновить состояние или отображение. |
17
- | `UPDATE_FAST` | `vne:settings_screen_view:update_fast` | Перерисовать view с `isFast`, без смены стейта. |
18
- | `PRELOAD` | `vne:settings_screen_view:preload` | Событие `PRELOAD` namespace плагина. |
19
- | `TAB_SET` | `vne:settings_screen_view:tab_set` | Выбрать вкладку по ключу из `PARAMS.SETTINGS_VIEW.TABS` (`{ tab: string }`). |
20
- | `STATE_UPDATE` | `vne:settings_screen_view:state_update` | Слить partial в стейт (в т.ч. `{ tab }` из tabs-модуля). |
21
-
22
- На `SHOW_BEFORE` fields-модуль эмитит `SETTINGS_VIEW.SHOW` с `{ tab, tabs, tabKey, locs }`; на `TAB_SET` экрана tabs-модуль шлёт `STATE_UPDATE` `{ tab }`, затем `UPDATE_FAST` (chrome) и `SETTINGS_VIEW.TAB_SET` (контент); на `HIDE` — `SETTINGS_VIEW.HIDE`.
11
+ | Ключ | Строка | Смысл |
12
+ | -------------- | --------------------------------------- | ---------------------------------------------------------------------------- |
13
+ | `SHOW` | `vne:settings_screen_view:show` | Показать UI или слой. |
14
+ | `HIDE` | `vne:settings_screen_view:hide` | Скрыть UI или слой. |
15
+ | `UPDATE` | `vne:settings_screen_view:update` | Обновить состояние или отображение. |
16
+ | `UPDATE_FAST` | `vne:settings_screen_view:update_fast` | Перерисовать view с `isFast`, без смены стейта. |
17
+ | `UPDATE_FORCE` | `vne:settings_screen_view:update_force` | Перерисовать view с `isForce`, стейт не меняет. |
18
+ | `PRELOAD` | `vne:settings_screen_view:preload` | Событие `PRELOAD` namespace плагина. |
19
+ | `TAB_SET` | `vne:settings_screen_view:tab_set` | Выбрать вкладку по ключу из `PARAMS.SETTINGS_VIEW.TABS` (`{ tab: string }`). |
20
+ | `UPDATE_STATE` | `vne:settings_screen_view:update_state` | Слить partial в стейт (в т.ч. `{ tab }` из tabs-модуля). |
21
+
22
+ На `SHOW` с `CONST.COMPONENTS.LIFECYCLE_PRIORITY.SHOW.BEFORE` fields-модуль и фон готовят экран: fields эмитит `SETTINGS_VIEW.SHOW` с `{ tab, tabs, tabKey, locs }`. На `TAB_SET` экрана tabs-модуль шлёт `UPDATE_STATE` `{ tab }`, затем `UPDATE_FAST` (chrome) и `SETTINGS_VIEW.TAB_SET` (контент). На `HIDE` с `LIFECYCLE_PRIORITY.HIDE.BEFORE` — `SETTINGS_VIEW.HIDE`.
23
23
 
24
24
  ## Константы
25
25
 
@@ -44,9 +44,9 @@ Payloads и результаты хендлеров типизированы ч
44
44
  | Модуль | Зона ответственности |
45
45
  | ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
46
46
  | `settings.screen.controller.audio` | Наследник `ModuleControllerAudio`: SHOW/HIDE/PRELOAD → pause global, play/stop `view`-трека; `VOLUME_SETTING = MUSIC.VOLUME`; SHOW передаёт в `AUDIO.PLAY` уже посчитанный `volume`; при `VOLUME_CHANGED` / смене `VOLUME_SETTING` — повторный `AUDIO.VOLUME`. |
47
- | `settings.screen.controller` | SHOW/HIDE; `beforeShow` → `SHOW_BEFORE`; `STATE_UPDATE` → `updateState`; `UPDATE_FAST`. Пустой `controls` на `ZINDEX`. |
48
- | `settings.screen.controller.bg` | Наследует `@vnejs/module.controller.bg`: `SHOW_BEFORE` → `bgSrc`; PRELOAD; `MEMORY.CLEARED` — preload и refresh при `isShow`. |
49
- | `settings.screen.controller.fields` | На `SHOW_BEFORE`: фильтр tabs (`showInSettings`) → `STATE_UPDATE` `{ tabs, tab }` → `SETTINGS_VIEW.SHOW`. |
47
+ | `settings.screen.controller` | SHOW/HIDE по фазам `CONST.COMPONENTS.LIFECYCLE_PRIORITY`; на `HIDE.BEFORE` эмитит `SETTINGS_VIEW.HIDE`. `UPDATE_STATE` → `updateState`; `UPDATE_FAST`. Пустой `controls` на `ZINDEX`. |
48
+ | `settings.screen.controller.bg` | Наследует `@vnejs/module.controller.bg`: `SHOW` + `LIFECYCLE_PRIORITY.SHOW.BEFORE` → `bgSrc`; PRELOAD; `MEMORY.CLEARED` — preload и refresh при `isShow`. |
49
+ | `settings.screen.controller.fields` | На `SHOW` + `LIFECYCLE_PRIORITY.SHOW.BEFORE`: фильтр tabs (`showInSettings`) → `UPDATE_STATE` `{ tabs, tab }` → `SETTINGS_VIEW.SHOW`. |
50
50
  | `settings.screen.hide.controls` | Наследует `@vnejs/module.controller.hide.on.controls`: `BACK` / `MENU` / `GAMEMENU` → `HIDE`; PUSH/POP на SHOW/HIDE. |
51
51
  | `settings.screen.hide.state` | Наследует `@vnejs/module.controller.hide.on.state`: `STATE.SET` / `STATE.CLEAR` → `HIDE` с `{ isForce: true }`. |
52
52
  | `settings.screen.controller.tabs` | Наследник `ModuleControllerTabs`: `TAB_SET` → `applyTab` + `onTabSet` (`UPDATE_FAST`, затем `SETTINGS_VIEW.TAB_SET`); TAB_PREV/TAB_NEXT → `TAB_SET`; `getTabKeys` по `showInSettings`. |