@vnejs/docs 0.2.46 → 0.2.48

package/CHANGELOG.md

@@ -2,6 +2,32 @@
 
 Краткая история изменений движка (плагины, helpers, packages, CLI и прочий runtime) и внешнего API. Версии — релизы пакета `@vnejs/docs`.
 
+## 0.2.47
+
+- `views.screens/save` — `SLOT_CREATE` result: `SaveViewSlotCreateResult` (в contracts); `views.screens/confirm` — `onAccept` / `onDecline`: `() => unknown`.
+- `views/*`, `views.scenario/*`, `views.screens/*` plugins — локальные `*PluginState` перенесены из `utils` в `types.ts` плагина.
+- `canvas/*` contracts (`bg`, `bg.speak`, `fill`, `layer`, `sprite`, `sprite.speak`, `text`, `video`) — `VneEventPayloadMap` + `VneEventResultMap` на все `SUBSCRIBE_EVENTS`; payload/result-типы в contracts (промоут из plugins / `module.layer`). API: payload/result types на событиях `LAYER_BG`, `LAYER_BG_SPEAK`, `LAYER_FILL`, `LAYER`, `LAYER_SPRITE`, `LAYER_SPRITE_SPEAK`, `LAYER_TEXT`, `LAYER_VIDEO`; `LayerChildRmPayload.duration`, `SpriteSrcGetPayload.mediaType`, `SpritePreloadPayload.priority` (`number | string`).
+- `canvas.layers/*` (`bl`, `fl`, `ml`, `ul`) — `VneEventPayloadMap` + `VneEventResultMap` на `UPDATE`. API: payload/result types на событиях `LAYER_BL`, `LAYER_FL`, `LAYER_ML`, `LAYER_UL`.
+- `canvas.props/*` (`animation`, `clip`, `filter`, `mask`, `scale`) — `VneEventPayloadMap` + `VneEventResultMap` на все `SUBSCRIBE_EVENTS`; payload-типы в contracts. API: payload/result types на событиях `LAYER_ANIMATION`, `LAYER_CLIP`, `LAYER_FILTER`, `LAYER_MASK`, `LAYER_SCALE`.
+- `views/*`, `views.scenario/*`, `views.screens/*` contracts — `VneEventPayloadMap` + `VneEventResultMap` на все `SUBSCRIBE_EVENTS`; payload/result-типы в contracts (промоут из plugins; локальные `*PluginState` — в `types.ts` плагина). API: payload/result types на событиях views / views.scenario / views.screens. Cursor без `SUBSCRIBE_EVENTS` — без maps.
+- `audio/audio`, `controls/controls`, `controls/cursor`, `controls/gamepad`, `save/save`, `save/auto`, `save/continue`, `save/quick`, `scales/scales`, `common/grid`, `common/turn`, `platform/electron`, `platform/metric`, `entities/wallet` — `VneEventPayloadMap` + `VneEventResultMap` на все `SUBSCRIBE_EVENTS`; payload/result-типы в contracts (промоут из plugins где нужно). API: payload/result types на событиях `AUDIO`, `CONTROLS`, `CURSOR`, `GAMEPAD`, `SAVE`, `SAVE_AUTO`, `SAVE_CONTINUE`, `SAVE_QUICK`, `SCALES`, `GRID`, `TURNS`, `ELECTRON`, `METRIC`, `WALLET`.
+- `ai/ai`, `ai/checkers`, `game/checkers`, `rpg/damage`, `rpg/hit`, `rpg/skills` — `VneEventPayloadMap` + `VneEventResultMap` на все `SUBSCRIBE_EVENTS`; payload/result-типы в contracts (`payloads.ts`). API: payload/result types на событиях `AI`, `CHECKERS_AI`, `CHECKERS`, `DAMAGE`, `HIT`, `SKILLS` (в т.ч. `SkillsCheckPayload`, `CheckersStateUpdatePayload`).
+- `scenario/choose`, `scenario/point_and_click` — `ChooseOptionLine` / `PointAndClickOptionLine` = `ScenarioLineObj` (`@vnejs/contracts.core.scenario`); сняты casts на `SCENARIO.LINES_GET`.
+- `vars/flags` — `GET` / `EXEC_GET` result: `boolean | undefined` (вместо `boolean`); handler `GET` нормализует `VARS.GET`.
+- `vars/counters` — `EXEC_CHECK` result: `boolean | undefined`; `GET` нормализует `VARS.GET` → `number | undefined`.
+- `vars/vars`, `vars/flags`, `vars/counters`, `time/time`, `time/date`, `settings/potato` — `VneEventPayloadMap` + `VneEventResultMap` на `SUBSCRIBE_EVENTS`; payload/result-типы в contracts (flags/counters промоут из plugins). API: payload/result types на событиях `VARS`, `VARS_FLAGS`, `VARS_COUNTERS`, `TIME`, `DATE`, `POTATO`.
+- `text/*` contracts (`text`, `locs`, `inject`, `wall`, `smooth`, `meet`) — `VneEventPayloadMap` + `VneEventResultMap` на все `SUBSCRIBE_EVENTS`; payload/result-типы в contracts (промоут из plugins). API: payload/result types на событиях `TEXT`, `LOCS`, `TEXT_INJECT`, `TEXT_WALL`, `TEXT_SMOOTH`, `TEXT_MEET`.
+- `module.handlers` — `EmitHandler` return: `void | Promise<unknown>` (вместо `Promise<void>`), чтобы хендлеры могли `return this.emit(...)`. API: `EmitHandler`.
+- `scenario/*` contracts (кроме `random`) — `VneEventPayloadMap` + `VneEventResultMap` на все `SUBSCRIBE_EVENTS`; payload/result-типы в contracts. API: payload/result types на событиях `CHOOSE`, `POINT_AND_CLICK`, `QTE`, `PAUSE`, `AUTOREAD`, `HISTORY`, `FASTFORWARD`.
+- plugin `utils` — removed contract type re-exports (`export type { … } from "@vnejs/contracts…"`); import payload/handler types from the matching `@vnejs/contracts.*` package (aliases like `LogQueueItem` / `ExecDelayPayload` / `FileLoadPayload` / `MigrateHandler` → contract names `LogsEmitPayload` / `ScenarioExecDelayPayload` / `SystemFileLoadPayload` / `StateMigrateHandler`).
+- `shared` / `observer` / `module` — typed `emit` / `on` via `VneEventPayloadMap` (contracts augment event string → payload); API: `VneEventPayloadMap`, `EmitArgs`, `HandlerArgs`.
+- `shared` / `observer` / `module` — typed `emit*` return via `VneEventResultMap` (contracts augment event string → handler result); API: `VneEventResultMap`, `EmitResult`, `EmitResults`.
+- `shared` — `EmitArgs`: payload arg optional when payload type is empty-object-compatible (`{} extends Payload`); `HandlerArgs` остаётся `unknown[]` (handlers не сужаются через map).
+- `core/*` contracts (кроме `platforms`) — `VneEventPayloadMap` + `VneEventResultMap` на все `SUBSCRIBE_EVENTS`; payload/result-типы в contracts (промоут из plugins). API: payload/result types на событиях `SYSTEM`, `MEMORY`, `STACK`, `SCENARIO`, `VENDORS`, `STORAGE`, `COMPONENTS`, `MEDIA`, `INTERACT`, `LOGS`, `SETTINGS`, `STATE`.
+- `core/state` — migrate/load state: `ModuleGlobalState` (вместо отдельного `StateMigrateState`).
+- `core/system` — `ModuleGlobalState["system.version"]` (`ModuleGlobalStateSystemVersion`: `major`, `minor`).
+- `module` — `getStateSlice` всегда возвращает `TState` (`payload[name] as TState`); API: `getStateSlice(payload): TState`.
+
 ## 0.2.46
 
 - `uis.react` Cursor — `vne-cursor-target` ставится/снимается только у элементов, у которых набор под курсором реально изменился.

package/package.json

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

package/plugins/ai/ai.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.ai`.
+
 | Ключ   | Строка        | Смысл                                                   |
 | ------ | ------------- | ------------------------------------------------------- |
 | `EMIT` | `vne:ai:emit` | Request/response (`emitOne`): payload `{ type, args }`. |

package/plugins/ai/checkers.md

@@ -6,6 +6,8 @@ AI-оркестрация русских шашек: конфиг сторон,
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.ai.checkers`.
+
 | Ключ       | Строка                     | Смысл                                   |
 | ---------- | -------------------------- | --------------------------------------- |
 | `INTERACT` | `vne:checkers_ai:interact` | Ход AI (если сторона не `player`).      |

package/plugins/audio/audio.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.audio`.
+
 | Ключ             | Строка                     | Смысл                                                 |
 | ---------------- | -------------------------- | ----------------------------------------------------- |
 | `PLAY`           | `vne:audio:play`           | Запросить данные у обработчиков и продолжить цепочку. |

package/plugins/canvas/bg.md

@@ -27,6 +27,8 @@ $ bl.bg show {castle/surgery_room} opacity 500
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.canvas.child.bg`.
+
 | Ключ            | Строка                       | Смысл                                                 |
 | --------------- | ---------------------------- | ----------------------------------------------------- |
 | `SHOW`          | `vne:layer_bg:show`          | Запросить данные у обработчиков и продолжить цепочку. |

package/plugins/canvas/bg.speak.md

@@ -8,6 +8,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.canvas.child.bg.speak`.
+
 | Ключ             | Строка                              | Смысл                                                 |
 | ---------------- | ----------------------------------- | ----------------------------------------------------- |
 | `PUSH`           | `vne:layer_bg_speak:push`           | Добавить элемент в очередь или стек.                  |

package/plugins/canvas/fill.md

@@ -16,6 +16,8 @@ $ bl.fill hide fillId1 300
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.canvas.child.fill`.
+
 | Ключ           | Строка                        | Смысл                                  |
 | -------------- | ----------------------------- | -------------------------------------- |
 | `SHOW`         | `vne:layer_fill:show`         | Показать заливку по `id` и цвету.      |

package/plugins/canvas/layer.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.canvas.layer`.
+
 | Ключ            | Строка                    | Смысл                                      |
 | --------------- | ------------------------- | ------------------------------------------ |
 | `UPDATE_FORCE`  | `vne:layer:update_force`  | Обновить состояние или отображение.        |

package/plugins/canvas/sprite.md

@@ -28,6 +28,8 @@ $ ul.sprite show co left {co/default} opacity 500
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.canvas.child.sprite`.
+
 | Ключ           | Строка                          | Смысл                                                 |
 | -------------- | ------------------------------- | ----------------------------------------------------- |
 | `SHOW`         | `vne:layer_sprite:show`         | Запросить данные у обработчиков и продолжить цепочку. |

package/plugins/canvas/sprite.speak.md

@@ -8,6 +8,8 @@ Args спрайта могут содержать `overlays` (как у [sprite.
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.canvas.child.sprite.speak`.
+
 | Ключ         | Строка                              | Смысл                                                 |
 | ------------ | ----------------------------------- | ----------------------------------------------------- |
 | `PUSH`       | `vne:layer_sprite_speak:push`       | Добавить элемент в очередь или стек.                  |

package/plugins/canvas/text.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.canvas.child.text`.
+
 | Ключ           | Строка                        | Смысл                                                 |
 | -------------- | ----------------------------- | ----------------------------------------------------- |
 | `SHOW`         | `vne:layer_text:show`         | Запросить данные у обработчиков и продолжить цепочку. |

package/plugins/canvas/video.md

@@ -16,6 +16,8 @@ $ bl.video show {logo} … then bg {castle/surgery_room} …
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.canvas.child.video`.
+
 | Ключ           | Строка                         | Смысл                                                 |
 | -------------- | ------------------------------ | ----------------------------------------------------- |
 | `SHOW`         | `vne:layer_video:show`         | Запросить данные у обработчиков и продолжить цепочку. |

package/plugins/canvas.layers/bl.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.canvas.layers.bl`.
+
 | Ключ     | Строка                | Смысл                               |
 | -------- | --------------------- | ----------------------------------- |
 | `UPDATE` | `vne:layer_bl:update` | Обновить состояние или отображение. |

package/plugins/canvas.layers/fl.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.canvas.layers.fl`.
+
 | Ключ     | Строка                | Смысл                               |
 | -------- | --------------------- | ----------------------------------- |
 | `UPDATE` | `vne:layer_fl:update` | Обновить состояние или отображение. |

package/plugins/canvas.layers/ml.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.canvas.layers.ml`.
+
 | Ключ     | Строка                | Смысл                               |
 | -------- | --------------------- | ----------------------------------- |
 | `UPDATE` | `vne:layer_ml:update` | Обновить состояние или отображение. |

package/plugins/canvas.layers/ul.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.canvas.layers.ul`.
+
 | Ключ     | Строка                | Смысл                               |
 | -------- | --------------------- | ----------------------------------- |
 | `UPDATE` | `vne:layer_ul:update` | Обновить состояние или отображение. |

package/plugins/canvas.props/animation.md

@@ -6,6 +6,8 @@ CSS-анимация canvas-слоя с сохранением в state.
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.canvas.props.animation`.
+
 | Ключ    | Строка                      | Смысл                              |
 | ------- | --------------------------- | ---------------------------------- |
 | `SET`   | `vne:layer_animation:set`   | Записать или обновить значение.    |

package/plugins/canvas.props/clip.md

@@ -6,6 +6,8 @@ CSS clip-path canvas-слоя с плавной сменой.
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.canvas.props.clip`.
+
 | Ключ    | Строка                 | Смысл                              |
 | ------- | ---------------------- | ---------------------------------- |
 | `SET`   | `vne:layer_clip:set`   | Записать или обновить значение.    |

package/plugins/canvas.props/filters.md

@@ -1,12 +1,17 @@
 # plugins/canvas.props/filters/
 
-Пакет: `@vnejs/plugins.canvas.props.filters` · namespace: `UNKNOWN`
+Пакет: `@vnejs/plugins.canvas.props.filters` · namespace: `LAYER_FILTER`
 
 CSS filter canvas-слоя с плавной сменой.
 
 ## События
 
-Нет.
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.canvas.props.filter`.
+
+| Ключ    | Строка                   | Смысл                           |
+| ------- | ------------------------ | ------------------------------- |
+| `SET`   | `vne:layer_filter:set`   | Записать или обновить значение. |
+| `UNSET` | `vne:layer_filter:unset` | Снять filter со слоя.           |
 
 ## Константы
 

package/plugins/canvas.props/mask.md

@@ -6,6 +6,8 @@ CSS mask canvas-слоя с анимированной сменой параме
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.canvas.props.mask`.
+
 | Ключ     | Строка                  | Смысл                               |
 | -------- | ----------------------- | ----------------------------------- |
 | `SET`    | `vne:layer_mask:set`    | Записать или обновить значение.     |

package/plugins/canvas.props/scale.md

@@ -6,6 +6,8 @@ CSS scale и transform-origin canvas-слоя.
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.canvas.props.scale`.
+
 | Ключ    | Строка                  | Смысл                              |
 | ------- | ----------------------- | ---------------------------------- |
 | `SET`   | `vne:layer_scale:set`   | Записать или обновить значение.    |

package/plugins/common/grid.md

@@ -8,6 +8,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.common.grid`.
+
 | Ключ      | Строка             | Смысл                                                                                             |
 | --------- | ------------------ | ------------------------------------------------------------------------------------------------- |
 | `SET`     | `vne:grid:set`     | Создать/заменить `{ id, rows, columns, cells? }`. Без `cells` — пустая матрица. Затем `CHANGED`.  |

package/plugins/common/turn.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.common.turn`.
+
 | Ключ      | Строка              | Смысл                                                       |
 | --------- | ------------------- | ----------------------------------------------------------- |
 | `SET`     | `vne:turns:set`     | Записать `{ id, owner }`. Без `id` или без `owner` — no-op. |

package/plugins/controls/controls.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.controls`.
+
 | Ключ             | Строка                        | Смысл                                                       |
 | ---------------- | ----------------------------- | ----------------------------------------------------------- |
 | `EMIT`           | `vne:controls:emit`           | Инициировать действие или цикл.                             |

package/plugins/controls/cursor.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.controls.cursor`.
+
 | Ключ       | Строка                | Смысл                                                        |
 | ---------- | --------------------- | ------------------------------------------------------------ |
 | `SHOW`     | `vne:cursor:show`     | Показать UI или слой.                                        |

package/plugins/controls/gamepad.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.controls.gamepad`.
+
 | Ключ   | Строка             | Смысл                                                                   |
 | ------ | ------------------ | ----------------------------------------------------------------------- |
 | `EMIT` | `vne:gamepad:emit` | Проксировать нажатие в `CONTROLS.EMIT` (`{ keys }`) с lock `inProcess`. |

package/plugins/core/components.md

@@ -6,6 +6,8 @@ React/DOM-контейнер для монтирования view-компоне
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.core.components`.
+
 | Ключ              | Строка                           | Смысл                                                                                                                                  |
 | ----------------- | -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
 | `RENDER`          | `vne:components:render`          | Запрос на отрисовку: создаётся дочерний контейнер, вызывается переданная `renderFunc`; завершение — когда компонент вызовет `onMount`. |

package/plugins/core/interact.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.core.interact`.
+
 | Ключ       | Строка                  | Смысл                                                                                                    |
 | ---------- | ----------------------- | -------------------------------------------------------------------------------------------------------- |
 | `EMIT`     | `vne:interact:emit`     | Запуск цикла взаимодействия: если не занят — `STARTED`, параллельный вызов всех handlers, затем `ENDED`. |

package/plugins/core/logs.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.core.logs`.
+
 | Ключ    | Строка           | Смысл                                                                                                      |
 | ------- | ---------------- | ---------------------------------------------------------------------------------------------------------- |
 | `EMIT`  | `vne:logs:emit`  | Поставить запись в очередь логов (если логирование включено); затем сформировать `PUSH` с uid и timestamp. |

package/plugins/core/media.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.core.media`.
+
 | Ключ            | Строка                    | Смысл                                                                                                                     |
 | --------------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
 | `GET`           | `vne:media:get`           | Получить готовый медиа-элемент: из кэша или через цепочку load. Битый или отсутствующий asset → `null`, без вечного wait. |

package/plugins/core/memory.md

@@ -6,6 +6,8 @@ In-memory кэш с reference counting по namespace модуля; исполь
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.core.memory`.
+
 | Ключ      | Строка               | Смысл                                                                                                                                              |
 | --------- | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `GET`     | `vne:memory:get`     | Получить значение по `module` + `key`; сбросить счётчик ссылок до `initCounter`.                                                                   |

package/plugins/core/scenario.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.core.scenario`.
+
 | Ключ            | Строка                       | Смысл                                                                                                          |
 | --------------- | ---------------------------- | -------------------------------------------------------------------------------------------------------------- |
 | `EXEC`          | `vne:scenario:exec`          | Выполнить строку сценария: dispatch по module/block с line, args и keywords.                                   |

package/plugins/core/settings.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.core.settings`.
+
 | Ключ      | Строка                | Смысл                                                                                                                 |
 | --------- | --------------------- | --------------------------------------------------------------------------------------------------------------------- |
 | `SET`     | `vne:settings:set`    | Установить значение настройки по `name`, сохранить в storage, emit `CHANGED`. Payload: `{ name?, value?, options? }`. |
@@ -26,10 +28,10 @@
 
 ## Модули
 
-| Модуль          | Зона ответственности                                                  |
-| --------------- | --------------------------------------------------------------------- |
+| Модуль          | Зона ответственности                                                                 |
+| --------------- | ------------------------------------------------------------------------------------ |
 | `settings`      | Load из storage при `setup` (`ensureReady`); `SET` / `INIT` тоже ждут `ensureReady`. |
-| `settings.logs` | Логирование set/init/changed.                                         |
+| `settings.logs` | Логирование set/init/changed.                                                        |
 
 ## Близкие плагины
 

package/plugins/core/stack.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.core.stack`.
+
 | Ключ                   | Строка                           | Смысл                                                                                                                                                                                                                            |
 | ---------------------- | -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `EMIT`                 | `vne:stack:emit`                 | Перейти на метку: сброс `curLine`, clone args, preload label, **await** `MEMORY.CLEAR` (до возврата из `EMIT`). Payload: `{ label?, args? }`. Перед переходом — `PROHIBIT_REPLACE`; при запрете — `PROHIBITED`, без `LABEL_GET`. |

package/plugins/core/state.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.core.state`.
+
 | Ключ          | Строка                  | Смысл                                                                                    |
 | ------------- | ----------------------- | ---------------------------------------------------------------------------------------- |
 | `GET`         | `vne:state:get`         | Снять snapshot `globalState` (clone, пустые slice модулей отфильтровываются).            |

package/plugins/core/storage.md

@@ -31,6 +31,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.core.storage`.
+
 | Ключ      | Строка                | Смысл                                                                                |
 | --------- | --------------------- | ------------------------------------------------------------------------------------ |
 | `SET`     | `vne:storage:set`     | Записать ключ (`module`, опционально `group`, `key`); emit `CHANGED`.                |
@@ -69,13 +71,13 @@
 
 ## Модули
 
-| Модуль            | Зона ответственности                            |
-| ----------------- | ----------------------------------------------- |
+| Модуль            | Зона ответственности                                              |
+| ----------------- | ----------------------------------------------------------------- |
 | `storage`         | localforage в `setup` / `ensureReady`; `KEYS`, `CHANGED`, `INIT`. |
-| `storage.get`     | `GET` / `GET_ALL`.                              |
-| `storage.set`     | `SET` / `SET_ALL`.                              |
-| `storage.rm`      | `RM` / `RM_ALL`.                                |
-| `storage.actions` | Import / export / clear с file picker и reload. |
+| `storage.get`     | `GET` / `GET_ALL`.                                                |
+| `storage.set`     | `SET` / `SET_ALL`.                                                |
+| `storage.rm`      | `RM` / `RM_ALL`.                                                  |
+| `storage.actions` | Import / export / clear с file picker и reload.                   |
 
 ## Близкие плагины
 

package/plugins/core/system.md

@@ -6,15 +6,17 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.core.system`.
+
 | Ключ           | Строка                    | Смысл                                                       |
 | -------------- | ------------------------- | ----------------------------------------------------------- |
 | `RESIZE`       | `vne:system:resize`       | Изменились размеры окна приложения.                         |
-| `RELOAD`       | `vne:system:reload`       | Перезагрузка страницы после фазы `CLOSE_BEFORE`.                     |
-| `FULLSCREEN`   | `vne:system:fullscreen`   | Переключение полноэкранного режима документа.                        |
-| `CLOSE`        | `vne:system:close`        | Закрытие окна приложения после фазы `CLOSE_BEFORE`.                  |
-| `CLOSE_BEFORE` | `vne:system:close_before` | Фаза подготовки перед закрытием или перезагрузкой страницы.          |
-| `FILE_LOAD`    | `vne:file:load`           | Скачать объект как JSON-файл. Payload: `{ obj?, name? }`.            |
-| `FILE_READ`    | `vne:file:read`           | File picker → parse JSON → вернуть содержимое.                       |
+| `RELOAD`       | `vne:system:reload`       | Перезагрузка страницы после фазы `CLOSE_BEFORE`.            |
+| `FULLSCREEN`   | `vne:system:fullscreen`   | Переключение полноэкранного режима документа.               |
+| `CLOSE`        | `vne:system:close`        | Закрытие окна приложения после фазы `CLOSE_BEFORE`.         |
+| `CLOSE_BEFORE` | `vne:system:close_before` | Фаза подготовки перед закрытием или перезагрузкой страницы. |
+| `FILE_LOAD`    | `vne:file:load`           | Скачать объект как JSON-файл. Payload: `{ obj?, name? }`.   |
+| `FILE_READ`    | `vne:file:read`           | File picker → parse JSON → вернуть содержимое.              |
 
 ## Константы
 
@@ -37,12 +39,12 @@
 
 ## Модули
 
-| Модуль           | Зона ответственности                                       |
-| ---------------- | ---------------------------------------------------------- |
-| `system`         | Reload, close, fullscreen, `CLOSE_BEFORE`.                 |
-| `system.resize`  | Реагирует на изменение размеров окна; инициирует `RESIZE`. |
-| `system.file`    | `FILE_LOAD` / `FILE_READ`.                                 |
-| `system.version` | Default state `{ major, minor }` для миграции сохранений.  |
+| Модуль           | Зона ответственности                                                                                                                        |
+| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
+| `system`         | Reload, close, fullscreen, `CLOSE_BEFORE`.                                                                                                  |
+| `system.resize`  | Реагирует на изменение размеров окна; инициирует `RESIZE`.                                                                                  |
+| `system.file`    | `FILE_LOAD` / `FILE_READ`.                                                                                                                  |
+| `system.version` | Default state `{ major, minor }` для миграции сохранений; slice в `ModuleGlobalState["system.version"]` (`ModuleGlobalStateSystemVersion`). |
 
 ## Близкие плагины
 

package/plugins/core/vendors.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.core.vendors`.
+
 | Ключ     | Строка               | Смысл                                                                                          |
 | -------- | -------------------- | ---------------------------------------------------------------------------------------------- |
 | `CLONE`  | `vne:vendors:clone`  | Deep clone через lodash (state, stack, args).                                                  |

package/plugins/entities/wallet.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.entities.wallet`.
+
 | Ключ      | Строка               | Смысл                              |
 | --------- | -------------------- | ---------------------------------- |
 | `ADD`     | `vne:wallet:add`     | Событие `ADD` namespace плагина.   |

package/plugins/game/checkers.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.game.checkers`.
+
 | Ключ           | Строка                      | Смысл                                                                                              |
 | -------------- | --------------------------- | -------------------------------------------------------------------------------------------------- |
 | `SHOW`         | `vne:checkers:show`         | Старт: `SET` (`cells` + `owner`) → `START`. Payload: `{ initialOwner?, initialPreset? }`.          |

package/plugins/platform/electron.md

@@ -6,7 +6,11 @@
 
 ## События
 
-Нет.
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.platform.electron`.
+
+| Ключ     | Строка                | Смысл                                      |
+| -------- | --------------------- | ------------------------------------------ |
+| `CONFIG` | `vne:electron:config` | Конфиг хоста Electron (например language). |
 
 ## Константы
 

package/plugins/platform/metric.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.platform.metric`.
+
 | Ключ     | Строка              | Смысл                               |
 | -------- | ------------------- | ----------------------------------- |
 | `GOAL`   | `vne.metric.goal`   | Событие `GOAL` namespace плагина.   |

package/plugins/rpg/damage.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.rpg.damage`.
+
 | Ключ          | Строка                   | Смысл                                    |
 | ------------- | ------------------------ | ---------------------------------------- |
 | `EMIT`        | `vne:damage:emit`        | Инициировать действие или цикл.          |

package/plugins/rpg/hit.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.rpg.hit`.
+
 | Ключ                    | Строка                          | Смысл                                              |
 | ----------------------- | ------------------------------- | -------------------------------------------------- |
 | `EMIT`                  | `vne:hit:emit`                  | Инициировать действие или цикл.                    |

package/plugins/rpg/skills.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.rpg.skills`.
+
 | Ключ          | Строка                   | Смысл                                    |
 | ------------- | ------------------------ | ---------------------------------------- |
 | `EMIT`        | `vne:skills:emit`        | Инициировать действие или цикл.          |

package/plugins/save/auto.md

@@ -6,6 +6,8 @@
 
 ## События
 
+Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.save.auto`.
+
 | Ключ   | Строка              | Смысл                             |
 | ------ | ------------------- | --------------------------------- |
 | `MAKE` | `vne:autosave:make` | Событие `MAKE` namespace плагина. |