@cj-tech-master/excelts 5.0.6 → 5.1.0

package/dist/browser/index.browser.d.ts

@@ -15,7 +15,7 @@ export { DataValidations } from "@excel/data-validations";
 export { FormCheckbox } from "@excel/form-control";
 export * from "@excel/enums";
 export * from "@excel/types";
-export type { PivotTable, PivotTableModel, PivotTableSource, CacheField, DataField, PivotTableSubtotal, ParsedCacheDefinition, ParsedCacheRecords } from "@excel/pivot-table";
+export type { PivotTable, PivotTableModel, PivotTableValue, PivotTableSource, CacheField, SharedItemValue, DataField, PivotTableSubtotal, RecordValue, ParsedCacheDefinition, ParsedCacheRecords } from "@excel/pivot-table";
 export type { FormCheckboxModel, FormCheckboxOptions, FormControlRange, FormControlAnchor } from "@excel/form-control";
 import { WorkbookWriter } from "@excel/stream/workbook-writer.browser";
 import { WorkbookReader } from "@excel/stream/workbook-reader.browser";

package/dist/browser/index.d.ts

@@ -15,7 +15,7 @@ export { WorksheetWriter } from "@excel/stream/worksheet-writer";
 export { WorksheetReader } from "@excel/stream/worksheet-reader";
 export * from "@excel/enums";
 export * from "@excel/types";
-export type { PivotTable, PivotTableModel, PivotTableSource, CacheField, DataField, PivotTableSubtotal, ParsedCacheDefinition, ParsedCacheRecords } from "@excel/pivot-table";
+export type { PivotTable, PivotTableModel, PivotTableValue, PivotTableSource, CacheField, SharedItemValue, DataField, PivotTableSubtotal, RecordValue, ParsedCacheDefinition, ParsedCacheRecords } from "@excel/pivot-table";
 export type { FormCheckboxModel, FormCheckboxOptions, FormControlRange, FormControlAnchor } from "@excel/form-control";
 export type { WorkbookReaderOptions, ParseEvent, SharedStringEvent, WorksheetReadyEvent, HyperlinksEvent } from "@excel/stream/workbook-reader";
 export type { WorksheetReaderOptions, WorksheetEvent, RowEvent, HyperlinkEvent, WorksheetHyperlink } from "@excel/stream/worksheet-reader";

package/dist/browser/modules/archive/unzip/stream.base.js

@@ -66,7 +66,7 @@ export function decodeZipEntryPath(pathBuffer) {
     return textDecoder.decode(pathBuffer);
 }
 export function isZipUnicodeFlag(flags) {
-    return ((flags || 0) & 0x800) !== 0;
+    return ((flags ?? 0) & 0x800) !== 0;
 }
 export function isZipDirectoryPath(path) {
     if (path.length === 0) {
@@ -88,8 +88,8 @@ export function buildZipEntryProps(path, pathBuffer, flags) {
     };
 }
 export function resolveZipEntryLastModifiedDateTime(vars, extraFields) {
-    const dosDate = vars.lastModifiedDate || 0;
-    const dosTime = vars.lastModifiedTime || 0;
+    const dosDate = vars.lastModifiedDate ?? 0;
+    const dosTime = vars.lastModifiedTime ?? 0;
     const dosDateTime = parseDosDateTimeUTC(dosDate, dosTime);
     const unixSecondsMtime = extraFields.mtimeUnixSeconds;
     if (unixSecondsMtime === undefined) {
@@ -99,10 +99,10 @@ export function resolveZipEntryLastModifiedDateTime(vars, extraFields) {
 }
 export const parseExtraField = parseZipExtraFields;
 export function hasDataDescriptorFlag(flags) {
-    return ((flags || 0) & 0x08) !== 0;
+    return ((flags ?? 0) & 0x08) !== 0;
 }
 export function isFileSizeKnown(flags, compressedSize) {
-    return !hasDataDescriptorFlag(flags) || (compressedSize || 0) > 0;
+    return !hasDataDescriptorFlag(flags) || (compressedSize ?? 0) > 0;
 }
 export function autodrain(stream) {
     const draining = stream.pipe(new Transform({
@@ -399,8 +399,8 @@ export class PullStream extends Duplex {
 export async function readCrxHeader(pull) {
     const data = await pull(12);
     const header = data.length >= 12 ? parseCrxHeaderFast(data) : parseBuffer(data, CRX_HEADER_FORMAT);
-    const pubKeyLength = header.pubKeyLength || 0;
-    const signatureLength = header.signatureLength || 0;
+    const pubKeyLength = header.pubKeyLength ?? 0;
+    const signatureLength = header.signatureLength ?? 0;
     const keyAndSig = await pull(pubKeyLength + signatureLength);
     header.publicKey = keyAndSig.subarray(0, pubKeyLength);
     header.signature = keyAndSig.subarray(pubKeyLength);
@@ -411,8 +411,8 @@ export async function readLocalFileHeader(pull) {
     const vars = data.length >= 26
         ? parseLocalFileHeaderVarsFast(data)
         : parseBuffer(data, LOCAL_FILE_HEADER_FORMAT);
-    const fileNameBuffer = await pull(vars.fileNameLength || 0);
-    const extraFieldData = await pull(vars.extraFieldLength || 0);
+    const fileNameBuffer = await pull(vars.fileNameLength ?? 0);
+    const extraFieldData = await pull(vars.extraFieldLength ?? 0);
     return { vars, fileNameBuffer, extraFieldData };
 }
 export async function readDataDescriptor(pull) {
@@ -424,14 +424,14 @@ export async function readDataDescriptor(pull) {
 export async function consumeCentralDirectoryFileHeader(pull) {
     const data = await pull(42);
     const vars = parseBuffer(data, CENTRAL_DIRECTORY_FILE_HEADER_FORMAT);
-    await pull(vars.fileNameLength || 0);
-    await pull(vars.extraFieldLength || 0);
-    await pull(vars.fileCommentLength || 0);
+    await pull(vars.fileNameLength ?? 0);
+    await pull(vars.extraFieldLength ?? 0);
+    await pull(vars.fileCommentLength ?? 0);
 }
 export async function consumeEndOfCentralDirectoryRecord(pull) {
     const data = await pull(18);
     const vars = parseBuffer(data, END_OF_CENTRAL_DIRECTORY_FORMAT);
-    await pull(vars.commentLength || 0);
+    await pull(vars.commentLength ?? 0);
 }
 // =============================================================================
 // Validated Data Descriptor Scan (shared by Node + Browser)
@@ -943,7 +943,7 @@ async function readFileRecord(opts, io, emitter, inflateFactory, state, threshol
     };
     entry.path = fileName;
     entry.props = buildZipEntryProps(fileName, fileNameBuffer, vars.flags);
-    entry.type = getZipEntryType(fileName, vars.uncompressedSize || 0);
+    entry.type = getZipEntryType(fileName, vars.uncompressedSize ?? 0);
     if (opts.verbose) {
         if (entry.type === "Directory") {
             console.log("   creating:", fileName);
@@ -964,7 +964,7 @@ async function readFileRecord(opts, io, emitter, inflateFactory, state, threshol
     entry.__autodraining = autodraining;
     const fileSizeKnown = isFileSizeKnown(vars.flags, vars.compressedSize);
     if (fileSizeKnown) {
-        entry.size = vars.uncompressedSize || 0;
+        entry.size = vars.uncompressedSize ?? 0;
     }
     if (opts.forceStream) {
         emitter.pushEntry(entry);
@@ -991,8 +991,8 @@ async function readFileRecord(opts, io, emitter, inflateFactory, state, threshol
     // This prevents materializing large highly-compressible files in memory,
     // which can cause massive peak RSS and negate streaming backpressure.
     const sizesTrusted = !hasDataDescriptorFlag(vars.flags);
-    const compressedSize = vars.compressedSize || 0;
-    const uncompressedSize = vars.uncompressedSize || 0;
+    const compressedSize = vars.compressedSize ?? 0;
+    const uncompressedSize = vars.uncompressedSize ?? 0;
     const useSmallFileOptimization = sizesTrusted &&
         fileSizeKnown &&
         inflateRawSync &&
@@ -1013,10 +1013,10 @@ async function readFileRecord(opts, io, emitter, inflateFactory, state, threshol
         ? inflateFactory()
         : new PassThrough({ highWaterMark: DEFAULT_UNZIP_STREAM_HIGH_WATER_MARK });
     if (fileSizeKnown) {
-        await pumpKnownCompressedSizeToEntry(io, inflater, entry, vars.compressedSize || 0);
+        await pumpKnownCompressedSizeToEntry(io, inflater, entry, vars.compressedSize ?? 0);
         return;
     }
     await pipeline(io.streamUntilDataDescriptor(), inflater, entry);
     const dd = await readDataDescriptor(async (l) => io.pull(l));
-    entry.size = dd.uncompressedSize || 0;
+    entry.size = dd.uncompressedSize ?? 0;
 }

package/dist/browser/modules/archive/unzip/stream.browser.js

@@ -171,9 +171,9 @@ class BrowserInflateRaw extends Duplex {
     }
     destroy(error) {
         if (!this.writeClosed) {
-            this.writer.abort(error || undefined).catch(() => { });
+            this.writer.abort(error ?? undefined).catch(() => { });
         }
-        this.reader.cancel(error || undefined).catch(() => { });
+        this.reader.cancel(error ?? undefined).catch(() => { });
         return super.destroy(error);
     }
 }
@@ -338,7 +338,7 @@ class WorkerInflateRaw extends Duplex {
             }
         };
         this.worker.onerror = (e) => {
-            const err = new Error(e.message || "Worker error");
+            const err = new Error(e.message ?? "Worker error");
             for (const cb of this._pendingAcks.values()) {
                 cb(err);
             }

package/dist/browser/modules/csv/csv-core.js

@@ -298,7 +298,10 @@ export function parseCsv(input, options = {}) {
                         validatedRows.push(row);
                     }
                     else {
-                        invalidRows.push({ row: Object.values(row), reason: "Validation failed" });
+                        invalidRows.push({
+                            row: Object.values(row),
+                            reason: "Validation failed"
+                        });
                     }
                 }
                 else {
@@ -308,7 +311,7 @@ export function parseCsv(input, options = {}) {
                     else {
                         invalidRows.push({
                             row: Object.values(row),
-                            reason: result.reason || "Validation failed"
+                            reason: result.reason ?? "Validation failed"
                         });
                     }
                 }
@@ -352,7 +355,7 @@ export function parseCsv(input, options = {}) {
                     validatedRows.push(row);
                 }
                 else {
-                    arrayInvalidRows.push({ row, reason: result.reason || "Validation failed" });
+                    arrayInvalidRows.push({ row, reason: result.reason ?? "Validation failed" });
                 }
             }
         }

package/dist/browser/modules/csv/csv.browser.js

@@ -69,10 +69,10 @@ export function createDefaultWriteMapper(dateFormat, dateUTC) {
     return function mapValue(value) {
         if (value) {
             if (value.text || value.hyperlink) {
-                return value.hyperlink || value.text || "";
+                return value.hyperlink ?? value.text ?? "";
             }
             if (value.formula || value.result) {
-                return value.result || "";
+                return value.result ?? "";
             }
             if (value instanceof Date) {
                 return formatter.format(value);

package/dist/browser/modules/csv/csv.js

@@ -19,7 +19,7 @@ class CSV extends CSVBrowser {
     }
     async writeFile(filename, options) {
         const writeStream = fs.createWriteStream(filename, {
-            encoding: (options?.encoding || "utf8"),
+            encoding: (options?.encoding ?? "utf8"),
             highWaterMark: options?.highWaterMark ?? 64 * 1024
         });
         return this.write(writeStream, options);

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

@@ -26,10 +26,10 @@ class Anchor {
             this.nativeRowOff = 0;
         }
         else if (isAnchorModel(address)) {
-            this.nativeCol = address.nativeCol || 0;
-            this.nativeColOff = address.nativeColOff || 0;
-            this.nativeRow = address.nativeRow || 0;
-            this.nativeRowOff = address.nativeRowOff || 0;
+            this.nativeCol = address.nativeCol ?? 0;
+            this.nativeColOff = address.nativeColOff ?? 0;
+            this.nativeRow = address.nativeRow ?? 0;
+            this.nativeRowOff = address.nativeRowOff ?? 0;
         }
         else if (isSimpleAddress(address)) {
             this.col = address.col + offset;

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

@@ -500,8 +500,8 @@ class HyperlinkValue {
     }
     get value() {
         return {
-            text: this.model.text || "",
-            hyperlink: this.model.hyperlink || "",
+            text: this.model.text ?? "",
+            hyperlink: this.model.hyperlink ?? "",
             tooltip: this.model.tooltip
         };
     }
@@ -537,11 +537,11 @@ class HyperlinkValue {
         this.model.address = value;
     }
     toCsvString() {
-        return this.model.hyperlink || "";
+        return this.model.hyperlink ?? "";
     }
     release() { }
     toString() {
-        return this.model.text || "";
+        return this.model.text ?? "";
     }
 }
 class MergeValue {
@@ -734,7 +734,7 @@ class FormulaValue {
         return this._translatedFormula;
     }
     toCsvString() {
-        return `${this.model.result || ""}`;
+        return `${this.model.result ?? ""}`;
     }
     release() { }
     toString() {

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

@@ -126,7 +126,7 @@ class Column {
      * Set an outline level for columns
      */
     get outlineLevel() {
-        return this._outlineLevel || 0;
+        return this._outlineLevel ?? 0;
     }
     set outlineLevel(value) {
         this._outlineLevel = value;
@@ -230,8 +230,8 @@ class Column {
      */
     addPageBreak(top, bottom) {
         const ws = this._worksheet;
-        const topRow = Math.max(0, (top || 0) - 1) || 0;
-        const bottomRow = Math.max(0, (bottom || 0) - 1) || 1048575;
+        const topRow = Math.max(0, (top ?? 0) - 1) || 0;
+        const bottomRow = Math.max(0, (bottom ?? 0) - 1) || 1048575;
         const pb = {
             id: this._number,
             max: bottomRow,
@@ -340,7 +340,7 @@ class Column {
             ? worksheetOrCols
             : worksheetOrCols;
         let cols = Array.isArray(worksheetOrCols) ? worksheetOrCols : (colsMaybe ?? []);
-        cols = cols || [];
+        cols = cols ?? [];
         const columns = [];
         let count = 1;
         let index = 0;

package/dist/browser/modules/excel/defined-names.js

@@ -204,7 +204,7 @@ class DefinedNames {
         value.forEach(definedName => {
             const matrix = (matrixMap[definedName.name] = new CellMatrix());
             definedName.ranges.forEach(rangeStr => {
-                if (rangeRegexp.test(rangeStr.split("!").pop() || "")) {
+                if (rangeRegexp.test(rangeStr.split("!").pop() ?? "")) {
                     matrix.addCell(rangeStr);
                 }
             });

package/dist/browser/modules/excel/form-control.js

@@ -30,7 +30,7 @@ class FormCheckbox {
         // Parse range to get anchors
         const { tl, br } = this._parseRange(range);
         // Generate shape ID (starting from 1025)
-        const existingCount = worksheet.formControls?.length || 0;
+        const existingCount = worksheet.formControls?.length ?? 0;
         const shapeId = 1025 + existingCount;
         // Parse link cell reference
         let link;

package/dist/browser/modules/excel/pivot-table.d.ts

@@ -6,21 +6,50 @@ import type { Table } from "@excel/table";
 export interface PivotTableSource {
     /** Name of the worksheet containing the source data (used in pivotCacheDefinition) */
     name: string;
+    /**
+     * Name of the source Table (e.g., "SalesData").
+     * When present, pivotCacheDefinition uses `<worksheetSource name="..."/>` instead of ref+sheet.
+     */
+    tableName?: string;
     /** Get row values by 1-indexed row number */
     getRow(rowNumber: number): {
-        values: any[];
+        values: unknown[];
     };
     /** Get column values by 1-indexed column number */
     getColumn(columnNumber: number): {
-        values: any[];
+        values: unknown[];
     };
     /** Get all sheet values as a sparse 2D array */
-    getSheetValues(): any[][];
+    getSheetValues(): unknown[][];
     /** Dimensions with short range reference (e.g., "A1:E10") */
     dimensions: {
         shortRange: string;
     };
 }
+/**
+ * A value field specification with optional per-field metric override.
+ * Use this instead of a plain string when you need different aggregation
+ * metrics for individual value fields.
+ *
+ * @example
+ * ```ts
+ * values: [
+ *   { name: "Sales", metric: "sum" },
+ *   { name: "Quantity", metric: "count" },
+ *   { name: "Price", metric: "average" },
+ * ]
+ * ```
+ */
+export interface PivotTableValue {
+    /** Column name to aggregate */
+    name: string;
+    /**
+     * Aggregation metric for this specific value field.
+     * Overrides the table-wide `metric` when specified.
+     * @default inherited from PivotTableModel.metric (which defaults to 'sum')
+     */
+    metric?: PivotTableSubtotal;
+}
 /**
  * Model for creating a new pivot table.
  * Pass this to worksheet.addPivotTable() to create a pivot table.
@@ -42,18 +71,45 @@ export interface PivotTableModel {
     /**
      * Column names to use as column fields in the pivot table.
      * If omitted or empty, Excel will use "Values" as the column field.
+     * When multiple values are specified alongside columns, the synthetic
+     * "∑Values" pseudo-field is appended to the column axis automatically.
      * @default []
      */
     columns?: string[];
-    /** Column names to aggregate as values in the pivot table */
-    values: string[];
     /**
-     * Aggregation metric for the pivot table values.
-     * - 'sum': Sum of values (default)
-     * - 'count': Count of values
+     * Column names (or value field specifications) to aggregate in the pivot table.
+     * Each entry can be a plain string (column name) or a {@link PivotTableValue}
+     * object with a per-field metric override.
+     *
+     * @example
+     * ```ts
+     * // Simple: all values use the table-wide metric
+     * values: ["Sales", "Quantity"]
+     *
+     * // Per-value metrics
+     * values: [
+     *   { name: "Sales", metric: "sum" },
+     *   { name: "Quantity", metric: "count" },
+     *   { name: "Price", metric: "average" },
+     * ]
+     *
+     * // Mixed: plain strings inherit table-wide metric
+     * values: ["Sales", { name: "Quantity", metric: "count" }]
+     * ```
+     */
+    values: (string | PivotTableValue)[];
+    /**
+     * Column names to use as page fields (report filters) in the pivot table.
+     * Page fields appear as dropdown filters above the pivot table.
+     * @default []
+     */
+    pages?: string[];
+    /**
+     * Default aggregation metric for all value fields.
+     * Individual value fields can override this via {@link PivotTableValue.metric}.
      * @default 'sum'
      */
-    metric?: "sum" | "count";
+    metric?: PivotTableSubtotal;
     /**
      * Controls whether pivot table style overrides worksheet column widths.
      * - '0': Preserve worksheet column widths (useful for custom sizing)
@@ -62,6 +118,19 @@ export interface PivotTableModel {
      */
     applyWidthHeightFormats?: "0" | "1";
 }
+/** Allowed element types within CacheField.sharedItems */
+export type SharedItemValue = string | number | boolean | Date | PivotErrorValue | null;
+/**
+ * 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>`.
+ */
+export declare class PivotErrorValue {
+    /** The error code without the leading '#' (e.g. "REF!", "VALUE!", "N/A") */
+    readonly code: string;
+    constructor(code: string);
+    /** Returns the display form with '#' prefix, e.g. "#REF!" */
+    toString(): string;
+}
 /**
  * Represents a cache field in a pivot table.
  * Cache fields store unique values from source columns for row/column grouping.
@@ -70,14 +139,42 @@ export interface CacheField {
     /** Name of the field (column header from source) */
     name: string;
     /** Unique values for row/column fields, null for value fields */
-    sharedItems: any[] | null;
+    sharedItems: SharedItemValue[] | null;
+    /** Whether the field contains numeric values (raw attribute string for roundtrip: "0" or "1") */
+    containsNumber?: string;
+    /** Whether the field contains only integer values (raw attribute string for roundtrip: "0" or "1") */
+    containsInteger?: string;
     /** Minimum value for numeric fields */
     minValue?: number;
     /** Maximum value for numeric fields */
     maxValue?: number;
+    /** Number format ID (preserved on roundtrip, defaults to "0") */
+    numFmtId?: string;
+    /** Original containsSemiMixedTypes attribute from loaded file */
+    containsSemiMixedTypes?: string;
+    /** Original containsNonDate attribute from loaded file */
+    containsNonDate?: string;
+    /** Original containsString attribute from loaded file */
+    containsString?: string;
+    /** Original containsBlank attribute from loaded file */
+    containsBlank?: string;
+    /** Original containsDate attribute from loaded file */
+    containsDate?: string;
+    /** Original containsMixedTypes attribute from loaded file */
+    containsMixedTypes?: string;
+    /** Flag indicating this cache field was loaded from file */
+    isLoaded?: boolean;
+    /** Preserved <fieldGroup> raw XML for roundtrip (loaded models only) */
+    fieldGroupXml?: string;
+    /** Bag of additional cacheField attributes not individually modeled (for roundtrip preservation) */
+    extraAttrs?: Record<string, string>;
 }
 /** Aggregation function types for pivot table data fields */
 export type PivotTableSubtotal = "sum" | "count" | "average" | "max" | "min" | "product" | "countNums" | "stdDev" | "stdDevP" | "var" | "varP";
+/** Map from PivotTableSubtotal to its Excel display name prefix */
+export declare const METRIC_DISPLAY_NAMES: Readonly<Record<PivotTableSubtotal, string>>;
+/** Set of all valid PivotTableSubtotal values (for runtime validation) */
+export declare const VALID_SUBTOTALS: ReadonlySet<string>;
 /**
  * Data field configuration for pivot table aggregation.
  * Defines how values are aggregated in the pivot table.
@@ -93,6 +190,8 @@ export interface DataField {
     baseItem?: number;
     /** Aggregation function (default: 'sum') */
     subtotal?: PivotTableSubtotal;
+    /** Number format ID (preserved on roundtrip for currency/date formatting) */
+    numFmtId?: number;
 }
 /**
  * Internal pivot table representation used by the library.
@@ -107,8 +206,12 @@ export interface PivotTable {
     columns: number[];
     /** Field indices for value fields */
     values: number[];
-    /** Aggregation metric */
-    metric: "sum" | "count";
+    /** Field indices for page fields (report filters) */
+    pages?: number[];
+    /** Default aggregation metric */
+    metric: PivotTableSubtotal;
+    /** Per-value metric overrides (parallel to `values` array). Falls back to `metric`. */
+    valueMetrics: PivotTableSubtotal[];
     /** Cache fields with shared items */
     cacheFields: CacheField[];
     /** Cache ID for linking to pivot cache */
@@ -117,6 +220,8 @@ export interface PivotTable {
     applyWidthHeightFormats: "0" | "1";
     /** 1-indexed table number for file naming (pivotTable1.xml, pivotTable2.xml, etc.) */
     tableNumber: number;
+    /** Workbook relationship ID, assigned during write by addWorkbookRels() */
+    rId?: string;
     /** Flag indicating this pivot table was loaded from file (not newly created) */
     isLoaded?: boolean;
     /** Data fields for loaded pivot tables */
@@ -132,21 +237,67 @@ export interface PivotTable {
 export interface ParsedCacheDefinition {
     sourceRef?: string;
     sourceSheet?: string;
+    /** Source table name (name style - references a named Table) */
+    sourceTableName?: string;
+    /** Cache source type (default "worksheet") */
+    cacheSourceType?: string;
     cacheFields: CacheField[];
     recordCount?: number;
     rId?: string;
+    /** Additional attributes to preserve */
+    refreshOnLoad?: string;
+    createdVersion?: string;
+    refreshedVersion?: string;
+    minRefreshableVersion?: string;
     isLoaded?: boolean;
+    backgroundQuery?: string;
+    supportSubquery?: string;
+    supportAdvancedDrill?: string;
+    /** Bag of additional root attributes not individually modeled (for roundtrip) */
+    extraRootAttrs?: Record<string, string>;
+    /** worksheetSource r:id attribute (for external connections) */
+    worksheetSourceRId?: string;
+    extLstXml?: string;
+    /** Preserved unknown child elements XML for roundtrip (e.g. calculatedItems, cacheHierarchies) */
+    unknownElementsXml?: string;
+    /** Preserved raw XML for non-worksheetSource children inside <cacheSource> (e.g. <consolidation>) */
+    cacheSourceXml?: string;
 }
+/** Allowed element types within cache record values */
+export type RecordValue = {
+    type: "x";
+    value: number;
+} | {
+    type: "n";
+    value: number;
+} | {
+    type: "s";
+    value: string;
+} | {
+    type: "b";
+    value: boolean;
+} | {
+    type: "m";
+} | {
+    type: "d";
+    value: Date;
+} | {
+    type: "e";
+    value: string;
+};
 /**
  * Parsed cache records from loaded pivot table files.
  */
 export interface ParsedCacheRecords {
-    records: Array<Array<{
-        type: string;
-        value?: any;
-    }>>;
+    records: RecordValue[][];
     count: number;
     isLoaded?: boolean;
+    /** Extra root attributes beyond xmlns/xmlns:r/count (for roundtrip preservation) */
+    extraRootAttrs?: Record<string, string>;
 }
-declare function makePivotTable(worksheet: any, model: PivotTableModel): PivotTable;
+declare function makePivotTable(worksheet: {
+    workbook: {
+        pivotTables: PivotTable[];
+    };
+}, model: PivotTableModel): PivotTable;
 export { makePivotTable };