Preserve QExcell hidden rows and columns in XLSX

README.md

@@ -32,7 +32,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`, высоту строк через `row ht/customHeight`, активный лист через `workbookView activeTab`, формулы за пределами стартового диапазона A-H, shared formulas XLSX с относительными ссылками, базовые merged cells, внешние и внутренние гиперссылки ячеек, базовые диаграммы листа и базовое форматирование ячеек: полужирный, курсив, подчеркивание, зачеркивание, размер и семейство шрифта, прямые RGB/theme/indexed цвета текста с учетом `xl/theme/theme1.xml`, заливку, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы XLSX для дат, процентов, денежных и дробных значений.
+- 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 слайда, сохраняет скрытые слайды, переходы слайдов, заметки докладчика, базовые растровые изображения слайдов, пользовательский цвет фона слайда, а также цвет, размер и семейство шрифта текста заголовка/подзаголовка.
 - 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` пока не реализованы.
 
@@ -46,7 +46,7 @@ Desktop-меню поддерживает системные команды дл
 - `Ctrl/Cmd+Shift+E`: экспортировать текущую рабочую область в PDF.
 - `Ctrl/Cmd+P`: печать текущей рабочей области.
 
-Импорт и экспорт реализуют базовую совместимость с Office Open XML, EML и чтением MSG: текст, базовое inline-форматирование, явные `w:br`, `w:br w:type="page"`, `w:tab`, `w:color`, `w:shd`, `w:highlight`, `w:sz`, `w:rFonts` и `w:strike` для переносов строк/разрывов страниц/табуляции/цвета/подсветки/размера/семейства/зачеркивания текста DOCX, выравнивание и отступы абзацев DOCX через `w:jc`/`w:ind`, закладки DOCX через `w:bookmarkStart`/`w:bookmarkEnd`, внешние `w:hyperlink r:id` и внутренние `w:hyperlink w:anchor` гиперссылки DOCX, внешние и внутренние гиперссылки XLSX, базовые растровые изображения DOCX/PPTX, простые таблицы, несколько листов, скрытые/veryHidden листы через `sheet state`, закрепленные области через `sheetViews pane`, скрытие сетки через `sheetView showGridLines`, масштаб листа через `sheetView zoomScale`, автофильтр через `autoFilter ref`, область печати XLSX через `_xlnm.Print_Area`, цвет вкладки листа через `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 через `p:transition` для `fade`/`push`/`wipe`, пользовательский фон слайдов PPTX, цвет, размер и семейство шрифта текста заголовка/подзаголовка PPTX, импорт и экспорт заметок докладчика, адресацию `To/Cc/Bcc/Reply-To`, заголовки цепочки писем `Message-ID`/`In-Reply-To`/`References`, заголовки приоритета `Importance`/`X-Priority`/`Priority`, 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:br w:type="page"`, `w:tab`, `w:color`, `w:shd`, `w:highlight`, `w:sz`, `w:rFonts` и `w:strike` для переносов строк/разрывов страниц/табуляции/цвета/подсветки/размера/семейства/зачеркивания текста DOCX, выравнивание и отступы абзацев DOCX через `w:jc`/`w:ind`, закладки DOCX через `w:bookmarkStart`/`w:bookmarkEnd`, внешние `w:hyperlink r:id` и внутренние `w:hyperlink w:anchor` гиперссылки DOCX, внешние и внутренние гиперссылки XLSX, базовые растровые изображения DOCX/PPTX, простые таблицы, несколько листов, скрытые/veryHidden листы через `sheet state`, закрепленные области через `sheetViews pane`, скрытие сетки через `sheetView showGridLines`, масштаб листа через `sheetView zoomScale`, автофильтр через `autoFilter ref`, область печати XLSX через `_xlnm.Print_Area`, цвет вкладки листа через `sheetPr tabColor`, ширину и скрытие колонок через `cols/col width`/`col hidden`, высоту и скрытие строк через `row ht/customHeight`/`row hidden` и активный лист 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 через `p:transition` для `fade`/`push`/`wipe`, пользовательский фон слайдов PPTX, цвет, размер и семейство шрифта текста заголовка/подзаголовка PPTX, импорт и экспорт заметок докладчика, адресацию `To/Cc/Bcc/Reply-To`, заголовки цепочки писем `Message-ID`/`In-Reply-To`/`References`, заголовки приоритета `Importance`/`X-Priority`/`Priority`, MIME encoded-word заголовки UTF-8/windows-1251, MIME-вложения EML, inline-вложения EML с `Content-ID` и базовые поля одиночных MSG-писем. Сложные стили, макросы, сложные диаграммы, сложное позиционирование и обтекание изображений, PST, экспорт MSG и полная fidelity документов Microsoft Office в текущем инкременте не заявлены.
 
 ## Сборка пакета
 

src/io/excellOffice.test.ts

@@ -25,6 +25,8 @@ import {
   worksheetXmlToCellFormats,
   worksheetXmlToColumnWidths,
   worksheetXmlToFrozenPane,
+  worksheetXmlToHiddenColumns,
+  worksheetXmlToHiddenRows,
   worksheetXmlToHyperlinks,
   worksheetXmlToMergedCells,
   worksheetXmlToRowHeights,
@@ -912,6 +914,62 @@ describe("excellOffice OOXML helpers", () => {
     expect(imported.sheets[0].rowHeights).toEqual({ "1": 24, "4": 30.5 });
   });
 
+  it("читает и записывает скрытые колонки и строки XLSX", async () => {
+    expect(
+      worksheetXmlToHiddenColumns({
+        worksheet: {
+          cols: {
+            col: [
+              { min: "2", max: "3", hidden: "1" },
+              { min: "5", max: "5", width: "12", hidden: "true" }
+            ]
+          }
+        }
+      })
+    ).toEqual({ B: true, C: true, E: true });
+    expect(
+      worksheetXmlToHiddenRows({
+        worksheet: {
+          sheetData: {
+            row: [{ r: "4", hidden: "1" }, { r: "6", ht: "21", hidden: "true" }]
+          }
+        }
+      })
+    ).toEqual({ "4": true, "6": true });
+    expect(buildColumnWidthsXml({ E: 12 }, { B: true, C: true, E: true })).toBe(
+      '<cols><col min="2" max="2" hidden="1"/><col min="3" max="3" hidden="1"/><col min="5" max="5" width="12" customWidth="1" hidden="1"/></cols>'
+    );
+
+    const blob = await exportXlsxBlob({
+      id: "book-1",
+      title: "Hidden rows and columns.xlsx",
+      updatedAt: "2026-06-01T00:00:00.000Z",
+      activeSheet: "sheet-1",
+      sheets: [
+        {
+          id: "sheet-1",
+          name: "Hidden",
+          columnWidths: { E: 12 },
+          rowHeights: { "6": 21 },
+          hiddenColumns: { B: true, C: true, E: true },
+          hiddenRows: { "4": true, "6": true },
+          cells: { A1: "Visible" }
+        }
+      ]
+    });
+    const zip = await JSZip.loadAsync(await blob.arrayBuffer());
+    const sheetXml = (await zip.file("xl/worksheets/sheet1.xml")?.async("string")) ?? "";
+    const imported = await importXlsxFile(new File([blob], "Hidden rows and columns.xlsx", { type: blob.type }));
+
+    expect(sheetXml).toContain(
+      '<cols><col min="2" max="2" hidden="1"/><col min="3" max="3" hidden="1"/><col min="5" max="5" width="12" customWidth="1" hidden="1"/></cols>'
+    );
+    expect(sheetXml).toContain('<row r="4" hidden="1"/>');
+    expect(sheetXml).toContain('<row r="6" ht="21" customHeight="1" hidden="1"/>');
+    expect(imported.sheets[0].hiddenColumns).toEqual({ B: true, C: true, E: true });
+    expect(imported.sheets[0].hiddenRows).toEqual({ "4": true, "6": true });
+  });
+
   it("создает OOXML chart part для диаграммы XLSX", () => {
     const xml = buildChartXml(
       {

src/io/excellOffice.ts

@@ -14,6 +14,8 @@ export interface ImportedExcellWorkbook {
     tabColor?: string;
     columnWidths?: Record<string, number>;
     rowHeights?: Record<string, number>;
+    hiddenColumns?: Record<string, boolean>;
+    hiddenRows?: Record<string, boolean>;
     showGridLines?: boolean;
     zoomScale?: number;
     printArea?: string;
@@ -69,6 +71,8 @@ interface ParsedSheet {
   tabColor?: string;
   columnWidths?: Record<string, number>;
   rowHeights?: Record<string, number>;
+  hiddenColumns?: Record<string, boolean>;
+  hiddenRows?: Record<string, boolean>;
   showGridLines?: boolean;
   zoomScale?: number;
   printArea?: string;
@@ -291,6 +295,8 @@ export async function exportXlsxBlob(workbook: Workbook): Promise<Blob> {
         sheet.tabColor,
         sheet.columnWidths,
         sheet.rowHeights,
+        sheet.hiddenColumns,
+        sheet.hiddenRows,
         sheet.showGridLines,
         sheet.zoomScale
       )
@@ -330,6 +336,8 @@ export function parsedWorksheetToSheet(
   const tabColor = worksheetXmlToTabColor(worksheetXml, themeColors);
   const columnWidths = worksheetXmlToColumnWidths(worksheetXml);
   const rowHeights = worksheetXmlToRowHeights(worksheetXml);
+  const hiddenColumns = worksheetXmlToHiddenColumns(worksheetXml);
+  const hiddenRows = worksheetXmlToHiddenRows(worksheetXml);
   const showGridLines = worksheetXmlToShowGridLines(worksheetXml);
   const zoomScale = worksheetXmlToZoomScale(worksheetXml);
 
@@ -342,6 +350,8 @@ export function parsedWorksheetToSheet(
     ...(tabColor ? { tabColor } : {}),
     ...(Object.keys(columnWidths).length > 0 ? { columnWidths } : {}),
     ...(Object.keys(rowHeights).length > 0 ? { rowHeights } : {}),
+    ...(Object.keys(hiddenColumns).length > 0 ? { hiddenColumns } : {}),
+    ...(Object.keys(hiddenRows).length > 0 ? { hiddenRows } : {}),
     ...(showGridLines === false ? { showGridLines } : {}),
     ...(zoomScale ? { zoomScale } : {}),
     cells: worksheetXmlToCells(worksheetXml, sharedStrings),
@@ -514,6 +524,26 @@ export function worksheetXmlToColumnWidths(worksheetXml: unknown): Record<string
   }, {});
 }
 
+export function worksheetXmlToHiddenColumns(worksheetXml: unknown): Record<string, boolean> {
+  const worksheet = childRecord(worksheetXml, "worksheet");
+  const cols = childRecord(worksheet, "cols");
+
+  return toArray(cols.col).reduce<Record<string, boolean>>((columns, col) => {
+    const record = asRecord(col);
+    const min = positiveIntegerAttribute(record.min);
+    const max = positiveIntegerAttribute(record.max) || min;
+    if (!min || !max || max < min || !booleanAttribute(record.hidden)) {
+      return columns;
+    }
+
+    for (let column = min; column <= max; column += 1) {
+      columns[columnName(column)] = true;
+    }
+
+    return columns;
+  }, {});
+}
+
 export function worksheetXmlToRowHeights(worksheetXml: unknown): Record<string, number> {
   const worksheet = childRecord(worksheetXml, "worksheet");
   const sheetData = childRecord(worksheet, "sheetData");
@@ -530,6 +560,21 @@ export function worksheetXmlToRowHeights(worksheetXml: unknown): Record<string,
   }, {});
 }
 
+export function worksheetXmlToHiddenRows(worksheetXml: unknown): Record<string, boolean> {
+  const worksheet = childRecord(worksheetXml, "worksheet");
+  const sheetData = childRecord(worksheet, "sheetData");
+
+  return toArray(sheetData.row).reduce<Record<string, boolean>>((rows, row, index) => {
+    const record = asRecord(row);
+    const rowNumber = positiveIntegerAttribute(record.r) || index + 1;
+    if (booleanAttribute(record.hidden)) {
+      rows[String(rowNumber)] = true;
+    }
+
+    return rows;
+  }, {});
+}
+
 async function worksheetXmlToCharts(
   zip: ZipInstance,
   parser: InstanceType<XmlParserConstructor>,
@@ -706,10 +751,13 @@ export function buildWorksheetXml(
   tabColor?: string,
   columnWidths: Record<string, number> = {},
   rowHeights: Record<string, number> = {},
+  hiddenColumns: Record<string, boolean> = {},
+  hiddenRows: Record<string, boolean> = {},
   showGridLines?: boolean,
   zoomScale?: number
 ) {
   const normalizedRowHeights = normalizedSheetRowHeights(rowHeights);
+  const normalizedHiddenRows = normalizedSheetHiddenRows(hiddenRows);
   const rows = sortedWorksheetEntries(cells, cellFormats).reduce<Record<number, Array<[string, string]>>>((grouped, entry) => {
     const rowNumber = cellRowNumber(entry[0]);
     if (!grouped[rowNumber]) {
@@ -724,11 +772,17 @@ export function buildWorksheetXml(
       rows[row] = [];
     }
   });
+  Object.keys(normalizedHiddenRows).forEach((rowNumber) => {
+    const row = positiveIntegerAttribute(rowNumber);
+    if (row && !rows[row]) {
+      rows[row] = [];
+    }
+  });
 
   const rowXml = Object.entries(rows)
     .map(([rowNumber, entries]) => {
       const cellXml = entries.map(([address, value]) => buildCellXml(address, value, cellStyleId(cellFormats[address], styleRegistry))).join("");
-      const rowAttributes = buildRowHeightAttributes(normalizedRowHeights[rowNumber]);
+      const rowAttributes = buildRowAttributes(normalizedRowHeights[rowNumber], normalizedHiddenRows[rowNumber]);
       return cellXml ? `<row r="${rowNumber}"${rowAttributes}>${cellXml}</row>` : `<row r="${rowNumber}"${rowAttributes}/>`;
     })
     .join("");
@@ -739,7 +793,7 @@ export function buildWorksheetXml(
   const drawingXml = drawingRelationshipId ? `<drawing r:id="${escapeXmlAttribute(drawingRelationshipId)}"/>` : "";
   const sheetPrXml = buildSheetPrXml(tabColor);
   const sheetViewsXml = buildSheetViewsXml(frozenPane, showGridLines, zoomScale);
-  const colsXml = buildColumnWidthsXml(columnWidths);
+  const colsXml = buildColumnWidthsXml(columnWidths, hiddenColumns);
 
   return xmlDeclaration(
     `<worksheet xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships">${sheetPrXml}${sheetViewsXml}${colsXml}<sheetData>${rowXml}</sheetData>${autoFilterXml}${mergeCellsXml}${hyperlinksXml}${drawingXml}</worksheet>`
@@ -835,16 +889,23 @@ export function buildSheetPrXml(tabColor?: string) {
   return color ? `<sheetPr><tabColor rgb="FF${color}"/></sheetPr>` : "";
 }
 
-export function buildColumnWidthsXml(columnWidths: Record<string, number> = {}) {
+export function buildColumnWidthsXml(columnWidths: Record<string, number> = {}, hiddenColumns: Record<string, boolean> = {}) {
-  const columns = normalizedSheetColumnWidths(columnWidths);
+  const columnsByNumber = new Map<number, { width?: number; hidden?: boolean }>();
+  normalizedSheetColumnWidths(columnWidths).forEach(({ column, width }) => {
+    columnsByNumber.set(column, { ...columnsByNumber.get(column), width });
+  });
+  normalizedSheetHiddenColumns(hiddenColumns).forEach((column) => {
+    columnsByNumber.set(column, { ...columnsByNumber.get(column), hidden: true });
+  });
+  const columns = Array.from(columnsByNumber.entries()).sort(([first], [second]) => first - second);
   if (columns.length === 0) {
     return "";
   }
 
   const xml = columns
     .map(
-      ({ column, width }) =>
+      ([column, options]) =>
-        `<col min="${column}" max="${column}" width="${formatSheetDimension(width)}" customWidth="1"/>`
+        `<col min="${column}" max="${column}"${options.width ? ` width="${formatSheetDimension(options.width)}" customWidth="1"` : ""}${options.hidden ? ' hidden="1"' : ""}/>`
     )
     .join("");
 
@@ -1628,6 +1689,24 @@ function normalizedSheetRowHeights(rowHeights: Record<string, number> = {}) {
   }, {});
 }
 
+function normalizedSheetHiddenColumns(hiddenColumns: Record<string, boolean> = {}) {
+  return Object.entries(hiddenColumns)
+    .map(([column, hidden]) => (hidden ? columnAddressNumber(column) : 0))
+    .filter((column, index, columns): column is number => Boolean(column) && columns.indexOf(column) === index)
+    .sort((first, second) => first - second);
+}
+
+function normalizedSheetHiddenRows(hiddenRows: Record<string, boolean> = {}) {
+  return Object.entries(hiddenRows).reduce<Record<string, boolean>>((rows, [row, hidden]) => {
+    const rowNumber = positiveIntegerAttribute(row);
+    if (rowNumber && hidden) {
+      rows[String(rowNumber)] = true;
+    }
+
+    return rows;
+  }, {});
+}
+
 function normalizedSheetZoomScale(value: unknown) {
   const number = Number(value);
   if (!Number.isFinite(number)) {
@@ -1638,8 +1717,8 @@ function normalizedSheetZoomScale(value: unknown) {
   return zoomScale >= 10 && zoomScale <= 400 && zoomScale !== 100 ? zoomScale : 0;
 }
 
-function buildRowHeightAttributes(height?: number) {
+function buildRowAttributes(height?: number, hidden?: boolean) {
-  return height ? ` ht="${formatSheetDimension(height)}" customHeight="1"` : "";
+  return `${height ? ` ht="${formatSheetDimension(height)}" customHeight="1"` : ""}${hidden ? ' hidden="1"' : ""}`;
 }
 
 function formatSheetDimension(value: number) {

src/types.ts

@@ -24,6 +24,8 @@ export interface Sheet {
   tabColor?: string;
   columnWidths?: Record<string, number>;
   rowHeights?: Record<string, number>;
+  hiddenColumns?: Record<string, boolean>;
+  hiddenRows?: Record<string, boolean>;
   showGridLines?: boolean;
   zoomScale?: number;
   printArea?: string;