@cj-tech-master/excelts 5.0.6 → 5.1.0

package/dist/esm/modules/excel/xlsx/xform/pivot-table/raw-xml-collector.js

@@ -0,0 +1,149 @@
+import { xmlEncode } from "../../../../../utils/utils.js";
+/**
+ * Reusable utility for collecting raw XML fragments during SAX parsing.
+ *
+ * Many pivot-table xforms need to capture entire sub-trees (extLst, formats,
+ * conditionalFormats, filters, fieldGroup, unknown elements, …) as raw strings
+ * for roundtrip preservation.  The pattern — `active` flag, `depth` counter,
+ * `buffer` of string fragments, plus identical `feedOpen` / `feedClose` /
+ * `feedText` logic — was previously copy-pasted across multiple files.
+ *
+ * Usage:
+ * ```ts
+ * const collector = new RawXmlCollector("extLst");
+ * // In parseOpen, when you see <extLst>:
+ * collector.start();                      // opens with <extLst>
+ * // For every child open tag while active:
+ * collector.feedOpen(name, attributes);
+ * // For every text node while active:
+ * collector.feedText(text);
+ * // For every close tag while active:
+ * if (collector.feedClose(name)) { ... }  // returns true when root tag closed
+ * // Retrieve result:
+ * collector.result;                       // joined XML string
+ * ```
+ */
+class RawXmlCollector {
+    constructor(rootTag) {
+        /** Whether the collector is currently capturing. */
+        this.active = false;
+        /** Nesting depth *within* the root element (0 = direct children). */
+        this.depth = 0;
+        /** String fragments being accumulated. */
+        this.buffer = [];
+        /** Index of the last open-tag entry in the buffer (for self-closing collapse). */
+        this.lastOpenIndex = -1;
+        this.rootTag = rootTag;
+    }
+    // ---------------------------------------------------------------------------
+    // Lifecycle
+    // ---------------------------------------------------------------------------
+    /**
+     * Begin collecting.  Pushes the opening root tag (with optional attributes)
+     * and resets depth.
+     *
+     * @param attributes - Attributes on the root element (may be undefined/null).
+     */
+    start(attributes) {
+        this.active = true;
+        this.depth = 0;
+        const attrsStr = serializeAttributes(attributes);
+        this.buffer = [`<${this.rootTag}${attrsStr ? " " + attrsStr : ""}>`];
+    }
+    /**
+     * Begin collecting with a dynamically determined root tag.
+     * Used for catch-all unknown element collectors where the tag name
+     * is not known at construction time.
+     */
+    startAs(rootTag, attributes) {
+        this.rootTag = rootTag;
+        this.start(attributes);
+    }
+    /**
+     * Reset the collector to its initial idle state.
+     */
+    reset() {
+        this.active = false;
+        this.depth = 0;
+        this.buffer.length = 0;
+        this.lastOpenIndex = -1;
+    }
+    // ---------------------------------------------------------------------------
+    // Feed methods — call these from parseOpen / parseText / parseClose
+    // ---------------------------------------------------------------------------
+    /**
+     * Feed an open-tag event.  Must only be called while `active` is true.
+     */
+    feedOpen(name, attributes) {
+        const attrsStr = serializeAttributes(attributes);
+        this.buffer.push(`<${name}${attrsStr ? " " + attrsStr : ""}>`);
+        this.depth++;
+        this.lastOpenIndex = this.buffer.length - 1;
+    }
+    /**
+     * Feed a text-node event.  Must only be called while `active` is true.
+     */
+    feedText(text) {
+        this.buffer.push(xmlEncode(text));
+        this.lastOpenIndex = -1;
+    }
+    /**
+     * Feed a close-tag event.
+     *
+     * @returns `true` when the **root** close tag has been received (collector
+     *          deactivates itself and the result is ready).  `false` for any
+     *          nested close tag.
+     */
+    feedClose(name) {
+        if (name === this.rootTag && this.depth === 0) {
+            this.buffer.push(`</${name}>`);
+            this.active = false;
+            this.lastOpenIndex = -1;
+            return true;
+        }
+        // Guard against depth going negative (e.g. mismatched close tags)
+        if (this.depth > 0) {
+            this.depth--;
+        }
+        // Collapse self-closing: if the close tag matches the last open tag and
+        // nothing was written between them, rewrite `<tag ...>` → `<tag ... />`
+        if (this.lastOpenIndex >= 0 && this.lastOpenIndex === this.buffer.length - 1) {
+            const openTag = this.buffer[this.lastOpenIndex];
+            // openTag ends with ">" — replace with " />"
+            this.buffer[this.lastOpenIndex] = openTag.slice(0, -1) + " />";
+            this.lastOpenIndex = -1;
+            return false;
+        }
+        this.lastOpenIndex = -1;
+        this.buffer.push(`</${name}>`);
+        return false;
+    }
+    // ---------------------------------------------------------------------------
+    // Result
+    // ---------------------------------------------------------------------------
+    /** The collected XML string.  Only meaningful after `feedClose` returns true. */
+    get result() {
+        return this.buffer.join("");
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Serialize an attributes object to an XML attribute string.
+ * `null`, `undefined`, and empty objects produce an empty string.
+ */
+function serializeAttributes(attributes) {
+    if (!attributes) {
+        return "";
+    }
+    const entries = Object.entries(attributes);
+    if (entries.length === 0) {
+        return "";
+    }
+    return entries
+        .filter(([, v]) => v != null)
+        .map(([k, v]) => `${k}="${xmlEncode(String(v))}"`)
+        .join(" ");
+}
+export { RawXmlCollector, serializeAttributes };

package/dist/esm/modules/excel/xlsx/xform/sheet/cell-xform.js

@@ -379,7 +379,7 @@ class CellXform extends BaseXform {
                 return true;
             case "r":
                 this.model.value = this.model.value || {};
-                this.model.value.richText = this.model.value.richText || [];
+                this.model.value.richText = this.model.value.richText ?? [];
                 this.model.value.richText.push(this.parser.model);
                 this.parser = undefined;
                 this.currentNode = undefined;

package/dist/esm/modules/excel/xlsx/xform/sheet/cf/cf-rule-xform.js

@@ -250,7 +250,7 @@ class CfRuleXform extends CompositeXform {
                 break;
             case "formula":
                 // except - formula is a string and appends to formulae
-                this.model.formulae = this.model.formulae || [];
+                this.model.formulae = this.model.formulae ?? [];
                 this.model.formulae.push(parser.model);
                 break;
         }

package/dist/esm/modules/excel/xlsx/xform/sheet/cf/conditional-formattings-xform.js

@@ -13,7 +13,7 @@ class ConditionalFormattingsXform extends BaseXform {
     }
     prepare(model, options) {
         // ensure each rule has a priority value
-        let nextPriority = model.reduce((p, cf) => Math.max(p, ...cf.rules.map((rule) => rule.priority || 0)), 1);
+        let nextPriority = model.reduce((p, cf) => Math.max(p, ...cf.rules.map((rule) => rule.priority ?? 0)), 1);
         model.forEach((cf) => {
             cf.rules.forEach((rule) => {
                 if (!rule.priority) {

package/dist/esm/modules/excel/xlsx/xform/sheet/cf-ext/cf-rule-ext-xform.js

@@ -61,7 +61,7 @@ class CfRuleExtXform extends CompositeXform {
         xmlStream.openNode(this.tag, {
             type: "iconSet",
             priority: model.priority,
-            id: model.x14Id || `{${uuidV4()}}`
+            id: model.x14Id ?? `{${uuidV4()}}`
         });
         this.iconSetXform.render(xmlStream, model);
         xmlStream.closeNode();

package/dist/esm/modules/excel/xlsx/xform/sheet/col-xform.js

@@ -38,9 +38,9 @@ class ColXform extends BaseXform {
     parseOpen(node) {
         if (node.name === "col") {
             const model = (this.model = {
-                min: parseInt(node.attributes.min || "0", 10),
-                max: parseInt(node.attributes.max || "0", 10),
-                width: node.attributes.width === undefined ? undefined : parseFloat(node.attributes.width || "0")
+                min: parseInt(node.attributes.min ?? "0", 10),
+                max: parseInt(node.attributes.max ?? "0", 10),
+                width: node.attributes.width === undefined ? undefined : parseFloat(node.attributes.width ?? "0")
             });
             if (node.attributes.style) {
                 model.styleId = parseInt(node.attributes.style, 10);

package/dist/esm/modules/excel/xlsx/xform/sheet/data-validations-xform.js

@@ -159,7 +159,7 @@ class DataValidationsXform extends BaseXform {
                     xmlStream.addAttribute("error", value.error);
                 }
                 xmlStream.addAttribute("sqref", value.sqref);
-                (value.formulae || []).forEach((formula, index) => {
+                (value.formulae ?? []).forEach((formula, index) => {
                     xmlStream.openNode(`formula${index + 1}`);
                     if (value.type === "date") {
                         xmlStream.writeText(dateToExcel(new Date(formula)));
@@ -181,7 +181,7 @@ class DataValidationsXform extends BaseXform {
                 return true;
             case "dataValidation": {
                 this._address = node.attributes.sqref;
-                const dataValidation = { type: node.attributes.type || "any", formulae: [] };
+                const dataValidation = { type: node.attributes.type ?? "any", formulae: [] };
                 if (node.attributes.type) {
                     assignBool(dataValidation, node.attributes, "allowBlank");
                 }
@@ -227,7 +227,7 @@ class DataValidationsXform extends BaseXform {
                     delete this._dataValidation.operator;
                 }
                 // The four known cases: 1. E4:L9 N4:U9  2.E4 L9  3. N4:U9  4. E4
-                const list = this._address.split(/\s+/g) || [];
+                const list = this._address.split(/\s+/g);
                 list.forEach((addr) => {
                     if (addr.includes(":")) {
                         // Store ranges directly to avoid expanding large (or many) validations.

package/dist/esm/modules/excel/xlsx/xform/sheet/header-footer-xform.js

@@ -85,22 +85,22 @@ class HeaderFooterXform extends BaseXform {
     parseText(text) {
         switch (this.currentNode) {
             case "oddHeader":
-                this.model.oddHeader = (this.model.oddHeader || "") + text;
+                this.model.oddHeader = (this.model.oddHeader ?? "") + text;
                 break;
             case "oddFooter":
-                this.model.oddFooter = (this.model.oddFooter || "") + text;
+                this.model.oddFooter = (this.model.oddFooter ?? "") + text;
                 break;
             case "evenHeader":
-                this.model.evenHeader = (this.model.evenHeader || "") + text;
+                this.model.evenHeader = (this.model.evenHeader ?? "") + text;
                 break;
             case "evenFooter":
-                this.model.evenFooter = (this.model.evenFooter || "") + text;
+                this.model.evenFooter = (this.model.evenFooter ?? "") + text;
                 break;
             case "firstHeader":
-                this.model.firstHeader = (this.model.firstHeader || "") + text;
+                this.model.firstHeader = (this.model.firstHeader ?? "") + text;
                 break;
             case "firstFooter":
-                this.model.firstFooter = (this.model.firstFooter || "") + text;
+                this.model.firstFooter = (this.model.firstFooter ?? "") + text;
                 break;
             default:
                 break;

package/dist/esm/modules/excel/xlsx/xform/sheet/page-setup-xform.js

@@ -81,21 +81,21 @@ class PageSetupXform extends BaseXform {
             case this.tag:
                 this.model = {
                     paperSize: pageSizeToModel(node.attributes.paperSize),
-                    orientation: node.attributes.orientation || "portrait",
-                    horizontalDpi: parseInt(node.attributes.horizontalDpi || "4294967295", 10),
-                    verticalDpi: parseInt(node.attributes.verticalDpi || "4294967295", 10),
-                    pageOrder: node.attributes.pageOrder || "downThenOver",
+                    orientation: node.attributes.orientation ?? "portrait",
+                    horizontalDpi: parseInt(node.attributes.horizontalDpi ?? "4294967295", 10),
+                    verticalDpi: parseInt(node.attributes.verticalDpi ?? "4294967295", 10),
+                    pageOrder: node.attributes.pageOrder ?? "downThenOver",
                     blackAndWhite: node.attributes.blackAndWhite === "1",
                     draft: node.attributes.draft === "1",
-                    cellComments: node.attributes.cellComments || "None",
-                    errors: node.attributes.errors || "displayed",
-                    scale: parseInt(node.attributes.scale || "100", 10),
-                    fitToWidth: parseInt(node.attributes.fitToWidth || "1", 10),
-                    fitToHeight: parseInt(node.attributes.fitToHeight || "1", 10),
-                    firstPageNumber: parseInt(node.attributes.firstPageNumber || "1", 10),
+                    cellComments: node.attributes.cellComments ?? "None",
+                    errors: node.attributes.errors ?? "displayed",
+                    scale: parseInt(node.attributes.scale ?? "100", 10),
+                    fitToWidth: parseInt(node.attributes.fitToWidth ?? "1", 10),
+                    fitToHeight: parseInt(node.attributes.fitToHeight ?? "1", 10),
+                    firstPageNumber: parseInt(node.attributes.firstPageNumber ?? "1", 10),
                     useFirstPageNumber: node.attributes.useFirstPageNumber === "1",
                     usePrinterDefaults: node.attributes.usePrinterDefaults === "1",
-                    copies: parseInt(node.attributes.copies || "1", 10)
+                    copies: parseInt(node.attributes.copies ?? "1", 10)
                 };
                 return true;
             default:

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

@@ -29,12 +29,12 @@ class SheetFormatPropertiesXform extends BaseXform {
     parseOpen(node) {
         if (node.name === "sheetFormatPr") {
             this.model = {
-                defaultRowHeight: parseFloat(node.attributes.defaultRowHeight || "0"),
+                defaultRowHeight: parseFloat(node.attributes.defaultRowHeight ?? "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)
+                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);

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

@@ -25,7 +25,7 @@ class SheetViewXform extends BaseXform {
         if (model.tabSelected) {
             initialAttrs.tabSelected = "1";
         }
-        initialAttrs.workbookViewId = model.workbookViewId || 0;
+        initialAttrs.workbookViewId = model.workbookViewId ?? 0;
         xmlStream.openNode("sheetView", initialAttrs);
         const add = function (name, value, included) {
             if (included) {
@@ -46,8 +46,8 @@ class SheetViewXform extends BaseXform {
         let activePane;
         switch (model.state) {
             case "frozen":
-                xSplit = model.xSplit || 0;
-                ySplit = model.ySplit || 0;
+                xSplit = model.xSplit ?? 0;
+                ySplit = model.ySplit ?? 0;
                 topLeftCell = model.topLeftCell || colCache.getAddress(ySplit + 1, xSplit + 1).address;
                 activePane =
                     (model.xSplit && model.ySplit && "bottomRight") ||
@@ -105,8 +105,8 @@ class SheetViewXform extends BaseXform {
                     showRuler: !(node.attributes.showRuler === "0"),
                     showRowColHeaders: !(node.attributes.showRowColHeaders === "0"),
                     showGridLines: !(node.attributes.showGridLines === "0"),
-                    zoomScale: parseInt(node.attributes.zoomScale || "100", 10),
-                    zoomScaleNormal: parseInt(node.attributes.zoomScaleNormal || "100", 10),
+                    zoomScale: parseInt(node.attributes.zoomScale ?? "100", 10),
+                    zoomScaleNormal: parseInt(node.attributes.zoomScaleNormal ?? "100", 10),
                     style: node.attributes.view
                 };
                 this.pane = undefined;
@@ -114,15 +114,15 @@ class SheetViewXform extends BaseXform {
                 return true;
             case "pane":
                 this.pane = {
-                    xSplit: parseInt(node.attributes.xSplit || "0", 10),
-                    ySplit: parseInt(node.attributes.ySplit || "0", 10),
+                    xSplit: parseInt(node.attributes.xSplit ?? "0", 10),
+                    ySplit: parseInt(node.attributes.ySplit ?? "0", 10),
                     topLeftCell: node.attributes.topLeftCell,
-                    activePane: node.attributes.activePane || "topLeft",
+                    activePane: node.attributes.activePane ?? "topLeft",
                     state: node.attributes.state
                 };
                 return true;
             case "selection": {
-                const name = node.attributes.pane || "topLeft";
+                const name = node.attributes.pane ?? "topLeft";
                 this.selections[name] = {
                     pane: name,
                     activeCell: node.attributes.activeCell
@@ -144,7 +144,7 @@ class SheetViewXform extends BaseXform {
                         workbookViewId: this.sheetView.workbookViewId,
                         rightToLeft: this.sheetView.rightToLeft,
                         tabSelected: this.sheetView.tabSelected,
-                        state: VIEW_STATES[this.pane.state] || "split", // split is default
+                        state: VIEW_STATES[this.pane.state] ?? "split", // split is default
                         xSplit: this.pane.xSplit,
                         ySplit: this.pane.ySplit,
                         topLeftCell: this.pane.topLeftCell,

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

@@ -85,7 +85,7 @@ class WorkSheetXform extends BaseXform {
     constructor(options) {
         super();
         const { maxRows, maxCols, ignoreNodes } = options || {};
-        this.ignoreNodes = ignoreNodes || [];
+        this.ignoreNodes = ignoreNodes ?? [];
         this.map = {
             sheetPr: new SheetPropertiesXform(),
             dimension: new DimensionXform(),
@@ -293,7 +293,7 @@ class WorkSheetXform extends BaseXform {
             });
         });
         // prepare pivot tables
-        (model.pivotTables || []).forEach((pivotTable) => {
+        (model.pivotTables ?? []).forEach((pivotTable) => {
             rels.push({
                 Id: nextRid(rels),
                 Type: RelType.PivotTable,
@@ -557,8 +557,8 @@ class WorkSheetXform extends BaseXform {
                     drawing: this.map.drawing.model,
                     tables: this.map.tableParts.model,
                     conditionalFormattings,
-                    rowBreaks: this.map.rowBreaks.model || [],
-                    colBreaks: this.map.colBreaks.model || []
+                    rowBreaks: this.map.rowBreaks.model ?? [],
+                    colBreaks: this.map.colBreaks.model ?? []
                 };
                 if (this.map.autoFilter.model) {
                     this.model.autoFilter = this.map.autoFilter.model;
@@ -576,7 +576,7 @@ class WorkSheetXform extends BaseXform {
     reconcile(model, options) {
         // options.merges = new Merges();
         // options.merges.reconcile(model.mergeCells, model.rows);
-        const rels = (model.relationships || []).reduce((h, rel) => {
+        const rels = (model.relationships ?? []).reduce((h, rel) => {
             h[rel.Id] = rel;
             if (rel.Type === RelType.Comments) {
                 model.comments = options.comments[rel.Target].comments;
@@ -589,13 +589,13 @@ class WorkSheetXform extends BaseXform {
             }
             return h;
         }, {});
-        options.commentsMap = (model.comments || []).reduce((h, comment) => {
+        options.commentsMap = (model.comments ?? []).reduce((h, comment) => {
             if (comment.ref) {
                 h[comment.ref] = comment;
             }
             return h;
         }, {});
-        options.hyperlinkMap = (model.hyperlinks || []).reduce((h, hyperlink) => {
+        options.hyperlinkMap = (model.hyperlinks ?? []).reduce((h, hyperlink) => {
             if (hyperlink.rId) {
                 h[hyperlink.address] = rels[hyperlink.rId].Target;
             }
@@ -603,9 +603,9 @@ class WorkSheetXform extends BaseXform {
         }, {});
         options.formulae = {};
         // compact the rows and cells
-        model.rows = (model.rows && model.rows.filter(Boolean)) || [];
+        model.rows = model.rows?.filter(Boolean) ?? [];
         model.rows.forEach(row => {
-            row.cells = (row.cells && row.cells.filter(Boolean)) || [];
+            row.cells = row.cells?.filter(Boolean) ?? [];
         });
         this.map.cols.reconcile(model.cols, options);
         this.map.sheetData.reconcile(model.rows, options);
@@ -623,7 +623,7 @@ class WorkSheetXform extends BaseXform {
                     model.drawing = {
                         ...drawing,
                         name: drawingName,
-                        rels: options.drawingRels?.[drawingName] || drawing.rels || []
+                        rels: options.drawingRels?.[drawingName] ?? drawing.rels ?? []
                     };
                     // Also extract images to model.media for backward compatibility
                     drawing.anchors.forEach(anchor => {
@@ -651,14 +651,14 @@ class WorkSheetXform extends BaseXform {
                 });
             }
         }
-        model.tables = (model.tables || []).map(tablePart => {
+        model.tables = (model.tables ?? []).map(tablePart => {
             const rel = rels[tablePart.rId];
             return options.tables[rel.Target];
         });
         // Link pivot tables from relationships to worksheet
         // This is needed so that when writing, the worksheet knows which pivot tables it contains
         model.pivotTables = [];
-        (model.relationships || []).forEach(rel => {
+        (model.relationships ?? []).forEach(rel => {
             if (rel.Type === RelType.PivotTable && options.pivotTables) {
                 const pivotTable = options.pivotTables[rel.Target];
                 if (pivotTable) {

package/dist/esm/modules/excel/xlsx/xform/strings/phonetic-text-xform.js

@@ -14,8 +14,8 @@ class PhoneticTextXform extends BaseXform {
     }
     render(xmlStream, model) {
         xmlStream.openNode(this.tag, {
-            sb: model.sb || 0,
-            eb: model.eb || 0
+            sb: model.sb ?? 0,
+            eb: model.eb ?? 0
         });
         if (model && Object.prototype.hasOwnProperty.call(model, "richText") && model.richText) {
             const { r } = this.map;

package/dist/esm/modules/excel/xlsx/xform/style/color-xform.js

@@ -4,7 +4,7 @@ class ColorXform extends BaseXform {
     constructor(name) {
         super();
         // this.name controls the xm node name
-        this.name = name || "color";
+        this.name = name ?? "color";
     }
     get tag() {
         return this.name;

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

@@ -16,13 +16,13 @@ class StyleXform extends BaseXform {
     }
     render(xmlStream, model) {
         xmlStream.openNode("xf", {
-            numFmtId: model.numFmtId || 0,
-            fontId: model.fontId || 0,
-            fillId: model.fillId || 0,
-            borderId: model.borderId || 0
+            numFmtId: model.numFmtId ?? 0,
+            fontId: model.fontId ?? 0,
+            fillId: model.fillId ?? 0,
+            borderId: model.borderId ?? 0
         });
         if (this.xfId) {
-            xmlStream.addAttribute("xfId", model.xfId || 0);
+            xmlStream.addAttribute("xfId", model.xfId ?? 0);
         }
         if (model.applyNumberFormat || model.numFmtId) {
             xmlStream.addAttribute("applyNumberFormat", "1");