@vnejs/docs 0.2.65 → 0.2.66

package/plugins/views.scenario/choose.md

@@ -1,53 +1,53 @@
-# plugins/views.scenario/choose/
+# plugins/views/scenario/choose/
 
-Пакет: `@vnejs/plugins.views.scenario.choose` · namespace: `CHOOSE_VIEW`
+Package: `@vnejs/plugins.views.scenario.choose` · namespace: `CHOOSE_VIEW`
 
-React-UI выбора из текстовых опций. Зависит от scenario-плагина [choose.md](../scenario/choose.md) (`CHOOSE`): слушает `SHOW` / `HIDE`, эмитит `OPTION` при выборе игроком.
+React UI for choosing text options. Depends on the scenario plugin [choose.md](../scenario/choose.md) (`CHOOSE`): listens to `SHOW` / `HIDE`, emits `OPTION` when the player picks one.
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.scenario.choose`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.views.scenario.choose`.
 
-| Ключ           | Строка                         | Смысл                                                                  |
+| Key            | String                         | Meaning                                                                |
 | -------------- | ------------------------------ | ---------------------------------------------------------------------- |
-| `SHOW`         | `vne:choose_view:show`         | Показать UI выбора.                                                    |
-| `HIDE`         | `vne:choose_view:hide`         | Скрыть UI выбора.                                                      |
-| `UPDATE`       | `vne:choose_view:update`       | Обновить React-store / отображение.                                    |
-| `UPDATE_STATE` | `vne:choose_view:update_state` | Слить partial в стейт контроллера без UPDATE view.                     |
-| `UPDATE_FAST`  | `vne:choose_view:update_fast`  | Перерисовать view с `isFast`, стейт не меняет.                         |
-| `UPDATE_FORCE` | `vne:choose_view:update_force` | Перерисовать view с `isForce`, стейт не меняет.                        |
-| `ACCEPT`       | `vne:choose_view:accept`       | `ACCEPT` / `INTERACT` → `CHOOSE.OPTION` по `currentArrowVerticalItem`. |
+| `SHOW`         | `vne:choose_view:show`         | Show the choice UI.                                                    |
+| `HIDE`         | `vne:choose_view:hide`         | Hide the choice UI.                                                    |
+| `UPDATE`       | `vne:choose_view:update`       | Update the React store / display.                                      |
+| `UPDATE_STATE` | `vne:choose_view:update_state` | Merge a partial into the controller state without an UPDATE view.      |
+| `UPDATE_FAST`  | `vne:choose_view:update_fast`  | Redraw the view with `isFast`; state does not change.                  |
+| `UPDATE_FORCE` | `vne:choose_view:update_force` | Redraw the view with `isForce`; state does not change.                 |
+| `ACCEPT`       | `vne:choose_view:accept`       | `ACCEPT` / `INTERACT` → `CHOOSE.OPTION` by `currentArrowVerticalItem`. |
 
-Сценарные события (`EMIT`, `OPTION`, `SHOW`, `HIDE`, `SKIP`, `EXEC_*`, `STATE_UPDATE`) — в контракте `@vnejs/contracts.scenario.choose`, namespace `CHOOSE`.
+Scenario events (`EMIT`, `OPTION`, `SHOW`, `HIDE`, `SKIP`, `EXEC_*`, `STATE_UPDATE`) — contract `@vnejs/contracts.scenario.choose`, namespace `CHOOSE`.
 
-## Константы
+## Constants
 
-Нет.
+None.
 
-## Параметры
+## Parameters
 
-| Ключ                  | Тип      | Смысл                                                                  |
-| --------------------- | -------- | ---------------------------------------------------------------------- |
-| `TRANSITION`          | `number` | Длительность анимации показа/скрытия (мс).                             |
-| `ZINDEX`              | `number` | Z-index слоя и индекс блока controls.                                  |
-| `VIEW_PROPS`          | `object` | Пропсы Screen, PositionBox, Flex-wrap, title Text, TextControls, Text. |
-| `CONTROLS_EXTENSIONS` | `object` | Дополнительные обработчики controls.                                   |
+| Key                   | Type     | Meaning                                                               |
+| --------------------- | -------- | --------------------------------------------------------------------- |
+| `TRANSITION`          | `number` | Show/hide animation duration (ms).                                    |
+| `ZINDEX`              | `number` | Layer z-index and controls block index.                               |
+| `VIEW_PROPS`          | `object` | Screen, PositionBox, Flex-wrap, title Text, TextControls, Text props. |
+| `CONTROLS_EXTENSIONS` | `object` | Extra controls handlers.                                              |
 
-## Настройки
+## Settings
 
-Нет.
+None.
 
-## Модули
+## Modules
 
-| Модуль                          | Зона ответственности                                                                                                                                                                                                                                                                                                                                   |
-| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `choose_view.bridge`            | Bridge `CHOOSE.SHOW/HIDE` → `CHOOSE_VIEW.SHOW/HIDE`.                                                                                                                                                                                                                                                                                                   |
-| `choose_view.controller`        | `CONTROLS_EXTENSIONS` сливается в `CONTROLS` в `ModuleController.init`; на `SHOW` + `LIFECYCLE_PRIORITY.SHOW.BEFORE` копирует `globalState.choose`; сброс стейта на `HIDE.CLEANUP` делает `ModuleController` (`SHOULD_CLEAR_STATE_ON_CLEANUP`). Зеркало `UPDATE_STATE` / `UPDATE_FAST`.                                                                |
-| `choose_view.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CHOOSE.OPTION` по `currentArrowVerticalItem`; зеркалит `UPDATE_STATE`; PUSH/POP на SHOW/HIDE.                                                                                                                                                                         |
-| `choose_view.controller.arrows` | Наследует `@vnejs/module.controller.arrows.vertical`: `ARROW_UP` / `ARROW_BOTTOM` по полному `options[]`; скипает `hided` через `isArrowItemAvailable` (индекс исходный); PUSH/POP на SHOW/HIDE; эмитит `UPDATE_STATE` с `{ currentArrowVerticalItem }` и `UPDATE_FAST`. На `HIDE.CLEANUP` `currentArrowVerticalItem` в стейте становится `undefined`. |
-| `choose_view.view`              | React-render опций; опциональный заголовок из `args.title`.                                                                                                                                                                                                                                                                                            |
+| Module                          | Role                                                                                                                                                                                                                                                                                                                                                  |
+| ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `choose_view.bridge`            | Bridge `CHOOSE.SHOW/HIDE` → `CHOOSE_VIEW.SHOW/HIDE`.                                                                                                                                                                                                                                                                                                  |
+| `choose_view.controller`        | `CONTROLS_EXTENSIONS` merges into `CONTROLS` in `ModuleController.init`; on `SHOW` + `LIFECYCLE_PRIORITY.SHOW.BEFORE` copies `globalState.choose`; state reset on `HIDE.CLEANUP` is done by `ModuleController` (`SHOULD_CLEAR_STATE_ON_CLEANUP`). Mirrors `UPDATE_STATE` / `UPDATE_FAST`.                                                             |
+| `choose_view.controller.accept` | Extends `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CHOOSE.OPTION` by `currentArrowVerticalItem`; mirrors `UPDATE_STATE`; PUSH/POP on SHOW/HIDE.                                                                                                                                                                           |
+| `choose_view.controller.arrows` | Extends `@vnejs/module.controller.arrows.vertical`: `ARROW_UP` / `ARROW_BOTTOM` over full `options[]`; skips `hided` via `isArrowItemAvailable` (index stays original); PUSH/POP on SHOW/HIDE; emits `UPDATE_STATE` with `{ currentArrowVerticalItem }` and `UPDATE_FAST`. On `HIDE.CLEANUP` `currentArrowVerticalItem` in state becomes `undefined`. |
+| `choose_view.view`              | React-render options; optional title from `args.title`.                                                                                                                                                                                                                                                                                               |
 
-## Связь с CHOOSE
+## Link to CHOOSE
 
 ```mermaid
 sequenceDiagram
@@ -60,7 +60,7 @@ sequenceDiagram
   OBS->>BR: bridge
   BR->>OBS: vne:choose_view:show
   OBS->>VC: onShow
-  Note over VC: SHOW BEFORE читает globalState.choose
+  Note over VC: SHOW BEFORE reads globalState.choose
   VC->>OBS: vne:choose:option
   OBS->>SC: onChooseOption
   SC->>OBS: vne:choose:hide
@@ -68,7 +68,7 @@ sequenceDiagram
   BR->>OBS: vne:choose_view:hide
 ```
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/scenario/
 
@@ -76,10 +76,10 @@ sequenceDiagram
 
 ### plugins/core/
 
-- [state.md](../core/state.md) — restore через `CHOOSE` + bridge
+- [state.md](../core/state.md) — restore via `CHOOSE` + bridge
 
-### Остальные
+### Other
 
-- [controls.md](../controls/controls.md) — `CONTROLS`: стрелки, ACCEPT, INTERACT
-- [interface.md](interface.md) — compatibility скрывает interface на `CHOOSE_VIEW.SHOW` (`LIFECYCLE_PRIORITY.SHOW.BEFORE`)
-- [qte.md](./qte.md) — `QTE_VIEW`: при опции с `qte:` открывается поверх choose (z-index 1300 > 1200)
+- [controls.md](../controls/controls.md) — `CONTROLS`: arrows, ACCEPT, INTERACT
+- [interface.md](interface.md) — compatibility hides interface on `CHOOSE_VIEW.SHOW` (`LIFECYCLE_PRIORITY.SHOW.BEFORE`)
+- [qte.md](./qte.md) — `QTE_VIEW`: option with `qte:` opens above choose (z-index 1300 > 1200)

package/plugins/views.scenario/interface.controls.md

@@ -1,54 +1,54 @@
 # plugins/views.scenario/interface.controls/
 
-Пакет: `@vnejs/plugins.views.scenario.interface.controls` · namespace: `INTERFACE_CONTROLS_VIEW`
+Package: `@vnejs/plugins.views.scenario.interface.controls` · namespace: `INTERFACE_CONTROLS_VIEW`
 
-Кнопки управления интерфейсом: скрытие, продолжение и переключение видимости.
+Interface control buttons: hide, continue, and visibility toggle.
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.scenario.interface.controls`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.views.scenario.interface.controls`.
 
-| Ключ           | Строка                                | Смысл                                           |
-| -------------- | ------------------------------------- | ----------------------------------------------- |
-| `SHOW`         | `vne:interface_controls:show`         | Показать UI или слой.                           |
-| `HIDE`         | `vne:interface_controls:hide`         | Скрыть UI или слой.                             |
-| `UPDATE`       | `vne:interface_controls:update`       | Обновить состояние или отображение.             |
-| `UPDATE_FAST`  | `vne:interface_controls:update_fast`  | Быстрое обновление отображения.                 |
-| `UPDATE_FORCE` | `vne:interface_controls:update_force` | Перерисовать view с `isForce`, стейт не меняет. |
-| `UPDATE_STATE` | `vne:interface_controls:update_state` | Слить partial в стейт контроллера.              |
-| `CLICK`        | `vne:interface_controls:click`        | Событие `CLICK` namespace плагина.              |
-| `ICONS`        | `vne:interface_controls:icons`        | Событие `ICONS` namespace плагина.              |
+| Key            | String                                | Meaning                                                |
+| -------------- | ------------------------------------- | ------------------------------------------------------ |
+| `SHOW`         | `vne:interface_controls:show`         | Show the UI or layer.                                  |
+| `HIDE`         | `vne:interface_controls:hide`         | Hide the UI or layer.                                  |
+| `UPDATE`       | `vne:interface_controls:update`       | Update state or display.                               |
+| `UPDATE_FAST`  | `vne:interface_controls:update_fast`  | Fast display update.                                   |
+| `UPDATE_FORCE` | `vne:interface_controls:update_force` | Redraw the view with `isForce`; state does not change. |
+| `UPDATE_STATE` | `vne:interface_controls:update_state` | Merge a partial into the controller state.             |
+| `CLICK`        | `vne:interface_controls:click`        | Plugin `CLICK` namespace event.                        |
+| `ICONS`        | `vne:interface_controls:icons`        | Plugin `ICONS` namespace event.                        |
 
-## Константы
+## Constants
 
-Нет.
+None.
 
-## Параметры
+## Parameters
 
-| Ключ                  | Тип      | Смысл                                         |
-| --------------------- | -------- | --------------------------------------------- |
-| `VIEW_PROPS`          | `string` | Значение по умолчанию: "VIEW_PROPS".          |
-| `ITEMS`               | `string` | Значение по умолчанию: "ITEMS".               |
-| `CONTROLS_EXTENSIONS` | `string` | Значение по умолчанию: "CONTROLS_EXTENSIONS". |
+| Key                   | Type     | Meaning                         |
+| --------------------- | -------- | ------------------------------- |
+| `VIEW_PROPS`          | `string` | Default: "VIEW_PROPS".          |
+| `ITEMS`               | `string` | Default: "ITEMS".               |
+| `CONTROLS_EXTENSIONS` | `string` | Default: "CONTROLS_EXTENSIONS". |
 
-## Настройки
+## Settings
 
-Нет.
+None.
 
-## Модули
+## Modules
 
-| Модуль                          | Зона ответственности                                                                                                                                                                                                                                                  |
-| ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `interface.controls.controller` | Обрабатывает UPDATE, VISIBLE, INTERACT, SHOW, …. `CONTROLS_EXTENSIONS` сливается в `CONTROLS` в `ModuleController.init`. `SHOULD_CLEAR_STATE_ON_CLEANUP` — `false`: hide не сбрасывает `isVisible` и `view`, чтобы следующий `$ interface show` снова показал кнопки. |
-| `interface.controls.view`       | Подмодуль `controls.view` плагина.                                                                                                                                                                                                                                    |
+| Module                          | Role                                                                                                                                                                                                                                                                |
+| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `interface.controls.controller` | Handles UPDATE, VISIBLE, INTERACT, SHOW, …. `CONTROLS_EXTENSIONS` merges into `CONTROLS` in `ModuleController.init`. `SHOULD_CLEAR_STATE_ON_CLEANUP` — `false`: hide does not reset `isVisible` and `view`, so the next `$ interface show` shows the buttons again. |
+| `interface.controls.view`       | Plugin `controls.view` submodule.                                                                                                                                                                                                                                   |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
 - [memory.md](../core/memory.md) — `MEMORY`: EVENTS.CLEARED
 
-### Остальные
+### Other
 
 - [controls.md](../controls/controls.md) — `CONTROLS`: EVENTS.POP, EVENTS.PUSH, CONST.BUTTONS.INTERFACE_HIDE, CONST.BUTTONS.ARROW_RIGHT, CONST.BUTTONS.ARROW_BOTTOM, CONST.BUTTONS.ANY
 - [interface.md](./interface.md) — `INTERFACE`: EVENTS.VISIBLE, EVENTS.INTERACT, EVENTS.SHOW_CHANGED, EVENTS.VIEW_CHANGED, EVENTS.STATE_CHANGED, EVENTS.VISIBLE_CHANGED

package/plugins/views.scenario/interface.fastforward.md

@@ -1,53 +1,53 @@
 # plugins/views.scenario/interface.fastforward/
 
-Пакет: `@vnejs/plugins.views.scenario.interface.fastforward` · namespace: `INTERFACE_FASTFORWARD_VIEW`
+Package: `@vnejs/plugins.views.scenario.interface.fastforward` · namespace: `INTERFACE_FASTFORWARD_VIEW`
 
-Кнопка и индикатор режима ускоренного просмотра в интерфейсе сценария.
+Fast-forward mode button and indicator in the scenario interface.
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.scenario.interface.fastforward`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.views.scenario.interface.fastforward`.
 
-| Ключ                | Строка                                        | Смысл                                           |
-| ------------------- | --------------------------------------------- | ----------------------------------------------- |
-| `SHOW`              | `vne:interface_fastforward:show`              | Показать UI или слой.                           |
-| `HIDE`              | `vne:interface_fastforward:hide`              | Скрыть UI или слой.                             |
-| `CLICK`             | `vne:interface_fastforward:click`             | Событие `CLICK` namespace плагина.              |
-| `UPDATE`            | `vne:interface_fastforward:update`            | Обновить состояние или отображение.             |
-| `UPDATE_FAST`       | `vne:interface_fastforward:update_fast`       | Быстрое обновление отображения.                 |
-| `UPDATE_FORCE`      | `vne:interface_fastforward:update_force`      | Перерисовать view с `isForce`, стейт не меняет. |
-| `UPDATE_STATE`      | `vne:interface_fastforward:update_state`      | Слить partial в стейт контроллера.              |
-| `DISABLE_ANIMATION` | `vne:interface_fastforward:disable_animation` | Событие `DISABLE_ANIMATION` namespace плагина.  |
+| Key                 | String                                        | Meaning                                                |
+| ------------------- | --------------------------------------------- | ------------------------------------------------------ |
+| `SHOW`              | `vne:interface_fastforward:show`              | Show the UI or layer.                                  |
+| `HIDE`              | `vne:interface_fastforward:hide`              | Hide the UI or layer.                                  |
+| `CLICK`             | `vne:interface_fastforward:click`             | Plugin `CLICK` namespace event.                        |
+| `UPDATE`            | `vne:interface_fastforward:update`            | Update state or display.                               |
+| `UPDATE_FAST`       | `vne:interface_fastforward:update_fast`       | Fast display update.                                   |
+| `UPDATE_FORCE`      | `vne:interface_fastforward:update_force`      | Redraw the view with `isForce`; state does not change. |
+| `UPDATE_STATE`      | `vne:interface_fastforward:update_state`      | Merge a partial into the controller state.             |
+| `DISABLE_ANIMATION` | `vne:interface_fastforward:disable_animation` | Plugin `DISABLE_ANIMATION` namespace event.            |
 
-## Константы
+## Constants
 
-Нет.
+None.
 
-## Параметры
+## Parameters
 
-| Ключ         | Тип      | Смысл                                |
-| ------------ | -------- | ------------------------------------ |
-| `VIEW_PROPS` | `string` | Значение по умолчанию: "VIEW_PROPS". |
+| Key          | Type     | Meaning                |
+| ------------ | -------- | ---------------------- |
+| `VIEW_PROPS` | `string` | Default: "VIEW_PROPS". |
 
-## Настройки
+## Settings
 
-Нет.
+None.
 
-## Модули
+## Modules
 
-| Модуль                             | Зона ответственности                                                                                                                                                                      |
-| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `interface.fastforward.controller` | Обрабатывает UPDATE, TOGGLE, START, STOP, …. `SHOULD_CLEAR_STATE_ON_CLEANUP` — `false`: hide не сбрасывает `isVisible` и `view`, чтобы следующий `$ interface show` снова показал кнопку. |
-| `interface.fastforward.view`       | Подмодуль `fastforward.view` плагина.                                                                                                                                                     |
+| Module                             | Role                                                                                                                                                                                  |
+| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `interface.fastforward.controller` | Handles UPDATE, TOGGLE, START, STOP, …. `SHOULD_CLEAR_STATE_ON_CLEANUP` — `false`: hide does not reset `isVisible` and `view`, so the next `$ interface show` shows the button again. |
+| `interface.fastforward.view`       | Plugin `fastforward.view` submodule.                                                                                                                                                  |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
 - [memory.md](../core/memory.md) — `MEMORY`: EVENTS.CLEARED
 - [system.md](../core/system.md) — `SYSTEM`: EVENTS.STARTED
 
-### Остальные
+### Other
 
 - [controls.md](../controls/controls.md) — `CONTROLS`: EVENTS.POP, EVENTS.PUSH, CONST.BUTTONS.FASTFORWARD_TOGGLE, CONST.BUTTONS.FASTFORWARD_START, CONST.BUTTONS.FASTFORWARD_FINISH
 - [fastforward.md](../scenario/fastforward.md) — `FASTFORWARD`: EVENTS.TOGGLE, EVENTS.START, EVENTS.STOP, EVENTS.CHANGED

package/plugins/views.scenario/interface.md

@@ -1,84 +1,84 @@
-# plugins/views.scenario/interface/
-
-Пакет: `@vnejs/plugins.views.scenario.interface` · namespace: `INTERFACE`
-
-Управляет диалоговым интерфейсом: показ, скрытие, видимость и отображение текста.
-
-## События
-
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.scenario.interface`.
-
-| Ключ              | Строка                          | Смысл                                           |
-| ----------------- | ------------------------------- | ----------------------------------------------- |
-| `SHOW`            | `vne:interface:show`            | Показать UI или слой.                           |
-| `HIDE`            | `vne:interface:hide`            | Скрыть UI или слой.                             |
-| `SHOW_CHANGED`    | `vne:interface:show_changed`    | Показать UI или слой.                           |
-| `VIEW_SHOW`       | `vne:interface:view_show`       | Показать UI или слой.                           |
-| `VIEW_HIDE`       | `vne:interface:view_hide`       | Скрыть UI или слой.                             |
-| `VIEW_UPDATE`     | `vne:interface:view_update`     | Обновить состояние или отображение.             |
-| `UPDATE_FAST`     | `vne:interface:update_fast`     | Быстрое обновление отображения.                 |
-| `UPDATE_FORCE`    | `vne:interface:update_force`    | Перерисовать view с `isForce`, стейт не меняет. |
-| `UPDATE_STATE`    | `vne:interface:update_state`    | Слить partial в стейт контроллера.              |
-| `TEXT_HIDE`       | `vne:interface:text_hide`       | Скрыть UI или слой.                             |
-| `TEXT_CHANGED`    | `vne:interface:text_changed`    | Зафиксировать изменение состояния.              |
-| `WALL_CHANGED`    | `vne:interface:wall_changed`    | Зафиксировать изменение состояния.              |
-| `SPEAKER_CHANGED` | `vne:interface:speaker_changed` | Зафиксировать смену текущего спикера.           |
-| `VISIBLE`         | `vne:interface:visible`         | Событие `VISIBLE` namespace плагина.            |
-| `VISIBLE_CHANGED` | `vne:interface:visible_changed` | Зафиксировать изменение состояния.              |
-| `VIEW`            | `vne:interface:view`            | Событие `VIEW` namespace плагина.               |
-| `VIEW_CHANGED`    | `vne:interface:view_changed`    | Зафиксировать изменение состояния.              |
-| `INTERACT`        | `vne:interface:interact`        | Событие `INTERACT` namespace плагина.           |
-| `STATE_CHANGED`   | `vne:interface:state_changed`   | Сигнал об изменении накопленного состояния.     |
-
-## Константы
-
-| Ключ                | Значение | Смысл                                    |
-| ------------------- | -------- | ---------------------------------------- |
-| `EXEC_ACTIONS.SHOW` | `show`   | Сценарное действие `$ interface show`.   |
-| `EXEC_ACTIONS.HIDE` | `hide`   | Сценарное действие `$ interface hide`.   |
-| `EXEC_ACTIONS.VIEW` | `view`   | Сценарное действие `$ interface view …`. |
-
-## Параметры
-
-| Ключ           | Тип      | Смысл                                  |
-| -------------- | -------- | -------------------------------------- |
-| `DEFAULT_VIEW` | `string` | Значение по умолчанию: "DEFAULT_VIEW". |
-| `LOC_LABEL`    | `string` | Имя метки или стартовой точки.         |
-| `TRANSITION`   | `string` | Значение по умолчанию: "TRANSITION".   |
-| `ZINDEX`       | `string` | Значение по умолчанию: "ZINDEX".       |
-| `VIEW_PROPS`   | `string` | Значение по умолчанию: "VIEW_PROPS".   |
-
-## Настройки
-
-Нет.
-
-## Модули
-
-| Модуль                        | Зона ответственности                                                                                                                                                                                             |
-| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `interface.controller`        | Обрабатывает VIEW_UPDATE, VIEW_SHOW, VIEW_HIDE, …. Пустой `controls` на `ZINDEX`; `CONTROLS_UNVISIBLE` при скрытии слоя. `SHOULD_CLEAR_STATE_ON_CLEANUP` — `false`, поэтому текст и задник переживают hide.      |
-| `interface.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `INTERFACE.INTERACT`; видимый слой → `INTERACT.EMIT`, скрытый → `INTERFACE.VISIBLE`; PUSH/POP на VIEW_SHOW/HIDE.                            |
-| `interface`                   | STATE.SET / STATE.CLEAR → STATE_CHANGED.                                                                                                                                                                         |
-| `interface.scenario`          | `$ interface`: `LINE_EXEC_REG` → SHOW / HIDE / VIEW по `CONST.INTERFACE.EXEC_ACTIONS`.                                                                                                                           |
-| `interface.actions`           | VISIBLE / TEXT_HIDE / VIEW через `globalState.interface`.                                                                                                                                                        |
-| `interface.actions.show`      | Подписки `SHOW` и `HIDE`. На `GATE` (`breakFollowing`): если интерфейс уже в целевом состоянии или цикл show/hide уже идёт, остальные подписчики этих событий не вызываются. Показ скрытого слоя шлёт `VISIBLE`. |
-| `interface.view`              | `isForce` доходит до `SmoothText` в `InterfaceViewDialog`, `InterfaceViewLine` и `InterfaceViewWall`.                                                                                                            |
+# plugins/views/scenario/interface/
+
+Package: `@vnejs/plugins.views.scenario.interface` · namespace: `INTERFACE`
+
+Controls the dialogue interface: show, hide, visibility, and text display.
+
+## Events
+
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.views.scenario.interface`.
+
+| Key               | String                          | Meaning                                                |
+| ----------------- | ------------------------------- | ------------------------------------------------------ |
+| `SHOW`            | `vne:interface:show`            | Show the UI or layer.                                  |
+| `HIDE`            | `vne:interface:hide`            | Hide the UI or layer.                                  |
+| `SHOW_CHANGED`    | `vne:interface:show_changed`    | Show the UI or layer.                                  |
+| `VIEW_SHOW`       | `vne:interface:view_show`       | Show the UI or layer.                                  |
+| `VIEW_HIDE`       | `vne:interface:view_hide`       | Hide the UI or layer.                                  |
+| `VIEW_UPDATE`     | `vne:interface:view_update`     | Update state or display.                               |
+| `UPDATE_FAST`     | `vne:interface:update_fast`     | Fast display update.                                   |
+| `UPDATE_FORCE`    | `vne:interface:update_force`    | Redraw the view with `isForce`; state does not change. |
+| `UPDATE_STATE`    | `vne:interface:update_state`    | Merge a partial into the controller state.             |
+| `TEXT_HIDE`       | `vne:interface:text_hide`       | Hide the UI or layer.                                  |
+| `TEXT_CHANGED`    | `vne:interface:text_changed`    | Record a state change.                                 |
+| `WALL_CHANGED`    | `vne:interface:wall_changed`    | Record a state change.                                 |
+| `SPEAKER_CHANGED` | `vne:interface:speaker_changed` | Record the current speaker change.                     |
+| `VISIBLE`         | `vne:interface:visible`         | Plugin `VISIBLE` namespace event.                      |
+| `VISIBLE_CHANGED` | `vne:interface:visible_changed` | Record a state change.                                 |
+| `VIEW`            | `vne:interface:view`            | Plugin `VIEW` namespace event.                         |
+| `VIEW_CHANGED`    | `vne:interface:view_changed`    | Record a state change.                                 |
+| `INTERACT`        | `vne:interface:interact`        | Plugin `INTERACT` namespace event.                     |
+| `STATE_CHANGED`   | `vne:interface:state_changed`   | Signal that accumulated state changed.                 |
+
+## Constants
+
+| Key                 | Value  | Meaning                               |
+| ------------------- | ------ | ------------------------------------- |
+| `EXEC_ACTIONS.SHOW` | `show` | Scenario action `$ interface show`.   |
+| `EXEC_ACTIONS.HIDE` | `hide` | Scenario action `$ interface hide`.   |
+| `EXEC_ACTIONS.VIEW` | `view` | Scenario action `$ interface view …`. |
+
+## Parameters
+
+| Key            | Type     | Meaning                    |
+| -------------- | -------- | -------------------------- |
+| `DEFAULT_VIEW` | `string` | Default: "DEFAULT_VIEW".   |
+| `LOC_LABEL`    | `string` | Label name or entry point. |
+| `TRANSITION`   | `string` | Default: "TRANSITION".     |
+| `ZINDEX`       | `string` | Default: "ZINDEX".         |
+| `VIEW_PROPS`   | `string` | Default: "VIEW_PROPS".     |
+
+## Settings
+
+None.
+
+## Modules
+
+| Module                        | Role                                                                                                                                                                                                                                      |
+| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `interface.controller`        | Handles VIEW_UPDATE, VIEW_SHOW, VIEW_HIDE, …. Empty `controls` on `ZINDEX`; `CONTROLS_UNVISIBLE` when the layer hides. `SHOULD_CLEAR_STATE_ON_CLEANUP` — `false`, so text and backdrop survive hide.                                      |
+| `interface.controller.accept` | Extends `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `INTERFACE.INTERACT`; visible layer → `INTERACT.EMIT`, hidden → `INTERFACE.VISIBLE`; PUSH/POP on VIEW_SHOW/HIDE.                                                       |
+| `interface`                   | STATE.SET / STATE.CLEAR → STATE_CHANGED.                                                                                                                                                                                                  |
+| `interface.scenario`          | `$ interface`: `LINE_EXEC_REG` → SHOW / HIDE / VIEW per `CONST.INTERFACE.EXEC_ACTIONS`.                                                                                                                                                   |
+| `interface.actions`           | VISIBLE / TEXT_HIDE / VIEW through `globalState.interface`.                                                                                                                                                                               |
+| `interface.actions.show`      | Subscribes to `SHOW` and `HIDE`. On `GATE` (`breakFollowing`): if the interface is already in the target state or a show/hide cycle is running, other subscribers on these events are not called. Showing a hidden layer sends `VISIBLE`. |
+| `interface.view`              | `isForce` reaches `SmoothText` in `InterfaceViewDialog`, `InterfaceViewLine`, and `InterfaceViewWall`.                                                                                                                                    |
 
 ## Compatibility
 
 ### `compatibility/views.scenario.interface/text/`
 
-Пакет: `@vnejs/compatibility.views.scenario.interface-with-text`
+Package: `@vnejs/compatibility.views.scenario.interface-with-text`
 
-На `TEXT.CHANGED` эмитит `INTERFACE.TEXT_CHANGED` (`tokensVisible` = длина токенов, если `shared.interfaceTextShowAllTokensOnChange`). На `TEXT.SPEAKER_CHANGED` — `INTERFACE.SPEAKER_CHANGED`. В `postinject` ставит флаг в `true`; в `init` регистрирует `TEXT.EMIT_BEFORE` → `INTERFACE.SHOW`. Подключается в `bundles/vn.skeleton`.
+On `TEXT.CHANGED` emits `INTERFACE.TEXT_CHANGED` (`tokensVisible` = token length when `shared.interfaceTextShowAllTokensOnChange`). On `TEXT.SPEAKER_CHANGED` — `INTERFACE.SPEAKER_CHANGED`. In `postinject` sets the flag to `true`; in `init` registers `TEXT.EMIT_BEFORE` → `INTERFACE.SHOW`. Wired in `bundles/vn.skeleton`.
 
 ### `compatibility/views.scenario.interface/text.smooth/`
 
-Пакет: `@vnejs/compatibility.views.scenario.interface-with-text.smooth`
+Package: `@vnejs/compatibility.views.scenario.interface-with-text.smooth`
 
-На `TEXT_SMOOTH.CHANGED` эмитит `INTERFACE.TEXT_CHANGED` с `tokens` из `globalState.text`, `tokensVisible` и `uid`. В `start` ставит `shared.interfaceTextShowAllTokensOnChange` в `false`.
+On `TEXT_SMOOTH.CHANGED` emits `INTERFACE.TEXT_CHANGED` with `tokens` from `globalState.text`, `tokensVisible`, and `uid`. In `start` sets `shared.interfaceTextShowAllTokensOnChange` to `false`.
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
@@ -86,9 +86,9 @@ Payloads и результаты хендлеров типизированы ч
 - [scenario.md](../core/scenario.md) — `SCENARIO`: EVENTS.NEXT, EVENTS.LINE_EXEC_REG
 - [state.md](../core/state.md) — `STATE`: EVENTS.SET, EVENTS.CLEAR
 
-### Остальные
+### Other
 
 - [controls.md](../controls/controls.md) — `CONTROLS`: EVENTS.POP, EVENTS.PUSH
-- [text.md](../text/text.md) — `TEXT`: связка через compatibility выше (`CHANGED`, `SPEAKER_CHANGED`, `EMIT_BEFORE`)
-- [choose.md](./choose.md) — compatibility скрывает interface на `CHOOSE_VIEW.SHOW` (`LIFECYCLE_PRIORITY.SHOW.BEFORE`)
-- [qte.md](./qte.md) — compatibility скрывает interface на `QTE_VIEW.SHOW` (`LIFECYCLE_PRIORITY.SHOW.BEFORE`)
+- [text.md](../text/text.md) — `TEXT`: link via compatibility above (`CHANGED`, `SPEAKER_CHANGED`, `EMIT_BEFORE`)
+- [choose.md](./choose.md) — compatibility hides interface on `CHOOSE_VIEW.SHOW` (`LIFECYCLE_PRIORITY.SHOW.BEFORE`)
+- [qte.md](./qte.md) — compatibility hides interface on `QTE_VIEW.SHOW` (`LIFECYCLE_PRIORITY.SHOW.BEFORE`)