From a2de721fc47749404b347eae6ad8b1c06cb0db89 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=9A=D1=83=D1=80=D0=BD=D0=B0=D1=82=20=D0=90=D0=BD=D0=B4?=
 =?UTF-8?q?=D1=80=D0=B5=D0=B9?= <sevenhill@live.ru>
Date: Mon, 1 Jun 2026 19:28:38 +0300
Subject: [PATCH] Preserve QPowerPoint hidden slides in PPTX

---
 README.md                                |  4 +-
 src/features/qpowerpoint/QPowerPoint.tsx | 22 ++++++++-
 src/io/powerPointOffice.test.ts          | 45 ++++++++++++++++++
 src/io/powerPointOffice.ts               | 60 ++++++++++++++++++++++--
 src/styles.css                           | 37 +++++++++++++++
 src/types.ts                             |  1 +
 6 files changed, 161 insertions(+), 8 deletions(-)

diff --git a/README.md b/README.md
index 8b1c9ab..6e51b19 100644
--- a/README.md
+++ b/README.md
@@ -33,7 +33,7 @@ npm run build
 
 - QWord открывает `.docx` и сохраняет `.docx`; при импорте базовых DOCX-абзацев читает выравнивание, переносы строк, табуляцию, внешние гиперссылки, простые таблицы, базовые растровые изображения, явные цвета текста, подсветку, размер и семейство шрифта из OOXML, а при экспорте DOCX сохраняются заголовки, абзацы, переносы строк, табуляция, выравнивание абзацев, списки, простые таблицы, внешние гиперссылки, базовые растровые изображения и базовое inline-форматирование текста: полужирный, курсив, подчеркивание, зачеркивание, цвет текста, подсветка, размер и семейство шрифта.
 - QExcell открывает `.xlsx` и сохраняет `.xlsx`; сетка расширяется по фактически заполненным ячейкам, поддерживает несколько листов, скрытые и veryHidden листы через `sheet state`, закрепленные области через `sheetViews pane`, скрытие сетки через `sheetView showGridLines`, масштаб листа через `sheetView zoomScale`, автофильтр через `autoFilter ref`, цвет вкладки листа через `sheetPr tabColor`, ширину колонок через `cols/col width`, высоту строк через `row ht/customHeight`, активный лист через `workbookView activeTab`, формулы за пределами стартового диапазона A-H, shared formulas XLSX с относительными ссылками, базовые merged cells, внешние и внутренние гиперссылки ячеек, базовые диаграммы листа и базовое форматирование ячеек: полужирный, курсив, подчеркивание, зачеркивание, размер и семейство шрифта, прямые RGB/theme/indexed цвета текста с учетом `xl/theme/theme1.xml`, заливку, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы XLSX для дат, процентов, денежных и дробных значений.
-- QPowerPoint открывает `.pptx` и сохраняет `.pptx`; импорт учитывает порядок слайдов из `presentation.xml`, переносы абзацев и ручные переносы строк `a:br` внутри текстовых блоков, а также заметки докладчика через relationships слайда, сохраняет заметки докладчика, базовые растровые изображения слайдов, пользовательский цвет фона слайда, а также цвет, размер и семейство шрифта текста заголовка/подзаголовка.
+- QPowerPoint открывает `.pptx` и сохраняет `.pptx`; импорт учитывает порядок слайдов из `presentation.xml`, переносы абзацев и ручные переносы строк `a:br` внутри текстовых блоков, скрытые слайды через атрибут `show`, а также заметки докладчика через 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:tab`, `w:color`, `w:shd`, `w:highlight`, `w:sz`, `w:rFonts` и `w:strike` для переносов строк/табуляции/цвета/подсветки/размера/семейства/зачеркивания текста DOCX, выравнивание абзацев DOCX, внешние гиперссылки DOCX, внешние и внутренние гиперссылки XLSX, базовые растровые изображения DOCX/PPTX, простые таблицы, несколько листов, скрытые/veryHidden листы через `sheet state`, закрепленные области через `sheetViews pane`, скрытие сетки через `sheetView showGridLines`, масштаб листа через `sheetView zoomScale`, автофильтр через `autoFilter ref`, цвет вкладки листа через `sheetPr tabColor`, ширину колонок через `cols/col width`, высоту строк через `row ht/customHeight` и активный лист XLSX через `workbookView activeTab`, ячейки, формулы, 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 в текущем инкременте не заявлены.
+Импорт и экспорт реализуют базовую совместимость с Office Open XML, EML и чтением MSG: текст, базовое inline-форматирование, явные `w:br`, `w:tab`, `w:color`, `w:shd`, `w:highlight`, `w:sz`, `w:rFonts` и `w:strike` для переносов строк/табуляции/цвета/подсветки/размера/семейства/зачеркивания текста DOCX, выравнивание абзацев DOCX, внешние гиперссылки DOCX, внешние и внутренние гиперссылки XLSX, базовые растровые изображения DOCX/PPTX, простые таблицы, несколько листов, скрытые/veryHidden листы через `sheet state`, закрепленные области через `sheetViews pane`, скрытие сетки через `sheetView showGridLines`, масштаб листа через `sheetView zoomScale`, автофильтр через `autoFilter ref`, цвет вкладки листа через `sheetPr tabColor`, ширину колонок через `cols/col width`, высоту строк через `row ht/customHeight` и активный лист XLSX через `workbookView activeTab`, ячейки, формулы, shared formulas XLSX с относительными ссылками, базовые merged cells, базовые стили, RGB/theme/indexed цвета XLSX с учетом `xl/theme/theme1.xml`, размеры и семейства шрифта, зачеркивание ячеек, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы и простые bar/line/pie диаграммы ячеек XLSX, текстовые слайды PPTX с переносами абзацев и ручными переносами строк `a:br` при импорте, скрытые слайды PPTX через атрибут `show`, пользовательский фон слайдов 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/features/qpowerpoint/QPowerPoint.tsx b/src/features/qpowerpoint/QPowerPoint.tsx
index c479ae2..f50b5f7 100644
--- a/src/features/qpowerpoint/QPowerPoint.tsx
+++ b/src/features/qpowerpoint/QPowerPoint.tsx
@@ -1,6 +1,6 @@
 import { useRef, useState } from "react";
 import type { CSSProperties } from "react";
-import { Copy, Download, FileText, FileUp, Image as ImageIcon, Palette, Plus, Save, Trash2 } from "lucide-react";
+import { Copy, Download, EyeOff, FileText, FileUp, Image as ImageIcon, Palette, Plus, Save, Trash2 } from "lucide-react";
 import type { Slide, SlideDeck, SlideImage } from "../../types";
 import { downloadBlobFile, downloadTextFile } from "../../utils/download";
 import { exportPptxBlob, importPptxFile } from "../../io/powerPointOffice";
@@ -315,11 +315,17 @@ export function QPowerPoint({ deck, onChange }: QPowerPointProps) {
           <button
             type="button"
             key={slide.id}
-            className={`slide-thumb theme-${slide.theme} ${slide.id === activeSlide.id ? "is-active" : ""}`}
+            className={`slide-thumb theme-${slide.theme} ${slide.id === activeSlide.id ? "is-active" : ""} ${slide.hidden ? "is-hidden" : ""}`}
             onClick={() => onChange({ ...deck, activeSlideId: slide.id })}
           >
             <span>{index + 1}</span>
             <strong>{slide.title}</strong>
+            {slide.hidden ? (
+              <span className="slide-hidden-badge">
+                <EyeOff size={14} />
+                Скрыт
+              </span>
+            ) : null}
           </button>
         ))}
       </aside>
@@ -417,6 +423,18 @@ export function QPowerPoint({ deck, onChange }: QPowerPointProps) {
       <aside className="inspector" aria-label="Параметры слайда">
         <section>
           <h3>Оформление</h3>
+          <label className="slide-hidden-toggle">
+            <span>
+              <EyeOff size={16} />
+              Показ слайда
+            </span>
+            <input
+              type="checkbox"
+              checked={Boolean(activeSlide.hidden)}
+              onChange={(event) => updateSlide({ ...activeSlide, hidden: event.target.checked || undefined })}
+            />
+            <span className="slide-hidden-toggle-text">Скрыть при показе слайд-шоу</span>
+          </label>
           <label>
             <span>
               <Palette size={16} />
diff --git a/src/io/powerPointOffice.test.ts b/src/io/powerPointOffice.test.ts
index 8bd6937..485f434 100644
--- a/src/io/powerPointOffice.test.ts
+++ b/src/io/powerPointOffice.test.ts
@@ -307,6 +307,47 @@ describe("powerPointOffice helpers", () => {
     expect(exportedSlideXml).toContain("FCE4D6");
   });
 
+  it("импортирует и экспортирует скрытые слайды PPTX через атрибут show", 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", slideXmlWithShow("Скрытый слайд", "0"));
+
+    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]).toMatchObject({ title: "Скрытый слайд", hidden: true });
+
+    const exportedBlob = await exportPptxBlob({
+      title: "Скрытый.pptx",
+      slides: [
+        {
+          id: "slide-1",
+          title: "Скрытый слайд",
+          subtitle: "",
+          notes: "",
+          theme: "classic",
+          hidden: true
+        }
+      ]
+    });
+    const exportedZip = await JSZip.loadAsync(await exportedBlob.arrayBuffer());
+    const exportedSlideXml = (await exportedZip.file("ppt/slides/slide1.xml")?.async("string")) ?? "";
+    const reimported = await importPptxFile(new File([exportedBlob], "Скрытый.pptx", { type: exportedBlob.type }));
+
+    expect(exportedSlideXml).toContain('show="0"');
+    expect(reimported.slides[0].hidden).toBe(true);
+  });
+
   it("импортирует и экспортирует цвет и размер текста слайда", async () => {
     const zip = new JSZip();
     zip.file(
@@ -380,6 +421,10 @@ 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 slideXmlWithShow(title: string, show: string) {
+  return `<p:sld show="${show}" 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:spTree></p:cSld></p:sld>`;
+}
+
 function slideXmlWithTextStyles(title: string, subtitle: 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:rPr sz="3400"><a:solidFill><a:srgbClr val="C2410C"/></a:solidFill><a:latin typeface="Courier New"/></a:rPr><a:t>${title}</a:t></a:r></a:p></p:txBody></p:sp><p:sp><p:txBody><a:p><a:r><a:rPr sz="2200"><a:solidFill><a:srgbClr val="0F766E"/></a:solidFill><a:latin typeface="Times New Roman"/></a:rPr><a:t>${subtitle}</a:t></a:r></a:p></p:txBody></p:sp></p:spTree></p:cSld></p:sld>`;
 }
diff --git a/src/io/powerPointOffice.ts b/src/io/powerPointOffice.ts
index 58c9d5f..81fdb86 100644
--- a/src/io/powerPointOffice.ts
+++ b/src/io/powerPointOffice.ts
@@ -24,6 +24,14 @@ type ZipEntry = {
   async(type: "base64"): Promise<string>;
 };
 type ZipArchive = { files?: Record<string, unknown>; file: (path: string) => ZipEntry | null };
+type WritableZipArchive = {
+  file: {
+    (path: string): ZipEntry | null;
+    (path: string, data: string): WritableZipArchive;
+  };
+  generateAsync: (options: { type: "blob"; mimeType: string }) => Promise<Blob>;
+};
+type ZipConstructor = { loadAsync: (data: ArrayBuffer) => Promise<WritableZipArchive> };
 
 const slidePathPattern = /^ppt\/slides\/slide(\d+)\.xml$/;
 const slideRelationshipType = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/slide";
@@ -66,6 +74,7 @@ export async function importPptxFile(file: File): Promise<ImportedPowerPointDeck
         ? extractOrderedTextBodyTexts(orderedParser.parse(notesXml)).join("\n") || extractTextBlocks(parser.parse(notesXml)).join("\n")
         : "";
       const backgroundColor = slideBackgroundColor(parsedSlide);
+      const hidden = slideHidden(parsedSlide);
 
       return {
         id: `pptx-slide-${index}`,
@@ -73,6 +82,7 @@ export async function importPptxFile(file: File): Promise<ImportedPowerPointDeck
         subtitle: slideTextBlocks.slice(1).map((block) => block.text).join("\n"),
         notes,
         theme: "classic" as const,
+        ...(hidden ? { hidden } : {}),
         ...(backgroundColor ? { backgroundColor } : {}),
         ...(slideTextBlocks[0]?.color ? { titleColor: slideTextBlocks[0].color } : {}),
         ...(slideTextBlocks[0]?.fontSize ? { titleFontSize: slideTextBlocks[0].fontSize } : {}),
@@ -169,7 +179,8 @@ export async function exportPptxBlob(deck: ExportablePowerPointDeck): Promise<Bl
   }
 
   const result = await pptx.write({ outputType: "blob" });
-  return result instanceof Blob ? result : new Blob([result], { type: PPTX_MIME_TYPE });
+  const blob = result instanceof Blob ? result : new Blob([result], { type: PPTX_MIME_TYPE });
+  return deck.slides.some((slide) => slide.hidden) ? applyHiddenSlidesToPptxBlob(blob, deck.slides) : blob;
 }
 
 export function extractTextBlocks(xmlNode: unknown): string[] {
@@ -448,6 +459,38 @@ function slideBackgroundColor(slideXml: unknown) {
   return normalizeHexColor(stringValue(srgbColor.val ?? srgbColor["@_val"]));
 }
 
+function slideHidden(slideXml: unknown) {
+  const slide = childRecord(slideXml, "sld");
+  return isFalseXmlBoolean(slide.show ?? slide["@_show"]);
+}
+
+async function applyHiddenSlidesToPptxBlob(blob: Blob, slides: Slide[]) {
+  const JSZip = await loadJsZip();
+  const zip = await JSZip.loadAsync(await blob.arrayBuffer());
+  await Promise.all(
+    slides.map(async (slide, index) => {
+      if (!slide.hidden) {
+        return;
+      }
+
+      const path = `ppt/slides/slide${index + 1}.xml`;
+      const xml = await zip.file(path)?.async("string");
+      if (xml) {
+        zip.file(path, pptxSlideXmlWithHiddenState(xml));
+      }
+    })
+  );
+
+  return zip.generateAsync({ type: "blob", mimeType: PPTX_MIME_TYPE });
+}
+
+function pptxSlideXmlWithHiddenState(xml: string) {
+  return xml.replace(/<p:sld\b([^>]*)>/, (_match, attributes: string) => {
+    const withoutShow = attributes.replace(/\sshow="[^"]*"/, "");
+    return `<p:sld${withoutShow} show="0">`;
+  });
+}
+
 function normalizeHexColor(value?: string) {
   const raw = value?.trim().replace(/^#/, "").toUpperCase() ?? "";
   return /^[0-9A-F]{6}$/.test(raw) ? raw : "";
@@ -490,17 +533,26 @@ function numberAttribute(record: Record<string, unknown>, name: string) {
   return Number.isFinite(value) ? value : undefined;
 }
 
+function isFalseXmlBoolean(value: unknown) {
+  const normalized = String(value ?? "").trim().toLowerCase();
+  return normalized === "0" || normalized === "false";
+}
+
 function emuToInches(value: number) {
   return Math.max(0, Math.round((value / emuPerInch) * 1000) / 1000);
 }
 
 async function loadZip(file: File): Promise<ZipArchive> {
-  const moduleName = "jszip";
-  const jsZipModule = (await import(moduleName)) as { default?: { loadAsync: (data: ArrayBuffer) => Promise<ZipArchive> } };
-  const jsZip = jsZipModule.default ?? (jsZipModule as unknown as { loadAsync: (data: ArrayBuffer) => Promise<ZipArchive> });
+  const jsZip = await loadJsZip();
   return jsZip.loadAsync(await readOfficeFileAsArrayBuffer(file));
 }
 
+async function loadJsZip(): Promise<ZipConstructor> {
+  const moduleName = "jszip";
+  const jsZipModule = (await import(moduleName)) as { default?: ZipConstructor } & ZipConstructor;
+  return jsZipModule.default ?? jsZipModule;
+}
+
 async function createXmlParser(): Promise<{ parse: (xml: string) => unknown }> {
   const moduleName = "fast-xml-parser";
   const parserModule = (await import(moduleName)) as { XMLParser: XmlParserConstructor };
diff --git a/src/styles.css b/src/styles.css
index 5976ad5..5eb30eb 100644
--- a/src/styles.css
+++ b/src/styles.css
@@ -927,6 +927,22 @@ button {
   border-color: var(--accent);
 }
 
+.slide-thumb.is-hidden {
+  box-shadow: inset 0 0 0 999px rgb(0 0 0 / 14%);
+}
+
+.slide-hidden-badge {
+  display: inline-flex;
+  align-items: center;
+  gap: 5px;
+  width: fit-content;
+  padding: 3px 7px;
+  border-radius: 999px;
+  background: rgb(255 255 255 / 18%);
+  font-size: 12px;
+  font-weight: 700;
+}
+
 .slide-stage {
   display: grid;
   grid-template-rows: auto minmax(0, 1fr);
@@ -1053,6 +1069,27 @@ button {
   gap: 4px;
 }
 
+.slide-hidden-toggle {
+  grid-template-columns: auto minmax(0, 1fr);
+  align-items: center;
+  gap: 8px 10px;
+}
+
+.slide-hidden-toggle > span:first-child {
+  grid-column: 1 / -1;
+}
+
+.slide-hidden-toggle input[type="checkbox"] {
+  width: 18px;
+  height: 18px;
+  margin: 0;
+}
+
+.slide-hidden-toggle-text {
+  color: var(--text);
+  font-size: 13px;
+}
+
 .danger-command {
   margin-top: 10px;
   border-color: #f3b4b4;
diff --git a/src/types.ts b/src/types.ts
index d4877bd..807b618 100644
--- a/src/types.ts
+++ b/src/types.ts
@@ -86,6 +86,7 @@ export interface Slide {
   subtitle: string;
   notes: string;
   theme: "classic" | "ocean" | "graphite";
+  hidden?: boolean;
   backgroundColor?: string;
   titleColor?: string;
   titleFontSize?: number;