diff --git a/AGENTS.md b/AGENTS.md index be3fabc..1abe1b7 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -51,7 +51,7 @@ Java2D → PNG: `ChartRenderer.DPI = 300`, потолок `MAX_PIXELS = 16_777_2 - Единственный XSL-FO-стилист — вендорный `xslt/docx2fo.xslt` (копия из docx4j-export-fo 17.3.2 + два AUDIT-FIX-патча: `w:rPr/w:position` → `baseline-shift`, Part 1 §17.3.2.24; AUDIT-FIX-2 — `w:moveFrom`/`w:moveTo`/`w:bdo`/`w:dir`, иначе их ловит catch-all `match="*"` и текст теряется). Дрейф-гейт `vendoredXsltTracksJarCopy`: вне AUDIT-FIX-регионов копия побайтно равна стилю из jar'а. `setCustomXsltTemplates` принимает предкомпилированный `Templates`. - `slf4j-simple` обязателен в ядре: без SLF4J-провайдера docx4j пишет «TO HIDE THESE MESSAGES» прямо в PDF (регрессия `noLoggingWarningInPdf`); приложение исключает его — логи ведёт logback. - FOP — форк `org.docx4j:docx4j-fo-renderer*` 2.11-docx4j.6 (транзитив от `docx4j-export-fo`, в pom не пинится; пакеты `org.apache.fop.*`). `FopFallbackFonts` берёт `w:renderer` с mime `application/pdf`, иначе первый со шрифтами. -- `BundledFonts.init()` идемпотентен и `synchronized`, распаковывает TTF в `wordpdf-fonts-*` (`deleteOnExit`); `dropNonBundled()` чистит `PhysicalFonts` от всего, что вне бандла. +- `BundledFonts.init()` идемпотентен и `synchronized`, распаковывает TTF в `wordpdf-fonts-*` (`deleteOnExit`); `dropNonBundled()` чистит `PhysicalFonts` от всего, что вне бандла; `font()`/`regular()`/... синхронизированы с `init()` (реестр `VARIANTS`). Внешние `init()`/`restrictToBundled()` во время идущих конвертаций — только под монитором `WordPdfConverter.class`. - `PhysicalFonts` — глобальный и мутируемый → конвертации сериализуются монитором `WordPdfConverter.class` внутри ядра (общая `FopFactory` и сброс её image-кешей — под тем же монитором); приложение держит однопоточный воркер ради 503/timeout; `warmup()` идёт тем же потоком. - Страницы в валидаторе = `max(кэш docProps/app.xml, явные разрывы, lastRenderedPageBreak+1)`; правила StAX-подсчёта — `docs/agent/pipeline.md`. - Не чинить: `jc="distribute"`, `suff="tab"`/`lvlJc`, метрика «single», кернинг, `framePr`, `REF`/`SEQ`/`TOC`-кэш, руби-надстрочница, U+2188/U+218A — доказательства в `docs/agent/render-limitations.md`. diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/BundledFonts.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/BundledFonts.java index c8176be..d78e3df 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/BundledFonts.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/BundledFonts.java @@ -188,6 +188,11 @@ public final class BundledFonts { * em-dash на шрифте ранa (Carlito) вместо fallback-DejaVu. * Шрифты, встроенные в docx, регистрируются при {@code load()} — * если чистить до load(), они останутся в реестре. + *
Мутирует глобальный реестр {@code PhysicalFonts}: нельзя звать
+ * параллельно идущей {@code WordPdfConverter.convert()} — рендер
+ * начнёт терять шрифты. Внешний вызов рядом с идущей конвертацией
+ * обязан держать монитор {@code WordPdfConverter.class} — тот же,
+ * что сериализует конвертации.
*/
public static synchronized void restrictToBundled() {
if (!inited) {
@@ -232,10 +237,13 @@ public final class BundledFonts {
/**
* Зарегистрированный шрифт: семейство (lowercase) + начертание.
+ * Синхронизирован с {@link #init()}: {@code VARIANTS} — обычный
+ * {@code HashMap}, наполняемый в {@code init()} под тем же монитором
+ * класса; без замка внешний читатель мог бы увидеть недобранную карту.
*
* @return PhysicalFont или null (если init() не вызван или шрифта нет)
*/
- public static PhysicalFont font(String family, String variant) {
+ public static synchronized PhysicalFont font(String family, String variant) {
Map