@vnejs/docs 0.2.64 → 0.2.66

package/plugins/views.screens/gamemenu.md

@@ -1,65 +1,65 @@
 # plugins/views.screens/gamemenu/
 
-Пакет: `@vnejs/plugins.views.screens.gamemenu` · namespace: `GAMEMENU`
+Package: `@vnejs/plugins.views.screens.gamemenu` · namespace: `GAMEMENU`
 
-Игровое меню паузы со списком настраиваемых пунктов.
+Pause game menu with a list of configurable items.
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.screens.gamemenu`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.views.screens.gamemenu`.
 
-| Ключ           | Строка                      | Смысл                                              |
-| -------------- | --------------------------- | -------------------------------------------------- |
-| `SHOW`         | `vne:gamemenu:show`         | Показать UI или слой.                              |
-| `HIDE`         | `vne:gamemenu:hide`         | Скрыть UI или слой.                                |
-| `ITEMS`        | `vne:gamemenu:items`        | Резолв фабрик пунктов меню.                        |
-| `CLICK`        | `vne:gamemenu:click`        | Событие `CLICK` namespace плагина.                 |
-| `UPDATE`       | `vne:gamemenu:update`       | Обновить состояние или отображение.                |
-| `UPDATE_STATE` | `vne:gamemenu:update_state` | Слить partial в стейт контроллера без UPDATE view. |
-| `UPDATE_FAST`  | `vne:gamemenu:update_fast`  | Перерисовать view с `isFast`, стейт не меняет.     |
-| `UPDATE_FORCE` | `vne:gamemenu:update_force` | Перерисовать view с `isForce`, стейт не меняет.    |
-| `ACCEPT`       | `vne:gamemenu:accept`       | Событие `ACCEPT` namespace плагина.                |
+| Key            | String                      | Meaning                                                       |
+| -------------- | --------------------------- | ------------------------------------------------------------- |
+| `SHOW`         | `vne:gamemenu:show`         | Show the UI or layer.                                         |
+| `HIDE`         | `vne:gamemenu:hide`         | Hide the UI or layer.                                         |
+| `ITEMS`        | `vne:gamemenu:items`        | Resolve menu item factories.                                  |
+| `CLICK`        | `vne:gamemenu:click`        | Plugin namespace `CLICK` event.                               |
+| `UPDATE`       | `vne:gamemenu:update`       | Update state or display.                                      |
+| `UPDATE_STATE` | `vne:gamemenu:update_state` | Merge a partial into controller state without an UPDATE view. |
+| `UPDATE_FAST`  | `vne:gamemenu:update_fast`  | Redraw the view with `isFast`; state does not change.         |
+| `UPDATE_FORCE` | `vne:gamemenu:update_force` | Redraw the view with `isForce`; state does not change.        |
+| `ACCEPT`       | `vne:gamemenu:accept`       | Plugin namespace `ACCEPT` event.                              |
 
-## Константы
+## Constants
 
-Нет.
+None.
 
-## Параметры
+## Parameters
 
-| Ключ         | Тип                     | Смысл                                                            |
-| ------------ | ----------------------- | ---------------------------------------------------------------- |
-| `ITEMS`      | `GameMenuItemFactory[]` | Фабрики пунктов; резолвятся на SHOW / смене языка через `ITEMS`. |
-| `TRANSITION` | `number`                | Длительность анимации (500).                                     |
-| `ZINDEX`     | `number`                | Z-index экрана (3000).                                           |
-| `LOC_LABEL`  | `string`                | Имя метки локалей (`gameMenu`).                                  |
-| `VIEW_PROPS` | `ViewProps`             | Пропсы Screen / PositionBox / TextControls.                      |
+| Key          | Type                    | Meaning                                                         |
+| ------------ | ----------------------- | --------------------------------------------------------------- |
+| `ITEMS`      | `GameMenuItemFactory[]` | Item factories; resolved on SHOW / language change via `ITEMS`. |
+| `TRANSITION` | `number`                | Animation duration (500).                                       |
+| `ZINDEX`     | `number`                | Screen z-index (3000).                                          |
+| `LOC_LABEL`  | `string`                | Locale label name (`gameMenu`).                                 |
+| `VIEW_PROPS` | `ViewProps`             | Screen / PositionBox / TextControls props.                      |
 
-Пункт (`GameMenuItem`): `locKey`, `onClick`, опционально `isDisabled` / `isHided` (как у main menu).
+Item (`GameMenuItem`): `locKey`, `onClick`, optional `isDisabled` / `isHided` (same as main menu).
 
-## Настройки
+## Settings
 
-Нет.
+None.
 
-## Модули
+## Modules
 
-| Модуль                       | Зона ответственности                                                                                                                                                                                                                                                                        |
-| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `gamemenu.controller`        | Обрабатывает UPDATE, HIDE, SHOW, UPDATE_STATE, UPDATE_FAST, …. Пустой `controls` на `ZINDEX`, чтобы стопорить слои ниже. Резолвит `ITEMS` → `items` / `realItems`.                                                                                                                          |
-| `gamemenu.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CLICK` по полному индексу пункта (через `realItems`); зеркалит `UPDATE_STATE`; PUSH/POP на SHOW/HIDE.                                                                                                      |
-| `gamemenu.controller.arrows` | Наследует `@vnejs/module.controller.arrows.vertical`: `ARROW_UP` / `ARROW_BOTTOM` по видимым пунктам; PUSH/POP controls на SHOW/HIDE; эмитит `UPDATE_STATE` с `{ currentArrowVerticalItem }` и `UPDATE_FAST`. На `HIDE.CLEANUP` `currentArrowVerticalItem` в стейте становится `undefined`. |
-| `gamemenu.hide.controls`     | Наследует `@vnejs/module.controller.hide.on.controls`: `BACK` / `MENU` / `GAMEMENU` → `HIDE`; PUSH/POP на SHOW/HIDE.                                                                                                                                                                        |
-| `gamemenu.hide.state`        | Наследует `@vnejs/module.controller.hide.on.state`: `STATE.SET` / `STATE.CLEAR` → `HIDE` с `{ isForce: true }`.                                                                                                                                                                             |
-| `gamemenu`                   | `ITEMS` / `CLICK`; пропускает disabled/hided.                                                                                                                                                                                                                                               |
-| `gamemenu.view`              | Подмодуль `view` плагина; `isDisabled` / `isNotRender` в TextControls.                                                                                                                                                                                                                      |
+| Module                       | Role                                                                                                                                                                                                                                                                                       |
+| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `gamemenu.controller`        | Handles UPDATE, HIDE, SHOW, UPDATE_STATE, UPDATE_FAST, …. Empty `controls` on `ZINDEX` to block lower layers. Resolves `ITEMS` → `items` / `realItems`.                                                                                                                                    |
+| `gamemenu.controller.accept` | Extends `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CLICK` on the full item index (via `realItems`); mirrors `UPDATE_STATE`; PUSH/POP on SHOW/HIDE.                                                                                                             |
+| `gamemenu.controller.arrows` | Extends `@vnejs/module.controller.arrows.vertical`: `ARROW_UP` / `ARROW_BOTTOM` over visible items; PUSH/POP controls on SHOW/HIDE; emits `UPDATE_STATE` with `{ currentArrowVerticalItem }` and `UPDATE_FAST`. On `HIDE.CLEANUP` `currentArrowVerticalItem` in state becomes `undefined`. |
+| `gamemenu.hide.controls`     | Extends `@vnejs/module.controller.hide.on.controls`: `BACK` / `MENU` / `GAMEMENU` → `HIDE`; PUSH/POP on SHOW/HIDE.                                                                                                                                                                         |
+| `gamemenu.hide.state`        | Extends `@vnejs/module.controller.hide.on.state`: `STATE.SET` / `STATE.CLEAR` → `HIDE` with `{ isForce: true }`.                                                                                                                                                                           |
+| `gamemenu`                   | `ITEMS` / `CLICK`; skips disabled/hided.                                                                                                                                                                                                                                                   |
+| `gamemenu.view`              | Plugin `view` submodule; `isDisabled` / `isNotRender` in TextControls.                                                                                                                                                                                                                     |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
 - [components.md](../core/components.md) — `COMPONENTS`: EVENTS.EXTERNAL_UPDATE
 - [state.md](../core/state.md) — `STATE`: EVENTS.SET, EVENTS.CLEAR
 
-### Остальные
+### Other
 
 - [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
-- [mainmenu.md](./mainmenu.md) — тот же паттерн фабрик пунктов
+- [mainmenu.md](./mainmenu.md) — same item-factory pattern

package/plugins/views.screens/history.md

@@ -1,63 +1,63 @@
 # plugins/views.screens/history/
 
-Пакет: `@vnejs/plugins.views.screens.history` · namespace: `HISTORY_VIEW`
+Package: `@vnejs/plugins.views.screens.history` · namespace: `HISTORY_VIEW`
 
-Экран журнала диалогов. Снапшоты и шаг назад — [scenario/history.md](../scenario/history.md) (`HISTORY`). Этот плагин в `bundles/vn.base`.
+Dialog history screen. Snapshots and step back — [scenario/history.md](../scenario/history.md) (`HISTORY`). This plugin is in `bundles/vn.base`.
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.screens.history`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.views.screens.history`.
 
-| Ключ           | Строка                          | Смысл                                                              |
-| -------------- | ------------------------------- | ------------------------------------------------------------------ |
-| `HIDE`         | `vne:history_view:hide`         | Скрыть экран.                                                      |
-| `SHOW`         | `vne:history_view:show`         | Показать экран.                                                    |
-| `CLICK`        | `vne:history_view:click`        | Клик по строке. Если `uid` есть в ключах журнала — `HISTORY.LOAD`. |
-| `UPDATE`       | `vne:history_view:update`       | Перерисовать view.                                                 |
-| `UPDATE_STATE` | `vne:history_view:update_state` | Слить partial в стейт контроллера без UPDATE view.                 |
-| `UPDATE_FAST`  | `vne:history_view:update_fast`  | Перерисовать view с `isFast`, стейт не меняет.                     |
-| `UPDATE_FORCE` | `vne:history_view:update_force` | Перерисовать view с `isForce`, стейт не меняет.                    |
-| `ACCEPT`       | `vne:history_view:accept`       | `ACCEPT` / `INTERACT` → `CLICK` по `currentArrowVerticalItem`.     |
+| Key            | String                          | Meaning                                                           |
+| -------------- | ------------------------------- | ----------------------------------------------------------------- |
+| `HIDE`         | `vne:history_view:hide`         | Hide the screen.                                                  |
+| `SHOW`         | `vne:history_view:show`         | Show the screen.                                                  |
+| `CLICK`        | `vne:history_view:click`        | Click a row. If `uid` is in journal keys — `HISTORY.LOAD`.        |
+| `UPDATE`       | `vne:history_view:update`       | Redraw the view.                                                  |
+| `UPDATE_STATE` | `vne:history_view:update_state` | Merge a partial into the controller state without an UPDATE view. |
+| `UPDATE_FAST`  | `vne:history_view:update_fast`  | Redraw the view with `isFast`; state does not change.             |
+| `UPDATE_FORCE` | `vne:history_view:update_force` | Redraw the view with `isForce`; state does not change.            |
+| `ACCEPT`       | `vne:history_view:accept`       | `ACCEPT` / `INTERACT` → `CLICK` on `currentArrowVerticalItem`.    |
 
-Строки журнала и шаг назад — `EVENTS.HISTORY.GET` / `KEYS` / `LOAD` / `BACK` / `ADD` (`scenario/history`).
+Journal rows and step back — `EVENTS.HISTORY.GET` / `KEYS` / `LOAD` / `BACK` / `ADD` (`scenario/history`).
 
-## Константы
+## Constants
 
-Нет.
+None.
 
-## Параметры
+## Parameters
 
-| Ключ         | Тип      | Смысл                                                                     |
-| ------------ | -------- | ------------------------------------------------------------------------- |
-| `ZINDEX`     | `number` | Значение по умолчанию: 2000.                                              |
-| `TRANSITION` | `number` | Значение по умолчанию: 300.                                               |
-| `LOC_LABEL`  | `string` | Метка локализации view (`history`).                                       |
-| `VIEW_PROPS` | `object` | Раскладка экрана, строк (блок по вертикали по центру) и крестика `close`. |
+| Key          | Type     | Meaning                                                           |
+| ------------ | -------- | ----------------------------------------------------------------- |
+| `ZINDEX`     | `number` | Default: 2000.                                                    |
+| `TRANSITION` | `number` | Default: 300.                                                     |
+| `LOC_LABEL`  | `string` | View localization label (`history`).                              |
+| `VIEW_PROPS` | `object` | Screen layout, rows (vertical block centered), and `close` cross. |
 
-## Настройки
+## Settings
 
-Нет.
+None.
 
-## Модули
+## Modules
 
-| Модуль                      | Зона ответственности                                                                                                                                                                                                                                                                        |
-| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `history.controller`        | SHOW/HIDE/UPDATE_STATE/UPDATE_FAST; перед SHOW резолвит тексты строк (`TEXT.REPLACE`). Для `locKey` — через `PARAMS.HISTORY_VIEW.LOC_LABEL` (локализация view), иначе через label сценария. Пустой `controls` на `ZINDEX`, чтобы стопорить слои ниже.                                       |
-| `history.controller.click`  | `HISTORY_VIEW.CLICK` → `HISTORY.KEYS`; если `uid` в ключах — `HISTORY.LOAD`.                                                                                                                                                                                                                |
-| `history.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CLICK` по `currentArrowVerticalItem`; зеркалит `UPDATE_STATE`; PUSH/POP на SHOW/HIDE.                                                                                                                      |
-| `history.controller.arrows` | Наследует `@vnejs/module.controller.arrows.vertical`: `ARROW_UP` / `ARROW_BOTTOM` по записям журнала; PUSH/POP controls на SHOW/HIDE; эмитит `UPDATE_STATE` с `{ currentArrowVerticalItem }` и `UPDATE_FAST`. На `HIDE.CLEANUP` `currentArrowVerticalItem` в стейте становится `undefined`. |
-| `history.hide.controls`     | Наследует `@vnejs/module.controller.hide.on.controls`: `BACK` / `MENU` / `GAMEMENU` → `HIDE`; PUSH/POP на SHOW/HIDE.                                                                                                                                                                        |
-| `history.hide.state`        | Наследует `@vnejs/module.controller.hide.on.state`: `STATE.SET` → `HIDE` с `{ isForce: true }` (`IS_STATE_CLEAR_ENABLED = false`).                                                                                                                                                          |
-| `history.view`              | Подмодуль `view` плагина.                                                                                                                                                                                                                                                                   |
+| Module                      | Role                                                                                                                                                                                                                                                                                                          |
+| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `history.controller`        | SHOW/HIDE/UPDATE_STATE/UPDATE_FAST; before SHOW resolves row texts (`TEXT.REPLACE`). For `locKey` — via `PARAMS.HISTORY_VIEW.LOC_LABEL` (view localization), else via scenario label. After translation, `{…}` markers are stripped from the display row. Empty `controls` on `ZINDEX` to block lower layers. |
+| `history.controller.click`  | `HISTORY_VIEW.CLICK` → `HISTORY.KEYS`; if `uid` is in keys — `HISTORY.LOAD`.                                                                                                                                                                                                                                  |
+| `history.controller.accept` | Extends `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CLICK` on `currentArrowVerticalItem`; mirrors `UPDATE_STATE`; PUSH/POP on SHOW/HIDE.                                                                                                                                           |
+| `history.controller.arrows` | Extends `@vnejs/module.controller.arrows.vertical`: `ARROW_UP` / `ARROW_BOTTOM` over journal entries; PUSH/POP controls on SHOW/HIDE; emits `UPDATE_STATE` with `{ currentArrowVerticalItem }` and `UPDATE_FAST`. On `HIDE.CLEANUP` `currentArrowVerticalItem` in state becomes `undefined`.                  |
+| `history.hide.controls`     | Extends `@vnejs/module.controller.hide.on.controls`: `BACK` / `MENU` / `GAMEMENU` → `HIDE`; PUSH/POP on SHOW/HIDE.                                                                                                                                                                                            |
+| `history.hide.state`        | Extends `@vnejs/module.controller.hide.on.state`: `STATE.SET` → `HIDE` with `{ isForce: true }` (`IS_STATE_CLEAR_ENABLED = false`).                                                                                                                                                                           |
+| `history.view`              | Plugin `view` submodule.                                                                                                                                                                                                                                                                                      |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
 - [logs.md](../core/logs.md) — `LOGS`: `EVENTS.LOGS.EMIT` (`action`, …)
 
-### Остальные
+### Other
 
-- [scenario/history.md](../scenario/history.md) — `HISTORY`: `GET` / `KEYS` / `LOAD`; запись журнала и `BACK`
+- [scenario/history.md](../scenario/history.md) — `HISTORY`: `GET` / `KEYS` / `LOAD`; journal write and `BACK`
 - [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
 - [text.md](../text/text.md) — `TEXT`: EVENTS.REPLACE

package/plugins/views.screens/intro.md

@@ -1,50 +1,50 @@
 # plugins/views.screens/intro/
 
-Пакет: `@vnejs/plugins.views.screens.intro` · namespace: `INTRO`
+Package: `@vnejs/plugins.views.screens.intro` · namespace: `INTRO`
 
-Вступительный экран сценария с пропуском по клику, interact или skip.
+Scenario intro screen with skip on click, interact, or skip.
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.screens.intro`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.views.screens.intro`.
 
-| Ключ           | Строка                   | Смысл                                           |
-| -------------- | ------------------------ | ----------------------------------------------- |
-| `SHOW`         | `vne:intro:show`         | Показать UI или слой.                           |
-| `HIDE`         | `vne:intro:hide`         | Скрыть UI или слой.                             |
-| `CLICK`        | `vne:intro:click`        | Продвинуть сценарий к следующей строке.         |
-| `UPDATE`       | `vne:intro:update`       | Обновить состояние или отображение.             |
-| `UPDATE_FAST`  | `vne:intro:update_fast`  | Перерисовать view с `isFast`.                   |
-| `UPDATE_FORCE` | `vne:intro:update_force` | Перерисовать view с `isForce`, стейт не меняет. |
-| `SKIP`         | `vne:intro:skip`         | Продвинуть сценарий к следующей строке.         |
-| `INTERACT`     | `vne:intro:interact`     | Продвинуть сценарий к следующей строке.         |
-| `UPDATE_STATE` | `vne:intro:update_state` | Слить partial в стейт.                          |
+| Key            | String                   | Meaning                                                |
+| -------------- | ------------------------ | ------------------------------------------------------ |
+| `SHOW`         | `vne:intro:show`         | Show the UI or layer.                                  |
+| `HIDE`         | `vne:intro:hide`         | Hide the UI or layer.                                  |
+| `CLICK`        | `vne:intro:click`        | Advance the scenario to the next line.                 |
+| `UPDATE`       | `vne:intro:update`       | Update state or display.                               |
+| `UPDATE_FAST`  | `vne:intro:update_fast`  | Redraw the view with `isFast`.                         |
+| `UPDATE_FORCE` | `vne:intro:update_force` | Redraw the view with `isForce`; state does not change. |
+| `SKIP`         | `vne:intro:skip`         | Advance the scenario to the next line.                 |
+| `INTERACT`     | `vne:intro:interact`     | Advance the scenario to the next line.                 |
+| `UPDATE_STATE` | `vne:intro:update_state` | Merge a partial into state.                            |
 
-## Константы
+## Constants
 
 - **`LOGS_ACTIONS`** — `click`, `interact`, `skip`.
 
-## Параметры
+## Parameters
 
-| Ключ         | Тип      | Смысл                                |
-| ------------ | -------- | ------------------------------------ |
-| `BACKGROUND` | `string` | Значение по умолчанию: "BACKGROUND". |
+| Key          | Type     | Meaning                |
+| ------------ | -------- | ---------------------- |
+| `BACKGROUND` | `string` | Default: "BACKGROUND". |
 
-## Настройки
+## Settings
 
-Нет.
+None.
 
-## Модули
+## Modules
 
-| Модуль                      | Зона ответственности                                                                                                                            |
-| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
-| `intro.controller`          | SHOW/HIDE по фазам `CONST.COMPONENTS.LIFECYCLE_PRIORITY`; `UPDATE_STATE` / `UPDATE_FAST`.                                                       |
-| `intro.controller.interact` | Наследует `@vnejs/module.controller.interact`: `BUTTONS.ANY` → `INTERACT.EMIT`; `onInteract` → `INTRO.INTERACT`; `CONTROLS_CHECK_NEXT = false`. |
-| `intro.controller.bg`       | Наследует `@vnejs/module.controller.bg`: `SHOW` + `LIFECYCLE_PRIORITY.SHOW.BEFORE` → `bgSrc`; `start` preload.                                  |
-| `intro`                     | Связь со сценарием: шаг next после завершения действия.                                                                                         |
-| `intro.view`                | Подмодуль `view` плагина.                                                                                                                       |
+| Module                      | Role                                                                                                                                          |
+| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
+| `intro.controller`          | SHOW/HIDE by `CONST.COMPONENTS.LIFECYCLE_PRIORITY` phases; `UPDATE_STATE` / `UPDATE_FAST`.                                                    |
+| `intro.controller.interact` | Extends `@vnejs/module.controller.interact`: `BUTTONS.ANY` → `INTERACT.EMIT`; `onInteract` → `INTRO.INTERACT`; `CONTROLS_CHECK_NEXT = false`. |
+| `intro.controller.bg`       | Extends `@vnejs/module.controller.bg`: `SHOW` + `LIFECYCLE_PRIORITY.SHOW.BEFORE` → `bgSrc`; `start` preload.                                  |
+| `intro`                     | Scenario link: next step after the action finishes.                                                                                           |
+| `intro.view`                | Plugin `view` submodule.                                                                                                                      |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
@@ -53,6 +53,6 @@ Payloads и результаты хендлеров типизированы ч
 - [scenario.md](../core/scenario.md) — `SCENARIO`: EVENTS.NEXT, EVENTS.LINE_EXEC_REG, CONST.LINE_KEYWORDS.SKIP_IF_POSSIBLE
 - [system.md](../core/system.md) — `SYSTEM`: EVENTS.STARTED
 
-### Остальные
+### Other
 
 - [controls.md](../controls/controls.md) — `CONTROLS`: CONST.BUTTONS.ANY

package/plugins/views.screens/loading.md

@@ -1,47 +1,47 @@
 # plugins/views.screens/loading/
 
-Пакет: `@vnejs/plugins.views.screens.loading` · namespace: `LOADING`
+Package: `@vnejs/plugins.views.screens.loading` · namespace: `LOADING`
 
-Экран загрузки поверх игры на время асинхронных операций с минимальной длительностью.
+Loading screen over the game during async work, with a minimum show time.
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.screens.loading`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.views.screens.loading`.
 
-| Ключ           | Строка                     | Смысл                                           |
-| -------------- | -------------------------- | ----------------------------------------------- |
-| `SHOW`         | `vne:loading:show`         | Показать UI или слой.                           |
-| `HIDE`         | `vne:loading:hide`         | Скрыть UI или слой.                             |
-| `EMIT`         | `vne:loading:emit`         | Записать диагностическое сообщение в лог.       |
-| `UPDATE`       | `vne:loading:update`       | Обновить состояние или отображение.             |
-| `UPDATE_FAST`  | `vne:loading:update_fast`  | Перерисовать view с `isFast`.                   |
-| `UPDATE_FORCE` | `vne:loading:update_force` | Перерисовать view с `isForce`, стейт не меняет. |
-| `UPDATE_STATE` | `vne:loading:update_state` | Слить partial в стейт.                          |
+| Key            | String                     | Meaning                                                |
+| -------------- | -------------------------- | ------------------------------------------------------ |
+| `SHOW`         | `vne:loading:show`         | Show the UI or layer.                                  |
+| `HIDE`         | `vne:loading:hide`         | Hide the UI or layer.                                  |
+| `EMIT`         | `vne:loading:emit`         | Write a diagnostic message to the log.                 |
+| `UPDATE`       | `vne:loading:update`       | Update state or display.                               |
+| `UPDATE_FAST`  | `vne:loading:update_fast`  | Redraw the view with `isFast`.                         |
+| `UPDATE_FORCE` | `vne:loading:update_force` | Redraw the view with `isForce`; state does not change. |
+| `UPDATE_STATE` | `vne:loading:update_state` | Merge a partial into state.                            |
 
-## Константы
+## Constants
 
 - **`LOGS_ACTIONS`** — `start`, `finish`.
 
-## Параметры
+## Parameters
 
-| Ключ            | Тип      | Смысл                                   |
-| --------------- | -------- | --------------------------------------- |
-| `MIN_SHOW_TIME` | `string` | Значение по умолчанию: "MIN_SHOW_TIME". |
+| Key             | Type     | Meaning                   |
+| --------------- | -------- | ------------------------- |
+| `MIN_SHOW_TIME` | `string` | Default: "MIN_SHOW_TIME". |
 
-## Настройки
+## Settings
 
-Нет.
+None.
 
-## Модули
+## Modules
 
-| Модуль                  | Зона ответственности                                                                                                                          |
-| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
-| `loading.controller`    | SHOW/HIDE по фазам `CONST.COMPONENTS.LIFECYCLE_PRIORITY`; `UPDATE_STATE` / `UPDATE_FAST`.                                                     |
-| `loading.controller.bg` | Наследует `@vnejs/module.controller.bg`: `SHOW` + `LIFECYCLE_PRIORITY.SHOW.BEFORE` → `bgSrc`; `start`; `MEMORY.CLEARED` refresh при `isShow`. |
-| `loading`               | Точка входа emit: подготовка и запуск process.                                                                                                |
-| `loading.view`          | Подмодуль `view` плагина.                                                                                                                     |
+| Module                  | Role                                                                                                                                         |
+| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
+| `loading.controller`    | SHOW/HIDE by `CONST.COMPONENTS.LIFECYCLE_PRIORITY` phases; `UPDATE_STATE` / `UPDATE_FAST`.                                                   |
+| `loading.controller.bg` | Extends `@vnejs/module.controller.bg`: `SHOW` + `LIFECYCLE_PRIORITY.SHOW.BEFORE` → `bgSrc`; `start`; `MEMORY.CLEARED` refresh when `isShow`. |
+| `loading`               | Emit entry point: prepare and run process.                                                                                                   |
+| `loading.view`          | Plugin `view` submodule.                                                                                                                     |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
@@ -49,6 +49,6 @@ Payloads и результаты хендлеров типизированы ч
 - [memory.md](../core/memory.md) — `MEMORY`: EVENTS.CLEARED
 - [system.md](../core/system.md) — `SYSTEM`: EVENTS.STARTED
 
-### Остальные
+### Other
 
-— нет
+— None

package/plugins/views.screens/mainmenu.md

@@ -1,67 +1,67 @@
 # plugins/views.screens/mainmenu/
 
-Пакет: `@vnejs/plugins.views.screens.mainmenu` · namespace: `MAINMENU`
+Package: `@vnejs/plugins.views.screens.mainmenu` · namespace: `MAINMENU`
 
-Главное меню с пунктами, сменой фона и предзагрузкой меток сценария.
+Main menu with items, background rotation, and scenario label preload.
 
-Ротация `BACKGROUNDS`: модуль `mainmenu.backgrounds` по `SHOW` сразу грузит следующий фон и по `BACKGROUNDS_INTERVAL` эмитит `UPDATE_STATE` с `{ bgSrc }` и затем `UPDATE_FAST`.
+`BACKGROUNDS` rotation: `mainmenu.backgrounds` on `SHOW` loads the next background at once and on `BACKGROUNDS_INTERVAL` emits `UPDATE_STATE` with `{ bgSrc }` and then `UPDATE_FAST`.
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.screens.mainmenu`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.views.screens.mainmenu`.
 
-| Ключ           | Строка                      | Смысл                                                            |
-| -------------- | --------------------------- | ---------------------------------------------------------------- |
-| `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`       | Обновить состояние или отображение.                              |
-| `UPDATE_STATE` | `vne:mainmenu:update_state` | Слить partial в стейт контроллера без UPDATE view.               |
-| `UPDATE_FORCE` | `vne:mainmenu:update_force` | Перерисовать view с `isForce`, стейт не меняет.                  |
-| `UPDATE_FAST`  | `vne:mainmenu:update_fast`  | Перерисовать view с `isFast`, стейт не меняет.                   |
+| Key            | String                      | Meaning                                                      |
+| -------------- | --------------------------- | ------------------------------------------------------------ |
+| `HIDE`         | `vne:mainmenu:hide`         | Hide the UI or layer.                                        |
+| `SHOW`         | `vne:mainmenu:show`         | Show the UI or layer.                                        |
+| `ITEMS`        | `vne:mainmenu:items`        | Plugin namespace `ITEMS` event.                              |
+| `PRELOAD`      | `vne:mainmenu:preload`      | Preload `PRELOAD_LABELS` labels and `PRELOAD_EVENTS` events. |
+| `CLICK`        | `vne:mainmenu:click`        | Plugin namespace `CLICK` event.                              |
+| `ACCEPT`       | `vne:mainmenu:accept`       | Plugin namespace `ACCEPT` event.                             |
+| `UPDATE`       | `vne:mainmenu:update`       | Update state or display.                                     |
+| `UPDATE_STATE` | `vne:mainmenu:update_state` | Merge a partial into controller state without UPDATE view.   |
+| `UPDATE_FORCE` | `vne:mainmenu:update_force` | Redraw the view with `isForce`; state does not change.       |
+| `UPDATE_FAST`  | `vne:mainmenu:update_fast`  | Redraw the view with `isFast`; state does not change.        |
 
-## Константы
+## Constants
 
-Нет.
+None.
 
-## Параметры
+## Parameters
 
-| Ключ                   | Тип      | Смысл                                          |
-| ---------------------- | -------- | ---------------------------------------------- |
-| `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".           |
+| Key                    | Type     | Meaning                          |
+| ---------------------- | -------- | -------------------------------- |
+| `PRELOAD_LABELS`       | `string` | Label name or entry point.       |
+| `PRELOAD_EVENTS`       | `string` | Default: "PRELOAD_EVENTS".       |
+| `ITEMS`                | `string` | Default: "ITEMS".                |
+| `BACKGROUND`           | `string` | Default: "BACKGROUND".           |
+| `BACKGROUNDS`          | `string` | Default: "BACKGROUNDS".          |
+| `BACKGROUNDS_INTERVAL` | `string` | Default: "BACKGROUNDS_INTERVAL". |
+| `TRANSITION`           | `string` | Default: "TRANSITION".           |
+| `ZINDEX`               | `string` | Default: "ZINDEX".               |
+| `LOC_LABEL`            | `string` | Label name or entry point.       |
+| `VIEW_PROPS`           | `string` | Default: "VIEW_PROPS".           |
 
-## Настройки
+## Settings
 
-Нет.
+None.
 
-## Модули
+## Modules
 
-| Модуль                       | Зона ответственности                                                                                                                                                                                                                                                                        |
-| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `mainmenu.controller`        | UPDATE, SHOW, HIDE по фазам `CONST.COMPONENTS.LIFECYCLE_PRIORITY`; на `SHOW.BEFORE` — ITEMS. Пустой `controls` на `ZINDEX`. UPDATE_STATE, UPDATE_FAST, UPDATE_FORCE.                                                                                                                        |
-| `mainmenu.controller.bg`     | Наследует `@vnejs/module.controller.bg`: начальный `bgSrc` на `SHOW` + `LIFECYCLE_PRIORITY.SHOW.BEFORE`; `isShow` из `UPDATE_STATE`; `start` / `STATE.CLEAR` preload. Ротацию не трогает.                                                                                                   |
-| `mainmenu.hide`              | Наследует `@vnejs/module.controller.hide.on.state`: `STATE.SET` / `STATE.CLEAR` → `HIDE` с `{ isForce: true }`.                                                                                                                                                                             |
-| `mainmenu.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CLICK` по `currentArrowVerticalItem`; зеркалит `UPDATE_STATE`; PUSH/POP на SHOW/HIDE.                                                                                                                      |
-| `mainmenu.controller.arrows` | Наследует `@vnejs/module.controller.arrows.vertical`: `ARROW_UP` / `ARROW_BOTTOM` по видимым пунктам; PUSH/POP controls на SHOW/HIDE; эмитит `UPDATE_STATE` с `{ currentArrowVerticalItem }` и `UPDATE_FAST`. На `HIDE.CLEANUP` `currentArrowVerticalItem` в стейте становится `undefined`. |
-| `mainmenu.backgrounds`       | Наследует `@vnejs/module.controller.backgrounds`: ротация `BACKGROUNDS`, preload и таймер; `isShow` из `UPDATE_STATE`; эмитит `UPDATE_STATE` и `UPDATE_FAST`. Таймер снимается на `HIDE.AFTER`.                                                                                             |
-| `mainmenu.preload`           | Наследует `@vnejs/module.controller.preload`: по SHOW / PRELOAD грузит `PRELOAD_LABELS` и `PRELOAD_EVENTS`. `MEMORY.CLEARED` — только при `isShow` из `UPDATE_STATE`.                                                                                                                       |
-| `mainmenu.scenario`          | LINE_EXEC → SHOW, LINE_LOAD → PRELOAD.                                                                                                                                                                                                                                                      |
-| `mainmenu`                   | Обрабатывает ITEMS и CLICK.                                                                                                                                                                                                                                                                 |
-| `mainmenu.view`              | Подмодуль `view` плагина.                                                                                                                                                                                                                                                                   |
+| Module                       | Role                                                                                                                                                                                                                                                                                       |
+| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `mainmenu.controller`        | UPDATE, SHOW, HIDE by `CONST.COMPONENTS.LIFECYCLE_PRIORITY` phases; on `SHOW.BEFORE` — ITEMS. Empty `controls` on `ZINDEX`. UPDATE_STATE, UPDATE_FAST, UPDATE_FORCE.                                                                                                                       |
+| `mainmenu.controller.bg`     | Extends `@vnejs/module.controller.bg`: initial `bgSrc` on `SHOW` + `LIFECYCLE_PRIORITY.SHOW.BEFORE`; `isShow` from `UPDATE_STATE`; `start` / `STATE.CLEAR` preload. Does not handle rotation.                                                                                              |
+| `mainmenu.hide`              | Extends `@vnejs/module.controller.hide.on.state`: `STATE.SET` / `STATE.CLEAR` → `HIDE` with `{ isForce: true }`.                                                                                                                                                                           |
+| `mainmenu.controller.accept` | Extends `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CLICK` on `currentArrowVerticalItem`; mirrors `UPDATE_STATE`; PUSH/POP on SHOW/HIDE.                                                                                                                        |
+| `mainmenu.controller.arrows` | Extends `@vnejs/module.controller.arrows.vertical`: `ARROW_UP` / `ARROW_BOTTOM` over visible items; PUSH/POP controls on SHOW/HIDE; emits `UPDATE_STATE` with `{ currentArrowVerticalItem }` and `UPDATE_FAST`. On `HIDE.CLEANUP` `currentArrowVerticalItem` in state becomes `undefined`. |
+| `mainmenu.backgrounds`       | Extends `@vnejs/module.controller.backgrounds`: `BACKGROUNDS` rotation, preload, and timer; `isShow` from `UPDATE_STATE`; emits `UPDATE_STATE` and `UPDATE_FAST`. Timer clears on `HIDE.AFTER`.                                                                                            |
+| `mainmenu.preload`           | Extends `@vnejs/module.controller.preload`: on SHOW / PRELOAD loads `PRELOAD_LABELS` and `PRELOAD_EVENTS`. `MEMORY.CLEARED` — only when `isShow` from `UPDATE_STATE`.                                                                                                                      |
+| `mainmenu.scenario`          | LINE_EXEC → SHOW, LINE_LOAD → PRELOAD.                                                                                                                                                                                                                                                     |
+| `mainmenu`                   | Handles ITEMS and CLICK.                                                                                                                                                                                                                                                                   |
+| `mainmenu.view`              | Plugin `view` submodule.                                                                                                                                                                                                                                                                   |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
@@ -71,6 +71,6 @@ Payloads и результаты хендлеров типизированы ч
 - [state.md](../core/state.md) — `STATE`: EVENTS.SET, EVENTS.CLEAR
 - [system.md](../core/system.md) — `SYSTEM`: EVENTS.STARTED
 
-### Остальные
+### Other
 
 - [controls.md](../controls/controls.md) — `CONTROLS`: CONST.BUTTONS.ARROW_UP, CONST.BUTTONS.ARROW_BOTTOM, CONST.BUTTONS.ACCEPT, CONST.BUTTONS.INTERACT