@vnejs/docs 0.2.65 → 0.2.67

package/plugins/views/controls.hints.md

@@ -1,54 +1,54 @@
 # plugins/views/controls.hints/
 
-Пакет: `@vnejs/plugins.views.controls.hints` · namespace: `CONTROLS_HINTS`
+Package: `@vnejs/plugins.views.controls.hints` · namespace: `CONTROLS_HINTS`
 
-Оверлей подсказок кнопок (keyboard / xbox / playstation). Группы из `PARAMS.GROUPS` показываются и прячутся по событиям из конфига; иконки переключаются по `CONTROLS.DEVICE_CHANGED`.
+Button-hints overlay (keyboard / xbox / playstation). Groups from `PARAMS.GROUPS` show and hide on events from config; icons switch on `CONTROLS.DEVICE_CHANGED`.
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.controls.hints`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.views.controls.hints`.
 
-| Ключ           | Строка                            | Смысл                                           |
-| -------------- | --------------------------------- | ----------------------------------------------- |
-| `SHOW`         | `vne:controls_hints:show`         | Показать UI или слой.                           |
-| `HIDE`         | `vne:controls_hints:hide`         | Скрыть UI или слой.                             |
-| `UPDATE`       | `vne:controls_hints:update`       | Обновить состояние или отображение.             |
-| `UPDATE_FAST`  | `vne:controls_hints:update_fast`  | Быстрое обновление отображения.                 |
-| `UPDATE_FORCE` | `vne:controls_hints:update_force` | Перерисовать view с `isForce`, стейт не меняет. |
-| `UPDATE_STATE` | `vne:controls_hints:update_state` | Слить partial в стейт контроллера.              |
+| Key            | String                            | Meaning                                                |
+| -------------- | --------------------------------- | ------------------------------------------------------ |
+| `SHOW`         | `vne:controls_hints:show`         | Show the UI or layer.                                  |
+| `HIDE`         | `vne:controls_hints:hide`         | Hide the UI or layer.                                  |
+| `UPDATE`       | `vne:controls_hints:update`       | Update state or display.                               |
+| `UPDATE_FAST`  | `vne:controls_hints:update_fast`  | Fast display update.                                   |
+| `UPDATE_FORCE` | `vne:controls_hints:update_force` | Redraw the view with `isForce`; state does not change. |
+| `UPDATE_STATE` | `vne:controls_hints:update_state` | Merge a partial into the controller state.             |
 
-## Константы
+## Constants
 
-Нет.
+None.
 
-## Параметры
+## Parameters
 
-| Ключ         | Тип                    | Смысл                                                               |
-| ------------ | ---------------------- | ------------------------------------------------------------------- |
-| `GROUPS`     | `ControlsHintsGroup[]` | Группы подсказок (position, direction, show/hide events, controls). |
-| `LOC_LABEL`  | `string`               | Метка locs (`controlsHints`).                                       |
-| `TRANSITION` | `number`               | Длительность перехода View.                                         |
-| `ZINDEX`     | `number`               | Fallback z-index группы, если не задан в `position.zIndex`.         |
-| `VIEW_PROPS` | `object`               | Стили `icon` / `text` / `controlFlex` / `groupFlex`.                |
+| Key          | Type                   | Meaning                                                        |
+| ------------ | ---------------------- | -------------------------------------------------------------- |
+| `GROUPS`     | `ControlsHintsGroup[]` | Hint groups (position, direction, show/hide events, controls). |
+| `LOC_LABEL`  | `string`               | Locs label (`controlsHints`).                                  |
+| `TRANSITION` | `number`               | View transition duration.                                      |
+| `ZINDEX`     | `number`               | Group fallback z-index when not set in `position.zIndex`.      |
+| `VIEW_PROPS` | `object`               | Styles for `icon` / `text` / `controlFlex` / `groupFlex`.      |
 
-Для экрана обычно задают `position.zIndex = PARAMS.<SCREEN>.ZINDEX + 100`, чтобы другие экраны могли перекрыть подсказки.
+For a screen, set `position.zIndex = PARAMS.<SCREEN>.ZINDEX + 100` so other screens can cover the hints.
 
-Появление и скрытие группы по `showEvents` / `hideEvents` обновляет view через `UPDATE_FAST`. Если у исходного события `isForce: true`, обновление идёт через `UPDATE_FORCE`. Обычный `UPDATE` с ожиданием `TRANSITION` на этих событиях не вызывается. Сам `View` по-прежнему анимируется с `transition={PARAMS.TRANSITION}` (по умолчанию `300` ms), кроме `isForce`. Группа видима, если `isShow` и есть контролы для текущего device (с учётом `hideOnDevices`). При уходе в пустой список (например keyboard) предыдущие иконки держатся до конца transition, чтобы fade-out успел отрисоваться.
+Group show/hide via `showEvents` / `hideEvents` updates the view through `UPDATE_FAST`. If the source event has `isForce: true`, the update goes through `UPDATE_FORCE`. A normal `UPDATE` that waits for `TRANSITION` is not used on these events. The `View` still animates with `transition={PARAMS.TRANSITION}` (default `300` ms) except for `isForce`. A group is visible when `isShow` and there are controls for the current device (respecting `hideOnDevices`). When the list becomes empty (for example keyboard), previous icons stay until the transition ends so fade-out can draw.
 
-Элемент `controls[]`: `{ locKey, keyboard: string[], xbox: string[], playstation: string[], hideOnDevices?: ControlsDevice[] }` — пути внутри `media/view/{quality}/` (ведущий `/` снимается). `hideOnDevices` — девайсы, на которых контрол не рендерится (`CONTROLS.DEVICES.*`).
+`controls[]` entry: `{ locKey, keyboard: string[], xbox: string[], playstation: string[], hideOnDevices?: ControlsDevice[] }` — paths under `media/view/{quality}/` (leading `/` is stripped). `hideOnDevices` — devices where the control is not rendered (`CONTROLS.DEVICES.*`).
 
-## Настройки
+## Settings
 
-Нет.
+None.
 
-## Модули
+## Modules
 
-| Модуль                      | Зона ответственности                                                                                                                                                                                                                    |
-| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `controls.hints.controller` | Preload иконок в `start` и на `MEMORY.CLEARED`; show/hide групп сохраняют `isForce` исходного события (`UPDATE_FORCE` или `UPDATE_FAST`); `DEVICE_CHANGED`. `EXTERNAL_UPDATE` всегда вызывает `updateViewFast` (без проверки `isShow`). |
-| `controls.hints.view`       | Рендер нескольких `View` + `Flex` + `Icon` + `Text`.                                                                                                                                                                                    |
+| Module                      | Role                                                                                                                                                                                                                         |
+| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `controls.hints.controller` | Preload icons in `start` and on `MEMORY.CLEARED`; show/hide groups keep the source event `isForce` (`UPDATE_FORCE` or `UPDATE_FAST`); `DEVICE_CHANGED`. `EXTERNAL_UPDATE` always calls `updateViewFast` (no `isShow` check). |
+| `controls.hints.view`       | Render multiple `View` + `Flex` + `Icon` + `Text`.                                                                                                                                                                           |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
@@ -58,6 +58,6 @@ Payloads и результаты хендлеров типизированы ч
 - [state.md](../core/state.md) — `STATE`: SET, CLEAR
 - [system.md](../core/system.md) — `SYSTEM`: STARTED
 
-### Остальные
+### Other
 
 - [controls.md](../controls/controls.md) — `CONTROLS`: DEVICE_CHANGED, DEVICES

package/plugins/views/cursor.md

@@ -1,42 +1,42 @@
 # plugins/views/cursor/
 
-Пакет: `@vnejs/plugins.views.cursor` · namespace: `CURSOR_VIEW`
+Package: `@vnejs/plugins.views.cursor` · namespace: `CURSOR_VIEW`
 
-Отображает кастомный курсор с загрузкой иконок default/pointer.
+Shows a custom cursor with default/pointer icon loading.
 
-Интерактивные элементы игрового UI задают тип курсора атрибутом `vne-cursor-type` на DOM-узле (`"pointer"` или пусто), а не через CSS `cursor`. Вместе с непустым типом на том же узле стоит `vne-cursor-target-possible`. Компонент курсора читает стек через `elementsFromPoint`, ставит `vne-cursor-target` только на узлы с `vne-cursor-target-possible` (и только если набор таких узлов изменился) и переключает иконку default/pointer по непустому `vne-cursor-type` во всём стеке. Исключение: у Range input остаётся `cursor: inherit`, чтобы браузерный курсор `<input type="range">` уходил в `none`.
+Interactive game UI elements set cursor type with the `vne-cursor-type` attribute on a DOM node (`"pointer"` or empty), not through CSS `cursor`. With a non-empty type on the same node, set `vne-cursor-target-possible`. The cursor component reads the stack through `elementsFromPoint`, sets `vne-cursor-target` only on nodes with `vne-cursor-target-possible` (and only when the set of such nodes changed), and switches default/pointer icons by non-empty `vne-cursor-type` anywhere in the stack. Exception: Range inputs keep `cursor: inherit` so the browser cursor on `<input type="range">` becomes `none`.
 
-## События
+## Events
 
-Нет.
+None.
 
-## Константы
+## Constants
 
-Нет.
+None.
 
-## Параметры
+## Parameters
 
-Нет.
+None.
 
-## Настройки
+## Settings
 
-Нет.
+None.
 
-## Модули
+## Modules
 
-| Модуль              | Зона ответственности                       |
-| ------------------- | ------------------------------------------ |
-| `cursor.controller`      | SHOW/HIDE/UPDATE_STATE/UPDATE_FAST; стейт курсора не чистится на `HIDE.CLEANUP`. |
-| `cursor.controller.sync` | `MOVED` / `VIEW_SET` / `MEMORY.CLEARED` → `UPDATE_STATE` + `UPDATE_FAST` и `MEDIA.LOAD`. |
-| `cursor.view`            | Подмодуль `view` плагина.                                                       |
+| Module                   | Role                                                                                       |
+| ------------------------ | ------------------------------------------------------------------------------------------ |
+| `cursor.controller`      | SHOW/HIDE/UPDATE_STATE/UPDATE_FAST; cursor state is not cleared on `HIDE.CLEANUP`.         |
+| `cursor.controller.sync` | `MOVED` / `VIEW_SET` / `MEMORY.CLEARED` → `UPDATE_STATE` + `UPDATE_FAST` and `MEDIA.LOAD`. |
+| `cursor.view`            | Plugin `view` submodule.                                                                   |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
 - [memory.md](../core/memory.md) — `MEMORY`: EVENTS.CLEARED
 
-### Остальные
+### Other
 
 - [cursor.md](../controls/cursor.md) — `CURSOR`: EVENTS.UPDATE, EVENTS.SHOW, EVENTS.HIDE, EVENTS.MOVED, EVENTS.VIEW_SET
 - [layer.md](../canvas/layer.md) — `LAYER`: SETTINGS.QUALITY

package/plugins/views/fps.md

@@ -1,55 +1,55 @@
 # plugins/views/fps/
 
-Пакет: `@vnejs/plugins.views.fps` · namespace: `FPS`
+Package: `@vnejs/plugins.views.fps` · namespace: `FPS`
 
-Показывает счётчик FPS, включаемый через настройку.
+Shows an FPS counter, enabled through settings.
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.fps`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.views.fps`.
 
-| Ключ           | Строка                 | Смысл                                           |
-| -------------- | ---------------------- | ----------------------------------------------- |
-| `SHOW`         | `vne:fps:show`         | Показать UI или слой.                           |
-| `HIDE`         | `vne:fps:hide`         | Скрыть UI или слой.                             |
-| `UPDATE`       | `vne:fps:update`       | Обновить состояние или отображение.             |
-| `UPDATE_FAST`  | `vne:fps:update_fast`  | Быстрое обновление отображения.                 |
-| `UPDATE_FORCE` | `vne:fps:update_force` | Перерисовать view с `isForce`, стейт не меняет. |
-| `UPDATE_STATE` | `vne:fps:update_state` | Слить partial в стейт контроллера.              |
+| Key            | String                 | Meaning                                                |
+| -------------- | ---------------------- | ------------------------------------------------------ |
+| `SHOW`         | `vne:fps:show`         | Show the UI or layer.                                  |
+| `HIDE`         | `vne:fps:hide`         | Hide the UI or layer.                                  |
+| `UPDATE`       | `vne:fps:update`       | Update state or display.                               |
+| `UPDATE_FAST`  | `vne:fps:update_fast`  | Fast display update.                                   |
+| `UPDATE_FORCE` | `vne:fps:update_force` | Redraw the view with `isForce`; state does not change. |
+| `UPDATE_STATE` | `vne:fps:update_state` | Merge a partial into the controller state.             |
 
-## Константы
+## Constants
 
-Нет.
+None.
 
-## Параметры
+## Parameters
 
-| Ключ         | Тип      | Смысл                                |
-| ------------ | -------- | ------------------------------------ |
-| `TRANSITION` | `string` | Значение по умолчанию: "TRANSITION". |
-| `ZINDEX`     | `string` | Значение по умолчанию: "ZINDEX".     |
-| `VIEW_PROPS` | `string` | Значение по умолчанию: "VIEW_PROPS". |
+| Key          | Type     | Meaning                |
+| ------------ | -------- | ---------------------- |
+| `TRANSITION` | `string` | Default: "TRANSITION". |
+| `ZINDEX`     | `string` | Default: "ZINDEX".     |
+| `VIEW_PROPS` | `string` | Default: "VIEW_PROPS". |
 
-## Настройки
+## Settings
 
-| Ключ                          | Тип       | Смысл                           |
-| ----------------------------- | --------- | ------------------------------- |
-| `ENABLED` (`vne:fps:enabled`) | `boolean` | Включить или выключить функцию. |
+| Key                           | Type      | Meaning                        |
+| ----------------------------- | --------- | ------------------------------ |
+| `ENABLED` (`vne:fps:enabled`) | `boolean` | Enable or disable the feature. |
 
-## Модули
+## Modules
 
-| Модуль           | Зона ответственности                     |
-| ---------------- | ---------------------------------------- |
-| `fps.controller` | SHOW/HIDE/UPDATE_STATE/UPDATE_FAST.                    |
-| `fps`            | SETTINGS + rAF; пишет `UPDATE_STATE` `{ text }` + `UPDATE_FAST`. |
-| `fps.view`       | Подмодуль `view` плагина.                |
+| Module           | Role                                                              |
+| ---------------- | ----------------------------------------------------------------- |
+| `fps.controller` | SHOW/HIDE/UPDATE_STATE/UPDATE_FAST.                               |
+| `fps`            | SETTINGS + rAF; writes `UPDATE_STATE` `{ text }` + `UPDATE_FAST`. |
+| `fps.view`       | Plugin `view` submodule.                                          |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
 - [settings.md](../core/settings.md) — `SETTINGS`: EVENTS.CHANGED, EVENTS.INIT
 - [system.md](../core/system.md) — `SYSTEM`: EVENTS.STARTED
 
-### Остальные
+### Other
 
-— нет
+— None

package/plugins/views/gamepad.debug.md

@@ -1,55 +1,55 @@
 # plugins/views/gamepad.debug/
 
-Пакет: `@vnejs/plugins.views.gamepad.debug` · namespace: `GAMEPAD_DEBUG`
+Package: `@vnejs/plugins.views.gamepad.debug` · namespace: `GAMEPAD_DEBUG`
 
-Оверлей сырых данных Gamepad API (пады, pressed indices) для отладки. Включается настройкой.
+Overlay with raw Gamepad API data (pads, pressed indices) for debugging. Enable it through settings.
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.gamepad.debug`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.views.gamepad.debug`.
 
-| Ключ           | Строка                           | Смысл                                           |
-| -------------- | -------------------------------- | ----------------------------------------------- |
-| `SHOW`         | `vne:gamepad.debug:show`         | Показать UI.                                    |
-| `HIDE`         | `vne:gamepad.debug:hide`         | Скрыть UI.                                      |
-| `UPDATE`       | `vne:gamepad.debug:update`       | Обновить отображение.                           |
-| `UPDATE_FAST`  | `vne:gamepad.debug:update_fast`  | Быстрое обновление отображения.                 |
-| `UPDATE_FORCE` | `vne:gamepad.debug:update_force` | Перерисовать view с `isForce`, стейт не меняет. |
-| `UPDATE_STATE` | `vne:gamepad.debug:update_state` | Слить partial в стейт контроллера.              |
+| Key            | String                           | Meaning                                                |
+| -------------- | -------------------------------- | ------------------------------------------------------ |
+| `SHOW`         | `vne:gamepad.debug:show`         | Show the UI.                                           |
+| `HIDE`         | `vne:gamepad.debug:hide`         | Hide the UI.                                           |
+| `UPDATE`       | `vne:gamepad.debug:update`       | Update the display.                                    |
+| `UPDATE_FAST`  | `vne:gamepad.debug:update_fast`  | Fast display update.                                   |
+| `UPDATE_FORCE` | `vne:gamepad.debug:update_force` | Redraw the view with `isForce`; state does not change. |
+| `UPDATE_STATE` | `vne:gamepad.debug:update_state` | Merge a partial into the controller state.             |
 
-## Константы
+## Constants
 
-Нет.
+None.
 
-## Параметры
+## Parameters
 
-| Ключ         | Тип    | Смысл                                                 |
-| ------------ | ------ | ----------------------------------------------------- |
-| `TRANSITION` | number | Анимация show/hide.                                   |
-| `ZINDEX`     | number | Слой поверх UI.                                       |
-| `VIEW_PROPS` | object | Позиция справа (`top`/`right`), props View/Wrap/Text. |
+| Key          | Type     | Meaning                                                      |
+| ------------ | -------- | ------------------------------------------------------------ |
+| `TRANSITION` | `number` | Show/hide animation.                                         |
+| `ZINDEX`     | `number` | Layer above the UI.                                          |
+| `VIEW_PROPS` | `object` | Position on the right (`top`/`right`), View/Wrap/Text props. |
 
-## Настройки
+## Settings
 
-| Ключ                                    | Тип       | Смысл             |
+| Key                                     | Type      | Meaning           |
 | --------------------------------------- | --------- | ----------------- |
-| `ENABLED` (`vne:gamepad.debug:enabled`) | `boolean` | Показать оверлей. |
+| `ENABLED` (`vne:gamepad.debug:enabled`) | `boolean` | Show the overlay. |
 
-## Модули
+## Modules
 
-| Модуль                     | Зона ответственности                           |
-| -------------------------- | ---------------------------------------------- |
-| `gamepad.debug.controller` | SHOW/HIDE/UPDATE_STATE/UPDATE_FAST.                         |
-| `gamepad.debug`            | SETTINGS + rAF poll; пишет `UPDATE_STATE` `{ text }` + `UPDATE_FAST`. |
-| `gamepad.debug.view`       | React-оверлей.                                 |
+| Module                     | Role                                                                   |
+| -------------------------- | ---------------------------------------------------------------------- |
+| `gamepad.debug.controller` | SHOW/HIDE/UPDATE_STATE/UPDATE_FAST.                                    |
+| `gamepad.debug`            | SETTINGS + rAF poll; writes `UPDATE_STATE` `{ text }` + `UPDATE_FAST`. |
+| `gamepad.debug.view`       | React overlay.                                                         |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
 - [settings.md](../core/settings.md) — `SETTINGS`: EVENTS.CHANGED, EVENTS.INIT
 - [system.md](../core/system.md) — `SYSTEM`: EVENTS.STARTED
 
-### Остальные
+### Other
 
-- [fps.md](./fps.md) — аналогичный view-плагин с toggle
+- [fps.md](./fps.md) — similar view plugin with a toggle

package/plugins/views/settings.md

@@ -1,64 +1,64 @@
 # plugins/views/settings/
 
-Пакет: `@vnejs/plugins.views.settings` · namespace: `SETTINGS_VIEW`
+Package: `@vnejs/plugins.views.settings` · namespace: `SETTINGS_VIEW`
 
-Слой списка полей настроек: рендер `<Settings />` и клавиатурная навигация по полям. Экраны (`SETTINGS_SCREEN_VIEW`, `SETTINGS_DEFAULT_VIEW`) передают активную вкладку через `SHOW` / `TAB_SET` и скрывают через `HIDE`.
+Settings field-list layer: render `<Settings />` and keyboard navigation across fields. Screens (`SETTINGS_SCREEN_VIEW`, `SETTINGS_DEFAULT_VIEW`) pass the active tab through `SHOW` / `TAB_SET` and hide through `HIDE`.
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.settings`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.views.settings`.
 
-| Ключ           | Строка                           | Смысл                                                                                                                                     |
+| Key            | String                           | Meaning                                                                                                                                   |
 | -------------- | -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
-| `SHOW`         | `vne:settings_view:show`         | Показать слой; payload `{ tab, tabKey?, tabs?, locs?, isForce? }`. Поля из `tab`; при `tabs` все вкладки монтируются сразу для crossfade. |
-| `TAB_SET`      | `vne:settings_view:tab_set`      | Сменить активную вкладку; payload `{ tab, tabKey?, locs?, isForce? }`. Старая и новая одновременно: `PositionBox opacity` 1↔0.            |
-| `HIDE`         | `vne:settings_view:hide`         | Скрыть слой полей.                                                                                                                        |
-| `UPDATE`       | `vne:settings_view:update`       | Обновить состояние или отображение.                                                                                                       |
-| `UPDATE_FAST`  | `vne:settings_view:update_fast`  | Быстрый UPDATE view без анимации (стрелки).                                                                                               |
-| `UPDATE_FORCE` | `vne:settings_view:update_force` | Перерисовать view с `isForce`, стейт не меняет.                                                                                           |
-| `UPDATE_STATE` | `vne:settings_view:update_state` | Слить `{ currentArrowVerticalItem }` в стейт controller; пересчитать `currentItemInner`.                                                  |
-| `ARROW_LEFT`   | `vne:settings_view:arrow_left`   | Горизонтальная стрелка влево: сменить значение сфокусированного поля.                                                                     |
-| `ARROW_RIGHT`  | `vne:settings_view:arrow_right`  | Горизонтальная стрелка вправо: сменить значение сфокусированного поля.                                                                    |
+| `SHOW`         | `vne:settings_view:show`         | Show the layer; payload `{ tab, tabKey?, tabs?, locs?, isForce? }`. Fields from `tab`; with `tabs`, all tabs mount at once for crossfade. |
+| `TAB_SET`      | `vne:settings_view:tab_set`      | Switch the active tab; payload `{ tab, tabKey?, locs?, isForce? }`. Old and new tabs together: `PositionBox opacity` 1↔0.                 |
+| `HIDE`         | `vne:settings_view:hide`         | Hide the field layer.                                                                                                                     |
+| `UPDATE`       | `vne:settings_view:update`       | Update state or display.                                                                                                                  |
+| `UPDATE_FAST`  | `vne:settings_view:update_fast`  | Fast view UPDATE without animation (arrows).                                                                                              |
+| `UPDATE_FORCE` | `vne:settings_view:update_force` | Redraw the view with `isForce`; state does not change.                                                                                    |
+| `UPDATE_STATE` | `vne:settings_view:update_state` | Merge `{ currentArrowVerticalItem }` into controller state; recompute `currentItemInner`.                                                 |
+| `ARROW_LEFT`   | `vne:settings_view:arrow_left`   | Horizontal arrow left: change the focused field value.                                                                                    |
+| `ARROW_RIGHT`  | `vne:settings_view:arrow_right`  | Horizontal arrow right: change the focused field value.                                                                                   |
 
-## Константы
+## Constants
 
-| Ключ          | Тип      | Смысл                                                          |
-| ------------- | -------- | -------------------------------------------------------------- |
-| `DEFAULT_TAB` | `string` | Ключ вкладки дефолтных настроек в `PARAMS.TABS` (`"DEFAULT"`). |
+| Key           | Type     | Meaning                                                  |
+| ------------- | -------- | -------------------------------------------------------- |
+| `DEFAULT_TAB` | `string` | Default-settings tab key in `PARAMS.TABS` (`"DEFAULT"`). |
 
-## Параметры
+## Parameters
 
-| Ключ         | Тип                                | Смысл                                                                |
-| ------------ | ---------------------------------- | -------------------------------------------------------------------- |
-| `TABS`       | `Record<string, SettingsTab>`      | Схема вкладок/полей (заполняет игра).                                |
-| `VALUE_MAPS` | `Record<string, SettingsValueMap>` | Мапперы значений range.                                              |
-| `ACTIONS`    | `Record<string, SettingsAction>`   | Именованные actions опций.                                           |
-| `VIEW_PROPS` | object                             | `view` (для `<View />`), `fieldProps`, `fieldsGap`, `exampleText`.   |
-| `TRANSITION` | `number`                           | Длительность анимации (в т.ч. fade при `TAB_SET`).                   |
-| `ZINDEX`     | `number`                           | Index в controls-стеке для стрелок/`INTERACT` (ниже chrome экранов). |
-| `LOC_LABEL`  | `string`                           | Label локалей для inject.                                            |
+| Key          | Type                               | Meaning                                                                  |
+| ------------ | ---------------------------------- | ------------------------------------------------------------------------ |
+| `TABS`       | `Record<string, SettingsTab>`      | Tab/field schema (filled by the game).                                   |
+| `VALUE_MAPS` | `Record<string, SettingsValueMap>` | Range value mappers.                                                     |
+| `ACTIONS`    | `Record<string, SettingsAction>`   | Named option actions.                                                    |
+| `VIEW_PROPS` | object                             | `view` (for `<View />`), `fieldProps`, `fieldsGap`, `exampleText`.       |
+| `TRANSITION` | `number`                           | Animation duration (including fade on `TAB_SET`).                        |
+| `ZINDEX`     | `number`                           | Index in the controls stack for arrows/`INTERACT` (below screen chrome). |
+| `LOC_LABEL`  | `string`                           | Locale label for inject.                                                 |
 
-## Настройки
+## Settings
 
-Нет.
+None.
 
-## Модули
+## Modules
 
-| Модуль                                         | Зона ответственности                                                                                                                                                                                                                                                                                                                                                                    |
-| ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `settings.fields.controller`                   | `SHOW`/`HIDE`/`TAB_SET`; зеркалит `UPDATE_STATE` (`currentArrowVerticalItem` + `currentItemInner`). На `ARROW_LEFT`/`ARROW_RIGHT`: у `selector_texts` / `actions` (`options`) циклят `currentItemInner` (modulo); у `selector_texts` сразу `SETTINGS.SET`. `INTERACT` — option value или named action (в т.ч. `actions` без `settingKey`). `ACCEPT` не обрабатывает — оставляют экраны. |
-| `settings.fields.controller.arrows`            | Наследует `@vnejs/module.controller.arrows.vertical`: `ARROW_UP`/`ARROW_BOTTOM` по полям; PUSH/POP на SHOW/HIDE; `TAB_SET` сбрасывает индекс; эмитит `UPDATE_STATE` с `{ currentArrowVerticalItem }` и `UPDATE_FAST`. На `HIDE.CLEANUP` `currentArrowVerticalItem` в стейте становится `undefined`.                                                                                     |
-| `settings.fields.controller.arrows.horizontal` | Наследует `@vnejs/module.controller.arrows.horizontal`: `onArrowLeft` / `onArrowRight` → `ARROW_LEFT` / `ARROW_RIGHT`; PUSH/POP на SHOW/HIDE. На `HIDE.CLEANUP` `currentArrowHorizontalItem` в стейте становится `undefined`.                                                                                                                                                           |
-| `settings.fields.view`                         | Обёртка `<View {...propsView} />` (fade show/hide); внутри вкладки `<SettingsTabContent />` с `PositionBox opacity` для crossfade по `tabKey`. Подсветка полей по `currentArrowVerticalItem`.                                                                                                                                                                                           |
+| Module                                         | Role                                                                                                                                                                                                                                                                                                                                                                                         |
+| ---------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `settings.fields.controller`                   | `SHOW`/`HIDE`/`TAB_SET`; mirrors `UPDATE_STATE` (`currentArrowVerticalItem` + `currentItemInner`). On `ARROW_LEFT`/`ARROW_RIGHT`: `selector_texts` / `actions` (`options`) cycle `currentItemInner` (modulo); `selector_texts` call `SETTINGS.SET` at once. `INTERACT` — option value or named action (including `actions` without `settingKey`). `ACCEPT` is not handled — screens keep it. |
+| `settings.fields.controller.arrows`            | Extends `@vnejs/module.controller.arrows.vertical`: `ARROW_UP`/`ARROW_BOTTOM` across fields; PUSH/POP on SHOW/HIDE; `TAB_SET` resets the index; emits `UPDATE_STATE` with `{ currentArrowVerticalItem }` and `UPDATE_FAST`. On `HIDE.CLEANUP` `currentArrowVerticalItem` in state becomes `undefined`.                                                                                       |
+| `settings.fields.controller.arrows.horizontal` | Extends `@vnejs/module.controller.arrows.horizontal`: `onArrowLeft` / `onArrowRight` → `ARROW_LEFT` / `ARROW_RIGHT`; PUSH/POP on SHOW/HIDE. On `HIDE.CLEANUP` `currentArrowHorizontalItem` in state becomes `undefined`.                                                                                                                                                                     |
+| `settings.fields.view`                         | Wrapper `<View {...propsView} />` (fade show/hide); inside tabs `<SettingsTabContent />` with `PositionBox opacity` for crossfade by `tabKey`. Field highlight by `currentArrowVerticalItem`.                                                                                                                                                                                                |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
 - [components.md](../core/components.md) — `COMPONENTS`: EVENTS.EXTERNAL_UPDATE, EVENTS.RENDER
 - [settings.md](../core/settings.md) — `SETTINGS`: EVENTS.SET, EVENTS.CHANGED
 
-### Остальные
+### Other
 
 - [controls.md](../controls/controls.md) — `CONTROLS`: CONST.BUTTONS.INTERACT, ARROW_*
 - [settings.md](../views.screens/settings.md) — `SETTINGS_SCREEN_VIEW`

package/plugins/views/video.md

@@ -1,55 +1,55 @@
 # plugins/views/video/
 
-Пакет: `@vnejs/plugins.views.video` · namespace: `VIDEO`
+Package: `@vnejs/plugins.views.video` · namespace: `VIDEO`
 
-Воспроизводит полноэкранное видео по командам сценария play/load.
+Plays fullscreen video via scenario play/load commands.
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.video`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.views.video`.
 
-| Ключ           | Строка                   | Смысл                                                 |
-| -------------- | ------------------------ | ----------------------------------------------------- |
-| `SET`          | `vne:video:set`          | Запросить данные у обработчиков и продолжить цепочку. |
-| `GET`          | `vne:video:get`          | Получить значение или ресурс.                         |
-| `LOAD`         | `vne:video:load`         | Загрузить данные или ресурс.                          |
-| `PLAY`         | `vne:video:play`         | Начать воспроизведение.                               |
-| `SET_SRC`      | `vne:video:set_src`      | Записать или обновить значение.                       |
-| `SHOW`         | `vne:video:show`         | Показать UI или слой.                                 |
-| `HIDE`         | `vne:video:hide`         | Скрыть UI или слой.                                   |
-| `UPDATE`       | `vne:video:update`       | Обновить состояние или отображение.                   |
-| `UPDATE_FAST`  | `vne:video:update_fast`  | Быстрое обновление отображения.                       |
-| `UPDATE_FORCE` | `vne:video:update_force` | Перерисовать view с `isForce`, стейт не меняет.       |
-| `UPDATE_STATE` | `vne:video:update_state` | Слить partial в стейт контроллера.                    |
+| Key            | String                   | Meaning                                                |
+| -------------- | ------------------------ | ------------------------------------------------------ |
+| `SET`          | `vne:video:set`          | Ask handlers for data and continue the chain.          |
+| `GET`          | `vne:video:get`          | Get a value or resource.                               |
+| `LOAD`         | `vne:video:load`         | Load data or a resource.                               |
+| `PLAY`         | `vne:video:play`         | Start playback.                                        |
+| `SET_SRC`      | `vne:video:set_src`      | Write or update a value.                               |
+| `SHOW`         | `vne:video:show`         | Show the UI or layer.                                  |
+| `HIDE`         | `vne:video:hide`         | Hide the UI or layer.                                  |
+| `UPDATE`       | `vne:video:update`       | Update state or display.                               |
+| `UPDATE_FAST`  | `vne:video:update_fast`  | Fast display update.                                   |
+| `UPDATE_FORCE` | `vne:video:update_force` | Redraw the view with `isForce`; state does not change. |
+| `UPDATE_STATE` | `vne:video:update_state` | Merge a partial into the controller state.             |
 
-## Константы
+## Constants
 
 - **`EXEC_ACTIONS.PLAY`** — "play"
 
-## Параметры
+## Parameters
 
-| Ключ         | Тип      | Смысл                                |
-| ------------ | -------- | ------------------------------------ |
-| `TRANSITION` | `string` | Значение по умолчанию: "TRANSITION". |
-| `ZINDEX`     | `string` | Значение по умолчанию: "ZINDEX".     |
-| `VIEW_PROPS` | `string` | Значение по умолчанию: "VIEW_PROPS". |
+| Key          | Type     | Meaning                |
+| ------------ | -------- | ---------------------- |
+| `TRANSITION` | `string` | Default: "TRANSITION". |
+| `ZINDEX`     | `string` | Default: "ZINDEX".     |
+| `VIEW_PROPS` | `string` | Default: "VIEW_PROPS". |
 
-## Настройки
+## Settings
 
-Нет.
+None.
 
-## Модули
+## Modules
 
-| Модуль                      | Зона ответственности                                                                                                                                        |
-| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `video.controller`          | SHOW/HIDE; `SHOW.BEFORE` → `INTERFACE.TEXT_HIDE`; `HIDE.AFTER` → `SET_SRC` и `SCENARIO.NEXT`.                                                               |
-| `video.controller.interact` | Наследует `@vnejs/module.controller.interact`: `BUTTONS.ANY` → `INTERACT.EMIT`; `onInteract` возвращает промис `VIDEO.HIDE`; `CONTROLS_CHECK_NEXT = false`. |
-| `video.controller.src`      | `SET_SRC` → `UPDATE_STATE` `{ src }` + `UPDATE_FAST`.                                                                                                       |
-| `video.hide.state`          | Наследует `@vnejs/module.controller.hide.on.state`: только `STATE.CLEAR` → `HIDE` с `{ isForce: true }` (`IS_STATE_SET_ENABLED = false`).                   |
-| `video`                     | Обрабатывает HIDE, PLAY, LOAD, GET, ….                                                                                                                      |
-| `video.view`                | Подмодуль `view` плагина.                                                                                                                                   |
+| Module                      | Role                                                                                                                                                      |
+| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `video.controller`          | SHOW/HIDE; `SHOW.BEFORE` → `INTERFACE.TEXT_HIDE`; `HIDE.AFTER` → `SET_SRC` and `SCENARIO.NEXT`.                                                           |
+| `video.controller.interact` | Extends `@vnejs/module.controller.interact`: `BUTTONS.ANY` → `INTERACT.EMIT`; `onInteract` returns a `VIDEO.HIDE` promise; `CONTROLS_CHECK_NEXT = false`. |
+| `video.controller.src`      | `SET_SRC` → `UPDATE_STATE` `{ src }` + `UPDATE_FAST`.                                                                                                     |
+| `video.hide.state`          | Extends `@vnejs/module.controller.hide.on.state`: only `STATE.CLEAR` → `HIDE` with `{ isForce: true }` (`IS_STATE_SET_ENABLED = false`).                  |
+| `video`                     | Handles HIDE, PLAY, LOAD, GET, ….                                                                                                                         |
+| `video.view`                | Plugin `view` submodule.                                                                                                                                  |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
@@ -58,7 +58,7 @@ Payloads и результаты хендлеров типизированы ч
 - [scenario.md](../core/scenario.md) — `SCENARIO`: EVENTS.NEXT, EVENTS.LINE_EXEC_REG, EVENTS.LINE_LOAD_REG
 - [state.md](../core/state.md) — `STATE`: EVENTS.CLEAR, EVENTS.SET
 
-### Остальные
+### Other
 
 - [controls.md](../controls/controls.md) — `CONTROLS`: CONST.BUTTONS.ANY
 - [interface.md](../views.scenario/interface.md) — `INTERFACE`: EVENTS.TEXT_HIDE