From c280e529323fc18cfdbe34f46bf9af8326bb1646 Mon Sep 17 00:00:00 2001
From: Nick Shirokov <nick_4312@mail.ru>
Date: Wed, 18 Mar 2026 20:00:08 +0300
Subject: [PATCH] docs: update web-test-recording-guide with showImage and
 titleSlide speech

- Add presentation slides section (showImage with style presets)
- Add speech parameter to title slide example
- Update full example with title speech and image slide

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 docs/web-test-recording-guide.md | 46 ++++++++++++++++++++++++++++----
 1 file changed, 41 insertions(+), 5 deletions(-)

diff --git a/docs/web-test-recording-guide.md b/docs/web-test-recording-guide.md
index 80a18eaf..89bb5321 100644
--- a/docs/web-test-recording-guide.md
+++ b/docs/web-test-recording-guide.md
@@ -139,18 +139,41 @@ Claude вызовет `addNarration` с другим голосом. Текст
 
 ### Титульный слайд
 
-Полноэкранная заставка в начале видео:
+Полноэкранная заставка в начале видео. Поддерживает озвучку через `speech`:
 
 ```js
 await startRecording('recordings/demo.mp4');
 await showTitleSlide('Создание заказа клиента', {
-  subtitle: '1С:Бухгалтерия в примерах'
+  subtitle: '1С:Бухгалтерия в примерах',
+  speech: 'Создание заказа клиента. Бухгалтерия в примерах.'
 });
-await wait(4);
+await wait(1);
 await hideTitleSlide();
 // ... далее контент
 ```
 
+### Слайды из презентации
+
+Показать изображение (скриншот слайда, схему и т.д.) как полноэкранный оверлей с озвучкой:
+
+```js
+await showImage('slides/overview.png', {
+  speech: 'На этом слайде показана общая схема процесса'
+});
+await wait(1);
+await hideImage();
+```
+
+Стили оформления (`style`):
+- `'blur'` (по умолчанию) — размытый фон из картинки + тень. Лучший для презентаций
+- `'dark'` — тёмный фон + тень
+- `'light'` — белый фон + тень
+- `'full'` — на весь экран без отступов
+
+```js
+await showImage('slides/diagram.png', { style: 'dark', speech: 'Диаграмма процесса' });
+```
+
 ### Подсветка элементов
 
 Полупрозрачная рамка на элементе, который сейчас используется. Два режима:
@@ -281,9 +304,22 @@ await showCaption('Технические детали', { speech: false });
 
 ```js
 await startRecording('output.mp4');
-await showTitleSlide('Заголовок', { subtitle: 'Подзаголовок' });
-await wait(4);
+
+// Титульный слайд с озвучкой
+await showTitleSlide('Заголовок', {
+  subtitle: 'Подзаголовок',
+  speech: 'Заголовок. Подзаголовок.'
+});
+await wait(1);
 await hideTitleSlide();
+
+// Слайд из презентации (опционально)
+await showImage('slides/overview.png', {
+  speech: 'Описание слайда для озвучки'
+});
+await wait(1);
+await hideImage();
+
 setHighlight(true);
 
 // ... шаги с showCaption + действия ...