docx4j 17.3.2 требует ковариантный ZipArchiveInputStream.getNextEntry()
(>= 1.25.0); BOM/nearest-wins потребителя мог навязать старую версию —
конвертация падала NoSuchMethodError внутри docx4j. Теперь шаг 0
convertToStream бросает ConversionException с инструкцией; commons-compress
объявлена явной зависимостью ядра (1.28.0, версия docx4j); README —
закрепление версии в Maven/Gradle. Регрессия — DependencyGuardTest,
негативная ветка проверена подменой jar (1.21 → ConversionException).
Знак без глифа в шрифте ранa FOP рисовал .notdef — в эталонном
references/word.docx таких оставалось 28.
- Noto Naskh Arabic и Noto Sans Armenian (SIL OFL, 278 КБ) в бандле:
FontFallback.selectCovering перебирает весь реестр PhysicalFonts и
находит их сам — арабские дополнения и армянские Unicode 16 рисуются
без нашего кода.
- GlyphCoverageNormalizer режет ран по покрытию глифов и пишет семейство
в w:rFonts. Нужен из-за двух дыр docx4j: needsCoverage=false для
«латинской» группы (римские цифры U+2150–U+218F) и кэш fallbackByScript
на всю группу Юникода (армянские U+058D/U+058E получали DejaVu Serif).
- FopFallbackFonts.declare декларирует все бандл-семейства: FOP встраивает
только задекларированные, а font-family в FO может запросить любое.
В эталоне осталось 2 решёток: U+2188 и U+218A есть только в GNU FreeSerif
(GPL-3+ с Font Exception), которого в бандле нет намеренно.
17.x приносит WordLayoutFixups (постобработка DOM XSL-FO: columnBreaks,
lineBoxAttributes, stripHints и др.) и jeuclid-fop, поэтому начинают
работать две вещи, которых не было: формулы m:oMath (на стр. 4 эталона
формула молча исчезала) и w:cols/@w:num (две колонки на стр. 9-11).
Сходимость текста references/word.docx с экспортом Word 0,848 -> 0,981,
средний постраничный пиксельный diff 10,5% -> 7,4%.
Что пришлось починить по пути:
* docx4j навешивает на fo:inline fox:gsub-features, не объявляя префикс
fox. FO становится некорректным XML, WordLayoutFixups не парсит его и
молча отказывается от всех фикс, а оставленный хинт docx4j-baseline
отвергает уже FOP. Отключаем генерацию через
docx4j.convert.out.fo.gsubFeatures=false.
* FOP теперь форк org.docx4j:docx4j-fo-renderer*, и его
META-INF/services/org.apache.fop.fo.ElementMapping лежит ещё и в
docx4j-export-fo: в fat-jar без ServicesResourceTransformer второй файл
перезаписывает первый, FOP не узнаёт namespace fo: и падает на
UnknownXMLObj. Тесты этого не видят — они идут по classpath.
* addPhysicalFont не перезаписывает занятый ключ реестра: системный
DejaVuSerif.ttf занимает «dejavu serif» и наш DejaVuSerif-Regular.ttf
не регистрировался. BundledFonts.init() чистит реестр до регистрации.
* Fop.Renderers.getRenderer() теперь список w:renderer по mime —
FopFallbackFonts ищет application/pdf.
Em-dash (U+2000-U+2EFF) остался на шрифте ранa, если в нём есть глиф —
так же делает Word (в references/word.pdf em-dash нарисован Calibri/Times,
DejaVu нет вообще), поэтому тест проверяет «вшитый шрифт, не Helvetica»,
а не конкретное семейство.