- 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.
ChartSpec читает c:grouping у CTBarChart; CartesianPainter применяет
накопление к BAR/BAR_HORIZONTAL (обе ориентации, barDir=col/bar): один
столбец на категорию, сегмент ряда от cum[si-1] до cum[si], ширина по
c:gapWidth, c:overlap к stacked не применяется. percentStacked поддержан
общими хелперами stackedCumulative/stackedRange.
Регрессии: ChartSpecTest#barGroupingParsed,
CartesianPainterTest#stackedBar_seriesStackCumulatively,
CartesianPainterTest#stackedBarHorizontal_seriesStackCumulatively;
фикстура chart-types.docx дополнена 12-й диаграммой (barDir=bar,
stacked), WordPdfConverterTest#chartTypes_allTypesRenderAsImages — 12 PNG.
- ChartSpec: чтение c:grouping у CTLineChart (line3D осознанно игнорирует)
- CartesianPainter (LINE): кумулятивный диапазон оси и ломаные по stackedCumulative; percentStacked — нормировка к 100
- хелперы isStacked/stackedCumulative/stackedRange переехали из Cartesian3dPainter в ChartRenderer (общие для 2-D и 3-D)
- фикстура chart-types.docx: +10-я диаграмма «График с накоплением»; тест переименован в chartTypes_allTypesRenderAsImages (чинит 14 stale-javadoc-ссылок), assertEquals(10, …)
- юниты ChartSpecTest/ChartRendererTest + пиксельные CartesianPainterTest (инверсия порядка линий stacked vs standard; плоский верх 100% в percentStacked)
Комментарии у поля ChartSpec.firstSliceAng и в PiePainter.paint приписывали
невозможность чтения firstSliceAng для PIE3D отсутствию геттера в JAXB-модели
docx4j 17.3.2. По ECMA-376 элемент §21.2.2.68 определён только для
CT_PieChart/CT_DoughnutChart; CT_Pie3DChart (§21.2.2.140, модель §A.5.1) его
не содержит — JAXB-класс верен стандарту. Поворот 3D-пирога — c:view3D/rotY
(readView3D/paint3d). Поведение не менялось.
docx4j падает на внедрённых OLE-объектах двумя путями: JAXB-парсинг
бинарника под ложным XML-типом в [Content_Types] («Content is not
allowed in prolog» → NPE) и NPE chunkType is null в VML-сериализации
w:object. Новый OleObjectNormalizer (шестой в цепочке, после
GlyphCoverageNormalizer) удаляет OLE-bin-части, rels-ссылки, элементы
w:object и Override удалённых частей; при errorOnOle=true вместо
удаления — DrawingFoundException(OLE) → 422 «Конвертация отменена: в
документе найдены OLE-объекты».
- ядро: Kind.OLE, ConvertOptions.errorOnOle, WordPdfSettings.ERROR_ON_OLE,
фикстура samples/ole-embedded.docx (ручная, оба механизма)
- app: параметр errorOnOle, 422-контракт, тесты errorFlagOle_rejected /
oleObjects_removedByDefault
- SPA: третий переключатель «OLE-объекты»
- прод-автотесты: +2 проверки (21)
- регрессии: OleObjectNormalizerTest ↔ oleObjects_removedAndConverted /
drawingErrors_errorFlagRejectsOle; E2E: notConverted.docx 500 → 200
- pmd-ruleset.xml: ReturnEmptyCollectionRatherThanNull (p1),
AvoidLiteralsInIfCondition (p3), EmptyCatchBlock (p2),
ForLoopCanBeForeach (p2)
- main: split/contentOf/invokeList возвращают List.of() вместо null;
литералы в условиях if вынесены в именованные константы
(9 файлов chart/валидатора); индексный цикл легенды → foreach
- src/test: 8 литералов в условиях if — те же именованные константы
- AGENTS.md: описание ruleset'а и гейта обновлено
mvn clean verify зелёный, 0 нарушений PMD.
На OpenJDK/Linux любое обращение к java.awt.Font требует fontconfig-нативки
(Fontconfig head is null на хосте без libfontconfig). java.awt.Font убран из
всего рантайм-пути: текст chart-движка (DrawMlText) и проверка покрытия глифов
(GlyphCoverageNormalizer) переведены на GlyphFont — чистый Java-парсер TTF
org.apache.pdfbox:fontbox 3.0.8 (compile; commons-logging исключён,
единственный провайдер jcl-over-slf4j). Метрики совпадают с AWT до 4-го знака,
кернинг-дрейф 0.0000 (DejaVu Sans, Carlito). AWT остаётся только как геометрия
(Graphics2D/Path2D), которая fontconfig не требует.
- GlyphFont: of/canDisplay/advance/ascent/descent/leading/draw; TTF читается
напрямую из classpath, не зависит от BundledFonts.init(); битый бандл падает
IllegalStateException, отсутствующее семейство/начертание -> null
- DrawMlText.fontFor: цепочка фолбэка family/variant -> family/regular ->
fallback/variant -> fallback/regular (bold у Noto остаётся своим regular)
- BundledFonts: awtFont/AWT_FONTS удалены (чистый cutover), CLASSPATH_DIR ->
package-private
- ChartRenderer.measureLegend: убран неиспользуемый после cutover параметр g (PMD)
- GlyphFontTest (6 юнитов) без единого java.awt.Font — обязан проходить на хосте
без fontconfig; Containerfile/AGENTS.md: fontconfig рантайму не нужен
Проверено: mvn clean verify локально (153 теста, PMD); приёмочный стенд —
контейнер без libfontconfig.so и /etc/fonts: mvn verify BUILD SUCCESS и
java -jar + конвертация charts-smartart.docx -> PDF 466 КБ с 4 растрами
(деградации нет).
- checkDocxContainer: потоковый проход по zip — декларация wordprocessingml.document
в [Content_Types].xml (голый zip / переименованный .xlsx → 400, а не 500 на docx4j)
+ лимиты MAX_DECOMPRESSED_MB (200) / MAX_ZIP_ENTRIES (8192) — бомба отсекается
до readAllBytes в checkPageCount; пороги константные, не ConvertOptions
- регрессии: validate_plainZipRejected/xlsxRenamedRejected/zipBombRejected/
tooManyEntriesRejected, inputNotDocx_rejectedBeforeRender, plainZipNotDocx_rejected;
junkInsideValidZip_conversionError — на валидном контейнере с мусором (500)
- прод-автест test_plain_zip_not_docx_rejected; AGENTS.md синхронизирован
Ядро: WordPdfSettings.MAX_INPUT_MB=5, ConvertOptions.maxMb,
WordPdfValidator.checkInput(byte[], long maxMb) — единственная точка
пересчёта МБ→байты, сообщение «Файл больше N МБ: X байт > Y байт».
Приложение: свойство wordpdf.max-mb (env WORDPDF_MAX_MB, relaxed binding).
CI/конфиг/автотесты/доки: WORDPDF_MAX_BYTES → WORDPDF_MAX_MB (значение 5).
Литерал слева в equals/equalsIgnoreCase (NPE-safe), удаление неиспользуемых
параметров/локальных/импортов/полей, логгеры log→LOG (конвенция UPPER_SNAKE),
UselessParentheses/UnnecessaryCast/UseShortArrayInitializer, record без явного
static, пустой конструктор ChartSpec удалён. Семантика не меняется.