styled-exceljs 0.21.4 → 0.21.6

package/CHANGELOG.md

@@ -4,6 +4,22 @@ This log is intended to keep track of backwards-incompatible changes, including
 but not limited to API changes and file location changes.  Minor behavioral
 changes may not be included if they are not expected to break existing code.
 
+## v0.21.6
+
+* Publish the maintained fork metadata and current test commands with the parser
+* Rebuild browser distributions from the same source as the CJS and ESM entries
+* Preserve verified CI tarballs for exact-byte comparison before publication
+
+## v0.21.5
+
+* Ignore unused MiniFAT pointers only when no live stream needs their data;
+  preserve the unchanged FAT-backed Workbook stream and all cell values
+* Reject missing required MiniFAT/root streams with explicit CFB errors instead
+  of a metadata `name` assignment crash or an empty replacement stream
+* Refresh legacy column-width assertions for the stable MDW=7 fallback introduced
+  in 0.21.4; retain each format's native character or pixel units without changing
+  parser measurements to satisfy old expectations
+
 ## v0.21.4
 
 * Restore applied OOXML table styles, including totals rows, banding, first and

package/README.md

@@ -22,6 +22,34 @@ port calculations to web apps; automate common spreadsheet tasks, and much more!
 
 ## Documentation
 
+### Maintainer releases
+
+`publish.yml` checks out the exact stable release tag, runs the security,
+table-style and CFB regressions, builds the package, and publishes with npm
+provenance. The npm trusted publisher must bind `styled-exceljs` to
+`flyfish-dev/styled-exceljs` and `publish.yml`; the workflow itself does not
+create that npm permission. Original SheetJS authorship and licensing remain
+unchanged.
+
+Manual dispatch defaults to a dry run. Reruns skip an existing version only
+when its registry SHA-512 matches the packed bytes. Authentication failures,
+different bytes and uncertain writes stop instead of being silently retried.
+
+The maintained CI matrix uses Node 22/24/26, Bun and Deno 2. Node 24 runs the
+full official corpus in both CJS and ESM; the other runtimes run the core
+corpus. A runtime assertion prevents a Bun/Deno command from silently falling
+back to Node. The test archive is pinned to SHA-256
+`a786d4f1a80adf9447997b6f3b30b2593c776c27e0b075e3971627c17205f220`
+and cached once before the matrix. Moving external SVN checkouts and obsolete
+Node 0.x/io.js/Deno 1 harnesses are no longer release gates. Historical engine
+metadata is not evidence of a fresh test on those retired runtimes.
+
+To repeat the full corpus locally after installing the verified archive and
+building the source, run `FMTS=full STYLED_TEST_RUNTIME=node npm run test:corpus`.
+Pending tests remain visible and are not counted as passing.
+
+### Usage documentation
+
 - [API and Usage Documentation](https://docs.sheetjs.com)
 
 - [Downloadable Scripts and Modules](https://cdn.sheetjs.com)
@@ -109,6 +137,27 @@ npm install styled-exceljs
 完整中文数据结构、选项说明和渲染行为请参考
 [中文视觉保真指南](docs/visual-fidelity.zh-CN.md)。
 
+## Regression tests
+
+Run `npm test` with the official SheetJS fixture corpus in the ignored
+`test_files/` directory. The Makefile's source is
+[test_files.zip](https://test-files.sheetjs.com/test_files.zip). The 2024-07-17
+archive used for the 0.21.5 candidate has SHA-256
+`a786d4f1a80adf9447997b6f3b30b2593c776c27e0b075e3971627c17205f220`.
+Do not commit the corpus or private customer files.
+
+The candidate run passed 74,699 tests with four pending tests. Four legacy
+column-width assertions also failed on unchanged 0.21.4: they assumed MDW=6
+instead of that version's stable MDW=7 fallback. The updated assertions keep
+native XLS/XLSX widths distinct from XLML pixel widths and SYLK character widths;
+the parser's measured values are unchanged. MiniFAT tests cover the failure
+mechanism with generated files, not the unavailable private reporter file.
+
+回归测试需要官方语料；语料和客户文件不能提交。0.21.5 候选版全量测试为
+74,699 项通过、4 项待启用。四项旧列宽断言在未修改的 0.21.4 上同样失败，
+本次只更新断言以符合该版已有的 MDW=7 行为，不修改解析结果来迎合测试。
+MiniFAT 合成文件证明了故障机制，不代表已验证尚未提供的私有原文件。
+
 ## Constellation
 
 - <https://oss.sheetjs.com/notes/>: File Format Notes

package/bower.json

@@ -1,7 +1,7 @@
 {
   "name": "js-xlsx",
-  "version": "0.21.3",
-  "homepage": "https://github.com/SheetJS/js-xlsx",
+  "version": "0.21.6",
+  "homepage": "https://github.com/flyfish-dev/styled-exceljs",
   "main": ["xlsx.js"],
   "ignore": [
     "bin",