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

package/dist/browser/modules/excel/xlsx/xform/style/protection-xform.d.ts

@@ -0,0 +1,13 @@
+import { BaseXform } from "@excel/xlsx/xform/base-xform";
+interface ProtectionModel {
+    locked?: boolean;
+    hidden?: boolean;
+}
+declare class ProtectionXform extends BaseXform {
+    get tag(): string;
+    render(xmlStream: any, model: ProtectionModel): void;
+    parseOpen(node: any): void;
+    parseText(): void;
+    parseClose(): boolean;
+}
+export { ProtectionXform };

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

@@ -0,0 +1,30 @@
+import { BaseXform } from "@excel/xlsx/xform/base-xform";
+import { AlignmentXform } from "@excel/xlsx/xform/style/alignment-xform";
+import { ProtectionXform } from "@excel/xlsx/xform/style/protection-xform";
+interface StyleModel {
+    numFmtId?: number;
+    fontId?: number;
+    fillId?: number;
+    borderId?: number;
+    xfId?: number;
+    alignment?: any;
+    protection?: any;
+}
+interface StyleOptions {
+    xfId?: boolean;
+}
+declare class StyleXform extends BaseXform {
+    private xfId;
+    map: {
+        alignment: AlignmentXform;
+        protection: ProtectionXform;
+    };
+    parser: any;
+    constructor(options?: StyleOptions);
+    get tag(): string;
+    render(xmlStream: any, model: StyleModel): void;
+    parseOpen(node: any): boolean;
+    parseText(text: string): void;
+    parseClose(name: string): boolean;
+}
+export { StyleXform };

package/dist/browser/modules/excel/xlsx/xform/style/styles-xform.d.ts

@@ -0,0 +1,46 @@
+import { BaseXform } from "@excel/xlsx/xform/base-xform";
+import { StaticXform } from "@excel/xlsx/xform/static-xform";
+interface StylesModel {
+    styles?: any[];
+    numFmts?: any[];
+    fonts?: any[];
+    borders?: any[];
+    fills?: any[];
+    dxfs?: any[];
+}
+declare class StylesXform extends BaseXform {
+    private index?;
+    private weakMap?;
+    parser: any;
+    static Mock: typeof StylesXform;
+    constructor(initialise?: boolean);
+    initIndex(): void;
+    init(): void;
+    render(xmlStream: any, model?: StylesModel): void;
+    parseOpen(node: any): boolean;
+    parseText(text: string): void;
+    parseClose(name: string): boolean;
+    addStyleModel(model: any, cellType?: number): number;
+    getStyleModel(id: number): any;
+    addDxfStyle(style: any): number;
+    getDxfStyle(id: number): any;
+    _addStyle(style: any): number;
+    _addNumFmtStr(formatCode: string): number;
+    _addFont(font: any): number;
+    _addBorder(border: any): number;
+    _addFill(fill: any): number;
+    static STYLESHEET_ATTRIBUTES: {
+        xmlns: string;
+        "xmlns:mc": string;
+        "mc:Ignorable": string;
+        "xmlns:x14ac": string;
+        "xmlns:x16r2": string;
+    };
+    static STATIC_XFORMS: {
+        cellStyles: StaticXform;
+        dxfs: StaticXform;
+        tableStyles: StaticXform;
+        extLst: StaticXform;
+    };
+}
+export { StylesXform };

package/dist/browser/modules/excel/xlsx/xform/style/styles-xform.js

@@ -0,0 +1,484 @@
+import { Enums } from "../../../enums.js";
+import { XmlStream } from "../../../utils/xml-stream.js";
+import { BaseXform } from "../base-xform.js";
+import { StaticXform } from "../static-xform.js";
+import { ListXform } from "../list-xform.js";
+import { FontXform } from "./font-xform.js";
+import { FillXform } from "./fill-xform.js";
+import { BorderXform } from "./border-xform.js";
+import { NumFmtXform } from "./numfmt-xform.js";
+import { StyleXform } from "./style-xform.js";
+import { DxfXform } from "./dxf-xform.js";
+// custom numfmt ids start here
+const NUMFMT_BASE = 164;
+// =============================================================================
+// StylesXform is used to generate and parse the styles.xml file
+// it manages the collections of fonts, number formats, alignments, etc
+class StylesXform extends BaseXform {
+    constructor(initialise) {
+        super();
+        this.map = {
+            numFmts: new ListXform({ tag: "numFmts", count: true, childXform: new NumFmtXform() }),
+            fonts: new ListXform({
+                tag: "fonts",
+                count: true,
+                childXform: new FontXform(),
+                $: { "x14ac:knownFonts": 1 }
+            }),
+            fills: new ListXform({ tag: "fills", count: true, childXform: new FillXform() }),
+            borders: new ListXform({ tag: "borders", count: true, childXform: new BorderXform() }),
+            cellStyleXfs: new ListXform({
+                tag: "cellStyleXfs",
+                count: true,
+                childXform: new StyleXform()
+            }),
+            cellXfs: new ListXform({
+                tag: "cellXfs",
+                count: true,
+                childXform: new StyleXform({ xfId: true })
+            }),
+            dxfs: new ListXform({ tag: "dxfs", always: true, count: true, childXform: new DxfXform() }),
+            // for style manager
+            numFmt: new NumFmtXform(),
+            font: new FontXform(),
+            fill: new FillXform(),
+            border: new BorderXform(),
+            style: new StyleXform({ xfId: true }),
+            cellStyles: StylesXform.STATIC_XFORMS.cellStyles,
+            tableStyles: StylesXform.STATIC_XFORMS.tableStyles,
+            extLst: StylesXform.STATIC_XFORMS.extLst
+        };
+        if (initialise) {
+            // StylesXform also acts as style manager and is used to build up styles-model during worksheet processing
+            this.init();
+        }
+    }
+    initIndex() {
+        this.index = {
+            style: {},
+            numFmt: {},
+            numFmtNextId: 164, // start custom format ids here
+            font: {},
+            border: {},
+            fill: {}
+        };
+    }
+    init() {
+        // Prepare for Style Manager role
+        this.model = {
+            styles: [],
+            numFmts: [],
+            fonts: [],
+            borders: [],
+            fills: [],
+            dxfs: []
+        };
+        this.initIndex();
+        // default (zero) border
+        this._addBorder({});
+        // add default (all zero) style
+        this._addStyle({ numFmtId: 0, fontId: 0, fillId: 0, borderId: 0, xfId: 0 });
+        // add default fills
+        this._addFill({ type: "pattern", pattern: "none" });
+        this._addFill({ type: "pattern", pattern: "gray125" });
+        this.weakMap = new WeakMap();
+    }
+    render(xmlStream, model) {
+        const renderModel = model || this.model;
+        //
+        //   <fonts count="2" x14ac:knownFonts="1">
+        xmlStream.openXml(XmlStream.StdDocAttributes);
+        xmlStream.openNode("styleSheet", StylesXform.STYLESHEET_ATTRIBUTES);
+        if (this.index) {
+            // model has been built by style manager role (contains xml)
+            if (renderModel.numFmts && renderModel.numFmts.length) {
+                xmlStream.openNode("numFmts", { count: renderModel.numFmts.length });
+                renderModel.numFmts.forEach((numFmtXml) => {
+                    xmlStream.writeXml(numFmtXml);
+                });
+                xmlStream.closeNode();
+            }
+            if (!renderModel.fonts.length) {
+                // default (zero) font
+                this._addFont({
+                    size: 11,
+                    color: { theme: 1 },
+                    name: "Calibri",
+                    family: 2,
+                    scheme: "minor"
+                });
+            }
+            xmlStream.openNode("fonts", { count: renderModel.fonts.length, "x14ac:knownFonts": 1 });
+            renderModel.fonts.forEach((fontXml) => {
+                xmlStream.writeXml(fontXml);
+            });
+            xmlStream.closeNode();
+            xmlStream.openNode("fills", { count: renderModel.fills.length });
+            renderModel.fills.forEach((fillXml) => {
+                xmlStream.writeXml(fillXml);
+            });
+            xmlStream.closeNode();
+            xmlStream.openNode("borders", { count: renderModel.borders.length });
+            renderModel.borders.forEach((borderXml) => {
+                xmlStream.writeXml(borderXml);
+            });
+            xmlStream.closeNode();
+            this.map.cellStyleXfs.render(xmlStream, [
+                { numFmtId: 0, fontId: 0, fillId: 0, borderId: 0, xfId: 0 }
+            ]);
+            xmlStream.openNode("cellXfs", { count: renderModel.styles.length });
+            renderModel.styles.forEach((styleXml) => {
+                xmlStream.writeXml(styleXml);
+            });
+            xmlStream.closeNode();
+        }
+        else {
+            // model is plain JSON and needs to be xformed
+            this.map.numFmts.render(xmlStream, renderModel.numFmts);
+            this.map.fonts.render(xmlStream, renderModel.fonts);
+            this.map.fills.render(xmlStream, renderModel.fills);
+            this.map.borders.render(xmlStream, renderModel.borders);
+            this.map.cellStyleXfs.render(xmlStream, [
+                { numFmtId: 0, fontId: 0, fillId: 0, borderId: 0, xfId: 0 }
+            ]);
+            this.map.cellXfs.render(xmlStream, renderModel.styles);
+        }
+        StylesXform.STATIC_XFORMS.cellStyles.render(xmlStream);
+        this.map.dxfs.render(xmlStream, renderModel.dxfs);
+        StylesXform.STATIC_XFORMS.tableStyles.render(xmlStream);
+        StylesXform.STATIC_XFORMS.extLst.render(xmlStream);
+        xmlStream.closeNode();
+    }
+    parseOpen(node) {
+        if (this.parser) {
+            this.parser.parseOpen(node);
+            return true;
+        }
+        switch (node.name) {
+            case "styleSheet":
+                this.initIndex();
+                return true;
+            default:
+                this.parser = this.map[node.name];
+                if (this.parser) {
+                    this.parser.parseOpen(node);
+                }
+                return true;
+        }
+    }
+    parseText(text) {
+        if (this.parser) {
+            this.parser.parseText(text);
+        }
+    }
+    parseClose(name) {
+        if (this.parser) {
+            if (!this.parser.parseClose(name)) {
+                this.parser = undefined;
+            }
+            return true;
+        }
+        switch (name) {
+            case "styleSheet": {
+                this.model = {};
+                const add = (propName, xform) => {
+                    if (xform.model && xform.model.length) {
+                        this.model[propName] = xform.model;
+                    }
+                };
+                add("numFmts", this.map.numFmts);
+                add("fonts", this.map.fonts);
+                add("fills", this.map.fills);
+                add("borders", this.map.borders);
+                add("styles", this.map.cellXfs);
+                add("dxfs", this.map.dxfs);
+                // index numFmts
+                this.index = {
+                    model: [],
+                    numFmt: {}
+                };
+                if (this.model.numFmts) {
+                    const numFmtIndex = this.index.numFmt;
+                    this.model.numFmts.forEach((numFmt) => {
+                        numFmtIndex[numFmt.id] = numFmt.formatCode;
+                    });
+                }
+                return false;
+            }
+            default:
+                // not quite sure how we get here!
+                return true;
+        }
+    }
+    // add a cell's style model to the collection
+    // each style property is processed and cross-referenced, etc.
+    // the styleId is returned. Note: cellType is used when numFmt not defined
+    addStyleModel(model, cellType) {
+        if (!model) {
+            return 0;
+        }
+        // if we have no default font, add it here now
+        if (!this.model.fonts.length) {
+            // default (zero) font
+            this._addFont({ size: 11, color: { theme: 1 }, name: "Calibri", family: 2, scheme: "minor" });
+        }
+        // if we have seen this style object before, assume it has the same styleId
+        if (this.weakMap && this.weakMap.has(model)) {
+            return this.weakMap.get(model);
+        }
+        const style = {};
+        const type = cellType || Enums.ValueType.Number;
+        if (model.numFmt) {
+            style.numFmtId = this._addNumFmtStr(model.numFmt);
+        }
+        else {
+            switch (type) {
+                case Enums.ValueType.Number:
+                    style.numFmtId = this._addNumFmtStr("General");
+                    break;
+                case Enums.ValueType.Date:
+                    style.numFmtId = this._addNumFmtStr("mm-dd-yy");
+                    break;
+                default:
+                    break;
+            }
+        }
+        if (model.font) {
+            style.fontId = this._addFont(model.font);
+        }
+        if (model.border) {
+            style.borderId = this._addBorder(model.border);
+        }
+        if (model.fill) {
+            style.fillId = this._addFill(model.fill);
+        }
+        if (model.alignment) {
+            style.alignment = model.alignment;
+        }
+        if (model.protection) {
+            style.protection = model.protection;
+        }
+        const styleId = this._addStyle(style);
+        if (this.weakMap) {
+            this.weakMap.set(model, styleId);
+        }
+        return styleId;
+    }
+    // given a styleId (i.e. s="n"), get the cell's style model
+    // objects are shared where possible.
+    getStyleModel(id) {
+        // if the style doesn't exist return null
+        const style = this.model.styles[id];
+        if (!style) {
+            return null;
+        }
+        // have we built this model before?
+        let model = this.index.model[id];
+        if (model) {
+            return model;
+        }
+        // build a new model
+        model = this.index.model[id] = {};
+        // -------------------------------------------------------
+        // number format
+        if (style.numFmtId) {
+            const numFmt = this.index.numFmt[style.numFmtId] ||
+                NumFmtXform.getDefaultFmtCode(style.numFmtId);
+            if (numFmt) {
+                model.numFmt = numFmt;
+            }
+        }
+        function addStyle(name, group, styleId) {
+            if (styleId || styleId === 0) {
+                const part = group[styleId];
+                if (part) {
+                    model[name] = part;
+                }
+            }
+        }
+        addStyle("font", this.model.fonts, style.fontId);
+        addStyle("border", this.model.borders, style.borderId);
+        addStyle("fill", this.model.fills, style.fillId);
+        // -------------------------------------------------------
+        // alignment
+        if (style.alignment) {
+            model.alignment = style.alignment;
+        }
+        // -------------------------------------------------------
+        // protection
+        if (style.protection) {
+            model.protection = style.protection;
+        }
+        return model;
+    }
+    addDxfStyle(style) {
+        if (style.numFmt) {
+            // register numFmtId to use it during dxf-xform rendering
+            style.numFmtId = this._addNumFmtStr(style.numFmt);
+        }
+        this.model.dxfs.push(style);
+        return this.model.dxfs.length - 1;
+    }
+    getDxfStyle(id) {
+        return this.model.dxfs[id];
+    }
+    // =========================================================================
+    // Private Interface
+    _addStyle(style) {
+        const xml = this.map.style.toXml(style);
+        let index = this.index.style[xml];
+        if (index === undefined) {
+            index = this.index.style[xml] = this.model.styles.length;
+            this.model.styles.push(xml);
+        }
+        return index;
+    }
+    // =========================================================================
+    // Number Formats
+    _addNumFmtStr(formatCode) {
+        // check if default format
+        let index = NumFmtXform.getDefaultFmtId(formatCode);
+        if (index !== undefined) {
+            return index;
+        }
+        // check if already in
+        index = this.index.numFmt[formatCode];
+        if (index !== undefined) {
+            return index;
+        }
+        index = this.index.numFmt[formatCode] = NUMFMT_BASE + this.model.numFmts.length;
+        const xml = this.map.numFmt.toXml({ id: index, formatCode });
+        this.model.numFmts.push(xml);
+        return index;
+    }
+    // =========================================================================
+    // Fonts
+    _addFont(font) {
+        const xml = this.map.font.toXml(font);
+        let index = this.index.font[xml];
+        if (index === undefined) {
+            index = this.index.font[xml] = this.model.fonts.length;
+            this.model.fonts.push(xml);
+        }
+        return index;
+    }
+    // =========================================================================
+    // Borders
+    _addBorder(border) {
+        const xml = this.map.border.toXml(border);
+        let index = this.index.border[xml];
+        if (index === undefined) {
+            index = this.index.border[xml] = this.model.borders.length;
+            this.model.borders.push(xml);
+        }
+        return index;
+    }
+    // =========================================================================
+    // Fills
+    _addFill(fill) {
+        const xml = this.map.fill.toXml(fill);
+        let index = this.index.fill[xml];
+        if (index === undefined) {
+            index = this.index.fill[xml] = this.model.fills.length;
+            this.model.fills.push(xml);
+        }
+        return index;
+    }
+}
+// =========================================================================
+StylesXform.STYLESHEET_ATTRIBUTES = {
+    xmlns: "http://schemas.openxmlformats.org/spreadsheetml/2006/main",
+    "xmlns:mc": "http://schemas.openxmlformats.org/markup-compatibility/2006",
+    "mc:Ignorable": "x14ac x16r2",
+    "xmlns:x14ac": "http://schemas.microsoft.com/office/spreadsheetml/2009/9/ac",
+    "xmlns:x16r2": "http://schemas.microsoft.com/office/spreadsheetml/2015/02/main"
+};
+StylesXform.STATIC_XFORMS = {
+    cellStyles: new StaticXform({
+        tag: "cellStyles",
+        $: { count: 1 },
+        c: [{ tag: "cellStyle", $: { name: "Normal", xfId: 0, builtinId: 0 } }]
+    }),
+    dxfs: new StaticXform({ tag: "dxfs", $: { count: 0 } }),
+    tableStyles: new StaticXform({
+        tag: "tableStyles",
+        $: {
+            count: 0,
+            defaultTableStyle: "TableStyleMedium2",
+            defaultPivotStyle: "PivotStyleLight16"
+        }
+    }),
+    extLst: new StaticXform({
+        tag: "extLst",
+        c: [
+            {
+                tag: "ext",
+                $: {
+                    uri: "{EB79DEF2-80B8-43e5-95BD-54CBDDF9020C}",
+                    "xmlns:x14": "http://schemas.microsoft.com/office/spreadsheetml/2009/9/main"
+                },
+                c: [{ tag: "x14:slicerStyles", $: { defaultSlicerStyle: "SlicerStyleLight1" } }]
+            },
+            {
+                tag: "ext",
+                $: {
+                    uri: "{9260A510-F301-46a8-8635-F512D64BE5F5}",
+                    "xmlns:x15": "http://schemas.microsoft.com/office/spreadsheetml/2010/11/main"
+                },
+                c: [{ tag: "x15:timelineStyles", $: { defaultTimelineStyle: "TimeSlicerStyleLight1" } }]
+            }
+        ]
+    })
+};
+// the stylemanager mock acts like StyleManager except that it always returns 0 or {}
+class StylesXformMock extends StylesXform {
+    constructor() {
+        super();
+        this.model = {
+            styles: [{ numFmtId: 0, fontId: 0, fillId: 0, borderId: 0, xfId: 0 }],
+            numFmts: [],
+            fonts: [{ size: 11, color: { theme: 1 }, name: "Calibri", family: 2, scheme: "minor" }],
+            borders: [{}],
+            fills: [
+                { type: "pattern", pattern: "none" },
+                { type: "pattern", pattern: "gray125" }
+            ]
+        };
+    }
+    // =========================================================================
+    // Style Manager Interface
+    // override normal behaviour - consume and dispose
+    parseStream(stream) {
+        stream.autodrain();
+        return Promise.resolve();
+    }
+    // add a cell's style model to the collection
+    // each style property is processed and cross-referenced, etc.
+    // the styleId is returned. Note: cellType is used when numFmt not defined
+    addStyleModel(model, cellType) {
+        switch (cellType) {
+            case Enums.ValueType.Date:
+                return this.dateStyleId;
+            default:
+                return 0;
+        }
+    }
+    get dateStyleId() {
+        if (!this._dateStyleId) {
+            const dateStyle = {
+                numFmtId: NumFmtXform.getDefaultFmtId("mm-dd-yy")
+            };
+            this._dateStyleId = this.model.styles.length;
+            this.model.styles.push(dateStyle);
+        }
+        return this._dateStyleId;
+    }
+    // given a styleId (i.e. s="n"), get the cell's style model
+    // objects are shared where possible.
+    getStyleModel( /* id */) {
+        return {};
+    }
+}
+// Assign Mock after class declaration to avoid "used before declaration" error
+StylesXform.Mock = StylesXformMock;
+export { StylesXform };

package/dist/browser/modules/excel/xlsx/xform/style/underline-xform.d.ts

@@ -0,0 +1,14 @@
+import { BaseXform } from "@excel/xlsx/xform/base-xform";
+type UnderlineType = boolean | "single" | "double" | "singleAccounting" | "doubleAccounting";
+declare class UnderlineXform extends BaseXform {
+    static Attributes: {
+        [key: string]: any;
+    };
+    constructor(model?: UnderlineType);
+    get tag(): string;
+    render(xmlStream: any, model?: UnderlineType): void;
+    parseOpen(node: any): void;
+    parseText(): void;
+    parseClose(): boolean;
+}
+export { UnderlineXform };

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

@@ -0,0 +1,21 @@
+import { BaseXform } from "@excel/xlsx/xform/base-xform";
+import { FilterColumnXform } from "@excel/xlsx/xform/table/filter-column-xform";
+interface AutoFilterModel {
+    autoFilterRef: string;
+    columns: any[];
+}
+declare class AutoFilterXform extends BaseXform {
+    map: {
+        [key: string]: FilterColumnXform;
+    };
+    parser: any;
+    model: AutoFilterModel;
+    constructor();
+    get tag(): string;
+    prepare(model: any): void;
+    render(xmlStream: any, model: any): void;
+    parseOpen(node: any): boolean;
+    parseText(text: string): void;
+    parseClose(name: string): boolean;
+}
+export { AutoFilterXform };

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

@@ -0,0 +1,15 @@
+import { BaseXform } from "@excel/xlsx/xform/base-xform";
+interface CustomFilterModel {
+    val: string;
+    operator?: string;
+}
+declare class CustomFilterXform extends BaseXform {
+    model: CustomFilterModel;
+    constructor();
+    get tag(): string;
+    render(xmlStream: any, model: CustomFilterModel): void;
+    parseOpen(node: any): boolean;
+    parseText(): void;
+    parseClose(): boolean;
+}
+export { CustomFilterXform };

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

@@ -0,0 +1,24 @@
+import { BaseXform } from "@excel/xlsx/xform/base-xform";
+import { ListXform } from "@excel/xlsx/xform/list-xform";
+interface FilterColumnModel {
+    colId?: string;
+    filterButton: boolean;
+    customFilters?: any[];
+}
+declare class FilterColumnXform extends BaseXform {
+    map: {
+        [key: string]: ListXform;
+    };
+    parser: any;
+    model: FilterColumnModel;
+    constructor();
+    get tag(): string;
+    prepare(model: FilterColumnModel, options: {
+        index: number;
+    }): void;
+    render(xmlStream: any, model: FilterColumnModel): void;
+    parseOpen(node: any): boolean;
+    parseText(): void;
+    parseClose(name: string): boolean;
+}
+export { FilterColumnXform };