Preserve QPowerPoint subtitle lists in PPTX

README.md

@@ -46,7 +46,7 @@ npm run build
 
 - QWord открывает `.docx` и сохраняет `.docx`; при импорте базовых DOCX-абзацев читает выравнивание, отступы `w:ind`, переносы строк, разрывы страниц, табуляцию, закладки, внешние и внутренние гиперссылки-якоря, простые таблицы, базовые растровые изображения, явные цвета текста, подсветку, размер и семейство шрифта из OOXML, а при экспорте DOCX сохраняются заголовки, абзацы, переносы строк, разрывы страниц, табуляция, выравнивание и отступы абзацев из HTML `margin-left`/`text-indent`, закладки из 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, внешние и внутренние гиперссылки ячеек, базовые диаграммы листа и базовое форматирование ячеек: полужирный, курсив, подчеркивание, зачеркивание, размер и семейство шрифта, прямые RGB/theme/indexed цвета текста с учетом `xl/theme/theme1.xml`, заливку, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы XLSX для дат, процентов, денежных и дробных значений.
-- QPowerPoint открывает `.pptx` и сохраняет `.pptx`; импорт учитывает порядок слайдов из `presentation.xml`, переносы абзацев и ручные переносы строк `a:br` внутри текстовых блоков, скрытые слайды через атрибут `show`, переходы `p:transition` для `fade`/`push`/`wipe`, а также заметки докладчика через relationships слайда, сохраняет скрытые слайды, переходы слайдов, заметки докладчика, базовые растровые изображения слайдов, пользовательский цвет фона слайда, а также цвет, размер и семейство шрифта текста заголовка/подзаголовка.
+- QPowerPoint открывает `.pptx` и сохраняет `.pptx`; импорт учитывает порядок слайдов из `presentation.xml`, переносы абзацев и ручные переносы строк `a:br` внутри текстовых блоков, маркированные и нумерованные списки подзаголовка через `a:buChar`/`a:buAutoNum`, скрытые слайды через атрибут `show`, переходы `p:transition` для `fade`/`push`/`wipe`, а также заметки докладчика через 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`, `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` пока не реализованы.
 
 В desktop-режиме Electron используются системные диалоги открытия и сохранения файлов. В web-режиме остаются браузерный выбор файла и скачивание результата.

src/features/qpowerpoint/QPowerPoint.tsx

@@ -1,7 +1,7 @@
 import { useRef, useState } from "react";
 import type { CSSProperties } from "react";
-import { Copy, Download, EyeOff, FileText, FileUp, Image as ImageIcon, Palette, Plus, Save, Trash2 } from "lucide-react";
+import { Copy, Download, EyeOff, FileText, FileUp, Image as ImageIcon, List, ListOrdered, ListX, Palette, Plus, Save, Trash2 } from "lucide-react";
-import type { Slide, SlideDeck, SlideImage, SlideTransition } from "../../types";
+import type { Slide, SlideDeck, SlideImage, SlideListStyle, SlideTransition } from "../../types";
 import { downloadBlobFile, downloadTextFile } from "../../utils/download";
 import { exportPptxBlob, importPptxFile } from "../../io/powerPointOffice";
 import { replaceFileExtension } from "../../io/fileHelpers";
@@ -183,6 +183,10 @@ export function QPowerPoint({ deck, onChange }: QPowerPointProps) {
     setSelectedImageId("");
   }
 
+  function updateSubtitleListStyle(listStyle: SlideListStyle | "") {
+    updateSlide({ ...activeSlide, subtitleListStyle: listStyle || undefined });
+  }
+
   function addSlide() {
     const id = `slide-${Date.now()}`;
     onChange({
@@ -537,6 +541,35 @@ export function QPowerPoint({ deck, onChange }: QPowerPointProps) {
                 />
               ))}
             </div>
+            <div className="segmented-tools slide-list-tools" aria-label="Список подзаголовка">
+              <button
+                type="button"
+                className={!activeSlide.subtitleListStyle ? "is-active" : ""}
+                onClick={() => updateSubtitleListStyle("")}
+                title="Без списка"
+                aria-label="Без списка"
+              >
+                <ListX size={16} />
+              </button>
+              <button
+                type="button"
+                className={activeSlide.subtitleListStyle === "bullet" ? "is-active" : ""}
+                onClick={() => updateSubtitleListStyle("bullet")}
+                title="Маркированный список"
+                aria-label="Маркированный список"
+              >
+                <List size={16} />
+              </button>
+              <button
+                type="button"
+                className={activeSlide.subtitleListStyle === "number" ? "is-active" : ""}
+                onClick={() => updateSubtitleListStyle("number")}
+                title="Нумерованный список"
+                aria-label="Нумерованный список"
+              >
+                <ListOrdered size={16} />
+              </button>
+            </div>
           </div>
 
           <div className="office-tool-section">
@@ -642,7 +675,7 @@ export function QPowerPoint({ deck, onChange }: QPowerPointProps) {
             onChange={(event) => updateSlide({ ...activeSlide, title: event.target.value })}
           />
           <textarea
-            className="slide-subtitle-input"
+            className={`slide-subtitle-input ${activeSlide.subtitleListStyle ? `is-${activeSlide.subtitleListStyle}-list` : ""}`.trim()}
             value={activeSlide.subtitle}
             aria-label="Подзаголовок слайда"
             style={slideTextStyle(activeSlide.subtitleColor, activeSlide.subtitleFontSize, activeSlide.subtitleFontFamily)}

src/io/powerPointOffice.test.ts

@@ -173,6 +173,86 @@ describe("powerPointOffice helpers", () => {
     expect(imported.slides[0].subtitle).toBe("Plan\nBuild\nShip");
   });
 
+  it("импортирует маркированные и нумерованные списки подзаголовка PPTX", async () => {
+    const bulletZip = new JSZip();
+    bulletZip.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>`
+    );
+    bulletZip.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>`
+    );
+    bulletZip.file("ppt/slides/slide1.xml", slideXmlWithListSubtitle("План", ["Собрать требования", "Проверить импорт"], "bullet"));
+
+    const bulletBlob = await bulletZip.generateAsync({
+      type: "blob",
+      mimeType: "application/vnd.openxmlformats-officedocument.presentationml.presentation"
+    });
+    const importedBullet = await importPptxFile(new File([bulletBlob], "Маркированный.pptx", { type: bulletBlob.type }));
+
+    expect(importedBullet.slides[0].subtitle).toBe("Собрать требования\nПроверить импорт");
+    expect(importedBullet.slides[0].subtitleListStyle).toBe("bullet");
+
+    const numberZip = new JSZip();
+    numberZip.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>`
+    );
+    numberZip.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>`
+    );
+    numberZip.file("ppt/slides/slide1.xml", slideXmlWithListSubtitle("План", ["Шаг один", "Шаг два"], "number"));
+
+    const numberBlob = await numberZip.generateAsync({
+      type: "blob",
+      mimeType: "application/vnd.openxmlformats-officedocument.presentationml.presentation"
+    });
+    const importedNumber = await importPptxFile(new File([numberBlob], "Нумерованный.pptx", { type: numberBlob.type }));
+
+    expect(importedNumber.slides[0].subtitle).toBe("Шаг один\nШаг два");
+    expect(importedNumber.slides[0].subtitleListStyle).toBe("number");
+  });
+
+  it("экспортирует списки подзаголовка PPTX как OOXML bullets", async () => {
+    const bulletBlob = await exportPptxBlob({
+      title: "Маркированный.pptx",
+      slides: [
+        {
+          id: "slide-1",
+          title: "План",
+          subtitle: "Собрать требования\nПроверить импорт",
+          subtitleListStyle: "bullet",
+          notes: "",
+          theme: "classic"
+        }
+      ]
+    });
+    const bulletZip = await JSZip.loadAsync(await bulletBlob.arrayBuffer());
+    const bulletSlideXml = (await bulletZip.file("ppt/slides/slide1.xml")?.async("string")) ?? "";
+
+    expect(bulletSlideXml).toContain("<a:buChar");
+
+    const numberBlob = await exportPptxBlob({
+      title: "Нумерованный.pptx",
+      slides: [
+        {
+          id: "slide-1",
+          title: "План",
+          subtitle: "Шаг один\nШаг два",
+          subtitleListStyle: "number",
+          notes: "",
+          theme: "classic"
+        }
+      ]
+    });
+    const numberZip = await JSZip.loadAsync(await numberBlob.arrayBuffer());
+    const numberSlideXml = (await numberZip.file("ppt/slides/slide1.xml")?.async("string")) ?? "";
+
+    expect(numberSlideXml).toContain("<a:buAutoNum");
+  });
+
   it("импортирует изображения слайда из PPTX media relationships", async () => {
     const zip = new JSZip();
     zip.file(
@@ -486,6 +566,14 @@ function slideXmlWithManualBreakSubtitle(title: string, subtitleLines: string[])
     .join("")}</a:p></p:txBody></p:sp></p:spTree></p:cSld></p:sld>`;
 }
 
+function slideXmlWithListSubtitle(title: string, subtitleLines: string[], listStyle: "bullet" | "number") {
+  const paragraphProperties =
+    listStyle === "number" ? '<a:pPr><a:buAutoNum type="arabicPeriod"/></a:pPr>' : '<a:pPr><a:buChar char="•"/></a:pPr>';
+  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>${subtitleLines
+    .map((text) => `<a:p>${paragraphProperties}<a:r><a:t>${text}</a:t></a:r></a:p>`)
+    .join("")}</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

@@ -1,4 +1,4 @@
-import type { Slide, SlideImage } from "../types";
+import type { Slide, SlideImage, SlideListStyle } from "../types";
 import { officeTitleFromFileName, PPTX_MIME_TYPE, readOfficeFileAsArrayBuffer } from "./fileHelpers";
 
 export interface ImportedPowerPointDeck {
@@ -13,6 +13,7 @@ export interface ExportablePowerPointDeck {
 
 interface SlideTextBlock {
   text: string;
+  listStyle?: SlideListStyle;
   color?: string;
   fontSize?: number;
   fontFamily?: string;
@@ -77,6 +78,10 @@ export async function importPptxFile(file: File): Promise<ImportedPowerPointDeck
       const backgroundColor = slideBackgroundColor(parsedSlide);
       const hidden = slideHidden(parsedSlide);
       const transition = slideTransition(parsedSlide);
+      const subtitleListStyle = slideTextBlocks
+        .slice(1)
+        .map((block) => block.listStyle)
+        .find((style): style is SlideListStyle => Boolean(style));
 
       return {
         id: `pptx-slide-${index}`,
@@ -93,6 +98,7 @@ export async function importPptxFile(file: File): Promise<ImportedPowerPointDeck
         ...(slideTextBlocks[1]?.color ? { subtitleColor: slideTextBlocks[1].color } : {}),
         ...(slideTextBlocks[1]?.fontSize ? { subtitleFontSize: slideTextBlocks[1].fontSize } : {}),
         ...(slideTextBlocks[1]?.fontFamily ? { subtitleFontFamily: slideTextBlocks[1].fontFamily } : {}),
+        ...(subtitleListStyle ? { subtitleListStyle } : {}),
         images
       };
     })
@@ -183,7 +189,9 @@ export async function exportPptxBlob(deck: ExportablePowerPointDeck): Promise<Bl
 
   const result = await pptx.write({ outputType: "blob" });
   const blob = result instanceof Blob ? result : new Blob([result], { type: PPTX_MIME_TYPE });
-  return deck.slides.some((slide) => slide.hidden || slide.transition) ? applySlideXmlOverridesToPptxBlob(blob, deck.slides) : blob;
+  return deck.slides.some((slide) => slide.hidden || slide.transition || slide.subtitleListStyle)
+    ? applySlideXmlOverridesToPptxBlob(blob, deck.slides)
+    : blob;
 }
 
 export function extractTextBlocks(xmlNode: unknown): string[] {
@@ -202,11 +210,13 @@ function extractSlideTextBlocks(slideXml: unknown): SlideTextBlock[] {
       }
 
       const runProperties = firstRecordByKey(textBody, "rPr");
+      const listStyle = textBodyListStyle(textBody);
       const color = runTextColor(runProperties);
       const fontSize = runTextFontSize(runProperties);
       const fontFamily = runTextFontFamily(runProperties);
       return {
         text,
+        ...(listStyle ? { listStyle } : {}),
         ...(color ? { color } : {}),
         ...(fontSize ? { fontSize } : {}),
         ...(fontFamily ? { fontFamily } : {})
@@ -228,6 +238,26 @@ function mergeOrderedSlideTextBlocks(styledBlocks: SlideTextBlock[], orderedText
   });
 }
 
+function textBodyListStyle(textBody: Record<string, unknown>): SlideListStyle | undefined {
+  const paragraphStyles = toArray(textBody.p)
+    .map(paragraphListStyle)
+    .filter((style): style is SlideListStyle => Boolean(style));
+
+  return paragraphStyles.includes("number") ? "number" : paragraphStyles[0];
+}
+
+function paragraphListStyle(paragraph: unknown): SlideListStyle | undefined {
+  const paragraphProperties = childRecord(asRecord(paragraph), "pPr");
+  if (Object.keys(childRecord(paragraphProperties, "buAutoNum")).length > 0) {
+    return "number";
+  }
+  if (Object.keys(childRecord(paragraphProperties, "buChar")).length > 0) {
+    return "bullet";
+  }
+
+  return undefined;
+}
+
 function extractOrderedTextBodyTexts(xmlNode: unknown) {
   return orderedElementsByName(xmlNode, "txBody").map(orderedTextBodyText).filter(Boolean);
 }
@@ -482,7 +512,7 @@ async function applySlideXmlOverridesToPptxBlob(blob: Blob, slides: Slide[]) {
   const zip = await JSZip.loadAsync(await blob.arrayBuffer());
   await Promise.all(
     slides.map(async (slide, index) => {
-      if (!slide.hidden && !slide.transition) {
+      if (!slide.hidden && !slide.transition && !slide.subtitleListStyle) {
         return;
       }
 
@@ -499,7 +529,8 @@ async function applySlideXmlOverridesToPptxBlob(blob: Blob, slides: Slide[]) {
 
 function pptxSlideXmlWithOverrides(xml: string, slide: Slide) {
   const withHiddenState = slide.hidden ? pptxSlideXmlWithHiddenState(xml) : xml;
-  return slide.transition ? pptxSlideXmlWithTransition(withHiddenState, slide.transition) : withHiddenState;
+  const withTransition = slide.transition ? pptxSlideXmlWithTransition(withHiddenState, slide.transition) : withHiddenState;
+  return slide.subtitleListStyle ? pptxSlideXmlWithSubtitleList(withTransition, slide.subtitleListStyle) : withTransition;
 }
 
 function pptxSlideXmlWithHiddenState(xml: string) {
@@ -524,6 +555,37 @@ function pptxSlideXmlWithTransition(xml: string, transition: NonNullable<Slide["
   return xml.replace(/<p:sld\b[^>]*>/, (match) => `${match}${transitionXml}`);
 }
 
+function pptxSlideXmlWithSubtitleList(xml: string, listStyle: SlideListStyle) {
+  let textBodyIndex = 0;
+  return xml.replace(/<p:txBody\b[\s\S]*?<\/p:txBody>/g, (textBodyXml) => {
+    textBodyIndex += 1;
+    return textBodyIndex === 2 ? pptxTextBodyXmlWithList(textBodyXml, listStyle) : textBodyXml;
+  });
+}
+
+function pptxTextBodyXmlWithList(textBodyXml: string, listStyle: SlideListStyle) {
+  return textBodyXml.replace(/<a:p>[\s\S]*?<\/a:p>/g, (paragraphXml) => pptxParagraphXmlWithList(paragraphXml, listStyle));
+}
+
+function pptxParagraphXmlWithList(paragraphXml: string, listStyle: SlideListStyle) {
+  const listXml = pptxParagraphListXml(listStyle);
+  if (/<a:pPr\b[^>]*\/>/.test(paragraphXml)) {
+    return paragraphXml.replace(/<a:pPr\b([^>]*)\/>/, `<a:pPr$1>${listXml}</a:pPr>`);
+  }
+  if (/<a:pPr\b/.test(paragraphXml)) {
+    return paragraphXml.replace(/<a:pPr\b([^>]*)>([\s\S]*?)<\/a:pPr>/, (_match, attributes: string, content: string) => {
+      const contentWithoutBullet = content.replace(/<a:bu[A-Za-z]+\b[^>]*\/>/g, "");
+      return `<a:pPr${attributes}>${listXml}${contentWithoutBullet}</a:pPr>`;
+    });
+  }
+
+  return paragraphXml.replace("<a:p>", `<a:p><a:pPr>${listXml}</a:pPr>`);
+}
+
+function pptxParagraphListXml(listStyle: SlideListStyle) {
+  return listStyle === "number" ? '<a:buAutoNum type="arabicPeriod"/>' : '<a:buChar char="•"/>';
+}
+
 function normalizeHexColor(value?: string) {
   const raw = value?.trim().replace(/^#/, "").toUpperCase() ?? "";
   return /^[0-9A-F]{6}$/.test(raw) ? raw : "";

src/styles.css

@@ -597,6 +597,11 @@ button {
   border-right: 0;
 }
 
+.segmented-tools button.is-active {
+  background: #e8f2ff;
+  color: #0f5fae;
+}
+
 .module-toolbar select,
 .office-workbar select,
 .office-workbar input,
@@ -1349,6 +1354,28 @@ button {
   line-height: 1.35;
 }
 
+.slide-subtitle-input.is-bullet-list,
+.slide-subtitle-input.is-number-list {
+  padding-left: 34px;
+}
+
+.slide-subtitle-input.is-bullet-list {
+  background-image: radial-gradient(currentColor 0 3px, transparent 3px);
+  background-position: 10px 0.63em;
+  background-repeat: no-repeat;
+}
+
+.slide-subtitle-input.is-number-list {
+  background-image: linear-gradient(currentColor 0 0);
+  background-position: 13px 0.64em;
+  background-repeat: no-repeat;
+  background-size: 13px 2px;
+}
+
+.slide-list-tools {
+  width: fit-content;
+}
+
 .slide-accent-line {
   position: relative;
   z-index: 2;

src/types.ts

@@ -87,6 +87,7 @@ export interface Slide {
   id: string;
   title: string;
   subtitle: string;
+  subtitleListStyle?: SlideListStyle;
   notes: string;
   theme: "classic" | "ocean" | "graphite";
   hidden?: boolean;
@@ -101,6 +102,7 @@ export interface Slide {
   images?: SlideImage[];
 }
 
+export type SlideListStyle = "bullet" | "number";
 export type SlideTransition = "fade" | "push" | "wipe";
 
 export interface SlideImage {