@vnejs/docs 0.2.1

package/plugins/views/comment.md

@@ -0,0 +1,49 @@
+# plugins/views/comment/
+
+Пакет: `@vnejs/plugins.views.comment` · namespace: `COMMENT`
+
+Показывает временные комментарии поверх игры по команде сценария.
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `SHOW` | `vne:comment:show` | Показать UI или слой. |
+| `HIDE` | `vne:comment:hide` | Скрыть UI или слой. |
+| `UPDATE` | `vne:comment:update` | Обновить состояние или отображение. |
+
+## Константы
+
+Нет.
+
+## Параметры
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `ZINDEX` | `string` | Значение по умолчанию: "ZINDEX". |
+| `TRANSITION` | `string` | Значение по умолчанию: "TRANSITION". |
+| `VIEW_PROPS` | `string` | Значение по умолчанию: "VIEW_PROPS". |
+
+## Настройки
+
+Нет.
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `comment` | Модуль `comment`. |
+| `comment.controller` | Обрабатывает UPDATE, SHOW, HIDE, EXTERNAL_UPDATE, …. |
+| `comment.view` | Подмодуль `view` плагина. |
+
+## Близкие плагины
+
+### plugins/core/
+
+- [components.md](../core/components.md) — `COMPONENTS`: EVENTS.EXTERNAL_UPDATE
+- [scenario.md](../core/scenario.md) — `SCENARIO`: emitNext, EVENTS.LINE_EXEC_REG
+- [state.md](../core/state.md) — `STATE`: EVENTS.SET, EVENTS.CLEAR
+
+### Остальные
+
+- [text.md](../text/text.md) — `TEXT`: EVENTS.REPLACE

package/plugins/views/cursor.md

@@ -0,0 +1,39 @@
+# plugins/views/cursor/
+
+Пакет: `@vnejs/plugins.views.cursor` · namespace: `CURSOR_VIEW`
+
+Отображает кастомный курсор с загрузкой иконок default/pointer.
+
+## События
+
+Нет.
+
+## Константы
+
+Нет.
+
+## Параметры
+
+Нет.
+
+## Настройки
+
+Нет.
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `cursor.controller` | Обрабатывает UPDATE, SHOW, HIDE, MOVED, …. |
+| `cursor.view` | Подмодуль `view` плагина. |
+
+## Близкие плагины
+
+### plugins/core/
+
+- [memory.md](../core/memory.md) — `MEMORY`: EVENTS.CLEARED
+
+### Остальные
+
+- [cursor.md](../controls/cursor.md) — `CURSOR`: EVENTS.UPDATE, EVENTS.SHOW, EVENTS.HIDE, EVENTS.MOVED, EVENTS.VIEW_SET
+- [layer.md](../canvas/layer.md) — `LAYER`: SETTINGS.QUALITY

package/plugins/views/fps.md

@@ -0,0 +1,51 @@
+# plugins/views/fps/
+
+Пакет: `@vnejs/plugins.views.fps` · namespace: `FPS`
+
+Показывает счётчик FPS, включаемый через настройку.
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `SHOW` | `vne:fps:show` | Показать UI или слой. |
+| `HIDE` | `vne:fps:hide` | Скрыть UI или слой. |
+| `UPDATE` | `vne:fps:update` | Обновить состояние или отображение. |
+| `CHANGE` | `vne:fps:change` | Событие `CHANGE` namespace плагина. |
+
+## Константы
+
+Нет.
+
+## Параметры
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `TRANSITION` | `string` | Значение по умолчанию: "TRANSITION". |
+| `ZINDEX` | `string` | Значение по умолчанию: "ZINDEX". |
+| `VIEW_PROPS` | `string` | Значение по умолчанию: "VIEW_PROPS". |
+
+## Настройки
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `ENABLED` (`vne:fps:enabled`) | `boolean` | Включить или выключить функцию. |
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `fps.controller` | Обрабатывает UPDATE, SHOW, HIDE, CHANGE. |
+| `fps` | Обрабатывает CHANGED, STARTED. |
+| `fps.view` | Подмодуль `view` плагина. |
+
+## Близкие плагины
+
+### plugins/core/
+
+- [settings.md](../core/settings.md) — `SETTINGS`: EVENTS.CHANGED, EVENTS.INIT
+- [system.md](../core/system.md) — `SYSTEM`: EVENTS.STARTED
+
+### Остальные
+
+— нет

package/plugins/views/video.md

@@ -0,0 +1,57 @@
+# plugins/views/video/
+
+Пакет: `@vnejs/plugins.views.video` · namespace: `VIDEO`
+
+Воспроизводит полноэкранное видео по командам сценария play/load.
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `SET` | `vne:video:set` | Запросить данные у обработчиков и продолжить цепочку. |
+| `GET` | `vne:video:get` | Получить значение или ресурс. |
+| `LOAD` | `vne:video:load` | Загрузить данные или ресурс. |
+| `PLAY` | `vne:video:play` | Начать воспроизведение. |
+| `SET_SRC` | `vne:video:set_src` | Записать или обновить значение. |
+| `SHOW` | `vne:video:show` | Показать UI или слой. |
+| `HIDE` | `vne:video:hide` | Скрыть UI или слой. |
+| `UPDATE` | `vne:video:update` | Обновить состояние или отображение. |
+
+## Константы
+
+- **`EXEC_ACTIONS.PLAY`** — "play"
+
+## Параметры
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `TRANSITION` | `string` | Значение по умолчанию: "TRANSITION". |
+| `ZINDEX` | `string` | Значение по умолчанию: "ZINDEX". |
+| `VIEW_PROPS` | `string` | Значение по умолчанию: "VIEW_PROPS". |
+
+## Настройки
+
+Нет.
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `video.controller` | Обрабатывает UPDATE, EMIT, SHOW, HIDE, …. |
+| `video` | Обрабатывает HIDE, PLAY, LOAD, GET, …. |
+| `video.view` | Подмодуль `view` плагина. |
+
+## Близкие плагины
+
+### plugins/core/
+
+- [interact.md](../core/interact.md) — `INTERACT`: EVENTS.EMIT, EVENTS.PUSH
+- [media.md](../core/media.md) — `MEDIA`: EVENTS.LOAD, EVENTS.GET, CONST.PRIORITIES.BACKGROUND, CONST.TYPES.VIDEO
+- [scenario.md](../core/scenario.md) — `SCENARIO`: emitNext, EVENTS.LINE_EXEC_REG, EVENTS.LINE_LOAD_REG
+- [state.md](../core/state.md) — `STATE`: EVENTS.CLEAR, EVENTS.SET
+
+### Остальные
+
+- [controls.md](../controls/controls.md) — `CONTROLS`: CONST.BUTTONS.ANY
+- [interface.md](../views.scenario/interface.md) — `INTERFACE`: EVENTS.TEXT_HIDE
+- [layer.md](../canvas/layer.md) — `LAYER`: SETTINGS.QUALITY

package/plugins/views.scenario/choose.md

@@ -0,0 +1,79 @@
+# plugins/views.scenario/choose/
+
+Пакет: `@vnejs/plugins.views.scenario.choose` · namespace: `CHOOSE_VIEW`
+
+React-UI выбора из текстовых опций. Зависит от scenario-плагина [choose.md](../scenario/choose.md) (`CHOOSE`): слушает `SHOW` / `HIDE`, эмитит `OPTION` при выборе игроком.
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `SHOW` | `vne:choose_view:show` | Показать UI выбора. |
+| `SHOW_BEFORE` | `vne:choose_view:show_before` | Хук перед показом (после загрузки state из `globalState.choose`). |
+| `HIDE` | `vne:choose_view:hide` | Скрыть UI выбора. |
+| `UPDATE` | `vne:choose_view:update` | Обновить React-store / отображение. |
+
+Сценарные события (`EMIT`, `OPTION`, `SHOW`, `HIDE`, `SKIP`, `EXEC_*`, `STATE_UPDATE`) — в контракте `@vnejs/contracts.scenario.choose`, namespace `CHOOSE`.
+
+## Константы
+
+Нет.
+
+## Параметры
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `TRANSITION` | `number` | Длительность анимации показа/скрытия (мс). |
+| `ZINDEX` | `number` | Z-index слоя и индекс блока controls. |
+| `VIEW_PROPS` | `object` | Пропсы Screen, PositionBox, TextControls, Text. |
+| `CONTROLS_EXTENSIONS` | `object` | Дополнительные обработчики controls. |
+
+## Настройки
+
+Нет.
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `choose_view.bridge` | Bridge `CHOOSE.SHOW/HIDE` → `CHOOSE_VIEW.SHOW/HIDE`. |
+| `choose_view.controller` | Controls, emit `CHOOSE.OPTION`, `beforeShow` / `afterHide`. |
+| `choose_view.view` | React-render опций. |
+
+## Связь с CHOOSE
+
+```mermaid
+sequenceDiagram
+  participant SC as plugins.scenario.choose
+  participant OBS as Observer
+  participant BR as choose_view.bridge
+  participant VC as choose_view.controller
+
+  SC->>OBS: vne:choose:show
+  OBS->>BR: bridge
+  BR->>OBS: vne:choose_view:show
+  OBS->>VC: onShow
+  Note over VC: beforeShow читает globalState.choose
+  VC->>OBS: vne:choose:option
+  OBS->>SC: onChooseOption
+  SC->>OBS: vne:choose:hide
+  OBS->>BR: bridge
+  BR->>OBS: vne:choose_view:hide
+```
+
+## Близкие плагины
+
+### plugins/scenario/
+
+- [choose.md](../scenario/choose.md) — `CHOOSE`: EMIT, OPTION, SHOW, HIDE, globalState.choose
+
+### plugins/core/
+
+- [vendors.md](../core/vendors.md) — `VENDORS`: emitClone
+- [state.md](../core/state.md) — restore через `CHOOSE` + bridge
+
+### Остальные
+
+- [controls.md](../controls/controls.md) — `CONTROLS`: стрелки, ACCEPT
+- [interface.md](interface.md) — compatibility скрывает interface на `CHOOSE_VIEW.SHOW_BEFORE`
+- [qte.md](./qte.md) — `QTE_VIEW`: при опции с `qte:` открывается поверх choose (z-index 1300 > 1200)

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

@@ -0,0 +1,50 @@
+# plugins/views.scenario/interface.controls/
+
+Пакет: `@vnejs/plugins.views.scenario.interface.controls` · namespace: `INTERFACE_CONTROLS_VIEW`
+
+Кнопки управления интерфейсом: скрытие, продолжение и переключение видимости.
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `SHOW` | `vne:interface_controls:show` | Показать UI или слой. |
+| `HIDE` | `vne:interface_controls:hide` | Скрыть UI или слой. |
+| `UPDATE` | `vne:interface_controls:update` | Обновить состояние или отображение. |
+| `CLICK` | `vne:interface_controls:click` | Событие `CLICK` namespace плагина. |
+| `ICONS` | `vne:interface_controls:icons` | Событие `ICONS` namespace плагина. |
+
+## Константы
+
+Нет.
+
+## Параметры
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `VIEW_PROPS` | `string` | Значение по умолчанию: "VIEW_PROPS". |
+| `ITEMS` | `string` | Значение по умолчанию: "ITEMS". |
+| `CONTROLS_EXTENSIONS` | `string` | Значение по умолчанию: "CONTROLS_EXTENSIONS". |
+
+## Настройки
+
+Нет.
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `interface.controls.controller` | Обрабатывает UPDATE, VISIBLE, INTERACT, SHOW, …. |
+| `interface.controls.view` | Подмодуль `controls.view` плагина. |
+
+## Близкие плагины
+
+### plugins/core/
+
+- [memory.md](../core/memory.md) — `MEMORY`: EVENTS.CLEARED
+
+### Остальные
+
+- [controls.md](../controls/controls.md) — `CONTROLS`: EVENTS.POP, EVENTS.PUSH, CONST.BUTTONS.INTERFACE_HIDE, CONST.BUTTONS.ARROW_RIGHT, CONST.BUTTONS.ARROW_BOTTOM, CONST.BUTTONS.ANY
+- [interface.md](./interface.md) — `INTERFACE`: EVENTS.VISIBLE, EVENTS.INTERACT, EVENTS.SHOW_CHANGED, EVENTS.VIEW_CHANGED, EVENTS.STATE_CHANGED, EVENTS.VISIBLE_CHANGED
+- [layer.md](../canvas/layer.md) — `LAYER`: SETTINGS.QUALITY

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

@@ -0,0 +1,50 @@
+# plugins/views.scenario/interface.fastforward/
+
+Пакет: `@vnejs/plugins.views.scenario.interface.fastforward` · namespace: `INTERFACE_FASTFORWARD_VIEW`
+
+Кнопка и индикатор режима ускоренного просмотра в интерфейсе сценария.
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `SHOW` | `vne:interface_fastforward:show` | Показать UI или слой. |
+| `HIDE` | `vne:interface_fastforward:hide` | Скрыть UI или слой. |
+| `CLICK` | `vne:interface_fastforward:click` | Событие `CLICK` namespace плагина. |
+| `UPDATE` | `vne:interface_fastforward:update` | Обновить состояние или отображение. |
+| `DISABLE_ANIMATION` | `vne:interface_fastforward:disable_animation` | Событие `DISABLE_ANIMATION` namespace плагина. |
+
+## Константы
+
+Нет.
+
+## Параметры
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `VIEW_PROPS` | `string` | Значение по умолчанию: "VIEW_PROPS". |
+
+## Настройки
+
+Нет.
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `interface.fastforward.controller` | Обрабатывает UPDATE, TOGGLE, START, STOP, …. |
+| `interface.fastforward.view` | Подмодуль `fastforward.view` плагина. |
+
+## Близкие плагины
+
+### plugins/core/
+
+- [memory.md](../core/memory.md) — `MEMORY`: EVENTS.CLEARED
+- [system.md](../core/system.md) — `SYSTEM`: EVENTS.STARTED
+
+### Остальные
+
+- [controls.md](../controls/controls.md) — `CONTROLS`: EVENTS.POP, EVENTS.PUSH, CONST.BUTTONS.FASTFORWARD_TOGGLE, CONST.BUTTONS.FASTFORWARD_START, CONST.BUTTONS.FASTFORWARD_FINISH
+- [fastforward.md](../scenario/fastforward.md) — `FASTFORWARD`: EVENTS.TOGGLE, EVENTS.START, EVENTS.STOP, EVENTS.CHANGED
+- [interface.md](./interface.md) — `INTERFACE`: EVENTS.SHOW_CHANGED, EVENTS.VIEW_CHANGED, EVENTS.STATE_CHANGED, EVENTS.VISIBLE_CHANGED, EVENTS.VISIBLE, PARAMS.ZINDEX
+- [layer.md](../canvas/layer.md) — `LAYER`: SETTINGS.QUALITY

package/plugins/views.scenario/interface.md

@@ -0,0 +1,68 @@
+# plugins/views.scenario/interface/
+
+Пакет: `@vnejs/plugins.views.scenario.interface` · namespace: `INTERFACE`
+
+Управляет диалоговым интерфейсом: показ, скрытие, видимость и отображение текста.
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `SHOW` | `vne:interface:show` | Показать UI или слой. |
+| `HIDE` | `vne:interface:hide` | Скрыть UI или слой. |
+| `SHOW_CHANGED` | `vne:interface:show_changed` | Показать UI или слой. |
+| `VIEW_SHOW` | `vne:interface:view_show` | Показать UI или слой. |
+| `VIEW_HIDE` | `vne:interface:view_hide` | Скрыть UI или слой. |
+| `VIEW_UPDATE` | `vne:interface:view_update` | Обновить состояние или отображение. |
+| `TEXT_HIDE` | `vne:interface:text_hide` | Скрыть UI или слой. |
+| `TEXT_CHANGED` | `vne:interface:text_changed` | Зафиксировать изменение состояния. |
+| `VISIBLE_TOKENS_CHANGED` | `vne:interface:visible_tokens_changed` | Зафиксировать изменение состояния. |
+| `WALL_CHANGED` | `vne:interface:wall_changed` | Зафиксировать изменение состояния. |
+| `SPEAKER_CHANGED` | `vne:interface:speaker_changed` | Зафиксировать смену текущего спикера. |
+| `VISIBLE` | `vne:interface:visible` | Событие `VISIBLE` namespace плагина. |
+| `VISIBLE_CHANGED` | `vne:interface:visible_changed` | Зафиксировать изменение состояния. |
+| `VIEW` | `vne:interface:view` | Событие `VIEW` namespace плагина. |
+| `VIEW_CHANGED` | `vne:interface:view_changed` | Зафиксировать изменение состояния. |
+| `INTERACT` | `vne:interface:interact` | Событие `INTERACT` namespace плагина. |
+| `STATE_CHANGED` | `vne:interface:state_changed` | Сигнал об изменении накопленного состояния. |
+
+## Константы
+
+Нет.
+
+## Параметры
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `DEFAULT_VIEW` | `string` | Значение по умолчанию: "DEFAULT_VIEW". |
+| `LOC_LABEL` | `string` | Имя метки или стартовой точки. |
+| `TRANSITION` | `string` | Значение по умолчанию: "TRANSITION". |
+| `ZINDEX` | `string` | Значение по умолчанию: "ZINDEX". |
+| `VIEW_PROPS` | `string` | Значение по умолчанию: "VIEW_PROPS". |
+
+## Настройки
+
+Нет.
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `interface.controller` | Обрабатывает VIEW_UPDATE, INTERACT, VIEW_SHOW, VIEW_HIDE, …. |
+| `interface` | Обрабатывает INTERACT, SHOW, HIDE, VISIBLE, …. |
+| `interface.view` | Подмодуль `view` плагина. |
+
+## Близкие плагины
+
+### plugins/core/
+
+- [interact.md](../core/interact.md) — `INTERACT`: EVENTS.EMIT
+- [scenario.md](../core/scenario.md) — `SCENARIO`: emitNext, EVENTS.LINE_EXEC_REG
+- [state.md](../core/state.md) — `STATE`: EVENTS.SET, EVENTS.CLEAR
+
+### Остальные
+
+- [controls.md](../controls/controls.md) — `CONTROLS`: EVENTS.POP, EVENTS.PUSH
+- [text.md](../text/text.md) — `TEXT`: EVENTS.CHANGED, EVENTS.SPEAKER_CHANGED, EVENTS.EMIT_BEFORE_REG
+- [choose.md](./choose.md) — compatibility скрывает interface на `CHOOSE_VIEW.SHOW_BEFORE`
+- [qte.md](./qte.md) — compatibility скрывает interface на `QTE_VIEW.SHOW_BEFORE`

package/plugins/views.scenario/point_and_click.md

@@ -0,0 +1,87 @@
+# plugins/views.scenario/point_and_click/
+
+Пакет: `@vnejs/plugins.views.scenario.point_and_click` · namespace: `POINT_AND_CLICK_VIEW`
+
+React-UI point-and-click (иконки-hotspot). Зависит от scenario-плагина [point_and_click.md](../scenario/point_and_click.md) (`POINT_AND_CLICK`): слушает `SHOW` / `HIDE`, эмитит `OPTION` при клике.
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `SHOW` | `vne:point_and_click_view:show` | Показать UI. |
+| `SHOW_BEFORE` | `vne:point_and_click_view:show_before` | Хук перед показом (после загрузки state и icon media). |
+| `HIDE` | `vne:point_and_click_view:hide` | Скрыть UI. |
+| `UPDATE` | `vne:point_and_click_view:update` | Обновить React-store / отображение. |
+
+Сценарные события (`EMIT`, `OPTION`, `SHOW`, `HIDE`, `SKIP`, `EXEC_*`, `STATE_UPDATE`) — в контракте `@vnejs/contracts.scenario.point_and_click`, namespace `POINT_AND_CLICK`.
+
+## Константы
+
+Нет.
+
+## Параметры
+
+| Ключ | Тип | Смысл |
+|------|-----|--------|
+| `TRANSITION` | `number` | Длительность анимации показа/скрытия (мс). |
+| `ZINDEX` | `number` | Z-index слоя и индекс блока controls. |
+| `CONTROLS_EXTENSIONS` | `object` | Дополнительные обработчики controls. |
+
+## Настройки
+
+Нет.
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `point_and_click_view.bridge` | Bridge `POINT_AND_CLICK.SHOW/HIDE` → `POINT_AND_CLICK_VIEW.SHOW/HIDE`; на hide — `INTERFACE.TEXT_HIDE`. |
+| `point_and_click_view.controller` | Загрузка `iconSrc`, controls → gamemenu (+ `CONTROLS_EXTENSIONS` в `init`), `beforeShow` / `afterHide`. |
+| `point_and_click_view.view` | React-render hotspot-иконок. |
+
+## Связь с POINT_AND_CLICK
+
+```mermaid
+sequenceDiagram
+  participant SC as plugins.scenario.point_and_click
+  participant OBS as Observer
+  participant BR as point_and_click_view.bridge
+  participant VC as point_and_click_view.controller
+
+  SC->>OBS: vne:point_and_click:show
+  OBS->>BR: bridge
+  BR->>OBS: vne:point_and_click_view:show
+  OBS->>VC: onShow
+  Note over VC: beforeShow читает globalState и грузит icons
+  VC->>OBS: vne:point_and_click:option
+  OBS->>SC: onOption
+  SC->>OBS: vne:point_and_click:hide
+  OBS->>BR: bridge
+  BR->>OBS: INTERFACE.TEXT_HIDE then VIEW.HIDE
+```
+
+## Compatibility
+
+### `compatibility/views.scenario.point_and_click/views.scenario.interface/`
+
+Пакет: `@vnejs/compatibility.views.scenario.point_and_click-with-views.scenario.interface`
+
+На `POINT_AND_CLICK_VIEW.SHOW_BEFORE` эмитит `INTERFACE.HIDE`.
+
+## Близкие плагины
+
+### plugins/scenario/
+
+- [point_and_click.md](../scenario/point_and_click.md) — `POINT_AND_CLICK`: EMIT, OPTION, SHOW, HIDE, globalState.point_and_click
+
+### plugins/core/
+
+- [vendors.md](../core/vendors.md) — `VENDORS`: emitClone
+- [state.md](../core/state.md) — restore через `POINT_AND_CLICK` + bridge
+
+### Остальные
+
+- [controls.md](../controls/controls.md) — `CONTROLS`: MENU / GAMEMENU
+- [interface.md](interface.md) — compatibility скрывает interface на `SHOW_BEFORE`; bridge зовёт `TEXT_HIDE` на hide
+- [gamemenu.md](../views.screens/gamemenu.md) — `GAMEMENU`: EVENTS.SHOW
+- [layer.md](../canvas/layer.md) — `LAYER`: SETTINGS.QUALITY для media icons

package/plugins/views.scenario/qte.md

@@ -0,0 +1,105 @@
+# plugins/views.scenario/qte/
+
+Пакет: `@vnejs/plugins.views.scenario.qte` · namespace: `QTE_VIEW`
+
+React-UI Quick Time Event: фазы анимации, зона успеха в процентах, ACCEPT / INTERACT. Зависит от scenario-плагина [qte.md](../scenario/qte.md) (`QTE`): слушает `OPENED` / `CLOSED`, эмитит `RESULT` по итогам раунда.
+
+Состояние раунда **не** пишется в save — только в controller/view; на `SHOW_BEFORE` скрывается interface (compatibility).
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `SHOW` | `vne:qte_view:show` | Показать UI QTE. |
+| `SHOW_BEFORE` | `vne:qte_view:show_before` | Хук перед показом (после сброса state раунда). |
+| `HIDE` | `vne:qte_view:hide` | Скрыть UI QTE. |
+| `UPDATE` | `vne:qte_view:update` | Обновить React-store / отображение. |
+| `ACTION` | `vne:qte_view:action` | Игрок нажал ACCEPT / INTERACT (или клик) во время `active`. |
+
+Сценарные события (`EMIT`, `RESULT`, `OPENED`, `CLOSED`) — в контракте `@vnejs/contracts.scenario.qte`, namespace `QTE`.
+
+## Константы
+
+Нет.
+
+## Параметры
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `TRANSITION` | `number` | Длительность анимации показа/скрытия (мс). По умолчанию `500`. |
+| `INITIAL` | `number` | Фаза `initial` до старта intro (мс). По умолчанию `100`. |
+| `ZINDEX` | `number` | Z-index слоя и индекс блока controls. По умолчанию `1300`. |
+| `RESULT_DELAY` | `number` | Пауза на экране success/fail перед `RESULT` (мс). По умолчанию `500`. |
+| `LOC_LABEL` | `string` | Метка локализации текстов статуса (`locs`). По умолчанию `"qte"`. |
+| `VIEW_PROPS` | `object` | Пропсы Screen, PositionBox. |
+
+Длительность intro: `max(TRANSITION - INITIAL, 0)`.
+
+## Настройки
+
+Нет.
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `qte_view.controller` | Bridge `QTE.OPENED/CLOSED` → `SHOW/HIDE`; фазы `initial → intro → active → resolved → outro`; таймер fail; controls ACCEPT/INTERACT; emit `QTE.RESULT`. |
+| `qte_view.view` | React-render круга / зоны / указателя; `locLabel` для статусов. |
+
+## Фазы
+
+| Фаза | Смысл |
+|------|-------|
+| `idle` | Скрыт / сброшен. |
+| `initial` | Показ Screen, старт анимации (длительность `INITIAL`). |
+| `intro` | Масштаб круга до полного размера. |
+| `active` | Указатель крутится один оборот за `item.duration`; клик/ACCEPT проверяет попадание в зону `[start, start+size]` (%). |
+| `resolved` | Показ success/fail (`RESULT_DELAY`). |
+| `outro` | Эмит `QTE.RESULT`, затем hide. |
+
+Авто-fail: таймер на момент конца зоны успеха (`start + size`), если игрок не нажал раньше.
+
+Геометрия view: проценты → градусы (`percentToDegrees`); проверка попадания — по progress от elapsed, не по CSS-позиции указателя.
+
+## Связь с QTE
+
+```mermaid
+sequenceDiagram
+  participant SC as plugins.scenario.qte
+  participant OBS as Observer
+  participant VC as qte_view.controller
+
+  SC->>OBS: vne:qte:opened
+  OBS->>VC: bridge
+  VC->>OBS: vne:qte_view:show
+  Note over VC: phases → ACTION / auto-fail
+  VC->>OBS: vne:qte:result
+  OBS->>SC: onQteResult
+  SC->>OBS: vne:qte:closed
+  OBS->>VC: bridge
+  VC->>OBS: vne:qte_view:hide
+```
+
+## Compatibility
+
+### `compatibility/views.scenario.qte/views.scenario.interface/`
+
+Пакет: `@vnejs/compatibility.views.scenario.qte-with-views.scenario.interface`
+
+На `QTE_VIEW.SHOW_BEFORE` эмитит `INTERFACE.HIDE`. Подключается в `bundles/vn.base`.
+
+## Близкие плагины
+
+### plugins/scenario/
+
+- [qte.md](../scenario/qte.md) — `QTE`: EMIT, RESULT, OPENED, CLOSED, PARAMS.ITEMS
+
+### plugins/core/
+
+- [vendors.md](../core/vendors.md) — `VENDORS`: emitClone (через ModuleController)
+
+### Остальные
+
+- [controls.md](../controls/controls.md) — `CONTROLS`: ACCEPT, INTERACT
+- [interface.md](interface.md) — compatibility скрывает interface на `QTE_VIEW.SHOW_BEFORE`
+- [locs.md](../text/locs.md) — тексты статуса через `locLabel`