@vnejs/docs 0.2.43 → 0.2.44

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 (4) hide show
  1. package/CHANGELOG.md +4 -1
  2. package/package.json +1 -1
  3. package/plugins/canvas/bg.md +2 -1
  4. package/plugins/core/stack.md +21 -21
package/CHANGELOG.md CHANGED
@@ -4,7 +4,10 @@
4
4
 
5
5
  ## 0.2.43
6
6
 
7
- - `canvas/bg` — `$ <layer>.bg change … <duration>`: сначала `transition`, затем смена `src` (как `sprite.move`), без opacity-кроссфейда `SHOW`.
7
+ - `core/stack` — `STACK.EMIT` (`$ stack jump` / `call`) ждёт завершения `MEMORY.CLEAR` перед возвратом, чтобы первая строка нового лейбла не гонялась с `CLEARED`.
8
+ - `canvas/bg` — `$ <layer>.bg change … <duration>`: `transition` → `waitRerender` → смена `src` (как `sprite.move`); bg-`Image` с `isSwitchDisabled` (overlays не slideshow).
9
+ - `uis.react` Image — `transition` как у Cursor (`background-image` + `opacity`); switcher не крутит кадры без `duration` и при `isAllSrcRendered`; `isAllSrcRendered` пишет слои в `--vne-image-src`, не в inline `backgroundImage`.
10
+ - `module.layer` — `updateChildren` ждёт `updateStateAndViewFast` до `waitTimeout`.
8
11
  - `save/quick` — слот быстрого сохранения (`SAVE_QUICK`): `MAKE` / `LOAD` / `PRELOAD`; `CONST.SAVE_QUICK.SAVE_GROUP` (`"quick"`); `shared.hasQuickSave`.
9
12
  - `views.screens/gamemenu` — пункты через `GameMenuItemFactory[]`; `EVENTS.GAMEMENU.ITEMS`; `isDisabled` / `isHided` (вместо `disabled` / `hided`). API: `GameMenuItemFactory`, `EVENTS.GAMEMENU.ITEMS`, `GameMenuItem.isDisabled` / `isHided`.
10
13
  - `views.screens/settings.defaults` — hover у кнопки Accept: `PARAMS.SETTINGS_DEFAULT_VIEW.VIEW_PROPS.accept.isHoverable` (`true`).
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@vnejs/docs",
3
- "version": "0.2.43",
3
+ "version": "0.2.44",
4
4
  "description": "VNEJS documentation for engine consumers and coding agents",
5
5
  "files": [
6
6
  "*.md",
package/plugins/canvas/bg.md CHANGED
@@ -7,7 +7,8 @@
7
7
  ## SHOW vs CHANGE
8
8
 
9
9
  - **`SHOW`** — новый child (часто fade через `opacity`), старые при необходимости снимаются.
10
- - **`CHANGE`** — смена `src` у уже существующего child. При `duration > 0` сначала выставляется `transition`, затем меняется `src` (как у `sprite.move`), без opacity-кроссфейда как у `SHOW`.
10
+ - **`CHANGE`** — смена `src` у уже существующего child. При `duration > 0`: `transition` → `waitRerender` → смена `src` (как `sprite.move`), без opacity-кроссфейда `SHOW`.
11
+ - Bg-`Image` всегда с `isSwitchDisabled` — overlay-массив `src` не крутится как slideshow-кадры.
11
12
 
12
13
  ## Overlays
13
14
 
package/plugins/core/stack.md CHANGED
@@ -6,17 +6,17 @@
6
6
 
7
7
  ## События
8
8
 
9
- | Ключ | Строка | Смысл |
10
- | --------------- | --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
11
- | `EMIT` | `vne:stack:emit` | Перейти на метку: сброс `curLine`, clone args, preload label, clear memory. Payload: `{ label?, args? }`. Перед переходом — `PROHIBIT_REPLACE`; при запрете — `PROHIBITED`, без `LABEL_GET`. |
12
- | `POP` | `vne:stack:pop` | Вернуться к предыдущей позиции в стеке или сбросить игру, если стек пуст. |
13
- | `CLEAR` | `vne:stack:clear` | Сбросить глобальный state и продолжить сценарий. |
14
- | `JUMP` | `vne:stack:jump` | Переход на метку без push в стек (делегирует в `EMIT`). |
15
- | `CALL` | `vne:stack:call` | `PROHIBIT_REPLACE`, затем push текущей позиции и `EMIT`. При запрете — `PROHIBITED`, без push. |
16
- | `EXEC_ARG` | `vne:stack:exec_arg` | По токену строки вернуть значение аргумента из верхнего frame. Payload: `{ line? }`. |
17
- | `PROHIBIT_REPLACE` | `vne:stack:prohibit_replace` | Цепочка `ModuleReplace`: можно ли идти на `label`. Payload: `{ label?, isProhibited? }`. Старт `isProhibited: false`. Возврат — итоговое `isProhibited`. |
18
- | `PROHIBIT_REPLACE_REG` | `vne:stack:prohibit_replace_reg` | Зарегистрировать обработчик `PROHIBIT_REPLACE`. `{ handler, priority? }`. Не блокирующий хендлер: `return isProhibited`; запрет: `return isProhibited \|\| ownCheck`. |
19
- | `PROHIBITED` | `vne:stack:prohibited` | Переход запрещён. Payload: `{ label?, args?, event? }` — `event` это `JUMP` / `CALL` / `EMIT`, чтобы повторить переход. `$ stack jump/call` при запрете не делает `emitNext`. |
9
+ | Ключ | Строка | Смысл |
10
+ | ---------------------- | -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
11
+ | `EMIT` | `vne:stack:emit` | Перейти на метку: сброс `curLine`, clone args, preload label, **await** `MEMORY.CLEAR` (до возврата из `EMIT`). Payload: `{ label?, args? }`. Перед переходом — `PROHIBIT_REPLACE`; при запрете — `PROHIBITED`, без `LABEL_GET`. |
12
+ | `POP` | `vne:stack:pop` | Вернуться к предыдущей позиции в стеке или сбросить игру, если стек пуст. |
13
+ | `CLEAR` | `vne:stack:clear` | Сбросить глобальный state и продолжить сценарий. |
14
+ | `JUMP` | `vne:stack:jump` | Переход на метку без push в стек (делегирует в `EMIT`). |
15
+ | `CALL` | `vne:stack:call` | `PROHIBIT_REPLACE`, затем push текущей позиции и `EMIT`. При запрете — `PROHIBITED`, без push. |
16
+ | `EXEC_ARG` | `vne:stack:exec_arg` | По токену строки вернуть значение аргумента из верхнего frame. Payload: `{ line? }`. |
17
+ | `PROHIBIT_REPLACE` | `vne:stack:prohibit_replace` | Цепочка `ModuleReplace`: можно ли идти на `label`. Payload: `{ label?, isProhibited? }`. Старт `isProhibited: false`. Возврат — итоговое `isProhibited`. |
18
+ | `PROHIBIT_REPLACE_REG` | `vne:stack:prohibit_replace_reg` | Зарегистрировать обработчик `PROHIBIT_REPLACE`. `{ handler, priority? }`. Не блокирующий хендлер: `return isProhibited`; запрет: `return isProhibited \|\| ownCheck`. |
19
+ | `PROHIBITED` | `vne:stack:prohibited` | Переход запрещён. Payload: `{ label?, args?, event? }` — `event` это `JUMP` / `CALL` / `EMIT`, чтобы повторить переход. `$ stack jump/call` при запрете не делает `emitNext`. |
20
20
 
21
21
  ## Константы
22
22
 
@@ -33,17 +33,17 @@
33
33
 
34
34
  ## Модули
35
35
 
36
- | Модуль | Зона ответственности |
37
- | --------------- | ------------------------------------------------------------------------------------------------------------- |
38
- | `stack` | State стека; обработка `EMIT` (`PROHIBIT_REPLACE` → переход или `PROHIBITED`); sync на `STATE.SET` / `CLEAR`. |
39
- | `stack.call` | `PROHIBIT_REPLACE`, затем push frame + `EMIT`. |
40
- | `stack.jump` | Jump без сохранения. |
41
- | `stack.pop` | Pop frame. |
42
- | `stack.clear` | Clear state + next. |
43
- | `stack.args` | Резолв аргументов из строки сценария. |
36
+ | Модуль | Зона ответственности |
37
+ | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
38
+ | `stack` | State стека; обработка `EMIT` (`PROHIBIT_REPLACE` → переход или `PROHIBITED`); sync на `STATE.SET` / `CLEAR`. |
39
+ | `stack.call` | `PROHIBIT_REPLACE`, затем push frame + `EMIT`. |
40
+ | `stack.jump` | Jump без сохранения. |
41
+ | `stack.pop` | Pop frame. |
42
+ | `stack.clear` | Clear state + next. |
43
+ | `stack.args` | Резолв аргументов из строки сценария. |
44
44
  | `stack.exec` | Регистрация `$stack` handlers в scenario (jump/call/pop + preload). На `LINE_LOAD` jump/call — `PROHIBIT_REPLACE` до `LABEL_GET`. `onLineExec`: `emitNext` только если jump/call не вернули `false` (запрет); `pop` — как раньше. |
45
- | `stack.replace` | Реестр обработчиков `PROHIBIT_REPLACE_REG`; наследник `@vnejs/module.replace`; `REPLACE_KEY` — `isProhibited`. |
46
- | `stack.logs` | Логирование операций стека, в т.ч. `PROHIBITED`; в `init` регистрирует хендлер `PROHIBIT_REPLACE` (пропускает флаг). |
45
+ | `stack.replace` | Реестр обработчиков `PROHIBIT_REPLACE_REG`; наследник `@vnejs/module.replace`; `REPLACE_KEY` — `isProhibited`. |
46
+ | `stack.logs` | Логирование операций стека, в т.ч. `PROHIBITED`; в `init` регистрирует хендлер `PROHIBIT_REPLACE` (пропускает флаг). |
47
47
 
48
48
  ## Близкие плагины
49
49