diff --git a/AGENTS.md b/AGENTS.md index b91c61f..db2f5fc 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -95,7 +95,7 @@ Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`, `PADDING = 4.0`, растр - `PhysicalFonts` — глобальный и мутируемый → ядро не потокобезопасно; приложение сериализует конвертации одним воркером. - Страницы в валидаторе = `max(кэш docProps/app.xml, явные разрывы, lastRenderedPageBreak+1)`; explicit = межсекционные `w:sectPr` в body + `w:br type="page"` + `pageBreakBefore` (включая таблицы и `w:sdt`). Единственный путь — lightweight (StAX по zip, secure-ридер без DTD/external entities; `WordPdfValidator` не зависит от docx4j): атрибуты — по локальному имени (`attrLocal`, не по transitional-URI: иначе в strict-документе `w:br type="page"` не засчитываются); `sectPr` внутри `pPr` не считает, последнюю body-direct секцию не считает, `continuous`-секции не считает, в колонтитуках — только `w:br type="page"`, `pageBreakBefore` — только внутри `pPr` вне `sectPr` (truthy `val`: `null|true|1|on`). На не-zip молчит — подпись проверяет вызывающий. `checkPageCount` — один стриминговый проход `ZipInputStream` без буферизации частей (хелпер `noClose` глушит `close()` сканеров): потребление O(одной части) вместо O(суммы XML-частей). - Известный остаток эталона: U+2188/U+218A — глифов нет в OFL-шрифтах бандла, остаются `.notdef` (GNU FreeSerif GPL — не добавляем намеренно). -- Аудит раскладки по ECMA-376 Part 1 (2026-10) — известные нечинимые ограничения FOP/docx4j (Java-слой): `w:jc="distribute"` рендерится как left — межсимвольного распределения в FOP нет (ST_Jc §17.18.44: distribute — межсимвольный разнос, justify только межсловный), последняя строка блока не растягивается, свойства `text-align-last` в форке нет (в docx4j-fo-renderer отсутствуют классы TextAlign*); `w:suff="tab"` и `w:lvlJc` игнорируются (numbering-лейбл всегда через hanging-tab; suff=space чинит правило 8, suff=nothing совпадает с docx4j — разделителя нет); абзац без `w:line` рендерится natural-высотой FOP 15.44pt@11pt, явный `lineRule="auto"` — 13.4277pt, два «single» в конвертере (13.4277 — канонический single по метрикам Carlito/Calibri 2500/2048 em; первичный замер аудита «Word ≈13.9pt» — пиксельное округление 18px@96dpi, расхождения с явной строкой нет, пункт закрыт); кернинг не применяется вовсе: шрифты бандла GPOS-only, латинский путь FOP (`TextLayoutManager`→`Font.hasKerning`) читает только legacy `kern`-таблицу, свойства `kerning` в форке нет (замер: advance A→V = A→A = 6.369pt@11pt Carlito); Word кернит только при явно заданном `w:kern` в иерархии стилей и при sz ≥ val (Part 1 §17.3.2.19; при отсутствии `w:kern` Office не кернит — MS-OI29500 §21.1.2.3.9a) — по умолчанию совпадает с нами, расходится только для документов с явно заданным `w:kern`. Починено веткой layout-class-c: левый padding ячейки (`LayoutPostRenderer`, шаг 4.25), `w:tblInd` при `w:jc`≠left (правило 7), `w:suff="space"` (правило 8). +- Аудит раскладки по ECMA-376 Part 1 (2026-10) — известные нечинимые ограничения FOP/docx4j (Java-слой): `w:jc="distribute"` рендерится как left — межсимвольного распределения в FOP нет (ST_Jc §17.18.44: distribute — межсимвольный разнос, justify только межсловный), последняя строка блока не растягивается, свойства `text-align-last` в форке нет (в docx4j-fo-renderer отсутствуют классы TextAlign*); `w:suff="tab"` и `w:lvlJc` игнорируются (numbering-лейбл всегда через hanging-tab; suff=space чинит правило 8, suff=nothing совпадает с docx4j — разделителя нет); абзац без `w:line` рендерится natural-высотой FOP 15.44pt@11pt, явный `lineRule="auto"` — 13.4277pt, два «single» в конвертере (13.4277 — канонический single по метрикам Carlito/Calibri 2500/2048 em; «Word ≈13.9pt» из первичного аудита не воспроизводится: обе величины считаются по метрикам шрифта, артефакты исходного замера не сохранились → пункт закрыт без правок); кернинг не применяется ни для одного бандл-семейства (замер: advance A→V = A→A — Carlito 6.369pt, DejaVu Sans 7.524pt@11pt): 22 TTF — GPOS-only, а legacy `kern`-таблица DejaVu Sans/Serif ключована glyph id, не совпадающими с cmap (2568/2727 пар без Unicode-маппинга, пары A→V нет) — латинский путь FOP (`TextLayoutManager`→`Font.hasKerning`) читает только legacy `kern` и такие пары отбрасывает; свойства `kerning` в форке нет, порог `w:kern` через FO не выражается. Word кернит только при явно заданном `w:kern` в иерархии стилей и при sz ≥ val (Part 1 §17.3.2.19; при отсутствии `w:kern` Office не кернит — MS-OI29500 §21.1.2.3.9a) — по умолчанию совпадает с нами, расходится только для документов с явно заданным `w:kern`. Починено веткой layout-class-c: левый padding ячейки (`LayoutPostRenderer`, шаг 4.25), `w:tblInd` при `w:jc`≠left (правило 7), `w:suff="space"` (правило 8). - Внимание: комментарии в `WordPdfConverter`/`DocxOnOffNormalizer` говорят «docx4j 11.x» — устаревшее число, фактически 17.3.2 (описанное поведение верно). ### Шрифты (30 TTF + 3 лицензии, SIL OFL, `wordpdf-core/src/main/resources/fonts/`) diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/LayoutPostRenderer.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/LayoutPostRenderer.java index 7d2524c..583a021 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/LayoutPostRenderer.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/LayoutPostRenderer.java @@ -33,8 +33,8 @@ import java.util.regex.Pattern; * которую считают и docx4j, и форк FOP, — каноническая по метрикам * Carlito/Calibri (hhea 1950+550, OS/2 win 1950+550, OS/2 typo 1536+512+452 — * все 2500/2048 em; Carlito метрически совмест с Calibri). Первичный замер - * аудита «Word ≈13.9pt» — пиксельное округление (18px@96dpi), расхождения - * нет. Регрессия, пинящая метрический шаг, — + * аудита «Word ≈13.9pt» не воспроизводится (артефакты исходного замера + * не сохранились), расхождения по метрикам нет. Регрессия, пинящая метрический шаг, — * WordPdfConverterTest#lineRuleAuto_wordSingleLinePitch. */ public final class LayoutPostRenderer implements FORenderer { diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java index b79958e..0ec7617 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java @@ -777,8 +777,8 @@ class WordPdfConverterTest { * w:spacing w:line="240" w:lineRule="auto" (single): шаг базовых = * 13.4277pt — канонический «single» по метрикам Carlito/Calibri * (hhea/win/typo — все 2500/2048 em @11pt; Carlito метрически совмест с - * Calibri). Пиксельный замер аудита «Word ≈13.9pt» — округление - * (18px@96dpi), расхождения с Word нет → rescale в LayoutPostRenderer + * Calibri). «Word ≈13.9pt» из аудита не воспроизводится (артефакты + * исходного замера не сохранились), расхождения по метрикам нет → rescale в LayoutPostRenderer * НЕ делается, тест пинит метрический шаг от регрессий. Регрессия — * аудит раскладки (матрица A2, пункт закрыт). */ @@ -793,7 +793,7 @@ class WordPdfConverterTest { + " w:line=\"240\" w:lineRule=\"auto\"/>" + "" + run + "Q"); Path pdf = convertPdf(docx, "t"); - // 2500/2048 em × 11pt = 13.4277 (не 13.9 — пиксельное округление) + // 2500/2048 em × 11pt = 13.4277 (не 13.9 — тот замер не воспроизведён) assertEquals(13.4277, yOfMarker(pdf, 'Q') - yOfMarker(pdf, 'P'), 0.1); }