diff --git a/AGENTS.md b/AGENTS.md index db2f5fc..77bef38 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -77,7 +77,7 @@ Нормативный источник любых правок — ECMA-376 (`docs/standards/`: графики §21.2, diagram-разметка §21.4, пресет-геометрия Annex D + полные наборы XSD `schema/strict/`/`schema/transitional/`; поведение Word — `ms-oi29500.md`, `ms-odrawxml.md`), а не догадки по исходникам LibreOffice/Word. Формулировки из стандарта при ссылке — с номером секции (§21.2.2.132 и т.п.). Эмпирические калибровки (камера, `PIE_DEPTH`) менять только вместе с пиксельными тестами. Фикстуры могут быть невалидны — код под фикстуру не правится, правится фикстура (после проверки по XSD/секции). -Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`, `PADDING = 4.0`, растр × `DPI/72`, размеры в пунктах, EMU→pt `cx/12700.0`). Потолок растра `ChartRenderer.MAX_PIXELS = 16_777_216` (4096², 64 МБ ARGB): при превышении `fitDpi` uniform-но понижает эффективный dpi (геометрия в пунктах и безразмерные пропорции не меняются; 24″-график: 208 МБ → 64 МБ, dpi 300 → ≈171); `SmartArtRenderer` использует тот же `DPI`/`fitDpi`. `ChartSpec.parse` (`enum Type`: PIE, PIE3D, DOUGHNUT, BAR, BAR_HORIZONTAL, LINE, AREA, SURFACE3D, AREA3D, BAR3D, LINE3D, RADAR, SCATTER, BUBBLE, STOCK, OF_PIE, SURFACE, UNSUPPORTED). `c:autoTitleDeleted=true` (в т.ч. при опущенном `c:val` — default true) скрывает заголовок целиком, включая явный `c:tx` (§21.2.2.7). Пустой `c:title` + `autoTitleDeleted="0"` — автозаголовок Word: круговая (PIE/PIE3D/DOUGHNUT/OF_PIE) с **одним** рядом → имя ряда, иначе `ChartSpec.AUTO_TITLE = "Название диаграммы"`; несколько абзацев `a:p` склеиваются `'\n'` (жёсткий перенос в `DrawMlText`). Регрессии — `ChartSpecTest#deletedTitleWithText_notShown`, `#deletedTitleValOmitted_notShown`, `#multiSeriesDoughnut_placeholderNotSeriesName`, `#multiParagraphTitle_joinedWithNewlines`. Палитра `accent1..6` темы; легенда по умолчанию снизу; `overlay` (§21.2.2.132) рисуется поверх области построения, место не резервирует. +Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`, `PADDING = 4.0`, растр × `DPI/72`, размеры в пунктах, EMU→pt `cx/12700.0`). Потолок растра `ChartRenderer.MAX_PIXELS = 16_777_216` (4096², 64 МБ ARGB): при превышении `fitDpi` uniform-но понижает эффективный dpi (геометрия в пунктах и безразмерные пропорции не меняются; 24″-график: 208 МБ → 64 МБ, dpi 300 → ≈171); `SmartArtRenderer` использует тот же `DPI`/`fitDpi`. `ChartSpec.parse` (`enum Type`: PIE, PIE3D, DOUGHNUT, BAR, BAR_HORIZONTAL, LINE, AREA, SURFACE3D, AREA3D, BAR3D, LINE3D, RADAR, SCATTER, BUBBLE, STOCK, OF_PIE, SURFACE, UNSUPPORTED). `c:autoTitleDeleted` (§21.2.2.7, `val` опущен — default true) применяется только при отсутствии `c:title` (MS-OI29500 §2.1.1431(a)) — явный заголовок показывается при любом флаге; при отсутствии `c:title` и `val=0` рисуется автозаголовок. Пустой/пробельный `c:title` (или `val=0` без `c:title`) — автозаголовок Office (MS-OI29500 §2.1.1561(a)): одиночный ряд с именем → имя ряда (любой тип графика), иначе `ChartSpec.AUTO_TITLE = "Название диаграммы"`; несколько абзацев `a:p` склеиваются `'\n'` (жёсткий перенос в `DrawMlText`). Регрессии — `ChartSpecTest#emptyTitleSingleSeriesBar_usesSeriesName`, `#deletedTitleWithText_stillShown`, `#deletedTitleValOmitted_stillShown`, `#multiSeriesDoughnut_placeholderNotSeriesName`, `#multiParagraphTitle_joinedWithNewlines`. Палитра `accent1..6` темы; легенда по умолчанию снизу; `overlay` (§21.2.2.132) рисуется поверх области построения, место не резервирует. Пейнтеры: `CartesianPainter` (2-D line/bar/area; `c:grouping` stacked/percentStacked §21.2.2.76 — ряд рисуется накопленной суммой через `ChartRenderer.stackedCumulative`), `PiePainter` (`PIE_DEPTH = 0.22`, `PIE_FIT = 0.865`), `Surface3dPainter` (камера — регрессия `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` приоритетнее `c:perspective` (MS-OI29500 §2.1.1516(b)); `c:wireframe` §21.2.2.205 — только каркас), `ScatterPainter` (радиус пузыря sqrt при `c:sizeRepresents="area"` §21.2.2.128), `RadarPainter` (спицы от 12 часов), `StockPainter` (upDownBars обводятся контуром, дефолт чёрный 0.75pt), `OfPiePainter` (MS-OI29500 §2.1.1507(a), §2.1.1545(a)), `Surface2dPainter` (контурная карта §21.2.2.204, marching squares, изолинии по `c:bandFmts` §21.2.2.13/.14), `Cartesian3dPainter` (bar3D/line3D/area3D §21.2.2.19/.101/.122, `c:shape` §21.2.3.44), `SmartArtRenderer` (кэш `word/diagrams/drawing1.xml` через relationship `…/office/2007/relationships/diagramDrawing`; формы — `PresetGeometry` из `a:prstGeom`, семь пресетов дословно из `presetShapeDefinitions.xml`; оператор `?:` = «if x > 0 then y else z» (ISO/IEC 29500-1, **не** x != 0); углы в Arc2D — со знаком минус; текст — `DrawMlText`, шрифты через `BundledFontMapper.bundledFamily`; autofit только `normAutofit` §21.1.2.1.2/.3; `dgm:prSet/@phldrT` не рисуется). @@ -217,5 +217,5 @@ java -cp wordpdf-core/target/test-classes:$(cat /tmp/cp.txt) \ - Фикстуры — закоммиченные `samples/*.docx` (13; в тестах не генерировать; все ECMA-conformant по `docs/standards/validate-fixtures.py` — фикстура невалидна, правится фикстура, не код): core грузит classpath-ресурсом → `byte[]`, PDF для PDFBox — временный файл; app читает `/samples/…` из **test-jar core** (classifier `tests`) → `mvn -pl wordpdf-app` без `-am` не соберётся. In-memory docx — `ZipOutputStream` из литеральных XML или POI в `byte[]`. Ключевые: `too-many-pages` (150 явных разрывов → 151), `stale-cache` (кэш `1` + 110 `lastRenderedPageBreak`), `charts-smartart` (4 растра; SmartArt-одиночка = ровно 2 Image XObject), `ole-embedded` (осиротевший bin с ложным `Default bin→footer+xml` + настоящий `w:object` с честным `Override → oleObject` и VML-плейсхолдером `media/fallback.png` — ручная, генератором не перезаписывать), `chart-types` (14 графиков: 9 типов + ofPie-pie + lineChart stacked + `c:wireframe` + combo barChart+lineChart на вторичной `c:valAx` pos="r"; пересоздание — `ChartTypesDocxGenerator`). - Юниты нормализаторов работают строками (`rewrite`) + zip'ами из `ZipOutputStream`; обязательные контракты: «нечего менять → тот же массив» (`assertSame`) и неприкосновенность частей вне `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`: `@Nested` + `@TestPropertySource` не даёт отдельного контекста). -- Регрессивные пары (фикс = нормализатор/pre-renderer + юнит + конвертер-тест с фикстурой): `StrictOoxmlNormalizerTest`↔`strictOoxml_convertsNotRejected` (+`pageCount_strictBreaksCountedLightweight`; юниты `indCoexistLeftStartUntouched`/`tcMarCoexistKept`/`tcBordersElementsKeptTransitional`/`jcStartRenamedTransitional`/`tabStartRenamedTransitional`/`transitionalCoexistReturnsOriginalArray`), `DocxOnOffNormalizerTest`↔`ruPlain_regularRunsUseRegularFont`, `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`), `WordPdfValidatorTest`↔`staleCachePageCountRejectedBeforeRender` (+`checkPageCount_limitBoundary` 99/100/101, `cachedPagesUnreadableFallsBackToZero`, `pageCount_breaksInsideTablesAreCounted`, `pageCount_continuousSectionsNotCountedLightweight`, `validate_notAZip`/`validate_plainZipRejected`/`validate_xlsxRenamedRejected`/`validate_zipBombRejected`/`validate_tooManyEntriesRejected`), `BundledFontsTest`↔`ruPlain_emDashEmbeddedNotHelvetica`, `PresetGeometryTest`↔`chartsSmartArt_drawingsBecomeImages` (`tableMatchesEcmaXml`), chart-пейнтеры↔`chartTypes_allTypesRenderAsImages`, `ChartSpecTest`↔автозаголовки/комбо/DoS (`hugePointIndex_rejectedNotOom`, `hugePtCount_rejectedNotOom`, `hugeCategoryIndex_rejectedNotOom`, `nonFiniteScalingBounds_dropped`, `overlayLegend_keepsPositionAndFlag`, `deletedTitleWithText_notShown`, `deletedTitleValOmitted_notShown`, `multiSeriesDoughnut_placeholderNotSeriesName`, `multiParagraphTitle_joinedWithNewlines`), `Surface3dPainterTest`↔`axisBounds_tinyMajorUnit_fallsBackToNiceUnit`/`axisBounds_zeroMajorUnit_fallsBackToNiceUnit`, `ChartRendererTest`↔`axisBounds_explicitHugeRange_reunitsToMaxTicks`/`axisBounds_infiniteSpan_fallsBackToData`/`stackedCumulative_*`/`stackedRange_coversNegativeSums`/`overlayLegend_drawnOverPlot`/`wireframeSurfaceLegend_hollowMarkers`, `DrawMlTextTest`↔`hugeWord_wrapsLinearly`/`fallbackFamilyAliasedToBundle`/`lineSpacingPct_compactsLines`, `DrawMlColorTest`↔`invalidSrgbHexFallsBackToOfficeDefault`, `SmartArtRendererTest`↔`normAutofitShrinksToFit`/`missingAutofitKeepsDeclaredSize`/`emptyTxBody_noPlaceholderInk`, `CartesianPainterTest`↔`stackedLine_seriesStackCumulatively`/`percentStackedLine_topSeriesFlatAtHundred`/`areaFill_closesToBaseline`/`combo_barsAndLineOnSecondary_bothDrawn`, `GlyphCoverageNormalizerTest`↔`multipleTextNodes_runLeftUntouched`/`nestedRunInTextBox_innerSplit`, `SymbolFontNormalizerTest`↔`nestedRunInTextBox_innerNormalized`, `WordPdfConverterTest`↔`noLoggingWarningInPdf`/`pdfTitle_comesFromParameter`/`hostileChartAxis_convertsNotHangs`/`hugeExtentChart_removedNotOom`/`chartWithoutExtent_errorFlagRejects`/`jcEndTransitional_rightAligned`/`rPrPosition_raisesBaseline`/`vendoredXsltTracksJarCopy` (аудит раскладки ECMA-376), `LayoutPostRendererTest`↔`tableCellPadding_textInsetLikeWord` (+`lineRuleAuto_wordSingleLinePitch` пинит метрический шаг «single» от псевдофиксов, `carlitoAutoBlock_untouched`), `TableIndentNormalizerTest`↔`tableIndentCentered_shiftedLikeWord`, `NumberingSuffixNormalizerTest`↔`suffSpace_labelGetsSpace`. App-регрессии: `requestLimitParams_areIgnored`, `nonPositiveLimits_failStartup`, `unknownPath_notFound`, `concurrentRequests_bothSucceed`, `corruptNotAZip_rejected`, `plainZipNotDocx_rejected`, `junkInsideValidZip_conversionError` (500 на валидном .docx-контейнере с мусором), `nonDocxFilename_rejected`, `oversizedOverCoreLimit_rejected`, `drawingsAlwaysRendered`, `cyrillicAndPathInFilename_sanitizedResponseName`, `docsOpenWithoutKey`/`forwardedPrefix_healthStaysOpen`/`forwardedPrefix_docsOpenWithoutKey`, `dotSegmentOpenPrefix_rejected`, `errorFlagNotBoolean_rejected`, `methodNotSupportedReturns405`/`badContentTypeReturns415`. +- Регрессивные пары (фикс = нормализатор/pre-renderer + юнит + конвертер-тест с фикстурой): `StrictOoxmlNormalizerTest`↔`strictOoxml_convertsNotRejected` (+`pageCount_strictBreaksCountedLightweight`; юниты `indCoexistLeftStartUntouched`/`tcMarCoexistKept`/`tcBordersElementsKeptTransitional`/`jcStartRenamedTransitional`/`tabStartRenamedTransitional`/`transitionalCoexistReturnsOriginalArray`), `DocxOnOffNormalizerTest`↔`ruPlain_regularRunsUseRegularFont`, `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`), `WordPdfValidatorTest`↔`staleCachePageCountRejectedBeforeRender` (+`checkPageCount_limitBoundary` 99/100/101, `cachedPagesUnreadableFallsBackToZero`, `pageCount_breaksInsideTablesAreCounted`, `pageCount_continuousSectionsNotCountedLightweight`, `validate_notAZip`/`validate_plainZipRejected`/`validate_xlsxRenamedRejected`/`validate_zipBombRejected`/`validate_tooManyEntriesRejected`), `BundledFontsTest`↔`ruPlain_emDashEmbeddedNotHelvetica`, `PresetGeometryTest`↔`chartsSmartArt_drawingsBecomeImages` (`tableMatchesEcmaXml`), chart-пейнтеры↔`chartTypes_allTypesRenderAsImages`, `ChartSpecTest`↔автозаголовки/комбо/DoS (`hugePointIndex_rejectedNotOom`, `hugePtCount_rejectedNotOom`, `hugeCategoryIndex_rejectedNotOom`, `nonFiniteScalingBounds_dropped`, `overlayLegend_keepsPositionAndFlag`, `emptyTitleSingleSeriesBar_usesSeriesName`, `deletedTitleWithText_stillShown`, `deletedTitleValOmitted_stillShown`, `multiSeriesDoughnut_placeholderNotSeriesName`, `multiParagraphTitle_joinedWithNewlines`), `Surface3dPainterTest`↔`axisBounds_tinyMajorUnit_fallsBackToNiceUnit`/`axisBounds_zeroMajorUnit_fallsBackToNiceUnit`, `ChartRendererTest`↔`axisBounds_explicitHugeRange_reunitsToMaxTicks`/`axisBounds_infiniteSpan_fallsBackToData`/`stackedCumulative_*`/`stackedRange_coversNegativeSums`/`overlayLegend_drawnOverPlot`/`wireframeSurfaceLegend_hollowMarkers`, `DrawMlTextTest`↔`hugeWord_wrapsLinearly`/`fallbackFamilyAliasedToBundle`/`lineSpacingPct_compactsLines`, `DrawMlColorTest`↔`invalidSrgbHexFallsBackToOfficeDefault`, `SmartArtRendererTest`↔`normAutofitShrinksToFit`/`missingAutofitKeepsDeclaredSize`/`emptyTxBody_noPlaceholderInk`, `CartesianPainterTest`↔`stackedLine_seriesStackCumulatively`/`percentStackedLine_topSeriesFlatAtHundred`/`areaFill_closesToBaseline`/`combo_barsAndLineOnSecondary_bothDrawn`, `GlyphCoverageNormalizerTest`↔`multipleTextNodes_runLeftUntouched`/`nestedRunInTextBox_innerSplit`, `SymbolFontNormalizerTest`↔`nestedRunInTextBox_innerNormalized`, `WordPdfConverterTest`↔`noLoggingWarningInPdf`/`pdfTitle_comesFromParameter`/`hostileChartAxis_convertsNotHangs`/`hugeExtentChart_removedNotOom`/`chartWithoutExtent_errorFlagRejects`/`jcEndTransitional_rightAligned`/`rPrPosition_raisesBaseline`/`vendoredXsltTracksJarCopy` (аудит раскладки ECMA-376), `LayoutPostRendererTest`↔`tableCellPadding_textInsetLikeWord` (+`lineRuleAuto_wordSingleLinePitch` пинит метрический шаг «single» от псевдофиксов, `carlitoAutoBlock_untouched`), `TableIndentNormalizerTest`↔`tableIndentCentered_shiftedLikeWord`, `NumberingSuffixNormalizerTest`↔`suffSpace_labelGetsSpace`. App-регрессии: `requestLimitParams_areIgnored`, `nonPositiveLimits_failStartup`, `unknownPath_notFound`, `concurrentRequests_bothSucceed`, `corruptNotAZip_rejected`, `plainZipNotDocx_rejected`, `junkInsideValidZip_conversionError` (500 на валидном .docx-контейнере с мусором), `nonDocxFilename_rejected`, `oversizedOverCoreLimit_rejected`, `drawingsAlwaysRendered`, `cyrillicAndPathInFilename_sanitizedResponseName`, `docsOpenWithoutKey`/`forwardedPrefix_healthStaysOpen`/`forwardedPrefix_docsOpenWithoutKey`, `dotSegmentOpenPrefix_rejected`, `errorFlagNotBoolean_rejected`, `methodNotSupportedReturns405`/`badContentTypeReturns415`. - 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/ChartSpec.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartSpec.java index c64b277..3f66afe 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartSpec.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartSpec.java @@ -79,6 +79,9 @@ final class ChartSpec { * не определяет). */ static final String AUTO_TITLE = "Название диаграммы"; + /** Порог «одиночный ряд» для автозаголовка (MS-OI29500 §2.1.1561(a)). */ + private static final int SINGLE_SERIES = 1; + /** * Верхняя граница индекса точки ({@code c:pt/@idx}, ECMA-376 §21.2.2.150/.151) и * счётчика ({@code c:ptCount}, §21.2.2.152): оба — ST_UnsignedInt без верхней @@ -900,23 +903,33 @@ final class ChartSpec { /** * Заголовок: явный текст (c:title/c:tx) или автозаголовок. - * {@code c:autoTitleDeleted=true} скрывает заголовок целиком, включая - * явный текст (ECMA-376 §21.2.2.7: «the title shall not be shown»; - * атрибут {@code c:val} опущен — значение по умолчанию true). Пустой - * заголовок при autoTitleDeleted=0: у круговой диаграммы с одним рядом - * — имя ряда, иначе встроенный плейсхолдер (строка UI-языка Word). + * MS-OI29500 §2.1.1431(a): в Office {@code c:autoTitleDeleted} + * (ECMA-376 §21.2.2.7, {@code val} опущен — default true) применяется + * ТОЛЬКО когда {@code c:title} у графика отсутствует — явный заголовок + * показывается при любом флаге. Пустой/пробельный {@code c:title} — + * автозаголовок Office (MS-OI29500 §2.1.1561(a)): одиночный ряд с именем + * → имя ряда (любой тип графика), иначе — локализованный плейсхолдер. + * Регрессии — ChartSpecTest#emptyTitleSingleSeriesBar_usesSeriesName, + * #deletedTitleWithText_stillShown. */ static void readTitle(CTChart chart, ChartSpec spec, DrawMlColor colors) { CTTitle t = chart.getTitle(); + // §21.2.2.7: val опущен — true. + boolean autoDeleted = chart.getAutoTitleDeleted() == null + || chart.getAutoTitleDeleted().isVal(); if (t == null) { + // §2.1.1431(a): флаг имеет смысл только при отсутствии c:title; + // val=0 — автозаголовок не удалён, он рисуется. + if (autoDeleted) { + return; + } + spec.title = autoTitleText(spec); + spec.titleStyle = DrawMlText.defaultStyle(null, colors, + colors.minorFontName(), 14, new Color(0x59, 0x59, 0x59)); return; } - // §21.2.2.7: удалённый автозаголовок не показывает заголовок ни при - // каких условиях — в том числе явный c:tx (устаревший текст из чужих - // шаблонов, где Word его скрывает, у нас не должен появляться). - if (chart.getAutoTitleDeleted() != null && chart.getAutoTitleDeleted().isVal()) { - return; - } + // §2.1.1431(a): при наличии c:title Office игнорирует autoTitleDeleted — + // явный текст показывается всегда. String text = null; CTTx tx = t.getTx(); if (tx != null) { @@ -935,29 +948,27 @@ final class ChartSpec { text = String.join("\n", paragraphs); } } - // Пустой c:title при autoTitleDeleted=0 — это автозаголовок Word: - // у круговой диаграммы с ОДНИМ рядом он берётся из имени ряда - // (автозаголовок = имя единственного ряда), во всех остальных - // случаях рисуется встроенный плейсхолдер (в англ. эталоне Word — - // "Chart Title", у нас плейсхолдер русифицирован; в XML его нет, - // Word подставляет строку из своего UI-языка). + // Пустой/пробельный c:title — автозаголовок Office (§2.1.1561(a)). if (text == null || text.isBlank()) { - boolean circular = spec.type == Type.PIE || spec.type == Type.PIE3D - || spec.type == Type.DOUGHNUT || spec.type == Type.OF_PIE; - if (circular && spec.series.size() == 1) { - text = spec.series.get(0).name; - } else { - text = AUTO_TITLE; - } - } - if (text == null || text.isBlank()) { - return; + text = autoTitleText(spec); } spec.title = text; spec.titleStyle = DrawMlText.defaultStyle(t.getTxPr(), colors, colors.minorFontName(), 14, new Color(0x59, 0x59, 0x59)); } + /** Автозаголовок Office (§2.1.1561(a)): одиночный ряд с именем → имя ряда, + * иначе локализованный плейсхолдер. Круговые — частный случай, не отдельное правило. */ + private static String autoTitleText(ChartSpec spec) { + if (spec.series.size() == SINGLE_SERIES) { + String name = spec.series.get(0).name; + if (name != null && !name.isBlank()) { + return name; + } + } + return AUTO_TITLE; + } + private static AxisSpec readAxis(Object ax, DrawMlColor colors) { AxisSpec a = new AxisSpec(); CTScaling scaling; diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/ChartSpecTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/ChartSpecTest.java index b59c16b..9401745 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/ChartSpecTest.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/ChartSpecTest.java @@ -135,8 +135,10 @@ class ChartSpecTest { assertEquals("Продажи", spec.title); } + /** MS-OI29500 §2.1.1431(a): при наличии c:title флаг autoTitleDeleted + * игнорируется — пустой заголовок получает автозаголовок (плейсхолдер). */ @Test - void deletedAutoTitleLeavesChartWithoutTitle() { + void emptyTitleWithDeletedFlag_placeholderShown() { ChartSpec spec = new ChartSpec(); spec.type = ChartSpec.Type.LINE; CTChart chart = emptyTitleChart(); @@ -144,14 +146,27 @@ class ChartSpecTest { deleted.setVal(Boolean.TRUE); chart.setAutoTitleDeleted(deleted); ChartSpec.readTitle(chart, spec, new DrawMlColor(null)); + assertEquals(ChartSpec.AUTO_TITLE, spec.title, + "флаг применяется только при отсутствии c:title"); + } + + /** c:title отсутствует + autoTitleDeleted=true — автозаголовок удалён, заголовка нет. */ + @Test + void noTitleElement_deleted_noTitle() { + ChartSpec spec = new ChartSpec(); + CTChart chart = new CTChart(); + CTBoolean deleted = new CTBoolean(); + deleted.setVal(Boolean.TRUE); + chart.setAutoTitleDeleted(deleted); + ChartSpec.readTitle(chart, spec, new DrawMlColor(null)); assertNull(spec.title); } - /** c:autoTitleDeleted=true скрывает заголовок целиком, включая явный - * текст (§21.2.2.7): устаревший "Chart Title" из чужого шаблона, где - * Word его не показывает, не должен появляться и у нас. */ + /** MS-OI29500 §2.1.1431(a): в Office autoTitleDeleted применяется только + * когда c:title отсутствует — явный текст показывается при любом флаге + * (устаревший "Chart Title" из чужого шаблона Word рисует, и мы рисуем). */ @Test - void deletedTitleWithText_notShown() { + void deletedTitleWithText_stillShown() { ChartSpec spec = new ChartSpec(); spec.type = ChartSpec.Type.BAR; CTChart chart = emptyTitleChart(); @@ -162,13 +177,14 @@ class ChartSpecTest { tx.setStrRef(strRef("Chart Title")); chart.getTitle().setTx(tx); ChartSpec.readTitle(chart, spec, new DrawMlColor(null)); - assertNull(spec.title, "удалённый автозаголовок — явный текст не показывается"); - assertNull(spec.titleStyle, "и начертание тоже"); + assertEquals("Chart Title", spec.title, "при наличии c:title флаг не применяется"); + assertNotNull(spec.titleStyle); } - /** c:autoTitleDeleted без c:val — по умолчанию true (§21.2.2.7). */ + /** c:autoTitleDeleted без c:val — по умолчанию true (§21.2.2.7), но при + * наличии c:title флаг игнорируется (MS-OI29500 §2.1.1431(a)). */ @Test - void deletedTitleValOmitted_notShown() { + void deletedTitleValOmitted_stillShown() { ChartSpec spec = new ChartSpec(); spec.type = ChartSpec.Type.BAR; CTChart chart = emptyTitleChart(); @@ -177,11 +193,54 @@ class ChartSpecTest { tx.setStrRef(strRef("Главный")); chart.getTitle().setTx(tx); ChartSpec.readTitle(chart, spec, new DrawMlColor(null)); - assertNull(spec.title, "val опущен — заголовок считается удалённым"); + assertEquals("Главный", spec.title, "val опущен, но c:title есть — показывается"); } - /** Автозаголовок из имени ряда — только у круговой диаграммы с одним - * рядом; многорядовая кольцевая получает плейсхолдер, а не имя первого. */ + /** MS-OI29500 §2.1.1561(a): автозаголовок = имя единственного ряда для + * ЛЮБОГО типа графика, не только кругового — пустой c:title у столбчатой + * с одним рядом даёт имя ряда, а не плейсхолдер. Регрессия симптома + * «в PDF Название диаграммы, в Word — имя ряда». */ + @Test + void emptyTitleSingleSeriesBar_usesSeriesName() { + ChartSpec spec = new ChartSpec(); + spec.type = ChartSpec.Type.BAR; + ChartSpec.Series s = new ChartSpec.Series(); + s.name = "Продажи"; + spec.series.add(s); + ChartSpec.readTitle(emptyTitleChart(), spec, new DrawMlColor(null)); + assertEquals("Продажи", spec.title); + } + + /** c:title отсутствует + autoTitleDeleted=false — автозаголовок не удалён + * и рисуется: имя единственного ряда либо плейсхолдер (§2.1.1431(a)). */ + @Test + void noTitleElement_autoTitleKept_seriesName() { + ChartSpec spec = new ChartSpec(); + CTChart chart = new CTChart(); + CTBoolean keep = new CTBoolean(); + keep.setVal(Boolean.FALSE); + chart.setAutoTitleDeleted(keep); + ChartSpec.Series s = new ChartSpec.Series(); + s.name = "Продажи"; + spec.series.add(s); + ChartSpec.readTitle(chart, spec, new DrawMlColor(null)); + assertEquals("Продажи", spec.title); + assertNotNull(spec.titleStyle); + } + + @Test + void noTitleElement_autoTitleKept_placeholder() { + ChartSpec spec = new ChartSpec(); + CTChart chart = new CTChart(); + CTBoolean keep = new CTBoolean(); + keep.setVal(Boolean.FALSE); + chart.setAutoTitleDeleted(keep); + ChartSpec.readTitle(chart, spec, new DrawMlColor(null)); + assertEquals(ChartSpec.AUTO_TITLE, spec.title, "рядов нет — плейсхолдер"); + } + + /** Автозаголовок из имени ряда — только при ОДНОМ ряде (§2.1.1561(a)); + * многорядовая кольцевая получает плейсхолдер, а не имя первого. */ @Test void multiSeriesDoughnut_placeholderNotSeriesName() { ChartSpec spec = new ChartSpec(); @@ -1176,9 +1235,10 @@ class ChartSpecTest { assertEquals(ChartSpec.AUTO_TITLE, spec.title); } - /** Пустой заголовок круговой диаграммы без рядов — плейсхолдер; ряд без имени — заголовка нет. */ + /** Пустой заголовок без рядов — плейсхолдер; одиночный ряд без имени — тоже + * плейсхолдер (исключение §2.1.1561(a) требует «single series with a name»). */ @Test - void circularAutoTitleEdgeCases() { + void autoTitleEdgeCases() { ChartSpec doughnut = new ChartSpec(); doughnut.type = ChartSpec.Type.DOUGHNUT; ChartSpec.readTitle(emptyTitleChart(), doughnut, new DrawMlColor(null)); @@ -1188,7 +1248,15 @@ class ChartSpecTest { pie.type = ChartSpec.Type.PIE; pie.series.add(new ChartSpec.Series()); ChartSpec.readTitle(emptyTitleChart(), pie, new DrawMlColor(null)); - assertNull(pie.title, "ряд без имени — заголовок не ставится"); + assertEquals(ChartSpec.AUTO_TITLE, pie.title, "ряд без имени — плейсхолдер"); + + ChartSpec bar = new ChartSpec(); + bar.type = ChartSpec.Type.BAR; + ChartSpec.Series blank = new ChartSpec.Series(); + blank.name = " "; + bar.series.add(blank); + ChartSpec.readTitle(emptyTitleChart(), bar, new DrawMlColor(null)); + assertEquals(ChartSpec.AUTO_TITLE, bar.title, "пробельное имя ряда — плейсхолдер"); } /** c:catAx разбирается полностью; c:valAx без c:numFmt — General; dateAx со своим numFmt. */