@vnejs/docs 0.2.1

package/plugins/core/components.md

@@ -0,0 +1,47 @@
+# plugins/core/components/
+
+Пакет: `@vnejs/plugins.core.components` · namespace: `COMPONENTS`
+
+React/DOM-контейнер для монтирования view-компонентов и цепочка inject-обработчиков.
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `RENDER` | `vne:components:render` | Запрос на отрисовку: создаётся дочерний контейнер, вызывается переданная `renderFunc`; завершение — когда компонент вызовет `onMount`. |
+| `INJECT` | `vne:components:inject` | Прогон значения через все зарегистрированные inject-обработчики по очереди; возвращает массив результатов. |
+| `INJECT_REG` | `vne:components:inject_reg` | Регистрация нового inject-обработчика в цепочку. |
+| `EXTERNAL_UPDATE` | `vne:components:external_update` | Запрос на принудительное обновление отображения UI без полного re-render. |
+
+## Константы
+
+- **`LOGS_ACTIONS.RENDER`** — `"render"`: метка действия для логов при рендере.
+
+## Параметры
+
+Нет.
+
+## Настройки
+
+Нет.
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `components.render` | Создаёт `#components` в DOM; обрабатывает `RENDER`; инициализирует `shared.viewForceAnimationSources`. |
+| `components.inject` | Регистрация и последовательный вызов inject-обработчиков на `INJECT` / `INJECT_REG`. |
+| `components.logs` | Логирование `RENDER` (результат фильтруется из ответа emit). |
+
+## Близкие плагины
+
+Плагины, чьи события, константы, параметры или настройки используются в коде `@vnejs/plugins.core.components`.
+
+### plugins/core/
+
+- [logs.md](./logs.md) — `LOGS`: `emitLog`, `CONST.LOGS.FILTER_FROM_RESULT_OPTIONS`
+- [system.md](./system.md) — `SYSTEM`: `CONST.SYSTEM.DOM_IDS` (`APP`, `COMPONENTS`)
+
+### Остальные
+
+— нет

package/plugins/core/interact.md

@@ -0,0 +1,45 @@
+# plugins/core/interact/
+
+Пакет: `@vnejs/plugins.core.interact` · namespace: `INTERACT`
+
+Очередь пользовательских обработчиков взаимодействия (клик «продолжить», ожидание ввода и т.п.) с ключами push/pop.
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `EMIT` | `vne:interact:emit` | Запуск цикла взаимодействия: если не занят — `STARTED`, параллельный вызов всех handlers, затем `ENDED`. |
+| `PUSH` | `vne:interact:push` | Зарегистрировать handler под ключом. Payload: `{ key?, handler? }`. |
+| `POP` | `vne:interact:pop` | Снять handler по ключу. Payload: `{ key? }`. |
+| `PUSH_POP` | `vne:interact:push_pop` | Временно подменить handler (`skipHandler`), выполнить `handler`, затем pop по `key`. |
+| `STARTED` | `vne:interact:started` | Начало цикла взаимодействия — перед параллельным вызовом handlers. |
+| `ENDED` | `vne:interact:ended` | Завершение цикла взаимодействия — после выполнения всех handlers. |
+
+## Константы
+
+- **`LOGS_ACTIONS`** — метки для логов: `EMIT`, `PUSH`, `POP`, `PUSH_POP`, `STARTED`, `ENDED`.
+
+## Параметры
+
+Нет.
+
+## Настройки
+
+Нет.
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `interact` | Хранит стек handlers; реализует `EMIT`, `PUSH`, `POP`, `PUSH_POP`. |
+| `interact.logs` | Логирование всех событий interact. |
+
+## Близкие плагины
+
+### plugins/core/
+
+- [logs.md](./logs.md) — `LOGS`: `emitLog`, `CONST.LOGS.FILTER_FROM_RESULT_OPTIONS`
+
+### Остальные
+
+— нет

package/plugins/core/logs.md

@@ -0,0 +1,46 @@
+# plugins/core/logs/
+
+Пакет: `@vnejs/plugins.core.logs` · namespace: `LOGS`
+
+Централизованное логирование в `window.VneLogs` и опционально в консоль.
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `EMIT` | `vne:logs:emit` | Поставить запись в очередь логов (если логирование включено); затем сформировать `PUSH` с uid и timestamp. |
+| `PUSH` | `vne:logs:push` | Записать строку в `window.VneLogs` и при необходимости вывести в консоль. |
+| `LOAD` | `vne:logs:load` | Скачать накопленные логи как JSON-файл через `SYSTEM.FILE_LOAD`. |
+| `CLEAR` | `vne:logs:clear` | Очистить `window.VneLogs`. |
+
+## Константы
+
+- **`FILTER_FROM_RESULT_OPTIONS`** — `{ filterFromResult: true }`: при emit результат обработчика не включается в массив ответов.
+
+## Параметры
+
+Нет.
+
+## Настройки
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `ENABLED` (`vne:logs:enabled`) | `boolean` | Включено ли логирование; инициализируется при старте модуля. |
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `logs` | Очередь логов, `EMIT`/`PUSH`/`LOAD`/`CLEAR`; регистрация настройки `ENABLED`. |
+
+## Близкие плагины
+
+### plugins/core/
+
+- [settings.md](./settings.md) — `SETTINGS`: `INIT`; `SETTINGS.LOGS.ENABLED`
+- [system.md](./system.md) — `SYSTEM`: `FILE_LOAD` (скачивание логов)
+- [vendors.md](./vendors.md) — `VENDORS`: `UID`, `CLONE` (`emitClone` для записи лога)
+
+### Остальные
+
+— нет

package/plugins/core/media.md

@@ -0,0 +1,59 @@
+# plugins/core/media/
+
+Пакет: `@vnejs/plugins.core.media` · namespace: `MEDIA`
+
+Загрузка, обработка и кэширование медиа (image/audio/video) с ограничением параллелизма.
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `GET` | `vne:media:get` | Получить готовый медиа-элемент: из кэша или через цепочку load. |
+| `SET` | `vne:media:set` | Положить готовый DOM-элемент в memory-подсистему media. |
+| `LOAD` | `vne:media:load` | Запуск загрузки по id/type/name с учётом semaphore и dedup через `LOAD_CHECK`. |
+| `LOAD_CHECK` | `vne:media:load_check` | Проверить: уже в памяти, в процессе process или load. |
+| `LOAD_START` | `vne:media:load_start` | Начало загрузки asset (маркер lifecycle). |
+| `LOAD_END` | `vne:media:load_end` | Окончание загрузки asset (маркер lifecycle). |
+| `ERROR_NO_SRC` | `vne:media:error_no_src` | В манифесте нет src для запрошенного asset. |
+| `ERROR_FETCH` | `vne:media:error_fetch` | Ошибка fetch при загрузке blob. |
+| `PROCESS` | `vne:media:process` | Скачать blob, создать `<img>` / `<audio>` / `<video>`, вызвать `SET`. |
+| `PROCESS_CHECK` | `vne:media:process_check` | Есть ли уже promise/результат process для `mediaId`. |
+| `MEMORY_GET` | `vne:media:memory_get` | Прокси к `MEMORY.GET` для namespace media. |
+| `MEMORY_SET` | `vne:media:memory_set` | Прокси к `MEMORY.SET` для namespace media. |
+
+## Константы
+
+- **`TYPES`** — `"image"` | `"audio"` | `"video"`.
+- **`PRIORITIES`** — числовые приоритеты очереди: `HIGH` (0), `MEDIUM` (1), `LOW` (2), `BACKGROUND` (3).
+- **`LOGS_ACTIONS`** — метки для логов: get, set, load, load_start, load_end, error_no_src, error_fetch.
+
+## Параметры
+
+Нет.
+
+## Настройки
+
+Нет.
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `media.load` | Semaphore-gated load, dedup, делегирование в process/memory. |
+| `media.process` | Fetch blob и создание DOM-медиа. |
+| `media.memory` | REG в memory, монтирование элементов в скрытый `#media`. |
+| `media` | Высокоуровневый get/set. |
+| `media.logs` | Логирование lifecycle media. |
+
+## Близкие плагины
+
+### plugins/core/
+
+- [logs.md](./logs.md) — `LOGS`: `emitLog`, `CONST.LOGS.FILTER_FROM_RESULT_OPTIONS`
+- [memory.md](./memory.md) — `MEMORY`: `REG`, `GET`, `SET` (через `MEMORY_GET` / `MEMORY_SET`)
+- [platforms.md](./platforms.md) — `PLATFORMS`: `CONST`, `PARAMS.CURRENT_PLATFORM` (лимит semaphore, mediaNoTimeout)
+- [system.md](./system.md) — `SYSTEM`: `CONST.SYSTEM.HOST`, `DOM_IDS.MEDIA`
+
+### Остальные
+
+— нет

package/plugins/core/memory.md

@@ -0,0 +1,44 @@
+# plugins/core/memory/
+
+Пакет: `@vnejs/plugins.core.memory` · namespace: `MEMORY`
+
+In-memory кэш с reference counting по namespace модуля; используется media, scenario и др.
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `GET` | `vne:memory:get` | Получить значение по `module` + `key`; сбросить счётчик ссылок до `initCounter`. |
+| `SET` | `vne:memory:set` | Сохранить значение; при первой записи вызвать `onAdd` зарегистрированного namespace. |
+| `REG` | `vne:memory:reg` | Зарегистрировать namespace с `initCounter`, хуками `onAdd` / `onClear`. |
+| `KEYS` | `vne:memory:keys` | Список ключей в namespace. |
+| `CLEAR` | `vne:memory:clear` | Уменьшить счётчики, удалить записи с нулевым счётчиком, вызвать `onClear`, затем `CLEARED`. |
+| `CLEARED` | `vne:memory:cleared` | In-memory кэш полностью очищен. |
+
+## Константы
+
+Нет.
+
+## Параметры
+
+Нет.
+
+## Настройки
+
+Нет.
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `memory` | Единый модуль: reg/get/set/keys/clear и reference counting. |
+
+## Близкие плагины
+
+### plugins/core/
+
+— нет
+
+### Остальные
+
+— нет

package/plugins/core/platforms.md

@@ -0,0 +1,48 @@
+# plugins/core/platforms/
+
+Пакет: `@vnejs/plugins.core.platforms` · namespace: `PLATFORMS`
+
+Статическая регистрация платформенных констант и текущей платформы (без модулей и событий).
+
+## События
+
+Нет.
+
+## Константы
+
+Идентификаторы платформ (строки):
+
+| Ключ | Значение |
+|------|----------|
+| `WEB` | `"web"` |
+| `MOBILE` | `"mobile"` |
+| `IOS` | `"ios"` |
+| `ANDROID` | `"android"` |
+| `ELECTRON` | `"electron"` |
+| `MACOS` | `"macos"` |
+| `LINUX` | `"linux"` |
+| `WINDOWS` | `"windows"` |
+
+## Параметры
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `CURRENT_PLATFORM` | `Platform` (одно из значений `CONSTANTS`) | Текущая платформа; по умолчанию `WEB`. |
+
+## Настройки
+
+Нет.
+
+## Модули
+
+Нет.
+
+## Близкие плагины
+
+### plugins/core/
+
+— нет
+
+### Остальные
+
+— нет

package/plugins/core/scenario.md

@@ -0,0 +1,63 @@
+# plugins/core/scenario/
+
+Пакет: `@vnejs/plugins.core.scenario` · namespace: `SCENARIO`
+
+Исполнение сценария `.vne`: метки, строки, exec handlers, продвижение `NEXT`.
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `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). |
+
+## Константы
+
+- **`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`** — `"%"`: префикс блока сценария.
+
+## Параметры
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `INIT_LABEL_NAME` | `string` | Имя стартовой метки; по умолчанию `"init"`. |
+
+## Настройки
+
+Нет.
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `scenario` | Главный цикл `NEXT`, exec строк, sync state, старт на `SYSTEM.STARTED`. |
+| `scenario.exec` | Dispatch `$module` / `%block`, registry handlers, `EXEC_DELAY`. |
+| `scenario.label` | `LABEL_GET`, preload меток, init label на старте/clear. |
+| `scenario.line` | `LINE_LOAD` / `LINE_GET`, registry preload handlers. |
+| `scenario.lines` | Fetch `label.*.json` с `HOST`. |
+
+## Близкие плагины
+
+### plugins/core/
+
+- [logs.md](./logs.md) — `LOGS`: `emitLog`
+- [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 / сброс позиции сценария)
+- [system.md](./system.md) — `SYSTEM`: `STARTED`; `CONST.SYSTEM.HOST` (fetch label JSON)
+- [vendors.md](./vendors.md) — `VENDORS`: `HASH` (hash текущей строки)
+
+### Остальные
+
+— нет

package/plugins/core/settings.md

@@ -0,0 +1,43 @@
+# plugins/core/settings/
+
+Пакет: `@vnejs/plugins.core.settings` · namespace: `SETTINGS`
+
+Глобальные настройки игры в `shared.settings` с персистентностью через storage.
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `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 }`. |
+
+## Константы
+
+- **`LOGS_ACTIONS`** — метки: `set`, `init`, `changed`.
+
+## Параметры
+
+Нет.
+
+## Настройки
+
+Нет.
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `settings` | Load из storage при init; `SET` / `INIT`; запись в `shared.settings`. |
+| `settings.logs` | Логирование set/init/changed. |
+
+## Близкие плагины
+
+### plugins/core/
+
+- [logs.md](./logs.md) — `LOGS`: `emitLog`, `CONST.LOGS.FILTER_FROM_RESULT_OPTIONS`
+- [storage.md](./storage.md) — `STORAGE`: `GET_ALL`, `SET` (персистентность настроек)
+
+### Остальные
+
+— нет

package/plugins/core/stack.md

@@ -0,0 +1,57 @@
+# plugins/core/stack/
+
+Пакет: `@vnejs/plugins.core.stack` · namespace: `STACK`
+
+Стек вызовов меток сценария: jump, call, pop, аргументы call-frame.
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `EMIT` | `vne:stack:emit` | Перейти на метку: сброс `curLine`, clone args, preload label, clear memory. Payload: `{ label?, args? }`. |
+| `POP` | `vne:stack:pop` | Вернуться к предыдущей позиции в стеке или сбросить игру, если стек пуст. |
+| `CLEAR` | `vne:stack:clear` | Сбросить глобальный state и продолжить сценарий. |
+| `JUMP` | `vne:stack:jump` | Переход на метку без push в стек (делегирует в `EMIT`). |
+| `CALL` | `vne:stack:call` | Push текущей позиции, затем `EMIT` новой метки. |
+| `EXEC_ARG` | `vne:stack:exec_arg` | По токену строки вернуть значение аргумента из верхнего frame. Payload: `{ line? }`. |
+
+## Константы
+
+- **`LOGS_ACTIONS`** — `emit`, `call`, `jump`, `pop`, `clear`.
+- **`EXEC_ACTIONS`** — действия в строках `$stack`: `jump`, `call`, `pop`.
+
+## Параметры
+
+Нет.
+
+## Настройки
+
+Нет.
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `stack` | State стека; обработка `EMIT`; sync на `STATE.SET` / `CLEAR`. |
+| `stack.call` | Push frame + jump. |
+| `stack.jump` | Jump без сохранения. |
+| `stack.pop` | Pop frame. |
+| `stack.clear` | Clear state + next. |
+| `stack.args` | Резолв аргументов из строки сценария. |
+| `stack.exec` | Регистрация `$stack` handlers в scenario (jump/call/pop + preload). |
+| `stack.logs` | Логирование операций стека. |
+
+## Близкие плагины
+
+### plugins/core/
+
+- [logs.md](./logs.md) — `LOGS`: `emitLog`, `CONST.LOGS.FILTER_FROM_RESULT_OPTIONS`
+- [media.md](./media.md) — `MEDIA`: `CONST.MEDIA.PRIORITIES` (preload при jump/call)
+- [memory.md](./memory.md) — `MEMORY`: `CLEAR` (при `EMIT`)
+- [scenario.md](./scenario.md) — `SCENARIO`: `LABEL_GET`, `LINE_EXEC_REG`, `LINE_LOAD_REG`; `emitNext` → `NEXT`
+- [state.md](./state.md) — `STATE`: `SET`, `CLEAR` (sync стека; `CLEAR` из `stack.clear`)
+- [vendors.md](./vendors.md) — `VENDORS`: `CLONE` (`emitClone` для args)
+
+### Остальные
+
+— нет

package/plugins/core/state.md

@@ -0,0 +1,51 @@
+# plugins/core/state/
+
+Пакет: `@vnejs/plugins.core.state` · namespace: `STATE`
+
+Сериализация и восстановление глобального 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. |
+
+## Константы
+
+- **`LOGS_ACTIONS`** — `get`, `load`, `clear`, `migrate`.
+- **`MIGRATE_STATUS`** — коды результата: `OK`, `LINE_NOT_FOUND`, `LABEL_NOT_FOUND`, `MAJOR_VERSION_MISMATCH`, `MINOR_VERSION_MISMATCH`.
+
+## Параметры
+
+Нет.
+
+## Настройки
+
+Нет.
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `state` | `GET` / `LOAD` — serialize/hydrate globalState. |
+| `state.migrate` | Версионная миграция сохранений по hash строк сценария. |
+| `state.logs` | Логирование get/load/clear. |
+
+## Близкие плагины
+
+### plugins/core/
+
+- [logs.md](./logs.md) — `LOGS`: `emitLog`, `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)
+- [vendors.md](./vendors.md) — `VENDORS`: `HASH`, `CLONE` (`emitClone` state)
+
+### Остальные
+
+— нет

package/plugins/core/storage.md

@@ -0,0 +1,89 @@
+# plugins/core/storage/
+
+Пакет: `@vnejs/plugins.core.storage` · namespace: `STORAGE`
+
+Персистентное key-value хранилище на IndexedDB (localforage) с namespace по модулю и группой.
+
+## Формат ключа
+
+Физический ключ всегда трёхчастный: `{module}/{group}/{key}`.
+
+- Если `group` не передан — подставляется `_` (default group).
+- `key` может содержать `:` (например settings `vne:volume:common`).
+- `module` может содержать `.` (например `vars.global`, `fastforward.visits`).
+
+Примеры:
+
+| Вызов | Физический ключ |
+|-------|-----------------|
+| `{ module: "settings", key: "vne:volume:common" }` | `settings/_/vne:volume:common` |
+| `{ module: "save", group: "0", key: "3" }` | `save/0/3` |
+| `{ module: "fastforward.visits", group: "intro", key: "hash" }` | `fastforward.visits/intro/hash` |
+
+## Диск (desktop / Steam)
+
+| Group | Файл |
+|-------|------|
+| `_` или не задан | `{module}.json` |
+| любая другая | `{module}/{group}.json` |
+
+Примеры: `settings.json`, `save/0.json`, `save/autosave.json`, `fastforward.visits/intro.json`.
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `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. |
+| `CHANGED` | `vne:storage:changed` | В хранилище произошла запись, обновление или удаление. |
+| `IMPORT` | `vne:storage:import` | Заменить всё содержимое store данными из JSON-файла и перезагрузить страницу. |
+| `EXPORT` | `vne:storage:export` | Скачать всё хранилище как JSON. |
+| `CLEAR` | `vne:storage:clear` | Полностью очистить store и перезагрузить страницу. |
+
+### `GET_ALL` и имена ключей в ответе
+
+- `GET_ALL({ module, group })` — в ответе «голые» `key`.
+- `GET_ALL({ module })` без group:
+  - для default-группы `_` — тоже «голые» `key` (префикс `_/` снимается);
+  - для остальных групп — `group/key` (чтобы не смешивать одинаковые key из разных групп).
+
+## Константы
+
+Нет.
+
+## Параметры
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `GAMENAME` | `string` | Префикс имени IndexedDB store; по умолчанию `"vne-default"`. |
+
+## Настройки
+
+Нет.
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `storage` | Init localforage, `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. |
+
+## Близкие плагины
+
+### plugins/core/
+
+- [logs.md](./logs.md) — `LOGS`: `emitLog` (событие `CHANGED`)
+- [system.md](./system.md) — `SYSTEM`: `CONST.SYSTEM.VERSION_MAJOR`; `FILE_LOAD`, `FILE_READ`, `RELOAD` (import/export/clear)
+
+### Остальные
+
+— нет

package/plugins/core/system.md

@@ -0,0 +1,56 @@
+# plugins/core/system/
+
+Пакет: `@vnejs/plugins.core.system` · namespace: `SYSTEM`
+
+Жизненный цикл приложения, DOM-якоря, файлы, resize, версия движка.
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `STARTED` | `vne:system:started` | Движок инициализирован: все модули ready, media-манифесты загружены. |
+| `RESIZE` | `vne:system:resize` | Изменились размеры окна приложения. |
+| `RELOAD` | `vne:system:reload` | Перезагрузка страницы после фазы `CLOSE_BEFORE`. |
+| `FULLSCREEN` | `vne:system:fullscreen` | Переключение полноэкранного режима документа. |
+| `CLOSE` | `vne:system:close` | Закрытие окна приложения после фазы `CLOSE_BEFORE`. |
+| `CLOSE_BEFORE` | `vne:system:close_before` | Фаза подготовки перед закрытием или перезагрузкой страницы. |
+| `FILE_LOAD` | `vne:file:load` | Скачать объект как JSON-файл. Payload: `{ obj?, name? }`. |
+| `FILE_READ` | `vne:file:read` | File picker → parse JSON → вернуть содержимое. |
+
+## Константы
+
+| Ключ | Смысл |
+|------|-------|
+| `HOST` | Origin или `http://localhost:{port}` из query |
+| `VERSION_MAJOR` | Major-версия формата state (число) |
+| `VERSION_MINOR` | Minor-версия (число) |
+| `DOM_IDS.APP` | `"app"` — корневой контейнер |
+| `DOM_IDS.MEDIA` | `"media"` — скрытый контейнер медиа |
+| `DOM_IDS.COMPONENTS` | `"components"` — контейнер UI |
+
+## Параметры
+
+Нет.
+
+## Настройки
+
+Нет.
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `system` | Reload, close, fullscreen, `CLOSE_BEFORE`. |
+| `system.resize` | Реагирует на изменение размеров окна; инициирует `RESIZE`. |
+| `system.file` | `FILE_LOAD` / `FILE_READ`. |
+| `system.version` | Default state `{ major, minor }` для миграции сохранений. |
+
+## Близкие плагины
+
+### plugins/core/
+
+- [logs.md](./logs.md) — `LOGS`: `emitLog` (resize)
+
+### Остальные
+
+— нет