@vnejs/docs 0.2.65 → 0.2.67

package/plugins/views.scenario/point_and_click.md

@@ -1,49 +1,49 @@
 # plugins/views.scenario/point_and_click/
 
-Пакет: `@vnejs/plugins.views.scenario.point_and_click` · namespace: `POINT_AND_CLICK_VIEW`
+Package: `@vnejs/plugins.views.scenario.point_and_click` · namespace: `POINT_AND_CLICK_VIEW`
 
-React-UI point-and-click (иконки-hotspot). Зависит от scenario-плагина [point_and_click.md](../scenario/point_and_click.md) (`POINT_AND_CLICK`): слушает `SHOW` / `HIDE`, эмитит `OPTION` при клике.
+React UI for point-and-click (icon hotspots). Depends on the scenario plugin [point_and_click.md](../scenario/point_and_click.md) (`POINT_AND_CLICK`): listens to `SHOW` / `HIDE`, emits `OPTION` on click.
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.scenario.point_and_click`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.views.scenario.point_and_click`.
 
-| Ключ           | Строка                                  | Смысл                                           |
-| -------------- | --------------------------------------- | ----------------------------------------------- |
-| `SHOW`         | `vne:point_and_click_view:show`         | Показать UI.                                    |
-| `HIDE`         | `vne:point_and_click_view:hide`         | Скрыть UI.                                      |
-| `UPDATE`       | `vne:point_and_click_view:update`       | Обновить React-store / отображение.             |
-| `UPDATE_FAST`  | `vne:point_and_click_view:update_fast`  | Быстрое обновление отображения.                 |
-| `UPDATE_FORCE` | `vne:point_and_click_view:update_force` | Перерисовать view с `isForce`, стейт не меняет. |
-| `UPDATE_STATE` | `vne:point_and_click_view:update_state` | Слить partial в стейт контроллера.              |
+| Key            | String                                  | Meaning                                                |
+| -------------- | --------------------------------------- | ------------------------------------------------------ |
+| `SHOW`         | `vne:point_and_click_view:show`         | Show the UI.                                           |
+| `HIDE`         | `vne:point_and_click_view:hide`         | Hide the UI.                                           |
+| `UPDATE`       | `vne:point_and_click_view:update`       | Update the React store / display.                      |
+| `UPDATE_FAST`  | `vne:point_and_click_view:update_fast`  | Fast display update.                                   |
+| `UPDATE_FORCE` | `vne:point_and_click_view:update_force` | Redraw the view with `isForce`; state does not change. |
+| `UPDATE_STATE` | `vne:point_and_click_view:update_state` | Merge a partial into the controller state.             |
 
-Сценарные события (`EMIT`, `OPTION`, `SHOW`, `HIDE`, `SKIP`, `EXEC_*`, `STATE_UPDATE`) — в контракте `@vnejs/contracts.scenario.point_and_click`, namespace `POINT_AND_CLICK`.
+Scenario events (`EMIT`, `OPTION`, `SHOW`, `HIDE`, `SKIP`, `EXEC_*`, `STATE_UPDATE`) — contract `@vnejs/contracts.scenario.point_and_click`, namespace `POINT_AND_CLICK`.
 
-## Константы
+## Constants
 
-Нет.
+None.
 
-## Параметры
+## Parameters
 
-| Ключ                  | Тип      | Смысл                                                                                          |
-| --------------------- | -------- | ---------------------------------------------------------------------------------------------- |
-| `TRANSITION`          | `number` | Длительность анимации показа/скрытия Screen и swap hotspot-картинки на hover (мс); дефолт 300. |
-| `ZINDEX`              | `number` | Z-index слоя и индекс блока controls.                                                          |
-| `CONTROLS_EXTENSIONS` | `object` | Дополнительные обработчики controls.                                                           |
+| Key                   | Type     | Meaning                                                                       |
+| --------------------- | -------- | ----------------------------------------------------------------------------- |
+| `TRANSITION`          | `number` | Screen show/hide animation and hotspot image swap on hover (ms); default 300. |
+| `ZINDEX`              | `number` | Layer z-index and controls block index.                                       |
+| `CONTROLS_EXTENSIONS` | `object` | Extra controls handlers.                                                      |
 
-## Настройки
+## Settings
 
-Нет.
+None.
 
-## Модули
+## Modules
 
-| Модуль                            | Зона ответственности                                                                                                                                                                                                                                                                                                 |
-| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `point_and_click_view.bridge`     | Bridge `POINT_AND_CLICK.SHOW/HIDE` → `POINT_AND_CLICK_VIEW.SHOW/HIDE`; на hide — `INTERFACE.TEXT_HIDE`.                                                                                                                                                                                                              |
-| `point_and_click_view.controller` | На `SHOW` + `LIFECYCLE_PRIORITY.SHOW.BEFORE` грузит `iconSrc` / `iconHoverSrc`; `CONTROLS_EXTENSIONS` сливается в `CONTROLS` в `ModuleController.init`; сброс стейта на `HIDE.CLEANUP` делает `ModuleController` (`SHOULD_CLEAR_STATE_ON_CLEANUP`). `SETTINGS.CHANGED` → `updateViewFast` при `state.isShow` — из `ModuleController`. |
-| `point_and_click_view.view`       | React-render hotspot-иконок (`Image` + `srcHover` + `transition` из `PARAMS.POINT_AND_CLICK_VIEW.TRANSITION`; размер — натуральный или args `imgWidth` / `imgHeight` в px canvas).                                                                                                                                   |
+| Module                            | Role                                                                                                                                                                                                                                                                                                                                        |
+| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `point_and_click_view.bridge`     | Bridge `POINT_AND_CLICK.SHOW/HIDE` → `POINT_AND_CLICK_VIEW.SHOW/HIDE`; on hide — `INTERFACE.TEXT_HIDE`.                                                                                                                                                                                                                                     |
+| `point_and_click_view.controller` | On `SHOW` + `LIFECYCLE_PRIORITY.SHOW.BEFORE` loads `iconSrc` / `iconHoverSrc`; `CONTROLS_EXTENSIONS` merges into `CONTROLS` in `ModuleController.init`; state reset on `HIDE.CLEANUP` is done by `ModuleController` (`SHOULD_CLEAR_STATE_ON_CLEANUP`). `SETTINGS.CHANGED` → `updateViewFast` when `state.isShow` — from `ModuleController`. |
+| `point_and_click_view.view`       | React-render hotspot icons (`Image` + `srcHover` + `transition` from `PARAMS.POINT_AND_CLICK_VIEW.TRANSITION`; size — natural or args `imgWidth` / `imgHeight` in px on canvas).                                                                                                                                                            |
 
-## Связь с POINT_AND_CLICK
+## Link to POINT_AND_CLICK
 
 ```mermaid
 sequenceDiagram
@@ -56,7 +56,7 @@ sequenceDiagram
   OBS->>BR: bridge
   BR->>OBS: vne:point_and_click_view:show
   OBS->>VC: onShow
-  Note over VC: SHOW BEFORE читает globalState и грузит icons
+  Note over VC: SHOW BEFORE reads globalState and loads icons
   VC->>OBS: vne:point_and_click:option
   OBS->>SC: onOption
   SC->>OBS: vne:point_and_click:hide
@@ -68,11 +68,11 @@ sequenceDiagram
 
 ### `compatibility/views.scenario.point_and_click/views.scenario.interface/`
 
-Пакет: `@vnejs/compatibility.views.scenario.point_and_click-with-views.scenario.interface`
+Package: `@vnejs/compatibility.views.scenario.point_and_click-with-views.scenario.interface`
 
-На `POINT_AND_CLICK_VIEW.SHOW` с `CONST.COMPONENTS.LIFECYCLE_PRIORITY.SHOW.BEFORE` эмитит `INTERFACE.HIDE`.
+On `POINT_AND_CLICK_VIEW.SHOW` with `CONST.COMPONENTS.LIFECYCLE_PRIORITY.SHOW.BEFORE` emits `INTERFACE.HIDE`.
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/scenario/
 
@@ -80,10 +80,10 @@ sequenceDiagram
 
 ### plugins/core/
 
-- [state.md](../core/state.md) — restore через `POINT_AND_CLICK` + bridge
+- [state.md](../core/state.md) — restore via `POINT_AND_CLICK` + bridge
 
-### Остальные
+### Other
 
-- [controls.md](../controls/controls.md) — `CONTROLS`: через `PARAMS.CONTROLS_EXTENSIONS`
-- [interface.md](interface.md) — compatibility скрывает interface на `SHOW` (`LIFECYCLE_PRIORITY.SHOW.BEFORE`); bridge зовёт `TEXT_HIDE` на hide
-- [layer.md](../canvas/layer.md) — `LAYER`: SETTINGS.QUALITY для media icons
+- [controls.md](../controls/controls.md) — `CONTROLS`: via `PARAMS.CONTROLS_EXTENSIONS`
+- [interface.md](interface.md) — compatibility hides interface on `SHOW` (`LIFECYCLE_PRIORITY.SHOW.BEFORE`); bridge calls `TEXT_HIDE` on hide
+- [layer.md](../canvas/layer.md) — `LAYER`: SETTINGS.QUALITY for media icons

package/plugins/views.scenario/qte.md

@@ -1,68 +1,68 @@
 # plugins/views.scenario/qte/
 
-Пакет: `@vnejs/plugins.views.scenario.qte` · namespace: `QTE_VIEW`
+Package: `@vnejs/plugins.views.scenario.qte` · namespace: `QTE_VIEW`
 
-React-UI Quick Time Event: фазы анимации, зона успеха в процентах, ACCEPT / INTERACT. Зависит от scenario-плагина [qte.md](../scenario/qte.md) (`QTE`): слушает `OPENED` / `CLOSED`, эмитит `RESULT` по итогам раунда.
+React UI for Quick Time Events: animation phases, success zone in percent, ACCEPT / INTERACT. Depends on the scenario plugin [qte.md](../scenario/qte.md) (`QTE`): listens to `OPENED` / `CLOSED`, emits `RESULT` from round outcome.
 
-Состояние раунда **не** пишется в save — только в controller/view; на `SHOW` с `CONST.COMPONENTS.LIFECYCLE_PRIORITY.SHOW.BEFORE` скрывается interface (compatibility).
+Round state is **not** written to save — only in controller/view; on `SHOW` with `CONST.COMPONENTS.LIFECYCLE_PRIORITY.SHOW.BEFORE` the interface hides (compatibility).
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.scenario.qte`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.views.scenario.qte`.
 
-| Ключ           | Строка                      | Смысл                                                       |
-| -------------- | --------------------------- | ----------------------------------------------------------- |
-| `SHOW`         | `vne:qte_view:show`         | Показать UI QTE.                                            |
-| `HIDE`         | `vne:qte_view:hide`         | Скрыть UI QTE.                                              |
-| `UPDATE`       | `vne:qte_view:update`       | Обновить React-store / отображение.                         |
-| `UPDATE_FAST`  | `vne:qte_view:update_fast`  | Быстрое обновление отображения.                             |
-| `UPDATE_FORCE` | `vne:qte_view:update_force` | Перерисовать view с `isForce`, стейт не меняет.             |
-| `UPDATE_STATE` | `vne:qte_view:update_state` | Слить partial в стейт контроллера.                          |
-| `ACTION`       | `vne:qte_view:action`       | Игрок нажал ACCEPT / INTERACT (или клик) во время `active`. |
+| Key            | String                      | Meaning                                                      |
+| -------------- | --------------------------- | ------------------------------------------------------------ |
+| `SHOW`         | `vne:qte_view:show`         | Show the QTE UI.                                             |
+| `HIDE`         | `vne:qte_view:hide`         | Hide the QTE UI.                                             |
+| `UPDATE`       | `vne:qte_view:update`       | Update the React store / display.                            |
+| `UPDATE_FAST`  | `vne:qte_view:update_fast`  | Fast display update.                                         |
+| `UPDATE_FORCE` | `vne:qte_view:update_force` | Redraw the view with `isForce`; state does not change.       |
+| `UPDATE_STATE` | `vne:qte_view:update_state` | Merge a partial into the controller state.                   |
+| `ACTION`       | `vne:qte_view:action`       | Player pressed ACCEPT / INTERACT (or click) during `active`. |
 
-Сценарные события (`EMIT`, `RESULT`, `OPENED`, `CLOSED`) — в контракте `@vnejs/contracts.scenario.qte`, namespace `QTE`.
+Scenario events (`EMIT`, `RESULT`, `OPENED`, `CLOSED`) — contract `@vnejs/contracts.scenario.qte`, namespace `QTE`.
 
-## Константы
+## Constants
 
-Нет.
+None.
 
-## Параметры
+## Parameters
 
-| Ключ           | Тип      | Смысл                                                                                          |
-| -------------- | -------- | ---------------------------------------------------------------------------------------------- |
-| `TRANSITION`   | `number` | Длительность анимации показа/скрытия (мс). По умолчанию `500`.                                 |
-| `INITIAL`      | `number` | Зарезервирован; не используется view (маркер стартует после `TRANSITION`). По умолчанию `100`. |
-| `ZINDEX`       | `number` | Z-index слоя и индекс блока controls. По умолчанию `1300`.                                     |
-| `RESULT_DELAY` | `number` | Пауза на экране success/fail перед `RESULT` (мс). По умолчанию `500`.                          |
-| `LOC_LABEL`    | `string` | Метка локализации текстов статуса (`locs`). По умолчанию `"qte"`.                              |
-| `VIEW_PROPS`   | `object` | Пропсы Screen, PositionBox.                                                                    |
+| Key            | Type     | Meaning                                                                           |
+| -------------- | -------- | --------------------------------------------------------------------------------- |
+| `TRANSITION`   | `number` | Show/hide animation duration (ms). Default `500`.                                 |
+| `INITIAL`      | `number` | Reserved; not used by the view (marker starts after `TRANSITION`). Default `100`. |
+| `ZINDEX`       | `number` | Layer z-index and controls block index. Default `1300`.                           |
+| `RESULT_DELAY` | `number` | Pause on success/fail screen before `RESULT` (ms). Default `500`.                 |
+| `LOC_LABEL`    | `string` | Label for status text locs (`locs`). Default `"qte"`.                             |
+| `VIEW_PROPS`   | `object` | Screen, PositionBox props.                                                        |
 
-## Настройки
+## Settings
 
-Нет.
+None.
 
-## Модули
+## Modules
 
-| Модуль                       | Зона ответственности                                                                                                                                                                        |
-| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `qte_view.controller`        | Bridge `QTE.OPENED/CLOSED` → `SHOW/HIDE`; фазы `initial → active → resolved`; таймер fail; пустой `controls` на `ZINDEX`; emit `QTE.RESULT`. Показ/скрытие — через `Screen` (`TRANSITION`). |
-| `qte_view.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `QTE_VIEW.ACTION`; PUSH/POP на SHOW/HIDE.                                                                              |
-| `qte_view.view`              | React-render горизонтальной линии, зоны успеха и маркера; `LOC_LABEL` для статусов.                                                                                                         |
+| Module                       | Role                                                                                                                                                                                    |
+| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `qte_view.controller`        | Bridge `QTE.OPENED/CLOSED` → `SHOW/HIDE`; phases `initial → active → resolved`; fail timer; empty `controls` on `ZINDEX`; emit `QTE.RESULT`. Show/hide through `Screen` (`TRANSITION`). |
+| `qte_view.controller.accept` | Extends `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `QTE_VIEW.ACTION`; PUSH/POP on SHOW/HIDE.                                                                            |
+| `qte_view.view`              | React-render horizontal line, success zone, and marker; `LOC_LABEL` for statuses.                                                                                                       |
 
-## Фазы
+## Phases
 
-| Фаза       | Смысл                                                                                                           |
-| ---------- | --------------------------------------------------------------------------------------------------------------- |
-| `idle`     | Скрыт / сброшен.                                                                                                |
-| `initial`  | Показ `Screen`; маркер ещё не идёт (до `TRANSITION`).                                                           |
-| `active`   | Маркер идёт слева направо за `item.duration`; клик/ACCEPT проверяет попадание в зону `[start, start+size]` (%). |
-| `resolved` | Показ success/fail (`RESULT_DELAY`), затем `QTE.RESULT` и скрытие через `Screen`.                               |
+| Phase      | Meaning                                                                                                     |
+| ---------- | ----------------------------------------------------------------------------------------------------------- |
+| `idle`     | Hidden / reset.                                                                                             |
+| `initial`  | Show `Screen`; marker does not move yet (until `TRANSITION`).                                               |
+| `active`   | Marker moves left to right over `item.duration`; click/ACCEPT checks hit in zone `[start, start+size]` (%). |
+| `resolved` | Show success/fail (`RESULT_DELAY`), then `QTE.RESULT` and hide through `Screen`.                            |
 
-Авто-fail: таймер на конец прохода маркера (`duration`), если игрок не нажал раньше.
+Auto-fail: timer at end of marker pass (`duration`) if the player did not press earlier.
 
-Геометрия view: зона и маркер на одной шкале 0–100% ширины линии; проверка попадания — по progress от elapsed, не по CSS-позиции маркера.
+View geometry: zone and marker share one 0–100% line scale; hit check uses progress from elapsed, not CSS marker position.
 
-## Связь с QTE
+## Link to QTE
 
 ```mermaid
 sequenceDiagram
@@ -85,11 +85,11 @@ sequenceDiagram
 
 ### `compatibility/views.scenario.qte/views.scenario.interface/`
 
-Пакет: `@vnejs/compatibility.views.scenario.qte-with-views.scenario.interface`
+Package: `@vnejs/compatibility.views.scenario.qte-with-views.scenario.interface`
 
-На `QTE_VIEW.SHOW` с `CONST.COMPONENTS.LIFECYCLE_PRIORITY.SHOW.BEFORE` эмитит `INTERFACE.HIDE`. Подключается в `bundles/vn.base`.
+On `QTE_VIEW.SHOW` with `CONST.COMPONENTS.LIFECYCLE_PRIORITY.SHOW.BEFORE` emits `INTERFACE.HIDE`. Wired in `bundles/vn.base`.
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/scenario/
 
@@ -97,10 +97,10 @@ sequenceDiagram
 
 ### plugins/core/
 
-— нет
+— None
 
-### Остальные
+### Other
 
 - [controls.md](../controls/controls.md) — `CONTROLS`: ACCEPT, INTERACT
-- [interface.md](interface.md) — compatibility скрывает interface на `QTE_VIEW.SHOW` (`LIFECYCLE_PRIORITY.SHOW.BEFORE`)
-- [locs.md](../text/locs.md) — тексты статуса через `LOC_LABEL`
+- [interface.md](interface.md) — compatibility hides interface on `QTE_VIEW.SHOW` (`LIFECYCLE_PRIORITY.SHOW.BEFORE`)
+- [locs.md](../text/locs.md) — status text via `LOC_LABEL`

package/plugins/views.screens/checkers.md

@@ -1,55 +1,55 @@
 # plugins/views.screens/checkers/
 
-Пакет: `@vnejs/plugins.views.screens.checkers` · namespace: `CHECKERS_VIEW`
+Package: `@vnejs/plugins.views.screens.checkers` · namespace: `CHECKERS_VIEW`
 
-Экран русских шашек: доска 8×8, сетка, клик / ACCEPT. Правила — в [`game/checkers`](../game/checkers.md) (`CHECKERS`); AI — в [`ai/checkers`](../ai/checkers.md) (`CHECKERS_AI`).
+Russian checkers screen: 8×8 board, grid, click / ACCEPT. Rules — in [`game/checkers`](../game/checkers.md) (`CHECKERS`); AI — in [`ai/checkers`](../ai/checkers.md) (`CHECKERS_AI`).
 
-Bridge: `CHECKERS.SHOW/HIDE` → `CHECKERS_VIEW.SHOW/HIDE`. Модель доски зеркалится с `GRID.CHANGED` / `GRID.UNSET` (`cells` → `board`, фильтр `CONST.CHECKERS.GRID_ID`); сторона хода — с `TURNS.CHANGED` / `TURNS.UNSET`; победитель — с `CHECKERS.FINISH` `{ winner }` (сброс на `SHOW`).
+Bridge: `CHECKERS.SHOW/HIDE` → `CHECKERS_VIEW.SHOW/HIDE`. Board model mirrors `GRID.CHANGED` / `GRID.UNSET` (`cells` → `board`, filter `CONST.CHECKERS.GRID_ID`); side to move — from `TURNS.CHANGED` / `TURNS.UNSET`; winner — from `CHECKERS.FINISH` `{ winner }` (reset on `SHOW`).
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.screens.checkers`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.views.screens.checkers`.
 
-| Ключ                     | Строка                               | Смысл                                                                    |
-| ------------------------ | ------------------------------------ | ------------------------------------------------------------------------ |
-| `SHOW` / `HIDE`          | `vne:checkers_view:show` / `…:hide`  | Показ / скрытие экрана.                                                  |
-| `UPDATE` / `UPDATE_FAST` | `vne:checkers_view:update` / `_fast` | React-view.                                                              |
-| `ACCEPT`                 | `vne:checkers_view:accept`           | Выбор клетки → `GRID_CLEAR` + `PLAYER_INTERACT`.                         |
-| `UPDATE_STATE`           | `vne:checkers_view:update_state`     | Патч view-стейта (grid + зеркало доски).                                 |
-| `GRID_*`                 | `vne:checkers_view:grid_*`           | Навигация сетки.                                                         |
-| `CLICK`                  | `vne:checkers_view:click`            | Клик → `GRID_CLEAR` + `PLAYER_INTERACT`.                                 |
-| `PLAYER_INTERACT`        | `vne:checkers_view:player_interact`  | UX выбора фигуры / клетки → `MOVES_GET` / `MOVE_PLAY` / `PLAYER_SELECT`. |
-| `PLAYER_SELECT`          | `vne:checkers_view:player_select`    | Патч `selected` / `legalMoves` → `gridItems` + `UPDATE_FAST`.            |
+| Key                      | String                               | Meaning                                                             |
+| ------------------------ | ------------------------------------ | ------------------------------------------------------------------- |
+| `SHOW` / `HIDE`          | `vne:checkers_view:show` / `…:hide`  | Show / hide the screen.                                             |
+| `UPDATE` / `UPDATE_FAST` | `vne:checkers_view:update` / `_fast` | React view.                                                         |
+| `ACCEPT`                 | `vne:checkers_view:accept`           | Cell pick → `GRID_CLEAR` + `PLAYER_INTERACT`.                       |
+| `UPDATE_STATE`           | `vne:checkers_view:update_state`     | Patch view state (grid + board mirror).                             |
+| `GRID_*`                 | `vne:checkers_view:grid_*`           | Grid navigation.                                                    |
+| `CLICK`                  | `vne:checkers_view:click`            | Click → `GRID_CLEAR` + `PLAYER_INTERACT`.                           |
+| `PLAYER_INTERACT`        | `vne:checkers_view:player_interact`  | Piece / cell pick UX → `MOVES_GET` / `MOVE_PLAY` / `PLAYER_SELECT`. |
+| `PLAYER_SELECT`          | `vne:checkers_view:player_select`    | Patch `selected` / `legalMoves` → `gridItems` + `UPDATE_FAST`.      |
 
-## Параметры
+## Parameters
 
-| Ключ                                       | Смысл                                |
+| Key                                        | Meaning                              |
 | ------------------------------------------ | ------------------------------------ |
-| `TRANSITION`                               | анимации экрана / клеток (мс, `300`) |
-| `ZINDEX`                                   | z-index экрана                       |
+| `TRANSITION`                               | Screen / cell animations (ms, `300`) |
+| `ZINDEX`                                   | Screen z-index                       |
 | `ROWS` / `COLUMNS`                         | `8`                                  |
-| `CELL_SIZE` / `CELL_GAP` / `GRAVEYARD_GAP` | layout доски                         |
-| `VIEW_PROPS`                               | layout screen / status / flex        |
+| `CELL_SIZE` / `CELL_GAP` / `GRAVEYARD_GAP` | Board layout                         |
+| `VIEW_PROPS`                               | Screen / status / flex layout        |
 
-## Модули
+## Modules
 
-| Модуль                                           | Зона                                                                                         |
-| ------------------------------------------------ | -------------------------------------------------------------------------------------------- |
-| `checkers_view.bridge`                           | SHOW/HIDE bridge                                                                             |
-| `checkers_view.controller` / `.grid` / `.accept` | экран, сетка, ACCEPT; на `HIDE.CLEANUP` сетка пишет `gridRow` / `gridColumn` как `undefined` |
-| `checkers_view.click` / `.player.interact`       | клик и выбор (game: `MOVES_GET` / `MOVE_PLAY`)                                               |
-| `checkers_view.player.select`                    | `PLAYER_SELECT` → selection + grid                                                           |
-| `checkers_view.board`                            | `GRID.CHANGED` / `UNSET` → `gridItems` + `UPDATE_FAST`                                       |
-| `checkers_view.status`                           | `TURNS` / `FINISH` / `SHOW` → status text                                                    |
-| `checkers_view.view`                             | React                                                                                        |
+| Module                                           | Role                                                                                        |
+| ------------------------------------------------ | ------------------------------------------------------------------------------------------- |
+| `checkers_view.bridge`                           | SHOW/HIDE bridge                                                                            |
+| `checkers_view.controller` / `.grid` / `.accept` | Screen, grid, ACCEPT; on `HIDE.CLEANUP` grid writes `gridRow` / `gridColumn` as `undefined` |
+| `checkers_view.click` / `.player.interact`       | Click and pick (game: `MOVES_GET` / `MOVE_PLAY`)                                            |
+| `checkers_view.player.select`                    | `PLAYER_SELECT` → selection + grid                                                          |
+| `checkers_view.board`                            | `GRID.CHANGED` / `UNSET` → `gridItems` + `UPDATE_FAST`                                      |
+| `checkers_view.status`                           | `TURNS` / `FINISH` / `SHOW` → status text                                                   |
+| `checkers_view.view`                             | React                                                                                       |
 
-## Сценарий
+## Scenario
 
 `$ checkers` — [`game/checkers`](../game/checkers.md); `$ checkers.ai` — [`ai/checkers`](../ai/checkers.md).
 
-## Близкие плагины
+## Related plugins
 
-- [common/grid.md](../common/grid.md) — `GRID` (доска)
+- [common/grid.md](../common/grid.md) — `GRID` (board)
 - [common/turn.md](../common/turn.md) — `TURNS` (`id` / `owner`)
-- [game/checkers.md](../game/checkers.md) — правила
+- [game/checkers.md](../game/checkers.md) — rules
 - [ai/checkers.md](../ai/checkers.md) — AI

package/plugins/views.screens/confirm.md

@@ -1,57 +1,57 @@
 # plugins/views.screens/confirm/
 
-Пакет: `@vnejs/plugins.views.screens.confirm` · namespace: `CONFIRM`
+Package: `@vnejs/plugins.views.screens.confirm` · namespace: `CONFIRM`
 
-Модальный экран подтверждения с выбором принять или отклонить и колбэками.
+Modal confirm screen with accept or decline and callbacks.
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.screens.confirm`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.views.screens.confirm`.
 
-| Ключ           | Строка                     | Смысл                                                                                           |
-| -------------- | -------------------------- | ----------------------------------------------------------------------------------------------- |
-| `SHOW`         | `vne:confirm:show`         | Показать UI или слой.                                                                           |
-| `HIDE`         | `vne:confirm:hide`         | Скрыть UI или слой.                                                                             |
-| `EMIT`         | `vne:confirm:emit`         | Инициировать действие или цикл.                                                                 |
-| `UPDATE`       | `vne:confirm:update`       | Обновить состояние или отображение.                                                             |
-| `UPDATE_FAST`  | `vne:confirm:update_fast`  | Быстрый UPDATE view без анимации (стрелки).                                                     |
-| `UPDATE_FORCE` | `vne:confirm:update_force` | Перерисовать view с `isForce`, стейт не меняет.                                                 |
-| `UPDATE_STATE` | `vne:confirm:update_state` | Слить `{ currentArrowHorizontalItem }` в стейт controller/accept без UPDATE view.               |
-| `ACCEPT`       | `vne:confirm:accept`       | Событие `ACCEPT` namespace плагина.                                                             |
-| `DECLINE`      | `vne:confirm:decline`      | Событие `DECLINE` namespace плагина.                                                            |
-| `SUBMIT`       | `vne:confirm:submit`       | `ACCEPT` / `INTERACT`: при `currentArrowHorizontalItem` — ACCEPT (0) или DECLINE, иначе ACCEPT. |
+| Key            | String                     | Meaning                                                                                        |
+| -------------- | -------------------------- | ---------------------------------------------------------------------------------------------- |
+| `SHOW`         | `vne:confirm:show`         | Show the UI or layer.                                                                          |
+| `HIDE`         | `vne:confirm:hide`         | Hide the UI or layer.                                                                          |
+| `EMIT`         | `vne:confirm:emit`         | Start an action or cycle.                                                                      |
+| `UPDATE`       | `vne:confirm:update`       | Update state or display.                                                                       |
+| `UPDATE_FAST`  | `vne:confirm:update_fast`  | Fast UPDATE view without animation (arrows).                                                   |
+| `UPDATE_FORCE` | `vne:confirm:update_force` | Redraw the view with `isForce`; state does not change.                                         |
+| `UPDATE_STATE` | `vne:confirm:update_state` | Merge `{ currentArrowHorizontalItem }` into controller/accept state without UPDATE view.       |
+| `ACCEPT`       | `vne:confirm:accept`       | Plugin namespace `ACCEPT` event.                                                               |
+| `DECLINE`      | `vne:confirm:decline`      | Plugin namespace `DECLINE` event.                                                              |
+| `SUBMIT`       | `vne:confirm:submit`       | `ACCEPT` / `INTERACT`: with `currentArrowHorizontalItem` — ACCEPT (0) or DECLINE, else ACCEPT. |
 
-## Константы
+## Constants
 
-Нет.
+None.
 
-## Параметры
+## Parameters
 
-| Ключ         | Тип      | Смысл                                |
-| ------------ | -------- | ------------------------------------ |
-| `TRANSITION` | `string` | Значение по умолчанию: "TRANSITION". |
+| Key          | Type     | Meaning                |
+| ------------ | -------- | ---------------------- |
+| `TRANSITION` | `string` | Default: "TRANSITION". |
 
-## Настройки
+## Settings
 
-Нет.
+None.
 
-## Модули
+## Modules
 
-| Модуль                      | Зона ответственности                                                                                                                                                                                                                                                                              |
-| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `confirm.controller`        | SHOW/HIDE; BACK → `DECLINE`; зеркалит `UPDATE_STATE` в стейт и `UPDATE_FAST` во view.                                                                                                                                                                                                             |
-| `confirm.controller.arrows` | Наследует `@vnejs/module.controller.arrows.horizontal`: `ARROW_LEFT` / `ARROW_RIGHT` по Accept/Decline; PUSH/POP controls на SHOW/HIDE; эмитит `UPDATE_STATE` с `{ currentArrowHorizontalItem }` и `UPDATE_FAST`. На `HIDE.CLEANUP` `currentArrowHorizontalItem` в стейте становится `undefined`. |
-| `confirm.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `SUBMIT` → `ACCEPT` или `DECLINE` по `currentArrowHorizontalItem`; зеркалит `UPDATE_STATE`; PUSH/POP на SHOW/HIDE.                                                                                                           |
-| `confirm.hide.state`        | Наследует `@vnejs/module.controller.hide.on.state`: только `STATE.CLEAR` → `HIDE` с `{ isForce: true }` (`IS_STATE_SET_ENABLED = false`).                                                                                                                                                         |
-| `confirm`                   | Обрабатывает EMIT, ACCEPT, DECLINE. Колбэки accept/decline снимаются на `HIDE.MAIN`, если контроллер не оборвал скрытие на `GATE`.                                                                                                                                                                |
-| `confirm.view`              | Подмодуль `view` плагина.                                                                                                                                                                                                                                                                         |
+| Module                      | Role                                                                                                                                                                                                                                                                                               |
+| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `confirm.controller`        | SHOW/HIDE; BACK → `DECLINE`; mirrors `UPDATE_STATE` into state and `UPDATE_FAST` into view.                                                                                                                                                                                                        |
+| `confirm.controller.arrows` | Extends `@vnejs/module.controller.arrows.horizontal`: `ARROW_LEFT` / `ARROW_RIGHT` over Accept/Decline; PUSH/POP controls on SHOW/HIDE; emits `UPDATE_STATE` with `{ currentArrowHorizontalItem }` and `UPDATE_FAST`. On `HIDE.CLEANUP` `currentArrowHorizontalItem` in state becomes `undefined`. |
+| `confirm.controller.accept` | Extends `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `SUBMIT` → `ACCEPT` or `DECLINE` by `currentArrowHorizontalItem`; mirrors `UPDATE_STATE`; PUSH/POP on SHOW/HIDE.                                                                                                                |
+| `confirm.hide.state`        | Extends `@vnejs/module.controller.hide.on.state`: only `STATE.CLEAR` → `HIDE` with `{ isForce: true }` (`IS_STATE_SET_ENABLED = false`).                                                                                                                                                           |
+| `confirm`                   | Handles EMIT, ACCEPT, DECLINE. Accept/decline callbacks clear on `HIDE.MAIN` if the controller did not abort hide at `GATE`.                                                                                                                                                                       |
+| `confirm.view`              | Plugin `view` submodule.                                                                                                                                                                                                                                                                           |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
 - [state.md](../core/state.md) — `STATE`: EVENTS.CLEAR
 
-### Остальные
+### Other
 
 - [controls.md](../controls/controls.md) — `CONTROLS`: CONST.BUTTONS.INTERACT, CONST.BUTTONS.ACCEPT, CONST.BUTTONS.BACK, CONST.BUTTONS.ARROW_LEFT, CONST.BUTTONS.ARROW_RIGHT

package/plugins/views.screens/credits.md

@@ -1,50 +1,50 @@
 # plugins/views.screens/credits/
 
-Пакет: `@vnejs/plugins.views.screens.credits` · namespace: `CREDITS`
+Package: `@vnejs/plugins.views.screens.credits` · namespace: `CREDITS`
 
-Экран титров, открываемый и закрываемый командами сценария show/hide.
+Credits screen, opened and closed by scenario show/hide commands.
 
-Конец прокрутки и клик по экрану шлют `HIDE`. На `HIDE.AFTER` уходит `SCENARIO.NEXT`: если титры открыты из главного меню, строка `$ mainmenu` уже пройдена, метка заканчивается, пустой стек делает `STACK.CLEAR`, и сценарий снова идёт с лейбла `init`.
+Scroll end and a screen click emit `HIDE`. On `HIDE.AFTER` — `SCENARIO.NEXT`: if credits opened from the main menu, the `$ mainmenu` line is already past, the label ends, an empty stack runs `STACK.CLEAR`, and the scenario runs again from the `init` label.
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.screens.credits`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.views.screens.credits`.
 
-| Ключ           | Строка                     | Смысл                                           |
-| -------------- | -------------------------- | ----------------------------------------------- |
-| `SHOW`         | `vne:credits:show`         | Показать UI или слой.                           |
-| `HIDE`         | `vne:credits:hide`         | Скрыть UI или слой.                             |
-| `UPDATE`       | `vne:credits:update`       | Обновить состояние или отображение.             |
-| `UPDATE_FAST`  | `vne:credits:update_fast`  | Быстрое обновление отображения.                 |
-| `UPDATE_FORCE` | `vne:credits:update_force` | Перерисовать view с `isForce`, стейт не меняет. |
-| `UPDATE_STATE` | `vne:credits:update_state` | Слить partial в стейт контроллера.              |
+| Key            | String                     | Meaning                                                |
+| -------------- | -------------------------- | ------------------------------------------------------ |
+| `SHOW`         | `vne:credits:show`         | Show the UI or layer.                                  |
+| `HIDE`         | `vne:credits:hide`         | Hide the UI or layer.                                  |
+| `UPDATE`       | `vne:credits:update`       | Update state or display.                               |
+| `UPDATE_FAST`  | `vne:credits:update_fast`  | Fast display update.                                   |
+| `UPDATE_FORCE` | `vne:credits:update_force` | Redraw the view with `isForce`; state does not change. |
+| `UPDATE_STATE` | `vne:credits:update_state` | Merge a partial into the controller state.             |
 
-## Константы
+## Constants
 
-Нет.
+None.
 
-## Параметры
+## Parameters
 
-| Ключ    | Тип      | Смысл                           |
-| ------- | -------- | ------------------------------- |
-| `LINES` | `string` | Значение по умолчанию: "LINES". |
+| Key     | Type     | Meaning           |
+| ------- | -------- | ----------------- |
+| `LINES` | `string` | Default: "LINES". |
 
-## Настройки
+## Settings
 
-Нет.
+None.
 
-## Модули
+## Modules
 
-| Модуль                        | Зона ответственности                                                                                                        |
+| Module                        | Role                                                                                                                        |
 | ----------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
-| `credits.controller`          | SHOW/HIDE по фазам `CONST.COMPONENTS.LIFECYCLE_PRIORITY`; пустой `controls` на `ZINDEX`; на `HIDE.AFTER` — `SCENARIO.NEXT`. |
-| `credits.controller.interact` | Наследует `@vnejs/module.controller.interact`: `BUTTONS.ANY` → `INTERACT.EMIT`; `onInteract` → `CREDITS.HIDE`.              |
-| `credits.hide.controls`       | Наследует `@vnejs/module.controller.hide.on.controls`: `BACK` / `MENU` / `GAMEMENU` → `HIDE`; PUSH/POP на SHOW/HIDE.        |
-| `credits.hide.state`          | Наследует `@vnejs/module.controller.hide.on.state`: `STATE.SET` / `STATE.CLEAR` → `HIDE` с `{ isForce: true }`.             |
-| `credits`                     | Модуль `credits`.                                                                                                           |
-| `credits.view`                | Подмодуль `view` плагина.                                                                                                   |
+| `credits.controller`          | SHOW/HIDE by `CONST.COMPONENTS.LIFECYCLE_PRIORITY` phases; empty `controls` on `ZINDEX`; on `HIDE.AFTER` — `SCENARIO.NEXT`. |
+| `credits.controller.interact` | Extends `@vnejs/module.controller.interact`: `BUTTONS.ANY` → `INTERACT.EMIT`; `onInteract` → `CREDITS.HIDE`.                |
+| `credits.hide.controls`       | Extends `@vnejs/module.controller.hide.on.controls`: `BACK` / `MENU` / `GAMEMENU` → `HIDE`; PUSH/POP on SHOW/HIDE.          |
+| `credits.hide.state`          | Extends `@vnejs/module.controller.hide.on.state`: `STATE.SET` / `STATE.CLEAR` → `HIDE` with `{ isForce: true }`.            |
+| `credits`                     | `credits` module.                                                                                                           |
+| `credits.view`                | Plugin `view` submodule.                                                                                                    |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
@@ -52,6 +52,6 @@ Payloads и результаты хендлеров типизированы ч
 - [state.md](../core/state.md) — `STATE`: EVENTS.SET, EVENTS.CLEAR
 - [scenario.md](../core/scenario.md) — `SCENARIO`: EVENTS.NEXT, EVENTS.LINE_EXEC_REG
 
-### Остальные
+### Other
 
 - [controls.md](../controls/controls.md) — `CONTROLS`: CONST.BUTTONS.ANY, CONST.BUTTONS.BACK, CONST.BUTTONS.MENU, CONST.BUTTONS.GAMEMENU