@vnejs/docs 0.2.33 → 0.2.35

package/CHANGELOG.md

@@ -2,6 +2,44 @@
 
 Краткая история изменений движка (плагины, helpers, packages, CLI и прочий runtime) и внешнего API. Версии — релизы пакета `@vnejs/docs`.
 
+## 0.2.35
+
+- `module.controller.arrows.grid` — `cachedItemsCount` не считает слоты с `isStub`; после `GRID_UPDATE_ITEMS` невалидные `gridRow` / `gridColumn` (в т.ч. stub после смены `gridIndex`) сдвигаются на ближайшую валидную ячейку. API: `getGridItemsCount`, `snapSelectionToGrid`, `findNearestValidCell`.
+- `views/settings` — константа ключа вкладки дефолтных настроек. API: `CONST.SETTINGS_VIEW.DEFAULT_TAB` (`"DEFAULT"`).
+- `views.screens/settings` — показ полей на `SHOW_BEFORE` в `settings.screen.controller.fields` (`STATE_UPDATE` tabs/tab → `SETTINGS_VIEW.SHOW`); main только эмитит `SHOW_BEFORE` и `HIDE` → `SETTINGS_VIEW.HIDE`.
+- `views.screens/settings.defaults` — показ полей на `SHOW_BEFORE` в `settings.default.controller.fields` с `CONST.SETTINGS_VIEW.DEFAULT_TAB`.
+- `module.controller.bg` — база статичного фона `@vnejs/module.controller.bg`: `SHOW_BEFORE` → `STATE_UPDATE` `{ bgSrc }`; опционально `EVENT_PRELOAD` / `start` / `STATE.CLEAR`; `MEMORY.CLEARED` — флаги preload и/или refresh при `isShow`. Abstract: `EVENT_SHOW` / `HIDE` / `SHOW_BEFORE` / `STATE_UPDATE` / `UPDATE_FAST`, `BGNAME`, `QUALITY_SETTING`. API: `IS_START_PRELOAD_ENABLED`, `IS_STATE_CLEAR_PRELOAD_ENABLED`, `IS_MEMORY_CLEARED_PRELOAD_ENABLED`, `IS_MEMORY_CLEARED_UPDATE_ENABLED`, `loadBg`.
+- `views.screens/gallery` — фон вынесен в `gallery.controller.bg`; main `beforeShow` эмитит `SHOW_BEFORE`, затем `TAB_SET`. API: `EVENTS.GALLERY.SHOW_BEFORE`.
+- `views.screens/save` — фон в `save.controller.bg` (`PRELOAD` / `start` / `MEMORY.CLEARED`); main `beforeShow` → `SHOW_BEFORE` + `TAB_SET`. API: `EVENTS.SAVE_VIEW.SHOW_BEFORE`.
+- `views.screens/settings` — фон в `settings.screen.controller.bg`; API: `EVENTS.SETTINGS_SCREEN_VIEW.SHOW_BEFORE`, `EVENTS.SETTINGS_SCREEN_VIEW.UPDATE_FAST`.
+- `views.screens/settings.defaults` — фон в `settings.default.controller.bg`; API: `EVENTS.SETTINGS_DEFAULT_VIEW.SHOW_BEFORE`, `EVENTS.SETTINGS_DEFAULT_VIEW.STATE_UPDATE`, `EVENTS.SETTINGS_DEFAULT_VIEW.UPDATE_FAST`.
+- `views.screens/intro` — фон в `intro.controller.bg` (`start` preload); API: `EVENTS.INTRO.SHOW_BEFORE`, `EVENTS.INTRO.STATE_UPDATE`, `EVENTS.INTRO.UPDATE_FAST`.
+- `views.screens/loading` — фон в `loading.controller.bg` (`start` / `MEMORY.CLEARED`); API: `EVENTS.LOADING.SHOW_BEFORE`, `EVENTS.LOADING.STATE_UPDATE`, `EVENTS.LOADING.UPDATE_FAST`.
+- `views.screens/mainmenu` — начальный фон в `mainmenu.controller.bg` (`start` / `STATE.CLEAR`); ротация по-прежнему `mainmenu.backgrounds`. API: `EVENTS.MAINMENU.SHOW_BEFORE`.
+- `module.controller.tabs` — abstract `EVENT_STATE_UPDATE`; entrypoint `onTabSetEvent` (guard пустого / того же tab) → `applyTab` (`STATE_UPDATE` `{ tab }`) → abstract `onTabSet` (как `onAccept`). API: `EVENT_STATE_UPDATE`, `applyTab`, `onTabSetEvent`, `onTabSet`.
+- `module.controller.pages` — база пагинации `@vnejs/module.controller.pages`: `PAGE_SET` / `PAGE_NEXT` / `PAGE_PREV` → `setPage` → abstract `applyPage` + `UPDATE_FAST`. Стейт `pageIndex` / `pagesCount`. Abstract: `EVENT_PAGE_SET` / `PAGE_NEXT` / `PAGE_PREV` / `STATE_UPDATE` / `UPDATE_FAST`, `applyPage`. API: `setPage`, `onPageSet`, `onPageNext`, `onPagePrev`, `applyPage`.
+- `views.screens/gallery` — `gallery.controller.pages.items` на `PAGE_ITEMS_GET` (`vne:gallery:page_items_get`) собирает UI-слот (`CHECK` + media); вместо `ITEM_CREATE` / `vne:gallery:item_create`. Call-sites: grid `getGridItems`, preload. API: `EVENTS.GALLERY.PAGE_ITEMS_GET`.
+- `views.screens/gallery` — `gallery.controller.preload`: PRELOAD / `MEMORY.CLEARED` предзагружают контент вкладок через `PAGE_ITEMS_GET`; фон — `gallery.controller.bg`.
+- `views.screens/save` / `views.screens/gallery` — `isDisableGridChangeVertical = true` в `*.controller.grid`: вертикальные стрелки не эмитят `GRID_NEXT`/`PREV` (не листают страницы); горизонталь по-прежнему может.
+- `views.screens/save` — `save.controller.actions`: `CREATE` → `SAVE.CREATE`, `DELETE` → `SAVE.DELETE`; `group` из payload или `getSaveGroup` (autosave / `pageIndex`); затем `GRID_UPDATE_ITEMS` + `UPDATE_FAST`. Main — SHOW/HIDE/PRELOAD.
+- `views.screens/save` — `save.controller.pages` наследует `@vnejs/module.controller.pages`; `EVENT_PAGE_NEXT`/`PREV` = `GRID_NEXT`/`PREV`; `applyPage` → `STATE_UPDATE` `{ gridIndex, gridsCount }` + `GRID_UPDATE_ITEMS`; стейт `pageIndex` / `pagesCount`; `PAGE_SET` `{ pageIndex }`; `init` пишет `pagesCount`. Main — SHOW/HIDE/PRELOAD. API: `EVENTS.SAVE_VIEW.PAGE_SET` payload `{ pageIndex }`.
+- `views.screens/save` — `TAB_SET` обрабатывает `save.controller.tabs` (`pageIndex: 0`, `GRID_CLEAR`, `STATE_UPDATE` `{ gridIndex, gridsCount }`, `GRID_UPDATE_ITEMS`, опционально `UPDATE_FAST`). `beforeShow` эмитит `TAB_SET` с `isForce` / `isUpdateView: false`.
+- `views.screens/gallery` — `gallery.controller.pages` наследует `@vnejs/module.controller.pages`; `EVENT_PAGE_NEXT`/`PREV` = `GRID_NEXT`/`PREV`; `applyPage` → `STATE_UPDATE` `{ gridIndex, gridsCount }` + `GRID_UPDATE_ITEMS` + `MEMORY.CLEAR`; стейт `pageIndex` / `pagesCount` (вместо `currentPage` / `pages`); `PAGE_SET` `{ pageIndex }`; tabs пишет `pagesCount` при `TAB_SET`. Main — SHOW/HIDE/PRELOAD. API: `EVENTS.GALLERY.PAGE_SET` payload `{ pageIndex }`.
+- `views.screens/gallery` — `gallery.controller.grid` на `@vnejs/module.controller.arrows.grid`; стейт `gridRow` / `gridColumn` / `gridItems` (вместо `current*`); `TAB_SET` в tabs: `GRID_CLEAR` + `STATE_UPDATE` `{ gridIndex, gridsCount }` + `GRID_UPDATE_ITEMS` + опционально `UPDATE_FAST`. `MEMORY.CLEAR` / `UPDATE_FAST` только при `isUpdateView` (не в `beforeShow`), чтобы SHOW не попадал под `viewForceAnimationSources`. API: `EVENTS.GALLERY.UPDATE_FAST`, `EVENTS.GALLERY.GRID_NEXT`, `EVENTS.GALLERY.GRID_PREV`, `EVENTS.GALLERY.GRID_CLEAR`, `EVENTS.GALLERY.GRID_UPDATE_ITEMS`, `EVENTS.GALLERY.PAGE_ITEMS_GET`.
+- `views.screens/settings` — `TAB_SET` в `settings.screen.controller.tabs` (`applyTab` + `SETTINGS_VIEW.TAB_SET` + `UPDATE_FAST`); main на `STATE_UPDATE` только `updateState`. API: `EVENTS.SETTINGS_SCREEN_VIEW.STATE_UPDATE`.
+- `module.controller.arrows.grid` — база сеточной навигации `@vnejs/module.controller.arrows.grid`: четыре стрелки, PUSH/POP на SHOW/HIDE, `STATE_UPDATE` `{ gridRow, gridColumn }` + `UPDATE_FAST`, на краю — `GRID_NEXT` / `GRID_PREV`, сброс позиции — `GRID_CLEAR` (`gridRow` / `gridColumn` → `null` + `STATE_UPDATE`). Abstract: `EVENT_SHOW` / `HIDE` / `STATE_UPDATE` / `UPDATE_FAST` / `GRID_NEXT` / `GRID_PREV` / `GRID_CLEAR`, `CONTROLS_ZINDEX`, `getMaxRows` / `getMaxColumns`. `STATE_UPDATE` зеркалит стейт (`updateState`) и кэш. `GRID_UPDATE_ITEMS` без payload → `getGridItems` из стейта → `STATE_UPDATE` `{ gridItems }`. Флаги `isDisableGridChangeHorizontal` / `isDisableGridChangeVertical` (по умолчанию `false`).
+- `views.screens/save` — `save.controller.grid` наследует `@vnejs/module.controller.arrows.grid`. Внутри сетки — `STATE_UPDATE` с `{ gridRow, gridColumn }` и `UPDATE_FAST`; на краю — `GRID_NEXT` / `GRID_PREV` (`save.controller.pages` мапит на пагинацию); смена tab — `EVENTS.SAVE_VIEW.GRID_CLEAR`. Meta сетки — `STATE_UPDATE` (`gridIndex` / `gridsCount` / `tab`); `GRID_UPDATE_ITEMS` без payload. Загрузка слотов — `getGridItems` через `emitOne(EVENTS.SAVE_VIEW.SLOT_CREATE)`. Модуль `save.view.slot` на `SLOT_CREATE` (`{ key, group, index }`) → `SAVE.GET` + дата/время. API: `EVENTS.SAVE_VIEW.UPDATE_FAST`, `EVENTS.SAVE_VIEW.GRID_NEXT`, `EVENTS.SAVE_VIEW.GRID_PREV`, `EVENTS.SAVE_VIEW.GRID_CLEAR`, `EVENTS.SAVE_VIEW.GRID_UPDATE_ITEMS`, `EVENTS.SAVE_VIEW.SLOT_CREATE`.
+- `module.controller.tabs` / `views.screens/settings` / `views.screens/gallery` — стейт вкладки: `tab` вместо `currentTab`.
+
+## 0.2.34
+
+- `scenario/pause` — логи в модуле `pause.logs`, не `emitLog` из шага. `$ pause` обрабатывает модуль `pause.scenario`: `LINE_EXEC_REG`, затем `EVENTS.PAUSE.EMIT` и `emitNext`. Блокировки — модуль `pause.emit`: в `postinject` создаёт `shared.pauseDisableSources`; `EVENTS.PAUSE.EMIT` (`vne:pause:emit`) эмитит `START`, если набор пуст. `START` больше не смотрит блокировки и не вызывает `emitNext`. `STATE.CLEAR` больше не вызывает `END`. API: `EVENTS.PAUSE.EMIT`, `CONST.PAUSE.LOGS_ACTIONS` (`EMIT` / `emit`, `START` / `start`, `END` / `end`).
+- `scenario/autoread` — постановка и сброс таймера через события, не методы модуля. `TIMEOUT_CREATE` ставит таймер на `SETTINGS.AUTOREAD.DELAY` и по нему эмитит `AUTOREAD.EMIT`. `TIMEOUT_CLEAR` снимает таймер. PUSH / POP / `STATE.SET` / `STATE.CLEAR` идут через эти события. Шаг авточтения — модуль `autoread.emit` на `EVENTS.AUTOREAD.EMIT` (`vne:autoread:emit`). Таймер — модуль `autoread.timeout` (`TIMEOUT_CREATE` / `TIMEOUT_CLEAR`; `STATE.CLEAR` → `TIMEOUT_CLEAR`, `STATE.SET` → `TIMEOUT_CLEAR` затем `TIMEOUT_CREATE`). Блокировки — модуль `autoread.sources`: `postinject` создаёт `shared.autoreadDisableSources`, `PUSH` / `POP` меняют набор, `STATE.SET` его очищает. Вместо `EVENTS.AUTOREAD.TRY` (`vne:autoread:try`). Логи — модуль `autoread.logs`, не `emitLog` из шага. `CONST.AUTOREAD.LOGS_ACTIONS`: `EMIT` (`emit`), `PUSH` (`push`), `POP` (`pop`), `TIMEOUT_CREATE` (`timeout_create`), `TIMEOUT_CLEAR` (`timeout_clear`). `PUSH` / `POP` пишут `source`. API: `EVENTS.AUTOREAD.EMIT`, `EVENTS.AUTOREAD.TIMEOUT_CREATE`, `EVENTS.AUTOREAD.TIMEOUT_CLEAR`, `CONST.AUTOREAD.LOGS_ACTIONS`.
+- `scenario/history` — журнал снапшотов вынесен из экрана (`@vnejs/plugins.scenario.history`). Шаг назад — `EVENTS.HISTORY.BACK`; запись — `EVENTS.HISTORY.ADD` / `GET` / `SET` / `LOAD` / `KEYS` / `KEYS_UPDATE`. Снапшот в память — `EVENTS.HISTORY.SET` (`{ uid, value }`), не прямой `MEMORY.SET`. Прогрев ключей — `EVENTS.HISTORY.KEYS_UPDATE`. Флаг загрузки — `shared.isHistoryLoadInProcess`, не поле модуля. Логи — `CONST.HISTORY.LOGS_ACTIONS` (`ADD`, `LOAD_START`, `LOAD_DELETED`, `LOAD_END`). `PARAMS.HISTORY.MAX_LENGTH`. Мост к `MEMORY` — модуль `history.memory` (`MEMORY.REG` / `GET` / `SET` / `KEYS`, ключ `module: this.name`). Загрузка снапшота — модуль `history.load` (`EVENTS.HISTORY.LOAD`, флаг `shared.isHistoryLoadInProcess`). Шаг назад — модуль `history.back` (`EVENTS.HISTORY.BACK`, последняя запись из `globalState.history`). Плагин и связки записи — в `bundles/vn.skeleton`. Вместо `HISTORY.ADD` с экрана `views.screens/history`.
+- `views.screens/history` — экран журнала: namespace `HISTORY_VIEW` (`@vnejs/plugins.views.screens.history`), в `bundles/vn.base`. API: `EVENTS.HISTORY_VIEW.SHOW`, `EVENTS.HISTORY_VIEW.HIDE`, `EVENTS.HISTORY_VIEW.CLICK`, `EVENTS.HISTORY_VIEW.UPDATE`, `EVENTS.HISTORY_VIEW.STATE_UPDATE`, `EVENTS.HISTORY_VIEW.UPDATE_FAST`, `EVENTS.HISTORY_VIEW.ACCEPT`, `PARAMS.HISTORY_VIEW.ZINDEX`, `PARAMS.HISTORY_VIEW.TRANSITION`, `PARAMS.HISTORY_VIEW.LOC_LABEL`, `PARAMS.HISTORY_VIEW.VIEW_PROPS`. Вместо `EVENTS.HISTORY.SHOW` и остальных view-событий `HISTORY`.
+- `compatibility/text/scenario.history` — `@vnejs/compatibility.text-with-scenario.history` вместо `@vnejs/compatibility.text-with-views.screens.history`. На `TEXT.EMIT_NEXT` эмитит `EVENTS.HISTORY.ADD`.
+- `compatibility/scenario.choose/scenario.history` — `@vnejs/compatibility.scenario.choose-with-scenario.history` вместо `@vnejs/compatibility.scenario.choose-with-views.screens.history`. На `CHOOSE.OPTION_BEFORE_REG` эмитит `EVENTS.HISTORY.ADD` с `{ locKey: "choice" }`.
+
 ## 0.2.33
 
 - `views.scenario/point_and_click` — `SETTINGS.CHANGED` обновляет view только при `state.isShow` (`point_and_click_view.controller`).

package/architecture.md

@@ -136,8 +136,12 @@ flowchart TD
   MCT["@vnejs/module.controller.tabs"]
   MCP["@vnejs/module.controller.preload"]
   MCB["@vnejs/module.controller.backgrounds"]
+  MCBG["@vnejs/module.controller.bg"]
   MCAC["@vnejs/module.controller.accept"]
   MCAV["@vnejs/module.controller.arrows.vertical"]
+  MCAH["@vnejs/module.controller.arrows.horizontal"]
+  MCAG["@vnejs/module.controller.arrows.grid"]
+  MCPG["@vnejs/module.controller.pages"]
   MCHS["@vnejs/module.controller.hide.on.state"]
   MCHC["@vnejs/module.controller.hide.on.controls"]
   MSC["@vnejs/module.scales.common"]
@@ -152,33 +156,41 @@ flowchart TD
   MC --> MCT
   MC --> MCP
   MC --> MCB
+  MC --> MCBG
   MC --> MCAC
   MC --> MCAV
+  MC --> MCAH
+  MC --> MCAG
+  MC --> MCPG
   MC --> MCHS
   MC --> MCHC
   MC --> MSC
   MCO --> ML
 ```
 
-| Пакет                                           | Назначение                                                                                                  |
-| ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
-| **`@vnejs/module`**                             | **`Module`**: `VNE`, `on`/`emit`, `inject`, state, shared, media, lifecycle                                 |
-| **`@vnejs/module.core`**                        | **`ModuleCore`** — типизированный доступ к **core-контрактам**; `emitLog`, `emitNext`, …                    |
-| **`@vnejs/module.handlers`**                    | **`ModuleHandlers`** — параллельные обработчики emit-событий с приоритетами (side effects)                  |
-| **`@vnejs/module.replace`**                     | **`ModuleReplace`** — последовательная подмена значения поля payload через `REPLACE_KEY` и цепочку handlers |
-| **`@vnejs/module.replace.exec`**                | **`ModuleReplaceExec`** — реестр exec-handlers по имени модуля (`EXEC_REG` / `EXEC_GET`)                    |
-| **`@vnejs/module.components`**                  | **`ModuleView`**, **`ModuleController`** — React-view, zustand, media, controls                             |
-| **`@vnejs/module.layer`**                       | Canvas layers: controller, image, sprite, text, video, props, view                                          |
-| **`@vnejs/module.audio`**                       | База для audio-плагинов scenario-слоёв (`music` / `sound` / …)                                              |
-| **`@vnejs/module.controller.audio`**            | Overlay-BGM для view-экранов: pause global / play `view` / resume на SHOW/HIDE/PRELOAD                      |
-| **`@vnejs/module.controller.tabs`**             | Навигация по вкладкам view-экранов: TAB_PREV/TAB_NEXT → `TAB_SET`, PUSH/POP controls на SHOW/HIDE           |
-| **`@vnejs/module.controller.preload`**          | Предзагрузка меток и событий экрана по SHOW / PRELOAD / MEMORY.CLEARED; SHOW/HIDE/PRELOAD задаёт плагин     |
-| **`@vnejs/module.controller.backgrounds`**      | Ротация списка фонов по SHOW / таймеру / MEMORY.CLEARED; стоп на HIDE; события и список задаёт плагин       |
-| **`@vnejs/module.controller.accept`**           | ACCEPT / INTERACT → событие ACCEPT плагина; PUSH/POP controls на SHOW/HIDE                                  |
-| **`@vnejs/module.controller.arrows.vertical`**  | ARROW_UP / ARROW_BOTTOM по видимым пунктам; PUSH/POP controls на SHOW/HIDE                                  |
-| **`@vnejs/module.controller.hide.on.state`**    | STATE.SET / STATE.CLEAR → emit HIDE плагина (`isForce` задаёт наследник)                                    |
-| **`@vnejs/module.controller.hide.on.controls`** | BACK / MENU / GAMEMENU → emit HIDE плагина; PUSH/POP controls на SHOW/HIDE                                  |
-| **`@vnejs/module.scales.common`**               | База для scales / RPG-модулей                                                                               |
+| Пакет                                            | Назначение                                                                                                                                        |
+| ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **`@vnejs/module`**                              | **`Module`**: `VNE`, `on`/`emit`, `inject`, state, shared, media, lifecycle                                                                       |
+| **`@vnejs/module.core`**                         | **`ModuleCore`** — типизированный доступ к **core-контрактам**; `emitLog`, `emitNext`, …                                                          |
+| **`@vnejs/module.handlers`**                     | **`ModuleHandlers`** — параллельные обработчики emit-событий с приоритетами (side effects)                                                        |
+| **`@vnejs/module.replace`**                      | **`ModuleReplace`** — последовательная подмена значения поля payload через `REPLACE_KEY` и цепочку handlers                                       |
+| **`@vnejs/module.replace.exec`**                 | **`ModuleReplaceExec`** — реестр exec-handlers по имени модуля (`EXEC_REG` / `EXEC_GET`)                                                          |
+| **`@vnejs/module.components`**                   | **`ModuleView`**, **`ModuleController`** — React-view, zustand, media, controls                                                                   |
+| **`@vnejs/module.layer`**                        | Canvas layers: controller, image, sprite, text, video, props, view                                                                                |
+| **`@vnejs/module.audio`**                        | База для audio-плагинов scenario-слоёв (`music` / `sound` / …)                                                                                    |
+| **`@vnejs/module.controller.audio`**             | Overlay-BGM для view-экранов: pause global / play `view` / resume на SHOW/HIDE/PRELOAD                                                            |
+| **`@vnejs/module.controller.tabs`**              | Навигация по вкладкам: TAB_PREV/TAB_NEXT → `TAB_SET`; guard + `applyTab` (`STATE_UPDATE` `{ tab }`) + abstract `onTabSet`; PUSH/POP на SHOW/HIDE  |
+| **`@vnejs/module.controller.preload`**           | Предзагрузка меток и событий экрана по SHOW / PRELOAD / MEMORY.CLEARED; SHOW/HIDE/PRELOAD задаёт плагин                                           |
+| **`@vnejs/module.controller.backgrounds`**       | Ротация списка фонов по SHOW / таймеру / MEMORY.CLEARED; стоп на HIDE; события и список задаёт плагин                                             |
+| **`@vnejs/module.controller.bg`**                | Статичный фон экрана: SHOW_BEFORE → `bgSrc` в стейт; опционально PRELOAD / start / STATE.CLEAR; MEMORY.CLEARED — preload и/или refresh при isShow |
+| **`@vnejs/module.controller.accept`**            | ACCEPT / INTERACT → событие ACCEPT плагина; PUSH/POP controls на SHOW/HIDE                                                                        |
+| **`@vnejs/module.controller.arrows.vertical`**   | ARROW_UP / ARROW_BOTTOM по видимым пунктам; PUSH/POP controls на SHOW/HIDE                                                                        |
+| **`@vnejs/module.controller.arrows.horizontal`** | ARROW_LEFT / ARROW_RIGHT по пунктам; PUSH/POP controls на SHOW/HIDE                                                                               |
+| **`@vnejs/module.controller.arrows.grid`**       | Четыре стрелки по сетке; `GRID_NEXT` / `GRID_PREV` на краю; PUSH/POP на SHOW/HIDE; `GRID_UPDATE_ITEMS` без payload, meta через `STATE_UPDATE`     |
+| **`@vnejs/module.controller.pages`**             | Пагинация: `PAGE_SET` / `PAGE_NEXT` / `PAGE_PREV` → `setPage` → abstract `applyPage` + `UPDATE_FAST`; стейт `pageIndex` / `pagesCount`            |
+| **`@vnejs/module.controller.hide.on.state`**     | STATE.SET / STATE.CLEAR → emit HIDE плагина (`isForce` задаёт наследник)                                                                          |
+| **`@vnejs/module.controller.hide.on.controls`**  | BACK / MENU / GAMEMENU → emit HIDE плагина; PUSH/POP controls на SHOW/HIDE                                                                        |
+| **`@vnejs/module.scales.common`**                | База для scales / RPG-модулей                                                                                                                     |
 
 ### Принципы
 

package/package.json

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

package/plugins/scenario/autoread.md

@@ -6,15 +6,19 @@
 
 ## События
 
-| Ключ   | Строка              | Смысл                                     |
-| ------ | ------------------- | ----------------------------------------- |
-| `TRY`  | `vne:autoread:try`  | Записать диагностическое сообщение в лог. |
-| `PUSH` | `vne:autoread:push` | Добавить элемент в очередь или стек.      |
-| `POP`  | `vne:autoread:pop`  | Извлечь элемент из очереди или стека.     |
+| Ключ             | Строка                        | Смысл                                                                                                        |
+| ---------------- | ----------------------------- | ------------------------------------------------------------------------------------------------------------ |
+| `EMIT`           | `vne:autoread:emit`           | Если авточтение включено и нет блокировок — `INTERACT.EMIT` по `vne-autoread-allow`, иначе `TIMEOUT_CREATE`. |
+| `PUSH`           | `vne:autoread:push`           | Добавить источник блокировки и `TIMEOUT_CLEAR`. Payload: `{ source? }`.                                      |
+| `POP`            | `vne:autoread:pop`            | Снять источник блокировки; если очередь пуста — `TIMEOUT_CREATE`. Payload: `{ source? }`.                    |
+| `TIMEOUT_CREATE` | `vne:autoread:timeout_create` | Поставить таймер на `SETTINGS.AUTOREAD.DELAY`; по нему эмитит `EMIT`.                                        |
+| `TIMEOUT_CLEAR`  | `vne:autoread:timeout_clear`  | Снять поставленный таймер.                                                                                   |
 
 ## Константы
 
-Нет.
+| Ключ           | Смысл                                                                                                                                     |
+| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
+| `LOGS_ACTIONS` | Метки для логов: `EMIT` (`emit`), `PUSH` (`push`), `POP` (`pop`), `TIMEOUT_CREATE` (`timeout_create`), `TIMEOUT_CLEAR` (`timeout_clear`). |
 
 ## Параметры
 
@@ -32,16 +36,20 @@
 
 ## Модули
 
-| Модуль     | Зона ответственности                                                                                     |
-| ---------- | -------------------------------------------------------------------------------------------------------- |
-| `autoread` | В `postinject` — `shared.autoreadDisableSources`; `SETTINGS.INIT` в `setup`; TRY, PUSH, POP, CHANGED, …. |
+| Модуль             | Зона ответственности                                                                                                                                                             |
+| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `autoread`         | `SETTINGS.INIT` в `setup`. `SETTINGS.CHANGED` для `ENABLED` эмитит `PUSH` / `POP`.                                                                                               |
+| `autoread.logs`    | Логи всех событий `AUTOREAD` через `emitLog`. `PUSH` / `POP` пишут `source`.                                                                                                     |
+| `autoread.sources` | В `postinject` — `shared.autoreadDisableSources`. `PUSH` / `POP`. На `STATE.SET` очищает набор.                                                                                  |
+| `autoread.emit`    | `EMIT`: если включено и нет блокировок — `INTERACT.EMIT` по `vne-autoread-allow`, иначе `TIMEOUT_CREATE`.                                                                        |
+| `autoread.timeout` | `TIMEOUT_CREATE` / `TIMEOUT_CLEAR`. Таймер на `SETTINGS.AUTOREAD.DELAY`, по нему `EMIT`. `STATE.CLEAR` → `TIMEOUT_CLEAR`. `STATE.SET` → `TIMEOUT_CLEAR`, затем `TIMEOUT_CREATE`. |
 
 ## Близкие плагины
 
 ### plugins/core/
 
 - [interact.md](../core/interact.md) — `INTERACT`: EVENTS.EMIT
-- [logs.md](../core/logs.md) — `LOGS`: emitLog
+- [logs.md](../core/logs.md) — `LOGS`: `emitLog`, `CONST.LOGS.FILTER_FROM_RESULT_OPTIONS`
 - [settings.md](../core/settings.md) — `SETTINGS`: EVENTS.CHANGED, EVENTS.INIT
 - [state.md](../core/state.md) — `STATE`: EVENTS.CLEAR, EVENTS.SET
 

package/plugins/scenario/choose.md

@@ -80,11 +80,11 @@
 
 В `init` регистрирует handler на `OPTION_BEFORE_REG`: при выборе опции эмитит `FASTFORWARD.CHECK` (до `HIDE` / `OPTION_REPLACE`).
 
-### `compatibility/scenario.choose/views.screens.history/`
+### `compatibility/scenario.choose/scenario.history/`
 
-Пакет: `@vnejs/compatibility.scenario.choose-with-views.screens.history`
+Пакет: `@vnejs/compatibility.scenario.choose-with-scenario.history`
 
-В `init` регистрирует handler на `OPTION_BEFORE_REG`: при выборе опции эмитит `HISTORY.ADD` с `{ locKey: "choice" }` (без speaker/text). Текст строки берётся из локализации view history (`history.json`).
+В `init` регистрирует handler на `OPTION_BEFORE_REG`: при выборе опции эмитит `HISTORY.ADD` с `{ locKey: "choice" }` (без speaker/text). Текст строки берётся из локализации экрана history (`history.json`). Подключается в `bundles/vn.skeleton`.
 
 ### `compatibility/scenario.choose/scenario.qte/`
 
@@ -106,6 +106,6 @@
 - [text.md](../text/text.md) — `TEXT`: EVENTS.REPLACE (текст опций)
 - [qte.md](./qte.md) — `QTE`: связка через `OPTION_REPLACE` (compatibility выше)
 - [fastforward.md](./fastforward.md) — `FASTFORWARD`: связка через `OPTION_BEFORE_REG` (compatibility выше)
-- [views.screens/history.md](../views.screens/history.md) — `HISTORY`: связка через `OPTION_BEFORE_REG` → `ADD` с `locKey` (compatibility выше)
+- [history.md](./history.md) — `HISTORY`: связка через `OPTION_BEFORE_REG` → `ADD` с `locKey` (compatibility выше)
 - [views.scenario/choose.md](../views.scenario/choose.md) — `CHOOSE_VIEW`: UI выбора (слушает SHOW / HIDE)
 - [scenario/point_and_click.md](./point_and_click.md) — тот же паттерн `repeat` / `SKIP` / `SHOW` / `HIDE` / `STATE_UPDATE`

package/plugins/scenario/history.md

@@ -0,0 +1,75 @@
+# plugins/scenario/history/
+
+Пакет: `@vnejs/plugins.scenario.history` · namespace: `HISTORY`
+
+Журнал снапшотов состояния. `BACK` возвращает на последнюю запись. Экран журнала — [views.screens/history.md](../views.screens/history.md) (`HISTORY_VIEW`), в `bundles/vn.base`. Этот плагин — в `bundles/vn.skeleton`.
+
+## События
+
+| Ключ   | Строка             | Смысл                                                                                                      |
+| ------ | ------------------ | ---------------------------------------------------------------------------------------------------------- |
+| `GET`         | `vne:history:get`         | Снапшот по `uid` (`MEMORY.GET`). Payload: `{ uid? }`.                                                                                                              |
+| `SET`         | `vne:history:set`         | Записать снапшот в `MEMORY` модуля `history.memory`. Payload: `{ uid?, value? }`.                                                                                 |
+| `ADD`         | `vne:history:add`         | Снять snapshot `STATE` и добавить запись. Payload: реплика (`label`/`text`/`args`/`speaker`…) или `{ locKey }`. Пока `shared.isHistoryLoadInProcess` — игнорируется. |
+| `LOAD`        | `vne:history:load`        | Загрузить снапшот в `STATE` и перейти на `state.scenario.label` (`SCENARIO.LABEL_GET`). Payload: `{ uid? }`. На время загрузки ставит `shared.isHistoryLoadInProcess`. |
+| `BACK`        | `vne:history:back`        | `LOAD` последней записи. Пока `shared.isHistoryLoadInProcess` и на пустом журнале ничего не делает.                                                               |
+| `KEYS`        | `vne:history:keys`        | Ключи модуля `history.memory` в `MEMORY`.                                                                                                                          |
+| `KEYS_UPDATE` | `vne:history:keys_update` | Прогреть ключи: `GET` по каждому `uid` в стейте журнала.                                                                                                          |
+
+Флаг загрузки — `shared.isHistoryLoadInProcess` (ставит модуль `history.load`; в `postinject` — `false`).
+
+## Константы
+
+| Ключ           | Смысл                                                                                          |
+| -------------- | ---------------------------------------------------------------------------------------------- |
+| `LOGS_ACTIONS` | Метки для логов: `ADD` (`add`), `LOAD_START` (`load start`), `LOAD_DELETED` (`load deleted`), `LOAD_END` (`load end`). |
+
+## Параметры
+
+| Ключ         | Тип      | Смысл                                      |
+| ------------ | -------- | ------------------------------------------ |
+| `MAX_LENGTH` | `number` | Максимум записей. Значение по умолчанию: 50. |
+
+## Настройки
+
+Нет.
+
+## Модули
+
+| Модуль           | Зона ответственности                                                                 |
+| ---------------- | ------------------------------------------------------------------------------------ |
+| `history`        | ADD, KEYS_UPDATE. Стейт `{ history }`.                                                     |
+| `history.back`   | BACK. Последняя запись — `globalState.history`. Пока `shared.isHistoryLoadInProcess` и на пустом журнале ничего не делает. |
+| `history.load`   | LOAD. На время загрузки ставит `shared.isHistoryLoadInProcess`.                           |
+| `history.memory` | `MEMORY.REG` в `setup` (`module: this.name`); GET, SET, KEYS.                            |
+
+Стейт журнала — у модуля `history` (`globalState.history`). Снапшоты в `MEMORY` лежат под именем модуля `history.memory`.
+
+## Compatibility
+
+### `compatibility/text/scenario.history/`
+
+Пакет: `@vnejs/compatibility.text-with-scenario.history`
+
+На `TEXT.EMIT_NEXT` эмитит `HISTORY.ADD` с `{ label, text, args, speaker, speakerInfo }`. Маркеры `{…}` из текста снимаются. Подключается в `bundles/vn.skeleton`.
+
+### `compatibility/scenario.choose/scenario.history/`
+
+Пакет: `@vnejs/compatibility.scenario.choose-with-scenario.history`
+
+На `CHOOSE.OPTION_BEFORE_REG` эмитит `HISTORY.ADD` с `{ locKey: "choice" }`. Перевод строки — ключ `choice` в `history.json` экрана. Подключается в `bundles/vn.skeleton`.
+
+## Близкие плагины
+
+### plugins/core/
+
+- [logs.md](../core/logs.md) — `LOGS`: emitLog
+- [memory.md](../core/memory.md) — `MEMORY`: EVENTS.REG, EVENTS.SET, EVENTS.KEYS, EVENTS.GET
+- [scenario.md](../core/scenario.md) — `SCENARIO`: EVENTS.LABEL_GET
+- [state.md](../core/state.md) — `STATE`: EVENTS.SET, EVENTS.CLEAR, EVENTS.GET, EVENTS.LOAD
+
+### Остальные
+
+- [text.md](../text/text.md) — `TEXT`: `EMIT_NEXT` → `ADD` (compatibility выше)
+- [choose.md](./choose.md) — `CHOOSE`: `OPTION_BEFORE_REG` → `ADD` (compatibility выше)
+- [views.screens/history.md](../views.screens/history.md) — `HISTORY_VIEW`: экран журнала (`SHOW` / `HIDE`); читает `GET` / `KEYS` / `LOAD`

package/plugins/scenario/pause.md

@@ -6,14 +6,17 @@
 
 ## События
 
-| Ключ    | Строка            | Смысл                                     |
-| ------- | ----------------- | ----------------------------------------- |
-| `START` | `vne:pause:start` | Продвинуть сценарий к следующей строке.   |
-| `END`   | `vne:pause:end`   | Записать диагностическое сообщение в лог. |
+| Ключ    | Строка            | Смысл                                                                                           |
+| ------- | ----------------- | ----------------------------------------------------------------------------------------------- |
+| `EMIT`  | `vne:pause:emit`  | Если `shared.pauseDisableSources` пуст — `START` с `{ time? }`. Иначе ничего.                  |
+| `START` | `vne:pause:start` | Ждать клик (`INTERACT.PUSH`, ключ `pause`) или `time` мс, пока не `END`. Payload: `{ time? }`. |
+| `END`   | `vne:pause:end`   | Снять таймер, `INTERACT.POP`, завершить ожидание `START`.                                      |
 
 ## Константы
 
-Нет.
+| Ключ           | Смысл                                                                                    |
+| -------------- | ---------------------------------------------------------------------------------------- |
+| `LOGS_ACTIONS` | Метки для логов: `EMIT` (`emit`), `START` (`start`), `END` (`end`). `EMIT` пишет `time`. |
 
 ## Параметры
 
@@ -25,18 +28,20 @@
 
 ## Модули
 
-| Модуль  | Зона ответственности                                                                        |
-| ------- | ------------------------------------------------------------------------------------------- |
-| `pause` | В `postinject` — `shared.pauseDisableSources`; `LINE_EXEC_REG` в `init`; END, START, CLEAR. |
+| Модуль           | Зона ответственности                                                                                      |
+| ---------------- | --------------------------------------------------------------------------------------------------------- |
+| `pause`          | `START` ждёт `END`: клик (`INTERACT`) или таймер `time`.                                                 |
+| `pause.emit`     | В `postinject` — `shared.pauseDisableSources`. `EMIT` → `START`, если набор пуст.                        |
+| `pause.logs`     | Логи `EMIT` / `START` / `END` через `emitLog`. `EMIT` пишет `time`.                                       |
+| `pause.scenario` | `LINE_EXEC_REG` для `$ pause` в `init`. Парсит `time`, эмитит `EMIT`, затем `emitNext`.                  |
 
 ## Близкие плагины
 
 ### plugins/core/
 
 - [interact.md](../core/interact.md) — `INTERACT`: EVENTS.POP, EVENTS.PUSH
-- [logs.md](../core/logs.md) — `LOGS`: emitLog
+- [logs.md](../core/logs.md) — `LOGS`: `emitLog`, `CONST.LOGS.FILTER_FROM_RESULT_OPTIONS`
 - [scenario.md](../core/scenario.md) — `SCENARIO`: emitNext, EVENTS.LINE_EXEC_REG
-- [state.md](../core/state.md) — `STATE`: EVENTS.CLEAR
 
 ### Остальные
 

package/plugins/text/text.md

@@ -71,6 +71,12 @@
 
 Связка с [interface.md](../views.scenario/interface.md): `CHANGED` / `SPEAKER_CHANGED` / `EMIT_BEFORE` → `INTERFACE.TEXT_CHANGED` / `SPEAKER_CHANGED` / `SHOW`. В `postinject` ставит `shared.interfaceTextShowAllTokensOnChange`.
 
+### `compatibility/text/scenario.history/`
+
+Пакет: `@vnejs/compatibility.text-with-scenario.history`
+
+На `EMIT_NEXT` эмитит `HISTORY.ADD` с текстом последней реплики (маркеры `{…}` снимаются). Подключается в `bundles/vn.skeleton`.
+
 ## Близкие плагины
 
 ### plugins/core/
@@ -84,3 +90,4 @@
 ### Остальные
 
 - [interface.md](../views.scenario/interface.md) — `INTERFACE`: связка через compatibility выше
+- [history.md](../scenario/history.md) — `HISTORY`: `EMIT_NEXT` → `ADD` (compatibility выше)

package/plugins/views/settings.md

@@ -17,7 +17,9 @@
 
 ## Константы
 
-Нет.
+| Ключ          | Тип      | Смысл                                                          |
+| ------------- | -------- | -------------------------------------------------------------- |
+| `DEFAULT_TAB` | `string` | Ключ вкладки дефолтных настроек в `PARAMS.TABS` (`"DEFAULT"`). |
 
 ## Параметры
 

package/plugins/views.screens/gallery.md

@@ -10,20 +10,27 @@ ACCEPT/INTERACT эмитит `CHOOSE` только для выбранного
 
 ## События
 
-| Ключ       | Строка                 | Смысл                                    |
-| ---------- | ---------------------- | ---------------------------------------- |
-| `OPEN`     | `vne:gallery:open`     | Открыть экран или панель.                |
-| `CHECK`    | `vne:gallery:check`    | Проверить состояние или наличие ресурса. |
-| `CLEAR`    | `vne:gallery:clear`    | Очистить накопленное состояние.          |
-| `SHOW`     | `vne:gallery:show`     | Показать UI или слой.                    |
-| `HIDE`     | `vne:gallery:hide`     | Скрыть UI или слой.                      |
-| `PAGE_SET` | `vne:gallery:page_set` | Записать или обновить значение.          |
-| `TAB_SET`  | `vne:gallery:tab_set`  | Выбрать вкладку галереи (`{ tab }`).     |
-| `UPDATE`   | `vne:gallery:update`   | Обновить состояние или отображение.      |
-| `PRELOAD`  | `vne:gallery:preload`  | Событие `PRELOAD` namespace плагина.     |
-| `CHOOSE`       | `vne:gallery:choose`       | Событие `CHOOSE` namespace плагина.      |
-| `ACCEPT`       | `vne:gallery:accept`       | ACCEPT / INTERACT по выбранному слоту.   |
-| `STATE_UPDATE` | `vne:gallery:state_update` | Слить partial в стейт accept-модуля.     |
+| Ключ                | Строка                          | Смысл                                                                                                            |
+| ------------------- | ------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
+| `OPEN`              | `vne:gallery:open`              | Открыть экран или панель.                                                                                        |
+| `CHECK`             | `vne:gallery:check`             | Проверить состояние или наличие ресурса.                                                                         |
+| `CLEAR`             | `vne:gallery:clear`             | Очистить накопленное состояние.                                                                                  |
+| `SHOW`              | `vne:gallery:show`              | Показать UI или слой.                                                                                            |
+| `SHOW_BEFORE`       | `vne:gallery:show_before`       | Хук перед показом: `gallery.controller.bg` пишет `bgSrc` в стейт.                                                |
+| `HIDE`              | `vne:gallery:hide`              | Скрыть UI или слой.                                                                                              |
+| `PAGE_SET`          | `vne:gallery:page_set`          | Абсолютный прыжок пагинации UI (`{ pageIndex }`).                                                                |
+| `TAB_SET`           | `vne:gallery:tab_set`           | Выбрать вкладку галереи (`{ tab }`).                                                                             |
+| `UPDATE`            | `vne:gallery:update`            | Обновить состояние или отображение.                                                                              |
+| `UPDATE_FAST`       | `vne:gallery:update_fast`       | Перерисовать view с `isFast`, без смены стейта.                                                                  |
+| `PRELOAD`           | `vne:gallery:preload`           | Событие `PRELOAD` namespace плагина.                                                                             |
+| `CHOOSE`            | `vne:gallery:choose`            | Событие `CHOOSE` namespace плагина.                                                                              |
+| `ACCEPT`            | `vne:gallery:accept`            | ACCEPT / INTERACT по выбранному слоту.                                                                           |
+| `STATE_UPDATE`      | `vne:gallery:state_update`      | Слить partial в стейт (`grid*`, `tab`, `pageIndex` / `pagesCount`, …).                                           |
+| `GRID_NEXT`         | `vne:gallery:grid_next`         | Край сетки вперёд; `gallery.controller.pages` слушает как `EVENT_PAGE_NEXT`.                                     |
+| `GRID_PREV`         | `vne:gallery:grid_prev`         | Край сетки назад; `gallery.controller.pages` слушает как `EVENT_PAGE_PREV`.                                      |
+| `GRID_CLEAR`        | `vne:gallery:grid_clear`        | Сбросить выбор ячейки: `gridRow` / `gridColumn` → `null` (+ `STATE_UPDATE`).                                     |
+| `GRID_UPDATE_ITEMS` | `vne:gallery:grid_update_items` | Пересобрать сетку из стейта (без payload) → `STATE_UPDATE` `{ gridItems }`. Meta — заранее через `STATE_UPDATE`. |
+| `PAGE_ITEMS_GET`    | `vne:gallery:page_items_get`    | Собрать UI-слот из content (`CHECK` + media); возврат item. Вместо `ITEM_CREATE`.                                |
 
 ## Константы
 
@@ -49,16 +56,21 @@ ACCEPT/INTERACT эмитит `CHOOSE` только для выбранного
 
 ## Модули
 
-| Модуль                     | Зона ответственности                                                                                                                                                                                                                                           |
-| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `gallery.controller.audio` | Наследник `ModuleControllerAudio`: SHOW/HIDE/PRELOAD → pause global, play/stop `view`-трека; `VOLUME_SETTING = MUSIC.VOLUME`; SHOW передаёт в `AUDIO.PLAY` уже посчитанный `volume`; при `VOLUME_CHANGED` / смене `VOLUME_SETTING` — повторный `AUDIO.VOLUME`. |
-| `gallery.controller`       | Обрабатывает UPDATE, HIDE, TAB_SET, …. Стрелки в `controls` контроллера; после смены ячейки эмитит `STATE_UPDATE`.                                                                                                                                              |
-| `gallery.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CHOOSE` только если слот открыт (`isOpened`, не stub); зеркалит `STATE_UPDATE`; PUSH/POP на SHOW/HIDE.                                                                       |
-| `gallery.hide.controls`    | Наследует `@vnejs/module.controller.hide.on.controls`: `BACK` / `MENU` / `GAMEMENU` → `HIDE`; PUSH/POP на SHOW/HIDE.                                                                                                                                           |
-| `gallery.hide.state`       | Наследует `@vnejs/module.controller.hide.on.state`: `STATE.SET` / `STATE.CLEAR` → `HIDE` с `{ isForce: true }`.                                                                                                                                                |
-| `gallery.controller.tabs`  | Наследник `ModuleControllerTabs`: TAB_PREV/TAB_NEXT → `TAB_SET`; PUSH/POP controls на SHOW/HIDE.                                                                                                                                                               |
-| `gallery`                  | Обрабатывает OPEN, CHECK, CLEAR.                                                                                                                                                                                                                               |
-| `gallery.view`             | Подмодуль `view` плагина.                                                                                                                                                                                                                                      |
+| Модуль                           | Зона ответственности                                                                                                                                                                                                                                                                                                     |
+| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `gallery.controller.audio`       | Наследник `ModuleControllerAudio`: SHOW/HIDE/PRELOAD → pause global, play/stop `view`-трека; `VOLUME_SETTING = MUSIC.VOLUME`; SHOW передаёт в `AUDIO.PLAY` уже посчитанный `volume`; при `VOLUME_CHANGED` / смене `VOLUME_SETTING` — повторный `AUDIO.VOLUME`.                                                           |
+| `gallery.controller`             | SHOW/HIDE; `beforeShow` → `SHOW_BEFORE` + `TAB_SET`; `STATE_UPDATE` / `UPDATE_FAST`; пустой `controls` на `ZINDEX`.                                                                                                                                                                                                      |
+| `gallery.controller.bg`          | Наследует `@vnejs/module.controller.bg`: `SHOW_BEFORE` → `STATE_UPDATE` `{ bgSrc }`; PRELOAD → warm-cache фона; `MEMORY.CLEARED` при `isShow` → refresh `bgSrc` + `UPDATE_FAST`.                                                                                                                                         |
+| `gallery.controller.preload`     | PRELOAD — page 0 первого таба через `PAGE_ITEMS_GET`; `MEMORY.CLEARED` при `isShow` — текущая / соседние страницы + page 0 остальных табов (`getItemsOnPage` / `getMaxPagesCount` на лету).                                                                                                                              |
+| `gallery.controller.pages`       | Наследует `@vnejs/module.controller.pages`: `EVENT_*` → `GALLERY`; `EVENT_PAGE_NEXT`/`PREV` = `GRID_NEXT`/`PREV`; `applyPage` → `STATE_UPDATE` `{ gridIndex, gridsCount }` + `GRID_UPDATE_ITEMS` + `MEMORY.CLEAR`; стейт `pageIndex` / `pagesCount` (пишет tabs).                                                        |
+| `gallery.controller.pages.items` | На `PAGE_ITEMS_GET` собирает UI-слот: `CHECK` + media (`MEDIA.LOAD`); возврат item.                                                                                                                                                                                                                                      |
+| `gallery.controller.accept`      | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CHOOSE` только если слот открыт (`isOpened`, не stub); зеркалит `STATE_UPDATE` (`grid*`); PUSH/POP на SHOW/HIDE.                                                                                                                        |
+| `gallery.controller.grid`        | Наследует `@vnejs/module.controller.arrows.grid`: четыре стрелки; `isDisableGridChangeVertical = true` (вертикаль не листает страницы); на краю колонок — `GRID_NEXT`/`PREV`; `GRID_CLEAR`; на `GRID_UPDATE_ITEMS` — `getGridItems` через `PAGE_ITEMS_GET` (stub’ы только для layout; в count и snap позиции не входят). |
+| `gallery.hide.controls`          | Наследует `@vnejs/module.controller.hide.on.controls`: `BACK` / `MENU` / `GAMEMENU` → `HIDE`; PUSH/POP на SHOW/HIDE.                                                                                                                                                                                                     |
+| `gallery.hide.state`             | Наследует `@vnejs/module.controller.hide.on.state`: `STATE.SET` / `STATE.CLEAR` → `HIDE` с `{ isForce: true }`.                                                                                                                                                                                                          |
+| `gallery.controller.tabs`        | Наследник `ModuleControllerTabs`: `TAB_SET` → `applyTab` + `onTabSet` (`pageIndex: 0`, `pagesCount`, `GRID_CLEAR`, `STATE_UPDATE` `{ gridIndex, gridsCount }`, `GRID_UPDATE_ITEMS`; при `isUpdateView` — `UPDATE_FAST` + `MEMORY.CLEAR`); TAB_PREV/TAB_NEXT → `TAB_SET`.                                                 |
+| `gallery`                        | Обрабатывает OPEN, CHECK, CLEAR.                                                                                                                                                                                                                                                                                         |
+| `gallery.view`                   | Подмодуль `view` плагина.                                                                                                                                                                                                                                                                                                |
 
 ## Близкие плагины
 
@@ -68,10 +80,3 @@ ACCEPT/INTERACT эмитит `CHOOSE` только для выбранного
 - [state.md](../core/state.md) — `STATE`: EVENTS.SET, EVENTS.CLEAR
 - [storage.md](../core/storage.md) — `STORAGE`: EVENTS.SET, EVENTS.GET, EVENTS.RM_ALL
 - [system.md](../core/system.md) — `SYSTEM`: EVENTS.STARTED
-
-### Остальные
-
-- [audio.md](../audio/audio.md) — `AUDIO`: EVENTS.GLOBAL_PAUSE, EVENTS.PLAY, EVENTS.STOP, EVENTS.GLOBAL_RESUME, EVENTS.MEDIA_LOAD, EVENTS.VOLUME, EVENTS.VOLUME_CHANGED
-- [music.md](../audio/music.md) — `MUSIC`: SETTINGS.VOLUME
-- [controls.md](../controls/controls.md) — `CONTROLS`: CONST.BUTTONS.BACK, CONST.BUTTONS.MENU, CONST.BUTTONS.GAMEMENU, CONST.BUTTONS.ARROW_UP, CONST.BUTTONS.ARROW_RIGHT, CONST.BUTTONS.ARROW_BOTTOM, CONST.BUTTONS.ACCEPT, CONST.BUTTONS.INTERACT
-- [layer.md](../canvas/layer.md) — `LAYER`: SETTINGS.QUALITY

package/plugins/views.screens/history.md

@@ -1,25 +1,22 @@
 # plugins/views.screens/history/
 
-Пакет: `@vnejs/plugins.views.screens.history` · namespace: `HISTORY`
+Пакет: `@vnejs/plugins.views.screens.history` · namespace: `HISTORY_VIEW`
 
-Журнал диалогов с возвратом к сохранённым состояниям прошлых реплик.
+Экран журнала диалогов. Снапшоты и шаг назад — [scenario/history.md](../scenario/history.md) (`HISTORY`). Этот плагин в `bundles/vn.base`.
 
 ## События
 
-| Ключ           | Строка                     | Смысл                                                                                                                                     |
-| -------------- | -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
-| `GET`          | `vne:history:get`          | Получить значение или ресурс.                                                                                                             |
-| `ADD`          | `vne:history:add`          | Добавить запись в журнал (snapshot state). Payload: реплика (`label`/`text`/`args`/`speaker`…) или маркер UI (`locKey` без speaker/text). |
-| `LOAD`         | `vne:history:load`         | Запросить данные у обработчиков и продолжить цепочку.                                                                                     |
-| `BACK`         | `vne:history:back`         | Событие `BACK` namespace плагина.                                                                                                         |
-| `KEYS`         | `vne:history:keys`         | Событие `KEYS` namespace плагина.                                                                                                         |
-| `HIDE`         | `vne:history:hide`         | Скрыть UI или слой.                                                                                                                       |
-| `SHOW`         | `vne:history:show`         | Показать UI или слой.                                                                                                                     |
-| `CLICK`        | `vne:history:click`        | Событие `CLICK` namespace плагина.                                                                                                        |
-| `UPDATE`       | `vne:history:update`       | Обновить состояние или отображение.                                                                                                       |
-| `STATE_UPDATE` | `vne:history:state_update` | Слить partial в стейт контроллера без UPDATE view.                                                                                        |
-| `UPDATE_FAST`  | `vne:history:update_fast`  | Перерисовать view с `isFast`, стейт не меняет.                                                                                            |
-| `ACCEPT`       | `vne:history:accept`       | Событие `ACCEPT` namespace плагина.                                                                                                       |
+| Ключ           | Строка                          | Смысл                                                                 |
+| -------------- | ------------------------------- | --------------------------------------------------------------------- |
+| `HIDE`         | `vne:history_view:hide`         | Скрыть экран.                                                         |
+| `SHOW`         | `vne:history_view:show`         | Показать экран.                                                       |
+| `CLICK`        | `vne:history_view:click`        | Клик по строке. Если `uid` есть в ключах журнала — `HISTORY.LOAD`.    |
+| `UPDATE`       | `vne:history_view:update`       | Перерисовать view.                                                    |
+| `STATE_UPDATE` | `vne:history_view:state_update` | Слить partial в стейт контроллера без UPDATE view.                    |
+| `UPDATE_FAST`  | `vne:history_view:update_fast`  | Перерисовать view с `isFast`, стейт не меняет.                        |
+| `ACCEPT`       | `vne:history_view:accept`       | `ACCEPT` / `INTERACT` → `CLICK` по `currentArrowVerticalItem`.        |
+
+Строки журнала и шаг назад — `EVENTS.HISTORY.GET` / `KEYS` / `LOAD` / `BACK` / `ADD` (`scenario/history`).
 
 ## Константы
 
@@ -29,11 +26,10 @@
 
 | Ключ         | Тип      | Смысл                                |
 | ------------ | -------- | ------------------------------------ |
-| `MAX_LENGTH` | `string` | Значение по умолчанию: "MAX_LENGTH". |
-| `ZINDEX`     | `string` | Значение по умолчанию: "ZINDEX".     |
-| `TRANSITION` | `string` | Значение по умолчанию: "TRANSITION". |
-| `LOC_LABEL`  | `string` | Имя метки или стартовой точки.       |
-| `VIEW_PROPS` | `string` | Значение по умолчанию: "VIEW_PROPS". |
+| `ZINDEX`     | `number` | Значение по умолчанию: 2000.         |
+| `TRANSITION` | `number` | Значение по умолчанию: 300.          |
+| `LOC_LABEL`  | `string` | Метка локализации view (`history`).  |
+| `VIEW_PROPS` | `object` | Раскладка экрана, строк и кнопки закрытия. |
 
 ## Настройки
 
@@ -43,34 +39,21 @@
 
 | Модуль                      | Зона ответственности                                                                                                                                                                                                                                   |
 | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `history.controller`        | SHOW/HIDE/CLICK/STATE_UPDATE/UPDATE_FAST; перед SHOW резолвит тексты строк (`TEXT.REPLACE`). Для `locKey` — через `PARAMS.HISTORY.LOC_LABEL` (локализация view), иначе через label сценария. Пустой `controls` на `ZINDEX`, чтобы стопорить слои ниже. |
+| `history.controller`        | SHOW/HIDE/CLICK/STATE_UPDATE/UPDATE_FAST; перед SHOW резолвит тексты строк (`TEXT.REPLACE`). Для `locKey` — через `PARAMS.HISTORY_VIEW.LOC_LABEL` (локализация view), иначе через label сценария. Пустой `controls` на `ZINDEX`, чтобы стопорить слои ниже. |
 | `history.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CLICK` по `currentArrowVerticalItem`; зеркалит `STATE_UPDATE`; PUSH/POP на SHOW/HIDE.                                                                                 |
 | `history.controller.arrows` | Наследует `@vnejs/module.controller.arrows.vertical`: `ARROW_UP` / `ARROW_BOTTOM` по записям журнала; PUSH/POP controls на SHOW/HIDE; эмитит `STATE_UPDATE` с `{ currentArrowVerticalItem }` и `UPDATE_FAST`.                                          |
 | `history.hide.controls`     | Наследует `@vnejs/module.controller.hide.on.controls`: `BACK` / `MENU` / `GAMEMENU` → `HIDE`; PUSH/POP на SHOW/HIDE.                                                                                                                                   |
 | `history.hide.state`        | Наследует `@vnejs/module.controller.hide.on.state`: `STATE.SET` → `HIDE` с `{ isForce: true }` (`IS_STATE_CLEAR_ENABLED = false`).                                                                                                                      |
-| `history`                   | `MEMORY.REG` в `setup`; ADD, GET, LOAD, BACK, ….                                                                                                                                                                                                       |
 | `history.view`              | Подмодуль `view` плагина.                                                                                                                                                                                                                              |
 
-## Compatibility
-
-### `compatibility/scenario.choose/views.screens.history/`
-
-Пакет: `@vnejs/compatibility.scenario.choose-with-views.screens.history`
-
-На `CHOOSE.OPTION_BEFORE_REG` добавляет в историю запись `{ locKey: "choice" }`. Перевод — ключ `choice` в `history.json` (например «Выбор...»).
-
 ## Близкие плагины
 
 ### plugins/core/
 
 - [logs.md](../core/logs.md) — `LOGS`: emitLog
-- [memory.md](../core/memory.md) — `MEMORY`: EVENTS.REG, EVENTS.SET, EVENTS.KEYS, EVENTS.GET
-- [scenario.md](../core/scenario.md) — `SCENARIO`: EVENTS.LABEL_GET
-- [state.md](../core/state.md) — `STATE`: EVENTS.SET, EVENTS.CLEAR, EVENTS.GET, EVENTS.LOAD
-- [vendors.md](../core/vendors.md) — `VENDORS`: emitClone, EVENTS.UID
 
 ### Остальные
 
+- [scenario/history.md](../scenario/history.md) — `HISTORY`: `GET` / `KEYS` / `LOAD`; запись журнала и `BACK`
 - [controls.md](../controls/controls.md) — `CONTROLS`: CONST.BUTTONS.BACK, CONST.BUTTONS.MENU, CONST.BUTTONS.GAMEMENU, CONST.BUTTONS.ARROW_UP, CONST.BUTTONS.ARROW_BOTTOM, CONST.BUTTONS.ACCEPT, CONST.BUTTONS.INTERACT
 - [text.md](../text/text.md) — `TEXT`: EVENTS.REPLACE
-- [choose.md](../scenario/choose.md) — `CHOOSE`: связка через compatibility выше (`OPTION_BEFORE_REG`)

package/plugins/views.screens/intro.md

@@ -6,14 +6,17 @@
 
 ## События
 
-| Ключ       | Строка               | Смысл                                   |
-| ---------- | -------------------- | --------------------------------------- |
-| `SHOW`     | `vne:intro:show`     | Показать UI или слой.                   |
-| `HIDE`     | `vne:intro:hide`     | Скрыть UI или слой.                     |
-| `CLICK`    | `vne:intro:click`    | Продвинуть сценарий к следующей строке. |
-| `UPDATE`   | `vne:intro:update`   | Обновить состояние или отображение.     |
-| `SKIP`     | `vne:intro:skip`     | Продвинуть сценарий к следующей строке. |
-| `INTERACT` | `vne:intro:interact` | Продвинуть сценарий к следующей строке. |
+| Ключ           | Строка                   | Смысл                                   |
+| -------------- | ------------------------ | --------------------------------------- |
+| `SHOW`         | `vne:intro:show`         | Показать UI или слой.                   |
+| `SHOW_BEFORE`  | `vne:intro:show_before`  | Хук перед показом: пишет `bgSrc`.       |
+| `HIDE`         | `vne:intro:hide`         | Скрыть UI или слой.                     |
+| `CLICK`        | `vne:intro:click`        | Продвинуть сценарий к следующей строке. |
+| `UPDATE`       | `vne:intro:update`       | Обновить состояние или отображение.     |
+| `UPDATE_FAST`  | `vne:intro:update_fast`  | Перерисовать view с `isFast`.           |
+| `SKIP`         | `vne:intro:skip`         | Продвинуть сценарий к следующей строке. |
+| `INTERACT`     | `vne:intro:interact`     | Продвинуть сценарий к следующей строке. |
+| `STATE_UPDATE` | `vne:intro:state_update` | Слить partial в стейт.                  |
 
 ## Константы
 
@@ -31,11 +34,12 @@
 
 ## Модули
 
-| Модуль             | Зона ответственности                                    |
-| ------------------ | ------------------------------------------------------- |
-| `intro.controller` | Обрабатывает INTERACT, UPDATE, SHOW, HIDE, ….           |
-| `intro`            | Связь со сценарием: шаг next после завершения действия. |
-| `intro.view`       | Подмодуль `view` плагина.                               |
+| Модуль                | Зона ответственности                                                                     |
+| --------------------- | ---------------------------------------------------------------------------------------- |
+| `intro.controller`    | SHOW/HIDE; `beforeShow` → `SHOW_BEFORE`; `STATE_UPDATE` / `UPDATE_FAST`; ANY → INTERACT. |
+| `intro.controller.bg` | Наследует `@vnejs/module.controller.bg`: `SHOW_BEFORE` → `bgSrc`; `start` preload.       |
+| `intro`               | Связь со сценарием: шаг next после завершения действия.                                  |
+| `intro.view`          | Подмодуль `view` плагина.                                                                |
 
 ## Близкие плагины
 

package/plugins/views.screens/loading.md

@@ -6,12 +6,15 @@
 
 ## События
 
-| Ключ     | Строка               | Смысл                                     |
-| -------- | -------------------- | ----------------------------------------- |
-| `SHOW`   | `vne:loading:show`   | Показать UI или слой.                     |
-| `HIDE`   | `vne:loading:hide`   | Скрыть UI или слой.                       |
-| `EMIT`   | `vne:loading:emit`   | Записать диагностическое сообщение в лог. |
-| `UPDATE` | `vne:loading:update` | Обновить состояние или отображение.       |
+| Ключ           | Строка                     | Смысл                                     |
+| -------------- | -------------------------- | ----------------------------------------- |
+| `SHOW`         | `vne:loading:show`         | Показать UI или слой.                     |
+| `SHOW_BEFORE`  | `vne:loading:show_before`  | Хук перед показом: пишет `bgSrc`.         |
+| `HIDE`         | `vne:loading:hide`         | Скрыть UI или слой.                       |
+| `EMIT`         | `vne:loading:emit`         | Записать диагностическое сообщение в лог. |
+| `UPDATE`       | `vne:loading:update`       | Обновить состояние или отображение.       |
+| `UPDATE_FAST`  | `vne:loading:update_fast`  | Перерисовать view с `isFast`.             |
+| `STATE_UPDATE` | `vne:loading:state_update` | Слить partial в стейт.                    |
 
 ## Константы
 
@@ -29,11 +32,12 @@
 
 ## Модули
 
-| Модуль               | Зона ответственности                           |
-| -------------------- | ---------------------------------------------- |
-| `loading.controller` | Обрабатывает UPDATE, SHOW, HIDE, STARTED, ….   |
-| `loading`            | Точка входа emit: подготовка и запуск process. |
-| `loading.view`       | Подмодуль `view` плагина.                      |
+| Модуль                  | Зона ответственности                                                                                              |
+| ----------------------- | ----------------------------------------------------------------------------------------------------------------- |
+| `loading.controller`    | SHOW/HIDE; `beforeShow` → `SHOW_BEFORE`; `STATE_UPDATE` / `UPDATE_FAST`.                                          |
+| `loading.controller.bg` | Наследует `@vnejs/module.controller.bg`: `SHOW_BEFORE` → `bgSrc`; `start`; `MEMORY.CLEARED` refresh при `isShow`. |
+| `loading`               | Точка входа emit: подготовка и запуск process.                                                                    |
+| `loading.view`          | Подмодуль `view` плагина.                                                                                         |
 
 ## Близкие плагины
 

package/plugins/views.screens/mainmenu.md

@@ -8,18 +8,19 @@
 
 ## События
 
-| Ключ           | Строка                      | Смысл                                                            |
-| -------------- | --------------------------- | ---------------------------------------------------------------- |
-| `HIDE`         | `vne:mainmenu:hide`         | Скрыть UI или слой.                                              |
-| `SHOW`         | `vne:mainmenu:show`         | Показать UI или слой.                                            |
-| `ITEMS`        | `vne:mainmenu:items`        | Событие `ITEMS` namespace плагина.                               |
-| `PRELOAD`      | `vne:mainmenu:preload`      | Предзагрузить метки `PRELOAD_LABELS` и события `PRELOAD_EVENTS`. |
-| `CLICK`        | `vne:mainmenu:click`        | Событие `CLICK` namespace плагина.                               |
-| `ACCEPT`       | `vne:mainmenu:accept`       | Событие `ACCEPT` namespace плагина.                              |
-| `UPDATE`       | `vne:mainmenu:update`       | Обновить состояние или отображение.                              |
-| `STATE_UPDATE` | `vne:mainmenu:state_update` | Слить partial в стейт контроллера без UPDATE view.               |
-| `UPDATE_FORCE` | `vne:mainmenu:update_force` | Перерисовать view с `isForce`, стейт не меняет.                  |
-| `UPDATE_FAST`  | `vne:mainmenu:update_fast`  | Перерисовать view с `isFast`, стейт не меняет.                   |
+| Ключ           | Строка                      | Смысл                                                                |
+| -------------- | --------------------------- | -------------------------------------------------------------------- |
+| `HIDE`         | `vne:mainmenu:hide`         | Скрыть UI или слой.                                                  |
+| `SHOW`         | `vne:mainmenu:show`         | Показать UI или слой.                                                |
+| `SHOW_BEFORE`  | `vne:mainmenu:show_before`  | Хук перед показом: начальный `bgSrc` через `mainmenu.controller.bg`. |
+| `ITEMS`        | `vne:mainmenu:items`        | Событие `ITEMS` namespace плагина.                                   |
+| `PRELOAD`      | `vne:mainmenu:preload`      | Предзагрузить метки `PRELOAD_LABELS` и события `PRELOAD_EVENTS`.     |
+| `CLICK`        | `vne:mainmenu:click`        | Событие `CLICK` namespace плагина.                                   |
+| `ACCEPT`       | `vne:mainmenu:accept`       | Событие `ACCEPT` namespace плагина.                                  |
+| `UPDATE`       | `vne:mainmenu:update`       | Обновить состояние или отображение.                                  |
+| `STATE_UPDATE` | `vne:mainmenu:state_update` | Слить partial в стейт контроллера без UPDATE view.                   |
+| `UPDATE_FORCE` | `vne:mainmenu:update_force` | Перерисовать view с `isForce`, стейт не меняет.                      |
+| `UPDATE_FAST`  | `vne:mainmenu:update_fast`  | Перерисовать view с `isFast`, стейт не меняет.                       |
 
 ## Константы
 
@@ -48,7 +49,8 @@
 
 | Модуль                       | Зона ответственности                                                                                                                                                                                          |
 | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `mainmenu.controller`        | Обрабатывает UPDATE, SHOW, HIDE, STATE_UPDATE, UPDATE_FAST, UPDATE_FORCE, …. На SHOW пушит пустой `controls` на `ZINDEX`, чтобы стопорить слои ниже.                                                          |
+| `mainmenu.controller`        | UPDATE, SHOW, HIDE, STATE_UPDATE, UPDATE_FAST, UPDATE_FORCE; `beforeShow` → `SHOW_BEFORE` + ITEMS. На SHOW пушит пустой `controls` на `ZINDEX`.                                                               |
+| `mainmenu.controller.bg`     | Наследует `@vnejs/module.controller.bg`: начальный `bgSrc` на `SHOW_BEFORE`; `start` / `STATE.CLEAR` preload. Ротацию не трогает.                                                                             |
 | `mainmenu.hide`              | Наследует `@vnejs/module.controller.hide.on.state`: `STATE.SET` / `STATE.CLEAR` → `HIDE` с `{ isForce: true }`.                                                                                               |
 | `mainmenu.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CLICK` по `currentArrowVerticalItem`; зеркалит `STATE_UPDATE`; PUSH/POP на SHOW/HIDE.                                        |
 | `mainmenu.controller.arrows` | Наследует `@vnejs/module.controller.arrows.vertical`: `ARROW_UP` / `ARROW_BOTTOM` по видимым пунктам; PUSH/POP controls на SHOW/HIDE; эмитит `STATE_UPDATE` с `{ currentArrowVerticalItem }` и `UPDATE_FAST`. |

package/plugins/views.screens/save.md

@@ -8,19 +8,26 @@ ACCEPT/INTERACT повторяет клик по слоту: на вкладке
 
 ## События
 
-| Ключ       | Строка                   | Смысл                                                             |
-| ---------- | ------------------------ | ----------------------------------------------------------------- |
-| `SHOW`     | `vne:save_view:show`     | Показать UI или слой.                                             |
-| `HIDE`     | `vne:save_view:hide`     | Скрыть UI или слой.                                               |
-| `PAGE_SET` | `vne:save_view:page_set` | Записать или обновить значение.                                   |
-| `TAB_SET`  | `vne:save_view:tab_set`  | Выбрать вкладку save/load/autosave (`{ tab }`).                   |
-| `CREATE`   | `vne:save_view:create`   | Создать слот (`{ key, group }`) → `SAVE.CREATE`.                  |
-| `DELETE`   | `vne:save_view:delete`   | Удалить слот (`{ key, group }`) → `SAVE.DELETE`.                  |
-| `LOAD`     | `vne:save_view:load`     | Загрузить слот (`{ key, group }`) → `SAVE.PRELOAD` / `SAVE.LOAD`. |
-| `UPDATE`   | `vne:save_view:update`   | Обновить состояние или отображение.                               |
-| `PRELOAD`      | `vne:save_view:preload`      | Событие `PRELOAD` namespace плагина.                              |
-| `ACCEPT`       | `vne:save_view:accept`       | ACCEPT / INTERACT по выбранному слоту.                            |
-| `STATE_UPDATE` | `vne:save_view:state_update` | Слить partial в стейт accept-модуля без UPDATE view.              |
+| Ключ                | Строка                            | Смысл                                                                                                                                                 |
+| ------------------- | --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `SHOW`              | `vne:save_view:show`              | Показать UI или слой.                                                                                                                                 |
+| `SHOW_BEFORE`       | `vne:save_view:show_before`       | Хук перед показом: `save.controller.bg` пишет `bgSrc` в стейт.                                                                                        |
+| `HIDE`              | `vne:save_view:hide`              | Скрыть UI или слой.                                                                                                                                   |
+| `PAGE_SET`          | `vne:save_view:page_set`          | Абсолютный прыжок пагинации UI (`{ pageIndex }`).                                                                                                     |
+| `TAB_SET`           | `vne:save_view:tab_set`           | Выбрать вкладку save/load/autosave (`{ tab }`).                                                                                                       |
+| `CREATE`            | `vne:save_view:create`            | Создать слот (`{ key, group }`) → `SAVE.CREATE`.                                                                                                      |
+| `DELETE`            | `vne:save_view:delete`            | Удалить слот (`{ key, group }`) → `SAVE.DELETE`.                                                                                                      |
+| `LOAD`              | `vne:save_view:load`              | Загрузить слот (`{ key, group }`) → `SAVE.PRELOAD` / `SAVE.LOAD`.                                                                                     |
+| `UPDATE`            | `vne:save_view:update`            | Обновить состояние или отображение.                                                                                                                   |
+| `UPDATE_FAST`       | `vne:save_view:update_fast`       | Перерисовать view с `isFast`, без смены стейта.                                                                                                       |
+| `PRELOAD`           | `vne:save_view:preload`           | Событие `PRELOAD` namespace плагина.                                                                                                                  |
+| `ACCEPT`            | `vne:save_view:accept`            | ACCEPT / INTERACT по выбранному слоту.                                                                                                                |
+| `STATE_UPDATE`      | `vne:save_view:state_update`      | Слить partial в стейт controller/accept/grid без UPDATE view.                                                                                         |
+| `GRID_NEXT`         | `vne:save_view:grid_next`         | Край сетки вперёд; `save.controller.pages` слушает как `EVENT_PAGE_NEXT` (намеренный мост, без знания сетки в pages).                                 |
+| `GRID_PREV`         | `vne:save_view:grid_prev`         | Край сетки назад; `save.controller.pages` слушает как `EVENT_PAGE_PREV`.                                                                              |
+| `GRID_CLEAR`        | `vne:save_view:grid_clear`        | Сбросить выбор ячейки: `gridRow` / `gridColumn` → `null` (+ `STATE_UPDATE`).                                                                          |
+| `GRID_UPDATE_ITEMS` | `vne:save_view:grid_update_items` | Пересобрать сетку из стейта (без payload) → `STATE_UPDATE` `{ gridItems }`. Meta (`gridIndex` / `gridsCount` / `tab`) — заранее через `STATE_UPDATE`. |
+| `SLOT_CREATE`       | `vne:save_view:slot_create`       | Собрать UI-слот (`{ key, group, index }`) → `SAVE.GET` + дата/время; возврат item.                                                                    |
 
 ## Константы
 
@@ -39,16 +46,21 @@ ACCEPT/INTERACT повторяет клик по слоту: на вкладке
 
 ## Модули
 
-| Модуль                  | Зона ответственности                                                                                                                                                                                                                                           |
-| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `save.controller.audio` | Наследник `ModuleControllerAudio`: SHOW/HIDE/PRELOAD → pause global, play/stop `view`-трека; `VOLUME_SETTING = MUSIC.VOLUME`; SHOW передаёт в `AUDIO.PLAY` уже посчитанный `volume`; при `VOLUME_CHANGED` / смене `VOLUME_SETTING` — повторный `AUDIO.VOLUME`. |
-| `save.controller`       | Обрабатывает UPDATE, HIDE, LOAD, TAB_SET, …. SHOW принимает `{ tab }`; в `SAVE.*` передаёт `group` (номер страницы или `autosave`). Стрелки в `controls` контроллера; после смены ячейки эмитит `STATE_UPDATE`.                                                  |
-| `save.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CREATE` на вкладке save, иначе `LOAD` при `screen`; зеркалит `STATE_UPDATE`; PUSH/POP на SHOW/HIDE.                                                                          |
-| `save.hide.controls`    | Наследует `@vnejs/module.controller.hide.on.controls`: `BACK` / `MENU` / `GAMEMENU` → `HIDE`; PUSH/POP на SHOW/HIDE.                                                                                                                                           |
-| `save.hide.state`       | Наследует `@vnejs/module.controller.hide.on.state`: `STATE.SET` / `STATE.CLEAR` → `HIDE` с `{ isForce: true }`.                                                                                                                                                |
-| `save.controller.tabs`  | Наследник `ModuleControllerTabs`: TAB_PREV/TAB_NEXT → `TAB_SET`; `getTabKeys` фильтрует SAVE vs LOAD/AUTOSAVE.                                                                                                                                                 |
-| `save.controller.load`  | Подмодуль `controller.load` плагина.                                                                                                                                                                                                                           |
-| `save.view`             | Подмодуль `view` плагина.                                                                                                                                                                                                                                      |
+| Модуль                    | Зона ответственности                                                                                                                                                                                                                                                           |
+| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `save.controller.audio`   | Наследник `ModuleControllerAudio`: SHOW/HIDE/PRELOAD → pause global, play/stop `view`-трека; `VOLUME_SETTING = MUSIC.VOLUME`; SHOW передаёт в `AUDIO.PLAY` уже посчитанный `volume`; при `VOLUME_CHANGED` / смене `VOLUME_SETTING` — повторный `AUDIO.VOLUME`.                 |
+| `save.controller`         | SHOW/HIDE; `beforeShow` → `SHOW_BEFORE` + `TAB_SET`; `STATE_UPDATE` / `UPDATE_FAST`; пустой `controls` на `ZINDEX`.                                                                                                                                                            |
+| `save.controller.bg`      | Наследует `@vnejs/module.controller.bg`: `SHOW_BEFORE` → `bgSrc`; PRELOAD / `start`; `MEMORY.CLEARED` — preload и refresh при `isShow`.                                                                                                                                        |
+| `save.controller.actions` | CREATE → `SAVE.CREATE`, DELETE → `SAVE.DELETE`; `group` из payload или `getSaveGroup` (autosave / `pageIndex`); затем `GRID_UPDATE_ITEMS` + `UPDATE_FAST`.                                                                                                                     |
+| `save.controller.pages`   | Наследует `@vnejs/module.controller.pages`: `EVENT_*` → `SAVE_VIEW`; `applyPage` → `STATE_UPDATE` `{ gridIndex, gridsCount }` + `GRID_UPDATE_ITEMS`; `init` пишет `pagesCount`.                                                                                                |
+| `save.controller.accept`  | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CREATE` на вкладке save, иначе `LOAD` при `screen`; зеркалит `STATE_UPDATE`; PUSH/POP на SHOW/HIDE.                                                                                           |
+| `save.controller.grid`    | Наследует `@vnejs/module.controller.arrows.grid`: четыре стрелки; `isDisableGridChangeVertical = true` (вертикаль не листает страницы); на краю колонок — `GRID_NEXT`/`PREV`; `GRID_CLEAR`; `GRID_UPDATE_ITEMS` → `getGridItems` / `STATE_UPDATE` `{ gridItems }`.             |
+| `save.view.slot`          | На `SLOT_CREATE` собирает UI-слот: `SAVE.GET` → `screen` / `ts` / `date` / `time` / `locKey`.                                                                                                                                                                                  |
+| `save.hide.controls`      | Наследует `@vnejs/module.controller.hide.on.controls`: `BACK` / `MENU` / `GAMEMENU` → `HIDE`; PUSH/POP на SHOW/HIDE.                                                                                                                                                           |
+| `save.hide.state`         | Наследует `@vnejs/module.controller.hide.on.state`: `STATE.SET` / `STATE.CLEAR` → `HIDE` с `{ isForce: true }`.                                                                                                                                                                |
+| `save.controller.tabs`    | Наследник `ModuleControllerTabs`: `TAB_SET` → `applyTab` + `onTabSet` (`pageIndex: 0`, `GRID_CLEAR`, `STATE_UPDATE` `{ gridIndex, gridsCount }`, `GRID_UPDATE_ITEMS`, опционально `UPDATE_FAST`); TAB_PREV/TAB_NEXT → `TAB_SET`; `getTabKeys` фильтрует SAVE vs LOAD/AUTOSAVE. |
+| `save.controller.load`    | Подмодуль `controller.load` плагина.                                                                                                                                                                                                                                           |
+| `save.view`               | Подмодуль `view` плагина.                                                                                                                                                                                                                                                      |
 
 ## Близкие плагины
 
@@ -65,7 +77,7 @@ ACCEPT/INTERACT повторяет клик по слоту: на вкладке
 - [audio.md](../audio/audio.md) — `AUDIO`: EVENTS.GLOBAL_PAUSE, EVENTS.PLAY, EVENTS.STOP, EVENTS.GLOBAL_RESUME, EVENTS.MEDIA_LOAD, EVENTS.VOLUME, EVENTS.VOLUME_CHANGED
 - [music.md](../audio/music.md) — `MUSIC`: SETTINGS.VOLUME
 - [confirm.md](./confirm.md) — `CONFIRM`: EVENTS.EMIT
-- [controls.md](../controls/controls.md) — `CONTROLS`: CONST.BUTTONS.BACK, CONST.BUTTONS.MENU, CONST.BUTTONS.GAMEMENU, CONST.BUTTONS.ARROW_UP, CONST.BUTTONS.ARROW_RIGHT, CONST.BUTTONS.ARROW_BOTTOM, CONST.BUTTONS.ACCEPT, CONST.BUTTONS.INTERACT
+- [controls.md](../controls/controls.md) — `CONTROLS`: CONST.BUTTONS.BACK, CONST.BUTTONS.MENU, CONST.BUTTONS.GAMEMENU, CONST.BUTTONS.ARROW_UP, CONST.BUTTONS.ARROW_RIGHT, CONST.BUTTONS.ARROW_BOTTOM, CONST.BUTTONS.ARROW_LEFT, CONST.BUTTONS.ACCEPT, CONST.BUTTONS.INTERACT
 - [loading.md](./loading.md) — `LOADING`: EVENTS.EMIT
 - [locs.md](../text/locs.md) — `LOCS`: EVENTS.GET
 - [save.md](../save/save.md) — `SAVE`: EVENTS.CREATE, EVENTS.DELETE, EVENTS.GET, EVENTS.PRELOAD, EVENTS.LOAD

package/plugins/views.screens/settings.defaults.md

@@ -8,14 +8,17 @@ Breaking: раньше namespace был `SETTINGS_DEFAULTS`, события `vne
 
 ## События
 
-| Ключ      | Строка                              | Смысл                                   |
-| --------- | ----------------------------------- | --------------------------------------- |
-| `UPDATE`  | `vne:settings_default_view:update`  | Обновить состояние или отображение.     |
-| `SHOW`    | `vne:settings_default_view:show`    | Показать UI или слой.                   |
-| `HIDE`    | `vne:settings_default_view:hide`    | Скрыть UI или слой.                     |
-| `CONFIRM` | `vne:settings_default_view:confirm` | Продвинуть сценарий к следующей строке. |
-
-На `SHOW` эмитит `SETTINGS_VIEW.SHOW` с `{ tab: PARAMS.SETTINGS_VIEW.TABS.DEFAULT, tabKey: "DEFAULT", locs }`; на `HIDE` — `SETTINGS_VIEW.HIDE`.
+| Ключ           | Строка                                   | Смысл                                   |
+| -------------- | ---------------------------------------- | --------------------------------------- |
+| `UPDATE`       | `vne:settings_default_view:update`       | Обновить состояние или отображение.     |
+| `UPDATE_FAST`  | `vne:settings_default_view:update_fast`  | Перерисовать view с `isFast`.           |
+| `SHOW`         | `vne:settings_default_view:show`         | Показать UI или слой.                   |
+| `SHOW_BEFORE`  | `vne:settings_default_view:show_before`  | Хук перед показом: пишет `bgSrc`.       |
+| `HIDE`         | `vne:settings_default_view:hide`         | Скрыть UI или слой.                     |
+| `CONFIRM`      | `vne:settings_default_view:confirm`      | Продвинуть сценарий к следующей строке. |
+| `STATE_UPDATE` | `vne:settings_default_view:state_update` | Слить partial в стейт.                  |
+
+На `SHOW_BEFORE` fields-модуль эмитит `SETTINGS_VIEW.SHOW` с `{ tab: TABS[CONST.SETTINGS_VIEW.DEFAULT_TAB], tabKey: CONST.SETTINGS_VIEW.DEFAULT_TAB, locs }`; на `HIDE` — `SETTINGS_VIEW.HIDE`.
 
 ## Константы
 
@@ -37,7 +40,9 @@ Breaking: раньше namespace был `SETTINGS_DEFAULTS`, события `vne
 
 | Модуль                               | Зона ответственности                                                                                                                                            |
 | ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `settings.default.controller`        | SHOW/HIDE; связка с `SETTINGS_VIEW`.                                                                                                                            |
+| `settings.default.controller`        | SHOW/HIDE; `beforeShow` → `SHOW_BEFORE`; `STATE_UPDATE` / `UPDATE_FAST`.                                                                                        |
+| `settings.default.controller.bg`     | Наследует `@vnejs/module.controller.bg`: `SHOW_BEFORE` → `bgSrc`; `MEMORY.CLEARED` при `isShow` → refresh.                                                      |
+| `settings.default.controller.fields` | На `SHOW_BEFORE`: `STATE_UPDATE` `{ tab }` + `SETTINGS_VIEW.SHOW` с `CONST.SETTINGS_VIEW.DEFAULT_TAB`.                                                          |
 | `settings.default.controller.accept` | Наследует `@vnejs/module.controller.accept`: только `ACCEPT` (`IS_INTERACT_ENABLED = false`) → `CONFIRM` → `INITED`, `HIDE`, `emitNext`; PUSH/POP на SHOW/HIDE. |
 | `settings.default`                   | `SETTINGS.INIT` INITED в `setup`; `LINE_EXEC` как `$ settings.defaults` → `SHOW`, либо `emitNext` при `skip_if_possible` и `INITED`.                            |
 | `settings.default.view`              | Chrome: title + кнопка Accept.                                                                                                                                  |
@@ -53,5 +58,5 @@ Breaking: раньше namespace был `SETTINGS_DEFAULTS`, события `vne
 
 ### Остальные
 
-- [settings.md](../views/settings.md) — `SETTINGS_VIEW`: PARAMS.TABS.DEFAULT, стрелки
+- [settings.md](../views/settings.md) — `SETTINGS_VIEW`: `CONST.DEFAULT_TAB`, стрелки
 - [controls.md](../controls/controls.md) — `CONTROLS`: CONST.BUTTONS.ACCEPT

package/plugins/views.screens/settings.md

@@ -6,15 +6,18 @@
 
 ## События
 
-| Ключ      | Строка                             | Смысл                                                                        |
-| --------- | ---------------------------------- | ---------------------------------------------------------------------------- |
-| `SHOW`    | `vne:settings_screen_view:show`    | Показать UI или слой.                                                        |
-| `HIDE`    | `vne:settings_screen_view:hide`    | Скрыть UI или слой.                                                          |
-| `UPDATE`  | `vne:settings_screen_view:update`  | Обновить состояние или отображение.                                          |
-| `PRELOAD` | `vne:settings_screen_view:preload` | Событие `PRELOAD` namespace плагина.                                         |
-| `TAB_SET` | `vne:settings_screen_view:tab_set` | Выбрать вкладку по ключу из `PARAMS.SETTINGS_VIEW.TABS` (`{ tab: string }`). |
-
-На открытии эмитит `SETTINGS_VIEW.SHOW` с `{ tab, tabs, tabKey, locs }`; на `TAB_SET` экрана — `SETTINGS_VIEW.TAB_SET` с `{ tab, tabKey, locs }` (crossfade контента); на `HIDE` — `SETTINGS_VIEW.HIDE`.
+| Ключ           | Строка                                  | Смысл                                                                               |
+| -------------- | --------------------------------------- | ----------------------------------------------------------------------------------- |
+| `SHOW`         | `vne:settings_screen_view:show`         | Показать UI или слой.                                                               |
+| `SHOW_BEFORE`  | `vne:settings_screen_view:show_before`  | Хук перед показом: bg + `settings.screen.controller.fields` → `SETTINGS_VIEW.SHOW`. |
+| `HIDE`         | `vne:settings_screen_view:hide`         | Скрыть UI или слой.                                                                 |
+| `UPDATE`       | `vne:settings_screen_view:update`       | Обновить состояние или отображение.                                                 |
+| `UPDATE_FAST`  | `vne:settings_screen_view:update_fast`  | Перерисовать view с `isFast`, без смены стейта.                                     |
+| `PRELOAD`      | `vne:settings_screen_view:preload`      | Событие `PRELOAD` namespace плагина.                                                |
+| `TAB_SET`      | `vne:settings_screen_view:tab_set`      | Выбрать вкладку по ключу из `PARAMS.SETTINGS_VIEW.TABS` (`{ tab: string }`).        |
+| `STATE_UPDATE` | `vne:settings_screen_view:state_update` | Слить partial в стейт (в т.ч. `{ tab }` из tabs-модуля).                            |
+
+На `SHOW_BEFORE` fields-модуль эмитит `SETTINGS_VIEW.SHOW` с `{ tab, tabs, tabKey, locs }`; на `TAB_SET` экрана tabs-модуль шлёт `STATE_UPDATE` `{ tab }`, `SETTINGS_VIEW.TAB_SET` и `UPDATE_FAST`; на `HIDE` — `SETTINGS_VIEW.HIDE`.
 
 ## Константы
 
@@ -36,14 +39,16 @@
 
 ## Модули
 
-| Модуль                             | Зона ответственности                                                                                                                                                                                                                                           |
-| ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `settings.screen.controller.audio` | Наследник `ModuleControllerAudio`: SHOW/HIDE/PRELOAD → pause global, play/stop `view`-трека; `VOLUME_SETTING = MUSIC.VOLUME`; SHOW передаёт в `AUDIO.PLAY` уже посчитанный `volume`; при `VOLUME_CHANGED` / смене `VOLUME_SETTING` — повторный `AUDIO.VOLUME`. |
-| `settings.screen.controller`       | SHOW/HIDE/TAB_SET; связка с `SETTINGS_VIEW`. Пустой `controls` на `ZINDEX`, чтобы стопорить слои ниже.                                                                                                                                                         |
-| `settings.screen.hide.controls`    | Наследует `@vnejs/module.controller.hide.on.controls`: `BACK` / `MENU` / `GAMEMENU` → `HIDE`; PUSH/POP на SHOW/HIDE.                                                                                                                                           |
-| `settings.screen.hide.state`       | Наследует `@vnejs/module.controller.hide.on.state`: `STATE.SET` / `STATE.CLEAR` → `HIDE` с `{ isForce: true }`.                                                                                                                                                 |
-| `settings.screen.controller.tabs`  | Наследник `ModuleControllerTabs`: TAB_PREV/TAB_NEXT → `TAB_SET`; `getTabKeys` по `showInSettings`.                                                                                                                                                             |
-| `settings.screen.view`             | Chrome экрана (Screen, tabs, cross); поля и example text — в `SETTINGS_VIEW`.                                                                                                                                                                                  |
+| Модуль                              | Зона ответственности                                                                                                                                                                                                                                           |
+| ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `settings.screen.controller.audio`  | Наследник `ModuleControllerAudio`: SHOW/HIDE/PRELOAD → pause global, play/stop `view`-трека; `VOLUME_SETTING = MUSIC.VOLUME`; SHOW передаёт в `AUDIO.PLAY` уже посчитанный `volume`; при `VOLUME_CHANGED` / смене `VOLUME_SETTING` — повторный `AUDIO.VOLUME`. |
+| `settings.screen.controller`        | SHOW/HIDE; `beforeShow` → `SHOW_BEFORE`; `STATE_UPDATE` → `updateState`; `UPDATE_FAST`. Пустой `controls` на `ZINDEX`.                                                                                                                                         |
+| `settings.screen.controller.bg`     | Наследует `@vnejs/module.controller.bg`: `SHOW_BEFORE` → `bgSrc`; PRELOAD; `MEMORY.CLEARED` — preload и refresh при `isShow`.                                                                                                                                  |
+| `settings.screen.controller.fields` | На `SHOW_BEFORE`: фильтр tabs (`showInSettings`) → `STATE_UPDATE` `{ tabs, tab }` → `SETTINGS_VIEW.SHOW`.                                                                                                                                                      |
+| `settings.screen.hide.controls`     | Наследует `@vnejs/module.controller.hide.on.controls`: `BACK` / `MENU` / `GAMEMENU` → `HIDE`; PUSH/POP на SHOW/HIDE.                                                                                                                                           |
+| `settings.screen.hide.state`        | Наследует `@vnejs/module.controller.hide.on.state`: `STATE.SET` / `STATE.CLEAR` → `HIDE` с `{ isForce: true }`.                                                                                                                                                |
+| `settings.screen.controller.tabs`   | Наследник `ModuleControllerTabs`: `TAB_SET` → `applyTab` + `onTabSet` (`SETTINGS_VIEW.TAB_SET` + `UPDATE_FAST`); TAB_PREV/TAB_NEXT → `TAB_SET`; `getTabKeys` по `showInSettings`.                                                                              |
+| `settings.screen.view`              | Chrome экрана (Screen, tabs, cross); поля и example text — в `SETTINGS_VIEW`.                                                                                                                                                                                  |
 
 ## Близкие плагины
 

package/scenario.catalog/stubs/pause.md

@@ -3,14 +3,15 @@
 |                |                                                   |
 | -------------- | ------------------------------------------------- |
 | Тип            | `module` (`$`)                                    |
-| Сигнатура      | `$ pause`                                         |
-| Actions / args | —                                                 |
+| Сигнатура      | `$ pause [time]`                                  |
+| Actions / args | необязательный `time` (мс)                        |
 | Plugin doc     | [scenario/pause.md](../plugins/scenario/pause.md) |
 
 ## Примеры
 
 ```vne
 $ pause
+$ pause 300
 ```
 
 Source of truth: `SCENARIO_COMMANDS` в соответствующем `contracts/**/commands.ts`.

package/scenario.guide/flow.md

@@ -33,9 +33,10 @@ $ scenario goto loop_start
 
 ```vne
 $ pause
+$ pause 300
 ```
 
-Пауза сценария (ожидание игрока / логика плагина pause).
+Пауза сценария до клика или на `time` миллисекунд.
 
 ## save