Перепаковка: v1 в каталог v1/, корень — диспетчер версий ...

v1 (черновик движка + демо) переехал целиком в v1/ (git mv — история
сохранена): packages/, apps/, eslint/tsbase/vitest конфиги, package.json
с workspaces и лок-файл. Корневой package.json — тонкий диспетчер: те же
команды делегируются --prefix v1, все команды из док работают от корня.
Корневой CLAUDE.md — краткая карта версий; полный маниал v1 — v1/CLAUDE.md.
Пути кода в доках (docs/, README, .gitignore AI-листы) префиксованы v1/.
docs/ остаются в корне (там уже живёт план v2). Хуки (.githooks) и prepare
остаются в корне. Верифицировано: check:fast (774 теста) и agent:check —
зелёные из корня.

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

Тени сидят на базе: изо-проекция направления и плотность блоба ...

Фидбек «объекты и персонажи летают»: центр массы эллипса стоял на середине
вылета — видимая тёмная масса висела в стороне от объекта, а ступени текстуры
× спрайт-альфа 0.34 давали лишь ~24% плотности центра (невидимая контактная
тень). Теперь: sunShadow считает направление азимутом в плоскости мира и
проецирует изометрией (DEFAULT_ISO) — тень всегда лежит на земле, не «стекает
по стене»; blobPlacement сажает массу у базы (ближний край заходит за базу);
пик альфы 0.5 и ступени 0.4/0.44/0.5 — центр блоба в разгар дня ~40%
затемнения (проверено пикселями и скриншотами утра/полдня).

Доки: render.md — геометрия «сидит на базе» + расчёт плотности.

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

Тени без 3D: блобы актёров и направленные тени tall-объектов по солнцу ...

Движок: render/shadowSim.ts — чистая математика солнца (sunShadow по часам:
направление от западного утра к восточному вечеру, длина к низкому солнцу,
рассветные/закатные рампы альфы, ночь = null; blobPlacement — эллипс из базы
объекта) + render/shadows.ts (ступенчатая трёхслойная текстура блоба, раскладка
спрайта) + 8 тестов. Игра: GameShadows (ground-слой между картой и актёрами,
блоб первым ребёнком вьюхи актёра, чистка уничтоженных спрайтов); герой/NPC/
сгустки/деревья/валуны/кусты/дома/башня. Проверка checks/shadows.mjs:
утро/полдень/вечер/ночь через scene:setTime + скриншоты.

Доки: render.md «Тени», practices.md (канвас морозит исключение в тике; ручные
шаги моста не рендерят; зомби-vite на порту), demo/plan/llms.

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

Пост-эффекты движка: переменный блюр, аберрация, марево (PostFx) ...

- движок render/postfx: postSim.ts (чистая математика: спад силы по
  радиусу, ядро золотого сечения, сдвиг аберрации, синус марева; 7
  headless-тестов) + PostFx.ts — один кастомный Pixi-фильтр на worldRoot
  (API set*/pulse* по образцу Lighting, blurObject на отдельной вьюхе,
  resolution inherit, clipToViewport выравнивает текстуру по вьюпорту)
- игра: блюр-волна вокруг героя при резонансе, аберрация при уроне,
  авто-марево у Старой Машины (до усыпления) и очага; ручная зона моста
- мост scene:postfx (blur/aberration/shimmer/clear) + checks/postfx.mjs
- доки: render.md «Пост-эффекты», practices.md приём + грабли v8
  (resolution inherit, uniforms напрямую, без const-массивов в GLSL 1.00)

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

Спектро-лист: «взгляд» ИИ-агента на аудио (тулза движка + view в aiaudio) ...

- packages/engine/tools/spectro.mjs: FFT (radix-2, чистый JS) → спектрограмма
  log-частоты в dB-палитре + огибающая RMS + секундные тики + маркер шва лупа;
  CLI листует несколько клипов в один PNG
- wav.mjs: decodeWav (PCM 16-бит, моно/стерео → Float32, чанки по ID)
- тесты: roundtrip encode/decode, частота тона попадает в бин, лист пишется
- aiaudio: команда view <id> [seeds] — лист кандидатов в /tmp одной командой
- docs: assets-audio-save (decodeWav/spectro), practices (приём отбора),
  llms.txt, plan.md (Работа A)

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

Герой за деревом действительно прячется: tall-объекты в depth-слое (задача 19) ...

Движок: IsometricTileMap.setTallDepthLayer(layer|null) — tall-вьюхи клеток
переносятся в общий IsoDepthLayer с глубиной tx+ty (как у героев). Куллинг
и setTile не ломаются: видимость переключается по ссылке из cells, не по
родителю; null возвращает вьюхи в objectsLayer (порядок по строкам, как раньше).

Игра: LocationScene зовёт setTallDepthLayer(this.actors) и кладёт пропы
в actors через addRect (как и было).

Проверки: 2 теста движка (глубина/возврат в карту), сценарий
hero_depth.mjs — численные zIndex-assert'ы (юг: герой поверх дерева,
север: дерево поверх героя) + скриншоты, инварианты чисты.

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

Тема области играет без амбиента: audio.prepare() в движке ...

Убрав амбиент лугов, сломали старт темы: playTheme компилирует буфер
синхронным createBuffer, а контекст создавался только в unlock (первый
жест) или ensureContext (любой play) — на тихой локации до первого ввода
музыка не начиналась. В движке unlock разделён на синхронный createCtx +
prepare() (контекст без resume) и async unlock; Game.playTheme зовёт
prepare перед компиляцией. Чеки audio/music/synth переведены с
ambience/meadows (его больше нет) на тишину лугов и тему.

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

engine: renderMinimap — чистый рендер карты в пиксельную картинку ...

renderMinimap(TileMapData, opts) — вид сверху: клетка сетки = тайл,
цвет из палитры вызывающей стороны (Record<id, 0xRRGGBB>), cell 2–3 px,
опциональные маркеры точек интереса (клетка с тёмной рамкой), fallback
для незаданных тайлов. Выход {width, height, rgba} — без Pixi; в текстуру
превращает игра. Экспорт через index.ts, секция в docs/engine/maps.md.

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

feat: B4 — деревья: три вида крон, качание, осыпающийся пепел ...

Движок: анимация тайлов сочетается с вариантами — tall-объект анимируется
по фактическому (вариантному) id клетки, у разных вариантов свой fps.

Игра: три вида деревьев (широкая крона с кабелем / редкая / молодая),
каждый с кадром качания (крона +1px по X), fps 1.5/1.7/1.3 — кроны
качаются рассинхронизировано. Варианты TREE_V1/V2 раздаются вариантами
карт по хэшу координат, карты перезаписаны. С крон изредка осыпается
пепел (ember-частицы, серые, нормальный блендинг).

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

docs(practices): приём «скриншот пробы устаревает без render-шага» + waitFor не бросает по таймауту ...

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

fix: флип side-анимации, панель диалога сразу полной высоты, перенос шрифтов ...

- PlayerController: side-кадры генератора смотрят вправо — флип теперь при
  facing left (был при right, анимация ходьбы казалась зеркальной).
- DialogueBox (движок): панель при typewriter сразу строится под полный
  текст (измерение до печати), место под «далее ▸» резервируется всегда —
  подложка больше не появляется после напечатавшегося текста.
- Перенос шрифтов: nameText диалога, метки Button, тосты (wordWrapWidth
  440) — длинные строки не вылезают за панели и экран; тост сдвинут ниже
  строки «Цель:» (LocationHud) — не накладываются.
- Доки: ui-and-dialogue.md (механика панели), practices.md (приём
  «размечай по полному тексту»), art-style.md (side смотрит вправо).

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

feat(game): солнечный день, золотой час и тюнинг под прорези ...

- движок lightSim: dayNightAmbient — трёхопорный микс суток день → закат →
  ночь (DUSK_PEAK 0.45, DEFAULT_DUSK_COLOR 0xe8c090), экспорт из index.ts
- locations.ts: дневные ambient к почти-белому (meadows 0xf7f4ea, ponds
  0xf2f0e8, zvenets 0xf5f2ea, rust_grove 0xe9e6da, old_siding 0xe4e2d8),
  ночи темнее под прорези (0x3e4658…); duskColor в LightingDef
- HERO_LAMP компактнее и ярче (радиус 1.6, интенсивность 0.85); радиусы
  колокольчиков 1.4→1.0, окон 1.8→1.2, интенсивности выше
- палитра: ключевые цвета травы/пепла/воды подняты тоном (G*, P4–P5H, W1–W2),
  арт перегенерирован; art-style.md синхронизирован
- чеки lighting/time под новые значения и трёхопорный микс; тесты золотого
  часа (lightSim, GameLighting); docs/engine/render.md

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

feat(engine): свет «тьма с прорезями» — RT-карта силы тьмы вместо аддитивных пятен ...

- lightSim: stepAlphas/HOLE_PROFILE/TONE_PROFILE (ступенчатые профили прорези
  и тона), quantizeHoleAlpha (шаг 1/8) — детерминизм bake
- Lighting: RenderTexture хранит силу тьмы (fill → erase-прорези), display-
  спрайт multiply с tint=ambient — смена цвета дня/ночи без перерисовки RT;
  bake по dirty-подписи {round(x),round(y),scale·1/8,alpha·1/8}; day fast-path
  (белый ambient — слой выключен); fallback без renderer (тесты в node)
- источник = прорезь (makeHoleTexture, 7 ступеней) + приглушённый тон
  (makeToneTexture, TONE_GAIN 0.3) — спрайты под светом остаются читаемыми
- тесты: fake-renderer (bake/dirty/fast-path/destroy), профиль ступеней;
  docs/engine/render.md + practices.md

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

feat(agent): мост scene:walk/approach вместо tapTile, чеки и смоуки на кнопках ...

- SceneAgentView: команды scene:walk (A* + followPath) и scene:approach
  (findPathToNeighbor, возврат тайла прибытия)
- GameAgent: walkTo через одну команду + waitFor тайла (без !moving —
  step-переход срабатывает в moving), новый approach; tapTile удалён
- lib.mjs: t.interactAt/t.talkTo/t.useInteractable — координаты из снапшота
  по id; fightNearest — подход, доворот facing коротким шагом к врагу
  (клавиши — экранный вектор) и конус, до 3 попыток
- Чеки и смоуки переписаны с кликов на кнопки: interact, interact-world,
  quest-bells, transitions, final, resonator, zoom, lighting, collision,
  perf; smoke-act1 и final-smoke green (бой починен)
- Доки: agent.md (контракт моста), practices.md (доворот facing, две
  линейки), plan.md (задача 15)

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

feat(game): удаление клик-механики — движение и взаимодействие только кнопками ...

ClickRouting.ts -> InteractRouting.ts. Удалены: resolveClick/ClickProbe/
resolvePixelTile/pointerToWorld, handleWorldClick, таргет врагов (target/
updateTarget/enemyAt/attackTarget), pending-механизм (pendingInteraction/
resolvePending/request*/walkTo), PlayerController.onWorldClick + setWalkGrid.
Остались: кнопка действия (pickInteract/interactCandidates/interactTarget/
resolveInteract), step-переходы с дисармом, линейка радиуса.

Мышь больше не маршрутизируется в мир: движение — WASD/стрелки/геймпад/тач-
джойстик, взаимодействие — E/A в радиусе, бой — Space конусом/резонансом.
Побочные баги кликов ушли вместе с механизмом (потеря клика при пустом пути,
перебивание подхода к NPC таргетом врага, тихий no-op без соседей, pending
не сбрасывался stop/teleport).

Доки: demo.md, practices.md (секция роутинга), input.md.

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

fix(game): радиус взаимодействия — истинная евклидова линейка ...

inCircleW (проекционная линейка, анизотропия 2:1) давал зоне взаимодействия
экранный радиус 48px = до 3-4 тайлов, вытянутый вдоль мировой диагонали:
NPC/интерактив срабатывал по клику издалека, до подхода героя. Константа
1.5 юнита теперь применяется честно (Math.hypot позиций, юнит = 1 тайл):
орто-сосед 1.0 ✓, диагональный сосед 1.414 ✓ (findPathToNeighbor), 2 тайла ✗.

practices.md: заметка про две линейки мира (проекционная для конусов/хитбоксов,
евклидова для радиусов взаимодействия).

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

feat(engine): зум камеры (Camera.setZoom/zoomTo) + шаг cameraZoom ...

apply ставит scale контейнера мира рядом с позицией (единственная точка
мир->экран); toScreen/follow(deadZone)/clamp пересчитаны на z (тряска не
масштабируется, финал анимации — ровно целевой зум, промежуточно 0.25).
Катсценный шаг cameraZoom (seconds: 0 — мгновенно, параллелен cameraMove).
Дефолт z=1 — поведение без зума не меняется.

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

feat(engine): скролл MenuList (ListScroll), hover->курсор, value-слот Button ...

ListScroll — чистое окно видимых строк (курсор всегда в окне, пересборка
короче зажимает offset). MenuList: visibleRows, кнопки строятся все — окно
двигает visible/y; hover переставляет курсор. Button: value справа
(настройки — setValue без пересборки списка). TextInput — вне среза.

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

feat(engine): шаг moveView + skip() раннера катсцен ...

moveView двигает вьюху (Movable — структурно, без Pixi-типов) в локальных
координатах родителя со своим ease. skip() дожимает сцену до конца:
движения — в конечные точки, until форсируются (скип конечен даже на
шаге-ожидании); scene:skipCutscene переведён на него.

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

feat(engine): шаг until + tween-хелпер катсцен ...

Шаг until ждёт внешнее событие (predicate каждый тик; timeout —
принудительное завершение), уже выполненный предикат не блокирует.
Интерполяция cameraMove вынесена в чистый applyEase (cutscene/tween).
Типовая пара «диалог посреди сцены»: call(talkTo) + until(диалог закрыт).

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

perf(render): фиксация WebGL-бэкенда (preference: 'webgl') ...

О-5. Renderer теперь всегда выбирает WebGL: рендер детерминирован на всех
машинах, WebGPU-ветка Pixi не выбирается. Canvas/WebGPU-рендереры Pixi и так
лежат отдельными async-чанками (~19/13 КБ gz) — с фиксированным preference
браузер их никогда не загружает, отдельная вырезка не нужна.

Финальные прогоны: check:fast зелёный, agent:check 16/16, smoke-act1 (акт 1
до кат-сцены), final-smoke (3 поездки луга<->Звенец, бой, guard аудио) —
чисто; прод-сборка собирается. Perf (swiftshader, без изменений к О-4):
bootMs ~2.8 с, newGame->location ~230 мс, route 2 мс, fps 6-7 покой /
7-8 бой, heap 30-33 МБ.

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

perf(assets): параллельная загрузка и ленивый амбиент ...

О-4. AssetLoader грузил ключи await-в-цикле (~45 последовательных запросов);
BootScene — 4 атласа и карты друг за другом; 2.3 МБ WAV амбиента всех областей
декодировались до меню, хотя играется в первую очередь луговой.

- AssetLoader.load: один Assets.load(массив URL, onProgress) — Pixi грузит
  параллельно, onProgress честный по группе; пост-обработка nearest по всем
  результатам. API не изменился.
- BootScene.loadAll: Promise.all по группам (текстуры / 4 атласа / карты
  областей / шрифт+аудио) с общим взвешенным прогресс-баром (0.6/0.15/0.15/0.1).
- Ленивое амбиент-аудио: регистрируются все ключи (дёшево), декодируются
  только лупы стартовой области (data/audio.ts areaAudioKeys); остальные —
  фоновый game.preloadAudio при входе в область (LocationScene.enter).
  playAmbience/playLoop и раньше умели декодировать на месте (BufferCache
  дедуплицирует in-flight) — теперь до меню их никто не ждёт.

Perf (swiftshader): bootMs 2947-3191 -> 2781; newGame->location без изменений
(~200 мс, аудио и карты грузились в boot и раньше). agent:check 16/16,
включая аудио-чеки с ленивым декодом.

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

perf(map): A* на мин-куче, findPathToNeighbor — один многоцелевой прогон ...

О-3. Открытый список искался линейным сканом (O(n) на узел, O(n^2) на путь);
findPathToNeighbor запускал до 8 полных A* по очереди.

- OpenHeap: мин-куча по f, O(log n) на push/pop; tie-break по seq (порядок
  вставки) — обход остался детерминированным, как с линейным сканом.
- Общий каркас astar(grid, start, dirs, isGoal, h): цель и эвристика —
  параметры; findPath и findPathToNeighbor без дублирования цикла.
- findPathToNeighbor: все 8 соседей цели — цели одного прогона, эвристика —
  минимум манхэттена по целям (админисибельна, первый popped-goal оптимален).
- Соседство DIRS4/DIRS8 — константы модуля (было: spread каждый узел).

Тесты pathfinding — без правок ожиданий (11 старых зелёные), +2: выбор
ближайшего из 8 соседей за один прогон, старт-сосед цели — пустой путь.
Perf (swiftshader): routeMs 1-4 мс — в пределах baseline (маршруты короткие,
выиграш растёт с длиной пути).

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

perf(render): culling тайлов карты, пустые оверлеи света, setDepth без пересортировки ...

О-2 рендера. На лугах ~900+ спрайтов карты рисовались целиком при ~250
видимых; пустые fullscreen-оверлеи света (ambient/vignette/пульс) рисовались
каждый кадр даже днём; ходьба взводила sortDirty каждый тик.

- IsometricTileMap.cullToRect: тайловое окно из экранных углов (screenToIso),
  margin ±1 по X и вверх на высоту самого высокого tall; пересчёт только при
  сдвиге окна; isTileVisible — для тестов/отладки; вызов из сцены
  (updateCameraFollow). null — вернуть всё.
- Lighting: ambient.visible=false при белом тинте, vignette/pulseAmb — при
  нулевой альфе (днём минус 2-3 fullscreen-квада).
- IsoDepthLayer.setDepth/setDepthRect: ранний выход при неизменном zIndex
  (пиксельная сортировка детей не перезапускается каждый тик ходьбы).
- agent.mjs perf: возврат 0 (объект отчёта ломал process.exit).

Perf (swiftshader headless, до → после): fps бой 3-6 → 7-8, покой 5-6 → 5-7
(rasterizer swiftshader глушит выигрыш — он раскроется на целевом iGPU);
heap в пределах шума (28-31 МБ). Скриншот смоука не изменился, тайлы у краёв
камеры на месте.

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

perf: горячий путь 60 Гц без аллокаций (О-1) ...

Baseline после: fps покой 6 / бой 6 (было 5-6/3-6), heap 29 МБ — не хуже.

- Частицы: stepParticle — out-параметр визуала; Particles — компакт swap-pop
  в один проход вместо двух filter за тик (~3400 объектов/сек раньше).
- Свет движка: upsertLight/upsertDarkSpot — апсейт def по полям вместо
  {...def}; пульсы — итерация Map без спреда; lightFrame — out-кадр
  (applyFrame reuse).
- Свет игры: дифф-наборы источников/пятна — два буфера со свопом (clear не
  задевает активный), defsBuf/posBuf/lampDef — переиспользуемые.
- Тики: Tween/Updatables/shake — компакт на месте вместо filter каждый тик
  (в Tween пограничный случай dt-в-delay сохранён — твин остаётся).
- Сцена: debug.setLines только при видимой панели; Atmosphere.updateHazard —
  поиск зоны только при смене тайла героя.
- Бой: CombatFlow.updateRing — трогает Graphics только на переходах;
  noiseFor — общий view вместо копии origin; EnemyBrain — переиспользуемые
  INTENT_* константы + dirInto/moveIntentFrom (dirToward больше не аллоцирует).
- SceneRegistry.near — опциональный out-массив + reuse Set дедупликации.
- PlayerController: имя клипа ходьбы — кэш по facing.
- docs/engine/render.md: out-параметр stepParticle.

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

perf: реальный fps в агентном мосту + чек perf (baseline О-0) ...

- Engine.get fps() через FpsMeter (было 1/fixedStep = 60 всегда); AgentHost.fps.
- checks/perf.mjs: старт (страница+ассеты, newGame→location), A* (scene:route),
  walkTo через луга, fps/heap в покое и в бою; agent.mjs perf (не в check —
  бенчмарк, не гейт); lib.mjs open() с сырыми опциями openGame.
- eslint: performance: readonly для node-тулз.

Baseline (swiftshader headless, 960x540):
- старт: ассеты→меню ~3.0 с (raw 4.5 с с фиксированными 1.5 с сна моста),
  newGame→location ~150-175 мс;
- A* путь через луга: 2-4 мс (10 узлов), walkTo: ~0.5 с;
- fps: 5-6 в покое, 3-6 в бою; heap: 28-31 МБ.

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

refactor: DialogueRunner -> модель + рантайм; LocationScene 890 -> 737 ...

Движок:
- dialogue/graph.ts (новый): типы графа, VarCondition/DialogueEffects/... и
  чистые предикаты hasConditions/evalConditions — их берут валидатор, dry-run
  и квест-стадии; DialogueRunner.ts (459 -> 298) — только рантайм обхода.
  Публичный API @rpg/engine не изменился; ui-and-dialogue.md дополнен.

Игра (сцена — оркестратор, механики — в systems/):
- systems/combat/CombatFlow.ts (новый): боевая обвязка героя — ввод атаки/
  резонанс, реакции на урон (вспышка/шейк/отброс/смерть-респаун), hp-бар,
  кольцо заряда, уровень угрозы для музыки, подписка combat:hurt.
- systems/LocationHud.ts (новый): название локации, подсказка, счётчик мотов
  (одна вьюха в uiRoot вместо трёх полей сцены).
- makeExitGlow — маркер выхода интерьера уехал в InteractableViews.

Проверки: check:fast, agent:check 16/16, smoke-act1 (квест+кат-сцена),
final-smoke (3 поездки + реальный бой) — зелёные.

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

К4: каркас withChecks для чек-сценариев, конфиги, доки ...

- apps/game/tools/lib.mjs: withChecks(name, fn) — сервер/браузер и помощники
  (boot/goToArea/sleepEnemies/readAudioLog/waitAudioLog/expectInvariantsClean)
  в одном месте; все 12 сценариев checks/*.mjs переписаны на шаги.
- Контекст сценария — только t.ctx (геттер): деструктуризация до boot давала
  null — задокументировано в agent.md и practices.md.
- vitest.config.ts: явный include (src-тесты + тулзы с чистой математикой);
  GameLoop.manual.test.ts -> GameLoop.timing.test.ts.
- Редактор диалогов: порт 5299 (5199 остаётся за dev-сервером смоуков) + фикс
  разбора --port (indexOf(-1) -> NaN, npm run dialogues падал без аргумента).
- tsconfig: apps/game включает только src (движок типчекается своим проектом);
  vite/client убран из движка (import.meta.env там нет).
- Докси: getting-started — regex-алиас вместо строкового; llms.txt + anim.md;
  CLAUDE.md — полный список док; wav.mjs writeWav удалён (0 вызовов).

Проверено: agent:check 16/16, check:fast (692 теста), smoke-act1, редактор на 5299.

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

refactor(engine): глубокий рефакторинг К2 — расшивка аудио, FadeState, контракт fx, Engine.destroy ...

Расшивка переростков:
- AudioManager (479→279) → AudioManager (фасад) + Voices (полифония sfx,
  pan в полёте в шине голоса) + Loops (слоты музыки/амбиента, кроссфейд)
  + decode.ts (BufferCache с in-flight дедупом) + types.ts;
  load() → register()
- IsometricTileMap: проходимость делегирует новому StaticGrid
  (map/collision.ts) — единый источник blocked/пропы/тени; headless-потребители
  берут через gridOf(data), setTile виден сразу
- core/fade.ts (FadeState): вместо ручных fadeLeft/fadeTotal в Lighting
  (ambient+виньетка) и SceneManager; повторный to() в середине фейда
  стартует от текущего значения — без прыжка

Контракт fx-эффектов: cancel() = остановить + вернуть базовое + погасить
свою вьюху (FxFade без keep теперь гасит, FxTrail получил cancel,
SpriteFlash.cancel через TintFlash.finish); конец жизни — destroyed
везде. FxLayer: один реестр тикающихся (items), flashes — только индекс
перезапуска.

Прочее:
- Engine.destroy() — полная зачистка (exit сцены, fx/tweens/events,
  ввод, FPS-метр, app.destroy) для HMR; stop() — только цикл
- FpsMeter считает всегда, отдаёт геттером fps; DebugOverlay принимает
  FpsMeter и перерисовывает Text не чаще 0,5 с
- Lighting: кэши текстур на инстансе (модульный переживал destroy
  рендерера), чинен двойной destroy darkFree/darkLayer
- InputManager: DOM-обработчики и инъекции идут через общие примитивы
  press/release (клавиши, указатель)
- SpriteAnimator: xorshift → math/rng.createRng (единый ГПСЧ)
- Мёртвый код: FrameAnimation (файл+экспорт+тест), vec2(), pxToUnits,
  screenToIsoExact, pushOutOfWalls

Тесты: +fade, +SceneManager (стек/фазы/глотание), +EventBus, +Engine
(stepTicks, мок pixi.js), +SpriteAnimator, +computeScale. Доки движка
обновлены в том же коммите (core.md: FadeState/Engine.destroy;
render.md: контракт fx, кэш Lighting; anim.md/maps.md/README.md — без
FrameAnimation; practices.md: тест ядра без WebGL, поле-метод).

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

engine: FX-слой one-shot эффектов + пресеты (render/fx/) ...

Инфраструктура визуальных эффектов: FxLayer (Container + Updatable, тикается
один раз в engine.fx, сам вычищает закончившиеся) и пресеты — кольцо/волна/
телеграф зоны (FxRing, repeat/shapes/fill), всплывающий текст (FxFloatText),
растворение/проявление с защитой от двойного destroy (FxFade), pop-появление
с овершутом (FxPop), шлейф (FxTrail), фабрики частиц spark/smoke/ember/dust.

Чистая математика сэмплов — fxSim.ts (headless-тесты); backOut в easing;
SpriteFlash + destroyed (самозачистка из реестра); Updatables.forEach.
Доки: render.md (раздел FX), core.md (engine.fx), recipes.md, practices.md.

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