houseplan-card/docs/specs/039-large-backdrops.md

ТЗ #39 — Безопасная работа с большими подложками

• Issue: https://github.com/Matysh/houseplan-card/issues/39
• Приоритет: P2
• Статус ТЗ: research-first, thresholds утверждаются по benchmark

Цель

До upload предупреждать о raster, способном исчерпать память tablet/WebView, и предлагать уменьшенную копию без потери текущего плана при ошибке.

Локальная диагностика

Для PNG/JPEG/WebP до сетевого запроса:

• MIME/signature и file bytes;
• decoded width×height через createImageBitmap, fallback isolated <img>;
• megapixels и minimum decoded RGBA memory w*h*4;
• estimated working peak: bitmap + canvas + encoded output (conservative 2.5×);
• рекомендуемый target dimensions.

Object URLs всегда revoke; decode timeout/error не заменяет текущий backdrop. SVG получает file-size/security validation, но не raster memory/downscale.

Threshold protocol

Перед code default провести matrix на reference low-end wall tablet WebView и desktop Chromium: 4/8/16/32/64 MP, transparency, JPEG/WebP. Ship constants документируются как WARN_DECODED_BYTES и MAX_SAFE_DIMENSION. Рекомендуемый начальный guard для исследования: warning при >32 MP либо estimated peak

128 MiB; это не становится product constant без результатов.

UX

• Safe: обычный upload.
• Warning: dialog показывает resolution, file size, estimated memory и действия «Загрузить уменьшенную копию», «Оставить оригинал», Cancel.
• Hard browser limit/decode failure: только Cancel и инструкция уменьшить файл desktop tool; нельзя продолжать blind.
• Downscale сохраняет aspect; longest side до benchmark target. PNG с alpha остаётся PNG, opaque photo — JPEG/WebP с documented quality; metadata не требуется.

Transaction

Existing backdrop/config остаются до успешного upload+validation+config save. Downscaled Blob проходит тот же quota/copy-on-write backend path. При upload, save или decode failure staging очищается, старый ref не удаляется. Undo и explicit plan deletion работают как сейчас.

Проверки и приёмка

• header fixtures без выделения гигантского canvas до warning;
• alpha/aspect/orientation (EXIF), corrupt/truncated, decode timeout;
• failed upload/save preserves previous plan and files;
• memory benchmark report + documented thresholds;
• mobile dialog без horizontal scroll;
• SVG никогда автоматически не растеризуется.