@rowsncolumns/toolkit 24.5.1 → 24.5.4

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

@@ -2,15 +2,17 @@ import type { GridRange } from "@rowsncolumns/common-types";
 import type { Column, FilterSpec, SortSpecs, TableTotalsRowFunction } from "@rowsncolumns/spreadsheet";
 export declare const getRangeFromAddressRef: (ref: string) => GridRange | undefined;
 /**
- * Convert an xlsx column width (in units of max-digit-width of the
- * default workbook font, Calibri 11 → MDW=7px) to pixels.
+ * OOXML `<col width>` (and `<sheetFormatPr defaultColWidth>`) → pixels.
  *
- * Excel's effective rendered pixel count includes a 5-pixel padding
- * baked into the column box: `pixels = floor(width × MDW + padding)`.
- * The default width "8.43" renders as 64 px (8.43 × 7 + 5 ≈ 64.01),
- * matching Excel exactly. The "pure" ECMA-376 §18.3.1.13 formula omits
- * the 5px padding; we keep the +5 form so our pixel output matches
- * Excel's rendered widths and round-trips with our exporter.
+ * The stored width is already in *padded* character units: Excel writes
+ * `Truncate((chars × MDW + 5) / MDW × 256) / 256` — the default 8.43-character
+ * column is stored as 9.140625 — and renders it back as
+ * `Truncate(((256 × width + Truncate(128 / MDW)) / 256) × MDW)`
+ * (ECMA-376 §18.3.1.13), i.e. 9.140625 → 64 px. Adding the 5 px padding a
+ * second time (the previous `floor(width × 7 + 5)`) drew every Excel-authored
+ * column ~5 px wider than Excel does and grew widths by 0.71 characters per
+ * import/export cycle (the exporter stores `px / 7`). MDW is 7 px for the
+ * Calibri 11 / Aptos Narrow 12 defaults at 96 dpi.
  */
 export declare function excelColumnWidthToPixels(width: number): number;
 export declare function findMax(arr: number[]): number;

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

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../excel-parser/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,KAAK,EAEV,MAAM,EACN,UAAU,EACV,SAAS,EACT,sBAAsB,EACvB,MAAM,2BAA2B,CAAC;AAUnC,eAAO,MAAM,sBAAsB,GAAI,KAAK,MAAM,KAAG,SAAS,GAAG,SAIhE,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,UAIrD;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,UAMpC;AAmBD,eAAO,MAAM,wBAAwB,GACnC,OAAO,OAAO,KACb,KAAK,IAAI,sBACwD,CAAC;AAErE;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GACjC,QAAQ,GAAG,KACV,IAAI,CAAC,MAAM,EAAE,mBAAmB,GAAG,gBAAgB,GAAG,kBAAkB,CAmB1E,CAAC;AAqBF,wBAAgB,+BAA+B,CAC7C,UAAU,EAAE,GAAG;AACf;;;;GAIG;AACH,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,gBA0G5E;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,CAgBtE;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,GAAG,EACd,KAAK,EAAE,SAAS,EAChB,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,GAC1E,SAAS,EAAE,CA2Cb;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,WAAW,wBAkB3D"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../excel-parser/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,KAAK,EAEV,MAAM,EACN,UAAU,EACV,SAAS,EACT,sBAAsB,EACvB,MAAM,2BAA2B,CAAC;AAUnC,eAAO,MAAM,sBAAsB,GAAI,KAAK,MAAM,KAAG,SAAS,GAAG,SAIhE,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,UAMrD;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,UAMpC;AAmBD,eAAO,MAAM,wBAAwB,GACnC,OAAO,OAAO,KACb,KAAK,IAAI,sBACwD,CAAC;AAErE;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GACjC,QAAQ,GAAG,KACV,IAAI,CAAC,MAAM,EAAE,mBAAmB,GAAG,gBAAgB,GAAG,kBAAkB,CAmB1E,CAAC;AAqBF,wBAAgB,+BAA+B,CAC7C,UAAU,EAAE,GAAG;AACf;;;;GAIG;AACH,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,gBA0G5E;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,CAgBtE;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,GAAG,EACd,KAAK,EAAE,SAAS,EAChB,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,GAC1E,SAAS,EAAE,CA2Cb;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,WAAW,wBAkB3D"}

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

@@ -8,20 +8,23 @@ export var getRangeFromAddressRef = function (ref) {
     return selection.range;
 };
 /**
- * Convert an xlsx column width (in units of max-digit-width of the
- * default workbook font, Calibri 11 → MDW=7px) to pixels.
+ * OOXML `<col width>` (and `<sheetFormatPr defaultColWidth>`) → pixels.
  *
- * Excel's effective rendered pixel count includes a 5-pixel padding
- * baked into the column box: `pixels = floor(width × MDW + padding)`.
- * The default width "8.43" renders as 64 px (8.43 × 7 + 5 ≈ 64.01),
- * matching Excel exactly. The "pure" ECMA-376 §18.3.1.13 formula omits
- * the 5px padding; we keep the +5 form so our pixel output matches
- * Excel's rendered widths and round-trips with our exporter.
+ * The stored width is already in *padded* character units: Excel writes
+ * `Truncate((chars × MDW + 5) / MDW × 256) / 256` — the default 8.43-character
+ * column is stored as 9.140625 — and renders it back as
+ * `Truncate(((256 × width + Truncate(128 / MDW)) / 256) × MDW)`
+ * (ECMA-376 §18.3.1.13), i.e. 9.140625 → 64 px. Adding the 5 px padding a
+ * second time (the previous `floor(width × 7 + 5)`) drew every Excel-authored
+ * column ~5 px wider than Excel does and grew widths by 0.71 characters per
+ * import/export cycle (the exporter stores `px / 7`). MDW is 7 px for the
+ * Calibri 11 / Aptos Narrow 12 defaults at 96 dpi.
  */
 export function excelColumnWidthToPixels(width) {
-    var padding = 5;
-    var charWidth = 7;
-    return Math.floor(width * charWidth + padding);
+    var maxDigitWidth = 7;
+    if (!Number.isFinite(width) || width <= 0)
+        return 0;
+    return Math.trunc(((256 * width + Math.trunc(128 / maxDigitWidth)) / 256) * maxDigitWidth);
 }
 export function findMax(arr) {
     var max = arr[0];

package/dist/cjs/exporter/xlsx/xlsx-export.js

@@ -1307,7 +1307,7 @@ var buildWorksheetXml = function (_a) {
     var sheetFormatPrAttrs = ["defaultRowHeight=\"".concat(defaultRowHeightPt, "\"")];
     if (typeof explicitDefaultColumnWidthPx === "number" &&
         explicitDefaultColumnWidthPx > 0) {
-        sheetFormatPrAttrs.push("defaultColWidth=\"".concat(columnPixelToChars(explicitDefaultColumnWidthPx).toFixed(2), "\""));
+        sheetFormatPrAttrs.push("defaultColWidth=\"".concat(columnPixelToChars(explicitDefaultColumnWidthPx), "\""));
     }
     var worksheetXml = "".concat(XML_DECLARATION, "<worksheet xmlns=\"").concat(WORKSHEET_NS, "\" xmlns:r=\"").concat(REL_NS, "\">").concat(sheetPrXml, "<dimension ref=\"").concat(dimension, "\"/>").concat(sheetViews, "<sheetFormatPr ").concat(sheetFormatPrAttrs.join(" "), "/>").concat(columnXml).concat(sheetDataXml).concat(protectionXml).concat(basicFilterXml).concat(mergeXml).concat(conditionalFormattingXml).concat(dataValidationsXml).concat(hyperlinksXml).concat(printSettingsXml).concat(drawingXml).concat(legacyDrawingXml).concat(controlsXml).concat(tablePartsXml).concat(extLstXml, "</worksheet>");
     return {
@@ -2514,8 +2514,11 @@ var buildColumnsXml = function (sheet, bounds) {
             continue;
         var attributes = ["min=\"".concat(columnIndex, "\""), "max=\"".concat(columnIndex, "\"")];
         if (hasExplicitSize) {
+            // Full precision on purpose: the stored value is a multiple of 1/256
+            // (Excel writes e.g. 9.140625), and rounding to two decimals would
+            // break the exact export → import pixel fixed point.
             var width = columnPixelToChars(getColumnWidthPx(sheet, columnIndex - 1));
-            attributes.push("width=\"".concat(width.toFixed(2), "\""));
+            attributes.push("width=\"".concat(width, "\""));
             attributes.push("customWidth=\"1\"");
         }
         if (hasHiddenFlag) {

package/dist/cjs/helpers.d.ts

@@ -8,7 +8,9 @@ export declare const createDownloadableFile: (filename: string, urlOrBlob: Blob
 export declare const toArrayBuffer: (data: ArrayBuffer | Uint8Array) => ArrayBuffer;
 export declare const charsToPixel: (chars: number) => number;
 export declare const pixelToCharacters: (px: number) => number;
+/** Stored OOXML column width (padded character units) → rendered pixels. */
 export declare const columnCharsToPixel: (chars: number) => number;
+/** Rendered pixels → stored OOXML column width (padded character units). */
 export declare const columnPixelToChars: (pixel: number) => number;
 /**
  * Get range from address reference with minimal processing

package/dist/cjs/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AA+B3E,eAAO,MAAM,0BAA0B,GACrC,SAAS,MAAM,GAAG,SAAS,EAC3B,YAAY,aAAa,EACzB,iBAAiB,aAAa,EAC9B,UAAU;IACR,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,KACA,MAAM,GAAG,SA8BX,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC3B,UAAU,MAAM,KACf,OAAO,CAAC,MAAM,GAAG,SAAS,CAiB5B,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,UAAU,MAAM,EAChB,WAAW,IAAI,GAAG,MAAM,8BAazB,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,MAAM,WAAW,GAAG,UAAU,KAAG,WAO9D,CAAC;AAIF,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,WAAiC,CAAC;AAC5E,eAAO,MAAM,iBAAiB,GAAI,IAAI,MAAM,WAA+B,CAAC;AAoB5E,eAAO,MAAM,kBAAkB,GAAI,OAAO,MAAM,WACrB,CAAC;AAE5B,eAAO,MAAM,kBAAkB,GAAI,OAAO,MAAM,WAClB,CAAC;AAE/B;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS;;;;;cAwBpE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAsB/C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAe7C"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAiC3E,eAAO,MAAM,0BAA0B,GACrC,SAAS,MAAM,GAAG,SAAS,EAC3B,YAAY,aAAa,EACzB,iBAAiB,aAAa,EAC9B,UAAU;IACR,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,KACA,MAAM,GAAG,SA8BX,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC3B,UAAU,MAAM,KACf,OAAO,CAAC,MAAM,GAAG,SAAS,CAiB5B,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,UAAU,MAAM,EAChB,WAAW,IAAI,GAAG,MAAM,8BAazB,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,MAAM,WAAW,GAAG,UAAU,KAAG,WAO9D,CAAC;AAIF,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,WAAiC,CAAC;AAC5E,eAAO,MAAM,iBAAiB,GAAI,IAAI,MAAM,WAA+B,CAAC;AAyB5E,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,GAAI,OAAO,MAAM,WACf,CAAC;AAElC,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,GAAI,OAAO,MAAM,WAG/C,CAAC;AAEF;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS;;;;;cAwBpE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAsB/C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAe7C"}

package/dist/cjs/helpers.js

@@ -2,6 +2,7 @@ import { __awaiter, __generator, __read } from "tslib";
 import { addressToCell, canUseDOM } from "@rowsncolumns/utils";
 // ---- Formula helpers ----
 import { alpha2number, number2Alpha } from "@rowsncolumns/utils";
+import { excelColumnWidthToPixels } from "./excel-parser/helpers";
 var CELL_ADDR_RE = /(?:'[^']+'!?|[^'!\s]+!?)?(\$?[A-Z]+\$?\d+)(?::(\$?[A-Z]+\$?\d+))?/g;
 var parseAddr = function (addr) {
     var m = /^(\$?)([A-Z]+)(\$?)(\d+)$/.exec(addr);
@@ -98,22 +99,30 @@ export var pixelToCharacters = function (px) { return Math.floor((72 / 96) * px)
 // export const pixelToDimension = (chWidth: number) =>
 //   Math.ceil((33.25 / 265) * chWidth);
 // // const dimensionToPixel = (chWidth: number) => (72 / 30) * chWidth;
-// Excel column-width / pixel conversion. Excel's rendered column box
-// includes a 5-pixel padding around the MDW (max-digit-width, 7 px for
-// Calibri 11), so the default width 8.43 renders at 64 px (8.43 × 7 + 5).
-// We keep the +5 padding form so a round-trip pixels → width → pixels is
-// an identity for the values Excel itself produces.
+// Excel column-width / pixel conversion (ECMA-376 §18.3.1.13).
 //
-//   pixels = floor(widthChars × 7 + 5)
-//   widthChars = (pixels − 5) / 7
-//
-// The "pure" ECMA-376 §18.3.1.13 formula omits the 5px padding and gives
-// 59 for default-width columns instead of Excel's actual 64.
+// OOXML `<col width>` / `<sheetFormatPr defaultColWidth>` are stored in
+// *padded* character units — Excel writes `px / MDW` (the default 64 px
+// column is stored as 9.140625, not 8.43) and renders it back as
+// `Truncate(((256 × width + Truncate(128 / MDW)) / 256) × MDW)`, which the
+// importer implements in `excelColumnWidthToPixels`. The exporter must be
+// that function's inverse so export → import is a fixed point: storing
+// `trunc(px × 256 / MDW) / 256` (Excel's own 1/256-character quantisation)
+// makes `excelColumnWidthToPixels(columnPixelToChars(px)) === px` for every
+// integer pixel width. Subtracting the 5 px cell padding here (the previous
+// `(px − 5) / 7`) shrank every column by 5 px per export/import cycle once
+// the importer stopped adding it. MDW is 7 px for the Calibri 11 /
+// Aptos Narrow 12 defaults at 96 dpi.
+var EXCEL_MAX_DIGIT_WIDTH_PX = 7;
+/** Stored OOXML column width (padded character units) → rendered pixels. */
 export var columnCharsToPixel = function (chars) {
-    return Math.floor(chars * 7 + 5);
+    return excelColumnWidthToPixels(chars);
 };
+/** Rendered pixels → stored OOXML column width (padded character units). */
 export var columnPixelToChars = function (pixel) {
-    return Math.max(0, (pixel - 5) / 7);
+    if (!Number.isFinite(pixel) || pixel <= 0)
+        return 0;
+    return Math.trunc((pixel * 256) / EXCEL_MAX_DIGIT_WIDTH_PX) / 256;
 };
 /**
  * Get range from address reference with minimal processing

package/dist/esm/excel-parser/helpers.d.ts

@@ -2,15 +2,17 @@ import type { GridRange } from "@rowsncolumns/common-types";
 import type { Column, FilterSpec, SortSpecs, TableTotalsRowFunction } from "@rowsncolumns/spreadsheet";
 export declare const getRangeFromAddressRef: (ref: string) => GridRange | undefined;
 /**
- * Convert an xlsx column width (in units of max-digit-width of the
- * default workbook font, Calibri 11 → MDW=7px) to pixels.
+ * OOXML `<col width>` (and `<sheetFormatPr defaultColWidth>`) → pixels.
  *
- * Excel's effective rendered pixel count includes a 5-pixel padding
- * baked into the column box: `pixels = floor(width × MDW + padding)`.
- * The default width "8.43" renders as 64 px (8.43 × 7 + 5 ≈ 64.01),
- * matching Excel exactly. The "pure" ECMA-376 §18.3.1.13 formula omits
- * the 5px padding; we keep the +5 form so our pixel output matches
- * Excel's rendered widths and round-trips with our exporter.
+ * The stored width is already in *padded* character units: Excel writes
+ * `Truncate((chars × MDW + 5) / MDW × 256) / 256` — the default 8.43-character
+ * column is stored as 9.140625 — and renders it back as
+ * `Truncate(((256 × width + Truncate(128 / MDW)) / 256) × MDW)`
+ * (ECMA-376 §18.3.1.13), i.e. 9.140625 → 64 px. Adding the 5 px padding a
+ * second time (the previous `floor(width × 7 + 5)`) drew every Excel-authored
+ * column ~5 px wider than Excel does and grew widths by 0.71 characters per
+ * import/export cycle (the exporter stores `px / 7`). MDW is 7 px for the
+ * Calibri 11 / Aptos Narrow 12 defaults at 96 dpi.
  */
 export declare function excelColumnWidthToPixels(width: number): number;
 export declare function findMax(arr: number[]): number;

package/dist/esm/excel-parser/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../excel-parser/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,KAAK,EAEV,MAAM,EACN,UAAU,EACV,SAAS,EACT,sBAAsB,EACvB,MAAM,2BAA2B,CAAC;AAUnC,eAAO,MAAM,sBAAsB,GAAI,KAAK,MAAM,KAAG,SAAS,GAAG,SAIhE,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,UAIrD;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,UAMpC;AAmBD,eAAO,MAAM,wBAAwB,GACnC,OAAO,OAAO,KACb,KAAK,IAAI,sBACwD,CAAC;AAErE;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GACjC,QAAQ,GAAG,KACV,IAAI,CAAC,MAAM,EAAE,mBAAmB,GAAG,gBAAgB,GAAG,kBAAkB,CAmB1E,CAAC;AAqBF,wBAAgB,+BAA+B,CAC7C,UAAU,EAAE,GAAG;AACf;;;;GAIG;AACH,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,gBA0G5E;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,CAgBtE;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,GAAG,EACd,KAAK,EAAE,SAAS,EAChB,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,GAC1E,SAAS,EAAE,CA2Cb;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,WAAW,wBAkB3D"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../excel-parser/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,KAAK,EAEV,MAAM,EACN,UAAU,EACV,SAAS,EACT,sBAAsB,EACvB,MAAM,2BAA2B,CAAC;AAUnC,eAAO,MAAM,sBAAsB,GAAI,KAAK,MAAM,KAAG,SAAS,GAAG,SAIhE,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,UAMrD;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,UAMpC;AAmBD,eAAO,MAAM,wBAAwB,GACnC,OAAO,OAAO,KACb,KAAK,IAAI,sBACwD,CAAC;AAErE;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GACjC,QAAQ,GAAG,KACV,IAAI,CAAC,MAAM,EAAE,mBAAmB,GAAG,gBAAgB,GAAG,kBAAkB,CAmB1E,CAAC;AAqBF,wBAAgB,+BAA+B,CAC7C,UAAU,EAAE,GAAG;AACf;;;;GAIG;AACH,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,gBA0G5E;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,CAgBtE;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,GAAG,EACd,KAAK,EAAE,SAAS,EAChB,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,GAC1E,SAAS,EAAE,CA2Cb;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,WAAW,wBAkB3D"}

package/dist/esm/excel-parser/helpers.js

@@ -7,20 +7,23 @@ export const getRangeFromAddressRef = (ref) => {
     return selection.range;
 };
 /**
- * Convert an xlsx column width (in units of max-digit-width of the
- * default workbook font, Calibri 11 → MDW=7px) to pixels.
+ * OOXML `<col width>` (and `<sheetFormatPr defaultColWidth>`) → pixels.
  *
- * Excel's effective rendered pixel count includes a 5-pixel padding
- * baked into the column box: `pixels = floor(width × MDW + padding)`.
- * The default width "8.43" renders as 64 px (8.43 × 7 + 5 ≈ 64.01),
- * matching Excel exactly. The "pure" ECMA-376 §18.3.1.13 formula omits
- * the 5px padding; we keep the +5 form so our pixel output matches
- * Excel's rendered widths and round-trips with our exporter.
+ * The stored width is already in *padded* character units: Excel writes
+ * `Truncate((chars × MDW + 5) / MDW × 256) / 256` — the default 8.43-character
+ * column is stored as 9.140625 — and renders it back as
+ * `Truncate(((256 × width + Truncate(128 / MDW)) / 256) × MDW)`
+ * (ECMA-376 §18.3.1.13), i.e. 9.140625 → 64 px. Adding the 5 px padding a
+ * second time (the previous `floor(width × 7 + 5)`) drew every Excel-authored
+ * column ~5 px wider than Excel does and grew widths by 0.71 characters per
+ * import/export cycle (the exporter stores `px / 7`). MDW is 7 px for the
+ * Calibri 11 / Aptos Narrow 12 defaults at 96 dpi.
  */
 export function excelColumnWidthToPixels(width) {
-    const padding = 5;
-    const charWidth = 7;
-    return Math.floor(width * charWidth + padding);
+    const maxDigitWidth = 7;
+    if (!Number.isFinite(width) || width <= 0)
+        return 0;
+    return Math.trunc(((256 * width + Math.trunc(128 / maxDigitWidth)) / 256) * maxDigitWidth);
 }
 export function findMax(arr) {
     let max = arr[0];

package/dist/esm/exporter/xlsx/xlsx-export.js

@@ -967,7 +967,7 @@ const buildWorksheetXml = ({ sheet, rows, sharedStrings, sourceSharedStrings, ce
     const sheetFormatPrAttrs = [`defaultRowHeight="${defaultRowHeightPt}"`];
     if (typeof explicitDefaultColumnWidthPx === "number" &&
         explicitDefaultColumnWidthPx > 0) {
-        sheetFormatPrAttrs.push(`defaultColWidth="${columnPixelToChars(explicitDefaultColumnWidthPx).toFixed(2)}"`);
+        sheetFormatPrAttrs.push(`defaultColWidth="${columnPixelToChars(explicitDefaultColumnWidthPx)}"`);
     }
     const worksheetXml = `${XML_DECLARATION}<worksheet xmlns="${WORKSHEET_NS}" xmlns:r="${REL_NS}">${sheetPrXml}<dimension ref="${dimension}"/>${sheetViews}<sheetFormatPr ${sheetFormatPrAttrs.join(" ")}/>${columnXml}${sheetDataXml}${protectionXml}${basicFilterXml}${mergeXml}${conditionalFormattingXml}${dataValidationsXml}${hyperlinksXml}${printSettingsXml}${drawingXml}${legacyDrawingXml}${controlsXml}${tablePartsXml}${extLstXml}</worksheet>`;
     return {
@@ -2208,8 +2208,11 @@ const buildColumnsXml = (sheet, bounds) => {
             continue;
         const attributes = [`min="${columnIndex}"`, `max="${columnIndex}"`];
         if (hasExplicitSize) {
+            // Full precision on purpose: the stored value is a multiple of 1/256
+            // (Excel writes e.g. 9.140625), and rounding to two decimals would
+            // break the exact export → import pixel fixed point.
             const width = columnPixelToChars(getColumnWidthPx(sheet, columnIndex - 1));
-            attributes.push(`width="${width.toFixed(2)}"`);
+            attributes.push(`width="${width}"`);
             attributes.push(`customWidth="1"`);
         }
         if (hasHiddenFlag) {

package/dist/esm/helpers.d.ts

@@ -8,7 +8,9 @@ export declare const createDownloadableFile: (filename: string, urlOrBlob: Blob
 export declare const toArrayBuffer: (data: ArrayBuffer | Uint8Array) => ArrayBuffer;
 export declare const charsToPixel: (chars: number) => number;
 export declare const pixelToCharacters: (px: number) => number;
+/** Stored OOXML column width (padded character units) → rendered pixels. */
 export declare const columnCharsToPixel: (chars: number) => number;
+/** Rendered pixels → stored OOXML column width (padded character units). */
 export declare const columnPixelToChars: (pixel: number) => number;
 /**
  * Get range from address reference with minimal processing

package/dist/esm/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AA+B3E,eAAO,MAAM,0BAA0B,GACrC,SAAS,MAAM,GAAG,SAAS,EAC3B,YAAY,aAAa,EACzB,iBAAiB,aAAa,EAC9B,UAAU;IACR,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,KACA,MAAM,GAAG,SA8BX,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC3B,UAAU,MAAM,KACf,OAAO,CAAC,MAAM,GAAG,SAAS,CAiB5B,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,UAAU,MAAM,EAChB,WAAW,IAAI,GAAG,MAAM,8BAazB,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,MAAM,WAAW,GAAG,UAAU,KAAG,WAO9D,CAAC;AAIF,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,WAAiC,CAAC;AAC5E,eAAO,MAAM,iBAAiB,GAAI,IAAI,MAAM,WAA+B,CAAC;AAoB5E,eAAO,MAAM,kBAAkB,GAAI,OAAO,MAAM,WACrB,CAAC;AAE5B,eAAO,MAAM,kBAAkB,GAAI,OAAO,MAAM,WAClB,CAAC;AAE/B;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS;;;;;cAwBpE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAsB/C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAe7C"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAiC3E,eAAO,MAAM,0BAA0B,GACrC,SAAS,MAAM,GAAG,SAAS,EAC3B,YAAY,aAAa,EACzB,iBAAiB,aAAa,EAC9B,UAAU;IACR,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,KACA,MAAM,GAAG,SA8BX,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC3B,UAAU,MAAM,KACf,OAAO,CAAC,MAAM,GAAG,SAAS,CAiB5B,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,UAAU,MAAM,EAChB,WAAW,IAAI,GAAG,MAAM,8BAazB,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,MAAM,WAAW,GAAG,UAAU,KAAG,WAO9D,CAAC;AAIF,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,WAAiC,CAAC;AAC5E,eAAO,MAAM,iBAAiB,GAAI,IAAI,MAAM,WAA+B,CAAC;AAyB5E,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,GAAI,OAAO,MAAM,WACf,CAAC;AAElC,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,GAAI,OAAO,MAAM,WAG/C,CAAC;AAEF;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS;;;;;cAwBpE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAsB/C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAe7C"}

package/dist/esm/helpers.js

@@ -1,6 +1,7 @@
 import { addressToCell, canUseDOM } from "@rowsncolumns/utils";
 // ---- Formula helpers ----
 import { alpha2number, number2Alpha } from "@rowsncolumns/utils";
+import { excelColumnWidthToPixels } from "./excel-parser/helpers";
 const CELL_ADDR_RE = /(?:'[^']+'!?|[^'!\s]+!?)?(\$?[A-Z]+\$?\d+)(?::(\$?[A-Z]+\$?\d+))?/g;
 const parseAddr = (addr) => {
     const m = /^(\$?)([A-Z]+)(\$?)(\d+)$/.exec(addr);
@@ -95,19 +96,29 @@ export const pixelToCharacters = (px) => Math.floor((72 / 96) * px);
 // export const pixelToDimension = (chWidth: number) =>
 //   Math.ceil((33.25 / 265) * chWidth);
 // // const dimensionToPixel = (chWidth: number) => (72 / 30) * chWidth;
-// Excel column-width / pixel conversion. Excel's rendered column box
-// includes a 5-pixel padding around the MDW (max-digit-width, 7 px for
-// Calibri 11), so the default width 8.43 renders at 64 px (8.43 × 7 + 5).
-// We keep the +5 padding form so a round-trip pixels → width → pixels is
-// an identity for the values Excel itself produces.
+// Excel column-width / pixel conversion (ECMA-376 §18.3.1.13).
 //
-//   pixels = floor(widthChars × 7 + 5)
-//   widthChars = (pixels − 5) / 7
-//
-// The "pure" ECMA-376 §18.3.1.13 formula omits the 5px padding and gives
-// 59 for default-width columns instead of Excel's actual 64.
-export const columnCharsToPixel = (chars) => Math.floor(chars * 7 + 5);
-export const columnPixelToChars = (pixel) => Math.max(0, (pixel - 5) / 7);
+// OOXML `<col width>` / `<sheetFormatPr defaultColWidth>` are stored in
+// *padded* character units — Excel writes `px / MDW` (the default 64 px
+// column is stored as 9.140625, not 8.43) and renders it back as
+// `Truncate(((256 × width + Truncate(128 / MDW)) / 256) × MDW)`, which the
+// importer implements in `excelColumnWidthToPixels`. The exporter must be
+// that function's inverse so export → import is a fixed point: storing
+// `trunc(px × 256 / MDW) / 256` (Excel's own 1/256-character quantisation)
+// makes `excelColumnWidthToPixels(columnPixelToChars(px)) === px` for every
+// integer pixel width. Subtracting the 5 px cell padding here (the previous
+// `(px − 5) / 7`) shrank every column by 5 px per export/import cycle once
+// the importer stopped adding it. MDW is 7 px for the Calibri 11 /
+// Aptos Narrow 12 defaults at 96 dpi.
+const EXCEL_MAX_DIGIT_WIDTH_PX = 7;
+/** Stored OOXML column width (padded character units) → rendered pixels. */
+export const columnCharsToPixel = (chars) => excelColumnWidthToPixels(chars);
+/** Rendered pixels → stored OOXML column width (padded character units). */
+export const columnPixelToChars = (pixel) => {
+    if (!Number.isFinite(pixel) || pixel <= 0)
+        return 0;
+    return Math.trunc((pixel * 256) / EXCEL_MAX_DIGIT_WIDTH_PX) / 256;
+};
 /**
  * Get range from address reference with minimal processing
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rowsncolumns/toolkit",
-  "version": "24.5.1",
+  "version": "24.5.4",
   "author": "Vinay M",
   "license": "SEE LICENSE IN LICENSE.md",
   "main": "./dist/cjs/index.js",
@@ -45,7 +45,7 @@
     "url": "https://github.com/rowsncolumns/spreadsheet/issues"
   },
   "devDependencies": {
-    "@rowsncolumns/utils": ">=9.5.0",
+    "@rowsncolumns/utils": ">=9.5.1",
     "@types/lodash-es": "^4.17.12"
   },
   "peerDependencies": {
@@ -55,9 +55,9 @@
   "dependencies": {
     "@noble/ciphers": "^0.5.3",
     "@noble/hashes": "^1.4.0",
-    "@rowsncolumns/calculator": ">=7.2.33",
-    "@rowsncolumns/common-types": ">=5.3.0",
-    "@rowsncolumns/date-parser": ">=13.0.1",
+    "@rowsncolumns/calculator": ">=7.3.1",
+    "@rowsncolumns/common-types": ">=5.3.1",
+    "@rowsncolumns/date-parser": ">=13.0.2",
     "@zip.js/zip.js": "^2.8.17",
     "fast-xml-parser": "^5.8.0",
     "fflate": "^0.8.2",