2.5 KiB
2.5 KiB
Модуль: Тестирование
Ответственность: защищает слои библиотеки, единственный 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.