- DrawingBridge: xdr-якоря two/one/absoluteCell (EMU-кумулятив по Metrics,
hidden=0; xdr:ext отличается от вложенного a:ext по namespace), inline-emit
в from-ячейку, clamp скрытых строк/колонок, fallback-абзацы в конец листа;
порог extent 22M EMU как DrawingPreRenderer
- xdr:pic → word/media/xlsx-imageN (as-is, тип по расширению); c:chart →
word/charts/xlsx-chartN.xml c сохранением graphicData — штатный шаг 3.5
дорисовывает PNG и ловит errorOnCharts (Kind.CHARTS, сквозной тест);
SmartArt/фигуры/внешние blip — пропуск+warn; theme1.xml → word/theme
(палитра для чартов); OLE — warn либо 422 по флагу
- юниты DrawingBridgeTest (8), пакетный тест эмита в cell+theme, PDF:
imageCount≥3/distinct≥2 на xlsx-chart-image, errorOnCharts→Kind.CHARTS
- PrintLayout: карта CT_PaperSize→twips (16 значений, вне карты — A4+warn),
landscape-swap, pageMargins in→twips; greedy-нарезка видимых колонок по
полезной ширине; fitToPage+fitToWidth=1 — один срез со сжатием ширин;
@scale без fitToPage — игнор+warn; вертикальные фрагменты по rowBreaks/@id
(обрывы за содержимым отбрасываются)
- SheetToTable.emit — список блоков (срез × фрагмент) с масштабом ширин;
XlsxToDocx — paragraph-level sectPr после каждого блока, секция последнего
блока — body-level sectPr (все листы скрыты — финальная A4-секция)
- фикстура xlsx-numfmt — Legal (sectionPerSheet); PDF-тесты: правый срез на
своей странице, разрыв после 12-й строки, fitToPage — одна landscape-страница,
MediaBox следует секции листа
- WarnOnce: литеральный NUL в исходнике заменён на '\0' (файл считался бинарным)
checkDocxContainer → checkOoxmlContainer (ContainerKind DOCX/XLSX по маркерам
wordprocessingml/spreadsheetml в [Content_Types].xml; новый текст 400 для zip
без обоих маркеров — контракт). isSpreadsheet — короткий скан манифеста.
checkPageCountXlsx: видимые листы (state, r:id, rel на существующую часть) +
rowBreaks/brk (§18.3.1.74), двупроходный zip. validate() роутирует XLSX на
xlsx-оценку; текст zip-подписи перечисляет .docx/.doc/.xlsx.
Общий сборщик docx-пакета для мостов .doc и (следующий шаг) .xlsx:
пакет internal, public record Part/write/storyPart, NAMESPACES + xmlns:c
(нужен xlsx-мосту для a:graphicData/c:chart). Механика не менялась.
DrawingPreRenderer.swapForPicture вставляет media-часть вручную
(newPartForContentType → setBinaryData → rels.addPart, имена
/word/media/chart-*): createImagePart писал temp-файл и декодировал
PNG обратно ради mime/размеров, которые нам и так известны.
ChartImageHandler (foSettings.setImageHandler) возвращает null из
compressedVariant для chart-* — «Compress Pictures» не ресемплит и не
декодирует наши 300-dpi растры; медиа документов остаются в штатном
docx4j-режиме. Замер (25 фикстур × 6 прогонов): chart-types.docx
657→507 МБ alloc (тёплый), суммарно 11640→10604 МБ, прочие 23 файла
±0%; ретеншн не изменился (144 MiB после GC), temp-файлов 0.
Регрессии: chartMedia_notDownsampled, DrawingPreRendererTest,
ChartImageHandlerTest.
- Правило 9 HiddenTextNormalizer: скрытые раны (прямой truthy w:vanish или
rStyle на vanish-стиль по цепочке w:basedOn) вырезаются до load() — Word
скрытое не печатает, стилист docx4j vanish не читает (скрытое утекало в PDF).
- Правило 10 RubyNormalizer: w:rubyBase/w:rubyBaseText разворачиваются,
w:rt/w:rubyPr/w:rubyAlign вырезаются — схема docx4j не биндит rubyBase/rt,
unmarshaller терял текст базы до XSLT (надстрочница — принятая деградация).
- AUDIT-FIX-2 в вендорном docx2fo.xslt: шаблоны w:moveFrom/w:moveTo/w:bdo/w:dir
(plain-text passthrough вместо catch-all); гейт vendoredXsltTracksJarCopy
обобщён на оба AUDIT-FIX-региона.
- Пиннинг работающих фич e2e-синтетикой: сноски/концевые, /URI-аннотации,
PAGEREF (complex + вложенный в TOC) и DATE (кэш заменяется живым), titlePg,
vMerge, block sdt, wps:txbx, OMML (пиксели), highlight/shd (фон рисуется —
прежняя запись в AGENTS.md о «fo:inline без фона» ошибочна, исправлена).
- AGENTS.md: правила 1–10, OLE=правило 11, инвентарь аудита, счётчики
(core 51/825, всего 57/868).
TTP-абзац каждой строки несёт свой sprmTDefTable; автомат использовал только
сетку первой строки → объединённая ячейка получала tcW первой колонки и
рендерилась пол-width с лишней вертикальной чертой в строке. Теперь rowXml
строит tcW/gridSpan из собственной сетки строки, согласованной с tblGrid
(ECMA-376 §17.4.65); при невыровненных границах — прежняя индексная выдача.
Регрессия — WordPdfConverterTest#docMergedTableRow_fullWidthNotSplit,
юниты — DocToDocxFormattingTest#mergedRow_gridSpanAndWidth,
#misalignedRow_fallsBackToColumnWidths.
Word выносит grpprl абзаца за FKP-страницу PAPX в Data-поток: одиночный
Prl sprmPHugePapx (0x6646) и цепочку sprmPTableProps (0x646B). Мост
читал сырой указатель → InTable/TTP/TAP терялись, строки таблиц с
huge-PAPX разваливались в плоские абзацы (жалоба на docTest.doc).
Новый класс PrcData.resolve(data, grpprl): union цепочки и исходных
Prl на позиции указателя; guard'ы (ptr за Data, cb вне [1, 0x3FA2],
цикл — бюджет 32 PrcData) — останов без исключения. Без указателей →
тот же массив. Отступление от §2.6.2 (обрыв за PTableProps) обязателен:
Word пишет после PTableProps легаси-зеркало с единственным TDefTable
(samples/ru-table-image.doc), а sprmTInsert из PrcData конвертер не
читает. Точка подключения единственная — DocxBody.buildRange.
Тесты: PrcDataTest (13 юнитов, byte[]-крафт), DocToDocxFormattingTest
#hugePapxRowMark_closesRowWithGridFromPrcData (POIFS-.doc, сетка из
цепочки). Живая проверка develop/docTest.doc: таблицы «Таблицы»
структурированы, фантомных рядов и плоских абзацев нет.
- 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 приведён в соответствие
- Кернинг: DejaVu Sans/Serif имеют legacy kern-таблицу, но она ключована
glyph id вне cmap (2568/2727 пар без Unicode-маппинга, A->V нет) — FOP
такие пары отбрасывает; замер конвейера: A->V = A->A и у Carlito, и у
DejaVu (7.524pt@11pt). Вывод «не кернит ни одно семейство» подтверждён,
причина «все шрифты GPOS-only» была неточна — исправлено в AGENTS.md
- «Word ≈13.9pt»: заявленное «пиксельное округление 18px@96dpi» —
нерепродуцируемая реконструкция (артефактов замера нет); переформулировано
в AGENTS.md, LayoutPostRenderer и WordPdfConverterTest
- Spec-ссылки: §17.3.1.13/§17.18.44/§17.3.2.24/§17.4.50 — Part 1, не Part 4
(AGENTS.md, StrictOoxmlNormalizer, вендорный XSLT, два тестовых javadoc);
- гейт vendoredXsltTracksJarCopy: вместо пин-хэша побайтовое сравнение вендорной
копии со стилистом jarа после возврата AUDIT-FIX-региона к исходному
createBlockForRPr — ловит и апгрейд docx4j, и правку копии вне патча;
- регрессия rPrPositionWithVertAlign_converts: position+vertAlign в одном ране
(дубль baseline-shift) не роняет конвертацию;
- AGENTS.md: причинность distribute без text-align-last (в форке нет TextAlign*),
два «single» в lineRule=auto, B2-отступление cellMar, MS-OI29500 §2.1.155 для
tblInd, команда перевендоринга docx2fo.xslt.
Парсер PMD 7.17 (движок maven-pmd-plugin 3.28.0) не разбирает
switch-выражение в аргументе super (pmd/pmd#6234) — при verify каждый
модуль давал PMD processing error (warning). Сообщения не меняются:
текст 422-контракта и ядра дословно прежние.
- c:autoTitleDeleted=true скрывает заголовок целиком, включая явный c:tx
(§21.2.2.7) — фантомный "Chart Title" из чужих шаблонов больше не рисуется;
- автозаголовок из имени ряда — только у круговой диаграммы с одним рядом,
многорядовая круговая получает плейсхолдер;
- несколько абзацев a:p в заголовке склеиваются через '\n' (жёсткий перенос),
а не внахлёст;
- 4 регрессии в ChartSpecTest (deletedTitleWithText_notShown,
deletedTitleValOmitted_notShown, multiSeriesDoughnut_placeholderNotSeriesName,
multiParagraphTitle_joinedWithNewlines).
Обход контента частей сузён до List<?> (он только читается; мутация идёт в gd.getAny()), хелпер cast удалён, invokeList возвращает List<?> через pattern matching — все три unchecked-подавления в main-коде больше не нужны.
DocxRewritePipeline применяет рерайты Strict→OnOff→Symbol→Field→Invisible→
GlyphCoverage к каждой записи word/*.xml за один проход zip; неизменённые
записи (медиа, rels) переносятся raw-копией сжатых байтов без inflate/deflate.
OleObjectNormalizer — два этапа: дешёвый детект по центральному каталогу
(читаются только [Content_Types].xml и word/*.xml), переупаковка только при
находке. PDF-буфер предразмеряется; нормализованная копия байтов перестаёт
читаться до FOP-рендера. Вывод на 13 фикстурах идентичен (текст + картинки),
531 тест без правок. Индивидуальные normalize() шести нормализаторов
сохранены (контракт юнит-тестов), в цепочке больше не вызываются.
surfaceChart (ECMA-376 §21.2.2.204) — «viewed from above, similar to 2-D
topographic maps»: заливочный режим вместо «торца» рисует топографическую
карту с залитыми полосами высот (fillBands — marching squares по ячейкам,
по одному пути на полосу — нет AA-шва на общих рёбрах), без изолиний и оси
значений; wireframe (§21.2.2.230) — без изменений геометрии. Маркеры
легенды полос следуют заливке: залитые при wireframe=false, полые при
wireframe=true (полосы не залиты нигде). Удалены drawContour/interp/yOf/
drawValueLabels/drawCategoryLabels и тест снятого вида торцом.
Регрессии — Surface2dPainterTest#filledContour_*,
ChartRendererTest#wireframeSurfaceLegend_hollowMarkers, фикстура
samples/chart-types.docx.
Word «Комбинированная» — несколько групп в одном c:plotArea (§21.2.2.145),
каждая со своими c:axId (§21.2.2.9); прежний ChartSpec хранил один type/
valAxis (last-wins) — побеждала последняя группа, столбцы рисовались линиями
по шкале вторичной оси.
- Series.renderAs/grouping/valAxis, AxisSpec.axId, ChartSpec.secondaryValAxis;
привязка групп к осям по c:axId в parse(), valAx/catAx first-wins,
тип combo = первая группа;
- CartesianPainter: семейства BAR/AREA/LINE, порядок отрисовки столбцы→линия,
масштаб каждой серии по своей оси, вторичная ось справа (линия+подписи),
накопление stacked внутри семейства;
- ChartRenderer: valueRange/stackedCumulative по подмножеству рядов,
легенда lineLike по renderAs ряда;
- фикстура chart-types.docx +combo (14 диаграмм), регрессии
ChartSpecTest#combo_*, CartesianPainterTest#combo_barsAndLineOnSecondary_bothDrawn.
- DrawMlText: фолбэк-семейство темы (minorFont без a:latin) алиасится через
BundledFontMapper.bundledFamily — раньше «Calibri» не находился в GlyphFont
и текст молча ехал в более широкий DejaVu Sans, из-за чего подписи
переносились и вылезали за фигуры (123@26pt: 49.6pt против бокса 39.7pt)
- DrawMlText: высота строки из a:lnSpc spcPct/spcPts (§21.1.2.4) — dsp-кэш
запекает, напр., 90%; хелпер totalHeight — высота после переносов
- SmartArtRenderer: autofit только normAutofit (§21.1.2.1.2/.3 — отсутствие
autofit-элемента имплицирует noAutofit); запечённый fontScale применяется,
без него — подбор кегля под перенесённый текст (низ 4pt); эвристика по
высоте одной строки удалена
- SmartArtRenderer: заполнитель dgm:prSet/@phldrT («[Текст]», §21.4.3.4) не
рисуется — элемент UI, в PDF Word его не показывает; render() без CTDataModel,
DrawingPreRenderer не резолвит dgm:relIds/@dm
Регрессии: DrawMlTextTest#fallbackFamilyAliasedToBundle,
#lineSpacingPct_compactsLines; SmartArtRendererTest#normAutofitShrinksToFit,
#missingAutofitKeepsDeclaredSize, #emptyTxBody_noPlaceholderInk.
mvn clean verify: 525 тестов зелёные, PMD + JaCoCo гейты пройдены.
w:object больше не выбрасывается целиком: w:drawing переиспользуется
дословно, v:imagedata r:id заменяется inline-DrawingML на ту же image-часть
(размер из style v:shape, иначе w:dxaOrig/w:dyaOrig); блоки w:control и без
плейсхолдера удаляются. Находка OLE — также разметка w:object без bin-части
(иначе NPE chunkType is null доходит до docx4j). oleObject-rels удаляются по
типу, включая TargetMode=External. Фикстура ole-embedded: битый рукописный
fallback.png (IDAT length 13 при 16 байтах) заменён на валидный — FOP падал
PNGImageDecoder. OLE-бинарники по-прежнему никогда не читаются.
StockPainter рисовал c:upBars/c:downBars только заливкой — белые up-столбцы
невидимы на белом фоне (Word обводит их контуром). Теперь столбец обводится:
цвет/ширина из c:spPr/a:ln (solidFill/@w), явный a:ln/a:noFill — без контура,
дефолт — чёрный 0.75pt. Регрессии: StockPainterTest#upDownBars_whiteFillBlackOutline,
ChartSpecTest#stockUpDownBarLinesParsed.
docx4j 17.3.2 требует ковариантный ZipArchiveInputStream.getNextEntry()
(>= 1.25.0); BOM/nearest-wins потребителя мог навязать старую версию —
конвертация падала NoSuchMethodError внутри docx4j. Теперь шаг 0
convertToStream бросает ConversionException с инструкцией; commons-compress
объявлена явной зависимостью ядра (1.28.0, версия docx4j); README —
закрепление версии в Maven/Gradle. Регрессия — DependencyGuardTest,
негативная ветка проверена подменой jar (1.21 → ConversionException).
- cachedPageCount: getElementText() на <Pages> с дочерним элементом бросает
IllegalStateException (не XMLStreamException) — теперь перехватывается,
кэш = 0, нижняя оценка по разрывам (был 400 на валидном .docx)
- Регрессия — WordPdfValidatorTest#cachedPagesUnreadableFallsBackToZero
- BundledFontsTest: @BeforeAll BundledFonts.init() — класс зелёный и при
запуске отдельно (реестр начертаний наполняется init())
Long.parseLong без try на a:srgbClr/@val из враждебной темы (val="zzzz")
бросил NumberFormatException из конструктора DrawMlColor → вся конвертация
500. Теперь null → baseOf/put/resolve штатно держат office-дефолт.
Регрессия — DrawMlColorTest#invalidSrgbHexFallsBackToOfficeDefault
Паттерн заякорен на открывающий тег (group 1 от '<' до w:val=, [^<>] не
пересекает границу тега): литеральный w:val="on" в тексте w:t больше не
переписывается. Регрессия — DocxOnOffNormalizerTest#onOffInTextNotTouched
- атрибуты w:start/w:end правятся только внутри открывающего тега и только при
отсутствии w:left/w:right в нём (transitional CT_Ind допускает обе пары —
глобальная замена давала дубль атрибута, не well-formed XML; литеральный
текст в w:t больше не правится)
- элементы w:start/w🔚 глобально только в strict-частях (URI purl.oclc.org);
в transitional — лишь в w:tcMar/w:tblCellMar без одноимённого left/right
- w:jc val=start/end правится только в strict (JcEnumeration docx4j содержит
START/END, FOP разрешает по направлению — рерайт ломал RTL); w:tab — всегда
(STTabJc 17.3.2 без start/end)
- ChartSpec.readAxis: не-конечные c:min/c:max/c:majorUnit отбрасываются (finite)
- ChartRenderer.axisBounds: санитайз данных + пересчёт шага по фактическому
интервалу — (hi-lo)/unit <= MAX_TICKS+1 при любых входах (вечный цикл делений);
warn вместо безмолвного default в switch типов
- DrawingPreRenderer: кап MAX_EXTENT_EMU на wp:extent (OOM-растр), детект
error-флагов до extent-guard, ловушка OutOfMemoryError в renderChart/renderDiagram,
очистка a:graphicData при раннем return в swapForPicture
- DrawMlText.wrapLines: инкрементальная ширина + экспоненциальный поиск границы
реза (O(L log L) вместо кубической деградации); рез теперь и для первого слова
c:wireframe val="1" (§21.2.2.230) рисовался линейной диаграммой «значение ×
категория» (ломаные рядов + вертикали) — неверная геометрия. Word рисует вид
сверху: X — категории, Y — ряды (серия 0 внизу), без заливок и оси значений;
только изолинии на внутренних границах полос высот lo+k·unit цветом полосы
ниже уровня (marching squares, седло — по среднему ячейки, узлы на уровне —
ребро-сегмент/дедупликация пересечений), сетка узлов catAx/serAx, рамка
области, подписи рядов со стороны serAx (axPos="r" — справа).
Фикстура chart-types.docx: +13-я диаграмма «Поверхность без заливки»
(4 ряда × 5 категорий «холмом», catAx/serAx с c:majorGridlines);
chartTypes_allTypesRenderAsImages — 13 растров. Surface2dPainterTest:
wireframe_gridOnly удалён (пинил снятое поведение), +4 рендер-теста
изолиний + 5 юнитов cellSegments. AGENTS.md синхронизирован.
Word пишет всем рядам шаблона Open-High-Low-Close <a:ln><a:noFill/></a:ln> —
ранее StockPainter рисовал ломаную каждого ряда безусловно, из-за чего между
столбцами upDownBars появлялись зигзаг-полоски. Флаг ChartSpec.Series.lineNoFill
теперь учитывается при отрисовке; dropLines и маркеры — по своим флагам.
Регрессия — StockPainterTest#seriesLineNoFill_notDrawn.
ChartSpec читает c:grouping у CTBarChart; CartesianPainter применяет
накопление к BAR/BAR_HORIZONTAL (обе ориентации, barDir=col/bar): один
столбец на категорию, сегмент ряда от cum[si-1] до cum[si], ширина по
c:gapWidth, c:overlap к stacked не применяется. percentStacked поддержан
общими хелперами stackedCumulative/stackedRange.
Регрессии: ChartSpecTest#barGroupingParsed,
CartesianPainterTest#stackedBar_seriesStackCumulatively,
CartesianPainterTest#stackedBarHorizontal_seriesStackCumulatively;
фикстура chart-types.docx дополнена 12-й диаграммой (barDir=bar,
stacked), WordPdfConverterTest#chartTypes_allTypesRenderAsImages — 12 PNG.
- ChartSpec: чтение c:grouping у CTLineChart (line3D осознанно игнорирует)
- CartesianPainter (LINE): кумулятивный диапазон оси и ломаные по stackedCumulative; percentStacked — нормировка к 100
- хелперы isStacked/stackedCumulative/stackedRange переехали из Cartesian3dPainter в ChartRenderer (общие для 2-D и 3-D)
- фикстура chart-types.docx: +10-я диаграмма «График с накоплением»; тест переименован в chartTypes_allTypesRenderAsImages (чинит 14 stale-javadoc-ссылок), assertEquals(10, …)
- юниты ChartSpecTest/ChartRendererTest + пиксельные CartesianPainterTest (инверсия порядка линий stacked vs standard; плоский верх 100% в percentStacked)