Preserve QPowerPoint manual line breaks

README.md

@@ -33,7 +33,7 @@ npm run build
 
 - QWord открывает `.docx` и сохраняет `.docx`; при импорте базовых DOCX-абзацев читает выравнивание, переносы строк, внешние гиперссылки, простые таблицы, базовые растровые изображения, явные цвета текста, подсветку, размер и семейство шрифта из OOXML, а при экспорте DOCX сохраняются заголовки, абзацы, переносы строк, выравнивание абзацев, списки, простые таблицы, внешние гиперссылки, базовые растровые изображения и базовое inline-форматирование текста: полужирный, курсив, подчеркивание, зачеркивание, цвет текста, подсветка, размер и семейство шрифта.
 - QExcell открывает `.xlsx` и сохраняет `.xlsx`; сетка расширяется по фактически заполненным ячейкам, поддерживает несколько листов, формулы за пределами стартового диапазона A-H, shared formulas XLSX с относительными ссылками, базовые merged cells, внешние и внутренние гиперссылки ячеек, базовые диаграммы листа и базовое форматирование ячеек: полужирный, курсив, подчеркивание, зачеркивание, размер и семейство шрифта, прямые RGB/theme/indexed цвета текста с учетом `xl/theme/theme1.xml`, заливку, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы XLSX для дат, процентов, денежных и дробных значений.
-- QPowerPoint открывает `.pptx` и сохраняет `.pptx`; импорт учитывает порядок слайдов из `presentation.xml`, переносы абзацев внутри текстовых блоков и заметки докладчика через relationships слайда, сохраняет заметки докладчика, базовые растровые изображения слайдов, пользовательский цвет фона слайда, а также цвет, размер и семейство шрифта текста заголовка/подзаголовка.
+- QPowerPoint открывает `.pptx` и сохраняет `.pptx`; импорт учитывает порядок слайдов из `presentation.xml`, переносы абзацев и ручные переносы строк `a:br` внутри текстовых блоков, а также заметки докладчика через relationships слайда, сохраняет заметки докладчика, базовые растровые изображения слайдов, пользовательский цвет фона слайда, а также цвет, размер и семейство шрифта текста заголовка/подзаголовка.
 - 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`. Импорт MSG читает тему, отправителя, получателей `To/Cc/Bcc`, текст/HTML body и вложения, если эти поля доступны в MSG-файле. Новые письма можно адресовать через `To/Cc/Bcc` и сохранять в EML вместе с добавленными файлами. `.pst` и экспорт в `.msg` пока не реализованы.
 
 В desktop-режиме Electron используются системные диалоги открытия и сохранения файлов. В web-режиме остаются браузерный выбор файла и скачивание результата.
@@ -46,7 +46,7 @@ Desktop-меню поддерживает системные команды дл
 - `Ctrl/Cmd+Shift+E`: экспортировать текущую рабочую область в PDF.
 - `Ctrl/Cmd+P`: печать текущей рабочей области.
 
-Импорт и экспорт реализуют базовую совместимость с Office Open XML, EML и чтением MSG: текст, базовое inline-форматирование, явные `w:br`, `w:color`, `w:shd`, `w:highlight`, `w:sz`, `w:rFonts` и `w:strike` для переносов строк/цвета/подсветки/размера/семейства/зачеркивания текста DOCX, выравнивание абзацев DOCX, внешние гиперссылки DOCX, внешние и внутренние гиперссылки XLSX, базовые растровые изображения DOCX/PPTX, простые таблицы, несколько листов XLSX, ячейки, формулы, shared formulas XLSX с относительными ссылками, базовые merged cells, базовые стили, RGB/theme/indexed цвета XLSX с учетом `xl/theme/theme1.xml`, размеры и семейства шрифта, зачеркивание ячеек, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы и простые bar/line/pie диаграммы ячеек XLSX, текстовые слайды PPTX с переносами абзацев при импорте, пользовательский фон слайдов PPTX, цвет, размер и семейство шрифта текста заголовка/подзаголовка PPTX, импорт и экспорт заметок докладчика, адресацию `To/Cc/Bcc`, 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:color`, `w:shd`, `w:highlight`, `w:sz`, `w:rFonts` и `w:strike` для переносов строк/цвета/подсветки/размера/семейства/зачеркивания текста DOCX, выравнивание абзацев DOCX, внешние гиперссылки DOCX, внешние и внутренние гиперссылки XLSX, базовые растровые изображения DOCX/PPTX, простые таблицы, несколько листов XLSX, ячейки, формулы, shared formulas XLSX с относительными ссылками, базовые merged cells, базовые стили, RGB/theme/indexed цвета XLSX с учетом `xl/theme/theme1.xml`, размеры и семейства шрифта, зачеркивание ячеек, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы и простые bar/line/pie диаграммы ячеек XLSX, текстовые слайды PPTX с переносами абзацев и ручными переносами строк `a:br` при импорте, пользовательский фон слайдов PPTX, цвет, размер и семейство шрифта текста заголовка/подзаголовка PPTX, импорт и экспорт заметок докладчика, адресацию `To/Cc/Bcc`, MIME encoded-word заголовки UTF-8/windows-1251, MIME-вложения EML, inline-вложения EML с `Content-ID` и базовые поля одиночных MSG-писем. Сложные стили, макросы, сложные диаграммы, сложное позиционирование и обтекание изображений, PST, экспорт MSG и полная fidelity документов Microsoft Office в текущем инкременте не заявлены.
 
 ## Сборка пакета
 

src/io/powerPointOffice.test.ts

@@ -151,6 +151,28 @@ describe("powerPointOffice helpers", () => {
     expect(imported.slides[0].subtitle).toBe("Plan\nBuild\nShip");
   });
 
+  it("сохраняет ручные переносы строк a:br внутри абзаца PPTX при импорте", async () => {
+    const zip = new JSZip();
+    zip.file(
+      "ppt/presentation.xml",
+      `<p:presentation xmlns:p="http://schemas.openxmlformats.org/presentationml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships"><p:sldIdLst><p:sldId id="256" r:id="rId1"/></p:sldIdLst></p:presentation>`
+    );
+    zip.file(
+      "ppt/_rels/presentation.xml.rels",
+      `<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships"><Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/slide" Target="slides/slide1.xml"/></Relationships>`
+    );
+    zip.file("ppt/slides/slide1.xml", slideXmlWithManualBreakSubtitle("Roadmap", ["Plan", "Build", "Ship"]));
+
+    const blob = await zip.generateAsync({
+      type: "blob",
+      mimeType: "application/vnd.openxmlformats-officedocument.presentationml.presentation"
+    });
+    const imported = await importPptxFile(new File([blob], "Roadmap.pptx", { type: blob.type }));
+
+    expect(imported.slides[0].title).toBe("Roadmap");
+    expect(imported.slides[0].subtitle).toBe("Plan\nBuild\nShip");
+  });
+
   it("импортирует изображения слайда из PPTX media relationships", async () => {
     const zip = new JSZip();
     zip.file(
@@ -368,6 +390,12 @@ function slideXmlWithMultilineSubtitle(title: string, subtitleParagraphs: string
     .join("")}</p:txBody></p:sp></p:spTree></p:cSld></p:sld>`;
 }
 
+function slideXmlWithManualBreakSubtitle(title: string, subtitleLines: string[]) {
+  return `<p:sld xmlns:p="http://schemas.openxmlformats.org/presentationml/2006/main" xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"><p:cSld><p:spTree><p:sp><p:txBody><a:p><a:r><a:t>${title}</a:t></a:r></a:p></p:txBody></p:sp><p:sp><p:txBody><a:p>${subtitleLines
+    .map((text, index) => `${index > 0 ? "<a:br/>" : ""}<a:r><a:t>${text}</a:t></a:r>`)
+    .join("")}</a:p></p:txBody></p:sp></p:spTree></p:cSld></p:sld>`;
+}
+
 function slideXmlWithPicture(title: string) {
   return `<p:sld xmlns:p="http://schemas.openxmlformats.org/presentationml/2006/main" xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships"><p:cSld><p:spTree><p:sp><p:txBody><a:p><a:r><a:t>${title}</a:t></a:r></a:p></p:txBody></p:sp><p:pic><p:nvPicPr><p:cNvPr id="4" name="Picture 1" descr="Логотип"/></p:nvPicPr><p:blipFill><a:blip r:embed="rIdImage"/></p:blipFill><p:spPr><a:xfrm><a:off x="914400" y="1828800"/><a:ext cx="2743200" cy="1371600"/></a:xfrm></p:spPr></p:pic></p:spTree></p:cSld></p:sld>`;
 }

src/io/powerPointOffice.ts

@@ -43,6 +43,7 @@ export async function importPptxFile(file: File): Promise<ImportedPowerPointDeck
 
   const zip = await loadZip(file);
   const parser = await createXmlParser();
+  const orderedParser = await createOrderedXmlParser();
   const title = officeTitleFromFileName(file.name, "Презентация QPowerPoint.pptx");
   const presentationXml = await readOptionalParsedXml(zip, parser, "ppt/presentation.xml");
   const presentationRelationshipsXml = await readOptionalParsedXml(zip, parser, "ppt/_rels/presentation.xml.rels");
@@ -56,11 +57,14 @@ export async function importPptxFile(file: File): Promise<ImportedPowerPointDeck
     slidePaths.map(async ({ path, index }) => {
       const slideXml = await readRequiredZipText(zip, path, "Не удалось прочитать слайд PowerPoint.");
       const parsedSlide = parser.parse(slideXml);
-      const slideTextBlocks = extractSlideTextBlocks(parsedSlide);
+      const orderedSlide = orderedParser.parse(slideXml);
+      const slideTextBlocks = mergeOrderedSlideTextBlocks(extractSlideTextBlocks(parsedSlide), extractOrderedTextBodyTexts(orderedSlide));
       const images = await extractSlideImages(zip, parser, parsedSlide, path, index);
       const notesPath = await slideNotesPath(zip, parser, path);
       const notesXml = notesPath ? await readOptionalZipText(zip, notesPath) : await readOptionalZipText(zip, `ppt/notesSlides/notesSlide${index}.xml`);
-      const notes = notesXml ? extractTextBlocks(parser.parse(notesXml)).join("\n") : "";
+      const notes = notesXml
+        ? extractOrderedTextBodyTexts(orderedParser.parse(notesXml)).join("\n") || extractTextBlocks(parser.parse(notesXml)).join("\n")
+        : "";
       const backgroundColor = slideBackgroundColor(parsedSlide);
 
       return {
@@ -199,6 +203,44 @@ function extractSlideTextBlocks(slideXml: unknown): SlideTextBlock[] {
   return blocks.length > 0 ? blocks : extractTextBlocks(slideXml).map((text) => ({ text }));
 }
 
+function mergeOrderedSlideTextBlocks(styledBlocks: SlideTextBlock[], orderedTexts: string[]) {
+  if (orderedTexts.length === 0) {
+    return styledBlocks;
+  }
+
+  return orderedTexts.map((text, index) => {
+    const styledBlock = styledBlocks[index] ?? { text };
+    return { ...styledBlock, text };
+  });
+}
+
+function extractOrderedTextBodyTexts(xmlNode: unknown) {
+  return orderedElementsByName(xmlNode, "txBody").map(orderedTextBodyText).filter(Boolean);
+}
+
+function orderedTextBodyText(textBody: unknown) {
+  const paragraphs = orderedDirectElements(textBody, "p").map(orderedParagraphText).filter(Boolean);
+  return paragraphs.length > 0 ? paragraphs.join("\n") : "";
+}
+
+function orderedParagraphText(paragraph: unknown) {
+  return normalizeTextWithLineBreaks(
+    orderedElementChildren(paragraph)
+      .map((child) => {
+        const name = orderedElementName(child);
+        if (name === "r" || name === "fld") {
+          return orderedXmlText(child);
+        }
+        if (name === "br") {
+          return "\n";
+        }
+
+        return "";
+      })
+      .join("")
+  );
+}
+
 function extractTextBodyText(textBody: Record<string, unknown>) {
   const paragraphs = toArray(textBody.p)
     .map((paragraph) => normalizeWhitespace(extractTextBlocks(paragraph).join("")))
@@ -288,6 +330,15 @@ export function normalizeWhitespace(value: string): string {
   return value.replace(/\s+/g, " ").trim();
 }
 
+function normalizeTextWithLineBreaks(value: string): string {
+  return value
+    .split("\n")
+    .map(normalizeWhitespace)
+    .join("\n")
+    .replace(/\n{3,}/g, "\n\n")
+    .trim();
+}
+
 async function extractSlideImages(
   zip: ZipArchive,
   parser: { parse: (xml: string) => unknown },
@@ -461,6 +512,18 @@ async function createXmlParser(): Promise<{ parse: (xml: string) => unknown }> {
   });
 }
 
+async function createOrderedXmlParser(): Promise<{ parse: (xml: string) => unknown }> {
+  const moduleName = "fast-xml-parser";
+  const parserModule = (await import(moduleName)) as { XMLParser: XmlParserConstructor };
+  return new parserModule.XMLParser({
+    ignoreAttributes: false,
+    removeNSPrefix: true,
+    textNodeName: "#text",
+    trimValues: true,
+    preserveOrder: true
+  });
+}
+
 async function readOptionalParsedXml(zip: ZipArchive, parser: { parse: (xml: string) => unknown }, path: string): Promise<unknown> {
   const xml = await readOptionalZipText(zip, path);
   return xml ? parser.parse(xml) : undefined;
@@ -529,6 +592,68 @@ function isXmlAttributeKey(key: string) {
   return key.startsWith("@_") || ["id", "name", "descr", "x", "y", "cx", "cy", "embed", "link"].includes(key);
 }
 
+function orderedElementsByName(node: unknown, name: string): unknown[] {
+  const elements: unknown[] = [];
+  visitOrderedElements(node, (element) => {
+    if (orderedElementName(element) === name) {
+      elements.push(element);
+    }
+  });
+  return elements;
+}
+
+function visitOrderedElements(node: unknown, visitor: (element: unknown) => void): void {
+  if (Array.isArray(node)) {
+    node.forEach((item) => visitOrderedElements(item, visitor));
+    return;
+  }
+
+  if (!node || typeof node !== "object") {
+    return;
+  }
+
+  visitor(node);
+  orderedElementChildren(node).forEach((child) => visitOrderedElements(child, visitor));
+}
+
+function orderedDirectElements(node: unknown, name: string) {
+  return orderedElementChildren(node).filter((child) => orderedElementName(child) === name);
+}
+
+function orderedElementName(node: unknown) {
+  return Object.keys(asRecord(node)).find((key) => key !== ":@") ?? "";
+}
+
+function orderedElementChildren(node: unknown): unknown[] {
+  const name = orderedElementName(node);
+  return name ? toArray(asRecord(node)[name]) : [];
+}
+
+function orderedXmlText(node: unknown): string {
+  if (node === null || node === undefined) {
+    return "";
+  }
+
+  if (typeof node === "string" || typeof node === "number") {
+    return String(node);
+  }
+
+  if (Array.isArray(node)) {
+    return node.map(orderedXmlText).join("");
+  }
+
+  if (typeof node !== "object") {
+    return "";
+  }
+
+  const record = node as Record<string, unknown>;
+  if (typeof record["#text"] === "string" || typeof record["#text"] === "number") {
+    return String(record["#text"]);
+  }
+
+  return orderedElementChildren(node).map(orderedXmlText).join("");
+}
+
 function slideIndexFromPath(path: string): number | undefined {
   const match = slidePathPattern.exec(path);
   return match ? Number(match[1]) : undefined;