@rowsncolumns/toolkit 24.4.2 → 24.4.4

package/dist/cjs/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,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AASrE,KAAK,aAAa,GAAG;IACnB,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AA6OF;;;;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,CAoEtB,CAAC"}
+{"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"}

package/dist/cjs/excel-parser/plugins/xlsx/pivots.js

@@ -1,4 +1,88 @@
-import { __awaiter, __generator, __read, __values } from "tslib";
+import { __assign, __awaiter, __generator, __read, __values } from "tslib";
+var attr = function (node, name) {
+    var _a, _b;
+    var v = (_b = (_a = node === null || node === void 0 ? void 0 : node.a$) === null || _a === void 0 ? void 0 : _a[name]) !== null && _b !== void 0 ? _b : node === null || node === void 0 ? void 0 : node["@_".concat(name)];
+    return v === undefined || v === null ? undefined : String(v);
+};
+/**
+ * `dataField@showDataAs` (ECMA-376) + the `x14:dataField@pivotShowAs`
+ * extension Excel uses for the newer modes → `PivotValue.showAs`.
+ * Modes without an engine equivalent (difference, % of parent, index…)
+ * degrade to the plain aggregate.
+ */
+var readShowAs = function (dataField) {
+    var e_1, _a;
+    var _b, _c;
+    var extLst = (_b = dataField === null || dataField === void 0 ? void 0 : dataField.extLst) !== null && _b !== void 0 ? _b : dataField === null || dataField === void 0 ? void 0 : dataField["x:extLst"];
+    var exts = asArray((_c = extLst === null || extLst === void 0 ? void 0 : extLst.ext) !== null && _c !== void 0 ? _c : extLst === null || extLst === void 0 ? void 0 : extLst["x:ext"]);
+    try {
+        for (var exts_1 = __values(exts), exts_1_1 = exts_1.next(); !exts_1_1.done; exts_1_1 = exts_1.next()) {
+            var ext = exts_1_1.value;
+            var x14 = ext === null || ext === void 0 ? void 0 : ext["x14:dataField"];
+            var pivotShowAs = attr(x14, "pivotShowAs");
+            if (pivotShowAs === "rankAscending")
+                return "rank_asc";
+            if (pivotShowAs === "rankDescending")
+                return "rank_desc";
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (exts_1_1 && !exts_1_1.done && (_a = exts_1.return)) _a.call(exts_1);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    switch (attr(dataField, "showDataAs")) {
+        case "percentOfTotal":
+            return "pct_of_total";
+        case "percentOfRow":
+            return "pct_of_row";
+        case "percentOfCol":
+            return "pct_of_column";
+        case "runTotal":
+            return "running_total";
+        default:
+            return undefined;
+    }
+};
+var readStyleInfo = function (pt) {
+    var e_2, _a;
+    var _b;
+    var node = (_b = pt === null || pt === void 0 ? void 0 : pt.pivotTableStyleInfo) !== null && _b !== void 0 ? _b : pt === null || pt === void 0 ? void 0 : pt["x:pivotTableStyleInfo"];
+    if (!node)
+        return undefined;
+    var flag = function (name) {
+        var v = attr(node, name);
+        return v === undefined ? undefined : v !== "0" && v !== "false";
+    };
+    var info = {};
+    var name = attr(node, "name");
+    if (name)
+        info.name = name;
+    try {
+        for (var _c = __values([
+            "showRowHeaders",
+            "showColHeaders",
+            "showRowStripes",
+            "showColStripes",
+            "showLastColumn",
+        ]), _d = _c.next(); !_d.done; _d = _c.next()) {
+            var key = _d.value;
+            var v = flag(key);
+            if (v !== undefined)
+                info[key] = v;
+        }
+    }
+    catch (e_2_1) { e_2 = { error: e_2_1 }; }
+    finally {
+        try {
+            if (_d && !_d.done && (_a = _c.return)) _a.call(_c);
+        }
+        finally { if (e_2) throw e_2.error; }
+    }
+    return Object.keys(info).length ? info : undefined;
+};
 var asArray = function (value) {
     if (value === undefined || value === null)
         return [];
@@ -29,7 +113,7 @@ var parseA1Range = function (a1) {
     };
 };
 var parseA1Cell = function (cell) {
-    var e_1, _a;
+    var e_3, _a;
     var m = cell.match(/^([A-Za-z]+)(\d+)$/);
     if (!m)
         return null;
@@ -40,12 +124,12 @@ var parseA1Cell = function (cell) {
             col = col * 26 + (ch.charCodeAt(0) - 64);
         }
     }
-    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    catch (e_3_1) { e_3 = { error: e_3_1 }; }
     finally {
         try {
             if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
         }
-        finally { if (e_1) throw e_1.error; }
+        finally { if (e_3) throw e_3.error; }
     }
     return { col: col, row: Number(m[2]) };
 };
@@ -84,10 +168,13 @@ var parsePivotCacheDefinition = function (cacheXml) {
     var cacheSource = (_b = cacheDef.cacheSource) !== null && _b !== void 0 ? _b : cacheDef["x:cacheSource"];
     var wsSource = (_c = cacheSource === null || cacheSource === void 0 ? void 0 : cacheSource.worksheetSource) !== null && _c !== void 0 ? _c : cacheSource === null || cacheSource === void 0 ? void 0 : cacheSource["x:worksheetSource"];
     var sourceRef = ((_d = wsSource === null || wsSource === void 0 ? void 0 : wsSource.a$) === null || _d === void 0 ? void 0 : _d.ref) || (wsSource === null || wsSource === void 0 ? void 0 : wsSource["@_ref"]);
+    // Excel writes the source sheet as `worksheetSource@sheet` (the ref is
+    // then sheet-less); a `Sheet!A1:D9` prefix on the ref also occurs.
+    var sourceSheet = attr(wsSource, "sheet");
     var cacheFields = (_e = cacheDef.cacheFields) !== null && _e !== void 0 ? _e : cacheDef["x:cacheFields"];
     var rawFieldList = asArray((_f = cacheFields === null || cacheFields === void 0 ? void 0 : cacheFields.cacheField) !== null && _f !== void 0 ? _f : cacheFields === null || cacheFields === void 0 ? void 0 : cacheFields["x:cacheField"]);
     var fields = rawFieldList.map(function (cf) {
-        var e_2, _a, e_3, _b, e_4, _c;
+        var e_4, _a, e_5, _b, e_6, _c;
         var _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p;
         var name = ((_d = cf.a$) === null || _d === void 0 ? void 0 : _d.name) || cf["@_name"] || "";
         var sharedItemsNode = (_e = cf.sharedItems) !== null && _e !== void 0 ? _e : cf["x:sharedItems"];
@@ -99,12 +186,12 @@ var parsePivotCacheDefinition = function (cacheXml) {
                     items.push(String((_j = (_h = (_g = s.a$) === null || _g === void 0 ? void 0 : _g.v) !== null && _h !== void 0 ? _h : s["@_v"]) !== null && _j !== void 0 ? _j : ""));
                 }
             }
-            catch (e_2_1) { e_2 = { error: e_2_1 }; }
+            catch (e_4_1) { e_4 = { error: e_4_1 }; }
             finally {
                 try {
                     if (_r && !_r.done && (_a = _q.return)) _a.call(_q);
                 }
-                finally { if (e_2) throw e_2.error; }
+                finally { if (e_4) throw e_4.error; }
             }
             try {
                 for (var _s = __values(asArray((_k = sharedItemsNode.n) !== null && _k !== void 0 ? _k : sharedItemsNode["x:n"])), _t = _s.next(); !_t.done; _t = _s.next()) {
@@ -112,12 +199,12 @@ var parsePivotCacheDefinition = function (cacheXml) {
                     items.push(Number((_o = (_m = (_l = n.a$) === null || _l === void 0 ? void 0 : _l.v) !== null && _m !== void 0 ? _m : n["@_v"]) !== null && _o !== void 0 ? _o : 0));
                 }
             }
-            catch (e_3_1) { e_3 = { error: e_3_1 }; }
+            catch (e_5_1) { e_5 = { error: e_5_1 }; }
             finally {
                 try {
                     if (_t && !_t.done && (_b = _s.return)) _b.call(_s);
                 }
-                finally { if (e_3) throw e_3.error; }
+                finally { if (e_5) throw e_5.error; }
             }
             try {
                 for (var _u = __values(asArray((_p = sharedItemsNode.m) !== null && _p !== void 0 ? _p : sharedItemsNode["x:m"])), _v = _u.next(); !_v.done; _v = _u.next()) {
@@ -125,17 +212,18 @@ var parsePivotCacheDefinition = function (cacheXml) {
                     items.push(null);
                 }
             }
-            catch (e_4_1) { e_4 = { error: e_4_1 }; }
+            catch (e_6_1) { e_6 = { error: e_6_1 }; }
             finally {
                 try {
                     if (_v && !_v.done && (_c = _u.return)) _c.call(_u);
                 }
-                finally { if (e_4) throw e_4.error; }
+                finally { if (e_6) throw e_6.error; }
             }
         }
-        return { name: name, sharedItems: items.length > 0 ? items : undefined };
+        var formula = attr(cf, "formula");
+        return __assign({ name: name, sharedItems: items.length > 0 ? items : undefined }, (formula !== undefined ? { formula: formula } : {}));
     });
-    return { sourceRef: sourceRef, fields: fields };
+    return { sourceRef: sourceRef, sourceSheet: sourceSheet, fields: fields };
 };
 /**
  * Parse a single pivotTable.xml into a PivotTable record. Needs the
@@ -172,7 +260,8 @@ var parsePivotTableXml = function (pivotXml, cacheDef, getSheetId, defaultSheetI
     // Source range from cacheDef
     var source;
     if (cacheDef.sourceRef) {
-        var _l = stripSheetPrefix(cacheDef.sourceRef), sheet = _l.sheet, a1 = _l.a1;
+        var _l = stripSheetPrefix(cacheDef.sourceRef), prefixSheet = _l.sheet, a1 = _l.a1;
+        var sheet = prefixSheet !== null && prefixSheet !== void 0 ? prefixSheet : cacheDef.sourceSheet;
         var sourceRange = parseA1Range(a1);
         if (sourceRange) {
             var resolved = sheet ? getSheetId(sheet) : undefined;
@@ -214,35 +303,32 @@ var parsePivotTableXml = function (pivotXml, cacheDef, getSheetId, defaultSheetI
         .map(function (field) { return ({ field: field, displayName: field }); });
     var values = dataFieldList
         .map(function (d) {
-        var _a, _b, _c, _d;
+        var _a, _b, _c, _d, _e;
         var idx = Number((_b = (_a = d.a$) === null || _a === void 0 ? void 0 : _a.fld) !== null && _b !== void 0 ? _b : d["@_fld"]);
         var field = fieldNameAt(idx);
         if (!field)
             return null;
-        var aggFunc = normalizeAggFunc(((_c = d.a$) === null || _c === void 0 ? void 0 : _c.subtotal) || d["@_subtotal"]);
-        var displayName = ((_d = d.a$) === null || _d === void 0 ? void 0 : _d.name) || d["@_name"] || "".concat(aggFunc, " of ").concat(field);
-        return { field: field, displayName: displayName, aggFunc: aggFunc };
+        // Excel always summarizes a calculated field with Sum.
+        var aggFunc = ((_c = cacheDef.fields[idx]) === null || _c === void 0 ? void 0 : _c.formula) !== undefined
+            ? "sum"
+            : normalizeAggFunc(((_d = d.a$) === null || _d === void 0 ? void 0 : _d.subtotal) || d["@_subtotal"]);
+        var displayName = ((_e = d.a$) === null || _e === void 0 ? void 0 : _e.name) || d["@_name"] || "".concat(aggFunc, " of ").concat(field);
+        var showAs = readShowAs(d);
+        return __assign({ field: field, displayName: displayName, aggFunc: aggFunc }, (showAs ? { showAs: showAs } : {}));
     })
         .filter(function (v) { return v !== null; });
+    var calculatedFields = cacheDef.fields
+        .filter(function (f) { return f.formula !== undefined && f.name !== ""; })
+        .map(function (f) { return ({ name: f.name, formula: f.formula }); });
+    var styleInfo = readStyleInfo(pt);
     // Display toggles (Phase A1 — round-trip these so the editor
     // checkboxes pick up the imported values).
     // XLSX: rowGrandTotals / colGrandTotals default to "1" (true).
     var showRowGT = ((_h = (_g = pt.a$) === null || _g === void 0 ? void 0 : _g.rowGrandTotals) !== null && _h !== void 0 ? _h : pt["@_rowGrandTotals"]) !== "0";
     var showColGT = ((_k = (_j = pt.a$) === null || _j === void 0 ? void 0 : _j.colGrandTotals) !== null && _k !== void 0 ? _k : pt["@_colGrandTotals"]) !== "0";
-    return {
-        pivotId: pivotId,
-        name: name,
-        source: source,
-        targetPosition: targetPosition,
-        pivotRange: pivotRange,
-        rows: rows,
-        columns: columns,
-        values: values,
-        showRowGrandTotals: showRowGT,
-        showColumnGrandTotals: showColGT,
+    return __assign(__assign({ pivotId: pivotId, name: name, source: source, targetPosition: targetPosition, pivotRange: pivotRange, rows: rows, columns: columns, values: values, showRowGrandTotals: showRowGT, showColumnGrandTotals: showColGT, 
         // Subtotal default on individual fields → leave true.
-        showSubtotals: true,
-    };
+        showSubtotals: true }, (calculatedFields.length ? { calculatedFields: calculatedFields } : {})), (styleInfo ? { styleInfo: styleInfo } : {}));
 };
 /**
  * Top-level: parse every pivotTable referenced by a worksheet's
@@ -250,8 +336,8 @@ var parsePivotTableXml = function (pivotXml, cacheDef, getSheetId, defaultSheetI
  * to the host's `pivotTables` state).
  */
 export var parsePivotTablesForSheet = function (options) { return __awaiter(void 0, void 0, void 0, function () {
-    var zipParser, xmlParser, sheetRels, nextPivotId, getSheetId, defaultSheetId, out, sheetRels_1, sheetRels_1_1, rel, pivotTablePath, pivotTableXmlText, pivotXml, pivotDir, fileName, pivotRelsPath, pivotRelsText, cacheDef, pivotRels, relList, cacheRel, cachePath, cacheText, _a, pivot, e_5_1;
-    var e_5, _b;
+    var zipParser, xmlParser, sheetRels, nextPivotId, getSheetId, defaultSheetId, out, sheetRels_1, sheetRels_1_1, rel, pivotTablePath, pivotTableXmlText, pivotXml, pivotDir, fileName, pivotRelsPath, pivotRelsText, cacheDef, pivotRels, relList, cacheRel, cachePath, cacheText, _a, pivot, e_7_1;
+    var e_7, _b;
     var _c, _d;
     return __generator(this, function (_e) {
         switch (_e.label) {
@@ -283,7 +369,9 @@ export var parsePivotTablesForSheet = function (options) { return __awaiter(void
                 return [4 /*yield*/, zipParser.getText(pivotRelsPath)];
             case 4:
                 pivotRelsText = _e.sent();
-                cacheDef = { fields: [] };
+                cacheDef = {
+                    fields: [],
+                };
                 if (!pivotRelsText) return [3 /*break*/, 8];
                 pivotRels = xmlParser.parse(pivotRelsText);
                 relList = asArray((_c = pivotRels === null || pivotRels === void 0 ? void 0 : pivotRels.Relationships) === null || _c === void 0 ? void 0 : _c.Relationship);
@@ -327,14 +415,14 @@ export var parsePivotTablesForSheet = function (options) { return __awaiter(void
                 return [3 /*break*/, 2];
             case 10: return [3 /*break*/, 13];
             case 11:
-                e_5_1 = _e.sent();
-                e_5 = { error: e_5_1 };
+                e_7_1 = _e.sent();
+                e_7 = { error: e_7_1 };
                 return [3 /*break*/, 13];
             case 12:
                 try {
                     if (sheetRels_1_1 && !sheetRels_1_1.done && (_b = sheetRels_1.return)) _b.call(sheetRels_1);
                 }
-                finally { if (e_5) throw e_5.error; }
+                finally { if (e_7) throw e_7.error; }
                 return [7 /*endfinally*/];
             case 13: return [2 /*return*/, out];
         }

package/dist/cjs/excel-parser/plugins/xlsx/sheet-views.d.ts

@@ -5,6 +5,7 @@
  *   - showRowColHeaders (row/column header visibility)
  *   - showZeros (whether zero values render in cells)
  *   - zoomScale (integer percent, 10-400; undefined = use Excel default 100)
+ *   - rightToLeft (the sheet displays right-to-left; only surfaced when set)
  *
  * Works with both single sheet view and multiple sheet views.
  *
@@ -21,6 +22,8 @@ export type SheetViewProperties = {
     showRowColHeaders: boolean;
     showZeros: boolean;
     zoomScale?: number;
+    /** `<sheetView rightToLeft="1">` — column A on the right. Absent = LTR. */
+    rightToLeft?: true;
 };
 export declare function extractSheetViewProperties(sheetViewData: any): SheetViewProperties;
 //# sourceMappingURL=sheet-views.d.ts.map

package/dist/cjs/excel-parser/plugins/xlsx/sheet-views.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sheet-views.d.ts","sourceRoot":"","sources":["../../../../../excel-parser/plugins/xlsx/sheet-views.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,OAAO,CAAC;IACvB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAKF,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,GAAG,GACjB,mBAAmB,CAqErB"}
+{"version":3,"file":"sheet-views.d.ts","sourceRoot":"","sources":["../../../../../excel-parser/plugins/xlsx/sheet-views.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,OAAO,CAAC;IACvB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,IAAI,CAAC;CACpB,CAAC;AAQF,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,GAAG,GACjB,mBAAmB,CAsErB"}

package/dist/cjs/excel-parser/plugins/xlsx/sheet-views.js

@@ -2,6 +2,9 @@ import { __assign } from "tslib";
 var isFalseAttr = function (val) {
     return val === "0" || val === "false" || val === false;
 };
+var isTrueAttr = function (val) {
+    return val === "1" || val === "true" || val === true;
+};
 export function extractSheetViewProperties(sheetViewData) {
     var defaults = {
         frozenRowCount: 0,
@@ -55,5 +58,5 @@ export function extractSheetViewProperties(sheetViewData) {
             zoomScale = parsed;
         }
     }
-    return __assign(__assign(__assign({ frozenRowCount: frozenRowCount, frozenColumnCount: frozenColumnCount }, (paneTopLeftCell ? { paneTopLeftCell: paneTopLeftCell } : {})), { showGridLines: !isFalseAttr(viewAttrs.showGridLines), showRowColHeaders: !isFalseAttr(viewAttrs.showRowColHeaders), showZeros: !isFalseAttr(viewAttrs.showZeros) }), (zoomScale !== undefined ? { zoomScale: zoomScale } : {}));
+    return __assign(__assign(__assign(__assign({ frozenRowCount: frozenRowCount, frozenColumnCount: frozenColumnCount }, (paneTopLeftCell ? { paneTopLeftCell: paneTopLeftCell } : {})), { showGridLines: !isFalseAttr(viewAttrs.showGridLines), showRowColHeaders: !isFalseAttr(viewAttrs.showRowColHeaders), showZeros: !isFalseAttr(viewAttrs.showZeros) }), (zoomScale !== undefined ? { zoomScale: zoomScale } : {})), (isTrueAttr(viewAttrs.rightToLeft) ? { rightToLeft: true } : {}));
 }

package/dist/cjs/excel-parser/plugins/xlsx/styles.d.ts

@@ -1,4 +1,4 @@
-import type { GridRange } from "@rowsncolumns/common-types";
+import type { GridRange, NamedCellStyle } from "@rowsncolumns/common-types";
 import type { CellData, Color, ExtendedValue, TextFormat } from "@rowsncolumns/spreadsheet";
 import type { WorkBook } from "../../workbook";
 import type { WorkbookStyles } from "./index";
@@ -12,6 +12,13 @@ type MergeCellContext = {
  * @param {WorkBook} workbook - The workbook object containing shared strings
  * @returns {Object} Object containing value and cellFormat properties
  */
+/** Days between the 1900 and 1904 date systems' serial 0. */
+export declare const DATE_1904_OFFSET_DAYS = 1462;
+/**
+ * Number formats whose serials move with the workbook's date system. Pure
+ * time-of-day values (`TIME`) are the same fraction in both systems.
+ */
+export declare const isEpochShiftedFormat: (type: string | undefined) => boolean;
 export declare function getCellValueAndFormat(cell: any, workbook: WorkBook, enableCellXfsRegistry?: boolean, enableSharedStrings?: boolean, activeSheetName?: string, mergeContext?: MergeCellContext): CellData | null;
 /**
  * Build a format-only CellData for a style index that a cell inherits from
@@ -31,6 +38,13 @@ export declare function extractCellProtection(cell: any, workbookStyles: Workboo
     locked?: boolean;
     hidden?: boolean;
 } | undefined;
+/**
+ * Resolve the workbook's named cell styles (`<cellStyles>`) to cell formats
+ * by reading each entry's `cellStyleXfs[xfId]` — the same extraction a cell
+ * xf goes through, minus merge-anchor border merging. Powers the toolbar's
+ * "Workbook styles" gallery; entries whose xf is missing keep no `format`.
+ */
+export declare function resolveNamedCellStyles(workbookStyles: WorkbookStyles | undefined | null): NamedCellStyle[];
 /**
  * Parse a raw styles.xml `<font>` node into a TextFormat. Also used for the
  * workbook default font (fonts[0]) so the exporter can round-trip it.

package/dist/cjs/excel-parser/plugins/xlsx/styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../../../excel-parser/plugins/xlsx/styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAS,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAGV,QAAQ,EAER,KAAK,EAEL,aAAa,EAIb,UAAU,EACX,MAAM,2BAA2B,CAAC;AAKnC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAuD9C,KAAK,gBAAgB,GAAG;IACtB,KAAK,EAAE,SAAS,CAAC;IACjB,qBAAqB,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACzC,CAAC;AAEF;;;;;GAKG;AAEH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,GAAG,EACT,QAAQ,EAAE,QAAQ,EAClB,qBAAqB,UAAQ,EAC7B,mBAAmB,UAAQ,EAC3B,eAAe,CAAC,EAAE,MAAM,EACxB,YAAY,CAAC,EAAE,gBAAgB,GAC9B,QAAQ,GAAG,IAAI,CAwJjB;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,QAAQ,EAClB,qBAAqB,UAAQ,GAC5B,QAAQ,GAAG,IAAI,CAoBjB;AAED,eAAO,MAAM,gBAAgB,GAAI,UAAU,GAAG,KAAG,aAAa,GAAG,SAShE,CAAC;AAuTF;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,GAAG,EACT,cAAc,EAAE,cAAc,GAC7B;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,CAUpD;AAuMD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,GAAG,EACT,cAAc,EAAE,cAAc,GAC7B,UAAU,GAAG,IAAI,CAwFnB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,GAAG,EACb,aAAa,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,GACxC,KAAK,GAAG,SAAS,GAAG,IAAI,CA8C1B"}
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../../../excel-parser/plugins/xlsx/styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EAET,cAAc,EACf,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAGV,QAAQ,EAER,KAAK,EAEL,aAAa,EAIb,UAAU,EACX,MAAM,2BAA2B,CAAC;AAMnC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAuD9C,KAAK,gBAAgB,GAAG;IACtB,KAAK,EAAE,SAAS,CAAC;IACjB,qBAAqB,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACzC,CAAC;AAEF;;;;;GAKG;AAEH,6DAA6D;AAC7D,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAE1C;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,GAAG,SAAS,KAAG,OACvB,CAAC;AAE1C,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,GAAG,EACT,QAAQ,EAAE,QAAQ,EAClB,qBAAqB,UAAQ,EAC7B,mBAAmB,UAAQ,EAC3B,eAAe,CAAC,EAAE,MAAM,EACxB,YAAY,CAAC,EAAE,gBAAgB,GAC9B,QAAQ,GAAG,IAAI,CAqKjB;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,QAAQ,EAClB,qBAAqB,UAAQ,GAC5B,QAAQ,GAAG,IAAI,CAoBjB;AAED,eAAO,MAAM,gBAAgB,GAAI,UAAU,GAAG,KAAG,aAAa,GAAG,SAShE,CAAC;AA2TF;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,GAAG,EACT,cAAc,EAAE,cAAc,GAC7B;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,CAUpD;AAgCD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,cAAc,GAAG,SAAS,GAAG,IAAI,GAChD,cAAc,EAAE,CAuBlB;AA4ND;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,GAAG,EACT,cAAc,EAAE,cAAc,GAC7B,UAAU,GAAG,IAAI,CAwFnB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,GAAG,EACb,aAAa,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,GACxC,KAAK,GAAG,SAAS,GAAG,IAAI,CA8C1B"}

package/dist/cjs/excel-parser/plugins/xlsx/styles.js

@@ -2,6 +2,7 @@ import { __assign, __read, __values } from "tslib";
 import { formulaToRelativeReference } from "@rowsncolumns/calculator";
 import { IndexedColors } from "@rowsncolumns/utils";
 import { addressToCell, ssfFormat } from "@rowsncolumns/utils";
+import { decodeImplicitIntersection } from "../../../helpers/implicit-intersection";
 import { standardExcelFormatCodeById } from "./numfmt";
 import { detectValueTypeAndPattern } from "./value-type-detection";
 var getNode = function (node) {
@@ -77,15 +78,24 @@ var getInlineStringValue = function (cell) {
  * @param {WorkBook} workbook - The workbook object containing shared strings
  * @returns {Object} Object containing value and cellFormat properties
  */
+/** Days between the 1900 and 1904 date systems' serial 0. */
+export var DATE_1904_OFFSET_DAYS = 1462;
+/**
+ * Number formats whose serials move with the workbook's date system. Pure
+ * time-of-day values (`TIME`) are the same fraction in both systems.
+ */
+export var isEpochShiftedFormat = function (type) {
+    return type === "DATE" || type === "DATE_TIME";
+};
 export function getCellValueAndFormat(cell, workbook, enableCellXfsRegistry, enableSharedStrings, activeSheetName, mergeContext) {
-    var _a, _b;
+    var _a, _b, _c;
     if (enableCellXfsRegistry === void 0) { enableCellXfsRegistry = false; }
     if (enableSharedStrings === void 0) { enableSharedStrings = false; }
     if (!cell) {
         return null;
     }
     // Extract raw value
-    var _c = extractCellValue(cell, workbook, activeSheetName), extractedRawValue = _c.rawValue, formulaValue = _c.formulaValue, sharedStringIndex = _c.sharedStringIndex, isError = _c.isError, arrayFormulaRef = _c.arrayFormulaRef, sharedFormulaSpec = _c.sharedFormulaSpec;
+    var _d = extractCellValue(cell, workbook, activeSheetName), extractedRawValue = _d.rawValue, formulaValue = _d.formulaValue, sharedStringIndex = _d.sharedStringIndex, isError = _d.isError, arrayFormulaRef = _d.arrayFormulaRef, sharedFormulaSpec = _d.sharedFormulaSpec;
     var rawValue = extractedRawValue;
     // Extract cell format
     var cellFormat = extractCellFormat(cell, workbook.workbookStyles, mergeContext);
@@ -117,7 +127,7 @@ export function getCellValueAndFormat(cell, workbook, enableCellXfsRegistry, ena
     if (!cellFormat.numberFormat &&
         typeof rawValue === "string" &&
         formulaValue === null) {
-        var _d = __read(detectValueTypeAndPattern(rawValue, undefined), 4), detectedValueType = _d[0], detectedNumberFormatType = _d[1], detectedNumberValue = _d[2], detectedPattern = _d[3];
+        var _e = __read(detectValueTypeAndPattern(rawValue, undefined), 4), detectedValueType = _e[0], detectedNumberFormatType = _e[1], detectedNumberValue = _e[2], detectedPattern = _e[3];
         if (detectedValueType === "numberValue" &&
             detectedNumberFormatType &&
             detectedNumberValue !== undefined) {
@@ -129,6 +139,16 @@ export function getCellValueAndFormat(cell, workbook, enableCellXfsRegistry, ena
         var styleId = workbook.registerFormat(cellFormat);
         ef = { sid: styleId };
     }
+    // A 1904-system workbook stores its date serials 1462 days below the 1900
+    // system the calculation engine, the formatter and the exporter run on.
+    // Date / datetime-formatted numbers (literals and cached formula results)
+    // are converted here, as `rnc-import` does, so they display and compute as
+    // the same calendar dates; time-of-day serials are epoch-independent.
+    if (typeof rawValue === "number" &&
+        isEpochShiftedFormat((_a = cellFormat.numberFormat) === null || _a === void 0 ? void 0 : _a.type) &&
+        workbook.getUse1904Epoch()) {
+        rawValue += DATE_1904_OFFSET_DAYS;
+    }
     // User entered value
     var ue;
     var ev;
@@ -167,7 +187,7 @@ export function getCellValueAndFormat(cell, workbook, enableCellXfsRegistry, ena
     if (!hasRawValue && !hasValue) {
         return hasFormat ? { uf: ef } : null;
     }
-    var pattern = (_b = (_a = cellFormat === null || cellFormat === void 0 ? void 0 : cellFormat.numberFormat) === null || _a === void 0 ? void 0 : _a.pattern) !== null && _b !== void 0 ? _b : "GENERAL";
+    var pattern = (_c = (_b = cellFormat === null || cellFormat === void 0 ? void 0 : cellFormat.numberFormat) === null || _b === void 0 ? void 0 : _b.pattern) !== null && _c !== void 0 ? _c : "GENERAL";
     // Skip persisting `fv` for formula cells — the renderer derives the
     // formatted value at paint time from the formula's effective value and
     // the precedent-derived number format. Excel ships a cached `fv` in the
@@ -311,7 +331,9 @@ function extractCellValue(cell, workbook, activeSheetName) {
         }
     }
     if (formulaValue) {
-        formulaValue = normalizeFormulaSheetNames(formulaValue);
+        // Excel 365 persists the implicit-intersection operator `@` as
+        // `_xlfn.SINGLE(...)`; show it the way Excel does.
+        formulaValue = decodeImplicitIntersection(normalizeFormulaSheetNames(formulaValue));
     }
     switch (cellType) {
         case "s": {
@@ -522,6 +544,73 @@ function extractCellFormat(cell, workbookStyles, mergeContext) {
     var xfId = xfIdStr !== undefined ? parseInt(xfIdStr) : 0;
     var parentXf = xfId > 0 ? workbookStyles.getCellStyleXf(xfId) : null;
     var xf = buildEffectiveXf(cellXf, parentXf);
+    return extractCellFormatFromXf(xf, workbookStyles, cell, mergeContext);
+}
+/**
+ * Resolve the workbook's named cell styles (`<cellStyles>`) to cell formats
+ * by reading each entry's `cellStyleXfs[xfId]` — the same extraction a cell
+ * xf goes through, minus merge-anchor border merging. Powers the toolbar's
+ * "Workbook styles" gallery; entries whose xf is missing keep no `format`.
+ */
+export function resolveNamedCellStyles(workbookStyles) {
+    if (!workbookStyles)
+        return [];
+    return workbookStyles.namedCellStyles.map(function (entry) {
+        var xf = workbookStyles.getCellStyleXf(entry.xfId);
+        if (!xf)
+            return __assign({}, entry);
+        // Drop empty slots and the default General number format — a style that
+        // carries nothing else is format-less as far as the gallery is concerned.
+        var format = Object.fromEntries(Object.entries(extractCellFormatFromXf(maskCellStyleXf(xf), workbookStyles)).filter(function (_a) {
+            var _b = __read(_a, 2), key = _b[0], value = _b[1];
+            return value != null &&
+                !(key === "numberFormat" &&
+                    value.type === "GENERAL" &&
+                    (!value.pattern ||
+                        value.pattern === "General"));
+        }));
+        return Object.keys(format).length ? __assign(__assign({}, entry), { format: format }) : __assign({}, entry);
+    });
+}
+var isApplyFlagOff = function (value) { return value === "0" || value === "false"; };
+/**
+ * A `cellStyleXfs` entry only *includes* an attribute when its `applyX` flag
+ * is not off (OOXML §18.8.45): Excel writes `applyFont="0" applyFill="0"
+ * applyBorder="0" applyAlignment="0"` on `Percent` / `Comma` / `Currency`,
+ * whose Style dialog has only "Number" ticked, so applying them must change
+ * the number format alone — extracting their `fontId="0"` as a real font
+ * would reset the cell's font family / size and un-bold it. Strip the
+ * excluded attributes before extraction. (Cell `cellXfs` entries follow the
+ * inverse rule and go through `buildEffectiveXf` instead.)
+ */
+function maskCellStyleXf(xf) {
+    var _a;
+    var attrs = (_a = xf === null || xf === void 0 ? void 0 : xf.a$) !== null && _a !== void 0 ? _a : {};
+    var masked = __assign(__assign({}, xf), { a$: __assign({}, attrs) });
+    if (isApplyFlagOff(attrs.applyNumberFormat))
+        delete masked.a$.numFmtId;
+    if (isApplyFlagOff(attrs.applyFont))
+        delete masked.a$.fontId;
+    if (isApplyFlagOff(attrs.applyFill))
+        delete masked.a$.fillId;
+    if (isApplyFlagOff(attrs.applyBorder))
+        delete masked.a$.borderId;
+    if (isApplyFlagOff(attrs.applyAlignment)) {
+        delete masked.alignment;
+        delete masked["x:alignment"];
+    }
+    if (isApplyFlagOff(attrs.applyProtection)) {
+        delete masked.protection;
+        delete masked["x:protection"];
+    }
+    return masked;
+}
+/**
+ * Extract a cell format from a resolved `<xf>` node. `cell` / `mergeContext`
+ * only matter for merge-anchor border merging and may be omitted.
+ */
+function extractCellFormatFromXf(xf, workbookStyles, cell, mergeContext) {
+    var cellFormat = {};
     // Extract number format
     var numberFormat = extractNumberFormat(xf, workbookStyles);
     if (!((numberFormat === null || numberFormat === void 0 ? void 0 : numberFormat.type) === "GENERAL" && !numberFormat.pattern)) {
@@ -566,7 +655,14 @@ function extractCellFormat(cell, workbookStyles, mergeContext) {
             cellFormat.relativeIndent = relativeIndent;
         if (alignment.textRotation) {
             var rotation = parseInt(alignment.textRotation);
-            cellFormat.textRotation = rotation === 255 ? "vertical" : rotation;
+            // Excel encodes clockwise rotation as 90 + degrees (91–180); the engine
+            // keeps signed counter-clockwise degrees (-90…90) like the renderer.
+            cellFormat.textRotation =
+                rotation === 255
+                    ? "vertical"
+                    : rotation > 90
+                        ? 90 - rotation
+                        : rotation;
         }
         if (alignment.shrinkToFit === "1" || alignment.shrinkToFit === "true") {
             cellFormat.shrinkToFit = true;

package/dist/cjs/excel-parser/registry.d.ts

@@ -2,4 +2,11 @@ import type { IWorkbookPlugin } from "./interface";
 export type PluginFactory = () => IWorkbookPlugin;
 export declare const PARSER_REGISTRY: Record<string, PluginFactory>;
 export declare function getPluginForFile(file: File | string): IWorkbookPlugin;
+/**
+ * Content-aware plugin resolution. The extension picks the parser, except:
+ * an OOXML zip saved with a `.xls` name opens through the xlsx parser (Excel
+ * opens those too), and a BIFF (CFB) container opens through the `.xls`
+ * reader whatever its name says.
+ */
+export declare function resolvePluginForBuffer(file: File | string, buffer: ArrayBuffer | File): Promise<IWorkbookPlugin>;
 //# sourceMappingURL=registry.d.ts.map

package/dist/cjs/excel-parser/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../excel-parser/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAMnD,MAAM,MAAM,aAAa,GAAG,MAAM,eAAe,CAAC;AAElD,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAKzD,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,eAAe,CAWrE"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../excel-parser/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAanD,MAAM,MAAM,aAAa,GAAG,MAAM,eAAe,CAAC;AAElD,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAMzD,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,eAAe,CAWrE;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,IAAI,GAAG,MAAM,EACnB,MAAM,EAAE,WAAW,GAAG,IAAI,GACzB,OAAO,CAAC,eAAe,CAAC,CAU1B"}

package/dist/cjs/excel-parser/registry.js

@@ -1,4 +1,6 @@
+import { __awaiter, __generator } from "tslib";
 import { OdsPlugin } from "./plugins/ods/index";
+import { CFB_SIGNATURE, readHeader, startsWith, XlsPlugin, ZIP_SIGNATURE, } from "./plugins/xls/index";
 import { XlsbPlugin } from "./plugins/xlsb/index";
 import { XlsmPlugin } from "./plugins/xlsm/index";
 import { XlsxPlugin } from "./plugins/xlsx/index";
@@ -6,6 +8,7 @@ export var PARSER_REGISTRY = {
     xlsx: function () { return new XlsxPlugin(); },
     xlsm: function () { return new XlsmPlugin(); },
     xlsb: function () { return new XlsbPlugin(); },
+    xls: function () { return new XlsPlugin(); },
     ods: function () { return new OdsPlugin(); },
 };
 export function getPluginForFile(file) {
@@ -19,3 +22,29 @@ export function getPluginForFile(file) {
     // Current behavior assumes everything is xlsx-like
     return new XlsxPlugin();
 }
+/**
+ * Content-aware plugin resolution. The extension picks the parser, except:
+ * an OOXML zip saved with a `.xls` name opens through the xlsx parser (Excel
+ * opens those too), and a BIFF (CFB) container opens through the `.xls`
+ * reader whatever its name says.
+ */
+export function resolvePluginForBuffer(file, buffer) {
+    return __awaiter(this, void 0, void 0, function () {
+        var header, plugin;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, readHeader(buffer, CFB_SIGNATURE.length)];
+                case 1:
+                    header = _a.sent();
+                    if (startsWith(header, CFB_SIGNATURE)) {
+                        return [2 /*return*/, new XlsPlugin()];
+                    }
+                    plugin = getPluginForFile(file);
+                    if (plugin instanceof XlsPlugin && startsWith(header, ZIP_SIGNATURE)) {
+                        return [2 /*return*/, new XlsxPlugin()];
+                    }
+                    return [2 /*return*/, plugin];
+            }
+        });
+    });
+}