@rowsncolumns/toolkit 24.4.1

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

@@ -0,0 +1,2 @@
+export { BUILTIN_NUMFMT_BY_ID as standardExcelFormatCodeById } from "../../builtin-numfmts";
+//# sourceMappingURL=numfmt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"numfmt.d.ts","sourceRoot":"","sources":["../../../../../excel-parser/plugins/xlsx/numfmt.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,IAAI,2BAA2B,EAAE,MAAM,uBAAuB,CAAC"}

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

@@ -0,0 +1,3 @@
+// Backwards-compatible export. The canonical table lives in
+// `excel-parser/builtin-numfmts.ts` so the exporter can share it.
+export { BUILTIN_NUMFMT_BY_ID as standardExcelFormatCodeById } from "../../builtin-numfmts";

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

@@ -0,0 +1,40 @@
+/**
+ * XLSX pivot table parser — Phase D1.
+ *
+ * Parses two XML families:
+ *   1. xl/pivotTables/pivotTable<N>.xml     (layout: rows/cols/values)
+ *   2. xl/pivotCache/pivotCacheDefinition<N>.xml (field names + source range)
+ *
+ * `xl/pivotCache/pivotCacheRecords<N>.xml` (the cached source data)
+ * is intentionally skipped — pivots in the host calculator pull
+ * live data from the sheet via the source range, so the cache
+ * records are redundant. Excel itself ignores stale caches when
+ * `refreshOnLoad="1"` is set.
+ *
+ * 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 { StreamingZipParser } from "../../zip-parser-streaming";
+type SheetPivotRel = {
+    /** Relationship target → xl/pivotTables/pivotTable<N>.xml */
+    target: string;
+};
+/**
+ * Top-level: parse every pivotTable referenced by a worksheet's
+ * relationships. Returns a flat PivotTable[] (host attaches them
+ * to the host's `pivotTables` state).
+ */
+export declare const parsePivotTablesForSheet: (options: {
+    zipParser: StreamingZipParser;
+    xmlParser: XMLParser;
+    sheetRels: SheetPivotRel[];
+    /** ID we'll stamp on imported pivots. Host can normalize later. */
+    nextPivotId: () => string;
+    /** Map XLSX sheet name → host numeric sheetId. */
+    getSheetId: (sheetName: string) => number | undefined;
+    defaultSheetId: number;
+}) => Promise<PivotTable[]>;
+export {};
+//# sourceMappingURL=pivots.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,342 @@
+import { __awaiter, __generator, __read, __values } from "tslib";
+var asArray = function (value) {
+    if (value === undefined || value === null)
+        return [];
+    return Array.isArray(value) ? value : [value];
+};
+var stripSheetPrefix = function (ref) {
+    var _a;
+    // Source refs in XLSX include the sheet, e.g. "Sheet1!$A$1:$D$100".
+    // Quoted sheets: "'Sheet 1'!$A$1:$D$100".
+    var m = ref.match(/^(?:'([^']+)'|([^!]+))!(.+)$/);
+    if (!m)
+        return { a1: ref };
+    return { sheet: (_a = m[1]) !== null && _a !== void 0 ? _a : m[2], a1: m[3] };
+};
+var parseA1Range = function (a1) {
+    // Accept "$A$1:$D$100", "A1:D100", "A1" (single cell), etc.
+    var range = a1.replace(/\$/g, "");
+    var _a = __read(range.split(":"), 2), s = _a[0], e = _a[1];
+    var startCell = parseA1Cell(s);
+    var endCell = e ? parseA1Cell(e) : startCell;
+    if (!startCell || !endCell)
+        return null;
+    return {
+        startCol: startCell.col,
+        endCol: endCell.col,
+        startRow: startCell.row,
+        endRow: endCell.row,
+    };
+};
+var parseA1Cell = function (cell) {
+    var e_1, _a;
+    var m = cell.match(/^([A-Za-z]+)(\d+)$/);
+    if (!m)
+        return null;
+    var col = 0;
+    try {
+        for (var _b = __values(m[1].toUpperCase()), _c = _b.next(); !_c.done; _c = _b.next()) {
+            var ch = _c.value;
+            col = col * 26 + (ch.charCodeAt(0) - 64);
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    return { col: col, row: Number(m[2]) };
+};
+/**
+ * Map XLSX subtotal/aggregator name to our PivotValueSummarizeFunction.
+ * XLSX uses `subtotal="sum"|"average"|...`; we map "average" → "avg".
+ */
+var normalizeAggFunc = function (raw) {
+    var _a;
+    var map = {
+        sum: "sum",
+        count: "counta",
+        countNums: "count",
+        average: "avg",
+        min: "min",
+        max: "max",
+        product: "product",
+        stdDev: "stddev",
+        stdDevp: "stddevp",
+        var: "var",
+        varp: "varp",
+    };
+    return (_a = map[raw !== null && raw !== void 0 ? raw : "sum"]) !== null && _a !== void 0 ? _a : "sum";
+};
+/**
+ * Parse one pivotCacheDefinition XML into a (sourceRange, fields) pair.
+ * Source range is resolved sheet-relative; the caller maps the sheet
+ * name to its numeric sheetId.
+ */
+var parsePivotCacheDefinition = function (cacheXml) {
+    var _a, _b, _c, _d, _e, _f;
+    var cacheDef = (_a = cacheXml === null || cacheXml === void 0 ? void 0 : cacheXml.pivotCacheDefinition) !== null && _a !== void 0 ? _a : cacheXml === null || cacheXml === void 0 ? void 0 : cacheXml["x:pivotCacheDefinition"];
+    if (!cacheDef)
+        return { fields: [] };
+    // cacheSource → worksheetSource@ref
+    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"]);
+    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 _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"];
+        var items = [];
+        if (sharedItemsNode) {
+            try {
+                for (var _q = __values(asArray((_f = sharedItemsNode.s) !== null && _f !== void 0 ? _f : sharedItemsNode["x:s"])), _r = _q.next(); !_r.done; _r = _q.next()) {
+                    var s = _r.value;
+                    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 }; }
+            finally {
+                try {
+                    if (_r && !_r.done && (_a = _q.return)) _a.call(_q);
+                }
+                finally { if (e_2) throw e_2.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()) {
+                    var n = _t.value;
+                    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 }; }
+            finally {
+                try {
+                    if (_t && !_t.done && (_b = _s.return)) _b.call(_s);
+                }
+                finally { if (e_3) throw e_3.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()) {
+                    var _1 = _v.value;
+                    items.push(null);
+                }
+            }
+            catch (e_4_1) { e_4 = { error: e_4_1 }; }
+            finally {
+                try {
+                    if (_v && !_v.done && (_c = _u.return)) _c.call(_u);
+                }
+                finally { if (e_4) throw e_4.error; }
+            }
+        }
+        return { name: name, sharedItems: items.length > 0 ? items : undefined };
+    });
+    return { sourceRef: sourceRef, fields: fields };
+};
+/**
+ * Parse a single pivotTable.xml into a PivotTable record. Needs the
+ * cacheDefinition pre-parsed so we can resolve field-name indices.
+ */
+var parsePivotTableXml = function (pivotXml, cacheDef, getSheetId, defaultSheetId, pivotId) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+    var pt = (_a = pivotXml === null || pivotXml === void 0 ? void 0 : pivotXml.pivotTableDefinition) !== null && _a !== void 0 ? _a : pivotXml === null || pivotXml === void 0 ? void 0 : pivotXml["x:pivotTableDefinition"];
+    if (!pt)
+        return null;
+    var name = ((_b = pt.a$) === null || _b === void 0 ? void 0 : _b.name) || pt["@_name"];
+    // location@ref → rendered range on the worksheet
+    var location = (_c = pt.location) !== null && _c !== void 0 ? _c : pt["x:location"];
+    var locRef = ((_d = location === null || location === void 0 ? void 0 : location.a$) === null || _d === void 0 ? void 0 : _d.ref) || (location === null || location === void 0 ? void 0 : location["@_ref"]);
+    var locRange = locRef ? parseA1Range(locRef) : null;
+    if (!locRange)
+        return null;
+    // Number of header rows / row-label columns gives us the data
+    // origin within the rendered range — but PivotTable only stores
+    // the target (top-left) and the full pivotRange.
+    var targetSheetId = defaultSheetId;
+    var targetPosition = {
+        sheetId: targetSheetId,
+        rowIndex: locRange.startRow,
+        columnIndex: locRange.startCol,
+    };
+    var pivotRange = {
+        sheetId: targetSheetId,
+        startRowIndex: locRange.startRow,
+        endRowIndex: locRange.endRow,
+        startColumnIndex: locRange.startCol,
+        endColumnIndex: locRange.endCol,
+    };
+    // Source range from cacheDef
+    var source;
+    if (cacheDef.sourceRef) {
+        var _l = stripSheetPrefix(cacheDef.sourceRef), sheet = _l.sheet, a1 = _l.a1;
+        var sourceRange = parseA1Range(a1);
+        if (sourceRange) {
+            var resolved = sheet ? getSheetId(sheet) : undefined;
+            var sId = typeof resolved === "number" ? resolved : targetSheetId;
+            source = {
+                sheetId: sId,
+                startRowIndex: sourceRange.startRow,
+                endRowIndex: sourceRange.endRow,
+                startColumnIndex: sourceRange.startCol,
+                endColumnIndex: sourceRange.endCol,
+            };
+        }
+    }
+    // Row + Column field axes — arrays of field indices into cacheFields.
+    var readAxis = function (key) {
+        var _a, _b;
+        var node = (_a = pt[key]) !== null && _a !== void 0 ? _a : pt["x:".concat(key)];
+        if (!node)
+            return [];
+        var fields = asArray((_b = node.field) !== null && _b !== void 0 ? _b : node["x:field"]);
+        return fields
+            .map(function (f) { var _a, _b; return Number((_b = (_a = f.a$) === null || _a === void 0 ? void 0 : _a.x) !== null && _b !== void 0 ? _b : f["@_x"]); })
+            .filter(function (n) { return Number.isFinite(n); });
+    };
+    var rowIndices = readAxis("rowFields");
+    var colIndices = readAxis("colFields");
+    // dataFields → value fields. Each has fld (cache-field index)
+    // and an optional subtotal aggregator.
+    var dataFieldsNode = (_e = pt.dataFields) !== null && _e !== void 0 ? _e : pt["x:dataFields"];
+    var dataFieldList = asArray((_f = dataFieldsNode === null || dataFieldsNode === void 0 ? void 0 : dataFieldsNode.dataField) !== null && _f !== void 0 ? _f : dataFieldsNode === null || dataFieldsNode === void 0 ? void 0 : dataFieldsNode["x:dataField"]);
+    var fieldNameAt = function (idx) { var _a; return (_a = cacheDef.fields[idx]) === null || _a === void 0 ? void 0 : _a.name; };
+    var rows = rowIndices
+        .map(function (idx) { return fieldNameAt(idx); })
+        .filter(function (n) { return !!n && n !== "Values" && n !== ""; })
+        .map(function (field) { return ({ field: field, displayName: field }); });
+    var columns = colIndices
+        .map(function (idx) { return fieldNameAt(idx); })
+        .filter(function (n) { return !!n && n !== "Values" && n !== ""; })
+        .map(function (field) { return ({ field: field, displayName: field }); });
+    var values = dataFieldList
+        .map(function (d) {
+        var _a, _b, _c, _d;
+        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 };
+    })
+        .filter(function (v) { return v !== null; });
+    // 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,
+        // Subtotal default on individual fields → leave true.
+        showSubtotals: true,
+    };
+};
+/**
+ * Top-level: parse every pivotTable referenced by a worksheet's
+ * relationships. Returns a flat PivotTable[] (host attaches them
+ * 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 _c, _d;
+    return __generator(this, function (_e) {
+        switch (_e.label) {
+            case 0:
+                zipParser = options.zipParser, xmlParser = options.xmlParser, sheetRels = options.sheetRels, nextPivotId = options.nextPivotId, getSheetId = options.getSheetId, defaultSheetId = options.defaultSheetId;
+                out = [];
+                _e.label = 1;
+            case 1:
+                _e.trys.push([1, 11, 12, 13]);
+                sheetRels_1 = __values(sheetRels), sheetRels_1_1 = sheetRels_1.next();
+                _e.label = 2;
+            case 2:
+                if (!!sheetRels_1_1.done) return [3 /*break*/, 10];
+                rel = sheetRels_1_1.value;
+                pivotTablePath = rel.target.startsWith("/")
+                    ? rel.target.slice(1)
+                    : rel.target.startsWith("../")
+                        ? "xl/".concat(rel.target.slice(3))
+                        : "xl/worksheets/".concat(rel.target);
+                return [4 /*yield*/, zipParser.getText(pivotTablePath)];
+            case 3:
+                pivotTableXmlText = _e.sent();
+                if (!pivotTableXmlText)
+                    return [3 /*break*/, 9];
+                pivotXml = xmlParser.parse(pivotTableXmlText);
+                pivotDir = pivotTablePath.substring(0, pivotTablePath.lastIndexOf("/"));
+                fileName = pivotTablePath.split("/").pop();
+                pivotRelsPath = "".concat(pivotDir, "/_rels/").concat(fileName, ".rels");
+                return [4 /*yield*/, zipParser.getText(pivotRelsPath)];
+            case 4:
+                pivotRelsText = _e.sent();
+                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);
+                cacheRel = relList.find(function (r) {
+                    var _a;
+                    var type = ((_a = r.a$) === null || _a === void 0 ? void 0 : _a.Type) || r["@_Type"] || "";
+                    return type.endsWith("pivotCacheDefinition");
+                });
+                if (!cacheRel) return [3 /*break*/, 8];
+                cachePath = ((_d = cacheRel.a$) === null || _d === void 0 ? void 0 : _d.Target) || cacheRel["@_Target"];
+                if (cachePath === null || cachePath === void 0 ? void 0 : cachePath.startsWith("../")) {
+                    cachePath = "xl/".concat(cachePath.slice(3));
+                }
+                else if (cachePath === null || cachePath === void 0 ? void 0 : cachePath.startsWith("/")) {
+                    cachePath = cachePath.slice(1);
+                }
+                else if (cachePath && !cachePath.startsWith("xl/")) {
+                    cachePath = "".concat(pivotDir, "/").concat(cachePath);
+                }
+                if (!cachePath) return [3 /*break*/, 6];
+                return [4 /*yield*/, zipParser.getText(cachePath)];
+            case 5:
+                _a = _e.sent();
+                return [3 /*break*/, 7];
+            case 6:
+                _a = undefined;
+                _e.label = 7;
+            case 7:
+                cacheText = _a;
+                if (cacheText) {
+                    cacheDef = parsePivotCacheDefinition(xmlParser.parse(cacheText));
+                }
+                _e.label = 8;
+            case 8:
+                pivot = parsePivotTableXml(pivotXml, cacheDef, getSheetId, defaultSheetId, nextPivotId());
+                if (pivot)
+                    out.push(pivot);
+                _e.label = 9;
+            case 9:
+                sheetRels_1_1 = sheetRels_1.next();
+                return [3 /*break*/, 2];
+            case 10: return [3 /*break*/, 13];
+            case 11:
+                e_5_1 = _e.sent();
+                e_5 = { error: e_5_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; }
+                return [7 /*endfinally*/];
+            case 13: return [2 /*return*/, out];
+        }
+    });
+}); };

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

@@ -0,0 +1,8 @@
+export interface Relationship {
+    id: string;
+    type: string;
+    target: string;
+    mode?: string;
+}
+export declare const getRelationsById: (xml: any) => Record<string, Relationship>;
+//# sourceMappingURL=relationships.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"relationships.d.ts","sourceRoot":"","sources":["../../../../../excel-parser/plugins/xlsx/relationships.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,gBAAgB,GAAI,KAAK,GAAG,iCAaxC,CAAC"}

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

@@ -0,0 +1,26 @@
+import { __values } from "tslib";
+export var getRelationsById = function (xml) {
+    var e_1, _a;
+    var _b;
+    var rels = {};
+    try {
+        for (var _c = __values(((_b = xml.Relationships) === null || _b === void 0 ? void 0 : _b.Relationship) || []), _d = _c.next(); !_d.done; _d = _c.next()) {
+            var relationship = _d.value;
+            var id = relationship.a$.Id;
+            rels[id] = {
+                id: id,
+                type: relationship.a$.Type,
+                target: relationship.a$.Target,
+                mode: relationship.a$.TargetMode,
+            };
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (_d && !_d.done && (_a = _c.return)) _a.call(_c);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    return rels;
+};

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

@@ -0,0 +1,26 @@
+/**
+ * Extracts view properties from Excel sheet view data:
+ *   - frozen rows / columns count
+ *   - showGridLines (gridline visibility)
+ *   - showRowColHeaders (row/column header visibility)
+ *   - showZeros (whether zero values render in cells)
+ *   - zoomScale (integer percent, 10-400; undefined = use Excel default 100)
+ *
+ * Works with both single sheet view and multiple sheet views.
+ *
+ * Defaults match Excel's defaults when the attribute is absent:
+ *   showGridLines = true, showRowColHeaders = true, showZeros = true,
+ *   zoomScale = undefined (consumers should treat as 100).
+ */
+export type SheetViewProperties = {
+    frozenRowCount: number;
+    frozenColumnCount: number;
+    /** Saved scroll position of the unfrozen pane (`<pane topLeftCell>`). */
+    paneTopLeftCell?: string;
+    showGridLines: boolean;
+    showRowColHeaders: boolean;
+    showZeros: boolean;
+    zoomScale?: number;
+};
+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

@@ -0,0 +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"}

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

@@ -0,0 +1,59 @@
+import { __assign } from "tslib";
+var isFalseAttr = function (val) {
+    return val === "0" || val === "false" || val === false;
+};
+export function extractSheetViewProperties(sheetViewData) {
+    var defaults = {
+        frozenRowCount: 0,
+        frozenColumnCount: 0,
+        showGridLines: true,
+        showRowColHeaders: true,
+        showZeros: true,
+    };
+    if (!sheetViewData)
+        return defaults;
+    // Handle multiple sheet views (array of sheet views)
+    var sheetViews = Array.isArray(sheetViewData)
+        ? sheetViewData
+        : "sheetViews" in sheetViewData
+            ? Array.isArray(sheetViewData.sheetViews)
+                ? sheetViewData.sheetViews
+                : [sheetViewData.sheetViews]
+            : [sheetViewData];
+    var firstView = sheetViews[0];
+    var sheetView = "sheetView" in firstView ? firstView.sheetView : firstView;
+    var frozenRowCount = 0;
+    var frozenColumnCount = 0;
+    var paneTopLeftCell;
+    // Process pane information if available
+    if (sheetView.pane) {
+        var pane = sheetView.pane.a$ || sheetView.pane;
+        if (pane.ySplit) {
+            frozenRowCount = parseInt(pane.ySplit, 10);
+        }
+        if (pane.xSplit) {
+            frozenColumnCount = parseInt(pane.xSplit, 10);
+        }
+        if (pane.state !== "frozen" && pane.state !== "frozenSplit") {
+            frozenRowCount = 0;
+            frozenColumnCount = 0;
+        }
+        else if (typeof pane.topLeftCell === "string" && pane.topLeftCell) {
+            // The saved scroll position of the unfrozen quadrant. Preserved so an
+            // untouched import/export doesn't snap the view back to the freeze
+            // anchor.
+            paneTopLeftCell = pane.topLeftCell;
+        }
+    }
+    var viewAttrs = sheetView.a$ || {};
+    // zoomScale: Excel clamps to 10-400. Omit (= use default) when absent
+    // or out of range, so we don't lie about what the file contained.
+    var zoomScale;
+    if (viewAttrs.zoomScale != null && viewAttrs.zoomScale !== "") {
+        var parsed = parseInt(String(viewAttrs.zoomScale), 10);
+        if (Number.isFinite(parsed) && parsed >= 10 && parsed <= 400) {
+            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 } : {}));
+}

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

@@ -0,0 +1,44 @@
+import type { GridRange } from "@rowsncolumns/common-types";
+import type { CellData, Color, ExtendedValue, TextFormat } from "@rowsncolumns/spreadsheet";
+import type { WorkBook } from "../../workbook";
+import type { WorkbookStyles } from "./index";
+type MergeCellContext = {
+    range: GridRange;
+    rowCellsByColumnIndex: Map<number, any>;
+};
+/**
+ * Extract cell value and format information from Excel cell data
+ * @param {Object} cell - The cell object from the sheet data
+ * @param {WorkBook} workbook - The workbook object containing shared strings
+ * @returns {Object} Object containing value and cellFormat properties
+ */
+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
+ * its row (`<row customFormat="1" s="N">`) or column (`<col style="N">`)
+ * rather than carrying itself. Excel paints such styles across every cell
+ * of the row/column even where no `<c>` element exists, so the importer
+ * materializes them as phantom cells. Returns null when the style resolves
+ * to an empty format (nothing to paint or inherit).
+ */
+export declare function getCellDataForStyleIndex(styleIndex: number, workbook: WorkBook, enableCellXfsRegistry?: boolean): CellData | null;
+export declare const getExtendedValue: (rawValue: any) => ExtendedValue | undefined;
+/**
+ * Resolve the xf for a cell and extract its protection flags. Returns
+ * undefined when the cell has no style or the style is at Excel defaults.
+ */
+export declare function extractCellProtection(cell: any, workbookStyles: WorkbookStyles): {
+    locked?: boolean;
+    hidden?: boolean;
+} | undefined;
+/**
+ * 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.
+ */
+export declare function fontNodeToTextFormat(font: any, workbookStyles: WorkbookStyles): TextFormat | null;
+/**
+ * Extract color information
+ */
+export declare function extractColor(colorObj: any, indexedColors?: Array<string | undefined>): Color | undefined | null;
+export {};
+//# sourceMappingURL=styles.d.ts.map

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

@@ -0,0 +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"}