Замена JEuclid/AWT-ветки формул на детерминированный растер только бандл-шрифтами jar (без fontconfig); FOP-конфиг дополняется всеми бандл-начертаниями при каждом declare — иначе общая FopFactory замораживает fopconf первого документа и теряет глифы. MathModel/MathRenderer: OMML (§22.1) → дерево боксов → PNG 300 dpi (только GlyphFont/fontbox, без java.awt.Font); метрики боксов равны габариту paint (пределы nary/sPre не обрезаются канвой). Unsupported конструкция или переполнение бюджета — текстовая деградация (m:t). Inline-картинка опускается раном w:rPr/w:position на базовую линию строки (FOP ставит инлайн-графику нижним краем на базу; AUDIT-FIX baseline-shift). Байтовое правило 6 MathFallbackNormalizer (перед GlyphCoverage) срезает unsupported-формулы до загрузки docx4j; формула в wps:txbx уходит в docx4j-фолбэк mathText. JEuclid исключён из pom (de.rototor jeuclid-core/jeuclid-fop); порядок zip-правил сдвинут (MathFallback → 6). Порядок сканов шрифтов закрыт гейтом FontsBundledOnlyInvariantTest + BundledFontAliases (единый алиас-реестр вместо рефлексивных мутаций реестра). Счётчики: 63 класса / 1004 теста (core 57/956, app 6/48); JaCoCo BRANCH core 0.8518. Доки: pipeline/render-limitations/repo-map/ testing/doc-bridge/MEM_USAGE_UPGRADE синхронизированы.
5.7 KiB
читать до попытки «починить» перечисленное ниже — это не баги, а невозможности FOP/docx4j. Авторитетно наравне с AGENTS.md.
Ограничения раскладки (FOP / docx4j)
-
Известный остаток эталона: U+2188/U+218A — глифов нет в OFL-шрифтах бандла, остаются
.notdef(GNU FreeSerif GPL — не добавляем намеренно). -
Аудит раскладки по ECMA-376 Part 1 (2026-10) — известные нечинимые ограничения FOP/docx4j (Java-слой):
w:jc="distribute"рендерится как left — межсимвольного распределения в FOP нет (ST_Jc §17.18.44: distribute — межсимвольный разнос, justify только межсловный), последняя строка блока не растягивается, свойстваtext-align-lastв форке нет (в docx4j-fo-renderer отсутствуют классы TextAlign*);w:suff="tab"иw:lvlJcигнорируются (numbering-лейбл всегда через hanging-tab; suff=space чинит правило 9, suff=nothing совпадает с docx4j — разделителя нет); абзац безw:lineрендерится natural-высотой FOP 15.44pt@11pt, явныйlineRule="auto"— 13.4277pt, два «single» в конвертере (13.4277 — канонический single по метрикам Carlito/Calibri 2500/2048 em; обе величины считаются по метрикам шрифта); кернинг не применяется ни для одного бандл-семейства (замер: advance A→V = A→A — Carlito 6.369pt, DejaVu Sans 7.524pt@11pt): 22 TTF — GPOS-only, а legacykern-таблица DejaVu Sans/Serif ключована glyph id, не совпадающими с cmap (2568/2727 пар без Unicode-маппинга, пары A→V нет) — латинский путь FOP (TextLayoutManager→Font.hasKerning) читает только legacykernи такие пары отбрасывает; свойстваkerningв форке нет, порогw:kernчерез FO не выражается. Word кернит только при явно заданномw:kernв иерархии стилей и при sz ≥ val (Part 1 §17.3.2.19: кернинг применяется, только когда элемент задан; при отсутствииw:kernне кернит; MS-OI29500 §2.1.83 уточняет лишь диапазонw:val) — по умолчанию совпадает с нами, расходится только для документов с явно заданнымw:kern. Починено веткой layout-class-c: левый padding ячейки (LayoutPostRenderer, шаг 4.25),w:tblIndприw:jc≠left (правило 8),w:suff="space"(правило 9). -
Аудит .docx-путей по ECMA-376 (2026-11) — запинено синтетикой (без фикстур): сноски/концевые сноски с номерами (§17.11), внешние гиперссылки с
/URI-аннотацией (§17.12.23),PAGEREF(complex и вложенный в результатTOC) иDATEподменяют кэш живым значением,titlePg→ first/default колонтитуки (§17.10.6),vMergerestart/continue (§17.4.70), block-levelw:sdt(§17.5.2),wps:txbx-текст (§17.3.3.23; формула внутри текстового бокса до растера не доходит — обход drawing-нагрузку не спускается и уходит в docx4j-фолбэкmathText, конкатенацияm:t; регрессия — WordPdfConverterTest#drawingTextBoxMath_convertsViaDocx4jTextFallback), OMML-формулы (§22.1) рисует собственный растерMathModel/MathRenderer— PNG 300 dpi, только бандл-шрифты jar, без AWT/JEuclid (текст из PDF не извлекается, пинь пикселями); неподдерживаемая конструкция или превышение бюджета — текстовая деградация (конкатенацияm:t,MathFallbackNormalizer, правило 6) + warn, inline-формула выравнивается по базовой линии текста (мат-ось Word — принятая деградация),m:oMathPara— отдельный центрированный абзац (left/right поm:jc, indentLeft→left); фонw:highlight/w:shdрисуется (§17.3.2.16/.29). Скрытый текстw:vanishне печатается (правило 10); текст руби-базы иw:moveFrom/w:moveTo/w:bdo/w:dirне теряется (правило 11 + AUDIT-FIX-2). Остаток (не чиним):w:framePrигнорируется — текст печатается в общем потоке, геометрия фрейма теряется (ни XSLT, ниcreateBlockForPPrне читают);REF/SEQ/литеральные записиTOCпечатают устаревший кэш из docx (движка пересчёта нет; инстринции полей не печатаются); надстрочница руби не выводится (правило 11 печатает только базу — ruby-разметки в FOP нет);w:ptabбез@w:alignment,bar,listтеряются catch-all'ом;w:bdo/w:dirпечатаются LTR (bidi вне контура).