From ffe03accd1db79b62ea1810113b8aaa456f8b2ff Mon Sep 17 00:00:00 2001 From: Pjandro Date: Sat, 31 Oct 2026 22:26:53 +0000 Subject: [PATCH] =?UTF-8?q?=D0=9C=D0=BE=D1=81=D1=82=20.doc=20=E2=86=92=20.?= =?UTF-8?q?docx:=20PAPX-=D1=81=D0=B2=D0=BE=D0=B9=D1=81=D1=82=D0=B2=D0=B0?= =?UTF-8?q?=20=D0=B8=D0=B7=20PrcData=20(sprmPHugePapx/sprmPTableProps,=20?= =?UTF-8?q?=C2=A72.9.210)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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: таблицы «Таблицы» структурированы, фантомных рядов и плоских абзацев нет. --- AGENTS.md | 15 +- .../wordpdf/internal/doc/DocToDocx.java | 5 +- .../pjandro/wordpdf/internal/doc/Grpprl.java | 14 ++ .../pjandro/wordpdf/internal/doc/PrcData.java | 110 ++++++++++ .../internal/doc/DocToDocxFormattingTest.java | 93 +++++++++ .../wordpdf/internal/doc/PrcDataTest.java | 189 ++++++++++++++++++ 6 files changed, 418 insertions(+), 8 deletions(-) create mode 100644 wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/doc/PrcData.java create mode 100644 wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/doc/PrcDataTest.java diff --git a/AGENTS.md b/AGENTS.md index 4bf26fc..a161867 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -44,7 +44,7 @@ |`CfbReader`|[MS-CFB] заголовок (секторы 512/4096, mini 64), FAT/DIFAT (лимиты секторов + защита от циклов), miniFAT + mini stream из root, directory; любой брак (цикл, ссылка за файл, обрезанный поток, битый заголовок) → `ValidationException`| |`FibHeader`|[MS-DOC §2.4.1/§2.6.1] FibBase (`fWhichTblStm` — бит 9 u16@10 → 1Table/0Table), FibRgLw97 (ccpText/ccpFtn/ccpHdd), пары FibRgFcLcb97: fcStshf=1, fcPlcfSed=6, fcPlcfHdd=11, fcPlcfBteChpx=12, fcPlcfBtePapx=13, fcSttbfFfn=15, fcClx=33, fcDggInfo=50, fcPlfLst=73, fcPlfLfo=74| |`PieceTable`|§2.9.135 Clx/Pcdt: куски compressed (FC/2, байт + CP1252-карта 0x80–0x9F) и uncompressed (UTF-16LE); FC за потоком → `ValidationException`| -|`Grpprl`|§2.6.2 sprm'ы: CHPX — bold 0x0835, italic 0x0836, strike 0x0837, kul 0x2A3E, hps 0x4A43, hpsBi 0x4A61, ftc0 0x4A4F, ftc1 0x4A50, cv 0x6870 (4-й байт FF → auto), sprmCFSpec 0x0875, **sprmCPicLocation 0x6A03** (смещение BLIP в Data); PAPX — jc 0x2461 (4→distribute, 5/7/8/9→both, 6 — игнор) и jc80 0x2403 (3/4/5 — justify-both с разной компрессией, distribute у jc80 нет), dxaLeft/dxaLeft1/dxaRight + 80-варианты 0x840F/0x8411/0x840E и sprmPNest 0x465F/sprmPNest80 0x4610 (XAS со знаком → hanging/firstLine; общий накопитель `Grpprl.Indents`: nest к своему dxaLeft, современное семейство вытесняет 80-е), pageBreakBefore 0x2407, InTable 0x2416, sprmPFTtp 0x2417, istd 0x8463, LSPD 0x6412 (dyaLine i16 + fMult), before/after 0xA413/0xA414, PChgTabs 0xC60D и **sprmPChgTabs 0xC615** (табы стиля; PChgTabsDelClose §2.9.182 — радиус удаления из rgdxaClose, XAS_plusOne), **ilvl 0x260A** (u8; 0x0C — «пропустить, не нумеровать»), **ilfo 0x460B** (i16: 0/0xF801 — списока нет, 1..0x07FE — 1-базированный индекс rgLfo, 0xF802..0xFFFF — отрицание индекса с сохранением отступов); TAP — **sprmTDefTable 0xD608**, sprmTTableBorders 0xD613, sprmTTableBorders80 0xD605, sprmTJc 0x548A / sprmTJc90 0x5400 (u16 0/1/2 → left/center/right, единый маппинг: FOP complex-script не поддерживает, RTL вне контура). Спец-длины операндов spra=6: у 0xD608 счётчик cb **двухбайтовый** («остаток+1», §2.9.321 — формула «1+первый байт» врёт при cb>255), у 0xC60D cb=0xFF — обрыв разбора; у 0xC615 cb=0xFF — длина 3 + 4·cTabsDel + 3·cTabsAdd по раскладке §2.9.182 (разбор продолжается)| +|`Grpprl`|§2.6.2 sprm'ы: CHPX — bold 0x0835, italic 0x0836, strike 0x0837, kul 0x2A3E, hps 0x4A43, hpsBi 0x4A61, ftc0 0x4A4F, ftc1 0x4A50, cv 0x6870 (4-й байт FF → auto), sprmCFSpec 0x0875, **sprmCPicLocation 0x6A03** (смещение BLIP в Data); PAPX — **sprmPHugePapx 0x6646**/**sprmPTableProps 0x646B** (указатели на PrcData в Data, разворачивает `PrcData.resolve`; `Grpprl.scan` сам их корректно пропускает по spra=3), jc 0x2461 (4→distribute, 5/7/8/9→both, 6 — игнор) и jc80 0x2403 (3/4/5 — justify-both с разной компрессией, distribute у jc80 нет), dxaLeft/dxaLeft1/dxaRight + 80-варианты 0x840F/0x8411/0x840E и sprmPNest 0x465F/sprmPNest80 0x4610 (XAS со знаком → hanging/firstLine; общий накопитель `Grpprl.Indents`: nest к своему dxaLeft, современное семейство вытесняет 80-е), pageBreakBefore 0x2407, InTable 0x2416, sprmPFTtp 0x2417, istd 0x8463, LSPD 0x6412 (dyaLine i16 + fMult), before/after 0xA413/0xA414, PChgTabs 0xC60D и **sprmPChgTabs 0xC615** (табы стиля; PChgTabsDelClose §2.9.182 — радиус удаления из rgdxaClose, XAS_plusOne), **ilvl 0x260A** (u8; 0x0C — «пропустить, не нумеровать»), **ilfo 0x460B** (i16: 0/0xF801 — списока нет, 1..0x07FE — 1-базированный индекс rgLfo, 0xF802..0xFFFF — отрицание индекса с сохранением отступов); TAP — **sprmTDefTable 0xD608**, sprmTTableBorders 0xD613, sprmTTableBorders80 0xD605, sprmTJc 0x548A / sprmTJc90 0x5400 (u16 0/1/2 → left/center/right, единый маппинг: FOP complex-script не поддерживает, RTL вне контура). Спец-длины операндов spra=6: у 0xD608 счётчик cb **двухбайтовый** («остаток+1», §2.9.321 — формула «1+первый байт» врёт при cb>255), у 0xC60D cb=0xFF — обрыв разбора; у 0xC615 cb=0xFF — длина 3 + 4·cTabsDel + 3·cTabsAdd по раскладке §2.9.182 (разбор продолжается)| |`ChpxIndex`/`PapxIndex`|§2.4.6: PlcfBte (aFc n+1 + pn 22 бита) → FKP-страницы 512 Б по pn·512 (rgfc (n+1)×4, rgbx n×1/×13, crun/cpara — последний байт); Chpx = cb + grpprl; PapxInFkp: cb≠0 → GrpPrlAndIstd 2cb−1, cb=0 → cb′ → 2cb′ (внутри istd(2) + grpprl, grpprl может быть пустым — istd без прямых Prl); bOffset=0 → дефолт; **istd сохраняется** (`istdFor`, вне диапазона −1) — по нему `DocxBody` применяет цепочку `Styles`| |`Styles`|§2.9.271 STSH по fcStshf: LPStshi (cbStshi, cstd, cbSTDBaseInFile) → LPStd на чётных границах → Std (stdf: sti/stk/istdBase/cupx + xstzName + LPUpx): stk=1 → UPX[0]=UpxPapx (istd(2)+grpprl), UPX[1]=UpxChpx. Цепочка base-first (предок раньше потомка, last-wins при скане); istdBase 0x0FFF — без предка, цикл — обрыв на MAX_CHAIN=16. Разбор **снисходительный** (образец FontTable): битый/отсутствующий STSH → пустая таблица, конвертация на прямых свойствах, без `ValidationException`| |`Tables`|TAP TTP-абзаца (§2.6.3) → `Grid(colWidths, indent, bordersXml, tblJc)`: sprmTDefTable (§2.9.321, ncols 1..63, rgdxaCenter XAS со знаком — ширина = center[i+1]−center[i], первый center — сдвиг от поля); границы: sprmTTableBorders (§2.9.302, 6×Brc: cv fAuto, dptLineWidth 1/8pt, brcType §2.9.39) иначе sprmTTableBorders80 (§2.9.303, ico→цвет §2.9.171); brcType=0 не эмитится, ≥0x40 ширина ×8, sz<2 → 2; выравнивание: sprmTJc/sprmTJc90 (u16: 1→"center", 2→"right", прочее → null — элемент не эмитится), современный перекрывает 90-вариант (тот же приоритет, что у 0xD613 над 0xD605) → `w:jc` в tblPr (`openTable`; регрессия — WordPdfConverterTest#docFooterTableCentered_shiftedLikeWord). `null` (нет/битый TDefTable, неположительная ширина) → строка деградирует в плоские абзацы| @@ -54,10 +54,11 @@ |`SummaryInfo`|[MS-OLEPS §2.2] PropertySet-поток `\x01SummaryInformation`; **offset'ы заголовка относительны начала PropertySet-потока** (`abs = Offset0 + offset`); PIDSI_PAGECOUNT=0x0E| |`Headers`|Plcfhdd (§2.4.1): 6 разделителей + по 6 историй на секцию (even/odd/first × hdr/ftr); odd hdr/ftr **каждой** секции → своя часть `headerN.xml`/`footerN.xml` (нумерация независимая по типу) и `headerReference`/`footerReference` type="default" в её sectPr; пустая история `[x,x)` → части нет, docx4j наследует колонтитук предыдущей секции; guard-¶ отрезается; PAGE/NUMPAGES/SECTIONPAGES → `w:fldSimple` (та же семантика, что `FieldNormalizer` в docx-пути)| |`OfficeArt`|[MS-ODRAW] PICF @ fcDggInfo/lcbDggInfo (Table-поток), delay-поток = WordDocument; DggContainer → BStoreContainer(0xF004)/BStoreContainerDelay(0xF007)/инлайн → FBSE → BLIP: 0xF01A EMF / 0xF01B WMF / 0xF01C PICT / 0xF01D JPEG (=0xF02A) / 0xF01E PNG / 0xF01F DIB; PNG/JPEG дословно, DIB → ImageIO → PNG, EMF/WMF/PICT → пропуск + warn (EMF-рендера в Java2D нет)| -|`DocToDocx`|Оркестратор + вложенный `DocxBody`: текст → раны (CHPX+стилевой chpx-цепочка → rPr, PAPX+стилевая papx-цепочка (отступы через `Grpprl.Indents`, 80-варианты включительно; `sprmPChgTabsPapx`/`sprmPChgTabs` → `w:tabs`, у стилевого варианта радиус удаления из `rgdxaClose`) + sprmPIlfo/sprmPIlvl → pPr + `w:numPr` (между pageBreakBefore и tabs, CT_PPr §17.3.1.26; ilfo=0 перекрывает стилевой, ilvl=0x0C и неразрешённый numId → без numPr), base→derived→direct last-wins), ¶ → ``; TAB/0x0B → `w:tab`/`w:br`, 0x0C в ране → `w:br type="page"`, 0x0C в конце абзаца — **разрыв секции**: `sectPr` соответствующей `Sections.Section` (матчинг по конечному CP) в pPr этого абзаца, внутри таблицы деградирует в `w:br type="page"`; body-level `sectPr` — последняя секция; `w:type continuous` из sprmSBkc; 0x1E → U+2011, 0x1F → U+00AD, 0x02/0x03/0x04 (сноски) → пропуск; U+0001 со sprmCPicLocation → DrawingML `pic` (общий путь с картинками и OLE-fallback); field-символы в основном тексте: инструкция скрыта, кэшированный результат после разделителя видим; **табличный автомат**: абзац с 0x07 без TTP закрывает ячейку, 0x07+sprmPFTtp — конец строки (`Tables.parse` по TAP → `w:tbl`/`w:tr`/`w:tc`, сам маркер не эмитится), sprmPFInTable открывает ячейку; без корректного TDefTable строка деградирует в плоские абзацы (прежнее поведение); сетка первой строки действует на всю таблицу| +|`PrcData`|§2.9.210 PrcData в Data-потоке (`[cbGrpprl:2][grpprl]`, капа cb 0x3FA2, поля `next` нет): `resolve(data, grpprl)` разворачивает grpprl абзаца, чьи свойства Word вынес за FKP-страницу PAPX, — одиночный Prl `sprmPHugePapx` (0x6646; в grpprl GrpPrlAndIstd — единственный Prl при istd=0, §2.6.2) и `sprmPTableProps` (0x646B — цепочка продолжается в указанном PrcData). Оба указателя разворачиваются на своей позиции **без обрыва** текущего массива, не-спец-спрмы сохраняются (union): spec §2.6.2 велит хвост за PTableProps игнорировать, но Word пишет в нём легаси-зеркало (в `samples/ru-table-image.doc` — единственный `sprmTDefTable`, Appendix A <9>), а `sprmTInsert` из PrcData конвертер не читает — замещение ломало бы сетку; спец-спрмов нет → **тот же массив** (по ссылке); любой брак (ptr за Data, cb вне [1, 0x3FA2], цикл A→B→A — бюджет 32 PrcData) → останов без исключения, снисходительно (образец `Styles`/`Lists`). Подключается единственной точкой — `DocxBody.buildRange` (покрывает тело, колонтитуки, TTP-ветку и обычные huge-PAPX абзацы). Регрессия — `DocToDocxFormattingTest#hugePapxRowMark_closesRowWithGridFromPrcData` | +|`DocToDocx`|Оркестратор + вложенный `DocxBody`: текст → раны (CHPX+стилевой chpx-цепочка → rPr, прямой PAPX — после `PrcData.resolve` — +стилевая papx-цепочка (отступы через `Grpprl.Indents`, 80-варианты включительно; `sprmPChgTabsPapx`/`sprmPChgTabs` → `w:tabs`, у стилевого варианта радиус удаления из `rgdxaClose`) + sprmPIlfo/sprmPIlvl → pPr + `w:numPr` (между pageBreakBefore и tabs, CT_PPr §17.3.1.26; ilfo=0 перекрывает стилевой, ilvl=0x0C и неразрешённый numId → без numPr), base→derived→direct last-wins), ¶ → ``; TAB/0x0B → `w:tab`/`w:br`, 0x0C в ране → `w:br type="page"`, 0x0C в конце абзаца — **разрыв секции**: `sectPr` соответствующей `Sections.Section` (матчинг по конечному CP) в pPr этого абзаца, внутри таблицы деградирует в `w:br type="page"`; body-level `sectPr` — последняя секция; `w:type continuous` из sprmSBkc; 0x1E → U+2011, 0x1F → U+00AD, 0x02/0x03/0x04 (сноски) → пропуск; U+0001 со sprmCPicLocation → DrawingML `pic` (общий путь с картинками и OLE-fallback); field-символы в основном тексте: инструкция скрыта, кэшированный результат после разделителя видим; **табличный автомат**: абзац с 0x07 без TTP закрывает ячейку, 0x07+sprmPFTtp — конец строки (`Tables.parse` по TAP → `w:tbl`/`w:tr`/`w:tc`, сам маркер не эмитится), sprmPFInTable открывает ячейку; без корректного TDefTable строка деградирует в плоские абзацы (прежнее поведение); сетка первой строки действует на всю таблицу| |`DocxWriter`|Мульти-частный zip: `[Content_Types].xml` (hdr/ftr/numbering/png/jpg), `_rels/.rels`, `word/document.xml` (посекционные sectPr + headerReference; tblPr таблиц: tblW → jc (из sprmTJc) → tblInd → tblBorders), `word/_rels/document.xml.rels`, `word/numbering.xml`, `word/headerN.xml`/`footerN.xml` (по одной на непустую историю секции), `word/media/imageN.(png|jpg)`; корневые namespaces w/r/wp/a/pic| -Остаток моста (осознанный, вне контура): семантика рестартов списков не переносится (`fNoRestart`/`ilvlRestartLim` → `w:lvlRestart` — docx4j-Emulator применяет свой дефолт «рестарт на старшем уровне»), как и `fLegal`/`isLgl`, `dxaIndentSav` и `LfoData.cp`; `sprmPIlvl=0x0C` — абзац без numPr (не «в списке без номера»); AUTONUM-поля трактуются как обычные списки; отрицательный `sprmPIlfo` («сохранить отступы») — обычный numPr, отступы делает прямой `w:ind` абзаца; объединённые ячейки (`vertMerge`/sprmTInsert), вложенные таблицы (sprmPFInnerTtp) и бордюры уровня ячейки (TC80/sprmTCellBorders) не переносятся — только сетка и строковые границы; сноски/концевые сноски/комментарии не рендерятся (метки ссылок пропускаются); чётные и first-page варианты колонтитуков не переносятся (переносится только odd → `type="default"`, FOP не различает чётность полос набора, `titlePg` не эмитится); разрыв секции в абзаце со sprmPFInTable деградирует в разрыв страницы (`w:sectPr` в `w:pPr` внутри `w:tc` невалиден); error-флаги `errorOnCharts`/`errorOnSmartArt`/`errorOnOle` на `.doc` **не срабатывают** — диаграммы/SmartArt/OLE в бинарном формате существуют только как BLIP-плейсхолдеры, мост выдаёт их картинками (задокументировано в `@Operation`); `stale-cache.doc` конвертируется (кэш PageCount=5, концепта lastRenderedPageBreak в .doc нет) — семантика отличается от docx-фикстуры, запинено тестом. +Остаток моста (осознанный, вне контура): семантика рестартов списков не переносится (`fNoRestart`/`ilvlRestartLim` → `w:lvlRestart` — docx4j-Emulator применяет свой дефолт «рестарт на старшем уровне»), как и `fLegal`/`isLgl`, `dxaIndentSav` и `LfoData.cp`; `sprmPIlvl=0x0C` — абзац без numPr (не «в списке без номера»); AUTONUM-поля трактуются как обычные списки; отрицательный `sprmPIlfo` («сохранить отступы») — обычный numPr, отступы делает прямой `w:ind` абзаца; объединённые ячейки (`vertMerge`/sprmTInsert), вложенные таблицы (sprmPFInnerTtp — разделитель ячейки/строки там ¶ 0x0D, не 0x07) и бордюры уровня ячейки (TC80/sprmTCellBorders) не переносятся — только сетка и строковые границы; строки, у которых сетка задана только `sprmTInsert` (в PrcData нет `sprmTDefTable`, а PAPX-зеркало отсутствует), деградируют в плоские абзацы (`sprmTInsert` конвертер не читает); `DocFile.countPages` (`PapxIndex.countPageBreakBefore`) цепочку PrcData не следует — свойства вне FKP в подсчёт страниц не попадают, 0x0C-разрывы считаются; сноски/концевые сноски/комментарии не рендерятся (метки ссылок пропускаются); чётные и first-page варианты колонтитуков не переносятся (переносится только odd → `type="default"`, FOP не различает чётность полос набора, `titlePg` не эмитится); разрыв секции в абзаце со sprmPFInTable деградирует в разрыв страницы (`w:sectPr` в `w:pPr` внутри `w:tc` невалиден); error-флаги `errorOnCharts`/`errorOnSmartArt`/`errorOnOle` на `.doc` **не срабатывают** — диаграммы/SmartArt/OLE в бинарном формате существуют только как BLIP-плейсхолдеры, мост выдаёт их картинками (задокументировано в `@Operation`); `stale-cache.doc` конвертируется (кэш PageCount=5, концепта lastRenderedPageBreak в .doc нет) — семантика отличается от docx-фикстуры, запинено тестом. ### Нормализаторы (`internal/DocxNormalizer`) @@ -133,7 +134,7 @@ Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`, `PADDING = 4.0`, растр | `wordpdf-core/src/main/java/ru/pjandro/wordpdf/` | Публичный API: `WordPdfConverter` (`convert(byte[],String[,ConvertOptions])`), `WordPdfValidator` (`checkInput`/`checkPageCount`/`validate` — без зависимости от docx4j), `ConversionException`, `ValidationException` (наследник — «вход некорректен»), `DrawingFoundException` (`enum Kind {CHARTS, SMARTART, OLE}`), `WordPdfSettings` (`MAX_INPUT_MB=5`, `MAX_PAGES=100`, защитные `MAX_DECOMPRESSED_MB=200`/`MAX_ZIP_ENTRIES=8192`, `ERROR_ON_*=false`), `ConvertOptions` (record) | | `…/wordpdf/fonts/` | `BundledFonts` (реестр/выгрузка TTF), `BundledFontMapper` (алиасы, self-map, `DISPLAY_NAMES`, `bundledFamily`), `GlyphFont` (глиф-движок fontbox) | | `…/wordpdf/internal/` | 9 нормализаторов + `DocxRewritePipeline` (один zip-проход правил 1–8, raw-копия неизменённых записей) + `LayoutPostRenderer` (кастомный `FORenderer`, post-FO padding-компенсация таблиц, шаг 4.25) + интерфейс `DocxNormalizer` + `FopFallbackFonts` + `DependencyGuard` (проверка commons-compress, шаг 0). Классы `public` (иначе родительский пакет не вызвал бы), публичные члены наружу только `normalize`/`STEP`/`declare`/`DependencyGuard.check`/`LayoutPostRenderer.register`; `OleObjectNormalizer` — многочастный, публичный `normalize(byte[], boolean)`, бросает `DrawingFoundException(OLE)` | -| `…/wordpdf/internal/doc/` | Мост `.doc` → `.docx`: 17 классов (см. секцию «Мост») — `CfbReader`, `FibHeader`, `PieceTable`, `Grpprl`, `ChpxIndex`, `PapxIndex`, `Styles`, `Tables`, `Lists`, `Sections`, `FontTable`, `SummaryInfo`, `Headers`, `OfficeArt`, `DocFile`, `DocxWriter`, `DocToDocx` (публичные `convert`/`countPages`; вложенный `DocxBody` — рендер текста и табличного автомата в XML) | +| `…/wordpdf/internal/doc/` | Мост `.doc` → `.docx`: 18 классов (см. секцию «Мост») — `CfbReader`, `FibHeader`, `PieceTable`, `Grpprl`, `ChpxIndex`, `PapxIndex`, `Styles`, `Tables`, `Lists`, `Sections`, `FontTable`, `SummaryInfo`, `Headers`, `OfficeArt`, `PrcData`, `DocFile`, `DocxWriter`, `DocToDocx` (публичные `convert`/`countPages`; вложенный `DocxBody` — рендер текста и табличного автомата в XML) | | `…/wordpdf/internal/chart/` |17 классов Java2D-рендера диаграмм/SmartArt в PNG (public только `DrawingPreRenderer.run`)| | `wordpdf-core/src/main/resources/fonts/` | 30 TTF + 3 лицензии — бинарные фикстуры, часть jar | | `wordpdf-core/src/main/resources/xslt/` | `docx2fo.xslt` — вендорный XSL-FO-стилист (копия docx4j-export-fo + AUDIT-FIX-патч), часть jar | @@ -239,13 +240,13 @@ java -cp wordpdf-core/target/test-classes:$(cat /tmp/cp.txt) \ - Гейт `maven-pmd-plugin` 3.28.0 на `verify` для обоих модулей, ruleset `pmd-ruleset.xml`, `includeTests=true`. Версия PMD-движка в pom не пинится (тянется плагином). - Гейт JaCoCo `0.8.15`: `jacoco:check` (правило BUNDLE, LINE COVEREDRATIO `0.90` — обоих модулей; в `wordpdf-core/pom.xml` execution `check` переопределён и добавляет BRANCH COVEREDRATIO `0.85` — только для core) на `verify`; агент подключается в surefire через `argLine` = `@{argLine} -Djava.awt.headless=true` (свойство `argLine` в корневом pom по умолчанию пусто и перезаписывается `prepare-agent` — `mvn test -Djacoco.skip=true` без агента работоспособно); `report` и `check` оба на `verify`, report раньше — при провале порога отчёт уже на диске; отчёты `target/site/jacoco/` (html+xml, xml нужен CI-сводке). Плотность покрытия держат тесты, а не заглушки: промахи в основном недостижимые IOException/catch-ветки (`GlyphFont`, `BundledFonts`) и защитные ветви сканеров нормализаторов/валидатора. -- 54 тестовых класса / 781 `@Test` (core 48/736 — из них 16 классов / 172 теста в `internal/doc/`, app 6/45: ConvertController 23 + ApiKeyFilter 8 + ConversionService 5 + ApiExceptionHandler 4 + ConvertLimits 3 + ConversionTimeout 2). JUnit 6 (`org.junit.jupiter:junit-jupiter`), surefire 3.6.0 с `-Djava.awt.headless=true`; только `Assertions` (Mockito/AssertJ не использовать; в app-тестах допустим inline-Hamcrest `org.hamcrest.Matchers.containsString` в `andExpect`), тестовые классы package-private, зеркалят main-пакеты; только `@Test` + два `@BeforeAll` (warm-up шрифтов в `GlyphCoverageNormalizerTest` и `BundledFonts.init()` в `BundledFontsTest`) + `@AfterEach drainWorker` в `ConversionTimeoutTest` (дренировать отменённый FOP-рендер до следующего класса — гонка глобального `PhysicalFonts`). +- 55 тестовых класса / 796 `@Test` (core 49/753 — из них 17 классов / 189 тестов в `internal/doc/`, app 6/43: ConvertController 23 + ApiKeyFilter 8 + ConversionService 5 + ApiExceptionHandler 4 + ConvertLimits 2 + ConversionTimeout 1). JUnit 6 (`org.junit.jupiter:junit-jupiter`), surefire 3.6.0 с `-Djava.awt.headless=true`; только `Assertions` (Mockito/AssertJ не использовать; в app-тестах допустим inline-Hamcrest `org.hamcrest.Matchers.containsString` в `andExpect`), тестовые классы package-private, зеркалят main-пакеты; только `@Test` + два `@BeforeAll` (warm-up шрифтов в `GlyphCoverageNormalizerTest` и `BundledFonts.init()` в `BundledFontsTest`) + `@AfterEach drainWorker` в `ConversionTimeoutTest` (дренировать отменённый FOP-рендер до следующего класса — гонка глобального `PhysicalFonts`). - **PDF сравнивается текстом, не растеризацией**: PDFBox 3 (`Loader.loadPDF`) — `PDFTextStripper` (пер-странично `setStartPage/setEndPage`), override `processTextPosition` для шрифта конкретного символа (`fontNameOf`), обход ресурсов страниц для встроенных шрифтов (`EAAAAA+Carlito-Bold`) и счётчик картинок (`imageCount`/`distinctImageCount` — SMask игнорируется). Негативные маркеры: `assertFalse(text.contains("#"))` (.notdef), `assertFalse(font.startsWith("Helvetica"))`. Текст нормализуется по пробелам (`norm`); в `tableImage_tableAndImage` — полное удаление пробелов (docx4j переносит слова в auto-fit таблицах). - Пиксели (BufferedImage) — только в unit-тестах chart-пейнтеров: безразмерные отношения к эталону Word (экспорт 300 dpi, числа зашиты в тесты), допуски `assertRatio` <0.06 (`PiePainterTest`, `CartesianPainterTest`) / <0.10 (`Surface3dPainterTest`, + `assertRange` ±6 pt для центров силуэта); пороги залитых px, перцентильные коридоры яркости, «серый» px — разброс каналов `GRAY_MAX_SPREAD=25`; исключение — структурная проверка чернил в `GlyphFontTest`. Эталонные файлы — `develop/`, вне git. Хелперы chart-тестов (`render`, `countColor`, `assertRatio`, `paint`) продублированы по классам — общего test-util нет. - `GlyphFont` (fontbox): метрики пиксельно-метрически эквивалентны AWT (ascent/descent/leading/advance совпадают до 4-го знака, кернинг-дрейф 0.0000 — DejaVu Sans, Carlito). Приёмочный стенд без-fontconfig: контейнер без `libfontconfig.so.1*` и `/etc/fonts`, `mvn verify` + `java -jar` (до перехода на GlyphFont там падали `GlyphCoverageNormalizerTest` 12 / `CartesianPainterTest` 3 / `PiePainterTest` 2 / chart-тесты `WordPdfConverterTest` 4, chart-рендер молча деградировал). `GlyphFontTest` написан без единого `java.awt.Font` — обязан проходить на хосте без fontconfig. - Фикстуры — закоммиченные `samples/*.docx` + `samples/*.doc` (13 + 12; в тестах не генерировать; `.docx` все ECMA-conformant по `docs/standards/docx/validate-fixtures.py` — фикстура невалидна, правится фикстура, не код; `.doc` — эталоны заказчика, конвертируются мостом): core грузит classpath-ресурсом → `byte[]`, PDF для PDFBox — временный файл; app читает `/samples/…` из **test-jar core** (classifier `tests`) → `mvn -pl wordpdf-app` без `-am` не соберётся. In-memory docx — `ZipOutputStream` из литеральных XML или POI в `byte[]`; in-memory `.doc` — POIFS (`POIFSFileSystem`) вокруг крафтовых WordDocument/1Table/Data (`DocToDocxFormattingTest`). Ключевые: `too-many-pages` (150 явных разрывов → 151; `.doc`-пара — кэш PageCount=150 → 400 «не менее 151»), `stale-cache` (docx: кэш `1` + 110 `lastRenderedPageBreak` → 400; doc: кэш 5 → конвертируется — семантика запинена), `charts-smartart` (4 растра; SmartArt-одиночка = ровно 2 Image XObject; `.doc`-пара — 3 BLIP-fallback → 3 картинки), `ole-embedded` (осиротевший bin с ложным `Default bin→footer+xml` + настоящий `w:object` с честным `Override → oleObject` и VML-плейсхолдером `media/fallback.png` — ручная, генератором не перезаписывать; `.doc`-пара — OLE-fallback BLIP → 1 картинка), `chart-types` (14 графиков: 9 типов + ofPie-pie + lineChart stacked + `c:wireframe` + combo barChart+lineChart на вторичной `c:valAx` pos="r"; пересоздание — `ChartTypesDocxGenerator`; `.doc`-аналога нет), `doc-formats.doc` (2 страницы — лимит страниц на .doc-пути). - Юниты нормализаторов работают строками (`rewrite`) + zip'ами из `ZipOutputStream`; обязательные контракты: «нечего менять → тот же массив» (`assertSame`) и неприкосновенность частей вне `word/*.xml` (`[Content_Types].xml`). Тесты бьют и в package-private API (`GlyphCoverageNormalizer.split(text, family)`, `ChartSpec.readTitle`). Исключение — `OleObjectNormalizerTest`: многочастный нормализатор без `rewrite`-хука, тесты только через `normalize` на in-memory zip. -- Юниты моста (`internal/doc/`): `CfbReaderTest` строит крафтовый CFB-байтстрим (сектор 512/mini 64: FAT/DIFAT/miniFAT/directory руками) и бьёт все guard-ветки (циклы FAT/DIFAT/MiniFAT, ссылки за файл, обрезанные потоки, root без mini stream, мусор в directory); `SummaryInfoTest` — крафтовый PropertySetStream (пинит **относительность offset от начала PropertySet**, реальные фикстуры её не различают); `PieceTableTest`/`ChpxIndexTest`/`PapxIndexTest` (в т.ч. `istdFor`: istd из UpxPapx, пустой grpprl ≠ null, bOffset=0 → нет записи)/`SectionsTest`/`FibHeaderTest` (пара fcStshf)/`GrpprlTest` (в т.ч. спец-длины: двухбайтовый cb у sprmTDefTable при operand >255 Б, у 0xC60D cb=0xFF — обрыв, у 0xC615 cb=0xFF — длина по формуле §2.9.182 (`scan_pChgTabsSentinel_lengthByFormula`))/`FontTableTest`/`HeadersTest`/`OfficeArtTest` — byte[]-конструкции in memory; `StylesTest` — крафтовый STSH (LPStd/LPUpx): цепочка base→derived, цикл → пустая таблица, чужой stk/битый STSH нисходительны; `TablesTest` — крафтовый TAP: сетка TDefTable (XAS со знаком), границы Brc (cv fAuto) и Brc80 (ico, приоритет 0xD613), выравнивание sprmTJc/sprmTJc90 (u16, приоритет современного, 0 → null), деградация при битом TDefTable; `ListsTest` — крафтовые PlfLst/PlfLfo байтстримом (счёт LVL по fSimpleList 1/9, плейсхолдеры xst → `%{n+1}` и литеральный `%` → `%%`, MSONFC→ST_NumberFormat вкл. экзотика→decimal, ixchFollow→`w:suff`, grpprl уровня → `w:ind`/`w:rFonts`, LFOLVL fStartAt/fFormatting, обрыв LVL-массива, lsid без LSTF, нулевые lcb); `DocToDocxFormattingTest` — полный синтетический .doc через POIFS (крафтовые FIB/Clx/FKP-страницы: полные CHPX/PAPX-свойства, STSH-цепочка с переопределением и победой direct, spacing/tabs, таблица TTP+TDefTable+Brc с деградацией строки без сетки и многострочной ячейкой, колонтитук со стилевым jc, табы колонтитука из стиля sprmPChgTabs (`styleTabsChg_reachesFooterPart`/`styleTabsChgDel_removesStop`: прямой del с rgdxaClose вырезает stop стиля), таблица в odd footer со sprmTJc (`footerTable_jcCenterEmitted`: guard-¶ отдельным абзацем после строки, как в реальных Plcfhdd), знаки, поле в основном тексте, picLocation=0, 0Table, отсутствие табличного потока, списки: `listParagraphs_getNumPrAndNumberingPart` (sprmPIlfo/sprmPIlvl в PAPX → `w:numPr` + `word/numbering.xml` c `w:num`/Override/rels), `listCancelledByDirectZero_noNumPr` (ilfo стиля, перекрытый прямым 0), `ilvlSkipValue_noNumPr` (ilvl=0x0C), `missingListTables_degradeToPlain` (нулевые FIB-пары 73/74 — ни numbering-части, ни numPr)). Doc-регрессии конвертера — общие assert-хелперы docx-пар: `assertCyrillicAndStyles`/`assertPageNumbers`/`assertTableImage`/`assertOleObjectsRemoved`/`assertDrawingsBecomeImages`/`assertTooManyPages`/`assertExoticGlyphs` вызываются с `ru-plain.doc`/`page-numbers.doc`/`ru-table-image.doc`/`ole-embedded.doc`/`charts-smartart.doc`/`too-many-pages.doc`/`exotic-glyphs.doc` (тесты-пары называются по docx-имени, внутри зовут оба формата); `WordPdfValidatorTest#checkPageCountDoc_*` + `ConvertControllerTest` (`.doc` upload, `nonDocxFilename_rejected`). +- Юниты моста (`internal/doc/`): `CfbReaderTest` строит крафтовый CFB-байтстрим (сектор 512/mini 64: FAT/DIFAT/miniFAT/directory руками) и бьёт все guard-ветки (циклы FAT/DIFAT/MiniFAT, ссылки за файл, обрезанные потоки, root без mini stream, мусор в directory); `SummaryInfoTest` — крафтовый PropertySetStream (пинит **относительность offset от начала PropertySet**, реальные фикстуры её не различают); `PieceTableTest`/`ChpxIndexTest`/`PapxIndexTest` (в т.ч. `istdFor`: istd из UpxPapx, пустой grpprl ≠ null, bOffset=0 → нет записи)/`SectionsTest`/`FibHeaderTest` (пара fcStshf)/`GrpprlTest` (в т.ч. спец-длины: двухбайтовый cb у sprmTDefTable при operand >255 Б, у 0xC60D cb=0xFF — обрыв, у 0xC615 cb=0xFF — длина по формуле §2.9.182 (`scan_pChgTabsSentinel_lengthByFormula`))/`FontTableTest`/`HeadersTest`/`OfficeArtTest`/`PrcDataTest` — byte[]-конструкции in memory (`PrcDataTest`: разворачивание huge-PAPX/PTableProps на позиции указателя, union цепочки с легаси-зеркалом, guard'ы — cb-капа 0x3FA2, ptr за Data, цикл A→B→A); `StylesTest` — крафтовый STSH (LPStd/LPUpx): цепочка base→derived, цикл → пустая таблица, чужой stk/битый STSH нисходительны; `TablesTest` — крафтовый TAP: сетка TDefTable (XAS со знаком), границы Brc (cv fAuto) и Brc80 (ico, приоритет 0xD613), выравнивание sprmTJc/sprmTJc90 (u16, приоритет современного, 0 → null), деградация при битом TDefTable; `ListsTest` — крафтовые PlfLst/PlfLfo байтстримом (счёт LVL по fSimpleList 1/9, плейсхолдеры xst → `%{n+1}` и литеральный `%` → `%%`, MSONFC→ST_NumberFormat вкл. экзотика→decimal, ixchFollow→`w:suff`, grpprl уровня → `w:ind`/`w:rFonts`, LFOLVL fStartAt/fFormatting, обрыв LVL-массива, lsid без LSTF, нулевые lcb); `DocToDocxFormattingTest` — полный синтетический .doc через POIFS (крафтовые FIB/Clx/FKP-страницы: полные CHPX/PAPX-свойства, STSH-цепочка с переопределением и победой direct, spacing/tabs, таблица TTP+TDefTable+Brc с деградацией строки без сетки и многострочной ячейкой, колонтитук со стилевым jc, табы колонтитука из стиля sprmPChgTabs (`styleTabsChg_reachesFooterPart`/`styleTabsChgDel_removesStop`: прямой del с rgdxaClose вырезает stop стиля), таблица в odd footer со sprmTJc (`footerTable_jcCenterEmitted`: guard-¶ отдельным абзацем после строки, как в реальных Plcfhdd), знаки, поле в основном тексте, picLocation=0, 0Table, отсутствие табличного потока, списки: `listParagraphs_getNumPrAndNumberingPart` (sprmPIlfo/sprmPIlvl в PAPX → `w:numPr` + `word/numbering.xml` c `w:num`/Override/rels), `listCancelledByDirectZero_noNumPr` (ilfo стиля, перекрытый прямым 0), `ilvlSkipValue_noNumPr` (ilvl=0x0C), `missingListTables_degradeToPlain` (нулевые FIB-пары 73/74 — ни numbering-части, ни numPr)). Doc-регрессии конвертера — общие assert-хелперы docx-пар: `assertCyrillicAndStyles`/`assertPageNumbers`/`assertTableImage`/`assertOleObjectsRemoved`/`assertDrawingsBecomeImages`/`assertTooManyPages`/`assertExoticGlyphs` вызываются с `ru-plain.doc`/`page-numbers.doc`/`ru-table-image.doc`/`ole-embedded.doc`/`charts-smartart.doc`/`too-many-pages.doc`/`exotic-glyphs.doc` (тесты-пары называются по docx-имени, внутри зовут оба формата); `WordPdfValidatorTest#checkPageCountDoc_*` + `ConvertControllerTest` (`.doc` upload, `nonDocxFilename_rejected`). - App-тесты: `@SpringBootTest` + `@AutoConfigureMockMvc` (Boot 4: `org.springframework.boot.webmvc.test.autoconfigure`); три контекста — `ConvertControllerTest` (пустой ключ), `ApiKeyFilterTest` (`properties = "wordpdf.api-key=…"`), `ConvertLimitsTest`/`ConversionTimeoutTest` (`@TestPropertySource` — отдельные классы, не `@Nested`: `@Nested` + `@TestPropertySource` не даёт отдельного контекста). -- Регрессивные пары (фикс = нормализатор/pre-renderer + юнит + конвертер-тест с фикстурой): `StrictOoxmlNormalizerTest`↔`strictOoxml_convertsNotRejected` (+`pageCount_strictBreaksCountedLightweight`; юниты `indCoexistLeftStartUntouched`/`tcMarCoexistKept`/`tcBordersElementsKeptTransitional`/`jcStartRenamedTransitional`/`tabStartRenamedTransitional`/`transitionalCoexistReturnsOriginalArray`), `DocxOnOffNormalizerTest`↔`ruPlain_regularRunsUseRegularFont`, `SymbolFontNormalizerTest`↔`symbolFonts_bulletsAreNotHash`, `FieldNormalizerTest`↔`pageNumbers_recomputedNotCached`, `InvisibleCharNormalizerTest`↔`invisibleChars_noEmptyLines`, `GlyphCoverageNormalizerTest`↔`exoticGlyphs_drawnNotHash`, `OleObjectNormalizerTest`↔`oleObjects_removedAndConverted`/`drawingErrors_errorFlagRejectsOle` (+app `errorFlagOle_rejected`/`oleObjects_removedByDefault`; юниты `objectWithImagedata_placeholderKept`/`objectWithoutImage_removed`/`objectWithDrawing_reusedVerbatim`/`controlBlockRemoved`/`sizeFromDxaOrig`/`styleUnits_allConvertToEmu`/`objectWithoutBin_stillRewritten`/`externalOleLinkRelRemoved`), `WordPdfValidatorTest`↔`staleCachePageCountRejectedBeforeRender` (+`checkPageCount_limitBoundary` 99/100/101, `cachedPagesUnreadableFallsBackToZero`, `pageCount_breaksInsideTablesAreCounted`, `pageCount_continuousSectionsNotCountedLightweight`, `validate_notAZip`/`validate_plainZipRejected`/`validate_xlsxRenamedRejected`/`validate_zipBombRejected`/`validate_tooManyEntriesRejected`), `BundledFontsTest`↔`ruPlain_emDashEmbeddedNotHelvetica`, `PresetGeometryTest`↔`chartsSmartArt_drawingsBecomeImages` (`tableMatchesEcmaXml`), chart-пейнтеры↔`chartTypes_allTypesRenderAsImages`, `ChartSpecTest`↔автозаголовки/комбо/DoS (`hugePointIndex_rejectedNotOom`, `hugePtCount_rejectedNotOom`, `hugeCategoryIndex_rejectedNotOom`, `nonFiniteScalingBounds_dropped`, `overlayLegend_keepsPositionAndFlag`, `emptyTitleSingleSeriesBar_usesSeriesName`, `deletedTitleWithText_stillShown`, `deletedTitleValOmitted_stillShown`, `multiSeriesDoughnut_placeholderNotSeriesName`, `multiParagraphTitle_joinedWithNewlines`), `Surface3dPainterTest`↔`axisBounds_tinyMajorUnit_fallsBackToNiceUnit`/`axisBounds_zeroMajorUnit_fallsBackToNiceUnit`, `ChartRendererTest`↔`axisBounds_explicitHugeRange_reunitsToMaxTicks`/`axisBounds_infiniteSpan_fallsBackToData`/`stackedCumulative_*`/`stackedRange_coversNegativeSums`/`overlayLegend_drawnOverPlot`/`wireframeSurfaceLegend_hollowMarkers`, `DrawMlTextTest`↔`hugeWord_wrapsLinearly`/`fallbackFamilyAliasedToBundle`/`lineSpacingPct_compactsLines`, `DrawMlColorTest`↔`invalidSrgbHexFallsBackToOfficeDefault`, `SmartArtRendererTest`↔`normAutofitShrinksToFit`/`missingAutofitKeepsDeclaredSize`/`emptyTxBody_noPlaceholderInk`, `CartesianPainterTest`↔`stackedLine_seriesStackCumulatively`/`percentStackedLine_topSeriesFlatAtHundred`/`areaFill_closesToBaseline`/`combo_barsAndLineOnSecondary_bothDrawn`, `GlyphCoverageNormalizerTest`↔`multipleTextNodes_runLeftUntouched`/`nestedRunInTextBox_innerSplit`, `SymbolFontNormalizerTest`↔`nestedRunInTextBox_innerNormalized`, `WordPdfConverterTest`↔`noLoggingWarningInPdf`/`pdfTitle_comesFromParameter`/`hostileChartAxis_convertsNotHangs`/`hugeExtentChart_removedNotOom`/`chartWithoutExtent_errorFlagRejects`/`jcEndTransitional_rightAligned`/`rPrPosition_raisesBaseline`/`vendoredXsltTracksJarCopy` (аудит раскладки ECMA-376), `LayoutPostRendererTest`↔`tableCellPadding_textInsetLikeWord` (+`lineRuleAuto_wordSingleLinePitch` пинит метрический шаг «single» от псевдофиксов, `carlitoAutoBlock_untouched`), `TableIndentNormalizerTest`↔`tableIndentCentered_shiftedLikeWord` (+`rewritePart*`↔`headerTableIndent_centeredInHeader`, +`jcWithoutIndent_folded`/`rightWithoutIndent_folded`/`zeroIndent_folded`/`cellSpacingWithoutIndent_returnsNull`↔`tableCenteredNoIndent_shiftedLikeWord`), `NumberingSuffixNormalizerTest`↔`suffSpace_labelGetsSpace`, `ListsTest`+`DocToDocxFormattingTest#list*`↔`docLists_numberingAndBulletsRendered` (синтетический .doc со списками → PDF: `1.` `2.` `a)` `b)` `•`, ни одного `#`; фикстур со списками нет — крафт POIFS продублирован в `WordPdfConverterTest`), `SectionsTest`+`HeadersTest`+`DocToDocxFormattingTest#twoSections*/sectionBreakInTable*`↔`docMultiSection_perSectionHeaders` (двухсекционный .doc → PDF: стр. 1 — ШАПКА-1+ПОДВАЛ-1, стр. 2 — ШАПКА-2 + унаследованный ПОДВАЛ-1, ни одной `#`; крафт POIFS продублирован в `WordPdfConverterTest`). App-регрессии: `requestLimitParams_areIgnored`, `nonPositiveLimits_failStartup`, `unknownPath_notFound`, `concurrentRequests_bothSucceed`, `corruptNotAZip_rejected`, `plainZipNotDocx_rejected`, `junkInsideValidZip_conversionError` (500 на валидном .docx-контейнере с мусором), `nonDocxFilename_rejected`, `oversizedOverCoreLimit_rejected`, `drawingsAlwaysRendered`, `cyrillicAndPathInFilename_sanitizedResponseName`, `docsOpenWithoutKey`/`forwardedPrefix_healthStaysOpen`/`forwardedPrefix_docsOpenWithoutKey`, `dotSegmentOpenPrefix_rejected`, `errorFlagNotBoolean_rejected`, `methodNotSupportedReturns405`/`badContentTypeReturns415`. +- Регрессивные пары (фикс = нормализатор/pre-renderer + юнит + конвертер-тест с фикстурой): `StrictOoxmlNormalizerTest`↔`strictOoxml_convertsNotRejected` (+`pageCount_strictBreaksCountedLightweight`; юниты `indCoexistLeftStartUntouched`/`tcMarCoexistKept`/`tcBordersElementsKeptTransitional`/`jcStartRenamedTransitional`/`tabStartRenamedTransitional`/`transitionalCoexistReturnsOriginalArray`), `DocxOnOffNormalizerTest`↔`ruPlain_regularRunsUseRegularFont`, `SymbolFontNormalizerTest`↔`symbolFonts_bulletsAreNotHash`, `FieldNormalizerTest`↔`pageNumbers_recomputedNotCached`, `InvisibleCharNormalizerTest`↔`invisibleChars_noEmptyLines`, `GlyphCoverageNormalizerTest`↔`exoticGlyphs_drawnNotHash`, `OleObjectNormalizerTest`↔`oleObjects_removedAndConverted`/`drawingErrors_errorFlagRejectsOle` (+app `errorFlagOle_rejected`/`oleObjects_removedByDefault`; юниты `objectWithImagedata_placeholderKept`/`objectWithoutImage_removed`/`objectWithDrawing_reusedVerbatim`/`controlBlockRemoved`/`sizeFromDxaOrig`/`styleUnits_allConvertToEmu`/`objectWithoutBin_stillRewritten`/`externalOleLinkRelRemoved`), `WordPdfValidatorTest`↔`staleCachePageCountRejectedBeforeRender` (+`checkPageCount_limitBoundary` 99/100/101, `cachedPagesUnreadableFallsBackToZero`, `pageCount_breaksInsideTablesAreCounted`, `pageCount_continuousSectionsNotCountedLightweight`, `validate_notAZip`/`validate_plainZipRejected`/`validate_xlsxRenamedRejected`/`validate_zipBombRejected`/`validate_tooManyEntriesRejected`), `BundledFontsTest`↔`ruPlain_emDashEmbeddedNotHelvetica`, `PresetGeometryTest`↔`chartsSmartArt_drawingsBecomeImages` (`tableMatchesEcmaXml`), chart-пейнтеры↔`chartTypes_allTypesRenderAsImages`, `ChartSpecTest`↔автозаголовки/комбо/DoS (`hugePointIndex_rejectedNotOom`, `hugePtCount_rejectedNotOom`, `hugeCategoryIndex_rejectedNotOom`, `nonFiniteScalingBounds_dropped`, `overlayLegend_keepsPositionAndFlag`, `emptyTitleSingleSeriesBar_usesSeriesName`, `deletedTitleWithText_stillShown`, `deletedTitleValOmitted_stillShown`, `multiSeriesDoughnut_placeholderNotSeriesName`, `multiParagraphTitle_joinedWithNewlines`), `Surface3dPainterTest`↔`axisBounds_tinyMajorUnit_fallsBackToNiceUnit`/`axisBounds_zeroMajorUnit_fallsBackToNiceUnit`, `ChartRendererTest`↔`axisBounds_explicitHugeRange_reunitsToMaxTicks`/`axisBounds_infiniteSpan_fallsBackToData`/`stackedCumulative_*`/`stackedRange_coversNegativeSums`/`overlayLegend_drawnOverPlot`/`wireframeSurfaceLegend_hollowMarkers`, `DrawMlTextTest`↔`hugeWord_wrapsLinearly`/`fallbackFamilyAliasedToBundle`/`lineSpacingPct_compactsLines`, `DrawMlColorTest`↔`invalidSrgbHexFallsBackToOfficeDefault`, `SmartArtRendererTest`↔`normAutofitShrinksToFit`/`missingAutofitKeepsDeclaredSize`/`emptyTxBody_noPlaceholderInk`, `CartesianPainterTest`↔`stackedLine_seriesStackCumulatively`/`percentStackedLine_topSeriesFlatAtHundred`/`areaFill_closesToBaseline`/`combo_barsAndLineOnSecondary_bothDrawn`, `GlyphCoverageNormalizerTest`↔`multipleTextNodes_runLeftUntouched`/`nestedRunInTextBox_innerSplit`, `SymbolFontNormalizerTest`↔`nestedRunInTextBox_innerNormalized`, `WordPdfConverterTest`↔`noLoggingWarningInPdf`/`pdfTitle_comesFromParameter`/`hostileChartAxis_convertsNotHangs`/`hugeExtentChart_removedNotOom`/`chartWithoutExtent_errorFlagRejects`/`jcEndTransitional_rightAligned`/`rPrPosition_raisesBaseline`/`vendoredXsltTracksJarCopy` (аудит раскладки ECMA-376), `LayoutPostRendererTest`↔`tableCellPadding_textInsetLikeWord` (+`lineRuleAuto_wordSingleLinePitch` пинит метрический шаг «single» от псевдофиксов, `carlitoAutoBlock_untouched`), `TableIndentNormalizerTest`↔`tableIndentCentered_shiftedLikeWord` (+`rewritePart*`↔`headerTableIndent_centeredInHeader`, +`jcWithoutIndent_folded`/`rightWithoutIndent_folded`/`zeroIndent_folded`/`cellSpacingWithoutIndent_returnsNull`↔`tableCenteredNoIndent_shiftedLikeWord`), `NumberingSuffixNormalizerTest`↔`suffSpace_labelGetsSpace`, `ListsTest`+`DocToDocxFormattingTest#list*`↔`docLists_numberingAndBulletsRendered` (синтетический .doc со списками → PDF: `1.` `2.` `a)` `b)` `•`, ни одного `#`; фикстур со списками нет — крафт POIFS продублирован в `WordPdfConverterTest`), `PrcDataTest`+`DocToDocxFormattingTest#hugePapxRowMark_closesRowWithGridFromPrcData` (TTP-абзац с grpprl в PrcData Data-потока → `w:tbl`/`w:tr`/сетка из цепочки; фикстуры нет — `docTest.doc` заказчика не коммитим, крафт POIFS продублирован), `SectionsTest`+`HeadersTest`+`DocToDocxFormattingTest#twoSections*/sectionBreakInTable*`↔`docMultiSection_perSectionHeaders` (двухсекционный .doc → PDF: стр. 1 — ШАПКА-1+ПОДВАЛ-1, стр. 2 — ШАПКА-2 + унаследованный ПОДВАЛ-1, ни одной `#`; крафт POIFS продублирован в `WordPdfConverterTest`). App-регрессии: `requestLimitParams_areIgnored`, `nonPositiveLimits_failStartup`, `unknownPath_notFound`, `concurrentRequests_bothSucceed`, `corruptNotAZip_rejected`, `plainZipNotDocx_rejected`, `junkInsideValidZip_conversionError` (500 на валидном .docx-контейнере с мусором), `nonDocxFilename_rejected`, `oversizedOverCoreLimit_rejected`, `drawingsAlwaysRendered`, `cyrillicAndPathInFilename_sanitizedResponseName`, `docsOpenWithoutKey`/`forwardedPrefix_healthStaysOpen`/`forwardedPrefix_docsOpenWithoutKey`, `dotSegmentOpenPrefix_rejected`, `errorFlagNotBoolean_rejected`, `methodNotSupportedReturns405`/`badContentTypeReturns415`. - UI-тестов нет; гейт SPA — `npm run build` (tsc -b) + `npm run lint` (oxlint, `.oxlintrc.json`: rules-of-hooks error, only-export-components warn). Прод-автотесты (pytest 9.1.1 + requests 2.34.2, 31 проверка — 27 под маркером `needs_key` (SKIP без ключа; включая `.doc`-фикстуры обоих путей — растры/OLE и границы страниц), 4 открытых: health/SPA-root/swagger/spec; env-конфиг, `mise exec -- python -m pytest -q .` из `prod-autotests/`) гоняются CI после deploy против живого прода. diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/doc/DocToDocx.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/doc/DocToDocx.java index 8b90c17..5c6988a 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/doc/DocToDocx.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/doc/DocToDocx.java @@ -264,7 +264,10 @@ public final class DocToDocx { while (cp < to) { int paraStart = cp; long paraFc = pieces.fcOf(paraStart); - byte[] direct = papx.grpprlFor(paraFc); + // grpprl абзаца может быть вынесен Word в PrcData (Data-поток) + // через sprmPHugePapx/sprmPTableProps — разворачиваем до + // потребления: InTable/TTP/TAP видят автомат и paraProps (§2.9.210) + byte[] direct = PrcData.resolve(dataStream, papx.grpprlFor(paraFc)); int istd = istdOf(direct, papx.istdFor(paraFc)); byte[] styleChpx = styles.chpxChain(istd); StringBuilder runs = new StringBuilder(); diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/doc/Grpprl.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/doc/Grpprl.java index b01baa3..12bfe7b 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/doc/Grpprl.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/doc/Grpprl.java @@ -83,6 +83,20 @@ final class Grpprl { * отрицание индекса (список тот же, отступы абзаца сохраняются). */ static final int SPRM_P_ILFO = 0x460B; + /** + * sprmPHugePapx (§2.6.2, 4 байта): смещение PrcData (§2.9.210) в + * Data-потоке — настоящие свойства абзаца, которые Word выносит в + * grpprl вне FKP-страницы PAPX. В grpprl структуры GrpPrlAndIstd — + * единственный Prl при istd=0 (§2.6.2); разрешение — {@link PrcData#resolve}. + */ + static final int SPRM_P_HUGE_PAPX = 0x6646; + /** + * sprmPTableProps (§2.6.2, 4 байта): смещение следующего PrcData в + * цепочке (свойства строки таблицы). Разбор текущего grpprl на нём + * обрывается (§2.6.2: «MUST NOT process any more Prl elements in the + * array that contained the sprmPTableProps»). + */ + static final int SPRM_P_TABLE_PROPS = 0x646B; // Table Properties (§2.6.3, sgc 5) static final int SPRM_T_TABLE_BORDERS_80 = 0xD605; diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/doc/PrcData.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/doc/PrcData.java new file mode 100644 index 0000000..e43cba6 --- /dev/null +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/doc/PrcData.java @@ -0,0 +1,110 @@ +package ru.pjandro.wordpdf.internal.doc; + +import java.io.ByteArrayOutputStream; + +/** + * Разворачивание grpprl абзаца через PrcData — цепочку grpprl внутри + * Data-потока, [MS-DOC] §2.9.210 (PrcData = {@code [cbGrpprl:2][grpprl]}, + * поля {@code next} нет) и §2.6.2 (sprmPHugePapx/sprmPTableProps). + * + *

Настоящий Word хранит свойства абзаца не только в FKP-страницах PAPX: + * grpprl абзаца может состоять из единственного Prl + * {@code sprmPHugePapx (0x6646) + u32} (в GrpPrlAndIstd — единственный Prl + * при istd=0), а сами свойства — с {@code sprmPFInTable}/{@code sprmPFTtp}/ + * {@code sprmTDefTable}/бордюрами — лежат в PrcData в Data-потоке. Внутри + * PrcData цепочка продолжается через {@code sprmPTableProps (0x646B)}. + * Оба указателя разворачиваются на позиции указателя без обрыва + * текущего массива; цепочка обязана завершиться PrcData без обоих + * спец-спрмов (§2.6.2).

+ * + *

Отступление от spec: §2.6.2 велит массив, содержащий PTableProps, + * «не читать дальше» — Word так и делает, потому что потребляет из PrcData + * полный TAP (включая {@code sprmTInsert}), а хвост массива — легаси-зеркало + * для Word 97/2000 (Appendix A <9>). Конвертер {@code sprmTInsert} + * не читает и живёт на этом зеркале: в {@code samples/ru-table-image.doc} + * единственный {@code sprmTDefTable} (сетка) стоит именно ПОСЛЕ + * {@code sprmPTableProps} в PAPX-массиве, а в PrcData его нет вовсе. + * Поэтому свойства объединяются (union), а не замещаются: без цепочки + * теряются её sprm'ы, без зеркал — сетка.

+ * + *

Снисходительность — по образцу {@link Styles}/{@link Lists}: любой + * брак (ptr за Data, битый cbGrpprl, цикл A→B→A) останавливает цепочку, + * накопленное возвращается — без {@code ValidationException}. Спец-спрмы + * из результата всегда вырезаются (потребители {@code Grpprl.scan} их всё + * равно не понимают); прочие Prl исходного массива сохраняются в исходном + * порядке (при многосprl-массиве с HugePapx — сверхспецификацией: валидный + * Word пишет HugePapx единственным Prl).

+ */ +final class PrcData { + + /** Капа cbGrpprl: §2.9.210 «MUST be less than or equal to 0x3FA2». */ + private static final int MAX_CB_GRPPRL = 0x3FA2; + /** Максимум разобранных PrcData на абзац — защита от цикла A→B→A. */ + private static final int MAX_HOPS = 32; + + private PrcData() { + } + + /** + * Grpprl абзаца с развёрнутой цепочкой PrcData. Без указателей + * (0x6646/0x646B нет) возвращается тот же массив; иначе — + * новый: не-спец-спрмы исходника дословно, спец-спрмы заменены + * содержимым цепочки по их указателям. + */ + static byte[] resolve(byte[] dataStream, byte[] grpprl) { + if (!hasPointer(grpprl)) { + return grpprl; + } + ByteArrayOutputStream out = new ByteArrayOutputStream(grpprl.length + 64); + int[] hops = new int[1]; + copyPrls(grpprl, 0, grpprl.length, dataStream, out, hops); + return out.toByteArray(); + } + + /** Есть ли в массиве указатель на PrcData. */ + private static boolean hasPointer(byte[] grpprl) { + boolean[] found = new boolean[1]; + Grpprl.scan(grpprl, 0, grpprl.length, (sprm, buf, off, len) -> { + if (sprm == Grpprl.SPRM_P_HUGE_PAPX || sprm == Grpprl.SPRM_P_TABLE_PROPS) { + found[0] = true; + } + }); + return found[0]; + } + + /** + * Копирует Prl массива {@code buf[off..off+len)} в {@code out}: + * обычные — дословно (sprm + операнд), оба указательных — разворачивают + * целевой PrcData на позиции указателя, разбор массива продолжается + * (union зеркала и цепочки — см. javadoc класса). + */ + private static void copyPrls(byte[] buf, int off, int len, byte[] data, + ByteArrayOutputStream out, int[] hops) { + Grpprl.scan(buf, off, len, (sprm, b, operandOff, operandLen) -> { + if (sprm == Grpprl.SPRM_P_HUGE_PAPX || sprm == Grpprl.SPRM_P_TABLE_PROPS) { + follow(Grpprl.operandInt(b, operandOff, operandLen), data, out, hops); + return; + } + out.write(b, operandOff - 2, operandLen + 2); + }); + } + + /** + * Разворачивает PrcData по смещению {@code ptr} в Data-потоке. Брак + * (ptr за потоком, cbGrpprl вне {@code [1, 0x3FA2]}, grpprl не влезает, + * исчерпан бюджет цепочки) — останов без исключения. + */ + private static void follow(int ptr, byte[] data, ByteArrayOutputStream out, int[] hops) { + if (hops[0]++ >= MAX_HOPS || ptr < 0) { + return; + } + if ((long) ptr + 2 > data.length) { + return; + } + int cb = (data[ptr] & 0xFF) | ((data[ptr + 1] & 0xFF) << 8); + if (cb < 1 || cb > MAX_CB_GRPPRL || (long) ptr + 2 + cb > data.length) { + return; + } + copyPrls(data, ptr + 2, cb, data, out, hops); + } +} diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/doc/DocToDocxFormattingTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/doc/DocToDocxFormattingTest.java index 67f4dd9..58571aa 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/doc/DocToDocxFormattingTest.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/doc/DocToDocxFormattingTest.java @@ -753,6 +753,99 @@ class DocToDocxFormattingTest { assertTrue(xml.indexOf(">D3<") < xml.indexOf(">E<"), xml); } + /** + * Таблица 2×2, у которой TTP-абзац первой строки несёт grpprl, вынесенный + * Word в PrcData (Data-поток): PAPX = единственный {@code sprmPHugePapx + * (0x6646) + ptr}, а {@code sprmPFInTable}/{@code sprmPFTtp}/ + * {@code sprmTDefTable} (сетка 900+1000)/бордюры — в PrcData по ptr + * (§2.9.210, §2.6.2). Без разворачивания строка 1 не закрывается + * (маркер TTP течёт в ячейку), сетка берётся из строки 2 (500+1000). + * TTP строки 2 — прямой grpprl, как в {@link #twoRowDoc}. + */ + private static byte[] hugePapxTableDoc() throws IOException { + String text = "A" + (char) 7 + "B" + (char) 7 + (char) 7 + + "C" + (char) 7 + "D" + (char) 7 + (char) 7; + byte[] wd = new byte[TEXT_FC + text.length() * 2]; + put16(wd, 0, 0xA5EC); + put16(wd, 2, 0x00C1); + put16(wd, 10, 1 << 9); + put16(wd, 62, 4); + put32(wd, 64, wd.length); + put32(wd, 76, text.length()); + put16(wd, 152, 98); + pair(wd, 6, 0, 20); + pair(wd, 13, 20, 12); // PlcfBtePapx + pair(wd, 33, 32, 21); // Clx + byte[] t = text.getBytes(StandardCharsets.UTF_16LE); + System.arraycopy(t, 0, wd, TEXT_FC, t.length); + int page = 3 * 512; + int[] rgfc = {TEXT_FC, TEXT_FC + 4, TEXT_FC + 8, TEXT_FC + 10, + TEXT_FC + 14, TEXT_FC + 18, TEXT_FC + 20}; + for (int i = 0; i < rgfc.length; i++) { + put32(wd, page + i * 4, rgfc[i]); + } + int rgbx = page + rgfc.length * 4; + int[] bx = {87, 90, 93, 98, 101, 120}; + for (int i = 0; i < bx.length; i++) { + wd[rgbx + i * 13] = (byte) bx[i]; + } + wd[page + 511] = 6; // cpara + byte[] inTable = prl(0x2416, 1); + byte[] ttp = prl(0x2417, 1); + byte[] prc = concat(inTable, ttp, tdefTable(2, new int[] {0, 900, 1900}), + tableBorders()); // grpprl строки 1 — в PrcData по 0x10 + byte[] hugePrl = {(byte) 0x6646, (byte) (0x6646 >>> 8), 0x10, 0, 0, 0}; + byte[] ttpRow2 = concat(inTable, ttp, tdefTable(2, new int[] {0, 500, 1500}), + tableBorders()); // сетка строки 2 — «чужая», не должна победить + papxEntry(wd, page, 87, 0, inTable); // A + papxEntry(wd, page, 90, 0, inTable); // B + papxEntry(wd, page, 93, 0, hugePrl); // TTP строки 1 — только указатель + papxEntry(wd, page, 98, 0, inTable); // C + papxEntry(wd, page, 101, 0, inTable); // D + papxEntry(wd, page, 120, 0, ttpRow2); // TTP строки 2 — прямой TAP + byte[] data = new byte[160]; + put16(data, 0x10, prc.length); + System.arraycopy(prc, 0, data, 0x12, prc.length); + byte[] tab = new byte[53]; + put32(tab, 0, 0); + put32(tab, 4, text.length()); // PlcfSed + put32(tab, 20, TEXT_FC); // PlcfBtePapx aFc + pn=3 + put32(tab, 24, TEXT_FC + 20); + put32(tab, 28, 3); + tab[32] = 0x02; // Clx Pcdt + put32(tab, 33, 16); + put32(tab, 37, 0); + put32(tab, 41, text.length()); + put32(tab, 47, TEXT_FC); + try (POIFSFileSystem fs = new POIFSFileSystem(); + ByteArrayOutputStream out = new ByteArrayOutputStream()) { + fs.getRoot().createDocument("WordDocument", new ByteArrayInputStream(wd)); + fs.getRoot().createDocument("1Table", new ByteArrayInputStream(tab)); + fs.getRoot().createDocument("Data", new ByteArrayInputStream(data)); + fs.writeFilesystem(out); + return out.toByteArray(); + } + } + + @Test + void hugePapxRowMark_closesRowWithGridFromPrcData() throws IOException { + String xml = documentXml(hugePapxTableDoc()); + assertEquals(1, xml.split("", -1).length - 1, xml); + assertEquals(2, xml.split("", -1).length - 1, "строки: " + xml); + assertEquals(4, xml.split("", -1).length - 1, "ячейки: " + xml); + assertTrue(xml.contains("") + && xml.contains(""), + "сетка должна прийти из PrcData: " + xml); + assertFalse(xml.contains(""), + "сетка строки 2 не должна открыть таблицу: " + xml); + assertTrue(xml.contains("") < xml.indexOf(">A<"), "A в таблице: " + xml); + assertTrue(xml.indexOf(">D<") < xml.indexOf(""), "D в таблице: " + xml); + assertTrue(xml.indexOf(">A<") < xml.indexOf(">B<") + && xml.indexOf(">B<") < xml.indexOf(">C<") + && xml.indexOf(">C<") < xml.indexOf(">D<"), xml); + } + // --- четвёртый документ: списки -------------------------------------- /** diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/doc/PrcDataTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/doc/PrcDataTest.java new file mode 100644 index 0000000..b610d0a --- /dev/null +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/doc/PrcDataTest.java @@ -0,0 +1,189 @@ +package ru.pjandro.wordpdf.internal.doc; + +import static org.junit.jupiter.api.Assertions.assertArrayEquals; +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertSame; + +import java.io.ByteArrayOutputStream; +import org.junit.jupiter.api.Test; + +/** + * Юниты разворачивания grpprl через PrcData ([MS-DOC] §2.9.210, §2.6.2: + * sprmPHugePapx 0x6646 / sprmPTableProps 0x646B). Крафт — байтовые массивы + * in memory, как в {@code CfbReaderTest}: PrcData = [cbGrpprl:2][grpprl]; + * содержимое задаётся лямбдой {@code at -> ...}, где {@code at[i]} — + * смещение i-го PrcData в собранном Data-потоке. + */ +class PrcDataTest { + + private static final byte[] EMPTY = new byte[0]; + private static final byte[] DATA_EMPTY = new byte[16]; + + @Test + void noPointerSprms_returnsSameArray() { + byte[] grpprl = inTable(); + assertSame(grpprl, PrcData.resolve(DATA_EMPTY, grpprl)); + assertSame(EMPTY, PrcData.resolve(DATA_EMPTY, EMPTY)); + } + + @Test + void hugePapx_insertsPrcDataSprms() { + DataStream d = data(at -> concat(inTable(), ttp())); + assertArrayEquals(concat(inTable(), ttp()), + PrcData.resolve(d.bytes, ptr(0x6646, d.at[0]))); + } + + @Test + void tablePropsChain_mergesKeepingTailAfterPointer() { + // PrcData[0] = [jc][→PrcData[1]][inTable]; PrcData[1] = [inTable]. + // Хвост после PTableProps СОХРАНЯЕТСЯ: spec (§2.6.2) велит его игнорировать, + // но Word пишет в нём легаси-зеркало (в ru-table-image.doc — единственный + // TDefTable), а TInsert из PrcData конвертер не читает → union. + DataStream d = data(at -> concat(prl(0x2461, 2), ptr(0x646B, at[1]), inTable()), + at -> inTable()); + assertArrayEquals(concat(prl(0x2461, 2), inTable(), inTable()), + PrcData.resolve(d.bytes, ptr(0x6646, d.at[0]))); + } + + @Test + void hugePapxInMultiPrlArray_othersKeptInPlace() { + DataStream d = data(at -> inTable()); + assertArrayEquals(concat(prl(0x2461, 2), inTable(), prl(0x2407, 1)), + PrcData.resolve(d.bytes, + concat(prl(0x2461, 2), ptr(0x6646, d.at[0]), prl(0x2407, 1)))); + } + + @Test + void topLevelTableProps_expandsChainKeepsTail() { + // Ровная форма TTP-массива из ru-table-image.doc: PTableProps первым, + // легаси-зеркало (здесь — jc) после него; побеждает оба (union). + DataStream d = data(at -> inTable()); + assertArrayEquals(concat(inTable(), prl(0x2461, 2)), + PrcData.resolve(d.bytes, concat(ptr(0x646B, d.at[0]), prl(0x2461, 2)))); + } + + @Test + void pointerBeyondData_keepsForeignPrlsStops() { + assertArrayEquals(prl(0x2461, 2), + PrcData.resolve(DATA_EMPTY, concat(prl(0x2461, 2), ptr(0x6646, 1000)))); + } + + @Test + void hugePapxCutOffAtEndOfData_stops() { + byte[] d = new byte[33]; + d[32] = 40; // cb=40, grpprl за конец Data (32+2+40 > 33) + assertArrayEquals(EMPTY, PrcData.resolve(d, ptr(0x6646, 32))); + } + + @Test + void pointerTopBitSet_rejected() { + // u32 ≥ 2^31 → operandInt отдаёт отрицательный int — вне Data + assertArrayEquals(prl(0x2461, 2), + PrcData.resolve(DATA_EMPTY, concat(prl(0x2461, 2), ptr(0x6646, -1)))); + } + + @Test + void zeroCb_rejected() { + assertArrayEquals(EMPTY, PrcData.resolve(DATA_EMPTY, ptr(0x6646, 0))); + } + + @Test + void cbAboveSpecCap_rejected() { + byte[] d = new byte[0x4000]; + d[1] = 0x40; // cb = 0x4000 > 0x3FA2 (капа §2.9.210) + assertArrayEquals(EMPTY, PrcData.resolve(d, ptr(0x6646, 0))); + } + + @Test + void cycleStopsWithinHopBudget() { + // PrcData[0] ↔ PrcData[1] — цикл через PTableProps; разбор обязан + // остановиться (цепочка по spec обязана завершаться) без исключения. + DataStream d = data(at -> ptr(0x646B, at[1]), at -> ptr(0x646B, at[0])); + assertArrayEquals(prl(0x2461, 2), + PrcData.resolve(d.bytes, concat(ptr(0x6646, d.at[0]), prl(0x2461, 2)))); + } + + @Test + void selfPointerStops() { + DataStream d = data(at -> ptr(0x6646, at[0])); + assertEquals(0, PrcData.resolve(d.bytes, ptr(0x6646, d.at[0])).length); + } + + @Test + void missingDataStream_keepsForeignPrls() { + assertArrayEquals(prl(0x2461, 2), + PrcData.resolve(new byte[0], concat(prl(0x2461, 2), ptr(0x6646, 0)))); + } + + // --- крафт ----------------------------------------------------------- + + /** Строит grpprl PrcData по смещениям готового потока. */ + private interface GrpBuilder { + byte[] build(int[] at); + } + + /** Data-поток и смещения, по которым легли его PrcData. */ + private static final class DataStream { + byte[] bytes; + int[] at; + } + + /** Потоковый Prl: toggle-спрм (sprm 2 Б + операнд 1 Б). */ + private static byte[] prl(int sprm, int toggle) { + return new byte[] {(byte) sprm, (byte) (sprm >>> 8), (byte) toggle}; + } + + private static byte[] inTable() { + return prl(0x2416, 1); // sprmPFInTable + } + + private static byte[] ttp() { + return prl(0x2417, 1); // sprmPFTtp + } + + /** Указательный Prl: 0x6646/0x646B (spra=3) + u32 смещение PrcData в Data. */ + private static byte[] ptr(int sprm, int offset) { + return new byte[] {(byte) sprm, (byte) (sprm >>> 8), + (byte) offset, (byte) (offset >>> 8), + (byte) (offset >>> 16), (byte) (offset >>> 24) }; + } + + private static byte[] concat(byte[]... parts) { + int len = 0; + for (byte[] p : parts) { + len += p.length; + } + byte[] out = new byte[len]; + int at = 0; + for (byte[] p : parts) { + System.arraycopy(p, 0, out, at, p.length); + at += p.length; + } + return out; + } + + /** + * Data-поток: grpprl'ы PrcData подряд, каждый с префиксом cbGrpprl. + * Смещения считаются первым проходом (длина {@code ptr}-Prl не зависит + * от значения указателя), тела — вторым, уже с финальными {@code at}. + */ + private static DataStream data(GrpBuilder... grps) { + int[] at = new int[grps.length]; + int pos = 0; + for (int i = 0; i < grps.length; i++) { + at[i] = pos; + pos += 2 + grps[i].build(new int[grps.length]).length; + } + ByteArrayOutputStream out = new ByteArrayOutputStream(); + for (GrpBuilder grp : grps) { + byte[] body = grp.build(at); + out.write(body.length & 0xFF); + out.write((body.length >>> 8) & 0xFF); + out.write(body, 0, body.length); + } + DataStream d = new DataStream(); + d.bytes = out.toByteArray(); + d.at = at; + return d; + } +}