fishing-game/AGENTS.md

# AGENTS.md

Игра — один файл `index.html` (HTML+CSS+JS, ~2700 строк): без сборки, зависимостей и бэкенда. Весь код в одном `<script>`, секции помечены комментариями. UI, комментарии и доки — на русском; при правках сохраняйте этот стиль.

## Проверка (lint/typecheck отсутствуют)

1. Синтаксис: `node tools/check.mjs` — вынимает JS из `index.html` и прогоняет `node --check` (при ошибке показывает номер строки index.html).
2. Главный рубеж — плейтест (запускать после правок `index.html` или `test.js`):
  ```bash
   cd tests
   npm install   # puppeteer-core
   npm test      # = node test.js
  ```
  ```
      Ждать все PASS и exit 0.
  ```
3. Браузерный плейтест (вкладка встроенного браузера Orca, через Orca CLI, только по просьбе пользователя):
  ```bash
   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/gen-screenshots.js [каталог-сборки] [папка-вывода] [язык]` — 15 кадров × 3 вьюпорта (1280×720 / 360×640@2x / 800×[450@1.6x](mailto:450@1.6x); кадры sea/ocean — этап 43, swamp/swamp-night — этап 45, aquarium — этап 46), 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.
6. Релизная (уменьшенная) сборка: `node tools/minify.mjs` (зависимости: `npm i --prefix tools` — terser+csso) → `dist/index.release.html` (−35% к размеру) + самопроверка 6 пунктов (размер, node --check, маркеры EMOJI-FONT/FISH-SVG, набор id, видимый текст DOM, base64 шрифта). Методы: terser с `mangle.toplevel:false` (глобалы из буллета «Подводные камни» — «Тесты гоняют игру через внутренние глобалы» — держатся ИМЯМИ, поэтому артефакт можно прогнать тем же tests/test.js), csso в каждом `<style>` кроме блока шрифта (держится побайтово), в FISH-SVG удаляются комменты и whitespace между тегами, прочие HTML-комменты — кроме маркеров, whitespace DOM — только между блок-тегами. ПЕРЕД публикацией артефакта: подставить его под `index.html` и прогнать `node tests/test.js` (полную суиту) и/или цепочку пункта 5.

## Подводные камни

- `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`, `LINE_SKINS`, `SKIN_GROUPS` (Этап 59), `RODS`, `LURES`, `rodLook()`, `hookRec()` (внешний вид снасти, Этап 63, тесты §10e2), `LOCATIONS`, `RIVER_SPECIES`, `RIVER_SPECIES_NIGHT`, `LAKE_SPECIES`, `LAKE_SPECIES_NIGHT`, `SEA_SPECIES`, `SEA_SPECIES_NIGHT`, `OCEAN_SPECIES`, `OCEAN_SPECIES_NIGHT`, `RIVER_IDS`, `LAKE_IDS`, `SEA_IDS`, `OCEAN_IDS`, `SWAMP_SPECIES`, `SWAMP_SPECIES_NIGHT`, `SWAMP_IDS`, `SWAMP_DAY_WEIGHTS`, `SWAMP_NIGHT_WEIGHTS`, `SAVE_KEY`, `loadSave`, `freshSave`, `ACHIEVEMENTS`, `checkAchievements`, `questText`, `genQuests`, `questScale`, `localMedianW` (квесты Этапа 53, тесты §9e2), `YG` (и `YG.counts`), `forceLang`, `setLang()`, `LANG`, `trName()`, `trRarity()` (i18n, тесты §Y5), `pauseOpen` (пауза, тесты §Y6), `uiOpen`, `dayTime` и имена состояний `MENU/IDLE/CHARGE/CAST/WAIT/APPROACH/BITE/REEL/SNAP/CARD`; аквариум (этап 46): `aqOpen`, `aqFishRt`, `aqSel`, `aqTank`, `AQ_BASE_SLOTS`, `AQ_MAX_SLOTS`, `AQ_SLOT_COSTS`, `AQ_VARIANT_RECOLOR`, `AQ_VARIANT_CLASS`, `aqApplyVariant`, `aqFishEls`, `aqBuildFishEl`, `aqPlaceFish`, `initAquarium`, `updateAquarium`, `drawAquarium`, `aqFishSize`, `aqTap`, `showAqPop`, `hideAqPop`, `renderAqBar`, `aqReleaseAt` (выпуск по индексу, Э64), `openAquarium`, `closeAquarium`, `syncKeepBtn`, `cardSpec`, `save.aqFish`, `save.aqSlots`, `aqPickOpen`, `aqPickPending`, `openAqPick`, `closeAqPick`, `renderAqPick`, `aqPickPlace`, `aqPickConfirmReplace`, `aqPickBuySlot`, `aqPickFinish`, декора аквариума (Этап 59): `AQ_FLOORS`, `AQ_DECOS`, `save.aqDecor`/`save.aqFloorOwned`/`save.aqDecoOwned`, `drawAqDeco`; диалога улучшений (Этап 62): `aqShopOpen`, `aqShopTab`, `openAqShop`, `closeAqShop`, `setAqTab`, `renderAqShop`, `aqDecorRow`, `aqBuySlot`, `aqEquipFloor`, `aqEquipDeco`, `aqShopRelPending` (pending выпуска, Э64) (`aqCycleFloor`/`aqCycleDeco`/`aqDecorName`/`btnAqFloor`/`btnAqDeco`/`btnAqSlot` — УДАЛЕНЫ Этапом 62; `aqReleaseSel`/`btnAqRelease` — УДАЛЕНЫ Э64 (выпуск только из диалога); `aqValue` удалён, `AQ_VARIANT_FX`/`AQ_VARIANT_HUE` — тоже, не использовать). Переименование любого из них ломает тесты молча — имена держать, либо обновлять тест в том же коммите.
- Ввод на Pointer Events (`pointerdown`/`pointerup`), а не touch/mouse — так тест управляет игрой мышью. Не заменять на тач-обработчики.
- Сейв: ключ localStorage `fishing-save-v1`. При изменении формата — миграцию добавлять в `loadSave()` (старые сейвы обязаны оставаться читаемыми).

## Где крутить

- Баланс (рыба/удилища/приманки): константы `SPECIES`, `RODS`, `LURES` в начале скрипта (базы: удочки **0/150/500/30000**, наживки **0/100/2000/22000** — Этап 53). Апгрейды снастей (уровни 1..4): цена перехода — `upgCost(type,i,lv)`: id 0 — фикс `ROD_UPG_COST`/`LURE_UPG_COST` (**20/50/100** и **15/40/80**), id&gt;0 — база×`UPG_MULT` (**0.15/0.35/0.6**, округление до 10); подписи уровней `ROD_UPG_NEXT`/`LURE_UPG_NEXT`, уровни `save.rodLv`/`save.lureLv`, эффективные статы — `effRod()`/`effLure()` (глобалы `rod()`/`lure()` отдают эффективные), гейтинг открытия — в `itemRow()`/`shopClick()`. **Этап 53 (ребаланс прогрессии):** ранний темп — Стеклопластик/Червь и Озёра ≤5 мин, затем плавное замедление (Карбон 5–10 мин, Болото +15 мин, Титан ~1 ч, Море ~2 ч, Океан ~4 ч). Цены калиброваны `tools/progression.mjs`; менять их — только перепрогнав этот скрипт и плейтест.
- **Внешний вид снасти (Этап 63, чистый визуал):** бланк удочки и крючок меняются от ЭКИПИРОВАННОЙ снасти, а не от скина (четвёртый класс скинов сознательно НЕ вводили — иначе два источника истины на один пиксель + миграция сейва/ачивки/пины). Данные только в записях таблиц (паттерн Этапа 57 — в отрисовке нет `switch` по id): `RODS[i].look={c,w,band?,fx?}` — цвет/толщина бланка, `band` — серебристое кольцо у кончика (Карбон/Титан), `fx:'glint'` — холодное мерцание (Титан); `LURES[i].hook={c,fx?,bait?,bead?,body?,blade?}` — цвет дуги/жала, `fx:'gold'` — золотое мерцание (Блёстка); **Э64:** `bait` — розовый червь НА конце крючка (по жалу, с головным утолщением; стал крупнее), `body` — тельце-минноу воблера над крючком (хвост, светлое брюшко, лопатка; `bead` — красный глаз), `blade` — золотой лепесток-«вращалка» Блёстки (ширина ходит `sin(time·4.5)`, рисуется внутри gold-тени). Чтение — хелперы `rodLook()`/`hookRec()` (кламп `length-1` + fallback на запись 0, паттерн `lineSkinRec()`); `effRod`/`effLure` — `Object.assign`-копии, косметика проходит через `rod()`/`lure()`. Отрисовка: `drawBoat()` (stroke бланка из `look`, glint/band в save/restore — тень не перетекает на лодку/флажок; **длина бланка и `tip` не тронуты — `tip` якорит леску/заброс, менять нельзя без перепроверки всей геометрии**) и `drawRig()` (крючок из `hook`, gold — паттерн `lineShadow()`; насадка поверх крючка ветвлением по полям записи, без switch по id: `blade` — внутри gold-тени до restore, `body`/`bait` — после; `body`+`bead` рисуются даже с крючком под тельцем — «тройник под вобом»; крючок виден только в WAIT/APPROACH/BITE — в REEL он «в рыбе»; геометрия `hx/hy/hookPos` Э64 НЕ тронута — только начертание). На статы/баланс/сейв/ачивки не влияет — миграция не нужна. Тесты §10e2 (данные + проход rod/lure 0..3 в WAIT без pageerror, со снимком экипировки).
- Ночной и погодный декор (Этап 58, чисто визуал): `fireflies[]`/`bats[]` собираются в `initScenery()` (Река/Озёра/Болото; у Моря/Океана пусто) там же очищаются; ход — только в `updateDecor(dt)` (дрейф Лиссажу, горизонтальный полёт мышей, старт/жизнь `meteor`, спавн/затухание `rainRipple`, `lightningT`). Отрисовка: светлячки `drawFireflies()` в `draw()` после `drawSwampDecor()` (гейт `nightMix()>0.35`), кольца дождя `drawRainRipple()` рядом до `drawBoat()` (массив отдельный от игровых `ripples[]`), мыши + падающая звезда — ВНУТРИ `drawSky()` (гейты 0.5/0.6). DOM/геймплей не трогает.
- Ночь (M3): длительность суток `DAY_LENGTH` (сек), ночная таблица рыб `SPECIES_NIGHT`, фонарик — апгрейд 1 любого удилища (`save.rodLv[save.rod]>=2`, проверка `hasLight()` в ветке WAIT, секция «M3: Цикл дня/ночи»); фонарь на носу лодки в `drawBoat()` горит под тем же гейтом `hasLight()` — без апгрейда ночная лодка тёмная (Этап 61, чистый визуал; ночные кадры `gen-screenshots.js` ставят `rodLv=2`, чтобы фонарь в скриптах оставался горел). Мировое время (`setDayTime(...)` + `updateWeather()` в `frame()`) идёт ТОЛЬКО в игре под `if(!uiOpen)` — под любым неигровым экраном (#menu/#gamemenu/лавка/аквариум/#resetDlg/#pause) день/ночь и погода заморожены; `time`/`updateDecor`/`updateAquarium` не морозятся (визуал). Под `YG.paused` (реклама/скрытая вкладка) заморожено как и раньше — весь блок кадра.
- Босс (M4, Этап 37 — босс в каждой локации, Этап 45 — +Болото, Этап 55/56 — босс Болота: Которыбка): тест-форс появления `forceBoss` (работает с боссом ТЕКУЩЕЙ локации), таблица `BOSS_BY_LOCATION={0:'sturge',1:'crayfish',2:'swordfish',3:'whale',4:'meowfish'}` (секция ДАННЫЕ) — босс = существующий вид текущей локации (Река=Осётр как в M4, Озёра=Гигантский рак, Море=Рыба-меч, Океан=Синий кит, Болото=Которыбка (meowfish, экс-целакант этапа 55); Дух болота с Этапа 55 — обычная рыба) с runtime-флагом `boss:true` (в `startBite()`, НОВЫХ видов в `SPECIES` нет); вес ЛЮБОГО босса — единое правило 20–50 кг в `hook()` (`w=20+Math.random()*30` вместо ролла `wMin..wMax` вида; стоит до `d0`/`ov`/`st0` и уходит в `reel.w`/`catchFish` тем же `w`); фазы боя `stateBoss`/`bossPhase`, босс-ветки в `updateReel()` (обрыв фазы) и `SNAP` в `updateGame()` (авто-переход), награда ×5 в `catchFish()`; `save.bosses={id:true}` — пер-босс трекинг (дефолт в `save`/`freshSave()` + миграция в `loadSave()`, ставится в boss-ветке `catchFish()`); ачивки: `boss_first` (текст нейтральный «Победи рыбу-босса», бонус не тронут) + `lake_boss`/`sea_boss`/`ocean_boss`/`swamp_boss` (БЕЗ coinPct — пин §10c(8) `achBonus().coinPct=0.18` жив; `bonus:{}` пустой — `bonusText()` требует объект).
- Варианты рыб (M6): таблица `VARIANTS` — 8 вариантов, порядок ролла = порядок массива: copper ×1.5 @0.12 → silver ×2 @0.08 → quartz ×2.5 @0.07 → gold ×3 @`SHINY_CHANCE` (0.06, живая) → emerald ×4 @0.01 → diamond ×4.5 @0.007 → rainbow ×5 @0.005 (топ), иначе normal; P(особой)≈31% без буста снасти, E[mult]≈1.36. `variantChance()` — единственная точка вероятностей (дождь M8 уже здесь — ×3, см. строку «Погода (M8)»; буст снасти M6+ тоже здесь: `variantBoost()` = `lure().rare×0.15 + (уровень наживки−1)×0.05`, множитель ×(1+B·r), r — номер в лестнице 1..7 — редким больше; простая наживка 1 ур. → B=0; блёстка 4 ур. → B=0.6, rainbow ×5.2), счётчики улова — `VARIANT_KEY` (cp/sv/qz/sn/em/dm/rb; sn = «shiny» = gold), миграция счётчиков в `loadSave()` (дефолт 0), тест-форс `forceVariant`, босс всегда normal. Рыбу нельзя улучшать: «Улучшить вариант» (M6) убрано в этапе 21 — карточка улова только бейдж/оформление по варианту. Пины шансов в тестах (§10c(1)/(5), M8(2)) — при нейтральной снасти (снапшот/рестор `save.lure`/`lureLv` в eval).
- Погода (M8): таблица `WEATHER` (rain — `variantMult` ×3; fog — `biteMult` ×1,5), таймеры — `updateWeather()` в `frame()` под `if(!uiOpen)`: идут в реальном времени только в игре, под неигровыми экранами заморожены вместе с днём/ночью (gap `WEATHER_GAP_MIN..MAX` 120–240 с, длительность `WEATHER_DURATION` 120 с, под форсом не гоняются), `weatherActive()` — единственная точка чтения (форс приоритетнее), эффекты только в `variantChance()` (rain) и `biteChance()` (fog), тест-форс `forceWeather` ('rain'/'fog'/null, паттерн `forceBoss`); погода не персистится в сейв. Тост погоды — из `T` (`t('wx_'+weather)`; `WEATHER.*.toast` — не используется). Заметка: туман может дать p&gt;1 → насыщение 100% клёва (осознанно). **Этап 58 (визуал):** `drawWeather()` больше не заливает экран целиком — пелена прижата к ватерлинии (градиент от 0 на `waterY−H*0.22` до 0.28 на `waterY−8` и ниже), НАД водой непрозрачность ≤ именованной `FOG_TOP_ALPHA` (0.10 — бюджет читаемости поплавка/HUD); 2 полосы дрейфуют горизонтально у поверхности под `clip`. В дождь — редкая молния: `lightningT` (8–16 с) в `updateDecor` ставит `lightningFlash=1` (затухание `-dt*3`), `drawWeather` рисует белый экран альфой `lightningFlash*0.35` (≤0.35); поля рантайм, в сейв не идут.
- Скины (M-skins, рефактор Этапа 57 — скины управляются ТОЛЬКО таблицей): таблицы `BOAT_SKINS`/`BOBBER_SKINS` (секция ДАННЫЕ) — **цвета и спец-эффекты живут в записях**, в отрисовке нет `[skin]`-массивов. Формат: лодка `{id,name,nameEn,cost,cols:[верх градиента,низ градиента,кромка борта], fx?}` (fx: `'cabin'` каюта / `'dragon'` драконья голова на носу + щит / `'wake'` бурун под корпусом); поплавок `{id,name,nameEn,cost,bot,top,ring, fx?}` (fx: `'neon'` постоянное зелёное свечение / `'firefly'` свечение только при `nightMix()>0.35` / `'bell'` двойной диск + металлический блик). Цены (Этап 57): лодка **0 / 800 / 2000 / 6000 (Драккар/Longship) / 18000 (Катер/Speedboat)**; поплавок **0 / 500 / 1500 / 4000 (Светлячок/Firefly) / 12000 (Бубенчик/Bell)** — строго возрастающие. Сейв `save.boatSkin(s)`/`save.bobberSkin(s)` + миграция в `loadSave()` (включая гарантию бесплатного скина 0); **жёсткие границы — `>BOAT_SKINS.length-1`/`>BOBBER_SKINS.length-1`** (было `>2` — новые скины молча сбрасывались на 0 при reload!), отрисовка — `Math.min(BOAT_SKINS.length-1,…)` с fallback `BOAT_SKINS[0]`/`BOBBER_SKINS[0]`; вкладка «Скины» 🎨 (`#tabSkins`, строка `skinRow(list,i,owned,equipped,group)`, ветки buyskin/select в `shopClick()`: покупка со списанием и авто-экипировкой, выбор — только купленное); чистая косметика — без эффектов на геймплей. Свечение поплавка — `shadowBlur` в save/restore (не перетекает на воду). Ачивки `skin_first` (>1 скина лодки/поплавка) и `skins_all` (все id обеих таблиц — табличная проверка `BOAT_SKINS.every`/`BOBBER_SKINS.every`, подхватила новые скины без правки; `bonus.coinPct` не менялся — пин §10c(8) 0.18 жив).
  **Этап 59 — ТРЕТИЙ класс: леска (`LINE_SKINS`).** Таблица рядом с лодкой/поплавком, тот же принцип «цвет/эффект только в записи»: `{id,name,nameEn,cost, c, w, fx?}` — `c` цвет основы (rgba-строка), `w` толщина на воде, `fx:'gold'` золотое мерцание (shadowBlur в save/restore, не перетекает). Скины: **0 Обычная / 3000 Флуоресцент / 12000 Золотая нить** (строго возрастающие, nameEn обязателен у всех). Сейв `save.lineSkins[]`/`save.lineSkin` + миграция в `loadSave()` (дефолты, гарантия индекса 0, клампы `LINE_SKINS.length-1`, купленные фильтруются от нечисловых/вне таблицы; у boatSkins/bobberSkins фильтра нет, только гарантия 0). Отрисовка — ЧЕТЫРЕ точки, все читают `lineSkinRec()` (`Math.min(length-1,…)` + fallback на скин 0): `drawLineTo()` (цвет+c.lineWidth из записи, `lineShadow()` для fx gold), поводок в `drawRig()` (тот же цвет, `globalAlpha=0.35` в save/restore), след поплавка в ветке CAST `drawLineAndBobber()` (цвет из записи, альфа — прежняя прогрессия `i/len*0.35`), подводный сегмент bobber→рыба в ветке REEL `drawLineAndBobber()` (цвет из записи, `globalAlpha=0.35`, `lineWidth=Math.min(1.2,ls.w)`, `lineShadow()` с парным restore). Удочка/катушка НЕ тронуты. Магазин: **таблица групп `SKIN_GROUPS={boat,bobber,line}`** (`list()`/`owned()`/`cur` — имя поля экипировки) — ветка `if(SKIN_GROUPS[type])` в `shopClick()` одна на все классы (прежний тернарник `type==='boat'?…:…` при третьем классе молча отдал бы поплавок — так и написан комментарий); `renderShop()` — секция `t('sec_line')` («Леска»/«Line») + `skinRow(...,'line')`. После покупки — `checkAchievements()` (Этап 59): ачивка `line_first` «Тонкая снасть» (`bonus:{}` — пин §10c(8) жив; `skin_first`/`skins_all` про лодку/поплавок НЕ расширены).
- Локации (этап 5, этап 35, этап 36 — эксклюзивная ихтиофауна, этап 45 — Болото): таблица `LOCATIONS` (Река 0 — бесплатно / «Озёра» **500** 🪙 / «Море» **100000** 🪙, этап 35 / «Океан» **300000** 🪙, этап 36 / «Волшебное болото» **10000** 🪙 — id 4, этап 45: в массиве `LOCATIONS` — ПОСЛЕДНИЙ; **Этап 53: цены пересмотрены** — Озёра 65536→500, Болото 90000→10000, Море 131072→100000, Океан 196608→300000; порядок по цене Река &lt; Озёра &lt; Болото &lt; Море &lt; Океан сохранён; `water` — 6 hex [dayTop,dayMid,dayBot,nightTop,nightMid,nightBot] для градиента `drawWater()`, nightMix-логика та же, у Болота — тёмно-моховая вода и слабая рябь `waves` тише Озёр), сейв `save.locations[]`/`save.location` + миграция в `loadSave()` (гарантия бесплатной Реки, граница `save.location>=LOCATIONS.length` — в этапе 36 ИСПРАВЛЕН баг этапа 5: жёсткое `>1` сбрасывало Море на reload, паттерн скинов), вкладка «Локации» 🗺️ (`#tabLocations`, строка `locationRow(loc,i,owned,selected)`, ветки buylocation/selectlocation в `shopClick()`: покупка — списание, push, АВТО-ПЕРЕХОД `save.location`, тост `welcome_lakes`/`welcome_sea`/`welcome_ocean`/`welcome_swamp` (у Болота — `if/else`-ветка, этап 45); выбор — только купленное). Таблицы рыб: у КАЖДОЙ воды свои `*_IDS`-списки, БЕЗ пересечений (этап 35): `RIVER_SPECIES(_NIGHT)` — ровно 8 базовых (`RIVER_IDS`; роллы реки не меняются: pin-тесты §9j(b)/M4/M6 завязаны на веса и порядок — новые виды в реку НЕ добавлять!), `LAKE_SPECIES(_NIGHT)` — только 10 озёрных (`LAKE_IDS`: zander/chuch/crayfish/bleak/roundel/eelpout/tench/navaga + rudd/cisco этап 35; веса `LAKE_DAY_WEIGHTS`/`LAKE_NIGHT_WEIGHTS`), `SEA_SPECIES(_NIGHT)` — только 5 морских (`SEA_IDS`: herring/mackerel/flounder/tuna/swordfish; веса `SEA_*_WEIGHTS`), `OCEAN_SPECIES(_NIGHT)` — только 9 океанских (этап 36, `OCEAN_IDS`: moray/grouper/turtle/angler/octopus/manta/shark/squid/whale; веса `OCEAN_*_WEIGHTS` — «с потолка», точный баланс отдельным этапом через tools/balance.mjs), `SWAMP_SPECIES(_NIGHT)` — только 6 болотных (этап 45, `SWAMP_IDS`: glowfin/moonfish/emberfin/violetlure/spiritfin + meowfish «Которыбка» (экс-целакант), Этап 56; веса `SWAMP_DAY_WEIGHTS`/`SWAMP_NIGHT_WEIGHTS`). Этап 38: лестница веса `wMin/wMax` — Озёра ×8, Море ×6 (рыба-меч ×4), Океан ×4 (синий кит ×2 — чтобы остался вываживаемым), Река НЕ меняется: дороже вода = тяжелее рыба = сложнее бой (дольше `d0=45+7·w`, сильнее `ov→aggr`). Этап 40: ночные `*_WEIGHTS` (Озёра/Море/Океан) подтянуты к «ночь доходнее» + доля сельди/скумбрии в Море снижена (день 82→79%, ночь 78→64%) — цифры см. строку «Баланс Озёр». `SPECIES`/`SPECIES_NIGHT` — полный словарь 38 видов; ночные веса реки — в `NIGHT_WEIGHTS`, ключ обязателен каждому id (иначе `weight=undefined`). **Новые виды добавлять только в КОНЕЦ `SPECIES`** — `SPECIES[0..7]` запинены тестами (§573/§1524/§2446 `SPECIES[0]`, §9j/M4/M6 по id) и квестами (`QUEST_TPLS` индексы 0..2); вставка в середину молча сломает их. `pickSpecies()` выбирает таблицу по `save.location` (0/1/2/3/4) и dayPhase (логика ролла та же) — ТАБЛИЧНЫЙ доступ `SPECIES_BY_LOCATION(_NIGHT)` по `save.location` с guard'ом (вне 0..4 → Река; роллы 0..3 идентичны прежним, этап 45); босс — вид `BOSS_BY_LOCATION[save.location]` текущей локации (Этап 37/45/56: стурдж/рак/рыба-меч/кит/которыбка; runtime-флаг, новых видов нет — см. строку «Босс (M4)»); ачивка species_8 — «Поймай все виды» (все 38, check = `SPECIES.every`, id не менять — старые сейвы). Ачивки локаций (этап 22/36/45): `lake_first`/`sea_first`/`ocean_first`/`swamp_first` — locations-based (проверка `save.locations`), не caught-based — пин §10c(8) achBonus не трогает, кроме `swamp_first` (её `coinPct:0.02` двигает пин 0.16→0.18, этап 45). Этап 43 (визуальное различение): значения `water` — Море светлая бирюза / Океан глубокий тёмно-синий, Река/Озёра не тронуты (тест пинит только ФОРМАТ 6 hex, значения можно двигать); `LOCATIONS.*.waves` — характер волн поверхности в `drawWater()` (amp/amp2·freq/freq2·speed/speed2; amp/amp2=0 — линия НЕ рисуется: Река — без волн, спокойная вода (ревизия Этапа 44); Озёра — медленная гладь, Море — умеренная волна, Океан — крупные зыби); `AMBIENT_FISH` (секция декораций, перед `initFish()`) — размер/оттенок/число фоновых рыб по локации (Река 9×8–22 как было, Озёра 9×10–26 зелёные, Море 8×12–32 синие, Океан 6×18–44 тёмно-синие, Болото 7×12–30 с `palette` из 4 цветов свечения — циан/зелёный/фиолет/золото; `initFish()` пишет цвет в `f.glow` по индексу рыбы, у локаций 0..3 он `null`); `initFish()` — вызовы: старт + ОБЕ ветки смены локации в `shopClick()` (buylocation/selectlocation) — новую точку смены локации без `initFish()` не добавлять. Чисто визуал — на роллы/баланс/физку не влияет. Этап 44 (береговые силуэты): `scenery`/`initScenery()` (секция декораций, после `initFish()`): Река — береговая полоса НА ВСЮ ШИРИНУ `{k:'bank',h}` (трава 12–17 px + тёмная кромка у воды) + лес в 2 ряда, посаженный НА КРОМКУ `{k:'pine',layer,by}` (`by` = верх кромки; без `by` — линия воды), Озёра — холмы `{k:'hill',rx,ry}` + деревья `{k:'tree',h}`, Море — парусник `{k:'ship',x,v,s,dir}` (дрейфует по курсу) + 3 чайки `{k:'gull',y,v,ph}` (летят, машут), Океан — ПУСТО (открытый горизонт); дрейф парусника/чаек — `updateDecor(dt)`; отрисовка `drawScenery()` — между `drawSky()` и `drawWater()` (вода перекрывает базу силуэтов); ночь — `dusk()` гасит силуэты к #0b1220 (nm×0.8), паруса/чайки темнеют. Вызовы `initScenery()`: `resize()` + ОБЕ ветки смены локации в `shopClick()` (рядом с `initFish` — новую точку без неё не добавлять) + кадры lake/sea/ocean в gen-screenshots.js. Этап 45 (свечение и декор Болота): у болотных видов поле `glow:'#hex'` (у 5 видов этапа 45 — по одному на редкость r0–r4; Этап 56: +которыбка `#ff9ecb`, второй r4 — всего 6 разных цветов); ночная аура — ПЛАВНЫЙ ramp `glowIntensity()` (ревизия: 0 при `nightMix()<=0.35` как старт фонаря, smoothstep до 1 при `>=0.9`), компактный ореол `drawGlowAura(x,y,r,hex,I)` (радиальный градиент с крутым профилем 0.55/0.30/0 от тела рыбы + `globalCompositeOperation='lighter'`, `save/restore`, ранний выход при `I<=0.02`; rgba-строки кэширует `GLOW_RGBA`), радиус ambient `size*1.5`, bite/hooked `bs/fs*1.5` — контур рыбы чёткий (силуэт светящегося вида непрозрачный, аура позади), общий хелпер `fishGlow(sp,x,y,r)` для подплывающей/зацепившейся/вываживаемой рыбы, фоновые — в `drawAmbientFish()` по цвету `f.glow` из `palette`; карточка улова — класс `glow-card` + CSS-переменная `--glow` (только normal-вариант — не спорить с фильтрами вариантов; CSS-правило `#card.glow-card .bigemoji`), дневник — inline `filter:drop-shadow` на SVG (`class="glow-fish"`). Декор: ветка `i===4` в `initScenery()` (bank + reed + snag + pine болотной гаммы) и отдельные от `scenery` слои `pads[]` (8–14 кувшинок, у 45% — лилия жёлтая/белая/розовая) и `frogs[]` (3–5 лягушек, размер `s`≈9–14 px — заметны на телефоне; вся отрисовка `drawSwampDecor()` масштабируется от `s`; прыжки `sit`→`jump` по параболе на соседнюю кувшинку, `jh` 16–30) — очищаются/пересобираются в `initScenery()`; покачивание кувшинок и прыжки — `updateDecor(dt)`; отрисовка `drawSwampDecor()` — в `draw()` после `drawWater()`/`drawAmbientFish()` и до `drawBoat()` (поверх воды, чтобы `dusk()` берега не гасил декор); `initScenery()` вместе с `pads`/`frogs` зовётся в `resize()` + ОБЕ ветки смены локации в `shopClick()`; кадры swamp/swamp-night в gen-screenshots.js.
- **Баланс Озёр (этап 34):** ожидаемая выручка за улов = Σ(w·V)/Σw, V — середина диапазона веса × цена. `pickSpecies()` нормирует веса, так что **умножение всех весов на константу доход НЕ меняет** — для «стало дороже» правят СДВИГ долей (меньше `carass`/`bleak` — самые дешёвые V≈9/6 🪙, больше `sturge`/`gold`/`catfish`/`tench`/`navaga`). Текущие ориентиры: Река день 65.1 / ночь 125.9 🪙 (не меняются с этапа 34); этап 38: лестница веса `wMin/wMax` (Озёра ×8, Море ×6 — меч ×4, Океан ×4 — кит ×2); этап 39: цены Озёр/Моря/Океана урезаны к целям (по дню) Озёра ≈×3 Реки, Море ≈×4, Океан ≈×5; этап 40: ночные `*_WEIGHTS` подтянуты к «ночь доходнее» + доля сельди/скумбрии в Море снижена — актуальные пины: Озёра 194.1 / 249.0 (×2.98/×1.98 Реки), Море 297.3 / 476.7 (×4.57/×3.79), Океан 329.1 / 552.7 (×5.06/×4.39); этап 45/53/55: Болото **302.9 / 342.3** 🪙 (ночь/день ×1.13; **Этап 53 доходность Болота опускали до уровня Озёр и ниже, но Этап 55/56 добавил Которыбку (meowfish, r4, 50🪙/кг, 20–80 кг, ролл 4) и сознательно вернул Болото выше Озёр — решение владельца: «дорогая которыбка важнее инвариантов»; по 🪙/мин Болото лидирует среди «средних» вод**) — порядок вод по цене: **Река → Озёра → Болото → Море → Океан**; ночь/день: Река ×1.93, Озёра ×1.28, Болото ×1.13, Море ×1.60, Океан ×1.68; инвариант «новая (по цене) вода доходнее предыдущей в ОБЕ фазы» для Болота **не выполняется сознательно с Этапа 55** (Болото/Озёра per-catch ×1.56/×1.37, а днём Болото обгоняет и Море — ×1.02; Море/Болото ×0.98/×1.39) — остальные пары держатся (Озёра/Река ×2.98/×1.98, Океан/Море день **×1.11 — тонкий запас**) — проверять при любой правке `*_WEIGHTS`/`price`/`wMin/wMax`; считать руками не нужно — см. строки «Баланс-скрипт»/«Прогрессия». **Минимальный вес вида ≥ ~2.2**: ниже — тест lc4 (3000 роллов, «каждый вид ≥1») начинает плавать.
- **Баланс-скрипт (`tools/balance.mjs`):** `node tools/balance.mjs` — считает доходность рыб ЗА ВАС, ручные прикидки Σ(w·V)/Σw больше не нужны. Вывод: по каждой из 10 таблиц ролла (Река/Озёра/Болото/Море/Океан × день/вечер-ночь; Болото добавлено этапом 45) — виды (вес/доля %/V/вклад) и итог E[🪙 за улов], сводка-матрица с отношениями соседних вод в обеих фазах (Озёра/Река, Болото/Озёра, Море/Болото, Океан/Море — пары строятся ПО ЦЕНЕ воды, а не по порядку массива `LOCATIONS`: Болото 10000 стоит последним, но по цене между Озёрами и Морем — инвариант «каждая новая (по цене) вода доходнее предыдущей в ОБЕ фазы»; для Болота — сознательное исключение с Этапов 53/55), «здоровье» (⚠ если у самого редкого вида P(промаха за 3000 роллов) > 0.1% — ориентир lc4 «каждый вид ≥1», соответствует вес ≥ ~2.2 при Σw≈95) и проверки целостности (пересечения таблиц, нечисловые веса, недостижимые виды). Данные берёт ПРЯМО из index.html: вырезает секцию «ДАННЫЕ» по якорям `const SPECIES=[` … закрытие таблицы `VARIANTS` и исполняет в изоляции (переименование якоря → понятная ошибка скрипта, чинить в самом скрипте) — правки баланса видны сразу, ничего дублировать не нужно. Модель ролла та же, что `pickSpecies()`: по умолчанию нейтрально (lure rare=0, dist=1 — штраф `minDist` ×0.06 не действует, как в пинах и lc4); опции: `--dist 0..1` (штраф дальних видов), `--lure <rare>` (буст `1+rare·rarity` — снасть может менять сравнение локаций, не путать с пинами), `--set id:вес` (what-if, можно несколько раз: переопределяет вес вида во ВСЕХ его таблицах — день и ночь; НЕ сохраняется), `--price id:цена` (what-if, можно несколько раз: переопределяет цену вида 🪙/кг; НЕ сохраняется — так же настраивали цены этапа 39), `--help`. Варианты рыб — строкой в шапке: E[mult]≈1.36 нейтрально / ≈1.69 при дожде — одинаково для всех локаций, на СРАВНЕНИЕ не влияет (босс «Осётр» — вне ролла, в доходность не входит). **Пины при нейтральной снасти (сверять до и после правок): Река 65.1/125.9 · Озёра 194.1/249.0 · Болото 302.9/342.3 · Море 297.3/476.7 · Океан 329.1/552.7 (день/ночь 🪙; этапы 38–55: лестница весов + урезанные цены + ночные веса + Болото с которыбкой).**
  - **Прогрессия (`tools/progression.mjs`, Этап 53):** `node tools/progression.mjs` — модель «за сколько минут игрок дойдёт до цели»: берёт цены/статы из index.html, моделирует улов (`pickSpecies`+`rollWeight`+варианты+обрыв по `maxW`) и цикл ловли (`biteChance`/таймеры/fishForce/updateReel ботом), прогоняет жадный маршрут покупок и печатает доход по водам (🪙/мин) + ETA целей. Опции: `--route`, `--start-coins`, `--per-day`, `--samples`, what-if `--rod/--lure/--loc/--rod-upg/--lure-upg/--upg-mult/--set/--set-day/--set-night`. **Калибровочные цели Этапа 53, пересняты на Этапе 55/56 после добавления болотной Которыбки** (модель «идеального» игрока): Стекло ~4.5 мин · Озёра ~10.5 · Карбон ~7 · Болото 22.7 (12.2 после Озёр) · Титан ~38 мин · Море 1 ч 29 · Океан 3 ч 14. Любую правку цен/весов сверять этим скриптом.
  Цикл настройки баланса новой локации: (1) новые виды — только в КОНЕЦ `SPECIES` + ключ каждому id в `NIGHT_WEIGHTS`; (2) свои `*_IDS` + `*_DAY_WEIGHTS`/`*_NIGHT_WEIGHTS` без пересечений с другими водами (пин lc2 + проверка скрипта), развилка таблиц в `pickSpecies()`; (3) крутить доли прикидками без правки игры: `node tools/balance.mjs --set zander:30 --set bleak:5` (id — латиницей!) до нужных цифр — двигают СДВИГ долей, ×константа всех весов доход не меняет; (4) перенести финальные веса в index.html и перегнать скрипт БЕЗ `--set` — цифры обязаны совпасть с what-if; (5) цена/веса самих видов (`SPECIES`) — тоже видны скрипту сразу, но их правки могут задевать другие локации (общий словарь!) — пересчитать всё; (6) прогнать плейтест (lc2/lc4 и пины §9j/M4/M6 — река не должна меняться).
- Сложность вываживания: `updateReel()`.
- Физика боя (спринт 4): `fishForce()` (сила рыбы: рывок `(16+34·st)·(0.5+0.9·ag)·(0.7+0.5·ov)`, затишье `5+7·ag`, уставшая ×0.45) и `updateReel()` — выносливость `st` (старт `st0`, флаг `tired` при `st≤0.12`: рывки ×0.45, втягивание быстрее до ×1.6), тормоз катушки (черта `drag` в `RODS`: в рывке выше тормоза леска скользит `over·0.22`), натяжение (`10+over·1.1+22·ag`, ×0.35 в затишье), втягивание `(11+3·reel)·(1+0.6·(1−st))`, свободный бег `F·0.32`, escape-бар растёт только при затишье без удержания (отпускание в рывок безопасно), near-miss `1.45·d0`, `d0=45+7·w`. Пустые клёвы: ролл `biteChance()` в ветке WAIT (тест-форс `forceBite`). Тесты (§10) завязаны на эти константы — при ребалансе гонять Monte-Carlo точными формулами (docs/PHYSICS-RESEARCH.md, §4.7) и править тесты в том же коммите.
- Награды (M2): шаблоны квестов `QUEST_TPLS`, награды стрика `STREAK_REWARDS`, достижения `ACHIEVEMENTS` — секция «M2. Награды» после сейва. Этап 22: ачивок 29, этап 36: 31 (+`sea_first`/`ocean_first` — locations-based, пин §10c(8) не трогает), этап 37: 34 (+`lake_boss`/`sea_boss`/`ocean_boss` — пер-босс, БЕЗ coinPct, пин §10c(8) не трогает), этап 45: 36 (+`swamp_first` — locations-based, `coinPct:0.02`; `swamp_boss` — пер-босс, БЕЗ coinPct), этап 46: 38 (+`aq_first` «Первый жилец» / `aq_full` «Аквариум полон» — аквариум, `bonus:{}`, пин §10c(8) не трогают), **этап 59: 39** (+`line_first` «Тонкая снасть» — скин лески, `bonus:{}`, пин §10c(8) не трогает; тест §22(2) пинит `ACHIEVEMENTS.length===39`) (идут `ACHIEVEMENTS`-записями по темам: снасти у экономики, варианты/погода/вес/ночь у рыболовных, скины/локации/аквариум у магазинных); новые счётчики сейва `save.kgTotal`/`nightCatch`/`wxRainV`/`wxFog` (чтение через `||0` — без миграции) ставятся в `catchFish()` до `checkAchievements()` (rain-счётчик — только вариант ≠ normal, босс всегда normal); тест-пин §10c(8): сумма `achBonus().coinPct` (все 8 видов × 8 вариантов) = 0.18 (этап 45 добавил `swamp_first` +0.02; старые пины 0.16 обновлены; этап 46 не меняет — aq-ачивки с `bonus:{}`).
  - **Этап 53 (масштабирование квестов):** `questScale()` = `clamp(round((save.earned/2000)^0.6),1,30)` — метрика `save.earned` (только доход с рыбалки; награды квестов его не разгоняют). `QUEST_TPLS.make(r)` масштабирует ВСЕ шаблоны: `earn_coins` goal×scale (reward = round(goal·0.25)); `casts` ×(1+0.15·scale); `catch_weight` порог от `localMedianW()` (медиана середин весов рыб ТЕКУЩЕЙ локации ×scale^0.35, а не фикс 2/3/5 кг); `catch_rarity` r = clamp(1+floor(1.5·log10(scale+1)),1,4); `catch_species` вид — из `SPECIES_BY_LOCATION[save.location]` с rarity≤2 (не только речные 0..2), `questText` RU/EN терпим к неречным id (fallback `trName`). `qReward(base)` = `round(base·scale^0.6)`. Первые 8 видов и порядок `SPECIES` не тронуты. Тесты §9e2.
  - SDK Яндекс Игр (Y1): секция «Y1: SDK Яндекс Игр» перед «ЦИКЛ» — обёртка YG (стаб при file:// без ?sdk=1: скрипт не создаётся, no-op'ы + счётчики counts), динамическая загрузка /sdk.js (http(s)) с retry/warn, LoadingAPI.ready() первым кадром, GameplayAPI.start/stop в btnPlay/openShop/closeShop/btnGmResume (в гменю-флоу stop даёт `YG.onPause()`, дублей нет — пин §Y8(4)), game_api_pause/resume + visibilitychange → YG.onPause/onResume (AC.suspend, пауза всего игрового времени в frame()).
- Реклама (Y2): константы `AD_FIRST_MS`/`AD_COOLDOWN_MS` (секция Y1), точка interstitial — `tryInterstitial()` в хендлере `btnCardOk` (гейт: первый показ ≥2 мин сессии, кулдаун 3 мин; `lastAdTs` — осознанно «попытка», не показ — при троттлинге платформы wasShown=false кулдаун сгорает), RV-кнопка `#btnRv` «📺 Реклама: ×2 за этот улов» на карточке улова (`showCard` сбрасывает `rvVal`/`rvDone`), методы `YG.showFullscreen/showRewarded` (+watchdog 90 с), `endAd()`; карточка улова БЕЗ `gameplayStop()` — осознанно (часть цикла улова); реклама не персистится в сейв (только `persist()` перед показом и после бонуса).
- i18n (треб. 2.14/2.2): таблица `T={ru,en}` (единая точка строк UI), `t(key)`/`tt(key,o)`, `LANG` (дефолт `ru`), `forceLang` (тест-форс), `setLang()` (обновляет `<html lang>`/`<title>` + пере-рендер меню/статичного UI и открытых оверлеев — магазина/карточки), `resolveLang(ysdk)` — резолюция: `forceLang` → `ysdk.environment.i18n.lang` → `ru`; стаб (file:// без SDK) — всегда `ru` (`navigator.language` НЕ используется — ломает headless-тесты). `trName`/`trDesc`/`trRarity` — выбор по `nameEn`/`descEn`/`RARITY_NAMES_EN` в таблицах данных. Меню — `renderMenu()` (device-aware: тач/мышь, `IS_TOUCH`). EN-ветка `questText()` (RU-ветка с `pluralN` не меняется).
- Пауза (треб. 6.3/1.3): HUD-кнопка `#btnPause` (⏸) → `openPause()` (гарды MENU/uiOpen/adShowing/pauseOpen; `YG.onPause()` + оверлей `#pause`); `#btnPauseResume` → `closePause()`, `#btnPauseMenu` → хаб «Меню» `#gamemenu` (с `YG.onResume()`). Гард `pauseOpen` в `YG.onResume` (после `adShowing`) — blur/focus/visibilitychange во время открытой паузы не снимают паузу (снимут только `closePause()`/«Продолжить» гменю). `window blur` → `YG.onPause()`, `focus` → `YG.onResume()` (треб. 1.3, дополнение к visibilitychange). Видимость `#btnPause` и `#btnRecall` — в `syncDom()` (вызывается каждый кадр в `frame()` вне `YG.paused` — без этого `#btnPause` «залипает» видимым за оверлеями). Сам оверлей `#pause` — частный случай правила «мировое время стоит под `uiOpen`» (см. строку «Ночь (M3)»): под паузой `uiOpen=true`, поэтому день/ночь и погода не идут.
- Хаб «Меню» (Э29): оверлей `#gamemenu` — кнопки «Продолжить» (`#btnGmResume`: uiOpen=false + `YG.gameplayStart()`), Магазин/Достижения/Дневник (`fromMenuShop(tab)` → `openShop('tackle'|'ach'|'journal')`), «Инструкции» (`#btnGmHowto` → `#menu`; «Играть» вернёт в игру), звук `#btnMute` и сброс `#btnReset` (→ `#resetDlg`) — ПЕРЕНЕСЕНЫ из HUD (id сохранены; в `.hudbtns` остались только 🛒 и ⏸). «В меню» НЕ меняет `state` — сессия (заброс/вываживание) заморожена под оверлеем и продолжается с того же места; `state='MENU'` теперь только при загрузке/после сброса (там показывается `#menu` с инструкциями — «старт новой игры» прежний). Флаг `shopFromMenu`: лавка, открытая из «Меню», при × возвращает в `#gamemenu` (uiOpen остаётся true, БЕЗ `YG.gameplayStart()`); лавка из HUD/`#coins` — как раньше, в игру. Z-порядок: `#gamemenu` в DOM позже `#shop`/`#resetDlg` (тот же z-index) — при открытии лавки/сброса из «Меню» гменю прячется, иначе перекрыл бы их. **Этап 59:** «Аквариум» и «Инструкции» стоят ПАРОЙ в строке (`.mbtn.mbhalf` + `.mbtns.flexrow`) — бар сцены банки вырос на 2 пилюли, и на телефоне 9 кнопок столбиком не влезали в 844px (кнопка «Аквариум» уезжала за экран — клики в тестах падали).
- Монеты → лавка (Э29): клик по `#coins` (pointer-events:auto + cursor в CSS) → `openShop('tackle')` — «Лавка рыбака» на вкладке «Лавка» (`#tabTackle`, эмодзи 🛒, `T.tab_tackle` 'Лавка'/'Shop'; RU-секции «🎣 Удилища»/«🪱 Приманки» внутри не тронуты). `openShop(tab?)` — аргумент форсит вкладку (`syncTabs()` синк активных классов, вынесен из `setTab`); HUD 🛒 зовёт `openShop()` без аргумента — помнит последнюю вкладку.
- **Иконки лавки (Этап 60, чистый визуал):** у записей `LOCATIONS`/`BOAT_SKINS`/`BOBBER_SKINS`/`LINE_SKINS` поле `icon` (как у `RODS`/`LURES`); `skinRow`/`locationRow` рисуют его `<span class="itemicon">` ДО `.itemname` — ВНУТРЯ нельзя: тесты сверяют текст `.itemname` строго (`=== 'Красная лодка'`, §скины(4)/(7)); у строк снастей иконка по-прежнему инлайн в `.itemname` (тесты там через `includes`). Кнопка апгрейда снасти вместо generic `⬆` показывает `item.icon` (fallback `⬆`) — тест M3(e) проверяет `indexOf`, зелёный. Иконки: локации 🏞️ 🛶 ⛵ 🌊 🐸; лодки 🛶 🔴 🏠 🐉 🚤; поплавки ⚪ 🔴 💚 ✨ 🔔; лески 🪢 💚 🪡. Новые emoji — перегенерирован `tools/emoji-font.py` (субсет 53→65 глифов); для ⛵/⚪/🏞️ FE0F (текстовая презентация по умолчанию — как 🗺️/⚠️ в файле).
- Закрытие по тапу мимо диалога: `backdropClose(el,fn)` (секция «КНОПКИ», после Y2-хендлеров) — `pointerdown`, где `e.target ===` сам оверлей (тап на подложку, не .panel), закрывает диалог тем же действием, что и кнопка: `#shop`→`closeShop`, `#resetDlg`→«Отмена» (`btnResetNo.click()`), `#pause`→`closePause`, `#gamemenu`→«Продолжить» (`btnGmResume.click()`), `#aqPick`→`closeAqPick` (Этап 52), `#aqShop`→`closeAqShop` (Этап 62). `#menu` — экран старта, не диалог. Новый оверлей-диалог без `backdropClose` не добавлять. **Карточка улова `#card` — ОСОЗНАННО ВНЕ `backdropClose`** (ревизия): случайный тап мимо НЕ закрывает её и не дёргает интерстишел; закрывается только явными кнопками (`#btnCardOk`/`#btnKeep`, каждая со своим хендлером и гейтом рекламы). Тест §X(5) пинит именно это (тап мимо → карточка открыта, `state='CARD'`; ждёт 400 мс — pop-анимация `#card{animation:pop .3s}` сужает hit-area подложки).
- Встроенный emoji-шрифт (Э28): все emoji UI и canvas рисует вшитый шрифт — субсет Noto Color Emoji (COLRv1, OFL) как base64 `@font-face font-family:'EmojiEmbedded'` в index.html между маркерами `<!-- EMOJI-FONT:BEGIN/END -->` (внешний .woff2 невозможен: публикуется только один index.html). В font-stack `html,body` и во всех `ctx.font` (константа `UI_FONT`, секция «ОТРИСОВКА») стоит ПЕРВЫМ — единый Google-стиль emoji на всех платформах; headless-скриншоты не зависят от системных шрифтов. Первый кадр ждёт `document.fonts.load('16px "EmojiEmbedded"')` с timeout-фолбэком 1.5 с. Генератор `tools/emoji-font.py` (venv: `python3 -m venv tools/.venv && tools/.venv/bin/pip install fonttools brotli`; исходник `tools/fonts-src/NotoColorEmoji-Regular.ttf` из google/fonts, всё в gitignore): `python3 tools/emoji-font.py` — перегенерация по текущим emoji index.html (ОБЯЗАТЕЛЬНО при добавлении новых emoji), `--check` — падает, если субсет не покрывает index.html (✓ № ● ○ ↩ — в NCE их нет, это ок, рисуются системными шрифтами). Тест §Y7 (tests/test.js) гоняет `document.fonts.check('16px "EmojiEmbedded"','🪙')`; семейство переименовывать нельзя (тест + @font-face + UI_FONT).
- **Портреты рыб (SVG-спрайт)**: исходники `assets/fish/fish-<id>.svg` (38 файлов — болотных 6, посл. «Которыбка» (meowfish), этапы 55/56, viewBox 0 0 160 100, цвета `var(--f1..f4, hsl-fallback)`; переменные НЕ объявлять на `<svg>`/`<g>`); встраивание — `node tools/embed-fish.mjs` (идемпотентно, блок между маркерами `FISH-SVG:BEGIN/END` в index.html, сразу после `<body>`; самопроверка + `check.mjs` внутри); приёмка — `tools/fish-preview.html` (file://); дневник/карточка показывают через `<use href="#fish-<id>">` (дневник `.jrow .je svg`, карточка `#cardEmoji svg`, `showCard` ставит href у `#cardFishUse`); перекраска вариантов — CSS-переменные `--f1`/`--f3` в `#card.<variant>-card .bigemoji` (наследуются сквозь `<use>`; silver/rainbow — существующие filter); правка портрета = правка `assets/fish/*.svg` + повторный запуск embed-скрипта. Эмодзи рыб УБРАНЫ (этап 42): поле emoji удалено из SPECIES, тосты без эмодзи, иконка квеста catch_species — mini-SVG `<svg class="qfish"><use href="#fish-<id>">`; субсет emoji-шрифта перегенерирован (рыбных глифов нет).
- **Favicon (Этап 54)**: логотип вшит в `index.html` как `data:`-URI PNG — внешняя иконка в архив Яндекс Игр не доехала бы (публикуется только `index.html`), а data:-URI работает и под `file://`, и в iframe площадки. Генератор `tools/favicon.mjs` (чистый Node, без зависимостей, идемпотентно, маркеры `<!-- FAVICON:BEGIN/END -->` сразу после `<title>`): декодирует `logo.png` (512×512 RGB, собственный PNG-декодер на zlib), area-average ресемплит в 64×64 (`rel="icon"`) и 180×180 (`rel="apple-touch-icon"`), кодирует PNG с адаптивным фильтром строк (эвристика libpng), кладёт base64 в `<link>`; самопроверка + `check.mjs` внутри. Обновить иконку = заменить `logo.png` + `node tools/favicon.mjs`. Маркеры снимаются минификатором (их нет в списке исключений EMOJI-FONT/FISH-SVG) — в релизе остаются только `<link>` с data:-URI; проверки `pack.mjs`/`minify.mjs` не затронуты.
- **Аквариум (Этап 46)**: декоративная сцена коллекции ЭКЗЕМПЛЯРОВ (вид+вариант+вес), **НЕ локация** — в `LOCATIONS`/`SPECIES_BY_LOCATION`/`BOSS_BY_LOCATION` не входит, роллы/боссы/баланс/пины не трогает (`tools/balance.mjs` не менялся). Данные: `save.aqFish[]` (`{id,v,w}`) + `save.aqSlots` (старт `AQ_BASE_SLOTS=6`, макс `AQ_MAX_SLOTS=12`), константы `AQ_BASE_SLOTS`/`AQ_MAX_SLOTS`/`AQ_SLOT_COSTS=[1500,4000,9000,20000,45000,100000]` в секции ДАННЫЕ рядом со скинами/локациями. **Модель C — бесплатная КОПИЯ**: `catchFish()` НЕ меняется (монеты/квесты/ачивки/реклама начисляются на улове как раньше), кнопка `#btnKeep` «🐠 В аквариум» на карточке улова (`cardSpec={sp,w,variant}` в `showCard()`) **Этап 52: открывает DOM-диалог выбора слота `#aqPick`**, а не кладёт рыбу сразу (см. отдельный пункт «Диалог слота аквариума (Этап 52)»). `syncKeepBtn()` теперь держит кнопку **всегда активной** (подпись/`title` = `aq_keep`), логика «Нет места»/`disabled` убрана: из диалога можно заменить занятый слот или докупить новый. Сцена: `aqOpen`, `aqFishRt[]` (раскладка `x,y,dir,ph,spd,vy,tail` — НЕ персистится, индекс = `save.aqFish`), `aqSel` (сентинел `-1` = ничего), `aqTank`/`aqPlants`/`aqBubbles`, `initAquarium()`/`updateAquarium(dt)`/`drawAquarium()` (вода `hexLerp` к `nightMix()` — общий цикл суток; размер `aqFishSize(w)` — от АБСОЛЮТНОГО веса по общей с вываживанием кривой `fishSizeFromW()` (Этап 41): `clamp(fishSizeFromW(w)·AQ_FISH_SCALE·k, AQ_FISH_SIZE_MIN·k, min(W,H)·AQ_FISH_SIZE_REL)`, `AQ_FISH_SCALE=2.1`/`AQ_FISH_SIZE_MIN=10`/`AQ_FISH_SIZE_REL=0.30`, масштаб экрана `k=clamp(min(W,H)/AQ_TANK_REF, 1, AQ_MAX_K)` — ПЛАВНЫЙ (`AQ_TANK_REF=360` → k=1, `AQ_MAX_K=2.4`; десктоп 1280×720 → k=2), верхний кап НЕ умножается на `k`; правка после Этапа 46 + ревизия размера (`w/wMax`+`rarity` не влияют), раньше был бинарный `AQ_DESKTOP_SCALE=2` при `min(W,H)>=600`; сетка стартовых позиций, разворот у стенок (per-fish `rise=size*0.65` держит крупную рыбу ниже бара/выше грунта), пузыри). **Ревизия: жильцы банки — те же SVG-портреты, что на карточке улова** (DOM-слой `#aqFishLayer` поверх canvas, спрайт `#fish-<id>` + вариант `.var<id>`/`--f1`/`--f3` 1:1 с карточкой; `aqBuildFishEl(i)`/`aqPlaceFish(el,rt)`/`aqFishEls[]`, transform обновляется в `updateAquarium`; слой включается только под `body.aq-open`, `pointer-events:none`, `clip-path` по банке). На canvas — вода/грунт/растения/пузыри/стекло, свечение болотных `drawGlowAura`+`glowIntensity()` (уходит ЗА портрет) и рамка выбора; `drawFishShape` в банке больше не используется (остался для рыб в сценах ловли). Точки жизненного цикла: `frame()` (`if(aqOpen) updateAquarium(dt)`), `draw()` (`if(aqOpen){ drawAquarium(); ctx.restore(); return; }` — банка ВМЕСТО озера), `onDown()` (ранний `if(aqOpen){ aqTap(x,y); return; }`), `resize()` (`if(aqOpen) initAquarium()`), `syncDom()` (под `aqOpen` `#btnPause`/`#btnRecall` не показываются). DOM: вход `#btnGmAquarium` в хабе `#gamemenu` → `openAquarium()`/`closeAquarium()` (аналог `shopFromMenu` — флаг `aqFromMenu`, «Назад» возвращает в гменю; `YG.gameplayStop()`; `uiOpen=true`); бар `#aqBar` (Этап 62: `#btnAqBack`, `#aqCount` «N/M», пилюля `#btnAqShop` «🛒 Улучшения» → диалог `#aqShop`; прежние `#btnAqSlot`/`#btnAqFloor`/`#btnAqDeco` убраны), поповер `#aqPop` (`#aqPopName`/`#aqPopSub` — вес · редкость, БЕЗ цены; Э64: кнопок в поповере нет — чистое инфо), тап по рыбе `aqTap(x,y)` (ближайшая в радиусе → `aqSel` → `showAqPop()`). «Выпустить» — Э64: **только из диалога «Слоты»** (`#aqShop`, кнопка на строке жильца + подтверждение, см. пункт Этапа 62) → `aqReleaseAt(i)` — точечное удаление экземпляра ИНДЕКСАМИ (без `initAquarium`, позиции остальных сохраняются; `aqSel` при необходимости сдвигается/снимается) **БЕЗ монет** (освобождение слота; продажа из банки была в плане §7, но по решению владельца заменена на выпуск — экономика не затронута; прежняя кнопка `#btnAqRelease` в поповере убрана). Миграция `loadSave()`: `aqFish` фильтруется по `SPECIES` (`Number.isFinite(w)&&w>0`), вариант → `'normal'`, `aqSlots` — `Math.trunc` + клампы `AQ_BASE_SLOTS..AQ_MAX_SLOTS`, хвост обрезается по слотам. Ачивки 36→38: `aq_first` «Первый жилец» / `aq_full` «Аквариум полон» — обе `bonus:{}` (пин `achBonus().coinPct=0.18` не сдвинут).
  **Этап 59 — декор сцены (чистая косметика, coin-sink):** таблицы `AQ_FLOORS` (`{id,name,nameEn,cost,c,c2}` — песок **0** / галька **2500** / тёмный грунт **8000**; `c` — цвет толщи, `c2` — кромки, ночное затемнение то же `nm*0.75`, что у старого песка) и `AQ_DECOS` (`{id,name,nameEn,cost}` — сундук **5000** / коряга **9000** / замок **20000**) в секции ДАННЫЕ рядом с `AQ_*`. Сейв: `save.aqDecor={floor:0,deco:-1}` (экипировка; `deco:-1` — без орнамента), `save.aqFloorOwned:[0]` / `save.aqDecoOwned:[]` (купленные — массивы индексов); миграция в `loadSave()` рядом с `aqFish`/`aqSlots` — дефолты, клампы `floor` 0..2 / `deco` −1..2 (невалид → дефолт), фильтр мусора в купленных, экипировка обязана быть куплена. Отрисовка: грунт в `drawAquarium()` берёт `AQ_FLOORS[save.aqDecor.floor]`; орнамент — `drawAqDeco(nm)` (после грунта/растений, ДО пузырей/стекла/блика, чтобы стекло было сверху; рыбы-жильцы — DOM-слой и так выше): простые фигуры (сундук у правого края: корпус+крышка+золотые полосы; коряга у левого: ствол+отростки; замок по центру у грунта мельче — `s=0.72*k`), масштаб — тот же плавный `k=clamp(min(W,H)/AQ_TANK_REF,1,AQ_MAX_K)`, ночь — `hexLerp(t,'#0b1220',nm*0.55)`; всё в save/restore. UI — **Этап 62: вместо пилюль в баре диалог `#aqShop`** (см. строку «Диалог улучшений аквариума (Этап 62)»); тосты покупки/выбора — `aq_floor_bought`/`aq_deco_bought`/`aq_floor`/`aq_deco`, отказ — `sfx('no')`+`not_enough`. `setLang()` пере-рендерит открытый диалог. Экономику улова/слотов не трогает. i18n: `gm_aquarium`, `aq_title`, `aq_keep`, `aq_back`, `aq_slots`, `aq_buy_slot`, `aq_max`, `aq_release`, `aq_released`, `aq_no_room` (оставлен неиспользуемым), `aq_kept`, `aq_pick_title`, `aq_empty_slot`, `aq_replace_q`, `aq_replace`, `aq_replace_short` (RU/EN). Emoji: 🐠 добавлен во встроенный субсет (перегенерация `tools/emoji-font.py`, `--check` OK). Подводные камни: `body.aq-open` прячет `#hud` (CSS + `syncDom`), а `#aqBar{pointer-events:none}` + `.aqpill{pointer-events:auto}` — иначе невидимая полоса бара перехватывала бы тапы по сцене; сентинел `aqSel=-1` (все проверки индекса — `aqSel>=0`); «выпустить» без монет — не вводить продажу (сознательное решение, дыра ×2 дохода закрыта).
- **Диалог слота аквариума (Этап 52)**: кнопка `#btnKeep` на карточке улова не кладёт рыбу сразу, а открывает DOM-оверлей `#aqPick` поверх `#card` (тот же `.overlay`/z-index 20, в DOM позже — лёг сверху; карточку `uiOpen` не ставит и не морозит мир). Список `save.aqSlots` строк `.aqpickrow` (занятые — `<use href="#fish-<id>">` + имя/вариант/вес, вариант через `aqApplyVariant()` на строку, CSS-фильтры `#aqPickList .aqpickrow.var* .je svg`; пустые — `＋`/`aq_empty_slot`). Логика: клик по пустой строке — `aqPickPlace(i)` (поселить копию `cardSpec` сразу); клик по занятой — `aqPickPending=i`, inline-подтверждение `#aqPickConfirm` (текст `aq_replace_q` с именем, кнопки «Отмена»/«Заменить»), `aqPickConfirmReplace()` меняет экземпляр в слоте (вытесненная рыба выпускается **бесплатно**, как выпуск через `aqReleaseAt` в диалоге «Слоты», экономика не затронута); докупка `#btnAqPickSlot` → `aqPickBuySlot()` — общая `aqBuySlot()` (Этап 62, она же в `#aqShop`; `AQ_SLOT_COSTS`, `disabled` при максе/во время подтверждения). Финиш `aqPickFinish()`: `persist()`/`checkAchievements()`/тост `aq_kept`/`cardSpec=null`/закрытие `#aqPick` И `#card`/`state='IDLE'`/`tryInterstitial()` (как прежний `#btnKeep`). Глобалы `aqPickOpen`/`aqPickPending`, функции `openAqPick`/`closeAqPick`/`renderAqPick`/`aqPickPortrait`/`aqPickPlace`/`aqPickConfirmReplace`/`aqPickBuySlot`/`aqPickFinish`; DOM: `#aqPick`, `#aqPickTitle`, `#aqPickList`, `.aqpickrow(.empty/.replace)`, `#aqPickConfirm`, `#aqPickConfirmText`, `#btnAqPickConfirmNo`, `#btnAqPickConfirmYes`, `#btnAqPickSlot`, `#btnAqPickCancel`. `backdropClose($('aqPick'),closeAqPick)` (тап мимо = отмена, возврат к карточке); `setLang()` пере-рендерит открытый диалог; сброс прогресса закрывает `#aqPick`. Тесты §AQ(4)/(5)/(5b) Этапа 52. `aq_no_room` оставлен в `T`, но не используется.
- **Диалог улучшений аквариума (Этап 62)**: DOM-оверлей `#aqShop` поверх сцены банки — вместо прежних пилюль `#btnAqFloor`/`#btnAqDeco`/`#btnAqSlot` в баре. Вход — пилюля `#btnAqShop` «🛒 Улучшения» в `#aqBar` (в баре остались «← Назад», счётчик `#aqCount`, пилюля входа — media-сжатие ≤520px перенесено на `#btnAqShop`); `openAqShop(tab?)`/`closeAqShop()`/`setAqTab()`/`renderAqShop()`, глобалы `aqShopOpen`/`aqShopTab` (паттерн `aqPickOpen`). **z-index 27** — выше `#aqBar`/`#aqPop` (26), иначе бар лёг бы поверх диалога (общий `.overlay` = 20, переопределён). Две вкладки (`.tabs`, кнопки `#tabAqSlots`/`#tabAqUpg`, пере-подпись из `T`): **«🫙 Слоты»** — все `AQ_MAX_SLOTS` строк `.aqpickrow` (стили `#aqPick`, CSS-фильтры вариантов расширены на `#aqShopBody`): жилец — `<use href="#fish-<id>">`+вариант (`AQ_VARIANT_RECOLOR` inline `--f1/--f3`)+имя/вес/редкость; пустой — `＋`; покупаемый (`i===save.aqSlots`) — `data-act="buyaslot"` с ценой `AQ_SLOT_COSTS`; дальние — 🔒 (гейтинг как `itemRow`); **Э64: жилец — кнопка `Выпустить` (`data-act="askrelease"`)**. **«🪸 Апгрейды»** — секции `sec_aq_floor`/`sec_aq_deco`, строки `aqDecorRow()` по образцу `skinRow` (иконка — поле `icon` в `AQ_FLOORS`/`AQ_DECOS`, паттерн Э60; «Купить N 🪙 / Выбрать / Выбрано ✓»), первой «🚫 Без декора» (`selnone` → `aqEquipDeco(-1)` — снимает орнамент, заменяет прежний цикл к `-1`). Клик — делегирование `#aqShopBody` (`data-act`: `buyaslot`/`buyfloor`/`selfloor`/`buydeco`/`seldeco`/`selnone`/`askrelease`), покупки — общие `aqBuySlot()`/`aqEquipFloor(i)`/`aqEquipDeco(i)` (её же зовёт `aqPickBuySlot`); после `buyaslot` — ещё `renderAqBar()` (счётчик). **Э64 — выпуск только отсюда:** `askrelease(i)` ставит `aqShopRelPending=i` (строка подсвечивается `.replace`), под списком — inline-подтверждение `#aqShopConfirm` (`#aqShopConfirmText` = `aq_release_q` с именем; `#btnAqShopConfirmNo`/`#btnAqShopConfirmYes`, паттерн `#aqPickConfirm`); «Выпустить» → `aqReleaseAt(i)` (без монет), «Отмена» снимает pending; pending сбрасывается в `openAqShop`/`closeAqShop`/`setAqTab` и при сбросе прогресса; кнопка `#btnAqRelease` из поповера сцены убрана. `aqCycleFloor`/`aqCycleDeco`/`aqDecorName`/`aq_floor_short`/`aq_deco_short` — УДАЛЕНЫ. `closeAquarium()` закрывает диалог; `setLang()` пере-рендерит открытый; сброс прогресса — тоже; `backdropClose`. Новое в `T`: `aq_shop_btn`, `tab_aq_slots`, `tab_aq_upg`, `aq_shop_slots`, `aq_slot`, `aq_slot_locked`, `sec_aq_floor`, `sec_aq_deco` + Э64 `aq_release_q` (RU/EN). Новые emoji (🫙🪸🏖️🪨🟫💰🪵🏰🚫) — субсет перегенерирован (65→73 глифа; 🏖️ с FE0F). Тесты §Э62 (открытие/вкладки/покупки/«без декора»/backdrop/слот через диалог/бар из 3 элементов).

## Запуск и публикация

- Dev-сервер: `python3 -m http.server 8000`; игра так же работает с `file://`.
- Процесс разработки, публикация в Gitea, гигиена секретов: `docs/DEVLOG.md`.