From e308db47da4b17b3c7f7781864364ae73688d33c Mon Sep 17 00:00:00 2001 From: Pjandro Date: Sat, 21 Nov 2026 03:06:39 +0300 Subject: [PATCH] =?UTF-8?q?fix(fonts):=20=D1=80=D0=B5=D0=B0=D0=BB=D1=8C?= =?UTF-8?q?=D0=BD=D1=8B=D0=B5=20=D0=BD=D0=B0=D1=87=D0=B5=D1=80=D1=82=D0=B0?= =?UTF-8?q?=D0=BD=D0=B8=D1=8F=20=D0=B1=D0=B0=D0=BD=D0=B4=D0=BB=D0=B0=20?= =?UTF-8?q?=D0=B2=20getBoldForm/getItalicForm/getBoldItalicForm?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit На macOS PhysicalFonts.getBoldForm для имён бандл-шрифтов ('Tinos Regular', 'Carlito Regular', ...) уходит в MicrosoftFontsRegistry, где у этих записей Mac-имя файла null, и возвращает null; docx4j строит simulate-style fopconf (все начертания на regular-TTF), FOP теряет реальные Bold/Italic — метрики и кернинг ломают переносы (strictOoxml: 'таблица' -> 'таблиц а'). BundledFontMapper переопределяет три variant-form метода: семейство опознаётся по embeddedURI regular-варианта, начертание берётся реальным из бандла; вне бандла / без init() — родительская логика без изменений. Тест: BundledFontMapperTest#variantForms_resolveBundleSibling (красный на macOS без override); регрессии: WordPdfConverterTest#strictOoxml_convertsNotRejected, #ruPlain_regularRunsUseRegularFont (проверены под -Dos.name='Mac OS X'). docs/agent/pipeline.md: абзац о macOS-ветке. --- docs/agent/pipeline.md | 2 + .../wordpdf/fonts/BundledFontMapper.java | 56 +++++++++++++++++++ .../wordpdf/fonts/BundledFontMapperTest.java | 27 +++++++++ 3 files changed, 85 insertions(+) diff --git a/docs/agent/pipeline.md b/docs/agent/pipeline.md index 290968d..7b815dd 100644 --- a/docs/agent/pipeline.md +++ b/docs/agent/pipeline.md @@ -16,6 +16,8 @@ | 6 | `Docx4J.toFO(foSettings, os, FLAG_EXPORT_PREFER_XSL)` | XSL-FO → PDF | | 7 | `finally` → `getFontTablePart().deleteEmbeddedFontTempFiles()` | В docx4j 17.x `OpcPackage.close()` нет — пакет в памяти | +`BundledFontMapper` переопределяет `getBoldForm`/`getItalicForm`/`getBoldItalicForm`: на macOS `PhysicalFonts.getBoldForm` для имён `Tinos Regular`/`Carlito Regular`/… уходит в `MicrosoftFontsRegistry` и возвращает `null` (у записей нет Mac-имени файла), из-за чего docx4j строил simulate-style fopconf — FOP терял реальные начертания и кернинг (регрессии `strictOoxml_convertsNotRejected`, `ruPlain_regularRunsUseRegularFont`). Override находит реальный вариант по `embeddedURI` regular-варианта. + ### `warmup()` — прогрев ядра (шаги 0–7 на минимальном docx) Первая конвертация после старта JVM стоит 1,3–1,7 с (JAXB/XSLT/FOP/классы; замер 2026-11), её платил первый запрос после деплоя. Публичный `WordPdfConverter.warmup()` прогоняет шаги 0–7 на минимальном docx, собранном в байтах (три zip-части константами, фикстуры не задействованы; алиас Calibri→Carlito греет маппер и embed-подмножество), и греет Java2D/PNG-энкодер (`warmRaster()` — растер + `GlyphFont.draw` + `ImageIO.write`), иначе первый чартный документ платит ещё ~200 мс. Идемпотентен (`volatile warmedUp`, метод `synchronized`), никогда не бросает (провал — warn в JUL), артефакты отбрасываются; вызывать на потоке, сериализующем конвертации. Ядро само себя не зовёт: `wordpdf-app` ставит warmup головой очереди воркеров в конструкторе `ConversionService`. Прогретый первый конверт ru-plain.docx HTTP-запросом: 0,13 с против 1,74 с (A/B на одной машине, сборки ветки и `main`). diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/BundledFontMapper.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/BundledFontMapper.java index e0e1dd7..13939e8 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/BundledFontMapper.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/BundledFontMapper.java @@ -26,6 +26,17 @@ import java.util.Set; * файл для каждого начертания. Ключи register*Form — точное имя из * документа: docx4j ищет варианты именно по нему. * + * ВАЖНО (macOS): {@code PhysicalFonts.getBoldForm} для имён бандл-шрифтов + * ({@code Tinos Regular}, {@code Carlito Regular}, …) на macOS уходит в + * {@code MicrosoftFontsRegistry} и возвращает {@code null} — у этих записей + * нет Mac-имени файла. docx4j тогда строит simulate-style fopconf (все + * начертания на regular-TTF), и FOP теряет реальные Bold/Italic: другие + * метрики и кернинг ломают переносы в узких ячейках (регрессии — + * {@code WordPdfConverterTest#strictOoxml_convertsNotRejected}, + * {@code #ruPlain_regularRunsUseRegularFont}). Override-ы + * {@code getBoldForm}/{@code getItalicForm}/{@code getBoldItalicForm} + * отдают реальные бандл-варианты. + * * ВАЖНО (порядок инициализации): конструктор BestMatchingMapper * запускает обнаружение системных шрифтов, которые могут занять те же * имена в реестре docx4j. Поэтому {@code BundledFonts.init()} нужно @@ -86,6 +97,51 @@ public class BundledFontMapper extends BestMatchingMapper { } } + /** Начертание бандла вместо registry-эвристики: см. «ВАЖНО (macOS)» в javadoc класса. */ + @Override + public PhysicalFont getBoldForm(String fontName, PhysicalFont physicalFont) { + PhysicalFont bundled = bundledSibling(physicalFont, BundledFonts.V_BOLD); + return bundled != null ? bundled : super.getBoldForm(fontName, physicalFont); + } + + /** Начертание бандла вместо registry-эвристики: см. «ВАЖНО (macOS)» в javadoc класса. */ + @Override + public PhysicalFont getItalicForm(String fontName, PhysicalFont physicalFont) { + PhysicalFont bundled = bundledSibling(physicalFont, BundledFonts.V_ITALIC); + return bundled != null ? bundled : super.getItalicForm(fontName, physicalFont); + } + + /** Начертание бандла вместо registry-эвристики: см. «ВАЖНО (macOS)» в javadoc класса. */ + @Override + public PhysicalFont getBoldItalicForm(String fontName, PhysicalFont physicalFont) { + PhysicalFont bundled = bundledSibling(physicalFont, BundledFonts.V_BOLD_ITALIC); + return bundled != null ? bundled : super.getBoldItalicForm(fontName, physicalFont); + } + + /** + * Реальное начертание бандл-семейства, к которому относится {@code pf}. + * + *

Семейство опознаётся по {@code embeddedURI} regular-варианта, а не + * по имени: на macOS имя в реестре docx4j — полное из TTF-таблицы + * ({@code Tinos Regular}), и именно на нём ломается + * {@code PhysicalFonts.getBoldForm}. Шрифт вне бандла (или {@code pf == + * null}, {@code BundledFonts.init()} не вызван) → {@code null}, вызывающий + * идёт родительской логикой.

+ */ + private static PhysicalFont bundledSibling(PhysicalFont pf, String variant) { + if (pf == null || pf.getEmbeddedURI() == null) { + return null; + } + String uri = pf.getEmbeddedURI().toString(); + for (String family : BundledFonts.families()) { + PhysicalFont regular = BundledFonts.regular(family); + if (regular != null && uri.equals(regular.getEmbeddedURI().toString())) { + return BundledFonts.font(family, variant); + } + } + return null; + } + /** * Привязывает все начертания семейства к имени шрифта из документа. */ diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/fonts/BundledFontMapperTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/fonts/BundledFontMapperTest.java index 75da595..280335a 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/fonts/BundledFontMapperTest.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/fonts/BundledFontMapperTest.java @@ -99,4 +99,31 @@ class BundledFontMapperTest { "без init() алиасованный шрифт не должен попасть и в fallback"); }); } + + /** + * Варианты начертаний отдаются реальным sibling-файлом бандла, а не + * результатом registry-эвристики: на macOS без override + * {@code PhysicalFonts.getBoldForm} для «Carlito Regular» уходит в + * {@code MicrosoftFontsRegistry} (Mac-имя файла {@code null}) и возвращает + * {@code null} — на этой платформе тест красный. На Linux super тоже + * находит bold, поэтому сквозная регрессия macOS — конвертерные тесты + * {@code WordPdfConverterTest#strictOoxml_convertsNotRejected} и + * {@code #ruPlain_regularRunsUseRegularFont}, а этот фиксирует контракт + * маппера. + */ + @Test + void variantForms_resolveBundleSibling() { + BundledFonts.init(); + BundledFontMapper mapper = new BundledFontMapper(); + PhysicalFont regular = BundledFonts.regular("carlito"); + + assertSame(BundledFonts.bold("carlito"), + mapper.getBoldForm("Carlito Regular", regular), "bold-вариант"); + assertSame(BundledFonts.italic("carlito"), + mapper.getItalicForm("Carlito Regular", regular), "italic-вариант"); + assertSame(BundledFonts.boldItalic("carlito"), + mapper.getBoldItalicForm("Carlito Regular", regular), "bolditalic-вариант"); + assertNull(mapper.getBoldForm("Unknown", null), + "путь super без physicalFont не должен падать"); + } } -- 2.56.1