@rowsncolumns/toolkit 24.4.4 → 24.5.0

package/dist/esm/excel-parser/plugins/xlsx/index.js

@@ -2,19 +2,19 @@ import { addressToCell, addressToSelection, alpha2number, checkIfStringIsReferen
 import { XMLParser } from "fast-xml-parser";
 import { get } from "lodash-es";
 import { Parser as HtmlParser } from "htmlparser2";
-import { createFilterSpecsFromAutoFilter, excelColumnWidthToPixels, findMax, getRangeFromAddressRef, parseTableColumnTotals, } from "../../helpers";
+import { createFilterSpecsFromAutoFilter, excelColumnWidthToPixels, findMax, createSortSpecsFromSortState, getRangeFromAddressRef, hiddenFilterButtonColumns, parseTableColumnTotals, } from "../../helpers";
 import { defaultSpreadsheetTheme } from "../../theme-default";
 import { Unescape } from "../../utils";
 import { compactPrintSettings, isBuiltinPrintName, isDefaultPageMargins, parsePrintAreaFormula, parsePrintTitlesFormula, PRINT_AREA_NAME, } from "../../../print-settings";
 import { StreamingZipParser } from "../../zip-parser-streaming";
 import { SheetDataValidationStamper } from "../../dv-cell-stamp";
 import { BaseWorkbookPlugin } from "../base/index";
-import { processChart } from "./charts";
-import { customFiltersToCondition, dynamicFilterToCondition, } from "../../../autofilter-condition";
+import { bindPivotChartsToPivotTables, PIVOT_SOURCE_NAME_KEY, processChart, } from "./charts";
+import { customFiltersToCriteria, dynamicFilterToCondition, top10FilterToCondition, } from "../../../autofilter-condition";
 import { getConditionalFormattingFromSheet } from "./conditional-formatting";
 import { getDataValidationsForSheet as parseDataValidationsFromSheetData } from "./data-validations";
-import { anchorsInDocumentOrder, processAnchors, } from "./drawing";
-import { getRelationsById } from "./relationships";
+import { anchorPlacementFromEditAs, anchorsInDocumentOrder, processAnchors, } from "./drawing";
+import { getRelationsById, getSheetRelsPath } from "./relationships";
 import { hasPowerQueryParts, } from "../../../power-query";
 import { extractSheetViewProperties } from "./sheet-views";
 import { EMPTY_SHEET_THREADED_COMMENTS, parsePersons, parseThreadedComments, } from "./threaded-comments";
@@ -422,10 +422,17 @@ export class WorkbookStyles {
                     if (color)
                         bandedDef.rowProperties.headerColor = color;
                     break;
-                case "totalRow":
+                case "totalRow": {
                     if (color)
                         bandedDef.rowProperties.totalRowColor = color;
+                    // Excel's totals element bolds the row (`<font><b/></font>`), fill or not.
+                    const font = dxf?.font || dxf?.["x:font"];
+                    const b = font?.b ?? font?.["x:b"];
+                    if (b !== undefined && (b?.a$?.val ?? b?.val) !== "0") {
+                        bandedDef.rowProperties.totalRowBold = true;
+                    }
                     break;
+                }
                 case "firstRowStripe":
                     if (color)
                         bandedDef.rowProperties.firstBandColor = color;
@@ -442,6 +449,14 @@ export class WorkbookStyles {
                     if (color)
                         bandedDef.columnProperties.secondBandColor = color;
                     break;
+                case "firstColumn":
+                    if (color)
+                        bandedDef.rowProperties.firstColumnColor = color;
+                    break;
+                case "lastColumn":
+                    if (color)
+                        bandedDef.rowProperties.lastColumnColor = color;
+                    break;
             }
         }
         // Only return if we found any properties
@@ -717,6 +732,12 @@ export class XlsxPlugin extends BaseWorkbookPlugin {
      * relevant elements. Absent entry ⇒ unknown ⇒ extractors parse as before.
      */
     sheetFeatures = new Map();
+    /**
+     * Pivot tables are parsed once: `getCharts()` needs them to bind
+     * PivotCharts before `getPivotTables()` runs, and both must see the
+     * same generated `pivotId`s.
+     */
+    pivotTablesPromise;
     /**
      * Single-entry memo for `getSheetData`: consecutive extractor calls for
      * the same sheet reuse one parsed DOM instead of re-decompressing and
@@ -724,6 +745,11 @@ export class XlsxPlugin extends BaseWorkbookPlugin {
      * multi-sheet workbook never retains more than one worksheet DOM.
      */
     lastSheetDataCache = null;
+    /**
+     * Per-rid memo of a chartsheet's parsed chart, so `Sheet.chartId` (set by
+     * `getSheets()`) and `getCharts()` see the same generated chart id.
+     */
+    chartsheetChartsCache = new Map();
     /** workbook.xml sheet elements indexed by sheetId (sheet-scoped API). */
     worksheetBySheetId = new Map();
     /**
@@ -1120,6 +1146,15 @@ export class XlsxPlugin extends BaseWorkbookPlugin {
                         entry.dynamicFilterType = attrs.type;
                     }
                 }
+                // <top10 top="1" percent="0" val="10"/> (Excel's "Top 10…")
+                if (name === "top10" && currentFilterColumn !== null) {
+                    const entry = getOrCreateFilterColumn(currentFilterColumn);
+                    entry.top10 = {
+                        top: typeof attrs.top === "string" ? attrs.top : undefined,
+                        percent: typeof attrs.percent === "string" ? attrs.percent : undefined,
+                        val: typeof attrs.val === "string" ? attrs.val : undefined,
+                    };
+                }
                 if (name === "tablePart") {
                     const rid = attrs["r:id"];
                     if (typeof rid === "string") {
@@ -1182,15 +1217,20 @@ export class XlsxPlugin extends BaseWorkbookPlugin {
                 };
             }
             if (raw.customFilters?.length) {
-                const condition = customFiltersToCondition(raw.customFilters, raw.customFiltersAnd === true);
-                if (condition)
-                    criteria.condition = condition;
+                const conditions = customFiltersToCriteria(raw.customFilters, raw.customFiltersAnd === true);
+                if (conditions)
+                    Object.assign(criteria, conditions);
             }
             else if (raw.dynamicFilterType) {
                 const condition = dynamicFilterToCondition(raw.dynamicFilterType);
                 if (condition)
                     criteria.condition = condition;
             }
+            else if (raw.top10) {
+                const condition = top10FilterToCondition(raw.top10);
+                if (condition)
+                    criteria.condition = condition;
+            }
             return { columnIndex, filterCriteria: criteria };
         });
         const sheetViewData = sheetViewAttrs || paneAttrs
@@ -1286,7 +1326,7 @@ export class XlsxPlugin extends BaseWorkbookPlugin {
                 return { maxColumnIndex, maxRowIndex };
             }
             const sheetPath = this.resolveSheetPath(relation.target);
-            const sheetRelPath = sheetPath.replace("worksheets", "worksheets/_rels") + ".rels";
+            const sheetRelPath = getSheetRelsPath(sheetPath);
             const sheetRelContent = await this.zipParser.getText(sheetRelPath);
             if (!sheetRelContent) {
                 return { maxColumnIndex, maxRowIndex };
@@ -1415,7 +1455,7 @@ export class XlsxPlugin extends BaseWorkbookPlugin {
             controls: false,
         };
         const sheetPath = this.resolveSheetPath(relation.target);
-        const sheetRelPath = sheetPath.replace("worksheets", "worksheets/_rels") + ".rels";
+        const sheetRelPath = getSheetRelsPath(sheetPath);
         let sheetRelationships = {};
         try {
             const sheetRelContent = await this.zipParser.getText(sheetRelPath);
@@ -1937,6 +1977,7 @@ export class XlsxPlugin extends BaseWorkbookPlugin {
         this.personsPromise = null;
         this.sheetFeatures.clear();
         this.lastSheetDataCache = null;
+        this.chartsheetChartsCache.clear();
         this.sheetMetadataCache.clear();
         this.dataValidationsBySheetCache.clear();
         this.conditionalFormattingBySheetCache.clear();
@@ -1957,6 +1998,7 @@ export class XlsxPlugin extends BaseWorkbookPlugin {
         this.personsPromise = null;
         this.sheetFeatures.clear();
         this.lastSheetDataCache = null;
+        this.chartsheetChartsCache.clear();
         this.sheetMetadataCache.clear();
         this.dataValidationsBySheetCache.clear();
         this.conditionalFormattingBySheetCache.clear();
@@ -1994,7 +2036,7 @@ export class XlsxPlugin extends BaseWorkbookPlugin {
         const sheetPath = target.startsWith("/xl")
             ? target.replace(/^\//gi, "")
             : `xl/${this.relations[rId].target}`;
-        const sheetRelPath = sheetPath.replace("worksheets", "worksheets/_rels") + ".rels";
+        const sheetRelPath = getSheetRelsPath(sheetPath);
         try {
             const sheetRelContent = await this.zipParser.getText(sheetRelPath);
             const sheetRels = this.xmlParser.parse(sheetRelContent);
@@ -2035,10 +2077,17 @@ export class XlsxPlugin extends BaseWorkbookPlugin {
                     // Parse table settings
                     const headerRow = attrs.headerRowCount !== "0";
                     const totalRow = attrs.totalsRowCount === "1";
-                    const showFirstColumn = attrs.showFirstColumn === "1";
-                    const showLastColumn = attrs.showLastColumn === "1";
-                    const showRowStripes = attrs.showRowStripes !== "0";
-                    const showColumnStripes = attrs.showColumnStripes === "1";
+                    // Parse table style information
+                    // Handle both with and without namespace prefix
+                    const tableStyle = get(tableDefinition, "tableStyleInfo") ||
+                        get(tableDefinition, "x:tableStyleInfo") ||
+                        {};
+                    const tableStyleAttrs = tableStyle.a$ || {};
+                    // The banding toggles live on `<tableStyleInfo>`, not on `<table>`.
+                    const showFirstColumn = tableStyleAttrs.showFirstColumn === "1";
+                    const showLastColumn = tableStyleAttrs.showLastColumn === "1";
+                    const showRowStripes = tableStyleAttrs.showRowStripes !== "0";
+                    const showColumnStripes = tableStyleAttrs.showColumnStripes === "1";
                     // Parse table columns
                     // Handle both with and without namespace prefix
                     const columnDefinitions = get(tableDefinition, "tableColumns.tableColumn") ||
@@ -2066,19 +2115,20 @@ export class XlsxPlugin extends BaseWorkbookPlugin {
                         }
                         return columnObj;
                     });
-                    // Parse table style information
                     // Handle both with and without namespace prefix
-                    const tableStyle = get(tableDefinition, "tableStyleInfo") ||
-                        get(tableDefinition, "x:tableStyleInfo") ||
-                        {};
-                    const tableStyleAttrs = tableStyle.a$ || {};
-                    // Extract filter button settings
-                    const filterButton = attrs.filterButton !== "0";
+                    const autoFilter = tableDefinition.autoFilter ?? tableDefinition["x:autoFilter"];
+                    // Excel shows a table's filter buttons iff the part carries an
+                    // `<autoFilter>`; per-column buttons hide via
+                    // `<filterColumn hiddenButton="1">`.
+                    const filterButton = attrs.filterButton !== "0" && (!headerRow || autoFilter !== undefined);
+                    for (const colId of hiddenFilterButtonColumns(autoFilter)) {
+                        if (columns[colId])
+                            columns[colId].filterButton = false;
+                    }
                     const range = getRangeFromAddressRef(attrs.ref);
                     if (range) {
-                        // Handle both with and without namespace prefix
-                        const autoFilter = tableDefinition.autoFilter ?? tableDefinition["x:autoFilter"];
                         const filterSpecs = createFilterSpecsFromAutoFilter(autoFilter, (dxfId, cellColor) => this.resolveDxfColor(dxfId, cellColor));
+                        const sortSpecs = createSortSpecsFromSortState(tableDefinition.sortState ?? tableDefinition["x:sortState"], range, (dxfId, cellColor) => this.resolveDxfColor(dxfId, cellColor));
                         // Create the table view object
                         const tableView = {
                             id: attrs.id,
@@ -2094,6 +2144,7 @@ export class XlsxPlugin extends BaseWorkbookPlugin {
                             columns,
                             range,
                             filterSpecs,
+                            ...(sortSpecs.length ? { sortSpecs } : {}),
                         };
                         // Add table theme if available
                         if (tableStyleAttrs.name) {
@@ -2111,16 +2162,22 @@ export class XlsxPlugin extends BaseWorkbookPlugin {
                                 // Only include row/column properties based on stripe settings
                                 if (!showRowStripes && bandedRange.rowProperties) {
                                     // Keep header and total row styling even if stripes are off
-                                    const { headerColor, headerBorder, totalRowColor, totalRowBorder, } = bandedRange.rowProperties;
+                                    const { headerColor, headerBorder, totalRowColor, totalRowBorder, firstColumnColor, lastColumnColor, totalRowBold, } = bandedRange.rowProperties;
                                     if (headerColor ||
                                         headerBorder ||
                                         totalRowColor ||
-                                        totalRowBorder) {
+                                        totalRowBorder ||
+                                        firstColumnColor ||
+                                        lastColumnColor ||
+                                        totalRowBold) {
                                         bandedRange.rowProperties = {
                                             headerColor,
                                             headerBorder,
                                             totalRowColor,
                                             totalRowBorder,
+                                            firstColumnColor,
+                                            lastColumnColor,
+                                            totalRowBold,
                                         };
                                     }
                                     else {
@@ -2173,6 +2230,25 @@ export class XlsxPlugin extends BaseWorkbookPlugin {
         }
         return this.resolveSheetPath(relation.target);
     }
+    /**
+     * A chartsheet (`xl/chartsheets/sheetN.xml`) is listed in `<sheets>` like a
+     * worksheet; only its workbook relationship type tells it apart.
+     */
+    isChartsheet(rid) {
+        const relation = this.relations[rid];
+        if (!relation)
+            return false;
+        return ((relation.type ?? "").endsWith("/chartsheet") ||
+            this.resolveSheetPath(relation.target).includes("chartsheets/"));
+    }
+    getChartsheetCharts(rid, sheetId) {
+        let cached = this.chartsheetChartsCache.get(rid);
+        if (!cached) {
+            cached = this.getSheetData(rid).then((sheetData) => this._getCharts(rid, sheetId, sheetData));
+            this.chartsheetChartsCache.set(rid, cached);
+        }
+        return cached;
+    }
     async *streamSheetRows(rid) {
         const path = this.getSheetPathByRid(rid);
         let inSheetData = false;
@@ -2564,7 +2640,7 @@ export class XlsxPlugin extends BaseWorkbookPlugin {
             return comments;
         }
         const sheetPath = this.resolveSheetPath(relation.target);
-        const sheetRelPath = sheetPath.replace("worksheets", "worksheets/_rels") + ".rels";
+        const sheetRelPath = getSheetRelsPath(sheetPath);
         let sheetRelContent;
         try {
             sheetRelContent = await this.zipParser.getText(sheetRelPath);
@@ -2656,7 +2732,7 @@ export class XlsxPlugin extends BaseWorkbookPlugin {
             return result;
         }
         const sheetPath = this.resolveSheetPath(relation.target);
-        const sheetRelPath = sheetPath.replace("worksheets", "worksheets/_rels") + ".rels";
+        const sheetRelPath = getSheetRelsPath(sheetPath);
         try {
             const sheetRelContent = await this.zipParser.getText(sheetRelPath);
             const sheetRels = this.xmlParser.parse(sheetRelContent);
@@ -2853,14 +2929,16 @@ export class XlsxPlugin extends BaseWorkbookPlugin {
         // Handle both with and without namespace prefix
         const drawing = get(sheetData, "worksheet.drawing") ||
             get(sheetData, "drawing") ||
-            get(sheetData, "x:worksheet.x:drawing");
+            get(sheetData, "x:worksheet.x:drawing") ||
+            get(sheetData, "chartsheet.drawing") ||
+            get(sheetData, "x:chartsheet.x:drawing");
         if (!drawing) {
             return [];
         }
         const drawings = Array.isArray(drawing) ? drawing : [drawing];
         try {
             // Get the sheet's relationships to find drawing relationship
-            const sheetRelPath = path.replace("worksheets", "worksheets/_rels") + ".rels";
+            const sheetRelPath = getSheetRelsPath(path);
             const sheetRelContent = await this.zipParser.getText(sheetRelPath);
             const sheetRels = this.xmlParser.parse(sheetRelContent);
             const drawingRelations = get(sheetRels, "Relationships.Relationship");
@@ -2909,22 +2987,11 @@ export class XlsxPlugin extends BaseWorkbookPlugin {
                 const drawingRelsArray = Array.isArray(drawingRelsList)
                     ? drawingRelsList
                     : [drawingRelsList];
-                // Extract anchors
-                const oneCellAnchors = get(drawingXml, "xdr:wsDr.xdr:oneCellAnchor") ||
-                    get(drawingXml, "wsDr.oneCellAnchor") ||
-                    [];
-                const twoCellAnchors = get(drawingXml, "xdr:wsDr.xdr:twoCellAnchor") ||
-                    get(drawingXml, "wsDr.twoCellAnchor") ||
-                    [];
-                const anchors = [
-                    ...(Array.isArray(oneCellAnchors)
-                        ? oneCellAnchors
-                        : [oneCellAnchors]),
-                    ...(Array.isArray(twoCellAnchors)
-                        ? twoCellAnchors
-                        : [twoCellAnchors]),
-                ].filter(Boolean);
-                for (const anchor of anchors) {
+                // Anchors in document order — Excel's z-order, shared with the
+                // sheet's pictures / shapes (`_getDrawings` numbers the same
+                // anchors), kept on `position.zOrder`.
+                const orderedAnchors = anchorsInDocumentOrder(drawingXml, drawingContent);
+                for (const [zOrder, { node: anchor }] of orderedAnchors.entries()) {
                     const chartRef = getChartReferenceFromAnchor(anchor);
                     if (!chartRef) {
                         // Excel 2016+ chartex (treemap / sunburst / histogram …) anchors
@@ -2937,8 +3004,10 @@ export class XlsxPlugin extends BaseWorkbookPlugin {
                             : undefined;
                         if (chartExRel) {
                             const chartEx = await processChartEx(chartExRel.a$.Target, drawingPath, anchor, sheetId, this.zipParser, this.xmlParser, sheetDimensions, resolveSheetId);
-                            if (chartEx)
+                            if (chartEx) {
+                                chartEx.position = { ...chartEx.position, zOrder };
                                 charts.push(chartEx);
+                            }
                         }
                         continue;
                     }
@@ -2954,6 +3023,7 @@ export class XlsxPlugin extends BaseWorkbookPlugin {
                     if (chartRel) {
                         const chart = await processChart(chartRel.a$.Target, drawingPath, anchor, sheetId, this.zipParser, this.xmlParser, sheetDimensions, resolveSheetId);
                         if (chart) {
+                            chart.position = { ...chart.position, zOrder };
                             charts.push(chart);
                         }
                     }
@@ -2980,14 +3050,16 @@ export class XlsxPlugin extends BaseWorkbookPlugin {
         // Handle both with and without namespace prefix
         const drawing = get(sheetData, "worksheet.drawing") ||
             get(sheetData, "drawing") ||
-            get(sheetData, "x:worksheet.x:drawing");
+            get(sheetData, "x:worksheet.x:drawing") ||
+            get(sheetData, "chartsheet.drawing") ||
+            get(sheetData, "x:chartsheet.x:drawing");
         if (!drawing) {
             return [];
         }
         const drawings = Array.isArray(drawing) ? drawing : [drawing];
         // Get the sheet's relationships to find drawing relationship
         // Modified to handle both patterns of relationship files
-        const sheetRelPath = path.replace("worksheets", "worksheets/_rels") + ".rels";
+        const sheetRelPath = getSheetRelsPath(path);
         const sheetRelContent = await this.zipParser.getText(sheetRelPath);
         const sheetRels = this.xmlParser.parse(sheetRelContent);
         const drawingRelations = get(sheetRels, "Relationships.Relationship");
@@ -3027,8 +3099,10 @@ export class XlsxPlugin extends BaseWorkbookPlugin {
                 // The parse groups anchors by element name, so the document order
                 // across `oneCellAnchor` / `twoCellAnchor` / `absoluteAnchor` is
                 // recovered from the raw part and each anchor processed in that order.
-                for (const anchor of anchorsInDocumentOrder(drawing, drawingContent)) {
+                const orderedAnchors = anchorsInDocumentOrder(drawing, drawingContent);
+                for (const [zOrder, anchor] of orderedAnchors.entries()) {
                     for (const image of await processAnchors(anchor.node, anchor.kind, drawingPath, sheetId, this.zipParser, this.xmlParser)) {
+                        image.position = { ...image.position, zOrder };
                         images.push(image);
                     }
                 }
@@ -3059,6 +3133,22 @@ export class XlsxPlugin extends BaseWorkbookPlugin {
     getNamedCellStyles() {
         return resolveNamedCellStyles(this.workbookStyles);
     }
+    /**
+     * The workbook's custom `<tableStyle>`s with their per-element dxf fills resolved into banding —
+     * the `customTableStyles` document facet (table style gallery + re-export), #668 T-103.
+     */
+    getCustomTableStyles() {
+        const styles = this.workbookStyles?.tableStyles;
+        if (!styles)
+            return [];
+        const out = [];
+        for (const name of styles.keys()) {
+            const bandedRange = this.workbookStyles?.getCustomTableStyleBanding(name);
+            if (bandedRange)
+                out.push({ name, bandedRange });
+        }
+        return out;
+    }
     /**
      * The workbook default font — styles.xml fonts[0], the font every cell
      * without an explicit font inherits. Exporters pass this through so the
@@ -3294,12 +3384,14 @@ export class XlsxPlugin extends BaseWorkbookPlugin {
                 : state === "hidden"
                     ? "hidden"
                     : "visible";
+            const rid = element.a$["r:id"];
             catalog.push({
                 sheetId: Number(element.a$.sheetId),
                 title: name,
                 visibility,
                 hidden: visibility !== "visible",
                 index,
+                type: rid && this.isChartsheet(rid) ? "chartsheet" : "worksheet",
             });
         });
         return catalog;
@@ -3340,6 +3432,13 @@ export class XlsxPlugin extends BaseWorkbookPlugin {
             if (visibility !== "visible") {
                 sheet.visibility = visibility;
             }
+            if (this.isChartsheet(rid)) {
+                sheet.type = "chartsheet";
+                const [chart] = await this.getChartsheetCharts(rid, sheetId);
+                if (chart) {
+                    sheet.chartId = chart.chartId;
+                }
+            }
             const metadata = await this.getSheetMetadata(rid);
             const { merges, rowEntries, columnMetadata, maxRowIndex, maxColumnIndex, autoFilterRange, filterSpecs, sheetViewData, tabColor, sheetHasFilterMode, zeroHeight, defaultRowHeightPx, defaultColumnWidthPx, tablePartIds, outlineSummaryBelow, outlineSummaryRight, sheetProtection, protectedRangeEntries, printSettings, } = metadata;
             if (sheetProtection) {
@@ -4059,7 +4158,7 @@ export class XlsxPlugin extends BaseWorkbookPlugin {
         const sheetPath = target.startsWith("/xl")
             ? target.replace(/^\//gi, "")
             : `xl/${target}`;
-        const sheetRelPath = sheetPath.replace("worksheets", "worksheets/_rels") + ".rels";
+        const sheetRelPath = getSheetRelsPath(sheetPath);
         const relTargets = new Map();
         try {
             const sheetRels = this.xmlParser.parse(await this.zipParser.getText(sheetRelPath));
@@ -4110,6 +4209,10 @@ export class XlsxPlugin extends BaseWorkbookPlugin {
         for (const element of workSheets) {
             const sheetId = Number(element.a$.sheetId);
             const rid = element.a$["r:id"];
+            if (this.isChartsheet(rid)) {
+                allCharts.push(...(await this.getChartsheetCharts(rid, sheetId)));
+                continue;
+            }
             // Charts are anchored inside drawing parts, which the worksheet
             // references via a <drawing> element; skip when the sheet has none.
             const features = this.sheetFeatures.get(rid);
@@ -4120,6 +4223,23 @@ export class XlsxPlugin extends BaseWorkbookPlugin {
             const charts = await this._getCharts(rid, sheetId, sheet_data);
             allCharts.push(...charts);
         }
+        if (allCharts.some((chart) => chart.spec[PIVOT_SOURCE_NAME_KEY] !==
+            undefined)) {
+            const sheetTitleById = new Map();
+            for (const ws of workSheets) {
+                const id = Number(ws.a$?.sheetId);
+                if (ws.a$?.name && Number.isFinite(id))
+                    sheetTitleById.set(id, ws.a$.name);
+            }
+            let pivotTables = [];
+            try {
+                pivotTables = await this.getPivotTables();
+            }
+            catch {
+                // Pivot import is best-effort; the charts fall back to plain charts.
+            }
+            bindPivotChartsToPivotTables(allCharts, pivotTables, sheetTitleById);
+        }
         return allCharts;
     }
     /**
@@ -4129,6 +4249,10 @@ export class XlsxPlugin extends BaseWorkbookPlugin {
      * suitable for `onChangePivotTables`.
      */
     async getPivotTables() {
+        this.pivotTablesPromise ??= this.parsePivotTables();
+        return this.pivotTablesPromise;
+    }
+    async parsePivotTables() {
         const { parsePivotTablesForSheet } = await import("./pivots");
         const all = [];
         const workSheets = this._getSheets();
@@ -4154,7 +4278,7 @@ export class XlsxPlugin extends BaseWorkbookPlugin {
             const path = target.startsWith("/xl")
                 ? target.replace(/^\//gi, "")
                 : `xl/${target}`;
-            const sheetRelPath = path.replace("worksheets", "worksheets/_rels") + ".rels";
+            const sheetRelPath = getSheetRelsPath(path);
             // Sheets without a rels part (common for plain data sheets) must not
             // abort pivot extraction for the remaining sheets.
             let sheetRelContent;
@@ -4518,7 +4642,7 @@ export class XlsxPlugin extends BaseWorkbookPlugin {
                 if (!relation?.target)
                     continue;
                 const sheetPath = this.resolveSheetPath(relation.target);
-                const sheetRelPath = sheetPath.replace("worksheets", "worksheets/_rels") + ".rels";
+                const sheetRelPath = getSheetRelsPath(sheetPath);
                 try {
                     const sheetRelContent = await this.zipParser.getText(sheetRelPath);
                     if (!sheetRelContent)
@@ -4773,6 +4897,7 @@ export class XlsxPlugin extends BaseWorkbookPlugin {
                 const height = extAttributes.cy
                     ? Math.round(parseInt(String(extAttributes.cy), 10) / 9525)
                     : 300;
+                // A `oneCellAnchor` is "Move but don't size with cells" (#668 C-46)
                 return {
                     sheetId,
                     overlayPosition: {
@@ -4784,6 +4909,7 @@ export class XlsxPlugin extends BaseWorkbookPlugin {
                         offsetYPixels: Math.round(rowOff / 9525),
                         widthPixels: width,
                         heightPixels: height,
+                        placement: "moveOnly",
                     },
                 };
             }
@@ -4797,9 +4923,14 @@ export class XlsxPlugin extends BaseWorkbookPlugin {
                 const rowOff = this.parseIntSafe(get(fromCell, "xdr:rowOff") || get(fromCell, "rowOff"));
                 const toCol = this.parseIntSafe(get(toCell, "xdr:col") || get(toCell, "col"));
                 const toRow = this.parseIntSafe(get(toCell, "xdr:row") || get(toCell, "row"));
+                const toColOff = this.parseIntSafe(get(toCell, "xdr:colOff") || get(toCell, "colOff"));
+                const toRowOff = this.parseIntSafe(get(toCell, "xdr:rowOff") || get(toCell, "rowOff"));
                 // Estimate size based on cell span
                 const width = Math.max((toCol - col) * 64, 100);
                 const height = Math.max((toRow - row) * 20, 100);
+                // `editAs` is the slicer's placement mode; a plain twoCellAnchor
+                // keeps `to` as the second anchor like a chart (#668 C-46)
+                const placement = anchorPlacementFromEditAs(get(anchor, "a$.editAs"));
                 return {
                     sheetId,
                     overlayPosition: {
@@ -4811,6 +4942,13 @@ export class XlsxPlugin extends BaseWorkbookPlugin {
                         offsetYPixels: Math.round(rowOff / 9525),
                         widthPixels: width,
                         heightPixels: height,
+                        ...(placement === "moveAndSize"
+                            ? {
+                                toCell: { rowIndex: toRow + 1, columnIndex: toCol + 1 },
+                                toOffsetXPixels: Math.round(toColOff / 9525),
+                                toOffsetYPixels: Math.round(toRowOff / 9525),
+                            }
+                            : { placement }),
                     },
                 };
             }

package/dist/esm/excel-parser/plugins/xlsx/pivots.d.ts

@@ -14,9 +14,15 @@
  * Output shape matches @rowsncolumns/spreadsheet `PivotTable` so
  * imported pivots drop straight into `onChangePivotTables`.
  */
-import type { PivotTable } from "@rowsncolumns/spreadsheet";
-import type { XMLParser } from "fast-xml-parser";
+import type { PivotSharedItems, PivotTable } from "@rowsncolumns/spreadsheet";
+import { XMLParser } from "fast-xml-parser";
 import type { StreamingZipParser } from "../../zip-parser-streaming";
+/**
+ * Each `<cacheField>`'s `<sharedItems>` verbatim, in cache-field order (`undefined`
+ * where a field has none): attributes minus `count`, items in document order with
+ * their type, `v` and any further attributes (rowsncolumns/spreadsheet#668 C-84).
+ */
+export declare const readSharedItemsVerbatim: (cacheText: string) => (PivotSharedItems | undefined)[];
 type SheetPivotRel = {
     /** Relationship target → xl/pivotTables/pivotTable<N>.xml */
     target: string;

package/dist/esm/excel-parser/plugins/xlsx/pivots.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pivots.d.ts","sourceRoot":"","sources":["../../../../../excel-parser/plugins/xlsx/pivots.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAEV,UAAU,EAGX,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAoErE,KAAK,aAAa,GAAG;IACnB,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAkQF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GACnC,SAAS;IACP,SAAS,EAAE,kBAAkB,CAAC;IAC9B,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,mEAAmE;IACnE,WAAW,EAAE,MAAM,MAAM,CAAC;IAC1B,kDAAkD;IAClD,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACtD,cAAc,EAAE,MAAM,CAAC;CACxB,KACA,OAAO,CAAC,UAAU,EAAE,CAsEtB,CAAC"}
+{"version":3,"file":"pivots.d.ts","sourceRoot":"","sources":["../../../../../excel-parser/plugins/xlsx/pivots.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAOV,gBAAgB,EAChB,UAAU,EAIX,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAwJrE;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GAClC,WAAW,MAAM,KAChB,CAAC,gBAAgB,GAAG,SAAS,CAAC,EAqEhC,CAAC;AA4BF,KAAK,aAAa,GAAG;IACnB,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAyRF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GACnC,SAAS;IACP,SAAS,EAAE,kBAAkB,CAAC;IAC9B,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,mEAAmE;IACnE,WAAW,EAAE,MAAM,MAAM,CAAC;IAC1B,kDAAkD;IAClD,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACtD,cAAc,EAAE,MAAM,CAAC;CACxB,KACA,OAAO,CAAC,UAAU,EAAE,CA4EtB,CAAC"}