documonster 0.18.1 → 0.18.2

package/dist/iife/documonster.xml.iife.min.js

@@ -1,5 +1,5 @@
 /*!
-* documonster v0.18.1
+* documonster v0.18.2
 * Zero-dependency TypeScript toolkit for Excel, Word, PDF, CSV, Markdown, XML & ZIP — one API across Node.js, Bun & browsers.
 * (c) 2025 cjnoname
 * Released under the Apache-2.0 License

package/dist/types/modules/excel/core/pivot-table.d.ts

@@ -199,6 +199,24 @@ export interface PivotTable {
     cacheDefinition?: ParsedCacheDefinition;
     /** Cache records for loaded pivot tables */
     cacheRecords?: ParsedCacheRecords;
+    /** Caption of the data field, shown with two or more data items. */
+    dataCaption?: string;
+    /** Caption for grand totals. */
+    grandTotalCaption?: string;
+    /** Header caption over the row labels (compact layout). */
+    rowHeaderCaption?: string;
+    /** Header caption over the column labels (compact layout). */
+    colHeaderCaption?: string;
+    /** Whether `errorCaption` replaces error values. */
+    showError?: string;
+    /** String shown in place of an error value. */
+    errorCaption?: string;
+    /** Whether `missingCaption` is shown for empty values. */
+    showMissing?: string;
+    /** String shown for an empty value. */
+    missingCaption?: string;
+    /** User-defined string associated with the table. */
+    tag?: string;
     /** Root chartFormat attribute used by pivot charts. */
     chartFormat?: number;
     /** Chart format entries used by pivot charts. */

package/dist/types/modules/excel/xlsb/pivot-view.d.ts

@@ -107,6 +107,22 @@ export interface PivotViewModel {
     }[];
     /** The caption above the data-field column when there are two or more data items. */
     readonly dataCaption: string;
+    /** `irstGrand`: a user-defined grand-total caption. Absent means the application's own. */
+    readonly grandTotalCaption?: string;
+    /** `fDisplayErrorString`: show `errorCaption` in place of an error value. */
+    readonly showError?: boolean;
+    /** `irstErrorString`. */
+    readonly errorCaption?: string;
+    /** `fDisplayNullString`: show `missingCaption` for an empty value. Defaults to true, as XLSX's `showMissing`. */
+    readonly showMissing?: boolean;
+    /** `irstNullString`. */
+    readonly missingCaption?: string;
+    /** `irstTag`. */
+    readonly tag?: string;
+    /** `irstRwHdrName`: the row header caption in compact layout. */
+    readonly rowHeaderCaption?: string;
+    /** `irstColHdrName`: the column header caption in compact layout. */
+    readonly colHeaderCaption?: string;
 }
 /**
  * `pivotTable{n}.bin`.

package/dist/types/modules/excel/xlsx/xform/pivot-table/pivot-table-xform.d.ts

@@ -33,6 +33,8 @@ interface PivotTableRenderModel {
  * Items can reference a shared item index (x attribute) or indicate a subtotal type (t attribute).
  */
 interface PivotFieldItem {
+    /** User caption — the name the item was renamed to in Excel */
+    n?: string;
     /** Shared item index (maps to cacheField sharedItems) */
     x?: number;
     /** Item type: "default" for subtotals, "sum", "count", "avg", "max", "min", "grand", etc. */
@@ -49,6 +51,10 @@ interface PivotFieldItem {
     c?: string;
     /** Drill across flag */
     d?: string;
+    /** Value-is-string flag (OLAP) */
+    s?: string;
+    /** Expanded flag (OLAP) */
+    e?: string;
 }
 /**
  * Parsed pivot field
@@ -69,6 +75,18 @@ interface ParsedPivotField {
     multipleItemSelectionAllowed?: boolean;
     /** Bag of additional attributes not individually modeled (for roundtrip preservation) */
     extraAttrs?: Record<string, string>;
+    /** Preserved field-level `<extLst>` XML (e.g. x14:pivotField fillDownLabels) */
+    extLstXml?: string;
+}
+/**
+ * Parsed data field (value field). Extends the public shape with what a
+ * loaded file carries but the builder never produces.
+ */
+interface ParsedDataField extends DataField {
+    /** Attributes not individually modeled, e.g. `showDataAs` (for roundtrip preservation) */
+    extraAttrs?: Record<string, string>;
+    /** Preserved field-level `<extLst>` XML (e.g. x14:dataField pivotShowAs) */
+    extLstXml?: string;
 }
 /**
  * Parsed page field (report filter)
@@ -78,6 +96,10 @@ interface ParsedPageField {
     item?: number;
     hier?: number;
     name?: string;
+    /** Display caption of the hierarchy (OLAP) */
+    cap?: string;
+    /** Preserved field-level `<extLst>` XML */
+    extLstXml?: string;
 }
 /**
  * Parsed pivot table model (loaded from file)
@@ -98,7 +120,7 @@ interface ParsedPivotTableModel {
     rowFields: number[];
     colFields: number[];
     pageFields: ParsedPageField[];
-    dataFields: DataField[];
+    dataFields: ParsedDataField[];
     applyNumberFormats?: string;
     applyBorderFormats?: string;
     applyFontFormats?: string;
@@ -135,6 +157,17 @@ interface ParsedPivotTableModel {
     showMissing?: string;
     missingCaption?: string;
     grandTotalCaption?: string;
+    /** Header caption over the row labels in compact layout */
+    rowHeaderCaption?: string;
+    /** Header caption over the column labels in compact layout */
+    colHeaderCaption?: string;
+    /** User-defined string associated with the table */
+    tag?: string;
+    /**
+     * Root attributes not individually modeled — showHeaders, pageStyle,
+     * mc:Ignorable, … — preserved verbatim for roundtrip.
+     */
+    extraRootAttrs?: Record<string, string>;
     rowItems?: RowColItem[];
     colItems?: RowColItem[];
     hasColFields?: boolean;
@@ -174,9 +207,16 @@ declare class PivotTableXform extends BaseXform<ParsedPivotTableModel | null> {
     private currentRowItem;
     private currentColItem;
     private currentChartFormat;
-    private pivotAreaXmlBuffer;
-    private autoSortScopeXmlBuffer;
+    private currentDataField;
+    private currentPageField;
     private extLstCollector;
+    /**
+     * Verbatim capture of a subtree that belongs to the element being parsed —
+     * a field's own `<extLst>`, a pivotField's `<autoSortScope>`, a chartFormat's
+     * `<pivotArea>`. `commit` receives the XML once the subtree closes.
+     */
+    private nestedCollector;
+    private nestedCommit;
     private formatsCollector;
     private conditionalFormatsCollector;
     private filtersCollector;
@@ -217,6 +257,8 @@ declare class PivotTableXform extends BaseXform<ParsedPivotTableModel | null> {
     private renderPivotFieldLoaded;
     parseOpen(node: ParseOpenTag): boolean;
     parseText(text: string): void;
+    /** Begin capturing the subtree rooted at `name`; `commit` receives it when it closes. */
+    private startNested;
     /** Feed a close-tag to a collector; if it completes, store the result on the model. */
     private tryCloseCollector;
     parseClose(name: string): boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "documonster",
-  "version": "0.18.1",
+  "version": "0.18.2",
   "description": "Zero-dependency TypeScript toolkit for Excel, Word, PDF, CSV, Markdown, XML & ZIP — one API across Node.js, Bun & browsers.",
   "keywords": [
     "archive",