Аудит раскладки: правки ревью — цитаты 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

- 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.
This commit was merged in pull request #68.
This commit is contained in:
Pjandro
2026-10-27 02:05:07 +00:00
parent 8cd6079170
commit ddbd8f8fd9
5 changed files with 53 additions and 28 deletions
@@ -702,7 +702,7 @@ class WordPdfConverterTest {
* w:jc val="end" в transitional-документе: docx4j Justification.setXslFO
* знает только left/center/right/both, для END {@code fo:text-align} не
* пишет вовсе — абзац рендерился по левому краю. StrictOoxmlNormalizer
* теперь переименовывает end→right всегда (Part 4 §14.11.2: right≡end).
* теперь переименовывает end→right всегда (Part 1 §17.3.1.13: end — правовыравнивание в LTR).
* Регрессия — аудит раскладки (матрица J2).
*/
@Test
@@ -735,34 +735,53 @@ class WordPdfConverterTest {
"w:position=8 должен поднимать базовую линию на 4pt");
}
/**
* w:position + w:vertAlign в одном ране: createBlockForRPr уже пишет
* baseline-shift для vertAlign — AUDIT-FIX-патч не должен породить дубль
* атрибута (некорректный FO роняет конвертацию целиком, а не один абзац).
*/
@Test
void rPrPositionWithVertAlign_converts() throws Exception {
byte[] docx = minimalDocx("<w:p>"
+ "<w:r><w:t>P</w:t></w:r>"
+ "<w:r><w:rPr><w:vertAlign w:val=\"superscript\"/>"
+ "<w:position w:val=\"8\"/></w:rPr><w:t>Q</w:t></w:r>"
+ "</w:p>");
Path pdf = convertPdf(docx, "t");
assertTrue(yOfMarker(pdf, 'Q') < yOfMarker(pdf, 'P'),
"Q поднят (vertAlign), конвертация жива");
}
/**
* Дрейф-гейт: вендорный xslt/docx2fo.xslt = копия
* org/docx4j/convert/out/fo/docx2fo.xslt из docx4j-export-fo +
* AUDIT-FIX-патч (w:rPr position). При апгрейде docx4j стилист jar'а
* меняется — тест заставляет перевендорить его и перенести патч.
* AUDIT-FIX-патч (w:rPr position). Возврат патч-региона к исходному
* вызову {@code createBlockForRPr} (взят из jar'а) обязан дать
* побайтовое равенство со стилистом jar'а — ловит и апгрейд docx4j,
* и случайную правку вендорной копии вне патча.
*/
@Test
void vendoredXsltTracksJarCopy() throws Exception {
try (InputStream jar = WordPdfConverterTest.class.getResourceAsStream(
String jar;
try (InputStream in = WordPdfConverterTest.class.getResourceAsStream(
"/org/docx4j/convert/out/fo/docx2fo.xslt")) {
assertNotNull(jar, "нет docx2fo.xslt в docx4j-export-fo");
java.security.MessageDigest digest =
java.security.MessageDigest.getInstance("SHA-256");
StringBuilder hex = new StringBuilder();
for (byte b : digest.digest(jar.readAllBytes())) {
hex.append(String.format("%02x", b));
}
assertEquals("cff420cb1bd7ad5d96211c16479db0f7d3a01fec4bf56d01d1bbc7ee4041dda7",
hex.toString(), "docx2fo.xslt в docx4j-export-fo изменился:"
+ " перевендорить xslt/docx2fo.xslt и перенести AUDIT-FIX-патч");
assertNotNull(in, "нет docx2fo.xslt в docx4j-export-fo");
jar = new String(in.readAllBytes(), StandardCharsets.UTF_8);
}
try (InputStream vendored = WordPdfConverterTest.class.getResourceAsStream(
"/xslt/docx2fo.xslt")) {
assertNotNull(vendored, "нет вендорного xslt/docx2fo.xslt");
assertTrue(new String(vendored.readAllBytes(), StandardCharsets.UTF_8)
.contains("AUDIT-FIX position"),
"вендорный стилист потерял position-патч");
String vendored;
try (InputStream in = WordPdfConverterTest.class.getResourceAsStream("/xslt/docx2fo.xslt")) {
assertNotNull(in, "нет вендорного xslt/docx2fo.xslt");
vendored = new String(in.readAllBytes(), StandardCharsets.UTF_8);
}
java.util.regex.Matcher call = java.util.regex.Pattern.compile(
"[ \\t]*<xsl:copy-of select=\"java:[^\"]*createBlockForRPr\\([^\"]*\"\\s*/>")
.matcher(jar);
assertTrue(call.find(), "в стилисте jar'а нет исходного вызова createBlockForRPr");
String restored = vendored.replaceFirst(
"(?s)[ \\t]*<!-- AUDIT-FIX position.*?\\t\\t\\t\\t \\t</xsl:choose>",
java.util.regex.Matcher.quoteReplacement(call.group()));
assertEquals(jar, restored, "вендорный xslt/docx2fo.xslt отличается от копии"
+ " docx4j-export-fo вне AUDIT-FIX-региона: перевендорить и перенести патч");
}
/** Правый край (X+ширина) самой правой глифы первой страницы. */
@@ -291,8 +291,8 @@ class StrictOoxmlNormalizerTest {
/**
* w:jc val="start" в transitional правится всегда: docx4j Justification.setXslFO
* знает только left/center/right/both, для start/end fo:text-align не пишет
* вовсе — jc="end" рендерился по левому краю (Part 4 §14.11.2: left≡start,
* right≡end; регрессия WordPdfConverterTest#jcEndTransitional_rightAligned).
* вовсе — jc="end" рендерился по левому краю (Part 1 §17.3.1.13: end —
* правовыравнивание в LTR; регрессия WordPdfConverterTest#jcEndTransitional_rightAligned).
*/
@Test
void jcStartRenamedTransitional() {