@vnejs/docs 0.2.64 → 0.2.66

package/plugins/core/scenario.md

@@ -1,73 +1,73 @@
 # plugins/core/scenario/
 
-Пакет: `@vnejs/plugins.core.scenario` · namespace: `SCENARIO`
+Package: `@vnejs/plugins.core.scenario` · namespace: `SCENARIO`
 
-Исполнение сценария `.vne`: метки, строки, exec handlers, продвижение `NEXT`.
+Runs a `.vne` scenario: labels, lines, exec handlers, `NEXT` advance.
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.core.scenario`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.core.scenario`.
 
-| Ключ            | Строка                       | Смысл                                                                                                          |
-| --------------- | ---------------------------- | -------------------------------------------------------------------------------------------------------------- |
-| `EXEC`          | `vne:scenario:exec`          | Выполнить строку сценария: dispatch по module/block с line, args и keywords.                                   |
-| `EXEC_DELAY`    | `vne:scenario:exec_delay`    | Отложить promise до завершения текущего exec (async-строки).                                                   |
-| `NEXT`          | `vne:scenario:next`          | Шаг вперёд по сценарию: выполнить текущую строку или завершить текущую метку.                                  |
-| `LABEL_GET`     | `vne:scenario:label_get`     | Предзагрузка строк метки на глубину `deep` с приоритетом. Упавшая строка не блокирует метку.                   |
-| `LINE_LOAD`     | `vne:scenario:line_load`     | Условная предзагрузка одной строки (с учётом depth в memory).                                                  |
-| `LINE_GET`      | `vne:scenario:line_get`      | Получить и подготовить одну строку сценария по label и index. Ошибка предзагрузки не оставляет промис висящим. |
-| `LINE_LOAD_REG` | `vne:scenario:line_load_reg` | Зарегистрировать обработчик предзагрузки строк для module/block.                                               |
-| `LINE_EXEC_REG` | `vne:scenario:line_exec_reg` | Зарегистрировать обработчик выполнения строк для module/block.                                                 |
-| `LINES_GET`     | `vne:scenario:lines_get`     | Получить массив строк метки (JSON с хоста, кэш в memory).                                                      |
+| Key             | String                       | Meaning                                                                                                 |
+| --------------- | ---------------------------- | ------------------------------------------------------------------------------------------------------- |
+| `EXEC`          | `vne:scenario:exec`          | Run a scenario line: dispatch by module/block with line, args, and keywords.                            |
+| `EXEC_DELAY`    | `vne:scenario:exec_delay`    | Defer a promise until the current exec finishes (async lines).                                          |
+| `NEXT`          | `vne:scenario:next`          | Step forward: run the current line or finish the current label.                                         |
+| `LABEL_GET`     | `vne:scenario:label_get`     | Preload label lines to depth `deep` with priority. One failed line does not block the label.            |
+| `LINE_LOAD`     | `vne:scenario:line_load`     | Conditional preload of one line (uses depth in memory).                                                 |
+| `LINE_GET`      | `vne:scenario:line_get`      | Get and prepare one scenario line by label and index. A preload error does not leave a hanging promise. |
+| `LINE_LOAD_REG` | `vne:scenario:line_load_reg` | Register a line preload handler for a module/block.                                                     |
+| `LINE_EXEC_REG` | `vne:scenario:line_exec_reg` | Register a line exec handler for a module/block.                                                        |
+| `LINES_GET`     | `vne:scenario:lines_get`     | Get an array of label lines (JSON from host, cache in memory).                                          |
 
-## Константы
+## Constants
 
-- **`OTHER_MODULE`** — `"other"`: fallback-модуль для строк без префикса.
-- **`LINE_KEYWORDS`** — ключевые слова строки сценария: `skip-if-possible`, `async`, `autonext`. Остальные keywords живут в доменных контрактах (`TEXT.extend`, `VARS.global`, `LAYER_ANIMATION.dangerous`, `QTE.qte-fallback`).
-- **`LINE_PREFIXES.MODULE`** — `"$"`: префикс вызова модуля.
-- **`LINE_PREFIXES.BLOCK`** — `"%"`: префикс блока сценария.
-- **`LOGS_ACTIONS`** — метки логов: `goto`, `goto_missing`, `exec start` / `exec end`, `reg`, `loaded start` / `loaded finish`, `load start` / `load end` / `load check` / `load finish`, `next emit start` / `next emit end`, `exec`.
+- **`OTHER_MODULE`** — `"other"`: fallback module for lines without a prefix.
+- **`LINE_KEYWORDS`** — scenario line keywords: `skip-if-possible`, `async`, `autonext`. Other keywords live in domain contracts (`TEXT.extend`, `VARS.global`, `LAYER_ANIMATION.dangerous`, `QTE.qte-fallback`).
+- **`LINE_PREFIXES.MODULE`** — `"$"`: module call prefix.
+- **`LINE_PREFIXES.BLOCK`** — `"%"`: scenario block prefix.
+- **`LOGS_ACTIONS`** — log labels: `goto`, `goto_missing`, `exec start` / `exec end`, `reg`, `loaded start` / `loaded finish`, `load start` / `load end` / `load check` / `load finish`, `next emit start` / `next emit end`, `exec`.
 
-## Параметры
+## Parameters
 
-| Ключ              | Тип      | Смысл                                       |
-| ----------------- | -------- | ------------------------------------------- |
-| `INIT_LABEL_NAME` | `string` | Имя стартовой метки; по умолчанию `"init"`. |
+| Key               | Type     | Meaning                             |
+| ----------------- | -------- | ----------------------------------- |
+| `INIT_LABEL_NAME` | `string` | Start label name; Default `"init"`. |
 
-## Настройки
+## Settings
 
-Нет.
+None.
 
 ## Shared
 
-| Поле                      | Тип       | Смысл                                                                                                                                                                                                                                                                 |
-| ------------------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `shouldAutostartScenario` | `boolean` | В `start` модуль `scenario.autostart` эмитит `LABEL_GET` (init) и `NEXT`, только если не `false`. В `postinject` ставится `true` через `??=`; другие плагины могут выставить `false`. `STATE.CLEAR` по-прежнему грузит init label в `scenario.label` без этого гейта. |
+| Field                     | Type      | Meaning                                                                                                                                                                                                                                                |
+| ------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `shouldAutostartScenario` | `boolean` | In `start`, module `scenario.autostart` emits `LABEL_GET` (init) and `NEXT` only when not `false`. In `postinject` set to `true` via `??=`; other plugins may set `false`. `STATE.CLEAR` still loads init label in `scenario.label` without this gate. |
 
-## Модули
+## Modules
 
-| Модуль               | Зона ответственности                                                                                                      |
-| -------------------- | ------------------------------------------------------------------------------------------------------------------------- |
-| `scenario`           | Главный цикл `NEXT`, exec строк, sync state. Handler `NEXT` читает `module` из `EmitParams` (`Module.emit`). |
-| `scenario.autostart` | Дефолт `shared.shouldAutostartScenario` в `postinject`; в `start` — init label + `emit SCENARIO.NEXT` при включённом флаге.         |
-| `scenario.exec`      | Dispatch `$module` / `%block`, registry handlers, `EXEC_DELAY`.                                                           |
-| `scenario.label`     | `LABEL_GET`, preload меток; `MEMORY.REG` в `setup`; init label на `STATE.CLEAR`. Одна упавшая строка не валит всю метку.  |
-| `scenario.line`      | `MEMORY.REG` в `setup`; `LINE_LOAD` / `LINE_GET`, registry preload handlers. Executor `LINE_GET` всегда resolve.          |
-| `scenario.lines`     | `MEMORY.REG` в `setup`; fetch `label/<path>.json` с `HOST` (например `label/prologue/1.json`).                            |
+| Module               | Role                                                                                                                              |
+| -------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
+| `scenario`           | Main `NEXT` loop, line exec, sync state. `NEXT` handler reads `module` from `EmitParams` (`Module.emit`).                         |
+| `scenario.autostart` | Default `shared.shouldAutostartScenario` in `postinject`; in `start` — init label + `emit SCENARIO.NEXT` when flag is on.         |
+| `scenario.exec`      | Dispatch `$module` / `%block`, handler registry, `EXEC_DELAY`.                                                                    |
+| `scenario.label`     | `LABEL_GET`, label preload; `MEMORY.REG` in `setup`; init label on `STATE.CLEAR`. One failed line does not break the whole label. |
+| `scenario.line`      | `MEMORY.REG` in `setup`; `LINE_LOAD` / `LINE_GET`, preload handler registry. `LINE_GET` executor always resolves.                 |
+| `scenario.lines`     | `MEMORY.REG` in `setup`; fetch `label/<path>.json` from `HOST` (e.g. `label/prologue/1.json`).                                    |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
 - [logs.md](./logs.md) — `LOGS`: `EVENTS.LOGS.EMIT` (`action`, …)
-- [media.md](./media.md) — `MEDIA`: `CONST.MEDIA.PRIORITIES` (preload строк и меток)
-- [memory.md](./memory.md) — `MEMORY`: `REG`, `GET`, `SET` (кэш строк и меток)
-- [platforms.md](./platforms.md) — `PLATFORMS`: `PARAMS.CURRENT_PLATFORM` (глубина preload метки)
-- [stack.md](./stack.md) — `STACK`: `POP` (конец метки)
-- [state.md](./state.md) — `STATE`: `SET`, `CLEAR` (sync / сброс позиции сценария)
+- [media.md](./media.md) — `MEDIA`: `CONST.MEDIA.PRIORITIES` (line and label preload)
+- [memory.md](./memory.md) — `MEMORY`: `REG`, `GET`, `SET` (line and label cache)
+- [platforms.md](./platforms.md) — `PLATFORMS`: `PARAMS.CURRENT_PLATFORM` (label preload depth)
+- [stack.md](./stack.md) — `STACK`: `POP` (end of label)
+- [state.md](./state.md) — `STATE`: `SET`, `CLEAR` (sync / reset scenario position)
 - [system.md](./system.md) — `SYSTEM`: `STARTED`; `CONST.SYSTEM.HOST` (fetch label JSON)
-- [vendors.md](./vendors.md) — `VENDORS`: `HASH` (hash текущей строки)
+- [vendors.md](./vendors.md) — `VENDORS`: `HASH` (current line hash)
 
-### Остальные
+### Other
 
-- [electron.md](../platform/electron.md) — `ELECTRON`: при reload выставляет `shared.shouldAutostartScenario = false`
+- [electron.md](../platform/electron.md) — `ELECTRON`: on reload sets `shared.shouldAutostartScenario = false`

package/plugins/core/settings.md

@@ -1,45 +1,45 @@
 # plugins/core/settings/
 
-Пакет: `@vnejs/plugins.core.settings` · namespace: `SETTINGS`
+Package: `@vnejs/plugins.core.settings` · namespace: `SETTINGS`
 
-Глобальные настройки игры в `shared.settings` с персистентностью через storage.
+Global game settings in `shared.settings` with persistence through storage.
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.core.settings`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.core.settings`.
 
-| Ключ      | Строка                | Смысл                                                                                                                 |
-| --------- | --------------------- | --------------------------------------------------------------------------------------------------------------------- |
-| `SET`     | `vne:settings:set`    | Установить значение настройки по `name`, сохранить в storage, emit `CHANGED`. Payload: `{ name?, value?, options? }`. |
-| `INIT`    | `vne:settings:init`   | Установить default, если значения нет или оно не из `options`; делегирует в `SET`.                                    |
-| `CHANGED` | `vne:settings:change` | Значение настройки изменилось: `{ name: string, value: unknown }`.                                                    |
+| Key       | String                | Meaning                                                                                           |
+| --------- | --------------------- | ------------------------------------------------------------------------------------------------- |
+| `SET`     | `vne:settings:set`    | Set a setting by `name`, save to storage, emit `CHANGED`. Payload: `{ name?, value?, options? }`. |
+| `INIT`    | `vne:settings:init`   | Set default when value is missing or not in `options`; delegates to `SET`.                        |
+| `CHANGED` | `vne:settings:change` | Setting value changed: `{ name: string, value: unknown }`.                                        |
 
-## Константы
+## Constants
 
-- **`LOGS_ACTIONS`** — метки: `set`, `init`, `changed`.
+- **`LOGS_ACTIONS`** — labels: `set`, `init`, `changed`.
 
-## Параметры
+## Parameters
 
-Нет.
+None.
 
-## Настройки
+## Settings
 
-Нет.
+None.
 
-## Модули
+## Modules
 
-| Модуль          | Зона ответственности                                                                 |
-| --------------- | ------------------------------------------------------------------------------------ |
-| `settings`      | Load из storage при `setup` (`ensureReady`); `SET` / `INIT` тоже ждут `ensureReady`. |
-| `settings.logs` | Логирование set/init/changed.                                                        |
+| Module          | Role                                                                                  |
+| --------------- | ------------------------------------------------------------------------------------- |
+| `settings`      | Load from storage in `setup` (`ensureReady`); `SET` / `INIT` also wait `ensureReady`. |
+| `settings.logs` | Log set/init/changed.                                                                 |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
 - [logs.md](./logs.md) — `LOGS`: `EVENTS.LOGS.EMIT` (`action`, …), `CONST.LOGS.FILTER_FROM_RESULT_OPTIONS`
-- [storage.md](./storage.md) — `STORAGE`: `GET_ALL`, `SET` (персистентность настроек)
+- [storage.md](./storage.md) — `STORAGE`: `GET_ALL`, `SET` (settings persistence)
 
-### Остальные
+### Other
 
-— нет
+— None

package/plugins/core/stack.md

@@ -1,62 +1,62 @@
 # plugins/core/stack/
 
-Пакет: `@vnejs/plugins.core.stack` · namespace: `STACK`
+Package: `@vnejs/plugins.core.stack` · namespace: `STACK`
 
-Стек вызовов меток сценария: jump, call, pop, аргументы call-frame.
+Scenario label call stack: jump, call, pop, call-frame args.
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.core.stack`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.core.stack`.
 
-| Ключ                   | Строка                           | Смысл                                                                                                                                                                                                                            |
-| ---------------------- | -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `EMIT`                 | `vne:stack:emit`                 | Перейти на метку: сброс `curLine`, clone args, preload label, **await** `MEMORY.CLEAR` (до возврата из `EMIT`). Payload: `{ label?, args? }`. Перед переходом — `PROHIBIT_REPLACE`; при запрете — `PROHIBITED`, без `LABEL_GET`. |
-| `POP`                  | `vne:stack:pop`                  | Вернуться к предыдущей позиции в стеке или сбросить игру, если стек пуст.                                                                                                                                                        |
-| `CLEAR`                | `vne:stack:clear`                | Сбросить глобальный state и продолжить сценарий.                                                                                                                                                                                 |
-| `JUMP`                 | `vne:stack:jump`                 | Переход на метку без push в стек (делегирует в `EMIT`).                                                                                                                                                                          |
-| `CALL`                 | `vne:stack:call`                 | `PROHIBIT_REPLACE`, затем push текущей позиции и `EMIT`. При запрете — `PROHIBITED`, без push.                                                                                                                                   |
-| `EXEC_ARG`             | `vne:stack:exec_arg`             | По токену строки вернуть значение аргумента из верхнего frame. Payload: `{ line? }`.                                                                                                                                             |
-| `PROHIBIT_REPLACE`     | `vne:stack:prohibit_replace`     | Цепочка `ModuleReplace`: можно ли идти на `label`. Payload: `{ label?, isProhibited? }`. Старт `isProhibited: false`. Возврат — итоговое `isProhibited`.                                                                         |
-| `PROHIBIT_REPLACE_REG` | `vne:stack:prohibit_replace_reg` | Зарегистрировать обработчик `PROHIBIT_REPLACE`. `{ handler, priority? }`. Не блокирующий хендлер: `return isProhibited`; запрет: `return isProhibited \|\| ownCheck`.                                                            |
-| `PROHIBITED`           | `vne:stack:prohibited`           | Переход запрещён. Payload: `{ label?, args?, event? }` — `event` это `JUMP` / `CALL` / `EMIT`, чтобы повторить переход. `$ stack jump/call` при запрете не делает `emit SCENARIO.NEXT`.                                          |
+| Key                    | String                           | Meaning                                                                                                                                                                                                                      |
+| ---------------------- | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `EMIT`                 | `vne:stack:emit`                 | Go to a label: reset `curLine`, clone args, preload label, **await** `MEMORY.CLEAR` (before `EMIT` returns). Payload: `{ label?, args? }`. Before jump — `PROHIBIT_REPLACE`; when prohibited — `PROHIBITED`, no `LABEL_GET`. |
+| `POP`                  | `vne:stack:pop`                  | Return to the previous stack position or reset the game when the stack is empty.                                                                                                                                             |
+| `CLEAR`                | `vne:stack:clear`                | Clear global state and continue the scenario.                                                                                                                                                                                |
+| `JUMP`                 | `vne:stack:jump`                 | Jump to a label without pushing the stack (delegates to `EMIT`).                                                                                                                                                             |
+| `CALL`                 | `vne:stack:call`                 | `PROHIBIT_REPLACE`, then push current position and `EMIT`. When prohibited — `PROHIBITED`, no push.                                                                                                                          |
+| `EXEC_ARG`             | `vne:stack:exec_arg`             | From a line token, return an argument value from the top frame. Payload: `{ line? }`.                                                                                                                                        |
+| `PROHIBIT_REPLACE`     | `vne:stack:prohibit_replace`     | `ModuleReplace` chain: may we go to `label`. Payload: `{ label?, isProhibited? }`. Start `isProhibited: false`. Returns final `isProhibited`.                                                                                |
+| `PROHIBIT_REPLACE_REG` | `vne:stack:prohibit_replace_reg` | Register a `PROHIBIT_REPLACE` handler. `{ handler, priority? }`. Non-blocking handler: `return isProhibited`; prohibit: `return isProhibited \|\| ownCheck`.                                                                 |
+| `PROHIBITED`           | `vne:stack:prohibited`           | Jump forbidden. Payload: `{ label?, args?, event? }` — `event` is `JUMP` / `CALL` / `EMIT` to retry the jump. On prohibit, `$ stack jump/call` does not `emit SCENARIO.NEXT`.                                                |
 
-## Константы
+## Constants
 
 - **`LOGS_ACTIONS`** — `emit`, `call`, `jump`, `pop`, `clear`, `prohibited`.
-- **`EXEC_ACTIONS`** — действия в строках `$stack`: `jump`, `call`, `pop`.
+- **`EXEC_ACTIONS`** — actions in `$stack` lines: `jump`, `call`, `pop`.
 
-## Параметры
+## Parameters
 
-Нет.
+None.
 
-## Настройки
+## Settings
 
-Нет.
+None.
 
-## Модули
+## Modules
 
-| Модуль          | Зона ответственности                                                                                                                                                                                                                        |
-| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `stack`         | State стека; обработка `EMIT` (`PROHIBIT_REPLACE` → переход или `PROHIBITED`); sync на `STATE.SET` / `CLEAR`.                                                                                                                               |
-| `stack.call`    | `PROHIBIT_REPLACE`, затем push frame + `EMIT`.                                                                                                                                                                                              |
-| `stack.jump`    | Jump без сохранения.                                                                                                                                                                                                                        |
-| `stack.pop`     | Pop frame.                                                                                                                                                                                                                                  |
-| `stack.clear`   | Clear state + next.                                                                                                                                                                                                                         |
-| `stack.args`    | Резолв аргументов из строки сценария.                                                                                                                                                                                                       |
-| `stack.exec`    | Регистрация `$stack` handlers в scenario (jump/call/pop + preload). На `LINE_LOAD` jump/call — `PROHIBIT_REPLACE` до `LABEL_GET`. `onLineExec`: `emit SCENARIO.NEXT` только если jump/call не вернули `false` (запрет); `pop` — как раньше. |
-| `stack.replace` | Реестр обработчиков `PROHIBIT_REPLACE_REG`; наследник `@vnejs/module.replace`; `REPLACE_KEY` — `isProhibited`.                                                                                                                              |
-| `stack.logs`    | Логирование операций стека, в т.ч. `PROHIBITED`; в `init` регистрирует хендлер `PROHIBIT_REPLACE` (пропускает флаг).                                                                                                                        |
+| Module          | Role                                                                                                                                                                                                                                             |
+| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `stack`         | Stack state; handle `EMIT` (`PROHIBIT_REPLACE` → jump or `PROHIBITED`); sync on `STATE.SET` / `CLEAR`.                                                                                                                                           |
+| `stack.call`    | `PROHIBIT_REPLACE`, then push frame + `EMIT`.                                                                                                                                                                                                    |
+| `stack.jump`    | Jump without push on the stack.                                                                                                                                                                                                                  |
+| `stack.pop`     | Pop frame.                                                                                                                                                                                                                                       |
+| `stack.clear`   | Clear state + next.                                                                                                                                                                                                                              |
+| `stack.args`    | Resolve arguments from a scenario line.                                                                                                                                                                                                          |
+| `stack.exec`    | Register `$stack` handlers in scenario (jump/call/pop + preload). On `LINE_LOAD` jump/call — `PROHIBIT_REPLACE` before `LABEL_GET`. `onLineExec`: `emit SCENARIO.NEXT` only when jump/call did not return `false` (prohibit); `pop` — unchanged. |
+| `stack.replace` | Registry for `PROHIBIT_REPLACE_REG` handlers; extends `@vnejs/module.replace`; `REPLACE_KEY` — `isProhibited`.                                                                                                                                   |
+| `stack.logs`    | Log stack ops including `PROHIBITED`; in `init` registers `PROHIBIT_REPLACE` handler (passes flag through).                                                                                                                                      |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
 - [logs.md](./logs.md) — `LOGS`: `EVENTS.LOGS.EMIT` (`action`, …), `CONST.LOGS.FILTER_FROM_RESULT_OPTIONS`
-- [media.md](./media.md) — `MEDIA`: `CONST.MEDIA.PRIORITIES` (preload при jump/call)
-- [memory.md](./memory.md) — `MEMORY`: `CLEAR` (при `EMIT`)
+- [media.md](./media.md) — `MEDIA`: `CONST.MEDIA.PRIORITIES` (preload on jump/call)
+- [memory.md](./memory.md) — `MEMORY`: `CLEAR` (on `EMIT`)
 - [scenario.md](./scenario.md) — `SCENARIO`: `LABEL_GET`, `LINE_EXEC_REG`, `LINE_LOAD_REG`; `emit SCENARIO.NEXT`
-- [state.md](./state.md) — `STATE`: `SET`, `CLEAR` (sync стека; `CLEAR` из `stack.clear`)
+- [state.md](./state.md) — `STATE`: `SET`, `CLEAR` (stack sync; `CLEAR` from `stack.clear`)
 
-### Остальные
+### Other
 
-— нет
+— None

package/plugins/core/state.md

@@ -1,52 +1,52 @@
 # plugins/core/state/
 
-Пакет: `@vnejs/plugins.core.state` · namespace: `STATE`
+Package: `@vnejs/plugins.core.state` · namespace: `STATE`
 
-Сериализация и восстановление глобального state игры, миграция сохранений.
+Serialize and restore global game state, migrate saves.
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.core.state`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.core.state`.
 
-| Ключ          | Строка                  | Смысл                                                                                    |
-| ------------- | ----------------------- | ---------------------------------------------------------------------------------------- |
-| `GET`         | `vne:state:get`         | Снять snapshot `globalState` (clone, пустые slice модулей отфильтровываются).            |
-| `SET`         | `vne:state:set`         | Применить полный snapshot globalState — восстановление состояния всех модулей.           |
-| `LOAD`        | `vne:state:load`        | Загрузить сохранение: clone → предобработка → применение state → preload метки сценария. |
-| `CLEAR`       | `vne:state:clear`       | Сбросить локальный state модулей к значениям по умолчанию.                               |
-| `PRELOAD`     | `vne:state:preload`     | Предобработка state перед применением (нормализация, подготовка к миграции).             |
-| `MIGRATE`     | `vne:state:migrate`     | Привести сохранение к текущей версии: проверка version/hash строки, цепочка миграций.    |
-| `MIGRATE_REG` | `vne:state:migrate_reg` | Зарегистрировать функцию миграции для пары versionMajor / versionMinor.                  |
+| Key           | String                  | Meaning                                                                      |
+| ------------- | ----------------------- | ---------------------------------------------------------------------------- |
+| `GET`         | `vne:state:get`         | Snapshot `globalState` (clone; empty module slices filtered out).            |
+| `SET`         | `vne:state:set`         | Apply full `globalState` snapshot — restore all module state.                |
+| `LOAD`        | `vne:state:load`        | Load a save: clone → preprocess → apply state → preload scenario label.      |
+| `CLEAR`       | `vne:state:clear`       | Reset module local state to defaults.                                        |
+| `PRELOAD`     | `vne:state:preload`     | Preprocess state before apply (normalize, prep for migration).               |
+| `MIGRATE`     | `vne:state:migrate`     | Bring save to current version: check version/line hash, run migration chain. |
+| `MIGRATE_REG` | `vne:state:migrate_reg` | Register a migration function for a versionMajor / versionMinor pair.        |
 
-## Константы
+## Constants
 
 - **`LOGS_ACTIONS`** — `get`, `load`, `clear`, `migrate`.
-- **`MIGRATE_STATUS`** — коды результата: `OK`, `LINE_NOT_FOUND`, `LABEL_NOT_FOUND`, `MAJOR_VERSION_MISMATCH`, `MINOR_VERSION_MISMATCH`.
+- **`MIGRATE_STATUS`** — result codes: `OK`, `LINE_NOT_FOUND`, `LABEL_NOT_FOUND`, `MAJOR_VERSION_MISMATCH`, `MINOR_VERSION_MISMATCH`.
 
-## Параметры
+## Parameters
 
-Нет.
+None.
 
-## Настройки
+## Settings
 
-Нет.
+None.
 
-## Модули
+## Modules
 
-| Модуль          | Зона ответственности                                   |
-| --------------- | ------------------------------------------------------ |
-| `state`         | `GET` / `LOAD` — serialize/hydrate globalState.        |
-| `state.migrate` | Версионная миграция сохранений по hash строк сценария. |
-| `state.logs`    | Логирование get/load/clear.                            |
+| Module          | Role                                            |
+| --------------- | ----------------------------------------------- |
+| `state`         | `GET` / `LOAD` — serialize/hydrate globalState. |
+| `state.migrate` | Versioned save migration by scenario line hash. |
+| `state.logs`    | Log get/load/clear.                             |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
 - [logs.md](./logs.md) — `LOGS`: `EVENTS.LOGS.EMIT` (`action`, …), `CONST.LOGS.FILTER_FROM_RESULT_OPTIONS`
-- [scenario.md](./scenario.md) — `SCENARIO`: `LINES_GET`, `LABEL_GET` (миграция по hash строки)
-- [system.md](./system.md) — `SYSTEM`: `CONST.SYSTEM.VERSION_MAJOR` / `VERSION_MINOR` (проверка версии save)
+- [scenario.md](./scenario.md) — `SCENARIO`: `LINES_GET`, `LABEL_GET` (migration by line hash)
+- [system.md](./system.md) — `SYSTEM`: `CONST.SYSTEM.VERSION_MAJOR` / `VERSION_MINOR` (save version check)
 
-### Остальные
+### Other
 
-— нет
+— None

package/plugins/core/storage.md

@@ -1,91 +1,91 @@
 # plugins/core/storage/
 
-Пакет: `@vnejs/plugins.core.storage` · namespace: `STORAGE`
+Package: `@vnejs/plugins.core.storage` · namespace: `STORAGE`
 
-Персистентное key-value хранилище на IndexedDB (localforage) с namespace по модулю и группой.
+Persistent key-value store on IndexedDB (localforage) with per-module namespace and group.
 
-## Формат ключа
+## Key format
 
-Физический ключ всегда трёхчастный: `{module}/{group}/{key}`.
+The physical key is always three parts: `{module}/{group}/{key}`.
 
-- Если `group` не передан — подставляется `_` (default group).
-- `key` может содержать `:` (например settings `vne:volume:common`).
-- `module` может содержать `.` (например `vars.global`, `fastforward.storage`).
+- When `group` is omitted — `_` is used (default group).
+- `key` may contain `:` (for example settings `vne:volume:common`).
+- `module` may contain `.` (for example `vars.global`, `fastforward.storage`).
 
-Примеры:
+Examples:
 
-| Вызов                                                            | Физический ключ                  |
+| Call                                                             | Physical key                     |
 | ---------------------------------------------------------------- | -------------------------------- |
 | `{ module: "settings", key: "vne:volume:common" }`               | `settings/_/vne:volume:common`   |
 | `{ module: "save", group: "0", key: "3" }`                       | `save/0/3`                       |
 | `{ module: "fastforward.storage", group: "intro", key: "hash" }` | `fastforward.storage/intro/hash` |
 
-## Диск (desktop / Steam)
+## Disk (desktop / Steam)
 
-| Group            | Файл                    |
-| ---------------- | ----------------------- |
-| `_` или не задан | `{module}.json`         |
-| любая другая     | `{module}/{group}.json` |
+| Group          | File                    |
+| -------------- | ----------------------- |
+| `_` or omitted | `{module}.json`         |
+| any other      | `{module}/{group}.json` |
 
-Примеры: `settings.json`, `save/0.json`, `save/autosave.json`, `fastforward.storage/intro.json`.
+Examples: `settings.json`, `save/0.json`, `save/autosave.json`, `fastforward.storage/intro.json`.
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.core.storage`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.core.storage`.
 
-| Ключ      | Строка                | Смысл                                                                                |
-| --------- | --------------------- | ------------------------------------------------------------------------------------ |
-| `SET`     | `vne:storage:set`     | Записать ключ (`module`, опционально `group`, `key`); emit `CHANGED`.                |
-| `SET_ALL` | `vne:storage:set_all` | Merge/replace всех ключей (плоские физические ключи); возвращает, были ли изменения. |
-| `GET`     | `vne:storage:get`     | Прочитать один ключ (`module`, опционально `group`, `key`).                          |
-| `GET_ALL` | `vne:storage:get_all` | Ключи модуля; с `group` — только группа.                                             |
-| `RM`      | `vne:storage:rm`      | Удалить один ключ.                                                                   |
-| `RM_ALL`  | `vne:storage:rm_all`  | Удалить ключи модуля; с `group` — только группа.                                     |
-| `KEYS`    | `vne:storage:keys`    | Список всех физических ключей в store.                                               |
-| `INIT`    | `vne:storage:init`    | Инициализация IndexedDB driver, ожидание ready (`ensureReady`, не `isReady`).        |
-| `CHANGED` | `vne:storage:changed` | В хранилище произошла запись, обновление или удаление.                               |
-| `IMPORT`  | `vne:storage:import`  | Заменить всё содержимое store данными из JSON-файла и перезагрузить страницу.        |
-| `EXPORT`  | `vne:storage:export`  | Скачать всё хранилище как JSON.                                                      |
-| `CLEAR`   | `vne:storage:clear`   | Полностью очистить store и перезагрузить страницу.                                   |
+| Key       | String                | Meaning                                                                        |
+| --------- | --------------------- | ------------------------------------------------------------------------------ |
+| `SET`     | `vne:storage:set`     | Write a key (`module`, optional `group`, `key`); emit `CHANGED`.               |
+| `SET_ALL` | `vne:storage:set_all` | Merge/replace all keys (flat physical keys); returns whether anything changed. |
+| `GET`     | `vne:storage:get`     | Read one key (`module`, optional `group`, `key`).                              |
+| `GET_ALL` | `vne:storage:get_all` | Keys for a module; with `group` — that group only.                             |
+| `RM`      | `vne:storage:rm`      | Remove one key.                                                                |
+| `RM_ALL`  | `vne:storage:rm_all`  | Remove module keys; with `group` — that group only.                            |
+| `KEYS`    | `vne:storage:keys`    | List all physical keys in the store.                                           |
+| `INIT`    | `vne:storage:init`    | Initialize IndexedDB driver, wait for ready (`ensureReady`, not `isReady`).    |
+| `CHANGED` | `vne:storage:changed` | A write, update, or delete happened in the store.                              |
+| `IMPORT`  | `vne:storage:import`  | Replace entire store contents from a JSON file and reload the page.            |
+| `EXPORT`  | `vne:storage:export`  | Download the whole store as JSON.                                              |
+| `CLEAR`   | `vne:storage:clear`   | Clear the store completely and reload the page.                                |
 
-### `GET_ALL` и имена ключей в ответе
+### `GET_ALL` and key names in the response
 
-- `GET_ALL({ module, group })` — в ответе «голые» `key`.
-- `GET_ALL({ module })` без group:
-  - для default-группы `_` — тоже «голые» `key` (префикс `_/` снимается);
-  - для остальных групп — `group/key` (чтобы не смешивать одинаковые key из разных групп).
+- `GET_ALL({ module, group })` — response uses bare `key` values.
+- `GET_ALL({ module })` without group:
+  - for default group `_` — bare `key` too (`_/` prefix stripped);
+  - for other groups — `group/key` (so identical keys in different groups do not collide).
 
-## Константы
+## Constants
 
-- **`LOGS_ACTIONS.CHANGED`** — `"changed"`: метка лога при `CHANGED`.
+- **`LOGS_ACTIONS.CHANGED`** — `"changed"`: log label on `CHANGED`.
 
-## Параметры
+## Parameters
 
-| Ключ       | Тип      | Смысл                                                        |
-| ---------- | -------- | ------------------------------------------------------------ |
-| `GAMENAME` | `string` | Префикс имени IndexedDB store; по умолчанию `"vne-default"`. |
+| Key        | Type     | Meaning                                               |
+| ---------- | -------- | ----------------------------------------------------- |
+| `GAMENAME` | `string` | IndexedDB store name prefix; Default `"vne-default"`. |
 
-## Настройки
+## Settings
 
-Нет.
+None.
 
-## Модули
+## Modules
 
-| Модуль            | Зона ответственности                                              |
-| ----------------- | ----------------------------------------------------------------- |
-| `storage`         | localforage в `setup` / `ensureReady`; `KEYS`, `CHANGED`, `INIT`. |
-| `storage.get`     | `GET` / `GET_ALL`.                                                |
-| `storage.set`     | `SET` / `SET_ALL`.                                                |
-| `storage.rm`      | `RM` / `RM_ALL`.                                                  |
-| `storage.actions` | Import / export / clear с file picker и reload.                   |
+| Module            | Role                                                               |
+| ----------------- | ------------------------------------------------------------------ |
+| `storage`         | localforage in `setup` / `ensureReady`; `KEYS`, `CHANGED`, `INIT`. |
+| `storage.get`     | `GET` / `GET_ALL`.                                                 |
+| `storage.set`     | `SET` / `SET_ALL`.                                                 |
+| `storage.rm`      | `RM` / `RM_ALL`.                                                   |
+| `storage.actions` | Import / export / clear with file picker and reload.               |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
-- [logs.md](./logs.md) — `LOGS`: `EVENTS.LOGS.EMIT` (`action`, …) (событие `CHANGED`)
+- [logs.md](./logs.md) — `LOGS`: `EVENTS.LOGS.EMIT` (`action`, …) (`CHANGED` event)
 - [system.md](./system.md) — `SYSTEM`: `CONST.SYSTEM.VERSION_MAJOR`; `FILE_LOAD`, `FILE_READ`, `RELOAD` (import/export/clear)
 
-### Остальные
+### Other
 
-— нет
+— None