Commit Graph

92 Commits

Author SHA1 Message Date
Pjandro 03213dceb4 SmartArt: соответствие ECMA-376 (формулы/переменные геометрии, цвета и трансформации, flipH/flipV, dsp:grpSp)
PR checks / web (pull_request) Successful in 38s
PR checks / java (pull_request) Successful in 1m26s
Main: tests, deploy, autotests / web (push) Successful in 43s
Main: tests, deploy, autotests / java (push) Successful in 55s
Main: tests, deploy, autotests / images-web (push) Successful in 31s
Main: tests, deploy, autotests / images-app (push) Successful in 2m10s
Main: tests, deploy, autotests / deploy (push) Successful in 2m19s
Main: tests, deploy, autotests / autotests (push) Successful in 52s
Main: tests, deploy, autotests / rollback (push) Has been skipped
2026-10-25 14:18:34 +00:00
Pjandro ae63892c71 chart3d: соответствие ECMA-376 для bar3D/area3D/line3D/surface3D/pie3D
PR checks / web (pull_request) Successful in 34s
PR checks / java (pull_request) Failing after 1m24s
- ChartSpec: парсинг c:hPercent, c:grouping (bar3D/area3D), per-series c:shape
- rAngAx=true имеет приоритет над c:perspective (Surface3d/Cartesian3d/Pie)
- c:hPercent сжимает глубину в Surface3dPainter/Cartesian3dPainter
- c:gapDepth (MS-OI29500 §2.1.1474): раскладка полос рядов по глубине
- подписи оси глубины serAx + учёт c:delete осей
- wireframe = только каркас (без полос высот); bandFmt-полосы сортируются по глубине
- формы bar3D: cone/cylinder/pyramid + *ToMax (§21.2.3.44), per-series override
- stacked/percentStacked для bar3D и area3D (§21.2.2.76); line3D игнорирует grouping

Регрессии: Cartesian3dPainterTest/Surface3dPainterTest/PiePainterTest/ChartSpecTest.
2026-10-25 13:12:56 +00:00
Pjandro fbdada1fda chart: 9 новых типов диаграмм (scatter/bubble/radar/stock/ofPie/surface2D/bar3D/area3D/line3D)
PR checks / web (pull_request) Successful in 55s
PR checks / java (pull_request) Successful in 1m6s
Main: tests, deploy, autotests / web (push) Successful in 32s
Main: tests, deploy, autotests / images-web (push) Successful in 35s
Main: tests, deploy, autotests / java (push) Successful in 2m17s
Main: tests, deploy, autotests / images-app (push) Successful in 31s
Main: tests, deploy, autotests / deploy (push) Successful in 1m46s
Main: tests, deploy, autotests / autotests (push) Successful in 52s
Main: tests, deploy, autotests / rollback (push) Has been skipped
- ChartSpec: enum +9 типов, readGroup 9 веток, два c:valAx для scatter/bubble
  (X — первый), автозаголовок OF_PIE как у круговых
- ChartRenderer: диспетчер + легенда высотных полос для SURFACE
- Пейнтеры: ScatterPainter, RadarPainter, StockPainter, OfPiePainter,
  Surface2dPainter, Cartesian3dPainter (камера Surface3dPainter.project)
- Фикстура samples/chart-types.docx (ChartTypesDocxGenerator, chart-XML
  литералами) + регрессия WordPdfConverterTest#chartTypes_allTypesRenderAsImages
- docs/standards: полные наборы XSD strict/transitional + validate-fixtures.py;
  все 13 фикстур валидны по ECMA-376 (битые атрибуты в старых фикстурах
  исправлены в генераторе и пересозданных .docx)
- AGENTS.md/README обновлены
2026-10-25 02:13:28 +00:00
Pjandro 6ab732b1b4 docs(chart): firstSliceAng вне CT_Pie3DChart по стандарту, а не из-за пробела docx4j
PR checks / web (pull_request) Successful in 31s
PR checks / java (pull_request) Successful in 1m19s
Main: tests, deploy, autotests / java (push) Successful in 55s
Main: tests, deploy, autotests / web (push) Successful in 39s
Main: tests, deploy, autotests / images-app (push) Successful in 39s
Main: tests, deploy, autotests / images-web (push) Successful in 1m4s
Main: tests, deploy, autotests / deploy (push) Successful in 1m27s
Main: tests, deploy, autotests / autotests (push) Successful in 44s
Main: tests, deploy, autotests / rollback (push) Has been skipped
Комментарии у поля ChartSpec.firstSliceAng и в PiePainter.paint приписывали
невозможность чтения firstSliceAng для PIE3D отсутствию геттера в JAXB-модели
docx4j 17.3.2. По ECMA-376 элемент §21.2.2.68 определён только для
CT_PieChart/CT_DoughnutChart; CT_Pie3DChart (§21.2.2.140, модель §A.5.1) его
не содержит — JAXB-класс верен стандарту. Поворот 3D-пирога — c:view3D/rotY
(readView3D/paint3d). Поведение не менялось.
2026-10-25 00:56:40 +00:00
Pjandro 4a0cd6a9b3 refactor(core): нормализаторы публикуют STEP-шаги конвейера
PR checks / web (pull_request) Successful in 40s
PR checks / java (pull_request) Successful in 57s
Main: tests, deploy, autotests / web (push) Successful in 39s
Main: tests, deploy, autotests / java (push) Successful in 1m12s
Main: tests, deploy, autotests / images-web (push) Successful in 1m0s
Main: tests, deploy, autotests / images-app (push) Successful in 45s
Main: tests, deploy, autotests / deploy (push) Successful in 1m33s
Main: tests, deploy, autotests / autotests (push) Successful in 39s
Main: tests, deploy, autotests / rollback (push) Has been skipped
2026-10-25 00:21:20 +00:00
Pjandro 5714bc835b refactor(core): интерфейс DocxNormalizer, конвейер нормализаторов списком в конвертере
PR checks / web (pull_request) Successful in 40s
PR checks / java (pull_request) Successful in 58s
2026-10-25 00:13:29 +00:00
Pjandro e356c36e45 Удаление невидимых символов из w:t: FOP больше не рисует пустые строки и боксы
PR checks / web (pull_request) Successful in 39s
PR checks / java (pull_request) Successful in 58s
Main: tests, deploy, autotests / web (push) Successful in 41s
Main: tests, deploy, autotests / java (push) Successful in 53s
Main: tests, deploy, autotests / images-web (push) Successful in 32s
Main: tests, deploy, autotests / images-app (push) Successful in 3m50s
Main: tests, deploy, autotests / deploy (push) Successful in 1m31s
Main: tests, deploy, autotests / autotests (push) Successful in 49s
Main: tests, deploy, autotests / rollback (push) Has been skipped
2026-10-25 00:01:17 +00:00
Pjandro a67a16851c wordpdf-core: гейт JaCoCo BRANCH 0.85 + тесты до 89.4% ветвей
- execution check в wordpdf-core/pom.xml добавляет BRANCH COVEREDRATIO 0.85 (LINE 0.90 остаётся)
- партии тестов: chart-пейнтеры/рендер/DrawMlText, WordPdfValidator lightweight-сканер,
  нормализаторы (Symbol/Strict/GlyphCoverage/Field/Ole), шрифты (BundledFonts/Mapper, FopFallback)
- CartesianPainter: guard valGutter при valAxis=null (NPE при диаграммах без c:valAx)
- 327 тестов ядра, BRANCH 1924/2151 (89.4%), LINE 95.4%
2026-10-24 23:30:57 +00:00
Pjandro 114b1fe2ee AGENTS.md: счётчик тестов, регрессивные пары, защитные константы chart
PR checks / web (pull_request) Successful in 49s
PR checks / java (pull_request) Successful in 1m2s
2026-10-24 21:45:27 +00:00
Pjandro f4b92f2140 Надёжность: ConcurrentHashMap покрытия, volatile cmap, ApiKeyFilter против точечных сегментов, 413/400 из конфигурации, deleteOnExit TTF 2026-10-24 21:42:29 +00:00
Pjandro 50447aa9d0 Вывод: guard составного рана, AREA к базовой линии, вложенные раны текстбоксов, overlay-легенда 2026-10-24 21:38:33 +00:00
Pjandro 41fe926ba0 Chart: лимит MAX_POINTS на c:pt idx/ptCount и санитайзер шага оси (DoS через загруженный docx) 2026-10-24 21:31:27 +00:00
Pjandro 8a07597d4c JaCoCo: гейт покрытия 90% строк + сводка/артефакты репортов в CI
PR checks / web (pull_request) Successful in 54s
PR checks / java (pull_request) Failing after 1m9s
Корневой pom: jacoco-maven-plugin 0.8.15 (prepare-agent, report+check на
verify, report раньше check — отчёт готов даже при провале гейта), surefire
argLine через @{argLine}. pr.yml/main.yml job java: Coverage summary в
step summary + артефакт jacoco-html (оба шага if: always()).

Тесты ради гейта (23 класса / 218 @Test): app ConversionService/
ApiExceptionHandler/ConversionTimeout +1 в ConvertController; core
DrawMlColor/DrawMlText + инкременты ChartSpec/PresetGeometry.
Покрытие: core 91,0%, app 92,9% строк.
2026-10-24 18:39:44 +00:00
Pjandro 037474cf5b SmartArt: ECMA-376 пресет-геометрия вместо калиброванных коэффициентов
PR checks / java (pull_request) Successful in 47s
PR checks / web (pull_request) Successful in 53s
Main: tests, deploy, autotests / web (push) Successful in 43s
Main: tests, deploy, autotests / java (push) Successful in 45s
Main: tests, deploy, autotests / images-web (push) Successful in 29s
Main: tests, deploy, autotests / images-app (push) Successful in 2m26s
Main: tests, deploy, autotests / deploy (push) Successful in 2m56s
Main: tests, deploy, autotests / autotests (push) Successful in 51s
Main: tests, deploy, autotests / rollback (push) Has been skipped
PresetGeometry: avLst/gdLst/pathLst семи пресетов (rect, roundRect, ellipse,
gear6, gear9, circularArrow, leftCircularArrow) дословно из
presetShapeDefinitions.xml + вычислитель префиксных формул ST_GeomGuideFormula.
Кольцевые стрелки: оператор ?: = «if x > 0 then y else z» (ISO/IEC 29500-1),
углы Arc2D со знаком минус (математическая конвенция). PrstGeomShapes удалён.
PresetGeometryTest#tableMatchesEcmaXml пинит синхрон таблицы с копией
стандарта (test-ресурс geom/presetShapeDefinitions.xml).
2026-10-23 21:25:15 +00:00
Pjandro 93ec325aa6 OLE-объекты: переключатель errorOnOle + тихое удаление из docx
PR checks / java (pull_request) Successful in 47s
PR checks / web (pull_request) Successful in 1m6s
docx4j падает на внедрённых OLE-объектах двумя путями: JAXB-парсинг
бинарника под ложным XML-типом в [Content_Types] («Content is not
allowed in prolog» → NPE) и NPE chunkType is null в VML-сериализации
w:object. Новый OleObjectNormalizer (шестой в цепочке, после
GlyphCoverageNormalizer) удаляет OLE-bin-части, rels-ссылки, элементы
w:object и Override удалённых частей; при errorOnOle=true вместо
удаления — DrawingFoundException(OLE) → 422 «Конвертация отменена: в
документе найдены OLE-объекты».

- ядро: Kind.OLE, ConvertOptions.errorOnOle, WordPdfSettings.ERROR_ON_OLE,
  фикстура samples/ole-embedded.docx (ручная, оба механизма)
- app: параметр errorOnOle, 422-контракт, тесты errorFlagOle_rejected /
  oleObjects_removedByDefault
- SPA: третий переключатель «OLE-объекты»
- прод-автотесты: +2 проверки (21)
- регрессии: OleObjectNormalizerTest ↔ oleObjects_removedAndConverted /
  drawingErrors_errorFlagRejectsOle; E2E: notConverted.docx 500 → 200
2026-10-22 21:08:18 +00:00
Pjandro 6b2715f1c2 Убрать render-флаги диаграмм/SmartArt; автозаголовок — «Название диаграммы»
PR checks / java (pull_request) Successful in 45s
PR checks / web (pull_request) Successful in 1m20s
ConvertOptions: renderCharts/renderSmartArt удалены (ядро, REST, SPA,
прод-автотесты) — диаграммы/SmartArt конвертируются всегда, отказ только
по error-флагам (DrawingFoundException → 422). Дефолт SPA-галок — false.
ChartSpec.AUTO_TITLE русифицирован: «Название диаграммы».
AGENTS.md приведён в соответствие.
2026-10-22 17:50:17 +00:00
Pjandro 1d5486f4c7 pmd: добавить 4 правила и вычистить нарушения
PR checks / web (pull_request) Successful in 35s
PR checks / java (pull_request) Successful in 1m23s
- pmd-ruleset.xml: ReturnEmptyCollectionRatherThanNull (p1),
  AvoidLiteralsInIfCondition (p3), EmptyCatchBlock (p2),
  ForLoopCanBeForeach (p2)
- main: split/contentOf/invokeList возвращают List.of() вместо null;
  литералы в условиях if вынесены в именованные константы
  (9 файлов chart/валидатора); индексный цикл легенды → foreach
- src/test: 8 литералов в условиях if — те же именованные константы
- AGENTS.md: описание ruleset'а и гейта обновлено

mvn clean verify зелёный, 0 нарушений PMD.
2026-10-21 23:02:15 +00:00
Pjandro c09a3f5adf feat: рантайм без fontconfig — глиф-движок GlyphFont (fontbox) вместо java.awt.Font
PR checks / java (pull_request) Successful in 2m11s
PR checks / web (pull_request) Successful in 1m8s
На OpenJDK/Linux любое обращение к java.awt.Font требует fontconfig-нативки
(Fontconfig head is null на хосте без libfontconfig). java.awt.Font убран из
всего рантайм-пути: текст chart-движка (DrawMlText) и проверка покрытия глифов
(GlyphCoverageNormalizer) переведены на GlyphFont — чистый Java-парсер TTF
org.apache.pdfbox:fontbox 3.0.8 (compile; commons-logging исключён,
единственный провайдер jcl-over-slf4j). Метрики совпадают с AWT до 4-го знака,
кернинг-дрейф 0.0000 (DejaVu Sans, Carlito). AWT остаётся только как геометрия
(Graphics2D/Path2D), которая fontconfig не требует.

- GlyphFont: of/canDisplay/advance/ascent/descent/leading/draw; TTF читается
  напрямую из classpath, не зависит от BundledFonts.init(); битый бандл падает
  IllegalStateException, отсутствующее семейство/начертание -> null
- DrawMlText.fontFor: цепочка фолбэка family/variant -> family/regular ->
  fallback/variant -> fallback/regular (bold у Noto остаётся своим regular)
- BundledFonts: awtFont/AWT_FONTS удалены (чистый cutover), CLASSPATH_DIR ->
  package-private
- ChartRenderer.measureLegend: убран неиспользуемый после cutover параметр g (PMD)
- GlyphFontTest (6 юнитов) без единого java.awt.Font — обязан проходить на хосте
  без fontconfig; Containerfile/AGENTS.md: fontconfig рантайму не нужен

Проверено: mvn clean verify локально (153 теста, PMD); приёмочный стенд —
контейнер без libfontconfig.so и /etc/fonts: mvn verify BUILD SUCCESS и
java -jar + конвертация charts-smartart.docx -> PDF 466 КБ с 4 растрами
(деградации нет).
2026-10-21 19:06:28 +00:00
Pjandro cd7d9f1386 test: юниты спека-параметров (barGapWidthAndOverlapParsed, doughnutHoleSizeParsed, pieFirstSliceAngParsed, chartDefaultsMatchWord) и пиксельные маски (CartesianPainterTest: 0.4·slot/gapWidth=0/overlap=50; PiePainterTest: doughnutHoleMatchesHoleSize, firstSliceAngRotatesStart); эталонные оракулы без правок
PR checks / java (pull_request) Successful in 1m54s
PR checks / web (pull_request) Successful in 1m2s
2026-10-20 22:35:52 +00:00
Pjandro 71a698cc71 docs: провенанс ChartRenderer.PADDING — auto-layout Word 2026-10-20 22:35:52 +00:00
Pjandro d70a5b05de feat: единая камера surface/pie3D — d = sqrt(0.25+0.25·ds²)/tan(θ/2) из c:view3D/perspective вместо CAMERA_DISTANCE=2.36; pie3D переписан на проекцию (обод/стенки/торцы по depth), PIE_DEPTH/PIE_FIT с провенансом Word-эмпирики; плоские PIE/DOUGHNUT исполняют firstSliceAng/holeSize 2026-10-20 22:35:52 +00:00
Pjandro d37fb257b6 feat: бары из формулы ECMA-376 gapWidth/overlap вместо магии 0.82/0.92: barW = slot/(nSer+gap/100), step = barW·(1-overlap/100); провенанс паддингов auto-layout Word 2026-10-20 22:35:52 +00:00
Pjandro 800b6e4b90 feat: ChartSpec читает c:firstSliceAng/holeSize/gapWidth/overlap (ECMA-376, дефолты Word 0/50/150/0); firstSliceAng у PIE3D недоступен в JAXB-модели docx4j 17.3.2 2026-10-20 22:35:52 +00:00
Pjandro 6f57c8a80f feat: валидация контейнера .docx и защита от zip-бомбы в WordPdfValidator.validate
PR checks / java (pull_request) Successful in 1m24s
PR checks / web (pull_request) Successful in 48s
- checkDocxContainer: потоковый проход по zip — декларация wordprocessingml.document
  в [Content_Types].xml (голый zip / переименованный .xlsx → 400, а не 500 на docx4j)
  + лимиты MAX_DECOMPRESSED_MB (200) / MAX_ZIP_ENTRIES (8192) — бомба отсекается
  до readAllBytes в checkPageCount; пороги константные, не ConvertOptions
- регрессии: validate_plainZipRejected/xlsxRenamedRejected/zipBombRejected/
  tooManyEntriesRejected, inputNotDocx_rejectedBeforeRender, plainZipNotDocx_rejected;
  junkInsideValidZip_conversionError — на валидном контейнере с мусором (500)
- прод-автест test_plain_zip_not_docx_rejected; AGENTS.md синхронизирован
2026-10-20 21:14:28 +00:00
Pjandro 1e20949a98 refactor: лимит размера входа во всех слоях — MAX_MB (МБ=MiB), байты вычисляются в checkInput
PR checks / java (pull_request) Successful in 1m7s
PR checks / web (pull_request) Successful in 43s
Ядро: WordPdfSettings.MAX_INPUT_MB=5, ConvertOptions.maxMb,
WordPdfValidator.checkInput(byte[], long maxMb) — единственная точка
пересчёта МБ→байты, сообщение «Файл больше N МБ: X байт > Y байт».
Приложение: свойство wordpdf.max-mb (env WORDPDF_MAX_MB, relaxed binding).
CI/конфиг/автотесты/доки: WORDPDF_MAX_BYTES → WORDPDF_MAX_MB (значение 5).
2026-10-20 20:34:01 +00:00
Pjandro 5f0cabd8e2 fix: устранить все предупреждения PMD (codestyle/unused/LiteralFirstInEquals)
Литерал слева в equals/equalsIgnoreCase (NPE-safe), удаление неиспользуемых
параметров/локальных/импортов/полей, логгеры log→LOG (конвенция UPPER_SNAKE),
UselessParentheses/UnnecessaryCast/UseShortArrayInitializer, record без явного
static, пустой конструктор ChartSpec удалён. Семантика не меняется.
2026-10-19 22:55:16 +00:00
Pjandro 5482bfac60 core: перенос валидации входа из ConversionService в WordPdfValidator.validate 2026-10-19 21:49:34 +00:00
Pjandro 45b78f7fc9 core,app,web: дефолты лимитов входа 5 MiB / 100 страниц 2026-10-19 21:30:45 +00:00
Pjandro f09b629270 core: ValidationException вместо ConversionException; удаление pkg-API и переименование checkPageCountLightweight в checkPageCount 2026-10-19 21:30:45 +00:00
Pjandro 307afc0678 feat: errorOnCharts/errorOnSmartArt — отказ конвертации при находке диаграмм/SmartArt 2026-10-15 22:03:14 +00:00
Pjandro 2af4db90f6 Fix: поддержка strict-OOXML (.docx в ISO 29500 strict)
Word в strict пишет проценты строками (a:shade val="50%",
w14:fillToRect w14:t="130%") и w:start/w:end вместо w:left/w:right —
JAXB-разбор docx4j падает на NumberFormatException (в mc-preprocessor.xslt
ветка % закомментирована, start/end не маппятся). Новый байтовый
StrictOoxmlNormalizer первым в цепочке нормализаторов приводит strict к
transitional-байту; mc-preprocessor доделывает namespaces и pt.

- StrictOoxmlNormalizer: %-атрибуты a:/w14:fillToRect -> тысячные (x1000),
  текст wp14:pctWidth/pctHeight, элементы/атрибуты w:start/w:end ->
  w:left/w:right (кроме w:lvl/w:start в numbering.xml), значения start/end
  у w:jc/w:tab; transitional-документы — no-op (assertSame)
- WordPdfValidator: lightweight-путь читает атрибуты по локальному имени
  (attrLocal) — иначе в strict не засчитываются w:br type="page";
  pageCountOf при провале JAXB-разбора бросает ConversionException вместо NPE
- тесты: StrictOoxmlNormalizerTest (13), регрессии
  strictOoxml_convertsNotRejected (in-memory strict-zip),
  pageCount_strictBreaksCountedLightweight; AGENTS.md обновлён

Реальный develop/openxml.docx: 11 страниц как в эталоне Word, диаграммы
и SmartArt рендерятся. mvn clean verify: core 104 + app 20, BUILD SUCCESS.
2026-10-15 20:52:20 +00:00
Pjandro dfdcb5124d Chore: рабочие материалы и эталоны — в develop/ (вне git); .gitignore без упоминаний локальных артефактов 2026-10-14 17:30:36 +00:00
Pjandro 0a411a944b Ядро: байтовый API, лимиты и опции рисования как параметры
WordPdfConverter/WordPdfValidator: вход и выход только byte[] (файловые
перегрузки убраны). Дефолты лимитов — в WordPdfSettings (20 МиБ/1000
страниц), переопределяются на вызове через ConvertOptions (лимиты,
renderCharts/renderSmartArt); DrawingPreRenderer пропускает выключенные
рисунки ранним continue.
2026-10-14 01:50:25 +00:00
Pjandro 8c390104d2 Замена wordpdf-cli на Spring Boot REST API: wordpdf-app, SPA wordpdf-web, docker-compose 2026-10-13 16:38:18 +00:00
Pjandro aec4dbffe7 Валидатор: лимиты 5 МиБ и 100 страниц, отказ до рендера и без артефактов
- WordPdfValidator (новый): MAX_INPUT_BYTES/MAX_PAGES, три нижние оценки
  страниц (кэш app.xml недостоверен — реальный кейс <Pages>1</Pages> при
  110 маркерах lastRenderedPageBreak); lightweight zip/StAX-путь.
- convert(Path,Path): неполный PDF удаляется при отказе, но только если
  поток вывода реально открылся (чужой read-only файл не стирается);
  checkPageCount внутри try — finally чистит temp-файлы шрифтов.
- lightweight: continuous-секции не считаются страницами; w:type —
  дочерний элемент, классификация на закрытии sectPr; мёртвый
  атрибутный перегруз startsNewPage удалён.
- Фикстуры too-many-pages.docx (151 страница) и stale-cache.docx
  (кэш 1 при 110 маркерах) + регрессии tooManyPages,
  staleCachePageCountRejectedBeforeRender, inputTooLarge,
  oversizedInputReturnsError, pageCount_continuousSectionsNotCountedLightweight.
- SampleDocxGenerator: точный поиск <w:t (не матчить <w:tbl/<w:tc),
  константа STALE_CACHE_UNMARKED_RUNS вместо литерала.
- AGENTS.md переписан; .gitignore += /diff/ и /word-export.*.

mvn clean verify: 95/95; fat-jar проверен java -jar (код 0/2, артефактов нет).
2026-10-13 15:29:23 +00:00
Pjandro ae31f27a27 Экзотические глифы: решётка «#» вместо .notdef
Знак без глифа в шрифте ранa FOP рисовал .notdef — в эталонном
references/word.docx таких оставалось 28.

- Noto Naskh Arabic и Noto Sans Armenian (SIL OFL, 278 КБ) в бандле:
  FontFallback.selectCovering перебирает весь реестр PhysicalFonts и
  находит их сам — арабские дополнения и армянские Unicode 16 рисуются
  без нашего кода.
- GlyphCoverageNormalizer режет ран по покрытию глифов и пишет семейство
  в w:rFonts. Нужен из-за двух дыр docx4j: needsCoverage=false для
  «латинской» группы (римские цифры U+2150–U+218F) и кэш fallbackByScript
  на всю группу Юникода (армянские U+058D/U+058E получали DejaVu Serif).
- FopFallbackFonts.declare декларирует все бандл-семейства: FOP встраивает
  только задекларированные, а font-family в FO может запросить любое.

В эталоне осталось 2 решёток: U+2188 и U+218A есть только в GNU FreeSerif
(GPL-3+ с Font Exception), которого в бандле нет намеренно.
2026-10-05 22:29:10 +00:00
Pjandro 0c10bae3cf docx4j 11.5.3 -> 17.3.0: формулы OMML, колонки и постобработка XSL-FO
17.x приносит WordLayoutFixups (постобработка DOM XSL-FO: columnBreaks,
lineBoxAttributes, stripHints и др.) и jeuclid-fop, поэтому начинают
работать две вещи, которых не было: формулы m:oMath (на стр. 4 эталона
формула молча исчезала) и w:cols/@w:num (две колонки на стр. 9-11).
Сходимость текста references/word.docx с экспортом Word 0,848 -> 0,981,
средний постраничный пиксельный diff 10,5% -> 7,4%.

Что пришлось починить по пути:

* docx4j навешивает на fo:inline fox:gsub-features, не объявляя префикс
  fox. FO становится некорректным XML, WordLayoutFixups не парсит его и
  молча отказывается от всех фикс, а оставленный хинт docx4j-baseline
  отвергает уже FOP. Отключаем генерацию через
  docx4j.convert.out.fo.gsubFeatures=false.

* FOP теперь форк org.docx4j:docx4j-fo-renderer*, и его
  META-INF/services/org.apache.fop.fo.ElementMapping лежит ещё и в
  docx4j-export-fo: в fat-jar без ServicesResourceTransformer второй файл
  перезаписывает первый, FOP не узнаёт namespace fo: и падает на
  UnknownXMLObj. Тесты этого не видят — они идут по classpath.

* addPhysicalFont не перезаписывает занятый ключ реестра: системный
  DejaVuSerif.ttf занимает «dejavu serif» и наш DejaVuSerif-Regular.ttf
  не регистрировался. BundledFonts.init() чистит реестр до регистрации.

* Fop.Renderers.getRenderer() теперь список w:renderer по mime —
  FopFallbackFonts ищет application/pdf.

Em-dash (U+2000-U+2EFF) остался на шрифте ранa, если в нём есть глиф —
так же делает Word (в references/word.pdf em-dash нарисован Calibri/Times,
DejaVu нет вообще), поэтому тест проверяет «вшитый шрифт, не Helvetica»,
а не конкретное семейство.
2026-10-05 21:48:23 +00:00
Pjandro 3ebb4780dd Поля страниц: PAGE/NUMPAGES пересчитываются, а не печатают кэш
Word записывает поле колонтитула как fldChar begin -> instrText "PAGE"
-> separate -> закэшированный результат -> end. Экспорт docx4j в XSL-FO
инструкцию внутри такого поля не видит и печатает кэш из docx: в
references/word.docx на всех страницах было «2» и «11/11».

FieldNormalizer разворачивает поле в w:fldSimple — его обрабатывает
FldSimpleWriter из docx4j-export-fo (PAGE -> fo:page-number, есть также
NUMPAGES/SECTIONPAGES). Закэшированные ран сохраняются внутри поля: они
дают оформление. Штатный FieldsCombiner docx4j делает то же, но не
заходит внутрь w:sdt, а Word держит нумерацию именно в контентном
контроле «Page Numbers (Top of Page)» — отсюда нормализация байтов.

Переписываются только инструкции, для которых есть обработчик; поле без
separate/end и вложенные поля пропускаются.
2026-10-05 21:25:46 +00:00
Pjandro 660bc19da7 Символьные шрифты: Symbol/Wingdings -> Unicode (маркеры списков вместо «#»)
Word задаёт маркеры списков кодами из PUA (U+F0xx), а глиф выбирается по
имени шрифта. Экспорт docx4j в XSL-FO эти шрифты не знает: код уходит в
fallback-семейство, глифа там нет, FOP рисует .notdef — в PDF решётка «#».

SymbolFontNormalizer (шаг перед JAXB, как DocxOnOffNormalizer) меняет код
на Unicode, а имя шрифта — на DejaVu Sans. Таблица кодов — SymbolMapper из
docx4j 17.x, отфильтрована по наличию глифа в DejaVu; совпадение с экспортом
Word сверено по references/word.pdf. Обрабатываются w:lvl (numbering.xml),
w:r и w:sym — ран с w:sym разрезается, т.к. у символа собственный w:font.

В эталонном документе пропали все 19 решёток в маркированных списках
(− • ▪ ❖ ➢ ✓ ♥) и поправились два w:sym.
2026-10-05 21:10:36 +00:00
Pjandro 076975885c Диаграммы и SmartArt: пре-рендер w:drawing в PNG (pie, line, surface3D)
docx2fo.xslt умеет только a:graphicData/pic:pic — для c:chart и dgm:relIds
там notImplemented, т.е. объект молча исчезал из PDF. Новый internal/chart
рендерит их своим Java2D-движком в PNG 300 dpi и подменяет на pic:pic
(шаг 3.5 в convertToStream: после setFontMapper, до FOSettings).

surface3D: седловая ячейка режется диагональю с большей суммой значений
(верхняя огибающая седла). При фиксированной w00–w11 второй треугольник
становится невидимой щепкой, а видимая грань окрашивается не той полосой.
2026-10-05 19:27:38 +00:00
Pjandro 2d446d783c Шрифты: restrictToBundled() чистит реестр PhysicalFonts от системных перед load()
Конструктор BundledFontMapper каждый раз заново обнаруживает системные
шрифты; на Windows найденный Calibri покрывает U+2000-U+2EFF, и
RunFontSelector оставляет em-dash на Carlito вместо fallback-DejaVu
(красный ruPlain_emDashEmbeddedNotHelvetica). Очистка реестра после
init() и до load() делает вывод одинаковым на любой ОС; шрифты,
встроенные в docx, регистрируются при load() и остаются в реестре.
2026-10-02 19:51:24 +00:00
Pjandro 76c251ddd9 docx→PDF конвертер на docx4j + FOP (без LibreOffice/Aspose)
- wordpdf-core: WordPdfConverter, встроенные TTF-шрифты (Carlito/Caladea/
  Arimo/Tinos/Cousine/DejaVu), BundledFontMapper с фолбэком в DejaVu
- нормализация w:val on/off (regular-раны не рендерятся жирным курсивом)
- символы U+2000–U+2EFF (em-dash) встраиваются через DejaVu, а не
  системным неembedded-шрифтом
- wordpdf-cli: fat-jar CLI (один/несколько docx, явный выходной файл)
- тесты (docx4j/FOP/PDFBox/POI), README
2026-09-23 17:54:54 +00:00