@vnejs/docs 0.2.13 → 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.13",
+  "version": "0.2.15",
   "description": "VNEJS documentation for engine consumers and coding agents",
   "files": [
     "*.md",

package/plugins/views.screens/gallery.full.md

@@ -4,6 +4,8 @@
 
 Полноэкранный просмотр выбранного изображения из галереи.
 
+`GALLERY.CHOOSE` с `isOpened: false` не открывает full-view. Залоченные вариации не грузят media: пустой `imageSrc` и `withBackgroundBlur`.
+
 Для вариаций с `layerChildType` фона src берётся через `LAYER_BG.SRC_GET` с `args.overlays` из выбранного варианта галереи.
 
 ## События

package/plugins/views.screens/gallery.md

@@ -4,6 +4,8 @@
 
 Галерея CG с вкладками и сеткой; открытые изображения отмечаются в storage.
 
+ACCEPT/INTERACT эмитит `CHOOSE` только для выбранного открытого слота (`isOpened`, не stub); без выделения или на залоченном слоте — no-op. Клик мыши уже вешается только на открытые слоты.
+
 Вариации вкладки (`GalleryTabContentVariation`) несут `overlays: Record<string, string | number>` — та же карта, что у [bg.md](../canvas/bg.md) args; значения нормализуются в строки перед показом / full-view.
 
 ## События
@@ -48,7 +50,7 @@
 | Модуль | Зона ответственности |
 |--------|----------------------|
 | `gallery.controller.audio` | Наследник `ModuleControllerAudio`: SHOW/HIDE/PRELOAD → pause global, play/stop `view`-трека; `VOLUME_SETTING = MUSIC.VOLUME`; при `VOLUME_CHANGED` / смене `VOLUME_SETTING` — повторный `AUDIO.VOLUME`. |
-| `gallery.controller` | Обрабатывает UPDATE, HIDE, CHOOSE, TAB_SET, …. |
+| `gallery.controller` | Обрабатывает UPDATE, HIDE, TAB_SET, …. ACCEPT/INTERACT → `CHOOSE` только если слот открыт. |
 | `gallery.controller.tabs` | Наследник `ModuleControllerTabs`: TAB_PREV/TAB_NEXT → `TAB_SET`; PUSH/POP controls на SHOW/HIDE. |
 | `gallery` | Обрабатывает OPEN, CHECK, CLEAR. |
 | `gallery.view` | Подмодуль `view` плагина. |

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` плагина. |
 
 ## Близкие плагины

package/plugins/views.screens/save.md

@@ -4,6 +4,8 @@
 
 Экран сохранения и загрузки с сеткой слотов и вкладками save/load/autosave.
 
+ACCEPT/INTERACT повторяет клик по слоту: на вкладке save — `CREATE`, на load/autosave — `LOAD` только если у слота есть `screen`.
+
 ## События
 
 | Ключ | Строка | Смысл |
@@ -38,7 +40,7 @@
 | Модуль | Зона ответственности |
 |--------|----------------------|
 | `save.controller.audio` | Наследник `ModuleControllerAudio`: SHOW/HIDE/PRELOAD → pause global, play/stop `view`-трека; `VOLUME_SETTING = MUSIC.VOLUME`; при `VOLUME_CHANGED` / смене `VOLUME_SETTING` — повторный `AUDIO.VOLUME`. |
-| `save.controller` | Обрабатывает UPDATE, HIDE, LOAD, TAB_SET, …. SHOW принимает `{ tab }`; в `SAVE.*` передаёт `group` (номер страницы или `autosave`). |
+| `save.controller` | Обрабатывает UPDATE, HIDE, LOAD, TAB_SET, …. SHOW принимает `{ tab }`; в `SAVE.*` передаёт `group` (номер страницы или `autosave`). ACCEPT/INTERACT: save → `CREATE`, load/autosave → `LOAD` при `screen`. |
 | `save.controller.tabs` | Наследник `ModuleControllerTabs`: TAB_PREV/TAB_NEXT → `TAB_SET`; `getTabKeys` фильтрует SAVE vs LOAD/AUTOSAVE. |
 | `save.controller.load` | Подмодуль `controller.load` плагина. |
 | `save.view` | Подмодуль `view` плагина. |