@vnejs/docs 0.2.14 → 0.2.15

package/architecture.md

@@ -134,6 +134,8 @@ flowchart TD
   MA["@vnejs/module.audio"]
   MCA["@vnejs/module.controller.audio"]
   MCT["@vnejs/module.controller.tabs"]
+  MCP["@vnejs/module.controller.preload"]
+  MCB["@vnejs/module.controller.backgrounds"]
   MSC["@vnejs/module.scales.common"]
 
   M --> MC
@@ -144,6 +146,8 @@ flowchart TD
   MC --> MA
   MC --> MCA
   MC --> MCT
+  MC --> MCP
+  MC --> MCB
   MC --> MSC
   MCO --> ML
 ```
@@ -160,6 +164,8 @@ flowchart TD
 | **`@vnejs/module.audio`** | База для audio-плагинов scenario-слоёв (`music` / `sound` / …) |
 | **`@vnejs/module.controller.audio`** | Overlay-BGM для view-экранов: pause global / play `view` / resume на SHOW/HIDE/PRELOAD |
 | **`@vnejs/module.controller.tabs`** | Навигация по вкладкам view-экранов: TAB_PREV/TAB_NEXT → `TAB_SET`, PUSH/POP controls на SHOW/HIDE |
+| **`@vnejs/module.controller.preload`** | Предзагрузка меток и событий экрана по SHOW / PRELOAD / MEMORY.CLEARED; SHOW/HIDE/PRELOAD задаёт плагин |
+| **`@vnejs/module.controller.backgrounds`** | Ротация списка фонов по SHOW / таймеру / MEMORY.CLEARED; стоп на HIDE и STATE.SET/CLEAR; события и список задаёт плагин |
 | **`@vnejs/module.scales.common`** | База для scales / RPG-модулей |
 
 ### Принципы

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vnejs/docs",
-  "version": "0.2.14",
+  "version": "0.2.15",
   "description": "VNEJS documentation for engine consumers and coding agents",
   "files": [
     "*.md",

package/plugins/views.screens/mainmenu.md

@@ -4,6 +4,8 @@
 
 Главное меню с пунктами, сменой фона и предзагрузкой меток сценария.
 
+Ротация `BACKGROUNDS`: модуль `mainmenu.backgrounds` по `SHOW` сразу грузит следующий фон и по `BACKGROUNDS_INTERVAL` эмитит `STATE_UPDATE` с `{ bgSrc }` и затем `UPDATE_FAST`.
+
 ## События
 
 | Ключ | Строка | Смысл |
@@ -11,9 +13,13 @@
 | `HIDE` | `vne:mainmenu:hide` | Скрыть UI или слой. |
 | `SHOW` | `vne:mainmenu:show` | Показать UI или слой. |
 | `ITEMS` | `vne:mainmenu:items` | Событие `ITEMS` namespace плагина. |
+| `PRELOAD` | `vne:mainmenu:preload` | Предзагрузить метки `PRELOAD_LABELS` и события `PRELOAD_EVENTS`. |
 | `CLICK` | `vne:mainmenu:click` | Событие `CLICK` namespace плагина. |
 | `ACCEPT` | `vne:mainmenu:accept` | Событие `ACCEPT` namespace плагина. |
 | `UPDATE` | `vne:mainmenu:update` | Обновить состояние или отображение. |
+| `STATE_UPDATE` | `vne:mainmenu:state_update` | Слить partial в стейт контроллера без UPDATE view. |
+| `UPDATE_FORCE` | `vne:mainmenu:update_force` | Перерисовать view с `isForce`, стейт не меняет. |
+| `UPDATE_FAST` | `vne:mainmenu:update_fast` | Перерисовать view с `isFast`, стейт не меняет. |
 
 ## Константы
 
@@ -42,8 +48,11 @@
 
 | Модуль | Зона ответственности |
 |--------|----------------------|
-| `mainmenu.controller` | Обрабатывает ACCEPT, UPDATE, SHOW, HIDE, …. |
-| `mainmenu` | Обрабатывает SHOW, HIDE, ITEMS, CLEARED. |
+| `mainmenu.controller` | Обрабатывает ACCEPT, UPDATE, SHOW, HIDE, STATE_UPDATE, UPDATE_FAST, UPDATE_FORCE, …. |
+| `mainmenu.backgrounds` | Наследует `@vnejs/module.controller.backgrounds`: ротация `BACKGROUNDS`, preload и таймер; эмитит `STATE_UPDATE` и `UPDATE_FAST`. |
+| `mainmenu.preload` | Наследует `@vnejs/module.controller.preload`: по SHOW / PRELOAD / MEMORY.CLEARED грузит `PRELOAD_LABELS` и `PRELOAD_EVENTS`. |
+| `mainmenu.scenario` | LINE_EXEC → SHOW, LINE_LOAD → PRELOAD. |
+| `mainmenu` | Обрабатывает ITEMS и CLICK. |
 | `mainmenu.view` | Подмодуль `view` плагина. |
 
 ## Близкие плагины