@cj-tech-master/excelts 5.0.6 → 5.1.0

package/dist/cjs/modules/excel/pivot-table.js

@@ -1,9 +1,44 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.VALID_SUBTOTALS = exports.METRIC_DISPLAY_NAMES = exports.PivotErrorValue = void 0;
 exports.makePivotTable = makePivotTable;
 const utils_1 = require("../../utils/utils.js");
 const col_cache_1 = require("./utils/col-cache.js");
-// TK(2023-10-10): turn this into a class constructor.
+/**
+ * Wrapper for OOXML error values in sharedItems (e.g. `<e v="REF!"/>`).
+ * Distinguishes error strings from regular strings so they roundtrip as `<e>` not `<s>`.
+ */
+class PivotErrorValue {
+    constructor(code) {
+        this.code = code;
+    }
+    /** Returns the display form with '#' prefix, e.g. "#REF!" */
+    toString() {
+        return `#${this.code}`;
+    }
+}
+exports.PivotErrorValue = PivotErrorValue;
+/** Map from PivotTableSubtotal to its Excel display name prefix */
+exports.METRIC_DISPLAY_NAMES = {
+    sum: "Sum",
+    count: "Count",
+    average: "Average",
+    max: "Max",
+    min: "Min",
+    product: "Product",
+    countNums: "Count Numbers",
+    stdDev: "StdDev",
+    stdDevP: "StdDevP",
+    var: "Var",
+    varP: "VarP"
+};
+/** Set of all valid PivotTableSubtotal values (for runtime validation) */
+exports.VALID_SUBTOTALS = new Set(Object.keys(exports.METRIC_DISPLAY_NAMES));
+/**
+ * Data rows start at index 2 in ExcelJS sparse arrays:
+ * index 0 = empty (ExcelJS convention), index 1 = header row.
+ */
+const DATA_START_INDEX = 2;
 /**
  * Creates a PivotTableSource adapter from a Table object.
  * This allows Tables to be used as pivot table data sources with the same interface as Worksheets.
@@ -32,6 +67,9 @@ function createTableSourceAdapter(table) {
     const dataRows = tableModel.rows.map(row => [undefined, ...row]); // sparse array starting at index 1
     // Calculate the range reference for the table
     const tl = tableModel.tl;
+    if (!tl) {
+        throw new Error(`Table "${tableModel.name}" is missing top-left cell address (tl)`);
+    }
     const startRow = tl.row;
     const startCol = tl.col;
     const endRow = startRow + tableModel.rows.length; // header row + data rows
@@ -40,13 +78,15 @@ function createTableSourceAdapter(table) {
     // Use the worksheet name (not table name) for pivotCacheDefinition's worksheetSource
     // The sheet attribute in worksheetSource must reference the actual worksheet name
     const worksheetName = table.worksheet.name;
+    const tableName = tableModel.name;
     return {
         name: worksheetName,
+        tableName,
         getRow(rowNumber) {
             if (rowNumber === 1) {
                 return { values: headerRow };
             }
-            const dataIndex = rowNumber - 2; // rowNumber 2 maps to index 0
+            const dataIndex = rowNumber - DATA_START_INDEX; // rowNumber 2 maps to index 0
             if (dataIndex >= 0 && dataIndex < dataRows.length) {
                 return { values: dataRows[dataIndex] };
             }
@@ -77,66 +117,87 @@ function createTableSourceAdapter(table) {
         dimensions: { shortRange }
     };
 }
+/** Base cache ID starts at 10 (Excel convention), each subsequent table increments */
+const BASE_CACHE_ID = 10;
 /**
  * Resolves the data source from the model, supporting both sourceSheet and sourceTable.
+ * Validates that exactly one source is provided.
  */
 function resolveSource(model) {
+    if (model.sourceSheet && model.sourceTable) {
+        throw new Error("Cannot specify both sourceSheet and sourceTable. Choose one.");
+    }
     if (model.sourceTable) {
         return createTableSourceAdapter(model.sourceTable);
     }
-    // For sourceSheet, it already implements the required interface
+    if (!model.sourceSheet) {
+        throw new Error("Either sourceSheet or sourceTable must be provided.");
+    }
     return model.sourceSheet;
 }
+/** Resolve a value entry to its column name string */
+function resolveValueName(v) {
+    return typeof v === "string" ? v : v.name;
+}
+/** Resolve a value entry's metric (or undefined if inheriting table-wide default) */
+function resolveValueMetric(v) {
+    return typeof v === "string" ? undefined : v.metric;
+}
 function makePivotTable(worksheet, model) {
-    // Example `model`:
-    // {
-    //   // Source of data (either sourceSheet OR sourceTable):
-    //   sourceSheet: worksheet1,  // Use entire sheet range
-    //   // OR
-    //   sourceTable: table,       // Use table data
-    //
-    //   // Pivot table fields: values indicate field names;
-    //   // they come from the first row in `worksheet1` or table column names.
-    //   rows: ['A', 'B'],
-    //   columns: ['C'],
-    //   values: ['E'], // only 1 item possible for now
-    //   metric: 'sum', // only 'sum' possible for now
-    // }
-    // Validate source exists before trying to resolve it
-    if (!model.sourceSheet && !model.sourceTable) {
-        throw new Error("Either sourceSheet or sourceTable must be provided.");
-    }
-    if (model.sourceSheet && model.sourceTable) {
-        throw new Error("Cannot specify both sourceSheet and sourceTable. Choose one.");
-    }
-    // Resolve source first to avoid creating adapter multiple times
+    // Resolve source (validates exactly one source is provided)
     const source = resolveSource(model);
-    validate(worksheet, model, source);
-    const { rows, values } = model;
+    validate(model, source);
+    const { rows } = model;
     const columns = model.columns ?? [];
-    const cacheFields = makeCacheFields(source, [...rows, ...columns], values);
-    const nameToIndex = cacheFields.reduce((result, cacheField, index) => {
-        result[cacheField.name] = index;
-        return result;
-    }, {});
-    const rowIndices = rows.map(row => nameToIndex[row]);
-    const columnIndices = columns.map(column => nameToIndex[column]);
-    const valueIndices = values.map(value => nameToIndex[value]);
-    // Calculate tableNumber based on existing pivot tables (1-indexed)
-    const tableNumber = worksheet.workbook.pivotTables.length + 1;
-    // Base cache ID starts at 10 (Excel convention), each subsequent table increments
-    const BASE_CACHE_ID = 10;
+    const pages = model.pages ?? [];
+    const valueNames = model.values.map(resolveValueName);
+    const defaultMetric = model.metric ?? "sum";
+    const valueMetrics = model.values.map(v => resolveValueMetric(v) ?? defaultMetric);
+    const cacheFields = makeCacheFields(source, [...rows, ...columns, ...pages], valueNames);
+    const nameToIndex = {};
+    for (let i = 0; i < cacheFields.length; i++) {
+        nameToIndex[cacheFields[i].name] = i;
+    }
+    const resolveIndex = (fieldName, role) => {
+        const idx = nameToIndex[fieldName];
+        if (idx === undefined) {
+            throw new Error(`${role} field "${fieldName}" not found in cache fields`);
+        }
+        return idx;
+    };
+    const rowIndices = rows.map(row => resolveIndex(row, "Row"));
+    const columnIndices = columns.map(column => resolveIndex(column, "Column"));
+    const valueIndices = valueNames.map(value => resolveIndex(value, "Value"));
+    const pageIndices = pages.map(page => resolveIndex(page, "Page"));
+    // R9-B1: Calculate tableNumber as max(existing)+1 to avoid collision with loaded
+    // pivot tables that may have non-contiguous numbering (e.g. [1, 2, 5]).
+    // Using length+1 would collide when adding multiple new tables.
+    const existingTableNumbers = worksheet.workbook.pivotTables
+        .map(pt => pt.tableNumber)
+        .filter(n => Number.isFinite(n));
+    const tableNumber = existingTableNumbers.length > 0
+        ? existingTableNumbers.reduce((a, b) => (a > b ? a : b), -Infinity) + 1
+        : 1;
+    // Dynamic cacheId: avoid collision with existing (loaded) pivot tables.
+    // Find the max cacheId already in use and start from max+1.
+    const existingCacheIds = worksheet.workbook.pivotTables
+        .map(pt => parseInt(pt.cacheId, 10))
+        .filter(id => Number.isFinite(id));
+    // R8-O3: Use reduce instead of Math.max(...spread) to avoid stack overflow with many pivot tables
+    const nextCacheId = existingCacheIds.length > 0
+        ? existingCacheIds.reduce((a, b) => (a > b ? a : b), -Infinity) + 1
+        : BASE_CACHE_ID + tableNumber - 1;
     // form pivot table object
     return {
         source,
         rows: rowIndices,
         columns: columnIndices,
         values: valueIndices,
-        metric: model.metric ?? "sum",
+        pages: pageIndices,
+        metric: defaultMetric,
+        valueMetrics,
         cacheFields,
-        // Dynamic cacheId: 10 for first table, 11 for second, etc.
-        // Used in <pivotTableDefinition> and xl/workbook.xml
-        cacheId: String(BASE_CACHE_ID + tableNumber - 1),
+        cacheId: String(nextCacheId),
         // Control whether pivot table style overrides worksheet column widths
         // '0' = preserve worksheet column widths (useful for custom sizing)
         // '1' = apply pivot table style width/height (default Excel behavior)
@@ -145,77 +206,224 @@ function makePivotTable(worksheet, model) {
         tableNumber
     };
 }
-function validate(_worksheet, model, source) {
-    if (model.metric && model.metric !== "sum" && model.metric !== "count") {
-        throw new Error('Only the "sum" and "count" metrics are supported at this time.');
-    }
+function validate(model, source) {
     const columns = model.columns ?? [];
+    const pages = model.pages ?? [];
+    const valueNames = model.values.map(resolveValueName);
     // Get header names from source (already resolved)
     const headerNames = source.getRow(1).values.slice(1);
-    // Use Set for O(1) lookup
-    const headerNameSet = new Set(headerNames);
-    for (const name of [...model.rows, ...columns, ...model.values]) {
+    // Validate no empty header names (null, undefined, empty-string, or whitespace-only).
+    // Note: numeric 0 and boolean false are valid headers (they coerce to "0"/"false").
+    for (let i = 0; i < headerNames.length; i++) {
+        const h = headerNames[i];
+        if (h === null || h === undefined || h === "" || (typeof h === "string" && h.trim() === "")) {
+            throw new Error(`Empty or missing header name at column ${i + 1} in ${source.name}. Pivot tables require all columns to have non-empty headers.`);
+        }
+    }
+    // Validate no duplicate header names
+    const headerDupCheck = new Set();
+    for (const h of headerNames) {
+        const name = String(h);
+        if (headerDupCheck.has(name)) {
+            throw new Error(`Duplicate header name "${name}" found in ${source.name}. Pivot tables require unique column names.`);
+        }
+        headerDupCheck.add(name);
+    }
+    // Use Set for O(1) lookup — coerce to String for consistent comparison with user-supplied names
+    const headerNameSet = new Set(headerNames.map(String));
+    const validateFieldExists = (name) => {
         if (!headerNameSet.has(name)) {
             throw new Error(`The header name "${name}" was not found in ${source.name}.`);
         }
+    };
+    for (const name of model.rows) {
+        validateFieldExists(name);
+    }
+    for (const name of columns) {
+        validateFieldExists(name);
+    }
+    for (const name of valueNames) {
+        validateFieldExists(name);
+    }
+    for (const name of pages) {
+        validateFieldExists(name);
+    }
+    // Validate no duplicate field names across axis areas (rows, columns, pages).
+    // A field can only belong to one axis area. Values can overlap with axis areas (dataField="1").
+    const fieldToAxis = new Map();
+    const axisAreas = [
+        { name: "rows", fields: model.rows },
+        { name: "columns", fields: columns },
+        { name: "pages", fields: pages }
+    ];
+    for (const area of axisAreas) {
+        for (const field of area.fields) {
+            const existing = fieldToAxis.get(field);
+            if (existing === area.name) {
+                throw new Error(`Duplicate field "${field}" in ${area.name}. Each field can only appear once per axis area.`);
+            }
+            else if (existing) {
+                throw new Error(`Field "${field}" cannot appear in both ${existing} and ${area.name}. Each field can only be assigned to one axis area.`);
+            }
+            fieldToAxis.set(field, area.name);
+        }
     }
     if (!model.rows.length) {
         throw new Error("No pivot table rows specified.");
     }
     // Allow empty columns - Excel will use "Values" as column field
-    // But can't have multiple values with columns specified
     if (model.values.length < 1) {
         throw new Error("Must have at least one value.");
     }
-    if (model.values.length > 1 && columns.length > 0) {
-        throw new Error("It is currently not possible to have multiple values when columns are specified. Please either supply an empty array for columns or a single value.");
+    // Validate metric values at runtime (guards against `as any` bypasses)
+    if (model.metric !== undefined && !exports.VALID_SUBTOTALS.has(model.metric)) {
+        throw new Error(`Invalid metric "${model.metric}". Must be one of: ${[...exports.VALID_SUBTOTALS].join(", ")}.`);
     }
+    for (const v of model.values) {
+        const perMetric = resolveValueMetric(v);
+        if (perMetric !== undefined && !exports.VALID_SUBTOTALS.has(perMetric)) {
+            throw new Error(`Invalid metric "${perMetric}" on value field "${resolveValueName(v)}". Must be one of: ${[...exports.VALID_SUBTOTALS].join(", ")}.`);
+        }
+    }
+    // Validate no duplicate value field names
+    const valueDupCheck = new Set();
+    for (const name of valueNames) {
+        if (valueDupCheck.has(name)) {
+            throw new Error(`Duplicate value field "${name}". Each value field name must be unique.`);
+        }
+        valueDupCheck.add(name);
+    }
+    // Multiple values with columns is supported — the synthetic "Values" pseudo-field
+    // (field x="-2") is appended to colFields so Excel positions the data field labels
+    // correctly on the column axis.
+}
+/**
+ * R8-B2: Unwrap complex cell value types to a primitive suitable for pivot table shared items.
+ * - CellErrorValue ({error:"#REF!"}) → PivotErrorValue
+ * - CellRichTextValue ({richText:[...]}) → concatenated plain text
+ * - CellFormulaValue / CellArrayFormulaValue / CellSharedFormulaValue → result value (recursive)
+ * - CellHyperlinkValue ({text,hyperlink}) → text string
+ * - CellCheckboxValue ({checkbox:bool}) → boolean
+ * - Other objects → String(v)
+ */
+function unwrapCellValue(v) {
+    if (v === null || v === undefined) {
+        return null;
+    }
+    if (typeof v !== "object") {
+        // Already a primitive (string, number, boolean)
+        return v;
+    }
+    if (v instanceof Date) {
+        return v;
+    }
+    if (v instanceof PivotErrorValue) {
+        return v;
+    }
+    const obj = v;
+    // CellErrorValue: { error: "#REF!" } → PivotErrorValue with code "REF!" (strip leading #)
+    if (typeof obj.error === "string") {
+        const errorStr = obj.error;
+        return new PivotErrorValue(errorStr.startsWith("#") ? errorStr.slice(1) : errorStr);
+    }
+    // CellFormulaValue / CellArrayFormulaValue / CellSharedFormulaValue: { formula/sharedFormula, result }
+    if ("formula" in obj || "sharedFormula" in obj) {
+        const result = obj.result;
+        if (result === undefined || result === null) {
+            return null;
+        }
+        // result can be number | string | boolean | Date | CellErrorValue — recurse
+        return unwrapCellValue(result);
+    }
+    // CellRichTextValue: { richText: [{text:"..."}, ...] }
+    if (Array.isArray(obj.richText)) {
+        return obj.richText.map(rt => rt.text ?? "").join("");
+    }
+    // CellHyperlinkValue: { text, hyperlink }
+    if (typeof obj.text === "string" && typeof obj.hyperlink === "string") {
+        return obj.text;
+    }
+    // CellCheckboxValue: { checkbox: boolean }
+    if (typeof obj.checkbox === "boolean") {
+        return obj.checkbox;
+    }
+    // Unknown object — fallback to string
+    return String(v);
 }
 function makeCacheFields(source, fieldNamesWithSharedItems, valueFieldNames) {
     // Cache fields are used in pivot tables to reference source data.
     // Fields in fieldNamesWithSharedItems get their unique values extracted as sharedItems.
     // Fields in valueFieldNames (but not in fieldNamesWithSharedItems) get min/max calculated.
-    // Other fields are unused and get empty sharedItems.
+    // Other fields are unused and get null sharedItems.
     const names = source.getRow(1).values;
     // Use Set for O(1) lookup instead of object
     const sharedItemsFields = new Set(fieldNamesWithSharedItems);
     const valueFields = new Set(valueFieldNames);
     const aggregate = (columnIndex) => {
         const columnValues = source.getColumn(columnIndex).values;
-        // Build unique values set directly, skipping header (index 0,1) and null/undefined
+        // Build unique values set directly, skipping header (index 0,1).
+        // null/undefined are tracked separately (collapsed to a single null sentinel)
+        // because Set treats each null as the same key but undefined as a separate key,
+        // and we need null in sharedItems so renderCellNew can find it via indexOf.
         const uniqueValues = new Set();
-        for (let i = 2; i < columnValues.length; i++) {
-            const v = columnValues[i];
-            if (v !== null && v !== undefined) {
+        // R8-B12: PivotErrorValue uses reference equality in Set, so track error strings
+        // separately to avoid duplicates (e.g., two PivotErrorValue("#REF!") instances).
+        const seenErrors = new Map();
+        let hasNull = false;
+        for (let i = DATA_START_INDEX; i < columnValues.length; i++) {
+            // R8-B2: Unwrap complex cell values (formula results, rich text, errors, etc.)
+            const v = unwrapCellValue(columnValues[i]);
+            if (v === null || (typeof v === "number" && isNaN(v))) {
+                hasNull = true;
+            }
+            else if (v instanceof PivotErrorValue) {
+                // R8-B12: Deduplicate PivotErrorValue by error string
+                if (!seenErrors.has(v.code)) {
+                    seenErrors.set(v.code, v);
+                    uniqueValues.add(v);
+                }
+            }
+            else {
                 uniqueValues.add(v);
             }
         }
-        return (0, utils_1.toSortedArray)(uniqueValues);
+        const sorted = (0, utils_1.toSortedArray)(uniqueValues);
+        // Append null at the end (OOXML convention: <m/> items go last in sharedItems)
+        if (hasNull) {
+            sorted.push(null);
+        }
+        return sorted;
     };
-    // Calculate min/max for numeric fields
+    // Calculate min/max and integer status for numeric fields
     const getMinMax = (columnIndex) => {
         const columnValues = source.getColumn(columnIndex).values;
         let min = Infinity;
         let max = -Infinity;
         let hasNumeric = false;
-        for (let i = 2; i < columnValues.length; i++) {
-            const v = columnValues[i];
-            if (typeof v === "number" && !isNaN(v)) {
+        let allInteger = true;
+        for (let i = DATA_START_INDEX; i < columnValues.length; i++) {
+            // R8-B10: Unwrap formula/complex cell values to extract numeric results
+            const unwrapped = unwrapCellValue(columnValues[i]);
+            if (typeof unwrapped === "number" && !isNaN(unwrapped)) {
                 hasNumeric = true;
-                if (v < min) {
-                    min = v;
+                if (unwrapped < min) {
+                    min = unwrapped;
+                }
+                if (unwrapped > max) {
+                    max = unwrapped;
                 }
-                if (v > max) {
-                    max = v;
+                if (!Number.isInteger(unwrapped)) {
+                    allInteger = false;
                 }
             }
         }
-        return hasNumeric ? { minValue: min, maxValue: max } : null;
+        return hasNumeric ? { minValue: min, maxValue: max, allInteger } : null;
     };
     // Build result array
     const result = [];
     for (const columnIndex of (0, utils_1.range)(1, names.length)) {
-        const name = names[columnIndex];
+        const rawName = names[columnIndex];
+        const name = String(rawName);
         if (sharedItemsFields.has(name)) {
             // Field used for rows/columns - extract unique values as sharedItems
             result.push({ name, sharedItems: aggregate(columnIndex) });
@@ -226,8 +434,10 @@ function makeCacheFields(source, fieldNamesWithSharedItems, valueFieldNames) {
             result.push({
                 name,
                 sharedItems: null,
+                containsNumber: minMax ? "1" : undefined,
                 minValue: minMax?.minValue,
-                maxValue: minMax?.maxValue
+                maxValue: minMax?.maxValue,
+                containsInteger: minMax?.allInteger ? "1" : undefined
             });
         }
         else {

package/dist/cjs/modules/excel/row.js

@@ -159,8 +159,8 @@ class Row {
     // Page Breaks
     addPageBreak(lft, rght) {
         const ws = this._worksheet;
-        const left = Math.max(0, (lft || 0) - 1) || 0;
-        const right = Math.max(0, (rght || 0) - 1) || 16838;
+        const left = Math.max(0, (lft ?? 0) - 1) || 0;
+        const right = Math.max(0, (rght ?? 0) - 1) || 16838;
         const pb = {
             id: this._number,
             max: right,
@@ -354,7 +354,7 @@ class Row {
         this._hidden = value;
     }
     get outlineLevel() {
-        return this._outlineLevel || 0;
+        return this._outlineLevel ?? 0;
     }
     set outlineLevel(value) {
         this._outlineLevel = value;
@@ -438,7 +438,7 @@ class Row {
             delete this.height;
         }
         this.hidden = value.hidden;
-        this.outlineLevel = value.outlineLevel || 0;
+        this.outlineLevel = value.outlineLevel ?? 0;
         this.dyDescent = value.dyDescent;
         this.style = (value.style && JSON.parse(JSON.stringify(value.style))) || {};
     }

package/dist/cjs/modules/excel/stream/workbook-reader.browser.js

@@ -172,7 +172,7 @@ class WorkbookReaderBase extends _stream_1.EventEmitter {
         this.workbookRels = await xform.parseStream((0, iterate_stream_1.iterateStream)(entry));
         // Build fast lookup for worksheet relationship ids.
         this._workbookRelIdByTarget = Object.create(null);
-        for (const rel of this.workbookRels || []) {
+        for (const rel of this.workbookRels ?? []) {
             if (rel?.Target && rel?.Id) {
                 this._workbookRelIdByTarget[rel.Target] = rel.Id;
             }
@@ -185,7 +185,7 @@ class WorkbookReaderBase extends _stream_1.EventEmitter {
         this.properties = workbook.map?.workbookPr;
         // Build fast lookup for sheet metadata by relationship id.
         this._sheetByRelId = Object.create(null);
-        for (const sheet of this.model?.sheets || []) {
+        for (const sheet of this.model?.sheets ?? []) {
             this._sheetByRelId[sheet.rId] = sheet;
         }
     }
@@ -292,10 +292,10 @@ class WorkbookReaderBase extends _stream_1.EventEmitter {
                             break;
                         case "si":
                             if (this.options.sharedStrings === "cache") {
-                                this.sharedStrings.push(richText.length ? { richText } : text || "");
+                                this.sharedStrings.push(richText.length ? { richText } : (text ?? ""));
                             }
                             else if (this.options.sharedStrings === "emit") {
-                                yield { index: index++, text: richText.length ? { richText } : text || "" };
+                                yield { index: index++, text: richText.length ? { richText } : (text ?? "") };
                             }
                             richText = [];
                             font = null;

package/dist/cjs/modules/excel/stream/workbook-writer.browser.js

@@ -38,10 +38,10 @@ class WorkbookWriterBase {
         this.WorksheetWriterClass = WorksheetWriterClass;
         this.created = options.created || new Date();
         this.modified = options.modified || this.created;
-        this.creator = options.creator || "ExcelTS";
-        this.lastModifiedBy = options.lastModifiedBy || "ExcelTS";
+        this.creator = options.creator ?? "ExcelTS";
+        this.lastModifiedBy = options.lastModifiedBy ?? "ExcelTS";
         this.lastPrinted = options.lastPrinted;
-        this.useSharedStrings = options.useSharedStrings || false;
+        this.useSharedStrings = options.useSharedStrings ?? false;
         this.sharedStrings = new shared_strings_1.SharedStrings();
         this.styles = options.useStyles ? new styles_xform_1.StylesXform(true) : new styles_xform_1.StylesXform.Mock(true);
         this._definedNames = new defined_names_1.DefinedNames();
@@ -173,7 +173,7 @@ class WorkbookWriterBase {
             opts.properties = { tabColor: opts.tabColor, ...opts.properties };
         }
         const id = this.nextId;
-        name = name || `sheet${id}`;
+        name = name ?? `sheet${id}`;
         const worksheet = new this.WorksheetWriterClass({
             id,
             name,

package/dist/cjs/modules/excel/stream/worksheet-reader.js

@@ -168,7 +168,7 @@ class WorksheetReader extends _stream_1.EventEmitter {
                                         min: parseInt(node.attributes.min, 10),
                                         max: parseInt(node.attributes.max, 10),
                                         width: parseFloat(node.attributes.width),
-                                        styleId: parseInt(node.attributes.style || "0", 10)
+                                        styleId: parseInt(node.attributes.style ?? "0", 10)
                                     });
                                 }
                                 break;

package/dist/cjs/modules/excel/stream/worksheet-writer.js

@@ -67,7 +67,7 @@ class WorksheetWriter {
         // and a name
         this.name = options.name || `Sheet${this.id}`;
         // add a state
-        this.state = options.state || "visible";
+        this.state = options.state ?? "visible";
         // rows are stored here while they need to be worked on.
         // when they are committed, they will be deleted.
         this._rows = [];
@@ -141,13 +141,13 @@ class WorksheetWriter {
             colBreaks: null
         }, options.pageSetup);
         // using shared strings creates a smaller xlsx file but may use more memory
-        this.useSharedStrings = options.useSharedStrings || false;
+        this.useSharedStrings = options.useSharedStrings ?? false;
         this._workbook = options.workbook;
         this.hasComments = false;
         // views
-        this._views = options.views || [];
+        this._views = options.views ?? [];
         // auto filter
-        this.autoFilter = options.autoFilter || null;
+        this.autoFilter = options.autoFilter ?? null;
         this._media = [];
         // worksheet protection
         this.sheetProtection = null;

package/dist/cjs/modules/excel/table.js

@@ -107,7 +107,7 @@ class Table {
             case "sum":
                 return `SUBTOTAL(109,${this.table.name}[${column.name}])`;
             case "custom":
-                return column.totalsRowFormula || null;
+                return column.totalsRowFormula ?? null;
             default:
                 throw new Error(`Invalid Totals Row Function: ${column.totalsRowFunction}`);
         }
@@ -169,7 +169,7 @@ class Table {
             }
             else {
                 assign(column, "totalsRowFunction", "none");
-                column.totalsRowFormula = this.getFormula(column) || undefined;
+                column.totalsRowFormula = this.getFormula(column) ?? undefined;
             }
         });
     }

package/dist/cjs/modules/excel/utils/cell-format.js

@@ -112,7 +112,7 @@ function getFormat(numFmtId) {
     }
     // Check default map
     if (DEFAULT_MAP[numFmtId] !== undefined) {
-        return TABLE_FMT[DEFAULT_MAP[numFmtId]] || "General";
+        return TABLE_FMT[DEFAULT_MAP[numFmtId]] ?? "General";
     }
     return "General";
 }
@@ -344,7 +344,7 @@ function formatGeneral(val) {
  */
 function formatPercentage(val, fmt) {
     // Count % signs
-    const percentCount = (fmt.match(/%/g) || []).length;
+    const percentCount = (fmt.match(/%/g) ?? []).length;
     // Multiply value by 100 for each %
     const scaledVal = val * Math.pow(100, percentCount);
     // Remove % from format to process the number part
@@ -558,7 +558,7 @@ function formatNumberPattern(val, fmt) {
             formattedInt = commaify(intPart);
         }
         // Pad integer with leading zeros if needed
-        const minIntDigits = (intFmt.match(/0/g) || []).length;
+        const minIntDigits = (intFmt.match(/0/g) ?? []).length;
         if (formattedInt.length < minIntDigits) {
             formattedInt = "0".repeat(minIntDigits - formattedInt.length) + formattedInt;
         }

package/dist/cjs/modules/excel/utils/shared-formula.js

@@ -30,7 +30,7 @@ function slideFormula(formula, fromCell, toCell) {
             if (!rowDollar) {
                 row += to.row - offset.row;
             }
-            const res = (sheet || "") + (colDollar || "") + col_cache_1.colCache.n2l(col) + (rowDollar || "") + row;
+            const res = (sheet ?? "") + (colDollar ?? "") + col_cache_1.colCache.n2l(col) + (rowDollar ?? "") + row;
             return res;
         }
         return refMatch;

package/dist/cjs/modules/excel/utils/stream-buf.js

@@ -135,7 +135,7 @@ class StreamBuf extends _stream_1.EventEmitter {
         this._asyncWriteQueue = Promise.resolve();
         this.bufSize = options?.bufSize || 1024 * 1024;
         this.buffers = [];
-        this.batch = options?.batch || false;
+        this.batch = options?.batch ?? false;
         this.corked = false;
         this.paused = false;
         this.encoding = null;
@@ -348,7 +348,7 @@ class StreamBuf extends _stream_1.EventEmitter {
      * Cross-platform compatible - works identically in Node.js and Browser.
      */
     readString(encoding) {
-        const enc = encoding || this.encoding || "utf-8";
+        const enc = encoding ?? this.encoding ?? "utf-8";
         const buf = this.read();
         if (typeof Buffer !== "undefined" && buf instanceof Buffer) {
             return buf.toString(enc);