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
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:
@@ -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;
|
||||||
|
}
|
||||||
|
spec.title = autoTitleText(spec);
|
||||||
|
spec.titleStyle = DrawMlText.defaultStyle(null, colors,
|
||||||
|
colors.minorFontName(), 14, new Color(0x59, 0x59, 0x59));
|
||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
// §21.2.2.7: удалённый автозаголовок не показывает заголовок ни при
|
// §2.1.1431(a): при наличии c:title Office игнорирует autoTitleDeleted —
|
||||||
// каких условиях — в том числе явный c:tx (устаревший текст из чужих
|
// явный текст показывается всегда.
|
||||||
// шаблонов, где Word его скрывает, у нас не должен появляться).
|
|
||||||
if (chart.getAutoTitleDeleted() != null && chart.getAutoTitleDeleted().isVal()) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
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. */
|
||||||
|
|||||||
Reference in New Issue
Block a user