@vnejs/docs 0.2.65 → 0.2.67

package/plugins/canvas/sprite.md

@@ -1,15 +1,15 @@
 # plugins/canvas/sprite/
 
-Пакет: `@vnejs/plugins.canvas.sprite` · namespace: `LAYER_SPRITE`
+Package: `@vnejs/plugins.canvas.sprite` · namespace: `LAYER_SPRITE`
 
-Показ, скрытие, перемещение и смена спрайтов на canvas-слоях.
+Show, hide, move, and change sprites on canvas layers.
 
 ## Overlays
 
-Два связанных смысла одного имени:
+Two related meanings of one name:
 
-1. **Args / сценарий** — `args.overlays?: Record<string, string>`: карта слоёв вида `emotion` / `hair` / `wear` → значение; пути `{variation}/{key}/{value}` (+ `{variation}/index`).
-2. **Layer child / React** — после `SRC_GET` на child и в `<Sprite />` поле `overlays` — массив `{ src }` для отрисовки.
+1. **Args / scenario** — `args.overlays?: Record<string, string>`: layer map `emotion` / `hair` / `wear` → value; paths `{variation}/{key}/{value}` (+ `{variation}/index`).
+2. **Layer child / React** — after `SRC_GET`, on the child and in `<Sprite />`, field `overlays` is a `{ src }` array for drawing.
 
 ```vne
 $ ul.sprite show co left {co/default} opacity 500
@@ -21,58 +21,58 @@ $ ul.sprite show co left {co/default} opacity 500
 
 `PARAMS.LAYER_SPRITE.SPRITE_INFO[type]`:
 
-| Поле           | Смысл                                                                                                                                                                                               |
-| -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `mapOverlays?` | Преобразование карты overlays перед резолвом путей                                                                                                                                                  |
-| `getSrc?`      | Кастомный список src по `(variation, realOverlays, options, otherArgs)`. Пустая строка и другие falsy-элементы сохраняют слот и рисуются как transparent-картинка (без `MEDIA.GET` / `MEDIA.LOAD`). |
+| Field          | Meaning                                                                                                                                                                                   |
+| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `mapOverlays?` | Transform the overlay map before path resolve                                                                                                                                             |
+| `getSrc?`      | Custom src list from `(variation, realOverlays, options, otherArgs)`. Empty string and other falsy entries keep the slot and draw as a transparent image (no `MEDIA.GET` / `MEDIA.LOAD`). |
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.canvas.child.sprite`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.canvas.child.sprite`.
 
-| Ключ           | Строка                          | Смысл                                                 |
-| -------------- | ------------------------------- | ----------------------------------------------------- |
-| `SHOW`         | `vne:layer_sprite:show`         | Запросить данные у обработчиков и продолжить цепочку. |
-| `HIDE`         | `vne:layer_sprite:hide`         | Скрыть UI или слой.                                   |
-| `MOVE`         | `vne:layer_sprite:move`         | Событие `MOVE` namespace плагина.                     |
-| `CHANGE`       | `vne:layer_sprite:change`       | Запросить данные у обработчиков и продолжить цепочку. |
-| `PRELOAD`      | `vne:layer_sprite:preload`      | Событие `PRELOAD` namespace плагина.                  |
-| `SRC_GET`      | `vne:layer_sprite:src_get`      | Получить значение или ресурс.                         |
-| `STATE_UPDATE` | `vne:layer_sprite:state_update` | Обновить накопленное состояние модуля.                |
-| `STATE_GET`    | `vne:layer_sprite:state_get`    | Получить значение или ресурс.                         |
-| `STATE_ADD`    | `vne:layer_sprite:state_add`    | Событие `STATE_ADD` namespace плагина.                |
-| `STATE_RM`     | `vne:layer_sprite:state_rm`     | Событие `STATE_RM` namespace плагина.                 |
+| Key            | String                          | Meaning                                       |
+| -------------- | ------------------------------- | --------------------------------------------- |
+| `SHOW`         | `vne:layer_sprite:show`         | Ask handlers for data and continue the chain. |
+| `HIDE`         | `vne:layer_sprite:hide`         | Hide the UI or layer.                         |
+| `MOVE`         | `vne:layer_sprite:move`         | Plugin namespace `MOVE` event.                |
+| `CHANGE`       | `vne:layer_sprite:change`       | Ask handlers for data and continue the chain. |
+| `PRELOAD`      | `vne:layer_sprite:preload`      | Plugin namespace `PRELOAD` event.             |
+| `SRC_GET`      | `vne:layer_sprite:src_get`      | Get a value or resource.                      |
+| `STATE_UPDATE` | `vne:layer_sprite:state_update` | Update accumulated module state.              |
+| `STATE_GET`    | `vne:layer_sprite:state_get`    | Get a value or resource.                      |
+| `STATE_ADD`    | `vne:layer_sprite:state_add`    | Plugin namespace `STATE_ADD` event.           |
+| `STATE_RM`     | `vne:layer_sprite:state_rm`     | Plugin namespace `STATE_RM` event.            |
 
-## Константы
+## Constants
 
-Нет.
+None.
 
-## Параметры
+## Parameters
 
-| Ключ               | Тип      | Смысл                                      |
-| ------------------ | -------- | ------------------------------------------ |
-| `TRANSITIONS_SHOW` | `string` | Значение по умолчанию: "TRANSITIONS_SHOW". |
-| `TRANSITIONS_HIDE` | `string` | Значение по умолчанию: "TRANSITIONS_HIDE". |
-| `POSITIONS`        | `string` | Значение по умолчанию: "POSITIONS".        |
-| `SPRITE_INFO`      | `string` | Значение по умолчанию: "SPRITE_INFO".      |
+| Key                | Type     | Meaning                      |
+| ------------------ | -------- | ---------------------------- |
+| `TRANSITIONS_SHOW` | `string` | Default: "TRANSITIONS_SHOW". |
+| `TRANSITIONS_HIDE` | `string` | Default: "TRANSITIONS_HIDE". |
+| `POSITIONS`        | `string` | Default: "POSITIONS".        |
+| `SPRITE_INFO`      | `string` | Default: "SPRITE_INFO".      |
 
-## Настройки
+## Settings
 
-Нет.
+None.
 
-## Модули
+## Modules
 
-| Модуль                 | Зона ответственности                                          |
-| ---------------------- | ------------------------------------------------------------- |
-| `layer.sprite.src`     | Подмодуль `sprite.src` плагина.                               |
-| `layer.sprite.show`    | Подмодуль `sprite.show` плагина.                              |
-| `layer.sprite.hide`    | Подмодуль `sprite.hide` плагина.                              |
-| `layer.sprite.move`    | Подмодуль `sprite.move` плагина.                              |
-| `layer.sprite.state`   | Обрабатывает STATE_UPDATE, STATE_GET, STATE_ADD, STATE_RM, …. |
-| `layer.sprite.change`  | Подмодуль `sprite.change` плагина.                            |
-| `layer.sprite.preload` | Подмодуль `sprite.preload` плагина.                           |
+| Module                 | Role                                                     |
+| ---------------------- | -------------------------------------------------------- |
+| `layer.sprite.src`     | Plugin `sprite.src` submodule.                           |
+| `layer.sprite.show`    | Plugin `sprite.show` submodule.                          |
+| `layer.sprite.hide`    | Plugin `sprite.hide` submodule.                          |
+| `layer.sprite.move`    | Plugin `sprite.move` submodule.                          |
+| `layer.sprite.state`   | Handles STATE_UPDATE, STATE_GET, STATE_ADD, STATE_RM, …. |
+| `layer.sprite.change`  | Plugin `sprite.change` submodule.                        |
+| `layer.sprite.preload` | Plugin `sprite.preload` submodule.                       |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
@@ -81,6 +81,6 @@ Payloads и результаты хендлеров типизированы ч
 - [memory.md](../core/memory.md) — `MEMORY`: EVENTS.CLEARED
 - [state.md](../core/state.md) — `STATE`: EVENTS.SET, EVENTS.CLEAR, EVENTS.PRELOAD
 
-### Остальные
+### Other
 
 - [layer.md](./layer.md) — `LAYER`: EVENTS.UPDATE_FORCE, EVENTS.CHILD_GET, EVENTS.CHILD_CHANGE, EVENTS.CHILD_RM, SETTINGS.QUALITY, EVENTS.CHILD_ADD

package/plugins/canvas/sprite.speak.md

@@ -1,55 +1,55 @@
 # plugins/canvas/sprite.speak/
 
-Пакет: `@vnejs/plugins.canvas.sprite.speak` · namespace: `LAYER_SPRITE_SPEAK`
+Package: `@vnejs/plugins.canvas.sprite.speak` · namespace: `LAYER_SPRITE_SPEAK`
 
-Включение опции speak у sprite при речи спикера.
+Turn on sprite speak when the speaker talks.
 
-Args спрайта могут содержать `overlays` (как у [sprite.md](./sprite.md)); speak меняет `options.speak` и перезапускает change/preload с теми же args.
+Sprite args may include `overlays` (as in [sprite.md](./sprite.md)); speak updates `options.speak` and reruns change/preload with the same args.
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.canvas.child.sprite.speak`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.canvas.child.sprite.speak`.
 
-| Ключ         | Строка                              | Смысл                                                 |
-| ------------ | ----------------------------------- | ----------------------------------------------------- |
-| `PUSH`       | `vne:layer_sprite_speak:push`       | Добавить элемент в очередь или стек.                  |
-| `POP`        | `vne:layer_sprite_speak:pop`        | Извлечь элемент из очереди или стека.                 |
-| `SPEAKER`    | `vne:layer_sprite_speak:speaker`    | Запросить данные у обработчиков и продолжить цепочку. |
-| `START`      | `vne:layer_sprite_speak:start`      | Начать процесс.                                       |
-| `END`        | `vne:layer_sprite_speak:end`        | Запросить данные у обработчиков и продолжить цепочку. |
-| `SPRITE_GET` | `vne:layer_sprite_speak:sprite_get` | Запросить данные у обработчиков и продолжить цепочку. |
-| `OPTION_SET` | `vne:layer_sprite_speak:option_set` | Записать или обновить значение.                       |
+| Key          | String                              | Meaning                                       |
+| ------------ | ----------------------------------- | --------------------------------------------- |
+| `PUSH`       | `vne:layer_sprite_speak:push`       | Add an item to a queue or stack.              |
+| `POP`        | `vne:layer_sprite_speak:pop`        | Remove an item from a queue or stack.         |
+| `SPEAKER`    | `vne:layer_sprite_speak:speaker`    | Ask handlers for data and continue the chain. |
+| `START`      | `vne:layer_sprite_speak:start`      | Start a process.                              |
+| `END`        | `vne:layer_sprite_speak:end`        | Ask handlers for data and continue the chain. |
+| `SPRITE_GET` | `vne:layer_sprite_speak:sprite_get` | Ask handlers for data and continue the chain. |
+| `OPTION_SET` | `vne:layer_sprite_speak:option_set` | Write or update a value.                      |
 
-## Константы
+## Constants
 
-Нет.
+None.
 
-## Параметры
+## Parameters
 
-| Ключ           | Тип      | Смысл                        |
-| -------------- | -------- | ---------------------------- |
-| `MIN_DURATION` | `number` | Значение по умолчанию: 2000. |
+| Key            | Type     | Meaning        |
+| -------------- | -------- | -------------- |
+| `MIN_DURATION` | `number` | Default: 2000. |
 
-## Настройки
+## Settings
 
-Нет.
+None.
 
-## Модули
+## Modules
 
-| Модуль                        | Зона ответственности                                          |
-| ----------------------------- | ------------------------------------------------------------- |
-| `layer.sprite.speak.sources`  | В `postinject` — `shared.layerSpriteSpeakSources`; PUSH, POP. |
-| `layer.sprite.speak.duration` | Подмодуль `sprite.speak.duration` плагина.                    |
-| `layer.sprite.speak.preload`  | Подмодуль `sprite.speak.preload` плагина.                     |
-| `layer.sprite.speak.staff`    | Обрабатывает SPRITE_GET, OPTION_SET.                          |
-| `layer.sprite.speak`          | Обрабатывает END, START, SPEAKER.                             |
+| Module                        | Role                                                           |
+| ----------------------------- | -------------------------------------------------------------- |
+| `layer.sprite.speak.sources`  | In `postinject` — `shared.layerSpriteSpeakSources`; PUSH, POP. |
+| `layer.sprite.speak.duration` | Plugin `sprite.speak.duration` submodule.                      |
+| `layer.sprite.speak.preload`  | Plugin `sprite.speak.preload` submodule.                       |
+| `layer.sprite.speak.staff`    | Handles SPRITE_GET, OPTION_SET.                                |
+| `layer.sprite.speak`          | Handles END, START, SPEAKER.                                   |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
-— нет
+— None
 
-### Остальные
+### Other
 
 - [sprite.md](./sprite.md) — `LAYER_SPRITE`: EVENTS.PRELOAD, EVENTS.STATE_GET, EVENTS.CHANGE

package/plugins/canvas/text.md

@@ -1,54 +1,54 @@
 # plugins/canvas/text/
 
-Пакет: `@vnejs/plugins.canvas.text` · namespace: `LAYER_TEXT`
+Package: `@vnejs/plugins.canvas.text` · namespace: `LAYER_TEXT`
 
-Показ, скрытие, смена и перемещение локализованного текста на слоях.
+Show, hide, change, and move localized text on layers.
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.canvas.child.text`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.canvas.child.text`.
 
-| Ключ           | Строка                        | Смысл                                                 |
-| -------------- | ----------------------------- | ----------------------------------------------------- |
-| `SHOW`         | `vne:layer_text:show`         | Запросить данные у обработчиков и продолжить цепочку. |
-| `HIDE`         | `vne:layer_text:hide`         | Скрыть UI или слой.                                   |
-| `CHANGE`       | `vne:layer_text:change`       | Запросить данные у обработчиков и продолжить цепочку. |
-| `MOVE`         | `vne:layer_text:move`         | Событие `MOVE` namespace плагина.                     |
-| `STATE_UPDATE` | `vne:layer_text:state_update` | Обновить накопленное состояние модуля.                |
-| `STATE_GET`    | `vne:layer_text:state_get`    | Получить значение или ресурс.                         |
-| `STATE_ADD`    | `vne:layer_text:state_add`    | Событие `STATE_ADD` namespace плагина.                |
-| `STATE_RM`     | `vne:layer_text:state_rm`     | Событие `STATE_RM` namespace плагина.                 |
+| Key            | String                        | Meaning                                       |
+| -------------- | ----------------------------- | --------------------------------------------- |
+| `SHOW`         | `vne:layer_text:show`         | Ask handlers for data and continue the chain. |
+| `HIDE`         | `vne:layer_text:hide`         | Hide the UI or layer.                         |
+| `CHANGE`       | `vne:layer_text:change`       | Ask handlers for data and continue the chain. |
+| `MOVE`         | `vne:layer_text:move`         | Plugin namespace `MOVE` event.                |
+| `STATE_UPDATE` | `vne:layer_text:state_update` | Update accumulated module state.              |
+| `STATE_GET`    | `vne:layer_text:state_get`    | Get a value or resource.                      |
+| `STATE_ADD`    | `vne:layer_text:state_add`    | Plugin namespace `STATE_ADD` event.           |
+| `STATE_RM`     | `vne:layer_text:state_rm`     | Plugin namespace `STATE_RM` event.            |
 
-## Константы
+## Constants
 
-Нет.
+None.
 
-## Параметры
+## Parameters
 
-| Ключ                 | Тип      | Смысл                                        |
-| -------------------- | -------- | -------------------------------------------- |
-| `TEXT_STYLE_KEYS`    | `string` | Значение по умолчанию: "TEXT_STYLE_KEYS".    |
-| `DEFAULT_TEXT_ARGS`  | `string` | Значение по умолчанию: "DEFAULT_TEXT_ARGS".  |
-| `TRANSITIONS_SHOW`   | `string` | Значение по умолчанию: "TRANSITIONS_SHOW".   |
-| `TRANSITIONS_HIDE`   | `string` | Значение по умолчанию: "TRANSITIONS_HIDE".   |
-| `TRANSITIONS_CHANGE` | `string` | Значение по умолчанию: "TRANSITIONS_CHANGE". |
-| `POSITIONS`          | `string` | Значение по умолчанию: "POSITIONS".          |
+| Key                  | Type     | Meaning                        |
+| -------------------- | -------- | ------------------------------ |
+| `TEXT_STYLE_KEYS`    | `string` | Default: "TEXT_STYLE_KEYS".    |
+| `DEFAULT_TEXT_ARGS`  | `string` | Default: "DEFAULT_TEXT_ARGS".  |
+| `TRANSITIONS_SHOW`   | `string` | Default: "TRANSITIONS_SHOW".   |
+| `TRANSITIONS_HIDE`   | `string` | Default: "TRANSITIONS_HIDE".   |
+| `TRANSITIONS_CHANGE` | `string` | Default: "TRANSITIONS_CHANGE". |
+| `POSITIONS`          | `string` | Default: "POSITIONS".          |
 
-## Настройки
+## Settings
 
-Нет.
+None.
 
-## Модули
+## Modules
 
-| Модуль              | Зона ответственности                                          |
-| ------------------- | ------------------------------------------------------------- |
-| `layer.text.show`   | Подмодуль `text.show` плагина.                                |
-| `layer.text.hide`   | Подмодуль `text.hide` плагина.                                |
-| `layer.text.change` | Подмодуль `text.change` плагина.                              |
-| `layer.text.move`   | Подмодуль `text.move` плагина.                                |
-| `layer.text.state`  | Обрабатывает STATE_UPDATE, STATE_GET, STATE_ADD, STATE_RM, …. |
+| Module              | Role                                                     |
+| ------------------- | -------------------------------------------------------- |
+| `layer.text.show`   | Plugin `text.show` submodule.                            |
+| `layer.text.hide`   | Plugin `text.hide` submodule.                            |
+| `layer.text.change` | Plugin `text.change` submodule.                          |
+| `layer.text.move`   | Plugin `text.move` submodule.                            |
+| `layer.text.state`  | Handles STATE_UPDATE, STATE_GET, STATE_ADD, STATE_RM, …. |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
@@ -57,7 +57,7 @@ Payloads и результаты хендлеров типизированы ч
 - [memory.md](../core/memory.md) — `MEMORY`: EVENTS.CLEARED
 - [state.md](../core/state.md) — `STATE`: EVENTS.SET, EVENTS.CLEAR, EVENTS.PRELOAD
 
-### Остальные
+### Other
 
 - [layer.md](./layer.md) — `LAYER`: EVENTS.CHILD_GET, EVENTS.CHILD_CHANGE, EVENTS.UPDATE_FORCE, EVENTS.CHILD_RM, EVENTS.CHILD_ADD
 - [locs.md](../text/locs.md) — `LOCS`: EVENTS.LOAD

package/plugins/canvas/video.md

@@ -1,10 +1,10 @@
 # plugins/canvas/video/
 
-Пакет: `@vnejs/plugins.canvas.video` · namespace: `LAYER_VIDEO`
+Package: `@vnejs/plugins.canvas.video` · namespace: `LAYER_VIDEO`
 
-Показ, скрытие, смена и preload видео на canvas-слоях.
+Show, hide, change, and preload video on canvas layers.
 
-Then-bg после видео принимает те же args, что [bg.md](./bg.md), включая `overlays` (в сценарии — блок `bg:` под командой video).
+Then-bg after video takes the same args as [bg.md](./bg.md), including `overlays` (in the scenario — a `bg:` block under the video command).
 
 ```vne
 $ bl.video show {logo} … then bg {castle/surgery_room} …
@@ -14,50 +14,50 @@ $ bl.video show {logo} … then bg {castle/surgery_room} …
       man: 1
 ```
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.canvas.child.video`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.canvas.child.video`.
 
-| Ключ           | Строка                         | Смысл                                                 |
-| -------------- | ------------------------------ | ----------------------------------------------------- |
-| `SHOW`         | `vne:layer_video:show`         | Запросить данные у обработчиков и продолжить цепочку. |
-| `HIDE`         | `vne:layer_video:hide`         | Запросить данные у обработчиков и продолжить цепочку. |
-| `CHANGE`       | `vne:layer_video:change`       | Запросить данные у обработчиков и продолжить цепочку. |
-| `ENDED`        | `vne:layer_video:ended`        | Запросить данные у обработчиков и продолжить цепочку. |
-| `PRELOAD`      | `vne:layer_video:preload`      | Событие `PRELOAD` namespace плагина.                  |
-| `SRC_GET`      | `vne:layer_video:src_get`      | Запросить данные у обработчиков и продолжить цепочку. |
-| `STATE_RM`     | `vne:layer_video:state_rm`     | Событие `STATE_RM` namespace плагина.                 |
-| `STATE_GET`    | `vne:layer_video:state_get`    | Получить значение или ресурс.                         |
-| `STATE_ADD`    | `vne:layer_video:state_add`    | Событие `STATE_ADD` namespace плагина.                |
-| `STATE_UPDATE` | `vne:layer_video:state_update` | Обновить накопленное состояние модуля.                |
+| Key            | String                         | Meaning                                       |
+| -------------- | ------------------------------ | --------------------------------------------- |
+| `SHOW`         | `vne:layer_video:show`         | Ask handlers for data and continue the chain. |
+| `HIDE`         | `vne:layer_video:hide`         | Ask handlers for data and continue the chain. |
+| `CHANGE`       | `vne:layer_video:change`       | Ask handlers for data and continue the chain. |
+| `ENDED`        | `vne:layer_video:ended`        | Ask handlers for data and continue the chain. |
+| `PRELOAD`      | `vne:layer_video:preload`      | Plugin namespace `PRELOAD` event.             |
+| `SRC_GET`      | `vne:layer_video:src_get`      | Ask handlers for data and continue the chain. |
+| `STATE_RM`     | `vne:layer_video:state_rm`     | Plugin namespace `STATE_RM` event.            |
+| `STATE_GET`    | `vne:layer_video:state_get`    | Get a value or resource.                      |
+| `STATE_ADD`    | `vne:layer_video:state_add`    | Plugin namespace `STATE_ADD` event.           |
+| `STATE_UPDATE` | `vne:layer_video:state_update` | Update accumulated module state.              |
 
-## Константы
+## Constants
 
-Нет.
+None.
 
-## Параметры
+## Parameters
 
-| Ключ               | Тип      | Смысл                                      |
-| ------------------ | -------- | ------------------------------------------ |
-| `TRANSITIONS_SHOW` | `string` | Значение по умолчанию: "TRANSITIONS_SHOW". |
-| `TRANSITIONS_HIDE` | `string` | Значение по умолчанию: "TRANSITIONS_HIDE". |
+| Key                | Type     | Meaning                      |
+| ------------------ | -------- | ---------------------------- |
+| `TRANSITIONS_SHOW` | `string` | Default: "TRANSITIONS_SHOW". |
+| `TRANSITIONS_HIDE` | `string` | Default: "TRANSITIONS_HIDE". |
 
-## Настройки
+## Settings
 
-Нет.
+None.
 
-## Модули
+## Modules
 
-| Модуль                | Зона ответственности                                          |
-| --------------------- | ------------------------------------------------------------- |
-| `layer.video.show`    | Обрабатывает SHOW, ENDED.                                     |
-| `layer.video.hide`    | Подмодуль `video.hide` плагина.                               |
-| `layer.video.change`  | Подмодуль `video.change` плагина.                             |
-| `layer.video.state`   | Обрабатывает STATE_UPDATE, STATE_GET, STATE_ADD, STATE_RM, …. |
-| `layer.video.src.get` | Подмодуль `video.src.get` плагина.                            |
-| `layer.video.preload` | Подмодуль `video.preload` плагина.                            |
+| Module                | Role                                                     |
+| --------------------- | -------------------------------------------------------- |
+| `layer.video.show`    | Handles SHOW, ENDED.                                     |
+| `layer.video.hide`    | Plugin `video.hide` submodule.                           |
+| `layer.video.change`  | Plugin `video.change` submodule.                         |
+| `layer.video.state`   | Handles STATE_UPDATE, STATE_GET, STATE_ADD, STATE_RM, …. |
+| `layer.video.src.get` | Plugin `video.src.get` submodule.                        |
+| `layer.video.preload` | Plugin `video.preload` submodule.                        |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
@@ -66,7 +66,7 @@ Payloads и результаты хендлеров типизированы ч
 - [memory.md](../core/memory.md) — `MEMORY`: EVENTS.CLEARED
 - [state.md](../core/state.md) — `STATE`: EVENTS.SET, EVENTS.CLEAR, EVENTS.PRELOAD
 
-### Остальные
+### Other
 
 - [layer.md](./layer.md) — `LAYER`: EVENTS.CHILD_CHANGE, EVENTS.UPDATE_FORCE, EVENTS.CHILDS_RM, SETTINGS.QUALITY, EVENTS.CHILD_ADD
 - [image.md](./image.md) — `LAYER_BG`: EVENTS.PRELOAD, EVENTS.SHOW

package/plugins/canvas.layers/bl.md

@@ -1,54 +1,54 @@
 # plugins/canvas.layers/bl/
 
-Пакет: `@vnejs/plugins.canvas.layers.bl` · namespace: `LAYER_BL`
+Package: `@vnejs/plugins.canvas.layers.bl` · namespace: `LAYER_BL`
 
-Фоновый canvas-слой bl: контроллер, view и команды bg/sprite/text/video.
+Back canvas layer `bl`: controller, view, and bg/sprite/text/video commands.
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.canvas.layers.bl`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.canvas.layers.bl`.
 
-| Ключ           | Строка                      | Смысл                                           |
-| -------------- | --------------------------- | ----------------------------------------------- |
-| `SHOW`         | `vne:layer_bl:show`         | Показать UI или слой.                           |
-| `HIDE`         | `vne:layer_bl:hide`         | Скрыть UI или слой.                             |
-| `UPDATE`       | `vne:layer_bl:update`       | Обновить состояние или отображение.             |
-| `UPDATE_FAST`  | `vne:layer_bl:update_fast`  | Быстрое обновление отображения.                 |
-| `UPDATE_FORCE` | `vne:layer_bl:update_force` | Перерисовать view с `isForce`, стейт не меняет. |
-| `UPDATE_STATE` | `vne:layer_bl:update_state` | Слить partial в стейт контроллера.              |
+| Key            | String                      | Meaning                                                |
+| -------------- | --------------------------- | ------------------------------------------------------ |
+| `SHOW`         | `vne:layer_bl:show`         | Show the UI or layer.                                  |
+| `HIDE`         | `vne:layer_bl:hide`         | Hide the UI or layer.                                  |
+| `UPDATE`       | `vne:layer_bl:update`       | Update state or display.                               |
+| `UPDATE_FAST`  | `vne:layer_bl:update_fast`  | Fast display update.                                   |
+| `UPDATE_FORCE` | `vne:layer_bl:update_force` | Redraw the view with `isForce`; state does not change. |
+| `UPDATE_STATE` | `vne:layer_bl:update_state` | Merge a partial into the controller state.             |
 
-## Константы
+## Constants
 
 - **`LAYER`** — "bl"
 
-## Параметры
+## Parameters
 
-| Ключ     | Тип      | Смысл                            |
-| -------- | -------- | -------------------------------- |
-| `ZINDEX` | `string` | Значение по умолчанию: "ZINDEX". |
+| Key      | Type     | Meaning            |
+| -------- | -------- | ------------------ |
+| `ZINDEX` | `string` | Default: "ZINDEX". |
 
-## Настройки
+## Settings
 
-Нет.
+None.
 
-## Модули
+## Modules
 
-| Модуль                | Зона ответственности               |
-| --------------------- | ---------------------------------- |
-| `layer.bl.controller` | Подмодуль `bl.controller` плагина. |
-| `layer.bl.props`      | Подмодуль `bl.props` плагина.      |
-| `layer.bl.bg`         | Подмодуль `bl.bg` плагина.         |
-| `layer.bl.sprite`     | Подмодуль `bl.sprite` плагина.     |
-| `layer.bl.text`       | Подмодуль `bl.text` плагина.       |
-| `layer.bl.video`      | Подмодуль `bl.video` плагина.      |
-| `layer.bl.view`       | Подмодуль `bl.view` плагина.       |
+| Module                | Role                              |
+| --------------------- | --------------------------------- |
+| `layer.bl.controller` | Plugin `bl.controller` submodule. |
+| `layer.bl.props`      | Plugin `bl.props` submodule.      |
+| `layer.bl.bg`         | Plugin `bl.bg` submodule.         |
+| `layer.bl.sprite`     | Plugin `bl.sprite` submodule.     |
+| `layer.bl.text`       | Plugin `bl.text` submodule.       |
+| `layer.bl.video`      | Plugin `bl.video` submodule.      |
+| `layer.bl.view`       | Plugin `bl.view` submodule.       |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
-— нет
+— None
 
-### Остальные
+### Other
 
-— нет
+— None