@vnejs/docs 0.2.64 → 0.2.66

package/plugins/scenario/fastforward.md

@@ -1,65 +1,65 @@
 # plugins/scenario/fastforward/
 
-Пакет: `@vnejs/plugins.scenario.fastforward` · namespace: `FASTFORWARD`
+Package: `@vnejs/plugins.scenario.fastforward` · namespace: `FASTFORWARD`
 
-Включает режим ускоренного просмотра с автокликом и проверкой уже просмотренных сцен.
+Fast-forward mode with auto-click and checks for already-viewed scenes.
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.scenario.fastforward`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.scenario.fastforward`.
 
-| Ключ         | Строка                       | Смысл                                                                                                               |
-| ------------ | ---------------------------- | ------------------------------------------------------------------------------------------------------------------- |
-| `STOP`       | `vne:fastforward:stop`       | Остановить воспроизведение.                                                                                         |
-| `START`      | `vne:fastforward:start`      | Начать процесс.                                                                                                     |
-| `TOGGLE`     | `vne:fastforward:toggle`     | Событие `TOGGLE` namespace плагина.                                                                                 |
-| `EMIT`       | `vne:fastforward:emit`       | Инициировать действие или цикл.                                                                                     |
-| `EMIT_CHECK` | `vne:fastforward:emit_check` | Инициировать действие или цикл.                                                                                     |
-| `CHECK`      | `vne:fastforward:check`      | Проверить состояние или наличие ресурса.                                                                            |
-| `CHANGED`    | `vne:fastforward:changed`    | Зафиксировать изменение состояния.                                                                                  |
-| `VISIT_ADD`  | `vne:fastforward:visit_add`  | Записать визит: `shared.fastforwardStorage` + стейт и `STORAGE.SET`. Payload: `key`, `group`, поля `SCENARIO.EXEC`. |
-| `CLEAR`      | `vne:fastforward:clear`      | Очистить накопленное состояние.                                                                                     |
+| Key          | String                       | Meaning                                                                                                                 |
+| ------------ | ---------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| `STOP`       | `vne:fastforward:stop`       | Stop playback.                                                                                                          |
+| `START`      | `vne:fastforward:start`      | Start the process.                                                                                                      |
+| `TOGGLE`     | `vne:fastforward:toggle`     | Plugin namespace `TOGGLE` event.                                                                                        |
+| `EMIT`       | `vne:fastforward:emit`       | Trigger an action or loop.                                                                                              |
+| `EMIT_CHECK` | `vne:fastforward:emit_check` | Trigger an action or loop.                                                                                              |
+| `CHECK`      | `vne:fastforward:check`      | Check state or resource presence.                                                                                       |
+| `CHANGED`    | `vne:fastforward:changed`    | Record a state change.                                                                                                  |
+| `VISIT_ADD`  | `vne:fastforward:visit_add`  | Record a visit: `shared.fastforwardStorage` + state and `STORAGE.SET`. Payload: `key`, `group`, `SCENARIO.EXEC` fields. |
+| `CLEAR`      | `vne:fastforward:clear`      | Clear accumulated state.                                                                                                |
 
-## Константы
+## Constants
 
-| Ключ     | Смысл                                                  |
-| -------- | ------------------------------------------------------ |
-| `SOURCE` | `"fastforward"` — ключ в SourcesSet соседних плагинов. |
+| Key      | Meaning                                                   |
+| -------- | --------------------------------------------------------- |
+| `SOURCE` | `"fastforward"` — key in neighboring plugins’ SourcesSet. |
 
-## Параметры
+## Parameters
 
-| Ключ                    | Тип       | Смысл                                        |
-| ----------------------- | --------- | -------------------------------------------- |
-| `DEFAULT_CHECK_VISITED` | `boolean` | Значение по умолчанию: true.                 |
-| `DEFAULT_DELAY`         | `number`  | Значение по умолчанию: 50.                   |
-| `DEFAULT_ENABLED`       | `boolean` | Значение по умолчанию для включения функции. |
+| Key                     | Type      | Meaning                                |
+| ----------------------- | --------- | -------------------------------------- |
+| `DEFAULT_CHECK_VISITED` | `boolean` | Default: true.                         |
+| `DEFAULT_DELAY`         | `number`  | Default: 50.                           |
+| `DEFAULT_ENABLED`       | `boolean` | Default for whether the feature is on. |
 
-## Настройки
+## Settings
 
-| Ключ                                              | Тип       | Смысл                                                          |
-| ------------------------------------------------- | --------- | -------------------------------------------------------------- |
-| `CHECK_VISITED` (`vne:fastforward:check_visited`) | `string`  | Настройка `vne:fastforward:check_visited` в `shared.settings`. |
-| `DELAY` (`vne:fastforward:delay`)                 | `number`  | Настройка `vne:fastforward:delay` в `shared.settings`.         |
-| `ENABLED` (`vne:fastforward:enabled`)             | `boolean` | Включить или выключить функцию.                                |
+| Key                                               | Type      | Meaning                                                       |
+| ------------------------------------------------- | --------- | ------------------------------------------------------------- |
+| `CHECK_VISITED` (`vne:fastforward:check_visited`) | `string`  | Setting `vne:fastforward:check_visited` in `shared.settings`. |
+| `DELAY` (`vne:fastforward:delay`)                 | `number`  | Setting `vne:fastforward:delay` in `shared.settings`.         |
+| `ENABLED` (`vne:fastforward:enabled`)             | `boolean` | Turn the feature on or off.                                   |
 
 ## Shared
 
-| Поле                 | Тип           | Смысл                                                                                                                              |
-| -------------------- | ------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
-| `isFastforwardOn`    | `boolean`     | Режим прокрутки включён. В `init` модуля `fastforward` сбрасывается через `setValue(false)`; дальше — `START` / `STOP` / `TOGGLE`. |
-| `fastforwardStorage` | `Set<string>` | Хеши уже просмотренных строк; наполняется из `STORAGE` в `init` модуля `fastforward.storage`.                                      |
+| Field                | Type          | Meaning                                                                                                             |
+| -------------------- | ------------- | ------------------------------------------------------------------------------------------------------------------- |
+| `isFastforwardOn`    | `boolean`     | Fast-forward mode on. In `fastforward` module `init` reset via `setValue(false)`; then `START` / `STOP` / `TOGGLE`. |
+| `fastforwardStorage` | `Set<string>` | Hashes of lines already viewed; filled from `STORAGE` in `fastforward.storage` `init`.                              |
 
-## Модули
+## Modules
 
-| Модуль                 | Зона ответственности                                                                                                                                                                                      |
-| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `fastforward`          | `STOP`, `START`, `CHECK`, `TOGGLE`; `SETTINGS.INIT` DELAY/ENABLED в `setup`; в `init` — `setValue(false)`.                                                                                                |
-| `fastforward.emit`     | Цикл `EMIT` / `EMIT_CHECK`: `CHECK` → `INTERACT.EMIT`; провал `CHECK` → `STOP`.                                                                                                                           |
-| `fastforward.scenario` | `SCENARIO.EXEC` → hash стейта `fastforward.visits` и `VISIT_ADD`.                                                                                                                                         |
-| `fastforward.visits`   | `SETTINGS.INIT` CHECK_VISITED в `setup`; `VISIT_ADD` пишет в `shared.fastforwardStorage` и снимок стейта. `CHECK` читает Set.                                                                             |
-| `fastforward.storage`  | `VISIT_ADD` → `STORAGE.SET` с `module` = `this.name`. `GET_ALL` / `RM_ALL` / `CLEAR`. `group` = label, `key` = hash; при init hash берётся из хвоста ключа. На диске: `fastforward.storage/{label}.json`. |
+| Module                 | Role                                                                                                                                                                                             |
+| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `fastforward`          | `STOP`, `START`, `CHECK`, `TOGGLE`; `SETTINGS.INIT` DELAY/ENABLED in `setup`; in `init` — `setValue(false)`.                                                                                     |
+| `fastforward.emit`     | `EMIT` / `EMIT_CHECK` loop: `CHECK` → `INTERACT.EMIT`; failed `CHECK` → `STOP`.                                                                                                                  |
+| `fastforward.scenario` | `SCENARIO.EXEC` → hash `fastforward.visits` state and `VISIT_ADD`.                                                                                                                               |
+| `fastforward.visits`   | `SETTINGS.INIT` CHECK_VISITED in `setup`; `VISIT_ADD` writes `shared.fastforwardStorage` and state snapshot. `CHECK` reads the Set.                                                              |
+| `fastforward.storage`  | `VISIT_ADD` → `STORAGE.SET` with `module` = `this.name`. `GET_ALL` / `RM_ALL` / `CLEAR`. `group` = label, `key` = hash; on init hash from key tail. On disk: `fastforward.storage/{label}.json`. |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
@@ -69,6 +69,6 @@ Payloads и результаты хендлеров типизированы ч
 - [state.md](../core/state.md) — `STATE`: EVENTS.CLEAR, EVENTS.SET
 - [storage.md](../core/storage.md) — `STORAGE`: EVENTS.GET_ALL, EVENTS.SET, EVENTS.RM_ALL
 
-### Остальные
+### Other
 
-- [choose.md](./choose.md) — `CHOOSE`: связка через `compatibility/scenario.choose/scenario.fastforward` (`OPTION_BEFORE` → `FASTFORWARD.CHECK`)
+- [choose.md](./choose.md) — `CHOOSE`: linked via `compatibility/scenario.choose/scenario.fastforward` (`OPTION_BEFORE` → `FASTFORWARD.CHECK`)

package/plugins/scenario/history.md

@@ -1,67 +1,67 @@
 # plugins/scenario/history/
 
-Пакет: `@vnejs/plugins.scenario.history` · namespace: `HISTORY`
+Package: `@vnejs/plugins.scenario.history` · namespace: `HISTORY`
 
-Журнал снапшотов состояния. `BACK` возвращает на последнюю запись. Экран журнала — [views.screens/history.md](../views.screens/history.md) (`HISTORY_VIEW`), в `bundles/vn.base`. Этот плагин — в `bundles/vn.skeleton`.
+Log of state snapshots. `BACK` returns to the last entry. Log screen — [views.screens/history.md](../views.screens/history.md) (`HISTORY_VIEW`), in `bundles/vn.base`. This plugin is in `bundles/vn.skeleton`.
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.scenario.history`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.scenario.history`.
 
-| Ключ          | Строка                    | Смысл                                                                                                                                                                  |
-| ------------- | ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `GET`         | `vne:history:get`         | Снапшот по `uid` (`MEMORY.GET`). Payload: `{ uid? }`.                                                                                                                  |
-| `SET`         | `vne:history:set`         | Записать снапшот в `MEMORY` модуля `history.memory`. Payload: `{ uid?, value? }`.                                                                                      |
-| `ADD`         | `vne:history:add`         | Снять snapshot `STATE` и добавить запись. Payload: реплика (`label`/`text`/`args`/`speaker`…) или `{ locKey }`. Пока `shared.isHistoryLoadInProcess` — игнорируется.   |
-| `LOAD`        | `vne:history:load`        | Загрузить снапшот в `STATE` и перейти на `state.scenario.label` (`SCENARIO.LABEL_GET`). Payload: `{ uid? }`. На время загрузки ставит `shared.isHistoryLoadInProcess`. |
-| `BACK`        | `vne:history:back`        | `LOAD` последней записи. Пока `shared.isHistoryLoadInProcess` и на пустом журнале ничего не делает.                                                                    |
-| `KEYS`        | `vne:history:keys`        | Ключи модуля `history.memory` в `MEMORY`.                                                                                                                              |
-| `KEYS_UPDATE` | `vne:history:keys_update` | Прогреть ключи: `GET` по каждому `uid` в стейте журнала.                                                                                                               |
+| Key           | String                    | Meaning                                                                                                                                                      |
+| ------------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `GET`         | `vne:history:get`         | Snapshot by `uid` (`MEMORY.GET`). Payload: `{ uid? }`.                                                                                                       |
+| `SET`         | `vne:history:set`         | Write snapshot to `MEMORY` of module `history.memory`. Payload: `{ uid?, value? }`.                                                                          |
+| `ADD`         | `vne:history:add`         | Snapshot `STATE` and add entry. Payload: reply (`label`/`text`/`args`/`speaker`…) or `{ locKey }`. Ignored while `shared.isHistoryLoadInProcess`.            |
+| `LOAD`        | `vne:history:load`        | Load snapshot into `STATE` and go to `state.scenario.label` (`SCENARIO.LABEL_GET`). Payload: `{ uid? }`. Sets `shared.isHistoryLoadInProcess` while loading. |
+| `BACK`        | `vne:history:back`        | `LOAD` last entry. Does nothing while `shared.isHistoryLoadInProcess` or when log is empty.                                                                  |
+| `KEYS`        | `vne:history:keys`        | Keys of module `history.memory` in `MEMORY`.                                                                                                                 |
+| `KEYS_UPDATE` | `vne:history:keys_update` | Warm keys: `GET` each `uid` in log state.                                                                                                                    |
 
-Флаг загрузки — `shared.isHistoryLoadInProcess` (ставит модуль `history.load`; в `postinject` — `false`).
+Load flag — `shared.isHistoryLoadInProcess` (set by module `history.load`; `false` in `postinject`).
 
-## Константы
+## Constants
 
-| Ключ           | Смысл                                                                                                                  |
-| -------------- | ---------------------------------------------------------------------------------------------------------------------- |
-| `LOGS_ACTIONS` | Метки для логов: `ADD` (`add`), `LOAD_START` (`load start`), `LOAD_DELETED` (`load deleted`), `LOAD_END` (`load end`). |
+| Key            | Meaning                                                                                                           |
+| -------------- | ----------------------------------------------------------------------------------------------------------------- |
+| `LOGS_ACTIONS` | Log labels: `ADD` (`add`), `LOAD_START` (`load start`), `LOAD_DELETED` (`load deleted`), `LOAD_END` (`load end`). |
 
-## Параметры
+## Parameters
 
-| Ключ         | Тип      | Смысл                                        |
-| ------------ | -------- | -------------------------------------------- |
-| `MAX_LENGTH` | `number` | Максимум записей. Значение по умолчанию: 50. |
+| Key          | Type     | Meaning                   |
+| ------------ | -------- | ------------------------- |
+| `MAX_LENGTH` | `number` | Max entries. Default: 50. |
 
-## Настройки
+## Settings
 
-Нет.
+None.
 
-## Модули
+## Modules
 
-| Модуль           | Зона ответственности                                                                                                       |
-| ---------------- | -------------------------------------------------------------------------------------------------------------------------- |
-| `history`        | ADD, KEYS_UPDATE. Стейт `{ history }`.                                                                                     |
-| `history.back`   | BACK. Последняя запись — `globalState.history`. Пока `shared.isHistoryLoadInProcess` и на пустом журнале ничего не делает. |
-| `history.load`   | LOAD. На время загрузки ставит `shared.isHistoryLoadInProcess`.                                                            |
-| `history.memory` | `MEMORY.REG` в `setup` (`module: this.name`); GET, SET, KEYS.                                                              |
+| Module           | Role                                                                                                               |
+| ---------------- | ------------------------------------------------------------------------------------------------------------------ |
+| `history`        | ADD, KEYS_UPDATE. State `{ history }`.                                                                             |
+| `history.back`   | BACK. Last entry — `globalState.history`. Does nothing while `shared.isHistoryLoadInProcess` or when log is empty. |
+| `history.load`   | LOAD. Sets `shared.isHistoryLoadInProcess` while loading.                                                          |
+| `history.memory` | `MEMORY.REG` in `setup` (`module: this.name`); GET, SET, KEYS.                                                     |
 
-Стейт журнала — у модуля `history` (`globalState.history`). Снапшоты в `MEMORY` лежат под именем модуля `history.memory`.
+Log state belongs to module `history` (`globalState.history`). Snapshots in `MEMORY` use module name `history.memory`.
 
 ## Compatibility
 
 ### `compatibility/text/scenario.history/`
 
-Пакет: `@vnejs/compatibility.text-with-scenario.history`
+Package: `@vnejs/compatibility.text-with-scenario.history`
 
-На `TEXT.EMIT_NEXT` эмитит `HISTORY.ADD` с `{ label, text, args, speaker, speakerInfo }`. Маркеры `{…}` из текста снимаются. Подключается в `bundles/vn.skeleton`.
+On `TEXT.EMIT_NEXT` emits `HISTORY.ADD` with `{ label, text, args, speaker, speakerInfo }`. `text` — scenario line as-is, including `{…}` markers: that is the localization key. Wired in `bundles/vn.skeleton`.
 
 ### `compatibility/scenario.choose/scenario.history/`
 
-Пакет: `@vnejs/compatibility.scenario.choose-with-scenario.history`
+Package: `@vnejs/compatibility.scenario.choose-with-scenario.history`
 
-На `CHOOSE.OPTION_BEFORE` эмитит `HISTORY.ADD` с `{ locKey: "choice" }`. Перевод строки — ключ `choice` в `history.json` экрана. Подключается в `bundles/vn.skeleton`.
+On `CHOOSE.OPTION_BEFORE` emits `HISTORY.ADD` with `{ locKey: "choice" }`. Line translation — key `choice` in the screen `history.json`. Wired in `bundles/vn.skeleton`.
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
@@ -70,8 +70,8 @@ Payloads и результаты хендлеров типизированы ч
 - [scenario.md](../core/scenario.md) — `SCENARIO`: EVENTS.LABEL_GET
 - [state.md](../core/state.md) — `STATE`: EVENTS.SET, EVENTS.CLEAR, EVENTS.GET, EVENTS.LOAD
 
-### Остальные
+### Other
 
-- [text.md](../text/text.md) — `TEXT`: `EMIT_NEXT` → `ADD` (compatibility выше)
-- [choose.md](./choose.md) — `CHOOSE`: `OPTION_BEFORE` → `ADD` (compatibility выше)
-- [views.screens/history.md](../views.screens/history.md) — `HISTORY_VIEW`: экран журнала (`SHOW` / `HIDE`); читает `GET` / `KEYS` / `LOAD`
+- [text.md](../text/text.md) — `TEXT`: `EMIT_NEXT` → `ADD` (compatibility above)
+- [choose.md](./choose.md) — `CHOOSE`: `OPTION_BEFORE` → `ADD` (compatibility above)
+- [views.screens/history.md](../views.screens/history.md) — `HISTORY_VIEW`: log screen (`SHOW` / `HIDE`); reads `GET` / `KEYS` / `LOAD`

package/plugins/scenario/pause.md

@@ -1,43 +1,43 @@
 # plugins/scenario/pause/
 
-Пакет: `@vnejs/plugins.scenario.pause` · namespace: `PAUSE`
+Package: `@vnejs/plugins.scenario.pause` · namespace: `PAUSE`
 
-Ставит сценарий на паузу до клика игрока или на заданное время через exec-команду.
+Pause the scenario until the player clicks or for a given time via an exec command.
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.scenario.pause`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.scenario.pause`.
 
-| Ключ    | Строка            | Смысл                                                                                          |
-| ------- | ----------------- | ---------------------------------------------------------------------------------------------- |
-| `EMIT`  | `vne:pause:emit`  | Если `shared.pauseDisableSources` пуст — `START` с `{ time? }`. Иначе ничего.                  |
-| `START` | `vne:pause:start` | Ждать клик (`INTERACT.PUSH`, ключ `pause`) или `time` мс, пока не `END`. Payload: `{ time? }`. |
-| `END`   | `vne:pause:end`   | Снять таймер, `INTERACT.POP`, завершить ожидание `START`.                                      |
+| Key     | String            | Meaning                                                                                       |
+| ------- | ----------------- | --------------------------------------------------------------------------------------------- |
+| `EMIT`  | `vne:pause:emit`  | When `shared.pauseDisableSources` is empty — `START` with `{ time? }`. Else nothing.          |
+| `START` | `vne:pause:start` | Wait for click (`INTERACT.PUSH`, key `pause`) or `time` ms until `END`. Payload: `{ time? }`. |
+| `END`   | `vne:pause:end`   | Clear timer, `INTERACT.POP`, finish `START` wait.                                             |
 
-## Константы
+## Constants
 
-| Ключ           | Смысл                                                                                    |
-| -------------- | ---------------------------------------------------------------------------------------- |
-| `LOGS_ACTIONS` | Метки для логов: `EMIT` (`emit`), `START` (`start`), `END` (`end`). `EMIT` пишет `time`. |
+| Key            | Meaning                                                                            |
+| -------------- | ---------------------------------------------------------------------------------- |
+| `LOGS_ACTIONS` | Log labels: `EMIT` (`emit`), `START` (`start`), `END` (`end`). `EMIT` logs `time`. |
 
-## Параметры
+## Parameters
 
-Нет.
+None.
 
-## Настройки
+## Settings
 
-Нет.
+None.
 
-## Модули
+## Modules
 
-| Модуль           | Зона ответственности                                                                    |
-| ---------------- | --------------------------------------------------------------------------------------- |
-| `pause`          | `START` ждёт `END`: клик (`INTERACT`) или таймер `time`.                                |
-| `pause.emit`     | В `postinject` — `shared.pauseDisableSources`. `EMIT` → `START`, если набор пуст.       |
-| `pause.logs`     | Логи `EMIT` / `START` / `END` через `EVENTS.LOGS.EMIT`. `EMIT` пишет `time`.                     |
-| `pause.scenario` | `LINE_EXEC_REG` для `$ pause` в `init`. Парсит `time`, эмитит `EMIT`, затем `emit SCENARIO.NEXT`. |
+| Module           | Role                                                                                           |
+| ---------------- | ---------------------------------------------------------------------------------------------- |
+| `pause`          | `START` waits for `END`: click (`INTERACT`) or timer `time`.                                   |
+| `pause.emit`     | In `postinject` — `shared.pauseDisableSources`. `EMIT` → `START` when set is empty.            |
+| `pause.logs`     | Log `EMIT` / `START` / `END` via `EVENTS.LOGS.EMIT`. `EMIT` logs `time`.                       |
+| `pause.scenario` | `LINE_EXEC_REG` for `$ pause` in `init`. Parse `time`, emit `EMIT`, then `emit SCENARIO.NEXT`. |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
@@ -45,6 +45,6 @@ Payloads и результаты хендлеров типизированы ч
 - [logs.md](../core/logs.md) — `LOGS`: `EVENTS.LOGS.EMIT` (`action`, …), `CONST.LOGS.FILTER_FROM_RESULT_OPTIONS`
 - [scenario.md](../core/scenario.md) — `SCENARIO`: EVENTS.NEXT, EVENTS.LINE_EXEC_REG
 
-### Остальные
+### Other
 
-— нет
+— None

package/plugins/scenario/point_and_click.md

@@ -1,18 +1,18 @@
 # plugins/scenario/point_and_click/
 
-Пакет: `@vnejs/plugins.scenario.point_and_click` · namespace: `POINT_AND_CLICK`
+Package: `@vnejs/plugins.scenario.point_and_click` · namespace: `POINT_AND_CLICK`
 
-Обрабатывает сценарные команды `% point-and-click` / `$ point-and-click`, собирает hotspot-опции, хранит состояние в `globalState.point_and_click` и переводит сценарий к выбранной ветке. UI не рендерит — за отображение отвечает [views.scenario/point_and_click.md](../views.scenario/point_and_click.md).
+Handles scenario commands `% point-and-click` / `$ point-and-click`, collects hotspot options, stores state in `globalState.point_and_click`, and moves the scenario to the picked branch. Does not render UI — see [views.scenario/point_and_click.md](../views.scenario/point_and_click.md).
 
-## Сценарные команды
+## Scenario commands
 
-| Синтаксис                                         | Смысл                                                                                                                                          |
-| ------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
-| `% point-and-click`                               | Открыть point-and-click: собрать `% point-and-click.option`, emit `EMIT`. Если все опции `hided` (или список пуст) — `SKIP` и переход за блок. |
-| `% point-and-click.option {icon} {iconHover} x y` | Hotspot; при проходе мимо невыбранного — skip тела по indent. Опционально args `imgWidth` / `imgHeight` (px canvas).                           |
-| `$ point-and-click repeat`                        | Вернуться к ближайшему `% point-and-click` **выше** текущей строки в том же label и `emit SCENARIO.NEXT`.                                      |
+| Syntax                                            | Meaning                                                                                                                                          |
+| ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `% point-and-click`                               | Open point-and-click: collect `% point-and-click.option`, emit `EMIT`. When all options are `hided` (or list empty) — `SKIP` and exit the block. |
+| `% point-and-click.option {icon} {iconHover} x y` | Hotspot; when passing a non-chosen option — skip body by indent. Optional args `imgWidth` / `imgHeight` (canvas px).                             |
+| `$ point-and-click repeat`                        | Return to the nearest `% point-and-click` **above** the current line in the same label and `emit SCENARIO.NEXT`.                                 |
 
-Пример цикла осмотра:
+Example look-around loop:
 
 ```vne
 % point-and-click
@@ -23,68 +23,68 @@
     $ flag prologue_2_pac_1
     "…"
     $ point-and-click repeat
-# дальше — когда при повторном входе все option скрыты
+# later — when on re-entry all options are hidden
 ```
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.scenario.point_and_click`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.scenario.point_and_click`.
 
-| Ключ           | Строка                             | Смысл                                                                                                      |
-| -------------- | ---------------------------------- | ---------------------------------------------------------------------------------------------------------- |
-| `EMIT`         | `vne:point_and_click:emit`         | Принять опции и args; если есть видимые — `STATE_UPDATE` и `SHOW`; иначе `SKIP`.                           |
-| `OPTION`       | `vne:point_and_click:option`       | Выбор hotspot: `HIDE`, `curLine` внутрь опции, сброс state через `STATE_UPDATE`, `emit SCENARIO.NEXT`.     |
-| `SKIP`         | `vne:point_and_click:skip`         | Пропустить блок: `curLine` на первую строку после indent-дерева `% point-and-click`, `emit SCENARIO.NEXT`. |
-| `SHOW`         | `vne:point_and_click:show`         | Выбор активен (state готов). Слушает view-плагин.                                                          |
-| `HIDE`         | `vne:point_and_click:hide`         | Выбор закрыт. Слушает view-плагин.                                                                         |
-| `EXEC_REG`     | `vne:point_and_click:exec_reg`     | Зарегистрировать exec-обработчик для подстановки в опции.                                                  |
-| `EXEC_GET`     | `vne:point_and_click:exec_get`     | Получить значение через зарегистрированный exec-обработчик (например `hided:` / `disabled:`).              |
-| `STATE_UPDATE` | `vne:point_and_click:state_update` | Обновить накопленное состояние модуля `point_and_click`.                                                   |
+| Key            | String                             | Meaning                                                                                            |
+| -------------- | ---------------------------------- | -------------------------------------------------------------------------------------------------- |
+| `EMIT`         | `vne:point_and_click:emit`         | Accept options and args; when any are visible — `STATE_UPDATE` and `SHOW`; else `SKIP`.            |
+| `OPTION`       | `vne:point_and_click:option`       | Hotspot pick: `HIDE`, `curLine` into option, reset state via `STATE_UPDATE`, `emit SCENARIO.NEXT`. |
+| `SKIP`         | `vne:point_and_click:skip`         | Skip block: `curLine` to first line after `% point-and-click` indent tree, `emit SCENARIO.NEXT`.   |
+| `SHOW`         | `vne:point_and_click:show`         | Choice active (state ready). View plugin listens.                                                  |
+| `HIDE`         | `vne:point_and_click:hide`         | Choice closed. View plugin listens.                                                                |
+| `EXEC_REG`     | `vne:point_and_click:exec_reg`     | Register exec handler for substitution in options.                                                 |
+| `EXEC_GET`     | `vne:point_and_click:exec_get`     | Get a value via a registered exec handler (e.g. `hided:` / `disabled:`).                           |
+| `STATE_UPDATE` | `vne:point_and_click:state_update` | Update accumulated `point_and_click` module state.                                                 |
 
-## Константы
+## Constants
 
-| Ключ                  | Смысл                                                                |
-| --------------------- | -------------------------------------------------------------------- |
-| `EXEC_ACTIONS.REPEAT` | Литерал `repeat` для `$ point-and-click repeat`.                     |
-| `LOGS_ACTIONS`        | Метки для логов: `EMIT`, `OPTION`, `SKIP`, `SHOW`, `HIDE`, `REPEAT`. |
+| Key                   | Meaning                                                         |
+| --------------------- | --------------------------------------------------------------- |
+| `EXEC_ACTIONS.REPEAT` | Literal `repeat` for `$ point-and-click repeat`.                |
+| `LOGS_ACTIONS`        | Log labels: `EMIT`, `OPTION`, `SKIP`, `SHOW`, `HIDE`, `REPEAT`. |
 
-## Параметры
+## Parameters
 
-Нет.
+None.
 
-## Настройки
+## Settings
 
-Нет.
+None.
 
-## Модули
+## Modules
 
-| Модуль                            | Зона ответственности                                                                     |
-| --------------------------------- | ---------------------------------------------------------------------------------------- |
-| `point_and_click`                 | State: `STATE_UPDATE`, синхронизация с `STATE.SET` / `STATE.CLEAR` (→ `SHOW` / `HIDE`).  |
-| `point_and_click.emit`            | Обрабатывает `EMIT` (→ `STATE_UPDATE` + `SHOW` или `SKIP`).                              |
-| `point_and_click.option`          | Обрабатывает `OPTION`.                                                                   |
-| `point_and_click.skip`            | Обрабатывает `SKIP` через `getBlockSkipShift`.                                           |
-| `point_and_click.logs`            | Логирование `EMIT` / `OPTION` / `SKIP` / `SHOW` / `HIDE`.                                |
-| `point_and_click.exec`            | Реестр обработчиков EXEC_REG / EXEC_GET.                                                 |
-| `point_and_click.scenario`        | Регистрация `% point-and-click`: сбор option-строк через `getBlockOptions`, emit `EMIT`. |
-| `point_and_click.scenario.option` | Регистрация `% point-and-click.option`: skip невыбранных веток.                          |
-| `point_and_click.scenario.module` | Регистрация `$ point-and-click`: action `repeat`.                                        |
+| Module                            | Role                                                                                   |
+| --------------------------------- | -------------------------------------------------------------------------------------- |
+| `point_and_click`                 | State: `STATE_UPDATE`, sync with `STATE.SET` / `STATE.CLEAR` (→ `SHOW` / `HIDE`).      |
+| `point_and_click.emit`            | Handles `EMIT` (→ `STATE_UPDATE` + `SHOW` or `SKIP`).                                  |
+| `point_and_click.option`          | Handles `OPTION`.                                                                      |
+| `point_and_click.skip`            | Handles `SKIP` via `getBlockSkipShift`.                                                |
+| `point_and_click.logs`            | Log `EMIT` / `OPTION` / `SKIP` / `SHOW` / `HIDE`.                                      |
+| `point_and_click.exec`            | Registry for EXEC_REG / EXEC_GET handlers.                                             |
+| `point_and_click.scenario`        | Register `% point-and-click`: collect option lines via `getBlockOptions`, emit `EMIT`. |
+| `point_and_click.scenario.option` | Register `% point-and-click.option`: skip unchosen branches.                           |
+| `point_and_click.scenario.module` | Register `$ point-and-click`: action `repeat`.                                         |
 
 ## Compatibility
 
 ### `compatibility/scenario.point_and_click/vars.flags/`
 
-Пакет: `@vnejs/compatibility.scenario.point_and_click-with-vars.flags`
+Package: `@vnejs/compatibility.scenario.point_and_click-with-vars.flags`
 
-В `init` регистрирует handler на `EXEC_REG` для модуля flags → `VARS_FLAGS.EXEC_CHECK`.
+In `init` registers handler on `EXEC_REG` for flags module → `VARS_FLAGS.EXEC_CHECK`.
 
 ### `compatibility/scenario.point_and_click/vars.counters/`
 
-Пакет: `@vnejs/compatibility.scenario.point_and_click-with-vars.counters`
+Package: `@vnejs/compatibility.scenario.point_and_click-with-vars.counters`
 
-В `init` регистрирует handler на `EXEC_REG` для модуля counters → `VARS_COUNTERS.EXEC_CHECK`.
+In `init` registers handler on `EXEC_REG` for counters module → `VARS_COUNTERS.EXEC_CHECK`.
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
@@ -92,7 +92,7 @@ Payloads и результаты хендлеров типизированы ч
 - [scenario.md](../core/scenario.md) — `SCENARIO`: EVENTS.NEXT, EVENTS.LINE_EXEC_REG, EVENTS.LINES_GET
 - [state.md](../core/state.md) — `STATE`: EVENTS.SET, EVENTS.CLEAR
 
-### Остальные
+### Other
 
-- [scenario/choose.md](./choose.md) — тот же паттерн `repeat` / `SKIP` / `SHOW` / `HIDE` / `STATE_UPDATE` для текстового выбора
-- [views.scenario/point_and_click.md](../views.scenario/point_and_click.md) — `POINT_AND_CLICK_VIEW`: UI hotspots
+- [scenario/choose.md](./choose.md) — same `repeat` / `SKIP` / `SHOW` / `HIDE` / `STATE_UPDATE` pattern for text choice
+- [views.scenario/point_and_click.md](../views.scenario/point_and_click.md) — `POINT_AND_CLICK_VIEW`: hotspot UI