@cj-tech-master/excelts 4.2.3 → 5.0.0-canary.20260123012457.1fdf506

package/dist/browser/modules/excel/xlsx/xform/sheet/sheet-format-properties-xform.d.ts

@@ -5,6 +5,7 @@ interface SheetFormatPropertiesModel {
     outlineLevelRow: number;
     outlineLevelCol: number;
     defaultColWidth?: number;
+    customHeight?: boolean;
 }
 declare class SheetFormatPropertiesXform extends BaseXform {
     get tag(): string;

package/dist/browser/modules/excel/xlsx/xform/sheet/sheet-format-properties-xform.js

@@ -11,14 +11,14 @@ class SheetFormatPropertiesXform extends BaseXform {
                 outlineLevelRow: model.outlineLevelRow || undefined,
                 outlineLevelCol: model.outlineLevelCol || undefined,
                 // Only output dyDescent if explicitly set (MS extension, not ECMA-376 standard)
-                "x14ac:dyDescent": model.dyDescent || undefined
+                "x14ac:dyDescent": model.dyDescent !== undefined && model.dyDescent !== 0 ? model.dyDescent : undefined
             };
             // Only output defaultColWidth if explicitly set
             if (model.defaultColWidth) {
                 attributes.defaultColWidth = model.defaultColWidth;
             }
-            // default value for 'defaultRowHeight' is 15, this should not be 'custom'
-            if (!model.defaultRowHeight || model.defaultRowHeight !== 15) {
+            // Only output customHeight if it was present in the original file
+            if (model.customHeight) {
                 attributes.customHeight = "1";
             }
             if (Object.values(attributes).some((value) => value !== undefined)) {
@@ -30,13 +30,18 @@ class SheetFormatPropertiesXform extends BaseXform {
         if (node.name === "sheetFormatPr") {
             this.model = {
                 defaultRowHeight: parseFloat(node.attributes.defaultRowHeight || "0"),
-                dyDescent: parseFloat(node.attributes["x14ac:dyDescent"] || "0"),
+                dyDescent: node.attributes["x14ac:dyDescent"] !== undefined
+                    ? parseFloat(node.attributes["x14ac:dyDescent"])
+                    : undefined,
                 outlineLevelRow: parseInt(node.attributes.outlineLevelRow || "0", 10),
                 outlineLevelCol: parseInt(node.attributes.outlineLevelCol || "0", 10)
             };
             if (node.attributes.defaultColWidth) {
                 this.model.defaultColWidth = parseFloat(node.attributes.defaultColWidth);
             }
+            if (node.attributes.customHeight === "1") {
+                this.model.customHeight = true;
+            }
             return true;
         }
         return false;

package/dist/browser/modules/excel/xlsx/xform/sheet/sheet-view-xform.js

@@ -37,8 +37,8 @@ class SheetViewXform extends BaseXform {
         add("showRuler", "0", model.showRuler === false);
         add("showRowColHeaders", "0", model.showRowColHeaders === false);
         add("showGridLines", "0", model.showGridLines === false);
-        add("zoomScale", model.zoomScale, model.zoomScale);
-        add("zoomScaleNormal", model.zoomScaleNormal, model.zoomScaleNormal);
+        add("zoomScale", model.zoomScale, model.zoomScale !== undefined && model.zoomScale !== 100);
+        add("zoomScaleNormal", model.zoomScaleNormal, model.zoomScaleNormal !== undefined && model.zoomScaleNormal !== 100);
         add("view", model.style, model.style);
         let topLeftCell;
         let xSplit;
@@ -143,6 +143,7 @@ class SheetViewXform extends BaseXform {
                     model = this.model = {
                         workbookViewId: this.sheetView.workbookViewId,
                         rightToLeft: this.sheetView.rightToLeft,
+                        tabSelected: this.sheetView.tabSelected,
                         state: VIEW_STATES[this.pane.state] || "split", // split is default
                         xSplit: this.pane.xSplit,
                         ySplit: this.pane.ySplit,
@@ -168,6 +169,7 @@ class SheetViewXform extends BaseXform {
                     model = this.model = {
                         workbookViewId: this.sheetView.workbookViewId,
                         rightToLeft: this.sheetView.rightToLeft,
+                        tabSelected: this.sheetView.tabSelected,
                         state: "normal",
                         showRuler: this.sheetView.showRuler,
                         showRowColHeaders: this.sheetView.showRowColHeaders,

package/dist/browser/modules/excel/xlsx/xform/sheet/worksheet-xform.js

@@ -188,6 +188,23 @@ class WorkSheetXform extends BaseXform {
                 vmlDrawing: `vmlDrawing${model.id}`
             });
         }
+        // Handle pre-loaded drawing (from file read) that may contain charts or other non-image content
+        // This preserves drawings through round-trip even if they don't contain images
+        // Note: Always assign a new rId since rels are rebuilt during write
+        if (model.drawing && model.drawing.anchors) {
+            // This is a loaded drawing that needs to be added to relationships
+            const drawing = model.drawing;
+            drawing.rId = nextRid(rels);
+            if (!drawing.name) {
+                drawing.name = `drawing${++options.drawingsCount}`;
+            }
+            options.drawings.push(drawing);
+            rels.push({
+                Id: drawing.rId,
+                Type: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/drawing",
+                Target: drawingRelTargetFromWorksheet(drawing.name)
+            });
+        }
         const drawingRelsHash = [];
         let bookImage;
         model.media.forEach(medium => {
@@ -367,7 +384,8 @@ class WorkSheetXform extends BaseXform {
                 defaultRowHeight: model.properties.defaultRowHeight,
                 dyDescent: model.properties.dyDescent,
                 outlineLevelCol: model.properties.outlineLevelCol,
-                outlineLevelRow: model.properties.outlineLevelRow
+                outlineLevelRow: model.properties.outlineLevelRow,
+                customHeight: model.properties.customHeight
             }
             : undefined;
         if (model.properties && model.properties.defaultColWidth) {
@@ -599,17 +617,27 @@ class WorkSheetXform extends BaseXform {
             if (match) {
                 const drawingName = match[1];
                 const drawing = options.drawings[drawingName];
-                drawing.anchors.forEach(anchor => {
-                    if (anchor.medium) {
-                        const image = {
-                            type: "image",
-                            imageId: anchor.medium.index,
-                            range: anchor.range,
-                            hyperlinks: anchor.picture.hyperlinks
-                        };
-                        model.media.push(image);
-                    }
-                });
+                if (drawing) {
+                    // Preserve the drawing object for round-trip (charts, etc.)
+                    // This includes the name, anchors, and rels
+                    model.drawing = {
+                        ...drawing,
+                        name: drawingName,
+                        rels: options.drawingRels?.[drawingName] || drawing.rels || []
+                    };
+                    // Also extract images to model.media for backward compatibility
+                    drawing.anchors.forEach(anchor => {
+                        if (anchor.medium) {
+                            const image = {
+                                type: "image",
+                                imageId: anchor.medium.index,
+                                range: anchor.range,
+                                hyperlinks: anchor.picture.hyperlinks
+                            };
+                            model.media.push(image);
+                        }
+                    });
+                }
             }
         }
         const backgroundRel = model.background && rels[model.background.rId];

package/dist/browser/modules/excel/xlsx/xform/style/style-xform.d.ts

@@ -11,6 +11,13 @@ interface StyleModel {
     protection?: any;
     checkbox?: boolean;
     xfComplementIndex?: number;
+    pivotButton?: boolean;
+    applyNumberFormat?: boolean;
+    applyFont?: boolean;
+    applyFill?: boolean;
+    applyBorder?: boolean;
+    applyAlignment?: boolean;
+    applyProtection?: boolean;
 }
 interface StyleOptions {
     xfId?: boolean;

package/dist/browser/modules/excel/xlsx/xform/style/style-xform.js

@@ -24,24 +24,27 @@ class StyleXform extends BaseXform {
         if (this.xfId) {
             xmlStream.addAttribute("xfId", model.xfId || 0);
         }
-        if (model.numFmtId) {
+        if (model.applyNumberFormat || model.numFmtId) {
             xmlStream.addAttribute("applyNumberFormat", "1");
         }
-        if (model.fontId) {
+        if (model.applyFont || model.fontId) {
             xmlStream.addAttribute("applyFont", "1");
         }
-        if (model.fillId) {
+        if (model.applyFill || model.fillId) {
             xmlStream.addAttribute("applyFill", "1");
         }
-        if (model.borderId) {
+        if (model.applyBorder || model.borderId) {
             xmlStream.addAttribute("applyBorder", "1");
         }
-        if (model.alignment) {
+        if (model.applyAlignment || model.alignment) {
             xmlStream.addAttribute("applyAlignment", "1");
         }
-        if (model.protection) {
+        if (model.applyProtection || model.protection) {
             xmlStream.addAttribute("applyProtection", "1");
         }
+        if (model.pivotButton) {
+            xmlStream.addAttribute("pivotButton", "1");
+        }
         /**
          * Rendering tags causes close of XML stream.
          * Therefore adding attributes must be done before rendering tags.
@@ -82,6 +85,23 @@ class StyleXform extends BaseXform {
                 if (this.xfId) {
                     this.model.xfId = parseInt(node.attributes.xfId, 10);
                 }
+                if (node.attributes.pivotButton === "1") {
+                    this.model.pivotButton = true;
+                }
+                // Preserve apply* flags from original file
+                const applyFlags = [
+                    "applyNumberFormat",
+                    "applyFont",
+                    "applyFill",
+                    "applyBorder",
+                    "applyAlignment",
+                    "applyProtection"
+                ];
+                for (const flag of applyFlags) {
+                    if (node.attributes[flag] === "1") {
+                        this.model[flag] = true;
+                    }
+                }
                 return true;
             case "alignment":
                 this.parser = this.map.alignment;

package/dist/browser/modules/excel/xlsx/xform/style/styles-xform.d.ts

@@ -12,11 +12,17 @@ declare class StylesXform extends BaseXform {
     private index?;
     private weakMap?;
     private _hasCheckboxes?;
+    defaultFont?: any;
     parser: any;
     static Mock: typeof StylesXform;
     constructor(initialise?: boolean);
     initIndex(): void;
     init(): void;
+    /**
+     * Set the default font to use when no font is explicitly specified.
+     * This preserves the original file's default font during round-trip.
+     */
+    setDefaultFont(font: any): void;
     render(xmlStream: any, model?: StylesModel): void;
     parseOpen(node: any): boolean;
     parseText(text: string): void;

package/dist/browser/modules/excel/xlsx/xform/style/styles-xform.js

@@ -84,6 +84,13 @@ class StylesXform extends BaseXform {
         this.weakMap = new WeakMap();
         this._hasCheckboxes = false;
     }
+    /**
+     * Set the default font to use when no font is explicitly specified.
+     * This preserves the original file's default font during round-trip.
+     */
+    setDefaultFont(font) {
+        this.defaultFont = font;
+    }
     render(xmlStream, model) {
         const renderModel = model || this.model;
         //
@@ -100,8 +107,8 @@ class StylesXform extends BaseXform {
                 xmlStream.closeNode();
             }
             if (!renderModel.fonts.length) {
-                // default (zero) font
-                this._addFont({
+                // default (zero) font - use preserved font or fallback to Calibri
+                this._addFont(this.defaultFont || {
                     size: 11,
                     color: { theme: 1 },
                     name: "Calibri",
@@ -193,6 +200,10 @@ class StylesXform extends BaseXform {
                 add("borders", this.map.borders);
                 add("styles", this.map.cellXfs);
                 add("dxfs", this.map.dxfs);
+                // preserve the default (first) font from the original file
+                if (this.map.fonts.model && this.map.fonts.model.length > 0) {
+                    this.defaultFont = this.map.fonts.model[0];
+                }
                 // index numFmts
                 this.index = {
                     model: [],
@@ -220,8 +231,14 @@ class StylesXform extends BaseXform {
         }
         // if we have no default font, add it here now
         if (!this.model.fonts.length) {
-            // default (zero) font
-            this._addFont({ size: 11, color: { theme: 1 }, name: "Calibri", family: 2, scheme: "minor" });
+            // default (zero) font - use preserved font or fallback to Calibri
+            this._addFont(this.defaultFont || {
+                size: 11,
+                color: { theme: 1 },
+                name: "Calibri",
+                family: 2,
+                scheme: "minor"
+            });
         }
         const type = cellType || Enums.ValueType.Number;
         // If we have seen this style object before, assume it has the same styleId.
@@ -262,6 +279,21 @@ class StylesXform extends BaseXform {
         if (model.protection) {
             style.protection = model.protection;
         }
+        // Preserve xf-level attributes (pivotButton, apply* flags)
+        const xfFlags = [
+            "pivotButton",
+            "applyNumberFormat",
+            "applyFont",
+            "applyFill",
+            "applyBorder",
+            "applyAlignment",
+            "applyProtection"
+        ];
+        for (const flag of xfFlags) {
+            if (model[flag]) {
+                style[flag] = true;
+            }
+        }
         if (type === Enums.ValueType.Checkbox) {
             // Checkbox rendering relies on style extensions (extLst) and workbook-level parts.
             // Force applyAlignment="1" (without emitting an <alignment/> node) by providing
@@ -322,6 +354,22 @@ class StylesXform extends BaseXform {
         if (style.protection) {
             model.protection = style.protection;
         }
+        // -------------------------------------------------------
+        // xf-level attributes (pivotButton, apply* flags)
+        const xfFlags = [
+            "pivotButton",
+            "applyNumberFormat",
+            "applyFont",
+            "applyFill",
+            "applyBorder",
+            "applyAlignment",
+            "applyProtection"
+        ];
+        for (const flag of xfFlags) {
+            if (style[flag]) {
+                model[flag] = true;
+            }
+        }
         return model;
     }
     addDxfStyle(style) {

package/dist/browser/modules/excel/xlsx/xlsx.browser.d.ts

@@ -144,6 +144,30 @@ declare class XLSX {
      * This is the foundation for TRUE streaming reads on platforms that have a
      * streaming ZIP parser (e.g. Node.js `modules/archive` Parse).
      */
+    /**
+     * Create an empty model for parsing XLSX files.
+     * Shared by loadFromZipEntries and loadFromFiles.
+     */
+    private createEmptyModel;
+    /**
+     * Collect all data from a stream into a single Uint8Array.
+     * Reusable helper for passthrough and drawing processing.
+     */
+    protected collectStreamData(stream: IParseStream): Promise<Uint8Array>;
+    /**
+     * Check if a drawing has chart references in its relationships
+     */
+    private drawingHasChartReference;
+    /**
+     * Check if a drawing rels list references charts.
+     * Used to decide whether we need to keep raw drawing XML for passthrough.
+     */
+    private drawingRelsHasChartReference;
+    /**
+     * Process a known OOXML entry (workbook, styles, shared strings, etc.)
+     * Returns true if handled, false if should be passed to _processDefaultEntry
+     */
+    protected _processKnownEntry(stream: IParseStream, model: any, entryName: string, options?: XlsxOptions): Promise<boolean>;
     protected loadFromZipEntries(entries: AsyncIterable<ZipEntryLike>, options?: XlsxOptions): Promise<any>;
     /**
      * Write workbook to buffer
@@ -189,8 +213,14 @@ declare class XLSX {
     loadFromFiles(zipData: Record<string, Uint8Array>, options?: any): Promise<any>;
     /**
      * Process default entries (drawings, comments, tables, etc.)
+     * @param rawData Optional raw entry data for passthrough preservation (used by loadFromFiles)
      */
-    protected _processDefaultEntry(stream: IParseStream, model: any, entryName: string): Promise<boolean>;
+    protected _processDefaultEntry(stream: IParseStream, model: any, entryName: string, rawData?: Uint8Array): Promise<boolean>;
+    /**
+     * Store a passthrough file for preservation during read/write cycles.
+     * These files are not parsed but stored as raw bytes to be written back unchanged.
+     */
+    _processPassthroughEntry(stream: IParseStream, model: any, entryName: string): Promise<void>;
     addContentTypes(zip: IZipWriter, model: any): Promise<void>;
     addApp(zip: IZipWriter, model: any): Promise<void>;
     addCore(zip: IZipWriter, model: any): Promise<void>;
@@ -204,6 +234,11 @@ declare class XLSX {
     addWorksheets(zip: IZipWriter, model: any): Promise<void>;
     addDrawings(zip: IZipWriter, model: any): void;
     addTables(zip: IZipWriter, model: any): void;
+    /**
+     * Write passthrough files (charts, etc.) that were preserved during read.
+     * These files are written back unchanged to preserve unsupported features.
+     */
+    addPassthrough(zip: IZipWriter, model: any): void;
     addPivotTables(zip: IZipWriter, model: any): void;
     _finalize(zip: IZipWriter): Promise<this>;
     prepareModel(model: any, options: any): void;