@vnejs/docs 0.2.46 → 0.2.48

package/plugins/save/continue.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.save.continue`.
+
 | Ключ      | Строка                      | Смысл                                |
 | --------- | --------------------------- | ------------------------------------ |
 | `MAKE`    | `vne:save_continue:make`    | Событие `MAKE` namespace плагина.    |

package/plugins/save/quick.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.save.quick`.
+
 | Ключ      | Строка                   | Смысл                                |
 | --------- | ------------------------ | ------------------------------------ |
 | `MAKE`    | `vne:save_quick:make`    | Событие `MAKE` namespace плагина.    |

package/plugins/save/save.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.save`.
+
 | Ключ         | Строка                | Смысл                                              |
 | ------------ | --------------------- | -------------------------------------------------- |
 | `GET`        | `vne:save:get`        | Прочитать слот (`{ key, group? }`) из `STORAGE`.   |

package/plugins/scales/scales.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.scales`.
+
 | Ключ        | Строка                 | Смысл                                    |
 | ----------- | ---------------------- | ---------------------------------------- |
 | `SPAWN`     | `vne:scales:spawn`     | Событие `SPAWN` namespace плагина.       |

package/plugins/scenario/autoread.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.scenario.autoread`.
+
 | Ключ             | Строка                        | Смысл                                                                                                        |
 | ---------------- | ----------------------------- | ------------------------------------------------------------------------------------------------------------ |
 | `EMIT`           | `vne:autoread:emit`           | Если авточтение включено и нет блокировок — `INTERACT.EMIT` по `vne-autoread-allow`, иначе `TIMEOUT_CREATE`. |

package/plugins/scenario/choose.md

@@ -26,6 +26,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.scenario.choose`.
+
 | Ключ                 | Строка                          | Смысл                                                                                                                                 |
 | -------------------- | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
 | `EMIT`               | `vne:choose:emit`               | Принять опции и args; если есть видимые — `STATE_UPDATE` и `SHOW`; иначе `SKIP`.                                                      |

package/plugins/scenario/fastforward.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.scenario.fastforward`.
+
 | Ключ         | Строка                       | Смысл                                                                                                               |
 | ------------ | ---------------------------- | ------------------------------------------------------------------------------------------------------------------- |
 | `STOP`       | `vne:fastforward:stop`       | Остановить воспроизведение.                                                                                         |

package/plugins/scenario/history.md

@@ -6,28 +6,30 @@
 
 ## События
 
-| Ключ   | Строка             | Смысл                                                                                                      |
-| ------ | ------------------ | ---------------------------------------------------------------------------------------------------------- |
-| `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` — игнорируется. |
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@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` в стейте журнала.                                                                                                          |
+| `BACK`        | `vne:history:back`        | `LOAD` последней записи. Пока `shared.isHistoryLoadInProcess` и на пустом журнале ничего не делает.                                                                    |
+| `KEYS`        | `vne:history:keys`        | Ключи модуля `history.memory` в `MEMORY`.                                                                                                                              |
+| `KEYS_UPDATE` | `vne:history:keys_update` | Прогреть ключи: `GET` по каждому `uid` в стейте журнала.                                                                                                               |
 
 Флаг загрузки — `shared.isHistoryLoadInProcess` (ставит модуль `history.load`; в `postinject` — `false`).
 
 ## Константы
 
-| Ключ           | Смысл                                                                                          |
-| -------------- | ---------------------------------------------------------------------------------------------- |
+| Ключ           | Смысл                                                                                                                  |
+| -------------- | ---------------------------------------------------------------------------------------------------------------------- |
 | `LOGS_ACTIONS` | Метки для логов: `ADD` (`add`), `LOAD_START` (`load start`), `LOAD_DELETED` (`load deleted`), `LOAD_END` (`load end`). |
 
 ## Параметры
 
-| Ключ         | Тип      | Смысл                                      |
-| ------------ | -------- | ------------------------------------------ |
+| Ключ         | Тип      | Смысл                                        |
+| ------------ | -------- | -------------------------------------------- |
 | `MAX_LENGTH` | `number` | Максимум записей. Значение по умолчанию: 50. |
 
 ## Настройки
@@ -36,12 +38,12 @@
 
 ## Модули
 
-| Модуль           | Зона ответственности                                                                 |
-| ---------------- | ------------------------------------------------------------------------------------ |
-| `history`        | ADD, KEYS_UPDATE. Стейт `{ history }`.                                                     |
+| Модуль           | Зона ответственности                                                                                                       |
+| ---------------- | -------------------------------------------------------------------------------------------------------------------------- |
+| `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.                            |
+| `history.load`   | LOAD. На время загрузки ставит `shared.isHistoryLoadInProcess`.                                                            |
+| `history.memory` | `MEMORY.REG` в `setup` (`module: this.name`); GET, SET, KEYS.                                                              |
 
 Стейт журнала — у модуля `history` (`globalState.history`). Снапшоты в `MEMORY` лежат под именем модуля `history.memory`.
 

package/plugins/scenario/pause.md

@@ -6,8 +6,10 @@
 
 ## События
 
-| Ключ    | Строка            | Смысл                                                                                           |
-| ------- | ----------------- | ----------------------------------------------------------------------------------------------- |
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@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`.                                      |
@@ -28,12 +30,12 @@
 
 ## Модули
 
-| Модуль           | Зона ответственности                                                                                      |
-| ---------------- | --------------------------------------------------------------------------------------------------------- |
-| `pause`          | `START` ждёт `END`: клик (`INTERACT`) или таймер `time`.                                                 |
-| `pause.emit`     | В `postinject` — `shared.pauseDisableSources`. `EMIT` → `START`, если набор пуст.                        |
-| `pause.logs`     | Логи `EMIT` / `START` / `END` через `emitLog`. `EMIT` пишет `time`.                                       |
-| `pause.scenario` | `LINE_EXEC_REG` для `$ pause` в `init`. Парсит `time`, эмитит `EMIT`, затем `emitNext`.                  |
+| Модуль           | Зона ответственности                                                                    |
+| ---------------- | --------------------------------------------------------------------------------------- |
+| `pause`          | `START` ждёт `END`: клик (`INTERACT`) или таймер `time`.                                |
+| `pause.emit`     | В `postinject` — `shared.pauseDisableSources`. `EMIT` → `START`, если набор пуст.       |
+| `pause.logs`     | Логи `EMIT` / `START` / `END` через `emitLog`. `EMIT` пишет `time`.                     |
+| `pause.scenario` | `LINE_EXEC_REG` для `$ pause` в `init`. Парсит `time`, эмитит `EMIT`, затем `emitNext`. |
 
 ## Близкие плагины
 

package/plugins/scenario/point_and_click.md

@@ -28,6 +28,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.scenario.point_and_click`.
+
 | Ключ           | Строка                             | Смысл                                                                                            |
 | -------------- | ---------------------------------- | ------------------------------------------------------------------------------------------------ |
 | `EMIT`         | `vne:point_and_click:emit`         | Принять опции и args; если есть видимые — `STATE_UPDATE` и `SHOW`; иначе `SKIP`.                 |

package/plugins/scenario/qte.md

@@ -8,6 +8,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.scenario.qte`.
+
 | Ключ     | Строка           | Смысл                                                                                            |
 | -------- | ---------------- | ------------------------------------------------------------------------------------------------ |
 | `EMIT`   | `vne:qte:emit`   | Запустить QTE: принять `id` / `item` / `skipScenario`, эмитить `OPENED`.                         |

package/plugins/settings/potato.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.settings.potato`.
+
 | Ключ   | Строка            | Смысл                           |
 | ------ | ----------------- | ------------------------------- |
 | `EMIT` | `vne:potato:emit` | Инициировать действие или цикл. |

package/plugins/text/inject.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.text.inject`.
+
 | Ключ   | Строка                 | Смысл                                        |
 | ------ | ---------------------- | -------------------------------------------- |
 | `REG`  | `vne:text_inject:reg`  | Зарегистрировать обработчик по имени модуля. |

package/plugins/text/locs.md

@@ -8,6 +8,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.text.locs`.
+
 | Ключ         | Строка                | Смысл                                                                                                                                                                |
 | ------------ | --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `LOAD`       | `vne:locs:load`       | Запросить данные у обработчиков и продолжить цепочку. Payload: `{ label, group, lang? }`. Без `group` файл не грузится.                                              |

package/plugins/text/meet.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.text.meet`.
+
 | Ключ   | Строка               | Смысл                                     |
 | ------ | -------------------- | ----------------------------------------- |
 | `MEET` | `vne:text_meet:meet` | Записать диагностическое сообщение в лог. |

package/plugins/text/smooth.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.text.smooth`.
+
 | Ключ      | Строка                    | Смысл                               |
 | --------- | ------------------------- | ----------------------------------- |
 | `SMOOTH`  | `vne:text:smooth`         | Событие `SMOOTH` namespace плагина. |

package/plugins/text/text.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.text`.
+
 | Ключ                  | Строка                         | Смысл                                                               |
 | --------------------- | ------------------------------ | ------------------------------------------------------------------- |
 | `EMIT`                | `vne:text:emit`                | Начать вывод: подготовка токенов, обновление state, запуск process. |

package/plugins/text/wall.md

@@ -6,9 +6,12 @@
 
 ## События
 
-| Ключ      | Строка                  | Смысл                              |
-| --------- | ----------------------- | ---------------------------------- |
-| `CHANGED` | `vne:text_wall:changed` | Зафиксировать изменение состояния. |
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.text.wall`.
+
+| Ключ           | Строка                       | Смысл                              |
+| -------------- | ---------------------------- | ---------------------------------- |
+| `STATE_UPDATE` | `vne:text_wall:state_update` | Обновить накопленное состояние.    |
+| `CHANGED`      | `vne:text_wall:changed`      | Зафиксировать изменение состояния. |
 
 ## Константы
 

package/plugins/time/date.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.time.date`.
+
 | Ключ      | Строка             | Смысл                              |
 | --------- | ------------------ | ---------------------------------- |
 | `SET`     | `vne:date:set`     | Записать или обновить значение.    |

package/plugins/time/time.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.time.time`.
+
 | Ключ       | Строка              | Смысл                                 |
 | ---------- | ------------------- | ------------------------------------- |
 | `SET`      | `vne:time:set`      | Записать или обновить значение.       |

package/plugins/vars/counters.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.vars.counters`.
+
 | Ключ         | Строка                        | Смысл                                                 |
 | ------------ | ----------------------------- | ----------------------------------------------------- |
 | `SET`        | `vne:vars_counter:set`        | Записать или обновить значение.                       |
@@ -30,12 +32,12 @@
 
 ## Модули
 
-| Модуль                   | Зона ответственности                                         |
-| ------------------------ | ------------------------------------------------------------ |
-| `vars.counters`          | Обрабатывает SET, GET; регистрирует DEFAULT_REG.             |
-| `vars.counters.handlers` | Обрабатывает CHANGE, COMPARE.                                |
-| `vars.counters.exec`     | Обрабатывает EXEC_INFO, EXEC_CHECK, EXEC_GET.                |
-| `vars.counters.scenario` | Регистрирует LINE_EXEC для module/block (`$/% counter`).     |
+| Модуль                   | Зона ответственности                                     |
+| ------------------------ | -------------------------------------------------------- |
+| `vars.counters`          | Обрабатывает SET, GET; регистрирует DEFAULT_REG.         |
+| `vars.counters.handlers` | Обрабатывает CHANGE, COMPARE.                            |
+| `vars.counters.exec`     | Обрабатывает EXEC_INFO, EXEC_CHECK, EXEC_GET.            |
+| `vars.counters.scenario` | Регистрирует LINE_EXEC для module/block (`$/% counter`). |
 
 ## Близкие плагины
 

package/plugins/vars/flags.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.vars.flags`.
+
 | Ключ         | Строка                      | Смысл                                                 |
 | ------------ | --------------------------- | ----------------------------------------------------- |
 | `SET`        | `vne:vars_flags:set`        | Записать или обновить значение.                       |

package/plugins/vars/vars.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.vars`.
+
 | Ключ           | Строка                  | Смысл                                                 |
 | -------------- | ----------------------- | ----------------------------------------------------- |
 | `GET`          | `vne:vars:get`          | Запросить данные у обработчиков и продолжить цепочку. |

package/plugins/views/achievement.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.achievement`.
+
 | Ключ       | Строка                     | Смысл                                                 |
 | ---------- | -------------------------- | ----------------------------------------------------- |
 | `CLEAR`    | `vne:achievement:clear`    | Очистить накопленное состояние.                       |

package/plugins/views/comment.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.comment`.
+
 | Ключ     | Строка               | Смысл                               |
 | -------- | -------------------- | ----------------------------------- |
 | `SHOW`   | `vne:comment:show`   | Показать UI или слой.               |

package/plugins/views/controls.hints.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.controls.hints`.
+
 | Ключ     | Строка                      | Смысл                               |
 | -------- | --------------------------- | ----------------------------------- |
 | `UPDATE` | `vne:controls_hints:update` | Обновить состояние или отображение. |
@@ -36,10 +38,10 @@
 
 ## Модули
 
-| Модуль                      | Зона ответственности                                                                                                                       |
-| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
+| Модуль                      | Зона ответственности                                                                                                                |
+| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
 | `controls.hints.controller` | Preload иконок в `start` и на `MEMORY.CLEARED`; show/hide групп; `DEVICE_CHANGED`; `COMPONENTS.EXTERNAL_UPDATE` → `updateViewFast`. |
-| `controls.hints.view`       | Рендер нескольких `View` + `Flex` + `Icon` + `Text`.                                                                                       |
+| `controls.hints.view`       | Рендер нескольких `View` + `Flex` + `Icon` + `Text`.                                                                                |
 
 ## Близкие плагины
 

package/plugins/views/fps.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.fps`.
+
 | Ключ     | Строка           | Смысл                               |
 | -------- | ---------------- | ----------------------------------- |
 | `SHOW`   | `vne:fps:show`   | Показать UI или слой.               |

package/plugins/views/gamepad.debug.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.gamepad.debug`.
+
 | Ключ     | Строка                     | Смысл                 |
 | -------- | -------------------------- | --------------------- |
 | `SHOW`   | `vne:gamepad.debug:show`   | Показать UI.          |

package/plugins/views/settings.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.settings`.
+
 | Ключ           | Строка                           | Смысл                                                                                                                                     |
 | -------------- | -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
 | `SHOW`         | `vne:settings_view:show`         | Показать слой; payload `{ tab, tabKey?, tabs?, locs?, isForce? }`. Поля из `tab`; при `tabs` все вкладки монтируются сразу для crossfade. |

package/plugins/views/video.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.video`.
+
 | Ключ      | Строка              | Смысл                                                 |
 | --------- | ------------------- | ----------------------------------------------------- |
 | `SET`     | `vne:video:set`     | Запросить данные у обработчиков и продолжить цепочку. |

package/plugins/views.scenario/choose.md

@@ -6,6 +6,8 @@ React-UI выбора из текстовых опций. Зависит от sc
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.scenario.choose`.
+
 | Ключ           | Строка                         | Смысл                                                                  |
 | -------------- | ------------------------------ | ---------------------------------------------------------------------- |
 | `SHOW`         | `vne:choose_view:show`         | Показать UI выбора.                                                    |

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

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.scenario.interface.controls`.
+
 | Ключ     | Строка                          | Смысл                               |
 | -------- | ------------------------------- | ----------------------------------- |
 | `SHOW`   | `vne:interface_controls:show`   | Показать UI или слой.               |

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

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.scenario.interface.fastforward`.
+
 | Ключ                | Строка                                        | Смысл                                          |
 | ------------------- | --------------------------------------------- | ---------------------------------------------- |
 | `SHOW`              | `vne:interface_fastforward:show`              | Показать UI или слой.                          |

package/plugins/views.scenario/interface.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.scenario.interface`.
+
 | Ключ              | Строка                          | Смысл                                       |
 | ----------------- | ------------------------------- | ------------------------------------------- |
 | `SHOW`            | `vne:interface:show`            | Показать UI или слой.                       |

package/plugins/views.scenario/point_and_click.md

@@ -6,6 +6,8 @@ React-UI point-and-click (иконки-hotspot). Зависит от scenario-п
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.scenario.point_and_click`.
+
 | Ключ          | Строка                                 | Смысл                                                  |
 | ------------- | -------------------------------------- | ------------------------------------------------------ |
 | `SHOW`        | `vne:point_and_click_view:show`        | Показать UI.                                           |

package/plugins/views.scenario/qte.md

@@ -8,6 +8,8 @@ React-UI Quick Time Event: фазы анимации, зона успеха в
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.scenario.qte`.
+
 | Ключ          | Строка                     | Смысл                                                       |
 | ------------- | -------------------------- | ----------------------------------------------------------- |
 | `SHOW`        | `vne:qte_view:show`        | Показать UI QTE.                                            |
@@ -41,11 +43,11 @@ React-UI Quick Time Event: фазы анимации, зона успеха в
 
 ## Модули
 
-| Модуль                | Зона ответственности                                                                                                                                    |
-| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Модуль                       | Зона ответственности                                                                                                                                         |
+| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | `qte_view.controller`        | Bridge `QTE.OPENED/CLOSED` → `SHOW/HIDE`; фазы `initial → intro → active → resolved → outro`; таймер fail; пустой `controls` на `ZINDEX`; emit `QTE.RESULT`. |
 | `qte_view.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `QTE_VIEW.ACTION`; PUSH/POP на SHOW/HIDE.                                               |
-| `qte_view.view`              | React-render круга / зоны / указателя; `LOC_LABEL` для статусов.                                                                                            |
+| `qte_view.view`              | React-render круга / зоны / указателя; `LOC_LABEL` для статусов.                                                                                             |
 
 ## Фазы
 

package/plugins/views.screens/checkers.md

@@ -8,6 +8,8 @@ Bridge: `CHECKERS.SHOW/HIDE` → `CHECKERS_VIEW.SHOW/HIDE`. Модель дос
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.screens.checkers`.
+
 | Ключ                     | Строка                               | Смысл                                                                    |
 | ------------------------ | ------------------------------------ | ------------------------------------------------------------------------ |
 | `SHOW` / `HIDE`          | `vne:checkers_view:show` / `…:hide`  | Показ / скрытие экрана.                                                  |

package/plugins/views.screens/confirm.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.screens.confirm`.
+
 | Ключ           | Строка                     | Смысл                                                                                           |
 | -------------- | -------------------------- | ----------------------------------------------------------------------------------------------- |
 | `SHOW`         | `vne:confirm:show`         | Показать UI или слой.                                                                           |

package/plugins/views.screens/credits.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.screens.credits`.
+
 | Ключ     | Строка               | Смысл                               |
 | -------- | -------------------- | ----------------------------------- |
 | `SHOW`   | `vne:credits:show`   | Показать UI или слой.               |
@@ -29,14 +31,14 @@
 
 ## Модули
 
-| Модуль                      | Зона ответственности                                                                                                 |
-| --------------------------- | -------------------------------------------------------------------------------------------------------------------- |
-| `credits.controller`        | SHOW/HIDE; пустой `controls` на `ZINDEX`; `afterHide` → emitNext.                                                    |
+| Модуль                      | Зона ответственности                                                                                                   |
+| --------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
+| `credits.controller`        | SHOW/HIDE; пустой `controls` на `ZINDEX`; `afterHide` → emitNext.                                                      |
 | `credits.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `CREDITS.ACCEPT` → `HIDE`; PUSH/POP на SHOW/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.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` плагина.                                                                                              |
 
 ## Близкие плагины
 

package/plugins/views.screens/disclaimer.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.screens.disclaimer`.
+
 | Ключ     | Строка                  | Смысл                                         |
 | -------- | ----------------------- | --------------------------------------------- |
 | `SHOW`   | `vne:disclaimer:show`   | Показать UI. Payload: `{ id }`.               |

package/plugins/views.screens/eula.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.screens.eula`.
+
 | Ключ           | Строка                  | Смысл                                                                    |
 | -------------- | ----------------------- | ------------------------------------------------------------------------ |
 | `UPDATE`       | `vne:eula:update`       | Обновить состояние или отображение.                                      |

package/plugins/views.screens/gallery.full.md

@@ -10,6 +10,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.screens.gallery.full`.
+
 | Ключ     | Строка                    | Смысл                               |
 | -------- | ------------------------- | ----------------------------------- |
 | `SHOW`   | `vne:gallery_full:show`   | Показать UI или слой.               |

package/plugins/views.screens/gallery.md

@@ -10,6 +10,8 @@ ACCEPT/INTERACT эмитит `CHOOSE` только для выбранного
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.screens.gallery`.
+
 | Ключ                | Строка                          | Смысл                                                                                                            |
 | ------------------- | ------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
 | `OPEN`              | `vne:gallery:open`              | Открыть экран или панель.                                                                                        |