@rowsncolumns/toolkit 24.4.4 → 24.5.0

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

@@ -31,6 +31,15 @@ const ODS_ORDERED_XML_OPTIONS = {
     preserveOrder: true,
 };
 const DISPLAY_CURRENCY_REGEX = /[$€¥£₹]/;
+/** The symbol behind an ODS `office:currency` value — an ISO code for the currencies the display-text detection knows, a literal symbol as is. */
+const ODS_CURRENCY_CODE_SYMBOLS = {
+    USD: "$",
+    EUR: "€",
+    GBP: "£",
+    JPY: "¥",
+    INR: "₹",
+};
+const odsCurrencySymbol = (currency) => ODS_CURRENCY_CODE_SYMBOLS[currency.toUpperCase()] ?? currency;
 function findChild(children, tagName) {
     return children?.find((child) => child[tagName]);
 }
@@ -223,6 +232,10 @@ const ODS_OPERATOR_TO_CONDITION = {
     endswith: "TEXT_ENDS_WITH",
     empty: "BLANK",
     "non-empty": "NOT_BLANK",
+    "top values": "NUMBER_TOP_N",
+    "bottom values": "NUMBER_BOTTOM_N",
+    "top percent": "NUMBER_TOP_PERCENT",
+    "bottom percent": "NUMBER_BOTTOM_PERCENT",
 };
 export class OdsPlugin extends BaseWorkbookPlugin {
     zipParser;
@@ -865,25 +878,29 @@ export class OdsPlugin extends BaseWorkbookPlugin {
     }
     convertFilterNodeToSpecs(filterNode) {
         const specMap = new Map();
-        const addConditions = (container) => {
+        // <table:filter-and> / <table:filter-or> nest (the exporter puts a
+        // column's Or-joined clause pair inside the outer And): walk them
+        // recursively, tagging each condition with the join of its container so
+        // a column's second condition becomes Excel's Custom AutoFilter clause.
+        const walk = (container, join) => {
             const conditions = this.toArray(get(container, "table:filter-condition") ||
                 get(container, "filter-condition"));
             for (const condition of conditions) {
-                this.applyFilterCondition(condition, specMap);
+                this.applyFilterCondition(condition, specMap, join);
+            }
+            const andNodes = this.toArray(get(container, "table:filter-and") || get(container, "filter-and"));
+            for (const node of andNodes) {
+                walk(node, "AND");
+            }
+            const orNodes = this.toArray(get(container, "table:filter-or") || get(container, "filter-or"));
+            for (const node of orNodes) {
+                walk(node, "OR");
             }
         };
-        addConditions(filterNode);
-        const andNodes = this.toArray(get(filterNode, "table:filter-and") || get(filterNode, "filter-and"));
-        for (const node of andNodes) {
-            addConditions(node);
-        }
-        const orNodes = this.toArray(get(filterNode, "table:filter-or") || get(filterNode, "filter-or"));
-        for (const node of orNodes) {
-            addConditions(node);
-        }
+        walk(filterNode, "AND");
         return Array.from(specMap.values()).sort((a, b) => a.columnIndex - b.columnIndex);
     }
-    applyFilterCondition(node, specMap) {
+    applyFilterCondition(node, specMap, join) {
         const attrs = this.getAttributes(node);
         if (!attrs)
             return;
@@ -919,10 +936,16 @@ export class OdsPlugin extends BaseWorkbookPlugin {
             if (value2 !== undefined) {
                 conditionValues.push({ userEnteredValue: String(value2) });
             }
-            spec.filterCriteria.condition = {
-                type: conditionType,
-                values: conditionValues,
-            };
+            const condition = { type: conditionType, values: conditionValues };
+            if (spec.filterCriteria.condition?.type) {
+                // A second operator condition on the column is the Custom
+                // AutoFilter's second clause, joined the way its container joins.
+                spec.filterCriteria.condition2 = condition;
+                spec.filterCriteria.conditionJoin = join;
+            }
+            else {
+                spec.filterCriteria.condition = condition;
+            }
             return;
         }
         // operator "=" (or unknown) -> value-list entry.
@@ -2017,7 +2040,28 @@ export class OdsPlugin extends BaseWorkbookPlugin {
         if (!plotArea)
             return undefined;
         const plotAreaAttrs = this.getAttributes(plotArea);
-        const sourceChartType = this.resolveOdsSourceChartType(chartClass, chartType, plotAreaAttrs?.["@_chart:style-name"] || plotAreaAttrs?.["@_style-name"], styles);
+        const plotAreaStyleName = plotAreaAttrs?.["@_chart:style-name"] || plotAreaAttrs?.["@_style-name"];
+        const sourceChartType = this.resolveOdsSourceChartType(chartClass, chartType, plotAreaStyleName, styles);
+        // Excel's "Show empty cells as" — the default (a gap) is left implicit.
+        const emptyCells = styles.getChartStyleEmptyCells(plotAreaStyleName);
+        // Axis tick-label formats — an axis style's data style with the source
+        // link severed is Excel's `<c:numFmt sourceLinked="0">`; a linked axis
+        // carries no options (the default).
+        let valueAxisOptions;
+        let categoryAxisOptions;
+        for (const axisNode of this.toArray(get(plotArea, "chart:axis") || get(plotArea, "axis"))) {
+            const axisAttrs = this.getAttributes(axisNode);
+            const pattern = styles.getChartStyleNumberFormatPattern(axisAttrs?.["@_chart:style-name"] || axisAttrs?.["@_style-name"]);
+            if (!pattern)
+                continue;
+            const dimension = axisAttrs?.["@_chart:dimension"] || axisAttrs?.["@_dimension"];
+            if (dimension === "y" && !valueAxisOptions) {
+                valueAxisOptions = { numberFormatPattern: pattern };
+            }
+            else if (dimension === "x" && !categoryAxisOptions) {
+                categoryAxisOptions = { numberFormatPattern: pattern };
+            }
+        }
         const seriesNodes = this.toArray(get(plotArea, "chart:series") ||
             get(plotArea, "chart:data-series") ||
             get(plotArea, "series"));
@@ -2025,8 +2069,16 @@ export class OdsPlugin extends BaseWorkbookPlugin {
             return undefined;
         const domains = [];
         const series = [];
+        // Exploded pie / doughnut: the largest `chart:pie-offset` across the
+        // series styles (OOXML keeps one <c:explosion> per series too).
+        let explosion;
         let seriesIndex = 1;
         for (const seriesNode of seriesNodes) {
+            const seriesAttrs = this.getAttributes(seriesNode);
+            const pieOffset = styles.getChartStylePieOffset(seriesAttrs?.["@_chart:style-name"] || seriesAttrs?.["@_style-name"]);
+            if (pieOffset !== undefined) {
+                explosion = Math.max(explosion ?? 0, pieOffset);
+            }
             const domainNode = get(seriesNode, "chart:domain") ||
                 get(seriesNode, "domain") ||
                 get(seriesNode, "chart:categories");
@@ -2064,6 +2116,13 @@ export class OdsPlugin extends BaseWorkbookPlugin {
             domains: finalizedDomains,
             series,
             ...(sourceChartType ? { sourceChartType } : {}),
+            ...(emptyCells && emptyCells !== "gaps" ? { emptyCells } : {}),
+            ...(valueAxisOptions ? { valueAxisOptions } : {}),
+            ...(categoryAxisOptions ? { categoryAxisOptions } : {}),
+            ...(explosion !== undefined &&
+                (chartType === "pie" || chartType === "doughnut")
+                ? { explosion }
+                : {}),
         };
     }
     extractSeriesLabel(seriesNode) {
@@ -2143,6 +2202,10 @@ export class OdsPlugin extends BaseWorkbookPlugin {
         if (normalized.includes("line") || normalized.includes("scatter")) {
             return "line";
         }
+        // `chart:ring` is ODF's doughnut.
+        if (normalized.includes("ring")) {
+            return "doughnut";
+        }
         if (normalized.includes("pie") || normalized.includes("circle")) {
             return "pie";
         }
@@ -2175,6 +2238,8 @@ export class OdsPlugin extends BaseWorkbookPlugin {
                 return "PIE_3D";
             case "area":
                 return "AREA_3D";
+            default:
+                return undefined;
         }
     }
     findRangeString(node, skipKeys) {
@@ -2273,6 +2338,24 @@ export class OdsPlugin extends BaseWorkbookPlugin {
         if (typeof offsetYPixels === "number") {
             overlayPosition.offsetYPixels = offsetYPixels;
         }
+        // `table:end-cell-address` (+ end-x / end-y) is ODS's "Move and size with
+        // cells" second anchor — kept as `toCell` so the frame follows the cells
+        // between the corners (#668 C-06). A frame without one keeps its pixel size.
+        const endAttr = (name) => frameAttrs?.[`@_table:${name}`] ||
+            frameAttrs?.[`@_${name}`] ||
+            cellAttrs?.[`@_table:${name}`] ||
+            cellAttrs?.[`@_${name}`];
+        const endCellAddress = endAttr("end-cell-address");
+        if (endCellAddress) {
+            const toCell = addressToCell((endCellAddress.split(".").pop() ?? endCellAddress).toUpperCase());
+            if (toCell) {
+                overlayPosition.toCell = toCell;
+                overlayPosition.toOffsetXPixels =
+                    this.convertLengthToPixels(endAttr("end-x")) ?? 0;
+                overlayPosition.toOffsetYPixels =
+                    this.convertLengthToPixels(endAttr("end-y")) ?? 0;
+            }
+        }
         const DEFAULT_CELL_IMAGE_MAX_SIZE = 60;
         const exceedsCellSize = (typeof widthPixels === "number" &&
             widthPixels > DEFAULT_CELL_IMAGE_MAX_SIZE) ||
@@ -2994,19 +3077,19 @@ export class OdsPlugin extends BaseWorkbookPlugin {
                                         mergedFormat = mergedFormat
                                             ? { ...mergedFormat }
                                             : {};
-                                        const currencySymbol = cellAttrs["@_office:currency"] ||
+                                        const currencySymbol = odsCurrencySymbol(cellAttrs["@_office:currency"] ||
                                             cellAttrs["@_currency"] ||
-                                            "$";
+                                            "$");
                                         if (!mergedFormat.numberFormat ||
                                             mergedFormat.numberFormat.type === "NUMBER") {
+                                            // No currency data style: Excel's default Currency format
+                                            // puts the symbol flush against the number (`$#,##0.00`).
                                             const pattern = mergedFormat.numberFormat?.pattern || "#,##0.00";
                                             mergedFormat.numberFormat = {
                                                 type: "CURRENCY",
                                                 pattern: pattern.includes(currencySymbol)
                                                     ? pattern
-                                                    : `${currencySymbol}${pattern.startsWith("#") || pattern.startsWith("0")
-                                                        ? " "
-                                                        : ""}${pattern}`,
+                                                    : `${currencySymbol}${pattern}`,
                                             };
                                         }
                                     }

package/dist/esm/excel-parser/plugins/ods/styles.d.ts

@@ -49,6 +49,12 @@ export declare class OdsStyles {
     private rightToLeftTableStyles;
     /** Chart styles whose `style:chart-properties` carry `chart:three-dimensional="true"`. */
     private threeDimensionalChartStyles;
+    /** Chart styles' `chart:treat-empty-cells`, as the spec's `emptyCells` policy. */
+    private chartStyleEmptyCells;
+    /** Series chart styles' `chart:pie-offset` (slice explosion, % of the radius). */
+    private chartStylePieOffsets;
+    /** Chart (axis) styles' `style:data-style-name` when the link to the source is severed. */
+    private chartStyleDataStyles;
     constructor();
     reset(): void;
     parseStylesXml(stylesXml: any): void;
@@ -73,6 +79,15 @@ export declare class OdsStyles {
     getChartStyleColor(styleName?: string): Color | undefined;
     /** Whether a chart style (plot-area) declares `chart:three-dimensional="true"`. */
     isChartStyleThreeDimensional(styleName?: string): boolean;
+    /** A series style's `chart:pie-offset` (slice explosion, % of the radius). */
+    getChartStylePieOffset(styleName?: string): number | undefined;
+    /**
+     * A chart axis style's explicit tick-label format (its data style, with
+     * the source link severed) as a number pattern; undefined when linked.
+     */
+    getChartStyleNumberFormatPattern(styleName?: string): string | undefined;
+    /** The plot-area style's `chart:treat-empty-cells` as a spec `emptyCells` policy. */
+    getChartStyleEmptyCells(styleName?: string): "gaps" | "zero" | "connect" | undefined;
     /** Whether a `style:family="table"` style renders the sheet right-to-left. */
     isTableStyleRightToLeft(styleName?: string): boolean;
     getTableCellFormat(styleName: string): CellFormat | undefined;

package/dist/esm/excel-parser/plugins/ods/styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../../../excel-parser/plugins/ods/styles.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../../../excel-parser/plugins/ods/styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,UAAU,EACV,KAAK,EAGL,WAAW,EACX,SAAS,EACT,YAAY,EACZ,UAAU,EACX,MAAM,2BAA2B,CAAC;AAenC,KAAK,WAAW,GAAG;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,qEAAqE;IACrE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,KAAK,cAAc,GAAG;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B,CAAC;AAEF,gFAAgF;AAChF,MAAM,MAAM,aAAa,GAAG;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAYF,qBAAa,SAAS;IACpB,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,mBAAmB,CAA+B;IAC1D,OAAO,CAAC,SAAS,CAAuC;IACxD,OAAO,CAAC,kBAAkB,CAAuC;IACjE,OAAO,CAAC,YAAY,CAA0C;IAC9D,OAAO,CAAC,qBAAqB,CAA0C;IACvE,OAAO,CAAC,UAAU,CAAkD;IACpE,OAAO,CAAC,mBAAmB,CAAkD;IAC7E,OAAO,CAAC,WAAW,CAAkD;IACrE,OAAO,CAAC,oBAAoB,CAAkD;IAC9E,OAAO,CAAC,aAAa,CAAwC;IAC7D,OAAO,CAAC,WAAW,CAAiC;IACpD,mDAAmD;IACnD,OAAO,CAAC,gBAAgB,CAAkC;IAC1D,OAAO,CAAC,WAAW,CAAyC;IAC5D,OAAO,CAAC,WAAW,CAAyC;IAC5D,+GAA+G;IAC/G,OAAO,CAAC,sBAAsB,CAA0B;IACxD,0FAA0F;IAC1F,OAAO,CAAC,2BAA2B,CAA0B;IAC7D,kFAAkF;IAClF,OAAO,CAAC,oBAAoB,CAChB;IACZ,kFAAkF;IAClF,OAAO,CAAC,oBAAoB,CAAkC;IAC9D,2FAA2F;IAC3F,OAAO,CAAC,oBAAoB,CAAkC;;IAI9D,KAAK;IAuBL,cAAc,CAAC,SAAS,EAAE,GAAG;IA0B7B;;;;;OAKG;IACH,uBAAuB,CAAC,aAAa,EAAE,GAAG;IA+B1C,OAAO,CAAC,kBAAkB;IA8F1B,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI7D,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAItD,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAItD,eAAe,CAAC,UAAU,EAAE,GAAG;IAc/B,OAAO,CAAC,aAAa;IAgJrB,OAAO,CAAC,mBAAmB;IAuB3B,OAAO,CAAC,uBAAuB;IAc/B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAQnD,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAMvD,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAO7D,kBAAkB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAKzD,mFAAmF;IACnF,4BAA4B,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO;IAIzD,8EAA8E;IAC9E,sBAAsB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI9D;;;OAGG;IACH,gCAAgC,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAUxE,qFAAqF;IACrF,uBAAuB,CACrB,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS;IAI1C,8EAA8E;IAC9E,uBAAuB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO;IAIpD,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAO7D,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAOzD,OAAO,CAAC,mBAAmB;IAuP3B,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,eAAe;IAsCvB,OAAO,CAAC,kBAAkB;IAsC1B,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,iBAAiB;IAoBzB,OAAO,CAAC,sBAAsB;IA2E9B,OAAO,CAAC,kBAAkB;IAmD1B,OAAO,CAAC,oBAAoB;IA+D5B,OAAO,CAAC,OAAO;IAKf,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,WAAW;IAuBnB,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,cAAc;IAiBtB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,qBAAqB;CAgB9B"}

package/dist/esm/excel-parser/plugins/ods/styles.js

@@ -1,5 +1,11 @@
 import { get } from "lodash-es";
 import { headerFooterZoneFromTokens, joinHeaderFooterZones, odsLengthToInches, paperSizeFromCm, parseOdsPrintTokens, parseOdsTableCentering, } from "../../../print-settings";
+/** ODF `chart:treat-empty-cells` → `ChartSpec.emptyCells`. */
+const ODS_TREAT_EMPTY_CELLS_TO_POLICY = {
+    "leave-gap": "gaps",
+    "use-zero": "zero",
+    ignore: "connect",
+};
 export class OdsStyles {
     cellStyles = new Map();
     automaticCellStyles = new Map();
@@ -21,6 +27,12 @@ export class OdsStyles {
     rightToLeftTableStyles = new Set();
     /** Chart styles whose `style:chart-properties` carry `chart:three-dimensional="true"`. */
     threeDimensionalChartStyles = new Set();
+    /** Chart styles' `chart:treat-empty-cells`, as the spec's `emptyCells` policy. */
+    chartStyleEmptyCells = new Map();
+    /** Series chart styles' `chart:pie-offset` (slice explosion, % of the radius). */
+    chartStylePieOffsets = new Map();
+    /** Chart (axis) styles' `style:data-style-name` when the link to the source is severed. */
+    chartStyleDataStyles = new Map();
     constructor() { }
     reset() {
         this.cellStyles.clear();
@@ -40,6 +52,9 @@ export class OdsStyles {
         this.masterPages.clear();
         this.rightToLeftTableStyles.clear();
         this.threeDimensionalChartStyles.clear();
+        this.chartStyleEmptyCells.clear();
+        this.chartStylePieOffsets.clear();
+        this.chartStyleDataStyles.clear();
     }
     parseStylesXml(stylesXml) {
         if (!stylesXml)
@@ -269,6 +284,25 @@ export class OdsStyles {
                 if (threeDimensional === "true" || threeDimensional === true) {
                     this.threeDimensionalChartStyles.add(name);
                 }
+                const treatEmptyCells = chartProps?.["@_chart:treat-empty-cells"] ??
+                    chartProps?.["@_treat-empty-cells"];
+                const emptyCells = ODS_TREAT_EMPTY_CELLS_TO_POLICY[String(treatEmptyCells)];
+                if (name && emptyCells) {
+                    this.chartStyleEmptyCells.set(name, emptyCells);
+                }
+                const pieOffset = Number(chartProps?.["@_chart:pie-offset"] ?? chartProps?.["@_pie-offset"]);
+                if (name && Number.isFinite(pieOffset) && pieOffset > 0) {
+                    this.chartStylePieOffsets.set(name, pieOffset);
+                }
+                // An axis' explicit tick-label format: a data style whose link to
+                // the source cells is severed (LibreOffice writes the data style
+                // with `chart:link-data-style-to-source="true"` for a linked axis).
+                const dataStyleName = style["@_style:data-style-name"] || style["@_data-style-name"];
+                const linkToSource = chartProps?.["@_chart:link-data-style-to-source"] ??
+                    chartProps?.["@_link-data-style-to-source"];
+                if (name && dataStyleName && String(linkToSource) !== "true") {
+                    this.chartStyleDataStyles.set(name, dataStyleName);
+                }
                 const color = this.convertChartStyle(style);
                 if (color) {
                     const displayName = style["@_style:display-name"] || style["@_display-name"];
@@ -343,6 +377,27 @@ export class OdsStyles {
     isChartStyleThreeDimensional(styleName) {
         return !!styleName && this.threeDimensionalChartStyles.has(styleName);
     }
+    /** A series style's `chart:pie-offset` (slice explosion, % of the radius). */
+    getChartStylePieOffset(styleName) {
+        return styleName ? this.chartStylePieOffsets.get(styleName) : undefined;
+    }
+    /**
+     * A chart axis style's explicit tick-label format (its data style, with
+     * the source link severed) as a number pattern; undefined when linked.
+     */
+    getChartStyleNumberFormatPattern(styleName) {
+        const dataStyleName = styleName
+            ? this.chartStyleDataStyles.get(styleName)
+            : undefined;
+        const numberFormat = dataStyleName
+            ? this.numberFormats.get(dataStyleName)
+            : undefined;
+        return numberFormat?.pattern ?? undefined;
+    }
+    /** The plot-area style's `chart:treat-empty-cells` as a spec `emptyCells` policy. */
+    getChartStyleEmptyCells(styleName) {
+        return styleName ? this.chartStyleEmptyCells.get(styleName) : undefined;
+    }
     /** Whether a `style:family="table"` style renders the sheet right-to-left. */
     isTableStyleRightToLeft(styleName) {
         return !!styleName && this.rightToLeftTableStyles.has(styleName);
@@ -664,13 +719,31 @@ export class OdsStyles {
             case "currency": {
                 const symbolNode = this.first(this.toArray(node["number:currency-symbol"]));
                 const symbol = this.extractText(symbolNode) || "¤";
+                // The symbol's side is its element order relative to `number:number`
+                // (the unordered tree keeps first-occurrence key order); a
+                // `number:position="after"` attribute is honoured as a fallback.
                 const position = symbolNode?.["@_number:position"] ||
                     symbolNode?.["@_style:position"] ||
                     symbolNode?.["@_position"];
-                const usePrefix = position !== "after";
+                const keys = Object.keys(node);
+                const symbolAt = keys.indexOf("number:currency-symbol");
+                const numberAt = keys.indexOf("number:number");
+                const usePrefix = symbolAt >= 0 && numberAt >= 0
+                    ? symbolAt < numberAt
+                    : position !== "after";
+                // A whitespace-only `number:text` is the gap between symbol and digits
+                // (the XML parser trims values, so it arrives as an empty node).
+                const texts = node["number:text"];
+                const space = texts !== undefined &&
+                    (Array.isArray(texts) ? texts : [texts]).some((text) => {
+                        const value = this.extractText(text);
+                        return value === undefined || String(value).trim() === "";
+                    })
+                    ? " "
+                    : "";
                 const pattern = this.buildNumberPattern(node, {
-                    prefix: usePrefix ? `${symbol} ` : undefined,
-                    suffix: !usePrefix ? ` ${symbol}` : undefined,
+                    prefix: usePrefix ? `${symbol}${space}` : undefined,
+                    suffix: !usePrefix ? `${space}${symbol}` : undefined,
                     defaultFractionDigits: 2,
                 });
                 return {
@@ -713,8 +786,9 @@ export class OdsStyles {
         if (isNaN(decimals)) {
             decimals = options?.defaultFractionDigits ?? 0;
         }
-        const groupingAttr = numberNode?.["@_number:grouping"] || numberNode?.["@_grouping"] || "true";
-        const grouping = groupingAttr !== "false";
+        // ODF's `number:grouping` defaults to false: `0.00` has no thousands separator.
+        const groupingAttr = numberNode?.["@_number:grouping"] || numberNode?.["@_grouping"] || "false";
+        const grouping = groupingAttr === "true";
         const minIntegerDigits = Math.max(parseInt(numberNode?.["@_number:min-integer-digits"] ||
             numberNode?.["@_min-integer-digits"] ||
             "1", 10) || 1, 1);

package/dist/esm/excel-parser/plugins/xlsb/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../excel-parser/plugins/xlsb/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,EAEL,2BAA2B,EAE5B,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EACV,WAAW,EAGX,qBAAqB,EACrB,wBAAwB,EAExB,aAAa,EACb,UAAU,EACV,KAAK,EACL,gBAAgB,EAChB,SAAS,EACV,MAAM,2BAA2B,CAAC;AAenC,OAAO,KAAK,EACV,0BAA0B,EAC1B,sBAAsB,EACvB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AA8VnD,eAAO,MAAM,qBAAqB,YAdJ,UAAU;;;CAcQ,CAAC;AAkBjD,eAAO,MAAM,mBAAmB,GAC9B,SAAS,UAAU,EACnB,wBAAwB,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS;;;;;QAoC7D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,SAAS,UAAU;;QAOxD,CAAC;AAiJF,KAAK,QAAQ,GAAG;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,KAAK,UAAU,GAAG;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,KAAK,CAAC;CACjB,CAAC;AAEF,KAAK,YAAY,GAAG;IAClB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACrB,OAAO,EAAE,QAAQ,EAAE,CAAC;IACpB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB,CAAC;AAUF,KAAK,UAAU,GAAG;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACtB,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,KAAK,CAAC;CACf,CAAC;AAEF,KAAK,YAAY,GAAG;IAClB,GAAG,CAAC,EAAE,gBAAgB,CAAC;IACvB,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,IAAI,CAAC,EAAE,gBAAgB,CAAC;CACzB,CAAC;AAswBF,qBAAa,UAAW,SAAQ,kBAAkB;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4B;IACtD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAOvB;IAEH,OAAO,CAAC,MAAM,CAAuB;IACrC,aAAa,EAAE,MAAM,EAAE,CAAM;IAC7B,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAa;IAC5D,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,MAAM,CAOZ;IACF,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,QAAQ,CAKT;IACP,OAAO,CAAC,eAAe,CAA4B;IACnD,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,OAAO,CAAS;IAElB,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwGxE,OAAO,IAAI,IAAI;YAID,yBAAyB;YAoBzB,iBAAiB;YAgBjB,UAAU;YAoGV,SAAS;IAwBvB,QAAQ,IAAI,gBAAgB;IAI5B,OAAO,CAAC,qBAAqB;YAMf,wBAAwB;YAwBxB,uBAAuB;YAwBvB,kBAAkB;YAmFlB,cAAc;IAiH5B,aAAa,IAAI,MAAM;IAIvB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,qBAAqB;IAoBvB,SAAS,CACb,WAAW,SAAI,EACf,cAAc,SAAI,GACjB,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IAgDlC,gBAAgB,IAAI,MAAM,EAAE;IAI5B,SAAS;IAIT,QAAQ,IAAI,MAAM,EAAE;IAQpB,UAAU,IAAI,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC;IAIvC,cAAc,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM;IAQ5B,gBAAgB,CACrB,SAAS,SAAM,EACf,qBAAqB,UAAQ,EAC7B,mBAAmB,UAAO,GACzB,cAAc,CAAC,sBAAsB,EAAE,IAAI,EAAE,OAAO,CAAC;IAmPlD,WAAW,IAAI,OAAO,CAAC,0BAA0B,EAAE,CAAC;IA6DpD,SAAS,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAwFrC,wBAAwB,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAsF5D,kBAAkB,IAAI,OAAO,CAAC,wBAAwB,EAAE,CAAC;IA8J/D,OAAO,CAAC,YAAY;IA8CpB,OAAO,CAAC,gBAAgB;IAaxB,cAAc,IAAI,UAAU,EAAE;IAI9B,cAAc,IAAI,OAAO;IAIzB;;;;OAIG;IACH,eAAe,IAAI,OAAO;IAI1B,8BAA8B,IAAI,2BAA2B,GAAG,SAAS;CAW1E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../excel-parser/plugins/xlsb/index.ts"],"names":[],"mappings":"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"}

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

@@ -4,7 +4,7 @@ import { XMLParser } from "fast-xml-parser";
 import { get } from "lodash-es";
 import { parseRgce } from "./rgce-parser";
 import { StreamingZipParser } from "../../zip-parser-streaming";
-import { createFilterSpecsFromAutoFilter, excelColumnWidthToPixels, getRangeFromAddressRef, parseTableColumnTotals, } from "../../helpers";
+import { createFilterSpecsFromAutoFilter, createSortSpecsFromSortState, excelColumnWidthToPixels, getRangeFromAddressRef, hiddenFilterButtonColumns, parseTableColumnTotals, } from "../../helpers";
 import { defaultSpreadsheetTheme } from "../../theme-default";
 import { BaseWorkbookPlugin } from "../base/index";
 import { processChart } from "../xlsx/charts";
@@ -1557,6 +1557,12 @@ export class XlsbPlugin extends BaseWorkbookPlugin {
             });
             const autoFilter = tableDefinition.autoFilter ?? tableDefinition["x:autoFilter"];
             const filterSpecs = createFilterSpecsFromAutoFilter(autoFilter);
+            for (const colId of hiddenFilterButtonColumns(autoFilter)) {
+                if (columns[colId])
+                    columns[colId].filterButton = false;
+            }
+            const sortSpecs = createSortSpecsFromSortState(tableDefinition.sortState ?? tableDefinition["x:sortState"], range);
+            const headerRow = attrs.headerRowCount !== "0";
             const tableStyle = get(tableDefinition, "tableStyleInfo") ||
                 get(tableDefinition, "x:tableStyleInfo") ||
                 {};
@@ -1565,16 +1571,18 @@ export class XlsbPlugin extends BaseWorkbookPlugin {
                 id: attrs.id || uuid(),
                 title: attrs.name || attrs.displayName || `Table_${tables.length + 1}`,
                 sheetId: sheet.sheetId,
-                headerRow: attrs.headerRowCount !== "0",
+                headerRow,
                 totalRow: attrs.totalsRowCount === "1",
-                showRowStripes: attrs.showRowStripes !== "0",
-                showColumnStripes: attrs.showColumnStripes === "1",
-                showFirstColumn: attrs.showFirstColumn === "1",
-                showLastColumn: attrs.showLastColumn === "1",
-                filterButton: attrs.filterButton !== "0",
+                // The banding toggles live on `<tableStyleInfo>`, not on `<table>`.
+                showRowStripes: tableStyleAttrs.showRowStripes !== "0",
+                showColumnStripes: tableStyleAttrs.showColumnStripes === "1",
+                showFirstColumn: tableStyleAttrs.showFirstColumn === "1",
+                showLastColumn: tableStyleAttrs.showLastColumn === "1",
+                filterButton: attrs.filterButton !== "0" && (!headerRow || autoFilter !== undefined),
                 columns: columns,
                 range,
                 filterSpecs,
+                ...(sortSpecs.length ? { sortSpecs } : {}),
             };
             if (tableStyleAttrs.name) {
                 tableView.theme = tableStyleAttrs.name;

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

@@ -1,4 +1,4 @@
-import type { ChartData, EmbeddedChart, EmbeddedObjectPosition, HIDDEN_DIMENSION_STRATEGY, SheetRange } from "@rowsncolumns/spreadsheet";
+import type { ChartData, EmbeddedChart, EmbeddedObjectPosition, HIDDEN_DIMENSION_STRATEGY, PivotChartFieldButtons, PivotChartFormat, PivotTable, SheetRange } from "@rowsncolumns/spreadsheet";
 import type { StreamingZipParser } from "../../zip-parser-streaming";
 /**
  * Resolver from a sheet name (as it appears inside chart formula refs,
@@ -15,6 +15,82 @@ export declare function extractChartDataRange(plotArea: any, chartType: string,
  * In Excel: plotVisOnly="1" means skip hidden rows/columns, "0" means show all
  */
 export declare function extractHiddenDimensionStrategy(chart: any): HIDDEN_DIMENSION_STRATEGY | undefined;
+/**
+ * `<c:dispBlanksAs val="gap|zero|span"/>` — Excel's "Show empty cells as"
+ * (Select Data → Hidden and Empty Cells). `span` is "Connect data points
+ * with line".
+ */
+export declare function extractEmptyCellsPolicy(chart: any): "gaps" | "zero" | "connect" | undefined;
+/**
+ * Excel 2016+ "Show #N/A as an empty cell":
+ * `<c:chart><c:extLst><c:ext uri="{56B9EC1D-…}"><c16r3:dataDisplayOptions16>
+ * <c16r3:dispNaAsBlank val="0|1"/>`. Undefined when the file predates the
+ * option (Excel then treats #N/A the legacy way — as if `val="0"`, but the
+ * spec leaves the default to the renderer).
+ */
+export declare function extractShowNaAsEmpty(chart: any): boolean | undefined;
+/**
+ * Transient spec key carrying `<c:pivotSource><c:name>` until the workbook's
+ * pivots are known; `bindPivotChartsToPivotTables` turns it into
+ * `pivotTableId` and removes it.
+ */
+export declare const PIVOT_SOURCE_NAME_KEY = "__pivotSourceName";
+/**
+ * Transient spec key carrying `<c:pivotSource><c:fmtId>` alongside the
+ * name; becomes `pivotSource.formatId` once the chart binds to its pivot.
+ */
+export declare const PIVOT_SOURCE_FORMAT_ID_KEY = "__pivotSourceFormatId";
+/**
+ * `<c:pivotSource><c:fmtId val="3"/>` — the id the pivot's `<chartFormats>`
+ * name this chart by. `0` is the exporter's default and stays implicit.
+ */
+export declare function extractPivotSourceFormatId(chartSpaceRoot: any): number | undefined;
+/** `<c:pivotSource><c:name>[Book1.xlsx]Sheet1!PivotTable1</c:name>` → the name text. */
+export declare function extractPivotSourceName(chartSpaceRoot: any): string | undefined;
+/**
+ * Split a pivotSource name into its sheet and pivot-table parts. The
+ * `[workbook]` prefix is dropped (it names the file the chart lived in);
+ * the sheet may be quoted (`'My Sheet'!PivotTable1`).
+ */
+export declare function parsePivotSourceName(name: string): {
+    sheetTitle?: string;
+    pivotName: string;
+} | undefined;
+/**
+ * Resolve every imported chart's `<c:pivotSource>` name to the id of the
+ * imported PivotTable it names (matched by pivot name, and by the pivot's
+ * target sheet when the name carries one). A name that matches no pivot
+ * leaves a plain chart — Excel converts a PivotChart whose pivot is gone
+ * to a static chart too. The transient key is always removed.
+ */
+export declare function bindPivotChartsToPivotTables(charts: EmbeddedChart[], pivotTables: readonly PivotTable[], sheetTitleById: ReadonlyMap<number, string>): void;
+/**
+ * `<c:chart><c:pivotFmts><c:pivotFmt><c:idx val/>…` — the per pivot-item
+ * formats Excel re-applies on a re-plot; only the index and a literal
+ * fill colour are kept.
+ */
+export declare function extractPivotFormats(chart: any): PivotChartFormat[] | undefined;
+/**
+ * Namespace URI → the prefix Excel writes for it. Bodies are stored with these
+ * canonical prefixes so a file that declared, say, `xmlns:c="…"` as `cs:` still
+ * round-trips through an exporter that declares `c:` / `a:` at the root.
+ */
+export declare const CHART_XML_PREFIXES: Record<string, string>;
+/**
+ * Read every `<c:pivotFmt>` body (its children after `<c:idx>`) verbatim from
+ * the chart part and attach it to the matching `pivotFormats` entry by index
+ * (rowsncolumns/spreadsheet#668 C-83). Gradient fills, theme colours, markers
+ * and data-label formatting Excel keeps per pivot item survive the round-trip
+ * that `color` (a literal solid fill) alone cannot carry.
+ */
+export declare function attachPivotFormatBodies(formats: PivotChartFormat[], chartContent: string): void;
+/**
+ * Excel's Field Buttons choices — `<c14:pivotOptions>` in the chartSpace
+ * `<c:extLst>`: `dropZoneFilter` / `dropZoneCategories` / `dropZoneData` /
+ * `dropZoneSeries` / `dropZonesVisible`, each `1` unless hidden. Only the
+ * hidden ones are recorded (every button shows by default).
+ */
+export declare function extractPivotFieldButtons(chartSpaceRoot: any): PivotChartFieldButtons | undefined;
 export declare function extractChartTitle(chart: any): string;
 export declare function determineChartType(chart: any): "bar" | "column" | "line" | "pie" | "doughnut" | "area" | "radar" | "stock" | "scatter" | "bubble" | "treemap" | "sunburst" | "histogram" | "boxplot" | "waterfall" | "funnel";
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"charts.d.ts","sourceRoot":"","sources":["../../../../../excel-parser/plugins/xlsx/charts.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"charts.d.ts","sourceRoot":"","sources":["../../../../../excel-parser/plugins/xlsx/charts.ts"],"names":[],"mappings":"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"}