@vnejs/docs 0.2.65 → 0.2.66

package/plugins/common/grid.md

@@ -1,41 +1,41 @@
 # plugins/common/grid/
 
-Пакет: `@vnejs/plugins.common.grid` · namespace: `GRID`
+Package: `@vnejs/plugins.common.grid` · namespace: `GRID`
 
-Хранит квадратные сетки по строковому `id` (несколько параллельных досок). Элемент клетки — любой объект с обязательным `id: string`; в одной сетке `id` уникален. Пустая клетка — `null`. Матрица — плотная `(item | null)[][]`.
+Stores square grids by string `id` (several parallel boards). A cell item is any object with required `id: string`; in one grid `id` is unique. Empty cell — `null`. Matrix is dense `(item | null)[][]`.
 
-Не путать с UI-навигацией `*.GRID_*` из `@vnejs/module.controller.arrows.grid` (фокус стрелками на экране).
+Do not confuse with UI navigation `*.GRID_*` from `@vnejs/module.controller.arrows.grid` (arrow focus on screen).
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.common.grid`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.common.grid`.
 
-| Ключ      | Строка             | Смысл                                                                                             |
-| --------- | ------------------ | ------------------------------------------------------------------------------------------------- |
-| `SET`     | `vne:grid:set`     | Создать/заменить `{ id, rows, columns, cells? }`. Без `cells` — пустая матрица. Затем `CHANGED`.  |
-| `GET`     | `vne:grid:get`     | `emitOne({ id })` → `{ id, rows, columns, cells } \| undefined`.                                  |
-| `UNSET`   | `vne:grid:unset`   | Удалить по `{ id }`. Без `CHANGED`.                                                               |
-| `CHANGED` | `vne:grid:changed` | Полный снимок после `SET` / `PUT` / `MOVE` / `REMOVE`.                                            |
-| `PUT`     | `vne:grid:put`     | `{ id, row, column, item }` — положить item; тот же `item.id` сначала снимается со старой клетки. |
-| `MOVE`    | `vne:grid:move`    | `{ id, from, to }` — перенос; занятый `to` — замена.                                              |
-| `REMOVE`  | `vne:grid:remove`  | `{ id, row?, column?, itemId? }` — очистить по позиции или по `itemId`.                           |
+| Key       | String             | Meaning                                                                                         |
+| --------- | ------------------ | ----------------------------------------------------------------------------------------------- |
+| `SET`     | `vne:grid:set`     | Create/replace `{ id, rows, columns, cells? }`. Without `cells` — empty matrix. Then `CHANGED`. |
+| `GET`     | `vne:grid:get`     | `emitOne({ id })` → `{ id, rows, columns, cells } \| undefined`.                                |
+| `UNSET`   | `vne:grid:unset`   | Remove by `{ id }`. No `CHANGED`.                                                               |
+| `CHANGED` | `vne:grid:changed` | Full snapshot after `SET` / `PUT` / `MOVE` / `REMOVE`.                                          |
+| `PUT`     | `vne:grid:put`     | `{ id, row, column, item }` — place item; same `item.id` is cleared from the old cell first.    |
+| `MOVE`    | `vne:grid:move`    | `{ id, from, to }` — move; occupied `to` — swap.                                                |
+| `REMOVE`  | `vne:grid:remove`  | `{ id, row?, column?, itemId? }` — clear by position or by `itemId`.                            |
 
 State: map `id → { rows, columns, cells }`.
 
-`STATE.SET` / `STATE.CLEAR` не пишут map напрямую: отсутствующие id — `UNSET`, присутствующие — `SET`.
+`STATE.SET` / `STATE.CLEAR` do not write the map directly: missing ids — `UNSET`, present ids — `SET`.
 
-## Константы / Params / Settings
+## Constants / Params / Settings
 
-Нет.
+None.
 
-## Модули
+## Modules
 
-| Модуль | Зона ответственности                                             |
+| Module | Role                                                             |
 | ------ | ---------------------------------------------------------------- |
 | `grid` | `SET` / `GET` / `UNSET` / `CHANGED` / `PUT` / `MOVE` / `REMOVE`. |
 
-## Близкие плагины
+## Related plugins
 
-- [game/checkers.md](../game/checkers.md) — пишет `GRID.SET` с `CONST.CHECKERS.GRID_ID`, читает через `GET`
-- [views.screens/checkers.md](../views.screens/checkers.md) / [ai/checkers.md](../ai/checkers.md) — зеркало через `CHANGED` / `UNSET`
-- [common/turn.md](./turn.md) — ход стороны (отдельный map)
+- [game/checkers.md](../game/checkers.md) — writes `GRID.SET` with `CONST.CHECKERS.GRID_ID`, reads via `GET`
+- [views.screens/checkers.md](../views.screens/checkers.md) / [ai/checkers.md](../ai/checkers.md) — mirror via `CHANGED` / `UNSET`
+- [common/turn.md](./turn.md) — side to move (separate map)

package/plugins/common/turn.md

@@ -1,35 +1,35 @@
 # plugins/common/turn/
 
-Пакет: `@vnejs/plugins.common.turn` · namespace: `TURNS`
+Package: `@vnejs/plugins.common.turn` · namespace: `TURNS`
 
-Хранит текущий ход по строковому `id` (несколько параллельных партий) и `owner` (кто ходит — произвольная строка).
+Stores the current turn by string `id` (several parallel games) and `owner` (who moves — arbitrary string).
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.common.turn`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.common.turn`.
 
-| Ключ      | Строка              | Смысл                                                       |
-| --------- | ------------------- | ----------------------------------------------------------- |
-| `SET`     | `vne:turns:set`     | Записать `{ id, owner }`. Без `id` или без `owner` — no-op. |
-| `GET`     | `vne:turns:get`     | `emitOne({ id })` → `owner` (`string \| undefined`).        |
-| `UNSET`   | `vne:turns:unset`   | Удалить запись по `{ id }`.                                 |
-| `CHANGED` | `vne:turns:changed` | После успешного `SET`: `{ id, owner }`.                     |
+| Key       | String              | Meaning                                                         |
+| --------- | ------------------- | --------------------------------------------------------------- |
+| `SET`     | `vne:turns:set`     | Write `{ id, owner }`. Without `id` or without `owner` — no-op. |
+| `GET`     | `vne:turns:get`     | `emitOne({ id })` → `owner` (`string \| undefined`).            |
+| `UNSET`   | `vne:turns:unset`   | Remove the entry by `{ id }`.                                   |
+| `CHANGED` | `vne:turns:changed` | After a successful `SET`: `{ id, owner }`.                      |
 
 State: map `id → owner`.
 
-`STATE.SET` / `STATE.CLEAR` не пишут map напрямую: для новых и изменённых id — `TURNS.SET`, для удалённых — `TURNS.UNSET`.
+`STATE.SET` / `STATE.CLEAR` do not write the map directly: for new and changed ids — `TURNS.SET`, for removed — `TURNS.UNSET`.
 
-## Константы / Params / Settings
+## Constants / Params / Settings
 
-Нет.
+None.
 
-## Модули
+## Modules
 
-| Модуль  | Зона ответственности                 |
+| Module  | Role                                 |
 | ------- | ------------------------------------ |
 | `turns` | `SET` / `GET` / `UNSET` / `CHANGED`. |
 
-## Близкие плагины
+## Related plugins
 
-- [game/checkers.md](../game/checkers.md) — пишет `TURNS.SET` с `CONST.CHECKERS.TURN_ID`, читает через `GET`; доска — через [`common/grid`](./grid.md)
-- [views.screens/checkers.md](../views.screens/checkers.md) / [ai/checkers.md](../ai/checkers.md) — зеркало через `CHANGED` / `UNSET`
+- [game/checkers.md](../game/checkers.md) — writes `TURNS.SET` with `CONST.CHECKERS.TURN_ID`, reads via `GET`; board — via [`common/grid`](./grid.md)
+- [views.screens/checkers.md](../views.screens/checkers.md) / [ai/checkers.md](../ai/checkers.md) — mirror via `CHANGED` / `UNSET`

package/plugins/controls/controls.md

@@ -1,54 +1,54 @@
 # plugins/controls/controls/
 
-Пакет: `@vnejs/plugins.controls.controls` · namespace: `CONTROLS`
+Package: `@vnejs/plugins.controls.controls` · namespace: `CONTROLS`
 
-Стек обработчиков абстрактных control-кнопок (push/pop/emit) и текущий тип устройства ввода (keyboard / xbox / playstation).
+Stack of abstract control-button handlers (push/pop/emit) and the current input device type (keyboard / xbox / playstation).
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.controls`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.controls`.
 
-| Ключ             | Строка                        | Смысл                                                       |
-| ---------------- | ----------------------------- | ----------------------------------------------------------- |
-| `EMIT`           | `vne:controls:emit`           | Инициировать действие или цикл.                             |
-| `PUSH`           | `vne:controls:push`           | Добавить элемент в очередь или стек.                        |
-| `POP`            | `vne:controls:pop`            | Извлечь элемент из очереди или стека.                       |
-| `DEVICE_SET`     | `vne:controls:device_set`     | Запросить смену типа устройства (`{ device }`).             |
-| `DEVICE_CHANGED` | `vne:controls:device_changed` | Тип устройства реально сменился (`{ device, prevDevice }`). |
+| Key              | String                        | Meaning                                                  |
+| ---------------- | ----------------------------- | -------------------------------------------------------- |
+| `EMIT`           | `vne:controls:emit`           | Start an action or cycle.                                |
+| `PUSH`           | `vne:controls:push`           | Push onto the queue or stack.                            |
+| `POP`            | `vne:controls:pop`            | Pop from the queue or stack.                             |
+| `DEVICE_SET`     | `vne:controls:device_set`     | Request a device type change (`{ device }`).             |
+| `DEVICE_CHANGED` | `vne:controls:device_changed` | Device type actually changed (`{ device, prevDevice }`). |
 
-## Константы
+## Constants
 
-| Ключ                  | Смысл                                             |
-| --------------------- | ------------------------------------------------- |
-| `BUTTONS`             | Абстрактные control-кнопки (`ACCEPT`, `BACK`, …). |
-| `DEVICES.KEYBOARD`    | `"keyboard"`                                      |
-| `DEVICES.XBOX`        | `"xbox"`                                          |
-| `DEVICES.PLAYSTATION` | `"playstation"`                                   |
+| Key                   | Meaning                                         |
+| --------------------- | ----------------------------------------------- |
+| `BUTTONS`             | Abstract control buttons (`ACCEPT`, `BACK`, …). |
+| `DEVICES.KEYBOARD`    | `"keyboard"`                                    |
+| `DEVICES.XBOX`        | `"xbox"`                                        |
+| `DEVICES.PLAYSTATION` | `"playstation"`                                 |
 
-## Параметры
+## Parameters
 
-Нет.
+None.
 
-## Настройки
+## Settings
 
-Нет.
+None.
 
-## Модули
+## Modules
 
-| Модуль            | Зона ответственности                                                                                |
-| ----------------- | --------------------------------------------------------------------------------------------------- |
-| `controls`        | Обрабатывает EMIT, PUSH, POP; во время async-обработчика EMIT выставляет `shared.isControlsLocked`. |
-| `controls.device` | Хранит `currentDevice`; на `DEVICE_SET` эмитит `DEVICE_CHANGED` только при реальной смене.          |
+| Module            | Role                                                                                             |
+| ----------------- | ------------------------------------------------------------------------------------------------ |
+| `controls`        | Handles EMIT, PUSH, POP; sets `shared.isControlsLocked` while an async EMIT handler runs.        |
+| `controls.device` | Holds `currentDevice`; on `DEVICE_SET` emits `DEVICE_CHANGED` only when the type really changes. |
 
-Источники `DEVICE_SET`: keyboard (keydown) → keyboard; `controls.gamepad.device` (button_press / axis_move) → xbox|playstation по `gamepad.id`; cursor (`mousemove`) → keyboard.
+Sources of `DEVICE_SET`: keyboard (keydown) → keyboard; `controls.gamepad.device` (button_press / axis_move) → xbox|playstation by `gamepad.id`; cursor (`mousemove`) → keyboard.
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
-— нет
+— None
 
-### Остальные
+### Other
 
 - [keyboard.md](./keyboard.md) — `KEYBOARD`
 - [gamepad.md](./gamepad.md) — `GAMEPAD`

package/plugins/controls/cursor.md

@@ -1,66 +1,66 @@
 # plugins/controls/cursor/
 
-Пакет: `@vnejs/plugins.controls.cursor` · namespace: `CURSOR`
+Package: `@vnejs/plugins.controls.cursor` · namespace: `CURSOR`
 
-Кастомный курсор: позиция, сдвиг, скролл под курсором, view и программный клик. DOM-клик с тача эмитит `HIDE`: у события `pointerType === "touch"`, перед кликом был `pointerdown` с тача, либо у клика `sourceCapabilities.firesTouchEvents`.
+Custom cursor: position, shift, scroll under cursor, view, and programmatic click. A DOM click from touch emits `HIDE`: the event has `pointerType === "touch"`, there was a touch `pointerdown` before the click, or the click has `sourceCapabilities.firesTouchEvents`.
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.controls.cursor`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.controls.cursor`.
 
-| Ключ           | Строка                    | Смысл                                                        |
+| Key            | String                    | Meaning                                                      |
 | -------------- | ------------------------- | ------------------------------------------------------------ |
-| `SHOW`         | `vne:cursor:show`         | Показать UI или слой.                                        |
-| `HIDE`         | `vne:cursor:hide`         | Скрыть UI или слой.                                          |
-| `UPDATE`       | `vne:cursor:update`       | Обновить состояние или отображение.                          |
-| `UPDATE_FAST`  | `vne:cursor:update_fast`  | Быстрое обновление отображения.                              |
-| `UPDATE_FORCE` | `vne:cursor:update_force` | Перерисовать view с `isForce`, стейт не меняет.              |
-| `UPDATE_STATE` | `vne:cursor:update_state` | Слить partial в стейт контроллера (`CursorUpdatePayload`).   |
-| `CLICK`        | `vne:cursor:click`        | Событие `CLICK` namespace плагина.                           |
-| `VIEW_SET`     | `vne:cursor:view_set`     | Записать или обновить значение.                              |
-| `MOVE`         | `vne:cursor:move`         | Событие `MOVE` namespace плагина.                            |
-| `MOVED`        | `vne:cursor:moved`        | Событие `MOVED` namespace плагина.                           |
-| `SET_X_Y`      | `vne:cursor:set_x_y`      | Установить позицию курсора (`{ x?, y? }`) с clamp и `MOVED`. |
-| `SHIFT`        | `vne:cursor:shift`        | Сдвиг позиции курсора (`{ x?, y? }`).                        |
-| `SCROLL`       | `vne:cursor:scroll`       | Скролл ближайшего scrollable под курсором (`{ x?, y? }`).    |
-
-## Константы
-
-Нет.
-
-## Параметры
-
-| Ключ                      | Тип       | Смысл                             |
-| ------------------------- | --------- | --------------------------------- |
-| `DEFAULT_VIEW`            | `string`  | Значение по умолчанию: "default". |
-| `DEFAULT_SHIFT_SPEED`     | `number`  | Значение по умолчанию: 1.         |
-| `DEFAULT_SHIFT_REVERSE_X` | `boolean` | Значение по умолчанию: false.     |
-| `DEFAULT_SHIFT_REVERSE_Y` | `boolean` | Значение по умолчанию: false.     |
-| `BASE_SHIFT_SPEED`        | `number`  | Значение по умолчанию: 16.        |
-| `DEFAULT_SCROLL_SPEED`    | `number`  | Значение по умолчанию: 1.         |
-| `BASE_SCROLL_SPEED`       | `number`  | Значение по умолчанию: 16.        |
-
-## Настройки
-
-| Ключ                                             | Тип       | Смысл                                    |
+| `SHOW`         | `vne:cursor:show`         | Show UI or layer.                                            |
+| `HIDE`         | `vne:cursor:hide`         | Hide UI or layer.                                            |
+| `UPDATE`       | `vne:cursor:update`       | Update state or display.                                     |
+| `UPDATE_FAST`  | `vne:cursor:update_fast`  | Fast display update.                                         |
+| `UPDATE_FORCE` | `vne:cursor:update_force` | Redraw view with `isForce`; does not change state.           |
+| `UPDATE_STATE` | `vne:cursor:update_state` | Merge partial into controller state (`CursorUpdatePayload`). |
+| `CLICK`        | `vne:cursor:click`        | Plugin namespace event `CLICK`.                              |
+| `VIEW_SET`     | `vne:cursor:view_set`     | Write or update a value.                                     |
+| `MOVE`         | `vne:cursor:move`         | Plugin namespace event `MOVE`.                               |
+| `MOVED`        | `vne:cursor:moved`        | Plugin namespace event `MOVED`.                              |
+| `SET_X_Y`      | `vne:cursor:set_x_y`      | Set cursor position (`{ x?, y? }`) with clamp and `MOVED`.   |
+| `SHIFT`        | `vne:cursor:shift`        | Shift cursor position (`{ x?, y? }`).                        |
+| `SCROLL`       | `vne:cursor:scroll`       | Scroll nearest scrollable under cursor (`{ x?, y? }`).       |
+
+## Constants
+
+None.
+
+## Parameters
+
+| Key                       | Type      | Meaning               |
+| ------------------------- | --------- | --------------------- |
+| `DEFAULT_VIEW`            | `string`  | Default: `"default"`. |
+| `DEFAULT_SHIFT_SPEED`     | `number`  | Default: `1`.         |
+| `DEFAULT_SHIFT_REVERSE_X` | `boolean` | Default: `false`.     |
+| `DEFAULT_SHIFT_REVERSE_Y` | `boolean` | Default: `false`.     |
+| `BASE_SHIFT_SPEED`        | `number`  | Default: `16`.        |
+| `DEFAULT_SCROLL_SPEED`    | `number`  | Default: `1`.         |
+| `BASE_SCROLL_SPEED`       | `number`  | Default: `16`.        |
+
+## Settings
+
+| Key                                              | Type      | Meaning                                  |
 | ------------------------------------------------ | --------- | ---------------------------------------- |
-| `SHIFT_SPEED` (`vne:cursor:shift_speed`)         | `number`  | Множитель скорости сдвига курсора.       |
-| `SHIFT_REVERSE_Y` (`vne:cursor:shift_reverse_y`) | `boolean` | Инверсия оси Y при `SHIFT`.              |
-| `SHIFT_REVERSE_X` (`vne:cursor:shift_reverse_x`) | `boolean` | Инверсия оси X при `SHIFT`.              |
-| `SCROLL_SPEED` (`vne:cursor:scroll_speed`)       | `number`  | Множитель скорости скролла при `SCROLL`. |
+| `SHIFT_SPEED` (`vne:cursor:shift_speed`)         | `number`  | Multiplier for cursor shift speed.       |
+| `SHIFT_REVERSE_Y` (`vne:cursor:shift_reverse_y`) | `boolean` | Invert Y axis on `SHIFT`.                |
+| `SHIFT_REVERSE_X` (`vne:cursor:shift_reverse_x`) | `boolean` | Invert X axis on `SHIFT`.                |
+| `SCROLL_SPEED` (`vne:cursor:scroll_speed`)       | `number`  | Multiplier for scroll speed on `SCROLL`. |
 
-## Модули
+## Modules
 
-| Модуль                              | Зона ответственности                                                                                                            |
-| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
-| `cursor` (`Cursor`)                 | SET_X_Y, resize; владеет `globalState.cursor` (x/y).                                                                            |
-| `cursor.view.set` (`CursorViewSet`) | VIEW_SET + STATE/STARTED для проставления `view`. Имя `view.set`, чтобы не пересечься с `plugins/views/cursor` (`cursor.view`). |
-| `cursor.move` (`CursorMove`)        | MOVE (мышь) → `CONTROLS.DEVICE_SET` (keyboard) + SHOW + SET_X_Y; скрывает системный курсор.                                     |
-| `cursor.shift` (`CursorShift`)      | SHIFT + INIT `SHIFT_SPEED` / `SHIFT_REVERSE_*`.                                                                                 |
-| `cursor.click` (`CursorClick`)      | CLICK по координатам курсора. DOM-клик с тача эмитит `HIDE`.                                                                    |
-| `cursor.scroll` (`CursorScroll`)    | SCROLL + INIT `SCROLL_SPEED`.                                                                                                   |
+| Module                              | Role                                                                                                                |
+| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
+| `cursor` (`Cursor`)                 | SET_X_Y, resize; owns `globalState.cursor` (x/y).                                                                   |
+| `cursor.view.set` (`CursorViewSet`) | VIEW_SET + STATE/STARTED to set `view`. Name `view.set` to avoid clash with `plugins/views/cursor` (`cursor.view`). |
+| `cursor.move` (`CursorMove`)        | MOVE (mouse) → `CONTROLS.DEVICE_SET` (keyboard) + SHOW + SET_X_Y; hides system cursor.                              |
+| `cursor.shift` (`CursorShift`)      | SHIFT + INIT `SHIFT_SPEED` / `SHIFT_REVERSE_*`.                                                                     |
+| `cursor.click` (`CursorClick`)      | CLICK at cursor coordinates. DOM click from touch emits `HIDE`.                                                     |
+| `cursor.scroll` (`CursorScroll`)    | SCROLL + INIT `SCROLL_SPEED`.                                                                                       |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
@@ -68,7 +68,7 @@ Payloads и результаты хендлеров типизированы ч
 - [state.md](../core/state.md) — `STATE`: EVENTS.SET, EVENTS.CLEAR
 - [system.md](../core/system.md) — `SYSTEM`: EVENTS.STARTED, EVENTS.RESIZE
 
-### Остальные
+### Other
 
 - [controls.md](./controls.md) — `CONTROLS`: EVENTS.DEVICE_SET (mousemove → keyboard)
-- [gamepad.md](./gamepad.md) — стики через `compatibility.controls.gamepad-with-controls.cursor`: left → `SHIFT`, right → `SCROLL`; тип устройства (xbox|ps) — `controls.gamepad.device`
+- [gamepad.md](./gamepad.md) — sticks via `compatibility.controls.gamepad-with-controls.cursor`: left → `SHIFT`, right → `SCROLL`; device type (xbox|ps) — `controls.gamepad.device`

package/plugins/controls/gamepad.md

@@ -1,72 +1,72 @@
 # plugins/controls/gamepad/
 
-Пакет: `@vnejs/plugins.controls.gamepad` · namespace: `GAMEPAD`
+Package: `@vnejs/plugins.controls.gamepad` · namespace: `GAMEPAD`
 
-Геймпад → абстрактные control-события через joypad.js.
+Gamepad → abstract control events via joypad.js.
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.controls.gamepad`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.controls.gamepad`.
 
-| Ключ   | Строка             | Смысл                                                                   |
-| ------ | ------------------ | ----------------------------------------------------------------------- |
-| `EMIT` | `vne:gamepad:emit` | Проксировать нажатие в `CONTROLS.EMIT` (`{ keys }`) с lock `inProcess`. |
+| Key    | String             | Meaning                                                              |
+| ------ | ------------------ | -------------------------------------------------------------------- |
+| `EMIT` | `vne:gamepad:emit` | Proxy a press to `CONTROLS.EMIT` (`{ keys }`) with lock `inProcess`. |
 
-## Константы
+## Constants
 
-Нет.
+None.
 
-## Параметры
+## Parameters
 
-Нет.
+None.
 
-## Настройки
+## Settings
 
-Нет.
+None.
 
-## Маппинг кнопок (W3C / Xbox standard)
+## Button mapping (W3C / Xbox standard)
 
-После того как joypad выдаёт логическое имя `button_N`, модули кнопок и триггеров эмитят `GAMEPAD.EMIT`, а `controls.gamepad` проксирует ключи в `CONTROLS.EMIT`:
+After joypad yields logical name `button_N`, button and trigger modules emit `GAMEPAD.EMIT`, and `controls.gamepad` proxies keys to `CONTROLS.EMIT`:
 
-| joypad           | Физическая (standard) | Абстрактный control                        |
-| ---------------- | --------------------- | ------------------------------------------ |
-| `button_0`       | A / Cross (низ)       | `ACCEPT`                                   |
-| `button_1`       | B / Circle (право)    | `BACK`                                     |
-| `button_2`       | X / Square (лево)     | `INTERACT`                                 |
-| `button_3`       | Y / Triangle (верх)   | `MENU`                                     |
-| `button_4`       | LB / L1               | `TAB_PREV`                                 |
-| `button_5`       | RB / R1               | `TAB_NEXT`                                 |
-| `button_6`       | LT / L2               | `FASTFORWARD_START` / `FASTFORWARD_FINISH` |
-| `button_7`       | RT / R2               | (cursor click через compatibility)         |
-| `button_8`       | View / Select         | `GAMEMENU`                                 |
-| `button_9`       | Menu / Start          | `MENU`                                     |
-| `button_12`…`15` | D-pad                 | `ARROW_*`                                  |
+| joypad           | Physical (standard) | Abstract control                           |
+| ---------------- | ------------------- | ------------------------------------------ |
+| `button_0`       | A / Cross (bottom)  | `ACCEPT`                                   |
+| `button_1`       | B / Circle (right)  | `BACK`                                     |
+| `button_2`       | X / Square (left)   | `INTERACT`                                 |
+| `button_3`       | Y / Triangle (top)  | `MENU`                                     |
+| `button_4`       | LB / L1             | `TAB_PREV`                                 |
+| `button_5`       | RB / R1             | `TAB_NEXT`                                 |
+| `button_6`       | LT / L2             | `FASTFORWARD_START` / `FASTFORWARD_FINISH` |
+| `button_7`       | RT / R2             | (cursor click via compatibility)           |
+| `button_8`       | View / Select       | `GAMEMENU`                                 |
+| `button_9`       | Menu / Start        | `MENU`                                     |
+| `button_12`…`15` | D-pad               | `ARROW_*`                                  |
 
-## Профили и активный пад
+## Profiles and active pad
 
-joypad.js применяет **один** `customButtonMapping` ко всем устройствам. На Steam Deck часто видны сразу два пада (raw HID + Steam Input Xbox virtual); «тихий» virtual pad нельзя выбирать заранее.
+joypad.js applies **one** `customButtonMapping` to all devices. On Steam Deck you often see two pads at once (raw HID + Steam Input Xbox virtual); you cannot pick the quiet virtual pad ahead of time.
 
-Поэтому плагин:
+So the plugin:
 
-1. Если пад один — сразу его профиль.
-2. Если падов несколько — ждёт **первое реальное нажатие** и lock на тот `gamepad.index`, который его прислал (не на ghost Steam Input).
-3. Дальше игнорирует события с других index; mapping только для locked-пада.
+1. If there is one pad — use its profile at once.
+2. If there are several pads — wait for the **first real press** and lock to the `gamepad.index` that sent it (not ghost Steam Input).
+3. Then ignore events from other indexes; mapping only for the locked pad.
 
-Приоритет профиля: `steam-deck` → `playstation` → `nintendo` → `firefox` → `standard`.
+Profile priority: `steam-deck` → `playstation` → `nintendo` → `firefox` → `standard`.
 
-Сырой дамп кнопок для отладки — отдельный view-плагин [gamepad.debug](../views/gamepad.debug.md) (toggle в Extra).
+Raw button dump for debugging — separate view plugin [gamepad.debug](../views/gamepad.debug.md) (toggle in Extra).
 
-| Профиль       | Когда                                                                            | Что делает                     |
-| ------------- | -------------------------------------------------------------------------------- | ------------------------------ |
-| `standard`    | по умолчанию; preferred с `mapping: "standard"`                                  | identity                       |
-| `steam-deck`  | preferred без standard + id Deck/Steam (`28de` / `valve` / …) или `?steamDeck=1` | raw HID Deck → W3C             |
-| `playstation` | `mapping !== "standard"` и id PS                                                 | raw Square-first → W3C         |
-| `nintendo`    | id Nintendo/Switch, в т.ч. при `standard`                                        | A/B и X/Y под Nintendo confirm |
-| `firefox`     | Firefox UA и не сработал device-профиль                                          | индексы из доки joypad.js      |
+| Profile       | When                                                                                | What it does                     |
+| ------------- | ----------------------------------------------------------------------------------- | -------------------------------- |
+| `standard`    | default; preferred with `mapping: "standard"`                                       | identity                         |
+| `steam-deck`  | preferred without standard + Deck/Steam id (`28de` / `valve` / …) or `?steamDeck=1` | raw HID Deck → W3C               |
+| `playstation` | `mapping !== "standard"` and PS id                                                  | raw Square-first → W3C           |
+| `nintendo`    | Nintendo/Switch id, including with `standard`                                       | A/B and X/Y for Nintendo confirm |
+| `firefox`     | Firefox UA and no device profile matched                                            | indexes from joypad.js docs      |
 
-Electron при `STEAM_DECK=1` добавляет `?steamDeck=1`.
+Electron with `STEAM_DECK=1` adds `?steamDeck=1`.
 
-Все маппинги — объект `CUSTOM_BUTTON_MAPPING` в `plugins/controls/gamepad/src/profiles/custom-button-mapping.ts`:
+All mappings — object `CUSTOM_BUTTON_MAPPING` in `plugins/controls/gamepad/src/profiles/custom-button-mapping.ts`:
 
 - `CUSTOM_BUTTON_MAPPING.STANDARD` — `null` (identity)
 - `CUSTOM_BUTTON_MAPPING.STEAM_DECK` — A→7, B→5, X→6, Y→4, LB→3, RB→2, LT→1, RT→0, Select→12, Start→14, D-pad → 8/11/10/9
@@ -74,21 +74,21 @@ Electron при `STEAM_DECK=1` добавляет `?steamDeck=1`.
 - `CUSTOM_BUTTON_MAPPING.NINTENDO` — ACCEPT←1 (A), BACK←0 (B), INTERACT←3 (X), MENU←2 (Y)
 - `CUSTOM_BUTTON_MAPPING.FIREFOX` — `button_0`←1, `button_7`←11, `button_8`←12
 
-## Модули
+## Modules
 
-| Модуль                     | Зона ответственности                                                                                             |
-| -------------------------- | ---------------------------------------------------------------------------------------------------------------- |
-| `controls.gamepad`         | `connect` / `disconnect` → sync профиля; `GAMEPAD.EMIT` → `CONTROLS.EMIT` с lock `inProcess`.                    |
-| `controls.gamepad.buttons` | `button_press` / `button_release` → `GAMEPAD.EMIT`; lock активного пада.                                         |
-| `controls.gamepad.device`  | `button_press` / `axis_move` → `CONTROLS.DEVICE_SET` (`DEVICES.XBOX` или `DEVICES.PLAYSTATION` по `gamepad.id`). |
+| Module                     | Role                                                                                                            |
+| -------------------------- | --------------------------------------------------------------------------------------------------------------- |
+| `controls.gamepad`         | `connect` / `disconnect` → sync profile; `GAMEPAD.EMIT` → `CONTROLS.EMIT` with lock `inProcess`.                |
+| `controls.gamepad.buttons` | `button_press` / `button_release` → `GAMEPAD.EMIT`; lock active pad.                                            |
+| `controls.gamepad.device`  | `button_press` / `axis_move` → `CONTROLS.DEVICE_SET` (`DEVICES.XBOX` or `DEVICES.PLAYSTATION` by `gamepad.id`). |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
-— нет
+— None
 
-### Остальные
+### Other
 
-- [controls.md](./controls.md) — `CONTROLS`: EVENTS.EMIT, EVENTS.DEVICE_SET (через `controls.gamepad.device` → xbox|playstation), CONST.BUTTONS, CONST.DEVICES
-- [cursor.md](./cursor.md) — через `compatibility.controls.gamepad-with-controls.cursor`: left stick (оси 0–1) → `CURSOR.SHIFT`, right stick (оси 2–3) → `CURSOR.SCROLL`; RT → `CURSOR.CLICK`
+- [controls.md](./controls.md) — `CONTROLS`: EVENTS.EMIT, EVENTS.DEVICE_SET (via `controls.gamepad.device` → xbox|playstation), CONST.BUTTONS, CONST.DEVICES
+- [cursor.md](./cursor.md) — via `compatibility.controls.gamepad-with-controls.cursor`: left stick (axes 0–1) → `CURSOR.SHIFT`, right stick (axes 2–3) → `CURSOR.SCROLL`; RT → `CURSOR.CLICK`

package/plugins/controls/keyboard.md

@@ -1,37 +1,37 @@
 # plugins/controls/keyboard/
 
-Пакет: `@vnejs/plugins.controls.keyboard` · namespace: `KEYBOARD`
+Package: `@vnejs/plugins.controls.keyboard` · namespace: `KEYBOARD`
 
-Клавиатура → абстрактные control-события.
+Keyboard → abstract control events.
 
-## События
+## Events
 
-Нет.
+None.
 
-## Константы
+## Constants
 
-Нет.
+None.
 
-## Параметры
+## Parameters
 
-Нет.
+None.
 
-## Настройки
+## Settings
 
-Нет.
+None.
 
-## Модули
+## Modules
 
-| Модуль              | Зона ответственности          |
-| ------------------- | ----------------------------- |
-| `controls.keyboard` | Подмодуль `keyboard` плагина. |
+| Module              | Role                         |
+| ------------------- | ---------------------------- |
+| `controls.keyboard` | Plugin `keyboard` submodule. |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
-— нет
+— None
 
-### Остальные
+### Other
 
 - [controls.md](./controls.md) — `CONTROLS`: EVENTS.EMIT, EVENTS.DEVICE_SET, CONST.BUTTONS, CONST.DEVICES