@vnejs/docs 0.2.30 → 0.2.32

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 (23) hide show
  1. package/CHANGELOG.md +10 -0
  2. package/package.json +1 -1
  3. package/plugins/audio/audio.md +9 -9
  4. package/plugins/audio/voice.md +4 -4
  5. package/plugins/canvas/bg.speak.md +1 -1
  6. package/plugins/canvas/layer.md +4 -5
  7. package/plugins/canvas/sprite.speak.md +7 -7
  8. package/plugins/core/components.md +5 -5
  9. package/plugins/core/interact.md +4 -4
  10. package/plugins/core/logs.md +5 -5
  11. package/plugins/core/media.md +7 -7
  12. package/plugins/core/scenario.md +10 -10
  13. package/plugins/save/auto.md +3 -3
  14. package/plugins/scenario/autoread.md +3 -3
  15. package/plugins/scenario/fastforward.md +2 -2
  16. package/plugins/scenario/pause.md +3 -3
  17. package/plugins/text/locs.md +3 -3
  18. package/plugins/text/smooth.md +7 -7
  19. package/plugins/text/text.md +15 -15
  20. package/plugins/text/wall.md +3 -3
  21. package/plugins/views.scenario/interface.md +30 -30
  22. package/plugins/views.screens/eula.md +1 -1
  23. package/plugins/views.screens/settings.defaults.md +1 -1
package/CHANGELOG.md CHANGED
@@ -2,6 +2,16 @@
2
2
 
3
3
  Краткая история изменений движка (плагины, helpers, packages, CLI и прочий runtime) и внешнего API. Версии — релизы пакета `@vnejs/docs`.
4
4
 
5
+ ## 0.2.32
6
+
7
+ - `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`.
8
+
9
+ ## 0.2.31
10
+
11
+ - `core/logs` — `SETTINGS.INIT` `ENABLED` в `setup`; до `isReady` `EMIT` только буферизуется; в `init` flush очереди по `ENABLED` (иначе clear). API: буфер `LOGS.EMIT` до ready.
12
+ - все плагины с регистрацией настроек — `SETTINGS.INIT` в `setup` (не в `init`): eula, save.auto, autoread, fastforward (+visits), voice.lang, locs, text.process.enabled, text.smooth.cycle, volume/ratio/filter/textsize/potato, cursor scroll/shift, layer.quality, layer.animation, fps, gamepad.debug, settings.defaults, settings.screen.controller, electron (`CONFIG_APPLIED`). Применение значений / REG / DOM остаётся в `init` где было.
13
+ - sync `shared.*` без I/O — в `postinject`: `audioNoSmoothSources`, `layerBgSpeakSources`, `layerSpriteSpeakSources`, `textProcessSkipSources`, `isTextSmoothInProcess`, `isTextWallSetStateInProcess`, `isInteractInProcess`, `mediaNoTimeoutSources`, `autosaveDisableSources`, `pauseDisableSources`, `autoreadDisableSources`, `voiceDisableSources`, `viewForceAnimationSources`, `interfaceTextShowAllTokensOnChange`, `shouldAutostartScenario`. API: создание полей в `Module.postinject()` вместо `init`/`setup`.
14
+
5
15
  ## 0.2.29
6
16
 
7
17
  - `core/memory` — `GET` / `SET` / `KEYS` больше не ждут `waitForModuleReg`. Все `MEMORY.REG` в `setup`: `scenario.label` / `line` / `lines`, `media.memory` (вместе с `#media`), `locs`, `history`. Незарегистрированный namespace: `GET` → `null`, `SET` no-op, `KEYS` → `[]`. Реестр — только `shared.memory` (создаётся в `Memory.postinject`). `GET` / `SET` / `KEYS` в `memory.store`, `CLEAR` в `memory.clear`. API: `shared.memory`.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@vnejs/docs",
3
- "version": "0.2.30",
3
+ "version": "0.2.32",
4
4
  "description": "VNEJS documentation for engine consumers and coding agents",
5
5
  "files": [
6
6
  "*.md",
package/plugins/audio/audio.md CHANGED
@@ -39,15 +39,15 @@
39
39
 
40
40
  ## Модули
41
41
 
42
- | Модуль | Зона ответственности |
43
- | -------------- | ----------------------------------------- |
44
- | `audio.play` | Подмодуль `play` плагина. |
45
- | `audio.stop` | Подмодуль `stop` плагина. |
46
- | `audio.media` | Обрабатывает MEDIA_GET, MEDIA_LOAD. |
47
- | `audio.pause` | Подмодуль `pause` плагина. |
48
- | `audio.volume` | Обрабатывает VOLUME, VOLUME_GET, CHANGED. |
49
- | `audio.resume` | Подмодуль `resume` плагина. |
50
- | `audio.ended` | Обрабатывает PLAY, STOP. |
42
+ | Модуль | Зона ответственности |
43
+ | -------------- | ----------------------------------------------------------------------------------- |
44
+ | `audio.play` | Подмодуль `play` плагина. |
45
+ | `audio.stop` | Подмодуль `stop` плагина. |
46
+ | `audio.media` | В `postinject` — `shared.audioNoSmoothSources`; обрабатывает MEDIA_GET, MEDIA_LOAD. |
47
+ | `audio.pause` | Подмодуль `pause` плагина. |
48
+ | `audio.volume` | Обрабатывает VOLUME, VOLUME_GET, CHANGED. |
49
+ | `audio.resume` | Подмодуль `resume` плагина. |
50
+ | `audio.ended` | Обрабатывает PLAY, STOP. |
51
51
 
52
52
  ## Близкие плагины
53
53
 
package/plugins/audio/voice.md CHANGED
@@ -27,10 +27,10 @@
27
27
 
28
28
  ## Модули
29
29
 
30
- | Модуль | Зона ответственности |
31
- | ------------ | ------------------------- |
32
- | `voice` | Модуль `voice`. |
33
- | `voice.lang` | Подмодуль `lang` плагина. |
30
+ | Модуль | Зона ответственности |
31
+ | ------------ | ---------------------------------------------------------------------------------------------------- |
32
+ | `voice` | Модуль `voice`. |
33
+ | `voice.lang` | В `postinject` — `shared.voiceDisableSources`; `SETTINGS.INIT` LANG в `setup`; `voiceLang` в `init`. |
34
34
 
35
35
  ## Близкие плагины
36
36
 
package/plugins/canvas/bg.speak.md CHANGED
@@ -37,7 +37,7 @@
37
37
 
38
38
  | Модуль | Зона ответственности |
39
39
  | ------------------------- | -------------------------------------------------------------- |
40
- | `layer.bg.speak.sources` | Обрабатывает PUSH, POP. |
40
+ | `layer.bg.speak.sources` | В `postinject` — `shared.layerBgSpeakSources`; PUSH, POP. |
41
41
  | `layer.bg.speak.duration` | Подмодуль `image.speak.duration` плагина. |
42
42
  | `layer.bg.speak.preload` | Подмодуль `image.speak.preload` плагина. |
43
43
  | `layer.bg.speak.staff` | Обрабатывает ARGS_INJECT, BGS_GET, BGS_GET_ACTIVE, OPTION_SET. |
package/plugins/canvas/layer.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  Пакет: `@vnejs/plugins.canvas.layer` · namespace: `LAYER`
4
4
 
5
- Качество canvas, размеры через CSS-переменные и viewport meta.
5
+ Качество canvas и размеры через CSS-переменные. Viewport meta и `overflow: hidden` на `html`/`body` задаёт `entry/index.html` игры, не этот плагин.
6
6
 
7
7
  ## События
8
8
 
@@ -39,10 +39,9 @@
39
39
 
40
40
  ## Модули
41
41
 
42
- | Модуль | Зона ответственности |
43
- | ---------------- | ------------------------------ |
44
- | `layer.quality` | Подмодуль `quality` плагина. |
45
- | `layer.viewport` | Обрабатывает CHANGED, STARTED. |
42
+ | Модуль | Зона ответственности |
43
+ | --------------- | ---------------------------- |
44
+ | `layer.quality` | Подмодуль `quality` плагина. |
46
45
 
47
46
  ## Близкие плагины
48
47
 
package/plugins/canvas/sprite.speak.md CHANGED
@@ -34,13 +34,13 @@ Args спрайта могут содержать `overlays` (как у [sprite.
34
34
 
35
35
  ## Модули
36
36
 
37
- | Модуль | Зона ответственности |
38
- | ----------------------------- | ------------------------------------------ |
39
- | `layer.sprite.speak.sources` | Обрабатывает PUSH, POP. |
40
- | `layer.sprite.speak.duration` | Подмодуль `sprite.speak.duration` плагина. |
41
- | `layer.sprite.speak.preload` | Подмодуль `sprite.speak.preload` плагина. |
42
- | `layer.sprite.speak.staff` | Обрабатывает SPRITE_GET, OPTION_SET. |
43
- | `layer.sprite.speak` | Обрабатывает END, START, SPEAKER. |
37
+ | Модуль | Зона ответственности |
38
+ | ----------------------------- | ------------------------------------------------------------- |
39
+ | `layer.sprite.speak.sources` | В `postinject` — `shared.layerSpriteSpeakSources`; PUSH, POP. |
40
+ | `layer.sprite.speak.duration` | Подмодуль `sprite.speak.duration` плагина. |
41
+ | `layer.sprite.speak.preload` | Подмодуль `sprite.speak.preload` плагина. |
42
+ | `layer.sprite.speak.staff` | Обрабатывает SPRITE_GET, OPTION_SET. |
43
+ | `layer.sprite.speak` | Обрабатывает END, START, SPEAKER. |
44
44
 
45
45
  ## Близкие плагины
46
46
 
package/plugins/core/components.md CHANGED
@@ -27,11 +27,11 @@ React/DOM-контейнер для монтирования view-компоне
27
27
 
28
28
  ## Модули
29
29
 
30
- | Модуль | Зона ответственности |
31
- | ------------------- | ------------------------------------------------------------------------------------------------------ |
32
- | `components.render` | В `setup` создаёт `#components` в DOM и `shared.viewForceAnimationSources`; обрабатывает `RENDER`. |
33
- | `components.inject` | Регистрация и последовательный вызов inject-обработчиков на `INJECT` / `INJECT_REG`. |
34
- | `components.logs` | Логирование `RENDER` (результат фильтруется из ответа emit). |
30
+ | Модуль | Зона ответственности |
31
+ | ------------------- | ------------------------------------------------------------------------------------------------------------------ |
32
+ | `components.render` | В `postinject` — `shared.viewForceAnimationSources`; в `setup` создаёт `#components` в DOM; обрабатывает `RENDER`. |
33
+ | `components.inject` | Регистрация и последовательный вызов inject-обработчиков на `INJECT` / `INJECT_REG`. |
34
+ | `components.logs` | Логирование `RENDER` (результат фильтруется из ответа emit). |
35
35
 
36
36
  ## Близкие плагины
37
37
 
package/plugins/core/interact.md CHANGED
@@ -29,10 +29,10 @@
29
29
 
30
30
  ## Модули
31
31
 
32
- | Модуль | Зона ответственности |
33
- | --------------- | ------------------------------------------------------------------ |
34
- | `interact` | Хранит стек handlers; реализует `EMIT`, `PUSH`, `POP`, `PUSH_POP`. |
35
- | `interact.logs` | Логирование всех событий interact. |
32
+ | Модуль | Зона ответственности |
33
+ | --------------- | -------------------------------------------------------------------------------------------------------- |
34
+ | `interact` | В `postinject` — `shared.isInteractInProcess = false`; стек handlers; `EMIT`, `PUSH`, `POP`, `PUSH_POP`. |
35
+ | `interact.logs` | Логирование всех событий interact. |
36
36
 
37
37
  ## Близкие плагины
38
38
 
package/plugins/core/logs.md CHANGED
@@ -23,15 +23,15 @@
23
23
 
24
24
  ## Настройки
25
25
 
26
- | Ключ | Тип | Смысл |
27
- | ------------------------------ | --------- | ------------------------------------------------------------ |
26
+ | Ключ | Тип | Смысл |
27
+ | ------------------------------ | --------- | --------------------------------------------------- |
28
28
  | `ENABLED` (`vne:logs:enabled`) | `boolean` | Включено ли логирование; `SETTINGS.INIT` в `setup`. |
29
29
 
30
30
  ## Модули
31
31
 
32
- | Модуль | Зона ответственности |
33
- | ------ | ----------------------------------------------------------------------------- |
34
- | `logs` | Очередь логов, `EMIT`/`PUSH`/`LOAD`/`CLEAR`; регистрация настройки `ENABLED` в `setup`. |
32
+ | Модуль | Зона ответственности |
33
+ | ------ | ------------------------------------------------------------------------------------------------------------------------- |
34
+ | `logs` | `SETTINGS.INIT` `ENABLED` в `setup`; до `isReady` буфер `EMIT`; в `init` flush/clear по `ENABLED`; `PUSH`/`LOAD`/`CLEAR`. |
35
35
 
36
36
  ## Близкие плагины
37
37
 
package/plugins/core/media.md CHANGED
@@ -37,13 +37,13 @@
37
37
 
38
38
  ## Модули
39
39
 
40
- | Модуль | Зона ответственности |
41
- | --------------- | ----------------------------------------------------------------------------------------------------------------------------- |
42
- | `media.load` | Semaphore в `setup`; gated load, dedup, делегирование в process/memory. Слот всегда освобождается (`finally`), даже если process reject. |
43
- | `media.process` | Fetch blob и создание DOM-медиа. HTTP не-ok и timeout fetch → `ERROR_FETCH`, без `SET`. |
44
- | `media.memory` | В `setup`: скрытый `#media` и `MEMORY.REG` (`onAdd` / `onClear`). |
45
- | `media` | Высокоуровневый get/set. `GET` возвращает `null`, если asset нет или не готов (битая картинка, error). |
46
- | `media.logs` | Логирование lifecycle media. |
40
+ | Модуль | Зона ответственности |
41
+ | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
42
+ | `media.load` | Semaphore в `setup`; gated load, dedup, делегирование в process/memory. Слот всегда освобождается (`finally`), даже если process reject. |
43
+ | `media.process` | В `postinject` — `shared.mediaNoTimeoutSources` (на WEB сразу `.add("web")`); fetch blob и создание DOM-медиа. HTTP не-ok и timeout fetch → `ERROR_FETCH`, без `SET`. |
44
+ | `media.memory` | В `setup`: скрытый `#media` и `MEMORY.REG` (`onAdd` / `onClear`). |
45
+ | `media` | Высокоуровневый get/set. `GET` возвращает `null`, если asset нет или не готов (битая картинка, error). |
46
+ | `media.logs` | Логирование lifecycle media. |
47
47
 
48
48
  ## Близкие плагины
49
49
 
package/plugins/core/scenario.md CHANGED
@@ -37,20 +37,20 @@
37
37
 
38
38
  ## Shared
39
39
 
40
- | Поле | Тип | Смысл |
41
- | ------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
42
- | `shouldAutostartScenario` | `boolean` | В `start` модуль `scenario.autostart` эмитит `LABEL_GET` (init) и `NEXT`, только если не `false`. В `init` ставится `true` через `??=`; другие плагины могут выставить `false`. `STATE.CLEAR` по-прежнему грузит init label в `scenario.label` без этого гейта. |
40
+ | Поле | Тип | Смысл |
41
+ | ------------------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
42
+ | `shouldAutostartScenario` | `boolean` | В `start` модуль `scenario.autostart` эмитит `LABEL_GET` (init) и `NEXT`, только если не `false`. В `postinject` ставится `true` через `??=`; другие плагины могут выставить `false`. `STATE.CLEAR` по-прежнему грузит init label в `scenario.label` без этого гейта. |
43
43
 
44
44
  ## Модули
45
45
 
46
- | Модуль | Зона ответственности |
47
- | -------------------- | ------------------------------------------------------------------------------------------------------------ |
48
- | `scenario` | Главный цикл `NEXT`, exec строк, sync state. |
49
- | `scenario.autostart` | Дефолт `shared.shouldAutostartScenario`; в `start` — init label + `emitNext` при включённом флаге. |
50
- | `scenario.exec` | Dispatch `$module` / `%block`, registry handlers, `EXEC_DELAY`. |
46
+ | Модуль | Зона ответственности |
47
+ | -------------------- | ------------------------------------------------------------------------------------------------------------------------ |
48
+ | `scenario` | Главный цикл `NEXT`, exec строк, sync state. |
49
+ | `scenario.autostart` | Дефолт `shared.shouldAutostartScenario` в `postinject`; в `start` — init label + `emitNext` при включённом флаге. |
50
+ | `scenario.exec` | Dispatch `$module` / `%block`, registry handlers, `EXEC_DELAY`. |
51
51
  | `scenario.label` | `LABEL_GET`, preload меток; `MEMORY.REG` в `setup`; init label на `STATE.CLEAR`. Одна упавшая строка не валит всю метку. |
52
- | `scenario.line` | `MEMORY.REG` в `setup`; `LINE_LOAD` / `LINE_GET`, registry preload handlers. Executor `LINE_GET` всегда resolve. |
53
- | `scenario.lines` | `MEMORY.REG` в `setup`; fetch `label/<path>.json` с `HOST` (например `label/prologue/1.json`). |
52
+ | `scenario.line` | `MEMORY.REG` в `setup`; `LINE_LOAD` / `LINE_GET`, registry preload handlers. Executor `LINE_GET` всегда resolve. |
53
+ | `scenario.lines` | `MEMORY.REG` в `setup`; fetch `label/<path>.json` с `HOST` (например `label/prologue/1.json`). |
54
54
 
55
55
  ## Близкие плагины
56
56
 
package/plugins/save/auto.md CHANGED
@@ -31,9 +31,9 @@
31
31
 
32
32
  ## Модули
33
33
 
34
- | Модуль | Зона ответственности |
35
- | ----------- | -------------------------------------------------------------- |
36
- | `save.auto` | Подмодуль `auto` плагина; `SAVE.CREATE` с `group: "autosave"`. |
34
+ | Модуль | Зона ответственности |
35
+ | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
36
+ | `save.auto` | В `postinject` — `shared.autosaveDisableSources`; `SETTINGS.INIT` в `setup`; `LINE_EXEC_REG` в `init`; `SAVE.CREATE` с `group: "autosave"`. |
37
37
 
38
38
  ## Близкие плагины
39
39
 
package/plugins/scenario/autoread.md CHANGED
@@ -32,9 +32,9 @@
32
32
 
33
33
  ## Модули
34
34
 
35
- | Модуль | Зона ответственности |
36
- | ---------- | ---------------------------------------- |
37
- | `autoread` | Обрабатывает TRY, PUSH, POP, CHANGED, …. |
35
+ | Модуль | Зона ответственности |
36
+ | ---------- | -------------------------------------------------------------------------------------------------------- |
37
+ | `autoread` | В `postinject` — `shared.autoreadDisableSources`; `SETTINGS.INIT` в `setup`; TRY, PUSH, POP, CHANGED, …. |
38
38
 
39
39
  ## Близкие плагины
40
40
 
package/plugins/scenario/fastforward.md CHANGED
@@ -51,10 +51,10 @@
51
51
 
52
52
  | Модуль | Зона ответственности |
53
53
  | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
54
- | `fastforward` | `STOP`, `START`, `CHECK`, `TOGGLE`; в `init` — `setValue(false)`. |
54
+ | `fastforward` | `STOP`, `START`, `CHECK`, `TOGGLE`; `SETTINGS.INIT` DELAY/ENABLED в `setup`; в `init` — `setValue(false)`. |
55
55
  | `fastforward.emit` | Цикл `EMIT` / `EMIT_CHECK`: `CHECK` → `INTERACT.EMIT`; провал `CHECK` → `STOP`. |
56
56
  | `fastforward.scenario` | `SCENARIO.EXEC` → hash стейта `fastforward.visits` и `VISIT_ADD`. |
57
- | `fastforward.visits` | `VISIT_ADD` пишет в `shared.fastforwardStorage` и снимок стейта. `CHECK` читает Set. |
57
+ | `fastforward.visits` | `SETTINGS.INIT` CHECK_VISITED в `setup`; `VISIT_ADD` пишет в `shared.fastforwardStorage` и снимок стейта. `CHECK` читает Set. |
58
58
  | `fastforward.storage` | `VISIT_ADD` → `STORAGE.SET` с `module` = `this.name`. `GET_ALL` / `RM_ALL` / `CLEAR`. `group` = label, `key` = hash; при init hash берётся из хвоста ключа. На диске: `fastforward.storage/{label}.json`. |
59
59
 
60
60
  ## Близкие плагины
package/plugins/scenario/pause.md CHANGED
@@ -25,9 +25,9 @@
25
25
 
26
26
  ## Модули
27
27
 
28
- | Модуль | Зона ответственности |
29
- | ------- | ------------------------------- |
30
- | `pause` | Обрабатывает END, START, CLEAR. |
28
+ | Модуль | Зона ответственности |
29
+ | ------- | ------------------------------------------------------------------------------------------- |
30
+ | `pause` | В `postinject` — `shared.pauseDisableSources`; `LINE_EXEC_REG` в `init`; END, START, CLEAR. |
31
31
 
32
32
  ## Близкие плагины
33
33
 
package/plugins/text/locs.md CHANGED
@@ -35,9 +35,9 @@
35
35
 
36
36
  ## Модули
37
37
 
38
- | Модуль | Зона ответственности |
39
- | ------ | -------------------------------- |
40
- | `locs` | `MEMORY.REG` в `setup`; LOAD, GET, CHANGED; `SETTINGS.INIT` / inject / replace в `init`. |
38
+ | Модуль | Зона ответственности |
39
+ | ------ | -------------------------------------------------------------------------------------------------------- |
40
+ | `locs` | `MEMORY.REG` + `SETTINGS.INIT` в `setup`; LOAD, GET, CHANGED; inject / replace / `setTextLang` в `init`. |
41
41
 
42
42
  ## Близкие плагины
43
43
 
package/plugins/text/smooth.md CHANGED
@@ -31,13 +31,13 @@
31
31
 
32
32
  ## Модули
33
33
 
34
- | Модуль | Зона ответственности |
35
- | ---------------------- | ----------------------------------------------------- |
36
- | `text.smooth.init` | Подмодуль `smooth.init` плагина. |
37
- | `text.smooth` | Подмодуль `smooth` плагина. |
38
- | `text.smooth.process` | Обрабатывает DONE, EMIT_PROCESS. |
39
- | `text.smooth.cycle` | Обрабатывает SMOOTH, PROCESS_CANCEL, EMIT_END, CLEAR. |
40
- | `text.smooth.emit.end` | Обрабатывает EMIT_END, RECALC_DONE. |
34
+ | Модуль | Зона ответственности |
35
+ | ---------------------- | -------------------------------------------------------- |
36
+ | `text.smooth.init` | В `postinject` — `shared.isTextSmoothInProcess = false`. |
37
+ | `text.smooth` | Подмодуль `smooth` плагина. |
38
+ | `text.smooth.process` | Обрабатывает DONE, EMIT_PROCESS. |
39
+ | `text.smooth.cycle` | Обрабатывает SMOOTH, PROCESS_CANCEL, EMIT_END, CLEAR. |
40
+ | `text.smooth.emit.end` | Обрабатывает EMIT_END, RECALC_DONE. |
41
41
 
42
42
  ## Compatibility
43
43
 
package/plugins/text/text.md CHANGED
@@ -48,20 +48,20 @@
48
48
 
49
49
  ## Модули
50
50
 
51
- | Модуль | Зона ответственности |
52
- | ---------------------- | ------------------------------------------------------ |
53
- | `text.emit.before` | Подмодуль `emit.before` плагина. |
54
- | `text.emit.end` | Завершение emit и переход к next или финальному state. |
55
- | `text.emit.next` | Подмодуль `emit.next` плагина. |
56
- | `text.emit` | Точка входа emit: подготовка и запуск process. |
57
- | `text.exec` | Подмодуль `exec` плагина. |
58
- | `text.prepare.tokens` | Токенизация текста перед отображением. |
59
- | `text.process.state` | Обрабатывает PROCESS_STATE, SET, CLEAR. |
60
- | `text.process.enabled` | Подмодуль `process.enabled` плагина. |
61
- | `text.recalc` | Пересчёт производного состояния текста. |
62
- | `text.replace` | Реестр обработчиков REPLACE_REG. |
63
- | `text.speaker` | Обрабатывает SPEAKER_INFO_UPDATE, CLEAR, SET. |
64
- | `text` | Обрабатывает STATE_UPDATE, STATE_CHANGED, CLEAR, SET. |
51
+ | Модуль | Зона ответственности |
52
+ | ---------------------- | ---------------------------------------------------------------------------- |
53
+ | `text.emit.before` | Подмодуль `emit.before` плагина. |
54
+ | `text.emit.end` | Завершение emit и переход к next или финальному state. |
55
+ | `text.emit.next` | Подмодуль `emit.next` плагина. |
56
+ | `text.emit` | Точка входа emit: подготовка и запуск process. |
57
+ | `text.exec` | Подмодуль `exec` плагина. |
58
+ | `text.prepare.tokens` | Токенизация текста перед отображением. |
59
+ | `text.process.state` | В `postinject` — `shared.textProcessSkipSources`; PROCESS_STATE, SET, CLEAR. |
60
+ | `text.process.enabled` | Подмодуль `process.enabled` плагина. |
61
+ | `text.recalc` | Пересчёт производного состояния текста. |
62
+ | `text.replace` | Реестр обработчиков REPLACE_REG. |
63
+ | `text.speaker` | Обрабатывает SPEAKER_INFO_UPDATE, CLEAR, SET. |
64
+ | `text` | Обрабатывает STATE_UPDATE, STATE_CHANGED, CLEAR, SET. |
65
65
 
66
66
  ## Compatibility
67
67
 
@@ -69,7 +69,7 @@
69
69
 
70
70
  Пакет: `@vnejs/compatibility.views.scenario.interface-with-text`
71
71
 
72
- Связка с [interface.md](../views.scenario/interface.md): `CHANGED` / `SPEAKER_CHANGED` / `EMIT_BEFORE` → `INTERFACE.TEXT_CHANGED` / `SPEAKER_CHANGED` / `SHOW`. Init ставит `shared.interfaceTextShowAllTokensOnChange`.
72
+ Связка с [interface.md](../views.scenario/interface.md): `CHANGED` / `SPEAKER_CHANGED` / `EMIT_BEFORE` → `INTERFACE.TEXT_CHANGED` / `SPEAKER_CHANGED` / `SHOW`. В `postinject` ставит `shared.interfaceTextShowAllTokensOnChange`.
73
73
 
74
74
  ## Близкие плагины
75
75
 
package/plugins/text/wall.md CHANGED
@@ -24,9 +24,9 @@
24
24
 
25
25
  ## Модули
26
26
 
27
- | Модуль | Зона ответственности |
28
- | ----------- | -------------------------------- |
29
- | `text.wall` | Обрабатывает RECALC, CLEAR, SET. |
27
+ | Модуль | Зона ответственности |
28
+ | ----------- | ---------------------------------------------------------------------------------- |
29
+ | `text.wall` | В `postinject` — `shared.isTextWallSetStateInProcess = false`; RECALC, CLEAR, SET. |
30
30
 
31
31
  ## Близкие плагины
32
32
 
package/plugins/views.scenario/interface.md CHANGED
@@ -6,32 +6,32 @@
6
6
 
7
7
  ## События
8
8
 
9
- | Ключ | Строка | Смысл |
10
- | ------------------------ | -------------------------------------- | ------------------------------------------- |
11
- | `SHOW` | `vne:interface:show` | Показать UI или слой. |
12
- | `HIDE` | `vne:interface:hide` | Скрыть UI или слой. |
13
- | `SHOW_CHANGED` | `vne:interface:show_changed` | Показать UI или слой. |
14
- | `VIEW_SHOW` | `vne:interface:view_show` | Показать UI или слой. |
15
- | `VIEW_HIDE` | `vne:interface:view_hide` | Скрыть UI или слой. |
16
- | `VIEW_UPDATE` | `vne:interface:view_update` | Обновить состояние или отображение. |
17
- | `TEXT_HIDE` | `vne:interface:text_hide` | Скрыть UI или слой. |
18
- | `TEXT_CHANGED` | `vne:interface:text_changed` | Зафиксировать изменение состояния. |
19
- | `WALL_CHANGED` | `vne:interface:wall_changed` | Зафиксировать изменение состояния. |
20
- | `SPEAKER_CHANGED` | `vne:interface:speaker_changed` | Зафиксировать смену текущего спикера. |
21
- | `VISIBLE` | `vne:interface:visible` | Событие `VISIBLE` namespace плагина. |
22
- | `VISIBLE_CHANGED` | `vne:interface:visible_changed` | Зафиксировать изменение состояния. |
23
- | `VIEW` | `vne:interface:view` | Событие `VIEW` namespace плагина. |
24
- | `VIEW_CHANGED` | `vne:interface:view_changed` | Зафиксировать изменение состояния. |
25
- | `INTERACT` | `vne:interface:interact` | Событие `INTERACT` namespace плагина. |
26
- | `STATE_CHANGED` | `vne:interface:state_changed` | Сигнал об изменении накопленного состояния. |
9
+ | Ключ | Строка | Смысл |
10
+ | ----------------- | ------------------------------- | ------------------------------------------- |
11
+ | `SHOW` | `vne:interface:show` | Показать UI или слой. |
12
+ | `HIDE` | `vne:interface:hide` | Скрыть UI или слой. |
13
+ | `SHOW_CHANGED` | `vne:interface:show_changed` | Показать UI или слой. |
14
+ | `VIEW_SHOW` | `vne:interface:view_show` | Показать UI или слой. |
15
+ | `VIEW_HIDE` | `vne:interface:view_hide` | Скрыть UI или слой. |
16
+ | `VIEW_UPDATE` | `vne:interface:view_update` | Обновить состояние или отображение. |
17
+ | `TEXT_HIDE` | `vne:interface:text_hide` | Скрыть UI или слой. |
18
+ | `TEXT_CHANGED` | `vne:interface:text_changed` | Зафиксировать изменение состояния. |
19
+ | `WALL_CHANGED` | `vne:interface:wall_changed` | Зафиксировать изменение состояния. |
20
+ | `SPEAKER_CHANGED` | `vne:interface:speaker_changed` | Зафиксировать смену текущего спикера. |
21
+ | `VISIBLE` | `vne:interface:visible` | Событие `VISIBLE` namespace плагина. |
22
+ | `VISIBLE_CHANGED` | `vne:interface:visible_changed` | Зафиксировать изменение состояния. |
23
+ | `VIEW` | `vne:interface:view` | Событие `VIEW` namespace плагина. |
24
+ | `VIEW_CHANGED` | `vne:interface:view_changed` | Зафиксировать изменение состояния. |
25
+ | `INTERACT` | `vne:interface:interact` | Событие `INTERACT` namespace плагина. |
26
+ | `STATE_CHANGED` | `vne:interface:state_changed` | Сигнал об изменении накопленного состояния. |
27
27
 
28
28
  ## Константы
29
29
 
30
- | Ключ | Значение | Смысл |
31
- | ----------------------- | -------- | ------------------------------------------ |
32
- | `EXEC_ACTIONS.SHOW` | `show` | Сценарное действие `$ interface show`. |
33
- | `EXEC_ACTIONS.HIDE` | `hide` | Сценарное действие `$ interface hide`. |
34
- | `EXEC_ACTIONS.VIEW` | `view` | Сценарное действие `$ interface view …`. |
30
+ | Ключ | Значение | Смысл |
31
+ | ------------------- | -------- | ---------------------------------------- |
32
+ | `EXEC_ACTIONS.SHOW` | `show` | Сценарное действие `$ interface show`. |
33
+ | `EXEC_ACTIONS.HIDE` | `hide` | Сценарное действие `$ interface hide`. |
34
+ | `EXEC_ACTIONS.VIEW` | `view` | Сценарное действие `$ interface view …`. |
35
35
 
36
36
  ## Параметры
37
37
 
@@ -49,14 +49,14 @@
49
49
 
50
50
  ## Модули
51
51
 
52
- | Модуль | Зона ответственности |
53
- | ---------------------- | ------------------------------------------------------------ |
54
- | `interface.controller` | Обрабатывает VIEW_UPDATE, VIEW_SHOW, VIEW_HIDE, …. Пустой `controls` на `ZINDEX`; `CONTROLS_UNVISIBLE` при скрытии слоя. |
52
+ | Модуль | Зона ответственности |
53
+ | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
54
+ | `interface.controller` | Обрабатывает VIEW_UPDATE, VIEW_SHOW, VIEW_HIDE, …. Пустой `controls` на `ZINDEX`; `CONTROLS_UNVISIBLE` при скрытии слоя. |
55
55
  | `interface.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `INTERFACE.INTERACT`; видимый слой → `INTERACT.EMIT`, скрытый → `INTERFACE.VISIBLE`; PUSH/POP на VIEW_SHOW/HIDE. |
56
- | `interface` | STATE.SET / STATE.CLEAR → STATE_CHANGED. |
57
- | `interface.scenario` | `$ interface`: `LINE_EXEC_REG` → SHOW / HIDE / VIEW по `CONST.INTERFACE.EXEC_ACTIONS`. |
56
+ | `interface` | STATE.SET / STATE.CLEAR → STATE_CHANGED. |
57
+ | `interface.scenario` | `$ interface`: `LINE_EXEC_REG` → SHOW / HIDE / VIEW по `CONST.INTERFACE.EXEC_ACTIONS`. |
58
58
  | `interface.actions` | SHOW / HIDE / VISIBLE / TEXT_HIDE / VIEW через `globalState.interface`. |
59
- | `interface.view` | Подмодуль `view` плагина. |
59
+ | `interface.view` | Подмодуль `view` плагина. |
60
60
 
61
61
  ## Compatibility
62
62
 
@@ -64,7 +64,7 @@
64
64
 
65
65
  Пакет: `@vnejs/compatibility.views.scenario.interface-with-text`
66
66
 
67
- На `TEXT.CHANGED` эмитит `INTERFACE.TEXT_CHANGED` (`tokensVisible` = длина токенов, если `shared.interfaceTextShowAllTokensOnChange`). На `TEXT.SPEAKER_CHANGED` — `INTERFACE.SPEAKER_CHANGED`. В `init` ставит флаг в `true` и регистрирует `TEXT.EMIT_BEFORE` → `INTERFACE.SHOW`. Подключается в `bundles/vn.skeleton`.
67
+ На `TEXT.CHANGED` эмитит `INTERFACE.TEXT_CHANGED` (`tokensVisible` = длина токенов, если `shared.interfaceTextShowAllTokensOnChange`). На `TEXT.SPEAKER_CHANGED` — `INTERFACE.SPEAKER_CHANGED`. В `postinject` ставит флаг в `true`; в `init` регистрирует `TEXT.EMIT_BEFORE` → `INTERFACE.SHOW`. Подключается в `bundles/vn.skeleton`.
68
68
 
69
69
  ### `compatibility/views.scenario.interface/text.smooth/`
70
70
 
package/plugins/views.screens/eula.md CHANGED
@@ -42,7 +42,7 @@
42
42
  | `eula.controller.arrows` | Наследует `@vnejs/module.controller.arrows.vertical`: `ARROW_UP` / `ARROW_BOTTOM` по строкам текста; пустые строки через `isArrowItemAvailable`; смена `SETTINGS.EULA.LANG` сбрасывает индекс; PUSH/POP на SHOW/HIDE; эмитит `STATE_UPDATE` с `{ currentArrowVerticalItem }` и `UPDATE_FAST`. |
43
43
  | `eula.controller.accept` | Наследует `@vnejs/module.controller.accept`: только `ACCEPT` (`IS_INTERACT_ENABLED = false`) → `EULA.ACCEPT` → `ACCEPTED_VERSION`, `HIDE`; PUSH/POP на SHOW/HIDE. |
44
44
  | `eula.hide.state` | Наследует `@vnejs/module.controller.hide.on.state`: `STATE.SET` / `STATE.CLEAR` → `HIDE` с `{ isForce: true }`. |
45
- | `eula` | В `setup` — `SETTINGS.INIT` для версии и языка; `MAINMENU.SHOW` → `SHOW` (если версия не принята); `EXIT` → `SYSTEM.CLOSE`. |
45
+ | `eula` | В `setup` — `SETTINGS.INIT` для версии и языка; `MAINMENU.SHOW` → `SHOW` (если версия не принята); `EXIT` → `SYSTEM.CLOSE`. |
46
46
  | `eula.view` | Подмодуль `view` плагина. |
47
47
 
48
48
  ## Близкие плагины
package/plugins/views.screens/settings.defaults.md CHANGED
@@ -39,7 +39,7 @@ Breaking: раньше namespace был `SETTINGS_DEFAULTS`, события `vne
39
39
  | ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
40
40
  | `settings.default.controller` | SHOW/HIDE; связка с `SETTINGS_VIEW`. |
41
41
  | `settings.default.controller.accept` | Наследует `@vnejs/module.controller.accept`: только `ACCEPT` (`IS_INTERACT_ENABLED = false`) → `CONFIRM` → `INITED`, `HIDE`, `emitNext`; PUSH/POP на SHOW/HIDE. |
42
- | `settings.default` | Сценарий: `LINE_EXEC` как `$ settings.defaults` (`execName`) → `SHOW`, либо `emitNext` при `skip_if_possible` и `INITED`. |
42
+ | `settings.default` | `SETTINGS.INIT` INITED в `setup`; `LINE_EXEC` как `$ settings.defaults` → `SHOW`, либо `emitNext` при `skip_if_possible` и `INITED`. |
43
43
  | `settings.default.view` | Chrome: title + кнопка Accept. |
44
44
 
45
45
  ## Близкие плагины