@vnejs/docs 0.2.49 → 0.2.50

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 Краткая история изменений движка (плагины, helpers, packages, CLI и прочий runtime) и внешнего API. Версии — релизы пакета `@vnejs/docs`.
 
+## 0.2.50
+
+- `observer` — `SubscriberOptions.priority` (default `0`); группы хендлеров собираются в `subscribe`, `emit` обходит их по возрастанию priority (внутри группы — параллельно); ответы со всех групп. API: `SubscriberOptions.priority`, `SubscriberGroup`.
+- `module.handlers` — пакет `@vnejs/module.handlers` / `ModuleHandlers` снят; вместо `*_REG` — `on(event, handler, { priority })`.
+- `text/text` — сняты `EMIT_BEFORE_REG` / `EMIT_NEXT_REG` и модуль `text.emit.before`; подписки на `EMIT_BEFORE` / `EMIT_NEXT` с `priority`. API: сняты `EVENTS.TEXT.EMIT_BEFORE_REG`, `EVENTS.TEXT.EMIT_NEXT_REG`.
+- `scenario/choose` — сняты `OPTION_BEFORE_REG` и модуль `choose.option.before`; подписка на `OPTION_BEFORE` с `priority`. API: снято `EVENTS.CHOOSE.OPTION_BEFORE_REG`.
+
 ## 0.2.49
 
 - `cli/monorepo` — при падении `run-changed` / `publish` в ошибке видны пакет, путь и exit code (и `!!!` в stderr у `publish`), а не только `N package script(s) failed`.

package/architecture.md

@@ -97,15 +97,15 @@ flowchart BT
   SH --> ME
 ```
 
-| Пакет                    | Назначение                                                                                                  |
-| ------------------------ | ----------------------------------------------------------------------------------------------------------- |
-| **`@vnejs/shared`**      | Реестр **`VNE`**, массив **`VNE_MODULES`**, **`regPlugin`** / **`regModule`**, типы для module augmentation |
-| **`@vnejs/observer`**    | **`Observer`** — pub/sub: `subscribe`, `emit`, `emitOne`, `emitReal`, `emitReals`                           |
-| **`@vnejs/core`**        | **`VneCore`**: модули из `VNE_MODULES`, lifecycle, загрузка `mods.json` / `media_info/`, `reset`            |
-| **`@vnejs/constants`**   | Общие константы-заглушки (`EMPTY_OBJECT`, `EMPTY_ARRAY`)                                                    |
-| **`@vnejs/sources-set`** | **`SourcesSet`** — управление множеством «источников» (text и связанная логика)                             |
-| **`@vnejs/semaphore`**   | **`Semaphore`** — очередь задач с весами и ограничением параллелизма                                        |
-| **`@vnejs/test-utils`**  | Harness для тестов модулей: observer stubs, `createTestModule`, spies, DOM mocks                            |
+| Пакет                    | Назначение                                                                                                              |
+| ------------------------ | ----------------------------------------------------------------------------------------------------------------------- |
+| **`@vnejs/shared`**      | Реестр **`VNE`**, массив **`VNE_MODULES`**, **`regPlugin`** / **`regModule`**, типы для module augmentation             |
+| **`@vnejs/observer`**    | **`Observer`** — pub/sub: `subscribe` / `emit` с `priority` (группы по возрастанию), `emitOne`, `emitReal`, `emitReals` |
+| **`@vnejs/core`**        | **`VneCore`**: модули из `VNE_MODULES`, lifecycle, загрузка `mods.json` / `media_info/`, `reset`                        |
+| **`@vnejs/constants`**   | Общие константы-заглушки (`EMPTY_OBJECT`, `EMPTY_ARRAY`)                                                                |
+| **`@vnejs/sources-set`** | **`SourcesSet`** — управление множеством «источников» (text и связанная логика)                                         |
+| **`@vnejs/semaphore`**   | **`Semaphore`** — очередь задач с весами и ограничением параллелизма                                                    |
+| **`@vnejs/test-utils`**  | Harness для тестов модулей: observer stubs, `createTestModule`, spies, DOM mocks                                        |
 
 ### Принципы
 
@@ -126,7 +126,6 @@ flowchart BT
 flowchart TD
   M["@vnejs/module<br/>Module"]
   MC["@vnejs/module.core<br/>ModuleCore"]
-  MH["@vnejs/module.handlers<br/>ModuleHandlers"]
   MR["@vnejs/module.replace<br/>ModuleReplace"]
   MRE["@vnejs/module.replace.exec<br/>ModuleReplaceExec"]
   MCO["@vnejs/module.components<br/>ModuleController, ModuleView"]
@@ -147,7 +146,6 @@ flowchart TD
   MSC["@vnejs/module.scales.common"]
 
   M --> MC
-  MC --> MH
   MC --> MR
   MC --> MRE
   MC --> MCO
@@ -172,7 +170,6 @@ flowchart TD
 | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- |
 | **`@vnejs/module`**                              | **`Module`**: `VNE`, `on`/`emit`, `inject`, state, shared, media, lifecycle                                                                       |
 | **`@vnejs/module.core`**                         | **`ModuleCore`** — типизированный доступ к **core-контрактам**; `emitLog`, `emitNext`, …                                                          |
-| **`@vnejs/module.handlers`**                     | **`ModuleHandlers`** — параллельные обработчики emit-событий с приоритетами (side effects)                                                        |
 | **`@vnejs/module.replace`**                      | **`ModuleReplace`** — последовательная подмена значения поля payload через `REPLACE_KEY` и цепочку handlers                                       |
 | **`@vnejs/module.replace.exec`**                 | **`ModuleReplaceExec`** — реестр exec-handlers по имени модуля (`EXEC_REG` / `EXEC_GET`)                                                          |
 | **`@vnejs/module.components`**                   | **`ModuleView`**, **`ModuleController`** — React-view, zustand, media, controls                                                                   |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vnejs/docs",
-  "version": "0.2.49",
+  "version": "0.2.50",
   "description": "VNEJS documentation for engine consumers and coding agents",
   "files": [
     "*.md",

package/plugins/scenario/choose.md

@@ -32,8 +32,7 @@ Payloads и результаты хендлеров типизированы ч
 | -------------------- | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
 | `EMIT`               | `vne:choose:emit`               | Принять опции и args; если есть видимые — `STATE_UPDATE` и `SHOW`; иначе `SKIP`.                                                      |
 | `OPTION`             | `vne:choose:option`             | Принять выбор по UI-индексу: прогнать `OPTION_BEFORE`, затем `HIDE`, `OPTION_REPLACE`, установить `curLine`, сброс state, `emitNext`. |
-| `OPTION_BEFORE`      | `vne:choose:option_before`      | Side effects до применения выбора (handlers с приоритетами; `ModuleHandlers`).                                                        |
-| `OPTION_BEFORE_REG`  | `vne:choose:option_before_reg`  | Зарегистрировать обработчик `OPTION_BEFORE`.                                                                                          |
+| `OPTION_BEFORE`      | `vne:choose:option_before`      | Side effects до применения выбора (подписки с `priority` на Observer).                                                                |
 | `OPTION_REPLACE`     | `vne:choose:option_replace`     | Подменить UI-индекс принятой опции (цепочка handlers перед переходом по ветке).                                                       |
 | `OPTION_REPLACE_REG` | `vne:choose:option_replace_reg` | Зарегистрировать обработчик `OPTION_REPLACE`.                                                                                         |
 | `SKIP`               | `vne:choose:skip`               | Пропустить блок: `curLine` на первую строку после indent-дерева `% choose`, `emitNext`.                                               |
@@ -67,7 +66,6 @@ Payloads и результаты хендлеров типизированы ч
 | `choose.option`          | Обрабатывает `OPTION`.                                                                  |
 | `choose.skip`            | Обрабатывает `SKIP` через `getBlockSkipShift`.                                          |
 | `choose.logs`            | Логирование `EMIT` / `OPTION` / `SKIP` / `SHOW` / `HIDE`.                               |
-| `choose.option.before`   | Реестр обработчиков `OPTION_BEFORE_REG`; наследник `@vnejs/module.handlers`.            |
 | `choose.replace`         | Реестр обработчиков `OPTION_REPLACE_REG`; наследник `@vnejs/module.replace`.            |
 | `choose.exec`            | Реестр обработчиков EXEC_REG / EXEC_GET.                                                |
 | `choose.scenario`        | Регистрация `% choose`: сбор option-строк через `getBlockOptions`, emit `EMIT`.         |
@@ -80,13 +78,13 @@ Payloads и результаты хендлеров типизированы ч
 
 Пакет: `@vnejs/compatibility.scenario.choose-with-scenario.fastforward`
 
-В `init` регистрирует handler на `OPTION_BEFORE_REG`: при выборе опции эмитит `FASTFORWARD.CHECK` (до `HIDE` / `OPTION_REPLACE`).
+В `subscribe` слушает `OPTION_BEFORE`: при выборе опции эмитит `FASTFORWARD.CHECK` (до `HIDE` / `OPTION_REPLACE`).
 
 ### `compatibility/scenario.choose/scenario.history/`
 
 Пакет: `@vnejs/compatibility.scenario.choose-with-scenario.history`
 
-В `init` регистрирует handler на `OPTION_BEFORE_REG`: при выборе опции эмитит `HISTORY.ADD` с `{ locKey: "choice" }` (без speaker/text). Текст строки берётся из локализации экрана history (`history.json`). Подключается в `bundles/vn.skeleton`.
+В `subscribe` слушает `OPTION_BEFORE`: при выборе опции эмитит `HISTORY.ADD` с `{ locKey: "choice" }` (без speaker/text). Текст строки берётся из локализации экрана history (`history.json`). Подключается в `bundles/vn.skeleton`.
 
 ### `compatibility/scenario.choose/scenario.qte/`
 
@@ -107,7 +105,7 @@ Payloads и результаты хендлеров типизированы ч
 
 - [text.md](../text/text.md) — `TEXT`: EVENTS.REPLACE (текст опций)
 - [qte.md](./qte.md) — `QTE`: связка через `OPTION_REPLACE` (compatibility выше)
-- [fastforward.md](./fastforward.md) — `FASTFORWARD`: связка через `OPTION_BEFORE_REG` (compatibility выше)
-- [history.md](./history.md) — `HISTORY`: связка через `OPTION_BEFORE_REG` → `ADD` с `locKey` (compatibility выше)
+- [fastforward.md](./fastforward.md) — `FASTFORWARD`: связка через `OPTION_BEFORE` (compatibility выше)
+- [history.md](./history.md) — `HISTORY`: связка через `OPTION_BEFORE` → `ADD` с `locKey` (compatibility выше)
 - [views.scenario/choose.md](../views.scenario/choose.md) — `CHOOSE_VIEW`: UI выбора (слушает SHOW / HIDE)
 - [scenario/point_and_click.md](./point_and_click.md) — тот же паттерн `repeat` / `SKIP` / `SHOW` / `HIDE` / `STATE_UPDATE`

package/plugins/scenario/fastforward.md

@@ -71,4 +71,4 @@ Payloads и результаты хендлеров типизированы ч
 
 ### Остальные
 
-- [choose.md](./choose.md) — `CHOOSE`: связка через `compatibility/scenario.choose/scenario.fastforward` (`OPTION_BEFORE_REG` → `FASTFORWARD.CHECK`)
+- [choose.md](./choose.md) — `CHOOSE`: связка через `compatibility/scenario.choose/scenario.fastforward` (`OPTION_BEFORE` → `FASTFORWARD.CHECK`)

package/plugins/scenario/history.md

@@ -59,7 +59,7 @@ Payloads и результаты хендлеров типизированы ч
 
 Пакет: `@vnejs/compatibility.scenario.choose-with-scenario.history`
 
-На `CHOOSE.OPTION_BEFORE_REG` эмитит `HISTORY.ADD` с `{ locKey: "choice" }`. Перевод строки — ключ `choice` в `history.json` экрана. Подключается в `bundles/vn.skeleton`.
+На `CHOOSE.OPTION_BEFORE` эмитит `HISTORY.ADD` с `{ locKey: "choice" }`. Перевод строки — ключ `choice` в `history.json` экрана. Подключается в `bundles/vn.skeleton`.
 
 ## Близкие плагины
 
@@ -73,5 +73,5 @@ Payloads и результаты хендлеров типизированы ч
 ### Остальные
 
 - [text.md](../text/text.md) — `TEXT`: `EMIT_NEXT` → `ADD` (compatibility выше)
-- [choose.md](./choose.md) — `CHOOSE`: `OPTION_BEFORE_REG` → `ADD` (compatibility выше)
+- [choose.md](./choose.md) — `CHOOSE`: `OPTION_BEFORE` → `ADD` (compatibility выше)
 - [views.screens/history.md](../views.screens/history.md) — `HISTORY_VIEW`: экран журнала (`SHOW` / `HIDE`); читает `GET` / `KEYS` / `LOAD`

package/plugins/text/text.md

@@ -12,10 +12,8 @@ Payloads и результаты хендлеров типизированы ч
 | --------------------- | ------------------------------ | ------------------------------------------------------------------- |
 | `EMIT`                | `vne:text:emit`                | Начать вывод: подготовка токенов, обновление state, запуск process. |
 | `EMIT_END`            | `vne:text:emit_end`            | Завершить текущий шаг; при autonext перейти к следующему.           |
-| `EMIT_NEXT`           | `vne:text:emit_next`           | Перейти к следующему шагу emit.                                     |
-| `EMIT_NEXT_REG`       | `vne:text:emit_next_reg`       | Зарегистрировать обработчик `EMIT_NEXT`.                            |
-| `EMIT_BEFORE`         | `vne:text:emit_before`         | Хук перед основным emit.                                            |
-| `EMIT_BEFORE_REG`     | `vne:text:emit_before_reg`     | Зарегистрировать обработчик `EMIT_BEFORE`.                          |
+| `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`      | Отменить текущий процесс.                                           |
@@ -50,20 +48,19 @@ Payloads и результаты хендлеров типизированы ч
 
 ## Модули
 
-| Модуль                 | Зона ответственности                                                         |
-| ---------------------- | ---------------------------------------------------------------------------- |
-| `text.emit.before`     | Подмодуль `emit.before` плагина.                                             |
-| `text.emit.end`        | Завершение emit и переход к next или финальному state.                       |
-| `text.emit.next`       | Подмодуль `emit.next` плагина.                                               |
-| `text.emit`            | Точка входа emit: подготовка и запуск process.                               |
-| `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.                                |
-| `text`                 | Обрабатывает STATE_UPDATE, STATE_CHANGED, CLEAR, SET.                        |
+| Модуль                 | Зона ответственности                                                          |
+| ---------------------- | ----------------------------------------------------------------------------- |
+| `text.emit.end`        | Завершение emit и переход к next или финальному state.                        |
+| `text.emit.next`       | На `EMIT_NEXT`: `PROCESS_STATE` NEXT, затем `emitNext` (`priority` 999999).   |
+| `text.emit`            | Точка входа emit: подготовка и запуск process.                                |
+| `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, CLEAR, SET.                         |
 
 ## Compatibility
 

package/plugins/text/wall.md

@@ -41,4 +41,4 @@ Payloads и результаты хендлеров типизированы ч
 
 ### Остальные
 
-- [text.md](./text.md) — `TEXT`: EVENTS.RECALC, EVENTS.EMIT_BEFORE_REG, EVENTS.REPLACE
+- [text.md](./text.md) — `TEXT`: EVENTS.RECALC, EVENTS.EMIT_BEFORE, EVENTS.REPLACE

package/plugins/views.scenario/interface.md

@@ -85,6 +85,6 @@ Payloads и результаты хендлеров типизированы ч
 ### Остальные
 
 - [controls.md](../controls/controls.md) — `CONTROLS`: EVENTS.POP, EVENTS.PUSH
-- [text.md](../text/text.md) — `TEXT`: связка через compatibility выше (`CHANGED`, `SPEAKER_CHANGED`, `EMIT_BEFORE_REG`)
+- [text.md](../text/text.md) — `TEXT`: связка через compatibility выше (`CHANGED`, `SPEAKER_CHANGED`, `EMIT_BEFORE`)
 - [choose.md](./choose.md) — compatibility скрывает interface на `CHOOSE_VIEW.SHOW_BEFORE`
 - [qte.md](./qte.md) — compatibility скрывает interface на `QTE_VIEW.SHOW_BEFORE`