- LocationScene: два слоя (fx в мире, uiFx в uiRoot); тост — floatText
  с readSeconds и clear() перед новым (раньше наслаивались); подбор
  интерактива — fx.fade; флэш героя при уроне — fx.flash.
- CombatViews: кольцо резонанса, hitBurst/deathBurst и флэши врагов —
  через fx.ring/fx.burst/fx.flash (ручной массив колец удалён);
  трупы растворяются через FxFade (keep — вьюху чистит сцена).
- Баг: эмиттер мотылей над потревоженным пеплом добавлялся в мир без
  engine.fx — не анимировался и не уничтожался; теперь fx.burst с
  emberPreset, доигрывает и исчезает сам.
- docs/demo.md: строка матрицы про render/fx/.

Co-Authored-By: Claude Code <noreply@anthropic.com>

- Движок: SpriteMotion перезаписывает позицию/поворот только при bob/sway —
  view с чистым blink/pulse можно двигать извне (герой прибивало к точке
  спавна, ходьба выглядела камерным скроллом, по прибытии спрайт
  «возвращался»); detach симметричен; тесты SpriteMotion
- PlayerController: syncView на точном прибытии в waypoint (кадр не отстаёт)
- Звук: ambience/wind — глобальный слой (AmbienceLayerDef.radius опционален,
  нет at/tiles — константная громкость) на лугах и прудах; вода прудов
  тише (0.6→0.35, радиус 6→5); sfx/rustle — редкие дальние шорохи пепла
  из тика сцены (rng сцены, случайные pan/rate). Птиц в мире нет по лору
- Доки: anim.md (правило позиционирования), practices.md (глобальные
  слои, шорохи, «птицы молчат»)

Co-Authored-By: Claude Code <noreply@anthropic.com>

Расталкивание через реестр сцены: герой выталкивает себя из NPC
(PlayerController), враг — из героя, NPC и своих (EnemySystem); каждый
актор двигает только себя (separateCircles). attackStop (0.85) больше
суммы радиусов — авто-атака не дрожит.

A* не ведёт героя сквозь тело: SceneObjects.walkGrid() считает тайлы
NPC занятыми (герой застревал «на носу» у Ирвина — звон в верёвку
не поднимал флаг). Проводка: клик по миру, авто-подход к цели,
scene:route моста.

Карта коллизий агенту: слой s.collision {width, height, blocked (0/1
с footprint пропов), props} + команды scene:walkable {x, y} и
scene:raycast {from, to} (прямая видимость, вода прозрачна). Новый
сценарий checks/collision.mjs: слой валиден, walkable/raycast на
конкретных тайлах, клик в дерево — герой в проходимом, телепорт в
тело спящего ползуна — враг выталкивает себя.

Доки: agent.md (слой + 2 команды), practices.md (ситуация «проверяю
коллизии/движение» + грабли телепорта на тайл перехода).

Co-Authored-By: Claude Code <noreply@anthropic.com>

Новый чистый модуль map/collision.ts в движке: gridOf (Grid из
TileMapData с footprint пропов), точная проверка круга circleFits
(ближайшая точка квадрата Blocked-тайла — ловит угловой прокол по
диагонали), moveCircle со скольжением по осям, pushOutOfWalls для
телепортов, separateCircles для будущего расталкивания тел.

Дедупликация четырёх копий worldToTile+isWalkable: движение героя
(moveFree), шаги врагов, фауна и валидатор контента теперь на одних
функциях. IsometricTileMap.isPropBlocked публичен.

Бой против стен: конус удара требует прямой видимости (hasLineOfSight
по tall + пропам), снаряды гасятся о стены и дома (вода прозрачна —
плевок летит над прудом). Отброс героя — только если тело помещается
(circleFits): прищёлкивание к центру тайла после отброса меняло
динамику погонь у прудов и валило пробу interact-world.

14 юнит-тестов на коллизии (скольжение, угловой прокол, совместимость
с A*-маршрутом, push-out, separateCircles). Доки: maps.md (раздел
«Коллизии»), README.md, llms.txt.

Co-Authored-By: Claude Code <noreply@anthropic.com>

Унификация акторов на движковые аниматоры (три ручных таймера кадров больше не дублируются):
- PlayerController: SpriteAnimator с клипами walk_*/idle_* — ушёл «застыл на произвольном кадре ходьбы»;
- CombatViews: SpriteAnimator (спящим pause), hit/death-бёрсты — oneShot через engine.fx
  (закрыт баг «частицы стоят на месте»), новые опции drag/spin/scaleOverLife/colors;
- FaunaSystem: SpriteAnimator (на ходу walk, в покое стоп-кадр).

Оживление статики в LocationScene (всё тикается engine.fx, без ручного update):
- вода — setTileAnimation (2 кадра, один таймлайн на все клетки);
- мигание героя — SpriteMotion blink с живым duty (вместо ручного alpha);
- NPC idle — кадры npcs_sheet (randomPhase по тайлу), атлас добавлен в BootScene,
  отдельные PNG NPC из списка ассетов убраны;
- искры pickup-объектов — SpriteMotion pulse;
- тёплые мотыльки — эмиттер blend:'add' + wobble + fadeIn;
- кадры героя/фауны — через assets.animation() (анимации атласов из батча 3).
Ограничение: sway для цветов/башни не вводился — это тайлы карты (спрайты
внутри IsometricTileMap), SpriteMotion на них неприменим.

Движок, попутные фиксы:
- Updatables: разрушенные записи не тикаются (Pixi обнуляет transform —
  тик разрушенного SpriteMotion ронял весь тик и молча убивал игру после
  перехода между локациями) + тесты;
- Engine.stepTicks: setManual(false)/resetTiming в finally — исключение в шаге
  больше не оставляет цикл в ручном режиме навсегда;
- EmitterOptions.velocity опционален (в oneShot с radialSpeed не нужен);
- SpriteAnimator/SpriteMotion: геттер destroyed — самозачистка из engine.fx.

Доки: core.md (fx), anim.md (самозачистка), render.md (velocity), agent.md +
practices.md (грабля «мост глотает throw шага» и приём диагностики).

Co-Authored-By: Claude Code <noreply@anthropic.com>

- HazardDef в locations.ts: разметка низин у Серых прудов (требуют cloth)
- герой в накате без маски: скорость x0.5, дымка-оверлей, тост при входе;
  с полотном - только лёгкая дымка
- звон как 'проверка воздуха': резонанс в низине подсвечивает пепел
  вспышками и шипением
- PlayerController.speedMul - множитель скорости, управляется сценой
- фикс: hero_sheet собирался data.set с неверным строковым шагом -
  кадры жались в полосы; теперь построчное копирование

Co-Authored-By: Claude Code <noreply@anthropic.com>

PlayerController, CombatWorld, EnemyBrain, CombatViews и LocationScene
переведены с виртуальных пикселей на мировые юниты (1 юнит = 1 тайл):
- позиции/дистанции/скорости в юнитах (герой 1.75 юн/с, скорости и
  радиусы врагов, knockback 0.75, INTERACT_RANGE 1.5);
- конус/окружности через inConeW/inCircleW (метрика проекции);
- вью-позиции — через worldToScreen, округление до px только на границе;
- гистерезис дистанции плевуна ±0.4 юнита, attackStop 0.85 юнита;
- тесты EnemyBrain/stats обновлены под юниты (185/185).

Co-Authored-By: Claude Code <noreply@anthropic.com>

- Camera.deadZone: цель двигает камеру только у границ окна,
  внутри окна камера неподвижна; Camera.snap — мгновенная постановка
  минуя окно (спавн/респаун)
- SpriteDebugView: текущий кадр героя с целым zoom (nearest) и сеткой
  по границам пикселей (KeyP в локации)
- PlayerController: followPath для готовых путей, currentTexture
- фикс сборки hero_sheet: Buffer.set принимает offset в байтах —
  кадры затирали друг друга, атлас был перемешанным мусором
  (отсюда «сжатый» герой)

Co-Authored-By: Claude Code <noreply@anthropic.com>

- pathfinding.findPathToNeighbor(grid, start, goal): путь к ближайшей
  проходимой клетке рядом с goal (8-соседство) — цель может быть занята
  NPC/объектом или непроходима; тесты (3 новых)
- PlayerController.followPath: пойти по готовому пути тайлов
- LocationScene: клик по NPC/цветку срабатывает только в радиусе 44px;
  издалека герой подходит к краю тайла и взаимодействие срабатывает
  на месте; исключение — force у requestTalk (сюжетные триггеры)
- доки: maps.md (findPathToNeighbor), demo.md (новое в движке)

Co-Authored-By: Claude Code <noreply@anthropic.com>

- VirtualJoystick в LocationScene: включается при первом касании,
  мышь проходит насквозь (клик-ход и бой не задеты)
- прямое движение PlayerController.moveFree с проверкой стен
- DebugOverlay (F3): fps, тайл, позиция, hp/киллы

Co-Authored-By: Claude Code <noreply@anthropic.com>

- encodeMap/parseMap: карты локаций теперь файлы assets/maps/*.map (RLE v1),
  генерируются тестом tools/maps/gen.test.ts (npm run maps), грузятся в BootScene
- LocationScene параметризована LocationDef (spawn, NPC, враги, выходы, амбиент);
  Серые пруды: гладь воды, туман-частицы, 5 сгустков, обратный переход
- переход между локациями по тайлу-триггеру с fade и точкой входа
- SaveSlotsScene: меню сейвов (autosave + 3 слота, listSlots/delete)
- хук window.__game (dev) для смоук-тестов; tools/smoke-ponds.mjs — сценарий перехода

Co-Authored-By: Claude Code <noreply@anthropic.com>

Co-Authored-By: Claude Code <noreply@anthropic.com>

- tools/audio/gen.mjs: генератор WAV из кода (моно 22050, 16-бит, без зависимостей):
  bell_hit, bell_low, ash_hiss, ash_die, spit, hurt, step, ui_click, chime
  + зацикленные амбиенты meadows/ponds (кроссфейд краёв лупа)
- engine: AudioManager.preload — декодирование до первого play
- Game.audio + связка settings.onChange -> setBusVolume
- unlock аудио на первом жесте (main.ts), preload в BootScene
- SettingsScene (Panel+MenuList): громкости master/music/sfx, вход из главного меню
- музыка локаций через Game.playMusic (защита от перезапуска того же трека)
- sfx: шаги героя (PlayerController.onStep), колокольчик реплик (DialogueSystem.onLineShown)

Co-Authored-By: Claude Code <noreply@anthropic.com>

Игра:
- диалоги переписаны на графы DialogueRunner + GameState (тексты сохранены)
- меню на MenuList, шрифт VT323 через PixelText во всех сценах
- герой из атласа hero_sheet (gen.mjs), акторы в IsoDepthLayer
- пепел через ParticleEmitter, fade-переходы сцен, сейв с GameState
- Vite: publicDir: 'assets', алиас regex, шрифт через ?url-импорт

Документация: docs/engine/ — 10 файлов (архитектура, подсистемы, рецепты).
CLAUDE.md и README.md обновлены под новые модули и грабли.

Co-Authored-By: Claude Code <noreply@anthropic.com>

- docs/world.md: библия мира (Великий Пепелопад, звонари, лунные колокольчики,
  регион Низина Звенца, персонажи, арка акта 1)
- docs/art-style.md: арт-библия — палитра 32 цвета, размеры, стиль, чеклист
- tools/pixelart: генератор PNG из кода (тайлы, дерево, герой 3 направления,
  NPC) без внешних зависимостей
- игра: загрузка ассетов через AssetLoader в BootScene с прогресс-баром,
  тайлсет в карте, анимированный герой, спрайты NPC, квестовый тайл
  с колокольчиками

Co-Authored-By: Claude Code <noreply@anthropic.com>

- packages/engine: жанронезависимый движок (цикл, сцены, ECS, ввод, камера,
  изометрия 2:1, A*, сейвы, диалоги, анимация) на PixiJS-бэкенде
- apps/game: первый вертикальный срез — меню, локация «Выжженные луга»,
  герой с click-to-move, 2 NPC с диалогами, автосейв по Esc
- CLAUDE.md, README.md, workspaces + Vite + Vitest

Co-Authored-By: Claude Code <noreply@anthropic.com>