@vnejs/docs 0.2.1

package/plugins/views.screens/settings.defaults.md

@@ -0,0 +1,51 @@
+# plugins/views.screens/settings.defaults/
+
+Пакет: `@vnejs/plugins.views.screens.settings.defaults` · namespace: `SETTINGS_DEFAULTS`
+
+Экран выбора настроек по умолчанию при первом запуске сценария.
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `UPDATE` | `vne:settings_defaults:update` | Обновить состояние или отображение. |
+| `SHOW` | `vne:settings_defaults:show` | Показать UI или слой. |
+| `HIDE` | `vne:settings_defaults:hide` | Скрыть UI или слой. |
+| `CONFIRM` | `vne:settings_defaults:confirm` | Продвинуть сценарий к следующей строке. |
+
+## Константы
+
+Нет.
+
+## Параметры
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `BACKGROUND` | `string` | Значение по умолчанию: "BACKGROUND". |
+
+## Настройки
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `INITED` (`vne:settings_defaults:inited`) | `string` | Настройка `vne:settings_defaults:inited` в `shared.settings`. |
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `settings.defaults.controller` | Обрабатывает UPDATE, SHOW, HIDE, EXTERNAL_UPDATE, …. |
+| `settings.defaults` | Связь со сценарием: шаг next после завершения действия. |
+| `settings.defaults.view` | Подмодуль `defaults.view` плагина. |
+
+## Близкие плагины
+
+### plugins/core/
+
+- [components.md](../core/components.md) — `COMPONENTS`: EVENTS.EXTERNAL_UPDATE
+- [memory.md](../core/memory.md) — `MEMORY`: EVENTS.CLEARED
+- [scenario.md](../core/scenario.md) — `SCENARIO`: emitNext, EVENTS.LINE_EXEC_REG, CONST.LINE_KEYWORDS.SKIP_IF_POSSIBLE
+- [settings.md](../core/settings.md) — `SETTINGS`: EVENTS.CHANGED, EVENTS.INIT, EVENTS.SET
+
+### Остальные
+
+- [settings.md](./settings.md) — `SETTINGS_VIEW`: PARAMS.TABS

package/plugins/views.screens/settings.md

@@ -0,0 +1,53 @@
+# plugins/views.screens/settings/
+
+Пакет: `@vnejs/plugins.views.screens.settings` · namespace: `SETTINGS_VIEW`
+
+Экран настроек с вкладками и полями toggle, range и списками значений.
+
+## События
+
+| Ключ | Строка | Смысл |
+|------|--------|-------|
+| `SHOW` | `vne:settings_view:show` | Показать UI или слой. |
+| `HIDE` | `vne:settings_view:hide` | Скрыть UI или слой. |
+| `UPDATE` | `vne:settings_view:update` | Обновить состояние или отображение. |
+| `PRELOAD` | `vne:settings_view:preload` | Событие `PRELOAD` namespace плагина. |
+| `TAB_SET` | `vne:settings_view:tab_set` | Выбрать вкладку по ключу из `PARAMS.TABS` (`{ tab: string }`). |
+
+## Константы
+
+Нет.
+
+## Параметры
+
+| Ключ | Тип | Смысл |
+|------|-----|-------|
+| `TRANSITION` | `string` | Значение по умолчанию: "TRANSITION". |
+| `AUDIO_NAME` | `string` | Имя трека на слое `view` при открытии экрана; пустая строка — без overlay-музыки. |
+
+## Настройки
+
+Нет.
+
+## Модули
+
+| Модуль | Зона ответственности |
+|--------|----------------------|
+| `settings.controller.audio` | Наследник `ModuleControllerAudio`: SHOW/HIDE/PRELOAD → pause global, play/stop `view`-трека. |
+| `settings.controller` | Обрабатывает HIDE, SET, TAB_SET, UPDATE, …; `currentTab` — ключ вкладки. |
+| `settings.controller.tabs` | Наследник `ModuleControllerTabs`: TAB_PREV/TAB_NEXT → `TAB_SET`; `getTabKeys` по `showInSettings`. |
+| `settings.view` | Подмодуль `view` плагина. |
+
+## Близкие плагины
+
+### plugins/core/
+
+- [components.md](../core/components.md) — `COMPONENTS`: EVENTS.EXTERNAL_UPDATE
+- [memory.md](../core/memory.md) — `MEMORY`: EVENTS.CLEARED
+- [settings.md](../core/settings.md) — `SETTINGS`: EVENTS.SET, EVENTS.CHANGED, EVENTS.INIT
+- [state.md](../core/state.md) — `STATE`: EVENTS.SET, EVENTS.CLEAR
+
+### Остальные
+
+- [audio.md](../audio/audio.md) — `AUDIO`: EVENTS.GLOBAL_PAUSE, EVENTS.PLAY, EVENTS.STOP, EVENTS.GLOBAL_RESUME, EVENTS.MEDIA_LOAD
+- [controls.md](../controls/controls.md) — `CONTROLS`: CONST.BUTTONS.BACK, CONST.BUTTONS.MENU, CONST.BUTTONS.GAMEMENU, CONST.BUTTONS.INTERACT, CONST.BUTTONS.ACCEPT, CONST.BUTTONS.TAB_PREV, CONST.BUTTONS.TAB_NEXT

package/scenario.catalog/README.md

@@ -0,0 +1,38 @@
+# Каталог сценарных команд (вариант C)
+
+Полный surface `$` / `%` команд для агента и автора. Каждая запись — короткий stub + ссылка на plugin doc.
+
+Параллельный вход с развёрнутыми гайдами: [`../scenario.guide/`](../scenario.guide/).
+
+## Как читать
+
+1. Откройте [`index.md`](./index.md) — оглавление всех команд.
+2. Перейдите в stub (`stubs/<name>.md`) за сигнатурой и примером.
+3. Если нужны события/модули — plugin doc из stub.
+
+## Source of truth
+
+Машинный каталог живёт в контрактах:
+
+```text
+contracts/**/src/commands.ts  →  export const SCENARIO_COMMANDS
+```
+
+Тот же набор агрегирует VS Code grammar (`vs_code_extensions/vne-language`, `load-commands.js`). Этот markdown-каталог в первой итерации **собран вручную** по текущим `commands.ts`; позже его можно генерировать тем же merge.
+
+Runtime регистрирует handlers отдельно через `SCENARIO.LINE_EXEC_REG` — stubs описывают author-facing синтаксис, не internals.
+
+## Структура
+
+```text
+scenario.catalog/
+  README.md
+  index.md
+  stubs/
+    flag.md              # $ и % вместе, где оба есть
+    choose.md            # $ choose
+    choose.block.md      # % choose
+    choose.option.md
+    bl.bg.md             # canvas: слой.kind
+    …
+```

package/scenario.catalog/index.md

@@ -0,0 +1,109 @@
+# Индекс команд (SCENARIO_COMMANDS)
+
+Однострочные описания → stub. Guide: [`../scenario.guide/`](../scenario.guide/).
+
+## Core / flow
+
+| Команда | Кратко | Stub |
+|---------|--------|------|
+| `$ scenario` | `anchor`, `goto` | [scenario.md](./stubs/scenario.md) |
+| `$ stack` | `jump`, `call`, `pop` | [stack.md](./stubs/stack.md) |
+| `$ pause` | пауза | [pause.md](./stubs/pause.md) |
+| `$ save` | `key` | [save.md](./stubs/save.md) |
+| `$ save.auto` | автосохранение | [save.auto.md](./stubs/save.auto.md) |
+
+## Диалог / текст
+
+| Команда | Кратко | Stub |
+|---------|--------|------|
+| `other` (без `$`) | реплики `"…"` / `<speaker> "…"` | [other.md](./stubs/other.md) |
+| `$ text.meet` | знакомство со спикером | [text.meet.md](./stubs/text.meet.md) |
+| `$ text.wall` | `start`, `end`, `clear` | [text.wall.md](./stubs/text.wall.md) |
+
+## Vars
+
+| Команда | Кратко | Stub |
+|---------|--------|------|
+| `$ flag` / `% flag` | set/unset и условный блок | [flag.md](./stubs/flag.md) |
+| `$ counter` / `% counter` | арифметика и сравнения | [counter.md](./stubs/counter.md) |
+
+## Choose / PAC / QTE / random
+
+| Команда | Кратко | Stub |
+|---------|--------|------|
+| `% choose` | меню опций | [choose.block.md](./stubs/choose.block.md) |
+| `% choose.option` | ветка опции | [choose.option.md](./stubs/choose.option.md) |
+| `$ choose` | `repeat` | [choose.md](./stubs/choose.md) |
+| `% point-and-click` | hotspots | [point-and-click.block.md](./stubs/point-and-click.block.md) |
+| `% point-and-click.option` | `{icon} x y` | [point-and-click.option.md](./stubs/point-and-click.option.md) |
+| `$ point-and-click` | `repeat` | [point-and-click.md](./stubs/point-and-click.md) |
+| `% qte` | QTE по id | [qte.md](./stubs/qte.md) |
+| `% random` | случайная ветка | [random.md](./stubs/random.md) |
+| `% random.option` | опция random | [random.option.md](./stubs/random.option.md) |
+
+## Audio
+
+| Команда | Кратко | Stub |
+|---------|--------|------|
+| `$ audio.music` | play/stop/pause/resume/volume | [audio.music.md](./stubs/audio.music.md) |
+| `$ audio.ambient` | то же | [audio.ambient.md](./stubs/audio.ambient.md) |
+| `$ audio.sound` | то же | [audio.sound.md](./stubs/audio.sound.md) |
+| `$ audio.voice` | то же | [audio.voice.md](./stubs/audio.voice.md) |
+
+## Views / screens / entities / time
+
+| Команда | Кратко | Stub |
+|---------|--------|------|
+| `$ interface` | `show`, `hide`, `view` | [interface.md](./stubs/interface.md) |
+| `$ intro` | интро | [intro.md](./stubs/intro.md) |
+| `$ mainmenu` | главное меню | [mainmenu.md](./stubs/mainmenu.md) |
+| `$ credits` | `show`, `hide` | [credits.md](./stubs/credits.md) |
+| `$ settings.defaults` | дефолты настроек | [settings.defaults.md](./stubs/settings.defaults.md) |
+| `$ video` | `play` | [video.md](./stubs/video.md) |
+| `$ comment` | комментарий / `hide` | [comment.md](./stubs/comment.md) |
+| `$ achievement` | `lock`, `unlock` | [achievement.md](./stubs/achievement.md) |
+| `$ wallet` | `add`, `set`, `reset` | [wallet.md](./stubs/wallet.md) |
+| `$ time` | `add`, `set` | [time.md](./stubs/time.md) |
+| `$ date` | `add`, `set` | [date.md](./stubs/date.md) |
+
+## Canvas layers
+
+Паттерн: `$ <layer>.<kind> <action> …`. Слои: `bl`, `fl`, `ml`, `ul`. Guide: [canvas.md](../scenario.guide/canvas.md).
+
+### bl
+
+| Команда | Actions | Stub |
+|---------|---------|------|
+| `$ bl.bg` | show, hide, change | [bl.bg.md](./stubs/bl.bg.md) |
+| `$ bl.sprite` | show, hide, change, move | [bl.sprite.md](./stubs/bl.sprite.md) |
+| `$ bl.video` | show, hide, change | [bl.video.md](./stubs/bl.video.md) |
+| `$ bl.text` | show, hide, change, move | [bl.text.md](./stubs/bl.text.md) |
+| `$ bl.fill` | show, change, hide | [bl.fill.md](./stubs/bl.fill.md) |
+| `$ bl.filter` | set, unset | [bl.filter.md](./stubs/bl.filter.md) |
+| `$ bl.scale` | set, unset | [bl.scale.md](./stubs/bl.scale.md) |
+| `$ bl.clip` | set, unset | [bl.clip.md](./stubs/bl.clip.md) |
+| `$ bl.mask` | set, unset, change | [bl.mask.md](./stubs/bl.mask.md) |
+| `$ bl.animation` | set, unset | [bl.animation.md](./stubs/bl.animation.md) |
+
+### fl / ml
+
+Те же kind, что у `bl` (`bg` … `animation`, включая `video`):
+
+- `fl.*` → [fl.bg.md](./stubs/fl.bg.md), [fl.sprite.md](./stubs/fl.sprite.md), [fl.video.md](./stubs/fl.video.md), [fl.text.md](./stubs/fl.text.md), [fl.fill.md](./stubs/fl.fill.md), [fl.filter.md](./stubs/fl.filter.md), [fl.scale.md](./stubs/fl.scale.md), [fl.clip.md](./stubs/fl.clip.md), [fl.mask.md](./stubs/fl.mask.md), [fl.animation.md](./stubs/fl.animation.md)
+- `ml.*` → [ml.bg.md](./stubs/ml.bg.md), [ml.sprite.md](./stubs/ml.sprite.md), [ml.video.md](./stubs/ml.video.md), [ml.text.md](./stubs/ml.text.md), [ml.fill.md](./stubs/ml.fill.md), [ml.filter.md](./stubs/ml.filter.md), [ml.scale.md](./stubs/ml.scale.md), [ml.clip.md](./stubs/ml.clip.md), [ml.mask.md](./stubs/ml.mask.md), [ml.animation.md](./stubs/ml.animation.md)
+
+### ul
+
+Без `video`:
+
+| Команда | Stub |
+|---------|------|
+| `$ ul.bg` | [ul.bg.md](./stubs/ul.bg.md) |
+| `$ ul.sprite` | [ul.sprite.md](./stubs/ul.sprite.md) |
+| `$ ul.text` | [ul.text.md](./stubs/ul.text.md) |
+| `$ ul.fill` | [ul.fill.md](./stubs/ul.fill.md) |
+| `$ ul.filter` | [ul.filter.md](./stubs/ul.filter.md) |
+| `$ ul.scale` | [ul.scale.md](./stubs/ul.scale.md) |
+| `$ ul.clip` | [ul.clip.md](./stubs/ul.clip.md) |
+| `$ ul.mask` | [ul.mask.md](./stubs/ul.mask.md) |
+| `$ ul.animation` | [ul.animation.md](./stubs/ul.animation.md) |

package/scenario.catalog/stubs/achievement.md

@@ -0,0 +1,16 @@
+# $ achievement
+
+| | |
+|--|--|
+| Тип | `module` (`$`) |
+| Сигнатура | `$ achievement <action> …` |
+| Actions / args | lock, unlock |
+| Plugin doc | [views/achievement.md](../plugins/views/achievement.md) |
+
+## Примеры
+
+```vne
+$ achievement unlock id
+```
+
+Source of truth: `SCENARIO_COMMANDS` в соответствующем `contracts/**/commands.ts`.

package/scenario.catalog/stubs/audio.ambient.md

@@ -0,0 +1,16 @@
+# $ audio.ambient
+
+| | |
+|--|--|
+| Тип | `module` (`$`) |
+| Сигнатура | `$ audio.ambient <action> …` |
+| Actions / args | play, stop, pause, resume, volume |
+| Plugin doc | [audio/ambient.md](../plugins/audio/ambient.md) |
+
+## Примеры
+
+```vne
+$ audio.ambient play {rain}
+```
+
+Source of truth: `SCENARIO_COMMANDS` в соответствующем `contracts/**/commands.ts`.

package/scenario.catalog/stubs/audio.music.md

@@ -0,0 +1,16 @@
+# $ audio.music
+
+| | |
+|--|--|
+| Тип | `module` (`$`) |
+| Сигнатура | `$ audio.music <action> …` |
+| Actions / args | play, stop, pause, resume, volume |
+| Plugin doc | [audio/music.md](../plugins/audio/music.md) |
+
+## Примеры
+
+```vne
+$ audio.music play {theme}
+```
+
+Source of truth: `SCENARIO_COMMANDS` в соответствующем `contracts/**/commands.ts`.

package/scenario.catalog/stubs/audio.sound.md

@@ -0,0 +1,16 @@
+# $ audio.sound
+
+| | |
+|--|--|
+| Тип | `module` (`$`) |
+| Сигнатура | `$ audio.sound <action> …` |
+| Actions / args | play, stop, pause, resume, volume |
+| Plugin doc | [audio/sound.md](../plugins/audio/sound.md) |
+
+## Примеры
+
+```vne
+$ audio.sound play {ui/click}
+```
+
+Source of truth: `SCENARIO_COMMANDS` в соответствующем `contracts/**/commands.ts`.

package/scenario.catalog/stubs/audio.voice.md

@@ -0,0 +1,16 @@
+# $ audio.voice
+
+| | |
+|--|--|
+| Тип | `module` (`$`) |
+| Сигнатура | `$ audio.voice <action> …` |
+| Actions / args | play, stop, pause, resume, volume |
+| Plugin doc | [audio/voice.md](../plugins/audio/voice.md) |
+
+## Примеры
+
+```vne
+$ audio.voice play {fl/line_01}
+```
+
+Source of truth: `SCENARIO_COMMANDS` в соответствующем `contracts/**/commands.ts`.

package/scenario.catalog/stubs/bl.animation.md

@@ -0,0 +1,18 @@
+# $ bl.animation
+
+| | |
+|--|--|
+| Тип | `module` (`$`) |
+| Сигнатура | `$ bl.animation <action> …` |
+| Actions / args | set, unset |
+| Plugin doc | [canvas.layers/bl.md](../plugins/canvas.layers/bl.md) |
+
+## Примеры
+
+```vne
+$ bl.animation set …
+```
+
+Паттерн всех слоёв одинаков — см. [guide canvas](../../scenario.guide/canvas.md).
+
+Source of truth: `SCENARIO_COMMANDS` в соответствующем `contracts/**/commands.ts`.

package/scenario.catalog/stubs/bl.bg.md

@@ -0,0 +1,18 @@
+# $ bl.bg
+
+| | |
+|--|--|
+| Тип | `module` (`$`) |
+| Сигнатура | `$ bl.bg <action> …` |
+| Actions / args | show, hide, change |
+| Plugin doc | [canvas.layers/bl.md](../plugins/canvas.layers/bl.md) |
+
+## Примеры
+
+```vne
+$ bl.bg show …
+```
+
+Паттерн всех слоёв одинаков — см. [guide canvas](../../scenario.guide/canvas.md).
+
+Source of truth: `SCENARIO_COMMANDS` в соответствующем `contracts/**/commands.ts`.

package/scenario.catalog/stubs/bl.clip.md

@@ -0,0 +1,18 @@
+# $ bl.clip
+
+| | |
+|--|--|
+| Тип | `module` (`$`) |
+| Сигнатура | `$ bl.clip <action> …` |
+| Actions / args | set, unset |
+| Plugin doc | [canvas.layers/bl.md](../plugins/canvas.layers/bl.md) |
+
+## Примеры
+
+```vne
+$ bl.clip set …
+```
+
+Паттерн всех слоёв одинаков — см. [guide canvas](../../scenario.guide/canvas.md).
+
+Source of truth: `SCENARIO_COMMANDS` в соответствующем `contracts/**/commands.ts`.

package/scenario.catalog/stubs/bl.fill.md

@@ -0,0 +1,18 @@
+# $ bl.fill
+
+| | |
+|--|--|
+| Тип | `module` (`$`) |
+| Сигнатура | `$ bl.fill <action> …` |
+| Actions / args | show, change, hide |
+| Plugin doc | [canvas.layers/bl.md](../plugins/canvas.layers/bl.md) |
+
+## Примеры
+
+```vne
+$ bl.fill show …
+```
+
+Паттерн всех слоёв одинаков — см. [guide canvas](../../scenario.guide/canvas.md).
+
+Source of truth: `SCENARIO_COMMANDS` в соответствующем `contracts/**/commands.ts`.

package/scenario.catalog/stubs/bl.filter.md

@@ -0,0 +1,18 @@
+# $ bl.filter
+
+| | |
+|--|--|
+| Тип | `module` (`$`) |
+| Сигнатура | `$ bl.filter <action> …` |
+| Actions / args | set, unset |
+| Plugin doc | [canvas.layers/bl.md](../plugins/canvas.layers/bl.md) |
+
+## Примеры
+
+```vne
+$ bl.filter set …
+```
+
+Паттерн всех слоёв одинаков — см. [guide canvas](../../scenario.guide/canvas.md).
+
+Source of truth: `SCENARIO_COMMANDS` в соответствующем `contracts/**/commands.ts`.

package/scenario.catalog/stubs/bl.mask.md

@@ -0,0 +1,18 @@
+# $ bl.mask
+
+| | |
+|--|--|
+| Тип | `module` (`$`) |
+| Сигнатура | `$ bl.mask <action> …` |
+| Actions / args | set, unset, change |
+| Plugin doc | [canvas.layers/bl.md](../plugins/canvas.layers/bl.md) |
+
+## Примеры
+
+```vne
+$ bl.mask set …
+```
+
+Паттерн всех слоёв одинаков — см. [guide canvas](../../scenario.guide/canvas.md).
+
+Source of truth: `SCENARIO_COMMANDS` в соответствующем `contracts/**/commands.ts`.

package/scenario.catalog/stubs/bl.scale.md

@@ -0,0 +1,18 @@
+# $ bl.scale
+
+| | |
+|--|--|
+| Тип | `module` (`$`) |
+| Сигнатура | `$ bl.scale <action> …` |
+| Actions / args | set, unset |
+| Plugin doc | [canvas.layers/bl.md](../plugins/canvas.layers/bl.md) |
+
+## Примеры
+
+```vne
+$ bl.scale set …
+```
+
+Паттерн всех слоёв одинаков — см. [guide canvas](../../scenario.guide/canvas.md).
+
+Source of truth: `SCENARIO_COMMANDS` в соответствующем `contracts/**/commands.ts`.

package/scenario.catalog/stubs/bl.sprite.md

@@ -0,0 +1,18 @@
+# $ bl.sprite
+
+| | |
+|--|--|
+| Тип | `module` (`$`) |
+| Сигнатура | `$ bl.sprite <action> …` |
+| Actions / args | show, hide, change, move |
+| Plugin doc | [canvas.layers/bl.md](../plugins/canvas.layers/bl.md) |
+
+## Примеры
+
+```vne
+$ bl.sprite show …
+```
+
+Паттерн всех слоёв одинаков — см. [guide canvas](../../scenario.guide/canvas.md).
+
+Source of truth: `SCENARIO_COMMANDS` в соответствующем `contracts/**/commands.ts`.

package/scenario.catalog/stubs/bl.text.md

@@ -0,0 +1,18 @@
+# $ bl.text
+
+| | |
+|--|--|
+| Тип | `module` (`$`) |
+| Сигнатура | `$ bl.text <action> …` |
+| Actions / args | show, hide, change, move |
+| Plugin doc | [canvas.layers/bl.md](../plugins/canvas.layers/bl.md) |
+
+## Примеры
+
+```vne
+$ bl.text show …
+```
+
+Паттерн всех слоёв одинаков — см. [guide canvas](../../scenario.guide/canvas.md).
+
+Source of truth: `SCENARIO_COMMANDS` в соответствующем `contracts/**/commands.ts`.

package/scenario.catalog/stubs/bl.video.md

@@ -0,0 +1,18 @@
+# $ bl.video
+
+| | |
+|--|--|
+| Тип | `module` (`$`) |
+| Сигнатура | `$ bl.video <action> …` |
+| Actions / args | show, hide, change |
+| Plugin doc | [canvas.layers/bl.md](../plugins/canvas.layers/bl.md) |
+
+## Примеры
+
+```vne
+$ bl.video show …
+```
+
+Паттерн всех слоёв одинаков — см. [guide canvas](../../scenario.guide/canvas.md).
+
+Source of truth: `SCENARIO_COMMANDS` в соответствующем `contracts/**/commands.ts`.

package/scenario.catalog/stubs/choose.block.md

@@ -0,0 +1,25 @@
+# % choose
+
+| | |
+|--|--|
+| Тип | `block` (`%`) |
+| Сигнатура | `% choose` |
+| Plugin doc | [scenario/choose.md](../../plugins/scenario/choose.md) |
+
+## Примеры
+
+```vne
+% choose
+  % choose.option "Осмотреть"
+    hided: $ flag seen
+    $ flag seen
+    $ choose repeat
+  % choose.option "Уйти"
+    "…"
+```
+
+Если все опции `hided` — блок пропускается.
+
+См. [guide choose](../../scenario.guide/choose.md).
+
+Source of truth: `contracts/scenario/choose/src/commands.ts`.

package/scenario.catalog/stubs/choose.md

@@ -0,0 +1,18 @@
+# $ choose
+
+| | |
+|--|--|
+| Тип | `module` (`$`) |
+| Сигнатура | `$ choose repeat` |
+| Actions | `repeat` |
+| Plugin doc | [scenario/choose.md](../../plugins/scenario/choose.md) |
+
+## Примеры
+
+```vne
+$ choose repeat
+```
+
+Возврат к ближайшему `% choose` выше в той же метке. Полный цикл «осмотреть → меню» — в [guide choose](../../scenario.guide/choose.md).
+
+Source of truth: `contracts/scenario/choose/src/commands.ts`.

package/scenario.catalog/stubs/choose.option.md

@@ -0,0 +1,24 @@
+# % choose.option
+
+| | |
+|--|--|
+| Тип | `block` (`%`) |
+| Сигнатура | `% choose.option "…"` |
+| Plugin doc | [scenario/choose.md](../../plugins/scenario/choose.md) |
+
+## Примеры
+
+```vne
+% choose.option "Уйти"
+  "Ветка"
+% choose.option "С QTE"
+  qte: easy
+% choose.option "Fallback" | qte-fallback
+  "…"
+```
+
+Props: `hided:`, `disabled:`, `qte:`. Keyword `| qte-fallback`.
+
+См. [guide choose](../../scenario.guide/choose.md).
+
+Source of truth: `contracts/scenario/choose/src/commands.ts`.

package/scenario.catalog/stubs/comment.md

@@ -0,0 +1,17 @@
+# $ comment
+
+| | |
+|--|--|
+| Тип | `module` (`$`) |
+| Сигнатура | `$ comment …` |
+| Actions / args | hide (+ freeform text line) |
+| Plugin doc | [views/comment.md](../plugins/views/comment.md) |
+
+## Примеры
+
+```vne
+$ comment "Подсказка" 5000
+$ comment hide
+```
+
+Source of truth: `SCENARIO_COMMANDS` в соответствующем `contracts/**/commands.ts`.

package/scenario.catalog/stubs/counter.md

@@ -0,0 +1,21 @@
+# counter ($ и %)
+
+| | |
+|--|--|
+| Тип | `module` (`$`) и `block` (`%`) |
+| `$ counter` | `$ counter <name> [op] [number]` — `++` `--` `+=` `-=` `=` |
+| `% counter` | `% counter <name> <compare> [number]` — `>` `>=` `===` `!==` `<` `<=` |
+| Plugin doc | [vars/counters.md](../../plugins/vars/counters.md) |
+
+## Примеры
+
+```vne
+$ counter n ++
+$ counter n = 10 | global
+% counter n > 0
+  "…"
+```
+
+См. также [guide vars](../../scenario.guide/vars.md).
+
+Source of truth: `SCENARIO_COMMANDS` в `contracts/vars/counters/src/commands.ts`.

package/scenario.catalog/stubs/credits.md

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