@vnejs/docs 0.2.5 → 0.2.7

package/architecture.md

@@ -101,7 +101,7 @@ flowchart BT
 |-------|------------|
 | **`@vnejs/shared`** | Реестр **`VNE`**, массив **`VNE_MODULES`**, **`regPlugin`** / **`regModule`**, типы для module augmentation |
 | **`@vnejs/observer`** | **`Observer`** — pub/sub: `subscribe`, `emit`, `emitOne`, `emitReal`, `emitReals` |
-| **`@vnejs/core`** | **`VneCore`**: модули из `VNE_MODULES`, lifecycle, загрузка `mods.json` / media, `reset` |
+| **`@vnejs/core`** | **`VneCore`**: модули из `VNE_MODULES`, lifecycle, загрузка `mods.json` / `media_info/`, `reset` |
 | **`@vnejs/constants`** | Общие константы-заглушки (`EMPTY_OBJECT`, `EMPTY_ARRAY`) |
 | **`@vnejs/sources-set`** | **`SourcesSet`** — управление множеством «источников» (text и связанная логика) |
 | **`@vnejs/semaphore`** | **`Semaphore`** — очередь задач с весами и ограничением параллелизма |
@@ -397,6 +397,9 @@ games/<name>/
 ├── game/<mod>/      # scenario (.vne), scripts, media, public
 ├── desktop/         # Electron dev/prod
 ├── dist/            # JSON + JS после сборки
+│   ├── mods.json
+│   ├── label/       # label/<path>.json (например label/prologue/1.json)
+│   └── media_info/  # media_info/<mod>.json (не путать с /media/ ассетов)
 └── package.json
 ```
 
@@ -404,7 +407,7 @@ games/<name>/
 flowchart LR
   SC["game/**/*.vne"]
   DATA["build data"]
-  JSON["dist/*.json"]
+  JSON["dist mods.json label/ media_info/"]
   ENTRY["entry/index.ts"]
   CLIENT["build client"]
   DIST["dist/"]
@@ -417,7 +420,7 @@ flowchart LR
   SRV --> RUN
 ```
 
-1. **`build:data`** — JSON для **`VneCore.init()`** (`mods.json`, labels, media).
+1. **`build:data`** — JSON для **`VneCore.init()`**: `mods.json`, `label/<path>.json`, `media_info/<mod>.json`.
 2. **`build:client`** — Vite + `bundles/`.
 3. **`entry/`** — `new VneCore()`, `await init()`.
 

package/package.json

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

package/plugins/controls/gamepad.md

@@ -20,6 +20,48 @@
 
 Нет.
 
+## Маппинг кнопок (W3C / Xbox standard)
+
+После того как joypad выдаёт логическое имя `button_N`, плагин эмитит ключи в `CONTROLS.EMIT`:
+
+| joypad | Физическая (standard) | Абстрактный control |
+|--------|----------------------|---------------------|
+| `button_0` | A / Cross (низ) | `ACCEPT` |
+| `button_1` | B / Circle (право) | `BACK` |
+| `button_2` | X / Square (лево) | `INTERACT` |
+| `button_3` | Y / Triangle (верх) | `MENU` |
+| `button_4` | LB / L1 | `TAB_PREV` |
+| `button_5` | RB / R1 | `TAB_NEXT` |
+| `button_6` | LT / L2 | `FASTFORWARD_START` / `FASTFORWARD_FINISH` |
+| `button_7` | RT / R2 | (cursor click через compatibility) |
+| `button_8` | View / Select | `GAMEMENU` |
+| `button_9` | Menu / Start | `MENU` |
+| `button_12`…`15` | D-pad | `ARROW_*` |
+
+## Профили
+
+На `joypad` `connect` выбирается профиль и, при необходимости, вызывается `joypad.set({ customButtonMapping })`.
+
+Приоритет: `steam-deck` → `playstation` → `nintendo` → `firefox` → `standard`.
+
+| Профиль | Когда | Что делает |
+|---------|-------|------------|
+| `standard` | по умолчанию | identity (сырой индекс = logical `button_N`) |
+| `steam-deck` | `mapping !== "standard"` и id Deck/Steam (`steam deck` / `valve` / `jupiter` / `28de`) | raw HID Deck → W3C |
+| `playstation` | `mapping !== "standard"` и id PS (`dualsense` / `dualshock` / `054c` / …) | raw Square-first layout → W3C |
+| `nintendo` | id Nintendo/Switch (`nintendo` / `switch` / `057e` / …), в т.ч. при `standard` | A/B и X/Y под Nintendo confirm |
+| `firefox` | Firefox UA и не сработал device-профиль | индексы из доки joypad.js |
+
+Если Steam Input / браузер отдаёт корректный `STANDARD GAMEPAD` для Xbox/PS — обычно остаётся `standard` (для PS при `mapping === "standard"` playstation-профиль не включается).
+
+Все маппинги — объект `CUSTOM_BUTTON_MAPPING` в `plugins/controls/gamepad/src/profiles/custom-button-mapping.ts`:
+
+- `CUSTOM_BUTTON_MAPPING.STANDARD` — `null` (identity)
+- `CUSTOM_BUTTON_MAPPING.STEAM_DECK` — A→7, B→5, X→6, Y→4, LB→3, RB→2, LT→1, RT→0, Select→12, Start→14, D-pad → 8/11/10/9
+- `CUSTOM_BUTTON_MAPPING.PLAYSTATION` — Cross←1, Circle←2, Square←0, Triangle←3; L1…R3 → 4…11
+- `CUSTOM_BUTTON_MAPPING.NINTENDO` — ACCEPT←1 (A), BACK←0 (B), INTERACT←3 (X), MENU←2 (Y)
+- `CUSTOM_BUTTON_MAPPING.FIREFOX` — `button_0`←1, `button_7`←11, `button_8`←12
+
 ## Модули
 
 | Модуль | Зона ответственности |

package/plugins/core/scenario.md

@@ -50,7 +50,7 @@
 | `scenario.exec` | Dispatch `$module` / `%block`, registry handlers, `EXEC_DELAY`. |
 | `scenario.label` | `LABEL_GET`, preload меток; init label на `STATE.CLEAR`. |
 | `scenario.line` | `LINE_LOAD` / `LINE_GET`, registry preload handlers. |
-| `scenario.lines` | Fetch `label.*.json` с `HOST`. |
+| `scenario.lines` | Fetch `label/<path>.json` с `HOST` (например `label/prologue/1.json`). |
 
 ## Близкие плагины