houseplan-card/legacy/specs/053-pdf-export.md

ТЗ #53 — Экспорт пространства в PDF: чистый архитектурный план

Частично переопределено #482. Актуальный контракт цвета и штриховки стен, отбора/дедупликации/размещения размеров, выбора листа и масштаба, компаса и отсутствия легенды находится в 482-pdf-export-polish.md. При противоречии он имеет приоритет; остальные требования этого ТЗ сохраняются.

• Issue: https://github.com/Matysh/houseplan-card/issues/53
• Приоритет: P3 · Тип: feature · Трек: полный (новый UX, новый ленивый чанк, новый формат вывода)
• Оценка: пользовательская ценность 7/10 («распечатал план для электрика/страховой»), уникальность против конкурентов 9/10 (у них нет геометрии для печати); сложность 6/10; риск 4/10 (шрифты и растр в PDF, детерминизм)
• Решения владельца: 2026-08-15 (исключение из docs/SCOPE.md, задача остаётся в очереди); 2026-09-07 (#52 объединён сюда, слой размеров во View не делается; кнопка-принтер, маленький диалог, только текущее пространство, без устройств, подложка — если есть у пространства)
• Связанные контракты: docs/specs/052-view-dimensions.md (§ Площади — контракт площадей; § Длины на бумаге не применяется, см. §7.3), docs/WALL-THICKNESS.md, docs/BACKDROP.md, docs/FURNITURE.md, docs/SCOPE.md, #456 (образец диалога у пространства), #476 (диалог с кнопкой)

1. Сценарий

Персона — администратор дома, desktop-браузер (touch — best effort по docs/TOUCH-SUPPORT.md, но диалог обязан работать пальцем). Он открывает нужное пространство, нажимает иконку принтера в панели карточки, в маленьком диалоге оставляет или снимает три-четыре галочки и нажимает «Сохранить». Через секунду браузер скачивает houseplan-<пространство>-<дата>.pdf — один лист A4 с планом этого пространства: стены с толщиной, перегородки, виртуальные стены, проёмы, размеры и площади, названия комнат — без устройств, состояний, подсветок и цветов. Лист можно отдать электрику, страховой, подрядчику.

2. Что человек увидит до и после

До: план существует только на экране; «бумажный» вариант — скриншот с маркерами и свечением.

После: в панели карточки между шестерёнкой и знаком вопроса — иконка принтера. Диалог «Сохранение в PDF» с галочками и одной кнопкой. Файл скачивается без диалога печати браузера, одинаково на десктопе и в мобильном приложении HA. На листе — векторная штриховая графика, читаемые подписи на языке плана, масштаб и масштабная линейка в подвале.

3. Проблема

Экспорт JSON (#50) переносит план между установками, но не годится как документ для человека без Home Assistant. SVG на экране рисует всё сразу — состояния, свечение, маркеры — и не имеет ни масштаба, ни листа. Размеры стен и площади уже считаются (ресайз, карточка комнаты), но нигде не печатаются. Контракт измерений принят в #52 и не реализован; печатный лист — первое место, где он нужен целиком.

4. Решения владельца (2026-09-07)

1. Точка входа — иконка принтера в основной панели между настройками и знаком вопроса.
2. Диалог маленький: заголовок «Сохранение в PDF», галочки и кнопка «Сохранить».
3. Экспортируется только текущее пространство; «все пространства» — не делаем.
4. На листе только архитектура: стены, перегородки, виртуальные стены, проёмы, размеры. Устройства не нужны совсем — ни галочки, ни маркеров.
5. Галочки: «Отображать размеры» (по умолчанию включена), «Отображать мебель и другой декор», «Отображать названия комнат», «Отображать подложку» — последняя есть только если у пространства задана подложка.
6. Слой размеров на экране (View) не делается — #52 закрыт.

5. Скоуп

• Кнопка в панели и диалог (§6).
• Печатная сцена пространства из канонической модели (§7): геометрия, подписи, размеры по контракту #52, подложка и декор по галочкам.
• Лист A4, автоориентация, вписывание, подвал с масштабом (§7.5).
• Генерация PDF целиком на клиенте, ленивым чанком, без внешних сервисов (§8); скачивание файла.
• Шрифт с кириллицей и латиницей, встроенный в PDF (§8.3).
• i18n четырёх языков (§9), документация, тесты (§12–§13).

6. Не-скоуп

• Устройства, маркеры, состояния, свечение, солнце, следы робота, топология Zigbee — не печатаются никогда.
• Экспорт всех пространств одним файлом; титульный лист; выбор формата листа (A3, Letter) и масштаба вручную — возможные следующие задачи.
• Слой размеров на экране; изометрический вид (печатается только плоский план независимо от текущей проекции).
• Печать через window.print()/диалог печати браузера — отвергнуто в §8.1.
• Изменение модели данных, конфига, схемы бэкенда — нет.
• houseplan-space-card — кнопки нет (статичная карточка без панели); отдельная задача при необходимости.

7. Контракт: что на листе

7.1. Геометрия (всегда)

Источник — spaceModels(cfg) для текущего пространства, та же нормализованная модель, что у View: комнаты, wall_segments с толщиной, partitions, wall_columns, проёмы (door, window, gate, passage).

элемент	изображение
стена с толщиной	замкнутый контур по физическим граням, заливка серым (#555), обводка чёрная 0,25 мм; общая стена — один раз
стена нулевой толщины (виртуальная / открытая граница)	штриховая линия 0,35 мм, штрих 3 мм / пробел 2 мм, без заливки
перегородка	как стена, своей толщиной; тоньше 4 см на бумаге — сплошная линия 0,5 мм
колонна	контур по cm (квадрат/круг), заливка серым
дверь	разрыв в стене + створка и дуга открывания в сторону и с петлями, как на экране (flip_v/петли уважаются)
окно	разрыв в стене с двойной линией по граням
ворота	как дверь, без дуги, с диагональной штриховкой створки
проход (passage)	разрыв без линий

Никаких заливок комнат, свечения, цветов стен из настроек: лист монохромный. Толщина линий — в миллиметрах бумаги, не зависит от масштаба (аналог vector-effect: non-scaling-stroke).

7.2. Названия комнат (галочка, по умолчанию — см. §18 Q1)

Название — как хранится в плане (язык пользователя), в сохранённой позиции подписи либо во внутренней точке комнаты (тот же резолвер, что у View). Кегль 9 pt; если название не помещается в комнату при масштабе листа — уменьшается до 7 pt, ниже — скрывается (tooltip'а на бумаге нет, поэтому комната остаётся без подписи, а не с обрезанной).

7.3. Размеры и площади (галочка, по умолчанию включена)

Решение владельца 2026-09-07: внутренние размеры каждой комнаты, достаточные, чтобы начертить её независимо от остальной планировки, и внешние размеры каждой наружной грани планировки. Осевые пролёты стен из 052-view-dimensions.md § Длины на бумаге не используются; из #52 переиспользуется только § Площади.

Площадь — чистый пол через geometryArea (тот же резолвер, что у карточки комнаты), formatArea, единицы из HA. Печатается под названием комнаты кеглем на 1 pt меньше; без названия — одна строка площади в той же точке.

Внутренние размеры комнаты. Контур — внутренние грани стен комнаты (чистый пол, тот же полигон, что у площади), после компакции коллинеарных рёбер. Каждое ребро контура получает длину formatLength(segmentCm) — расстояние от грани до грани, а не по оси стены. Подпись — внутри комнаты, параллельно ребру, отступ 2 мм от грани, читается слева направо или снизу вверх. Для комнаты-прямоугольника печатаются все четыре ребра; если при коллизии места не хватает, второе ребро той же длины и того же направления может быть опущено — комната остаётся вычерчиваемой (по одной длине на направление). Для непрямоугольных контуров опускать нельзя: каждое ребро — свой размер. Рёбра короче 30 см на бумаге не подписываются, но их длину можно восстановить из соседних — такие рёбра помечаются короткой засечкой без числа. Проёмы на длину ребра не влияют (ребро — грань стены целиком).

Внешние размеры планировки. Внешний контур — объединение физических стен пространства по наружным граням (тот же силуэт, что у контура «вписать всё»), после компакции. Каждая прямая наружная грань получает размерную линию снаружи контура на расстоянии 6 мм: выносные линии перпендикулярно грани, засечки, число над линией. Грани одной прямой (сдвиг по наружной стене из-за выступа) — отдельные размеры, каждая своя; суммарной цепочки нет (её даёт сумма). Несколько несвязных наружных контуров (пристройка, отдельное строение в пространстве) — каждый со своими внешними размерами. Виртуальные (нулевые) границы наружного контура длину не получают. Порог 30 см для внутренних рёбер здесь не применяется: каждая физическая наружная грань, включая грань короче 30 см, получает числовое значение. Если число не помещается над размерной линией, оно выносится наружу на детерминированную полку с линией-указателем и не скрывается.

Единицы и точность — formatLength/formatArea, metric/imperial из HA, масштаб сетки cell_cm; числа совпадают с живой линейкой ресайза на том же ребре и с площадью в карточке комнаты.

Коллизии — детерминированно: приоритет внешние размеры → площади → внутренние рёбра длинные → короткие; подпись, чей прямоугольник пересекает уже размещённый или выходит за поле листа, скрывается только в разрешённых выше случаях: дубликат направления у прямоугольной комнаты или короткое (< 30 см) внутреннее ребро с засечкой. У непрямоугольного контура числовое значение ребра из-за коллизии не исчезает: сначала кегль уменьшается до 6 pt и подпись детерминированно сдвигается вдоль ребра внутрь комнаты; если свободного места всё равно нет, у ребра ставится компактная метка R<n> с выносной линией, а полное значение печатается в нумерованном блоке «Внутренние размеры» в свободном поле листа. Нумерация стабильна: комнаты — по room.id, рёбра — от лексикографически минимальной вершины по часовой стрелке. Блок входит в bounding box печатного содержимого при выборе масштаба §7.5. Никакая подпись не печатается вверх ногами.

7.4. Мебель и другой декор (галочка, по умолчанию — Q1)

Всё содержимое decor[]: мебель (арт из furniture-art-runtime, штрих чёрный), линии/прямоугольники/эллипсы (цвет игнорируется — чёрный штрих, без заливки), текстовые подписи (кегль по width_cm, минимум 6 pt), изображения (kind: 'image') — растром по правилу §7.6. Порядок слоёв — как в модели.

7.5. Лист, подвал, легенда (всегда)

• A4 (210 × 297 мм), поля 12 мм; ориентация — по пропорциям bounding box контента (ширина > высоты → landscape).
• Контент — геометрия ± внешние размерные линии (при включённой галочке) ± подложка/декор (при включённых) — вписывается в поле листа с сохранением пропорций; масштаб округляется вниз до стандартного ряда 1:20, 1:25, 1:50, 1:75, 1:100, 1:150, 1:200, 1:250, 1:500, чтобы линейкой на бумаге можно было мерить; при экстремальных планах — ближайший больший.
• Шапка: название пространства (кегль 14 pt), справа — название дома (title карточки), если задано.
• Подвал: «Масштаб 1:N», масштабная линейка 1 м (metric) / 5 ft (imperial) с делениями, стрелка севера при заданном компасе пространства или общем north_deg (тот же резолвер, что у солнца), дата (локальная, YYYY-MM-DD), «House Plan vX.Y.Z», легенда: стена · перегородка · виртуальная стена · дверь · окно · ворота (только присутствующие на плане элементы).
• Текст шапки/подвала — на языке карточки (_t).

7.6. Подложка (галочка, есть только при заданной подложке)

Растровая подложка (PNG/JPEG/WebP) встраивается как XObject с исходными байтами (JPEG — DCTDecode без перекодирования; PNG/WebP — через canvas в JPEG q=0.85, чтобы не тащить декодер PNG в writer), в сохранённой позиции (plan_x/plan_y/plan_scale*, поворот) под геометрией, с прозрачностью 60 % — иначе штриховая геометрия тонет в скане. SVG-подложка растеризуется через canvas при 150 dpi по размеру на листе. Изображения декора — по тем же правилам. Суммарный размер встроенных растров ограничен 25 МБ: превышение — отказ с тостом pdf.too_large до генерации, галочки остаются.

Внешние URL подложки идут через тот же подписанный доступ, что и на экране; недоступная картинка — отказ с тостом pdf.asset_failed, файл не пишется (лист без обещанной подложки молча — хуже, чем честный отказ).

8. Контракт: как делается PDF

8.1. Выбор способа

вариант	плюсы	минусы	решение
window.print() + print-CSS	нет зависимостей, любой шрифт	диалог печати вместо скачивания; в мобильном приложении HA (WebView) печать недоступна или калечит лист; пагинация и масштаб не под контролем	отвергнут
jsPDF + svg2pdf	готовые примитивы	~200 КБ gzip ленивого кода плюс шрифт всё равно нужен свой (стандартные 14 шрифтов PDF без кириллицы); конвертация SVG → PDF с потерями (маски, non-scaling-stroke)	отвергнут
собственный минимальный PDF-writer	вектор, прямое скачивание, ~15 КБ gzip кода, одинаково на десктопе и в приложении; рисуем из модели, а не из экрана — без потерь	писать самим: страницы, контент-поток (m l c h f S), встраивание TrueType (CIDFontType2, Identity-H, ToUnicode), XObject Image, xref	принят

8.2. Ленивый чанк pdf-export

src/pdf/ — новый модуль, динамически импортируемый из ядра через EditorRuntimeLoader (отпечаток сборки, повтор с нонсом, терминальный отказ для чужой сборки — образец iso-scene-render). В стартовый граф не входит ничего, кроме кнопки, обработчика и вызова загрузчика; манифест получает роль pdf и lazyPdfFiles, bundle:budget требует непустой список и отсутствие пересечения с initial (как у lazyIsometricFiles).

Состав: pdf-writer.ts (объекты, потоки, xref, шрифт, изображения), pdf-scene.ts (модель → примитивы листа: геометрия, подписи, размеры, подвал), pdf-dimensions.ts (контракт #52: пролёты, площади, раскладка), pdf-export.ts (оркестрация: опции → сцена → байты → Blob → скачивание), hp-pdf-dialog.ts (диалог).

8.3. Шрифт

Один шрифт, встроенный в PDF как FontFile2: Roboto Regular, лицензия Apache 2.0 (файл лицензии в assets/fonts/), сабсет, собираемый на этапе генерации (scripts/generate-pdf-font.mjs, devDependency subset-font): Basic Latin, Latin-1 Supplement, Latin Extended-A, Cyrillic, Cyrillic Supplement, General Punctuation, знаки ° ² ′ ″ × ≈. Результат — src/pdf/pdf-font.generated.ts (base64, ожидаемо 60–80 КБ raw), только в ленивом чанке; --check-режим генератора, как у мебели. Глиф вне сабсета → .notdef (пустой прямоугольник) — документировано; язык плана ограничен четырьмя поддерживаемыми, поэтому в практике не встречается.

Ширины глифов берутся из hmtx сабсета в момент генерации и кладутся в тот же файл — writer не парсит TrueType в браузере.

8.4. Скачивание и детерминизм

Blob → URL.createObjectURL → <a download> → revokeObjectURL. Имя: houseplan-<slug названия пространства>-<YYYY-MM-DD>.pdf. В мобильном приложении HA скачивание идёт штатным путём WebView — проверяется вручную на Android-приложении (AC12).

При одинаковых входах (модель, опции, единицы, язык, версия, дата) байты PDF идентичны: даты CreationDate/ModDate берутся из переданного now, объекты нумеруются детерминированно, растры — исходные байты. Это основа golden-проверки (§13).

8.5. Диалог и состояния

hp-pdf-dialog на базе hp-dialog (модальность и центрирование — #463). Заголовок pdf.title («Сохранение в PDF»), галочки в порядке: размеры, мебель и другой декор, названия комнат, подложка (только если space.bg); кнопка pdf.save («Сохранить»), закрытие крестиком/Esc/кликом вне — как у остальных диалогов. Состояние галочек запоминается в localStorage (hp.pdf.options, схема {v:1,...}); при отсутствии — значения по умолчанию §18 Q1.

Нажатие «Сохранить»: кнопка блокируется, текст pdf.saving («Формируем…»), загружается чанк (первый раз — до 1 с), формируется файл, диалог закрывается после начала скачивания. Отказ (чанк не загрузился, растр не удалось получить, лимит) — тост с причиной, диалог остаётся открытым с теми же галочками. Повторное нажатие во время формирования игнорируется.

Кнопка в панели: mdi:printer-outline, title/aria-label = title.export_pdf, стоит между «Общие настройки» и «Помощь и обратная связь» в том же блоке (_canEdit), в киоске не показывается, в изометрии — показывается (печатается плоский план). Минимальная зона нажатия 44×44 px как у соседей.

9. i18n

Новые ключи (en/ru/de/fr): title.export_pdf, pdf.title, pdf.dimensions, pdf.decor, pdf.room_names, pdf.backdrop, pdf.save, pdf.saving, pdf.failed, pdf.too_large, pdf.asset_failed, pdf.internal_dimensions, pdf.scale («Масштаб 1:{n}»), pdf.north, pdf.legend.wall, pdf.legend.partition, pdf.legend.virtual, pdf.legend.door, pdf.legend.window, pdf.legend.gate. Тест i18n-dead-keys требует потребителя у каждого — все используются диалогом, содержимым листа или подвалом.

10. Модель данных, миграция, совместимость

Конфиг, схема, бэкенд — без изменений; экспорт только читает. Планы любой поддерживаемой версии модели печатаются через ту же нормализацию, что и View. localStorage — единственное новое состояние, per-браузер.

11. Затронутые файлы и модули

• src/pdf/pdf-writer.ts, pdf-scene.ts, pdf-dimensions.ts, pdf-raster.ts, pdf-export.ts, hp-pdf-dialog.ts, pdf-font.generated.ts — новые;
• scripts/generate-pdf-font.mjs, assets/fonts/Roboto-Regular.ttf + LICENSE — новые; package.json (devDependency subset-font, скрипты pdf-font:generate/pdf-font:check);
• src/houseplan-card.ts — только кнопка, exact-build loader, открытие диалога и передача уже рассчитанной геометрии; после реализации 13 643 строки при потолке 13 659. Writer, сцена, шрифт и UI диалога остаются вне ядра;
• scripts/bundle-manifest.mjs, scripts/bundle-budget.mjs — роль pdf, lazyPdfFiles, токен retry-URL;
• src/i18n/*.json; docs/PDF-EXPORT.md (новый), docs/USER-GUIDE*.md, docs/ARCHITECTURE.md (ленивая граница), docs/SCOPE.md (узкое read-only исключение #53, принятое 2026-08-15 и суженное 2026-09-07), docs/CHANGELOG*;
• тесты §13; golden-сцена; смок demo/smoke_pdf_export.mjs; scripts/mutation-gate.mjs — свидетели §13.

12. Критерии приёмки

AC	Критерий	Доказательство
AC1	Кнопка-принтер между шестерёнкой и «?» у _canEdit, отсутствует в киоске; открывает диалог с заголовком, галочками §8.5 и кнопкой	smoke
AC2	Галочка «подложка» присутствует только у пространства с bg; состояние галочек переживает перезагрузку страницы	smoke
AC3	«Сохранить» скачивает файл houseplan-<slug>-<дата>.pdf; в файле ровно одна страница A4 (MediaBox 595.28×841.89 или наоборот) с ориентацией по пропорциям	smoke (перехват download) + unit на writer
AC4	Геометрия §7.1: стены с толщиной залиты, нулевые — штрих, проёмы с разрывами, общая стена один раз, ни одного маркера/состояния/цвета комнаты	golden по растру PDF (§13) + unit по операторам контент-потока
AC5	Внутренние размеры: каждое ребро чистого контура комнаты (грань-в-грань) имеет числовую подпись, нумерованную выноску либо разрешённую для ребра < 30 см засечку; значения не исчезают из-за коллизий, совпадают с formatLength живой линейки на том же ребре, площадь — с карточкой комнаты; по этим данным комната вычерчивается автономно (тест восстанавливает контур и сверяет с моделью)	unit (фикстуры: прямоугольник, L, комната с выступом, плотный непрямоугольный контур с выноской, общая толстая стена, виртуальная граница, партиция внутри комнаты)
AC6	Внешние размеры: у каждой прямой физической наружной грани планировки, включая грань < 30 см, своя размерная линия и числовое значение снаружи контура; несвязные контуры — каждый свои; виртуальные границы без размера; текст не вверх ногами; тесные значения не скрываются, а детерминированно выносятся	unit на раскладку + golden
AC7	Галочки реально управляют содержимым: без «размеров» в PDF нет ни одной размерной строки; без «названий» — ни одного названия; без «декора» — ни одного декор-объекта; без «подложки» — ни одного XObject Image	unit по извлечённому тексту/операторам
AC8	Кириллица и латиница в названиях печатаются встроенным сабсетом; текст извлекается из PDF (pdfjs-dist в тесте) как Unicode — работает ToUnicode	unit
AC9	Подвал: масштаб из ряда §7.5, линейка соответствует масштабу (1 м на бумаге = 1000/N мм ± 0,1 мм), стрелка севера при компасе, легенда только присутствующих элементов	unit
AC10	Детерминизм: два вызова с тем же now дают идентичные байты; изменение любой галочки — другие	unit
AC11	Ленивость: чанк pdf не в initial, initial View растёт только на кнопку, exact-build loader и передачу контекста (≤ 1 200 Б gzip; замер реализации относительно origin/dev — 983 Б); отказ загрузки чанка → тост, карточка жива; чужая сборка → терминальный отказ без повтора	bundle:budget + smoke с перехватом чанка (образец #474)
AC12	Скачивание работает в мобильном приложении HA (Android) — файл появляется в загрузках	вручную владельцем на даче до закрытия, запись в issue
AC13	Растровая подложка встроена под геометрией с прозрачностью, лимит 25 МБ даёт pdf.too_large без файла	unit + smoke
AC14	Диалог модален и центрирован после переподключения HA (контракт #463)	smoke_pdf_export повторяет reconnect-проверку из smoke_dialog_modal_recovery на реальном hp-pdf-dialog
AC15	Свидетели §13 в реестре, каждый «поймано 1 из 1»	отрицательные прогоны

13. План автотестов

• test/pdf-writer.test.mjs — объекты/xref валидны (парсится pdfjs-dist), шрифт CIDFontType2 + ToUnicode, изображение DCTDecode, детерминизм.
• test/pdf-dimensions.test.mjs — пролёты и площади на общих фикстурах, раскладка, коллизии, нумерованные выноски, порог 30 см только для внутренних рёбер, короткая внешняя грань с числом, «не вверх ногами».
• test/pdf-scene.test.mjs — таблица §7.1 по операторам, галочки (AC7), подвал (AC9), ориентация и ряд масштабов.
• demo/smoke_pdf_export.mjs — кнопка, диалог, localStorage, перехват download, MediaBox, отказ чанка, лимит растра.
• golden: сцена pdf-export-geometry-light — PDF рендерится pdfjs-dist в canvas в браузере golden-harness и сравнивается как PNG (детерминизм §8.4 делает это устойчивым); при отклонении — обычная приёмка эталона.
• Свидетели: pdf-shared-wall-twice (общая стена дважды), pdf-dimensions-ignore-toggle (галочка размеров не влияет), pdf-room-edge-dropped (у непрямоугольной комнаты пропущено ребро — контур невосстановим), pdf-outer-face-inside (внешний размер нарисован внутри контура), pdf-virtual-wall-solid (нулевая стена сплошная), pdf-font-no-tounicode (текст без ToUnicode — не извлекается), pdf-backdrop-over-geometry (подложка поверх геометрии), pdf-devices-leak (маркеры попадают на лист), pdf-scale-not-standard (масштаб не из ряда).

14. Release-артефакты

User-Visible: yes. Changelog en/ru: «Экспорт текущего пространства в PDF: чистый архитектурный план с размерами, площадями и названиями комнат, по желанию — мебель и подложка (#53)». docs/PDF-EXPORT.md (что печатается, правила измерений — ссылка на 052, ограничения растров, шрифт и лицензия), раздел в USER-GUIDE/USER-GUIDE.ru, скриншот диалога в документации (пересъёмка по правилу §8 PROCESS).

15. Производительность и безопасность

Генерация — синхронный расчёт сцены из уже построенных видимой карточкой кэшей стен, чистых контуров и чистых площадей комнат (< 200 мс CPU для одного текущего пространства large-house: 20 комнат и относящиеся к этому пространству перегородки, колонны и декор; проверяется в unit как порог) плюс асинхронная растеризация подложки. Ничего не уходит в сеть, кроме загрузки чанка и получения подложки тем же путём, что и на экране. PDF не содержит ссылок, скриптов, метаданных HA (только название пространства, дома, дата, версия). Шрифт — лицензия Apache 2.0, файл лицензии в репозитории.

16. Риски и меры

Риск	Мера
Собственный writer даёт PDF, который открывается не везде	тест парсером pdfjs-dist + ручная проверка в Acrobat Reader, Chrome, macOS Preview, Android (AC12); простой PDF 1.4 без потоков-объектов и без сжатия контент-потока
Размерные подписи налезают друг на друга на плотных планах (по 4+ числа на комнату)	детерминированная коллизия §7.3: внешние → площади → длинные рёбра; у прямоугольников дубликаты опускаются первыми, обязательные значения переходят в выноски; проверено на текущем 20-комнатном пространстве large-house в golden
Ядро на потолке	логика целиком в src/pdf/**, ядро — кнопка и вызов; счёт строк в дифе
Растры делают файл огромным	лимит 25 МБ, JPEG q=0.85, тост вместо молчаливого 100-МБ файла
Мобильное приложение не скачивает Blob	AC12 вручную до закрытия; при отказе — запасной путь data:-URL в новой вкладке, решение по факту
Детерминизм ломается плавающей точкой раскладки	координаты округляются до 0,01 pt перед записью

17. Откат

Revert одного коммита: кнопка и чанк исчезают, конфиг и данные не затрагивались, localStorage-ключ становится бесхозным (безвреден).

18. Принятые предположения и вопросы к ревью ТЗ

• Q1 — значения галочек по умолчанию. Владелец задал только «размеры — включена». Принято: названия комнат — включена (архитектурный план без названий комнат нечитаем), мебель и другой декор — выключена («чистый план»), подложка — включена, если есть (формулировка владельца «подложка — да, если она включена на этом пространстве»).
• Q2 — кому видна кнопка. Принято: тем же, кому видны шестерёнка и «?» (_canEdit), поскольку владелец поместил её между ними; не-админы экспорт не получают. Альтернатива — всем, кто видит карточку.
• Q3 — формат листа и масштаб. Принято автоматическое решение §7.5 (A4, автоориентация, стандартный ряд масштабов); выбор в диалоге — не-скоуп.
• Шрифт Roboto Regular как единственный (без жирного): заголовок — тот же шрифт большим кеглем.
• Изометрическая проекция на печать не влияет: всегда плоский план.