@vnejs/docs 0.2.31 → 0.2.33
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 +10 -0
- package/package.json +1 -1
- package/plugins/canvas/layer.md +4 -5
- package/plugins/core/memory.md +12 -12
- package/plugins/text/locs.md +16 -8
- package/plugins/views.scenario/point_and_click.md +5 -5
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,16 @@
|
|
|
2
2
|
|
|
3
3
|
Краткая история изменений движка (плагины, helpers, packages, CLI и прочий runtime) и внешнего API. Версии — релизы пакета `@vnejs/docs`.
|
|
4
4
|
|
|
5
|
+
## 0.2.33
|
|
6
|
+
|
|
7
|
+
- `views.scenario/point_and_click` — `SETTINGS.CHANGED` обновляет view только при `state.isShow` (`point_and_click_view.controller`).
|
|
8
|
+
- `core/memory` — `MEMORY.CLEAR` до `isReady` модуля `memory.clear` игнорируется (нет чистки и нет `CLEARED`).
|
|
9
|
+
- `text/locs` — `SETTINGS.CHANGED` не вызывает `setTextLang`, пока `locs` не `isReady`. Применение языка — `LOCS.SET` (`init` и `SETTINGS.CHANGED` после `isReady`), не метод модуля. В `postinject` `shared.textLang = PARAMS.LOCS.DEFAULT_LANG`; ожидание кадра до языка снято. Чтение и запись уже загруженного словаря — события модуля `locs.memory`, не прямой `MEMORY` из загрузчика. `LOCS.MEMORY_SET` принимает `{ label, group, lang?, value }`, ключ считает модуль. API: `LOCS.SET`, `LOCS.MEMORY_GET`, `LOCS.MEMORY_SET`, `shared.textLang`.
|
|
10
|
+
|
|
11
|
+
## 0.2.32
|
|
12
|
+
|
|
13
|
+
- `canvas/layer` — снят модуль `layer.viewport` (он задавал viewport meta размером canvas, `width=1920,height=1080`). Viewport и запрет скролла документа — в `entry/index.html` игры: `width=device-width, initial-scale=1`, `overflow: hidden` на `html`/`body`. Так в `games/coraline` и `games/vn.skeleton`. Разрешение canvas по-прежнему в `--vne-canvas-width` / `--vne-canvas-height`.
|
|
14
|
+
|
|
5
15
|
## 0.2.31
|
|
6
16
|
|
|
7
17
|
- `core/logs` — `SETTINGS.INIT` `ENABLED` в `setup`; до `isReady` `EMIT` только буферизуется; в `init` flush очереди по `ENABLED` (иначе clear). API: буфер `LOGS.EMIT` до ready.
|
package/package.json
CHANGED
package/plugins/canvas/layer.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
Пакет: `@vnejs/plugins.canvas.layer` · namespace: `LAYER`
|
|
4
4
|
|
|
5
|
-
Качество canvas
|
|
5
|
+
Качество canvas и размеры через CSS-переменные. Viewport meta и `overflow: hidden` на `html`/`body` задаёт `entry/index.html` игры, не этот плагин. У `html` и `body` должна быть `height: 100%`, у `body` — flex-центрирование: иначе 16:9-бокс `#app` от `ratio` прилипает к верху окна.
|
|
6
6
|
|
|
7
7
|
## События
|
|
8
8
|
|
|
@@ -39,10 +39,9 @@
|
|
|
39
39
|
|
|
40
40
|
## Модули
|
|
41
41
|
|
|
42
|
-
| Модуль
|
|
43
|
-
|
|
|
44
|
-
| `layer.quality`
|
|
45
|
-
| `layer.viewport` | Обрабатывает CHANGED, STARTED. |
|
|
42
|
+
| Модуль | Зона ответственности |
|
|
43
|
+
| --------------- | --------------------------------------------------------------------------------- |
|
|
44
|
+
| `layer.quality` | Качество → CSS-размеры и `SETTINGS.LAYER.WIDTH` / `HEIGHT`, затем `MEMORY.CLEAR`. |
|
|
46
45
|
|
|
47
46
|
## Близкие плагины
|
|
48
47
|
|
package/plugins/core/memory.md
CHANGED
|
@@ -6,14 +6,14 @@ In-memory кэш с reference counting по namespace модуля; исполь
|
|
|
6
6
|
|
|
7
7
|
## События
|
|
8
8
|
|
|
9
|
-
| Ключ | Строка | Смысл
|
|
10
|
-
| --------- | -------------------- |
|
|
11
|
-
| `GET` | `vne:memory:get` | Получить значение по `module` + `key`; сбросить счётчик ссылок до `initCounter`.
|
|
12
|
-
| `SET` | `vne:memory:set` | Сохранить значение; при первой записи вызвать `onAdd` зарегистрированного namespace.
|
|
13
|
-
| `REG` | `vne:memory:reg` | Зарегистрировать namespace с `initCounter`, хуками `onAdd` / `onClear`.
|
|
14
|
-
| `KEYS` | `vne:memory:keys` | Список ключей в namespace.
|
|
15
|
-
| `CLEAR` | `vne:memory:clear` |
|
|
16
|
-
| `CLEARED` | `vne:memory:cleared` | In-memory кэш полностью очищен.
|
|
9
|
+
| Ключ | Строка | Смысл |
|
|
10
|
+
| --------- | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
11
|
+
| `GET` | `vne:memory:get` | Получить значение по `module` + `key`; сбросить счётчик ссылок до `initCounter`. |
|
|
12
|
+
| `SET` | `vne:memory:set` | Сохранить значение; при первой записи вызвать `onAdd` зарегистрированного namespace. |
|
|
13
|
+
| `REG` | `vne:memory:reg` | Зарегистрировать namespace с `initCounter`, хуками `onAdd` / `onClear`. |
|
|
14
|
+
| `KEYS` | `vne:memory:keys` | Список ключей в namespace. |
|
|
15
|
+
| `CLEAR` | `vne:memory:clear` | Если модуль `memory.clear` ещё не `isReady` — no-op. Иначе уменьшает счётчики, удаляет записи с нулевым счётчиком, вызывает `onClear` и `CLEARED`. |
|
|
16
|
+
| `CLEARED` | `vne:memory:cleared` | In-memory кэш полностью очищен. |
|
|
17
17
|
|
|
18
18
|
## Константы
|
|
19
19
|
|
|
@@ -29,11 +29,11 @@ In-memory кэш с reference counting по namespace модуля; исполь
|
|
|
29
29
|
|
|
30
30
|
## Модули
|
|
31
31
|
|
|
32
|
-
| Модуль | Зона ответственности
|
|
33
|
-
| -------------- |
|
|
34
|
-
| `memory` | `REG` и `shared.memory = {}` в `postinject`.
|
|
32
|
+
| Модуль | Зона ответственности |
|
|
33
|
+
| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
34
|
+
| `memory` | `REG` и `shared.memory = {}` в `postinject`. |
|
|
35
35
|
| `memory.store` | `GET` / `SET` / `KEYS` через `shared.memory`. Не ждут `REG` — namespace регистрируют в `setup`. Незарегистрированный: `GET` → `null`, `SET` no-op, `KEYS` → `[]`. |
|
|
36
|
-
| `memory.clear` | `CLEAR`: уменьшает счётчики в `shared.memory`, удаляет записи с нулевым счётчиком, `onClear`, затем `CLEARED`.
|
|
36
|
+
| `memory.clear` | `CLEAR`: до `isReady` игнорируется. Иначе уменьшает счётчики в `shared.memory`, удаляет записи с нулевым счётчиком, `onClear`, затем `CLEARED`. |
|
|
37
37
|
|
|
38
38
|
## Близкие плагины
|
|
39
39
|
|
package/plugins/text/locs.md
CHANGED
|
@@ -8,11 +8,14 @@
|
|
|
8
8
|
|
|
9
9
|
## События
|
|
10
10
|
|
|
11
|
-
| Ключ
|
|
12
|
-
|
|
|
13
|
-
| `LOAD`
|
|
14
|
-
| `GET`
|
|
15
|
-
| `
|
|
11
|
+
| Ключ | Строка | Смысл |
|
|
12
|
+
| ------------ | --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
13
|
+
| `LOAD` | `vne:locs:load` | Запросить данные у обработчиков и продолжить цепочку. Payload: `{ label, group, lang? }`. Без `group` файл не грузится. |
|
|
14
|
+
| `GET` | `vne:locs:get` | Получить словарь. Payload: `{ label, group, lang? }`. Без `group` — пустой объект. |
|
|
15
|
+
| `MEMORY_GET` | `vne:locs:memory_get` | Уже загруженный словарь из памяти, без загрузки. Payload: `{ label, group, lang? }`. Без `group` — `undefined`. |
|
|
16
|
+
| `MEMORY_SET` | `vne:locs:memory_set` | Записать словарь в память ядра. Payload: `{ label, group, lang?, value }`. Ключ считает модуль. Без `group` — ничего. `module` не передаётся — всегда `locs.memory`. |
|
|
17
|
+
| `SET` | `vne:locs:set` | Применить язык: `shared.textLang` и `CHANGED`. Payload: `{ lang }`. Без `lang` — ничего. |
|
|
18
|
+
| `CHANGED` | `vne:locs:changed` | Зафиксировать изменение состояния. |
|
|
16
19
|
|
|
17
20
|
## Константы
|
|
18
21
|
|
|
@@ -35,9 +38,14 @@
|
|
|
35
38
|
|
|
36
39
|
## Модули
|
|
37
40
|
|
|
38
|
-
| Модуль
|
|
39
|
-
|
|
|
40
|
-
| `locs`
|
|
41
|
+
| Модуль | Зона ответственности |
|
|
42
|
+
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
43
|
+
| `locs` | В `postinject` — `shared.textLang = PARAMS.LOCS.DEFAULT_LANG`. `SETTINGS.INIT` в `setup`. `SET` применяет язык и эмитит `CHANGED`. `init` и `SETTINGS.CHANGED` после `isReady` эмитят `SET`. Чтение словаря — `MEMORY_GET`. |
|
|
44
|
+
| `locs.changed` | `CHANGED`: если словаря меток нет — `LOAD`, затем `TEXT.RECALC` и `COMPONENTS.EXTERNAL_UPDATE`. |
|
|
45
|
+
| `locs.memory` | `MEMORY.REG` в `setup` с `module: this.name` (`locs.memory`). `MEMORY_GET` / `MEMORY_SET`. |
|
|
46
|
+
| `locs.load` | `LOCS.LOAD`: fetch словаря, чтение и запись только через `MEMORY_GET` / `MEMORY_SET`. |
|
|
47
|
+
| `locs.components.inject` | `COMPONENTS.INJECT_REG` в `init`. `LOC_LABEL` → `LOCS.GET` с `GROUPS.VIEWS`. |
|
|
48
|
+
| `locs.text.replace` | `TEXT.REPLACE_REG` в `init` с priority `-999999`. Без `group` — `GROUPS.LABELS`. |
|
|
41
49
|
|
|
42
50
|
## Близкие плагины
|
|
43
51
|
|
|
@@ -33,11 +33,11 @@ React-UI point-and-click (иконки-hotspot). Зависит от scenario-п
|
|
|
33
33
|
|
|
34
34
|
## Модули
|
|
35
35
|
|
|
36
|
-
| Модуль | Зона ответственности
|
|
37
|
-
| --------------------------------- |
|
|
38
|
-
| `point_and_click_view.bridge` | Bridge `POINT_AND_CLICK.SHOW/HIDE` → `POINT_AND_CLICK_VIEW.SHOW/HIDE`; на hide — `INTERFACE.TEXT_HIDE`.
|
|
39
|
-
| `point_and_click_view.controller` | Загрузка `iconSrc`, `controls` из `CONTROLS_EXTENSIONS` в `init`, `beforeShow` / `afterHide`.
|
|
40
|
-
| `point_and_click_view.view` | React-render hotspot-иконок.
|
|
36
|
+
| Модуль | Зона ответственности |
|
|
37
|
+
| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
38
|
+
| `point_and_click_view.bridge` | Bridge `POINT_AND_CLICK.SHOW/HIDE` → `POINT_AND_CLICK_VIEW.SHOW/HIDE`; на hide — `INTERFACE.TEXT_HIDE`. |
|
|
39
|
+
| `point_and_click_view.controller` | Загрузка `iconSrc`, `controls` из `CONTROLS_EXTENSIONS` в `init`, `beforeShow` / `afterHide`. `SETTINGS.CHANGED` → `updateViewFast` только при `state.isShow`. |
|
|
40
|
+
| `point_and_click_view.view` | React-render hotspot-иконок. |
|
|
41
41
|
|
|
42
42
|
## Связь с POINT_AND_CLICK
|
|
43
43
|
|