Preserve QExcell worksheet zoom in XLSX

src/io/excellOffice.test.ts

@@ -29,6 +29,7 @@ import {
   worksheetXmlToRowHeights,
   worksheetXmlToShowGridLines,
   worksheetXmlToTabColor,
+  worksheetXmlToZoomScale,
   xlsxStylesXmlToCellFormatTable,
   xlsxThemeXmlToColors,
   xlsxCellToText
@@ -688,6 +689,52 @@ describe("excellOffice OOXML helpers", () => {
     expect(imported.sheets[0].showGridLines).toBe(false);
   });
 
+  it("читает и записывает масштаб листа XLSX через sheetView zoomScale", async () => {
+    expect(
+      worksheetXmlToZoomScale({
+        worksheet: {
+          sheetViews: {
+            sheetView: { zoomScale: "125" }
+          }
+        }
+      })
+    ).toBe(125);
+    expect(
+      worksheetXmlToZoomScale({
+        worksheet: {
+          sheetViews: {
+            sheetView: { zoomScale: "100" }
+          }
+        }
+      })
+    ).toBe(0);
+    expect(buildSheetViewsXml(undefined, undefined, 125)).toBe('<sheetViews><sheetView workbookViewId="0" zoomScale="125"/></sheetViews>');
+    expect(buildSheetViewsXml({ columns: 1 }, false, 90)).toBe(
+      '<sheetViews><sheetView workbookViewId="0" showGridLines="0" zoomScale="90"><pane xSplit="1" topLeftCell="B1" activePane="topRight" state="frozen"/></sheetView></sheetViews>'
+    );
+
+    const blob = await exportXlsxBlob({
+      id: "book-1",
+      title: "Zoom.xlsx",
+      updatedAt: "2026-06-01T00:00:00.000Z",
+      activeSheet: "sheet-1",
+      sheets: [
+        {
+          id: "sheet-1",
+          name: "Zoom",
+          zoomScale: 125,
+          cells: { A1: "Zoomed" }
+        }
+      ]
+    });
+    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], "Zoom.xlsx", { type: blob.type }));
+
+    expect(sheetXml).toContain('<sheetViews><sheetView workbookViewId="0" zoomScale="125"/></sheetViews>');
+    expect(imported.sheets[0].zoomScale).toBe(125);
+  });
+
   it("читает и записывает автофильтр XLSX через autoFilter ref", async () => {
     expect(
       worksheetXmlToAutoFilter({

src/io/excellOffice.ts

@@ -15,6 +15,7 @@ export interface ImportedExcellWorkbook {
     columnWidths?: Record<string, number>;
     rowHeights?: Record<string, number>;
     showGridLines?: boolean;
+    zoomScale?: number;
     cells: Record<string, string>;
     mergedCells?: MergedCellRange[];
     hyperlinks?: Record<string, string>;
@@ -68,6 +69,7 @@ interface ParsedSheet {
   columnWidths?: Record<string, number>;
   rowHeights?: Record<string, number>;
   showGridLines?: boolean;
+  zoomScale?: number;
   cells: Record<string, string>;
   mergedCells?: MergedCellRange[];
   hyperlinks?: Record<string, string>;
@@ -276,7 +278,8 @@ export async function exportXlsxBlob(workbook: Workbook): Promise<Blob> {
         sheet.tabColor,
         sheet.columnWidths,
         sheet.rowHeights,
-        sheet.showGridLines
+        sheet.showGridLines,
+        sheet.zoomScale
       )
     );
     const relationshipsXml = buildWorksheetRelationshipsXml(
@@ -315,6 +318,7 @@ export function parsedWorksheetToSheet(
   const columnWidths = worksheetXmlToColumnWidths(worksheetXml);
   const rowHeights = worksheetXmlToRowHeights(worksheetXml);
   const showGridLines = worksheetXmlToShowGridLines(worksheetXml);
+  const zoomScale = worksheetXmlToZoomScale(worksheetXml);
 
   return {
     id: sheet.id || `sheet-${index + 1}`,
@@ -326,6 +330,7 @@ export function parsedWorksheetToSheet(
     ...(Object.keys(columnWidths).length > 0 ? { columnWidths } : {}),
     ...(Object.keys(rowHeights).length > 0 ? { rowHeights } : {}),
     ...(showGridLines === false ? { showGridLines } : {}),
+    ...(zoomScale ? { zoomScale } : {}),
     cells: worksheetXmlToCells(worksheetXml, sharedStrings),
     mergedCells: worksheetXmlToMergedCells(worksheetXml),
     hyperlinks: worksheetXmlToHyperlinks(worksheetXml, relationshipsXml),
@@ -456,6 +461,13 @@ export function worksheetXmlToShowGridLines(worksheetXml: unknown): boolean | un
   return !isFalseXmlBoolean(value);
 }
 
+export function worksheetXmlToZoomScale(worksheetXml: unknown) {
+  const worksheet = childRecord(worksheetXml, "worksheet");
+  const sheetViews = childRecord(worksheet, "sheetViews");
+  const sheetView = asRecord(toArray(sheetViews.sheetView)[0]);
+  return normalizedSheetZoomScale(sheetView.zoomScale);
+}
+
 export function worksheetXmlToAutoFilter(worksheetXml: unknown) {
   const worksheet = childRecord(worksheetXml, "worksheet");
   const autoFilter = childRecord(worksheet, "autoFilter");
@@ -681,7 +693,8 @@ export function buildWorksheetXml(
   tabColor?: string,
   columnWidths: Record<string, number> = {},
   rowHeights: Record<string, number> = {},
-  showGridLines?: boolean
+  showGridLines?: boolean,
+  zoomScale?: number
 ) {
   const normalizedRowHeights = normalizedSheetRowHeights(rowHeights);
   const rows = sortedWorksheetEntries(cells, cellFormats).reduce<Record<number, Array<[string, string]>>>((grouped, entry) => {
@@ -712,7 +725,7 @@ export function buildWorksheetXml(
   const hyperlinksXml = buildHyperlinksXml(hyperlinks);
   const drawingXml = drawingRelationshipId ? `<drawing r:id="${escapeXmlAttribute(drawingRelationshipId)}"/>` : "";
   const sheetPrXml = buildSheetPrXml(tabColor);
-  const sheetViewsXml = buildSheetViewsXml(frozenPane, showGridLines);
+  const sheetViewsXml = buildSheetViewsXml(frozenPane, showGridLines, zoomScale);
   const colsXml = buildColumnWidthsXml(columnWidths);
 
   return xmlDeclaration(
@@ -773,13 +786,20 @@ export function buildHyperlinksXml(hyperlinks: Record<string, string> = {}) {
   return `<hyperlinks>${hyperlinkXml}</hyperlinks>`;
 }
 
-export function buildSheetViewsXml(frozenPane?: SheetFrozenPane, showGridLines?: boolean) {
+export function buildSheetViewsXml(frozenPane?: SheetFrozenPane, showGridLines?: boolean, zoomScale?: number) {
   const pane = normalizedFrozenPane(frozenPane);
-  if (!pane && showGridLines !== false) {
+  const normalizedZoomScale = normalizedSheetZoomScale(zoomScale);
+  if (!pane && showGridLines !== false && !normalizedZoomScale) {
     return "";
   }
 
-  const sheetViewAttributes = ["workbookViewId=\"0\"", showGridLines === false ? 'showGridLines="0"' : ""].filter(Boolean).join(" ");
+  const sheetViewAttributes = [
+    "workbookViewId=\"0\"",
+    showGridLines === false ? 'showGridLines="0"' : "",
+    normalizedZoomScale ? `zoomScale="${normalizedZoomScale}"` : ""
+  ]
+    .filter(Boolean)
+    .join(" ");
   if (!pane) {
     return `<sheetViews><sheetView ${sheetViewAttributes}/></sheetViews>`;
   }
@@ -1545,6 +1565,16 @@ function normalizedSheetRowHeights(rowHeights: Record<string, number> = {}) {
   }, {});
 }
 
+function normalizedSheetZoomScale(value: unknown) {
+  const number = Number(value);
+  if (!Number.isFinite(number)) {
+    return 0;
+  }
+
+  const zoomScale = Math.round(number);
+  return zoomScale >= 10 && zoomScale <= 400 && zoomScale !== 100 ? zoomScale : 0;
+}
+
 function buildRowHeightAttributes(height?: number) {
   return height ? ` ht="${formatSheetDimension(height)}" customHeight="1"` : "";
 }

src/types.ts

@@ -25,6 +25,7 @@ export interface Sheet {
   columnWidths?: Record<string, number>;
   rowHeights?: Record<string, number>;
   showGridLines?: boolean;
+  zoomScale?: number;
   cells: Record<string, string>;
   mergedCells?: MergedCellRange[];
   hyperlinks?: Record<string, string>;