@cj-tech-master/excelts 9.2.1 → 9.3.0

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

@@ -15,6 +15,7 @@ import { WorksheetReader } from "./worksheet-reader.js";
 import { iterateStream } from "../utils/iterate-stream.js";
 import { getWorksheetNoFromWorksheetPath, getWorksheetNoFromWorksheetRelsPath, normalizeZipPath, OOXML_PATHS, worksheetRelTarget } from "../utils/ooxml-paths.js";
 import { WorkbookXform } from "../xlsx/xform/book/workbook-xform.js";
+import { MetadataXform } from "../xlsx/xform/core/metadata-xform.js";
 import { RelationshipsXform } from "../xlsx/xform/core/relationships-xform.js";
 import { StylesXform } from "../xlsx/xform/style/styles-xform.js";
 import { Readable } from "../../stream/index.browser.js";
@@ -36,6 +37,8 @@ export class WorkbookReaderBase extends EventEmitter {
     }
     constructor(input, options, WorksheetReaderClass, HyperlinkReaderClass) {
         super();
+        /** Whether xl/metadata.xml contains XLDAPR dynamic array metadata */
+        this.hasDynamicArrayMetadata = false;
         /** Running total of bytes buffered for waiting worksheets. */
         this._totalBufferedBytes = 0;
         this.input = input;
@@ -443,6 +446,14 @@ export class WorkbookReaderBase extends EventEmitter {
             await this.styles.parseStream(iterateStream(entry));
         }
     }
+    async _parseMetadata(entry) {
+        const xform = new MetadataXform();
+        const result = await xform.parseStream(iterateStream(entry));
+        if (result) {
+            this.hasDynamicArrayMetadata = !!result.hasDynamicArrays;
+            this.dynamicArrayCmIndices = result.dynamicArrayCmIndices;
+        }
+    }
     *_parseWorksheet(iterator, sheetNo) {
         this._emitEntry({ type: "worksheet", id: sheetNo });
         const sheetNoNumber = parseInt(sheetNo, 10);
@@ -511,6 +522,9 @@ export class WorkbookReaderBase extends EventEmitter {
                 case OOXML_PATHS.xlStyles:
                     await this._parseStyles(entry);
                     break;
+                case OOXML_PATHS.xlMetadata:
+                    await this._parseMetadata(entry);
+                    break;
                 default:
                     sheetNo = getWorksheetNoFromWorksheetPath(normalizedPath)?.toString();
                     if (sheetNo) {

package/dist/browser/modules/excel/stream/workbook-reader.d.ts

@@ -3,6 +3,7 @@
  *
  * Extends base with file path support and temp file storage for large files.
  */
+import type { ZipEntry } from "../../archive/unzip/stream.js";
 import { HyperlinkReader } from "./hyperlink-reader.js";
 import { WorkbookReaderBase, type CommonInput, type WorkbookReaderOptions, type WorksheetReadyEvent, WorkbookReaderOptionsSchema } from "./workbook-reader.browser.js";
 import { WorksheetReader } from "./worksheet-reader.js";
@@ -18,7 +19,7 @@ interface WaitingWorksheet {
 declare class WorkbookReader extends WorkbookReaderBase<NodeInput, WorksheetReader, HyperlinkReader, WaitingWorksheet> {
     constructor(input: NodeInput, options?: WorkbookReaderOptions);
     _getStream(input: NodeInput): Readable;
-    _storeWaitingWorksheet(sheetNo: string, entry: any): Promise<WaitingWorksheet>;
+    _storeWaitingWorksheet(sheetNo: string, entry: ZipEntry): Promise<WaitingWorksheet>;
     _processWaitingWorksheets(waitingWorksheets: WaitingWorksheet[]): AsyncIterableIterator<WorksheetReadyEvent<WorksheetReader>>;
 }
 export { WorkbookReader, WorkbookReaderOptionsSchema };

package/dist/browser/modules/excel/stream/workbook-writer.browser.d.ts

@@ -10,11 +10,17 @@
 import { Zip } from "../../archive/zip/stream.js";
 import { DefinedNames } from "../defined-names.js";
 import { WorksheetWriter } from "./worksheet-writer.js";
-import type { ImageData, WorkbookView, AddWorksheetOptions } from "../types.js";
+import type { Font, ImageData, WorkbookView, WorkbookProtection, AddWorksheetOptions } from "../types.js";
 import { SharedStrings } from "../utils/shared-strings.js";
 import { StylesXform } from "../xlsx/xform/style/styles-xform.js";
 import type { Writable } from "../../stream/index.js";
-interface Medium extends ImageData {
+/**
+ * An image registered in the streaming writer.
+ *
+ * Extends the public {@link ImageData} shape with the unique stored name
+ * (`name`) assigned by `addImage`, and pins `type` to `"image"`.
+ */
+export interface Medium extends ImageData {
     type: "image";
     name: string;
 }
@@ -56,8 +62,8 @@ export interface WorkbookWriterOptions {
     trueStreaming?: boolean;
 }
 interface OutputStreamLike {
-    emit(eventName: string | symbol, ...args: any[]): boolean;
-    write(chunk: any): boolean | Promise<boolean>;
+    emit(eventName: string | symbol, ...args: unknown[]): boolean;
+    write(chunk: Uint8Array | string): boolean | Promise<boolean>;
     end(): void;
     once(eventName: string | symbol, listener: (...args: any[]) => void): this;
     removeListener(eventName: string | symbol, listener: (...args: any[]) => void): this;
@@ -107,6 +113,18 @@ export declare abstract class WorkbookWriterBase<TWorksheetWriter extends Worksh
     compressionLevel: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
     media: Medium[];
     commentRefs: CommentRef[];
+    /** Number of cells with dynamic array formulas, accumulated during worksheet commit */
+    dynamicArrayCount: number;
+    /** Workbook-level structure protection */
+    protection?: {
+        lockStructure?: boolean;
+        lockWindows?: boolean;
+        lockRevision?: boolean;
+        algorithmName?: string;
+        hashValue?: string;
+        saltValue?: string;
+        spinCount?: number;
+    };
     zip: Zip;
     stream: OutputStreamLike;
     promise: Promise<void[] | void>;
@@ -118,12 +136,27 @@ export declare abstract class WorkbookWriterBase<TWorksheetWriter extends Worksh
      */
     protected _createOutputStream(options: WorkbookWriterOptions): OutputStreamLike;
     get definedNames(): DefinedNames;
+    /**
+     * The default font for the workbook (fontId=0 / "Normal" style).
+     * Must be set before any worksheet rows are committed.
+     */
+    get defaultFont(): Partial<Font> | undefined;
+    set defaultFont(font: Partial<Font> | undefined);
     protected _addFile(data: string | Uint8Array, name: string, base64?: boolean): void;
     private _commitWorksheets;
     commit(): Promise<void>;
     get nextId(): number;
     addImage(image: ImageData): number;
-    getImage(id: number): ImageData | undefined;
+    getImage(id: number): Medium | undefined;
+    /**
+     * Protect the workbook structure with an optional password.
+     * Prevents users from adding, deleting, renaming, moving, or copying worksheets.
+     */
+    protect(password?: string, options?: Partial<WorkbookProtection>): Promise<void>;
+    /**
+     * Remove workbook structure protection.
+     */
+    unprotect(): void;
     addWorksheet(name?: string, options?: Partial<AddWorksheetOptions>): TWorksheetWriter;
     getWorksheet(id?: string | number): TWorksheetWriter | undefined;
     addStyles(): Promise<void>;
@@ -144,6 +177,7 @@ export declare abstract class WorkbookWriterBase<TWorksheetWriter extends Worksh
     addCore(): Promise<void>;
     addSharedStrings(): Promise<void>;
     addFeaturePropertyBag(): Promise<void>;
+    addMetadata(): Promise<void>;
     addWorkbookRels(): Promise<void>;
     addWorkbook(): Promise<void>;
     private _finalize;

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

@@ -15,12 +15,14 @@ import { filterDrawingAnchors } from "../utils/drawing-utils.js";
 import { drawingPath, drawingRelsPath, mediaPath, OOXML_PATHS, OOXML_REL_TARGETS, worksheetRelTarget } from "../utils/ooxml-paths.js";
 import { SharedStrings } from "../utils/shared-strings.js";
 import { StreamBuf } from "../utils/stream-buf.js";
+import { buildWorkbookProtection } from "../utils/workbook-protection.js";
 import { RelType } from "../xlsx/rel-type.js";
 import { WorkbookXform } from "../xlsx/xform/book/workbook-xform.js";
 import { AppXform } from "../xlsx/xform/core/app-xform.js";
 import { ContentTypesXform } from "../xlsx/xform/core/content-types-xform.js";
 import { CoreXform } from "../xlsx/xform/core/core-xform.js";
 import { FeaturePropertyBagXform } from "../xlsx/xform/core/feature-property-bag-xform.js";
+import { MetadataXform } from "../xlsx/xform/core/metadata-xform.js";
 import { RelationshipsXform } from "../xlsx/xform/core/relationships-xform.js";
 import { DrawingXform } from "../xlsx/xform/drawing/drawing-xform.js";
 import { SharedStringsXform } from "../xlsx/xform/strings/shared-strings-xform.js";
@@ -53,6 +55,7 @@ export class WorkbookWriterBase {
         this.compressionLevel = Math.max(0, Math.min(9, level));
         this.media = [];
         this.commentRefs = [];
+        this.dynamicArrayCount = 0;
         this._trueStreaming = options.trueStreaming ?? false;
         // Create Zip instance
         this.zip = new Zip((err, data, final) => {
@@ -87,6 +90,18 @@ export class WorkbookWriterBase {
     get definedNames() {
         return this._definedNames;
     }
+    /**
+     * The default font for the workbook (fontId=0 / "Normal" style).
+     * Must be set before any worksheet rows are committed.
+     */
+    get defaultFont() {
+        return this.styles.defaultFont;
+    }
+    set defaultFont(font) {
+        if (this.styles.setDefaultFont) {
+            this.styles.setDefaultFont(font);
+        }
+    }
     /** @internal */
     _openStream(path) {
         const stream = new StreamBuf({
@@ -147,6 +162,7 @@ export class WorkbookWriterBase {
             this.addSharedStrings(),
             this.addStyles(),
             this.addFeaturePropertyBag(),
+            this.addMetadata(),
             this.addWorkbookRels()
         ]);
         await this.addWorkbook();
@@ -173,6 +189,19 @@ export class WorkbookWriterBase {
     getImage(id) {
         return this.media[id];
     }
+    /**
+     * Protect the workbook structure with an optional password.
+     * Prevents users from adding, deleting, renaming, moving, or copying worksheets.
+     */
+    async protect(password, options) {
+        this.protection = await buildWorkbookProtection(password, options);
+    }
+    /**
+     * Remove workbook structure protection.
+     */
+    unprotect() {
+        this.protection = undefined;
+    }
     addWorksheet(name, options) {
         const opts = options || {};
         const useSharedStrings = opts.useSharedStrings !== undefined ? opts.useSharedStrings : this.useSharedStrings;
@@ -250,7 +279,8 @@ export class WorkbookWriterBase {
                 commentRefs: this.commentRefs,
                 media: this.media,
                 drawings,
-                hasCheckboxes: this.styles.hasCheckboxes
+                hasCheckboxes: this.styles.hasCheckboxes,
+                hasDynamicArrayFormulas: this.dynamicArrayCount > 0
             };
             const xform = new ContentTypesXform();
             this._addFile(xform.toXml(model), OOXML_PATHS.contentTypes);
@@ -336,6 +366,14 @@ export class WorkbookWriterBase {
         }
         return Promise.resolve();
     }
+    addMetadata() {
+        if (this.dynamicArrayCount <= 0) {
+            return Promise.resolve();
+        }
+        const xform = new MetadataXform();
+        this._addFile(xform.toXml({ dynamicArrayCount: this.dynamicArrayCount }), OOXML_PATHS.xlMetadata);
+        return Promise.resolve();
+    }
     addWorkbookRels() {
         let count = 1;
         const relationships = [
@@ -357,6 +395,14 @@ export class WorkbookWriterBase {
                 Target: OOXML_REL_TARGETS.workbookFeaturePropertyBag
             });
         }
+        // Add metadata relationship for dynamic array formulas
+        if (this.dynamicArrayCount > 0) {
+            relationships.push({
+                Id: `rId${count++}`,
+                Type: RelType.SheetMetadata,
+                Target: OOXML_REL_TARGETS.workbookMetadata
+            });
+        }
         this._worksheets.forEach(ws => {
             if (ws) {
                 ws.rId = `rId${count++}`;
@@ -379,6 +425,7 @@ export class WorkbookWriterBase {
             definedNames: this._definedNames.model,
             views: this.views,
             properties: {},
+            protection: this.protection,
             calcProperties: {}
         };
         return new Promise(resolve => {

package/dist/browser/modules/excel/stream/workbook-writer.d.ts

@@ -6,13 +6,14 @@
 import { WorkbookWriterBase, type WorkbookWriterOptions as BaseOptions, type WorkbookZipOptions, type ZlibOptions } from "./workbook-writer.browser.js";
 import { WorksheetWriter } from "./worksheet-writer.js";
 export type { WorkbookZipOptions, ZlibOptions };
+export type { Medium } from "./workbook-writer.browser.js";
 export interface WorkbookWriterOptions extends BaseOptions {
     /** If stream not specified, this field specifies the path to a file to write the XLSX workbook to */
     filename?: string;
 }
 interface OutputStreamLike {
-    emit(eventName: string | symbol, ...args: any[]): boolean;
-    write(chunk: any): boolean | Promise<boolean>;
+    emit(eventName: string | symbol, ...args: unknown[]): boolean;
+    write(chunk: Uint8Array | string): boolean | Promise<boolean>;
     end(): void;
     once(eventName: string | symbol, listener: (...args: any[]) => void): this;
     removeListener(eventName: string | symbol, listener: (...args: any[]) => void): this;

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

@@ -187,10 +187,12 @@ class WorksheetReader extends EventEmitter {
                     case "c":
                         if (row) {
                             const styleAttr = node.attributes.s;
+                            const cmAttr = node.attributes.cm;
                             c = {
                                 ref: node.attributes.r,
                                 s: styleAttr !== undefined ? parseInt(styleAttr, 10) : undefined,
-                                t: node.attributes.t
+                                t: node.attributes.t,
+                                cm: cmAttr !== undefined ? parseInt(cmAttr, 10) : undefined
                             };
                         }
                         break;
@@ -295,6 +297,20 @@ class WorksheetReader extends EventEmitter {
                                         cellValue.result = parseFloat(c.v.text);
                                     }
                                 }
+                                // Check if this cell is a dynamic array formula via cm → metadata mapping.
+                                // Uses the precise dynamicArrayCmIndices set from WorkbookReaderBase,
+                                // falling back to the coarser hasDynamicArrayMetadata boolean.
+                                if (c.cm !== undefined) {
+                                    const { workbook: wb } = this;
+                                    if (wb.dynamicArrayCmIndices) {
+                                        if (wb.dynamicArrayCmIndices.has(c.cm)) {
+                                            cellValue.isDynamicArray = true;
+                                        }
+                                    }
+                                    else if (wb.hasDynamicArrayMetadata) {
+                                        cellValue.isDynamicArray = true;
+                                    }
+                                }
                                 cell.value = cellValue;
                             }
                             else if (c.v) {

package/dist/browser/modules/excel/stream/worksheet-writer.d.ts

@@ -3,11 +3,37 @@ import { Column } from "../column.js";
 import { DataValidations } from "../data-validations.js";
 import { Dimensions } from "../range.js";
 import { Row } from "../row.js";
-import type { RowBreak, ColBreak, PageSetup, HeaderFooter, WorksheetProperties, WorksheetView, WorksheetState, AutoFilter, WorksheetProtection, ConditionalFormattingOptions, AddImageRange, WatermarkOptions, RowValues } from "../types.js";
+import type { Medium as WriterMedium } from "./workbook-writer.js";
+import { type DrawingAnchor, type DrawingRel } from "../utils/drawing-utils.js";
+import type { SharedStrings } from "../utils/shared-strings.js";
+import type { StreamBuf } from "../utils/stream-buf.js";
+import type { RowBreak, ColBreak, PageSetup, HeaderFooter, WorksheetProperties, WorksheetView, WorksheetState, AutoFilter, WorksheetProtection, ConditionalFormattingOptions, AddImageRange, IgnoredError, WatermarkOptions, RowValues } from "../types.js";
+/**
+ * Structural view of the fields/methods WorksheetWriter needs from its
+ * parent WorkbookWriter. Defined here (rather than importing WorkbookWriter
+ * directly) to avoid the circular `workbook-writer.ts <-> worksheet-writer.ts`
+ * dependency. The shape must stay in sync with the concrete WorkbookWriter.
+ */
+export interface WorkbookWriterLike {
+    /** Shared-string table (deduplicates plain/rich-text cell values). */
+    readonly sharedStrings: SharedStrings;
+    /**
+     * Style manager. Typed loosely here (`unknown`) because the concrete
+     * `StylesXform` is an internal xform class and pulling it in would
+     * reintroduce the circular import. Xform methods accept it by duck-typing.
+     */
+    readonly styles: object;
+    /** Incremented once per dynamic-array formula cell during row commit. */
+    dynamicArrayCount: number;
+    /** Lookup a media (image/chart) by registered id. */
+    getImage(id: number): WriterMedium | undefined;
+    /** Open a streaming entry in the output zip for the given path. */
+    _openStream(path: string): InstanceType<typeof StreamBuf>;
+}
 interface WorksheetWriterOptions {
     id: number;
     name?: string;
-    workbook: any;
+    workbook: WorkbookWriterLike;
     useSharedStrings?: boolean;
     properties?: Partial<WorksheetProperties>;
     state?: WorksheetState;
@@ -38,6 +64,11 @@ interface WriterImageModel {
             height: number;
         };
         editAs?: string;
+        /** Absolute position in pixels — mutually exclusive with tl/br cell anchors. */
+        pos?: {
+            x: number;
+            y: number;
+        };
     };
     hyperlinks?: {
         hyperlink?: string;
@@ -67,6 +98,7 @@ declare class WorksheetWriter {
     private _formulae;
     private _siFormulae;
     conditionalFormatting: ConditionalFormattingOptions[];
+    ignoredErrors: IgnoredError[];
     rowBreaks: RowBreak[];
     colBreaks: ColBreak[];
     properties: Partial<WorksheetProperties> & {
@@ -104,8 +136,8 @@ declare class WorksheetWriter {
     /** Relationship Id - assigned by WorkbookWriter */
     rId?: string;
     constructor(options: WorksheetWriterOptions);
-    get workbook(): any;
-    get stream(): any;
+    get workbook(): WorkbookWriterLike;
+    get stream(): InstanceType<typeof StreamBuf>;
     destroy(): void;
     commit(): void;
     get dimensions(): Dimensions;
@@ -184,6 +216,7 @@ declare class WorksheetWriter {
      * The prepare phase was already done in _writeConditionalFormatting().
      */
     private _writeExtLst;
+    private _writeIgnoredErrors;
     private _writeRowBreaks;
     private _writeColBreaks;
     private _writeDataValidations;
@@ -197,8 +230,8 @@ declare class WorksheetWriter {
     get drawing(): {
         rId: string;
         name: string;
-        anchors: any[];
-        rels: any[];
+        anchors: DrawingAnchor[];
+        rels: DrawingRel[];
     } | undefined;
     private _writeBackground;
     private _writeLegacyData;

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

@@ -26,6 +26,7 @@ import { DrawingXform as DrawingPartXform } from "../xlsx/xform/sheet/drawing-xf
 import { ExtLstXform } from "../xlsx/xform/sheet/ext-lst-xform.js";
 import { HeaderFooterXform } from "../xlsx/xform/sheet/header-footer-xform.js";
 import { HyperlinkXform } from "../xlsx/xform/sheet/hyperlink-xform.js";
+import { IgnoredErrorsXform } from "../xlsx/xform/sheet/ignored-errors-xform.js";
 import { PageMarginsXform } from "../xlsx/xform/sheet/page-margins-xform.js";
 import { PageSetupXform } from "../xlsx/xform/sheet/page-setup-xform.js";
 import { PictureXform } from "../xlsx/xform/sheet/picture-xform.js";
@@ -60,6 +61,7 @@ const xform = {
     drawing: new DrawingPartXform(),
     conditionalFormattings: new ConditionalFormattingsXform(),
     extLst: new ExtLstXform(),
+    ignoredErrors: new IgnoredErrorsXform(),
     headerFooter: new HeaderFooterXform(),
     rowBreaks: new RowBreaksXform(),
     colBreaks: new ColBreaksXform()
@@ -100,6 +102,8 @@ class WorksheetWriter {
         this._siFormulae = 0;
         // keep a record of conditionalFormattings
         this.conditionalFormatting = [];
+        // ignored errors (suppress green triangles in Excel)
+        this.ignoredErrors = [];
         // keep a record of all row and column pageBreaks
         this.rowBreaks = [];
         this.colBreaks = [];
@@ -212,6 +216,8 @@ class WorksheetWriter {
         this._writeBackground(); // Note: must be after drawing
         // Legacy Data tag for comments
         this._writeLegacyData();
+        // ignoredErrors must be before extLst
+        this._writeIgnoredErrors();
         // extLst must be the last child element before </worksheet>
         this._writeExtLst();
         this._writeCloseWorksheet();
@@ -529,18 +535,33 @@ class WorksheetWriter {
             }
             throw new Error(`Invalid image range: "${range}". Expected a range like "A1:C3".`);
         }
-        const tl = new Anchor(this, range.tl, 0).model;
-        const br = range.br ? new Anchor(this, range.br, 0).model : undefined;
+        // Absolute positioning (pos + ext, no cell anchors)
+        if ("pos" in range && range.pos) {
+            return {
+                type: "image",
+                imageId,
+                range: {
+                    tl: { nativeCol: 0, nativeColOff: 0, nativeRow: 0, nativeRowOff: 0 },
+                    ext: range.ext,
+                    pos: range.pos
+                },
+                hyperlinks: range.hyperlinks
+            };
+        }
+        // Cell-based positioning (tl/br anchors)
+        const cellRange = range;
+        const tl = new Anchor(this, cellRange.tl, 0).model;
+        const br = cellRange.br ? new Anchor(this, cellRange.br, 0).model : undefined;
         return {
             type: "image",
             imageId,
             range: {
                 tl,
                 br,
-                ext: range.ext,
-                editAs: range.editAs
+                ext: cellRange.ext,
+                editAs: cellRange.editAs
             },
-            hyperlinks: range.hyperlinks
+            hyperlinks: cellRange.hyperlinks
         };
     }
     // =========================================================================
@@ -617,6 +638,9 @@ class WorksheetWriter {
         }
         if (row.hasValues || row.height != null) {
             const { model } = row;
+            if (!model) {
+                return;
+            }
             const options = {
                 styles: this._workbook.styles,
                 sharedStrings: this.useSharedStrings ? this._workbook.sharedStrings : undefined,
@@ -628,6 +652,14 @@ class WorksheetWriter {
             };
             xform.row.prepare(model, options);
             this.stream.write(xform.row.toXml(model));
+            // Count dynamic array formula cells for metadata generation
+            if (model.cells) {
+                for (const cell of model.cells) {
+                    if (cell && cell.isDynamicArray) {
+                        this._workbook.dynamicArrayCount++;
+                    }
+                }
+            }
             if (options.comments.length) {
                 this.hasComments = true;
                 this._sheetCommentsWriter.addComments(options.comments);
@@ -680,6 +712,11 @@ class WorksheetWriter {
         const model = { conditionalFormattings: this.conditionalFormatting };
         this.stream.write(xform.extLst.toXml(model));
     }
+    _writeIgnoredErrors() {
+        if (this.ignoredErrors.length > 0) {
+            this.stream.write(xform.ignoredErrors.toXml(this.ignoredErrors));
+        }
+    }
     _writeRowBreaks() {
         this.stream.write(xform.rowBreaks.toXml(this.rowBreaks));
     }
@@ -753,6 +790,9 @@ class WorksheetWriter {
         if (this._background) {
             if (this._background.imageId !== undefined) {
                 const image = this._workbook.getImage(this._background.imageId);
+                if (!image) {
+                    return;
+                }
                 const pictureId = this._sheetRelsWriter.addMedia({
                     Target: mediaRelTargetFromRels(image.name),
                     Type: RelType.Image

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

@@ -535,14 +535,27 @@ class Table {
         this._ensureStyle().showColumnStripes = value;
     }
 }
+// SUBTOTAL function codes per OOXML/Excel:
+//   1/101=AVERAGE, 2/102=COUNT, 3/103=COUNTA, 4/104=MAX, 5/105=MIN,
+//   6/106=PRODUCT, 7/107=STDEV, 8/108=STDEVP, 9/109=SUM, 10/110=VAR, 11/111=VARP.
+// The 1xx variants also ignore manually hidden rows — Excel always uses
+// these for totals-row injection. OOXML totalsRowFunction names map to:
+//   average → 1 (AVERAGE)
+//   countNums → 2 (COUNT, numeric-only)
+//   count → 3 (COUNTA)
+//   max → 4
+//   min → 5
+//   stdDev → 7 (sample std dev, per Excel's totals UI)
+//   var → 10  (sample variance, per Excel's totals UI)
+//   sum → 9
 Table.SUBTOTAL_FUNCTIONS = {
     average: 101,
     countNums: 102,
     count: 103,
     max: 104,
     min: 105,
-    stdDev: 106,
-    var: 107,
+    stdDev: 107,
+    var: 110,
     sum: 109
 };
 export { Table, sanitizeTableName };