@vnejs/docs 0.2.42 → 0.2.43
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.
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,14 @@
|
|
|
2
2
|
|
|
3
3
|
Краткая история изменений движка (плагины, helpers, packages, CLI и прочий runtime) и внешнего API. Версии — релизы пакета `@vnejs/docs`.
|
|
4
4
|
|
|
5
|
+
## 0.2.43
|
|
6
|
+
|
|
7
|
+
- `canvas/bg` — `$ <layer>.bg change … <duration>`: сначала `transition`, затем смена `src` (как `sprite.move`), без opacity-кроссфейда `SHOW`.
|
|
8
|
+
- `save/quick` — слот быстрого сохранения (`SAVE_QUICK`): `MAKE` / `LOAD` / `PRELOAD`; `CONST.SAVE_QUICK.SAVE_GROUP` (`"quick"`); `shared.hasQuickSave`.
|
|
9
|
+
- `views.screens/gamemenu` — пункты через `GameMenuItemFactory[]`; `EVENTS.GAMEMENU.ITEMS`; `isDisabled` / `isHided` (вместо `disabled` / `hided`). API: `GameMenuItemFactory`, `EVENTS.GAMEMENU.ITEMS`, `GameMenuItem.isDisabled` / `isHided`.
|
|
10
|
+
- `views.screens/settings.defaults` — hover у кнопки Accept: `PARAMS.SETTINGS_DEFAULT_VIEW.VIEW_PROPS.accept.isHoverable` (`true`).
|
|
11
|
+
- `views.screens/settings` — на `TAB_SET` сначала `UPDATE_FAST` (chrome), потом `SETTINGS_VIEW.TAB_SET` (контент).
|
|
12
|
+
|
|
5
13
|
## 0.2.42
|
|
6
14
|
|
|
7
15
|
- `cli/tools` resize image — флаг `-d` / `--desktop` (webp quality 90); `--web` → 80; без флагов → 100. API: `--desktop`.
|
package/package.json
CHANGED
package/plugins/canvas/bg.md
CHANGED
|
@@ -4,6 +4,11 @@
|
|
|
4
4
|
|
|
5
5
|
Показ, скрытие, смена и preload изображений на canvas-слоях.
|
|
6
6
|
|
|
7
|
+
## SHOW vs CHANGE
|
|
8
|
+
|
|
9
|
+
- **`SHOW`** — новый child (часто fade через `opacity`), старые при необходимости снимаются.
|
|
10
|
+
- **`CHANGE`** — смена `src` у уже существующего child. При `duration > 0` сначала выставляется `transition`, затем меняется `src` (как у `sprite.move`), без opacity-кроссфейда как у `SHOW`.
|
|
11
|
+
|
|
7
12
|
## Overlays
|
|
8
13
|
|
|
9
14
|
В args сценария / событий поле `overlays?: Record<string, string>` задаёт слои поверх базового `{name}/index`: каждый ключ `key → value` резолвится в медиа `{name}/{key}/{value}`.
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
# plugins/save/quick/
|
|
2
|
+
|
|
3
|
+
Пакет: `@vnejs/plugins.save.quick` · namespace: `SAVE_QUICK`
|
|
4
|
+
|
|
5
|
+
Ведёт слот быстрого сохранения: создание, загрузка и предзагрузка.
|
|
6
|
+
|
|
7
|
+
## События
|
|
8
|
+
|
|
9
|
+
| Ключ | Строка | Смысл |
|
|
10
|
+
| --------- | ------------------------ | ------------------------------------ |
|
|
11
|
+
| `MAKE` | `vne:save_quick:make` | Событие `MAKE` namespace плагина. |
|
|
12
|
+
| `LOAD` | `vne:save_quick:load` | Загрузить данные или ресурс. |
|
|
13
|
+
| `PRELOAD` | `vne:save_quick:preload` | Событие `PRELOAD` namespace плагина. |
|
|
14
|
+
|
|
15
|
+
## Константы
|
|
16
|
+
|
|
17
|
+
| Ключ | Смысл |
|
|
18
|
+
| ------------ | ------------------------------------------------------------------------------------------- |
|
|
19
|
+
| `SAVE_GROUP` | Storage group для слота quick (`"quick"`); доступ через `this.CONST.SAVE_QUICK.SAVE_GROUP`. |
|
|
20
|
+
|
|
21
|
+
## Параметры
|
|
22
|
+
|
|
23
|
+
Нет.
|
|
24
|
+
|
|
25
|
+
## Настройки
|
|
26
|
+
|
|
27
|
+
Нет.
|
|
28
|
+
|
|
29
|
+
## Модули
|
|
30
|
+
|
|
31
|
+
| Модуль | Зона ответственности |
|
|
32
|
+
| ------------ | ------------------------------------------------------------------- |
|
|
33
|
+
| `save.quick` | Обрабатывает MAKE, LOAD, PRELOAD; слот в `SAVE` с `group: "quick"`. |
|
|
34
|
+
|
|
35
|
+
## Близкие плагины
|
|
36
|
+
|
|
37
|
+
### plugins/core/
|
|
38
|
+
|
|
39
|
+
- [state.md](../core/state.md) — `STATE`: CONST.MIGRATE_STATUS.OK
|
|
40
|
+
|
|
41
|
+
### Остальные
|
|
42
|
+
|
|
43
|
+
- [save.md](./save.md) — `SAVE`: EVENTS.GET, EVENTS.CREATE, EVENTS.LOAD, EVENTS.PRELOAD
|
|
44
|
+
- [continue.md](./continue.md) — тот же паттерн для слота «Продолжить»
|
|
@@ -10,6 +10,7 @@
|
|
|
10
10
|
| -------------- | --------------------------- | -------------------------------------------------- |
|
|
11
11
|
| `SHOW` | `vne:gamemenu:show` | Показать UI или слой. |
|
|
12
12
|
| `HIDE` | `vne:gamemenu:hide` | Скрыть UI или слой. |
|
|
13
|
+
| `ITEMS` | `vne:gamemenu:items` | Резолв фабрик пунктов меню. |
|
|
13
14
|
| `CLICK` | `vne:gamemenu:click` | Событие `CLICK` namespace плагина. |
|
|
14
15
|
| `UPDATE` | `vne:gamemenu:update` | Обновить состояние или отображение. |
|
|
15
16
|
| `STATE_UPDATE` | `vne:gamemenu:state_update` | Слить partial в стейт контроллера без UPDATE view. |
|
|
@@ -22,13 +23,15 @@
|
|
|
22
23
|
|
|
23
24
|
## Параметры
|
|
24
25
|
|
|
25
|
-
| Ключ | Тип
|
|
26
|
-
| ------------ |
|
|
27
|
-
| `ITEMS` | `
|
|
28
|
-
| `TRANSITION` | `
|
|
29
|
-
| `ZINDEX` | `
|
|
30
|
-
| `LOC_LABEL` | `string`
|
|
31
|
-
| `VIEW_PROPS` | `
|
|
26
|
+
| Ключ | Тип | Смысл |
|
|
27
|
+
| ------------ | ----------------------- | ---------------------------------------------------------------- |
|
|
28
|
+
| `ITEMS` | `GameMenuItemFactory[]` | Фабрики пунктов; резолвятся на SHOW / смене языка через `ITEMS`. |
|
|
29
|
+
| `TRANSITION` | `number` | Длительность анимации (500). |
|
|
30
|
+
| `ZINDEX` | `number` | Z-index экрана (3000). |
|
|
31
|
+
| `LOC_LABEL` | `string` | Имя метки локалей (`gameMenu`). |
|
|
32
|
+
| `VIEW_PROPS` | `ViewProps` | Пропсы Screen / PositionBox / TextControls. |
|
|
33
|
+
|
|
34
|
+
Пункт (`GameMenuItem`): `locKey`, `onClick`, опционально `isDisabled` / `isHided` (как у main menu).
|
|
32
35
|
|
|
33
36
|
## Настройки
|
|
34
37
|
|
|
@@ -38,13 +41,13 @@
|
|
|
38
41
|
|
|
39
42
|
| Модуль | Зона ответственности |
|
|
40
43
|
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
41
|
-
| `gamemenu.controller` | Обрабатывает UPDATE, HIDE, SHOW, STATE_UPDATE, UPDATE_FAST, …. Пустой `controls` на `ZINDEX`, чтобы стопорить слои ниже.
|
|
42
|
-
| `gamemenu.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CLICK` по `
|
|
44
|
+
| `gamemenu.controller` | Обрабатывает UPDATE, HIDE, SHOW, STATE_UPDATE, UPDATE_FAST, …. Пустой `controls` на `ZINDEX`, чтобы стопорить слои ниже. Резолвит `ITEMS` → `items` / `realItems`. |
|
|
45
|
+
| `gamemenu.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `ACCEPT` → `CLICK` по полному индексу пункта (через `realItems`); зеркалит `STATE_UPDATE`; PUSH/POP на SHOW/HIDE. |
|
|
43
46
|
| `gamemenu.controller.arrows` | Наследует `@vnejs/module.controller.arrows.vertical`: `ARROW_UP` / `ARROW_BOTTOM` по видимым пунктам; PUSH/POP controls на SHOW/HIDE; эмитит `STATE_UPDATE` с `{ currentArrowVerticalItem }` и `UPDATE_FAST`. |
|
|
44
47
|
| `gamemenu.hide.controls` | Наследует `@vnejs/module.controller.hide.on.controls`: `BACK` / `MENU` / `GAMEMENU` → `HIDE`; PUSH/POP на SHOW/HIDE. |
|
|
45
48
|
| `gamemenu.hide.state` | Наследует `@vnejs/module.controller.hide.on.state`: `STATE.SET` / `STATE.CLEAR` → `HIDE` с `{ isForce: true }`. |
|
|
46
|
-
| `gamemenu` |
|
|
47
|
-
| `gamemenu.view` | Подмодуль `view`
|
|
49
|
+
| `gamemenu` | `ITEMS` / `CLICK`; пропускает disabled/hided. |
|
|
50
|
+
| `gamemenu.view` | Подмодуль `view` плагина; `isDisabled` / `isNotRender` в TextControls. |
|
|
48
51
|
|
|
49
52
|
## Близкие плагины
|
|
50
53
|
|
|
@@ -56,3 +59,4 @@
|
|
|
56
59
|
### Остальные
|
|
57
60
|
|
|
58
61
|
- [controls.md](../controls/controls.md) — `CONTROLS`: CONST.BUTTONS.BACK, CONST.BUTTONS.MENU, CONST.BUTTONS.GAMEMENU, CONST.BUTTONS.ACCEPT, CONST.BUTTONS.INTERACT, CONST.BUTTONS.ARROW_UP, CONST.BUTTONS.ARROW_BOTTOM
|
|
62
|
+
- [mainmenu.md](./mainmenu.md) — тот же паттерн фабрик пунктов
|
|
@@ -17,7 +17,7 @@
|
|
|
17
17
|
| `TAB_SET` | `vne:settings_screen_view:tab_set` | Выбрать вкладку по ключу из `PARAMS.SETTINGS_VIEW.TABS` (`{ tab: string }`). |
|
|
18
18
|
| `STATE_UPDATE` | `vne:settings_screen_view:state_update` | Слить partial в стейт (в т.ч. `{ tab }` из tabs-модуля). |
|
|
19
19
|
|
|
20
|
-
На `SHOW_BEFORE` fields-модуль эмитит `SETTINGS_VIEW.SHOW` с `{ tab, tabs, tabKey, locs }`; на `TAB_SET` экрана tabs-модуль шлёт `STATE_UPDATE` `{ tab }`, `SETTINGS_VIEW.TAB_SET`
|
|
20
|
+
На `SHOW_BEFORE` fields-модуль эмитит `SETTINGS_VIEW.SHOW` с `{ tab, tabs, tabKey, locs }`; на `TAB_SET` экрана tabs-модуль шлёт `STATE_UPDATE` `{ tab }`, затем `UPDATE_FAST` (chrome) и `SETTINGS_VIEW.TAB_SET` (контент); на `HIDE` — `SETTINGS_VIEW.HIDE`.
|
|
21
21
|
|
|
22
22
|
## Константы
|
|
23
23
|
|
|
@@ -47,7 +47,7 @@
|
|
|
47
47
|
| `settings.screen.controller.fields` | На `SHOW_BEFORE`: фильтр tabs (`showInSettings`) → `STATE_UPDATE` `{ tabs, tab }` → `SETTINGS_VIEW.SHOW`. |
|
|
48
48
|
| `settings.screen.hide.controls` | Наследует `@vnejs/module.controller.hide.on.controls`: `BACK` / `MENU` / `GAMEMENU` → `HIDE`; PUSH/POP на SHOW/HIDE. |
|
|
49
49
|
| `settings.screen.hide.state` | Наследует `@vnejs/module.controller.hide.on.state`: `STATE.SET` / `STATE.CLEAR` → `HIDE` с `{ isForce: true }`. |
|
|
50
|
-
| `settings.screen.controller.tabs` | Наследник `ModuleControllerTabs`: `TAB_SET` → `applyTab` + `onTabSet` (`SETTINGS_VIEW.TAB_SET`
|
|
50
|
+
| `settings.screen.controller.tabs` | Наследник `ModuleControllerTabs`: `TAB_SET` → `applyTab` + `onTabSet` (`UPDATE_FAST`, затем `SETTINGS_VIEW.TAB_SET`); TAB_PREV/TAB_NEXT → `TAB_SET`; `getTabKeys` по `showInSettings`. |
|
|
51
51
|
| `settings.screen.view` | Chrome экрана (Screen, tabs, cross); поля и example text — в `SETTINGS_VIEW`. |
|
|
52
52
|
|
|
53
53
|
## Близкие плагины
|