@vnejs/docs 0.2.65 → 0.2.66

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

@@ -1,49 +1,49 @@
 # plugins/views.screens/mainmenu.socials/
 
-Пакет: `@vnejs/plugins.views.screens.mainmenu.socials` · namespace: `MAINMENU_SOCIALS_VIEW`
+Package: `@vnejs/plugins.views.screens.mainmenu.socials` · namespace: `MAINMENU_SOCIALS_VIEW`
 
-Блок иконок соцсетей, показываемый вместе с главным меню.
+Social icon block shown with the main menu.
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.screens.mainmenu.socials`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.views.screens.mainmenu.socials`.
 
-| Ключ           | Строка                              | Смысл                                           |
-| -------------- | ----------------------------------- | ----------------------------------------------- |
-| `UPDATE`       | `vne:mainmenu_socials:update`       | Обновить состояние или отображение.             |
-| `UPDATE_FAST`  | `vne:mainmenu_socials:update_fast`  | Быстрое обновление отображения.                 |
-| `UPDATE_FORCE` | `vne:mainmenu_socials:update_force` | Перерисовать view с `isForce`, стейт не меняет. |
-| `UPDATE_STATE` | `vne:mainmenu_socials:update_state` | Слить partial в стейт контроллера.              |
+| Key            | String                              | Meaning                                                |
+| -------------- | ----------------------------------- | ------------------------------------------------------ |
+| `UPDATE`       | `vne:mainmenu_socials:update`       | Update state or display.                               |
+| `UPDATE_FAST`  | `vne:mainmenu_socials:update_fast`  | Fast display update.                                   |
+| `UPDATE_FORCE` | `vne:mainmenu_socials:update_force` | Redraw the view with `isForce`; state does not change. |
+| `UPDATE_STATE` | `vne:mainmenu_socials:update_state` | Merge a partial into controller state.                 |
 
-## Константы
+## Constants
 
-Нет.
+None.
 
-## Параметры
+## Parameters
 
-| Ключ         | Тип      | Смысл                                |
-| ------------ | -------- | ------------------------------------ |
-| `VIEW_PROPS` | `string` | Значение по умолчанию: "VIEW_PROPS". |
+| Key          | Type     | Meaning                |
+| ------------ | -------- | ---------------------- |
+| `VIEW_PROPS` | `string` | Default: "VIEW_PROPS". |
 
-## Настройки
+## Settings
 
-Нет.
+None.
 
-## Модули
+## Modules
 
-| Модуль                        | Зона ответственности                                                                                                                                |
+| Module                        | Role                                                                                                                                                |
 | ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `mainmenu.socials.controller` | Обрабатывает UPDATE, SHOW, HIDE. Hide на `STATE.SET` / `STATE.CLEAR` идёт через `MAINMENU.HIDE` от `mainmenu.hide`, прямых подписок на `STATE` нет. |
-| `mainmenu.socials.view`       | Подмодуль `socials.view` плагина.                                                                                                                   |
+| `mainmenu.socials.controller` | Handles UPDATE, SHOW, HIDE. Hide on `STATE.SET` / `STATE.CLEAR` goes through `MAINMENU.HIDE` from `mainmenu.hide`; no direct `STATE` subscriptions. |
+| `mainmenu.socials.view`       | Plugin `socials.view` submodule.                                                                                                                    |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
 - [memory.md](../core/memory.md) — `MEMORY`: EVENTS.CLEARED
 - [system.md](../core/system.md) — `SYSTEM`: EVENTS.STARTED
 
-### Остальные
+### Other
 
 - [layer.md](../canvas/layer.md) — `LAYER`: SETTINGS.QUALITY
-- [mainmenu.md](./mainmenu.md) — `MAINMENU`: EVENTS.SHOW, EVENTS.HIDE; hide на STATE через `mainmenu.hide`
+- [mainmenu.md](./mainmenu.md) — `MAINMENU`: EVENTS.SHOW, EVENTS.HIDE; hide on STATE via `mainmenu.hide`

package/plugins/views.screens/save.md

@@ -1,70 +1,70 @@
 # plugins/views.screens/save/
 
-Пакет: `@vnejs/plugins.views.screens.save` · namespace: `SAVE_VIEW`
-
-Экран сохранения и загрузки с сеткой слотов и вкладками save/load/autosave.
-
-ACCEPT/INTERACT повторяет клик по слоту: на вкладке save — `CREATE`, на load/autosave — `LOAD` только если у слота есть `screen`.
-
-## События
-
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.screens.save`.
-
-| Ключ                | Строка                            | Смысл                                                                                                                                                 |
-| ------------------- | --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `SHOW`              | `vne:save_view:show`              | Показать UI или слой.                                                                                                                                 |
-| `HIDE`              | `vne:save_view:hide`              | Скрыть UI или слой.                                                                                                                                   |
-| `PAGE_SET`          | `vne:save_view:page_set`          | Абсолютный прыжок пагинации UI (`{ pageIndex }`).                                                                                                     |
-| `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`            | Обновить состояние или отображение.                                                                                                                   |
-| `UPDATE_FAST`       | `vne:save_view:update_fast`       | Перерисовать view с `isFast`, без смены стейта.                                                                                                       |
-| `UPDATE_FORCE`      | `vne:save_view:update_force`      | Перерисовать view с `isForce`, стейт не меняет.                                                                                                       |
-| `PRELOAD`           | `vne:save_view:preload`           | Событие `PRELOAD` namespace плагина.                                                                                                                  |
-| `ACCEPT`            | `vne:save_view:accept`            | ACCEPT / INTERACT по выбранному слоту.                                                                                                                |
-| `UPDATE_STATE`      | `vne:save_view:update_state`      | Слить partial в стейт controller/accept/grid без UPDATE view.                                                                                         |
-| `GRID_NEXT`         | `vne:save_view:grid_next`         | Край сетки вперёд; `save.controller.pages` слушает как `EVENT_PAGE_NEXT` (намеренный мост, без знания сетки в pages).                                 |
-| `GRID_PREV`         | `vne:save_view:grid_prev`         | Край сетки назад; `save.controller.pages` слушает как `EVENT_PAGE_PREV`.                                                                              |
-| `GRID_CLEAR`        | `vne:save_view:grid_clear`        | Сбросить выбор ячейки: `gridRow` / `gridColumn` → `null` (+ `UPDATE_STATE`).                                                                          |
-| `GRID_UPDATE_ITEMS` | `vne:save_view:grid_update_items` | Пересобрать сетку из стейта (без payload) → `UPDATE_STATE` `{ gridItems }`. Meta (`gridIndex` / `gridsCount` / `tab`) — заранее через `UPDATE_STATE`. |
-| `SLOT_CREATE`       | `vne:save_view:slot_create`       | Собрать UI-слот → `SAVE.GET` + дата/время; result: `SaveViewSlotCreateResult`.                                                                        |
-
-## Константы
-
-Нет.
-
-## Параметры
-
-| Ключ         | Тип      | Смысл                                                                             |
-| ------------ | -------- | --------------------------------------------------------------------------------- |
-| `BACKGROUND` | `string` | Значение по умолчанию: "BACKGROUND".                                              |
-| `AUDIO_NAME` | `string` | Имя трека на слое `view` при открытии экрана; пустая строка — без overlay-музыки. |
-
-## Настройки
-
-Нет.
-
-## Модули
-
-| Модуль                    | Зона ответственности                                                                                                                                                                                                                                                                                                                           |
-| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `save.controller.audio`   | Наследник `ModuleControllerAudio`: SHOW/HIDE/PRELOAD → pause global, play/stop `view`-трека; `VOLUME_SETTING = MUSIC.VOLUME`; SHOW передаёт в `AUDIO.PLAY` уже посчитанный `volume`; при `VOLUME_CHANGED` / смене `VOLUME_SETTING` — повторный `AUDIO.VOLUME`.                                                                                 |
-| `save.controller`         | SHOW/HIDE по фазам `CONST.COMPONENTS.LIFECYCLE_PRIORITY`; на `SHOW.BEFORE` — `TAB_SET`. `UPDATE_STATE` / `UPDATE_FAST`; пустой `controls` на `ZINDEX`.                                                                                                                                                                                         |
-| `save.controller.bg`      | Наследует `@vnejs/module.controller.bg`: `SHOW` + `LIFECYCLE_PRIORITY.SHOW.BEFORE` → `bgSrc`; PRELOAD / `start`; `MEMORY.CLEARED` — preload и refresh при `isShow`.                                                                                                                                                                            |
-| `save.controller.actions` | CREATE → `SAVE.CREATE`, DELETE → `SAVE.DELETE`; `group` из payload или `getSaveGroup` (autosave / `pageIndex`); затем `GRID_UPDATE_ITEMS` + `UPDATE_FAST`.                                                                                                                                                                                     |
-| `save.controller.pages`   | Наследует `@vnejs/module.controller.pages`: `EVENT_*` → `SAVE_VIEW`; `applyPage` → `UPDATE_STATE` `{ gridIndex, gridsCount }` + `GRID_UPDATE_ITEMS`; `init` пишет `pagesCount`.                                                                                                                                                                |
-| `save.controller.accept`  | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CREATE` на вкладке save, иначе `LOAD` при `screen`; зеркалит `UPDATE_STATE`; PUSH/POP на SHOW/HIDE.                                                                                                                                                           |
-| `save.controller.grid`    | Наследует `@vnejs/module.controller.arrows.grid`: четыре стрелки; `isDisableGridChangeVertical = true` (вертикаль не листает страницы); на краю колонок — `GRID_NEXT`/`PREV`; `GRID_CLEAR`; `GRID_UPDATE_ITEMS` → `getGridItems` / `UPDATE_STATE` `{ gridItems }`. На `HIDE.CLEANUP` `gridRow` / `gridColumn` в стейте становятся `undefined`. |
-| `save.view.slot`          | На `SLOT_CREATE` собирает UI-слот: `SAVE.GET` → `screen` / `ts` / `date` / `time` / `locKey`.                                                                                                                                                                                                                                                  |
-| `save.hide.controls`      | Наследует `@vnejs/module.controller.hide.on.controls`: `BACK` / `MENU` / `GAMEMENU` → `HIDE`; PUSH/POP на SHOW/HIDE.                                                                                                                                                                                                                           |
-| `save.hide.state`         | Наследует `@vnejs/module.controller.hide.on.state`: `STATE.SET` / `STATE.CLEAR` → `HIDE` с `{ isForce: true }`.                                                                                                                                                                                                                                |
-| `save.controller.tabs`    | Наследник `ModuleControllerTabs`: `TAB_SET` → `applyTab` + `onTabSet` (`pageIndex: 0`, `GRID_CLEAR`, `UPDATE_STATE` `{ gridIndex, gridsCount }`, `GRID_UPDATE_ITEMS`, опционально `UPDATE_FAST`); TAB_PREV/TAB_NEXT → `TAB_SET`; `getTabKeys` фильтрует SAVE vs LOAD/AUTOSAVE.                                                                 |
-| `save.controller.load`    | Подмодуль `controller.load` плагина.                                                                                                                                                                                                                                                                                                           |
-| `save.view`               | Подмодуль `view` плагина.                                                                                                                                                                                                                                                                                                                      |
-
-## Близкие плагины
+Package: `@vnejs/plugins.views.screens.save` · namespace: `SAVE_VIEW`
+
+Save and load screen with a slot grid and save/load/autosave tabs.
+
+ACCEPT/INTERACT repeats a slot click: on the save tab — `CREATE`; on load/autosave — `LOAD` only if the slot has `screen`.
+
+## Events
+
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.views.screens.save`.
+
+| Key                 | String                            | Meaning                                                                                                                                                |
+| ------------------- | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `SHOW`              | `vne:save_view:show`              | Show the UI or layer.                                                                                                                                  |
+| `HIDE`              | `vne:save_view:hide`              | Hide the UI or layer.                                                                                                                                  |
+| `PAGE_SET`          | `vne:save_view:page_set`          | Absolute UI pagination jump (`{ pageIndex }`).                                                                                                         |
+| `TAB_SET`           | `vne:save_view:tab_set`           | Pick save/load/autosave tab (`{ tab }`).                                                                                                               |
+| `CREATE`            | `vne:save_view:create`            | Create a slot (`{ key, group }`) → `SAVE.CREATE`.                                                                                                      |
+| `DELETE`            | `vne:save_view:delete`            | Delete a slot (`{ key, group }`) → `SAVE.DELETE`.                                                                                                      |
+| `LOAD`              | `vne:save_view:load`              | Load a slot (`{ key, group }`) → `SAVE.PRELOAD` / `SAVE.LOAD`.                                                                                         |
+| `UPDATE`            | `vne:save_view:update`            | Update state or display.                                                                                                                               |
+| `UPDATE_FAST`       | `vne:save_view:update_fast`       | Redraw the view with `isFast`, without a state change.                                                                                                 |
+| `UPDATE_FORCE`      | `vne:save_view:update_force`      | Redraw the view with `isForce`; state does not change.                                                                                                 |
+| `PRELOAD`           | `vne:save_view:preload`           | Plugin namespace `PRELOAD` event.                                                                                                                      |
+| `ACCEPT`            | `vne:save_view:accept`            | ACCEPT / INTERACT on the selected slot.                                                                                                                |
+| `UPDATE_STATE`      | `vne:save_view:update_state`      | Merge a partial into controller/accept/grid state without an UPDATE view.                                                                              |
+| `GRID_NEXT`         | `vne:save_view:grid_next`         | Grid edge forward; `save.controller.pages` listens as `EVENT_PAGE_NEXT` (intentional bridge, pages module knows nothing about the grid).               |
+| `GRID_PREV`         | `vne:save_view:grid_prev`         | Grid edge backward; `save.controller.pages` listens as `EVENT_PAGE_PREV`.                                                                              |
+| `GRID_CLEAR`        | `vne:save_view:grid_clear`        | Clear cell selection: `gridRow` / `gridColumn` → `null` (+ `UPDATE_STATE`).                                                                            |
+| `GRID_UPDATE_ITEMS` | `vne:save_view:grid_update_items` | Rebuild the grid from state (no payload) → `UPDATE_STATE` `{ gridItems }`. Meta (`gridIndex` / `gridsCount` / `tab`) — set earlier via `UPDATE_STATE`. |
+| `SLOT_CREATE`       | `vne:save_view:slot_create`       | Build a UI slot → `SAVE.GET` + date/time; result: `SaveViewSlotCreateResult`.                                                                          |
+
+## Constants
+
+None.
+
+## Parameters
+
+| Key          | Type     | Meaning                                                                                |
+| ------------ | -------- | -------------------------------------------------------------------------------------- |
+| `BACKGROUND` | `string` | Default: "BACKGROUND".                                                                 |
+| `AUDIO_NAME` | `string` | Track name on the `view` layer when the screen opens; empty string — no overlay music. |
+
+## Settings
+
+None.
+
+## Modules
+
+| Module                    | Role                                                                                                                                                                                                                                                                                                                                |
+| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `save.controller.audio`   | `ModuleControllerAudio` subclass: SHOW/HIDE/PRELOAD → pause global, play/stop `view` track; `VOLUME_SETTING = MUSIC.VOLUME`; SHOW passes a computed `volume` into `AUDIO.PLAY`; on `VOLUME_CHANGED` / `VOLUME_SETTING` change — `AUDIO.VOLUME` again.                                                                               |
+| `save.controller`         | SHOW/HIDE by `CONST.COMPONENTS.LIFECYCLE_PRIORITY` phases; on `SHOW.BEFORE` — `TAB_SET`. `UPDATE_STATE` / `UPDATE_FAST`; empty `controls` on `ZINDEX`.                                                                                                                                                                              |
+| `save.controller.bg`      | Extends `@vnejs/module.controller.bg`: `SHOW` + `LIFECYCLE_PRIORITY.SHOW.BEFORE` → `bgSrc`; PRELOAD / `start`; `MEMORY.CLEARED` — preload and refresh when `isShow`.                                                                                                                                                                |
+| `save.controller.actions` | CREATE → `SAVE.CREATE`, DELETE → `SAVE.DELETE`; `group` from payload or `getSaveGroup` (autosave / `pageIndex`); then `GRID_UPDATE_ITEMS` + `UPDATE_FAST`.                                                                                                                                                                          |
+| `save.controller.pages`   | Extends `@vnejs/module.controller.pages`: `EVENT_*` → `SAVE_VIEW`; `applyPage` → `UPDATE_STATE` `{ gridIndex, gridsCount }` + `GRID_UPDATE_ITEMS`; `init` sets `pagesCount`.                                                                                                                                                        |
+| `save.controller.accept`  | Extends `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CREATE` on save tab, else `LOAD` when `screen`; mirrors `UPDATE_STATE`; PUSH/POP on SHOW/HIDE.                                                                                                                                                       |
+| `save.controller.grid`    | Extends `@vnejs/module.controller.arrows.grid`: four arrows; `isDisableGridChangeVertical = true` (vertical does not flip pages); at column edge — `GRID_NEXT`/`PREV`; `GRID_CLEAR`; `GRID_UPDATE_ITEMS` → `getGridItems` / `UPDATE_STATE` `{ gridItems }`. On `HIDE.CLEANUP` `gridRow` / `gridColumn` in state become `undefined`. |
+| `save.view.slot`          | On `SLOT_CREATE` builds a UI slot: `SAVE.GET` → `screen` / `ts` / `date` / `time` / `locKey`.                                                                                                                                                                                                                                       |
+| `save.hide.controls`      | Extends `@vnejs/module.controller.hide.on.controls`: `BACK` / `MENU` / `GAMEMENU` → `HIDE`; PUSH/POP on SHOW/HIDE.                                                                                                                                                                                                                  |
+| `save.hide.state`         | Extends `@vnejs/module.controller.hide.on.state`: `STATE.SET` / `STATE.CLEAR` → `HIDE` with `{ isForce: true }`.                                                                                                                                                                                                                    |
+| `save.controller.tabs`    | `ModuleControllerTabs` subclass: `TAB_SET` → `applyTab` + `onTabSet` (`pageIndex: 0`, `GRID_CLEAR`, `UPDATE_STATE` `{ gridIndex, gridsCount }`, `GRID_UPDATE_ITEMS`, optional `UPDATE_FAST`); TAB_PREV/TAB_NEXT → `TAB_SET`; `getTabKeys` filters SAVE vs LOAD/AUTOSAVE.                                                            |
+| `save.controller.load`    | Plugin `controller.load` submodule.                                                                                                                                                                                                                                                                                                 |
+| `save.view`               | Plugin `view` submodule.                                                                                                                                                                                                                                                                                                            |
+
+## Related plugins
 
 ### plugins/core/
 
@@ -74,7 +74,7 @@ Payloads и результаты хендлеров типизированы ч
 - [system.md](../core/system.md) — `SYSTEM`: EVENTS.STARTED
 - [vendors.md](../core/vendors.md) — `VENDORS`: EVENTS.DATE
 
-### Остальные
+### Other
 
 - [audio.md](../audio/audio.md) — `AUDIO`: EVENTS.GLOBAL_PAUSE, EVENTS.PLAY, EVENTS.STOP, EVENTS.GLOBAL_RESUME, EVENTS.MEDIA_LOAD, EVENTS.VOLUME, EVENTS.VOLUME_CHANGED
 - [music.md](../audio/music.md) — `MUSIC`: SETTINGS.VOLUME

package/plugins/views.screens/settings.defaults.md

@@ -1,55 +1,55 @@
 # plugins/views.screens/settings.defaults/
 
-Пакет: `@vnejs/plugins.views.screens.settings.defaults` · namespace: `SETTINGS_DEFAULT_VIEW`
+Package: `@vnejs/plugins.views.screens.settings.defaults` · namespace: `SETTINGS_DEFAULT_VIEW`
 
-Экран выбора настроек по умолчанию при первом запуске сценария (chrome: title + Accept). Список полей и стрелки — в [`plugins/views/settings`](../views/settings.md) (`SETTINGS_VIEW`).
+Default settings picker on first scenario run (chrome: title + Accept). Field list and arrows — in [`plugins/views/settings`](../views/settings.md) (`SETTINGS_VIEW`).
 
-Breaking: раньше namespace был `SETTINGS_DEFAULTS`, события `vne:settings_defaults:*`, ключ `vne:settings_defaults:inited`.
+Breaking: namespace was `SETTINGS_DEFAULTS`, events `vne:settings_defaults:*`, key `vne:settings_defaults:inited`.
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.screens.settings.defaults`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.views.screens.settings.defaults`.
 
-| Ключ           | Строка                                   | Смысл                                           |
-| -------------- | ---------------------------------------- | ----------------------------------------------- |
-| `UPDATE`       | `vne:settings_default_view:update`       | Обновить состояние или отображение.             |
-| `UPDATE_FAST`  | `vne:settings_default_view:update_fast`  | Перерисовать view с `isFast`.                   |
-| `UPDATE_FORCE` | `vne:settings_default_view:update_force` | Перерисовать view с `isForce`, стейт не меняет. |
-| `SHOW`         | `vne:settings_default_view:show`         | Показать UI или слой.                           |
-| `HIDE`         | `vne:settings_default_view:hide`         | Скрыть UI или слой.                             |
-| `CONFIRM`      | `vne:settings_default_view:confirm`      | Продвинуть сценарий к следующей строке.         |
-| `UPDATE_STATE` | `vne:settings_default_view:update_state` | Слить partial в стейт.                          |
+| Key            | String                                   | Meaning                                                |
+| -------------- | ---------------------------------------- | ------------------------------------------------------ |
+| `UPDATE`       | `vne:settings_default_view:update`       | Update state or display.                               |
+| `UPDATE_FAST`  | `vne:settings_default_view:update_fast`  | Redraw the view with `isFast`.                         |
+| `UPDATE_FORCE` | `vne:settings_default_view:update_force` | Redraw the view with `isForce`; state does not change. |
+| `SHOW`         | `vne:settings_default_view:show`         | Show the UI or layer.                                  |
+| `HIDE`         | `vne:settings_default_view:hide`         | Hide the UI or layer.                                  |
+| `CONFIRM`      | `vne:settings_default_view:confirm`      | Advance the scenario to the next line.                 |
+| `UPDATE_STATE` | `vne:settings_default_view:update_state` | Merge a partial into state.                            |
 
-На `SHOW` с `CONST.COMPONENTS.LIFECYCLE_PRIORITY.SHOW.BEFORE` fields-модуль эмитит `SETTINGS_VIEW.SHOW` с `{ tab: TABS[CONST.SETTINGS_VIEW.DEFAULT_TAB], tabKey: CONST.SETTINGS_VIEW.DEFAULT_TAB, locs }`. На `HIDE` с `LIFECYCLE_PRIORITY.HIDE.BEFORE` — `SETTINGS_VIEW.HIDE`.
+On `SHOW` with `CONST.COMPONENTS.LIFECYCLE_PRIORITY.SHOW.BEFORE` the fields module emits `SETTINGS_VIEW.SHOW` with `{ tab: TABS[CONST.SETTINGS_VIEW.DEFAULT_TAB], tabKey: CONST.SETTINGS_VIEW.DEFAULT_TAB, locs }`. On `HIDE` with `LIFECYCLE_PRIORITY.HIDE.BEFORE` — `SETTINGS_VIEW.HIDE`.
 
-## Константы
+## Constants
 
-Нет.
+None.
 
-## Параметры
+## Parameters
 
-| Ключ         | Тип      | Смысл                                |
-| ------------ | -------- | ------------------------------------ |
-| `BACKGROUND` | `string` | Значение по умолчанию: "BACKGROUND". |
+| Key          | Type     | Meaning                |
+| ------------ | -------- | ---------------------- |
+| `BACKGROUND` | `string` | Default: "BACKGROUND". |
 
-## Настройки
+## Settings
 
-| Ключ                                          | Тип      | Смысл                          |
-| --------------------------------------------- | -------- | ------------------------------ |
-| `INITED` (`vne:settings_default_view:inited`) | `string` | Настройка в `shared.settings`. |
+| Key                                           | Type     | Meaning                       |
+| --------------------------------------------- | -------- | ----------------------------- |
+| `INITED` (`vne:settings_default_view:inited`) | `string` | Setting in `shared.settings`. |
 
-## Модули
+## Modules
 
-| Модуль                               | Зона ответственности                                                                                                                                                      |
-| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `settings.default.controller`        | SHOW/HIDE по фазам `CONST.COMPONENTS.LIFECYCLE_PRIORITY`; на `HIDE.BEFORE` — `SETTINGS_VIEW.HIDE`. `UPDATE_STATE` / `UPDATE_FAST`.                                        |
-| `settings.default.controller.bg`     | Наследует `@vnejs/module.controller.bg`: `SHOW` + `LIFECYCLE_PRIORITY.SHOW.BEFORE` → `bgSrc`; `MEMORY.CLEARED` при `isShow` → refresh.                                    |
-| `settings.default.controller.fields` | На `SHOW` + `LIFECYCLE_PRIORITY.SHOW.BEFORE`: `UPDATE_STATE` `{ tab }` + `SETTINGS_VIEW.SHOW` с `CONST.SETTINGS_VIEW.DEFAULT_TAB`.                                        |
-| `settings.default.controller.accept` | Наследует `@vnejs/module.controller.accept`: только `ACCEPT` (`IS_INTERACT_ENABLED = false`) → `CONFIRM` → `INITED`, `HIDE`, `emit SCENARIO.NEXT`; PUSH/POP на SHOW/HIDE. |
-| `settings.default`                   | `SETTINGS.INIT` INITED в `setup`; `LINE_EXEC` как `$ settings.defaults` → `SHOW`, либо `emit SCENARIO.NEXT` при `skip_if_possible` и `INITED`.                            |
-| `settings.default.view`              | Chrome: title + кнопка Accept.                                                                                                                                            |
+| Module                               | Role                                                                                                                                                                  |
+| ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `settings.default.controller`        | SHOW/HIDE by `CONST.COMPONENTS.LIFECYCLE_PRIORITY` phases; on `HIDE.BEFORE` — `SETTINGS_VIEW.HIDE`. `UPDATE_STATE` / `UPDATE_FAST`.                                   |
+| `settings.default.controller.bg`     | Extends `@vnejs/module.controller.bg`: `SHOW` + `LIFECYCLE_PRIORITY.SHOW.BEFORE` → `bgSrc`; `MEMORY.CLEARED` when `isShow` → refresh.                                 |
+| `settings.default.controller.fields` | On `SHOW` + `LIFECYCLE_PRIORITY.SHOW.BEFORE`: `UPDATE_STATE` `{ tab }` + `SETTINGS_VIEW.SHOW` with `CONST.SETTINGS_VIEW.DEFAULT_TAB`.                                 |
+| `settings.default.controller.accept` | Extends `@vnejs/module.controller.accept`: only `ACCEPT` (`IS_INTERACT_ENABLED = false`) → `CONFIRM` → `INITED`, `HIDE`, `emit SCENARIO.NEXT`; PUSH/POP on SHOW/HIDE. |
+| `settings.default`                   | `SETTINGS.INIT` INITED in `setup`; `LINE_EXEC` as `$ settings.defaults` → `SHOW`, or `emit SCENARIO.NEXT` when `skip_if_possible` and `INITED`.                       |
+| `settings.default.view`              | Chrome: title + Accept button.                                                                                                                                        |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
@@ -58,7 +58,7 @@ Payloads и результаты хендлеров типизированы ч
 - [scenario.md](../core/scenario.md) — `SCENARIO`: EVENTS.NEXT, EVENTS.LINE_EXEC_REG, CONST.LINE_KEYWORDS.SKIP_IF_POSSIBLE
 - [settings.md](../core/settings.md) — `SETTINGS`: EVENTS.CHANGED, EVENTS.INIT, EVENTS.SET
 
-### Остальные
+### Other
 
-- [settings.md](../views/settings.md) — `SETTINGS_VIEW`: `CONST.DEFAULT_TAB`, стрелки
+- [settings.md](../views/settings.md) — `SETTINGS_VIEW`: `CONST.DEFAULT_TAB`, arrows
 - [controls.md](../controls/controls.md) — `CONTROLS`: CONST.BUTTONS.ACCEPT

package/plugins/views.screens/settings.md

@@ -1,58 +1,58 @@
 # plugins/views.screens/settings/
 
-Пакет: `@vnejs/plugins.views.screens.settings` · namespace: `SETTINGS_SCREEN_VIEW`
+Package: `@vnejs/plugins.views.screens.settings` · namespace: `SETTINGS_SCREEN_VIEW`
 
-Экран настроек с вкладками (chrome: Screen, tabs, cross, example text). Список полей и стрелки — в [`plugins/views/settings`](../views/settings.md) (`SETTINGS_VIEW`).
+Settings screen with tabs (chrome: Screen, tabs, cross, example text). Field list and arrows — in [`plugins/views/settings`](../views/settings.md) (`SETTINGS_VIEW`).
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.screens.settings`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.views.screens.settings`.
 
-| Ключ           | Строка                                  | Смысл                                                                        |
-| -------------- | --------------------------------------- | ---------------------------------------------------------------------------- |
-| `SHOW`         | `vne:settings_screen_view:show`         | Показать UI или слой.                                                        |
-| `HIDE`         | `vne:settings_screen_view:hide`         | Скрыть UI или слой.                                                          |
-| `UPDATE`       | `vne:settings_screen_view:update`       | Обновить состояние или отображение.                                          |
-| `UPDATE_FAST`  | `vne:settings_screen_view:update_fast`  | Перерисовать view с `isFast`, без смены стейта.                              |
-| `UPDATE_FORCE` | `vne:settings_screen_view:update_force` | Перерисовать view с `isForce`, стейт не меняет.                              |
-| `PRELOAD`      | `vne:settings_screen_view:preload`      | Событие `PRELOAD` namespace плагина.                                         |
-| `TAB_SET`      | `vne:settings_screen_view:tab_set`      | Выбрать вкладку по ключу из `PARAMS.SETTINGS_VIEW.TABS` (`{ tab: string }`). |
-| `UPDATE_STATE` | `vne:settings_screen_view:update_state` | Слить partial в стейт (в т.ч. `{ tab }` из tabs-модуля).                     |
+| Key            | String                                  | Meaning                                                                 |
+| -------------- | --------------------------------------- | ----------------------------------------------------------------------- |
+| `SHOW`         | `vne:settings_screen_view:show`         | Show the UI or layer.                                                   |
+| `HIDE`         | `vne:settings_screen_view:hide`         | Hide the UI or layer.                                                   |
+| `UPDATE`       | `vne:settings_screen_view:update`       | Update state or display.                                                |
+| `UPDATE_FAST`  | `vne:settings_screen_view:update_fast`  | Redraw the view with `isFast`, without a state change.                  |
+| `UPDATE_FORCE` | `vne:settings_screen_view:update_force` | Redraw the view with `isForce`; state does not change.                  |
+| `PRELOAD`      | `vne:settings_screen_view:preload`      | Plugin namespace `PRELOAD` event.                                       |
+| `TAB_SET`      | `vne:settings_screen_view:tab_set`      | Pick a tab by key from `PARAMS.SETTINGS_VIEW.TABS` (`{ tab: string }`). |
+| `UPDATE_STATE` | `vne:settings_screen_view:update_state` | Merge a partial into state (incl. `{ tab }` from the tabs module).      |
 
-На `SHOW` с `CONST.COMPONENTS.LIFECYCLE_PRIORITY.SHOW.BEFORE` fields-модуль и фон готовят экран: fields эмитит `SETTINGS_VIEW.SHOW` с `{ tab, tabs, tabKey, locs }`. На `TAB_SET` экрана tabs-модуль шлёт `UPDATE_STATE` `{ tab }`, затем `UPDATE_FAST` (chrome) и `SETTINGS_VIEW.TAB_SET` (контент). На `HIDE` с `LIFECYCLE_PRIORITY.HIDE.BEFORE` — `SETTINGS_VIEW.HIDE`.
+On `SHOW` with `CONST.COMPONENTS.LIFECYCLE_PRIORITY.SHOW.BEFORE` the fields module and background prepare the screen: fields emits `SETTINGS_VIEW.SHOW` with `{ tab, tabs, tabKey, locs }`. On `TAB_SET` the screen tabs module sends `UPDATE_STATE` `{ tab }`, then `UPDATE_FAST` (chrome) and `SETTINGS_VIEW.TAB_SET` (content). On `HIDE` with `LIFECYCLE_PRIORITY.HIDE.BEFORE` — `SETTINGS_VIEW.HIDE`.
 
-## Константы
+## Constants
 
-Нет.
+None.
 
-## Параметры
+## Parameters
 
-| Ключ         | Тип      | Смысл                                                                             |
-| ------------ | -------- | --------------------------------------------------------------------------------- |
-| `TRANSITION` | `number` | Длительность анимации.                                                            |
-| `AUDIO_NAME` | `string` | Имя трека на слое `view` при открытии экрана; пустая строка — без overlay-музыки. |
-| `VIEW_PROPS` | object   | Chrome: `screen`, `cross`, `controls`.                                            |
+| Key          | Type     | Meaning                                                                                |
+| ------------ | -------- | -------------------------------------------------------------------------------------- |
+| `TRANSITION` | `number` | Animation duration.                                                                    |
+| `AUDIO_NAME` | `string` | Track name on the `view` layer when the screen opens; empty string — no overlay music. |
+| `VIEW_PROPS` | object   | Chrome: `screen`, `cross`, `controls`.                                                 |
 
-Схема полей (`TABS` / `VALUE_MAPS` / `ACTIONS` / `fieldProps`) — в `PARAMS.SETTINGS_VIEW`.
+Field schema (`TABS` / `VALUE_MAPS` / `ACTIONS` / `fieldProps`) — in `PARAMS.SETTINGS_VIEW`.
 
-## Настройки
+## Settings
 
-Нет.
+None.
 
-## Модули
+## Modules
 
-| Модуль                              | Зона ответственности                                                                                                                                                                                                                                           |
-| ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `settings.screen.controller.audio`  | Наследник `ModuleControllerAudio`: SHOW/HIDE/PRELOAD → pause global, play/stop `view`-трека; `VOLUME_SETTING = MUSIC.VOLUME`; SHOW передаёт в `AUDIO.PLAY` уже посчитанный `volume`; при `VOLUME_CHANGED` / смене `VOLUME_SETTING` — повторный `AUDIO.VOLUME`. |
-| `settings.screen.controller`        | SHOW/HIDE по фазам `CONST.COMPONENTS.LIFECYCLE_PRIORITY`; на `HIDE.BEFORE` эмитит `SETTINGS_VIEW.HIDE`. `UPDATE_STATE` → `updateState`; `UPDATE_FAST`. Пустой `controls` на `ZINDEX`.                                                                          |
-| `settings.screen.controller.bg`     | Наследует `@vnejs/module.controller.bg`: `SHOW` + `LIFECYCLE_PRIORITY.SHOW.BEFORE` → `bgSrc`; PRELOAD; `MEMORY.CLEARED` — preload и refresh при `isShow`.                                                                                                      |
-| `settings.screen.controller.fields` | На `SHOW` + `LIFECYCLE_PRIORITY.SHOW.BEFORE`: фильтр tabs (`showInSettings`) → `UPDATE_STATE` `{ tabs, tab }` → `SETTINGS_VIEW.SHOW`.                                                                                                                          |
-| `settings.screen.hide.controls`     | Наследует `@vnejs/module.controller.hide.on.controls`: `BACK` / `MENU` / `GAMEMENU` → `HIDE`; PUSH/POP на SHOW/HIDE.                                                                                                                                           |
-| `settings.screen.hide.state`        | Наследует `@vnejs/module.controller.hide.on.state`: `STATE.SET` / `STATE.CLEAR` → `HIDE` с `{ isForce: true }`.                                                                                                                                                |
-| `settings.screen.controller.tabs`   | Наследник `ModuleControllerTabs`: `TAB_SET` → `applyTab` + `onTabSet` (`UPDATE_FAST`, затем `SETTINGS_VIEW.TAB_SET`); TAB_PREV/TAB_NEXT → `TAB_SET`; `getTabKeys` по `showInSettings`.                                                                         |
-| `settings.screen.view`              | Chrome экрана (Screen, tabs, cross); поля и example text — в `SETTINGS_VIEW`.                                                                                                                                                                                  |
+| Module                              | Role                                                                                                                                                                                                                                                  |
+| ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `settings.screen.controller.audio`  | `ModuleControllerAudio` subclass: SHOW/HIDE/PRELOAD → pause global, play/stop `view` track; `VOLUME_SETTING = MUSIC.VOLUME`; SHOW passes a computed `volume` into `AUDIO.PLAY`; on `VOLUME_CHANGED` / `VOLUME_SETTING` change — `AUDIO.VOLUME` again. |
+| `settings.screen.controller`        | SHOW/HIDE by `CONST.COMPONENTS.LIFECYCLE_PRIORITY` phases; on `HIDE.BEFORE` emits `SETTINGS_VIEW.HIDE`. `UPDATE_STATE` → `updateState`; `UPDATE_FAST`. Empty `controls` on `ZINDEX`.                                                                  |
+| `settings.screen.controller.bg`     | Extends `@vnejs/module.controller.bg`: `SHOW` + `LIFECYCLE_PRIORITY.SHOW.BEFORE` → `bgSrc`; PRELOAD; `MEMORY.CLEARED` — preload and refresh when `isShow`.                                                                                            |
+| `settings.screen.controller.fields` | On `SHOW` + `LIFECYCLE_PRIORITY.SHOW.BEFORE`: filter tabs (`showInSettings`) → `UPDATE_STATE` `{ tabs, tab }` → `SETTINGS_VIEW.SHOW`.                                                                                                                 |
+| `settings.screen.hide.controls`     | Extends `@vnejs/module.controller.hide.on.controls`: `BACK` / `MENU` / `GAMEMENU` → `HIDE`; PUSH/POP on SHOW/HIDE.                                                                                                                                    |
+| `settings.screen.hide.state`        | Extends `@vnejs/module.controller.hide.on.state`: `STATE.SET` / `STATE.CLEAR` → `HIDE` with `{ isForce: true }`.                                                                                                                                      |
+| `settings.screen.controller.tabs`   | `ModuleControllerTabs` subclass: `TAB_SET` → `applyTab` + `onTabSet` (`UPDATE_FAST`, then `SETTINGS_VIEW.TAB_SET`); TAB_PREV/TAB_NEXT → `TAB_SET`; `getTabKeys` by `showInSettings`.                                                                  |
+| `settings.screen.view`              | Screen chrome (Screen, tabs, cross); fields and example text — in `SETTINGS_VIEW`.                                                                                                                                                                    |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
@@ -61,9 +61,9 @@ Payloads и результаты хендлеров типизированы ч
 - [settings.md](../core/settings.md) — `SETTINGS`: EVENTS.SET, EVENTS.CHANGED, EVENTS.INIT
 - [state.md](../core/state.md) — `STATE`: EVENTS.SET, EVENTS.CLEAR
 
-### Остальные
+### Other
 
-- [settings.md](../views/settings.md) — `SETTINGS_VIEW`: поля и стрелки
+- [settings.md](../views/settings.md) — `SETTINGS_VIEW`: fields and arrows
 - [audio.md](../audio/audio.md) — `AUDIO`
 - [music.md](../audio/music.md) — `MUSIC`: SETTINGS.VOLUME
 - [controls.md](../controls/controls.md) — `CONTROLS`: CONST.BUTTONS.BACK, MENU, GAMEMENU, TAB_PREV, TAB_NEXT

package/scenario.catalog/README.md

@@ -1,38 +1,38 @@
-# Каталог сценарных команд (вариант C)
+# Scenario command catalog (variant C)
 
-Полный surface `$` / `%` команд для агента и автора. Каждая запись — короткий stub + ссылка на plugin doc.
+The full `$` / `%` command surface for an agent and an author. Each entry is a short stub plus a link to the plugin doc.
 
-Параллельный вход с развёрнутыми гайдами: [`../scenario.guide/`](../scenario.guide/).
+The parallel entry with longer guides is [`../scenario.guide/`](../scenario.guide/).
 
-## Как читать
+## How to read this
 
-1. Откройте [`index.md`](./index.md) — оглавление всех команд.
-2. Перейдите в stub (`stubs/<name>.md`) за сигнатурой и примером.
-3. Если нужны события/модули — plugin doc из stub.
+1. Open [`index.md`](./index.md) — the list of every command.
+2. Open the stub (`stubs/<name>.md`) for the signature and an example.
+3. When you need events or modules, open the plugin doc linked from the stub.
 
 ## Source of truth
 
-Машинный каталог живёт в контрактах:
+The machine catalog lives in the contracts:
 
 ```text
 contracts/**/src/commands.ts  →  export const SCENARIO_COMMANDS
 ```
 
-Тот же набор агрегирует VS Code grammar (`vs_code_extensions/vne-language`, `load-commands.js`). Этот markdown-каталог в первой итерации **собран вручную** по текущим `commands.ts`; позже его можно генерировать тем же merge.
+The same set feeds the VS Code grammar (`vs_code_extensions/vne-language`, `load-commands.js`). This markdown catalog was **assembled by hand** from the current `commands.ts` in the first pass. Later it can be generated by the same merge.
 
-Runtime регистрирует handlers отдельно через `SCENARIO.LINE_EXEC_REG` — stubs описывают author-facing синтаксис, не internals.
+Runtime registers handlers separately through `SCENARIO.LINE_EXEC_REG`. Stubs describe author-facing syntax, not internals.
 
-## Структура
+## Layout
 
 ```text
 scenario.catalog/
   README.md
   index.md
   stubs/
-    flag.md              # $ и % вместе, где оба есть
+    flag.md              # $ and % together, where both exist
     choose.md            # $ choose
     choose.block.md      # % choose
     choose.option.md
-    bl.bg.md             # canvas: слой.kind
+    bl.bg.md             # canvas: layer.kind
     …
 ```