@rowsncolumns/toolkit 24.5.3 → 24.5.4

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/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.3",
+  "version": "24.5.4",
   "author": "Vinay M",
   "license": "SEE LICENSE IN LICENSE.md",
   "main": "./dist/cjs/index.js",