DrawingFoundException с enum Kind удалён: каждый error-флаг бросает свой
тип-наследник ConversionException с фиксированным сообщением. App-слой
сохраняет один DrawingRejectedException (422) — маппинг по типу в
ConversionService.doConvert, тексты ответа не изменились (контракт с
фронтом). Обновлены тесты и документация.
На хостах без fontconfig (arm64 без /etc/fonts) jeuclid-fop при первой
OMML-формуле падает InternalError: Fontconfig head is null — проба
MathMlSupport фиксирует недоступность AWT-шрифтов один раз на JVM,
MathFallbackNormalizer (правило 11, после Ruby) заменяет m:oMath/
m:oMathPara ранами с конкатенацией m:t (как docx4j mathText). С
fontconfig поведение не меняется (вектор).
Контейнер Containerfile.test (maven:3.9-temurin-17 без fontconfig с
JVM-гейтом) прогоняет mvn clean verify по этой ветке всегда: задача
mise verify-nofontconfig и шаг CI в pr.yml/main.yml.
checkDocxContainer получает бюджеты параметром; validate считает их из
ConvertOptions.maxMb()/maxPages(): clamp(maxMb×10MiB + maxPages×64KiB, 16MiB,
MAX_DECOMPRESSED_MB) и clamp(maxMb×4MiB + maxPages×32KiB, 4MiB,
MAX_DECOMPRESSED_XML_MB) (коэффициенты/полы — package-private константы
WordPdfConverter, compile-time инлайн — WordPdfValidator по-прежнему без
зависимости от docx4j). Константы WordPdfSettings — жёсткие крышки (публичный
API, защита JAXB DOM). Сообщения печатают вычисленный бюджет. Тесты: пол
(16 МБ при maxMb=1), масштабирование и крышка (64 МБ при maxMb=10); доки
синхронизированы.
Аудит потокобезопасности ядра: font()/regular()/... читали VARIANTS
(HashMap, пишется в init() под монитором BundledFonts.class) без
замка — публичный API гонял с init(). font() стал synchronized
(делегаты regular/bold/italic/boldItalic идут через него). Контракты
зафиксированы javadoc: restrictToBundled() рядом с идущей
конвертацией — только под монитором WordPdfConverter.class;
потокобезопасность GlyphFont (монитор of(), volatile cmap, внутренние
замки fontbox lockReadtable). Инвариант — AGENTS.md. Тест
concurrentFontApi_callsAllSucceed — 4 потока × 50 итераций font-API.
Регрессия — BundledFontsTest#concurrentFontApi_callsAllSucceed.
Публичный convert() теперь безопасен из нескольких потоков: секция после
валидации (мост .doc + convertToStream) выполняется под монитором класса —
общая FopFactory (per-render disableFontCache, имиджевые кеши) и её сброс в
finally больше не могут пересечься с параллельным рендером. warmup()
синхронизирован тем же монитором (реентельно). WordPdfValidator остаётся
до монитора: stateless, вызывается параллельно HTTP-потоками.
Регрессия — WordPdfConverterTest#concurrentConversions_twoThreadsBothSucceed.
Комментарии ConversionService/AGENTS/repo-map приведены к новому контракту.
Переиспользование FopFactory между конвертациями раньше запрещалось:
форк FOP копит на фабрике image-кеши (xmlgraphics-commons ImageCache:
imageInfos/images и ImageObjectCacheImpl), ключи записей — временные
файлы file:/tmp/<uuid>… с уникальным на конвертацию именем, попадания
не бывает никогда, а soft-ссылки не освобождаются при свободной куче
(2 ГБ фиксированная): после 30 конвертаций ~1,5 ГБ живых byte[]
против 17 МБ, рост live-кучи, Full GC.
Теперь фабрика одна на JVM, а каждая конвертация в finally вызывает
resetSharedImageCaches() — публичные clearCache() у ImageCache и
ImageObjectCacheImpl. Разбор шрифтов форка (GPOS, ~140k объектов)
теперь один раз на JVM. Замер после фикса: 16,8 МБ живых byte[],
heap used 89 МБ после 30 конвертаций, Full GC от нагрузки — 0.
Регрессии — WordPdfConverterTest#fopFactorySharedAcrossConversions,
#sharedImageCaches_clearedAfterConversion.
ChartImageHandler: для не-JPEG без кропа с ppi <= threshold (или без
размера в макете) PictureCompression.compress всегда возвращает null,
но сначала декодирует полный растр ImageIO — решение принимается по
26 байтам заголовка (PNG/GIF/BMP), растр не декодируется вовсе; JPEG
остаётся на штатном пути CR-029 (перекодировка «для размера» сохранена).
OleObjectNormalizer: детект <w:object — потоковым поиском окном 8 KiB
с перекрытием, без readAllBytes()+new String на каждую word/*.xml.
Heap: ENTRYPOINT -Xms2g -Xmx2g (вместо -XX:MaxRAMPercentage=70),
mem_limit 2g -> 3g (compose.yml, compose.dev.yml, прод-heredoc
main.yml) — фиксированный heap + запас под metaspace/native.
Отменённая ветка: переиспользование общей FopFactory между прогонами
копит шрифтовые данные форка FOP на каждый render (замер 2026-11:
после 30 конвертаций ~1,4 ГБ живых byte[] против 17 МБ при
per-conversion сборке, рост live-кучи, Full GC) — фабрика остаётся
per-conversion, инвариант зафиксирован комментарием.
GC-замер (java -jar, -Xms2g -Xmx2g, 30 конвертаций фикстур): young
5 против 7 на main, паузы 12,2 мс против 18,7 мс, Full GC нет на обоих.
Тесты: ChartImageHandlerTest +5 (PNG/GIF/BMP/JPEG/выше порога),
OleObjectNormalizerTest +1 (маркер через границу окна).
Мост .doc → .docx (internal/doc) и javadoc-контракты переводятся на
ConversionException; WordPdfValidator.checkPageCountDoc оборачивает отказ
моста в ValidationException с сохранением текста (вердикт «вход
некорректен» выносит только валидатор; глубина, ловимая лишь при
конвертации, становится 500 — как у .docx). Проверки ConvertController
переезжают на новый app-класс BadRequestException (400 с теми же
текстами), ApiExceptionHandler получает хендлер. Тесты моста доказывают
ровно тип (assertSame(ConversionException.class, ...)); новый регрессивный
WordPdfValidatorTest#checkPageCountDoc_brokenBridge_wrappedAsValidation.
Документация (AGENTS.md, docs/agent/doc-bridge.md) синхронизирована.
Первая конвертация после старта JVM стоит 1,3–1,7 с (JAXB/XSLT/FOP/классы),
её платил первый запрос после деплоя. warmup() прогоняет весь пайплайн на
минимальном docx, собранном в байтах (фикстуры не задействованы), и греет
Java2D/PNG-энкодер для пре-рендера диаграмм. Идемпотентен (volatile флаг),
не бросает (провал — warn в JUL), артефакты отбрасываются. Ядро само себя
не прогревает — момент прогрева решает приложение.
Прогретая первая конвертация ru-plain.docx: 100 мс против ~1,4 с холодную.
BestMatchingMapper (static) при первом касании сканирует системные шрифты
и все jar'ы classpath'а (~100–140 мс на JVM плюс память реестра), а
BundledFonts.restrictToBundled() перед каждой конвертацией всё найденное
выбрасывает. Гейт-свойства discoverPhysicalFonts/discoverJarFonts ставим
в false в static-блоке WordPdfConverter (инициализация класса
предшествует первому new BundledFontMapper()). discoverJarFonts("fonts-symbol")
свойством не гейтится — символ-шрифт регистрируется и снимается restrict'ом
как раньше; живой реестр (Panose-путь) после restrict идентичен, всё
незамапленное — финальный fallback DejaVu Sans (прежняя стратегия).
DrawingPreRenderer.swapForPicture вставляет media-часть вручную
(newPartForContentType → setBinaryData → rels.addPart, имена
/word/media/chart-*): createImagePart писал temp-файл и декодировал
PNG обратно ради mime/размеров, которые нам и так известны.
ChartImageHandler (foSettings.setImageHandler) возвращает null из
compressedVariant для chart-* — «Compress Pictures» не ресемплит и не
декодирует наши 300-dpi растры; медиа документов остаются в штатном
docx4j-режиме. Замер (25 фикстур × 6 прогонов): chart-types.docx
657→507 МБ alloc (тёплый), суммарно 11640→10604 МБ, прочие 23 файла
±0%; ретеншн не изменился (144 MiB после GC), temp-файлов 0.
Регрессии: chartMedia_notDownsampled, DrawingPreRendererTest,
ChartImageHandlerTest.
- Правило 9 HiddenTextNormalizer: скрытые раны (прямой truthy w:vanish или
rStyle на vanish-стиль по цепочке w:basedOn) вырезаются до load() — Word
скрытое не печатает, стилист docx4j vanish не читает (скрытое утекало в PDF).
- Правило 10 RubyNormalizer: w:rubyBase/w:rubyBaseText разворачиваются,
w:rt/w:rubyPr/w:rubyAlign вырезаются — схема docx4j не биндит rubyBase/rt,
unmarshaller терял текст базы до XSLT (надстрочница — принятая деградация).
- AUDIT-FIX-2 в вендорном docx2fo.xslt: шаблоны w:moveFrom/w:moveTo/w:bdo/w:dir
(plain-text passthrough вместо catch-all); гейт vendoredXsltTracksJarCopy
обобщён на оба AUDIT-FIX-региона.
- Пиннинг работающих фич e2e-синтетикой: сноски/концевые, /URI-аннотации,
PAGEREF (complex + вложенный в TOC) и DATE (кэш заменяется живым), titlePg,
vMerge, block sdt, wps:txbx, OMML (пиксели), highlight/shd (фон рисуется —
прежняя запись в AGENTS.md о «fo:inline без фона» ошибочна, исправлена).
- AGENTS.md: правила 1–10, OLE=правило 11, инвентарь аудита, счётчики
(core 51/825, всего 57/868).
TTP-абзац каждой строки несёт свой sprmTDefTable; автомат использовал только
сетку первой строки → объединённая ячейка получала tcW первой колонки и
рендерилась пол-width с лишней вертикальной чертой в строке. Теперь rowXml
строит tcW/gridSpan из собственной сетки строки, согласованной с tblGrid
(ECMA-376 §17.4.65); при невыровненных границах — прежняя индексная выдача.
Регрессия — WordPdfConverterTest#docMergedTableRow_fullWidthNotSplit,
юниты — DocToDocxFormattingTest#mergedRow_gridSpanAndWidth,
#misalignedRow_fallsBackToColumnWidths.
Word выносит grpprl абзаца за FKP-страницу PAPX в Data-поток: одиночный
Prl sprmPHugePapx (0x6646) и цепочку sprmPTableProps (0x646B). Мост
читал сырой указатель → InTable/TTP/TAP терялись, строки таблиц с
huge-PAPX разваливались в плоские абзацы (жалоба на docTest.doc).
Новый класс PrcData.resolve(data, grpprl): union цепочки и исходных
Prl на позиции указателя; guard'ы (ptr за Data, cb вне [1, 0x3FA2],
цикл — бюджет 32 PrcData) — останов без исключения. Без указателей →
тот же массив. Отступление от §2.6.2 (обрыв за PTableProps) обязателен:
Word пишет после PTableProps легаси-зеркало с единственным TDefTable
(samples/ru-table-image.doc), а sprmTInsert из PrcData конвертер не
читает. Точка подключения единственная — DocxBody.buildRange.
Тесты: PrcDataTest (13 юнитов, byte[]-крафт), DocToDocxFormattingTest
#hugePapxRowMark_closesRowWithGridFromPrcData (POIFS-.doc, сетка из
цепочки). Живая проверка develop/docTest.doc: таблицы «Таблицы»
структурированы, фантомных рядов и плоских абзацев нет.
- readTitle: пустой/пробельный c:title (или val=0 без c:title) — автозаголовок
Office (MS-OI29500 §2.1.1561(a)): одиночный ряд с именем → имя ряда любого
типа графика, иначе плейсхолдер; раньше имя ряда — только у круговых
- autoTitleDeleted (§21.2.2.7) применяется только при отсутствии c:title
(MS-OI29500 §2.1.1431(a)) — явный заголовок показывается при любом флаге
- регрессии ChartSpecTest: emptyTitleSingleSeriesBar_usesSeriesName,
deletedTitleWithText_stillShown, deletedTitleValOmitted_stillShown,
noTitleElement_*; AGENTS.md приведён в соответствие
- Кернинг: DejaVu Sans/Serif имеют legacy kern-таблицу, но она ключована
glyph id вне cmap (2568/2727 пар без Unicode-маппинга, A->V нет) — FOP
такие пары отбрасывает; замер конвейера: A->V = A->A и у Carlito, и у
DejaVu (7.524pt@11pt). Вывод «не кернит ни одно семейство» подтверждён,
причина «все шрифты GPOS-only» была неточна — исправлено в AGENTS.md
- «Word ≈13.9pt»: заявленное «пиксельное округление 18px@96dpi» —
нерепродуцируемая реконструкция (артефактов замера нет); переформулировано
в AGENTS.md, LayoutPostRenderer и WordPdfConverterTest
- Spec-ссылки: §17.3.1.13/§17.18.44/§17.3.2.24/§17.4.50 — Part 1, не Part 4
(AGENTS.md, StrictOoxmlNormalizer, вендорный XSLT, два тестовых javadoc);
- гейт vendoredXsltTracksJarCopy: вместо пин-хэша побайтовое сравнение вендорной
копии со стилистом jarа после возврата AUDIT-FIX-региона к исходному
createBlockForRPr — ловит и апгрейд docx4j, и правку копии вне патча;
- регрессия rPrPositionWithVertAlign_converts: position+vertAlign в одном ране
(дубль baseline-shift) не роняет конвертацию;
- AGENTS.md: причинность distribute без text-align-last (в форке нет TextAlign*),
два «single» в lineRule=auto, B2-отступление cellMar, MS-OI29500 §2.1.155 для
tblInd, команда перевендоринга docx2fo.xslt.
Парсер PMD 7.17 (движок maven-pmd-plugin 3.28.0) не разбирает
switch-выражение в аргументе super (pmd/pmd#6234) — при verify каждый
модуль давал PMD processing error (warning). Сообщения не меняются:
текст 422-контракта и ядра дословно прежние.
- c:autoTitleDeleted=true скрывает заголовок целиком, включая явный c:tx
(§21.2.2.7) — фантомный "Chart Title" из чужих шаблонов больше не рисуется;
- автозаголовок из имени ряда — только у круговой диаграммы с одним рядом,
многорядовая круговая получает плейсхолдер;
- несколько абзацев a:p в заголовке склеиваются через '\n' (жёсткий перенос),
а не внахлёст;
- 4 регрессии в ChartSpecTest (deletedTitleWithText_notShown,
deletedTitleValOmitted_notShown, multiSeriesDoughnut_placeholderNotSeriesName,
multiParagraphTitle_joinedWithNewlines).
Обход контента частей сузён до List<?> (он только читается; мутация идёт в gd.getAny()), хелпер cast удалён, invokeList возвращает List<?> через pattern matching — все три unchecked-подавления в main-коде больше не нужны.
DocxRewritePipeline применяет рерайты Strict→OnOff→Symbol→Field→Invisible→
GlyphCoverage к каждой записи word/*.xml за один проход zip; неизменённые
записи (медиа, rels) переносятся raw-копией сжатых байтов без inflate/deflate.
OleObjectNormalizer — два этапа: дешёвый детект по центральному каталогу
(читаются только [Content_Types].xml и word/*.xml), переупаковка только при
находке. PDF-буфер предразмеряется; нормализованная копия байтов перестаёт
читаться до FOP-рендера. Вывод на 13 фикстурах идентичен (текст + картинки),
531 тест без правок. Индивидуальные normalize() шести нормализаторов
сохранены (контракт юнит-тестов), в цепочке больше не вызываются.
surfaceChart (ECMA-376 §21.2.2.204) — «viewed from above, similar to 2-D
topographic maps»: заливочный режим вместо «торца» рисует топографическую
карту с залитыми полосами высот (fillBands — marching squares по ячейкам,
по одному пути на полосу — нет AA-шва на общих рёбрах), без изолиний и оси
значений; wireframe (§21.2.2.230) — без изменений геометрии. Маркеры
легенды полос следуют заливке: залитые при wireframe=false, полые при
wireframe=true (полосы не залиты нигде). Удалены drawContour/interp/yOf/
drawValueLabels/drawCategoryLabels и тест снятого вида торцом.
Регрессии — Surface2dPainterTest#filledContour_*,
ChartRendererTest#wireframeSurfaceLegend_hollowMarkers, фикстура
samples/chart-types.docx.
Word «Комбинированная» — несколько групп в одном c:plotArea (§21.2.2.145),
каждая со своими c:axId (§21.2.2.9); прежний ChartSpec хранил один type/
valAxis (last-wins) — побеждала последняя группа, столбцы рисовались линиями
по шкале вторичной оси.
- Series.renderAs/grouping/valAxis, AxisSpec.axId, ChartSpec.secondaryValAxis;
привязка групп к осям по c:axId в parse(), valAx/catAx first-wins,
тип combo = первая группа;
- CartesianPainter: семейства BAR/AREA/LINE, порядок отрисовки столбцы→линия,
масштаб каждой серии по своей оси, вторичная ось справа (линия+подписи),
накопление stacked внутри семейства;
- ChartRenderer: valueRange/stackedCumulative по подмножеству рядов,
легенда lineLike по renderAs ряда;
- фикстура chart-types.docx +combo (14 диаграмм), регрессии
ChartSpecTest#combo_*, CartesianPainterTest#combo_barsAndLineOnSecondary_bothDrawn.
- DrawMlText: фолбэк-семейство темы (minorFont без a:latin) алиасится через
BundledFontMapper.bundledFamily — раньше «Calibri» не находился в GlyphFont
и текст молча ехал в более широкий DejaVu Sans, из-за чего подписи
переносились и вылезали за фигуры (123@26pt: 49.6pt против бокса 39.7pt)
- DrawMlText: высота строки из a:lnSpc spcPct/spcPts (§21.1.2.4) — dsp-кэш
запекает, напр., 90%; хелпер totalHeight — высота после переносов
- SmartArtRenderer: autofit только normAutofit (§21.1.2.1.2/.3 — отсутствие
autofit-элемента имплицирует noAutofit); запечённый fontScale применяется,
без него — подбор кегля под перенесённый текст (низ 4pt); эвристика по
высоте одной строки удалена
- SmartArtRenderer: заполнитель dgm:prSet/@phldrT («[Текст]», §21.4.3.4) не
рисуется — элемент UI, в PDF Word его не показывает; render() без CTDataModel,
DrawingPreRenderer не резолвит dgm:relIds/@dm
Регрессии: DrawMlTextTest#fallbackFamilyAliasedToBundle,
#lineSpacingPct_compactsLines; SmartArtRendererTest#normAutofitShrinksToFit,
#missingAutofitKeepsDeclaredSize, #emptyTxBody_noPlaceholderInk.
mvn clean verify: 525 тестов зелёные, PMD + JaCoCo гейты пройдены.
w:object больше не выбрасывается целиком: w:drawing переиспользуется
дословно, v:imagedata r:id заменяется inline-DrawingML на ту же image-часть
(размер из style v:shape, иначе w:dxaOrig/w:dyaOrig); блоки w:control и без
плейсхолдера удаляются. Находка OLE — также разметка w:object без bin-части
(иначе NPE chunkType is null доходит до docx4j). oleObject-rels удаляются по
типу, включая TargetMode=External. Фикстура ole-embedded: битый рукописный
fallback.png (IDAT length 13 при 16 байтах) заменён на валидный — FOP падал
PNGImageDecoder. OLE-бинарники по-прежнему никогда не читаются.
StockPainter рисовал c:upBars/c:downBars только заливкой — белые up-столбцы
невидимы на белом фоне (Word обводит их контуром). Теперь столбец обводится:
цвет/ширина из c:spPr/a:ln (solidFill/@w), явный a:ln/a:noFill — без контура,
дефолт — чёрный 0.75pt. Регрессии: StockPainterTest#upDownBars_whiteFillBlackOutline,
ChartSpecTest#stockUpDownBarLinesParsed.
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).
- cachedPageCount: getElementText() на <Pages> с дочерним элементом бросает
IllegalStateException (не XMLStreamException) — теперь перехватывается,
кэш = 0, нижняя оценка по разрывам (был 400 на валидном .docx)
- Регрессия — WordPdfValidatorTest#cachedPagesUnreadableFallsBackToZero
- BundledFontsTest: @BeforeAll BundledFonts.init() — класс зелёный и при
запуске отдельно (реестр начертаний наполняется init())
Long.parseLong без try на a:srgbClr/@val из враждебной темы (val="zzzz")
бросил NumberFormatException из конструктора DrawMlColor → вся конвертация
500. Теперь null → baseOf/put/resolve штатно держат office-дефолт.
Регрессия — DrawMlColorTest#invalidSrgbHexFallsBackToOfficeDefault
Паттерн заякорен на открывающий тег (group 1 от '<' до w:val=, [^<>] не
пересекает границу тега): литеральный w:val="on" в тексте w:t больше не
переписывается. Регрессия — DocxOnOffNormalizerTest#onOffInTextNotTouched
- атрибуты w:start/w:end правятся только внутри открывающего тега и только при
отсутствии w:left/w:right в нём (transitional CT_Ind допускает обе пары —
глобальная замена давала дубль атрибута, не well-formed XML; литеральный
текст в w:t больше не правится)
- элементы w:start/w🔚 глобально только в strict-частях (URI purl.oclc.org);
в transitional — лишь в w:tcMar/w:tblCellMar без одноимённого left/right
- w:jc val=start/end правится только в strict (JcEnumeration docx4j содержит
START/END, FOP разрешает по направлению — рерайт ломал RTL); w:tab — всегда
(STTabJc 17.3.2 без start/end)
- ChartSpec.readAxis: не-конечные c:min/c:max/c:majorUnit отбрасываются (finite)
- ChartRenderer.axisBounds: санитайз данных + пересчёт шага по фактическому
интервалу — (hi-lo)/unit <= MAX_TICKS+1 при любых входах (вечный цикл делений);
warn вместо безмолвного default в switch типов
- DrawingPreRenderer: кап MAX_EXTENT_EMU на wp:extent (OOM-растр), детект
error-флагов до extent-guard, ловушка OutOfMemoryError в renderChart/renderDiagram,
очистка a:graphicData при раннем return в swapForPicture
- DrawMlText.wrapLines: инкрементальная ширина + экспоненциальный поиск границы
реза (O(L log L) вместо кубической деградации); рез теперь и для первого слова
c:wireframe val="1" (§21.2.2.230) рисовался линейной диаграммой «значение ×
категория» (ломаные рядов + вертикали) — неверная геометрия. Word рисует вид
сверху: X — категории, Y — ряды (серия 0 внизу), без заливок и оси значений;
только изолинии на внутренних границах полос высот lo+k·unit цветом полосы
ниже уровня (marching squares, седло — по среднему ячейки, узлы на уровне —
ребро-сегмент/дедупликация пересечений), сетка узлов catAx/serAx, рамка
области, подписи рядов со стороны serAx (axPos="r" — справа).
Фикстура chart-types.docx: +13-я диаграмма «Поверхность без заливки»
(4 ряда × 5 категорий «холмом», catAx/serAx с c:majorGridlines);
chartTypes_allTypesRenderAsImages — 13 растров. Surface2dPainterTest:
wireframe_gridOnly удалён (пинил снятое поведение), +4 рендер-теста
изолиний + 5 юнитов cellSegments. AGENTS.md синхронизирован.
Word пишет всем рядам шаблона Open-High-Low-Close <a:ln><a:noFill/></a:ln> —
ранее StockPainter рисовал ломаную каждого ряда безусловно, из-за чего между
столбцами upDownBars появлялись зигзаг-полоски. Флаг ChartSpec.Series.lineNoFill
теперь учитывается при отрисовке; dropLines и маркеры — по своим флагам.
Регрессия — StockPainterTest#seriesLineNoFill_notDrawn.