styled-exceljs 0.21.0 → 0.21.2

package/CHANGELOG.md

@@ -9,6 +9,35 @@ 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.2
+
+* Preserve TIFF drawing MIME metadata for XLSX images so browser renderers can
+  select an explicit decoder instead of receiving `application/octet-stream`
+* Keep workbook column-width measurement stable across sheets and tolerate
+  missing Numbers format tables
+
+中文摘要：
+
+* XLSX 中的 TIFF 图片现在会保留 `image/tiff` 类型，便于浏览器渲染器按需解码
+* 稳定多工作表列宽测量，并容错缺失的 Numbers 格式表
+
+## 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

@@ -1,5 +1,16 @@
 # [SheetJS](https://sheetjs.com)
 
+## Fork Notice
+
+`styled-exceljs` is a fork of the original SheetJS Community Edition source
+code.  This fork keeps the SheetJS-compatible workbook and worksheet model, then
+adds browser-oriented visual fidelity extensions for styles, dimensions,
+drawings, charts, merge validation, and HTML rendering.
+
+中文说明：`styled-exceljs` 基于 SheetJS Community Edition 原始代码 fork
+并继续增强，保持 SheetJS 兼容的数据模型，同时扩展样式、行列尺寸、图片绘图、
+图表、合并校验和浏览器 HTML 渲染能力。
+
 The SheetJS Community Edition offers battle-tested open-source solutions for
 extracting useful data from almost any complex spreadsheet and generating new
 spreadsheets that will work with legacy and modern software alike.
@@ -45,6 +56,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 +72,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 +92,9 @@ npm install styled-exceljs
 
 这个版本面向浏览器预览和报表渲染扩展了 XLSX / XLS 的视觉读取能力。
 默认读取路径仍然保持轻量和兼容；只有显式开启 `cellStyles`、
-`browserPixels`、`charts`、`drawings` 和 `validateMerges` 等选项时，才会
-解析完整样式、浏览器像素尺寸、图片、绘图、图表和合并单元格校验结果。
+`browserPixels`、`autoFit`、`charts`、`drawings` 和 `validateMerges` 等选项时，
+才会解析完整样式、浏览器像素尺寸、自动列宽、图片、绘图、图表和合并单元格
+校验结果。
 
 常用入口如下：
 
@@ -88,6 +103,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.2",
   "homepage": "https://github.com/SheetJS/js-xlsx",
   "main": ["xlsx.js"],
   "ignore": [