@vnejs/docs 0.2.65 → 0.2.66

package/plugins/text/locs.md

@@ -1,55 +1,55 @@
 # plugins/text/locs/
 
-Пакет: `@vnejs/plugins.text.locs` · namespace: `LOCS`
+Package: `@vnejs/plugins.text.locs` · namespace: `LOCS`
 
-Загружает словари локализации и подменяет строки текста по выбранному языку.
+Loads localization dictionaries and replaces text strings for the chosen language.
 
-Файлы: `media/locs/{lang}/{group}/{label}.json`, например `media/locs/ru/views/mainMenu.json` и `media/locs/ru/labels/prologue.json`. `LOC_LABEL` и имена сценарных меток в путь не включают группу.
+Files: `media/locs/{lang}/{group}/{label}.json`, for example `media/locs/ru/views/mainMenu.json` and `media/locs/ru/labels/prologue.json`. `LOC_LABEL` and scenario label names in the path do not include the group.
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.text.locs`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.text.locs`.
 
-| Ключ         | Строка                | Смысл                                                                                                                                                                |
-| ------------ | --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `LOAD`       | `vne:locs:load`       | Запросить данные у обработчиков и продолжить цепочку. Payload: `{ label, group, lang? }`. Без `group` файл не грузится.                                              |
-| `GET`        | `vne:locs:get`        | Получить словарь. Payload: `{ label, group, lang? }`. Без `group` — пустой объект.                                                                                   |
-| `MEMORY_GET` | `vne:locs:memory_get` | Уже загруженный словарь из памяти, без загрузки. Payload: `{ label, group, lang? }`. Без `group` — `undefined`.                                                      |
-| `MEMORY_SET` | `vne:locs:memory_set` | Записать словарь в память ядра. Payload: `{ label, group, lang?, value }`. Ключ считает модуль. Без `group` — ничего. `module` не передаётся — всегда `locs.memory`. |
-| `SET`        | `vne:locs:set`        | Применить язык: `shared.textLang` и `CHANGED`. Payload: `{ lang }`. Без `lang` — ничего.                                                                             |
-| `CHANGED`    | `vne:locs:changed`    | Зафиксировать изменение состояния.                                                                                                                                   |
+| Key          | String                | Meaning                                                                                                                                                                              |
+| ------------ | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `LOAD`       | `vne:locs:load`       | Ask handlers for data and continue the chain. Payload: `{ label, group, lang? }`. Without `group` the file is not loaded.                                                            |
+| `GET`        | `vne:locs:get`        | Get dictionary. Payload: `{ label, group, lang? }`. Without `group` — empty object.                                                                                                  |
+| `MEMORY_GET` | `vne:locs:memory_get` | Dictionary already in memory, without loading. Payload: `{ label, group, lang? }`. Without `group` — `undefined`.                                                                    |
+| `MEMORY_SET` | `vne:locs:memory_set` | Write dictionary to core memory. Payload: `{ label, group, lang?, value }`. Key is computed by the module. Without `group` — nothing. `module` is not passed — always `locs.memory`. |
+| `SET`        | `vne:locs:set`        | Apply language: `shared.textLang` and `CHANGED`. Payload: `{ lang }`. Without `lang` — nothing.                                                                                      |
+| `CHANGED`    | `vne:locs:changed`    | Record a state change.                                                                                                                                                               |
 
-## Константы
+## Constants
 
-Нет.
+None.
 
-## Параметры
+## Parameters
 
-| Ключ           | Тип      | Смысл                                                         |
-| -------------- | -------- | ------------------------------------------------------------- |
-| `DEFAULT_LANG` | `string` | Значение по умолчанию: "ru".                                  |
-| `GROUPS`       | `object` | `VIEWS: "views"`, `LABELS: "labels"` — папки после `{lang}/`. |
+| Key            | Type     | Meaning                                                         |
+| -------------- | -------- | --------------------------------------------------------------- |
+| `DEFAULT_LANG` | `string` | Default: `"ru"`.                                                |
+| `GROUPS`       | `object` | `VIEWS: "views"`, `LABELS: "labels"` — folders after `{lang}/`. |
 
-`LOCS.GET` / `LOCS.LOAD` требуют `group`. `TEXT.REPLACE` без `group` в locs-handler подставляет `GROUPS.LABELS`. View-inject (`LOC_LABEL`) берёт `GROUPS.VIEWS`.
+`LOCS.GET` / `LOCS.LOAD` require `group`. `TEXT.REPLACE` without `group` in the locs handler uses `GROUPS.LABELS`. View inject (`LOC_LABEL`) uses `GROUPS.VIEWS`.
 
-## Настройки
+## Settings
 
-| Ключ                     | Тип      | Смысл                                          |
-| ------------------------ | -------- | ---------------------------------------------- |
-| `LANG` (`vne:locs:lang`) | `string` | Настройка `vne:locs:lang` в `shared.settings`. |
+| Key                      | Type     | Meaning                                       |
+| ------------------------ | -------- | --------------------------------------------- |
+| `LANG` (`vne:locs:lang`) | `string` | Setting `vne:locs:lang` in `shared.settings`. |
 
-## Модули
+## Modules
 
-| Модуль                   | Зона ответственности                                                                                                                                                                                                        |
-| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `locs`                   | В `postinject` — `shared.textLang = PARAMS.LOCS.DEFAULT_LANG`. `SETTINGS.INIT` в `setup`. `SET` применяет язык и эмитит `CHANGED`. `init` и `SETTINGS.CHANGED` после `isReady` эмитят `SET`. Чтение словаря — `MEMORY_GET`. |
-| `locs.changed`           | `CHANGED`: если словаря меток нет — `LOAD`, затем `TEXT.RECALC` и `COMPONENTS.EXTERNAL_UPDATE`.                                                                                                                             |
-| `locs.memory`            | `MEMORY.REG` в `setup` с `module: this.name` (`locs.memory`). `MEMORY_GET` / `MEMORY_SET`.                                                                                                                                  |
-| `locs.load`              | `LOCS.LOAD`: fetch словаря, чтение и запись только через `MEMORY_GET` / `MEMORY_SET`.                                                                                                                                       |
-| `locs.components.inject` | `COMPONENTS.INJECT_REG` в `init`. `LOC_LABEL` → `LOCS.GET` с `GROUPS.VIEWS`.                                                                                                                                                |
-| `locs.text.replace`      | `TEXT.REPLACE_REG` в `init` с priority `-999999`. Без `group` — `GROUPS.LABELS`.                                                                                                                                            |
+| Module                   | Role                                                                                                                                                                                                                              |
+| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `locs`                   | In `postinject` — `shared.textLang = PARAMS.LOCS.DEFAULT_LANG`. `SETTINGS.INIT` in `setup`. `SET` applies language and emits `CHANGED`. `init` and `SETTINGS.CHANGED` after `isReady` emit `SET`. Dictionary read — `MEMORY_GET`. |
+| `locs.changed`           | `CHANGED`: if label dictionary is missing — `LOAD`, then `TEXT.RECALC` and `COMPONENTS.EXTERNAL_UPDATE`.                                                                                                                          |
+| `locs.memory`            | `MEMORY.REG` in `setup` with `module: this.name` (`locs.memory`). `MEMORY_GET` / `MEMORY_SET`.                                                                                                                                    |
+| `locs.load`              | `LOCS.LOAD`: fetch dictionary, read and write only via `MEMORY_GET` / `MEMORY_SET`.                                                                                                                                               |
+| `locs.components.inject` | `COMPONENTS.INJECT_REG` in `init`. `LOC_LABEL` → `LOCS.GET` with `GROUPS.VIEWS`.                                                                                                                                                  |
+| `locs.text.replace`      | `TEXT.REPLACE_REG` in `init` with priority `-999999`. Without `group` — `GROUPS.LABELS`.                                                                                                                                          |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
@@ -59,6 +59,6 @@ Payloads и результаты хендлеров типизированы ч
 - [settings.md](../core/settings.md) — `SETTINGS`: EVENTS.CHANGED, EVENTS.INIT
 - [system.md](../core/system.md) — `SYSTEM`: CONST.HOST
 
-### Остальные
+### Other
 
 - [text.md](./text.md) — `TEXT`: EVENTS.REPLACE_REG, EVENTS.RECALC

package/plugins/text/meet.md

@@ -1,42 +1,42 @@
 # plugins/text/meet/
 
-Пакет: `@vnejs/plugins.text.meet` · namespace: `TEXT_MEET`
+Package: `@vnejs/plugins.text.meet` · namespace: `TEXT_MEET`
 
-Увеличивает счётчик знакомств с персонажем через exec-команды meet.
+Increments meet counters for a character via meet exec commands.
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.text.meet`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.text.meet`.
 
-| Ключ   | Строка               | Смысл                                     |
-| ------ | -------------------- | ----------------------------------------- |
-| `MEET` | `vne:text_meet:meet` | Записать диагностическое сообщение в лог. |
+| Key    | String               | Meaning                                |
+| ------ | -------------------- | -------------------------------------- |
+| `MEET` | `vne:text_meet:meet` | Write a diagnostic message to the log. |
 
-## Константы
+## Constants
 
-- **`LOGS_ACTIONS.MEET`** — `"meet"`: метка лога при `MEET`.
+- **`LOGS_ACTIONS.MEET`** — `"meet"`: log label on `MEET`.
 
-## Параметры
+## Parameters
 
-Нет.
+None.
 
-## Настройки
+## Settings
 
-Нет.
+None.
 
-## Модули
+## Modules
 
-| Модуль      | Зона ответственности      |
-| ----------- | ------------------------- |
-| `text.meet` | Подмодуль `meet` плагина. |
+| Module      | Role                     |
+| ----------- | ------------------------ |
+| `text.meet` | Plugin `meet` submodule. |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
 - [logs.md](../core/logs.md) — `LOGS`: `EVENTS.LOGS.EMIT` (`action`, …)
 - [scenario.md](../core/scenario.md) — `SCENARIO`: EVENTS.NEXT, EVENTS.LINE_EXEC_REG
 
-### Остальные
+### Other
 
 - [text.md](./text.md) — `TEXT`: EVENTS.SPEAKER_INFO_UPDATE

package/plugins/text/smooth.md

@@ -1,62 +1,62 @@
 # plugins/text/smooth/
 
-Пакет: `@vnejs/plugins.text.smooth` · namespace: `TEXT_SMOOTH`
+Package: `@vnejs/plugins.text.smooth` · namespace: `TEXT_SMOOTH`
 
-Анимирует постепенный посимвольный вывод текста с настраиваемой скоростью.
+Animates gradual character-by-character text output with configurable speed.
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.text.smooth`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.text.smooth`.
 
-| Ключ      | Строка                    | Смысл                               |
-| --------- | ------------------------- | ----------------------------------- |
-| `SMOOTH`  | `vne:text:smooth`         | Событие `SMOOTH` namespace плагина. |
-| `CHANGED` | `vne:text:smooth_changed` | Зафиксировать изменение состояния.  |
-| `DONE`    | `vne:text:smooth_done`    | Событие `DONE` namespace плагина.   |
+| Key       | String                    | Meaning                          |
+| --------- | ------------------------- | -------------------------------- |
+| `SMOOTH`  | `vne:text:smooth`         | Plugin namespace event `SMOOTH`. |
+| `CHANGED` | `vne:text:smooth_changed` | Record a state change.           |
+| `DONE`    | `vne:text:smooth_done`    | Plugin namespace event `DONE`.   |
 
-## Константы
+## Constants
 
-Нет.
+None.
 
-## Параметры
+## Parameters
 
-| Ключ                         | Тип      | Смысл                      |
-| ---------------------------- | -------- | -------------------------- |
-| `DEFAULT_TOKEN_RENDER_SPEED` | `number` | Значение по умолчанию: 1.  |
-| `TOKEN_RENDER_DELAY`         | `number` | Значение по умолчанию: 16. |
+| Key                          | Type     | Meaning        |
+| ---------------------------- | -------- | -------------- |
+| `DEFAULT_TOKEN_RENDER_SPEED` | `number` | Default: `1`.  |
+| `TOKEN_RENDER_DELAY`         | `number` | Default: `16`. |
 
-## Настройки
+## Settings
 
-| Ключ                                                 | Тип      | Смысл                                  |
-| ---------------------------------------------------- | -------- | -------------------------------------- |
-| `TOKEN_RENDER_SPEED` (`vne:text:token_render_speed`) | `number` | Скорость воспроизведения или анимации. |
+| Key                                                  | Type     | Meaning                      |
+| ---------------------------------------------------- | -------- | ---------------------------- |
+| `TOKEN_RENDER_SPEED` (`vne:text:token_render_speed`) | `number` | Playback or animation speed. |
 
-## Модули
+## Modules
 
-| Модуль                 | Зона ответственности                                     |
-| ---------------------- | -------------------------------------------------------- |
-| `text.smooth.init`     | В `postinject` — `shared.isTextSmoothInProcess = false`. |
-| `text.smooth`          | Подмодуль `smooth` плагина.                              |
-| `text.smooth.process`  | Обрабатывает DONE, EMIT_PROCESS.                         |
-| `text.smooth.cycle`    | Обрабатывает SMOOTH, PROCESS_CANCEL, EMIT_END, CLEAR.    |
-| `text.smooth.emit.end` | Обрабатывает EMIT_END, RECALC_DONE.                      |
+| Module                 | Role                                                      |
+| ---------------------- | --------------------------------------------------------- |
+| `text.smooth.init`     | In `postinject` — `shared.isTextSmoothInProcess = false`. |
+| `text.smooth`          | Plugin `smooth` submodule.                                |
+| `text.smooth.process`  | Handles DONE, EMIT_PROCESS.                               |
+| `text.smooth.cycle`    | Handles SMOOTH, PROCESS_CANCEL, EMIT_END, CLEAR.          |
+| `text.smooth.emit.end` | Handles EMIT_END, RECALC_DONE.                            |
 
 ## Compatibility
 
 ### `compatibility/views.scenario.interface/text.smooth/`
 
-Пакет: `@vnejs/compatibility.views.scenario.interface-with-text.smooth`
+Package: `@vnejs/compatibility.views.scenario.interface-with-text.smooth`
 
-Связка с [interface.md](../views.scenario/interface.md): `CHANGED` → `INTERFACE.TEXT_CHANGED` (`tokens` из `globalState.text`, `tokensVisible`, `uid`). `start` сбрасывает `shared.interfaceTextShowAllTokensOnChange`.
+Link to [interface.md](../views.scenario/interface.md): `CHANGED` → `INTERFACE.TEXT_CHANGED` (`tokens` from `globalState.text`, `tokensVisible`, `uid`). `start` resets `shared.interfaceTextShowAllTokensOnChange`.
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
 - [settings.md](../core/settings.md) — `SETTINGS`: EVENTS.INIT
 - [state.md](../core/state.md) — `STATE`: EVENTS.CLEAR
 
-### Остальные
+### Other
 
 - [text.md](./text.md) — `TEXT`: EVENTS.PROCESS_CANCEL, EVENTS.EMIT_END, EVENTS.RECALC_DONE, EVENTS.EMIT_PROCESS
-- [interface.md](../views.scenario/interface.md) — `INTERFACE`: связка через compatibility выше
+- [interface.md](../views.scenario/interface.md) — `INTERFACE`: link via compatibility above

package/plugins/text/text.md

@@ -1,82 +1,88 @@
 # plugins/text/text/
 
-Пакет: `@vnejs/plugins.text.text` · namespace: `TEXT`
-
-Ядро текстовой системы: парсинг строк сценария, состояние, токены и спикеры.
-
-## События
-
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.text`.
-
-| Ключ                  | Строка                         | Смысл                                                                                                                              |
-| --------------------- | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------- |
-| `EMIT`                | `vne:text:emit`                | Начать вывод: подготовка токенов, обновление state, запуск process. С `isKeepProcessState` после `STATE_CHANGED` сразу `EMIT_END`. |
-| `EMIT_END`            | `vne:text:emit_end`            | Завершить текущий шаг; при autonext перейти к следующему. С `isKeepProcessState` не шлёт `PROCESS_STATE` и `EMIT_NEXT`.            |
-| `EMIT_NEXT`           | `vne:text:emit_next`           | Перейти к следующему шагу emit (подписки с `priority` на Observer).                                                                |
-| `EMIT_BEFORE`         | `vne:text:emit_before`         | Хук перед основным emit (подписки с `priority` на Observer).                                                                       |
-| `EMIT_PROCESS`        | `vne:text:emit_process`        | Запустить пошаговый процесс вывода.                                                                                                |
-| `PREPARE_TOKENS`      | `vne:text:prepare_tokens`      | Подготовить токены или промежуточные данные.                                                                                       |
-| `PROCESS_CANCEL`      | `vne:text:process_cancel`      | Отменить текущий процесс.                                                                                                          |
-| `PROCESS_STATE`       | `vne:text:process_state`       | Изменить состояние процесса.                                                                                                       |
-| `CHANGED`             | `vne:text:changed`             | Зафиксировать изменение состояния.                                                                                                 |
-| `SPEAKER_CHANGED`     | `vne:text:speaker_changed`     | Зафиксировать смену текущего спикера.                                                                                              |
-| `SPEAKER_INFO_UPDATE` | `vne:text:speaker_info_update` | Обновить метаданные спикера (цвет, имя, opacity).                                                                                  |
-| `STATE_UPDATE`        | `vne:text:state_update`        | Обновить накопленное состояние модуля.                                                                                             |
-| `STATE_CHANGED`       | `vne:text:state_changed`       | Сигнал об изменении накопленного состояния.                                                                                        |
-| `RECALC`              | `vne:text:recalc`              | Запросить данные у обработчиков и продолжить цепочку.                                                                              |
-| `RECALC_DONE`         | `vne:text:recalc_done`         | Завершить операцию `RECALC`.                                                                                                       |
-| `REPLACE`             | `vne:text:replace`             | Заменить текущее значение или контент.                                                                                             |
-| `REPLACE_REG`         | `vne:text:replace_reg`         | Зарегистрировать обработчик `REPLACE`.                                                                                             |
-
-## Константы
-
-- **`LINE_KEYWORDS.EXTEND`** — `"extend"`: продолжить предыдущий текст без новой реплики.
-
-## Параметры
-
-| Ключ                      | Тип       | Смысл                                        |
-| ------------------------- | --------- | -------------------------------------------- |
-| `DEFAULT_SPEAKER_NAME`    | `string`  | Имя или метаданные спикера по умолчанию.     |
-| `DEFAULT_PROCESS_ENABLED` | `boolean` | Значение по умолчанию для включения функции. |
-| `SPEAKERS_INFO`           | `object`  | Справочник метаданных спикеров по умолчанию. |
-
-## Настройки
-
-| Ключ                                       | Тип       | Смысл                           |
-| ------------------------------------------ | --------- | ------------------------------- |
-| `PROCESS_ENABLED` (`text.process_enabled`) | `boolean` | Включить или выключить функцию. |
-
-## Модули
-
-| Модуль                 | Зона ответственности                                                                                                                                              |
-| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `text.emit.end`        | Завершение emit и переход к next или финальному state. `isKeepProcessState` выходит без `PROCESS_STATE` и `EMIT_NEXT`.                                            |
-| `text.emit.next`       | На `EMIT_NEXT`: `PROCESS_STATE` NEXT, затем `onTextEmitNext` → `emit SCENARIO.NEXT` (`priority` 999999).                                                          |
-| `text.emit`            | Точка входа emit: подготовка и запуск process. `isKeepProcessState` после `STATE_CHANGED` сразу `EMIT_END`.                                                       |
-| `text.exec`            | Подмодуль `exec` плагина.                                                                                                                                         |
-| `text.prepare.tokens`  | Токенизация текста перед отображением.                                                                                                                            |
-| `text.process.state`   | В `postinject` — `shared.textProcessSkipSources`; PROCESS_STATE, SET, CLEAR.                                                                                      |
-| `text.process.enabled` | Подмодуль `process.enabled` плагина.                                                                                                                              |
-| `text.recalc`          | Пересчёт производного состояния текста.                                                                                                                           |
-| `text.replace`         | Реестр обработчиков REPLACE_REG.                                                                                                                                  |
-| `text.speaker`         | SPEAKER_INFO_UPDATE, CLEAR, SET; на `EMIT_BEFORE` (`priority` 100) — speaker.                                                                                     |
-| `text`                 | STATE_UPDATE, STATE_CHANGED, SET, CLEAR. `STATE.SET` → `TEXT.EMIT` с `isKeepProcessState`. `STATE.CLEAR` сбрасывает стейт и шлёт `TEXT.CHANGED`, без `TEXT.EMIT`. |
+Package: `@vnejs/plugins.text.text` · namespace: `TEXT`
+
+Text system core: parse scenario lines, state, tokens, and speakers.
+
+## Events
+
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.text`.
+
+| Key                   | String                         | Meaning                                                                                                                               |
+| --------------------- | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- |
+| `EMIT`                | `vne:text:emit`                | Start output: prepare tokens, update state, run process. With `isKeepProcessState` after `STATE_CHANGED` goes straight to `EMIT_END`. |
+| `EMIT_END`            | `vne:text:emit_end`            | Finish the current step; with autonext go to the next. With `isKeepProcessState` does not send `PROCESS_STATE` or `EMIT_NEXT`.        |
+| `EMIT_NEXT`           | `vne:text:emit_next`           | Go to the next emit step (subscriptions with `priority` on Observer).                                                                 |
+| `EMIT_BEFORE`         | `vne:text:emit_before`         | Hook before main emit (subscriptions with `priority` on Observer).                                                                    |
+| `EMIT_PROCESS`        | `vne:text:emit_process`        | Run step-by-step output process.                                                                                                      |
+| `PREPARE_TOKENS`      | `vne:text:prepare_tokens`      | Prepare tokens or intermediate data.                                                                                                  |
+| `PROCESS_CANCEL`      | `vne:text:process_cancel`      | Cancel the current process.                                                                                                           |
+| `PROCESS_STATE`       | `vne:text:process_state`       | Change process state.                                                                                                                 |
+| `CHANGED`             | `vne:text:changed`             | Record a state change.                                                                                                                |
+| `SPEAKER_CHANGED`     | `vne:text:speaker_changed`     | Record a change of the current speaker.                                                                                               |
+| `SPEAKER_INFO_UPDATE` | `vne:text:speaker_info_update` | Update speaker metadata (color, name, opacity).                                                                                       |
+| `STATE_UPDATE`        | `vne:text:state_update`        | Update accumulated module state.                                                                                                      |
+| `STATE_CHANGED`       | `vne:text:state_changed`       | Signal that accumulated state changed.                                                                                                |
+| `RECALC`              | `vne:text:recalc`              | Ask handlers for data and continue the chain.                                                                                         |
+| `RECALC_DONE`         | `vne:text:recalc_done`         | Finish the `RECALC` operation.                                                                                                        |
+| `REPLACE`             | `vne:text:replace`             | Replace the current value or content.                                                                                                 |
+| `REPLACE_REG`         | `vne:text:replace_reg`         | Register a `REPLACE` handler.                                                                                                         |
+
+## Constants
+
+- **`LINE_KEYWORDS.EXTEND`** — `"extend"`: continue previous text without a new line.
+
+## Parameters
+
+| Key                       | Type      | Meaning                             |
+| ------------------------- | --------- | ----------------------------------- |
+| `DEFAULT_SPEAKER_NAME`    | `string`  | Default speaker name or metadata.   |
+| `DEFAULT_PROCESS_ENABLED` | `boolean` | Default for enabling the feature.   |
+| `SPEAKERS_INFO`           | `object`  | Default speaker metadata directory. |
+
+## Settings
+
+| Key                                        | Type      | Meaning            |
+| ------------------------------------------ | --------- | ------------------ |
+| `PROCESS_ENABLED` (`text.process_enabled`) | `boolean` | Enable or disable. |
+
+## Modules
+
+| Module                 | Role                                                                                                                                                               |
+| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `text.emit.end`        | Finish emit and go to next or final state. `isKeepProcessState` exits without `PROCESS_STATE` and `EMIT_NEXT`.                                                     |
+| `text.emit.next`       | On `EMIT_NEXT`: `PROCESS_STATE` NEXT, then `onTextEmitNext` → `emit SCENARIO.NEXT` (`priority` 999999).                                                            |
+| `text.emit`            | Emit entry: prepare and run process. `isKeepProcessState` after `STATE_CHANGED` goes straight to `EMIT_END`.                                                       |
+| `text.exec`            | Plugin `exec` submodule.                                                                                                                                           |
+| `text.prepare.tokens`  | Tokenize text before display.                                                                                                                                      |
+| `text.process.state`   | In `postinject` — `shared.textProcessSkipSources`; PROCESS_STATE, SET, CLEAR.                                                                                      |
+| `text.process.enabled` | Plugin `process.enabled` submodule.                                                                                                                                |
+| `text.recalc`          | Recalculate derived text state.                                                                                                                                    |
+| `text.replace`         | `REPLACE_REG` handler registry.                                                                                                                                    |
+| `text.speaker`         | SPEAKER_INFO_UPDATE, CLEAR, SET; on `EMIT_BEFORE` (`priority` 100) — speaker.                                                                                      |
+| `text`                 | STATE_UPDATE, STATE_CHANGED, SET, CLEAR. `STATE.SET` → `TEXT.EMIT` with `isKeepProcessState`. `STATE.CLEAR` resets state and sends `TEXT.CHANGED`, no `TEXT.EMIT`. |
 
 ## Compatibility
 
 ### `compatibility/views.scenario.interface/text/`
 
-Пакет: `@vnejs/compatibility.views.scenario.interface-with-text`
+Package: `@vnejs/compatibility.views.scenario.interface-with-text`
 
-Связка с [interface.md](../views.scenario/interface.md): `CHANGED` / `SPEAKER_CHANGED` / `EMIT_BEFORE` → `INTERFACE.TEXT_CHANGED` / `SPEAKER_CHANGED` / `SHOW`. В `postinject` ставит `shared.interfaceTextShowAllTokensOnChange`.
+Link to [interface.md](../views.scenario/interface.md): `CHANGED` / `SPEAKER_CHANGED` / `EMIT_BEFORE` → `INTERFACE.TEXT_CHANGED` / `SPEAKER_CHANGED` / `SHOW`. In `postinject` sets `shared.interfaceTextShowAllTokensOnChange`.
 
 ### `compatibility/text/scenario.history/`
 
-Пакет: `@vnejs/compatibility.text-with-scenario.history`
+Package: `@vnejs/compatibility.text-with-scenario.history`
 
-На `EMIT_NEXT` эмитит `HISTORY.ADD` с текстом последней реплики. Маркеры `{…}` в строке остаются: по ним ищется перевод. Подключается в `bundles/vn.skeleton`.
+On `EMIT_NEXT` emits `HISTORY.ADD` with text from the last line. `{…}` markers in the line stay: translation is looked up by them. Wired in `bundles/vn.skeleton`.
 
-## Близкие плагины
+### `compatibility/scenario.choose/text/`
+
+Package: `@vnejs/compatibility.scenario.choose-with-text`
+
+Link to [choose.md](../scenario/choose.md): `OPTION_TEXT` handler returns `TEXT.REPLACE`. Wired in `bundles/vn.skeleton`.
+
+## Related plugins
 
 ### plugins/core/
 
@@ -85,7 +91,8 @@ Payloads и результаты хендлеров типизированы ч
 - [settings.md](../core/settings.md) — `SETTINGS`: EVENTS.CHANGED, EVENTS.INIT
 - [state.md](../core/state.md) — `STATE`: EVENTS.SET, EVENTS.CLEAR
 
-### Остальные
+### Other
 
-- [interface.md](../views.scenario/interface.md) — `INTERFACE`: связка через compatibility выше
-- [history.md](../scenario/history.md) — `HISTORY`: `EMIT_NEXT` → `ADD` (compatibility выше)
+- [interface.md](../views.scenario/interface.md) — `INTERFACE`: link via compatibility above
+- [history.md](../scenario/history.md) — `HISTORY`: `EMIT_NEXT` → `ADD` (compatibility above)
+- [choose.md](../scenario/choose.md) — `CHOOSE`: `OPTION_TEXT` → `REPLACE` (compatibility above)

package/plugins/text/wall.md

@@ -1,43 +1,43 @@
 # plugins/text/wall/
 
-Пакет: `@vnejs/plugins.text.wall` · namespace: `TEXT_WALL`
+Package: `@vnejs/plugins.text.wall` · namespace: `TEXT_WALL`
 
-Накапливает историю реплик («стену текста») с командами start, end и clear.
+Accumulates line history (a "text wall") with start, end, and clear commands.
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.text.wall`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.text.wall`.
 
-| Ключ           | Строка                       | Смысл                              |
-| -------------- | ---------------------------- | ---------------------------------- |
-| `STATE_UPDATE` | `vne:text_wall:state_update` | Обновить накопленное состояние.    |
-| `CHANGED`      | `vne:text_wall:changed`      | Зафиксировать изменение состояния. |
+| Key            | String                       | Meaning                   |
+| -------------- | ---------------------------- | ------------------------- |
+| `STATE_UPDATE` | `vne:text_wall:state_update` | Update accumulated state. |
+| `CHANGED`      | `vne:text_wall:changed`      | Record a state change.    |
 
-## Константы
+## Constants
 
-Нет.
+None.
 
-## Параметры
+## Parameters
 
-Нет.
+None.
 
-## Настройки
+## Settings
 
-Нет.
+None.
 
-## Модули
+## Modules
 
-| Модуль      | Зона ответственности                                                               |
-| ----------- | ---------------------------------------------------------------------------------- |
-| `text.wall` | В `postinject` — `shared.isTextWallSetStateInProcess = false`; RECALC, CLEAR, SET. |
+| Module      | Role                                                                                |
+| ----------- | ----------------------------------------------------------------------------------- |
+| `text.wall` | In `postinject` — `shared.isTextWallSetStateInProcess = false`; RECALC, CLEAR, SET. |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
 - [scenario.md](../core/scenario.md) — `SCENARIO`: EVENTS.NEXT, EVENTS.LINE_EXEC_REG
 - [state.md](../core/state.md) — `STATE`: EVENTS.CLEAR, EVENTS.SET
 
-### Остальные
+### Other
 
 - [text.md](./text.md) — `TEXT`: EVENTS.RECALC, EVENTS.EMIT_BEFORE, EVENTS.REPLACE

package/plugins/time/date.md

@@ -1,44 +1,44 @@
 # plugins/time/date/
 
-Пакет: `@vnejs/plugins.time.date` · namespace: `DATE`
+Package: `@vnejs/plugins.time.date` · namespace: `DATE`
 
-Хранит и изменяет игровую дату: установка и смещение дней, месяцев и лет.
+Stores and changes game date: set and shift days, months, and years.
 
-## События
+## Events
 
-Payloads и результаты хендлеров типизированы через module augmentation контракта (`VneEventPayloadMap` / `VneEventResultMap`); типы — в `@vnejs/contracts.time.date`.
+Handler payloads and results are typed through module augmentation of the contract (`VneEventPayloadMap` / `VneEventResultMap`). The types live in `@vnejs/contracts.time.date`.
 
-| Ключ      | Строка             | Смысл                              |
-| --------- | ------------------ | ---------------------------------- |
-| `SET`     | `vne:date:set`     | Записать или обновить значение.    |
-| `ADD`     | `vne:date:add`     | Событие `ADD` namespace плагина.   |
-| `CHANGED` | `vne:date:changed` | Зафиксировать изменение состояния. |
+| Key       | String             | Meaning                       |
+| --------- | ------------------ | ----------------------------- |
+| `SET`     | `vne:date:set`     | Write or update a value.      |
+| `ADD`     | `vne:date:add`     | Plugin namespace event `ADD`. |
+| `CHANGED` | `vne:date:changed` | Record a state change.        |
 
-## Константы
+## Constants
 
-Нет.
+None.
 
-## Параметры
+## Parameters
 
-Нет.
+None.
 
-## Настройки
+## Settings
 
-Нет.
+None.
 
-## Модули
+## Modules
 
-| Модуль | Зона ответственности          |
-| ------ | ----------------------------- |
-| `date` | Обрабатывает SET, ADD, CLEAR. |
+| Module | Role                     |
+| ------ | ------------------------ |
+| `date` | Handles SET, ADD, CLEAR. |
 
-## Близкие плагины
+## Related plugins
 
 ### plugins/core/
 
 - [scenario.md](../core/scenario.md) — `SCENARIO`: EVENTS.NEXT, EVENTS.LINE_EXEC_REG
 - [state.md](../core/state.md) — `STATE`: EVENTS.SET, EVENTS.CLEAR
 
-### Остальные
+### Other
 
-— нет
+— None