@cj-tech-master/excelts 1.5.0 → 1.6.1

package/dist/types/xlsx/xform/pivot-table/pivot-cache-definition-xform.d.ts

@@ -1,19 +1,58 @@
 import { BaseXform } from "../base-xform.js";
+import { type CacheFieldModel } from "./cache-field-xform.js";
+import type { PivotTableSource } from "../../../doc/pivot-table.js";
+/**
+ * Model for parsed pivot cache definition
+ */
+interface ParsedCacheDefinitionModel {
+    sourceRef?: string;
+    sourceSheet?: string;
+    cacheFields: CacheFieldModel[];
+    recordCount?: number;
+    rId?: string;
+    refreshOnLoad?: string;
+    refreshedBy?: string;
+    refreshedDate?: string;
+    createdVersion?: string;
+    refreshedVersion?: string;
+    minRefreshableVersion?: string;
+    isLoaded?: boolean;
+}
+/**
+ * Model for generating pivot cache definition (with live source)
+ */
 interface CacheDefinitionModel {
-    sourceSheet: any;
+    source: PivotTableSource;
     cacheFields: any[];
 }
 declare class PivotCacheDefinitionXform extends BaseXform {
     map: {
         [key: string]: any;
     };
+    model: ParsedCacheDefinitionModel | null;
+    private currentCacheField;
+    private inCacheFields;
+    private inCacheSource;
     constructor();
     prepare(_model: any): void;
     get tag(): string;
-    render(xmlStream: any, model: CacheDefinitionModel): void;
-    parseOpen(_node: any): boolean;
-    parseText(_text: string): void;
-    parseClose(_name: string): boolean;
+    reset(): void;
+    /**
+     * Render pivot cache definition XML.
+     * Supports both newly created models (with PivotTableSource) and loaded models.
+     */
+    render(xmlStream: any, model: CacheDefinitionModel | ParsedCacheDefinitionModel): void;
+    /**
+     * Render newly created pivot cache definition
+     */
+    private renderNew;
+    /**
+     * Render loaded pivot cache definition (preserving original structure)
+     */
+    private renderLoaded;
+    parseOpen(node: any): boolean;
+    parseText(text: string): void;
+    parseClose(name: string): boolean;
     reconcile(_model: any, _options: any): void;
     static PIVOT_CACHE_DEFINITION_ATTRIBUTES: {
         xmlns: string;
@@ -23,4 +62,4 @@ declare class PivotCacheDefinitionXform extends BaseXform {
         "xmlns:xr": string;
     };
 }
-export { PivotCacheDefinitionXform };
+export { PivotCacheDefinitionXform, type ParsedCacheDefinitionModel };

package/dist/types/xlsx/xform/pivot-table/pivot-cache-records-xform.d.ts

@@ -1,19 +1,66 @@
 import { BaseXform } from "../base-xform.js";
+import type { PivotTableSource } from "../../../doc/pivot-table.js";
+/**
+ * Model for generating pivot cache records (with live source)
+ */
 interface CacheRecordsModel {
-    sourceSheet: any;
+    source: PivotTableSource;
     cacheFields: any[];
 }
+/**
+ * Parsed record value - can be:
+ * - { type: 'x', value: number } - Shared item index
+ * - { type: 'n', value: number } - Numeric value
+ * - { type: 's', value: string } - String value
+ * - { type: 'b', value: boolean } - Boolean value
+ * - { type: 'm' } - Missing/null value
+ * - { type: 'd', value: Date } - Date value
+ * - { type: 'e', value: string } - Error value
+ */
+interface RecordValue {
+    type: "x" | "n" | "s" | "b" | "m" | "d" | "e";
+    value?: any;
+}
+/**
+ * Parsed cache records model
+ */
+interface ParsedCacheRecordsModel {
+    records: RecordValue[][];
+    count: number;
+    isLoaded?: boolean;
+}
 declare class PivotCacheRecordsXform extends BaseXform {
     map: {
         [key: string]: any;
     };
+    model: ParsedCacheRecordsModel | null;
+    private currentRecord;
     constructor();
     prepare(_model: any): void;
     get tag(): string;
-    render(xmlStream: any, model: CacheRecordsModel): void;
-    parseOpen(_node: any): boolean;
+    reset(): void;
+    /**
+     * Render pivot cache records XML.
+     * Supports both newly created models (with PivotTableSource) and loaded models.
+     */
+    render(xmlStream: any, model: CacheRecordsModel | ParsedCacheRecordsModel): void;
+    /**
+     * Render newly created pivot cache records
+     */
+    private renderNew;
+    /**
+     * Render loaded pivot cache records
+     */
+    private renderLoaded;
+    /**
+     * Render a single record value to XML
+     */
+    private renderRecordValue;
+    private renderTableNew;
+    private renderCellNew;
+    parseOpen(node: any): boolean;
     parseText(_text: string): void;
-    parseClose(_name: string): boolean;
+    parseClose(name: string): boolean;
     reconcile(_model: any, _options: any): void;
     static PIVOT_CACHE_RECORDS_ATTRIBUTES: {
         xmlns: string;
@@ -23,4 +70,4 @@ declare class PivotCacheRecordsXform extends BaseXform {
         "xmlns:xr": string;
     };
 }
-export { PivotCacheRecordsXform };
+export { PivotCacheRecordsXform, type ParsedCacheRecordsModel };

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

@@ -1,23 +1,116 @@
 import { BaseXform } from "../base-xform.js";
+/**
+ * Model for generating pivot table (with live source)
+ */
 interface PivotTableModel {
     rows: number[];
     columns: number[];
     values: number[];
-    metric: string;
+    metric: "sum" | "count";
     cacheFields: any[];
     cacheId: number;
+    applyWidthHeightFormats: "0" | "1";
+}
+/**
+ * Parsed pivot field
+ */
+interface ParsedPivotField {
+    axis?: "axisRow" | "axisCol" | "axisPage" | "axisValues";
+    dataField?: boolean;
+    items?: number[];
+    compact?: boolean;
+    outline?: boolean;
+    showAll?: boolean;
+    defaultSubtotal?: boolean;
+}
+/**
+ * Parsed data field
+ */
+interface ParsedDataField {
+    name: string;
+    fld: number;
+    baseField?: number;
+    baseItem?: number;
+    subtotal?: "sum" | "count" | "average" | "max" | "min" | "product" | "countNums" | "stdDev" | "stdDevP" | "var" | "varP";
+}
+/**
+ * Parsed pivot table model (loaded from file)
+ */
+interface ParsedPivotTableModel {
+    name?: string;
+    cacheId: number;
+    uid?: string;
+    location?: {
+        ref: string;
+        firstHeaderRow?: number;
+        firstDataRow?: number;
+        firstDataCol?: number;
+    };
+    pivotFields: ParsedPivotField[];
+    rowFields: number[];
+    colFields: number[];
+    dataFields: ParsedDataField[];
+    applyNumberFormats?: string;
+    applyBorderFormats?: string;
+    applyFontFormats?: string;
+    applyPatternFormats?: string;
+    applyAlignmentFormats?: string;
+    applyWidthHeightFormats?: string;
+    dataCaption?: string;
+    styleName?: string;
+    updatedVersion?: string;
+    minRefreshableVersion?: string;
+    createdVersion?: string;
+    useAutoFormatting?: boolean;
+    itemPrintTitles?: boolean;
+    indent?: number;
+    compact?: boolean;
+    compactData?: boolean;
+    multipleFieldFilters?: boolean;
+    rowItems?: any[];
+    colItems?: any[];
+    isLoaded?: boolean;
+    extensions?: any[];
 }
 declare class PivotTableXform extends BaseXform {
     map: {
         [key: string]: any;
     };
+    model: ParsedPivotTableModel | null;
+    private inPivotFields;
+    private inRowFields;
+    private inColFields;
+    private inDataFields;
+    private inRowItems;
+    private inColItems;
+    private inLocation;
+    private currentPivotField;
+    private inItems;
+    private inPivotTableStyleInfo;
     constructor();
     prepare(_model: any): void;
     get tag(): string;
-    render(xmlStream: any, model: PivotTableModel): void;
-    parseOpen(_node: any): boolean;
+    reset(): void;
+    /**
+     * Render pivot table XML.
+     * Supports both newly created models and loaded models.
+     */
+    render(xmlStream: any, model: PivotTableModel | ParsedPivotTableModel): void;
+    /**
+     * Render newly created pivot table
+     */
+    private renderNew;
+    /**
+     * Render loaded pivot table (preserving original structure)
+     */
+    private renderLoaded;
+    /**
+     * Render a loaded pivot field
+     */
+    private renderPivotFieldLoaded;
+    parseOpen(node: any): boolean;
     parseText(_text: string): void;
-    parseClose(_name: string): boolean;
+    parseClose(name: string): boolean;
     reconcile(_model: any, _options: any): void;
     static PIVOT_TABLE_ATTRIBUTES: {
         xmlns: string;
@@ -26,4 +119,4 @@ declare class PivotTableXform extends BaseXform {
         "xmlns:xr": string;
     };
 }
-export { PivotTableXform };
+export { PivotTableXform, type ParsedPivotTableModel };

package/dist/types/xlsx/xlsx.d.ts

@@ -6,6 +6,28 @@ declare class XLSX {
     parseWorkbook(stream: any): Promise<any>;
     parseSharedStrings(stream: any): Promise<any>;
     reconcile(model: any, options?: any): void;
+    /**
+     * Reconcile pivot tables by linking them to worksheets and their cache data.
+     * This builds a complete pivot table model ready for writing.
+     */
+    private _reconcilePivotTables;
+    /**
+     * Extract table number from pivot table name (e.g., "pivotTable1" -> 1)
+     */
+    private _extractTableNumber;
+    /**
+     * Build a mapping from rId to cacheId using pivotCaches from workbook.xml
+     * and workbookRels to determine which definition file corresponds to which cacheId
+     */
+    private _buildCacheIdMap;
+    /**
+     * Build a mapping from definition name to cacheId
+     */
+    private _buildDefinitionToCacheIdMap;
+    /**
+     * Determine the aggregation metric from dataFields
+     */
+    private _determineMetric;
     _processWorksheetEntry(stream: any, model: any, sheetNo: number, options: any, path: string): Promise<void>;
     _processCommentEntry(stream: any, model: any, name: string): Promise<void>;
     _processTableEntry(stream: any, model: any, name: string): Promise<void>;
@@ -15,6 +37,11 @@ declare class XLSX {
     _processDrawingRelsEntry(entry: any, model: any, name: string): Promise<void>;
     _processVmlDrawingEntry(entry: any, model: any, name: string): Promise<void>;
     _processThemeEntry(stream: any, model: any, name: string): Promise<void>;
+    _processPivotTableEntry(stream: any, model: any, name: string): Promise<void>;
+    _processPivotTableRelsEntry(stream: any, model: any, name: string): Promise<void>;
+    _processPivotCacheDefinitionEntry(stream: any, model: any, name: string): Promise<void>;
+    _processPivotCacheDefinitionRelsEntry(stream: any, model: any, name: string): Promise<void>;
+    _processPivotCacheRecordsEntry(stream: any, model: any, name: string): Promise<void>;
     read(stream: any, options?: any): Promise<any>;
     load(data: any, options?: any): Promise<any>;
     loadFromFiles(zipData: Record<string, Uint8Array>, options?: any): Promise<any>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cj-tech-master/excelts",
-  "version": "1.5.0",
+  "version": "1.6.1",
   "description": "TypeScript Excel Workbook Manager - Read and Write xlsx and csv Files.",
   "private": false,
   "publishConfig": {
@@ -105,39 +105,39 @@
     "uuid": "^13.0.0"
   },
   "devDependencies": {
-    "@eslint/js": "^9.39.1",
+    "@eslint/js": "^9.39.2",
     "@oxc-node/core": "^0.0.35",
-    "@types/node": "^25.0.0",
-    "@typescript-eslint/eslint-plugin": "^8.49.0",
-    "@typescript-eslint/parser": "^8.49.0",
-    "@typescript/native-preview": "^7.0.0-dev.20251208.1",
-    "@vitest/browser": "^4.0.15",
-    "@vitest/browser-playwright": "^4.0.15",
-    "@vitest/ui": "^4.0.15",
+    "@types/node": "^25.0.3",
+    "@typescript-eslint/eslint-plugin": "^8.50.0",
+    "@typescript-eslint/parser": "^8.50.0",
+    "@typescript/native-preview": "^7.0.0-dev.20251217.1",
+    "@vitest/browser": "^4.0.16",
+    "@vitest/browser-playwright": "^4.0.16",
+    "@vitest/ui": "^4.0.16",
     "concurrently": "^9.2.1",
     "cross-env": "^10.1.0",
-    "eslint": "^9.39.1",
+    "eslint": "^9.39.2",
     "eslint-config-prettier": "^10.1.8",
     "eslint-import-resolver-typescript": "^4.4.4",
     "eslint-plugin-import-x": "^4.16.1",
-    "eslint-plugin-oxlint": "^1.32.0",
+    "eslint-plugin-oxlint": "^1.33.0",
     "eslint-plugin-unused-imports": "^4.3.0",
     "express": "^5.2.1",
-    "fast-xml-parser": "^5.3.2",
+    "fast-xml-parser": "^5.3.3",
     "husky": "^9.1.7",
     "node-stdlib-browser": "^1.3.1",
     "nodemon": "^3.1.11",
-    "oxlint": "^1.32.0",
+    "oxlint": "^1.33.0",
     "playwright": "^1.57.0",
     "prettier": "^3.7.4",
     "rimraf": "^6.1.2",
-    "rolldown": "^1.0.0-beta.54",
+    "rolldown": "^1.0.0-beta.55",
     "rollup-plugin-visualizer": "^6.0.5",
     "tslib": "^2.8.1",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.49.0",
-    "vite-tsconfig-paths": "^5.1.4",
-    "vitest": "^4.0.15"
+    "typescript-eslint": "^8.50.0",
+    "vite-tsconfig-paths": "^6.0.2",
+    "vitest": "^4.0.16"
   },
   "scripts": {
     "local": "nodemon src/local.ts",