diff --git a/README.md b/README.md index 7accb44..b398712 100644 --- a/README.md +++ b/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 в текущем инкременте не заявлены. ## Сборка пакета diff --git a/src/io/powerPointOffice.test.ts b/src/io/powerPointOffice.test.ts index 77c99ad..8bd6937 100644 --- a/src/io/powerPointOffice.test.ts +++ b/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", + `` + ); + zip.file( + "ppt/_rels/presentation.xml.rels", + `` + ); + 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("")}`; } +function slideXmlWithManualBreakSubtitle(title: string, subtitleLines: string[]) { + return `${title}${subtitleLines + .map((text, index) => `${index > 0 ? "" : ""}${text}`) + .join("")}`; +} + function slideXmlWithPicture(title: string) { return `${title}`; } diff --git a/src/io/powerPointOffice.ts b/src/io/powerPointOffice.ts index c1618b9..58c9d5f 100644 --- a/src/io/powerPointOffice.ts +++ b/src/io/powerPointOffice.ts @@ -43,6 +43,7 @@ export async function importPptxFile(file: File): Promise { 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) { 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 { 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; + 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;