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: таблицы «Таблицы»
структурированы, фантомных рядов и плоских абзацев нет.
- контракт нормализаторов: STEP у 8 rewrite-нормализаторов, у OleObjectNormalizer нет (лямбда в normalizers())
- число тестов: 582 @Test (core 540, было 537)
- job deploy: подсеть прода 10.112.0.0/24, бинд gateway 127.0.0.1+$DEPLOY_HOST:9010, resolver 10.112.0.1
- compose.yml: springdoc выключен env-переменными (в dev — включён)
- main.yml: проверка Variables (включая новую PIP_INDEX_URL) — до Setup venv (fail-closed);
pip install только с индекса Nexus (-i), PIP_TRUSTED_HOST вырезается из URL,
--timeout 60 --retries 5 на холодный промах прокси
- GITEA-vars.md: Variable PIP_INDEX_URL + раздел «Nexus: pypi-proxy» (репозиторий,
роль pypi-anonymous, Anonymous User Role IDs) — заводятся до мержа
- AGENTS.md: PIP_INDEX_URL в перечень Variables
- 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.
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.
- 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).
Корневой mise.toml пинит java temurin-17, maven 3.9.16, node 24, python 3.15
и задачи (verify/app-package/app-run/web-*/prod-tests); bootstrap.sh/.ps1
скачивают mise v2026.10.19 в ./.mise/bin (gitignored, вне системы); обёртки
mise.sh/.ps1 зовут его без PATH/активации шелла. prod-autotests/mise.toml
удалён — дубль корневого (venv тем же путём). AGENTS.md синхронизирован.
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 синхронизирован.
- 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)
upload-artifact@v4 не поддерживается, @v3 на этом стенде висит на загрузке
(run 508 — 153 файла, run 509 — один zip; оба отменены в полёте). Вместо
артефактов: Coverage summary пишет coverage-summary.md (он же в step
summary), Comment coverage on PR постит/обновляет комментарий в PR по
маркеру <!-- jacoco-coverage --> (continue-on-error). Шаг продублирован в
main.yml байт-в-байт, там if не срабатывает. HTML — локально
target/site/jacoco.
docx4j падает на внедрённых OLE-объектах двумя путями: JAXB-парсинг
бинарника под ложным XML-типом в [Content_Types] («Content is not
allowed in prolog» → NPE) и NPE chunkType is null в VML-сериализации
w:object. Новый OleObjectNormalizer (шестой в цепочке, после
GlyphCoverageNormalizer) удаляет OLE-bin-части, rels-ссылки, элементы
w:object и Override удалённых частей; при errorOnOle=true вместо
удаления — DrawingFoundException(OLE) → 422 «Конвертация отменена: в
документе найдены OLE-объекты».
- ядро: Kind.OLE, ConvertOptions.errorOnOle, WordPdfSettings.ERROR_ON_OLE,
фикстура samples/ole-embedded.docx (ручная, оба механизма)
- app: параметр errorOnOle, 422-контракт, тесты errorFlagOle_rejected /
oleObjects_removedByDefault
- SPA: третий переключатель «OLE-объекты»
- прод-автотесты: +2 проверки (21)
- регрессии: OleObjectNormalizerTest ↔ oleObjects_removedAndConverted /
drawingErrors_errorFlagRejectsOle; E2E: notConverted.docx 500 → 200
- pmd-ruleset.xml: ReturnEmptyCollectionRatherThanNull (p1),
AvoidLiteralsInIfCondition (p3), EmptyCatchBlock (p2),
ForLoopCanBeForeach (p2)
- main: split/contentOf/invokeList возвращают List.of() вместо null;
литералы в условиях if вынесены в именованные константы
(9 файлов chart/валидатора); индексный цикл легенды → foreach
- src/test: 8 литералов в условиях if — те же именованные константы
- AGENTS.md: описание ruleset'а и гейта обновлено
mvn clean verify зелёный, 0 нарушений PMD.
Прод-хост не хранит ни конфигов, ни секретов: docker-compose.yml и nginx.conf
генерируются job deploy на каждый деплой (новые Variables WORDPDF_PORT/
PROD_SUBNET/PROD_GW вместо литералов в yml), API-ключ подаётся окружением и на
диск не пишется; restart.sh и .env удаляются как наследие ручного setup.
Healthcheck app — wget (alpine-jre образ curl не содержит: curl-хелсчек давал
вечный unhealthy и висящий up, run 479). Gateway пересоздаётся, а не рестартует.
Rollback — retag из .rollback.env + пересоздание app/web/gateway.
После ухода с java.awt.Font рантайму не нужны ни fontconfig, ни системные
шрифты, ни утилиты из apt: chart-движку достаточно модуля java.desktop
(Graphics2D), который есть и в musl-сборке temurin 21-jre-alpine (проверено
на стенде без libfontconfig.so и /etc/fonts: конвертация charts-smartart.docx
-> PDF 466357 байт, байт-в-байт с Debian-стендом).
- Containerfile: FROM eclipse-temurin:21-jre-alpine, HEALTHCHECK на busybox
wget (есть в alpine из коробки) — apt-get install curl удалён вместе
с уровнем apt-кэша; adduser -S -D -H -u 10001 (non-root как раньше)
- compose.yml / compose.dev.yml: явные healthcheck app дублируют
Containerfile — переведены с curl на wget (curl в образе больше нет)
- AGENTS.md: строка Containerfile/compose обновлена
Проверено: podman build -> образ 280 МБ (база 209 МБ против 333 МБ полного
jre); smoke образа — health UP, uid 10001, wget есть/curl нет, конвертация
через :18080 -> %PDF-1.4 466357 байт; полный dev-стенд compose.dev.yml —
app/web healthy (wget-хелсчек), gateway поднялся по depends_on,
конвертация через :9011 -> тот же PDF.
На OpenJDK/Linux любое обращение к java.awt.Font требует fontconfig-нативки
(Fontconfig head is null на хосте без libfontconfig). java.awt.Font убран из
всего рантайм-пути: текст chart-движка (DrawMlText) и проверка покрытия глифов
(GlyphCoverageNormalizer) переведены на GlyphFont — чистый Java-парсер TTF
org.apache.pdfbox:fontbox 3.0.8 (compile; commons-logging исключён,
единственный провайдер jcl-over-slf4j). Метрики совпадают с AWT до 4-го знака,
кернинг-дрейф 0.0000 (DejaVu Sans, Carlito). AWT остаётся только как геометрия
(Graphics2D/Path2D), которая fontconfig не требует.
- GlyphFont: of/canDisplay/advance/ascent/descent/leading/draw; TTF читается
напрямую из classpath, не зависит от BundledFonts.init(); битый бандл падает
IllegalStateException, отсутствующее семейство/начертание -> null
- DrawMlText.fontFor: цепочка фолбэка family/variant -> family/regular ->
fallback/variant -> fallback/regular (bold у Noto остаётся своим regular)
- BundledFonts: awtFont/AWT_FONTS удалены (чистый cutover), CLASSPATH_DIR ->
package-private
- ChartRenderer.measureLegend: убран неиспользуемый после cutover параметр g (PMD)
- GlyphFontTest (6 юнитов) без единого java.awt.Font — обязан проходить на хосте
без fontconfig; Containerfile/AGENTS.md: fontconfig рантайму не нужен
Проверено: mvn clean verify локально (153 теста, PMD); приёмочный стенд —
контейнер без libfontconfig.so и /etc/fonts: mvn verify BUILD SUCCESS и
java -jar + конвертация charts-smartart.docx -> PDF 466 КБ с 4 растрами
(деградации нет).