Preserve QWord paragraph spacing in DOCX

README.md

@@ -44,7 +44,7 @@ npm run build
 
 ## Поддержка форматов
 
-- QWord открывает `.docx` и сохраняет `.docx`; при импорте базовых DOCX-абзацев читает заголовки Word `Heading 1`–`Heading 6`, стиль Word `Quote` как HTML `blockquote`, выравнивание, отступы `w:ind`, переносы строк, разрывы страниц, табуляцию, закладки, внешние и внутренние гиперссылки-якоря, маркированные и нумерованные списки через `w:numPr`/`numbering.xml`, простые таблицы, базовые растровые изображения, явные цвета текста, подсветку, размер и семейство шрифта из OOXML, нижний и верхний индекс через `w:vertAlign`, а при экспорте DOCX сохраняются заголовки HTML `h1`–`h6`, цитаты HTML `blockquote` как стиль Word `Quote`, абзацы, переносы строк, разрывы страниц, табуляция, выравнивание и отступы абзацев из HTML `margin-left`/`text-indent`, закладки из HTML `id`, списки, простые таблицы, внешние и внутренние гиперссылки-якоря, базовые растровые изображения и базовое inline-форматирование текста: полужирный, курсив, подчеркивание, зачеркивание, нижний и верхний индекс, цвет текста, подсветка, размер и семейство шрифта.
+- QWord открывает `.docx` и сохраняет `.docx`; при импорте базовых DOCX-абзацев читает заголовки Word `Heading 1`–`Heading 6`, стиль Word `Quote` как HTML `blockquote`, выравнивание, отступы `w:ind`, интервалы абзацев `w:spacing` `before`/`after`, переносы строк, разрывы страниц, табуляцию, закладки, внешние и внутренние гиперссылки-якоря, маркированные и нумерованные списки через `w:numPr`/`numbering.xml`, простые таблицы, базовые растровые изображения, явные цвета текста, подсветку, размер и семейство шрифта из OOXML, нижний и верхний индекс через `w:vertAlign`, а при экспорте DOCX сохраняются заголовки HTML `h1`–`h6`, цитаты HTML `blockquote` как стиль Word `Quote`, абзацы, переносы строк, разрывы страниц, табуляция, выравнивание, отступы абзацев из HTML `margin-left`/`text-indent` и интервалы из HTML `margin-top`/`margin-bottom`, закладки из HTML `id`, списки, простые таблицы, внешние и внутренние гиперссылки-якоря, базовые растровые изображения и базовое inline-форматирование текста: полужирный, курсив, подчеркивание, зачеркивание, нижний и верхний индекс, цвет текста, подсветка, размер и семейство шрифта.
 - QExcell открывает `.xlsx` и сохраняет `.xlsx`; сетка расширяется по фактически заполненным ячейкам, поддерживает несколько листов, скрытые и veryHidden листы через `sheet state`, закрепленные области через `sheetViews pane`, скрытие сетки через `sheetView showGridLines`, масштаб листа через `sheetView zoomScale`, автофильтр через `autoFilter ref`, область печати через `_xlnm.Print_Area`, цвет вкладки листа через `sheetPr tabColor`, ширину и скрытие колонок через `cols/col width` и `col hidden`, высоту и скрытие строк через `row ht/customHeight` и `row hidden`, управление скрытием выбранной строки и столбца в интерфейсе, активный лист через `workbookView activeTab`, формулы за пределами стартового диапазона A-H, shared formulas XLSX с относительными ссылками, базовые merged cells, внешние и внутренние гиперссылки ячеек, legacy-заметки ячеек через `comments.xml` и VML `legacyDrawing`, базовые диаграммы листа и базовое форматирование ячеек: полужирный, курсив, подчеркивание, зачеркивание, размер и семейство шрифта, прямые RGB/theme/indexed цвета текста с учетом `xl/theme/theme1.xml`, заливку, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы XLSX для дат, процентов, денежных и дробных значений.
 - QPowerPoint открывает `.pptx` и сохраняет `.pptx`; импорт учитывает порядок слайдов из `presentation.xml`, переносы абзацев и ручные переносы строк `a:br` внутри текстовых блоков, маркированные и нумерованные списки подзаголовка через `a:buChar`/`a:buAutoNum`, внешние ссылки текста заголовка/подзаголовка и изображений через `a:hlinkClick` и hyperlink relationships, скрытые слайды через атрибут `show`, переходы `p:transition` для `fade`/`push`/`wipe`, а также заметки докладчика через relationships слайда, сохраняет скрытые слайды, переходы слайдов, заметки докладчика, внешние ссылки текста заголовка/подзаголовка и изображений, базовые растровые изображения слайдов, пользовательский цвет фона слайда, списки подзаголовка, а также цвет, размер, семейство шрифта, начертание `b`/`i`/`u`/`strike` и выравнивание `a:pPr algn` текста заголовка/подзаголовка.
 - QOutlook открывает `.eml` и одиночные сообщения Outlook `.msg`, сохраняет письма в `.eml`; импорт EML поддерживает простые текстовые письма, `multipart/alternative`, `multipart/mixed`, `multipart/related`, `text/plain`, fallback из `text/html` в читаемый текст, base64, quoted-printable, MIME encoded-word заголовки UTF-8/windows-1251, MIME-вложения и inline-вложения с `Content-ID`, `To`, `Cc`, `Bcc`, `Reply-To`, `Message-ID`, `In-Reply-To`, `References`, `Importance`, `X-Priority` и `Priority`. Импорт MSG читает тему, отправителя, получателей `To/Cc/Bcc`, `Reply-To`, `Message-ID`, `In-Reply-To`, `References`, `Importance`, `X-Priority` и `Priority` из транспортных заголовков, текст/HTML body и вложения, если эти поля доступны в MSG-файле. Новые письма можно адресовать через `To/Cc/Bcc`, задавать `Reply-To` и сохранять в EML вместе с добавленными файлами. `.pst` и экспорт в `.msg` пока не реализованы.
@@ -60,7 +60,7 @@ Desktop-меню поддерживает системные команды дл
 - `Ctrl/Cmd+Shift+E`: экспортировать текущую рабочую область в PDF.
 - `Ctrl/Cmd+P`: печать текущей рабочей области.
 
-Импорт и экспорт реализуют базовую совместимость с Office Open XML, EML и чтением MSG: текст, базовое inline-форматирование, явные `w:br`, `w:br w:type="page"`, `w:tab`, `w:color`, `w:shd`, `w:highlight`, `w:sz`, `w:rFonts`, `w:strike` и `w:vertAlign` для переносов строк/разрывов страниц/табуляции/цвета/подсветки/размера/семейства/зачеркивания/нижнего и верхнего индекса текста DOCX, выравнивание и отступы абзацев DOCX через `w:jc`/`w:ind`, закладки DOCX через `w:bookmarkStart`/`w:bookmarkEnd`, внешние `w:hyperlink r:id` и внутренние `w:hyperlink w:anchor` гиперссылки DOCX, маркированные и нумерованные списки DOCX через `w:numPr` и `numbering.xml`, внешние и внутренние гиперссылки XLSX, legacy-заметки ячеек XLSX через `comments.xml`, relationship `comments`, VML `vmlDrawing` и `legacyDrawing`, базовые растровые изображения DOCX/PPTX, простые таблицы, несколько листов, скрытые/veryHidden листы через `sheet state`, закрепленные области через `sheetViews pane`, скрытие сетки через `sheetView showGridLines`, масштаб листа через `sheetView zoomScale`, автофильтр через `autoFilter ref`, область печати XLSX через `_xlnm.Print_Area`, цвет вкладки листа через `sheetPr tabColor`, ширину и скрытие колонок через `cols/col width`/`col hidden`, высоту и скрытие строк через `row ht/customHeight`/`row hidden` и активный лист XLSX через `workbookView activeTab`, ячейки, формулы, shared formulas XLSX с относительными ссылками, базовые merged cells, базовые стили, RGB/theme/indexed цвета XLSX с учетом `xl/theme/theme1.xml`, размеры и семейства шрифта, зачеркивание ячеек, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы и простые bar/line/pie диаграммы ячеек XLSX, текстовые слайды PPTX с переносами абзацев и ручными переносами строк `a:br` при импорте, внешние ссылки текста заголовка/подзаголовка и изображений PPTX через `a:hlinkClick` и hyperlink relationships, скрытые слайды PPTX через атрибут `show`, переходы PPTX через `p:transition` для `fade`/`push`/`wipe`, пользовательский фон слайдов PPTX, цвет, размер, семейство шрифта, начертание `b`/`i`/`u`/`strike` и выравнивание `a:pPr algn` текста заголовка/подзаголовка PPTX, импорт и экспорт заметок докладчика, адресацию `To/Cc/Bcc/Reply-To`, заголовки цепочки писем `Message-ID`/`In-Reply-To`/`References`, заголовки приоритета `Importance`/`X-Priority`/`Priority`, MIME encoded-word заголовки UTF-8/windows-1251, MIME-вложения EML, inline-вложения EML с `Content-ID` и базовые поля одиночных MSG-писем. Сложные стили, макросы, сложные диаграммы, сложное позиционирование и обтекание изображений, PST, экспорт MSG и полная fidelity документов Microsoft Office в текущем инкременте не заявлены.
+Импорт и экспорт реализуют базовую совместимость с Office Open XML, EML и чтением MSG: текст, базовое inline-форматирование, явные `w:br`, `w:br w:type="page"`, `w:tab`, `w:color`, `w:shd`, `w:highlight`, `w:sz`, `w:rFonts`, `w:strike` и `w:vertAlign` для переносов строк/разрывов страниц/табуляции/цвета/подсветки/размера/семейства/зачеркивания/нижнего и верхнего индекса текста DOCX, выравнивание, отступы и интервалы абзацев DOCX через `w:jc`/`w:ind`/`w:spacing`, закладки DOCX через `w:bookmarkStart`/`w:bookmarkEnd`, внешние `w:hyperlink r:id` и внутренние `w:hyperlink w:anchor` гиперссылки DOCX, маркированные и нумерованные списки DOCX через `w:numPr` и `numbering.xml`, внешние и внутренние гиперссылки XLSX, legacy-заметки ячеек XLSX через `comments.xml`, relationship `comments`, VML `vmlDrawing` и `legacyDrawing`, базовые растровые изображения DOCX/PPTX, простые таблицы, несколько листов, скрытые/veryHidden листы через `sheet state`, закрепленные области через `sheetViews pane`, скрытие сетки через `sheetView showGridLines`, масштаб листа через `sheetView zoomScale`, автофильтр через `autoFilter ref`, область печати XLSX через `_xlnm.Print_Area`, цвет вкладки листа через `sheetPr tabColor`, ширину и скрытие колонок через `cols/col width`/`col hidden`, высоту и скрытие строк через `row ht/customHeight`/`row hidden` и активный лист XLSX через `workbookView activeTab`, ячейки, формулы, shared formulas XLSX с относительными ссылками, базовые merged cells, базовые стили, RGB/theme/indexed цвета XLSX с учетом `xl/theme/theme1.xml`, размеры и семейства шрифта, зачеркивание ячеек, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы и простые bar/line/pie диаграммы ячеек XLSX, текстовые слайды PPTX с переносами абзацев и ручными переносами строк `a:br` при импорте, внешние ссылки текста заголовка/подзаголовка и изображений PPTX через `a:hlinkClick` и hyperlink relationships, скрытые слайды PPTX через атрибут `show`, переходы PPTX через `p:transition` для `fade`/`push`/`wipe`, пользовательский фон слайдов PPTX, цвет, размер, семейство шрифта, начертание `b`/`i`/`u`/`strike` и выравнивание `a:pPr algn` текста заголовка/подзаголовка PPTX, импорт и экспорт заметок докладчика, адресацию `To/Cc/Bcc/Reply-To`, заголовки цепочки писем `Message-ID`/`In-Reply-To`/`References`, заголовки приоритета `Importance`/`X-Priority`/`Priority`, MIME encoded-word заголовки UTF-8/windows-1251, MIME-вложения EML, inline-вложения EML с `Content-ID` и базовые поля одиночных MSG-писем. Сложные стили, макросы, сложные диаграммы, сложное позиционирование и обтекание изображений, PST, экспорт MSG и полная fidelity документов Microsoft Office в текущем инкременте не заявлены.
 
 Для QOutlook EML round-trip дополнительно покрывает HTML body через `multipart/alternative` без вложений и с вложениями внутри `multipart/mixed`.
 

src/io/wordOffice.test.ts

@@ -465,6 +465,18 @@ describe("wordOffice helpers", () => {
     ]);
   });
 
+  it("сохраняет HTML-интервалы абзацев и заголовков для DOCX", () => {
+    const blocks = htmlToWordBlocks(`
+      <h2 style="margin-top: 6pt; margin-bottom: 10pt;">Title spacing</h2>
+      <p style="margin-top: 12pt; margin-bottom: 18pt;">Paragraph spacing</p>
+    `);
+
+    expect(blocks).toEqual([
+      { type: "heading", level: 2, text: "Title spacing", runs: [{ text: "Title spacing" }], spacing: { before: 120, after: 200 } },
+      { type: "paragraph", text: "Paragraph spacing", runs: [{ text: "Paragraph spacing" }], spacing: { before: 240, after: 360 } }
+    ]);
+  });
+
   it("записывает отступы абзацев в w:ind экспортированного DOCX", async () => {
     const blob = await exportDocxBlob(
       "Indent.docx",
@@ -477,6 +489,18 @@ describe("wordOffice helpers", () => {
     expect(documentXml).toMatch(/<w:ind\b(?=[^>]*w:left="720")(?=[^>]*w:hanging="240")[^>]*\/>/);
   });
 
+  it("записывает интервалы абзацев в w:spacing экспортированного DOCX", async () => {
+    const blob = await exportDocxBlob(
+      "Spacing.docx",
+      '<h2 style="margin-top: 6pt; margin-bottom: 10pt;">Title spacing</h2><p style="margin-top: 12pt; margin-bottom: 18pt;">Paragraph spacing</p>'
+    );
+    const zip = await JSZip.loadAsync(await blob.arrayBuffer());
+    const documentXml = await zip.file("word/document.xml")?.async("string");
+
+    expect(documentXml).toMatch(/<w:spacing\b(?=[^>]*w:before="120")(?=[^>]*w:after="200")[^>]*\/>/);
+    expect(documentXml).toMatch(/<w:spacing\b(?=[^>]*w:before="240")(?=[^>]*w:after="360")[^>]*\/>/);
+  });
+
   it("нормализует HTML после импорта DOCX", () => {
     expect(normalizeImportedDocxHtml("  <p>Готово</p>\n")).toBe("<p>Готово</p>");
   });

src/io/wordOffice.ts

@@ -41,11 +41,34 @@ export interface WordParagraphIndent {
   hanging?: number;
 }
 
+export interface WordParagraphSpacing {
+  before?: number;
+  after?: number;
+}
+
 export type WordHeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
 
 export type WordBlock =
-  | { type: "heading"; level: WordHeadingLevel; text: string; runs: WordInlineRun[]; alignment?: WordParagraphAlignment; indent?: WordParagraphIndent; bookmark?: string }
+  | {
-  | { type: "paragraph"; text: string; runs: WordInlineRun[]; alignment?: WordParagraphAlignment; indent?: WordParagraphIndent; bookmark?: string; quote?: boolean }
+      type: "heading";
+      level: WordHeadingLevel;
+      text: string;
+      runs: WordInlineRun[];
+      alignment?: WordParagraphAlignment;
+      indent?: WordParagraphIndent;
+      spacing?: WordParagraphSpacing;
+      bookmark?: string;
+    }
+  | {
+      type: "paragraph";
+      text: string;
+      runs: WordInlineRun[];
+      alignment?: WordParagraphAlignment;
+      indent?: WordParagraphIndent;
+      spacing?: WordParagraphSpacing;
+      bookmark?: string;
+      quote?: boolean;
+    }
   | { type: "list"; ordered: boolean; items: WordListItem[] }
   | { type: "table"; rows: string[][] }
   | WordImageBlock;
@@ -104,6 +127,8 @@ type DocxModule = {
   ImageRun?: new (options: Record<string, unknown>) => unknown;
 };
 
+const defaultParagraphSpacingAfterTwips = 160;
+
 type InlineFormat = Omit<WordInlineRun, "text">;
 type InlineSegment = { type: "runs"; runs: WordInlineRun[] } | { type: "image"; image: WordImageBlock };
 type DocxInlineRecord = { run: unknown; text: string; href?: string };
@@ -251,6 +276,7 @@ export function htmlToWordBlocks(html: string): WordBlock[] {
       const text = inlineRunsText(runs);
       const alignment = paragraphAlignmentFromElement(node);
       const indent = paragraphIndentFromElement(node);
+      const spacing = paragraphSpacingFromElement(node);
       const bookmark = bookmarkFromElement(node);
       if (text) {
         blocks.push({
@@ -260,6 +286,7 @@ export function htmlToWordBlocks(html: string): WordBlock[] {
           runs,
           ...(alignment ? { alignment } : {}),
           ...(indent ? { indent } : {}),
+          ...(spacing ? { spacing } : {}),
           ...(bookmark ? { bookmark } : {})
         });
       }
@@ -308,7 +335,7 @@ function wordBlockToDocxChildren(block: WordBlock, docx: DocxModule) {
     return [
       new docx.Paragraph({
         heading: docxHeadingLevel(block.level, docx),
-        spacing: { after: 160 },
+        spacing: docxParagraphSpacing(block.spacing, defaultParagraphSpacingAfterTwips),
         ...docxAlignmentOption(block.alignment, docx),
         ...docxIndentOption(block.indent),
         children: bookmarkDocxChildren(block.bookmark, children, docx)
@@ -321,7 +348,7 @@ function wordBlockToDocxChildren(block: WordBlock, docx: DocxModule) {
     return [
       new docx.Paragraph({
         ...(block.quote ? { style: "Quote" } : {}),
-        spacing: { after: 160 },
+        spacing: docxParagraphSpacing(block.spacing, defaultParagraphSpacingAfterTwips),
         ...docxAlignmentOption(block.alignment, docx),
         ...docxIndentOption(block.indent),
         children: bookmarkDocxChildren(block.bookmark, children, docx)
@@ -525,6 +552,23 @@ function docxIndentOption(indent: WordParagraphIndent | undefined) {
   return Object.keys(normalized).length > 0 ? { indent: normalized } : {};
 }
 
+function docxParagraphSpacing(spacing: WordParagraphSpacing | undefined, defaultAfter: number) {
+  const normalized = normalizedParagraphSpacing(spacing);
+  return {
+    after: normalized.after ?? defaultAfter,
+    ...(normalized.before ? { before: normalized.before } : {})
+  };
+}
+
+function normalizedParagraphSpacing(spacing: WordParagraphSpacing | undefined) {
+  const before = normalizedTwips(spacing?.before);
+  const after = normalizedTwips(spacing?.after);
+  return {
+    ...(before ? { before } : {}),
+    ...(after !== undefined ? { after } : {})
+  };
+}
+
 function normalizedParagraphIndent(indent: WordParagraphIndent | undefined) {
   const left = normalizedTwips(indent?.left);
   const firstLine = normalizedTwips(indent?.firstLine);
@@ -602,6 +646,7 @@ function paragraphElementToBlocks(element: Element, options: { quote?: boolean }
   const segments = collectInlineSegments(Array.from(element.childNodes), {});
   const alignment = paragraphAlignmentFromElement(element);
   const indent = paragraphIndentFromElement(element);
+  const spacing = paragraphSpacingFromElement(element);
   const bookmark = bookmarkFromElement(element);
   const blocks: WordBlock[] = [];
   let pendingRuns: WordInlineRun[] = [];
@@ -618,6 +663,7 @@ function paragraphElementToBlocks(element: Element, options: { quote?: boolean }
         runs,
         ...(alignment ? { alignment } : {}),
         ...(indent ? { indent } : {}),
+        ...(spacing ? { spacing } : {}),
         ...(bookmark && !bookmarkApplied ? { bookmark } : {}),
         ...(options.quote ? { quote: true } : {})
       });
@@ -666,6 +712,17 @@ function paragraphIndentFromElement(element: Element): WordParagraphIndent | und
   return Object.keys(indent).length > 0 ? indent : undefined;
 }
 
+function paragraphSpacingFromElement(element: Element): WordParagraphSpacing | undefined {
+  const style = element.getAttribute("style") ?? "";
+  const before = cssTwipsValue(style, "margin-top");
+  const after = cssTwipsValue(style, "margin-bottom");
+  const spacing = {
+    ...(before && before > 0 ? { before } : {}),
+    ...(after && after > 0 ? { after } : {})
+  };
+  return Object.keys(spacing).length > 0 ? spacing : undefined;
+}
+
 function bookmarkFromElement(element: Element) {
   return normalizedDocxAnchor(element.getAttribute("id") || element.getAttribute("name"));
 }
@@ -674,7 +731,7 @@ function cssTextAlignValue(style: string) {
   return /(?:^|;)\s*text-align\s*:\s*([^;]+)/i.exec(style)?.[1] ?? "";
 }
 
-function cssTwipsValue(style: string, property: "margin-left" | "text-indent") {
+function cssTwipsValue(style: string, property: "margin-left" | "margin-top" | "margin-bottom" | "text-indent") {
   const raw = new RegExp(`(?:^|;)\\s*${property}\\s*:\\s*([^;]+)`, "i").exec(style)?.[1]?.trim().toLowerCase() ?? "";
   return cssLengthToTwips(raw);
 }
@@ -1069,7 +1126,8 @@ function docxParagraphStyleAttribute(properties: XmlRecord) {
   const htmlAlignment = alignment === "both" ? "justify" : alignment;
   const styles = [
     ["left", "center", "right", "justify"].includes(htmlAlignment) ? `text-align: ${htmlAlignment};` : "",
-    ...docxParagraphIndentStyles(properties)
+    ...docxParagraphIndentStyles(properties),
+    ...docxParagraphSpacingStyles(properties)
   ].filter(Boolean);
   return styles.join(" ");
 }
@@ -1086,6 +1144,16 @@ function docxParagraphIndentStyles(properties: XmlRecord) {
   ].filter(Boolean);
 }
 
+function docxParagraphSpacingStyles(properties: XmlRecord) {
+  const spacing = childRecord(properties, "w:spacing");
+  const before = docxTwipsAttribute(spacing, ["w:before"]);
+  const after = docxTwipsAttribute(spacing, ["w:after"]);
+  return [
+    before ? `margin-top: ${formatPointSize(before / 20)}pt;` : "",
+    after && after !== defaultParagraphSpacingAfterTwips ? `margin-bottom: ${formatPointSize(after / 20)}pt;` : ""
+  ].filter(Boolean);
+}
+
 function docxParagraphListInfo(properties: XmlRecord, numberingDefinitions: DocxNumberingDefinitions): DocxListInfo | undefined {
   const numbering = childRecord(properties, "w:numPr");
   const numId = docxAttribute(childRecord(numbering, "w:numId"), "w:val");

src/io/wordOfficeImport.test.ts

@@ -363,4 +363,22 @@ describe("wordOffice DOCX import", () => {
       { type: "paragraph", text: "Hanging", runs: [{ text: "Hanging" }], indent: { left: 720, hanging: 240 } }
     ]);
   });
+
+  it("imports DOCX paragraph spacing from OOXML", async () => {
+    const blob = await exportDocxBlob(
+      "Spacing.docx",
+      '<h2 style="margin-top: 6pt; margin-bottom: 10pt;">Title spacing</h2><p style="margin-top: 12pt; margin-bottom: 18pt;">Paragraph spacing</p>'
+    );
+    const file = new File([blob], "Spacing.docx", {
+      type: "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
+    });
+    const imported = await importDocxFile(file);
+
+    expect(imported.html).toContain("margin-top: 6pt; margin-bottom: 10pt;");
+    expect(imported.html).toContain("margin-top: 12pt; margin-bottom: 18pt;");
+    expect(htmlToWordBlocks(imported.html)).toEqual([
+      { type: "heading", level: 2, text: "Title spacing", runs: [{ text: "Title spacing" }], spacing: { before: 120, after: 200 } },
+      { type: "paragraph", text: "Paragraph spacing", runs: [{ text: "Paragraph spacing" }], spacing: { before: 240, after: 360 } }
+    ]);
+  });
 });