FOP-оверлей ru.pjandro + правило 9: w:jc=distribute растягивает все строки #101

Closed
ai wants to merge 9 commits from fop-overlay-integration into main
Collaborator

Стек: основан на ветке PR #100 (docx4j 17.3.6) — после мержа #100 дифф схлопнется до двух коммитов этого PR.

build(core) — подключение собственного FOP-оверлея ru.pjandro:docx4j-fo-renderer-core:2.12-docx4j.1-pj.2 (форк docx4j-fo-renderer-core 2.12-docx4j.1 = FOP 2.12 + word-layout, репо ai/xmlgraphics-fop-pj, Nexus): exclusion центрального org.docx4j:docx4j-fo-renderer-core из docx4j-export-fo, тонкий docx4j-fo-renderer (маркер Docx4jFop) остаётся.

feat(core) — правило 12→9 DistributeStampNormalizer: w:jc="distribute" (Part 1 §17.18.44) раньше печатался по левому краю (docx4j Justification.setXslFO для DISTRIBUTE не эмитит ничего). Нормализатор ставит закладку-якорь pj-distribute-<часть>-<n> (content-части, после Hidden, идемпотентно), LayoutPostRenderer по якорю дописывает блоку пару text-align/text-align-last="justify" — межсловный разнос всех строк, включая последнюю. Паттерн якоря принимает и безпрефиксную сериализацию fo:inline (DOM-поддерево toNode). Пины: DistributeLineTestCase в форке, distribute_allLinesReachRightMargin + юниты здесь; фикстура samples/distribute.docx (хвост трёхсловный: одно слово растягивать нечем).

Доки: перенумерация правил (Ole → 10), шаг 4.25, секция «FOP-оверлей» в AGENTS, render-limitations: distribute перенесён в починенное (межсимвольный kashida не реализован).

Проверка: mvn clean verify — 852 core-теста + 48 app, PMD/JaCoCo зелёные.

Стек: основан на ветке PR #100 (docx4j 17.3.6) — после мержа #100 дифф схлопнется до двух коммитов этого PR. **build(core)** — подключение собственного FOP-оверлея `ru.pjandro:docx4j-fo-renderer-core:2.12-docx4j.1-pj.2` (форк docx4j-fo-renderer-core 2.12-docx4j.1 = FOP 2.12 + word-layout, репо ai/xmlgraphics-fop-pj, Nexus): exclusion центрального `org.docx4j:docx4j-fo-renderer-core` из `docx4j-export-fo`, тонкий `docx4j-fo-renderer` (маркер Docx4jFop) остаётся. **feat(core)** — правило 12→9 `DistributeStampNormalizer`: `w:jc="distribute"` (Part 1 §17.18.44) раньше печатался по левому краю (docx4j `Justification.setXslFO` для DISTRIBUTE не эмитит ничего). Нормализатор ставит закладку-якорь `pj-distribute-<часть>-<n>` (content-части, после Hidden, идемпотентно), `LayoutPostRenderer` по якорю дописывает блоку пару `text-align`/`text-align-last="justify"` — межсловный разнос всех строк, включая последнюю. Паттерн якоря принимает и безпрефиксную сериализацию `fo:inline` (DOM-поддерево `toNode`). Пины: `DistributeLineTestCase` в форке, `distribute_allLinesReachRightMargin` + юниты здесь; фикстура `samples/distribute.docx` (хвост трёхсловный: одно слово растягивать нечем). Доки: перенумерация правил (Ole → 10), шаг 4.25, секция «FOP-оверлей» в AGENTS, render-limitations: distribute перенесён в починенное (межсимвольный kashida не реализован). Проверка: `mvn clean verify` — 852 core-теста + 48 app, PMD/JaCoCo зелёные.
ai added 6 commits 2026-11-09 02:19:51 +03:00
test(core): ветки мусорных заголовков растров и null-гейдов валидатора
PR checks / web (pull_request) Successful in 41s
PR checks / java (pull_request) Successful in 1m45s
cbd4742a96
Удаление правил Symbol/Field (делает сам экспорт 17.3.x) убрало два
хорошо покрытых класса и просадил branch-coverage 0.8505 → 0.8487 под
гейт JaCoCo 0.85. Добавлены тесты задокументированных, но не покрытых
веток WordPdfValidator#rasterArea (битые сигнатуры PNG/BMP по байтно,
короткие заголовки, JPEG: нет FFD8, мусор-маркер, обход DHT/C8/CC и
нетелевых RST/TEM, SOF0 без телеги) и null-контрактов
validate/checkPageCountDoc/isBinaryDoc. Регрессия —
WordPdfValidatorTest#validate_rasterGarbageHeadsAccepted,
#nullGuards_rejectBeforeWork, #validate_nullOptions_rejected.
Exclusion org.docx4j:docx4j-fo-renderer-core из docx4j-export-fo + зависимость
на собственный форк (word-layout менеджеры: label-align, line-box, tab-транспорт,
distribute-пин); тонкий docx4j-fo-renderer с маркером Docx4jFop остаётся.
Версия — fop-overlay.version в корневом dependencyManagement.
feat(core): правило 9 DistributeStampNormalizer - w:jc=distribute растягивает все строки (Part 1 17.18.44)
PR checks / web (pull_request) Successful in 51s
PR checks / java (pull_request) Failing after 1m3s
838ec29a69
docx4j для DISTRIBUTE не эмитит в FO ничего - абзац печатался по левому краю.
Нормализатор ставит в distribute-абзацы закладку-якорь pj-distribute-<часть>-<n>
(после Hidden, content-части, идемпотентно), LayoutPostRenderer по якорю дописывает
блоку пару text-align/text-align-last=justify - межсловный разнос всех строк,
включая последнюю (пин форка DistributeLineTestCase). Паттерн якоря принимает и
префиксную, и безпрефиксную сериализацию fo:inline (DOM-поддерево toNode).
Фикстура distribute.docx (хвост трёхсловный - одно слово растягивать нечем),
регрессии distribute_allLinesReachRightMargin + юниты нормализатора и фильтра.

Доки: правила 1-9 (Ole - правило 10), шаг 4.25, FOP-оверлей в инвариантах и
новая секция AGENTS; render-limitations - distribute перенесён в починенное.
Дополнительно в AGENTS: заметки про гейт готовности podman-контейнеров.

Покрытие (JaCoCo)

Модуль Строки Ветви Порог строк
wordpdf-core нет данных — 90%
wordpdf-app нет данных — 90%
<!-- jacoco-coverage --> ## Покрытие (JaCoCo) | Модуль | Строки | Ветви | Порог строк | |---|---|---|---| | wordpdf-core | нет данных | — | 90% | | wordpdf-app | нет данных | — | 90% |
ai added 1 commit 2026-11-09 02:50:39 +03:00
- DistributeStampNormalizer: pPr ищется как первый ребёнок w:p (S17.3.1.23,
  O(1) вместо неограниченного indexOf по хвосту части); окно jc режется
  началом w:pPrChange - старое значение реvision больше не штампуется и не
  маскируется; вставка - после НАРУЖНОГО </w:pPr> (lastIndexOf от конца
  абзаца), идемпотентность позиционная (чужая закладка Word сразу после pPr
  больше не считается штампом);
- штампуется word/headerN.xml / word/footerN.xml (якорь работает и в
  колонтитулах; .rels отсекаются);
- юниты: реvision-only jc, вложенный pPr в реvision, чужая закладка,
  header/footer, pretty-print; LayoutPostRendererTest: якорь внутри
  fo:static-content;
- проба опровергла двойной разделитель suff=space (TP-поток «1.·ITEM») -
  зафиксировано в javadoc правила 6;
- нумерация правил сведена к docs (Distribute=9, OLE=10): код/тесты 12->9,
  README 8/9->9/10, doc-bridge 9->7, xslt-комментарий внутри AUDIT-FIX-2
  10->8 (гейт побайтной копии не затронут);
- GITEA-vars.md: MAVEN_MIRROR_URL = group maven-public (иначе CI не
  резолвит ru.pjandro-оверлей через mirrorOf=*); render-limitations:
  замер framePr - 180pt от КРАЯ страницы при hAnchor=page; счётчики
  58/906.

mvn clean verify зелёные (core 858 + app 48; артефакт форка докачан
через maven-public при пустом кэше).
ai added 1 commit 2026-11-09 02:51:34 +03:00
docs: счётчики 58/906 (core 52/858, WordPdfConverterTest 83) - догнаны после ревью-юнитов
PR checks / web (pull_request) Successful in 43s
PR checks / java (pull_request) Failing after 1m0s
19300ac640
ai added 1 commit 2026-11-09 02:51:51 +03:00
docs: счётчик фикстур 14 docx (+distribute.docx)
PR checks / web (pull_request) Successful in 42s
PR checks / java (pull_request) Failing after 55s
7b9fdf783d
pjandro closed this pull request 2026-11-10 01:23:58 +03:00
Some checks are pending
PR checks / web (pull_request) Successful in 42s
PR checks / java (pull_request) Failing after 55s

Pull request closed

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#101