Building/.template/development/modules/testing.md

Модуль: Тестирование

Ответственность: защищает слои библиотеки, единственный root entrypoint, public examples, PDF semantics и визуальную стабильность.
Расположение: .template/development/tests/

Публичный интерфейс

Символ или файл	Тип	Описание
run-tests.py	CLI	Полный release gate
manifest.json	fixture manifest	Compile, semantic, negative и visual expectations
check_architecture()	static check	Направление Typst imports
check_workspace()	static check	Root surface, docs, VS Code, private settings и public examples
snapshots/	visual baseline	Утверждённые страницы стабильных renderer fixtures

Зависимости

Компонент	Что использует
Typst 0.15.1+	Компиляция и PDF generation
Poppler	Text extraction, links и PNG rendering
Pillow	Pixel diff snapshots
docs/examples/	Public executable documentation

Инварианты

• Корень не содержит document.typ, draft.typ и clean-copy.typ.
• docs/ видим и содержит обязательную public navigation.
• Все четыре документа и formatting guide компилируются.
• Generic profile fixtures проверяют final, draft и clean-copy без root entrypoint duplication.
• Безопасный private settings example содержит всех сотрудников с отключёнными PNG.
• Unit tests проверяют public directory, private offsets и отсутствие подписи.
• Public company profiles не содержат настоящих sign/stamp.
• Snapshot изменяется только после ручного visual review.

Намеренно НЕ обрабатывает

• Юридическую корректность договоров.
• Инженерную достоверность example values.
• Установку сторонних extensions.

Заметки для агента

Public example является production-facing documentation: его compile failure блокирует выпуск так же, как regression renderer. Для layout changes сначала просмотрите rendered pages, затем осознанно обновите snapshots.