@vnejs/docs 0.2.8 → 0.2.9

package/package.json

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

package/plugins/controls/gamepad.md

@@ -40,16 +40,18 @@
 
 ## Профили и активный пад
 
-joypad.js применяет **один** `customButtonMapping` ко всем устройствам. На Steam Deck часто видны сразу два пада (raw HID + Steam Input Xbox virtual) — события с «кривого» сырого пада ломают кнопки.
+joypad.js применяет **один** `customButtonMapping` ко всем устройствам. На Steam Deck часто видны сразу два пада (raw HID + Steam Input Xbox virtual); «тихий» virtual pad нельзя выбирать заранее.
 
 Поэтому плагин:
 
-1. На `init` / `connect` / `disconnect` выбирает **preferred** пад: сначала `mapping === "standard"`, иначе Deck/Valve id, иначе первый.
-2. Ставит `joypad.set({ customButtonMapping })` только по профилю этого пада.
-3. Игнорирует `button_press` / `button_release` с других `gamepad.index`.
+1. Если пад один — сразу его профиль.
+2. Если падов несколько — ждёт **первое реальное нажатие** и lock на тот `gamepad.index`, который его прислал (не на ghost Steam Input).
+3. Дальше игнорирует события с других index; mapping только для locked-пада.
 
 Приоритет профиля: `steam-deck` → `playstation` → `nintendo` → `firefox` → `standard`.
 
+Сырой дамп кнопок для отладки — отдельный view-плагин [gamepad.debug](../views/gamepad.debug.md) (toggle в Extra).
+
 | Профиль | Когда | Что делает |
 |---------|-------|------------|
 | `standard` | по умолчанию; preferred с `mapping: "standard"` | identity |
@@ -58,7 +60,7 @@ joypad.js применяет **один** `customButtonMapping` ко всем у
 | `nintendo` | id Nintendo/Switch, в т.ч. при `standard` | A/B и X/Y под Nintendo confirm |
 | `firefox` | Firefox UA и не сработал device-профиль | индексы из доки joypad.js |
 
-Electron при `STEAM_DECK=1` добавляет в URL `?steamDeck=1` (подсказка для raw-only случая).
+Electron при `STEAM_DECK=1` добавляет `?steamDeck=1`.
 
 Все маппинги — объект `CUSTOM_BUTTON_MAPPING` в `plugins/controls/gamepad/src/profiles/custom-button-mapping.ts`:
 

package/plugins/views/gamepad.debug.md

@@ -0,0 +1,51 @@
+# plugins/views/gamepad.debug/
+
+Пакет: `@vnejs/plugins.views.gamepad.debug` · namespace: `GAMEPAD_DEBUG`
+
+Оверлей сырых данных Gamepad API (пады, pressed indices) для отладки. Включается настройкой.
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `SHOW` | `vne:gamepad.debug:show` | Показать UI. |
+| `HIDE` | `vne:gamepad.debug:hide` | Скрыть UI. |
+| `UPDATE` | `vne:gamepad.debug:update` | Обновить отображение. |
+| `CHANGE` | `vne:gamepad.debug:change` | Новый текст дампа. |
+
+## Константы
+
+Нет.
+
+## Параметры
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `TRANSITION` | number | Анимация show/hide. |
+| `ZINDEX` | number | Слой поверх UI. |
+| `VIEW_PROPS` | object | Позиция справа (`top`/`right`), props View/Wrap/Text. |
+
+## Настройки
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `ENABLED` (`vne:gamepad.debug:enabled`) | `boolean` | Показать оверлей. |
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `gamepad.debug.controller` | SHOW/HIDE/CHANGE → state/view. |
+| `gamepad.debug` | SETTINGS + rAF poll `navigator.getGamepads()`. |
+| `gamepad.debug.view` | React-оверлей. |
+
+## Близкие плагины
+
+### plugins/core/
+
+- [settings.md](../core/settings.md) — `SETTINGS`: EVENTS.CHANGED, EVENTS.INIT
+- [system.md](../core/system.md) — `SYSTEM`: EVENTS.STARTED
+
+### Остальные
+
+- [fps.md](./fps.md) — аналогичный view-плагин с toggle