Preserve QWord DOCX font size

2026-06-01 06:53:02 +03:00
parent 024f208538
commit 9f5a003bae
4 changed files with 107 additions and 7 deletions
@@ -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 в текущем инкременте не заявлены.

 ## Сборка пакета

@@ -193,6 +193,37 @@ describe("wordOffice helpers", () => {
    ]);
  });

+  it("сохраняет размер шрифта из HTML inline-стилей для DOCX", () => {
+    const blocks = htmlToWordBlocks(`
+      <p>Normal <span style="font-size: 18pt;">Large</span> <span style="font-size: 24px;">Pixel size</span></p>
+    `);
+
+    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", '<p><span style="font-size: 18pt;">Крупный текст</span></p>');
+    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("  <p>Готово</p>\n")).toBe("<p>Готово</p>");
  });
@@ -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) {
@@ -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", '<p><span style="font-size: 18pt;">Large text</span></p>');
+    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 }]
+      }
+    ]);
+  });
 });