@rowsncolumns/toolkit 24.5.4 → 24.5.6

package/dist/cjs/exporter/xlsx/future-functions.js

@@ -1,264 +1,8 @@
-import { __read, __spreadArray } from "tslib";
 /**
  * Excel "future functions" — functions added after the Excel 2007 (.xlsx)
- * file format was frozen. [MS-XLSX] requires them to be written into sheet
- * XML behind a `_xlfn.` namespace prefix (`_xlfn._xlws.` for the
- * worksheet-scoped dynamic-array functions); the UI never shows the prefix.
- * Written bare, Excel does not resolve the name: it renders the call behind
- * the implicit-intersection operator (`=@DAYS(...)`) and evaluates `#NAME?`.
- *
- * The list follows Microsoft's documentation of `_xlfn.`-prefixed functions
- * ("Issue: An _xlfn. prefix is displayed in front of a function in a
- * formula", support.microsoft.com) plus the dynamic-array / LAMBDA-era and
- * 2024 additions that ship with the same prefix convention.
+ * file format was frozen — must be written into sheet XML behind a `_xlfn.`
+ * namespace prefix. The list and both directions of the transform live in
+ * `helpers/excel-formula-prefixes` (the importer strips what the exporter
+ * adds); this module keeps the exporter-side entry point.
  */
-var FUTURE_FUNCTION_NAMES = [
-    "ACOT",
-    "ACOTH",
-    "AGGREGATE",
-    "ANCHORARRAY",
-    "ARABIC",
-    "ARRAYTOTEXT",
-    "BASE",
-    "BETA.DIST",
-    "BETA.INV",
-    "BINOM.DIST",
-    "BINOM.DIST.RANGE",
-    "BINOM.INV",
-    "BITAND",
-    "BITLSHIFT",
-    "BITOR",
-    "BITRSHIFT",
-    "BITXOR",
-    "BYCOL",
-    "BYROW",
-    "CEILING.MATH",
-    "CEILING.PRECISE",
-    "CHISQ.DIST",
-    "CHISQ.DIST.RT",
-    "CHISQ.INV",
-    "CHISQ.INV.RT",
-    "CHISQ.TEST",
-    "CHOOSECOLS",
-    "CHOOSEROWS",
-    "COMBINA",
-    "CONCAT",
-    "CONFIDENCE.NORM",
-    "CONFIDENCE.T",
-    "COT",
-    "COTH",
-    "COVARIANCE.P",
-    "COVARIANCE.S",
-    "CSC",
-    "CSCH",
-    "DAYS",
-    "DECIMAL",
-    "DETECTLANGUAGE",
-    "DROP",
-    "ENCODEURL",
-    "ERF.PRECISE",
-    "ERFC.PRECISE",
-    "EXPAND",
-    "EXPON.DIST",
-    "F.DIST",
-    "F.DIST.RT",
-    "F.INV",
-    "F.INV.RT",
-    "F.TEST",
-    "FIELDVALUE",
-    "FILTER",
-    "FILTERXML",
-    "FLOOR.MATH",
-    "FLOOR.PRECISE",
-    "FORECAST.ETS",
-    "FORECAST.ETS.CONFINT",
-    "FORECAST.ETS.SEASONALITY",
-    "FORECAST.ETS.STAT",
-    "FORECAST.LINEAR",
-    "FORMULATEXT",
-    "GAMMA",
-    "GAMMA.DIST",
-    "GAMMA.INV",
-    "GAMMALN.PRECISE",
-    "GAUSS",
-    "GROUPBY",
-    "HSTACK",
-    "HYPGEOM.DIST",
-    "IFNA",
-    "IFS",
-    "IMAGE",
-    "IMCOSH",
-    "IMCOT",
-    "IMCSC",
-    "IMCSCH",
-    "IMSEC",
-    "IMSECH",
-    "IMSINH",
-    "IMTAN",
-    "ISFORMULA",
-    "ISOMITTED",
-    "ISOWEEKNUM",
-    "LAMBDA",
-    "LET",
-    "LOGNORM.DIST",
-    "LOGNORM.INV",
-    "MAKEARRAY",
-    "MAP",
-    "MAXIFS",
-    "MINIFS",
-    "MODE.MULT",
-    "MODE.SNGL",
-    "MUNIT",
-    "NEGBINOM.DIST",
-    "NETWORKDAYS.INTL",
-    "NORM.DIST",
-    "NORM.INV",
-    "NORM.S.DIST",
-    "NORM.S.INV",
-    "NUMBERVALUE",
-    "PDURATION",
-    "PERCENTILE.EXC",
-    "PERCENTILE.INC",
-    "PERCENTOF",
-    "PERCENTRANK.EXC",
-    "PERCENTRANK.INC",
-    "PERMUTATIONA",
-    "PHI",
-    "PIVOTBY",
-    "POISSON.DIST",
-    "QUARTILE.EXC",
-    "QUARTILE.INC",
-    "QUERYSTRING",
-    "RANDARRAY",
-    "RANK.AVG",
-    "RANK.EQ",
-    "REDUCE",
-    "REGEXEXTRACT",
-    "REGEXREPLACE",
-    "REGEXTEST",
-    "RRI",
-    "SCAN",
-    "SEC",
-    "SECH",
-    "SEQUENCE",
-    "SHEET",
-    "SHEETS",
-    "SINGLE",
-    "SKEW.P",
-    "SORT",
-    "SORTBY",
-    "STDEV.P",
-    "STDEV.S",
-    "STOCKHISTORY",
-    "SWITCH",
-    "T.DIST",
-    "T.DIST.2T",
-    "T.DIST.RT",
-    "T.INV",
-    "T.INV.2T",
-    "T.TEST",
-    "TAKE",
-    "TEXTAFTER",
-    "TEXTBEFORE",
-    "TEXTJOIN",
-    "TEXTSPLIT",
-    "TOCOL",
-    "TOROW",
-    "TRANSLATE",
-    "TRIMRANGE",
-    "UNICHAR",
-    "UNICODE",
-    "UNIQUE",
-    "VALUETOTEXT",
-    "VAR.P",
-    "VAR.S",
-    "VSTACK",
-    "WEBSERVICE",
-    "WEIBULL.DIST",
-    "WORKDAY.INTL",
-    "WRAPCOLS",
-    "WRAPROWS",
-    "XLOOKUP",
-    "XMATCH",
-    "XOR",
-    "Z.TEST",
-];
-/**
- * Future functions that Excel writes behind the worksheet-scope prefix
- * (`_xlfn._xlws.`) rather than plain `_xlfn.` — the dynamic-array functions
- * that also exist as worksheet-only names.
- */
-var WORKSHEET_SCOPED_FUTURE_FUNCTIONS = new Set([
-    "FILTER",
-    "SORT",
-]);
-var QUALIFIED_BY_NAME = new Map(FUTURE_FUNCTION_NAMES.map(function (name) { return [
-    name,
-    WORKSHEET_SCOPED_FUTURE_FUNCTIONS.has(name)
-        ? "_xlfn._xlws.".concat(name)
-        : "_xlfn.".concat(name),
-]; }));
-// Longest names first so `T.DIST.2T` wins over `T.DIST`. The match must be
-// followed by `(` — a bare name (e.g. the defined name `DAYS`) is not a call.
-var FUTURE_FUNCTION_REGEX = new RegExp("(" +
-    __spreadArray([], __read(FUTURE_FUNCTION_NAMES), false).sort(function (a, b) { return b.length - a.length; })
-        .map(function (name) { return name.replace(/\./g, "\\."); })
-        .join("|") +
-    ")(\\s*\\()", "gi");
-// `\b` is not enough of a left boundary: it would match the `DAYS` in
-// `_xlfn.DAYS` and in `MYDAYS`. The preceding character is checked by offset
-// instead of being consumed by the pattern, so nested calls
-// (`SORT(FILTER(...))`) still match after the enclosing one.
-var FUTURE_FUNCTION_LEFT_BOUNDARY = /[A-Za-z0-9_.$]/;
-function qualifySegment(segment) {
-    var stripped = segment
-        .replace(/_xlfn\./gi, "")
-        .replace(/_xlws\./gi, "")
-        .replace(/_xludf\./gi, "");
-    return stripped.replace(FUTURE_FUNCTION_REGEX, function (match, name, open, offset) {
-        if (offset > 0 &&
-            FUTURE_FUNCTION_LEFT_BOUNDARY.test(stripped[offset - 1])) {
-            return match;
-        }
-        var qualified = QUALIFIED_BY_NAME.get(name.toUpperCase());
-        return qualified ? qualified + open : match;
-    });
-}
-/**
- * Strip the `_xlfn.` / `_xlws.` / `_xludf.` prefixes and re-add the correct
- * one to every future-function call in `formula`. Quoted spans are copied
- * verbatim so string literals (`"…"`) and quoted sheet names (`'…'`) keep
- * their original text; a doubled quote inside a span is an escaped quote.
- * Because the strip pass runs first, already-qualified input comes out
- * qualified exactly once.
- */
-export function qualifyFutureFunctions(formula) {
-    var result = "";
-    var segmentStart = 0;
-    var index = 0;
-    while (index < formula.length) {
-        var char = formula[index];
-        if (char !== '"' && char !== "'") {
-            index++;
-            continue;
-        }
-        result += qualifySegment(formula.slice(segmentStart, index));
-        var end = index + 1;
-        while (end < formula.length) {
-            if (formula[end] === char) {
-                if (formula[end + 1] === char) {
-                    end += 2;
-                    continue;
-                }
-                break;
-            }
-            end++;
-        }
-        // An unterminated literal consumes the rest of the formula.
-        var literalEnd = end < formula.length ? end + 1 : formula.length;
-        result += formula.slice(index, literalEnd);
-        index = literalEnd;
-        segmentStart = literalEnd;
-    }
-    return result + qualifySegment(formula.slice(segmentStart));
-}
+export { FUTURE_FUNCTION_NAMES, WORKSHEET_SCOPED_FUTURE_FUNCTIONS, qualifyFutureFunctions, } from "../../helpers/excel-formula-prefixes";

package/dist/cjs/exporter/xlsx/style-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"style-builder.d.ts","sourceRoot":"","sources":["../../../../exporter/xlsx/style-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,QAAQ,EACR,UAAU,EACV,KAAK,EAEL,UAAU,EACV,gBAAgB,EAEjB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAwF/D,KAAK,oBAAoB,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAKF,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,eAAe,CAAC,EAAE,KAAK,CAAC;QACxB,SAAS,CAAC,EAAE,KAAK,CAAC;QAClB,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC,CAAC;CACJ,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,GACxC,aAAa,gBAAgB,KAC5B,sBAAsB,CAAC,UAAU,CAqBnC,CAAC;AAEF,qBAAa,YAAY;IACvB,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,KAAK,CAKX;IACF,OAAO,CAAC,KAAK,CAA+D;IAC5E,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,eAAe,CAErB;IACF,OAAO,CAAC,iBAAiB,CAAgC;IAEzD;;;;;;;;;;;OAWG;IACH,kBAAkB,CAAC,OAAO,EAAE,oBAAoB,EAAE;IAUlD;;;;;;;OAOG;IACH,oBAAoB,CAAC,OAAO,EAAE,sBAAsB,EAAE;IAOtD,OAAO,CAAC,OAAO,CAOb;IAEF,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,IAAI,CAAmB;IAC/B,OAAO,CAAC,MAAM,CAA6B;;IAU3C;;;;;;;OAOG;IACH,cAAc,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI;IASzC,YAAY,CAAC,CAAC,SAAS,QAAQ,EAC7B,IAAI,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EAC1B,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS;IACnC;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,UAAU,CAAC,cAAc,CAAC,GAC/C,MAAM;IAsET,0BAA0B,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI;IA0BrD,OAAO,CAAC,iBAAiB;IAoCzB,OAAO,CAAC,SAAS;IAcjB,OAAO,CAAC,SAAS;IA2DjB,OAAO,CAAC,WAAW;IA2BnB,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,eAAe;IA8BvB,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,YAAY;IAqCpB,OAAO,CAAC,oBAAoB;IAyB5B,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,YAAY;IAMpB,KAAK;CAuJN"}
+{"version":3,"file":"style-builder.d.ts","sourceRoot":"","sources":["../../../../exporter/xlsx/style-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,QAAQ,EACR,UAAU,EACV,KAAK,EAEL,UAAU,EACV,gBAAgB,EAEjB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,iCAAiC,CAAC;AA4F/D,KAAK,oBAAoB,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAKF,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,eAAe,CAAC,EAAE,KAAK,CAAC;QACxB,SAAS,CAAC,EAAE,KAAK,CAAC;QAClB,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC,CAAC;CACJ,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,GACxC,aAAa,gBAAgB,KAC5B,sBAAsB,CAAC,UAAU,CAqBnC,CAAC;AAEF,qBAAa,YAAY;IACvB,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,KAAK,CAKX;IACF,OAAO,CAAC,KAAK,CAA+D;IAC5E,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,eAAe,CAErB;IACF,OAAO,CAAC,iBAAiB,CAAgC;IAEzD;;;;;;;;;;;OAWG;IACH,kBAAkB,CAAC,OAAO,EAAE,oBAAoB,EAAE;IAUlD;;;;;;;OAOG;IACH,oBAAoB,CAAC,OAAO,EAAE,sBAAsB,EAAE;IAOtD,OAAO,CAAC,OAAO,CAOb;IAEF,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,IAAI,CAAmB;IAC/B,OAAO,CAAC,MAAM,CAA6B;;IAU3C;;;;;;;OAOG;IACH,cAAc,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI;IASzC,YAAY,CAAC,CAAC,SAAS,QAAQ,EAC7B,IAAI,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EAC1B,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS;IACnC;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,UAAU,CAAC,cAAc,CAAC,GAC/C,MAAM;IAsET,0BAA0B,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI;IAsCrD,OAAO,CAAC,iBAAiB;IAoCzB,OAAO,CAAC,SAAS;IAcjB,OAAO,CAAC,SAAS;IA2DjB,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,eAAe;IA8BvB,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,YAAY;IAqCpB,OAAO,CAAC,oBAAoB;IAyB5B,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,YAAY;IAQpB,KAAK;CA6JN"}

package/dist/cjs/exporter/xlsx/style-builder.js

@@ -180,6 +180,7 @@ var StyleBuilder = /** @class */ (function () {
         return nextId;
     };
     StyleBuilder.prototype.registerDifferentialFormat = function (format) {
+        var _a;
         if (!format)
             return undefined;
         var record = {};
@@ -192,7 +193,19 @@ var StyleBuilder = /** @class */ (function () {
         if (font) {
             record.font = font;
         }
-        if (!record.fill && !record.font) {
+        // A rule may set ONLY a border and/or a number format (Excel's Format
+        // Cells → Border / Number tabs) — that is a normal rule with a normal
+        // dxf, not an empty record to drop.
+        var border = buildBorderRecord(format.borders);
+        if (hasBorderEdge(border)) {
+            record.border = border;
+        }
+        var numFmtId = this.getNumberFormatId(format);
+        var numFmtPattern = (_a = format.numberFormat) === null || _a === void 0 ? void 0 : _a.pattern;
+        if (numFmtId !== 0 && numFmtPattern) {
+            record.numFmt = { id: numFmtId, format: numFmtPattern };
+        }
+        if (!record.fill && !record.font && !record.border && !record.numFmt) {
             return undefined;
         }
         var key = this.serializeDxf(record);
@@ -310,22 +323,7 @@ var StyleBuilder = /** @class */ (function () {
         return nextId;
     };
     StyleBuilder.prototype.getBorderId = function (borders) {
-        var _a;
-        // OOXML uses a single <diagonal> child plus diagonalUp/diagonalDown
-        // attributes. If both diagonals are present and identically styled the
-        // first non-null one defines the edge; otherwise each flag is set
-        // independently and both share the same painted style. This matches
-        // how Excel collapses diagonal pairs.
-        var diagonalEdge = convertBorderEdge((_a = borders === null || borders === void 0 ? void 0 : borders.diagonalUp) !== null && _a !== void 0 ? _a : borders === null || borders === void 0 ? void 0 : borders.diagonalDown);
-        var record = {
-            top: convertBorderEdge(borders === null || borders === void 0 ? void 0 : borders.top),
-            bottom: convertBorderEdge(borders === null || borders === void 0 ? void 0 : borders.bottom),
-            left: convertBorderEdge(borders === null || borders === void 0 ? void 0 : borders.left),
-            right: convertBorderEdge(borders === null || borders === void 0 ? void 0 : borders.right),
-            diagonal: diagonalEdge,
-            diagonalUp: !!(borders === null || borders === void 0 ? void 0 : borders.diagonalUp),
-            diagonalDown: !!(borders === null || borders === void 0 ? void 0 : borders.diagonalDown),
-        };
+        var record = buildBorderRecord(borders);
         var key = this.serializeBorder(record);
         var existing = this.borderMap.get(key);
         if (typeof existing === "number") {
@@ -464,7 +462,7 @@ var StyleBuilder = /** @class */ (function () {
         ].join("|");
     };
     StyleBuilder.prototype.serializeDxf = function (dxf) {
-        return "".concat(dxf.fill ? this.serializeFill(dxf.fill) : "", "|").concat(dxf.font ? this.serializeFont(dxf.font) : "");
+        return "".concat(dxf.fill ? this.serializeFill(dxf.fill) : "", "|").concat(dxf.font ? this.serializeFont(dxf.font) : "", "|").concat(dxf.border ? this.serializeBorder(dxf.border) : "", "|").concat(dxf.numFmt ? dxf.numFmt.id : "");
     };
     StyleBuilder.prototype.toXml = function () {
         var _this = this;
@@ -553,8 +551,12 @@ var StyleBuilder = /** @class */ (function () {
             ? "<dxfs count=\"".concat(this.dxfs.length, "\">").concat(this.dxfs
                 .map(function (dxf) {
                 var font = dxf.font ? _this.buildFontXml(dxf.font) : "";
+                var numFmt = dxf.numFmt
+                    ? "<numFmt numFmtId=\"".concat(dxf.numFmt.id, "\" formatCode=\"").concat(escapeXml(dxf.numFmt.format), "\"/>")
+                    : "";
                 var fill = dxf.fill ? _this.buildFillXml(dxf.fill, true) : "";
-                return "<dxf>".concat(font).concat(fill, "</dxf>");
+                var border = dxf.border ? buildDxfBorderXml(dxf.border) : "";
+                return "<dxf>".concat(font).concat(numFmt).concat(fill).concat(border, "</dxf>");
             })
                 .join(""), "</dxfs>")
             : "<dxfs count=\"0\"/>";
@@ -598,6 +600,47 @@ var StyleBuilder = /** @class */ (function () {
     return StyleBuilder;
 }());
 export { StyleBuilder };
+// OOXML uses a single <diagonal> child plus diagonalUp/diagonalDown
+// attributes. If both diagonals are present and identically styled the
+// first non-null one defines the edge; otherwise each flag is set
+// independently and both share the same painted style. This matches
+// how Excel collapses diagonal pairs.
+var buildBorderRecord = function (borders) {
+    var _a;
+    var diagonalEdge = convertBorderEdge((_a = borders === null || borders === void 0 ? void 0 : borders.diagonalUp) !== null && _a !== void 0 ? _a : borders === null || borders === void 0 ? void 0 : borders.diagonalDown);
+    return {
+        top: convertBorderEdge(borders === null || borders === void 0 ? void 0 : borders.top),
+        bottom: convertBorderEdge(borders === null || borders === void 0 ? void 0 : borders.bottom),
+        left: convertBorderEdge(borders === null || borders === void 0 ? void 0 : borders.left),
+        right: convertBorderEdge(borders === null || borders === void 0 ? void 0 : borders.right),
+        diagonal: diagonalEdge,
+        diagonalUp: !!(borders === null || borders === void 0 ? void 0 : borders.diagonalUp),
+        diagonalDown: !!(borders === null || borders === void 0 ? void 0 : borders.diagonalDown),
+    };
+};
+var hasBorderEdge = function (border) {
+    var _a, _b, _c, _d, _e;
+    return Boolean(((_a = border.top) === null || _a === void 0 ? void 0 : _a.style) ||
+        ((_b = border.bottom) === null || _b === void 0 ? void 0 : _b.style) ||
+        ((_c = border.left) === null || _c === void 0 ? void 0 : _c.style) ||
+        ((_d = border.right) === null || _d === void 0 ? void 0 : _d.style) ||
+        ((_e = border.diagonal) === null || _e === void 0 ? void 0 : _e.style));
+};
+// A dxf `<border>` lists only the edges the rule sets: unlike a cell
+// border, an empty `<left/>` in a differential format would mean "remove
+// the left border", not "leave it alone".
+var buildDxfBorderXml = function (border) {
+    var _a;
+    var edges = ["left", "right", "top", "bottom"]
+        .filter(function (side) { var _a; return (_a = border[side]) === null || _a === void 0 ? void 0 : _a.style; })
+        .map(function (side) { return serializeBorderEdgeXml(border[side], side); })
+        .join("");
+    var diagonal = ((_a = border.diagonal) === null || _a === void 0 ? void 0 : _a.style)
+        ? serializeBorderEdgeXml(border.diagonal, "diagonal")
+        : "";
+    var diagonalAttrs = "".concat(border.diagonalUp ? " diagonalUp=\"1\"" : "").concat(border.diagonalDown ? " diagonalDown=\"1\"" : "");
+    return "<border".concat(diagonalAttrs, ">").concat(edges).concat(diagonal, "</border>");
+};
 var convertBorderEdge = function (border) {
     var _a;
     if (!border || !border.style)

package/dist/cjs/exporter/xlsx/xlsx-export.d.ts

@@ -1,5 +1,5 @@
 import type { CellData, Citation, CommentThread, DataValidationRuleRecord, IterativeCalculationOptions, SheetData, TextFormat } from "@rowsncolumns/common-types";
-import type { Color, ConditionalFormatRule, EmbeddedChart, EmbeddedObject, NamedRange, PivotTable, ProtectedRange, Sheet, Slicer, SpreadsheetTheme, TableView, CustomTableStyle } from "@rowsncolumns/spreadsheet";
+import type { Color, ConditionalFormatRule, EmbeddedChart, EmbeddedObject, NamedRange, PivotTable, ProtectedRange, Sheet, WorkbookProtection, Slicer, SpreadsheetTheme, TableView, CustomTableStyle } from "@rowsncolumns/spreadsheet";
 import type { CellXfs, SharedStrings as SharedStringsType } from "@rowsncolumns/spreadsheet-state";
 import type { PowerQueryParts } from "../../power-query";
 import type { ExternalLink, WorkbookProperties } from "../../excel-parser/types";
@@ -83,6 +83,14 @@ export type ExportExcelProps<S extends Sheet, T extends CellData, C extends Cita
         }>;
     }>;
     iterativeCalculationOptions?: IterativeCalculationOptions;
+    /**
+     * Excel "Protect Workbook" — written as `<workbookProtection …/>` right after
+     * `<workbookPr>` in `xl/workbook.xml` (structure / windows / revision locks
+     * plus the source's password hash, verbatim). Omitted ⇒ no element, Excel's
+     * unprotected workbook. The parser's `getWorkbookProtection()` is the source
+     * on a round trip.
+     */
+    workbookProtection?: WorkbookProtection;
     ignoreFormulaPatterns?: RegExp | RegExp[];
     citations?: Citation[];
     /**
@@ -118,7 +126,7 @@ export type ExportExcelProps<S extends Sheet, T extends CellData, C extends Cita
      */
     properties?: WorkbookProperties;
 };
-export declare const createExcelFile: <S extends Sheet, T extends CellData, C extends Citation>({ conditionalFormats: _conditionalFormats, dataValidations: _dataValidations, sheets, sheetData, sharedStrings: sourceSharedStrings, tables: _tables, cellXfs, theme, defaultFont, embeds, charts, slicers, pivotTables, externalLinks, namedRanges, protectedRanges, namedCellStyles, customTableStyles, iterativeCalculationOptions, ignoreFormulaPatterns, citations, comments, password, locale, use1904, properties, powerQuery, }: ExportExcelProps<S, T, C>) => Promise<Uint8Array<ArrayBufferLike>>;
+export declare const createExcelFile: <S extends Sheet, T extends CellData, C extends Citation>({ conditionalFormats: _conditionalFormats, dataValidations: _dataValidations, sheets, sheetData, sharedStrings: sourceSharedStrings, tables: _tables, cellXfs, theme, defaultFont, embeds, charts, slicers, pivotTables, externalLinks, namedRanges, protectedRanges, namedCellStyles, customTableStyles, iterativeCalculationOptions, workbookProtection, ignoreFormulaPatterns, citations, comments, password, locale, use1904, properties, powerQuery, }: ExportExcelProps<S, T, C>) => Promise<Uint8Array<ArrayBufferLike>>;
 /**
  * Normalize a dataValidation sqref list: collapse degenerate ranges
  * (`C7:C7` → `C7`), drop exact duplicates, and drop members fully contained

package/dist/cjs/exporter/xlsx/xlsx-export.d.ts.map

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