diff --git a/AGENTS.md b/AGENTS.md
index a7598ec..6fb2f2e 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -43,21 +43,21 @@
|`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, rMarkDel 0x0800/rMarkIns 0x0801 (непринятые правки → `w:del`/`w:ins`), smallCaps 0x083A/caps 0x083B (апкейс текста в мосту), vanish 0x083C (фильтр рана — FO `w:vanish` не читает), hpsPos 0x4845 (со знаком, hps → `w:position`), **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 (перед ним keepFollow 0x2406/keep 0x2405 → `w:keepNext`/`w:keepLines`), 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 вне контура), sprmTVertAlign 0xD62C (CellRangeVertAlign §2.9.30: cb=3 + itcFirst + itcLim + VerticalAlign 0/1/2 → `w:vAlign`; cb≠3 — операнд игнорируется). Спец-длины операндов 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), **sprmCHighlight 0x2A0C** (Ico §2.9.171 → `w:highlight`, член ST_HighlightColor §17.18.42 по RGB 1:1), **sprmCShd 0xCA71**/**sprmCShd80 0x4866** (SHDOperand §2.9.177 = cb(1)=10 + cvFore/cvBack COLORREF + ipat §2.9.178; Shd80 u16 5+5+6 §2.9.176 → `w:shd`, форма Word `w:val="clear"`: fill=cvFore при ipatSolid иначе cvBack; ipatAuto/оба цвета auto → не эмитится — FOP красит только w:fill, зонд 2026-11), **sprmCIstd 0x4A30** (ссылка на символьный стиль §2.4.6.5 → `Styles.charChain`), sprmCFSpec 0x0875, rMarkDel 0x0800/rMarkIns 0x0801 (непринятые правки → `w:del`/`w:ins`), smallCaps 0x083A/caps 0x083B (апкейс текста в мосту), vanish 0x083C (фильтр рана — FO `w:vanish` не читает), hpsPos 0x4845 (со знаком, hps → `w:position`), **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 (перед ним keepFollow 0x2406/keep 0x2405 → `w:keepNext`/`w:keepLines`), InTable 0x2416, sprmPFTtp 0x2417, **sprmPShd 0xC64D**/**sprmPShd80 0x442D** (тот же Shd/Shd80 → `w:shd` в pPr до `w:tabs`, CT_PPr §17.3.1.26), 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 вне контура), sprmTVertAlign 0xD62C (CellRangeVertAlign §2.9.30: cb=3 + itcFirst + itcLim + VerticalAlign 0/1/2 → `w:vAlign`; cb≠3 — операнд игнорируется), **sprmTCellPadding 0xD632**/**sprmTCellPaddingDefault 0xD634** (CSSAOperand §2.9.209: cb(1)=6 + itc(2 ItcFirstLim) + grfbrc (top|left|bottom|right = 1|2|4|8) + ftsWidth + wWidth(2); переносится только ftsDxa, Default-operand действует на весь ряд (§2.63 фиктивные itc 0/1 → [0,∞)) → `w:tcMar`, порядок детей CT_TcMar §17.4.66). **sprmTInsert 0x7621 пропускается по правилу spra=3 (4 байта)** — эмпирика живых образцов (ru-table-image.doc/ru-en-mixed.doc: following-sprm выравнивается ровно при 4; MS-DOC-форма rgttte 2+6·ctc Word'ом не пишется, сетка из sprmTInsert мостом не строится). Спец-длины операндов 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 → свойств нет (дефолт), но **граница rgfc[j+1] в индекс заносится** — иначе дефолтный ран проглотил бы последующие CHPX-раны абзаца (регрессии ChpxIndexTest#zeroOffset_defaultPropsBoundaryKept, WordPdfConverterTest#docClassD_landscapeHiddenDelCaps); **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, cellVAlign)`: 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); вертикальное выравнивание ячеек: sprmTVertAlign 0xD62C (CellRangeVertAlign §2.9.30) → `cellVAlign[]` по индексам колонок (диапазоны clamped к сетке, top/вне диапазона — не эмитится) → `w:vAlign` в `w:tcPr` после `w:gridSpan` (регрессии — TablesTest#vertAlign_*, DocToDocxFormattingTest#cellVertAlign_*). `null` (нет/битый TDefTable, неположительная ширина) → строка деградирует в плоские абзацы|
+|`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; **stk=3 (STCF — символьные стили Word 97+)** — единственный UPX[0]=UpxChpx целиком, отдельная цепочка `charChain(istd)` (источник ссылки — sprmCIstd, §2.4.6.5); stk=2 (легаси STDC) не читается. Цепочка base-first (предок раньше потомка, last-wins при скане); istdBase 0x0FFF — без предка, цикл — обрыв на MAX_CHAIN=16. Разбор **снисходительный** (образец FontTable): битый/отсутствующий STSH → пустая таблица, конвертация на прямых свойствах, без `ValidationException`|
+|`Tables`|TAP TTP-абзаца (§2.6.3) → `Grid(colWidths, indent, bordersXml, tblJc, cellVAlign, cellMargins)`: 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); вертикальное выравнивание ячеек: sprmTVertAlign 0xD62C (CellRangeVertAlign §2.9.30) → `cellVAlign[]` по индексам колонок (диапазоны clamped к сетке, top/вне диапазона — не эмитится) → `w:vAlign` в `w:tcPr` после `w:gridSpan` (регрессии — TablesTest#vertAlign_*, DocToDocxFormattingTest#cellVertAlign_*); поля ячеек: sprmTCellPadding/…Default (CSSAOperand §2.9.209, только ftsDxa, wWidth ≤ 31680) → `cellMargins[]` (record `CellMargin(itcFirst, itcLim, sideMask, width)`, Default — весь ряд) → `w:tcMar` в `w:tcPr` до `w:vAlign` (CT_TcMar §17.4.66; регрессии — TablesTest#cellPadding_*, DocToDocxFormattingTest#cellMargins_becomeTcMar, пайплайн — WordPdfConverterTest#tableTcMar_textInsetLikeWord). `null` (нет/битый TDefTable, неположительная ширина) → строка деградирует в плоские абзацы|
|`Lists`|§2.9.200/.201 PlfLst/PlfLfo → `word/numbering.xml`: PlfLst — cLst SHORT (2 Б) при `fc`, rgLstf с `fc+2` (§2.9.201, Figure 56); LSTF (28 Б, fSimpleList→1 LVL иначе 9, массив LVL приложен за `fc+lcb`) + LVL (LVLF 28 Б: iStartAt/nfc/jc/ixchFollow/cbGrpprl'ы; Xst: плейсхолдеры 0x00–0x08 → `%{n+1}`, литеральный `%` → `%%`) → `w:abstractNum` (MSONFC [MS-OSHARED §2.2.1.3] → ST_NumberFormat §17.18.59, общий `numFmt` с `DocxBody.appendPgNumType`, экзотика CJK → decimal — нет глифов в бандле; ixchFollow 1/2 → `w:suff` space/nothing, 0=tab не эмитится; grpprlPapx уровня → `w:ind`, grpprlChpx → `w:rPr` rFonts/b/sz); LFO (lsid→первый LSTF) + LFOLVL (fStartAt → `w:startOverride`, fFormatting → полный `w:lvl`) → `w:num` (numId = 1-базированный ilfo). Снисходительно (образец `Styles`): битая таблица/обрыв LVL → пустой/неполный результат; `hasNum` — numId разрешается в валидный abstractNum, иначе абзацы деградируют в плоские|
-|`Sections`|PlcfSed (§2.8.26): aCP n+1 + Sed n (12 Б) + Sepx (cb + секционные sprm) → `list()` — список record'ов `Section` (CP-диапазон, геометрия секции, `continuous` из sprmSBkc, `landscape` из sprmSBOrientation 0x301D (§2.9.236: 1/2), нумерация страниц — `pgNumStart` (0 = не задан; sprmSFPgnRestart 0x3011 + sprmSPgnStart97 0x501C, restart без start клампится к 1) и `nfcPgn` (sprmSNfcPgn 0x300E, MSONFC), колонки — sprmSCcolumns 0x500B (число − 1, кап 44), sprmSFEvenlySpaced 0x3005 (Bool8, дефолт true), sprmSDxaColumns 0x900C; при неравных колонках per-column ширины/зазоры из sprmSDxaColWidth 0xF203/sprmSDxaColSpacing 0xF204 (SDxaColWidthOperand/SDxaColSpacingOperand §2.9.241/.242: iCol+dxa)); невозрастающие aCP → `ValidationException`; финальный aCP реальные файлы пишут за ccpText (PLC покрывает весь текстовый поток) — конец последней секции клампится к ccpText; `pageWidth()`/`header()`/`footer()` — геометрия последней секции (полоса набора для правила 7), `continuousSectionEnds()` — вычитание из подсчёта страниц (последняя секция не считается)|
+|`Sections`|PlcfSed (§2.8.26): aCP n+1 + Sed n (12 Б) + Sepx (cb + секционные sprm) → `list()` — список record'ов `Section` (CP-диапазон, геометрия секции, `continuous` из sprmSBkc, `landscape` из sprmSBOrientation 0x301D (§2.9.236: 1/2), нумерация страниц — `pgNumStart` (0 = не задан; sprmSFPgnRestart 0x3011 + sprmSPgnStart97 0x501C, restart без start клампится к 1) и `nfcPgn` (sprmSNfcPgn 0x300E, MSONFC), колонки — sprmSCcolumns 0x500B (число − 1, кап 44), sprmSFEvenlySpaced 0x3005 (Bool8, дефолт true), sprmSDxaColumns 0x900C; при неравных колонках per-column ширины/зазоры из sprmSDxaColWidth 0xF203/sprmSDxaColSpacing 0xF204 (SDxaColWidthOperand/SDxaColSpacingOperand §2.9.241/.242: iCol+dxa)); `titlePage` из sprmSFTitlePage 0x300A (Bool8)); невозрастающие aCP → `ValidationException`; финальный aCP реальные файлы пишут за ccpText (PLC покрывает весь текстовый поток) — конец последней секции клампится к ccpText; `pageWidth()`/`header()`/`footer()` — геометрия последней секции (полоса набора для правила 7), `continuousSectionEnds()` — вычитание из подсчёта страниц (последняя секция не считается)|
|`FontTable`|SttbfFfn (§2.9.147): индекс ftc → имя семейства в `w:rFonts`|
|`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-пути)|
+|`Headers`|Plcfhdd (§2.4.1): 6 разделителей + по 6 историй на секцию (even/odd/first × hdr/ftr); odd hdr/ftr **каждой** секции → своя часть `headerN.xml`/`footerN.xml` (нумерация независимая по типу) и `headerReference`/`footerReference` type="default" в её sectPr; **first hdr/ftr (слоты 4/5 §2.8.22)** — только когда у секции Sepx задал sprmSFTitlePage → `type="first"` (нумерация общая с first-частями; регрессия — DocToDocxFormattingTest#titlePage_emittedAfterCols, WordPdfConverterTest#docTitlePage_firstHeaderOnlyFirstPage); пустая история [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 нет)|
|`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; флаги рана: vanish — мост фильтрует вывод рана (`w:vanish` в FO мёртв), caps/smallCaps — `Character.toUpperCase` в мосту (`w:caps`/`w:smallCaps` конвейер не читает, FOP без font-variant), rMarkIns/rMarkDel — ран оборачивается в `w:ins`/`w:del`+`w:delText` (шаблоны docx2fo рисуют правки — вид «Show Markup»), hpsPos → `w:position` (вендорный AUDIT-FIX → baseline-shift)), ¶ → ``; TAB/0x0B → `w:tab`/`w:br`, 0x0E → `w:br type="column"` (конец колонки при sprmSCcolumns), 0x0C в ране → `w:br type="page"`, 0x0C в конце абзаца — **разрыв секции**: `sectPr` соответствующей `Sections.Section` (матчинг по конечному CP) в pPr этого абзаца, внутри таблицы деградирует в `w:br type="page"`; body-level `sectPr` — последняя секция; `w:type continuous` из sprmSBkc; `w:pgSz w:orient="landscape"` со сменой w/h местами, `w:pgNumType` (`w:start` при restart, `w:fmt` только для числовых nfc — общий маппинг `Lists.numFmt`), `w:cols` (evenly → `w:num`+`w:space`, иначе per-column `w:col`; неравные/неполные ширины → деградация в одноколонную) — `DocxBody.sectPrXml`/`appendPgNumType`/`appendCols`; pPr: `w:keepNext`/`w:keepLines` перед `w:pageBreakBefore` (CT_PPr §17.3.1.26); 0x1E → U+2011, 0x1F → U+00AD, 0x02/0x03/0x04 (сноски) → пропуск; U+0001/U+0008 со sprmCPicLocation → DrawingML `pic` (общий путь с картинками и OLE-fallback; 0x08 — якорь плавающей картинки §2.9.267, переносится inline-приближением: PlcfSpa не читается, позиция/обтекание теряются); field-символы в основном тексте: инструкция скрыта, кэшированный результат после разделителя видим; **табличный автомат**: абзац с 0x07 без TTP закрывает ячейку, 0x07+sprmPFTtp — конец строки (`Tables.parse` по TAP → `w:tbl`/`w:tr`/`w:tc`, сам маркер не эмитится), sprmPFInTable открывает ячейку; без корректного TDefTable строка деградирует в плоские абзацы (прежнее поведение); сетка первой строки действует на всю таблицу как `tblGrid`, ширины/объединение ячеек каждой строки — из её собственного TDefTable (горизонтальное слияние → `w:gridSpan`)|
+|`DocToDocx`|Оркестратор + вложенный `DocxBody`: текст → раны (CHPX+стилевой chpx-цепочка +chpx-цепочка символьного стиля по **sprmCIstd** (`Styles.charChain` — между стилевой цепочкой и прямыми, §2.4.6.5) → rPr (в т.ч. `w:highlight`/`w:shd`), прямой 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; флаги рана: vanish — мост фильтрует вывод рана (`w:vanish` в FO мёртв), caps/smallCaps — `Character.toUpperCase` в мосту (`w:caps`/`w:smallCaps` конвейер не читает, FOP без font-variant), rMarkIns/rMarkDel — ран оборачивается в `w:ins`/`w:del`+`w:delText` (шаблоны docx2fo рисуют правки — вид «Show Markup»), hpsPos → `w:position` (вендорный AUDIT-FIX → baseline-shift)), ¶ → ``; TAB/0x0B → `w:tab`/`w:br`, 0x0E → `w:br type="column"` (конец колонки при sprmSCcolumns), 0x0C в ране → `w:br type="page"`, 0x0C в конце абзаца — **разрыв секции**: `sectPr` соответствующей `Sections.Section` (матчинг по конечному CP) в pPr этого абзаца, внутри таблицы деградирует в `w:br type="page"`; body-level `sectPr` — последняя секция; `w:type continuous` из sprmSBkc; `w:pgSz w:orient="landscape"` со сменой w/h местами, `w:pgNumType` (`w:start` при restart, `w:fmt` только для числовых nfc — общий маппинг `Lists.numFmt`), `w:cols` (evenly → `w:num`+`w:space`, иначе per-column `w:col`; неравные/неполные ширины → деградация в одноколонную), `w:titlePg` из `Section.titlePage` (после w:cols, CT_SectPrBase §17.2.3) — `DocxBody.sectPrXml`/`appendPgNumType`/`appendCols`; pPr: `w:shd` из sprmPShd/…80 перед `w:tabs` (CT_PPr §17.3.1.26), `w:keepNext`/`w:keepLines` перед `w:pageBreakBefore` (CT_PPr §17.3.1.26); 0x1E → U+2011, 0x1F → U+00AD, 0x02/0x03/0x04 (сноски) → пропуск; U+0001/U+0008 со sprmCPicLocation → DrawingML `pic` (общий путь с картинками и OLE-fallback; 0x08 — якорь плавающей картинки §2.9.267, переносится inline-приближением: PlcfSpa не читается, позиция/обтекание теряются); field-символы в основном тексте: инструкция скрыта, кэшированный результат после разделителя видим; **табличный автомат**: абзац с 0x07 без TTP закрывает ячейку, 0x07+sprmPFTtp — конец строки (`Tables.parse` по TAP → `w:tbl`/`w:tr`/`w:tc`, сам маркер не эмитится), sprmPFInTable открывает ячейку; без корректного TDefTable строка деградирует в плоские абзацы (прежнее поведение); сетка первой строки действует на всю таблицу как `tblGrid`, ширины/объединение ячеек каждой строки — из её собственного TDefTable (горизонтальное слияние → `w:gridSpan`)|
|`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`) не переносится, горизонтальное — переносится собственной сеткой строки (TTP-абзац каждой строки несёт свой `sprmTDefTable`, §2.9.321 → `w:gridSpan`+суммарный `w:tcW`; регрессия — WordPdfConverterTest#docMergedTableRow_fullWidthNotSplit, юниты — DocToDocxFormattingTest#mergedRow_gridSpanAndWidth, #misalignedRow_fallsBackToColumnWidths), вложенные таблицы (sprmPFInnerTtp — разделитель ячейки/строки там ¶ 0x0D, не 0x07) и бордюры уровня ячейки (TC80/sprmTCellBorders) не переносятся — только сетка и строковые границы; строки, у которых сетка задана только `sprmTInsert` (в PrcData нет `sprmTDefTable`, а PAPX-зеркало отсутствует), деградируют в плоские абзацы (`sprmTInsert` конвертер не читает); `DocFile.countPages` (`PapxIndex.countPageBreakBefore`) цепочку PrcData не следует — свойства вне FKP в подсчёт страниц не попадают, 0x0C-разрывы считаются; сноски/концевые сноски/комментарии не рендерятся (метки ссылок пропускаются); плавающие объекты (якорь 0x08) — только inline-картинкой: позиция/плавание/обтекание (PlcfSpa) не переносятся; непринятые правки рендерятся как разметка (`w:ins`/`w:del`, вид «Show Markup»), эмуляция принятия правок не делается; скрытый текст вырезается мостом сам (с 2026-11 `.docx`-путь чистит и его — правило 9, но мост не ждёт байтового прохода), ВСЕ ПРОПИСНЫЕ/малые капители — апкейс текста (FOP без font-variant); подсветка `sprmCHighlight` 0x2A0C и затенения (`sprmCShd` 0xCA71/`sprmPShd` 0xC64D/`sprmTSetShd` 0xD62D) мостом не переносятся — **сам конвейер `.docx`-путём `w:highlight`/`w:shd` рисует** (замер пикселями 2026-11: 1130 жёлтых px@150dpi, baseline 0; прежняя формулировка «у fo:inline в FOP фона нет» ошибочна), перенос `sprmCHighlight`/`sprmCShd` в мосту — отдельная задача; границы абзацев (sprmPBfc/sprmPBcl + PlfBdx §2.9.8) не переносятся (нужен отдельный PLC-парсер); чётные и 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`) не переносится, горизонтальное — переносится собственной сеткой строки (TTP-абзац каждой строки несёт свой `sprmTDefTable`, §2.9.321 → `w:gridSpan`+суммарный `w:tcW`; регрессия — WordPdfConverterTest#docMergedTableRow_fullWidthNotSplit, юниты — DocToDocxFormattingTest#mergedRow_gridSpanAndWidth, #misalignedRow_fallsBackToColumnWidths), вложенные таблицы (sprmPFInnerTtp — разделитель ячейки/строки там ¶ 0x0D, не 0x07) и бордюры уровня ячейки (TC80/sprmTCellBorders) не переносятся — только сетка и строковые границы; строки, у которых сетка задана только `sprmTInsert` (в PrcData нет `sprmTDefTable`, а PAPX-зеркало отсутствует), деградируют в плоские абзацы (`sprmTInsert` конвертер не читает); `DocFile.countPages` (`PapxIndex.countPageBreakBefore`) цепочку PrcData не следует — свойства вне FKP в подсчёт страниц не попадают, 0x0C-разрывы считаются; сноски/концевые сноски/комментарии не рендерятся (метки ссылок пропускаются); плавающие объекты (якорь 0x08) — только inline-картинкой: позиция/плавание/обтекание (PlcfSpa) не переносятся; непринятые правки рендерятся как разметка (`w:ins`/`w:del`, вид «Show Markup»), эмуляция принятия правок не делается; скрытый текст вырезается мостом сам (с 2026-11 `.docx`-путь чистит и его — правило 9, но мост не ждёт байтового прохода), ВСЕ ПРОПИСНЫЕ/малые капители — апкейс текста (FOP без font-variant); подсветка и затенения перенесены аудитом 2026-11: `sprmCHighlight` 0x2A0C → `w:highlight` (Ico→ST_HighlightColor по RGB), `sprmCShd` 0xCA71/`sprmCShd80` 0x4866/`sprmPShd` 0xC64D/`sprmPShd80` 0x442D → `w:shd` (форма `w:val="clear"` + цвет в `w:fill` — FOP закрашивает только w:fill, зонд 2026-11: `w:val="solid" w:color=RRGGBB w:fill="auto"` не рисует ничего; ipatSolid → fill=cvFore, иначе fill=cvBack — паттерны Ipat≥2 деградируют, [MS-DOC] Ipat: «lost if converted to ECMA-376»); затенение таблицы/ячеек (`sprmTSetShd` 0xD62D/`sprmTSetShd80` 0xD60F) мостом не переносится; тип подчёркивания не переносится: KUL любой → `w:u val="single"` (double/dotted деградируют, `sprmCCvUl` не читается); границы абзацев (хранятся sprm PAPX 0xC64E–0xC652, а не PlfBdx §2.9.8) не переносятся — и конвейер `w:pBdr` не рисует (в docx4j-export-fo 17.3.2 нет getPBdr, байткод 2026-11); не переносятся и не были бы нарисованы (в docx4j-export-fo 17.3.2 нет соответствующих getters — байткодовый зонд 2026-11): `w:tcBorders` (границы ячеек — TC80/sprmTCellBorders), `w:trHeight` (sprmTRheight), `w:tblHeader` (sprmTfHdrTbl), `w:cantSplit` (sprmTfCantSplit), `w:widowControl` (sprmPFWidowControl); отступы в символьных единицах `sprmPDxcLeft`/`sprmPDxcRight`/`sprmPDxcLeft1` 0x4456/0x4455/0x4457 не переносятся — операнд есть 1/100 ширины символа (§2.6.1), перевод в twips требует ширины глифа «0» разрешённого шрифта, коей у моста нет (guard `fCharLineUnits` §2.6.2: в обычных документах этих Prl нет вовсе); чётные варианты колонтитуков не переносятся (переносится только odd → `type="default"`, FOP не различает чётность полос набора); first-page переносится аудитом 2026-11 — sprmSFTitlePage + `type="first"` (см. строку `Headers`); разрыв секции в абзаце со 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`)
@@ -243,7 +243,7 @@ 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`) и защитные ветви сканеров нормализаторов/валидатора.
-- 57 тестовых класса / 868 теста (core 51/825 — из них 17 классов / 210 тестов в `internal/doc/`, `WordPdfConverterTest` 72 — включая блок аудита .docx 2026-11: правила 9–10, AUDIT-FIX-2 и пиннинг сносок/полей/titlePg/vMerge/sdt/txbx/OMML/highlight на синтетике через хелпер `docx(...)`; 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`).
+- 57 тестовых класса / 886 теста (core 51/843 — из них 17 классов / 225 тестов в `internal/doc/`, `WordPdfConverterTest` 75 — включая блок аудита .docx 2026-11: правила 9–10, AUDIT-FIX-2 и пиннинг сносок/полей/titlePg/vMerge/sdt/txbx/OMML/highlight на синтетике через хелпер `docx(...)`; 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.
@@ -251,5 +251,5 @@ java -cp wordpdf-core/target/test-classes:$(cat /tmp/cp.txt) \
- Юниты нормализаторов работают строками (`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`/`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` (`@TestPropertySource` max-mb/max-pages), `ConversionTimeoutTest` (`@TestPropertySource` convert-timeout=1ms) — четыре разных набора свойств = четыре кэшированных контекста (отдельные классы, не `@Nested`: `@Nested` + `@TestPropertySource` не даёт отдельного контекста); `ConversionServiceTest`/`ApiExceptionHandlerTest` — без Spring-контекста (прямые юниты).
-- Регрессивные пары (фикс = нормализатор/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`), `ChpxIndexTest#zeroOffset_defaultPropsBoundaryKept`+`DocToDocxFormattingTest#runFlags_*/keepNextKeepLines_*/sectLandscapePgNumCols_*/sectUnevenCols_*/cellVertAlign_*/drawnObject_*`+`SectionsTest#orientationPgNumColumns_applied/unevenColumns_perIndexWidths/restartWithoutStart_clampsToOne`+`TablesTest#vertAlign_*`↔`WordPdfConverterTest#docClassD_landscapeHiddenDelCaps/#docClassD_pageNumberRestartLowerRoman/#docClassD_twoColumnsBreak/#docClassD_drawnObjectBecomesImage` (закрытие пробелов класса D: vanish-фильтр/правки/caps/position/keep, landscape+pgNumType, колонки+column break, vAlign, 0x08→inline-картинка; фикстур нет — крафт POIFS продублирован в обоих тестовых классах), `HiddenTextNormalizerTest`↔`hiddenText_notPrinted` (правило 9), `RubyNormalizerTest`↔`rubyBase_textPrinted` (правило 10), AUDIT-FIX-2↔`movedRevision_textPrinted`/`bdoDir_textPrinted` (фикстур нет — синтетический docx через общий хелпер `docx(docXmlns, body, sect, rels, overrides, parts)`), пиннинг аудита .docx↔`footnote_rendersAtPageBottom`, `endnote_rendersAtDocumentEnd`, `docxHyperlink_uriAnnotation`, `pageRefField_liveNotCached` (кэш 9001/7777 заменён живым номером), `dateField_notStaleCache` (кэш 01.02.2003 заменён текущей датой), `titlePg_firstPageHeader`, `vMergeCell_spansRows`, `sdtContent_rendered`, `drawingTextBox_textPrinted`, `ommlMath_drawnAsVectors` (пиксели: +150 тёмных px@150dpi сверх текста), `highlightAndShading_backgroundDrawn` (жёлтые px >0 против baseline 0). 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`), `ChpxIndexTest#zeroOffset_defaultPropsBoundaryKept`+`DocToDocxFormattingTest#runFlags_*/keepNextKeepLines_*/sectLandscapePgNumCols_*/sectUnevenCols_*/cellVertAlign_*/drawnObject_*`+`SectionsTest#orientationPgNumColumns_applied/unevenColumns_perIndexWidths/restartWithoutStart_clampsToOne`+`TablesTest#vertAlign_*`↔`WordPdfConverterTest#docClassD_landscapeHiddenDelCaps/#docClassD_pageNumberRestartLowerRoman/#docClassD_twoColumnsBreak/#docClassD_drawnObjectBecomesImage` (закрытие пробелов класса D: vanish-фильтр/правки/caps/position/keep, landscape+pgNumType, колонки+column break, vAlign, 0x08→inline-картинка; фикстур нет — крафт POIFS продублирован в обоих тестовых классах), `HiddenTextNormalizerTest`↔`hiddenText_notPrinted` (правило 9), `RubyNormalizerTest`↔`rubyBase_textPrinted` (правило 10), AUDIT-FIX-2↔`movedRevision_textPrinted`/`bdoDir_textPrinted` (фикстур нет — синтетический docx через общий хелпер `docx(docXmlns, body, sect, rels, overrides, parts)`), пиннинг аудита .docx↔`footnote_rendersAtPageBottom`, `endnote_rendersAtDocumentEnd`, `docxHyperlink_uriAnnotation`, `pageRefField_liveNotCached` (кэш 9001/7777 заменён живым номером), `dateField_notStaleCache` (кэш 01.02.2003 заменён текущей датой), `titlePg_firstPageHeader`, `vMergeCell_spansRows`, `sdtContent_rendered`, `drawingTextBox_textPrinted`, `ommlMath_drawnAsVectors` (пиксели: +150 тёмных px@150dpi сверх текста), `highlightAndShading_backgroundDrawn` (жёлтые px >0 против baseline 0), аудит [MS-DOC] моста 2026-11: `GrpprlTest#tInsertOperand_skippedBySpra`/`tInsertOperand_truncated_aborts` (sprmTInsert — 4 байта, хвост TAP не рассинхронизирован), `TablesTest#cellPadding_*` + `DocToDocxFormattingTest#cellMargins_becomeTcMar` ↔ `WordPdfConverterTest#tableTcMar_textInsetLikeWord` (CSSA→w:tcMar, пайплайн красит поля ячейки как tblCellMar — текст на margin+padding), `StylesTest#characterStyle_stk3_chainViaCharChain`/`charChain_nonCharacterStk_empty` + `DocToDocxFormattingTest#charStyle_viaIstd_mergesUnderDirect` (sprmCIstd: символьная chpx-цепочка между стилевой и прямыми, direct wins), `DocToDocxFormattingTest#runHighlightAndShading_inRPr`/`runShadingPattern_degradesToBackFill`/`paraShd_inPPrBeforeJc` ↔ `docHighlightAndShading_yellowPixels` (Ico→ST_HighlightColor; w:shd в форме FOP val="clear"+fill; паттерн→cvBack), `SectionsTest#titlePage_flagFromSepx` + `DocToDocxFormattingTest#titlePage_emittedAfterCols` ↔ `docTitlePage_firstHeaderOnlyFirstPage` (sprmSFTitlePage + first-слоты Plcfhdd → headerReference type="first", первая страница — только first-шапка). 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 23f924d..4fcd45d 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
@@ -39,10 +39,22 @@ import java.util.regex.Pattern;
* (sprmSFPgnRestart/sprmSPgnStart97/sprmSNfcPgn → w:pgNumType), многостолбцовость
* (sprmSCcolumns/… → w:cols, 0x0E → w:br type="column"), вертикальное
* выравнивание ячеек (sprmTVertAlign → w:vAlign), картинки-якоря плавающих
- * объектов (0x08 — inline-приближение, PlcfSpa не переносится). Не переносятся:
+ * объектов (0x08 — inline-приближение, PlcfSpa не переносится),
+ * текстовыделитель (sprmCHighlight → w:highlight), затенения рана/абзаца
+ * (sprmCShd/sprmCShd80 → rPr, sprmPShd/sprmPShd80 → pPr — w:shd), прямые
+ * символьные стили (sprmCIstd + stk=3 в STSH → цепочка chpx в rPr), поля
+ * ячеек (sprmTCellPadding/sprmTCellPaddingDefault → w:tcMar; по умолчанию
+ * конвейер даёт дефолт Word 108/0), титульная страница секции
+ * (sprmSFTitlePage → w:titlePg + first-колонтитуки Plcfhdd). Не переносятся:
* семантика рестартов списков (fNoRestart/ilvlRestartLim), fLegal,
- * объединённые/вложенные ячейки и бордюры TC80; подсветка/затенения/границы
- * абзацев (PlfBdx) — конвейер их в FO не потребляет; сноски/комментарии
+ * объединённые/вложенные ячейки и бордюры TC80, границы абзацев
+ * (sprmPBrc* 0xC64E–0xC652 — конвейер не читает w:pBdr) и ячейки
+ * (sprmTSetBrc — не читает w:tcBorders), высота строк (sprmTDyaRowHeight —
+ * не читает w:trHeight),
+ * «шапка-repeat»/cantSplit/widowControl, типы подчёркивания и цвет линии
+ * (sprmCKul/sprmCCvUl — всегда single), эффетки шрифта, отступы Dxc
+ * (hundredths of a character — пайплайн не читает w:*Chars);
+ * сноски/комментарии
* (0x02/0x05) и инструкции полей (0x13–0x14) выбрасываются,
* результат поля (0x14–0x15) остаётся; поле {@code HYPERLINK} в основном
* тексте переносится как {@code w:hyperlink} с внешней rels-связью на URL из
@@ -139,12 +151,16 @@ public final class DocToDocx {
List secs = sections.list();
String[] hdrRel = new String[secs.size()];
String[] ftrRel = new String[secs.size()];
+ String[] firstHdrRel = new String[secs.size()];
+ String[] firstFtrRel = new String[secs.size()];
// Odd header/footer каждой секции → type="default" (FOP не различает
// чётные/нечётные); guard-абзац истории отбрасывается. История
// cpStart == cpEnd не определена (§2.4.4) — ни части, ни ссылки:
// docx4j наследует полосы предыдущей секции. Guard-only история —
// часть с единственным (явно пустой колонтитул, обрывающий
// наследование; пустой w:hdr невалиден — ≥1 блочный элемент).
+ // First-page истории (4/5) эмитятся только при sprmSFTitlePage —
+ // как type="first" (docx4j+FOP различают first/default).
int hdrNo = 0;
int ftrNo = 0;
for (int i = 0; i < secs.size(); i++) {
@@ -168,9 +184,33 @@ public final class DocToDocx {
: "")));
ftrRel[i] = "rId" + parts.size();
}
+ if (secs.get(i).titlePage()) {
+ Headers.Story firstHdr = headers.firstHeader(i);
+ if (!firstHdr.empty()) {
+ hdrNo++;
+ parts.add(new DocxWriter.Part("word/header" + hdrNo + ".xml",
+ HEADER_CONTENT_TYPE, HEADER_REL_TYPE,
+ DocxWriter.storyPart("w:hdr", firstHdr.hasContent()
+ ? body.buildRange(firstHdr.cpStart(), firstHdr.contentEnd(),
+ true)
+ : "")));
+ firstHdrRel[i] = "rId" + parts.size();
+ }
+ Headers.Story firstFtr = headers.firstFooter(i);
+ if (!firstFtr.empty()) {
+ ftrNo++;
+ parts.add(new DocxWriter.Part("word/footer" + ftrNo + ".xml",
+ FOOTER_CONTENT_TYPE, FOOTER_REL_TYPE,
+ DocxWriter.storyPart("w:ftr", firstFtr.hasContent()
+ ? body.buildRange(firstFtr.cpStart(), firstFtr.contentEnd(),
+ true)
+ : "")));
+ firstFtrRel[i] = "rId" + parts.size();
+ }
+ }
}
// hyperlinks наполняются внутри build (body-pass); rels пишутся после
- String bodyXml = body.build(secs, hdrRel, ftrRel);
+ String bodyXml = body.build(secs, hdrRel, ftrRel, firstHdrRel, firstFtrRel);
return DocxWriter.write(bodyXml, parts, body.hyperlinks());
}
@@ -193,6 +233,8 @@ public final class DocToDocx {
private static final int FMULT_MULTIPLIER = 1;
/** w:gridSpan эмитится только при покрытии ≥2 колонок tblGrid (§17.4.65). */
private static final int MIN_GRID_SPAN = 2;
+ /** Ipat=ipatSolid (0x01, [MS-DOC] Ipat): непрозрачная заливка цветом cvFore. */
+ private static final int IPAT_SOLID = 1;
/** Схема URL в начале строки (RFC 3986 §3.1), lookingAt. */
private static final Pattern URL_SCHEME =
Pattern.compile("[A-Za-z][A-Za-z0-9+.\\-]*:");
@@ -261,7 +303,8 @@ public final class DocToDocx {
* (ECMA-376 §17.6.22), поэтому берётся из sprmSBkc ПРЕДЫДУЩЕЙ секции
* ([MS-DOC] §2.6.3 SBkcOperand — «break that terminates the section»).
*/
- String build(List secs, String[] hdrRel, String[] ftrRel) {
+ String build(List secs, String[] hdrRel, String[] ftrRel,
+ String[] firstHdrRel, String[] firstFtrRel) {
Map sectByEndCp = new HashMap<>();
int n = secs.size();
for (int i = 0; i < n - 1; i++) {
@@ -269,12 +312,14 @@ public final class DocToDocx {
if (endCp >= 0 && endCp < ccpText
&& pieces.charAt(endCp) == PAGE_OR_SECTION_BREAK) {
sectByEndCp.put(endCp, sectPrXml(secs.get(i), hdrRel[i], ftrRel[i],
+ firstHdrRel[i], firstFtrRel[i],
i > 0 && secs.get(i - 1).continuous()));
}
}
Sections.Section last = secs.get(n - 1);
return buildRange(0, ccpText, false, sectByEndCp)
+ sectPrXml(last, hdrRel[n - 1], ftrRel[n - 1],
+ firstHdrRel[n - 1], firstFtrRel[n - 1],
n > 1 && secs.get(n - 2).continuous());
}
@@ -515,6 +560,11 @@ public final class DocToDocx {
tcPr.append("");
}
+ // sprmTCellPadding/…Default (CT_TcPr, §17.4.72: tcMar до vAlign)
+ String tcMar = tcMarXml(rowGrid, i);
+ if (tcMar != null) {
+ tcPr.append(tcMar);
+ }
// sprmTVertAlign (CT_TcPrBase: vAlign после tcW/gridSpan); top — не эмитится
int[] va = rowGrid == null ? null : rowGrid.cellVAlign();
if (va != null && i < va.length && (va[i] == 1 || va[i] == 2)) {
@@ -547,6 +597,47 @@ public final class DocToDocx {
return -1;
}
+ /**
+ * w:tcMar ячейки i по полям строки (sprmTCellPadding/…Default):
+ * пересечение диапазона [itcFirst, itcLim) с индексом ячейки, позже
+ * заданный операнд перекрывает сторону ранее заданного (порядок
+ * скана TAP = last-wins). Стороны только явные, порядок детей
+ * CT_TcMar (§17.4.66): top → left → bottom → right. Нет явных
+ * полей — null (конвейер даёт дефолт 108/0 — он же дефолт Word).
+ */
+ private static String tcMarXml(Tables.Grid rowGrid, int i) {
+ if (rowGrid == null) {
+ return null;
+ }
+ int[] side = {-1, -1, -1, -1}; // top, left, bottom, right (dxa; −1 — нет)
+ for (Tables.CellMargin m : rowGrid.cellMargins()) {
+ if (i < m.itcFirst() || i >= m.itcLim()) {
+ continue;
+ }
+ if ((m.sideMask() & 1) != 0) {
+ side[0] = m.width();
+ }
+ if ((m.sideMask() & 2) != 0) {
+ side[1] = m.width();
+ }
+ if ((m.sideMask() & 4) != 0) {
+ side[2] = m.width();
+ }
+ if ((m.sideMask() & 8) != 0) {
+ side[3] = m.width();
+ }
+ }
+ String[] names = {"top", "left", "bottom", "right"};
+ StringBuilder xml = new StringBuilder();
+ for (int s = 0; s < side.length; s++) {
+ if (side[s] >= 0) {
+ xml.append("");
+ }
+ }
+ return xml.length() == 0 ? null : "" + xml + "";
+ }
+
/** istd абзаца: последний прямой sprmPIstd в границах STSH, иначе из PAPX. */
private int istdOf(byte[] direct, int fallback) {
int[] istd = {fallback};
@@ -585,8 +676,7 @@ public final class DocToDocx {
/** Один ран свойств CHPX (поверх CHPX-цепочки стиля абзаца); CP после рана. */
private int emitRun(StringBuilder runs, int cpStart, int cpEnd, byte[] grpprl,
byte[] styleChpx) {
- RunProps props = runProps(
- styleChpx.length == 0 ? grpprl : concat(styleChpx, grpprl));
+ RunProps props = runProps(chpxWithCharStyle(grpprl, styleChpx));
String rPr = runXml(props);
runHidden = props.hidden;
runCaps = props.caps || props.smallCaps;
@@ -967,6 +1057,11 @@ public final class DocToDocx {
case Grpprl.SPRM_C_RG_FTC0 -> p.ftc0 = Grpprl.operandInt(buf, off, len);
case Grpprl.SPRM_C_RG_FTC1 -> p.ftc1 = Grpprl.operandInt(buf, off, len);
case Grpprl.SPRM_C_CV -> p.color = colorOf(buf, off, len);
+ case Grpprl.SPRM_C_HIGHLIGHT -> p.highlight =
+ highlightName(Grpprl.operandInt(buf, off, len));
+ case Grpprl.SPRM_C_SHD -> p.shd = shdAttrs10(buf, off, len);
+ case Grpprl.SPRM_C_SHD80 -> p.shd =
+ shdAttrs80(Grpprl.operandInt(buf, off, len));
case Grpprl.SPRM_C_HPS_POS -> p.pos = signedXas(buf, off, len);
case Grpprl.SPRM_C_F_VANISH -> p.hidden = Grpprl.toggleOn(buf, off);
case Grpprl.SPRM_C_F_CAPS -> p.caps = Grpprl.toggleOn(buf, off);
@@ -979,7 +1074,10 @@ public final class DocToDocx {
return p;
}
- /** rPr по CT_RPr-порядку: rFonts, b, i, strike, color, position, sz, szCs, u. */
+ /**
+ * rPr по CT_RPr-порядку (§17.3.2.28): rFonts, b, i, strike, color,
+ * position, sz, szCs, highlight, u, shd.
+ */
private String runXml(RunProps p) {
StringBuilder xml = new StringBuilder();
String ascii = p.ftc0 >= 0 ? fonts.font(p.ftc0) : null;
@@ -1018,15 +1116,21 @@ public final class DocToDocx {
if (p.szCs > 0) {
xml.append("");
}
+ if (p.highlight != null) {
+ xml.append("");
+ }
if (p.underline) {
xml.append("");
}
+ if (p.shd != null) {
+ xml.append("");
+ }
return xml.length() == 0 ? "" : "" + xml + "";
}
/**
- * Дети pPr по CT_PPr (§17.3.1.26): pageBreakBefore, tabs, spacing, ind,
- * jc (обёртку {@code } дописывает {@link #paraXml}).
+ * Дети pPr по CT_PPr (§17.3.1.26): pageBreakBefore, shd, tabs, spacing,
+ * ind, jc (обёртку {@code } дописывает {@link #paraXml}).
* Скан идёт по конкатенации цепочки стиля абзаца (base-first) и
* прямых PAPX — порядок сохраняет last-wins: base → derived → direct.
* Отступы накапливает общий {@link Grpprl.Indents} (80-варианты
@@ -1048,6 +1152,7 @@ public final class DocToDocx {
boolean[] keepLines = {false};
int[] ilvl = {0};
int[] ilfo = {0};
+ String[] pShd = {null};
List tabs = new ArrayList<>();
Grpprl.scan(grpprl, 0, grpprl.length, (sprm, buf, off, len) -> {
ind.prl(sprm, buf, off, len);
@@ -1080,6 +1185,9 @@ public final class DocToDocx {
case Grpprl.SPRM_P_CHG_TABS -> applyTabs(tabs, buf, off, len, true);
case Grpprl.SPRM_P_ILVL -> ilvl[0] = Grpprl.operandInt(buf, off, len);
case Grpprl.SPRM_P_ILFO -> ilfo[0] = signedXas(buf, off, len);
+ case Grpprl.SPRM_P_SHD -> pShd[0] = shdAttrs10(buf, off, len);
+ case Grpprl.SPRM_P_SHD80 -> pShd[0] =
+ shdAttrs80(Grpprl.operandInt(buf, off, len));
default -> { }
}
});
@@ -1096,6 +1204,11 @@ public final class DocToDocx {
}
// numPr — после pageBreakBefore, до tabs (CT_PPr, §17.3.1.26)
xml.append(numPrXml(ilfo[0], ilvl[0]));
+ // w:shd — после numPr, до tabs (CT_PPr §17.3.1.26: pBdr → shd → tabs;
+ // границы абзацев мост не эмитит — w:pBdr конвейер не читает)
+ if (pShd[0] != null) {
+ xml.append("");
+ }
String tabsEl = tabsXml(tabs);
if (!tabsEl.isEmpty()) {
xml.append(tabsEl);
@@ -1324,6 +1437,95 @@ public final class DocToDocx {
buf[off + 2] & 0xFF);
}
+ /**
+ * Ico (§2.9.171) → член ST_HighlightColor (§17.18.42) — соответствие
+ * 1:1 по RGB палитры (teal 00FFFF = cyan, dark teal 008080 = darkCyan,
+ * gray50 = darkGray, gray25 = lightGray). 0/auto/вне 1..16 → null
+ * (не эмитится).
+ */
+ private static String highlightName(int ico) {
+ return switch (ico) {
+ case 1 -> "black";
+ case 2 -> "blue";
+ case 3 -> "cyan";
+ case 4 -> "green";
+ case 5 -> "magenta";
+ case 6 -> "red";
+ case 7 -> "yellow";
+ case 8 -> "white";
+ case 9 -> "darkBlue";
+ case 10 -> "darkCyan";
+ case 11 -> "darkGreen";
+ case 12 -> "darkMagenta";
+ case 13 -> "darkRed";
+ case 14 -> "darkYellow";
+ case 15 -> "darkGray";
+ case 16 -> "lightGray";
+ default -> null;
+ };
+ }
+
+ /**
+ * SHDOperand (§2.9.177): cb(1)=10 + Shd(10: cvFore/cvBack COLORREF +
+ * ipat u16, §2.9.178) → атрибуты w:shd; cb≠10/обрезок → null.
+ */
+ private static String shdAttrs10(byte[] buf, int off, int len) {
+ if (len < 11 || (buf[off] & 0xFF) != 10) {
+ return null;
+ }
+ return shdAttrs(Grpprl.operandInt(buf, off + 9, 2),
+ colorOf(buf, off + 1, 4), colorOf(buf, off + 5, 4));
+ }
+
+ /**
+ * Shd80 (§2.9.176, u16: icoFore(5) icoBack(5) ipat(6)) → атрибуты
+ * w:shd; Shd80Nil (0x1F/0x1F/0x3F) даёт null (цвета вне палитры).
+ */
+ private static String shdAttrs80(int v) {
+ return shdAttrs((v >>> 10) & 0x3F,
+ Tables.icoColor(v & 0x1F), Tables.icoColor((v >>> 5) & 0x1F));
+ }
+
+ /**
+ * Ipat+цвета → атрибуты w:shd в форме, которую Word сам пишет при
+ * doc→docx: фон в w:fill, w:val="clear". FOP закрашивает только
+ * w:fill (зонд 2026-11: w:val="solid" w:color=RRGGBB w:fill="auto"
+ * не рисует ничего); паттерны Ipat≥2 в FOP неразличимы — деградация
+ * в фон cvBack (MS-DOC Ipat: вне ST_Shd паттерны «lost if converted
+ * to ECMA-376»). ShdAuto/ShdNil (оба цвета auto, §2.9.178) и
+ * нечем-красить (fill auto) → null.
+ */
+ private static String shdAttrs(int ipat, String fore, String back) {
+ if (fore == null && back == null) {
+ return null;
+ }
+ String fill = ipat == IPAT_SOLID ? (fore != null ? fore : back) : back;
+ return fill == null ? null
+ : "w:val=\"clear\" w:color=\"auto\" w:fill=\"" + fill + "\"";
+ }
+
+ /**
+ * Grpprl рана с учётом sprmCIstd (§2.6.1): цепочка chpx символьного
+ * стиля (stk=3) вставляется между цепочкой стиля абзаца и прямыми
+ * CHPX — §2.4.6.5: символьные свойства сначала возвращаются к
+ * результату стиля абзаца, затем символьный стиль, затем прямые.
+ * Без sprmCIstd — прежняя конкатенация.
+ */
+ private byte[] chpxWithCharStyle(byte[] grpprl, byte[] styleChpx) {
+ int[] istd = {-1};
+ Grpprl.scan(grpprl, 0, grpprl.length, (sprm, buf, off, len) -> {
+ if (sprm == Grpprl.SPRM_C_ISTD) {
+ int v = Grpprl.operandInt(buf, off, len);
+ istd[0] = v < styles.count() ? v : -1;
+ }
+ });
+ byte[] chStyle = istd[0] >= 0 ? styles.charChain(istd[0]) : new byte[0];
+ if (chStyle.length == 0) {
+ return styleChpx.length == 0 ? grpprl : concat(styleChpx, grpprl);
+ }
+ return concat(concat(styleChpx, chStyle), grpprl);
+ }
+
/**
* w:sectPr секции: ссылки на части колонтитуков (null — элемент не
* пишется, docx4j наследует полосы предыдущей секции), затем w:type,
@@ -1336,7 +1538,8 @@ public final class DocToDocx {
* предыдущей секции, [MS-DOC] §2.6.3)
*/
private static String sectPrXml(Sections.Section s, String headerRelId,
- String footerRelId, boolean typeContinuous) {
+ String footerRelId, String firstHeaderRelId, String firstFooterRelId,
+ boolean typeContinuous) {
StringBuilder xml = new StringBuilder("");
// EG_HdrFtrReferences — до содержимого секции (CT_SectPr, ECMA-376 §17.2.3)
if (headerRelId != null) {
@@ -1347,6 +1550,14 @@ public final class DocToDocx {
xml.append("");
}
+ if (firstHeaderRelId != null) {
+ xml.append("");
+ }
+ if (firstFooterRelId != null) {
+ xml.append("");
+ }
if (typeContinuous) {
xml.append("");
}
@@ -1372,6 +1583,11 @@ public final class DocToDocx {
.append("\" w:gutter=\"0\"/>");
appendPgNumType(xml, s);
appendCols(xml, s);
+ // w:titlePg — после w:cols (CT_SectPrBase, §17.2.3): первая страница
+ // секции использует first-части (ссылки w:type="first" выше)
+ if (s.titlePage()) {
+ xml.append("");
+ }
xml.append("");
return xml.toString();
}
@@ -1492,6 +1708,10 @@ public final class DocToDocx {
/** sprmCFRMarkDel/sprmCFRMarkIns: непринятая правка → w:del/w:ins. */
private boolean del;
private boolean ins;
+ /** sprmCHighlight: член ST_HighlightColor (§17.18.42); null — нет. */
+ private String highlight;
+ /** sprmCShd/sprmCShd80: готовые атрибуты w:shd; null — нет затенения. */
+ private String shd;
}
}
}
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 2ecfdc1..1b8e156 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
@@ -52,6 +52,27 @@ final class Grpprl {
static final int SPRM_C_F_VANISH = 0x083C;
/** sprmCHpsPos (§2.6.1, 2 байта со знаком): вертикальный сдвиг в hps. */
static final int SPRM_C_HPS_POS = 0x4845;
+ /**
+ * sprmCHighlight (§2.6.1, 1 байт Ico): текстовыделитель. Ico (§2.9.171)
+ * → w:highlight в порядке CT_RPr — конвейер рисует фон рана (пинь
+ * WordPdfConverterTest#highlightAndShading_backgroundDrawn).
+ */
+ static final int SPRM_C_HIGHLIGHT = 0x2A0C;
+ /**
+ * sprmCShd/sprmCShd80 (§2.6.1): затенение рана → w:shd в rPr.
+ * SHDOperand (§2.9.177) = cb(1)=10 + Shd(10): cvFore/cvBack COLORREF
+ * + ipat (§2.9.178); Shd80 (§2.9.176) — 2 байта: icoFore(5) icoBack(5)
+ * ipat(6).
+ */
+ static final int SPRM_C_SHD = 0xCA71;
+ static final int SPRM_C_SHD80 = 0x4866;
+ /**
+ * sprmCIstd (§2.6.1, u16): istd прямого символьного стиля (stk=3 в STSH).
+ * По §2.4.6.5 символьные свойства возвращаются к результату стиля абзаца,
+ * затем накладывается цепочка chpx символьного стиля, затем прямые CHPX —
+ * порядок конкатенации в {@code DocxBody.chpxWithCharStyle}.
+ */
+ static final int SPRM_C_ISTD = 0x4A30;
// Paragraph Properties (§2.6.2, sgc 1)
static final int SPRM_P_ISTD = 0x4600;
@@ -123,6 +144,13 @@ final class Grpprl {
* array that contained the sprmPTableProps»).
*/
static final int SPRM_P_TABLE_PROPS = 0x646B;
+ /**
+ * sprmPShd/sprmPShd80 (§2.6.2): затенение абзаца (те же Shd/Shd80, что
+ * для рана) → w:shd в pPr между numPr и tabs (CT_PPr §17.3.1.26;
+ * w:pBdr мост не эмитит).
+ */
+ static final int SPRM_P_SHD = 0xC64D;
+ static final int SPRM_P_SHD80 = 0x442D;
// Table Properties (§2.6.3, sgc 5)
static final int SPRM_T_TABLE_BORDERS_80 = 0xD605;
@@ -149,6 +177,28 @@ final class Grpprl {
* строки → w:vAlign в tcPr.
*/
static final int SPRM_T_VERT_ALIGN = 0xD62C;
+ /**
+ * sprmTCellPadding/sprmTCellPaddingDefault (§2.6.3): поля ячеек —
+ * CSSAOperand (§2.9.209): cb(1)=6 + CSSA (§2.9.96): itc(2, ItcFirstLim)
+ * + grfbrc(1: маска сторон top|left|bottom|right = 1|2|4|8) + ftsWidth(1)
+ * + wWidth(2). Поля переносятся только при ftsWidth=ftsDxa(0x03);
+ * ftsNil(0) — сторона не задана. Default-вариант действует на весь ряд
+ * (Word пишет имPLICIT-дефолт 108/0, но пайплайн при отсутствии даёт те
+ * же 108 — замерено), padding-вариант — на диапазон [itcFirst, itcLim)
+ * → w:tcMar.
+ */
+ static final int SPRM_T_CELL_PADDING = 0xD632;
+ static final int SPRM_T_CELL_PADDING_DEFAULT = 0xD634;
+ /**
+ * sprmTInsert (§2.6.3): вставка определений ячеек ряда — пропускается
+ * правилом spra=3 (4 байта: itcFirst(1)+ctc(1)+dxaCol(2 XAS), §2.9.322;
+ * ECMA-376 Part 4 описывал прежнюю форму rgttte ctc×6 байт, но [MS-DOC]
+ * и реальные файлы Word сходятся на 4 байтах: в TAP образцов
+ * ru-table-image.doc/ru-en-mixed.doc following-sprm выравниваются ровно
+ * при 4). Сетку из sprmTInsert мост не строит (остаток — javadoc Tables);
+ * регрессия выравнивания — GrpprlTest#tInsertOperand_skippedBySpra.
+ */
+ static final int SPRM_T_INSERT = 0x7621;
// Section Properties (§2.6.4, sgc 4)
static final int SPRM_S_DYA_HDR_TOP = 0xB017;
@@ -181,6 +231,12 @@ final class Grpprl {
*/
static final int SPRM_S_DXA_COL_WIDTH = 0xF203;
static final int SPRM_S_DXA_COL_SPACING = 0xF204;
+ /**
+ * sprmSFTitlePage (§2.6.4, Bool8): первая страница секции использует
+ * собственные колонтитуки (истории 4/5 группы секции, §2.4.4) →
+ * w:titlePg + ссылки w:type="first".
+ */
+ static final int SPRM_S_F_TITLE_PAGE = 0x300A;
/**
* Накопитель абзацных отступов PAPX (§2.6.2) — общий для
diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/doc/Headers.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/doc/Headers.java
index f942e76..2082c42 100644
--- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/doc/Headers.java
+++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/doc/Headers.java
@@ -14,9 +14,11 @@ import ru.pjandro.wordpdf.ValidationException;
* в вывод не попадает.
*
* В перенос идут odd header/footer каждой секции как {@code type="default"}
- * — FOP не различает чётные/нечётные страницы, а {@code titlePg} (первая
- * страница) не поддерживается. История с {@code cpStart == cpEnd} не
- * определена — часть и ссылка не эмитятся, docx4j наследует полосы
+ * — FOP не различает чётные/нечётные страницы. First-page истории (4/5)
+ * переносятся как {@code type="first"} только для секций с
+ * {@code sprmSFTitlePage} (w:titlePg, конвейер различает first/default —
+ * пинь {@code titlePg_firstPageHeader}). История с {@code cpStart == cpEnd}
+ * не определена — часть и ссылка не эмитятся, docx4j наследует полосы
* предыдущей секции (§2.4.4 «Same as Previous»).
*/
final class Headers {
@@ -54,6 +56,9 @@ final class Headers {
/** Индексы внутри группы секции: 0 even hdr, 1 odd hdr, 2 even ftr, 3 odd ftr… */
private static final int ODD_HEADER = 1;
private static final int ODD_FOOTER = 3;
+ /** Первая страница (истории 4/5, применяются при sprmSFTitlePage, §2.4.4). */
+ private static final int FIRST_HEADER = 4;
+ private static final int FIRST_FOOTER = 5;
private final int[] aCp;
@@ -94,6 +99,16 @@ final class Headers {
return story(SEPARATOR_STORIES + section * STORIES_PER_SECTION + ODD_FOOTER);
}
+ /** Заголовок первой страницы секции {@code section} (titlePg, §2.4.4). */
+ Story firstHeader(int section) {
+ return story(SEPARATOR_STORIES + section * STORIES_PER_SECTION + FIRST_HEADER);
+ }
+
+ /** Колонтитул первой страницы секции {@code section} (titlePg, §2.4.4). */
+ Story firstFooter(int section) {
+ return story(SEPARATOR_STORIES + section * STORIES_PER_SECTION + FIRST_FOOTER);
+ }
+
private Story story(int index) {
if (index + 1 >= aCp.length) {
return new Story(0, 0);
diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/doc/Sections.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/doc/Sections.java
index 581d045..da5cde1 100644
--- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/doc/Sections.java
+++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/doc/Sections.java
@@ -40,15 +40,16 @@ final class Sections {
* финальный символ — 0x0C, §2.8.26) + геометрия из её Sepx + признак
* «разрыв, заканчивающий секцию, не начинает новую страницу» +
* ориентация (sprmSBOrientation), нумерация страниц (sprmSFPgnRestart/
- * sprmSPgnStart97/sprmSNfcPgn — pgNumStart=0 «не задан», nfcPgn — MSONFC)
- * и колонки (sprmSCcolumns/…; colWidths/colSpacings заполнены только при
- * evenlySpaced=false, индекс — номер колонки).
+ * sprmSPgnStart97/sprmSNfcPgn — pgNumStart=0 «не задан», nfcPgn — MSONFC),
+ * колонки (sprmSCcolumns/…; colWidths/colSpacings заполнены только при
+ * evenlySpaced=false, индекс — номер колонки) и титульная страница
+ * (sprmSFTitlePage → w:titlePg, §2.6.4).
*/
record Section(int cpStart, int cpEnd, int pageWidth, int pageHeight,
int marginLeft, int marginRight, int marginTop, int marginBottom,
int header, int footer, boolean continuous, boolean landscape,
int pgNumStart, int nfcPgn, int columnCount, boolean evenlySpaced,
- int dxaColumns, int[] colWidths, int[] colSpacings) {
+ int dxaColumns, int[] colWidths, int[] colSpacings, boolean titlePage) {
}
/** Дефолты Word 97 (§2.6.3, twips). */
@@ -78,6 +79,7 @@ final class Sections {
private int footer = DEFAULT_HEADER_FOOTER;
private boolean continuous;
private boolean landscape;
+ private boolean titlePage;
private boolean pgnRestart;
private int pgnStart97;
private int nfcPgn;
@@ -115,6 +117,8 @@ final class Sections {
nfcPgn = value; // MSONFC ([MS-OSHARED] §2.2.1.3)
} else if (sprm == Grpprl.SPRM_S_F_EVENLY_SPACED) {
evenlySpaced = value != 0; // Bool8, дефолт true
+ } else if (sprm == Grpprl.SPRM_S_F_TITLE_PAGE) {
+ titlePage = value != 0; // Bool8 (§2.6.4)
} else if (sprm == Grpprl.SPRM_S_C_COLUMNS) {
// sprmSCcolumns = число колонок − 1 (§2.6.4)
columnCount = Math.min(value + 1, MAX_COLUMNS);
@@ -208,7 +212,7 @@ final class Sections {
g.pgnRestart ? Math.max(1, g.pgnStart97) : 0,
g.nfcPgn, g.columnCount, g.evenlySpaced, g.dxaColumns,
Arrays.copyOf(g.colWidths, g.columnCount),
- Arrays.copyOf(g.colSpacings, g.columnCount)));
+ Arrays.copyOf(g.colSpacings, g.columnCount), g.titlePage));
}
sections = List.copyOf(list);
continuousEnds = cont;
@@ -218,7 +222,7 @@ final class Sections {
return new Section(cpStart, cpEnd, DEFAULT_PAGE_WIDTH, DEFAULT_PAGE_HEIGHT,
DEFAULT_MARGIN, DEFAULT_MARGIN, DEFAULT_MARGIN, DEFAULT_MARGIN,
DEFAULT_HEADER_FOOTER, DEFAULT_HEADER_FOOTER, false,
- false, 0, 0, 1, true, -1, new int[0], new int[0]);
+ false, 0, 0, 1, true, -1, new int[0], new int[0], false);
}
static Sections read(byte[] tableStream, long fcSed, long lcbSed, byte[] wordDocument,
diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/doc/Styles.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/doc/Styles.java
index a37becc..23b6e22 100644
--- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/doc/Styles.java
+++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/doc/Styles.java
@@ -12,7 +12,9 @@ package ru.pjandro.wordpdf.internal.doc;
* + xstzName (cch(2)+2·cch+терминатор(2), §2.9.348) + cupx × LPUpx
* (cbUpx(2) + данные, шаг 2+cbUpx с выравниванием на чёт). Для stk=1
* (абзацный стиль) UPX[0] = UpxPapx (istd(2) + grpprlPapx), UPX[1] =
- * UpxChpx (grpprlChpx целиком), §2.9.267/.308/.309.
+ * UpxChpx (grpprlChpx целиком), §2.9.267/.308/.309; для stk=3 (символьный
+ * стиль) единственный UPX = UpxChpx целиком (§2.9.267) — читается в
+ * {@link #charChain} для sprmCIstd.
*
* Цепочка свойств стиля — base-first: сначала grpprl предка по
* istdBase (0x0FFF — без предка), затем собственный grpprl (шаг 8
@@ -29,6 +31,8 @@ final class Styles {
/** stk абзацного стиля (§2.9.260). */
private static final int STK_PARAGRAPH = 1;
+ /** stk символьного стиля (§2.9.260): UPX[0] = UpxChpx целиком. */
+ private static final int STK_CHARACTER = 3;
/** Индекс UpxPapx в Std абзацного стиля (§2.9.308). */
private static final int UPX_PAPX = 0;
/** Индекс UpxChpx в Std абзацного стиля (§2.9.309). */
@@ -38,8 +42,8 @@ final class Styles {
/** Защита от цикла в istdBase. */
private static final int MAX_CHAIN = 16;
- /** Один стиль: предка + собственные grpprl'ы (пустые массивы — нет). */
- private record Style(int istdBase, byte[] papx, byte[] chpx) {
+ /** Один стиль: stk (§2.9.260), предка + собственные grpprl'ы (пустые — нет). */
+ private record Style(int istdBase, int stk, byte[] papx, byte[] chpx) {
}
private final Style[] styles;
@@ -100,7 +104,7 @@ final class Styles {
int cupx = table[std + 4] & 0xF;
int p = std + cbStdf;
if (p + 2 > stdEnd) {
- return new Style(NO_BASE, new byte[0], new byte[0]);
+ return new Style(NO_BASE, stk, new byte[0], new byte[0]);
}
int cch = CfbReader.u16(table, p);
p += 2 + 2 * cch + 2; // xstzName: cch + строка + chTerm (§2.9.348)
@@ -119,13 +123,16 @@ final class Styles {
} else if (i == UPX_CHPX) {
chpx = slice(table, p, cbUpx); // UpxChpx (§2.9.343)
}
+ } else if (stk == STK_CHARACTER && i == UPX_PAPX && cbUpx > 0) {
+ // Символьный стиль: единственный UPX = UpxChpx целиком (§2.9.267)
+ chpx = slice(table, p, cbUpx);
}
p += cbUpx;
if ((p & 1) != 0) {
p++; // LPUpx выровнены на чёт, padding в cbUpx не входит
}
}
- return new Style(istdBase, papx, chpx);
+ return new Style(istdBase, stk, papx, chpx);
}
private static byte[] slice(byte[] src, int from, int len) {
@@ -154,6 +161,19 @@ final class Styles {
return chain(istd, false);
}
+ /**
+ * Цепочка chpx символьного стиля для sprmCIstd (§2.6.1): только стили
+ * stk=3, иначе пусто (§2.4.6.5 — символьный стиль применяется к рану,
+ * стиль другого типа игнорируется снисходительно).
+ */
+ byte[] charChain(int istd) {
+ if (istd < 0 || istd >= styles.length || styles[istd] == null
+ || styles[istd].stk() != STK_CHARACTER) {
+ return new byte[0];
+ }
+ return chain(istd, false);
+ }
+
private byte[] chain(int istd, boolean papx) {
byte[] own = new byte[0];
int depth = 0;
diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/doc/Tables.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/doc/Tables.java
index a3839f2..ca86125 100644
--- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/doc/Tables.java
+++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/doc/Tables.java
@@ -28,7 +28,13 @@ import java.util.List;
*
Горизонтальное объединение ячеек переносится сеткой самой строки:
* у TTP-абзаца каждой строки свой {@code sprmTDefTable} (§2.9.321), и
* автомат {@code DocxBody} по нему выдаёт {@code w:gridSpan}+{@code w:tcW}
- * (сетка первой строки остаётся tblGrid).
+ * (сетка первой строки остаётся tblGrid). Явные поля ячеек
+ * ({@code sprmTCellPadding}/{@code sprmTCellPaddingDefault}, CSSA §2.9.209)
+ * переносятся {@code w:tcMar}; при их отсутствии конвейер даёт дефолт
+ * 108/0 — он же дефолт Word (замер). {@code sprmTDxaGapHalf} не переносится
+ * как поле: §2.6.3 — «not used to layout cell contents», это поправка
+ * начала координат таблицы при {@code sprmTDxaLeft} (позиция уже зашита в
+ * rgdxaCenter).
*
* Вне контура (деградация {@code null} / молчаливый пропуск): вложенные
* таблицы (sprmPFInnerTtp), вертикальное объединение ячеек (vertMerge),
@@ -46,15 +52,31 @@ final class Tables {
/** Минимум центров в TDefTable: ncols≥1 → centers[ncols+1]≥2 (§2.9.321). */
private static final int MIN_CENTERS = 2;
+ /** Fts=ftsDxa (0x03): wWidth CSSA задан в twips; прочие Fts сторона не задают (§2.6.3). */
+ private static final int FTS_DXA = 0x03;
+ /** Кап wWidth полей ячеек (31680 = 22″, §2.6.3). */
+ private static final int MAX_CELL_MARGIN = 31680;
+
+ /**
+ * Поля ячеек из одного CSSAOperand (§2.9.209): стороны grfbrc (биты
+ * top|left|bottom|right = 1|2|4|8) с шириной wWidth (dxa, ≥0) для ячеек
+ * ряда с индексами [itcFirst, itcLim). Default-operand (0xD634) — весь
+ * ряд (itcLim = {@link Integer#MAX_VALUE}).
+ */
+ record CellMargin(int itcFirst, int itcLim, int sideMask, int width) {
+ }
+
/**
* Сетка строки: ширины колонок, сдвиг от поля, XML границ (может быть
* пустым), выравнивание таблицы ("center"/"right"; null = left → элемент
* не эмитится), вертикальное выравнивание содержимого ячеек по индексам
* строки (sprmTVertAlign → {@code w:vAlign}: 0 top, 1 center, 2 bottom;
- * {@code null} — ни одного 0xD62C, все top).
+ * {@code null} — ни одного 0xD62C, все top) и явные поля ячеек
+ * (sprmTCellPadding/…Default → {@code w:tcMar}, пустой список — дефолт
+ * конвейера 108/0, он же дефолт Word).
*/
record Grid(int[] colWidths, int indent, String bordersXml, String tblJc,
- int[] cellVAlign) {
+ int[] cellVAlign, List cellMargins) {
/**
* Абсолютные границы колонок: [indent, indent+w0, …] — восстановленный
@@ -97,6 +119,15 @@ final class Tables {
"C0C0C0", // 16 gray 25%
};
+ /**
+ * Ico (§2.9.171) → RRGGBB; 0/auto и вне таблицы (в т.ч. 0x1F = nil у
+ * Shd80) — {@code null}. Пользуется {@code DocxBody} для Shd80/
+ * затенений.
+ */
+ static String icoColor(int ico) {
+ return ico > 0 && ico < ICO_COLORS.length ? ICO_COLORS[ico] : null;
+ }
+
/**
* Имена ST_Border по brcType (§2.9.39, колонка Reference); 0 — none.
* package-private хук для юнита полного покрытия таблицы.
@@ -145,6 +176,7 @@ final class Tables {
String[] jc = {null};
boolean[] jcSeen = {false};
List vaRanges = new ArrayList<>();
+ List margins = new ArrayList<>();
Grpprl.scan(tap, 0, tap.length, (sprm, buf, off, len) -> {
if (sprm == Grpprl.SPRM_T_DEF_TABLE && len >= 3) {
centers[0] = readDefTable(buf, off, len);
@@ -165,6 +197,12 @@ final class Tables {
// CellRangeVertAlign (§2.9.30): cb=3 + itcFirst + itcLim + VerticalAlign
vaRanges.add(new int[] {buf[off + 1] & 0xFF, buf[off + 2] & 0xFF,
buf[off + 3] & 0xFF});
+ } else if (sprm == Grpprl.SPRM_T_CELL_PADDING
+ || sprm == Grpprl.SPRM_T_CELL_PADDING_DEFAULT) {
+ CellMargin m = cssa(sprm, buf, off, len);
+ if (m != null) {
+ margins.add(m);
+ }
}
});
int[] c = centers[0];
@@ -188,7 +226,32 @@ final class Tables {
}
}
}
- return new Grid(colWidths, c[0], borders[0], jc[0], cellVAlign);
+ return new Grid(colWidths, c[0], borders[0], jc[0], cellVAlign, margins);
+ }
+
+ /**
+ * CSSAOperand (§2.9.209) полей ячеек: cb(1)=6 + itc(2, ItcFirstLim) +
+ * grfbrc(1, маска сторон) + ftsWidth(1) + wWidth(2 XAS_nonNeg).
+ * Переносится только ftsDxa (0x03) — ftsNil/percent/auto сторона не
+ * задают (§2.6.3: wWidth ≤ 31680); битый операнд/пустая маска — null.
+ * Default-operand (0xD634) действует на весь ряд: его itc по §2.6.3 —
+ * фиктивные 0/1, диапазон заменяется на [0, ∞).
+ */
+ private static CellMargin cssa(int sprm, byte[] buf, int off, int len) {
+ if (len != 7 || (buf[off] & 0xFF) != 6 || (buf[off + 4] & 0xFF) != FTS_DXA) {
+ return null;
+ }
+ int mask = buf[off + 3] & 0x0F;
+ int width = CfbReader.u16(buf, off + 5);
+ if (mask == 0 || width > MAX_CELL_MARGIN) {
+ return null;
+ }
+ if (sprm == Grpprl.SPRM_T_CELL_PADDING_DEFAULT) {
+ return new CellMargin(0, Integer.MAX_VALUE, mask, width);
+ }
+ int first = buf[off + 1] & 0xFF;
+ int lim = buf[off + 2] & 0xFF;
+ return lim > first ? new CellMargin(first, lim, mask, width) : null;
}
/** sprmTJc/sprmTJc90 (§2.6.3): 1 → "center", 2 → "right", прочее (0/left) → null. */
@@ -245,7 +308,7 @@ final class Tables {
continue;
}
int ico = buf[b + 2] & 0xFF;
- String color = ico < ICO_COLORS.length ? ICO_COLORS[ico] : null;
+ String color = icoColor(ico);
appendBorder(xml, names[i], type, buf[b] & 0xFF, color);
}
return xml.length() == 0 ? "" : "" + xml + "";
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 7475802..c900e4c 100644
--- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java
+++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java
@@ -2585,4 +2585,118 @@ class WordPdfConverterTest {
minimalDocx("ХАЙЛАЙТЖЕЛТЫЙ"), true));
}
+ /**
+ * Поля УРОВНЯ ЯЧЕЙКИ (w:tcMar) рисуются так же, как tblCellMar: текст на
+ * margin+padding (мост переносит sprmTCellPadding именно в w:tcMar).
+ */
+ @Test
+ void tableTcMar_textInsetLikeWord() throws Exception {
+ byte[] docx = minimalDocx(""
+ + ""
+ + ""
+ + "Q",
+ ""
+ + "");
+ Path pdf = convertPdf(docx, "t");
+ // margin 1800 twips = 90pt + tcMar left 288 = 14.4pt (та же арифметика,
+ // что у tableCellPadding_textInsetLikeWord)
+ assertEquals(104.4, xOfMarker(pdf, 'Q'), 0.9);
+ }
+
+ /**
+ * .doc-путь: sprmCHighlight → жёлтый фон рана, sprmCShd (ipatSolid,
+ * cvFore жёлтый) — тоже; baseline без свойств — ноль жёлтых px.
+ * Регрессия — аудит [MS-DOC] 2026-11 (Grpprl/DocToDocx, Ico→ST_HighlightColor).
+ */
+ @Test
+ void docHighlightAndShading_yellowPixels() throws IOException {
+ byte[] shdYellowSolid = {
+ (byte) 0x71, (byte) 0xCA, 10,
+ (byte) 0xFF, (byte) 0xFF, 0, 0, // cvFore = жёлтый (COLORREF R-first)
+ 0, 0, 0, (byte) 0xFF, // cvBack = auto
+ 1, 0, // ipat = ipatSolid
+ };
+ byte[] doc = classDDoc("ЖЕЛТШД\r", null, null, new int[] {0, 4},
+ new byte[][] {prl(0x2A0C, 7), shdYellowSolid});
+ assertTrue(countPixels(doc, true) > 0, "подсветка/затенение не нарисованы");
+ assertTrue(norm(pdfText(convertPdf(doc, "тест"))).contains("ЖЕЛТШД"),
+ "текст подсвеченного рана потерян");
+ assertEquals(0, countPixels(classDDoc("ЖЕЛТШД\r", null, null,
+ new int[0], new byte[0][]), true), "жёлтый утёк в baseline");
+ }
+
+ /**
+ * sprmSFTitlePage + first-колонтитук Plcfhdd: первая страница — «ПЕРВАЯ!»,
+ * обычная — «ОБЫЧНАЯ» ( slots §2.8.22, w:titlePg §17.13.1.35; FOP
+ * first/default различает — регрессия docx titlePg_firstPageHeader).
+ * Регрессия — аудит [MS-DOC] 2026-11 (Sections/Headers/DocToDocx).
+ */
+ @Test
+ void docTitlePage_firstHeaderOnlyFirstPage() throws Exception {
+ Path pdf = convertPdf(titlePageDoc(), "doc-titlepage");
+ try (PDDocument doc = Loader.loadPDF(pdf.toFile())) {
+ assertEquals(2, doc.getNumberOfPages(), "разрыв 0x0C не дал страницу");
+ }
+ String p1 = norm(pdfPageText(pdf, 1));
+ String p2 = norm(pdfPageText(pdf, 2));
+ assertTrue(p1.contains("ПЕРВАЯ!"), "first-шапка не на первой странице: " + p1);
+ assertFalse(p1.contains("ОБЫЧНАЯ"), "default-шапка утекла на первую: " + p1);
+ assertTrue(p2.contains("ОБЫЧНАЯ"), "default-шапка пропала: " + p2);
+ assertFalse(p2.contains("ПЕРВАЯ"), "first-шапка утекла на вторую: " + p2);
+ }
+
+ /**
+ * Односекционный .doc с titlePg: body «Текст1⌬Текст2⏎» (0x0C на CP6),
+ * Sepx — sprmSFTitlePage=1; Plcfhdd (13 aCP): odd hdr «ОБЫЧНАЯ»,
+ * first hdr «ПЕРВАЯ!», footers не определены ([x,x), §2.4.4).
+ */
+ private static byte[] titlePageDoc() throws IOException {
+ String text = "Текст1" + (char) 0x0C + "Текст2\r"
+ + "\r\r\r\r\r\r" + "ОБЫЧНАЯ\r" + "ПЕРВАЯ!\r" + "\r";
+ byte[] wd = new byte[2048 + 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, 14); // ccpText
+ put32(wd, 80, 0); // ccpFtn
+ put32(wd, 84, text.length() - 14); // ccpHdd
+ put16(wd, 152, 98);
+ pair(wd, 6, 0, 20); // PlcfSed @0 + fcSepx=512
+ pair(wd, 11, 20, 52); // Plcfhdd @20: aCp(13)
+ pair(wd, 33, 72, 21); // Clx @72
+ wd[512] = 3; // Sepx: cb=3, sprmSFTitlePage=1
+ wd[513] = 0;
+ wd[514] = 0x0A;
+ wd[515] = 0x30;
+ wd[516] = 1;
+ byte[] t = text.getBytes(StandardCharsets.UTF_16LE);
+ System.arraycopy(t, 0, wd, 2048, t.length);
+ byte[] tab = new byte[93];
+ put32(tab, 0, 0);
+ put32(tab, 4, 14);
+ put32(tab, 10, 512); // SED[0].fcSepx
+ // aCp относительны header-документа: separators [0,6); odd hdr [6,14),
+ // first hdr [14,22), остальное — [x,x) (не определено), хвост [22,23)
+ int[] hdd = {0, 1, 2, 3, 4, 5, 6, 6, 14, 14, 14, 22, 23};
+ for (int i = 0; i < hdd.length; i++) {
+ put32(tab, 20 + i * 4, hdd[i]);
+ }
+ tab[72] = 0x02; // Clx Pcdt, один несжатый кусок
+ put32(tab, 73, 16);
+ put32(tab, 77, 0);
+ put32(tab, 81, text.length());
+ put32(tab, 87, 2048);
+ 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(new byte[64]));
+ fs.writeFilesystem(out);
+ return out.toByteArray();
+ }
+ }
+
}
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 2cf8dc1..adbe10e 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
@@ -1667,6 +1667,12 @@ class DocToDocxFormattingTest {
*/
private static byte[] craftDoc(String text, byte[] sepxGrpprl, byte[] data,
List chpxRuns, List papxRuns) throws IOException {
+ return craftDoc(text, sepxGrpprl, data, chpxRuns, papxRuns, null);
+ }
+
+ private static byte[] craftDoc(String text, byte[] sepxGrpprl, byte[] data,
+ List chpxRuns, List papxRuns, byte[] stsh)
+ throws IOException {
// FKP-страницы (1024/1536) обязаны влезать в поток даже без текста
byte[] wd = new byte[Math.max(TEXT_FC, 2048) + text.length() * 2];
put16(wd, 0, 0xA5EC);
@@ -1684,12 +1690,18 @@ class DocToDocxFormattingTest {
pair(wd, 13, 48, 12); // PlcfBtePapx @48, pn=3
}
pair(wd, 33, 60, 21); // Clx @60
+ if (stsh != null) {
+ pair(wd, 1, 82, stsh.length); // Stshf @82 (после Clx 60+21)
+ }
if (sepxGrpprl != null) {
sepx(wd, 512, sepxGrpprl);
}
byte[] t = text.getBytes(StandardCharsets.UTF_16LE);
System.arraycopy(t, 0, wd, TEXT_FC, t.length);
- byte[] tab = new byte[81];
+ byte[] tab = new byte[stsh == null ? 81 : 82 + stsh.length];
+ if (stsh != null) {
+ System.arraycopy(stsh, 0, tab, 82, stsh.length);
+ }
put32(tab, 0, 0);
put32(tab, 4, text.length());
if (sepxGrpprl != null) {
@@ -1872,6 +1884,163 @@ class DocToDocxFormattingTest {
assertFalse(xml.contains(">> 8), 6,
+ (byte) itcFirst, (byte) itcLim, (byte) grfbrc, (byte) fts,
+ (byte) wWidth, (byte) (wWidth >>> 8)};
+ }
+
+ /** SHDOperand (§2.9.177): cb=10 + cvFore(4) + cvBack(4) + ipat(2), COLORREF R-first. */
+ private static byte[] shd10(int sprm, int[] fore, int[] back, int ipat) {
+ byte[] op = new byte[3 + 10];
+ op[0] = (byte) (sprm & 0xFF);
+ op[1] = (byte) (sprm >>> 8);
+ op[2] = 10;
+ for (int i = 0; i < 4; i++) {
+ op[3 + i] = (byte) fore[i];
+ op[7 + i] = (byte) back[i];
+ }
+ op[11] = (byte) ipat;
+ op[12] = (byte) (ipat >>> 8);
+ return op;
+ }
+
+ /**
+ * sprmCHighlight (Ico→ST_HighlightColor) и sprmCShd/sprmCShd80 → rPr:
+ * solid → fill=cvFore, паттерн → fill=cvBack, w:val="clear" (форма Word,
+ * FOP красит только fill); ico=0/auto-оба-цвета не эмитятся.
+ */
+ @Test
+ void runHighlightAndShading_inRPr() throws IOException {
+ int[] red = {0xFF, 0, 0, 0};
+ int[] auto = {0, 0, 0, 0xFF};
+ String xml = documentXml(craftDoc("HySh8PtAuto\r", null, null,
+ List.of(new ChpxRun(0, prl(0x2A0C, 7)), // yellow
+ new ChpxRun(2, shd10(0xCA71, red, auto, 1)), // solid red
+ new ChpxRun(4, new byte[] {0x66, 0x48, // CShd80: fore
+ (byte) (2 | (4 << 5) | (1 << 10)), // =blue(2),
+ (byte) ((2 | (4 << 5) | (1 << 10)) >>> 8)}), // back=green(4)
+ new ChpxRun(6, shd10(0xCA71, red, auto, 2)), // паттерн: fill=back
+ new ChpxRun(8, concat(prl(0x2A0C, 0),
+ shd10(0xCA71, auto, auto, 1)))), // auto — ничего
+ List.of(new PapxRun(0, null))));
+ assertTrue(xml.contains(""), "highlight: " + xml);
+ assertTrue(xml.contains(""), "CShd solid → fill=cvFore: " + xml);
+ assertTrue(xml.contains(""), "CShd80 solid → fill=cvFore (Ico blue): " + xml);
+ assertEquals(1, xml.split("w:fill=\"FF0000\"", -1).length - 1,
+ "паттерн красит cvBack (auto→null), не cvFore: " + xml);
+ assertFalse(xml.contains("w:fill=\"00FF00\""),
+ "паттерн с auto-cvBack не должен брать cvFore: " + xml);
+ assertFalse(xml.contains("w:fill=\"auto\""), xml);
+ }
+
+ /**
+ * sprmCShd паттерна с явным cvBack → деградация в сплошной фон cvBack
+ * (паттернов в FOP нет); w:shd рана идёт в rPr.
+ */
+ @Test
+ void runShadingPattern_degradesToBackFill() throws IOException {
+ String xml = documentXml(craftDoc("Pat\r", null, null,
+ List.of(new ChpxRun(0, shd10(0xCA71, new int[] {0xFF, 0, 0, 0},
+ new int[] {0, 0xFF, 0, 0}, 2))),
+ List.of(new PapxRun(0, null))));
+ assertTrue(xml.contains(""), "паттерн → fill=cvBack: " + xml);
+ }
+
+ /** sprmPShd/sprmPShd80 → w:shd в pPr до jc (CT_PPr: pBdr→shd→tabs→…→jc). */
+ @Test
+ void paraShd_inPPrBeforeJc() throws IOException {
+ String xml = documentXml(craftDoc("Para\r", null, null, List.of(),
+ List.of(new PapxRun(0, concat(prl(0x2461, 2),
+ shd10(0xC64D, new int[] {0xFF, 0, 0, 0},
+ new int[] {0, 0, 0, 0xFF}, 1))))));
+ int shd = xml.indexOf("");
+ int jc = xml.indexOf("");
+ assertTrue(shd > 0 && jc > shd, "w:shd в pPr до w:jc (CT_PPr): " + xml);
+ String p80 = documentXml(craftDoc("P80\r", null, null, List.of(),
+ List.of(new PapxRun(0, new byte[] {0x2D, 0x44,
+ (byte) (2 | (4 << 5) | (1 << 10)), (byte) 0x04}))));
+ assertTrue(p80.contains(""), "sprmPShd80: " + p80);
+ }
+
+ /**
+ * sprmCIstd: chpx-цепочка символьного стиля (stk=3) между стилевой
+ * papx-цепочкой и прямыми CHPX; прямые перекрывают стиль (last-wins).
+ */
+ @Test
+ void charStyle_viaIstd_mergesUnderDirect() throws IOException {
+ // стиль istd=10 (stk=3): синий + underline; ран: istd + прямой cv=red
+ byte[] style = std(65, 3, 0x0FFF, 1, null,
+ concat(new byte[] {0x70, 0x68, 0, 0, (byte) 0xFF, 0}, prl(0x2A3E, 1)));
+ byte[] stsh = new byte[2 + 18 + 10 * 2 + 2 + style.length];
+ put16(stsh, 0, 18); // cbStshi
+ put16(stsh, 2, 11); // cstd
+ put16(stsh, 4, 0x0A); // cbSTDBaseInFile
+ int p = 20;
+ for (int i = 0; i < 10; i++) {
+ put16(stsh, p, 0);
+ p += 2;
+ }
+ lpstd(stsh, p, style);
+ String xml = documentXml(craftDoc("Lnk\r", null, null,
+ List.of(new ChpxRun(0, concat(prl2(0x4A30, 10),
+ new byte[] {0x70, 0x68, (byte) 0xFF, 0, 0, 0}))),
+ List.of(new PapxRun(0, null)), stsh));
+ assertTrue(xml.contains(""),
+ "underline из символьного стиля потерян: " + xml);
+ assertTrue(xml.contains("", -1).length - 1,
+ "обе ячейки получают Default-поля (108 L/R): " + xml);
+ assertEquals(2, xml.split("", -1).length - 1, xml);
+ int mar = xml.indexOf("");
+ assertTrue(xml.indexOf("") > mar
+ && xml.indexOf(" xml.indexOf(
+ ""),
+ "диапазонный top=20 только у ячейки 0, top до left (CT_TcMar): " + xml);
+ assertEquals(1, xml.split("");
+ assertTrue(cols > 0 && tp > cols, "w:titlePg после w:cols: " + xml);
+ assertFalse(documentXml(craftDoc("x\r", prl2(0x900C, 720), null, List.of(),
+ List.of(new PapxRun(0, null)))).contains(""),
+ "без sprmSFTitlePage — не эмитится");
+ }
+
/** Якорь плавающей картинки 0x08 + sprmCPicLocation → inline-картинка (раньше выбрасывался). */
@Test
void drawnObject_becomesInlinePicture() throws IOException {
diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/doc/GrpprlTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/doc/GrpprlTest.java
index 79abcb9..0758a21 100644
--- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/doc/GrpprlTest.java
+++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/doc/GrpprlTest.java
@@ -169,4 +169,34 @@ class GrpprlTest {
assertEquals(300, md.right(), "right — слияние last-wins");
assertEquals(120, md.left1(), "left1 — слияние last-wins");
}
+
+ @Test
+ void tInsertOperand_skippedBySpra() {
+ // sprmTInsert 0x7621 (§2.9.322): операнд 4 байта (itcFirst+ctc+dxaCol) —
+ // правило spra=3 корректен и для формы ECMA-376 Part 4 (rgtte), и для
+ // формы MS-DOC; в образцах ru-table-image.doc/ru-en-mixed.doc Word
+ // пишет 4-байтовый, following-sprm выравнивается ровно при 4.
+ // Следующий Prl (sprmTJc 0x548A) обязан дойти до sink несъеденным.
+ byte[] buf = {
+ 0x21, 0x76, 0x00, 0x02, 0x68, 0x01, // tInsert: itcFirst=0, ctc=2, dxaCol=360
+ (byte) 0x8A, 0x54, 0x01, 0x00, // sprmTJc = center
+ };
+ List seen = new ArrayList<>();
+ List sizes = new ArrayList<>();
+ Grpprl.scan(buf, 0, buf.length, (sprm, b, off, len) -> {
+ seen.add(sprm);
+ sizes.add(len);
+ });
+ assertEquals(List.of(0x7621, 0x548A), seen, "скан не рассинхронизирован");
+ assertEquals(List.of(4, 2), sizes);
+ }
+
+ @Test
+ void tInsertOperand_truncated_aborts() {
+ // rgttte-хвост не влезает → обрыв без исключения (контракт scan)
+ byte[] buf = {0x21, 0x76, 0x00, 0x02, 0x68};
+ int[] count = {0};
+ Grpprl.scan(buf, 0, buf.length, (sprm, b, off, len) -> count[0]++);
+ assertEquals(0, count[0]);
+ }
}
diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/doc/HeadersTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/doc/HeadersTest.java
index 6fbe29e..aa957d0 100644
--- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/doc/HeadersTest.java
+++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/doc/HeadersTest.java
@@ -64,6 +64,13 @@ class HeadersTest {
assertFalse(new Headers.Story(5, 6).hasContent());
// секции 1 нет (aCp короче) → пустая история
assertEquals(0, h.oddHeader(1).cpEnd());
+ // slots FIRST_HEADER=4/FIRST_FOOTER=5 (§2.8.22): first hdr = [1020, 1022),
+ // first ftr = [1022, 1024)
+ Headers.Story fh = h.firstHeader(0);
+ assertEquals(1020, fh.cpStart());
+ assertEquals(1022, fh.cpEnd());
+ assertTrue(fh.hasContent());
+ assertEquals(1022, h.firstFooter(0).cpStart());
}
/**
diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/doc/SectionsTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/doc/SectionsTest.java
index 6f938c3..58b5bad 100644
--- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/doc/SectionsTest.java
+++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/doc/SectionsTest.java
@@ -199,6 +199,21 @@ class SectionsTest {
* Spacing (§2.6.4): accessors секции; iCol за массивом — молча; restart
* без start97 → старт 1.
*/
+ @Test
+ void titlePage_flagFromSepx() {
+ // sprmSFTitlePage Bool8=1 → Section.titlePage()=true; без sprm — false
+ byte[] wd = new byte[4096];
+ sepx(wd, 64, new byte[] {
+ 0x0A, 0x30, 1, // titlePage = true
+ (byte) 0x21, (byte) 0xB0, (byte) 0x90, 0x01, // dxaLeft = 400
+ });
+ byte[] t = plcfSed(64);
+ Sections s = Sections.read(t, 0, t.length, wd, 1000);
+ assertTrue(s.list().get(0).titlePage());
+ Sections plain = Sections.read(plcfSed(0), 0, plcfSed(0).length, wd, 1000);
+ assertFalse(plain.list().get(0).titlePage());
+ }
+
@Test
void orientationPgNumColumns_applied() {
byte[] wd = new byte[4096];
diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/doc/StylesTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/doc/StylesTest.java
index 2cb567d..9ceacfe 100644
--- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/doc/StylesTest.java
+++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/doc/StylesTest.java
@@ -141,6 +141,31 @@ class StylesTest {
assertArrayEquals(new byte[0], s.chpxChain(10));
}
+ @Test
+ void characterStyle_stk3_chainViaCharChain() {
+ // stk=3 (STCF, Word 97+): единственный UPX = UpxChpx целиком; цепочка
+ // base-first (источник sprmCIstd); papx-цепочка символьного стиля пуста
+ byte[] blue = {0x70, 0x68, 0x00, 0x00, (byte) 0xFF, 0x00}; // sprmCCv blue
+ byte[] table = stsh(13,
+ std(65, 3, 0x0FFF, null, blue),
+ std(105, 3, 10, null, BOLD));
+ Styles s = Styles.read(table, 0, table.length);
+ assertArrayEquals(concat(blue, BOLD), s.charChain(11),
+ "символьная цепочка base-first");
+ assertArrayEquals(blue, s.charChain(10));
+ assertArrayEquals(new byte[0], s.papxChain(11), "papx у символьного нет");
+ }
+
+ @Test
+ void charChain_nonCharacterStk_empty() {
+ // sprmCIstd обязан указывать на символьный стиль; stk=1/2 и промахи — пусто
+ byte[] table = stsh(12, std(65, 1, 0x0FFF, JC_CENTER, BOLD));
+ Styles s = Styles.read(table, 0, table.length);
+ assertArrayEquals(new byte[0], s.charChain(10), "stk=1 через charChain — пусто");
+ assertArrayEquals(new byte[0], s.charChain(99));
+ assertArrayEquals(new byte[0], s.charChain(-1));
+ }
+
@Test
void brokenStsh_emptyTableNotThrow() {
assertEmptyFor(new byte[0]);
diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/doc/TablesTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/doc/TablesTest.java
index 35227f4..87a41cb 100644
--- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/doc/TablesTest.java
+++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/doc/TablesTest.java
@@ -276,4 +276,55 @@ class TablesTest {
byte[] bad = {0x2C, (byte) 0xD6, 9, 0, 1, 2};
assertNull(Tables.parse(concat(defTable(new int[] {0, 3000}), bad)).cellVAlign());
}
+
+ /** CSSAOperand (§2.9.209): cb(1)=6 + itc(2) + grfbrc(1) + fts(1) + wWidth(2). */
+ private static byte[] cssa(int sprm, int itcFirst, int itcLim, int grfbrc,
+ int fts, int wWidth) {
+ return new byte[] {(byte) (sprm & 0xFF), (byte) (sprm >>> 8), 6,
+ (byte) itcFirst, (byte) itcLim, (byte) grfbrc, (byte) fts,
+ (byte) wWidth, (byte) (wWidth >>> 8)};
+ }
+
+ @Test
+ void cellPadding_defaultAppliesToRowAndSidesParsed() {
+ // Word пишет два …Default: L/R dxa=108 и T/B dxa=0 (образец doc-formats.doc)
+ Tables.Grid g = Tables.parse(concat(defTable(new int[] {0, 3000}),
+ cssa(Grpprl.SPRM_T_CELL_PADDING_DEFAULT, 0, 1, 0x0A, 3, 108),
+ cssa(Grpprl.SPRM_T_CELL_PADDING_DEFAULT, 0, 1, 0x05, 3, 0)));
+ assertEquals(2, g.cellMargins().size());
+ Tables.CellMargin lr = g.cellMargins().get(0);
+ assertEquals(0, lr.itcFirst());
+ assertEquals(Integer.MAX_VALUE, lr.itcLim(), "Default-operand — весь ряд");
+ assertEquals(0x0A, lr.sideMask());
+ assertEquals(108, lr.width());
+ assertEquals(0, g.cellMargins().get(1).width(), "явный 0 — поле переносится");
+ }
+
+ @Test
+ void cellPadding_rangeOperandKeepsItc() {
+ Tables.Grid g = Tables.parse(concat(defTable(new int[] {0, 3000, 6000}),
+ cssa(Grpprl.SPRM_T_CELL_PADDING, 1, 2, 0x02, 3, 25)));
+ assertEquals(1, g.cellMargins().size());
+ assertEquals(1, g.cellMargins().get(0).itcFirst());
+ assertEquals(2, g.cellMargins().get(0).itcLim(), "padding — диапазон [1, 2)");
+ }
+
+ @Test
+ void cellPadding_ftsNilEmptyMaskAndEmptyRangeIgnored() {
+ // ftsNil (0) — сторона не задана (§2.6.3); маска 0 и пустой itc-диапазон — тоже
+ Tables.Grid g = Tables.parse(concat(defTable(new int[] {0, 3000}),
+ cssa(Grpprl.SPRM_T_CELL_PADDING_DEFAULT, 0, 1, 0x0A, 0, 0),
+ cssa(Grpprl.SPRM_T_CELL_PADDING, 2, 2, 0x0A, 3, 108),
+ cssa(Grpprl.SPRM_T_CELL_PADDING, 0, 3, 0x00, 3, 108)));
+ assertTrue(g.cellMargins().isEmpty(), "ни одного переносимого поля");
+ }
+
+ @Test
+ void cellPadding_truncatedOperandIgnoredGridSurvives() {
+ // cb=6, но операнд обрезан (len=5 ≠ 7) — молчаливый пропуск, сетка жива
+ Tables.Grid g = Tables.parse(concat(defTable(new int[] {0, 3000}),
+ new byte[] {0x34, (byte) 0xD6, 0x06, 0x00, 0x01, 0x0A, 0x03}));
+ assertEquals(1, g.colWidths().length);
+ assertTrue(g.cellMargins().isEmpty());
+ }
}