gen-screenshots.js: 15 кадров × 3 вьюпорта, поддержка en, обновлены доки и README

.gitignore

@@ -11,16 +11,12 @@ tools/.venv/
 *.log
 .DS_Store
 
-# Артефакт сборки для Яндекс Игр (node tools/pack.mjs)
+# Артефакт сборки
 dist/
 
-# Локальные worktree спринтов (Orca)
-sprint3-*/
-sprint2-*/
-sprint4-*/
-
 # Локальная документация (защита от случайного git add -A)
 /*.pdf
 
 # Секреты (никогда не коммитить)
 .gitea_token
+

AGENTS.md

@@ -17,12 +17,12 @@
    node tests/orca-playtest.js   # из каталога репо; требует ЗАПУЩЕННЫЙ Orca app и orca-ide (или ORCA_CLI_COMMAND)
    ```
    Проходит тот же геймплей «вживую» в браузере (не headless) и пишет `orca-*.png` в каталог запуска. Если Orca app не запущен — пропустить и НЕ блокировать (главный рубеж — пункт 2). Подробности и подводные камни: `docs/BROWSER-TESTING.md`.
-4. Скриншоты: `node tests/shots.js` пишет `shot-*.png` в каталог запуска (запускать из `tests/`); README ссылается на `screenshots/` в корне — свежие скопировать туда. Emoji рисует встроенный шрифт (раздел «Встроенный emoji-шрифт») — системные emoji-шрифты для скриншотов больше не нужны.
+4. Скриншоты: `node tests/gen-screenshots.js [каталог-сборки] [папка-вывода] [язык]` — 15 кадров × 3 вьюпорта (1280×720 / 360×640@2x / 800×450@1.6x), 24-битный PNG без альфа. Без аргументов — русские в `screenshots-wiki/`, с `en` — английские в `screenshots-wiki-en/`. README ссылается на `screenshots-wiki/mobp-*` (мобильный портрет). Emoji рисует встроенный шрифт (раздел «Встроенный emoji-шрифт») — системные emoji-шрифты для скриншотов больше не нужны.
 5. Публикация в Яндекс Играх: `node tools/pack.mjs` (сборка dist/fishing-yandex.zip + самопроверка 5 пунктов) → `node tests/pack-smoke.js` (smoke играбельности КОПИИ из архива, 6 чек) → загрузить zip в консоль. Доки: раздел README «Публикация в Яндекс Играх», запись Этап 27 в DEVLOG.
 
 ## Подводные камни
 
-- `tests/test.js` берёт браузер из `process.env.CHROMIUM || '/usr/bin/chromium-browser'`, а URL игры резолвит динамически от каталога репо (тот же паттерн, что в `shots.js`). Если тест падает на старте — поправьте имя/путь chromium под свой чекаут (переменная `CHROMIUM`).
+- `tests/test.js` берёт браузер из `process.env.CHROMIUM || '/usr/bin/chromium-browser'`, а URL игры резолвит динамически от каталога репо (тот же паттерн, что в `gen-screenshots.js`). Если тест падает на старте — поправьте имя/путь chromium под свой чекаут (переменная `CHROMIUM`).
 - Граница полуночи: если прогон стартует в пределах 5 минут от 00:00, test.js сам ждёт безопасное окно (дата не должна смениться посреди прогона — падают date-ассерты квестов/стрика). Это нормально, не баг.
 - Тесты гоняют игру через внутренние глобалы в `page.evaluate`: `state`, `save`, `biteTimer`, `reel`, `SPECIES`, `SPECIES_NIGHT`, `rod()`, `SHINY_CHANCE`, `forceBoss`, `forceBite`, `forceVariant`, `VARIANTS`, `rollVariant()`, `variantChance()`, `fishForce()`, `stateBoss`, `bossPhase`, `dayPhase`, `pickSpecies()`, `setDayTime()`, `todayStr()`, `dateShift()`, `isoWeek()`, `achBonus()`, `forceWeather`, `weather`, `weatherT`, `weatherGap`, `WEATHER`, `WEATHER_GAP_MIN`, `WEATHER_GAP_MAX`, `WEATHER_DURATION`, `weatherActive()`, `BOAT_SKINS`, `BOBBER_SKINS`, `LOCATIONS`, `RIVER_SPECIES`, `RIVER_SPECIES_NIGHT`, `LAKE_SPECIES`, `LAKE_SPECIES_NIGHT`, `SAVE_KEY`, `loadSave`, `freshSave`, `ACHIEVEMENTS`, `checkAchievements`, `questText`, `YG` (и `YG.counts`), `forceLang`, `setLang()`, `LANG`, `trName()`, `trRarity()` (i18n, тесты §Y5), `pauseOpen` (пауза, тесты §Y6), `uiOpen`, `dayTime` и имена состояний `MENU/IDLE/CHARGE/CAST/WAIT/APPROACH/BITE/REEL/SNAP/CARD`. Переименование любого из них ломает тесты молча — имена держать, либо обновлять тест в том же коммите.
 - Ввод на Pointer Events (`pointerdown`/`pointerup`), а не touch/mouse — так тест управляет игрой мышью. Не заменять на тач-обработчики.

README.md

@@ -4,7 +4,7 @@
 
 | Меню | Клёв | Вываживание | Улов |
 |---|---|---|---|
-| ![меню](screenshots/shot-menu.png) | ![клев](screenshots/shot-bite.png) | ![вываживание](screenshots/shot-reel.png) | ![улов](screenshots/shot-card.png) |
+| ![меню](screenshots-wiki/mobp-menu.png) | ![клев](screenshots-wiki/mobp-bite.png) | ![вываживание](screenshots-wiki/mobp-reel.png) | ![улов](screenshots-wiki/mobp-card.png) |
 
 ## Как играть
 
@@ -31,14 +31,14 @@
 - Апгрейды снастей: удилища и приманки улучшаются до 4 уровня (свет фонарика, крепость лески, тормоз, катушка, клёв, редкие и крупные рыбы); следующая снасть в лавке открывается после 4 уровня предыдущей
 - Босс-рыба — Осётр-босс (шанс при поимке осётра): 3 фазы «рвёт и уходит», награда ×5, достижение «Босс-рыбак»
 - Варианты рыб: серебряная ×2, золотая ×3, радужная ×5 — бейдж и оформление карточки улова
-- Погода: дождь (🌧️) — шанс серебряной/золотой/радужной ×2,5; туман (🌫️) — клёв ×1,5; событие идёт 120 с, следующее — раз в 2–4 минуты — ![дождь](screenshots/shot-weather-rain.png)
+- Погода: дождь (🌧️) — шанс серебряной/золотой/радужной ×2,5; туман (🌫️) — клёв ×1,5; событие идёт 120 с, следующее — раз в 2–4 минуты — ![дождь](screenshots-wiki/mobp-weather-rain.png)
 - Скины лодки и поплавка 🎨 — вкладка «Скины» в лавке: лодка «Красная лодка» 800 🪙 / «Лодка-домик» 2000 🪙, поплавок «Красный» 500 🪙 / «Неоновый» 1500 🪙 — чистая косметика (без эффектов на геймплей)
-- Локации: Озёра (100 000 🪙) — судак, хариус, гигантский рак; свой состав днём/ночью, свой цвет воды; покупка и переключение во вкладке 🗺️ лавки — ![озёра](screenshots/shot-lake.png)
+- Локации: Озёра (100 000 🪙) — судак, хариус, гигантский рак; свой состав днём/ночью, свой цвет воды; покупка и переключение во вкладке 🗺️ лавки — ![озёра](screenshots-wiki/mobp-lake.png)
 - Квесты дня (3 шт, генерация по дню), стрик входов со «щитом», 29 достижений с бонусами
 - Дневник рыбака — коллекция, максимальный улов по каждому виду, статистика
 - Магазин с вкладками: Лавка 🛒, Дневник 📔, Награды 🎯, Достижения 🏅, Скины 🎨, Локации 🗺️
 - Прогресс и коллекция сохраняются в `localStorage` (старые сейвы мигрируются автоматически)
-- Диалог «Меню» (пауза ⏸ → «В меню»): «Продолжить» (сессия сохраняется), Магазин/Достижения/Дневник, «Инструкции», звук 🔊 и сброс 🗑️ (через диалог подтверждения; настройка звука при сбросе сохраняется) — ![меню](screenshots/shot-gamemenu.png)
+- Диалог «Меню» (пауза ⏸ → «В меню»): «Продолжить» (сессия сохраняется), Магазин/Достижения/Дневник, «Инструкции», звук 🔊 и сброс 🗑️ (через диалог подтверждения; настройка звука при сбросе сохраняется) — ![меню](screenshots-wiki/mobp-gamemenu.png)
 - Клик по монетам в HUD открывает лавку на вкладке «Лавка» 🛒
 - Звуки на WebAudio, вибрация на телефоне
 - Локализация RU/EN — язык определяется автоматически через SDK Яндекс Игр (`ysdk.environment.i18n.lang`); меню адаптируется под устройство (тач/мышь)
@@ -83,4 +83,4 @@ node test.js         # 162 проверки
 
 Есть и браузерный плейтест «вживую» во встроенном браузере Orca: `node tests/orca-playtest.js` (из каталога репо, требует запущенный Orca app) — полный геймплей, проверка консоли и pageerror; детали в [docs/BROWSER-TESTING.md](docs/BROWSER-TESTING.md).
 
-Скриншоты состояний — `tests/shots.js` (headless, запускать из каталога `tests/`, кадры пишутся в текущий каталог): без аргументов снимает все кадры; `node shots.js menu boss` — только выбранные (прогон всё равно полный, пропускается лишь сохранение остальных); `node shots.js --list` — список кадров. Свежие скрины для README копируются в `screenshots/`.
+Скриншоты состояний — `tests/gen-screenshots.js` (headless, 15 кадров × 3 вьюпорта: десктоп 1280×720, мобильный портрет 360×640@2x, мобильный ландшафт 800×450@1.6x, 24-битный PNG без альфа). Без аргументов — русские скриншоты в `screenshots-wiki/`; с аргументом `en` — английские в `screenshots-wiki-en/`. README ссылается на `screenshots-wiki/mobp-*` (мобильный портрет).

docs/BROWSER-TESTING.md

@@ -10,7 +10,7 @@
   1. `node --check` на вынутый из `index.html` JS;
   2. `cd tests && node test.js` — **главный рубеж** (headless, всегда доступен);
   3. `node tests/orca-playtest.js` — браузерный плейтест (требует запущенный Orca app);
-  4. `node shots.js` — скриншоты.
+  4. `node tests/gen-screenshots.js` — скриншоты (15 кадров × 3 вьюпорта, 24-битный PNG).
 - **В отличие от puppeteer-теста, требует запущенный Orca app.** Если Orca не запущен — скрипт честно падает на шаге 0 с понятной ошибкой; в таком случае шаг **пропускается и не блокирует** коммит (главный рубеж — `tests/test.js`).
 
 ## Требования
@@ -163,7 +163,7 @@ PASS | нет pageerror за прогон (window.onerror / unhandledrejection)
 1. В секции «Прогон» в нужном месте добавьте действия через хелперы (`evalPage`, `waitCond`/`waitState`, `pointerDown/Up`, `clickByText`, `shot`) — фиксированные sleep на ожидание состояний не писать (пункт 1 выше).
 2. После каждого шага — `ok('название', условие, extra)`.
 3. Если шаг форсирует игру (например, `SHINY_CHANCE = 1`), возвращайте исходное значение в `finally` — иначе сломаете следующие циклы и сейв вкладки.
-4. Скриншот — `shot('orca-<имя>.png')`: файл уходит в CWD, не путать с `shot-*.png` из `tests/shots.js`.
+4. Скриншот — `shot('orca-<имя>.png')`: файл уходит в CWD, не путать с `shot-*.png` из `tests/test.js` (автотесты) и `screenshots-wiki/` из `tests/gen-screenshots.js`.
 5. Обновите таблицу шагов в этом документе и число проверок в AGENTS.md, если менялось общее количество ok().
 
 ## Справочник CLI (используемые команды)