styled-exceljs 0.21.0 → 0.21.1

package/CHANGELOG.md

@@ -9,6 +9,23 @@ changes may not be included if they are not expected to break existing code.
 * Proper handling of XLSX encoded entities (h/t @inreoh)
 * Proper handling of invalid DIF sheets that match heuristics (h/t @lowkeyfish)
 
+## v0.21.1
+
+* Added browser-aware text measurement and `XLSX.utils.auto_fit_columns` for
+  best-fit column widths with wrap, overflow, shrink-to-fit, and merge support
+* `sheet_to_html` visual mode now supports `autoFit`, `overflow`, fixed-layout
+  `<colgroup>` output, and Canvas-backed shrink-to-fit sizing
+* Updated TypeScript definitions, English documentation, Chinese documentation,
+  and unit tests for the auto-fit rendering path
+
+中文摘要：
+
+* 新增浏览器文字测量和 `XLSX.utils.auto_fit_columns`，可结合换行、溢出、
+  收缩适应和合并跨度计算最优列宽
+* `sheet_to_html` 视觉模式支持 `autoFit`、`overflow`、固定布局 `<colgroup>`
+  和基于 Canvas 测量的收缩适应字号
+* 更新 TypeScript 类型、英文文档、中文文档和自动列宽单元测试
+
 ## v0.21.0
 
 * XLSX style parsing resolves fonts, fills, borders, alignment, protection,

package/README.md

@@ -45,6 +45,7 @@ const ws = wb.Sheets[wb.SheetNames[0]];
 const html = XLSX.utils.sheet_to_html(ws, {
   cellStyles: true,
   browserPixels: true,
+  autoFit: true,
   charts: true,
   drawings: true
 });
@@ -60,6 +61,8 @@ The following public worksheet fields are populated when requested:
 - `ws["!drawings"]`: parsed images, shapes, anchors, raw fallback records.
 - `ws["!charts"]` and chartsheet `ws["!chart"]`: normalized chart models used
   by HTML SVG rendering.
+- `XLSX.utils.auto_fit_columns(ws, opts)`: browser-measured best-fit column
+  widths with wrap, overflow, shrink-to-fit, and merge-span handling.
 
 `XLSX.utils.validate_merges(ws, opts)` validates merge ranges and reports
 duplicate, overlapping, invalid, or out-of-bounds ranges.  Passing
@@ -78,8 +81,9 @@ npm install styled-exceljs
 
 这个版本面向浏览器预览和报表渲染扩展了 XLSX / XLS 的视觉读取能力。
 默认读取路径仍然保持轻量和兼容；只有显式开启 `cellStyles`、
-`browserPixels`、`charts`、`drawings` 和 `validateMerges` 等选项时，才会
-解析完整样式、浏览器像素尺寸、图片、绘图、图表和合并单元格校验结果。
+`browserPixels`、`autoFit`、`charts`、`drawings` 和 `validateMerges` 等选项时，
+才会解析完整样式、浏览器像素尺寸、自动列宽、图片、绘图、图表和合并单元格
+校验结果。
 
 常用入口如下：
 
@@ -88,6 +92,8 @@ npm install styled-exceljs
 - `ws["!drawings"]`：图片、形状、锚点和复杂绘图的 raw fallback。
 - `ws["!charts"]` / `ws["!chart"]`：工作表嵌入图表和图表工作表模型，可用于 SVG 渲染。
 - `XLSX.utils.validate_merges(ws, opts)`：检查非法、重复、重叠和越界的合并单元格。
+- `XLSX.utils.auto_fit_columns(ws, opts)`：结合浏览器文字测量、换行、溢出、
+  收缩适应和合并跨度计算最优列宽。
 
 完整中文数据结构、选项说明和渲染行为请参考
 [docs/visual-fidelity.zh-CN.md](docs/visual-fidelity.zh-CN.md)。

package/bower.json

@@ -1,6 +1,6 @@
 {
   "name": "js-xlsx",
-  "version": "0.21.0",
+  "version": "0.21.1",
   "homepage": "https://github.com/SheetJS/js-xlsx",
   "main": ["xlsx.js"],
   "ignore": [