@vnejs/docs 0.2.65 → 0.2.67

package/plugins/views.screens/disclaimer.md

@@ -1,76 +1,76 @@
 # plugins/views.screens/disclaimer/
 
-Пакет: `@vnejs/plugins.views.screens.disclaimer` · namespace: `DISCLAIMER`
+Package: `@vnejs/plugins.views.screens.disclaimer` · namespace: `DISCLAIMER`
 
-Полноэкранный дисклеймер по сценарной команде: заголовок, текст и кнопка принятия. Затемнение без фоновой картинки. Принятие не сохраняется — экран показывается при каждом вызове.
+Full-screen disclaimer via a scenario command: title, text, and accept button. Dim overlay, no background image. Acceptance is not saved — the screen shows on every call.
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.screens.disclaimer`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.views.screens.disclaimer`.
 
-| Ключ           | Строка                        | Смысл                                           |
-| -------------- | ----------------------------- | ----------------------------------------------- |
-| `SHOW`         | `vne:disclaimer:show`         | Показать UI. Payload: `{ id }`.                 |
-| `HIDE`         | `vne:disclaimer:hide`         | Скрыть UI.                                      |
-| `UPDATE`       | `vne:disclaimer:update`       | Обновить состояние или отображение.             |
-| `UPDATE_FAST`  | `vne:disclaimer:update_fast`  | Быстрое обновление отображения.                 |
-| `UPDATE_FORCE` | `vne:disclaimer:update_force` | Перерисовать view с `isForce`, стейт не меняет. |
-| `UPDATE_STATE` | `vne:disclaimer:update_state` | Слить partial в стейт контроллера.              |
-| `ACCEPT`       | `vne:disclaimer:accept`       | Пользователь принял дисклеймер → HIDE → next.   |
+| Key            | String                        | Meaning                                                |
+| -------------- | ----------------------------- | ------------------------------------------------------ |
+| `SHOW`         | `vne:disclaimer:show`         | Show the UI. Payload: `{ id }`.                        |
+| `HIDE`         | `vne:disclaimer:hide`         | Hide the UI.                                           |
+| `UPDATE`       | `vne:disclaimer:update`       | Update state or display.                               |
+| `UPDATE_FAST`  | `vne:disclaimer:update_fast`  | Fast display update.                                   |
+| `UPDATE_FORCE` | `vne:disclaimer:update_force` | Redraw the view with `isForce`; state does not change. |
+| `UPDATE_STATE` | `vne:disclaimer:update_state` | Merge a partial into controller state.                 |
+| `ACCEPT`       | `vne:disclaimer:accept`       | User accepted disclaimer → HIDE → next.                |
 
-## Константы
+## Constants
 
-- **`EXEC_ACTIONS.SHOW`** — `"show"`: действие сценарной команды.
-- **`LOGS_ACTIONS.SHOW` / `ACCEPT`** — метки логов при показе и принятии.
+- **`EXEC_ACTIONS.SHOW`** — `"show"`: scenario command action.
+- **`LOGS_ACTIONS.SHOW` / `ACCEPT`** — log labels on show and accept.
 
-## Параметры
+## Parameters
 
-| Ключ         | Тип      | Смысл                                                          |
+| Key          | Type     | Meaning                                                        |
 | ------------ | -------- | -------------------------------------------------------------- |
-| `TRANSITION` | `number` | Длительность анимации экрана.                                  |
-| `ZINDEX`     | `number` | z-index экрана.                                                |
-| `LOC_LABEL`  | `string` | Метка локализации (`disclaimer`).                              |
+| `TRANSITION` | `number` | Screen animation duration.                                     |
+| `ZINDEX`     | `number` | Screen z-index.                                                |
+| `LOC_LABEL`  | `string` | Localization label (`disclaimer`).                             |
 | `VIEW_PROPS` | `object` | Layout: screen (`withDark`/`withBlur`), title, text, controls. |
 
-## Настройки
+## Settings
 
-Нет.
+None.
 
-## Модули
+## Modules
 
-| Модуль                         | Зона ответственности                                                                                                                            |
-| ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- |
-| `disclaimer.controller`        | SHOW/HIDE; пустой `controls` на `ZINDEX`, чтобы стопорить слои ниже.                                                                            |
-| `disclaimer.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `DISCLAIMER.ACCEPT` → `HIDE`, `emit SCENARIO.NEXT`; PUSH/POP на SHOW/HIDE. |
-| `disclaimer`                   | `$ disclaimer show <id>` → SHOW.                                                                                                                |
-| `disclaimer.view`              | React UI: title / text / accept из locs.                                                                                                        |
+| Module                         | Role                                                                                                                                          |
+| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- |
+| `disclaimer.controller`        | SHOW/HIDE; empty `controls` on `ZINDEX` to block lower layers.                                                                                |
+| `disclaimer.controller.accept` | Extends `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `DISCLAIMER.ACCEPT` → `HIDE`, `emit SCENARIO.NEXT`; PUSH/POP on SHOW/HIDE. |
+| `disclaimer`                   | `$ disclaimer show <id>` → SHOW.                                                                                                              |
+| `disclaimer.view`              | React UI: title / text / accept from locs.                                                                                                    |
 
-## Локализация
+## Localization
 
-Файл `media/locs/{lang}/views/disclaimer.json`. Ключи:
+File `media/locs/{lang}/views/disclaimer.json`. Keys:
 
-| Ключ         | Смысл                                         |
-| ------------ | --------------------------------------------- |
-| `accept`     | Текст кнопки                                  |
-| `{id}.title` | Заголовок для id                              |
-| `{id}.text`  | Текст для id (можно многострочный через `\n`) |
+| Key          | Meaning                             |
+| ------------ | ----------------------------------- |
+| `accept`     | Button text                         |
+| `{id}.title` | Title for id                        |
+| `{id}.text`  | Text for id (multiline via `\n` ok) |
 
-## Сценарий
+## Scenario
 
 ```vne
 $ disclaimer show setting
 $ disclaimer show qte
 ```
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
 - [logs.md](../core/logs.md) — `LOGS`: `EVENTS.LOGS.EMIT` (`action`, …)
 - [scenario.md](../core/scenario.md) — `SCENARIO`: EVENTS.NEXT, EVENTS.LINE_EXEC_REG
 
-### Остальные
+### Other
 
 - [controls.md](../controls/controls.md) — `CONTROLS`: CONST.BUTTONS.ACCEPT, CONST.BUTTONS.INTERACT
-- [intro.md](./intro.md) — `INTRO`: похожий сценарный экран
-- [confirm.md](./confirm.md) — `CONFIRM`: затемнение и кнопки
+- [intro.md](./intro.md) — `INTRO`: similar scenario screen
+- [confirm.md](./confirm.md) — `CONFIRM`: dim overlay and buttons

package/plugins/views.screens/eula.md

@@ -1,54 +1,54 @@
 # plugins/views.screens/eula/
 
-Пакет: `@vnejs/plugins.views.screens.eula` · namespace: `EULA`
+Package: `@vnejs/plugins.views.screens.eula` · namespace: `EULA`
 
-Экран лицензионного соглашения перед главным меню, если версия ещё не принята.
+License agreement screen before the main menu, if the version is not accepted yet.
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.screens.eula`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.views.screens.eula`.
 
-| Ключ           | Строка                  | Смысл                                                                    |
-| -------------- | ----------------------- | ------------------------------------------------------------------------ |
-| `UPDATE`       | `vne:eula:update`       | Обновить состояние или отображение.                                      |
-| `UPDATE_FAST`  | `vne:eula:update_fast`  | Быстрый UPDATE view без анимации (стрелки по тексту).                    |
-| `UPDATE_FORCE` | `vne:eula:update_force` | Перерисовать view с `isForce`, стейт не меняет.                          |
-| `UPDATE_STATE` | `vne:eula:update_state` | Слить `{ currentArrowVerticalItem }` в стейт controller без UPDATE view. |
-| `SHOW`         | `vne:eula:show`         | Показать UI или слой.                                                    |
-| `HIDE`         | `vne:eula:hide`         | Скрыть UI или слой.                                                      |
-| `ACCEPT`       | `vne:eula:accept`       | Событие `ACCEPT` namespace плагина.                                      |
-| `EXIT`         | `vne:eula:exit`         | Событие `EXIT` namespace плагина.                                        |
+| Key            | String                  | Meaning                                                                         |
+| -------------- | ----------------------- | ------------------------------------------------------------------------------- |
+| `UPDATE`       | `vne:eula:update`       | Update state or display.                                                        |
+| `UPDATE_FAST`  | `vne:eula:update_fast`  | Fast UPDATE view without animation (arrows over text).                          |
+| `UPDATE_FORCE` | `vne:eula:update_force` | Redraw the view with `isForce`; state does not change.                          |
+| `UPDATE_STATE` | `vne:eula:update_state` | Merge `{ currentArrowVerticalItem }` into controller state without UPDATE view. |
+| `SHOW`         | `vne:eula:show`         | Show the UI or layer.                                                           |
+| `HIDE`         | `vne:eula:hide`         | Hide the UI or layer.                                                           |
+| `ACCEPT`       | `vne:eula:accept`       | Plugin namespace `ACCEPT` event.                                                |
+| `EXIT`         | `vne:eula:exit`         | Plugin namespace `EXIT` event.                                                  |
 
-## Константы
+## Constants
 
-Нет.
+None.
 
-## Параметры
+## Parameters
 
-| Ключ      | Тип       | Смысл                                                       |
-| --------- | --------- | ----------------------------------------------------------- |
-| `ENABLED` | `boolean` | Показывать экран при `MAINMENU.SHOW`; по умолчанию `false`. |
-| `LANGS`   | `string`  | Значение по умолчанию: "LANGS".                             |
+| Key       | Type      | Meaning                                              |
+| --------- | --------- | ---------------------------------------------------- |
+| `ENABLED` | `boolean` | Show the screen on `MAINMENU.SHOW`; default `false`. |
+| `LANGS`   | `string`  | Default: "LANGS".                                    |
 
-## Настройки
+## Settings
 
-| Ключ                                             | Тип      | Смысл                                                      |
-| ------------------------------------------------ | -------- | ---------------------------------------------------------- |
-| `ACCEPTED_VERSION` (`vne:eula:accepted_version`) | `string` | Настройка `vne:eula:accepted_version` в `shared.settings`. |
-| `LANG` (`vne:eula:lang`)                         | `string` | Настройка `vne:eula:lang` в `shared.settings`.             |
+| Key                                              | Type     | Meaning                                                   |
+| ------------------------------------------------ | -------- | --------------------------------------------------------- |
+| `ACCEPTED_VERSION` (`vne:eula:accepted_version`) | `string` | `vne:eula:accepted_version` setting in `shared.settings`. |
+| `LANG` (`vne:eula:lang`)                         | `string` | `vne:eula:lang` setting in `shared.settings`.             |
 
-## Модули
+## Modules
 
-| Модуль                   | Зона ответственности                                                                                                                                                                                                                                                                                                                                                        |
-| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `eula.controller`        | SHOW/HIDE; `BACK` → `EXIT`; зеркалит `UPDATE_STATE` / `UPDATE_FAST`; lang/locs. `onSettingChange`: при `SETTINGS.EULA.LANG` и `isShow` — `lang` + сброс `currentArrowVerticalItem`.                                                                                                                                                                                         |
-| `eula.controller.arrows` | Наследует `@vnejs/module.controller.arrows.vertical`: `ARROW_UP` / `ARROW_BOTTOM` по строкам текста; пустые строки через `isArrowItemAvailable`; смена `SETTINGS.EULA.LANG` сбрасывает индекс; PUSH/POP на SHOW/HIDE; эмитит `UPDATE_STATE` с `{ currentArrowVerticalItem }` и `UPDATE_FAST`. На `HIDE.CLEANUP` `currentArrowVerticalItem` в стейте становится `undefined`. |
-| `eula.controller.accept` | Наследует `@vnejs/module.controller.accept`: только `ACCEPT` (`IS_INTERACT_ENABLED = false`) → `EULA.ACCEPT` → `ACCEPTED_VERSION`, `HIDE`; PUSH/POP на SHOW/HIDE.                                                                                                                                                                                                           |
-| `eula.hide.state`        | Наследует `@vnejs/module.controller.hide.on.state`: `STATE.SET` / `STATE.CLEAR` → `HIDE` с `{ isForce: true }`.                                                                                                                                                                                                                                                             |
-| `eula`                   | В `setup` — `SETTINGS.INIT` для версии и языка; `MAINMENU.SHOW` → `SHOW` (если версия не принята); `EXIT` → `SYSTEM.CLOSE`.                                                                                                                                                                                                                                                 |
-| `eula.view`              | Подмодуль `view` плагина.                                                                                                                                                                                                                                                                                                                                                   |
+| Module                   | Role                                                                                                                                                                                                                                                                                                                                                             |
+| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `eula.controller`        | SHOW/HIDE; `BACK` → `EXIT`; mirrors `UPDATE_STATE` / `UPDATE_FAST`; lang/locs. `onSettingChange`: on `SETTINGS.EULA.LANG` when `isShow` — `lang` + reset `currentArrowVerticalItem`.                                                                                                                                                                             |
+| `eula.controller.arrows` | Extends `@vnejs/module.controller.arrows.vertical`: `ARROW_UP` / `ARROW_BOTTOM` over text lines; empty lines via `isArrowItemAvailable`; `SETTINGS.EULA.LANG` change resets index; PUSH/POP on SHOW/HIDE; emits `UPDATE_STATE` with `{ currentArrowVerticalItem }` and `UPDATE_FAST`. On `HIDE.CLEANUP` `currentArrowVerticalItem` in state becomes `undefined`. |
+| `eula.controller.accept` | Extends `@vnejs/module.controller.accept`: only `ACCEPT` (`IS_INTERACT_ENABLED = false`) → `EULA.ACCEPT` → `ACCEPTED_VERSION`, `HIDE`; PUSH/POP on SHOW/HIDE.                                                                                                                                                                                                    |
+| `eula.hide.state`        | Extends `@vnejs/module.controller.hide.on.state`: `STATE.SET` / `STATE.CLEAR` → `HIDE` with `{ isForce: true }`.                                                                                                                                                                                                                                                 |
+| `eula`                   | In `setup` — `SETTINGS.INIT` for version and language; `MAINMENU.SHOW` → `SHOW` (if version not accepted); `EXIT` → `SYSTEM.CLOSE`.                                                                                                                                                                                                                              |
+| `eula.view`              | Plugin `view` submodule.                                                                                                                                                                                                                                                                                                                                         |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
@@ -57,7 +57,7 @@ Payloads и результаты хендлеров типизированы ч
 - [state.md](../core/state.md) — `STATE`: EVENTS.SET, EVENTS.CLEAR
 - [system.md](../core/system.md) — `SYSTEM`: EVENTS.CLOSE
 
-### Остальные
+### Other
 
 - [controls.md](../controls/controls.md) — `CONTROLS`: CONST.BUTTONS.ARROW_UP, CONST.BUTTONS.ARROW_BOTTOM, CONST.BUTTONS.ACCEPT, CONST.BUTTONS.BACK
 - [mainmenu.md](./mainmenu.md) — `MAINMENU`: EVENTS.SHOW

package/plugins/views.screens/gallery.full.md

@@ -1,65 +1,65 @@
 # plugins/views.screens/gallery.full/
 
-Пакет: `@vnejs/plugins.views.screens.gallery.full` · namespace: `GALLERY_FULL_VIEW`
+Package: `@vnejs/plugins.views.screens.gallery.full` · namespace: `GALLERY_FULL_VIEW`
 
-Полноэкранный просмотр выбранного изображения из галереи.
+Full-screen view of the selected gallery image.
 
-`GALLERY.CHOOSE` с `isOpened: false` не открывает full-view. Залоченные вариации не грузят media: пустой `imageSrc` и `withBackgroundBlur`.
+`GALLERY.CHOOSE` with `isOpened: false` does not open full-view. Locked variations do not load media: empty `imageSrc` and `withBackgroundBlur`.
 
-Для вариаций с `layerChildType` фона src берётся через `LAYER_BG.SRC_GET` с `args.overlays` из выбранного варианта галереи.
+For background variations with `layerChildType`, src comes from `LAYER_BG.SRC_GET` with `args.overlays` from the selected gallery variant.
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.screens.gallery.full`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.views.screens.gallery.full`.
 
-| Ключ           | Строка                          | Смысл                                           |
-| -------------- | ------------------------------- | ----------------------------------------------- |
-| `SHOW`         | `vne:gallery_full:show`         | Показать UI или слой.                           |
-| `HIDE`         | `vne:gallery_full:hide`         | Скрыть UI или слой.                             |
-| `UPDATE`       | `vne:gallery_full:update`       | Обновить состояние или отображение.             |
-| `UPDATE_FAST`  | `vne:gallery_full:update_fast`  | Быстрое обновление отображения.                 |
-| `UPDATE_FORCE` | `vne:gallery_full:update_force` | Перерисовать view с `isForce`, стейт не меняет. |
-| `UPDATE_STATE` | `vne:gallery_full:update_state` | Слить partial в стейт контроллера и модулей, подписанных на событие. |
-| `LOAD`         | `vne:gallery_full:load`         | Загрузить вариацию. Payload `{ pageIndex }`. |
-| `LOAD_SRC`     | `vne:gallery_full:load_src`     | Получить src вариации. Payload — вариант, результат — src. |
-| `PREV`         | `vne:gallery_full:prev`         | Предыдущая вариация (`EVENT_PAGE_PREV`).            |
-| `NEXT`         | `vne:gallery_full:next`         | Следующая вариация (`EVENT_PAGE_NEXT`).             |
-| `PAGE_SET`     | `vne:gallery_full:page_set`     | Абсолютный прыжок вариации (`{ pageIndex }`).       |
+| Key            | String                          | Meaning                                                                    |
+| -------------- | ------------------------------- | -------------------------------------------------------------------------- |
+| `SHOW`         | `vne:gallery_full:show`         | Show the UI or layer.                                                      |
+| `HIDE`         | `vne:gallery_full:hide`         | Hide the UI or layer.                                                      |
+| `UPDATE`       | `vne:gallery_full:update`       | Update state or display.                                                   |
+| `UPDATE_FAST`  | `vne:gallery_full:update_fast`  | Fast display update.                                                       |
+| `UPDATE_FORCE` | `vne:gallery_full:update_force` | Redraw the view with `isForce`; state does not change.                     |
+| `UPDATE_STATE` | `vne:gallery_full:update_state` | Merge a partial into controller state and modules subscribed to the event. |
+| `LOAD`         | `vne:gallery_full:load`         | Load a variation. Payload `{ pageIndex }`.                                 |
+| `LOAD_SRC`     | `vne:gallery_full:load_src`     | Get variation src. Payload — variant, result — src.                        |
+| `PREV`         | `vne:gallery_full:prev`         | Previous variation (`EVENT_PAGE_PREV`).                                    |
+| `NEXT`         | `vne:gallery_full:next`         | Next variation (`EVENT_PAGE_NEXT`).                                        |
+| `PAGE_SET`     | `vne:gallery_full:page_set`     | Absolute variation jump (`{ pageIndex }`).                                 |
 
-## Константы
+## Constants
 
-Нет.
+None.
 
-## Параметры
+## Parameters
 
-| Ключ         | Тип      | Смысл                                |
-| ------------ | -------- | ------------------------------------ |
-| `TRANSITION` | `string` | Значение по умолчанию: "TRANSITION". |
+| Key          | Type     | Meaning                |
+| ------------ | -------- | ---------------------- |
+| `TRANSITION` | `string` | Default: "TRANSITION". |
 
-## Настройки
+## Settings
 
-Нет.
+None.
 
-## Модули
+## Modules
 
-| Модуль                       | Зона ответственности                                                                                                 |
-| ---------------------------- | -------------------------------------------------------------------------------------------------------------------- |
-| `gallery.full.bridge`               | `GALLERY.CHOOSE` с `isOpened: true` → `SHOW`.                                                                       |
-| `gallery.full.controller`           | `onShowBefore` пишет `itemFullName` / `itemMediaType` / `itemLayerChildType` / `variants` в `UPDATE_STATE` и эмитит `LOAD` `{ pageIndex: 0 }`. `onHideAfter` сбрасывает этот контекст через `UPDATE_STATE`. |
-| `gallery.full.load`                 | `LOAD` → `onLoad` по `state.variants`; для открытой вариации эмитит `LOAD_SRC`. `UPDATE_STATE` сливает partial в стейт модуля. |
-| `gallery.full.load.src`             | `LOAD_SRC` → `loadVariationSrc`: media по имени или `LAYER_BG.SRC_GET` для фона.                                     |
-| `gallery.full.variation`            | Наследует `@vnejs/module.controller.pages`: `EVENT_PAGE_PREV`/`NEXT`/`SET` = `PREV`/`NEXT`/`PAGE_SET`; стейт `pageIndex` / `pagesCount`; `applyPage` → `LOAD` `{ pageIndex }`. |
-| `gallery.full.controller.arrows`    | `onArrowLeft` / `onArrowRight` → `PREV` / `NEXT`; PUSH/POP на SHOW/HIDE.                                              |
-| `gallery.full.hide.controls`        | Наследует `@vnejs/module.controller.hide.on.controls`: `BACK` / `MENU` / `GAMEMENU` → `HIDE`; PUSH/POP на SHOW/HIDE. |
-| `gallery.full.view`                 | Подмодуль `full.view` плагина.                                                                                       |
+| Module                           | Role                                                                                                                                                                                                      |
+| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `gallery.full.bridge`            | `GALLERY.CHOOSE` with `isOpened: true` → `SHOW`.                                                                                                                                                          |
+| `gallery.full.controller`        | `onShowBefore` writes `itemFullName` / `itemMediaType` / `itemLayerChildType` / `variants` into `UPDATE_STATE` and emits `LOAD` `{ pageIndex: 0 }`. `onHideAfter` resets this context via `UPDATE_STATE`. |
+| `gallery.full.load`              | `LOAD` → `onLoad` by `state.variants`; for an open variation emits `LOAD_SRC`. `UPDATE_STATE` merges a partial into module state.                                                                         |
+| `gallery.full.load.src`          | `LOAD_SRC` → `loadVariationSrc`: media by name or `LAYER_BG.SRC_GET` for background.                                                                                                                      |
+| `gallery.full.variation`         | Extends `@vnejs/module.controller.pages`: `EVENT_PAGE_PREV`/`NEXT`/`SET` = `PREV`/`NEXT`/`PAGE_SET`; state `pageIndex` / `pagesCount`; `applyPage` → `LOAD` `{ pageIndex }`.                              |
+| `gallery.full.controller.arrows` | `onArrowLeft` / `onArrowRight` → `PREV` / `NEXT`; PUSH/POP on SHOW/HIDE.                                                                                                                                  |
+| `gallery.full.hide.controls`     | Extends `@vnejs/module.controller.hide.on.controls`: `BACK` / `MENU` / `GAMEMENU` → `HIDE`; PUSH/POP on SHOW/HIDE.                                                                                        |
+| `gallery.full.view`              | Plugin `full.view` submodule.                                                                                                                                                                             |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
-— нет
+— None
 
-### Остальные
+### Other
 
 - [controls.md](../controls/controls.md) — `CONTROLS`: CONST.BUTTONS.BACK, CONST.BUTTONS.MENU, CONST.BUTTONS.GAMEMENU
 - [gallery.md](./gallery.md) — `GALLERY`: EVENTS.CHOOSE

package/plugins/views.screens/gallery.md

@@ -1,80 +1,80 @@
 # plugins/views.screens/gallery/
 
-Пакет: `@vnejs/plugins.views.screens.gallery` · namespace: `GALLERY`
-
-Галерея CG с вкладками и сеткой; открытые изображения отмечаются в storage.
-
-ACCEPT/INTERACT эмитит `CHOOSE` только для выбранного открытого слота (`isOpened`, не stub); без выделения или на залоченном слоте — no-op. Клик мыши уже вешается только на открытые слоты.
-
-Вариации вкладки (`GalleryTabContentVariation`) несут `overlays: Record<string, string | number>` — та же карта, что у [bg.md](../canvas/bg.md) args; значения нормализуются в строки перед показом / full-view.
-
-## События
-
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.views.screens.gallery`.
-
-| Ключ                | Строка                          | Смысл                                                                                                            |
-| ------------------- | ------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
-| `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`          | Абсолютный прыжок пагинации UI (`{ pageIndex }`).                                                                |
-| `TAB_SET`           | `vne:gallery:tab_set`           | Выбрать вкладку галереи (`{ tab }`).                                                                             |
-| `UPDATE`            | `vne:gallery:update`            | Обновить состояние или отображение.                                                                              |
-| `UPDATE_FAST`       | `vne:gallery:update_fast`       | Перерисовать view с `isFast`, без смены стейта.                                                                  |
-| `UPDATE_FORCE`      | `vne:gallery:update_force`      | Перерисовать view с `isForce`, стейт не меняет.                                                                  |
-| `PRELOAD`           | `vne:gallery:preload`           | Событие `PRELOAD` namespace плагина.                                                                             |
-| `CHOOSE`            | `vne:gallery:choose`            | Событие `CHOOSE` namespace плагина.                                                                              |
-| `ACCEPT`            | `vne:gallery:accept`            | ACCEPT / INTERACT по выбранному слоту.                                                                           |
-| `UPDATE_STATE`      | `vne:gallery:update_state`      | Слить 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` (+ `UPDATE_STATE`).                                     |
-| `GRID_UPDATE_ITEMS` | `vne:gallery:grid_update_items` | Пересобрать сетку из стейта (без payload) → `UPDATE_STATE` `{ gridItems }`. Meta — заранее через `UPDATE_STATE`. |
-| `PAGE_ITEMS_GET`    | `vne:gallery:page_items_get`    | Собрать UI-слот из content (`CHECK` + media); возврат item. Вместо `ITEM_CREATE`.                                |
-
-## Константы
-
-Нет.
-
-## Параметры
-
-| Ключ         | Тип      | Смысл                                                                             |
-| ------------ | -------- | --------------------------------------------------------------------------------- |
-| `TABS`       | `string` | Значение по умолчанию: "TABS".                                                    |
-| `BACKGROUND` | `string` | Значение по умолчанию: "save".                                                    |
-| `TRANSITION` | `string` | Значение по умолчанию: "TRANSITION".                                              |
-| `ZINDEX`     | `string` | Значение по умолчанию: "ZINDEX".                                                  |
-| `LOC_LABEL`  | `string` | Имя метки или стартовой точки.                                                    |
-| `VIEW_PROPS` | `string` | Значение по умолчанию: "VIEW_PROPS".                                              |
-| `ROWS`       | `string` | Значение по умолчанию: "ROWS".                                                    |
-| `COLUMNS`    | `string` | Значение по умолчанию: "COLUMNS".                                                 |
-| `AUDIO_NAME` | `string` | Имя трека на слое `view` при открытии экрана; пустая строка — без overlay-музыки. |
-
-## Настройки
-
-Нет.
-
-## Модули
-
-| Модуль                           | Зона ответственности                                                                                                                                                                                                                                                                                                                                                                                 |
-| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `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 по фазам `CONST.COMPONENTS.LIFECYCLE_PRIORITY`; на `SHOW.BEFORE` — `TAB_SET`. `UPDATE_STATE` / `UPDATE_FAST`; пустой `controls` на `ZINDEX`.                                                                                                                                                                                                                                               |
-| `gallery.controller.bg`          | Наследует `@vnejs/module.controller.bg`: `SHOW` + `LIFECYCLE_PRIORITY.SHOW.BEFORE` → `UPDATE_STATE` `{ 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` → `UPDATE_STATE` `{ 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); зеркалит `UPDATE_STATE` (`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 позиции не входят). На `HIDE.CLEANUP` `gridRow` / `gridColumn` в стейте становятся `undefined`. |
-| `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`, `UPDATE_STATE` `{ gridIndex, gridsCount }`, `GRID_UPDATE_ITEMS`; при `isUpdateView` — `UPDATE_FAST` + `MEMORY.CLEAR`); TAB_PREV/TAB_NEXT → `TAB_SET`.                                                                                                                             |
-| `gallery`                        | Обрабатывает OPEN, CHECK, CLEAR.                                                                                                                                                                                                                                                                                                                                                                     |
-| `gallery.view`                   | Подмодуль `view` плагина.                                                                                                                                                                                                                                                                                                                                                                            |
-
-## Близкие плагины
+Package: `@vnejs/plugins.views.screens.gallery` · namespace: `GALLERY`
+
+CG gallery with tabs and a grid; opened images are marked in storage.
+
+ACCEPT/INTERACT emits `CHOOSE` only for the selected open slot (`isOpened`, not stub); with no selection or on a locked slot — no-op. Mouse click is wired only on open slots.
+
+Tab variations (`GalleryTabContentVariation`) carry `overlays: Record<string, string | number>` — the same map as [bg.md](../canvas/bg.md) args; values normalize to strings before show / full-view.
+
+## Events
+
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.views.screens.gallery`.
+
+| Key                 | String                          | Meaning                                                                                                           |
+| ------------------- | ------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
+| `OPEN`              | `vne:gallery:open`              | Open the screen or panel.                                                                                         |
+| `CHECK`             | `vne:gallery:check`             | Check state or resource presence.                                                                                 |
+| `CLEAR`             | `vne:gallery:clear`             | Clear accumulated state.                                                                                          |
+| `SHOW`              | `vne:gallery:show`              | Show the UI or layer.                                                                                             |
+| `HIDE`              | `vne:gallery:hide`              | Hide the UI or layer.                                                                                             |
+| `PAGE_SET`          | `vne:gallery:page_set`          | Absolute UI pagination jump (`{ pageIndex }`).                                                                    |
+| `TAB_SET`           | `vne:gallery:tab_set`           | Pick a gallery tab (`{ tab }`).                                                                                   |
+| `UPDATE`            | `vne:gallery:update`            | Update state or display.                                                                                          |
+| `UPDATE_FAST`       | `vne:gallery:update_fast`       | Redraw the view with `isFast`, without a state change.                                                            |
+| `UPDATE_FORCE`      | `vne:gallery:update_force`      | Redraw the view with `isForce`; state does not change.                                                            |
+| `PRELOAD`           | `vne:gallery:preload`           | Plugin namespace `PRELOAD` event.                                                                                 |
+| `CHOOSE`            | `vne:gallery:choose`            | Plugin namespace `CHOOSE` event.                                                                                  |
+| `ACCEPT`            | `vne:gallery:accept`            | ACCEPT / INTERACT on the selected slot.                                                                           |
+| `UPDATE_STATE`      | `vne:gallery:update_state`      | Merge a partial into state (`grid*`, `tab`, `pageIndex` / `pagesCount`, …).                                       |
+| `GRID_NEXT`         | `vne:gallery:grid_next`         | Grid edge forward; `gallery.controller.pages` listens as `EVENT_PAGE_NEXT`.                                       |
+| `GRID_PREV`         | `vne:gallery:grid_prev`         | Grid edge backward; `gallery.controller.pages` listens as `EVENT_PAGE_PREV`.                                      |
+| `GRID_CLEAR`        | `vne:gallery:grid_clear`        | Clear cell selection: `gridRow` / `gridColumn` → `null` (+ `UPDATE_STATE`).                                       |
+| `GRID_UPDATE_ITEMS` | `vne:gallery:grid_update_items` | Rebuild the grid from state (no payload) → `UPDATE_STATE` `{ gridItems }`. Meta — set earlier via `UPDATE_STATE`. |
+| `PAGE_ITEMS_GET`    | `vne:gallery:page_items_get`    | Build a UI slot from content (`CHECK` + media); return item. Replaces `ITEM_CREATE`.                              |
+
+## Constants
+
+None.
+
+## Parameters
+
+| Key          | Type     | Meaning                                                                                |
+| ------------ | -------- | -------------------------------------------------------------------------------------- |
+| `TABS`       | `string` | Default: "TABS".                                                                       |
+| `BACKGROUND` | `string` | Default: "save".                                                                       |
+| `TRANSITION` | `string` | Default: "TRANSITION".                                                                 |
+| `ZINDEX`     | `string` | Default: "ZINDEX".                                                                     |
+| `LOC_LABEL`  | `string` | Label name or entry point.                                                             |
+| `VIEW_PROPS` | `string` | Default: "VIEW_PROPS".                                                                 |
+| `ROWS`       | `string` | Default: "ROWS".                                                                       |
+| `COLUMNS`    | `string` | Default: "COLUMNS".                                                                    |
+| `AUDIO_NAME` | `string` | Track name on the `view` layer when the screen opens; empty string — no overlay music. |
+
+## Settings
+
+None.
+
+## Modules
+
+| Module                           | Role                                                                                                                                                                                                                                                                                                                                                                              |
+| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `gallery.controller.audio`       | `ModuleControllerAudio` subclass: SHOW/HIDE/PRELOAD → pause global, play/stop `view` track; `VOLUME_SETTING = MUSIC.VOLUME`; SHOW passes a computed `volume` into `AUDIO.PLAY`; on `VOLUME_CHANGED` / `VOLUME_SETTING` change — `AUDIO.VOLUME` again.                                                                                                                             |
+| `gallery.controller`             | SHOW/HIDE by `CONST.COMPONENTS.LIFECYCLE_PRIORITY` phases; on `SHOW.BEFORE` — `TAB_SET`. `UPDATE_STATE` / `UPDATE_FAST`; empty `controls` on `ZINDEX`.                                                                                                                                                                                                                            |
+| `gallery.controller.bg`          | Extends `@vnejs/module.controller.bg`: `SHOW` + `LIFECYCLE_PRIORITY.SHOW.BEFORE` → `UPDATE_STATE` `{ bgSrc }`; PRELOAD → background warm-cache; `MEMORY.CLEARED` when `isShow` → refresh `bgSrc` + `UPDATE_FAST`.                                                                                                                                                                 |
+| `gallery.controller.preload`     | PRELOAD — page 0 of the first tab via `PAGE_ITEMS_GET`; `MEMORY.CLEARED` when `isShow` — current / neighbor pages + page 0 of other tabs (`getItemsOnPage` / `getMaxPagesCount` on the fly).                                                                                                                                                                                      |
+| `gallery.controller.pages`       | Extends `@vnejs/module.controller.pages`: `EVENT_*` → `GALLERY`; `EVENT_PAGE_NEXT`/`PREV` = `GRID_NEXT`/`PREV`; `applyPage` → `UPDATE_STATE` `{ gridIndex, gridsCount }` + `GRID_UPDATE_ITEMS` + `MEMORY.CLEAR`; state `pageIndex` / `pagesCount` (written by tabs).                                                                                                              |
+| `gallery.controller.pages.items` | On `PAGE_ITEMS_GET` builds a UI slot: `CHECK` + media (`MEDIA.LOAD`); return item.                                                                                                                                                                                                                                                                                                |
+| `gallery.controller.accept`      | Extends `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CHOOSE` only when the slot is open (`isOpened`, not stub); mirrors `UPDATE_STATE` (`grid*`); PUSH/POP on SHOW/HIDE.                                                                                                                                                                                |
+| `gallery.controller.grid`        | Extends `@vnejs/module.controller.arrows.grid`: four arrows; `isDisableGridChangeVertical = true` (vertical does not flip pages); at column edge — `GRID_NEXT`/`PREV`; `GRID_CLEAR`; on `GRID_UPDATE_ITEMS` — `getGridItems` via `PAGE_ITEMS_GET` (stubs for layout only; not in count or snap position). On `HIDE.CLEANUP` `gridRow` / `gridColumn` in state become `undefined`. |
+| `gallery.hide.controls`          | Extends `@vnejs/module.controller.hide.on.controls`: `BACK` / `MENU` / `GAMEMENU` → `HIDE`; PUSH/POP on SHOW/HIDE.                                                                                                                                                                                                                                                                |
+| `gallery.hide.state`             | Extends `@vnejs/module.controller.hide.on.state`: `STATE.SET` / `STATE.CLEAR` → `HIDE` with `{ isForce: true }`.                                                                                                                                                                                                                                                                  |
+| `gallery.controller.tabs`        | `ModuleControllerTabs` subclass: `TAB_SET` → `applyTab` + `onTabSet` (`pageIndex: 0`, `pagesCount`, `GRID_CLEAR`, `UPDATE_STATE` `{ gridIndex, gridsCount }`, `GRID_UPDATE_ITEMS`; when `isUpdateView` — `UPDATE_FAST` + `MEMORY.CLEAR`); TAB_PREV/TAB_NEXT → `TAB_SET`.                                                                                                          |
+| `gallery`                        | Handles OPEN, CHECK, CLEAR.                                                                                                                                                                                                                                                                                                                                                       |
+| `gallery.view`                   | Plugin `view` submodule.                                                                                                                                                                                                                                                                                                                                                          |
+
+## Related plugins
 
 ### plugins/core/