квестовая система: декларативные стадии ...

- data/quests.ts переписан: QuestDef/QuestStage, реестр QUESTS;
  состояние квеста — флаги/вары GameState (ставятся графами диалогов);
- API: questTaken/questDone/activeStage, questDialogueFor (диалог NPC
  по активной стадии), questEffectFor (побочные эффекты из стадий +
  знакомства), questLog (журнал с прогрессом);
- LocationScene.talkTo/onDialogueFinished: хардкод-ветки заменены
  квест-моделью (полотно — эффект trader_first);
- тесты: 199/199 (новые — стадии квеста и сумка).

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

сейвы v2 + предметы + инвентарь ...

- движок: Inventory — контейнер Map<id, count> (add/remove/count/has/all,
  onChange), inventoryFromData; тесты;
- Game.inventory: сумка героя, сброс в новой игре;
- SaveData v2: поле version + items, normalizeSave дополняет сейвы v1;
- data/items.ts: реестр предметов (cloth, bellflower, salt, water_flask);
- сбор цветка кладёт bellflower в сумку; полотно выдаётся предметом
  после диалога Милы (флаг got_cloth остаётся меткой);
- InventoryScene: строки сумки из инвентаря (имя + ×N);
- тесты: 192/192.

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

Фаза 4: TallSpec.height в мировых юнитах ...

- плейсхолдер-колонна: h = tall.height * iso.tileW (вместо px);
- удалён устаревший map.screenSize (остался worldBounds в юнитах);
- data/map.ts: высота дерева 1.5 юнита (те же 48 px на экране);
- .map-файлы перегенерированы (diff — только height: 48 -> 1.5);
- parseMap отвергает tall.height > 16 как высоту в px (защита от
  протухших карт-файлов);
- тесты: 186/186.

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

Фаза 3: мир игры в мировых юнитах ...

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.x/y и bounds в юнитах (1 юнит = 1 тайл); клэмп по экранному
  bbox мирового прямоугольника; deadZone -> deadZonePx (окно на экране)
- IsometricTileMap.worldBounds; LocationScene использует его
- camera.test.ts переписан в юнитах (проверка проекций)

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

камера: dead zone (окно следования) + дебаг-просмотр спрайта ...

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

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

движок: дистанция взаимодействия + findPathToNeighbor ...

- 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>

полировка: плавная камера при ходьбе + кадры походки с бобом туловища ...

- камера следует за непрерывной позицией ног героя, а не за центром
  тайла: в покое картинка та же, в движении нет рывка на границе тайлов
- кадры ходьбы (down/up/side ×2): вторые кадры — туловище на пиксель
  ниже (классический stride/passing боб) — походка читается целиком,
  а не «перестановкой кусочков»
- пробы: tools/walk-probe.mjs (кадры ходьбы), tools/cam-probe.mjs
  (сэмплы worldRoot — движение монотонное)

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

рендер: резкий UI при пиксельном мире + тайлы без обводки ...

- Renderer: бэкинг-стор канваса в пикселях устройства (scale × dpr) —
  UI и текст рендерятся 1:1 с экраном, без «мыльного» апскейла на HiDPI;
  CSS-размер канваса не изменился (виртуальное × целое)
- PixelText: setPixelTextResolution — глифы растеризуются с resolution
  канваса (синхронизирует Renderer при смене масштаба)
- AssetLoader: текстуры мира (и кадры атласов) сэмплируются nearest —
  пиксель-арт остаётся чётким квадратным
- тайлы без обводки граней (fillDiamond без light/dark линий):
  смежные тайлы сливаются в поля, сетка больше не «шумит»
- доки: render.md (двухслойный пайплайн), ui-and-dialogue.md (resolution
  текста), CLAUDE.md (правило №2)

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

полировка: читаемость шрифтов (кегль VT323 ≥ 10) + перерисовка героя ...

- DialogueBox: минимум 10px, панель расширена (8–9px у VT323 нечитаемы);
  проба tools/font-probe.mjs подтвердила на честном конвейере игры
- подсказка локации укорочена и опущена под сердечки (налезала на HUD)
- кегли в сценах: меню/настройки/сейвы/сумка/boot 9→10, тосты 11
- герой перерисован (все направления): крупнее лицо, два симметричных
  глаза, плечи/пояс/сапоги — без «кляксы», читается как человек;
  размер 16×24, имена кадров и якорь не тронуты

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

игра: тач-джойстик и дебаг-оверлей (F3) ...

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

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

игра: квест «Три цветка» — сбор, журнал, сумка, сдача и крючок акта 1 ...

- движок: IsometricTileMap.setTile — изменение тайла с перерисовкой ячейки (+тест);
  InputManager: одна клавиша маппится на несколько действий (Space = advance+attack)
- data/quests.ts: журнал квестов и предметы из флагов/варов GameState
- сбор лунных колокольчиков кликом на прудах (тайл зеленеет, прогресс flowers)
- сдача квеста Ирвину (elder_hand_in) — посадка цветов у тропы, крючок «Машина дышит»
- повторные реплики Милы (trader_repeat/trader_after)
- InventoryScene: сумка и журнал на Panel (клавиша I / геймпад Y)
- tools/smoke-quest.mjs: смоук диалога и сумки

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

игра: вторая локация «Серые пруды» — карты-файлы .map, переходы, сейв-слоты ...

- 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>

игра: бой в реальном времени — сгустки на ECS, конус/резонанс, HUD, интеграция в LocationScene ...

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

игра: звук и настройки — WAV-генератор, AudioManager, SettingsScene ...

- 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>

Миграция игры на новые API движка + документация docs/engine ...

Игра:
- диалоги переписаны на графы 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>

Фиксы рендера, камера с границами, смоук-тест ...

- Renderer: ждём app.init() до обращения к renderer (баг чёрного экрана)
- AssetLoader: Assets.init() до первой загрузки (иначе load виснет навсегда)
- Camera: границы {x,y,width,height} — изометрический ромб уходит в минус по X
- арт: пепельные бугры темнее (не читались как пепел), favicon-заглушка
- tools/smoke.mjs: смоук-тест в реальном Chromium (puppeteer-core) —
  headless --virtual-time-budget зависает на декодинге картинок
- CLAUDE.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>

Скелет проекта: свой движок + изометрическая RPG ...

- 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>