From 9f5a003bae5b013dd924b5a2bb5279e6d7e3abb2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=9A=D1=83=D1=80=D0=BD=D0=B0=D1=82=20=D0=90=D0=BD=D0=B4?= =?UTF-8?q?=D1=80=D0=B5=D0=B9?= Date: Mon, 1 Jun 2026 06:53:02 +0300 Subject: [PATCH] Preserve QWord DOCX font size --- README.md | 4 +-- src/io/wordOffice.test.ts | 31 +++++++++++++++++ src/io/wordOffice.ts | 62 ++++++++++++++++++++++++++++++--- src/io/wordOfficeImport.test.ts | 17 +++++++++ 4 files changed, 107 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index c10bb9a..e3c3c0c 100644 --- a/README.md +++ b/README.md @@ -31,7 +31,7 @@ npm run build ## Поддержка форматов -- QWord открывает `.docx` и сохраняет `.docx`; при импорте базовых DOCX-абзацев читает выравнивание, явные цвета текста и подсветку из OOXML, а при экспорте DOCX сохраняются заголовки, абзацы, выравнивание абзацев, списки, простые таблицы, внешние гиперссылки, базовые растровые изображения и базовое inline-форматирование текста: полужирный, курсив, подчеркивание, цвет текста и подсветка. +- QWord открывает `.docx` и сохраняет `.docx`; при импорте базовых DOCX-абзацев читает выравнивание, явные цвета текста, подсветку и размер шрифта из OOXML, а при экспорте DOCX сохраняются заголовки, абзацы, выравнивание абзацев, списки, простые таблицы, внешние гиперссылки, базовые растровые изображения и базовое inline-форматирование текста: полужирный, курсив, подчеркивание, цвет текста, подсветка и размер шрифта. - QExcell открывает `.xlsx` и сохраняет `.xlsx`; сетка расширяется по фактически заполненным ячейкам, поддерживает несколько листов, формулы за пределами стартового диапазона A-H, базовые merged cells, внешние гиперссылки ячеек, базовые диаграммы листа и базовое форматирование ячеек: полужирный, курсив, подчеркивание, цвет текста, заливку, горизонтальное выравнивание и числовые форматы XLSX для дат, процентов, денежных и дробных значений. - QPowerPoint открывает `.pptx` и сохраняет `.pptx`; импорт учитывает порядок слайдов из `presentation.xml`, читает заметки докладчика через relationships слайда, сохраняет базовые растровые изображения слайдов и пользовательский цвет фона слайда. - QOutlook открывает `.eml` и одиночные сообщения Outlook `.msg`, сохраняет письма в `.eml`; импорт EML поддерживает простые текстовые письма, `multipart/alternative`, `multipart/mixed`, `text/plain`, fallback из `text/html` в читаемый текст, base64, quoted-printable, MIME-вложения, `To`, `Cc` и `Bcc`. Импорт MSG читает тему, отправителя, получателей `To/Cc/Bcc`, текст/HTML body и вложения, если эти поля доступны в MSG-файле. Новые письма можно адресовать через `To/Cc/Bcc` и сохранять в EML вместе с добавленными файлами. `.pst` и экспорт в `.msg` пока не реализованы. @@ -46,7 +46,7 @@ Desktop-меню поддерживает системные команды дл - `Ctrl/Cmd+Shift+E`: экспортировать текущую рабочую область в PDF. - `Ctrl/Cmd+P`: печать текущей рабочей области. -Импорт и экспорт реализуют базовую совместимость с Office Open XML, EML и чтением MSG: текст, базовое inline-форматирование, явные `w:color`, `w:shd` и `w:highlight` для цвета/подсветки текста DOCX, выравнивание абзацев DOCX, внешние гиперссылки DOCX/XLSX, базовые растровые изображения DOCX/PPTX, простые таблицы, несколько листов XLSX, ячейки, формулы, базовые merged cells, базовые стили, цвета текста ячеек, горизонтальное выравнивание ячеек, числовые форматы и простые bar/line/pie диаграммы ячеек XLSX, текстовые слайды PPTX, пользовательский фон слайдов PPTX, заметки докладчика, адресацию `To/Cc/Bcc`, MIME-вложения EML и базовые поля одиночных MSG-писем. Сложные стили, макросы, сложные диаграммы, сложное позиционирование и обтекание изображений, PST, экспорт MSG и полная fidelity документов Microsoft Office в текущем инкременте не заявлены. +Импорт и экспорт реализуют базовую совместимость с Office Open XML, EML и чтением MSG: текст, базовое inline-форматирование, явные `w:color`, `w:shd`, `w:highlight` и `w:sz` для цвета/подсветки/размера текста DOCX, выравнивание абзацев DOCX, внешние гиперссылки DOCX/XLSX, базовые растровые изображения DOCX/PPTX, простые таблицы, несколько листов XLSX, ячейки, формулы, базовые merged cells, базовые стили, цвета текста ячеек, горизонтальное выравнивание ячеек, числовые форматы и простые bar/line/pie диаграммы ячеек XLSX, текстовые слайды PPTX, пользовательский фон слайдов PPTX, заметки докладчика, адресацию `To/Cc/Bcc`, MIME-вложения EML и базовые поля одиночных MSG-писем. Сложные стили, макросы, сложные диаграммы, сложное позиционирование и обтекание изображений, PST, экспорт MSG и полная fidelity документов Microsoft Office в текущем инкременте не заявлены. ## Сборка пакета diff --git a/src/io/wordOffice.test.ts b/src/io/wordOffice.test.ts index 483a847..4f09751 100644 --- a/src/io/wordOffice.test.ts +++ b/src/io/wordOffice.test.ts @@ -193,6 +193,37 @@ describe("wordOffice helpers", () => { ]); }); + it("сохраняет размер шрифта из HTML inline-стилей для DOCX", () => { + const blocks = htmlToWordBlocks(` +

Normal Large Pixel size

+ `); + + expect(blocks).toEqual([ + { + type: "paragraph", + text: "Normal Large Pixel size", + runs: [ + { text: "Normal " }, + { text: "Large", fontSize: 18 }, + { text: " " }, + { text: "Pixel size", fontSize: 18 } + ] + } + ]); + }); + + it("преобразует размер шрифта inline runs в half-point значение docx", () => { + expect(wordInlineRunsToTextRunOptions([{ text: "Размер", fontSize: 18 }])).toEqual([{ text: "Размер", size: 36 }]); + }); + + it("записывает размер шрифта в XML экспортированного DOCX", async () => { + const blob = await exportDocxBlob("Размер.docx", '

Крупный текст

'); + const zip = await JSZip.loadAsync(await blob.arrayBuffer()); + const documentXml = await zip.file("word/document.xml")?.async("string"); + + expect(documentXml).toContain('w:sz w:val="36"'); + }); + it("нормализует HTML после импорта DOCX", () => { expect(normalizeImportedDocxHtml("

Готово

\n")).toBe("

Готово

"); }); diff --git a/src/io/wordOffice.ts b/src/io/wordOffice.ts index d80c830..48babad 100644 --- a/src/io/wordOffice.ts +++ b/src/io/wordOffice.ts @@ -13,6 +13,7 @@ export interface WordInlineRun { href?: string; color?: string; highlightColor?: string; + fontSize?: number; } export interface WordListItem { @@ -357,6 +358,10 @@ function wordInlineRunToTextRunOption(run: WordInlineRun) { if (run.highlightColor) { options.shading = { fill: run.highlightColor }; } + const fontSize = normalizedPointSize(run.fontSize); + if (fontSize) { + options.size = Math.round(fontSize * 2); + } return options; } @@ -496,6 +501,25 @@ function cssColorValue(style: string, property: "color" | "background" | "backgr return normalizedCssColor(value); } +function cssFontSizeValue(style: string) { + const raw = /(?:^|;)\s*font-size\s*:\s*([^;]+)/i.exec(style)?.[1]?.trim().toLowerCase() ?? ""; + if (!raw || ["inherit", "initial", "unset", "revert"].includes(raw)) { + return undefined; + } + + const match = /^([0-9]+(?:\.[0-9]+)?)(pt|px)$/i.exec(raw); + if (!match) { + return undefined; + } + + const value = Number.parseFloat(match[1]); + if (!Number.isFinite(value) || value <= 0) { + return undefined; + } + + return normalizedPointSize(match[2].toLowerCase() === "px" ? value * 0.75 : value); +} + function normalizedCssColor(value: string) { const raw = value.trim().toLowerCase(); if (!raw || ["transparent", "inherit", "initial", "currentcolor", "auto"].includes(raw)) { @@ -642,7 +666,8 @@ function docxRunToHtml(run: unknown) { const text = docxRunText(record); const color = docxRunColor(properties); const highlightColor = docxRunHighlightColor(properties); - const hasInlineColorOrHighlight = Boolean(color || highlightColor); + const fontSize = docxRunFontSize(properties); + const hasInlineColorOrHighlight = Boolean(color || highlightColor || fontSize); let html = escapeHtml(text); if (!text) { @@ -661,7 +686,8 @@ function docxRunToHtml(run: unknown) { const styles = [ color ? `color: #${color};` : "", - highlightColor ? `background-color: #${highlightColor};` : "" + highlightColor ? `background-color: #${highlightColor};` : "", + fontSize ? `font-size: ${formatPointSize(fontSize)}pt;` : "" ].filter(Boolean); if (styles.length > 0) { @@ -712,6 +738,15 @@ function docxRunHighlightColor(properties: XmlRecord) { return highlightColors[highlight] ?? ""; } +function docxRunFontSize(properties: XmlRecord) { + const value = Number.parseFloat(docxAttribute(childRecord(properties, "w:sz"), "w:val")); + if (!Number.isFinite(value) || value <= 0) { + return undefined; + } + + return normalizedPointSize(value / 2); +} + function normalizedDocxHexColor(value: string) { const normalized = value.trim().toUpperCase(); if (!normalized || normalized === "AUTO" || normalized === "NONE") { @@ -806,6 +841,7 @@ function formatForElement(element: Element, inherited: InlineFormat): InlineForm const color = cssColorValue(style, "color") || inherited.color; const highlightColor = cssColorValue(style, "background-color") || cssColorValue(style, "background") || inherited.highlightColor; + const fontSize = cssFontSizeValue(style) ?? inherited.fontSize; return cleanInlineFormat({ bold: inherited.bold || tagName === "b" || tagName === "strong" || /font-weight\s*:\s*(bold|[6-9]00)\b/i.test(style), @@ -813,7 +849,8 @@ function formatForElement(element: Element, inherited: InlineFormat): InlineForm underline: inherited.underline || tagName === "u" || /text-decoration(?:-line)?\s*:[^;]*underline/i.test(style), ...(href ? { href } : {}), ...(color ? { color } : {}), - ...(highlightColor ? { highlightColor } : {}) + ...(highlightColor ? { highlightColor } : {}), + ...(fontSize ? { fontSize } : {}) }); } @@ -851,7 +888,8 @@ function sameInlineFormat(first: InlineFormat, second: InlineFormat) { Boolean(first.underline) === Boolean(second.underline) && (first.href ?? "") === (second.href ?? "") && (first.color ?? "") === (second.color ?? "") && - (first.highlightColor ?? "") === (second.highlightColor ?? "") + (first.highlightColor ?? "") === (second.highlightColor ?? "") && + (first.fontSize ?? 0) === (second.fontSize ?? 0) ); } @@ -862,10 +900,24 @@ function cleanInlineFormat(format: InlineFormat): InlineFormat { ...(format.underline ? { underline: true } : {}), ...(format.href ? { href: format.href } : {}), ...(format.color ? { color: format.color } : {}), - ...(format.highlightColor ? { highlightColor: format.highlightColor } : {}) + ...(format.highlightColor ? { highlightColor: format.highlightColor } : {}), + ...(format.fontSize ? { fontSize: format.fontSize } : {}) }; } +function normalizedPointSize(value: unknown) { + const numeric = typeof value === "number" ? value : Number.parseFloat(String(value ?? "")); + if (!Number.isFinite(numeric) || numeric <= 0) { + return undefined; + } + + return Math.round(numeric * 2) / 2; +} + +function formatPointSize(value: number) { + return Number.isInteger(value) ? String(value) : value.toFixed(1); +} + function normalizedHyperlinkTarget(value?: string | null) { const raw = value?.trim(); if (!raw) { diff --git a/src/io/wordOfficeImport.test.ts b/src/io/wordOfficeImport.test.ts index 2e429ba..53f3c65 100644 --- a/src/io/wordOfficeImport.test.ts +++ b/src/io/wordOfficeImport.test.ts @@ -40,4 +40,21 @@ describe("wordOffice DOCX import", () => { { type: "paragraph", text: "Justified", runs: [{ text: "Justified" }], alignment: "both" } ]); }); + + it("imports DOCX font size from OOXML", async () => { + const blob = await exportDocxBlob("FontSize.docx", '

Large text

'); + const file = new File([blob], "FontSize.docx", { + type: "application/vnd.openxmlformats-officedocument.wordprocessingml.document" + }); + const imported = await importDocxFile(file); + + expect(imported.html).toContain("font-size: 18pt;"); + expect(htmlToWordBlocks(imported.html)).toEqual([ + { + type: "paragraph", + text: "Large text", + runs: [{ text: "Large text", fontSize: 18 }] + } + ]); + }); });