chart: заголовок по MS-OI29500 — автозаголовок из имени ряда для любого типа, autoTitleDeleted только при отсутствии c:title
PR checks / web (pull_request) Successful in 32s
PR checks / java (pull_request) Successful in 1m0s
Main: tests, deploy, autotests / web (push) Successful in 32s
Main: tests, deploy, autotests / java (push) Successful in 57s
Main: tests, deploy, autotests / images-web (push) Successful in 29s
Main: tests, deploy, autotests / images-app (push) Successful in 43s
Main: tests, deploy, autotests / deploy (push) Successful in 1m34s
Main: tests, deploy, autotests / autotests (push) Failing after 2m1s
Main: tests, deploy, autotests / rollback (push) Successful in 3m10s

- 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 приведён в соответствие
This commit was merged in pull request #70.
This commit is contained in:
Pjandro
2026-10-28 05:18:02 +00:00
parent 8de839f375
commit e929c6ade7
3 changed files with 123 additions and 44 deletions
+2 -2
View File
@@ -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/секции). Нормативный источник любых правок — 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` не рисуется). Пейнтеры: `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` (кэш `<Pages>1</Pages>` + 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`). - Фикстуры — закоммиченные `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` (кэш `<Pages>1</Pages>` + 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. - Юниты нормализаторов работают строками (`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` не даёт отдельного контекста). - 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 против живого прода. - 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 против живого прода.
@@ -79,6 +79,9 @@ final class ChartSpec {
* не определяет). */ * не определяет). */
static final String AUTO_TITLE = "Название диаграммы"; 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:pt/@idx}, ECMA-376 §21.2.2.150/.151) и
* счётчика ({@code c:ptCount}, §21.2.2.152): оба — ST_UnsignedInt без верхней * счётчика ({@code c:ptCount}, §21.2.2.152): оба — ST_UnsignedInt без верхней
@@ -900,23 +903,33 @@ final class ChartSpec {
/** /**
* Заголовок: явный текст (c:title/c:tx) или автозаголовок. * Заголовок: явный текст (c:title/c:tx) или автозаголовок.
* {@code c:autoTitleDeleted=true} скрывает заголовок целиком, включая * MS-OI29500 §2.1.1431(a): в Office {@code c:autoTitleDeleted}
* явный текст (ECMA-376 §21.2.2.7: «the title shall not be shown»; * (ECMA-376 §21.2.2.7, {@code val} опущен — default true) применяется
* атрибут {@code c:val} опущен — значение по умолчанию true). Пустой * ТОЛЬКО когда {@code c:title} у графика отсутствует — явный заголовок
* заголовок при autoTitleDeleted=0: у круговой диаграммы с одним рядом * показывается при любом флаге. Пустой/пробельный {@code c:title} —
* — имя ряда, иначе встроенный плейсхолдер (строка UI-языка Word). * автозаголовок Office (MS-OI29500 §2.1.1561(a)): одиночный ряд с именем
* → имя ряда (любой тип графика), иначе — локализованный плейсхолдер.
* Регрессии — ChartSpecTest#emptyTitleSingleSeriesBar_usesSeriesName,
* #deletedTitleWithText_stillShown.
*/ */
static void readTitle(CTChart chart, ChartSpec spec, DrawMlColor colors) { static void readTitle(CTChart chart, ChartSpec spec, DrawMlColor colors) {
CTTitle t = chart.getTitle(); CTTitle t = chart.getTitle();
// §21.2.2.7: val опущен — true.
boolean autoDeleted = chart.getAutoTitleDeleted() == null
|| chart.getAutoTitleDeleted().isVal();
if (t == null) { if (t == null) {
// §2.1.1431(a): флаг имеет смысл только при отсутствии c:title;
// val=0 — автозаголовок не удалён, он рисуется.
if (autoDeleted) {
return; return;
} }
// §21.2.2.7: удалённый автозаголовок не показывает заголовок ни при spec.title = autoTitleText(spec);
// каких условиях — в том числе явный c:tx (устаревший текст из чужих spec.titleStyle = DrawMlText.defaultStyle(null, colors,
// шаблонов, где Word его скрывает, у нас не должен появляться). colors.minorFontName(), 14, new Color(0x59, 0x59, 0x59));
if (chart.getAutoTitleDeleted() != null && chart.getAutoTitleDeleted().isVal()) {
return; return;
} }
// §2.1.1431(a): при наличии c:title Office игнорирует autoTitleDeleted —
// явный текст показывается всегда.
String text = null; String text = null;
CTTx tx = t.getTx(); CTTx tx = t.getTx();
if (tx != null) { if (tx != null) {
@@ -935,29 +948,27 @@ final class ChartSpec {
text = String.join("\n", paragraphs); text = String.join("\n", paragraphs);
} }
} }
// Пустой c:title при autoTitleDeleted=0 — это автозаголовок Word: // Пустой/пробельный c:title — автозаголовок Office (§2.1.1561(a)).
// у круговой диаграммы с ОДНИМ рядом он берётся из имени ряда
// (автозаголовок = имя единственного ряда), во всех остальных
// случаях рисуется встроенный плейсхолдер (в англ. эталоне Word —
// "Chart Title", у нас плейсхолдер русифицирован; в XML его нет,
// Word подставляет строку из своего UI-языка).
if (text == null || text.isBlank()) { if (text == null || text.isBlank()) {
boolean circular = spec.type == Type.PIE || spec.type == Type.PIE3D text = autoTitleText(spec);
|| 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;
} }
spec.title = text; spec.title = text;
spec.titleStyle = DrawMlText.defaultStyle(t.getTxPr(), colors, spec.titleStyle = DrawMlText.defaultStyle(t.getTxPr(), colors,
colors.minorFontName(), 14, new Color(0x59, 0x59, 0x59)); 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) { private static AxisSpec readAxis(Object ax, DrawMlColor colors) {
AxisSpec a = new AxisSpec(); AxisSpec a = new AxisSpec();
CTScaling scaling; CTScaling scaling;
@@ -135,8 +135,10 @@ class ChartSpecTest {
assertEquals("Продажи", spec.title); assertEquals("Продажи", spec.title);
} }
/** MS-OI29500 §2.1.1431(a): при наличии c:title флаг autoTitleDeleted
* игнорируется — пустой заголовок получает автозаголовок (плейсхолдер). */
@Test @Test
void deletedAutoTitleLeavesChartWithoutTitle() { void emptyTitleWithDeletedFlag_placeholderShown() {
ChartSpec spec = new ChartSpec(); ChartSpec spec = new ChartSpec();
spec.type = ChartSpec.Type.LINE; spec.type = ChartSpec.Type.LINE;
CTChart chart = emptyTitleChart(); CTChart chart = emptyTitleChart();
@@ -144,14 +146,27 @@ class ChartSpecTest {
deleted.setVal(Boolean.TRUE); deleted.setVal(Boolean.TRUE);
chart.setAutoTitleDeleted(deleted); chart.setAutoTitleDeleted(deleted);
ChartSpec.readTitle(chart, spec, new DrawMlColor(null)); 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); assertNull(spec.title);
} }
/** c:autoTitleDeleted=true скрывает заголовок целиком, включая явный /** MS-OI29500 §2.1.1431(a): в Office autoTitleDeleted применяется только
* текст (§21.2.2.7): устаревший "Chart Title" из чужого шаблона, где * когда c:title отсутствует — явный текст показывается при любом флаге
* Word его не показывает, не должен появляться и у нас. */ * (устаревший "Chart Title" из чужого шаблона Word рисует, и мы рисуем). */
@Test @Test
void deletedTitleWithText_notShown() { void deletedTitleWithText_stillShown() {
ChartSpec spec = new ChartSpec(); ChartSpec spec = new ChartSpec();
spec.type = ChartSpec.Type.BAR; spec.type = ChartSpec.Type.BAR;
CTChart chart = emptyTitleChart(); CTChart chart = emptyTitleChart();
@@ -162,13 +177,14 @@ class ChartSpecTest {
tx.setStrRef(strRef("Chart Title")); tx.setStrRef(strRef("Chart Title"));
chart.getTitle().setTx(tx); chart.getTitle().setTx(tx);
ChartSpec.readTitle(chart, spec, new DrawMlColor(null)); ChartSpec.readTitle(chart, spec, new DrawMlColor(null));
assertNull(spec.title, "удалённый автозаголовок — явный текст не показывается"); assertEquals("Chart Title", spec.title, "при наличии c:title флаг не применяется");
assertNull(spec.titleStyle, "и начертание тоже"); 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 @Test
void deletedTitleValOmitted_notShown() { void deletedTitleValOmitted_stillShown() {
ChartSpec spec = new ChartSpec(); ChartSpec spec = new ChartSpec();
spec.type = ChartSpec.Type.BAR; spec.type = ChartSpec.Type.BAR;
CTChart chart = emptyTitleChart(); CTChart chart = emptyTitleChart();
@@ -177,11 +193,54 @@ class ChartSpecTest {
tx.setStrRef(strRef("Главный")); tx.setStrRef(strRef("Главный"));
chart.getTitle().setTx(tx); chart.getTitle().setTx(tx);
ChartSpec.readTitle(chart, spec, new DrawMlColor(null)); 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 @Test
void multiSeriesDoughnut_placeholderNotSeriesName() { void multiSeriesDoughnut_placeholderNotSeriesName() {
ChartSpec spec = new ChartSpec(); ChartSpec spec = new ChartSpec();
@@ -1176,9 +1235,10 @@ class ChartSpecTest {
assertEquals(ChartSpec.AUTO_TITLE, spec.title); assertEquals(ChartSpec.AUTO_TITLE, spec.title);
} }
/** Пустой заголовок круговой диаграммы без рядов — плейсхолдер; ряд без имени — заголовка нет. */ /** Пустой заголовок без рядов — плейсхолдер; одиночный ряд без имени — тоже
* плейсхолдер (исключение §2.1.1561(a) требует «single series with a name»). */
@Test @Test
void circularAutoTitleEdgeCases() { void autoTitleEdgeCases() {
ChartSpec doughnut = new ChartSpec(); ChartSpec doughnut = new ChartSpec();
doughnut.type = ChartSpec.Type.DOUGHNUT; doughnut.type = ChartSpec.Type.DOUGHNUT;
ChartSpec.readTitle(emptyTitleChart(), doughnut, new DrawMlColor(null)); ChartSpec.readTitle(emptyTitleChart(), doughnut, new DrawMlColor(null));
@@ -1188,7 +1248,15 @@ class ChartSpecTest {
pie.type = ChartSpec.Type.PIE; pie.type = ChartSpec.Type.PIE;
pie.series.add(new ChartSpec.Series()); pie.series.add(new ChartSpec.Series());
ChartSpec.readTitle(emptyTitleChart(), pie, new DrawMlColor(null)); 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. */ /** c:catAx разбирается полностью; c:valAx без c:numFmt — General; dateAx со своим numFmt. */