Preserve QPowerPoint slide backgrounds

README.md

@@ -33,7 +33,7 @@ npm run build
 
 - QWord открывает `.docx` и сохраняет `.docx`; при импорте базовых DOCX-абзацев читает выравнивание, явные цвета текста и подсветку из OOXML, а при экспорте DOCX сохраняются заголовки, абзацы, выравнивание абзацев, списки, простые таблицы, внешние гиперссылки, базовые растровые изображения и базовое inline-форматирование текста: полужирный, курсив, подчеркивание, цвет текста и подсветка.
 - QExcell открывает `.xlsx` и сохраняет `.xlsx`; сетка расширяется по фактически заполненным ячейкам, поддерживает несколько листов, формулы за пределами стартового диапазона A-H, базовые merged cells, внешние гиперссылки ячеек, базовые диаграммы листа и базовое форматирование ячеек: полужирный, курсив, подчеркивание, цвет текста, заливку, горизонтальное выравнивание и числовые форматы XLSX для дат, процентов, денежных и дробных значений.
-- QPowerPoint открывает `.pptx` и сохраняет `.pptx`; импорт учитывает порядок слайдов из `presentation.xml`, читает заметки докладчика через relationships слайда и сохраняет базовые растровые изображения слайдов.
+- 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-вложения. Импорт MSG читает тему, отправителя, получателей, текст/HTML body и вложения, если эти поля доступны в MSG-файле. Новые письма можно сохранять в 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:color`, `w:shd` и `w:highlight` для цвета/подсветки текста DOCX, выравнивание абзацев DOCX, внешние гиперссылки DOCX/XLSX, базовые растровые изображения DOCX/PPTX, простые таблицы, несколько листов XLSX, ячейки, формулы, базовые merged cells, базовые стили, цвета текста ячеек, горизонтальное выравнивание ячеек, числовые форматы и простые bar/line/pie диаграммы ячеек XLSX, текстовые слайды PPTX, заметки докладчика, MIME-вложения EML и базовые поля одиночных MSG-писем. Сложные стили, макросы, сложные диаграммы, сложное позиционирование и обтекание изображений, PST, экспорт MSG и полная fidelity документов Microsoft Office в текущем инкременте не заявлены.
+Импорт и экспорт реализуют базовую совместимость с 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, заметки докладчика, MIME-вложения EML и базовые поля одиночных MSG-писем. Сложные стили, макросы, сложные диаграммы, сложное позиционирование и обтекание изображений, PST, экспорт MSG и полная fidelity документов Microsoft Office в текущем инкременте не заявлены.
 
 ## Сборка пакета
 

src/App.tsx

@@ -13,6 +13,7 @@ const STORAGE_KEY = "qoffice-state-v1";
 function migrateQOfficeState(state: QOfficeState): QOfficeState {
   const launchChecklistAttachments = initialState.mail.messages.find((message) => message.id === "mail-1")?.attachments;
   const sampleSheet = initialState.workbook.sheets.find((sheet) => sheet.id === "sheet-1");
+  const sampleSlidesById = Object.fromEntries(initialState.deck.slides.map((slide) => [slide.id, slide]));
   const sampleWordHtml = initialState.word.html;
   const needsSampleWordColor =
     state.word.id === initialState.word.id &&
@@ -64,11 +65,25 @@ function migrateQOfficeState(state: QOfficeState): QOfficeState {
         })
       : state.workbook.sheets;
 
+  const slides =
+    state.deck.id === initialState.deck.id
+      ? state.deck.slides.map((slide) => {
+          const sampleSlide = sampleSlidesById[slide.id];
+          if (!sampleSlide?.backgroundColor || slide.backgroundColor) {
+            return slide;
+          }
+
+          changed = true;
+          return { ...slide, backgroundColor: sampleSlide.backgroundColor };
+        })
+      : state.deck.slides;
+
   return changed
     ? {
         ...state,
         word: needsSampleWordColor ? { ...state.word, html: sampleWordHtml } : state.word,
         workbook: { ...state.workbook, sheets },
+        deck: { ...state.deck, slides },
         mail: { ...state.mail, messages }
       }
     : state;

src/data/sampleData.ts

@@ -111,7 +111,8 @@ export const initialState: QOfficeState = {
         title: "Дорожная карта QOffice",
         subtitle: "Единая рабочая среда для документов, данных, презентаций и коммуникации.",
         notes: "Начать с цели продукта и текущего этапа.",
-        theme: "classic"
+        theme: "classic",
+        backgroundColor: "EAF6FF"
       },
       {
         id: "slide-2",

src/features/qpowerpoint/QPowerPoint.tsx

@@ -19,6 +19,16 @@ const themeLabels: Record<Slide["theme"], string> = {
   graphite: "Графит"
 };
 
+const backgroundColorSwatches = [
+  { color: "", label: "Фон темы" },
+  { color: "FFFFFF", label: "Белый фон" },
+  { color: "EAF6FF", label: "Светло-синий фон" },
+  { color: "D9EAD3", label: "Светло-зеленый фон" },
+  { color: "FFF2CC", label: "Светло-желтый фон" },
+  { color: "FCE4D6", label: "Коралловый фон" },
+  { color: "1F2937", label: "Темный фон" }
+];
+
 const slideWidthInches = 13.333;
 const slideHeightInches = 7.5;
 
@@ -69,6 +79,16 @@ function slideImageStyle(image: SlideImage) {
   };
 }
 
+function slideCanvasStyle(slide: Slide) {
+  const backgroundColor = normalizedHexColor(slide.backgroundColor);
+  return backgroundColor ? { background: `#${backgroundColor}` } : undefined;
+}
+
+function normalizedHexColor(value?: string) {
+  const raw = value?.trim().replace(/^#/, "").toUpperCase() ?? "";
+  return /^[0-9A-F]{6}$/.test(raw) ? raw : "";
+}
+
 function clonedSlideImages(images?: SlideImage[]) {
   const suffix = Date.now();
   return images?.map((image, index) => ({ ...image, id: `${image.id}-copy-${suffix}-${index}` }));
@@ -324,7 +344,7 @@ export function QPowerPoint({ deck, onChange }: QPowerPointProps) {
           </button>
         </div>
 
-        <div className={`slide-canvas theme-${activeSlide.theme}`}>
+        <div className={`slide-canvas theme-${activeSlide.theme}`} style={slideCanvasStyle(activeSlide)}>
           {activeImages.map((image) => (
             <button
               key={image.id}
@@ -370,6 +390,19 @@ export function QPowerPoint({ deck, onChange }: QPowerPointProps) {
               ))}
             </select>
           </label>
+          <div className="slide-background-swatches" aria-label="Фон слайда">
+            {backgroundColorSwatches.map((swatch) => (
+              <button
+                key={swatch.label}
+                className={`fill-swatch ${swatch.color ? "" : "is-empty"} ${normalizedHexColor(activeSlide.backgroundColor) === swatch.color || (!activeSlide.backgroundColor && !swatch.color) ? "is-active" : ""}`.trim()}
+                type="button"
+                onClick={() => updateSlide({ ...activeSlide, backgroundColor: swatch.color || undefined })}
+                title={swatch.label}
+                aria-label={swatch.label}
+                style={swatch.color ? { backgroundColor: `#${swatch.color}` } : undefined}
+              />
+            ))}
+          </div>
         </section>
         <section>
           <h3>Изображения</h3>

src/io/powerPointOffice.test.ts

@@ -201,6 +201,45 @@ describe("powerPointOffice helpers", () => {
     expect(mediaFiles.length).toBeGreaterThan(0);
   });
 
+  it("импортирует и экспортирует пользовательский цвет фона слайда", 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", slideXmlWithBackground("Фон слайда", "FCE4D6"));
+
+    const importedBlob = await zip.generateAsync({
+      type: "blob",
+      mimeType: "application/vnd.openxmlformats-officedocument.presentationml.presentation"
+    });
+    const imported = await importPptxFile(new File([importedBlob], "Фон.pptx", { type: importedBlob.type }));
+
+    expect(imported.slides[0].backgroundColor).toBe("FCE4D6");
+
+    const exportedBlob = await exportPptxBlob({
+      title: "Фон.pptx",
+      slides: [
+        {
+          id: "slide-1",
+          title: "Фон слайда",
+          subtitle: "",
+          notes: "",
+          theme: "classic",
+          backgroundColor: "FCE4D6"
+        }
+      ]
+    });
+    const exportedZip = await JSZip.loadAsync(await exportedBlob.arrayBuffer());
+    const exportedSlideXml = await exportedZip.file("ppt/slides/slide1.xml")?.async("string");
+
+    expect(exportedSlideXml).toContain("FCE4D6");
+  });
+
   it("нормализует пробелы в импортированном тексте", () => {
     expect(normalizeWhitespace("  Строка\tс \n пробелами  ")).toBe("Строка с пробелами");
   });
@@ -212,6 +251,10 @@ function slideXml(...texts: string[]) {
     .join("")}</p:spTree></p:cSld></p:sld>`;
 }
 
+function slideXmlWithBackground(title: string, color: 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:bg><p:bgPr><a:solidFill><a:srgbClr val="${color}"/></a:solidFill></p:bgPr></p:bg><p:spTree><p:sp><p:txBody><a:p><a:r><a:t>${title}</a:t></a:r></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

@@ -54,6 +54,7 @@ export async function importPptxFile(file: File): Promise<ImportedPowerPointDeck
       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 backgroundColor = slideBackgroundColor(parsedSlide);
 
       return {
         id: `pptx-slide-${index}`,
@@ -61,6 +62,7 @@ export async function importPptxFile(file: File): Promise<ImportedPowerPointDeck
         subtitle: slideTextBlocks.slice(1).join("\n"),
         notes,
         theme: "classic" as const,
+        ...(backgroundColor ? { backgroundColor } : {}),
         images
       };
     })
@@ -97,7 +99,7 @@ export async function exportPptxBlob(deck: ExportablePowerPointDeck): Promise<Bl
   for (const sourceSlide of deck.slides) {
     const colors = themeColors[sourceSlide.theme] ?? themeColors.classic;
     const slide = pptx.addSlide();
-    slide.background = { color: colors.background };
+    slide.background = { color: normalizeHexColor(sourceSlide.backgroundColor) || colors.background };
     sourceSlide.images?.forEach((image, index) => {
       const data = normalizedImageData(image.src);
       if (!data || !slide.addImage) {
@@ -335,6 +337,19 @@ function normalizedImageData(src: string) {
   return /^data:image\/(?:png|jpe?g|gif|bmp|svg\+xml);base64,/i.test(value) ? value : "";
 }
 
+function slideBackgroundColor(slideXml: unknown) {
+  const background = firstRecordByKey(slideXml, "bg");
+  const backgroundProperties = childRecord(background, "bgPr");
+  const solidFill = childRecord(backgroundProperties, "solidFill");
+  const srgbColor = childRecord(solidFill, "srgbClr");
+  return normalizeHexColor(stringValue(srgbColor.val ?? srgbColor["@_val"]));
+}
+
+function normalizeHexColor(value?: string) {
+  const raw = value?.trim().replace(/^#/, "").toUpperCase() ?? "";
+  return /^[0-9A-F]{6}$/.test(raw) ? raw : "";
+}
+
 function numberAttribute(record: Record<string, unknown>, name: string) {
   const value = Number.parseFloat(stringValue(record[name] ?? record[`@_${name}`]));
   return Number.isFinite(value) ? value : undefined;

src/styles.css

@@ -422,6 +422,12 @@ button {
   padding-left: 2px;
 }
 
+.slide-background-swatches {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 6px;
+}
+
 .fill-swatch {
   position: relative;
   width: 24px;

src/types.ts

@@ -64,6 +64,7 @@ export interface Slide {
   subtitle: string;
   notes: string;
   theme: "classic" | "ocean" | "graphite";
+  backgroundColor?: string;
   images?: SlideImage[];
 }