@vnejs/docs 0.2.14 → 0.2.16

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.16",
   "description": "VNEJS documentation for engine consumers and coding agents",
   "files": [
     "*.md",

package/plugins/text/locs.md

@@ -4,12 +4,14 @@
 
 Загружает словари локализации и подменяет строки текста по выбранному языку.
 
+Файлы: `media/locs/{lang}/{group}/{label}.json`, например `media/locs/ru/views/mainMenu.json` и `media/locs/ru/labels/prologue.json`. `LOC_LABEL` и имена сценарных меток в путь не включают группу.
+
 ## События
 
 | Ключ | Строка | Смысл |
 |------|--------|-------|
-| `LOAD` | `vne:locs:load` | Запросить данные у обработчиков и продолжить цепочку. |
-| `GET` | `vne:locs:get` | Получить значение или ресурс. |
+| `LOAD` | `vne:locs:load` | Запросить данные у обработчиков и продолжить цепочку. Payload: `{ label, group, lang? }`. Без `group` файл не грузится. |
+| `GET` | `vne:locs:get` | Получить словарь. Payload: `{ label, group, lang? }`. Без `group` — пустой объект. |
 | `CHANGED` | `vne:locs:changed` | Зафиксировать изменение состояния. |
 
 ## Константы
@@ -21,6 +23,9 @@
 | Ключ | Тип | Смысл |
 |------|-----|-------|
 | `DEFAULT_LANG` | `string` | Значение по умолчанию: "ru". |
+| `GROUPS` | `object` | `VIEWS: "views"`, `LABELS: "labels"` — папки после `{lang}/`. |
+
+`LOCS.GET` / `LOCS.LOAD` требуют `group`. `TEXT.REPLACE` без `group` в locs-handler подставляет `GROUPS.LABELS`. View-inject (`locLabel`) берёт `GROUPS.VIEWS`.
 
 ## Настройки
 

package/plugins/views.screens/disclaimer.md

@@ -40,7 +40,7 @@
 
 ## Локализация
 
-Файл `media/locs/{lang}/disclaimer.json`. Ключи:
+Файл `media/locs/{lang}/views/disclaimer.json`. Ключи:
 
 | Ключ | Смысл |
 |------|-------|

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