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

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

@@ -11,6 +11,8 @@ export interface ColumnDefn {
     outlineLevel?: number;
     hidden?: boolean;
     style?: Partial<Style>;
+    /** Whether the column width is auto-fitted to content */
+    bestFit?: boolean;
 }
 export interface ColumnModel {
     min: number;
@@ -21,6 +23,7 @@ export interface ColumnModel {
     hidden?: boolean;
     outlineLevel?: number;
     collapsed?: boolean;
+    bestFit?: boolean;
 }
 /**
  * Column defines the column properties for 1 column.
@@ -36,6 +39,8 @@ declare class Column {
     width?: number;
     private _hidden;
     private _outlineLevel;
+    /** Whether the column width is auto-fitted to content */
+    bestFit?: boolean;
     /** Styles applied to the column */
     style: Partial<Style>;
     constructor(worksheet: Worksheet, number: number, defn?: ColumnDefn | false);

package/dist/browser/modules/excel/column.js

@@ -38,7 +38,8 @@ class Column {
             width: this.width,
             style: this.style,
             hidden: this.hidden,
-            outlineLevel: this.outlineLevel
+            outlineLevel: this.outlineLevel,
+            bestFit: this.bestFit
         };
     }
     set defn(value) {
@@ -55,6 +56,7 @@ class Column {
             // headers must be set after style
             this.header = value.header;
             this._hidden = !!value.hidden;
+            this.bestFit = value.bestFit;
         }
         else {
             delete this._header;
@@ -62,6 +64,7 @@ class Column {
             delete this.width;
             this.style = {};
             this.outlineLevel = 0;
+            delete this.bestFit;
         }
     }
     /**
@@ -151,6 +154,7 @@ class Column {
         return (this.width === model.width &&
             this.hidden === model.hidden &&
             this.outlineLevel === model.outlineLevel &&
+            this.bestFit === model.bestFit &&
             isEqual(this.style, model.style));
     }
     get isDefault() {
@@ -163,6 +167,9 @@ class Column {
         if (this.outlineLevel) {
             return false;
         }
+        if (this.bestFit) {
+            return false;
+        }
         const s = this.style;
         if (s && (s.font || s.numFmt || s.alignment || s.border || s.fill || s.protection)) {
             return false;
@@ -313,7 +320,8 @@ class Column {
                         isCustomWidth: column.isCustomWidth,
                         hidden: column.hidden,
                         outlineLevel: column.outlineLevel,
-                        collapsed: column.collapsed
+                        collapsed: column.collapsed,
+                        bestFit: column.bestFit
                     };
                     cols.push(col);
                 }

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

@@ -15,6 +15,7 @@ export interface RowModel {
     hidden: boolean;
     outlineLevel: number;
     collapsed: boolean;
+    dyDescent?: number;
 }
 declare class Row {
     private _worksheet;
@@ -24,6 +25,7 @@ declare class Row {
     private _hidden?;
     private _outlineLevel?;
     height?: number;
+    dyDescent?: number;
     constructor(worksheet: Worksheet, number: number);
     /**
      * The row number

package/dist/browser/modules/excel/row.js

@@ -388,7 +388,8 @@ class Row {
                 style: this.style,
                 hidden: this.hidden,
                 outlineLevel: this.outlineLevel,
-                collapsed: this.collapsed
+                collapsed: this.collapsed,
+                dyDescent: this.dyDescent
             }
             : null;
     }
@@ -435,6 +436,7 @@ class Row {
         }
         this.hidden = value.hidden;
         this.outlineLevel = value.outlineLevel || 0;
+        this.dyDescent = value.dyDescent;
         this.style = (value.style && JSON.parse(JSON.stringify(value.style))) || {};
     }
 }

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

@@ -59,6 +59,8 @@ export interface WorkbookModel {
     passthrough?: Record<string, Uint8Array>;
     /** Raw drawing XML data for passthrough (when drawing contains chart references) */
     rawDrawings?: Record<string, Uint8Array>;
+    /** Default font preserved from the original file for round-trip fidelity */
+    defaultFont?: any;
 }
 declare class Workbook {
     /**
@@ -102,6 +104,8 @@ declare class Workbook {
     private _passthrough;
     /** Raw drawing XML data for passthrough (when drawing contains chart references) */
     private _rawDrawings;
+    /** Default font preserved from original file for round-trip fidelity */
+    private _defaultFont?;
     private _xlsx?;
     private _csv?;
     constructor();

package/dist/browser/modules/excel/workbook.js

@@ -255,7 +255,8 @@ class Workbook {
             pivotTables: this.pivotTables,
             calcProperties: this.calcProperties,
             passthrough: this._passthrough,
-            rawDrawings: this._rawDrawings
+            rawDrawings: this._rawDrawings,
+            defaultFont: this._defaultFont
         };
     }
     set model(value) {
@@ -300,6 +301,8 @@ class Workbook {
         this._passthrough = value.passthrough || {};
         // Preserve raw drawing data for drawings with chart references
         this._rawDrawings = value.rawDrawings || {};
+        // Preserve default font for round-trip fidelity
+        this._defaultFont = value.defaultFont;
     }
 }
 // ===========================================================================

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

@@ -72,6 +72,7 @@ interface ParsedPivotTableModel {
     chartFormat?: number;
     rowItems?: RowColItem[];
     colItems?: RowColItem[];
+    hasColFields?: boolean;
     chartFormats?: ChartFormatItem[];
     isLoaded?: boolean;
     extensions?: any[];

package/dist/browser/modules/excel/xlsx/xform/pivot-table/pivot-table-xform.js

@@ -245,18 +245,21 @@ class PivotTableXform extends BaseXform {
             xmlStream.writeXml('<rowItems count="1"><i t="grand"><x/></i></rowItems>');
         }
         // Col fields
-        // Excel commonly emits a synthetic field x=-2 when there are no column fields.
-        const colFieldCount = model.colFields.length === 0 ? 1 : model.colFields.length;
-        xmlStream.openNode("colFields", { count: colFieldCount });
-        if (model.colFields.length === 0) {
-            xmlStream.leafNode("field", { x: -2 });
-        }
-        else {
-            for (const fieldIndex of model.colFields) {
-                xmlStream.leafNode("field", { x: fieldIndex });
+        // Only render colFields if it was present in the original file or if there are actual column fields
+        // Some pivot tables don't have colFields element at all
+        if (model.hasColFields || model.colFields.length > 0) {
+            const colFieldCount = model.colFields.length === 0 ? 1 : model.colFields.length;
+            xmlStream.openNode("colFields", { count: colFieldCount });
+            if (model.colFields.length === 0) {
+                xmlStream.leafNode("field", { x: -2 });
+            }
+            else {
+                for (const fieldIndex of model.colFields) {
+                    xmlStream.leafNode("field", { x: fieldIndex });
+                }
             }
+            xmlStream.closeNode();
         }
-        xmlStream.closeNode();
         // Col items - use parsed items if available
         if (model.colItems && model.colItems.length > 0) {
             xmlStream.openNode("colItems", { count: model.colItems.length });
@@ -459,6 +462,10 @@ class PivotTableXform extends BaseXform {
                 break;
             case "colFields":
                 this.state.inColFields = true;
+                // Track that colFields element was present in original file
+                if (this.model) {
+                    this.model.hasColFields = true;
+                }
                 break;
             case "dataFields":
                 this.state.inDataFields = true;

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

@@ -14,6 +14,7 @@ interface RowModel {
     outlineLevel?: number;
     collapsed?: boolean;
     style?: any;
+    dyDescent?: number;
 }
 declare class RowXform extends BaseXform {
     private maxItems?;

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

@@ -48,7 +48,10 @@ class RowXform extends BaseXform {
             xmlStream.addAttribute("s", model.styleId);
             xmlStream.addAttribute("customFormat", "1");
         }
-        // Note: dyDescent is MS extension, not output by default (Excel auto-calculates)
+        // Output dyDescent if present (MS extension for font descent)
+        if (model.dyDescent !== undefined) {
+            xmlStream.addAttribute("x14ac:dyDescent", model.dyDescent);
+        }
         if (model.outlineLevel) {
             xmlStream.addAttribute("outlineLevel", model.outlineLevel);
         }
@@ -99,6 +102,9 @@ class RowXform extends BaseXform {
             if (parseBoolean(node.attributes.collapsed)) {
                 model.collapsed = true;
             }
+            if (node.attributes["x14ac:dyDescent"] !== undefined) {
+                model.dyDescent = parseFloat(node.attributes["x14ac:dyDescent"]);
+            }
             return true;
         }
         this.parser = this.map[node.name];

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

@@ -384,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) {

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.js

@@ -600,6 +600,8 @@ class XLSX {
         delete model.sharedStrings;
         delete model.workbookRels;
         delete model.sheetDefs;
+        // Preserve default font before deleting styles
+        model.defaultFont = model.styles?.defaultFont;
         delete model.styles;
         delete model.mediaIndex;
         delete model.drawings;
@@ -1235,7 +1237,12 @@ class XLSX {
             options.useSharedStrings !== undefined ? options.useSharedStrings : true;
         model.useStyles = options.useStyles !== undefined ? options.useStyles : true;
         model.sharedStrings = new SharedStringsXform();
+        // Preserve default font from parsed styles if available
+        const oldDefaultFont = model.defaultFont;
         model.styles = model.useStyles ? new StylesXform(true) : new StylesXform.Mock();
+        if (oldDefaultFont && model.styles.setDefaultFont) {
+            model.styles.setDefaultFont(oldDefaultFont);
+        }
         const workbookXform = new WorkbookXform();
         const worksheetXform = new WorkSheetXform();
         workbookXform.prepare(model);

package/dist/cjs/modules/excel/column.js

@@ -41,7 +41,8 @@ class Column {
             width: this.width,
             style: this.style,
             hidden: this.hidden,
-            outlineLevel: this.outlineLevel
+            outlineLevel: this.outlineLevel,
+            bestFit: this.bestFit
         };
     }
     set defn(value) {
@@ -58,6 +59,7 @@ class Column {
             // headers must be set after style
             this.header = value.header;
             this._hidden = !!value.hidden;
+            this.bestFit = value.bestFit;
         }
         else {
             delete this._header;
@@ -65,6 +67,7 @@ class Column {
             delete this.width;
             this.style = {};
             this.outlineLevel = 0;
+            delete this.bestFit;
         }
     }
     /**
@@ -154,6 +157,7 @@ class Column {
         return (this.width === model.width &&
             this.hidden === model.hidden &&
             this.outlineLevel === model.outlineLevel &&
+            this.bestFit === model.bestFit &&
             (0, under_dash_1.isEqual)(this.style, model.style));
     }
     get isDefault() {
@@ -166,6 +170,9 @@ class Column {
         if (this.outlineLevel) {
             return false;
         }
+        if (this.bestFit) {
+            return false;
+        }
         const s = this.style;
         if (s && (s.font || s.numFmt || s.alignment || s.border || s.fill || s.protection)) {
             return false;
@@ -316,7 +323,8 @@ class Column {
                         isCustomWidth: column.isCustomWidth,
                         hidden: column.hidden,
                         outlineLevel: column.outlineLevel,
-                        collapsed: column.collapsed
+                        collapsed: column.collapsed,
+                        bestFit: column.bestFit
                     };
                     cols.push(col);
                 }

package/dist/cjs/modules/excel/row.js

@@ -391,7 +391,8 @@ class Row {
                 style: this.style,
                 hidden: this.hidden,
                 outlineLevel: this.outlineLevel,
-                collapsed: this.collapsed
+                collapsed: this.collapsed,
+                dyDescent: this.dyDescent
             }
             : null;
     }
@@ -438,6 +439,7 @@ class Row {
         }
         this.hidden = value.hidden;
         this.outlineLevel = value.outlineLevel || 0;
+        this.dyDescent = value.dyDescent;
         this.style = (value.style && JSON.parse(JSON.stringify(value.style))) || {};
     }
 }

package/dist/cjs/modules/excel/workbook.js

@@ -258,7 +258,8 @@ class Workbook {
             pivotTables: this.pivotTables,
             calcProperties: this.calcProperties,
             passthrough: this._passthrough,
-            rawDrawings: this._rawDrawings
+            rawDrawings: this._rawDrawings,
+            defaultFont: this._defaultFont
         };
     }
     set model(value) {
@@ -303,6 +304,8 @@ class Workbook {
         this._passthrough = value.passthrough || {};
         // Preserve raw drawing data for drawings with chart references
         this._rawDrawings = value.rawDrawings || {};
+        // Preserve default font for round-trip fidelity
+        this._defaultFont = value.defaultFont;
     }
 }
 exports.Workbook = Workbook;