Building/.template/development/modules/components.md

Модуль: Компоненты

Ответственность: содержит проверенные переиспользуемые визуальные примитивы, которые не принадлежат одному профилю документа. Расположение: .template/lib/presentation/components.typ

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

Символ	Тип	Описание
corp-table()	функция	Корпоративная таблица со сложной шапкой, spans и продолжениями
formula()	функция	Блочная формула, совместимая с профильной нумерацией
signature-block()	функция	Один подписант с media policy
multi-party-signing()	функция	Подписание несколькими сторонами
approval-block()	функция	Блок утверждения отчёта
company-footer()	функция	Контакты и реквизиты организации в footer
letter-header()	функция	Общая геометрия исходящего письма и ТКП
attachment-list()	функция	Перечень приложений к письму или ТКП
requisites-table()	функция	Реквизиты одной или нескольких сторон

Зависимости

Модуль	Что использует
.template/lib/domain/company.typ	Нормализованные реквизиты и brand
.template/lib/domain/parties.typ	Signer, Approval и Party
.template/lib/domain/attachments.typ	AttachmentSet для перечней
.template/lib/presentation/foundation.typ	Design tokens и render-media-slot()
.template/lib/shared/numbering.typ	Общие numbering functions

Инварианты

• Компонент не читает JSON и не конструирует пользовательский path.
• Компонент не определяет global page settings.
• corp-table сохраняет поддержку auto/multirow headers, rowspan/colspan, repeat header и continuation label.
• row_breakable: true действительно передаётся в table.cell(breakable:); режим проверяется fixture с одной строкой, которая продолжается на трёх страницах.
• Центрирование блока corp-table не наследуется текстом ячеек: шапка по умолчанию центрирована, тело выровнено влево; явный align имеет приоритет.
• Блок подписи сохраняет эталонную геометрию для обычных реквизитов и переключается на ограниченные равные боковые колонки при длинных наименованиях.
• Письмо и ТКП используют один эталонный footer; на страницах приложений footer скрывается.
• Обязательный positional body идёт первым в функциях, используемых через .with, если это требуется Typst.
• Компонент принимает domain-значение и layout options отдельно.
• Любая работа с изображением проходит через media slot или проверку resource != none.
• Компоненты не импортируют profile renderers.

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

• Полный жизненный цикл документа.
• Profile-specific обязательность полей.
• Выбор компании по id.
• Сброс глобальных counters между главами.

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

corp_table считается особо хрупким: не переписывайте рекурсивное определение header rows без unit и visual fixtures на rowspan/colspan. Общность компонента доказывается использованием хотя бы в двух профилях; иначе оставьте его внутри конкретного renderer. Layout offsets изображений должны быть параметрами компонента или design tokens, но не данными Signer.