@cj-tech-master/excelts 4.2.2 → 4.2.3-canary.20260122073152.a9bb6b0

package/dist/browser/modules/csv/csv-core.d.ts

@@ -58,15 +58,6 @@ export interface CsvParseOptions {
     renameHeaders?: boolean;
     /** Comment character - lines starting with this are ignored */
     comment?: string;
-    /**
-     * Decimal separator used when parsing numbers from CSV (default: ".").
-     *
-     * Note: core CSV parsing returns strings; number conversion is handled by higher-level
-     * consumers (e.g. the default value mapper in the CSV module).
-     *
-     * @deprecated Use CsvReadOptions.valueMapperOptions.decimalSeparator instead.
-     */
-    decimalSeparator?: "." | ",";
     /** Maximum number of data rows to parse (excluding header) */
     maxRows?: number;
     /** Number of lines to skip at the beginning (before header detection) */

package/dist/browser/modules/csv/csv.browser.js

@@ -112,7 +112,7 @@ class CSV {
         const dateFormats = options?.dateFormats ?? DEFAULT_DATE_FORMATS;
         const map = options?.map ||
             createDefaultValueMapper(dateFormats, {
-                decimalSeparator: options?.valueMapperOptions?.decimalSeparator ?? options?.parserOptions?.decimalSeparator
+                decimalSeparator: options?.valueMapperOptions?.decimalSeparator
             });
         const rows = parseCsv(str, options?.parserOptions);
         for (const row of rows) {
@@ -154,7 +154,7 @@ class CSV {
         const dateFormats = options?.dateFormats ?? DEFAULT_DATE_FORMATS;
         const map = options?.map ||
             createDefaultValueMapper(dateFormats, {
-                decimalSeparator: options?.valueMapperOptions?.decimalSeparator ?? options?.parserOptions?.decimalSeparator
+                decimalSeparator: options?.valueMapperOptions?.decimalSeparator
             });
         const parser = new CsvParserStream(options?.parserOptions);
         return new Promise((resolve, reject) => {
@@ -224,7 +224,7 @@ class CSV {
         const dateFormats = options?.dateFormats ?? DEFAULT_DATE_FORMATS;
         const map = options?.map ||
             createDefaultValueMapper(dateFormats, {
-                decimalSeparator: options?.valueMapperOptions?.decimalSeparator ?? options?.parserOptions?.decimalSeparator
+                decimalSeparator: options?.valueMapperOptions?.decimalSeparator
             });
         const parser = new CsvParserStream(options?.parserOptions);
         parser.on("data", (row) => worksheet.addRow(row.map(map)));

package/dist/browser/modules/excel/utils/parse-sax.d.ts

@@ -54,6 +54,7 @@ export declare class SaxesParser {
     private positionAtNewLine;
     private chunkPosition;
     ENTITIES: Record<string, string>;
+    private nsPrefix;
     private textHandler?;
     private openTagHandler?;
     private closeTagHandler?;
@@ -62,6 +63,7 @@ export declare class SaxesParser {
     get closed(): boolean;
     get position(): number;
     private _init;
+    private stripNsPrefix;
     on(name: "text", handler: TextHandler): void;
     on(name: "opentag", handler: OpenTagHandler): void;
     on(name: "closetag", handler: CloseTagHandler): void;
@@ -106,6 +108,7 @@ export declare class SaxesParser {
     private skipSpaces;
     private openTag;
     private openSelfClosingTag;
+    private processAttributes;
     private closeTag;
     private end;
 }

package/dist/browser/modules/excel/utils/parse-sax.js

@@ -142,6 +142,12 @@ const XML_ENTITIES = {
     quot: '"',
     apos: "'"
 };
+// HAN CELL namespace prefix normalization
+// HAN CELL uses non-standard namespace prefixes (ep:, cp:, dc:, etc.)
+// The x: prefix for spreadsheetml is detected dynamically from xmlns declarations
+// See: https://github.com/exceljs/exceljs/issues/3014
+const HAN_CELL_PREFIXES = /^(ep|cp|dc|dcterms|dcmitype|vt):/;
+const SPREADSHEETML_NS = "http://schemas.openxmlformats.org/spreadsheetml/2006/main";
 // ============================================================================
 // Parser States
 // ============================================================================
@@ -202,6 +208,8 @@ export class SaxesParser {
         this.chunkPosition = 0;
         // Entity storage
         this.ENTITIES = { ...XML_ENTITIES };
+        // HAN CELL compatibility: spreadsheetml namespace prefix (e.g., "x")
+        this.nsPrefix = null;
         this.trackPosition = opt?.position !== false;
         this.fileName = opt?.fileName;
         this.fragment = opt?.fragment ?? false;
@@ -236,6 +244,14 @@ export class SaxesParser {
         this.chunk = "";
         this.i = 0;
         this.prevI = 0;
+        this.nsPrefix = null;
+    }
+    // Strip HAN CELL namespace prefixes from element names
+    stripNsPrefix(name) {
+        const n = name.replace(HAN_CELL_PREFIXES, "");
+        return this.nsPrefix && n.startsWith(this.nsPrefix + ":")
+            ? n.slice(this.nsPrefix.length + 1)
+            : n;
     }
     on(name, handler) {
         switch (name) {
@@ -651,9 +667,8 @@ export class SaxesParser {
             this.name += charFromCode(c);
             return;
         }
-        // Tag name complete
         this.tag = {
-            name: this.name,
+            name: this.stripNsPrefix(this.name),
             attributes: Object.create(null),
             isSelfClosing: false
         };
@@ -1092,11 +1107,7 @@ export class SaxesParser {
     openTag() {
         const tag = this.tag;
         tag.isSelfClosing = false;
-        // Copy attributes from list to object
-        for (const { name, value } of this.attribList) {
-            tag.attributes[name] = value;
-        }
-        this.attribList = [];
+        this.processAttributes(tag);
         this.openTagHandler?.(tag);
         this.tags.push(tag);
         this.name = "";
@@ -1105,11 +1116,7 @@ export class SaxesParser {
     openSelfClosingTag() {
         const tag = this.tag;
         tag.isSelfClosing = true;
-        // Copy attributes from list to object
-        for (const { name, value } of this.attribList) {
-            tag.attributes[name] = value;
-        }
-        this.attribList = [];
+        this.processAttributes(tag);
         this.openTagHandler?.(tag);
         this.closeTagHandler?.(tag);
         if (this.tags.length === 0) {
@@ -1118,8 +1125,20 @@ export class SaxesParser {
         this.name = "";
         this.state = S_TEXT;
     }
+    // Process attributes and detect spreadsheetml namespace prefix
+    processAttributes(tag) {
+        for (const { name, value } of this.attribList) {
+            tag.attributes[name] = value;
+            if (name.startsWith("xmlns:") && value === SPREADSHEETML_NS) {
+                this.nsPrefix = name.slice(6);
+                tag.name = this.stripNsPrefix(tag.name);
+            }
+        }
+        this.attribList = [];
+    }
     closeTag() {
-        const { tags, name } = this;
+        const { tags } = this;
+        const name = this.stripNsPrefix(this.name);
         this.state = S_TEXT;
         this.name = "";
         if (name === "") {

package/dist/browser/modules/excel/utils/passthrough-manager.d.ts

@@ -0,0 +1,77 @@
+/**
+ * PassthroughManager - Manages passthrough files for round-trip preservation
+ *
+ * This module handles files that are not fully parsed by the library but need to be
+ * preserved during read/write cycles (e.g., charts, sparklines, slicers).
+ */
+/**
+ * Content type entry for ZIP content types
+ */
+export interface PassthroughContentType {
+    partName: string;
+    contentType: string;
+}
+/**
+ * ZIP writer interface for passthrough files
+ */
+export interface IPassthroughZipWriter {
+    append(data: Uint8Array, options: {
+        name: string;
+    }): void;
+}
+/**
+ * PassthroughManager handles storage and retrieval of passthrough files
+ * that need to be preserved during Excel read/write cycles.
+ */
+export declare class PassthroughManager {
+    private files;
+    /**
+     * Check if a path should be treated as passthrough
+     */
+    static isPassthroughPath(path: string): boolean;
+    /**
+     * Get the content type for a passthrough file path
+     * @returns Content type string or undefined if unknown
+     */
+    static getContentType(path: string): string | undefined;
+    /**
+     * Add a file to passthrough storage
+     */
+    add(path: string, data: Uint8Array): void;
+    /**
+     * Get a file from passthrough storage
+     */
+    get(path: string): Uint8Array | undefined;
+    /**
+     * Check if a file exists in passthrough storage
+     */
+    has(path: string): boolean;
+    /**
+     * Get all stored paths
+     */
+    getPaths(): string[];
+    /**
+     * Get all files as a record (for serialization)
+     */
+    toRecord(): Record<string, Uint8Array>;
+    /**
+     * Load files from a record (for deserialization)
+     */
+    fromRecord(record: Record<string, Uint8Array>): void;
+    /**
+     * Get content types for all stored files that have known types
+     */
+    getContentTypes(): PassthroughContentType[];
+    /**
+     * Write all passthrough files to a ZIP writer
+     */
+    writeToZip(zip: IPassthroughZipWriter): void;
+    /**
+     * Clear all stored files
+     */
+    clear(): void;
+    /**
+     * Get the number of stored files
+     */
+    get size(): number;
+}

package/dist/browser/modules/excel/utils/passthrough-manager.js

@@ -0,0 +1,129 @@
+/**
+ * PassthroughManager - Manages passthrough files for round-trip preservation
+ *
+ * This module handles files that are not fully parsed by the library but need to be
+ * preserved during read/write cycles (e.g., charts, sparklines, slicers).
+ */
+// Pre-compiled regex patterns for content type detection (performance optimization)
+const chartXmlRegex = /^xl\/charts\/chart\d+\.xml$/;
+const chartStyleXmlRegex = /^xl\/charts\/style\d+\.xml$/;
+const chartColorsXmlRegex = /^xl\/charts\/colors\d+\.xml$/;
+/**
+ * Content type definitions for passthrough files
+ */
+const PASSTHROUGH_CONTENT_TYPES = new Map([
+    [chartXmlRegex, "application/vnd.openxmlformats-officedocument.drawingml.chart+xml"],
+    [chartStyleXmlRegex, "application/vnd.ms-office.chartstyle+xml"],
+    [chartColorsXmlRegex, "application/vnd.ms-office.chartcolorstyle+xml"]
+]);
+/**
+ * Passthrough path prefixes that should be preserved
+ */
+const PASSTHROUGH_PREFIXES = ["xl/charts/"];
+/**
+ * PassthroughManager handles storage and retrieval of passthrough files
+ * that need to be preserved during Excel read/write cycles.
+ */
+export class PassthroughManager {
+    constructor() {
+        this.files = new Map();
+    }
+    /**
+     * Check if a path should be treated as passthrough
+     */
+    static isPassthroughPath(path) {
+        return PASSTHROUGH_PREFIXES.some(prefix => path.startsWith(prefix));
+    }
+    /**
+     * Get the content type for a passthrough file path
+     * @returns Content type string or undefined if unknown
+     */
+    static getContentType(path) {
+        // Chart relationships are handled by Default extension="rels"
+        if (path.startsWith("xl/charts/_rels/")) {
+            return undefined;
+        }
+        for (const [regex, contentType] of PASSTHROUGH_CONTENT_TYPES) {
+            if (regex.test(path)) {
+                return contentType;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Add a file to passthrough storage
+     */
+    add(path, data) {
+        this.files.set(path, data);
+    }
+    /**
+     * Get a file from passthrough storage
+     */
+    get(path) {
+        return this.files.get(path);
+    }
+    /**
+     * Check if a file exists in passthrough storage
+     */
+    has(path) {
+        return this.files.has(path);
+    }
+    /**
+     * Get all stored paths
+     */
+    getPaths() {
+        return [...this.files.keys()];
+    }
+    /**
+     * Get all files as a record (for serialization)
+     */
+    toRecord() {
+        const record = {};
+        for (const [path, data] of this.files) {
+            record[path] = data;
+        }
+        return record;
+    }
+    /**
+     * Load files from a record (for deserialization)
+     */
+    fromRecord(record) {
+        this.files.clear();
+        for (const [path, data] of Object.entries(record)) {
+            this.files.set(path, data);
+        }
+    }
+    /**
+     * Get content types for all stored files that have known types
+     */
+    getContentTypes() {
+        const contentTypes = [];
+        for (const path of this.files.keys()) {
+            const contentType = PassthroughManager.getContentType(path);
+            if (contentType) {
+                contentTypes.push({ partName: path, contentType });
+            }
+        }
+        return contentTypes;
+    }
+    /**
+     * Write all passthrough files to a ZIP writer
+     */
+    writeToZip(zip) {
+        for (const [path, data] of this.files) {
+            zip.append(data, { name: path });
+        }
+    }
+    /**
+     * Clear all stored files
+     */
+    clear() {
+        this.files.clear();
+    }
+    /**
+     * Get the number of stored files
+     */
+    get size() {
+        return this.files.size;
+    }
+}

package/dist/browser/modules/excel/workbook.d.ts

@@ -55,6 +55,10 @@ export interface WorkbookModel {
     /** Loaded pivot tables from file - used during reconciliation */
     loadedPivotTables?: any[];
     calcProperties: Partial<CalculationProperties>;
+    /** Passthrough files (charts, etc.) preserved for round-trip */
+    passthrough?: Record<string, Uint8Array>;
+    /** Raw drawing XML data for passthrough (when drawing contains chart references) */
+    rawDrawings?: Record<string, Uint8Array>;
 }
 declare class Workbook {
     /**
@@ -94,6 +98,10 @@ declare class Workbook {
     private _worksheets;
     private _definedNames;
     private _themes?;
+    /** Passthrough files (charts, etc.) preserved for round-trip */
+    private _passthrough;
+    /** Raw drawing XML data for passthrough (when drawing contains chart references) */
+    private _rawDrawings;
     private _xlsx?;
     private _csv?;
     constructor();

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

@@ -38,6 +38,8 @@ class Workbook {
         this.views = [];
         this.media = [];
         this.pivotTables = [];
+        this._passthrough = {};
+        this._rawDrawings = {};
         this._definedNames = new DefinedNames();
     }
     // ===========================================================================
@@ -251,7 +253,9 @@ class Workbook {
             themes: this._themes,
             media: this.media,
             pivotTables: this.pivotTables,
-            calcProperties: this.calcProperties
+            calcProperties: this.calcProperties,
+            passthrough: this._passthrough,
+            rawDrawings: this._rawDrawings
         };
     }
     set model(value) {
@@ -292,6 +296,10 @@ class Workbook {
         // Handle pivot tables - either newly created or loaded from file
         // Loaded pivot tables come from loadedPivotTables after reconciliation
         this.pivotTables = value.pivotTables || value.loadedPivotTables || [];
+        // Preserve passthrough files (charts, etc.) for round-trip preservation
+        this._passthrough = value.passthrough || {};
+        // Preserve raw drawing data for drawings with chart references
+        this._rawDrawings = value.rawDrawings || {};
     }
 }
 // ===========================================================================

package/dist/browser/modules/excel/worksheet.d.ts

@@ -111,6 +111,8 @@ interface WorksheetModel {
     dimensions?: Range;
     merges?: string[];
     mergeCells?: string[];
+    /** Loaded drawing data (for charts, etc.) - preserved for round-trip */
+    drawing?: any;
 }
 declare class Worksheet {
     private _workbook;
@@ -139,6 +141,8 @@ declare class Worksheet {
     conditionalFormattings: ConditionalFormattingOptions[];
     formControls: FormCheckbox[];
     private _headerRowCount?;
+    /** Loaded drawing data (for charts, etc.) - preserved for round-trip */
+    private _drawing;
     constructor(options: WorksheetOptions);
     get name(): string;
     set name(name: string | undefined);

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

@@ -897,7 +897,8 @@ class Worksheet {
             tables: Object.values(this.tables).map(table => table.model),
             pivotTables: this.pivotTables,
             conditionalFormattings: this.conditionalFormattings,
-            formControls: this.formControls.map(fc => fc.model)
+            formControls: this.formControls.map(fc => fc.model),
+            drawing: this._drawing
         };
         // =================================================
         // columns
@@ -965,6 +966,8 @@ class Worksheet {
         this.conditionalFormattings = value.conditionalFormattings;
         // Form controls are currently write-only (not parsed from XLSX)
         this.formControls = [];
+        // Preserve loaded drawing data (charts, etc.)
+        this._drawing = value.drawing;
     }
 }
 export { Worksheet };

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

@@ -10,7 +10,7 @@ class AppXform extends BaseXform {
             Company: new StringXform({ tag: "Company" }),
             Manager: new StringXform({ tag: "Manager" }),
             HeadingPairs: new AppHeadingPairsXform(),
-            TitleOfParts: new AppTitlesOfPartsXform()
+            TitlesOfParts: new AppTitlesOfPartsXform()
         };
     }
     render(xmlStream, model) {
@@ -20,7 +20,7 @@ class AppXform extends BaseXform {
         xmlStream.leafNode("DocSecurity", undefined, "0");
         xmlStream.leafNode("ScaleCrop", undefined, "false");
         this.map.HeadingPairs.render(xmlStream, model.worksheets);
-        this.map.TitleOfParts.render(xmlStream, model.worksheets);
+        this.map.TitlesOfParts.render(xmlStream, model.worksheets);
         this.map.Company.render(xmlStream, model.company || "");
         this.map.Manager.render(xmlStream, model.manager);
         xmlStream.leafNode("LinksUpToDate", undefined, "false");
@@ -62,7 +62,7 @@ class AppXform extends BaseXform {
         switch (name) {
             case "Properties":
                 this.model = {
-                    worksheets: this.map.TitleOfParts.model,
+                    worksheets: this.map.TitlesOfParts.model,
                     company: this.map.Company.model,
                     manager: this.map.Manager.model
                 };

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

@@ -93,11 +93,16 @@ class ContentTypesXform extends BaseXform {
                 });
             });
         }
-        if (model.commentRefs) {
+        // VML extension is needed for comments or form controls
+        const hasComments = model.commentRefs && model.commentRefs.length > 0;
+        const hasFormControls = model.formControlRefs && model.formControlRefs.length > 0;
+        if (hasComments || hasFormControls) {
             xmlStream.leafNode("Default", {
                 Extension: "vml",
                 ContentType: "application/vnd.openxmlformats-officedocument.vmlDrawing"
             });
+        }
+        if (hasComments) {
             model.commentRefs.forEach(({ commentName }) => {
                 xmlStream.leafNode("Override", {
                     PartName: toContentTypesPartName(commentsPathFromName(commentName)),
@@ -105,15 +110,7 @@ class ContentTypesXform extends BaseXform {
                 });
             });
         }
-        // Add form control (ctrlProps) content types
-        if (model.formControlRefs) {
-            // Ensure vml extension is declared (may already be declared for comments)
-            if (!model.commentRefs) {
-                xmlStream.leafNode("Default", {
-                    Extension: "vml",
-                    ContentType: "application/vnd.openxmlformats-officedocument.vmlDrawing"
-                });
-            }
+        if (hasFormControls) {
             for (const ctrlPropId of model.formControlRefs) {
                 xmlStream.leafNode("Override", {
                     PartName: toContentTypesPartName(ctrlPropPath(ctrlPropId)),
@@ -121,6 +118,15 @@ class ContentTypesXform extends BaseXform {
                 });
             }
         }
+        // Add passthrough content types (charts, etc.)
+        if (model.passthroughContentTypes) {
+            for (const { partName, contentType } of model.passthroughContentTypes) {
+                xmlStream.leafNode("Override", {
+                    PartName: toContentTypesPartName(partName),
+                    ContentType: contentType
+                });
+            }
+        }
         xmlStream.leafNode("Override", {
             PartName: toContentTypesPartName(OOXML_PATHS.docPropsCore),
             ContentType: "application/vnd.openxmlformats-package.core-properties+xml"