Preserve QExcell hidden sheets in XLSX

README.md

@@ -32,7 +32,7 @@ npm run build
 ## Поддержка форматов
 
 - QWord открывает `.docx` и сохраняет `.docx`; при импорте базовых DOCX-абзацев читает выравнивание, переносы строк, табуляцию, внешние гиперссылки, простые таблицы, базовые растровые изображения, явные цвета текста, подсветку, размер и семейство шрифта из OOXML, а при экспорте DOCX сохраняются заголовки, абзацы, переносы строк, табуляция, выравнивание абзацев, списки, простые таблицы, внешние гиперссылки, базовые растровые изображения и базовое inline-форматирование текста: полужирный, курсив, подчеркивание, зачеркивание, цвет текста, подсветка, размер и семейство шрифта.
-- QExcell открывает `.xlsx` и сохраняет `.xlsx`; сетка расширяется по фактически заполненным ячейкам, поддерживает несколько листов, активный лист через `workbookView activeTab`, формулы за пределами стартового диапазона A-H, shared formulas XLSX с относительными ссылками, базовые merged cells, внешние и внутренние гиперссылки ячеек, базовые диаграммы листа и базовое форматирование ячеек: полужирный, курсив, подчеркивание, зачеркивание, размер и семейство шрифта, прямые RGB/theme/indexed цвета текста с учетом `xl/theme/theme1.xml`, заливку, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы XLSX для дат, процентов, денежных и дробных значений.
+- QExcell открывает `.xlsx` и сохраняет `.xlsx`; сетка расширяется по фактически заполненным ячейкам, поддерживает несколько листов, скрытые и veryHidden листы через `sheet state`, активный лист через `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 слайда, сохраняет заметки докладчика, базовые растровые изображения слайдов, пользовательский цвет фона слайда, а также цвет, размер и семейство шрифта текста заголовка/подзаголовка.
 - 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` пока не реализованы.
 
@@ -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, простые таблицы, несколько листов и активный лист 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` и активный лист 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 в текущем инкременте не заявлены.
 
 ## Сборка пакета
 

src/io/excellOffice.test.ts

@@ -513,6 +513,16 @@ describe("excellOffice OOXML helpers", () => {
       })
     ).toEqual([{ id: "sheet-7", name: "Бюджет", relationshipId: "rId3" }]);
 
+    expect(
+      workbookSheetRefs({
+        workbook: {
+          sheets: {
+            sheet: { name: "Архив", sheetId: "8", "r:id": "rId4", state: "hidden" }
+          }
+        }
+      })
+    ).toEqual([{ id: "sheet-8", name: "Архив", visibility: "hidden", relationshipId: "rId4" }]);
+
     expect(
       workbookRelationshipTargets({
         Relationships: {
@@ -555,6 +565,28 @@ describe("excellOffice OOXML helpers", () => {
     expect(imported.activeSheet).toBe("sheet-2");
   });
 
+  it("сохраняет и импортирует скрытые листы XLSX через sheet state", async () => {
+    const blob = await exportXlsxBlob({
+      id: "book-1",
+      title: "Скрытые листы.xlsx",
+      updatedAt: "2026-06-01T00:00:00.000Z",
+      activeSheet: "sheet-1",
+      sheets: [
+        { id: "sheet-1", name: "Рабочий", cells: { A1: "Открыт" } },
+        { id: "sheet-2", name: "Архив", visibility: "hidden", cells: { A1: "Скрыт" } },
+        { id: "sheet-3", name: "Служебный", visibility: "veryHidden", cells: { A1: "Очень скрыт" } }
+      ]
+    });
+    const zip = await JSZip.loadAsync(await blob.arrayBuffer());
+    const workbookXml = await zip.file("xl/workbook.xml")?.async("string");
+    const imported = await importXlsxFile(new File([blob], "Скрытые листы.xlsx", { type: blob.type }));
+
+    expect(workbookXml).toContain('<sheet name="Архив" sheetId="2" r:id="rId2" state="hidden"/>');
+    expect(workbookXml).toContain('<sheet name="Служебный" sheetId="3" r:id="rId3" state="veryHidden"/>');
+    expect(imported.sheets[1]).toMatchObject({ id: "sheet-2", name: "Архив", visibility: "hidden" });
+    expect(imported.sheets[2]).toMatchObject({ id: "sheet-3", name: "Служебный", visibility: "veryHidden" });
+  });
+
   it("создает OOXML chart part для диаграммы XLSX", () => {
     const xml = buildChartXml(
       {

src/io/excellOffice.ts

@@ -8,6 +8,7 @@ export interface ImportedExcellWorkbook {
   sheets: Array<{
     id: string;
     name: string;
+    visibility?: "hidden" | "veryHidden";
     cells: Record<string, string>;
     mergedCells?: MergedCellRange[];
     hyperlinks?: Record<string, string>;
@@ -47,12 +48,14 @@ type FastXmlParserModule = {
 interface WorkbookSheetRef {
   id: string;
   name: string;
+  visibility?: "hidden" | "veryHidden";
   relationshipId: string;
 }
 
 interface ParsedSheet {
   id: string;
   name: string;
+  visibility?: "hidden" | "veryHidden";
   cells: Record<string, string>;
   mergedCells?: MergedCellRange[];
   hyperlinks?: Record<string, string>;
@@ -224,7 +227,16 @@ export async function exportXlsxBlob(workbook: Workbook): Promise<Blob> {
   zip.file("_rels/.rels", buildRootRelationshipsXml());
   zip.file("docProps/app.xml", buildAppPropertiesXml());
   zip.file("docProps/core.xml", buildCorePropertiesXml());
-  zip.file("xl/workbook.xml", buildWorkbookXml(sheets.map((sheet, index) => sheet.name.trim() || `Лист ${index + 1}`), activeSheetIndex));
+  zip.file(
+    "xl/workbook.xml",
+    buildWorkbookXml(
+      sheets.map((sheet, index) => ({
+        name: sheet.name.trim() || `Лист ${index + 1}`,
+        ...(sheet.visibility ? { visibility: sheet.visibility } : {})
+      })),
+      activeSheetIndex
+    )
+  );
   zip.file("xl/_rels/workbook.xml.rels", buildWorkbookRelationshipsXml(sheets.length));
   zip.file("xl/styles.xml", buildStylesXml(styleRegistry));
 
@@ -267,6 +279,7 @@ export function parsedWorksheetToSheet(
   return {
     id: sheet.id || `sheet-${index + 1}`,
     name: sheet.name || `Лист ${index + 1}`,
+    ...(sheet.visibility ? { visibility: sheet.visibility } : {}),
     cells: worksheetXmlToCells(worksheetXml, sharedStrings),
     mergedCells: worksheetXmlToMergedCells(worksheetXml),
     hyperlinks: worksheetXmlToHyperlinks(worksheetXml, relationshipsXml),
@@ -632,14 +645,28 @@ export function workbookSheetRefs(workbookXml: unknown): WorkbookSheetRef[] {
 
   return toArray(sheets.sheet).map((sheet, index) => {
     const record = asRecord(sheet);
+    const visibility = workbookSheetVisibility(record.state);
     return {
       id: `sheet-${String(record.sheetId || index + 1)}`,
       name: String(record.name || `Лист ${index + 1}`),
+      ...(visibility ? { visibility } : {}),
       relationshipId: String(record["r:id"] || "")
     };
   });
 }
 
+function workbookSheetVisibility(value: unknown): WorkbookSheetRef["visibility"] {
+  const normalized = String(value ?? "").trim().toLowerCase();
+  if (normalized === "hidden") {
+    return "hidden";
+  }
+  if (normalized === "veryhidden") {
+    return "veryHidden";
+  }
+
+  return undefined;
+}
+
 export function workbookActiveSheetId(workbookXml: unknown, sheets: Array<{ id: string }>): string {
   const workbook = childRecord(workbookXml, "workbook");
   const bookViews = childRecord(workbook, "bookViews");
@@ -705,17 +732,18 @@ function buildRootRelationshipsXml() {
   );
 }
 
-function buildWorkbookXml(sheetNames: string[], activeSheetIndex = 0) {
-  const activeTab = Math.min(Math.max(0, activeSheetIndex), Math.max(0, sheetNames.length - 1));
+function buildWorkbookXml(sheets: Array<{ name: string; visibility?: WorkbookSheetRef["visibility"] }>, activeSheetIndex = 0) {
+  const activeTab = Math.min(Math.max(0, activeSheetIndex), Math.max(0, sheets.length - 1));
   const bookViews = `<bookViews><workbookView activeTab="${activeTab}"/></bookViews>`;
-  const sheets = sheetNames
-    .map((name, index) => {
-      return `<sheet name="${escapeXmlAttribute(name)}" sheetId="${index + 1}" r:id="rId${index + 1}"/>`;
+  const sheetXml = sheets
+    .map((sheet, index) => {
+      const visibility = sheet.visibility ? ` state="${sheet.visibility}"` : "";
+      return `<sheet name="${escapeXmlAttribute(sheet.name)}" sheetId="${index + 1}" r:id="rId${index + 1}"${visibility}/>`;
     })
     .join("");
 
   return xmlDeclaration(
-    `<workbook xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships">${bookViews}<sheets>${sheets}</sheets></workbook>`
+    `<workbook xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships">${bookViews}<sheets>${sheetXml}</sheets></workbook>`
   );
 }
 

src/types.ts

@@ -18,6 +18,7 @@ export interface Workbook {
 export interface Sheet {
   id: string;
   name: string;
+  visibility?: "hidden" | "veryHidden";
   cells: Record<string, string>;
   mergedCells?: MergedCellRange[];
   hyperlinks?: Record<string, string>;