diff --git a/AGENTS.md b/AGENTS.md index d31e8ab..c2a0907 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -30,7 +30,7 @@ Нормативный источник любых правок/решений по диаграммам и SmartArt — ECMA-376 (`docs/standards/`: графики §21.2, diagram-разметка §21.4, пресет-геометрия Annex D + полные наборы XSD `schema/strict/`/`schema/transitional/`; соответствие фикстур схемам проверяет `docs/standards/validate-fixtures.py` — см. README; поведение Word — `ms-oi29500.md`, `ms-odrawxml.md`), а не догадки по исходникам LibreOffice/Word-эмпирике; эмпирические калибровки (камера, `PIE_DEPTH`) менять только вместе с пиксельными тестами. Формулировки из стандарта при ссылке — с номером секции (§21.2.2.132 и т.п.). Фикстуры могут быть невалидны — код под фикстуру не правится, правится фикстура (после проверки по XSD/секции). -Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`, `PADDING = 4.0`, растр × `DPI/72`, размеры — в пунктах, EMU→pt `cx/12700.0`). `ChartSpec.parse` (`enum Type`: PIE/PIE3D/DOUGHNUT/BAR/BAR_HORIZONTAL/LINE/AREA/SURFACE3D/SCATTER/BUBBLE/RADAR/STOCK/OF_PIE/SURFACE/BAR3D/AREA3D/LINE3D/UNSUPPORTED; пустой `c:title` + `autoTitleDeleted="0"` → у **круговых** имя первого ряда, у прочих — `AUTO_TITLE = "Название диаграммы"` (русская замена англ. плейсхолдеру Word); палитра `accent1..6` темы, легенда по умолчанию снизу (у SURFACE — полосы высот «0-1»…), позиция `t` поддержана, `overlay` (§21.2.2.132) → рисуется поверх области построения, место не резервирует (`ChartSpec.legendOverlay`, регрессия `ChartRendererTest#overlayLegend_drawnOverPlot`)) → `ChartRenderer` (осевые «круглые» шаги `niceUnit` 1/2/5·10ⁿ как Word; санитайзер `c:majorUnit` — `MAX_TICKS = 1000`: шаг ≤ 0/NaN/слишком мелкий в `axisBounds` заменяется niceUnit, иначе циклы делений вечные; `axisBounds` также перебирает шаг при неконечном диапазоне и отбрасывает нечитаемый `majorUnit` при ±∞-осях scaling; общие кумулятивные хелперы stacked `isStacked`/`stackedCumulative`/`stackedRange`) → пейнтеры `CartesianPainter` (2-D line/bar/area; lineChart `c:grouping` stacked/percentStacked §21.2.2.76 — ряд рисуется на накопленной сумме через `ChartRenderer.stackedCumulative`, регрессии `stackedLine_seriesStackCumulatively`/`percentStackedLine_topSeriesFlatAtHundred`)/`PiePainter` (`PIE_DEPTH=0.22`, `PIE_FIT=0.865`)/`Surface3dPainter` (калибровка по эталону Word 300 dpi, камера — регрессия `cameraMatchesWordReference`: `DEPTH_RATIO=0.705`, `HEIGHT_RATIO=0.664`, `GUTTER_LEFT/RIGHT=0.1485`, `GUTTER_TOP=0.116`, `GUTTER_BOTTOM=0.146`, свет `LIGHT_X/Y/Z=0.83/0.48/0.28`, `c:rAngAx=true` во всех 3D-пейнтерах имеет приоритет над `c:perspective` (MS-OI29500 §2.1.1516(b)), `c:hPercent` сжимает глубину, `c:wireframe` §21.2.2.205 — только каркас без полос высот, bandFmt-полосы сортируются по глубине)/`ScatterPainter` (scatter/bubble: обе оси числовые, две `c:valAx`, X — первая; маркеры по `c:marker`, `c:scatterStyle` §21.2.2.136; радиус пузыря sqrt при `c:sizeRepresents="area"` §21.2.2.128 и линейно при «w», масштаб `c:bubbleScale`)/`RadarPainter` (спицы от 12 часов по часовой, `c:radarStyle` §21.2.2.119 standard/marker/filled, сетка — концентрические многоугольники)/`StockPainter` (high-low-close: `c:hiLowLines`/`c:upDownBars`/`c:dropLines`; цвета — дефолты UI Word, эмпирика запинена тестом; upDownBars обводятся контуром — `c:spPr/a:ln` solidFill/noFill/@w, дефолт чёрный 0.75pt: белая up-заливка невидима на белом фоне, регрессия `StockPainterTest#upDownBars_whiteFillBlackOutline`)/`OfPiePainter` (главный пирог, замкнутый «Other»-сектором — MS-OI29500 §2.1.1507(a), обращён центром к 3 часам ко вторичной, цвет — следующая ротация палитры; пара пирогов центрирована, зазор `GAP_FIT=0.25·d1` — Word-эмпирика; вторичный пирог/стек, разбиение по `c:splitType` §21.2.2.155 (splitPos — MS-OI29500 §2.1.1554a/b), вторичный пирог стартует от конца «Other»-сектора; `c:serLines` — ровно две связи от границ «Other»-сектора к ободу вторичного на 270°±wedgeSweep / левым углам столбца — MS-OI29500 §2.1.1545(a))/`Surface2dPainter` (контурная карта §21.2.2.204: полосы высот между ломаными соседних рядов §21.2.2.13, передняя стенка — полоса значения переднего края; `c:wireframe` §21.2.2.230 — вид сверху (X=категории, Y=ряды, серия 0 внизу) без заливок: изолинии на границах полос высот `lo+k·unit` цветом нижней полосы (c:bandFmts §21.2.2.13/.14, без них — палитра), marching squares, седло — по среднему ячейки; сетка catAx/serAx, рамка plot; ось значений не рисуется)/`Cartesian3dPainter` (bar3D/line3D/area3D §21.2.2.19/.101/.122 — камера `Surface3dPainter.project`, ряды уходят в глубину; bar3D: `c:shape` box/cone/cylinder/pyramid + `*ToMax` §21.2.3.44 (per-series `c:shape` переопределяет диаграммный, горизонтальная ориентация — всегда box), `c:grouping` stacked/percentStacked §21.2.2.76 (одна полоса глубины на категорию, сегменты столбиком, percent — нормировка к 100%; area3D stacked — полосы на стене v=0, line3D grouping игнорирует), `c:gapDepth` — MS-OI29500 §2.1.1474, подписи serAx рисуются, `c:delete` осей учитывается); `SmartArtRenderer` рисует кэш разложенной схемы (relationship `…/office/2007/relationships/diagramDrawing`, фактически `word/diagrams/drawing1.xml`), формы строит `PresetGeometry` — ECMA-пресет-геометрия `a:prstGeom`: avLst/gdLst/pathLst семи пресетов (rect, roundRect, ellipse, gear6, gear9, circularArrow, leftCircularArrow) дословно из `presetShapeDefinitions.xml`, вычислитель префиксных формул; оператор `?:` = «if x > 0 then y else z» (ISO/IEC 29500-1, НЕ x != 0), углы в Arc2D передавать со знаком минус (математическая конвенция y вверх), неизвестный пресет → прямоугольник ячейки (синхрон таблицы со стандартом пинит `PresetGeometryTest#tableMatchesEcmaXml`); палитра темы — `DrawMlColor` (instance; без ThemePart — дефолтная Office-палитра `accent1=4472C4`…, битый `a:srgbClr/@val` — дефолт вместо падения); текст — `DrawMlText` (шрифты — тот же бандл через `BundledFontMapper.bundledFamily`; `fitCut` гарантирует прогресс реза на 1 символе — иначе `wrapLines` вечный цикл); утилиты `RgbHsl`. Калибровочные константы менять только вместе с `Surface3dPainterTest`/`PiePainterTest`. Защитные лимиты против враждебного chart-XML: `ChartSpec.MAX_POINTS` (`c:pt/@idx` §21.2.2.150/.151 и `c:ptCount` §21.2.2.152 — ST_UnsignedInt без верхней границы, отказ `IllegalArgumentException` до предвыделения списка), `MAX_TICKS` (см. выше) и `ChartSpec.MAX_EXTENT_EMU` (`a:ext`/`a:chExt` §21.2.2.62 — ST_PositiveSizeType без верхней границы, extent > 2^31 EMU заменяется размером якоря, иначе `BufferedImage` OOM); бросок перехватывает catch `DrawingPreRenderer.renderChart` → штатная деградация «объект удалён + warn» (`DrawingPreRenderer` log; подмена `graphic` на `pic:pic` — структурный обход `swapForPicture`, не toString-замена). Обход `pkg.getParts()` — только по **снимку** списка (`createImagePart` мутирует реестр → CME); rels частей — `part.getRelationshipsPart()`, НЕ `getOwningRelationshipPart()` (это rels ссылающегося); обход XML обязан раскрывать `JAXBElement`. +Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`, `PADDING = 4.0`, растр × `DPI/72`, размеры — в пунктах, EMU→pt `cx/12700.0`). `ChartSpec.parse` (`enum Type`: PIE/PIE3D/DOUGHNUT/BAR/BAR_HORIZONTAL/LINE/AREA/SURFACE3D/SCATTER/BUBBLE/RADAR/STOCK/OF_PIE/SURFACE/BAR3D/AREA3D/LINE3D/UNSUPPORTED; пустой `c:title` + `autoTitleDeleted="0"` → у **круговых** имя первого ряда, у прочих — `AUTO_TITLE = "Название диаграммы"` (русская замена англ. плейсхолдеру Word); палитра `accent1..6` темы, легенда по умолчанию снизу (у SURFACE — полосы высот «0-1»…), позиция `t` поддержана, `overlay` (§21.2.2.132) → рисуется поверх области построения, место не резервирует (`ChartSpec.legendOverlay`, регрессия `ChartRendererTest#overlayLegend_drawnOverPlot`)) → `ChartRenderer` (осевые «круглые» шаги `niceUnit` 1/2/5·10ⁿ как Word; санитайзер `c:majorUnit` — `MAX_TICKS = 1000`: шаг ≤ 0/NaN/слишком мелкий в `axisBounds` заменяется niceUnit, иначе циклы делений вечные; `axisBounds` также перебирает шаг при неконечном диапазоне и отбрасывает нечитаемый `majorUnit` при ±∞-осях scaling; общие кумулятивные хелперы stacked `isStacked`/`stackedCumulative`/`stackedRange`) → пейнтеры `CartesianPainter` (2-D line/bar/area; lineChart `c:grouping` stacked/percentStacked §21.2.2.76 — ряд рисуется на накопленной сумме через `ChartRenderer.stackedCumulative`, регрессии `stackedLine_seriesStackCumulatively`/`percentStackedLine_topSeriesFlatAtHundred`)/`PiePainter` (`PIE_DEPTH=0.22`, `PIE_FIT=0.865`)/`Surface3dPainter` (калибровка по эталону Word 300 dpi, камера — регрессия `cameraMatchesWordReference`: `DEPTH_RATIO=0.705`, `HEIGHT_RATIO=0.664`, `GUTTER_LEFT/RIGHT=0.1485`, `GUTTER_TOP=0.116`, `GUTTER_BOTTOM=0.146`, свет `LIGHT_X/Y/Z=0.83/0.48/0.28`, `c:rAngAx=true` во всех 3D-пейнтерах имеет приоритет над `c:perspective` (MS-OI29500 §2.1.1516(b)), `c:hPercent` сжимает глубину, `c:wireframe` §21.2.2.205 — только каркас без полос высот, bandFmt-полосы сортируются по глубине)/`ScatterPainter` (scatter/bubble: обе оси числовые, две `c:valAx`, X — первая; маркеры по `c:marker`, `c:scatterStyle` §21.2.2.136; радиус пузыря sqrt при `c:sizeRepresents="area"` §21.2.2.128 и линейно при «w», масштаб `c:bubbleScale`)/`RadarPainter` (спицы от 12 часов по часовой, `c:radarStyle` §21.2.2.119 standard/marker/filled, сетка — концентрические многоугольники)/`StockPainter` (high-low-close: `c:hiLowLines`/`c:upDownBars`/`c:dropLines`; цвета — дефолты UI Word, эмпирика запинена тестом; upDownBars обводятся контуром — `c:spPr/a:ln` solidFill/noFill/@w, дефолт чёрный 0.75pt: белая up-заливка невидима на белом фоне, регрессия `StockPainterTest#upDownBars_whiteFillBlackOutline`)/`OfPiePainter` (главный пирог, замкнутый «Other»-сектором — MS-OI29500 §2.1.1507(a), обращён центром к 3 часам ко вторичной, цвет — следующая ротация палитры; пара пирогов центрирована, зазор `GAP_FIT=0.25·d1` — Word-эмпирика; вторичный пирог/стек, разбиение по `c:splitType` §21.2.2.155 (splitPos — MS-OI29500 §2.1.1554a/b), вторичный пирог стартует от конца «Other»-сектора; `c:serLines` — ровно две связи от границ «Other»-сектора к ободу вторичного на 270°±wedgeSweep / левым углам столбца — MS-OI29500 §2.1.1545(a))/`Surface2dPainter` (контурная карта §21.2.2.204: полосы высот между ломаными соседних рядов §21.2.2.13, передняя стенка — полоса значения переднего края; `c:wireframe` §21.2.2.230 — вид сверху (X=категории, Y=ряды, серия 0 внизу) без заливок: изолинии на границах полос высот `lo+k·unit` цветом нижней полосы (c:bandFmts §21.2.2.13/.14, без них — палитра), marching squares, седло — по среднему ячейки; сетка catAx/serAx, рамка plot; ось значений не рисуется)/`Cartesian3dPainter` (bar3D/line3D/area3D §21.2.2.19/.101/.122 — камера `Surface3dPainter.project`, ряды уходят в глубину; bar3D: `c:shape` box/cone/cylinder/pyramid + `*ToMax` §21.2.3.44 (per-series `c:shape` переопределяет диаграммный, горизонтальная ориентация — всегда box), `c:grouping` stacked/percentStacked §21.2.2.76 (одна полоса глубины на категорию, сегменты столбиком, percent — нормировка к 100%; area3D stacked — полосы на стене v=0, line3D grouping игнорирует), `c:gapDepth` — MS-OI29500 §2.1.1474, подписи serAx рисуются, `c:delete` осей учитывается); `SmartArtRenderer` рисует кэш разложенной схемы (relationship `…/office/2007/relationships/diagramDrawing`, фактически `word/diagrams/drawing1.xml`), формы строит `PresetGeometry` — ECMA-пресет-геометрия `a:prstGeom`: avLst/gdLst/pathLst семи пресетов (rect, roundRect, ellipse, gear6, gear9, circularArrow, leftCircularArrow) дословно из `presetShapeDefinitions.xml`, вычислитель префиксных формул; оператор `?:` = «if x > 0 then y else z» (ISO/IEC 29500-1, НЕ x != 0), углы в Arc2D передавать со знаком минус (математическая конвенция y вверх), неизвестный пресет → прямоугольник ячейки (синхрон таблицы со стандартом пинит `PresetGeometryTest#tableMatchesEcmaXml`); палитра темы — `DrawMlColor` (instance; без ThemePart — дефолтная Office-палитра `accent1=4472C4`…, битый `a:srgbClr/@val` — дефолт вместо падения); текст — `DrawMlText` (шрифты — тот же бандл через `BundledFontMapper.bundledFamily`, **фолбэк-семейство темы тоже алиасится** — иначе «Calibri» не находится в `GlyphFont` и текст молча уезжает в более широкий DejaVu, из-за чего переносы вылезали за фигуру, регрессия `DrawMlTextTest#fallbackFamilyAliasedToBundle`; `fitCut` гарантирует прогресс реза на 1 символе — иначе `wrapLines` вечный цикл; высота строки — из `a:lnSpc` spcPct/spcPts §21.1.2.4, регрессия `DrawMlTextTest#lineSpacingPct_compactsLines`); autofit фигур — только `normAutofit` (§21.1.2.1.2/.3: отсутствие autofit-элемента имплицирует noAutofit — заявленный кегль не ужимается, переполнение уходит за фигуру, как Word; запечённый Word-ом `fontScale` применяется, без него — подбор кегля под высоту надетого текста `DrawMlText.totalHeight` с низом `MIN_FONT_PT=4pt`; регрессии `SmartArtRendererTest#normAutofitShrinksToFit`/`#missingAutofitKeepsDeclaredSize`); заполнитель `dgm:prSet/@phldrT` («[Текст]», §21.4.3.4) не рисуется — элемент UI, в PDF Word его не показывает (`SmartArtRendererTest#emptyTxBody_noPlaceholderInk`, `render` без `CTDataModel`); утилиты `RgbHsl`. Калибровочные константы менять только вместе с `Surface3dPainterTest`/`PiePainterTest`. Защитные лимиты против враждебного chart-XML: `ChartSpec.MAX_POINTS` (`c:pt/@idx` §21.2.2.150/.151 и `c:ptCount` §21.2.2.152 — ST_UnsignedInt без верхней границы, отказ `IllegalArgumentException` до предвыделения списка), `MAX_TICKS` (см. выше) и `ChartSpec.MAX_EXTENT_EMU` (`a:ext`/`a:chExt` §21.2.2.62 — ST_PositiveSizeType без верхней границы, extent > 2^31 EMU заменяется размером якоря, иначе `BufferedImage` OOM); бросок перехватывает catch `DrawingPreRenderer.renderChart` → штатная деградация «объект удалён + warn» (`DrawingPreRenderer` log; подмена `graphic` на `pic:pic` — структурный обход `swapForPicture`, не toString-замена). Обход `pkg.getParts()` — только по **снимку** списка (`createImagePart` мутирует реестр → CME); rels частей — `part.getRelationshipsPart()`, НЕ `getOwningRelationshipPart()` (это rels ссылающегося); обход XML обязан раскрывать `JAXBElement`. ### Критические инварианты (нарушение = битый вывод) @@ -158,7 +158,7 @@ gateway). Кеш раннеров — сервер act_runner (серверна - Гейт `maven-pmd-plugin` 3.28.0 на `verify` для обоих модулей, ruleset `pmd-ruleset.xml` (codestyle без opinionated-правил + unused-правила + XPath `LiteralFirstInEquals` — строковый литерал слева в `equals`/`equalsIgnoreCase`; `junit5TestPattern` разрешает underscore-имена регрессий; `includeTests=true` — тесты сканируются; `failurePriority` не задан — на практике `verify` валят нарушения любой приоритетности, проверено на priority 3–4: строки `[WARNING] PMD Failure` = BUILD FAILURE). Версия PMD-движка в pom не пинится (тянется плагином). - Гейт JaCoCo `0.8.15`: `jacoco:check` (правило BUNDLE, LINE COVEREDRATIO `0.90` — обоих модулей; в `wordpdf-core/pom.xml` execution `check` переопределён и добавляет BRANCH COVEREDRATIO `0.85` — только для core, у app бранчи ниже порога) на `verify`; агент подключается в surefire через `argLine` = `@{argLine} -Djava.awt.headless=true` (свойство `argLine` в корневом pom по умолчанию пусто и перезаписывается `prepare-agent` — `mvn test -Djacoco.skip=true` без агента работоспособно); `report` и `check` оба на `verify`, report раньше — при провале порога отчёт уже на диске; отчёты `target/site/jacoco/` (html+xml, xml нужен CI-сводке). Плотность покрытия держат тесты, а не заглушки: промахи в основном недостижимые IOException/catch-ветки (`GlyphFont`, `BundledFonts`) и защитные ветви сканеров нормализаторов/валидатора, разобранные в комментариях к тестам. -- 35 тестовых класса / 520 `@Test` (core 29/478, app 6/42: ConvertController 22 + ApiKeyFilter 8 + ConversionService 5 + ApiExceptionHandler 4 + ConvertLimits 2 + ConversionTimeout 1). JUnit 6 (`org.junit.jupiter:junit-jupiter`), surefire 3.6.0 с `-Djava.awt.headless=true` в argLine; только `Assertions` (Mockito/AssertJ не использовать, несмотря на test-classpath Boot; в app-тестах допустим inline-Hamcrest `org.hamcrest.Matchers.containsString` в `andExpect`), тестовые классы package-private, зеркалят main-пакеты; только `@Test` (+ два `@BeforeAll` — warm-up шрифтов в `GlyphCoverageNormalizerTest` и `BundledFonts.init()` в `BundledFontsTest`). +- 35 тестовых класса / 525 `@Test` (core 29/483, app 6/42: ConvertController 22 + ApiKeyFilter 8 + ConversionService 5 + ApiExceptionHandler 4 + ConvertLimits 2 + ConversionTimeout 1). JUnit 6 (`org.junit.jupiter:junit-jupiter`), surefire 3.6.0 с `-Djava.awt.headless=true` в argLine; только `Assertions` (Mockito/AssertJ не использовать, несмотря на test-classpath Boot; в app-тестах допустим inline-Hamcrest `org.hamcrest.Matchers.containsString` в `andExpect`), тестовые классы package-private, зеркалят main-пакеты; только `@Test` (+ два `@BeforeAll` — warm-up шрифтов в `GlyphCoverageNormalizerTest` и `BundledFonts.init()` в `BundledFontsTest`). - **PDF сравнивается текстом, не растеризацией**: PDFBox 3 (`Loader.loadPDF`) — `PDFTextStripper` для текста (пер-странично `setStartPage/setEndPage`), override `processTextPosition` для шрифта конкретного символа (`fontNameOf`), обход ресурсов страниц для встроенных шрифтов (`EAAAAA+Carlito-Bold`) и счётчик картинок (`imageCount`). Негативные маркеры — регрессии: `assertFalse(text.contains("#"))` (.notdef), `assertFalse(font.startsWith("Helvetica"))`. Текст нормализуется по пробелам (`norm`); в `tableImage_tableAndImage` — полное удаление пробелов (docx4j переносит слова в auto-fit таблицах). - Пиксели (BufferedImage) — только в unit-тестах chart-пейнтеров: безразмерные отношения к эталону Word (экспорт 300 dpi, числа зашиты в тесты), допуски `assertRatio` <0.06 (`PiePainterTest`, `CartesianPainterTest`) / <0.10 (`Surface3dPainterTest`, + `assertRange` ±6 pt для центров силуэта); пороги залитых px, перцентильные коридоры яркости, «серый» px — разброс каналов `GRAY_MAX_SPREAD=25`; исключение — структурная проверка чернил в `GlyphFontTest` (без сравнения с эталоном). Эталонные файлы — `develop/`, вне git. - `GlyphFont` (fontbox): метрики пиксельно-метрически эквивалентны AWT (ascent/descent/leading/advance совпадают до 4-го знака, кернинг-дрейф 0.0000 — DejaVu Sans, Carlito). Приёмочный стенд без-fontconfig: контейнер без `libfontconfig.so.1*` и `/etc/fonts`, `mvn verify` + `java -jar` (до перехода на GlyphFont там падали `GlyphCoverageNormalizerTest` 12 / `CartesianPainterTest` 3 / `PiePainterTest` 2 / chart-тесты `WordPdfConverterTest` 4, chart-рендер молча деградировал). `GlyphFontTest` написан без единого `java.awt.Font` — обязан проходить на хосте без fontconfig. @@ -166,4 +166,5 @@ gateway). Кеш раннеров — сервер act_runner (серверна - Юниты нормализаторов работают строками (`rewrite`) + zip'ами из `ZipOutputStream`; обязательные контракты: «нечего менять → тот же массив» (`assertSame` покрыт тестами у zip-нормализаторов `DocxOnOff`/`SymbolFont`/`StrictOoxml`/`InvisibleChar` и многочастного `OleObject`; у `Field`/`GlyphCoverage` — `rewrite`→`null`) и неприкосновенность частей вне `word/*.xml` (`[Content_Types].xml`). Тесты бьют и в package-private API (`GlyphCoverageNormalizer.split(text, family)`, `ChartSpec.readTitle`). Исключение — `OleObjectNormalizerTest`: многочастный нормализатор без `rewrite`-хука, тесты только через `normalize` на in-memory zip. - App-тесты: `@SpringBootTest` + `@AutoConfigureMockMvc` (Boot 4: `org.springframework.boot.webmvc.test.autoconfigure`); три контекста — `ConvertControllerTest` (пустой ключ), `ApiKeyFilterTest` (`properties = "wordpdf.api-key=…"`), `ConvertLimitsTest`/`ConversionTimeoutTest` (`@TestPropertySource` — отдельные классы, не `@Nested`). - Регрессивные пары (фикс = нормализатор/pre-renderer + юнит + конвертер-тест с фикстурой): `StrictOoxmlNormalizerTest`↔`strictOoxml_convertsNotRejected` (+`pageCount_strictBreaksCountedLightweight` — lightweight против strict; `indCoexistForms_convertsNotRejected` + юниты `indCoexistLeftStartUntouched`/`indStartOnlyRenamedTransitional`/`tcMarCoexistKept`/`tcMarStartOnlyRenamedTransitional`/`tcBordersElementsKeptTransitional`/`jcStartKeptTransitional`/`tabStartRenamedTransitional`/`transitionalCoexistReturnsOriginalArray` — guard сосуществования форм + strict-gating), `DocxOnOffNormalizerTest`↔`ruPlain_regularRunsUseRegularFont` (+`onOffInTextNotTouched` — `w:val` правится только внутри тега), `SymbolFontNormalizerTest`↔`symbolFonts_bulletsAreNotHash`, `FieldNormalizerTest`↔`pageNumbers_recomputedNotCached`, `InvisibleCharNormalizerTest`↔`invisibleChars_noEmptyLines`, `GlyphCoverageNormalizerTest`↔`exoticGlyphs_drawnNotHash`, `OleObjectNormalizerTest`↔`oleObjects_removedAndConverted`/`drawingErrors_errorFlagRejectsOle` (+app `errorFlagOle_rejected`/`oleObjects_removedByDefault`; сохранение плейсхолдера — юниты `objectWithImagedata_placeholderKept`/`objectWithoutImage_removed`/`objectWithDrawing_reusedVerbatim`/`controlBlockRemoved`/`sizeFromDxaOrig`/`styleUnits_allConvertToEmu`/`objectWithoutBin_stillRewritten`/`externalOleLinkRelRemoved`/`errorFlagObjectWithoutBin_rejects`, в `oleObjects_removedAndConverted` — `distinctImageCount==1`, RGBA FOP режет на картинку+SMask), `WordPdfValidatorTest`↔`staleCachePageCountRejectedBeforeRender` (+`checkPageCount_limitBoundary` 99/100/101, `cachedPagesUnreadableFallsBackToZero` — нечитаемый `` → 0, `pageCount_breaksInsideTablesAreCounted`, `pageCount_continuousSectionsNotCountedLightweight`, `validate_notAZip`↔`inputNotAZip_rejectedBeforeRender`, `validate_plainZipRejected`/`validate_xlsxRenamedRejected`/`validate_zipBombRejected`/`validate_tooManyEntriesRejected`↔`plainZipNotDocx_rejected`/`inputNotDocx_rejectedBeforeRender` — контейнер и zip-бомба), `BundledFontsTest`↔`ruPlain_emDashEmbeddedNotHelvetica`, `ChartSpecTest`↔автозаголовки, `PresetGeometryTest`↔`chartsSmartArt_drawingsBecomeImages` (`tableMatchesEcmaXml` — синхрон таблицы пресетов с ECMA XML; кольцевые стрелки — семантика `?:` и знаки дуг Arc2D), chart-пейнтеры↔`chartsSmartArt_drawingsBecomeImages` (+`drawingErrors_*`↔app `errorFlagCharts_rejected`/`errorFlagSmartArt_rejected`), новые пейнтеры `ScatterPainterTest`/`RadarPainterTest`/`StockPainterTest`/`OfPiePainterTest`/`Surface2dPainterTest`/`Cartesian3dPainterTest`↔`chartTypes_allTypesRenderAsImages` (фикстура `chart-types`; ось X scatter/bubble и OF_PIE-заголовок — `ChartSpecTest`), lineChart stacked — `ChartSpecTest#lineGroupingParsed` + `ChartRendererTest#stackedCumulative_*`/`stackedRange_coversNegativeSums` + `CartesianPainterTest#stackedLine_seriesStackCumulatively`/`percentStackedLine_topSeriesFlatAtHundred`↔`chartTypes_allTypesRenderAsImages`; `noLoggingWarningInPdf` — регрессия `slf4j-simple`, `pdfTitle_comesFromParameter` — регрессия PDF-title (юнит-партнёра нет). App-регрессии: `requestLimitParams_areIgnored`, `nonPositiveLimits_failStartup`, `unknownPath_notFound`, `concurrentRequests_bothSucceed` (гонка реестра `PhysicalFonts`), `corruptNotAZip_rejected`, `plainZipNotDocx_rejected` (голый zip без манифеста → 400), `junkInsideValidZip_conversionError` (500 на валидном .docx-контейнере с мусором), `nonDocxFilename_rejected`, `oversizedOverCoreLimit_rejected`, `drawingsAlwaysRendered`, `cyrillicAndPathInFilename_sanitizedResponseName` (RFC 5987 + path-traversal), `docsOpenWithoutKey`/`forwardedPrefix_healthStaysOpen`/`forwardedPrefix_docsOpenWithoutKey` (открытая документация + матч фильтра без forwarded-contextPath), `dotSegmentOpenPrefix_rejected` (точечные сегменты `..`/`%2e` — не открытый путь), `errorFlagNotBoolean_rejected` (битый error-флаг → 400), `methodNotSupportedReturns405`/`badContentTypeReturns415` (405/415 вместо catch-all 500); DoS/корректность core: `ChartSpecTest#hugePointIndex_rejectedNotOom`/`hugePtCount_rejectedNotOom`/`hugeCategoryIndex_rejectedNotOom` (`MAX_POINTS`), `Surface3dPainterTest#axisBounds_tinyMajorUnit_fallsBackToNiceUnit`/`axisBounds_zeroMajorUnit_fallsBackToNiceUnit` (`MAX_TICKS`), `ChartRendererTest#axisBounds_explicitHugeRange_reunitsToMaxTicks`/`axisBounds_infiniteSpan_fallsBackToData` (шаг при враждебном/неконечном диапазоне), `ChartSpecTest#nonFiniteScalingBounds_dropped` (±∞ scaling), `WordPdfConverterTest#hostileChartAxis_convertsNotHangs`/`hugeExtentChart_removedNotOom`/`chartWithoutExtent_errorFlagRejects` (`MAX_EXTENT_EMU`), `DrawMlTextTest#hugeWord_wrapsLinearly` (fitCut — прогресс реза), `DrawMlColorTest#invalidSrgbHexFallsBackToOfficeDefault` (битый hex темы — деградация), `GlyphCoverageNormalizerTest#multipleTextNodes_runLeftUntouched` (guard составного рана)/`nestedRunInTextBox_innerSplit` + `SymbolFontNormalizerTest#nestedRunInTextBox_innerNormalized` (вложенные раны текстбоксов), `CartesianPainterTest#areaFill_closesToBaseline` (AREA к базовой линии), `ChartRendererTest#overlayLegend_drawnOverPlot` + `ChartSpecTest#overlayLegend_keepsPositionAndFlag` (overlay-легенда). +- SmartArt-текст: `SmartArtRendererTest#normAutofitShrinksToFit`/`#missingAutofitKeepsDeclaredSize`/`#emptyTxBody_noPlaceholderInk` + `DrawMlTextTest#fallbackFamilyAliasedToBundle`/`#lineSpacingPct_compactsLines` ↔ `chartsSmartArt_drawingsBecomeImages` (autofit только `normAutofit` §21.1.2.1.2/.3 с подбором кегля под перенесённый текст, высота строки из `a:lnSpc`, фолбэк-семейство темы алиасится в бандл, `phldrT` не рисуется). - UI-тестов нет; гейт SPA — `npm run build` (tsc -b) + `npm run lint` (oxlint, `.oxlintrc.json`: rules-of-hooks error, only-export-components warn). Прод-автотесты (pytest 9.1.1 + requests 2.34.2, 21 проверка — 17 под маркером `needs_key` (SKIP без ключа), 4 открытых: health/SPA-root/swagger/spec; env-конфиг, `mise exec -- python -m pytest -q .` из `prod-autotests/`) гоняются CI после deploy против живого прода. diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawMlText.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawMlText.java index fe3f88a..3ab22f7 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawMlText.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawMlText.java @@ -5,6 +5,7 @@ import org.docx4j.dml.CTTextBody; import org.docx4j.dml.CTTextCharacterProperties; import org.docx4j.dml.CTTextParagraph; import org.docx4j.dml.CTTextParagraphProperties; +import org.docx4j.dml.CTTextSpacing; import org.docx4j.dml.TextFont; import ru.pjandro.wordpdf.fonts.BundledFontMapper; import ru.pjandro.wordpdf.fonts.BundledFonts; @@ -40,8 +41,18 @@ final class DrawMlText { } } - /** Один абзац: текст + начертание + выравнивание. */ - record Paragraph(String text, Style style, String align) { + /** + * Один абзац: текст + начертание + выравнивание + межстрочный интервал + * из {@code a:lnSpc} (ECMA-376 §21.1.2.4): {@code spacingPct} — доля + * одинарного (a:spcPct/100000), {@code spacingPts} — фиксированная + * высота строки в pt (a:spcPts/100); оба null — одинарный. + */ + record Paragraph(String text, Style style, String align, + Double spacingPct, Double spacingPts) { + + Paragraph(String text, Style style, String align) { + this(text, style, align, null, null); + } } /** Значения выравнивания DrawingML (a:pPr/@algn, a:bodyPr/@anchor). */ @@ -59,12 +70,19 @@ final class DrawMlText { * * @param txPr тело текста (может быть null) * @param colors палитра темы (для schemeClr в solidFill) - * @param fallbackFam семейство, если latin не указан/неизвестен + * @param fallbackFam семейство, если latin не указан/неизвестен; + * алиасится в бандл-семейство, как и явный latin + * (иначе «Calibri» из темы не находится в реестре + * {@link GlyphFont} и текст молча уезжает в DejaVu — + * шире, чем Calibri/Carlito у Word). + * Регрессия — DrawMlTextTest#fallbackFamilyAliasedToBundle. * @param fallbackSize размер в pt, если sz нет */ static Style defaultStyle(CTTextBody txPr, DrawMlColor colors, String fallbackFam, double fallbackSize, Color fallbackColor) { - Style base = new Style(fallbackSize, false, false, fallbackColor, fallbackFam); + Style base = new Style(fallbackSize, false, false, fallbackColor, + fallbackFam == null ? BundledFonts.FALLBACK_FAMILY + : BundledFontMapper.bundledFamily(fallbackFam)); if (txPr == null || txPr.getP().isEmpty()) { return base; } @@ -103,9 +121,18 @@ final class DrawMlText { } String align = p.getPPr() != null && p.getPPr().getAlgn() != null ? p.getPPr().getAlgn().value() : null; + Double spacingPct = null; + Double spacingPts = null; + CTTextSpacing lnSpc = p.getPPr() == null ? null : p.getPPr().getLnSpc(); + if (lnSpc != null && lnSpc.getSpcPct() != null && lnSpc.getSpcPct().getVal() > 0) { + spacingPct = lnSpc.getSpcPct().getVal() / 100000.0; + } else if (lnSpc != null && lnSpc.getSpcPts() != null + && lnSpc.getSpcPts().getVal() > 0) { + spacingPts = lnSpc.getSpcPts().getVal() / 100.0; + } String text = sb.toString(); if (!text.isBlank()) { - out.add(new Paragraph(text, runStyle, align)); + out.add(new Paragraph(text, runStyle, align, spacingPct, spacingPts)); } } return out; @@ -175,7 +202,9 @@ final class DrawMlText { /** * Рисует абзацы внутри прямоугольника: выравнивание по горизонтали * (align абзаца или {@code defAlign}) и по вертикали ({@code vAlign}: - * t/ctr/b). + * t/ctr/b). Высота строки — из {@code a:lnSpc} абзаца + * ({@link #lineFor}), поверх — множитель {@code lineHeightFactor} + * (lnSpcReduction из normAutofit). */ static void paint(Graphics2D g, List paragraphs, Rectangle2D box, String defAlign, String vAlign, double lineHeightFactor) { @@ -190,7 +219,7 @@ final class DrawMlText { for (Paragraph p : paragraphs) { GlyphFont f = fontFor(p.style()); double sizePt = p.style().sizePt(); - double lineH = (f.ascent(sizePt) + f.descent(sizePt) + double lineH = lineFor(p, f.ascent(sizePt) + f.descent(sizePt) + f.leading(sizePt)) * lineHeightFactor; for (String line : wrapLines(p.text(), f, sizePt, box.getWidth())) { lines.add(new Line(line, p.style(), p.align(), @@ -221,6 +250,36 @@ final class DrawMlText { } } + /** + * Высота строки абзаца: a:lnSpc/a:spcPts — фиксированная в pt, + * a:spcPct — доля одинарного (ascent+descent+leading), ничего — + * одинарный (ECMA-376 §21.1.2.4 CT_TextLineSpacing). + */ + private static double lineFor(Paragraph p, double single) { + if (p.spacingPts() != null) { + return p.spacingPts(); + } + return p.spacingPct() != null ? single * p.spacingPct() : single; + } + + /** + * Суммарная высота абзацев после переноса в боксе шириной boxWidth pt + * (та же разбивка, что в {@link #paint}) — мера для подбора кегля + * normAutofit. Регрессия — SmartArtRendererTest#normAutofitShrinksToFit. + */ + static double totalHeight(List paragraphs, double boxWidth, + double lineHeightFactor) { + double total = 0; + for (Paragraph p : paragraphs) { + GlyphFont f = fontFor(p.style()); + double sizePt = p.style().sizePt(); + double lineH = lineFor(p, f.ascent(sizePt) + f.descent(sizePt) + + f.leading(sizePt)) * lineHeightFactor; + total += wrapLines(p.text(), f, sizePt, boxWidth).size() * lineH; + } + return total; + } + /** * Жадный перенос по пробелам; длинные слова режутся по символам. * Ширина набирается инкрементально ({@link GlyphFont#advance} аддитивен — diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawingPreRenderer.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawingPreRenderer.java index 1fc6983..ff2d346 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawingPreRenderer.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawingPreRenderer.java @@ -18,8 +18,6 @@ import org.docx4j.dml.GraphicData; import org.docx4j.dml.STShapeType; import org.docx4j.dml.chart.CTChartSpace; import org.docx4j.dml.chart.CTRelId; -import org.docx4j.dml.diagram.CTDataModel; -import org.docx4j.dml.diagram.CTRelIds; import org.docx4j.dml.diagram2008.CTDrawing; import org.docx4j.dml.picture.Pic; import org.docx4j.dml.wordprocessingDrawing.Anchor; @@ -219,8 +217,7 @@ public final class DrawingPreRenderer { colors, cx, cy); label = "график"; } else if (isDiagram) { - img = renderDiagram(part, (CTRelIds) ((JAXBElement) payload).getValue(), - colors, cx, cy); + img = renderDiagram(part, colors, cx, cy); label = "SmartArt"; } if (img == null) { @@ -252,21 +249,15 @@ public final class DrawingPreRenderer { } } - private static BufferedImage renderDiagram(Part part, CTRelIds refs, - DrawMlColor colors, long cx, long cy) { + private static BufferedImage renderDiagram(Part part, DrawMlColor colors, long cx, long cy) { Part drawingPart = diagramDrawingPart(part); if (!(drawingPart instanceof JaxbXmlPart jp) || !(jp.getJaxbElement() instanceof CTDrawing drawing)) { LOG.warn("dsp:drawing (SmartArt) не найден — схема пропущена"); return null; } - CTDataModel data = null; - if (refs.getDm() != null && resolve(part, refs.getDm()) instanceof JaxbXmlPart dp - && dp.getJaxbElement() instanceof CTDataModel dm) { - data = dm; - } try { - return SmartArtRenderer.render(drawing, data, colors, cx / 12700.0, cy / 12700.0); + return SmartArtRenderer.render(drawing, colors, cx / 12700.0, cy / 12700.0); } catch (RuntimeException | OutOfMemoryError e) { LOG.warn("рендер SmartArt упал: {}", e.toString()); return null; diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/SmartArtRenderer.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/SmartArtRenderer.java index 7ee3e09..a8b3a37 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/SmartArtRenderer.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/SmartArtRenderer.java @@ -11,11 +11,7 @@ import org.docx4j.dml.CTShapeStyle; import org.docx4j.dml.CTTextBodyProperties; import org.docx4j.dml.CTTextNormalAutofit; import org.docx4j.dml.CTTransform2D; -import org.docx4j.dml.diagram.CTCxn; import org.docx4j.dml.STTextAnchoringType; -import org.docx4j.dml.diagram.CTDataModel; -import org.docx4j.dml.diagram.STCxnType; -import org.docx4j.dml.diagram.CTPt; import org.docx4j.dml.diagram2008.CTDrawing; import org.docx4j.dml.diagram2008.CTGroupShape; import org.docx4j.dml.diagram2008.CTShape; @@ -28,9 +24,7 @@ import java.awt.geom.AffineTransform; import java.awt.geom.Rectangle2D; import java.awt.image.BufferedImage; import java.util.ArrayList; -import java.util.HashMap; import java.util.List; -import java.util.Map; /** * SmartArt в растр. Рисуется {@code word/diagrams/drawing1.xml} — это @@ -44,8 +38,10 @@ import java.util.Map; * относительно центра bounding box (ECMA-376 §20.1.7.6, Annex L.4.7.3 * и L.4.7.4). Регрессии — SmartArtRendererTest. * - * Пустые подписи фигур Word показывает текстом-заполнителем из - * {@code data1.xml} (dgm:pt/dgm:prSet/@phldrT) — его берём оттуда же. + * Текст-заполнитель dgm:prSet/@phldrT («[Текст]», ECMA-376 §21.4.3.4) — + * элемент интерфейса редактирования: в dsp:кэше у таких фигур txBody пуст, + * и Word при экспорте в PDF ничего не рисует — мы тоже. Регрессия — + * SmartArtRendererTest#emptyTxBody_noPlaceholderInk. */ final class SmartArtRenderer { @@ -79,7 +75,7 @@ final class SmartArtRenderer { private record Item(CTShape shape, AffineTransform toDiagram, double w, double h) { } - static BufferedImage render(CTDrawing drawing, CTDataModel data, DrawMlColor colors, + static BufferedImage render(CTDrawing drawing, DrawMlColor colors, double widthPt, double heightPt) { List items = new ArrayList<>(); collect(drawing.getSpTree().getSpOrGrpSp(), new AffineTransform(), items); @@ -123,9 +119,8 @@ final class SmartArtRenderer { g.translate(offX, offY); g.scale(scale, scale); - Map placeholders = placeholders(data); for (Item it : items) { - drawShape(g, it, colors, placeholders); + drawShape(g, it, colors); } } finally { g.dispose(); @@ -190,52 +185,7 @@ final class SmartArtRenderer { } } - /** - * Подписи-заполнители. Форма в drawing1.xml ссылается на dgm:pt - * type="pres", а phldrT лежит на dgm:pt type="node" — их связывает - * dgm:cxn type="presOf" (srcId=node, destId=pres). - */ - private static Map placeholders(CTDataModel data) { - Map out = new HashMap<>(); - if (data == null || data.getPtLst() == null) { - return out; - } - Map byId = new HashMap<>(); - for (CTPt pt : data.getPtLst().getPt()) { - if (pt.getModelId() != null) { - byId.put(pt.getModelId(), pt); - } - } - if (data.getCxnLst() != null) { - for (CTCxn cxn : data.getCxnLst().getCxn()) { - if (cxn.getType() != STCxnType.PRES_OF || cxn.getDestId() == null) { - continue; - } - String text = phldrOf(byId.get(cxn.getSrcId())); - if (text != null) { - out.put(cxn.getDestId(), text); - } - } - } - for (CTPt pt : data.getPtLst().getPt()) { - String text = phldrOf(pt); - if (text != null && pt.getModelId() != null) { - out.putIfAbsent(pt.getModelId(), text); - } - } - return out; - } - - private static String phldrOf(CTPt pt) { - if (pt == null || pt.getPrSet() == null || pt.getPrSet().getPhldrT() == null) { - return null; - } - String text = pt.getPrSet().getPhldrT(); - return text.isBlank() ? null : text; - } - - private static void drawShape(Graphics2D g, Item it, DrawMlColor colors, - Map placeholders) { + private static void drawShape(Graphics2D g, Item it, DrawMlColor colors) { CTShape sp = it.shape(); CTShapeProperties spPr = sp.getSpPr(); @@ -324,62 +274,54 @@ final class SmartArtRenderer { paragraphs = DrawMlText.paragraphs(sp.getTxBody(), colors, colors.minorFontName(), 12, textColor); } - if (paragraphs.isEmpty() && sp.getModelId() != null) { - String ph = placeholders.get(sp.getModelId()); - if (ph != null) { - paragraphs = List.of(new DrawMlText.Paragraph(ph, - new DrawMlText.Style(9, false, false, textColor, - colors.minorFontName()), "ctr")); - } - } if (paragraphs.isEmpty()) { return; } - // autofit по CT_TextBodyProperties: noAutofit — текст по заявленным - // размерам (переполнение не ужимается, как в Word); normAutofit — - // fontScale/lnSpcReduction из XML, затем подбор кегля под прямоугольник. + // autofit по ECMA-376 §21.1.2.1.2/.3: noAutofit, spAutoFit (§21.1.2.1.4 — + // под размер текста ресайзится фигура, сам текст не масштабируется) + // или отсутствие autofit-элемента (отсутствие имплицирует noAutofit) — + // текст рисуется заявленным кеглем. normAutofit — применяем запечённые + // Word-ом fontScale/lnSpcReduction из XML; если fontScale не запечён + // (устаревший или чужой кэш), Word пересчитывает autofit при рендере — + // и мы подбираем кегль так, чтобы высота надетого текста влезала в + // прямоугольник (до MIN_FONT_PT). Регрессии — + // SmartArtRendererTest#normAutofitShrinksToFit, + // #missingAutofitKeepsDeclaredSize. double lineFactor = 1.0; - boolean noAutofit = bodyPr != null && bodyPr.getNoAutofit() != null; CTTextNormalAutofit na = bodyPr == null ? null : bodyPr.getNormAutofit(); if (na != null) { - if (na.getFontScale() > 0 && na.getFontScale() != NORM_AUTOFIT_FULL) { - double k = na.getFontScale() / (double) NORM_AUTOFIT_FULL; - List scaled = new ArrayList<>(); - for (DrawMlText.Paragraph p : paragraphs) { - scaled.add(new DrawMlText.Paragraph(p.text(), - p.style().derive(p.style().sizePt() * k, - null, null, null, null), p.align())); - } - paragraphs = scaled; - } if (na.getLnSpcReduction() > 0) { lineFactor = 1.0 - na.getLnSpcReduction() / (double) NORM_AUTOFIT_FULL; } - } - if (!noAutofit) { - // autosize: уменьшаем кегль, пока текст не влезет в прямоугольник - for (int attempt = 0; attempt < SHRINK_ATTEMPTS; attempt++) { - double needed = 0; - for (DrawMlText.Paragraph p : paragraphs) { - needed += DrawMlText.textHeight(p.style()); + if (na.getFontScale() > 0 && na.getFontScale() != NORM_AUTOFIT_FULL) { + paragraphs = scale(paragraphs, na.getFontScale() / (double) NORM_AUTOFIT_FULL); + } else { + for (int attempt = 0; attempt < SHRINK_ATTEMPTS && p0(paragraphs) > MIN_FONT_PT; + attempt++) { + double needed = DrawMlText.totalHeight(paragraphs, tw, lineFactor); + if (needed <= th) { + break; + } + paragraphs = scale(paragraphs, + Math.max(MIN_FONT_PT / p0(paragraphs), th / needed)); } - if (needed <= th || p0(paragraphs) <= MIN_FONT_PT) { - break; - } - double factor = th / needed; - List shrunk = new ArrayList<>(); - for (DrawMlText.Paragraph p : paragraphs) { - shrunk.add(new DrawMlText.Paragraph(p.text(), - p.style().derive(p.style().sizePt() * factor, - null, null, null, null), p.align())); - } - paragraphs = shrunk; } } DrawMlText.paint(g, paragraphs, new Rectangle2D.Double(tx, ty, tw, th), ALIGN_LEFT, vAlignOf(bodyPr), lineFactor); } + /** Масштабирует кегль всех абзацев в k раз (a:spcPts — абсолютный, не масштабируется). */ + private static List scale(List ps, double k) { + List out = new ArrayList<>(ps.size()); + for (DrawMlText.Paragraph p : ps) { + out.add(new DrawMlText.Paragraph(p.text(), + p.style().derive(p.style().sizePt() * k, null, null, null, null), + p.align(), p.spacingPct(), p.spacingPts())); + } + return out; + } + /** Insets bodyPr: значение из XML (EMU) или дефолт ECMA (pt) -> pt. */ private static double inset(Integer emu, double defaultPt) { return emu == null ? defaultPt : emu / EMU_PER_PT; diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/DrawMlTextTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/DrawMlTextTest.java index b3d010a..2122923 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/DrawMlTextTest.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/DrawMlTextTest.java @@ -6,6 +6,8 @@ import org.docx4j.dml.CTTextBody; import org.docx4j.dml.CTTextCharacterProperties; import org.docx4j.dml.CTTextParagraph; import org.docx4j.dml.CTTextParagraphProperties; +import org.docx4j.dml.CTTextSpacing; +import org.docx4j.dml.CTTextSpacingPercent; import org.docx4j.dml.STTextAlignType; import org.docx4j.dml.TextFont; import org.junit.jupiter.api.Test; @@ -89,6 +91,62 @@ class DrawMlTextTest { assertEquals(Color.GRAY, base.color(), "без a:pPr/a:defRPr — фолбэк-цвет"); } + /** + * Фолбэк-семейство (шрифт темы, когда у рана нет a:latin) алиасится + * в бандл: «Calibri» → Carlito. Без алиаса GlyphFont.of("Calibri") + * не находится, текст молча уезжает в DejaVu Sans — шире, чем Calibri + * у Word, из-за чего текст SmartArt переносился и вылезал за фигуру. + */ + @Test + void fallbackFamilyAliasedToBundle() { + DrawMlText.Style def = DrawMlText.defaultStyle(null, new DrawMlColor(null), + "Calibri", 9, Color.BLACK); + assertEquals("carlito", def.family()); + } + + /** a:lnSpc/a:spcPct (ECMA-376 §21.1.2.4) — высота строки как доля одинарного. */ + @Test + void lineSpacingPct_compactsLines() { + BundledFonts.init(); + DrawMlColor colors = new DrawMlColor(null); + CTTextBody body = new CTTextBody(); + CTTextParagraph p = new CTTextParagraph(); + CTTextParagraphProperties pPr = new CTTextParagraphProperties(); + CTTextSpacing lnSpc = new CTTextSpacing(); + CTTextSpacingPercent pct = new CTTextSpacingPercent(); + pct.setVal(40000); + lnSpc.setSpcPct(pct); + pPr.setLnSpc(lnSpc); + p.setPPr(pPr); + CTRegularTextRun r = new CTRegularTextRun(); + r.setT("A\nB"); + p.getEGTextRun().add(r); + body.getP().add(p); + List paras = DrawMlText.paragraphs(body, colors, + "DejaVu Sans", 10, Color.BLACK); + assertEquals(0.4, paras.get(0).spacingPct(), 1e-9); + int compacted = lastInkY(paint(paras, + new Rectangle2D.Double(0, 0, 120, 80), null, "t")); + int normal = lastInkY(paint(List.of(new DrawMlText.Paragraph("A\nB", STYLE, null)), + new Rectangle2D.Double(0, 0, 120, 80), null, "t")); + assertTrue(compacted < normal - 8, + "интервал 40% — вторая строка заметно выше: compacted=" + + compacted + ", normal=" + normal); + } + + /** Нижний ряд с тёмными чернилами. */ + private static int lastInkY(BufferedImage img) { + for (int y = img.getHeight() - 1; y >= 0; y--) { + for (int x = 0; x < img.getWidth(); x++) { + int argb = img.getRGB(x, y); + if (argb >>> 24 > 0 && (argb & 0xFFFFFF) < 0x808080) { + return y; + } + } + } + return -1; + } + @Test void paragraphsNullBodyAndRunStyles() { BundledFonts.init(); diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/SmartArtRendererTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/SmartArtRendererTest.java index 5cc87b9..d071700 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/SmartArtRendererTest.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/SmartArtRendererTest.java @@ -6,11 +6,18 @@ import org.docx4j.dml.CTNoFillProperties; import org.docx4j.dml.CTPoint2D; import org.docx4j.dml.CTPositiveSize2D; import org.docx4j.dml.CTPresetGeometry2D; +import org.docx4j.dml.CTRegularTextRun; import org.docx4j.dml.CTSRgbColor; import org.docx4j.dml.CTShapeProperties; import org.docx4j.dml.CTSolidColorFillProperties; import org.docx4j.dml.CTTransform2D; +import org.docx4j.dml.CTTextBody; +import org.docx4j.dml.CTTextBodyProperties; +import org.docx4j.dml.CTTextCharacterProperties; +import org.docx4j.dml.CTTextNormalAutofit; +import org.docx4j.dml.CTTextParagraph; import org.docx4j.dml.STShapeType; +import org.docx4j.dml.STTextAnchoringType; import org.docx4j.dml.diagram2008.CTDrawing; import org.docx4j.dml.diagram2008.CTGroupShape; import org.docx4j.dml.diagram2008.CTShape; @@ -20,6 +27,7 @@ import java.awt.image.BufferedImage; import static org.junit.jupiter.api.Assertions.assertEquals; import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.junit.jupiter.api.Assertions.assertFalse; /** * Обход dsp:spTree и трансформации фигур: flipH/flipV применяются до @@ -85,7 +93,7 @@ class SmartArtRendererTest { } private static BufferedImage render(CTDrawing d) { - return SmartArtRenderer.render(d, null, new DrawMlColor(null), SIDE_PT, SIDE_PT); + return SmartArtRenderer.render(d, new DrawMlColor(null), SIDE_PT, SIDE_PT); } private static boolean reddish(BufferedImage img, double fx, double fy) { @@ -220,4 +228,101 @@ class SmartArtRendererTest { BufferedImage img = render(tree(gs)); assertTrue(reddish(img, 0.5, 0.5), "дочерний rect отрендерен как есть"); } + + /** rect w×h pt, noFill, с текстовым телом. */ + private static CTShape textRect(double wPt, double hPt, CTTextBody txBody) { + CTShape sp = new CTShape(); + CTTransform2D t = new CTTransform2D(); + t.setOff(point(0, 0)); + t.setExt(size(Math.round(wPt * 12700), Math.round(hPt * 12700))); + CTShapeProperties spPr = new CTShapeProperties(); + spPr.setXfrm(t); + spPr.setNoFill(new CTNoFillProperties()); + sp.setSpPr(spPr); + sp.setTxBody(txBody); + return sp; + } + + /** txBody: bodyPr + абзацы раном 12pt. */ + private static CTTextBody textBody(CTTextBodyProperties bodyPr, String... texts) { + CTTextBody tb = new CTTextBody(); + tb.setBodyPr(bodyPr); + for (String s : texts) { + CTTextParagraph p = new CTTextParagraph(); + CTRegularTextRun r = new CTRegularTextRun(); + CTTextCharacterProperties rPr = new CTTextCharacterProperties(); + rPr.setSz(1200); + r.setRPr(rPr); + r.setT(s); + p.getEGTextRun().add(r); + tb.getP().add(p); + } + return tb; + } + + /** Есть ли тёмные чернила (цвет текста 0x595959) ниже yPt изображения. */ + private static boolean hasInkBelow(BufferedImage img, double yPt) { + int y0 = Math.max(0, (int) Math.ceil(yPt * SmartArtRenderer.DPI / 72.0)); + for (int y = y0; y < img.getHeight(); y++) { + for (int x = 0; x < img.getWidth(); x++) { + int argb = img.getRGB(x, y); + if (argb >>> 24 > 0 && (argb & 0xFFFFFF) < 0x808080) { + return true; + } + } + } + return false; + } + + /** + * ECMA-376 §21.4.3.4: phldrT («[Текст]») — заполнитель интерфейса + * редактирования; при пустом txBody Word в PDF ничего не рисует, и мы. + */ + @Test + void emptyTxBody_noPlaceholderInk() { + CTTextBody tb = new CTTextBody(); + tb.setBodyPr(new CTTextBodyProperties()); + tb.getP().add(new CTTextParagraph()); + BufferedImage img = render(tree(textRect(60, 20, tb))); + for (int y = 0; y < img.getHeight(); y++) { + for (int x = 0; x < img.getWidth(); x++) { + assertEquals(0, img.getRGB(x, y) >>> 24, + "пустая фигура — никаких чернил (заполнитель не рисуется)"); + } + } + } + + /** + * §21.1.2.1.3: normAutofit без запечённого fontScale — Word пересчитывает + * autofit при рендере; и мы подбираем кегль под высоту надетого текста. + * Раньше эвристика проверяла высоту одной строки, и переносы вылезали + * из-под фигуры. + */ + @Test + void normAutofitShrinksToFit() { + CTTextBodyProperties bodyPr = new CTTextBodyProperties(); + bodyPr.setAnchor(STTextAnchoringType.T); + bodyPr.setNormAutofit(new CTTextNormalAutofit()); + BufferedImage img = render(tree(textRect(60, 40, textBody(bodyPr, + "альфа бета гамма дельта эпсилон зета эта йота капа лямбда")))); + double bottomPt = (SIDE_PT - 40 * (SIDE_PT / 60.0)) / 2.0 + 40 * (SIDE_PT / 60.0); + assertTrue(hasInkBelow(img, 0), "текст нарисован"); + assertFalse(hasInkBelow(img, bottomPt + 2), + "normAutofit — перенесённый текст влезает в фигуру"); + } + + /** + * §21.1.2.1.2: отсутствие autofit-элемента имплицирует noAutofit — + * заявленный кегль не ужимается, переполнение уходит за фигуру (как Word). + * Раньше эвристика резала кегль и без normAutofit. + */ + @Test + void missingAutofitKeepsDeclaredSize() { + CTTextBodyProperties bodyPr = new CTTextBodyProperties(); + bodyPr.setAnchor(STTextAnchoringType.T); + BufferedImage img = render(tree(textRect(60, 40, textBody(bodyPr, "A", "B", "C")))); + double bottomPt = (SIDE_PT - 40 * (SIDE_PT / 60.0)) / 2.0 + 40 * (SIDE_PT / 60.0); + assertTrue(hasInkBelow(img, bottomPt + 2), + "нет autofit — кегль не ужат, текст выходит за фигуру"); + } }