@vnejs/docs 0.2.64 → 0.2.66

package/changelog/README.md

@@ -0,0 +1,43 @@
+# Changelog
+
+Engine and public API changes. One file per `@vnejs/docs` release. Newest first.
+
+- [0.2.66](./0.2.66.md)
+- [0.2.65](./0.2.65.md)
+- [0.2.64](./0.2.64.md)
+- [0.2.63](./0.2.63.md)
+- [0.2.62](./0.2.62.md)
+- [0.2.61](./0.2.61.md)
+- [0.2.60](./0.2.60.md)
+- [0.2.59](./0.2.59.md)
+- [0.2.58](./0.2.58.md)
+- [0.2.57](./0.2.57.md)
+- [0.2.56](./0.2.56.md)
+- [0.2.55](./0.2.55.md)
+- [0.2.53](./0.2.53.md)
+- [0.2.52](./0.2.52.md)
+- [0.2.51](./0.2.51.md)
+- [0.2.50](./0.2.50.md)
+- [0.2.49](./0.2.49.md)
+- [0.2.47](./0.2.47.md)
+- [0.2.46](./0.2.46.md)
+- [0.2.43](./0.2.43.md)
+- [0.2.42](./0.2.42.md)
+- [0.2.40](./0.2.40.md)
+- [0.2.39](./0.2.39.md)
+- [0.2.38](./0.2.38.md)
+- [0.2.36](./0.2.36.md)
+- [0.2.35](./0.2.35.md)
+- [0.2.34](./0.2.34.md)
+- [0.2.33](./0.2.33.md)
+- [0.2.32](./0.2.32.md)
+- [0.2.31](./0.2.31.md)
+- [0.2.29](./0.2.29.md)
+- [0.2.26](./0.2.26.md)
+- [0.2.25](./0.2.25.md)
+- [0.2.23](./0.2.23.md)
+- [0.2.22](./0.2.22.md)
+- [0.2.21](./0.2.21.md)
+- [0.2.20](./0.2.20.md)
+- [0.2.19](./0.2.19.md)
+- [0.2.18](./0.2.18.md)

package/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "@vnejs/docs",
-  "readOrder": ["scenario.guide/README.md", "scenario.catalog/README.md", "scenario.catalog/index.md", "plugins/", "architecture.md"],
+  "readOrder": ["scenario.guide/README.md", "scenario.catalog/README.md", "scenario.catalog/index.md", "plugins/", "architecture/"],
   "sections": {
     "scenario.guide": {
       "path": "scenario.guide/",
@@ -31,12 +31,73 @@
       "role": "Plugin internals: events, modules, contracts"
     },
     "architecture": {
-      "path": "architecture.md",
-      "role": "Monorepo architecture (read rarely for scenario authoring)"
+      "path": "architecture/",
+      "role": "Monorepo model. Read every file in this folder, in one batch.",
+      "entry": "architecture/",
+      "pages": [
+        "architecture/model.md",
+        "architecture/dependencies.md",
+        "architecture/packages.md",
+        "architecture/modules.md",
+        "architecture/configs.md",
+        "architecture/contracts.md",
+        "architecture/plugins.md",
+        "architecture/compatibility.md",
+        "architecture/bundles.md",
+        "architecture/helpers.md",
+        "architecture/uis.md",
+        "architecture/cli.md",
+        "architecture/games.md",
+        "architecture/backends.md",
+        "architecture/editor.md",
+        "architecture/build.md"
+      ]
     },
     "changelog": {
-      "path": "CHANGELOG.md",
-      "role": "Plugin and API changes by @vnejs/docs version"
+      "path": "changelog/",
+      "role": "Engine and API changes. One file per @vnejs/docs release. Read README.md, then one version file.",
+      "entry": "changelog/README.md",
+      "pages": [
+        "changelog/README.md",
+        "changelog/0.2.65.md",
+        "changelog/0.2.64.md",
+        "changelog/0.2.63.md",
+        "changelog/0.2.62.md",
+        "changelog/0.2.61.md",
+        "changelog/0.2.60.md",
+        "changelog/0.2.59.md",
+        "changelog/0.2.58.md",
+        "changelog/0.2.57.md",
+        "changelog/0.2.56.md",
+        "changelog/0.2.55.md",
+        "changelog/0.2.53.md",
+        "changelog/0.2.52.md",
+        "changelog/0.2.51.md",
+        "changelog/0.2.50.md",
+        "changelog/0.2.49.md",
+        "changelog/0.2.47.md",
+        "changelog/0.2.46.md",
+        "changelog/0.2.43.md",
+        "changelog/0.2.42.md",
+        "changelog/0.2.40.md",
+        "changelog/0.2.39.md",
+        "changelog/0.2.38.md",
+        "changelog/0.2.36.md",
+        "changelog/0.2.35.md",
+        "changelog/0.2.34.md",
+        "changelog/0.2.33.md",
+        "changelog/0.2.32.md",
+        "changelog/0.2.31.md",
+        "changelog/0.2.29.md",
+        "changelog/0.2.26.md",
+        "changelog/0.2.25.md",
+        "changelog/0.2.23.md",
+        "changelog/0.2.22.md",
+        "changelog/0.2.21.md",
+        "changelog/0.2.20.md",
+        "changelog/0.2.19.md",
+        "changelog/0.2.18.md"
+      ]
     }
   }
 }

package/package.json

@@ -1,20 +1,22 @@
 {
   "name": "@vnejs/docs",
-  "version": "0.2.64",
+  "version": "0.2.66",
   "description": "VNEJS documentation for engine consumers and coding agents",
   "files": [
     "*.md",
     "*.json",
     "plugins/**/*.md",
     "scenario.guide/**/*.md",
-    "scenario.catalog/**/*.md"
+    "scenario.catalog/**/*.md",
+    "architecture/**/*.md",
+    "changelog/**/*.md"
   ],
   "exports": {
     "./package.json": "./package.json",
     "./manifest.json": "./manifest.json",
     "./README.md": "./README.md",
-    "./CHANGELOG.md": "./CHANGELOG.md",
-    "./architecture.md": "./architecture.md",
+    "./changelog/*": "./changelog/*",
+    "./architecture/*": "./architecture/*",
     "./plugins/*": "./plugins/*",
     "./scenario.guide/*": "./scenario.guide/*",
     "./scenario.catalog/*": "./scenario.catalog/*"

package/plugins/ai/ai.md

@@ -1,14 +1,14 @@
 # plugins/ai/ai/
 
-Пакет: `@vnejs/plugins.ai` · namespace: `AI`
+Package: `@vnejs/plugins.ai` · namespace: `AI`
 
-Универсальный диспетчер AI-алгоритмов: `emitOne(EVENTS.AI.EMIT, { type, args })` вызывает `PARAMS.AI.ALGORITHMS[type](args, module)`. Доменные стратегии подключают свои контракты (side-effect на `PARAMS.AI.ALGORITHMS`), как [`ai/checkers`](./checkers.md).
+Universal AI algorithm dispatcher: `emitOne(EVENTS.AI.EMIT, { type, args })` calls `PARAMS.AI.ALGORITHMS[type](args, module)`. Domain strategies plug in their contracts (side effect on `PARAMS.AI.ALGORITHMS`), like [`ai/checkers`](./checkers.md).
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.ai`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.ai`.
 
-| Ключ   | Строка        | Смысл                                                   |
+| Key    | String        | Meaning                                                 |
 | ------ | ------------- | ------------------------------------------------------- |
 | `EMIT` | `vne:ai:emit` | Request/response (`emitOne`): payload `{ type, args }`. |
 
@@ -17,26 +17,26 @@ emitOne(EVENTS.AI.EMIT, { type, args });
 // → PARAMS.AI.ALGORITHMS[type](args, module) ?? null
 ```
 
-| Поле   | Тип       | Смысл                                          |
-| ------ | --------- | ---------------------------------------------- |
-| `type` | `string`  | Ключ в `PARAMS.AI.ALGORITHMS`.                 |
-| `args` | `unknown` | Произвольный payload для выбранного алгоритма. |
+| Field  | Type      | Meaning                                       |
+| ------ | --------- | --------------------------------------------- |
+| `type` | `string`  | Key in `PARAMS.AI.ALGORITHMS`.                |
+| `args` | `unknown` | Arbitrary payload for the selected algorithm. |
 
-Второй аргумент алгоритма — модуль AI (`emit` / `emitOne` / `emitReal`), как у settings ACTIONS.
+The second algorithm argument is the AI module (`emit` / `emitOne` / `emitReal`), like settings ACTIONS.
 
-Результат: значение из алгоритма или `null` (нет `type` / нет функции / алгоритм вернул `null`). Поддерживается `async`.
+Result: value from the algorithm or `null` (no `type` / no function / algorithm returned `null`). `async` is supported.
 
-## Константы
+## Constants
 
-| Ключ          | Тип / значение | Смысл                                                              |
-| ------------- | -------------- | ------------------------------------------------------------------ |
-| `PLAYER_TYPE` | `"player"`     | Тип контроллера «человек» (не алгоритм из `PARAMS.AI.ALGORITHMS`). |
+| Key           | Type / value | Meaning                                                                     |
+| ------------- | ------------ | --------------------------------------------------------------------------- |
+| `PLAYER_TYPE` | `"player"`   | Controller type for a human (not an algorithm from `PARAMS.AI.ALGORITHMS`). |
 
-## Параметры
+## Parameters
 
-| Ключ         | Тип / дефолт                         | Смысл                                                                |
-| ------------ | ------------------------------------ | -------------------------------------------------------------------- |
-| `ALGORITHMS` | `Record<string, AiAlgorithm>` → `{}` | Карта type → `(args, module) => result \| null`. Пусто по умолчанию. |
+| Key          | Type / default                       | Meaning                                                          |
+| ------------ | ------------------------------------ | ---------------------------------------------------------------- |
+| `ALGORITHMS` | `Record<string, AiAlgorithm>` → `{}` | Map type → `(args, module) => result \| null`. Empty by default. |
 
 ```ts
 type AiAlgorithmContext = Pick<Module, "emit" | "emitOne" | "emitReal">;
@@ -44,15 +44,15 @@ type AiAlgorithm<TArgs = unknown, TResult = unknown> = (args: TArgs, module: AiA
 type AiEmitPayload<TArgs = unknown> = { type?: string; args?: TArgs };
 ```
 
-## Модули
+## Modules
 
-| Модуль    | Зона ответственности                                               |
+| Module    | Role                                                               |
 | --------- | ------------------------------------------------------------------ |
 | `ai.emit` | `on(EVENTS.AI.EMIT)` → `PARAMS.AI.ALGORITHMS[type]?.(args, this)`. |
 
-## Регистрация алгоритмов
+## Algorithm registration
 
-Доменный контракт мутирует `PARAMS.AI.ALGORITHMS` при загрузке (как `SCALE_MANA` → `PARAMS.SCALES.TYPES`):
+A domain contract mutates `PARAMS.AI.ALGORITHMS` on load (like `SCALE_MANA` → `PARAMS.SCALES.TYPES`):
 
 ```ts
 import { PARAMS as AI_PARAMS } from "@vnejs/contracts.ai";
@@ -62,16 +62,16 @@ AI_PARAMS.ALGORITHMS["checkers:random"] = random;
 AI_PARAMS.ALGORITHMS["checkers:strong"] = strong;
 ```
 
-Шашечные `checkers:sacrifice` / `checkers:random` / `checkers:strong` — в [`ai/checkers`](./checkers.md). Игра может добавить свои ключи тем же способом или в скриптах.
+Checkers keys `checkers:sacrifice` / `checkers:random` / `checkers:strong` — in [`ai/checkers`](./checkers.md). A game can add its own keys the same way or in scripts.
 
-Вызывающая сторона (например `ai/checkers`):
+Caller (for example `ai/checkers`):
 
 ```ts
 await this.emitOne(this.EVENTS.AI.EMIT, { type, args: { board, turn, controllerType: type } });
 ```
 
-## Близкие плагины
+## Related plugins
 
-- [ai/checkers.md](./checkers.md) — оркестрация шашек: `CHECKERS_AI.INTERACT` → `AI.EMIT`.
-- [game/checkers.md](../game/checkers.md) — правила: `MOVES_GET` / `MOVE_PLAY`.
-- [views.screens/checkers.md](../views.screens/checkers.md) — экран `CHECKERS_VIEW`.
+- [ai/checkers.md](./checkers.md) — checkers orchestration: `CHECKERS_AI.INTERACT` → `AI.EMIT`.
+- [game/checkers.md](../game/checkers.md) — rules: `MOVES_GET` / `MOVE_PLAY`.
+- [views.screens/checkers.md](../views.screens/checkers.md) — `CHECKERS_VIEW` screen.

package/plugins/ai/checkers.md

@@ -1,60 +1,60 @@
 # plugins/ai/checkers/
 
-Пакет: `@vnejs/plugins.ai.checkers` · namespace: `CHECKERS_AI`
+Package: `@vnejs/plugins.ai.checkers` · namespace: `CHECKERS_AI`
 
-AI-оркестрация русских шашек: конфиг сторон, цикл хода через `AI.EMIT`, `$ checkers.ai`, дефолтные алгоритмы `checkers:sacrifice` / `checkers:random` / `checkers:strong`. Правила доски — в [`game/checkers`](../game/checkers.md); UI — в [`views.screens/checkers`](../views.screens/checkers.md); диспетчер — в [`ai/ai`](./ai.md).
+AI orchestration for Russian checkers: side config, turn loop via `AI.EMIT`, `$ checkers.ai`, default algorithms `checkers:sacrifice` / `checkers:random` / `checkers:strong`. Board rules — in [`game/checkers`](../game/checkers.md); UI — in [`views.screens/checkers`](../views.screens/checkers.md); dispatcher — in [`ai/ai`](./ai.md).
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.ai.checkers`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.ai.checkers`.
 
-| Ключ       | Строка                     | Смысл                                   |
-| ---------- | -------------------------- | --------------------------------------- |
-| `INTERACT` | `vne:checkers_ai:interact` | Ход AI (если сторона не `player`).      |
-| `SET`      | `vne:checkers_ai:set`      | `$ checkers.ai set`: `{ color, type }`. |
-| `UNSET`    | `vne:checkers_ai:unset`    | `$ checkers.ai unset <color>`.          |
+| Key        | String                     | Meaning                                  |
+| ---------- | -------------------------- | ---------------------------------------- |
+| `INTERACT` | `vne:checkers_ai:interact` | AI move (when the side is not `player`). |
+| `SET`      | `vne:checkers_ai:set`      | `$ checkers.ai set`: `{ color, type }`.  |
+| `UNSET`    | `vne:checkers_ai:unset`    | `$ checkers.ai unset <color>`.           |
 
-Слушает `CHECKERS.START` → `INTERACT`; `CHECKERS.MOVE_PLAYED` → unlock + `INTERACT`. Сторона хода — с `TURNS.CHANGED` / `TURNS.UNSET`; победитель — с `CHECKERS.FINISH` / сброс на `SHOW`; `board` — с `GRID.CHANGED` / `GRID.UNSET` (`cells`, фильтр `CONST.CHECKERS.GRID_ID`).
+Listens to `CHECKERS.START` → `INTERACT`; `CHECKERS.MOVE_PLAYED` → unlock + `INTERACT`. Side to move — from `TURNS.CHANGED` / `TURNS.UNSET`; winner — from `CHECKERS.FINISH` / reset on `SHOW`; `board` — from `GRID.CHANGED` / `GRID.UNSET` (`cells`, filter `CONST.CHECKERS.GRID_ID`).
 
-## Константы / Shared / Params
+## Constants / Shared / Params
 
-| Ключ                                          | Смысл                                                                   |
+| Key                                           | Meaning                                                                 |
 | --------------------------------------------- | ----------------------------------------------------------------------- |
-| `CONST.CHECKERS_AI.SOURCE`                    | `"checkers.ai.interact"` — ключ в `SourcesSet`                          |
+| `CONST.CHECKERS_AI.SOURCE`                    | `"checkers.ai.interact"` — key in `SourcesSet`                          |
 | `CONST.CHECKERS_AI.EXEC_ACTIONS` / `AI_TYPES` | set/unset; `checkers:sacrifice` / `checkers:random` / `checkers:strong` |
-| `shared.checkersAi`                           | `{ white, black }` → оба `player` по умолчанию                          |
-| `PARAMS.CHECKERS_AI.AI_DELAY`                 | пауза перед ходом AI (мс, `1000`)                                       |
+| `shared.checkersAi`                           | `{ white, black }` → both `player` by default                           |
+| `PARAMS.CHECKERS_AI.AI_DELAY`                 | pause before an AI move (ms, `1000`)                                    |
 
-Busy-флаг пишется в `shared.checkersInteractDisableSources` (владелец — `CHECKERS`).
+Busy flag is written to `shared.checkersInteractDisableSources` (owner — `CHECKERS`).
 
-Цвета сторон (`CONST.CHECKERS.COLORS`) — в контракте game.
+Side colors (`CONST.CHECKERS.COLORS`) — in the game contract.
 
-При загрузке контракта в `PARAMS.AI.ALGORITHMS` регистрируются `checkers:sacrifice` / `checkers:random` / `checkers:strong` (мутация как у `SCALE_MANA` → `PARAMS.SCALES.TYPES`).
+On contract load, `checkers:sacrifice` / `checkers:random` / `checkers:strong` register in `PARAMS.AI.ALGORITHMS` (mutation like `SCALE_MANA` → `PARAMS.SCALES.TYPES`).
 
-## Модули
+## Modules
 
-| Модуль                    | Зона                                               |
+| Module                    | Role                                               |
 | ------------------------- | -------------------------------------------------- |
 | `checkers.ai`             | `$ checkers.ai set/unset` → `SET` / `UNSET`        |
 | `checkers.ai.start`       | `CHECKERS.START` → `INTERACT`                      |
 | `checkers.ai.interact`    | `INTERACT` → delay → `AI.EMIT` (source = `SOURCE`) |
 | `checkers.ai.move.played` | `CHECKERS.MOVE_PLAYED` → `rm(SOURCE)` → `INTERACT` |
 
-## Сценарий
+## Scenario
 
 ```vne
 $ checkers.ai set white checkers:strong
 $ checkers.ai set black player
 ```
 
-## Бандл
+## Bundle
 
 `@vnejs/bundles.checkers` — `plugins.common.grid` + `plugins.common.turn` + `plugins.ai` + `plugins.ai.checkers` + `plugins.game.checkers` + `plugins.views.screens.checkers`.
 
-## Близкие плагины
+## Related plugins
 
-- [common/grid.md](../common/grid.md) — `GRID` (доска)
+- [common/grid.md](../common/grid.md) — `GRID` (board)
 - [common/turn.md](../common/turn.md) — `TURNS` (`id` / `owner`)
 - [ai/ai.md](./ai.md) — `EVENTS.AI.EMIT` / `PARAMS.AI.ALGORITHMS`
-- [game/checkers.md](../game/checkers.md) — правила, `START` / `MOVE_PLAYED`
-- [views.screens/checkers.md](../views.screens/checkers.md) — UI, gate по `SourcesSet`
+- [game/checkers.md](../game/checkers.md) — rules, `START` / `MOVE_PLAYED`
+- [views.screens/checkers.md](../views.screens/checkers.md) — UI, gate via `SourcesSet`

package/plugins/audio/ambient.md

@@ -1,39 +1,39 @@
 # plugins/audio/ambient/
 
-Пакет: `@vnejs/plugins.audio.ambient` · namespace: `AMBIENT`
+Package: `@vnejs/plugins.audio.ambient` · namespace: `AMBIENT`
 
-Воспроизведение зацикленного ambient-аудио из сценария с отдельной громкостью.
+Play looped ambient audio from scenario with a separate volume.
 
-## События
+## Events
 
-Нет.
+None.
 
-## Константы
+## Constants
 
-Нет.
+None.
 
-## Параметры
+## Parameters
 
-Нет.
+None.
 
-## Настройки
+## Settings
 
-| Ключ                            | Тип      | Смысл              |
-| ------------------------------- | -------- | ------------------ |
-| `VOLUME` (`vne:ambient:volume`) | `number` | Уровень громкости. |
+| Key                             | Type     | Meaning       |
+| ------------------------------- | -------- | ------------- |
+| `VOLUME` (`vne:ambient:volume`) | `number` | Volume level. |
 
-## Модули
+## Modules
 
-| Модуль    | Зона ответственности |
-| --------- | -------------------- |
-| `ambient` | Модуль `ambient`.    |
+| Module    | Role              |
+| --------- | ----------------- |
+| `ambient` | `ambient` module. |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
-— нет
+— None
 
-### Остальные
+### Other
 
-— нет
+— None

package/plugins/audio/audio.md

@@ -1,63 +1,63 @@
 # plugins/audio/audio/
 
-Пакет: `@vnejs/plugins.audio.audio` · namespace: `AUDIO`
+Package: `@vnejs/plugins.audio.audio` · namespace: `AUDIO`
 
-Базовый аудиодвижок: play/stop/pause/resume, volume и загрузка медиа через Web Audio.
+Base audio engine: play/stop/pause/resume, volume, and media load via Web Audio.
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.audio`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.audio`.
 
-| Ключ             | Строка                     | Смысл                                                 |
-| ---------------- | -------------------------- | ----------------------------------------------------- |
-| `PLAY`           | `vne:audio:play`           | Запросить данные у обработчиков и продолжить цепочку. |
-| `STOP`           | `vne:audio:stop`           | Запросить данные у обработчиков и продолжить цепочку. |
-| `PAUSE`          | `vne:audio:pause`          | Запросить данные у обработчиков и продолжить цепочку. |
-| `RESUME`         | `vne:audio:resume`         | Запросить данные у обработчиков и продолжить цепочку. |
-| `MEDIA_GET`      | `vne:audio:media_get`      | Получить значение или ресурс.                         |
-| `MEDIA_LOAD`     | `vne:audio:media_load`     | Загрузить данные или ресурс.                          |
-| `VOLUME`         | `vne:audio:volume`         | Запросить данные у обработчиков и продолжить цепочку. |
-| `VOLUME_GET`     | `vne:audio:volume_get`     | Запросить данные у обработчиков и продолжить цепочку. |
-| `VOLUME_CHANGED` | `vne:audio:volume_changed` | Зафиксировать изменение состояния.                    |
-| `GLOBAL_PAUSE`   | `vne:audio:global_pause`   | Приостановить воспроизведение.                        |
-| `GLOBAL_RESUME`  | `vne:audio:global_resume`  | Событие `GLOBAL_RESUME` namespace плагина.            |
-| `ENDED`          | `vne:audio:ended`          | Событие `ENDED` namespace плагина.                    |
+| Key              | String                     | Meaning                                       |
+| ---------------- | -------------------------- | --------------------------------------------- |
+| `PLAY`           | `vne:audio:play`           | Ask handlers for data and continue the chain. |
+| `STOP`           | `vne:audio:stop`           | Ask handlers for data and continue the chain. |
+| `PAUSE`          | `vne:audio:pause`          | Ask handlers for data and continue the chain. |
+| `RESUME`         | `vne:audio:resume`         | Ask handlers for data and continue the chain. |
+| `MEDIA_GET`      | `vne:audio:media_get`      | Get a value or resource.                      |
+| `MEDIA_LOAD`     | `vne:audio:media_load`     | Load data or a resource.                      |
+| `VOLUME`         | `vne:audio:volume`         | Ask handlers for data and continue the chain. |
+| `VOLUME_GET`     | `vne:audio:volume_get`     | Ask handlers for data and continue the chain. |
+| `VOLUME_CHANGED` | `vne:audio:volume_changed` | Record a state change.                        |
+| `GLOBAL_PAUSE`   | `vne:audio:global_pause`   | Pause playback.                               |
+| `GLOBAL_RESUME`  | `vne:audio:global_resume`  | Plugin namespace event `GLOBAL_RESUME`.       |
+| `ENDED`          | `vne:audio:ended`          | Plugin namespace event `ENDED`.               |
 
-## Константы
+## Constants
 
-Нет.
+None.
 
-## Параметры
+## Parameters
 
-| Ключ      | Тип      | Смысл                         |
-| --------- | -------- | ----------------------------- |
-| `QUALITY` | `string` | Значение по умолчанию: "64k". |
+| Key       | Type     | Meaning           |
+| --------- | -------- | ----------------- |
+| `QUALITY` | `string` | Default: `"64k"`. |
 
-## Настройки
+## Settings
 
-| Ключ                          | Тип      | Смысл              |
-| ----------------------------- | -------- | ------------------ |
-| `VOLUME` (`vne:audio:volume`) | `number` | Уровень громкости. |
+| Key                           | Type     | Meaning       |
+| ----------------------------- | -------- | ------------- |
+| `VOLUME` (`vne:audio:volume`) | `number` | Volume level. |
 
-## Модули
+## Modules
 
-| Модуль         | Зона ответственности                                                                |
-| -------------- | ----------------------------------------------------------------------------------- |
-| `audio.play`   | Подмодуль `play` плагина.                                                           |
-| `audio.stop`   | Подмодуль `stop` плагина.                                                           |
-| `audio.media`  | В `postinject` — `shared.audioNoSmoothSources`; обрабатывает MEDIA_GET, MEDIA_LOAD. |
-| `audio.pause`  | Подмодуль `pause` плагина.                                                          |
-| `audio.volume` | Обрабатывает VOLUME, VOLUME_GET, CHANGED.                                           |
-| `audio.resume` | Подмодуль `resume` плагина.                                                         |
-| `audio.ended`  | Обрабатывает PLAY, STOP.                                                            |
+| Module         | Role                                                                            |
+| -------------- | ------------------------------------------------------------------------------- |
+| `audio.play`   | Plugin `play` submodule.                                                        |
+| `audio.stop`   | Plugin `stop` submodule.                                                        |
+| `audio.media`  | In `postinject` — `shared.audioNoSmoothSources`; handles MEDIA_GET, MEDIA_LOAD. |
+| `audio.pause`  | Plugin `pause` submodule.                                                       |
+| `audio.volume` | Handles VOLUME, VOLUME_GET, CHANGED.                                            |
+| `audio.resume` | Plugin `resume` submodule.                                                      |
+| `audio.ended`  | Handles PLAY, STOP.                                                             |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
 - [media.md](../core/media.md) — `MEDIA`: EVENTS.LOAD, CONST.PRIORITIES.BACKGROUND, CONST.TYPES.AUDIO
 - [settings.md](../core/settings.md) — `SETTINGS`: EVENTS.CHANGED
 
-### Остальные
+### Other
 
 - [volume.md](../settings/volume.md) — `VOLUME`: SETTINGS.COMMON, SETTINGS.AUDIO

package/plugins/audio/music.md

@@ -1,39 +1,39 @@
 # plugins/audio/music/
 
-Пакет: `@vnejs/plugins.audio.music` · namespace: `MUSIC`
+Package: `@vnejs/plugins.audio.music` · namespace: `MUSIC`
 
-Воспроизведение зацикленной музыки из сценария с сохранением state.
+Play looped music from scenario with state persistence.
 
-## События
+## Events
 
-Нет.
+None.
 
-## Константы
+## Constants
 
-Нет.
+None.
 
-## Параметры
+## Parameters
 
-Нет.
+None.
 
-## Настройки
+## Settings
 
-| Ключ                          | Тип      | Смысл              |
-| ----------------------------- | -------- | ------------------ |
-| `VOLUME` (`vne:music:volume`) | `number` | Уровень громкости. |
+| Key                           | Type     | Meaning       |
+| ----------------------------- | -------- | ------------- |
+| `VOLUME` (`vne:music:volume`) | `number` | Volume level. |
 
-## Модули
+## Modules
 
-| Модуль  | Зона ответственности |
-| ------- | -------------------- |
-| `music` | Модуль `music`.      |
+| Module  | Role            |
+| ------- | --------------- |
+| `music` | `music` module. |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
-— нет
+— None
 
-### Остальные
+### Other
 
-— нет
+— None