@vnejs/docs 0.2.4 → 0.2.6

package/architecture.md

@@ -101,7 +101,7 @@ flowchart BT
 |-------|------------|
 | **`@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, `reset` |
+| **`@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`** — очередь задач с весами и ограничением параллелизма |
@@ -397,6 +397,9 @@ games/<name>/
 ├── game/<mod>/      # scenario (.vne), scripts, media, public
 ├── desktop/         # Electron dev/prod
 ├── dist/            # JSON + JS после сборки
+│   ├── mods.json
+│   ├── label/       # label/<path>.json (например label/prologue/1.json)
+│   └── media_info/  # media_info/<mod>.json (не путать с /media/ ассетов)
 └── package.json
 ```
 
@@ -404,7 +407,7 @@ games/<name>/
 flowchart LR
   SC["game/**/*.vne"]
   DATA["build data"]
-  JSON["dist/*.json"]
+  JSON["dist mods.json label/ media_info/"]
   ENTRY["entry/index.ts"]
   CLIENT["build client"]
   DIST["dist/"]
@@ -417,7 +420,7 @@ flowchart LR
   SRV --> RUN
 ```
 
-1. **`build:data`** — JSON для **`VneCore.init()`** (`mods.json`, labels, media).
+1. **`build:data`** — JSON для **`VneCore.init()`**: `mods.json`, `label/<path>.json`, `media_info/<mod>.json`.
 2. **`build:client`** — Vite + `bundles/`.
 3. **`entry/`** — `new VneCore()`, `await init()`.
 

package/package.json

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

package/plugins/core/scenario.md

@@ -50,7 +50,7 @@
 | `scenario.exec` | Dispatch `$module` / `%block`, registry handlers, `EXEC_DELAY`. |
 | `scenario.label` | `LABEL_GET`, preload меток; init label на `STATE.CLEAR`. |
 | `scenario.line` | `LINE_LOAD` / `LINE_GET`, registry preload handlers. |
-| `scenario.lines` | Fetch `label.*.json` с `HOST`. |
+| `scenario.lines` | Fetch `label/<path>.json` с `HOST` (например `label/prologue/1.json`). |
 
 ## Близкие плагины
 

package/plugins/views.screens/disclaimer.md

@@ -0,0 +1,69 @@
+# plugins/views.screens/disclaimer/
+
+Пакет: `@vnejs/plugins.views.screens.disclaimer` · namespace: `DISCLAIMER`
+
+Полноэкранный дисклеймер по сценарной команде: заголовок, текст и кнопка принятия. Затемнение без фоновой картинки. Принятие не сохраняется — экран показывается при каждом вызове.
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `SHOW` | `vne:disclaimer:show` | Показать UI. Payload: `{ id }`. |
+| `HIDE` | `vne:disclaimer:hide` | Скрыть UI. |
+| `UPDATE` | `vne:disclaimer:update` | Обновить состояние или отображение. |
+| `ACCEPT` | `vne:disclaimer:accept` | Пользователь принял дисклеймер → HIDE → next. |
+
+## Константы
+
+Нет.
+
+## Параметры
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `TRANSITION` | `number` | Длительность анимации экрана. |
+| `ZINDEX` | `number` | z-index экрана. |
+| `LOC_LABEL` | `string` | Метка локализации (`disclaimer`). |
+| `VIEW_PROPS` | `object` | Layout: screen (`withDark`/`withBlur`), title, text, controls. |
+
+## Настройки
+
+Нет.
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `disclaimer.controller` | SHOW/HIDE, controls ACCEPT/INTERACT → ACCEPT. |
+| `disclaimer` | `$ disclaimer show <id>` → SHOW; ACCEPT → HIDE → emitNext. |
+| `disclaimer.view` | React UI: title / text / accept из locs. |
+
+## Локализация
+
+Файл `media/locs/{lang}/disclaimer.json`. Ключи:
+
+| Ключ | Смысл |
+|------|-------|
+| `accept` | Текст кнопки |
+| `{id}.title` | Заголовок для id |
+| `{id}.text` | Текст для id (можно многострочный через `\n`) |
+
+## Сценарий
+
+```vne
+$ disclaimer show setting
+$ disclaimer show qte
+```
+
+## Близкие плагины
+
+### plugins/core/
+
+- [logs.md](../core/logs.md) — `LOGS`: emitLog
+- [scenario.md](../core/scenario.md) — `SCENARIO`: emitNext, EVENTS.LINE_EXEC_REG
+
+### Остальные
+
+- [controls.md](../controls/controls.md) — `CONTROLS`: CONST.BUTTONS.ACCEPT, CONST.BUTTONS.INTERACT
+- [intro.md](./intro.md) — `INTRO`: похожий сценарный экран
+- [confirm.md](./confirm.md) — `CONFIRM`: затемнение и кнопки

package/scenario.catalog/index.md

@@ -56,6 +56,7 @@
 |---------|--------|------|
 | `$ interface` | `show`, `hide`, `view` | [interface.md](./stubs/interface.md) |
 | `$ intro` | интро | [intro.md](./stubs/intro.md) |
+| `$ disclaimer` | `show` + id | [disclaimer.md](./stubs/disclaimer.md) |
 | `$ mainmenu` | главное меню | [mainmenu.md](./stubs/mainmenu.md) |
 | `$ credits` | `show`, `hide` | [credits.md](./stubs/credits.md) |
 | `$ settings.defaults` | дефолты настроек | [settings.defaults.md](./stubs/settings.defaults.md) |

package/scenario.catalog/stubs/disclaimer.md

@@ -0,0 +1,17 @@
+# $ disclaimer
+
+| | |
+|--|--|
+| Тип | `module` (`$`) |
+| Сигнатура | `$ disclaimer <action> <id>` |
+| Actions / args | `show` + `<id>` — ключ текстов в `disclaimer` locs |
+| Plugin doc | [views.screens/disclaimer.md](../plugins/views.screens/disclaimer.md) |
+
+## Примеры
+
+```vne
+$ disclaimer show setting
+$ disclaimer show qte
+```
+
+Source of truth: `SCENARIO_COMMANDS` в соответствующем `contracts/**/commands.ts`.

package/scenario.guide/views.md

@@ -14,6 +14,7 @@ $ interface view adv
 
 ```vne
 $ intro
+$ disclaimer show setting
 $ mainmenu
 $ credits show
 $ credits hide
@@ -23,6 +24,7 @@ $ settings.defaults
 | Команда | Смысл |
 |---------|--------|
 | `$ intro` | Интро-экран |
+| `$ disclaimer show <id>` | Дисклеймер (title/text/accept по id из locs) |
 | `$ mainmenu` | Главное меню |
 | `$ credits show` / `hide` | Титры |
 | `$ settings.defaults` | Сброс/дефолты настроек (по плагину) |