@cj-tech-master/excelts 2.0.1 → 3.0.0-canary.20251228183403.d3eb98d

package/dist/cjs/xlsx/xform/style/font-xform.js

@@ -12,35 +12,48 @@ class FontXform extends base_xform_1.BaseXform {
     constructor(options) {
         super();
         this.options = options || FontXform.OPTIONS;
-        this.map = {
-            b: { prop: "bold", xform: new boolean_xform_1.BooleanXform({ tag: "b", attr: "val" }) },
-            i: { prop: "italic", xform: new boolean_xform_1.BooleanXform({ tag: "i", attr: "val" }) },
-            u: { prop: "underline", xform: new underline_xform_1.UnderlineXform() },
-            charset: { prop: "charset", xform: new integer_xform_1.IntegerXform({ tag: "charset", attr: "val" }) },
-            color: { prop: "color", xform: new color_xform_1.ColorXform() },
-            condense: { prop: "condense", xform: new boolean_xform_1.BooleanXform({ tag: "condense", attr: "val" }) },
-            extend: { prop: "extend", xform: new boolean_xform_1.BooleanXform({ tag: "extend", attr: "val" }) },
-            family: { prop: "family", xform: new integer_xform_1.IntegerXform({ tag: "family", attr: "val" }) },
-            outline: { prop: "outline", xform: new boolean_xform_1.BooleanXform({ tag: "outline", attr: "val" }) },
-            vertAlign: { prop: "vertAlign", xform: new string_xform_1.StringXform({ tag: "vertAlign", attr: "val" }) },
-            scheme: { prop: "scheme", xform: new string_xform_1.StringXform({ tag: "scheme", attr: "val" }) },
-            shadow: { prop: "shadow", xform: new boolean_xform_1.BooleanXform({ tag: "shadow", attr: "val" }) },
-            strike: { prop: "strike", xform: new boolean_xform_1.BooleanXform({ tag: "strike", attr: "val" }) },
-            sz: { prop: "size", xform: new integer_xform_1.IntegerXform({ tag: "sz", attr: "val" }) }
-        };
-        this.map[this.options.fontNameTag] = {
-            prop: "name",
-            xform: new string_xform_1.StringXform({ tag: this.options.fontNameTag, attr: "val" })
-        };
+        // Define properties in render order (Excel's expected order)
+        const fontProperties = [
+            { tag: "b", prop: "bold", xform: new boolean_xform_1.BooleanXform({ tag: "b", attr: "val" }) },
+            { tag: "i", prop: "italic", xform: new boolean_xform_1.BooleanXform({ tag: "i", attr: "val" }) },
+            { tag: "u", prop: "underline", xform: new underline_xform_1.UnderlineXform() },
+            { tag: "strike", prop: "strike", xform: new boolean_xform_1.BooleanXform({ tag: "strike", attr: "val" }) },
+            {
+                tag: "condense",
+                prop: "condense",
+                xform: new boolean_xform_1.BooleanXform({ tag: "condense", attr: "val" })
+            },
+            { tag: "extend", prop: "extend", xform: new boolean_xform_1.BooleanXform({ tag: "extend", attr: "val" }) },
+            { tag: "outline", prop: "outline", xform: new boolean_xform_1.BooleanXform({ tag: "outline", attr: "val" }) },
+            { tag: "shadow", prop: "shadow", xform: new boolean_xform_1.BooleanXform({ tag: "shadow", attr: "val" }) },
+            { tag: "sz", prop: "size", xform: new integer_xform_1.IntegerXform({ tag: "sz", attr: "val" }) },
+            { tag: "color", prop: "color", xform: new color_xform_1.ColorXform() },
+            {
+                tag: this.options.fontNameTag,
+                prop: "name",
+                xform: new string_xform_1.StringXform({ tag: this.options.fontNameTag, attr: "val" })
+            },
+            { tag: "family", prop: "family", xform: new integer_xform_1.IntegerXform({ tag: "family", attr: "val" }) },
+            { tag: "scheme", prop: "scheme", xform: new string_xform_1.StringXform({ tag: "scheme", attr: "val" }) },
+            { tag: "charset", prop: "charset", xform: new integer_xform_1.IntegerXform({ tag: "charset", attr: "val" }) },
+            {
+                tag: "vertAlign",
+                prop: "vertAlign",
+                xform: new string_xform_1.StringXform({ tag: "vertAlign", attr: "val" })
+            }
+        ];
+        // Build map and renderOrder from single source of truth
+        this.map = Object.fromEntries(fontProperties.map(p => [p.tag, { prop: p.prop, xform: p.xform }]));
+        this.renderOrder = fontProperties.map(p => p.tag);
     }
     get tag() {
         return this.options.tagName;
     }
     render(xmlStream, model) {
-        const { map } = this;
+        const { map, renderOrder } = this;
         xmlStream.openNode(this.options.tagName);
-        Object.entries(this.map).forEach(([tag, defn]) => {
-            map[tag].xform.render(xmlStream, model[defn.prop]);
+        renderOrder.forEach(tag => {
+            map[tag].xform.render(xmlStream, model[map[tag].prop]);
         });
         xmlStream.closeNode();
     }

package/dist/cjs/xlsx/xform/table/auto-filter-xform.js

@@ -20,7 +20,9 @@ class AutoFilterXform extends base_xform_1.BaseXform {
         });
     }
     render(xmlStream, model) {
-        xmlStream.openNode(this.tag, { ref: model.autoFilterRef });
+        xmlStream.openNode(this.tag, {
+            ref: model.autoFilterRef
+        });
         model.columns.forEach((column) => {
             this.map.filterColumn.render(xmlStream, column);
         });

package/dist/cjs/xlsx/xform/table/table-column-xform.js

@@ -18,7 +18,8 @@ class TableColumnXform extends base_xform_1.BaseXform {
             id: model.id.toString(),
             name: model.name,
             totalsRowLabel: model.totalsRowLabel,
-            totalsRowFunction: model.totalsRowFunction,
+            // Excel doesn't output totalsRowFunction when value is 'none'
+            totalsRowFunction: model.totalsRowFunction === "none" ? undefined : model.totalsRowFunction,
             dxfId: model.dxfId
         });
     }

package/dist/cjs/xlsx/xform/table/table-xform.js

@@ -43,8 +43,8 @@ class TableXform extends base_xform_1.BaseXform {
             displayName: model.displayName || model.name,
             ref: model.tableRef,
             totalsRowCount: model.totalsRow ? "1" : undefined,
-            totalsRowShown: model.totalsRow ? undefined : "1",
-            headerRowCount: model.headerRow ? "1" : "0"
+            // Excel doesn't output headerRowCount when it's 1 (default) or when there's a header row
+            headerRowCount: model.headerRow ? undefined : "0"
         });
         this.map.autoFilter.render(xmlStream, model);
         this.map.tableColumns.render(xmlStream, model.columns);
@@ -65,7 +65,8 @@ class TableXform extends base_xform_1.BaseXform {
                     displayName: attributes.displayName || attributes.name,
                     tableRef: attributes.ref,
                     totalsRow: attributes.totalsRowCount === "1",
-                    headerRow: attributes.headerRowCount === "1"
+                    // ECMA-376: headerRowCount defaults to 1, so missing attribute means has header
+                    headerRow: attributes.headerRowCount !== "0"
                 };
                 break;
             default:
@@ -124,10 +125,5 @@ class TableXform extends base_xform_1.BaseXform {
 }
 exports.TableXform = TableXform;
 TableXform.TABLE_ATTRIBUTES = {
-    xmlns: "http://schemas.openxmlformats.org/spreadsheetml/2006/main",
-    "xmlns:mc": "http://schemas.openxmlformats.org/markup-compatibility/2006",
-    "mc:Ignorable": "xr xr3",
-    "xmlns:xr": "http://schemas.microsoft.com/office/spreadsheetml/2014/revision",
-    "xmlns:xr3": "http://schemas.microsoft.com/office/spreadsheetml/2016/revision3"
-    // 'xr:uid': '{00000000-000C-0000-FFFF-FFFF00000000}',
+    xmlns: "http://schemas.openxmlformats.org/spreadsheetml/2006/main"
 };

package/dist/esm/doc/pivot-table.js

@@ -34,8 +34,11 @@ function createTableSourceAdapter(table) {
     const endRow = startRow + tableModel.rows.length; // header row + data rows
     const endCol = startCol + columnNames.length - 1;
     const shortRange = colCache.encode(startRow, startCol, endRow, endCol);
+    // Use the worksheet name (not table name) for pivotCacheDefinition's worksheetSource
+    // The sheet attribute in worksheetSource must reference the actual worksheet name
+    const worksheetName = table.worksheet.name;
     return {
-        name: tableModel.name,
+        name: worksheetName,
         getRow(rowNumber) {
             if (rowNumber === 1) {
                 return { values: headerRow };
@@ -108,7 +111,7 @@ function makePivotTable(worksheet, model) {
     validate(worksheet, model, source);
     const { rows, values } = model;
     const columns = model.columns ?? [];
-    const cacheFields = makeCacheFields(source, [...rows, ...columns]);
+    const cacheFields = makeCacheFields(source, [...rows, ...columns], values);
     const nameToIndex = cacheFields.reduce((result, cacheField, index) => {
         result[cacheField.name] = index;
         return result;
@@ -165,13 +168,15 @@ function validate(_worksheet, model, source) {
         throw new Error("It is currently not possible to have multiple values when columns are specified. Please either supply an empty array for columns or a single value.");
     }
 }
-function makeCacheFields(source, fieldNamesWithSharedItems) {
+function makeCacheFields(source, fieldNamesWithSharedItems, valueFieldNames) {
     // Cache fields are used in pivot tables to reference source data.
     // Fields in fieldNamesWithSharedItems get their unique values extracted as sharedItems.
-    // Other fields (typically numeric) have sharedItems = null.
+    // Fields in valueFieldNames (but not in fieldNamesWithSharedItems) get min/max calculated.
+    // Other fields are unused and get empty sharedItems.
     const names = source.getRow(1).values;
     // Use Set for O(1) lookup instead of object
     const sharedItemsFields = new Set(fieldNamesWithSharedItems);
+    const valueFields = new Set(valueFieldNames);
     const aggregate = (columnIndex) => {
         const columnValues = source.getColumn(columnIndex).values;
         // Build unique values set directly, skipping header (index 0,1) and null/undefined
@@ -184,12 +189,48 @@ function makeCacheFields(source, fieldNamesWithSharedItems) {
         }
         return toSortedArray(uniqueValues);
     };
+    // Calculate min/max for numeric fields
+    const getMinMax = (columnIndex) => {
+        const columnValues = source.getColumn(columnIndex).values;
+        let min = Infinity;
+        let max = -Infinity;
+        let hasNumeric = false;
+        for (let i = 2; i < columnValues.length; i++) {
+            const v = columnValues[i];
+            if (typeof v === "number" && !isNaN(v)) {
+                hasNumeric = true;
+                if (v < min) {
+                    min = v;
+                }
+                if (v > max) {
+                    max = v;
+                }
+            }
+        }
+        return hasNumeric ? { minValue: min, maxValue: max } : null;
+    };
     // Build result array
     const result = [];
     for (const columnIndex of range(1, names.length)) {
         const name = names[columnIndex];
-        const sharedItems = sharedItemsFields.has(name) ? aggregate(columnIndex) : null;
-        result.push({ name, sharedItems });
+        if (sharedItemsFields.has(name)) {
+            // Field used for rows/columns - extract unique values as sharedItems
+            result.push({ name, sharedItems: aggregate(columnIndex) });
+        }
+        else if (valueFields.has(name)) {
+            // Field used only for values (aggregation) - calculate min/max
+            const minMax = getMinMax(columnIndex);
+            result.push({
+                name,
+                sharedItems: null,
+                minValue: minMax?.minValue,
+                maxValue: minMax?.maxValue
+            });
+        }
+        else {
+            // Unused field - just empty sharedItems (like Excel does)
+            result.push({ name, sharedItems: null });
+        }
     }
     return result;
 }

package/dist/esm/doc/worksheet.js

@@ -40,7 +40,6 @@ class Worksheet {
         // for tabColor, default row height, outline levels, etc
         this.properties = Object.assign({}, {
             defaultRowHeight: 15,
-            dyDescent: 55,
             outlineLevelCol: 0,
             outlineLevelRow: 0
         }, options.properties);

package/dist/esm/stream/xlsx/worksheet-writer.js

@@ -95,7 +95,6 @@ class WorksheetWriter {
         // for default row height, outline levels, etc
         this.properties = Object.assign({}, {
             defaultRowHeight: 15,
-            dyDescent: 55,
             outlineLevelCol: 0,
             outlineLevelRow: 0
         }, options.properties);

package/dist/esm/xlsx/xform/book/sheet-xform.js

@@ -3,9 +3,10 @@ import { BaseXform } from "../base-xform.js";
 class WorksheetXform extends BaseXform {
     render(xmlStream, model) {
         xmlStream.leafNode("sheet", {
-            sheetId: model.id,
             name: model.name,
-            state: model.state,
+            sheetId: model.id,
+            // Excel doesn't output state when it's 'visible' (default)
+            state: model.state === "visible" ? undefined : model.state,
             "r:id": model.rId
         });
     }

package/dist/esm/xlsx/xform/book/workbook-properties-xform.js

@@ -3,7 +3,7 @@ class WorkbookPropertiesXform extends BaseXform {
     render(xmlStream, model) {
         xmlStream.leafNode("workbookPr", {
             date1904: model.date1904 ? 1 : undefined,
-            defaultThemeVersion: 164011,
+            // Excel doesn't output defaultThemeVersion
             filterPrivacy: 1
         });
     }

package/dist/esm/xlsx/xform/core/content-types-xform.js

@@ -38,7 +38,7 @@ class ContentTypesXform extends BaseXform {
             });
         });
         if ((model.pivotTables || []).length) {
-            // Add content types for each pivot table
+            // Add content types for pivot cache (definition and records)
             (model.pivotTables || []).forEach((pivotTable) => {
                 const n = pivotTable.tableNumber;
                 xmlStream.leafNode("Override", {
@@ -49,10 +49,6 @@ class ContentTypesXform extends BaseXform {
                     PartName: `/xl/pivotCache/pivotCacheRecords${n}.xml`,
                     ContentType: "application/vnd.openxmlformats-officedocument.spreadsheetml.pivotCacheRecords+xml"
                 });
-                xmlStream.leafNode("Override", {
-                    PartName: `/xl/pivotTables/pivotTable${n}.xml`,
-                    ContentType: "application/vnd.openxmlformats-officedocument.spreadsheetml.pivotTable+xml"
-                });
             });
         }
         xmlStream.leafNode("Override", {
@@ -78,6 +74,16 @@ class ContentTypesXform extends BaseXform {
                 });
             });
         }
+        // Add pivot table overrides after tables (matches Excel order)
+        if ((model.pivotTables || []).length) {
+            (model.pivotTables || []).forEach((pivotTable) => {
+                const n = pivotTable.tableNumber;
+                xmlStream.leafNode("Override", {
+                    PartName: `/xl/pivotTables/pivotTable${n}.xml`,
+                    ContentType: "application/vnd.openxmlformats-officedocument.spreadsheetml.pivotTable+xml"
+                });
+            });
+        }
         if (model.drawings) {
             model.drawings.forEach((drawing) => {
                 xmlStream.leafNode("Override", {
@@ -86,7 +92,7 @@ class ContentTypesXform extends BaseXform {
                 });
             });
         }
-        if (model.commentRefs) {
+        if (model.commentRefs && model.commentRefs.length) {
             xmlStream.leafNode("Default", {
                 Extension: "vml",
                 ContentType: "application/vnd.openxmlformats-officedocument.vmlDrawing"

package/dist/esm/xlsx/xform/pivot-table/cache-field-xform.js

@@ -44,28 +44,24 @@ class CacheFieldXform extends BaseXform {
                 break;
             case "sharedItems":
                 this.inSharedItems = true;
-                // Check if this is a numeric field (no string items)
-                if (attributes.containsNumber === "1" || attributes.containsInteger === "1") {
-                    if (this.model) {
-                        this.model.containsNumber = attributes.containsNumber === "1";
-                        this.model.containsInteger = attributes.containsInteger === "1";
-                        if (attributes.minValue !== undefined) {
-                            this.model.minValue = parseFloat(attributes.minValue);
-                        }
-                        if (attributes.maxValue !== undefined) {
-                            this.model.maxValue = parseFloat(attributes.maxValue);
-                        }
-                        // Numeric fields have sharedItems = null
-                        this.model.sharedItems = null;
+                // Store numeric field metadata
+                if (this.model) {
+                    this.model.containsNumber = attributes.containsNumber === "1";
+                    this.model.containsInteger = attributes.containsInteger === "1";
+                    if (attributes.minValue !== undefined) {
+                        this.model.minValue = parseFloat(attributes.minValue);
                     }
-                }
-                else {
-                    // String field - initialize sharedItems array if count > 0
-                    if (this.model) {
-                        const count = parseInt(attributes.count || "0", 10);
-                        if (count > 0) {
-                            this.model.sharedItems = [];
-                        }
+                    if (attributes.maxValue !== undefined) {
+                        this.model.maxValue = parseFloat(attributes.maxValue);
+                    }
+                    // Initialize sharedItems array if count > 0 (for both string and numeric fields)
+                    const count = parseInt(attributes.count || "0", 10);
+                    if (count > 0) {
+                        this.model.sharedItems = [];
+                    }
+                    else {
+                        // No count means no individual items (pure numeric field)
+                        this.model.sharedItems = null;
                     }
                 }
                 break;

package/dist/esm/xlsx/xform/pivot-table/cache-field.js

@@ -1,6 +1,6 @@
 import { xmlEncode } from "../../../utils/utils.js";
 class CacheField {
-    constructor({ name, sharedItems }) {
+    constructor({ name, sharedItems, minValue, maxValue }) {
         // string type
         //
         // {
@@ -10,28 +10,64 @@ class CacheField {
         //
         // or
         //
-        // integer type
+        // integer type (no sharedItems)
         //
         // {
         //   'name': 'D',
-        //   'sharedItems': null
+        //   'sharedItems': null,
+        //   'minValue': 5,
+        //   'maxValue': 45
+        // }
+        //
+        // or
+        //
+        // numeric type with shared items (used as both row/column and value field)
+        //
+        // {
+        //   'name': 'C',
+        //   'sharedItems': [5, 24, 35, 45]
         // }
         this.name = name;
         this.sharedItems = sharedItems;
+        this.minValue = minValue;
+        this.maxValue = maxValue;
     }
     render() {
         // PivotCache Field: http://www.datypic.com/sc/ooxml/e-ssml_cacheField-1.html
         // Shared Items: http://www.datypic.com/sc/ooxml/e-ssml_sharedItems-1.html
         // Escape XML special characters in name attribute
         const escapedName = xmlEncode(this.name);
-        // integer types
+        // No shared items - field not used for rows/columns
         if (this.sharedItems === null) {
-            // TK(2023-07-18): left out attributes... minValue="5" maxValue="45"
+            // If no minValue/maxValue, this is an unused field - use empty sharedItems like Excel does
+            if (this.minValue === undefined || this.maxValue === undefined) {
+                return `<cacheField name="${escapedName}" numFmtId="0">
+      <sharedItems />
+    </cacheField>`;
+            }
+            // Numeric field used only for values (not rows/columns) - include min/max
             return `<cacheField name="${escapedName}" numFmtId="0">
-      <sharedItems containsSemiMixedTypes="0" containsString="0" containsNumber="1" containsInteger="1" />
+      <sharedItems containsSemiMixedTypes="0" containsString="0" containsNumber="1" containsInteger="1" minValue="${this.minValue}" maxValue="${this.maxValue}" />
+    </cacheField>`;
+        }
+        // Shared items exist - check if all values are numeric
+        // Note: empty array returns true for every(), so check length first
+        const allNumeric = this.sharedItems.length > 0 &&
+            this.sharedItems.every(item => typeof item === "number" && Number.isFinite(item));
+        const allInteger = allNumeric && this.sharedItems.every(item => Number.isInteger(item));
+        if (allNumeric) {
+            // Numeric shared items - used when field is both a row/column field AND a value field
+            // This allows Excel to both group by unique values AND perform aggregation
+            const minValue = Math.min(...this.sharedItems);
+            const maxValue = Math.max(...this.sharedItems);
+            const integerAttr = allInteger ? ' containsInteger="1"' : "";
+            return `<cacheField name="${escapedName}" numFmtId="0">
+      <sharedItems containsSemiMixedTypes="0" containsString="0" containsNumber="1"${integerAttr} minValue="${minValue}" maxValue="${maxValue}" count="${this.sharedItems.length}">
+        ${this.sharedItems.map(item => `<n v="${item}" />`).join("")}
+      </sharedItems>
     </cacheField>`;
         }
-        // string types - escape XML special characters in each shared item value
+        // String shared items - escape XML special characters in each value
         return `<cacheField name="${escapedName}" numFmtId="0">
       <sharedItems count="${this.sharedItems.length}">
         ${this.sharedItems.map(item => `<s v="${xmlEncode(String(item))}" />`).join("")}

package/dist/esm/xlsx/xform/pivot-table/pivot-cache-definition-xform.js

@@ -50,8 +50,6 @@ class PivotCacheDefinitionXform extends BaseXform {
             ...PivotCacheDefinitionXform.PIVOT_CACHE_DEFINITION_ATTRIBUTES,
             "r:id": "rId1",
             refreshOnLoad: "1", // important for our implementation to work
-            refreshedBy: "Author",
-            refreshedDate: "45125.026046874998",
             createdVersion: "8",
             refreshedVersion: "8",
             minRefreshableVersion: "3",
@@ -79,8 +77,6 @@ class PivotCacheDefinitionXform extends BaseXform {
             ...PivotCacheDefinitionXform.PIVOT_CACHE_DEFINITION_ATTRIBUTES,
             "r:id": model.rId || "rId1",
             refreshOnLoad: model.refreshOnLoad || "1",
-            refreshedBy: model.refreshedBy || "Author",
-            refreshedDate: model.refreshedDate || "45125.026046874998",
             createdVersion: model.createdVersion || "8",
             refreshedVersion: model.refreshedVersion || "8",
             minRefreshableVersion: model.minRefreshableVersion || "3",
@@ -114,8 +110,6 @@ class PivotCacheDefinitionXform extends BaseXform {
                     cacheFields: [],
                     rId: attributes["r:id"],
                     refreshOnLoad: attributes.refreshOnLoad,
-                    refreshedBy: attributes.refreshedBy,
-                    refreshedDate: attributes.refreshedDate,
                     createdVersion: attributes.createdVersion,
                     refreshedVersion: attributes.refreshedVersion,
                     minRefreshableVersion: attributes.minRefreshableVersion,
@@ -180,9 +174,6 @@ class PivotCacheDefinitionXform extends BaseXform {
 }
 PivotCacheDefinitionXform.PIVOT_CACHE_DEFINITION_ATTRIBUTES = {
     xmlns: "http://schemas.openxmlformats.org/spreadsheetml/2006/main",
-    "xmlns:r": "http://schemas.openxmlformats.org/officeDocument/2006/relationships",
-    "xmlns:mc": "http://schemas.openxmlformats.org/markup-compatibility/2006",
-    "mc:Ignorable": "xr",
-    "xmlns:xr": "http://schemas.microsoft.com/office/spreadsheetml/2014/revision"
+    "xmlns:r": "http://schemas.openxmlformats.org/officeDocument/2006/relationships"
 };
 export { PivotCacheDefinitionXform };

package/dist/esm/xlsx/xform/pivot-table/pivot-cache-records-xform.js

@@ -116,7 +116,7 @@ class PivotCacheRecordsXform extends BaseXform {
             }
             return `<s v="${xmlEncode(String(value))}" />`;
         }
-        // shared items
+        // shared items - use indexOf for value lookup (works for both string and numeric)
         const sharedItemsIndex = sharedItems.indexOf(value);
         if (sharedItemsIndex < 0) {
             throw new Error(`${JSON.stringify(value)} not in sharedItems ${JSON.stringify(sharedItems)}`);