2.9 KiB
ADR-0001: Typst 0.15.1 как минимальная платформа
Дата: 2026-08-26 Статус: Принято
Контекст
Шаблон уже реализован на Typst и использует его counters, introspection, show rules и PDF-рендер. После обновления окружения доступен Typst 0.15.1, который добавляет несколько bibliographies, тип path для передачи project-relative ресурсов и более подробные diagnostics. Одновременно 0.15 меняет baseline некоторых layout-элементов, поэтому обновление должно сопровождаться визуальным аудитом.
Официальные основания: changelog Typst 0.15.0, bibliography, path.
Рассматриваемые варианты
- Остаться на Typst 0.14.2 — меньше миграционных рисков сейчас, но нет нативных нескольких bibliographies и нового
path. - Принять Typst 0.15.1+ — доступны нужные возможности, но требуется новый baseline и контроль будущих обновлений.
- Перейти на LaTeX или Word — большая экосистема, но фактически требует переписать проверенную вёрстку и усложняет программируемые компоненты.
Решение
Выбрали Typst 0.15.1 как минимальную поддерживаемую версию, потому что она уже установлена, поддерживает несколько bibliographies и даёт корректную модель передачи путей между пользовательским проектом и библиотекой.
Каждое обновление Typst выполняется отдельным изменением: сначала полная компиляционная и визуальная матрица, затем принятие новых snapshots.
Последствия
Становится проще: тематические и поглавные библиографии, автономное подключение шаблона, диагностика layout convergence.
Становится сложнее: необходимо контролировать версию CLI и визуальные изменения baseline.
Закрывает дверь на: поддержку Typst 0.14 и более ранних версий без отдельной compatibility-ветки.