@cj-tech-master/excelts 5.0.6 → 5.1.0

package/dist/esm/modules/excel/stream/workbook-writer.browser.js

@@ -35,10 +35,10 @@ export class WorkbookWriterBase {
         this.WorksheetWriterClass = WorksheetWriterClass;
         this.created = options.created || new Date();
         this.modified = options.modified || this.created;
-        this.creator = options.creator || "ExcelTS";
-        this.lastModifiedBy = options.lastModifiedBy || "ExcelTS";
+        this.creator = options.creator ?? "ExcelTS";
+        this.lastModifiedBy = options.lastModifiedBy ?? "ExcelTS";
         this.lastPrinted = options.lastPrinted;
-        this.useSharedStrings = options.useSharedStrings || false;
+        this.useSharedStrings = options.useSharedStrings ?? false;
         this.sharedStrings = new SharedStrings();
         this.styles = options.useStyles ? new StylesXform(true) : new StylesXform.Mock(true);
         this._definedNames = new DefinedNames();
@@ -170,7 +170,7 @@ export class WorkbookWriterBase {
             opts.properties = { tabColor: opts.tabColor, ...opts.properties };
         }
         const id = this.nextId;
-        name = name || `sheet${id}`;
+        name = name ?? `sheet${id}`;
         const worksheet = new this.WorksheetWriterClass({
             id,
             name,

package/dist/esm/modules/excel/stream/worksheet-reader.js

@@ -165,7 +165,7 @@ class WorksheetReader extends EventEmitter {
                                         min: parseInt(node.attributes.min, 10),
                                         max: parseInt(node.attributes.max, 10),
                                         width: parseFloat(node.attributes.width),
-                                        styleId: parseInt(node.attributes.style || "0", 10)
+                                        styleId: parseInt(node.attributes.style ?? "0", 10)
                                     });
                                 }
                                 break;

package/dist/esm/modules/excel/stream/worksheet-writer.js

@@ -64,7 +64,7 @@ class WorksheetWriter {
         // and a name
         this.name = options.name || `Sheet${this.id}`;
         // add a state
-        this.state = options.state || "visible";
+        this.state = options.state ?? "visible";
         // rows are stored here while they need to be worked on.
         // when they are committed, they will be deleted.
         this._rows = [];
@@ -138,13 +138,13 @@ class WorksheetWriter {
             colBreaks: null
         }, options.pageSetup);
         // using shared strings creates a smaller xlsx file but may use more memory
-        this.useSharedStrings = options.useSharedStrings || false;
+        this.useSharedStrings = options.useSharedStrings ?? false;
         this._workbook = options.workbook;
         this.hasComments = false;
         // views
-        this._views = options.views || [];
+        this._views = options.views ?? [];
         // auto filter
-        this.autoFilter = options.autoFilter || null;
+        this.autoFilter = options.autoFilter ?? null;
         this._media = [];
         // worksheet protection
         this.sheetProtection = null;

package/dist/esm/modules/excel/table.js

@@ -104,7 +104,7 @@ class Table {
             case "sum":
                 return `SUBTOTAL(109,${this.table.name}[${column.name}])`;
             case "custom":
-                return column.totalsRowFormula || null;
+                return column.totalsRowFormula ?? null;
             default:
                 throw new Error(`Invalid Totals Row Function: ${column.totalsRowFunction}`);
         }
@@ -166,7 +166,7 @@ class Table {
             }
             else {
                 assign(column, "totalsRowFunction", "none");
-                column.totalsRowFormula = this.getFormula(column) || undefined;
+                column.totalsRowFormula = this.getFormula(column) ?? undefined;
             }
         });
     }

package/dist/esm/modules/excel/utils/cell-format.js

@@ -107,7 +107,7 @@ export function getFormat(numFmtId) {
     }
     // Check default map
     if (DEFAULT_MAP[numFmtId] !== undefined) {
-        return TABLE_FMT[DEFAULT_MAP[numFmtId]] || "General";
+        return TABLE_FMT[DEFAULT_MAP[numFmtId]] ?? "General";
     }
     return "General";
 }
@@ -339,7 +339,7 @@ function formatGeneral(val) {
  */
 function formatPercentage(val, fmt) {
     // Count % signs
-    const percentCount = (fmt.match(/%/g) || []).length;
+    const percentCount = (fmt.match(/%/g) ?? []).length;
     // Multiply value by 100 for each %
     const scaledVal = val * Math.pow(100, percentCount);
     // Remove % from format to process the number part
@@ -553,7 +553,7 @@ function formatNumberPattern(val, fmt) {
             formattedInt = commaify(intPart);
         }
         // Pad integer with leading zeros if needed
-        const minIntDigits = (intFmt.match(/0/g) || []).length;
+        const minIntDigits = (intFmt.match(/0/g) ?? []).length;
         if (formattedInt.length < minIntDigits) {
             formattedInt = "0".repeat(minIntDigits - formattedInt.length) + formattedInt;
         }

package/dist/esm/modules/excel/utils/shared-formula.js

@@ -27,7 +27,7 @@ function slideFormula(formula, fromCell, toCell) {
             if (!rowDollar) {
                 row += to.row - offset.row;
             }
-            const res = (sheet || "") + (colDollar || "") + colCache.n2l(col) + (rowDollar || "") + row;
+            const res = (sheet ?? "") + (colDollar ?? "") + colCache.n2l(col) + (rowDollar ?? "") + row;
             return res;
         }
         return refMatch;

package/dist/esm/modules/excel/utils/stream-buf.js

@@ -132,7 +132,7 @@ class StreamBuf extends EventEmitter {
         this._asyncWriteQueue = Promise.resolve();
         this.bufSize = options?.bufSize || 1024 * 1024;
         this.buffers = [];
-        this.batch = options?.batch || false;
+        this.batch = options?.batch ?? false;
         this.corked = false;
         this.paused = false;
         this.encoding = null;
@@ -345,7 +345,7 @@ class StreamBuf extends EventEmitter {
      * Cross-platform compatible - works identically in Node.js and Browser.
      */
     readString(encoding) {
-        const enc = encoding || this.encoding || "utf-8";
+        const enc = encoding ?? this.encoding ?? "utf-8";
         const buf = this.read();
         if (typeof Buffer !== "undefined" && buf instanceof Buffer) {
             return buf.toString(enc);

package/dist/esm/modules/excel/utils/string-buf.js

@@ -33,7 +33,7 @@ class StringBuf {
         return this._buffer;
     }
     reset(position) {
-        position = position || 0;
+        position = position ?? 0;
         this._buffer = undefined;
         this._inPos = position;
     }

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

@@ -230,8 +230,8 @@ class Workbook {
     // ===========================================================================
     get model() {
         return {
-            creator: this.creator || "Unknown",
-            lastModifiedBy: this.lastModifiedBy || "Unknown",
+            creator: this.creator ?? "Unknown",
+            lastModifiedBy: this.lastModifiedBy ?? "Unknown",
             lastPrinted: this.lastPrinted,
             created: this.created,
             modified: this.modified,
@@ -293,10 +293,9 @@ class Workbook {
         this._definedNames.model = value.definedNames;
         this.views = value.views;
         this._themes = value.themes;
-        this.media = value.media || [];
+        this.media = value.media ?? [];
         // Handle pivot tables - either newly created or loaded from file
-        // Loaded pivot tables come from loadedPivotTables after reconciliation
-        this.pivotTables = value.pivotTables || value.loadedPivotTables || [];
+        this.pivotTables = value.pivotTables ?? [];
         // Preserve passthrough files (charts, etc.) for round-trip preservation
         this._passthrough = value.passthrough || {};
         // Preserve raw drawing data for drawings with chart references

package/dist/esm/modules/excel/worksheet.js

@@ -21,12 +21,12 @@ class Worksheet {
         options = options || {};
         this._workbook = options.workbook;
         // in a workbook, each sheet will have a number
-        this.id = options.id || 0;
-        this.orderNo = options.orderNo || 0;
+        this.id = options.id ?? 0;
+        this.orderNo = options.orderNo ?? 0;
         // and a name - use the setter to ensure validation and truncation
         this.name = options.name || `sheet${this.id}`;
         // add a state
-        this.state = options.state || "visible";
+        this.state = options.state ?? "visible";
         // rows allows access organised by row. Sparse array of arrays indexed by row-1, col
         // Note: _rows is zero based. Must subtract 1 to go from cell.row to index
         this._rows = [];
@@ -86,8 +86,8 @@ class Worksheet {
         }, options.headerFooter);
         this.dataValidations = new DataValidations();
         // for freezepanes, split, zoom, gridlines, etc
-        this.views = options.views || [];
-        this.autoFilter = options.autoFilter || null;
+        this.views = options.views ?? [];
+        this.autoFilter = options.autoFilter ?? null;
         // for images, etc
         this._media = [];
         // worksheet protection
@@ -250,7 +250,7 @@ class Worksheet {
         if (inserts.length > 0) {
             // must iterate over all rows whether they exist yet or not
             for (let i = 0; i < nRows; i++) {
-                const insertValues = inserts.map(insert => insert[i] || null);
+                const insertValues = inserts.map(insert => insert[i] ?? null);
                 const row = this.getRow(i + 1);
                 row.splice(start, count, ...insertValues);
             }
@@ -930,7 +930,7 @@ class Worksheet {
         };
         // =================================================
         // columns
-        model.cols = Column.toModel(this.columns || []);
+        model.cols = Column.toModel(this.columns ?? []);
         // ==========================================================
         // Rows
         const rows = (model.rows = []);
@@ -978,8 +978,8 @@ class Worksheet {
         this.properties = value.properties;
         this.pageSetup = value.pageSetup;
         this.headerFooter = value.headerFooter;
-        this.rowBreaks = value.rowBreaks || [];
-        this.colBreaks = value.colBreaks || [];
+        this.rowBreaks = value.rowBreaks ?? [];
+        this.colBreaks = value.colBreaks ?? [];
         this.views = value.views;
         this.autoFilter = value.autoFilter;
         this._media = value.media.map(medium => new Image(this, medium));

package/dist/esm/modules/excel/xlsx/xform/base-xform.js

@@ -62,7 +62,7 @@ class BaseXform {
     // ============================================================
     reset() {
         // to make sure parses don't bleed to next iteration
-        this.model = null;
+        this.model = undefined;
         // if we have a map - reset them too
         if (this.map) {
             Object.values(this.map).forEach(xform => {

package/dist/esm/modules/excel/xlsx/xform/book/defined-name-xform.js

@@ -57,7 +57,7 @@ function isValidRange(range) {
         return false;
     }
     // Extract the cell reference part (after the sheet name if present)
-    const cellRef = range.split("!").pop() || "";
+    const cellRef = range.split("!").pop() ?? "";
     // Must match one of the valid patterns
     if (!cellRangeRegexp.test(cellRef) &&
         !rowRangeRegexp.test(cellRef) &&
@@ -93,7 +93,7 @@ function extractRanges(parsedText) {
         if (!item) {
             return;
         }
-        const quotes = (item.match(/'/g) || []).length;
+        const quotes = (item.match(/'/g) ?? []).length;
         if (!quotes) {
             if (quotesOpened) {
                 last += `${item},`;

package/dist/esm/modules/excel/xlsx/xform/book/workbook-view-xform.js

@@ -2,10 +2,10 @@ import { BaseXform } from "../base-xform.js";
 class WorkbookViewXform extends BaseXform {
     render(xmlStream, model) {
         const attributes = {
-            xWindow: model.x || 0,
-            yWindow: model.y || 0,
-            windowWidth: model.width || 12000,
-            windowHeight: model.height || 24000,
+            xWindow: model.x ?? 0,
+            yWindow: model.y ?? 0,
+            windowWidth: model.width ?? 12000,
+            windowHeight: model.height ?? 24000,
             firstSheet: model.firstSheet,
             activeTab: model.activeTab
         };

package/dist/esm/modules/excel/xlsx/xform/book/workbook-xform.js

@@ -74,7 +74,7 @@ class WorkbookXform extends BaseXform {
         if (printAreas.length) {
             model.definedNames = model.definedNames.concat(printAreas);
         }
-        (model.media || []).forEach((medium, i) => {
+        (model.media ?? []).forEach((medium, i) => {
             // assign name
             medium.name = medium.type + (i + 1);
         });
@@ -88,7 +88,19 @@ class WorkbookXform extends BaseXform {
         this.map.sheets.render(xmlStream, model.sheets);
         this.map.definedNames.render(xmlStream, model.definedNames);
         this.map.calcPr.render(xmlStream, model.calcProperties);
-        this.map.pivotCaches.render(xmlStream, model.pivotTables);
+        // R9-B6: Deduplicate pivot caches by cacheId before rendering.
+        // Multiple pivot tables may share the same cache, but workbook.xml should
+        // only list each cache once in <pivotCaches>.
+        const pivotTables = model.pivotTables ?? [];
+        const seenCacheIds = new Set();
+        const uniquePivotCaches = pivotTables.filter((pt) => {
+            if (seenCacheIds.has(pt.cacheId)) {
+                return false;
+            }
+            seenCacheIds.add(pt.cacheId);
+            return true;
+        });
+        this.map.pivotCaches.render(xmlStream, uniquePivotCaches);
         xmlStream.closeNode();
     }
     parseOpen(node) {
@@ -140,7 +152,7 @@ class WorkbookXform extends BaseXform {
         }
     }
     reconcile(model) {
-        const rels = (model.workbookRels || []).reduce((map, rel) => {
+        const rels = (model.workbookRels ?? []).reduce((map, rel) => {
             map[rel.Id] = rel;
             return map;
         }, {});
@@ -148,7 +160,7 @@ class WorkbookXform extends BaseXform {
         const worksheets = [];
         let worksheet;
         let index = 0;
-        (model.sheets || []).forEach((sheet) => {
+        (model.sheets ?? []).forEach((sheet) => {
             const rel = rels[sheet.rId];
             if (!rel) {
                 return;

package/dist/esm/modules/excel/xlsx/xform/comment/style/vml-position-xform.js

@@ -6,7 +6,7 @@ class VmlPositionXform extends BaseXform {
         this.model = {};
     }
     get tag() {
-        return (this._model && this._model.tag) || "";
+        return this._model?.tag ?? "";
     }
     render(xmlStream, model, type) {
         if (type && model === type[2]) {

package/dist/esm/modules/excel/xlsx/xform/comment/style/vml-protection-xform.js

@@ -6,7 +6,7 @@ class VmlProtectionXform extends BaseXform {
         this.text = "";
     }
     get tag() {
-        return (this._model && this._model.tag) || "";
+        return this._model?.tag ?? "";
     }
     render(xmlStream, model) {
         xmlStream.leafNode(this.tag, null, model);

package/dist/esm/modules/excel/xlsx/xform/comment/vml-shape-xform.js

@@ -13,7 +13,7 @@ class VmlShapeXform extends BaseXform {
         return "v:shape";
     }
     render(xmlStream, model, index) {
-        xmlStream.openNode("v:shape", VmlShapeXform.V_SHAPE_ATTRIBUTES(model, index || 0));
+        xmlStream.openNode("v:shape", VmlShapeXform.V_SHAPE_ATTRIBUTES(model, index ?? 0));
         xmlStream.leafNode("v:fill", { color2: "infoBackground [80]" });
         xmlStream.leafNode("v:shadow", { color: "none [81]", obscured: "t" });
         xmlStream.leafNode("v:path", { "o:connecttype": "none" });

package/dist/esm/modules/excel/xlsx/xform/comment/vml-textbox-xform.js

@@ -11,7 +11,7 @@ class VmlTextboxXform extends BaseXform {
         return `${(parseFloat(value.toString()) * multiple).toFixed(2)}${unit}`;
     }
     reverseConversionUnit(inset) {
-        return (inset || "").split(",").map(margin => {
+        return (inset ?? "").split(",").map(margin => {
             return Number(parseFloat(this.conversionUnit(parseFloat(margin), 0.1, "")).toFixed(2));
         });
     }

package/dist/esm/modules/excel/xlsx/xform/core/app-xform.js

@@ -21,7 +21,7 @@ class AppXform extends BaseXform {
         xmlStream.leafNode("ScaleCrop", undefined, "false");
         this.map.HeadingPairs.render(xmlStream, model.worksheets);
         this.map.TitlesOfParts.render(xmlStream, model.worksheets);
-        this.map.Company.render(xmlStream, model.company || "");
+        this.map.Company.render(xmlStream, model.company ?? "");
         this.map.Manager.render(xmlStream, model.manager);
         xmlStream.leafNode("LinksUpToDate", undefined, "false");
         xmlStream.leafNode("SharedDoc", undefined, "false");

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

@@ -8,7 +8,7 @@ class ContentTypesXform extends BaseXform {
         xmlStream.openXml(XmlStream.StdDocAttributes);
         xmlStream.openNode("Types", ContentTypesXform.PROPERTY_ATTRIBUTES);
         const mediaHash = {};
-        (model.media || []).forEach((medium) => {
+        (model.media ?? []).forEach((medium) => {
             if (medium.type === "image") {
                 const imageType = medium.extension;
                 if (!mediaHash[imageType]) {
@@ -37,18 +37,31 @@ class ContentTypesXform extends BaseXform {
                 ContentType: "application/vnd.openxmlformats-officedocument.spreadsheetml.worksheet+xml"
             });
         });
-        if ((model.pivotTables || []).length) {
+        if ((model.pivotTables ?? []).length) {
+            // R9-B6: Deduplicate cache content types by cacheId. When multiple pivot tables
+            // share the same cache, the cache definition/records files are written only once.
+            const writtenCacheIds = new Set();
             // Add content types for each pivot table
-            (model.pivotTables || []).forEach((pivotTable) => {
+            (model.pivotTables ?? []).forEach((pivotTable) => {
                 const n = pivotTable.tableNumber;
-                xmlStream.leafNode("Override", {
-                    PartName: toContentTypesPartName(pivotCacheDefinitionPath(n)),
-                    ContentType: "application/vnd.openxmlformats-officedocument.spreadsheetml.pivotCacheDefinition+xml"
-                });
-                xmlStream.leafNode("Override", {
-                    PartName: toContentTypesPartName(pivotCacheRecordsPath(n)),
-                    ContentType: "application/vnd.openxmlformats-officedocument.spreadsheetml.pivotCacheRecords+xml"
-                });
+                const cacheId = pivotTable.cacheId;
+                if (!writtenCacheIds.has(cacheId)) {
+                    writtenCacheIds.add(cacheId);
+                    xmlStream.leafNode("Override", {
+                        PartName: toContentTypesPartName(pivotCacheDefinitionPath(n)),
+                        ContentType: "application/vnd.openxmlformats-officedocument.spreadsheetml.pivotCacheDefinition+xml"
+                    });
+                    // R9-B5: Only register cacheRecords content type when the file actually exists.
+                    // Loaded pivot tables may lack cacheRecords (e.g. OLAP sources).
+                    const hasCacheRecords = pivotTable.isLoaded ? !!pivotTable.cacheRecords : true;
+                    if (hasCacheRecords) {
+                        xmlStream.leafNode("Override", {
+                            PartName: toContentTypesPartName(pivotCacheRecordsPath(n)),
+                            ContentType: "application/vnd.openxmlformats-officedocument.spreadsheetml.pivotCacheRecords+xml"
+                        });
+                    }
+                }
+                // Each pivot table always has its own file
                 xmlStream.leafNode("Override", {
                     PartName: toContentTypesPartName(pivotTablePath(n)),
                     ContentType: "application/vnd.openxmlformats-officedocument.spreadsheetml.pivotTable+xml"

package/dist/esm/modules/excel/xlsx/xform/drawing/base-cell-anchor-xform.js

@@ -10,7 +10,7 @@ class BaseCellAnchorXform extends BaseXform {
                 this.reset();
                 this.model = {
                     range: {
-                        editAs: node.attributes.editAs || "oneCell"
+                        editAs: node.attributes.editAs ?? "oneCell"
                     }
                 };
                 break;

package/dist/esm/modules/excel/xlsx/xform/drawing/ext-xform.js

@@ -19,8 +19,8 @@ class ExtXform extends BaseXform {
     parseOpen(node) {
         if (node.name === this.tag) {
             this.model = {
-                width: parseInt(node.attributes.cx || "0", 10) / EMU_PER_PIXEL_AT_96_DPI,
-                height: parseInt(node.attributes.cy || "0", 10) / EMU_PER_PIXEL_AT_96_DPI
+                width: parseInt(node.attributes.cx ?? "0", 10) / EMU_PER_PIXEL_AT_96_DPI,
+                height: parseInt(node.attributes.cy ?? "0", 10) / EMU_PER_PIXEL_AT_96_DPI
             };
             return true;
         }

package/dist/esm/modules/excel/xlsx/xform/drawing/one-cell-anchor-xform.js

@@ -20,7 +20,7 @@ class OneCellAnchorXform extends BaseCellAnchorXform {
         this.map["xdr:pic"].prepare(model.picture, options);
     }
     render(xmlStream, model) {
-        xmlStream.openNode(this.tag, { editAs: model.range.editAs || "oneCell" });
+        xmlStream.openNode(this.tag, { editAs: model.range.editAs ?? "oneCell" });
         this.map["xdr:from"].render(xmlStream, model.range.tl);
         this.map["xdr:ext"].render(xmlStream, model.range.ext);
         this.map["xdr:pic"].render(xmlStream, model.picture);

package/dist/esm/modules/excel/xlsx/xform/drawing/two-cell-anchor-xform.js

@@ -37,7 +37,7 @@ class TwoCellAnchorXform extends BaseCellAnchorXform {
                     : {})
             });
         }
-        xmlStream.openNode(this.tag, { editAs: model.range.editAs || "oneCell" });
+        xmlStream.openNode(this.tag, { editAs: model.range.editAs ?? "oneCell" });
         this.map["xdr:from"].render(xmlStream, model.range.tl);
         this.map["xdr:to"].render(xmlStream, model.range.br);
         if (model.picture) {

package/dist/esm/modules/excel/xlsx/xform/list-xform.js

@@ -6,7 +6,7 @@ class ListXform extends BaseXform {
         this.always = !!options.always;
         this.count = options.count;
         this.empty = options.empty;
-        this.$count = options.$count || "count";
+        this.$count = options.$count ?? "count";
         this.$ = options.$;
         this.childXform = options.childXform;
         this.maxItems = options.maxItems;
@@ -24,10 +24,10 @@ class ListXform extends BaseXform {
         if (this.always || (model && model.length)) {
             xmlStream.openNode(this.tag, this.$);
             if (this.count) {
-                xmlStream.addAttribute(this.$count, (model && model.length) || 0);
+                xmlStream.addAttribute(this.$count, model?.length ?? 0);
             }
             const { childXform } = this;
-            (model || []).forEach((childModel, index) => {
+            (model ?? []).forEach((childModel, index) => {
                 childXform.render(xmlStream, childModel, index);
             });
             xmlStream.closeNode();