@vnejs/docs 0.2.17 → 0.2.19

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 (19) hide show
  1. package/CHANGELOG.md +26 -0
  2. package/README.md +1 -0
  3. package/architecture.md +13 -1
  4. package/manifest.json +4 -0
  5. package/package.json +2 -1
  6. package/plugins/views/comment.md +1 -0
  7. package/plugins/views/settings.md +1 -1
  8. package/plugins/views.scenario/choose.md +7 -2
  9. package/plugins/views.screens/confirm.md +4 -1
  10. package/plugins/views.screens/eula.md +3 -2
  11. package/plugins/views.screens/gallery.full.md +2 -1
  12. package/plugins/views.screens/gallery.md +3 -2
  13. package/plugins/views.screens/gamemenu.md +8 -2
  14. package/plugins/views.screens/history.md +7 -2
  15. package/plugins/views.screens/mainmenu.md +4 -1
  16. package/plugins/views.screens/mainmenu.socials.md +2 -3
  17. package/plugins/views.screens/save.md +3 -2
  18. package/plugins/views.screens/settings.defaults.md +3 -2
  19. package/plugins/views.screens/settings.md +3 -2
package/CHANGELOG.md ADDED
@@ -0,0 +1,26 @@
1
+ # Changelog
2
+
3
+ Краткая история изменений плагинов и внешнего API. Версии — релизы пакета `@vnejs/docs`.
4
+
5
+ ## 0.2.19
6
+
7
+ - `views.screens/gamemenu` — вертикальные стрелки в модуле `gameMenu.controller.arrows` на `@vnejs/module.controller.arrows.vertical`; индекс в стейте `currentArrowVerticalItem`. `ACCEPT` / `INTERACT` и хендлер `ACCEPT` → `CLICK` в `gameMenu.controller.accept` на `@vnejs/module.controller.accept`. `BACK` / `MENU` / `GAMEMENU` → `HIDE` в `gameMenu.hide.controls` на `@vnejs/module.controller.hide.on.controls`. `STATE.SET` / `STATE.CLEAR` эмитят `HIDE` с `{ isForce: true }` из модуля `gameMenu.hide.state` на `@vnejs/module.controller.hide.on.state`. API: `EVENTS.GAMEMENU.STATE_UPDATE`, `EVENTS.GAMEMENU.UPDATE_FAST`.
8
+ - `views.screens/history` — вертикальные стрелки в модуле `history.controller.arrows` на `@vnejs/module.controller.arrows.vertical`; индекс в стейте `currentArrowVerticalItem`. `ACCEPT` / `INTERACT` и хендлер `ACCEPT` → `CLICK` в `history.controller.accept` на `@vnejs/module.controller.accept`. `BACK` / `MENU` / `GAMEMENU` → `HIDE` в `history.hide.controls` на `@vnejs/module.controller.hide.on.controls`. API: `EVENTS.HISTORY.STATE_UPDATE`, `EVENTS.HISTORY.UPDATE_FAST`.
9
+ - `views.screens/settings` — `BACK` / `MENU` / `GAMEMENU` → `HIDE` в `settings.hide.controls` на `@vnejs/module.controller.hide.on.controls`.
10
+ - `views.screens/gallery` — `BACK` / `MENU` / `GAMEMENU` → `HIDE` в `gallery.hide.controls` на `@vnejs/module.controller.hide.on.controls`.
11
+ - `views.screens/gallery.full` — `BACK` / `MENU` / `GAMEMENU` → `HIDE` в `gallery.full.hide.controls` на `@vnejs/module.controller.hide.on.controls`.
12
+ - `views.screens/save` — `BACK` / `MENU` / `GAMEMENU` → `HIDE` в `save.hide.controls` на `@vnejs/module.controller.hide.on.controls`.
13
+ - `views.scenario/choose` — вертикальные стрелки в модуле `choose_view.controller.arrows` на `@vnejs/module.controller.arrows.vertical`; скип `hided` через `isArrowItemAvailable` (индекс исходный). `ACCEPT` / `INTERACT` → `CHOOSE.OPTION` в `choose_view.controller.accept` на `@vnejs/module.controller.accept`. API: `EVENTS.CHOOSE_VIEW.STATE_UPDATE`, `EVENTS.CHOOSE_VIEW.UPDATE_FAST`, `EVENTS.CHOOSE_VIEW.ACCEPT`.
14
+ - `views.screens/confirm` — `ACCEPT` / `INTERACT` в `confirm.controller.accept` на `@vnejs/module.controller.accept`: при `currentItem` — `ACCEPT` (0) или `DECLINE` (иначе), без выделения — `ACCEPT`. API: `EVENTS.CONFIRM.SUBMIT`, `EVENTS.CONFIRM.STATE_UPDATE`.
15
+ - `views.screens/eula` — `ACCEPT` (`IS_INTERACT_ENABLED = false`) в `eula.controller.accept` на `@vnejs/module.controller.accept` → `EULA.ACCEPT` → `ACCEPTED_VERSION`, `HIDE`.
16
+ - `views.screens/settings.defaults` — `ACCEPT` (`IS_INTERACT_ENABLED = false`) в `settings.defaults.controller.accept` на `@vnejs/module.controller.accept` → `CONFIRM` → `INITED`, `HIDE`, `emitNext`.
17
+ - `views/comment` — `STATE.SET` / `STATE.CLEAR` эмитят `HIDE` с `{ isForce: true }` из модуля `comment.hide` на `@vnejs/module.controller.hide.on.state`.
18
+ - `views.screens/mainmenu.socials` — прямые подписки на `STATE.SET` / `STATE.CLEAR` сняты; hide идёт через `MAINMENU.HIDE` от `mainmenu.hide`.
19
+
20
+ ## 0.2.18
21
+
22
+ - `views.screens/mainmenu` — вертикальные стрелки в модуле `mainmenu.controller.arrows` на `@vnejs/module.controller.arrows.vertical`; индекс в стейте `currentArrowVerticalItem` (ACCEPT читает его, не `currentItem` базы). Кнопки `ACCEPT` / `INTERACT` и хендлер `ACCEPT` → `CLICK` в `mainmenu.controller.accept` на `@vnejs/module.controller.accept` (зеркало `STATE_UPDATE`). `mainmenu.controller` пушит пустой `controls` на `ZINDEX`, чтобы стопорить слои ниже. `STATE.SET` / `STATE.CLEAR` эмитят `HIDE` с `{ isForce: true }` из модуля `mainmenu.hide` на `@vnejs/module.controller.hide.on.state`. Accept / arrows / backgrounds больше не слушают `STATE.SET` / `STATE.CLEAR` напрямую — только `HIDE`.
23
+ - `views/settings` — горизонтальная навигация TextControls: стрелки циклят `options` (`selector_texts` сразу `SETTINGS.SET`), `INTERACT` для `actions` без `settingKey`.
24
+ - `views.screens/settings` — overlay-BGM на SHOW стартует с громкостью `SETTINGS.MUSIC.VOLUME`.
25
+ - `views.screens/gallery` — overlay-BGM на SHOW стартует с громкостью `SETTINGS.MUSIC.VOLUME`.
26
+ - `views.screens/save` — overlay-BGM на SHOW стартует с громкостью `SETTINGS.MUSIC.VOLUME`.
package/README.md CHANGED
@@ -28,6 +28,7 @@ npm i @vnejs/docs
28
28
  - [Сценарий — guide](./scenario.guide/README.md) — синтаксис `.vne` и тематические гайды
29
29
  - [Сценарий — catalog](./scenario.catalog/README.md) — каталог `$` / `%` команд
30
30
  - [Архитектура](./architecture.md) — каталоги монорепы и их связи, mermaid-диаграммы
31
+ - [Changelog](./CHANGELOG.md) — изменения плагинов и API по версиям `@vnejs/docs`
31
32
 
32
33
  ## Быстрый ориентир по монорепе
33
34
 
package/architecture.md CHANGED
@@ -136,6 +136,10 @@ flowchart TD
136
136
  MCT["@vnejs/module.controller.tabs"]
137
137
  MCP["@vnejs/module.controller.preload"]
138
138
  MCB["@vnejs/module.controller.backgrounds"]
139
+ MCAC["@vnejs/module.controller.accept"]
140
+ MCAV["@vnejs/module.controller.arrows.vertical"]
141
+ MCHS["@vnejs/module.controller.hide.on.state"]
142
+ MCHC["@vnejs/module.controller.hide.on.controls"]
139
143
  MSC["@vnejs/module.scales.common"]
140
144
 
141
145
  M --> MC
@@ -148,6 +152,10 @@ flowchart TD
148
152
  MC --> MCT
149
153
  MC --> MCP
150
154
  MC --> MCB
155
+ MC --> MCAC
156
+ MC --> MCAV
157
+ MC --> MCHS
158
+ MC --> MCHC
151
159
  MC --> MSC
152
160
  MCO --> ML
153
161
  ```
@@ -165,7 +173,11 @@ flowchart TD
165
173
  | **`@vnejs/module.controller.audio`** | Overlay-BGM для view-экранов: pause global / play `view` / resume на SHOW/HIDE/PRELOAD |
166
174
  | **`@vnejs/module.controller.tabs`** | Навигация по вкладкам view-экранов: TAB_PREV/TAB_NEXT → `TAB_SET`, PUSH/POP controls на SHOW/HIDE |
167
175
  | **`@vnejs/module.controller.preload`** | Предзагрузка меток и событий экрана по SHOW / PRELOAD / MEMORY.CLEARED; SHOW/HIDE/PRELOAD задаёт плагин |
168
- | **`@vnejs/module.controller.backgrounds`** | Ротация списка фонов по SHOW / таймеру / MEMORY.CLEARED; стоп на HIDE и STATE.SET/CLEAR; события и список задаёт плагин |
176
+ | **`@vnejs/module.controller.backgrounds`** | Ротация списка фонов по SHOW / таймеру / MEMORY.CLEARED; стоп на HIDE; события и список задаёт плагин |
177
+ | **`@vnejs/module.controller.accept`** | ACCEPT / INTERACT → событие ACCEPT плагина; PUSH/POP controls на SHOW/HIDE |
178
+ | **`@vnejs/module.controller.arrows.vertical`** | ARROW_UP / ARROW_BOTTOM по видимым пунктам; PUSH/POP controls на SHOW/HIDE |
179
+ | **`@vnejs/module.controller.hide.on.state`** | STATE.SET / STATE.CLEAR → emit HIDE плагина (`isForce` задаёт наследник) |
180
+ | **`@vnejs/module.controller.hide.on.controls`** | BACK / MENU / GAMEMENU → emit HIDE плагина; PUSH/POP controls на SHOW/HIDE |
169
181
  | **`@vnejs/module.scales.common`** | База для scales / RPG-модулей |
170
182
 
171
183
  ### Принципы
package/manifest.json CHANGED
@@ -39,6 +39,10 @@
39
39
  "architecture": {
40
40
  "path": "architecture.md",
41
41
  "role": "Monorepo architecture (read rarely for scenario authoring)"
42
+ },
43
+ "changelog": {
44
+ "path": "CHANGELOG.md",
45
+ "role": "Plugin and API changes by @vnejs/docs version"
42
46
  }
43
47
  }
44
48
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@vnejs/docs",
3
- "version": "0.2.17",
3
+ "version": "0.2.19",
4
4
  "description": "VNEJS documentation for engine consumers and coding agents",
5
5
  "files": [
6
6
  "*.md",
@@ -13,6 +13,7 @@
13
13
  "./package.json": "./package.json",
14
14
  "./manifest.json": "./manifest.json",
15
15
  "./README.md": "./README.md",
16
+ "./CHANGELOG.md": "./CHANGELOG.md",
16
17
  "./architecture.md": "./architecture.md",
17
18
  "./plugins/*": "./plugins/*",
18
19
  "./scenario.guide/*": "./scenario.guide/*",
package/plugins/views/comment.md CHANGED
@@ -34,6 +34,7 @@
34
34
  |--------|----------------------|
35
35
  | `comment` | Модуль `comment`. |
36
36
  | `comment.controller` | Обрабатывает UPDATE, SHOW, HIDE, EXTERNAL_UPDATE, …. |
37
+ | `comment.hide` | Наследует `@vnejs/module.controller.hide.on.state`: `STATE.SET` / `STATE.CLEAR` → `HIDE` с `{ isForce: true }`. |
37
38
  | `comment.view` | Подмодуль `view` плагина. |
38
39
 
39
40
  ## Близкие плагины
package/plugins/views/settings.md CHANGED
@@ -37,7 +37,7 @@
37
37
 
38
38
  | Модуль | Зона ответственности |
39
39
  |--------|----------------------|
40
- | `settings.fields.controller` | `SHOW`/`HIDE`/`TAB_SET`; `ARROW_*` / `INTERACT`→применить option/toggle; `SETTINGS.SET`. `ACCEPT` не обрабатывает — оставляют экраны. |
40
+ | `settings.fields.controller` | `SHOW`/`HIDE`/`TAB_SET`; `ARROW_UP`/`ARROW_BOTTOM` по полям. На `selector_texts` / `actions` (`options`): `ARROW_LEFT`/`ARROW_RIGHT` циклят `currentItemInner` (modulo); у `selector_texts` сразу `SETTINGS.SET`. `INTERACT` — option value или named action (в т.ч. `actions` без `settingKey`). `ACCEPT` не обрабатывает — оставляют экраны. |
41
41
  | `settings.fields.view` | Обёртка `<View {...propsView} />` (fade show/hide); внутри вкладки `<SettingsTabContent />` с `PositionBox opacity` для crossfade по `tabKey`. |
42
42
 
43
43
  ## Близкие плагины
package/plugins/views.scenario/choose.md CHANGED
@@ -12,6 +12,9 @@ React-UI выбора из текстовых опций. Зависит от sc
12
12
  | `SHOW_BEFORE` | `vne:choose_view:show_before` | Хук перед показом (после загрузки state из `globalState.choose`). |
13
13
  | `HIDE` | `vne:choose_view:hide` | Скрыть UI выбора. |
14
14
  | `UPDATE` | `vne:choose_view:update` | Обновить React-store / отображение. |
15
+ | `STATE_UPDATE` | `vne:choose_view:state_update` | Слить partial в стейт контроллера без UPDATE view. |
16
+ | `UPDATE_FAST` | `vne:choose_view:update_fast` | Перерисовать view с `isFast`, стейт не меняет. |
17
+ | `ACCEPT` | `vne:choose_view:accept` | `ACCEPT` / `INTERACT` → `CHOOSE.OPTION` по `currentArrowVerticalItem`. |
15
18
 
16
19
  Сценарные события (`EMIT`, `OPTION`, `SHOW`, `HIDE`, `SKIP`, `EXEC_*`, `STATE_UPDATE`) — в контракте `@vnejs/contracts.scenario.choose`, namespace `CHOOSE`.
17
20
 
@@ -37,7 +40,9 @@ React-UI выбора из текстовых опций. Зависит от sc
37
40
  | Модуль | Зона ответственности |
38
41
  |--------|----------------------|
39
42
  | `choose_view.bridge` | Bridge `CHOOSE.SHOW/HIDE` → `CHOOSE_VIEW.SHOW/HIDE`. |
40
- | `choose_view.controller` | Controls, emit `CHOOSE.OPTION`, `beforeShow` / `afterHide`. |
43
+ | `choose_view.controller` | `CONTROLS_EXTENSIONS`, `beforeShow` / `afterHide`, зеркало `STATE_UPDATE` / `UPDATE_FAST`. |
44
+ | `choose_view.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CHOOSE.OPTION` по `currentArrowVerticalItem`; зеркалит `STATE_UPDATE`; PUSH/POP на SHOW/HIDE. |
45
+ | `choose_view.controller.arrows` | Наследует `@vnejs/module.controller.arrows.vertical`: `ARROW_UP` / `ARROW_BOTTOM` по полному `options[]`; скипает `hided` через `isArrowItemAvailable` (индекс исходный); PUSH/POP на SHOW/HIDE; эмитит `STATE_UPDATE` с `{ currentArrowVerticalItem }` и `UPDATE_FAST`. |
41
46
  | `choose_view.view` | React-render опций. |
42
47
 
43
48
  ## Связь с CHOOSE
@@ -74,6 +79,6 @@ sequenceDiagram
74
79
 
75
80
  ### Остальные
76
81
 
77
- - [controls.md](../controls/controls.md) — `CONTROLS`: стрелки, ACCEPT
82
+ - [controls.md](../controls/controls.md) — `CONTROLS`: стрелки, ACCEPT, INTERACT
78
83
  - [interface.md](interface.md) — compatibility скрывает interface на `CHOOSE_VIEW.SHOW_BEFORE`
79
84
  - [qte.md](./qte.md) — `QTE_VIEW`: при опции с `qte:` открывается поверх choose (z-index 1300 > 1200)
package/plugins/views.screens/confirm.md CHANGED
@@ -12,8 +12,10 @@
12
12
  | `HIDE` | `vne:confirm:hide` | Скрыть UI или слой. |
13
13
  | `EMIT` | `vne:confirm:emit` | Инициировать действие или цикл. |
14
14
  | `UPDATE` | `vne:confirm:update` | Обновить состояние или отображение. |
15
+ | `STATE_UPDATE` | `vne:confirm:state_update` | Слить `{ currentItem }` в стейт accept-модуля без UPDATE view. |
15
16
  | `ACCEPT` | `vne:confirm:accept` | Событие `ACCEPT` namespace плагина. |
16
17
  | `DECLINE` | `vne:confirm:decline` | Событие `DECLINE` namespace плагина. |
18
+ | `SUBMIT` | `vne:confirm:submit` | `ACCEPT` / `INTERACT`: при `currentItem` — ACCEPT (0) или DECLINE, иначе ACCEPT. |
17
19
 
18
20
  ## Константы
19
21
 
@@ -33,7 +35,8 @@
33
35
 
34
36
  | Модуль | Зона ответственности |
35
37
  |--------|----------------------|
36
- | `confirm.controller` | Обрабатывает UPDATE, ACCEPT, DECLINE, SHOW, …. |
38
+ | `confirm.controller` | SHOW/HIDE; BACK → `DECLINE`; стрелки меняют `currentItem` и эмитят `STATE_UPDATE`. |
39
+ | `confirm.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `SUBMIT` → `ACCEPT` или `DECLINE` по `currentItem`; зеркалит `STATE_UPDATE`; PUSH/POP на SHOW/HIDE. |
37
40
  | `confirm` | Обрабатывает EMIT, ACCEPT, DECLINE. |
38
41
  | `confirm.view` | Подмодуль `view` плагина. |
39
42
 
package/plugins/views.screens/eula.md CHANGED
@@ -36,8 +36,9 @@
36
36
 
37
37
  | Модуль | Зона ответственности |
38
38
  |--------|----------------------|
39
- | `eula.controller` | Обрабатывает UPDATE, SHOW, HIDE, EXTERNAL_UPDATE, …. |
40
- | `eula` | Обрабатывает ACCEPT, EXIT, SHOW. |
39
+ | `eula.controller` | Обрабатывает UPDATE, SHOW, HIDE, EXTERNAL_UPDATE, …. Стрелки по тексту, BACK → `EXIT`. |
40
+ | `eula.controller.accept` | Наследует `@vnejs/module.controller.accept`: только `ACCEPT` (`IS_INTERACT_ENABLED = false`) → `EULA.ACCEPT` → `ACCEPTED_VERSION`, `HIDE`; PUSH/POP на SHOW/HIDE. |
41
+ | `eula` | `MAINMENU.SHOW` → `SHOW` (если версия не принята); `EXIT` → `SYSTEM.CLOSE`. |
41
42
  | `eula.view` | Подмодуль `view` плагина. |
42
43
 
43
44
  ## Близкие плагины
package/plugins/views.screens/gallery.full.md CHANGED
@@ -34,7 +34,8 @@
34
34
 
35
35
  | Модуль | Зона ответственности |
36
36
  |--------|----------------------|
37
- | `gallery.full.controller` | Обрабатывает UPDATE, HIDE, SHOW, CHOOSE. |
37
+ | `gallery.full.controller` | Обрабатывает UPDATE, HIDE, SHOW, CHOOSE. `ARROW_LEFT` / `ARROW_RIGHT` → смена вариации. |
38
+ | `gallery.full.hide.controls` | Наследует `@vnejs/module.controller.hide.on.controls`: `BACK` / `MENU` / `GAMEMENU` → `HIDE`; PUSH/POP на SHOW/HIDE. |
38
39
  | `gallery.full.view` | Подмодуль `full.view` плагина. |
39
40
 
40
41
  ## Близкие плагины
package/plugins/views.screens/gallery.md CHANGED
@@ -49,8 +49,9 @@ ACCEPT/INTERACT эмитит `CHOOSE` только для выбранного
49
49
 
50
50
  | Модуль | Зона ответственности |
51
51
  |--------|----------------------|
52
- | `gallery.controller.audio` | Наследник `ModuleControllerAudio`: SHOW/HIDE/PRELOAD → pause global, play/stop `view`-трека; `VOLUME_SETTING = MUSIC.VOLUME`; при `VOLUME_CHANGED` / смене `VOLUME_SETTING` — повторный `AUDIO.VOLUME`. |
53
- | `gallery.controller` | Обрабатывает UPDATE, HIDE, TAB_SET, …. ACCEPT/INTERACT → `CHOOSE` только если слот открыт. |
52
+ | `gallery.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`. |
53
+ | `gallery.controller` | Обрабатывает UPDATE, HIDE, TAB_SET, …. ACCEPT/INTERACT → `CHOOSE` только если слот открыт. Стрелки и ACCEPT/INTERACT в `controls` контроллера. |
54
+ | `gallery.hide.controls` | Наследует `@vnejs/module.controller.hide.on.controls`: `BACK` / `MENU` / `GAMEMENU` → `HIDE`; PUSH/POP на SHOW/HIDE. |
54
55
  | `gallery.controller.tabs` | Наследник `ModuleControllerTabs`: TAB_PREV/TAB_NEXT → `TAB_SET`; PUSH/POP controls на SHOW/HIDE. |
55
56
  | `gallery` | Обрабатывает OPEN, CHECK, CLEAR. |
56
57
  | `gallery.view` | Подмодуль `view` плагина. |
package/plugins/views.screens/gamemenu.md CHANGED
@@ -12,6 +12,8 @@
12
12
  | `HIDE` | `vne:gamemenu:hide` | Скрыть UI или слой. |
13
13
  | `CLICK` | `vne:gamemenu:click` | Событие `CLICK` namespace плагина. |
14
14
  | `UPDATE` | `vne:gamemenu:update` | Обновить состояние или отображение. |
15
+ | `STATE_UPDATE` | `vne:gamemenu:state_update` | Слить partial в стейт контроллера без UPDATE view. |
16
+ | `UPDATE_FAST` | `vne:gamemenu:update_fast` | Перерисовать view с `isFast`, стейт не меняет. |
15
17
  | `ACCEPT` | `vne:gamemenu:accept` | Событие `ACCEPT` namespace плагина. |
16
18
 
17
19
  ## Константы
@@ -36,7 +38,11 @@
36
38
 
37
39
  | Модуль | Зона ответственности |
38
40
  |--------|----------------------|
39
- | `gameMenu.controller` | Обрабатывает UPDATE, HIDE, ACCEPT, SHOW, …. |
41
+ | `gameMenu.controller` | Обрабатывает UPDATE, HIDE, SHOW, STATE_UPDATE, UPDATE_FAST, …. Пустой `controls` на `ZINDEX`, чтобы стопорить слои ниже. |
42
+ | `gameMenu.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CLICK` по `currentArrowVerticalItem`; зеркалит `STATE_UPDATE`; PUSH/POP на SHOW/HIDE. |
43
+ | `gameMenu.controller.arrows` | Наследует `@vnejs/module.controller.arrows.vertical`: `ARROW_UP` / `ARROW_BOTTOM` по видимым пунктам; PUSH/POP controls на SHOW/HIDE; эмитит `STATE_UPDATE` с `{ currentArrowVerticalItem }` и `UPDATE_FAST`. |
44
+ | `gameMenu.hide.controls` | Наследует `@vnejs/module.controller.hide.on.controls`: `BACK` / `MENU` / `GAMEMENU` → `HIDE`; PUSH/POP на SHOW/HIDE. |
45
+ | `gameMenu.hide.state` | Наследует `@vnejs/module.controller.hide.on.state`: `STATE.SET` / `STATE.CLEAR` → `HIDE` с `{ isForce: true }`. |
40
46
  | `gameMenu` | Модуль `gameMenu`. |
41
47
  | `gameMenu.view` | Подмодуль `view` плагина. |
42
48
 
@@ -49,4 +55,4 @@
49
55
 
50
56
  ### Остальные
51
57
 
52
- - [controls.md](../controls/controls.md) — `CONTROLS`: CONST.BUTTONS.BACK, CONST.BUTTONS.MENU, CONST.BUTTONS.GAMEMENU, CONST.BUTTONS.ACCEPT, CONST.BUTTONS.ARROW_UP, CONST.BUTTONS.ARROW_BOTTOM
58
+ - [controls.md](../controls/controls.md) — `CONTROLS`: CONST.BUTTONS.BACK, CONST.BUTTONS.MENU, CONST.BUTTONS.GAMEMENU, CONST.BUTTONS.ACCEPT, CONST.BUTTONS.INTERACT, CONST.BUTTONS.ARROW_UP, CONST.BUTTONS.ARROW_BOTTOM
package/plugins/views.screens/history.md CHANGED
@@ -17,6 +17,8 @@
17
17
  | `SHOW` | `vne:history:show` | Показать UI или слой. |
18
18
  | `CLICK` | `vne:history:click` | Событие `CLICK` namespace плагина. |
19
19
  | `UPDATE` | `vne:history:update` | Обновить состояние или отображение. |
20
+ | `STATE_UPDATE` | `vne:history:state_update` | Слить partial в стейт контроллера без UPDATE view. |
21
+ | `UPDATE_FAST` | `vne:history:update_fast` | Перерисовать view с `isFast`, стейт не меняет. |
20
22
  | `ACCEPT` | `vne:history:accept` | Событие `ACCEPT` namespace плагина. |
21
23
 
22
24
  ## Константы
@@ -41,7 +43,10 @@
41
43
 
42
44
  | Модуль | Зона ответственности |
43
45
  |--------|----------------------|
44
- | `history.controller` | SHOW/HIDE/ACCEPT/CLICK; перед SHOW резолвит тексты строк (`TEXT.REPLACE`). Для `locKey` — через `PARAMS.HISTORY.LOC_LABEL` (локализация view), иначе через label сценария. |
46
+ | `history.controller` | SHOW/HIDE/CLICK/STATE_UPDATE/UPDATE_FAST; перед SHOW резолвит тексты строк (`TEXT.REPLACE`). Для `locKey` — через `PARAMS.HISTORY.LOC_LABEL` (локализация view), иначе через label сценария. Пустой `controls` на `ZINDEX`, чтобы стопорить слои ниже. |
47
+ | `history.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CLICK` по `currentArrowVerticalItem`; зеркалит `STATE_UPDATE`; PUSH/POP на SHOW/HIDE. |
48
+ | `history.controller.arrows` | Наследует `@vnejs/module.controller.arrows.vertical`: `ARROW_UP` / `ARROW_BOTTOM` по записям журнала; PUSH/POP controls на SHOW/HIDE; эмитит `STATE_UPDATE` с `{ currentArrowVerticalItem }` и `UPDATE_FAST`. |
49
+ | `history.hide.controls` | Наследует `@vnejs/module.controller.hide.on.controls`: `BACK` / `MENU` / `GAMEMENU` → `HIDE`; PUSH/POP на SHOW/HIDE. |
45
50
  | `history` | Обрабатывает ADD, GET, LOAD, BACK, …. |
46
51
  | `history.view` | Подмодуль `view` плагина. |
47
52
 
@@ -65,6 +70,6 @@
65
70
 
66
71
  ### Остальные
67
72
 
68
- - [controls.md](../controls/controls.md) — `CONTROLS`: CONST.BUTTONS.BACK, CONST.BUTTONS.MENU, CONST.BUTTONS.GAMEMENU, CONST.BUTTONS.ARROW_UP, CONST.BUTTONS.ARROW_BOTTOM, CONST.BUTTONS.ACCEPT
73
+ - [controls.md](../controls/controls.md) — `CONTROLS`: CONST.BUTTONS.BACK, CONST.BUTTONS.MENU, CONST.BUTTONS.GAMEMENU, CONST.BUTTONS.ARROW_UP, CONST.BUTTONS.ARROW_BOTTOM, CONST.BUTTONS.ACCEPT, CONST.BUTTONS.INTERACT
69
74
  - [text.md](../text/text.md) — `TEXT`: EVENTS.REPLACE
70
75
  - [choose.md](../scenario/choose.md) — `CHOOSE`: связка через compatibility выше (`OPTION_BEFORE_REG`)
package/plugins/views.screens/mainmenu.md CHANGED
@@ -48,7 +48,10 @@
48
48
 
49
49
  | Модуль | Зона ответственности |
50
50
  |--------|----------------------|
51
- | `mainmenu.controller` | Обрабатывает ACCEPT, UPDATE, SHOW, HIDE, STATE_UPDATE, UPDATE_FAST, UPDATE_FORCE, …. |
51
+ | `mainmenu.controller` | Обрабатывает UPDATE, SHOW, HIDE, STATE_UPDATE, UPDATE_FAST, UPDATE_FORCE, …. На SHOW пушит пустой `controls` на `ZINDEX`, чтобы стопорить слои ниже. |
52
+ | `mainmenu.hide` | Наследует `@vnejs/module.controller.hide.on.state`: `STATE.SET` / `STATE.CLEAR` → `HIDE` с `{ isForce: true }`. |
53
+ | `mainmenu.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CLICK` по `currentArrowVerticalItem`; зеркалит `STATE_UPDATE`; PUSH/POP на SHOW/HIDE. |
54
+ | `mainmenu.controller.arrows` | Наследует `@vnejs/module.controller.arrows.vertical`: `ARROW_UP` / `ARROW_BOTTOM` по видимым пунктам; PUSH/POP controls на SHOW/HIDE; эмитит `STATE_UPDATE` с `{ currentArrowVerticalItem }` и `UPDATE_FAST`. |
52
55
  | `mainmenu.backgrounds` | Наследует `@vnejs/module.controller.backgrounds`: ротация `BACKGROUNDS`, preload и таймер; эмитит `STATE_UPDATE` и `UPDATE_FAST`. |
53
56
  | `mainmenu.preload` | Наследует `@vnejs/module.controller.preload`: по SHOW / PRELOAD / MEMORY.CLEARED грузит `PRELOAD_LABELS` и `PRELOAD_EVENTS`. |
54
57
  | `mainmenu.scenario` | LINE_EXEC → SHOW, LINE_LOAD → PRELOAD. |
package/plugins/views.screens/mainmenu.socials.md CHANGED
@@ -28,7 +28,7 @@
28
28
 
29
29
  | Модуль | Зона ответственности |
30
30
  |--------|----------------------|
31
- | `mainmenu.socials.controller` | Обрабатывает UPDATE, SHOW, HIDE, CLEAR, …. |
31
+ | `mainmenu.socials.controller` | Обрабатывает UPDATE, SHOW, HIDE. Hide на `STATE.SET` / `STATE.CLEAR` идёт через `MAINMENU.HIDE` от `mainmenu.hide`, прямых подписок на `STATE` нет. |
32
32
  | `mainmenu.socials.view` | Подмодуль `socials.view` плагина. |
33
33
 
34
34
  ## Близкие плагины
@@ -36,10 +36,9 @@
36
36
  ### plugins/core/
37
37
 
38
38
  - [memory.md](../core/memory.md) — `MEMORY`: EVENTS.CLEARED
39
- - [state.md](../core/state.md) — `STATE`: EVENTS.CLEAR, EVENTS.SET
40
39
  - [system.md](../core/system.md) — `SYSTEM`: EVENTS.STARTED
41
40
 
42
41
  ### Остальные
43
42
 
44
43
  - [layer.md](../canvas/layer.md) — `LAYER`: SETTINGS.QUALITY
45
- - [mainmenu.md](./mainmenu.md) — `MAINMENU`: EVENTS.SHOW, EVENTS.HIDE, PARAMS.TRANSITION
44
+ - [mainmenu.md](./mainmenu.md) — `MAINMENU`: EVENTS.SHOW, EVENTS.HIDE; hide на STATE через `mainmenu.hide`
package/plugins/views.screens/save.md CHANGED
@@ -39,8 +39,9 @@ ACCEPT/INTERACT повторяет клик по слоту: на вкладке
39
39
 
40
40
  | Модуль | Зона ответственности |
41
41
  |--------|----------------------|
42
- | `save.controller.audio` | Наследник `ModuleControllerAudio`: SHOW/HIDE/PRELOAD → pause global, play/stop `view`-трека; `VOLUME_SETTING = MUSIC.VOLUME`; при `VOLUME_CHANGED` / смене `VOLUME_SETTING` — повторный `AUDIO.VOLUME`. |
43
- | `save.controller` | Обрабатывает UPDATE, HIDE, LOAD, TAB_SET, …. SHOW принимает `{ tab }`; в `SAVE.*` передаёт `group` (номер страницы или `autosave`). ACCEPT/INTERACT: save → `CREATE`, load/autosave → `LOAD` при `screen`. |
42
+ | `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`. |
43
+ | `save.controller` | Обрабатывает UPDATE, HIDE, LOAD, TAB_SET, …. SHOW принимает `{ tab }`; в `SAVE.*` передаёт `group` (номер страницы или `autosave`). ACCEPT/INTERACT: save → `CREATE`, load/autosave → `LOAD` при `screen`. Стрелки и ACCEPT/INTERACT в `controls` контроллера. |
44
+ | `save.hide.controls` | Наследует `@vnejs/module.controller.hide.on.controls`: `BACK` / `MENU` / `GAMEMENU` → `HIDE`; PUSH/POP на SHOW/HIDE. |
44
45
  | `save.controller.tabs` | Наследник `ModuleControllerTabs`: TAB_PREV/TAB_NEXT → `TAB_SET`; `getTabKeys` фильтрует SAVE vs LOAD/AUTOSAVE. |
45
46
  | `save.controller.load` | Подмодуль `controller.load` плагина. |
46
47
  | `save.view` | Подмодуль `view` плагина. |
package/plugins/views.screens/settings.defaults.md CHANGED
@@ -37,8 +37,9 @@ Breaking: раньше namespace был `SETTINGS_DEFAULTS`, события `vne
37
37
 
38
38
  | Модуль | Зона ответственности |
39
39
  |--------|----------------------|
40
- | `settings.defaults.controller` | SHOW/HIDE; `ACCEPT` → `CONFIRM` (выше controls index слоя полей); связка с `SETTINGS_VIEW`. |
41
- | `settings.defaults` | Связь со сценарием: шаг next после завершения действия. |
40
+ | `settings.defaults.controller` | SHOW/HIDE; связка с `SETTINGS_VIEW`. |
41
+ | `settings.defaults.controller.accept` | Наследует `@vnejs/module.controller.accept`: только `ACCEPT` (`IS_INTERACT_ENABLED = false`) → `CONFIRM` → `INITED`, `HIDE`, `emitNext`; PUSH/POP на SHOW/HIDE. |
42
+ | `settings.defaults` | Сценарий: `LINE_EXEC` → `SHOW`, либо `emitNext` при `skip_if_possible` и `INITED`. |
42
43
  | `settings.defaults.view` | Chrome: title + кнопка Accept. |
43
44
 
44
45
  ## Близкие плагины
package/plugins/views.screens/settings.md CHANGED
@@ -38,8 +38,9 @@
38
38
 
39
39
  | Модуль | Зона ответственности |
40
40
  |--------|----------------------|
41
- | `settings.controller.audio` | Наследник `ModuleControllerAudio`: SHOW/HIDE/PRELOAD → pause global, play/stop `view`-трека. |
42
- | `settings.controller` | SHOW/HIDE/TAB_SET; `BACK`/`MENU`/`GAMEMENU` → hide; связка с `SETTINGS_VIEW`. |
41
+ | `settings.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`. |
42
+ | `settings.controller` | SHOW/HIDE/TAB_SET; связка с `SETTINGS_VIEW`. Пустой `controls` на `ZINDEX`, чтобы стопорить слои ниже. |
43
+ | `settings.hide.controls` | Наследует `@vnejs/module.controller.hide.on.controls`: `BACK` / `MENU` / `GAMEMENU` → `HIDE`; PUSH/POP на SHOW/HIDE. |
43
44
  | `settings.controller.tabs` | Наследник `ModuleControllerTabs`: TAB_PREV/TAB_NEXT → `TAB_SET`; `getTabKeys` по `showInSettings`. |
44
45
  | `settings.view` | Chrome экрана (Screen, tabs, cross); поля и example text — в `SETTINGS_VIEW`. |
45
46