@vnejs/docs 0.2.1

package/plugins/views.screens/confirm.md

@@ -0,0 +1,48 @@
+# plugins/views.screens/confirm/
+
+Пакет: `@vnejs/plugins.views.screens.confirm` · namespace: `CONFIRM`
+
+Модальный экран подтверждения с выбором принять или отклонить и колбэками.
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `SHOW` | `vne:confirm:show` | Показать UI или слой. |
+| `HIDE` | `vne:confirm:hide` | Скрыть UI или слой. |
+| `EMIT` | `vne:confirm:emit` | Инициировать действие или цикл. |
+| `UPDATE` | `vne:confirm:update` | Обновить состояние или отображение. |
+| `ACCEPT` | `vne:confirm:accept` | Событие `ACCEPT` namespace плагина. |
+| `DECLINE` | `vne:confirm:decline` | Событие `DECLINE` namespace плагина. |
+
+## Константы
+
+Нет.
+
+## Параметры
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `TRANSITION` | `string` | Значение по умолчанию: "TRANSITION". |
+
+## Настройки
+
+Нет.
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `confirm.controller` | Обрабатывает UPDATE, ACCEPT, DECLINE, SHOW, …. |
+| `confirm` | Обрабатывает EMIT, ACCEPT, DECLINE. |
+| `confirm.view` | Подмодуль `view` плагина. |
+
+## Близкие плагины
+
+### plugins/core/
+
+- [state.md](../core/state.md) — `STATE`: EVENTS.CLEAR
+
+### Остальные
+
+- [controls.md](../controls/controls.md) — `CONTROLS`: CONST.BUTTONS.INTERACT, CONST.BUTTONS.ACCEPT, CONST.BUTTONS.BACK, CONST.BUTTONS.ARROW_LEFT, CONST.BUTTONS.ARROW_RIGHT

package/plugins/views.screens/credits.md

@@ -0,0 +1,46 @@
+# plugins/views.screens/credits/
+
+Пакет: `@vnejs/plugins.views.screens.credits` · namespace: `CREDITS`
+
+Экран титров, открываемый и закрываемый командами сценария show/hide.
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `SHOW` | `vne:credits:show` | Показать UI или слой. |
+| `HIDE` | `vne:credits:hide` | Скрыть UI или слой. |
+| `UPDATE` | `vne:credits:update` | Обновить состояние или отображение. |
+
+## Константы
+
+Нет.
+
+## Параметры
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `LINES` | `string` | Значение по умолчанию: "LINES". |
+
+## Настройки
+
+Нет.
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `credits.controller` | Обрабатывает HIDE, UPDATE, SHOW, CLEAR. |
+| `credits` | Модуль `credits`. |
+| `credits.view` | Подмодуль `view` плагина. |
+
+## Близкие плагины
+
+### plugins/core/
+
+- [scenario.md](../core/scenario.md) — `SCENARIO`: emitNext, EVENTS.LINE_EXEC_REG
+- [state.md](../core/state.md) — `STATE`: EVENTS.CLEAR
+
+### Остальные
+
+- [controls.md](../controls/controls.md) — `CONTROLS`: CONST.BUTTONS.ACCEPT, CONST.BUTTONS.INTERACT, CONST.BUTTONS.MENU

package/plugins/views.screens/eula.md

@@ -0,0 +1,54 @@
+# plugins/views.screens/eula/
+
+Пакет: `@vnejs/plugins.views.screens.eula` · namespace: `EULA`
+
+Экран лицензионного соглашения перед главным меню, если версия ещё не принята.
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `UPDATE` | `vne:eula:update` | Обновить состояние или отображение. |
+| `SHOW` | `vne:eula:show` | Показать UI или слой. |
+| `HIDE` | `vne:eula:hide` | Скрыть UI или слой. |
+| `ACCEPT` | `vne:eula:accept` | Событие `ACCEPT` namespace плагина. |
+| `EXIT` | `vne:eula:exit` | Событие `EXIT` namespace плагина. |
+
+## Константы
+
+Нет.
+
+## Параметры
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `LANGS` | `string` | Значение по умолчанию: "LANGS". |
+
+## Настройки
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `ACCEPTED_VERSION` (`vne:eula:accepted_version`) | `string` | Настройка `vne:eula:accepted_version` в `shared.settings`. |
+| `LANG` (`vne:eula:lang`) | `string` | Настройка `vne:eula:lang` в `shared.settings`. |
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `eula.controller` | Обрабатывает UPDATE, SHOW, HIDE, EXTERNAL_UPDATE, …. |
+| `eula` | Обрабатывает ACCEPT, EXIT, SHOW. |
+| `eula.view` | Подмодуль `view` плагина. |
+
+## Близкие плагины
+
+### plugins/core/
+
+- [components.md](../core/components.md) — `COMPONENTS`: EVENTS.EXTERNAL_UPDATE
+- [settings.md](../core/settings.md) — `SETTINGS`: EVENTS.CHANGED, EVENTS.INIT, EVENTS.SET
+- [state.md](../core/state.md) — `STATE`: EVENTS.CLEAR
+- [system.md](../core/system.md) — `SYSTEM`: EVENTS.CLOSE
+
+### Остальные
+
+- [controls.md](../controls/controls.md) — `CONTROLS`: CONST.BUTTONS.ARROW_UP, CONST.BUTTONS.ARROW_BOTTOM, CONST.BUTTONS.ACCEPT, CONST.BUTTONS.BACK
+- [mainmenu.md](./mainmenu.md) — `MAINMENU`: EVENTS.SHOW

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

@@ -0,0 +1,48 @@
+# plugins/views.screens/gallery.full/
+
+Пакет: `@vnejs/plugins.views.screens.gallery.full` · namespace: `GALLERY_FULL_VIEW`
+
+Полноэкранный просмотр выбранного изображения из галереи.
+
+Для вариаций с `layerChildType` фона src берётся через `LAYER_BG.SRC_GET` с `args.overlays` из выбранного варианта галереи.
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `SHOW` | `vne:gallery_full:show` | Показать UI или слой. |
+| `HIDE` | `vne:gallery_full:hide` | Скрыть UI или слой. |
+| `UPDATE` | `vne:gallery_full:update` | Обновить состояние или отображение. |
+
+## Константы
+
+Нет.
+
+## Параметры
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `TRANSITION` | `string` | Значение по умолчанию: "TRANSITION". |
+
+## Настройки
+
+Нет.
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `gallery.full.controller` | Обрабатывает UPDATE, HIDE, SHOW, CHOOSE. |
+| `gallery.full.view` | Подмодуль `full.view` плагина. |
+
+## Близкие плагины
+
+### plugins/core/
+
+— нет
+
+### Остальные
+
+- [controls.md](../controls/controls.md) — `CONTROLS`: CONST.BUTTONS.BACK, CONST.BUTTONS.MENU, CONST.BUTTONS.GAMEMENU
+- [gallery.md](./gallery.md) — `GALLERY`: EVENTS.CHOOSE
+- [layer.md](../canvas/layer.md) — `LAYER`: SETTINGS.QUALITY

package/plugins/views.screens/gallery.md

@@ -0,0 +1,69 @@
+# plugins/views.screens/gallery/
+
+Пакет: `@vnejs/plugins.views.screens.gallery` · namespace: `GALLERY`
+
+Галерея CG с вкладками и сеткой; открытые изображения отмечаются в storage.
+
+Вариации вкладки (`GalleryTabContentVariation`) несут `overlays: Record<string, string | number>` — та же карта, что у [bg.md](../canvas/bg.md) args; значения нормализуются в строки перед показом / full-view.
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `OPEN` | `vne:gallery:open` | Открыть экран или панель. |
+| `CHECK` | `vne:gallery:check` | Проверить состояние или наличие ресурса. |
+| `CLEAR` | `vne:gallery:clear` | Очистить накопленное состояние. |
+| `SHOW` | `vne:gallery:show` | Показать UI или слой. |
+| `HIDE` | `vne:gallery:hide` | Скрыть UI или слой. |
+| `PAGE_SET` | `vne:gallery:page_set` | Записать или обновить значение. |
+| `TAB_SET` | `vne:gallery:tab_set` | Выбрать вкладку галереи (`{ tab }`). |
+| `UPDATE` | `vne:gallery:update` | Обновить состояние или отображение. |
+| `PRELOAD` | `vne:gallery:preload` | Событие `PRELOAD` namespace плагина. |
+| `CHOOSE` | `vne:gallery:choose` | Событие `CHOOSE` namespace плагина. |
+
+## Константы
+
+Нет.
+
+## Параметры
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `TABS` | `string` | Значение по умолчанию: "TABS". |
+| `BACKGROUND` | `string` | Значение по умолчанию: "save". |
+| `TRANSITION` | `string` | Значение по умолчанию: "TRANSITION". |
+| `ZINDEX` | `string` | Значение по умолчанию: "ZINDEX". |
+| `LOC_LABEL` | `string` | Имя метки или стартовой точки. |
+| `VIEW_PROPS` | `string` | Значение по умолчанию: "VIEW_PROPS". |
+| `ROWS` | `string` | Значение по умолчанию: "ROWS". |
+| `COLUMNS` | `string` | Значение по умолчанию: "COLUMNS". |
+| `AUDIO_NAME` | `string` | Имя трека на слое `view` при открытии экрана; пустая строка — без overlay-музыки. |
+
+## Настройки
+
+Нет.
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `gallery.controller.audio` | Наследник `ModuleControllerAudio`: SHOW/HIDE/PRELOAD → pause global, play/stop `view`-трека. |
+| `gallery.controller` | Обрабатывает UPDATE, HIDE, CHOOSE, TAB_SET, …. |
+| `gallery.controller.tabs` | Наследник `ModuleControllerTabs`: TAB_PREV/TAB_NEXT → `TAB_SET`; PUSH/POP controls на SHOW/HIDE. |
+| `gallery` | Обрабатывает OPEN, CHECK, CLEAR. |
+| `gallery.view` | Подмодуль `view` плагина. |
+
+## Близкие плагины
+
+### plugins/core/
+
+- [memory.md](../core/memory.md) — `MEMORY`: EVENTS.CLEARED, EVENTS.CLEAR
+- [state.md](../core/state.md) — `STATE`: EVENTS.CLEAR
+- [storage.md](../core/storage.md) — `STORAGE`: EVENTS.SET, EVENTS.GET, EVENTS.RM_ALL
+- [system.md](../core/system.md) — `SYSTEM`: EVENTS.STARTED
+
+### Остальные
+
+- [audio.md](../audio/audio.md) — `AUDIO`: EVENTS.GLOBAL_PAUSE, EVENTS.PLAY, EVENTS.STOP, EVENTS.GLOBAL_RESUME, EVENTS.MEDIA_LOAD
+- [controls.md](../controls/controls.md) — `CONTROLS`: CONST.BUTTONS.BACK, CONST.BUTTONS.MENU, CONST.BUTTONS.GAMEMENU, CONST.BUTTONS.ARROW_UP, CONST.BUTTONS.ARROW_RIGHT, CONST.BUTTONS.ARROW_BOTTOM
+- [layer.md](../canvas/layer.md) — `LAYER`: SETTINGS.QUALITY

package/plugins/views.screens/gamemenu.md

@@ -0,0 +1,52 @@
+# plugins/views.screens/gamemenu/
+
+Пакет: `@vnejs/plugins.views.screens.gamemenu` · namespace: `GAMEMENU`
+
+Игровое меню паузы со списком настраиваемых пунктов.
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `SHOW` | `vne:gamemenu:show` | Показать UI или слой. |
+| `HIDE` | `vne:gamemenu:hide` | Скрыть UI или слой. |
+| `CLICK` | `vne:gamemenu:click` | Событие `CLICK` namespace плагина. |
+| `UPDATE` | `vne:gamemenu:update` | Обновить состояние или отображение. |
+| `ACCEPT` | `vne:gamemenu:accept` | Событие `ACCEPT` namespace плагина. |
+
+## Константы
+
+Нет.
+
+## Параметры
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `ITEMS` | `string` | Значение по умолчанию: "ITEMS". |
+| `TRANSITION` | `string` | Значение по умолчанию: "TRANSITION". |
+| `ZINDEX` | `string` | Значение по умолчанию: "ZINDEX". |
+| `LOC_LABEL` | `string` | Имя метки или стартовой точки. |
+| `VIEW_PROPS` | `string` | Значение по умолчанию: "VIEW_PROPS". |
+
+## Настройки
+
+Нет.
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `gameMenu.controller` | Обрабатывает UPDATE, HIDE, ACCEPT, SHOW, …. |
+| `gameMenu` | Модуль `gameMenu`. |
+| `gameMenu.view` | Подмодуль `view` плагина. |
+
+## Близкие плагины
+
+### plugins/core/
+
+- [components.md](../core/components.md) — `COMPONENTS`: EVENTS.EXTERNAL_UPDATE
+- [state.md](../core/state.md) — `STATE`: EVENTS.SET, EVENTS.CLEAR
+
+### Остальные
+
+- [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

package/plugins/views.screens/history.md

@@ -0,0 +1,70 @@
+# plugins/views.screens/history/
+
+Пакет: `@vnejs/plugins.views.screens.history` · namespace: `HISTORY`
+
+Журнал диалогов с возвратом к сохранённым состояниям прошлых реплик.
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `GET` | `vne:history:get` | Получить значение или ресурс. |
+| `ADD` | `vne:history:add` | Добавить запись в журнал (snapshot state). Payload: реплика (`label`/`text`/`args`/`speaker`…) или маркер UI (`locKey` без speaker/text). |
+| `LOAD` | `vne:history:load` | Запросить данные у обработчиков и продолжить цепочку. |
+| `BACK` | `vne:history:back` | Событие `BACK` namespace плагина. |
+| `KEYS` | `vne:history:keys` | Событие `KEYS` namespace плагина. |
+| `HIDE` | `vne:history:hide` | Скрыть UI или слой. |
+| `SHOW` | `vne:history:show` | Показать UI или слой. |
+| `CLICK` | `vne:history:click` | Событие `CLICK` namespace плагина. |
+| `UPDATE` | `vne:history:update` | Обновить состояние или отображение. |
+| `ACCEPT` | `vne:history:accept` | Событие `ACCEPT` namespace плагина. |
+
+## Константы
+
+Нет.
+
+## Параметры
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `MAX_LENGTH` | `string` | Значение по умолчанию: "MAX_LENGTH". |
+| `ZINDEX` | `string` | Значение по умолчанию: "ZINDEX". |
+| `TRANSITION` | `string` | Значение по умолчанию: "TRANSITION". |
+| `LOC_LABEL` | `string` | Имя метки или стартовой точки. |
+| `VIEW_PROPS` | `string` | Значение по умолчанию: "VIEW_PROPS". |
+
+## Настройки
+
+Нет.
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `history.controller` | SHOW/HIDE/ACCEPT/CLICK; перед SHOW резолвит тексты строк (`TEXT.REPLACE`). Для `locKey` — через `PARAMS.HISTORY.LOC_LABEL` (локализация view), иначе через label сценария. |
+| `history` | Обрабатывает ADD, GET, LOAD, BACK, …. |
+| `history.view` | Подмодуль `view` плагина. |
+
+## Compatibility
+
+### `compatibility/scenario.choose/views.screens.history/`
+
+Пакет: `@vnejs/compatibility.scenario.choose-with-views.screens.history`
+
+На `CHOOSE.OPTION_BEFORE_REG` добавляет в историю запись `{ locKey: "choice" }`. Перевод — ключ `choice` в `history.json` (например «Выбор...»).
+
+## Близкие плагины
+
+### plugins/core/
+
+- [logs.md](../core/logs.md) — `LOGS`: emitLog
+- [memory.md](../core/memory.md) — `MEMORY`: EVENTS.REG, EVENTS.SET, EVENTS.KEYS, EVENTS.GET
+- [scenario.md](../core/scenario.md) — `SCENARIO`: EVENTS.LABEL_GET
+- [state.md](../core/state.md) — `STATE`: EVENTS.SET, EVENTS.CLEAR, EVENTS.GET, EVENTS.LOAD
+- [vendors.md](../core/vendors.md) — `VENDORS`: emitClone, EVENTS.UID
+
+### Остальные
+
+- [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
+- [text.md](../text/text.md) — `TEXT`: EVENTS.REPLACE
+- [choose.md](../scenario/choose.md) — `CHOOSE`: связка через compatibility выше (`OPTION_BEFORE_REG`)

package/plugins/views.screens/intro.md

@@ -0,0 +1,50 @@
+# plugins/views.screens/intro/
+
+Пакет: `@vnejs/plugins.views.screens.intro` · namespace: `INTRO`
+
+Вступительный экран сценария с пропуском по клику, interact или skip.
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `SHOW` | `vne:intro:show` | Показать UI или слой. |
+| `HIDE` | `vne:intro:hide` | Скрыть UI или слой. |
+| `CLICK` | `vne:intro:click` | Продвинуть сценарий к следующей строке. |
+| `UPDATE` | `vne:intro:update` | Обновить состояние или отображение. |
+| `SKIP` | `vne:intro:skip` | Продвинуть сценарий к следующей строке. |
+| `INTERACT` | `vne:intro:interact` | Продвинуть сценарий к следующей строке. |
+
+## Константы
+
+Нет.
+
+## Параметры
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `BACKGROUND` | `string` | Значение по умолчанию: "BACKGROUND". |
+
+## Настройки
+
+Нет.
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `intro.controller` | Обрабатывает INTERACT, UPDATE, SHOW, HIDE, …. |
+| `intro` | Связь со сценарием: шаг next после завершения действия. |
+| `intro.view` | Подмодуль `view` плагина. |
+
+## Близкие плагины
+
+### plugins/core/
+
+- [logs.md](../core/logs.md) — `LOGS`: emitLog
+- [scenario.md](../core/scenario.md) — `SCENARIO`: emitNext, EVENTS.LINE_EXEC_REG, CONST.LINE_KEYWORDS.SKIP_IF_POSSIBLE
+- [system.md](../core/system.md) — `SYSTEM`: EVENTS.STARTED
+
+### Остальные
+
+- [controls.md](../controls/controls.md) — `CONTROLS`: CONST.BUTTONS.ANY

package/plugins/views.screens/loading.md

@@ -0,0 +1,48 @@
+# plugins/views.screens/loading/
+
+Пакет: `@vnejs/plugins.views.screens.loading` · namespace: `LOADING`
+
+Экран загрузки поверх игры на время асинхронных операций с минимальной длительностью.
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `SHOW` | `vne:loading:show` | Показать UI или слой. |
+| `HIDE` | `vne:loading:hide` | Скрыть UI или слой. |
+| `EMIT` | `vne:loading:emit` | Записать диагностическое сообщение в лог. |
+| `UPDATE` | `vne:loading:update` | Обновить состояние или отображение. |
+
+## Константы
+
+Нет.
+
+## Параметры
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `MIN_SHOW_TIME` | `string` | Значение по умолчанию: "MIN_SHOW_TIME". |
+
+## Настройки
+
+Нет.
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `loading.controller` | Обрабатывает UPDATE, SHOW, HIDE, STARTED, …. |
+| `loading` | Точка входа emit: подготовка и запуск process. |
+| `loading.view` | Подмодуль `view` плагина. |
+
+## Близкие плагины
+
+### plugins/core/
+
+- [logs.md](../core/logs.md) — `LOGS`: emitLog
+- [memory.md](../core/memory.md) — `MEMORY`: EVENTS.CLEARED
+- [system.md](../core/system.md) — `SYSTEM`: EVENTS.STARTED
+
+### Остальные
+
+— нет

package/plugins/views.screens/mainmenu.md

@@ -0,0 +1,61 @@
+# plugins/views.screens/mainmenu/
+
+Пакет: `@vnejs/plugins.views.screens.mainmenu` · namespace: `MAINMENU`
+
+Главное меню с пунктами, сменой фона и предзагрузкой меток сценария.
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `HIDE` | `vne:mainmenu:hide` | Скрыть UI или слой. |
+| `SHOW` | `vne:mainmenu:show` | Показать UI или слой. |
+| `ITEMS` | `vne:mainmenu:items` | Событие `ITEMS` namespace плагина. |
+| `CLICK` | `vne:mainmenu:click` | Событие `CLICK` namespace плагина. |
+| `ACCEPT` | `vne:mainmenu:accept` | Событие `ACCEPT` namespace плагина. |
+| `UPDATE` | `vne:mainmenu:update` | Обновить состояние или отображение. |
+
+## Константы
+
+Нет.
+
+## Параметры
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `PRELOAD_LABELS` | `string` | Имя метки или стартовой точки. |
+| `PRELOAD_EVENTS` | `string` | Значение по умолчанию: "PRELOAD_EVENTS". |
+| `ITEMS` | `string` | Значение по умолчанию: "ITEMS". |
+| `BACKGROUND` | `string` | Значение по умолчанию: "BACKGROUND". |
+| `BACKGROUNDS` | `string` | Значение по умолчанию: "BACKGROUNDS". |
+| `BACKGROUNDS_INTERVAL` | `string` | Значение по умолчанию: "BACKGROUNDS_INTERVAL". |
+| `TRANSITION` | `string` | Значение по умолчанию: "TRANSITION". |
+| `ZINDEX` | `string` | Значение по умолчанию: "ZINDEX". |
+| `LOC_LABEL` | `string` | Имя метки или стартовой точки. |
+| `VIEW_PROPS` | `string` | Значение по умолчанию: "VIEW_PROPS". |
+
+## Настройки
+
+Нет.
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `mainmenu.controller` | Обрабатывает ACCEPT, UPDATE, SHOW, HIDE, …. |
+| `mainmenu` | Обрабатывает SHOW, HIDE, ITEMS, CLEARED. |
+| `mainmenu.view` | Подмодуль `view` плагина. |
+
+## Близкие плагины
+
+### plugins/core/
+
+- [components.md](../core/components.md) — `COMPONENTS`: EVENTS.EXTERNAL_UPDATE
+- [memory.md](../core/memory.md) — `MEMORY`: EVENTS.CLEARED
+- [scenario.md](../core/scenario.md) — `SCENARIO`: EVENTS.LINE_EXEC_REG, EVENTS.LINE_LOAD_REG, EVENTS.LABEL_GET
+- [state.md](../core/state.md) — `STATE`: EVENTS.SET, EVENTS.CLEAR
+- [system.md](../core/system.md) — `SYSTEM`: EVENTS.STARTED
+
+### Остальные
+
+- [controls.md](../controls/controls.md) — `CONTROLS`: CONST.BUTTONS.ARROW_UP, CONST.BUTTONS.ARROW_BOTTOM, CONST.BUTTONS.ACCEPT, CONST.BUTTONS.INTERACT

package/plugins/views.screens/mainmenu.socials.md

@@ -0,0 +1,45 @@
+# plugins/views.screens/mainmenu.socials/
+
+Пакет: `@vnejs/plugins.views.screens.mainmenu.socials` · namespace: `MAINMENU_SOCIALS_VIEW`
+
+Блок иконок соцсетей, показываемый вместе с главным меню.
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `UPDATE` | `vne:mainmenu_socials:update` | Обновить состояние или отображение. |
+
+## Константы
+
+Нет.
+
+## Параметры
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `VIEW_PROPS` | `string` | Значение по умолчанию: "VIEW_PROPS". |
+
+## Настройки
+
+Нет.
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `mainmenu.socials.controller` | Обрабатывает UPDATE, SHOW, HIDE, CLEAR, …. |
+| `mainmenu.socials.view` | Подмодуль `socials.view` плагина. |
+
+## Близкие плагины
+
+### plugins/core/
+
+- [memory.md](../core/memory.md) — `MEMORY`: EVENTS.CLEARED
+- [state.md](../core/state.md) — `STATE`: EVENTS.CLEAR, EVENTS.SET
+- [system.md](../core/system.md) — `SYSTEM`: EVENTS.STARTED
+
+### Остальные
+
+- [layer.md](../canvas/layer.md) — `LAYER`: SETTINGS.QUALITY
+- [mainmenu.md](./mainmenu.md) — `MAINMENU`: EVENTS.SHOW, EVENTS.HIDE, PARAMS.TRANSITION

package/plugins/views.screens/save.md

@@ -0,0 +1,63 @@
+# plugins/views.screens/save/
+
+Пакет: `@vnejs/plugins.views.screens.save` · namespace: `SAVE_VIEW`
+
+Экран сохранения и загрузки с сеткой слотов и вкладками save/load/autosave.
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `SHOW` | `vne:save_view:show` | Показать UI или слой. |
+| `HIDE` | `vne:save_view:hide` | Скрыть UI или слой. |
+| `PAGE_SET` | `vne:save_view:page_set` | Записать или обновить значение. |
+| `TAB_SET` | `vne:save_view:tab_set` | Выбрать вкладку save/load/autosave (`{ tab }`). |
+| `CREATE` | `vne:save_view:create` | Создать слот (`{ key, group }`) → `SAVE.CREATE`. |
+| `DELETE` | `vne:save_view:delete` | Удалить слот (`{ key, group }`) → `SAVE.DELETE`. |
+| `LOAD` | `vne:save_view:load` | Загрузить слот (`{ key, group }`) → `SAVE.PRELOAD` / `SAVE.LOAD`. |
+| `UPDATE` | `vne:save_view:update` | Обновить состояние или отображение. |
+| `PRELOAD` | `vne:save_view:preload` | Событие `PRELOAD` namespace плагина. |
+
+## Константы
+
+Нет.
+
+## Параметры
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `BACKGROUND` | `string` | Значение по умолчанию: "BACKGROUND". |
+| `AUDIO_NAME` | `string` | Имя трека на слое `view` при открытии экрана; пустая строка — без overlay-музыки. |
+
+## Настройки
+
+Нет.
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `save.controller.audio` | Наследник `ModuleControllerAudio`: SHOW/HIDE/PRELOAD → pause global, play/stop `view`-трека. |
+| `save.controller` | Обрабатывает UPDATE, HIDE, LOAD, TAB_SET, …. SHOW принимает `{ tab }`; в `SAVE.*` передаёт `group` (номер страницы или `autosave`). |
+| `save.controller.tabs` | Наследник `ModuleControllerTabs`: TAB_PREV/TAB_NEXT → `TAB_SET`; `getTabKeys` фильтрует SAVE vs LOAD/AUTOSAVE. |
+| `save.controller.load` | Подмодуль `controller.load` плагина. |
+| `save.view` | Подмодуль `view` плагина. |
+
+## Близкие плагины
+
+### plugins/core/
+
+- [memory.md](../core/memory.md) — `MEMORY`: EVENTS.CLEARED
+- [scenario.md](../core/scenario.md) — `SCENARIO`: emitNext
+- [state.md](../core/state.md) — `STATE`: EVENTS.SET, EVENTS.CLEAR, CONST.MIGRATE_STATUS.LINE_NOT_FOUND, CONST.MIGRATE_STATUS.OK
+- [system.md](../core/system.md) — `SYSTEM`: EVENTS.STARTED
+- [vendors.md](../core/vendors.md) — `VENDORS`: EVENTS.DATE
+
+### Остальные
+
+- [audio.md](../audio/audio.md) — `AUDIO`: EVENTS.GLOBAL_PAUSE, EVENTS.PLAY, EVENTS.STOP, EVENTS.GLOBAL_RESUME, EVENTS.MEDIA_LOAD
+- [confirm.md](./confirm.md) — `CONFIRM`: EVENTS.EMIT
+- [controls.md](../controls/controls.md) — `CONTROLS`: CONST.BUTTONS.BACK, CONST.BUTTONS.MENU, CONST.BUTTONS.GAMEMENU, CONST.BUTTONS.ARROW_UP, CONST.BUTTONS.ARROW_RIGHT, CONST.BUTTONS.ARROW_BOTTOM
+- [loading.md](./loading.md) — `LOADING`: EVENTS.EMIT
+- [locs.md](../text/locs.md) — `LOCS`: EVENTS.GET
+- [save.md](../save/save.md) — `SAVE`: EVENTS.CREATE, EVENTS.DELETE, EVENTS.GET, EVENTS.PRELOAD, EVENTS.LOAD