@vnejs/docs 0.2.59 → 0.2.61

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (16) hide show
  1. package/CHANGELOG.md +18 -0
  2. package/README.md +1 -0
  3. package/architecture.md +41 -17
  4. package/package.json +1 -1
  5. package/plugins/views/controls.hints.md +5 -5
  6. package/plugins/views/settings.md +5 -5
  7. package/plugins/views.scenario/choose.md +7 -7
  8. package/plugins/views.scenario/interface.md +9 -8
  9. package/plugins/views.screens/checkers.md +9 -9
  10. package/plugins/views.screens/confirm.md +8 -8
  11. package/plugins/views.screens/eula.md +8 -8
  12. package/plugins/views.screens/gallery.md +15 -15
  13. package/plugins/views.screens/gamemenu.md +9 -9
  14. package/plugins/views.screens/history.md +15 -15
  15. package/plugins/views.screens/mainmenu.md +12 -12
  16. package/plugins/views.screens/save.md +15 -15
package/CHANGELOG.md CHANGED
@@ -2,6 +2,24 @@
2
2
 
3
3
  Краткая история изменений движка (плагины, helpers, packages, CLI и прочий runtime) и внешнего API. Версии — релизы пакета `@vnejs/docs`.
4
4
 
5
+ ## 0.2.61
6
+
7
+ - `views.scenario/interface` — подписки `INTERFACE.SHOW` и `INTERFACE.HIDE` в модуле `interface.actions.show`. На `GATE` они обрывают остальных подписчиков, если интерфейс уже показан или уже скрыт, либо show/hide уже выполняется. Показ скрытого слоя шлёт `EVENTS.INTERFACE.VISIBLE`. API: `InterfaceShow.onShowGate`, `InterfaceShow.onHideGate`, `InterfaceShow.isInShowOrHideProcess`, `InterfaceShow.setShow`, `CONST.COMPONENTS.LIFECYCLE_PRIORITY.SHOW.GATE`, `CONST.COMPONENTS.LIFECYCLE_PRIORITY.HIDE.GATE`.
8
+ - `views/controls.hints` — show/hide группы по `showEvents` / `hideEvents` сохраняют `isForce` исходного события: `isForce: true` обновляет view через `UPDATE_FORCE`, иначе через `UPDATE_FAST`. API: `ControlsHintsController.onGroupShow`, `ControlsHintsController.onGroupHide`, `ControlsHintsController.updateGroupStateAndView`.
9
+ - `backends/auth`, `backends/content` — локальный запуск: `npm run dev` (`npm start` то же самое), auth `127.0.0.1:8787`, content `127.0.0.1:8788`. Секрет из `.env`; пустой `AUTH_SECRET` → `500`, не ошибка WebCrypto.
10
+ - `backends/auth` — `GET /` показывает статус входа и кнопку на `/steam/start`. Origin самого воркера для этой страницы допускается вместе с `ALLOWED_ORIGINS`.
11
+ - `backends/auth` — `isOwnedByUser` (ранее `isPurchasedByUser`): `ownsApp` в JWT без требования `permanent` в ответе CheckAppOwnership; по-прежнему отсекаются `sitelicense` и чужой `ownersteamid`.
12
+ - `backends/auth` — env `APP_DEMO_ID` (по умолчанию `5081630`); CheckAppOwnership для демо, в JWT и на тестовой странице `GET /` — `ownsDemoApp` отдельно от `ownsApp`.
13
+ - `backends/auth` — тестовая страница и `/session`: имя (`GetPlayerSummaries`), локальное время окончания JWT (`expiresAt`, формат `DD.MM hh:mm:ss`), кнопка «Обновить сессию» (`GET /session`).
14
+ - `backends/shared` — `TOKEN_TTL_SECONDS`: JWT живёт 3 суток.
15
+ - `backends/auth`, `backends/content` — HTTP на Fastify; локально `npm run dev` (`node --env-file=.env` + `tsx`, порты 8787/8788). Опционально `npm run dev:worker` (Wrangler + Fastify через `inject`).
16
+
17
+ ## 0.2.60
18
+
19
+ - `backends/auth`, `backends/content` — воркеры токена Steam и выдачи `dist/label`. Контент отдаётся только с JWT, в котором `ownsApp` true.
20
+ - `views.screens/history` — закрытие крестиком сверху справа, клик шлёт `EVENTS.HISTORY_VIEW.HIDE`. Текстовая кнопка внизу снята. Список реплик высотой 1800 по вертикали по центру экрана. API: `PARAMS.HISTORY_VIEW.VIEW_PROPS.close` теперь `{ position, svg }`.
21
+ - `module.controller.arrows.vertical`, `module.controller.arrows.horizontal`, `module.controller.arrows.grid` — на `HIDE.CLEANUP` позиция пункта в стейте становится `undefined` через `UPDATE_STATE`, затем `UPDATE_FAST` перерисовывает view. API: `currentArrowVerticalItem`, `currentArrowHorizontalItem`, `gridRow`, `gridColumn`, `CONST.COMPONENTS.LIFECYCLE_PRIORITY.HIDE.CLEANUP`.
22
+
5
23
  ## 0.2.59
6
24
 
7
25
  - `views.scenario/interface.controls`, `views.scenario/interface.fastforward` — hide не сбрасывает локальный стейт (`SHOULD_CLEAR_STATE_ON_CLEANUP` = `false`). Иначе `$ interface show` после выбора публиковал `isVisible: false`, и кнопки с индикатором прокрутки оставались прозрачными. API: `InterfaceControlsController.SHOULD_CLEAR_STATE_ON_CLEANUP`, `InterfaceFastforwardController.SHOULD_CLEAR_STATE_ON_CLEANUP`.
package/README.md CHANGED
@@ -45,6 +45,7 @@ npm i @vnejs/docs
45
45
  | [`uis/`](./architecture.md#uis) | React-компоненты для view-плагинов |
46
46
  | [`cli/`](./architecture.md#cli) | Сборка монорепы и игр |
47
47
  | [`games/`](./architecture.md#games) | Проекты игр: сценарий, entry, dist |
48
+ | [`backends/`](./architecture.md#backends) | Workers: токен Steam и JSON меток |
48
49
  | [`vs_code_extensions/`](./architecture.md#vs_code_extensions) | Подсветка `.vne` в редакторе |
49
50
 
50
51
  `games/` подключает один `bundles/` и получает `VneCore` — точку входа в движок.
package/architecture.md CHANGED
@@ -40,6 +40,7 @@ flowchart LR
40
40
  flowchart TD
41
41
  G[games/] --> B[bundles/]
42
42
  G --> CLI[cli/]
43
+ G -.->|HTTP| BE[backends/]
43
44
  B --> P[plugins/]
44
45
  B --> C[compatibility/]
45
46
  P --> CT[contracts/]
@@ -60,6 +61,7 @@ flowchart TD
60
61
  | От | К | Смысл |
61
62
  | ---------------- | ----------------------------------- | -------------------------------------------------------- |
62
63
  | `games/` | `bundles/`, `cli/` | Игра не знает про отдельные плагины; сборка через `cli/` |
64
+ | `games/` | `backends/` | HTTP к воркерам токена и меток, без импорта пакетов |
63
65
  | `bundles/` | `plugins/`, `compatibility/` | Только импорт нужного набора |
64
66
  | `plugins/` | `contracts/` | Реализация следует объявленному API |
65
67
  | `plugins/` | `modules_extensions/` → `packages/` | Модули наследуют базы, базы опираются на shared/observer |
@@ -184,9 +186,9 @@ flowchart TD
184
186
  | **`@vnejs/module.controller.bg`** | Статичный фон экрана: `SHOW.BEFORE` пишет `bgSrc` через `UPDATE_STATE`; `isShow` приходит из `UPDATE_STATE`. Опционально PRELOAD / start / STATE.CLEAR; `MEMORY.CLEARED` — preload и/или refresh при `isShow` |
185
187
  | **`@vnejs/module.controller.accept`** | ACCEPT / INTERACT → событие ACCEPT плагина; PUSH/POP controls на `SHOW.CONTROLS` / `HIDE.CONTROLS` |
186
188
  | **`@vnejs/module.controller.interact`** | `BUTTONS.ANY` → `INTERACT.EMIT`; после показа `INTERACT.PUSH` (`onInteract`), перед скрытием `INTERACT.POP`; PUSH/POP controls на `SHOW.CONTROLS` / `HIDE.CONTROLS` |
187
- | **`@vnejs/module.controller.arrows.vertical`** | ARROW_UP / ARROW_BOTTOM по видимым пунктам; PUSH/POP controls на `SHOW.CONTROLS` / `HIDE.CONTROLS`; индекс через `UPDATE_STATE` |
188
- | **`@vnejs/module.controller.arrows.horizontal`** | ARROW_LEFT / ARROW_RIGHT по пунктам; PUSH/POP controls на `SHOW.CONTROLS` / `HIDE.CONTROLS`; индекс через `UPDATE_STATE` |
189
- | **`@vnejs/module.controller.arrows.grid`** | Четыре стрелки по сетке; `GRID_NEXT` / `GRID_PREV` на краю; PUSH/POP на `SHOW.CONTROLS` / `HIDE.CONTROLS`; `GRID_UPDATE_ITEMS` без payload, meta через `UPDATE_STATE` |
189
+ | **`@vnejs/module.controller.arrows.vertical`** | ARROW_UP / ARROW_BOTTOM по видимым пунктам; PUSH/POP controls на `SHOW.CONTROLS` / `HIDE.CONTROLS`; индекс через `UPDATE_STATE`; на `HIDE.CLEANUP` `currentArrowVerticalItem` становится `undefined` через `UPDATE_STATE`, затем `UPDATE_FAST` |
190
+ | **`@vnejs/module.controller.arrows.horizontal`** | ARROW_LEFT / ARROW_RIGHT по пунктам; PUSH/POP controls на `SHOW.CONTROLS` / `HIDE.CONTROLS`; индекс через `UPDATE_STATE`; на `HIDE.CLEANUP` `currentArrowHorizontalItem` становится `undefined` через `UPDATE_STATE`, затем `UPDATE_FAST` |
191
+ | **`@vnejs/module.controller.arrows.grid`** | Четыре стрелки по сетке; `GRID_NEXT` / `GRID_PREV` на краю; PUSH/POP на `SHOW.CONTROLS` / `HIDE.CONTROLS`; `GRID_UPDATE_ITEMS` без payload, meta через `UPDATE_STATE`; на `HIDE.CLEANUP` `gridRow` / `gridColumn` становятся `undefined` через `UPDATE_STATE`, затем `UPDATE_FAST` |
190
192
  | **`@vnejs/module.controller.pages`** | Пагинация: `PAGE_SET` / `PAGE_NEXT` / `PAGE_PREV` → `setPage` → `UPDATE_STATE` (`pageIndex`) + abstract `applyPage` + `UPDATE_FAST` |
191
193
  | **`@vnejs/module.controller.hide.on.state`** | STATE.SET / STATE.CLEAR → emit HIDE плагина (`isForce` задаёт наследник) |
192
194
  | **`@vnejs/module.controller.hide.on.controls`** | BACK / MENU / GAMEMENU → emit HIDE плагина; PUSH/POP controls на `SHOW.CONTROLS` / `HIDE.CONTROLS` |
@@ -460,6 +462,27 @@ flowchart LR
460
462
 
461
463
  ---
462
464
 
465
+ ## backends/
466
+
467
+ **Отдельные Cloudflare Workers** — не плагины и не часть `VneCore`. Игра ходит к ним по HTTP. Пакеты в `plugins/` их не импортируют.
468
+
469
+ | Пакет | Назначение |
470
+ | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
471
+ | **`backends/auth`** | Steam OpenID и проверка покупки своего AppID. Отдаёт подписанный JWT (`steamId`, `ownsApp`, `exp`). |
472
+ | **`backends/content`** | `GET /label/*` — JSON меток из `dist/label`. Пускает только запрос с тем же JWT и `ownsApp`. Картинки и `mods.json` не отдаёт. |
473
+
474
+ Оба воркера знают один `AUTH_SECRET`. Контент-воркер Steam не вызывает. Каталог ассетов при деплое указывает на `dist` игры, сами JSON в репозиторий воркера не копируются. Закрытый деплой не кладёт то же дерево `label/` рядом со статикой игры.
475
+
476
+ ```mermaid
477
+ flowchart LR
478
+ Game[games/] -->|popup OpenID| Auth[backends/auth]
479
+ Auth --> Steam[steamcommunity.com]
480
+ Game -->|GET /label Bearer| Content[backends/content]
481
+ Auth -.->|общий AUTH_SECRET| Content
482
+ ```
483
+
484
+ ---
485
+
463
486
  ## vs_code_extensions/
464
487
 
465
488
  **Расширения редактора** для формата сценария — не runtime.
@@ -524,19 +547,20 @@ flowchart TD
524
547
 
525
548
  ## Резюме
526
549
 
527
- | Каталог | Одной фразой |
528
- | ------------------------- | --------------------------- |
529
- | **`packages/`** | Реестр, шина, VneCore |
530
- | **`modules_extensions/`** | Базовые классы модулей |
531
- | **`configs/`** | Общие tsconfig |
532
- | **`contracts/`** | API плагина: события, типы |
533
- | **`plugins/`** | Реализация на шине |
534
- | **`compatibility/`** | Opt-in связка двух плагинов |
535
- | **`bundles/`** | Набор способностей для игры |
536
- | **`helpers/`** | Утилиты без движка |
537
- | **`uis/`** | React/UI для view |
538
- | **`cli/`** | Сборка монорепы и игр |
539
- | **`games/`** | Сценарий + entry + dist |
540
- | **`vs_code_extensions/`** | Подсветка `.vne` |
550
+ | Каталог | Одной фразой |
551
+ | ------------------------- | --------------------------------- |
552
+ | **`packages/`** | Реестр, шина, VneCore |
553
+ | **`modules_extensions/`** | Базовые классы модулей |
554
+ | **`configs/`** | Общие tsconfig |
555
+ | **`contracts/`** | API плагина: события, типы |
556
+ | **`plugins/`** | Реализация на шине |
557
+ | **`compatibility/`** | Opt-in связка двух плагинов |
558
+ | **`bundles/`** | Набор способностей для игры |
559
+ | **`helpers/`** | Утилиты без движка |
560
+ | **`uis/`** | React/UI для view |
561
+ | **`cli/`** | Сборка монорепы и игр |
562
+ | **`games/`** | Сценарий + entry + dist |
563
+ | **`backends/`** | Workers: токен Steam и JSON меток |
564
+ | **`vs_code_extensions/`** | Подсветка `.vne` |
541
565
 
542
566
  **Главное правило:** `plugins/` не знают друг о друге; интеграция — через события по `contracts/` и явный `compatibility/` в `bundles/`.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@vnejs/docs",
3
- "version": "0.2.59",
3
+ "version": "0.2.61",
4
4
  "description": "VNEJS documentation for engine consumers and coding agents",
5
5
  "files": [
6
6
  "*.md",
package/plugins/views/controls.hints.md CHANGED
@@ -33,7 +33,7 @@ Payloads и результаты хендлеров типизированы ч
33
33
 
34
34
  Для экрана обычно задают `position.zIndex = PARAMS.<SCREEN>.ZINDEX + 100`, чтобы другие экраны могли перекрыть подсказки.
35
35
 
36
- Появление/скрытие группы анимируется через `View` с `transition={PARAMS.TRANSITION}` (по умолчанию `300` ms). Группа видима, если `isShow` и есть контролы для текущего device (с учётом `hideOnDevices`). При уходе в пустой список (например keyboard) предыдущие иконки держатся до конца transition, чтобы fade-out успел отрисоваться.
36
+ Появление и скрытие группы по `showEvents` / `hideEvents` обновляет view через `UPDATE_FAST`. Если у исходного события `isForce: true`, обновление идёт через `UPDATE_FORCE`. Обычный `UPDATE` с ожиданием `TRANSITION` на этих событиях не вызывается. Сам `View` по-прежнему анимируется с `transition={PARAMS.TRANSITION}` (по умолчанию `300` ms), кроме `isForce`. Группа видима, если `isShow` и есть контролы для текущего device (с учётом `hideOnDevices`). При уходе в пустой список (например keyboard) предыдущие иконки держатся до конца transition, чтобы fade-out успел отрисоваться.
37
37
 
38
38
  Элемент `controls[]`: `{ locKey, keyboard: string[], xbox: string[], playstation: string[], hideOnDevices?: ControlsDevice[] }` — пути внутри `media/view/{quality}/` (ведущий `/` снимается). `hideOnDevices` — девайсы, на которых контрол не рендерится (`CONTROLS.DEVICES.*`).
39
39
 
@@ -43,10 +43,10 @@ Payloads и результаты хендлеров типизированы ч
43
43
 
44
44
  ## Модули
45
45
 
46
- | Модуль | Зона ответственности |
47
- | --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
48
- | `controls.hints.controller` | Preload иконок в `start` и на `MEMORY.CLEARED`; show/hide групп; `DEVICE_CHANGED`. `EXTERNAL_UPDATE` всегда вызывает `updateViewFast` (без проверки `isShow`). |
49
- | `controls.hints.view` | Рендер нескольких `View` + `Flex` + `Icon` + `Text`. |
46
+ | Модуль | Зона ответственности |
47
+ | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
48
+ | `controls.hints.controller` | Preload иконок в `start` и на `MEMORY.CLEARED`; show/hide групп сохраняют `isForce` исходного события (`UPDATE_FORCE` или `UPDATE_FAST`); `DEVICE_CHANGED`. `EXTERNAL_UPDATE` всегда вызывает `updateViewFast` (без проверки `isShow`). |
49
+ | `controls.hints.view` | Рендер нескольких `View` + `Flex` + `Icon` + `Text`. |
50
50
 
51
51
  ## Близкие плагины
52
52
 
package/plugins/views/settings.md CHANGED
@@ -44,12 +44,12 @@ Payloads и результаты хендлеров типизированы ч
44
44
 
45
45
  ## Модули
46
46
 
47
- | Модуль | Зона ответственности |
48
- | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
47
+ | Модуль | Зона ответственности |
48
+ | ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
49
49
  | `settings.fields.controller` | `SHOW`/`HIDE`/`TAB_SET`; зеркалит `UPDATE_STATE` (`currentArrowVerticalItem` + `currentItemInner`). На `ARROW_LEFT`/`ARROW_RIGHT`: у `selector_texts` / `actions` (`options`) циклят `currentItemInner` (modulo); у `selector_texts` сразу `SETTINGS.SET`. `INTERACT` — option value или named action (в т.ч. `actions` без `settingKey`). `ACCEPT` не обрабатывает — оставляют экраны. |
50
- | `settings.fields.controller.arrows` | Наследует `@vnejs/module.controller.arrows.vertical`: `ARROW_UP`/`ARROW_BOTTOM` по полям; PUSH/POP на SHOW/HIDE; `TAB_SET` сбрасывает индекс; эмитит `UPDATE_STATE` с `{ currentArrowVerticalItem }` и `UPDATE_FAST`. |
51
- | `settings.fields.controller.arrows.horizontal` | Наследует `@vnejs/module.controller.arrows.horizontal`: `onArrowLeft` / `onArrowRight` → `ARROW_LEFT` / `ARROW_RIGHT`; PUSH/POP на SHOW/HIDE. |
52
- | `settings.fields.view` | Обёртка `<View {...propsView} />` (fade show/hide); внутри вкладки `<SettingsTabContent />` с `PositionBox opacity` для crossfade по `tabKey`. Подсветка полей по `currentArrowVerticalItem`. |
50
+ | `settings.fields.controller.arrows` | Наследует `@vnejs/module.controller.arrows.vertical`: `ARROW_UP`/`ARROW_BOTTOM` по полям; PUSH/POP на SHOW/HIDE; `TAB_SET` сбрасывает индекс; эмитит `UPDATE_STATE` с `{ currentArrowVerticalItem }` и `UPDATE_FAST`. На `HIDE.CLEANUP` `currentArrowVerticalItem` в стейте становится `undefined`. |
51
+ | `settings.fields.controller.arrows.horizontal` | Наследует `@vnejs/module.controller.arrows.horizontal`: `onArrowLeft` / `onArrowRight` → `ARROW_LEFT` / `ARROW_RIGHT`; PUSH/POP на SHOW/HIDE. На `HIDE.CLEANUP` `currentArrowHorizontalItem` в стейте становится `undefined`. |
52
+ | `settings.fields.view` | Обёртка `<View {...propsView} />` (fade show/hide); внутри вкладки `<SettingsTabContent />` с `PositionBox opacity` для crossfade по `tabKey`. Подсветка полей по `currentArrowVerticalItem`. |
53
53
 
54
54
  ## Близкие плагины
55
55
 
package/plugins/views.scenario/choose.md CHANGED
@@ -39,13 +39,13 @@ Payloads и результаты хендлеров типизированы ч
39
39
 
40
40
  ## Модули
41
41
 
42
- | Модуль | Зона ответственности |
43
- | ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
44
- | `choose_view.bridge` | Bridge `CHOOSE.SHOW/HIDE` → `CHOOSE_VIEW.SHOW/HIDE`. |
45
- | `choose_view.controller` | `CONTROLS_EXTENSIONS` сливается в `CONTROLS` в `ModuleController.init`; на `SHOW` + `LIFECYCLE_PRIORITY.SHOW.BEFORE` копирует `globalState.choose`; сброс стейта на `HIDE.CLEANUP` делает `ModuleController` (`SHOULD_CLEAR_STATE_ON_CLEANUP`). Зеркало `UPDATE_STATE` / `UPDATE_FAST`. |
46
- | `choose_view.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CHOOSE.OPTION` по `currentArrowVerticalItem`; зеркалит `UPDATE_STATE`; PUSH/POP на SHOW/HIDE. |
47
- | `choose_view.controller.arrows` | Наследует `@vnejs/module.controller.arrows.vertical`: `ARROW_UP` / `ARROW_BOTTOM` по полному `options[]`; скипает `hided` через `isArrowItemAvailable` (индекс исходный); PUSH/POP на SHOW/HIDE; эмитит `UPDATE_STATE` с `{ currentArrowVerticalItem }` и `UPDATE_FAST`. |
48
- | `choose_view.view` | React-render опций; опциональный заголовок из `args.title`. |
42
+ | Модуль | Зона ответственности |
43
+ | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
44
+ | `choose_view.bridge` | Bridge `CHOOSE.SHOW/HIDE` → `CHOOSE_VIEW.SHOW/HIDE`. |
45
+ | `choose_view.controller` | `CONTROLS_EXTENSIONS` сливается в `CONTROLS` в `ModuleController.init`; на `SHOW` + `LIFECYCLE_PRIORITY.SHOW.BEFORE` копирует `globalState.choose`; сброс стейта на `HIDE.CLEANUP` делает `ModuleController` (`SHOULD_CLEAR_STATE_ON_CLEANUP`). Зеркало `UPDATE_STATE` / `UPDATE_FAST`. |
46
+ | `choose_view.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CHOOSE.OPTION` по `currentArrowVerticalItem`; зеркалит `UPDATE_STATE`; PUSH/POP на SHOW/HIDE. |
47
+ | `choose_view.controller.arrows` | Наследует `@vnejs/module.controller.arrows.vertical`: `ARROW_UP` / `ARROW_BOTTOM` по полному `options[]`; скипает `hided` через `isArrowItemAvailable` (индекс исходный); PUSH/POP на SHOW/HIDE; эмитит `UPDATE_STATE` с `{ currentArrowVerticalItem }` и `UPDATE_FAST`. На `HIDE.CLEANUP` `currentArrowVerticalItem` в стейте становится `undefined`. |
48
+ | `choose_view.view` | React-render опций; опциональный заголовок из `args.title`. |
49
49
 
50
50
  ## Связь с CHOOSE
51
51
 
package/plugins/views.scenario/interface.md CHANGED
@@ -54,14 +54,15 @@ Payloads и результаты хендлеров типизированы ч
54
54
 
55
55
  ## Модули
56
56
 
57
- | Модуль | Зона ответственности |
58
- | ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
59
- | `interface.controller` | Обрабатывает VIEW_UPDATE, VIEW_SHOW, VIEW_HIDE, …. Пустой `controls` на `ZINDEX`; `CONTROLS_UNVISIBLE` при скрытии слоя. `SHOULD_CLEAR_STATE_ON_CLEANUP` — `false`, поэтому текст и задник переживают hide. |
60
- | `interface.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `INTERFACE.INTERACT`; видимый слой → `INTERACT.EMIT`, скрытый → `INTERFACE.VISIBLE`; PUSH/POP на VIEW_SHOW/HIDE. |
61
- | `interface` | STATE.SET / STATE.CLEAR → STATE_CHANGED. |
62
- | `interface.scenario` | `$ interface`: `LINE_EXEC_REG` → SHOW / HIDE / VIEW по `CONST.INTERFACE.EXEC_ACTIONS`. |
63
- | `interface.actions` | SHOW / HIDE / VISIBLE / TEXT_HIDE / VIEW через `globalState.interface`. |
64
- | `interface.view` | Подмодуль `view` плагина. |
57
+ | Модуль | Зона ответственности |
58
+ | ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
59
+ | `interface.controller` | Обрабатывает VIEW_UPDATE, VIEW_SHOW, VIEW_HIDE, …. Пустой `controls` на `ZINDEX`; `CONTROLS_UNVISIBLE` при скрытии слоя. `SHOULD_CLEAR_STATE_ON_CLEANUP` — `false`, поэтому текст и задник переживают hide. |
60
+ | `interface.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `INTERFACE.INTERACT`; видимый слой → `INTERACT.EMIT`, скрытый → `INTERFACE.VISIBLE`; PUSH/POP на VIEW_SHOW/HIDE. |
61
+ | `interface` | STATE.SET / STATE.CLEAR → STATE_CHANGED. |
62
+ | `interface.scenario` | `$ interface`: `LINE_EXEC_REG` → SHOW / HIDE / VIEW по `CONST.INTERFACE.EXEC_ACTIONS`. |
63
+ | `interface.actions` | VISIBLE / TEXT_HIDE / VIEW через `globalState.interface`. |
64
+ | `interface.actions.show` | Подписки `SHOW` и `HIDE`. На `GATE` (`breakFollowing`): если интерфейс уже в целевом состоянии или цикл show/hide уже идёт, остальные подписчики этих событий не вызываются. Показ скрытого слоя шлёт `VISIBLE`. |
65
+ | `interface.view` | Подмодуль `view` плагина. |
65
66
 
66
67
  ## Compatibility
67
68
 
package/plugins/views.screens/checkers.md CHANGED
@@ -33,15 +33,15 @@ Payloads и результаты хендлеров типизированы ч
33
33
 
34
34
  ## Модули
35
35
 
36
- | Модуль | Зона |
37
- | ------------------------------------------------ | ------------------------------------------------------ |
38
- | `checkers_view.bridge` | SHOW/HIDE bridge |
39
- | `checkers_view.controller` / `.grid` / `.accept` | экран, сетка, ACCEPT |
40
- | `checkers_view.click` / `.player.interact` | клик и выбор (game: `MOVES_GET` / `MOVE_PLAY`) |
41
- | `checkers_view.player.select` | `PLAYER_SELECT` → selection + grid |
42
- | `checkers_view.board` | `GRID.CHANGED` / `UNSET` → `gridItems` + `UPDATE_FAST` |
43
- | `checkers_view.status` | `TURNS` / `FINISH` / `SHOW` → status text |
44
- | `checkers_view.view` | React |
36
+ | Модуль | Зона |
37
+ | ------------------------------------------------ | -------------------------------------------------------------------------------------------- |
38
+ | `checkers_view.bridge` | SHOW/HIDE bridge |
39
+ | `checkers_view.controller` / `.grid` / `.accept` | экран, сетка, ACCEPT; на `HIDE.CLEANUP` сетка пишет `gridRow` / `gridColumn` как `undefined` |
40
+ | `checkers_view.click` / `.player.interact` | клик и выбор (game: `MOVES_GET` / `MOVE_PLAY`) |
41
+ | `checkers_view.player.select` | `PLAYER_SELECT` → selection + grid |
42
+ | `checkers_view.board` | `GRID.CHANGED` / `UNSET` → `gridItems` + `UPDATE_FAST` |
43
+ | `checkers_view.status` | `TURNS` / `FINISH` / `SHOW` → status text |
44
+ | `checkers_view.view` | React |
45
45
 
46
46
  ## Сценарий
47
47
 
package/plugins/views.screens/confirm.md CHANGED
@@ -37,14 +37,14 @@ Payloads и результаты хендлеров типизированы ч
37
37
 
38
38
  ## Модули
39
39
 
40
- | Модуль | Зона ответственности |
41
- | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
42
- | `confirm.controller` | SHOW/HIDE; BACK → `DECLINE`; зеркалит `UPDATE_STATE` в стейт и `UPDATE_FAST` во view. |
43
- | `confirm.controller.arrows` | Наследует `@vnejs/module.controller.arrows.horizontal`: `ARROW_LEFT` / `ARROW_RIGHT` по Accept/Decline; PUSH/POP controls на SHOW/HIDE; эмитит `UPDATE_STATE` с `{ currentArrowHorizontalItem }` и `UPDATE_FAST`. |
44
- | `confirm.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `SUBMIT` → `ACCEPT` или `DECLINE` по `currentArrowHorizontalItem`; зеркалит `UPDATE_STATE`; PUSH/POP на SHOW/HIDE. |
45
- | `confirm.hide.state` | Наследует `@vnejs/module.controller.hide.on.state`: только `STATE.CLEAR` → `HIDE` с `{ isForce: true }` (`IS_STATE_SET_ENABLED = false`). |
46
- | `confirm` | Обрабатывает EMIT, ACCEPT, DECLINE. Колбэки accept/decline снимаются на `HIDE.MAIN`, если контроллер не оборвал скрытие на `GATE`. |
47
- | `confirm.view` | Подмодуль `view` плагина. |
40
+ | Модуль | Зона ответственности |
41
+ | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
42
+ | `confirm.controller` | SHOW/HIDE; BACK → `DECLINE`; зеркалит `UPDATE_STATE` в стейт и `UPDATE_FAST` во view. |
43
+ | `confirm.controller.arrows` | Наследует `@vnejs/module.controller.arrows.horizontal`: `ARROW_LEFT` / `ARROW_RIGHT` по Accept/Decline; PUSH/POP controls на SHOW/HIDE; эмитит `UPDATE_STATE` с `{ currentArrowHorizontalItem }` и `UPDATE_FAST`. На `HIDE.CLEANUP` `currentArrowHorizontalItem` в стейте становится `undefined`. |
44
+ | `confirm.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `SUBMIT` → `ACCEPT` или `DECLINE` по `currentArrowHorizontalItem`; зеркалит `UPDATE_STATE`; PUSH/POP на SHOW/HIDE. |
45
+ | `confirm.hide.state` | Наследует `@vnejs/module.controller.hide.on.state`: только `STATE.CLEAR` → `HIDE` с `{ isForce: true }` (`IS_STATE_SET_ENABLED = false`). |
46
+ | `confirm` | Обрабатывает EMIT, ACCEPT, DECLINE. Колбэки accept/decline снимаются на `HIDE.MAIN`, если контроллер не оборвал скрытие на `GATE`. |
47
+ | `confirm.view` | Подмодуль `view` плагина. |
48
48
 
49
49
  ## Близкие плагины
50
50
 
package/plugins/views.screens/eula.md CHANGED
@@ -39,14 +39,14 @@ Payloads и результаты хендлеров типизированы ч
39
39
 
40
40
  ## Модули
41
41
 
42
- | Модуль | Зона ответственности |
43
- | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
44
- | `eula.controller` | SHOW/HIDE; `BACK` → `EXIT`; зеркалит `UPDATE_STATE` / `UPDATE_FAST`; lang/locs. `onSettingChange`: при `SETTINGS.EULA.LANG` и `isShow` — `lang` + сброс `currentArrowVerticalItem`. |
45
- | `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`. |
46
- | `eula.controller.accept` | Наследует `@vnejs/module.controller.accept`: только `ACCEPT` (`IS_INTERACT_ENABLED = false`) → `EULA.ACCEPT` → `ACCEPTED_VERSION`, `HIDE`; PUSH/POP на SHOW/HIDE. |
47
- | `eula.hide.state` | Наследует `@vnejs/module.controller.hide.on.state`: `STATE.SET` / `STATE.CLEAR` → `HIDE` с `{ isForce: true }`. |
48
- | `eula` | В `setup` — `SETTINGS.INIT` для версии и языка; `MAINMENU.SHOW` → `SHOW` (если версия не принята); `EXIT` → `SYSTEM.CLOSE`. |
49
- | `eula.view` | Подмодуль `view` плагина. |
42
+ | Модуль | Зона ответственности |
43
+ | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
44
+ | `eula.controller` | SHOW/HIDE; `BACK` → `EXIT`; зеркалит `UPDATE_STATE` / `UPDATE_FAST`; lang/locs. `onSettingChange`: при `SETTINGS.EULA.LANG` и `isShow` — `lang` + сброс `currentArrowVerticalItem`. |
45
+ | `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`. |
46
+ | `eula.controller.accept` | Наследует `@vnejs/module.controller.accept`: только `ACCEPT` (`IS_INTERACT_ENABLED = false`) → `EULA.ACCEPT` → `ACCEPTED_VERSION`, `HIDE`; PUSH/POP на SHOW/HIDE. |
47
+ | `eula.hide.state` | Наследует `@vnejs/module.controller.hide.on.state`: `STATE.SET` / `STATE.CLEAR` → `HIDE` с `{ isForce: true }`. |
48
+ | `eula` | В `setup` — `SETTINGS.INIT` для версии и языка; `MAINMENU.SHOW` → `SHOW` (если версия не принята); `EXIT` → `SYSTEM.CLOSE`. |
49
+ | `eula.view` | Подмодуль `view` плагина. |
50
50
 
51
51
  ## Близкие плагины
52
52
 
package/plugins/views.screens/gallery.md CHANGED
@@ -58,21 +58,21 @@ Payloads и результаты хендлеров типизированы ч
58
58
 
59
59
  ## Модули
60
60
 
61
- | Модуль | Зона ответственности |
62
- | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
63
- | `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`. |
64
- | `gallery.controller` | SHOW/HIDE по фазам `CONST.COMPONENTS.LIFECYCLE_PRIORITY`; на `SHOW.BEFORE` — `TAB_SET`. `UPDATE_STATE` / `UPDATE_FAST`; пустой `controls` на `ZINDEX`. |
65
- | `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`. |
66
- | `gallery.controller.preload` | PRELOAD — page 0 первого таба через `PAGE_ITEMS_GET`; `MEMORY.CLEARED` при `isShow` — текущая / соседние страницы + page 0 остальных табов (`getItemsOnPage` / `getMaxPagesCount` на лету). |
67
- | `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). |
68
- | `gallery.controller.pages.items` | На `PAGE_ITEMS_GET` собирает UI-слот: `CHECK` + media (`MEDIA.LOAD`); возврат item. |
69
- | `gallery.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CHOOSE` только если слот открыт (`isOpened`, не stub); зеркалит `UPDATE_STATE` (`grid*`); PUSH/POP на SHOW/HIDE. |
70
- | `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 позиции не входят). |
71
- | `gallery.hide.controls` | Наследует `@vnejs/module.controller.hide.on.controls`: `BACK` / `MENU` / `GAMEMENU` → `HIDE`; PUSH/POP на SHOW/HIDE. |
72
- | `gallery.hide.state` | Наследует `@vnejs/module.controller.hide.on.state`: `STATE.SET` / `STATE.CLEAR` → `HIDE` с `{ isForce: true }`. |
73
- | `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`. |
74
- | `gallery` | Обрабатывает OPEN, CHECK, CLEAR. |
75
- | `gallery.view` | Подмодуль `view` плагина. |
61
+ | Модуль | Зона ответственности |
62
+ | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
63
+ | `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`. |
64
+ | `gallery.controller` | SHOW/HIDE по фазам `CONST.COMPONENTS.LIFECYCLE_PRIORITY`; на `SHOW.BEFORE` — `TAB_SET`. `UPDATE_STATE` / `UPDATE_FAST`; пустой `controls` на `ZINDEX`. |
65
+ | `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`. |
66
+ | `gallery.controller.preload` | PRELOAD — page 0 первого таба через `PAGE_ITEMS_GET`; `MEMORY.CLEARED` при `isShow` — текущая / соседние страницы + page 0 остальных табов (`getItemsOnPage` / `getMaxPagesCount` на лету). |
67
+ | `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). |
68
+ | `gallery.controller.pages.items` | На `PAGE_ITEMS_GET` собирает UI-слот: `CHECK` + media (`MEDIA.LOAD`); возврат item. |
69
+ | `gallery.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CHOOSE` только если слот открыт (`isOpened`, не stub); зеркалит `UPDATE_STATE` (`grid*`); PUSH/POP на SHOW/HIDE. |
70
+ | `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`. |
71
+ | `gallery.hide.controls` | Наследует `@vnejs/module.controller.hide.on.controls`: `BACK` / `MENU` / `GAMEMENU` → `HIDE`; PUSH/POP на SHOW/HIDE. |
72
+ | `gallery.hide.state` | Наследует `@vnejs/module.controller.hide.on.state`: `STATE.SET` / `STATE.CLEAR` → `HIDE` с `{ isForce: true }`. |
73
+ | `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`. |
74
+ | `gallery` | Обрабатывает OPEN, CHECK, CLEAR. |
75
+ | `gallery.view` | Подмодуль `view` плагина. |
76
76
 
77
77
  ## Близкие плагины
78
78
 
package/plugins/views.screens/gamemenu.md CHANGED
@@ -42,15 +42,15 @@ Payloads и результаты хендлеров типизированы ч
42
42
 
43
43
  ## Модули
44
44
 
45
- | Модуль | Зона ответственности |
46
- | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
47
- | `gamemenu.controller` | Обрабатывает UPDATE, HIDE, SHOW, UPDATE_STATE, UPDATE_FAST, …. Пустой `controls` на `ZINDEX`, чтобы стопорить слои ниже. Резолвит `ITEMS` → `items` / `realItems`. |
48
- | `gamemenu.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CLICK` по полному индексу пункта (через `realItems`); зеркалит `UPDATE_STATE`; PUSH/POP на SHOW/HIDE. |
49
- | `gamemenu.controller.arrows` | Наследует `@vnejs/module.controller.arrows.vertical`: `ARROW_UP` / `ARROW_BOTTOM` по видимым пунктам; PUSH/POP controls на SHOW/HIDE; эмитит `UPDATE_STATE` с `{ currentArrowVerticalItem }` и `UPDATE_FAST`. |
50
- | `gamemenu.hide.controls` | Наследует `@vnejs/module.controller.hide.on.controls`: `BACK` / `MENU` / `GAMEMENU` → `HIDE`; PUSH/POP на SHOW/HIDE. |
51
- | `gamemenu.hide.state` | Наследует `@vnejs/module.controller.hide.on.state`: `STATE.SET` / `STATE.CLEAR` → `HIDE` с `{ isForce: true }`. |
52
- | `gamemenu` | `ITEMS` / `CLICK`; пропускает disabled/hided. |
53
- | `gamemenu.view` | Подмодуль `view` плагина; `isDisabled` / `isNotRender` в TextControls. |
45
+ | Модуль | Зона ответственности |
46
+ | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
47
+ | `gamemenu.controller` | Обрабатывает UPDATE, HIDE, SHOW, UPDATE_STATE, UPDATE_FAST, …. Пустой `controls` на `ZINDEX`, чтобы стопорить слои ниже. Резолвит `ITEMS` → `items` / `realItems`. |
48
+ | `gamemenu.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CLICK` по полному индексу пункта (через `realItems`); зеркалит `UPDATE_STATE`; PUSH/POP на SHOW/HIDE. |
49
+ | `gamemenu.controller.arrows` | Наследует `@vnejs/module.controller.arrows.vertical`: `ARROW_UP` / `ARROW_BOTTOM` по видимым пунктам; PUSH/POP controls на SHOW/HIDE; эмитит `UPDATE_STATE` с `{ currentArrowVerticalItem }` и `UPDATE_FAST`. На `HIDE.CLEANUP` `currentArrowVerticalItem` в стейте становится `undefined`. |
50
+ | `gamemenu.hide.controls` | Наследует `@vnejs/module.controller.hide.on.controls`: `BACK` / `MENU` / `GAMEMENU` → `HIDE`; PUSH/POP на SHOW/HIDE. |
51
+ | `gamemenu.hide.state` | Наследует `@vnejs/module.controller.hide.on.state`: `STATE.SET` / `STATE.CLEAR` → `HIDE` с `{ isForce: true }`. |
52
+ | `gamemenu` | `ITEMS` / `CLICK`; пропускает disabled/hided. |
53
+ | `gamemenu.view` | Подмодуль `view` плагина; `isDisabled` / `isNotRender` в TextControls. |
54
54
 
55
55
  ## Близкие плагины
56
56
 
package/plugins/views.screens/history.md CHANGED
@@ -27,12 +27,12 @@ Payloads и результаты хендлеров типизированы ч
27
27
 
28
28
  ## Параметры
29
29
 
30
- | Ключ | Тип | Смысл |
31
- | ------------ | -------- | ------------------------------------------ |
32
- | `ZINDEX` | `number` | Значение по умолчанию: 2000. |
33
- | `TRANSITION` | `number` | Значение по умолчанию: 300. |
34
- | `LOC_LABEL` | `string` | Метка локализации view (`history`). |
35
- | `VIEW_PROPS` | `object` | Раскладка экрана, строк и кнопки закрытия. |
30
+ | Ключ | Тип | Смысл |
31
+ | ------------ | -------- | ------------------------------------------------------------------------- |
32
+ | `ZINDEX` | `number` | Значение по умолчанию: 2000. |
33
+ | `TRANSITION` | `number` | Значение по умолчанию: 300. |
34
+ | `LOC_LABEL` | `string` | Метка локализации view (`history`). |
35
+ | `VIEW_PROPS` | `object` | Раскладка экрана, строк (блок по вертикали по центру) и крестика `close`. |
36
36
 
37
37
  ## Настройки
38
38
 
@@ -40,15 +40,15 @@ Payloads и результаты хендлеров типизированы ч
40
40
 
41
41
  ## Модули
42
42
 
43
- | Модуль | Зона ответственности |
44
- | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
45
- | `history.controller` | SHOW/HIDE/UPDATE_STATE/UPDATE_FAST; перед SHOW резолвит тексты строк (`TEXT.REPLACE`). Для `locKey` — через `PARAMS.HISTORY_VIEW.LOC_LABEL` (локализация view), иначе через label сценария. Пустой `controls` на `ZINDEX`, чтобы стопорить слои ниже. |
46
- | `history.controller.click` | `HISTORY_VIEW.CLICK` → `HISTORY.KEYS`; если `uid` в ключах — `HISTORY.LOAD`. |
47
- | `history.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CLICK` по `currentArrowVerticalItem`; зеркалит `UPDATE_STATE`; PUSH/POP на SHOW/HIDE. |
48
- | `history.controller.arrows` | Наследует `@vnejs/module.controller.arrows.vertical`: `ARROW_UP` / `ARROW_BOTTOM` по записям журнала; PUSH/POP controls на SHOW/HIDE; эмитит `UPDATE_STATE` с `{ currentArrowVerticalItem }` и `UPDATE_FAST`. |
49
- | `history.hide.controls` | Наследует `@vnejs/module.controller.hide.on.controls`: `BACK` / `MENU` / `GAMEMENU` → `HIDE`; PUSH/POP на SHOW/HIDE. |
50
- | `history.hide.state` | Наследует `@vnejs/module.controller.hide.on.state`: `STATE.SET` → `HIDE` с `{ isForce: true }` (`IS_STATE_CLEAR_ENABLED = false`). |
51
- | `history.view` | Подмодуль `view` плагина. |
43
+ | Модуль | Зона ответственности |
44
+ | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
45
+ | `history.controller` | SHOW/HIDE/UPDATE_STATE/UPDATE_FAST; перед SHOW резолвит тексты строк (`TEXT.REPLACE`). Для `locKey` — через `PARAMS.HISTORY_VIEW.LOC_LABEL` (локализация view), иначе через label сценария. Пустой `controls` на `ZINDEX`, чтобы стопорить слои ниже. |
46
+ | `history.controller.click` | `HISTORY_VIEW.CLICK` → `HISTORY.KEYS`; если `uid` в ключах — `HISTORY.LOAD`. |
47
+ | `history.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CLICK` по `currentArrowVerticalItem`; зеркалит `UPDATE_STATE`; PUSH/POP на SHOW/HIDE. |
48
+ | `history.controller.arrows` | Наследует `@vnejs/module.controller.arrows.vertical`: `ARROW_UP` / `ARROW_BOTTOM` по записям журнала; PUSH/POP controls на SHOW/HIDE; эмитит `UPDATE_STATE` с `{ currentArrowVerticalItem }` и `UPDATE_FAST`. На `HIDE.CLEANUP` `currentArrowVerticalItem` в стейте становится `undefined`. |
49
+ | `history.hide.controls` | Наследует `@vnejs/module.controller.hide.on.controls`: `BACK` / `MENU` / `GAMEMENU` → `HIDE`; PUSH/POP на SHOW/HIDE. |
50
+ | `history.hide.state` | Наследует `@vnejs/module.controller.hide.on.state`: `STATE.SET` → `HIDE` с `{ isForce: true }` (`IS_STATE_CLEAR_ENABLED = false`). |
51
+ | `history.view` | Подмодуль `view` плагина. |
52
52
 
53
53
  ## Близкие плагины
54
54
 
package/plugins/views.screens/mainmenu.md CHANGED
@@ -48,18 +48,18 @@ Payloads и результаты хендлеров типизированы ч
48
48
 
49
49
  ## Модули
50
50
 
51
- | Модуль | Зона ответственности |
52
- | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
53
- | `mainmenu.controller` | UPDATE, SHOW, HIDE по фазам `CONST.COMPONENTS.LIFECYCLE_PRIORITY`; на `SHOW.BEFORE` — ITEMS. Пустой `controls` на `ZINDEX`. UPDATE_STATE, UPDATE_FAST, UPDATE_FORCE. |
54
- | `mainmenu.controller.bg` | Наследует `@vnejs/module.controller.bg`: начальный `bgSrc` на `SHOW` + `LIFECYCLE_PRIORITY.SHOW.BEFORE`; `isShow` из `UPDATE_STATE`; `start` / `STATE.CLEAR` preload. Ротацию не трогает. |
55
- | `mainmenu.hide` | Наследует `@vnejs/module.controller.hide.on.state`: `STATE.SET` / `STATE.CLEAR` → `HIDE` с `{ isForce: true }`. |
56
- | `mainmenu.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CLICK` по `currentArrowVerticalItem`; зеркалит `UPDATE_STATE`; PUSH/POP на SHOW/HIDE. |
57
- | `mainmenu.controller.arrows` | Наследует `@vnejs/module.controller.arrows.vertical`: `ARROW_UP` / `ARROW_BOTTOM` по видимым пунктам; PUSH/POP controls на SHOW/HIDE; эмитит `UPDATE_STATE` с `{ currentArrowVerticalItem }` и `UPDATE_FAST`. |
58
- | `mainmenu.backgrounds` | Наследует `@vnejs/module.controller.backgrounds`: ротация `BACKGROUNDS`, preload и таймер; `isShow` из `UPDATE_STATE`; эмитит `UPDATE_STATE` и `UPDATE_FAST`. Таймер снимается на `HIDE.AFTER`. |
59
- | `mainmenu.preload` | Наследует `@vnejs/module.controller.preload`: по SHOW / PRELOAD грузит `PRELOAD_LABELS` и `PRELOAD_EVENTS`. `MEMORY.CLEARED` — только при `isShow` из `UPDATE_STATE`. |
60
- | `mainmenu.scenario` | LINE_EXEC → SHOW, LINE_LOAD → PRELOAD. |
61
- | `mainmenu` | Обрабатывает ITEMS и CLICK. |
62
- | `mainmenu.view` | Подмодуль `view` плагина. |
51
+ | Модуль | Зона ответственности |
52
+ | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
53
+ | `mainmenu.controller` | UPDATE, SHOW, HIDE по фазам `CONST.COMPONENTS.LIFECYCLE_PRIORITY`; на `SHOW.BEFORE` — ITEMS. Пустой `controls` на `ZINDEX`. UPDATE_STATE, UPDATE_FAST, UPDATE_FORCE. |
54
+ | `mainmenu.controller.bg` | Наследует `@vnejs/module.controller.bg`: начальный `bgSrc` на `SHOW` + `LIFECYCLE_PRIORITY.SHOW.BEFORE`; `isShow` из `UPDATE_STATE`; `start` / `STATE.CLEAR` preload. Ротацию не трогает. |
55
+ | `mainmenu.hide` | Наследует `@vnejs/module.controller.hide.on.state`: `STATE.SET` / `STATE.CLEAR` → `HIDE` с `{ isForce: true }`. |
56
+ | `mainmenu.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CLICK` по `currentArrowVerticalItem`; зеркалит `UPDATE_STATE`; PUSH/POP на SHOW/HIDE. |
57
+ | `mainmenu.controller.arrows` | Наследует `@vnejs/module.controller.arrows.vertical`: `ARROW_UP` / `ARROW_BOTTOM` по видимым пунктам; PUSH/POP controls на SHOW/HIDE; эмитит `UPDATE_STATE` с `{ currentArrowVerticalItem }` и `UPDATE_FAST`. На `HIDE.CLEANUP` `currentArrowVerticalItem` в стейте становится `undefined`. |
58
+ | `mainmenu.backgrounds` | Наследует `@vnejs/module.controller.backgrounds`: ротация `BACKGROUNDS`, preload и таймер; `isShow` из `UPDATE_STATE`; эмитит `UPDATE_STATE` и `UPDATE_FAST`. Таймер снимается на `HIDE.AFTER`. |
59
+ | `mainmenu.preload` | Наследует `@vnejs/module.controller.preload`: по SHOW / PRELOAD грузит `PRELOAD_LABELS` и `PRELOAD_EVENTS`. `MEMORY.CLEARED` — только при `isShow` из `UPDATE_STATE`. |
60
+ | `mainmenu.scenario` | LINE_EXEC → SHOW, LINE_LOAD → PRELOAD. |
61
+ | `mainmenu` | Обрабатывает ITEMS и CLICK. |
62
+ | `mainmenu.view` | Подмодуль `view` плагина. |
63
63
 
64
64
  ## Близкие плагины
65
65
 
package/plugins/views.screens/save.md CHANGED
@@ -48,21 +48,21 @@ Payloads и результаты хендлеров типизированы ч
48
48
 
49
49
  ## Модули
50
50
 
51
- | Модуль | Зона ответственности |
52
- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
53
- | `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`. |
54
- | `save.controller` | SHOW/HIDE по фазам `CONST.COMPONENTS.LIFECYCLE_PRIORITY`; на `SHOW.BEFORE` — `TAB_SET`. `UPDATE_STATE` / `UPDATE_FAST`; пустой `controls` на `ZINDEX`. |
55
- | `save.controller.bg` | Наследует `@vnejs/module.controller.bg`: `SHOW` + `LIFECYCLE_PRIORITY.SHOW.BEFORE` → `bgSrc`; PRELOAD / `start`; `MEMORY.CLEARED` — preload и refresh при `isShow`. |
56
- | `save.controller.actions` | CREATE → `SAVE.CREATE`, DELETE → `SAVE.DELETE`; `group` из payload или `getSaveGroup` (autosave / `pageIndex`); затем `GRID_UPDATE_ITEMS` + `UPDATE_FAST`. |
57
- | `save.controller.pages` | Наследует `@vnejs/module.controller.pages`: `EVENT_*` → `SAVE_VIEW`; `applyPage` → `UPDATE_STATE` `{ gridIndex, gridsCount }` + `GRID_UPDATE_ITEMS`; `init` пишет `pagesCount`. |
58
- | `save.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CREATE` на вкладке save, иначе `LOAD` при `screen`; зеркалит `UPDATE_STATE`; PUSH/POP на SHOW/HIDE. |
59
- | `save.controller.grid` | Наследует `@vnejs/module.controller.arrows.grid`: четыре стрелки; `isDisableGridChangeVertical = true` (вертикаль не листает страницы); на краю колонок — `GRID_NEXT`/`PREV`; `GRID_CLEAR`; `GRID_UPDATE_ITEMS` → `getGridItems` / `UPDATE_STATE` `{ gridItems }`. |
60
- | `save.view.slot` | На `SLOT_CREATE` собирает UI-слот: `SAVE.GET` → `screen` / `ts` / `date` / `time` / `locKey`. |
61
- | `save.hide.controls` | Наследует `@vnejs/module.controller.hide.on.controls`: `BACK` / `MENU` / `GAMEMENU` → `HIDE`; PUSH/POP на SHOW/HIDE. |
62
- | `save.hide.state` | Наследует `@vnejs/module.controller.hide.on.state`: `STATE.SET` / `STATE.CLEAR` → `HIDE` с `{ isForce: true }`. |
63
- | `save.controller.tabs` | Наследник `ModuleControllerTabs`: `TAB_SET` → `applyTab` + `onTabSet` (`pageIndex: 0`, `GRID_CLEAR`, `UPDATE_STATE` `{ gridIndex, gridsCount }`, `GRID_UPDATE_ITEMS`, опционально `UPDATE_FAST`); TAB_PREV/TAB_NEXT → `TAB_SET`; `getTabKeys` фильтрует SAVE vs LOAD/AUTOSAVE. |
64
- | `save.controller.load` | Подмодуль `controller.load` плагина. |
65
- | `save.view` | Подмодуль `view` плагина. |
51
+ | Модуль | Зона ответственности |
52
+ | ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
53
+ | `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`. |
54
+ | `save.controller` | SHOW/HIDE по фазам `CONST.COMPONENTS.LIFECYCLE_PRIORITY`; на `SHOW.BEFORE` — `TAB_SET`. `UPDATE_STATE` / `UPDATE_FAST`; пустой `controls` на `ZINDEX`. |
55
+ | `save.controller.bg` | Наследует `@vnejs/module.controller.bg`: `SHOW` + `LIFECYCLE_PRIORITY.SHOW.BEFORE` → `bgSrc`; PRELOAD / `start`; `MEMORY.CLEARED` — preload и refresh при `isShow`. |
56
+ | `save.controller.actions` | CREATE → `SAVE.CREATE`, DELETE → `SAVE.DELETE`; `group` из payload или `getSaveGroup` (autosave / `pageIndex`); затем `GRID_UPDATE_ITEMS` + `UPDATE_FAST`. |
57
+ | `save.controller.pages` | Наследует `@vnejs/module.controller.pages`: `EVENT_*` → `SAVE_VIEW`; `applyPage` → `UPDATE_STATE` `{ gridIndex, gridsCount }` + `GRID_UPDATE_ITEMS`; `init` пишет `pagesCount`. |
58
+ | `save.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CREATE` на вкладке save, иначе `LOAD` при `screen`; зеркалит `UPDATE_STATE`; PUSH/POP на SHOW/HIDE. |
59
+ | `save.controller.grid` | Наследует `@vnejs/module.controller.arrows.grid`: четыре стрелки; `isDisableGridChangeVertical = true` (вертикаль не листает страницы); на краю колонок — `GRID_NEXT`/`PREV`; `GRID_CLEAR`; `GRID_UPDATE_ITEMS` → `getGridItems` / `UPDATE_STATE` `{ gridItems }`. На `HIDE.CLEANUP` `gridRow` / `gridColumn` в стейте становятся `undefined`. |
60
+ | `save.view.slot` | На `SLOT_CREATE` собирает UI-слот: `SAVE.GET` → `screen` / `ts` / `date` / `time` / `locKey`. |
61
+ | `save.hide.controls` | Наследует `@vnejs/module.controller.hide.on.controls`: `BACK` / `MENU` / `GAMEMENU` → `HIDE`; PUSH/POP на SHOW/HIDE. |
62
+ | `save.hide.state` | Наследует `@vnejs/module.controller.hide.on.state`: `STATE.SET` / `STATE.CLEAR` → `HIDE` с `{ isForce: true }`. |
63
+ | `save.controller.tabs` | Наследник `ModuleControllerTabs`: `TAB_SET` → `applyTab` + `onTabSet` (`pageIndex: 0`, `GRID_CLEAR`, `UPDATE_STATE` `{ gridIndex, gridsCount }`, `GRID_UPDATE_ITEMS`, опционально `UPDATE_FAST`); TAB_PREV/TAB_NEXT → `TAB_SET`; `getTabKeys` фильтрует SAVE vs LOAD/AUTOSAVE. |
64
+ | `save.controller.load` | Подмодуль `controller.load` плагина. |
65
+ | `save.view` | Подмодуль `view` плагина. |
66
66
 
67
67
  ## Близкие плагины
68
68