@cj-tech-master/excelts 3.1.0 → 4.0.0-canary.20260103013222.0e5d37f

package/dist/cjs/modules/excel/xlsx/xform/sheet/outline-properties-xform.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OutlinePropertiesXform = void 0;
+const base_xform_1 = require("../base-xform.js");
+const isDefined = (attr) => typeof attr !== "undefined";
+class OutlinePropertiesXform extends base_xform_1.BaseXform {
+    get tag() {
+        return "outlinePr";
+    }
+    render(xmlStream, model) {
+        if (model && (isDefined(model.summaryBelow) || isDefined(model.summaryRight))) {
+            xmlStream.leafNode(this.tag, {
+                summaryBelow: isDefined(model.summaryBelow) ? Number(model.summaryBelow) : undefined,
+                summaryRight: isDefined(model.summaryRight) ? Number(model.summaryRight) : undefined
+            });
+            return true;
+        }
+        return false;
+    }
+    parseOpen(node) {
+        if (node.name === this.tag) {
+            this.model = {
+                summaryBelow: isDefined(node.attributes.summaryBelow)
+                    ? Boolean(Number(node.attributes.summaryBelow))
+                    : undefined,
+                summaryRight: isDefined(node.attributes.summaryRight)
+                    ? Boolean(Number(node.attributes.summaryRight))
+                    : undefined
+            };
+            return true;
+        }
+        return false;
+    }
+    parseText() { }
+    parseClose() {
+        return false;
+    }
+}
+exports.OutlinePropertiesXform = OutlinePropertiesXform;

package/dist/cjs/modules/excel/xlsx/xform/sheet/page-breaks-xform.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PageBreaksXform = void 0;
+const base_xform_1 = require("../base-xform.js");
+/**
+ * Xform for individual page break (brk element)
+ * Used by both RowBreaksXform and ColBreaksXform
+ */
+class PageBreaksXform extends base_xform_1.BaseXform {
+    get tag() {
+        return "brk";
+    }
+    render(xmlStream, model) {
+        xmlStream.leafNode("brk", model);
+    }
+    parseOpen(node) {
+        if (node.name === "brk") {
+            const { id, max, man, min } = node.attributes;
+            this.model = {
+                id: +id,
+                max: +max,
+                man: +man
+            };
+            if (min !== undefined) {
+                this.model.min = +min;
+            }
+            return true;
+        }
+        return false;
+    }
+    parseText() { }
+    parseClose() {
+        return false;
+    }
+}
+exports.PageBreaksXform = PageBreaksXform;

package/dist/cjs/modules/excel/xlsx/xform/sheet/page-margins-xform.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PageMarginsXform = void 0;
+const base_xform_1 = require("../base-xform.js");
+class PageMarginsXform extends base_xform_1.BaseXform {
+    get tag() {
+        return "pageMargins";
+    }
+    render(xmlStream, model) {
+        if (model) {
+            const attributes = {
+                left: model.left,
+                right: model.right,
+                top: model.top,
+                bottom: model.bottom,
+                header: model.header,
+                footer: model.footer
+            };
+            if (Object.values(attributes).some((value) => value !== undefined)) {
+                xmlStream.leafNode(this.tag, attributes);
+            }
+        }
+    }
+    parseOpen(node) {
+        switch (node.name) {
+            case this.tag:
+                this.model = {
+                    left: parseFloat(node.attributes.left || 0.7),
+                    right: parseFloat(node.attributes.right || 0.7),
+                    top: parseFloat(node.attributes.top || 0.75),
+                    bottom: parseFloat(node.attributes.bottom || 0.75),
+                    header: parseFloat(node.attributes.header || 0.3),
+                    footer: parseFloat(node.attributes.footer || 0.3)
+                };
+                return true;
+            default:
+                return false;
+        }
+    }
+    parseText() { }
+    parseClose() {
+        return false;
+    }
+}
+exports.PageMarginsXform = PageMarginsXform;

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

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PageSetupPropertiesXform = void 0;
+const base_xform_1 = require("../base-xform.js");
+class PageSetupPropertiesXform extends base_xform_1.BaseXform {
+    get tag() {
+        return "pageSetUpPr";
+    }
+    render(xmlStream, model) {
+        if (model && model.fitToPage) {
+            xmlStream.leafNode(this.tag, {
+                fitToPage: model.fitToPage ? "1" : undefined
+            });
+            return true;
+        }
+        return false;
+    }
+    parseOpen(node) {
+        if (node.name === this.tag) {
+            this.model = {
+                fitToPage: node.attributes.fitToPage === "1"
+            };
+            return true;
+        }
+        return false;
+    }
+    parseText() { }
+    parseClose() {
+        return false;
+    }
+}
+exports.PageSetupPropertiesXform = PageSetupPropertiesXform;

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

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PageSetupXform = void 0;
+const base_xform_1 = require("../base-xform.js");
+function booleanToXml(model) {
+    return model ? "1" : undefined;
+}
+function pageOrderToXml(model) {
+    switch (model) {
+        case "overThenDown":
+            return model;
+        default:
+            return undefined;
+    }
+}
+function cellCommentsToXml(model) {
+    switch (model) {
+        case "atEnd":
+        case "asDisplyed":
+            return model;
+        default:
+            return undefined;
+    }
+}
+function errorsToXml(model) {
+    switch (model) {
+        case "dash":
+        case "blank":
+        case "NA":
+            return model;
+        default:
+            return undefined;
+    }
+}
+function pageSizeToModel(value) {
+    return value !== undefined ? parseInt(value, 10) : undefined;
+}
+class PageSetupXform extends base_xform_1.BaseXform {
+    get tag() {
+        return "pageSetup";
+    }
+    render(xmlStream, model) {
+        if (model) {
+            const attributes = {
+                paperSize: model.paperSize,
+                orientation: model.orientation,
+                horizontalDpi: model.horizontalDpi,
+                verticalDpi: model.verticalDpi,
+                pageOrder: pageOrderToXml(model.pageOrder),
+                blackAndWhite: booleanToXml(model.blackAndWhite),
+                draft: booleanToXml(model.draft),
+                cellComments: cellCommentsToXml(model.cellComments),
+                errors: errorsToXml(model.errors),
+                // Only output non-default values (matches Excel behavior)
+                scale: model.scale !== 100 ? model.scale : undefined,
+                fitToWidth: model.fitToWidth !== 1 ? model.fitToWidth : undefined,
+                fitToHeight: model.fitToHeight !== 1 ? model.fitToHeight : undefined,
+                firstPageNumber: model.firstPageNumber,
+                useFirstPageNumber: booleanToXml(!!model.firstPageNumber),
+                usePrinterDefaults: booleanToXml(model.usePrinterDefaults),
+                copies: model.copies
+            };
+            if (Object.values(attributes).some((value) => value !== undefined)) {
+                xmlStream.leafNode(this.tag, attributes);
+            }
+        }
+    }
+    parseOpen(node) {
+        switch (node.name) {
+            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",
+                    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),
+                    useFirstPageNumber: node.attributes.useFirstPageNumber === "1",
+                    usePrinterDefaults: node.attributes.usePrinterDefaults === "1",
+                    copies: parseInt(node.attributes.copies || "1", 10)
+                };
+                return true;
+            default:
+                return false;
+        }
+    }
+    parseText() { }
+    parseClose() {
+        return false;
+    }
+}
+exports.PageSetupXform = PageSetupXform;

package/dist/cjs/modules/excel/xlsx/xform/sheet/picture-xform.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PictureXform = void 0;
+const base_xform_1 = require("../base-xform.js");
+class PictureXform extends base_xform_1.BaseXform {
+    get tag() {
+        return "picture";
+    }
+    render(xmlStream, model) {
+        if (model) {
+            xmlStream.leafNode(this.tag, { "r:id": model.rId });
+        }
+    }
+    parseOpen(node) {
+        switch (node.name) {
+            case this.tag:
+                this.model = {
+                    rId: node.attributes["r:id"]
+                };
+                return true;
+            default:
+                return false;
+        }
+    }
+    parseText() { }
+    parseClose() {
+        return false;
+    }
+}
+exports.PictureXform = PictureXform;

package/dist/cjs/modules/excel/xlsx/xform/sheet/print-options-xform.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PrintOptionsXform = void 0;
+const base_xform_1 = require("../base-xform.js");
+function booleanToXml(model) {
+    return model ? "1" : undefined;
+}
+class PrintOptionsXform extends base_xform_1.BaseXform {
+    get tag() {
+        return "printOptions";
+    }
+    render(xmlStream, model) {
+        if (model) {
+            const attributes = {
+                headings: booleanToXml(model.showRowColHeaders),
+                gridLines: booleanToXml(model.showGridLines),
+                horizontalCentered: booleanToXml(model.horizontalCentered),
+                verticalCentered: booleanToXml(model.verticalCentered)
+            };
+            if (Object.values(attributes).some((value) => value !== undefined)) {
+                xmlStream.leafNode(this.tag, attributes);
+            }
+        }
+    }
+    parseOpen(node) {
+        switch (node.name) {
+            case this.tag:
+                this.model = {
+                    showRowColHeaders: node.attributes.headings === "1",
+                    showGridLines: node.attributes.gridLines === "1",
+                    horizontalCentered: node.attributes.horizontalCentered === "1",
+                    verticalCentered: node.attributes.verticalCentered === "1"
+                };
+                return true;
+            default:
+                return false;
+        }
+    }
+    parseText() { }
+    parseClose() {
+        return false;
+    }
+}
+exports.PrintOptionsXform = PrintOptionsXform;

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

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RowBreaksXform = void 0;
+const page_breaks_xform_1 = require("./page-breaks-xform.js");
+const list_xform_1 = require("../list-xform.js");
+/**
+ * Xform for row page breaks (rowBreaks element in worksheet XML)
+ * Used to define manual page breaks between rows when printing.
+ */
+class RowBreaksXform extends list_xform_1.ListXform {
+    constructor() {
+        super({
+            tag: "rowBreaks",
+            count: true,
+            childXform: new page_breaks_xform_1.PageBreaksXform()
+        });
+    }
+    // Override to add manualBreakCount attribute required by Excel
+    render(xmlStream, model) {
+        if (model && model.length) {
+            xmlStream.openNode(this.tag, this.$);
+            xmlStream.addAttribute(this.$count, model.length);
+            xmlStream.addAttribute("manualBreakCount", model.length);
+            const { childXform } = this;
+            for (const childModel of model) {
+                childXform.render(xmlStream, childModel);
+            }
+            xmlStream.closeNode();
+        }
+    }
+}
+exports.RowBreaksXform = RowBreaksXform;

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

@@ -0,0 +1,155 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RowXform = void 0;
+const base_xform_1 = require("../base-xform.js");
+const cell_xform_1 = require("./cell-xform.js");
+const utils_1 = require("../../../../../utils/utils.js");
+const col_cache_1 = require("../../../utils/col-cache.js");
+class RowXform extends base_xform_1.BaseXform {
+    constructor(options) {
+        super();
+        this.maxItems = options && options.maxItems;
+        this.map = {
+            c: new cell_xform_1.CellXform()
+        };
+    }
+    get tag() {
+        return "row";
+    }
+    reset() {
+        super.reset();
+        this.numRowsSeen = 0;
+        this.lastCellCol = 0;
+    }
+    prepare(model, options) {
+        const styleId = options.styles.addStyleModel(model.style);
+        if (styleId) {
+            model.styleId = styleId;
+        }
+        const cellXform = this.map.c;
+        model.cells.forEach((cellModel) => {
+            cellXform.prepare(cellModel, options);
+        });
+    }
+    render(xmlStream, model, options) {
+        if (!model) {
+            return;
+        }
+        xmlStream.openNode("row");
+        xmlStream.addAttribute("r", model.number);
+        if (model.height) {
+            xmlStream.addAttribute("ht", model.height);
+            xmlStream.addAttribute("customHeight", "1");
+        }
+        if (model.hidden) {
+            xmlStream.addAttribute("hidden", "1");
+        }
+        if (model.min > 0 && model.max > 0 && model.min <= model.max) {
+            xmlStream.addAttribute("spans", `${model.min}:${model.max}`);
+        }
+        if (model.styleId) {
+            xmlStream.addAttribute("s", model.styleId);
+            xmlStream.addAttribute("customFormat", "1");
+        }
+        // Note: dyDescent is MS extension, not output by default (Excel auto-calculates)
+        if (model.outlineLevel) {
+            xmlStream.addAttribute("outlineLevel", model.outlineLevel);
+        }
+        if (model.collapsed) {
+            xmlStream.addAttribute("collapsed", "1");
+        }
+        const cellXform = this.map.c;
+        model.cells.forEach((cellModel) => {
+            cellXform.render(xmlStream, cellModel, options);
+        });
+        xmlStream.closeNode();
+    }
+    parseOpen(node) {
+        if (this.parser) {
+            this.parser.parseOpen(node);
+            return true;
+        }
+        if (node.name === "row") {
+            this.numRowsSeen += 1;
+            // Reset lastCellCol for each new row
+            this.lastCellCol = 0;
+            const spans = node.attributes.spans
+                ? node.attributes.spans.split(":").map((span) => parseInt(span, 10))
+                : [undefined, undefined];
+            // If r attribute is missing, use numRowsSeen as the row number
+            const rowNumber = node.attributes.r ? parseInt(node.attributes.r, 10) : this.numRowsSeen;
+            const model = (this.model = {
+                number: rowNumber,
+                min: spans[0],
+                max: spans[1],
+                cells: []
+            });
+            if (node.attributes.s) {
+                model.styleId = parseInt(node.attributes.s, 10);
+            }
+            if ((0, utils_1.parseBoolean)(node.attributes.hidden)) {
+                model.hidden = true;
+            }
+            if ((0, utils_1.parseBoolean)(node.attributes.bestFit)) {
+                model.bestFit = true;
+            }
+            if (node.attributes.ht) {
+                model.height = parseFloat(node.attributes.ht);
+            }
+            if (node.attributes.outlineLevel) {
+                model.outlineLevel = parseInt(node.attributes.outlineLevel, 10);
+            }
+            if ((0, utils_1.parseBoolean)(node.attributes.collapsed)) {
+                model.collapsed = true;
+            }
+            return true;
+        }
+        this.parser = this.map[node.name];
+        if (this.parser) {
+            this.parser.parseOpen(node);
+            return true;
+        }
+        return false;
+    }
+    parseText(text) {
+        if (this.parser) {
+            this.parser.parseText(text);
+        }
+    }
+    parseClose(name) {
+        if (this.parser) {
+            if (!this.parser.parseClose(name)) {
+                const cellModel = this.parser.model;
+                // If cell has address, extract column number from it
+                // Otherwise, calculate address based on position
+                if (cellModel.address) {
+                    const decoded = col_cache_1.colCache.decodeAddress(cellModel.address);
+                    this.lastCellCol = decoded.col;
+                }
+                else {
+                    // No r attribute, calculate address from position
+                    this.lastCellCol += 1;
+                    cellModel.address = col_cache_1.colCache.encodeAddress(this.model.number, this.lastCellCol);
+                }
+                this.model.cells.push(cellModel);
+                if (this.maxItems && this.model.cells.length > this.maxItems) {
+                    throw new Error(`Max column count (${this.maxItems}) exceeded`);
+                }
+                this.parser = undefined;
+            }
+            return true;
+        }
+        return false;
+    }
+    reconcile(model, options) {
+        model.style = model.styleId ? options.styles.getStyleModel(model.styleId) : {};
+        if (model.styleId !== undefined) {
+            model.styleId = undefined;
+        }
+        const cellXform = this.map.c;
+        model.cells.forEach((cellModel) => {
+            cellXform.reconcile(cellModel, options);
+        });
+    }
+}
+exports.RowXform = RowXform;

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

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SheetFormatPropertiesXform = void 0;
+const base_xform_1 = require("../base-xform.js");
+class SheetFormatPropertiesXform extends base_xform_1.BaseXform {
+    get tag() {
+        return "sheetFormatPr";
+    }
+    render(xmlStream, model) {
+        if (model) {
+            const attributes = {
+                defaultRowHeight: model.defaultRowHeight,
+                // Only output outlineLevelRow/Col when non-zero (matches Excel behavior)
+                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
+            };
+            // 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) {
+                attributes.customHeight = "1";
+            }
+            if (Object.values(attributes).some((value) => value !== undefined)) {
+                xmlStream.leafNode("sheetFormatPr", attributes);
+            }
+        }
+    }
+    parseOpen(node) {
+        if (node.name === "sheetFormatPr") {
+            this.model = {
+                defaultRowHeight: parseFloat(node.attributes.defaultRowHeight || "0"),
+                dyDescent: parseFloat(node.attributes["x14ac:dyDescent"] || "0"),
+                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);
+            }
+            return true;
+        }
+        return false;
+    }
+    parseText() { }
+    parseClose() {
+        return false;
+    }
+}
+exports.SheetFormatPropertiesXform = SheetFormatPropertiesXform;

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

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SheetPropertiesXform = void 0;
+const base_xform_1 = require("../base-xform.js");
+const color_xform_1 = require("../style/color-xform.js");
+const page_setup_properties_xform_1 = require("./page-setup-properties-xform.js");
+const outline_properties_xform_1 = require("./outline-properties-xform.js");
+class SheetPropertiesXform extends base_xform_1.BaseXform {
+    constructor() {
+        super();
+        this.map = {
+            tabColor: new color_xform_1.ColorXform("tabColor"),
+            pageSetUpPr: new page_setup_properties_xform_1.PageSetupPropertiesXform(),
+            outlinePr: new outline_properties_xform_1.OutlinePropertiesXform()
+        };
+    }
+    get tag() {
+        return "sheetPr";
+    }
+    render(xmlStream, model) {
+        if (model) {
+            xmlStream.addRollback();
+            xmlStream.openNode("sheetPr");
+            let inner = false;
+            inner = this.map.tabColor.render(xmlStream, model.tabColor) || inner;
+            inner = this.map.pageSetUpPr.render(xmlStream, model.pageSetup) || inner;
+            inner = this.map.outlinePr.render(xmlStream, model.outlineProperties) || inner;
+            if (inner) {
+                xmlStream.closeNode();
+                xmlStream.commit();
+            }
+            else {
+                xmlStream.rollback();
+            }
+        }
+    }
+    parseOpen(node) {
+        if (this.parser) {
+            this.parser.parseOpen(node);
+            return true;
+        }
+        if (node.name === this.tag) {
+            this.reset();
+            return true;
+        }
+        if (this.map[node.name]) {
+            this.parser = this.map[node.name];
+            this.parser.parseOpen(node);
+            return true;
+        }
+        return false;
+    }
+    parseText(text) {
+        if (this.parser) {
+            this.parser.parseText(text);
+            return true;
+        }
+        return false;
+    }
+    parseClose(_name) {
+        if (this.parser) {
+            if (!this.parser.parseClose(_name)) {
+                this.parser = undefined;
+            }
+            return true;
+        }
+        if (this.map.tabColor.model || this.map.pageSetUpPr.model || this.map.outlinePr.model) {
+            this.model = {};
+            if (this.map.tabColor.model) {
+                this.model.tabColor = this.map.tabColor.model;
+            }
+            if (this.map.pageSetUpPr.model) {
+                this.model.pageSetup = this.map.pageSetUpPr.model;
+            }
+            if (this.map.outlinePr.model) {
+                this.model.outlineProperties = this.map.outlinePr.model;
+            }
+        }
+        else {
+            this.model = null;
+        }
+        return false;
+    }
+}
+exports.SheetPropertiesXform = SheetPropertiesXform;