@vnejs/docs 0.2.53 → 0.2.54

package/CHANGELOG.md

@@ -4,9 +4,12 @@
 
 ## 0.2.53
 
+- `module.controller.hide.on.controls`, `module.controller.accept`, `module.controller.arrows.*` — PUSH/POP controls только при смене локального `isShow` (как у `ModuleController`), без лишнего POP на HIDE до SHOW.
+- `controls/controls` — флаг блокировки EMIT в `shared.isControlsLocked` (инициализация в `controls.postinject`); при `CONTROLS.EMIT` в консоль пишется список `keys`.
 - `controls/cursor` — DOM-клик с тача эмитит `CURSOR.HIDE` (сам клик с `pointerType === "touch"`, клик после `pointerdown` с тача, либо `sourceCapabilities.firesTouchEvents`).
 - `uis.react` — `vne-cursor-target` ставится только на узлы с `vne-cursor-target-possible` (тот же момент, что непустой `vne-cursor-type`). API: `vne-cursor-target-possible`.
-- `views.screens/checkers`, `views.scenario/qte` — клетки доски и dial QTE помечаются `vne-cursor-target-possible`.
+- `views.screens/checkers` — клетки доски помечаются `vne-cursor-target-possible`.
+- `views.scenario/qte` — дефолтный UI: горизонтальная линия и маркер слева направо вместо круга; rail QTE с `vne-cursor-target-possible`. Авто-fail только в конце `duration`, не при выходе маркера из зоны. Фазы `intro` / `outro` сняты; показ и скрытие только через `Screen` (`TRANSITION`). API сценария `start` / `size` / `duration` без изменений.
 - `module` — `setStateFromGlobalState` → `setClonedState`: `setState(structuredClone(getStateSlice(payload)))`. `getStateSlice`: нет слайса в payload → `getDefaultState()` (пустые модули вырезаются из сейва). API: `setClonedState`, `getStateSlice`.
 - `module.core` — снят `onSetStateClone`; вместо него `setClonedState`. Снят `emitClone`; вместо него `structuredClone`. Снят `emitInteractPushPop`; вместо него `emit(EVENTS.INTERACT.PUSH_POP, …)`. API: снято `ModuleCore.onSetStateClone`, `ModuleCore.emitClone`, `ModuleCore.emitInteractPushPop`.
 - `core/logs` — доп. поля `LogsValue` — `LogsCloneable` (строки, числа, boolean, bigint, null, массивы, plain-object), не `unknown`. API: `LogsCloneable`, `LogsValue`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vnejs/docs",
-  "version": "0.2.53",
+  "version": "0.2.54",
   "description": "VNEJS documentation for engine consumers and coding agents",
   "files": [
     "*.md",

package/plugins/controls/controls.md

@@ -35,10 +35,10 @@ Payloads и результаты хендлеров типизированы ч
 
 ## Модули
 
-| Модуль            | Зона ответственности                                                                       |
-| ----------------- | ------------------------------------------------------------------------------------------ |
-| `controls`        | Обрабатывает EMIT, PUSH, POP.                                                              |
-| `controls.device` | Хранит `currentDevice`; на `DEVICE_SET` эмитит `DEVICE_CHANGED` только при реальной смене. |
+| Модуль            | Зона ответственности                                                                                |
+| ----------------- | --------------------------------------------------------------------------------------------------- |
+| `controls`        | Обрабатывает EMIT, PUSH, POP; во время async-обработчика EMIT выставляет `shared.isControlsLocked`. |
+| `controls.device` | Хранит `currentDevice`; на `DEVICE_SET` эмитит `DEVICE_CHANGED` только при реальной смене.          |
 
 Источники `DEVICE_SET`: keyboard (keydown) → keyboard; `controls.gamepad.device` (button_press / axis_move) → xbox|playstation по `gamepad.id`; cursor (`mousemove`) → keyboard.
 

package/plugins/views.scenario/qte.md

@@ -29,14 +29,12 @@ Payloads и результаты хендлеров типизированы ч
 | Ключ           | Тип      | Смысл                                                                 |
 | -------------- | -------- | --------------------------------------------------------------------- |
 | `TRANSITION`   | `number` | Длительность анимации показа/скрытия (мс). По умолчанию `500`.        |
-| `INITIAL`      | `number` | Фаза `initial` до старта intro (мс). По умолчанию `100`.              |
+| `INITIAL`      | `number` | Зарезервирован; не используется view (маркер стартует после `TRANSITION`). По умолчанию `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)`.
-
 ## Настройки
 
 Нет.
@@ -45,24 +43,22 @@ Payloads и результаты хендлеров типизированы ч
 
 | Модуль                       | Зона ответственности                                                                                                                                         |
 | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `qte_view.controller`        | Bridge `QTE.OPENED/CLOSED` → `SHOW/HIDE`; фазы `initial → intro → active → resolved → outro`; таймер fail; пустой `controls` на `ZINDEX`; emit `QTE.RESULT`. |
+| `qte_view.controller`        | Bridge `QTE.OPENED/CLOSED` → `SHOW/HIDE`; фазы `initial → active → resolved`; таймер fail; пустой `controls` на `ZINDEX`; emit `QTE.RESULT`. Показ/скрытие — через `Screen` (`TRANSITION`). |
 | `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` для статусов.                                                                          |
 
 ## Фазы
 
 | Фаза       | Смысл                                                                                                                |
 | ---------- | -------------------------------------------------------------------------------------------------------------------- |
 | `idle`     | Скрыт / сброшен.                                                                                                     |
-| `initial`  | Показ Screen, старт анимации (длительность `INITIAL`).                                                               |
-| `intro`    | Масштаб круга до полного размера.                                                                                    |
-| `active`   | Указатель крутится один оборот за `item.duration`; клик/ACCEPT проверяет попадание в зону `[start, start+size]` (%). |
-| `resolved` | Показ success/fail (`RESULT_DELAY`).                                                                                 |
-| `outro`    | Эмит `QTE.RESULT`, затем hide.                                                                                       |
+| `initial`  | Показ `Screen`; маркер ещё не идёт (до `TRANSITION`).                                                                |
+| `active`   | Маркер идёт слева направо за `item.duration`; клик/ACCEPT проверяет попадание в зону `[start, start+size]` (%).      |
+| `resolved` | Показ success/fail (`RESULT_DELAY`), затем `QTE.RESULT` и скрытие через `Screen`.                                  |
 
-Авто-fail: таймер на момент конца зоны успеха (`start + size`), если игрок не нажал раньше.
+Авто-fail: таймер на конец прохода маркера (`duration`), если игрок не нажал раньше.
 
-Геометрия view: проценты → градусы (`percentToDegrees`); проверка попадания — по progress от elapsed, не по CSS-позиции указателя.
+Геометрия view: зона и маркер на одной шкале 0–100% ширины линии; проверка попадания — по progress от elapsed, не по CSS-позиции маркера.
 
 ## Связь с QTE