@vnejs/docs 0.2.3 → 0.2.5

package/package.json

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

package/plugins/core/scenario.md

@@ -35,13 +35,20 @@
 
 Нет.
 
+## Shared
+
+| Поле | Тип | Смысл |
+|------|-----|--------|
+| `shouldAutostartScenario` | `boolean` | На `SYSTEM.STARTED` модуль `scenario.autostart` эмитит `LABEL_GET` (init) и `NEXT`, только если не `false`. В `init` ставится `true` через `??=`; другие плагины могут выставить `false`. `STATE.CLEAR` по-прежнему грузит init label в `scenario.label` без этого гейта. |
+
 ## Модули
 
 | Модуль | Зона ответственности |
 |--------|----------------------|
-| `scenario` | Главный цикл `NEXT`, exec строк, sync state, старт на `SYSTEM.STARTED`. |
+| `scenario` | Главный цикл `NEXT`, exec строк, sync state. |
+| `scenario.autostart` | Дефолт `shared.shouldAutostartScenario`; на `SYSTEM.STARTED` — init label + `emitNext` при включённом флаге. |
 | `scenario.exec` | Dispatch `$module` / `%block`, registry handlers, `EXEC_DELAY`. |
-| `scenario.label` | `LABEL_GET`, preload меток, init label на старте/clear. |
+| `scenario.label` | `LABEL_GET`, preload меток; init label на `STATE.CLEAR`. |
 | `scenario.line` | `LINE_LOAD` / `LINE_GET`, registry preload handlers. |
 | `scenario.lines` | Fetch `label.*.json` с `HOST`. |
 
@@ -60,4 +67,4 @@
 
 ### Остальные
 
-— нет
+- [electron.md](../platform/electron.md) — `ELECTRON`: при reload выставляет `shared.shouldAutostartScenario = false`

package/plugins/platform/electron.md

@@ -24,13 +24,14 @@
 
 | Модуль | Зона ответственности |
 |--------|----------------------|
-| `electron` | Обрабатывает CHANGED, STARTED, CLOSE_BEFORE. |
+| `electron` | Синхронизирует remote storage; при изменении и cooldown ≥ 10 с (метка в `sessionStorage`) ставит `shouldReload` + `shared.shouldAutostartScenario = false`; на `STARTED` эмитит `RELOAD`; обрабатывает CHANGED / CLOSE_BEFORE. |
 
 ## Близкие плагины
 
 ### plugins/core/
 
 - [platforms.md](../core/platforms.md) — `PLATFORMS`: CONST.ELECTRON, PARAMS.CURRENT_PLATFORM
+- [scenario.md](../core/scenario.md) — `SCENARIO`: `shared.shouldAutostartScenario` (отключает автостарт перед reload)
 - [storage.md](../core/storage.md) — `STORAGE`: EVENTS.CHANGED, EVENTS.SET_ALL, EVENTS.GET_ALL
 - [system.md](../core/system.md) — `SYSTEM`: EVENTS.STARTED, EVENTS.CLOSE_BEFORE, EVENTS.RELOAD, CONST.HOST
 - [vendors.md](../core/vendors.md) — `VENDORS`: EVENTS.DEBOUNCE

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` | Сброс/дефолты настроек (по плагину) |