@vnejs/docs 0.2.1

package/plugins/scales/scales.md

@@ -0,0 +1,54 @@
+# plugins/scales/scales/
+
+Пакет: `@vnejs/plugins.scales.scales` · namespace: `SCALES`
+
+Управляет числовыми шкалами: spawn, change, set, check и границы.
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `SPAWN` | `vne:scales:spawn` | Событие `SPAWN` namespace плагина. |
+| `DESTROY` | `vne:scales:destroy` | Событие `DESTROY` namespace плагина. |
+| `SET` | `vne:scales:set` | Записать или обновить значение. |
+| `RESET` | `vne:scales:reset` | Событие `RESET` namespace плагина. |
+| `CHANGE` | `vne:scales:change` | Событие `CHANGE` namespace плагина. |
+| `CHANGED` | `vne:scales:changed` | Зафиксировать изменение состояния. |
+| `CHECK` | `vne:scales:check` | Проверить состояние или наличие ресурса. |
+| `OVERFLOW` | `vne:scales:overflow` | Событие `OVERFLOW` namespace плагина. |
+| `UNDERFLOW` | `vne:scales:underflow` | Событие `UNDERFLOW` namespace плагина. |
+
+## Константы
+
+Нет.
+
+## Параметры
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `TYPES` | `string` | Виды шкал (`health`, `mana`, …), расширяются дочерними контрактами. |
+
+## Ключи
+
+Контракт экспортирует `getScaleKey(entityId, scaleType)` → `` `${entityId}:${scaleType}` `` (например `hero:health`). События scales принимают `key` как opaque string.
+
+## Настройки
+
+Нет.
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `scales` | Обрабатывает SPAWN, DESTROY, RESET, CHANGE, …. |
+
+## Близкие плагины
+
+### plugins/core/
+
+- [state.md](../core/state.md) — `STATE`: EVENTS.SET, EVENTS.CLEAR
+
+### Остальные
+
+- [health.md](./health.md) — `SCALES.TYPES.HEALTH`
+- [mana.md](./mana.md) — `SCALES.TYPES.MANA`

package/plugins/scenario/autoread.md

@@ -0,0 +1,50 @@
+# plugins/scenario/autoread/
+
+Пакет: `@vnejs/plugins.scenario.autoread` · namespace: `AUTOREAD`
+
+Автоматически продвигает сценарий по таймеру с настраиваемой задержкой и временными блокировками.
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `TRY` | `vne:autoread:try` | Записать диагностическое сообщение в лог. |
+| `PUSH` | `vne:autoread:push` | Добавить элемент в очередь или стек. |
+| `POP` | `vne:autoread:pop` | Извлечь элемент из очереди или стека. |
+
+## Константы
+
+Нет.
+
+## Параметры
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `DEFAULT_DELAY` | `number` | Значение по умолчанию: 5000. |
+| `DEFAULT_ENABLED` | `boolean` | Значение по умолчанию для включения функции. |
+
+## Настройки
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `ENABLED` (`vne:autoread:enabled`) | `boolean` | Включить или выключить функцию. |
+| `DELAY` (`vne:autoread:delay`) | `number` | Настройка `vne:autoread:delay` в `shared.settings`. |
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `autoread` | Обрабатывает TRY, PUSH, POP, CHANGED, …. |
+
+## Близкие плагины
+
+### plugins/core/
+
+- [interact.md](../core/interact.md) — `INTERACT`: EVENTS.EMIT
+- [logs.md](../core/logs.md) — `LOGS`: emitLog
+- [settings.md](../core/settings.md) — `SETTINGS`: EVENTS.CHANGED, EVENTS.INIT
+- [state.md](../core/state.md) — `STATE`: EVENTS.CLEAR, EVENTS.SET
+
+### Остальные
+
+— нет

package/plugins/scenario/choose.md

@@ -0,0 +1,111 @@
+# plugins/scenario/choose/
+
+Пакет: `@vnejs/plugins.scenario.choose` · namespace: `CHOOSE`
+
+Обрабатывает сценарные команды `% choose` / `$ choose`, собирает опции, хранит состояние выбора в `globalState.choose` и переводит сценарий к выбранной ветке. UI не рендерит — за отображение отвечает [views.scenario/choose.md](../views.scenario/choose.md).
+
+## Сценарные команды
+
+| Синтаксис | Смысл |
+|-----------|--------|
+| `% choose` | Открыть выбор: собрать `% choose.option`, emit `EMIT`. Если все опции `hided` (или список пуст) — `SKIP` и переход за блок. |
+| `% choose.option "…"` | Ветка опции; при проходе мимо невыбранной — skip тела по indent. |
+| `$ choose repeat` | Вернуться к ближайшему `% choose` **выше** текущей строки в том же label и `emitNext`. |
+
+Пример цикла «осмотреть → вернуться в меню»:
+
+```vne
+% choose
+  % choose.option "Осмотреть"
+    hided: $ flag seen
+    $ flag seen
+    "…"
+    $ choose repeat
+# дальше — когда при повторном входе все option скрыты
+```
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `EMIT` | `vne:choose:emit` | Принять опции и args; если есть видимые — `STATE_UPDATE` и `SHOW`; иначе `SKIP`. |
+| `OPTION` | `vne:choose:option` | Принять выбор по UI-индексу: прогнать `OPTION_BEFORE`, затем `HIDE`, `OPTION_REPLACE`, установить `curLine`, сброс state, `emitNext`. |
+| `OPTION_BEFORE` | `vne:choose:option_before` | Side effects до применения выбора (handlers с приоритетами; `ModuleHandlers`). |
+| `OPTION_BEFORE_REG` | `vne:choose:option_before_reg` | Зарегистрировать обработчик `OPTION_BEFORE`. |
+| `OPTION_REPLACE` | `vne:choose:option_replace` | Подменить UI-индекс принятой опции (цепочка handlers перед переходом по ветке). |
+| `OPTION_REPLACE_REG` | `vne:choose:option_replace_reg` | Зарегистрировать обработчик `OPTION_REPLACE`. |
+| `SKIP` | `vne:choose:skip` | Пропустить блок: `curLine` на первую строку после indent-дерева `% choose`, `emitNext`. |
+| `SHOW` | `vne:choose:show` | Выбор активен (state готов). Слушает view-плагин. |
+| `HIDE` | `vne:choose:hide` | Выбор закрыт. Слушает view-плагин. |
+| `EXEC_REG` | `vne:choose:exec_reg` | Зарегистрировать exec-обработчик для подстановки в опции. |
+| `EXEC_GET` | `vne:choose:exec_get` | Получить значение через зарегистрированный exec-обработчик. |
+| `STATE_UPDATE` | `vne:choose:state_update` | Обновить накопленное состояние модуля `choose`. |
+
+## Константы
+
+| Ключ | Смысл |
+|------|--------|
+| `EXEC_ACTIONS.REPEAT` | Литерал `repeat` для `$ choose repeat`. |
+| `LOGS_ACTIONS` | Метки для логов: `EMIT`, `OPTION`, `SKIP`, `SHOW`, `HIDE`, `REPEAT`. |
+
+## Параметры
+
+Нет.
+
+## Настройки
+
+Нет.
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `choose` | State: `STATE_UPDATE`, синхронизация с `STATE.SET` / `STATE.CLEAR` (→ `SHOW` / `HIDE`). |
+| `choose.emit` | Обрабатывает `EMIT` (→ `STATE_UPDATE` + `SHOW` или `SKIP`). |
+| `choose.option` | Обрабатывает `OPTION`. |
+| `choose.skip` | Обрабатывает `SKIP`. |
+| `choose.logs` | Логирование `EMIT` / `OPTION` / `SKIP` / `SHOW` / `HIDE`. |
+| `choose.option_before` | Реестр обработчиков `OPTION_BEFORE_REG`; наследник `@vnejs/module.handlers`. |
+| `choose.replace` | Реестр обработчиков `OPTION_REPLACE_REG`; наследник `@vnejs/module.replace`. |
+| `choose.exec` | Реестр обработчиков EXEC_REG / EXEC_GET. |
+| `choose.scenario` | Регистрация `% choose`: сбор option-строк, emit `EMIT`. |
+| `choose.scenario.option` | Регистрация `% choose.option`: skip невыбранных веток. |
+| `choose.scenario.module` | Регистрация `$ choose`: action `repeat`. |
+
+## Compatibility
+
+### `compatibility/scenario.choose/scenario.fastforward/`
+
+Пакет: `@vnejs/compatibility.scenario.choose-with-scenario.fastforward`
+
+В `init` регистрирует handler на `OPTION_BEFORE_REG`: при выборе опции эмитит `FASTFORWARD.CHECK` (до `HIDE` / `OPTION_REPLACE`).
+
+### `compatibility/scenario.choose/views.screens.history/`
+
+Пакет: `@vnejs/compatibility.scenario.choose-with-views.screens.history`
+
+В `init` регистрирует handler на `OPTION_BEFORE_REG`: при выборе опции эмитит `HISTORY.ADD` с `{ locKey: "choice" }` (без speaker/text). Текст строки берётся из локализации view history (`history.json`).
+
+### `compatibility/scenario.choose/scenario.qte/`
+
+Пакет: `@vnejs/compatibility.scenario.choose-with-scenario.qte`
+
+На `OPTION_REPLACE` запускает QTE, если у опции есть `qte: <id>` (см. [qte.md](./qte.md#compatibility)). Поле `qte` добавляется в тип `ChooseOption` через module augmentation этого пакета; `qte-fallback` — keyword на строке опции (`% choose.option "…" | qte-fallback`), попадает в `ChooseOption.keywords`.
+
+## Близкие плагины
+
+### plugins/core/
+
+- [logs.md](../core/logs.md) — `LOGS`: emitLog, `CONST.LOGS.FILTER_FROM_RESULT_OPTIONS`
+- [scenario.md](../core/scenario.md) — `SCENARIO`: emitNext, EVENTS.LINE_EXEC_REG, EVENTS.LINES_GET
+- [state.md](../core/state.md) — `STATE`: EVENTS.SET, EVENTS.CLEAR
+- [vendors.md](../core/vendors.md) — `VENDORS`: emitClone
+
+### Остальные
+
+- [text.md](../text/text.md) — `TEXT`: EVENTS.REPLACE (текст опций)
+- [qte.md](./qte.md) — `QTE`: связка через `OPTION_REPLACE` (compatibility выше)
+- [fastforward.md](./fastforward.md) — `FASTFORWARD`: связка через `OPTION_BEFORE_REG` (compatibility выше)
+- [views.screens/history.md](../views.screens/history.md) — `HISTORY`: связка через `OPTION_BEFORE_REG` → `ADD` с `locKey` (compatibility выше)
+- [views.scenario/choose.md](../views.scenario/choose.md) — `CHOOSE_VIEW`: UI выбора (слушает SHOW / HIDE)
+- [scenario/point_and_click.md](./point_and_click.md) — тот же паттерн `repeat` / `SKIP` / `SHOW` / `HIDE` / `STATE_UPDATE`

package/plugins/scenario/fastforward.md

@@ -0,0 +1,61 @@
+# plugins/scenario/fastforward/
+
+Пакет: `@vnejs/plugins.scenario.fastforward` · namespace: `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` | Зафиксировать изменение состояния. |
+| `CLEAR` | `vne:fastforward:clear` | Очистить накопленное состояние. |
+
+## Константы
+
+Нет.
+
+## Параметры
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `DEFAULT_CHECK_VISITED` | `boolean` | Значение по умолчанию: true. |
+| `DEFAULT_DELAY` | `number` | Значение по умолчанию: 50. |
+| `DEFAULT_ENABLED` | `boolean` | Значение по умолчанию для включения функции. |
+
+## Настройки
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `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` | Включить или выключить функцию. |
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `fastforward` | Обрабатывает STOP, START, CHECK, TOGGLE, …. |
+| `fastforward.visits` | Визиты в `STORAGE`: `group` = label, `key` = hash; `GET_ALL` по module без group возвращает `label/hash`, при init hash берётся из хвоста ключа. На диске: `fastforward.visits/{label}.json`. |
+
+## Близкие плагины
+
+### plugins/core/
+
+- [interact.md](../core/interact.md) — `INTERACT`: EVENTS.EMIT
+- [scenario.md](../core/scenario.md) — `SCENARIO`: EVENTS.EXEC
+- [settings.md](../core/settings.md) — `SETTINGS`: EVENTS.INIT
+- [state.md](../core/state.md) — `STATE`: EVENTS.CLEAR, EVENTS.SET
+- [storage.md](../core/storage.md) — `STORAGE`: EVENTS.GET_ALL, EVENTS.SET, EVENTS.RM_ALL
+- [system.md](../core/system.md) — `SYSTEM`: EVENTS.STARTED
+- [vendors.md](../core/vendors.md) — `VENDORS`: EVENTS.HASH
+
+### Остальные
+
+- [choose.md](./choose.md) — `CHOOSE`: связка через `compatibility/scenario.choose/scenario.fastforward` (`OPTION_BEFORE_REG` → `FASTFORWARD.CHECK`)

package/plugins/scenario/pause.md

@@ -0,0 +1,43 @@
+# plugins/scenario/pause/
+
+Пакет: `@vnejs/plugins.scenario.pause` · namespace: `PAUSE`
+
+Ставит сценарий на паузу до клика игрока или на заданное время через exec-команду.
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `START` | `vne:pause:start` | Продвинуть сценарий к следующей строке. |
+| `END` | `vne:pause:end` | Записать диагностическое сообщение в лог. |
+
+## Константы
+
+Нет.
+
+## Параметры
+
+Нет.
+
+## Настройки
+
+Нет.
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `pause` | Обрабатывает END, START, CLEAR. |
+
+## Близкие плагины
+
+### plugins/core/
+
+- [interact.md](../core/interact.md) — `INTERACT`: EVENTS.POP, EVENTS.PUSH
+- [logs.md](../core/logs.md) — `LOGS`: emitLog
+- [scenario.md](../core/scenario.md) — `SCENARIO`: emitNext, EVENTS.LINE_EXEC_REG
+- [state.md](../core/state.md) — `STATE`: EVENTS.CLEAR
+
+### Остальные
+
+— нет

package/plugins/scenario/point_and_click.md

@@ -0,0 +1,95 @@
+# plugins/scenario/point_and_click/
+
+Пакет: `@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).
+
+## Сценарные команды
+
+| Синтаксис | Смысл |
+|-----------|--------|
+| `% point-and-click` | Открыть point-and-click: собрать `% point-and-click.option`, emit `EMIT`. Если все опции `hided` (или список пуст) — `SKIP` и переход за блок. |
+| `% point-and-click.option {icon} x y` | Hotspot; при проходе мимо невыбранного — skip тела по indent. |
+| `$ point-and-click repeat` | Вернуться к ближайшему `% point-and-click` **выше** текущей строки в том же label и `emitNext`. |
+
+Пример цикла осмотра:
+
+```vne
+% point-and-click
+  % point-and-click.option {lupa} 25 25
+    hided: $ flag prologue_2_pac_1
+    $ flag prologue_2_pac_1
+    "…"
+    $ point-and-click repeat
+# дальше — когда при повторном входе все option скрыты
+```
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `EMIT` | `vne:point_and_click:emit` | Принять опции и args; если есть видимые — `STATE_UPDATE` и `SHOW`; иначе `SKIP`. |
+| `OPTION` | `vne:point_and_click:option` | Выбор hotspot: `HIDE`, `curLine` внутрь опции, сброс state через `STATE_UPDATE`, `emitNext`. |
+| `SKIP` | `vne:point_and_click:skip` | Пропустить блок: `curLine` на первую строку после indent-дерева `% point-and-click`, `emitNext`. |
+| `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`. |
+
+## Константы
+
+| Ключ | Смысл |
+|------|--------|
+| `EXEC_ACTIONS.REPEAT` | Литерал `repeat` для `$ point-and-click repeat`. |
+| `LOGS_ACTIONS` | Метки для логов: `EMIT`, `OPTION`, `SKIP`, `SHOW`, `HIDE`, `REPEAT`. |
+
+## Параметры
+
+Нет.
+
+## Настройки
+
+Нет.
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `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`. |
+| `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-строк, emit `EMIT`. |
+| `point-and-click.scenario.option` | Регистрация `% point-and-click.option`: skip невыбранных веток. |
+| `point-and-click.scenario.module` | Регистрация `$ point-and-click`: action `repeat`. |
+
+## Compatibility
+
+### `compatibility/scenario.point_and_click/vars.flags/`
+
+Пакет: `@vnejs/compatibility.scenario.point_and_click-with-vars.flags`
+
+В `init` регистрирует handler на `EXEC_REG` для модуля flags → `VARS_FLAGS.EXEC_CHECK`.
+
+### `compatibility/scenario.point_and_click/vars.counters/`
+
+Пакет: `@vnejs/compatibility.scenario.point_and_click-with-vars.counters`
+
+В `init` регистрирует handler на `EXEC_REG` для модуля counters → `VARS_COUNTERS.EXEC_CHECK`.
+
+## Близкие плагины
+
+### plugins/core/
+
+- [logs.md](../core/logs.md) — `LOGS`: emitLog, `CONST.LOGS.FILTER_FROM_RESULT_OPTIONS`
+- [scenario.md](../core/scenario.md) — `SCENARIO`: emitNext, EVENTS.LINE_EXEC_REG, EVENTS.LINES_GET
+- [state.md](../core/state.md) — `STATE`: EVENTS.SET, EVENTS.CLEAR
+- [vendors.md](../core/vendors.md) — `VENDORS`: emitClone
+
+### Остальные
+
+- [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

package/plugins/scenario/qte.md

@@ -0,0 +1,97 @@
+# plugins/scenario/qte/
+
+Пакет: `@vnejs/plugins.scenario.qte` · namespace: `QTE`
+
+Логика Quick Time Event: сценарная команда `% qte <id>`, сдвиг `curLine` по success/fail и режим embedded (`skipScenario`) для вызова из других плагинов. UI не рендерит — за отображение отвечает [views.scenario/qte.md](../views.scenario/qte.md).
+
+Описание QTE задаётся в игре через `PARAMS.QTE.ITEMS` (контракт `@vnejs/contracts.scenario.qte`).
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `EMIT` | `vne:qte:emit` | Запустить QTE: принять `id` / `item` / `skipScenario`, эмитить `OPENED`. |
+| `RESULT` | `vne:qte:result` | Результат раунда (`success`). Эмитит `CLOSED`; без `skipScenario` — сдвиг сценария и `emitNext`. |
+| `OPENED` | `vne:qte:opened` | QTE активен. Слушает view-плагин. |
+| `CLOSED` | `vne:qte:closed` | QTE закрыт. Слушает view-плагин. |
+
+## Константы
+
+- **`LINE_KEYWORDS.QTE_FALLBACK`** — `"qte-fallback"`: keyword на `% choose.option` для ветки fail QTE (через compatibility choose↔qte).
+
+## Параметры
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `ITEMS` | `Record<string, QteItem>` | Справочник QTE по id. Пустой объект по умолчанию. |
+
+`QteItem`:
+
+| Поле | Тип | Смысл |
+|------|-----|-------|
+| `start` | `number` | Начало зоны успеха, % от длительности (0–100). |
+| `size` | `number` | Ширина зоны успеха, %. |
+| `duration` | `number` | Длительность фазы `active`, мс. |
+
+View сам переводит проценты в геометрию (градусы, пиксели и т.п.).
+
+## Настройки
+
+Нет.
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `qte` | EMIT / RESULT / OPENED / CLOSED; `applyResult` (success → `curLine + 1`, fail → пропуск indented-блока); флаг `skipScenario`. |
+| `qte.scenario` | Регистрация `% qte` в SCENARIO; lookup `ITEMS`; при отсутствии id/item — `RESULT { success: false }`. |
+
+## Сценарий
+
+```vne
+% qte door_lock
+  "Успех — вход в indented-блок"
+"Провал или после блока — следующая строка"
+```
+
+1. `% qte <id>` → `EMIT` с `item` из `ITEMS[id]`.
+2. **Success** → `curLine` на первую строку внутри блока.
+3. **Fail** (или неизвестный id) → пропуск indented-блока, дальше по сценарию.
+4. После `RESULT` (без `skipScenario`) — `emitNext`.
+
+## Embedded (`skipScenario`)
+
+При `EMIT` с `skipScenario: true` модуль `qte` на `RESULT` **не** меняет `curLine` и **не** вызывает `emitNext` — только `CLOSED`. Используется compatibility choose↔qte, чтобы ветвление осталось у choose.
+
+## Compatibility
+
+### `compatibility/scenario.choose/scenario.qte/`
+
+Пакет: `@vnejs/compatibility.scenario.choose-with-scenario.qte`
+
+На `CHOOSE.OPTION_REPLACE`: если у опции `qte: <id>`, запускает QTE с `skipScenario: true`. Success — тот же индекс опции; fail — индекс опции, у которой в `keywords` есть `LINE_KEYWORDS.QTE_FALLBACK` (`qte-fallback`; если нет — исходный индекс + `emitLog`).
+
+Расширяет тип `ChooseOption` полем `qte?: string`. Keyword `| qte-fallback` попадает в `ChooseOption.keywords` через choose.
+
+```vne
+% choose
+  % choose.option "С QTE"
+    qte: easy
+    "Успех — ветка этой опции"
+  % choose.option "Fallback" | qte-fallback
+    "Прямой выбор или fail QTE"
+```
+
+Подключается в `bundles/vn.base`.
+
+## Близкие плагины
+
+### plugins/core/
+
+- [logs.md](../core/logs.md) — `LOGS`: emitLog
+- [scenario.md](../core/scenario.md) — `SCENARIO`: emitNext, EVENTS.LINE_EXEC_REG, EVENTS.LINES_GET
+
+### Остальные
+
+- [views.scenario/qte.md](../views.scenario/qte.md) — `QTE_VIEW`: UI раунда (слушает OPENED / CLOSED)
+- [choose.md](./choose.md) — `CHOOSE`: OPTION_REPLACE; связка через compatibility выше

package/plugins/scenario/random.md

@@ -0,0 +1,38 @@
+# plugins/scenario/random/
+
+Пакет: `@vnejs/plugins.scenario.random` · namespace: `RANDOM`
+
+Случайно выбирает одну из вложенных опций `% random.option` блока `% random` и переходит к ней.
+
+## События
+
+Нет.
+
+## Константы
+
+Нет.
+
+## Параметры
+
+Нет.
+
+## Настройки
+
+Нет.
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `random` | Модуль `random`. |
+
+## Близкие плагины
+
+### plugins/core/
+
+- [logs.md](../core/logs.md) — `LOGS`: emitLog
+- [scenario.md](../core/scenario.md) — `SCENARIO`: emitNext, EVENTS.LINE_EXEC_REG, EVENTS.LINES_GET
+
+### Остальные
+
+— нет

package/plugins/settings/filter.md

@@ -0,0 +1,39 @@
+# plugins/settings/filter/
+
+Пакет: `@vnejs/plugins.settings.filter` · namespace: `FILTER`
+
+Применяет к экрану CSS-фильтры из пресетов, выбранных в настройках.
+
+## События
+
+Нет.
+
+## Константы
+
+Нет.
+
+## Параметры
+
+Нет.
+
+## Настройки
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `VALUE` (`vne:filter:value`) | `string` | Настройка `vne:filter:value` в `shared.settings`. |
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `filter` | Модуль `filter`. |
+
+## Близкие плагины
+
+### plugins/core/
+
+- [settings.md](../core/settings.md) — `SETTINGS`: EVENTS.CHANGED, EVENTS.INIT
+
+### Остальные
+
+— нет

package/plugins/settings/potato.md

@@ -0,0 +1,41 @@
+# plugins/settings/potato/
+
+Пакет: `@vnejs/plugins.settings.potato` · namespace: `POTATO`
+
+Режим низкой нагрузки: отключает анимации, переходы и таймауты медиа.
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `EMIT` | `vne:potato:emit` | Инициировать действие или цикл. |
+
+## Константы
+
+Нет.
+
+## Параметры
+
+Нет.
+
+## Настройки
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `ENABLED` (`vne:potato:enabled`) | `boolean` | Включить или выключить функцию. |
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `potato` | Обрабатывает EMIT, CHANGED. |
+
+## Близкие плагины
+
+### plugins/core/
+
+- [settings.md](../core/settings.md) — `SETTINGS`: EVENTS.CHANGED, EVENTS.INIT
+
+### Остальные
+
+— нет

package/plugins/settings/ratio.md

@@ -0,0 +1,41 @@
+# plugins/settings/ratio/
+
+Пакет: `@vnejs/plugins.settings.ratio` · namespace: `RATIO`
+
+Ограничивает размер приложения соотношением сторон 16:9.
+
+## События
+
+Нет.
+
+## Константы
+
+Нет.
+
+## Параметры
+
+Нет.
+
+## Настройки
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `VALUE` (`vne:ratio:value`) | `boolean` | Настройка `vne:ratio:value` в `shared.settings`. |
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `ratio` | Обрабатывает CHANGED, STARTED. |
+
+## Близкие плагины
+
+### plugins/core/
+
+- [logs.md](../core/logs.md) — `LOGS`: emitLog
+- [settings.md](../core/settings.md) — `SETTINGS`: EVENTS.CHANGED, EVENTS.INIT
+- [system.md](../core/system.md) — `SYSTEM`: EVENTS.STARTED, CONST.DOM_IDS.APP
+
+### Остальные
+
+— нет