Аудит раскладки ECMA-376: jc start/end, вендорный docx2fo.xslt с патчем w:position #68

Merged
pjandro merged 2 commits from layout-ecma376 into main 2026-10-28 01:27:06 +03:00
Collaborator

Аудит раскладки по ECMA-376 Part 1

Исправлено

  • w:jc val="start"/"end" — StrictOoxmlNormalizer переименовывает всегда (Part 1 §17.3.1.13: end — правовыравнивание в LTR; ST_Jc §17.18.44). До фикса jc="end" рендерился по левому краю (docx4j Justification.setXslFO не знает END).
  • w:rPr/w:position (полупункты, поднимает — Part 1 §17.3.2.24) — AUDIT-FIX-патч в вендорном wordpdf-core/src/main/resources/xslt/docx2fo.xslt → baseline-shift; docx4j position игнорировал. Дрейф-гейт vendoredXsltTracksJarCopy: побайтовое сравнение вендорной копии со стилистом jar'а после возврата патч-региона к исходному createBlockForRPr.
  • Патч jc="distribute" → text-align/text-align-last пробован и откачен (см. ниже).

Не исправлено (ограничения FOP/docx4j, Java-слой)

  • distribute рендерится как left: ST_Jc §17.18.44 — distribute это межсимвольный разнос, justify только межсловный; FOP не растягивает последнюю строку блока; свойства text-align-last в форке нет (в docx4j-fo-renderer отсутствуют классы TextAlign*).
  • w:suff (nothing/space) и w:lvlJc игнорируются — numbering-лейбл всегда через hanging-tab.
  • Левый padding ячейки таблицы не применяется к тексту (текст на leading edge таблицы, рамка уезжает влево на padding) — Java TableWriter.
  • w:tblInd при jc≠left игнорируется (буквально по Part 1 §17.4.50; Word не игнорирует — MS-OI29500 §2.1.155).
  • lineRule="auto": docx4j считает (line/240)×внутренний single ≈13.43pt@11pt (Word ≈13.9pt), абзац без w:line — natural-высота FOP 15.44pt; два «single» в конвертере.
  • Кернинг применяется без порога w:kern.

Не покрыто аудитом

Колонтитуки и весь §17.10 (нумерация страниц, PAGE/NUMPAGES — только FieldNormalizer), RTL/bidi (§17.15), многостраничные таблицы, картинки/плавающие объекты (§17.3.3+), наследование стилей styles.xml, нумерация шире проверенной матрицы, chart/SmartArt (отдельный движок), print scaling.

Тесты: 539 (core 497 + app 42), mvn clean verify зелёный.

## Аудит раскладки по ECMA-376 Part 1 ### Исправлено - `w:jc val="start"/"end"` — `StrictOoxmlNormalizer` переименовывает **всегда** (Part 1 §17.3.1.13: `end` — правовыравнивание в LTR; ST_Jc §17.18.44). До фикса `jc="end"` рендерился по левому краю (docx4j `Justification.setXslFO` не знает END). - `w:rPr/w:position` (полупункты, поднимает — Part 1 §17.3.2.24) — AUDIT-FIX-патч в вендорном `wordpdf-core/src/main/resources/xslt/docx2fo.xslt` → `baseline-shift`; docx4j position игнорировал. Дрейф-гейт `vendoredXsltTracksJarCopy`: побайтовое сравнение вендорной копии со стилистом jar'а после возврата патч-региона к исходному `createBlockForRPr`. - Патч `jc="distribute"` → `text-align`/`text-align-last` пробован и **откачен** (см. ниже). ### Не исправлено (ограничения FOP/docx4j, Java-слой) - `distribute` рендерится как left: ST_Jc §17.18.44 — distribute это меж**символьный** разнос, justify только межсловный; FOP не растягивает последнюю строку блока; свойства `text-align-last` в форке нет (в docx4j-fo-renderer отсутствуют классы `TextAlign*`). - `w:suff` (nothing/space) и `w:lvlJc` игнорируются — numbering-лейбл всегда через hanging-tab. - Левый padding ячейки таблицы не применяется к тексту (текст на leading edge таблицы, рамка уезжает влево на padding) — Java `TableWriter`. - `w:tblInd` при `jc`≠left игнорируется (буквально по Part 1 §17.4.50; Word не игнорирует — MS-OI29500 §2.1.155). - `lineRule="auto"`: docx4j считает (line/240)×внутренний single ≈13.43pt@11pt (Word ≈13.9pt), абзац без `w:line` — natural-высота FOP 15.44pt; два «single» в конвертере. - Кернинг применяется без порога `w:kern`. ### Не покрыто аудитом Колонтитуки и весь §17.10 (нумерация страниц, PAGE/NUMPAGES — только `FieldNormalizer`), RTL/bidi (§17.15), многостраничные таблицы, картинки/плавающие объекты (§17.3.3+), наследование стилей `styles.xml`, нумерация шире проверенной матрицы, chart/SmartArt (отдельный движок), print scaling. Тесты: 539 (core 497 + app 42), `mvn clean verify` зелёный.
ai added 1 commit 2026-10-27 04:58:08 +03:00
- StrictOoxmlNormalizer: w:jc val=start/end переименовывается и в
  transitional (docx4j Justification.setXslFO дропает END без
  fo:text-align — jc=end рендерился по левому краю; Part 4 §14.11.2)
- вендорный xslt/docx2fo.xslt = копия docx4j-export-fo + AUDIT-FIX
  (w:rPr/w:position -> baseline-shift, §17.3.2.24); WordPdfConverter
  инжектит предкомпилированный Templates (шаг 4.5)
- дрейф-гейт vendoredXsltTracksJarCopy (SHA-256 стилиста из jar'а)
- регрессии jcEndTransitional_rightAligned, rPrPosition_raisesBaseline
- AGENTS.md: шаг 4.5, инвариант стилиста, ограничения из аудита
  (distribute/suff/lvlJc/tblInd/auto-line-height/kern)

Покрытие (JaCoCo)

Модуль Строки Ветви Порог строк
wordpdf-core 94.4% 85.0% 90%
wordpdf-app 93.4% 84.2% 90%
<!-- jacoco-coverage --> ## Покрытие (JaCoCo) | Модуль | Строки | Ветви | Порог строк | |---|---|---|---| | wordpdf-core | 94.4% | 85.0% | 90% | | wordpdf-app | 93.4% | 84.2% | 90% |
ai added 1 commit 2026-10-27 05:05:11 +03:00
Аудит раскладки: правки ревью — цитаты ECMA Part 1, побайтный дрейф-гейт XSLT, тест дубля baseline-shift
PR checks / web (pull_request) Successful in 39s
PR checks / java (pull_request) Successful in 1m7s
Main: tests, deploy, autotests / web (push) Successful in 30s
Main: tests, deploy, autotests / java (push) Successful in 56s
Main: tests, deploy, autotests / images-web (push) Successful in 29s
Main: tests, deploy, autotests / images-app (push) Successful in 40s
Main: tests, deploy, autotests / deploy (push) Successful in 1m37s
Main: tests, deploy, autotests / autotests (push) Successful in 38s
Main: tests, deploy, autotests / rollback (push) Has been skipped
ddbd8f8fd9
- 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.
pjandro merged commit ddbd8f8fd9 into main 2026-10-28 01:27:06 +03:00
pjandro deleted branch layout-ecma376 2026-10-28 01:27:06 +03:00
Sign in to join this conversation.
No Reviewers
No Label
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: pjandro/java-word-pdf#68