@niicojs/excel 0.2.4 → 0.2.6

package/dist/index.cjs

@@ -40,10 +40,8 @@ var fflate = require('fflate');
     if (!match) {
         throw new Error(`Invalid cell address: ${address}`);
     }
-    const rowNumber = +match[2];
-    if (rowNumber <= 0) throw new Error(`Invalid cell address: ${address}`);
     const col = letterToCol(match[1].toUpperCase());
-    const row = rowNumber - 1; // Convert to 0-based
+    const row = parseInt(match[2], 10) - 1; // Convert to 0-based
     return {
         row,
         col
@@ -105,12 +103,6 @@ var fflate = require('fflate');
         }
     };
 };
-/**
- * Checks if an address is within a range
- */ const isInRange = (addr, range)=>{
-    const norm = normalizeRange(range);
-    return addr.row >= norm.start.row && addr.row <= norm.end.row && addr.col >= norm.start.col && addr.col <= norm.end.col;
-};
 
 // Excel epoch: December 30, 1899 (accounting for the 1900 leap year bug)
 const EXCEL_EPOCH = new Date(Date.UTC(1899, 11, 30));
@@ -443,23 +435,12 @@ _computedKey = Symbol.iterator;
     /**
    * Get all values in the range as a 2D array
    */ get values() {
-        return this.getValues();
-    }
-    /**
-   * Get all values in the range as a 2D array with options
-   */ getValues(options = {}) {
-        const { createMissing = true } = options;
         const result = [];
         for(let r = this._range.start.row; r <= this._range.end.row; r++){
             const row = [];
             for(let c = this._range.start.col; c <= this._range.end.col; c++){
-                if (createMissing) {
-                    const cell = this._worksheet.cell(r, c);
-                    row.push(cell.value);
-                } else {
-                    const cell = this._worksheet.getCellIfExists(r, c);
-                    row.push(cell?.value ?? null);
-                }
+                const cell = this._worksheet.cell(r, c);
+                row.push(cell.value);
             }
             result.push(row);
         }
@@ -632,11 +613,6 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
         this._dirty = false;
         this._mergedCells = new Set();
         this._sheetData = [];
-        this._columnWidths = new Map();
-        this._rowHeights = new Map();
-        this._frozenPane = null;
-        this._dataBoundsCache = null;
-        this._boundsDirty = true;
         this._workbook = workbook;
         this._name = name;
     }
@@ -663,49 +639,12 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
         const worksheet = findElement(this._xmlNodes, 'worksheet');
         if (!worksheet) return;
         const worksheetChildren = getChildren(worksheet, 'worksheet');
-        // Parse sheet views (freeze panes)
-        const sheetViews = findElement(worksheetChildren, 'sheetViews');
-        if (sheetViews) {
-            const viewChildren = getChildren(sheetViews, 'sheetViews');
-            const sheetView = findElement(viewChildren, 'sheetView');
-            if (sheetView) {
-                const sheetViewChildren = getChildren(sheetView, 'sheetView');
-                const pane = findElement(sheetViewChildren, 'pane');
-                if (pane && getAttr(pane, 'state') === 'frozen') {
-                    const xSplit = parseInt(getAttr(pane, 'xSplit') || '0', 10);
-                    const ySplit = parseInt(getAttr(pane, 'ySplit') || '0', 10);
-                    if (xSplit > 0 || ySplit > 0) {
-                        this._frozenPane = {
-                            row: ySplit,
-                            col: xSplit
-                        };
-                    }
-                }
-            }
-        }
         // Parse sheet data (cells)
         const sheetData = findElement(worksheetChildren, 'sheetData');
         if (sheetData) {
             this._sheetData = getChildren(sheetData, 'sheetData');
             this._parseSheetData(this._sheetData);
         }
-        // Parse column widths
-        const cols = findElement(worksheetChildren, 'cols');
-        if (cols) {
-            const colChildren = getChildren(cols, 'cols');
-            for (const col of colChildren){
-                if (!('col' in col)) continue;
-                const min = parseInt(getAttr(col, 'min') || '0', 10);
-                const max = parseInt(getAttr(col, 'max') || '0', 10);
-                const width = parseFloat(getAttr(col, 'width') || '0');
-                if (!Number.isFinite(width) || width <= 0) continue;
-                if (min > 0 && max > 0) {
-                    for(let idx = min; idx <= max; idx++){
-                        this._columnWidths.set(idx - 1, width);
-                    }
-                }
-            }
-        }
         // Parse merged cells
         const mergeCells = findElement(worksheetChildren, 'mergeCells');
         if (mergeCells) {
@@ -725,11 +664,6 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
    */ _parseSheetData(rows) {
         for (const rowNode of rows){
             if (!('row' in rowNode)) continue;
-            const rowIndex = parseInt(getAttr(rowNode, 'r') || '0', 10) - 1;
-            const rowHeight = parseFloat(getAttr(rowNode, 'ht') || '0');
-            if (rowIndex >= 0 && Number.isFinite(rowHeight) && rowHeight > 0) {
-                this._rowHeights.set(rowIndex, rowHeight);
-            }
             const rowChildren = getChildren(rowNode, 'row');
             for (const cellNode of rowChildren){
                 if (!('c' in cellNode)) continue;
@@ -741,7 +675,6 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
                 this._cells.set(ref, cell);
             }
         }
-        this._boundsDirty = true;
     }
     /**
    * Parse a cell XML node to CellData
@@ -828,17 +761,9 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
         if (!cell) {
             cell = new Cell(this, row, c);
             this._cells.set(address, cell);
-            this._boundsDirty = true;
         }
         return cell;
     }
-    /**
-   * Get an existing cell without creating it.
-   */ getCellIfExists(rowOrAddress, col) {
-        const { row, col: c } = parseCellRef(rowOrAddress, col);
-        const address = toAddress(row, c);
-        return this._cells.get(address);
-    }
     range(startRowOrRange, startCol, endRow, endCol) {
         let rangeAddr;
         if (typeof startRowOrRange === 'string') {
@@ -898,65 +823,6 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
         return this._cells;
     }
     /**
-   * Set a column width (0-based index or column letter)
-   */ setColumnWidth(col, width) {
-        if (!Number.isFinite(width) || width <= 0) {
-            throw new Error('Column width must be a positive number');
-        }
-        const colIndex = typeof col === 'number' ? col : letterToCol(col);
-        if (colIndex < 0) {
-            throw new Error(`Invalid column: ${col}`);
-        }
-        this._columnWidths.set(colIndex, width);
-        this._dirty = true;
-    }
-    /**
-   * Get a column width if set
-   */ getColumnWidth(col) {
-        const colIndex = typeof col === 'number' ? col : letterToCol(col);
-        return this._columnWidths.get(colIndex);
-    }
-    /**
-   * Set a row height (0-based index)
-   */ setRowHeight(row, height) {
-        if (!Number.isFinite(height) || height <= 0) {
-            throw new Error('Row height must be a positive number');
-        }
-        if (row < 0) {
-            throw new Error('Row index must be >= 0');
-        }
-        this._rowHeights.set(row, height);
-        this._dirty = true;
-    }
-    /**
-   * Get a row height if set
-   */ getRowHeight(row) {
-        return this._rowHeights.get(row);
-    }
-    /**
-   * Freeze panes at a given row/column split (counts from top-left)
-   */ freezePane(rowSplit, colSplit) {
-        if (rowSplit < 0 || colSplit < 0) {
-            throw new Error('Freeze pane splits must be >= 0');
-        }
-        if (rowSplit === 0 && colSplit === 0) {
-            this._frozenPane = null;
-        } else {
-            this._frozenPane = {
-                row: rowSplit,
-                col: colSplit
-            };
-        }
-        this._dirty = true;
-    }
-    /**
-   * Get current frozen pane configuration
-   */ getFrozenPane() {
-        return this._frozenPane ? {
-            ...this._frozenPane
-        } : null;
-    }
-    /**
    * Convert sheet data to an array of JSON objects.
    *
    * @param config - Configuration options
@@ -974,7 +840,7 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
    * const data = sheet.toJson({ startRow: 2, startCol: 1 });
    * ```
    */ toJson(config = {}) {
-        const { fields, startRow = 0, startCol = 0, endRow, endCol, stopOnEmptyRow = true, dateHandling = this._workbook.dateHandling } = config;
+        const { fields, startRow = 0, startCol = 0, endRow, endCol, stopOnEmptyRow = true } = config;
         // Get the bounds of data in the sheet
         const bounds = this._getDataBounds();
         if (!bounds) {
@@ -1007,10 +873,7 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
             for(let colOffset = 0; colOffset < fieldNames.length; colOffset++){
                 const col = startCol + colOffset;
                 const cell = this._cells.get(toAddress(row, col));
-                let value = cell?.value ?? null;
-                if (value instanceof Date) {
-                    value = this._serializeDate(value, dateHandling, cell);
-                }
+                const value = cell?.value ?? null;
                 if (value !== null) {
                     hasData = true;
                 }
@@ -1027,24 +890,10 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
         }
         return result;
     }
-    _serializeDate(value, dateHandling, cell) {
-        if (dateHandling === 'excelSerial') {
-            return cell?._jsDateToExcel(value) ?? value;
-        }
-        if (dateHandling === 'isoString') {
-            return value.toISOString();
-        }
-        return value;
-    }
     /**
    * Get the bounds of data in the sheet (min/max row and column with data)
    */ _getDataBounds() {
-        if (!this._boundsDirty && this._dataBoundsCache) {
-            return this._dataBoundsCache;
-        }
         if (this._cells.size === 0) {
-            this._dataBoundsCache = null;
-            this._boundsDirty = false;
             return null;
         }
         let minRow = Infinity;
@@ -1060,18 +909,14 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
             }
         }
         if (minRow === Infinity) {
-            this._dataBoundsCache = null;
-            this._boundsDirty = false;
             return null;
         }
-        this._dataBoundsCache = {
+        return {
             minRow,
             maxRow,
             minCol,
             maxCol
         };
-        this._boundsDirty = false;
-        return this._dataBoundsCache;
     }
     /**
    * Generate XML for this worksheet
@@ -1085,11 +930,6 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
             }
             rowMap.get(row).push(cell);
         }
-        for (const rowIdx of this._rowHeights.keys()){
-            if (!rowMap.has(rowIdx)) {
-                rowMap.set(rowIdx, []);
-            }
-        }
         // Sort rows and cells
         const sortedRows = Array.from(rowMap.entries()).sort((a, b)=>a[0] - b[0]);
         const rowNodes = [];
@@ -1100,71 +940,16 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
                 const cellNode = this._buildCellNode(cell);
                 cellNodes.push(cellNode);
             }
-            const rowAttrs = {
+            const rowNode = createElement('row', {
                 r: String(rowIdx + 1)
-            };
-            const rowHeight = this._rowHeights.get(rowIdx);
-            if (rowHeight !== undefined) {
-                rowAttrs.ht = String(rowHeight);
-                rowAttrs.customHeight = '1';
-            }
-            const rowNode = createElement('row', rowAttrs, cellNodes);
+            }, cellNodes);
             rowNodes.push(rowNode);
         }
         const sheetDataNode = createElement('sheetData', {}, rowNodes);
         // Build worksheet structure
-        const worksheetChildren = [];
-        // Sheet views (freeze panes)
-        if (this._frozenPane) {
-            const paneAttrs = {
-                state: 'frozen'
-            };
-            const topLeftCell = toAddress(this._frozenPane.row, this._frozenPane.col);
-            paneAttrs.topLeftCell = topLeftCell;
-            if (this._frozenPane.col > 0) {
-                paneAttrs.xSplit = String(this._frozenPane.col);
-            }
-            if (this._frozenPane.row > 0) {
-                paneAttrs.ySplit = String(this._frozenPane.row);
-            }
-            let activePane = 'bottomRight';
-            if (this._frozenPane.row > 0 && this._frozenPane.col === 0) {
-                activePane = 'bottomLeft';
-            } else if (this._frozenPane.row === 0 && this._frozenPane.col > 0) {
-                activePane = 'topRight';
-            }
-            paneAttrs.activePane = activePane;
-            const paneNode = createElement('pane', paneAttrs, []);
-            const selectionNode = createElement('selection', {
-                pane: activePane,
-                activeCell: topLeftCell,
-                sqref: topLeftCell
-            }, []);
-            const sheetViewNode = createElement('sheetView', {
-                workbookViewId: '0'
-            }, [
-                paneNode,
-                selectionNode
-            ]);
-            worksheetChildren.push(createElement('sheetViews', {}, [
-                sheetViewNode
-            ]));
-        }
-        // Column widths
-        if (this._columnWidths.size > 0) {
-            const colNodes = [];
-            const entries = Array.from(this._columnWidths.entries()).sort((a, b)=>a[0] - b[0]);
-            for (const [colIndex, width] of entries){
-                colNodes.push(createElement('col', {
-                    min: String(colIndex + 1),
-                    max: String(colIndex + 1),
-                    width: String(width),
-                    customWidth: '1'
-                }, []));
-            }
-            worksheetChildren.push(createElement('cols', {}, colNodes));
-        }
-        worksheetChildren.push(sheetDataNode);
+        const worksheetChildren = [
+            sheetDataNode
+        ];
         // Add merged cells if any
         if (this._mergedCells.size > 0) {
             const mergeCellNodes = [];
@@ -1332,6 +1117,129 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
     }
 }
 
+/**
+ * Excel built-in number format IDs (0-163 are reserved).
+ * These formats don't need to be defined in the numFmts element.
+ */ const BUILTIN_NUM_FMTS = new Map([
+    [
+        'General',
+        0
+    ],
+    [
+        '0',
+        1
+    ],
+    [
+        '0.00',
+        2
+    ],
+    [
+        '#,##0',
+        3
+    ],
+    [
+        '#,##0.00',
+        4
+    ],
+    [
+        '0%',
+        9
+    ],
+    [
+        '0.00%',
+        10
+    ],
+    [
+        '0.00E+00',
+        11
+    ],
+    [
+        '# ?/?',
+        12
+    ],
+    [
+        '# ??/??',
+        13
+    ],
+    [
+        'mm-dd-yy',
+        14
+    ],
+    [
+        'd-mmm-yy',
+        15
+    ],
+    [
+        'd-mmm',
+        16
+    ],
+    [
+        'mmm-yy',
+        17
+    ],
+    [
+        'h:mm AM/PM',
+        18
+    ],
+    [
+        'h:mm:ss AM/PM',
+        19
+    ],
+    [
+        'h:mm',
+        20
+    ],
+    [
+        'h:mm:ss',
+        21
+    ],
+    [
+        'm/d/yy h:mm',
+        22
+    ],
+    [
+        '#,##0 ;(#,##0)',
+        37
+    ],
+    [
+        '#,##0 ;[Red](#,##0)',
+        38
+    ],
+    [
+        '#,##0.00;(#,##0.00)',
+        39
+    ],
+    [
+        '#,##0.00;[Red](#,##0.00)',
+        40
+    ],
+    [
+        'mm:ss',
+        45
+    ],
+    [
+        '[h]:mm:ss',
+        46
+    ],
+    [
+        'mmss.0',
+        47
+    ],
+    [
+        '##0.0E+0',
+        48
+    ],
+    [
+        '@',
+        49
+    ]
+]);
+/**
+ * Reverse lookup: built-in format ID -> format code
+ */ const BUILTIN_NUM_FMT_CODES = new Map(Array.from(BUILTIN_NUM_FMTS.entries()).map(([code, id])=>[
+        id,
+        code
+    ]));
 /**
  * Normalize a color to ARGB format (8 hex chars).
  * Accepts: "#RGB", "#RRGGBB", "RGB", "RRGGBB", "AARRGGBB", "#AARRGGBB"
@@ -1351,40 +1259,6 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
  * Manages the styles (xl/styles.xml)
  */ class Styles {
     /**
-   * Generate a deterministic cache key for a style object.
-   * More efficient than JSON.stringify as it avoids the overhead of
-   * full JSON serialization and produces a consistent key regardless
-   * of property order.
-   */ _getStyleKey(style) {
-        // Use a delimiter that won't appear in values
-        const SEP = '\x00';
-        // Build key from all style properties in a fixed order
-        const parts = [
-            style.bold ? '1' : '0',
-            style.italic ? '1' : '0',
-            style.underline === true ? '1' : style.underline === 'single' ? 's' : style.underline === 'double' ? 'd' : '0',
-            style.strike ? '1' : '0',
-            style.fontSize?.toString() ?? '',
-            style.fontName ?? '',
-            style.fontColor ?? '',
-            style.fill ?? '',
-            style.numberFormat ?? ''
-        ];
-        // Border properties
-        if (style.border) {
-            parts.push(style.border.top ?? '', style.border.bottom ?? '', style.border.left ?? '', style.border.right ?? '');
-        } else {
-            parts.push('', '', '', '');
-        }
-        // Alignment properties
-        if (style.alignment) {
-            parts.push(style.alignment.horizontal ?? '', style.alignment.vertical ?? '', style.alignment.wrapText ? '1' : '0', style.alignment.textRotation?.toString() ?? '');
-        } else {
-            parts.push('', '', '0', '');
-        }
-        return parts.join(SEP);
-    }
-    /**
    * Parse styles from XML content
    */ static parse(xml) {
         const styles = new Styles();
@@ -1551,16 +1425,13 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
     /**
    * Get a style by index
    */ getStyle(index) {
-        const cached = this._styleObjectCache.get(index);
-        if (cached) return {
-            ...cached
-        };
         const xf = this._cellXfs[index];
         if (!xf) return {};
         const font = this._fonts[xf.fontId];
         const fill = this._fills[xf.fillId];
         const border = this._borders[xf.borderId];
-        const numFmt = this._numFmts.get(xf.numFmtId);
+        // Check custom formats first, then fall back to built-in format codes
+        const numFmt = this._numFmts.get(xf.numFmtId) ?? BUILTIN_NUM_FMT_CODES.get(xf.numFmtId);
         const style = {};
         if (font) {
             if (font.bold) style.bold = true;
@@ -1595,16 +1466,13 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
                 textRotation: xf.alignment.textRotation
             };
         }
-        this._styleObjectCache.set(index, {
-            ...style
-        });
         return style;
     }
     /**
    * Create a style and return its index
    * Uses caching to deduplicate identical styles
    */ createStyle(style) {
-        const key = this._getStyleKey(style);
+        const key = JSON.stringify(style);
         const cached = this._styleCache.get(key);
         if (cached !== undefined) {
             return cached;
@@ -1636,20 +1504,8 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
         const index = this._cellXfs.length;
         this._cellXfs.push(xf);
         this._styleCache.set(key, index);
-        this._styleObjectCache.set(index, {
-            ...style
-        });
         return index;
     }
-    /**
-   * Clone an existing style by index, optionally overriding fields.
-   */ cloneStyle(index, overrides = {}) {
-        const baseStyle = this.getStyle(index);
-        return this.createStyle({
-            ...baseStyle,
-            ...overrides
-        });
-    }
     _findOrCreateFont(style) {
         const font = {
             bold: style.bold || false,
@@ -1707,16 +1563,30 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
         return this._borders.length - 1;
     }
     _findOrCreateNumFmt(format) {
-        // Check if already exists
+        // Check built-in formats first (IDs 0-163)
+        const builtinId = BUILTIN_NUM_FMTS.get(format);
+        if (builtinId !== undefined) {
+            return builtinId;
+        }
+        // Check if already exists in custom formats
         for (const [id, code] of this._numFmts){
             if (code === format) return id;
         }
-        // Create new (custom formats start at 164)
-        const id = Math.max(164, ...Array.from(this._numFmts.keys())) + 1;
+        // Create new custom format (IDs 164+)
+        const existingIds = Array.from(this._numFmts.keys());
+        const id = existingIds.length > 0 ? Math.max(...existingIds) + 1 : 164;
         this._numFmts.set(id, format);
         return id;
     }
     /**
+   * Get or create a number format ID for the given format string.
+   * Returns built-in IDs (0-163) for standard formats, or creates custom IDs (164+).
+   * @param format - The number format string (e.g., '0.00', '#,##0', '$#,##0.00')
+   */ getOrCreateNumFmtId(format) {
+        this._dirty = true;
+        return this._findOrCreateNumFmt(format);
+    }
+    /**
    * Check if styles have been modified
    */ get dirty() {
         return this._dirty;
@@ -1885,7 +1755,6 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
         this._dirty = false;
         // Cache for style deduplication
         this._styleCache = new Map();
-        this._styleObjectCache = new Map();
     }
 }
 
@@ -1897,7 +1766,7 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
         this._columnFields = [];
         this._valueFields = [];
         this._filterFields = [];
-        this._fieldAssignments = new Map();
+        this._styles = null;
         this._name = name;
         this._cache = cache;
         this._targetSheet = targetSheet;
@@ -1932,6 +1801,13 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
         return this._pivotTableIndex;
     }
     /**
+   * Set the styles reference for number format resolution
+   * @internal
+   */ setStyles(styles) {
+        this._styles = styles;
+        return this;
+    }
+    /**
    * Add a field to the row area
    * @param fieldName - Name of the source field (column header)
    */ addRowField(fieldName) {
@@ -1939,13 +1815,11 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
         if (fieldIndex < 0) {
             throw new Error(`Field not found in source data: ${fieldName}`);
         }
-        const assignment = {
+        this._rowFields.push({
             fieldName,
             fieldIndex,
             axis: 'row'
-        };
-        this._rowFields.push(assignment);
-        this._fieldAssignments.set(fieldIndex, assignment);
+        });
         return this;
     }
     /**
@@ -1956,13 +1830,11 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
         if (fieldIndex < 0) {
             throw new Error(`Field not found in source data: ${fieldName}`);
         }
-        const assignment = {
+        this._columnFields.push({
             fieldName,
             fieldIndex,
             axis: 'column'
-        };
-        this._columnFields.push(assignment);
-        this._fieldAssignments.set(fieldIndex, assignment);
+        });
         return this;
     }
     /**
@@ -1970,21 +1842,21 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
    * @param fieldName - Name of the source field (column header)
    * @param aggregation - Aggregation function (sum, count, average, min, max)
    * @param displayName - Optional display name (defaults to "Sum of FieldName")
-   */ addValueField(fieldName, aggregation = 'sum', displayName) {
+   * @param numberFormat - Optional number format (e.g., '$#,##0.00', '0.00%')
+   */ addValueField(fieldName, aggregation = 'sum', displayName, numberFormat) {
         const fieldIndex = this._cache.getFieldIndex(fieldName);
         if (fieldIndex < 0) {
             throw new Error(`Field not found in source data: ${fieldName}`);
         }
         const defaultName = `${aggregation.charAt(0).toUpperCase() + aggregation.slice(1)} of ${fieldName}`;
-        const assignment = {
+        this._valueFields.push({
             fieldName,
             fieldIndex,
             axis: 'value',
             aggregation,
-            displayName: displayName || defaultName
-        };
-        this._valueFields.push(assignment);
-        this._fieldAssignments.set(fieldIndex, assignment);
+            displayName: displayName || defaultName,
+            numberFormat
+        });
         return this;
     }
     /**
@@ -1995,44 +1867,11 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
         if (fieldIndex < 0) {
             throw new Error(`Field not found in source data: ${fieldName}`);
         }
-        const assignment = {
+        this._filterFields.push({
             fieldName,
             fieldIndex,
             axis: 'filter'
-        };
-        this._filterFields.push(assignment);
-        this._fieldAssignments.set(fieldIndex, assignment);
-        return this;
-    }
-    /**
-   * Set a sort order for a row/column field
-   */ sortField(fieldName, order) {
-        const fieldIndex = this._cache.getFieldIndex(fieldName);
-        if (fieldIndex < 0) {
-            throw new Error(`Field not found in source data: ${fieldName}`);
-        }
-        const assignment = this._fieldAssignments.get(fieldIndex);
-        if (!assignment || assignment.axis !== 'row' && assignment.axis !== 'column') {
-            throw new Error(`Field is not assigned to row or column axis: ${fieldName}`);
-        }
-        assignment.sortOrder = order;
-        return this;
-    }
-    /**
-   * Filter items for a field (include or exclude list)
-   */ filterField(fieldName, filter) {
-        const fieldIndex = this._cache.getFieldIndex(fieldName);
-        if (fieldIndex < 0) {
-            throw new Error(`Field not found in source data: ${fieldName}`);
-        }
-        const assignment = this._fieldAssignments.get(fieldIndex);
-        if (!assignment) {
-            throw new Error(`Field is not assigned to pivot table: ${fieldName}`);
-        }
-        if (filter.include && filter.exclude) {
-            throw new Error('Pivot field filter cannot use both include and exclude');
-        }
-        assignment.filter = filter;
+        });
         return this;
     }
     /**
@@ -2139,17 +1978,26 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
         }
         // Data fields (values)
         if (this._valueFields.length > 0) {
-            const dataFieldNodes = this._valueFields.map((f)=>createElement('dataField', {
+            const dataFieldNodes = this._valueFields.map((f)=>{
+                const attrs = {
                     name: f.displayName || f.fieldName,
                     fld: String(f.fieldIndex),
                     baseField: '0',
                     baseItem: '0',
                     subtotal: f.aggregation || 'sum'
-                }, []));
+                };
+                // Add numFmtId if format specified and styles available
+                if (f.numberFormat && this._styles) {
+                    attrs.numFmtId = String(this._styles.getOrCreateNumFmtId(f.numberFormat));
+                }
+                return createElement('dataField', attrs, []);
+            });
             children.push(createElement('dataFields', {
                 count: String(dataFieldNodes.length)
             }, dataFieldNodes));
         }
+        // Check if any value field has a number format
+        const hasNumberFormats = this._valueFields.some((f)=>f.numberFormat);
         // Pivot table style
         children.push(createElement('pivotTableStyleInfo', {
             name: 'PivotStyleMedium9',
@@ -2164,7 +2012,7 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
             'xmlns:r': 'http://schemas.openxmlformats.org/officeDocument/2006/relationships',
             name: this._name,
             cacheId: String(this._cache.cacheId),
-            applyNumberFormats: '0',
+            applyNumberFormats: hasNumberFormats ? '1' : '0',
             applyBorderFormats: '0',
             applyFontFormats: '0',
             applyPatternFormats: '0',
@@ -2197,28 +2045,17 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
         const colField = this._columnFields.find((f)=>f.fieldIndex === fieldIndex);
         const filterField = this._filterFields.find((f)=>f.fieldIndex === fieldIndex);
         const valueField = this._valueFields.find((f)=>f.fieldIndex === fieldIndex);
-        const assignment = this._fieldAssignments.get(fieldIndex);
         if (rowField) {
             attrs.axis = 'axisRow';
             attrs.showAll = '0';
-            if (assignment?.sortOrder) {
-                attrs.sortType = 'ascending';
-                attrs.sortOrder = assignment.sortOrder === 'asc' ? 'ascending' : 'descending';
-            }
             // Add items for shared values
             const cacheField = this._cache.fields[fieldIndex];
             if (cacheField && cacheField.sharedItems.length > 0) {
                 const itemNodes = [];
-                const allowedIndexes = this._resolveItemFilter(cacheField.sharedItems, assignment?.filter);
                 for(let i = 0; i < cacheField.sharedItems.length; i++){
-                    const shouldInclude = allowedIndexes.has(i);
-                    const itemAttrs = {
+                    itemNodes.push(createElement('item', {
                         x: String(i)
-                    };
-                    if (!shouldInclude) {
-                        itemAttrs.h = '1';
-                    }
-                    itemNodes.push(createElement('item', itemAttrs, []));
+                    }, []));
                 }
                 // Add default subtotal item
                 itemNodes.push(createElement('item', {
@@ -2231,23 +2068,13 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
         } else if (colField) {
             attrs.axis = 'axisCol';
             attrs.showAll = '0';
-            if (assignment?.sortOrder) {
-                attrs.sortType = 'ascending';
-                attrs.sortOrder = assignment.sortOrder === 'asc' ? 'ascending' : 'descending';
-            }
             const cacheField = this._cache.fields[fieldIndex];
             if (cacheField && cacheField.sharedItems.length > 0) {
                 const itemNodes = [];
-                const allowedIndexes = this._resolveItemFilter(cacheField.sharedItems, assignment?.filter);
                 for(let i = 0; i < cacheField.sharedItems.length; i++){
-                    const shouldInclude = allowedIndexes.has(i);
-                    const itemAttrs = {
+                    itemNodes.push(createElement('item', {
                         x: String(i)
-                    };
-                    if (!shouldInclude) {
-                        itemAttrs.h = '1';
-                    }
-                    itemNodes.push(createElement('item', itemAttrs, []));
+                    }, []));
                 }
                 itemNodes.push(createElement('item', {
                     t: 'default'
@@ -2262,16 +2089,10 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
             const cacheField = this._cache.fields[fieldIndex];
             if (cacheField && cacheField.sharedItems.length > 0) {
                 const itemNodes = [];
-                const allowedIndexes = this._resolveItemFilter(cacheField.sharedItems, assignment?.filter);
                 for(let i = 0; i < cacheField.sharedItems.length; i++){
-                    const shouldInclude = allowedIndexes.has(i);
-                    const itemAttrs = {
+                    itemNodes.push(createElement('item', {
                         x: String(i)
-                    };
-                    if (!shouldInclude) {
-                        itemAttrs.h = '1';
-                    }
-                    itemNodes.push(createElement('item', itemAttrs, []));
+                    }, []));
                 }
                 itemNodes.push(createElement('item', {
                     t: 'default'
@@ -2288,31 +2109,6 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
         }
         return createElement('pivotField', attrs, children);
     }
-    _resolveItemFilter(items, filter) {
-        const allowed = new Set();
-        if (!filter || !filter.include && !filter.exclude) {
-            for(let i = 0; i < items.length; i++){
-                allowed.add(i);
-            }
-            return allowed;
-        }
-        if (filter.include) {
-            for(let i = 0; i < items.length; i++){
-                if (filter.include.includes(items[i])) {
-                    allowed.add(i);
-                }
-            }
-            return allowed;
-        }
-        if (filter.exclude) {
-            for(let i = 0; i < items.length; i++){
-                if (!filter.exclude.includes(items[i])) {
-                    allowed.add(i);
-                }
-            }
-        }
-        return allowed;
-    }
     /**
    * Build row items based on unique values in row fields
    */ _buildRowItems() {
@@ -2463,7 +2259,8 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
         this._records = [];
         this._recordCount = 0;
         this._refreshOnLoad = true; // Default to true
-        this._dateGrouping = false;
+        // Optimized lookup: Map<fieldIndex, Map<stringValue, sharedItemsIndex>>
+        this._sharedItemsIndexMap = new Map();
         this._cacheId = cacheId;
         this._sourceSheet = sourceSheet;
         this._sourceRange = sourceRange;
@@ -2524,6 +2321,8 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
                 minValue: undefined,
                 maxValue: undefined
             }));
+        // Use Sets for O(1) unique value collection during analysis
+        const sharedItemsSets = this._fields.map(()=>new Set());
         // Analyze data to determine field types and collect unique values
         for (const row of data){
             for(let colIdx = 0; colIdx < row.length && colIdx < this._fields.length; colIdx++){
@@ -2534,9 +2333,8 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
                 }
                 if (typeof value === 'string') {
                     field.isNumeric = false;
-                    if (!field.sharedItems.includes(value)) {
-                        field.sharedItems.push(value);
-                    }
+                    // O(1) Set.add instead of O(n) Array.includes + push
+                    sharedItemsSets[colIdx].add(value);
                 } else if (typeof value === 'number') {
                     if (field.minValue === undefined || value < field.minValue) {
                         field.minValue = value;
@@ -2552,8 +2350,22 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
                 }
             }
         }
-        // Enable date grouping flag if any date field exists
-        this._dateGrouping = this._fields.some((field)=>field.isDate);
+        // Convert Sets to arrays and build reverse index Maps for O(1) lookup during XML generation
+        this._sharedItemsIndexMap.clear();
+        for(let colIdx = 0; colIdx < this._fields.length; colIdx++){
+            const field = this._fields[colIdx];
+            const set = sharedItemsSets[colIdx];
+            // Convert Set to array (maintains insertion order in ES6+)
+            field.sharedItems = Array.from(set);
+            // Build reverse lookup Map: value -> index
+            if (field.sharedItems.length > 0) {
+                const indexMap = new Map();
+                for(let i = 0; i < field.sharedItems.length; i++){
+                    indexMap.set(field.sharedItems[i], i);
+                }
+                this._sharedItemsIndexMap.set(colIdx, indexMap);
+            }
+        }
         // Store records
         this._records = data;
     }
@@ -2582,8 +2394,6 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
                         v: item
                     }, []));
                 }
-            } else if (field.isDate) {
-                sharedItemsAttrs.containsDate = '1';
             } else if (field.isNumeric) {
                 // Numeric field - use "0"/"1" for boolean attributes as Excel expects
                 sharedItemsAttrs.containsSemiMixedTypes = '0';
@@ -2614,13 +2424,9 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
             ref: this._sourceRange,
             sheet: this._sourceSheet
         }, []);
-        const cacheSourceAttrs = {
+        const cacheSourceNode = createElement('cacheSource', {
             type: 'worksheet'
-        };
-        if (this._dateGrouping) {
-            cacheSourceAttrs.grouping = '1';
-        }
-        const cacheSourceNode = createElement('cacheSource', cacheSourceAttrs, [
+        }, [
             worksheetSourceNode
         ]);
         // Build attributes - refreshOnLoad should come early per OOXML schema
@@ -2654,15 +2460,15 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
         for (const row of this._records){
             const fieldNodes = [];
             for(let colIdx = 0; colIdx < this._fields.length; colIdx++){
-                const field = this._fields[colIdx];
                 const value = colIdx < row.length ? row[colIdx] : null;
                 if (value === null || value === undefined) {
                     // Missing value
                     fieldNodes.push(createElement('m', {}, []));
                 } else if (typeof value === 'string') {
-                    // String value - use index into sharedItems
-                    const idx = field.sharedItems.indexOf(value);
-                    if (idx >= 0) {
+                    // String value - use index into sharedItems via O(1) Map lookup
+                    const indexMap = this._sharedItemsIndexMap.get(colIdx);
+                    const idx = indexMap?.get(value);
+                    if (idx !== undefined) {
                         fieldNodes.push(createElement('x', {
                             v: String(idx)
                         }, []));
@@ -2766,8 +2572,6 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
         this._pivotTables = [];
         this._pivotCaches = [];
         this._nextCacheId = 0;
-        // Date serialization handling
-        this._dateHandling = 'jsDate';
         this._sharedStrings = new SharedStrings();
         this._styles = Styles.createDefault();
     }
@@ -2832,16 +2636,6 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
         return this._styles;
     }
     /**
-   * Get the workbook date handling strategy.
-   */ get dateHandling() {
-        return this._dateHandling;
-    }
-    /**
-   * Set the workbook date handling strategy.
-   */ set dateHandling(value) {
-        this._dateHandling = value;
-    }
-    /**
    * Get a worksheet by name or index
    */ sheet(nameOrIndex) {
         let def;
@@ -3152,6 +2946,8 @@ const builder = new fastXmlParser.XMLBuilder(builderOptions);
         // Create pivot table
         const pivotTableIndex = this._pivotTables.length + 1;
         const pivotTable = new PivotTable(config.name, cache, targetSheet, targetCell, targetAddr.row + 1, targetAddr.col, pivotTableIndex);
+        // Set styles reference for number format resolution
+        pivotTable.setStyles(this._styles);
         this._pivotTables.push(pivotTable);
         return pivotTable;
     }
@@ -3529,10 +3325,6 @@ exports.SharedStrings = SharedStrings;
 exports.Styles = Styles;
 exports.Workbook = Workbook;
 exports.Worksheet = Worksheet;
-exports.colToLetter = colToLetter;
-exports.isInRange = isInRange;
-exports.letterToCol = letterToCol;
-exports.normalizeRange = normalizeRange;
 exports.parseAddress = parseAddress;
 exports.parseRange = parseRange;
 exports.toAddress = toAddress;